savepoint 1.0.4 → 1.0.7

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T007-verify.md

@@ -1,25 +0,0 @@
----
-id: E05-project-cleanup/T007-verify
-status: planned
-objective: "Run full verification: build, typecheck, lint, test"
-depends_on: [E05-project-cleanup/T006-clean-package-json]
----
-
-# T007: Verify
-
-## Acceptance Criteria
-
-- `npm run build` passes.
-- `npm run typecheck` passes.
-- `npm run lint` passes.
-- `npm test` passes.
-- No errors, no warnings, no dead code.
-
-## Implementation Plan
-
-- [ ] Run `npm run build`.
-- [ ] Run `npm run typecheck`.
-- [ ] Run `npm run lint`.
-- [ ] Run `npm test`.
-- [ ] Fix any failures.
-- [ ] Repeat until all gates pass.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/Design.md

@@ -1,104 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# Epic E06: tui-board
-
-## Purpose
-
-Implement `savepoint board`, an Ink-based terminal UI for viewing and moving tasks through the Savepoint workflow, including audit-review mode entry points. The board should make the file-backed state machine usable without replacing direct file editing.
-
-## What this epic adds
-
-- Ink app shell launched by `savepoint board`.
-- Three-column Kanban view for `planned`, `in_progress`, and `done`.
-- Detail pane for the selected task.
-- Keyboard navigation using arrows and vim-style movement.
-- Status transition actions with gate enforcement.
-- Manual refresh.
-- Theme tokens loaded from `config.yml`.
-- Render fallbacks for 24-bit/256-color, 16-color, `NO_COLOR=1`, and non-TTY plain table output.
-- Optimistic mtime conflict detection before writes.
-- Reducer tests for navigation, selection, and transition behavior.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                            | Purpose                                            |
-| ------------------------------- | -------------------------------------------------- |
-| `src/commands/board.ts`         | Command entrypoint and non-TTY fallback.           |
-| `src/tui/App.tsx`               | Ink app root.                                      |
-| `src/tui/Board.tsx`             | Kanban layout.                                     |
-| `src/tui/DetailPane.tsx`        | Selected task details.                             |
-| `src/tui/state/*.ts`            | Reducers and derived view state.                   |
-| `src/tui/theme/*.ts`            | Theme loading and terminal color fallback mapping. |
-| `src/tui/render/plain-table.ts` | Non-TTY table rendering.                           |
-| `src/tui/io/*.ts`               | Safe task status write helpers and mtime checks.   |
-| `test/tui/**/*.test.ts`         | Reducer and fallback rendering tests.              |
-
-## Architectural delta
-
-Before this epic, Savepoint can read project files and expose CLI commands. After this epic, users can inspect and advance workflow state through a terminal interface.
-
-The TUI uses the domain layer for rules and the filesystem layer for reads/writes. It should not define independent workflow logic.
-
-## Visual and interaction design
-
-The terminal adaptation of Atari-Noir applies here:
-
-- Dark background with warm off-white text where terminal color support allows.
-- One accent color per major semantic area.
-- Quiet borders and compact uppercase headings.
-- Focus shown through accent borders or subtle background tint.
-- Colored glyphs should reinforce state but never be the only signal.
-- Scanlines and web-style glow are skipped in terminal rendering.
-
-## Boundaries
-
-In scope:
-
-- Board navigation and status transitions.
-- Gate enforcement for dependencies and status rules.
-- Plain table fallback when not in a TTY.
-- Manual `r` refresh.
-- Initial audit-review mode entry point if audit proposals exist.
-
-## Implemented as
-
-- `savepoint board` now reads the Savepoint root, router state, config, and active epic task set through existing readers.
-- Non-TTY sessions render deterministic plain text with warnings and audit-entry signaling.
-- TTY sessions launch an Ink app with five status columns, selected-task detail, keyboard navigation, surfaced load warnings, manual refresh, forward/backward transition actions, and audit proposal handoff.
-- Reducers in `src/tui/state/` own derived view state only; workflow truth remains in project files.
-- Transition gates combine domain status validation with dependency completion checks.
-- Status writes preserve task body and extra frontmatter fields, re-stat after parsing, and return non-destructive conflict/error results.
-- Theme helpers map configured tokens into truecolor, 256-color, 16-color, and no-color palettes.
-
-## Audit deltas
-
-- Full proposal diff review remains deferred to `E07-audit-pipeline`; E06 only signals that proposals exist and exits toward `savepoint audit`.
-- Rich TUI rendering is covered with deterministic component assertions instead of full-screen snapshots.
-- Conflict UX is implemented as a message plus manual refresh, not an interactive reload prompt.
-
-Out of scope:
-
-- File watching.
-- Search.
-- Mouse interaction.
-- Drag-and-drop.
-- Full audit proposal diff implementation beyond what `audit-pipeline` needs.
-- Snapshot tests for rich TUI rendering.
-
-## Quality gates
-
-- Reducers and transition behavior should be covered by tests.
-- Rendering tests should focus on deterministic fallback/plain output, not brittle full-screen snapshots.
-- Conflict detection should be tested without relying on real-time delays where possible.
-
-## Design constraints
-
-- Keep workflow state in files; the TUI holds only derived view state.
-- Use mtime-based optimistic concurrency.
-- Do not create a lockfile.
-- Keep terminal controls discoverable but avoid loading screens with long instructions.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/tasks/T001-board-command-data.md

@@ -1,23 +0,0 @@
----
-id: E06-tui-board/T001-board-command-data
-status: done
-objective: "Replace the board stub with a data-backed command path that can read the active Savepoint project and render deterministic plain output."
-depends_on: []
----
-
-# T001: board-command-data
-
-## Implementation Plan
-
-- [x] Add the command context needed by `runBoard()` to know the current working directory, stdout TTY capability, environment, and platform without breaking existing command handlers.
-- [x] Resolve the Savepoint project root from the command context and surface boundary errors through existing CLI exit-code conventions.
-- [x] Load router state, config, and the active epic task set through existing readers instead of parsing workflow files inside the command.
-- [x] Introduce a small board data model that groups tasks by the five canonical statuses and records the active release, epic, task, and reader errors.
-- [x] Implement `src/tui/render/plain-table.ts` as the deterministic non-TTY fallback for columns, selected task marker, and empty states.
-- [x] Update board command and runner tests to prove `savepoint board` no longer returns the not-implemented stub in an initialized project and still reports readable errors outside a Savepoint project.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T001-board-command-data.md`; `.savepoint/metrics/context-bench.md`; `src/commands/board.ts`; `src/cli/run.ts`; `src/cli/environment.ts`; `src/domain/config.ts`; `src/domain/status.ts`; `src/domain/task.ts`; `src/fs/markdown.ts`; `src/fs/project.ts`; `src/readers/config.ts`; `src/readers/router.ts`; `src/readers/tasks.ts`; `src/validation/dependencies.ts`; `test/cli/run.test.ts`; `test/domain/status.test.ts`; `package.json`; `src/cli.ts`; `src/commands/audit.ts`; `src/commands/doctor.ts`; `src/commands/init.ts`; `test/init/validate-target.test.ts`; `test/readers/router.test.ts`; `test/domain/router.test.ts`; `test/cli/commands.test.ts`; `src/domain/router.ts`; `src/domain/ids.ts`; `src/cli/exit-codes.ts`; `src/commands/result.ts`
-- Estimated input tokens: ~19,660
-- Notes: Rehydrated from router, E06 Design, task file, and directly touched source/test files. Extended router schema with optional `task` field to match live `router.md` format. Board command now async with rich result shape matching `runInit` pattern.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/tasks/T002-board-view-state.md

@@ -1,24 +0,0 @@
----
-id: E06-tui-board/T002-board-view-state
-status: done
-objective: "Create pure board view-state reducers for column grouping, selected-task movement, refresh replacement, and keyboard-intent actions."
-depends_on:
-  - E06-tui-board/T001-board-command-data
----
-
-# T002: board-view-state
-
-## Implementation Plan
-
-- [x] Add `src/tui/state/` modules that derive board columns and task indexes from the T001 board data model without storing duplicate workflow truth.
-- [x] Model selection state so it survives same-task refreshes, falls back predictably when tasks disappear, and handles empty columns.
-- [x] Implement reducer actions for left/right/up/down movement plus vim-style `h`, `j`, `k`, and `l` intents.
-- [x] Add refresh replacement behavior that swaps in newly read task data while preserving selection and visible status columns.
-- [x] Keep transition and filesystem write behavior out of this reducer task so the reducer remains pure.
-- [x] Add focused reducer tests for initial selection, horizontal and vertical navigation, empty columns, and refresh after task reorder/removal.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T002-board-view-state.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T001-board-command-data.md`; `src/tui/board-data.ts`; `src/tui/render/plain-table.ts`; `src/domain/status.ts`; `src/domain/task.ts`; `src/commands/board.ts`; `test/domain/status.test.ts`; `package.json`; `tsconfig.json`; `.savepoint/metrics/context-bench.md`
-- Estimated input tokens: ~6,925
-- Notes: Rehydrated from router, E06 Design, task file, and directly touched source/test files. Implemented pure reducer with deterministic selection fallbacks and refresh behavior.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/tasks/T003-transition-gates-and-writes.md

@@ -1,25 +0,0 @@
----
-id: E06-tui-board/T003-transition-gates-and-writes
-status: done
-objective: "Add task transition gate evaluation and optimistic mtime-safe status writes for board actions."
-depends_on:
-  - E06-tui-board/T001-board-command-data
-  - E06-tui-board/T002-board-view-state
----
-
-# T003: transition-gates-and-writes
-
-## Implementation Plan
-
-- [x] Add pure gate evaluation that combines `validateTransition()` with dependency rules so tasks cannot advance when required dependencies are not `done`.
-- [x] Return structured gate results that the TUI can display without duplicating workflow logic in rendering components.
-- [x] Add `src/tui/io/` helpers that read a task file's mtime before action and verify it is unchanged immediately before writing.
-- [x] Update only the task frontmatter `status` field while preserving the task body and unrelated frontmatter fields.
-- [x] Surface stale mtime conflicts as non-destructive action results that require a manual refresh before retry.
-- [x] Add tests for allowed transitions, blocked dependencies, disallowed status jumps, successful status write preservation, and stale mtime conflict handling without relying on real-time delays.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T003-transition-gates-and-writes.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T001-board-command-data.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T002-board-view-state.md`; `.savepoint/metrics/context-bench.md`; `package.json`; `tsconfig.json`; `vitest.config.js`; `src/domain/status.ts`; `src/domain/task.ts`; `src/domain/ids.ts`; `src/validation/dependencies.ts`; `src/fs/markdown.ts`; `src/readers/tasks.ts`; `src/commands/board.ts`; `src/tui/board-data.ts`; `src/tui/state/reducer.ts`; `src/tui/state/view-state.ts`; `src/tui/render/plain-table.ts`; `test/tui/state/reducer.test.ts`; `test/tui/render/plain-table.test.ts`; `test/fs/markdown.test.ts`
-- Estimated input tokens: ~19,630
-- Notes: Implementation rehydrated from router, E06 Design, task file, and directly touched source/test files. Extended `MarkdownDoc` with `rawFrontmatter` to preserve extra frontmatter fields during status writes. Gate evaluator allows idempotent same-status transitions and blocks only forward moves with undone dependencies.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/tasks/T004-terminal-theme.md

@@ -1,23 +0,0 @@
----
-id: E06-tui-board/T004-terminal-theme
-status: done
-objective: "Load board theme tokens from config and map them into deterministic terminal color palettes for rich and fallback environments."
-depends_on:
-  - E06-tui-board/T001-board-command-data
----
-
-# T004: terminal-theme
-
-## Implementation Plan
-
-- [x] Add `src/tui/theme/` modules that consume `SavepointConfig["theme"]` and expose board-specific semantic tokens for statuses, borders, text, focus, and blocked states.
-- [x] Implement terminal color capability mapping for 24-bit, 256-color, 16-color, `NO_COLOR=1`, `FORCE_COLOR`, `TERM=dumb`, and non-TTY plain output.
-- [x] Keep color fallback data deterministic and separate from Ink components so render tests can avoid full-screen snapshots.
-- [x] Respect configured border style values while preserving readable defaults when config values are missing or colors are disabled.
-- [x] Add tests for config defaults, custom accents, no-color mode, dumb terminals, and reduced palettes.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T004-terminal-theme.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T003-transition-gates-and-writes.md`; `package.json`; `tsconfig.json`; `src/domain/config.ts`; `src/cli/environment.ts`; `src/commands/board.ts`; `src/domain/status.ts`; `src/tui/board-data.ts`; `src/tui/render/plain-table.ts`; `src/tui/state/view-state.ts`; `src/tui/state/reducer.ts`; `src/tui/io/gates.ts`; `src/tui/io/write-status.ts`; `test/tui/state/reducer.test.ts`; `test/tui/render/plain-table.test.ts`
-- Estimated input tokens: ~14,752
-- Notes: Implemented theme capability detection, 256/16 color approximation, and palette builder with semantic tokens. Rehydrated from router, E06 Design, T004 task, T003 task for dependency state, and directly touched source/test files.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/tasks/T005-ink-board-ui.md

@@ -1,26 +0,0 @@
----
-id: E06-tui-board/T005-ink-board-ui
-status: done
-objective: "Build the Ink board UI shell with keyboard navigation, detail pane, manual refresh, and transition actions."
-depends_on:
-  - E06-tui-board/T002-board-view-state
-  - E06-tui-board/T003-transition-gates-and-writes
-  - E06-tui-board/T004-terminal-theme
----
-
-# T005: ink-board-ui
-
-## Implementation Plan
-
-- [x] Add the minimum Ink and React dependencies and TypeScript configuration needed for `src/tui/**/*.tsx` while keeping the CLI build ESM-compatible on Node 20.
-- [x] Implement `src/tui/App.tsx` as the stateful app root that receives initial board data, theme, refresh/write callbacks, and terminal capability data.
-- [x] Implement `src/tui/Board.tsx` with five compact status columns, selected-task focus treatment, empty-column states, and keyboard hints that do not dominate the screen.
-- [x] Implement `src/tui/DetailPane.tsx` for selected task objective, status, dependencies, gate state, and last action/conflict messages.
-- [x] Wire arrow keys, vim-style navigation, manual `r` refresh, and transition actions through the pure reducer and IO helpers.
-- [x] Add focused tests around reducer-connected interaction behavior and component output where deterministic, avoiding brittle full-screen TUI snapshots.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T005-ink-board-ui.md`; `.savepoint/visual-identity.md`; `.savepoint/metrics/context-bench.md`; `package.json`; `tsconfig.json`; `vitest.config.js`; `src/commands/board.ts`; `src/cli/run.ts`; `src/cli/environment.ts`; `src/domain/config.ts`; `src/domain/ids.ts`; `src/domain/status.ts`; `src/domain/task.ts`; `src/fs/project.ts`; `src/readers/tasks.ts`; `src/tui/board-data.ts`; `src/tui/state/reducer.ts`; `src/tui/state/view-state.ts`; `src/tui/theme/index.ts`; `src/tui/theme/palette.ts`; `src/tui/theme/capability.ts`; `src/tui/io/gates.ts`; `src/tui/io/write-status.ts`; `src/tui/render/plain-table.ts`; `test/tui/state/reducer.test.ts`; `test/tui/io/gates.test.ts`; `test/tui/io/write-status.test.ts`; `test/tui/render/plain-table.test.ts`; `test/tui/theme/capability.test.ts`; `test/tui/theme/palette.test.ts`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T002-board-view-state.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T003-transition-gates-and-writes.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T004-terminal-theme.md`
-- Estimated input tokens: ~18,000
-- Notes: Rehydrated from router, E06 Design, T005 task, prerequisite task files (T002-T004), visual-identity, and directly touched source/test files. Added Ink 7 + React 19 with JSX support, extended EnvMap with COLORTERM, and built App/Board/DetailPane components with keyboard-driven navigation and transition actions.

package/.savepoint/releases/v1/epics/_archived/E06-tui-board/tasks/T006-board-integration-audit-entry.md

@@ -1,24 +0,0 @@
----
-id: E06-tui-board/T006-board-integration-audit-entry
-status: done
-objective: "Integrate the rich board command end to end and add the initial audit-review entry point when audit proposals are present."
-depends_on:
-  - E06-tui-board/T005-ink-board-ui
----
-
-# T006: board-integration-audit-entry
-
-## Implementation Plan
-
-- [x] Update `runBoard()` so TTY sessions launch the Ink app and non-TTY sessions use the plain table fallback from T001.
-- [x] Ensure command execution handles missing project files, task graph errors, config errors, refresh failures, write conflicts, and user exit with clear stdout/stderr behavior.
-- [x] Add audit proposal discovery for the active epic and expose an initial board entry point when `.savepoint/audit/{epic}/proposals.md` exists.
-- [x] Keep audit-review behavior limited to entry signaling and navigation handoff; leave full proposal diff review to `E07-audit-pipeline`.
-- [x] Add integration tests for TTY vs non-TTY dispatch, fallback rendering, audit-entry detection, and unchanged help/unknown-flag behavior.
-- [x] Run the focused TUI/CLI tests first, then run typecheck, lint, format check, build, and the smoke suite before moving the task to review.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/tasks/T006-board-integration-audit-entry.md`; `.savepoint/metrics/context-bench.md`; `package.json`; `vitest.config.js`; `src/commands/board.ts`; `src/cli/run.ts`; `src/cli/environment.ts`; `src/cli/help.ts`; `src/commands/audit.ts`; `src/tui/App.tsx`; `src/tui/board-data.ts`; `src/tui/Board.tsx`; `src/tui/DetailPane.tsx`; `src/tui/io/gates.ts`; `src/tui/io/write-status.ts`; `src/tui/render/plain-table.ts`; `src/tui/state/app-reducer.ts`; `src/tui/state/reducer.ts`; `src/tui/state/view-state.ts`; `src/tui/theme/capability.ts`; `src/tui/theme/palette.ts`; `src/fs/project.ts`; `test/cli/run.test.ts`; `test/commands/board.test.ts`; `test/commands/board-tty.test.ts`; `test/tui/state/app-reducer.test.ts`; `test/tui/render/plain-table.test.ts`; `test/tui/state/reducer.test.ts`
-- Estimated input tokens: ~28,568
-- Notes: Implemented audit proposal discovery, plain-table signal, Ink banner and key handler, and handoff message. Added board-tty integration tests with mocked ink. All quality gates passed.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/Design.md

@@ -1,88 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# Epic E07: audit-pipeline
-
-## Purpose
-
-Implement `savepoint audit`, the hard gate that reconciles built code with Savepoint documentation before the next epic can start. This epic ships the v0.1.0 audit loop without AI semantic review content.
-
-## What this epic adds
-
-- Quality gate runner for configured lint, typecheck, and test commands.
-- Gitignore-respecting snapshot generation.
-- Changed-files listing without embedding code contents in the snapshot.
-- Router transition into audit-pending state.
-- Audit prompt output for the user to give to an AI agent.
-- Proposal directory creation.
-- TUI review mode for approving, rejecting, or editing proposed documentation updates.
-- Commit step that applies approved proposals to live files.
-- Audit log entries, including skipped audits and reasons.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                           | Purpose                                         |
-| ------------------------------ | ----------------------------------------------- |
-| `src/commands/audit.ts`        | Audit command entrypoint.                       |
-| `src/audit/quality-gates.ts`   | Configured command runner.                      |
-| `src/audit/snapshot.ts`        | File tree and changed-file snapshot generation. |
-| `src/audit/router-state.ts`    | Audit-pending state updates.                    |
-| `src/audit/prompts.ts`         | Audit handoff prompt generation.                |
-| `src/audit/proposals.ts`       | Proposal discovery and validation.              |
-| `src/audit/apply-proposals.ts` | Approved proposal application.                  |
-| `src/audit/log.ts`             | Audit log writes.                               |
-| `src/tui/audit-review/*.tsx`   | Proposal review UI.                             |
-| `test/audit/**/*.test.ts`      | Audit pipeline tests.                           |
-
-## Implemented as
-
-- `src/commands/audit.ts` resolves the target epic from `--epic` or router state, supports `--skip --reason`, runs configured quality gates, writes bounded audit artifacts, transitions the router into `audit-pending`, logs audit events, and prints the audit handoff prompt.
-- `src/audit/quality-gates.ts`, `snapshot.ts`, `router-state.ts`, `prompts.ts`, `proposals.ts`, `apply-proposals.ts`, and `log.ts` keep audit gates, snapshot generation, router updates, prompt text, proposal parsing, proposal application, and audit logging separately testable.
-- `src/commands/board.ts` detects proposal availability and launches `src/tui/audit-review/AuditReviewApp.tsx` after the board exits through the audit-review entry path.
-- `src/tui/audit-review/state.ts`, `summary.ts`, `ProposalList.tsx`, `OperationDetail.tsx`, and `AuditReviewApp.tsx` model and render proposal review decisions, replacement edits, apply status, high-divergence acknowledgement, and audit review outcomes.
-- `test/audit/`, `test/commands/audit.test.ts`, `test/cli/{args,run}.test.ts`, and `test/tui/audit-review/` cover the audit command contract, quality gates, snapshots, prompt generation, proposal validation/application, review state, Ink interactions, and end-to-end lifecycle behavior.
-
-Implementation deltas from the original plan:
-
-- Proposal review is launched from the board audit-entry path rather than a separate `savepoint audit review` command.
-- The audit command creates `.savepoint/audit/{epic}/proposals/`; reconciliation writes one `proposals/proposals.md` bundle, and the loader rejects multiple bundles to keep review state aligned with the workflow.
-- AI semantic review remains manual and advisory through the handoff prompt, matching the epic's out-of-scope boundary for API calls and automatic semantic findings.
-
-## Architectural delta
-
-Before this epic, Savepoint can manage workflow state but cannot enforce the documentation audit gate. After this epic, completing an epic can produce a bounded audit context and block progress until documentation proposals are reviewed.
-
-The audit pipeline bridges CLI, filesystem, config, templates, and TUI review mode, but each step should remain separately testable.
-
-## Boundaries
-
-In scope:
-
-- Implement the six-step audit pipeline except AI semantic review generation.
-- Support `--skip --reason`.
-- Support `--epic` when an explicit epic is needed.
-- Generate `.savepoint/audit/{epic}/snapshot.md`.
-- Generate `.savepoint/audit/{epic}/proposals/`.
-
-Out of scope:
-
-- Writing semantic-review findings automatically.
-- Calling AI APIs.
-- Inferring code quality beyond configured mechanical gates.
-- Complex merge conflict resolution for proposal application.
-
-## Quality gates
-
-- Tests should cover passing/failing quality gates, snapshot generation, skip logging, proposal validation, and approved proposal application.
-- Snapshot generation must not include source code contents.
-- Failed blocking quality gates must stop the audit before snapshot generation.
-
-## Design constraints
-
-- Keep audit context bounded to protect token budgets.
-- Treat proposal application as a filesystem boundary with explicit failure states.
-- Preserve user edits and require confirmation for high-divergence proposal application through the TUI.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T001-audit-cli-contract.md

@@ -1,23 +0,0 @@
----
-id: E07-audit-pipeline/T001-audit-cli-contract
-status: done
-objective: Define the audit command contract, explicit epic selection, and skip-with-reason logging path without running the full audit pipeline.
-depends_on: []
----
-
-# T001: audit-cli-contract
-
-## Implementation Plan
-
-- [x] Extend CLI parsing and help text for `savepoint audit --epic <epic>`, `--skip`, and `--reason <text>` while rejecting invalid flag combinations.
-- [x] Replace the audit stub with a boundary-safe command handler that resolves the Savepoint project root and active epic from `--epic` or the router state.
-- [x] Add audit path and log helpers that can create `.savepoint/audit/{epic}/` and record skipped audits with timestamp, epic, and reason.
-- [x] Keep the non-skip path explicit and non-destructive until the pipeline tasks are available.
-- [x] Add focused CLI tests for help output, option parsing, explicit epic selection, skip success, missing reason, and invalid reason usage.
-- [x] Run the focused audit CLI tests before handing off the task.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/tasks/T001-audit-cli-contract.md`; `src/cli/args.ts`; `src/cli/help.ts`; `src/cli/run.ts`; `src/cli/exit-codes.ts`; `src/commands/audit.ts`; `src/commands/board.ts`; `src/commands/result.ts`; `src/domain/router.ts`; `src/fs/project.ts`; `src/fs/markdown.ts`; `src/readers/router.ts`; `test/cli/args.test.ts`; `test/cli/run.test.ts`; `test/cli/commands.test.ts`; `test/commands/board.test.ts`
-- Estimated input tokens: ~18,000
-- Notes: Added `AuditOptions` interface and `parseAuditArgs()` to `src/cli/args.ts`; audit now has its own `"audit-command"` and `"audit-invalid-options"` ParseResult kinds. Created `src/audit/log.ts` for skip logging. Replaced audit stub in `src/commands/audit.ts` with async `runAudit(ctx: AuditContext)`. Updated `run.ts` to dispatch audit-command and audit-invalid-options. 500 tests passing, 0 failures.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T002-quality-gate-runner.md

@@ -1,23 +0,0 @@
----
-id: E07-audit-pipeline/T002-quality-gate-runner
-status: done
-objective: Run configured audit quality gates with deterministic pass/fail results and no snapshot side effects.
-depends_on: []
----
-
-# T002: quality-gate-runner
-
-## Implementation Plan
-
-- [x] Introduce `src/audit/quality-gates.ts` with a small typed model for configured lint, typecheck, test, and future gate commands.
-- [x] Implement an injectable command runner that executes gates in project-root context and captures exit code, stdout, stderr, duration, and spawn failures.
-- [x] Normalize empty or missing gate configuration into the project defaults without hard-coding command execution inside the CLI command.
-- [x] Return an aggregate result that clearly distinguishes pass, blocking failure, and runner error so orchestration can stop before snapshot generation.
-- [x] Add unit tests for all-pass gates, nonzero failures, spawn errors, empty gate lists, output capture, and deterministic execution order.
-- [x] Run the focused audit quality-gate tests before handing off the task.
-
-## Context Log
-
-- Files read: `.savepoint/router.md` (via AGENTS.md routing); `AGENTS.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `T001-audit-cli-contract.md`; `T002-quality-gate-runner.md`; `src/commands/audit.ts`; `src/audit/log.ts`; `src/domain/config.ts`; `src/readers/config.ts`; `src/fs/project.ts`; `src/cli/args.ts`; `test/commands/audit.test.ts`
-- Estimated input tokens: ~8,500
-- Notes: Created `src/audit/quality-gates.ts` with `Gate`, `GateResult`, `QualityGateOutcome`, `CommandRunner` types, `normalizeGates()`, `defaultRunner()`, and `runQualityGates()`. Created `test/audit/quality-gates.test.ts` with 13 tests covering all-pass, blocking failure, non-blocking failure, spawn errors, empty gates, output capture, duration recording, and deterministic order. All 13 tests pass.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T003-snapshot-and-prompt.md

@@ -1,23 +0,0 @@
----
-id: E07-audit-pipeline/T003-snapshot-and-prompt
-status: done
-objective: Generate a bounded audit snapshot and AI handoff prompt for an epic without embedding source contents.
-depends_on: []
----
-
-# T003: snapshot-and-prompt
-
-## Implementation Plan
-
-- [x] Add `src/audit/snapshot.ts` to generate `.savepoint/audit/{epic}/snapshot.md` from router state, epic/task metadata, gitignore-respecting file listings, and changed-file paths.
-- [x] Ensure changed-file output records path and status only, never source or test file contents.
-- [x] Create `.savepoint/audit/{epic}/proposals/` alongside the snapshot so later proposal review has a stable artifact location.
-- [x] Add `src/audit/prompts.ts` to render the bounded handoff prompt that points an AI agent at the snapshot and proposal directory.
-- [x] Add tests for gitignore exclusions, snapshot bounds, changed-file metadata, proposal directory creation, and prompt content.
-- [x] Run the focused audit snapshot and prompt tests before handing off the task.
-
-## Context Log
-
-- Files read: `AGENTS.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `T003-snapshot-and-prompt.md`; `src/audit/quality-gates.ts`; `src/audit/log.ts`; `src/fs/project.ts`; `src/fs/markdown.ts`; `src/readers/router.ts`; `src/readers/epic.ts`; `src/readers/tasks.ts`; `src/domain/router.ts`; `src/domain/task.ts`; `src/domain/ids.ts`; `src/domain/status.ts`; `src/domain/config.ts`; `templates/prompts/audit-reconciliation.prompt.md`; `test/audit/quality-gates.test.ts`; `test/init/write-scaffold.test.ts`; `package.json`
-- Estimated input tokens: ~12,500
-- Notes: Implemented `buildSnapshotMarkdown` (pure), `generateSnapshot` (filesystem + injected GitReader), `defaultGitReader` (spawn-based), and `buildAuditPrompt` (pure). 31 tests, 555 total passing. Typecheck and lint clean.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T004-audit-orchestration-router.md

@@ -1,27 +0,0 @@
----
-id: E07-audit-pipeline/T004-audit-orchestration-router
-status: done
-objective: Wire `savepoint audit` to run gates, write audit artifacts, and move the router into audit-pending only after blocking gates pass.
-depends_on:
-  - E07-audit-pipeline/T001-audit-cli-contract
-  - E07-audit-pipeline/T002-quality-gate-runner
-  - E07-audit-pipeline/T003-snapshot-and-prompt
----
-
-# T004: audit-orchestration-router
-
-## Implementation Plan
-
-- [x] Replace the non-skip audit placeholder with orchestration that resolves the target epic, reads config, runs quality gates, and reports gate results.
-- [x] Stop before snapshot generation when any blocking quality gate fails, preserving clear stdout/stderr and exit-code behavior.
-- [x] Generate the snapshot, proposal directory, and handoff prompt after gates pass.
-- [x] Add `src/audit/router-state.ts` to transition `.savepoint/router.md` into `audit-pending` for the audited epic without disturbing unrelated router content.
-- [x] Write audit log entries for started, failed-gate, and snapshot-created outcomes.
-- [x] Add integration tests for happy path, failed gates stopping snapshots, explicit `--epic`, active-router epic fallback, and router transition.
-- [x] Run the focused audit command integration tests before handing off the task.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `E07/Design.md`; `T004`; `T001`; `T002`; `T003`; `src/commands/audit.ts`; `src/audit/log.ts`; `src/audit/quality-gates.ts`; `src/audit/snapshot.ts`; `src/audit/prompts.ts`; `src/domain/config.ts`; `src/readers/config.ts`; `src/readers/tasks.ts`; `src/domain/router.ts`; `src/readers/router.ts`; `src/fs/project.ts`; `src/cli/exit-codes.ts`; `test/audit/quality-gates.test.ts`; `test/audit/snapshot.test.ts` (partial); `test/commands/audit.test.ts`; `.savepoint/metrics/context-bench.md`
-- Estimated input tokens: ~15,300
-- Notes: Created `src/audit/router-state.ts` with `transitionToAuditPending`. Added `logAuditEntry` to `src/audit/log.ts`. Replaced placeholder in `src/commands/audit.ts` with full orchestration (gates → snapshot → router transition → prompt). Added injectable `commandRunner` and `gitReader` to `AuditContext` for testing. 20 audit command tests, 564 total passing. Typecheck and lint clean.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T005-proposal-validation-apply.md

@@ -1,25 +0,0 @@
----
-id: E07-audit-pipeline/T005-proposal-validation-apply
-status: done
-objective: Validate audit proposal files and apply approved patch-shaped documentation updates with explicit divergence failures.
-depends_on:
-  - E07-audit-pipeline/T003-snapshot-and-prompt
----
-
-# T005: proposal-validation-apply
-
-## Implementation Plan
-
-- [x] Add `src/audit/proposals.ts` to discover proposal files in `.savepoint/audit/{epic}/proposals/` and parse patch-shaped operations for documentation targets.
-- [x] Validate proposal target paths, required sections, duplicate operations, empty replacements, and malformed proposal documents with path-aware errors.
-- [x] Add `src/audit/apply-proposals.ts` to apply approved replace, insert, and delete operations only when anchors still match the live file.
-- [x] Fail with explicit divergence errors instead of overwriting user edits when a proposal no longer matches the target document.
-- [x] Preserve compatibility with any existing board handoff signal until the review UI moves fully to the proposal directory.
-- [x] Add tests for discovery, validation failures, successful apply, partial approval, divergence, and scoped path protection.
-- [x] Run the focused proposal validation and apply tests before handing off the task.
-
-## Context Log
-
-- Files read: `AGENTS.md`; `.savepoint/router.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/tasks/T005-proposal-validation-apply.md`; `src/audit/snapshot.ts`; `src/audit/prompts.ts`; `src/audit/router-state.ts`; `src/audit/log.ts`; `src/fs/project.ts`; `test/audit/snapshot.test.ts`; `test/audit/quality-gates.test.ts`; `templates/prompts/audit-reconciliation.prompt.md`; `.savepoint/audit/E06-tui-board/proposals.md`; `.savepoint/audit/E05-init-command/proposals.md`
-- Estimated input tokens: ~18,500
-- Notes: Implemented `proposals.ts` (discovery, parse, validate) and `apply-proposals.ts` (applyOperation, applyApprovedOperations). All 46 focused tests pass. Proposal format supports Replace/Insert After/Delete with fenced or plain-text anchors; scoped path protection rejects non-.md/.yml/.yaml and path traversal targets; divergence detection skips writing any operation to a file if any op on it diverges.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T006-audit-review-state.md

@@ -1,24 +0,0 @@
----
-id: E07-audit-pipeline/T006-audit-review-state
-status: done
-objective: Model audit proposal review decisions so approve, reject, edit, and apply flows are testable before the Ink UI.
-depends_on:
-  - E07-audit-pipeline/T005-proposal-validation-apply
----
-
-# T006: audit-review-state
-
-## Implementation Plan
-
-- [x] Add non-rendering audit review state under `src/tui/audit-review/` for loaded proposals, selected operation, review decision, edited replacement text, warnings, and apply readiness.
-- [x] Implement reducer actions for navigation, approve, reject, edit, reset edit, show divergence warning, and mark apply result.
-- [x] Derive concise review summaries that the UI can render without reparsing proposal documents.
-- [x] Keep all filesystem writes out of the state layer; call proposal/apply services through injected callbacks only in later integration.
-- [x] Add deterministic reducer tests for navigation bounds, decision changes, edit preservation, ready-to-apply calculation, and warning state.
-- [x] Run the focused audit review state tests before handing off the task.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/tasks/T006-audit-review-state.md`; `src/tui/state/reducer.ts`; `src/tui/state/app-reducer.ts`; `src/tui/state/view-state.ts`; `test/tui/state/reducer.test.ts`; `test/tui/state/app-reducer.test.ts`; `src/audit/proposals.ts`; `src/audit/apply-proposals.ts`; `.savepoint/metrics/context-bench.md`
-- Estimated input tokens: ~11,975
-- Notes: E06 state/test conventions for reducer shape and deterministic testing; E07 audit proposal/apply types for state model alignment.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T007-audit-review-ui.md

@@ -1,26 +0,0 @@
----
-id: E07-audit-pipeline/T007-audit-review-ui
-status: done
-objective: "Add the Ink audit review mode that lets users inspect proposals, approve or reject them, edit replacements, and apply approved changes."
-depends_on:
-  - E07-audit-pipeline/T004-audit-orchestration-router
-  - E07-audit-pipeline/T006-audit-review-state
----
-
-# T007: audit-review-ui
-
-## Implementation Plan
-
-- [x] Create `src/tui/audit-review/*.tsx` components that follow the existing terminal palette and the Atari-Noir visual identity within terminal constraints.
-- [x] Update the board audit entry point so proposal directories produced by E07 open the review mode for the active epic.
-- [x] Render proposal targets, operation summaries, selected diffs, approval state, edit mode, and divergence warnings without dumping full unrelated file contents.
-- [x] Wire apply actions through `src/audit/apply-proposals.ts`, require confirmation for high-divergence cases, and surface apply errors without losing review decisions.
-- [x] Write audit log entries for applied, rejected-only, and user-aborted review outcomes.
-- [x] Add TUI tests with mocked Ink rendering and service callbacks for navigation, approve/reject/edit, apply success, and apply failure.
-- [x] Run the focused audit review UI and board integration tests before handing off the task.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `.savepoint/visual-identity.md`; `.savepoint/metrics/context-bench.md`; `src/tui/App.tsx`; `src/tui/Board.tsx`; `src/commands/board.ts`; `src/tui/theme/palette.ts`; `src/tui/DetailPane.tsx`; `src/audit/apply-proposals.ts`; `src/audit/proposals.ts`; `src/audit/log.ts`; `src/domain/config.ts`; `src/tui/state/app-reducer.ts`; `src/tui/board-data.ts`; `test/commands/board.test.ts`; `test/commands/board-tty.test.ts`; `test/tui/components/App.test.tsx`; `src/tui/state/reducer.ts`; `src/tui/audit-review/state.ts`; `src/tui/audit-review/summary.ts`; `test/tui/audit-review/state.test.ts`; `vitest.config.ts`; `vitest.config.js`
-- Estimated input tokens: ~16,000
-- Notes: Implementation required understanding E06 TUI patterns for reducer shape, keyboard input, Ink testing, and board integration; extended T006 state model with confirm-divergence and edit helpers; wired apply through existing E07 audit services.

package/.savepoint/releases/v1/epics/_archived/E07-audit-pipeline/tasks/T008-audit-pipeline-integration.md

@@ -1,24 +0,0 @@
----
-id: E07-audit-pipeline/T008-audit-pipeline-integration
-status: done
-objective: Verify the complete audit lifecycle from command execution through review application with end-to-end coverage and full quality gates.
-depends_on:
-  - E07-audit-pipeline/T007-audit-review-ui
----
-
-# T008: audit-pipeline-integration
-
-## Implementation Plan
-
-- [x] Add end-to-end tests that cover audit skip logging, gate failure short-circuiting, successful snapshot/prompt generation, router `audit-pending` transition, proposal review, and approved proposal application.
-- [x] Verify audit artifacts remain bounded by asserting snapshots contain metadata and paths but not source/test code bodies.
-- [x] Confirm explicit `--epic` and active-router epic selection work consistently across command, snapshot, proposal, and review paths.
-- [x] Tighten command help, error messages, and fixture cleanup discovered by the integration tests.
-- [x] Run focused audit integration tests first, then run `npm run typecheck`, `npm run lint`, `npm run format:check`, `npm run build`, and `npm test`.
-- [x] Update this task's context log with implementation files read before moving it to review.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/tasks/T008-audit-pipeline-integration.md`; `src/commands/audit.ts`; `src/audit/quality-gates.ts`; `src/audit/snapshot.ts`; `src/audit/router-state.ts`; `src/audit/prompts.ts`; `src/audit/proposals.ts`; `src/audit/apply-proposals.ts`; `src/audit/log.ts`; `test/commands/audit.test.ts`; `test/cli/run.test.ts`; `test/audit/quality-gates.test.ts`; `test/audit/snapshot.test.ts`; `test/audit/proposals.test.ts`; `test/audit/apply-proposals.test.ts`; `test/audit/prompts.test.ts`; `src/tui/audit-review/state.ts`; `src/tui/audit-review/AuditReviewApp.tsx`; `src/tui/audit-review/summary.ts`; `test/tui/audit-review/state.test.ts`; `test/tui/audit-review/AuditReviewApp.test.tsx`; `test/commands/board.test.ts`; `src/cli/args.ts`; `src/cli/run.ts`; `src/cli/help.ts`; `src/readers/router.ts`; `.savepoint/metrics/context-bench.md`
-- Estimated input tokens: ~45,844
-- Notes: Full integration context: all E07 audit source and test files, CLI dispatch layer, TUI audit-review state/components, board test patterns for fixture setup, and context bench. Prettier formatting applied to all E07-scoped files with existing warnings.