create-quiver 0.15.3 → 0.16.0

package/pr.md

@@ -0,0 +1,154 @@
+## Title
+
+chore(release): 0.16.0
+
+## Summary
+
+Prepares `create-quiver` `0.16.0` for publication. This release bumps package metadata from `0.15.3` to `0.16.0` and updates the changelog with the newly integrated read-only `changelog` command, parser/registry extraction, Spec 01 closure package, and release-readiness command-role audit.
+
+## PR Policy
+
+- One release = one commit.
+- Base branch: `main`.
+- Branch: `release/create-quiver-0.16.0`.
+- Human merge required.
+- This PR does not publish to npm.
+- Publishing remains explicitly guarded by `QUIVER_ALLOW_NPM_PUBLISH=1` and npm auth.
+
+## Scope
+
+Includes:
+
+- Bump `package.json` to `0.16.0`.
+- Bump `package-lock.json` root/package versions to `0.16.0`.
+- Update `CHANGELOG.md` with release notes for the command wrapper, parser/registry extraction, evidence gates, and Spec 01 closure.
+- Validate the CLI command surface and release gates before opening the PR.
+
+Excludes:
+
+- No `npm publish`.
+- No npm tag creation.
+- No Git tag creation.
+- No branch cleanup.
+- No runtime code changes beyond already-merged slices.
+
+## Files
+
+- `package.json`
+- `package-lock.json`
+- `CHANGELOG.md`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js and npm installed.
+- Dependencies installed with `npm ci` or existing `node_modules` available.
+- Git checkout of this PR branch.
+- npm publish credentials are not required for PR validation.
+
+### Worktree Access
+
+1. Checkout `release/create-quiver-0.16.0`.
+2. Confirm the package version is `0.16.0`:
+
+   ```bash
+   node -e "const p=require('./package.json'); const l=require('./package-lock.json'); console.log(p.version, l.version, l.packages[''].version)"
+   ```
+
+3. Confirm only release metadata files changed:
+
+   ```bash
+   git diff --stat origin/main...HEAD
+   ```
+
+### Run the Project
+
+No server is required. This is a CLI package release PR.
+
+### Use Cases
+
+1. Confirm release version metadata.
+
+   Expected:
+
+   - `package.json` reports `0.16.0`.
+   - `package-lock.json` reports `0.16.0` at root and package entry.
+
+2. Confirm changelog explains why the release exists.
+
+   Expected:
+
+   - `CHANGELOG.md` includes `changelog` command notes.
+   - `CHANGELOG.md` includes parser/registry extraction and release-readiness evidence notes.
+
+3. Confirm the new command role.
+
+   Expected:
+
+   - `changelog` is read-only.
+   - Human output explains packaged release notes.
+   - JSON output is parseable for automation.
+
+4. Confirm public command roles are understood before publish.
+
+   Expected:
+
+   - Help/version/changelog/config are direct inspection commands.
+   - Init/analyze/migrate/demo/evidence write only in explicit or fixture-safe modes.
+   - Flow/dashboard/plan/graph/next/spec/slice/handoff commands describe workflow state and validation.
+   - AI commands are lifecycle, planning, provider-profile, execution, inspection, and PR-preflight surfaces.
+   - Commands with missing prerequisites fail with actionable, controlled errors instead of crashes.
+
+### Technical Verification
+
+Run:
+
+```bash
+npm run changelog:check
+npm run docs:check
+npm run schema:slice:check
+npm test
+```
+
+Optional release dry-run from a clean worktree:
+
+```bash
+npm ci
+bash scripts/release-quiver.sh patch
+```
+
+Expected:
+
+- Changelog validation passes.
+- Docs lint/link/generated command reference checks pass.
+- Slice schema validation passes.
+- Full test suite passes.
+- Release dry-run passes through changelog/docs/schema, installer smoke, package artifact, and installed CLI smoke.
+
+## Evidence
+
+Validated locally before PR:
+
+- `npm run changelog:check`: OK, `Unreleased entries: 26`.
+- `npm run docs:check`: OK.
+- `npm run schema:slice:check`: OK.
+- `npm test`: OK, `655/655` pass.
+- Manual command-role audit: OK after correcting fixtures/preconditions.
+- `changelog` human output: OK.
+- `changelog --json`: OK, parseable JSON.
+- `status --json`: controlled unsupported top-level command, as intended.
+- Release dry-run in clean temporary worktree with `npm ci`: OK.
+- Package smoke: OK, `create-quiver-0.16.0.tgz` installed CLI smoke passed.
+
+## Rollback
+
+Revert the single release commit before merge. If already merged but not published, revert the release commit on `main`. If already published, do not unpublish by default; publish a corrective patch release instead.
+
+## Risks / Notes
+
+- npm `latest` is currently `0.15.4`; this PR intentionally prepares `0.16.0` because the public CLI surface changed with `changelog`.
+- Local `npm whoami` previously returned `401 Unauthorized`; publishing requires npm login before the final publish step.
+- `QUIVER_ALLOW_NPM_PUBLISH=1` must be explicitly set for guarded publish flows.
+- The release script does not publish in this PR.
+- Local `pr.md` is not part of the PR commit.

package/scripts/package-quiver.sh

@@ -6,6 +6,9 @@ repo_root="$(git rev-parse --show-toplevel)"
 temp_root="$(mktemp -d "${TMPDIR:-/tmp}/quiver-pack.XXXXXX")"
 pack_dir="$temp_root/pack"
 npm_cache="$temp_root/npm-cache"
+install_root="$temp_root/install-root"
+dry_run_target="$temp_root/dry-run-project"
+cli_version="$(node -p 'require(process.argv[1]).version' "$repo_root/package.json")"
 
 cleanup() {
   rm -rf "$temp_root"
@@ -15,13 +18,14 @@ trap cleanup EXIT
 
 mkdir -p "$pack_dir"
 mkdir -p "$npm_cache"
+mkdir -p "$install_root"
 
 pack_json="$(
   cd "$repo_root" && npm_config_cache="$npm_cache" npm pack --json --pack-destination "$pack_dir"
 )"
 
 tarball_name="$(
-  node -e 'const data = JSON.parse(process.argv[1]); process.stdout.write(data[0].filename);' "$pack_json"
+  printf '%s\n' "$pack_json" | node -e 'const fs = require("node:fs"); const data = JSON.parse(fs.readFileSync(0, "utf8")); process.stdout.write(data[0].filename);'
 )"
 tarball_path="$pack_dir/$tarball_name"
 
@@ -68,6 +72,41 @@ require_absent() {
   fi
 }
 
+reject_forbidden_content_patterns() {
+  local path
+
+  while IFS= read -r path; do
+    case "$path" in
+      package/package-lock.json|\
+      package/CLI_ANALYSIS.md|\
+      package/REQUERIMIENTOS_DERIVADOS_DE_AUDITORIA.md|\
+      package/Documentation_Report.pdf|\
+      package/WORKTREE_CONTEXT.md|\
+      package/.DS_Store|\
+      package/*/.DS_Store|\
+      package/*.pdf|\
+      package/.env|\
+      package/.env.*|\
+      package/.npmrc|\
+      package/.npm/*|\
+      package/.ssh/*|\
+      package/ssh/*|\
+      package/*.pem|\
+      package/*.key|\
+      package/.claude/*|\
+      package/.codex/*|\
+      package/.quiver/*|\
+      package/.worktrees/*|\
+      package/tests/*|\
+      package/examples/*|\
+      package/scripts/ci/*)
+        echo "FAIL: el paquete incluye contenido fuera del contrato: $path" >&2
+        exit 1
+        ;;
+    esac
+  done <<<"$contents"
+}
+
 required_paths=(
   "package/package.json"
   "package/bin/create-quiver.js"
@@ -93,6 +132,9 @@ required_paths=(
   "package/.github/ISSUE_TEMPLATE/feature_request.md"
   "package/.github/workflows/ci.yml"
   "package/docs/INDEX.md.template"
+  "package/docs/reference/commands.md"
+  "package/docs/schema/slice.schema.json"
+  "package/docs/reference/slice-schema.md"
   "package/docs/DOCUMENTATION_GUIDE.md.template"
   "package/docs/WORKFLOW.md.template"
   "package/docs/SUPPORT_MATRIX.md.template"
@@ -127,8 +169,16 @@ done
 
 excluded_paths=(
   "package/package-lock.json"
+  "package/CLI_ANALYSIS.md"
+  "package/REQUERIMIENTOS_DERIVADOS_DE_AUDITORIA.md"
+  "package/Documentation_Report.pdf"
+  "package/.DS_Store"
+  "package/WORKTREE_CONTEXT.md"
   "package/tests/"
   "package/examples/"
+  "package/.claude/"
+  "package/.codex/"
+  "package/.quiver/"
   "package/.worktrees/"
   "package/specs/quiver-v01/"
   "package/specs/quiver-v02-bootstrap-hardening/"
@@ -144,4 +194,34 @@ for path in "${excluded_paths[@]}"; do
   fi
 done
 
-printf 'Package smoke passed: %s\n' "$tarball_name"
+reject_forbidden_content_patterns
+
+npm_config_cache="$npm_cache" npm install --prefix "$install_root" "$tarball_path" --ignore-scripts --no-audit --no-fund >/dev/null
+installed_cli="$install_root/node_modules/create-quiver/bin/create-quiver.js"
+
+if [[ ! -f "$installed_cli" ]]; then
+  echo "FAIL: no se encontró el CLI instalado en $installed_cli" >&2
+  exit 1
+fi
+
+installed_semver="$(node "$installed_cli" --version)"
+if [[ "$installed_semver" != "$cli_version" ]]; then
+  echo "FAIL: el CLI instalado devolvió versión '$installed_semver', esperada '$cli_version'" >&2
+  exit 1
+fi
+
+installed_help="$(node "$installed_cli" --help)"
+if [[ "$installed_help" != *"version [--json]"* ]] \
+  || [[ "$installed_help" != *"spec create"* ]] \
+  || [[ "$installed_help" != *"slice start|check|pr|scope|cleanup|refresh-active"* ]]; then
+  echo "FAIL: la ayuda del CLI instalado no expone comandos públicos esperados" >&2
+  exit 1
+fi
+
+node "$installed_cli" init --dry-run --name "Package Smoke" --dir "$dry_run_target" --skip-install >/dev/null
+if [[ -e "$dry_run_target" ]]; then
+  echo "FAIL: init --dry-run del CLI instalado escribió en $dry_run_target" >&2
+  exit 1
+fi
+
+printf 'Package smoke passed: %s (installed CLI smoke passed)\n' "$tarball_name"

package/scripts/release-quiver.sh

@@ -11,12 +11,15 @@ usage() {
 Usage: scripts/release-quiver.sh [patch|minor|major|x.y.z] [--publish | --publish-current]
 
 By default the script performs a release dry run:
+  - validates changelog, docs, and schema gates
   - validates the installer smoke
-  - validates the package artifact
+  - validates the package artifact and installed CLI smoke
   - prints the versioning and publish commands to run next
 
-Pass --publish to run npm version and npm publish after the smoke checks pass.
-Pass --publish-current to publish the current package version without forcing a patch bump.
+Publishing remains manually guarded. Pass --publish only with
+QUIVER_ALLOW_NPM_PUBLISH=1 to run npm version and npm publish after the smoke
+checks pass. Pass --publish-current with the same environment guard to publish
+the current package version without forcing a patch bump.
 EOF
 }
 
@@ -50,6 +53,14 @@ if [[ -n "$(git status --porcelain)" ]]; then
   exit 1
 fi
 
+if [[ "$publish" == "true" && "${QUIVER_ALLOW_NPM_PUBLISH:-}" != "1" ]]; then
+  echo "FAIL: publishing requires QUIVER_ALLOW_NPM_PUBLISH=1. Run the dry-run first and publish manually unless this release is explicitly authorized." >&2
+  exit 1
+fi
+
+npm run changelog:check
+npm run docs:check
+npm run schema:slice:check
 bash scripts/ci/smoke-create-quiver.sh
 bash scripts/package-quiver.sh
 

package/specs/[project-name]/slices/pr.md.template

@@ -8,6 +8,25 @@
 
 [Brief summary of what was implemented and why]
 
+## PR Policy
+
+- [ ] One slice only.
+- [ ] Grouped PR exception: at most 2-3 slices, all docs-only, research-only, or low-risk mechanical cleanup.
+- [ ] No behavior changes in a grouped PR.
+- [ ] No mixed docs with UI, backend, refactor, or performance work.
+- [ ] Separate evidence for each included slice.
+- [ ] Whole PR is revertible without leaving partial state.
+
+Individual PR required when this slice includes functional code, UI/UX, Supabase, Edge Functions, auth, storage, preview, performance/code-splitting, refactors, or tests/CI changes that affect gates.
+
+### Merge Policy
+
+- [ ] Human merge expected.
+- [ ] Assisted auto-merge explicitly authorized for this PR or documented category.
+- [ ] Assisted auto-merge conditions met: docs-only or chore-only, low risk, no runtime changes, no production configuration changes, green checks, and no pending comments.
+
+Assisted auto-merge is prohibited for UI, Supabase, Edge Functions, auth, storage, preview, performance, refactors, and changes with doubtful rollback.
+
 ## Scope
 
 - [Included change 1]

package/specs/quiver-v37-cli-i18n-foundation/EVIDENCE_REPORT.md

@@ -0,0 +1,73 @@
+# Evidence Report - Quiver v37 CLI i18n Foundation
+
+## slice-00-foundation-and-program-roadmap
+
+- Created this spec package and all slice handoffs.
+- Runtime implementation intentionally not started.
+
+## slice-01-language-resolution-contract
+
+- Implemented `src/create-quiver/lib/i18n/language.js`.
+- Wired global `--lang <en|es>` extraction before command dispatch in `src/create-quiver/index.js`.
+- Added focused resolver/config/locale tests in `tests/lib/i18n-language.test.js`.
+- Added CLI contract tests proving `--lang` works before and after commands without changing JSON output.
+- Validation passed:
+  - `node --test tests/lib/i18n-language.test.js`
+  - `node --test tests/commands/cli-contract.test.js`
+  - `node --test tests/**/*.test.js` (534 tests)
+  - `node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict`
+  - `git diff --check`
+
+## slice-02-message-catalog-interpolation
+
+- Implemented `src/create-quiver/lib/i18n/catalog.js`.
+- Added versioned catalogs:
+  - `src/create-quiver/lib/i18n/messages/en.js`
+  - `src/create-quiver/lib/i18n/messages/es.js`
+- Added focused catalog tests in `tests/lib/i18n-catalog.test.js`.
+- Validation passed:
+  - `node --test tests/lib/i18n-catalog.test.js`
+
+## slice-03-config-language-command
+
+- Implemented `src/create-quiver/commands/config.js`.
+- Wired `config language show` and `config language set <en|es>` into `src/create-quiver/index.js`.
+- Added `--global` support for writing `~/.quiver/config.json`.
+- Updated `docs/reference/commands.md`.
+- Added `tests/commands/config-language.test.js`.
+- Validation passed:
+  - `node --test tests/commands/config-language.test.js`
+  - `node --test tests/lib/i18n-catalog.test.js tests/lib/i18n-language.test.js tests/commands/cli-contract.test.js`
+  - `node --test tests/**/*.test.js` (547 tests)
+  - `node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict`
+  - `git diff --check`
+
+## slice-04-parser-help-error-foundation
+
+- Routed top-level help headings, command descriptions, language warnings, unsupported commands, unsupported flags, and missing flag values through the i18n catalog.
+- Preserved literal command snippets, flags, ids, and JSON contracts.
+- Added CLI contract coverage for:
+  - `--lang es --help`
+  - project-configured Spanish help without `--lang`
+  - missing `--lang` value using `QUIVER_LANG=es`
+  - unsupported flags in Spanish
+  - unsupported commands in English and Spanish
+- Validation passed:
+  - `node --test tests/commands/cli-contract.test.js`
+  - `node --test tests/lib/i18n-catalog.test.js tests/lib/i18n-language.test.js`
+  - `node --test tests/commands/config-language.test.js`
+
+## slice-05-foundation-docs-tests-package-readiness
+
+- Updated `docs/CLI_UX_GUIDE.md` with language resolution precedence, JSON stability, and automation/no-TTY rules.
+- Updated `docs/reference/commands.md` with `--lang`, `QUIVER_LANG`, project/global config precedence, and examples.
+- Validation passed:
+  - `node --test tests/**/*.test.js` (549 tests)
+  - `git diff --check`
+  - `npm run package:quiver`
+  - `npm run smoke:create-quiver`
+  - `node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict`
+
+## Pending Evidence
+
+- None.

package/specs/quiver-v37-cli-i18n-foundation/EXECUTION_PLAN.md

@@ -0,0 +1,34 @@
+# Execution Plan - Quiver v37 CLI i18n Foundation
+
+## Execution Rules
+
+- Do not implement runtime code without an approved slice.
+- Preserve stable JSON output.
+- Keep command names, flags, ids, paths, provider names, and model ids untranslated.
+- Add tests for `en` and `es` for every public human output touched by this spec.
+
+## Suggested Order
+
+1. `slice-00-foundation-and-program-roadmap`
+2. `slice-01-language-resolution-contract`
+3. `slice-02-message-catalog-interpolation`
+4. `slice-03-config-language-command`
+5. `slice-04-parser-help-error-foundation`
+6. `slice-05-foundation-docs-tests-package-readiness`
+
+## Parallelization Guidance
+
+- `slice-01` must complete before runtime i18n work.
+- `slice-02` must complete before commands are migrated to catalogs.
+- `slice-03` and `slice-04` can run in parallel only after `slice-02` if ownership is split by files.
+- `slice-05` runs last.
+
+## Final Validation
+
+```bash
+node --test tests/**/*.test.js
+git diff --check
+npx create-quiver spec validate specs/quiver-v37-cli-i18n-foundation --strict
+npm run package:quiver
+npm run smoke:create-quiver
+```

package/specs/quiver-v37-cli-i18n-foundation/SPEC.md

@@ -0,0 +1,91 @@
+# Quiver v37 - CLI i18n Foundation
+
+**Date:** 2026-05-28
+**Status:** Completed
+**Source:** User-approved requirement for Spanish and English CLI output, hardened for production before implementation.
+
+Slice numbering resets here. This spec intentionally starts at `slice-00`.
+
+## Problem
+
+Quiver currently exposes human CLI messages in a single language. Users should not need to remember language flags after configuring a project, and automation must keep stable JSON contracts while human output can be localized.
+
+## Objective
+
+Create the foundation for Spanish (`es`) and English (`en`) output across Quiver commands:
+
+- A single language resolution contract.
+- Project and global language persistence.
+- A message catalog with interpolation, pluralization, fallback, and missing-key detection.
+- Localized help, parser errors, and early command errors before command dispatch.
+- A stable rule that JSON output remains machine-readable and not localized.
+
+## Scope
+
+### Included
+
+- Supported languages: `en`, `es`.
+- Global `--lang <en|es>` flag that works before and after command names.
+- `QUIVER_LANG` environment override.
+- Project config `.quiver/config.json`.
+- Global config `~/.quiver/config.json` resolved with `os.homedir()`.
+- Locale detection from `LC_ALL`, `LC_MESSAGES`, `LANG`, `LANGUAGE`, and `Intl.DateTimeFormat().resolvedOptions().locale`.
+- Fallback to `en`.
+- `config language show`, `config language set es`, and `config language set en`.
+- Catalog versioning, interpolation, pluralization, fallback, and test coverage.
+- Parser/help/error localization foundation.
+
+### Excluded
+
+- Migrating every existing command in this spec.
+- Localizing JSON keys, error codes, schema fields, or command identifiers.
+- Translating commands, flags, file paths, provider names, model ids, run ids, spec ids, slice ids, or suggested command snippets.
+- Generated project documentation; that is covered by v42.
+
+## Approved Acceptance Criteria
+
+1. `init --interactive` can store the selected language in `.quiver/config.json`.
+2. After project language is configured, normal commands use that language without requiring `--lang`.
+3. `--lang` overrides every other source and works before or after the command.
+4. `QUIVER_LANG` overrides project/global config when `--lang` is absent.
+5. Project config overrides global config.
+6. Global config lives at `~/.quiver/config.json` using `os.homedir()`.
+7. Locale detection normalizes `es_AR`, `es-AR`, `en_US`, and `en-US`.
+8. Unsupported or missing language falls back to `en` with an actionable warning in human mode.
+9. `--json` output remains stable and parseable; JSON keys and codes are not localized.
+10. Localized text keeps suggested commands and flags exact.
+11. Catalog misses fail tests before release.
+12. New commands after v37 must use i18n or declare a temporary documented exception.
+
+## Approved Technical Plan
+
+1. Create this SDD package and handoffs without runtime implementation.
+2. Add language resolution and persistence helpers.
+3. Add message catalogs and safe translation helpers.
+4. Add `config language` commands.
+5. Route help, parser errors, and early command errors through the i18n layer.
+6. Add docs, tests, and package readiness for the foundation.
+
+## Slice Roadmap
+
+| Slice | Title | Status | Dependencies |
+|---|---|---|---|
+| slice-00 | Foundation and program roadmap | completed | none |
+| slice-01 | Language resolution contract | completed | slice-00 |
+| slice-02 | Message catalog and interpolation | completed | slice-01 |
+| slice-03 | Config language command | completed | slice-01, slice-02 |
+| slice-04 | Parser, help, and early error foundation | completed | slice-01, slice-02 |
+| slice-05 | Foundation docs, tests, and package readiness | completed | slice-02, slice-03, slice-04 |
+
+## Risks and Guardrails
+
+- Do not localize JSON contracts.
+- Do not mix Spanish and English in the same human command unless the untranslated fragment is a literal command, flag, path, id, provider, or model.
+- Do not hardcode output strings in later command work when a catalog key should exist.
+- Keep no-TTY and CI behavior deterministic; no prompts unless `--interactive` was requested.
+- Keep fallback behavior explicit and testable.
+
+## Assumptions
+
+- This repository's canonical spec location is `specs/quiver-vNN-*`.
+- The first implementation slice should start with a minimal reusable foundation before command migration.

package/specs/quiver-v37-cli-i18n-foundation/STATUS.md

@@ -0,0 +1,29 @@
+# Status - Quiver v37 CLI i18n Foundation
+
+**Overall status:** Completed
+**Created:** 2026-05-28
+**Completed:** 2026-05-29
+**Current slice:** none
+
+## Summary
+
+This spec defines the shared i18n foundation for Quiver CLI output. All v37 slices have been implemented and validated.
+
+## Slice Status
+
+| Slice | Status | Notes |
+|---|---|---|
+| slice-00-foundation-and-program-roadmap | Completed | Spec package, execution plan, PR body, evidence skeleton, and slice briefs created. |
+| slice-01-language-resolution-contract | Completed | Language sources, precedence, normalization, config read/write primitives, and global `--lang` extraction implemented. |
+| slice-02-message-catalog-interpolation | Completed | Catalog helpers, fallback, interpolation, pluralization, and missing-key tests implemented. |
+| slice-03-config-language-command | Completed | Added `config language show|set`, project/global persistence, JSON output, and command docs. |
+| slice-04-parser-help-error-foundation | Completed | Localized help headings/command descriptions, language warnings, unsupported commands, unsupported flags, and missing flag values. |
+| slice-05-foundation-docs-tests-package-readiness | Completed | Updated public docs and ran full tests, package smoke, create-quiver smoke, spec validation, and diff check. |
+
+## Current Blockers
+
+- None.
+
+## Next Step
+
+Proceed to the next i18n migration spec in the approved roadmap.

package/specs/quiver-v37-cli-i18n-foundation/pr.md

@@ -0,0 +1,97 @@
+## Title
+
+Quiver v37 CLI i18n foundation
+
+## Summary
+
+- Adds the shared foundation for Spanish and English CLI output.
+- Persists the configured language so users do not need flags after setup.
+- Keeps JSON output stable and non-localized.
+- Adds the approved follow-up i18n specs v38-v43 as the program roadmap.
+
+## Scope
+
+- Language resolution and config persistence.
+- Message catalogs and translation helpers.
+- `config language` commands.
+- Localized help/parser/early errors.
+- Docs and validation for the i18n foundation.
+- Roadmap specs for read-only commands, setup/onboarding, spec/slice workflows, AI lifecycle, generated docs, and release readiness.
+
+## Files
+
+- `src/create-quiver/index.js`
+- `src/create-quiver/commands/config.js`
+- `src/create-quiver/lib/i18n/**`
+- `tests/commands/cli-contract.test.js`
+- `tests/commands/config-language.test.js`
+- `tests/lib/i18n-catalog.test.js`
+- `tests/lib/i18n-language.test.js`
+- `docs/CLI_UX_GUIDE.md`
+- `docs/reference/commands.md`
+- `docs/INDEX.md`
+- `specs/quiver-v37-cli-i18n-foundation/**`
+- `specs/quiver-v38-cli-i18n-read-only-commands/**`
+- `specs/quiver-v39-cli-i18n-setup-onboarding/**`
+- `specs/quiver-v40-cli-i18n-spec-slice-workflows/**`
+- `specs/quiver-v41-cli-i18n-ai-lifecycle/**`
+- `specs/quiver-v42-cli-i18n-generated-docs/**`
+- `specs/quiver-v43-cli-i18n-audit-release-readiness/**`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js and npm available.
+- Repository checked out on macOS, Linux, or Windows-compatible shell.
+
+### Worktree Access
+
+- This PR is based on `main`.
+- No external services are required for local validation.
+
+### Run the Project
+
+```bash
+node bin/create-quiver.js --help
+node bin/create-quiver.js --lang es --help
+node bin/create-quiver.js config language show
+node bin/create-quiver.js config language set es --json
+node bin/create-quiver.js version --json
+```
+
+### Use Cases
+
+1. Run `node bin/create-quiver.js --lang es --help` and verify headings/descriptions are in Spanish while commands and flags remain exact.
+2. Run `QUIVER_LANG=es node bin/create-quiver.js --unknown-flag` and verify the early parser error is localized.
+3. Run `node bin/create-quiver.js version --json --lang es` and verify stdout remains parseable JSON with stable field names.
+4. Run `node bin/create-quiver.js config language set es` in a temp project and verify `.quiver/config.json` stores `language: "es"` without deleting existing keys.
+
+### Technical Verification
+
+```bash
+node --test tests/**/*.test.js
+git diff --check
+node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict
+npm run package:quiver
+npm run smoke:create-quiver
+```
+
+## Evidence
+
+- `node --test tests/**/*.test.js` passed with 549 tests.
+- `git diff --check` passed.
+- `node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict` passed.
+- `npm run package:quiver` passed.
+- `npm run smoke:create-quiver` passed.
+
+## Rollback
+
+- Revert this PR.
+- Remove `.quiver/config.json` language entries only if a local project used the new `config language set` command during manual testing.
+
+## Risks / Notes
+
+- Parser-level errors can bypass command-local i18n if the foundation is not wired before dispatch.
+- JSON contracts must remain stable across languages.
+- v38-v43 are specs only in this PR; command-specific migrations remain pending by design.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-00-foundation-and-program-roadmap/CLOSURE_BRIEF.md

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