@principles/core 1.73.0

package/dist/runtime-v2/store/task-migration.js

@@ -0,0 +1,79 @@
+/**
+ * Migration bridge from legacy EvolutionQueueItem to TaskRecord.
+ *
+ * Provides the transformation logic that adapters can use to translate
+ * between the legacy queue format and the new TaskRecord format.
+ */
+export class EvolutionQueueItemMigrator {
+    taskStore;
+    constructor(taskStore) {
+        this.taskStore = taskStore;
+    }
+    /**
+     * Map legacy EvolutionQueueItem status to PDTaskStatus.
+     * Returns null if the status is unrecognized (skip migration).
+     */
+    static mapLegacyStatus(legacyStatus) {
+        const mapping = {
+            pending: 'pending',
+            in_progress: 'leased',
+            completed: 'succeeded',
+            failed: 'failed',
+            canceled: 'failed',
+        };
+        return mapping[legacyStatus] ?? null;
+    }
+    /**
+     * Transform a legacy EvolutionQueueItem to TaskRecord fields.
+     * Only includes fields that are safe to migrate — lease fields are NOT migrated
+     * since the legacy queue had no lease concept.
+     */
+    static toTaskRecord(legacyItem) {
+        const newStatus = EvolutionQueueItemMigrator.mapLegacyStatus(legacyItem.status);
+        if (!newStatus)
+            return null;
+        return {
+            taskId: legacyItem.taskId,
+            taskKind: legacyItem.taskKind,
+            status: newStatus,
+            attemptCount: legacyItem.attemptCount ?? 0,
+            maxAttempts: legacyItem.maxAttempts ?? 3,
+            inputRef: legacyItem.inputRef,
+            resultRef: legacyItem.resultRef,
+            lastError: legacyItem.lastError,
+        };
+    }
+    /**
+     * Migrate a single legacy item (idempotent).
+     * If task already exists in store, compares updatedAt and only overwrites if legacy is newer.
+     */
+    async migrateOne(legacyItem) {
+        const record = EvolutionQueueItemMigrator.toTaskRecord(legacyItem);
+        if (!record) {
+            return { migrated: false, reason: 'unknown_status' };
+        }
+        const existing = await this.taskStore.getTask(record.taskId);
+        if (existing) {
+            // Idempotent: only overwrite if legacy is newer
+            const legacyUpdated = legacyItem.updatedAt ? new Date(legacyItem.updatedAt) : null;
+            const existingUpdated = new Date(existing.updatedAt);
+            if (legacyUpdated && legacyUpdated <= existingUpdated) {
+                return { migrated: false, reason: 'existing_newer' };
+            }
+            // Update existing record
+            await this.taskStore.updateTask(record.taskId, {
+                status: record.status,
+                attemptCount: record.attemptCount,
+                maxAttempts: record.maxAttempts,
+                lastError: record.lastError,
+                inputRef: record.inputRef,
+                resultRef: record.resultRef,
+            });
+            return { migrated: true, reason: 'updated_existing' };
+        }
+        // Create new record
+        await this.taskStore.createTask(record);
+        return { migrated: true, reason: 'created_new' };
+    }
+}
+//# sourceMappingURL=task-migration.js.map

package/dist/runtime-v2/store/task-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-migration.js","sourceRoot":"","sources":["../../../src/runtime-v2/store/task-migration.ts"],"names":[],"mappings":"AAuCA;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,YAAoB;QACzC,MAAM,OAAO,GAAiC;YAC5C,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,QAAQ;YACrB,SAAS,EAAE,WAAW;YACtB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,QAAQ;SACnB,CAAC;QACF,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CACjB,UAWC;QAED,MAAM,SAAS,GAAG,0BAA0B,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5B,OAAO;YACL,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,CAAC;YAC1C,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,CAAC;YACxC,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,SAAS,EAAE,UAAU,CAAC,SAAoC;SAC3D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CACd,UAWC;QAED,MAAM,MAAM,GAAG,0BAA0B,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,gDAAgD;YAChD,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnF,MAAM,eAAe,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,aAAa,IAAI,aAAa,IAAI,eAAe,EAAE,CAAC;gBACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YACvD,CAAC;YACD,yBAAyB;YACzB,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE;gBAC7C,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;YACH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxD,CAAC;QAED,oBAAoB;QACpB,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnD,CAAC;CACF"}

package/dist/runtime-v2/store/trajectory/index.d.ts

@@ -0,0 +1,5 @@
+export type { TrajectoryLocator } from './trajectory-locator.js';
+export { SqliteTrajectoryLocator } from './sqlite-trajectory-locator.js';
+export type { SourceTraceLocator, SourceTraceLocateDecision, SourceTraceLocateQuery, SourceTraceLocateResult, SourceTraceCandidate } from './source-trace-locator.js';
+export { SqliteSourceTraceLocator } from './sqlite-source-trace-locator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/store/trajectory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/trajectory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtK,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/runtime-v2/store/trajectory/index.js

@@ -0,0 +1,3 @@
+export { SqliteTrajectoryLocator } from './sqlite-trajectory-locator.js';
+export { SqliteSourceTraceLocator } from './sqlite-source-trace-locator.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/store/trajectory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/trajectory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/runtime-v2/store/trajectory/source-trace-locator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SourceTraceLocator -- contract for resolving source pain trajectories.
+ *
+ * A "source trace" is the original execution trajectory that caused a pain
+ * signal, NOT the Diagnostician task's own runs. This contract formalizes
+ * the lookup semantics that were previously inline in SqliteContextAssembler.
+ *
+ * Key semantics:
+ *   - sourcePainId is mandatory for a `found` result
+ *   - sessionIdHint narrows search scope but cannot produce a candidate alone
+ *   - excludeTaskIds prevents self-trace (Diagnostician task seeing its own runs)
+ *   - Ambiguous = multiple matching candidates → candidate = null
+ *   - Mismatch = candidate found but painId doesn't match → source_pain_mismatch
+ *   - Malformed diagnosticJson → recorded as reason, doesn't crash lookup
+ *   - Storage errors → fail loud via PDRuntimeError, never silently swallowed
+ */
+export type SourceTraceLocateDecision = 'found' | 'missing_source_pain_id' | 'missing_session_hint' | 'not_found' | 'ambiguous' | 'source_pain_mismatch' | 'storage_unavailable';
+export interface SourceTraceLocateQuery {
+    sourcePainId?: string;
+    sessionIdHint?: string;
+    workspaceDir?: string;
+    excludeTaskIds?: string[];
+}
+export interface SourceTraceCandidate {
+    taskId: string;
+    sourcePainId: string;
+    confidence: number;
+    reasons: string[];
+    sourceTypes: string[];
+}
+export interface SourceTraceLocateResult {
+    decision: SourceTraceLocateDecision;
+    candidate: SourceTraceCandidate | null;
+    candidates: SourceTraceCandidate[];
+    ambiguityNotes: string[];
+}
+export interface SourceTraceLocator {
+    locate(query: SourceTraceLocateQuery): Promise<SourceTraceLocateResult>;
+}
+//# sourceMappingURL=source-trace-locator.d.ts.map

package/dist/runtime-v2/store/trajectory/source-trace-locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-trace-locator.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/trajectory/source-trace-locator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,wBAAwB,GACxB,sBAAsB,GACtB,WAAW,GACX,WAAW,GACX,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACzE"}

package/dist/runtime-v2/store/trajectory/source-trace-locator.js

@@ -0,0 +1,18 @@
+/**
+ * SourceTraceLocator -- contract for resolving source pain trajectories.
+ *
+ * A "source trace" is the original execution trajectory that caused a pain
+ * signal, NOT the Diagnostician task's own runs. This contract formalizes
+ * the lookup semantics that were previously inline in SqliteContextAssembler.
+ *
+ * Key semantics:
+ *   - sourcePainId is mandatory for a `found` result
+ *   - sessionIdHint narrows search scope but cannot produce a candidate alone
+ *   - excludeTaskIds prevents self-trace (Diagnostician task seeing its own runs)
+ *   - Ambiguous = multiple matching candidates → candidate = null
+ *   - Mismatch = candidate found but painId doesn't match → source_pain_mismatch
+ *   - Malformed diagnosticJson → recorded as reason, doesn't crash lookup
+ *   - Storage errors → fail loud via PDRuntimeError, never silently swallowed
+ */
+export {};
+//# sourceMappingURL=source-trace-locator.js.map

package/dist/runtime-v2/store/trajectory/source-trace-locator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-trace-locator.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/trajectory/source-trace-locator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/runtime-v2/store/trajectory/source-trace-locator.test.d.ts

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

package/dist/runtime-v2/store/trajectory/source-trace-locator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-trace-locator.test.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/trajectory/source-trace-locator.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/store/trajectory/source-trace-locator.test.js

@@ -0,0 +1,320 @@
+/**
+ * SourceTraceLocator contract tests — PRI-189.
+ *
+ * Tests the formalized source trace lookup semantics extracted from
+ * SqliteContextAssembler. Covers all SourceTraceLocateDecision values
+ * and the core invariant: fullTrace only comes from sourcePainId-aligned
+ * source task/runs.
+ */
+import { describe, it, expect } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { SqliteConnection } from '../sqlite-connection.js';
+import { SqliteTaskStore } from '../task/sqlite-task-store.js';
+import { SqliteTrajectoryLocator } from './sqlite-trajectory-locator.js';
+import { SqliteSourceTraceLocator } from './sqlite-source-trace-locator.js';
+const WORKSPACE = '/tmp/test-workspace';
+function createFixture() {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-source-trace-locator-test-'));
+    const connection = new SqliteConnection(tmpDir);
+    const taskStore = new SqliteTaskStore(connection);
+    const trajectoryLocator = new SqliteTrajectoryLocator(connection);
+    const sourceTraceLocator = new SqliteSourceTraceLocator(taskStore, trajectoryLocator);
+    return { tmpDir, connection, taskStore, trajectoryLocator, sourceTraceLocator };
+}
+function cleanupFixture(fixture) {
+    fixture.connection.close();
+    fs.rmSync(fixture.tmpDir, { recursive: true, force: true });
+}
+async function createSourceTask(fixture, taskId, opts) {
+    const dj = { sessionIdHint: opts.sessionId };
+    if (opts.sourcePainId)
+        dj.sourcePainId = opts.sourcePainId;
+    if (opts.painId)
+        dj.painId = opts.painId;
+    const existing = await fixture.taskStore.getTask(taskId);
+    if (!existing) {
+        await fixture.taskStore.createTask({
+            taskId,
+            taskKind: 'user_session',
+            status: 'succeeded',
+            attemptCount: 1,
+            maxAttempts: 1,
+            diagnosticJson: JSON.stringify(dj),
+        });
+    }
+}
+function q(overrides = {}) {
+    return {
+        sourcePainId: overrides.sourcePainId,
+        sessionIdHint: overrides.sessionIdHint,
+        workspaceDir: overrides.workspaceDir ?? WORKSPACE,
+        excludeTaskIds: overrides.excludeTaskIds,
+    };
+}
+describe('SqliteSourceTraceLocator', () => {
+    it('returns found when source task diagnosticJson has matching sourcePainId', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_src_1', { sessionId: 'sess-1', sourcePainId: 'pain-A' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-A',
+                sessionIdHint: 'sess-1',
+            }));
+            expect(result.decision).toBe('found');
+            expect(result.candidate).not.toBeNull();
+            if (result.candidate) {
+                expect(result.candidate.taskId).toBe('task_src_1');
+                expect(result.candidate.sourcePainId).toBe('pain-A');
+            }
+            expect(result.candidates.length).toBe(1);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns found when source task diagnosticJson has matching painId (not sourcePainId)', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_src_painid', { sessionId: 'sess-painid', painId: 'pain-B' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-B',
+                sessionIdHint: 'sess-painid',
+            }));
+            expect(result.decision).toBe('found');
+            expect(result.candidate).not.toBeNull();
+            if (result.candidate) {
+                expect(result.candidate.taskId).toBe('task_src_painid');
+            }
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns missing_source_pain_id when query has no sourcePainId', async () => {
+        const f = createFixture();
+        try {
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: undefined,
+                sessionIdHint: 'sess-any',
+            }));
+            expect(result.decision).toBe('missing_source_pain_id');
+            expect(result.candidate).toBeNull();
+            expect(result.ambiguityNotes.length).toBeGreaterThan(0);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns missing_session_hint when query has no sessionIdHint', async () => {
+        const f = createFixture();
+        try {
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-X',
+                sessionIdHint: undefined,
+            }));
+            expect(result.decision).toBe('missing_session_hint');
+            expect(result.candidate).toBeNull();
+            expect(result.ambiguityNotes.length).toBeGreaterThan(0);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('does not return found when session has task but diagnosticJson has no sourcePainId/painId', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_no_pain', { sessionId: 'sess-nopain' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-missing',
+                sessionIdHint: 'sess-nopain',
+            }));
+            expect(result.decision).not.toBe('found');
+            expect(result.candidate).toBeNull();
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns source_pain_mismatch when candidate has different sourcePainId', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_mismatch', { sessionId: 'sess-mismatch', sourcePainId: 'pain-B' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-A',
+                sessionIdHint: 'sess-mismatch',
+            }));
+            expect(result.decision).toBe('source_pain_mismatch');
+            expect(result.candidate).toBeNull();
+            expect(result.ambiguityNotes.some(n => n.includes('mismatch'))).toBe(true);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns not_found when session has no tasks at all', async () => {
+        const f = createFixture();
+        try {
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-orphan',
+                sessionIdHint: 'sess-empty',
+            }));
+            expect(result.decision).toBe('not_found');
+            expect(result.candidate).toBeNull();
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns ambiguous when multiple candidates match same sourcePainId', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_amb_1', { sessionId: 'sess-amb', sourcePainId: 'pain-amb' });
+            await createSourceTask(f, 'task_amb_2', { sessionId: 'sess-amb', sourcePainId: 'pain-amb' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-amb',
+                sessionIdHint: 'sess-amb',
+            }));
+            expect(result.decision).toBe('ambiguous');
+            expect(result.candidate).toBeNull();
+            expect(result.candidates.length).toBe(2);
+            expect(result.ambiguityNotes.some(n => n.includes('task_amb_1') || n.includes('task_amb_2'))).toBe(true);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('excludes tasks listed in excludeTaskIds', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_diag_self', { sessionId: 'sess-excl', sourcePainId: 'pain-excl' });
+            await createSourceTask(f, 'task_real_source', { sessionId: 'sess-excl', sourcePainId: 'pain-excl' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-excl',
+                sessionIdHint: 'sess-excl',
+                excludeTaskIds: ['task_diag_self'],
+            }));
+            expect(result.decision).toBe('found');
+            expect(result.candidate).not.toBeNull();
+            if (result.candidate) {
+                expect(result.candidate.taskId).toBe('task_real_source');
+            }
+            expect(result.candidates.every(c => c.taskId !== 'task_diag_self')).toBe(true);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns not_found when all matching candidates are excluded', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_only_one', { sessionId: 'sess-excl-all', sourcePainId: 'pain-excl-all' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-excl-all',
+                sessionIdHint: 'sess-excl-all',
+                excludeTaskIds: ['task_only_one'],
+            }));
+            expect(result.decision).toBe('not_found');
+            expect(result.candidate).toBeNull();
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('handles candidate with null diagnosticJson without crashing', async () => {
+        const f = createFixture();
+        try {
+            const db = f.connection.getDb();
+            const now = new Date().toISOString();
+            db.prepare('INSERT INTO tasks (task_id, task_kind, status, created_at, updated_at, attempt_count, max_attempts, diagnostic_json) ' +
+                'VALUES (?, ?, ?, ?, ?, ?, ?, ?)').run('task_null_dj', 'user_session', 'succeeded', now, now, 1, 1, null);
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-nulldj',
+                sessionIdHint: 'sess-nulldj',
+            }));
+            expect(result.decision).not.toBe('found');
+            expect(result.candidate).toBeNull();
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns storage_unavailable when TrajectoryLocator is not provided', async () => {
+        const f = createFixture();
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const locator = new SqliteSourceTraceLocator(f.taskStore, undefined);
+            const result = await locator.locate(q({
+                sourcePainId: 'pain-no-traj',
+                sessionIdHint: 'sess-no-traj',
+            }));
+            expect(result.decision).toBe('storage_unavailable');
+            expect(result.candidate).toBeNull();
+            expect(result.ambiguityNotes.length).toBeGreaterThan(0);
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('does not return found based on sessionIdHint alone without sourcePainId match', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_session_only', { sessionId: 'sess-session-only', sourcePainId: 'pain-other' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-different',
+                sessionIdHint: 'sess-session-only',
+            }));
+            expect(result.decision).not.toBe('found');
+            expect(result.candidate).toBeNull();
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('returns found with correct sourceTypes from TrajectoryLocator candidates', async () => {
+        const f = createFixture();
+        try {
+            await createSourceTask(f, 'task_sourcetypes', { sessionId: 'sess-st', sourcePainId: 'pain-st' });
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: 'pain-st',
+                sessionIdHint: 'sess-st',
+            }));
+            expect(result.decision).toBe('found');
+            expect(result.candidate).not.toBeNull();
+            if (result.candidate) {
+                expect(result.candidate.sourceTypes.length).toBeGreaterThan(0);
+            }
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+    it('ignores non-string sourcePainId values in diagnosticJson', async () => {
+        const f = createFixture();
+        try {
+            const dj = { sessionIdHint: 'sess-nonstr', sourcePainId: 42 };
+            const existing = await f.taskStore.getTask('task_nonstr_painid');
+            if (!existing) {
+                await f.taskStore.createTask({
+                    taskId: 'task_nonstr_painid',
+                    taskKind: 'user_session',
+                    status: 'succeeded',
+                    attemptCount: 1,
+                    maxAttempts: 1,
+                    diagnosticJson: JSON.stringify(dj),
+                });
+            }
+            const result = await f.sourceTraceLocator.locate(q({
+                sourcePainId: '42',
+                sessionIdHint: 'sess-nonstr',
+            }));
+            expect(result.decision).not.toBe('found');
+            expect(result.candidate).toBeNull();
+        }
+        finally {
+            cleanupFixture(f);
+        }
+    });
+});
+//# sourceMappingURL=source-trace-locator.test.js.map

package/dist/runtime-v2/store/trajectory/source-trace-locator.test.js.map

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

package/dist/runtime-v2/store/trajectory/sqlite-source-trace-locator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SQLite implementation of SourceTraceLocator.
+ *
+ * Resolves source pain trajectories by:
+ * 1. Using TrajectoryLocator to find session-scoped task candidates
+ * 2. Filtering by excludeTaskIds to prevent self-trace
+ * 3. Matching each candidate's diagnosticJson.sourcePainId or diagnosticJson.painId
+ *    against the query's sourcePainId
+ * 4. Returning structured decisions for missing/mismatch/ambiguous cases
+ *
+ * Key invariant: sourcePainId is mandatory for a `found` result.
+ * sessionIdHint narrows scope but cannot produce a candidate alone.
+ */
+import type { TaskStore } from '../task/task-store.js';
+import type { TrajectoryLocator } from './trajectory-locator.js';
+import { type SourceTraceLocateQuery, type SourceTraceLocateResult, type SourceTraceLocator } from './source-trace-locator.js';
+export declare class SqliteSourceTraceLocator implements SourceTraceLocator {
+    private readonly taskStore;
+    private readonly trajectoryLocator;
+    constructor(taskStore: TaskStore, trajectoryLocator: TrajectoryLocator | undefined);
+    locate(query: SourceTraceLocateQuery): Promise<SourceTraceLocateResult>;
+}
+//# sourceMappingURL=sqlite-source-trace-locator.d.ts.map

package/dist/runtime-v2/store/trajectory/sqlite-source-trace-locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-source-trace-locator.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/trajectory/sqlite-source-trace-locator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAE5B,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAgBnC,qBAAa,wBAAyB,YAAW,kBAAkB;IAE/D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBADjB,SAAS,EAAE,SAAS,EACpB,iBAAiB,EAAE,iBAAiB,GAAG,SAAS;IAG7D,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAwI9E"}