create-quiver 0.10.0 → 0.12.1

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.

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

@@ -0,0 +1,55 @@
+# EXECUTION BRIEF - slice-07: Smoke and release readiness
+
+## Context
+
+This final slice proves the hotfix is ready for PR, merge, and later npm publication. It should not publish npm itself.
+
+## Objective
+
+Run full validation, prepare `0.12.1` package metadata, perform candidate tarball smoke, and record evidence.
+
+## Scope
+
+- Version metadata.
+- Changelog/release notes.
+- Test and smoke scripts if needed.
+- Evidence report and PR body.
+
+## Acceptance Criteria
+
+- Full test suite passes.
+- Required smokes pass.
+- Candidate tarball smoke passes from `/private/tmp`.
+- Package metadata targets `0.12.1`.
+- Evidence and PR body are updated.
+
+## Technical Plan Summary
+
+Integrate all previous slices, run package safety and clean install smoke, then update release artifacts for PR review.
+
+## Suggested Execution Steps
+
+1. Confirm all prior slices are complete.
+2. Bump package metadata to `0.12.1`.
+3. Run full test and smoke suite.
+4. Run `npm pack` and smoke the tarball from `/private/tmp`.
+5. Update `EVIDENCE_REPORT.md`, `STATUS.md`, `CHANGELOG.md`, and `pr.md`.
+6. Leave npm publication for post-merge release.
+
+## Restrictions
+
+- Do not publish npm.
+- Do not create the real demo project in `/Prueba`.
+- Do not ignore failed smoke output.
+
+## Risks
+
+- Tarball smoke may reveal packaging-only issues not covered by local tests.
+
+## Completion Checklist
+
+- [ ] Full tests passed.
+- [ ] Smokes passed.
+- [ ] Tarball smoke passed.
+- [ ] Evidence recorded.
+- [ ] Version metadata ready.

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

@@ -0,0 +1,92 @@
+{
+  "slice_id": "slice-07-smoke-release-readiness",
+  "ticket": "QUIVER-26-07",
+  "type": "release",
+  "title": "Smoke and release readiness",
+  "objective": "Validate the hotfix end to end, prepare 0.12.1 package metadata, and record evidence before PR and publication.",
+  "description": "Run the full validation suite, candidate tarball smoke, documentation sync, version bump, evidence updates, and release-readiness checks.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "smoke-release-readiness",
+    "branch_name": "feature/QUIVER-26-07-smoke-release-readiness"
+  },
+  "files": [
+    "package.json",
+    "package-lock.json",
+    "CHANGELOG.md",
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "scripts/ci/**",
+    "specs/quiver-v26-0121-smoke-hardening/**",
+    "tests/**"
+  ],
+  "expected_read_paths": [
+    "package.json",
+    "package-lock.json",
+    "CHANGELOG.md",
+    "scripts/release-quiver.sh",
+    "scripts/package-quiver.sh",
+    "scripts/ci/**",
+    "specs/quiver-v26-0121-smoke-hardening/EVIDENCE_REPORT.md"
+  ],
+  "allowed_write_paths": [
+    "package.json",
+    "package-lock.json",
+    "CHANGELOG.md",
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "scripts/ci/**",
+    "specs/quiver-v26-0121-smoke-hardening/**",
+    "tests/**"
+  ],
+  "depends_on": [
+    "slice-01-cli-help-version-contract",
+    "slice-02-init-doc-links-and-flow-guidance",
+    "slice-03-ai-approval-review-consistency",
+    "slice-04-local-validation-brief-contracts",
+    "slice-05-demo-scaffold-readiness",
+    "slice-06-plan-graph-scope-performance"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Final integration and release readiness must run after every implementation slice.",
+  "must": [
+    "Bump package metadata to 0.12.1 only after implementation slices are complete.",
+    "Run full local tests and smokes.",
+    "Run candidate tarball smoke from a clean temp directory.",
+    "Record evidence and remaining risks.",
+    "Prepare PR body and release notes without publishing npm."
+  ],
+  "not_included": [
+    "Publishing npm before PR merge.",
+    "Creating the real Quiver Spec Viewer project.",
+    "Skipping failed smoke results."
+  ],
+  "acceptance": [
+    "node --test tests/**/*.test.js passes.",
+    "npm run smoke:create-quiver passes.",
+    "npm run smoke:guided-workflow passes.",
+    "npm run smoke:doctor-fixtures passes.",
+    "git diff --check passes.",
+    "Candidate tarball smoke validates init, analyze, doctor, flow, AI dry-runs, demo, and validate.",
+    "CHANGELOG.md and evidence report document 0.12.1 readiness."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run smoke:guided-workflow",
+    "npm run smoke:doctor-fixtures",
+    "npm pack",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use /private/tmp for tarball smoke.",
+    "Do not rely on the local checkout path for candidate validation.",
+    "After merge and publish, verify npm with npm view create-quiver version."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 3,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}