create-quiver 0.15.3 → 0.15.4

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-03-config-language-command/CLOSURE_BRIEF.md

@@ -0,0 +1,32 @@
+# CLOSURE_BRIEF - slice-03 Config language command
+
+## Summary
+
+Implemented `config language` commands.
+
+Added:
+
+- `config language show`
+- `config language show --json`
+- `config language set <en|es>`
+- `config language set <en|es> --global`
+- project config writes to `.quiver/config.json`
+- global config writes to `~/.quiver/config.json`
+- stable JSON output for show/set
+- command reference documentation
+
+## Validation
+
+- [x] `node --test tests/commands/config-language.test.js`
+- [x] `node --test tests/lib/i18n-catalog.test.js tests/lib/i18n-language.test.js tests/commands/cli-contract.test.js`
+- [x] `node --test tests/**/*.test.js`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict`
+- [x] `git diff --check`
+
+## Pending
+
+- No pending work for this slice.
+
+## Remaining Risks
+
+- Parser/help localization is still pending in `slice-04-parser-help-error-foundation`.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-03-config-language-command/EXECUTION_BRIEF.md

@@ -0,0 +1,25 @@
+# EXECUTION_BRIEF - slice-03 Config language command
+
+## Context
+
+Language changes should be discoverable after init and usable in scripts.
+
+## Objective
+
+Add `config language show` and `config language set <en|es>` with project and global persistence.
+
+## Acceptance Criteria
+
+- `config language show` reports effective language and source.
+- `config language set es` and `config language set en` update project config by default.
+- A global option writes to `~/.quiver/config.json` without requiring a project.
+- Invalid languages fail with actionable guidance.
+- `--json` returns stable keys and codes.
+- Existing config keys are preserved.
+
+## Completion Checklist
+
+- [x] Command parser route added.
+- [x] Project/global write paths tested.
+- [x] JSON and human modes covered.
+- [x] Docs updated.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-03-config-language-command/slice.json

@@ -0,0 +1,66 @@
+{
+  "slice_id": "slice-03-config-language-command",
+  "ticket": "QUIVER-37-03",
+  "type": "feature",
+  "title": "Config language command",
+  "objective": "Add user-facing commands to inspect and update Quiver language configuration.",
+  "description": "Lets users change language without editing JSON by hand.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v37-config-language-command",
+    "branch_name": "feature/QUIVER-37-03-v37-config-language-command"
+  },
+  "files": [
+    "src/create-quiver/commands/config.js",
+    "tests/commands/config-language.test.js",
+    "docs/reference/commands.md"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/i18n/language.js",
+    "src/create-quiver/lib/i18n/catalog.js",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/config.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/config-language.test.js",
+    "docs/reference/commands.md",
+    "specs/quiver-v37-cli-i18n-foundation/**"
+  ],
+  "depends_on": [
+    "slice-01-language-resolution-contract",
+    "slice-02-message-catalog-interpolation"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can run alongside parser work after catalog ownership is settled.",
+  "must": [
+    "Implement show and set subcommands.",
+    "Preserve existing config keys.",
+    "Support project and global config scopes.",
+    "Keep JSON contracts stable."
+  ],
+  "not_included": [
+    "Migrating unrelated command output."
+  ],
+  "acceptance": [
+    "Users can set es or en for the project.",
+    "Users can set es or en globally.",
+    "show identifies effective language and source.",
+    "Invalid language values fail clearly."
+  ],
+  "tests": [
+    "node --test tests/commands/config-language.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use temp HOME in tests for global config.",
+    "Assert existing .quiver/config.json content is preserved."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "completed_at": "2026-05-29T00:00:00.000Z",
+  "blocked_reason": null
+}

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-04-parser-help-error-foundation/CLOSURE_BRIEF.md

@@ -0,0 +1,30 @@
+# CLOSURE_BRIEF - slice-04 Parser, help, and early error foundation
+
+## Summary
+
+Implemented parser/help/error i18n foundation.
+
+Added:
+
+- language-aware top-level help rendering
+- cataloged help headings and command descriptions
+- localized unsupported command errors
+- localized unsupported flag errors
+- localized missing flag value errors, including missing `--lang`
+- localized unsupported-language warnings in CLI entrypoint
+- tests for explicit `--lang`, project-configured language, JSON stdout cleanliness, no-color help, and literal command preservation
+
+## Validation
+
+- [x] `node --test tests/commands/cli-contract.test.js`
+- [x] `node --test tests/lib/i18n-catalog.test.js tests/lib/i18n-language.test.js`
+- [x] `node --test tests/commands/config-language.test.js`
+- [ ] `git diff --check`
+
+## Pending
+
+- Run `git diff --check` after final docs updates.
+
+## Remaining Risks
+
+- Command-specific business output is intentionally not migrated in this slice; it is covered by later i18n specs.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-04-parser-help-error-foundation/EXECUTION_BRIEF.md

@@ -0,0 +1,24 @@
+# EXECUTION_BRIEF - slice-04 Parser, help, and early error foundation
+
+## Context
+
+Some messages are emitted before command handlers run. They must still respect the selected language.
+
+## Objective
+
+Route help text, parser errors, unsupported command errors, and global option errors through the i18n foundation.
+
+## Acceptance Criteria
+
+- `--help` uses the resolved language.
+- Unknown command and unsupported flag errors use the resolved language.
+- `--lang` errors work even when `--lang` appears before the command.
+- `--json` errors keep stable machine fields.
+- `--no-color`, CI, and no-TTY modes remain clean.
+
+## Completion Checklist
+
+- [ ] Parser-level i18n wiring added.
+- [ ] Help output cataloged.
+- [ ] Early error tests added for `en` and `es`.
+- [ ] JSON/no-TTY tests updated.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-04-parser-help-error-foundation/slice.json

@@ -0,0 +1,65 @@
+{
+  "slice_id": "slice-04-parser-help-error-foundation",
+  "ticket": "QUIVER-37-04",
+  "type": "feature",
+  "title": "Parser, help, and early error foundation",
+  "objective": "Localize CLI help and early parser errors before command-specific migrations begin.",
+  "description": "Ensures global UX obeys selected language even before command handlers run.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v37-parser-help-error-foundation",
+    "branch_name": "feature/QUIVER-37-04-v37-parser-help-error-foundation"
+  },
+  "files": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/i18n/messages/en.js",
+    "src/create-quiver/lib/i18n/messages/es.js",
+    "tests/commands/cli-contract.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/i18n/**",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/**",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/cli-contract.test.js",
+    "specs/quiver-v37-cli-i18n-foundation/**"
+  ],
+  "depends_on": [
+    "slice-01-language-resolution-contract",
+    "slice-02-message-catalog-interpolation"
+  ],
+  "parallel_safe": "conditional",
+  "parallel_safe_reason": "Can run after catalog API is stable and should avoid overlapping config command files.",
+  "must": [
+    "Localize help output.",
+    "Localize unknown command and unsupported flag errors.",
+    "Respect --lang before command dispatch.",
+    "Keep JSON mode clean."
+  ],
+  "not_included": [
+    "Migrating every command's business output."
+  ],
+  "acceptance": [
+    "Help renders in en and es.",
+    "Early parser errors render in en and es.",
+    "JSON error payloads keep stable fields.",
+    "CI/no-TTY outputs contain no prompts or spinners."
+  ],
+  "tests": [
+    "node --test tests/commands/cli-contract.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Assert that command snippets remain exact in both languages."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "completed_at": "2026-05-29T00:00:00.000Z",
+  "blocked_reason": null
+}

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-05-foundation-docs-tests-package-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,27 @@
+# CLOSURE_BRIEF - slice-05 Foundation docs, tests, and package readiness
+
+## Summary
+
+Completed foundation documentation and release-readiness validation.
+
+Added:
+
+- language selection rules to `docs/CLI_UX_GUIDE.md`
+- `--lang`, `QUIVER_LANG`, project/global config precedence, and JSON stability docs to `docs/reference/commands.md`
+- final evidence for full suite, package smoke, and create-quiver smoke
+
+## Validation
+
+- [x] `node --test tests/**/*.test.js`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v37-cli-i18n-foundation --strict`
+- [x] `npm run package:quiver`
+- [x] `npm run smoke:create-quiver`
+- [x] `git diff --check`
+
+## Pending
+
+- No pending work for this slice.
+
+## Remaining Risks
+
+- Downstream command-specific migrations remain in v38-v43 by design.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-05-foundation-docs-tests-package-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,23 @@
+# EXECUTION_BRIEF - slice-05 Foundation docs, tests, and package readiness
+
+## Context
+
+The foundation changes public CLI behavior and must be documented before later command migration specs start.
+
+## Objective
+
+Update public docs and run validation for the i18n foundation.
+
+## Acceptance Criteria
+
+- `docs/CLI_UX_GUIDE.md` documents language selection and JSON stability.
+- `docs/reference/commands.md` documents `--lang`, `QUIVER_LANG`, and `config language`.
+- Tests cover the foundation in `en`, `es`, no-TTY/CI, `--json`, and `--no-color` where relevant.
+- Package smoke passes.
+
+## Completion Checklist
+
+- [ ] Docs updated.
+- [ ] Full test suite passes.
+- [ ] Package smoke passes.
+- [ ] Spec validation passes.

package/specs/quiver-v37-cli-i18n-foundation/slices/slice-05-foundation-docs-tests-package-readiness/slice.json

@@ -0,0 +1,67 @@
+{
+  "slice_id": "slice-05-foundation-docs-tests-package-readiness",
+  "ticket": "QUIVER-37-05",
+  "type": "validation",
+  "title": "Foundation docs, tests, and package readiness",
+  "objective": "Document and validate the i18n foundation before command migration specs proceed.",
+  "description": "Closes the foundation with docs, full tests, spec validation, and package smoke.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v37-foundation-docs-tests",
+    "branch_name": "feature/QUIVER-37-05-v37-foundation-docs-tests"
+  },
+  "files": [
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "tests/**/*.test.js"
+  ],
+  "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": [
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "tests/**",
+    "specs/quiver-v37-cli-i18n-foundation/**"
+  ],
+  "depends_on": [
+    "slice-02-message-catalog-interpolation",
+    "slice-03-config-language-command",
+    "slice-04-parser-help-error-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This is the closing validation slice for v37.",
+  "must": [
+    "Document the public language contract.",
+    "Run full tests and package smoke.",
+    "Validate the spec package.",
+    "Record evidence."
+  ],
+  "not_included": [
+    "Migrating command groups covered by v38-v42."
+  ],
+  "acceptance": [
+    "Docs explain default language behavior after init/config.",
+    "Docs explain --lang and QUIVER_LANG override behavior.",
+    "Full validation passes.",
+    "Evidence report is updated."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npx create-quiver spec validate specs/quiver-v37-cli-i18n-foundation --strict",
+    "npm run package:quiver",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Do not claim that downstream command groups are migrated until their specs complete."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "completed_at": "2026-05-29T00:00:00.000Z",
+  "blocked_reason": null
+}

package/specs/quiver-v38-cli-i18n-read-only-commands/EVIDENCE_REPORT.md

@@ -0,0 +1,69 @@
+# Evidence Report - Quiver v38 CLI i18n Read-only Commands
+
+## slice-00-read-only-foundation
+
+- Created this spec package and slice handoffs.
+- Runtime implementation intentionally not started.
+
+## slice-01-version-dashboard-help
+
+- Localized `version` human output through the shared `en`/`es` catalog.
+- Localized `dashboard` compact, details, section, warning, and human option-error output.
+- Preserved exact command snippets in dashboard next steps and truncation prompts.
+- Preserved machine-readable `version --json` and `dashboard --json` contracts.
+- Added focused command tests for `version` and expanded dashboard i18n/JSON regression coverage.
+
+Validation:
+
+- Passed: `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`
+- Passed: `node --test tests/**/*.test.js`
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- Passed with expected completed-slice warning: `node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-01-version-dashboard-help/slice.json --local`
+
+## slice-02-flow-doctor-next-graph
+
+- Localized `flow`, `doctor`, `next`, `graph`, and `plan` human output through the shared `en`/`es` catalog.
+- Added shared read-only formatting helpers for statuses, warning prefixes, and human translators.
+- Preserved exact suggested command snippets for `flow` and `next`.
+- Preserved `--json` output contracts by only applying i18n in human formatters.
+- Added focused Spanish coverage for each included command plus warning/blocker localization.
+
+Validation:
+
+- Passed: `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`
+- Passed: `node --test tests/**/*.test.js`
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- Passed with expected completed-slice warning: `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`
+
+## slice-03-ai-inspection-and-export
+
+- Localized AI read-only inspection surfaces for `ai inspect`, `ai specs list`, `ai slices list`, `ai trace report`, `ai status`, `ai resume`, and `ai approvals`.
+- Localized `ai export --format markdown` as human-facing export while keeping `ai export --format json` stable and non-localized.
+- Preserved run ids, spec ids, slice ids, provider/model identifiers, paths, and exact next-command snippets.
+- Added Spanish command coverage for AI inspection/export and run-state surfaces.
+
+Validation:
+
+- Passed: `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`
+- Passed: `node --test tests/**/*.test.js` (562 tests)
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- Passed with expected completed-slice warning: `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`
+
+## slice-04-read-only-tests-smokes
+
+- Validated the complete v38 read-only i18n migration after slices 02 and 03.
+- Confirmed full test suite coverage remains green.
+- Confirmed package and create-quiver smoke flows pass.
+- Confirmed spec and slice handoffs validate after closure updates.
+
+Validation:
+
+- Passed: `node --test tests/**/*.test.js` (562 tests)
+- Passed: `npm run package:quiver`
+- Passed: `npm run smoke:create-quiver`
+- Passed: `git diff --check`
+- Passed: `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- Passed with expected completed-slice warning: `node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-04-read-only-tests-smokes/slice.json --local`

package/specs/quiver-v38-cli-i18n-read-only-commands/EXECUTION_PLAN.md

@@ -0,0 +1,25 @@
+# Execution Plan - Quiver v38 CLI i18n Read-only Commands
+
+## Execution Rules
+
+- Start only after v37 foundation is complete.
+- Keep every `--json` mode non-localized and parseable.
+- Reuse v37 catalog helpers; do not add a second i18n mechanism.
+
+## Suggested Order
+
+1. `slice-00-read-only-foundation`
+2. `slice-01-version-dashboard-help`
+3. `slice-02-flow-doctor-next-graph`
+4. `slice-03-ai-inspection-and-export`
+5. `slice-04-read-only-tests-smokes`
+
+## Final Validation
+
+```bash
+node --test tests/**/*.test.js
+git diff --check
+npx create-quiver spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict
+npm run package:quiver
+npm run smoke:create-quiver
+```

package/specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md

@@ -0,0 +1,52 @@
+# Quiver v38 - CLI i18n Read-only Commands
+
+**Date:** 2026-05-28
+**Status:** Completed
+**Source:** Continuation of the approved CLI i18n program.
+
+## Problem
+
+Read-only commands are the safest first migration after the i18n foundation because they have broad user visibility and low write risk.
+
+## Objective
+
+Migrate Quiver read-only human output to `en` and `es` while preserving JSON contracts and command snippets.
+
+## Scope
+
+### Included
+
+- `version`, `--version`, `--help`.
+- `dashboard`, `flow`, `doctor`, `next`, `graph`, `plan`.
+- `ai inspect`, `ai export`, `ai specs list`, `ai slices list`, `ai trace report`, and `ai approvals`.
+- Human mode, no-TTY/CI, `--no-color`, and supported `--json` modes.
+
+### Excluded
+
+- Commands that write files or call providers; those are covered by later specs.
+- Generated project documentation.
+
+## Acceptance Criteria
+
+1. All included read-only human outputs render in `en` and `es`.
+2. Configured project language is used without requiring `--lang`.
+3. `--lang` and `QUIVER_LANG` overrides work for all included commands.
+4. `--json` output remains parseable and schema-stable.
+5. Suggested commands, flags, ids, paths, provider names, and model ids remain untranslated.
+6. Tests cover both languages for representative normal, empty, warning, and error states.
+
+## Slice Roadmap
+
+| Slice | Title | Status | Dependencies |
+|---|---|---|---|
+| slice-00 | Read-only foundation | completed | none |
+| slice-01 | Version, dashboard, and help | completed | v37 complete |
+| slice-02 | Flow, doctor, next, graph, and plan | completed | slice-01 |
+| slice-03 | AI inspection and export read-only commands | completed | slice-01 |
+| slice-04 | Read-only tests and smokes | completed | slice-02, slice-03 |
+
+## Guardrails
+
+- Do not localize JSON field names or stable codes.
+- Avoid duplicating catalog keys when one domain key is enough.
+- Keep compact dashboard layout readable in both languages.

package/specs/quiver-v38-cli-i18n-read-only-commands/STATUS.md

@@ -0,0 +1,24 @@
+# Status - Quiver v38 CLI i18n Read-only Commands
+
+**Overall status:** Completed
+**Created:** 2026-05-28
+**Completed:** 2026-05-29
+**Current slice:** None
+
+## Summary
+
+This spec migrates read-only command output after the v37 i18n foundation is complete.
+
+## Slice Status
+
+| Slice | Status | Notes |
+|---|---|---|
+| slice-00-read-only-foundation | Completed | Spec package and handoffs created. |
+| slice-01-version-dashboard-help | Completed | `version`, `dashboard`, and existing help i18n paths validated in `en` and `es`; JSON contracts preserved. |
+| slice-02-flow-doctor-next-graph | Completed | `flow`, `doctor`, `next`, `graph`, and `plan` human output localized in `en` and `es`; JSON contracts preserved. |
+| slice-03-ai-inspection-and-export | Completed | AI inspection/export/status/approval human output localized in `en` and `es`; JSON contracts preserved. |
+| slice-04-read-only-tests-smokes | Completed | Full validation, package, smoke, spec validation, and evidence completed. |
+
+## Current Blockers
+
+- None.

package/specs/quiver-v38-cli-i18n-read-only-commands/pr.md

@@ -0,0 +1,119 @@
+## Title
+
+feat: complete v38 read-only CLI i18n
+
+## Summary
+
+- Completes the v38 read-only command migration to the shared `en`/`es` i18n catalog.
+- Localizes human output for `flow`, `doctor`, `next`, `graph`, `plan`, and AI read-only inspection/export/status surfaces.
+- Preserves JSON contracts, ids, paths, provider/model names, and exact suggested command snippets.
+- Closes v38 with full tests, package smoke, create-quiver smoke, spec validation, slice validation, and evidence.
+
+## Scope
+
+- Included: `flow`, `doctor`, `next`, `graph`, `plan` human output in `en` and `es`.
+- Included: `ai inspect`, `ai export --format markdown`, `ai specs list`, `ai slices list`, `ai trace report`, `ai status`, `ai resume`, and `ai approvals` human output in `en` and `es`.
+- Included: shared read-only formatting helpers for status labels, warning prefixes, and human translators.
+- Included: focused command tests plus full v38 evidence and handoff closure.
+- Excluded: write commands, provider-backed AI execution, generated project docs, and v44 TUI-lite work.
+
+## Files
+
+- `src/create-quiver/index.js`
+- `src/create-quiver/commands/ai.js`
+- `src/create-quiver/commands/flow.js`
+- `src/create-quiver/commands/graph.js`
+- `src/create-quiver/commands/next.js`
+- `src/create-quiver/commands/plan.js`
+- `src/create-quiver/lib/ai/export-state.js`
+- `src/create-quiver/lib/ai/run-state.js`
+- `src/create-quiver/lib/i18n/messages/en.js`
+- `src/create-quiver/lib/i18n/messages/es.js`
+- `src/create-quiver/lib/i18n/read-only-format.js`
+- `src/create-quiver/lib/renderers/tree.js`
+- `tests/commands/ai-export.test.js`
+- `tests/commands/ai-run-state.test.js`
+- `tests/commands/doctor.test.js`
+- `tests/commands/flow.test.js`
+- `tests/commands/graph.test.js`
+- `tests/commands/next.test.js`
+- `tests/commands/plan.test.js`
+- `specs/quiver-v38-cli-i18n-read-only-commands/**`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js and npm available.
+- Repository dependencies installed.
+- `gh` available only for PR creation, not for runtime validation.
+
+### Worktree Access
+
+- Worktree: `/Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/quiver-v38-02`
+- Branch: `feature/QUIVER-38-02-v38-flow-doctor-next-graph`
+- Base: `main`
+
+### Run the Project
+
+```bash
+node bin/create-quiver.js flow --lang es
+node bin/create-quiver.js doctor --lang es
+node bin/create-quiver.js next --lang es --json
+node bin/create-quiver.js graph --lang es
+node bin/create-quiver.js plan --lang es
+node bin/create-quiver.js ai inspect --lang es
+node bin/create-quiver.js ai specs list --lang es
+node bin/create-quiver.js ai slices list --lang es
+node bin/create-quiver.js ai trace report --lang es
+node bin/create-quiver.js ai export --format markdown --lang es
+node bin/create-quiver.js ai export --format json --lang es
+node bin/create-quiver.js ai status --lang es
+node bin/create-quiver.js ai resume --lang es
+node bin/create-quiver.js ai approvals --lang es
+```
+
+### Use Cases
+
+- Run included read-only commands with `--lang es` and confirm labels/messages render in Spanish.
+- Run the same commands without `--lang` in a project configured with `"language": "es"` and confirm the configured project language is used.
+- Run included JSON modes and confirm stdout remains parseable JSON without localized field names.
+- Confirm suggested commands, flags, ids, paths, provider names, and model names remain exact and untranslated.
+- Confirm empty, warning, and blocker states render localized human text without changing machine-readable contracts.
+
+### Technical Verification
+
+```bash
+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
+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
+node --test tests/**/*.test.js
+npm run package:quiver
+npm run smoke:create-quiver
+git diff --check
+node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict
+node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-04-read-only-tests-smokes/slice.json --local
+```
+
+## Evidence
+
+- Passed: focused slice-02 command/lib test set.
+- Passed: focused slice-03 AI command/lib test set.
+- Passed: `node --test tests/**/*.test.js` (562 tests).
+- Passed: `npm run package:quiver`.
+- Passed: `npm run smoke:create-quiver`.
+- Passed: `git diff --check`.
+- Passed: strict v38 spec validation.
+- Passed: `check-slice --local` with expected warning because the slice is already marked completed.
+
+## Rollback
+
+- Revert the v38 slice commits in this PR.
+- Re-run `node --test tests/**/*.test.js`.
+- Re-run `npm run package:quiver`.
+- Re-run `npm run smoke:create-quiver`.
+- Re-run `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`.
+
+## Risks / Notes
+
+- AI lifecycle work in later specs should account for the read-only AI status/resume coverage already completed here to avoid duplicate localization work.
+- This PR intentionally does not include or modify `specs/quiver-v44-provider-live-output-tui-lite/`.

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

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