Why
A developer running the TUI for the first time and pressing i on a CI failure sees a flash error with no indication of whether hub fetch is a one-time setup step or a sign that their config is broken.
Current state
The TUI silently surfaces a flash error at runtime when a bare repo does not exist. Neither CONTRIBUTING.md nor the add-an-investigation playbook (if it exists) mentions hub fetch as a prerequisite. The setup section in CONTRIBUTING.md does not document the runtime directory structure the TUI depends on.
Ideal state
CONTRIBUTING.md's setup section mentions hub fetch as a prerequisite step before opening the TUI and attempting an investigation.- The
docs/playbooks/ investigation playbook (or equivalent) notes that a bare repo must exist before an investigation can open a worktree.
Out of scope
Improving the flash error message itself (that may be covered separately).
Starting points
CONTRIBUTING.md — setup section to updatedocs/playbooks/ — any investigation playbook to updateui/tui/src/investigations/mod.rs — shows where the runtime error originates
QA plan
- Open
CONTRIBUTING.md — expect a step that instructs the reader to run hub fetch before using TUI investigations.
- Follow the documented setup steps on a clean checkout — expect TUI investigations to work without a flash error.
Done when
CONTRIBUTING.md lists hub fetch as a required setup step and a developer following the setup section can open a TUI investigation without encountering the bare-repo flash error.
Why
A developer running the TUI for the first time and pressing
ion a CI failure sees a flash error with no indication of whetherhub fetchis a one-time setup step or a sign that their config is broken.Current state
The TUI silently surfaces a flash error at runtime when a bare repo does not exist. Neither
CONTRIBUTING.mdnor theadd-an-investigationplaybook (if it exists) mentionshub fetchas a prerequisite. The setup section inCONTRIBUTING.mddoes not document the runtime directory structure the TUI depends on.Ideal state
CONTRIBUTING.md's setup section mentionshub fetchas a prerequisite step before opening the TUI and attempting an investigation.docs/playbooks/investigation playbook (or equivalent) notes that a bare repo must exist before an investigation can open a worktree.Out of scope
Improving the flash error message itself (that may be covered separately).
Starting points
CONTRIBUTING.md— setup section to updatedocs/playbooks/— any investigation playbook to updateui/tui/src/investigations/mod.rs— shows where the runtime error originatesQA plan
CONTRIBUTING.md— expect a step that instructs the reader to runhub fetchbefore using TUI investigations.Done when
CONTRIBUTING.mdlistshub fetchas a required setup step and a developer following the setup section can open a TUI investigation without encountering the bare-repo flash error.