Epic: guided interactive flow + installer-grade terminal UX

[aptracebloc]

Goal

Make the CLI feel like the tracebloc/client one-line installer: a guided, prompted flow for dataset push (instead of requiring every flag), installer-grade colored step/feedback after each command, and a rich post-ingestion summary. Plus a follow-on to delete pushed data.

Decisions locked

• Styling: fatih/color — the installer's ANSI palette (not lipgloss).
• Prompts: AlecAivazis/survey/v2 — classic line prompts (not bubbletea/huh).
• Line-oriented colored output matching the installer — not a full-screen TUI.

Phases

• feat(ui): installer-style terminal UX package (internal/ui) #26 — Phase 1: installer-style terminal UX package (internal/ui)
• feat(submit): rich ingestion summary screen #27 — Phase 2: rich ingestion summary screen
• feat(dataset push): interactive guided mode #28 — Phase 3: interactive guided dataset push
• feat: UX polish — guided launcher + --output json (stretch) #29 — Phase 4: UX polish — guided launcher + --output json (stretch)
• feat(dataset): delete pushed data (dataset rm) [needs design] #30 — Phase 5: delete pushed data (dataset rm) — needs design, after batch 1

Sequencing

1 → 2 (UX foundation, then the summary built on it) → 3 (interactive, depends on 1–2) → 4 (polish) → 5 (delete; detailed design after the first batch lands).

References

• Borrowed UX: tracebloc/client/scripts/lib/common.sh (step/success/warn/info/hint/print_banner) + summary.sh (print_summary).
• Existing CLI primitives to build on: internal/push/progress.go (TTY gating + the Progress interface pattern), internal/submit/summary.go (the Summary parser + RenderPanel).

🤖 Generated with Claude Code