make-worksgood-thin-existing-graph-launcher

Metadata

Status	done
Created	2026-07-31T08:35:54.972894619+00:00
Started	2026-07-31T11:34:06.258287600+00:00
Completed	2026-08-03T09:42:52.410712894+00:00
Tags	`draft`, `worksgood`, `tui`, `concierge`, `ux`
Tokens	9765311 in / 26063 out

Description

Make bare worksgood a thin launcher once a repository already has .wg. The concierge exists to bootstrap a new repository or when explicitly requested through worksgood setup; it must not run on every normal entry.

Required behavior:

Existing repository with .wg: resolve the authenticated absolute sibling wg executable and directly exec/open wg tui with the exact project graph. Do not discover Pi, ensure the Pi plugin, read/reconcile concierge state, print onboarding prose, choose routes, or touch services/config.
Repository without .wg: run the minimal new-repo concierge/bootstrap, allowing route-free graph/TUI setup; then open the TUI.
worksgood setup: explicit advanced concierge for unattended automation on new or existing graphs.
worksgood tui: remain a setup-neutral explicit alias, but bare worksgood on an existing graph should be behaviorally equivalent.
TUI owns chat creation and reports executor/Pi availability only when the user chooses that action.

Validation

Existing .wg invocation executes the same TUI path/argv and state effects as wg tui, with no Pi/plugin/profile/service/concierge reads or writes.
Existing graph opens when Pi is absent; only choosing New chat → Pi produces an actionable Pi error.
Fresh repository gets bootstrap exactly once, then subsequent invocations bypass concierge.
worksgood setup retains explicit automation route/reasoning/service gates.
Credential-free PTY smoke compares bare worksgood, worksgood tui, and wg tui on an existing graph and proves no setup mutation.

Make bare `worksgood` a thin launcher once a repository already has `.wg`. The concierge exists to bootstrap a new repository or when explicitly requested through `worksgood setup`; it must not run on every normal entry.

Required behavior:
- Existing repository with `.wg`: resolve the authenticated absolute sibling `wg` executable and directly exec/open `wg tui` with the exact project graph. Do not discover Pi, ensure the Pi plugin, read/reconcile concierge state, print onboarding prose, choose routes, or touch services/config.
- Repository without `.wg`: run the minimal new-repo concierge/bootstrap, allowing route-free graph/TUI setup; then open the TUI.
- `worksgood setup`: explicit advanced concierge for unattended automation on new or existing graphs.
- `worksgood tui`: remain a setup-neutral explicit alias, but bare `worksgood` on an existing graph should be behaviorally equivalent.
- TUI owns chat creation and reports executor/Pi availability only when the user chooses that action.

## Validation
- Existing `.wg` invocation executes the same TUI path/argv and state effects as `wg tui`, with no Pi/plugin/profile/service/concierge reads or writes.
- Existing graph opens when Pi is absent; only choosing New chat → Pi produces an actionable Pi error.
- Fresh repository gets bootstrap exactly once, then subsequent invocations bypass concierge.
- `worksgood setup` retains explicit automation route/reasoning/service gates.
- Credential-free PTY smoke compares bare `worksgood`, `worksgood tui`, and `wg tui` on an existing graph and proves no setup mutation.

Depends on

done implement-task-owned-finish-transaction

Required by

done synthesize-post-lifecycle-convergence-ux

Log

2026-07-31T08:35:54.938927846+00:00 Task paused
2026-07-31T11:34:04.519087419+00:00 Task published
2026-07-31T11:34:06.519632086+00:00 Spawned by coordinator --executor pi --model openai-codex:gpt-5.6-sol --isolation required-worktree
2026-07-31T11:34:21.570023039+00:00 Starting implementation; inspecting launcher, concierge, TUI dispatch, and existing PTY smoke patterns. FANOUT_DECISION: stay inline — launcher behavior and its regression scenario are tightly coupled and likely touch a small sequential file set.
2026-07-31T11:50:04.385605963+00:00 Implemented thin bare-entry branch: existing graphs resolve authenticated sibling wg and invoke only --dir <canonical graph> tui; fresh repos run route-free/no-agency init once then the same TUI. Removed bare Pi/plugin preparation and returning concierge path; kept explicit automation planner. Reworked credential-free real tmux smoke to compare bare/alias/direct argv and effects, exercise missing-Pi selection error, one-time bootstrap, and setup gates. Focused scenario plus prior concierge scenario pass.
2026-07-31T12:17:59.181424340+00:00 Validated: task-owned credential-free tmux/PTTY smoke PASS; existing bare/worksgood tui/wg tui exact argv and effects match; no-Pi open + New chat error PASS; fresh one-time bootstrap PASS; explicit setup route/reasoning/service gates PASS. Prior worksgood_concierge and worksgood_one_model_setup scenarios PASS.
2026-07-31T12:17:59.275416628+00:00 Validated: cargo fmt --check PASS; cargo build PASS; cargo clippy PASS with existing warnings; focused concierge tests 16/16 PASS; cargo install --path . --locked PASS. Full cargo test exercised the suite but ended on unrelated existing failures (spawn-site allowlist, watchdog/lifecycle tests) and transient ENOSPC after parallel compilation; no launcher-focused failure.
2026-07-31T12:17:59.376147943+00:00 Committed: eb837464 — pushed to origin/wg/agent-946/make-worksgood-thin-existing-graph-launcher