create-quiver 0.15.3 → 0.16.0

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/pr.md

@@ -0,0 +1,146 @@
+# PR - QUIVER-52-01 - JSON Schema for slice.json
+
+## Title
+
+QUIVER-52-01 JSON Schema for slice.json
+
+## Summary
+
+Publishes a Draft-07 JSON Schema for executable Quiver `slice.json` files and adds an AJV-backed validation check. The schema is derived from current runtime validation/generation behavior, validates real runtime-valid fixtures, rejects representative invalid fixtures, and is required in package smoke as a public artifact.
+
+## PR Policy
+
+- [x] One slice only.
+- [ ] Grouped PR exception: at most 2-3 slices, all docs-only, research-only, or low-risk mechanical cleanup.
+- [x] No behavior changes in a grouped PR.
+- [x] No mixed docs with UI, backend, refactor, or performance work.
+- [x] Separate evidence for this slice is recorded in `EVIDENCE_REPORT.md`.
+- [x] Whole PR is revertible without leaving partial state.
+
+Individual PR required classification: schema artifact, validation script, tests, docs, package smoke, and slice metadata.
+
+### Merge Policy
+
+- [x] Human merge expected.
+- [ ] Assisted auto-merge explicitly authorized for this PR or documented category.
+- [ ] Assisted auto-merge conditions 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 not requested.
+
+## Scope
+
+- Add `docs/schema/slice.schema.json` as JSON Schema Draft-07.
+- Add `npm run schema:slice:check`.
+- Add AJV as a direct devDependency and synchronize `package-lock.json`.
+- Validate runtime-valid real fixtures from `specs/**` and `examples/**`.
+- Reject representative invalid fixtures.
+- Document schema usage and runtime source-of-truth boundaries.
+- Require the public schema and schema reference doc in package smoke.
+- Update v52 status, evidence, closure, slice metadata, and PR body.
+
+## Files
+
+- `docs/INDEX.md`
+- `docs/reference/slice-schema.md`
+- `docs/schema/slice.schema.json`
+- `package.json`
+- `package-lock.json`
+- `scripts/ci/check-slice-schema.js`
+- `scripts/package-quiver.sh`
+- `tests/fixtures/slice-schema/invalid/empty-files.json`
+- `tests/fixtures/slice-schema/invalid/missing-git-field.json`
+- `tests/fixtures/slice-schema/invalid/missing-slice-id.json`
+- `tests/fixtures/slice-schema/invalid/unsafe-allowed-write-path.json`
+- `tests/schema/slice-schema.test.js`
+- `specs/quiver-v52-schema-docs-release-hygiene/SPEC.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/STATUS.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/CLOSURE_BRIEF.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/pr.md`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js supported by the repo.
+- npm.
+- Git.
+
+### Worktree Access
+
+```bash
+cd /Users/fabrijk/Documents/Work/Proyectos\ Personales/nika/frameworks/quiver
+git switch feature/QUIVER-52-01-v52-slice-json-schema
+```
+
+### Run the Project
+
+No runtime server is required. This is schema, validation tooling, docs, tests, package smoke, and spec evidence.
+
+### Use Cases
+
+#### Case 1: validate real slice fixtures
+
+1. Run `npm run schema:slice:check`.
+2. Inspect the summary.
+
+**Expected result:** runtime-valid `specs/**` and `examples/**` fixtures pass, placeholder templates are skipped, and representative invalid fixtures fail.
+
+#### Case 2: use schema in docs
+
+1. Open `docs/reference/slice-schema.md`.
+2. Confirm it links to `docs/schema/slice.schema.json`.
+3. Run `npm run docs:check`.
+
+**Expected result:** docs lint and link checks pass with the schema reference included.
+
+#### Case 3: package includes public schema
+
+1. Run `npm run package:quiver`.
+2. Inspect the package smoke output.
+
+**Expected result:** package smoke passes and requires `package/docs/schema/slice.schema.json` plus `package/docs/reference/slice-schema.md`.
+
+#### Case 4: representative invalid fixture rejection
+
+1. Run `node --test tests/schema/slice-schema.test.js`.
+2. Inspect the invalid fixtures under `tests/fixtures/slice-schema/invalid`.
+
+**Expected result:** missing `slice_id`, missing git metadata, empty `files`, and unsafe traversal path fixtures are rejected by AJV.
+
+### Technical Verification
+
+```bash
+npm ci
+npm run schema:slice:check
+node --test tests/schema/slice-schema.test.js
+npm run docs:check
+npm run package:quiver
+node --test
+git diff --check
+node bin/create-quiver.js spec validate specs/quiver-v52-schema-docs-release-hygiene
+node bin/create-quiver.js check-slice specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json --local --gate validation
+node bin/create-quiver.js check-scope specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json --base main --strict
+node bin/create-quiver.js check-pr specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json --base main
+```
+
+## Evidence
+
+- `npm run schema:slice:check`: passed; 266 runtime-valid fixtures validated, 1 historical/non-runtime fixture skipped, 4 invalid fixtures rejected.
+- `node --test tests/schema/slice-schema.test.js`: passed, 2 tests.
+- `npm run docs:check`: passed, 21 files in docs scope.
+- `npm run package:quiver`: passed and required the public schema/doc paths.
+
+## Rollback
+
+1. Revert this slice commit with `git revert <commit-sha>`.
+2. Run the technical verification commands above.
+3. Confirm `docs/schema/slice.schema.json`, `schema:slice:check`, AJV dependency changes, schema docs, package smoke requirements, and schema tests are removed.
+
+## Risks / Notes
+
+- The schema is maintained manually from current runtime behavior because Quiver does not yet have a single schema source generator.
+- `check-slice --local` still requires non-empty `files`; the schema reflects that stricter executable contract even though newer scope tooling can prefer `allowed_write_paths`.
+- Placeholder template slice files are intentionally skipped by schema validation because they contain scaffolding placeholders, not executable slice contracts.
+- One historical v18 slice is skipped as non-runtime-valid because it lacks current required execution metadata.

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json

@@ -0,0 +1,106 @@
+{
+  "slice_id": "slice-01-json-schema-for-slice-json",
+  "ticket": "QUIVER-52-01",
+  "type": "feature",
+  "title": "JSON Schema for slice.json",
+  "objective": "Publish a slice.json JSON Schema aligned with runtime behavior.",
+  "description": "Generates or authors a schema only after the source of truth is confirmed and validates it against real fixtures.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v52-slice-json-schema",
+    "branch_name": "feature/QUIVER-52-01-v52-slice-json-schema"
+  },
+  "files": [
+    "docs/INDEX.md",
+    "docs/reference/slice-schema.md",
+    "docs/schema/slice.schema.json",
+    "package.json",
+    "package-lock.json",
+    "scripts/ci/check-slice-schema.js",
+    "scripts/package-quiver.sh",
+    "tests/fixtures/slice-schema/invalid/empty-files.json",
+    "tests/fixtures/slice-schema/invalid/missing-git-field.json",
+    "tests/fixtures/slice-schema/invalid/missing-slice-id.json",
+    "tests/fixtures/slice-schema/invalid/unsafe-allowed-write-path.json",
+    "tests/schema/slice-schema.test.js",
+    "specs/quiver-v52-schema-docs-release-hygiene/SPEC.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/STATUS.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/CLOSURE_BRIEF.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/pr.md"
+  ],
+  "expected_read_paths": [
+    "package.json",
+    "scripts/package-quiver.sh",
+    "src/create-quiver/lib/slice.js",
+    "src/create-quiver/lib/slice-graph.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/readiness.js",
+    "src/create-quiver/lib/ai/spec-generator.js",
+    "specs/**/slices/**/slice.json",
+    "tests/**"
+  ],
+  "allowed_write_paths": [
+    "docs/INDEX.md",
+    "docs/reference/slice-schema.md",
+    "docs/schema/**",
+    "package.json",
+    "package-lock.json",
+    "scripts/ci/check-slice-schema.js",
+    "scripts/package-quiver.sh",
+    "tests/fixtures/slice-schema/invalid/empty-files.json",
+    "tests/fixtures/slice-schema/invalid/missing-git-field.json",
+    "tests/fixtures/slice-schema/invalid/missing-slice-id.json",
+    "tests/fixtures/slice-schema/invalid/unsafe-allowed-write-path.json",
+    "tests/schema/slice-schema.test.js",
+    "specs/quiver-v52-schema-docs-release-hygiene/SPEC.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/STATUS.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/CLOSURE_BRIEF.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/slice.json",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-01-json-schema-for-slice-json/pr.md"
+  ],
+  "depends_on": [
+    "slice-00-schema-docs-release-baseline"
+  ],
+  "parallel_safe": "yes",
+  "parallel_safe_reason": "Schema work can run independently after baseline, but package smoke updates must coordinate with slice-03.",
+  "must": [
+    "Create docs/schema/slice.schema.json.",
+    "Validate real valid fixtures.",
+    "Reject representative invalid fixtures.",
+    "Document schema usage and generation.",
+    "Keep schema aligned with runtime behavior."
+  ],
+  "not_included": [
+    "Changing slice runtime semantics unless required and explicitly documented.",
+    "Adding IDE-specific config unless minimal and justified."
+  ],
+  "acceptance": [
+    "Schema is valid JSON Schema Draft-07 or higher.",
+    "Schema validates existing valid slice fixtures.",
+    "Schema rejects representative invalid fixtures.",
+    "Docs reference the schema.",
+    "Package smoke includes the schema if it is public."
+  ],
+  "tests": [
+    "npm ci",
+    "npm run schema:slice:check",
+    "node --test tests/schema/slice-schema.test.js",
+    "npm run docs:check",
+    "node --test",
+    "npm run package:quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "If adding schema tooling dependencies, commit package-lock changes."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 5,
+  "started_at": "2026-06-03T00:00:00-0300",
+  "completed_at": "2026-06-03T00:25:00-0300"
+}

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE_BRIEF - slice-02 generated CLI reference
+
+## Summary
+
+Added a generated CLI command reference block and drift check that preserve curated docs outside explicit markers.
+
+- Added `scripts/ci/check-command-reference.js` with `--write` and `--check` modes.
+- Generated the protected block in `docs/reference/commands.md`.
+- Added `npm run docs:commands:write` and `npm run docs:commands:check`.
+- Wired `docs:commands:check` into `npm run docs:check`.
+- Added tests for runtime-help consistency, docs synchronization, and manual-content preservation.
+
+## Validation
+
+- [x] `npm run docs:commands:write`
+- [x] `npm run docs:commands:check`
+- [x] `node --test tests/docs/command-reference.test.js`
+- [x] `node bin/create-quiver.js --help`
+- [x] `npm run docs:check`
+- [x] `npm ci`
+- [x] `node --test`
+- [x] `git diff --check`
+
+## Closure Conditions
+
+- [x] Generated content protected.
+- [x] Drift check available.
+- [x] Manual docs preserved.
+- [x] CI/docs check can fail on drift without rewriting files.
+
+## Open Items
+
+- None.

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/EXECUTION_BRIEF.md

@@ -0,0 +1,67 @@
+# EXECUTION_BRIEF - slice-02 generated CLI reference
+
+## Context
+
+`docs/reference/commands.md` can drift from runtime help. Generation must not erase curated explanations.
+
+## Objective
+
+Generate or drift-check CLI command reference without overwriting curated documentation.
+
+## Scope
+
+- Generated docs blocks or separate generated file.
+- Drift check.
+- Local script.
+- CI/release integration point.
+
+## Acceptance Criteria
+
+- Manual content outside generated blocks is untouched.
+- Generated content matches runtime help or registry metadata.
+- Drift check can fail CI/release without rewriting files.
+- Generation/check command is documented.
+
+## Expected Files To Modify
+
+- `docs/reference/commands.md`
+- `scripts/**`
+- `package.json`
+- `package-lock.json`
+- `tests/**`
+- `specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md`
+
+## Validations Required
+
+- `npm ci`
+- `node --test`
+- `node bin/create-quiver.js --help`
+- docs generation check command
+- `git diff --check`
+
+## Risks
+
+- Destroying curated docs.
+- Generating unstable output.
+- Lockfile drift after adding scripts/dependencies.
+
+## Dependencies
+
+- Depends on `slice-00-schema-docs-release-baseline`.
+
+## Instructions For Executor
+
+1. Use generated blocks or a separate file.
+2. Add a check mode for CI.
+3. Keep manual docs protected.
+4. Record drift validation evidence.
+
+## Completion Checklist
+
+- [ ] Acceptance criteria satisfied.
+- [ ] Required validations run or blockers documented.
+- [ ] Closure brief updated.
+
+## Conditions Of Closure
+
+- CLI reference drift is detectable without losing curated content.

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/pr.md

@@ -0,0 +1,144 @@
+# PR - QUIVER-52-02 - Generated CLI reference
+
+## Title
+
+QUIVER-52-02 Generated CLI reference
+
+## Summary
+
+Adds a protected generated CLI command reference block to `docs/reference/commands.md` and a no-dependency drift check that validates the generated content against CLI help metadata and runtime `--help` output. The check is wired into `npm run docs:check` so CI/release validation can fail on drift without rewriting docs.
+
+## PR Policy
+
+- [x] One slice only.
+- [ ] Grouped PR exception: at most 2-3 slices, all docs-only, research-only, or low-risk mechanical cleanup.
+- [x] No behavior changes in a grouped PR.
+- [x] No mixed docs with UI, backend, refactor, or performance work.
+- [x] Separate evidence for this slice is recorded in `EVIDENCE_REPORT.md`.
+- [x] Whole PR is revertible without leaving partial state.
+
+Individual PR required classification: docs generation tooling, docs drift check, tests affecting docs gate, and slice metadata.
+
+### Merge Policy
+
+- [x] Human merge expected.
+- [ ] Assisted auto-merge explicitly authorized for this PR or documented category.
+- [ ] Assisted auto-merge conditions 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 not requested.
+
+## Scope
+
+- Add `scripts/ci/check-command-reference.js` with `--write` and `--check` modes.
+- Add a protected generated block to `docs/reference/commands.md`.
+- Preserve curated command documentation outside generated markers.
+- Add `docs:commands:write` and `docs:commands:check` npm scripts.
+- Wire `docs:commands:check` into `docs:check`.
+- Add tests for runtime help consistency, drift synchronization, and manual-content preservation.
+- Update v52 status, evidence, closure, slice metadata, and PR body.
+
+## Files
+
+- `docs/reference/commands.md`
+- `package.json`
+- `scripts/ci/check-command-reference.js`
+- `tests/docs/command-reference.test.js`
+- `specs/quiver-v52-schema-docs-release-hygiene/SPEC.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/spec.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/STATUS.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/CLOSURE_BRIEF.md`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json`
+- `specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/pr.md`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js supported by the repo.
+- npm.
+- Git.
+
+### Worktree Access
+
+```bash
+cd /Users/fabrijk/Documents/Work/Proyectos\ Personales/nika/frameworks/quiver
+git switch feature/QUIVER-52-02-v52-generated-cli-reference
+```
+
+### Run the Project
+
+No runtime server is required. This is docs generation tooling, docs drift validation, tests, and spec evidence.
+
+### Use Cases
+
+#### Case 1: regenerate command reference
+
+1. Run `npm run docs:commands:write`.
+2. Inspect `docs/reference/commands.md`.
+
+**Expected result:** only the generated block between `<!-- quiver:generated-cli-reference:start -->` and `<!-- quiver:generated-cli-reference:end -->` changes.
+
+#### Case 2: detect docs drift without rewriting
+
+1. Run `npm run docs:commands:check`.
+2. Inspect the command summary.
+
+**Expected result:** check mode exits successfully when the generated block is synchronized and exits non-zero with guidance to run `docs:commands:write` when stale or missing.
+
+#### Case 3: preserve curated docs
+
+1. Review content before and after the generated markers in `docs/reference/commands.md`.
+2. Run `node --test tests/docs/command-reference.test.js`.
+
+**Expected result:** manual content outside markers is preserved and the focused preservation test passes.
+
+#### Case 4: CI/docs gate includes drift check
+
+1. Run `npm run docs:check`.
+2. Inspect the final step.
+
+**Expected result:** markdown lint, link check, and generated CLI reference drift check all pass.
+
+### Technical Verification
+
+```bash
+npm ci
+npm run docs:commands:write
+npm run docs:commands:check
+node --test tests/docs/command-reference.test.js
+npm run docs:check
+node bin/create-quiver.js --help
+node --test
+git diff --check
+node bin/create-quiver.js spec validate specs/quiver-v52-schema-docs-release-hygiene
+node bin/create-quiver.js check-slice specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json --local --gate validation
+node bin/create-quiver.js check-scope specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json --base main --strict
+node bin/create-quiver.js check-pr specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json --base main
+```
+
+## Evidence
+
+- `npm run docs:commands:write`: passed; generated 7 groups and 59 commands.
+- `npm run docs:commands:check`: passed; generated block is synchronized.
+- `node --test tests/docs/command-reference.test.js`: passed, 3 tests.
+- `node bin/create-quiver.js --help`: passed.
+- `npm run docs:check`: passed, including generated CLI reference drift check.
+- `npm ci`: passed; 165 packages installed/audited, 0 vulnerabilities reported.
+- `node --test`: passed, 651 tests.
+- `git diff --check`: passed.
+- `node bin/create-quiver.js spec validate specs/quiver-v52-schema-docs-release-hygiene`: passed.
+- `node bin/create-quiver.js check-slice specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json --local --gate validation`: passed.
+
+## Rollback
+
+1. Revert this slice commit with `git revert <commit-sha>`.
+2. Run the technical verification commands above.
+3. Confirm `docs:commands:write`, `docs:commands:check`, the generated block, command reference script, and focused tests are removed.
+
+## Risks / Notes
+
+- The generator reads `COMMAND_HELP_GROUPS` from `src/create-quiver/index.js` because that is the current source used by runtime help.
+- The drift check also runs `node bin/create-quiver.js --lang en --help --no-color` to detect mismatch between metadata and runtime help.
+- The generated block is English because the runtime help metadata is English. Existing curated Spanish documentation remains outside the generated block.
+- No package dependency or lockfile update is required.

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json

@@ -0,0 +1,86 @@
+{
+  "slice_id": "slice-02-generated-cli-reference",
+  "ticket": "QUIVER-52-02",
+  "type": "automation",
+  "title": "Generated CLI reference",
+  "objective": "Generate or drift-check CLI command reference without overwriting curated documentation.",
+  "description": "Adds a safe generation/drift-check path for docs/reference/commands.md based on runtime help or registry metadata.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v52-generated-cli-reference",
+    "branch_name": "feature/QUIVER-52-02-v52-generated-cli-reference"
+  },
+  "files": [
+    "docs/reference/commands.md",
+    "scripts/ci/check-command-reference.js",
+    "package.json",
+    "tests/docs/command-reference.test.js",
+    "specs/quiver-v52-schema-docs-release-hygiene/SPEC.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/spec.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/STATUS.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/CLOSURE_BRIEF.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/pr.md"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/command-registry.js",
+    "docs/reference/commands.md",
+    "tests/commands/cli-contract.test.js"
+  ],
+  "allowed_write_paths": [
+    "docs/reference/commands.md",
+    "scripts/ci/check-command-reference.js",
+    "package.json",
+    "tests/docs/command-reference.test.js",
+    "specs/quiver-v52-schema-docs-release-hygiene/SPEC.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/spec.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/STATUS.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/EVIDENCE_REPORT.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/CLOSURE_BRIEF.md",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/slice.json",
+    "specs/quiver-v52-schema-docs-release-hygiene/slices/slice-02-generated-cli-reference/pr.md"
+  ],
+  "depends_on": [
+    "slice-00-schema-docs-release-baseline"
+  ],
+  "parallel_safe": "yes",
+  "parallel_safe_reason": "Generated reference work can run independently after baseline.",
+  "must": [
+    "Protect curated manual docs content.",
+    "Generate only delimited blocks or a separate generated file.",
+    "Add drift check against runtime help or registry.",
+    "Document the local generation/check command."
+  ],
+  "not_included": [
+    "Replacing all docs with generated output.",
+    "Changing command help semantics."
+  ],
+  "acceptance": [
+    "Manual content outside generated blocks remains untouched.",
+    "Generated content matches runtime help/registry.",
+    "CI or release can detect drift.",
+    "Script command is documented."
+  ],
+  "tests": [
+    "npm ci",
+    "npm run docs:commands:write",
+    "npm run docs:commands:check",
+    "node --test tests/docs/command-reference.test.js",
+    "npm run docs:check",
+    "node --test",
+    "node bin/create-quiver.js --help",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Prefer a --check mode so CI can fail on drift without rewriting files."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 4,
+  "started_at": "2026-06-03T00:45:00-0300",
+  "completed_at": "2026-06-03T01:00:00-0300"
+}

package/specs/quiver-v52-schema-docs-release-hygiene/slices/slice-03-changelog-package-release-smoke-hygiene/CLOSURE_BRIEF.md

@@ -0,0 +1,38 @@
+# CLOSURE_BRIEF - slice-03 changelog, package, and release smoke hygiene
+
+## Summary
+
+Formalized changelog and release/package hygiene while keeping publishing manually guarded.
+
+- Added `npm run changelog:check` and focused tests.
+- Updated `[Unreleased]` changelog entries for v52.
+- Hardened `.npmignore` and package smoke exclusions for local audit/tool/secret artifacts.
+- Extended package smoke to install the tarball and run installed CLI `--version`, `--help`, and `init --dry-run`.
+- Wired docs CI to `npm run docs:check`.
+- Added changelog/docs/schema gates to release dry-run.
+- Required `QUIVER_ALLOW_NPM_PUBLISH=1` for release publish flags.
+
+## Validation
+
+- [x] `npm run changelog:check`
+- [x] `node --test tests/ci/changelog.test.js`
+- [x] `bash -n scripts/package-quiver.sh scripts/release-quiver.sh`
+- [x] `shellcheck scripts/package-quiver.sh scripts/release-quiver.sh`
+- [x] `npm run package:quiver`
+- [x] installed tarball smoke
+- [x] `npm run release:quiver`
+- [x] `npm run docs:check`
+- [x] `npm ci`
+- [x] `node --test`
+- [x] `git diff --check`
+
+## Closure Conditions
+
+- [x] Changelog process documented.
+- [x] Package smoke validates required and forbidden files.
+- [x] Installed tarball smoke passes.
+- [x] Publish automation remains safely scoped.
+
+## Open Items
+
+- None.