@principles/pd-cli 1.73.0

package/dist/services/synthetic-baseline-runner.js

@@ -0,0 +1,251 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { RuntimeStateManager } from '@principles/core/runtime-v2';
+import { SqliteContextAssembler } from '@principles/core/runtime-v2';
+import { SqliteHistoryQuery } from '@principles/core/runtime-v2';
+import { StoreEventEmitter } from '@principles/core/runtime-v2';
+import { DiagnosticianRunner } from '@principles/core/runtime-v2';
+import { PassThroughValidator } from '@principles/core/runtime-v2';
+import { SqliteDiagnosticianCommitter } from '@principles/core/runtime-v2';
+import { TestDoubleRuntimeAdapter } from '@principles/core/runtime-v2';
+import { PainSignalBridge } from '@principles/core/runtime-v2';
+import { CandidateIntakeService } from '@principles/core/runtime-v2';
+import { PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
+import { auditCandidateLedgerConsistency } from '@principles/core/runtime-v2';
+import { OperatorHealthReadModel } from '@principles/core/runtime-v2';
+import { createInternalizationQueueReadModel } from '@principles/core/runtime-v2';
+import { createPITaskDiagnosticJson } from '@principles/core/runtime-v2';
+import { computeOverallStatus, boundedEvidence, truncateReason, recommendNextIssue, makeDeterministicDiagnosticianOutput, } from '@principles/core/runtime-v2';
+export async function runSyntheticBaseline(opts) {
+    const { workspaceDir, workspaceMode, failAfterStage } = opts;
+    const stages = [];
+    const generatedAt = new Date().toISOString();
+    const painId = `synth-pain-${Date.now()}`;
+    const diagnosticianOutput = makeDeterministicDiagnosticianOutput(painId);
+    let stateManager = null;
+    try {
+        const pdDir = path.join(workspaceDir, '.pd');
+        const stateDir = path.join(workspaceDir, '.state');
+        await fs.promises.mkdir(pdDir, { recursive: true });
+        await fs.promises.mkdir(stateDir, { recursive: true });
+        stateManager = new RuntimeStateManager({ workspaceDir });
+        await stateManager.initialize();
+        if (failAfterStage === 'before_pain_intake') {
+            stages.push({
+                name: 'pain_intake',
+                status: 'failed',
+                reason: truncateReason('Injected failure: pain intake stage forced to fail for testing'),
+            });
+            for (const name of ['diagnostician_task_created', 'candidate_created', 'ledger_consistent', 'internalization_queue_ready', 'canary_health']) {
+                stages.push({ name, status: 'failed', reason: 'Prerequisite stage pain_intake failed' });
+            }
+            const status = computeOverallStatus(stages);
+            return { status, workspaceMode, generatedAt, stages, recommendedNextIssue: recommendNextIssue(stages) };
+        }
+        const { connection: sqliteConn, taskStore, runStore } = stateManager;
+        const historyQuery = new SqliteHistoryQuery(sqliteConn);
+        const contextAssembler = new SqliteContextAssembler(taskStore, historyQuery, runStore);
+        const eventEmitter = new StoreEventEmitter();
+        const committer = new SqliteDiagnosticianCommitter(sqliteConn);
+        const validator = new PassThroughValidator();
+        const runtimeAdapter = new TestDoubleRuntimeAdapter({ onFetchOutput: () => ({ runId: `synth-${painId}`, payload: diagnosticianOutput }) }, `diagnosis_${painId}`);
+        const runner = new DiagnosticianRunner({
+            stateManager,
+            contextAssembler,
+            runtimeAdapter,
+            eventEmitter,
+            validator,
+            committer,
+        }, {
+            owner: 'synthetic-baseline',
+            runtimeKind: 'test-double',
+            pollIntervalMs: 50,
+            timeoutMs: 10000,
+        });
+        const ledgerAdapter = new PrincipleTreeLedgerAdapter({ stateDir });
+        const intakeService = new CandidateIntakeService({ stateManager, ledgerAdapter });
+        const bridge = new PainSignalBridge({
+            stateManager,
+            runner,
+            intakeService,
+            ledgerAdapter,
+            autoIntakeEnabled: true,
+        });
+        const bridgeResult = await bridge.onPainDetected({
+            painId,
+            painType: 'tool_failure',
+            source: 'synthetic-baseline',
+            reason: 'Synthetic baseline deterministic pain signal',
+        });
+        const painPassed = bridgeResult.status === 'succeeded';
+        stages.push({
+            name: 'pain_intake',
+            status: painPassed ? 'passed' : 'failed',
+            ...(painPassed ? {} : { reason: truncateReason(bridgeResult.message ?? `PainSignalBridge returned status=${bridgeResult.status}`) }),
+            evidence: boundedEvidence({
+                painId: bridgeResult.painId,
+                bridgeStatus: bridgeResult.status,
+            }),
+        });
+        if (failAfterStage === 'after_pain_intake') {
+            stages.push({ name: 'diagnostician_task_created', status: 'failed', reason: 'Injected failure: forced fail after pain_intake' });
+            stages.push({ name: 'candidate_created', status: 'failed', reason: 'Prerequisite stage diagnostician_task_created failed' });
+            stages.push({ name: 'ledger_consistent', status: 'failed', reason: 'Prerequisite stage candidate_created failed' });
+            stages.push({ name: 'internalization_queue_ready', status: 'failed', reason: 'Prerequisite stage ledger_consistent failed' });
+            stages.push({ name: 'canary_health', status: 'failed', reason: 'Prerequisite stage internalization_queue_ready failed' });
+            const status = computeOverallStatus(stages);
+            return { status, workspaceMode, generatedAt, stages, recommendedNextIssue: recommendNextIssue(stages) };
+        }
+        const { taskId } = bridgeResult;
+        const task = await stateManager.getTask(taskId);
+        const taskPassed = task !== null && task.status === 'succeeded';
+        stages.push({
+            name: 'diagnostician_task_created',
+            status: taskPassed ? 'passed' : 'failed',
+            ...(taskPassed ? {} : { reason: truncateReason(`Task ${taskId} not found or not succeeded. task=${task ? task.status : 'null'}`) }),
+            evidence: boundedEvidence({
+                taskId,
+                taskStatus: task?.status ?? 'not_found',
+            }),
+        });
+        const candidates = await stateManager.getCandidatesByTaskId(taskId);
+        const candidatePassed = candidates.length > 0;
+        stages.push({
+            name: 'candidate_created',
+            status: candidatePassed ? 'passed' : 'failed',
+            ...(candidatePassed ? {} : { reason: truncateReason(`No candidates found for task ${taskId}`) }),
+            evidence: boundedEvidence({
+                candidateCount: candidates.length,
+                candidateIds: candidates.map(c => c.candidateId).slice(0, 5),
+            }),
+        });
+        if (failAfterStage === 'after_candidate_created') {
+            stages.push({ name: 'ledger_consistent', status: 'failed', reason: 'Injected failure: forced fail after candidate_created' });
+            stages.push({ name: 'internalization_queue_ready', status: 'failed', reason: 'Prerequisite stage ledger_consistent failed' });
+            stages.push({ name: 'canary_health', status: 'failed', reason: 'Prerequisite stage internalization_queue_ready failed' });
+            const status = computeOverallStatus(stages);
+            return { status, workspaceMode, generatedAt, stages, recommendedNextIssue: recommendNextIssue(stages) };
+        }
+        const auditResult = await auditCandidateLedgerConsistency(workspaceDir);
+        const ledgerPassed = auditResult.status === 'ok';
+        stages.push({
+            name: 'ledger_consistent',
+            status: ledgerPassed ? 'passed' : 'failed',
+            ...(ledgerPassed ? {} : { reason: truncateReason(`Ledger audit status=${auditResult.status}. orphanCandidates=${auditResult.orphanCandidateCount} missingLedger=${auditResult.missingLedgerCount}`) }),
+            evidence: boundedEvidence({
+                auditStatus: auditResult.status,
+                consumedCount: auditResult.consumedCount,
+                orphanCandidateCount: auditResult.orphanCandidateCount,
+                missingLedgerCount: auditResult.missingLedgerCount,
+            }),
+        });
+        if (failAfterStage === 'after_ledger_consistent') {
+            stages.push({ name: 'internalization_queue_ready', status: 'failed', reason: 'Injected failure: forced fail after ledger_consistent' });
+            stages.push({ name: 'canary_health', status: 'failed', reason: 'Prerequisite stage internalization_queue_ready failed' });
+            const status = computeOverallStatus(stages);
+            return { status, workspaceMode, generatedAt, stages, recommendedNextIssue: recommendNextIssue(stages) };
+        }
+        const piTaskId = `synth-dreamer-${Date.now()}`;
+        await stateManager.createTask({
+            taskId: piTaskId,
+            taskKind: 'dreamer',
+            status: 'pending',
+            attemptCount: 0,
+            maxAttempts: 3,
+            diagnosticJson: createPITaskDiagnosticJson({
+                dependencyTaskIds: [],
+                channel: 'prompt',
+                timeoutMs: 300_000,
+                inputArtifactRefs: [],
+                outputArtifactRefs: [],
+            }),
+        });
+        const { readModel: queueReadModel, close: queueClose } = await createInternalizationQueueReadModel({
+            workspaceDir,
+            readonly: true,
+        });
+        try {
+            const queueSnapshot = await queueReadModel.getSnapshot();
+            const queueReady = queueSnapshot.readyTasks.length > 0;
+            stages.push({
+                name: 'internalization_queue_ready',
+                status: queueReady ? 'passed' : 'failed',
+                ...(queueReady ? {} : { reason: truncateReason(`Queue has no ready tasks. pendingCount=${queueSnapshot.pendingCount} noReadyTasks=${queueSnapshot.noReadyTasks?.reason ?? 'n/a'}`) }),
+                evidence: boundedEvidence({
+                    readyCount: queueSnapshot.readyTasks.length,
+                    pendingCount: queueSnapshot.pendingCount,
+                    noReadyReason: queueSnapshot.noReadyTasks?.reason ?? null,
+                }),
+            });
+        }
+        catch (err) {
+            stages.push({
+                name: 'internalization_queue_ready',
+                status: 'failed',
+                reason: truncateReason(`Queue read model failed: ${err instanceof Error ? err.message : String(err)}`),
+            });
+        }
+        finally {
+            await queueClose();
+        }
+        const healthModel = new OperatorHealthReadModel({ workspaceDir });
+        try {
+            const healthSnapshot = await healthModel.getSnapshot();
+            const healthPassed = healthSnapshot.overallStatus === 'healthy' || healthSnapshot.overallStatus === 'degraded';
+            stages.push({
+                name: 'canary_health',
+                status: healthPassed ? 'passed' : 'failed',
+                ...(healthPassed ? {} : { reason: truncateReason(`Operator health: ${healthSnapshot.overallStatus}. Actions: ${healthSnapshot.recommendedActions.join('; ')}`) }),
+                evidence: boundedEvidence({
+                    overallStatus: healthSnapshot.overallStatus,
+                    recommendedActions: healthSnapshot.recommendedActions.slice(0, 3),
+                }),
+            });
+        }
+        catch (err) {
+            stages.push({
+                name: 'canary_health',
+                status: 'failed',
+                reason: truncateReason(`Health read model failed: ${err instanceof Error ? err.message : String(err)}`),
+            });
+        }
+        finally {
+            await healthModel.close();
+        }
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const stageNames = [
+            'pain_intake',
+            'diagnostician_task_created',
+            'candidate_created',
+            'ledger_consistent',
+            'internalization_queue_ready',
+            'canary_health',
+        ];
+        const existingNames = new Set(stages.map(s => s.name));
+        for (const name of stageNames) {
+            if (!existingNames.has(name)) {
+                stages.push({
+                    name,
+                    status: 'failed',
+                    reason: truncateReason(`Unexpected error: ${errorMessage}`),
+                });
+            }
+        }
+    }
+    finally {
+        if (stateManager) {
+            await stateManager.close();
+        }
+    }
+    const status = computeOverallStatus(stages);
+    return {
+        status,
+        workspaceMode,
+        generatedAt,
+        stages,
+        recommendedNextIssue: recommendNextIssue(stages),
+    };
+}
+//# sourceMappingURL=synthetic-baseline-runner.js.map

package/dist/services/synthetic-baseline-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-baseline-runner.js","sourceRoot":"","sources":["../../src/services/synthetic-baseline-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@principles/pd-cli",
+  "version": "1.73.0",
+  "description": "PD CLI — Pain recording, sample management, and evolution tasks",
+  "type": "module",
+  "bin": {
+    "pd": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepack": "npm run build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@principles/core": "^1.73.0",
+    "commander": "^12.0.0",
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/csuzngjh/principles.git",
+    "directory": "packages/pd-cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/commands/artifact.ts

@@ -0,0 +1,82 @@
+/**
+ * pd artifact show command — Artifact registry inspection.
+ *
+ * Usage:
+ *   pd artifact show <artifactId> --workspace <path> [--json]
+ */
+import {
+  RuntimeStateManager,
+  artifactShow,
+} from '@principles/core/runtime-v2';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+
+interface ArtifactShowOptions {
+  artifactId: string;
+  workspace?: string;
+  json?: boolean;
+}
+
+/**
+ * pd artifact show <artifactId> [--workspace <path>] [--json]
+ *
+ * Shows artifact content and its associated principle candidates.
+ * Returns: artifactId, runId, taskId, artifactKind, contentJson, createdAt, candidates[].
+ */
+export async function handleArtifactShow(opts: ArtifactShowOptions): Promise<void> {
+  const workspaceDir: string = resolveWorkspaceDir(opts.workspace);
+  const stateManager = new RuntimeStateManager({ workspaceDir });
+
+  try {
+    await stateManager.initialize();
+
+    const result = await artifactShow({
+      artifactId: opts.artifactId,
+      stateManager,
+    });
+
+    if (!result) {
+      console.error(`Artifact not found: ${opts.artifactId}`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    console.log(`\nArtifact: ${result.artifactId}\n`);
+    console.log(`  Kind:       ${result.artifactKind}`);
+    console.log(`  Run:        ${result.runId}`);
+    console.log(`  Task:       ${result.taskId}`);
+    console.log(`  Created:    ${result.createdAt}`);
+    console.log(`  Candidates: ${result.candidates.length}`);
+
+    // Pretty-print the JSON content
+    try {
+      const parsed = JSON.parse(result.contentJson);
+      console.log(`\n  Content (parsed):`);
+      console.log(`    diagnosisId: ${parsed.diagnosisId ?? 'N/A'}`);
+      console.log(`    summary:     ${parsed.summary ?? 'N/A'}`);
+      if (parsed.recommendations) {
+        console.log(`    recommendations: ${parsed.recommendations.length}`);
+        const principles = parsed.recommendations.filter((r: { kind: string }) => r.kind === 'principle');
+        if (principles.length > 0) {
+          console.log(`      (${principles.length} principle candidates)`);
+        }
+      }
+    } catch {
+      console.log(`  Content:    ${result.contentJson.substring(0, 200)}...`);
+    }
+
+    if (result.candidates.length > 0) {
+      console.log(`\n  Candidate Details:`);
+      for (const c of result.candidates) {
+        console.log(`    - ${c.candidateId} | ${c.title} | ${c.status}`);
+      }
+    }
+
+    console.log('');
+  } finally {
+    await stateManager.close();
+  }
+}