savepoint 1.0.3 → 1.0.6

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.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/Design.md

@@ -1,103 +0,0 @@
----
-type: epic-design
-status: active
----
-
-# Epic E08: board-workflow-cleanup
-
-## Purpose
-
-Make the board usable as the primary release workflow surface before `0.1.0` ships by adding epic navigation, readable task presentation, acceptance criteria, and a focused task detail view.
-
-## What this epic adds
-
-- Immersive full-screen TUI that utilizes the terminal's alternate screen buffer, hiding shell history while active.
-- Epic selection in a fixed left rail (minimum 25 columns wide) so users can browse and work across release epics without manually editing router state.
-- A clear separation between selectable epic items and task cards, with `Tab` to switch focus between the two panes.
-- Readable task card labels that prioritize task title/slug/objective over full `epic/task` IDs.
-- Required task-level acceptance criteria that define what "done" means.
-- A workflow rule that the implementation plan is the build checklist for satisfying acceptance criteria.
-- A full-screen task detail modal that shows objective, acceptance criteria, implementation checklist, dependencies, status, and transition affordances.
-- Updated templates and planning prompts so new task files include acceptance criteria by default.
-- Migration/compatibility behavior for existing task files that do not yet include acceptance criteria.
-
-## Backlog.md & OpenCode inspiration
-
-Backlog.md and OpenCode are useful inspiration for release-blocking product behaviors: task files are human-readable Markdown, tasks carry clear acceptance criteria, and the visual board/detail views make task status and task content inspectable without opening files directly. The TUI acts as a standalone, immersive application. Savepoint should borrow those product lessons while preserving Savepoint's epic-first router and audit workflow.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                                 | Purpose                                                               |
-| ------------------------------------ | --------------------------------------------------------------------- |
-| `src/domain/task.ts`                 | Task document model with acceptance criteria parsing and validation.  |
-| `src/readers/tasks.ts`               | Epic task-set reader updated for acceptance criteria compatibility.   |
-| `src/tui/board-data.ts`              | Cross-epic board data and readable task/epic display metadata.        |
-| `src/tui/state/*.ts`                 | Board navigation state for epic selection, task selection, and popup. |
-| `src/tui/{App,Board,DetailPane}.tsx` | Board keyboard flow, readable cards, layout, and task detail modal.   |
-| `src/tui/render/plain-table.ts`      | Non-TTY rendering for epic/task separation and acceptance criteria.   |
-| `src/commands/board.ts`              | Alternate screen buffer management and immersive launch.              |
-| `templates/project/**`               | Default workflow docs and task templates with acceptance criteria.    |
-| `templates/prompts/*.prompt.md`      | Agent prompts updated to require acceptance criteria before planning. |
-| `.savepoint/router.md`               | Workflow instructions for acceptance criteria and detail navigation.  |
-| `test/domain/*.test.ts`              | Task schema and compatibility tests.                                  |
-| `test/readers/*.test.ts`             | Cross-epic task reading tests.                                        |
-| `test/tui/**/*.test.ts(x)`           | Board navigation, card labels, popup detail, and render tests.        |
-| `test/templates/*.test.ts`           | Template and prompt integrity tests.                                  |
-
-## Architectural delta
-
-Before this epic, the board is scoped to the active epic and shows task IDs as the primary task label. The board prints inline to standard output. Task files have an objective and implementation plan, but no explicit acceptance criteria contract.
-
-After this epic, the board becomes a release-level immersive navigation surface using the alternate screen buffer. Epics are selectable in a left rail, tasks are readable at a glance, and a full-screen task detail modal is available. Task documents gain acceptance criteria as a first-class section, with the implementation plan explicitly subordinate to those criteria.
-
-The router remains the source of truth for the active build task. Browsing another epic in the board must not silently change the active build task unless the user performs an explicit workflow action (`Enter` on the left rail).
-
-## Resolved design decisions
-
-1. **Immersive TUI & Layout:** The board will enter the terminal's alternate screen buffer (`\x1b[?1049h`), restoring shell history cleanly on exit. Layout consists of a fixed Left Rail (min 25 columns width) for Epics, and a Main Board for tasks. Focus is toggled via `Tab` / `Shift+Tab`.
-2. **Epic Interaction:** Epics display status via glyphs and colors: `✓` (Completed/Green), `▶` (Active/Yellow), `○` (Planned/Dim). Browsing previews tasks (read-only). Pressing `Enter` on an Epic activates it in `router.md`.
-3. **Task Mutation Constraints:** Tasks can only be advanced (`Space`) or retreated (`Backspace`) if the currently browsed epic matches the Active Router Epic. Otherwise, the action is blocked with a warning.
-4. **Task Detail Modal:** A full-screen overlay triggered by `Enter` from the board. It displays task details, and the implementation checklist is strictly read-only for `v0.1.0`. Closed via `Escape`.
-5. **Acceptance Criteria Parsing:** The `task.ts` parser will extract the `## Acceptance Criteria` markdown section. If missing, it safely returns an empty array for backward compatibility.
-
-## Boundaries
-
-In scope:
-
-- Release-level epic browsing in an immersive full-screen board.
-- Readable task labels and full ID demotion into detail/metadata.
-- Required acceptance criteria for newly planned tasks.
-- Compatibility for existing tasks missing acceptance criteria.
-- Full-screen task detail modal in the TUI and plain fallback output.
-- Prompt/template updates that make acceptance criteria part of normal workflow.
-- Visual bugs to be fixed - scrolling up and down fragments the board, the task surface is too busy for a four-pane workflow, and the TUI should feel like a standalone application.
-
-Out of scope:
-
-- Web UI.
-- Search.
-- File watching.
-- Drag-and-drop or mouse interactions.
-- Editing every historical task file by hand unless tests/templates require fixture updates.
-- AI semantic review or audit pipeline behavior beyond prompt/template wording.
-- Interactive toggling of markdown implementation checklists within the TUI (deferred to future release).
-
-## Quality gates
-
-- Tests cover task documents with and without acceptance criteria.
-- Tests cover cross-epic board data loading and epic switching.
-- Tests prove readable labels are shown on task cards while full IDs remain visible in detail.
-- Tests cover the task detail modal content, full-screen takeover, and keyboard flow.
-- Template tests prove new task scaffolds include acceptance criteria before implementation plans.
-- Existing board transition behavior remains covered after keybinding changes.
-
-## Design constraints
-
-- Keep the board fast and bounded; release-level browsing must not load unrelated source code.
-- Preserve the file-first workflow. The board reads and writes Markdown-backed state; it does not create a hidden database.
-- Make navigation explicit. Browsing an epic and changing the router's active task are different actions.
-- Keep task files independently buildable and objective-led.
-- Acceptance criteria describe observable outcomes; implementation plans describe the build steps to satisfy them.
-- Design the layout for terminal constraints: safe truncation, fixed regions, and consistent with Atari-Noir terminal palette rules.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T001-acceptance-criteria-model.md

@@ -1,30 +0,0 @@
----
-id: E08-board-workflow-cleanup/T001-acceptance-criteria-model
-status: done
-objective: Add task-document acceptance criteria parsing with compatibility for existing tasks that do not declare criteria.
-depends_on: []
----
-
-# T001: acceptance-criteria-model
-
-## Acceptance Criteria
-
-- Task documents with a `## Acceptance Criteria` section expose normalized criteria to callers.
-- Task documents without acceptance criteria remain readable and carry an explicit compatibility signal instead of failing schema validation.
-- Existing frontmatter validation remains unchanged, so status writes still preserve unknown frontmatter and task bodies.
-- Tests cover present, missing, empty, and checkbox/bullet acceptance criteria formats.
-
-## Implementation Plan
-
-- [x] Add a focused Markdown section parser for task body sections, keeping frontmatter validation in `src/domain/task.ts` strict and unchanged.
-- [x] Extend the task document model returned to callers with acceptance criteria data and a missing-criteria compatibility marker.
-- [x] Update `test/domain/task.test.ts` to cover acceptance criteria extraction, missing-section compatibility, empty-section compatibility, and mixed bullet/checkbox criteria.
-- [x] Update the relevant status-write tests to prove task body and criteria text survive status changes unchanged.
-- [x] Run focused task-domain and status-write tests before handing off.
-- [x] Update this task's context log with implementation files read before moving it to review.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `AGENTS.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; `src/domain/task.ts`; `test/domain/task.test.ts`; `test/tui/io/write-status.test.ts`.
-- Estimated input tokens: ~7,500
-- Notes: Implementation pass. Added `AcceptanceCriteria` interface, `parseAcceptanceCriteria`, and `parseTaskDocument` to `src/domain/task.ts`. Tests: 9 new in task.test.ts, 1 new in write-status.test.ts. 35/35 pass.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T002-release-task-set-reader.md

@@ -1,33 +0,0 @@
----
-id: E08-board-workflow-cleanup/T002-release-task-set-reader
-status: done
-objective: Read release epics into a release-level task collection that preserves per-epic errors and resolves cross-epic task dependencies.
-depends_on:
-  - E08-board-workflow-cleanup/T001-acceptance-criteria-model
----
-
-# T002: release-task-set-reader
-
-## Acceptance Criteria
-
-- A release-level reader lists epic directories under `.savepoint/releases/{release}/epics` in deterministic order.
-- The reader returns task documents grouped by epic while preserving filesystem/schema errors for each epic.
-- Cross-epic dependencies are validated at release scope so valid cross-epic links do not appear as missing dependencies.
-- Existing `readEpicTaskSet` behavior remains available for callers that only need one epic.
-- Tests cover multiple epics, empty task directories, missing task directories, cross-epic dependencies, duplicate IDs, and true missing dependencies.
-
-## Implementation Plan
-
-- [x] Add a release-level task-set result type in `src/readers/tasks.ts` or a new focused reader module if that keeps the file to one job.
-- [x] Implement deterministic epic directory discovery from the release `epics/` directory, ignoring non-directories.
-- [x] Reuse existing markdown/frontmatter parsing and acceptance-criteria extraction from T001 for every task file.
-- [x] Add release-scope graph validation that treats cross-epic dependencies as valid when the target task exists anywhere in the release.
-- [x] Add reader tests in `test/readers/tasks.test.ts` for multi-epic success, partial epic errors, cross-epic dependency success, and release-level graph failures.
-- [x] Run focused reader tests before handing off.
-- [x] Update this task's context log with implementation files read before moving it to review.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/Design.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; `.savepoint/releases/v1/epics/E06-tui-board/Design.md`; `.savepoint/releases/v1/epics/E07-audit-pipeline/Design.md`; `.savepoint/visual-identity.md`; `agent-skills/ink-tui-design/SKILL.md` and focused references; current task/domain/reader/board/template/test files for E08 planning.
-- Estimated input tokens: ~58,547
-- Notes: Task-breakdown planning context only. Implementation should re-read this task plus directly touched source/test files.