Add interactive WORKFLOW bootstrap for project selection

[BetterAndBetterII]

Summary

Issue #6 ships a non-interactive baseline WORKFLOW.md bootstrap so users can install and run symphony from a packaged release. Reviewer follow-up requested an interactive bootstrap flow that can pick or create the GitHub Project configuration instead of leaving those edits to the user.

Acceptance Criteria

• When symphony initializes a missing WORKFLOW.md, it can offer a guided TUI bootstrap flow for GitHub-backed setups.
• The flow lists accessible GitHub Projects and lets the user select one for the generated WORKFLOW.md.
• The flow can create a new ProjectV2 when needed and configure the required status options (Backlog, Todo, Spec, In Progress, Rework, In Review, Merging, Done, Canceled, Duplicated).
• The flow lets the user choose Codex approval/sandbox defaults and writes the selected values into WORKFLOW.md.
• Missing auth, permission failures, and GitHub API errors fail with clear guidance.

Notes

• Related to 实现用户拿到一个打包产物就能跑 #6.
• This follow-up depends on the packaged release / installer baseline from 实现用户拿到一个打包产物就能跑 #6 being in place first.

[BetterAndBetterII]

Codex Workpad

gary-run-box:/home/gary/code/symphony-workspaces/BetterAndBetterII_symphony_13@a437db1

Plan

• 1. Confirm the current baseline and sync the branch
  • 1.1 Run the pull workflow against origin/main and capture evidence
  • 1.2 Reproduce the current static bootstrap behavior with targeted tests
• 2. Land the reviewed spec and implementation plan
  • 2.1 Keep SPEC.md aligned with the guided bootstrap contract
  • 2.2 Reuse PR Add guided WORKFLOW bootstrap for GitHub Projects #18 as the implementation review vehicle
• 3. Implement guided WORKFLOW.md bootstrap for GitHub-backed setup
  • 3.1 Add typed bootstrap flow state + rendering helpers for workflow generation
  • 3.2 Add GitHub bootstrap auth/project discovery + project creation/status reconciliation support
  • 3.3 Wire CLI first-run bootstrap through an interactive prompt runtime while preserving the baseline template path
• 4. Validate and prepare review artifacts
  • 4.1 Add/update targeted tests for guided bootstrap success + failure paths
  • 4.2 Sweep PR feedback/comments, refresh PR metadata/body, and record final validation before moving back to In Review

Acceptance Criteria

• Missing WORKFLOW.md bootstrap can offer a guided TUI flow for GitHub-backed setup.
• The flow can list accessible GitHub Projects and let the user select one for generated WORKFLOW.md.
• The flow can create a ProjectV2 and configure status options: Backlog, Todo, Spec, In Progress, Rework, In Review, Merging, Done, Canceled, Duplicated.
• The flow lets the user choose Codex approval/sandbox defaults and writes them into WORKFLOW.md.
• Missing auth, permission failures, and GitHub API errors fail with clear guidance.
• UI walkthrough: starting symphony with no WORKFLOW.md reaches a guided project selection/create flow and produces the expected config file.
• App flow: packaged-release bootstrap keeps the existing non-interactive path available while adding the guided GitHub-backed path.

Validation

• Targeted baseline/bootstrap tests: cd elixir && mix test test/symphony_elixir/cli_test.exs test/symphony_elixir/default_workflow_test.exs test/symphony_elixir/github_client_test.exs test/symphony_elixir/workflow_bootstrap_test.exs
• Repo gate: rm -f .hex/cache.ets && HEX_HOME=$PWD/.hex MIX_HOME=$PWD/.mix HEX_UNSAFE_HTTPS=1 make -C elixir all
• PR feedback sweep: env -u GITHUB_TOKEN -u GH_TOKEN gh pr view 18 --comments && env -u GITHUB_TOKEN -u GH_TOKEN gh api repos/BetterAndBetterII/symphony/pulls/18/comments && env -u GITHUB_TOKEN -u GH_TOKEN gh pr view 18 --json reviews
• PR checks: env -u GITHUB_TOKEN -u GH_TOKEN gh pr view 18 --json statusCheckRollup

Notes

• [2026-03-06 13:56:56 +0800] Moved issue status from Todo to Spec and created the persistent workpad comment.
• [2026-03-06 13:58:52 +0800] pull skill evidence: merged origin/main into main via fast-forward (clean); HEAD is now 987a714.
• [2026-03-06 14:01:31 +0800] Baseline signal: SymphonyElixir.CLI still bootstraps a static template by calling DefaultWorkflow.write/1 when default WORKFLOW.md is missing, and the embedded template still requires GITHUB_PROJECT_OWNER / GITHUB_PROJECT_NUMBER placeholders instead of guiding project selection.
• [2026-03-06 14:03:33 +0800] Impact analysis in progress: likely touch points are CLI/runtime bootstrap entry, workflow template rendering, GitHub bootstrap auth/query helpers, and status-field reconciliation for generated GitHub Project config.
• [2026-03-06 16:15:07 +0800] pull skill evidence: merged origin/main into feat/gar-13-workflow-bootstrap (clean); HEAD remains 15b5a9e.
• [2026-03-06 16:18:41 +0800] Reproduced the current baseline with mix test before editing; bootstrap coverage still proves the default path only writes the static template and never offers a guided project-selection flow.
• [2026-03-06 16:20:54 +0800] PR feedback sweep found one actionable bot thread on SPEC.md clarifying why Backlog is created but intentionally excluded from active_states; I rolled that clarification into both the spec and generated workflow copy.
• [2026-03-06 16:40:12 +0800] Implemented the guided bootstrap runtime in SymphonyElixir.DefaultWorkflow.Bootstrap, extended CLI/default workflow rendering to use it on interactive first runs, and taught GitHub.Client / GitHubAuth to support bootstrap-specific auth + endpoint overrides.
• [2026-03-06 16:43:36 +0800] Committed implementation as a437db1 (feat(workflow): add guided GitHub bootstrap) and pushed the branch update.
• [2026-03-06 16:44:48 +0800] Refreshed PR Add guided WORKFLOW bootstrap for GitHub Projects #18 title/body, added the symphony label, replied to and resolved the Gemini review thread, and marked the PR ready for review.
• [2026-03-06 16:45:32 +0800] Validation passed: targeted bootstrap tests are green and make -C elixir all passed using repo-local HEX_HOME / MIX_HOME plus HEX_UNSAFE_HTTPS=1 after clearing the transient local .hex/cache.ets corruption inside this workspace.

Confusions

• None currently.