@principles/pd-cli 1.109.4 → 1.111.0

package/src/index.ts

@@ -1,6 +1,6 @@
 #!/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]
@@ -186,7 +186,7 @@ centralCmd
     await handleCentralSync();
   });
 
-// 鈹€鈹€ Runtime v2 task/run commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+// ── Runtime v2 task/run commands ──────────────────────────────────────────────鈹€鈹€鈹€鈹€鈹€鈹€
 
 const rtTaskCmd = program
   .command('task')
@@ -221,7 +221,7 @@ rtRunCmd
     await handleRunShow({ id: runId });
   });
 
-// 鈹€鈹€ Runtime v2 trajectory/history/context commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+// ── Runtime v2 trajectory/history/context commands ────────────────────────────鈹€鈹€
 
 const trajectoryCmd = program
   .command('trajectory')
@@ -270,7 +270,7 @@ contextCmd
     await handleContextBuild(taskId, opts);
   });
 
-// 鈹€鈹€ Legacy import command 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+// ── Legacy import command ──────────────────────────────────────────────────────鈹€鈹€鈹€鈹€鈹€鈹€鈹€
 
 const legacyCmd = program
   .command('legacy')
@@ -289,7 +289,7 @@ importCmd
     await handleLegacyImportOpenClaw(opts);
   });
 
-// 鈹€鈹€ Diagnostician run/status commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+// ── Diagnostician run/status commands ─────────────────────────────────────────鈹€鈹€鈹€鈹€
 
 const diagnoseCmd = program
   .command('diagnose')
@@ -315,19 +315,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')
@@ -348,7 +348,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) => {
@@ -357,7 +357,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)
@@ -375,7 +375,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)')
@@ -418,7 +418,7 @@ const demoCmd = program
 
 demoCmd
   .command('story-a')
-  .description('Run Story A\' proven-channel demo (PRI-246) 鈥?full evidence鈫抪roposal鈫抋pproval鈫抋ctivation鈫抩bservation chain')
+  .description('Run Story A\'s proven-channel demo (PRI-246) — full evidence→proposal→approval→activation→observation 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)')
@@ -492,19 +492,7 @@ runtimeHealthCmd
 
 runtimeHealthCmd
   .command('gfi')
-  .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)
-runtimeCmd
-  .command('gfi')
-  .description('GFI workspace snapshot 鈥?active vs stale session breakdown')
-  .command('snapshot')
-  .description('GFI workspace snapshot for the operator (alias: pd runtime health gfi)')
+  .description('GFI workspace snapshot — active vs stale session breakdown')
   .option('-w, --workspace <path>', 'Workspace directory')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
@@ -656,7 +644,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) => {
@@ -727,7 +715,7 @@ pruningCmd
     });
   });
 
-// 鈹€鈹€ Candidate inspection commands 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+// ── Candidate inspection commands ─────────────────────────────────────────────
 
 const candidateCmd = program
   .command('candidate')
@@ -831,7 +819,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')

package/src/legacy/session-history-import.ts

@@ -201,31 +201,3 @@ export async function importSessionHistory(
 
   return { sessionsProcessed, entriesImported };
 }
-
-function _buildConversationEntries(
-  assistantTurns: AssistantTurn[],
-  userTurns: UserTurn[],
-  toolCalls: ToolCall[],
-): string {
-  // Interleave and sort by timestamp for a unified view
-  type Entry = { ts: string; role: string; text: string; toolName?: string };
-  const entries: Entry[] = [];
-
-  for (const t of assistantTurns) {
-    entries.push({ ts: t.created_at, role: 'assistant', text: t.sanitized_text });
-  }
-  for (const t of userTurns) {
-    entries.push({ ts: t.created_at, role: 'user', text: t.raw_text ?? '' });
-  }
-  for (const t of toolCalls) {
-    entries.push({
-      ts: t.created_at,
-      role: 'tool',
-      text: `${t.tool_name}: ${t.outcome}${t.error_message ? ` — ${t.error_message}` : ''}`,
-      toolName: t.tool_name,
-    });
-  }
-
-  entries.sort((a, b) => a.ts.localeCompare(b.ts));
-  return JSON.stringify(entries, null, 2);
-}

package/src/utils/production-workspace-guard.ts

@@ -173,18 +173,6 @@ export function getSafeUatWorkspacePath(): string {
   return uatWorkspace;
 }
 
-/**
- * Check if --allow-production-workspace-for-uat flag is set.
- *
- * This is the escape hatch for cases where the operator explicitly wants to run UAT on production.
- * The flag must be very explicit in both name and output (as required by PRI-334).
- */
-export function isProductionWorkspaceAllowed(): boolean {
-  // Check if the flag was parsed and passed through opts
-  // This will be called from command handlers after Commander parses flags
-  return false; // Placeholder; actual check depends on Commander opts
-}
-
 /**
  * Format guard refusal for console output.
  *

package/tests/commands/candidate-audit-repair.test.ts

@@ -97,9 +97,6 @@ vi.mock('@principles/core/runtime-v2', () => ({
   loadLedger: mockLoadLedger,
   getLedgerFilePathPublic: mockGetLedgerFilePath,
   resolveOutputLanguage: vi.fn().mockReturnValue({ outputLanguage: 'zh-CN' }),
-}));
-
-vi.mock('../../src/principle-tree-ledger-adapter.js', () => ({
   PrincipleTreeLedgerAdapter: MockPrincipleTreeLedgerAdapter,
 }));
 

package/tests/commands/candidate-intake.test.ts

@@ -71,9 +71,6 @@ vi.mock('@principles/core/runtime-v2', () => ({
   CandidateIntakeError: MockCandidateIntakeError,
   RuntimeStateManager: MockRuntimeStateManager,
   resolveOutputLanguage: vi.fn().mockReturnValue({ outputLanguage: 'zh-CN' }),
-}));
-
-vi.mock('../../src/principle-tree-ledger-adapter.js', () => ({
   PrincipleTreeLedgerAdapter: MockPrincipleTreeLedgerAdapter,
 }));
 

package/tests/commands/candidate-internalization-backfill.test.ts

@@ -17,19 +17,16 @@ vi.mock('../../src/resolve-workspace.js', () => ({
   resolveWorkspaceDir: vi.fn((workspace?: string) => workspace ?? '/fake/workspace'),
 }));
 
-vi.mock('../../src/principle-tree-ledger-adapter.js', () => ({
-  PrincipleTreeLedgerAdapter: vi.fn().mockImplementation(function () {
-    return {
-      intake: mockIntake,
-      existsForCandidate: mockExistsForCandidate,
-    };
-  }),
-}));
-
 vi.mock('@principles/core/runtime-v2', async (importOriginal) => {
   const original = await importOriginal() as Record<string, unknown>;
   return {
     ...original,
+    PrincipleTreeLedgerAdapter: vi.fn().mockImplementation(function () {
+      return {
+        intake: mockIntake,
+        existsForCandidate: mockExistsForCandidate,
+      };
+    }),
     RuntimeStateManager: vi.fn().mockImplementation(function (opts: Record<string, unknown>) {
       mockRuntimeStateManagerOpts(opts);
       return {

package/tests/commands/diagnose.test.ts

@@ -123,13 +123,10 @@ vi.mock('@principles/core/runtime-v2', () => {
       },
     }),
     status: vi.fn(),
+    PrincipleTreeLedgerAdapter: MockPrincipleTreeLedgerAdapter,
   };
 });
 
-vi.mock('../../src/principle-tree-ledger-adapter.js', () => ({
-  PrincipleTreeLedgerAdapter: MockPrincipleTreeLedgerAdapter,
-}));
-
 vi.mock('../../src/config-reader.js', () => ({
   readOutputLanguageFromWorkspace: vi.fn().mockReturnValue({ outputLanguage: 'zh-CN' }),
 }));

package/tests/commands/pain-retry.test.ts

@@ -130,13 +130,10 @@ vi.mock('@principles/core/runtime-v2', () => {
     redactPdConfig: vi.fn().mockImplementation((c) => c),
     run: mockRun,
     status: vi.fn(),
+    PrincipleTreeLedgerAdapter: MockPrincipleTreeLedgerAdapter,
   };
 });
 
-vi.mock('../../src/principle-tree-ledger-adapter.js', () => ({
-  PrincipleTreeLedgerAdapter: MockPrincipleTreeLedgerAdapter,
-}));
-
 vi.mock('../../src/config-reader.js', () => ({
   readOutputLanguageFromWorkspace: vi.fn().mockReturnValue({ outputLanguage: 'zh-CN' }),
 }));

package/dist/principle-tree-ledger-adapter.d.ts

@@ -1,12 +0,0 @@
-/**
- * Re-exports the canonical PrincipleTreeLedgerAdapter from @principles/core/runtime-v2.
- *
- * This adapter uses @principles/core's addPrincipleToLedger/loadLedger, which write to
- * <stateDir>/principle_training_state.json (HybridLedgerStore format), matching the ledger
- * format used by the OpenClaw plugin's pain-signal-bridge.
- *
- * audit/repair commands use this adapter — it ensures consistency between
- * what intake writes and what audit/repair read back.
- */
-export { PrincipleTreeLedgerAdapter, } from '@principles/core/runtime-v2';
-//# sourceMappingURL=principle-tree-ledger-adapter.d.ts.map

package/dist/principle-tree-ledger-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"principle-tree-ledger-adapter.d.ts","sourceRoot":"","sources":["../src/principle-tree-ledger-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC"}

package/dist/principle-tree-ledger-adapter.js

@@ -1,12 +0,0 @@
-/**
- * Re-exports the canonical PrincipleTreeLedgerAdapter from @principles/core/runtime-v2.
- *
- * This adapter uses @principles/core's addPrincipleToLedger/loadLedger, which write to
- * <stateDir>/principle_training_state.json (HybridLedgerStore format), matching the ledger
- * format used by the OpenClaw plugin's pain-signal-bridge.
- *
- * audit/repair commands use this adapter — it ensures consistency between
- * what intake writes and what audit/repair read back.
- */
-export { PrincipleTreeLedgerAdapter, } from '@principles/core/runtime-v2';
-//# sourceMappingURL=principle-tree-ledger-adapter.js.map

package/dist/principle-tree-ledger-adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"principle-tree-ledger-adapter.js","sourceRoot":"","sources":["../src/principle-tree-ledger-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC"}

package/src/principle-tree-ledger-adapter.ts

@@ -1,13 +0,0 @@
-/**
- * Re-exports the canonical PrincipleTreeLedgerAdapter from @principles/core/runtime-v2.
- *
- * This adapter uses @principles/core's addPrincipleToLedger/loadLedger, which write to
- * <stateDir>/principle_training_state.json (HybridLedgerStore format), matching the ledger
- * format used by the OpenClaw plugin's pain-signal-bridge.
- *
- * audit/repair commands use this adapter — it ensures consistency between
- * what intake writes and what audit/repair read back.
- */
-export {
-  PrincipleTreeLedgerAdapter,
-} from '@principles/core/runtime-v2';