create-quiver 0.15.3 → 0.16.0

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-04-ai-execution-pr/slice.json

@@ -0,0 +1,72 @@
+{
+  "slice_id": "slice-04-ai-execution-pr",
+  "ticket": "QUIVER-41-04",
+  "type": "feature",
+  "title": "AI execution and PR",
+  "objective": "Localize AI execution and PR wrapper output without changing git, gh, or validation behavior.",
+  "description": "Covers execute-slice, execute-plan, and PR creation dry-run/review/create surfaces.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v41-ai-execution-pr",
+    "branch_name": "feature/QUIVER-41-04-v41-ai-execution-pr"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/execution-plan.js",
+    "src/create-quiver/lib/ai/github.js",
+    "src/create-quiver/lib/i18n/messages/en.js",
+    "src/create-quiver/lib/i18n/messages/es.js",
+    "tests/commands/ai-execute-slice.test.js",
+    "tests/commands/ai-execute-plan.test.js",
+    "tests/commands/ai-pr.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**",
+    "docs/GITFLOW_PR_GUIDE.md",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/execution-plan.js",
+    "src/create-quiver/lib/ai/github.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/ai-execute-slice.test.js",
+    "tests/commands/ai-execute-plan.test.js",
+    "tests/commands/ai-pr.test.js",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/**"
+  ],
+  "depends_on": [
+    "slice-03-ai-planner-approval-review"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Touches AI execution and PR command logic after planner/approval localization.",
+  "must": [
+    "Localize execution and PR wrapper messages.",
+    "Keep git/gh commands exact.",
+    "Preserve review and dry-run behavior.",
+    "Keep automation outputs stable."
+  ],
+  "not_included": [
+    "Changing GitHub integration behavior."
+  ],
+  "acceptance": [
+    "Execution and PR commands render in en and es.",
+    "Dry-run and review tests pass.",
+    "GitHub/gh command semantics are unchanged."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-execute-slice.test.js tests/commands/ai-execute-plan.test.js tests/commands/ai-pr.test.js tests/lib/i18n-catalog.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "If no ai-pr test exists, add focused dry-run tests rather than relying on live gh."
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": "",
+  "completed_at": "2026-05-29T17:52:55Z"
+}

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-05-ai-tests-smokes/CLOSURE_BRIEF.md

@@ -0,0 +1,15 @@
+# CLOSURE_BRIEF - slice-05 AI tests and smokes
+
+## Summary
+
+Completed. v41 was closed with full local test, package, smoke, spec, slice, and whitespace validation. During validation, a mixed-language live progress gap was fixed under `slice-06-ai-prepare-context-progress-i18n-fix`; this slice records the final validation evidence after that fix.
+
+## Validation
+
+- [x] `node --test tests/**/*.test.js` (`599/599`)
+- [x] `npm run package:quiver` (`create-quiver-0.15.3.tgz`)
+- [x] `npm run smoke:create-quiver`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v41-cli-i18n-ai-lifecycle --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-05-ai-tests-smokes/slice.json --local`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-06-ai-prepare-context-progress-i18n-fix/slice.json --local`
+- [x] `git diff --check`

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-05-ai-tests-smokes/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-05 AI tests and smokes
+
+## Context
+
+AI lifecycle localization touches the highest-risk CLI flows because provider and GitHub integrations are involved.
+
+## Objective
+
+Close v41 with full tests, package smoke, and evidence.
+
+## Acceptance Criteria
+
+- Full test suite passes.
+- Package smoke passes.
+- Provider prompt and JSON/JSONL stability are explicitly evidenced.
+- Spec validation passes.
+
+## Completion Checklist
+
+- [ ] Full tests run.
+- [ ] Package smoke run.
+- [ ] Evidence updated.

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-05-ai-tests-smokes/slice.json

@@ -0,0 +1,66 @@
+{
+  "slice_id": "slice-05-ai-tests-smokes",
+  "ticket": "QUIVER-41-05",
+  "type": "validation",
+  "title": "AI tests and smokes",
+  "objective": "Validate AI lifecycle localization and record release evidence.",
+  "description": "Runs full validation for v41 after AI lifecycle command migration.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v41-ai-tests-smokes",
+    "branch_name": "feature/QUIVER-41-05-v41-ai-tests-smokes"
+  },
+  "files": [
+    "tests/**/*.test.js",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/STATUS.md",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-05-ai-tests-smokes/CLOSURE_BRIEF.md",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/EVIDENCE_REPORT.md"
+  ],
+  "expected_read_paths": [
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "tests/**",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/**"
+  ],
+  "depends_on": [
+    "slice-02-ai-agent-models",
+    "slice-04-ai-execution-pr",
+    "slice-06-ai-prepare-context-progress-i18n-fix"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This is the closing validation slice for v41.",
+  "must": [
+    "Run full validation.",
+    "Confirm provider prompts remain stable.",
+    "Confirm JSON/JSONL outputs remain pure.",
+    "Record evidence."
+  ],
+  "not_included": [
+    "Live provider execution requiring external credentials."
+  ],
+  "acceptance": [
+    "Full tests pass.",
+    "Package smoke passes.",
+    "Spec validation passes.",
+    "Evidence report is updated."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npx create-quiver spec validate specs/quiver-v41-cli-i18n-ai-lifecycle --strict",
+    "npm run package:quiver",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use dry-run and print-prompt tests for provider-backed flows instead of requiring provider credentials."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": "",
+  "completed_at": "2026-05-29T18:04:10Z"
+}

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-06-ai-prepare-context-progress-i18n-fix/CLOSURE_BRIEF.md

@@ -0,0 +1,11 @@
+# CLOSURE_BRIEF - slice-06 AI prepare-context progress i18n fix
+
+## Summary
+
+Completed. `ai onboard` and `ai prepare-context --with-planner` now use catalog-backed progress checks for base-doc reading, structure detection, and prompt preparation. This removes mixed-language live progress when the default language is English and keeps Spanish available through the same catalog path.
+
+## Validation
+
+- [x] `node --test tests/commands/ai-plan.test.js tests/commands/ai-prepare-context-planner.test.js tests/commands/ai-review-plan.test.js tests/lib/i18n-catalog.test.js`
+- [x] `node --test tests/**/*.test.js`
+- [x] `git diff --check`

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-06-ai-prepare-context-progress-i18n-fix/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-06 AI prepare-context progress i18n fix
+
+## Context
+
+The closing v41 validation found that live progress for `ai prepare-context --with-planner` mixed English headings and spinner labels with Spanish progress checks when no explicit Spanish language was selected. The same progress helper is used by `ai onboard`.
+
+## Objective
+
+Ensure live progress checks for onboard and planner prepare-context use the resolved Quiver language consistently.
+
+## Acceptance Criteria
+
+- `ai onboard` and `ai prepare-context --with-planner` progress checks use catalog-backed `en` and `es` messages.
+- English defaults do not render Spanish progress checks.
+- Spanish messages remain available through the shared catalog.
+- Provider prompts, JSON output, command snippets, provider ids, and model ids remain unchanged.
+
+## Completion Checklist
+
+- [x] Progress checks moved to shared i18n catalog keys.
+- [x] Focused tests updated for the corrected English default.
+- [x] i18n catalog completeness validated.

package/specs/quiver-v41-cli-i18n-ai-lifecycle/slices/slice-06-ai-prepare-context-progress-i18n-fix/slice.json

@@ -0,0 +1,70 @@
+{
+  "slice_id": "slice-06-ai-prepare-context-progress-i18n-fix",
+  "ticket": "QUIVER-41-06",
+  "type": "fix",
+  "title": "AI prepare-context progress i18n fix",
+  "objective": "Remove mixed-language live progress from onboard and planner prepare-context flows.",
+  "description": "Fixes progress checks that still used hardcoded Spanish labels after planner progress wrappers were localized.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v41-prepare-context-progress-i18n-fix",
+    "branch_name": "feature/QUIVER-41-06-v41-prepare-context-progress-i18n-fix"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/messages/en.js",
+    "src/create-quiver/lib/i18n/messages/es.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/ai-prepare-context-planner.test.js",
+    "tests/commands/ai-review-plan.test.js",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/**"
+  ],
+  "expected_read_paths": [
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/ai-prepare-context-planner.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/ai-prepare-context-planner.test.js",
+    "tests/commands/ai-review-plan.test.js",
+    "specs/quiver-v41-cli-i18n-ai-lifecycle/**"
+  ],
+  "depends_on": [
+    "slice-03-ai-planner-approval-review"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Touches shared AI progress output after planner localization.",
+  "must": [
+    "Use catalog-backed progress checks for onboard and planner prepare-context.",
+    "Keep English defaults fully English.",
+    "Keep Spanish progress labels available through the catalog.",
+    "Preserve provider prompt and machine-output contracts."
+  ],
+  "not_included": [
+    "Changing provider adapters or prompt content.",
+    "Changing prepare-context write semantics."
+  ],
+  "acceptance": [
+    "Focused AI progress tests pass.",
+    "i18n catalog completeness passes.",
+    "Full test suite passes.",
+    "Whitespace validation passes."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-plan.test.js tests/commands/ai-prepare-context-planner.test.js tests/commands/ai-review-plan.test.js tests/lib/i18n-catalog.test.js",
+    "node --test tests/**/*.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use injected provider runners; do not require live provider credentials."
+  ],
+  "estimated_hours": 2,
+  "status": "completed",
+  "blocked_reason": "",
+  "completed_at": "2026-05-29T18:02:20Z"
+}

package/specs/quiver-v42-cli-i18n-generated-docs/EVIDENCE_REPORT.md

@@ -0,0 +1,64 @@
+# Evidence Report - Quiver v42 CLI i18n Generated Docs
+
+## slice-00-generated-docs-foundation
+
+- Created this spec package and slice handoffs.
+- Runtime implementation intentionally not started.
+
+## slice-01-template-language-routing
+
+- Added `src/create-quiver/lib/i18n/templates.js` as a pure routing layer for generated human templates.
+- Reused v37 language resolution precedence through `resolveLanguage`.
+- Defined localized template convention: base template is fallback `en`; non-default variants add the language before `.template`, for example `docs/INDEX.md.es.template`.
+- Explicitly excludes machine artifacts such as `package.template.json` and `slice.json` from human template routing.
+- Added coverage helpers so missing localized human templates can be reported while runtime fallback remains deterministic.
+- Documented the convention in `docs/CLI_UX_GUIDE.md`.
+
+Validation:
+
+- PASS `node --test tests/lib/i18n-templates.test.js`
+- PASS `git diff --check`
+
+## slice-02-init-docs-and-i18n-assets
+
+- Routed `init` generated human templates through the v42 template language resolver.
+- Added Spanish template variants for default init human docs and AGENTS onboarding guidance.
+- Kept machine artifacts such as `package.template.json`, package scripts, and `slice.json` outside localization routing.
+- Made `--lang` configure generated docs and persisted project language, while existing project config remains the default when `--lang` is absent.
+- Preserved overwrite behavior for existing docs and config keys.
+
+Validation:
+
+- PASS `node --test tests/commands/init-profiles.test.js tests/lib/init-docs.test.js tests/lib/i18n-templates.test.js`
+- PASS `node --test tests/commands/demo.test.js`
+
+## slice-03-docs-reference-guides
+
+- Documented generated human docs language behavior in `docs/reference/commands.md`.
+- Clarified in `docs/CLI_UX_GUIDE.md` that CLI output, generated human docs, and machine artifacts are separate surfaces.
+- Added getting-started guidance for using `--lang es init` and `config language set es`.
+- Explicitly documented that JSON, JSONL, package metadata, `slice.json`, commands, flags, routes, providers, and models are not localized.
+
+Validation:
+
+- PASS `git diff --check`
+- PASS `node bin/create-quiver.js spec validate specs/quiver-v42-cli-i18n-generated-docs --strict`
+
+## slice-04-generated-docs-tests-smokes
+
+- Full test suite passed: 608 tests, 0 failures.
+- `npm run package:quiver` passed and produced a package smoke result for `create-quiver-0.15.3.tgz`.
+- `npm run smoke:create-quiver` passed.
+- Manual temporary project smoke generated `en` and `es` projects with `--full --skip-install`.
+- Manual smoke confirmed `docs/INDEX.md` routes to English and Spanish human docs.
+- Manual smoke confirmed stable machine artifacts by comparing `package.json` and `specs/lang-demo/slices/slice-template/slice.json` across `en` and `es`.
+- Manual smoke confirmed `.quiver/config.json` stores the intended project language per project.
+
+Validation:
+
+- PASS `node --test tests/**/*.test.js`
+- PASS `npm run package:quiver`
+- PASS `npm run smoke:create-quiver`
+- PASS manual generated-doc language smoke for `--lang en` and `--lang es`
+- PASS `node bin/create-quiver.js spec validate specs/quiver-v42-cli-i18n-generated-docs --strict`
+- PASS `git diff --check`

package/specs/quiver-v42-cli-i18n-generated-docs/EXECUTION_PLAN.md

@@ -0,0 +1,26 @@
+# Execution Plan - Quiver v42 CLI i18n Generated Docs
+
+## Execution Rules
+
+- Start only after v37 foundation is complete.
+- Localize human documentation only.
+- Keep machine artifacts stable.
+- Do not duplicate large templates unless parameterization would be less clear or more fragile.
+
+## Suggested Order
+
+1. `slice-00-generated-docs-foundation`
+2. `slice-01-template-language-routing`
+3. `slice-02-init-docs-and-i18n-assets`
+4. `slice-03-docs-reference-guides`
+5. `slice-04-generated-docs-tests-smokes`
+
+## Final Validation
+
+```bash
+node --test tests/**/*.test.js
+git diff --check
+npx create-quiver spec validate specs/quiver-v42-cli-i18n-generated-docs --strict
+npm run package:quiver
+npm run smoke:create-quiver
+```

package/specs/quiver-v42-cli-i18n-generated-docs/SPEC.md

@@ -0,0 +1,52 @@
+# Quiver v42 - CLI i18n Generated Docs
+
+**Date:** 2026-05-28
+**Status:** Completed
+**Source:** Continuation of the approved CLI i18n program.
+
+## Problem
+
+CLI output localization is not enough if Quiver-generated project docs and templates remain locked to one language. Generated docs need explicit language routing without changing machine artifacts.
+
+## Objective
+
+Add Spanish and English support to generated human documentation and templates, using the configured project language by default.
+
+## Scope
+
+### Included
+
+- Generated docs from `init`, `spec create`, demos, and onboarding helpers where content is intended for humans.
+- Template language routing for `en` and `es`.
+- Docs/reference updates explaining language behavior.
+- Tests proving generated docs follow configured language while machine artifacts remain stable.
+
+### Excluded
+
+- Runtime CLI command output already covered by v37-v41.
+- Translating JSON, `slice.json`, package metadata, lockfiles, provider prompts, or code comments.
+
+## Acceptance Criteria
+
+1. Generated human docs can be emitted in `en` or `es`.
+2. Project config language is used by default.
+3. `--lang` can override generated human docs for supported commands.
+4. Machine artifacts remain stable and non-localized.
+5. Existing templates are not duplicated unnecessarily when shared fragments can be parameterized safely.
+6. Docs explain which artifacts are localized and which are intentionally stable.
+
+## Slice Roadmap
+
+| Slice | Title | Status | Dependencies |
+|---|---|---|---|
+| slice-00 | Generated docs foundation | completed | none |
+| slice-01 | Template language routing | completed | v37 complete |
+| slice-02 | Init docs and i18n assets | completed | slice-01 |
+| slice-03 | Docs reference and guides | completed | slice-01 |
+| slice-04 | Generated docs tests and smokes | completed | slice-02, slice-03 |
+
+## Guardrails
+
+- Do not translate schema-like generated files.
+- Keep template routing explicit and testable.
+- Avoid uncontrolled duplication of large templates.

package/specs/quiver-v42-cli-i18n-generated-docs/STATUS.md

@@ -0,0 +1,24 @@
+# Status - Quiver v42 CLI i18n Generated Docs
+
+**Overall status:** Completed
+**Created:** 2026-05-28
+**Completed:** 2026-05-29
+**Current slice:** none
+
+## Summary
+
+This spec localizes generated human documentation and templates after the v37 foundation is complete.
+
+## Slice Status
+
+| Slice | Status | Notes |
+|---|---|---|
+| slice-00-generated-docs-foundation | Completed | Spec package and handoffs created. |
+| slice-01-template-language-routing | Completed | Added pure generated-doc template language routing, fallback reporting, and naming convention. |
+| slice-02-init-docs-and-i18n-assets | Completed | Routed init-generated human docs through language selection and added Spanish template assets. |
+| slice-03-docs-reference-guides | Completed | Documented configured generated-doc language behavior, --lang overrides, and machine artifact exclusions. |
+| slice-04-generated-docs-tests-smokes | Completed | Full tests, package smoke, create-quiver smoke, spec validation, diff check, and manual en/es generated-doc smoke passed. |
+
+## Current Blockers
+
+- None.

package/specs/quiver-v42-cli-i18n-generated-docs/pr.md

@@ -0,0 +1,125 @@
+# PR - Quiver v42 CLI i18n Generated Docs
+
+## Title
+
+QUIVER-42 - CLI i18n generated docs
+
+## Summary
+
+Adds language routing for generated human documentation and templates so `init` can emit English or Spanish docs from the configured project language or an explicit `--lang` override.
+
+Keeps machine-readable artifacts stable and non-localized.
+
+## Scope
+
+- Adds generated-doc template language resolution with explicit fallback to the base English template.
+- Adds Spanish variants for `init` human docs and onboarding templates.
+- Routes `init` generated human docs through the resolved project language.
+- Documents generated-doc language behavior, `--lang` overrides, and machine artifact exclusions.
+- Closes v42 evidence with full tests, package smoke, create-quiver smoke, and manual `en/es` generated-doc smoke.
+
+Out of scope:
+
+- Runtime CLI output migration already covered by v37-v41.
+- Translating JSON, JSONL, package metadata, `slice.json`, commands, flags, routes, providers, or models.
+
+## Files
+
+- `src/create-quiver/lib/i18n/templates.js`
+- `src/create-quiver/lib/init-docs.js`
+- `src/create-quiver/index.js`
+- `tests/lib/i18n-templates.test.js`
+- `tests/commands/init-profiles.test.js`
+- `docs/CLI_UX_GUIDE.md`
+- `docs/reference/commands.md`
+- `docs/getting-started/installation.md`
+- `AGENTS.md.es.template`
+- `docs/*.es.template`
+- `docs/ai/LESSONS.md.es.template`
+- `specs/quiver-v42-cli-i18n-generated-docs/**`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js and npm available.
+- Repository dependencies installed with `npm ci`.
+- Run commands from the v42 worktree root.
+
+### Worktree Access
+
+```bash
+cd /Users/fabrijk/Documents/Work/Proyectos\ Personales/nika/frameworks/quiver-v42
+git status --short --branch
+```
+
+Expected: branch `feature/QUIVER-42-01-v42-template-language-routing` and a clean working tree.
+
+### Run the Project
+
+Package and smoke the CLI:
+
+```bash
+npm run package:quiver
+npm run smoke:create-quiver
+```
+
+Expected: both commands finish successfully.
+
+### Use Cases
+
+Generate English and Spanish temporary projects:
+
+```bash
+repo_root="$PWD"
+tmp="$(mktemp -d)"
+node "$repo_root/bin/create-quiver.js" --lang en init --name "Lang Demo" --dir "$tmp/en-project" --full --skip-install
+node "$repo_root/bin/create-quiver.js" --lang es init --name "Lang Demo" --dir "$tmp/es-project" --full --skip-install
+grep -F "# Lang Demo Documentation Index" "$tmp/en-project/docs/INDEX.md"
+grep -F "# Indice de documentacion de Lang Demo" "$tmp/es-project/docs/INDEX.md"
+cmp -s "$tmp/en-project/package.json" "$tmp/es-project/package.json"
+cmp -s "$tmp/en-project/specs/lang-demo/slices/slice-template/slice.json" "$tmp/es-project/specs/lang-demo/slices/slice-template/slice.json"
+```
+
+Expected:
+
+- English docs contain `# Lang Demo Documentation Index`.
+- Spanish docs contain `# Indice de documentacion de Lang Demo`.
+- `package.json` and `slice.json` are identical across languages.
+
+### Technical Verification
+
+```bash
+node --test tests/**/*.test.js
+node bin/create-quiver.js spec validate specs/quiver-v42-cli-i18n-generated-docs --strict
+node bin/create-quiver.js check-slice specs/quiver-v42-cli-i18n-generated-docs/slices/slice-04-generated-docs-tests-smokes/slice.json --local
+git diff --check
+```
+
+Expected:
+
+- Full test suite passes.
+- Spec validation passes.
+- Slice gate passes in local mode.
+- Diff check reports no whitespace errors.
+
+## Evidence
+
+- PASS `node --test tests/**/*.test.js` - 608 tests, 0 failures.
+- PASS `npm run package:quiver`.
+- PASS `npm run smoke:create-quiver`.
+- PASS manual generated-doc language smoke for `--lang en` and `--lang es`.
+- PASS `node bin/create-quiver.js spec validate specs/quiver-v42-cli-i18n-generated-docs --strict`.
+- PASS `git diff --check`.
+
+## Rollback
+
+Revert this PR. The rollback removes generated-doc template routing, Spanish generated-doc templates, related docs updates, and v42 spec evidence.
+
+No migrations or external state changes are required.
+
+## Risks / Notes
+
+- Template fallback is intentional: missing Spanish human templates fall back to the base English template.
+- Machine-readable artifacts are intentionally not localized.
+- `package.template.json`, `slice.json`, commands, flags, routes, providers, and models must stay stable for automation compatibility.

package/specs/quiver-v42-cli-i18n-generated-docs/slices/slice-00-generated-docs-foundation/CLOSURE_BRIEF.md

@@ -0,0 +1,10 @@
+# CLOSURE_BRIEF - slice-00 Generated docs foundation
+
+## Summary
+
+Documentation package created. No runtime implementation was performed.
+
+## Validation
+
+- Pending `npx create-quiver spec validate specs/quiver-v42-cli-i18n-generated-docs --strict`.
+- Pending `git diff --check`.

package/specs/quiver-v42-cli-i18n-generated-docs/slices/slice-00-generated-docs-foundation/EXECUTION_BRIEF.md

@@ -0,0 +1,21 @@
+# EXECUTION_BRIEF - slice-00 Generated docs foundation
+
+## Context
+
+Generated human docs need explicit i18n scope separate from runtime CLI output.
+
+## Objective
+
+Create the v42 generated-docs i18n spec package and handoffs.
+
+## Acceptance Criteria
+
+- v42 root documents exist.
+- Each planned slice has execution and closure briefs.
+- Runtime code remains untouched.
+
+## Completion Checklist
+
+- [x] Spec package created.
+- [x] Handoffs created.
+- [x] Runtime implementation deferred.

package/specs/quiver-v42-cli-i18n-generated-docs/slices/slice-00-generated-docs-foundation/slice.json

@@ -0,0 +1,53 @@
+{
+  "slice_id": "slice-00-generated-docs-foundation",
+  "ticket": "QUIVER-42-00",
+  "type": "documentation",
+  "title": "Generated docs foundation",
+  "objective": "Create the approved v42 generated docs i18n spec package and handoffs.",
+  "description": "Documents language routing for generated human documentation.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v42-generated-docs-foundation",
+    "branch_name": "feature/QUIVER-42-00-v42-generated-docs-foundation"
+  },
+  "files": [
+    "specs/quiver-v42-cli-i18n-generated-docs/**"
+  ],
+  "expected_read_paths": [
+    "docs/INDEX.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "specs/quiver-v37-cli-i18n-foundation/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "specs/quiver-v42-cli-i18n-generated-docs/**"
+  ],
+  "depends_on": [],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This creates the roadmap for v42.",
+  "must": [
+    "Create v42 package.",
+    "Document generated-doc localization scope.",
+    "Keep runtime code untouched."
+  ],
+  "not_included": [
+    "Runtime command migration."
+  ],
+  "acceptance": [
+    "Spec package exists.",
+    "Slice handoffs exist.",
+    "Runtime code is untouched."
+  ],
+  "tests": [
+    "npx create-quiver spec validate specs/quiver-v42-cli-i18n-generated-docs --strict",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Strict validation requires completed slices to appear in EVIDENCE_REPORT.md."
+  ],
+  "estimated_hours": 1,
+  "status": "completed",
+  "completed_at": "2026-05-28T00:00:00.000Z",
+  "blocked_reason": null
+}