savepoint 1.0.1 → 1.0.2

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
+
+- [ ] Read `main.go` — understand startup flow and identify where to inject profile forcing
+- [ ] Edit `main.go` — add `lipgloss.SetColorProfile(lipgloss.Force256Color)` call before `board.Run()`
+- [ ] Run `make build && make test` to verify no regressions
+
+## 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-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.

package/.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T002-epic-detail-overlay.md

@@ -0,0 +1,73 @@
+---
+id: E04-epic-navigation/T002-epic-detail-overlay
+status: done
+objective: "Add Epic Detail overlay showing E##-Detail.md content, triggered by Enter on a focused epic"
+depends_on:
+    - E04-epic-navigation/T001-sidebar-focusable-navigation
+---
+
+# T002: Epic Detail Overlay
+
+## Acceptance Criteria
+
+- Pressing `Enter` on a focused epic in the sidebar opens a centered overlay titled "EPIC DETAIL"
+- The overlay content is read from the epic's `E##-Detail.md` file on disk
+- If the file exists, it shows: epic title, purpose, definition of done, and the components table (rendered as text)
+- If the file does not exist, the overlay shows an informative "(no detail available)" message
+- The overlay is height-capped at ~70% of terminal height with scroll indicators (↑/↓) for overflow
+- `↑`/`k` and `↓`/`j` scroll the detail content (reuses existing scroll indicator pattern from `detail.go`)
+- `PgUp`/`PgDown` scroll in page increments
+- `Esc` or `q` closes the overlay and returns to epic panel focus
+- The overlay uses `styles.DetailOverlay` for consistent visual styling with task detail
+
+## Implementation Plan
+
+- [x] Add `OverlayEpicDetail OverlayType = "detail-epic"` to `model.go`
+- [x] Add `EpicDetailOffset int` to `Model` in `model.go`
+- [x] Add `EpicDetailContent string` to `Model` in `model.go` (cached content of the detail file)
+
+- [x] In `epic_panel.go` — add `RenderEpicDetail(epicID, content string, overlayW, maxHeight, offset int) string`:
+  - Parse frontmatter lines from the markdown content (lines between `---` markers) for metadata display
+  - Render header: epic ID and title from markdown heading
+  - Render body: the rest of the markdown content as plain text (no markdown rendering)
+  - Use `visibleDetailLines` from `detail.go` for height-capped scrolling
+  - Reuse `styles.DetailOverlay`, `styles.ColumnTitleFocused`, `styles.CardMeta`, `styles.ColumnTitle`
+
+- [x] In `update.go` — when `m.EpicPanelFocus && enter`:
+  - Derive detail file path: `{m.Root}/releases/{m.SelectedRelease}/epics/{epicSlug}/{shortID(epicSlug)}-Detail.md`
+  - Read the file content with `os.ReadFile`
+  - If error (file missing, etc.), set `m.EpicDetailContent = "(no detail available)"`
+  - Set `m.Overlay = OverlayEpicDetail`, `m.EpicDetailOffset = 0`
+  - Cache the content in `m.EpicDetailContent`
+
+- [x] In `updateOverlay` in `update.go` — match `OverlayEpicDetail` and handle:
+  - `esc`/`q` → `OverlayNone` (exit back to epic panel focus)
+  - `up`/`k` → decrement `EpicDetailOffset` if > 0
+  - `down`/`j` → increment `EpicDetailOffset`
+  - `pgup`/`pgdown` → page scroll using existing `detailPageSize()`
+
+- [x] In `view.go` — match `OverlayEpicDetail` and call `RenderEpicDetail(...)` with the cached content
+- [x] Reuse `visibleDetailLines`, `clampDetailOffset`, `detailRow`, `WrapText` from `detail.go` — no need to copy
+- [x] Run `make build && make test` to verify no regressions
+
+## Context Log
+
+Files read:
+- `internal/board/model.go`
+- `internal/board/update.go`
+- `internal/board/view.go`
+- `internal/board/epic_panel.go`
+- `internal/board/detail.go`
+- `internal/board/card.go` — `shortID` helper
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md` — example detail file
+
+Estimated input tokens: ~2800
+
+Quality gate: `go build` ✓, `go test ./...` ✓ (all 3 packages pass)
+
+Notes:
+- `detail.go` functions `visibleDetailLines`, `clampDetailOffset`, `WrapText` are unexported — `epic_panel.go` is in the same `board` package so they're accessible
+- Content loading is synchronous (simple file read) — no async command needed
+- `shortID` extracts "E04" from "E04-epic-navigation" via first `-` split
+- Updated `TestUpdate_epicPanelEnterSelectsFocusedEpic` → `TestUpdate_epicPanelEnterOpensDetailOverlay` to reflect T002 behavior change
+- Added 7 new tests covering overlay open, scroll, pgup/pgdown, esc close, view rendering, no-content fallback

package/.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T003-epic-status-glyphs.md

@@ -0,0 +1,73 @@
+---
+id: E04-epic-navigation/T003-epic-status-glyphs
+status: done
+objective: "Add status glyphs to the epic sidebar showing each epic's lifecycle state"
+depends_on:
+  - E04-epic-navigation/T001-sidebar-focusable-navigation
+---
+
+# T003: Epic Status Glyphs in Side Panel
+
+## Acceptance Criteria
+
+- Each epic in the sidebar shows a status glyph prefix: `○` for `planned`, `▶` for `in_progress`, `◉` for `done`, `✓` for `audited`, space for unknown
+- The glyph is styled: `○` in dim, `▶` in orange, `◉` in green, `✓` in green — matching the status colour convention
+- The status is read from the `status:` field in each epic's `E##-Detail.md` frontmatter at load time
+- Only the **side panel** is affected — the `E` key dropdown overlay is unchanged
+- The status map is loaded once during `loadBoardData` and cached in the Model (no per-frame file I/O)
+- If an epic's detail file is missing or has no `status` frontmatter, the glyph defaults to a space (no indicator)
+- All existing epic sidebar rendering (focus highlighting, cursor, active marker, selected marker) works unchanged
+- `make build && make test` pass
+
+## Implementation Plan
+
+- [x] Add `EpicStatus map[string]string` to `Model` in `model.go` — keyed by epic ID, values like `"planned"`, `"in_progress"`, `"done"`, `"audited"`
+- [x] In `board.go` — update `loadBoardData` to load epic statuses:
+  - After listing epics for a release, iterate each epic's directory
+  - Build detail file path: `filepath.Join(epic.Path, shortID(epic.ID)+"-Detail.md")`
+  - Read the file with `os.ReadFile`
+  - Parse frontmatter with `data.NewParser().ParseFrontmatter(string(content))`
+  - Extract `"status"` from the returned map; if missing, skip
+  - Store in `epicStatuses[epic.ID]` — collect all epics across releases into the map
+- [x] Pass `epicStatuses map[string]string` through the `reloadMsg` pipeline so dynamic reloads preserve glyphs
+- [x] In `epic_panel.go` — update `RenderEpicSidebar` signature to accept `status map[string]string`
+- [x] Add a helper function `epicSidebarGlyph(status map[string]string, epicID string) string`:
+  - `"planned"` → styles.CardMeta.Render("○")
+  - `"in_progress"` → styles.GlyphBuild.Render("▶")
+  - `"done"` → styles.TagDone.Render("◉")
+  - `"audited"` → styles.TagDone.Render("✓")
+  - default → " " (single space)
+- [x] In `RenderEpicSidebar` — prepend the glyph to each epic label: `"▶ E01-tui-optimisation"`
+- [x] In `view.go` — pass `m.EpicStatus` to `RenderEpicSidebar`
+- [x] Handle `EpicStatus` in `reloadMsg` handler in `update.go` — store the map when tasks reload
+- [x] Update `reloadMsg` struct in `watch.go` to carry `epicStatuses map[string]string`
+- [x] Run `make build && make test` to verify no regressions
+
+## Context Log
+
+Files read:
+- `internal/board/model.go`
+- `internal/board/epic_panel.go`
+- `internal/board/view.go`
+- `internal/board/board.go`
+- `internal/board/watch.go`
+- `internal/board/update.go`
+- `internal/board/card.go` — glyph pattern reference
+- `internal/styles/styles.go` — existing style constants
+- `internal/data/parser.go` — `ParseFrontmatter` for YAML extraction
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md` — example frontmatter with status field
+- `.savepoint/releases/v1.1/epics/E04-epic-navigation/tasks/T001-sidebar-focusable-navigation.md` — dependency status check
+- `internal/board/epic_panel_test.go` — updated RenderEpicSidebar test calls
+
+Estimated input tokens: 1800
+
+Notes:
+- Reuses `data.NewParser().ParseFrontmatter()` which already handles YAML frontmatter extraction
+- Reuses `shortID()` from `card.go` (same package) to derive the detail file name
+- The `E` key dropdown in `epic_panel.go` (`RenderEpicDropdown`) is intentionally NOT updated — side panel only per user preference
+- Function named `epicSidebarGlyph` (not `epicStatusGlyph`) — takes `(map[string]string, string)` for nil-safe lookup
+- `go build` + `go test ./...` pass
+
+## Drift Notes
+
+No drift — all changes are within existing files and follow established patterns.

package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Detail.md

@@ -0,0 +1,45 @@
+---
+type: epic-design
+status: planned
+---
+
+# Epic E05: Tasking Permissions & Router Updates
+
+## Purpose
+
+Restrict agent task status mutation to `in_progress` only (no `done`, no retreat). Add an explicit TUI hotkey (`m`) to update the router to the current task, decoupling router updates from navigation. The user retains full control over `done` transitions and retreats via the board.
+
+## Definition of Done
+
+- AGENTS.md updated: agents set `status: in_progress` when starting implementation; only user can set `done` or retreat
+- Router.md updated: document that agent sets router task when starting work via explicit `m` action
+- Design.md Section 4 updated: status model distinguishes agent vs user capabilities
+- TUI `m` hotkey implemented: sets router's `task` field to the currently focused task; detects if it's the last uncompleted task in the epic → sets `audit-pending` state
+- Help overlay shows `m` key binding
+- `make build && make test` passes
+
+## Components and files
+
+| Path | Purpose |
+|------|---------|
+| `AGENTS.md` | Remove "set status: done" from Task Completion Protocol; add `in_progress` guidance |
+| `.savepoint/router.md` | Add agent router-update guidance in task-building state |
+| `.savepoint/Design.md` | Revise Section 4 status model: agent `in_progress` only, user `done`/retreat only |
+| `.savepoint/releases/v1.1/v1.1-PRD.md` | Add E05 to epic breakdown |
+| `.savepoint/router.md` | Update current state for E05/T001 |
+| `internal/board/update.go` | Add `m` key handler for explicit router update |
+| `internal/board/model.go` | Add `writeRouterTask()` method to update router's `task` field and derive state |
+| `internal/board/help.go` | Add `m` key to keyboard shortcuts |
+| `internal/data/router.go` | No changes needed (WriteRouterState already supports all fields) |
+| `internal/data/write.go` | No changes needed |
+
+## Architectural notes
+
+- The `m` hotkey reads the currently focused task, not the epic panel cursor
+- Router state derivation from task:
+  - Task is the last uncompleted task in its epic → `state: audit-pending`, `task: <empty>`
+  - Otherwise → `state: task-building`, `task: <full-task-id>`
+  - `release` and `epic` are always set from the focused task
+- The `m` key does nothing when no task is focused, or when focused on a `done` task
+- The `m` key is independent of navigation — user can browse freely without router drift
+- No code enforcement against agents writing `done`. This is a documentation-only trust boundary. AGENTS.md is the contract.

package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T001-update-agents-md.md

@@ -0,0 +1,34 @@
+---
+id: E05-tasking-permissions/T001-update-agents-md
+status: planned
+objective: "Update AGENTS.md to remove agent 'set status: done' permission and add 'set status: in_progress' guidance with router update instruction"
+depends_on: []
+---
+
+# T001: Update AGENTS.md
+
+## Acceptance Criteria
+
+- Task Completion Protocol no longer says "Set the task frontmatter to `status: done`"
+- Protocol says "When starting implementation, set `status: in_progress`"
+- Protocol says "After setting `in_progress`, press `m` in the TUI to update the router"
+- The words "Set the task frontmatter to `status: done`" are removed or replaced
+- Audit Handoff Rule still says the agent updates router.md to `state: audit-pending` when all tasks are done (this is router state, not task state)
+
+## Implementation Plan
+
+- [ ] In AGENTS.md `## Task Completion Protocol`: replace "Set the task frontmatter to `status: done`" with appropriate guidance
+- [ ] In AGENTS.md `## Task Completion Protocol` step 7: keep router update for `audit-pending` (that's router state, not task status)
+- [ ] In AGENTS.md add note under `## Task Status Canon` about agent vs user capabilities
+- [ ] Run `make build && make test` to verify
+
+## Context Log
+
+Files read:
+- AGENTS.md
+- .savepoint/router.md
+- .savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Detail.md
+
+Estimated input tokens: 3000
+
+Notes:

package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T002-update-router-md.md

@@ -0,0 +1,30 @@
+---
+id: E05-tasking-permissions/T002-update-router-md
+status: planned
+objective: "Add agent router-update guidance to router.md task-building state and update current state for E05"
+depends_on: ["E05-tasking-permissions/T001-update-agents-md"]
+---
+
+# T002: Update Router.md
+
+## Acceptance Criteria
+
+- Router.md `task-building` state section includes guidance: "When starting work, set task `status: in_progress` and press `m` in TUI to update router task"
+- Current state in router.md updated to point to E05/T001
+- Router.md continues to describe `audit-pending` transition correctly (user confirms, router updates)
+
+## Implementation Plan
+
+- [ ] Edit `.savepoint/router.md` `task-building` state block to add agent router-update instruction
+- [ ] Update router.md `## Current state` yaml block to point to E05 tasking-permissions epic
+- [ ] Run `make build && make test` to verify
+
+## Context Log
+
+Files read:
+- .savepoint/router.md
+- .savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Detail.md
+
+Estimated input tokens: 2500
+
+Notes:

package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T003-update-design-md.md

@@ -0,0 +1,33 @@
+---
+id: E05-tasking-permissions/T003-update-design-md
+status: planned
+objective: "Revise Design.md Section 4 to document agent vs user task status capabilities"
+depends_on: ["E05-tasking-permissions/T001-update-agents-md"]
+---
+
+# T003: Update Design.md
+
+## Acceptance Criteria
+
+- Design.md Section 4 (`## 4. Status model & gates`) documents:
+  - Agent can only set `status: in_progress`
+  - Only user can set `status: done` or retreat
+  - Router update is explicit via TUI `m` key, not automatic on navigation
+- `last_audited` field updated (or not — this is documenting current design, not auditing)
+- No other sections modified
+
+## Implementation Plan
+
+- [ ] Edit `.savepoint/Design.md` Section 4 to add new permission row or note
+- [ ] Update `last_audited` in frontmatter
+- [ ] Run `make build && make test` to verify
+
+## Context Log
+
+Files read:
+- .savepoint/Design.md
+- .savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Detail.md
+
+Estimated input tokens: 2500
+
+Notes: