@principles/pd-cli 1.73.2 → 1.75.0

package/src/index.ts

@@ -1,6 +1,6 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
- * pd CLI — Principles Disciple command-line interface.
+ * pd CLI 鈥?Principles Disciple command-line interface.
  *
  * Usage:
  *   pd pain record --reason <text> [--score N] [--source manual]
@@ -46,6 +46,7 @@ import { handleRuntimeActivationDispatch } from './commands/runtime-activation.j
 import { handleProvenChannelBaseline } from './commands/proven-channel-baseline.js';
 import { handleDemoStoryA } from './commands/demo-story-a.js';
 import { handleRuntimeFeaturesStatus } from './commands/runtime-features.js';
+import { handleConfigDoctor } from './commands/config-doctor.js';
 
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
@@ -56,7 +57,8 @@ const program = new Command();
 program
   .name('pd')
   .description('PD CLI — Pain recording, sample management, and evolution tasks')
-  .version(pkg.version);
+  .version(pkg.version)
+  .enablePositionalOptions();
 
 const painCmd = program
   .command('pain')
@@ -147,7 +149,7 @@ centralCmd
     await handleCentralSync();
   });
 
-// ── Runtime v2 task/run commands ──────────────────────────────────────────────
+// 鈹€鈹€ Runtime v2 task/run commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const rtTaskCmd = program
   .command('task')
@@ -190,7 +192,7 @@ rtRunCmd
     await handleRunShow({ id: runId });
   });
 
-// ── Runtime v2 trajectory/history/context commands ───────────────────────────
+// 鈹€鈹€ Runtime v2 trajectory/history/context commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const trajectoryCmd = program
   .command('trajectory')
@@ -239,7 +241,7 @@ contextCmd
     await handleContextBuild(taskId, opts);
   });
 
-// ── Legacy import command ───────────────────────────────────────────────────────
+// 鈹€鈹€ Legacy import command 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const legacyCmd = program
   .command('legacy')
@@ -258,7 +260,7 @@ importCmd
     await handleLegacyImportOpenClaw(opts);
   });
 
-// ── Diagnostician run/status commands ─────────────────────────────────────
+// 鈹€鈹€ Diagnostician run/status commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const diagnoseCmd = program
   .command('diagnose')
@@ -283,19 +285,19 @@ diagnoseCmd
   .option('--openclaw-local', 'Use local OpenClaw (mutually exclusive with --openclaw-gateway)')
   .option('--openclaw-gateway', 'Use gateway OpenClaw (mutually exclusive with --openclaw-local)')
   .option('-a, --agent <agentId>', 'Agent ID to invoke')
-  .option('--provider <name>', 'LLM provider (e.g., openrouter) — for pi-ai, falls back to policy')
-  .option('--model <id>', 'Model ID (e.g., anthropic/claude-sonnet-4) — for pi-ai, falls back to policy')
-  .option('--apiKeyEnv <name>', 'Env var name for API key — for pi-ai, falls back to policy')
-  .option('--baseUrl <url>', 'Custom base URL — for pi-ai, falls back to policy')
-  .option('--maxRetries <n>', 'Max retry attempts for LLM failures — for pi-ai, falls back to policy', parseInt)
-  .option('--timeoutMs <ms>', 'Timeout in milliseconds — for pi-ai, falls back to policy', parseInt)
+  .option('--provider <name>', 'LLM provider (e.g., openrouter) 鈥?for pi-ai, falls back to policy')
+  .option('--model <id>', 'Model ID (e.g., anthropic/claude-sonnet-4) 鈥?for pi-ai, falls back to policy')
+  .option('--apiKeyEnv <name>', 'Env var name for API key 鈥?for pi-ai, falls back to policy')
+  .option('--baseUrl <url>', 'Custom base URL 鈥?for pi-ai, falls back to policy')
+  .option('--maxRetries <n>', 'Max retry attempts for LLM failures 鈥?for pi-ai, falls back to policy', parseInt)
+  .option('--timeoutMs <ms>', 'Timeout in milliseconds 鈥?for pi-ai, falls back to policy', parseInt)
   .option('--no-intake', 'Skip candidate intake after successful diagnosis')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
     await handleDiagnoseRun(opts);
   });
 
-// ── Runtime probe command (HG-01 HARD GATE) ─────────────────────────────────
+// 鈹€鈹€ Runtime probe command (HG-01 HARD GATE) 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const runtimeCmd = program
   .command('runtime')
@@ -316,7 +318,7 @@ const synthCmd = runtimeCmd
 
 synthCmd
   .command('baseline')
-  .description('Run synthetic PD workload baseline (PRI-206) — deterministic, no LLM required')
+  .description('Run synthetic PD workload baseline (PRI-206) 鈥?deterministic, no LLM required')
   .option('-w, --workspace <path>', 'Workspace directory (default: temp workspace)')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
@@ -325,7 +327,7 @@ synthCmd
 
 synthCmd
   .command('flood')
-  .description('Run pain flood simulation (PRI-208) — deterministic dedup/stress test, no LLM required')
+  .description('Run pain flood simulation (PRI-208) 鈥?deterministic dedup/stress test, no LLM required')
   .option('-w, --workspace <path>', 'Workspace directory (default: temp workspace)')
   .option('--json', 'Output raw JSON')
   .option('--identical-count <n>', 'Number of identical pain signals (default: 10)', parseInt)
@@ -343,7 +345,7 @@ synthCmd
 
 synthCmd
   .command('proven-channel')
-  .description('Run MVP activation continuity baseline (PRI-240) — deterministic, no LLM required')
+  .description('Run MVP activation continuity baseline (PRI-240) 鈥?deterministic, no LLM required')
   .option('-w, --workspace <path>', 'Workspace directory (default: temp workspace)')
   .option('--json', 'Output raw JSON')
   .option('--channels <channels>', 'Comma-separated channel list (prompt,code_tool_hook,defer_archive)')
@@ -367,13 +369,26 @@ runtimeCmd
     });
   });
 
+const configCmd = program
+  .command('config')
+  .description('PD configuration discovery and diagnosis');
+
+configCmd
+  .command('doctor')
+  .description('Show PD + OpenClaw config locations, feature flags, and provider connectivity (PRI-299)')
+  .option('-w, --workspace <path>', 'Workspace directory')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    await handleConfigDoctor({ workspace: opts.workspace, json: opts.json });
+  });
+
 const demoCmd = program
   .command('demo')
   .description('Demo scenarios for MVP validation');
 
 demoCmd
   .command('story-a')
-  .description('Run Story A\' proven-channel demo (PRI-246) — full evidence→proposal→approval→activation→observation chain')
+  .description('Run Story A\' proven-channel demo (PRI-246) 鈥?full evidence鈫抪roposal鈫抋pproval鈫抋ctivation鈫抩bservation chain')
   .option('-w, --workspace <path>', 'Workspace directory (default: temp workspace)')
   .option('--json', 'Output raw JSON')
   .option('--channels <channels>', 'Comma-separated channel list (prompt,code_tool_hook,defer_archive)')
@@ -392,13 +407,13 @@ runtimeCmd
   .option('--openclaw-local', 'Use local OpenClaw (mutually exclusive with --openclaw-gateway)')
   .option('--openclaw-gateway', 'Use gateway OpenClaw (mutually exclusive with --openclaw-local)')
   .option('-a, --agent <agentId>', 'Agent ID to probe')
-  .option('--provider <name>', 'LLM provider (e.g., openrouter) — for pi-ai, falls back to --workspace workflows.yaml')
-  .option('--model <id>', 'Model ID (e.g., anthropic/claude-sonnet-4) — for pi-ai, falls back to --workspace workflows.yaml')
-  .option('--apiKeyEnv <name>', 'Env var name for API key (e.g., OPENROUTER_API_KEY) — for pi-ai, falls back to --workspace workflows.yaml')
-  .option('--baseUrl <url>', 'Custom base URL for OpenAI-compatible providers — for pi-ai, falls back to --workspace workflows.yaml')
+  .option('--provider <name>', 'LLM provider (e.g., openrouter) 鈥?for pi-ai, falls back to --workspace workflows.yaml')
+  .option('--model <id>', 'Model ID (e.g., anthropic/claude-sonnet-4) 鈥?for pi-ai, falls back to --workspace workflows.yaml')
+  .option('--apiKeyEnv <name>', 'Env var name for API key (e.g., OPENROUTER_API_KEY) 鈥?for pi-ai, falls back to --workspace workflows.yaml')
+  .option('--baseUrl <url>', 'Custom base URL for OpenAI-compatible providers 鈥?for pi-ai, falls back to --workspace workflows.yaml')
   .option('--maxRetries <n>', 'Max retry attempts for LLM failures', parseInt)
   .option('--timeoutMs <ms>', 'Timeout in milliseconds for probe', parseInt)
-  .option('-w, --workspace <path>', 'Workspace directory — loads pi-ai policy from .state/workflows.yaml')
+  .option('-w, --workspace <path>', 'Workspace directory 鈥?loads pi-ai policy from .state/workflows.yaml')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
     await handleRuntimeProbe(opts);
@@ -462,17 +477,17 @@ runtimeHealthCmd
 
 runtimeHealthCmd
   .command('gfi')
-  .description('GFI workspace snapshot — active vs stale session breakdown')
+  .description('GFI workspace snapshot 鈥?active vs stale session breakdown')
   .option('-w, --workspace <path>', 'Workspace directory')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
     await handleRuntimeGfiSnapshot({ workspace: opts.workspace, json: opts.json });
   });
 
-// PRI-82: pd runtime gfi snapshot — canonical operator command (alias of runtime health gfi)
+// PRI-82: pd runtime gfi snapshot 鈥?canonical operator command (alias of runtime health gfi)
 runtimeCmd
   .command('gfi')
-  .description('GFI workspace snapshot — active vs stale session breakdown')
+  .description('GFI workspace snapshot 鈥?active vs stale session breakdown')
   .command('snapshot')
   .description('GFI workspace snapshot for the operator (alias: pd runtime health gfi)')
   .option('-w, --workspace <path>', 'Workspace directory')
@@ -608,7 +623,7 @@ const pruningCmd = runtimeCmd
 
 pruningCmd
   .command('report')
-  .description('Show pruning health report — watch/review principle signals')
+  .description('Show pruning health report 鈥?watch/review principle signals')
   .option('-w, --workspace <path>', 'Workspace directory')
   .option('--json', 'Output raw JSON')
   .action((opts) => {
@@ -679,7 +694,7 @@ pruningCmd
     });
   });
 
-// ── Candidate inspection commands ───────────────────────────────────────────
+// 鈹€鈹€ Candidate inspection commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const candidateCmd = program
   .command('candidate')
@@ -783,7 +798,7 @@ candidateInternalizationCmd
     await handleCandidateInternalizationBackfill({ workspace: opts.workspace, dryRun: opts.dryRun, confirm: opts.confirm, includePending: opts.includePending, json: opts.json });
   });
 
-// ── Artifact inspection commands ────────────────────────────────────────────
+// 鈹€鈹€ Artifact inspection commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const artifactCmd = program
   .command('artifact')
@@ -813,9 +828,18 @@ const _legacyCleanupCmd = legacyCmd
     await handleLegacyCleanup(opts.workspace, apply);
   });
 
-program
+const consoleCmd = program
   .command('console')
-  .description('Start the pd-console web UI for principle review')
+  .description('Start the pd-console web UI for principle review (default: legacy launcher)')
+  .passThroughOptions()
+  .option('-w, --workspace <path>', 'Workspace directory')
+  .option('-p, --port <port>', 'Port to listen on', '3100')
+  .option('--no-auth', 'Disable authentication (local dev only)', false)
+  .option('--json', 'Output JSON status', false);
+
+consoleCmd
+  .command('start')
+  .description('Legacy launcher — start the pd-console on the requested port (no reuse, no browser open)')
   .option('-w, --workspace <path>', 'Workspace directory')
   .option('-p, --port <port>', 'Port to listen on', '3100')
   .option('--no-auth', 'Disable authentication (local dev only)', false)
@@ -825,9 +849,42 @@ program
     await handleConsole({
       workspace: opts.workspace,
       port: opts.port,
-      noAuth: opts.noAuth,
+      noAuth: opts.auth === false,
       json: opts.json,
     });
   });
 
+// PRI-300: seed-friendly Console launcher with reuse + auto-port + browser open
+consoleCmd
+  .command('open')
+  .description('Open the pd-console in your browser (PRI-300) — auto-port, reuses running console, loopback-only')
+  .option('-w, --workspace <path>', 'Workspace directory')
+  .option('-p, --port <port>', 'Preferred port (default 3100; auto-falls back to next free port)')
+  .option('--host <host>', 'Loopback host (default 127.0.0.1; non-loopback refused)')
+  .option('--no-auth', 'Disable authentication (local dev only)', false)
+  .option('--no-browser', 'Do not open the system browser on success', false)
+  .option('--json', 'Output JSON status (suppresses browser open)', false)
+  .action(async (opts) => {
+    const { handleConsoleOpen } = await import('./commands/console.js');
+    await handleConsoleOpen({
+      workspace: opts.workspace,
+      port: opts.port,
+      host: opts.host,
+      noAuth: opts.auth === false,
+      noBrowser: opts.browser === false,
+      json: opts.json,
+    });
+  });
+
+// Default `pd console` → legacy launcher (backward compat)
+consoleCmd.action(async (opts) => {
+  const { handleConsole } = await import('./commands/console.js');
+  await handleConsole({
+    workspace: opts.workspace,
+    port: opts.port,
+    noAuth: opts.auth === false,
+    json: opts.json,
+  });
+});
+
 program.parse();