savepoint 1.0.0 → 1.0.2

package/.savepoint/audit/{E04-board-components → v1/E04-board-components}/proposals.md

@@ -31,29 +31,29 @@
 ## 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                                                          |
+| `internal/data/errors.go`            | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.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                     |
+| `internal/board/model.go`            | [E03-board-tui-core](.savepoint/releases/v1/epics/E03-board-tui-core/E03-Detail.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/E03-Detail.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/E03-Detail.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/E03-Detail.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/E04-Detail.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/E04-Detail.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/E04-Detail.md)            | Wide epic sidebar and narrow epic selector dropdown renderers                                         |
+| `internal/board/detail.go`           | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.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/E04-Detail.md)            | Release selector dropdown renderer and current-release cursor lookup                                  |
+| `internal/board/help.go`             | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md)            | Keyboard shortcut help overlay renderer                                                               |
+| `internal/styles/*.go`               | [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.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/E03-Detail.md) / [E04-board-components](.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md) | Go board model, layout, update, view, component, selector, detail, and help tests                     |
 ```
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E04-board-components/Design.md`
+`.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`
 
 ## Insert After
 

package/.savepoint/audit/{E04-board-components → v1/E04-board-components}/snapshot.md

@@ -16,7 +16,7 @@ next_action: "Epic E04-board-components complete. Start a new agent session for
 
 ## Epic Scope
 
-Epic design: `.savepoint/releases/v1/epics/E04-board-components/Design.md`
+Epic design: `.savepoint/releases/v1/epics/E04-board-components/E04-Detail.md`
 
 Tasks:
 

package/.savepoint/audit/{E05-init-command → v1/E05-init-command}/snapshot.md

@@ -64,7 +64,7 @@ test/
 | `.savepoint/audit/E05-init-command/proposals.md`          | Single audit proposal bundle, pending.  |
 | `.savepoint/metrics/context-bench.md`                     | Context rows for E05 task building.     |
 | `AGENTS.md`                                               | Codebase Map needs E05 module refresh.  |
-| `.savepoint/releases/v1/epics/E05-init-command/Design.md` | Epic Design needs implemented-as notes. |
+| `.savepoint/releases/v1/epics/E05-init-command/E05-Detail.md` | Epic Design needs implemented-as notes. |
 
 ## New files introduced by E05
 

package/.savepoint/audit/{E05-phase-transitions → v1/E05-phase-transitions}/proposals.md

@@ -23,19 +23,19 @@
 ## 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                                                          |
+| `internal/data/errors.go`                     | [E02-data-readers](.savepoint/releases/v1/epics/E02-data-readers/E02-Detail.md)                   | Shared data-reader boundary error sentinels                                                          |
 ```
 
 ## With
 
 ```md
-| `internal/data/write.go`                      | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/Design.md)         | Mtime-checked task status/phase and router current-state write helpers                               |
-| `internal/board/transitions.go`               | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/Design.md)         | Board phase advance/retreat lifecycle and dependency gate checks                                     |
+| `internal/data/write.go`                      | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md)         | Mtime-checked task status/phase and router current-state write helpers                               |
+| `internal/board/transitions.go`               | [E05-phase-transitions](.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md)         | Board phase advance/retreat lifecycle and dependency gate checks                                     |
 ```
 
 ## Target File
 
-`.savepoint/releases/v1/epics/E05-phase-transitions/Design.md`
+`.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md`
 
 ## Insert After
 

package/.savepoint/audit/{E05-phase-transitions → v1/E05-phase-transitions}/snapshot.md

@@ -14,7 +14,7 @@ next_action: "Epic E05-phase-transitions is complete. Start a new agent session
 
 ## Epic Scope
 
-- `.savepoint/releases/v1/epics/E05-phase-transitions/Design.md`
+- `.savepoint/releases/v1/epics/E05-phase-transitions/E05-Detail.md`
 - `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T001-phase-stepping.md`
 - `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T002-gates.md`
 - `.savepoint/releases/v1/epics/E05-phase-transitions/tasks/T003-write-task.md`

package/.savepoint/audit/v1/E06-atari-noir-layout/proposals.md

@@ -0,0 +1,130 @@
+# E06 Atari-Noir Layout Audit Proposals
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```md
+- **Board command** (`savepoint board`) reads project, non-TTY fallback, Ink TUI, transition gates, mtime writes, audit signaling (epic E06).
+```
+
+## With
+
+```md
+- **Board command** (`savepoint board`) reads project state, renders the Atari-Noir TUI board, supports release/epic filtering, detail overlays, task status transitions with mtime-guarded writes, router priority markers, and fsnotify-based task auto-refresh (epic E06).
+```
+
+## 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).
+```
+
+## With
+
+```md
+**Layout:** single screen with a 3-column task board (`planned`, `in_progress`, `done`), optional epic sidebar on wide terminals, centered overlays for release/epic/help/task detail, static Atari-Noir header/footer, and navigation hints. Non-TTY output remains a plain table fallback.
+
+**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.
+
+**Implementation modules:** see AGENTS.md Codebase Map.
+```
+
+## Target File
+
+`AGENTS.md`
+
+## Replace
+
+```md
+| `internal/board/`                    | TUI board components, models, layouts, transitions, and rendering logic                              |
+| `internal/data/`                     | Task data models, frontmatter parsing, project configuration, routing, and generic file readers      |
+| `internal/styles/`                   | Shared visual design system, TUI styling, and palettes                                               |
+```
+
+## With
+
+```md
+| `internal/board/`                    | TUI board models, layout, rendering, overlays, task transitions, router priority markers, and fsnotify refresh |
+| `internal/data/`                     | Task/router/config models, frontmatter parsing, checklist state parsing, mtime-guarded writes, discovery, and generic file readers |
+| `internal/styles/`                   | Atari-Noir palette constants, terminal color fallbacks, shared TUI styles, semantic glyph/tag styles, and footer/header styling |
+```
+
+## Target File
+
+`.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
+
+## Replace
+
+```md
+# Epic E07: Atari-Noir Layout Uplift
+```
+
+## With
+
+```md
+# Epic E06: Atari-Noir Layout Uplift
+```
+
+## Target File
+
+`.savepoint/releases/v1/epics/E06-atari-noir-layout/E06-Detail.md`
+
+## Insert After
+
+```md
+| `internal/board/epic_panel.go` | Refine epic panel layout |
+```
+
+## With
+
+```md
+
+## Implemented As
+
+- `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, 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/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`.
+
+## Implementation Deltas
+
+- The original visual-only scope expanded to include board usability fixes requested during E06: footer navigation hints, detail overlay spacing, card title word-wrap, checklist state rendering, router priority markers, and auto-refresh on task file changes.
+- The current implementation still uses rounded frames/borders on header, board, columns, cards, and epic panel. That differs from the design language of "unnecessary borders removed" and should be reconciled before closing the visual uplift.
+- `styles.Divider` exists but the main view does not render explicit full-width top/bottom divider lines; divider-like output currently comes from framed containers and component separators.
+```
+
+## Quality Review
+
+## Must Fix Before Close
+
+- None remaining after approval closeout.
+
+## Carry Forward
+
+- `internal/board/watch.go:17`: watcher errors are consumed silently. This is acceptable for v1 audit as non-blocking resilience, but a future task should surface watcher failures in `StatusMessage` or diagnostics.
+- `internal/board/update.go:68` and `internal/board/update.go:84`: `ErrMtimeConflict` is intentionally non-destructive, but the user receives no visible conflict message because that error is ignored. Consider showing a manual-refresh message so conflicts are understandable.
+- `go.mod`: `github.com/fsnotify/fsnotify` is currently listed as indirect even though project code imports it directly. `go mod tidy` may fix this metadata.
+- Root instruction drift: `AGENTS.md` references `agent-skills/audit/SKILL.md`, but the repository contains `agent-skills/savepoint-audit/SKILL.md`.
+
+## Already Fixed
+
+- `go build ./...`: PASS during audit.
+- `go test ./...`: PASS during audit.
+- Approval closeout added explicit full-width divider lines rendered through `styles.Divider`.
+- Approval closeout removed unnecessary borders from unfocused header, board, column, card, and epic panel surfaces while preserving focused Atari Orange borders.
+- T008 checklist parsing preserves checked/unchecked state in `data.CheckItem` and renders checked items distinctly.
+- T009 router priority marker is wired through model, card, column, and detail rendering.
+- T010 auto-refresh watcher is isolated in `internal/board/watch.go` and cleanly disabled in tests when `Model.Watcher` is nil.

package/.savepoint/audit/v1/E06-atari-noir-layout/snapshot.md

@@ -0,0 +1,84 @@
+---
+type: audit-snapshot
+release: v1
+epic: E06-atari-noir-layout
+created: 2026-05-02
+mode: manual
+reason: "Audit CLI snapshot was unavailable; router authorized one manual snapshot from known epic scope."
+---
+
+# E06 Atari-Noir Layout Snapshot
+
+## Router State
+
+- `state`: `audit-pending`
+- `release`: `v1`
+- `epic`: `E06-atari-noir-layout`
+- `task`: `E06-atari-noir-layout/T010-auto-refresh-watcher`
+- `next_action`: All E06 tasks done. Start new agent session for epic audit.
+
+## Epic Scope
+
+E06 implemented the Atari-Noir TUI layout uplift and related board usability fixes:
+
+- Atari-Noir palette/style usage in `internal/styles/`.
+- Header/footer rendering, navigation hints, and board layout adjustments in `internal/board/view.go`.
+- Card title wrapping and detail overlay spacing/checklist rendering in `internal/board/card.go` and `internal/board/detail.go`.
+- Router priority marker support across board model/card/detail rendering.
+- Task checklist state parsing in `internal/data/parser.go` and `internal/data/task.go`.
+- File watcher auto-refresh and task status disk persistence in `internal/board/watch.go`, `internal/board/board.go`, `internal/board/model.go`, and `internal/board/update.go`.
+
+## Task Files Reviewed
+
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T001-color-system.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T002-header-and-dividers.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T003-footer-status-bar.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T004-component-refinement.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T005-restore-nav-hints.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T007-detail-card-fixes.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T008-checkbox-states.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T009-router-priority-marker.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T010-auto-refresh-watcher.md`
+
+## Changed Files In Epic Scope
+
+- `go.mod`
+- `go.sum`
+- `internal/board/board.go`
+- `internal/board/card.go`
+- `internal/board/card_test.go`
+- `internal/board/column.go`
+- `internal/board/column_test.go`
+- `internal/board/detail.go`
+- `internal/board/detail_test.go`
+- `internal/board/epic_panel.go`
+- `internal/board/layout.go`
+- `internal/board/model.go`
+- `internal/board/update.go`
+- `internal/board/view.go`
+- `internal/board/view_test.go`
+- `internal/board/watch.go`
+- `internal/data/parser.go`
+- `internal/data/parser_test.go`
+- `internal/data/task.go`
+- `internal/data/write.go`
+- `internal/styles/palette.go`
+- `internal/styles/styles.go`
+
+## Drift Notes Found
+
+- `T002-header-and-dividers.md`: `internal/styles/palette.go` and `internal/styles/styles.go` were not yet reflected with sufficient specificity in the Codebase Map.
+
+## Verification
+
+- `go build ./...`: PASS
+- `go test ./...`: PASS
+- Approval closeout rerun: `go build ./...` PASS, `go test ./...` PASS.
+- `make build` and `make test`: not run; `make` is not installed on PATH in this environment.
+
+## Audit Observations
+
+- `agent-skills/audit/SKILL.md` is referenced by the root instructions but does not exist; `agent-skills/savepoint-audit/SKILL.md` was used as the equivalent audit skill.
+- The epic Design title says `Epic E07`; the folder, router, and task IDs identify this epic as `E06-atari-noir-layout`.
+- The implementation added scoped behavior beyond the original visual uplift: footer navigation hints, detail overlay spacing, card word-wrap, checklist state parsing/rendering, router priority markers, and fsnotify auto-refresh.
+- Visual ACs around explicit full-width dividers and border reduction are not fully represented in `internal/board/view.go` and `internal/styles/styles.go`; see proposals quality review.

package/.savepoint/audit/{E07-audit-pipeline → v1/E07-audit-pipeline}/snapshot.md

@@ -32,18 +32,18 @@ next_action: Run savepoint audit for E07-audit-pipeline.
 | M      | .claude/settings.local.json                                                            |
 | M      | .savepoint/Design.md                                                                   |
 | M      | .savepoint/metrics/context-bench.md                                                    |
-| M      | .savepoint/releases/v1/PRD.md                                                          |
-| M      | .savepoint/releases/v1/epics/E05-init-command/Design.md                                |
+| M      | .savepoint/releases/v1/v1-PRD.md                                                          |
+| M      | .savepoint/releases/v1/epics/E05-init-command/E05-Detail.md                                |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T001-init-cli-contract.md          |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T002-target-validation.md          |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T003-scaffold-writer.md            |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T004-magic-prompt-and-clipboard.md |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T005-dev-deps-install-option.md    |
 | M      | .savepoint/releases/v1/epics/E05-init-command/tasks/T006-init-command-integration.md   |
-| M      | .savepoint/releases/v1/epics/E06-tui-board/Design.md                                   |
-| D      | .savepoint/releases/v1/epics/E08-doctor-command/Design.md                              |
-| D      | .savepoint/releases/v1/epics/E09-docs-and-packaging/Design.md                          |
-| D      | .savepoint/releases/v1/epics/E10-release-validation/Design.md                          |
+| M      | .savepoint/releases/v1/epics/E06-tui-board/E06-Detail.md                                   |
+| D      | .savepoint/releases/v1/epics/E08-doctor-command/E08-Detail.md                              |
+| D      | .savepoint/releases/v1/epics/E09-docs-and-packaging/E09-Detail.md                          |
+| D      | .savepoint/releases/v1/epics/E10-release-validation/E10-Detail.md                          |
 | M      | .savepoint/router.md                                                                   |
 | M      | .savepoint/visual-identity.md                                                          |
 | M      | AGENTS.md                                                                              |

package/.savepoint/audit/v1.1/E02-cross-platform-compatibility/proposals.md

@@ -0,0 +1,114 @@
+# Audit Proposals: v1.1 E02 Cross-Platform Compatibility
+
+## Target File
+
+`.savepoint/Design.md`
+
+## Replace
+
+```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.
+
+- **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.
+- **No telemetry.** Ever.
+```
+
+## With
+
+```md
+## 12. Distribution & build
+
+> 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.
+- **Runtime:** Go CLI binary. Source builds with `go build`; tests run with `go test ./...`.
+- **Local build:** `make build` builds `savepoint` and injects `main.version` from `VERSION`.
+- **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.
+- **Smoke validation:** `make smoke-test` builds the local binary and runs `./savepoint --version` as a headless exit-0 check.
+- **No telemetry.** Ever.
+```
+
+## Target File
+
+`AGENTS.md`
+
+## Replace
+
+```md
+| `main.go`                            | CLI Entrypoint and root command wiring                                                               |
+```
+
+## With
+
+```md
+| `main.go`                            | CLI entrypoint, root command wiring, and `--version` handling via build-time version injection        |
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
+
+## Insert After
+
+```md
+## Architectural notes
+
+- All Go code uses `path/filepath` — no syscalls are platform-specific
+- Bubble Tea handles terminal differences across platforms
+- No Go build tags or platform-specific files needed
+- This is purely a build-tooling and release-workflow epic
+```
+
+## With
+
+```md
+## Implemented as
+
+- `Makefile` now has `build-linux`, `build-darwin`, `build-all`, `dist`, and `smoke-test` targets.
+- `VERSION` defaults from `git describe --tags --abbrev=0` with a `v0.0.0` fallback and is injected into the binary with `-ldflags "-X main.version=$(VERSION)"`.
+- `main.go` handles `--version` before launching the TUI, which gives smoke tests a non-interactive success path.
+- `dist/` remains ignored by git and contains both raw cross-compiled binaries and versioned `.tar.gz` archives for Linux and Darwin builds.
+- Windows zip packaging was not implemented in this epic; the final implementation covers the Linux and Darwin targets named in the epic's build-all definition of done.
+```
+
+## Target File
+
+`.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
+
+## Replace
+
+```md
+- [x] Makefile replaced with Go-native commands (no `rm`, `cp`, `mkdir`)
+```
+
+## With
+
+```md
+- [ ] Makefile replaced with Go-native commands (no `rm`, `cp`, `mkdir`)
+```
+
+## Quality Review
+
+## Must Fix Before Close
+
+- `Makefile`: `clean` still runs `rm -rf dist/`, which violates T001 acceptance criteria: "`make clean` removes the binary without using `rm -f` or other Unix-only commands" and "No shell commands in Makefile are platform-dependent."
+- `Makefile`: `build-linux` and `build-darwin` still use `mkdir -p` and inline `GOOS=... GOARCH=...` environment assignment. That is fine for Linux, macOS, Git Bash, and WSL, but it is not a shell-agnostic Makefile implementation.
+- `Makefile`: `dist` relies on `tar`, so packaging is not yet toolchain-native or Windows-shell portable.
+- `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T004-smoke-tests-and-artifacts.md`: the task says `go test ./...` was not run even though the task completion protocol requires the full quality-gate suite before `status: done`.
+
+## Carry Forward
+
+- Windows `.zip` artifacts were deferred in T004. Keep that as a known scope gap unless the project narrows E02 explicitly to Linux and Darwin distribution.
+- Consider moving cross-platform build and archive logic into a tiny Go helper if the project wants true shell portability while keeping `make` as the human entrypoint.
+
+## Already Fixed
+
+- `main.go` has a headless `--version` path, so smoke testing no longer needs to start the TUI.
+- Linux and Darwin raw binary targets exist for amd64 and arm64.
+- `AGENTS.md` already documents `build-all`, `dist`, and `smoke-test`.

package/.savepoint/audit/v1.1/E02-cross-platform-compatibility/snapshot.md

@@ -0,0 +1,41 @@
+# Audit Snapshot: v1.1 E02 Cross-Platform Compatibility
+
+Manual snapshot created because the audit CLI snapshot was missing while the router is already in `audit-pending`.
+
+## Epic
+
+- Release: `v1.1`
+- Epic: `E02-cross-platform-compatibility`
+- Source: `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
+- Router state: `audit-pending`
+
+## Completed Tasks
+
+- `E02-cross-platform-compatibility/T001-fix-makefile`
+- `E02-cross-platform-compatibility/T002-linux-build-target`
+- `E02-cross-platform-compatibility/T003-macos-build-target`
+- `E02-cross-platform-compatibility/T004-smoke-tests-and-artifacts`
+
+## Changed Files Listed By Task Logs
+
+- `Makefile`
+- `AGENTS.md`
+- `.gitignore`
+- `main.go`
+- `internal/board/board.go`
+
+## Drift Notes Found
+
+- `main.go`: added `version` package-level var and `--version` arg check. Not yet in Codebase Map.
+
+## Verification Reported By Tasks
+
+- T001: `go build -o savepoint main.go` PASS, `go test ./...` PASS, `go clean` PASS
+- T002: `go build` PASS, `go test ./...` PASS; Linux binaries reported as ELF for amd64 and arm64
+- T003: `go build` PASS, `go test ./...` PASS; Darwin binaries reported as Mach-O for amd64 and arm64
+- T004: `go build` PASS, `./savepoint --version` PASS; `go test ./...` not run
+
+## Audit Notes
+
+- The final `Makefile` includes cross-compile and packaging targets, but still contains Unix shell forms in `clean`, `build-linux`, `build-darwin`, `dist`, and `VERSION`.
+- `T004` explicitly deferred Windows zip artifacts; the implemented release artifacts cover Linux and Darwin only.