savepoint 1.0.3 → 1.0.6

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

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

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

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

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

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

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

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

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

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/tasks/T002-typescript-build.md

@@ -1,48 +0,0 @@
----
-id: E01-scaffolding/T002-typescript-build
-status: done
-objective: "Add the strict TypeScript source layout and `tsup` build that emits the placeholder `savepoint` CLI binary."
-depends_on: [E01-scaffolding/T001-package-baseline]
----
-
-# Task T002: TypeScript Build
-
-## Implementation Plan
-
-- [x] Add `tsconfig.json` with strict NodeNext compilation settings for the scaffold.
-- [x] Add `tsup.config.ts` and a minimal `src/cli.ts` entrypoint that builds to `dist/cli.js`.
-- [x] Add `src/version.ts` as the single source of version metadata used by the CLI placeholder.
-- [x] Add TypeScript and build dependencies to `package.json`.
-- [x] Generate `package-lock.json` from the updated manifest.
-- [x] Verify `npm run build` and `npm run typecheck` pass.
-
-## Scope
-
-Create the minimal source tree and build configuration needed for a compiled CLI placeholder.
-
-Expected files:
-
-- `tsconfig.json`
-- `tsup.config.ts`
-- `src/cli.ts`
-- `src/version.ts`
-- `package-lock.json`
-
-Expected `package.json` updates:
-
-- Add TypeScript/build dependencies.
-- Add `build` and `typecheck` scripts.
-
-## Acceptance Criteria
-
-- `npm run build` emits `dist/cli.js`.
-- The emitted CLI file has a Node shebang.
-- `npm run typecheck` passes under strict TypeScript settings.
-- The placeholder CLI can print version/help placeholder output.
-- No real command dispatch is implemented.
-
-## Out Of Scope
-
-- Argument parsing beyond minimal placeholder output.
-- `init`, `board`, `audit`, or `doctor` behavior.
-- Tests beyond whatever is necessary to validate the build manually.

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/tasks/T003-vitest-smoke.md

@@ -1,43 +0,0 @@
----
-id: E01-scaffolding/T003-vitest-smoke
-status: done
-objective: "Add Vitest configuration and a smoke test that proves the scaffolded package can run automated tests."
-depends_on: [E01-scaffolding/T002-typescript-build]
----
-
-# Task T003: Vitest Smoke Test
-
-## Implementation Plan
-
-- [x] Add Vitest configuration and include pattern for the scaffold smoke test.
-- [x] Add a smoke test that imports scaffolded source and asserts the exported version.
-- [x] Add the Vitest dependency and `test` script to `package.json`.
-- [x] Adjust the scaffold for the Windows runner path so `npm test` executes reliably in this environment.
-- [x] Verify `npm test` and `npm run typecheck` pass.
-
-## Scope
-
-Introduce the test runner and a small smoke test for the existing scaffolded source.
-
-Expected files:
-
-- `vitest.config.ts`
-- `test/smoke.test.ts`
-
-Expected `package.json` updates:
-
-- Add Vitest dependency.
-- Add `test` script.
-
-## Acceptance Criteria
-
-- `npm test` runs Vitest.
-- The smoke test imports TypeScript source.
-- The smoke test verifies stable placeholder behavior such as exported version metadata.
-- Tests do not depend on generated `dist/` output.
-
-## Out Of Scope
-
-- CLI integration tests.
-- Command behavior tests.
-- Filesystem fixture tests.

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/tasks/T004-lint-format-gates.md

@@ -1,45 +0,0 @@
----
-id: E01-scaffolding/T004-lint-format-gates
-status: done
-objective: "Add ESLint and Prettier configuration so the scaffold has mechanical quality gates from the first epic."
-depends_on: [E01-scaffolding/T003-vitest-smoke]
----
-
-# Task T004: Lint And Format Gates
-
-## Implementation Plan
-
-- [x] Add ESLint, TypeScript ESLint, Prettier, and supporting config dependencies to `package.json`.
-- [x] Add `eslint.config.js` with flat-config rules that reject `any` in TypeScript.
-- [x] Add `.prettierrc.json` and ignore rules for generated output.
-- [x] Add `lint` and `format:check` scripts to `package.json`.
-- [x] Verify `npm run lint` and `npm run format:check` pass on the current scaffold.
-- [x] Verify the existing scaffold still passes `npm run build`, `npm test`, and `npm run typecheck`.
-
-## Scope
-
-Add lint and formatting configuration for the TypeScript project.
-
-Expected files:
-
-- `eslint.config.js`
-- `.prettierrc.json`
-
-Expected `package.json` updates:
-
-- Add ESLint, TypeScript ESLint, and Prettier dependencies.
-- Add `lint` and `format:check` scripts.
-
-## Acceptance Criteria
-
-- `npm run lint` passes.
-- `npm run format:check` passes.
-- ESLint is configured with the flat config format.
-- ESLint rejects `any` usage in project TypeScript.
-- Prettier covers source, test, config, and markdown files.
-
-## Out Of Scope
-
-- Language-specific quality presets beyond TypeScript.
-- Dependency boundary tooling.
-- Auto-format command requirements beyond a check script.

package/.savepoint/releases/v1/epics/_archived/E01-scaffolding/tasks/T005-scaffold-verification.md

@@ -1,40 +0,0 @@
----
-id: E01-scaffolding/T005-scaffold-verification
-status: done
-objective: "Verify the complete scaffold through the agreed npm scripts and make any final minimal adjustments needed for the first audit baseline."
-depends_on: [E01-scaffolding/T004-lint-format-gates]
----
-
-# Task T005: Scaffold Verification
-
-## Implementation Plan
-
-- [x] Run the full scaffold command set: build, typecheck, lint, format check, and tests.
-- [x] Inspect the repo for any missing scaffold artifacts or generated files that should stay ignored.
-- [x] Make only minimal corrections if the baseline is still inconsistent.
-- [x] Mark the scaffold task complete once the verification set passes.
-
-## Scope
-
-Run the full scaffold command set and make small corrective edits if any setup task left the baseline inconsistent.
-
-Expected verification commands:
-
-- `npm run build`
-- `npm run typecheck`
-- `npm run lint`
-- `npm run format:check`
-- `npm test`
-
-## Acceptance Criteria
-
-- All expected verification commands pass.
-- `package-lock.json` is present and consistent with `package.json`.
-- `dist/` remains generated output and is not committed as source.
-- The repo is ready for the first epic audit to populate the `AGENTS.md` codebase map.
-
-## Out Of Scope
-
-- Updating `AGENTS.md` codebase map before audit.
-- Implementing command behavior.
-- Public release packaging polish.

package/.savepoint/releases/v1/epics/_archived/E02-data-model/Design.md

@@ -1,142 +0,0 @@
----
-type: epic-design
-status: audited
-audited: 2026-04-27
----
-
-# Epic E02: data-model
-
-## Context Budget
-
-For implementation tasks in this epic, read only:
-
-- `.savepoint/router.md`
-- this epic `Design.md`
-- the active task file
-- directly touched source/test files
-
-Read `.savepoint/Design.md` only if the task changes architecture. Read `.savepoint/releases/v1/PRD.md`, prior epic docs, audit proposals, or `.savepoint/visual-identity.md` only when the active task explicitly requires them.
-
-## Purpose
-
-Build the core file-backed model for releases, epics, tasks, statuses, dependencies, and project configuration. This epic gives later CLI and TUI work a typed domain layer instead of each command parsing markdown independently.
-
-## What this epic adds
-
-- Typed models for releases, epics, tasks, task statuses, dependency IDs, config, and router state.
-- Markdown frontmatter parsing for task and planning files.
-- Readers for `.savepoint/releases/{release}/PRD.md`, epic `Design.md`, and task files.
-- Status transition validation for `planned`, `in_progress`, and `done`, with legacy `backlog` and `review` normalized on read.
-- Dependency resolution, missing dependency detection, and cycle detection.
-- Shared filesystem helpers for scoped `.savepoint` reads.
-- Unit tests for parsing, validation, dependency logic, and state transitions.
-
-## Implementation strategy
-
-- Use structured parsers for YAML/frontmatter and Markdown boundaries.
-- Keep domain types and validation pure; filesystem reads belong in `src/fs/*` and `src/readers/*`.
-- Keep writes out of scope except temporary test fixtures.
-- Make ID parsing understand prefixed epic and task IDs such as `E02-data-model/T001-readers`.
-- Return boundary errors that include the path and reason without forcing callers to parse error text.
-
-## Components and files
-
-Expected files introduced or extended by this epic:
-
-| Path                    | Purpose                                             |
-| ----------------------- | --------------------------------------------------- |
-| `src/domain/status.ts`  | Status values and transition rules.                 |
-| `src/domain/ids.ts`     | Release, epic, and task ID parsing/formatting.      |
-| `src/domain/task.ts`    | Task frontmatter and task document types.           |
-| `src/domain/release.ts` | Release PRD metadata types.                         |
-| `src/domain/config.ts`  | `config.yml` type and defaults.                     |
-| `src/fs/markdown.ts`    | Markdown/frontmatter read helpers.                  |
-| `src/fs/project.ts`     | Project root and `.savepoint` path helpers.         |
-| `src/readers/*.ts`      | Release, epic, task, router, and config readers.    |
-| `src/validation/*.ts`   | Status, dependency, duplicate ID, and cycle checks. |
-| `test/**/*.test.ts`     | Unit tests for the model and validation behavior.   |
-
-## Architectural delta
-
-Before this epic, Savepoint has only a package scaffold. After this epic, it has a reusable domain and read-only persistence layer for the file-based state machine.
-
-This epic intentionally avoids write operations except where tests create fixtures. Writes belong to later command/TUI/audit work once behavior exists.
-
-## Boundaries
-
-In scope:
-
-- Parse markdown frontmatter with clear boundary errors.
-- Model task dependencies using repo-relative task IDs.
-- Detect cycles and broken dependencies.
-- Expose pure validation functions usable by CLI, TUI, audit, and doctor.
-
-Out of scope:
-
-- Creating or editing tasks.
-- Rendering any TUI.
-- Implementing command dispatch.
-- Running quality gates.
-- Writing audit proposals.
-
-## Quality gates
-
-- Branching parser and validator logic must have unit tests.
-- Fixture files should be small and local to tests.
-- Errors should identify the file path and failure reason.
-
-## Design constraints
-
-- Prefer structured parsers over ad hoc string splitting.
-- Keep filesystem access at boundaries; domain validation should be pure.
-- Use one source of truth for status transitions and dependency rules.
-
-## Implemented as
-
-Implemented on 2026-04-27 across tasks T001-T007. The read-only data model landed with focused unit tests and passing mechanical gates after formatting the E02 task markdown.
-
-**Implemented components:**
-
-| Path                             | Result                                                                  |
-| -------------------------------- | ----------------------------------------------------------------------- |
-| `src/domain/ids.ts`              | Release, epic, and full task ID parsing plus formatting helpers.        |
-| `src/domain/status.ts`           | Canonical task status values and transition validation.                 |
-| `src/domain/task.ts`             | Task frontmatter and task document validation.                          |
-| `src/domain/release.ts`          | Release PRD frontmatter validation.                                     |
-| `src/domain/epic.ts`             | Epic Design frontmatter validation.                                     |
-| `src/domain/router.ts`           | Router state value and Current state validation.                        |
-| `src/domain/config.ts`           | Config defaults and merge behavior.                                     |
-| `src/fs/markdown.ts`             | Structured YAML frontmatter parsing with path-aware boundary errors.    |
-| `src/fs/project.ts`              | `.savepoint` root discovery and scoped path construction.               |
-| `src/readers/*.ts`               | Read-only release, epic, router, config, and task-set readers.          |
-| `src/validation/dependencies.ts` | Duplicate task ID, missing dependency, and cycle detection.             |
-| `test/**/*.test.ts`              | Branch coverage for parser, reader, status, config, and graph behavior. |
-
-**Deviations from original design:**
-
-| Item                          | Deviation            | Reason / follow-up                                                                      |
-| ----------------------------- | -------------------- | --------------------------------------------------------------------------------------- |
-| `done` status transitions     | Fixed during audit   | `done -> review` is allowed so completed work can be reopened for audit-stale rechecks. |
-| Config accent validation      | Fixed during audit   | Non-string custom accent values are ignored before merging defaults.                    |
-| Audit snapshot/router flip    | Manual               | Expected until E07 implements the audit CLI pipeline.                                   |
-| `.claude/settings.local.json` | Local untracked file | Decide whether to add `.claude/` to `.gitignore` before commit.                         |
-
-**Quality gates:**
-
-| Gate                   | Result                                                                                   |
-| ---------------------- | ---------------------------------------------------------------------------------------- |
-| `npm run build`        | Passed.                                                                                  |
-| `npm run typecheck`    | Passed.                                                                                  |
-| `npm run lint`         | Passed.                                                                                  |
-| `npm run format:check` | Passed after formatting E02 task markdown.                                               |
-| `npm test`             | Passed outside sandbox: 16 test files, 176 tests. Sandbox run hit esbuild `spawn EPERM`. |
-
-## Close Criteria
-
-- All `E02-data-model` tasks are `done`.
-- `npm run build`, `npm run typecheck`, `npm run lint`, `npm run format:check`, and `npm test` pass.
-- Tests cover parser errors, valid documents, invalid statuses, allowed and disallowed status transitions, missing dependencies, duplicate IDs, and dependency cycles.
-- Audit snapshot exists at `.savepoint/audit/E02-data-model/snapshot.md`.
-- Audit proposals are accepted, rejected, or explicitly carried forward.
-- This epic `Design.md` has `status: audited`.
-- Router points to the next epic state.

package/.savepoint/releases/v1/epics/_archived/E02-data-model/tasks/T001-domain-ids-status.md

@@ -1,27 +0,0 @@
----
-id: E02-data-model/T001-domain-ids-status
-status: done
-objective: "Define pure domain primitives for release, epic, task IDs, task statuses, and allowed status transitions."
-depends_on: []
----
-
-# T001: Domain IDs and Statuses
-
-## Scope
-
-Introduce the core domain types and validation helpers that later readers and validators can share.
-
-## Acceptance Criteria
-
-- Release, epic, and task ID parsing accepts the E02 design's expected ID shapes.
-- Task status values are represented from one source of truth.
-- Status transition validation covers allowed and disallowed transitions.
-- Branching validation behavior has focused unit tests.
-
-## Implementation Plan
-
-- [x] Inspect existing package/test conventions needed to place domain modules and focused unit tests.
-- [x] Add pure ID parsing and formatting helpers for release IDs, epic IDs, task numbers, and full task IDs.
-- [x] Add task status constants/types and one transition rule table for `backlog`, `planned`, `in_progress`, `review`, and `done`.
-- [x] Add validation helpers that return typed success/failure results without filesystem access.
-- [x] Add unit tests for valid and invalid ID shapes plus allowed and disallowed status transitions.