create-quiver 0.9.0 → 0.10.0

package/specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/EXECUTION_BRIEF.md

@@ -0,0 +1,61 @@
+# EXECUTION BRIEF - slice-07: Documentation and guidance alignment
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-07-docs-guidance-alignment
+**Tipo:** docs
+
+## Contexto
+
+Despues de cambiar comportamiento, la documentacion debe dejar de presentar `docs-template/`, `tools/scripts/` y spec placeholder como default.
+
+## Objetivo
+
+Alinear README, README_FOR_AI, generated README y templates con el nuevo layout AI-first.
+
+## Alcance
+
+- Root README.
+- AI guide.
+- Generated README in Node and Bash paths.
+- Docs templates for commands, workflow, onboarding, support and troubleshooting.
+- Smoke assertions de docs.
+
+## Criterios de aceptacion
+
+- Toda la documentacion diferencia contrato visible de maquinaria interna.
+- `docs-template/` y `tools/scripts/` aparecen solo como legacy/opcionales.
+- Specs reales se documentan como salida de `ai plan --phase spec`.
+- Scan crudo y project map tienen paths correctos.
+
+## Plan tecnico resumido
+
+Actualizar docs despues de estabilizar comportamiento. Agregar asserts en smokes para evitar drift.
+
+## Pasos sugeridos de ejecucion
+
+1. Revisar textos actuales que nombren paths legacy.
+2. Actualizar README y README_FOR_AI.
+3. Actualizar generated README.
+4. Actualizar templates.
+5. Ajustar smokes de doc.
+6. Validar que no se prometan comandos inexistentes.
+
+## Restricciones
+
+- No cambiar codigo de comportamiento salvo generated README text.
+- No duplicar instrucciones largas.
+- No documentar flags no implementados.
+
+## Riesgos
+
+- Docs queden ahead del comportamiento.
+- README se vuelva demasiado largo.
+- Onboarding IA vuelva a abrir `.quiver/` innecesariamente.
+
+## Checklist de finalizacion
+
+- [ ] README actualizado.
+- [ ] README_FOR_AI actualizado.
+- [ ] Generated README actualizado.
+- [ ] Templates actualizados.
+- [ ] Smokes de docs pasan.

package/specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/slice.json

@@ -0,0 +1,67 @@
+{
+  "slice_id": "slice-07-docs-guidance-alignment",
+  "ticket": "QUIVER-21-07",
+  "type": "docs",
+  "title": "Align documentation with AI-first layout",
+  "objective": "Update human and AI-facing documentation so every source describes the same visible contract and internal `.quiver/` model.",
+  "description": "Behavior changes need docs alignment to avoid two competing truths about `docs-template/`, `tools/scripts/`, scans, and specs.",
+  "git": {
+    "branch_type": "docs",
+    "base_branch": "main",
+    "branch_slug": "docs-guidance-alignment",
+    "branch_name": "docs/QUIVER-21-07-docs-guidance-alignment"
+  },
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "docs/AI_ONBOARDING_PROMPT.md.template",
+    "docs/COMMANDS.md.template",
+    "docs/WORKFLOW.md.template",
+    "docs/SUPPORT_MATRIX.md.template",
+    "docs/TROUBLESHOOTING.md.template",
+    "docs/GITFLOW_PR_GUIDE.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "scripts/init-docs.sh",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-init-docs.sh",
+    "specs/quiver-v21-ai-first-layout/STATUS.md",
+    "specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-07-docs-guidance-alignment/slice.json"
+  ],
+  "depends_on": [
+    "slice-05-empty-specs-layout-doctor",
+    "slice-06-legacy-migration-optional-assets"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Docs must reflect final behavior from previous slices.",
+  "must": [
+    "Update root README to present AI-first layout and init profiles accurately.",
+    "Update README_FOR_AI so `docs-template/` is no longer the normal onboarding flow.",
+    "Update generated README content to explain visible contract vs internal `.quiver/` machinery.",
+    "Update commands/support/troubleshooting templates for new paths and flags.",
+    "Document that real specs are created by `ai plan --phase spec`, not default init.",
+    "Document legacy paths as compatibility, not recommended default."
+  ],
+  "not_included": [
+    "Changing behavior.",
+    "Release publication.",
+    "Large marketing rewrite unrelated to layout."
+  ],
+  "acceptance": [
+    "Docs agree that `.quiver/` is internal.",
+    "Docs agree that default init does not create `docs-template/`, `tools/scripts/`, or placeholder specs.",
+    "Generated README points agents to visible contract first.",
+    "Docs mention `.quiver/scans/PROJECT_SCAN.json` and visible `docs/PROJECT_MAP.md` correctly.",
+    "Legacy guidance is clearly marked as compatibility."
+  ],
+  "tests": [
+    "bash scripts/ci/smoke-init-docs.sh",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "estimated_hours": 5,
+  "actual_hours": 4,
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,35 @@
+# CLOSURE BRIEF - slice-08: Smokes and release readiness
+
+## Resumen de lo realizado
+
+Se ejecuto la matriz final de validacion para v21 y se ajusto `smoke-tiered-pack` para que pruebe explicitamente el perfil `--full --skip-install` cuando necesita assets legacy como spec placeholder y wrappers. Tambien se actualizaron evidencia, status y cuerpo de PR.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Suite Node pasa.
+- [x] Smokes pasan.
+- [x] Evidence actualizado.
+- [x] PR body listo.
+
+## Cambios relevantes
+
+- `scripts/ci/smoke-tiered-pack.sh` usa `init --full --skip-install` y espera la guia correcta de `doctor` para el estado AI-first sin specs.
+- `scripts/ci/smoke-cross-platform.js` usa `init` explicito para el smoke de perfiles.
+- `src/create-quiver/index.js` tiene fallback sin `npm` para empaquetar templates cuando `--skip-install` evita instalar dependencias.
+- Scripts legacy quedaron alineados con shellcheck y `check-slice` acepta `develop` local en modo sin origin.
+- `specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md` registra la matriz final.
+- `specs/quiver-v21-ai-first-layout/STATUS.md` marca la spec como completada.
+- `specs/quiver-v21-ai-first-layout/pr.md` queda listo para copiar al PR.
+- `slice.json` queda marcado como completado.
+
+## Pendientes
+
+No quedan pendientes dentro de esta spec. No se publico npm ni se abrio PR.
+
+## Riesgos remanentes
+
+La matriz local valida macOS/shell actual y el smoke cross-platform simulado; la verificacion definitiva multi-OS queda en CI.
+
+## Recomendaciones futuras
+
+Abrir PR de la spec con el cuerpo preparado y correr la CI completa antes de publicar una nueva version npm.

package/specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,66 @@
+# EXECUTION BRIEF - slice-08: Smokes and release readiness
+
+**Spec:** quiver-v21-ai-first-layout
+**Slice:** slice-08-smokes-release-readiness
+**Tipo:** chore
+
+## Contexto
+
+El cambio toca init, analyze, doctor, docs y compatibilidad legacy. El cierre debe probar todos los perfiles y estados criticos.
+
+## Objetivo
+
+Completar validaciones, evidencia y cuerpo de PR para la spec v21.
+
+## Alcance
+
+- Smokes de perfiles.
+- Smokes cross-platform.
+- Suite Node.
+- Evidence report.
+- PR body.
+- Fixes menores necesarios para que las validaciones pasen.
+
+## Criterios de aceptacion
+
+- Suite Node completa pasa.
+- Smokes principales pasan.
+- Evidencia real agregada.
+- PR body listo.
+- No queda drift documental conocido.
+
+## Plan tecnico resumido
+
+Ejecutar la matriz completa despues de todas las slices funcionales y documentales. Ajustar smokes o errores menores solo dentro del alcance de v21.
+
+## Pasos sugeridos de ejecucion
+
+1. Ejecutar suite Node.
+2. Ejecutar smoke create-quiver.
+3. Ejecutar smoke init-docs.
+4. Ejecutar smoke cross-platform.
+5. Revisar `git diff --check`.
+6. Actualizar evidence y PR body.
+7. Cerrar status.
+
+## Restricciones
+
+- No publicar npm.
+- No abrir PR sin pedido explicito.
+- No agregar nuevo alcance funcional.
+
+## Riesgos
+
+- Smokes lentos o dependientes de red.
+- Tests legacy que asumen layout viejo.
+- Fixes de ultimo minuto que expandan alcance.
+
+## Checklist de finalizacion
+
+- [ ] `node --test tests/**/*.test.js` pasa.
+- [ ] `npm run smoke:create-quiver` pasa.
+- [ ] `bash scripts/ci/smoke-init-docs.sh` pasa.
+- [ ] `node scripts/ci/smoke-cross-platform.js` pasa.
+- [ ] `git diff --check` pasa.
+- [ ] Evidence report actualizado.
+- [ ] PR body actualizado.

package/specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/slice.json

@@ -0,0 +1,62 @@
+{
+  "slice_id": "slice-08-smokes-release-readiness",
+  "ticket": "QUIVER-21-08",
+  "type": "chore",
+  "title": "Finalize smokes and release readiness",
+  "objective": "Run and harden the full validation matrix for the AI-first layout before PR or release work.",
+  "description": "This slice closes cross-profile smoke coverage, evidence, and final consistency checks.",
+  "git": {
+    "branch_type": "chore",
+    "base_branch": "main",
+    "branch_slug": "smokes-release-readiness",
+    "branch_name": "chore/QUIVER-21-08-smokes-release-readiness"
+  },
+  "files": [
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-init-docs.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "tests/**/*.test.js",
+    "specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md",
+    "specs/quiver-v21-ai-first-layout/STATUS.md",
+    "specs/quiver-v21-ai-first-layout/pr.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/CLOSURE_BRIEF.md",
+    "specs/quiver-v21-ai-first-layout/slices/slice-08-smokes-release-readiness/slice.json"
+  ],
+  "depends_on": [
+    "slice-07-docs-guidance-alignment"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Final validation depends on completed behavior and docs.",
+  "must": [
+    "Validate default, minimal, full, legacy-scripts, include-templates, and dry-run profiles.",
+    "Validate analyze scan relocation and visible project map.",
+    "Validate no-spec state for plan, graph, next, and doctor.",
+    "Validate legacy compatibility for scan, docs-template, and tools/scripts where applicable.",
+    "Update evidence report with real commands and outcomes.",
+    "Update PR body with summary, validation, and risks."
+  ],
+  "not_included": [
+    "Publishing to npm.",
+    "Opening the PR unless explicitly requested.",
+    "Changing product behavior beyond smoke fixes required for this spec."
+  ],
+  "acceptance": [
+    "Full Node test suite passes.",
+    "Create-quiver smoke passes.",
+    "Init-docs smoke passes.",
+    "Cross-platform smoke passes.",
+    "Evidence report is updated.",
+    "PR body is ready for review."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "bash scripts/ci/smoke-init-docs.sh",
+    "node scripts/ci/smoke-cross-platform.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 4,
+  "actual_hours": 3,
+  "status": "completed",
+  "blocked_reason": null
+}