create-quiver 0.15.2 → 0.15.4

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-05-main-progress-user-guidance/slice.json

@@ -0,0 +1,71 @@
+{
+  "slice_id": "slice-05-main-progress-user-guidance",
+  "ticket": "QUIVER-36-05",
+  "type": "feature",
+  "title": "Main progress and user guidance",
+  "objective": "Show run id and watch command in the main human UX while preserving automation-safe output modes.",
+  "description": "Updates planner-oriented live AI commands to surface the generated run id, keep stable progress, and guide users to the portable watcher.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v36-main-progress-user-guidance",
+    "branch_name": "feature/QUIVER-36-05-v36-main-progress-user-guidance"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/cli/ux.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/ai-revise.test.js",
+    "tests/commands/ai-run-watch.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/run-state.js",
+    "src/create-quiver/lib/ai/run-events.js",
+    "src/create-quiver/lib/cli/ux.js",
+    "specs/quiver-v36-ai-run-watch-portable/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/cli/ux.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/commands/ai-revise.test.js",
+    "tests/commands/ai-run-watch.test.js",
+    "specs/quiver-v36-ai-run-watch-portable/**"
+  ],
+  "depends_on": [
+    "slice-03-provider-streaming-integration",
+    "slice-04-ai-run-watch-command"
+  ],
+  "parallel_safe": "never",
+  "parallel_safe_reason": "Depends on the completed provider streaming and watcher contracts to avoid partial user guidance.",
+  "must": [
+    "Show the generated run id in human TTY output.",
+    "Show the exact watch command for the current run.",
+    "Keep raw provider output out of the main terminal by default.",
+    "Preserve CI, no-TTY, --json, --print-prompt, and --dry-run behavior.",
+    "Update run status on provider failure or main-command cancellation."
+  ],
+  "not_included": [
+    "Watcher implementation.",
+    "Provider event persistence.",
+    "Documentation updates."
+  ],
+  "acceptance": [
+    "Users can copy the displayed watch command and observe the same run.",
+    "Machine-readable output contains no human headings, spinners, or colors.",
+    "Dry-run and print-prompt do not create unexpected live run artifacts.",
+    "Failure and cancellation guidance is actionable and redacted."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-plan.test.js tests/commands/ai-revise.test.js tests/commands/ai-run-watch.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Test TTY and no-TTY paths separately.",
+    "Test provider failure and SIGINT after run creation."
+  ],
+  "estimated_hours": 4,
+  "status": "planned",
+  "blocked_reason": null
+}

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-06-docs-generated-guidance/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-06 Docs and generated guidance
+
+## Summary
+
+Pending implementation.
+
+## Validation
+
+- [ ] `node --test tests/commands/cli-contract.test.js tests/lib/init-docs.test.js`
+- [ ] `npx create-quiver spec validate specs/quiver-v36-ai-run-watch-portable --strict`
+- [ ] `git diff --check`
+
+## Pending
+
+- Update docs after public runtime behavior is implemented.
+
+## Remaining Risks
+
+- Documentation can drift if generated templates are not updated with the same examples as canonical docs.

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-06-docs-generated-guidance/EXECUTION_BRIEF.md

@@ -0,0 +1,45 @@
+# EXECUTION_BRIEF - slice-06 Docs and generated guidance
+
+## Context
+
+The watcher introduces public commands, artifacts, and safety expectations. User-facing docs and generated project guidance must match the implemented behavior.
+
+## Objective
+
+Document `ai run watch`, run artifacts, JSONL mode, portability limits, and safe usage in canonical docs and generated guidance.
+
+## Scope
+
+- CLI UX documentation
+- AI guidance documentation
+- Command reference documentation
+- Generated docs/templates
+- Notes for legacy runs, stale runs, JSONL, and security
+
+## Acceptance Criteria
+
+- Docs explain what the Quiver run id is and that it is not a provider session id.
+- Docs include `npx create-quiver ai run watch --run <run-id>`.
+- Docs include `npx create-quiver ai run watch --latest`.
+- Docs include JSONL usage and state that `--json` emits JSONL only.
+- Docs explain completed, failed, canceled, stale, legacy, and missing-run behavior at a user level.
+- Docs explicitly state Quiver does not embed provider TUIs or require terminal multiplexers.
+- Generated guidance matches public command behavior.
+- Missing `docs/INDEX.md` debt is not hidden if the documentation workflow requires index updates.
+
+## Technical Plan Summary
+
+Update docs after runtime behavior stabilizes, then update generated guidance/templates so new projects receive the same command references.
+
+## Restrictions
+
+- Do not document behavior that has not been implemented.
+- Do not add architecture claims that contradict the SPEC.
+- Do not duplicate large sections across docs when a command reference link is enough.
+
+## Completion Checklist
+
+- [ ] Canonical docs updated.
+- [ ] Generated guidance updated.
+- [ ] Command examples verified.
+- [ ] Documentation debt captured if `docs/INDEX.md` remains absent.

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-06-docs-generated-guidance/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-06-docs-generated-guidance",
+  "ticket": "QUIVER-36-06",
+  "type": "documentation",
+  "title": "Docs and generated guidance",
+  "objective": "Document the portable watcher in canonical docs, command references, and generated guidance.",
+  "description": "Adds user-facing and generated documentation for run ids, watch commands, JSONL mode, artifacts, portability, and safety expectations.",
+  "git": {
+    "branch_type": "docs",
+    "base_branch": "main",
+    "branch_slug": "v36-docs-generated-guidance",
+    "branch_name": "docs/QUIVER-36-06-v36-docs-generated-guidance"
+  },
+  "files": [
+    "docs/CLI_UX_GUIDE.md",
+    "README_FOR_AI.md",
+    "docs/reference/commands.md",
+    "docs/COMMANDS.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/init-docs.test.js"
+  ],
+  "expected_read_paths": [
+    "docs/CLI_UX_GUIDE.md",
+    "README_FOR_AI.md",
+    "docs/reference/commands.md",
+    "docs/COMMANDS.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "specs/quiver-v36-ai-run-watch-portable/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "docs/CLI_UX_GUIDE.md",
+    "README_FOR_AI.md",
+    "docs/reference/commands.md",
+    "docs/COMMANDS.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/lib/init-docs.test.js",
+    "specs/quiver-v36-ai-run-watch-portable/**"
+  ],
+  "depends_on": [
+    "slice-04-ai-run-watch-command",
+    "slice-05-main-progress-user-guidance"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can proceed after command behavior is stable; generated docs and canonical docs should be updated in one pass.",
+  "must": [
+    "Document run id semantics.",
+    "Document --run and --latest usage.",
+    "Document JSONL-only behavior for --json.",
+    "Document stale, legacy, completed, failed, canceled, and missing-run behavior.",
+    "Document that Quiver does not embed provider TUIs or require terminal multiplexers.",
+    "Update generated guidance/templates with matching command examples."
+  ],
+  "not_included": [
+    "Runtime behavior changes.",
+    "Spec redesign."
+  ],
+  "acceptance": [
+    "Docs match the implemented public CLI behavior.",
+    "Generated guidance includes the same essential watcher commands.",
+    "No docs claim platform-specific terminal automation as core behavior.",
+    "Documentation debt around missing docs/INDEX.md is surfaced if still applicable."
+  ],
+  "tests": [
+    "node --test tests/commands/cli-contract.test.js tests/lib/init-docs.test.js",
+    "npx create-quiver spec validate specs/quiver-v36-ai-run-watch-portable --strict",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Generate a fresh sandbox project and inspect AI guidance files.",
+    "Check that documented commands are accepted by CLI parsing tests."
+  ],
+  "estimated_hours": 3,
+  "status": "planned",
+  "blocked_reason": null
+}

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-07-tests-cross-platform-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,22 @@
+# CLOSURE_BRIEF - slice-07 Tests and cross-platform readiness
+
+## Summary
+
+Pending implementation.
+
+## Validation
+
+- [ ] `node --test tests/**/*.test.js`
+- [ ] `git diff --check`
+- [ ] `npx create-quiver spec validate specs/quiver-v36-ai-run-watch-portable --strict`
+- [ ] `npm run package:quiver`
+- [ ] `npm run smoke:create-quiver`
+- [ ] `node scripts/ci/smoke-cross-platform.js`
+
+## Pending
+
+- Execute after runtime and docs slices are complete.
+
+## Remaining Risks
+
+- Cross-platform behavior can regress if validation depends on POSIX-only shell behavior instead of Node-based smoke coverage.

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-07-tests-cross-platform-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,46 @@
+# EXECUTION_BRIEF - slice-07 Tests and cross-platform readiness
+
+## Context
+
+The feature changes long-running AI command observability and touches persistence, redaction, command UX, and docs. Final validation must prove the full workflow is production-ready across supported terminals and platforms.
+
+## Objective
+
+Add and run final automated validation, package smoke tests, and cross-platform smoke coverage for the portable watcher.
+
+## Scope
+
+- Focused unit and command tests
+- Integration-style simulated provider streaming tests
+- Package smoke validation
+- Cross-platform smoke script updates
+- Final evidence report updates
+
+## Acceptance Criteria
+
+- Tests cover path traversal and malformed run ids.
+- Tests cover missing run, `--latest`, completed, failed, canceled, stale, and legacy runs.
+- Tests cover partial JSONL lines during append.
+- Tests cover split secrets, ANSI/control character sanitization, and log truncation.
+- Tests cover no-TTY, CI, JSON, dry-run, and print-prompt behavior.
+- Tests cover paths with spaces.
+- Simulated provider streaming proves stdout/stderr capture, event persistence, cancellation, and failure handling.
+- Package smoke proves `npx create-quiver ai run watch ...` resolves from the packaged CLI.
+- Final evidence records commands run and any remaining risks.
+
+## Technical Plan Summary
+
+Close gaps left by earlier slices with targeted tests first, then run full project validation and package smokes. Prefer deterministic local simulations over external provider calls.
+
+## Restrictions
+
+- Do not require real provider credentials for validation.
+- Do not require `tmux`, `zellij`, Windows Terminal automation, or `node-pty`.
+- Do not rely on platform-specific shell syntax in required smoke tests.
+
+## Completion Checklist
+
+- [ ] Focused tests added or updated.
+- [ ] Cross-platform smoke covers watcher behavior.
+- [ ] Package smoke covers packaged command resolution.
+- [ ] Evidence report updated with command results.

package/specs/quiver-v36-ai-run-watch-portable/slices/slice-07-tests-cross-platform-readiness/slice.json

@@ -0,0 +1,87 @@
+{
+  "slice_id": "slice-07-tests-cross-platform-readiness",
+  "ticket": "QUIVER-36-07",
+  "type": "validation",
+  "title": "Tests and cross-platform readiness",
+  "objective": "Prove the portable watcher is covered by automated tests, package smoke, and cross-platform smoke validation.",
+  "description": "Adds final coverage for persistence, watcher behavior, security, automation modes, package execution, and platform portability.",
+  "git": {
+    "branch_type": "test",
+    "base_branch": "main",
+    "branch_slug": "v36-tests-cross-platform-readiness",
+    "branch_name": "test/QUIVER-36-07-v36-tests-cross-platform-readiness"
+  },
+  "files": [
+    "tests/commands/ai-run-watch.test.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/lib/ai-run-state.test.js",
+    "tests/lib/ai-run-events.test.js",
+    "tests/lib/ai-provider-streaming.test.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "specs/quiver-v36-ai-run-watch-portable/EVIDENCE_REPORT.md"
+  ],
+  "expected_read_paths": [
+    "tests/commands/ai-run-watch.test.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/lib/ai-run-state.test.js",
+    "tests/lib/ai-run-events.test.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "specs/quiver-v36-ai-run-watch-portable/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "tests/commands/ai-run-watch.test.js",
+    "tests/commands/ai-plan.test.js",
+    "tests/lib/ai-run-state.test.js",
+    "tests/lib/ai-run-events.test.js",
+    "tests/lib/ai-provider-streaming.test.js",
+    "scripts/ci/smoke-create-quiver.sh",
+    "scripts/ci/smoke-cross-platform.js",
+    "specs/quiver-v36-ai-run-watch-portable/**"
+  ],
+  "depends_on": [
+    "slice-02-event-writer-redacted-logs",
+    "slice-03-provider-streaming-integration",
+    "slice-04-ai-run-watch-command",
+    "slice-05-main-progress-user-guidance",
+    "slice-06-docs-generated-guidance"
+  ],
+  "parallel_safe": "never",
+  "parallel_safe_reason": "Final readiness must run after runtime and docs behavior stabilizes.",
+  "must": [
+    "Cover path traversal and malformed run ids.",
+    "Cover missing, latest, completed, failed, canceled, stale, and legacy runs.",
+    "Cover partial JSONL lines.",
+    "Cover split secrets, ANSI/control sanitization, and log truncation.",
+    "Cover no-TTY, CI, JSON, dry-run, and print-prompt behavior.",
+    "Cover paths with spaces.",
+    "Cover simulated provider streaming for stdout, stderr, cancellation, and failure.",
+    "Run package smoke and cross-platform smoke."
+  ],
+  "not_included": [
+    "Real provider credential tests.",
+    "Publishing to npm."
+  ],
+  "acceptance": [
+    "Required validation commands complete or documented blockers are recorded.",
+    "No required smoke depends on a terminal multiplexer.",
+    "Evidence report lists final commands and outcomes.",
+    "All P0 safety criteria from the SPEC have automated coverage."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "git diff --check",
+    "npx create-quiver spec validate specs/quiver-v36-ai-run-watch-portable --strict",
+    "npm run package:quiver",
+    "npm run smoke:create-quiver",
+    "node scripts/ci/smoke-cross-platform.js"
+  ],
+  "validation_hints": [
+    "Use simulated providers instead of external AI CLIs.",
+    "Run package smoke from a path containing spaces."
+  ],
+  "estimated_hours": 6,
+  "status": "planned",
+  "blocked_reason": null
+}

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.