savepoint 1.0.4 → 1.0.7

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

@@ -1,66 +0,0 @@
----
-id: E06-atari-noir-layout/T010-auto-refresh-watcher
-status: done
-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
-
-- [x] Add `github.com/fsnotify/fsnotify` to `go.mod`
-- [x] 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`
-- [x] Edit `internal/board/model.go`:
-  - Add `Watcher *fsnotify.Watcher` field to `Model`
-  - `Init()` — returns `watchFiles(m.Watcher)` if watcher non-nil, else nil
-- [x] Edit `internal/board/board.go`:
-  - Extract task-discovery loop from `newProjectModel` into `loadAllTasks(root string) ([]data.Task, error)`
-  - `newProjectModel` calls `loadAllTasks` + `newWatcher`, sets `model.Watcher`
-  - `loadEpicTasks` now sets `task.Path` and `task.Mtime` from stat
-- [x] 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`
-  - `space`/`backspace` now call `data.WriteTaskStatus` to persist to disk
-- [x] `internal/data/task.go`: added `Path string` and `Mtime time.Time` (yaml:"-") to Task
-- [x] 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` (created)
-- `internal/data/write.go`
-- `internal/data/task.go`
-- `internal/data/parser.go`
-- `.savepoint/AGENTS.md`
-
-Estimated input tokens: 2200
-
-Quality gates: `go build ./...` PASS, `go test ./...` PASS (board: 0.317s, data: 0.343s)
-
-Notes:
-- fsnotify v1.10.0 has no recursive AddWith option; used `filepath.WalkDir` + `w.Add` per subdir instead.
-- `data.Task` gained `Path` and `Mtime` (yaml:"-") fields populated in `loadEpicTasks`.
-- Advance/Retreat disk writes live in `update.go`, not `transitions.go` (keeps transitions pure).
-- Watcher created in `newProjectModel`; Init() subscribes if non-nil; nil watcher = test-safe.
-- Follow-up fix (2026-05-02): `newWatcher` receives `root` as the `.savepoint` directory, so it watches `root/releases` directly rather than `.savepoint/.savepoint/releases`. Watch startup errors now fail model creation instead of being silently ignored.
-- Follow-up fix (2026-05-02): file-change reloads refresh task data plus release/epic indexes, and create events add watches for newly-created directories before the debounced reload.

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.