Function cmdInit

internal/app/init.go:41–127

cmdInit creates ~/.flow/ (or $FLOW_ROOT), initializes flow.db, installs the skill. Idempotent — re-running is safe.

(args []string)

// cmdInit creates ~/.flow/ (or $FLOW_ROOT), initializes flow.db, installs
// the skill. Idempotent — re-running is safe.
func cmdInit(args []string) int {
	fs := flagSet("init")
	if err := fs.Parse(args); err != nil {
		return 2
	}
	if fs.NArg() > 0 {
		fmt.Fprintln(os.Stderr, "error: init takes no positional arguments")
		return 2
	}

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

	// Create the top-level tree. `projects/` and `tasks/` are parents for
	// per-project and per-task subdirectories created later by `flow add`.
	// `kb/` holds 5 knowledge-base files (user/org/products/processes/
	// business) that the skill appends to on the fly and that `flow show
	// task`/`show project` lists for execution sessions to read.
	for _, d := range []string{
		root,
		filepath.Join(root, "projects"),
		filepath.Join(root, "tasks"),
		filepath.Join(root, "kb"),
	} {
		if err := os.MkdirAll(d, 0o755); err != nil {
			fmt.Fprintf(os.Stderr, "error: mkdir %s: %v\n", d, err)
			return 1
		}
	}

	// Seed the KB files. Idempotent: only create if missing; never
	// overwrite existing content.
	for _, kb := range kbSeeds() {
		path := filepath.Join(root, "kb", kb.filename)
		if _, err := os.Stat(path); os.IsNotExist(err) {
			if err := os.WriteFile(path, []byte(kb.stub), 0o644); err != nil {
				fmt.Fprintf(os.Stderr, "error: write %s: %v\n", path, err)
				return 1
			}
		}
	}

	// Open (and implicitly initialize) flow.db.
	dbPath := filepath.Join(root, "flow.db")
	db, err := flowdb.OpenDB(dbPath)
	if err != nil {
		fmt.Fprintf(os.Stderr, "error: open db: %v\n", err)
		return 1
	}
	db.Close()

	// Install the skill idempotently. Skip if already present; we never
	// overwrite on init (use `flow skill update` for that).
	h := defaultHarness()
	skillPath, err := h.SkillInstallPath()