@principles/pd-cli 1.145.2 → 1.146.1

package/README.md

@@ -15,13 +15,22 @@ npm install -g @principles/pd-cli
 Record a pain signal to the workspace's trajectory database via `PainToPrincipleService`.
 
 ```bash
-pd pain record --reason "edited file without reading first" --score 75
+pd pain record --reason "edited file without reading first" --score 75 --session "<session-id>"
 ```
 
 Options:
 - `--reason, -r` — Pain reason (required)
 - `--score, -s` — Pain score 0-100 (default: 80)
-- `--session-id` — Session ID (default: auto-generated)
+- `--session` — Session ID recorded in this workspace's trajectory; validated
+  up front (a missing session fails with `session_not_found` before anything
+  is written). Binding a session attaches real trajectory evidence.
+- `--workspace, -w` — Workspace directory
+- `--wait` — Diagnose synchronously (overrides the async CLI flag)
+- `--json` — Machine-readable output
+
+Without `--session` the record is an honest unbound Owner report: it carries
+no trajectory evidence and candidates will likely be gated by the admission
+threshold (`needs_evidence`); the output discloses this explicitly.
 
 ## Production Canary Validation
 

package/dist/commands/build-trajectory-evidence.d.ts

@@ -10,12 +10,31 @@
  */
 import type { PainEvidenceEntry } from '@principles/core/runtime-v2';
 /**
- * Build trajectory evidence entries by reading trajectory.db directly.
+ * PRI-642 (SPEC §7.3): discriminated acquisition result. `unavailable` carries
+ * a distinct reasonCode so `pd pain record --session` can fail/degrade
+ * explicitly BEFORE any LLM/task/candidate mutation, without placeholder
+ * evidence.
+ */
+export type TrajectoryEvidenceAcquisition = {
+    status: 'available';
+    entries: PainEvidenceEntry[];
+} | {
+    status: 'unavailable';
+    reasonCode: 'trajectory_unavailable' | 'session_not_found' | 'empty_trajectory' | 'evidence_read_failed';
+    detail: string;
+};
+/**
+ * PRI-642 Scope A typed acquisition from trajectory.db (SPEC §7.3).
  *
- * @param stateDir   - The .state directory containing trajectory.db
- * @param sessionId  - The session ID to query turns for
- * @param workspaceDir - Workspace directory for path redaction (sanitizeString)
- * @returns Array of PainEvidenceEntry (never empty; degraded entries on failure)
+ * Validates that the requested session exists in the trajectory `sessions`
+ * table (every recorded turn/tool call upserts its session row, so an absent
+ * row means the session was never seen) and classifies the outcome:
+ *  - `available`            — session bound, ≥1 real behavior-trace entry;
+ *  - `session_not_found`    — session absent from the sessions table (or a
+ *                             `cli`/`unknown` sentinel — never a real session);
+ *  - `trajectory_unavailable` — no trajectory.db in this workspace;
+ *  - `evidence_read_failed` — the DB exists but cannot be opened/read;
+ *  - `empty_trajectory`     — real session, no usable evidence rows.
  */
-export declare function buildTrajectoryEvidenceFromDb(stateDir: string, sessionId: string | undefined, workspaceDir?: string): PainEvidenceEntry[];
+export declare function acquireTrajectoryEvidenceFromDb(stateDir: string, sessionId: string | undefined, workspaceDir?: string): TrajectoryEvidenceAcquisition;
 //# sourceMappingURL=build-trajectory-evidence.d.ts.map

package/dist/commands/build-trajectory-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-trajectory-evidence.d.ts","sourceRoot":"","sources":["../../src/commands/build-trajectory-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,EAAE,CAyJrB"}
+{"version":3,"file":"build-trajectory-evidence.d.ts","sourceRoot":"","sources":["../../src/commands/build-trajectory-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GACrC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,GACrD;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,wBAAwB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;IACzG,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA6JN;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,CAAC,EAAE,MAAM,GACpB,6BAA6B,CAoE/B"}

package/dist/commands/build-trajectory-evidence.js

@@ -12,110 +12,90 @@ import Database from 'better-sqlite3';
 import * as fs from 'fs';
 import * as path from 'path';
 import { MAX_EVIDENCE_ENTRIES, MAX_EVIDENCE_NOTE_CHARS, sanitizeString, } from '@principles/core/runtime-v2';
+/** SourceRef markers that carry no real behavior trace (placeholder shapes). */
+const PLACEHOLDER_SOURCE_REFS = new Set([
+    'owner_reported:cli',
+    'owner_message:unavailable',
+    'agent_turn:unavailable',
+    'tool_call_failure:unavailable',
+    'trajectory:empty',
+]);
 /**
- * Build trajectory evidence entries by reading trajectory.db directly.
- *
- * @param stateDir   - The .state directory containing trajectory.db
- * @param sessionId  - The session ID to query turns for
- * @param workspaceDir - Workspace directory for path redaction (sanitizeString)
- * @returns Array of PainEvidenceEntry (never empty; degraded entries on failure)
+ * Collect evidence entries from an open trajectory.db for one session.
+ * Shared by the typed acquisition API and the legacy array wrapper so the
+ * two can never drift.
  */
-export function buildTrajectoryEvidenceFromDb(stateDir, sessionId, workspaceDir) {
+function collectEvidenceFromDb(db, sessionId, workspaceDir) {
     const evidence = [];
-    // No session or empty → placeholder entry (ERR-002: never return empty array silently)
-    if (!sessionId || sessionId === 'cli' || sessionId === 'unknown') {
-        evidence.push({
-            sourceRef: 'owner_reported:cli',
-            note: 'No session context available',
-        });
-        return evidence;
-    }
-    const dbPath = path.join(stateDir, 'trajectory.db');
-    if (!fs.existsSync(dbPath)) {
-        evidence.push({
-            sourceRef: 'owner_reported:cli',
-            note: 'No session context available',
-        });
-        return evidence;
-    }
-    let db;
-    try {
-        db = new Database(dbPath, { readonly: true });
-    }
-    catch {
-        evidence.push({
-            sourceRef: 'owner_reported:cli',
-            note: 'No session context available',
-        });
-        return evidence;
-    }
+    let readFailed = false;
+    // Try to read user turns with correction detection
     try {
-        // Try to read user turns with correction detection
-        try {
-            const userTurns = db.prepare(`
+        const userTurns = db.prepare(`
         SELECT id, raw_excerpt, correction_detected, correction_cue, created_at
         FROM user_turns
         WHERE session_id = ?
         ORDER BY id ASC
       `).all(sessionId);
-            const lastCorrectionTurn = [...userTurns].reverse().find(t => Boolean(t.correction_detected));
-            if (lastCorrectionTurn) {
-                const rawExcerpt = typeof lastCorrectionTurn.raw_excerpt === 'string'
-                    ? lastCorrectionTurn.raw_excerpt
-                    : '';
-                const sanitizedNote = sanitizeString(rawExcerpt.slice(0, MAX_EVIDENCE_NOTE_CHARS), workspaceDir);
-                evidence.push({
-                    sourceRef: `owner_message:${String(lastCorrectionTurn.created_at ?? 'unknown')}`,
-                    note: sanitizedNote,
-                });
-            }
+        const lastCorrectionTurn = [...userTurns].reverse().find(t => Boolean(t.correction_detected));
+        if (lastCorrectionTurn) {
+            const rawExcerpt = typeof lastCorrectionTurn.raw_excerpt === 'string'
+                ? lastCorrectionTurn.raw_excerpt
+                : '';
+            const sanitizedNote = sanitizeString(rawExcerpt.slice(0, MAX_EVIDENCE_NOTE_CHARS), workspaceDir);
+            evidence.push({
+                sourceRef: `owner_message:${String(lastCorrectionTurn.created_at ?? 'unknown')}`,
+                note: sanitizedNote,
+            });
         }
-        catch {
-            // user_turns table may not exist — degrade gracefully
-            if (evidence.length < MAX_EVIDENCE_ENTRIES) {
-                evidence.push({
-                    sourceRef: 'owner_message:unavailable',
-                    note: 'trajectory_user_turns_unavailable',
-                });
-            }
+    }
+    catch {
+        readFailed = true;
+        // user_turns table may not exist — degrade gracefully
+        if (evidence.length < MAX_EVIDENCE_ENTRIES) {
+            evidence.push({
+                sourceRef: 'owner_message:unavailable',
+                note: 'trajectory_user_turns_unavailable',
+            });
         }
-        // Try to read assistant turns (last 3)
-        try {
-            const assistantTurns = db.prepare(`
+    }
+    // Try to read assistant turns (last 3)
+    try {
+        const assistantTurns = db.prepare(`
         SELECT id, sanitized_text, stop_reason, created_at
         FROM assistant_turns
         WHERE session_id = ?
         ORDER BY id ASC
       `).all(sessionId);
-            const recentAssistant = assistantTurns.slice(-3);
-            for (const turn of recentAssistant) {
-                if (evidence.length >= MAX_EVIDENCE_ENTRIES)
-                    break;
-                const sanitizedText = typeof turn.sanitized_text === 'string'
-                    ? turn.sanitized_text
-                    : '';
-                const sanitizedNote = sanitizeString(sanitizedText.slice(0, MAX_EVIDENCE_NOTE_CHARS), workspaceDir);
-                // Enhanced: append truncation warning when stop_reason=length
-                const stopReason = typeof turn.stop_reason === 'string' ? turn.stop_reason : null;
-                const truncationWarning = stopReason === 'length' ? ' [TRUNCATED: output cut off by length limit]' : '';
-                evidence.push({
-                    sourceRef: `agent_turn:${String(turn.created_at ?? 'unknown')}`,
-                    note: sanitizedNote + truncationWarning,
-                });
-            }
+        const recentAssistant = assistantTurns.slice(-3);
+        for (const turn of recentAssistant) {
+            if (evidence.length >= MAX_EVIDENCE_ENTRIES)
+                break;
+            const sanitizedText = typeof turn.sanitized_text === 'string'
+                ? turn.sanitized_text
+                : '';
+            const sanitizedNote = sanitizeString(sanitizedText.slice(0, MAX_EVIDENCE_NOTE_CHARS), workspaceDir);
+            // Enhanced: append truncation warning when stop_reason=length
+            const stopReason = typeof turn.stop_reason === 'string' ? turn.stop_reason : null;
+            const truncationWarning = stopReason === 'length' ? ' [TRUNCATED: output cut off by length limit]' : '';
+            evidence.push({
+                sourceRef: `agent_turn:${String(turn.created_at ?? 'unknown')}`,
+                note: sanitizedNote + truncationWarning,
+            });
         }
-        catch {
-            // assistant_turns table may not exist — degrade gracefully
-            if (evidence.length < MAX_EVIDENCE_ENTRIES) {
-                evidence.push({
-                    sourceRef: 'agent_turn:unavailable',
-                    note: 'trajectory_assistant_turns_unavailable',
-                });
-            }
+    }
+    catch {
+        readFailed = true;
+        // assistant_turns table may not exist — degrade gracefully
+        if (evidence.length < MAX_EVIDENCE_ENTRIES) {
+            evidence.push({
+                sourceRef: 'agent_turn:unavailable',
+                note: 'trajectory_assistant_turns_unavailable',
+            });
         }
-        // PRI-358: Try to read failed tool_calls (last 3 failures, chronological order)
-        try {
-            const failedToolCalls = db.prepare(`
+    }
+    // PRI-358: Try to read failed tool_calls (last 3 failures, chronological order)
+    try {
+        const failedToolCalls = db.prepare(`
         SELECT tool_name, error_type, exit_code, result_preview, created_at
         FROM (
           SELECT tool_name, error_type, exit_code, result_preview, created_at
@@ -126,39 +106,119 @@ export function buildTrajectoryEvidenceFromDb(stateDir, sessionId, workspaceDir)
         )
         ORDER BY created_at ASC
       `).all(sessionId);
-            for (const tc of failedToolCalls) {
-                if (evidence.length >= MAX_EVIDENCE_ENTRIES)
-                    break;
-                const toolName = typeof tc.tool_name === 'string' ? tc.tool_name : 'unknown';
-                const errorType = typeof tc.error_type === 'string' ? tc.error_type : 'unknown';
-                const exitCode = tc.exit_code != null ? String(tc.exit_code) : 'N/A';
-                // Enhanced: append resultPreview when available
-                const resultPreview = typeof tc.result_preview === 'string' ? tc.result_preview : null;
-                const previewSuffix = resultPreview ? ` | ${resultPreview.slice(0, 200)}` : '';
-                const note = `Tool ${toolName} failed: ${errorType} (exitCode: ${exitCode})${previewSuffix}`;
-                evidence.push({
-                    sourceRef: `tool_call_failure:${String(tc.created_at ?? 'unknown')}`,
-                    note: sanitizeString(note.slice(0, MAX_EVIDENCE_NOTE_CHARS), workspaceDir),
-                });
-            }
-        }
-        catch {
-            // tool_calls table may not exist — degrade gracefully (only when no other evidence)
-            if (evidence.length === 0) {
-                evidence.push({
-                    sourceRef: 'tool_call_failure:unavailable',
-                    note: 'trajectory_tool_calls_unavailable',
-                });
-            }
+        for (const tc of failedToolCalls) {
+            if (evidence.length >= MAX_EVIDENCE_ENTRIES)
+                break;
+            const toolName = typeof tc.tool_name === 'string' ? tc.tool_name : 'unknown';
+            const errorType = typeof tc.error_type === 'string' ? tc.error_type : 'unknown';
+            const exitCode = tc.exit_code != null ? String(tc.exit_code) : 'N/A';
+            // Enhanced: append resultPreview when available
+            const resultPreview = typeof tc.result_preview === 'string' ? tc.result_preview : null;
+            const previewSuffix = resultPreview ? ` | ${resultPreview.slice(0, 200)}` : '';
+            const note = `Tool ${toolName} failed: ${errorType} (exitCode: ${exitCode})${previewSuffix}`;
+            evidence.push({
+                sourceRef: `tool_call_failure:${String(tc.created_at ?? 'unknown')}`,
+                note: sanitizeString(note.slice(0, MAX_EVIDENCE_NOTE_CHARS), workspaceDir),
+            });
         }
-        // If no evidence at all from trajectory, provide a meaningful placeholder
+    }
+    catch {
+        readFailed = true;
+        // tool_calls table may not exist — degrade gracefully (only when no other evidence)
         if (evidence.length === 0) {
             evidence.push({
-                sourceRef: 'trajectory:empty',
-                note: 'trajectory_available_but_empty: no user correction or assistant turns found',
+                sourceRef: 'tool_call_failure:unavailable',
+                note: 'trajectory_tool_calls_unavailable',
             });
         }
-        return evidence.slice(0, MAX_EVIDENCE_ENTRIES);
+    }
+    // If no evidence at all from trajectory, provide a meaningful placeholder
+    if (evidence.length === 0) {
+        evidence.push({
+            sourceRef: 'trajectory:empty',
+            note: 'trajectory_available_but_empty: no user correction or assistant turns found',
+        });
+    }
+    const bounded = evidence.slice(0, MAX_EVIDENCE_ENTRIES);
+    const realEntryCount = bounded.reduce((count, entry) => count + (PLACEHOLDER_SOURCE_REFS.has(entry.sourceRef) ? 0 : 1), 0);
+    return { entries: bounded, realEntryCount, readFailed };
+}
+/**
+ * PRI-642 Scope A typed acquisition from trajectory.db (SPEC §7.3).
+ *
+ * Validates that the requested session exists in the trajectory `sessions`
+ * table (every recorded turn/tool call upserts its session row, so an absent
+ * row means the session was never seen) and classifies the outcome:
+ *  - `available`            — session bound, ≥1 real behavior-trace entry;
+ *  - `session_not_found`    — session absent from the sessions table (or a
+ *                             `cli`/`unknown` sentinel — never a real session);
+ *  - `trajectory_unavailable` — no trajectory.db in this workspace;
+ *  - `evidence_read_failed` — the DB exists but cannot be opened/read;
+ *  - `empty_trajectory`     — real session, no usable evidence rows.
+ */
+export function acquireTrajectoryEvidenceFromDb(stateDir, sessionId, workspaceDir) {
+    if (!sessionId || sessionId === 'cli' || sessionId === 'unknown') {
+        return {
+            status: 'unavailable',
+            reasonCode: 'session_not_found',
+            detail: sessionId ? `sentinel_session_id:${sessionId}` : 'missing_session_id',
+        };
+    }
+    const dbPath = path.join(stateDir, 'trajectory.db');
+    if (!fs.existsSync(dbPath)) {
+        return {
+            status: 'unavailable',
+            reasonCode: 'trajectory_unavailable',
+            detail: 'trajectory_db_missing',
+        };
+    }
+    let db;
+    try {
+        db = new Database(dbPath, { readonly: true });
+    }
+    catch (err) {
+        return {
+            status: 'unavailable',
+            reasonCode: 'evidence_read_failed',
+            detail: `trajectory_db_unreadable: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        // Session existence: rows are upserted by every turn/tool-call write, so
+        // an absent row means the trajectory never saw this session.
+        let sessionExists = false;
+        try {
+            const row = db.prepare('SELECT 1 FROM sessions WHERE session_id = ?').get(sessionId);
+            sessionExists = row !== undefined;
+        }
+        catch {
+            // sessions table missing → cannot validate existence; fall through and
+            // let the evidence rows decide (legacy DBs may lack the table).
+            sessionExists = true;
+        }
+        if (!sessionExists) {
+            return {
+                status: 'unavailable',
+                reasonCode: 'session_not_found',
+                detail: 'session_not_present_in_trajectory',
+            };
+        }
+        const collection = collectEvidenceFromDb(db, sessionId, workspaceDir);
+        if (collection.realEntryCount > 0) {
+            return { status: 'available', entries: collection.entries };
+        }
+        if (collection.readFailed) {
+            return {
+                status: 'unavailable',
+                reasonCode: 'evidence_read_failed',
+                detail: 'trajectory_tables_unreadable',
+            };
+        }
+        return {
+            status: 'unavailable',
+            reasonCode: 'empty_trajectory',
+            detail: 'session_present_but_no_usable_evidence',
+        };
     }
     finally {
         db.close();

package/dist/commands/build-trajectory-evidence.js.map

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

package/dist/commands/console.d.ts

@@ -15,6 +15,19 @@ interface ConsoleOptions {
     noAuth?: boolean;
     json?: boolean;
 }
+/**
+ * Verify the console server's runtime dependency slots are resolvable.
+ *
+ * The console's dist statically imports `@principles/core/runtime-v2` and
+ * `@principles/host-runtime`, and reads plugin governance exports from
+ * `principles-disciple`. Each slot must be a real package (package.json present
+ * AND dist/index.js present) — a dangling junction or an empty shell (package.json
+ * without dist) makes the server crash with ERR_MODULE_NOT_FOUND at startup.
+ *
+ * Returns a human-readable description of the first broken slot, or undefined
+ * when everything is resolvable.
+ */
+export declare function checkConsoleRuntimeDependencies(consoleDir: string): string | undefined;
 export declare function handleConsole(opts?: ConsoleOptions): Promise<void>;
 /**
  * Launch (or reuse) the PD Console with seed-friendly defaults:

package/dist/commands/console.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/commands/console.ts"],"names":[],"mappings":"AAwBA,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuBD,wBAAsB,aAAa,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoH5E;AAID;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAydpF"}
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/commands/console.ts"],"names":[],"mappings":"AAwBA,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqCtF;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyI5E;AAID;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0fpF"}

package/dist/commands/console.js

@@ -30,6 +30,56 @@ function getConsoleDir() {
     const dir = resolved.mode === 'canonical' ? paths.consoleDir : path.join(paths.openClawExtensionDir, 'console');
     return { dir, mode: resolved.mode };
 }
+/**
+ * Verify the console server's runtime dependency slots are resolvable.
+ *
+ * The console's dist statically imports `@principles/core/runtime-v2` and
+ * `@principles/host-runtime`, and reads plugin governance exports from
+ * `principles-disciple`. Each slot must be a real package (package.json present
+ * AND dist/index.js present) — a dangling junction or an empty shell (package.json
+ * without dist) makes the server crash with ERR_MODULE_NOT_FOUND at startup.
+ *
+ * Returns a human-readable description of the first broken slot, or undefined
+ * when everything is resolvable.
+ */
+export function checkConsoleRuntimeDependencies(consoleDir) {
+    // These are the exact entry files the console server resolves at startup,
+    // derived from each package's real `exports` map (not assumed dist/index.js):
+    //   @principles/core/principle-tree-ledger → dist/principle-tree-ledger.js
+    //   @principles/core/runtime-v2            → dist/runtime-v2/index.js
+    //   @principles/host-runtime               → dist/index.js
+    //   @principles/install-layout             → dist/index.js
+    //   principles-disciple/governance-audit   → dist/governance-audit.js
+    // Checking the real resolved entries (not just dist/index.js) catches broken
+    // shells where package.json exists but the actual import target is missing.
+    // One package can have multiple required entries (@principles/core).
+    const slots = [
+        {
+            pkg: '@principles/core',
+            entries: [
+                path.join('dist', 'principle-tree-ledger.js'),
+                path.join('dist', 'runtime-v2', 'index.js'),
+            ],
+        },
+        { pkg: '@principles/host-runtime', entries: [path.join('dist', 'index.js')] },
+        { pkg: '@principles/install-layout', entries: [path.join('dist', 'index.js')] },
+        { pkg: 'principles-disciple', entries: [path.join('dist', 'governance-audit.js')] },
+    ];
+    for (const slot of slots) {
+        const base = path.join(consoleDir, 'node_modules', slot.pkg);
+        const pkgJson = path.join(base, 'package.json');
+        if (!fs.existsSync(pkgJson)) {
+            return `console/node_modules/${slot.pkg}/package.json is missing`;
+        }
+        for (const entry of slot.entries) {
+            const entryFile = path.join(base, entry);
+            if (!fs.existsSync(entryFile)) {
+                return `console/node_modules/${slot.pkg}/${entry.replaceAll('\\', '/')} is missing (incomplete package)`;
+            }
+        }
+    }
+    return undefined;
+}
 export async function handleConsole(opts = {}) {
     const workspaceDir = opts.workspace
         ? path.resolve(opts.workspace)
@@ -73,6 +123,27 @@ export async function handleConsole(opts = {}) {
         process.exit(1);
         return;
     }
+    // Runtime dependency integrity check: the console server statically imports
+    // @principles/core/runtime-v2 and @principles/host-runtime, and the console
+    // reads plugin governance exports from principles-disciple. When the OpenClaw
+    // upgrade path refreshes the plugin bundle without re-running the PD installer
+    // (2026-09: console_cli_exited_before_result), these node_modules slots can be
+    // left as an empty shell (package.json without dist) or a dangling junction.
+    // The server then crashes with ERR_MODULE_NOT_FOUND at startup, which the
+    // Companion reports as the opaque console_cli_exited_before_result. Fail loud
+    // here with the actionable repair command instead.
+    const integrityError = checkConsoleRuntimeDependencies(consoleLocation.dir);
+    if (integrityError) {
+        const msg = `Console runtime dependency broken: ${integrityError}. Re-run installer to repair.`;
+        if (opts.json) {
+            console.log(JSON.stringify({ success: false, reason: msg, nextAction: 'npx create-principles-disciple' }));
+        }
+        else {
+            console.error(msg);
+        }
+        process.exit(1);
+        return;
+    }
     const port = opts.port || '3100';
     const host = '127.0.0.1';
     const args = [serverEntry, '--workspace', workspaceDir, '--port', port, '--host', host];
@@ -456,6 +527,39 @@ export async function handleConsoleOpen(opts = {}) {
         return;
     }
     // 5) Fresh spawn path
+    // Runtime dependency integrity check — only here, NOT before the reuse
+    // probe above. A healthy console already running (reused) has its modules
+    // loaded in memory; broken disk slots (dangling junction / empty shell left
+    // by an interrupted update) must not prevent reusing it. Only when we are
+    // about to execute the local console bytes do the local bytes need to be
+    // resolvable. The server statically imports @principles/core/runtime-v2 and
+    // @principles/host-runtime, and reads plugin governance exports from
+    // principles-disciple; without this check a broken install crashes with
+    // ERR_MODULE_NOT_FOUND which the Companion reports as the opaque
+    // console_cli_exited_before_result.
+    const integrityError = checkConsoleRuntimeDependencies(consoleLocation.dir);
+    if (integrityError) {
+        const result = {
+            status: 'failed',
+            url: '',
+            port: plan.port,
+            host: plan.host,
+            workspaceDir,
+            reused: false,
+            browserOpened: false,
+            reason: 'console_runtime_dependency_broken',
+            nextAction: `Re-run installer: npx create-principles-disciple (${integrityError})`,
+        };
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.error(`error: ${result.reason}`);
+            console.error(`next:   ${result.nextAction}`);
+        }
+        process.exit(1);
+        return;
+    }
     const args = [serverEntry, '--workspace', workspaceDir, '--port', String(plan.port), '--host', plan.host];
     if (opts.noAuth)
         args.push('--no-auth');