create-quiver 0.9.1 → 0.12.0

package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-09-spec-viewer-demo-scaffolding/slice.json

@@ -0,0 +1,59 @@
+{
+  "slice_id": "slice-09-spec-viewer-demo-scaffolding",
+  "ticket": "QUIVER-24-09",
+  "type": "feature",
+  "title": "Spec Viewer demo scaffolding",
+  "objective": "Provide an optional first-party demo that lets users test Quiver end-to-end without inventing an app.",
+  "description": "Add `demo create spec-viewer` with dry-run support to create a lightweight Quiver Spec Viewer demo, spec, slices, validation scripts, and docs.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "spec-viewer-demo-scaffolding",
+    "branch_name": "feature/QUIVER-24-09-spec-viewer-demo-scaffolding"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/lib/demo.js",
+    "docs/COMMANDS.md.template",
+    "README.md",
+    "tests/commands/demo.test.js",
+    "tests/lib/package-safety.test.js",
+    "scripts/ci/smoke-create-quiver.sh"
+  ],
+  "depends_on": [
+    "slice-01-init-template-hygiene",
+    "slice-06-plan-graph-next-history-views",
+    "slice-08-evidence-run-command"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Depends on init, history views, and evidence behavior; should integrate after those contracts stabilize.",
+  "must": [
+    "Add `demo create spec-viewer --dry-run`.",
+    "Add `demo create spec-viewer` for safe targets.",
+    "Keep the demo optional and out of default init.",
+    "Avoid heavy dependencies.",
+    "Generate demo spec/slice artifacts and validation scripts.",
+    "Respect non-destructive target handling."
+  ],
+  "not_included": [
+    "Persistent web console.",
+    "React/Vite/Express dependency stack unless explicitly justified later.",
+    "Real filesystem spec parsing in browser."
+  ],
+  "acceptance": [
+    "Dry-run prints planned demo files without writing.",
+    "Real run creates a small runnable demo in an empty or safe target.",
+    "Demo includes README, app files, package scripts, spec/slices, and validation.",
+    "Demo does not add heavy dependencies.",
+    "Existing files are preserved or reported as skipped.",
+    "Package safety excludes local demo output that should not ship."
+  ],
+  "tests": [
+    "node --test tests/commands/demo.test.js tests/lib/package-safety.test.js",
+    "npm run smoke:create-quiver"
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-10-docs-smokes-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-10: Docs, smokes, and release readiness
+
+## Resumen de lo realizado
+
+Se cerró v24 con documentación sincronizada, changelog/roadmap actualizados, smokes finales, package safety y evidencia de validación.
+
+## Validación contra criterios de aceptación
+
+- [x] README updated.
+- [x] README_FOR_AI synchronized.
+- [x] Smokes cover v24 behavior.
+- [x] Evidence report complete.
+- [x] Package safety passes.
+
+## Cambios relevantes
+
+- README ahora muestra `ai prepare-context`, evidence y demo en el flujo AI-first.
+- README_FOR_AI marca v24 como implementado y aclara que no hay release npm implícita.
+- ROADMAP y CHANGELOG registran v24 como implementado, pendiente de package release.
+- Troubleshooting y support matrix reflejan los nuevos modos de recuperación y el runtime Node cross-platform.
+- Smokes finales pasaron; `smoke:tiered-pack` ahora acepta warnings esperados del link checker.
+
+## Pendientes
+
+Sin pendientes críticos del spec. La publicación npm queda fuera de este slice.
+
+## Riesgos remanentes
+
+El cache local de npm tiene archivos root-owned; `npm pack --dry-run` directo falla en esta máquina, pero el dry-run con cache aislado y `npm run package:quiver` pasan.
+
+## Recomendaciones futuras
+
+Publish a new npm version only after this slice closes and package checks pass.

package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-10-docs-smokes-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,54 @@
+# EXECUTION BRIEF - slice-10: Docs, smokes, and release readiness
+
+## Contexto
+
+This is the final integration slice for v24. It must run after implementation behavior is stable.
+
+## Objetivo
+
+Close the spec with synchronized docs, smoke coverage, evidence, and package safety.
+
+## Alcance
+
+- README and README_FOR_AI updates.
+- Command/template docs.
+- Roadmap/changelog status.
+- Smoke tests.
+- Evidence report and status closure.
+- Package safety and pack dry-run.
+
+## Criterios de aceptación
+
+- Docs match implemented behavior.
+- Smokes cover v24 user paths.
+- Evidence report is complete.
+- Package safety passes.
+- No unreleased behavior is marked as published.
+
+## Plan técnico resumido
+
+Audit all changed behavior, update docs once, run final validations, and record evidence.
+
+## Pasos sugeridos de ejecución
+
+1. Review all implementation slices.
+2. Update docs/templates.
+3. Add/adjust smoke coverage.
+4. Run full tests and package checks.
+5. Update evidence/status/pr body.
+
+## Restricciones
+
+- Do not add new functional scope in this final slice.
+- Do not publish to npm.
+
+## Riesgos
+
+- Docs can overstate behavior if final validation fails; keep claims tied to evidence.
+
+## Checklist de finalización
+
+- [ ] Docs updated.
+- [ ] Smokes updated.
+- [ ] Full validation captured.
+- [ ] Status/evidence closed.

package/specs/quiver-v24-dx-onboarding-hardening/slices/slice-10-docs-smokes-release-readiness/slice.json

@@ -0,0 +1,76 @@
+{
+  "slice_id": "slice-10-docs-smokes-release-readiness",
+  "ticket": "QUIVER-24-10",
+  "type": "docs",
+  "title": "Docs, smokes, and release readiness",
+  "objective": "Close v24 with documentation, smoke coverage, evidence, and package safety checks.",
+  "description": "Update README, README_FOR_AI, roadmap, command docs, templates, smoke scripts, evidence report, and release readiness notes after implementation slices land.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "docs-smokes-release-readiness",
+    "branch_name": "feature/QUIVER-24-10-docs-smokes-release-readiness"
+  },
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "CHANGELOG.md",
+    "docs/COMMANDS.md.template",
+    "docs/WORKFLOW.md.template",
+    "docs/TROUBLESHOOTING.md.template",
+    "docs/SUPPORT_MATRIX.md.template",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-guided-workflow.sh",
+    "scripts/ci/smoke-tiered-pack.sh",
+    "tests/**",
+    "specs/quiver-v24-dx-onboarding-hardening/EVIDENCE_REPORT.md",
+    "specs/quiver-v24-dx-onboarding-hardening/STATUS.md",
+    "specs/quiver-v24-dx-onboarding-hardening/pr.md"
+  ],
+  "depends_on": [
+    "slice-01-init-template-hygiene",
+    "slice-02-cli-command-routing-version-errors",
+    "slice-03-doctor-fix-doc-link-checks",
+    "slice-04-prepare-output-ai-context-drafts",
+    "slice-05-local-slice-validation-base-guidance",
+    "slice-06-plan-graph-next-history-views",
+    "slice-07-analyzer-command-map-hardening",
+    "slice-08-evidence-run-command",
+    "slice-09-spec-viewer-demo-scaffolding"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Final integration slice must run after all implementation behavior is known.",
+  "must": [
+    "Update user-facing docs for all shipped v24 behavior.",
+    "Update README_FOR_AI.md to mark implemented behavior accurately.",
+    "Update ROADMAP/CHANGELOG without claiming an npm release unless it happened.",
+    "Add or update smoke tests.",
+    "Run final test and package safety checks.",
+    "Update evidence and status."
+  ],
+  "not_included": [
+    "Publishing to npm.",
+    "Opening or merging the PR.",
+    "Adding new product behavior not covered by earlier slices."
+  ],
+  "acceptance": [
+    "README documents v24 commands and safe first-use flow.",
+    "README_FOR_AI.md is synchronized with actual implemented behavior.",
+    "Smokes cover init hygiene, prepare, local slice validation, historical views, evidence, and demo dry-run.",
+    "Evidence report records final validation commands and results.",
+    "Package safety and npm pack dry-run pass.",
+    "No docs claim a package release that has not happened."
+  ],
+  "tests": [
+    "git diff --check",
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run smoke:guided-workflow",
+    "npm run smoke:tiered-pack",
+    "npm pack --dry-run"
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null
+}