savepoint 1.0.0 → 1.0.2

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/config.yml

@@ -13,9 +13,9 @@ audit:
   divergence_threshold: 0.5 # warn if a proposal changes >50% of a live file
 
 theme:
-  bg: "#121212"
-  surface: "#0D0D0D"
-  surface_2: "#0F0F0F"
+  bg: "#000000"
+  surface: "#000000"
+  surface_2: "#000000"
   border: "#1A1A1A"
   text: "#F0E6DA"
   accents:

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/E06-Detail.md

@@ -0,0 +1,62 @@
+---
+type: epic-design
+status: audited
+---
+
+# Epic E06: Atari-Noir Layout Uplift
+
+## Purpose
+
+Update the existing TUI to align with the **Atari-Noir SavePoint design system**. This is a visual and layout uplift focused on restraint, clarity, and control, preserving existing functionality while eliminating visual noise and strictly adhering to the new color and layout rules.
+
+## What this epic adds
+
+- Centralized Atari-Noir color system in `palette.go`.
+- Restructured `styles.go` mapped to exact usage rules.
+- Static header component: `▣  S A V E P O I N T`.
+- Static footer component: `PLAN      │      BUILD      │      AUDIT`.
+- Full-width subtle horizontal dividers.
+- Refined component styling (columns, cards, epic panel) to remove unnecessary borders and improve spacing.
+
+## Definition of Done
+
+- All colors match the Atari-Noir strict specification.
+- Header renders correctly with no wrapping.
+- Footer displays PLAN / BUILD / AUDIT cleanly without dynamic status text.
+- Full-width dividers frame the content.
+- Cards/panels feel like surfaces, not text blocks.
+- Spacing is consistent and components breathe.
+- Focus/selection is obvious through position and Atari Orange borders, not relying solely on color text changes.
+- Existing functionality remains 100% intact.
+
+## Components and files
+
+| Path | Purpose |
+|------|---------|
+| `internal/styles/palette.go` | Define strict hex values |
+| `internal/styles/styles.go` | Map styles to new usage rules |
+| `internal/board/view.go` | Implement header, footer, dividers |
+| `internal/board/layout.go` | Adjust layout height calculations |
+| `internal/board/column.go` | Refine column styling and spacing |
+| `internal/board/card.go` | Refine card surface and focus state |
+| `internal/board/epic_panel.go` | Refine epic panel layout |
+
+## Implemented As
+
+- `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, 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 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
+
+- The original visual-only scope expanded to include board usability fixes requested during E06: footer navigation hints, detail overlay spacing, card title word-wrap, checklist state rendering, router priority markers, and auto-refresh on task file changes.
+- 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/T007-detail-card-fixes.md

@@ -1,6 +1,6 @@
 ---
 id: E06-atari-noir-layout/T007-detail-card-fixes
-status: planned
+status: done
 objective: "Add line breaks under Acceptance Criteria and Implementation Plan headings in task detail, and word-wrap card titles instead of truncating"
 depends_on: []
 ---
@@ -18,11 +18,11 @@ depends_on: []
 
 ## Implementation Plan
 
-- [ ] Edit `internal/board/detail.go` — add `""` entry after the `Acceptance Criteria:` heading line and after the `Implementation Plan:` heading line.
-- [ ] Edit `internal/board/detail.go` — make `wrapText` and `splitLongWord` exported (capitalize) so they can be reused from `card.go`.
-- [ ] Edit `internal/board/card.go` — replace `truncate(t.Title, inner)` with a multi-line approach that word-wraps the title across available width.
-- [ ] Edit `internal/board/card.go` — combine wrapped title lines with newlines in the card content (joining with `\n`).
-- [ ] Run `make build && make test` to verify no regressions.
+- [x] Edit `internal/board/detail.go` — add `""` entry after the `Acceptance Criteria:` heading line and after the `Implementation Plan:` heading line.
+- [x] Edit `internal/board/detail.go` — make `wrapText` and `splitLongWord` exported (capitalize) so they can be reused from `card.go`.
+- [x] Edit `internal/board/card.go` — replace `truncate(t.Title, inner)` with a multi-line approach that word-wraps the title across available width.
+- [x] Edit `internal/board/card.go` — combine wrapped title lines with newlines in the card content (joining with `\n`).
+- [x] Run `make build && make test` to verify no regressions.
 
 ## Context Log
 
@@ -33,4 +33,4 @@ Files read:
 
 Estimated input tokens: 600
 
-Notes:
+Notes: Exported WrapText/SplitLongWord from detail.go; updated card_test.go TestRenderCard_titleTruncated → TestRenderCard_titleWraps. Build and tests pass.

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T008-checkbox-states.md

@@ -1,6 +1,6 @@
 ---
 id: E06-atari-noir-layout/T008-checkbox-states
-status: planned
+status: done
 objective: "Parse and render checked/unchecked state for Implementation Plan checklist items"
 depends_on: []
 ---
@@ -19,11 +19,11 @@ depends_on: []
 
 ## Implementation Plan
 
-- [ ] Edit `internal/data/task.go` — add `CheckItem` struct with `Text string` and `Done bool` fields; change `Checklist []string` to `Checklist []CheckItem`.
-- [ ] Edit `internal/data/parser.go` — update `extractChecklistSection()` to detect `- [x] ` vs `- [ ] ` vs `- ` prefixes and set `Done` accordingly; strip prefix from `Text`.
-- [ ] Update all usages of `Checklist` across the codebase (likely only `board/detail.go` and tests).
-- [ ] Edit `internal/board/detail.go` — in the Implementation Plan section, render done items with `☑ ` + green `TagDone` styling and undone items with `□ ` + dim `CardMeta` styling.
-- [ ] Run `make build && make test` to verify no regressions.
+- [x] Edit `internal/data/task.go` — add `CheckItem` struct with `Text string` and `Done bool` fields; change `Checklist []string` to `Checklist []CheckItem`.
+- [x] Edit `internal/data/parser.go` — update `extractChecklistSection()` to detect `- [x] ` vs `- [ ] ` vs `- ` prefixes and set `Done` accordingly; strip prefix from `Text`.
+- [x] Update all usages of `Checklist` across the codebase (likely only `board/detail.go` and tests).
+- [x] Edit `internal/board/detail.go` — in the Implementation Plan section, render done items with `☑ ` + green `TagDone` styling and undone items with `□ ` + dim `CardMeta` styling.
+- [x] Run `make build && make test` to verify no regressions.
 
 ## Context Log
 
@@ -32,7 +32,9 @@ Files read:
 - `internal/data/parser.go`
 - `internal/board/detail.go`
 - `internal/styles/styles.go`
+- `internal/data/parser_test.go`
+- `internal/board/detail_test.go`
 
-Estimated input tokens: 800
+Estimated input tokens: 1200
 
-Notes:
+Notes: Added `extractChecklistItems` alongside existing `extractChecklistSection` (kept for `[]string` Acceptance path). Build and all tests pass.

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T009-router-priority-marker.md

@@ -1,6 +1,6 @@
 ---
 id: E06-atari-noir-layout/T009-router-priority-marker
-status: planned
+status: done
 objective: "Highlight the router priority task with a green marker on the card and optional text highlight"
 depends_on: []
 ---
@@ -12,18 +12,19 @@ depends_on: []
 - The model reads `RouterState.Task` (the `task:` field from `router.md`) and stores it as `Model.RouterTask`
 - In the board view, the task card whose ID matches `RouterTask` shows a green `▣` glyph (using `TagDone`/green style) instead of the normal phase-colored glyph
 - Non-priority tasks keep their existing phase-colored glyphs unchanged
+- Board always default view to current state release and epic 
 - The task detail overlay shows a `"(router priority)"` label or marker when the displayed task matches `RouterTask`
 - All existing keyboard interactions, column rendering, and card behavior remain intact
 
 ## Implementation Plan
 
-- [ ] Edit `internal/board/model.go` — add `RouterTask string` field to `Model`.
-- [ ] Edit `internal/board/board.go` — in `newProjectModel()`, read `routerState.Task` into `model.RouterTask`.
-- [ ] Edit `internal/board/card.go` — update `RenderCard` to accept a `routerTaskID string` parameter; when `t.ID == routerTaskID`, replace the phase glyph with a green `▣` using `TagDone` style.
-- [ ] Edit `internal/board/card.go` — update `RenderCard` signature and callsites (`column.go`, `view.go`).
-- [ ] Edit `internal/board/detail.go` — update `RenderDetail` to accept a `routerTaskID string`; when matching, append a `"(router priority)"` green label line.
-- [ ] Update all callsites of `RenderCard` and `RenderDetail` to pass `m.RouterTask`.
-- [ ] Run `make build && make test` to verify no regressions.
+- [x] Edit `internal/board/model.go` — add `RouterTask string` field to `Model`.
+- [x] Edit `internal/board/board.go` — in `newProjectModel()`, read `routerState.Task` into `model.RouterTask`.
+- [x] Edit `internal/board/card.go` — update `RenderCard` to accept a `routerTaskID string` parameter; when `t.ID == routerTaskID`, replace the phase glyph with a green `▣` using `TagDone` style.
+- [x] Edit `internal/board/card.go` — update `RenderCard` signature and callsites (`column.go`, `view.go`).
+- [x] Edit `internal/board/detail.go` — update `RenderDetail` to accept a `routerTaskID string`; when matching, append a `"(router priority)"` green label line.
+- [x] Update all callsites of `RenderCard` and `RenderDetail` to pass `m.RouterTask`.
+- [x] Run `make build && make test` to verify no regressions.
 
 ## Context Log
 
@@ -35,7 +36,13 @@ Files read:
 - `internal/board/detail.go`
 - `internal/data/router.go`
 - `internal/board/view.go`
+- `internal/board/card_test.go`
+- `internal/board/detail_test.go`
+- `internal/board/column_test.go`
 
-Estimated input tokens: 1000
+Estimated input tokens: 1800
 
 Notes:
+- `go build && go test ./...` — PASS (all board tests green)
+- `RenderColumn` signature extended with `routerTaskID string`; all 7 test callsites updated
+- New tests: `TestRenderCard_routerPriorityUsesGreenGlyph`, `TestRenderDetail_routerPriorityLabel`, `TestRenderDetail_noRouterPriorityLabelWhenNoMatch`

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

@@ -1,6 +1,6 @@
 ---
 id: E06-atari-noir-layout/T010-auto-refresh-watcher
-status: planned
+status: done
 objective: "Auto-refresh the board when task files change on disk via fsnotify file watcher"
 depends_on: []
 ---
@@ -19,26 +19,26 @@ depends_on: []
 
 ## Implementation Plan
 
-- [ ] Add `github.com/fsnotify/fsnotify` to `go.mod`
-- [ ] Create `internal/board/watch.go`:
+- [x] Add `github.com/fsnotify/fsnotify` to `go.mod`
+- [x] Create `internal/board/watch.go`:
   - Define `fileChangeMsg struct{}` and `reloadMsg struct{ tasks []data.Task }`
   - `watchFiles(w *fsnotify.Watcher) tea.Cmd` — blocks on watcher.Events, drains channel for 100ms, emits single `fileChangeMsg`
   - `reloadTasks(root string) tea.Cmd` — calls `loadAllTasks(root)` and emits `reloadMsg{tasks}`
   - `loadAllTasks(root string) ([]data.Task, error)` — extracted from `board.go`, reuses `Discover` + `Parser`
-- [ ] Edit `internal/board/model.go`:
-  - Add `watcher *fsnotify.Watcher` field to `Model`
-  - `Init()` — create watcher, `watcher.AddRecursive(root)` on `.savepoint/releases/`, return `watchFiles(watcher)`
-  - Close watcher in `Init()` if root is empty (test mode)
-- [ ] Edit `internal/board/board.go`:
+- [x] Edit `internal/board/model.go`:
+  - Add `Watcher *fsnotify.Watcher` field to `Model`
+  - `Init()` — returns `watchFiles(m.Watcher)` if watcher non-nil, else nil
+- [x] Edit `internal/board/board.go`:
   - Extract task-discovery loop from `newProjectModel` into `loadAllTasks(root string) ([]data.Task, error)`
-  - `newProjectModel` calls `loadAllTasks` instead of inline logic
-- [ ] Edit `internal/board/update.go`:
+  - `newProjectModel` calls `loadAllTasks` + `newWatcher`, sets `model.Watcher`
+  - `loadEpicTasks` now sets `task.Path` and `task.Mtime` from stat
+- [x] Edit `internal/board/update.go`:
   - Handle `fileChangeMsg` → return `reloadTasks(m.Root)` cmd
-  - Handle `reloadMsg` → swap `m.AllTasks = msg.tasks`, call `m.refreshTasks()`, return `watchFiles(m.watcher)` to re-subscribe
-  - On quit (`q`/`ctrl+c`), close `m.watcher` before `tea.Quit`
-- [ ] Edit `internal/board/transitions.go`:
-  - In `Advance` / `Retreat`, call `data.WriteTaskStatus(taskPath, task, expectedMtime)` to persist to disk so the watcher picks it up
-- [ ] Run `go build ./...` and `go test ./...` to verify no regressions
+  - Handle `reloadMsg` → swap `m.AllTasks = msg.tasks`, call `m.refreshTasks()`, return `watchFiles(m.Watcher)` to re-subscribe
+  - On quit (`q`/`ctrl+c`), close `m.Watcher` before `tea.Quit`
+  - `space`/`backspace` now call `data.WriteTaskStatus` to persist to disk
+- [x] `internal/data/task.go`: added `Path string` and `Mtime time.Time` (yaml:"-") to Task
+- [x] Run `go build ./...` and `go test ./...` to verify no regressions
 
 ## Context Log
 
@@ -47,15 +47,20 @@ Files read:
 - `internal/board/board.go`
 - `internal/board/update.go`
 - `internal/board/transitions.go`
-- `internal/board/watch.go` (does not exist yet)
+- `internal/board/watch.go` (created)
 - `internal/data/write.go`
+- `internal/data/task.go`
+- `internal/data/parser.go`
 - `.savepoint/AGENTS.md`
-- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
-- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T009-router-priority-marker.md`
 
-Estimated input tokens: 1800
+Estimated input tokens: 2200
+
+Quality gates: `go build ./...` PASS, `go test ./...` PASS (board: 0.317s, data: 0.343s)
 
 Notes:
-- The watcher watches `.savepoint/releases/` recursively. `fsnotify` v1.7+ supports `AddWith(path, fsnotify.Recursive)` on macOS/Windows; on Linux, fall back to walking and adding each subdirectory.
-- The 100ms debounce in `watchFiles` collapses rapid write sequences (e.g. editor save + lsp format) into a single reload.
-- `WriteTaskStatus` needs the task file path. Task struct may need a `Path` field populated at load time to make persistence possible.
+- fsnotify v1.10.0 has no recursive AddWith option; used `filepath.WalkDir` + `w.Add` per subdir instead.
+- `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.

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

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