create-quiver 0.15.2 → 0.15.4

package/specs/quiver-v34-cli-dashboard-status/pr.md

@@ -0,0 +1,99 @@
+## Title
+
+Quiver v34: CLI dashboard status
+
+## Summary
+
+- Adds a read-only `dashboard` command for consolidated Quiver project state.
+- Shows specs, slices, global progress, visible progress, next ready work, blockers, warnings, approvals, agents, active-slice state, runs, evidence counts, and next safe commands.
+- Keeps the dashboard CLI-first and script-safe: no Ink, no prompts, no provider execution, no writes.
+- Adds compact `dashboard --json` output with a stable schema.
+- Adds docs, generated scripts, tests, smokes, and release-readiness evidence.
+
+## Scope
+
+- Dashboard report contract.
+- Human and JSON dashboard output.
+- Top-level CLI command routing and help.
+- Edge-case handling for missing specs, invalid graphs, legacy/incomplete layouts, no-spec states, no-color, CI/no-TTY, and evidence/log redaction.
+- Docs, generated templates, package scripts, tests, and evidence.
+
+## Files
+
+- `README.md`
+- `README_FOR_AI.md`
+- `docs/CLI_UX_GUIDE.md`
+- `docs/reference/commands.md`
+- `src/create-quiver/commands/dashboard.js`
+- `src/create-quiver/index.js`
+- `src/create-quiver/lib/dashboard.js`
+- `src/create-quiver/lib/init-docs.js`
+- `tests/commands/dashboard.test.js`
+- `tests/commands/cli-contract.test.js`
+- `tests/commands/ux-flags.test.js`
+- `tests/lib/dashboard.test.js`
+- `tests/lib/init-docs.test.js`
+- `tests/lib/init-layout.test.js`
+- `specs/quiver-v34-cli-dashboard-status/**`
+
+## How to Test (DETAILED - REQUIRED)
+
+### Required Environment
+
+- Node.js and npm.
+- No provider credentials are required.
+- No GitHub credentials are required.
+
+### Worktree Access
+
+- One dedicated branch/worktree for `quiver-v34-cli-dashboard-status`.
+- One commit per slice.
+
+### Use Cases
+
+- Run `npx create-quiver dashboard` in a project with specs and slices.
+- Run `npx create-quiver dashboard --json` and parse stdout as JSON.
+- Run `npx create-quiver dashboard --spec <slug>` for an existing spec.
+- Run `npx create-quiver dashboard --spec missing-spec` and verify actionable failure.
+- Run `npx create-quiver dashboard --include-completed` and verify completed slices are visible while global progress remains correct.
+- Run in legacy/incomplete/no-spec/no-slice fixtures and verify useful output without crashes.
+- Run with no-color/CI/no-TTY conditions and verify no prompts, spinners, or color-only semantics.
+
+### Technical Verification
+
+- `node --test tests/lib/dashboard.test.js`
+- `node --test tests/commands/dashboard.test.js`
+- `node --test tests/commands/cli-contract.test.js tests/commands/ux-flags.test.js`
+- `node --test tests/lib/ai-export-state.test.js tests/commands/ai-export.test.js`
+- `node --test tests/lib/init-docs.test.js tests/lib/init-layout.test.js`
+- `node --test tests/**/*.test.js`
+- `npm run smoke:create-quiver`
+- `npm run smoke:doctor-fixtures`
+- `npm run smoke:guided-workflow`
+- `npm run package:quiver`
+- `git diff --check`
+- `node bin/create-quiver.js spec validate specs/quiver-v34-cli-dashboard-status`
+
+## Evidence
+
+- `node --test tests/lib/dashboard.test.js tests/commands/dashboard.test.js tests/commands/cli-contract.test.js tests/commands/ux-flags.test.js tests/lib/init-layout.test.js tests/lib/init-docs.test.js` passed.
+- `node --test` passed: 511 tests.
+- `npm run smoke:create-quiver` passed.
+- `npm run smoke:doctor-fixtures` passed: 13 states.
+- `npm run smoke:guided-workflow` passed.
+- `npm run package:quiver` passed: `create-quiver-0.15.2.tgz`.
+- `node bin/create-quiver.js dashboard --json --spec quiver-v34-cli-dashboard-status` passed.
+- `git diff --check` passed.
+- `node bin/create-quiver.js spec validate specs/quiver-v34-cli-dashboard-status` passed.
+
+## Rollback
+
+Revert slice commits in reverse order. The dashboard is additive and read-only, so rollback should not affect existing workflow commands if done by slice.
+
+## Risks / Notes
+
+- Dashboard progress must distinguish global progress from visible filtered progress.
+- `dashboard --json` must stay compact and must not duplicate the full `ai export` contract.
+- Graph errors must not break the entire dashboard.
+- Evidence/log content must not be printed.
+- This PR does not publish npm.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-00-dashboard-foundation/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-00 Dashboard foundation
+
+## Summary
+
+Created the v34 spec package for the CLI dashboard status feature. This foundation is documentation-only and does not implement product behavior.
+
+## Validation
+
+- [x] Slice JSON parse command passed for 6 slice files.
+- [x] `node bin/create-quiver.js spec validate specs/quiver-v34-cli-dashboard-status` passed.
+- [x] `git diff --check` passed.
+
+## Pending
+
+- Execute `slice-01-dashboard-report-contract`.
+
+## Remaining Risks
+
+- None critical for the foundation package.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-00-dashboard-foundation/EXECUTION_BRIEF.md

@@ -0,0 +1,49 @@
+# EXECUTION_BRIEF - slice-00 Dashboard foundation
+
+## Context
+
+The user approved a read-only CLI dashboard initiative after acceptance criteria and production-plan review. The repository already has lifecycle export state and CLI UX rules, so this foundation slice only creates the durable spec package.
+
+## Objective
+
+Create the v34 spec package for `quiver dashboard` without changing product code.
+
+## Scope
+
+- `specs/quiver-v34-cli-dashboard-status/**`
+
+## Acceptance Criteria
+
+- `SPEC.md`, `STATUS.md`, `EVIDENCE_REPORT.md`, `EXECUTION_PLAN.md`, and `pr.md` exist.
+- Every slice has `slice.json`, `EXECUTION_BRIEF.md`, and `CLOSURE_BRIEF.md`.
+- The approved acceptance criteria and reviewed technical plan are captured.
+- No product code is modified.
+
+## Technical Plan Summary
+
+Create a complete spec package following the existing `specs/quiver-vNN-*` pattern. Mark this foundation slice completed and leave implementation slices ready/planned.
+
+## Suggested Steps
+
+1. Create the spec directory and top-level documents.
+2. Create all slice directories and handoffs.
+3. Validate every `slice.json`.
+4. Validate the spec package.
+5. Record evidence.
+
+## Restrictions
+
+- Do not implement the dashboard.
+- Do not update root README or command docs in this slice.
+- Do not claim npm publication.
+
+## Risks
+
+- Missing handoffs would block future executor agents.
+
+## Completion Checklist
+
+- [ ] Spec package created.
+- [ ] Slice handoffs created.
+- [ ] Slice JSON files parse.
+- [ ] Spec validation passes.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-00-dashboard-foundation/slice.json

@@ -0,0 +1,68 @@
+{
+  "slice_id": "slice-00-dashboard-foundation",
+  "ticket": "QUIVER-34-00",
+  "type": "docs",
+  "title": "Dashboard foundation",
+  "objective": "Create the v34 spec package for the read-only CLI dashboard status feature.",
+  "description": "Publishes the approved spec, execution plan, PR body, status, evidence report, slice definitions, and handoffs without changing product code.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v34-dashboard-foundation",
+    "branch_name": "feature/QUIVER-34-00-v34-dashboard-foundation"
+  },
+  "files": [
+    "specs/quiver-v34-cli-dashboard-status/**"
+  ],
+  "expected_read_paths": [
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "BACKLOG.md",
+    "docs/CLI_UX_GUIDE.md",
+    "docs/reference/commands.md",
+    "docs/workflows/full-ai-spec-to-pr.md",
+    "specs/quiver-v23-guided-flow-productization/**",
+    "specs/quiver-v29-planner-prepare-context-cli-ux/**",
+    "specs/quiver-v30-interactive-cli-ux-agent-selection/**",
+    "specs/quiver-v33-approval-ux-and-planner-progress/**"
+  ],
+  "allowed_write_paths": [
+    "specs/quiver-v34-cli-dashboard-status/**"
+  ],
+  "depends_on": [],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "slice-00 is the foundation barrier for the spec.",
+  "must": [
+    "Create SPEC.md, STATUS.md, EVIDENCE_REPORT.md, EXECUTION_PLAN.md, and pr.md.",
+    "Create slice.json, EXECUTION_BRIEF.md, and CLOSURE_BRIEF.md for every slice.",
+    "Capture approved acceptance criteria, review findings, and technical plan.",
+    "Avoid product code changes."
+  ],
+  "not_included": [
+    "Implementing the dashboard command.",
+    "Changing CLI routing.",
+    "Updating public docs outside this spec package.",
+    "Publishing a package."
+  ],
+  "acceptance": [
+    "Spec folder exists under specs/quiver-v34-cli-dashboard-status.",
+    "Every slice has slice.json, EXECUTION_BRIEF.md, and CLOSURE_BRIEF.md.",
+    "Every slice.json parses successfully.",
+    "Spec validation passes.",
+    "No product code is modified."
+  ],
+  "tests": [
+    "git diff --check",
+    "find specs/quiver-v34-cli-dashboard-status -name \"slice.json\" -print -exec node -e \"JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'))\" {} \\;",
+    "node bin/create-quiver.js spec validate specs/quiver-v34-cli-dashboard-status"
+  ],
+  "validation_hints": [
+    "Keep this slice documentation-only.",
+    "Do not claim implementation or package publication."
+  ],
+  "estimated_hours": 2,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 2,
+  "completed_at": "2026-05-28"
+}

package/specs/quiver-v34-cli-dashboard-status/slices/slice-01-dashboard-report-contract/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-01 Dashboard report contract
+
+## Summary
+
+Implemented the compact dashboard report contract in `src/create-quiver/lib/dashboard.js`. The report exposes schema version 1, global vs visible progress, filtered specs/slices, next-ready work, blockers, warnings, agents, approvals, active-slice reconciliation, run summaries, evidence counts, and next safe commands without leaking raw evidence values.
+
+## Validation
+
+- [x] `node --test tests/lib/dashboard.test.js`
+- [x] `node --test tests/lib/ai-export-state.test.js tests/commands/ai-export.test.js` covered by full `node --test`.
+- [x] `git diff --check`
+
+## Pending
+
+- None for this slice.
+
+## Remaining Risks
+
+- None critical.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-01-dashboard-report-contract/EXECUTION_BRIEF.md

@@ -0,0 +1,53 @@
+# EXECUTION_BRIEF - slice-01 Dashboard report contract
+
+## Context
+
+`ai export --format json` already exposes lifecycle state and a `dashboard` subobject, but the new public dashboard needs a compact purpose-built contract. It must not become a second source of truth.
+
+## Objective
+
+Create the dashboard report model that future command rendering can consume.
+
+## Scope
+
+- `src/create-quiver/lib/dashboard.js`
+- compatible helper extraction in `src/create-quiver/lib/ai/export-state.js` if needed
+- focused model tests
+
+## Acceptance Criteria
+
+- Report includes `dashboard_schema_version: 1`.
+- Report includes `summary`, `global_progress`, `visible_progress`, `next_ready`, `specs`, `slices`, `agents`, `approvals`, `active_slice`, `blockers`, `warnings`, and `next_steps`.
+- Global progress includes completed slices even when visible work hides them.
+- Visible progress respects `--spec` and `--include-completed`.
+- Evidence and run details are summarized without raw logs or evidence values.
+- Missing data is represented with stable nulls/empty arrays rather than crashes.
+
+## Technical Plan Summary
+
+Build pure dashboard helpers on top of existing lifecycle export and project-state resolver data. Keep CLI routing and formatting out of this slice.
+
+## Suggested Steps
+
+1. Define the compact report shape.
+2. Add report construction from existing export state.
+3. Add global vs visible progress calculation.
+4. Add safe evidence/run summaries.
+5. Add next-ready derivation where graph data allows it.
+6. Add model tests for default, include-completed, spec filter, missing data, and evidence safety.
+
+## Restrictions
+
+- Do not add top-level command routing.
+- Do not add prompts, spinners, writes, providers, or shell-outs.
+- Do not return the full lifecycle export as dashboard JSON.
+
+## Risks
+
+- Progress can be misleading if global and visible counts are collapsed into one number.
+
+## Completion Checklist
+
+- [ ] Report contract implemented.
+- [ ] Focused tests added.
+- [ ] Existing `ai export` tests still pass.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-01-dashboard-report-contract/slice.json

@@ -0,0 +1,78 @@
+{
+  "slice_id": "slice-01-dashboard-report-contract",
+  "ticket": "QUIVER-34-01",
+  "type": "feature",
+  "title": "Dashboard report contract",
+  "objective": "Create a compact read-only dashboard report contract from existing Quiver lifecycle state.",
+  "description": "Adds the dashboard data model that separates global progress from visible progress, exposes next-ready work, and summarizes state without duplicating lifecycle export or leaking evidence/log content.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v34-dashboard-report-contract",
+    "branch_name": "feature/QUIVER-34-01-v34-dashboard-report-contract"
+  },
+  "files": [
+    "src/create-quiver/lib/dashboard.js",
+    "src/create-quiver/lib/ai/export-state.js",
+    "tests/lib/dashboard.test.js",
+    "tests/lib/ai-export-state.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/lib/ai/export-state.js",
+    "src/create-quiver/lib/project-state-resolver.js",
+    "src/create-quiver/commands/plan.js",
+    "src/create-quiver/commands/next.js",
+    "tests/commands/ai-export.test.js",
+    "tests/lib/ai-export-state.test.js",
+    "specs/quiver-v34-cli-dashboard-status/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/lib/dashboard.js",
+    "src/create-quiver/lib/ai/export-state.js",
+    "tests/lib/dashboard.test.js",
+    "tests/lib/ai-export-state.test.js",
+    "specs/quiver-v34-cli-dashboard-status/**"
+  ],
+  "depends_on": [
+    "slice-00-dashboard-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "The report contract is the dependency for command rendering and edge-case hardening.",
+  "must": [
+    "Use existing lifecycle/export state as the source of truth.",
+    "Define dashboard_schema_version 1.",
+    "Return a compact report, not the full ai export payload.",
+    "Calculate global_progress from all slices.",
+    "Calculate visible_progress from filters such as --spec and --include-completed.",
+    "Summarize evidence and runs without raw log or evidence content.",
+    "Expose next_ready when graph state allows it.",
+    "Preserve existing ai export behavior unless a backwards-compatible helper extraction is needed."
+  ],
+  "not_included": [
+    "Top-level CLI routing.",
+    "Human formatting.",
+    "Generated docs or package scripts.",
+    "Interactive behavior."
+  ],
+  "acceptance": [
+    "Dashboard report includes dashboard_schema_version, summary, global_progress, visible_progress, next_ready, specs, slices, agents, approvals, active_slice, blockers, warnings, and next_steps.",
+    "Completed slices are counted in global_progress even when hidden from visible slices.",
+    "Visible progress changes with --include-completed and --spec filters.",
+    "Evidence/log content is not included in the compact report.",
+    "Report construction does not shell out to the CLI."
+  ],
+  "tests": [
+    "node --test tests/lib/dashboard.test.js",
+    "node --test tests/lib/ai-export-state.test.js tests/commands/ai-export.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Prefer pure functions for report construction.",
+    "Keep the report easy to snapshot and stable for future consumers."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 5,
+  "completed_at": "2026-05-28"
+}

package/specs/quiver-v34-cli-dashboard-status/slices/slice-02-dashboard-command-rendering/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-02 Dashboard command and rendering
+
+## Summary
+
+Added the top-level `dashboard` command, CLI router integration, help/example coverage, human output, JSON output, and UX flag guardrail coverage. The command is read-only, uses no prompts/spinners, and keeps JSON stdout parseable.
+
+## Validation
+
+- [x] `node --test tests/commands/dashboard.test.js`
+- [x] `node --test tests/commands/cli-contract.test.js tests/commands/ux-flags.test.js`
+- [x] `git diff --check`
+
+## Pending
+
+- None for this slice.
+
+## Remaining Risks
+
+- None critical.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-02-dashboard-command-rendering/EXECUTION_BRIEF.md

@@ -0,0 +1,53 @@
+# EXECUTION_BRIEF - slice-02 Dashboard command and rendering
+
+## Context
+
+The report contract exists from slice-01. This slice makes it available through the CLI.
+
+## Objective
+
+Add `npx create-quiver dashboard` with human and JSON output.
+
+## Scope
+
+- `src/create-quiver/commands/dashboard.js`
+- `src/create-quiver/index.js`
+- focused command tests
+
+## Acceptance Criteria
+
+- `dashboard` is a supported top-level command.
+- `dashboard --json` emits parseable compact JSON.
+- Human output shows project, progress, next ready slice, blockers, approvals, agents, active slice, and next steps where available.
+- `--spec`, `--include-completed`, and `--no-color` are passed to the report/formatting layer.
+- `--interactive`, `--review`, and `--with-planner` are rejected.
+- Help output documents the command.
+
+## Technical Plan Summary
+
+Add a command wrapper that calls the dashboard report helpers and formats either compact JSON or human output. Integrate the command into the central parser/router/help.
+
+## Suggested Steps
+
+1. Add `commands/dashboard.js`.
+2. Add `dashboard` to supported modes.
+3. Add usage/help/example entries.
+4. Wire options into `runDashboard`.
+5. Add command tests for human output, JSON, filters, no-color, and unsupported UX flags.
+
+## Restrictions
+
+- Do not perform writes.
+- Do not start slices.
+- Do not prompt.
+- Do not use Ink.
+
+## Risks
+
+- Central CLI router changes can regress help or unsupported-command behavior.
+
+## Completion Checklist
+
+- [ ] Command implemented.
+- [ ] Help updated.
+- [ ] Command tests pass.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-02-dashboard-command-rendering/slice.json

@@ -0,0 +1,82 @@
+{
+  "slice_id": "slice-02-dashboard-command-rendering",
+  "ticket": "QUIVER-34-02",
+  "type": "feature",
+  "title": "Dashboard command and rendering",
+  "objective": "Expose the dashboard report through a top-level CLI command with human and JSON output.",
+  "description": "Adds `npx create-quiver dashboard`, compact JSON output, human rendering, CLI help, examples, and UX flag guardrail coverage.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v34-dashboard-command-rendering",
+    "branch_name": "feature/QUIVER-34-02-dashboard-command-rendering"
+  },
+  "files": [
+    "src/create-quiver/commands/dashboard.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/dashboard.js",
+    "tests/commands/dashboard.test.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/commands/ux-flags.test.js"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/cli/ux.js",
+    "src/create-quiver/lib/cli/theme.js",
+    "src/create-quiver/lib/cli/ux-flags.js",
+    "src/create-quiver/lib/dashboard.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/commands/ux-flags.test.js",
+    "specs/quiver-v34-cli-dashboard-status/SPEC.md"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/dashboard.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/lib/dashboard.js",
+    "tests/commands/dashboard.test.js",
+    "tests/commands/cli-contract.test.js",
+    "tests/commands/ux-flags.test.js",
+    "specs/quiver-v34-cli-dashboard-status/**"
+  ],
+  "depends_on": [
+    "slice-01-dashboard-report-contract"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "The public command consumes the report contract and touches the central CLI router.",
+  "must": [
+    "Add top-level `dashboard` routing.",
+    "Support `--json`, `--spec <slug>`, `--include-completed`, and `--no-color`.",
+    "Emit parseable JSON with no human prose in JSON mode.",
+    "Render human output with clear sections and next safe commands.",
+    "Respect no-color and CI/no-TTY output constraints.",
+    "Reject unsupported UX flags through existing guardrails.",
+    "Document the command in help and examples."
+  ],
+  "not_included": [
+    "Interactive navigation.",
+    "Ink or fullscreen TUI.",
+    "Starting slices from the dashboard.",
+    "Docs/templates updates outside help text."
+  ],
+  "acceptance": [
+    "`node bin/create-quiver.js dashboard` prints a human dashboard.",
+    "`node bin/create-quiver.js dashboard --json` emits parseable compact JSON.",
+    "The command is included in `--help` and grouped command descriptions.",
+    "Unsupported UX flags fail early.",
+    "No prompt or spinner is used."
+  ],
+  "tests": [
+    "node --test tests/commands/dashboard.test.js",
+    "node --test tests/commands/cli-contract.test.js tests/commands/ux-flags.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Keep command implementation thin over the dashboard report contract.",
+    "JSON stdout must be clean."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 4,
+  "completed_at": "2026-05-28"
+}

package/specs/quiver-v34-cli-dashboard-status/slices/slice-03-dashboard-edge-cases-and-guardrails/CLOSURE_BRIEF.md

@@ -0,0 +1,19 @@
+# CLOSURE_BRIEF - slice-03 Dashboard edge cases and guardrails
+
+## Summary
+
+Hardened dashboard behavior for explicit missing specs, zero-slice specs, graph cycles, JSON failure output, evidence summary leakage, and no-crash graph fallback. Fixed `project-state-resolver` so `allowGraphErrors` also tolerates cycle errors raised during topological sorting.
+
+## Validation
+
+- [x] `node --test tests/lib/dashboard.test.js tests/commands/dashboard.test.js`
+- [x] Full `node --test` passed.
+- [x] `git diff --check`
+
+## Pending
+
+- None for this slice.
+
+## Remaining Risks
+
+- None critical.

package/specs/quiver-v34-cli-dashboard-status/slices/slice-03-dashboard-edge-cases-and-guardrails/EXECUTION_BRIEF.md

@@ -0,0 +1,54 @@
+# EXECUTION_BRIEF - slice-03 Dashboard edge cases and guardrails
+
+## Context
+
+The dashboard command exists after slice-02. This slice prevents partial-fix behavior in states that real projects hit frequently: old layouts, missing specs, invalid graphs, and sensitive evidence.
+
+## Objective
+
+Make dashboard output trustworthy and resilient across edge cases.
+
+## Scope
+
+- dashboard report helpers
+- dashboard command formatting/error handling
+- focused fixture tests
+
+## Acceptance Criteria
+
+- Missing explicit `--spec` fails actionably.
+- Invalid graph state does not crash the whole dashboard.
+- No specs/no slices still produce useful next steps.
+- Legacy/incomplete layouts show migration guidance.
+- Evidence/log contents are not printed.
+- JSON and human modes stay separate and clean.
+- No-color/CI/no-TTY behavior is readable and prompt-free.
+
+## Technical Plan Summary
+
+Add guardrails and tests around the report/command layers without changing workflow semantics or slice graph internals.
+
+## Suggested Steps
+
+1. Add missing-spec validation.
+2. Add graph-error fallback tests.
+3. Add no-spec/no-slice fixture tests.
+4. Add legacy/incomplete layout fixture tests.
+5. Add evidence/log redaction tests.
+6. Add no-color/CI/no-TTY tests.
+
+## Restrictions
+
+- Do not alter persisted project state.
+- Do not relax existing graph validation semantics outside dashboard fallback behavior.
+- Do not print raw evidence values.
+
+## Risks
+
+- Over-hardening the dashboard can diverge from `ai export`; keep source-of-truth alignment explicit.
+
+## Completion Checklist
+
+- [ ] Edge-case tests pass.
+- [ ] JSON remains parseable.
+- [ ] Sensitive summaries remain bounded.