create-quiver 0.15.2 → 0.15.3

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-02-dashboard-compact-renderer/EXECUTION_BRIEF.md

@@ -0,0 +1,48 @@
+# EXECUTION_BRIEF - slice-02 Dashboard compact renderer
+
+## Context
+
+The current dashboard human output prints every section vertically. The user explicitly reported that this makes headings disappear when there is a lot of information.
+
+## Objective
+
+Make `npx create-quiver dashboard` compact and actionable by default.
+
+## Scope
+
+- Default human renderer only
+- List truncation helpers
+- Line-budget and no-spec tests
+
+## Acceptance Criteria
+
+- Default output is summary-first.
+- Large fixture output is `<= 28` non-empty lines after ANSI stripping.
+- Next safe command is visible in compact output.
+- No-spec output avoids repeated empty sections.
+- Truncated lists show `+ N more` and an inspection command.
+- `dashboard --json` remains unchanged.
+
+## Technical Plan Summary
+
+Build the compact view from the existing dashboard report. Keep details and section rendering for the next slice.
+
+## Suggested Steps
+
+1. Add compact formatting helper.
+2. Add ANSI-stripped line-count test helper.
+3. Create a large dashboard fixture.
+4. Add truncation and horizontal shortening.
+5. Preserve JSON tests.
+
+## Restrictions
+
+- Do not introduce Ink or fullscreen TUI.
+- Do not change report collection semantics.
+- Do not implement `--details` or `--section` rendering here.
+
+## Completion Checklist
+
+- [ ] Compact renderer implemented.
+- [ ] Large fixture line budget tested.
+- [ ] JSON compatibility tested.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-02-dashboard-compact-renderer/slice.json

@@ -0,0 +1,73 @@
+{
+  "slice_id": "slice-02-dashboard-compact-renderer",
+  "ticket": "QUIVER-35-02",
+  "type": "feature",
+  "title": "Dashboard compact renderer",
+  "objective": "Make the default dashboard human output compact, summary-first, and actionable without changing the underlying JSON report.",
+  "description": "Replaces the long default human dashboard with a line-budgeted compact view that prioritizes state, blockers, warnings, next safe command, progress, and counts.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v35-dashboard-compact-renderer",
+    "branch_name": "feature/QUIVER-35-02-v35-dashboard-compact-renderer"
+  },
+  "files": [
+    "src/create-quiver/lib/dashboard.js",
+    "tests/lib/dashboard.test.js",
+    "tests/commands/dashboard.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/dashboard.js",
+    "src/create-quiver/lib/cli/theme.js",
+    "tests/lib/dashboard.test.js",
+    "tests/commands/dashboard.test.js",
+    "specs/quiver-v35-compact-dashboard-version-ux/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/lib/dashboard.js",
+    "tests/lib/dashboard.test.js",
+    "tests/commands/dashboard.test.js",
+    "specs/quiver-v35-compact-dashboard-version-ux/**"
+  ],
+  "depends_on": [
+    "slice-01-dashboard-cli-contract"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can run in parallel with the version command after the dashboard CLI contract is stable, but not with dashboard details/sections.",
+  "must": [
+    "Render the default dashboard in <= 28 non-empty lines after ANSI is stripped for a large fixture.",
+    "Prioritize state, blockers, warnings, next safe command, progress, and summary counts.",
+    "Avoid repeated empty sections in no-spec/no-slice projects.",
+    "Truncate long descriptive text with ... for horizontal readability.",
+    "Keep critical next safe command visible.",
+    "Show actionable truncation hints for hidden list items."
+  ],
+  "not_included": [
+    "Full details renderer.",
+    "Section-specific renderer.",
+    "Version command.",
+    "JSON schema changes."
+  ],
+  "acceptance": [
+    "Default dashboard output is summary-first.",
+    "Large fixture default output is <= 28 non-empty ANSI-stripped lines.",
+    "No-spec project output remains useful and actionable.",
+    "Hidden repeated items include a + N more hint and a command to inspect details.",
+    "dashboard --json remains unchanged by the compact human renderer."
+  ],
+  "tests": [
+    "node --test tests/lib/dashboard.test.js",
+    "node --test tests/commands/dashboard.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Add helper tests that strip ANSI before measuring line count.",
+    "Use fixture data with many specs, slices, warnings, agents, approvals, and runs."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "started_at": "2026-05-28T17:00:00Z",
+  "completed_at": "2026-05-28T17:36:57Z",
+  "actual_hours": 2,
+  "blocked_reason": null
+}

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-03-dashboard-details-sections/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-03 Dashboard details and sections
+
+## Summary
+
+Implemented `dashboard --details` as the full human report and `dashboard --section <name>` for overview, specs, slices, blockers, warnings, agents, approvals, runs, active-slice, and next-steps. Section and compact renderers share validation and limit handling.
+
+## Validation
+
+- [x] `node --test tests/lib/dashboard.test.js`
+- [x] `node --test tests/commands/dashboard.test.js`
+- [x] `git diff --check`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Low. Supported sections are centralized and covered by focused tests.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-03-dashboard-details-sections/EXECUTION_BRIEF.md

@@ -0,0 +1,48 @@
+# EXECUTION_BRIEF - slice-03 Dashboard details and sections
+
+## Context
+
+The compact default must not remove access to complete state. Deep inspection should be explicit and predictable.
+
+## Objective
+
+Implement `dashboard --details` and `dashboard --section <name>` human renderers.
+
+## Scope
+
+- Full details human report
+- Single-section human report
+- Shared section registry and tests
+
+## Acceptance Criteria
+
+- `dashboard --details` renders the full human report.
+- `dashboard --section slices` renders only slice information and relevant context.
+- Supported sections are `overview`, `specs`, `slices`, `blockers`, `warnings`, `agents`, `approvals`, `runs`, `active-slice`, and `next-steps`.
+- Unsupported sections list valid values.
+- `--limit` applies consistently.
+- No evidence/log content leaks.
+
+## Technical Plan Summary
+
+Use the existing dashboard report and shared formatter helpers. Do not fork state collection for sections.
+
+## Suggested Steps
+
+1. Add section registry.
+2. Implement details renderer.
+3. Implement section renderers.
+4. Add tests for each representative section and invalid sections.
+5. Verify no JSON behavior changes.
+
+## Restrictions
+
+- Do not recollect state per section.
+- Do not add interactive navigation.
+- Do not modify `dashboard --json` shape.
+
+## Completion Checklist
+
+- [ ] Details renderer implemented.
+- [ ] Section renderer implemented.
+- [ ] Section tests pass.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-03-dashboard-details-sections/slice.json

@@ -0,0 +1,72 @@
+{
+  "slice_id": "slice-03-dashboard-details-sections",
+  "ticket": "QUIVER-35-03",
+  "type": "feature",
+  "title": "Dashboard details and sections",
+  "objective": "Add explicit human inspection modes for complete dashboard details and single-section views.",
+  "description": "Implements --details and --section rendering after the compact default and CLI validation contract are stable.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v35-dashboard-details-sections",
+    "branch_name": "feature/QUIVER-35-03-v35-dashboard-details-sections"
+  },
+  "files": [
+    "src/create-quiver/lib/dashboard.js",
+    "tests/lib/dashboard.test.js",
+    "tests/commands/dashboard.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/dashboard.js",
+    "tests/lib/dashboard.test.js",
+    "tests/commands/dashboard.test.js",
+    "specs/quiver-v35-compact-dashboard-version-ux/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/lib/dashboard.js",
+    "tests/lib/dashboard.test.js",
+    "tests/commands/dashboard.test.js",
+    "specs/quiver-v35-compact-dashboard-version-ux/**"
+  ],
+  "depends_on": [
+    "slice-01-dashboard-cli-contract",
+    "slice-02-dashboard-compact-renderer"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Section output must share compact renderer primitives and the finalized dashboard flag contract.",
+  "must": [
+    "Implement dashboard --details as the full human report.",
+    "Implement dashboard --section for overview, specs, slices, blockers, warnings, agents, approvals, runs, active-slice, and next-steps.",
+    "Apply --limit to repeated lists.",
+    "Keep section output readable in TTY, no-TTY, CI, and no-color modes.",
+    "Avoid collecting dashboard state a second time for section rendering."
+  ],
+  "not_included": [
+    "Changing dashboard JSON schema.",
+    "Version command.",
+    "Docs updates beyond implementation-adjacent tests."
+  ],
+  "acceptance": [
+    "dashboard --details renders the complete human report.",
+    "dashboard --section slices renders only the slices section and its relevant context.",
+    "Every supported section has focused coverage.",
+    "Unsupported sections fail with valid values listed.",
+    "--limit applies consistently to section and compact repeated lists.",
+    "No section rendering path leaks evidence/log content."
+  ],
+  "tests": [
+    "node --test tests/lib/dashboard.test.js",
+    "node --test tests/commands/dashboard.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Keep one section registry so help, validation, and rendering cannot drift.",
+    "Test active-slice and next-steps because they are not simple list sections."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "started_at": "2026-05-28T17:00:00Z",
+  "completed_at": "2026-05-28T17:36:57Z",
+  "actual_hours": 2,
+  "blocked_reason": null
+}

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-04-version-command/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-04 Version command and banner
+
+## Summary
+
+Implemented `version` and `version --json` with schema version 1, Quiver ASCII banner, approved palette colors, no-color/CI/no-TTY behavior, runtime/package-manager/project metadata, and preserved semver-only top-level `--version` / `-V`.
+
+## Validation
+
+- [x] `node --test tests/commands/cli-contract.test.js`
+- [x] `node --test tests/lib/cli-theme.test.js tests/lib/version.test.js`
+- [x] `git diff --check`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Low. Semver-only `--version` / `-V` is covered by unit tests and installed-package smoke.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-04-version-command/EXECUTION_BRIEF.md

@@ -0,0 +1,49 @@
+# EXECUTION_BRIEF - slice-04 Version command and banner
+
+## Context
+
+The user wants an Angular CLI-like branded version display, but Quiver's existing `--version` is automation-sensitive and must remain semver-only.
+
+## Objective
+
+Add `create-quiver version` and `version --json` without breaking existing `--version` behavior.
+
+## Scope
+
+- New version command routing
+- Human banner and metadata formatter
+- JSON metadata formatter
+- Tests for color, no-color, CI/no-TTY, and semver preservation
+
+## Acceptance Criteria
+
+- `create-quiver version` renders a readable human report.
+- `version --json` emits parseable JSON with `version_schema_version: 1`.
+- `--version` and `-V` still output only semver.
+- `quiver version` works through the same binary alias.
+- No ANSI appears when color is disabled or in JSON.
+- Version metadata is best-effort and uses no external process execution.
+
+## Technical Plan Summary
+
+Add a small version metadata module that reads local package/runtime information and renders through the existing Quiver theme helpers.
+
+## Suggested Steps
+
+1. Add version metadata collection from `process`, package data, env, package.json, and lockfiles.
+2. Add human banner renderer with approved palette.
+3. Add JSON renderer.
+4. Route `version` command without touching top-level `--version`.
+5. Add tests for binary contract and theme behavior.
+
+## Restrictions
+
+- Do not execute `npm`, `git`, or provider CLIs.
+- Do not overload `--version`.
+- Do not require initialized Quiver project files.
+
+## Completion Checklist
+
+- [ ] Version command implemented.
+- [ ] JSON version output implemented.
+- [ ] Semver-only contract preserved.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-04-version-command/slice.json

@@ -0,0 +1,82 @@
+{
+  "slice_id": "slice-04-version-command",
+  "ticket": "QUIVER-35-04",
+  "type": "feature",
+  "title": "Version command and banner",
+  "objective": "Add a human-friendly Quiver version command with a branded ASCII banner and automation-safe JSON output.",
+  "description": "Introduces npx create-quiver version and version --json while preserving top-level --version and -V semver-only behavior.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v35-version-command",
+    "branch_name": "feature/QUIVER-35-04-v35-version-command"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/theme.js",
+    "src/create-quiver/lib/version.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/cli-theme.test.js",
+    "tests/lib/version.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/theme.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/cli-theme.test.js",
+    "package.json",
+    "specs/quiver-v35-compact-dashboard-version-ux/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/version.js",
+    "src/create-quiver/lib/cli/theme.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/cli-theme.test.js",
+    "tests/lib/version.test.js",
+    "specs/quiver-v35-compact-dashboard-version-ux/**"
+  ],
+  "depends_on": [
+    "slice-01-dashboard-cli-contract"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can run after slice-01 in parallel with compact dashboard work if router/help changes are coordinated.",
+  "must": [
+    "Add npx create-quiver version as a human command.",
+    "Add npx create-quiver version --json with version_schema_version 1.",
+    "Preserve npx create-quiver --version and -V as semver-only output.",
+    "Support the quiver binary alias.",
+    "Render a Quiver ASCII banner using approved palette when color is enabled.",
+    "Disable color for --no-color, NO_COLOR, FORCE_COLOR=0, CI, no-TTY, and dumb terminals.",
+    "Keep banner width <= 80 columns.",
+    "Avoid external process execution."
+  ],
+  "not_included": [
+    "Dashboard rendering changes.",
+    "Package smoke updates.",
+    "Docs beyond help text needed for command discovery."
+  ],
+  "acceptance": [
+    "create-quiver version renders a readable human report.",
+    "create-quiver version --json emits parseable JSON with version_schema_version 1.",
+    "Human version output works outside initialized Quiver projects.",
+    "No ANSI appears in --json, --no-color, CI, or no-TTY modes.",
+    "create-quiver --version and -V still output only package semver.",
+    "quiver version behaves like create-quiver version."
+  ],
+  "tests": [
+    "node --test tests/commands/cli-contract.test.js",
+    "node --test tests/lib/cli-theme.test.js tests/lib/version.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use dependency injection for env/tty where possible so tests can simulate CI and no-TTY.",
+    "Do not shell out to npm or git for metadata."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "started_at": "2026-05-28T17:00:00Z",
+  "completed_at": "2026-05-28T17:36:57Z",
+  "actual_hours": 2,
+  "blocked_reason": null
+}

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-05-docs-help-generated-guidance/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-05 Docs, help, and generated guidance
+
+## Summary
+
+Updated public help, command reference, CLI UX guidance, README_FOR_AI, generated docs guidance, and generated `quiver:version` package script. Root `docs/INDEX.md` was intentionally not added because only `docs/INDEX.md.template` exists in this repo and generated projects already receive `docs/INDEX.md`; package smoke validated contents.
+
+## Validation
+
+- [x] `node --test tests/commands/cli-contract.test.js`
+- [x] `node --test tests/lib/init-docs.test.js`
+- [x] `git diff --check`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Low. The repo root `docs/INDEX.md` debt remains documented; package contents passed package and smoke validation.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-05-docs-help-generated-guidance/EXECUTION_BRIEF.md

@@ -0,0 +1,50 @@
+# EXECUTION_BRIEF - slice-05 Docs, help, and generated guidance
+
+## Context
+
+Docs should reflect stabilized behavior, not anticipated behavior. This slice comes after dashboard and version command behavior is implemented.
+
+## Objective
+
+Update public and generated documentation for compact dashboard and version UX.
+
+## Scope
+
+- Help text and examples
+- `docs/reference/commands.md`
+- `docs/CLI_UX_GUIDE.md`
+- `README_FOR_AI.md`
+- generated docs/templates as needed
+- `docs/INDEX.md` package decision if touched
+
+## Acceptance Criteria
+
+- Help documents dashboard flags and `version`.
+- Command reference documents compact default, details, sections, limit, and version JSON.
+- CLI UX guide documents relevant color/no-color and read-only rules.
+- Generated guidance stays npx-first and automation-safe.
+- If root `docs/INDEX.md` is added, package contents are intentionally handled.
+
+## Technical Plan Summary
+
+Patch docs only after command behavior is stable. Keep docs concise and avoid duplicating long reference content in README-style files.
+
+## Suggested Steps
+
+1. Update help output.
+2. Update command reference.
+3. Update CLI UX guide if rules changed.
+4. Update README_FOR_AI.md if workflow guidance changed.
+5. Update generated docs/templates when needed.
+6. Validate package-content decision for `docs/INDEX.md`.
+
+## Restrictions
+
+- Do not change dashboard or version implementation except help strings.
+- Do not publish npm.
+
+## Completion Checklist
+
+- [ ] Help updated.
+- [ ] Docs updated.
+- [ ] Generated guidance tests pass.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-05-docs-help-generated-guidance/slice.json

@@ -0,0 +1,90 @@
+{
+  "slice_id": "slice-05-docs-help-generated-guidance",
+  "ticket": "QUIVER-35-05",
+  "type": "documentation",
+  "title": "Docs, help, and generated guidance",
+  "objective": "Document the finalized dashboard and version UX contracts across public help, references, generated guidance, and package-content decisions.",
+  "description": "Updates command docs and AI guidance only after dashboard and version behavior stabilizes.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v35-docs-help-guidance",
+    "branch_name": "feature/QUIVER-35-05-v35-docs-help-guidance"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "docs/reference/commands.md",
+    "docs/CLI_UX_GUIDE.md",
+    "README_FOR_AI.md",
+    "src/create-quiver/lib/init-docs.js",
+    "docs/INDEX.md",
+    ".npmignore",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/init-docs.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "docs/reference/commands.md",
+    "docs/CLI_UX_GUIDE.md",
+    "README_FOR_AI.md",
+    "docs/INDEX.md.template",
+    ".npmignore",
+    "scripts/package-quiver.sh",
+    "specs/quiver-v35-compact-dashboard-version-ux/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "docs/reference/commands.md",
+    "docs/CLI_UX_GUIDE.md",
+    "README_FOR_AI.md",
+    "src/create-quiver/lib/init-docs.js",
+    "docs/INDEX.md",
+    ".npmignore",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/init-docs.test.js",
+    "specs/quiver-v35-compact-dashboard-version-ux/**"
+  ],
+  "depends_on": [
+    "slice-02-dashboard-compact-renderer",
+    "slice-03-dashboard-details-sections",
+    "slice-04-version-command"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Docs must reflect stabilized behavior from dashboard and version command slices.",
+  "must": [
+    "Update top-level help and examples for dashboard flags and version command.",
+    "Update docs/reference/commands.md.",
+    "Update docs/CLI_UX_GUIDE.md if output rules or supported commands changed.",
+    "Update README_FOR_AI.md if public workflow guidance changed.",
+    "Update generated docs/templates when generated projects should mention the new behavior.",
+    "Decide whether to add root docs/INDEX.md in this repo and validate package-publication impact.",
+    "Update .npmignore or package safety expectations if adding docs/INDEX.md changes tarball contents."
+  ],
+  "not_included": [
+    "Product behavior changes beyond help text.",
+    "Focused test closeout.",
+    "Package-installed smoke execution."
+  ],
+  "acceptance": [
+    "Help output documents version and dashboard flags.",
+    "Command reference documents compact default, details, sections, limit, version, and version --json.",
+    "CLI UX guide documents color/no-color and read-only behavior where relevant.",
+    "Generated guidance remains aligned with npx-first Quiver usage.",
+    "docs/INDEX.md package decision is explicit and validated."
+  ],
+  "tests": [
+    "node --test tests/commands/cli-contract.test.js",
+    "node --test tests/lib/init-docs.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Avoid duplicating long procedural docs across README and reference docs.",
+    "If adding docs/INDEX.md, inspect npm pack contents before finalizing."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "started_at": "2026-05-28T17:00:00Z",
+  "completed_at": "2026-05-28T17:36:57Z",
+  "actual_hours": 1,
+  "blocked_reason": null
+}

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-06-tests-smokes-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,21 @@
+# CLOSURE_BRIEF - slice-06 Tests, smokes, and release readiness
+
+## Summary
+
+Added focused dashboard/version/init-docs coverage, ran the full Node test suite, diff check, strict spec validation, package build, and smoke suite. Evidence was recorded in the spec evidence report.
+
+## Validation
+
+- [x] `node --test tests/**/*.test.js`
+- [x] `git diff --check`
+- [x] `npx create-quiver spec validate specs/quiver-v35-compact-dashboard-version-ux --strict`
+- [x] `npm run package:quiver`
+- [x] `npm run smoke:create-quiver`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Low. Installed-package behavior is covered by slice-07 and smoke evidence.

package/specs/quiver-v35-compact-dashboard-version-ux/slices/slice-06-tests-smokes-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,51 @@
+# EXECUTION_BRIEF - slice-06 Tests, smokes, and release readiness
+
+## Context
+
+The feature touches public CLI contracts and automation-sensitive output, so test evidence must be broader than unit coverage.
+
+## Objective
+
+Validate integrated dashboard and version UX behavior and record release-readiness evidence.
+
+## Scope
+
+- Focused tests
+- Full `node --test`
+- diff checks
+- spec validation
+- package smoke
+- evidence updates
+
+## Acceptance Criteria
+
+- Focused dashboard and version tests pass.
+- Full `node --test` passes or blocker is documented.
+- `git diff --check` passes.
+- Spec validation passes.
+- Package smoke passes.
+- Evidence report and closure briefs are updated with real results.
+
+## Technical Plan Summary
+
+Run focused tests first, then full validation. Record exact commands and outcomes in the spec evidence artifacts.
+
+## Suggested Steps
+
+1. Run focused tests for dashboard and version.
+2. Run full `node --test`.
+3. Run `git diff --check`.
+4. Run `spec validate`.
+5. Run package smoke.
+6. Update evidence and closure briefs.
+
+## Restrictions
+
+- Do not publish npm.
+- Do not mark incomplete slices as completed.
+
+## Completion Checklist
+
+- [ ] Focused tests pass.
+- [ ] Full validation recorded.
+- [ ] Evidence updated.