create-quiver 0.9.1 → 0.12.0

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-06-ai-execute-slice-scope-enforcement/EXECUTION_BRIEF.md

@@ -0,0 +1,64 @@
+# EXECUTION BRIEF - slice-06: Execute slice with scope enforcement
+
+**Spec:** quiver-v20-ai-cli-orchestration
+**Slice:** slice-06-ai-execute-slice-scope-enforcement
+**Tipo:** feature
+
+## Contexto
+
+El executor es un agente de menor costo que puede modificar codigo directamente siguiendo el handoff. Para que sea seguro, Quiver debe controlar el scope antes y despues.
+
+## Objetivo
+
+Agregar `quiver ai execute-slice` con contexto minimo y validacion de scope.
+
+## Alcance
+
+- Subcomando `ai execute-slice`.
+- Requerir `--slice`.
+- Requerir `slice.json` y `EXECUTION_BRIEF.md`.
+- Preparar prompt executor con contexto `slice` o `minimal`.
+- Capturar diff antes/despues.
+- Ejecutar scope validation.
+
+## Criterios de aceptacion
+
+- Falla si falta `slice.json`.
+- Falla si falta `EXECUTION_BRIEF.md`.
+- Dry-run no ejecuta provider.
+- Detecta archivos fuera de scope.
+- No incluye onboarding full.
+- Error de provider sale con codigo no cero.
+
+## Plan tecnico resumido
+
+Crear `ai/executor.js` y conectar el subcomando en `commands/ai.js`. Reusar context packs, provider runner y scope validation existente.
+
+## Pasos sugeridos de ejecucion
+
+1. Implementar loader de slice y handoff.
+2. Implementar prompt executor.
+3. Integrar provider runner.
+4. Capturar diff pre/post.
+5. Validar scope.
+6. Agregar tests.
+
+## Restricciones
+
+- No commitear automaticamente.
+- No arreglar scope violations automaticamente.
+- No correr multiples executors en esta slice.
+
+## Riesgos
+
+- Scope validation incompleta.
+- Executor necesita mas contexto que el minimo.
+- Cambios de codigo fuera del handoff.
+
+## Checklist de finalizacion
+
+- [ ] Tests de execute-slice pasan.
+- [ ] Dry-run cubierto.
+- [ ] Scope violation cubierto.
+- [ ] Provider failure cubierto.
+

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-06-ai-execute-slice-scope-enforcement/slice.json

@@ -0,0 +1,65 @@
+{
+  "slice_id": "slice-06-ai-execute-slice-scope-enforcement",
+  "ticket": "QUIVER-20-06",
+  "type": "feature",
+  "title": "Add executor command with scope enforcement",
+  "objective": "Allow a low-cost executor agent to run a slice using minimal context, then verify that changes stayed inside the declared handoff scope.",
+  "description": "Implement quiver ai execute-slice with provider selection, executor role defaults, slice context pack, pre-run validation, post-run git diff inspection, and check-scope integration.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "ai-execute-slice-scope-enforcement",
+    "branch_name": "feature/QUIVER-20-06-ai-execute-slice-scope-enforcement"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/ai/executor.js",
+    "src/create-quiver/lib/ai/context-packs.js",
+    "src/create-quiver/lib/scope.js",
+    "tests/commands/ai-execute-slice.test.js",
+    "tests/lib/ai-executor.test.js"
+  ],
+  "depends_on": [
+    "slice-01-ai-provider-runner",
+    "slice-02-context-packs-token-budget",
+    "slice-05-execution-plan-parallel-worktrees"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Requires provider runner, context packs, and execution planning.",
+  "must": [
+    "Add npx create-quiver ai execute-slice.",
+    "Default role to executor and context to slice or minimal.",
+    "Require --slice path.",
+    "Require slice.json and EXECUTION_BRIEF.md.",
+    "Build an executor prompt from only the slice context pack.",
+    "Allow executor to modify code directly within declared scope.",
+    "Capture git diff before and after execution.",
+    "Run scope validation after execution.",
+    "Report scope violations clearly and fail the command."
+  ],
+  "not_included": [
+    "Automatically committing the slice.",
+    "Automatically fixing scope violations.",
+    "Running multiple executors concurrently."
+  ],
+  "acceptance": [
+    "execute-slice fails if slice.json is missing.",
+    "execute-slice fails if EXECUTION_BRIEF.md is missing.",
+    "execute-slice --dry-run prints minimal context selection without provider execution.",
+    "Post-run validation detects files outside the slice file list.",
+    "Executor prompt does not include full onboarding context.",
+    "Provider failure exits non-zero and preserves the provider error summary."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-execute-slice.test.js tests/lib/ai-executor.test.js",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "actual_hours": 5,
+  "started_at": "2026-05-19T20:01:48-0300",
+  "completed_at": "2026-05-19T20:01:48-0300",
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-07-github-pr-preflight/CLOSURE_BRIEF.md

@@ -0,0 +1,36 @@
+# CLOSURE BRIEF - slice-07: GitHub PR preflight
+
+## Resumen de lo realizado
+
+Se implemento el preflight de GitHub para `ai pr` y `ai doctor` con validacion cross-platform de `gh`, `gh auth status`, remote Git, worktree/rama, GitFlow guide e identidad SSH. Tambien se agregaron opciones separadas para `sshHostAlias` e `identityFile`, y se cubrio `--dry-run` sin abrir PRs.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Missing `gh` cubierto.
+- [x] Missing `gh auth` cubierto.
+- [x] Missing GitFlow guide cubierto.
+- [x] Missing identity file cubierto.
+- [x] `sshHostAlias` e `identityFile` separados.
+- [x] Dry-run no crea PR.
+
+## Cambios relevantes
+
+- `src/create-quiver/commands/ai.js`
+- `src/create-quiver/index.js`
+- `src/create-quiver/lib/ai/github.js`
+- `src/create-quiver/lib/git.js`
+- `tests/commands/ai-pr.test.js`
+- `tests/lib/ai-github.test.js`
+
+## Pendientes
+
+Ninguno para esta slice.
+
+## Riesgos remanentes
+
+- `gh auth status` valida el estado de login, pero no correlaciona la cuenta de GitHub con la identidad SSH.
+- El guia GitFlow todavia depende de que el archivo `docs/GITFLOW_PR_GUIDE.md` exista en el repo consumido.
+
+## Recomendaciones futuras
+
+Agregar la apertura real de PR cuando slice-08 deje listos los artefactos finales y el flujo documental.

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-07-github-pr-preflight/EXECUTION_BRIEF.md

@@ -0,0 +1,66 @@
+# EXECUTION BRIEF - slice-07: GitHub PR preflight
+
+**Spec:** quiver-v20-ai-cli-orchestration
+**Slice:** slice-07-github-pr-preflight
+**Tipo:** feature
+
+## Contexto
+
+Quiver debe preparar PRs siguiendo `docs/GITFLOW_PR_GUIDE.md`, usando `gh` y configuracion SSH portable. macOS, Linux y Windows necesitan guias distintas.
+
+## Objetivo
+
+Agregar preflight para PR con `gh`, auth, remote, worktree, GitFlow guide, `sshHostAlias` e `identityFile`.
+
+## Alcance
+
+- Validar `gh`.
+- Validar `gh auth status`.
+- Validar remote Git.
+- Validar worktree/rama.
+- Validar guia GitFlow.
+- Separar alias SSH y identity file.
+- Guiar configuracion sin modificar credenciales automaticamente.
+
+## Criterios de aceptacion
+
+- Missing `gh` muestra guia macOS/Linux/Windows.
+- `gh` no autenticado muestra `gh auth login`.
+- Falta GitFlow guide detiene el flujo.
+- Falta identity file muestra path revisado.
+- `sshHostAlias` e `identityFile` son opciones separadas.
+- Dry-run no crea PR.
+
+## Plan tecnico resumido
+
+Crear `ai/github.js` y extender preflight. Reusar helpers de Git. Los comandos externos deben usar arrays y ser mockeables en tests.
+
+## Pasos sugeridos de ejecucion
+
+1. Implementar checks de `gh`.
+2. Implementar checks de auth.
+3. Implementar checks de remote/worktree.
+4. Implementar checks SSH.
+5. Integrar en `ai doctor` y `ai pr`.
+6. Agregar tests.
+
+## Restricciones
+
+- No instalar `gh`.
+- No editar SSH config.
+- No abrir PR en tests.
+
+## Riesgos
+
+- Cuenta `gh` distinta al remote SSH.
+- Alias SSH confundido con path de key.
+- Windows path handling.
+
+## Checklist de finalizacion
+
+- [ ] Tests de PR preflight pasan.
+- [ ] Missing gh cubierto.
+- [ ] Missing auth cubierto.
+- [ ] Missing SSH cubierto.
+- [ ] Dry-run cubierto.
+

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-07-github-pr-preflight/slice.json

@@ -0,0 +1,63 @@
+{
+  "slice_id": "slice-07-github-pr-preflight",
+  "ticket": "QUIVER-20-07",
+  "type": "feature",
+  "title": "Add GitHub PR preflight with gh and SSH validation",
+  "objective": "Validate PR readiness across macOS, Linux, and Windows before Quiver opens or prepares a PR.",
+  "description": "Implement ai doctor and ai pr preflight checks for gh installation, gh authentication, Git remote, worktree branch, GitFlow guide, SSH host alias, identity file, and cross-platform setup guidance.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "ai-github-pr-preflight",
+    "branch_name": "feature/QUIVER-20-07-ai-github-pr-preflight"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/github.js",
+    "src/create-quiver/lib/ai/preflight.js",
+    "src/create-quiver/lib/git.js",
+    "tests/commands/ai-pr.test.js",
+    "tests/lib/ai-github.test.js"
+  ],
+  "depends_on": [
+    "slice-01-ai-provider-runner",
+    "slice-04-spec-slice-handoff-pr-generation"
+  ],
+  "parallel_safe": "after_dependencies",
+  "parallel_safe_reason": "Can run in parallel with slice-05 after slice-04 if command-file edits are coordinated.",
+  "must": [
+    "Add PR preflight checks for command -v gh.",
+    "Validate gh auth status.",
+    "Validate a Git remote exists.",
+    "Validate the current worktree/branch can be used for a spec PR.",
+    "Validate docs/GITFLOW_PR_GUIDE.md exists or provide a clear missing-guide error.",
+    "Separate sshHostAlias from identityFile.",
+    "Validate identityFile exists when provided.",
+    "Guide the user to create SSH config without modifying credentials automatically.",
+    "Provide macOS, Linux, and Windows install guidance for gh."
+  ],
+  "not_included": [
+    "Installing gh automatically.",
+    "Editing SSH config automatically.",
+    "Merging PRs.",
+    "Managing GitHub accounts beyond gh auth status."
+  ],
+  "acceptance": [
+    "Missing gh fails with cross-platform installation guidance.",
+    "Unauthenticated gh fails with gh auth login guidance.",
+    "Missing GitFlow guide fails before PR creation.",
+    "Missing identity file fails with the path that was checked.",
+    "sshHostAlias and identityFile are represented as separate options.",
+    "Dry-run prints what PR command would run without creating a PR."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-pr.test.js tests/lib/ai-github.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 5,
+  "actual_hours": 5,
+  "started_at": "2026-05-19T17:29:24-0300",
+  "completed_at": "2026-05-19T17:29:24-0300",
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-08-docs-smokes-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,35 @@
+# CLOSURE BRIEF - slice-08: Docs, smokes, and release readiness
+
+## Resumen de lo realizado
+
+Se actualizaron README, README_FOR_AI, templates generados, scripts npm, doctor warnings y smokes para reflejar la familia `quiver ai`: onboarding, planning por fases, execute-slice, PR preflight y doctor. Tambien se agregaron smokes dry-run que no dependen de providers reales ni de autenticacion real de GitHub.
+
+## Validacion contra criterios de aceptacion
+
+- [x] README actualizado.
+- [x] Templates actualizados.
+- [x] Scripts `quiver:ai:*` generados.
+- [x] Smokes dry-run agregados.
+- [x] Cross-platform smoke actualizado.
+- [x] Suite final documentada.
+
+## Cambios relevantes
+
+- `README.md` y `README_FOR_AI.md` documentan comandos AI reales y el flujo planner/executor.
+- `package.template.json` y `package.json` incluyen scripts `quiver:ai:*`.
+- `docs/COMMANDS.md.template`, `docs/AI_ONBOARDING_PROMPT.md.template`, `docs/SUPPORT_MATRIX.md.template`, `docs/TROUBLESHOOTING.md.template` y `docs/GITFLOW_PR_GUIDE.md.template` quedaron alineados con el comportamiento implementado.
+- `src/create-quiver/lib/init-docs.js` y `scripts/init-docs.sh` generan README con scripts AI y guidance planner/executor.
+- `scripts/ci/smoke-create-quiver.sh`, `scripts/ci/smoke-cross-platform.js` y `scripts/ci/smoke-init-docs.sh` validan scripts AI y dry-runs.
+
+## Pendientes
+
+Ninguno para esta slice.
+
+## Riesgos remanentes
+
+- `ai pr` sigue limitado a preflight en esta version; no abre PR real.
+- Los smokes usan dry-run y un `gh` falso para evitar dependencia de autenticacion real.
+
+## Recomendaciones futuras
+
+Preparar release patch/minor segun impacto final y actualizar changelog.

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-08-docs-smokes-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,64 @@
+# EXECUTION BRIEF - slice-08: Docs, smokes, and release readiness
+
+**Spec:** quiver-v20-ai-cli-orchestration
+**Slice:** slice-08-docs-smokes-release-readiness
+**Tipo:** docs
+
+## Contexto
+
+Esta slice cierra la feature. Debe alinear README, templates generados, scripts npm, prompts y smokes con el comportamiento real implementado.
+
+## Objetivo
+
+Documentar `quiver ai ...`, actualizar templates y agregar smokes dry-run sin depender de providers reales.
+
+## Alcance
+
+- README y README_FOR_AI.
+- Templates de onboarding, commands, support, troubleshooting y GitFlow.
+- Scripts generados en package templates.
+- Smokes create-quiver y cross-platform.
+- Verificacion de docs generadas.
+
+## Criterios de aceptacion
+
+- README generado menciona comandos AI.
+- COMMANDS generado incluye ejemplos `quiver ai`.
+- Onboarding prompt generado explica planner/executor.
+- Scripts `quiver:ai:*` existen.
+- Smokes cubren dry-run sin auth real.
+- Cross-platform cubre paths con espacios.
+
+## Plan tecnico resumido
+
+Actualizar documentacion y generadores despues de que los comandos existan. Los smokes deben usar dry-run/mocks para no requerir Codex, Claude, Gemini ni `gh` autenticado.
+
+## Pasos sugeridos de ejecucion
+
+1. Revisar comportamiento final implementado.
+2. Actualizar README.
+3. Actualizar templates.
+4. Actualizar init docs runtime.
+5. Agregar scripts npm generados.
+6. Agregar smokes.
+7. Correr suite completa.
+
+## Restricciones
+
+- No cambiar comportamiento funcional fuera de docs/smokes salvo ajuste necesario para generacion.
+- No publicar npm en esta slice.
+- No modificar specs antiguas.
+
+## Riesgos
+
+- Docs prometen mas de lo implementado.
+- Smokes requieren CLIs reales por accidente.
+- Drift entre README_FOR_AI y templates.
+
+## Checklist de finalizacion
+
+- [ ] Tests unitarios pasan.
+- [ ] Smoke create-quiver pasa.
+- [ ] Cross-platform smoke pasa.
+- [ ] README_FOR_AI no contradice README/templates.
+- [ ] No hay prompts obsoletos.

package/specs/quiver-v20-ai-cli-orchestration/slices/slice-08-docs-smokes-release-readiness/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-08-docs-smokes-release-readiness",
+  "ticket": "QUIVER-20-08",
+  "type": "docs",
+  "title": "Document AI orchestration and add smoke coverage",
+  "objective": "Update user-facing docs, generated templates, scripts, and smoke tests so the AI orchestration workflow is discoverable and release-ready.",
+  "description": "Finalize the feature by documenting commands, roles, context packs, token strategy, provider setup, gh/SSH preflight, and cross-platform behavior. Add dry-run smokes that do not require real provider authentication.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "ai-orchestration-docs-smokes",
+    "branch_name": "feature/QUIVER-20-08-ai-orchestration-docs-smokes"
+  },
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "docs/AI_ONBOARDING_PROMPT.md.template",
+    "docs/COMMANDS.md.template",
+    "docs/GITFLOW_PR_GUIDE.md.template",
+    "docs/SUPPORT_MATRIX.md.template",
+    "docs/TROUBLESHOOTING.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "scripts/init-docs.sh",
+    "package.json",
+    "package.template.json",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js"
+  ],
+  "depends_on": [
+    "slice-01-ai-provider-runner",
+    "slice-02-context-packs-token-budget",
+    "slice-03-ai-phase-gated-planner",
+    "slice-04-spec-slice-handoff-pr-generation",
+    "slice-05-execution-plan-parallel-worktrees",
+    "slice-06-ai-execute-slice-scope-enforcement",
+    "slice-07-github-pr-preflight"
+  ],
+  "parallel_safe": "never",
+  "parallel_safe_reason": "Final integration slice touches shared docs, templates, package scripts, and smoke tests.",
+  "must": [
+    "Document quiver ai commands in README.",
+    "Document planner and executor roles.",
+    "Document token-efficient context packs.",
+    "Document phase-gated planning and approval rules.",
+    "Document mandatory slice-00.",
+    "Document one spec equals one PR/worktree and one slice equals one commit.",
+    "Document gh and SSH preflight guidance for macOS, Linux, and Windows.",
+    "Add generated npm scripts for quiver:ai:* commands.",
+    "Add smoke tests for dry-run flows without real provider auth.",
+    "Ensure docs/GITFLOW_PR_GUIDE.md is generated or the intended generation behavior is explicitly validated."
+  ],
+  "not_included": [
+    "Adding new provider APIs.",
+    "Publishing npm.",
+    "Changing unrelated docs or old specs."
+  ],
+  "acceptance": [
+    "Generated project README mentions quiver ai commands.",
+    "Generated COMMANDS.md includes ai commands and examples.",
+    "Generated onboarding prompt references planner/executor workflow safely.",
+    "Generated package scripts include quiver:ai:onboard, quiver:ai:plan, quiver:ai:execute-slice, quiver:ai:pr, and quiver:ai:doctor.",
+    "Smoke tests cover ai dry-run flows without requiring provider CLIs.",
+    "Cross-platform smoke validates path handling for ai commands."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "node scripts/ci/smoke-cross-platform.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "actual_hours": 5,
+  "started_at": "2026-05-19T21:43:12-0300",
+  "completed_at": "2026-05-19T21:43:12-0300",
+  "status": "completed",
+  "blocked_reason": null
+}

package/specs/quiver-v21-ai-first-layout/EVIDENCE_REPORT.md

@@ -0,0 +1,31 @@
+# Evidence Report - Quiver v21 AI-First Layout
+
+## Summary
+
+Implementation and release-readiness validation are complete.
+
+## Evidence By Slice
+
+| Slice | Evidence |
+| --- | --- |
+| slice-00 | Completed. Created spec foundation, all slice handoffs, execution plan, and PR body. Validated JSON parsing for all `slice.json` files and `git diff --check`. |
+| slice-01 | Completed. Added explicit `init` command parsing, init profile flags, pure layout planner, dry-run formatter, compatibility alias handling, and focused tests. Evidence: `node --test tests/lib/init-layout.test.js tests/commands/init-profiles.test.js`; `git diff --check`. |
+| slice-02 | Completed. Added `.quiver/` internal path helpers, versionable config, internal gitignore for runtime folders, packaged/exported/legacy template resolver, and explicit template-root support in init docs. Evidence: `node --test tests/lib/template-resolver.test.js tests/lib/quiver-internal-layout.test.js tests/lib/init-layout.test.js tests/commands/init-profiles.test.js`; `git diff --check`. |
+| slice-03 | Completed. Implemented profile-aware init generation. Default no longer creates root `docs-template/`, `tools/scripts/`, or placeholder specs; minimal creates the essential onboarding contract; full preserves the broad compatibility layout. Evidence: `node --test tests/**/*.test.js`; `bash scripts/ci/smoke-init-docs.sh`; `bash scripts/ci/smoke-create-quiver.sh`; `git diff --check`. |
+| slice-04 | Completed. Moved raw analyze output to `.quiver/scans/PROJECT_SCAN.json`, kept `docs/PROJECT_MAP.md` visible, added current/legacy scan helpers, and wired context pack metadata plus doctor scan detection to accept the new path with legacy fallback. Evidence: `node --test tests/commands/analyze.test.js tests/lib/project-scan.test.js tests/lib/ai-context-packs.test.js`; `node --test tests/**/*.test.js`; `bash scripts/ci/smoke-create-quiver.sh`; `node scripts/ci/smoke-cross-platform.js`; `git diff --check`. |
+| slice-05 | Completed. Updated doctor so projects initialized with the clean AI-first layout can have no specs yet without failing. Added layout detection for new, legacy, hybrid, and incomplete projects while preserving valid empty states for plan, graph, and next. Evidence: `node --test tests/commands/doctor.test.js tests/lib/doctor.test.js tests/commands/plan.test.js tests/commands/graph.test.js tests/commands/next.test.js`; `node --test tests/**/*.test.js`; `git diff --check`. |
+| slice-06 | Completed. Added non-destructive migrate reporting for legacy `docs-template/`, `tools/scripts/`, and `docs/PROJECT_SCAN.json`, plus explicit optional asset coverage for `--legacy-scripts`, `--include-templates`, and `--full`. Evidence: `node --test tests/commands/init-profiles.test.js tests/lib/init-docs.test.js`; `bash scripts/ci/smoke-init-docs.sh`; `bash scripts/ci/smoke-create-quiver.sh`; `node scripts/ci/smoke-cross-platform.js`; `node --test tests/**/*.test.js`; `git diff --check`. |
+| slice-07 | Completed. Aligned root README, AI guide, onboarding/workflow/command templates, generated README text, and smoke assertions with the AI-first layout. Docs now distinguish visible contract from `.quiver/` internals, mark `docs-template/` and `tools/scripts/` as legacy/optional, and point raw scan output to `.quiver/scans/PROJECT_SCAN.json`. Evidence: `node --test tests/commands/init-profiles.test.js tests/lib/init-docs.test.js`; `bash scripts/ci/smoke-init-docs.sh`; `bash scripts/ci/smoke-create-quiver.sh`; `node --test tests/**/*.test.js`; `bash -n scripts/init-docs.sh`; `git diff --check`. |
+| slice-08 | Completed. Hardened the tiered context-pack smoke to use the explicit `--full --skip-install` compatibility profile and updated expectations for the no-spec AI-first doctor guidance. Completed the final validation matrix. Evidence: `node --test tests/**/*.test.js`; `npm run smoke:create-quiver`; `bash scripts/ci/smoke-init-docs.sh`; `node scripts/ci/smoke-cross-platform.js`; `npm run smoke:tiered-pack`; `git diff --check`. |
+
+## Final Evidence
+
+- `node --test tests/**/*.test.js` passed: 143 tests.
+- `npm run smoke:create-quiver` passed.
+- `bash scripts/ci/smoke-init-docs.sh` passed.
+- `node scripts/ci/smoke-cross-platform.js` passed.
+- `PATH=/private/tmp/quiver-no-npm-path-bin node bin/create-quiver.js init --name "No Npm Smoke 2" --dir /private/tmp/quiver-no-npm-smoke-2 --full --skip-install` passed, covering init when `npm` is unavailable and install is skipped.
+- `npm run smoke:tiered-pack` passed.
+- `git diff --check` passed.
+- GitHub Actions CI run `26196340530` passed validate plus macOS, Ubuntu, and Windows cross-platform smoke jobs.
+- Default init is covered by tests and smokes that assert no root `docs-template/`, no `tools/scripts/`, and no placeholder spec in the default/minimal profiles.