create-quiver 0.15.4 → 0.16.0

package/.github/pull_request_template.md

@@ -2,3 +2,20 @@
 
 Please fill in the slice `pr.md` and keep this PR aligned with it.
 
+## PR Policy
+
+- [ ] This PR contains one slice only.
+- [ ] Grouped PR exception: this PR contains at most 2-3 slices, all docs-only, research-only, or low-risk mechanical cleanup.
+- [ ] This PR does not mix docs with UI, backend, refactor, or performance work.
+- [ ] Each included slice has separate evidence.
+- [ ] The whole PR can be reverted without leaving partial state.
+
+Individual PRs are mandatory for functional code, UI/UX, Supabase, Edge Functions, auth, storage, preview, performance/code-splitting, refactors, and tests or CI changes that affect gates.
+
+## Merge Policy
+
+- [ ] Human merge is expected.
+- [ ] Assisted auto-merge is explicitly authorized for this PR or for this documented category.
+- [ ] Assisted auto-merge conditions are met: docs-only or chore-only, low risk, no runtime changes, no production configuration changes, green checks, and no pending comments.
+
+Assisted auto-merge is prohibited for UI, Supabase, Edge Functions, auth, storage, preview, performance, refactors, and changes with doubtful rollback.

package/.github/workflows/ci.yml

@@ -17,6 +17,14 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm ci
+
       - name: Install shellcheck
         run: sudo apt-get update && sudo apt-get install -y shellcheck
 
@@ -28,6 +36,43 @@ jobs:
           node -e "const fs=require('fs'); const {parseJsonWithComments}=require('./src/create-quiver/lib/json'); parseJsonWithComments(fs.readFileSync('specs/[project-name]/slices/slice-template/slice.json', 'utf8'))"
           node -e "const fs=require('fs'); const {parseJsonWithComments}=require('./src/create-quiver/lib/json'); parseJsonWithComments(fs.readFileSync('specs/quiver-v01/slices/slice-01-legal-integrity/slice.json', 'utf8'))"
 
+  tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run portable test suite
+        run: npm run test:ci
+
+      - name: Run package smoke
+        run: npm run package:quiver
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run docs checks
+        run: npm run docs:check
+
   cross-platform-smoke:
     strategy:
       fail-fast: false
@@ -52,6 +97,37 @@ jobs:
       - name: Run cross-platform smoke
         run: node scripts/ci/smoke-cross-platform.js
 
+      - name: Run Windows PowerShell portable path smoke
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $versionJson = node .\bin\create-quiver.js version --json
+          $version = $versionJson | ConvertFrom-Json
+          if (-not $version.version_schema_version -or -not $version.cli.version) {
+            throw "create-quiver version JSON did not include version schema metadata"
+          }
+          node .\bin\create-quiver.js slice check --local specs\quiver-v51-cli-ergonomics-automation-contracts\slices\slice-00-cli-contract-baseline\slice.json
+          node .\bin\create-quiver.js handoff check specs\quiver-v51-cli-ergonomics-automation-contracts\slices\slice-06-namespace-compatibility-windows-scripts\EXECUTION_BRIEF.md
+          npm run quiver:check-handoff -- specs\quiver-v51-cli-ergonomics-automation-contracts\slices\slice-06-namespace-compatibility-windows-scripts\EXECUTION_BRIEF.md
+          npm run test:ci -- tests\lib\paths.test.js
+
       - name: Run tiered pack smoke
         shell: bash
         run: bash scripts/ci/smoke-tiered-pack.sh
+
+  minimum-node:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup minimum supported Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.12.0
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run full test suite on minimum Node
+        run: npm run test:ci

package/.markdown-link-check.json

@@ -0,0 +1,15 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "^https?://"
+    },
+    {
+      "pattern": "^mailto:"
+    },
+    {
+      "pattern": "^#"
+    }
+  ],
+  "retryOn429": false,
+  "timeout": "5s"
+}

package/.markdownlint.json

@@ -0,0 +1,11 @@
+{
+  "default": true,
+  "MD012": false,
+  "MD013": false,
+  "MD024": {
+    "siblings_only": true
+  },
+  "MD033": false,
+  "MD041": false,
+  "MD060": false
+}

package/.quiver/runs/run-2026-06-09t19-14-39z/approvals.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "run_id": "run-2026-06-09t19-14-39z",
+  "approvals": []
+}

package/.quiver/runs/run-2026-06-09t19-14-39z/decisions.md

@@ -0,0 +1,2 @@
+# Decisions
+

package/.quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/docs/INDEX.md

@@ -0,0 +1,97 @@
+# Quiver Documentation Index
+
+**Last updated:** 2026-05-29
+
+Use this file as the first documentation map before planning, implementing, reviewing, or opening PRs in this repository. Prefer the smallest set of linked documents that fits the task.
+
+## Start Here
+
+- **Public overview:** [`../README.md`](../README.md)
+- **AI guide:** [`../README_FOR_AI.md`](../README_FOR_AI.md)
+- **CLI UX standards:** [`./CLI_UX_GUIDE.md`](./CLI_UX_GUIDE.md)
+- **Command reference:** [`./reference/commands.md`](./reference/commands.md)
+- **Slice JSON schema:** [`./reference/slice-schema.md`](./reference/slice-schema.md)
+- **Troubleshooting:** [`./TROUBLESHOOTING.md`](./TROUBLESHOOTING.md)
+- **Git and PR workflow:** [`./GITFLOW_PR_GUIDE.md`](./GITFLOW_PR_GUIDE.md)
+
+## Getting Started
+
+- **Install and npx behavior:** [`./getting-started/installation.md`](./getting-started/installation.md)
+- **macOS setup:** [`./getting-started/macos.md`](./getting-started/macos.md)
+- **Linux setup:** [`./getting-started/linux.md`](./getting-started/linux.md)
+- **Windows PowerShell setup:** [`./getting-started/windows-powershell.md`](./getting-started/windows-powershell.md)
+- **Windows Git Bash / WSL setup:** [`./getting-started/windows-git-bash-wsl.md`](./getting-started/windows-git-bash-wsl.md)
+
+## Workflows
+
+- **New project:** [`./workflows/new-project.md`](./workflows/new-project.md)
+- **Existing project:** [`./workflows/existing-project.md`](./workflows/existing-project.md)
+- **Legacy Quiver project:** [`./workflows/legacy-quiver-project.md`](./workflows/legacy-quiver-project.md)
+- **Full AI spec-to-PR flow:** [`./workflows/full-ai-spec-to-pr.md`](./workflows/full-ai-spec-to-pr.md)
+
+## AI Configuration
+
+- **AI principles:** [`./ai/PRINCIPLES.md`](./ai/PRINCIPLES.md)
+- **AI rules:** [`./ai/RULES.yaml`](./ai/RULES.yaml)
+
+## Specs
+
+Canonical specs live outside `docs/` in [`../specs/`](../specs/).
+
+Recent specs:
+
+- [`../specs/quiver-v45-ci-actions-node24-readiness/SPEC.md`](../specs/quiver-v45-ci-actions-node24-readiness/SPEC.md)
+- [`../specs/quiver-v44-provider-live-output-tui-lite/SPEC.md`](../specs/quiver-v44-provider-live-output-tui-lite/SPEC.md)
+- [`../specs/quiver-v43-cli-i18n-audit-release-readiness/SPEC.md`](../specs/quiver-v43-cli-i18n-audit-release-readiness/SPEC.md)
+- [`../specs/quiver-v42-cli-i18n-generated-docs/SPEC.md`](../specs/quiver-v42-cli-i18n-generated-docs/SPEC.md)
+- [`../specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md`](../specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md)
+- [`../specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md`](../specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md)
+- [`../specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md`](../specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md)
+- [`../specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md`](../specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md)
+- [`../specs/quiver-v37-cli-i18n-foundation/SPEC.md`](../specs/quiver-v37-cli-i18n-foundation/SPEC.md)
+- [`../specs/quiver-v36-ai-run-watch-portable/SPEC.md`](../specs/quiver-v36-ai-run-watch-portable/SPEC.md)
+- [`../specs/quiver-v35-compact-dashboard-version-ux/SPEC.md`](../specs/quiver-v35-compact-dashboard-version-ux/SPEC.md)
+- [`../specs/quiver-v34-cli-dashboard-status/SPEC.md`](../specs/quiver-v34-cli-dashboard-status/SPEC.md)
+
+For implementation work, read the target spec and the target slice's `slice.json`, `EXECUTION_BRIEF.md`, and `CLOSURE_BRIEF.md` only.
+
+## Templates
+
+These files are templates for generated projects or optional profiles. Do not treat them as concrete project state unless the task is about templates or init output:
+
+- [`./AI_CONTEXT.md.template`](./AI_CONTEXT.md.template)
+- [`./AI_ONBOARDING_PROMPT.md.template`](./AI_ONBOARDING_PROMPT.md.template)
+- [`./COMMANDS.md.template`](./COMMANDS.md.template)
+- [`./CONTEXTO.md.template`](./CONTEXTO.md.template)
+- [`./DECISIONS.md.template`](./DECISIONS.md.template)
+- [`./DOCUMENTATION_GUIDE.md.template`](./DOCUMENTATION_GUIDE.md.template)
+- [`./STATUS.md.template`](./STATUS.md.template)
+- [`./SUPPORT_MATRIX.md.template`](./SUPPORT_MATRIX.md.template)
+- [`./TESTING_GUIDE_FOR_AI.md.template`](./TESTING_GUIDE_FOR_AI.md.template)
+- [`./WORKFLOW.md.template`](./WORKFLOW.md.template)
+- [`./ai/LESSONS.md.template`](./ai/LESSONS.md.template)
+
+## Task Routing
+
+- **Documentation/index work:** read this index, then the affected docs only.
+- **CLI UX, output, dashboard, or version work:** read [`./CLI_UX_GUIDE.md`](./CLI_UX_GUIDE.md), [`./reference/commands.md`](./reference/commands.md), and the relevant spec.
+- **Spec or slice execution:** read the relevant [`../specs/`](../specs/) package, especially the target slice files.
+- **PR creation:** read [`./GITFLOW_PR_GUIDE.md`](./GITFLOW_PR_GUIDE.md) and the relevant `pr.md`.
+- **Troubleshooting or install issues:** read [`./TROUBLESHOOTING.md`](./TROUBLESHOOTING.md) and the matching getting-started guide.
+- **AI agent behavior:** read [`../README_FOR_AI.md`](../README_FOR_AI.md), [`./ai/PRINCIPLES.md`](./ai/PRINCIPLES.md), and [`./ai/RULES.yaml`](./ai/RULES.yaml).
+
+## Known Documentation Debt
+
+The following concrete docs are referenced by templates or generated-project guidance but do not currently exist as repository docs:
+
+- `docs/CONTEXTO.md`
+- `docs/WORKFLOW.md`
+- `docs/STATUS.md`
+- `docs/SUPPORT_MATRIX.md`
+- `docs/TESTING_GUIDE_FOR_AI.md`
+- `docs/AI_CONTEXT.md`
+- `docs/AI_ONBOARDING_PROMPT.md`
+- `docs/DECISIONS.md`
+- `docs/ai/LESSONS.md`
+
+Use the `.template` files only when the task is about generated project output or template maintenance.

package/.quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/manifest.json

@@ -0,0 +1,61 @@
+{
+  "schema_version": 1,
+  "run_id": "run-2026-06-09t19-14-39z",
+  "created_at": "2026-06-09T19:14:39.889Z",
+  "entries": [
+    {
+      "path": "docs/INDEX.md",
+      "action": "update",
+      "existed": true,
+      "snapshot_path": ".quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/docs/INDEX.md"
+    },
+    {
+      "path": "docs/PROJECT_MAP.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/AI_CONTEXT.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/AI_ONBOARDING_PROMPT.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/CONTEXTO.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/WORKFLOW.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/ARCHITECTURE.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/STATUS.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    },
+    {
+      "path": "docs/DECISIONS.md",
+      "action": "create",
+      "existed": false,
+      "snapshot_path": null
+    }
+  ]
+}

package/.quiver/runs/run-2026-06-09t19-14-39z/state.json

@@ -0,0 +1,28 @@
+{
+  "schema_version": 1,
+  "run_id": "run-2026-06-09t19-14-39z",
+  "status": "active",
+  "phase": "onboarding-ready",
+  "spec_slug": null,
+  "created_at": "2026-06-09T19:14:39.888Z",
+  "updated_at": "2026-06-09T19:14:39.894Z",
+  "requirement": {
+    "source_file": null,
+    "path": ".quiver/runs/run-2026-06-09t19-14-39z/requirement.md"
+  },
+  "approvals_path": ".quiver/runs/run-2026-06-09t19-14-39z/approvals.json",
+  "decisions_path": ".quiver/runs/run-2026-06-09t19-14-39z/decisions.md",
+  "history": [
+    {
+      "phase": "created",
+      "command": "ai prepare-context",
+      "at": "2026-06-09T19:14:39.888Z"
+    },
+    {
+      "phase": "onboarding-ready",
+      "command": "ai prepare-context",
+      "artifact": ".quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/manifest.json",
+      "at": "2026-06-09T19:14:39.894Z"
+    }
+  ]
+}

package/ACTIVE_SLICES.md

@@ -0,0 +1,43 @@
+# Active Slices
+
+> Archivo local generado por `tools/scripts/refresh-active-slices.sh`.
+> No se trackea en git.
+
+**Actualizado:** 2026-06-09T19:15:40.959Z
+
+## Convencion
+
+- `Alias`: identificador corto para hablar del slice sin ambiguedad
+- `Spec`: directorio del spec
+- `slice-00`: baseline congelado, solo referencia
+- `slice-01+`: implementacion o revalidacion
+
+## Checkout Principal
+
+| Branch | Path |
+|--------|------|
+| release/create-quiver-0.16.0 | /Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/quiver |
+
+## Implementacion Activa
+
+| Alias | Spec | Slice | Branch | Estado | Path |
+|-------|------|-------|--------|--------|------|
+| QUI-01 | quiver-v52-schema-docs-release-hygiene | slice-01-json-schema-for-slice-json | feature/QUIVER-52-01-v52-slice-json-schema | completed | /Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/.worktrees/quiver/feature-QUIVER-52-01-v52-slice-json-schema |
+
+## Baselines Congelados
+
+| Alias | Spec | Slice | Branch | Estado | Path |
+|-------|------|-------|--------|--------|------|
+| - | - | - | - | - | - |
+
+## Worktrees Auxiliares
+
+| Branch | Path |
+|--------|------|
+| - | - |
+
+## Recomendacion Operativa
+
+- En VS Code, dejar visibles solo `develop` y la tabla de `Implementacion Activa`.
+- Tratar la tabla de `Baselines Congelados` como solo lectura.
+- Cerrar visualmente los `Worktrees Auxiliares` salvo cuando estes trabajando ese PR o esa tarea de proceso.

package/ARCHITECTURE.md

@@ -0,0 +1,133 @@
+# Quiver Architecture
+
+Quiver is a Node.js CLI package published as `create-quiver`. It bootstraps and
+operates a WDD + SDD workflow around specs, slices, handoffs, validation
+evidence, and PR readiness.
+
+## Runtime Entrypoints
+
+| Surface | Path | Purpose |
+|---|---|---|
+| CLI binary | `bin/create-quiver.js` | Package binary for `create-quiver` and `quiver`. |
+| Main dispatcher | `src/create-quiver/index.js` | Parses top-level args, routes commands, renders help, and wires command modules. |
+| Package scripts | `package.json` | Contributor and generated workflow shortcuts such as `quiver:plan`, `quiver:graph`, and `package:quiver`. |
+
+The public bootstrap command is `npx create-quiver ...`. The `quiver` binary is
+a local installed alias to the same entrypoint.
+
+## Command Layer
+
+Command modules live under `src/create-quiver/commands/`.
+
+| Area | Representative files | Responsibility |
+|---|---|---|
+| Project setup | `analyze.js`, `prepare.js`, `config.js` | Project scans, diagnostics, language config, and preparation checks. |
+| Read-only status | `dashboard.js`, `flow.js`, `next.js`, `plan.js`, `graph.js` | Guided status, dependency graphs, and next-slice discovery. |
+| AI workflow | `ai.js`, `src/create-quiver/lib/ai/**` | Planner drafts, approvals, profiles, execution plans, provider execution, PR preflight, and export. |
+| Specs and lifecycle | `spec.js`, `src/create-quiver/lib/lifecycle.js`, `src/create-quiver/lib/spec-worktrees.js` | Spec creation/validation, slice readiness, worktrees, and closure. |
+| Evidence and demos | `evidence.js`, `demo.js` | Validation evidence capture and optional static Spec Viewer demo generation. |
+
+The current `origin/main` help surface uses legacy slice/handoff commands such
+as `start-slice`, `check-slice`, `check-pr`, `check-handoff`, `new-handoff`,
+`cleanup-slice`, `check-scope`, and `refresh-active-slices`.
+
+## Library Layer
+
+Shared logic lives under `src/create-quiver/lib/`.
+
+| Area | Representative files |
+|---|---|
+| Project analysis and generated docs | `analyze.js`, `project-scan.js`, `init-docs.js`, `init-layout.js`, `template-resolver.js` |
+| State and safety | `state.js`, `project-state-resolver.js`, `statuses.js`, `locks.js`, `paths.js`, `scope.js` |
+| UX and i18n | `cli/ux.js`, `cli/theme.js`, `cli/selectors.js`, `cli/ux-flags.js`, `i18n/**` |
+| AI orchestration | `ai/artifacts.js`, `ai/context-packs.js`, `ai/executor.js`, `ai/providers.js`, `ai/spec-generator.js`, `ai/phase-gates.js` |
+| Spec graphing | `slice.js`, `slice-graph.js`, `renderers/tree.js`, `renderers/mermaid.js`, `renderers/dot.js` |
+| Packaging | `package-safety.js`, `version.js` |
+
+Keep command modules thin where possible. Put reusable behavior in `lib/` so it
+can be tested without spawning the full CLI.
+
+## Specs and Slices
+
+Quiver dogfoods its own workflow in `specs/quiver-vNN-*`.
+
+Each spec contains:
+
+- `SPEC.md`: problem, objective, scope, acceptance criteria, guardrails.
+- `STATUS.md`: current status and per-slice state.
+- `EVIDENCE_REPORT.md`: validation evidence and decisions.
+- `EXECUTION_PLAN.md`: dependency-aware execution order.
+- `pr.md`: PR body source.
+- `slices/<slice-id>/slice.json`: machine-readable scope, dependencies, and validation.
+- `slices/<slice-id>/EXECUTION_BRIEF.md`: executor instructions.
+- `slices/<slice-id>/CLOSURE_BRIEF.md`: completion conditions and validation record.
+
+Slice numbering resets inside each spec. `slice-00` is the documentary
+foundation for that spec; `slice-01` is the first implementation slice in that
+same spec.
+
+## Generated Project Contract
+
+When Quiver initializes another project, it writes visible workflow docs and
+internal state:
+
+- Visible docs: `AGENTS.md`, `docs/**`, `specs/<project-slug>/**` when specs are created.
+- Internal state: `.quiver/config.json`, `.quiver/state.json`,
+  `.quiver/scans/PROJECT_SCAN.json`, `.quiver/runs/**`, `.quiver/agents/**`.
+
+Do not treat `.quiver/` as product code. It is local workflow state and must not
+be published to npm.
+
+## Templates and Localization
+
+Human Markdown templates live under `docs/*.template`; Spanish variants use
+`.es.template`. Machine-readable artifacts, command names, flags, ids,
+providers, and JSON keys are not localized.
+
+Spec templates live under `specs/[project-name]/`. Optional docs examples live
+under `docs/examples/`.
+
+## Package Boundary
+
+`scripts/package-quiver.sh` builds and validates the npm tarball. The package
+must include the CLI entrypoint, runtime source, README, public docs/templates,
+community files, package scripts, and the minimal spec template.
+
+The package must exclude tests, local examples, historical dogfooding specs that
+are explicitly ignored, CI-only scripts, local PDFs, worktrees, provider state,
+secrets, `.DS_Store`, and npm credentials. `src/create-quiver/lib/package-safety.js`
+enforces additional unsafe-path checks against tarball contents.
+
+## Tests and Smokes
+
+| Command | Purpose |
+|---|---|
+| `node --test` | Full Node test suite. |
+| `node --test tests/<file>.js` | Targeted test file. |
+| `npm run package:quiver` | Build tarball and validate package contents. |
+| `bash scripts/ci/smoke-create-quiver.sh` | Package-installed CLI smoke. |
+| `npm run smoke:doctor-fixtures` | Doctor/preflight fixture smoke. |
+| `npm run smoke:tiered-pack` | Tiered packaging smoke. |
+| `npm run smoke:guided-workflow` | Guided workflow smoke. |
+
+Run `node bin/create-quiver.js --help` after changing command surfaces or docs
+that mention command names.
+
+## CI
+
+`.github/workflows/ci.yml` currently validates shell scripts, selected slice
+templates, cross-platform smoke behavior on Ubuntu/macOS/Windows, and package
+smoke coverage.
+
+CI should stay deterministic and local-first. Avoid adding blocking network link
+checks or publish steps unless a slice explicitly provides the safety contract.
+
+## Design Constraints
+
+- Keep JSON stdout clean and machine-readable.
+- Keep prompts and spinners out of CI, no-TTY, `--json`, and `--no-color` flows.
+- Preserve existing command compatibility unless a slice explicitly scopes a
+  breaking change.
+- Prefer additive fields and aliases over removing established contracts.
+- Do not publish local audit files, generated PDFs, worktrees, secrets, or AI
+  raw provider state.

package/CHANGELOG.md

@@ -6,6 +6,12 @@ All notable changes to this project will be documented in this file.
 
 ### Added
 
+- Top-level read-only `changelog` command with human and JSON output for inspecting packaged release notes.
+- Spec 01 branch-recovery closure package under `docs/specs/01-spec/`, including controlled branch-cleanup guidance and release-readiness evidence.
+- v52 schema/docs/release hygiene under `specs/quiver-v52-schema-docs-release-hygiene/`.
+- Public `slice.json` JSON Schema docs and schema validation with `npm run schema:slice:check`.
+- Generated CLI command reference drift checks with `npm run docs:commands:write` and `npm run docs:commands:check`.
+- Changelog validation with `npm run changelog:check`.
 - Implemented v31 AI model catalog and guided agent setup under `specs/quiver-v31-ai-model-catalog-agent-selection/`.
 - Local known-model catalog for Codex, Claude, and Gemini, with role metadata, alias normalization, and `ai models list`.
 - Guided provider/model selection for `ai agent set <role>`, plus `ai agent doctor` and `ai agent repair --dry-run` for legacy or invalid profiles.
@@ -17,6 +23,12 @@ All notable changes to this project will be documented in this file.
 
 ### Changed
 
+- CLI parser and command registry are now split into explicit modules while preserving existing command behavior and legacy aliases.
+- Release-readiness evidence now includes a command-role audit that explains what each public command is for and how it was safely validated.
+- `npm run docs:check` now includes generated CLI command reference drift detection.
+- Package smoke now installs the generated tarball and verifies the installed CLI with `--version`, `--help`, and `init --dry-run`.
+- Release dry-runs now require changelog, docs, schema, installer, package, and installed CLI smoke gates before publishing guidance.
+- Release publishing remains explicitly guarded and requires `QUIVER_ALLOW_NPM_PUBLISH=1` when using publish flags.
 - Agent profiles now distinguish the technical `model` id passed to provider CLIs from the human `displayName` shown in Quiver output.
 - Live AI commands now normalize safe CLI model aliases, block persisted display aliases before provider execution, and surface invalid-model provider failures more clearly.
 - Public docs, generated templates, CLI help, and smoke checks now describe model catalog entries as known by Quiver, not guaranteed account availability.