create-quiver 0.15.2 → 0.15.3

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/src/create-quiver/commands/dashboard.js

@@ -0,0 +1,31 @@
+const {
+  buildErrorPayload,
+  collectDashboardReport,
+  formatHumanDashboard,
+  normalizeDashboardOptions,
+} = require('../lib/dashboard');
+
+function runDashboard(repoRoot, options = {}) {
+  try {
+    normalizeDashboardOptions(options);
+    const report = collectDashboardReport(repoRoot, options);
+    if (options.json) {
+      process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+      return report;
+    }
+
+    process.stdout.write(formatHumanDashboard(report, options));
+    return report;
+  } catch (error) {
+    if (options.json) {
+      process.stdout.write(`${JSON.stringify(buildErrorPayload(error), null, 2)}\n`);
+      process.exitCode = 1;
+      return null;
+    }
+    throw error;
+  }
+}
+
+module.exports = {
+  runDashboard,
+};

package/src/create-quiver/index.js

@@ -35,6 +35,7 @@ const {
   runSpecsList: runAiSpecsList,
   runTraceReport: runAiTraceReport,
 } = require('./commands/ai');
+const { runDashboard } = require('./commands/dashboard');
 const { runDemo } = require('./commands/demo');
 const { runPrepare } = require('./commands/prepare');
 const { runEvidence } = require('./commands/evidence');
@@ -43,6 +44,7 @@ const { runGraph } = require('./commands/graph');
 const { runNext } = require('./commands/next');
 const { runPlan } = require('./commands/plan');
 const { runCreateSpec, runValidateSpec } = require('./commands/spec');
+const { collectVersionReport, formatHumanVersionReport } = require('./lib/version');
 const { buildInitLayout, formatInitLayoutPlan } = require('./lib/init-layout');
 const {
   formatInstallSelfCommand,
@@ -82,7 +84,9 @@ function formatError(message) {
 
 const SUPPORTED_COMMAND_MODES = new Set([
   'init',
+  'version',
   'flow',
+  'dashboard',
   'plan',
   'graph',
   'next',
@@ -152,6 +156,8 @@ const COMMAND_HELP_GROUPS = [
       ['analyze', 'Scan the project and write docs/PROJECT_MAP.md plus .quiver scan data.'],
       ['doctor', 'Validate the Quiver layout, generated docs, environment, and next safe steps.'],
       ['flow', 'Show the read-only guided workflow stage, blockers, and next safe command.'],
+      ['dashboard', 'Show compact read-only project, spec, slice, run, approval, and agent status.'],
+      ['version', 'Show a Quiver-branded version report; use --json for metadata.'],
       ['prepare', 'Run setup diagnostics for providers, GitHub, SSH, and project readiness.'],
       ['migrate', 'Upgrade an already initialized Quiver project to the current contract.'],
     ],
@@ -251,6 +257,8 @@ function printUsage() {
   npx create-quiver init [options]
   npx create-quiver analyze [options]
   npx create-quiver flow [options]
+  npx create-quiver dashboard [options]
+  npx create-quiver version [--json]
   npx create-quiver plan [options]
   npx create-quiver ai <task> [options]
   npx create-quiver ai run create --input <requirements.md>
@@ -294,12 +302,15 @@ ${formatCommandHelpGroups()}
 Options:
   -n, --name <project-name>   Project name to generate
   -d, --dir <target-dir>      Target directory to scaffold into or inspect
-      --spec <slug>           Restrict plan output to one spec
+      --spec <slug>           Restrict plan, graph, next, or dashboard output to one spec
       --format <name>         Graph or AI export output format (tree, mermaid, dot, json, markdown)
       --show-conflicts        Show shared file paths in graph output
       --level <n>             Restrict graph output to one level
       --json                  Emit machine-readable JSON
-      --include-completed     Include completed slices in plan, graph, or next history output
+      --include-completed     Include completed slices in dashboard, plan, graph, or next history output
+      --details               Show the full human dashboard report
+      --section <name>        Show one human dashboard section
+      --limit <n>             Limit dashboard human lists (1-100)
       --only-ready            Show only slices with no pending dependencies
       --all-ready             List every ready slice returned by next
       --auto-start            Prompt for confirmation and run start-slice on next
@@ -345,6 +356,11 @@ Examples:
   npx create-quiver --name "My Project"
   npx create-quiver --name "My Project" --dir ./my-project
   cd ./my-project && npx create-quiver flow
+  cd ./my-project && npx create-quiver dashboard
+  cd ./my-project && npx create-quiver dashboard --section slices --limit 10
+  cd ./my-project && npx create-quiver dashboard --json
+  cd ./my-project && npx create-quiver version
+  cd ./my-project && npx create-quiver version --json
   cd ./my-project && npx create-quiver analyze
   cd ./my-project && npx create-quiver plan --json
   cd ./my-project && npx create-quiver ai onboard --dry-run
@@ -437,6 +453,10 @@ function parseArgs(argv) {
     interactive: false,
     review: false,
     includeCompleted: false,
+    dashboardDetails: false,
+    dashboardSection: '',
+    dashboardLimit: null,
+    dashboardOptionErrors: [],
     onlyReady: false,
     allReady: false,
     autoStart: false,
@@ -700,6 +720,33 @@ function parseArgs(argv) {
       continue;
     }
 
+    if (arg === '--details') {
+      result.dashboardDetails = true;
+      continue;
+    }
+
+    if (arg === '--section') {
+      const value = args[index + 1];
+      if (!value || String(value).startsWith('--')) {
+        result.dashboardOptionErrors.push('missing value for --section');
+        continue;
+      }
+      result.dashboardSection = value;
+      index += 1;
+      continue;
+    }
+
+    if (arg === '--limit') {
+      const value = args[index + 1];
+      if (!value || String(value).startsWith('--')) {
+        result.dashboardOptionErrors.push('missing value for --limit');
+        continue;
+      }
+      result.dashboardLimit = value;
+      index += 1;
+      continue;
+    }
+
     if (arg === '--show-conflicts') {
       result.showConflicts = true;
       continue;
@@ -1049,6 +1096,14 @@ function parseArgs(argv) {
     if (positional.length > 0) {
       throw new Error(formatError('flow does not accept positional arguments'));
     }
+  } else if (result.mode === 'version') {
+    if (positional.length > 0) {
+      throw new Error(formatError('version does not accept positional arguments'));
+    }
+  } else if (result.mode === 'dashboard') {
+    if (positional.length > 0) {
+      throw new Error(formatError('dashboard does not accept positional arguments; use --spec <slug>'));
+    }
   } else if (result.mode === 'ai') {
     if (!result.aiCommand && positional.length > 0) {
       result.aiCommand = positional.shift();
@@ -1142,6 +1197,14 @@ function parseArgs(argv) {
     throw new Error(formatError('too many positional arguments'));
   }
 
+  const requestedDashboardFlags = [];
+  if (result.dashboardDetails) requestedDashboardFlags.push('--details');
+  if (result.dashboardSection || result.dashboardOptionErrors.some((error) => error.includes('--section'))) requestedDashboardFlags.push('--section');
+  if (result.dashboardLimit !== null || result.dashboardOptionErrors.some((error) => error.includes('--limit'))) requestedDashboardFlags.push('--limit');
+  if (result.mode !== 'dashboard' && requestedDashboardFlags.length > 0) {
+    throw new Error(formatError(`${requestedDashboardFlags.join(', ')} ${requestedDashboardFlags.length === 1 ? 'is' : 'are'} only supported by dashboard. Use: npx create-quiver dashboard ${requestedDashboardFlags[0]}${requestedDashboardFlags[0] === '--section' ? ' <name>' : requestedDashboardFlags[0] === '--limit' ? ' <n>' : ''}`));
+  }
+
   return result;
 }
 
@@ -2827,6 +2890,37 @@ async function run(argv) {
     return;
   }
 
+  if (args.mode === 'dashboard') {
+    runDashboard(process.cwd(), {
+      details: args.dashboardDetails,
+      includeCompleted: args.includeCompleted,
+      json: args.json,
+      limit: args.dashboardLimit,
+      noColor: args.noColor,
+      optionErrors: args.dashboardOptionErrors,
+      section: args.dashboardSection,
+      specSlug: args.specSlug,
+    });
+    return;
+  }
+
+  if (args.mode === 'version') {
+    const report = collectVersionReport(process.cwd(), {
+      cliVersion: CLI_VERSION,
+      env: process.env,
+    });
+    if (args.json) {
+      process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    } else {
+      process.stdout.write(formatHumanVersionReport(report, {
+        env: process.env,
+        noColor: args.noColor,
+        stdoutIsTTY: Boolean(process.stdout.isTTY),
+      }));
+    }
+    return;
+  }
+
   if (args.mode === 'plan') {
     runPlan(process.cwd(), {
       includeCompleted: args.includeCompleted,
@@ -3396,6 +3490,7 @@ async function run(argv) {
 module.exports = {
   resolveInteractiveInitOptions,
   runAnalyze,
+  runDashboard,
   runDoctor,
   runFlow,
   runMigrate,

package/src/create-quiver/lib/cli/ux-flags.js

@@ -47,6 +47,12 @@ const UX_FLAG_MATRIX = Object.freeze({
     review: false,
     note: 'execution strategy confirmation and future selectors',
   }),
+  dashboard: Object.freeze({
+    withPlanner: false,
+    interactive: false,
+    review: false,
+    note: 'read-only consolidated project status',
+  }),
 });
 
 function formatError(message) {