savepoint 1.0.3 → 1.0.6

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T003-board-data-and-plain-output.md

@@ -1,34 +0,0 @@
----
-id: E08-board-workflow-cleanup/T003-board-data-and-plain-output
-status: done
-objective: Build release-level board data and update non-TTY board output so epics and readable task labels are visible without changing router state.
-depends_on:
-  - E08-board-workflow-cleanup/T002-release-task-set-reader
----
-
-# T003: board-data-and-plain-output
-
-## Acceptance Criteria
-
-- `BoardData` includes release epic metadata (including status mapped to `✓`, `▶`, `○` markers), active router epic/task, selected epic, selected epic columns, readable task labels, full task IDs, acceptance criteria summaries, and per-epic warnings.
-- `runBoard` loads release-level board data for refresh and non-TTY rendering while keeping router state read-only.
-- Status writes derive the target task path from the selected task ID's epic segment, not only from the router's active epic.
-- Non-TTY output separates epic navigation from task status output and uses readable task labels before full IDs.
-- Tests cover release-level board data, readable labels, acceptance criteria summaries, selected-vs-active epic metadata, and non-TTY output.
-
-## Implementation Plan
-
-- [x] Extend `src/tui/board-data.ts` types to represent release epics, selected epic metadata, readable task labels, full IDs, and acceptance criteria summaries.
-- [x] Update board-data construction to consume the release-level reader from T002 while preserving current single-epic behavior through compatible defaults.
-- [x] Update `src/commands/board.ts` loading and refresh callbacks to use release-level data without mutating `.savepoint/router.md`.
-- [x] Update status-write path resolution to derive `release`, `epic`, and task filename from the selected task ID and current release.
-- [x] Update `src/tui/render/plain-table.ts` so plain output shows an epic section, selected/active markers, readable task lines, and full IDs as metadata.
-- [x] Add or update focused tests in `test/commands/board.test.ts`, `test/tui/render/plain-table.test.ts`, and board-data tests for the new release-level contract.
-- [x] Run focused board-data, command, and plain-render tests before handing off.
-- [x] Update this task's context log with implementation files read before moving it to review.
-
-## Context Log
-
-- Files read: `src/tui/board-data.ts`; `src/commands/board.ts`; `src/tui/render/plain-table.ts`; `src/readers/tasks.ts`; `src/domain/task.ts`; `src/domain/ids.ts`; `src/fs/markdown.ts`; `src/domain/router.ts`; `src/tui/state/view-state.ts`; `test/tui/render/plain-table.test.ts`; `test/commands/board.test.ts`; `test/tui/state/reducer.test.ts`; `test/tui/state/app-reducer.test.ts`; `test/tui/components/Board.test.tsx`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; `tsconfig.json`.
-- Also fixed pre-existing bug: `src/readers/tasks.ts` was not calling `parseTaskDocument` after parsing markdown, so `acceptanceCriteria` was always undefined at runtime.
-- 727 tests pass (54 test files). New tests: `test/tui/board-data.test.ts` (14), `test/tui/render/plain-table.test.ts` +7 cases, `test/commands/board.test.ts` +4 cases.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T004-board-selection-state.md

@@ -1,33 +0,0 @@
----
-id: E08-board-workflow-cleanup/T004-board-selection-state
-status: done
-objective: Model board selection state for epic browsing, task focus, refresh preservation, and task detail popup visibility.
-depends_on:
-  - E08-board-workflow-cleanup/T003-board-data-and-plain-output
----
-
-# T004: board-selection-state
-
-## Acceptance Criteria
-
-- Board state distinguishes epic focus, task focus, selected epic, selected task, and detail-popup visibility.
-- Browsing another epic never changes the active router epic/task in state. Advancing (`Space`) or retreating (`Backspace`) task status is blocked unless the browsed epic matches the active router epic.
-- Refresh preserves the selected epic and task when they still exist, and falls back predictably when an epic or task disappears.
-- Navigation clamps at list boundaries where wrapping would make the screen feel unstable.
-- Reducer tests cover epic switching, task movement within an epic, detail open/close, refresh preservation, and fallback behavior.
-
-## Implementation Plan
-
-- [x] Extend `src/tui/state/view-state.ts` with selected-epic, selected-task, focus-area, and detail-popup state derived from the new `BoardData`.
-- [x] Update `src/tui/state/reducer.ts` actions for moving across epics, moving across tasks/status groups, switching focus, opening detail, closing detail, and refreshing release-level data.
-- [x] Update `src/tui/state/app-reducer.ts` to preserve warning/message/loading behavior while carrying the expanded view state.
-- [x] Replace wraparound movement with explicit clamp behavior where needed to avoid disorienting jumps and layout fragmentation.
-- [x] Update state tests for the new release-level board shape and add coverage for detail visibility and selected-vs-active router metadata.
-- [x] Run focused TUI state 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/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; this task file; `src/tui/state/view-state.ts`; `src/tui/state/reducer.ts`; `src/tui/state/app-reducer.ts`; `src/tui/board-data.ts`; `test/tui/state/reducer.test.ts`; `test/tui/state/app-reducer.test.ts`.
-- Estimated input tokens: ~14,000
-- Notes: Added `FocusArea`, `epicIndex`, `selectedEpicRaw`, `focusArea`, `detailVisible` to `BoardViewState`. New actions: `move-epic`, `switch-focus`, `open-detail`, `close-detail`. Vertical task nav changed from wrap to clamp. 174 TUI tests pass.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T005-ink-board-layout-cleanup.md

@@ -1,37 +0,0 @@
----
-id: E08-board-workflow-cleanup/T005-ink-board-layout-cleanup
-status: done
-objective: Rework the Ink board into a stable release-level screen with an epic selector, readable task cards, and bounded terminal layout.
-depends_on:
-  - E08-board-workflow-cleanup/T004-board-selection-state
----
-
-# T005: ink-board-layout-cleanup
-
-## Acceptance Criteria
-
-- The TTY board renders as an immersive full-screen application using the alternate screen buffer (`\x1b[?1049h`), with a header, epic selector (fixed left rail, min 25 columns), task surface, warning area, and footer.
-- Epic items are visually distinct from task cards and explicitly show status (`✓`, `▶`, `○`) and active-router state separately from selected/browsed state. Focus switches between panes via `Tab`/`Shift+Tab`.
-- Task cards prioritize readable labels from slug/objective/title-style text while keeping full IDs visible as dim metadata.
-- The backlog status remains represented but no longer consumes one fifth of the horizontal screen when that space is better used for epic selection.
-- Layout uses terminal-safe widths, truncation, and fixed regions so arrow-key navigation does not fragment or wrap the board.
-- Component tests cover epic selector rendering, readable labels, active-vs-selected markers, no-color output, and empty states.
-
-## Implementation Plan
-
-- [x] Refactor `src/tui/Board.tsx` into smaller render parts if needed so epic selection, task grouping, and task cards each have one job.
-- [x] Implement alternate screen buffer entry/exit in `src/commands/board.ts` for full-screen takeover.
-- [x] Add a release-level header and a fixed-width left rail epic selector that follow Atari-Noir terminal constraints and the Ink guide's screen/part split.
-- [x] Replace full-ID-first task rendering with readable card labels, status/count metadata, and full IDs as secondary detail.
-- [x] Rebalance the task surface so backlog is still visible but does not monopolize equal-width Kanban space when an epic rail is present.
-- [x] Add terminal-width truncation and safe margins for long task labels, objectives, criteria, and epic names.
-- [x] Update `src/tui/App.tsx` footer/help text for the new focus and navigation model without adding long in-app instructions.
-- [x] Read and adhere to `agent-skills/ink-tui-design/SKILL.md` for component structure and visual constraints.
-- [x] Update Ink component tests for the new layout and readable labels.
-- [x] Run focused board component tests before handing off.
-- [x] Update this task's context log with implementation files read before moving it to review.
-
-## Context Log
-
-- Files read: this task; E08 Design; T003/T004 context logs; `src/tui/Board.tsx`; `src/tui/App.tsx`; `src/tui/board-data.ts`; `src/tui/state/view-state.ts`; `src/tui/state/reducer.ts`; `src/tui/state/app-reducer.ts`; `src/commands/board.ts`; `src/tui/theme/palette.ts`; `agent-skills/ink-tui-design/SKILL.md`; `.savepoint/visual-identity.md`; `test/tui/components/Board.test.tsx`; `test/tui/components/App.test.tsx`.
-- Implementation: refactored `Board.tsx` into `EpicRail` (React.memo, fixed 25-col left rail, glyph status + browsed cursor `›`) + `TaskCard` (React.memo, label primary, dim full ID secondary) + flex task surface. `App.tsx` gains header, Tab→switch-focus, rail up/down→move-epic, board left/right guard, mutation guard when browsedEpic≠activeEpic. `board.ts` wraps render in `\x1b[?1049h`/`\x1b[?1049l` alt screen buffer with cleanup on process exit. 755 tests pass, typecheck clean.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T006-task-detail-popup.md

@@ -1,36 +0,0 @@
----
-id: E08-board-workflow-cleanup/T006-task-detail-popup
-status: done
-objective: Add a keyboard-driven task detail popup that shows acceptance criteria, implementation checklist state, dependencies, status, and transition affordances.
-depends_on:
-  - E08-board-workflow-cleanup/T005-ink-board-layout-cleanup
----
-
-# T006: task-detail-popup
-
-## Acceptance Criteria
-
-- A selected task can open a full-screen detail modal using `Enter` (when focused on the board); `Escape` closes the modal. The implementation checklist remains read-only for v0.1.0.
-- While the popup is open, underlying board key handlers are disabled so input is handled once.
-- The popup shows objective, full ID, status, dependencies, acceptance criteria, implementation checklist progress, transition gate preview, and current warning/message text.
-- Enter/backspace status transitions remain predictable and refresh board data after successful writes.
-- Detail rendering is compact, no-color compatible, and safe for narrow terminals.
-- Ink tests cover open/close, disabled underlying navigation, content sections, transition affordances, loading/error messages, and long text truncation.
-
-## Implementation Plan
-
-- [x] Extend board task data with implementation checklist summary parsed from the task body.
-- [x] Add a focused detail popup component or refactor `src/tui/DetailPane.tsx` into popup-oriented parts while preserving one job per file.
-- [x] Wire `src/tui/App.tsx` input handling so `Enter` opens detail, `Escape` closes it, and board-level movement/transition keys are disabled in popup mode.
-- [x] Render criteria, checklist progress, dependency status, full ID, and transition gate previews with no hidden database state.
-- [x] Ensure status transitions across selected epics refresh release-level data and surface mtime conflicts without closing or corrupting detail state.
-- [x] Read and adhere to `agent-skills/ink-tui-design/SKILL.md` for modal component structure and visual constraints.
-- [x] Update Ink tests for popup keyboard flow and rendered sections.
-- [x] Run focused App and detail component 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/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/tasks/T006-task-detail-popup.md`; `.savepoint/visual-identity.md`; `agent-skills/ink-tui-design/SKILL.md`; `agent-skills/ink-tui-design/references/component-patterns.md`; `agent-skills/ink-tui-design/references/ink-gotchas.md`; `agent-skills/ink-tui-design/references/testing-patterns.md`; `src/domain/task.ts`; `src/tui/App.tsx`; `src/tui/Board.tsx`; `src/tui/DetailPane.tsx`; `src/tui/board-data.ts`; `src/tui/state/app-reducer.ts`; `src/tui/state/view-state.ts`; `src/tui/state/reducer.ts`; `test/domain/task.test.ts`; `test/tui/board-data.test.ts`; `test/tui/components/App.test.tsx`; `test/tui/components/Board.test.tsx`; `test/tui/components/DetailPane.test.tsx`; `test/tui/state/app-reducer.test.ts`; `.savepoint/metrics/context-bench.md`.
-- Estimated input tokens: ~41,158
-- Notes: Implemented Enter/Escape modal flow per acceptance criteria and retained Space/backspace status transitions. Focused tests, typecheck, and lint pass; full format check is still blocked by unrelated pre-existing unformatted files outside this task's edit set.

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

@@ -1,34 +0,0 @@
----
-id: E08-board-workflow-cleanup/T007-templates-acceptance-criteria
-status: done
-objective: Update workflow templates and prompts so new task files require acceptance criteria before implementation planning.
-depends_on:
-  - E08-board-workflow-cleanup/T001-acceptance-criteria-model
----
-
-# T007: templates-acceptance-criteria
-
-## Acceptance Criteria
-
-- Live workflow docs and scaffold templates describe acceptance criteria as required task content before `## Implementation Plan`.
-- Task-breakdown and task-planning prompts require acceptance criteria and distinguish observable outcomes from implementation checklist steps.
-- Task-building prompts tell agents to satisfy acceptance criteria by completing the implementation checklist.
-- Router and agent templates preserve token-discipline rules and include the Ink guide conditional read where TUI implementation requires it.
-- Template tests prove generated task examples contain `## Acceptance Criteria` before `## Implementation Plan`.
-- Historical task files are not bulk edited; compatibility behavior from T001 remains the migration path.
-
-## Implementation Plan
-
-- [x] Update live `.savepoint/router.md` workflow instructions only as needed for acceptance criteria and task detail navigation wording, without advancing router state while E07 remains active.
-- [x] Update `templates/project/AGENTS.md` and `templates/project/.savepoint/router.md` so generated projects inherit acceptance-criteria and Ink-guide conditional-read guidance.
-- [x] Update `templates/prompts/task-breakdown.prompt.md`, `templates/prompts/task-planning.prompt.md`, and `templates/prompts/task-building.prompt.md` to require acceptance criteria and clarify the implementation-plan relationship.
-- [x] Update template tests for prompt shape, generated task examples, and router/agent workflow wording.
-- [x] Confirm no historical task-file migration is required for tests or templates beyond fixtures that intentionally represent new tasks.
-- [x] Run focused template 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`; `templates/project/AGENTS.md`; `templates/project/.savepoint/router.md`; `templates/prompts/task-breakdown.prompt.md`; `templates/prompts/task-planning.prompt.md`; `templates/prompts/task-building.prompt.md`; `test/templates/prompt-templates.test.ts`; `test/templates/project-templates.test.ts`; `test/templates/router-template.test.ts`; `test/templates/render-integrity.test.ts`; `test/templates/template-registry.test.ts`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/tasks/T007-templates-acceptance-criteria.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/tasks/T001-acceptance-criteria-model.md`; `src/domain/task.ts`; `.savepoint/metrics/context-bench.md`; `templates/prompts/magic-prompt.prompt.md`; `templates/prompts/audit-reconciliation.prompt.md`; `templates/prompts/epic-design.prompt.md`.
-- Estimated input tokens: ~19,360
-- Notes: Updated live router, template AGENTS.md/router.md, task prompts, and template tests. No historical task-file migration needed. All 48 template tests pass.

package/.savepoint/releases/v1/epics/_archived/E08-board-workflow-cleanup/tasks/T008-board-workflow-integration.md

@@ -1,41 +0,0 @@
----
-id: E08-board-workflow-cleanup/T008-board-workflow-integration
-status: done
-objective: Close out the board workflow cleanup by reconciling E06/E07 board rework, updating integration coverage, and running the full quality gates.
-depends_on:
-  - E08-board-workflow-cleanup/T006-task-detail-popup
-  - E08-board-workflow-cleanup/T007-templates-acceptance-criteria
----
-
-# T008: board-workflow-integration
-
-## Acceptance Criteria
-
-- E06 board command behavior still works after release-level browsing, including full-screen alternate buffer setup/teardown (restoring shell history cleanly), non-TTY fallback, TTY launch, refresh, transition gates, and mtime conflict handling.
-- E07 audit review entry still works for the router's active epic and is not confused with a merely browsed epic.
-- Existing E07 T008 audit-pipeline integration scope is respected; this task does not change E07 task status or audit lifecycle semantics.
-- Focused tests cover cross-epic board browsing through command/state/component layers.
-- Full quality gates pass or any blocker is documented in this task before handoff.
-- The E08 task set remains independently buildable and ready for normal implementation after E07 audit closeout.
-
-## Implementation Plan
-
-- [x] Review the E06 and E07 tests affected by board data shape, App keybindings, audit entry, and non-TTY output, then update only assertions that reflect intentional E08 behavior.
-- [x] Add integration coverage for browsing a non-active epic, refreshing after underlying task-file changes, transitioning a selected task by ID-derived path, and preserving active-router audit review behavior.
-- [x] Run focused command, state, component, reader, template, and audit-review tests that cover E08 changes.
-- [x] Run `npm run typecheck`, `npm run lint`, `npm run format:check`, `npm run build`, and `npm test`.
-- [x] Update E08 task context logs and `.savepoint/metrics/context-bench.md` with measured implementation context before moving this task to review.
-- [x] Leave router advancement to the normal post-E07 workflow; do not mark E08 implementation active while E07 is still incomplete or unaudited.
-- [x] Simplify the canonical task workflow to `planned`, `in_progress`, and `done`, while preserving read-time compatibility for historical `backlog` and `review` task files.
-
-## Rework Notes
-
-- E06 rework expected: board data moves from active-epic-only to release-level, reducers gain epic focus, the board collapses to a calmer three-lane workflow plus the epic rail, and plain output changes from ID-first rows to readable task lines.
-- E07 rework expected: audit proposal entry remains tied to the router active epic, and audit-review TUI patterns should be reused for mode-gated input and two-pane detail behavior where helpful.
-- E04/E05 rework expected: scaffolded workflow docs and prompts must learn acceptance criteria; historical task files should remain compatible rather than being hand-migrated.
-
-## Context Log
-
-- Files read: `.savepoint/router.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/Design.md`; `.savepoint/releases/v1/epics/E08-board-workflow-cleanup/tasks/T008-board-workflow-integration.md`; `agent-skills/ink-tui-design/SKILL.md`; `.savepoint/visual-identity.md`; `src/commands/board.ts`; `src/tui/App.tsx`; `src/tui/board-data.ts`; `src/tui/state/app-reducer.ts`; `src/tui/state/view-state.ts`; `src/tui/state/reducer.ts`; `src/tui/Board.tsx`; `src/tui/DetailPane.tsx`; `src/tui/io/write-active-router-epic.ts`; `src/tui/io/write-active-router-release.ts`; `src/tui/render/plain-table.ts`; `src/tui/theme/palette.ts`; `src/domain/config.ts`; `.savepoint/config.yml`; `test/commands/board.test.ts`; `test/commands/board-tty.test.ts`; `test/tui/components/App.test.tsx`; `test/tui/components/Board.test.tsx`; `test/tui/components/DetailPane.test.tsx`; `test/tui/state/reducer.test.ts`; `test/tui/state/app-reducer.test.ts`; `test/tui/board-data.test.ts`; `test/tui/render/plain-table.test.ts`; `.savepoint/metrics/context-bench.md`.
-- Estimated input tokens: ~43,206
-- Notes: Integration closeout for E08. Fixed the release-workflow gaps found in the manual audit: rail browsing now previews the selected epic immediately, `Enter` on the rail activates that epic in the router, transition gates evaluate against release-level task data so cross-epic dependencies still block invalid moves, and horizontal board navigation clamps instead of wrapping. Added explicit release navigation with `[` and `]`, backed by router release rewrites and reload of the first available epic/task in the selected release. Reworked the board layout to a calmer four-surface workflow (`Epics`, `Planned`, `In Progress`, `Done`) with deterministic terminal-width sizing, stronger panel outlines, and detail sections that better match `.savepoint/visual-identity.md` through dark panel surfaces, warm text, orange focus treatment, purple epic accents, and retro iconography. Simplified the canonical task status model to `planned`, `in_progress`, and `done`, while preserving read-time compatibility for historical `backlog` and `review` task files and updating write paths to persist only canonical values. Tightened the workflow docs and templates so any explicit user-requested audit must persist `.savepoint/audit/{E##-epic}/snapshot.md` and `.savepoint/audit/{E##-epic}/proposals.md` before replying, and so task-building closes at `done` instead of `review`. Focused verification for this pass: targeted board/status/theme/template tests now pass after the simplification. `.savepoint/metrics/context-bench.md` could not be updated in this pass because the file is currently deleted in the workspace.

package/.savepoint/releases/v1/epics/_archived/E09-doctor-command/Design.md

@@ -1,70 +0,0 @@
----
-type: epic-design
-status: active
----
-
-# Epic E09: doctor-command
-
-## Purpose
-
-Implement `savepoint doctor`, the diagnostic command for corrupted or inconsistent Savepoint projects. Doctor reports problems and suggested repairs, but does not make destructive changes automatically.
-
-## What this epic adds
-
-- Integrity checks for config, router state, release/epic/task structure, YAML/frontmatter, task acceptance criteria, dependency references, cycles, duplicate task IDs, audit state, and orphaned tasks.
-- Ad-hoc quality gate runner.
-- Human-readable diagnostic output.
-- Machine-testable diagnostic objects.
-- Suggested repair messages for common failure modes.
-- Layer-2 AI review prompt printing hook for future expansion, without implementing v0.2 semantic review.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                          | Purpose                       |
-| ----------------------------- | ----------------------------- |
-| `src/commands/doctor.ts`      | Doctor command entrypoint.    |
-| `src/doctor/checks/*.ts`      | Individual integrity checks.  |
-| `src/doctor/report.ts`        | Diagnostic report formatting. |
-| `src/doctor/repairs.ts`       | Suggested repair text.        |
-| `src/doctor/quality-gates.ts` | Ad-hoc quality gate reuse.    |
-| `test/doctor/**/*.test.ts`    | Diagnostic behavior tests.    |
-
-## Architectural delta
-
-Before this epic, validation exists inside specific workflows. After this epic, users have a central command for diagnosing project health outside normal board/audit flows.
-
-Doctor should reuse the data model and audit quality-gate runner instead of introducing parallel logic.
-
-## Boundaries
-
-In scope:
-
-- Detect corrupt YAML/frontmatter.
-- Detect missing config.
-- Detect missing dependencies and dependency cycles.
-- Detect duplicate task IDs.
-- Detect missing or malformed task acceptance criteria after the board workflow cleanup makes them required.
-- Detect tasks in nonexistent epics.
-- Detect audit proposals without matching audit-pending state.
-- Run configured quality gates on demand.
-
-Out of scope:
-
-- Auto-moving orphaned tasks without user action.
-- Repairing files destructively.
-- Launching the TUI.
-- Calling AI APIs.
-
-## Quality gates
-
-- Each failure mode listed in the project Design should have at least one test.
-- Reports should include file paths and actionable messages.
-- Exit codes should distinguish clean, diagnosed problems, and internal command failure.
-
-## Design constraints
-
-- Doctor diagnoses and proposes; it does not silently mutate.
-- Keep diagnostics deterministic and suitable for CI output.
-- Reuse existing validation functions wherever possible.

package/.savepoint/releases/v1/epics/_archived/E10-docs-and-packaging/Design.md

@@ -1,68 +0,0 @@
----
-type: epic-design
-status: active
----
-
-# Epic E10: docs-and-packaging
-
-## Purpose
-
-Prepare Savepoint as a public npm package with clear user-facing documentation, correct package metadata, and validated publish contents.
-
-## What this epic adds
-
-- Public README suitable for npm and GitHub.
-- MIT license finalized.
-- Package metadata review for repository, keywords, files, bin, engines, and exports.
-- `npm pack` validation.
-- Local install smoke tests from the packed tarball.
-- Documentation for install, init, board, audit, doctor, and the audit loop.
-- Release checklist draft for `0.1.0`.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                             | Purpose                                            |
-| -------------------------------- | -------------------------------------------------- |
-| `README.md`                      | Public product and usage documentation.            |
-| `LICENSE`                        | Final MIT license text.                            |
-| `package.json`                   | Publish metadata and package allowlist.            |
-| `.npmignore` or `files` field    | Publish contents control.                          |
-| `docs/*.md`                      | Optional focused docs if README becomes too large. |
-| `scripts/*.ts` or `scripts/*.js` | Optional pack/install smoke helpers.               |
-| `test/packaging/**/*.test.ts`    | Packaging validation tests if scriptable.          |
-
-## Architectural delta
-
-Before this epic, the package can function locally. After this epic, the package is shaped for public consumption and can be validated as a packed npm artifact.
-
-This epic does not publish the package; it makes publishing boring and inspectable.
-
-## Boundaries
-
-In scope:
-
-- Public docs and package metadata.
-- Packed artifact validation.
-- Local install smoke tests.
-- Ensure generated `dist/cli.js` is the published binary.
-
-Out of scope:
-
-- Actual npm publish.
-- Manual agent matrix.
-- Broad marketing site work.
-- Major feature changes discovered during docs writing unless they block package correctness.
-
-## Quality gates
-
-- `npm pack --dry-run` or equivalent should show only intended files.
-- Packed install smoke should verify `savepoint --help` and `savepoint --version`.
-- README examples should match implemented command behavior.
-
-## Design constraints
-
-- Keep docs plain and practical for vibe coders.
-- Do not over-document deferred features.
-- Treat package contents as a release contract.

package/.savepoint/releases/v1/epics/_archived/E11-release-validation/Design.md

@@ -1,68 +0,0 @@
----
-type: epic-design
-status: active
----
-
-# Epic E11: release-validation
-
-## Purpose
-
-Run the final validation matrix for `0.1.0`, resolve release-blocking issues, and prepare the public release cut.
-
-## What this epic adds
-
-- Manual e2e test matrix across Claude, Cursor, Gemini, and Aider where available.
-- Cross-platform checks for macOS, Linux, and Windows Terminal where available.
-- Fresh-project `npx savepoint init` validation.
-- Full command walkthrough: init, board, audit, and doctor.
-- Final version check for `0.1.0`.
-- Release notes.
-- Publish-readiness checklist.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                        | Purpose                                           |
-| --------------------------- | ------------------------------------------------- |
-| `docs/release-checklist.md` | Final release checklist and results.              |
-| `docs/e2e-matrix.md`        | Manual agent/platform matrix results.             |
-| `CHANGELOG.md`              | Initial release notes.                            |
-| `package.json`              | Final version metadata if needed.                 |
-| `.savepoint/audit-log.md`   | Audit history if audits were skipped or recorded. |
-
-## Architectural delta
-
-Before this epic, the package should be feature-complete for v0.1.0. After this epic, the release has documented validation evidence and can be published with known residual risks.
-
-This epic should prefer fixing release blockers in the smallest responsible place over broad refactors.
-
-## Boundaries
-
-In scope:
-
-- Manual matrix execution and recording.
-- Cross-platform smoke validation.
-- Final bug fixes required to pass release criteria.
-- Release notes and version confirmation.
-
-Out of scope:
-
-- New features.
-- v0.2.0 semantic review.
-- File watching.
-- Search.
-- MCP server work.
-
-## Quality gates
-
-- All automated tests pass.
-- Packed install smoke passes.
-- Manual e2e matrix passes against at least three of four target agents.
-- Known limitations are documented.
-
-## Design constraints
-
-- Keep late fixes narrow and auditable.
-- Do not relax quality gates to ship.
-- Record evidence, not vibes.

package/.savepoint/releases/v1/v1-PRD.md

@@ -1,66 +0,0 @@
----
-version: 1
-name: "Simplified Board"
-status: in_progress
----
-
-# Release v1 — Simplified Board
-
-## Simplification Objective
-
-The original v1 scope (11 epics, 5 CLI commands, full audit pipeline) proved over-engineered. This release strips savepoint back to its essential value: a board for tracking AI-driven development work through phases.
-
-**Stack change:** Ink/TypeScript → Bubble Tea/Go. Full rewrite.
-
-**What stays:**
-- `savepoint board` — Bubble Tea TUI for viewing and moving tasks
-- The `.savepoint/` data structure: router → release → epic → task
-- AGENTS.md as the agent bootstrap file
-
-**What goes:**
-- `init`, `audit`, `doctor` commands
-- Full 6-step audit pipeline
-- Template scaffolding and prompt generation
-- Quality gates, divergence thresholds, snapshot generation
-- Complex router state machine (6 states → 3 states)
-- TypeScript, React, Ink, npm, tsup, vitest
-
-**What replaces the audit pipeline:**
-- Tasks in `in_progress` now carry a `phase`: `build → test → audit → done`
-- The board itself enforces phase progression
-- Space advances phase, backspace retreats
-- Must reach `audit` phase before advancing to `done`
-
-## What ships in v0.2.0
-
-- `savepoint board` — the only CLI command (Go binary)
-- Phase-aware Kanban board: planned / in_progress (build/test/audit) / done
-- Task status transitions with phase gating
-- Non-TTY plain table fallback
-- Atari-Noir theme, fully overridable via `config.yml`
-- Go 1.23+, single binary, `go build`
-
-## Epic breakdown
-
-| #   | Epic name                    | Purpose |
-| --- | ---------------------------- | ------- |
-| 01  | `E01-go-setup`               | Initialize Go module, project structure, dependencies, build loop |
-| 02  | `E02-data-readers`           | Parse markdown/yaml, read .savepoint data (router, config, tasks) |
-| 03  | `E03-board-tui-core`         | Bubble Tea model, update loop, view, styles, responsive layout |
-| 04  | `E04-board-components`       | Columns, cards with phase glyphs, epic panel, detail overlay, dropdowns, help |
-| 05  | `E05-phase-transitions`      | Phase stepping, gates, task frontmatter write-back, router state write-back |
-
-## Success criteria
-
-- `savepoint board` launches and renders the phase-aware Kanban board.
-- Space/backspace correctly advances/retreats task phases.
-- Cannot advance to `done` without passing through `audit` phase.
-- `go build` produces a working binary.
-- `go test ./...` passes.
-- No dead code, no unused dependencies, no references to deleted commands.
-
-## Risks
-
-- **Agent compliance.** Simpler structure should improve compliance. AGENTS.md must be crystal clear.
-- **Phase model clarity.** Users must understand build/test/audit as sub-states of in_progress. Board rendering must make this obvious.
-- **Go ecosystem.** New stack requires different testing patterns, dependency management, build tooling.

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md

@@ -1,40 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# Epic E01: TUI Optimisation
-
-## Purpose
-
-Performance, layout robustness, and structural improvements for the board TUI. Focused on fixing rendering edge-cases (resize clipping, wasted space) and improving the codebase's architectural hygiene around file watching and data refresh.
-
-## Definition of Done
-
-- Right-border clipping is eliminated at all terminal widths ≥ 40
-- Resize handling is robust — no corruption, no artifacts when growing/shrinking
-- The board auto-refreshes when task files change on disk via fsnotify
-- Board columns use virtual viewport scrolling — 4-5 cards visible with `↑/↓` indicators
-- Detail overlay is height-capped (~70%) with scroll indicators for overflow content
-- All scroll indicators use dim/subtle styling consistent with Atari Noir aesthetic
-
-## Implemented As
-
-- Header Next Activity rendering is implemented in `internal/board/view.go` using `FormatNextActivity` and `styles.HeaderRight`.
-- Column and detail scrolling are implemented through `ColumnOffsets`, `DetailOffset`, height-aware layout, viewport slicing, and subtle scroll indicators in `internal/board/model.go`, `internal/board/layout.go`, `internal/board/update.go`, `internal/board/column.go`, and `internal/board/detail.go`.
-- Focus border stability is implemented by rendering unfocused columns with `styles.ColumnUnfocused`, matching focused column border dimensions while using the subtle border color.
-- Naming conventions were reconciled across workflow docs: per-epic `Design.md` files became `E##-Detail.md`, and release `PRD.md` became `{release}-PRD.md`.
-- The originally listed fsnotify watcher scope was already present from the prior TUI epic and was reviewed as existing behavior rather than newly introduced in this epic.
-
-## Components and files
-
-| Path | Purpose |
-|------|---------|
-| `internal/board/layout.go` | Layout arithmetic and resize guards, height-aware ContentHeight |
-| `internal/board/view.go` | Minimum width clamping, height passthrough to renderers |
-| `internal/board/watch.go` | File watcher and reload commands |
-| `internal/board/model.go` | Watcher lifecycle, ColumnOffsets, DetailOffset state |
-| `internal/board/update.go` | Reload message handling, auto-scroll offsets, PageUp/PageDown |
-| `internal/board/column.go` | Virtual viewport slicing, scroll indicator rendering |
-| `internal/board/detail.go` | Height-capped overlay, detail scroll indicators |
-| `internal/styles/styles.go` | ScrollIndicator style (dim/subtle) |

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T001-next-activity-header.md

@@ -1,56 +0,0 @@
----
-id: E01-tui-optimisation/T001-next-activity-header
-status: done
-objective: "Show Next Activity indicator in the TUI header bar, right-aligned, displaying the current router state"
-depends_on: []
----
-
-# T001: Next Activity Header Display
-
-## Acceptance Criteria
-
-- The header bar displays "Next Activity:" followed by a formatted state string on the right side
-- When router state is `task-building`, displays "Build T{NNN} (E{NN}) v{N}" format (e.g., "Build T010 (E06) v1")
-- When router state is `audit-pending`, displays "Audit E{NN}" format (e.g., "Audit E06")
-- For `epic-design` state, displays "Design E{NN}" format
-- For `epic-task-breakdown` state, displays "Plan E{NN}" format
-- For `pre-implementation` state, displays "Planning v{N}" format
-- The Next Activity text (excluding "Next Activity:" label) is capped at 20 characters maximum, with ellipsis truncation if exceeded
-- The display gracefully degrades at narrow terminal widths (header text remains intact, Next Activity truncates but doesn't break layout)
-- All existing tests pass
-
-## Implementation Plan
-
-- [x] Add `HeaderRight` style to `internal/styles/styles.go` (dim foreground, right-aligned)
-- [x] Create `FormatNextActivity(state *data.RouterState) string` helper in `internal/board/view.go` that:
-  - Parses router state and formats compact string based on state type
-  - Truncates to max 20 chars using `xansi.Truncate` with ellipsis
-- [x] Update `view.go` `View()` method — modify header rendering:
-  - Split header into left (icon + "SAVEPOINT") and right sections
-  - Use `lipgloss.PlaceHorizontal` or manual string construction to position Next Activity on right
-  - Maintain existing `HeaderFrame` width and padding
-- [x] Update `main.go` or board initialization to read router state and populate `Model` with parsed state
-- [x] Add test in `internal/board/view_test.go` for Next Activity rendering at various widths
-- [x] Add test for `FormatNextActivity` covering all router states and truncation behavior
-- [x] Run quality gates — `make build && make test` unavailable in this shell; equivalent `go build ./...` and `go test ./...` pass
-
-## Context Log
-
-Files read:
-- `internal/board/view.go`
-- `internal/board/model.go`
-- `internal/styles/styles.go`
-- `internal/data/router.go`
-- `internal/board/view_test.go`
-- `.savepoint/router.md`
-- `.savepoint/releases/v1.1/epics/E03-header-activity/E03-Detail.md`
-
-Estimated input tokens: 2800
-
-Notes:
-- Uses existing `data.RouterState` model — no new data parsing needed
-- Router state already available via `m.RouterTask` in Model — may need to add `*data.RouterState` field or parse separately
-- Truncation uses same `xansi` package already imported in view.go
-- Max 20 char constraint keeps header clean at all terminal widths
-- Audit must-fix applied: stale implementation checklist items were ticked after verifying the implemented source and tests.
-- Quality gates verified during audit: `go build ./...` passed; `go test ./...` passed.

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T002-rename-epic-design-files.md

@@ -1,38 +0,0 @@
----
-id: E01-tui-optimisation/T002-rename-epic-design-files
-status: done
-objective: "Rename all epic Design.md files to E##-Detail.md convention"
-depends_on: []
----
-
-# T002: Rename Epic Design Files
-
-## Acceptance Criteria
-
-- All 8 active epic `Design.md` files renamed to `E##-Detail.md` pattern
-- Archived epics under `_archived/` left unchanged
-- Root `.savepoint/Design.md` left unchanged
-- No content changes in renamed files
-- All renamed files remain valid markdown with intact frontmatter
-
-## Implementation Plan
-
-- [x] Rename `.savepoint/releases/v1/epics/E01-go-setup/Design.md` → `E01-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E02-data-readers/Design.md` → `E02-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E03-board-tui-core/Design.md` → `E03-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E04-board-components/Design.md` → `E04-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E05-phase-transitions/Design.md` → `E05-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md` → `E06-Detail.md`
-- [x] Rename `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md` → `E01-Detail.md`
-- [x] Rename `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/Design.md` → `E02-Detail.md`
-
-## Context Log
-
-Files read:
-- None (file renames only)
-
-Estimated input tokens: 300
-
-Notes:
-- Content is not modified, only file paths change
-- Archived epics explicitly excluded per user request