@principles/pd-cli 1.102.0 → 1.103.0

package/dist/commands/runtime-internalization-integrity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-internalization-integrity.d.ts","sourceRoot":"","sources":["../../src/commands/runtime-internalization-integrity.ts"],"names":[],"mappings":"AAKA,UAAU,+BAA+B;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoCD,wBAAsB,qCAAqC,CAAC,IAAI,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhH"}
+{"version":3,"file":"runtime-internalization-integrity.d.ts","sourceRoot":"","sources":["../../src/commands/runtime-internalization-integrity.ts"],"names":[],"mappings":"AAMA,UAAU,+BAA+B;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoCD,wBAAsB,qCAAqC,CAAC,IAAI,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDhH"}

package/dist/commands/runtime-internalization-integrity.js

@@ -1,6 +1,7 @@
 import * as path from 'path';
 import { InternalizationChainIntegrityReadModel } from '@principles/core/runtime-v2';
 import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { assembleMainlineSnapshot } from '../services/mainline-snapshot-assembler.js';
 function formatTextOutput(result) {
     const lines = [];
     const icon = result.overallStatus === 'ok' ? '✓' : result.overallStatus === 'degraded' ? '⚠' : '✗';
@@ -38,7 +39,45 @@ export async function handleRuntimeInternalizationIntegrity(opts) {
     const workspaceDir = opts.workspace
         ? path.resolve(opts.workspace)
         : resolveWorkspaceDir();
-    const model = new InternalizationChainIntegrityReadModel({ workspaceDir });
+    let warnings;
+    let snapshot;
+    try {
+        ({ snapshot, warnings } = await assembleMainlineSnapshot({ workspaceDir }));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        const failure = {
+            overallStatus: 'error',
+            brokenLinks: [{
+                    type: 'mainline_snapshot_assembly_failed',
+                    severity: 'error',
+                    reason: `Failed to assemble mainline snapshot: ${reason}`,
+                    recommendedAction: 'Verify workspace state.db/config and rerun `pd runtime internalization integrity`.',
+                }],
+            chainSummaries: {
+                totalCandidates: 0,
+                totalDreamerTasks: 0,
+                totalPhilosopherTasks: 0,
+                totalPIArtifacts: 0,
+                chainsWithBrokenLinks: 0,
+            },
+            generatedAt: new Date().toISOString(),
+        };
+        if (opts.json) {
+            console.log(JSON.stringify(failure, null, 2));
+        }
+        else {
+            console.error(`FAIL: ${failure.brokenLinks[0].reason}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (!opts.json && warnings.length > 0) {
+        for (const warning of warnings) {
+            console.warn(`Warning: ${warning}`);
+        }
+    }
+    const model = new InternalizationChainIntegrityReadModel({ workspaceDir, mainlineSnapshot: snapshot });
     const result = model.check();
     if (opts.json) {
         console.log(JSON.stringify(result, null, 2));

package/dist/commands/runtime-internalization-integrity.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-internalization-integrity.js","sourceRoot":"","sources":["../../src/commands/runtime-internalization-integrity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-internalization-integrity.js","sourceRoot":"","sources":["../../src/commands/runtime-internalization-integrity.ts"],"names":[],"mappings":"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"}

package/dist/services/mainline-snapshot-assembler.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared MainlineSnapshot assembler (PRI-394)
+ *
+ * I/O-boundary reader that assembles a read-only `MainlineSnapshot` from real
+ * Runtime V2 SQLite state, then hands it to core's pure `assertMainlineContract`.
+ *
+ * Rules:
+ *   - This module lives in pd-cli (I/O boundary). It reads `.pd/state.db` via
+ *     the existing `RuntimeStateManager` / `SqliteConnection` abstractions.
+ *   - It does NOT judge the contract. Judgment lives exclusively in
+ *     `packages/principles-core/src/runtime-v2/mainline-contract.ts`.
+ *   - All DB JSON / `diagnosticJson` / artifact metadata is treated as `unknown`
+ *     and validated at runtime before use (EP-01).
+ *   - It never throws on malformed input; it returns a snapshot that the pure
+ *     contract will judge as a violation with a concrete `nextAction`.
+ */
+import { assertMainlineContract, EMPTY_CONTEXT_SENTINEL, type MainlineSnapshot, type RuntimeReadinessSnapshot } from '@principles/core/runtime-v2';
+export interface AssembleMainlineSnapshotOptions {
+    /** Workspace directory containing `.pd/state.db`. */
+    workspaceDir: string;
+    /** Specific painId to evaluate. If omitted, the latest diagnostician task is used. */
+    painId?: string;
+    /** Pre-built readiness snapshot. If omitted, a degraded one is assembled from `.pd/config.yaml`. */
+    readiness?: RuntimeReadinessSnapshot;
+}
+export interface AssembleMainlineSnapshotResult {
+    snapshot: MainlineSnapshot;
+    /** Non-fatal assembly warnings (e.g., malformed JSON that the contract will judge). */
+    warnings: string[];
+    /** The painId that was evaluated (useful when caller did not provide one). */
+    resolvedPainId: string | null;
+}
+export declare function assembleMainlineSnapshot(options: AssembleMainlineSnapshotOptions): Promise<AssembleMainlineSnapshotResult>;
+export { assertMainlineContract, EMPTY_CONTEXT_SENTINEL };
+//# sourceMappingURL=mainline-snapshot-assembler.d.ts.map

package/dist/services/mainline-snapshot-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mainline-snapshot-assembler.d.ts","sourceRoot":"","sources":["../../src/services/mainline-snapshot-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,sBAAsB,EACtB,sBAAsB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAU9B,MAAM,6BAA6B,CAAC;AAIrC,MAAM,WAAW,+BAA+B;IAC9C,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AA8cD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CAwBzC;AAGD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/services/mainline-snapshot-assembler.js

@@ -0,0 +1,399 @@
+/**
+ * Shared MainlineSnapshot assembler (PRI-394)
+ *
+ * I/O-boundary reader that assembles a read-only `MainlineSnapshot` from real
+ * Runtime V2 SQLite state, then hands it to core's pure `assertMainlineContract`.
+ *
+ * Rules:
+ *   - This module lives in pd-cli (I/O boundary). It reads `.pd/state.db` via
+ *     the existing `RuntimeStateManager` / `SqliteConnection` abstractions.
+ *   - It does NOT judge the contract. Judgment lives exclusively in
+ *     `packages/principles-core/src/runtime-v2/mainline-contract.ts`.
+ *   - All DB JSON / `diagnosticJson` / artifact metadata is treated as `unknown`
+ *     and validated at runtime before use (EP-01).
+ *   - It never throws on malformed input; it returns a snapshot that the pure
+ *     contract will judge as a violation with a concrete `nextAction`.
+ */
+import { RuntimeStateManager, assertMainlineContract, EMPTY_CONTEXT_SENTINEL, hydratePITaskRecord, } from '@principles/core/runtime-v2';
+import { loadPdConfig } from './pd-config-loader.js';
+// ── Safe JSON helpers ────────────────────────────────────────────────────────
+function safeJsonParse(raw) {
+    if (raw === null || raw === undefined || raw.trim() === '') {
+        return { ok: false, reason: 'diagnosticJson is empty' };
+    }
+    try {
+        return { ok: true, value: JSON.parse(raw) };
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return { ok: false, reason: `diagnosticJson is not valid JSON: ${detail}` };
+    }
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readOwnString(obj, key) {
+    if (!Object.hasOwn(obj, key))
+        return undefined;
+    const value = obj[key];
+    return isNonEmptyString(value) ? value : undefined;
+}
+function validateDiagnosticianArtifactRow(value) {
+    if (!isObject(value))
+        return null;
+    const artifactId = readOwnString(value, 'artifact_id');
+    const runId = readOwnString(value, 'run_id');
+    const taskId = readOwnString(value, 'task_id');
+    const artifactKind = readOwnString(value, 'artifact_kind');
+    const contentJson = readOwnString(value, 'content_json');
+    if (!artifactId || !contentJson)
+        return null;
+    return { artifactId, runId: runId ?? '', taskId: taskId ?? '', artifactKind: artifactKind ?? '', contentJson };
+}
+function validateConsumedCandidateRow(value) {
+    if (!isObject(value))
+        return null;
+    const candidateId = readOwnString(value, 'candidate_id');
+    if (!candidateId)
+        return null;
+    return { candidateId };
+}
+// ── Context hash helper ──────────────────────────────────────────────────────
+function hashContextRefs(contextRefs) {
+    const str = contextRefs.join('\u0000');
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    return `ctx-${Math.abs(hash).toString(16)}`;
+}
+// ── Readiness fallback ───────────────────────────────────────────────────────
+function buildDefaultReadiness(workspaceDir, warnings) {
+    const configLoadResult = loadPdConfig(workspaceDir);
+    const effective = configLoadResult.ok ? configLoadResult.effective : configLoadResult.defaults;
+    const defaultProfile = effective.config?.internalAgents?.defaultRuntime ?? 'openclaw.default';
+    if (!configLoadResult.ok) {
+        for (const err of configLoadResult.errors) {
+            warnings.push(`${err.path}: ${err.reason}`);
+        }
+    }
+    if (configLoadResult.warnings.length > 0) {
+        warnings.push(...configLoadResult.warnings);
+    }
+    return {
+        configDoctorProfile: defaultProfile,
+        runtimeProbeProfile: null,
+        configSource: '.pd/config.yaml',
+        probeConfigSource: '.pd/config.yaml',
+        diagnosticianReady: false,
+        diagnosticianReadinessReason: 'No readiness snapshot provided; run "pd runtime probe" first.',
+    };
+}
+// ── Diagnosis task lookup ────────────────────────────────────────────────────
+async function findDiagnosisTask(stateManager, requestedPainId, warnings) {
+    const allTasks = await stateManager.listTasks();
+    const diagTasks = allTasks.filter((t) => t.taskKind === 'diagnostician');
+    if (requestedPainId) {
+        const sortedByDate = [...diagTasks].sort((a, b) => (b.createdAt ?? '').localeCompare(a.createdAt ?? ''));
+        for (const task of sortedByDate) {
+            const parsed = safeJsonParse(task.diagnosticJson);
+            if (!parsed.ok)
+                continue;
+            const sourcePainId = isObject(parsed.value) ? readOwnString(parsed.value, 'sourcePainId') : undefined;
+            if (sourcePainId === requestedPainId) {
+                return { painId: requestedPainId, diagnosisTask: task };
+            }
+        }
+        return { painId: requestedPainId, diagnosisTask: null };
+    }
+    // No painId provided — pick the latest diagnostician task by createdAt.
+    const sorted = diagTasks.sort((a, b) => (b.createdAt ?? '').localeCompare(a.createdAt ?? ''));
+    for (const task of sorted) {
+        const parsed = safeJsonParse(task.diagnosticJson);
+        if (!parsed.ok) {
+            warnings.push(`Task ${task.taskId} has malformed diagnosticJson: ${parsed.reason}`);
+            continue;
+        }
+        const sourcePainId = isObject(parsed.value) ? readOwnString(parsed.value, 'sourcePainId') : undefined;
+        if (sourcePainId) {
+            return { painId: sourcePainId, diagnosisTask: task };
+        }
+    }
+    return { painId: null, diagnosisTask: sorted[0] ?? null };
+}
+async function buildDiagnosisTaskSnapshot(stateManager, task) {
+    const runs = await stateManager.getRunsByTask(task.taskId);
+    const hasSucceededRun = runs.some((r) => r.executionStatus === 'succeeded');
+    return {
+        taskId: task.taskId,
+        status: task.status,
+        hasSucceededRun,
+    };
+}
+async function findDiagnosticianArtifact(input) {
+    const { stateManager, diagnosisTaskId, painId, warnings } = input;
+    const db = stateManager.connection.getDb();
+    const rows = db
+        .prepare(`SELECT artifact_id, run_id, task_id, artifact_kind, content_json
+       FROM artifacts
+       WHERE task_id = ? AND artifact_kind = 'diagnostician_output'
+       ORDER BY created_at DESC
+       LIMIT 1`)
+        .all(diagnosisTaskId);
+    const [raw] = rows;
+    if (!raw)
+        return null;
+    const row = validateDiagnosticianArtifactRow(raw);
+    if (!row) {
+        warnings.push(`Malformed diagnostician artifact row for task ${diagnosisTaskId}: missing artifact_id or content_json`);
+        return null;
+    }
+    let sourcePainId = painId;
+    const parsed = safeJsonParse(row.contentJson);
+    if (parsed.ok && isObject(parsed.value)) {
+        const artifactPainId = readOwnString(parsed.value, 'painId');
+        if (artifactPainId) {
+            sourcePainId = artifactPainId;
+        }
+    }
+    else if (parsed.ok === false) {
+        warnings.push(`Artifact ${row.artifactId} content_json parse failed: ${parsed.reason}`);
+    }
+    return {
+        artifactId: row.artifactId,
+        sourcePainId,
+    };
+}
+async function findCandidate(stateManager, artifactId, warnings) {
+    const artifactWithCandidates = await stateManager.getArtifactWithCandidates(artifactId);
+    if (!artifactWithCandidates || artifactWithCandidates.candidates.length === 0)
+        return null;
+    const [candidate] = artifactWithCandidates.candidates;
+    if (!candidate)
+        return null;
+    const { status } = candidate;
+    if (status !== 'pending' && status !== 'consumed' && status !== 'expired') {
+        warnings.push(`Candidate ${candidate.candidateId} has unexpected status "${status}"`);
+    }
+    return {
+        candidateId: candidate.candidateId,
+        status,
+        sourceTaskId: candidate.taskId,
+        sourceArtifactId: candidate.artifactId,
+        sourceRunId: candidate.sourceRunId,
+    };
+}
+function buildDreamerTaskSnapshot(task, warnings) {
+    const piTask = hydratePITaskRecord(task);
+    if (!piTask) {
+        warnings.push(`Dreamer task ${task.taskId} has invalid PI metadata`);
+        return null;
+    }
+    const inputArtifactRefs = [];
+    for (const ref of piTask.inputArtifactRefs ?? []) {
+        if (isObject(ref) && isNonEmptyString(ref.artifactType) && isNonEmptyString(ref.ref)) {
+            inputArtifactRefs.push({
+                artifactType: ref.artifactType,
+                ref: ref.ref,
+            });
+        }
+    }
+    return {
+        taskId: task.taskId,
+        dependencyTaskIds: piTask.dependencyTaskIds,
+        inputArtifactRefs,
+    };
+}
+async function findDreamerTask(stateManager, candidate, warnings) {
+    // Predictable taskId from intake-to-internalization bridge.
+    const predictableIds = [
+        `dreamer-${candidate.candidateId}-prompt`,
+        `dreamer-${candidate.candidateId}-code_tool_hook`,
+        `dreamer-${candidate.candidateId}-defer_archive`,
+    ];
+    for (const taskId of predictableIds) {
+        const task = await stateManager.getTask(taskId);
+        if (task && task.taskKind === 'dreamer') {
+            return buildDreamerTaskSnapshot(task, warnings);
+        }
+    }
+    // Fallback: scan dreamer tasks whose diagnostic_json references this candidate.
+    const allTasks = await stateManager.listTasks();
+    for (const task of allTasks) {
+        if (task.taskKind !== 'dreamer')
+            continue;
+        const parsed = safeJsonParse(task.diagnosticJson);
+        if (!parsed.ok)
+            continue;
+        const candidateId = isObject(parsed.value) ? readOwnString(parsed.value, 'candidateId') : undefined;
+        if (candidateId === candidate.candidateId) {
+            return buildDreamerTaskSnapshot(task, warnings);
+        }
+    }
+    return null;
+}
+async function buildDreamerContextSnapshot(stateManager, dreamerTask, warnings) {
+    const contextRefs = [];
+    for (const depId of dreamerTask.dependencyTaskIds) {
+        const dep = await stateManager.getTask(depId);
+        if (!dep) {
+            warnings.push(`Dreamer task ${dreamerTask.taskId} dependency ${depId} not found`);
+            continue;
+        }
+        if (dep.resultRef)
+            contextRefs.push(dep.resultRef);
+        const depPi = hydratePITaskRecord(dep);
+        if (depPi?.outputArtifactRefs) {
+            for (const ref of depPi.outputArtifactRefs) {
+                if (ref && isNonEmptyString(ref.ref)) {
+                    contextRefs.push(ref.ref);
+                }
+            }
+        }
+    }
+    const contextHash = contextRefs.length === 0 ? EMPTY_CONTEXT_SENTINEL : hashContextRefs(contextRefs);
+    return { contextHash, contextRefs };
+}
+async function findSuccessor(stateManager, dreamerTaskId) {
+    const allTasks = await stateManager.listTasks();
+    for (const task of allTasks) {
+        if (task.taskKind !== 'philosopher')
+            continue;
+        const piTask = hydratePITaskRecord(task);
+        if (!piTask)
+            continue;
+        const { parentTaskId, dependencyTaskIds: deps = [] } = piTask;
+        if (parentTaskId === dreamerTaskId || deps.includes(dreamerTaskId)) {
+            return {
+                taskId: task.taskId,
+                taskKind: task.taskKind,
+                exists: true,
+            };
+        }
+    }
+    return null;
+}
+async function findReviewablePrinciple(stateManager, philosopherTaskId) {
+    const artifacts = await stateManager.piArtifactStore.listBySourceTaskId(philosopherTaskId);
+    const principleArtifact = artifacts.find((a) => a.artifactKind === 'principle');
+    if (!principleArtifact)
+        return null;
+    let principleId;
+    const parsed = safeJsonParse(principleArtifact.contentJson);
+    if (parsed.ok && isObject(parsed.value)) {
+        const { principleCandidate: candidate } = parsed.value;
+        if (isObject(candidate)) {
+            const id = readOwnString(candidate, 'principleId');
+            if (id)
+                principleId = id;
+        }
+    }
+    return {
+        exists: true,
+        principleId,
+        reviewable: principleArtifact.validationStatus !== 'rejected',
+    };
+}
+async function assembleChain(input) {
+    const { stateManager, painId, diagnosisTask, warnings } = input;
+    const diagnosisTaskSnapshot = diagnosisTask
+        ? await buildDiagnosisTaskSnapshot(stateManager, diagnosisTask)
+        : null;
+    const diagnosticianArtifact = diagnosisTask
+        ? await findDiagnosticianArtifact({
+            stateManager,
+            diagnosisTaskId: diagnosisTask.taskId,
+            painId,
+            warnings,
+        })
+        : null;
+    const candidate = diagnosticianArtifact
+        ? await findCandidate(stateManager, diagnosticianArtifact.artifactId, warnings)
+        : null;
+    const dreamerTask = candidate
+        ? await findDreamerTask(stateManager, candidate, warnings)
+        : null;
+    const dreamerContext = dreamerTask
+        ? await buildDreamerContextSnapshot(stateManager, dreamerTask, warnings)
+        : null;
+    const successor = dreamerTask
+        ? await findSuccessor(stateManager, dreamerTask.taskId)
+        : null;
+    const principle = successor
+        ? await findReviewablePrinciple(stateManager, successor.taskId)
+        : null;
+    return {
+        painId,
+        diagnosisTask: diagnosisTaskSnapshot,
+        diagnosticianArtifact,
+        candidate,
+        dreamerTask,
+        dreamerContext,
+        successor,
+        principle,
+    };
+}
+// ── Workspace-level auto-consumption hole ────────────────────────────────────
+async function findConsumedCandidatesMissingDreamer(stateManager, warnings) {
+    const db = stateManager.connection.getDb();
+    const rows = db
+        .prepare(`SELECT candidate_id FROM principle_candidates WHERE status = 'consumed'`)
+        .all();
+    const allTasks = await stateManager.listTasks();
+    const dreamerTasks = allTasks.filter((t) => t.taskKind === 'dreamer');
+    const dreamerTaskIds = new Set(dreamerTasks.map((t) => t.taskId));
+    const orphans = [];
+    for (const raw of rows) {
+        const row = validateConsumedCandidateRow(raw);
+        if (!row) {
+            warnings.push('Malformed consumed candidate row: missing candidate_id');
+            continue;
+        }
+        const { candidateId } = row;
+        const predictableIds = [
+            `dreamer-${candidateId}-prompt`,
+            `dreamer-${candidateId}-code_tool_hook`,
+            `dreamer-${candidateId}-defer_archive`,
+        ];
+        const hasDreamerByTaskId = predictableIds.some((taskId) => dreamerTaskIds.has(taskId));
+        const hasDreamerByJson = !hasDreamerByTaskId && dreamerTasks.some((dt) => {
+            const parsed = safeJsonParse(dt.diagnosticJson);
+            if (!parsed.ok)
+                return false;
+            const id = isObject(parsed.value) ? readOwnString(parsed.value, 'candidateId') : undefined;
+            return id === candidateId;
+        });
+        if (!hasDreamerByTaskId && !hasDreamerByJson) {
+            orphans.push(candidateId);
+        }
+    }
+    return orphans;
+}
+// ── Assembler ────────────────────────────────────────────────────────────────
+export async function assembleMainlineSnapshot(options) {
+    const stateManager = new RuntimeStateManager({ workspaceDir: options.workspaceDir, readonly: true });
+    const warnings = [];
+    try {
+        await stateManager.initialize();
+        const readiness = options.readiness ?? buildDefaultReadiness(options.workspaceDir, warnings);
+        const { painId, diagnosisTask } = await findDiagnosisTask(stateManager, options.painId, warnings);
+        const chain = await assembleChain({ stateManager, painId, diagnosisTask, warnings });
+        const consumedCandidatesMissingDreamer = await findConsumedCandidatesMissingDreamer(stateManager, warnings);
+        const snapshot = {
+            readiness,
+            chain,
+            consumedCandidatesMissingDreamer,
+        };
+        return { snapshot, warnings, resolvedPainId: painId };
+    }
+    finally {
+        await stateManager.close();
+    }
+}
+// Re-export the pure contract so callers can judge the assembled snapshot.
+export { assertMainlineContract, EMPTY_CONTEXT_SENTINEL };
+//# sourceMappingURL=mainline-snapshot-assembler.js.map

package/dist/services/mainline-snapshot-assembler.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/pd-cli",
-  "version": "1.102.0",
+  "version": "1.103.0",
   "description": "PD CLI — Pain recording, sample management, and evolution tasks",
   "type": "module",
   "bin": {

package/src/commands/runtime-internalization-integrity.ts

@@ -2,6 +2,7 @@ import * as path from 'path';
 import { InternalizationChainIntegrityReadModel } from '@principles/core/runtime-v2';
 import type { ChainIntegrityResult } from '@principles/core/runtime-v2';
 import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { assembleMainlineSnapshot } from '../services/mainline-snapshot-assembler.js';
 
 interface InternalizationIntegrityOptions {
   workspace?: string;
@@ -47,7 +48,45 @@ export async function handleRuntimeInternalizationIntegrity(opts: Internalizatio
     ? path.resolve(opts.workspace)
     : resolveWorkspaceDir();
 
-  const model = new InternalizationChainIntegrityReadModel({ workspaceDir });
+  let warnings: string[];
+  let snapshot;
+  try {
+    ({ snapshot, warnings } = await assembleMainlineSnapshot({ workspaceDir }));
+  } catch (error: unknown) {
+    const reason = error instanceof Error ? error.message : String(error);
+    const failure: ChainIntegrityResult = {
+      overallStatus: 'error',
+      brokenLinks: [{
+        type: 'mainline_snapshot_assembly_failed',
+        severity: 'error',
+        reason: `Failed to assemble mainline snapshot: ${reason}`,
+        recommendedAction: 'Verify workspace state.db/config and rerun `pd runtime internalization integrity`.',
+      }],
+      chainSummaries: {
+        totalCandidates: 0,
+        totalDreamerTasks: 0,
+        totalPhilosopherTasks: 0,
+        totalPIArtifacts: 0,
+        chainsWithBrokenLinks: 0,
+      },
+      generatedAt: new Date().toISOString(),
+    };
+    if (opts.json) {
+      console.log(JSON.stringify(failure, null, 2));
+    } else {
+      console.error(`FAIL: ${failure.brokenLinks[0].reason}`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+
+  if (!opts.json && warnings.length > 0) {
+    for (const warning of warnings) {
+      console.warn(`Warning: ${warning}`);
+    }
+  }
+
+  const model = new InternalizationChainIntegrityReadModel({ workspaceDir, mainlineSnapshot: snapshot });
   const result = model.check();
 
   if (opts.json) {