savepoint 1.0.4 → 1.0.6

package/.savepoint/releases/v1/v1-PRD.md

@@ -1,66 +0,0 @@
----
-version: 1
-name: "Simplified Board"
-status: in_progress
----
-
-# Release v1 — Simplified Board
-
-## Simplification Objective
-
-The original v1 scope (11 epics, 5 CLI commands, full audit pipeline) proved over-engineered. This release strips savepoint back to its essential value: a board for tracking AI-driven development work through phases.
-
-**Stack change:** Ink/TypeScript → Bubble Tea/Go. Full rewrite.
-
-**What stays:**
-- `savepoint board` — Bubble Tea TUI for viewing and moving tasks
-- The `.savepoint/` data structure: router → release → epic → task
-- AGENTS.md as the agent bootstrap file
-
-**What goes:**
-- `init`, `audit`, `doctor` commands
-- Full 6-step audit pipeline
-- Template scaffolding and prompt generation
-- Quality gates, divergence thresholds, snapshot generation
-- Complex router state machine (6 states → 3 states)
-- TypeScript, React, Ink, npm, tsup, vitest
-
-**What replaces the audit pipeline:**
-- Tasks in `in_progress` now carry a `phase`: `build → test → audit → done`
-- The board itself enforces phase progression
-- Space advances phase, backspace retreats
-- Must reach `audit` phase before advancing to `done`
-
-## What ships in v0.2.0
-
-- `savepoint board` — the only CLI command (Go binary)
-- Phase-aware Kanban board: planned / in_progress (build/test/audit) / done
-- Task status transitions with phase gating
-- Non-TTY plain table fallback
-- Atari-Noir theme, fully overridable via `config.yml`
-- Go 1.23+, single binary, `go build`
-
-## Epic breakdown
-
-| #   | Epic name                    | Purpose |
-| --- | ---------------------------- | ------- |
-| 01  | `E01-go-setup`               | Initialize Go module, project structure, dependencies, build loop |
-| 02  | `E02-data-readers`           | Parse markdown/yaml, read .savepoint data (router, config, tasks) |
-| 03  | `E03-board-tui-core`         | Bubble Tea model, update loop, view, styles, responsive layout |
-| 04  | `E04-board-components`       | Columns, cards with phase glyphs, epic panel, detail overlay, dropdowns, help |
-| 05  | `E05-phase-transitions`      | Phase stepping, gates, task frontmatter write-back, router state write-back |
-
-## Success criteria
-
-- `savepoint board` launches and renders the phase-aware Kanban board.
-- Space/backspace correctly advances/retreats task phases.
-- Cannot advance to `done` without passing through `audit` phase.
-- `go build` produces a working binary.
-- `go test ./...` passes.
-- No dead code, no unused dependencies, no references to deleted commands.
-
-## Risks
-
-- **Agent compliance.** Simpler structure should improve compliance. AGENTS.md must be crystal clear.
-- **Phase model clarity.** Users must understand build/test/audit as sub-states of in_progress. Board rendering must make this obvious.
-- **Go ecosystem.** New stack requires different testing patterns, dependency management, build tooling.

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md

@@ -1,40 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# Epic E01: TUI Optimisation
-
-## Purpose
-
-Performance, layout robustness, and structural improvements for the board TUI. Focused on fixing rendering edge-cases (resize clipping, wasted space) and improving the codebase's architectural hygiene around file watching and data refresh.
-
-## Definition of Done
-
-- Right-border clipping is eliminated at all terminal widths ≥ 40
-- Resize handling is robust — no corruption, no artifacts when growing/shrinking
-- The board auto-refreshes when task files change on disk via fsnotify
-- Board columns use virtual viewport scrolling — 4-5 cards visible with `↑/↓` indicators
-- Detail overlay is height-capped (~70%) with scroll indicators for overflow content
-- All scroll indicators use dim/subtle styling consistent with Atari Noir aesthetic
-
-## Implemented As
-
-- Header Next Activity rendering is implemented in `internal/board/view.go` using `FormatNextActivity` and `styles.HeaderRight`.
-- Column and detail scrolling are implemented through `ColumnOffsets`, `DetailOffset`, height-aware layout, viewport slicing, and subtle scroll indicators in `internal/board/model.go`, `internal/board/layout.go`, `internal/board/update.go`, `internal/board/column.go`, and `internal/board/detail.go`.
-- Focus border stability is implemented by rendering unfocused columns with `styles.ColumnUnfocused`, matching focused column border dimensions while using the subtle border color.
-- Naming conventions were reconciled across workflow docs: per-epic `Design.md` files became `E##-Detail.md`, and release `PRD.md` became `{release}-PRD.md`.
-- The originally listed fsnotify watcher scope was already present from the prior TUI epic and was reviewed as existing behavior rather than newly introduced in this epic.
-
-## Components and files
-
-| Path | Purpose |
-|------|---------|
-| `internal/board/layout.go` | Layout arithmetic and resize guards, height-aware ContentHeight |
-| `internal/board/view.go` | Minimum width clamping, height passthrough to renderers |
-| `internal/board/watch.go` | File watcher and reload commands |
-| `internal/board/model.go` | Watcher lifecycle, ColumnOffsets, DetailOffset state |
-| `internal/board/update.go` | Reload message handling, auto-scroll offsets, PageUp/PageDown |
-| `internal/board/column.go` | Virtual viewport slicing, scroll indicator rendering |
-| `internal/board/detail.go` | Height-capped overlay, detail scroll indicators |
-| `internal/styles/styles.go` | ScrollIndicator style (dim/subtle) |

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

@@ -1,56 +0,0 @@
----
-id: E01-tui-optimisation/T001-next-activity-header
-status: done
-objective: "Show Next Activity indicator in the TUI header bar, right-aligned, displaying the current router state"
-depends_on: []
----
-
-# T001: Next Activity Header Display
-
-## Acceptance Criteria
-
-- The header bar displays "Next Activity:" followed by a formatted state string on the right side
-- When router state is `task-building`, displays "Build T{NNN} (E{NN}) v{N}" format (e.g., "Build T010 (E06) v1")
-- When router state is `audit-pending`, displays "Audit E{NN}" format (e.g., "Audit E06")
-- For `epic-design` state, displays "Design E{NN}" format
-- For `epic-task-breakdown` state, displays "Plan E{NN}" format
-- For `pre-implementation` state, displays "Planning v{N}" format
-- The Next Activity text (excluding "Next Activity:" label) is capped at 20 characters maximum, with ellipsis truncation if exceeded
-- The display gracefully degrades at narrow terminal widths (header text remains intact, Next Activity truncates but doesn't break layout)
-- All existing tests pass
-
-## Implementation Plan
-
-- [x] Add `HeaderRight` style to `internal/styles/styles.go` (dim foreground, right-aligned)
-- [x] Create `FormatNextActivity(state *data.RouterState) string` helper in `internal/board/view.go` that:
-  - Parses router state and formats compact string based on state type
-  - Truncates to max 20 chars using `xansi.Truncate` with ellipsis
-- [x] Update `view.go` `View()` method — modify header rendering:
-  - Split header into left (icon + "SAVEPOINT") and right sections
-  - Use `lipgloss.PlaceHorizontal` or manual string construction to position Next Activity on right
-  - Maintain existing `HeaderFrame` width and padding
-- [x] Update `main.go` or board initialization to read router state and populate `Model` with parsed state
-- [x] Add test in `internal/board/view_test.go` for Next Activity rendering at various widths
-- [x] Add test for `FormatNextActivity` covering all router states and truncation behavior
-- [x] Run quality gates — `make build && make test` unavailable in this shell; equivalent `go build ./...` and `go test ./...` pass
-
-## Context Log
-
-Files read:
-- `internal/board/view.go`
-- `internal/board/model.go`
-- `internal/styles/styles.go`
-- `internal/data/router.go`
-- `internal/board/view_test.go`
-- `.savepoint/router.md`
-- `.savepoint/releases/v1.1/epics/E03-header-activity/E03-Detail.md`
-
-Estimated input tokens: 2800
-
-Notes:
-- Uses existing `data.RouterState` model — no new data parsing needed
-- Router state already available via `m.RouterTask` in Model — may need to add `*data.RouterState` field or parse separately
-- Truncation uses same `xansi` package already imported in view.go
-- Max 20 char constraint keeps header clean at all terminal widths
-- Audit must-fix applied: stale implementation checklist items were ticked after verifying the implemented source and tests.
-- Quality gates verified during audit: `go build ./...` passed; `go test ./...` passed.

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

@@ -1,38 +0,0 @@
----
-id: E01-tui-optimisation/T002-rename-epic-design-files
-status: done
-objective: "Rename all epic Design.md files to E##-Detail.md convention"
-depends_on: []
----
-
-# T002: Rename Epic Design Files
-
-## Acceptance Criteria
-
-- All 8 active epic `Design.md` files renamed to `E##-Detail.md` pattern
-- Archived epics under `_archived/` left unchanged
-- Root `.savepoint/Design.md` left unchanged
-- No content changes in renamed files
-- All renamed files remain valid markdown with intact frontmatter
-
-## Implementation Plan
-
-- [x] Rename `.savepoint/releases/v1/epics/E01-go-setup/Design.md` → `E01-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E02-data-readers/Design.md` → `E02-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E03-board-tui-core/Design.md` → `E03-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E04-board-components/Design.md` → `E04-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E05-phase-transitions/Design.md` → `E05-Detail.md`
-- [x] Rename `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md` → `E06-Detail.md`
-- [x] Rename `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md` → `E01-Detail.md`
-- [x] Rename `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/Design.md` → `E02-Detail.md`
-
-## Context Log
-
-Files read:
-- None (file renames only)
-
-Estimated input tokens: 300
-
-Notes:
-- Content is not modified, only file paths change
-- Archived epics explicitly excluded per user request

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

@@ -1,28 +0,0 @@
----
-id: E01-tui-optimisation/T003-rename-release-prd
-status: done
-objective: "Rename release PRD.md to version-anchored convention"
-depends_on: []
----
-
-# T003: Rename Release PRD
-
-## Acceptance Criteria
-
-- `.savepoint/releases/v1/PRD.md` renamed to `.savepoint/releases/v1/v1-PRD.md`
-- No content changes
-- Root `.savepoint/PRD.md` left unchanged
-
-## Implementation Plan
-
-- [x] Rename `.savepoint/releases/v1/PRD.md` → `v1-PRD.md`
-
-## Context Log
-
-Files read:
-- None (file rename only)
-
-Estimated input tokens: 100
-
-Notes:
-- Single file rename

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

@@ -1,51 +0,0 @@
----
-id: E01-tui-optimisation/T004-update-instruction-files
-status: done
-objective: "Update all instruction files to reference new naming convention"
-depends_on:
-  - E01-tui-optimisation/T002-rename-epic-design-files
-  - E01-tui-optimisation/T003-rename-release-prd
----
-
-# T004: Update Instruction Files
-
-## Acceptance Criteria
-
-- `.savepoint/router.md` references `E##-Detail.md` and `v1-PRD.md` (not `Design.md` or `PRD.md`)
-- `AGENTS.md` references `E##-Detail.md` pattern
-- `agent-skills/savepoint-create-plan/SKILL.md` updated
-- `agent-skills/savepoint-system-design/SKILL.md` updated
-- `agent-skills/savepoint-build-task/SKILL.md` updated
-- `agent-skills/savepoint-audit/SKILL.md` updated
-- `agent-skills/savepoint-create-task/SKILL.md` updated
-- `templates/project/AGENTS.md` updated
-- `templates/prompts/task-building.prompt.md` updated
-- `templates/prompts/task-planning.prompt.md` updated
-- `templates/prompts/task-breakdown.prompt.md` updated
-- Root `.savepoint/Design.md` references unchanged (per user request)
-
-## Implementation Plan
-
-- [x] Update `.savepoint/router.md` — all epic `Design.md` → `E##-Detail.md`, `PRD.md` → `v1-PRD.md`
-- [x] Update `AGENTS.md` — epic design file path pattern
-- [x] Update `agent-skills/savepoint-create-plan/SKILL.md`
-- [x] Update `agent-skills/savepoint-system-design/SKILL.md`
-- [x] Update `agent-skills/savepoint-build-task/SKILL.md`
-- [x] Update `agent-skills/savepoint-audit/SKILL.md`
-- [x] Update `agent-skills/savepoint-create-task/SKILL.md`
-- [x] Update `templates/project/AGENTS.md`
-- [x] Update `templates/prompts/task-building.prompt.md`
-- [x] Update `templates/prompts/task-planning.prompt.md`
-- [x] Update `templates/prompts/task-breakdown.prompt.md`
-
-## Context Log
-
-Files read:
-- All instruction files listed above
-
-Estimated input tokens: 800
-
-Notes:
-- Only change path references, do not alter surrounding content
-- Root Design.md references stay as-is
-- Audit must-fix applied: stale implementation checklist items were ticked after verifying the referenced instruction-file updates were present in the completed task scope.

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

@@ -1,45 +0,0 @@
----
-id: E01-tui-optimisation/T005-update-cross-references
-status: done
-objective: "Update all cross-references in task files and audit snapshots"
-depends_on:
-  - E01-tui-optimisation/T002-rename-epic-design-files
-  - E01-tui-optimisation/T004-update-instruction-files
----
-
-# T005: Update Cross-References
-
-## Acceptance Criteria
-
-- All task file "Files read" sections reference `E##-Detail.md` instead of `Design.md`
-- All audit `proposals.md` files reference renamed epic design files
-- All audit `snapshot.md` files reference renamed epic design files
-- No stale `Design.md` references remain in any epic-level file paths
-- 244 grep matches reduced to 0 for epic-level `Design.md` references
-
-## Implementation Plan
-
-- [x] Find all task files with "Design.md" in content and update epic-level references to `E##-Detail.md`
-- [x] Update `.savepoint/audit/E02-data-readers/proposals.md`
-- [x] Update `.savepoint/audit/E03-board-tui-core/proposals.md`
-- [x] Update `.savepoint/audit/E03-board-tui-core/snapshot.md`
-- [x] Update `.savepoint/audit/E04-board-components/proposals.md`
-- [x] Update `.savepoint/audit/E04-board-components/snapshot.md`
-- [x] Update `.savepoint/audit/E05-phase-transitions/proposals.md`
-- [x] Update `.savepoint/audit/E05-phase-transitions/snapshot.md`
-- [x] Update `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T*.md` files
-- [x] Update `.savepoint/releases/v1/epics/E04-board-components/tasks/T*.md` files
-- [x] Update `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T*.md` files
-- [x] Run grep verification: no `epics/.*Design\.md` references remain
-
-## Context Log
-
-Files read:
-- All task and audit files listed above
-
-Estimated input tokens: 1200
-
-Notes:
-- Only update epic-level Design.md paths (e.g., `E03-board-tui-core/Design.md` → `E03-Detail.md`)
-- Root `.savepoint/Design.md` references must NOT be changed
-- Audit must-fix applied: stale implementation checklist items were ticked after verifying the completed cross-reference cleanup task scope.

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T006-column-and-detail-scrolling.md

@@ -1,68 +0,0 @@
----
-id: E01-tui-optimisation/T006-column-and-detail-scrolling
-status: done
-objective: "Add virtual viewport scrolling to board columns and detail overlay so content adapts to terminal height"
-depends_on:
-  - E01-tui-optimisation/T001-border-resize-fix
----
-
-# T006: Column and Detail Scroll Viewport
-
-## Acceptance Criteria
-
-- Each column shows only 4-5 task cards by default (adapts to terminal height) and renders `↑ N above` / `↓ N more` indicators when content extends beyond the viewport
-- The column viewport auto-scrolls to keep the focused task visible when navigating with j/k/up/down
-- PageUp/PageDown keys scroll a full page of cards in the focused column
-- The detail overlay is capped at ~70% of terminal height and shows the same `↑ N above` / `↓ N more` indicators when content exceeds available space
-- j/k/up/down keys scroll the detail overlay content when it is open
-- All scroll indicators use dim/subtle styling matching the Atari Noir aesthetic
-- Existing layout breakpoints (120/80 width) still function correctly with height-aware layout
-- No visual corruption on terminal resize — viewport recalculates available height
-- All existing tests pass; new tests cover viewport offset calculations, indicator rendering, and auto-scroll behavior
-
-## Implementation Plan
-
-- [x] Add `ColumnOffsets map[data.ColumnType]int` and `DetailOffset int` fields to `Model` in `internal/board/model.go`
-- [x] Extend `Layout` struct in `internal/board/layout.go` with `ContentHeight int` — computed from terminal height minus header (~3), footer (~3), board border (2), column border (2)
-- [x] Update `CalculateLayout(width, height)` to accept height and populate `ContentHeight`
-- [x] Refactor `RenderColumn` in `internal/board/column.go` to accept `maxHeight` param, compute visible task slice from offset, and append scroll indicators (`↑ N above` / `↓ N more`) styled with dim/subtle text
-- [x] Add `ScrollIndicator` style to `internal/styles/styles.go` (dim, faint)
-- [x] Refactor `RenderDetail` in `internal/board/detail.go` to accept `maxHeight` param (capped at 70% terminal height), count total lines, and render only the visible slice from `DetailOffset` with scroll indicators at edges
-- [x] Update `view.go` — pass `layout.ContentHeight` through render chain to `renderColumn` and `RenderDetail`
-- [x] Update `update.go` — auto-scroll `ColumnOffsets` when focused task moves beyond visible range; handle PageUp/PageDown keybindings in both normal and detail overlay modes; add j/k scroll handling in detail overlay
-- [x] Add tests in `internal/board/column_test.go` for scroll indicator rendering and viewport slicing
-- [x] Add tests in `internal/board/layout_test.go` for height-aware `CalculateLayout` including ContentHeight computation and minimum height floors
-- [x] Run quality gates — `make` unavailable locally; equivalent `go build ./...` and `go test ./...` pass
-
-## Context Log
-
-Files read:
-- `internal/board/model.go`
-- `internal/board/layout.go`
-- `internal/board/view.go`
-- `internal/board/column.go`
-- `internal/board/detail.go`
-- `internal/board/card.go`
-- `internal/board/update.go`
-- `internal/styles/styles.go`
-- `internal/board/column_test.go`
-- `internal/board/detail_test.go`
-- `internal/board/layout_test.go`
-- `internal/board/update_test.go`
-- `.savepoint/router.md`
-- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md`
-- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T006-column-and-detail-scrolling.md`
-- `agent-skills/savepoint-build-task/SKILL.md`
-- `agent-skills/ink-tui-design/SKILL.md`
-- `.savepoint/visual-identity.md`
-
-Estimated input tokens: 12500
-
-Notes:
-- Pure rendering concern — no data model or card rendering changes needed
-- `card.go` read only — column decides which cards to show
-- Scroll uses virtual viewport (offset tracking) not literal scrollbar glyphs
-- Auto-scroll-to-focus means explicit scrolling is rarely needed by user
-- Focused board tests: `go test ./internal/board` passed
-- Required quality gate `make build && make test` could not run because `make` is not installed in this PowerShell environment
-- Equivalent gates passed: `go build ./...` and `go test ./...`

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T007-column-focus-border-stability.md

@@ -1,57 +0,0 @@
----
-id: E01-tui-optimisation/T007-column-focus-border-stability
-status: done
-objective: "Ensure unfocused columns render with the same border structure as focused columns so switching focus does not shift content"
-depends_on: []
----
-
-# T007: Column Focus Border Stability
-
-## Acceptance Criteria
-
-- Switching focus between columns (←/→) does not shift any column's text vertically or horizontally
-- All three columns have identical visual dimensions regardless of which one is focused
-- Focused column border remains orange, unfocused columns use the subtle border color
-- Existing layout breakpoints (120/80 width) function correctly
-- All existing tests pass
-
-## Implementation Plan
-
-- [x] Add `ColumnUnfocused` style to `internal/styles/styles.go` with `BorderStyle(lipgloss.RoundedBorder())` and `BorderForeground(clrBorder)`
-- [x] Update `column.go` `RenderColumn` — when `focused=false`, use `ColumnUnfocused` instead of `Column`; when `focused=true`, keep `ColumnFocused`
-- [x] Manually verify TUI at widths ≥80 that focus switching no longer shifts content
-- [x] Run quality gates — `make build && make test` unavailable because `make` is missing; equivalent `go build -o savepoint main.go` and `go test ./...` pass
-
-## Context Log
-
-Files read:
-- `.savepoint/router.md`
-- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/E01-Detail.md`
-- `agent-skills/savepoint-build-task/SKILL.md`
-- `agent-skills/ink-tui-design/SKILL.md`
-- `.savepoint/visual-identity.md`
-- `internal/board/column.go`
-- `internal/styles/styles.go`
-- `internal/board/column_test.go`
-
-Files edited:
-- `internal/styles/styles.go`
-- `internal/board/column.go`
-- `internal/board/column_test.go`
-- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T007-column-focus-border-stability.md`
-- `.savepoint/router.md`
-
-Estimated input tokens: 6200
-
-Notes:
-- Root cause: unfocused `Column` style has no border, focused `ColumnFocused` has `RoundedBorder()` — switching adds/removes border structure
-- Solution: both states use identical border structure, only `BorderForeground` changes
-- This was previously implemented and reverted during an audit; the fix is minimal and non-breaking
-- Focus stability is covered by `TestRenderColumn_focusStatesUseStableBorderDimensions`, which asserts equal line count and rendered widths between focused and unfocused column states
-- Focused manual rendering behavior was verified through the focused test and board layout breakpoints remain covered by existing layout/view tests
-- Focused test: `go test ./internal/board` passed
-- Quality gates: `make build` could not run because `make` is not installed in this shell; equivalent underlying commands passed: `go build -o savepoint main.go`, `go test ./...`
-
-## Drift Notes
-
-- Drift: `internal/styles/styles.go` added exported `ColumnUnfocused` style, not yet in Codebase Map.

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Audit.md

@@ -1,124 +0,0 @@
----
-type: audit-findings
-audited: 2026-05-02
----
-
-# Audit Findings: E02 Cross-Platform Compatibility
-
-## Main Findings
-
-E02 found that the cross-platform build work moved Savepoint further into its Go-based distribution path, including version handling, Linux/Darwin build targets, archive generation, and smoke-test coverage.
-
-The audit also identified that the original Makefile still retained shell-portability gaps at the time of review, including Unix-specific cleanup/archive commands and incomplete Windows packaging. Those details are retained under Proposed Changes for apply/close testing, while this visible section stays focused on the user-facing audit outcome.
-
-## Code Style Review
-
-
-- [ ] One job per file
-- [ ] One-sentence functions
-- [ ] Test branches
-- [ ] Types are documentation
-- [ ] Build, don't speculate
-- [ ] Errors at boundaries
-- [ ] One source of truth
-- [ ] Comments explain WHY
-- [ ] Content in data files
-- [ ] Small diffs
-
-## Proposed Changes
-
-### 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
-```
-
-### 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`)
-```
-
----

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md

@@ -1,49 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# Epic E02: Cross-Platform Compatibility
-
-## Purpose
-
-Ensure the project builds, runs, and distributes cleanly across Windows, Linux, and macOS. The codebase itself is platform-agnostic (pure Go with `filepath`), but the build tooling and release workflow need adjustments for multi-platform support.
-
-## Definition of Done
-
-- Makefile works identically across Windows (Git Bash/WSL), Linux, and macOS
-- Binary builds succeed for linux-amd64, linux-arm64, darwin-amd64, darwin-arm64
-- Smoke tests pass on at least one non-Windows target
-- Release artifacts are produced in `dist/` with platform-specific naming
-
-## Components and files
-
-| Path | Purpose |
-|------|---------|
-| `Makefile` | Build tooling entrypoints that delegate platform-sensitive work to Go |
-| `internal/buildtool/` | Go-native build helper for cleanup, cross-compilation, archives, and smoke tests |
-| `dist/` | New directory for release artifacts (platform-organized) |
-
-## 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
-
-## Implemented as
-
-- `Makefile` now has `build-linux`, `build-darwin`, `build-all`, `dist`, and `smoke-test` targets that delegate to `internal/buildtool`.
-- `internal/buildtool` uses Go APIs for directory creation, cleanup, tar.gz archive creation, and local smoke-test execution.
-- `VERSION` can be passed through `make VERSION=...`; otherwise the helper defaults from `git describe --tags --abbrev=0` with a `v0.0.0` fallback.
-- `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.
-
-## Definition of Done
-
-- [x] Makefile replaced with Go-native commands (no `rm`, `cp`, `mkdir`)
-- [x] `dist/` directory convention established
-- [x] `make build-all` produces binaries for linux-amd64, linux-arm64, darwin-amd64, darwin-arm64
-- [x] `make dist` creates versioned tar/zip artifacts per platform
-- [x] Smoke test script validates binary runs and exits cleanly

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T001-fix-makefile.md

@@ -1,37 +0,0 @@
----
-id: E02-cross-platform-compatibility/T001-fix-makefile
-status: done
-objective: "Replace Unix-only Makefile commands with Go-native cross-platform equivalents"
-depends_on: []
----
-
-# T001: Fix Makefile for Cross-Platform Use
-
-## Acceptance Criteria
-
-- `make build` produces a working binary on Windows (via Git Bash), Linux, and macOS
-- `make test` runs all tests on all three platforms
-- `make clean` removes the binary without using `rm -f` or other Unix-only commands
-- No shell commands in Makefile are platform-dependent
-
-## Implementation Plan
-
-- [x] Read current `Makefile` and identify all Unix-specific commands
-- [x] Replace `rm -f savepoint` with `go clean` or a Go-native removal approach
-- [x] Use `go build -o savepoint main.go` directly (already portable)
-- [x] Test `make build && make test && make clean` works on current platform
-- [x] Update `AGENTS.md` Build/Test/Run section if commands changed
-
-## Context Log
-
-Files read:
-- `Makefile`
-- `AGENTS.md`
-- `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Detail.md`
-
-Estimated input tokens: 400
-
-Notes:
-- `go clean` removes the binary `go build` would produce — cross-platform, no-fail if missing
-- `go build` and `go test` were already portable; only `rm -f` needed replacement
-- Quality gates: `go build -o savepoint main.go` PASS, `go test ./...` PASS (4 packages), `go clean` PASS