savepoint 1.0.2 → 1.0.4

package/.savepoint/audit/v1/E01-go-setup/proposals.md

@@ -1,166 +0,0 @@
-# E01-go-setup Audit Proposals
-
-## Target File
-
-`.savepoint/Design.md`
-
-## Replace
-
-```md
-## 12. Distribution & build
-
-- **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.
-- **Baseline scaffold:** established in epic `E01-scaffolding` (2026-04-27). Package name `savepoint`, version `0.1.0`. Build, typecheck, lint, format, and test gates all pass.
-```
-
-## With
-
-```md
-## 12. Distribution & build
-
-- **License:** MIT.
-- **Install:** local Go build during the rewrite; public install channel remains release work.
-- **Runtime:** Go 1.23+ target, single native binary. macOS / Linux / Windows-Terminal.
-- **Repo:** Go module `github.com/opencode/savepoint`. Build with `go build`; test with `go test ./...`.
-- **No telemetry.** Ever.
-- **Go baseline scaffold:** established in epic `E01-go-setup` (2026-05-01). The project now has `go.mod`, `go.sum`, `main.go`, `internal/board`, and Makefile shortcuts for build/test/run/clean.
-```
-
-## Target File
-
-`.savepoint/Design.md`
-
-## Insert After
-
-```md
-## 8. TUI
-```
-
-## With
-
-```md
-
-**Go rewrite baseline:** E01 creates a minimal Bubble Tea shell in `internal/board`. The root `main.go` delegates process startup to `board.Run()`, which owns the Bubble Tea program lifecycle. Later board epics should move richer rendering, input state, and styling into focused packages rather than expanding `main.go`.
-```
-
-## Target File
-
-`AGENTS.md`
-
-## Replace
-
-~~~~md
-## Build / Test / Run
-
-```bash
-npm run build        # compile src/ → dist/cli.js via tsup (ESM, node20)
-npm run typecheck    # tsc --noEmit strict check (NodeNext)
-npm run lint         # eslint flat config — rejects any in TypeScript
-npm run format:check # prettier check across src, test, config, markdown
-npm test             # vitest smoke suite
-```
-~~~~
-
-## With
-
-````md
-## Build / Test / Run
-
-```bash
-go build ./...       # compile all Go packages
-go test ./...        # run Go test suite
-make build           # shortcut: go build -o savepoint main.go
-make test            # shortcut: go test ./...
-make run             # shortcut: go run main.go
-```
-````
-
-## Target File
-
-`AGENTS.md`
-
-## Replace
-
-```md
-<!-- AUTO-GENERATED BY savepoint audit. Do not edit manually. -->
-```
-
-## With
-
-```md
-<!-- AUTO-GENERATED BY savepoint audit. Do not edit manually. -->
-
-| Module                    | Epic                                                                    | Purpose                                                         |
-| ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------- |
-| `go.mod`                  | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Go module definition for the Savepoint CLI rewrite              |
-| `go.sum`                  | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Dependency checksums for Bubble Tea, Lip Gloss, YAML, and deps  |
-| `main.go`                 | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Process entrypoint; delegates Bubble Tea startup to board.Run   |
-| `Makefile`                | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Local build, test, run, and clean shortcuts                     |
-| `internal/board/board.go` | [E01-go-setup](.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md)     | Minimal Bubble Tea model, quit handling, and program lifecycle  |
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
-
-## Replace
-
-```md
-status: planned
-```
-
-## With
-
-```md
-status: audited
-```
-
-## Target File
-
-`.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
-
-## Insert After
-
-```md
-## Components and files
-```
-
-## With
-
-```md
-
-## Implemented as
-
-- `go.mod` uses module path `github.com/opencode/savepoint` and Go `1.26.2` in the current local toolchain.
-- `main.go` is intentionally thin and delegates to `internal/board.Run()`.
-- `internal/board/board.go` contains the first Bubble Tea model, `q`/`ctrl+c` quit handling, and the program runner.
-- `Makefile` provides build/test/run/clean shortcuts, but `make` is not available in the audited Windows environment.
-- `cmd/` and `internal/styles/` currently exist as empty directories. Add placeholder files if those directories must survive git checkout before later epics add code.
-```
-
-## Quality Review
-
-## Must Fix Before Close
-
-- `internal/data/discover_test.go` fails `go test ./...` because imports `os` and `path/filepath` are unused. This is active E02 work, not E01 code, but it blocks the repo-level quality gate.
-
-## Must Fix Before Next Epic
-
-- `AGENTS.md` and `.savepoint/Design.md` still describe the old TypeScript/npm architecture and quality gates in several sections. Apply or refine the proposal sections above so future agents do not follow stale commands.
-- `cmd/` and `internal/styles/` are empty directories. Git will not preserve them unless later code lands there or placeholders are added.
-
-## Carry Forward
-
-- `internal/board/board.go` currently writes errors to stderr inside `Run()` and `main.go` panics on the returned error. Before the CLI grows real command handling, centralize boundary error presentation so failures do not double-report or emit stack-like panic output.
-- `Makefile` uses `rm -f savepoint`, which is fine under POSIX shells but is not enough for native Windows cleanup of `savepoint.exe`. Consider making clean cross-platform or documenting the expected shell.
-
-## Already Fixed
-
-- `go build ./...` passes outside the sandbox.
-- The root TypeScript scaffold files are removed from the working tree as required by the E01 definition of done.
-- `main.go` delegates to `internal/board`, and `q`/`ctrl+c` quit handling is implemented.
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md` now has checked implementation items and a `## Context Log`.

package/.savepoint/audit/v1/E01-go-setup/snapshot.md

@@ -1,71 +0,0 @@
----
-type: audit-snapshot
-epic: E01-go-setup
-created: 2026-05-01
-mode: manual
----
-
-# E01-go-setup Audit Snapshot
-
-Manual snapshot created because the router was already on E02 and the audit CLI is not the source of truth for this Go rewrite state.
-
-## Epic Scope
-
-- Initialize Go module `github.com/opencode/savepoint`.
-- Add Bubble Tea, Lip Gloss, and YAML dependencies.
-- Add root `main.go` entrypoint.
-- Add `internal/board` Bubble Tea shell.
-- Add `cmd/`, `internal/data/`, and `internal/styles/` directories.
-- Add `Makefile` targets for build, test, run, and clean.
-- Remove the old TypeScript/npm root scaffold.
-
-## Files Read
-
-- `.savepoint/router.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T002-entrypoint.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T003-directory-structure.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T004-makefile.md`
-- `agent-skills/ink-tui-design/SKILL.md`
-- `.savepoint/visual-identity.md`
-- `.savepoint/Design.md`
-- `AGENTS.md`
-- `go.mod`
-- `go.sum`
-- `main.go`
-- `internal/board/board.go`
-- `Makefile`
-
-## Changed Files in Epic Scope
-
-- `go.mod`
-- `go.sum`
-- `main.go`
-- `internal/board/board.go`
-- `Makefile`
-- `.savepoint/releases/v1/epics/E01-go-setup/E01-Detail.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T001-init-module.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T002-entrypoint.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T003-directory-structure.md`
-- `.savepoint/releases/v1/epics/E01-go-setup/tasks/T004-makefile.md`
-
-## Directory Checks
-
-- `cmd/` exists.
-- `internal/board/` exists and contains `board.go`.
-- `internal/data/` exists but currently contains E02 data-reader work, outside E01 scope.
-- `internal/styles/` exists but is empty.
-
-## Verification
-
-- `go env GOVERSION`: `go1.26.2`
-- `go build ./...`: pass when run outside the sandbox.
-- `go test ./...`: fail. Failure is in `internal/data/discover_test.go` from active E02 work: unused imports `os` and `path/filepath`.
-- `make test`: not runnable in this Windows environment because `make` is not installed.
-
-## Notes
-
-- The router currently points to `E02-data-readers/T001-task-struct`, so this audit is an explicit manual override for E01.
-- The working tree contains a broad TypeScript-to-Go rewrite. Deleted TypeScript files are not treated as E01 regressions because the E01 design explicitly requires removing the TypeScript root scaffold.
-- Empty directories such as `cmd/` and `internal/styles/` are not represented by `git ls-files` unless placeholder files are added.

package/.savepoint/audit/v1/E01-scaffolding/proposals/AGENTS.md

@@ -1,66 +0,0 @@
-# Agents Guide
-
-Welcome, AI agent. This project (`savepoint`) uses its own conventions to manage its own build. You are about to dogfood the workflow.
-
-## Workflow
-
-Before doing anything, read `.savepoint/router.md`. That file routes you to the next file based on the project's current state.
-
-When you are about to write code, you must first read, in order:
-
-1. `.savepoint/PRD.md` — what we are building and why
-2. `.savepoint/Design.md` — how the system is architected
-3. The release PRD: `.savepoint/releases/v1/v1-PRD.md`
-4. The epic E##-Detail.md: `.savepoint/releases/v1/epics/{epic}/E##-Detail.md`
-5. The active task file: `.savepoint/releases/v1/epics/{epic}/tasks/{NNN}-*.md`
-
-**Conditional read:** if the active task touches TUI rendering, theme, or visual design, also read `.savepoint/visual-identity.md`. Otherwise skip it — it's ~1.8K tokens you don't need.
-
-**Do not load files outside the current task scope** unless the task requires it. Token discipline is the wedge of this product; we honor it on ourselves.
-
-## Build / Test / Run
-
-```bash
-npm run build        # compile src/ → dist/cli.js via tsup (ESM, node20)
-npm run typecheck    # tsc --noEmit strict check (NodeNext)
-npm run lint         # eslint flat config — rejects any in TypeScript
-npm run format:check # prettier check across src, test, config, markdown
-npm test             # vitest smoke suite
-```
-
-> **Windows note:** `npm test` uses a custom preload script (`scripts/vitest-preload.cjs`) and `vitest.config.js` (not `.ts`) to work around a Windows-specific child_process/esbuild issue. This is transparent when running through npm scripts.
-
-## Code Style
-
-1. **One job per file.** If a file does two things, split it.
-2. **One-sentence rule.** If you can't describe a function in one sentence, refactor.
-3. **Test what branches.** Logic with if/else/switch gets a test. Pure rendering: skip.
-4. **Types are documentation.** No `any`. Let the compiler help.
-5. **Build, don't speculate.** No code for hypothetical futures.
-6. **Errors at boundaries.** Handle failure where data enters or leaves the system.
-7. **One source of truth.** State lives in one place. No syncing copies.
-8. **Comments explain WHY,** not what. If removing the comment wouldn't confuse a future reader, delete it.
-9. **Content in data files.** Markdown/JSON/YAML, not strings in code.
-10. **Small diffs.** Each task touches as few files as possible.
-
-## Codebase Map
-
-<!-- AUTO-GENERATED BY savepoint audit. Do not edit manually. -->
-
-| Module               | Epic                                                                      | Purpose                                              |
-| -------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- |
-| `src/cli.ts`         | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/E01-Detail.md) | CLI entrypoint; placeholder help/version output      |
-| `src/version.ts`     | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/E01-Detail.md) | Single source for package version string             |
-| `test/smoke.test.ts` | [E01-scaffolding](.savepoint/releases/v1/epics/E01-scaffolding/E01-Detail.md) | Baseline Vitest smoke test proving test runner works |
-
-<!-- END AUTO-GENERATED -->
-
-## CLI rules for agents
-
-**Never run `savepoint` commands.** The CLI is for the human. Edit files directly.
-
-(For this repo specifically: `savepoint` doesn't exist yet — we're building it. Even once it exists, this rule stands.)
-
-## Recommended planning models
-
-For PRD/Design/Task planning, this workflow assumes a top-tier model: Claude Opus, Gemini 2.5 Pro, GPT-5.5, or equivalent. Lighter models may not follow embedded prompt instructions reliably. If you are not one of those, advise the user before proceeding with planning steps.

package/.savepoint/audit/v1/E01-scaffolding/proposals/Design.md

@@ -1,210 +0,0 @@
----
-type: project-design
-status: active
-last_audited: E01-scaffolding (2026-04-27)
----
-
-# Savepoint — System Architecture
-
-> Project-level architecture. Audit-kept fresh: every epic's audit step merges its delta into this document.
->
-> **Visual identity** lives separately in `.savepoint/visual-identity.md` and is loaded only for TUI/theme/visual tasks.
-
-## 1. Architecture model
-
-- **File-only.** No MCP server in v1. Agents read and edit Markdown + YAML files directly using their native file tools.
-- **Agent-agnostic via the Router Pattern:**
-  1. `AGENTS.md` at the project root (spec-compliant; readable by all major coding agents).
-  2. `AGENTS.md` routes the agent into `.savepoint/router.md` (the state-machine file).
-  3. `.savepoint/router.md` conditionally points the agent at the next template prompt based on project state.
-  4. Templates contain **embedded HTML-comment instructions** (`<!-- AGENT: ... -->`) the agent follows verbatim.
-- **Token-efficiency principle.**
-  - Cold session bootstrap: ~5–7K tokens (one-time per conversation).
-  - Per-task incremental: <2KB.
-  - Audit: 5–15KB.
-  - Anything that breaks these bounds violates the wedge.
-
-## 2. Directory layout
-
-```
-<project-root>/
-├── AGENTS.md                       ← uppercase, spec-standard, agent entry point
-└── .savepoint/
-    ├── PRD.md                      ← project vision (rare changes)
-    ├── Design.md                   ← project architecture (this file)
-    ├── visual-identity.md          ← design system; loaded conditionally for TUI work
-    ├── router.md                   ← state-machine routing
-    ├── config.yml                  ← theme, quality_gates, verify_strict
-    ├── audit/
-    │   └── {E##-epic}/
-    │       ├── snapshot.md
-    │       └── proposals/
-    └── releases/
-        └── v1/
-            ├── PRD.md              ← release-scoped PRD
-            └── epics/
-                └── E##-{epic-name}/
-                    ├── Design.md   ← epic delta
-                    └── tasks/
-                        └── T001-slug.md
-```
-
-- `AGENTS.md` is at root (uppercase, cross-vendor spec).
-- `Design.md` lives in `.savepoint/` (working doc, not public-facing).
-- `visual-identity.md` is conditional — only loaded by router for TUI/theme/visual tasks.
-- **Subtasks are inline checklists** inside the task `.md` — never separate files.
-- Epic folders are prefixed for navigation (`E01-scaffolding/`). Task files and IDs are prefixed the same way (`T001-package-baseline.md`).
-
-## 3. Hierarchy semantics
-
-| Level        | Definition                                                                             |
-| ------------ | -------------------------------------------------------------------------------------- |
-| **Release**  | The thing being built. One PRD per release. v1 = MVP.                                  |
-| **Epic**     | A major feature within a release. Has its own Design.md (delta from project Design).   |
-| **Task**     | Independently buildable. Objective-led. **Requires implementation plan before build.** |
-| **Sub-task** | Inline checklist item — _evidence of the implementation plan_, not standalone work.    |
-
-## 4. Status model & gates
-
-Five statuses, with explicit gates:
-
-| Status        | Meaning                           | Entry gate                                    |
-| ------------- | --------------------------------- | --------------------------------------------- |
-| `backlog`     | Task exists, no plan              | created                                       |
-| `planned`     | Implementation plan written       | plan section non-empty                        |
-| `in_progress` | AI building                       | all `depends_on` are `done`                   |
-| `review`      | Build done, awaiting verification | all sub-tasks checked off                     |
-| `done`        | Verified, locked                  | assertion + (configurable) quality gates pass |
-
-- `blocked` is a **flag**, not a status — `in_progress` + `blocked: "reason"` is valid.
-- Reverts allowed; reverting from `done` warns about audit staleness.
-- **Verification mode is configurable per project** (`verify_strict: true|false`). Default: `false` (vibe-coder soft mode).
-
-## 5. Dependencies
-
-- Declared in YAML frontmatter: `depends_on: [E##-epic/T###-task-id, ...]` (repo-relative IDs).
-- Cross-epic deps allowed but warned (signal that epic boundaries may be wrong).
-- TUI shows blocked tasks as visually locked.
-- `savepoint doctor` detects cycles.
-
-## 6. CLI surface (5 commands, no more)
-
-| Command                | Purpose                                                                           |
-| ---------------------- | --------------------------------------------------------------------------------- |
-| `savepoint init`       | Scaffold `.savepoint/`, print magic prompt to stdout + clipboard                  |
-| `savepoint board`      | Launch TUI; auto-falls-back to plain table on non-TTY                             |
-| `savepoint audit`      | Run audit pipeline (`--skip --reason`, `--epic`)                                  |
-| `savepoint doctor`     | Integrity check + ad-hoc quality-gate run + Layer-2 prompt for AI semantic review |
-| `--version` / `--help` | Standard                                                                          |
-
-- Bare `savepoint` prints help.
-- **Explicitly rejected:** `task new`, `epic new`, `release new`, `plan`, `next`, `status`, `task done`. All are file edits or TUI actions.
-- **Agents must not run `savepoint` commands.** Stated in AGENTS.md.
-
-**Names:** npm package `savepoint`; binary `savepoint`. No `vk` alias.
-
-## 7. Audit pipeline (6 steps)
-
-```
-0. Quality Gates  — CLI runs configured commands. Halts on failure if block_on_failure: true.
-1. Snapshot       — CLI writes file tree (gitignore-respecting) + changed-files list. NO code contents.
-2. Diff Brief     — State flips to audit_pending: {E##-epic}. Magic prompt printed to user.
-3. Reconcile      — Agent reads epic Design + snapshot + scoped code. Writes proposed updates to
-                    .savepoint/audit/{E##-epic}/proposals/.
-4. Review         — TUI shows side-by-side per-proposal diff. Approve / reject / edit each.
-5. Commit         — Approved proposals overwrite live files. Epic gets status: audited. Next epic unlocks.
-```
-
-- **First epic = E01-scaffolding by convention.** First audit establishes the baseline. ✓ _E01-scaffolding audited 2026-04-27._
-- `audit_pending` is a **hard gate**: next epic's tasks cannot enter `in_progress` until prior epic is `audited`.
-- **High-divergence guard:** if a proposal changes >50% of the live file, TUI requires extra confirmation (threshold tunable in `config.yml`).
-- **Skip allowed** via `savepoint audit --skip --reason "..."`. Logged to `.savepoint/audit-log.md`. Permanent `⚠ skipped` badge in TUI.
-- **Codebase Map** auto-generated in `AGENTS.md` between markers — one line per top-level module pointing to its epic Design.
-
-### Quality gates (audit step 0)
-
-```yaml
-# .savepoint/config.yml
-quality_gates:
-  lint: "<command>" # null to disable
-  typecheck: "<command>"
-  test: "<command>"
-  block_on_failure: true
-```
-
-Three layers:
-
-- **Layer 1 (mechanical):** user's chosen linter (we recommend, don't ship). TS: `eslint` + `dependency-cruiser`. Python: `radon` + `pylint`. Go: `gocyclo` + `staticcheck`. **Cross-language fallback:** `lizard`.
-- **Layer 2 (AI semantic review):** baked into the audit reconcile prompt. Outputs `quality-review.md` proposal. **Advisory, not blocking.**
-- **Layer 3:** `savepoint doctor` runs Layer 1 + prints Layer 2 prompt for ad-hoc use.
-
-## 8. TUI
-
-**Theming:** Atari-Noir is the default theme. **For full design tokens, palette, and rendering rules, see `.savepoint/visual-identity.md`** (loaded conditionally for TUI tasks). Live values in `config.yml` `theme:` section.
-
-Acknowledged terminal limits: fonts, scanlines, glows, letter-spacing, mouse-driven motion don't translate. Lean on color discipline + box-drawing geometry + uppercase headings.
-
-**Render fallbacks:** 256-color → 16-color hard-coded → `NO_COLOR=1` monochrome with glyphs → non-TTY plain table.
-
-**Layout:** single screen — header (release/epic context) + 5-column Kanban + detail pane.
-
-**Keybindings:** arrow + vim. `space`/`enter`/`e`/`r`/`R`/`E`/`A`/`q`. **No file watching MVP** (manual `r` refresh).
-
-**Out of MVP:** file watching, drag-and-drop, multi-select, search, inline editing.
-
-## 9. Concurrency
-
-- **mtime-based optimistic concurrency.** TUI reads mtime, re-stats before write, prompts "Reload? [Y/n]" on conflict.
-- Agents edit freely; the TUI defers.
-- **No lockfile.**
-
-## 10. Release versioning (PRDs)
-
-- Sequential integer (`v1`, `v2`). Optional `name` in YAML.
-- `savepoint doctor` warns when creating `v2` while `v1` has un-audited epics.
-
-## 11. Failure modes
-
-All routed through `savepoint doctor`. Doctor diagnoses and proposes; never auto-destructive.
-
-| Failure                                      | Behavior                                                    |
-| -------------------------------------------- | ----------------------------------------------------------- |
-| Corrupt YAML                                 | Doctor flags file:line. TUI marks `⚠ corrupt`, refuses ops. |
-| Missing dep                                  | Doctor flags. TUI shows `⚠ broken dep`.                     |
-| Dependency cycle                             | Doctor refuses to start either side; prints cycle path.     |
-| Duplicate task ID                            | Doctor flags.                                               |
-| Audit proposals without `audit_pending` flag | Doctor offers cleanup or restore.                           |
-| Task in nonexistent epic                     | Doctor moves to `.savepoint/orphans/`.                      |
-| Missing `config.yml`                         | All commands except `init` refuse.                          |
-| Unknown CLI flag                             | Show help, exit 1.                                          |
-
-## 12. Distribution & build
-
-- **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.
-- **Baseline scaffold:** established in epic `E01-scaffolding` (2026-04-27). Package name `savepoint`, version `0.1.0`. Build, typecheck, lint, format, and test gates all pass.
-
-## 13. Testing
-
-| Layer                                                    | Tool                             | Coverage                                                               |
-| -------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------- |
-| Unit: file ops, YAML, frontmatter, snapshot gen          | `vitest`                         | High                                                                   |
-| Unit: state transitions, dep resolution, cycle detection | `vitest`                         | High                                                                   |
-| Integration: CLI commands in temp dirs                   | `vitest` + `tmp`                 | Medium                                                                 |
-| TUI reducers (state, isolated from rendering)            | `vitest` + `ink-testing-library` | Medium                                                                 |
-| TUI rendering (snapshot tests)                           | —                                | **None.** Brittle.                                                     |
-| End-to-end with real AI agents                           | Manual matrix                    | Pre-release: `[Claude, Cursor, Gemini, Aider]` × `[init, plan, audit]` |
-
-~70% line coverage target; behavior coverage prioritized.
-
-## 14. Package versioning
-
-- `0.1.0` — first public release: scaffolding, status model, CLI, basic TUI, audit (no AI semantic review).
-- `0.2.0` — AI semantic review + broader quality-gate language presets.
-- `0.3.0` — file watching, search.
-- `1.0.0` — MCP server + production stability.
-
-Strict semver. Pre-1.0 minors may break.

package/.savepoint/audit/v1/E01-scaffolding/proposals/epic-Design.md

@@ -1,117 +0,0 @@
----
-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 supports these commands:
-
-```bash
-npm run build
-npm run typecheck
-npm run lint
-npm run format:check
-npm test
-```
-
-## 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 |