savepoint 1.0.2 → 1.0.4

package/.savepoint/audit/v1/E03-cli-foundation/snapshot.md

@@ -1,106 +0,0 @@
----
-type: audit-snapshot
-epic: E03-cli-foundation
-created: 2026-04-27
-manual: true
----
-
-# Audit Snapshot: E03-cli-foundation
-
-Manual snapshot generated because `savepoint audit` is not implemented yet.
-
-## Source file tree
-
-```
-src/
-  cli.ts                     - process entrypoint; delegates to runCli() with process globals
-  cli/
-    args.ts                  - argument parsing and normalization
-    environment.ts           - TTY, color, and platform detection
-    exit-codes.ts            - shared exit code constants
-    help.ts                  - help text generation (top-level and per-command)
-    run.ts                   - testable CLI runner with injectable argv/streams/env
-  commands/
-    audit.ts                 - stub: savepoint audit
-    board.ts                 - stub: savepoint board
-    doctor.ts                - stub: savepoint doctor
-    init.ts                  - stub: savepoint init
-test/
-  cli/
-    args.test.ts             - parser unit tests
-    commands.test.ts         - command stub dispatch tests
-    environment.test.ts      - TTY/color detection tests
-    help.test.ts             - help text generation tests
-    run.test.ts              - full runner dispatch tests (35 tests)
-```
-
-## Config / metadata changes
-
-| Path                                    | Purpose                                                                                       |
-| --------------------------------------- | --------------------------------------------------------------------------------------------- |
-| `.savepoint/router.md`                  | Router state still pointed at T001; E03 tasks were completed without router updates per task. |
-| `E03-cli-foundation/tasks/T001-T006.md` | Six planned and completed E03 task files.                                                     |
-
-## New files introduced by E03
-
-- `src/cli/args.ts`
-- `src/cli/environment.ts`
-- `src/cli/exit-codes.ts`
-- `src/cli/help.ts`
-- `src/cli/run.ts`
-- `src/commands/audit.ts`
-- `src/commands/board.ts`
-- `src/commands/doctor.ts`
-- `src/commands/init.ts`
-- `src/commands/result.ts`
-- `test/cli/args.test.ts`
-- `test/cli/commands.test.ts`
-- `test/cli/environment.test.ts`
-- `test/cli/help.test.ts`
-- `test/cli/run.test.ts`
-
-## Modified files
-
-- `src/cli.ts` — replaced old placeholder with `runCli()` delegation; process globals isolated here.
-- `src/cli/run.ts` — command-level unknown flags now return usage errors.
-- `src/commands/audit.ts` — prettier formatting applied.
-- `src/commands/board.ts` — prettier formatting applied.
-- `src/commands/doctor.ts` — prettier formatting applied.
-- `src/commands/init.ts` — prettier formatting applied.
-- `test/cli/environment.test.ts` — prettier formatting applied.
-- `test/cli/run.test.ts` — prettier formatting applied.
-
-## Quality gates
-
-- `npm run build` passed. Output: `dist/cli.js` 4.83 KB.
-- `npm run typecheck` passed.
-- `npm run lint` passed.
-- `npm run format:check` initially failed on 6 pre-existing files (commands and CLI tests); fixed with `prettier --write`, then passed.
-- During audit closeout, `npm.cmd test -- test/cli/run.test.ts` initially failed in the sandbox with esbuild `spawn EPERM`; rerunning outside the sandbox passed.
-- `npm test` passed: 21 test files, 259 tests (0 failures).
-
-## Coverage summary
-
-| Branch                    | Test file           | Tests |
-| ------------------------- | ------------------- | ----- |
-| Bare invocation           | run.test.ts         | 3     |
-| Global help flags         | run.test.ts         | 4     |
-| Version flags             | run.test.ts         | 4     |
-| Command dispatch (4 cmds) | run.test.ts         | 8     |
-| Command-level help        | run.test.ts         | 7     |
-| Unknown command           | run.test.ts         | 3     |
-| Unknown flag              | run.test.ts         | 6     |
-| Argument parsing          | args.test.ts        | 12    |
-| Help text                 | help.test.ts        | 13    |
-| Environment detection     | environment.test.ts | 15    |
-| Command stubs             | commands.test.ts    | 8     |
-
-## Deviations from epic Design
-
-| Item                      | Status | Note                                                                                                 |
-| ------------------------- | ------ | ---------------------------------------------------------------------------------------------------- |
-| Audit snapshot            | manual | Generated by the agent because the audit CLI does not exist yet.                                     |
-| Router state              | manual | Router still shows T001 as active; router was not updated per-task during E03 implementation.        |
-| Prettier failures at gate | fixed  | 6 command/test files had formatting issues at T006; fixed before gate closeout.                      |
-| `src/cli.ts` entrypoint   | done   | Updated from placeholder to `runCli()` delegation with all process globals isolated at the boundary. |
-| Command-level flags       | fixed  | Unknown command-level flags now return usage errors instead of dispatching command stubs.            |

package/.savepoint/audit/v1/E04-board-components/proposals.md

@@ -1,118 +0,0 @@
-## Target File
-
-`.savepoint/Design.md`
-
-## Replace
-
-```md
-**Layout:** single screen with a 5-column Kanban board and detail pane. Non-TTY output uses `src/tui/render/plain-table.ts`.
-
-**Implementation modules:** see AGENTS.md Codebase Map (E06 and E07 epic rows).
-
-**Keybindings:** arrow/vim navigation, enter advances, backspace retreats, r/R refreshes, a/A exits toward audit review when proposals exist, q quits.
-```
-
-## With
-
-```md
-**Layout:** Go Bubble Tea board with responsive columns: wide terminals (`>=120` cols) show an epic sidebar plus planned / in-progress / done columns; medium terminals show three columns; narrow terminals show the focused column only.
-
-**Board components:** E04 adds Lip Gloss renderers for columns, task cards, epic sidebar/dropdown, release dropdown, task detail overlay, and help overlay. Selector, detail, and help overlays dim the current board and composite a centered panel over it.
-
-**Implementation modules:** see AGENTS.md Codebase Map (`internal/board/*`, `internal/styles/*`, and `internal/data/*` rows).
-
-**Keybindings:** h/left and l/right move columns; enter opens task detail or selects an overlay item; e opens the epic selector on narrow screens; r opens the release selector; ? opens help; esc/q close overlays; q/ctrl+c quit from the base board.
-```
-
-## Target File
-
-`AGENTS.md`
-
-## Insert After
-
-```md
-| `internal/data/errors.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Shared data-reader boundary error sentinels                                                          |
-```
-
-## With
-
-```md
-| `internal/board/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)                | Bubble Tea board state for grouped tasks, focused column/task, selected release/epic, responsive size, and active overlay |
-| `internal/board/update.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)                | Keyboard and window-size update handling for board navigation, overlays, selectors, and quit behavior |
-| `internal/board/layout.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)                | Responsive board geometry breakpoints and column/sidebar width calculation                            |
-| `internal/board/view.go`             | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)                | Board view composition, status bar, responsive columns, and overlay placement helpers                 |
-| `internal/board/column.go`           | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Column renderer with status header, task count, empty state, and focused border styling               |
-| `internal/board/card.go`             | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Task card renderer with phase glyphs, metadata dimming, truncation, and focus styling                 |
-| `internal/board/epic_panel.go`       | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Wide epic sidebar and narrow epic selector dropdown renderers                                         |
-| `internal/board/detail.go`           | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Task detail overlay renderer with task metadata, description, acceptance criteria, and phase labels   |
-| `internal/board/release.go`          | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Release selector dropdown renderer and current-release cursor lookup                                  |
-| `internal/board/help.go`             | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Keyboard shortcut help overlay renderer                                                               |
-| `internal/styles/*.go`               | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Atari-Noir Lip Gloss palette and shared board, card, overlay, glyph, status, and tag styles          |
-| `internal/board/*_test.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md) / [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md) | Go board model, layout, update, view, component, selector, detail, and help tests                     |
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`
-
-## Insert After
-
-```md
-## Definition of Done
-
-- Cards render with correct phase glyphs and colors.
-- Focused card has orange accent border.
-- Epic panel renders on wide screens; dropdown on narrow.
-- Detail overlay opens with Enter, closes with Esc.
-- Epic dropdown opens with `e`, release with `r`.
-- Help overlay opens with `?`.
-- All components render without wrapping or layout breaks.
-- Component tests pass.
-```
-
-## With
-
-```md
-## Implemented As
-
-- `internal/board/column.go` renders status columns with uppercase label, task count, empty state, focused border, and task cards.
-- `internal/board/card.go` renders standalone task cards with build/test/audit glyphs, dim metadata, truncation, and focused styling.
-- `internal/board/epic_panel.go` renders the wide epic sidebar and narrow epic dropdown; `e` opens the dropdown only below the wide breakpoint.
-- `internal/board/release.go` renders the release dropdown; `r` opens it at all widths.
-- `internal/board/detail.go` renders task detail panels with wrapped long text; `internal/board/view.go` dims the board and composites selector/detail/help overlays over the base board.
-- `internal/board/help.go` renders the keyboard shortcut overlay.
-- `internal/styles/styles.go` and `internal/styles/palette.go` add shared Lip Gloss styles for cards, overlays, metadata, glyphs, and dim text.
-
-## Audit Deltas
-
-- Planned `internal/board/dropdown.go` was not created; epic and release dropdowns are separate renderers.
-- Task cards are integrated into column rendering; board columns now display card borders and phase glyphs.
-- Selecting an epic or release updates `SelectedEpic` / `SelectedRelease` and regroups visible board tasks from `Model.AllTasks`.
-- Selector/detail/help overlays keep the dimmed board visible behind the panel.
-- Base board up/down navigation moves the focused task within the focused column.
-```
-
-## Quality Review
-
-## Must Fix Before Close
-
-No open findings.
-
-## Must Fix Before Next Epic
-
-No open findings.
-
-## Carry Forward
-
-- The current project architecture and Codebase Map still contain substantial TypeScript-era rows. This proposal adds E04 Go rows as a delta, but a later audit should reconcile the stale TypeScript implementation sections once the Go transition is complete.
-
-## Already Fixed
-
-- Board columns render `RenderCard`, so phase glyphs, card borders, truncation, and focused card styling are visible in the actual board.
-- Epic and release selections regroup visible tasks from `Model.AllTasks`.
-- Epic and release dropdowns use the same dimmed-base overlay composition as detail/help.
-- Base board up/down navigation moves `FocusedTask` and clamps at column bounds.
-- Detail rows, descriptions, and acceptance criteria wrap long text within overlay width.
-- Focused tests passed during audit: `go test ./internal/board/...`.
-- Full Go suite passed during audit: `go test ./...`.
-- Help and detail overlays use the dimmed-base compositing path and close on `esc` / `q`.

package/.savepoint/audit/v1/E04-board-components/snapshot.md

@@ -1,77 +0,0 @@
-# Manual Audit Snapshot: E04-board-components
-
-Created: 2026-05-01
-
-Reason: `.savepoint/router.md` is in `audit-pending` for `E04-board-components`, but `.savepoint/audit/E04-board-components/snapshot.md` was missing. Per router instructions, this is a one-time manual snapshot from the known epic scope.
-
-## Router State
-
-```yaml
-state: audit-pending
-release: v1
-epic: E04-board-components
-task: E04-board-components/T006-help-overlay
-next_action: "Epic E04-board-components complete. Start a new agent session for audit."
-```
-
-## Epic Scope
-
-Epic design: `.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`
-
-Tasks:
-
-- `.savepoint/releases/v1/epics/E04-board-components/tasks/T001-column.md`
-- `.savepoint/releases/v1/epics/E04-board-components/tasks/T002-card.md`
-- `.savepoint/releases/v1/epics/E04-board-components/tasks/T003-epic-panel.md`
-- `.savepoint/releases/v1/epics/E04-board-components/tasks/T004-detail-overlay.md`
-- `.savepoint/releases/v1/epics/E04-board-components/tasks/T005-release-dropdown.md`
-- `.savepoint/releases/v1/epics/E04-board-components/tasks/T006-help-overlay.md`
-
-## Files Listed By Epic Design
-
-- `internal/board/column.go`
-- `internal/board/card.go`
-- `internal/board/epic_panel.go`
-- `internal/board/detail.go`
-- `internal/board/dropdown.go` (planned; no live file found)
-- `internal/board/help.go`
-- `internal/board/card_test.go`
-- `internal/board/column_test.go`
-
-## Additional Files Touched By Task Logs
-
-- `internal/board/model.go`
-- `internal/board/update.go`
-- `internal/board/view.go`
-- `internal/board/layout.go`
-- `internal/board/detail_test.go`
-- `internal/board/epic_panel_test.go`
-- `internal/board/help_test.go`
-- `internal/board/release.go`
-- `internal/board/release_test.go`
-- `internal/board/update_test.go`
-- `internal/board/view_test.go`
-- `internal/styles/styles.go`
-- `internal/styles/palette.go`
-
-## Verification Re-run During Audit
-
-- `go test ./internal/board/...` passed.
-- `go test ./...` passed.
-
-## Scoped Review Notes
-
-- `RenderCard` is implemented and tested, but `RenderColumn` still renders plain task labels through `taskLabel`, and `rg RenderCard internal/board` shows no production call site outside `card.go`.
-- Epic and release selection currently mutate `SelectedEpic` / `SelectedRelease` only. There is no data reload or regrouping path in `internal/board/update.go`, so the task-list update acceptance criteria are not yet satisfied.
-- Detail/help overlays are composited over dimmed base board. Epic/release dropdowns use `lipgloss.Place` over a blank canvas, so the board is not visible behind those overlays.
-
-## Post-Audit Implementation
-
-Updated after user request to implement all audit findings:
-
-- `RenderColumn` now renders `RenderCard` for each task.
-- `Model` now stores `AllTasks` and regroups visible tasks when epic/release selection changes.
-- Base board `up`/`k` and `down`/`j` move focused task selection.
-- Epic/release dropdowns now composite over the dimmed board.
-- Detail overlay text now wraps long rows, description, and acceptance criteria.
-- Verification after implementation: `go build ./...`, `go vet ./...`, and `go test ./...` passed.

package/.savepoint/audit/v1/E04-templates-and-prompts/snapshot.md

@@ -1,115 +0,0 @@
----
-type: audit-snapshot
-epic: E04-templates-and-prompts
-created: 2026-04-27
-manual: true
----
-
-# Audit Snapshot: E04-templates-and-prompts
-
-Manual snapshot generated because `savepoint audit` is not implemented yet.
-
-## Source file tree
-
-```text
-src/
-  templates/
-    index.ts     - public export surface for template helpers
-    load.ts      - async template file loader with path-aware not_found errors
-    manifest.ts  - typed manifest of project, release, and prompt templates
-    paths.ts     - template root discovery and template path resolution
-    render.ts    - small placeholder interpolation helper
-templates/
-  project/
-    AGENTS.md
-    .savepoint/
-      router.md
-      PRD.md
-      Design.md
-      config.yml
-      visual-identity.md
-  release/
-    v1/
-      PRD.md
-  prompts/
-    audit-reconciliation.prompt.md
-    design.prompt.md
-    epic-design.prompt.md
-    prd.prompt.md
-    task-breakdown.prompt.md
-    task-building.prompt.md
-    task-planning.prompt.md
-test/
-  templates/
-    project-templates.test.ts
-    prompt-templates.test.ts
-    render-integrity.test.ts
-    router-template.test.ts
-    template-registry.test.ts
-```
-
-## Config / metadata changes
-
-| Path                                                      | Purpose                                     |
-| --------------------------------------------------------- | ------------------------------------------- |
-| `.savepoint/router.md`                                    | Router state points to E04 audit-pending.   |
-| `E04-templates-and-prompts/tasks/T001-T005.md`            | Five completed E04 task files.              |
-| `.savepoint/audit/E04-templates-and-prompts/snapshot.md`  | Manual audit snapshot for this epic.        |
-| `.savepoint/audit/E04-templates-and-prompts/proposals.md` | Single audit proposal bundle for this epic. |
-
-## New files introduced by E04
-
-- `src/templates/index.ts`
-- `src/templates/load.ts`
-- `src/templates/manifest.ts`
-- `src/templates/paths.ts`
-- `src/templates/render.ts`
-- `templates/project/AGENTS.md`
-- `templates/project/.savepoint/router.md`
-- `templates/project/.savepoint/PRD.md`
-- `templates/project/.savepoint/Design.md`
-- `templates/project/.savepoint/config.yml`
-- `templates/project/.savepoint/visual-identity.md`
-- `templates/release/v1/PRD.md`
-- `templates/prompts/audit-reconciliation.prompt.md`
-- `templates/prompts/design.prompt.md`
-- `templates/prompts/epic-design.prompt.md`
-- `templates/prompts/prd.prompt.md`
-- `templates/prompts/task-breakdown.prompt.md`
-- `templates/prompts/task-building.prompt.md`
-- `templates/prompts/task-planning.prompt.md`
-- `test/templates/project-templates.test.ts`
-- `test/templates/prompt-templates.test.ts`
-- `test/templates/render-integrity.test.ts`
-- `test/templates/router-template.test.ts`
-- `test/templates/template-registry.test.ts`
-
-## Quality gates
-
-- `npm run build` passed. Output: `dist/cli.js` 4.83 KB.
-- `npm run typecheck` passed.
-- `npm run lint` passed.
-- `npm run format:check` passed.
-- `npm test` passed: 26 test files, 299 tests.
-
-## Coverage summary
-
-| Branch / behavior                        | Test file                                           |
-| ---------------------------------------- | --------------------------------------------------- |
-| Template path routing by template family | template-registry.test.ts                           |
-| Missing template boundary error          | template-registry.test.ts                           |
-| Placeholder interpolation                | template-registry.test.ts, render-integrity.test.ts |
-| Required project template files/markers  | project-templates.test.ts                           |
-| Router states and read-order markers     | router-template.test.ts                             |
-| Prompt template set and required markers | prompt-templates.test.ts                            |
-| Audit prompt single-bundle guidance      | prompt-templates.test.ts                            |
-
-## Deviations from epic Design
-
-| Item                      | Status | Note                                                                                                   |
-| ------------------------- | ------ | ------------------------------------------------------------------------------------------------------ |
-| Audit snapshot            | manual | Generated by the agent because the audit CLI does not exist yet.                                       |
-| Template loader errors    | done   | Loader currently reports missing read failures as `not_found`.                                         |
-| Interpolation variables   | done   | Implemented for `projectName`, `releaseNumber`, and `releaseName`.                                     |
-| Audit proposal output     | done   | E04 prompt locks audit reconciliation to one `proposals.md` bundle.                                    |
-| Audit initiation friction | found  | The router assumed the snapshot existed; this caused an unnecessary missing-file probe at audit start. |

package/.savepoint/audit/v1/E05-init-command/snapshot.md

@@ -1,125 +0,0 @@
----
-type: audit-snapshot
-epic: E05-init-command
-created: 2026-04-27
-manual: true
----
-
-# Audit Snapshot: E05-init-command
-
-Manual snapshot generated because `savepoint audit` is not implemented yet.
-
-## Source file tree
-
-```text
-src/
-  cli.ts                 - async process entrypoint delegates to runCli()
-  cli/
-    args.ts              - init option parsing and validation
-    exit-codes.ts        - shared CLI exit code constants, including boundary errors
-    help.ts              - init help text
-    run.ts               - async command dispatcher and init dependency injection
-  commands/
-    init.ts              - init command orchestration
-  init/
-    clipboard.ts         - best-effort clipboard command selection and execution
-    dev-deps.ts          - package manager detection and optional install execution
-    magic-prompt.ts      - post-init prompt generation from template assets
-    validate-target.ts   - target directory safety checks
-    write-scaffold.ts    - template-backed scaffold writer
-  templates/
-    manifest.ts          - project and prompt template registry entries
-templates/
-  project/
-    AGENTS.md
-    .savepoint/
-      router.md
-      metrics/
-        context-bench.md
-  prompts/
-    magic-prompt.prompt.md
-test/
-  cli/
-    args.test.ts
-    commands.test.ts
-    run.test.ts
-  init/
-    clipboard.test.ts
-    dev-deps.test.ts
-    init-command.test.ts
-    magic-prompt.test.ts
-    validate-target.test.ts
-    write-scaffold.test.ts
-  templates/
-    project-templates.test.ts
-```
-
-## Config / metadata changes
-
-| Path                                                      | Purpose                                 |
-| --------------------------------------------------------- | --------------------------------------- |
-| `.savepoint/router.md`                                    | Router state reached E05 audit handoff. |
-| `E05-init-command/tasks/T001-T006.md`                     | Six completed E05 task files.           |
-| `.savepoint/audit/E05-init-command/snapshot.md`           | Manual audit snapshot for this epic.    |
-| `.savepoint/audit/E05-init-command/proposals.md`          | Single audit proposal bundle, pending.  |
-| `.savepoint/metrics/context-bench.md`                     | Context rows for E05 task building.     |
-| `AGENTS.md`                                               | Codebase Map needs E05 module refresh.  |
-| `.savepoint/releases/v1/epics/E05-init-command/E05-Detail.md` | Epic Design needs implemented-as notes. |
-
-## New files introduced by E05
-
-- `src/init/clipboard.ts`
-- `src/init/dev-deps.ts`
-- `src/init/magic-prompt.ts`
-- `src/init/validate-target.ts`
-- `src/init/write-scaffold.ts`
-- `templates/project/.savepoint/metrics/context-bench.md`
-- `templates/prompts/magic-prompt.prompt.md`
-- `test/init/clipboard.test.ts`
-- `test/init/dev-deps.test.ts`
-- `test/init/init-command.test.ts`
-- `test/init/magic-prompt.test.ts`
-- `test/init/validate-target.test.ts`
-- `test/init/write-scaffold.test.ts`
-
-## Changed files in scope
-
-- `src/cli.ts`
-- `src/cli/args.ts`
-- `src/cli/exit-codes.ts`
-- `src/cli/help.ts`
-- `src/cli/run.ts`
-- `src/commands/init.ts`
-- `src/templates/manifest.ts`
-- `templates/project/AGENTS.md`
-- `templates/project/.savepoint/router.md`
-- `test/cli/args.test.ts`
-- `test/cli/commands.test.ts`
-- `test/cli/run.test.ts`
-- `test/templates/project-templates.test.ts`
-
-## Quality gates
-
-- Focused init tests passed during task closeout.
-- Full quality gate suite passed during T006 closeout per task context.
-
-## Coverage summary
-
-| Branch / behavior                         | Test file                               |
-| ----------------------------------------- | --------------------------------------- |
-| Init CLI option parsing and invalid flags | args.test.ts                            |
-| Init command dispatch and async runner    | run.test.ts, init-command.test.ts       |
-| Target directory validation               | validate-target.test.ts                 |
-| Scaffold writing and overwrite behavior   | write-scaffold.test.ts                  |
-| Magic prompt generation                   | magic-prompt.test.ts                    |
-| Clipboard success, skip, and failure      | clipboard.test.ts, init-command.test.ts |
-| Dev-dependency install path               | dev-deps.test.ts, init-command.test.ts  |
-| Template registry and project assets      | project-templates.test.ts               |
-
-## Deviations from epic Design
-
-| Item                  | Status | Note                                                                                          |
-| --------------------- | ------ | --------------------------------------------------------------------------------------------- |
-| Audit snapshot        | manual | Generated by the agent because the audit CLI does not exist yet.                              |
-| Init command boundary | done   | `runCli()` and init orchestration became async to support clipboard and install subprocesses. |
-| Optional install      | done   | Implemented as explicit flag-driven behavior with package manager detection.                  |

package/.savepoint/audit/v1/E05-phase-transitions/proposals.md

@@ -1,83 +0,0 @@
-# Audit Proposals: E05-phase-transitions
-
-## Target File
-
-`.savepoint/Design.md`
-
-## Insert After
-
-```md
-- **Board command** (`savepoint board`) reads project, non-TTY fallback, Ink TUI, transition gates, mtime writes, audit signaling (epic E06).
-```
-
-## With
-
-```md
-- **Phase transitions** are owned by the Go board/data boundary: `internal/board/transitions.go` defines planned/in_progress/done phase movement and gate checks; `internal/data/write.go` owns mtime-checked task and router frontmatter writes.
-```
-
-## Target File
-
-`AGENTS.md`
-
-## Insert After
-
-```md
-| `internal/data/errors.go`                     | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Shared data-reader boundary error sentinels                                                          |
-```
-
-## With
-
-```md
-| `internal/data/write.go`                      | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md)         | Mtime-checked task status/phase and router current-state write helpers                               |
-| `internal/board/transitions.go`               | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md)         | Board phase advance/retreat lifecycle and dependency gate checks                                     |
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md`
-
-## Insert After
-
-```md
-## Definition of Done
-```
-
-## With
-
-```md
-## Implemented As
-
-- `internal/board/transitions.go` implements in-memory phase movement and `CanAdvance` gate checks.
-- `internal/board/update.go` maps Space and Backspace to transition helpers and displays gate-block reasons in the status bar.
-- `internal/data/write.go` adds mtime-checked write helpers for task frontmatter and router current state.
-- `internal/board/model.go` carries `Root` and writes selected release/epic changes back to `router.md`.
-
-## Audit Delta
-
-- The task write helper exists, but board Space/Backspace does not yet call it, so task markdown write-back is not implemented on the live interaction path.
-- Router write-back is implemented only for release/epic overlay selection, preserving the existing `next_action` value.
-```
-
-## Quality Review
-
-## Must Fix Before Close
-
-- `internal/board/update.go:47` and `internal/board/update.go:64`: Space/Backspace mutate `m.AllTasks` and refresh the grouped view, but never call `data.WriteTaskStatus`. The epic Definition of Done says task `.md` files are updated and mtime conflicts are detected/reported. The current live board path is memory-only, so the central write-back acceptance criteria from T003 are not satisfied outside isolated helper tests.
-- `internal/board/update.go:47`: the update path has no way to know a selected task file path or expected task mtime. `data.Task` carries task metadata but not source path/mtime, and the board model does not keep a side table for them. That means mtime conflict detection cannot be enforced for task status transitions as designed.
-
-## Must Fix Before Next Epic
-
-- Add reducer/integration tests for Space and Backspace that verify the board either writes through `WriteTaskStatus` successfully or reports `ErrMtimeConflict` without mutating local state. Current tests cover `Advance`, `Retreat`, and `WriteTaskStatus` independently, but not the user-facing transition workflow.
-- Harden `WriteTaskStatus` body preservation. `internal/data/write.go:54` computes the body offset from the trimmed frontmatter returned by `extractFrontmatter`; frontmatter with extra blank lines or trailing whitespace can shift the splice point. Prefer deriving the body boundary from delimiter indexes in the original normalized content.
-
-## Carry Forward
-
-- Keep `WriteRouterState` as the data-layer boundary for router YAML updates, but document that callers must preserve `next_action` by reading existing router state first.
-- Consider splitting `internal/data/write.go` if task writes and router writes grow separate validation rules; for now it is still small enough to remain a single file.
-
-## Already Fixed
-
-- Phase order helpers cover planned -> in_progress/build -> test -> audit -> done and the reverse path.
-- Dependency gates block audit -> done when dependencies are missing or not done.
-- Router release/epic selection writes through the data-layer mtime helper and reports errors via `StatusMessage`.

package/.savepoint/audit/v1/E05-phase-transitions/snapshot.md

@@ -1,36 +0,0 @@
-# Audit Snapshot: E05-phase-transitions
-
-Manual snapshot created because `.savepoint/audit/E05-phase-transitions/snapshot.md` was missing when the router was already in `audit-pending`.
-
-## Router State
-
-```yaml
-state: audit-pending
-release: v1
-epic: E05-phase-transitions
-task: ""
-next_action: "Epic E05-phase-transitions is complete. Start a new agent session for the audit."
-```
-
-## Epic Scope
-
-- `.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md`
-- `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T001-phase-stepping.md`
-- `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T002-gates.md`
-- `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T003-write-task.md`
-- `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T004-write-router.md`
-
-## Changed Files Reviewed
-
-- `internal/board/transitions.go`
-- `internal/board/transitions_test.go`
-- `internal/board/update.go`
-- `internal/board/model.go`
-- `internal/data/write.go`
-- `internal/data/write_test.go`
-
-## Audit Notes
-
-- The repository has a broad dirty worktree unrelated to this audit. This snapshot is intentionally scoped to the active epic design, task context logs, and files named by the E05 design/tasks.
-- Task closeout logs report `go build ./...`, `go vet ./...`, and `go test ./...` passing during implementation.
-- The audit did not rerun quality gates; this artifact is the semantic reconciliation snapshot.