savepoint 1.0.0

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

@@ -0,0 +1,52 @@
+---
+id: E06-atari-noir-layout/T003-footer-status-bar
+status: done
+objective: "Implement the static Footer Status Bar and bottom divider"
+depends_on: ["E06-atari-noir-layout/T002-header-and-dividers"]
+---
+
+# T003: Implement Footer Status Bar
+
+## Acceptance Criteria
+
+- Footer replaces the dynamic status string with exactly: `PLAN      │      BUILD      │      AUDIT`.
+- PLAN is colored Vibe Purple.
+- BUILD is colored Atari Orange.
+- AUDIT is colored NPP Green.
+- The divider `│` is colored Border Subtle.
+- The text is bold or slightly emphasized, with even spacing between sections.
+- A full-width horizontal divider is rendered above the footer.
+- The footer contains no icons, no repetition of the logo, and no extra labels/metrics.
+- The main application content sits cleanly between the top and bottom dividers without overlapping.
+
+## Implementation Plan
+
+- [x] Update `renderStatus` in `internal/board/view.go` to render the new static phase footer.
+- [x] Style the footer segments according to the color rules.
+- [x] Add the bottom horizontal divider above the footer.
+- [x] Adjust height calculations so the board area fits exactly between the top and bottom dividers. (No height calculation changes needed — `lipgloss.JoinVertical` naturally accommodates the extra divider line.)
+
+## Context Log
+
+Files read:
+- `.savepoint/router.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T003-footer-status-bar.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T002-header-and-dividers.md`
+- `.savepoint/visual-identity.md`
+- `internal/board/view.go`
+- `internal/board/view_test.go`
+- `internal/board/layout.go`
+- `internal/board/model.go`
+- `internal/styles/palette.go`
+- `internal/styles/styles.go`
+
+Estimated input tokens: ~5500
+
+Notes:
+- Replaced `renderStatus` (dynamic status bar with release/epic/column info) with `renderFooter` (static phase footer: PLAN │ BUILD │ AUDIT).
+- Added `FooterPhasePlan` (purple, bold), `FooterPhaseBuild` (orange, bold), `FooterPhaseAudit` (green, bold), and `FooterDivider` (border subtle) styles.
+- Added full-width bottom divider above the footer matching the top divider style.
+- Removed unused `fmt` import from `view.go` after `renderStatus` deletion.
+- `StatusBar` style and `StatusMessage` model field remain unused but harmless; left for future cleanup.
+- Quality gates: `go build ./...` pass, `go test ./...` pass, `go vet ./...` pass.

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

@@ -0,0 +1,53 @@
+---
+id: E06-atari-noir-layout/T004-component-refinement
+status: done
+objective: "Refine columns, cards, and epic panels to match rhythm and interaction requirements"
+depends_on: ["E06-atari-noir-layout/T001-color-system"]
+---
+
+# T004: Component Refinement & Spacing Rhythm
+
+## Acceptance Criteria
+
+- Columns, cards, and epic panels use Surface (`#0D0D0D`) or Surface 2 (`#0F0F0F`) colors rather than text blocks.
+- Unnecessary borders are removed. Focus states use structure, position, and minimal accents (e.g., Atari Orange for focused borders).
+- Spacing is consistent and components "breathe". No dense, edge-to-edge clutter exists.
+- Line wrapping in standard data views is prevented where possible (treated as a bug).
+- The existing functional data structures and keyboard interactions remain completely intact.
+
+## Implementation Plan
+
+- [x] Refine `internal/board/column.go` to remove unnecessary borders and improve padding.
+- [x] Update `internal/board/card.go` to behave as a distinct surface with clear focus states.
+- [x] Update `internal/board/epic_panel.go` spacing and styles.
+- [x] Verify there is no unintentional wrapping on resizing, fixing any remaining flex/width issues in Lip Gloss setup.
+
+## Context Log
+
+Files read:
+- `.savepoint/router.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T004-component-refinement.md`
+- `internal/styles/palette.go`
+- `internal/styles/styles.go`
+- `internal/board/column.go`
+- `internal/board/card.go`
+- `internal/board/epic_panel.go`
+- `internal/board/layout.go`
+- `internal/board/view.go`
+- `internal/board/column_test.go`
+- `internal/board/card_test.go`
+- `internal/board/epic_panel_test.go`
+- `internal/board/layout_test.go`
+- `internal/board/board_test.go`
+
+Estimated input tokens: ~15k
+
+Notes:
+- Only `internal/styles/styles.go` was modified; no source code logic changes were needed since column.go, card.go, and epic_panel.go all reference the centralized styles.
+- Column (unfocused): removed `RoundedBorder()`, added `Background(clrSurfaceDark #0D0D0D)`.
+- ColumnFocused: added `Background(clrSurfaceDark)`, kept orange rounded border for focus.
+- Card (unfocused): added `Background(clrSurface #0F0F0F)` for surface feel.
+- EpicPanel: removed `RoundedBorder()`, added `Background(clrSurface #0F0F0F)`.
+- New color var `clrSurfaceDark` added for Surface (#0D0D0D) palette usage.
+- Quality gates: `go build ./...` (pass), `go vet ./...` (pass), `go test ./...` (all 113 tests pass). 

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T005-restore-nav-hints.md

@@ -0,0 +1,39 @@
+---
+id: E06-atari-noir-layout/T005-restore-nav-hints
+status: done
+objective: "Restore persistent navigation keybinding hints to the main board footer"
+depends_on: []
+---
+
+# T005: Restore Navigation Hints in Footer
+
+## Acceptance Criteria
+
+- The footer shows a second line below the phase labels with keybinding hints: `←/→:nav  E:epic  R:release  ?:help  q:quit`
+- Hints are styled in a subdued color to not overwhelm the phase labels
+- The footer still fits within a single terminal width without wrapping
+- All existing footer behavior (centered phase labels, alignment) remains intact
+- Hints refresh correctly on terminal resize
+
+## Implementation Plan
+
+- [x] Edit `internal/board/view.go` — update `renderFooter()` to append a second line of keybinding hints below the phase labels.
+- [x] Add a new `FooterHints` style in `internal/styles/styles.go` using `clrDim` (dim/subdued appearance).
+- [x] Run `make build && make test` to verify no regressions.
+
+## Context Log
+
+Files read:
+- `internal/board/view.go`
+- `internal/board/update.go`
+- `internal/styles/styles.go`
+- `internal/board/view_test.go`
+- `internal/board/layout.go`
+- `internal/board/model.go`
+
+Estimated input tokens: 1400
+
+Notes:
+- `make build` could not run because `make` is not installed on PATH in this environment.
+- Verified the task with `go build ./...`, `go test ./...`, and focused `go test ./internal/board`.
+- Footer render now uses a width-guarded centered phase line, a blank spacer line, and a second subdued hint line.

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T007-detail-card-fixes.md

@@ -0,0 +1,36 @@
+---
+id: E06-atari-noir-layout/T007-detail-card-fixes
+status: planned
+objective: "Add line breaks under Acceptance Criteria and Implementation Plan headings in task detail, and word-wrap card titles instead of truncating"
+depends_on: []
+---
+
+# T007: Detail Overlay Spacing and Card Word-Wrap
+
+## Acceptance Criteria
+
+- Task detail overlay shows a blank line between `"Acceptance Criteria:"` heading and the first bullet item
+- Task detail overlay shows a blank line between `"Implementation Plan:"` heading and the first checklist item
+- Card titles word-wrap to multiple lines when too long for the available card width, instead of being truncated with `…`
+- Cards grow vertically to accommodate wrapped titles
+- Short titles remain single-line (no visual change for titles that fit)
+- All existing card visual structure (phase glyph, ID line, focus border) is preserved
+
+## Implementation Plan
+
+- [ ] Edit `internal/board/detail.go` — add `""` entry after the `Acceptance Criteria:` heading line and after the `Implementation Plan:` heading line.
+- [ ] Edit `internal/board/detail.go` — make `wrapText` and `splitLongWord` exported (capitalize) so they can be reused from `card.go`.
+- [ ] Edit `internal/board/card.go` — replace `truncate(t.Title, inner)` with a multi-line approach that word-wraps the title across available width.
+- [ ] Edit `internal/board/card.go` — combine wrapped title lines with newlines in the card content (joining with `\n`).
+- [ ] Run `make build && make test` to verify no regressions.
+
+## Context Log
+
+Files read:
+- `internal/board/detail.go`
+- `internal/board/card.go`
+- `internal/board/column.go`
+
+Estimated input tokens: 600
+
+Notes:

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T008-checkbox-states.md

@@ -0,0 +1,38 @@
+---
+id: E06-atari-noir-layout/T008-checkbox-states
+status: planned
+objective: "Parse and render checked/unchecked state for Implementation Plan checklist items"
+depends_on: []
+---
+
+# T008: Parse and Render Checkbox States in Task Detail
+
+## Acceptance Criteria
+
+- `Task.Checklist` stores the checked state of each item (not just the text)
+- `- [x]` markers in the markdown source are parsed as "done" items
+- `- [ ]` markers in the markdown source are parsed as "undone" items
+- Legacy `- ` (no checkbox prefix) items are treated as undone
+- The task detail overlay renders done items with a `☑` (checked box) glyph and undone items with `□` (empty box)
+- Done items render in the `TagDone` (green) style; undone items render in `CardMeta` (dim) style
+- All existing `make test` tests pass, with updates to any tests that construct `Checklist` values
+
+## Implementation Plan
+
+- [ ] Edit `internal/data/task.go` — add `CheckItem` struct with `Text string` and `Done bool` fields; change `Checklist []string` to `Checklist []CheckItem`.
+- [ ] Edit `internal/data/parser.go` — update `extractChecklistSection()` to detect `- [x] ` vs `- [ ] ` vs `- ` prefixes and set `Done` accordingly; strip prefix from `Text`.
+- [ ] Update all usages of `Checklist` across the codebase (likely only `board/detail.go` and tests).
+- [ ] Edit `internal/board/detail.go` — in the Implementation Plan section, render done items with `☑ ` + green `TagDone` styling and undone items with `□ ` + dim `CardMeta` styling.
+- [ ] Run `make build && make test` to verify no regressions.
+
+## Context Log
+
+Files read:
+- `internal/data/task.go`
+- `internal/data/parser.go`
+- `internal/board/detail.go`
+- `internal/styles/styles.go`
+
+Estimated input tokens: 800
+
+Notes:

package/.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T009-router-priority-marker.md

@@ -0,0 +1,41 @@
+---
+id: E06-atari-noir-layout/T009-router-priority-marker
+status: planned
+objective: "Highlight the router priority task with a green marker on the card and optional text highlight"
+depends_on: []
+---
+
+# T009: Highlight Router Priority Task on Board
+
+## Acceptance Criteria
+
+- The model reads `RouterState.Task` (the `task:` field from `router.md`) and stores it as `Model.RouterTask`
+- In the board view, the task card whose ID matches `RouterTask` shows a green `▣` glyph (using `TagDone`/green style) instead of the normal phase-colored glyph
+- Non-priority tasks keep their existing phase-colored glyphs unchanged
+- The task detail overlay shows a `"(router priority)"` label or marker when the displayed task matches `RouterTask`
+- All existing keyboard interactions, column rendering, and card behavior remain intact
+
+## Implementation Plan
+
+- [ ] Edit `internal/board/model.go` — add `RouterTask string` field to `Model`.
+- [ ] Edit `internal/board/board.go` — in `newProjectModel()`, read `routerState.Task` into `model.RouterTask`.
+- [ ] Edit `internal/board/card.go` — update `RenderCard` to accept a `routerTaskID string` parameter; when `t.ID == routerTaskID`, replace the phase glyph with a green `▣` using `TagDone` style.
+- [ ] Edit `internal/board/card.go` — update `RenderCard` signature and callsites (`column.go`, `view.go`).
+- [ ] Edit `internal/board/detail.go` — update `RenderDetail` to accept a `routerTaskID string`; when matching, append a `"(router priority)"` green label line.
+- [ ] Update all callsites of `RenderCard` and `RenderDetail` to pass `m.RouterTask`.
+- [ ] Run `make build && make test` to verify no regressions.
+
+## Context Log
+
+Files read:
+- `internal/board/model.go`
+- `internal/board/board.go`
+- `internal/board/card.go`
+- `internal/board/column.go`
+- `internal/board/detail.go`
+- `internal/data/router.go`
+- `internal/board/view.go`
+
+Estimated input tokens: 1000
+
+Notes:

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

@@ -0,0 +1,61 @@
+---
+id: E06-atari-noir-layout/T010-auto-refresh-watcher
+status: planned
+objective: "Auto-refresh the board when task files change on disk via fsnotify file watcher"
+depends_on: []
+---
+
+# T010: Auto-Refresh Board on File Changes
+
+## Acceptance Criteria
+
+- The board detects task `.md` file changes (write, create, delete) under `.savepoint/releases/` without requiring a restart
+- When a file change is detected, the board reloads all tasks from disk and re-renders the columns
+- Rapid successive file saves (e.g. editor auto-save + format) are debounced — only one reload fires within a 100ms window
+- The watcher does not prevent graceful shutdown (closes on `q`/`ctrl+c`)
+- An in-memory status change via `space`/`backspace` persists to disk via `data.WriteTaskStatus` and triggers the file watcher naturally
+- All existing keyboard navigation, overlay, and column behavior remain intact
+- `go build ./...` and `go test ./...` pass cleanly
+
+## Implementation Plan
+
+- [ ] Add `github.com/fsnotify/fsnotify` to `go.mod`
+- [ ] Create `internal/board/watch.go`:
+  - Define `fileChangeMsg struct{}` and `reloadMsg struct{ tasks []data.Task }`
+  - `watchFiles(w *fsnotify.Watcher) tea.Cmd` — blocks on watcher.Events, drains channel for 100ms, emits single `fileChangeMsg`
+  - `reloadTasks(root string) tea.Cmd` — calls `loadAllTasks(root)` and emits `reloadMsg{tasks}`
+  - `loadAllTasks(root string) ([]data.Task, error)` — extracted from `board.go`, reuses `Discover` + `Parser`
+- [ ] Edit `internal/board/model.go`:
+  - Add `watcher *fsnotify.Watcher` field to `Model`
+  - `Init()` — create watcher, `watcher.AddRecursive(root)` on `.savepoint/releases/`, return `watchFiles(watcher)`
+  - Close watcher in `Init()` if root is empty (test mode)
+- [ ] Edit `internal/board/board.go`:
+  - Extract task-discovery loop from `newProjectModel` into `loadAllTasks(root string) ([]data.Task, error)`
+  - `newProjectModel` calls `loadAllTasks` instead of inline logic
+- [ ] Edit `internal/board/update.go`:
+  - Handle `fileChangeMsg` → return `reloadTasks(m.Root)` cmd
+  - Handle `reloadMsg` → swap `m.AllTasks = msg.tasks`, call `m.refreshTasks()`, return `watchFiles(m.watcher)` to re-subscribe
+  - On quit (`q`/`ctrl+c`), close `m.watcher` before `tea.Quit`
+- [ ] Edit `internal/board/transitions.go`:
+  - In `Advance` / `Retreat`, call `data.WriteTaskStatus(taskPath, task, expectedMtime)` to persist to disk so the watcher picks it up
+- [ ] Run `go build ./...` and `go test ./...` to verify no regressions
+
+## Context Log
+
+Files read:
+- `internal/board/model.go`
+- `internal/board/board.go`
+- `internal/board/update.go`
+- `internal/board/transitions.go`
+- `internal/board/watch.go` (does not exist yet)
+- `internal/data/write.go`
+- `.savepoint/AGENTS.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/Design.md`
+- `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T009-router-priority-marker.md`
+
+Estimated input tokens: 1800
+
+Notes:
+- The watcher watches `.savepoint/releases/` recursively. `fsnotify` v1.7+ supports `AddWith(path, fsnotify.Recursive)` on macOS/Windows; on Linux, fall back to walking and adding each subdirectory.
+- The 100ms debounce in `watchFiles` collapses rapid write sequences (e.g. editor save + lsp format) into a single reload.
+- `WriteTaskStatus` needs the task file path. Task struct may need a `Path` field populated at load time to make persistence possible.

package/.savepoint/releases/v1/epics/_archived/E01-archive-and-reset/Design.md

@@ -0,0 +1,39 @@
+---
+type: epic-design
+status: planned
+---
+
+# Epic E01: Archive and Reset
+
+## Purpose
+
+Archive all v1 epics, reset the project to a clean slate, and establish the v1 release structure for the simplified savepoint. This epic is pure filesystem and metadata housekeeping — no code changes.
+
+## What this epic adds
+
+- `_archived/` directory containing all 11 original v1 epics (E01–E11).
+- A rewritten `PRD.md` scoped to the simplified savepoint: board-only CLI, phase model, no audit pipeline.
+- Five new epic directories under `releases/v1/epics/` with Design.md stubs.
+- A rewritten `router.md` pointing at the first new epic.
+
+## Definition of Done
+
+- All 11 original epic directories live under `releases/v1/epics/_archived/`.
+- `releases/v1/PRD.md` describes the simplified scope.
+- Five new epic directories exist: E01-archive-and-reset, E02-domain-phase-model, E03-cli-simplify, E04-board-phase-integration, E05-project-cleanup.
+- `router.md` uses the 3-state model (`planning`, `building`, `reviewing`) and points at E01.
+- No references to old epics remain in active files.
+
+## Components and files
+
+| Path | Purpose |
+|------|---------|
+| `releases/v1/epics/_archived/` | Archive of all original v1 epics |
+| `releases/v1/PRD.md` | Rewritten release scope for simplified savepoint |
+| `releases/v1/epics/E01-archive-and-reset/Design.md` | This file |
+| `releases/v1/epics/E01-archive-and-reset/tasks/` | Archive + reset tasks |
+| `releases/v1/epics/E02-domain-phase-model/Design.md` | Phase model epic stub |
+| `releases/v1/epics/E03-cli-simplify/Design.md` | CLI simplification epic stub |
+| `releases/v1/epics/E04-board-phase-integration/Design.md` | Board phase epic stub |
+| `releases/v1/epics/E05-project-cleanup/Design.md` | Cleanup epic stub |
+| `router.md` | 3-state router, points at E01 |

package/.savepoint/releases/v1/epics/_archived/E01-archive-and-reset/tasks/T001-archive-epics.md

@@ -0,0 +1,20 @@
+---
+id: E01-archive-and-reset/T001-archive-epics
+status: planned
+objective: "Move all 11 original v1 epic directories into _archived/"
+depends_on: []
+---
+
+# T001: Archive Epics
+
+## Acceptance Criteria
+
+- All 11 original epic directories (E01-scaffolding through E11-release-validation) exist under `releases/v1/epics/_archived/`.
+- No original epic directories remain under `releases/v1/epics/` except `_archived/`.
+- All task files and Design.md files within archived epics are preserved.
+
+## Implementation Plan
+
+- [ ] Create `releases/v1/epics/_archived/` directory.
+- [ ] Move each of the 11 original epic directories into `_archived/`.
+- [ ] Verify no original epic dirs remain at top level.

package/.savepoint/releases/v1/epics/_archived/E01-archive-and-reset/tasks/T002-rewrite-prd.md

@@ -0,0 +1,22 @@
+---
+id: E01-archive-and-reset/T002-rewrite-prd
+status: planned
+objective: "Rewrite releases/v1/PRD.md with simplification scope"
+depends_on: [E01-archive-and-reset/T001-archive-epics]
+---
+
+# T002: Rewrite PRD
+
+## Acceptance Criteria
+
+- `releases/v1/PRD.md` defines the simplified savepoint scope.
+- Scope includes: board-only CLI, phase model (build/test/audit), no audit pipeline, no init command, no doctor command.
+- PRD frontmatter is valid: `version`, `name`, `status`.
+- No references to the full 11-epic v1 scope remain in the active PRD.
+
+## Implementation Plan
+
+- [ ] Read existing PRD.md for reference.
+- [ ] Write new PRD.md with simplified scope: board command, phase model, minimal CLI.
+- [ ] Update frontmatter: status = in_progress, version = 1.
+- [ ] List 5 new epics in scope table.

package/.savepoint/releases/v1/epics/_archived/E01-archive-and-reset/tasks/T003-create-epic-stubs.md

@@ -0,0 +1,24 @@
+---
+id: E01-archive-and-reset/T003-create-epic-stubs
+status: planned
+objective: "Create 5 new epic directories with Design.md stubs"
+depends_on: [E01-archive-and-reset/T002-rewrite-prd]
+---
+
+# T003: Create Epic Stubs
+
+## Acceptance Criteria
+
+- Five epic directories exist under `releases/v1/epics/`: E01-archive-and-reset, E02-domain-phase-model, E03-cli-simplify, E04-board-phase-integration, E05-project-cleanup.
+- Each epic directory contains a `Design.md` with valid frontmatter (`type: epic-design`, `status: planned`).
+- Each Design.md contains Purpose, What this epic adds, Definition of Done, and Components sections.
+- Each epic has a `tasks/` subdirectory.
+
+## Implementation Plan
+
+- [ ] Create directory structure for each epic.
+- [ ] Write Design.md for E02-domain-phase-model.
+- [ ] Write Design.md for E03-cli-simplify.
+- [ ] Write Design.md for E04-board-phase-integration.
+- [ ] Write Design.md for E05-project-cleanup.
+- [ ] Verify all 5 epic dirs exist with Design.md.

package/.savepoint/releases/v1/epics/_archived/E01-archive-and-reset/tasks/T004-update-router.md

@@ -0,0 +1,22 @@
+---
+id: E01-archive-and-reset/T004-update-router
+status: planned
+objective: "Rewrite router.md with 3-state model and point at E01"
+depends_on: [E01-archive-and-reset/T003-create-epic-stubs]
+---
+
+# T004: Update Router
+
+## Acceptance Criteria
+
+- `router.md` defines 3 states: `planning`, `building`, `reviewing`.
+- `router.md` points at epic `E01-archive-and-reset` as the active epic.
+- `router.md` contains a `## Current state` yaml block with valid frontmatter.
+- No references to old 6-state model remain.
+
+## Implementation Plan
+
+- [ ] Read existing router.md.
+- [ ] Rewrite state machine section with 3 states.
+- [ ] Update Current state yaml block: state = planning, release = v1, epic = E01-archive-and-reset.
+- [ ] Verify yaml is parseable.

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/Design.md

@@ -0,0 +1,118 @@
+---
+type: epic-design
+status: audited
+audited: 2026-04-27
+---
+
+# Epic E01: scaffolding
+
+## Purpose
+
+Create the minimum production-ready TypeScript package foundation for `savepoint`, including build, test, lint, formatting, package metadata, and source tree conventions. This epic establishes the first auditable codebase baseline without implementing user-facing Savepoint behavior.
+
+## What this epic adds
+
+- A single-package Node 20.10+ TypeScript project using ESM.
+- npm package metadata for package name `savepoint` and binary name `savepoint`.
+- A `tsup` build that emits `dist/cli.js` with a Node shebang.
+- Strict TypeScript configuration.
+- Vitest test setup for future unit and integration tests.
+- ESLint and Prettier configuration for mechanical quality gates.
+- A minimal source layout that future epics can extend.
+- Baseline npm scripts for build, typecheck, lint, format check, and test.
+- Root documentation and ignore files needed for ordinary OSS development.
+
+## Components and files
+
+Expected files introduced by this epic:
+
+| Path                 | Purpose                                                                  |
+| -------------------- | ------------------------------------------------------------------------ |
+| `package.json`       | Package metadata, bin mapping, scripts, dependencies, files allowlist.   |
+| `package-lock.json`  | Locked dependency graph for repeatable installs.                         |
+| `tsconfig.json`      | Strict TypeScript compiler settings for ESM Node output.                 |
+| `tsup.config.ts`     | Build entry and output configuration.                                    |
+| `vitest.config.ts`   | Test runner configuration.                                               |
+| `eslint.config.js`   | Flat ESLint config for TypeScript.                                       |
+| `.prettierrc.json`   | Formatting rules.                                                        |
+| `.gitignore`         | Ignore generated artifacts and local environment files.                  |
+| `README.md`          | Minimal development README until release docs expand it.                 |
+| `LICENSE`            | MIT license placeholder for the package.                                 |
+| `src/cli.ts`         | Minimal executable entrypoint that prints help/version placeholder text. |
+| `src/version.ts`     | Single source for the package version used by the placeholder CLI.       |
+| `test/smoke.test.ts` | Baseline test proving the test runner and exported constants work.       |
+
+## Architectural delta
+
+Before this epic, the repository contains only planning markdown and Savepoint workflow metadata. After this epic, it becomes an installable npm package skeleton with a compilable CLI entrypoint.
+
+This does not add the actual Savepoint command system. The placeholder `src/cli.ts` exists only to validate packaging, shebang output, and the future binary surface. Real command dispatch belongs to `cli-foundation`.
+
+## Boundaries
+
+In scope:
+
+- Configure the repo as an ESM-only TypeScript package.
+- Make `npm run build`, `npm run typecheck`, `npm run lint`, and `npm test` meaningful.
+- Keep runtime code minimal and dependency-light.
+- Use package and binary name `savepoint`.
+
+Out of scope:
+
+- Argument parsing beyond placeholder help/version output.
+- Reading or writing `.savepoint` project files.
+- Implementing `init`, `board`, `audit`, or `doctor`.
+- Ink, React, TUI rendering, theming, or visual identity work.
+- Template content or Router Pattern prompt assets.
+- Release publishing automation beyond package metadata basics.
+
+## Quality gates
+
+The scaffold should support these commands:
+
+```bash
+npm run build
+npm run typecheck
+npm run lint
+npm test
+```
+
+The first audit after this epic should be able to update `AGENTS.md` with a codebase map that reflects the new top-level modules.
+
+## Design constraints
+
+- Keep files small and obvious; no framework or architecture abstractions before there is behavior to organize.
+- Use strict typing from the first commit.
+- Avoid `any`.
+- Keep config conventional enough that a vibe coder can recognize and modify it.
+- Do not add native dependencies.
+- Do not add telemetry, update checks, analytics, or postinstall scripts.
+
+## Open decisions
+
+- The exact dependency versions are implementation details, but they should be current stable versions compatible with Node 20.10+.
+- `README.md` should stay intentionally sparse in this epic; fuller public-facing docs belong to `docs-and-packaging`.
+
+## Implemented as
+
+Implemented on 2026-04-27 across tasks T001–T005. All quality gates pass.
+
+**Deviations from original design:**
+
+| Item                         | Deviation                | Reason                                                                                                                                                                                     |
+| ---------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `vitest.config.js`           | Extra file not in design | `npm test` requires `--configLoader runner` pointing at a `.js` config on Windows; `.ts` config cannot be loaded directly in this execution path                                           |
+| `scripts/vitest-preload.cjs` | Extra file not in design | Windows runner executes a `net use` child_process call during Vitest startup; this CJS preload stubs that call and also stubs esbuild transforms to avoid a secondary Windows compat issue |
+| `.prettierignore`            | Extra file not in design | Standard convention; consistent with `.gitignore` exclusions                                                                                                                               |
+
+**Dependency versions (pinned):**
+
+| Package             | Version |
+| ------------------- | ------- |
+| `typescript`        | ^5.8.3  |
+| `tsup`              | ^8.5.1  |
+| `vitest`            | ^3.2.4  |
+| `eslint`            | ^9.33.0 |
+| `typescript-eslint` | ^8.39.0 |
+| `prettier`          | ^3.6.2  |
+| `@types/node`       | ^24.1.0 |

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/handoff.md

@@ -0,0 +1,9 @@
+# E01-scaffolding Handoff
+
+Read this instead of the full audit unless debugging scaffold history.
+
+- Package scaffold exists for `savepoint` version `0.1.0`.
+- Commands available through npm: `build`, `typecheck`, `lint`, `format:check`, and `test`.
+- Windows test execution uses `scripts/vitest-preload.cjs` plus `vitest.config.js`.
+- Source baseline: `src/cli.ts`, `src/version.ts`, and `test/smoke.test.ts`.
+- Carried forward to `E03-cli-foundation`: real CLI dispatch tests and the decision on whether `version.ts` should derive from `package.json`.

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/tasks/T001-package-baseline.md

@@ -0,0 +1,45 @@
+---
+id: E01-scaffolding/T001-package-baseline
+status: done
+objective: "Establish the `savepoint` npm package identity and baseline repository hygiene files without implementing CLI behavior."
+depends_on: []
+---
+
+# Task T001: Package Baseline
+
+## Implementation Plan
+
+- [x] Draft `package.json` with package name, binary mapping, Node engine, and module type.
+- [x] Add `.gitignore` for generated, dependency, coverage, and local environment artifacts.
+- [x] Add minimal `README.md` content that describes the repo as the `savepoint` scaffold.
+- [x] Add MIT `LICENSE` text for the package baseline.
+- [x] Verify the files align with the package and binary name `savepoint`.
+
+## Scope
+
+Create the root package and repository metadata that every later scaffolding task builds on.
+
+Expected files:
+
+- `package.json`
+- `.gitignore`
+- `README.md`
+- `LICENSE`
+
+## Acceptance Criteria
+
+- `package.json` uses package name `savepoint`.
+- `package.json` declares binary name `savepoint` pointing at `dist/cli.js`.
+- `package.json` declares Node `>=20.10`.
+- `package.json` is ESM-only with `"type": "module"`.
+- `README.md` is intentionally minimal and development-focused.
+- `LICENSE` contains MIT license text.
+- `.gitignore` excludes generated build, dependency, coverage, and local environment artifacts.
+
+## Out Of Scope
+
+- TypeScript configuration.
+- Build tooling.
+- Test tooling.
+- Lint or format tooling.
+- Real command behavior.