savepoint 1.0.1 → 1.0.3

package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/E03-Detail.md

@@ -0,0 +1,45 @@
+---
+type: epic-design
+status: audited
+---
+
+# Epic E03: UI Visual Refinement
+
+## Purpose
+
+Polish the Atari-Noir TUI rendering across Next Activity indicator repositioning below the header with phase-aligned styling, checkbox rendering at sentence boundaries (not line breaks), unify icon/glyph determination across task cards and the epic sidebar, and force a consistent 256-color terminal profile for reliable cross-terminal rendering.
+
+## Definition of Done
+
+- Next Activity renders as a dedicated line below the header with phase-aligned coloring
+- Checkboxes render at sentence starts, not at line break positions
+- ~~Total content width equals available space at every breakpoint with no underflow~~ (absorbed into T001, which is marked done; existing layout tests pass)
+- Task card and epic sidebar glyphs are determined by a shared helper, unified on the same status→glyph mapping
+- Terminal color profile is forced to 256-color, ensuring consistent background rendering on all terminals including PowerShell
+
+## Components and files
+
+| Path | Purpose |
+|------|---------|
+| `internal/board/layout.go` | Width arithmetic, layout breakpoints, min width guard (stable — existing implementation verified) |
+| `internal/board/view.go` | Header rendering, Next Activity line, checkbox rendering point |
+| `internal/board/update.go` | Resize handling, terminal dimension clamping |
+| `internal/styles/styles.go` | Phase-aligned styles for Next Activity |
+| `internal/data/router.go` | RouterState model |
+| `internal/data/task.go` | Task markdown parsing for checkbox placement |
+| `internal/board/status.go` | Shared status glyph mapping helper (new) |
+| `internal/board/card.go` | Task card glyph determination (updated for shared helper) |
+| `internal/board/board.go` | Board startup; sets the Lipgloss color profile to ANSI256 before model initialization |
+| `internal/board/view_test.go` | Header, formatting, and checkbox tests |
+
+## Implemented As
+
+- `internal/board/view.go` renders `next_action` as a separate line below the header through `renderNextActivityLine`, using existing footer phase styles for `PLAN`, `BUILD`, and `AUDIT`.
+- `internal/board/layout.go` accounts for the optional Next Activity line when calculating board chrome and content height.
+- `internal/data/parser.go` joins hard-wrapped checklist continuation lines before rendering so markdown wrap points do not create duplicate checklist items.
+- `internal/board/detail.go` splits checklist item text on semantic sentence boundaries and emits one `[ ]` or `[x]` marker per sentence.
+- `internal/data/task.go` adds `Task.Status` plus status constants, including `audited`, for shared board glyph rendering.
+- `internal/board/status.go` centralizes the planned, in-progress, done, and audited status glyph mapping used by task cards and the epic sidebar.
+- `internal/board/card.go` uses explicit `Task.Status` when present, while preserving the legacy column/stage glyph fallback for older task data.
+- `internal/board/epic_panel.go` delegates epic status glyph rendering to the shared status helper.
+- `internal/board/board.go` sets Lipgloss to the ANSI256 color profile at board startup. This satisfies the deterministic 256-color rendering intent, although the implementation lives at the board boundary instead of `main.go`.

package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T001-border-resize-fix.md

@@ -0,0 +1,40 @@
+---
+id: E03-ui-visual-refinement/T001-border-resize-fix
+status: done
+objective: "Fix right-border clipping and ensure clean rendering on terminal resize"
+depends_on: []
+---
+
+# T001: Fix Right-Border Clipping and Resize Robustness
+
+## Acceptance Criteria
+
+- The board frame right border (`│` or rounded corner) is always visible at any terminal width ≥ 40 chars
+- Reducing terminal width below a breakpoint (120→119, 80→79) does not leave stray pixels or broken border artifacts
+- Reducing to very narrow widths (< 50) degrades gracefully (no visual corruption)
+- Expanding terminal width back renders cleanly with no leftover characters from previous dimensions
+- All existing layout breakpoints (120/80) still function correctly
+- At every layout breakpoint (120+, 80–119, 40–79), total rendered column width + borders + padding equals the available terminal width with zero underflow
+- Column widths are calculated as `floor(innerWidth / colCount)` and the remainder is distributed as 1 extra column to the first `remainder` columns
+- The board frame overhead (left border + inter-column separators + right border) is exactly accounted for in every breakpoint
+- Reducing terminal width by 1 character removes exactly 1 column of content (no more, no less)
+- All existing layout tests pass
+
+## Implementation Plan
+
+- [x] Verified — no artifacts observed. Existing layout.go + tests satisfy acceptance criteria.
+
+## Context Log
+
+Files read:
+- `internal/board/layout.go`
+- `internal/board/view.go`
+- `internal/board/update.go`
+- `internal/board/layout_test.go`
+
+Estimated input tokens: 800
+
+Notes:
+- Consolidated from former T001 + T004 (duplicate width arithmetic scopes).
+- Former T004 at `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T004-width-arithmetic-audit.md` has been deleted.
+- Moved from `E06-atari-noir-layout/T006-border-resize-fix` (release v1) to `E03-ui-visual-refinement` (release v1.1).

package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T002-next-activity-below-header.md

@@ -0,0 +1,64 @@
+---
+id: E03-ui-visual-refinement/T002-next-activity-below-header
+status: done
+objective: "Reposition Next Activity below header as a dedicated line with phase-aligned styling"
+depends_on:
+    - E03-ui-visual-refinement/T001-border-resize-fix
+---
+
+# T002: Reposition Next Activity Below Header with Phase-Aligned Styling
+
+## Acceptance Criteria
+
+- Next Activity renders as a dedicated full-width line immediately below the header bar
+- The line is hidden (not rendered) when no activity is active or router state is idle
+- The line uses `phase:` prefix mapped to existing footer phase styles:
+  - `task-building` → FooterPhaseBuild (orange + bold)
+  - `audit-pending` → FooterPhaseAudit (green + bold)
+  - `pre-implementation` / `epic-design` / `epic-task-breakdown` → FooterPhasePlan (purple + bold)
+- Format: `"PLAN: Build T010 (E06) v1"` — phase prefix in styled tag, activity text follows
+- Activity text is the `next_action` value from router state (already populated)
+- At narrow widths (< 60 chars), the line truncates gracefully: `"PLAN: Build T0…"`
+- Existing header layout is preserved — nothing shifts or wraps incorrectly
+
+## Implementation Plan
+
+- [x] Read `internal/board/view.go` — locate current header rendering and any existing Next Activity right-aligned logic
+- [x] Read `internal/styles/styles.go` — verify FooterPhaseBuild/FooterPhaseAudit/FooterPhasePlan are available for reuse, or add them if missing
+- [x] Read `internal/data/router.go` — confirm RouterState model exposes `state` and `next_action` fields
+- [x] Edit `internal/board/view.go` — add `renderNextActivityLine(state)` that returns a styled string using phase-mapped style
+- [x] Edit `internal/board/view.go` — insert the rendered line immediately after header output in the `View()` function
+- [x] Edit `internal/board/layout.go` — adjust vertical layout height calculation to account for the new line
+- [x] Add tests in `internal/board/view_test.go` — verify phase mapping, truncation, and hidden state
+- [x] Run `make build && make test` to verify no regressions
+
+## Context Log
+
+Files read:
+- `.savepoint/router.md`
+- `agent-skills/savepoint-build-task/SKILL.md`
+- `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/E03-Design.md`
+- `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T002-next-activity-below-header.md`
+- `.savepoint/visual-identity.md`
+- `agent-skills/ink-tui-design/SKILL.md`
+- `internal/board/view.go`
+- `internal/board/layout.go`
+- `internal/styles/styles.go`
+- `internal/data/router.go`
+- `internal/board/view_test.go`
+- `internal/board/layout_test.go`
+
+Files edited:
+- `internal/board/view.go`
+- `internal/board/layout.go`
+- `internal/board/view_test.go`
+- `internal/board/layout_test.go`
+- `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T002-next-activity-below-header.md`
+- `.savepoint/router.md`
+
+Estimated input tokens: 9800
+
+Notes:
+- Key design decision from user: placement below header as dedicated line (not right-aligned in header); reuse existing FooterPhase* styles
+- Acceptance criteria verified by `go test ./internal/board` covering dedicated line ordering, hidden nil/idle/empty states, phase tag mapping, `next_action` text, narrow truncation, and header preservation.
+- Quality gates: `make build` could not run because `make` is not installed in this Windows shell. Equivalent `go run ./internal/buildtool build` passed. Equivalent `go test ./...` passed.

package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T003-checkbox-rendering-fix.md

@@ -0,0 +1,56 @@
+---
+id: E03-ui-visual-refinement/T003-checkbox-rendering-fix
+status: done
+objective: "Fix checkbox rendering to place checkboxes at sentence start, not at line break positions"
+depends_on:
+  - E03-ui-visual-refinement/T001-border-resize-fix
+---
+
+# T003: Fix Checkbox Rendering — Place at Sentence Start
+
+## Acceptance Criteria
+
+- Checkboxes (`[ ]` / `[x]`) render at the beginning of each task description sentence, not at arbitrary line-break positions
+- If a task description is hard-wrapped in markdown at column 80, the checkbox appears only once per sentence
+- Multi-sentence tasks show one checkbox per sentence, visually aligned at column 0 of each sentence
+- Already-checked tasks show `[x]` at sentence start consistently
+- No duplicate checkboxes for the same sentence
+- Single-sentence tasks (most common case) render exactly one checkbox at the start, unchanged from current behavior
+
+## Implementation Plan
+
+- [x] Read `internal/data/task.go` — locate the markdown parsing / TUI rendering path for task descriptions
+- [x] Read `internal/board/view.go` — locate where task items are rendered in the board columns
+- [x] Identify the parsing layer — this is likely where markdown task body text is split into the displayed description string before being passed to rendering
+- [x] Edit the identified file(s) — change the sentence-splitting logic to split on sentence boundaries (`. `, `!\n`, `?\n`) rather than on hard line breaks
+- [x] In the rendering layer, emit one checkbox per sentence start, aligned to column 0 of each sentence block
+- [x] Add tests in the relevant test file for sentence-boundary detection, single-sentence, multi-sentence, and hard-wrapped cases
+- [x] Run `make build && make test` to verify no regressions
+
+## Context Log
+
+Files read:
+- `internal/data/task.go`
+- `internal/data/parser.go`
+- `internal/data/parser_test.go`
+- `internal/board/view.go`
+- `internal/board/detail.go`
+- `internal/board/detail_test.go`
+- `agent-skills/savepoint-build-task/SKILL.md`
+- `agent-skills/ink-tui-design/SKILL.md`
+- `.savepoint/visual-identity.md`
+
+Files edited:
+- `internal/data/parser.go`
+- `internal/data/parser_test.go`
+- `internal/board/detail.go`
+- `internal/board/detail_test.go`
+
+Estimated input tokens: 8,500
+
+Notes:
+- Parser now joins hard-wrapped continuation lines into the current checklist item.
+- Detail rendering now splits checklist item text into semantic sentences and emits `[ ]` / `[x]` only at sentence starts; wrapped continuation lines are indented under the sentence text.
+- Focused tests: `go test ./internal/data ./internal/board` passed.
+- Required literal quality gate: `make build` could not run because `make` is not installed in this PowerShell environment.
+- Equivalent gates: `go run ./internal/buildtool build` passed; `go test ./...` passed.

package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T005-unify-status-glyphs.md

@@ -0,0 +1,65 @@
+---
+id: E03-ui-visual-refinement/T005-unify-status-glyphs
+status: done
+objective: "Unify icon/glyph determination across task cards and epic sidebar via a shared statusGlyph helper with backward compatibility"
+depends_on: []
+---
+
+# T005: Unify Task Status Glyph Determination
+
+## Acceptance Criteria
+
+- A new `status` field is added to the `data.Task` struct (one of: `planned`, `in_progress`, `done`, `audited`)
+- A shared `statusGlyph(status string) (styled string)` helper exists in `internal/board/status.go` that maps status strings to the same glyph+style used by the epic sidebar
+- `RenderCard` in `card.go` uses the unified helper when `Task.Status` is set, otherwise falls back to the existing Column+Stage logic with identical behavior
+- The epic sidebar's `epicSidebarGlyph` function is refactored to call the shared `statusGlyph` helper instead of its own switch
+- All existing tests pass without modification
+- New tests cover the explicit `Status` path for each status value
+- No changes to existing task files are required
+- `make build && make test` pass
+
+## Implementation Plan
+
+- [x] Read `internal/data/task.go` — study Task struct and existing columns/stage types
+- [x] Read `internal/board/card.go` — study current RenderCard glyph determination path
+- [x] Read `internal/board/epic_panel.go` — study epicSidebarGlyph for extraction opportunity
+- [x] Edit `internal/data/task.go` — add `Status string` field to Task struct and Status constants
+- [x] Create `internal/board/status.go` — shared `statusGlyph(status string) string` function with the unified glyph mapping
+- [x] Edit `internal/board/epic_panel.go` — refactor `epicSidebarGlyph` to call the shared `statusGlyph`
+- [x] Edit `internal/board/card.go` — update `RenderCard` to use `statusGlyph` when Status is set, else existing backward-compat path
+- [x] Edit `internal/board/card_test.go` — add tests for explicit Status path (planned/in_progress/done/audited)
+- [x] Run `make build && make test` to verify no regressions
+
+## Context Log
+
+Files read:
+- `.savepoint/router.md`
+- `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/E03-Detail.md`
+- `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T005-unify-status-glyphs.md`
+- `agent-skills/savepoint-build-task/SKILL.md`
+- `agent-skills/ink-tui-design/SKILL.md`
+- `.savepoint/visual-identity.md`
+- `internal/data/task.go`
+- `internal/data/parser.go`
+- `internal/data/write.go`
+- `internal/data/task_test.go`
+- `internal/board/card.go`
+- `internal/board/epic_panel.go`
+- `internal/styles/styles.go`
+- `internal/board/card_test.go`
+- `internal/board/epic_panel_test.go`
+- `.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T003-epic-status-glyphs.md`
+
+Estimated input tokens: 11000
+
+Notes:
+- Option A approach: backward compatible when `Status` is unset
+- The unified glyph mapping matches epic sidebar: planned→○, in_progress→▶, done→◉, audited→✓
+- Old `Column`+`Stage` path reproduces exact current behavior (▣/◇/◆ with column-level overrides)
+- `go test ./internal/board ./internal/data` initially hit a sandbox AppData build-cache permission error; rerun outside the sandbox passed.
+- Literal `make build && make test` could not run because `make` is not installed in this Windows shell.
+- Equivalent quality gates passed: `go run ./internal/buildtool build`; `go test ./...`.
+
+## Drift Notes
+
+- Drift: `internal/board/status.go` added, not yet in Codebase Map.

package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T006-forced-256-color-profile.md

@@ -0,0 +1,36 @@
+---
+id: E03-ui-visual-refinement/T006-forced-256-color-profile
+status: done
+objective: "Force 256-color terminal profile at init to ensure consistent background rendering across all terminals"
+depends_on: []
+---
+
+# T006: Forced 256-Color Profile for Terminal Consistency
+
+## Acceptance Criteria
+
+- On startup, `lipgloss` is configured to use `Force256Color` profile instead of relying on terminal detection
+- The board's background renders as uniform black (`"#000000"` / ANSI256 `"232"`) on every color-capable terminal including PowerShell, CMD, Windows Terminal, VS Code terminal, and all Unix terminals
+- No color artifacts or background mismatches are visible when running on PowerShell
+- Existing style definitions using TrueColor hex values still resolve correctly via Lipgloss's 256-color fallback
+- `make build && make test` pass with no regressions
+
+## Implementation Plan
+
+- [x] Read board startup flow and identify where to inject profile forcing
+- [x] Edit `internal/board/board.go` — add `lipgloss.SetColorProfile(termenv.ANSI256)` before model initialization
+- [x] Run equivalent build and test gates in this Windows shell
+
+## Context Log
+
+Files read:
+- `main.go`
+- `internal/styles/palette.go`
+- `internal/styles/styles.go`
+
+Estimated input tokens: 400
+
+Notes:
+- `lipgloss.Force256Color` is supported on all Go platforms and all color-capable terminals
+- This is a single-line change — no new dependencies or imports beyond the existing `github.com/charmbracelet/lipgloss` package
+- TrueColor hex values (`"#000000"`) are mapped to nearest 256-color values (`"232"`) via palette.go's `color()` helper; these are already configured

package/.savepoint/releases/v1.1/epics/E04-epic-navigation/E04-Audit.md

@@ -0,0 +1,167 @@
+---
+type: audit-findings
+audited: 2026-05-02
+---
+
+# Audit Findings: E04 Epic Navigation
+
+## Main Findings
+
+E04 verified the wide-screen epic navigation work: focusable epic sidebar, purple epic focus styling, epic detail overlay, and epic status glyph loading from epic detail frontmatter.
+
+The audit found no must-fix product issue before close. Carry-forward notes were limited to documenting accepted overlay filtering behavior, the permissive epic detail file fallback, and a minor unused sidebar paging helper.
+
+## Code Style Review
+
+
+- [ ] One job per file
+- [ ] One-sentence functions
+- [ ] Test branches
+- [ ] Types are documentation
+- [ ] Build, don't speculate
+- [ ] Errors at boundaries
+- [ ] One source of truth
+- [ ] Comments explain WHY
+- [ ] Content in data files
+- [ ] Small diffs
+
+## Proposed Changes
+
+### 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
+```
+
+### With
+
+```md
+## 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.
+
+## Architectural notes
+```
+
+---

package/.savepoint/releases/v1.1/epics/E04-epic-navigation/E04-Detail.md

@@ -0,0 +1,51 @@
+---
+type: epic-design
+status: audited
+---
+
+# Epic E04: Epic Navigation
+
+## Purpose
+
+Make the epic sidebar an active, focusable UI component. The sidebar currently lists epics as static text — the only way to switch epics is through the `E` key dropdown popup. This epic gives the sidebar parity with task columns: ↑/↓ navigation, focus highlighting, and an Enter-triggered "Epic Detail" overlay.
+
+## Definition of Done
+
+- Epic sidebar is focusable — left arrow from `Planned` column moves focus to sidebar
+- In sidebar focus: ↑/↓ navigates through epics, right arrow returns to column view
+- Focused epic filters tasks in all three columns (same filtering as current `SelectedEpic`)
+- A focused epic entry in the sidebar is visually distinct from unfocused ones
+- Enter on a focused epic opens an "Epic Detail" overlay showing the epic's `E##-Detail.md` content
+- Overlay supports scrolling (↑/↓, PgUp/PgDown) identical to task detail overlay
+- `E` key dropdown behavior is preserved unchanged
+- All above works only when epic panel is visible (≥120 terminal width)
+
+## Components and files
+
+| Path | Purpose |
+|------|---------|
+| `internal/board/model.go` | Add `EpicPanelFocus`, `EpicPanelCursor`, `EpicDetailOffset`, `EpicDetailContent` state |
+| `internal/board/update.go` | Handle left arrow to enter panel, ↑/↓ within, Enter to open detail, right arrow to exit |
+| `internal/board/view.go` | Pass focus/cursor to `RenderEpicSidebar`, render epic detail overlay |
+| `internal/board/epic_panel.go` | Update `RenderEpicSidebar` for focus/cursor, add `RenderEpicDetail` |
+| `internal/board/detail.go` | Reuse `visibleDetailLines`, `WrapText`, scroll helpers for epic detail |
+| `internal/board/board.go` | Load epic status from detail files in `loadBoardData` |
+| `internal/board/watch.go` | Carry `epicStatuses` in `reloadMsg` for dynamic reloads |
+| `internal/data/parser.go` | Reuse `ParseFrontmatter` to extract status YAML field |
+
+## 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.

package/.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T001-sidebar-focusable-navigation.md

@@ -0,0 +1,65 @@
+---
+id: E04-epic-navigation/T001-sidebar-focusable-navigation
+status: done
+objective: "Make the epic sidebar focusable with up/down navigation to select epics"
+depends_on: []
+---
+
+# T001: Sidebar Focusable Navigation
+
+## Acceptance Criteria
+
+- Left arrow (`←`/`h`) from the `Planned` column moves keyboard focus to the epic panel (when panel is visible at ≥120 width)
+- In epic panel focus mode, `↑`/`k` moves the cursor up through the epic list (clamped to bounds)
+- In epic panel focus mode, `↓`/`j` moves the cursor down through the epic list (clamped to bounds)
+- The focused epic entry in the sidebar is highlighted with the same focused style used in task columns
+- `Enter` in epic panel focus mode selects the focused epic: tasks are filtered to that epic, and focus remains in the panel
+- Right arrow (`→`/`l`) from epic panel focus exits back to the `Planned` column with `FocusedTask=0`
+- The existing `E` key dropdown overlay still works unchanged
+- When no epics exist in the current release, the panel shows no navigable cursor
+- All navigation is blocked when any overlay is open (existing behavior)
+
+## Implementation Plan
+
+- [x] Add `EpicPanelFocus bool` and `EpicPanelCursor int` to `Model` in `model.go`
+- [x] Add `EpicPanelFocus` tracking to `refreshEpicsForRelease()` — clamp cursor and clear focus if epics list becomes empty
+- [x] In `update.go` — before the `switch msg.String()` block, check `m.Overlay == OverlayNone && m.EpicPanelFocus` and route to a new `updateEpicPanel` method
+- [x] In `updateEpicPanel` — handle `up`/`k` (decrement cursor), `down`/`j` (increment cursor), `enter` (call `m.selectEpicPanelEpic()`), `right`/`l` (exit to Planned column), `left`/`h` (no-op or wrap)
+- [x] In `update.go` main switch — handle `left`/`h` when `FocusedColumn == Planned` by setting `EpicPanelFocus = true` (only when epic panel is visible, i.e. `CalculateLayout(m.Width, m.Height).EpicPanelVisible`)
+
+- [x] Add `m.selectEpicPanelEpic()` method: set `m.SelectedEpic = m.Epics[m.EpicPanelCursor]`, reset `m.FocusedTask = 0`, `m.DetailOffset = 0`, call `m.refreshTasks()`, call `m.ensureFocusedTaskVisible()`, write router state
+- [x] Update `epic_panel.go` — update `RenderEpicSidebar` signature to accept `focus bool, cursor int` params; when focused, render the item at cursor with `styles.TaskItemFocused` and `epicActiveMarker`; when not focused, keep current rendering with `SelectedEpic` marker
+- [x] Update `view.go` — pass `m.EpicPanelFocus` and `m.EpicPanelCursor` to `RenderEpicSidebar` in `renderEpicPanel`
+- [x] Add `m.epicPanelPageSize()` helper returning `m.Height / 2` (or similar) for eventual PgUp/PgDown support
+- [x] Run `make build && make test` to verify no regressions
+
+## Context Log
+
+Files read:
+- `.savepoint/router.md`
+- `agent-skills/savepoint-build-task/SKILL.md`
+- `agent-skills/ink-tui-design/SKILL.md`
+- `.savepoint/visual-identity.md`
+- `.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`
+- `internal/board/model.go`
+- `internal/board/update.go`
+- `internal/board/view.go`
+- `internal/board/epic_panel.go`
+- `internal/board/layout.go`
+- `internal/board/board.go`
+- `internal/board/epic_panel_test.go`
+- `internal/board/update_test.go`
+- `internal/board/model_test.go`
+- `internal/board/view_test.go`
+
+Estimated input tokens: 12000
+
+Notes:
+- Model's `EpicCursor` field (used in dropdown) is distinct from new `EpicPanelCursor`
+- The epic panel visibility is determined by `layout.EpicPanelVisible` in `CalculateLayout`
+- Focused board tests: `go test ./internal/board` passed.
+- Required quality gate `make build && make test`: failed to start because `make` is not installed in this shell.
+- Equivalent quality gates: `go build -o savepoint main.go` passed; `go test ./...` passed.
+- Follow-up fix after manual review: epic panel focus now renders with the focused panel border and focused title so entering the sidebar is visually apparent even when the cursor starts on the already selected epic. Re-ran `go test ./internal/board`, `go build -o savepoint main.go`, and `go test ./...`; all passed.
+- Follow-up input-routing fix: global `q`, `e`, `r`, and `?` keys now run before epic-panel-specific key handling, so quit and dropdown overlays still work when the epic panel is focused. Added regression tests for `q`, `e`, and `r` from epic panel focus. Re-ran `go test ./internal/board`, `go build -o savepoint main.go`, and `go test ./...`; all passed.