create-quiver 0.15.3 → 0.15.4

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-00-read-only-foundation/EXECUTION_BRIEF.md

@@ -0,0 +1,21 @@
+# EXECUTION_BRIEF - slice-00 Read-only foundation
+
+## Context
+
+Read-only commands are the first broad command migration after the i18n foundation.
+
+## Objective
+
+Create the v38 spec package and handoffs.
+
+## Acceptance Criteria
+
+- v38 spec root documents exist.
+- All planned read-only migration slices have briefs and JSON metadata.
+- Runtime code is not modified.
+
+## Completion Checklist
+
+- [x] Spec package created.
+- [x] Handoffs created.
+- [x] Runtime implementation deferred.

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-00-read-only-foundation/slice.json

@@ -0,0 +1,53 @@
+{
+  "slice_id": "slice-00-read-only-foundation",
+  "ticket": "QUIVER-38-00",
+  "type": "documentation",
+  "title": "Read-only foundation",
+  "objective": "Create the approved v38 read-only command migration spec package and handoffs.",
+  "description": "Documents how read-only command output will be migrated to en and es.",
+  "git": {
+    "branch_type": "docs",
+    "base_branch": "main",
+    "branch_slug": "v38-read-only-foundation",
+    "branch_name": "docs/QUIVER-38-00-v38-read-only-foundation"
+  },
+  "files": [
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "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-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This creates the roadmap for v38.",
+  "must": [
+    "Create the v38 package.",
+    "Keep runtime code untouched.",
+    "Document dependency on v37."
+  ],
+  "not_included": [
+    "Runtime command migration."
+  ],
+  "acceptance": [
+    "Spec package exists.",
+    "Slice handoffs exist.",
+    "Runtime code is untouched."
+  ],
+  "tests": [
+    "npx create-quiver spec validate specs/quiver-v38-cli-i18n-read-only-commands --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
+}

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

@@ -0,0 +1,17 @@
+# CLOSURE_BRIEF - slice-01 Version, dashboard, and help
+
+## Summary
+
+Completed localization for the most visible read-only surfaces in this slice:
+
+- `version` human labels now use the configured CLI language while `version --json` remains stable.
+- `dashboard` compact, detailed, section, warning, and option-error human labels now use `en`/`es` catalog keys while `dashboard --json` remains stable.
+- Existing help localization from the v37 foundation remains covered by command contract tests.
+
+## Validation
+
+- [x] `node --test tests/commands/version.test.js tests/commands/dashboard.test.js tests/commands/cli-contract.test.js tests/lib/version.test.js tests/lib/dashboard.test.js tests/lib/i18n-catalog.test.js tests/lib/i18n-language.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-01-version-dashboard-help/slice.json --local` (warning expected: slice already completed)

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

@@ -0,0 +1,23 @@
+# EXECUTION_BRIEF - slice-01 Version, dashboard, and help
+
+## Context
+
+These commands are highly visible and define the first impression of localized Quiver output.
+
+## Objective
+
+Localize `version`, `--version`, `--help`, and `dashboard` human output.
+
+## Acceptance Criteria
+
+- `version` and `dashboard` render in `en` and `es`.
+- The Quiver banner uses approved Quiver tonalities where color is enabled.
+- `dashboard --json` and `version --json` remain stable.
+- Compact dashboard labels fit in Spanish and English without losing section readability.
+- Suggested commands remain exact.
+
+## Completion Checklist
+
+- [x] Human output catalog keys added.
+- [x] `en` and `es` command tests added.
+- [x] JSON regression tests preserved.

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.