create-quiver 0.15.2 → 0.15.4

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-01-version-dashboard-help/slice.json

@@ -0,0 +1,69 @@
+{
+  "slice_id": "slice-01-version-dashboard-help",
+  "ticket": "QUIVER-38-01",
+  "type": "feature",
+  "title": "Version, dashboard, and help",
+  "objective": "Localize the most visible read-only CLI surfaces in Spanish and English.",
+  "description": "Migrates version, help, and dashboard human output while preserving JSON contracts.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v38-version-dashboard-help",
+    "branch_name": "feature/QUIVER-38-01-v38-version-dashboard-help"
+  },
+  "files": [
+    "src/create-quiver/lib/version.js",
+    "src/create-quiver/commands/dashboard.js",
+    "src/create-quiver/lib/dashboard.js",
+    "tests/commands/version.test.js",
+    "tests/commands/dashboard.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/i18n/**",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/dashboard.js",
+    "src/create-quiver/lib/version.js",
+    "src/create-quiver/lib/dashboard.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/version.test.js",
+    "tests/commands/dashboard.test.js",
+    "tests/commands/cli-contract.test.js",
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [
+    "slice-00-read-only-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Establishes command migration patterns for the rest of v38.",
+  "must": [
+    "Localize human output for version, help, and dashboard.",
+    "Keep JSON output stable.",
+    "Preserve exact command snippets.",
+    "Maintain compact dashboard readability."
+  ],
+  "not_included": [
+    "Provider-backed AI commands.",
+    "Generated project docs."
+  ],
+  "acceptance": [
+    "Representative output snapshots pass in en and es.",
+    "JSON tests continue to pass.",
+    "Color/no-color behavior remains correct."
+  ],
+  "tests": [
+    "node --test tests/commands/version.test.js tests/commands/dashboard.test.js tests/commands/cli-contract.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use project config language tests, not only --lang tests.",
+    "Assert Spanish labels do not expand dashboard beyond readable layout assumptions."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "completed_at": "2026-05-29T00:00:00.000Z",
+  "blocked_reason": null
+}

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/CLOSURE_BRIEF.md

@@ -0,0 +1,13 @@
+# CLOSURE_BRIEF - slice-02 Flow, doctor, next, graph, and plan
+
+## Summary
+
+Implemented shared read-only i18n helpers and localized human output for `flow`, `doctor`, `next`, `graph`, and `plan` while preserving JSON contracts and exact command snippets.
+
+## Validation
+
+- [x] `node --test tests/commands/flow.test.js tests/commands/doctor.test.js tests/commands/next.test.js tests/commands/graph.test.js tests/commands/plan.test.js tests/lib/i18n-catalog.test.js`
+- [x] `node --test tests/**/*.test.js`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/slice.json --local`

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-02 Flow, doctor, next, graph, and plan
+
+## Context
+
+Workflow status commands guide the user's next action and must be clear in the configured language.
+
+## Objective
+
+Localize `flow`, `doctor`, `next`, `graph`, and `plan` human output.
+
+## Acceptance Criteria
+
+- All included commands render human output in `en` and `es`.
+- Actionable suggested commands remain exact.
+- Warning and blocker labels are localized without changing stable codes.
+- JSON outputs remain stable where supported.
+
+## Completion Checklist
+
+- [x] Command output migrated.
+- [x] Normal, empty, warning, and blocker states tested.
+- [x] JSON regression tests preserved.

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-02-flow-doctor-next-graph",
+  "ticket": "QUIVER-38-02",
+  "type": "feature",
+  "title": "Flow, doctor, next, graph, and plan",
+  "objective": "Localize workflow inspection commands without changing their machine-readable contracts.",
+  "description": "Migrates the read-only workflow guidance commands to the shared i18n catalog.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v38-flow-doctor-next-graph",
+    "branch_name": "feature/QUIVER-38-02-v38-flow-doctor-next-graph"
+  },
+  "files": [
+    "src/create-quiver/commands/flow.js",
+    "src/create-quiver/commands/next.js",
+    "src/create-quiver/commands/graph.js",
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/lib/renderers/tree.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/flow.test.js",
+    "tests/commands/doctor.test.js",
+    "tests/commands/next.test.js",
+    "tests/commands/graph.test.js",
+    "tests/commands/plan.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/flow.js",
+    "src/create-quiver/commands/next.js",
+    "src/create-quiver/commands/graph.js",
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/lib/renderers/tree.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/flow.test.js",
+    "tests/commands/doctor.test.js",
+    "tests/commands/next.test.js",
+    "tests/commands/graph.test.js",
+    "tests/commands/plan.test.js",
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [
+    "slice-01-version-dashboard-help"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can overlap with slice-03 if catalog keys are namespaced by command group.",
+  "must": [
+    "Localize workflow status labels and guidance.",
+    "Keep exact commands in suggestions.",
+    "Keep JSON stable.",
+    "Test warnings and blocker states."
+  ],
+  "not_included": [
+    "AI provider execution commands."
+  ],
+  "acceptance": [
+    "Each included command has en and es test coverage.",
+    "JSON contract tests remain stable.",
+    "No localized command snippet is altered."
+  ],
+  "tests": [
+    "node --test tests/commands/flow.test.js tests/commands/doctor.test.js tests/commands/next.test.js tests/commands/graph.test.js tests/commands/plan.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Include fixtures with no specs and with blocked slices."
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-03-ai-inspection-and-export/CLOSURE_BRIEF.md

@@ -0,0 +1,12 @@
+# CLOSURE_BRIEF - slice-03 AI inspection and export read-only commands
+
+## Summary
+
+Localized AI read-only inspection surfaces for `ai inspect`, `ai export --format markdown`, `ai specs list`, `ai slices list`, `ai trace report`, `ai status`, `ai resume`, and `ai approvals` while preserving JSON/export identifiers and exact next-command snippets.
+
+## Validation
+
+- [x] `node --test tests/commands/ai-export.test.js tests/commands/ai-run-state.test.js tests/lib/ai-export-state.test.js tests/lib/ai-run-state.test.js tests/lib/i18n-catalog.test.js`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-03-ai-inspection-and-export/slice.json --local`

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-03-ai-inspection-and-export/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-03 AI inspection and export read-only commands
+
+## Context
+
+AI inspection commands expose run/spec state without writing files. They should match the same language behavior as other read-only commands.
+
+## Objective
+
+Localize AI read-only commands such as `ai inspect`, `ai export`, `ai specs list`, `ai slices list`, `ai trace report`, and `ai approvals`.
+
+## Acceptance Criteria
+
+- Human output supports `en` and `es`.
+- JSON and export payloads remain stable and non-localized.
+- Run ids, spec ids, slice ids, providers, and models remain unchanged.
+- Missing/empty state messages are localized.
+
+## Completion Checklist
+
+- [x] AI read-only human strings cataloged.
+- [x] JSON/export tests preserved.
+- [x] Empty/missing-state tests added.

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-03-ai-inspection-and-export/slice.json

@@ -0,0 +1,66 @@
+{
+  "slice_id": "slice-03-ai-inspection-and-export",
+  "ticket": "QUIVER-38-03",
+  "type": "feature",
+  "title": "AI inspection and export read-only commands",
+  "objective": "Localize AI read-only inspection surfaces while preserving exports and JSON contracts.",
+  "description": "Covers AI status/introspection outputs that do not execute providers or write product files.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v38-ai-inspection-export",
+    "branch_name": "feature/QUIVER-38-03-v38-ai-inspection-export"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/ai/export-state.js",
+    "src/create-quiver/lib/ai/run-state.js",
+    "tests/commands/ai-export.test.js",
+    "tests/commands/ai-run-state.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/ai/export-state.js",
+    "src/create-quiver/lib/ai/run-state.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/ai-export.test.js",
+    "tests/commands/ai-run-state.test.js",
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [
+    "slice-01-version-dashboard-help"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can overlap with slice-02 if AI catalog keys are isolated.",
+  "must": [
+    "Localize human AI inspection output.",
+    "Keep JSON and export payloads stable.",
+    "Preserve ids, providers, and model identifiers."
+  ],
+  "not_included": [
+    "Provider-backed AI planning/execution commands."
+  ],
+  "acceptance": [
+    "AI read-only commands render in en and es.",
+    "Export and JSON tests remain stable.",
+    "Empty states are localized."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-export.test.js tests/commands/ai-run-state.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Avoid changing export file contents unless they are explicitly human-facing docs."
+  ],
+  "estimated_hours": 7,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-04-read-only-tests-smokes/CLOSURE_BRIEF.md

@@ -0,0 +1,13 @@
+# CLOSURE_BRIEF - slice-04 Read-only tests and smokes
+
+## Summary
+
+Completed closing validation for the v38 read-only i18n migration. Full tests, package smoke, create-quiver smoke, spec validation, slice validation, and whitespace checks passed.
+
+## Validation
+
+- [x] `node --test tests/**/*.test.js`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- [x] `npm run package:quiver`
+- [x] `npm run smoke:create-quiver`
+- [x] `git diff --check`

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-04-read-only-tests-smokes/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-04 Read-only tests and smokes
+
+## Context
+
+Read-only command migration touches many user-facing outputs and can regress automation if JSON modes are polluted.
+
+## Objective
+
+Run full validation and update evidence for the v38 read-only command migration.
+
+## Acceptance Criteria
+
+- Full test suite passes.
+- Package smoke passes.
+- Spec validation passes.
+- Evidence report documents commands covered and remaining exclusions.
+
+## Completion Checklist
+
+- [x] Full tests run.
+- [x] Package smoke run.
+- [x] Evidence updated.

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-04-read-only-tests-smokes/slice.json

@@ -0,0 +1,61 @@
+{
+  "slice_id": "slice-04-read-only-tests-smokes",
+  "ticket": "QUIVER-38-04",
+  "type": "validation",
+  "title": "Read-only tests and smokes",
+  "objective": "Validate the full read-only command migration and record evidence.",
+  "description": "Runs full tests and package smokes for v38.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v38-read-only-tests-smokes",
+    "branch_name": "feature/QUIVER-38-04-v38-read-only-tests-smokes"
+  },
+  "files": [
+    "tests/**/*.test.js",
+    "specs/quiver-v38-cli-i18n-read-only-commands/EVIDENCE_REPORT.md"
+  ],
+  "expected_read_paths": [
+    "specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "tests/**",
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [
+    "slice-02-flow-doctor-next-graph",
+    "slice-03-ai-inspection-and-export"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This is the closing validation slice for v38.",
+  "must": [
+    "Run full validation.",
+    "Record evidence.",
+    "Confirm downstream exclusions remain documented."
+  ],
+  "not_included": [
+    "Migrating write or provider-backed commands."
+  ],
+  "acceptance": [
+    "Full tests pass.",
+    "Package smoke passes.",
+    "Spec validation passes.",
+    "Evidence report is updated."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict",
+    "npm run package:quiver",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Audit that no read-only command still emits hardcoded English in human mode."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v39-cli-i18n-setup-onboarding/EVIDENCE_REPORT.md

@@ -0,0 +1,71 @@
+# Evidence Report - Quiver v39 CLI i18n Setup and Onboarding
+
+## slice-00-setup-foundation
+
+- Created this spec package and slice handoffs.
+- Runtime implementation intentionally not started.
+
+## slice-01-init-interactive-language
+
+- Added `init --interactive` project language selection for `en` and `es`.
+- Persisted the selected language to `.quiver/config.json` through the existing config writer, preserving existing keys.
+- Kept non-interactive init prompt-free and did not persist `--lang` as project config.
+- Added dry-run plan output for the intended language config write without writing files.
+- Localized interactive init prompts, summaries, confirmations, install completion, and next-step labels through the shared catalog.
+- Updated public command reference for the interactive init language choice.
+
+Validation:
+
+- Passed: `node --test tests/commands/init-profiles.test.js tests/commands/config-language.test.js tests/lib/init-layout.test.js tests/lib/i18n-catalog.test.js`
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- Passed with expected completed-slice warning: `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-01-init-interactive-language/slice.json --local`
+
+## slice-02-analyze-migrate-prepare
+
+- Localized `analyze` dry-run and completion output through the shared `en`/`es` catalog.
+- Localized `migrate` dry-run and completion output while preserving exact commands and paths.
+- Localized deterministic and planner dry-run wrapper output for `ai prepare-context` while keeping generated prompt/content contracts untouched.
+- Added Spanish regression coverage for `analyze --dry-run`, `migrate --dry-run`, `ai prepare-context --dry-run`, and `ai prepare-context --with-planner --dry-run`.
+
+Validation:
+
+- Passed: `node --test tests/commands/analyze.test.js tests/commands/init-profiles.test.js tests/commands/ai-onboard.test.js tests/lib/i18n-catalog.test.js`
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- Passed with expected completed-slice warning: `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-02-analyze-migrate-prepare/slice.json --local`
+
+## slice-03-demo-evidence-onboarding
+
+- Localized `demo create spec-viewer` human output through the shared `en`/`es` catalog.
+- Localized `evidence run` command summary output while keeping command strings and output paths exact.
+- Localized `ai onboard` dry-run and prompt-only wrapper output while keeping prompt delimiters and generated prompt contents unchanged.
+- Added regression coverage for `--lang es` and project-configured Spanish defaults.
+
+Validation:
+
+- Passed: `node --test tests/commands/demo.test.js tests/commands/evidence.test.js tests/commands/ai-onboard.test.js tests/lib/i18n-catalog.test.js`
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- Passed with expected completed-slice warning: `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-03-demo-evidence-onboarding/slice.json --local`
+
+## slice-04-setup-tests-smokes
+
+- Closed v39 with full regression coverage across CLI commands and library helpers.
+- Confirmed package creation and create-quiver smoke still pass after i18n setup changes.
+- Confirmed a project with `.quiver/config.json` set to Spanish renders setup output in Spanish without passing `--lang`.
+- Revalidated the full v39 spec package and diff hygiene.
+
+Validation:
+
+- Passed: `node --test tests/**/*.test.js` (574 passing)
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- Passed with expected completed-slice warning: `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-04-setup-tests-smokes/slice.json --local`
+- Passed: `npm run package:quiver` (`create-quiver-0.15.3.tgz`)
+- Passed: `npm run smoke:create-quiver`
+- Passed: configured-language smoke with `.quiver/config.json` language `es` and `demo create spec-viewer --dry-run` without `--lang`
+- Passed: `git diff --check`
+
+## Pending Evidence
+
+- None.

package/specs/quiver-v39-cli-i18n-setup-onboarding/EXECUTION_PLAN.md

@@ -0,0 +1,25 @@
+# Execution Plan - Quiver v39 CLI i18n Setup and Onboarding
+
+## Execution Rules
+
+- Start only after v37 foundation is complete.
+- Preserve no-TTY and CI safety.
+- Do not mix generated docs localization into this spec.
+
+## Suggested Order
+
+1. `slice-00-setup-foundation`
+2. `slice-01-init-interactive-language`
+3. `slice-02-analyze-migrate-prepare`
+4. `slice-03-demo-evidence-onboarding`
+5. `slice-04-setup-tests-smokes`
+
+## Final Validation
+
+```bash
+node --test tests/**/*.test.js
+git diff --check
+npx create-quiver spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict
+npm run package:quiver
+npm run smoke:create-quiver
+```

package/specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md

@@ -0,0 +1,53 @@
+# Quiver v39 - CLI i18n Setup and Onboarding
+
+**Date:** 2026-05-28
+**Status:** Completed
+**Source:** Continuation of the approved CLI i18n program.
+
+## Problem
+
+Setup commands define how a project starts using Quiver. Language selection must be easy during init and then persist automatically.
+
+## Objective
+
+Localize setup and onboarding commands while making `init --interactive` the primary place to choose project language.
+
+## Scope
+
+### Included
+
+- `init`, especially `init --interactive`.
+- `migrate`, `analyze`, and `ai prepare-context`.
+- Demo/evidence onboarding outputs when they are human-facing CLI messages.
+- Human output, `--dry-run`, no-TTY/CI, `--no-color`, and supported `--json` behavior.
+
+### Excluded
+
+- Full generated documentation localization; v42 owns that.
+- Provider-backed planning/execution; v41 owns that.
+
+## Acceptance Criteria
+
+1. `init --interactive` asks for language when language is not already configured.
+2. The selected language is stored in `.quiver/config.json`.
+3. Subsequent commands use the configured language without `--lang`.
+4. `init`, `migrate`, `analyze`, and `ai prepare-context` human outputs support `en` and `es`.
+5. Dry-run output remains localized but does not write files.
+6. JSON output remains schema-stable and non-localized.
+7. Non-interactive setup never blocks waiting for language input.
+
+## Slice Roadmap
+
+| Slice | Title | Status | Dependencies |
+|---|---|---|---|
+| slice-00 | Setup foundation | completed | none |
+| slice-01 | Init interactive language | completed | v37 complete |
+| slice-02 | Analyze, migrate, and prepare-context | completed | slice-01 |
+| slice-03 | Demo, evidence, and onboarding messages | completed | slice-01 |
+| slice-04 | Setup tests and smokes | completed | slice-02, slice-03 |
+
+## Guardrails
+
+- Do not prompt in CI/no-TTY unless `--interactive` is explicitly valid and a TTY exists.
+- Do not overwrite existing config keys when storing language.
+- Keep generated docs routing separate from command output.

package/specs/quiver-v39-cli-i18n-setup-onboarding/STATUS.md

@@ -0,0 +1,24 @@
+# Status - Quiver v39 CLI i18n Setup and Onboarding
+
+**Overall status:** Completed
+**Created:** 2026-05-28
+**Completed:** 2026-05-29
+**Current slice:** None
+
+## Summary
+
+This spec localizes setup and onboarding command output after the v37 i18n foundation is complete.
+
+## Slice Status
+
+| Slice | Status | Notes |
+|---|---|---|
+| slice-00-setup-foundation | Completed | Spec package and handoffs created. |
+| slice-01-init-interactive-language | Completed | `init --interactive` can select and persist project language while preserving config keys; dry-run remains write-free. |
+| slice-02-analyze-migrate-prepare | Completed | `analyze`, `migrate`, and `ai prepare-context` setup-adjacent human output localized in `en` and `es`; paths and command snippets preserved. |
+| slice-03-demo-evidence-onboarding | Completed | `demo`, `evidence`, and `ai onboard` setup-facing human output localized in `en` and `es`; paths, commands, and generated prompt contents preserved. |
+| slice-04-setup-tests-smokes | Completed | Full suite, package smoke, create-quiver smoke, spec validation, diff check, and configured-language smoke passed. |
+
+## Current Blockers
+
+- None.

package/specs/quiver-v39-cli-i18n-setup-onboarding/pr.md

@@ -0,0 +1,104 @@
+# PR - Quiver v39 CLI i18n Setup and Onboarding
+
+## Title
+
+feat: complete v39 setup and onboarding i18n
+
+## Summary
+
+- Adds interactive init language selection for `en` and `es`, persisted in `.quiver/config.json`.
+- Localizes setup and onboarding human output for `init`, `analyze`, `migrate`, `ai prepare-context`, `demo`, `evidence`, and `ai onboard`.
+- Keeps JSON output, command snippets, paths, prompt delimiters, and generated prompt/doc contents stable.
+
+## Scope
+
+- Included: setup-facing human CLI messages, dry-run flows, configured project language resolution, and regression coverage.
+- Excluded: full generated documentation localization and provider-backed planning/execution localization beyond setup wrappers.
+
+## Files
+
+- `src/create-quiver/index.js`
+- `src/create-quiver/commands/ai.js`
+- `src/create-quiver/commands/analyze.js`
+- `src/create-quiver/commands/demo.js`
+- `src/create-quiver/commands/evidence.js`
+- `src/create-quiver/commands/migrate.js`
+- `src/create-quiver/lib/demo.js`
+- `src/create-quiver/lib/i18n/**`
+- `src/create-quiver/lib/init-layout.js`
+- `tests/commands/**`
+- `tests/lib/**`
+- `docs/reference/commands.md`
+- `specs/quiver-v39-cli-i18n-setup-onboarding/**`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node and npm available.
+- Local checkout on this branch.
+- No provider credentials required for dry-run and smoke coverage.
+
+### Worktree Access
+
+```bash
+git checkout feature/QUIVER-39-01-v39-init-interactive-language
+```
+
+### Run the Project
+
+```bash
+npm run package:quiver
+npm run smoke:create-quiver
+```
+
+### Use Cases
+
+```bash
+node bin/create-quiver.js --lang es init --name demo --dry-run
+node bin/create-quiver.js --lang es analyze --dry-run
+node bin/create-quiver.js --lang es migrate --dry-run
+node bin/create-quiver.js --lang es ai prepare-context --dry-run
+node bin/create-quiver.js --lang es demo create spec-viewer --dry-run
+node bin/create-quiver.js --lang es evidence run --output evidence.md -- node -e "console.log('ok')"
+node bin/create-quiver.js --lang es ai onboard --provider claude --role planner --context full --dry-run
+```
+
+Configured-language smoke without repeated `--lang`:
+
+```bash
+TMPDIR_QU="$(mktemp -d)"
+QUIVER_REPO="$(pwd)"
+mkdir -p "$TMPDIR_QU/.quiver"
+printf '{\n  "language": "es"\n}\n' > "$TMPDIR_QU/.quiver/config.json"
+(cd "$TMPDIR_QU" && node "$QUIVER_REPO/bin/create-quiver.js" demo create spec-viewer --dry-run)
+rm -rf "$TMPDIR_QU"
+```
+
+### Technical Verification
+
+```bash
+node --test tests/**/*.test.js
+node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict
+node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-04-setup-tests-smokes/slice.json --local
+git diff --check
+```
+
+## Evidence
+
+- `node --test tests/**/*.test.js`: 574 passing.
+- `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`: passed.
+- `npm run package:quiver`: passed, produced `create-quiver-0.15.3.tgz`.
+- `npm run smoke:create-quiver`: passed.
+- Configured-language smoke with `.quiver/config.json` language `es`: passed.
+- `git diff --check`: passed.
+
+## Rollback
+
+- Revert this spec branch commits for v39.
+- Existing English behavior remains the default fallback if `.quiver/config.json`, `QUIVER_LANG`, and `--lang` are absent.
+
+## Risks / Notes
+
+- Generated documentation templates remain intentionally mostly English; v42 owns full template localization.
+- Provider-backed live output localization is out of this spec except setup wrapper text.