@principles/core 1.265.1 → 1.267.0

package/dist/runtime-v2/__tests__/owner-retry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=owner-retry.test.d.ts.map

package/dist/runtime-v2/__tests__/owner-retry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-retry.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/owner-retry.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/__tests__/owner-retry.test.js

@@ -0,0 +1,144 @@
+/**
+ * owner-retry.ts tests — Governance Recovery Actions v1.
+ *
+ * The extracted owner authority reset (needs_human_review → pending, clearing
+ * runnerDecision + completionIntent atomically). CLI behavior is guarded by
+ * pd-cli's runtime-internalization-retry-owner-authority tests against the
+ * SAME shared function; these tests exercise the function directly and via
+ * the RecoverySweepService production path (EP-02: real RuntimeStateManager +
+ * real SQLite temp workspace — no store mocks).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { RuntimeStateManager } from '../store/runtime-state-manager.js';
+import { hydratePITaskRecord, createPITaskDiagnosticJson, } from '../internalization/pitask-metadata.js';
+import { ownerRetryNeedsHumanReviewTask } from '../internalization/owner-retry.js';
+import { createRecoverySweepService } from '../recovery-sweep-service.js';
+const TASK_ID = 'rollout_reviewer-owner-retry-core';
+let workspaceDir;
+let stateManager;
+function intent(status) {
+    return {
+        decision: 'needs_revision',
+        sourceRunId: 'run-core-1',
+        revisionEpoch: 1,
+        status,
+        effect: 'needs_human_review',
+    };
+}
+async function seedNeedsHumanReview(opts = {}) {
+    await stateManager.createTask({
+        taskId: opts.taskId ?? TASK_ID,
+        taskKind: 'rollout_reviewer',
+        status: 'needs_human_review',
+        attemptCount: 2,
+        maxAttempts: 3,
+        diagnosticJson: opts.diagnosticJson ??
+            createPITaskDiagnosticJson({
+                dependencyTaskIds: ['evaluator-1'],
+                channel: 'prompt',
+                timeoutMs: 300_000,
+                inputArtifactRefs: [],
+                outputArtifactRefs: [],
+                correlationId: 'owner-retry-core',
+                ...opts.meta,
+            }),
+    });
+}
+async function readTask(taskId = TASK_ID) {
+    return stateManager.getTask(taskId);
+}
+beforeEach(async () => {
+    workspaceDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-owner-retry-core-'));
+    stateManager = new RuntimeStateManager({ workspaceDir });
+    await stateManager.initialize();
+});
+afterEach(async () => {
+    await stateManager.close();
+    try {
+        fs.rmSync(workspaceDir, { recursive: true, force: true });
+    }
+    catch {
+        /* temp */
+    }
+});
+describe('ownerRetryNeedsHumanReviewTask (direct function)', () => {
+    it('resets status/attemptCount and clears runnerDecision + completionIntent', async () => {
+        await seedNeedsHumanReview({
+            meta: { runnerDecision: 'needs_revision', completionIntent: intent('applied') },
+        });
+        const outcome = await ownerRetryNeedsHumanReviewTask(stateManager, TASK_ID);
+        expect(outcome).toEqual({
+            status: 'requeued',
+            taskKind: 'rollout_reviewer',
+            previousStatus: 'needs_human_review',
+        });
+        const task = await readTask();
+        expect(task?.status).toBe('pending');
+        expect(task?.attemptCount).toBe(0);
+        const meta = task ? hydratePITaskRecord(task) : null;
+        expect(meta).not.toBeNull();
+        expect(meta?.runnerDecision).toBeUndefined();
+        expect(meta?.completionIntent).toBeUndefined();
+        // lineage preserved
+        expect(meta?.dependencyTaskIds).toEqual(['evaluator-1']);
+        expect(meta?.channel).toBe('prompt');
+    });
+    it('returns not_found for an unknown task id (no mutation)', async () => {
+        const outcome = await ownerRetryNeedsHumanReviewTask(stateManager, 'does-not-exist');
+        expect(outcome).toEqual({ status: 'not_found' });
+    });
+    it('returns skipped (no mutation) for a task that is not needs_human_review', async () => {
+        await seedNeedsHumanReview({ taskId: 'failed-task-1' });
+        await stateManager.updateTask('failed-task-1', { status: 'failed' });
+        const outcome = await ownerRetryNeedsHumanReviewTask(stateManager, 'failed-task-1');
+        expect(outcome.status).toBe('skipped');
+        if (outcome.status === 'skipped') {
+            expect(outcome.previousStatus).toBe('failed');
+            expect(outcome.taskKind).toBe('rollout_reviewer');
+        }
+        // row untouched
+        expect((await readTask('failed-task-1'))?.status).toBe('failed');
+    });
+    it('fail-closed: metadata_invalid leaves the row completely untouched', async () => {
+        await seedNeedsHumanReview({ diagnosticJson: JSON.stringify({ note: 'not pi metadata' }) });
+        const outcome = await ownerRetryNeedsHumanReviewTask(stateManager, TASK_ID);
+        expect(outcome).toEqual({ status: 'metadata_invalid', taskKind: 'rollout_reviewer' });
+        const task = await readTask();
+        expect(task?.status).toBe('needs_human_review');
+        expect(task?.attemptCount).toBe(2);
+    });
+});
+describe('RecoverySweepService.recoverNeedsHumanReviewTask (production path)', () => {
+    it('delegates to the same sequence via the sweep service handle', async () => {
+        await seedNeedsHumanReview({
+            meta: { runnerDecision: 'needs_revision', completionIntent: intent('pending') },
+        });
+        const handle = await createRecoverySweepService({ workspaceDir });
+        try {
+            const outcome = await handle.service.recoverNeedsHumanReviewTask(TASK_ID);
+            expect(outcome.status).toBe('requeued');
+            const task = await readTask();
+            expect(task?.status).toBe('pending');
+            const meta = task ? hydratePITaskRecord(task) : null;
+            expect(meta?.runnerDecision).toBeUndefined();
+            expect(meta?.completionIntent).toBeUndefined();
+        }
+        finally {
+            await handle.close();
+        }
+    });
+    it('reports not_found through the service for an unknown id', async () => {
+        const handle = await createRecoverySweepService({ workspaceDir });
+        try {
+            const outcome = await handle.service.recoverNeedsHumanReviewTask('nope');
+            expect(outcome.status).toBe('not_found');
+        }
+        finally {
+            await handle.close();
+        }
+    });
+});
+//# sourceMappingURL=owner-retry.test.js.map

package/dist/runtime-v2/__tests__/owner-retry.test.js.map

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

package/dist/runtime-v2/__tests__/pain-diagnosis-persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pain-diagnosis-persistence.test.d.ts.map

package/dist/runtime-v2/__tests__/pain-diagnosis-persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pain-diagnosis-persistence.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/pain-diagnosis-persistence.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/__tests__/pain-diagnosis-persistence.test.js

@@ -0,0 +1,293 @@
+/**
+ * Pain Diagnosis Persistence regression tests (Pain Diagnosis Persistence
+ * SPEC v1.1 §12).
+ *
+ * Coverage required by the SPEC:
+ *   1. Agent behavior failure → persisted diagnosis category People.
+ *   2. Environment failure → persisted diagnosis category Tooling.
+ *   3. Mixed failure → multiple diagnosis rows sharing one pain_id (no Mixed enum).
+ *   4. Principle pollution → a software-bug (Design/Tooling) diagnosis keeps its
+ *      true category and cannot masquerade as an agent-behavior (People) narrative;
+ *      the Stage A prompt only allows People with agent-behavior evidence.
+ *
+ * Plus flag-contract behavior: default off writes nothing; replay is idempotent;
+ * unparseable rootCause prefixes and store failures degrade observably (rc-9).
+ *
+ * Persistence goes through a REAL RuntimeStateManager on a temp workspace, so
+ * the schema migration (pain_diagnoses) and the sqlite round-trip are exercised.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterAll, describe, expect, it } from 'vitest';
+import { PainSignalBridge } from '../pain-signal-bridge.js';
+import { RuntimeStateManager as RuntimeStateManagerClass } from '../store/runtime-state-manager.js';
+import { SqliteConnection } from '../store/sqlite-connection.js';
+import { buildRootCauseProtocolInstruction } from '../diagnostician/rootcause-prompt-builder.js';
+import { mapBridgeTelemetryToStoreEvent } from '../pain-signal-runtime-factory.js';
+// ── Fixtures ─────────────────────────────────────────────────────────────────
+const workspaces = [];
+const managers = [];
+async function makeStateManager() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-pain-diag-'));
+    workspaces.push(dir);
+    const mgr = new RuntimeStateManagerClass({ workspaceDir: dir });
+    await mgr.initialize();
+    managers.push(mgr);
+    return mgr;
+}
+afterAll(async () => {
+    for (const mgr of managers.splice(0)) {
+        try {
+            await mgr.close();
+        }
+        catch { /* best-effort cleanup */ }
+    }
+    for (const dir of workspaces.splice(0)) {
+        fs.rmSync(dir, { recursive: true, force: true, maxRetries: 3, retryDelay: 20 });
+    }
+});
+function makeOutput(rootCause, over = {}) {
+    return {
+        valid: true,
+        diagnosisId: 'diag-001',
+        summary: 'test diagnosis summary',
+        rootCause,
+        violatedPrinciples: [],
+        evidence: [{ sourceRef: 'tool_calls:1', note: 'agent action evidence' }],
+        recommendations: [{ kind: 'defer', description: 'no actionable principle' }],
+        confidence: 0.7,
+        ...over,
+    };
+}
+function makeBridge(stateManager, opts) {
+    const ledgerAdapter = {
+        existsForCandidate: () => null,
+        writeProbationEntry: undefined,
+    };
+    return new PainSignalBridge({
+        stateManager,
+        runner: {
+            run: async (taskId) => ({ status: 'succeeded', taskId, attemptCount: 1 }),
+        },
+        intakeService: undefined,
+        ledgerAdapter,
+        autoIntakeEnabled: false,
+        diagnosisPersistenceEnabled: opts.persistenceEnabled,
+        eventEmitter: {
+            emitTelemetry: (event) => { opts.events.push({ eventType: event.eventType, payload: event.payload }); },
+        },
+    });
+}
+async function completeDiagnosis(bridge, opts) {
+    return bridge.onDiagnosisComplete({
+        taskId: opts.taskId,
+        diagnosticianOutput: opts.output,
+        painId: opts.painId,
+        provenance: 'automatic_hook',
+        inputEvidenceCount: 1,
+    });
+}
+// ── SPEC §12: Agent Failure → People ────────────────────────────────────────
+describe('pain diagnosis persistence (SPEC v1.1 §12 regression)', () => {
+    it('agent behavior failure (changed code without testing) persists category People', async () => {
+        const mgr = await makeStateManager();
+        const events = [];
+        const bridge = makeBridge(mgr, { persistenceEnabled: true, events });
+        await completeDiagnosis(bridge, {
+            painId: 'pain-agent-001',
+            taskId: 'diagnosis_pain-agent-001',
+            output: makeOutput('People: Agent modified code without running the tests first'),
+        });
+        const rows = await mgr.getDiagnosesByPainId('pain-agent-001');
+        expect(rows).toHaveLength(1);
+        expect(rows[0]?.category).toBe('People');
+        expect(rows[0]?.rootCause).toBe('People: Agent modified code without running the tests first');
+        expect(rows[0]?.diagnosisId).toBe('diag-001');
+        expect(rows[0]?.evidence).toEqual([{ sourceRef: 'tool_calls:1', note: 'agent action evidence' }]);
+        expect(rows[0]?.confidence).toBe(0.7);
+        expect(rows[0]?.artifactId).toBeNull();
+        expect(typeof rows[0]?.createdAt).toBe('string');
+    });
+    // ── SPEC §12: Environment Failure → Tooling ──────────────────────────────
+    it('environment failure (third-party API outage) persists category Tooling', async () => {
+        const mgr = await makeStateManager();
+        const bridge = makeBridge(mgr, { persistenceEnabled: true, events: [] });
+        await completeDiagnosis(bridge, {
+            painId: 'pain-env-001',
+            taskId: 'diagnosis_pain-env-001',
+            output: makeOutput('Tooling: third-party API returned 503 for every retry'),
+        });
+        const rows = await mgr.getDiagnosesByPainId('pain-env-001');
+        expect(rows).toHaveLength(1);
+        expect(rows[0]?.category).toBe('Tooling');
+    });
+    // ── SPEC §12: Mixed Failure → multiple rows per pain_id ──────────────────
+    it('mixed failure persists multiple diagnosis rows under one pain_id (no Mixed enum)', async () => {
+        const mgr = await makeStateManager();
+        const bridge = makeBridge(mgr, { persistenceEnabled: true, events: [] });
+        const painId = 'pain-mixed-001';
+        await completeDiagnosis(bridge, {
+            painId,
+            taskId: 'diagnosis_pain-mixed-001',
+            output: makeOutput('Tooling: unstable third-party API', { diagnosisId: 'diag-tooling' }),
+        });
+        await completeDiagnosis(bridge, {
+            painId,
+            taskId: 'diagnosis_pain-mixed-001-r2',
+            output: makeOutput('People: Agent added no fallback despite prior API instability', { diagnosisId: 'diag-people' }),
+        });
+        const rows = await mgr.getDiagnosesByPainId(painId);
+        expect(rows).toHaveLength(2);
+        // Same-millisecond writes make created_at tie-break on id — assert the
+        // category SET, order is not part of the contract.
+        expect([...rows.map((r) => r.category)].sort()).toEqual(['People', 'Tooling']);
+        expect(new Set(rows.map((r) => r.painId))).toEqual(new Set([painId]));
+    });
+    it('replaying the same diagnosis completion is idempotent', async () => {
+        const mgr = await makeStateManager();
+        const bridge = makeBridge(mgr, { persistenceEnabled: true, events: [] });
+        const call = {
+            painId: 'pain-replay-001',
+            taskId: 'diagnosis_pain-replay-001',
+            output: makeOutput('Design: missing validation gate'),
+        };
+        await completeDiagnosis(bridge, call);
+        await completeDiagnosis(bridge, call);
+        const rows = await mgr.getDiagnosesByPainId('pain-replay-001');
+        expect(rows).toHaveLength(1);
+    });
+    // ── SPEC §12: Principle Pollution ────────────────────────────────────────
+    it('software-bug diagnosis keeps its Design category — attribution cannot drift to People', async () => {
+        const mgr = await makeStateManager();
+        const bridge = makeBridge(mgr, { persistenceEnabled: true, events: [] });
+        // A bug in PD itself, which the agent legitimately worked around: the
+        // persisted attribution must remain Design so a future agent Principle
+        // cannot be justified by re-reading this pain's history as "agent error".
+        await completeDiagnosis(bridge, {
+            painId: 'pain-pollution-001',
+            taskId: 'diagnosis_pain-pollution-001',
+            output: makeOutput('Design: PD failed to close the DB handle before renaming the workspace', { confidence: 0.9 }),
+        });
+        const rows = await mgr.getDiagnosesByPainId('pain-pollution-001');
+        expect(rows).toHaveLength(1);
+        expect(rows[0]?.category).toBe('Design');
+        expect(rows[0]?.rootCause).not.toMatch(/^People:/);
+    });
+    it('prompt requires agent-behavior evidence for People — failure is not automatically an agent error', () => {
+        const prompt = buildRootCauseProtocolInstruction({ evidenceFirstAttribution: true });
+        expect(prompt).toContain('Evidence First Attribution');
+        expect(prompt).toContain('A failure event is NOT automatically an agent error');
+        expect(prompt).toContain('Never classify as People without evidence of an avoidable agent action');
+        // SPEC §6: the five People-leaning behaviors are stated explicitly.
+        expect(prompt).toContain('without investigating');
+        expect(prompt).toContain('skipped verification or testing');
+        expect(prompt).toContain('ignored an already-active principle');
+        expect(prompt).toContain('high-risk action without checking');
+        expect(prompt).toContain('repeated the same class of error');
+    });
+    it('prompt is byte-identical when the flag is off (default) — no attribution semantics ship by default', () => {
+        const off = buildRootCauseProtocolInstruction();
+        expect(off).toBe(buildRootCauseProtocolInstruction({ evidenceFirstAttribution: false }));
+        expect(off).not.toContain('Evidence First Attribution');
+        expect(off).not.toContain('automatically an agent error');
+    });
+    // ── Flag default / degradation contract ───────────────────────────────────
+    it('flag off (default) writes no diagnosis rows', async () => {
+        const mgr = await makeStateManager();
+        const bridge = makeBridge(mgr, { persistenceEnabled: false, events: [] });
+        await completeDiagnosis(bridge, {
+            painId: 'pain-off-001',
+            taskId: 'diagnosis_pain-off-001',
+            output: makeOutput('People: Agent modified code without running the tests first'),
+        });
+        expect(await mgr.getDiagnosesByPainId('pain-off-001')).toHaveLength(0);
+    });
+    it('unparseable rootCause prefix skips the write observably (rc-9)', async () => {
+        const mgr = await makeStateManager();
+        const events = [];
+        const bridge = makeBridge(mgr, { persistenceEnabled: true, events });
+        await completeDiagnosis(bridge, {
+            painId: 'pain-noprefix-001',
+            taskId: 'diagnosis_pain-noprefix-001',
+            output: makeOutput('Something went wrong with no category prefix'),
+        });
+        expect(await mgr.getDiagnosesByPainId('pain-noprefix-001')).toHaveLength(0);
+        const skipped = events.filter((e) => e.eventType === 'pain_diagnosis_persist_skipped');
+        expect(skipped).toHaveLength(1);
+        expect(skipped[0]?.payload.reason).toBe('unparseable_root_cause_prefix');
+        expect(typeof skipped[0]?.payload.nextAction).toBe('string');
+    });
+    it('store failure degrades observably and does not break the admission flow', async () => {
+        const mgr = await makeStateManager();
+        const events = [];
+        const failing = Object.assign(Object.create(Object.getPrototypeOf(mgr)), mgr, {
+            recordPainDiagnosis: async () => { throw new Error('injected store failure'); },
+        });
+        const bridge = makeBridge(failing, { persistenceEnabled: true, events });
+        await expect(completeDiagnosis(bridge, {
+            painId: 'pain-storefail-001',
+            taskId: 'diagnosis_pain-storefail-001',
+            output: makeOutput('Tooling: store unavailable'),
+        })).resolves.toBeDefined();
+        const failed = events.filter((e) => e.eventType === 'pain_diagnosis_persist_failed');
+        expect(failed).toHaveLength(1);
+        expect(String(failed[0]?.payload.reason)).toContain('injected store failure');
+        expect(typeof failed[0]?.payload.nextAction).toBe('string');
+    });
+    // ── Schema migration ──────────────────────────────────────────────────────
+    it('existing state.db gains the pain_diagnoses table on next open', async () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-pain-diag-mig-'));
+        workspaces.push(dir);
+        const first = new SqliteConnection(dir);
+        const db = first.getDb();
+        expect(db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='pain_diagnoses'").get()).toBeDefined();
+        // Simulate a pre-feature database by dropping the table, then reopen.
+        db.prepare('DROP TABLE pain_diagnoses').run();
+        first.close();
+        const second = new SqliteConnection(dir);
+        const db2 = second.getDb();
+        expect(db2.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='pain_diagnoses'").get()).toBeDefined();
+        second.close();
+    });
+});
+// ── Factory telemetry wiring ─────────────────────────────────────────────────
+describe('pain diagnosis persistence — factory telemetry forwarding', () => {
+    // The production factory (createPainSignalBridge) is the ONLY place the
+    // bridge gets an eventEmitter. Before this feature, no emitter was wired,
+    // so the bridge's pre-existing event sites (candidate_admission_decision,
+    // candidate_dreamer_task_seeded, …) were dormant. Wiring the emitter must
+    // not wake them up as degradation_triggered — routine admission decisions
+    // are not degradations, and flag-off behavior must stay identical to main.
+    it('maps persistence degradation events onto degradation_triggered with originalEventType preserved', () => {
+        const mapped = mapBridgeTelemetryToStoreEvent({
+            eventType: 'pain_diagnosis_persist_failed',
+            traceId: 'pain-1',
+            timestamp: '2026-08-24T00:00:00.000Z',
+            payload: { reason: 'boom', nextAction: 'inspect' },
+        });
+        expect(mapped).toEqual({
+            eventType: 'degradation_triggered',
+            traceId: 'pain-1',
+            timestamp: '2026-08-24T00:00:00.000Z',
+            sessionId: '',
+            payload: { component: 'PainSignalBridge', originalEventType: 'pain_diagnosis_persist_failed', reason: 'boom', nextAction: 'inspect' },
+        });
+    });
+    it('keeps pre-existing bridge events dormant — admission decisions are NOT degradation_triggered (negative control)', () => {
+        for (const eventType of [
+            'candidate_admission_decision',
+            'candidate_dreamer_task_seeded',
+            'candidate_dreamer_task_seed_failed',
+            'candidate_not_internalizable',
+        ]) {
+            expect(mapBridgeTelemetryToStoreEvent({
+                eventType,
+                traceId: 'cand-1',
+                timestamp: '2026-08-24T00:00:00.000Z',
+                payload: { decision: 'accepted' },
+            })).toBeNull();
+        }
+    });
+});
+//# sourceMappingURL=pain-diagnosis-persistence.test.js.map

package/dist/runtime-v2/__tests__/pain-diagnosis-persistence.test.js.map

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

package/dist/runtime-v2/__tests__/recovery-actions-log.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recovery-actions-log.test.d.ts.map

package/dist/runtime-v2/__tests__/recovery-actions-log.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-actions-log.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/recovery-actions-log.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/__tests__/recovery-actions-log.test.js

@@ -0,0 +1,112 @@
+/**
+ * RecoveryActionsLog unit tests — Governance Recovery Actions v1 (SPEC §10).
+ *
+ * Tests the append-only JSONL audit log for owner-triggered recovery actions.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { appendRecoveryAction, listRecoveryActions } from '../recovery-actions-log.js';
+describe('RecoveryActionsLog', () => {
+    let tmpDir = '';
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'recovery-actions-log-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('append creates .state/recovery_actions.jsonl', () => {
+        appendRecoveryAction(tmpDir, {
+            taskId: 'dreamer-chain-1',
+            previousStatus: 'failed',
+            result: 'recovered',
+            operator: 'console',
+            reason: 'Owner approved retry after reviewing failure',
+        });
+        const logPath = path.join(tmpDir, '.state', 'recovery_actions.jsonl');
+        expect(fs.existsSync(logPath)).toBe(true);
+    });
+    it('append returns record with SPEC §10 minimal fields', () => {
+        const record = appendRecoveryAction(tmpDir, {
+            taskId: 'dreamer-chain-2',
+            previousStatus: 'needs_human_review',
+            result: 'requeued',
+            operator: 'console',
+            reason: null,
+        });
+        expect(typeof record.actionId).toBe('string');
+        expect(record.actionId.length).toBeGreaterThan(0);
+        expect(record.taskId).toBe('dreamer-chain-2');
+        expect(record.action).toBe('recover');
+        expect(record.previousStatus).toBe('needs_human_review');
+        expect(record.operator).toBe('console');
+        expect(record.reason).toBeNull();
+        expect(record.createdAt).toBeTruthy();
+        expect(record.result).toBe('requeued');
+    });
+    it('defaults operator to null when omitted', () => {
+        const record = appendRecoveryAction(tmpDir, {
+            taskId: 't-1',
+            previousStatus: 'failed',
+            result: 'recovered',
+        });
+        expect(record.operator).toBeNull();
+    });
+    it('bounds reason to 2000 characters (rc-8 bounded serialization)', () => {
+        const longReason = 'x'.repeat(3000);
+        const record = appendRecoveryAction(tmpDir, {
+            taskId: 't-2',
+            previousStatus: 'failed',
+            result: 'recovered',
+            reason: longReason,
+        });
+        expect(record.reason).not.toBeNull();
+        expect(record.reason.length).toBe(2000);
+    });
+    it('rejects invalid result values (fail loud, rc-3)', () => {
+        expect(() => appendRecoveryAction(tmpDir, {
+            taskId: 't-3',
+            previousStatus: 'failed',
+            // @ts-expect-error — deliberately invalid union member
+            result: 'exploded',
+        })).toThrow(/Invalid recovery result/);
+    });
+    it('list returns records oldest-first and round-trips fields', () => {
+        appendRecoveryAction(tmpDir, { taskId: 't-a', previousStatus: 'failed', result: 'recovered', operator: 'console', reason: 'first' });
+        appendRecoveryAction(tmpDir, { taskId: 't-b', previousStatus: 'needs_human_review', result: 'requeued' });
+        const records = listRecoveryActions(tmpDir);
+        expect(records.length).toBe(2);
+        expect(records[0]?.taskId).toBe('t-a');
+        expect(records[0]?.result).toBe('recovered');
+        expect(records[0]?.reason).toBe('first');
+        expect(records[1]?.taskId).toBe('t-b');
+        expect(records[1]?.operator).toBeNull();
+    });
+    it('list filters by taskId', () => {
+        appendRecoveryAction(tmpDir, { taskId: 't-a', previousStatus: 'failed', result: 'recovered' });
+        appendRecoveryAction(tmpDir, { taskId: 't-b', previousStatus: 'failed', result: 'recovered' });
+        const records = listRecoveryActions(tmpDir, { taskId: 't-b' });
+        expect(records.length).toBe(1);
+        expect(records[0]?.taskId).toBe('t-b');
+    });
+    it('list returns [] when log file does not exist', () => {
+        expect(listRecoveryActions(tmpDir)).toEqual([]);
+    });
+    it('list skips corrupt and shape-invalid lines (rc-1/rc-2)', () => {
+        const stateDir = path.join(tmpDir, '.state');
+        fs.mkdirSync(stateDir, { recursive: true });
+        const logPath = path.join(stateDir, 'recovery_actions.jsonl');
+        const good = appendRecoveryAction(tmpDir, { taskId: 't-good', previousStatus: 'failed', result: 'recovered' });
+        fs.appendFileSync(logPath, [
+            'not json at all\n',
+            JSON.stringify({ taskId: 'missing every other field' }) + '\n',
+            JSON.stringify({ actionId: 'x', taskId: 't-wrong-result', action: 'recover', previousStatus: 'failed', operator: null, reason: null, createdAt: 'now', result: 'not-a-real-result' }) + '\n',
+        ].join(''), 'utf-8');
+        const records = listRecoveryActions(tmpDir);
+        expect(records.length).toBe(1);
+        expect(records[0]?.taskId).toBe('t-good');
+        expect(records[0]?.actionId).toBe(good.actionId);
+    });
+});
+//# sourceMappingURL=recovery-actions-log.test.js.map

package/dist/runtime-v2/__tests__/recovery-actions-log.test.js.map

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

package/dist/runtime-v2/diagnostician/rootcause-prompt-builder.d.ts

@@ -47,6 +47,16 @@ export interface RootCausePromptBuilderOptions {
      * byte-identical to the pre-PRI-468 prompt (EP-03: no silent fallback).
      */
     intentGrounding?: boolean;
+    /**
+     * Evidence First Attribution (Pain Diagnosis Persistence SPEC §2.2/§6,
+     * gated by the `pain_diagnosis_persistence` flag; default: false).
+     *
+     * When true, inserts attribution rules that constrain PHASE 3 classification
+     * to be evidence-driven (People only on agent-avoidable-behavior evidence,
+     * never as a default). When false/undefined, the prompt is byte-identical
+     * to the pre-feature prompt (EP-03: no silent fallback).
+     */
+    evidenceFirstAttribution?: boolean;
 }
 /**
  * Build the Stage A diagnostic protocol instruction (PHASE 1–3 + optional PHASE 3.5).