savepoint 1.0.0

package/.savepoint/releases/v1/epics/_archived/E02-domain-phase-model/tasks/T004-simplify-router-domain.md

@@ -0,0 +1,24 @@
+---
+id: E02-domain-phase-model/T004-simplify-router-domain
+status: planned
+objective: "Collapse router states from 6 to 3 in router.ts"
+depends_on: []
+---
+
+# T004: Simplify Router Domain
+
+## Acceptance Criteria
+
+- `router.ts` defines 3 states: `planning`, `building`, `reviewing`.
+- `isRouterStateValue` validates only the 3 states.
+- `validateRouterState` accepts the 3-state model.
+- `RouterState` interface unchanged (still has `state`, `release`, `epic`, `task`, `next_action`).
+- All router tests pass.
+
+## Implementation Plan
+
+- [ ] Read existing `router.ts` and `test/domain/router.test.ts`.
+- [ ] Replace `ROUTER_STATES` array with 3 states.
+- [ ] Update `isRouterStateValue` and `validateRouterState`.
+- [ ] Update `test/domain/router.test.ts` with 3-state cases.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/Design.md

@@ -0,0 +1,122 @@
+---
+type: epic-design
+status: audited
+---
+
+# Epic E03: cli-foundation
+
+## Context Budget
+
+For implementation tasks in this epic, read only:
+
+- `.savepoint/router.md`
+- this epic `Design.md`
+- the active task file
+- directly touched source/test files
+
+Read `.savepoint/Design.md` only if the task changes architecture. Read `.savepoint/releases/v1/PRD.md`, prior epic docs, audit proposals, or `.savepoint/visual-identity.md` only when the active task explicitly requires them.
+
+For E03 specifically, do not preload E02 source files, E02 audit proposals, `.savepoint/PRD.md`, or `.savepoint/releases/v1/PRD.md` during implementation. The CLI foundation should use the command contract in this file and the active task as its source of truth.
+
+## Purpose
+
+Introduce the real `savepoint` command shell: argument parsing, command dispatch, help/version output, exit codes, and terminal capability detection. This epic wires a command framework around stub command handlers so later epics can fill behavior without changing the CLI contract.
+
+## What this epic adds
+
+- Command dispatch for `init`, `board`, `audit`, and `doctor`.
+- Top-level `--help` and `--version`.
+- Command-level help text.
+- Unknown command and unknown flag handling.
+- Exit code conventions.
+- TTY and color capability detection helpers.
+- A testable CLI runner separated from process globals.
+
+## Implementation strategy
+
+- Use a small local parser instead of a CLI framework unless implementation proves it would reduce code.
+- Treat the allowed commands as a closed set: `init`, `board`, `audit`, `doctor`.
+- Treat allowed global flags as a closed set: `--help`, `-h`, `--version`, `-v`.
+- Keep command stubs shallow. They should return deterministic "not implemented yet" results and exit codes without reading or writing project files.
+- Keep process globals in `src/cli.ts`; tests should exercise `runCli()` with injected argv, streams, and environment.
+
+## Components and files
+
+Expected files introduced or extended by this epic:
+
+| Path                     | Purpose                                             |
+| ------------------------ | --------------------------------------------------- |
+| `src/cli.ts`             | Process entrypoint that invokes the CLI runner.     |
+| `src/cli/run.ts`         | Testable command runner.                            |
+| `src/cli/args.ts`        | Argument parsing and normalization.                 |
+| `src/cli/help.ts`        | Help text generation.                               |
+| `src/cli/exit-codes.ts`  | Shared exit code constants.                         |
+| `src/cli/environment.ts` | TTY, color, and platform detection.                 |
+| `src/commands/*.ts`      | Stub command modules for the fixed command surface. |
+| `test/cli/**/*.test.ts`  | CLI parser and dispatch tests.                      |
+
+## Architectural delta
+
+Before this epic, the binary is a placeholder. After this epic, `savepoint` has a stable command boundary with stubbed behaviors behind it.
+
+The command layer should not introduce data-model behavior. Commands that need project data stay as deterministic stubs until a later epic owns the data model.
+
+## Implemented As
+
+- `src/cli.ts` now isolates process globals and delegates to `runCli()`.
+- `src/cli/args.ts` implements the closed parser contract for bare invocation, global help/version flags, known commands, unknown top-level commands, and unknown top-level flags.
+- `src/cli/run.ts` wires parser output to help, version output, command-level help, command stubs, and usage errors.
+- `src/cli/help.ts` provides deterministic top-level and command-level help text.
+- `src/cli/environment.ts` provides injectable TTY, color, and platform detection.
+- `src/cli/exit-codes.ts` centralizes success, usage-error, and not-implemented exit codes.
+- `src/commands/init.ts`, `src/commands/board.ts`, `src/commands/audit.ts`, and `src/commands/doctor.ts` return deterministic not-yet-implemented results with no project filesystem side effects.
+- `src/commands/result.ts` was added as the shared command-result type used by the command stubs.
+- Focused tests were added under `test/cli/` for parsing, help text, terminal environment detection, command stubs, and runner dispatch.
+- The audit snapshot was generated manually because `savepoint audit` is still a stub.
+- During audit closeout, command-level unknown flags were fixed to return a usage error instead of dispatching command stubs.
+- The audit workflow was updated for future epics to prefer a single delta-shaped proposal bundle over four separate proposal files.
+
+Design delta notes:
+
+- The planned `src/commands/*.ts` component was implemented as one module per command plus a small shared `result.ts`.
+- The epic design table originally described command modules as the "five-command surface"; the implemented command surface has four commands plus top-level global help/version flags, matching the rest of the design.
+- Command behavior remains stubbed by design. Later epics own real `init`, `board`, `audit`, and `doctor` behavior.
+
+## Boundaries
+
+In scope:
+
+- Preserve the exact v1 CLI surface from the project Design.
+- Make bare `savepoint` print help.
+- Make command stubs return clear "not implemented yet" output where necessary.
+- Keep command functions testable without spawning Node processes.
+
+Out of scope:
+
+- Implementing `init`, `board`, `audit`, or `doctor` behavior.
+- Adding extra commands such as `task new`, `plan`, or `status`.
+- TUI rendering.
+- Project file writes.
+
+## Quality gates
+
+- Tests must cover bare invocation, help, version, unknown commands, unknown flags, and each command dispatch path.
+- CLI behavior should be deterministic with injected `argv`, `stdin`, `stdout`, `stderr`, and environment data.
+- Every branch in argument parsing and command dispatch must have a focused test.
+- During individual implementation tasks, run the focused `test/cli/**/*.test.ts` files for touched behavior first. Run the full gate suite at task closeout when practical, and always in the final E03 quality-gates task.
+
+## Design constraints
+
+- Keep process I/O at the entrypoint boundary.
+- Avoid a heavy CLI framework unless it materially reduces complexity.
+- Command names are fixed: `init`, `board`, `audit`, `doctor`.
+
+## Close Criteria
+
+- All `E03-cli-foundation` tasks are `done`.
+- `npm run build`, `npm run typecheck`, `npm run lint`, `npm run format:check`, and `npm test` pass.
+- CLI branch tests cover bare invocation, help, version, unknown commands, unknown flags, and each command dispatch path.
+- Audit snapshot exists at `.savepoint/audit/E03-cli-foundation/snapshot.md`.
+- Audit proposals are accepted, rejected, or explicitly carried forward.
+- This epic `Design.md` has `status: audited`.
+- Router points to the next epic state.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/tasks/T001-argument-parser-contract.md

@@ -0,0 +1,28 @@
+---
+id: E03-cli-foundation/T001-argument-parser-contract
+status: done
+objective: "Define the closed CLI argument parser and exit-code contract for the v1 command surface."
+depends_on: []
+---
+
+# T001: Argument Parser Contract
+
+## Scope
+
+Create the argument parsing foundation for `savepoint` without wiring command behavior yet. This task owns the closed set of global flags, command names, parser result shapes, and shared exit-code constants.
+
+## Implementation Plan
+
+- [x] Read `.savepoint/router.md`, this epic `Design.md`, this task file, and the directly touched CLI/test files.
+- [x] Add `src/cli/exit-codes.ts` with named exit-code constants for success, usage errors, and not-yet-implemented command stubs.
+- [x] Add `src/cli/args.ts` with typed parser results for bare invocation, global help/version flags, command invocation, unknown commands, and unknown flags.
+- [x] Keep allowed commands closed to `init`, `board`, `audit`, and `doctor`.
+- [x] Treat `--help`, `-h`, `--version`, and `-v` as the only allowed global flags.
+- [x] Add focused parser tests covering bare invocation, each global flag alias, each known command, unknown command, and unknown flag branches.
+- [x] Run the focused parser test file.
+
+## Acceptance Criteria
+
+- The parser is deterministic from an injected `argv` array.
+- Unknown commands and unknown flags are represented as typed parser results, not thrown exceptions.
+- Every parser branch introduced by this task has a focused test.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/tasks/T002-help-text-generation.md

@@ -0,0 +1,28 @@
+---
+id: E03-cli-foundation/T002-help-text-generation
+status: done
+objective: "Generate deterministic top-level and command-level help text for the fixed v1 CLI surface."
+depends_on:
+  - E03-cli-foundation/T001-argument-parser-contract
+---
+
+# T002: Help Text Generation
+
+## Scope
+
+Introduce the help-text module used by the runner later. This task does not dispatch commands or touch process streams.
+
+## Implementation Plan
+
+- [x] Read `.savepoint/router.md`, this epic `Design.md`, this task file, and the directly touched CLI/test files.
+- [x] Add `src/cli/help.ts` with deterministic top-level help output for bare `savepoint` and global `--help`/`-h`.
+- [x] Add command-level help output for `init`, `board`, `audit`, and `doctor`.
+- [x] Keep help content limited to the command contract from the epic Design and avoid promising unimplemented behavior.
+- [x] Add focused help tests for top-level help and each command-level help branch.
+- [x] Run the focused help test file.
+
+## Acceptance Criteria
+
+- Help text is generated by pure functions with no process I/O.
+- Top-level help lists only the fixed v1 command and global flag surface.
+- Each supported command has deterministic command-level help text.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/tasks/T003-terminal-environment-detection.md

@@ -0,0 +1,27 @@
+---
+id: E03-cli-foundation/T003-terminal-environment-detection
+status: done
+objective: "Provide injectable terminal capability detection for TTY, color, and platform behavior."
+depends_on: []
+---
+
+# T003: Terminal Environment Detection
+
+## Scope
+
+Add environment capability helpers that can be used by later CLI and TUI work. This task stays independent from command dispatch and does not read project files.
+
+## Implementation Plan
+
+- [x] Read `.savepoint/router.md`, this epic `Design.md`, this task file, and the directly touched CLI/test files.
+- [x] Add `src/cli/environment.ts` with typed inputs for stdout/stderr TTY state, environment variables, and platform.
+- [x] Detect whether stdout and stderr are TTY-capable from injected stream-like values.
+- [x] Detect color support from injected environment/platform data using conservative rules for `NO_COLOR`, `FORCE_COLOR`, and common CI/non-TTY cases.
+- [x] Add focused tests for TTY true/false branches, color disabled/enabled branches, and platform passthrough.
+- [x] Run the focused environment test file.
+
+## Acceptance Criteria
+
+- Capability detection is deterministic with injected streams, environment, and platform.
+- No helper reads directly from `process`.
+- Branching behavior for TTY and color detection is covered by focused tests.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/tasks/T004-command-stub-modules.md

@@ -0,0 +1,29 @@
+---
+id: E03-cli-foundation/T004-command-stub-modules
+status: done
+objective: "Create deterministic stub handlers for the fixed command surface without project file side effects."
+depends_on:
+  - E03-cli-foundation/T001-argument-parser-contract
+---
+
+# T004: Command Stub Modules
+
+## Scope
+
+Create command modules for the v1 surface so dispatch can call stable handler boundaries before the real command behavior exists.
+
+## Implementation Plan
+
+- [x] Read `.savepoint/router.md`, this epic `Design.md`, this task file, and the directly touched command/test files.
+- [x] Add a small command result type if needed by the stub handlers and runner.
+- [x] Add stub modules under `src/commands/` for `init`, `board`, `audit`, and `doctor`.
+- [x] Make each stub return deterministic "not implemented yet" output and the shared not-implemented exit code.
+- [x] Ensure stubs do not read, write, or discover project files.
+- [x] Add focused tests for each command stub result.
+- [x] Run the focused command-stub test file.
+
+## Acceptance Criteria
+
+- Each fixed command has a handler module with a testable function.
+- Stub outputs are clear and deterministic.
+- Command stubs have no project filesystem side effects.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/tasks/T005-cli-runner-dispatch.md

@@ -0,0 +1,34 @@
+---
+id: E03-cli-foundation/T005-cli-runner-dispatch
+status: done
+objective: "Wire the parser, help text, environment helpers, and command stubs into a testable CLI runner."
+depends_on:
+  - E03-cli-foundation/T001-argument-parser-contract
+  - E03-cli-foundation/T002-help-text-generation
+  - E03-cli-foundation/T003-terminal-environment-detection
+  - E03-cli-foundation/T004-command-stub-modules
+---
+
+# T005: CLI Runner Dispatch
+
+## Scope
+
+Add the `runCli()` boundary that later command implementations will use. This task owns command dispatch behavior, injected streams/environment, and result-to-output handling, but not the process entrypoint.
+
+## Implementation Plan
+
+- [x] Read `.savepoint/router.md`, this epic `Design.md`, this task file, and the directly touched CLI/command/test files.
+- [x] Add `src/cli/run.ts` with an injectable runner input for `argv`, `stdin`, `stdout`, `stderr`, environment, and platform data.
+- [x] Route bare invocation and global help flags to top-level help output with a success exit code.
+- [x] Route global version flags to the existing package version source with a success exit code.
+- [x] Route command-level help requests to command help output with a success exit code.
+- [x] Route known commands to their stub handlers.
+- [x] Route unknown commands and unknown flags to stderr with the usage-error exit code.
+- [x] Add focused runner tests for bare invocation, help, version, each command dispatch path, command-level help, unknown command, and unknown flag.
+- [x] Run the focused runner test file.
+
+## Acceptance Criteria
+
+- `runCli()` is testable without spawning Node or reading process globals.
+- Output routing between stdout and stderr is deterministic.
+- Every command dispatch branch required by the epic quality gates has focused coverage.

package/.savepoint/releases/v1/epics/_archived/E03-cli-foundation/tasks/T006-entrypoint-quality-gates.md

@@ -0,0 +1,32 @@
+---
+id: E03-cli-foundation/T006-entrypoint-quality-gates
+status: done
+objective: "Connect the process entrypoint to the CLI runner and complete the E03 quality-gate closeout."
+depends_on:
+  - E03-cli-foundation/T005-cli-runner-dispatch
+---
+
+# T006: Entrypoint Quality Gates
+
+## Scope
+
+Finish the CLI foundation by keeping process globals in `src/cli.ts`, running the required quality gates, and creating the E03 audit snapshot handoff.
+
+## Implementation Plan
+
+- [x] Read `.savepoint/router.md`, this epic `Design.md`, this task file, and the directly touched entrypoint/test files.
+- [x] Update `src/cli.ts` so process argv, streams, environment, platform, and exit code handling stay at the entrypoint boundary.
+- [x] Add or update entrypoint-level tests only if existing coverage does not prove the process boundary behavior.
+- [x] Run the focused CLI test files for the touched behavior.
+- [x] Run `npm run build`.
+- [x] Run `npm run typecheck`.
+- [x] Run `npm run lint`.
+- [x] Run `npm run format:check`.
+- [x] Run `npm test`.
+- [x] Create `.savepoint/audit/E03-cli-foundation/snapshot.md` with the implemented file list and quality-gate results for audit handoff.
+
+## Acceptance Criteria
+
+- Process globals are isolated to `src/cli.ts`.
+- The full E03 quality-gate command list has been run and recorded.
+- The audit snapshot exists for the next `audit-pending` state.

package/.savepoint/releases/v1/epics/_archived/E03-cli-simplify/Design.md

@@ -0,0 +1,43 @@
+---
+ type: epic-design
+ status: planned
+ ---
+
+ # Epic E03: CLI Simplify
+
+ ## Purpose
+
+ Strip the CLI down to the board command only. Remove init, audit, doctor commands and their supporting infrastructure. Update CLI tests to reflect the board-only interface.
+
+ ## What this epic adds
+
+ - Board-only argument parsing (`args.ts`).
+ - Board-only help text (`help.ts`).
+ - Board-only command dispatch (`run.ts`).
+ - Deletion of init, audit, doctor command files and their supporting directories.
+
+ ## Definition of Done
+
+ - `savepoint --help` shows only `board` command.
+ - `savepoint init/audit/doctor` returns unknown-command error.
+ - `savepoint board` still launches from TTY.
+ - No dead command code remains in `src/commands/`, `src/init/`, `src/templates/`.
+ - All CLI tests pass with board-only interface.
+ - Build and typecheck pass.
+
+ ## Components and files
+
+ | Path | Purpose |
+ |------|---------|
+ | `src/cli/args.ts` | Board-only argument parsing |
+ | `src/cli/help.ts` | Board-only help text |
+ | `src/cli/run.ts` | Board-only command dispatch |
+ | `test/cli/args.test.ts` | Updated args tests |
+ | `test/cli/help.test.ts` | Updated help tests |
+ | `test/cli/run.test.ts` | Updated runner tests |
+ | (deleted) `src/commands/init.ts` | Removed |
+ | (deleted) `src/commands/audit.ts` | Removed |
+ | (deleted) `src/commands/doctor.ts` | Removed |
+ | (deleted) `src/commands/result.ts` | Removed |
+ | (deleted) `src/init/` | Removed (5 files) |
+ | (deleted) `src/templates/` | Removed (5 files) |

package/.savepoint/releases/v1/epics/_archived/E03-cli-simplify/tasks/T001-strip-args.md

@@ -0,0 +1,26 @@
+---
+id: E03-cli-simplify/T001-strip-args
+status: planned
+objective: "Remove init, audit, doctor from args.ts; keep only board + version + help"
+depends_on: [E02-domain-phase-model/T004-simplify-router-domain]
+---
+
+# T001: Strip Args
+
+## Acceptance Criteria
+
+- `args.ts` defines only `board` as an allowed command.
+- `ParseResult` union has no init, audit, or doctor variants.
+- `--version` and `--help` still work.
+- Unknown commands return appropriate error.
+- All args tests pass.
+
+## Implementation Plan
+
+- [ ] Read existing `args.ts` and `test/cli/args.test.ts`.
+- [ ] Remove `InitOptions`, `AuditOptions` interfaces.
+- [ ] Remove init/audit parse result variants from `ParseResult`.
+- [ ] Remove `parseInitArgs`, `parseAuditArgs`.
+- [ ] Simplify `parseArgs` to handle only `board`, `--help`, `--version`.
+- [ ] Update `test/cli/args.test.ts`.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E03-cli-simplify/tasks/T002-strip-help.md

@@ -0,0 +1,23 @@
+---
+id: E03-cli-simplify/T002-strip-help
+status: planned
+objective: "Remove init, audit, doctor help text from help.ts"
+depends_on: [E03-cli-simplify/T001-strip-args]
+---
+
+# T002: Strip Help
+
+## Acceptance Criteria
+
+- `help.ts` top-level help shows only `board` command.
+- `commandHelp('board')` returns board-specific help text.
+- No help text for init, audit, or doctor exists.
+- All help tests pass.
+
+## Implementation Plan
+
+- [ ] Read existing `help.ts` and `test/cli/help.test.ts`.
+- [ ] Remove init/audit/doctor help text blocks.
+- [ ] Update top-level help to list only `board`.
+- [ ] Update `test/cli/help.test.ts`.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E03-cli-simplify/tasks/T003-strip-run.md

@@ -0,0 +1,23 @@
+---
+id: E03-cli-simplify/T003-strip-run
+status: planned
+objective: "Remove init, audit, doctor dispatch from run.ts; keep only board"
+depends_on: [E03-cli-simplify/T001-strip-args]
+---
+
+# T003: Strip Run
+
+## Acceptance Criteria
+
+- `run.ts` imports only `runBoard` from commands.
+- `runCli` dispatches only `board`, `--version`, and `--help`.
+- No dead imports (init, audit, doctor).
+- All runner tests pass.
+
+## Implementation Plan
+
+- [ ] Read existing `run.ts` and `test/cli/run.test.ts`.
+- [ ] Remove imports of `runInit`, `runAudit`, `runDoctor`.
+- [ ] Remove init/audit/doctor dispatch branches.
+- [ ] Update `test/cli/run.test.ts`.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E03-cli-simplify/tasks/T004-delete-commands.md

@@ -0,0 +1,24 @@
+---
+id: E03-cli-simplify/T004-delete-commands
+status: planned
+objective: "Delete dead command files and supporting directories"
+depends_on: [E03-cli-simplify/T003-strip-run]
+---
+
+# T004: Delete Commands
+
+## Acceptance Criteria
+
+- `src/commands/init.ts`, `audit.ts`, `doctor.ts`, `result.ts` do not exist.
+- `src/init/` directory does not exist.
+- `src/templates/` directory does not exist.
+- Build still compiles (no broken imports from deleted files).
+
+## Implementation Plan
+
+- [ ] Verify no remaining imports reference files to be deleted.
+- [ ] Delete `src/commands/init.ts`, `audit.ts`, `doctor.ts`, `result.ts`.
+- [ ] Delete `src/init/` directory and all files within.
+- [ ] Delete `src/templates/` directory and all files within.
+- [ ] Run `npm run build` to confirm no broken imports.
+- [ ] Run `npm run typecheck`.

package/.savepoint/releases/v1/epics/_archived/E03-cli-simplify/tasks/T005-update-cli-tests.md

@@ -0,0 +1,22 @@
+---
+id: E03-cli-simplify/T005-update-cli-tests
+status: planned
+objective: "Update CLI tests to reflect board-only interface"
+depends_on: [E03-cli-simplify/T003-strip-run]
+---
+
+# T005: Update CLI Tests
+
+## Acceptance Criteria
+
+- All CLI tests pass with board-only interface.
+- No test cases reference init, audit, or doctor commands.
+- `test/cli/`, `test/commands/` contain only board-relevant tests.
+- `npm test` passes.
+
+## Implementation Plan
+
+- [ ] Review all files in `test/cli/` and `test/commands/`.
+- [ ] Update or delete tests referencing init/audit/doctor.
+- [ ] Ensure board command tests still cover TTY and non-TTY paths.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E04-board-phase-integration/Design.md

@@ -0,0 +1,48 @@
+---
+ type: epic-design
+ status: planned
+ ---
+
+ # Epic E04: Board Phase Integration
+
+ ## Purpose
+
+ Integrate the phase model into the board TUI. Render phase letters on in_progress tasks, enable phase stepping via keyboard, enforce phase gating, and write phase back to task frontmatter. Remove the audit-review flow entirely.
+
+ ## What this epic adds
+
+ - Phase letter rendering (B/T/A) with phase-derived colors on in_progress task cards.
+ - Phase stepping: space advances (build→test→audit→done), backspace retreats.
+ - Phase gating: cannot advance to done unless phase is audit; cannot skip phases.
+ - Phase write-back: `phase` field written alongside `status` in task frontmatter.
+ - Complete removal of audit proposal loading, AuditReviewApp, and audit event logging.
+
+ ## Definition of Done
+
+ - Board renders phase letters on in_progress task cards with correct colors.
+ - Space/backspace walks through phases; done requires audit phase.
+ - Detail pane shows current phase and phase-aware transition preview.
+ - Task files are updated with `phase` field on transition.
+ - No audit-review code remains in `src/tui/audit-review/` or `src/commands/board.ts`.
+ - All board tests pass with phase model.
+ - Build and typecheck pass.
+
+ ## Components and files
+
+ | Path | Purpose |
+ |------|---------|
+ | `src/tui/board-data.ts` | Phase on BoardTask; remove auditProposalsAvailable |
+ | `src/tui/Board.tsx` | Phase letter rendering on task cards |
+ | `src/tui/DetailPane.tsx` | Phase display and transition preview |
+ | `src/tui/App.tsx` | Phase stepping in input handler; remove audit request |
+ | `src/tui/io/gates.ts` | Phase-aware gate enforcement |
+ | `src/tui/io/write-status.ts` | Phase write-back to frontmatter |
+ | `src/tui/io/write-active-router-epic.ts` | Updated for 3-state router |
+ | `src/tui/io/write-active-router-release.ts` | Updated for 3-state router |
+ | `src/tui/state/app-reducer.ts` | Remove auditProposalsAvailable from state |
+ | `src/commands/board.ts` | Remove audit flow |
+ | `test/tui/board-data.test.ts` | Phase data model tests |
+ | `test/tui/state/` | Phase-aware state tests |
+ | `test/tui/io/` | Phase write and gate tests |
+ | `test/commands/board.test.ts` | Updated board command tests |
+ | (deleted) `src/tui/audit-review/` | Removed (5 files) |

package/.savepoint/releases/v1/epics/_archived/E04-board-phase-integration/tasks/T001-board-data-phases.md

@@ -0,0 +1,26 @@
+---
+id: E04-board-phase-integration/T001-board-data-phases
+status: planned
+objective: "Add phase to BoardTask; remove auditProposalsAvailable from board-data.ts"
+depends_on: [E02-domain-phase-model/T002-phase-frontmatter]
+---
+
+# T001: Board Data Phases
+
+## Acceptance Criteria
+
+- `BoardTask` interface includes `phase?: TaskPhase`.
+- `buildBoardData` carries phase from task frontmatter to board tasks.
+- `BoardData` interface has no `auditProposalsAvailable` field.
+- `toBoardTask` copies phase from task document.
+- `test/tui/board-data.test.ts` passes with phase data.
+
+## Implementation Plan
+
+- [ ] Read `board-data.ts` and `test/tui/board-data.test.ts`.
+- [ ] Add `phase?: TaskPhase` to `BoardTask`.
+- [ ] Remove `auditProposalsAvailable` from `BoardData`.
+- [ ] Update `toBoardTask` to copy phase.
+- [ ] Update `buildBoardData` signature and body.
+- [ ] Update board-data tests.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E04-board-phase-integration/tasks/T002-phase-rendering.md

@@ -0,0 +1,28 @@
+---
+id: E04-board-phase-integration/T002-phase-rendering
+status: planned
+objective: "Render phase glyphs with phase-derived color on in_progress task cards in Board.tsx"
+depends_on: [E04-board-phase-integration/T001-board-data-phases]
+---
+
+# T002: Phase Rendering
+
+## Acceptance Criteria
+
+- In_progress task cards show phase glyphs inline: `▣` (build), `◇` (test), `◆` (audit).
+- Phase glyph uses the accent color mapped by `PHASE_ACCENTS`.
+- Planned and done task cards show no phase glyph.
+- Cards are fixed width, titles are truncated (never wrap), metadata is dimmed.
+- Focused card has accent border (Atari Orange) and slight background tint.
+- Rendering works for 24-bit, 256-color, 16-color, and `NO_COLOR=1` terminals.
+- Board component tests pass.
+
+## Implementation Plan
+
+- [ ] Read `Board.tsx` and `test/tui/components/`.
+- [ ] Import `PHASE_ACCENTS` and `TaskPhase` in Board.
+- [ ] Add `PHASE_GLYPHS` map: build→▣, test→◇, audit→◆.
+- [ ] Update `TaskCardComponent` to accept phase and render glyph with phase color.
+- [ ] Apply card styling rules: fixed width, truncate title, dimmed metadata, accent border on focus.
+- [ ] Update component tests.
+- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E04-board-phase-integration/tasks/T003-detail-pane-phases.md

@@ -0,0 +1,27 @@
+---
+id: E04-board-phase-integration/T003-detail-pane-phases
+status: planned
+objective: "Render detail pane as centered overlay with board visible behind; add Esc close"
+depends_on: [E04-board-phase-integration/T001-board-data-phases]
+---
+
+# T003: Detail Pane Overlay
+
+## Acceptance Criteria
+
+- Detail pane renders as a centered overlay on top of the board.
+- Board remains visible and dimmed behind the overlay.
+- Overlay shows: task ID, title, epic, release, status, current phase, description, acceptance criteria.
+- Pressing `Esc` closes the overlay.
+- Overlay width is calculated from terminal size (max 40 chars, or terminal width - 4).
+- No layout breaks at any terminal width.
+
+## Implementation Plan
+
+- [ ] Read `DetailPane.tsx` and `test/tui/components/`.
+- [ ] Convert DetailPane from replacing board to overlay mode.
+- [ ] Add board dimming behind overlay (reduce opacity or dark tint).
+- [ ] Add `Esc` handler in `App.tsx` to close overlay.
+- [ ] Calculate overlay width from `useWindowSize`.
+- [ ] Update component tests.
+- [ ] Run `npm test`.