@principles/core 1.241.0 → 1.242.0

package/dist/runtime-v2/internalization/__tests__/candidate-lineage.property.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Property tests for CandidateLineage (design §6.4, tasks 7.3–7.6).
+ *
+ * CP-17: stage attribution is determined solely by taskKind (not artifactKind)
+ * CP-18: lineage cache idempotency (each artifactId fetched at most once)
+ * CP-19: lineage error classification (corruption vs expected-absence)
+ * CP-20: lineage failures are never swallowed (caller must surface them)
+ *
+ * Uses stub artifact store + task reader (no real I/O).
+ *
+ * @see .kiro/specs/internalization-progressive-disclosure/design.md §6.4
+ * @see .kiro/specs/internalization-progressive-disclosure/requirements.md Requirement 6
+ */
+export {};
+//# sourceMappingURL=candidate-lineage.property.test.d.ts.map

package/dist/runtime-v2/internalization/__tests__/candidate-lineage.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-lineage.property.test.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/internalization/__tests__/candidate-lineage.property.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/runtime-v2/internalization/__tests__/candidate-lineage.property.test.js

@@ -0,0 +1,301 @@
+/**
+ * Property tests for CandidateLineage (design §6.4, tasks 7.3–7.6).
+ *
+ * CP-17: stage attribution is determined solely by taskKind (not artifactKind)
+ * CP-18: lineage cache idempotency (each artifactId fetched at most once)
+ * CP-19: lineage error classification (corruption vs expected-absence)
+ * CP-20: lineage failures are never swallowed (caller must surface them)
+ *
+ * Uses stub artifact store + task reader (no real I/O).
+ *
+ * @see .kiro/specs/internalization-progressive-disclosure/design.md §6.4
+ * @see .kiro/specs/internalization-progressive-disclosure/requirements.md Requirement 6
+ */
+import { describe, it, expect } from 'vitest';
+import fc from 'fast-check';
+import { CandidateLineage, } from '../candidate-lineage.js';
+function makeStub(artifacts, tasks) {
+    const artifactMap = new Map(artifacts.map((a) => [a.artifactId, a]));
+    const taskMap = new Map(tasks.map((t) => [t.taskId, t]));
+    const artifactReads = new Map();
+    const taskReads = new Map();
+    const events = [];
+    return { artifacts: artifactMap, tasks: taskMap, artifactReads, taskReads, events };
+}
+function makeArtifact(artifactId, sourceTaskId, lineageArtifactIds = [], contentJson = { data: 'test' }, artifactKind = 'principle') {
+    return {
+        artifactId,
+        artifactKind,
+        sourceTaskId,
+        lineageArtifactIds,
+        validationStatus: 'validated',
+        contentJson: typeof contentJson === 'string' ? contentJson : JSON.stringify(contentJson),
+        createdAt: '2026-01-01T00:00:00Z',
+        updatedAt: '2026-01-01T00:00:00Z',
+    };
+}
+function makeLineage(deps, maxDepth) {
+    const artifactStore = {
+        getArtifactById: async (id) => {
+            deps.artifactReads.set(id, (deps.artifactReads.get(id) ?? 0) + 1);
+            return deps.artifacts.get(id) ?? null;
+        },
+    };
+    const taskReader = {
+        getTaskById: async (id) => {
+            deps.taskReads.set(id, (deps.taskReads.get(id) ?? 0) + 1);
+            return deps.tasks.get(id) ?? null;
+        },
+    };
+    return new CandidateLineage({
+        artifacts: artifactStore,
+        tasks: taskReader,
+        maxDepth,
+        emit: (e) => deps.events.push(e),
+    });
+}
+// ── CP-17: stage by taskKind only ────────────────────────────────────────────
+describe('CP-17 — stage attribution determined solely by taskKind (F1)', () => {
+    it('artifactKind is irrelevant: same taskKind → same runnerKind regardless of artifactKind', async () => {
+        const artifactKinds = ['principle', 'rule', 'skill', 'patch'];
+        for (const kind of artifactKinds) {
+            const deps = makeStub([makeArtifact('art-1', 'task-1', [], { x: 1 }, kind)], [{ taskId: 'task-1', taskKind: 'dreamer' }]);
+            const lineage = makeLineage(deps);
+            const result = await lineage.resolve('art-1');
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.value.nodes[0]?.runnerKind).toBe('dreamer');
+                expect(result.value.nodes[0]?.taskKind).toBe('dreamer');
+            }
+        }
+    });
+    it('property: artifactKind randomly mismatched with real stage → runnerKind still follows taskKind', async () => {
+        await fc.assert(fc.asyncProperty(fc.constantFrom('principle', 'rule', 'skill', 'patch'), fc.constantFrom('dreamer', 'scribe', 'artificer', 'evaluator', 'diag_router'), async (artifactKind, taskKind) => {
+            const deps = makeStub([makeArtifact('art-prop', 'task-prop', [], { v: 1 }, artifactKind)], [{ taskId: 'task-prop', taskKind }]);
+            const lineage = makeLineage(deps);
+            const result = await lineage.resolve('art-prop');
+            if (result.ok) {
+                expect(result.value.nodes[0]?.taskKind).toBe(taskKind);
+            }
+        }), { numRuns: 40 });
+    });
+});
+// ── CP-18: cache idempotency ─────────────────────────────────────────────────
+describe('CP-18 — lineage cache idempotency', () => {
+    it('each artifactId is fetched from the store at most once', async () => {
+        // Diamond: A → B, A → C, B → D, C → D (D reachable via two paths).
+        const artifacts = [
+            makeArtifact('A', 'task-A', ['B', 'C']),
+            makeArtifact('B', 'task-B', ['D']),
+            makeArtifact('C', 'task-C', ['D']),
+            makeArtifact('D', 'task-D', []),
+        ];
+        const tasks = ['A', 'B', 'C', 'D'].map((t) => ({ taskId: `task-${t}`, taskKind: 'dreamer' }));
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps);
+        const r1 = await lineage.resolve('A');
+        const r2 = await lineage.resolve('A');
+        expect(r1.ok).toBe(true);
+        expect(r2.ok).toBe(true);
+        // Each artifact fetched exactly once across both resolve calls (cached).
+        for (const id of ['A', 'B', 'C', 'D']) {
+            expect(deps.artifactReads.get(id) ?? 0).toBe(1);
+        }
+    });
+    it('repeated resolve returns identical results', async () => {
+        const artifacts = [
+            makeArtifact('X', 'task-X', ['Y']),
+            makeArtifact('Y', 'task-Y', []),
+        ];
+        const tasks = [{ taskId: 'task-X', taskKind: 'dreamer' }, { taskId: 'task-Y', taskKind: 'scribe' }];
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps);
+        const r1 = await lineage.resolve('X');
+        const r2 = await lineage.resolve('X');
+        expect(JSON.stringify(r1)).toBe(JSON.stringify(r2));
+    });
+    it('findAncestorByTaskKind also uses the cache (no extra store reads)', async () => {
+        const artifacts = [
+            makeArtifact('P', 'task-P', ['Q']),
+            makeArtifact('Q', 'task-Q', []),
+        ];
+        const tasks = [
+            { taskId: 'task-P', taskKind: 'evaluator' },
+            { taskId: 'task-Q', taskKind: 'dreamer' },
+        ];
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps);
+        await lineage.resolve('P');
+        await lineage.findAncestorByTaskKind('P', 'dreamer');
+        for (const id of ['P', 'Q']) {
+            expect(deps.artifactReads.get(id) ?? 0).toBe(1);
+        }
+    });
+});
+// ── CP-19: error classification ──────────────────────────────────────────────
+describe('CP-19 — lineage error classification', () => {
+    it('contentJson unparseable → ok:false + content_json_unparseable + lineage_data_corrupt', async () => {
+        const deps = makeStub([makeArtifact('bad', 'task-1', [], '{not valid json')], [{ taskId: 'task-1', taskKind: 'dreamer' }]);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('bad');
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.kind).toBe('content_json_unparseable');
+        expect(deps.events.some((e) => e.type === 'lineage_data_corrupt')).toBe(true);
+    });
+    it('artifact missing sourceTaskId → ok:false + artifact_shape_invalid', async () => {
+        const badArtifact = {
+            ...makeArtifact('shapeless', 'task-1', []),
+            sourceTaskId: '',
+        };
+        const deps = makeStub([badArtifact], [{ taskId: 'task-1', taskKind: 'dreamer' }]);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('shapeless');
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.kind).toBe('artifact_shape_invalid');
+    });
+    it('store throws → ok:false + store_failure + lineage_store_failure', async () => {
+        const deps = makeStub([], []);
+        const failingStore = {
+            getArtifactById: async () => { throw new Error('db connection lost'); },
+        };
+        const lineage = new CandidateLineage({
+            artifacts: failingStore,
+            tasks: { getTaskById: async () => null },
+            emit: (e) => deps.events.push(e),
+        });
+        const result = await lineage.resolve('any');
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.error.kind).toBe('store_failure');
+        expect(deps.events.some((e) => e.type === 'lineage_store_failure')).toBe(true);
+    });
+    it('ancestor pruned (referenced but absent) → ok:true + partial + ancestor_pruned note', async () => {
+        const deps = makeStub([makeArtifact('start', 'task-1', ['ghost'])], // 'ghost' not in store
+        [{ taskId: 'task-1', taskKind: 'dreamer' }]);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('start');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value.complete).toBe(false);
+            expect(result.value.notes.some((n) => n.code === 'ancestor_pruned')).toBe(true);
+        }
+    });
+    it('task missing → ok:true + partial + task_missing note + runnerKind unknown', async () => {
+        const deps = makeStub([makeArtifact('orphan', 'task-gone', [])], []);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('orphan');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value.complete).toBe(false);
+            expect(result.value.nodes[0]?.runnerKind).toBe('unknown');
+            expect(result.value.notes.some((n) => n.code === 'task_missing')).toBe(true);
+        }
+    });
+    it('depth limit → ok:true + partial + depth_limit_reached note', async () => {
+        // Chain longer than maxDepth=2.
+        const artifacts = [
+            makeArtifact('n0', 't0', ['n1']),
+            makeArtifact('n1', 't1', ['n2']),
+            makeArtifact('n2', 't2', ['n3']),
+            makeArtifact('n3', 't3', []),
+        ];
+        const tasks = [0, 1, 2, 3].map((i) => ({ taskId: `t${i}`, taskKind: 'dreamer' }));
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps, 2);
+        const result = await lineage.resolve('n0');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value.complete).toBe(false);
+            expect(result.value.notes.some((n) => n.code === 'depth_limit_reached')).toBe(true);
+        }
+    });
+    it('cycle → ok:true + partial + cycle_detected note', async () => {
+        // A → B → A (cycle).
+        const artifacts = [
+            makeArtifact('cyc-A', 't-A', ['cyc-B']),
+            makeArtifact('cyc-B', 't-B', ['cyc-A']),
+        ];
+        const tasks = [{ taskId: 't-A', taskKind: 'dreamer' }, { taskId: 't-B', taskKind: 'scribe' }];
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('cyc-A');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value.notes.some((n) => n.code === 'cycle_detected')).toBe(true);
+        }
+    });
+    it('complete chain (no issues) → ok:true + complete + empty notes', async () => {
+        const artifacts = [
+            makeArtifact('ok-1', 't-1', ['ok-2']),
+            makeArtifact('ok-2', 't-2', []),
+        ];
+        const tasks = [{ taskId: 't-1', taskKind: 'dreamer' }, { taskId: 't-2', taskKind: 'scribe' }];
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('ok-1');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value.complete).toBe(true);
+            expect(result.value.notes).toHaveLength(0);
+            expect(result.value.nodes).toHaveLength(2);
+        }
+    });
+    it('findAncestorByTaskKind miss → ok:true + node null', async () => {
+        const artifacts = [makeArtifact('solo', 't-1', [])];
+        const tasks = [{ taskId: 't-1', taskKind: 'dreamer' }];
+        const deps = makeStub(artifacts, tasks);
+        const lineage = makeLineage(deps);
+        const result = await lineage.findAncestorByTaskKind('solo', 'evaluator');
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.node).toBeNull();
+    });
+    it('contentJson stays unknown (not narrowed) on the returned node', async () => {
+        const deps = makeStub([makeArtifact('unk', 't-1', [], { complex: { nested: [1, 2] } })], [{ taskId: 't-1', taskKind: 'dreamer' }]);
+        const lineage = makeLineage(deps);
+        const result = await lineage.resolve('unk');
+        if (result.ok) {
+            // contentJson is typed `unknown` — we verify it's an object but the type
+            // system guarantees it was never cast to a specific shape.
+            expect(typeof result.value.nodes[0]?.contentJson).toBe('object');
+        }
+    });
+});
+// ── CP-20: failures never swallowed ──────────────────────────────────────────
+describe('CP-20 — lineage failures never swallowed', () => {
+    it('all three LineageError kinds produce ok:false (never a silent ok:true)', async () => {
+        // content_json_unparseable
+        const r1 = await makeLineage(makeStub([makeArtifact('a', 't', [], 'bad{json')], [{ taskId: 't', taskKind: 'dreamer' }])).resolve('a');
+        expect(r1.ok).toBe(false);
+        // artifact_shape_invalid
+        const r2 = await makeLineage(makeStub([{ ...makeArtifact('b', 't', []), sourceTaskId: '' }], [{ taskId: 't', taskKind: 'dreamer' }])).resolve('b');
+        expect(r2.ok).toBe(false);
+        // store_failure
+        const r3 = await new CandidateLineage({
+            artifacts: { getArtifactById: async () => { throw new Error('boom'); } },
+            tasks: { getTaskById: async () => null },
+        }).resolve('c');
+        expect(r3.ok).toBe(false);
+    });
+    it('every ok:false result has a non-empty error.kind (no generic "unknown" failure)', async () => {
+        const results = [];
+        // Run all three failure modes.
+        for (const setup of [
+            { art: makeArtifact('x', 't', [], 'bad'), task: { taskId: 't', taskKind: 'dreamer' } },
+            { art: { ...makeArtifact('y', 't', []), sourceTaskId: '' }, task: { taskId: 't', taskKind: 'dreamer' } },
+        ]) {
+            const r = await makeLineage(makeStub([setup.art], [setup.task])).resolve(setup.art.artifactId);
+            results.push(r);
+        }
+        for (const r of results) {
+            expect(r.ok).toBe(false);
+            if (!r.ok) {
+                // error.kind is one of the three known kinds — never empty or undefined.
+                expect(['content_json_unparseable', 'artifact_shape_invalid', 'store_failure']).toContain(r.error.kind);
+            }
+        }
+    });
+});
+//# sourceMappingURL=candidate-lineage.property.test.js.map

package/dist/runtime-v2/internalization/__tests__/candidate-lineage.property.test.js.map

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

package/dist/runtime-v2/internalization/candidate-lineage.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Layer 2 — CandidateLineage: on-demand ancestry traversal (design §6.4).
+ *
+ * Pure logic with **injected** I/O (artifact store + task reader). Walks an
+ * artifact's ancestry via `lineageArtifactIds`, determining each node's stage
+ * by the two-hop `artifact.sourceTaskId → task.taskKind` (F1 — never by
+ * `artifactKind`, which is ambiguous: all internalization artifacts are
+ * `principle`).
+ *
+ * Result contract (rc-9, design §6.4 error table):
+ *   - data corruption (unparseable / shape-invalid / store-throw) → `ok: false`
+ *     + a `LineageError`; the caller MUST surface it as an explicit failure or
+ *     structured degradation — never silently fall through.
+ *   - expected absence (no lineage ids / ancestor pruned / task missing / depth
+ *     limit / cycle) → `ok: true` with a partial chain + notes; `complete` is
+ *     false and `notes` is non-empty.
+ *
+ * Request-scoped cache: a single `CandidateLineage` instance lives for one
+ * `buildContext`; repeated `getArtifactById` calls for the same id hit the
+ * cache, not the store (CP-18).
+ *
+ * rc-1: every `contentJson` stays `unknown` — it is never narrowed or cast.
+ */
+import type { PIArtifactStore } from './pi-artifact.js';
+import type { ArtifactSummary, SummaryRunnerKind } from './artifact-summary.js';
+export interface LineageNode {
+    readonly artifactId: string;
+    readonly taskId: string;
+    /** Stage determined by the two-hop sourceTaskId → task.taskKind (F1). */
+    readonly taskKind: string;
+    readonly runnerKind: SummaryRunnerKind | 'unknown';
+    /** rc-1: remains `unknown`; the caller narrows it. */
+    readonly contentJson: unknown;
+    readonly summary?: ArtifactSummary;
+}
+export type LineageNoteCode = 'source_trace_missing' | 'ancestor_pruned' | 'task_missing' | 'depth_limit_reached' | 'cycle_detected';
+export interface LineageNote {
+    readonly code: LineageNoteCode;
+    readonly artifactId: string;
+    readonly detail: string;
+}
+export interface LineageChain {
+    /** From start node upstream, in traversal order. */
+    readonly nodes: readonly LineageNode[];
+    /** false when notes is non-empty (partial chain). */
+    readonly complete: boolean;
+    readonly notes: readonly LineageNote[];
+}
+export type LineageError = {
+    readonly kind: 'content_json_unparseable';
+    readonly artifactId: string;
+    readonly detail: string;
+} | {
+    readonly kind: 'artifact_shape_invalid';
+    readonly artifactId: string;
+    readonly detail: string;
+} | {
+    readonly kind: 'store_failure';
+    readonly detail: string;
+};
+export type LineageResult = {
+    readonly ok: true;
+    readonly value: LineageChain;
+} | {
+    readonly ok: false;
+    readonly error: LineageError;
+};
+/** Lineage telemetry event (forwarded to the caller's emit, if provided). */
+export type LineageEvent = {
+    readonly type: 'lineage_data_corrupt';
+    readonly artifactId: string;
+    readonly detail: string;
+    readonly errorKind: LineageError['kind'];
+} | {
+    readonly type: 'lineage_store_failure';
+    readonly detail: string;
+} | {
+    readonly type: 'lineage_partial';
+    readonly artifactId: string;
+    readonly noteCode: LineageNoteCode;
+    readonly detail: string;
+};
+/** Two-hop task reader (F1) — resolves taskKind from a taskId. */
+export interface LineageTaskReader {
+    getTaskById(taskId: string): Promise<{
+        readonly taskId: string;
+        readonly taskKind: string;
+    } | null>;
+}
+export interface CandidateLineageDeps {
+    readonly artifacts: Pick<PIArtifactStore, 'getArtifactById'>;
+    readonly tasks: LineageTaskReader;
+    /** Default 6 (longest pipeline chain + 1). */
+    readonly maxDepth?: number;
+    readonly emit?: (event: LineageEvent) => void;
+}
+export declare class CandidateLineage {
+    private readonly artifacts;
+    private readonly tasks;
+    private readonly maxDepth;
+    private readonly emit;
+    /** request-scoped: artifactId → resolved record (or null if known-absent). */
+    private readonly cache;
+    /** request-scoped: taskId → resolved taskKind (or null). */
+    private readonly taskCache;
+    constructor(deps: CandidateLineageDeps);
+    /**
+     * Resolve the full ancestry chain starting from `startArtifactId`.
+     * Walks `lineageArtifactIds` upstream, building an ordered node list.
+     */
+    resolve(startArtifactId: string): Promise<LineageResult>;
+    /**
+     * Find the nearest ancestor node with a given `taskKind` (F1 — never by
+     * `artifactKind`). Returns `{ ok: true, node: null }` when no ancestor
+     * matches (a valid result, not an error).
+     */
+    findAncestorByTaskKind(startArtifactId: string, taskKind: string): Promise<{
+        readonly ok: true;
+        readonly node: LineageNode | null;
+        readonly notes: readonly LineageNote[];
+    } | {
+        readonly ok: false;
+        readonly error: LineageError;
+    }>;
+    /**
+     * Iterative BFS resolution with cycle detection (via `visited`) and depth
+     * limiting. `visited` carries artifactIds already resolved (prevents cycles
+     * and redundant fetches across the whole traversal, not just one path).
+     */
+    private resolveChain;
+    /** Cached artifact fetch. Returns `ok:false` on store failure or corruption. */
+    private getArtifactCached;
+    /** Cached task fetch (two-hop). Returns `ok:false` only on reader failure (treated as store_failure). */
+    private getTaskCached;
+}
+//# sourceMappingURL=candidate-lineage.d.ts.map

package/dist/runtime-v2/internalization/candidate-lineage.d.ts.map

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

package/dist/runtime-v2/internalization/candidate-lineage.js

@@ -0,0 +1,230 @@
+/**
+ * Layer 2 — CandidateLineage: on-demand ancestry traversal (design §6.4).
+ *
+ * Pure logic with **injected** I/O (artifact store + task reader). Walks an
+ * artifact's ancestry via `lineageArtifactIds`, determining each node's stage
+ * by the two-hop `artifact.sourceTaskId → task.taskKind` (F1 — never by
+ * `artifactKind`, which is ambiguous: all internalization artifacts are
+ * `principle`).
+ *
+ * Result contract (rc-9, design §6.4 error table):
+ *   - data corruption (unparseable / shape-invalid / store-throw) → `ok: false`
+ *     + a `LineageError`; the caller MUST surface it as an explicit failure or
+ *     structured degradation — never silently fall through.
+ *   - expected absence (no lineage ids / ancestor pruned / task missing / depth
+ *     limit / cycle) → `ok: true` with a partial chain + notes; `complete` is
+ *     false and `notes` is non-empty.
+ *
+ * Request-scoped cache: a single `CandidateLineage` instance lives for one
+ * `buildContext`; repeated `getArtifactById` calls for the same id hit the
+ * cache, not the store (CP-18).
+ *
+ * rc-1: every `contentJson` stays `unknown` — it is never narrowed or cast.
+ */
+import { SUMMARY_RUNNER_KINDS } from './artifact-summary.js';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+const DEFAULT_MAX_DEPTH = 6;
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Read an existing ArtifactSummary off a contentJson (Layer 0 envelope), with
+ * full value-type validation (rc-2). Returns null when absent or malformed —
+ * the node simply carries no `summary`, which is a valid partial state.
+ */
+function readSummary(contentJson) {
+    if (!isRecord(contentJson) || !Object.hasOwn(contentJson, 'summary'))
+        return undefined;
+    const { summary } = contentJson;
+    if (!isRecord(summary))
+        return undefined;
+    // rc-2: full value-type validation, then construct a typed object (no as cast).
+    if (Object.hasOwn(summary, 'schemaVersion') && summary.schemaVersion === 1
+        && Object.hasOwn(summary, 'runnerKind') && typeof summary.runnerKind === 'string'
+        && SUMMARY_RUNNER_KINDS.includes(summary.runnerKind)
+        && Object.hasOwn(summary, 'headline') && typeof summary.headline === 'string'
+        && Object.hasOwn(summary, 'fields') && isRecord(summary.fields)
+        && Object.values(summary.fields).every((v) => typeof v === 'string')
+        && Object.hasOwn(summary, 'derivedFrom') && summary.derivedFrom === 'structured_output'
+        && Object.hasOwn(summary, 'omittedFields') && Array.isArray(summary.omittedFields)
+        && summary.omittedFields.every((v) => typeof v === 'string')) {
+        // runtime-contract-exempt: ERR-001 narrowing after full value-type validation: runnerKind checked against SUMMARY_RUNNER_KINDS, fields checked via Object.values().every(typeof string), omittedFields checked via Array.isArray + every. The casts are type-only — the values are already validated at runtime above.
+        return {
+            schemaVersion: 1,
+            runnerKind: summary.runnerKind, // runtime-contract-exempt: ERR-001 validated via SUMMARY_RUNNER_KINDS.includes above
+            headline: summary.headline,
+            fields: summary.fields, // runtime-contract-exempt: ERR-001 validated via Object.values().every(typeof===string) above
+            derivedFrom: 'structured_output',
+            omittedFields: summary.omittedFields, // runtime-contract-exempt: ERR-001 validated via Array.isArray + every(typeof===string) above
+        };
+    }
+    return undefined;
+}
+// ── CandidateLineage ─────────────────────────────────────────────────────────
+export class CandidateLineage {
+    artifacts;
+    tasks;
+    maxDepth;
+    emit;
+    /** request-scoped: artifactId → resolved record (or null if known-absent). */
+    cache = new Map();
+    /** request-scoped: taskId → resolved taskKind (or null). */
+    taskCache = new Map();
+    constructor(deps) {
+        this.artifacts = deps.artifacts;
+        this.tasks = deps.tasks;
+        this.maxDepth = deps.maxDepth ?? DEFAULT_MAX_DEPTH;
+        this.emit = deps.emit ?? (() => undefined);
+    }
+    /**
+     * Resolve the full ancestry chain starting from `startArtifactId`.
+     * Walks `lineageArtifactIds` upstream, building an ordered node list.
+     */
+    async resolve(startArtifactId) {
+        return this.resolveChain(startArtifactId, new Set());
+    }
+    /**
+     * Find the nearest ancestor node with a given `taskKind` (F1 — never by
+     * `artifactKind`). Returns `{ ok: true, node: null }` when no ancestor
+     * matches (a valid result, not an error).
+     */
+    async findAncestorByTaskKind(startArtifactId, taskKind) {
+        const result = await this.resolve(startArtifactId);
+        if (!result.ok)
+            return { ok: false, error: result.error };
+        const node = result.value.nodes.find((n) => n.taskKind === taskKind) ?? null;
+        return { ok: true, node, notes: result.value.notes };
+    }
+    // ── Internal traversal ─────────────────────────────────────────────────────
+    /**
+     * Iterative BFS resolution with cycle detection (via `visited`) and depth
+     * limiting. `visited` carries artifactIds already resolved (prevents cycles
+     * and redundant fetches across the whole traversal, not just one path).
+     */
+    async resolveChain(startArtifactId, visited) {
+        const nodes = [];
+        const notes = [];
+        // BFS-style frontier of artifact ids to resolve, seeded with the start.
+        // We process in order; each node's lineageArtifactIds extend the frontier.
+        const queue = [startArtifactId];
+        let depth = 0;
+        while (queue.length > 0) {
+            if (depth >= this.maxDepth) {
+                const [last] = queue;
+                notes.push({ code: 'depth_limit_reached', artifactId: last ?? startArtifactId, detail: `maxDepth (${this.maxDepth}) reached; remaining ${queue.length} ancestor(s) not traversed` });
+                this.emit({ type: 'lineage_partial', artifactId: last ?? startArtifactId, noteCode: 'depth_limit_reached', detail: `maxDepth ${this.maxDepth}` });
+                break;
+            }
+            const artifactId = queue.shift();
+            if (artifactId === undefined)
+                break;
+            // Cycle detection.
+            if (visited.has(artifactId)) {
+                notes.push({ code: 'cycle_detected', artifactId, detail: `artifact ${artifactId} already on the resolution path` });
+                this.emit({ type: 'lineage_partial', artifactId, noteCode: 'cycle_detected', detail: 'cycle detected' });
+                continue;
+            }
+            visited.add(artifactId);
+            // Fetch artifact (cached).
+            const artifactResult = await this.getArtifactCached(artifactId);
+            if (!artifactResult.ok)
+                return artifactResult; // propagate corruption / store failure
+            const artifact = artifactResult.value;
+            if (artifact === null) {
+                // Ancestor referenced but pruned — expected, partial.
+                notes.push({ code: 'ancestor_pruned', artifactId, detail: `ancestor artifact ${artifactId} not found (pruned)` });
+                this.emit({ type: 'lineage_partial', artifactId, noteCode: 'ancestor_pruned', detail: 'artifact not found' });
+                continue;
+            }
+            // Parse contentJson (rc-1: stays unknown on success; unparseable = corruption).
+            let contentJson;
+            try {
+                contentJson = JSON.parse(artifact.contentJson);
+            }
+            catch {
+                const err = { kind: 'content_json_unparseable', artifactId, detail: `contentJson of ${artifactId} is not valid JSON` };
+                this.emit({ type: 'lineage_data_corrupt', artifactId, detail: err.detail, errorKind: 'content_json_unparseable' });
+                return { ok: false, error: err };
+            }
+            // Shape check: must have sourceTaskId (rc-3 fail loud on corruption).
+            if (typeof artifact.sourceTaskId !== 'string' || artifact.sourceTaskId === '') {
+                const err = { kind: 'artifact_shape_invalid', artifactId, detail: `artifact ${artifactId} missing required sourceTaskId` };
+                this.emit({ type: 'lineage_data_corrupt', artifactId, detail: err.detail, errorKind: 'artifact_shape_invalid' });
+                return { ok: false, error: err };
+            }
+            // Two-hop: sourceTaskId → task.taskKind (F1).
+            const taskResult = await this.getTaskCached(artifact.sourceTaskId);
+            if (!taskResult.ok)
+                return taskResult;
+            const task = taskResult.value;
+            let taskKind;
+            let runnerKind;
+            if (task === null) {
+                taskKind = 'unknown';
+                runnerKind = 'unknown';
+                notes.push({ code: 'task_missing', artifactId, detail: `task ${artifact.sourceTaskId} not found; cannot determine stage via two-hop` });
+                this.emit({ type: 'lineage_partial', artifactId, noteCode: 'task_missing', detail: `task ${artifact.sourceTaskId} missing` });
+            }
+            else {
+                ({ taskKind } = task);
+                runnerKind = SUMMARY_RUNNER_KINDS.includes(taskKind)
+                    ? taskKind
+                    : 'unknown';
+            }
+            const node = {
+                artifactId,
+                taskId: artifact.sourceTaskId,
+                taskKind,
+                runnerKind,
+                contentJson,
+                summary: readSummary(contentJson),
+            };
+            nodes.push(node);
+            // Extend frontier with lineage ids (ancestry).
+            const lineageIds = Array.isArray(artifact.lineageArtifactIds) ? artifact.lineageArtifactIds : [];
+            if (lineageIds.length === 0 && nodes.length === 1) {
+                // The start node has no ancestry — not an error, just a short chain.
+            }
+            for (const id of lineageIds) {
+                if (typeof id === 'string' && id !== '') {
+                    queue.push(id);
+                }
+            }
+            depth++;
+        }
+        return { ok: true, value: { nodes, complete: notes.length === 0, notes } };
+    }
+    /** Cached artifact fetch. Returns `ok:false` on store failure or corruption. */
+    async getArtifactCached(artifactId) {
+        if (this.cache.has(artifactId)) {
+            return { ok: true, value: this.cache.get(artifactId) ?? null };
+        }
+        try {
+            const record = await this.artifacts.getArtifactById(artifactId);
+            this.cache.set(artifactId, record);
+            return { ok: true, value: record };
+        }
+        catch (storeErr) {
+            const err = { kind: 'store_failure', detail: storeErr instanceof Error ? storeErr.message : String(storeErr) };
+            this.emit({ type: 'lineage_store_failure', detail: err.detail });
+            return { ok: false, error: err };
+        }
+    }
+    /** Cached task fetch (two-hop). Returns `ok:false` only on reader failure (treated as store_failure). */
+    async getTaskCached(taskId) {
+        if (this.taskCache.has(taskId)) {
+            return { ok: true, value: this.taskCache.get(taskId) ?? null };
+        }
+        try {
+            const task = await this.tasks.getTaskById(taskId);
+            this.taskCache.set(taskId, task);
+            return { ok: true, value: task };
+        }
+        catch (readerErr) {
+            const err = { kind: 'store_failure', detail: readerErr instanceof Error ? readerErr.message : String(readerErr) };
+            this.emit({ type: 'lineage_store_failure', detail: err.detail });
+            return { ok: false, error: err };
+        }
+    }
+}
+//# sourceMappingURL=candidate-lineage.js.map

package/dist/runtime-v2/internalization/candidate-lineage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-lineage.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/candidate-lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAgE7D,gFAAgF;AAEhF,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,WAAoB;IACvC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;IAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,gFAAgF;IAChF,IACE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC;WACnE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;WAC7E,oBAA0C,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;WACxE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;WAC1E,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;WAC5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;WACjE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,OAAO,CAAC,WAAW,KAAK,mBAAmB;WACpF,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;WAC9E,OAAO,CAAC,aAAoC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EACpF,CAAC;QACD,uTAAuT;QACvT,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,OAAO,CAAC,UAA+B,EAAE,qFAAqF;YAC1I,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAgC,EAAE,8FAA8F;YAChJ,WAAW,EAAE,mBAAmB;YAChC,aAAa,EAAE,OAAO,CAAC,aAAkC,EAAE,8FAA8F;SAC1J,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAEhF,MAAM,OAAO,gBAAgB;IACV,SAAS,CAAoC;IAC7C,KAAK,CAAoB;IACzB,QAAQ,CAAS;IACjB,IAAI,CAAgC;IACrD,8EAA8E;IAC7D,KAAK,GAAyC,IAAI,GAAG,EAAE,CAAC;IACzE,4DAA4D;IAC3C,SAAS,GAA+E,IAAI,GAAG,EAAE,CAAC;IAEnH,YAAY,IAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,eAAuB;QACnC,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,sBAAsB,CAC1B,eAAuB,EACvB,QAAgB;QAKhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;QAC7E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;IAED,8EAA8E;IAE9E;;;;OAIG;IACK,KAAK,CAAC,YAAY,CACxB,eAAuB,EACvB,OAAoB;QAEpB,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,MAAM,KAAK,GAAkB,EAAE,CAAC;QAEhC,wEAAwE;QACxE,2EAA2E;QAC3E,MAAM,KAAK,GAAa,CAAC,eAAe,CAAC,CAAC;QAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,UAAU,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,EAAE,aAAa,IAAI,CAAC,QAAQ,wBAAwB,KAAK,CAAC,MAAM,4BAA4B,EAAE,CAAC,CAAC;gBACrL,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,IAAI,eAAe,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,YAAY,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAClJ,MAAM;YACR,CAAC;YACD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM;YAEpC,mBAAmB;YACnB,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,UAAU,iCAAiC,EAAE,CAAC,CAAC;gBACpH,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACzG,SAAS;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAExB,2BAA2B;YAC3B,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAChE,IAAI,CAAC,cAAc,CAAC,EAAE;gBAAE,OAAO,cAAc,CAAC,CAAC,uCAAuC;YACtF,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC;YACtC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,sDAAsD;gBACtD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,UAAU,qBAAqB,EAAE,CAAC,CAAC;gBAClH,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;gBAC9G,SAAS;YACX,CAAC;YAED,gFAAgF;YAChF,IAAI,WAAoB,CAAC;YACzB,IAAI,CAAC;gBACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,GAAiB,EAAE,IAAI,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,UAAU,oBAAoB,EAAE,CAAC;gBACrI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC,CAAC;gBACnH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACnC,CAAC;YAED,sEAAsE;YACtE,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,IAAI,QAAQ,CAAC,YAAY,KAAK,EAAE,EAAE,CAAC;gBAC9E,MAAM,GAAG,GAAiB,EAAE,IAAI,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,UAAU,gCAAgC,EAAE,CAAC;gBACzI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,wBAAwB,EAAE,CAAC,CAAC;gBACjH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACnC,CAAC;YAED,8CAA8C;YAC9C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACnE,IAAI,CAAC,UAAU,CAAC,EAAE;gBAAE,OAAO,UAAU,CAAC;YACtC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;YAC9B,IAAI,QAAgB,CAAC;YACrB,IAAI,UAAyC,CAAC;YAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,QAAQ,GAAG,SAAS,CAAC;gBACrB,UAAU,GAAG,SAAS,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,QAAQ,CAAC,YAAY,gDAAgD,EAAE,CAAC,CAAC;gBACxI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,QAAQ,CAAC,YAAY,UAAU,EAAE,CAAC,CAAC;YAChI,CAAC;iBAAM,CAAC;gBACN,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;gBACtB,UAAU,GAAI,oBAA0C,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACzE,CAAC,CAAE,QAA8B;oBACjC,CAAC,CAAC,SAAS,CAAC;YAChB,CAAC;YAED,MAAM,IAAI,GAAgB;gBACxB,UAAU;gBACV,MAAM,EAAE,QAAQ,CAAC,YAAY;gBAC7B,QAAQ;gBACR,UAAU;gBACV,WAAW;gBACX,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC;aAClC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjB,+CAA+C;YAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;YACjG,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClD,qEAAqE;YACvE,CAAC;YACD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,KAAK,EAAE,CAAC;QACV,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,gFAAgF;IACxE,KAAK,CAAC,iBAAiB,CAC7B,UAAkB;QAElB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,MAAM,GAAG,GAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7H,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED,yGAAyG;IACjG,KAAK,CAAC,aAAa,CACzB,MAAc;QAEd,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,MAAM,GAAG,GAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAChI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/core",
-  "version": "1.241.0",
+  "version": "1.242.0",
   "description": "Universal Evolution SDK - framework-agnostic pain signal capture and principle injection",
   "type": "module",
   "main": "./dist/index.js",