savepoint 1.0.1 → 1.0.3

package/.savepoint/audit/E01-scaffolding/proposals/quality-review.md

@@ -1,101 +0,0 @@
----
-type: quality-review
-epic: E01-scaffolding
-reviewed: 2026-04-27
-advisory: true
----
-
-# Quality Review: E01-scaffolding
-
-Semantic review of the scaffolded source against the 10 Code Style rules from `AGENTS.md`. Advisory only — no blocking issues.
-
----
-
-## Rule-by-rule findings
-
-### 1. One job per file ✓
-
-`src/cli.ts` handles argument dispatch and output. `src/version.ts` is a single export. No file does two things.
-
-### 2. One-sentence rule ✓
-
-`printHelp()` — prints the placeholder help banner. `main()` — dispatches on argv and calls the appropriate output function. Both are one-sentence describable.
-
-### 3. Test what branches ⚠ advisory
-
-`src/cli.ts` has a branch on `command === "--version"`. The smoke test in `test/smoke.test.ts` only covers `src/version.ts`. The CLI dispatch logic is untested.
-
-This is acceptable at scaffold stage — the branches contain only placeholder output and will be replaced in `cli-foundation`. Flag for that epic: when real dispatch lands, cover every branch.
-
-### 4. Types are documentation ✓
-
-No `any` anywhere in source or test. Return types are declared (`void`). ESLint is configured to error on `@typescript-eslint/no-explicit-any`.
-
-### 5. Build, don't speculate ✓
-
-No abstraction layers, registries, or plugin systems. Placeholder CLI is minimal: two functions and a `main()` call. Nothing exists for hypothetical future behavior.
-
-### 6. Errors at boundaries ✓ (n/a at scaffold)
-
-No real system boundaries in placeholder code. The CLI entrypoint reads only `process.argv`, which cannot throw. Acceptable for a placeholder.
-
-### 7. One source of truth ✓
-
-Version string is declared once in `src/version.ts` and imported by `src/cli.ts`. `package.json` also contains `"version": "0.1.0"` — this is expected (npm requires it there), not a violation. When the CLI reads its own version at runtime, it imports from `src/version.ts`, not from `package.json` directly.
-
-> **Recommendation for `cli-foundation`:** consider whether `version.ts` should derive from `package.json` at build time (via `tsup` banner injection or a build-time const) to eliminate the manual sync requirement. Not urgent at `0.1.0`.
-
-### 8. Comments explain WHY ✓
-
-No comments in any source file. Config files have no inline comments. Good.
-
-### 9. Content in data files ✓ (n/a at scaffold)
-
-No user-facing content exists yet. Config is in conventional JSON/TS config files.
-
-### 10. Small diffs ✓
-
-Epic split into 5 tasks with clear separation: package metadata → TypeScript build → test runner → lint/format → verification. Each task touched a minimal set of files with declared dependencies.
-
----
-
-## Structural observations
-
-### Dual vitest config files
-
-`vitest.config.ts` and `vitest.config.js` are identical. The `.js` variant is the one actually used by `npm test` (required for `--configLoader runner`). The `.ts` variant is unused but exists as the "source of truth" for IDE tooling and type checking.
-
-**Recommendation:** document this in a comment in `vitest.config.ts`, or remove it and keep only `.js`. The dual-file situation will confuse future contributors who edit `.ts` expecting it to take effect.
-
-### scripts/vitest-preload.cjs complexity
-
-The preload script stubs two unrelated things: a `net use` child_process call (Windows network drive detection in Vitest's environment) and `esbuild.transform`/`transformSync` (a secondary Windows compat issue). The stubs are correct and well-structured.
-
-**Recommendation:** add a single-line comment per stub explaining the specific Windows issue being worked around (bug reference or symptom description). The WHY is not obvious — a future contributor would not know whether these stubs are still needed after a Vitest upgrade.
-
-### test/smoke.test.ts include pattern
-
-`vitest.config.js` uses `include: ["test/**/*.test.js"]` but the actual test file is `smoke.test.ts`. This works because Vitest transforms TypeScript to JS before matching, but the pattern is misleading.
-
-**Recommendation:** change include to `["test/**/*.test.ts"]` to match what actually exists in the repo.
-
----
-
-## Must Fix Before Close
-
-None.
-
-## Carry Forward
-
-- Add CLI branch tests when real dispatch is implemented in `E03-cli-foundation`.
-- Decide in `E03-cli-foundation` whether `src/version.ts` should derive from `package.json`.
-
-## Already Fixed
-
-- `vitest.config.ts` now documents the dual-config setup.
-- `scripts/vitest-preload.cjs` now explains the Windows `net use` and esbuild workarounds.
-- Vitest include patterns now match `test/**/*.test.ts`.
-
-## Summary
-
-No blocking issues remain for `E01-scaffolding`.

package/.savepoint/audit/E01-scaffolding/snapshot.md

@@ -1,54 +0,0 @@
----
-type: audit-snapshot
-epic: E01-scaffolding
-created: 2026-04-27
----
-
-# Audit Snapshot: E01-scaffolding
-
-All files are new — this is the first auditable baseline.
-
-## Source file tree
-
-```
-src/
-  cli.ts                    — CLI entrypoint; placeholder help/version output
-  version.ts                — single export for package version string
-test/
-  smoke.test.ts             — Vitest smoke test asserting exported version
-scripts/
-  vitest-preload.cjs        — Windows runner workaround (stubs net use + esbuild)
-```
-
-## Config / metadata files
-
-| Path                | Purpose                                                            |
-| ------------------- | ------------------------------------------------------------------ |
-| `package.json`      | Package name, bin mapping, scripts, devDependencies                |
-| `package-lock.json` | Locked dependency graph                                            |
-| `tsconfig.json`     | Strict NodeNext TypeScript compiler settings                       |
-| `tsup.config.ts`    | Build entry and output config (ESM, node20)                        |
-| `vitest.config.ts`  | Vitest config (TypeScript source)                                  |
-| `vitest.config.js`  | Vitest config (JS copy used by npm test via --configLoader runner) |
-| `eslint.config.js`  | Flat ESLint config — rejects `any` in TypeScript                   |
-| `.prettierrc.json`  | Prettier rules (double quotes, trailing commas)                    |
-| `.prettierignore`   | Excludes dist/, coverage/, node_modules/ from formatting           |
-| `.gitignore`        | Excludes generated artifacts and local env files                   |
-| `README.md`         | Minimal development README                                         |
-| `LICENSE`           | MIT license                                                        |
-
-## Quality gates (all passed)
-
-- `npm run build` ✓
-- `npm run typecheck` ✓
-- `npm run lint` ✓
-- `npm run format:check` ✓
-- `npm test` ✓
-
-## Deviations from epic Design
-
-| Item                         | Status | Note                                                                        |
-| ---------------------------- | ------ | --------------------------------------------------------------------------- |
-| `vitest.config.js`           | extra  | Duplicate of `.ts` variant; required for `--configLoader runner` on Windows |
-| `scripts/vitest-preload.cjs` | extra  | Windows-specific: stubs `net use` child_process call and esbuild transforms |
-| `.prettierignore`            | extra  | Not listed in Design but conventional; consistent with `.gitignore`         |

package/.savepoint/audit/E02-data-model/snapshot.md

@@ -1,128 +0,0 @@
----
-type: audit-snapshot
-epic: E02-data-model
-created: 2026-04-27
-manual: true
----
-
-# Audit Snapshot: E02-data-model
-
-Manual snapshot generated because `savepoint audit` is not implemented yet.
-
-## Source file tree
-
-```
-src/
-  domain/
-    config.ts       - config defaults and typed project config model
-    epic.ts         - epic Design frontmatter model
-    ids.ts          - release, epic, and task ID parsing/formatting
-    release.ts      - release PRD frontmatter model
-    router.ts       - router state model and validation
-    status.ts       - task status values and transition validation
-    task.ts         - task frontmatter and document validation
-  fs/
-    markdown.ts     - markdown/frontmatter read boundary with path-aware errors
-    project.ts      - .savepoint root and scoped path helpers
-  readers/
-    config.ts       - read-only config.yml reader
-    epic.ts         - read-only epic Design reader
-    release.ts      - read-only release PRD reader
-    router.ts       - read-only router Current state reader
-    tasks.ts        - epic task-set reader with graph validation
-  validation/
-    dependencies.ts - duplicate ID, missing dependency, and cycle detection
-test/
-  domain/           - unit tests for config, epic, IDs, release, router, status, task
-  fs/               - unit tests for markdown and project helpers
-  readers/          - unit tests for config, epic, release, router, task-set readers
-  validation/       - unit tests for dependency graph validation
-```
-
-## Config / metadata changes
-
-| Path                     | Purpose                                                        |
-| ------------------------ | -------------------------------------------------------------- |
-| `package.json`           | Adds `js-yaml` runtime dependency and `@types/js-yaml`.        |
-| `package-lock.json`      | Locks the new YAML parser dependency graph.                    |
-| `.prettierignore`        | Excludes `.claude/` from Prettier traversal.                   |
-| `.savepoint/router.md`   | Manually advances E02 to `audit-pending`.                      |
-| `AGENTS.md`              | Workflow text was tightened during E02 planning/building.      |
-| `README.md`              | Marketing/readme copy changed outside the E02 runtime layer.   |
-| `.savepoint/metrics/*`   | Context-benchmark notes changed outside the E02 runtime layer. |
-| `E02-data-model/tasks/*` | Seven planned and completed E02 task files.                    |
-
-## Changed files
-
-Tracked modified files:
-
-- `.prettierignore`
-- `.savepoint/metrics/context-bench.md`
-- `.savepoint/router.md`
-- `AGENTS.md`
-- `README.md`
-- `package-lock.json`
-- `package.json`
-
-New E02 files:
-
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T001-domain-ids-status.md`
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T002-markdown-frontmatter-boundary.md`
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T003-task-documents.md`
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T004-release-epic-router-config-readers.md`
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T005-dependency-validation.md`
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T006-epic-task-set-reader.md`
-- `.savepoint/releases/v1/epics/E02-data-model/tasks/T007-quality-gates.md`
-- `src/domain/config.ts`
-- `src/domain/epic.ts`
-- `src/domain/ids.ts`
-- `src/domain/release.ts`
-- `src/domain/router.ts`
-- `src/domain/status.ts`
-- `src/domain/task.ts`
-- `src/fs/markdown.ts`
-- `src/fs/project.ts`
-- `src/readers/config.ts`
-- `src/readers/epic.ts`
-- `src/readers/release.ts`
-- `src/readers/router.ts`
-- `src/readers/tasks.ts`
-- `src/validation/dependencies.ts`
-- `test/domain/config.test.ts`
-- `test/domain/epic.test.ts`
-- `test/domain/ids.test.ts`
-- `test/domain/release.test.ts`
-- `test/domain/router.test.ts`
-- `test/domain/status.test.ts`
-- `test/domain/task.test.ts`
-- `test/fs/markdown.test.ts`
-- `test/fs/project.test.ts`
-- `test/readers/config.test.ts`
-- `test/readers/epic.test.ts`
-- `test/readers/release.test.ts`
-- `test/readers/router.test.ts`
-- `test/readers/tasks.test.ts`
-- `test/validation/dependencies.test.ts`
-
-Local untracked file outside E02 scope:
-
-- `.claude/settings.local.json`
-
-## Quality gates
-
-- `npm run build` passed.
-- `npm run typecheck` passed.
-- `npm run lint` passed.
-- `npm run format:check` initially failed on E02 task markdown; after Prettier formatting, it passed.
-- `npm test` passed outside the sandbox: 16 files, 176 tests. Inside the sandbox it failed with `spawn EPERM` while Vitest/esbuild tried to start a child process.
-
-## Deviations from epic Design
-
-| Item                  | Status | Note                                                                                        |
-| --------------------- | ------ | ------------------------------------------------------------------------------------------- |
-| Audit snapshot        | manual | Generated by the agent because the E07 audit CLI does not exist yet.                        |
-| Router state          | manual | Advanced directly to `audit-pending` for E02 because the CLI transition does not exist yet. |
-| `done` transitions    | fixed  | `done -> review` is allowed so completed work can be reopened for audit-stale rechecks.     |
-| Config accent values  | fixed  | Config defaults ignore non-string custom accent values before merging.                      |
-| README/metrics edits  | extra  | Present in working tree but not part of the E02 data-model runtime layer.                   |
-| `.claude/` local file | extra  | Local untracked settings are ignored by Prettier but not by Git.                            |

package/.savepoint/audit/E02-data-readers/proposals.md

@@ -1,123 +0,0 @@
-# Audit Proposals: E02-data-readers
-
-## Target File
-
-`.savepoint/Design.md`
-
-## Replace
-
-```md
-- **Template asset boundary:** established in epic `E04-templates-and-prompts` (2026-04-27). Project scaffolding and workflow prompts now live as versioned markdown/YAML assets under `templates/`, with small TypeScript helpers in `src/templates/` for manifest lookup, path resolution, loading, and interpolation.
-```
-
-## With
-
-```md
-- **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, and release/epic/task directory listing.
-- **Template asset boundary:** established in epic `E04-templates-and-prompts` (2026-04-27). Project scaffolding and workflow prompts now live as versioned markdown/YAML assets under `templates/`, with small TypeScript helpers in `src/templates/` for manifest lookup, path resolution, loading, and interpolation.
-```
-
-## Target File
-
-`.savepoint/Design.md`
-
-## Replace
-
-```md
-## 12. Distribution & build
-```
-
-## With
-
-```md
-## 12. Distribution & build
-
-> Audit note: the live repository is transitioning from the documented TypeScript/Node implementation to a Go module (`github.com/opencode/savepoint`). The architecture document still contains substantial TypeScript-era implementation detail and should be reconciled as Go epics are audited.
-```
-
-## Target File
-
-`AGENTS.md`
-
-## Replace
-
-```md
-| `src/domain/config.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Config defaults and typed project config model                                                       |
-| `src/domain/epic.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Epic Design frontmatter model and validation                                                         |
-| `src/domain/ids.ts`                  | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Release, epic, and task ID parsing and formatting                                                    |
-| `src/domain/release.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Release PRD frontmatter model and validation                                                         |
-| `src/domain/router.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Router state values and validation                                                                   |
-| `src/domain/status.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Task status values and transition validation                                                         |
-| `src/domain/task.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Task frontmatter/document model and validation                                                       |
-| `src/fs/markdown.ts`                 | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Markdown/frontmatter reader with path-aware boundary errors                                          |
-| `src/fs/project.ts`                  | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Project root discovery and scoped `.savepoint` path helpers                                          |
-| `src/readers/config.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only `config.yml` reader with defaults                                                          |
-| `src/readers/epic.ts`                | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only epic Design reader                                                                         |
-| `src/readers/release.ts`             | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only release PRD reader                                                                         |
-| `src/readers/router.ts`              | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Read-only router Current state reader                                                                |
-| `src/readers/tasks.ts`               | [E02-data-model](.savepoint/releases/v1/epics/E02-data-model/Design.md)                       | Epic task-set reader with graph validation                                                           |
-```
-
-## With
-
-```md
-| `internal/data/task.go`              | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Task, column, progress stage, dependency, and metadata structs for Go data readers                   |
-| `internal/data/parser.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Markdown YAML frontmatter extraction and task frontmatter parsing                                    |
-| `internal/data/router.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Router current-state YAML block extraction and parsing                                               |
-| `internal/data/config.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Savepoint config/theme parsing with default theme fallback                                           |
-| `internal/data/discover.go`          | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | `.savepoint` root discovery and release, epic, and task directory listing                            |
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E02-data-readers/Design.md`
-
-## Insert After
-
-```md
-## Components and files
-```
-
-## With
-
-```md
-## Implemented As
-
-- `internal/data/task.go` defines task metadata, column, progress stage, dependency, and progress structs.
-- `internal/data/parser.go` extracts YAML frontmatter from markdown and currently maps the task ID and objective into `Task`.
-- `internal/data/router.go` extracts and parses the `## Current state` fenced YAML block from `router.md`.
-- `internal/data/config.go` reads `config.yml` theme values and falls back to a default theme when the config is missing.
-- `internal/data/discover.go` finds the `.savepoint` root and lists release, epic, and task directories in stable order.
-
-## Deltas From Plan
-
-- The planned `internal/data/errors.go` was not created; errors currently use formatted `error` values.
-- `ParseTaskFile` does not yet populate `Column`, `Stage`, `DependsOn`, `Priority`, `Points`, `Tags`, `Acceptance`, or `Notes` from YAML frontmatter.
-- The parser uses a regular expression rather than a line-based frontmatter scanner.
-- Config malformed YAML currently falls back to defaults instead of surfacing a parse error.
-```
-
-## Quality Review
-
-## Must Fix Before Close
-
-All close blockers resolved in audit closeout.
-
-## Must Fix Before Next Epic
-
-All next-epic blockers resolved in audit closeout.
-
-## Carry Forward
-
-- `.savepoint/Design.md` and `AGENTS.md` still mostly describe the previous TypeScript implementation. The Go architecture should be reconciled incrementally as each Go epic is audited.
-
-## Already Fixed
-
-- `go test ./internal/data/...` passed during audit.
-- `go test ./...` passed during audit.
-- `ParseTaskFile` now maps task frontmatter fields including `status`, `phase`, `depends_on`, priority, points, tags, acceptance, notes, release, epic, and progress.
-- `ConfigReader.Read` now returns defaults only for missing config files and returns malformed YAML/read errors.
-- Discovery tests now use temporary fixtures instead of the live repository tree.
-- Parser tests now assert task metadata mapping and malformed YAML behavior.
-- `internal/data/errors.go` now provides data-reader boundary error sentinels.
-- E02 task files now include context logs.

package/.savepoint/audit/E02-data-readers/snapshot.md

@@ -1,54 +0,0 @@
----
-type: audit-snapshot
-epic: E02-data-readers
-created: 2026-05-01
-mode: manual
----
-
-# Audit Snapshot: E02-data-readers
-
-Manual snapshot created because `.savepoint/audit/E02-data-readers/snapshot.md` was missing while the router was already in `audit-pending`.
-
-## Router State
-
-```yaml
-state: audit-pending
-release: v1
-epic: E02-data-readers
-task: ~
-next_action: "Audit E02-data-readers: all 5 tasks done. Start fresh session for audit."
-```
-
-## Epic Scope
-
-- `.savepoint/releases/v1/epics/E02-data-readers/Design.md`
-- `.savepoint/releases/v1/epics/E02-data-readers/tasks/T001-task-struct.md`
-- `.savepoint/releases/v1/epics/E02-data-readers/tasks/T002-frontmatter-parser.md`
-- `.savepoint/releases/v1/epics/E02-data-readers/tasks/T003-router-reader.md`
-- `.savepoint/releases/v1/epics/E02-data-readers/tasks/T004-config-reader.md`
-- `.savepoint/releases/v1/epics/E02-data-readers/tasks/T005-discovery.md`
-
-## Changed Files In Scope
-
-- `internal/data/task.go`
-- `internal/data/parser.go`
-- `internal/data/router.go`
-- `internal/data/config.go`
-- `internal/data/discover.go`
-- `internal/data/task_test.go`
-- `internal/data/parser_test.go`
-- `internal/data/router_test.go`
-- `internal/data/config_test.go`
-- `internal/data/discover_test.go`
-- `go.mod`
-- `go.sum`
-
-## Verification Observed During Audit
-
-- `go test ./internal/data/...` passed.
-- `go test ./...` passed.
-
-## Notes
-
-- The repository is in a broad TypeScript-to-Go transition. Many tracked TypeScript files are deleted or replaced, but this snapshot is intentionally scoped to the E02 data-reader epic.
-- Task context logs are mostly absent except `T005-discovery.md`; this is audit process drift, not a source-code blocker.

package/.savepoint/audit/E03-board-tui-core/proposals.md

@@ -1,146 +0,0 @@
-# Audit Proposals — E03-board-tui-core
-
-## Target File
-
-`.savepoint/Design.md`
-
-## Replace
-
-```md
-## 8. TUI
-
-**Theming:** Atari-Noir is the default theme. **For full design tokens, palette, and rendering rules, see `.savepoint/visual-identity.md`** (loaded conditionally for TUI tasks). Live values in `config.yml` `theme:` section.
-
-Acknowledged terminal limits: fonts, scanlines, glows, letter-spacing, mouse-driven motion don't translate. Lean on color discipline + box-drawing geometry + uppercase headings.
-
-**Render fallbacks:** 256-color → 16-color hard-coded → `NO_COLOR=1` monochrome with glyphs → non-TTY plain table.
-
-**Layout:** single screen with a 5-column Kanban board and detail pane. Non-TTY output uses `src/tui/render/plain-table.ts`.
-
-**Implementation modules:** see AGENTS.md Codebase Map (E06 and E07 epic rows).
-
-**Keybindings:** arrow/vim navigation, enter advances, backspace retreats, r/R refreshes, a/A exits toward audit review when proposals exist, q quits.
-```
-
-## With
-
-```md
-## 8. TUI
-
-**Theming:** Atari-Noir is the default theme. **For full design tokens, palette, and rendering rules, see `.savepoint/visual-identity.md`** (loaded conditionally for TUI tasks). Live values in `config.yml` `theme:` section.
-
-Acknowledged terminal limits: fonts, scanlines, glows, letter-spacing, mouse-driven motion don't translate. Lean on color discipline + box-drawing geometry + uppercase headings.
-
-**Go board core:** established in epic `E03-board-tui-core` (2026-05-01). `internal/board` owns the Bubble Tea model, update loop, responsive layout calculation, and Lip Gloss view composition. `internal/styles` owns the Atari-Noir terminal palette and reusable Lip Gloss styles with truecolor, 256-color, and 16-color fallbacks.
-
-**Layout:** the Go board core currently renders a responsive 3-column grid. At `>=120` columns it includes a 28-cell epic panel plus 3 task columns; at `80-119` columns it renders 3 task columns; below `80` columns it renders only the focused column and supports left/right or h/l column switching.
-
-**Render fallbacks:** truecolor → 256-color → 16-color are encoded in Go styles. A future non-TTY/plain renderer remains outside this epic.
-
-**Implementation modules:** see AGENTS.md Codebase Map.
-
-**Keybindings:** `q` and `ctrl+c` quit. Left/right arrows and h/l move the focused column in narrow layouts.
-```
-
-## Target File
-
-`AGENTS.md`
-
-## Insert After
-
-```md
-| `internal/data/errors.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/Design.md)                   | Shared data-reader boundary error sentinels                                                          |
-```
-
-## With
-
-```md
-| `internal/board/board.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Bubble Tea board entrypoint and program launch                                                        |
-| `internal/board/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Board model state, constructor, task grouping, and initialization                                     |
-| `internal/board/update.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Board key handling, quit behavior, column focus navigation, and terminal resize updates               |
-| `internal/board/view.go`             | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Lip Gloss view composition for header, responsive board columns, epic panel, tasks, and status bar    |
-| `internal/board/layout.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Responsive board breakpoint and column width calculations                                            |
-| `internal/styles/palette.go`         | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Atari-Noir terminal color constants and 256-color/16-color fallbacks                                 |
-| `internal/styles/styles.go`          | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Reusable Lip Gloss styles for board chrome, focused state, task rows, status, tags, and epic panel   |
-| `internal/board/*_test.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)               | Unit tests for board model, update loop, layout breakpoints, and rendered output                     |
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E03-board-tui-core/Design.md`
-
-## Replace
-
-```md
-type: epic-design
-status: planned
-```
-
-## With
-
-```md
-type: epic-design
-status: implemented
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E03-board-tui-core/Design.md`
-
-## Insert After
-
-```md
-## Components and files
-
-| Path | Purpose |
-|------|---------|
-| `internal/board/model.go` | Model struct and Init |
-| `internal/board/update.go` | Update loop, message handling |
-| `internal/board/view.go` | View composition |
-| `internal/styles/palette.go` | Atari-Noir hex colors |
-| `internal/styles/styles.go` | Lip Gloss style definitions |
-| `internal/board/layout.go` | Width/height calculations |
-```
-
-## With
-
-```md
-
-## Implemented as
-
-- `internal/board/model.go` defines exported board state, groups tasks by `data.ColumnType`, defaults empty task columns to `planned`, and initializes with no startup command.
-- `internal/board/update.go` handles `q`, `ctrl+c`, terminal resize messages, and left/right or h/l focused-column navigation.
-- `internal/board/layout.go` implements the requested 120/80 column breakpoints and returns explicit layout metadata for view rendering.
-- `internal/board/view.go` composes the header, responsive task columns, optional epic panel, and status bar using Lip Gloss.
-- `internal/styles/palette.go` and `internal/styles/styles.go` define Atari-Noir truecolor values plus 256-color and 16-color fallbacks.
-
-## Audit deltas
-
-- The implemented board core is wired into `internal/board/board.go`; `Run()` now launches the exported board model rather than the pre-epic placeholder screen.
-- The layout currently uses rounded borders, while the visual identity prefers single-line quiet borders by default. This is acceptable if intentional, but should be normalized before the visual system hardens.
-- Layout width coverage now lives on `CalculateLayout`; the dead `columnContentWidth()` helper was removed.
-```
-
-## Quality Review
-
-## Must Fix Before Close
-
-None.
-
-## Must Fix Before Next Epic
-
-- `internal/board/layout.go:28` accepts height but ignores it. The epic originally calls for width/height calculations and no layout break at any width. Either incorporate height into visible task capacity or narrow the documented contract before components depend on it.
-- `internal/board/view.go:65` renders task labels without truncation or width-aware clipping. Long IDs/titles can wrap and break the grid, conflicting with the visual guardrail that accidental wrapping is a bug.
-
-## Carry Forward
-
-- `internal/styles/styles.go` uses rounded borders for columns and the epic panel. The visual identity says single-line borders are the default and rounded borders are not called out as a signature style; decide whether rounded borders are an intentional product choice in E04.
-- The Go implementation has replaced the older TypeScript architecture in active epics. Continue reconciling `.savepoint/Design.md` and AGENTS.md away from stale `src/` rows as each Go epic audits.
-
-## Already Fixed
-
-- Board state, resize handling, responsive breakpoints, Atari-Noir palette constants, color fallbacks, focused-column rendering, and focused-column navigation have focused tests.
-- `internal/board/board.go` now launches `newProgramModel()`, which returns the exported `Model` created by `NewModel(...)`; the private placeholder model was removed.
-- `internal/board/board_test.go` verifies the program model renders board columns and does not render the old welcome screen.
-- The dead `columnContentWidth()` helper and its stale tests were removed; layout width coverage remains in `internal/board/layout_test.go`.
-- `go test ./...` and `go build ./...` passed during audit.

package/.savepoint/audit/E03-board-tui-core/snapshot.md

@@ -1,57 +0,0 @@
----
-type: audit-snapshot
-epic: E03-board-tui-core
-release: v1
-created: 2026-05-01
-mode: manual
----
-
-# Audit Snapshot — E03-board-tui-core
-
-Manual snapshot created because `.savepoint/audit/E03-board-tui-core/snapshot.md` was missing while the audit CLI is unavailable.
-
-## Router State
-
-```yaml
-state: audit-pending
-release: v1
-epic: E03-board-tui-core
-task: E03-board-tui-core/T005-layout
-next_action: "E03-board-tui-core complete. Start a new agent session for the audit."
-```
-
-## Epic Scope
-
-- `.savepoint/releases/v1/epics/E03-board-tui-core/Design.md`
-- `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T001-model.md`
-- `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T002-update-loop.md`
-- `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T003-view.md`
-- `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T004-styles.md`
-- `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T005-layout.md`
-
-## Changed Files In Scope
-
-- `main.go`
-- `go.mod`
-- `internal/board/board.go`
-- `internal/board/model.go`
-- `internal/board/update.go`
-- `internal/board/view.go`
-- `internal/board/layout.go`
-- `internal/board/model_test.go`
-- `internal/board/update_test.go`
-- `internal/board/view_test.go`
-- `internal/board/layout_test.go`
-- `internal/styles/palette.go`
-- `internal/styles/styles.go`
-
-## Verification Observed During Audit
-
-- `go test ./...` passed.
-- `go build ./...` passed.
-- Closeout fix verification: `go test ./internal/board`, `go test ./...`, and `go build ./...` passed after wiring the runtime model and removing dead layout code.
-
-## Notes
-
-- Repository contains a broad TypeScript-to-Go transition and many unrelated working-tree changes. This snapshot is intentionally limited to the E03 Board TUI Core scope declared by the epic design and task files.
-- Closeout fix: `internal/board/board.go` now launches the exported `Model` implemented by this epic.