savepoint 1.0.3 → 1.0.6

package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T010-audit-file-migration.md

@@ -1,45 +0,0 @@
----
-id: E06-audit-command/T010-audit-file-migration
-status: done
-objective: Move existing audit files from .savepoint/audit/v1.1/ to epic folders as E##-Audit.md
-depends_on: []
----
-
-# T010: Audit File Migration
-## Migration of existing audit files from .savepoint/audit/ to epic folder
-
-## Acceptance Criteria
-
-- [x] Script reads all `.savepoint/audit/v1.1/{E##}/proposals.md` and `snapshot.md` files
-- [x] For each epic, concatenates content into single E##-Audit.md file
-- [x] Writes to `.savepoint/releases/v1.1/epics/{E##}/E##-Audit.md`
-- [x] Deletes old audit folders after migration
-
-## Implementation Plan
-
-- [x] Created migration:
-  - Read proposals.md from each epic (if exists)
-  - Read snapshot.md from each epic (if exists)
-  - Wrote E##-Audit.md format with frontmatter + Main Findings + Quality Review + Code Style Review
-  - Wrote to corresponding epic folder
-  - Deleted `.savepoint/audit/` folder
-- [x] 4 audit files created:
-  - E02-Audit.md (Cross-Platform Compatibility)
-  - E03-Audit.md (UI Visual Refinement)
-  - E04-Audit.md (Epic Navigation)
-  - E05-Audit.md (Tasking Permissions)
-- [x] Quality gates: `go build` passed
-
-## Context Log
-
-Files created:
-- `.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/E02-Audit.md`
-- `.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/E03-Audit.md`
-- `.savepoint/releases/v1.1/epics/E04-epic-navigation/E04-Audit.md`
-- `.savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Audit.md`
-
-Notes:
-- E01 not migrated - no audit files existed
-- E06+ not migrated - no audit files existed yet
-- Old `.savepoint/audit/` folder deleted after migration
-- Next task: T011 (Model Tab State)

package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T011-model-tab-state.md

@@ -1,26 +0,0 @@
----
-id: E06-audit-command/T011-model-tab-state
-status: done
-objective: Add tab state to board Model for Detail/Audit switching
-depends_on: []
----
-
-# T011: Model Tab State
-
-## Acceptance Criteria
-
-- [x] `EpicDetailTab int` added to Model (0=Detail, 1=Audit)
-- [x] `EpicAuditContent string` added to Model (cached audit file content)
-- [x] Defaults to 0 (Detail tab)
-- [x] `make build` passes
-- [x] `make test` passes
-
-## Implementation Plan
-
-- [ ] Add to `Model` struct in `internal/board/model.go`:
-  ```go
-  EpicDetailTab    int    // 0=Detail, 1=Audit
-  EpicAuditContent string // cached E##-Audit.md content
-  ```
-- [ ] Run `make build`
-- [ ] Run `make test`

package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T012-epic-audit-render.md

@@ -1,33 +0,0 @@
----
-id: E06-audit-command/T012-epic-audit-render
-status: done
-objective: Add RenderEpicAuditTab function to render audit findings + code style checklist
-depends_on:
-    - E06-audit-command/T011-model-tab-state
----
-
-# T012: Render Epic Audit Tab
-
-## Acceptance Criteria
-
-- [ ] `RenderEpicAuditTab(epicSlug, content string, overlayW, maxHeight, offset int) string` function created
-- [ ] Renders "EPIC AUDIT" header
-- [ ] Parses E##-Audit.md Markdown content (Main Findings + Code Style Review sections)
-- [ ] Renders code style checkboxes with appropriate styling
-- [ ] Uses existing scroll helpers (visibleDetailLines)
-- [ ] Tests pass
-
-## Implementation Plan
-
-- [x] Add `RenderEpicAuditTab()` function to `internal/board/epic_panel.go`:
-  - Similar structure to `RenderEpicDetail()`
-  - Parse markdown content: strip frontmatter, extract sections
-  - Render header with audit title style
-  - Render body: findings content + checklist
-  - Reuse `visibleDetailLines`, `WrapText` from detail.go
-- [x] Add unit tests for parsing and rendering
-- [x] Ensure scroll behavior matches detail overlay
-
-## Fixed
-
-- Section filtering: `epicAuditBody` now only renders "Quality Review" and "Code Style Review" sections, excluding all other sections per acceptance criteria

package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T013-handle-tab-keys.md

@@ -1,34 +0,0 @@
----
-id: E06-audit-command/T013-handle-tab-keys
-status: done
-objective: Handle 1/2 keys to switch tabs in Epic Detail overlay
-depends_on:
-    - E06-audit-command/T011-model-tab-state
-    - E06-audit-command/T012-epic-audit-render
----
-
-# T013: Handle Tab Keys
-
-## Acceptance Criteria
-
-- [x] Pressing `1` switches to Detail tab (EpicDetailTab = 0)
-- [x] Pressing `2` switches to Audit tab (EpicDetailTab = 1)
-- [x] When switching to Audit tab, loads E##-Audit.md content
-- [x] Audit content cached in EpicAuditContent
-- [x] Scrolling works on both tabs
-- [x] Tests pass
-
-## Implementation Plan
-
-- [ ] In `internal/board/update.go`:
-  - When `m.Overlay == OverlayEpicDetail`:
-    - If key is `1` → set `m.EpicDetailTab = 0`
-    - If key is `2` →:
-      - set `m.EpicDetailTab = 1`
-      - if `m.EpicAuditContent == ""`:
-        - derive audit file path
-        - read file with `os.ReadFile`
-        - if error → set `m.EpicAuditContent = "(no audit available)"`
-        - else → cache content
-- [ ] Add test for tab switching
-- [ ] Add test for audit file loading on first access

package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T014-tab-indicator.md

@@ -1,33 +0,0 @@
----
-id: E06-audit-command/T014-tab-indicator
-status: done
-objective: Update Epic Detail overlay header to show tab indicator and switch between tabs in view.go
-depends_on:
-    - E06-audit-command/T011-model-tab-state
-    - E06-audit-command/T012-epic-audit-render
-    - E06-audit-command/T013-handle-tab-keys
----
-
-# T014: Tab Indicator
-
-## Acceptance Criteria
-
-- [ ] Tab indicator shown in overlay header: "EPIC DETAIL [1] │ AUDIT [2]"
-- [ ] Active tab highlighted/bold
-- [ ] Switches between RenderEpicDetail and RenderEpicAuditTab based on EpicDetailTab state
-- [ ] Tests pass and verify indicator rendering
-
-## Implementation Plan
-
-- [ ] In `internal/board/view.go`:
-  - When `m.Overlay == OverlayEpicDetail`:
-    - Check `m.EpicDetailTab` state
-    - If 0 → call existing `RenderEpicDetail()`
-    - If 1 → call `RenderEpicAuditTab()`
-  - Pass `EpicDetailTab` to renderer for header rendering
-- [ ] Update `RenderEpicDetail()` in `epic_panel.go`:
-  - Accept `tab int` parameter
-  - Render tab indicator line before content
-  - Highlight active tab number (bold or different color)
-- [ ] Update `RenderEpicAuditTab()` similarly
-- [ ] Add test for tab indicator rendering with both tab states

package/.savepoint/releases/v1.1/epics/E07-init-command/E07-Audit.md

@@ -1,336 +0,0 @@
----
-type: audit-findings
-audited: 2026-05-03
----
-
-# Audit Findings: E07 Init Command
-
-## Main Findings
-
-E07 is implemented and the Go baseline passes: `go test ./internal/init ./cmd`, `go build ./...`, and `go test ./...` all succeeded. The command parser, target validation, scaffold copy, prompt rendering, clipboard best-effort path, and integration coverage are present.
-
-Audit apply resolved the generated-template drift. New Savepoint projects now receive `stage` task-status instructions, `make build && make test` quality-gate guidance, and the current epic-local `E##-Audit.md` audit workflow instead of the archived `.savepoint/audit/.../proposals.md` pipeline.
-
-Audit apply also tightened scaffold safety. Init validation now treats an existing root `agent-skills/` directory as a conflict unless `--force` is set, and `AtomicWrite` uses a portable replace helper that falls back to backup/restore when a platform cannot rename over an existing target.
-
-The clipboard task record was reconciled: `T006-clipboard.md` now reflects the implemented `ClipboardResult` API, best-effort status handling, current-platform tests, and completed Go quality gates.
-
-## Code Style Review
-
-- [x] One job per file
-- [x] One-sentence functions
-- [x] Test branches
-- [x] Types are documentation
-- [x] Build, don't speculate
-- [x] Errors at boundaries
-- [x] One source of truth
-- [x] Comments explain WHY
-- [x] Content in data files
-- [x] Small diffs
-
-The audit-close patch brought generated workflow content back in line with the live root instructions, added tests that guard template freshness, and kept the scaffold conflict/overwrite fixes scoped to `internal/init`.
-
-## Proposed Changes
-
-### Target File
-templates/project/AGENTS.md
-
-### Replace
-```
-- `phase` (build/test/audit): only when `status: in_progress`
-```
-
-### With
-```
-- `stage` (build/test/audit): **required** when `status: in_progress` — omitting it is a parse error
-```
-
-### Target File
-templates/project/AGENTS.md
-
-### Replace
-```
-2. When starting implementation, set task frontmatter to `status: in_progress`
-```
-
-### With
-```
-2. When starting implementation, set task frontmatter to `status: in_progress` + `stage: build` (both required together)
-```
-
-### Target File
-templates/project/AGENTS.md
-
-### Replace
-```
-npm run build && npm run test
-```
-
-### With
-```
-make build && make test
-```
-
-### Target File
-templates/project/.savepoint/router.md
-
-### Replace
-```
-## Manual audit override
-
-If the user explicitly asks you to audit an epic, perform the audit for that epic even if the router has not reached `state: audit-pending` yet.
-
-Persist the audit artifacts before replying:
-
-- Ensure `.savepoint/audit/{E##-epic}/snapshot.md` exists. Create a manual snapshot once if needed.
-- Write the proposal bundle to `.savepoint/audit/{release}/{E##-epic}/proposals.md`.
-- Do not stop at chat-only findings. The filesystem artifact is part of the task output.
-```
-
-### With
-```
-## Manual audit override
-
-If the user explicitly asks you to audit an epic, perform the audit for that epic even if the router has not reached `state: audit-pending` yet.
-
-Persist the audit artifact before replying:
-
-- Write exactly one `.savepoint/releases/{release}/epics/{E##-epic}/E##-Audit.md`.
-- Include `## Main Findings`, `## Code Style Review`, and `## Proposed Changes`.
-- Keep file-specific `### Target File` / `### Replace` / `### With` blocks under `## Proposed Changes`.
-- Do not apply proposals or mark the epic audited until the user says `apply audit`.
-```
-
-### Target File
-templates/project/.savepoint/router.md
-
-### Replace
-```
-**Next action (fresh session only):** Confirm `.savepoint/audit/{E##-epic}/snapshot.md` exists. If it is missing while the audit CLI is still unavailable, create one manual snapshot from the known epic scope once; do not search broadly for replacement inputs. Then read the snapshot, read the epic's `Design.md`, and read only the files listed as changed. Write one patch-shaped proposal bundle to `.savepoint/audit/{E##-epic}/proposals.md`:
-```
-
-### With
-```
-**Next action (fresh session only):** Read the epic's `E##-Detail.md`, task files, drift notes, `.savepoint/Design.md`, `AGENTS.md`, and scoped changed files. Write one epic-local audit file to `.savepoint/releases/{release}/epics/{E##-epic}/E##-Audit.md`:
-```
-
-### Target File
-templates/project/.savepoint/router.md
-
-### Replace
-```
-- `Design.md` section — merge only the epic delta into project architecture.
-- `AGENTS.md` section — refresh Codebase Map entries from changed-module metadata; preserve existing rows.
-- `epic-Design.md` section — add "Implemented as:" notes and deltas from the original plan.
-- `Quality Review` section — semantic-review findings against the 10 Code Style rules.
-```
-
-### With
-```
-- `## Main Findings` — user-facing AC verification, important drift, and notable risks.
-- `## Code Style Review` — checklist against the 10 AGENTS.md code style rules.
-- `## Proposed Changes` — admin/apply metadata using `### Target File`, `### Replace`, and `### With`.
-```
-
-### Target File
-templates/project/.savepoint/router.md
-
-### Replace
-```
-After proposals are approved, apply approved proposals to live files, mark the epic `Design.md` as `status: audited`, update project `Design.md` `last_audited`, refresh `AGENTS.md` Codebase Map, and advance this router to the next epic state.
-```
-
-### With
-```
-After proposals are approved, apply approved proposals to live files, mark the epic `E##-Detail.md` as `status: audited`, update project `Design.md` `last_audited`, refresh `AGENTS.md` Codebase Map if needed, and advance this router to the next epic state.
-```
-
-### Target File
-internal/init/validate.go
-
-### Replace
-```
-var conflictingFiles = []string{
-	"AGENTS.md",
-}
-```
-
-### With
-```
-var conflictingFiles = []string{
-	"AGENTS.md",
-	"agent-skills",
-}
-```
-
-### Target File
-internal/init/scaffold_test.go
-
-### Replace
-```
-func TestScaffold_preservesExistingWithoutForce(t *testing.T) {
-```
-
-### With
-```
-func TestScaffold_overwritesExistingAfterValidation(t *testing.T) {
-```
-
-### Target File
-internal/init/validate_test.go
-
-### Replace
-```
-func TestValidateTarget_conflictingFileWithForce(t *testing.T) {
-	dir := t.TempDir()
-	if err := os.WriteFile(filepath.Join(dir, "AGENTS.md"), []byte("existing"), 0644); err != nil {
-		t.Fatal(err)
-	}
-
-	err := ValidateTarget(dir, true)
-	if err != nil {
-		t.Fatalf("ValidateTarget() with --force error = %v, want nil", err)
-	}
-}
-```
-
-### With
-```
-func TestValidateTarget_conflictingFileWithForce(t *testing.T) {
-	dir := t.TempDir()
-	if err := os.WriteFile(filepath.Join(dir, "AGENTS.md"), []byte("existing"), 0644); err != nil {
-		t.Fatal(err)
-	}
-
-	err := ValidateTarget(dir, true)
-	if err != nil {
-		t.Fatalf("ValidateTarget() with --force error = %v, want nil", err)
-	}
-}
-
-func TestValidateTarget_conflictingAgentSkillsDirectory(t *testing.T) {
-	dir := t.TempDir()
-	if err := os.Mkdir(filepath.Join(dir, "agent-skills"), 0755); err != nil {
-		t.Fatal(err)
-	}
-
-	err := ValidateTarget(dir, false)
-	if err == nil {
-		t.Fatal("ValidateTarget() expected error for conflicting agent-skills directory")
-	}
-	if !errors.Is(err, ErrConflict) {
-		t.Fatalf("ValidateTarget() error type = %v, want ErrConflict", err)
-	}
-}
-```
-
-### Target File
-internal/init/write.go
-
-### Replace
-```
-	if err := os.Rename(tmpName, target); err != nil {
-		return fmt.Errorf("rename temp to target: %w", err)
-	}
-```
-
-### With
-```
-	if err := replaceFile(tmpName, target); err != nil {
-		return fmt.Errorf("replace target with temp file: %w", err)
-	}
-```
-
-### Target File
-internal/init/write.go
-
-### Replace
-```
-	return nil
-}
-```
-
-### With
-```
-	return nil
-}
-
-func replaceFile(tmpName, target string) error {
-	if err := os.Rename(tmpName, target); err == nil {
-		return nil
-	}
-
-	if _, statErr := os.Stat(target); statErr != nil {
-		return os.Rename(tmpName, target)
-	}
-
-	backup := target + ".savepoint-bak"
-	_ = os.Remove(backup)
-	if err := os.Rename(target, backup); err != nil {
-		return err
-	}
-	if err := os.Rename(tmpName, target); err != nil {
-		_ = os.Rename(backup, target)
-		return err
-	}
-	return os.Remove(backup)
-}
-```
-
-### Target File
-.savepoint/Design.md
-
-### Replace
-```
-- **Init command** (`savepoint init`) validates, scaffolds, prints prompt, clipboard, optional install (epic E05).
-```
-
-### With
-```
-- **Init command** (`savepoint init`) validates target directories, scaffolds rendered copies of `templates/project/`, prints the rendered magic prompt, attempts best-effort clipboard copy, and optionally runs `npm install` after scaffolding (v1.1 E07).
-```
-
-### Target File
-.savepoint/releases/v1.1/epics/E07-init-command/E07-Detail.md
-
-### Replace
-```
-## Boundaries
-```
-
-### With
-```
-## Implemented As
-
-- `cmd/init.go` owns init argument parsing and delegates execution through `InitRunner`.
-- `main.go` embeds `templates/project/` and `templates/prompts/`, then wires validation, scaffold, prompt rendering, clipboard copy, and optional install in sequence.
-- `internal/init/` owns validation, scaffold interpolation, atomic writes, prompt rendering, clipboard copy, dependency install, and integration tests.
-- Audit found that generated workflow templates need reconciliation with the current epic-local audit workflow before closing.
-
-## Boundaries
-```
-
-### Target File
-.savepoint/releases/v1.1/epics/E07-init-command/tasks/T006-clipboard.md
-
-### Replace
-```
-- [ ] Add `internal/init/clipboard.go`
-- [ ] Implement `CopyToClipboard(text) error`
-- [ ] Detect platform: Windows (clip.exe), macOS (pbcopy), Linux (xclip/xsel)
-- [ ] Fall back gracefully if clipboard tools unavailable
-- [ ] Log skip or failure without failing init
-- [ ] Test clipboard on each platform
-- [ ] Run `make build && make test`
-```
-
-### With
-```
-- [x] Add `internal/init/clipboard.go`
-- [x] Implement `CopyToClipboard(text) ClipboardResult`
-- [x] Detect platform: Windows (clip.exe), macOS (pbcopy), Linux (xclip/xsel)
-- [x] Fall back gracefully if clipboard tools unavailable
-- [x] Log skip or failure without failing init
-- [x] Test clipboard status handling on the current platform
-- [x] Run quality gates (`go test ./internal/init ./cmd`, `go build ./...`, `go test ./...`)
-```

package/.savepoint/releases/v1.1/epics/E07-init-command/E07-Detail.md

@@ -1,61 +0,0 @@
----
-type: epic-design
-status: audited
----
-
-# E07: Init Command
-
-## Purpose
-
-Implement `savepoint init`, the first-run command that creates a Savepoint workflow in an empty or compatible project directory and prints the magic prompt the user gives to an AI agent.
-
-## Interface
-
-```bash
-savepoint init [dir]           # scaffold .savepoint/ in target directory
-savepoint init [dir] --force   # overwrite existing
-savepoint init [dir] --install  # run npm install after scaffold
-```
-
-## What this epic adds
-
-- Target directory validation (missing, empty, compatible, already-initialized, conflicting, boundary-error)
-- Scaffold writing from `templates/project/`
-- Project name interpolation
-- Safe handling (refuse conflicts by default, temp-file-plus-rename)
-- Magic prompt output to stdout (from `templates/prompts/magic-prompt.prompt.md`)
-- Best-effort clipboard copy (doesn't fail if unavailable)
-- Optional `--install` flag for dev dependencies
-- Integration tests using temporary directories
-
-## Components
-
-| Module | Purpose |
-|--------|---------|
-| `cmd/init.go` | CLI registration, arg parsing |
-| `internal/init/validate.go` | Target directory checks |
-| `internal/init/scaffold.go` | Template copy, project name interpolation |
-| `internal/init/write.go` | Atomic writes with temp-file-plus-rename |
-| `internal/init/prompt.go` | Magic prompt rendering from template |
-| `internal/init/clipboard.go` | Platform clipboard detection and copy |
-
-## Implemented As
-
-- `cmd/init.go` owns init argument parsing and delegates execution through `InitRunner`.
-- `main.go` embeds `templates/project/` and `templates/prompts/`, then wires validation, scaffold, prompt rendering, clipboard copy, and optional install in sequence.
-- `internal/init/` owns validation, scaffold interpolation, atomic writes, prompt rendering, clipboard copy, dependency install, and integration tests.
-- Audit reconciled generated workflow templates with the current epic-local audit workflow before closing.
-
-## Boundaries
-
-**In scope:**
-- Create `.savepoint/` and root `AGENTS.md`
-- Print the initial agent prompt
-- Avoid overwriting user files unless explicitly allowed by flags
-- Support Windows, macOS, and Linux filesystem behavior
-
-**Out of scope:**
-- Creating epics/tasks interactively
-- Running the board after init
-- Implementing audit or doctor
-- Managing package installation beyond the optional one-shot path

package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T001-cli-entrypoint.md

@@ -1,37 +0,0 @@
----
-id: E07-init-command/T001-cli-entrypoint
-status: done
-objective: "Create CLI entrypoint for savepoint init command"
-depends_on: []
----
-
-# T001: CLI Entrypoint
-
-## Acceptance Criteria
-
-- `savepoint init --help` shows usage: `init [dir] [--force] [--install]`
-- `savepoint init` uses current directory
-- `savepoint init <dir>` uses specified directory
-- `--force` flag allows overwriting existing .savepoint
-- `--install` flag triggers dev dependency install after scaffold
-- Unknown flags show error and exit non-zero
-
-## Implementation Plan
-
-- [x] Add `cmd/init.go` with CLI arg parsing
-- [x] Wire init command into main.go dispatch
-- [x] Implement arg validation (dir, --force, --install)
-- [x] Default to current directory if no dir specified
-- [x] Test `savepoint init --help` output
-- [x] Run quality gates (`make` unavailable; used direct Go build/test)
-
-## Context Log
-
-- Files read: `.savepoint/router.md`, `E07-Detail.md`, this task file, E07 task files T002-T007, `main.go`, `go.mod`, `Makefile`, `internal/board/board.go`, archived E05 init task.
-- Files edited: `cmd/init.go`, `cmd/init_test.go`, `main.go`, this task file, `.savepoint/router.md`.
-- Estimated input tokens: ~18k.
-- Quality gates: `go test ./cmd` passed; `make build` could not run because `make` is not installed; `go build ./...` passed with a Go module cache warning; `go test ./...` passed; `go run . init --help` printed `Usage: init [dir] [--force] [--install]`; `go run . init --bogus` exited non-zero with an unknown flag error.
-
-## Drift Notes
-
-- Added new `cmd/` package for CLI command parsing and dispatch. This module is listed in the E07 epic design but is not yet listed in the AGENTS.md Codebase Map.

package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T002-target-validation.md

@@ -1,28 +0,0 @@
----
-id: E07-init-command/T002-target-validation
-status: done
-objective: "Implement target directory validation"
-depends_on: ["E07-init-command/T001-cli-entrypoint"]
----
-
-# T002: Target Validation
-
-## Acceptance Criteria
-
-- Target missing → error with helpful message
-- Target empty → proceed with init
-- Target has compatible files (package.json, .git, etc.) → proceed
-- Target already has .savepoint → error unless --force
-- Target has conflicting files → error unless --force
-- Boundary errors (permission denied) → clear error message
-
-## Implementation Plan
-
-- [x] Add `internal/init/validate.go`
-- [x] Implement `ValidateTarget(path, force) error`
-- [x] Check directory exists, is writable
-- [x] Check for existing .savepoint (conflict)
-- [x] Check for compatible project files
-- [x] Handle permission errors with clear messages
-- [x] Test all validation scenarios
-- [x] Run `make build && make test`

package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T003-scaffold-writer.md

@@ -1,46 +0,0 @@
----
-id: E07-init-command/T003-scaffold-writer
-status: done
-objective: "Implement scaffold writing from templates"
-depends_on: ["E07-init-command/T002-target-validation"]
----
-
-# T003: Scaffold Writer
-
-## Acceptance Criteria
-
-- Reads templates from `templates/project/` directory
-- Interpolates project name into template files (AGENTS.md, config.yml)
-- Creates parent directories as needed
-- Excludes conflicting files unless --force
-- Copies all .savepoint/ contents
-- Creates root AGENTS.md from template
-
-## Implementation Plan
-
-- [x] Add `internal/init/scaffold.go`
-- [x] Implement `Scaffold(targetDir, projectName, force) error`
-- [x] Load templates from embedded or filesystem path
-- [x] Implement template variable interpolation (project name)
-- [x] Create .savepoint/ directory structure
-- [x] Copy all template files to target
-- [x] Create root AGENTS.md from template
-- [x] Test scaffold output in temp directory
-- [x] Run `make build && make test`
-
-## Context Log
-
-- Files read: router.md, E07-Detail.md, T002-target-validation.md, T001-cli-entrypoint.md, cmd/init.go, cmd/init_test.go, main.go, internal/init/validate.go, internal/init/validate_test.go, Makefile, templates/project/**/*
-- Files created: internal/init/scaffold.go, internal/init/scaffold_test.go
-- Files modified: main.go, T003-scaffold-writer.md
-- Estimated input tokens: ~14k
-- Key decisions:
-  - Used Go `embed.FS` with `fs.Sub` to embed `templates/project/` recursively.
-  - Explicit `//go:embed templates/project/.savepoint` needed because Go's embed excludes dotfile-prefixed directories from recursive directory embedding.
-  - Scaffold accepts `fs.FS` for testability; tested with `testing/fstest.MapFS`.
-  - Init runner in `main.go` validates first (reuses T002), then scaffolds.
-  - Template variables: `{{PROJECT_NAME}}` and `{{RELEASE_NUMBER}}` replaced via `strings.ReplaceAll`.
-
-## Drift Notes
-
-- `cmd/` and `internal/init/` modules were not in AGENTS.md Codebase Map. Updated AGENTS.md to include both.