Function cmdDone

internal/app/done.go:28–108

cmdDone marks a task done. Per spec §5.3 this is a single UPDATE that does NOT touch the iTerm tab, kill the Claude session, or clear session_id — the session can still be resumed via `flow do` after manually reopening the task if the user ever needs to. After the status flip, if the task has a ses

(args []string)

// A failed sweep (missing claude binary, non-zero exit) only emits a
// warning — the status flip is the contract; the sweep is best-effort.
func cmdDone(args []string) int {
	if len(args) == 0 {
		fmt.Fprintln(os.Stderr, "error: done requires a task ref")
		return 2
	}
	query := args[0]
	fs := flagSet("done")
	if err := fs.Parse(args[1:]); err != nil {
		return 2
	}

	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: %v\n", err)
		return 1
	}
	defer db.Close()

	task, rc := findTask(db, query)
	if rc != 0 {
		return rc
	}

	// Done implies a session existed and produced learnings. A backlog
	// task that was never started has nothing to sweep. The task-table
	// CHECK constraint would reject the UPDATE with a cryptic error;
	// we surface the right verbs here instead.
	if task.Status == "backlog" && (!task.SessionID.Valid || task.SessionID.String == "") {
		fmt.Fprintf(os.Stderr,
			"error: task %q has no session_id — flow done requires at least one prior `flow do` (or `flow do --here`) to have attached a session whose transcript the sweep can read.\n"+
				"  options:\n"+
				"    - if you've been working on this task in the current Claude session, bind it now and retry close-out:\n"+
				"        flow do --here %s   (then re-run: flow done %s)\n"+
				"    - if it was never worked on and isn't relevant, archive it instead:\n"+
				"        flow archive %s\n",
			task.Slug, task.Slug, task.Slug, task.Slug)
		return 1
	}

	now := flowdb.NowISO()
	res, err := db.Exec(
		`UPDATE tasks SET status='done', status_changed_at=?, updated_at=? WHERE slug=?`,
		now, now, task.Slug,
	)
	if err != nil {
		fmt.Fprintf(os.Stderr, "error: mark done: %v\n", err)
		return 1
	}
	if affected, _ := res.RowsAffected(); affected == 0 {
		fmt.Fprintf(os.Stderr, "error: task %q not updated\n", task.Slug)
		return 1
	}
	fmt.Printf("Marked %s as done\n", task.Slug)