savepoint 1.0.1 → 1.0.3

package/.claude/settings.local.json

@@ -18,7 +18,21 @@
       "Bash(make build *)",
       "Bash(make test *)",
       "Bash(go get *)",
-      "Bash(go doc *)"
+      "Bash(go doc *)",
+      "Bash(make clean *)",
+      "Bash(make build-linux *)",
+      "Bash(./savepoint_test_bin --version)",
+      "PowerShell(go run *)",
+      "Bash(go run *)",
+      "PowerShell(Get-ChildItem -Path \"C:\\\\Users\\\\User\\\\Branding\\\\03-VIBE-LAB\\\\savepoint\" -Force | Select-Object Name, @{Name=\"Type\"; Expression={if\\($_.PSIsContainer\\){\"DIR\"}else{\"FILE\"}}} | Format-Table -AutoSize)",
+      "PowerShell(Get-ChildItem *)",
+      "Bash(Get-ChildItem -Path \"C:\\\\Users\\\\User\\\\Branding\\\\03-VIBE-LAB\\\\savepoint\\\\.savepoint\\\\releases\\\\v1.1\\\\epics\\\\E08-board-command\" -Recurse -Filter \"*.md\")",
+      "Bash(Select-Object -ExpandProperty FullName)",
+      "Bash(cmd\")",
+      "PowerShell(go build *)",
+      "PowerShell(go test *)",
+      "PowerShell(cd \"C:\\\\Users\\\\User\\\\Branding\\\\03-VIBE-LAB\\\\savepoint\"; $files = @\\(\"agent-skills\\\\savepoint-create-task\\\\SKILL.md\", \"templates\\\\project\\\\agent-skills\\\\savepoint-create-task\\\\SKILL.md\"\\); foreach \\($f in $files\\) { $bytes = [System.IO.File]::ReadAllBytes\\($f\\); Write-Host \"$f first bytes: $\\($bytes[0..9] -join ','\\) \\(CRLF: $\\($bytes[3] -eq 13\\)\\)\" })",
+      "PowerShell(cd \"C:\\\\Users\\\\User\\\\Branding\\\\03-VIBE-LAB\\\\savepoint\"; $others = Get-ChildItem agent-skills -Recurse -Filter \"SKILL.md\" | Where-Object { $_.DirectoryName -notmatch \"savepoint-create-task\" }; foreach \\($f in $others\\) { $bytes = [System.IO.File]::ReadAllBytes\\($f.FullName\\); Write-Host \"$\\($f.Name\\) dir=$\\($f.Directory.Name\\) CRLF=$\\($bytes[3] -eq 13\\)\" })"
     ]
   }
 }

package/.golangci.yml

@@ -0,0 +1,11 @@
+run:
+  timeout: 5m
+
+linters:
+  enable:
+    - unused
+    - errcheck
+    - staticcheck
+    - govet
+    - ineffassign
+    - gosimple

package/.savepoint/Design.md

@@ -1,7 +1,7 @@
 ---
 type: project-design
 status: active
-last_audited: E06-atari-noir-layout (2026-05-02)
+last_audited: v1.1/E14-structural-improvements
 ---
 
 # Savepoint — System Architecture
@@ -14,17 +14,20 @@ last_audited: E06-atari-noir-layout (2026-05-02)
 
 - **File-only.** No MCP server in v1. Agents read and edit Markdown + YAML files directly using their native file tools.
 - **Agent routing:** AGENTS.md → `.savepoint/router.md` → template prompts. See AGENTS.md Workflow section.
-- **Bundled Agent Skills:** Savepoint ships with custom skills (`draft-prd`, `system-design`, `create-plan`, `create-task`, `build-task`, `audit`) to enforce each phase of the state machine.
+- **Bundled Agent Skills:** Savepoint ships with custom skills (`savepoint-draft-prd`, `savepoint-system-design`, `savepoint-create-plan`, `savepoint-create-task`, `savepoint-build-task`, `savepoint-audit`) to enforce each phase of the state machine.
 - **Token-efficiency principle.**
   - Cold session bootstrap: ~5–7K tokens (one-time per conversation).
   - Per-task incremental: <2KB.
   - Audit: 5–15KB.
   - Anything that breaks these bounds violates the wedge.
-- **Go data-reader boundary:** established in epic `E02-data-readers` (2026-05-01). `internal/data` owns Savepoint file parsing and discovery for the Go implementation: task frontmatter models, markdown YAML extraction, router state parsing, config theme defaults, release/epic/task directory listing, and boundary error sentinels.
+- **Go data-reader boundary:** established in epic `E02-data-readers` (2026-05-01). `internal/data` owns Savepoint file parsing and discovery for the Go implementation: task frontmatter models, markdown YAML extraction, router state parsing, config theme defaults, release/epic/task directory listing, task lifecycle validation/defaulting, write-time status validation, and boundary error sentinels.
 - **Template assets** live under `templates/` with helpers in `src/templates/` (epic E04).
-- **Init command** (`savepoint init`) validates, scaffolds, prints prompt, clipboard, optional install (epic E05).
-- **Board command** (`savepoint board`) reads project state, renders the Atari-Noir TUI board, supports release/epic filtering, detail overlays, task status transitions with mtime-guarded writes, router priority markers, and fsnotify-based task auto-refresh (epic E06).
-- **Audit pipeline** (`savepoint audit`) resolves epic, skips, quality gates, snapshots, router transition, proposal review (epic E07).
+- **Init command** (`savepoint init`) validates target directories, scaffolds rendered copies of `templates/project/`, prints the rendered magic prompt, attempts best-effort clipboard copy, and optionally runs `npm install` after scaffolding (v1.1 E07).
+- **Board command** (`savepoint board`, and bare `savepoint`) reads project state, renders the Atari-Noir TUI board when stdout is a TTY, falls back to a deterministic plain table in non-TTY mode, 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), dedicated phase-colored Next Activity line below the header, sentence-boundary checklist rendering in task details, shared status glyph mapping for task cards and the epic sidebar, a forced ANSI256 Lipgloss color profile for board startup (v1.1 E03), a focusable wide-screen epic sidebar with purple epic focus, epic detail overlays, and status glyphs loaded from epic detail frontmatter (v1.1 E04), and an epic Detail/Audit tab switch that renders user-facing audit findings from `{epic}/E##-Audit.md` (v1.1 E06).
+- **Doctor command** (`savepoint doctor`, `savepoint doctor --epic E##`) runs read-only integrity diagnostics for config, router state, release/epic/task structure, frontmatter validity, acceptance criteria presence, dependencies, duplicate task IDs, stale audit files, orphaned task IDs, and configured quality gates. It prints a human-readable report with repair suggestions and exits 0 when clean, 1 when problems are diagnosed, and 2 for internal or invocation failures.
+- **Audit remediation baseline** (v1.1 E13) centralizes frontmatter/body splitting and line-ending normalization in `internal/data`, uses typed sentinel errors for doctor repair suggestions, applies a configurable `quality_gates.gate_timeout`, removes tracked build artifacts from source control, adds `.golangci.yml`, and moves board filesystem reads/writes behind Bubble Tea command messages while preserving direct file I/O inside command helpers.
+- **Structural improvement baseline** (v1.1 E14) groups board `Model` fields into focused embedded state structs, defines consumer-side board/doctor data-access interfaces, routes doctor orphan discovery through `Discover.ListRootDirs`, renders audit-tab hidden sections via exact heading matches, improves quality-gate shell tokenization for quoted and escaped arguments, removes the separate `TaskStatus` enum in favor of `ColumnType`, and adds `internal/testutil` for shared Go test fixtures.
+- **Agent audit workflow** is skill-driven, not a CLI pipeline. At `audit-pending`, a fresh audit agent writes one epic-local `E##-Audit.md`; the user reviews its Audit tab, then asks an agent to apply the admin proposal blocks, update the visible audit findings to reflect the applied outcome, and close the epic.
 
 ## 2. Directory layout
 
@@ -37,17 +40,13 @@ last_audited: E06-atari-noir-layout (2026-05-02)
     ├── visual-identity.md          ← design system; loaded conditionally for TUI work
     ├── router.md                   ← state-machine routing
     ├── config.yml                  ← theme, quality_gates, verify_strict
-    ├── audit/
-    │   └── {E##-epic}/
-    │       ├── snapshot.md
-    │       └── proposals/
-    │           └── proposals.md
     └── releases/
-        └── v1/
-            ├── PRD.md              ← release-scoped PRD
+        └── {release}/              ← e.g. v1, v1.1
+            ├── {release}-PRD.md    ← release-scoped PRD
             └── epics/
                 └── E##-{epic-name}/
-                    ├── Design.md   ← epic delta
+                    ├── E##-Detail.md   ← epic delta
+                    ├── E##-Audit.md    ← audit findings + admin apply proposals
                     └── tasks/
                         └── T001-slug.md
 ```
@@ -59,22 +58,24 @@ AGENTS.md at root (uppercase, cross-vendor spec). Design.md in `.savepoint/` (wo
 | Level        | Definition                                                                             |
 | ------------ | -------------------------------------------------------------------------------------- |
 | **Release**  | The thing being built. One PRD per release. v1 = MVP.                                  |
-| **Epic**     | A major feature within a release. Has its own Design.md (delta from project Design).   |
+| **Epic**     | A major feature within a release. Has its own E##-Detail.md (delta from project Design). |
 | **Task**     | Independently buildable. Objective-led. **Requires implementation plan before build.** |
 | **Sub-task** | Inline checklist item — _evidence of the implementation plan_, not standalone work.    |
 
 ## 4. Status model & gates
 
-Three statuses, with explicit gates:
+Three statuses, with explicit gates and ownership boundaries:
 
-| Status        | Meaning                    | Entry gate                                                      |
-| ------------- | -------------------------- | --------------------------------------------------------------- |
-| `planned`     | Ready to build             | plan section non-empty                                          |
-| `in_progress` | AI building                | all `depends_on` are `done`                                     |
-| `done`        | Complete for current scope | all implementation items checked; verification per project mode |
+| Status        | Meaning                    | Entry gate                                                      | Who may set it                         |
+| ------------- | -------------------------- | --------------------------------------------------------------- | -------------------------------------- |
+| `planned`     | Ready to build             | plan section non-empty                                          | User or planning workflow              |
+| `in_progress` | AI building                | all `depends_on` are `done`                                     | Agent when starting implementation     |
+| `done`        | Complete for current scope | all implementation items checked; verification per project mode | User only                              |
 
 - `blocked` is a **flag**, not a status — `in_progress` + `blocked: "reason"` is valid.
-- `done -> in_progress` is allowed so completed work can be reopened when follow-up work is required.
+- Agents may only advance a task into `in_progress`; they must not set `done` or retreat a task to an earlier status.
+- Only the user may set a task to `done` or retreat it from `done` to `in_progress` when follow-up work is required.
+- Router updates are explicit TUI actions: after setting a task to `in_progress`, the agent prompts the user to press `p` in the board to mark the focused task as router priority. Navigation alone must not change router task priority.
 - Verification mode: see `config.yml`.
 
 ## 5. Dependencies
@@ -83,13 +84,12 @@ Three statuses, with explicit gates:
 - `src/validation/dependencies.ts` detects duplicate task IDs, missing dependencies, and dependency cycles.
 - Cross-epic deps allowed but warned (signal that epic boundaries may be wrong).
 
-## 6. CLI surface (4 commands, no extras)
+## 6. CLI surface (3 commands, no extras)
 
 | Command                | Purpose                                                                           |
 | ---------------------- | --------------------------------------------------------------------------------- |
 | `savepoint init`       | Scaffold `.savepoint/`, print magic prompt to stdout + clipboard                  |
 | `savepoint board`      | Launch TUI; auto-falls-back to plain table on non-TTY                             |
-| `savepoint audit`      | Run audit pipeline (`--skip --reason`, `--epic`)                                  |
 | `savepoint doctor`     | Integrity check + ad-hoc quality-gate run + Layer-2 prompt for AI semantic review |
 | `--version` / `--help` | Standard global flags                                                             |
 
@@ -98,29 +98,29 @@ Three statuses, with explicit gates:
 - **Explicitly rejected:** `task new`, `epic new`, `release new`, `plan`, `next`, `status`, `task done`. All are file edits or TUI actions.
 
 **Names:** npm package `savepoint`; binary `savepoint`. No `vk` alias.
-## 7. Audit pipeline (6 steps)
+## 7. Agent audit workflow
 
 ```
-0. Quality Gates  — CLI runs configured commands. Halts on failure if block_on_failure: true.
-1. Snapshot       — CLI writes file tree (gitignore-respecting) + changed-files list. NO code contents.
-2. Diff Brief     — State flips to audit_pending: {E##-epic}. Magic prompt printed to user.
-3. Reconcile      — Agent reads epic Design + snapshot + scoped code. Writes one proposal bundle to
-                    .savepoint/audit/{E##-epic}/proposals.md.
-4. Review         — TUI shows side-by-side per-proposal diff. Approve / reject / edit each.
-5. Commit         — Approved proposals overwrite live files. Epic gets status: audited. Next epic unlocks.
+0. Quality Gates  — Build agent runs configured build/test gates before audit handoff.
+1. Audit Pending  — Router enters `audit-pending` for the completed epic.
+2. Reconcile      — Fresh audit agent reads router, epic detail, task files, Design.md, AGENTS.md, and scoped source/test files.
+3. Findings       — Agent writes exactly one `{epic}/E##-Audit.md`.
+4. Review         — User reviews the TUI Epic Detail Audit tab.
+5. Apply + Close  — After user approval, agent applies proposal blocks, updates the audit file's visible findings, marks the epic audited, updates `last_audited`, and advances router.
 ```
 
-- `audit_pending` is a **hard gate**: next epic's tasks cannot enter `in_progress` until prior epic is `audited`.
-- **High-divergence guard:** if a proposal changes >50% of the live file, TUI requires extra confirmation (threshold tunable in `config.yml`).
-- **Skip allowed** via `savepoint audit --skip --reason "..."`. Logged to `.savepoint/audit-log.md`. Permanent `⚠ skipped` badge in TUI.
-- **Proposal bundles** use delta-shaped edits: `Insert After`, `Replace`, or `Delete` blocks anchored to exact text.
-- **Quality review** is a section inside the proposal bundle.
-- **Snapshot availability is an audit precondition.** The router should enter `audit-pending` only after `.savepoint/audit/{E##-epic}/snapshot.md` exists.
+- `audit-pending` is a **hard gate**: next epic's tasks cannot enter `in_progress` until prior epic is `audited` or the user explicitly skips the audit.
+- `E##-Audit.md` has two user-facing sections: `## Main Findings` and `## Code Style Review`.
+- `## Main Findings` contains narrative audit findings only: AC verification, important drift, and notable risks. It must not contain file-specific replacement blocks.
+- `## Code Style Review` contains the 10 AGENTS.md code style checks.
+- `## Proposed Changes` contains admin/apply metadata using `### Target File`, `### Replace`, and `### With`. The TUI Audit tab intentionally does not render this section to avoid stale file-change details in the Epic Detail panel.
+- Apply/close must rewrite `## Main Findings` and `## Code Style Review` in the same `E##-Audit.md` so the TUI Audit tab shows resolved findings and remaining risks instead of stale pre-apply blockers. `## Proposed Changes` stays as the trace of what was applied unless the user asks otherwise.
+- There is no `savepoint audit` CLI pipeline in the active design. Audit is performed by agents using `agent-skills/savepoint-audit/SKILL.md`.
 
 Three layers:
 
 - **Layer 1 (mechanical):** user's chosen linter. Recommended: eslint+dependency-cruiser (TS), radon+pylint (Python), gocyclo+staticcheck (Go). Cross-language fallback: `lizard`. Quality gate config: see `.savepoint/config.yml`.
-- **Layer 2 (AI semantic review):** baked into the audit reconcile prompt. Outputs a quality-review section in the proposal bundle. **Advisory, not blocking.**
+- **Layer 2 (AI semantic review):** baked into the audit reconcile prompt. Outputs Main Findings and Code Style Review in the epic-local audit file. **Advisory, not blocking.**
 - **Layer 3:** `savepoint doctor` runs Layer 1 + prints Layer 2 prompt for ad-hoc use.
 
 ## 8. TUI
@@ -131,15 +131,19 @@ Acknowledged terminal limits: fonts, scanlines, glows, letter-spacing, mouse-dri
 
 **Render fallbacks:** 256-color → 16-color hard-coded → `NO_COLOR=1` monochrome with glyphs → non-TTY plain table.
 
-**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task detail, static Atari-Noir header/footer, full-width dividers, uniform black TUI backgrounds, and navigation hints. Non-TTY output remains a plain table fallback.
+**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task/epic-detail views, static Atari-Noir header/footer, full-width dividers, uniform black TUI backgrounds, and navigation hints. Active router `next_action` renders as a dedicated full-width line below the header with phase-colored `PLAN`, `BUILD`, or `AUDIT` prefix styling and truncates to terminal width. 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. Task detail implementation-plan checkboxes render once per semantic sentence, not once per hard-wrapped markdown line. 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. Task card and epic sidebar status glyphs share `internal/board/status.go`; task cards use explicit `Task.Status` when available and retain the legacy column/stage glyph fallback when it is not. Non-TTY output remains a plain table fallback.
 
 **Visual guardrail:** the terminal board intentionally uses one black background for Background, Surface, and Surface 2. Do not restore subtly different dark panel fills; depth should come from spacing, dividers, glyphs, and focused Atari Orange borders.
 
-**Board persistence and refresh:** task status transitions write canonical task frontmatter through `internal/data.WriteTaskStatus` with mtime conflict checks. The board watches `.savepoint/releases/` recursively with fsnotify and reloads task data after debounced file changes.
+**Terminal color policy:** the board must use a deterministic Lipgloss color profile and one canonical terminal black across truecolor, ANSI256, and ANSI fallbacks. In 256-color mode, Background, Surface, and Surface 2 must map to the same actual black value, not adjacent dark-gray values. Full-screen/root surfaces may paint that one black background for consistency; nested task cards, task text, glyphs, tags, metadata, and router-priority labels should remain foreground-only unless a component explicitly owns a filled visual region. This prevents padded text from creating gray bars in terminals such as PowerShell, Windows Terminal, VS Code terminal, and Warp.
+
+**Border policy:** focus must not change geometry or introduce terminal-specific broken border rendering. Use one consistent box-border family across columns, cards, and overlays. If rounded borders render as dash bars or broken segments in Warp, prefer the single-line border style already allowed by `.savepoint/visual-identity.md`; do not mix rounded and single-line borders as an ad-hoc per-component workaround.
+
+**Board persistence and refresh:** task status transitions write canonical task frontmatter through `internal/data.WriteTaskStatus` with mtime conflict checks. Board update handlers dispatch filesystem reads and writes through Bubble Tea command helpers (`routerWriteMsg`, `taskWriteMsg`, `epicDetailMsg`, `auditContentMsg`, and `errorMsg`) so `Update()` remains an event/message reducer. 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. The `p` key explicitly writes the focused non-done task to router state as `task-building`; it does not infer `audit-pending` from task position. Epic status glyphs are cached from each epic's `E##-Detail.md` frontmatter and shown in the wide epic sidebar only.
 
 **Implementation modules:** see AGENTS.md Codebase Map.
 
-**Keybindings:** arrow/vim navigation, enter advances, backspace retreats, r/R refreshes, a/A exits toward audit review when proposals exist, q quits.
+**Keybindings:** arrow/vim navigation, enter opens focused task detail, space advances, backspace retreats, `p` marks the focused non-done task as router priority, `r`/`R` opens release selection or refreshes where supported, `?` opens help, and `q` quits or closes overlays.
 
 ## 9. Concurrency
 
@@ -169,12 +173,14 @@ All failure modes are diagnosed by `savepoint doctor`. Doctor diagnoses and prop
 
 ## 12. Distribution & build
 
-> Audit note: the live repository is transitioning from the documented TypeScript/Node implementation to a Go module (`github.com/opencode/savepoint`). The architecture document still contains substantial TypeScript-era implementation detail and should be reconciled as Go epics are audited.
+> Audit note: the live repository is now a Go module (`github.com/opencode/savepoint`). Remaining TypeScript-era distribution details should be removed as Go epics are audited.
 
 - **License:** MIT.
-- **Install:** primary `npx savepoint init`, persistent `npm i -g savepoint` → `savepoint`.
-- **Runtime:** Node 20.10+ LTS, ESM-only, no native deps. macOS / Linux / Windows-Terminal.
-- **Repo:** single package. TypeScript strict. `tsup` build → `dist/`. Bin `dist/cli.js` shebanged.
+- **Runtime:** Go CLI binary. Source builds with `go build`; tests run with `go test ./...`.
+- **Local build:** `make build` delegates to `internal/buildtool`, builds `savepoint` or `savepoint.exe`, and injects `main.version` from `VERSION` or the latest git tag.
+- **Cross-platform builds:** `make build-all` cross-compiles linux-amd64, linux-arm64, darwin-amd64, and darwin-arm64 raw binaries into `dist/{platform}-{arch}/savepoint`.
+- **Artifacts:** `make dist` creates versioned `.tar.gz` archives in `dist/` for the Linux and Darwin targets using Go archive APIs, not shell `tar`.
+- **Smoke validation:** `make smoke-test` builds the local binary and runs `--version` as a headless exit-0 check.
 - **No telemetry.** Ever.
 
 ## 13. Testing

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

@@ -27,7 +27,7 @@ depends_on: []
 Files read:
 
 - `.savepoint/router.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/Design.md`
+- `.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
 - `.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md`
 - `go.mod`
 - `go.sum`

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/{Design.md → E01-Detail.md}

@@ -1,6 +1,6 @@
 ---
 type: epic-design
-status: planned
+status: audited
 ---
 
 # Epic E01: TUI Optimisation
@@ -18,6 +18,14 @@ Performance, layout robustness, and structural improvements for the board TUI. F
 - 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 |

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/{T007-next-activity-header.md → T001-next-activity-header.md}

@@ -1,11 +1,11 @@
 ---
-id: E01-tui-optimisation/T007-next-activity-header
-status: planned
+id: E01-tui-optimisation/T001-next-activity-header
+status: done
 objective: "Show Next Activity indicator in the TUI header bar, right-aligned, displaying the current router state"
 depends_on: []
 ---
 
-# T007: Next Activity Header Display
+# T001: Next Activity Header Display
 
 ## Acceptance Criteria
 
@@ -21,18 +21,18 @@ depends_on: []
 
 ## Implementation Plan
 
-- [ ] Add `HeaderRight` style to `internal/styles/styles.go` (dim foreground, right-aligned)
-- [ ] Create `FormatNextActivity(state *data.RouterState) string` helper in `internal/board/view.go` that:
+- [x] Add `HeaderRight` style to `internal/styles/styles.go` (dim foreground, right-aligned)
+- [x] Create `FormatNextActivity(state *data.RouterState) string` helper in `internal/board/view.go` that:
   - Parses router state and formats compact string based on state type
   - Truncates to max 20 chars using `xansi.Truncate` with ellipsis
-- [ ] Update `view.go` `View()` method — modify header rendering:
+- [x] Update `view.go` `View()` method — modify header rendering:
   - Split header into left (icon + "SAVEPOINT") and right sections
   - Use `lipgloss.PlaceHorizontal` or manual string construction to position Next Activity on right
   - Maintain existing `HeaderFrame` width and padding
-- [ ] Update `main.go` or board initialization to read router state and populate `Model` with parsed state
-- [ ] Add test in `internal/board/view_test.go` for Next Activity rendering at various widths
-- [ ] Add test for `FormatNextActivity` covering all router states and truncation behavior
-- [ ] Run `make build && make test` — all gates pass
+- [x] Update `main.go` or board initialization to read router state and populate `Model` with parsed state
+- [x] Add test in `internal/board/view_test.go` for Next Activity rendering at various widths
+- [x] Add test for `FormatNextActivity` covering all router states and truncation behavior
+- [x] Run quality gates — `make build && make test` unavailable in this shell; equivalent `go build ./...` and `go test ./...` pass
 
 ## Context Log
 
@@ -43,8 +43,7 @@ Files read:
 - `internal/data/router.go`
 - `internal/board/view_test.go`
 - `.savepoint/router.md`
-- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md`
-- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T006-column-and-detail-scrolling.md`
+- `.savepoint/releases/v1.1/epics/E03-header-activity/E03-Detail.md`
 
 Estimated input tokens: 2800
 
@@ -53,3 +52,5 @@ Notes:
 - Router state already available via `m.RouterTask` in Model — may need to add `*data.RouterState` field or parse separately
 - Truncation uses same `xansi` package already imported in view.go
 - Max 20 char constraint keeps header clean at all terminal widths
+- Audit must-fix applied: stale implementation checklist items were ticked after verifying the implemented source and tests.
+- Quality gates verified during audit: `go build ./...` passed; `go test ./...` passed.

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T002-rename-epic-design-files.md

@@ -1,6 +1,6 @@
 ---
 id: E01-tui-optimisation/T002-rename-epic-design-files
-status: planned
+status: done
 objective: "Rename all epic Design.md files to E##-Detail.md convention"
 depends_on: []
 ---
@@ -17,14 +17,14 @@ depends_on: []
 
 ## Implementation Plan
 
-- [ ] Rename `.savepoint/releases/v1/epics/E01-scaffolding/Design.md` → `E01-Detail.md`
-- [ ] Rename `.savepoint/releases/v1/epics/E02-architecture/Design.md` → `E02-Detail.md`
-- [ ] Rename `.savepoint/releases/v1/epics/E03-board-tui-core/Design.md` → `E03-Detail.md`
-- [ ] Rename `.savepoint/releases/v1/epics/E04-board-components/Design.md` → `E04-Detail.md`
-- [ ] Rename `.savepoint/releases/v1/epics/E05-phase-transitions/Design.md` → `E05-Detail.md`
-- [ ] Rename `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md` → `E06-Detail.md`
-- [ ] Rename `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md` → `E01-Detail.md`
-- [ ] Rename `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/Design.md` → `E02-Detail.md`
+- [x] Rename `.savepoint/releases/v1/epics/E01-go-setup/Design.md` → `E01-Detail.md`
+- [x] Rename `.savepoint/releases/v1/epics/E02-data-readers/Design.md` → `E02-Detail.md`
+- [x] Rename `.savepoint/releases/v1/epics/E03-board-tui-core/Design.md` → `E03-Detail.md`
+- [x] Rename `.savepoint/releases/v1/epics/E04-board-components/Design.md` → `E04-Detail.md`
+- [x] Rename `.savepoint/releases/v1/epics/E05-phase-transitions/Design.md` → `E05-Detail.md`
+- [x] Rename `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md` → `E06-Detail.md`
+- [x] Rename `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md` → `E01-Detail.md`
+- [x] Rename `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/Design.md` → `E02-Detail.md`
 
 ## Context Log
 

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T003-rename-release-prd.md

@@ -1,6 +1,6 @@
 ---
 id: E01-tui-optimisation/T003-rename-release-prd
-status: planned
+status: done
 objective: "Rename release PRD.md to version-anchored convention"
 depends_on: []
 ---
@@ -15,7 +15,7 @@ depends_on: []
 
 ## Implementation Plan
 
-- [ ] Rename `.savepoint/releases/v1/PRD.md` → `v1-PRD.md`
+- [x] Rename `.savepoint/releases/v1/PRD.md` → `v1-PRD.md`
 
 ## Context Log
 

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T004-update-instruction-files.md

@@ -1,6 +1,6 @@
 ---
 id: E01-tui-optimisation/T004-update-instruction-files
-status: planned
+status: done
 objective: "Update all instruction files to reference new naming convention"
 depends_on:
   - E01-tui-optimisation/T002-rename-epic-design-files
@@ -26,17 +26,17 @@ depends_on:
 
 ## Implementation Plan
 
-- [ ] Update `.savepoint/router.md` — all epic `Design.md` → `E##-Detail.md`, `PRD.md` → `v1-PRD.md`
-- [ ] Update `AGENTS.md` — epic design file path pattern
-- [ ] Update `agent-skills/savepoint-create-plan/SKILL.md`
-- [ ] Update `agent-skills/savepoint-system-design/SKILL.md`
-- [ ] Update `agent-skills/savepoint-build-task/SKILL.md`
-- [ ] Update `agent-skills/savepoint-audit/SKILL.md`
-- [ ] Update `agent-skills/savepoint-create-task/SKILL.md`
-- [ ] Update `templates/project/AGENTS.md`
-- [ ] Update `templates/prompts/task-building.prompt.md`
-- [ ] Update `templates/prompts/task-planning.prompt.md`
-- [ ] Update `templates/prompts/task-breakdown.prompt.md`
+- [x] Update `.savepoint/router.md` — all epic `Design.md` → `E##-Detail.md`, `PRD.md` → `v1-PRD.md`
+- [x] Update `AGENTS.md` — epic design file path pattern
+- [x] Update `agent-skills/savepoint-create-plan/SKILL.md`
+- [x] Update `agent-skills/savepoint-system-design/SKILL.md`
+- [x] Update `agent-skills/savepoint-build-task/SKILL.md`
+- [x] Update `agent-skills/savepoint-audit/SKILL.md`
+- [x] Update `agent-skills/savepoint-create-task/SKILL.md`
+- [x] Update `templates/project/AGENTS.md`
+- [x] Update `templates/prompts/task-building.prompt.md`
+- [x] Update `templates/prompts/task-planning.prompt.md`
+- [x] Update `templates/prompts/task-breakdown.prompt.md`
 
 ## Context Log
 
@@ -48,3 +48,4 @@ Estimated input tokens: 800
 Notes:
 - Only change path references, do not alter surrounding content
 - Root Design.md references stay as-is
+- Audit must-fix applied: stale implementation checklist items were ticked after verifying the referenced instruction-file updates were present in the completed task scope.

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T005-update-cross-references.md

@@ -1,6 +1,6 @@
 ---
 id: E01-tui-optimisation/T005-update-cross-references
-status: planned
+status: done
 objective: "Update all cross-references in task files and audit snapshots"
 depends_on:
   - E01-tui-optimisation/T002-rename-epic-design-files
@@ -19,18 +19,18 @@ depends_on:
 
 ## Implementation Plan
 
-- [ ] Find all task files with "Design.md" in content and update epic-level references to `E##-Detail.md`
-- [ ] Update `.savepoint/audit/E02-data-readers/proposals.md`
-- [ ] Update `.savepoint/audit/E03-board-tui-core/proposals.md`
-- [ ] Update `.savepoint/audit/E03-board-tui-core/snapshot.md`
-- [ ] Update `.savepoint/audit/E04-board-components/proposals.md`
-- [ ] Update `.savepoint/audit/E04-board-components/snapshot.md`
-- [ ] Update `.savepoint/audit/E05-phase-transitions/proposals.md`
-- [ ] Update `.savepoint/audit/E05-phase-transitions/snapshot.md`
-- [ ] Update `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T*.md` files
-- [ ] Update `.savepoint/releases/v1/epics/E04-board-components/tasks/T*.md` files
-- [ ] Update `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T*.md` files
-- [ ] Run grep verification: no `epics/.*Design\.md` references remain
+- [x] Find all task files with "Design.md" in content and update epic-level references to `E##-Detail.md`
+- [x] Update `.savepoint/audit/E02-data-readers/proposals.md`
+- [x] Update `.savepoint/audit/E03-board-tui-core/proposals.md`
+- [x] Update `.savepoint/audit/E03-board-tui-core/snapshot.md`
+- [x] Update `.savepoint/audit/E04-board-components/proposals.md`
+- [x] Update `.savepoint/audit/E04-board-components/snapshot.md`
+- [x] Update `.savepoint/audit/E05-phase-transitions/proposals.md`
+- [x] Update `.savepoint/audit/E05-phase-transitions/snapshot.md`
+- [x] Update `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T*.md` files
+- [x] Update `.savepoint/releases/v1/epics/E04-board-components/tasks/T*.md` files
+- [x] Update `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T*.md` files
+- [x] Run grep verification: no `epics/.*Design\.md` references remain
 
 ## Context Log
 
@@ -42,3 +42,4 @@ Estimated input tokens: 1200
 Notes:
 - Only update epic-level Design.md paths (e.g., `E03-board-tui-core/Design.md` → `E03-Detail.md`)
 - Root `.savepoint/Design.md` references must NOT be changed
+- Audit must-fix applied: stale implementation checklist items were ticked after verifying the completed cross-reference cleanup task scope.