refactor(cli): adopt cobra + lipgloss for the command tree

[mcampbellr]

What

Replaces the hand-rolled os.Args dispatch in cmd/vector with a cobra command tree and adds cli/internal/ui (lipgloss) for the styled human surface. The CLI gains auto-generated --help, vector completion <bash|zsh|fish|powershell>, and clear styled output.

The hard guarantee: --json is byte-identical

The --json contract consumed by the /vector:* project commands is unchanged, byte-for-byte. Verified two ways:

• A golden suite (cli/cmd/vector/golden_test.go + testdata/golden/) captures 15 deterministic --json commands and gates on drift.
• Direct diff of the pre-cobra main binary vs the new binary on identically-seeded repos — all identical.

pflag interleaves flags and positionals, so invocations like vector spec apply --json <id> (flag before id) now work too — a strict superset; every previously valid invocation stays valid.

Details

• cmd/vector: each runXxx → newXxxCmd() factory (flags 1:1, body in RunE); newRootCmd() builds a fresh tree per call; hand-rolled -v/--version fires in any position; exit-code contract preserved (no-args / unknown-command → 2; unknown subverb / unknown flag / business error → 1; version → 0).
• internal/ui: lipgloss wrappers + ApplyCustomHelp, applied only in the human branch (a test guards against ui.* inside any if jsonOut branch).
• summarize commit keeps both orderings (summarize commit <id> and summarize <id> commit) via manual two-order detection — documented exception to the cobra-child pattern.
• Deps (first external deps of the module): cobra v1.10.2 (Apache-2.0), lipgloss v1.1.0 (MIT); no huh/bubbletea. Release-equivalent binary: 6.60 → 8.04 MiB (+1.43 MiB, +21.7%) — no hard threshold.

Gate

gofmt clean · go vet ./... clean · go build ./... · go test ./... green · go mod tidy no diff.

Merge note — coordinate with emit-sketch-attached-event

cmd/vector/sketch.go here calls the 3-arg Store.AttachSketch (matching main). The separate in-progress emit-sketch-attached-event change adds a 4th actor arg to AttachSketch. When both land, resolve the sketch.go conflict by keeping newSpecAttachSketchCmd (cobra) and using the 4-arg call.

🤖 Generated with Claude Code