create-quiver 0.12.0 → 0.13.0

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-03-ai-approval-review-consistency/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-03-ai-approval-review-consistency",
+  "ticket": "QUIVER-26-03",
+  "type": "fix",
+  "title": "AI approval and review consistency",
+  "objective": "Make review-plan, approval, and spec-create gates consistent and actionable.",
+  "description": "Align the AI lifecycle guidance so approved-but-unreviewed technical plans are clearly blocked, reviewed drafts are approvable, and suggested commands exist.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "ai-approval-review-consistency",
+    "branch_name": "feature/QUIVER-26-03-ai-approval-review-consistency"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/commands/flow.js",
+    "src/create-quiver/lib/approvals.js",
+    "src/create-quiver/lib/ai/**",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/approvals.js",
+    "src/create-quiver/lib/ai/plan-review.js",
+    "tests/commands/ai-review-plan.test.js",
+    "tests/commands/ai-plan-spec-phase.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/commands/flow.js",
+    "src/create-quiver/lib/approvals.js",
+    "src/create-quiver/lib/ai/**",
+    "tests/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-01-cli-help-version-contract"
+  ],
+  "parallel_safe": "maybe",
+  "parallel_safe_reason": "Can run beside slice-02 only if flow/help files do not overlap.",
+  "must": [
+    "Remove or avoid any suggestion to approve unsupported phase plan-review.",
+    "Make spec-create blockers explain reviewed technical-plan requirements.",
+    "Ensure flow suggests commands that exist and can be completed.",
+    "Preserve versioned approval gates."
+  ],
+  "not_included": [
+    "Changing provider invocation behavior.",
+    "Generating specs from unreviewed plans."
+  ],
+  "acceptance": [
+    "Approved-but-unreviewed technical plans are blocked with an exact next command.",
+    "Reviewed technical-plan drafts can be approved through the supported command path.",
+    "flow does not suggest unsupported phases.",
+    "Tests cover missing review, stale review, reviewed approval, and spec-create gating."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-review-plan.test.js tests/commands/ai-plan-spec-phase.test.js tests/lib/approvals.test.js tests/commands/flow.test.js",
+    "npm run smoke:guided-workflow",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Simulate approval from input and versioned approval paths if both still exist.",
+    "Verify every printed next command is accepted by the CLI."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 2,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-04-local-validation-brief-contracts/CLOSURE_BRIEF.md

@@ -0,0 +1,35 @@
+# CLOSURE BRIEF - slice-04: Local validation and brief contracts
+
+## Summary of Work
+
+- Implemented local slice readiness hardening and current brief validation support.
+- `check-slice --local` now falls back to the current directory when Git metadata is unavailable.
+- `depends_on` validation now compares normalized dependency refs, so bare same-spec dependencies resolve consistently.
+- `check-handoff` now validates legacy `HANDOFF.md` files and per-slice `EXECUTION_BRIEF.md` / `CLOSURE_BRIEF.md` files.
+
+## Validation Against Acceptance Criteria
+
+- [x] Local validation works without fatal Git assumption.
+- [x] Completed dependency resolves.
+- [x] Brief validation supported.
+- [x] Handoff compatibility preserved.
+
+## Relevant Changes
+
+- Updated `src/create-quiver/lib/readiness.js`.
+- Updated `src/create-quiver/lib/slice-graph.js`.
+- Updated `src/create-quiver/lib/handoff.js`.
+- Updated CLI help and generated command documentation.
+- Added `tests/lib/handoff.test.js` and new local validation fixtures.
+
+## Pending
+
+- No pending work for this slice.
+
+## Remaining Risks
+
+- Final release smoke still needs normal Git/base validation coverage.
+
+## Future Recommendations
+
+- Keep generated demo slices in validation fixtures to catch regressions.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-04-local-validation-brief-contracts/EXECUTION_BRIEF.md

@@ -0,0 +1,52 @@
+# EXECUTION BRIEF - slice-04: Local validation and brief contracts
+
+## Context
+
+The npm smoke test found that `check-slice --local` still failed before validation in a non-Git folder and then failed on a valid dependency from `slice-01` to a completed `slice-00-docs-foundation`. It also found that `check-handoff` only accepts the older global `HANDOFF.md` shape.
+
+## Objective
+
+Make local validation useful for new projects and align validation with current slice-local briefs.
+
+## Scope
+
+- `check-slice --local`.
+- Dependency resolution for completed slices.
+- Brief/handoff validators.
+- Fixtures and docs.
+
+## Acceptance Criteria
+
+- Local structural validation does not fatally require Git.
+- Completed documentary slices can satisfy dependencies.
+- `EXECUTION_BRIEF.md` and `CLOSURE_BRIEF.md` validation is supported.
+- Existing `HANDOFF.md` validation remains supported.
+
+## Technical Plan Summary
+
+Separate structural validation from Git/remote validation in local mode, resolve dependencies from the full slice set, and extend validation contracts for slice briefs.
+
+## Suggested Execution Steps
+
+1. Reproduce no-Git local validation failure.
+2. Reproduce completed `slice-00` dependency failure.
+3. Split local structural checks from Git checks.
+4. Add brief validators or route support.
+5. Add regression fixtures and tests.
+
+## Restrictions
+
+- Do not weaken normal PR/base validation outside `--local`.
+- Do not remove global handoff compatibility.
+
+## Risks
+
+- Dependency resolution changes can affect `plan`, `graph`, or `next`; run focused graph tests.
+
+## Completion Checklist
+
+- [ ] No-Git fixture covered.
+- [ ] Completed dependency covered.
+- [ ] Brief validation covered.
+- [ ] Handoff compatibility covered.
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-04-local-validation-brief-contracts/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-04-local-validation-brief-contracts",
+  "ticket": "QUIVER-26-04",
+  "type": "fix",
+  "title": "Local validation and brief contracts",
+  "objective": "Make local slice validation and current per-slice brief validation work in new/local projects.",
+  "description": "Harden check-slice --local without Git/remote assumptions, resolve dependencies against completed slices, and support EXECUTION_BRIEF.md and CLOSURE_BRIEF.md validation while keeping HANDOFF.md compatible.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "local-validation-brief-contracts",
+    "branch_name": "feature/QUIVER-26-04-local-validation-brief-contracts"
+  },
+  "files": [
+    "src/create-quiver/lib/slice.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "src/create-quiver/lib/handoff.js",
+    "src/create-quiver/index.js",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/slice.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "src/create-quiver/lib/handoff.js",
+    "tests/commands/check-slice*.test.js",
+    "tests/commands/check-handoff*.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/lib/slice.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "src/create-quiver/lib/handoff.js",
+    "src/create-quiver/index.js",
+    "tests/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-02-init-doc-links-and-flow-guidance",
+    "slice-03-ai-approval-review-consistency"
+  ],
+  "parallel_safe": "maybe",
+  "parallel_safe_reason": "Can run beside demo work only if shared demo validation helpers are not touched.",
+  "must": [
+    "Allow check-slice --local structural validation without fatal git rev-parse failure.",
+    "Resolve dependencies against all known slices, including completed slices.",
+    "Support validation for EXECUTION_BRIEF.md and CLOSURE_BRIEF.md.",
+    "Keep existing HANDOFF.md validation compatible.",
+    "Add fixtures for no-git local project and completed slice-00 dependency."
+  ],
+  "not_included": [
+    "Changing normal non-local remote/base validation semantics.",
+    "Removing HANDOFF.md support."
+  ],
+  "acceptance": [
+    "check-slice --local works in a folder without .git or prints only non-fatal Git warnings.",
+    "slice-01 depending on completed slice-00-docs-foundation validates locally.",
+    "EXECUTION_BRIEF.md and CLOSURE_BRIEF.md can be validated with a supported command path.",
+    "HANDOFF.md validation remains supported.",
+    "Focused fixtures cover the reported smoke failures."
+  ],
+  "tests": [
+    "node --test tests/commands/check-slice*.test.js tests/commands/check-handoff*.test.js tests/lib/slice-graph.test.js",
+    "npm run smoke:guided-workflow",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use a temp fixture without .git.",
+    "Use the generated spec-viewer demo slice dependency as a regression fixture."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 3,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-05-demo-scaffold-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,34 @@
+# CLOSURE BRIEF - slice-05: Demo scaffold readiness
+
+## Summary of Work
+
+- Made `demo create spec-viewer` generate a minimal Quiver-initialized demo scaffold with `.quiver` metadata, AGENTS, docs, scripts, specs, slices, and validation.
+- Added dependency-free server port fallback when the starting port is occupied.
+- Strengthened demo validation and tests for doctor, plan, graph, next, and brief validation.
+- Updated stale smoke expectations that still required `COMMANDS.md` links to optional `docs/examples/*` files.
+
+## Validation Against Acceptance Criteria
+
+- [x] Demo generation verified.
+- [x] Demo validation verified.
+- [x] Doctor behavior verified.
+- [x] Port behavior verified.
+
+## Relevant Changes
+
+- Updated `src/create-quiver/lib/demo.js`.
+- Updated `tests/commands/demo.test.js`.
+- Updated smoke fixtures in `scripts/ci/`.
+- Updated README and command template docs.
+
+## Pending
+
+- No pending work for this slice.
+
+## Remaining Risks
+
+- The server fallback is covered by generated contract tests instead of opening real sockets because the sandbox blocks local listening.
+
+## Future Recommendations
+
+- Use the demo as a recurring dogfooding fixture after each release.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-05-demo-scaffold-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,54 @@
+# EXECUTION BRIEF - slice-05: Demo scaffold readiness
+
+## Context
+
+The optional `spec-viewer` demo generated and validated, but `doctor` inside the demo reported that it was not initialized by Quiver. The demo server also failed with `EADDRINUSE` when port `4173` was already in use.
+
+## Objective
+
+Make the demo scaffold coherent with Quiver diagnostics and easier to run cross-platform.
+
+## Scope
+
+- `demo create spec-viewer`.
+- Demo metadata and README.
+- Demo server port behavior.
+- Doctor behavior for demo scaffold.
+- Demo tests/smoke.
+
+## Acceptance Criteria
+
+- Demo generation succeeds.
+- Demo validation succeeds.
+- Doctor inside demo is clear and not misleading.
+- Occupied port behavior is actionable or auto-recovers.
+- Generated Quiver demo scripts still work.
+
+## Technical Plan Summary
+
+Decide whether the demo should include minimal Quiver metadata or whether doctor should detect demo scaffolds explicitly. Improve server port handling and README instructions.
+
+## Suggested Execution Steps
+
+1. Generate demo in a temp folder.
+2. Run validate, doctor, plan, graph, next, and start.
+3. Fix demo metadata/doctor handling.
+4. Improve port fallback or docs.
+5. Add tests/smoke.
+
+## Restrictions
+
+- Keep demo small and dependency-light.
+- Do not add backend, auth, database, or external assets.
+
+## Risks
+
+- If demo includes `.quiver` metadata, it must not imply a full initialized project unless that is true.
+
+## Completion Checklist
+
+- [ ] Demo validates.
+- [ ] Doctor output is clear.
+- [ ] Port behavior verified.
+- [ ] Demo scripts verified.
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-05-demo-scaffold-readiness/slice.json

@@ -0,0 +1,84 @@
+{
+  "slice_id": "slice-05-demo-scaffold-readiness",
+  "ticket": "QUIVER-26-05",
+  "type": "fix",
+  "title": "Demo scaffold readiness",
+  "objective": "Make the optional spec-viewer demo scaffold diagnosable, validatable, and easy to run when the default port is occupied.",
+  "description": "Align demo scaffold metadata with doctor behavior, improve server port handling or cross-platform instructions, and add demo smoke coverage.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "demo-scaffold-readiness",
+    "branch_name": "feature/QUIVER-26-05-demo-scaffold-readiness"
+  },
+  "files": [
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/lib/demo.js",
+    "src/create-quiver/lib/doctor.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "scripts/ci/smoke-init-docs.sh",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/lib/demo.js",
+    "src/create-quiver/lib/doctor.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "scripts/ci/smoke-init-docs.sh",
+    "tests/commands/demo.test.js",
+    "README.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/lib/demo.js",
+    "src/create-quiver/lib/doctor.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "scripts/ci/smoke-init-docs.sh",
+    "tests/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-02-init-doc-links-and-flow-guidance",
+    "slice-04-local-validation-brief-contracts"
+  ],
+  "parallel_safe": "maybe",
+  "parallel_safe_reason": "Can run beside slice-04 only if doctor/validation helpers do not overlap.",
+  "must": [
+    "Generated demo must be coherent with doctor or doctor must explain demo scaffold status clearly.",
+    "Demo validate command must remain dependency-light.",
+    "Port occupied failure must be actionable or fallback automatically.",
+    "README instructions must be cross-platform if environment variables are used."
+  ],
+  "not_included": [
+    "Turning the demo into a large app.",
+    "Adding backend/auth/database.",
+    "Using external assets."
+  ],
+  "acceptance": [
+    "demo create spec-viewer generates a demo that validates.",
+    "doctor inside the demo no longer gives a misleading not-initialized error.",
+    "npm start handles occupied default port or documents a clear cross-platform recovery path.",
+    "Demo Quiver scripts still work: plan, graph, next, evidence.",
+    "Tests or smoke cover demo generation and validation."
+  ],
+  "tests": [
+    "node --test tests/commands/demo.test.js tests/commands/doctor.test.js",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Generate the demo into a temp folder.",
+    "Run validate, quiver plan/graph/next, doctor, and start with an occupied default port when practical."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 4,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-06-plan-graph-scope-performance/CLOSURE_BRIEF.md

@@ -0,0 +1,35 @@
+# CLOSURE BRIEF - slice-06: Plan and graph scope performance
+
+## Summary of Work
+
+- Added scoped slice loading for `plan` and `graph` when `--spec <slug>` is provided.
+- Scoped loading reads the target spec and explicit dependency refs without parsing unrelated historical specs.
+- Kept unscoped `plan` and `graph` behavior compatible.
+- Updated root `quiver:plan` and `quiver:graph` scripts to use the local CLI entrypoint so local validation tests the branch code instead of the published npm version.
+
+## Validation Against Acceptance Criteria
+
+- [x] Scoped plan passes without OOM.
+- [x] Scoped graph passes without OOM.
+- [x] Regression test added.
+- [x] Unscoped behavior verified.
+
+## Relevant Changes
+
+- Updated `src/create-quiver/lib/slice-graph.js`.
+- Updated `src/create-quiver/commands/plan.js`.
+- Updated `src/create-quiver/commands/graph.js`.
+- Updated `tests/commands/plan.test.js` and `tests/commands/graph.test.js`.
+- Updated root `package.json` scripts for local `quiver:plan` and `quiver:graph`.
+
+## Pending
+
+- No pending work for this slice.
+
+## Remaining Risks
+
+- Scoped output intentionally keeps external dependency refs for readiness but still displays only the requested spec, matching prior filtered output.
+
+## Future Recommendations
+
+- Keep large-repo fixtures around scoped graph commands.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-06-plan-graph-scope-performance/EXECUTION_BRIEF.md

@@ -0,0 +1,53 @@
+# EXECUTION BRIEF - slice-06: Plan and graph scope performance
+
+## Context
+
+During v25 and v26 documentation validation, scoped `plan` and `graph` commands failed with Node out-of-memory even for a small target spec. This means the commands likely load or retain too much unrelated historical data before applying `--spec`.
+
+## Objective
+
+Make scoped `plan` and `graph` safe to run in this repo without increasing Node heap size.
+
+## Scope
+
+- `plan` command.
+- `graph` command.
+- Slice graph loading/filtering helpers.
+- Regression tests and evidence.
+
+## Acceptance Criteria
+
+- Scoped plan for v26 completes without OOM.
+- Scoped graph for v26 completes without OOM.
+- Tests prove scoped loading avoids unrelated heavy artifacts.
+- Unscoped behavior remains compatible.
+
+## Technical Plan Summary
+
+Audit the graph-loading path, move spec filtering earlier, avoid retaining unnecessary file contents or historical artifacts, and add focused tests.
+
+## Suggested Execution Steps
+
+1. Reproduce the OOM with v26 scoped plan/graph.
+2. Inspect `plan`, `graph`, and slice graph loading.
+3. Move filtering earlier or reduce retained data.
+4. Add regression tests.
+5. Re-run scoped plan/graph and record evidence.
+
+## Restrictions
+
+- Do not solve this by raising heap size.
+- Do not remove support for historical specs.
+- Do not change dependency semantics without explicit evidence.
+
+## Risks
+
+- Over-filtering could hide cross-spec dependencies if those are valid in existing specs.
+
+## Completion Checklist
+
+- [ ] Scoped plan passes.
+- [ ] Scoped graph passes.
+- [ ] Regression test added.
+- [ ] Evidence updated.
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-06-plan-graph-scope-performance/slice.json

@@ -0,0 +1,82 @@
+{
+  "slice_id": "slice-06-plan-graph-scope-performance",
+  "ticket": "QUIVER-26-06",
+  "type": "fix",
+  "title": "Plan and graph scope performance",
+  "objective": "Prevent scoped plan and graph commands from running out of memory in repos with many historical specs.",
+  "description": "Harden plan/graph data loading so --spec <slug> only reads and retains the needed spec/slice graph, and add regression coverage for the OOM observed in v25 and v26 validation.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "plan-graph-scope-performance",
+    "branch_name": "feature/QUIVER-26-06-plan-graph-scope-performance"
+  },
+  "files": [
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/commands/graph.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "package.json",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/commands/graph.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "package.json",
+    "tests/commands/plan.test.js",
+    "tests/commands/graph.test.js",
+    "specs/quiver-v25-ai-first-lifecycle-orchestrator/EVIDENCE_REPORT.md",
+    "specs/quiver-v26-0121-smoke-hardening/EVIDENCE_REPORT.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/commands/graph.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "package.json",
+    "tests/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-04-local-validation-brief-contracts"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This slice modifies shared graph/planning utilities used by multiple commands.",
+  "must": [
+    "Reproduce or cover the scoped plan/graph OOM with a regression fixture or command-level test.",
+    "Ensure --spec <slug> limits read/retained data to the target spec and necessary dependency references.",
+    "Keep unscoped plan/graph behavior compatible.",
+    "Ensure plan and graph still support --include-completed.",
+    "Record evidence for v26 scoped plan and graph commands."
+  ],
+  "not_included": [
+    "Changing slice dependency semantics beyond necessary scoped loading.",
+    "Removing historical spec support.",
+    "Adding a database or cache service."
+  ],
+  "acceptance": [
+    "npm run quiver:plan -- --spec quiver-v26-0121-smoke-hardening --include-completed completes without OOM.",
+    "npm run quiver:graph -- --spec quiver-v26-0121-smoke-hardening --include-completed completes without OOM.",
+    "A test or fixture proves scoped plan/graph do not load unrelated heavy spec artifacts unnecessarily.",
+    "Unscoped plan/graph tests continue to pass.",
+    "Dependency output remains correct for v26."
+  ],
+  "tests": [
+    "node --test tests/commands/plan.test.js tests/commands/graph.test.js tests/lib/slice-graph.test.js",
+    "npm run quiver:plan -- --spec quiver-v26-0121-smoke-hardening --include-completed",
+    "npm run quiver:graph -- --spec quiver-v26-0121-smoke-hardening --include-completed",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Do not mask the issue by increasing Node heap size.",
+    "Prefer lazy/scoped discovery over post-filtering a full historical graph.",
+    "Use the current repo as a real regression case."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 4,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-07-smoke-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,35 @@
+# CLOSURE BRIEF - slice-07: Smoke and release readiness
+
+## Summary of Work
+
+- Prepared `0.12.1` package metadata.
+- Updated changelog, source-of-truth docs, PR body, spec status, and evidence.
+- Ran full local validation, required smokes, extra CI smokes, and candidate tarball smoke from `/private/tmp`.
+
+## Validation Against Acceptance Criteria
+
+- [x] Full tests passed.
+- [x] Required smokes passed.
+- [x] Candidate tarball smoke passed.
+- [x] Evidence updated.
+- [x] Release metadata prepared.
+
+## Relevant Changes
+
+- `package.json` and `package-lock.json` now target `0.12.1`.
+- `CHANGELOG.md` documents the `0.12.1` release candidate.
+- `README_FOR_AI.md` and `ROADMAP.md` mark v26 as implemented/release-ready while keeping npm publication pending.
+- `EVIDENCE_REPORT.md`, `STATUS.md`, and `pr.md` include final release-readiness evidence.
+
+## Pending
+
+- Open PR, merge after review, publish `create-quiver@0.12.1`, then run published-package smoke.
+
+## Remaining Risks
+
+- npm publication and post-publish smoke happen after PR merge.
+- This workstation's default npm cache has ownership issues; packaging passed with an isolated temp cache.
+
+## Future Recommendations
+
+- Automate published-package smoke as a reusable release command.