savepoint 1.0.0

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

@@ -0,0 +1,123 @@
+# 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

@@ -0,0 +1,54 @@
+---
+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

@@ -0,0 +1,146 @@
+# 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

@@ -0,0 +1,57 @@
+---
+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.

package/.savepoint/audit/E03-cli-foundation/snapshot.md

@@ -0,0 +1,106 @@
+---
+type: audit-snapshot
+epic: E03-cli-foundation
+created: 2026-04-27
+manual: true
+---
+
+# Audit Snapshot: E03-cli-foundation
+
+Manual snapshot generated because `savepoint audit` is not implemented yet.
+
+## Source file tree
+
+```
+src/
+  cli.ts                     - process entrypoint; delegates to runCli() with process globals
+  cli/
+    args.ts                  - argument parsing and normalization
+    environment.ts           - TTY, color, and platform detection
+    exit-codes.ts            - shared exit code constants
+    help.ts                  - help text generation (top-level and per-command)
+    run.ts                   - testable CLI runner with injectable argv/streams/env
+  commands/
+    audit.ts                 - stub: savepoint audit
+    board.ts                 - stub: savepoint board
+    doctor.ts                - stub: savepoint doctor
+    init.ts                  - stub: savepoint init
+test/
+  cli/
+    args.test.ts             - parser unit tests
+    commands.test.ts         - command stub dispatch tests
+    environment.test.ts      - TTY/color detection tests
+    help.test.ts             - help text generation tests
+    run.test.ts              - full runner dispatch tests (35 tests)
+```
+
+## Config / metadata changes
+
+| Path                                    | Purpose                                                                                       |
+| --------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `.savepoint/router.md`                  | Router state still pointed at T001; E03 tasks were completed without router updates per task. |
+| `E03-cli-foundation/tasks/T001-T006.md` | Six planned and completed E03 task files.                                                     |
+
+## New files introduced by E03
+
+- `src/cli/args.ts`
+- `src/cli/environment.ts`
+- `src/cli/exit-codes.ts`
+- `src/cli/help.ts`
+- `src/cli/run.ts`
+- `src/commands/audit.ts`
+- `src/commands/board.ts`
+- `src/commands/doctor.ts`
+- `src/commands/init.ts`
+- `src/commands/result.ts`
+- `test/cli/args.test.ts`
+- `test/cli/commands.test.ts`
+- `test/cli/environment.test.ts`
+- `test/cli/help.test.ts`
+- `test/cli/run.test.ts`
+
+## Modified files
+
+- `src/cli.ts` — replaced old placeholder with `runCli()` delegation; process globals isolated here.
+- `src/cli/run.ts` — command-level unknown flags now return usage errors.
+- `src/commands/audit.ts` — prettier formatting applied.
+- `src/commands/board.ts` — prettier formatting applied.
+- `src/commands/doctor.ts` — prettier formatting applied.
+- `src/commands/init.ts` — prettier formatting applied.
+- `test/cli/environment.test.ts` — prettier formatting applied.
+- `test/cli/run.test.ts` — prettier formatting applied.
+
+## Quality gates
+
+- `npm run build` passed. Output: `dist/cli.js` 4.83 KB.
+- `npm run typecheck` passed.
+- `npm run lint` passed.
+- `npm run format:check` initially failed on 6 pre-existing files (commands and CLI tests); fixed with `prettier --write`, then passed.
+- During audit closeout, `npm.cmd test -- test/cli/run.test.ts` initially failed in the sandbox with esbuild `spawn EPERM`; rerunning outside the sandbox passed.
+- `npm test` passed: 21 test files, 259 tests (0 failures).
+
+## Coverage summary
+
+| Branch                    | Test file           | Tests |
+| ------------------------- | ------------------- | ----- |
+| Bare invocation           | run.test.ts         | 3     |
+| Global help flags         | run.test.ts         | 4     |
+| Version flags             | run.test.ts         | 4     |
+| Command dispatch (4 cmds) | run.test.ts         | 8     |
+| Command-level help        | run.test.ts         | 7     |
+| Unknown command           | run.test.ts         | 3     |
+| Unknown flag              | run.test.ts         | 6     |
+| Argument parsing          | args.test.ts        | 12    |
+| Help text                 | help.test.ts        | 13    |
+| Environment detection     | environment.test.ts | 15    |
+| Command stubs             | commands.test.ts    | 8     |
+
+## Deviations from epic Design
+
+| Item                      | Status | Note                                                                                                 |
+| ------------------------- | ------ | ---------------------------------------------------------------------------------------------------- |
+| Audit snapshot            | manual | Generated by the agent because the audit CLI does not exist yet.                                     |
+| Router state              | manual | Router still shows T001 as active; router was not updated per-task during E03 implementation.        |
+| Prettier failures at gate | fixed  | 6 command/test files had formatting issues at T006; fixed before gate closeout.                      |
+| `src/cli.ts` entrypoint   | done   | Updated from placeholder to `runCli()` delegation with all process globals isolated at the boundary. |
+| Command-level flags       | fixed  | Unknown command-level flags now return usage errors instead of dispatching command stubs.            |

package/.savepoint/audit/E04-board-components/proposals.md

@@ -0,0 +1,118 @@
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+**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
+**Layout:** Go Bubble Tea board with responsive columns: wide terminals (`>=120` cols) show an epic sidebar plus planned / in-progress / done columns; medium terminals show three columns; narrow terminals show the focused column only.
+
+**Board components:** E04 adds Lip Gloss renderers for columns, task cards, epic sidebar/dropdown, release dropdown, task detail overlay, and help overlay. Selector, detail, and help overlays dim the current board and composite a centered panel over it.
+
+**Implementation modules:** see AGENTS.md Codebase Map (`internal/board/*`, `internal/styles/*`, and `internal/data/*` rows).
+
+**Keybindings:** h/left and l/right move columns; enter opens task detail or selects an overlay item; e opens the epic selector on narrow screens; r opens the release selector; ? opens help; esc/q close overlays; q/ctrl+c quit from the base board.
+```
+
+## 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/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)                | Bubble Tea board state for grouped tasks, focused column/task, selected release/epic, responsive size, and active overlay |
+| `internal/board/update.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)                | Keyboard and window-size update handling for board navigation, overlays, selectors, and quit behavior |
+| `internal/board/layout.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)                | Responsive board geometry breakpoints and column/sidebar width calculation                            |
+| `internal/board/view.go`             | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md)                | Board view composition, status bar, responsive columns, and overlay placement helpers                 |
+| `internal/board/column.go`           | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Column renderer with status header, task count, empty state, and focused border styling               |
+| `internal/board/card.go`             | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Task card renderer with phase glyphs, metadata dimming, truncation, and focus styling                 |
+| `internal/board/epic_panel.go`       | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Wide epic sidebar and narrow epic selector dropdown renderers                                         |
+| `internal/board/detail.go`           | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Task detail overlay renderer with task metadata, description, acceptance criteria, and phase labels   |
+| `internal/board/release.go`          | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Release selector dropdown renderer and current-release cursor lookup                                  |
+| `internal/board/help.go`             | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Keyboard shortcut help overlay renderer                                                               |
+| `internal/styles/*.go`               | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md)            | Atari-Noir Lip Gloss palette and shared board, card, overlay, glyph, status, and tag styles          |
+| `internal/board/*_test.go`           | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/Design.md) / [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/Design.md) | Go board model, layout, update, view, component, selector, detail, and help tests                     |
+```
+
+## Target File
+
+`.savepoint/releases/v1/epics/E04-board-components/Design.md`
+
+## Insert After
+
+```md
+## Definition of Done
+
+- Cards render with correct phase glyphs and colors.
+- Focused card has orange accent border.
+- Epic panel renders on wide screens; dropdown on narrow.
+- Detail overlay opens with Enter, closes with Esc.
+- Epic dropdown opens with `e`, release with `r`.
+- Help overlay opens with `?`.
+- All components render without wrapping or layout breaks.
+- Component tests pass.
+```
+
+## With
+
+```md
+## Implemented As
+
+- `internal/board/column.go` renders status columns with uppercase label, task count, empty state, focused border, and task cards.
+- `internal/board/card.go` renders standalone task cards with build/test/audit glyphs, dim metadata, truncation, and focused styling.
+- `internal/board/epic_panel.go` renders the wide epic sidebar and narrow epic dropdown; `e` opens the dropdown only below the wide breakpoint.
+- `internal/board/release.go` renders the release dropdown; `r` opens it at all widths.
+- `internal/board/detail.go` renders task detail panels with wrapped long text; `internal/board/view.go` dims the board and composites selector/detail/help overlays over the base board.
+- `internal/board/help.go` renders the keyboard shortcut overlay.
+- `internal/styles/styles.go` and `internal/styles/palette.go` add shared Lip Gloss styles for cards, overlays, metadata, glyphs, and dim text.
+
+## Audit Deltas
+
+- Planned `internal/board/dropdown.go` was not created; epic and release dropdowns are separate renderers.
+- Task cards are integrated into column rendering; board columns now display card borders and phase glyphs.
+- Selecting an epic or release updates `SelectedEpic` / `SelectedRelease` and regroups visible board tasks from `Model.AllTasks`.
+- Selector/detail/help overlays keep the dimmed board visible behind the panel.
+- Base board up/down navigation moves the focused task within the focused column.
+```
+
+## Quality Review
+
+## Must Fix Before Close
+
+No open findings.
+
+## Must Fix Before Next Epic
+
+No open findings.
+
+## Carry Forward
+
+- The current project architecture and Codebase Map still contain substantial TypeScript-era rows. This proposal adds E04 Go rows as a delta, but a later audit should reconcile the stale TypeScript implementation sections once the Go transition is complete.
+
+## Already Fixed
+
+- Board columns render `RenderCard`, so phase glyphs, card borders, truncation, and focused card styling are visible in the actual board.
+- Epic and release selections regroup visible tasks from `Model.AllTasks`.
+- Epic and release dropdowns use the same dimmed-base overlay composition as detail/help.
+- Base board up/down navigation moves `FocusedTask` and clamps at column bounds.
+- Detail rows, descriptions, and acceptance criteria wrap long text within overlay width.
+- Focused tests passed during audit: `go test ./internal/board/...`.
+- Full Go suite passed during audit: `go test ./...`.
+- Help and detail overlays use the dimmed-base compositing path and close on `esc` / `q`.