create-quiver 0.15.3 → 0.16.0

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`.

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

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

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

@@ -0,0 +1,53 @@
+{
+  "slice_id": "slice-00-read-only-foundation",
+  "ticket": "QUIVER-38-00",
+  "type": "documentation",
+  "title": "Read-only foundation",
+  "objective": "Create the approved v38 read-only command migration spec package and handoffs.",
+  "description": "Documents how read-only command output will be migrated to en and es.",
+  "git": {
+    "branch_type": "docs",
+    "base_branch": "main",
+    "branch_slug": "v38-read-only-foundation",
+    "branch_name": "docs/QUIVER-38-00-v38-read-only-foundation"
+  },
+  "files": [
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "expected_read_paths": [
+    "docs/INDEX.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "specs/quiver-v37-cli-i18n-foundation/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This creates the roadmap for v38.",
+  "must": [
+    "Create the v38 package.",
+    "Keep runtime code untouched.",
+    "Document dependency on v37."
+  ],
+  "not_included": [
+    "Runtime command migration."
+  ],
+  "acceptance": [
+    "Spec package exists.",
+    "Slice handoffs exist.",
+    "Runtime code is untouched."
+  ],
+  "tests": [
+    "npx create-quiver spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Strict validation requires completed slices to appear in EVIDENCE_REPORT.md."
+  ],
+  "estimated_hours": 1,
+  "status": "completed",
+  "completed_at": "2026-05-28T00:00:00.000Z",
+  "blocked_reason": null
+}

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

@@ -0,0 +1,17 @@
+# CLOSURE_BRIEF - slice-01 Version, dashboard, and help
+
+## Summary
+
+Completed localization for the most visible read-only surfaces in this slice:
+
+- `version` human labels now use the configured CLI language while `version --json` remains stable.
+- `dashboard` compact, detailed, section, warning, and option-error human labels now use `en`/`es` catalog keys while `dashboard --json` remains stable.
+- Existing help localization from the v37 foundation remains covered by command contract tests.
+
+## Validation
+
+- [x] `node --test tests/commands/version.test.js tests/commands/dashboard.test.js tests/commands/cli-contract.test.js tests/lib/version.test.js tests/lib/dashboard.test.js tests/lib/i18n-catalog.test.js tests/lib/i18n-language.test.js`
+- [x] `node --test tests/**/*.test.js`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-01-version-dashboard-help/slice.json --local` (warning expected: slice already completed)

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

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

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

@@ -0,0 +1,69 @@
+{
+  "slice_id": "slice-01-version-dashboard-help",
+  "ticket": "QUIVER-38-01",
+  "type": "feature",
+  "title": "Version, dashboard, and help",
+  "objective": "Localize the most visible read-only CLI surfaces in Spanish and English.",
+  "description": "Migrates version, help, and dashboard human output while preserving JSON contracts.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v38-version-dashboard-help",
+    "branch_name": "feature/QUIVER-38-01-v38-version-dashboard-help"
+  },
+  "files": [
+    "src/create-quiver/lib/version.js",
+    "src/create-quiver/commands/dashboard.js",
+    "src/create-quiver/lib/dashboard.js",
+    "tests/commands/version.test.js",
+    "tests/commands/dashboard.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/i18n/**",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/dashboard.js",
+    "src/create-quiver/lib/version.js",
+    "src/create-quiver/lib/dashboard.js",
+    "src/create-quiver/lib/i18n/**",
+    "tests/commands/version.test.js",
+    "tests/commands/dashboard.test.js",
+    "tests/commands/cli-contract.test.js",
+    "specs/quiver-v38-cli-i18n-read-only-commands/**"
+  ],
+  "depends_on": [
+    "slice-00-read-only-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Establishes command migration patterns for the rest of v38.",
+  "must": [
+    "Localize human output for version, help, and dashboard.",
+    "Keep JSON output stable.",
+    "Preserve exact command snippets.",
+    "Maintain compact dashboard readability."
+  ],
+  "not_included": [
+    "Provider-backed AI commands.",
+    "Generated project docs."
+  ],
+  "acceptance": [
+    "Representative output snapshots pass in en and es.",
+    "JSON tests continue to pass.",
+    "Color/no-color behavior remains correct."
+  ],
+  "tests": [
+    "node --test tests/commands/version.test.js tests/commands/dashboard.test.js tests/commands/cli-contract.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use project config language tests, not only --lang tests.",
+    "Assert Spanish labels do not expand dashboard beyond readable layout assumptions."
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "completed_at": "2026-05-29T00:00:00.000Z",
+  "blocked_reason": null
+}

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/CLOSURE_BRIEF.md

@@ -0,0 +1,13 @@
+# CLOSURE_BRIEF - slice-02 Flow, doctor, next, graph, and plan
+
+## Summary
+
+Implemented shared read-only i18n helpers and localized human output for `flow`, `doctor`, `next`, `graph`, and `plan` while preserving JSON contracts and exact command snippets.
+
+## Validation
+
+- [x] `node --test tests/commands/flow.test.js tests/commands/doctor.test.js tests/commands/next.test.js tests/commands/graph.test.js tests/commands/plan.test.js tests/lib/i18n-catalog.test.js`
+- [x] `node --test tests/**/*.test.js`
+- [x] `git diff --check`
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v38-cli-i18n-read-only-commands --strict`
+- [x] `node bin/create-quiver.js check-slice specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/slice.json --local`

package/specs/quiver-v38-cli-i18n-read-only-commands/slices/slice-02-flow-doctor-next-graph/EXECUTION_BRIEF.md

@@ -0,0 +1,22 @@
+# EXECUTION_BRIEF - slice-02 Flow, doctor, next, graph, and plan
+
+## Context
+
+Workflow status commands guide the user's next action and must be clear in the configured language.
+
+## Objective
+
+Localize `flow`, `doctor`, `next`, `graph`, and `plan` human output.
+
+## Acceptance Criteria
+
+- All included commands render human output in `en` and `es`.
+- Actionable suggested commands remain exact.
+- Warning and blocker labels are localized without changing stable codes.
+- JSON outputs remain stable where supported.
+
+## Completion Checklist
+
+- [x] Command output migrated.
+- [x] Normal, empty, warning, and blocker states tested.
+- [x] JSON regression tests preserved.