savepoint 1.0.1 → 1.0.2

package/.claude/settings.local.json

@@ -18,7 +18,10 @@
       "Bash(make build *)",
       "Bash(make test *)",
       "Bash(go get *)",
-      "Bash(go doc *)"
+      "Bash(go doc *)",
+      "Bash(make clean *)",
+      "Bash(make build-linux *)",
+      "Bash(./savepoint_test_bin --version)"
     ]
   }
 }

package/.savepoint/Design.md

@@ -1,7 +1,7 @@
 ---
 type: project-design
 status: active
-last_audited: E06-atari-noir-layout (2026-05-02)
+last_audited: v1.1/E02-cross-platform-compatibility (2026-05-02)
 ---
 
 # Savepoint — System Architecture
@@ -14,7 +14,7 @@ last_audited: E06-atari-noir-layout (2026-05-02)
 
 - **File-only.** No MCP server in v1. Agents read and edit Markdown + YAML files directly using their native file tools.
 - **Agent routing:** AGENTS.md → `.savepoint/router.md` → template prompts. See AGENTS.md Workflow section.
-- **Bundled Agent Skills:** Savepoint ships with custom skills (`draft-prd`, `system-design`, `create-plan`, `create-task`, `build-task`, `audit`) to enforce each phase of the state machine.
+- **Bundled Agent Skills:** Savepoint ships with custom skills (`savepoint-draft-prd`, `savepoint-system-design`, `savepoint-create-plan`, `savepoint-create-task`, `savepoint-build-task`, `savepoint-audit`) to enforce each phase of the state machine.
 - **Token-efficiency principle.**
   - Cold session bootstrap: ~5–7K tokens (one-time per conversation).
   - Per-task incremental: <2KB.
@@ -23,7 +23,7 @@ last_audited: E06-atari-noir-layout (2026-05-02)
 - **Go data-reader boundary:** established in epic `E02-data-readers` (2026-05-01). `internal/data` owns Savepoint file parsing and discovery for the Go implementation: task frontmatter models, markdown YAML extraction, router state parsing, config theme defaults, release/epic/task directory listing, and boundary error sentinels.
 - **Template assets** live under `templates/` with helpers in `src/templates/` (epic E04).
 - **Init command** (`savepoint init`) validates, scaffolds, prints prompt, clipboard, optional install (epic E05).
-- **Board command** (`savepoint board`) reads project state, renders the Atari-Noir TUI board, supports release/epic filtering, detail overlays, task status transitions with mtime-guarded writes, router priority markers, and fsnotify-based task auto-refresh (epic E06).
+- **Board command** (`savepoint board`) reads project state, renders the Atari-Noir TUI board, supports release/epic filtering, detail overlays, task status transitions with mtime-guarded writes, release/epic-scoped router priority markers, fsnotify-based task auto-refresh (epic E06), header Next Activity display, height-aware column/detail viewport scrolling, stable focused/unfocused column border geometry (v1.1 E01), and a focusable wide-screen epic sidebar with purple epic focus, epic detail overlays, and status glyphs loaded from epic detail frontmatter (v1.1 E04).
 - **Audit pipeline** (`savepoint audit`) resolves epic, skips, quality gates, snapshots, router transition, proposal review (epic E07).
 
 ## 2. Directory layout
@@ -40,14 +40,13 @@ last_audited: E06-atari-noir-layout (2026-05-02)
     ├── audit/
     │   └── {E##-epic}/
     │       ├── snapshot.md
-    │       └── proposals/
-    │           └── proposals.md
+    │       └── proposals.md
     └── releases/
-        └── v1/
-            ├── PRD.md              ← release-scoped PRD
+        └── {release}/              ← e.g. v1, v1.1
+            ├── {release}-PRD.md    ← release-scoped PRD
             └── epics/
                 └── E##-{epic-name}/
-                    ├── Design.md   ← epic delta
+                    ├── E##-Detail.md   ← epic delta
                     └── tasks/
                         └── T001-slug.md
 ```
@@ -59,7 +58,7 @@ AGENTS.md at root (uppercase, cross-vendor spec). Design.md in `.savepoint/` (wo
 | Level        | Definition                                                                             |
 | ------------ | -------------------------------------------------------------------------------------- |
 | **Release**  | The thing being built. One PRD per release. v1 = MVP.                                  |
-| **Epic**     | A major feature within a release. Has its own Design.md (delta from project Design).   |
+| **Epic**     | A major feature within a release. Has its own E##-Detail.md (delta from project Design). |
 | **Task**     | Independently buildable. Objective-led. **Requires implementation plan before build.** |
 | **Sub-task** | Inline checklist item — _evidence of the implementation plan_, not standalone work.    |
 
@@ -104,7 +103,7 @@ Three statuses, with explicit gates:
 0. Quality Gates  — CLI runs configured commands. Halts on failure if block_on_failure: true.
 1. Snapshot       — CLI writes file tree (gitignore-respecting) + changed-files list. NO code contents.
 2. Diff Brief     — State flips to audit_pending: {E##-epic}. Magic prompt printed to user.
-3. Reconcile      — Agent reads epic Design + snapshot + scoped code. Writes one proposal bundle to
+3. Reconcile      — Agent reads epic E##-Detail.md + snapshot + scoped code. Writes one proposal bundle to
                     .savepoint/audit/{E##-epic}/proposals.md.
 4. Review         — TUI shows side-by-side per-proposal diff. Approve / reject / edit each.
 5. Commit         — Approved proposals overwrite live files. Epic gets status: audited. Next epic unlocks.
@@ -115,7 +114,7 @@ Three statuses, with explicit gates:
 - **Skip allowed** via `savepoint audit --skip --reason "..."`. Logged to `.savepoint/audit-log.md`. Permanent `⚠ skipped` badge in TUI.
 - **Proposal bundles** use delta-shaped edits: `Insert After`, `Replace`, or `Delete` blocks anchored to exact text.
 - **Quality review** is a section inside the proposal bundle.
-- **Snapshot availability is an audit precondition.** The router should enter `audit-pending` only after `.savepoint/audit/{E##-epic}/snapshot.md` exists.
+- **Snapshot availability is an audit precondition.** The router should enter `audit-pending` only after `.savepoint/audit/{release}/{E##-epic}/snapshot.md` exists.
 
 Three layers:
 
@@ -131,11 +130,15 @@ Acknowledged terminal limits: fonts, scanlines, glows, letter-spacing, mouse-dri
 
 **Render fallbacks:** 256-color → 16-color hard-coded → `NO_COLOR=1` monochrome with glyphs → non-TTY plain table.
 
-**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task detail, static Atari-Noir header/footer, full-width dividers, uniform black TUI backgrounds, and navigation hints. Non-TTY output remains a plain table fallback.
+**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task/epic-detail views, static Atari-Noir header/footer, full-width dividers, uniform black TUI backgrounds, and navigation hints. The header can show a compact right-aligned Next Activity value from router state. Columns and detail overlays use height-aware viewport slicing with subtle above/more scroll indicators. Focused and unfocused columns preserve the same rounded-border geometry so focus changes do not shift content. On terminals at least 120 columns wide, the epic sidebar is focusable from the Planned column; it uses the purple epic accent for focused panel borders, focused epic labels, and epic detail overlays while task-column focus remains orange. Non-TTY output remains a plain table fallback.
 
 **Visual guardrail:** the terminal board intentionally uses one black background for Background, Surface, and Surface 2. Do not restore subtly different dark panel fills; depth should come from spacing, dividers, glyphs, and focused Atari Orange borders.
 
-**Board persistence and refresh:** task status transitions write canonical task frontmatter through `internal/data.WriteTaskStatus` with mtime conflict checks. The board watches `.savepoint/releases/` recursively with fsnotify and reloads task data after debounced file changes.
+**Terminal color policy:** the board must use a deterministic Lipgloss color profile and one canonical terminal black across truecolor, ANSI256, and ANSI fallbacks. In 256-color mode, Background, Surface, and Surface 2 must map to the same actual black value, not adjacent dark-gray values. Full-screen/root surfaces may paint that one black background for consistency; nested task cards, task text, glyphs, tags, metadata, and router-priority labels should remain foreground-only unless a component explicitly owns a filled visual region. This prevents padded text from creating gray bars in terminals such as PowerShell, Windows Terminal, VS Code terminal, and Warp.
+
+**Border policy:** focus must not change geometry or introduce terminal-specific broken border rendering. Use one consistent box-border family across columns, cards, and overlays. If rounded borders render as dash bars or broken segments in Warp, prefer the single-line border style already allowed by `.savepoint/visual-identity.md`; do not mix rounded and single-line borders as an ad-hoc per-component workaround.
+
+**Board persistence and refresh:** task status transitions write canonical task frontmatter through `internal/data.WriteTaskStatus` with mtime conflict checks. The board treats `Model.Root` as the `.savepoint` directory, watches `.savepoint/releases/` recursively with fsnotify, adds watches for newly-created release/epic/task directories, and reloads task plus release/epic index data plus epic status metadata after debounced file changes. Router priority markers match release + epic + task, not only the short `T###` value; completed cards render with the orange build glyph even if they previously matched router priority. Epic status glyphs are cached from each epic's `E##-Detail.md` frontmatter and shown in the wide epic sidebar only.
 
 **Implementation modules:** see AGENTS.md Codebase Map.
 
@@ -169,12 +172,14 @@ All failure modes are diagnosed by `savepoint doctor`. Doctor diagnoses and prop
 
 ## 12. Distribution & build
 
-> Audit note: the live repository is transitioning from the documented TypeScript/Node implementation to a Go module (`github.com/opencode/savepoint`). The architecture document still contains substantial TypeScript-era implementation detail and should be reconciled as Go epics are audited.
+> Audit note: the live repository is now a Go module (`github.com/opencode/savepoint`). Remaining TypeScript-era distribution details should be removed as Go epics are audited.
 
 - **License:** MIT.
-- **Install:** primary `npx savepoint init`, persistent `npm i -g savepoint` → `savepoint`.
-- **Runtime:** Node 20.10+ LTS, ESM-only, no native deps. macOS / Linux / Windows-Terminal.
-- **Repo:** single package. TypeScript strict. `tsup` build → `dist/`. Bin `dist/cli.js` shebanged.
+- **Runtime:** Go CLI binary. Source builds with `go build`; tests run with `go test ./...`.
+- **Local build:** `make build` delegates to `internal/buildtool`, builds `savepoint` or `savepoint.exe`, and injects `main.version` from `VERSION` or the latest git tag.
+- **Cross-platform builds:** `make build-all` cross-compiles linux-amd64, linux-arm64, darwin-amd64, and darwin-arm64 raw binaries into `dist/{platform}-{arch}/savepoint`.
+- **Artifacts:** `make dist` creates versioned `.tar.gz` archives in `dist/` for the Linux and Darwin targets using Go archive APIs, not shell `tar`.
+- **Smoke validation:** `make smoke-test` builds the local binary and runs `--version` as a headless exit-0 check.
 - **No telemetry.** Ever.
 
 ## 13. Testing

package/.savepoint/audit/v1/E01/proposals.md

@@ -0,0 +1,168 @@
+# Audit Proposals: v1.1 E01 TUI Optimisation
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+last_audited: E06-atari-noir-layout (2026-05-02)
+```
+
+## With
+
+```md
+last_audited: E01-tui-optimisation (2026-05-02)
+```
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+- **Board command** (`savepoint board`) reads project state, renders the Atari-Noir TUI board, supports release/epic filtering, detail overlays, task status transitions with mtime-guarded writes, router priority markers, and fsnotify-based task auto-refresh (epic E06).
+```
+
+## With
+
+```md
+- **Board command** (`savepoint board`) reads project state, renders the Atari-Noir TUI board, supports release/epic filtering, detail overlays, task status transitions with mtime-guarded writes, router priority markers, fsnotify-based task auto-refresh (epic E06), header Next Activity display, height-aware column/detail viewport scrolling, and stable focused/unfocused column border geometry (v1.1 E01).
+```
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+    │   └── {E##-epic}/
+    │       ├── snapshot.md
+    │       └── proposals/
+    │           └── proposals.md
+```
+
+## With
+
+```md
+    │   └── {E##-epic}/
+    │       ├── snapshot.md
+    │       └── proposals.md
+```
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+                └── E##-{epic-name}/
+                    ├── Design.md   ← epic delta
+                    └── tasks/
+                        └── T001-slug.md
+```
+
+## With
+
+```md
+                └── E##-{epic-name}/
+                    ├── E##-Detail.md   ← epic delta
+                    └── tasks/
+                        └── T001-slug.md
+```
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+| **Epic**     | A major feature within a release. Has its own Design.md (delta from project Design).   |
+```
+
+## With
+
+```md
+| **Epic**     | A major feature within a release. Has its own E##-Detail.md (delta from project Design). |
+```
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task detail, static Atari-Noir header/footer, full-width dividers, uniform black TUI backgrounds, and navigation hints. Non-TTY output remains a plain table fallback.
+```
+
+## With
+
+```md
+**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task detail, static Atari-Noir header/footer, full-width dividers, uniform black TUI backgrounds, and navigation hints. The header can show a compact right-aligned Next Activity value from router state. Columns and detail overlays use height-aware viewport slicing with subtle above/more scroll indicators. Focused and unfocused columns preserve the same rounded-border geometry so focus changes do not shift content. Non-TTY output remains a plain table fallback.
+```
+
+## Target File
+
+`AGENTS.md`
+
+## Replace
+
+```md
+| `internal/styles/`                   | Atari-Noir palette constants, terminal color fallbacks, shared TUI styles, semantic glyph/tag styles, and footer/header styling |
+```
+
+## With
+
+```md
+| `internal/styles/`                   | Atari-Noir palette constants, terminal color fallbacks, shared TUI styles, stable column border styles, scroll indicators, semantic glyph/tag styles, and footer/header styling |
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md`
+
+## Replace
+
+```md
+## Components and files
+```
+
+## With
+
+```md
+## 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
+```
+
+## Quality Review
+
+## Must Fix Before Close
+
+No remaining must-fix items.
+
+## Carry Forward
+
+- `make build && make test` could not be verified directly in this environment. The audit verified the underlying Go gates with `go build ./...` and `go test ./...`, both passing.
+- `internal/board/update.go` allows `DetailOffset` to grow beyond the rendered detail body and relies on render-time clamping. This is not currently user-visible breakage, but a future cleanup could clamp detail scrolling against actual visible body height to keep model state closer to rendered state.
+
+## Already Fixed
+
+- Stale unchecked implementation checklist items in `T001-next-activity-header.md`, `T004-update-instruction-files.md`, and `T005-update-cross-references.md` were reconciled after audit verification.
+- Column viewport slicing and subtle scroll indicators are covered by `internal/board/column_test.go`.
+- Detail overlay scrolling is covered by `internal/board/detail_test.go`.
+- Height-aware layout is covered by `internal/board/layout_test.go`.
+- Header Next Activity rendering and truncation are covered by `internal/board/view_test.go`.
+- Focused and unfocused column border dimensions are covered by `TestRenderColumn_focusStatesUseStableBorderDimensions`.

package/.savepoint/audit/v1/E01/snapshot.md

@@ -0,0 +1,78 @@
+# Audit Snapshot: v1.1 E01 TUI Optimisation
+
+Manual snapshot created because the audit CLI snapshot was missing and the router permits one manual snapshot when the CLI is unavailable.
+
+## Scope
+
+- Release: `v1.1`
+- Epic: `E01-tui-optimisation`
+- Router state at audit start: `audit-pending`
+- Next action: `Audit v1.1 E01 TUI optimisation.`
+
+## Epic Files
+
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T001-next-activity-header.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T002-rename-epic-design-files.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T003-rename-release-prd.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T004-update-instruction-files.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T005-update-cross-references.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T006-column-and-detail-scrolling.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T007-column-focus-border-stability.md`
+
+## Changed Source And Test Files Reviewed
+
+- `internal/board/layout.go`
+- `internal/board/view.go`
+- `internal/board/column.go`
+- `internal/board/detail.go`
+- `internal/board/model.go`
+- `internal/board/update.go`
+- `internal/board/watch.go`
+- `internal/styles/styles.go`
+- `internal/board/column_test.go`
+- `internal/board/detail_test.go`
+- `internal/board/layout_test.go`
+- `internal/board/view_test.go`
+
+## Documentation And Workflow Files In Scope
+
+- `.savepoint/Design.md`
+- `AGENTS.md`
+- `.savepoint/router.md`
+- `agent-skills/savepoint-audit/SKILL.md`
+- `agent-skills/savepoint-build-task/SKILL.md`
+- `agent-skills/savepoint-create-plan/SKILL.md`
+- `agent-skills/savepoint-create-task/SKILL.md`
+- `agent-skills/savepoint-system-design/SKILL.md`
+- `templates/project/AGENTS.md`
+- `templates/project/.savepoint/router.md`
+- `templates/prompts/task-breakdown.prompt.md`
+- `templates/prompts/task-building.prompt.md`
+- `templates/prompts/task-planning.prompt.md`
+
+## Implemented Delta Observed
+
+- Board header can show a right-aligned `Next Activity:` label from parsed router state.
+- Release PRD naming moved from `PRD.md` to `{release}-PRD.md`.
+- Epic design naming moved from per-epic `Design.md` to `E##-Detail.md`.
+- TUI columns use height-aware virtual viewport slicing with above/more scroll indicators.
+- Detail overlay accepts terminal-height-derived caps and scroll offsets.
+- Model state now tracks per-column offsets and detail offsets.
+- Column navigation and page keys keep the focused task visible.
+- Unfocused columns now use a rounded-border style matching focused column dimensions.
+- `internal/styles/styles.go` added `HeaderRight`, `ScrollIndicator`, and `ColumnUnfocused`.
+
+## Drift Notes Found
+
+- `T007-column-focus-border-stability.md`: `internal/styles/styles.go` added exported `ColumnUnfocused` style, not yet in Codebase Map.
+
+## Verification Performed During Audit
+
+- `go build ./...`: passed.
+- `go test ./...`: passed.
+
+## Audit Caveats
+
+- The required `make build && make test` gate was not rerun because this environment has used direct Go equivalents for recent task closeout when `make` is unavailable.
+- Must-fix follow-up applied: `T001-next-activity-header.md`, `T004-update-instruction-files.md`, and `T005-update-cross-references.md` no longer contain unchecked implementation checklist items.

package/.savepoint/audit/{E01-go-setup → v1/E01-go-setup}/proposals.md

@@ -96,16 +96,16 @@ make run             # shortcut: go run main.go
 
 | Module                    | Epic                                                                    | Purpose                                                         |
 | ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------- |
-| `go.mod`                  | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/Design.md)     | Go module definition for the Savepoint CLI rewrite              |
-| `go.sum`                  | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/Design.md)     | Dependency checksums for Bubble Tea, Lip Gloss, YAML, and deps  |
-| `main.go`                 | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/Design.md)     | Process entrypoint; delegates Bubble Tea startup to board.Run   |
-| `Makefile`                | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/Design.md)     | Local build, test, run, and clean shortcuts                     |
-| `internal/board/board.go` | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/Design.md)     | Minimal Bubble Tea model, quit handling, and program lifecycle  |
+| `go.mod`                  | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Go module definition for the Savepoint CLI rewrite              |
+| `go.sum`                  | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Dependency checksums for Bubble Tea, Lip Gloss, YAML, and deps  |
+| `main.go`                 | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Process entrypoint; delegates Bubble Tea startup to board.Run   |
+| `Makefile`                | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Local build, test, run, and clean shortcuts                     |
+| `internal/board/board.go` | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Minimal Bubble Tea model, quit handling, and program lifecycle  |
 ```
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E01-go-setup/Design.md`
+`.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
 
 ## Replace
 
@@ -121,7 +121,7 @@ status: audited
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E01-go-setup/Design.md`
+`.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
 
 ## Insert After
 

package/.savepoint/audit/{E01-go-setup → v1/E01-go-setup}/snapshot.md

@@ -22,7 +22,7 @@ Manual snapshot created because the router was already on E02 and the audit CLI
 ## Files Read
 
 - `.savepoint/router.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/Design.md`
+- `.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T002-entrypoint.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T003-directory-structure.md`
@@ -44,7 +44,7 @@ Manual snapshot created because the router was already on E02 and the audit CLI
 - `main.go`
 - `internal/board/board.go`
 - `Makefile`
-- `.savepoint/releases/v1/epics/E01-go-setup/Design.md`
+- `.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T002-entrypoint.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T003-directory-structure.md`

package/.savepoint/audit/{E01-scaffolding → v1/E01-scaffolding}/proposals/AGENTS.md

@@ -10,8 +10,8 @@ When you are about to write code, you must first read, in order:
 
 1. `.savepoint/PRD.md` — what we are building and why
 2. `.savepoint/Design.md` — how the system is architected
-3. The release PRD: `.savepoint/releases/v1/PRD.md`
-4. The epic Design: `.savepoint/releases/v1/epics/{epic}/Design.md`
+3. The release PRD: `.savepoint/releases/v1/v1-PRD.md`
+4. The epic E##-Detail.md: `.savepoint/releases/v1/epics/{epic}/E##-Detail.md`
 5. The active task file: `.savepoint/releases/v1/epics/{epic}/tasks/{NNN}-*.md`
 
 **Conditional read:** if the active task touches TUI rendering, theme, or visual design, also read `.savepoint/visual-identity.md`. Otherwise skip it — it's ~1.8K tokens you don't need.
@@ -49,9 +49,9 @@ npm test             # vitest smoke suite
 
 | Module               | Epic                                                                      | Purpose                                              |
 | -------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- |
-| `src/cli.ts`         | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/Design.md) | CLI entrypoint; placeholder help/version output      |
-| `src/version.ts`     | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/Design.md) | Single source for package version string             |
-| `test/smoke.test.ts` | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/Design.md) | Baseline Vitest smoke test proving test runner works |
+| `src/cli.ts`         | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/E01-Detail.md) | CLI entrypoint; placeholder help/version output      |
+| `src/version.ts`     | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/E01-Detail.md) | Single source for package version string             |
+| `test/smoke.test.ts` | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/E01-Detail.md) | Baseline Vitest smoke test proving test runner works |
 
 <!-- END AUTO-GENERATED -->
 

package/.savepoint/audit/{E02-data-readers → v1/E02-data-readers}/proposals.md

@@ -42,35 +42,35 @@
 ## Replace
 
 ```md
-| `src/domain/config.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Config defaults and typed project config model                                                       |
-| `src/domain/epic.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Epic Design frontmatter model and validation                                                         |
-| `src/domain/ids.ts`                  | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Release, epic, and task ID parsing and formatting                                                    |
-| `src/domain/release.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Release PRD frontmatter model and validation                                                         |
-| `src/domain/router.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Router state values and validation                                                                   |
-| `src/domain/status.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Task status values and transition validation                                                         |
-| `src/domain/task.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Task frontmatter/document model and validation                                                       |
-| `src/fs/markdown.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Markdown/frontmatter reader with path-aware boundary errors                                          |
-| `src/fs/project.ts`                  | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Project root discovery and scoped `.savepoint` path helpers                                          |
-| `src/readers/config.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only `config.yml` reader with defaults                                                          |
-| `src/readers/epic.ts`                | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only epic Design reader                                                                         |
-| `src/readers/release.ts`             | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only release PRD reader                                                                         |
-| `src/readers/router.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only router Current state reader                                                                |
-| `src/readers/tasks.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Epic task-set reader with graph validation                                                           |
+| `src/domain/config.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Config defaults and typed project config model                                                       |
+| `src/domain/epic.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Epic Design frontmatter model and validation                                                         |
+| `src/domain/ids.ts`                  | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Release, epic, and task ID parsing and formatting                                                    |
+| `src/domain/release.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Release PRD frontmatter model and validation                                                         |
+| `src/domain/router.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Router state values and validation                                                                   |
+| `src/domain/status.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Task status values and transition validation                                                         |
+| `src/domain/task.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Task frontmatter/document model and validation                                                       |
+| `src/fs/markdown.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Markdown/frontmatter reader with path-aware boundary errors                                          |
+| `src/fs/project.ts`                  | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Project root discovery and scoped `.savepoint` path helpers                                          |
+| `src/readers/config.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Read-only `config.yml` reader with defaults                                                          |
+| `src/readers/epic.ts`                | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Read-only epic Design reader                                                                         |
+| `src/readers/release.ts`             | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Read-only release PRD reader                                                                         |
+| `src/readers/router.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Read-only router Current state reader                                                                |
+| `src/readers/tasks.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/E02-Detail.md)                       | Epic task-set reader with graph validation                                                           |
 ```
 
 ## With
 
 ```md
-| `internal/data/task.go`              | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Task, column, progress stage, dependency, and metadata structs for Go data readers                   |
-| `internal/data/parser.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Markdown YAML frontmatter extraction and task frontmatter parsing                                    |
-| `internal/data/router.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Router current-state YAML block extraction and parsing                                               |
-| `internal/data/config.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Savepoint config/theme parsing with default theme fallback                                           |
-| `internal/data/discover.go`          | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | `.savepoint` root discovery and release, epic, and task directory listing                            |
+| `internal/data/task.go`              | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Task, column, progress stage, dependency, and metadata structs for Go data readers                   |
+| `internal/data/parser.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Markdown YAML frontmatter extraction and task frontmatter parsing                                    |
+| `internal/data/router.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Router current-state YAML block extraction and parsing                                               |
+| `internal/data/config.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Savepoint config/theme parsing with default theme fallback                                           |
+| `internal/data/discover.go`          | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | `.savepoint` root discovery and release, epic, and task directory listing                            |
 ```
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E02-data-readers/Design.md`
+`.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md`
 
 ## Insert After
 

package/.savepoint/audit/{E02-data-readers → v1/E02-data-readers}/snapshot.md

@@ -21,7 +21,7 @@ next_action: "Audit E02-data-readers: all 5 tasks done. Start fresh session for
 
 ## Epic Scope
 
-- `.savepoint/releases/v1/epics/E02-data-readers/Design.md`
+- `.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md`
 - `.savepoint/releases/v1/epics/E02-data-readers/tasks/T001-task-struct.md`
 - `.savepoint/releases/v1/epics/E02-data-readers/tasks/T002-frontmatter-parser.md`
 - `.savepoint/releases/v1/epics/E02-data-readers/tasks/T003-router-reader.md`

package/.savepoint/audit/{E03-board-tui-core → v1/E03-board-tui-core}/proposals.md

@@ -49,25 +49,25 @@ Acknowledged terminal limits: fonts, scanlines, glows, letter-spacing, mouse-dri
 ## Insert After
 
 ```md
-| `internal/data/errors.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Shared data-reader boundary error sentinels                                                          |
+| `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/board.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Bubble Tea board entrypoint and program launch                                                        |
-| `internal/board/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Board model state, constructor, task grouping, and initialization                                     |
-| `internal/board/update.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Board key handling, quit behavior, column focus navigation, and terminal resize updates               |
-| `internal/board/view.go`             | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Lip Gloss view composition for header, responsive board columns, epic panel, tasks, and status bar    |
-| `internal/board/layout.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Responsive board breakpoint and column width calculations                                            |
-| `internal/styles/palette.go`         | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Atari-Noir terminal color constants and 256-color/16-color fallbacks                                 |
-| `internal/styles/styles.go`          | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Reusable Lip Gloss styles for board chrome, focused state, task rows, status, tags, and epic panel   |
-| `internal/board/*_test.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Unit tests for board model, update loop, layout breakpoints, and rendered output                     |
+| `internal/board/board.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Bubble Tea board entrypoint and program launch                                                        |
+| `internal/board/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Board model state, constructor, task grouping, and initialization                                     |
+| `internal/board/update.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Board key handling, quit behavior, column focus navigation, and terminal resize updates               |
+| `internal/board/view.go`             | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Lip Gloss view composition for header, responsive board columns, epic panel, tasks, and status bar    |
+| `internal/board/layout.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Responsive board breakpoint and column width calculations                                            |
+| `internal/styles/palette.go`         | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Atari-Noir terminal color constants and 256-color/16-color fallbacks                                 |
+| `internal/styles/styles.go`          | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Reusable Lip Gloss styles for board chrome, focused state, task rows, status, tags, and epic panel   |
+| `internal/board/*_test.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md)               | Unit tests for board model, update loop, layout breakpoints, and rendered output                     |
 ```
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E03-board-tui-core/Design.md`
+`.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md`
 
 ## Replace
 
@@ -85,7 +85,7 @@ status: implemented
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E03-board-tui-core/Design.md`
+`.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md`
 
 ## Insert After
 

package/.savepoint/audit/{E03-board-tui-core → v1/E03-board-tui-core}/snapshot.md

@@ -22,7 +22,7 @@ next_action: "E03-board-tui-core complete. Start a new agent session for the aud
 
 ## Epic Scope
 
-- `.savepoint/releases/v1/epics/E03-board-tui-core/Design.md`
+- `.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md`
 - `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T001-model.md`
 - `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T002-update-loop.md`
 - `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T003-view.md`