@principles/core 1.73.0

package/dist/runtime-v2/observer/correction-observer.js

@@ -0,0 +1,178 @@
+import { Type } from '@sinclair/typebox';
+// ── Schemas ──────────────────────────────────────────────────────────────────
+export const CorrectionObserverPayloadSchema = Type.Object({
+    parentSessionId: Type.String(),
+    workspaceDir: Type.String(),
+    keywordStoreSummary: Type.Object({
+        totalKeywords: Type.Number(),
+        terms: Type.Array(Type.Object({
+            term: Type.String(),
+            weight: Type.Number(),
+            hitCount: Type.Number(),
+            truePositiveCount: Type.Number(),
+            falsePositiveCount: Type.Number(),
+        })),
+    }),
+    recentMessages: Type.Array(Type.String()),
+    trajectoryHistory: Type.Array(Type.Object({
+        sessionId: Type.String(),
+        timestamp: Type.String(),
+        term: Type.String(),
+        userMessage: Type.String(),
+    })),
+});
+export const CorrectionObserverOutputV1Schema = Type.Object({
+    updated: Type.Boolean(),
+    updates: Type.Optional(Type.Record(Type.String(), Type.Object({
+        action: Type.Union([Type.Literal('add'), Type.Literal('update'), Type.Literal('remove')]),
+        weight: Type.Optional(Type.Number()),
+        falsePositiveRate: Type.Optional(Type.Number()),
+        reasoning: Type.String(),
+    }))),
+    fpTerms: Type.Optional(Type.Array(Type.String())),
+    fpAnalysisStatus: Type.Optional(Type.Union([Type.Literal('completed'), Type.Literal('skipped')])),
+    summary: Type.String(),
+});
+export class CorrectionObserver {
+    runtimeAdapter;
+    timeoutMs;
+    agentId;
+    constructor(deps, options) {
+        this.runtimeAdapter = deps.runtimeAdapter;
+        this.timeoutMs = options?.timeoutMs ?? 30_000;
+        this.agentId = options?.agentId ?? 'correction-observer';
+    }
+    /**
+     * Replicates prompt construction from correctionObserverWorkflowSpec
+     */
+    static buildPrompt(payload) {
+        const { keywordStoreSummary, recentMessages, trajectoryHistory } = payload;
+        const MAX_TRAJECTORY_MESSAGE_LENGTH = 80;
+        const termsList = keywordStoreSummary.terms
+            .map(t => `  - term="${t.term}", weight=${t.weight}, hits=${t.hitCount}, TP=${t.truePositiveCount}, FP=${t.falsePositiveCount}`)
+            .join('\n');
+        const messages = recentMessages.length > 0
+            ? recentMessages.map(m => `  - ${JSON.stringify(m)}`).join('\n')
+            : '  (none)';
+        const trajectory = trajectoryHistory.length > 0
+            ? trajectoryHistory.map(t => `  - [${t.sessionId}] ${t.term} (${t.timestamp}): ${t.userMessage.substring(0, MAX_TRAJECTORY_MESSAGE_LENGTH)}`)
+                .join('\n')
+            : '  (none)';
+        return [
+            'You are a correction keyword optimizer.',
+            '',
+            '## TASK',
+            'Analyze the current correction keyword store and recent user messages.',
+            'Recommend ADD/UPDATE/REMOVE actions to improve correction cue accuracy.',
+            'Also identify terms that triggered false positives (correctionDetected fired but user message doesn\'t indicate actual frustration).',
+            '',
+            '## Current Keyword Store (' + keywordStoreSummary.totalKeywords + ' terms):',
+            termsList,
+            '',
+            '## Recent User Messages (' + recentMessages.length + ' messages):',
+            messages,
+            '',
+            '## Correction Trajectory (recent confirmed corrections, D-40-08):',
+            trajectory,
+            '',
+            '## Rules:',
+            '- ADD: If a correction pattern is detected in messages but not in store',
+            '- UPDATE: If a term\'s weight should change based on TP/FP ratio',
+            '- REMOVE: If a term has 0 hits after many uses AND high false positive rate (>0.3)',
+            '- FALSE POSITIVE: If a term appears in trajectory but the user message doesn\'t actually express frustration (e.g., user said "wrong" but in a factual context, not emotional)',
+            '- fpAnalysisStatus: set to "completed" if you performed trajectory analysis (even if no FPs found), or "skipped" if trajectory was empty/unavailable',
+            '- Keep reasoning concise (max 100 chars)',
+            '- Weight range: 0.1-0.9',
+            '',
+            'Return strict JSON (no markdown):',
+            '{"updated": boolean, "updates": {...}, "fpTerms": ["term1", ...], "fpAnalysisStatus": "completed" | "skipped", "summary": string}',
+            'Note: fpTerms is optional — only include if you identified clear false positives.',
+        ].join('\n');
+    }
+    /**
+     * Run the simplified one-shot Correction Observer.
+     */
+    async run(input) {
+        const prompt = CorrectionObserver.buildPrompt(input);
+        // One-shot start run
+        const runHandle = await this.runtimeAdapter.startRun({
+            agentSpec: { agentId: this.agentId, schemaVersion: 'v1' },
+            taskRef: { taskId: `corr_obs_${Date.now()}` },
+            inputPayload: prompt,
+            contextItems: [],
+            outputSchemaRef: 'correction-observer-output-v1',
+            timeoutMs: this.timeoutMs,
+        });
+        // Poll until terminal
+        const deadline = Date.now() + this.timeoutMs;
+        const pollIntervalMs = 500;
+        let terminal = false;
+        while (Date.now() < deadline) {
+            const status = await this.runtimeAdapter.pollRun(runHandle.runId);
+            if (status.status === 'succeeded') {
+                terminal = true;
+                break;
+            }
+            if (status.status === 'failed' || status.status === 'timed_out' || status.status === 'cancelled') {
+                throw new Error(`CorrectionObserver run failed: ${status.status} | reason: ${status.reason ?? 'unknown'}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        if (!terminal) {
+            let cancelReason = '';
+            try {
+                await this.runtimeAdapter.cancelRun(runHandle.runId);
+            }
+            catch (cancelErr) {
+                cancelReason = ` | cancelFailed: ${String(cancelErr)}`;
+            }
+            throw new Error(`CorrectionObserver run timed out after ${this.timeoutMs}ms${cancelReason}`);
+        }
+        // Fetch and parse output
+        const outputResult = await this.runtimeAdapter.fetchOutput(runHandle.runId);
+        if (!outputResult?.payload) {
+            throw new Error(`CorrectionObserver run yielded empty output`);
+        }
+        const payload = outputResult.payload;
+        // Strict runtime schema verification
+        const VALID_ACTIONS = new Set(['add', 'update', 'remove']);
+        if (typeof payload.updated !== 'boolean' ||
+            typeof payload.summary !== 'string') {
+            throw new Error(`CorrectionObserver output validation failed: ${JSON.stringify(payload).substring(0, 200)}`);
+        }
+        if (payload.updates !== undefined && payload.updates !== null) {
+            if (typeof payload.updates !== 'object' || Array.isArray(payload.updates)) {
+                throw new Error(`CorrectionObserver output validation failed: updates must be a record, got ${typeof payload.updates}`);
+            }
+            for (const [key, val] of Object.entries(payload.updates)) {
+                if (typeof val !== 'object' || val === null || Array.isArray(val)) {
+                    throw new Error(`CorrectionObserver output validation failed: updates["${key}"] must be an object, got ${typeof val}`);
+                }
+                const entry = val;
+                if (!VALID_ACTIONS.has(entry.action)) {
+                    throw new Error(`CorrectionObserver output validation failed: updates["${key}"].action must be add|update|remove, got "${String(entry.action)}"`);
+                }
+                if (typeof entry.reasoning !== 'string') {
+                    throw new Error(`CorrectionObserver output validation failed: updates["${key}"].reasoning must be a string, got ${typeof entry.reasoning}`);
+                }
+            }
+        }
+        if (payload.fpTerms !== undefined && payload.fpTerms !== null) {
+            if (!Array.isArray(payload.fpTerms)) {
+                throw new Error(`CorrectionObserver output validation failed: fpTerms must be an array, got ${typeof payload.fpTerms}`);
+            }
+            for (let i = 0; i < payload.fpTerms.length; i++) {
+                if (typeof payload.fpTerms[i] !== 'string') {
+                    throw new Error(`CorrectionObserver output validation failed: fpTerms[${i}] must be a string, got ${typeof payload.fpTerms[i]}`);
+                }
+            }
+        }
+        if (payload.fpAnalysisStatus !== undefined && payload.fpAnalysisStatus !== null) {
+            if (payload.fpAnalysisStatus !== 'completed' && payload.fpAnalysisStatus !== 'skipped') {
+                throw new Error(`CorrectionObserver output validation failed: fpAnalysisStatus must be completed|skipped, got "${String(payload.fpAnalysisStatus)}"`);
+            }
+        }
+        return payload;
+    }
+}
+//# sourceMappingURL=correction-observer.js.map

package/dist/runtime-v2/observer/correction-observer.js.map

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

package/dist/runtime-v2/observer/empathy-observer.d.ts

@@ -0,0 +1,35 @@
+import { type Static } from '@sinclair/typebox';
+import type { PDRuntimeAdapter } from '../runtime-protocol.js';
+export declare const EmpathyObserverInputSchema: import("@sinclair/typebox").TObject<{
+    userMessage: import("@sinclair/typebox").TString;
+}>;
+export type EmpathyObserverInput = Static<typeof EmpathyObserverInputSchema>;
+export declare const EmpathyObserverOutputV1Schema: import("@sinclair/typebox").TObject<{
+    damageDetected: import("@sinclair/typebox").TBoolean;
+    severity: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"mild">, import("@sinclair/typebox").TLiteral<"moderate">, import("@sinclair/typebox").TLiteral<"severe">]>;
+    confidence: import("@sinclair/typebox").TNumber;
+    reason: import("@sinclair/typebox").TString;
+}>;
+export type EmpathyObserverOutputV1 = Static<typeof EmpathyObserverOutputV1Schema>;
+export interface EmpathyObserverDeps {
+    readonly runtimeAdapter: PDRuntimeAdapter;
+}
+export interface EmpathyObserverOptions {
+    readonly timeoutMs?: number;
+    readonly agentId?: string;
+}
+export declare class EmpathyObserver {
+    private readonly runtimeAdapter;
+    private readonly timeoutMs;
+    private readonly agentId;
+    constructor(deps: EmpathyObserverDeps, options?: EmpathyObserverOptions);
+    /**
+     * Builds the prompt exactly replicating the legacy empathyObserverWorkflowSpec
+     */
+    static buildPrompt(userMessage: string): string;
+    /**
+     * Run the simplified one-shot Empathy Observer.
+     */
+    run(input: EmpathyObserverInput): Promise<EmpathyObserverOutputV1>;
+}
+//# sourceMappingURL=empathy-observer.d.ts.map

package/dist/runtime-v2/observer/empathy-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empathy-observer.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/observer/empathy-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,eAAO,MAAM,0BAA0B;;EAErC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE7E,eAAO,MAAM,6BAA6B;;;;;EASxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAInF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAMvE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAS/C;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAmEzE"}

package/dist/runtime-v2/observer/empathy-observer.js

@@ -0,0 +1,98 @@
+import { Type } from '@sinclair/typebox';
+// ── Schemas ──────────────────────────────────────────────────────────────────
+export const EmpathyObserverInputSchema = Type.Object({
+    userMessage: Type.String({ minLength: 1 }),
+});
+export const EmpathyObserverOutputV1Schema = Type.Object({
+    damageDetected: Type.Boolean(),
+    severity: Type.Union([
+        Type.Literal('mild'),
+        Type.Literal('moderate'),
+        Type.Literal('severe'),
+    ]),
+    confidence: Type.Number({ minimum: 0, maximum: 1 }),
+    reason: Type.String(),
+});
+export class EmpathyObserver {
+    runtimeAdapter;
+    timeoutMs;
+    agentId;
+    constructor(deps, options) {
+        this.runtimeAdapter = deps.runtimeAdapter;
+        this.timeoutMs = options?.timeoutMs ?? 30_000;
+        this.agentId = options?.agentId ?? 'empathy-observer';
+    }
+    /**
+     * Builds the prompt exactly replicating the legacy empathyObserverWorkflowSpec
+     */
+    static buildPrompt(userMessage) {
+        return [
+            'You are an empathy observer.',
+            'Analyze ONLY the user message and return strict JSON (no markdown):',
+            '{"damageDetected": boolean, "severity": "mild|moderate|severe", "confidence": number, "reason": string}',
+            `User message: ${JSON.stringify(userMessage.trim())}`,
+        ].join('\n');
+    }
+    /**
+     * Run the simplified one-shot Empathy Observer.
+     */
+    async run(input) {
+        const prompt = EmpathyObserver.buildPrompt(input.userMessage);
+        // One-shot start run
+        const runHandle = await this.runtimeAdapter.startRun({
+            agentSpec: { agentId: this.agentId, schemaVersion: 'v1' },
+            taskRef: { taskId: `emp_obs_${Date.now()}` },
+            inputPayload: prompt,
+            contextItems: [],
+            outputSchemaRef: 'empathy-observer-output-v1',
+            timeoutMs: this.timeoutMs,
+        });
+        // Poll until terminal
+        const deadline = Date.now() + this.timeoutMs;
+        const pollIntervalMs = 500;
+        let terminal = false;
+        while (Date.now() < deadline) {
+            const status = await this.runtimeAdapter.pollRun(runHandle.runId);
+            if (status.status === 'succeeded') {
+                terminal = true;
+                break;
+            }
+            if (status.status === 'failed' || status.status === 'timed_out' || status.status === 'cancelled') {
+                throw new Error(`EmpathyObserver run failed: ${status.status} | reason: ${status.reason ?? 'unknown'}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        if (!terminal) {
+            let cancelReason = '';
+            try {
+                await this.runtimeAdapter.cancelRun(runHandle.runId);
+            }
+            catch (cancelErr) {
+                cancelReason = ` | cancelFailed: ${String(cancelErr)}`;
+            }
+            throw new Error(`EmpathyObserver run timed out after ${this.timeoutMs}ms${cancelReason}`);
+        }
+        // Fetch and parse output
+        const outputResult = await this.runtimeAdapter.fetchOutput(runHandle.runId);
+        if (!outputResult?.payload) {
+            throw new Error(`EmpathyObserver run yielded empty output`);
+        }
+        const payload = outputResult.payload;
+        // Strict runtime schema verification
+        if (typeof payload.damageDetected !== 'boolean' ||
+            !['mild', 'moderate', 'severe'].includes(payload.severity) ||
+            typeof payload.confidence !== 'number' ||
+            payload.confidence < 0 ||
+            payload.confidence > 1 ||
+            typeof payload.reason !== 'string') {
+            throw new Error(`EmpathyObserver output validation failed: ${JSON.stringify(payload).substring(0, 200)}`);
+        }
+        return {
+            damageDetected: payload.damageDetected,
+            severity: payload.severity,
+            confidence: payload.confidence,
+            reason: payload.reason,
+        };
+    }
+}
+//# sourceMappingURL=empathy-observer.js.map

package/dist/runtime-v2/observer/empathy-observer.js.map

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

package/dist/runtime-v2/operator-health-read-model.d.ts

@@ -0,0 +1,45 @@
+import { PainChainReadModel } from './pain-chain-read-model.js';
+import type { PainChainTrace } from './pain-chain-read-model.js';
+import { PruningReadModel } from './pruning-read-model.js';
+import type { CandidateAuditResult } from './candidate-audit.js';
+import type { GfiWorkspaceSnapshot } from './gfi/gfi-read-model.js';
+export type OverallHealthStatus = 'healthy' | 'degraded' | 'error';
+export interface OperatorHealthSnapshot {
+    generatedAt: string;
+    workspace: string;
+    painChain: {
+        lastSuccessfulChain: PainChainTrace | null;
+        failureCategory: string | null;
+    };
+    candidateLedger: {
+        auditStatus: CandidateAuditResult['status'];
+        orphanCandidateCount: number;
+        missingLedgerCount: number;
+    };
+    pruning: {
+        watchCount: number;
+        reviewCount: number;
+        orphanDerivedCandidateCount: number;
+    };
+    gfi: GfiWorkspaceSnapshot;
+    overallStatus: OverallHealthStatus;
+    recommendedActions: string[];
+    /** Total number of tasks in the workspace DB. Used to distinguish cold-start (0 tasks) from real degradation (tasks exist but no successful chain). */
+    totalTaskCount: number;
+}
+export interface OperatorHealthReadModelOptions {
+    workspaceDir: string;
+    painChainReadModel?: PainChainReadModel;
+    pruningReadModel?: PruningReadModel;
+}
+export declare class OperatorHealthReadModel {
+    private readonly workspaceDir;
+    private readonly injectedPainChainReadModel;
+    private readonly injectedPruningReadModel;
+    private ownedPainChainReadModel;
+    private ownedPruningReadModel;
+    constructor(opts: OperatorHealthReadModelOptions);
+    getSnapshot(): Promise<OperatorHealthSnapshot>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=operator-health-read-model.d.ts.map

package/dist/runtime-v2/operator-health-read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-health-read-model.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/operator-health-read-model.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AASpE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE;QACT,mBAAmB,EAAE,cAAc,GAAG,IAAI,CAAC;QAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,eAAe,EAAE;QACf,WAAW,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC5C,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,2BAA2B,EAAE,MAAM,CAAC;KACrC,CAAC;IACF,GAAG,EAAE,oBAAoB,CAAC;IAC1B,aAAa,EAAE,mBAAmB,CAAC;IACnC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,uJAAuJ;IACvJ,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAiDD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAiC;IAC5E,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA+B;IACxE,OAAO,CAAC,uBAAuB,CAAmC;IAClE,OAAO,CAAC,qBAAqB,CAAiC;gBAElD,IAAI,EAAE,8BAA8B;IAM1C,WAAW,IAAI,OAAO,CAAC,sBAAsB,CAAC;IA4I9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}

package/dist/runtime-v2/operator-health-read-model.js

@@ -0,0 +1,189 @@
+/**
+ * OperatorHealthReadModel — composite read-only health snapshot for Runtime V2.
+ *
+ * Aggregates chain reliability, candidate/ledger consistency, and pruning
+ * lifecycle signals into a single operator-facing snapshot.
+ *
+ * PRI-28: Operator health snapshot.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { PainChainReadModel } from './pain-chain-read-model.js';
+import { PruningReadModel } from './pruning-read-model.js';
+import { auditCandidateLedgerConsistency } from './candidate-audit.js';
+import { buildGfiWorkspaceSnapshot, classifyGfiWorkspaceHealth } from './gfi/gfi-read-model.js';
+// ── Thresholds ────────────────────────────────────────────────────────────────
+const ORPHAN_DERIVED_CANDIDATE_COUNT_THRESHOLD = 10;
+function readPersistedSessions(workspaceDir) {
+    const sessionDir = path.join(workspaceDir, '.state', 'sessions');
+    if (!fs.existsSync(sessionDir)) {
+        return [];
+    }
+    const sessions = [];
+    for (const file of fs.readdirSync(sessionDir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        try {
+            const raw = fs.readFileSync(path.join(sessionDir, file), 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed?.sessionId) {
+                sessions.push({
+                    sessionId: parsed.sessionId ?? file.replace('.json', ''),
+                    currentGfi: parsed.currentGfi ?? 0,
+                    gfiBySource: parsed.gfiBySource,
+                    lastErrorSource: parsed.lastErrorSource,
+                    consecutiveErrors: parsed.consecutiveErrors ?? 0,
+                    lastGfiDecayAt: parsed.lastGfiDecayAt,
+                    dailyGfiPeak: parsed.dailyGfiPeak,
+                    lastActivityAt: parsed.lastActivityAt ?? parsed.lastControlActivityAt ?? 0,
+                });
+            }
+        }
+        catch {
+            // skip malformed session files
+        }
+    }
+    return sessions;
+}
+export class OperatorHealthReadModel {
+    workspaceDir;
+    injectedPainChainReadModel;
+    injectedPruningReadModel;
+    ownedPainChainReadModel = null;
+    ownedPruningReadModel = null;
+    constructor(opts) {
+        this.workspaceDir = opts.workspaceDir;
+        this.injectedPainChainReadModel = opts.painChainReadModel;
+        this.injectedPruningReadModel = opts.pruningReadModel;
+    }
+    async getSnapshot() {
+        const generatedAt = new Date().toISOString();
+        const recommendedActions = [];
+        const pdDbPath = path.join(this.workspaceDir, '.pd', 'state.db');
+        const dbExists = fs.existsSync(pdDbPath);
+        // ── Candidate/ledger audit ────────────────────────────────────────────
+        const audit = await auditCandidateLedgerConsistency(this.workspaceDir);
+        // ── Pain chain read model (also used for task-count) ───────────────────
+        const painChainReadModel = this.injectedPainChainReadModel
+            ?? new PainChainReadModel({ workspaceDir: this.workspaceDir });
+        if (!this.injectedPainChainReadModel) {
+            this.ownedPainChainReadModel = painChainReadModel;
+        }
+        // ── Task count (for cold-start vs. real-degradation discrimination) ───
+        let totalTaskCount = 0;
+        try {
+            totalTaskCount = await painChainReadModel.getTotalTaskCount();
+        }
+        catch {
+            // graceful — task count stays 0
+        }
+        // ── Pain chain ────────────────────────────────────────────────────────
+        let lastSuccessfulChain = null;
+        let failureCategory = null;
+        try {
+            const chain = await painChainReadModel.getLastSuccessfulChain();
+            lastSuccessfulChain = chain ?? null;
+            failureCategory = chain?.failureCategory ?? null;
+        }
+        catch {
+            // Graceful — chain section stays null
+        }
+        // ── Pruning ───────────────────────────────────────────────────────────
+        let watchCount = 0;
+        let reviewCount = 0;
+        let orphanDerivedCandidateCount = 0;
+        const pruningReadModel = this.injectedPruningReadModel
+            ?? new PruningReadModel({ workspaceDir: this.workspaceDir });
+        if (!this.injectedPruningReadModel) {
+            this.ownedPruningReadModel = pruningReadModel;
+        }
+        try {
+            const summary = pruningReadModel.getHealthSummary();
+            ({ watchCount, reviewCount, orphanDerivedCandidateCount } = summary);
+        }
+        catch {
+            // Graceful — pruning section stays zeroed
+        }
+        // ── GFI ───────────────────────────────────────────────────────────────
+        const gfi = (() => {
+            try {
+                const sessions = readPersistedSessions(this.workspaceDir);
+                return buildGfiWorkspaceSnapshot({ sessions, nowMs: Date.now() });
+            }
+            catch {
+                return {
+                    active: null,
+                    staleSessionCount: 0,
+                    staleGfiRange: null,
+                    totalSessionCount: 0,
+                    activeSessionCount: 0,
+                    generatedAt: new Date().toISOString(),
+                };
+            }
+        })();
+        // ── Compute overallStatus ─────────────────────────────────────────────
+        const gfiHealth = classifyGfiWorkspaceHealth(gfi);
+        let overallStatus = 'healthy';
+        if (!dbExists || audit.status === 'error') {
+            overallStatus = 'error';
+        }
+        else if (audit.status === 'degraded'
+            || watchCount > 0
+            || reviewCount > 0
+            || orphanDerivedCandidateCount > ORPHAN_DERIVED_CANDIDATE_COUNT_THRESHOLD
+            || gfiHealth.status === 'degraded'
+            || (lastSuccessfulChain === null && totalTaskCount > 0)) {
+            overallStatus = 'degraded';
+        }
+        // ── Build recommendedActions ──────────────────────────────────────────
+        if (!dbExists) {
+            recommendedActions.push('Initialize workspace with `pd pain record`.');
+        }
+        if (audit.status === 'error' && dbExists) {
+            recommendedActions.push('Candidate audit failed — check DB integrity with `pd candidate audit --workspace <path>`.');
+        }
+        if (audit.status === 'degraded') {
+            recommendedActions.push('Run `pd candidate audit --workspace <path> --json` for details.');
+        }
+        if (watchCount > 0 || reviewCount > 0) {
+            recommendedActions.push('Run `pd runtime pruning report --workspace <path> --json` for lifecycle signals.');
+        }
+        if (orphanDerivedCandidateCount > ORPHAN_DERIVED_CANDIDATE_COUNT_THRESHOLD) {
+            recommendedActions.push(`High orphan-derived-candidate count (${orphanDerivedCandidateCount}) — run pruning to clean up.`);
+        }
+        if (gfiHealth.status === 'degraded') {
+            recommendedActions.push(`GFI degraded: ${gfiHealth.reason} — run cleanup or investigate session lifecycle.`);
+        }
+        if (lastSuccessfulChain === null && dbExists && totalTaskCount > 0) {
+            recommendedActions.push('Run `pd runtime uat --workspace <path> --count 3` to establish baseline.');
+        }
+        if (totalTaskCount === 0 && dbExists) {
+            recommendedActions.push('Runtime V2 pipeline has never been exercised. Run `pd pain record --reason "test" --workspace <path>` to trigger the pain-to-principle chain.');
+        }
+        return {
+            generatedAt,
+            workspace: this.workspaceDir,
+            painChain: { lastSuccessfulChain, failureCategory },
+            candidateLedger: {
+                auditStatus: audit.status,
+                orphanCandidateCount: audit.orphanCandidateCount,
+                missingLedgerCount: audit.missingLedgerCount,
+            },
+            pruning: { watchCount, reviewCount, orphanDerivedCandidateCount },
+            gfi,
+            overallStatus,
+            recommendedActions,
+            totalTaskCount,
+        };
+    }
+    async close() {
+        if (this.ownedPainChainReadModel) {
+            await this.ownedPainChainReadModel.close();
+            this.ownedPainChainReadModel = null;
+        }
+        if (this.ownedPruningReadModel) {
+            this.ownedPruningReadModel = null;
+        }
+    }
+}
+//# sourceMappingURL=operator-health-read-model.js.map

package/dist/runtime-v2/operator-health-read-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-health-read-model.js","sourceRoot":"","sources":["../../src/runtime-v2/operator-health-read-model.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/pain-chain-read-model.d.ts

@@ -0,0 +1,40 @@
+import { RuntimeStateManager } from './store/runtime-state-manager.js';
+import type { FailureCategory } from './pain-to-principle-service.js';
+export interface PainChainTraceLatencyMs {
+    painToTask?: number;
+    taskToRun?: number;
+    runToArtifact?: number;
+    artifactToCandidate?: number;
+    candidateToLedger?: number;
+}
+export interface PainChainTrace {
+    painId: string;
+    taskId: string;
+    runId?: string;
+    artifactId?: string;
+    candidateIds: string[];
+    ledgerEntryIds: string[];
+    status: string;
+    latencyMs: PainChainTraceLatencyMs;
+    failureCategory: FailureCategory | null;
+    checkedAt: string;
+    missingLinks: string[];
+}
+export interface PainChainReadModelOptions {
+    workspaceDir: string;
+    stateManager?: RuntimeStateManager;
+}
+export declare class PainChainReadModel {
+    private readonly workspaceDir;
+    private stateManager;
+    private readonly injectedStateManager;
+    private ownsStateManager;
+    constructor(opts: PainChainReadModelOptions);
+    getTotalTaskCount(): Promise<number>;
+    private initialized;
+    private getStateManager;
+    traceByPainId(painId: string): Promise<PainChainTrace>;
+    getLastSuccessfulChain(): Promise<PainChainTrace | undefined>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=pain-chain-read-model.d.ts.map

package/dist/runtime-v2/pain-chain-read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pain-chain-read-model.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/pain-chain-read-model.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,uBAAuB,CAAC;IACnC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAaD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAClE,OAAO,CAAC,gBAAgB,CAAS;gBAErB,IAAI,EAAE,yBAAyB;IASrC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAW1C,OAAO,CAAC,WAAW,CAAS;YAEd,eAAe;IAYvB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAiJtD,sBAAsB,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IA8F7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}