savepoint 1.0.3 → 1.0.6

package/.savepoint/releases/v1/epics/_archived/E05-init-command/Design.md

@@ -1,88 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# Epic E05: init-command
-
-## Purpose
-
-Implement `savepoint init`, the first-run command that creates a Savepoint workflow in an empty or compatible project directory and prints the magic prompt the user gives to an AI agent.
-
-## What this epic adds
-
-- Target directory validation.
-- Scaffold writing from template assets.
-- Project name and release metadata interpolation.
-- Safe handling for existing files.
-- Magic prompt output to stdout.
-- Best-effort clipboard copy.
-- Optional one-shot dev-dependency installation prompt/flag support as defined by the CLI contract.
-- Integration tests using temporary directories.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                          | Purpose                                           |
-| ----------------------------- | ------------------------------------------------- |
-| `src/commands/init.ts`        | `savepoint init` command implementation.          |
-| `src/init/validate-target.ts` | Target directory checks.                          |
-| `src/init/write-scaffold.ts`  | Template copy/write orchestration.                |
-| `src/init/magic-prompt.ts`    | Prompt text generation.                           |
-| `src/init/clipboard.ts`       | Best-effort clipboard integration.                |
-| `src/init/dev-deps.ts`        | Optional dependency-install command construction. |
-| `test/init/**/*.test.ts`      | Unit and integration tests for init behavior.     |
-
-## Architectural delta
-
-Before this epic, Savepoint has assets and a command shell but cannot create a project. After this epic, `npx savepoint init` can produce the file-only workflow scaffold consumed by agents.
-
-This epic is the first user-visible workflow command, but it should still rely on the existing CLI and template layers rather than embedding content or parsing rules locally.
-
-## Implemented As
-
-- `src/cli/args.ts`, `src/cli/help.ts`, and `src/cli/run.ts` now recognize `savepoint init [dir]`, `--force`/`-f`, `--install`/`-y`, and init command help.
-- `src/commands/init.ts` orchestrates target validation, scaffold writing, magic prompt generation, best-effort clipboard copy, and optional install execution.
-- `src/init/validate-target.ts` checks missing, empty, compatible, already-initialized, conflicting, and boundary-error target states.
-- `src/init/write-scaffold.ts` loads project templates through the template layer, renders project metadata, creates parent directories, refuses conflicts by default, and writes via temp-file-plus-rename.
-- `src/init/magic-prompt.ts` renders `templates/prompts/magic-prompt.prompt.md` rather than embedding prompt copy in code.
-- `src/init/clipboard.ts` selects platform clipboard commands and returns success, skipped, or failed results without throwing through the init success path.
-- `src/init/dev-deps.ts` detects package managers from lockfiles and builds or runs the matching dev-dependency install command.
-- Project scaffold templates now include `.savepoint/metrics/context-bench.md` so generated projects can track context load from the start.
-- Init tests cover parser behavior, validation, scaffold writes, prompt generation, clipboard behavior, optional install handling, and end-to-end temporary-directory init flows.
-- The audit snapshot was generated manually because `savepoint audit` is still a stub.
-
-Design delta notes:
-
-- `runCli()` and `src/cli.ts` became async so the init command can perform filesystem, clipboard, and subprocess work.
-- The optional install path is explicit flag-driven behavior in this implementation; interactive prompting is not implemented.
-- Clipboard failures and install failures do not fail the scaffold path; install failures are reported on stderr after successful scaffold and prompt output.
-
-## Boundaries
-
-In scope:
-
-- Create `.savepoint/` and root `AGENTS.md`.
-- Print the initial agent prompt.
-- Avoid overwriting user files unless explicitly allowed by flags.
-- Support Windows, macOS, and Linux filesystem behavior.
-
-Out of scope:
-
-- Creating epics/tasks interactively.
-- Running the board after init.
-- Implementing audit or doctor.
-- Managing package installation beyond the optional one-shot path.
-
-## Quality gates
-
-- Integration tests should cover empty directories, existing incompatible files, and successful scaffold creation.
-- Clipboard failures should not fail init if the scaffold was written successfully.
-- File writes should be atomic enough to avoid partially corrupting existing files.
-
-## Design constraints
-
-- Use the template layer as the only source for generated file content.
-- Keep user-facing output short and copyable.
-- Treat filesystem writes as a boundary with clear errors.

package/.savepoint/releases/v1/epics/_archived/E05-init-command/tasks/T001-init-cli-contract.md

@@ -1,22 +0,0 @@
----
-id: E05-init-command/T001-init-cli-contract
-status: done
-objective: "Define and test the `savepoint init` CLI option contract without changing scaffold behavior yet."
-depends_on: []
----
-
-# T001: init-cli-contract
-
-## Implementation Plan
-
-- [x] Extend CLI argument parsing so `savepoint init` can accept only the init-specific flags required by this epic.
-- [x] Update command help for `savepoint init` to document the supported init usage and flags.
-- [x] Pass parsed init options and command execution context into `runInit()` without breaking other command handlers.
-- [x] Keep the init command returning the current not-implemented result until later tasks wire behavior.
-- [x] Add focused CLI parser and runner tests for valid init flags, invalid init flags, help output, and unchanged non-init command behavior.
-
-## Context Log
-
-- Files read: not captured before context tracking was added to task files.
-- Estimated input tokens: n/a
-- Notes: Use `.savepoint/metrics/context-bench.md` for measured rows going forward.

package/.savepoint/releases/v1/epics/_archived/E05-init-command/tasks/T002-target-validation.md

@@ -1,23 +0,0 @@
----
-id: E05-init-command/T002-target-validation
-status: done
-objective: "Validate whether a target directory can safely receive a Savepoint scaffold."
-depends_on: []
----
-
-# T002: target-validation
-
-## Implementation Plan
-
-- [x] Create `src/init/validate-target.ts` with typed validation results for empty, compatible, already-initialized, and conflicting target directories.
-- [x] Treat existing `.savepoint/` and root `AGENTS.md` paths as protected unless an explicit overwrite mode allows compatible replacement.
-- [x] Normalize filesystem boundary errors into clear validation failures that include the affected path.
-- [x] Add unit tests with temporary directories for empty targets, compatible existing files, incompatible files, missing directories, and inaccessible filesystem errors where practical.
-- [x] Export only the validation types and function needed by later init orchestration.
-- [x] Update `.savepoint/metrics/context-bench.md` with this task's measured context before setting status to review.
-
-## Context Log
-
-- Files read: not captured before context tracking was added to task files.
-- Estimated input tokens: n/a
-- Notes: Use `.savepoint/metrics/context-bench.md` for measured rows going forward.

package/.savepoint/releases/v1/epics/_archived/E05-init-command/tasks/T003-scaffold-writer.md

@@ -1,24 +0,0 @@
----
-id: E05-init-command/T003-scaffold-writer
-status: done
-objective: "Write the project scaffold from template assets while preserving existing user files."
-depends_on:
-  - E05-init-command/T002-target-validation
----
-
-# T003: scaffold-writer
-
-## Implementation Plan
-
-- [x] Create `src/init/write-scaffold.ts` to load project templates through `src/templates` APIs and render project metadata variables.
-- [x] Write `AGENTS.md` and `.savepoint/` files to the target directory with parent directory creation handled in one place.
-- [x] Refuse to overwrite conflicting existing files unless the caller has already selected the explicit overwrite mode.
-- [x] Use temporary-file-plus-rename writes for file content so existing files are not partially corrupted.
-- [x] Add integration tests covering successful scaffold creation, rendered project metadata, conflict refusal, and explicit overwrite behavior.
-- [x] Update `.savepoint/metrics/context-bench.md` with this task's measured context before setting status to review.
-
-## Context Log
-
-- Files read: 17 (router.md, E05 Design.md, T003 task, AGENTS.md, T001, T002, validate-target.ts, manifest.ts, render.ts, load.ts, paths.ts, index.ts, validate-target.test.ts, context-bench.md, init.ts, config.yml, AGENTS.md template)
-- Estimated input tokens: ~7,225
-- Notes: All 9 new tests pass; 338 total suite green.

package/.savepoint/releases/v1/epics/_archived/E05-init-command/tasks/T004-magic-prompt-and-clipboard.md

@@ -1,23 +0,0 @@
----
-id: E05-init-command/T004-magic-prompt-and-clipboard
-status: done
-objective: "Generate the post-init agent prompt and copy it to the clipboard on a best-effort basis."
-depends_on: []
----
-
-# T004: magic-prompt-and-clipboard
-
-## Implementation Plan
-
-- [x] Create `src/init/magic-prompt.ts` with a deterministic prompt generator that uses template-backed content rather than embedded long strings.
-- [x] Keep the generated prompt short enough for terminal output and explicit enough to route an agent into the new project workflow.
-- [x] Create `src/init/clipboard.ts` with platform-aware best-effort copy behavior and typed success, skipped, and failed outcomes.
-- [x] Ensure clipboard failures never throw through the init success path.
-- [x] Add focused tests for prompt generation, platform command selection or skip behavior, and non-fatal clipboard failure handling.
-- [x] Update `.savepoint/metrics/context-bench.md` with this task's measured context before setting status to review.
-
-## Context Log
-
-- Files read: 15
-- Estimated input tokens: ~7,625
-- Notes: Read T004, AGENTS.md, E05 Design, validate-target, write-scaffold, task-building prompt, templates layer (manifest, load, render, paths), project template files (AGENTS.md, router.md), environment.ts, and both existing init test files for patterns.

package/.savepoint/releases/v1/epics/_archived/E05-init-command/tasks/T005-dev-deps-install-option.md

@@ -1,24 +0,0 @@
----
-id: E05-init-command/T005-dev-deps-install-option
-status: done
-objective: "Support the optional one-shot dev-dependency installation path promised by the init command contract."
-depends_on:
-  - E05-init-command/T001-init-cli-contract
----
-
-# T005: dev-deps-install-option
-
-## Implementation Plan
-
-- [x] Create `src/init/dev-deps.ts` to build the package-manager-specific command needed for the optional Savepoint dev-dependency install.
-- [x] Detect the package manager from lockfiles or package metadata without modifying unrelated project files.
-- [x] Respect init flags that force install, skip install, or leave install as an interactive prompt decision.
-- [x] Run the install command only after scaffold writing succeeds and surface install failures separately from scaffold failures.
-- [x] Add tests for command construction, package manager detection, flag precedence, skipped install, and failed install reporting.
-- [x] Update `.savepoint/metrics/context-bench.md` with this task's measured context before setting status to review.
-
-## Context Log
-
-- Files read: 12
-- Estimated input tokens: ~6,269
-- Notes: Read T001 and two existing init modules + tests to align with codebase patterns. runInstallCommand is exported separately so tests can drive it with node without a real package manager.

package/.savepoint/releases/v1/epics/_archived/E05-init-command/tasks/T006-init-command-integration.md

@@ -1,28 +0,0 @@
----
-id: E05-init-command/T006-init-command-integration
-status: done
-objective: "Wire `savepoint init` end to end from CLI entrypoint to scaffold, prompt output, clipboard, and optional install behavior."
-depends_on:
-  - E05-init-command/T001-init-cli-contract
-  - E05-init-command/T002-target-validation
-  - E05-init-command/T003-scaffold-writer
-  - E05-init-command/T004-magic-prompt-and-clipboard
-  - E05-init-command/T005-dev-deps-install-option
----
-
-# T006: init-command-integration
-
-## Implementation Plan
-
-- [x] Replace the init stub with orchestration that validates the target, writes the scaffold, prints the magic prompt, attempts clipboard copy, and handles optional install.
-- [x] Return success, usage, and boundary-error exit codes consistently with the existing CLI runner.
-- [x] Keep stdout short and copyable while sending actionable failure details to stderr.
-- [x] Add end-to-end temporary-directory tests for empty directory success, incompatible existing files, already initialized project handling, clipboard failure success, and install failure reporting.
-- [x] Run focused init tests first, then the full quality gate suite for the epic closeout path.
-- [x] Update `.savepoint/metrics/context-bench.md` with this task's measured context before setting status to review.
-
-## Context Log
-
-- Files read: 21 (AGENTS.md, E05 Design, T006, T001, validate-target.ts, write-scaffold.ts, magic-prompt.ts, clipboard.ts, dev-deps.ts, args.ts, run.ts, cli.ts, exit-codes.ts, result.ts, run.test.ts, validate-target.test.ts, write-scaffold.test.ts, manifest.ts, render.ts, paths.ts, context-bench.md)
-- Estimated input tokens: ~10,925
-- Notes: runCli made async; InitResult replaces CommandResult for init; EXIT_BOUNDARY_ERROR added; InitDeps injection for clipboard/install test overrides; stale commands.test.ts runInit block removed.

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/Design.md

@@ -1,53 +0,0 @@
----
- type: epic-design
- status: planned
- ---
-
- # Epic E05: Project Cleanup
-
- ## Purpose
-
- Delete all dead files, tests, templates, and assets. Rewrite AGENTS.md as a lean agent guide. Clean package.json of unused dependencies. Verify everything builds, typechecks, lints, and tests.
-
- ## What this epic adds
-
- - Removal of dead source directories (`src/audit/`, `src/tui/audit-review/`).
- - Removal of dead test directories (`test/audit/`, `test/init/`, `test/templates/`).
- - Removal of dead assets (`templates/`, `agent-skills/`, stale markdown files).
- - Cleanup of `.savepoint/` data (delete audit/, metrics/, Design.md, PRD.md, visual-identity.md).
- - Lean AGENTS.md: router read order, phase workflow, build commands, code style.
- - Clean package.json with no unused devDependencies.
-
- ## Definition of Done
-
- - No dead files remain in `src/`, `test/`, `templates/`, `agent-skills/`.
- - `.savepoint/` contains only `router.md`, `config.yml`, and `releases/`.
- - AGENTS.md is under 100 lines, covers router, phases, build, and style.
- - `package.json` has no unused dependencies.
- - `npm run build && npm run typecheck && npm run lint && npm test` all pass.
- - No references to deleted commands, audit pipeline, or old state model remain anywhere.
-
- ## Components and files
-
- | Path | Purpose |
- |------|---------|
- | `AGENTS.md` | Rewritten lean agent guide |
- | `package.json` | Cleaned dependencies |
- | (deleted) `src/audit/` | Removed (7 files) |
- | (deleted) `src/tui/audit-review/` | Removed (5 files) |
- | (deleted) `test/audit/` | Removed (6 files) |
- | (deleted) `test/init/` | Removed |
- | (deleted) `test/templates/` | Removed |
- | (deleted) `test/commands/audit.test.ts` | Removed |
- | (deleted) `test/tui/audit-review/` | Removed |
- | (deleted) `templates/` | Removed |
- | (deleted) `agent-skills/` | Removed |
- | (deleted) `CLAUDE.md` | Removed |
- | (deleted) `GEMINI.md` | Removed |
- | (deleted) `ink-cli-ui-design.zip` | Removed |
- | (deleted) `vitest.config.ts` | Removed |
- | (deleted) `.savepoint/audit/` | Removed |
- | (deleted) `.savepoint/metrics/` | Removed |
- | (deleted) `.savepoint/Design.md` | Removed |
- | (deleted) `.savepoint/PRD.md` | Removed |
- | (deleted) `.savepoint/visual-identity.md` | Removed |

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T001-delete-dead-src.md

@@ -1,23 +0,0 @@
----
-id: E05-project-cleanup/T001-delete-dead-src
-status: planned
-objective: "Delete src/audit/ and src/tui/audit-review/ directories"
-depends_on: [E04-board-phase-integration/T008-board-tests]
----
-
-# T001: Delete Dead Source
-
-## Acceptance Criteria
-
-- `src/audit/` directory does not exist.
-- `src/tui/audit-review/` directory does not exist.
-- No remaining imports reference files in deleted directories.
-- Build compiles successfully.
-
-## Implementation Plan
-
-- [ ] Search codebase for imports from `src/audit/` and `src/tui/audit-review/`.
-- [ ] Confirm all references were removed in E04.
-- [ ] Delete `src/audit/` and all files within.
-- [ ] Delete `src/tui/audit-review/` and all files within.
-- [ ] Run `npm run build`.

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T002-delete-dead-tests.md

@@ -1,26 +0,0 @@
----
-id: E05-project-cleanup/T002-delete-dead-tests
-status: planned
-objective: "Delete test/audit/, test/init/, test/templates/, test/commands/audit.test.ts, test/tui/audit-review/"
-depends_on: [E04-board-phase-integration/T008-board-tests]
----
-
-# T002: Delete Dead Tests
-
-## Acceptance Criteria
-
-- `test/audit/` directory does not exist.
-- `test/init/` directory does not exist.
-- `test/templates/` directory does not exist.
-- `test/commands/audit.test.ts` does not exist.
-- `test/tui/audit-review/` directory does not exist.
-- `npm test` still passes.
-
-## Implementation Plan
-
-- [ ] Delete `test/audit/` and all files within.
-- [ ] Delete `test/init/` and all files within.
-- [ ] Delete `test/templates/` and all files within.
-- [ ] Delete `test/commands/audit.test.ts`.
-- [ ] Delete `test/tui/audit-review/` and all files within.
-- [ ] Run `npm test`.

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T003-delete-assets.md

@@ -1,25 +0,0 @@
----
-id: E05-project-cleanup/T003-delete-assets
-status: planned
-objective: "Delete templates/, agent-skills/, CLAUDE.md, GEMINI.md, ink-cli-ui-design.zip, vitest.config.ts"
-depends_on: []
----
-
-# T003: Delete Assets
-
-## Acceptance Criteria
-
-- `templates/` directory does not exist.
-- `agent-skills/` directory does not exist.
-- `CLAUDE.md`, `GEMINI.md`, `ink-cli-ui-design.zip` do not exist.
-- `vitest.config.ts` does not exist (keep `vitest.config.js`).
-- No references to deleted files remain.
-
-## Implementation Plan
-
-- [ ] Search codebase for references to templates/, agent-skills/, CLAUDE.md, GEMINI.md.
-- [ ] Delete `templates/` and all files within.
-- [ ] Delete `agent-skills/` and all files within.
-- [ ] Delete `CLAUDE.md`, `GEMINI.md`, `ink-cli-ui-design.zip`.
-- [ ] Delete `vitest.config.ts`.
-- [ ] Run `npm run build`.

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T004-clean-savepoint.md

@@ -1,28 +0,0 @@
----
-id: E05-project-cleanup/T004-clean-savepoint
-status: planned
-objective: "Delete .savepoint/audit/, .savepoint/metrics/, .savepoint/Design.md, .savepoint/PRD.md, .savepoint/visual-identity.md; trim config.yml"
-depends_on: [E05-project-cleanup/T002-delete-dead-tests]
----
-
-# T004: Clean Savepoint Data
-
-## Acceptance Criteria
-
-- `.savepoint/audit/` directory does not exist.
-- `.savepoint/metrics/` directory does not exist.
-- `.savepoint/Design.md` does not exist.
-- `.savepoint/PRD.md` does not exist.
-- `.savepoint/visual-identity.md` does not exist.
-- `config.yml` contains only theme configuration.
-- `router.md` still exists and is valid.
-
-## Implementation Plan
-
-- [ ] Delete `.savepoint/audit/` and all files within.
-- [ ] Delete `.savepoint/metrics/` and all files within.
-- [ ] Delete `.savepoint/Design.md`.
-- [ ] Delete `.savepoint/PRD.md`.
-- [ ] Delete `.savepoint/visual-identity.md`.
-- [ ] Read existing `config.yml`.
-- [ ] Rewrite `config.yml` with theme-only content.

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T005-rewrite-agents-md.md

@@ -1,28 +0,0 @@
----
-id: E05-project-cleanup/T005-rewrite-agents-md
-status: planned
-objective: "Rewrite AGENTS.md as a lean agent guide"
-depends_on: [E04-board-phase-integration/T008-board-tests]
----
-
-# T005: Rewrite AGENTS.md
-
-## Acceptance Criteria
-
-- `AGENTS.md` is under 100 lines.
-- Covers: router read order, phase workflow, build commands, code style.
-- No Codebase Map table.
-- No audit workflow description.
-- No 6-state planning machine.
-- No capability check warning.
-- Valid markdown, readable by any agent.
-
-## Implementation Plan
-
-- [ ] Read existing `AGENTS.md`.
-- [ ] Write new lean version: router -> epic -> task workflow.
-- [ ] Document phase model: build -> test -> audit -> done.
-- [ ] List build/test/lint commands.
-- [ ] Keep code style rules (the 10 rules).
-- [ ] Remove everything else.
-

package/.savepoint/releases/v1/epics/_archived/E05-project-cleanup/tasks/T006-clean-package-json.md

@@ -1,23 +0,0 @@
----
-id: E05-project-cleanup/T006-clean-package-json
-status: planned
-objective: "Remove ink-testing-library and verify no unused dependencies"
-depends_on: [E05-project-cleanup/T001-delete-dead-src]
----
-
-# T006: Clean Package JSON
-
-## Acceptance Criteria
-
-- `ink-testing-library` removed from devDependencies.
-- All remaining dependencies are used by the simplified codebase.
-- `npm install` succeeds.
-- Build still works.
-
-## Implementation Plan
-
-- [ ] Read `package.json`.
-- [ ] Remove `ink-testing-library` from devDependencies.
-- [ ] Verify `@types/react` is still needed (yes, Ink uses React).
-- [ ] Run `npm install`.
-- [ ] Run `npm run build`.

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.