create-quiver 0.15.3 → 0.16.0

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-01-init-interactive-language/EXECUTION_BRIEF.md

@@ -0,0 +1,23 @@
+# EXECUTION_BRIEF - slice-01 Init interactive language
+
+## Context
+
+The best UX is choosing language once during setup and reusing it automatically.
+
+## Objective
+
+Add language selection to `init --interactive` and persist it to project config.
+
+## Acceptance Criteria
+
+- `init --interactive` prompts for `en` or `es` when no language is configured.
+- Existing project language is shown and can be kept or changed.
+- Selection writes `.quiver/config.json` without removing existing keys.
+- Non-interactive init accepts existing config and never prompts.
+- Dry-run shows intended language write without writing.
+
+## Completion Checklist
+
+- [x] Interactive selector added.
+- [x] Config persistence tested.
+- [x] Dry-run and no-TTY behavior tested.

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-01-init-interactive-language/slice.json

@@ -0,0 +1,68 @@
+{
+  "slice_id": "slice-01-init-interactive-language",
+  "ticket": "QUIVER-39-01",
+  "type": "feature",
+  "title": "Init interactive language",
+  "objective": "Let users choose Spanish or English during interactive init and persist the project language.",
+  "description": "Adds the primary language onboarding path.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v39-init-interactive-language",
+    "branch_name": "feature/QUIVER-39-01-v39-init-interactive-language"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-layout.js",
+    "tests/commands/init-profiles.test.js",
+    "tests/lib/init-layout.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-layout.js",
+    "src/create-quiver/lib/i18n/**",
+    "docs/reference/commands.md",
+    "specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/init-layout.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/init-profiles.test.js",
+    "tests/commands/config-language.test.js",
+    "tests/lib/init-layout.test.js",
+    "docs/reference/commands.md",
+    "specs/quiver-v39-cli-i18n-setup-onboarding/**"
+  ],
+  "depends_on": [
+    "slice-00-setup-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Defines setup behavior consumed by the rest of v39.",
+  "must": [
+    "Prompt for language only in valid interactive TTY mode.",
+    "Persist selected language to .quiver/config.json.",
+    "Preserve existing config keys.",
+    "Keep dry-run write-free."
+  ],
+  "not_included": [
+    "Generated docs localization."
+  ],
+  "acceptance": [
+    "Interactive init can configure es or en.",
+    "Subsequent commands resolve project language without --lang.",
+    "No-TTY init does not block.",
+    "Dry-run does not write config."
+  ],
+  "tests": [
+    "node --test tests/commands/init-profiles.test.js tests/commands/config-language.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use selector test utilities rather than manual TTY assumptions."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-02-analyze-migrate-prepare/CLOSURE_BRIEF.md

@@ -0,0 +1,12 @@
+# CLOSURE_BRIEF - slice-02 Analyze, migrate, and prepare-context
+
+## Summary
+
+Localized setup-adjacent human output for `analyze`, `migrate`, and `ai prepare-context` while preserving paths, command snippets, write-free dry-runs, and generated prompt/content contracts.
+
+## Validation
+
+- [x] `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`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-02-analyze-migrate-prepare/slice.json --local`

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-02-analyze-migrate-prepare/EXECUTION_BRIEF.md

@@ -0,0 +1,23 @@
+# EXECUTION_BRIEF - slice-02 Analyze, migrate, and prepare-context
+
+## Context
+
+Setup-adjacent commands explain what Quiver detected or will write, so localization must preserve actionability.
+
+## Objective
+
+Localize `analyze`, `migrate`, and `ai prepare-context` human output.
+
+## Acceptance Criteria
+
+- Commands render in `en` and `es`.
+- `--dry-run` outputs are localized and write-free.
+- `--json` output remains stable where supported.
+- File paths and suggested commands remain exact.
+- Planner prompt content is not silently translated unless it is a human-facing CLI wrapper message.
+
+## Completion Checklist
+
+- [x] Human strings cataloged.
+- [x] Dry-run tests added.
+- [x] JSON regression tests preserved.

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-02-analyze-migrate-prepare/slice.json

@@ -0,0 +1,62 @@
+{
+  "slice_id": "slice-02-analyze-migrate-prepare",
+  "ticket": "QUIVER-39-02",
+  "type": "feature",
+  "title": "Analyze, migrate, and prepare-context",
+  "objective": "Localize setup-adjacent commands while preserving dry-run and automation behavior.",
+  "description": "Migrates analyze, migrate, and ai prepare-context human output to the shared i18n catalog.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v39-analyze-migrate-prepare",
+    "branch_name": "feature/QUIVER-39-02-v39-analyze-migrate-prepare"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/analyze.test.js",
+    "tests/commands/init-profiles.test.js",
+    "tests/commands/ai-onboard.test.js",
+    "specs/quiver-v39-cli-i18n-setup-onboarding/**"
+  ],
+  "depends_on": [
+    "slice-01-init-interactive-language"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can overlap with slice-03 if AI command ownership is coordinated.",
+  "must": [
+    "Localize human setup-adjacent output.",
+    "Keep dry-run write-free.",
+    "Keep JSON stable.",
+    "Do not translate file paths or command snippets."
+  ],
+  "not_included": [
+    "Provider-backed planning output."
+  ],
+  "acceptance": [
+    "Commands render in en and es.",
+    "Dry-run tests prove no writes.",
+    "JSON tests remain stable."
+  ],
+  "tests": [
+    "node --test tests/commands/analyze.test.js tests/commands/init-profiles.test.js tests/commands/ai-onboard.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Separate CLI wrapper localization from generated prompt contents."
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-03-demo-evidence-onboarding/CLOSURE_BRIEF.md

@@ -0,0 +1,12 @@
+# CLOSURE_BRIEF - slice-03 Demo, evidence, and onboarding messages
+
+## Summary
+
+Localized `demo`, `evidence`, and `ai onboard` setup-facing human output through the shared catalog. Command snippets, paths, prompt delimiters, and generated prompt contents remain exact and untranslated.
+
+## Validation
+
+- [x] `node --test tests/commands/demo.test.js tests/commands/evidence.test.js tests/commands/ai-onboard.test.js tests/lib/i18n-catalog.test.js`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-03-demo-evidence-onboarding/slice.json --local`

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-03-demo-evidence-onboarding/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-03 Demo, evidence, and onboarding messages
+
+## Context
+
+Remaining onboarding surfaces should not leave users with mixed-language setup feedback.
+
+## Objective
+
+Localize demo, evidence, and onboarding helper outputs that are human-facing CLI messages.
+
+## Acceptance Criteria
+
+- Human-facing demo/onboarding messages render in `en` and `es`.
+- Generated artifact contents are changed only when they are explicitly command output templates.
+- Suggested commands remain exact.
+- Tests cover both configured language and `--lang` override.
+
+## Completion Checklist
+
+- [x] Human-facing onboarding strings cataloged.
+- [x] Tests added or updated.
+- [x] Generated artifacts left for v42 unless explicitly in scope.

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-03-demo-evidence-onboarding/slice.json

@@ -0,0 +1,72 @@
+{
+  "slice_id": "slice-03-demo-evidence-onboarding",
+  "ticket": "QUIVER-39-03",
+  "type": "feature",
+  "title": "Demo, evidence, and onboarding messages",
+  "objective": "Localize remaining setup-facing human CLI messages without changing generated docs scope.",
+  "description": "Covers demo/evidence/onboarding outputs that users see during setup flows.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v39-demo-evidence-onboarding",
+    "branch_name": "feature/QUIVER-39-03-v39-demo-evidence-onboarding"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/commands/evidence.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/demo.js",
+    "tests/commands/demo.test.js",
+    "tests/commands/evidence.test.js",
+    "tests/commands/ai-onboard.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/commands/evidence.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/i18n/**"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/commands/demo.js",
+    "src/create-quiver/commands/evidence.js",
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/demo.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/demo.test.js",
+    "tests/commands/evidence.test.js",
+    "tests/commands/ai-onboard.test.js",
+    "specs/quiver-v39-cli-i18n-setup-onboarding/**"
+  ],
+  "depends_on": [
+    "slice-01-init-interactive-language"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can overlap with slice-02 only if command file ownership is split.",
+  "must": [
+    "Localize human-facing onboarding messages.",
+    "Avoid changing generated documentation templates.",
+    "Keep command snippets exact."
+  ],
+  "not_included": [
+    "Template localization owned by v42."
+  ],
+  "acceptance": [
+    "Onboarding messages render in en and es.",
+    "Tests cover project config and --lang override.",
+    "Generated docs are not accidentally translated."
+  ],
+  "tests": [
+    "node --test tests/commands/demo.test.js tests/commands/ai-onboard.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Audit fixtures that assert literal English output."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-04-setup-tests-smokes/CLOSURE_BRIEF.md

@@ -0,0 +1,15 @@
+# CLOSURE_BRIEF - slice-04 Setup tests and smokes
+
+## Summary
+
+Closed v39 with full test, package, smoke, spec validation, diff hygiene, and configured-language evidence. The configured-language smoke proves setup output uses `.quiver/config.json` without requiring repeated `--lang` flags.
+
+## Validation
+
+- [x] `node --test tests/**/*.test.js`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v39-cli-i18n-setup-onboarding --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-04-setup-tests-smokes/slice.json --local`
+- [x] `npm run package:quiver`
+- [x] `npm run smoke:create-quiver`
+- [x] configured-language smoke with `.quiver/config.json` language `es`
+- [x] `git diff --check`

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-04-setup-tests-smokes/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-04 Setup tests and smokes
+
+## Context
+
+Setup localization must be validated in interactive, dry-run, no-TTY, and configured-language flows.
+
+## Objective
+
+Close v39 with full tests, package smoke, and evidence.
+
+## Acceptance Criteria
+
+- Full test suite passes.
+- Setup smoke covers a configured Spanish or English project without repeated flags.
+- Spec validation passes.
+- Evidence report is updated.
+
+## Completion Checklist
+
+- [x] Full tests run.
+- [x] Smoke commands run.
+- [x] Evidence updated.

package/specs/quiver-v39-cli-i18n-setup-onboarding/slices/slice-04-setup-tests-smokes/slice.json

@@ -0,0 +1,61 @@
+{
+  "slice_id": "slice-04-setup-tests-smokes",
+  "ticket": "QUIVER-39-04",
+  "type": "validation",
+  "title": "Setup tests and smokes",
+  "objective": "Validate setup/onboarding localization and record release evidence.",
+  "description": "Runs full tests and smokes after v39 command migration.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v39-setup-tests-smokes",
+    "branch_name": "feature/QUIVER-39-04-v39-setup-tests-smokes"
+  },
+  "files": [
+    "tests/**/*.test.js",
+    "specs/quiver-v39-cli-i18n-setup-onboarding/EVIDENCE_REPORT.md"
+  ],
+  "expected_read_paths": [
+    "specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "tests/**",
+    "specs/quiver-v39-cli-i18n-setup-onboarding/**"
+  ],
+  "depends_on": [
+    "slice-02-analyze-migrate-prepare",
+    "slice-03-demo-evidence-onboarding"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This is the closing validation slice for v39.",
+  "must": [
+    "Run full validation.",
+    "Confirm configured language works without flags.",
+    "Record evidence."
+  ],
+  "not_included": [
+    "Generated docs localization."
+  ],
+  "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-v39-cli-i18n-setup-onboarding --strict",
+    "npm run package:quiver",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Run at least one smoke in a temp project with .quiver/config.json language set."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "completed_at": "2026-05-29T00:00:00.000Z"
+}

package/specs/quiver-v40-cli-i18n-spec-slice-workflows/EVIDENCE_REPORT.md

@@ -0,0 +1,50 @@
+# Evidence Report - Quiver v40 CLI i18n Spec and Slice Workflows
+
+## slice-00-spec-slice-foundation
+
+- Created this spec package and slice handoffs.
+- Runtime implementation intentionally not started.
+
+## slice-01-spec-create-start-status
+
+- Localized `spec create`, `spec start`, and `spec status` human output through the shared `en`/`es` catalog.
+- Preserved generated spec artifacts, slice ids, statuses, paths, branch names, and suggested commands.
+- Validation:
+  - `node --test tests/commands/spec-create.test.js tests/commands/spec-worktree.test.js tests/lib/i18n-catalog.test.js` - passed.
+  - `git diff --check` - passed.
+  - `node bin/create-quiver.js spec validate specs/quiver-v40-cli-i18n-spec-slice-workflows --strict` - passed.
+  - `node bin/create-quiver.js check-slice specs/quiver-v40-cli-i18n-spec-slice-workflows/slices/slice-01-spec-create-start-status/slice.json --local` - passed.
+
+## slice-02-spec-validate-close
+
+- Localized `spec validate` report headings/results and `spec close` dry-run/completion output through the shared `en`/`es` catalog.
+- Preserved validation rule text, file paths, slice ids, branch names, commands, and strict-mode behavior.
+- Validation:
+  - `node --test tests/commands/spec-validate.test.js tests/commands/spec-close.test.js tests/lib/i18n-catalog.test.js` - passed.
+  - `git diff --check` - passed.
+
+## slice-03-slice-lifecycle-handoffs
+
+- Localized `start-slice`, readiness gates, `check-pr` wrappers, handoff validation errors, `check-scope` wrappers, and `ai execute-slice --dry-run` output through the shared `en`/`es` catalog.
+- Kept `ai prompt-slice` payload output unchanged to preserve the exact executor prompt contract.
+- Preserved accepted handoff heading aliases, paths, slice ids, branch names, and command snippets.
+- Validation:
+  - `node --test tests/commands/ai-execute-slice.test.js tests/lib/check-slice.test.js tests/lib/handoff.test.js tests/lib/lifecycle.test.js tests/lib/scope.test.js tests/lib/i18n-catalog.test.js` - passed.
+  - `git diff --check` - passed.
+
+## slice-04-spec-slice-tests-smokes
+
+- Adjusted package, cross-platform, and tiered-pack smokes to set `QUIVER_LANG=es` explicitly for Spanish workflow wrapper assertions.
+- Confirmed generated spec artifacts, command snippets, ids, paths, and JSON contracts remain stable.
+- Validation:
+  - `node --test tests/**/*.test.js` - passed, 587 tests.
+  - `node bin/create-quiver.js spec validate specs/quiver-v40-cli-i18n-spec-slice-workflows --strict` - passed.
+  - `npm run package:quiver` - passed, package smoke produced `create-quiver-0.15.3.tgz`.
+  - `npm run smoke:create-quiver` - passed.
+  - `node scripts/ci/smoke-cross-platform.js` - passed.
+  - `bash scripts/ci/smoke-tiered-pack.sh` - passed.
+  - `git diff --check` - passed.
+
+## Pending Evidence
+
+- None.

package/specs/quiver-v40-cli-i18n-spec-slice-workflows/EXECUTION_PLAN.md

@@ -0,0 +1,25 @@
+# Execution Plan - Quiver v40 CLI i18n Spec and Slice Workflows
+
+## Execution Rules
+
+- Start only after v37 foundation is complete.
+- Keep structured spec and slice artifacts stable.
+- Do not translate generated docs/templates in this spec.
+
+## Suggested Order
+
+1. `slice-00-spec-slice-foundation`
+2. `slice-01-spec-create-start-status`
+3. `slice-02-spec-validate-close`
+4. `slice-03-slice-lifecycle-handoffs`
+5. `slice-04-spec-slice-tests-smokes`
+
+## Final Validation
+
+```bash
+node --test tests/**/*.test.js
+git diff --check
+npx create-quiver spec validate specs/quiver-v40-cli-i18n-spec-slice-workflows --strict
+npm run package:quiver
+npm run smoke:create-quiver
+```

package/specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md

@@ -0,0 +1,52 @@
+# Quiver v40 - CLI i18n Spec and Slice Workflows
+
+**Date:** 2026-05-28
+**Status:** Completed
+**Source:** Continuation of the approved CLI i18n program.
+
+## Problem
+
+Spec and slice workflow commands are central to WDD + SDD. Their guidance must be localized without changing structured artifacts or automation contracts.
+
+## Objective
+
+Localize spec/slice workflow command output in `en` and `es` while preserving generated spec metadata and JSON contracts.
+
+## Scope
+
+### Included
+
+- `spec create`, `spec validate`, `spec start`, `spec close`.
+- `start-slice`, `check-slice`, `check-pr`, `ai prompt-slice`.
+- Handoff validation messages and workflow gate output.
+- Human output, dry-run, review/interactive wrapper messages, no-TTY/CI, and `--json` where supported.
+
+### Excluded
+
+- Translating generated spec content or templates; v42 owns generated docs/templates.
+- Provider-backed AI lifecycle output; v41 owns that.
+
+## Acceptance Criteria
+
+1. Included workflow commands render human output in `en` and `es`.
+2. Generated `slice.json` fields, status values, git metadata, and schema-like content remain stable.
+3. Handoff validation errors are localized but required heading aliases stay documented.
+4. Suggested commands remain exact and copy-pasteable.
+5. `spec validate --strict` remains deterministic across languages.
+6. Tests cover success, warning, validation failure, dry-run, and no-TTY/CI paths.
+
+## Slice Roadmap
+
+| Slice | Title | Status | Dependencies |
+|---|---|---|---|
+| slice-00 | Spec/slice foundation | completed | none |
+| slice-01 | Spec create, start, and status surfaces | completed | v37 complete |
+| slice-02 | Spec validate and close | completed | slice-01 |
+| slice-03 | Slice lifecycle and handoffs | completed | slice-01 |
+| slice-04 | Spec/slice tests and smokes | completed | slice-02, slice-03 |
+
+## Guardrails
+
+- Do not translate JSON keys, statuses, branch names, file paths, or spec/slice ids.
+- Do not localize generated spec files unless v42 explicitly owns the generated template.
+- Preserve parser and strict validation behavior.

package/specs/quiver-v40-cli-i18n-spec-slice-workflows/STATUS.md

@@ -0,0 +1,24 @@
+# Status - Quiver v40 CLI i18n Spec and Slice Workflows
+
+**Overall status:** Completed
+**Created:** 2026-05-28
+**Completed:** 2026-05-29
+**Current slice:** Completed
+
+## Summary
+
+This spec localizes spec and slice workflow command output after the v37 foundation is complete.
+
+## Slice Status
+
+| Slice | Status | Notes |
+|---|---|---|
+| slice-00-spec-slice-foundation | Completed | Spec package and handoffs created. |
+| slice-01-spec-create-start-status | Completed | `spec create`, `spec start`, and `spec status` human output localized for `en`/`es`. |
+| slice-02-spec-validate-close | Completed | `spec validate` and `spec close` human output localized for `en`/`es`. |
+| slice-03-slice-lifecycle-handoffs | Completed | Slice lifecycle, readiness gates, handoff errors, and executor dry-run output localized for `en`/`es`. |
+| slice-04-spec-slice-tests-smokes | Completed | Full tests, package, smoke, diff, and strict spec validation passed. |
+
+## Current Blockers
+
+- None.

package/specs/quiver-v40-cli-i18n-spec-slice-workflows/pr.md

@@ -0,0 +1,94 @@
+## Title
+
+Quiver v40 - CLI i18n for spec and slice workflow commands
+
+## Summary
+
+- Localizes `spec create/start/status/validate/close`, slice lifecycle gates, handoff validation, `check-slice`, `check-pr`, `check-scope`, and `ai execute-slice` wrapper output for `en` and `es`.
+- Preserves generated spec artifacts, JSON contracts, provider prompts, command snippets, paths, ids, statuses, and branch/model/provider identifiers.
+- Closes the v40 spec with full test, package, smoke, and strict spec validation evidence.
+
+## Scope
+
+- In scope: human-facing wrappers and reports for spec/slice workflow commands covered by `specs/quiver-v40-cli-i18n-spec-slice-workflows`.
+- Out of scope: generated template localization, provider prompt translation, model/provider access behavior, and unrelated v44 TUI work.
+
+## Files
+
+- `src/create-quiver/commands/spec.js`
+- `src/create-quiver/lib/spec-worktrees.js`
+- `src/create-quiver/lib/handoff.js`
+- `src/create-quiver/lib/lifecycle.js`
+- `src/create-quiver/lib/readiness.js`
+- `src/create-quiver/lib/ai/executor.js`
+- `src/create-quiver/lib/i18n/messages/en.js`
+- `src/create-quiver/lib/i18n/messages/es.js`
+- `src/create-quiver/index.js`
+- `tests/**`
+- `scripts/ci/smoke-create-quiver.sh`
+- `scripts/ci/smoke-cross-platform.js`
+- `scripts/ci/smoke-tiered-pack.sh`
+- `specs/quiver-v40-cli-i18n-spec-slice-workflows/**`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js 22+
+- npm
+- Git CLI available
+
+### Worktree Access
+
+- Worktree: `quiver-v40`
+- Branch: `feature/QUIVER-40-01-v40-spec-create-start-status`
+
+### Run the Project
+
+```bash
+node bin/create-quiver.js --help
+```
+
+### Use Cases
+
+#### Case 1: Spec workflow command localization
+
+Run `spec create`, `spec start`, `spec status`, `spec validate`, and `spec close` paths in `en` and `es`; verify human labels change while paths, commands, ids, and JSON stay stable.
+
+#### Case 2: Slice lifecycle and handoff localization
+
+Run `start-slice`, `check-slice`, `check-pr`, `check-handoff`, and `ai execute-slice --dry-run`; verify wrappers localize while `ai prompt-slice` remains prompt-only.
+
+### Technical Verification
+
+```bash
+node --test tests/**/*.test.js
+node bin/create-quiver.js spec validate specs/quiver-v40-cli-i18n-spec-slice-workflows --strict
+npm run package:quiver
+npm run smoke:create-quiver
+node scripts/ci/smoke-cross-platform.js
+bash scripts/ci/smoke-tiered-pack.sh
+git diff --check
+```
+
+## Evidence
+
+- `node --test tests/**/*.test.js` passed: 587 tests.
+- `node bin/create-quiver.js spec validate specs/quiver-v40-cli-i18n-spec-slice-workflows --strict` passed.
+- `npm run package:quiver` passed and produced `create-quiver-0.15.3.tgz`.
+- `npm run smoke:create-quiver` passed.
+- `node scripts/ci/smoke-cross-platform.js` passed.
+- `bash scripts/ci/smoke-tiered-pack.sh` passed.
+- `git diff --check` passed.
+
+## Rollback
+
+```bash
+git revert --no-commit origin/main..HEAD
+git commit -m "revert: Quiver v40 CLI i18n workflow commands"
+```
+
+## Risks / Notes
+
+- `ai prompt-slice` intentionally remains payload-only to avoid polluting provider/executor prompt content.
+- Smokes now set `QUIVER_LANG=es` explicitly where they assert Spanish workflow wrapper output.

package/specs/quiver-v40-cli-i18n-spec-slice-workflows/slices/slice-00-spec-slice-foundation/CLOSURE_BRIEF.md

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