Function cmdEdit

internal/app/edit.go:15–101

cmdEdit opens a brief.md in $EDITOR for either a task or a project. Per spec §5.5. Bumps updated_at after a clean editor exit.

(args []string)

// cmdEdit opens a brief.md in $EDITOR for either a task or a project.
// Per spec §5.5. Bumps updated_at after a clean editor exit.
func cmdEdit(args []string) int {
	fs := flagSet("edit")
	if err := fs.Parse(args); err != nil {
		return 2
	}
	if fs.NArg() == 0 {
		fmt.Fprintln(os.Stderr, "error: edit requires a ref")
		return 2
	}
	ref := fs.Arg(0)

	dbPath, err := flowDBPath()
	if err != nil {
		fmt.Fprintf(os.Stderr, "error: %v\n", err)
		return 1
	}
	db, err := flowdb.OpenDB(dbPath)
	if err != nil {
		fmt.Fprintf(os.Stderr, "error: open db: %v\n", err)
		return 1
	}
	defer db.Close()

	kind, slug, err := resolveEditRef(db, ref)
	if err != nil {
		fmt.Fprintf(os.Stderr, "error: %v\n", err)
		return 1
	}

	root, err := flowRoot()
	if err != nil {
		fmt.Fprintf(os.Stderr, "error: %v\n", err)
		return 1
	}

	var briefPath string
	switch kind {
	case "task":
		briefPath = filepath.Join(root, "tasks", slug, "brief.md")
	case "project":
		briefPath = filepath.Join(root, "projects", slug, "brief.md")
	case "playbook":
		briefPath = filepath.Join(root, "playbooks", slug, "brief.md")
	}

	// Ensure the parent directory exists so the editor doesn't refuse.
	if err := os.MkdirAll(filepath.Dir(briefPath), 0o755); err != nil {
		fmt.Fprintf(os.Stderr, "error: mkdir %s: %v\n", filepath.Dir(briefPath), err)
		return 1
	}

	editor := os.Getenv("EDITOR")
	if editor == "" {
		editor = "vi"
	}

	// Accept EDITOR values that contain flags ("emacs -nw"), splitting on
	// whitespace. This matches the convention of git and other tools.