savepoint 1.0.1 → 1.0.2

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

@@ -31,29 +31,29 @@
 ## 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/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.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/Design.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/Design.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/Design.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/Design.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/Design.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/Design.md)            | Wide epic sidebar and narrow epic selector dropdown renderers                                         |
-| `internal/board/detail.go`           | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.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/Design.md)            | Release selector dropdown renderer and current-release cursor lookup                                  |
-| `internal/board/help.go`             | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Keyboard shortcut help overlay renderer                                                               |
-| `internal/styles/*.go`               | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.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/Design.md) / [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md) | Go board model, layout, update, view, component, selector, detail, and help tests                     |
+| `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/Design.md`
+`.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`
 
 ## Insert After
 

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

@@ -16,7 +16,7 @@ next_action: "Epic E04-board-components complete. Start a new agent session for
 
 ## Epic Scope
 
-Epic design: `.savepoint/releases/v1/epics/E04-board-components/Design.md`
+Epic design: `.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`
 
 Tasks:
 

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

@@ -64,7 +64,7 @@ test/
 | `.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/Design.md` | Epic Design needs implemented-as notes. |
+| `.savepoint/releases/v1/epics/E05-init-command/E05-Detail.md` | Epic Design needs implemented-as notes. |
 
 ## New files introduced by E05
 

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

@@ -23,19 +23,19 @@
 ## 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/data/write.go`                      | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/Design.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/Design.md)         | Board phase advance/retreat lifecycle and dependency gate checks                                     |
+| `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/Design.md`
+`.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md`
 
 ## Insert After
 

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

@@ -14,7 +14,7 @@ next_action: "Epic E05-phase-transitions is complete. Start a new agent session
 
 ## Epic Scope
 
-- `.savepoint/releases/v1/epics/E05-phase-transitions/Design.md`
+- `.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`

package/.savepoint/audit/{E06-atari-noir-layout → v1/E06-atari-noir-layout}/proposals.md

@@ -60,7 +60,7 @@
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+`.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
 
 ## Replace
 
@@ -76,7 +76,7 @@
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+`.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
 
 ## Insert After
 

package/.savepoint/audit/{E07-audit-pipeline → v1/E07-audit-pipeline}/snapshot.md

@@ -32,18 +32,18 @@ next_action: Run savepoint audit for E07-audit-pipeline.
 | M      | .claude/settings.local.json                                                            |
 | M      | .savepoint/Design.md                                                                   |
 | M      | .savepoint/metrics/context-bench.md                                                    |
-| M      | .savepoint/releases/v1/PRD.md                                                          |
-| M      | .savepoint/releases/v1/epics/E05-init-command/Design.md                                |
+| M      | .savepoint/releases/v1/v1-PRD.md                                                          |
+| M      | .savepoint/releases/v1/epics/E05-init-command/E05-Detail.md                                |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T001-init-cli-contract.md          |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T002-target-validation.md          |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T003-scaffold-writer.md            |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T004-magic-prompt-and-clipboard.md |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T005-dev-deps-install-option.md    |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T006-init-command-integration.md   |
-| M      | .savepoint/releases/v1/epics/E06-tui-board/Design.md                                   |
-| D      | .savepoint/releases/v1/epics/E08-doctor-command/Design.md                              |
-| D      | .savepoint/releases/v1/epics/E09-docs-and-packaging/Design.md                          |
-| D      | .savepoint/releases/v1/epics/E10-release-validation/Design.md                          |
+| M      | .savepoint/releases/v1/epics/E06-tui-board/E06-Detail.md                                   |
+| D      | .savepoint/releases/v1/epics/E08-doctor-command/E08-Detail.md                              |
+| D      | .savepoint/releases/v1/epics/E09-docs-and-packaging/E09-Detail.md                          |
+| D      | .savepoint/releases/v1/epics/E10-release-validation/E10-Detail.md                          |
 | M      | .savepoint/router.md                                                                   |
 | M      | .savepoint/visual-identity.md                                                          |
 | M      | AGENTS.md                                                                              |

package/.savepoint/audit/v1.1/E02-cross-platform-compatibility/proposals.md

@@ -0,0 +1,114 @@
+# Audit Proposals: v1.1 E02 Cross-Platform Compatibility
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+## 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.
+
+- **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.
+- **No telemetry.** Ever.
+```
+
+## With
+
+```md
+## 12. Distribution & build
+
+> 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.
+- **Runtime:** Go CLI binary. Source builds with `go build`; tests run with `go test ./...`.
+- **Local build:** `make build` builds `savepoint` and injects `main.version` from `VERSION`.
+- **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.
+- **Smoke validation:** `make smoke-test` builds the local binary and runs `./savepoint --version` as a headless exit-0 check.
+- **No telemetry.** Ever.
+```
+
+## Target File
+
+`AGENTS.md`
+
+## Replace
+
+```md
+| `main.go`                            | CLI Entrypoint and root command wiring                                                               |
+```
+
+## With
+
+```md
+| `main.go`                            | CLI entrypoint, root command wiring, and `--version` handling via build-time version injection        |
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
+
+## Insert After
+
+```md
+## Architectural notes
+
+- All Go code uses `path/filepath` — no syscalls are platform-specific
+- Bubble Tea handles terminal differences across platforms
+- No Go build tags or platform-specific files needed
+- This is purely a build-tooling and release-workflow epic
+```
+
+## With
+
+```md
+## Implemented as
+
+- `Makefile` now has `build-linux`, `build-darwin`, `build-all`, `dist`, and `smoke-test` targets.
+- `VERSION` defaults from `git describe --tags --abbrev=0` with a `v0.0.0` fallback and is injected into the binary with `-ldflags "-X main.version=$(VERSION)"`.
+- `main.go` handles `--version` before launching the TUI, which gives smoke tests a non-interactive success path.
+- `dist/` remains ignored by git and contains both raw cross-compiled binaries and versioned `.tar.gz` archives for Linux and Darwin builds.
+- Windows zip packaging was not implemented in this epic; the final implementation covers the Linux and Darwin targets named in the epic's build-all definition of done.
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
+
+## Replace
+
+```md
+- [x] Makefile replaced with Go-native commands (no `rm`, `cp`, `mkdir`)
+```
+
+## With
+
+```md
+- [ ] Makefile replaced with Go-native commands (no `rm`, `cp`, `mkdir`)
+```
+
+## Quality Review
+
+## Must Fix Before Close
+
+- `Makefile`: `clean` still runs `rm -rf dist/`, which violates T001 acceptance criteria: "`make clean` removes the binary without using `rm -f` or other Unix-only commands" and "No shell commands in Makefile are platform-dependent."
+- `Makefile`: `build-linux` and `build-darwin` still use `mkdir -p` and inline `GOOS=... GOARCH=...` environment assignment. That is fine for Linux, macOS, Git Bash, and WSL, but it is not a shell-agnostic Makefile implementation.
+- `Makefile`: `dist` relies on `tar`, so packaging is not yet toolchain-native or Windows-shell portable.
+- `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T004-smoke-tests-and-artifacts.md`: the task says `go test ./...` was not run even though the task completion protocol requires the full quality-gate suite before `status: done`.
+
+## Carry Forward
+
+- Windows `.zip` artifacts were deferred in T004. Keep that as a known scope gap unless the project narrows E02 explicitly to Linux and Darwin distribution.
+- Consider moving cross-platform build and archive logic into a tiny Go helper if the project wants true shell portability while keeping `make` as the human entrypoint.
+
+## Already Fixed
+
+- `main.go` has a headless `--version` path, so smoke testing no longer needs to start the TUI.
+- Linux and Darwin raw binary targets exist for amd64 and arm64.
+- `AGENTS.md` already documents `build-all`, `dist`, and `smoke-test`.

package/.savepoint/audit/v1.1/E02-cross-platform-compatibility/snapshot.md

@@ -0,0 +1,41 @@
+# Audit Snapshot: v1.1 E02 Cross-Platform Compatibility
+
+Manual snapshot created because the audit CLI snapshot was missing while the router is already in `audit-pending`.
+
+## Epic
+
+- Release: `v1.1`
+- Epic: `E02-cross-platform-compatibility`
+- Source: `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
+- Router state: `audit-pending`
+
+## Completed Tasks
+
+- `E02-cross-platform-compatibility/T001-fix-makefile`
+- `E02-cross-platform-compatibility/T002-linux-build-target`
+- `E02-cross-platform-compatibility/T003-macos-build-target`
+- `E02-cross-platform-compatibility/T004-smoke-tests-and-artifacts`
+
+## Changed Files Listed By Task Logs
+
+- `Makefile`
+- `AGENTS.md`
+- `.gitignore`
+- `main.go`
+- `internal/board/board.go`
+
+## Drift Notes Found
+
+- `main.go`: added `version` package-level var and `--version` arg check. Not yet in Codebase Map.
+
+## Verification Reported By Tasks
+
+- T001: `go build -o savepoint main.go` PASS, `go test ./...` PASS, `go clean` PASS
+- T002: `go build` PASS, `go test ./...` PASS; Linux binaries reported as ELF for amd64 and arm64
+- T003: `go build` PASS, `go test ./...` PASS; Darwin binaries reported as Mach-O for amd64 and arm64
+- T004: `go build` PASS, `./savepoint --version` PASS; `go test ./...` not run
+
+## Audit Notes
+
+- The final `Makefile` includes cross-compile and packaging targets, but still contains Unix shell forms in `clean`, `build-linux`, `build-darwin`, `dist`, and `VERSION`.
+- `T004` explicitly deferred Windows zip artifacts; the implemented release artifacts cover Linux and Darwin only.

package/.savepoint/audit/v1.1/E04-epic-navigation/proposals.md

@@ -0,0 +1,156 @@
+# Audit Proposals: v1.1 E04 Epic Navigation
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```yaml
+last_audited: E01-tui-optimisation (2026-05-02)
+```
+
+## With
+
+```yaml
+last_audited: E04-epic-navigation (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, release/epic-scoped 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).
+```
+
+## 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, 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).
+```
+
+## 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. 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.
+```
+
+## 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/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.
+```
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+**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 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.
+```
+
+## With
+
+```md
+**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.
+```
+
+## Target File
+
+`AGENTS.md`
+
+## Replace
+
+```md
+| `internal/board/`                    | TUI board models, layout, rendering, overlays, task transitions, router priority markers, and fsnotify refresh |
+| `internal/data/`                     | Task/router/config models, frontmatter parsing, checklist state parsing, mtime-guarded writes, discovery, and generic file readers |
+| `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 |
+```
+
+## With
+
+```md
+| `internal/board/`                    | TUI board models, layout, rendering, overlays, focusable epic sidebar navigation, epic detail overlays, epic status glyph loading, task transitions, router priority markers, and fsnotify refresh |
+| `internal/data/`                     | Task/router/config models, frontmatter parsing, checklist state parsing, mtime-guarded writes, discovery, and generic file readers |
+| `internal/styles/`                   | Atari-Noir palette constants, terminal color fallbacks, shared TUI styles, stable column border styles, scroll indicators, purple epic navigation/detail styles, semantic glyph/tag styles, and footer/header styling |
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E04-epic-navigation/E04-Detail.md`
+
+## Replace
+
+```yaml
+status: planned
+```
+
+## With
+
+```yaml
+status: audited
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E04-epic-navigation/E04-Detail.md`
+
+## Replace
+
+```md
+## Architectural notes
+
+- `EpicPanelFocus bool` is a lightweight flag replacing the need for a new column type
+- The epic detail overlay content is read from `E##-Detail.md` on the filesystem when Enter is pressed (not pre-loaded)
+- Detail file path is deterministic: `{root}/releases/{release}/epics/{epic-slug}/{shortID}-Detail.md`
+- If the detail file is missing, the overlay shows a "(no detail available)" message
+- Column selection, task selection, and existing overlay behavior are completely unchanged
+```
+
+## With
+
+```md
+## Architectural notes
+
+- `EpicPanelFocus bool` is a lightweight flag replacing the need for a new column type
+- The epic detail overlay content is read from `E##-Detail.md` on the filesystem when Enter is pressed (not pre-loaded)
+- Detail file path is deterministic: `{root}/releases/{release}/epics/{epic-slug}/{shortID}-Detail.md`
+- If the detail file is missing, the overlay shows a "(no detail available)" message
+- Column selection, task selection, and existing overlay behavior are completely unchanged
+
+## Implemented as
+
+- `internal/board/model.go` adds `EpicPanelFocus`, `EpicPanelCursor`, `EpicDetailOffset`, `EpicDetailContent`, and `EpicStatus` model state.
+- `internal/board/update.go` handles global keys before epic-panel routing, focuses the panel from the Planned column on wide layouts, changes the selected epic during panel cursor movement, writes router release/epic state, and opens the epic detail overlay on Enter.
+- `internal/board/epic_panel.go` renders the purple-accented epic sidebar focus state, purple epic detail overlay, markdown detail body, and side-panel-only status glyph prefixes.
+- `internal/board/board.go` loads epic status frontmatter during board-data loading; `internal/board/watch.go` carries that status map through reloads.
+- Epic navigation deliberately uses `VibePurple` (`#B1A1DF`) for focused epic panel borders, focused epic labels, epic detail overlays, and epic/audit accents, while task-column focus remains Atari Orange.
+- Implementation deviation: T001 originally said Enter in epic-panel focus selected the focused epic. The final behavior from T002 is that up/down selects and filters immediately, while Enter opens the epic detail overlay.
+```
+
+## Quality Review
+
+## Must Fix Before Close
+
+None.
+
+## Carry Forward
+
+- Accepted design decision: `RenderEpicDetail` intentionally omits the components/files table from the overlay for readability. The epic detail overlay shows the narrative sections and keeps implementation file mapping in the source `E##-Detail.md`.
+- `readEpicDetailFile` falls back to `E##-Design.md` and then any `E##-*.md`, which is more permissive than the epic design's deterministic path. The fallback is harmless and user-friendly, but it should be documented if kept as product behavior.
+- `epicPanelPageSize()` was added for eventual PgUp/PgDown support but is not currently used. This is minor dead code carried from the task plan and can be removed or wired in during a future sidebar paging task.
+
+## Already Fixed
+
+- Global `q`, `e`, `r`, and `?` keys are processed before epic-panel-specific key handling, so panel focus does not trap quit, release, epic dropdown, or help commands.
+- Focused epic sidebar rendering uses purple focused border/title/item styles, making the colour-scheme shift from task orange to epic purple visible in the TUI.
+- Focused board tests, `go build -o savepoint main.go`, and `go test ./...` pass.

package/.savepoint/audit/v1.1/E04-epic-navigation/snapshot.md

@@ -0,0 +1,48 @@
+---
+type: audit-snapshot
+release: v1.1
+epic: E04-epic-navigation
+created: 2026-05-02
+source: manual-router-snapshot
+---
+
+# Audit Snapshot: v1.1 E04 Epic Navigation
+
+The audit CLI snapshot was missing when the router entered `audit-pending`. Per router guidance, this manual snapshot is scoped to the known epic and task records only.
+
+## Epic Scope
+
+- `.savepoint/releases/v1.1/epics/E04-epic-navigation/E04-Detail.md`
+- `.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T001-sidebar-focusable-navigation.md`
+- `.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T002-epic-detail-overlay.md`
+- `.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T003-epic-status-glyphs.md`
+
+## Changed Files Recorded by Tasks
+
+- `internal/board/model.go`
+- `internal/board/update.go`
+- `internal/board/view.go`
+- `internal/board/epic_panel.go`
+- `internal/board/board.go`
+- `internal/board/watch.go`
+- `internal/board/epic_panel_test.go`
+- `internal/board/update_test.go`
+- `internal/board/board_test.go`
+- `internal/styles/styles.go`
+- `internal/styles/palette.go`
+- `.savepoint/config.yml`
+
+## Implemented Delta
+
+- Wide-board epic sidebar is focusable from the Planned column and returns focus to the board with right arrow.
+- Epic-panel up/down navigation selects the focused epic immediately, filters visible tasks, and writes release/epic router state.
+- Enter from epic-panel focus opens an `EPIC DETAIL` overlay backed by the selected epic detail markdown file.
+- Epic detail overlay supports esc/q close, line scrolling, and page scrolling.
+- Epic status glyphs are loaded from each epic detail file's `status` frontmatter at board-data load time and propagated through reloads.
+- Epic panel focus, epic item focus, epic detail overlay, and epic/audit accents now use `VibePurple` (`#B1A1DF`) rather than the orange task-column focus color.
+
+## Verification Evidence
+
+- `go test ./internal/board` passed.
+- `go build -o savepoint main.go` passed.
+- `go test ./...` passed.

package/.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md

@@ -27,7 +27,7 @@ depends_on: []
 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`
 - `go.mod`
 - `go.sum`

package/.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T005-layout.md

@@ -25,7 +25,7 @@ depends_on: [E03-board-tui-core/T004-styles]
 
 ## Context Log
 
-Files read: internal/board/model.go, view.go, update.go, board.go, view_test.go, update_test.go, model_test.go, internal/styles/styles.go, go.mod, .savepoint/releases/v1/epics/E03-board-tui-core/Design.md
+Files read: internal/board/model.go, view.go, update.go, board.go, view_test.go, update_test.go, model_test.go, internal/styles/styles.go, go.mod, .savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.md
 
 Estimated input tokens: ~6 000
 

package/.savepoint/releases/v1/epics/E04-board-components/tasks/T002-card.md

@@ -26,7 +26,7 @@ depends_on: [E04-board-components/T001-column]
 
 ## Context Log
 
-Files read: `internal/board/column.go`, `internal/board/column_test.go`, `internal/styles/styles.go`, `internal/styles/palette.go`, `internal/data/task.go`, `.savepoint/releases/v1/epics/E04-board-components/Design.md`, `AGENTS.md`, `.savepoint/router.md`
+Files read: `internal/board/column.go`, `internal/board/column_test.go`, `internal/styles/styles.go`, `internal/styles/palette.go`, `internal/data/task.go`, `.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`, `AGENTS.md`, `.savepoint/router.md`
 
 Estimated input tokens: ~4 000
 

package/.savepoint/releases/v1/epics/E04-board-components/tasks/T006-help-overlay.md

@@ -24,7 +24,7 @@ depends_on: [E04-board-components/T005-release-dropdown]
 
 ## Context Log
 
-Files read: `.savepoint/router.md`, `.savepoint/releases/v1/epics/E04-board-components/Design.md`, this task file, `agent-skills/ink-tui-design/SKILL.md`, `.savepoint/visual-identity.md`, `internal/board/model.go`, `internal/board/update.go`, `internal/board/view.go`, `internal/board/detail.go`, `internal/board/epic_panel.go`, `internal/board/release.go`, `internal/board/update_test.go`, `internal/board/view_test.go`, `internal/board/detail_test.go`, `internal/board/release_test.go`, `internal/styles/styles.go`, `go.mod`, `Makefile`
+Files read: `.savepoint/router.md`, `.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`, this task file, `agent-skills/ink-tui-design/SKILL.md`, `.savepoint/visual-identity.md`, `internal/board/model.go`, `internal/board/update.go`, `internal/board/view.go`, `internal/board/detail.go`, `internal/board/epic_panel.go`, `internal/board/release.go`, `internal/board/update_test.go`, `internal/board/view_test.go`, `internal/board/detail_test.go`, `internal/board/release_test.go`, `internal/styles/styles.go`, `go.mod`, `Makefile`
 Estimated input tokens: ~8500
 Notes: Added help overlay renderer, `?` key handling, centered overlay rendering over dimmed board, and focused render/update/view tests. Focused test `go test ./internal/board/...` initially failed in the sandbox because Go could not access the external build cache; rerun with approved cache access passed. Quality gates: `go build ./...` pass, `go vet ./...` pass, `go test ./...` pass.
 

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/{Design.md → E06-Detail.md}

@@ -46,11 +46,11 @@ Update the existing TUI to align with the **Atari-Noir SavePoint design system**
 - `internal/styles/palette.go` defines the Atari-Noir hex palette plus ANSI256/ANSI16 fallbacks.
 - `internal/styles/styles.go` centralizes header, divider, footer, column, card, detail, glyph, and semantic tag styles.
 - `internal/board/view.go` renders the static SavePoint header, explicit full-width top/bottom dividers, the static `PLAN │ BUILD │ AUDIT` footer, subdued navigation hints, and overlay composition.
-- `internal/board/card.go` wraps long task titles instead of truncating them and uses a green `▣` marker for the router-priority task.
-- `internal/board/detail.go` adds spacing below Acceptance Criteria and Implementation Plan headings, renders checklist state with `☑`/`□`, and labels the router-priority task.
+- `internal/board/card.go` wraps long task titles instead of truncating them, uses a green `▣` marker only for the release/epic/task-scoped router-priority task, and keeps all done cards on the orange build glyph.
+- `internal/board/detail.go` adds spacing below Acceptance Criteria and Implementation Plan headings, renders checklist state with `☑`/`□`, and labels only the release/epic/task-scoped router-priority task.
 - `internal/data/task.go` and `internal/data/parser.go` represent Implementation Plan items as `CheckItem{Text, Done}` and parse `- [x]`, `- [ ]`, and legacy `- ` items.
 - `internal/data/write.go` persists task status and phase changes with mtime conflict protection.
-- `internal/board/watch.go` adds fsnotify-based recursive release directory watching, 100ms debounce, and reload messages used by `internal/board/update.go`.
+- `internal/board/watch.go` adds fsnotify-based recursive release directory watching from the `.savepoint/releases/` root, dynamically adds watches for newly-created subdirectories, applies a 100ms debounce, and sends reload messages used by `internal/board/update.go`.
 
 ## Implementation Deltas
 
@@ -58,3 +58,5 @@ Update the existing TUI to align with the **Atari-Noir SavePoint design system**
 - Audit closeout removed unnecessary borders from unfocused header, board, column, card, and epic-panel surfaces while preserving Atari Orange borders for focused cards/columns and detail overlays.
 - User-approved visual guardrail: Background, Surface, and Surface 2 are intentionally the same black value in the terminal TUI. Do not reintroduce subtly different background fills for panels/cards.
 - The main view now renders explicit full-width divider lines with `styles.Divider` rather than relying on component frames as separators.
+- Auto-refresh reload now refreshes both task data and release/epic indexes so newly-added task files and newly-added epic directories can appear without restarting the board.
+- Router-priority matching is intentionally scoped by release and epic before task number; a router task of `T001` must not mark every epic's `T001` as priority.

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T002-header-and-dividers.md

@@ -27,7 +27,7 @@ depends_on: ["E06-atari-noir-layout/T001-color-system"]
 
 Files read:
 - `.savepoint/router.md`
-- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
 - `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T002-header-and-dividers.md`
 - `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T001-color-system.md`
 - `.savepoint/visual-identity.md`

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T003-footer-status-bar.md

@@ -30,7 +30,7 @@ depends_on: ["E06-atari-noir-layout/T002-header-and-dividers"]
 
 Files read:
 - `.savepoint/router.md`
-- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
 - `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T003-footer-status-bar.md`
 - `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T002-header-and-dividers.md`
 - `.savepoint/visual-identity.md`

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T004-component-refinement.md

@@ -26,7 +26,7 @@ depends_on: ["E06-atari-noir-layout/T001-color-system"]
 
 Files read:
 - `.savepoint/router.md`
-- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
 - `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T004-component-refinement.md`
 - `internal/styles/palette.go`
 - `internal/styles/styles.go`

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T010-auto-refresh-watcher.md

@@ -62,3 +62,5 @@ Notes:
 - `data.Task` gained `Path` and `Mtime` (yaml:"-") fields populated in `loadEpicTasks`.
 - Advance/Retreat disk writes live in `update.go`, not `transitions.go` (keeps transitions pure).
 - Watcher created in `newProjectModel`; Init() subscribes if non-nil; nil watcher = test-safe.
+- Follow-up fix (2026-05-02): `newWatcher` receives `root` as the `.savepoint` directory, so it watches `root/releases` directly rather than `.savepoint/.savepoint/releases`. Watch startup errors now fail model creation instead of being silently ignored.
+- Follow-up fix (2026-05-02): file-change reloads refresh task data plus release/epic indexes, and create events add watches for newly-created directories before the debounced reload.