@devflow-tools/sdk 0.17.2 → 0.17.4

package/dist/semantic-resolution.test.js

@@ -0,0 +1,106 @@
+import { describe, expect, it } from 'vitest';
+import { createTaskSemanticFrameV2, projectSemanticFrameToLegacyIntent, semanticEvidenceId, semanticTextHash, } from './semantic-resolution.js';
+describe('semantic resolution contracts', () => {
+    it('accepts a valid resolved analysis frame', () => {
+        const prompt = 'explain the cache design';
+        const frame = createTaskSemanticFrameV2(frameInput(prompt), prompt);
+        expect(frame.frameHash).toMatch(/^[a-f0-9]{64}$/u);
+        expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
+            intent: 'understand', action: 'analyze', mutating: false,
+        });
+    });
+    it('rejects a forged source span', () => {
+        const prompt = 'publish 0.18.0';
+        const evidence = span(prompt, 'publish', 'action', 'release');
+        evidence.textHash = semanticTextHash('forged');
+        expect(() => createTaskSemanticFrameV2(frameInput(prompt, {
+            primaryIntent: 'feature',
+            primaryAction: 'release',
+            mutationPermission: 'explicitly_authorized',
+            evidence: [evidence],
+        }), prompt)).toThrow('SEMANTIC_EVIDENCE_HASH_MISMATCH');
+    });
+    it('rejects model-only mutation with no action span', () => {
+        const prompt = 'ship it';
+        expect(() => createTaskSemanticFrameV2(frameInput(prompt, {
+            primaryIntent: 'feature',
+            primaryAction: 'release',
+            mutationPermission: 'explicitly_authorized',
+        }), prompt)).toThrow('SEMANTIC_ACTION_EVIDENCE_REQUIRED');
+    });
+    it('preserves conditional steps as non-authorized', () => {
+        const prompt = 'if tests pass, publish';
+        const condition = span(prompt, 'if tests pass', 'condition', 'tests_pass');
+        const action = span(prompt, 'publish', 'action', 'release');
+        const frame = createTaskSemanticFrameV2(frameInput(prompt, {
+            primaryIntent: 'feature',
+            primaryAction: 'release',
+            mutationPermission: 'conditional',
+            evidence: [condition, action],
+            steps: [{
+                    order: 0,
+                    action: 'release',
+                    condition: 'tests_pass',
+                    mutationPermission: 'conditional',
+                    evidenceIds: [semanticEvidenceId(condition), semanticEvidenceId(action)],
+                }],
+        }), prompt);
+        expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
+            intent: 'feature', action: 'analyze', mutating: false,
+        });
+    });
+    it('projects an abstained frame to non-mutating analyze', () => {
+        const prompt = 'do it';
+        const frame = createTaskSemanticFrameV2(frameInput(prompt, {
+            state: 'abstained',
+            primaryIntent: 'unknown',
+            primaryAction: 'modify',
+            mutationPermission: 'ambiguous',
+            outOfScope: true,
+        }), prompt);
+        expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
+            intent: 'unknown', action: 'analyze', mutating: false,
+        });
+    });
+});
+function frameInput(prompt, overrides = {}) {
+    return {
+        schemaVersion: 'task-semantic-frame.v2',
+        sourceHash: semanticTextHash(prompt),
+        state: 'resolved',
+        primaryIntent: 'understand',
+        primaryAction: 'analyze',
+        mutationPermission: 'not_requested',
+        intents: ['understand'],
+        entities: [],
+        targetAnchors: [],
+        constraints: [],
+        negations: [],
+        steps: [],
+        memoryDirective: 'none',
+        knowledgeNeeds: [],
+        outOfScope: false,
+        confidence: { overall: 0.9, perField: { intent: 0.9 } },
+        evidence: [],
+        resolver: {
+            generatedBy: 'deterministic',
+            routeCatalogVersion: 'test-catalog.v1',
+            thresholdVersion: 'test-threshold.v1',
+        },
+        createdAt: 1,
+        ...overrides,
+    };
+}
+function span(prompt, text, field, value) {
+    const start = prompt.indexOf(text);
+    return {
+        field,
+        source: 'lexical_feature',
+        value,
+        start,
+        end: start + text.length,
+        textHash: semanticTextHash(text),
+        confidence: 1,
+    };
+}
+//# sourceMappingURL=semantic-resolution.test.js.map

package/dist/semantic-resolution.test.js.map

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

package/dist/task-runtime-reducer.d.ts

@@ -0,0 +1,3 @@
+import { type TaskRuntimeEventV1, type TaskRuntimeSnapshotV1, type TaskSpecV1 } from './task-runtime.js';
+export declare function reduceTaskRuntime(taskSpec: TaskSpecV1, events: TaskRuntimeEventV1[]): TaskRuntimeSnapshotV1;
+//# sourceMappingURL=task-runtime-reducer.d.ts.map

package/dist/task-runtime-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runtime-reducer.d.ts","sourceRoot":"","sources":["../src/task-runtime-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,kBAAkB,EAAE,GAC3B,qBAAqB,CAmCvB"}

package/dist/task-runtime-reducer.js

@@ -0,0 +1,219 @@
+import { assertTaskRuntimeEventV1, assertTaskRuntimeSnapshotV1, stableRuntimeHash, } from './task-runtime.js';
+export function reduceTaskRuntime(taskSpec, events) {
+    if (events.length === 0)
+        throw new Error('TASK_RUNTIME_EVENT_STREAM_EMPTY');
+    const state = initialState(taskSpec);
+    for (const [index, event] of events.entries()) {
+        assertTaskRuntimeEventV1(event);
+        if (event.sequence !== index + 1)
+            throw new Error(`TASK_RUNTIME_SEQUENCE_GAP:${index + 1}`);
+        if (event.taskSpecHash !== taskSpec.specHash)
+            throw new Error('TASK_RUNTIME_SPEC_MISMATCH');
+        if (!sameIdentity(event.identity, taskSpec.identity))
+            throw new Error('TASK_RUNTIME_IDENTITY_MISMATCH');
+        applyEvent(state, event);
+    }
+    const last = events.at(-1);
+    const terminal = terminalOutcome(state);
+    const body = {
+        schemaVersion: 'task-runtime-snapshot.v1',
+        producer: 'devflow-task-runtime-reducer',
+        producerVersion: '1.0.0',
+        identity: taskSpec.identity,
+        taskSpecHash: taskSpec.specHash,
+        lastEventSequence: last.sequence,
+        artifacts: state.artifacts,
+        channels: state.channels,
+        ...(state.contextReceiptId ? { contextReceiptId: state.contextReceiptId } : {}),
+        action: state.action,
+        verification: state.verification,
+        memory: state.memory,
+        durableWorkIds: [...state.durableWorkOwners.keys()].sort(),
+        terminal,
+        runtimeHealth: state.runtimeHealth,
+        updatedAt: last.createdAt,
+    };
+    const snapshot = { ...body, snapshotHash: stableRuntimeHash(body) };
+    assertTaskRuntimeSnapshotV1(snapshot);
+    return snapshot;
+}
+function initialState(taskSpec) {
+    return {
+        artifacts: {
+            requiredIdentityIds: [...taskSpec.artifacts.requiredIdentityIds],
+            resolvedIdentityIds: [],
+            ambiguousIdentityIds: [],
+        },
+        channels: {},
+        action: obligation(taskSpec.obligations.action),
+        verification: obligation(taskSpec.obligations.verification),
+        memory: { requirement: 'required', state: 'pending' },
+        durableWorkOwners: new Map(),
+        runtimeHealth: 'healthy',
+    };
+}
+function obligation(requirement) {
+    return { requirement, state: requirement === 'not_required' ? 'satisfied' : 'pending' };
+}
+function applyEvent(state, event) {
+    const payload = event.payload;
+    switch (event.kind) {
+        case 'task.spec.bound':
+        case 'action.lease.issued':
+            return;
+        case 'context.completed':
+            state.channels = readChannels(payload.channels);
+            state.artifacts = readArtifacts(payload.artifacts, state.artifacts);
+            state.contextReceiptId = optionalString(payload.contextReceiptId);
+            state.runtimeHealth = mergeHealth(state.runtimeHealth, readHealth(payload.runtimeHealth));
+            return;
+        case 'action.started':
+            state.action = withReceipt(state.action, 'pending', payload);
+            return;
+        case 'action.succeeded':
+            state.action = withReceipt(state.action, 'satisfied', payload);
+            return;
+        case 'action.failed':
+            state.action = withReceipt(state.action, 'failed', payload);
+            return;
+        case 'verification.succeeded':
+            state.verification = withReceipt(state.verification, 'satisfied', payload);
+            return;
+        case 'verification.failed':
+            state.verification = withReceipt(state.verification, 'failed', payload);
+            return;
+        case 'memory.committed':
+        case 'memory.skipped':
+            state.memory = withReceipt(state.memory, 'satisfied', payload);
+            return;
+        case 'memory.pending':
+            state.memory = withReceipt(state.memory, 'pending', payload);
+            return;
+        case 'memory.failed':
+            state.memory = withReceipt(state.memory, 'failed', payload);
+            return;
+        case 'durable_work.owned':
+            state.durableWorkOwners.set(requiredString(payload.workId, 'workId'), requiredString(payload.obligation, 'obligation'));
+            return;
+        case 'durable_work.completed':
+            state.durableWorkOwners.delete(requiredString(payload.workId, 'workId'));
+            return;
+        case 'durable_work.dead_lettered':
+            state.durableWorkOwners.delete(requiredString(payload.workId, 'workId'));
+            failObligation(state, optionalString(payload.obligation));
+            state.runtimeHealth = mergeHealth(state.runtimeHealth, 'degraded');
+    }
+}
+function terminalOutcome(state) {
+    const obligations = [state.action, state.verification, state.memory];
+    const requiredChannels = Object.values(state.channels)
+        .filter((channel) => channel?.requirement === 'required');
+    const permanentFailure = obligations.some(item => item.requirement === 'required' && item.state === 'failed')
+        || requiredChannels.some(item => item.status === 'failed');
+    if (permanentFailure)
+        return 'failed';
+    const incomplete = [
+        ...(state.action.requirement === 'required' && state.action.state === 'pending' ? ['action'] : []),
+        ...(state.verification.requirement === 'required' && state.verification.state === 'pending' ? ['verification'] : []),
+        ...(state.memory.requirement === 'required' && state.memory.state === 'pending' ? ['memory'] : []),
+        ...requiredChannels.filter(item => !channelSatisfied(item)).map(item => `channel:${channelName(state, item)}`),
+    ];
+    const ownedObligations = new Set(state.durableWorkOwners.values());
+    if (incomplete.length > 0 && incomplete.every(item => ownedObligations.has(item)))
+        return 'retry_pending';
+    if (incomplete.length > 0)
+        return 'failed';
+    const materialDegradation = state.runtimeHealth !== 'healthy'
+        || obligations.some(item => item.state === 'degraded')
+        || Object.values(state.channels).some(item => item?.material && item.status === 'degraded');
+    return materialDegradation ? 'completed_with_degradation' : 'completed';
+}
+function channelName(state, target) {
+    return (Object.entries(state.channels).find(([, value]) => value === target)?.[0]) ?? 'unknown';
+}
+function channelSatisfied(channel) {
+    return channel.status === 'satisfied'
+        || channel.status === 'intentional_abstention'
+        || channel.status === 'empty_valid'
+        || channel.status === 'degraded';
+}
+function withReceipt(current, state, payload) {
+    return {
+        ...current,
+        state,
+        ...(optionalString(payload.receiptId) ? { receiptId: optionalString(payload.receiptId) } : {}),
+        ...(optionalString(payload.reasonCode) ? { reasonCode: optionalString(payload.reasonCode) } : {}),
+    };
+}
+function failObligation(state, obligationName) {
+    if (obligationName === 'action')
+        state.action = { ...state.action, state: 'failed', reasonCode: 'dead_lettered' };
+    if (obligationName === 'verification')
+        state.verification = { ...state.verification, state: 'failed', reasonCode: 'dead_lettered' };
+    if (obligationName === 'memory')
+        state.memory = { ...state.memory, state: 'failed', reasonCode: 'dead_lettered' };
+}
+function readChannels(value) {
+    if (value === undefined)
+        return {};
+    const source = record(value, 'channels');
+    const result = {};
+    for (const channel of ['code', 'memory', 'knowledge']) {
+        if (source[channel] === undefined)
+            continue;
+        const item = record(source[channel], `channels.${channel}`);
+        result[channel] = {
+            requirement: oneOf(item.requirement, ['required', 'optional', 'not_required'], `channels.${channel}.requirement`),
+            status: oneOf(item.status, ['satisfied', 'intentional_abstention', 'empty_valid', 'degraded', 'failed'], `channels.${channel}.status`),
+            reasonCode: requiredString(item.reasonCode, `channels.${channel}.reasonCode`),
+            evidenceIds: stringArray(item.evidenceIds, `channels.${channel}.evidenceIds`),
+            material: Boolean(item.material),
+        };
+    }
+    return result;
+}
+function readArtifacts(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const item = record(value, 'artifacts');
+    return {
+        requiredIdentityIds: stringArray(item.requiredIdentityIds, 'artifacts.requiredIdentityIds'),
+        resolvedIdentityIds: stringArray(item.resolvedIdentityIds, 'artifacts.resolvedIdentityIds'),
+        ambiguousIdentityIds: stringArray(item.ambiguousIdentityIds, 'artifacts.ambiguousIdentityIds'),
+    };
+}
+function readHealth(value) {
+    return value === undefined ? 'healthy' : oneOf(value, ['healthy', 'degraded', 'unavailable'], 'runtimeHealth');
+}
+function mergeHealth(current, next) {
+    const rank = { healthy: 0, degraded: 1, unavailable: 2 };
+    return rank[next] > rank[current] ? next : current;
+}
+function sameIdentity(left, right) {
+    return stableRuntimeHash(left) === stableRuntimeHash(right);
+}
+function record(value, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`TASK_RUNTIME_PAYLOAD_INVALID:${field}`);
+    return value;
+}
+function requiredString(value, field) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`TASK_RUNTIME_PAYLOAD_INVALID:${field}`);
+    return value;
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function stringArray(value, field) {
+    if (!Array.isArray(value) || value.some(item => typeof item !== 'string' || !item.trim())) {
+        throw new Error(`TASK_RUNTIME_PAYLOAD_INVALID:${field}`);
+    }
+    return [...value];
+}
+function oneOf(value, values, field) {
+    if (typeof value !== 'string' || !values.includes(value))
+        throw new Error(`TASK_RUNTIME_PAYLOAD_INVALID:${field}`);
+    return value;
+}
+//# sourceMappingURL=task-runtime-reducer.js.map

package/dist/task-runtime-reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runtime-reducer.js","sourceRoot":"","sources":["../src/task-runtime-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,iBAAiB,GASlB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,iBAAiB,CAC/B,QAAoB,EACpB,MAA4B;IAE5B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5F,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5F,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACxG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG;QACX,aAAa,EAAE,0BAAmC;QAClD,QAAQ,EAAE,8BAA8B;QACxC,eAAe,EAAE,OAAO;QACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,YAAY,EAAE,QAAQ,CAAC,QAAQ;QAC/B,iBAAiB,EAAE,IAAI,CAAC,QAAQ;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC1D,QAAQ;QACR,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IACF,MAAM,QAAQ,GAA0B,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3F,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAaD,SAAS,YAAY,CAAC,QAAoB;IACxC,OAAO;QACL,SAAS,EAAE;YACT,mBAAmB,EAAE,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,mBAAmB,CAAC;YAChE,mBAAmB,EAAE,EAAE;YACvB,oBAAoB,EAAE,EAAE;SACzB;QACD,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;QAC/C,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC;QAC3D,MAAM,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE;QACrD,iBAAiB,EAAE,IAAI,GAAG,EAAE;QAC5B,aAAa,EAAE,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,WAA+B;IACjD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,KAAK,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,UAAU,CAAC,KAA0B,EAAE,KAAyB;IACvE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,iBAAiB,CAAC;QACvB,KAAK,qBAAqB;YACxB,OAAO;QACT,KAAK,mBAAmB;YACtB,KAAK,CAAC,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAChD,KAAK,CAAC,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACpE,KAAK,CAAC,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAClE,KAAK,CAAC,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;YAC1F,OAAO;QACT,KAAK,gBAAgB;YACnB,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7D,OAAO;QACT,KAAK,kBAAkB;YACrB,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/D,OAAO;QACT,KAAK,eAAe;YAClB,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO;QACT,KAAK,wBAAwB;YAC3B,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAC3E,OAAO;QACT,KAAK,qBAAqB;YACxB,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxE,OAAO;QACT,KAAK,kBAAkB,CAAC;QACxB,KAAK,gBAAgB;YACnB,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/D,OAAO;QACT,KAAK,gBAAgB;YACnB,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7D,OAAO;QACT,KAAK,eAAe;YAClB,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO;QACT,KAAK,oBAAoB;YACvB,KAAK,CAAC,iBAAiB,CAAC,GAAG,CACzB,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,EACxC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CACjD,CAAC;YACF,OAAO;QACT,KAAK,wBAAwB;YAC3B,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzE,OAAO;QACT,KAAK,4BAA4B;YAC/B,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1D,KAAK,CAAC,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAA0B;IACjD,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;SACnD,MAAM,CAAC,CAAC,OAAO,EAAkC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,UAAU,CAAC,CAAC;IAC5F,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;WACxG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC7D,IAAI,gBAAgB;QAAE,OAAO,QAAQ,CAAC;IAEtC,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,KAAK,UAAU,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpH,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;KAC/G,CAAC;IACF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,eAAe,CAAC;IAC1G,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE3C,MAAM,mBAAmB,GAAG,KAAK,CAAC,aAAa,KAAK,SAAS;WACxD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC;WACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAC9F,OAAO,mBAAmB,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,WAAW,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,KAA0B,EAAE,MAA2B;IAC1E,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAClG,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA4B;IACpD,OAAO,OAAO,CAAC,MAAM,KAAK,WAAW;WAChC,OAAO,CAAC,MAAM,KAAK,wBAAwB;WAC3C,OAAO,CAAC,MAAM,KAAK,aAAa;WAChC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAClB,OAA+B,EAC/B,KAAsC,EACtC,OAAgC;IAEhC,OAAO;QACL,GAAG,OAAO;QACV,KAAK;QACL,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClG,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAA0B,EAAE,cAAuB;IACzE,IAAI,cAAc,KAAK,QAAQ;QAAE,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAClH,IAAI,cAAc,KAAK,cAAc;QAAE,KAAK,CAAC,YAAY,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IACpI,IAAI,cAAc,KAAK,QAAQ;QAAE,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACpH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,MAAM,GAAsC,EAAE,CAAC;IACrD,KAAK,MAAM,OAAO,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAU,EAAE,CAAC;QAC/D,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;YAAE,SAAS;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,OAAO,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,YAAY,OAAO,cAAc,CAAC;YACjH,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,wBAAwB,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,YAAY,OAAO,SAAS,CAAC;YACtI,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,OAAO,aAAa,CAAC;YAC7E,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,OAAO,cAAc,CAAC;YAC7E,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;SACjC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,QAA4C;IAE5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACxC,OAAO;QACL,mBAAmB,EAAE,WAAW,CAAC,IAAI,CAAC,mBAAmB,EAAE,+BAA+B,CAAC;QAC3F,mBAAmB,EAAE,WAAW,CAAC,IAAI,CAAC,mBAAmB,EAAE,+BAA+B,CAAC;QAC3F,oBAAoB,EAAE,WAAW,CAAC,IAAI,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;KAC/F,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,eAAe,CAAC,CAAC;AACjH,CAAC;AAED,SAAS,WAAW,CAAC,OAAsB,EAAE,IAAmB;IAC9D,MAAM,IAAI,GAAkC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IACxF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,IAAoC,EAAE,KAA6B;IACvF,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,KAAa;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IAC1H,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IACzG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,KAAK,CAAyB,KAAc,EAAE,MAAoB,EAAE,KAAa;IACxF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IACxH,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/task-runtime-store.d.ts

@@ -0,0 +1,34 @@
+import { type DevFlowDatabase } from '@devflow-tools/database';
+import { type TaskRuntimeEventKind, type TaskRuntimeEventV1, type TaskRuntimeSnapshotV1, type TaskSpecV1 } from './task-runtime.js';
+export type EvidenceRuntimeMode = 'off' | 'shadow' | 'project';
+export interface AppendTaskRuntimeBoundaryInput {
+    projectRoot: string;
+    taskSpec?: TaskSpecV1;
+    identity?: TaskRuntimeEventV1['identity'];
+    kind: TaskRuntimeEventKind;
+    payload?: Record<string, unknown>;
+    dedupeKey: string;
+    producer: string;
+    producerVersion?: string;
+    createdAt?: number;
+    database?: DevFlowDatabase;
+    env?: NodeJS.ProcessEnv;
+}
+export interface AppendedTaskRuntimeBoundary {
+    mode: Exclude<EvidenceRuntimeMode, 'off'>;
+    event: TaskRuntimeEventV1;
+    snapshot: TaskRuntimeSnapshotV1;
+    replayed: boolean;
+}
+export interface AppendTaskRuntimeBoundaryForTaskInput extends Omit<AppendTaskRuntimeBoundaryInput, 'taskSpec' | 'identity' | 'database'> {
+    sessionId: string;
+    turnId: string;
+    database?: DevFlowDatabase;
+}
+/** Append from an already-bound runtime stream without rebuilding host identity. */
+export declare function appendTaskRuntimeBoundaryForTask(input: AppendTaskRuntimeBoundaryForTaskInput): AppendedTaskRuntimeBoundary | null;
+export declare function resolveEvidenceRuntimeMode(projectRoot: string, env?: NodeJS.ProcessEnv): EvidenceRuntimeMode;
+export declare function evidenceRuntimeProjectHash(projectRoot: string): string;
+export declare function appendTaskRuntimeBoundary(input: AppendTaskRuntimeBoundaryInput): AppendedTaskRuntimeBoundary | null;
+export declare function loadTaskSpec(database: DevFlowDatabase, identity?: TaskRuntimeEventV1['identity']): TaskSpecV1;
+//# sourceMappingURL=task-runtime-store.d.ts.map

package/dist/task-runtime-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runtime-store.d.ts","sourceRoot":"","sources":["../src/task-runtime-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC1C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qCAAsC,SAAQ,IAAI,CACjE,8BAA8B,EAC9B,UAAU,GAAG,UAAU,GAAG,UAAU,CACrC;IACC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,oFAAoF;AACpF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,2BAA2B,GAAG,IAAI,CAkBpC;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,mBAAmB,CAOrB;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,2BAA2B,GAAG,IAAI,CAuEpC;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,eAAe,EACzB,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GACxC,UAAU,CAUZ"}

package/dist/task-runtime-store.js

@@ -0,0 +1,126 @@
+import { createHash } from 'node:crypto';
+import { realpathSync } from 'node:fs';
+import { openGlobalDevFlowDatabase, } from '@devflow-tools/database';
+import { assertTaskSpecV1, stableRuntimeHash, } from './task-runtime.js';
+import { reduceTaskRuntime } from './task-runtime-reducer.js';
+/** Append from an already-bound runtime stream without rebuilding host identity. */
+export function appendTaskRuntimeBoundaryForTask(input) {
+    const ownsDatabase = !input.database;
+    const database = input.database ?? openGlobalDevFlowDatabase(undefined, { busyTimeoutMs: 250 });
+    try {
+        const first = database.listTaskRuntimeEvents(input.projectRoot, input.sessionId, input.turnId)[0];
+        const taskSpec = first?.payload.taskSpec;
+        if (!taskSpec || typeof taskSpec !== 'object' || Array.isArray(taskSpec)) {
+            throw new Error('TASK_RUNTIME_SPEC_EVENT_MISSING');
+        }
+        const { sessionId: _sessionId, turnId: _turnId, database: _database, ...boundary } = input;
+        return appendTaskRuntimeBoundary({
+            ...boundary,
+            taskSpec: taskSpec,
+            database,
+        });
+    }
+    finally {
+        if (ownsDatabase)
+            database.close();
+    }
+}
+export function resolveEvidenceRuntimeMode(projectRoot, env = process.env) {
+    const requested = env.DEVFLOW_EVIDENCE_RUNTIME_MODE;
+    if (requested !== 'shadow' && requested !== 'project')
+        return 'off';
+    if (requested === 'shadow')
+        return 'shadow';
+    const allowed = new Set((env.DEVFLOW_EVIDENCE_RUNTIME_PROJECTS ?? '')
+        .split(',').map(value => value.trim()).filter(Boolean));
+    return allowed.has(evidenceRuntimeProjectHash(projectRoot)) ? 'project' : 'off';
+}
+export function evidenceRuntimeProjectHash(projectRoot) {
+    let canonical = projectRoot;
+    try {
+        canonical = realpathSync(projectRoot);
+    }
+    catch { /* Non-existent roots remain fail-closed for project mode. */ }
+    return createHash('sha256').update(canonical).digest('hex');
+}
+export function appendTaskRuntimeBoundary(input) {
+    const mode = resolveEvidenceRuntimeMode(input.projectRoot, input.env);
+    if (mode === 'off')
+        return null;
+    const ownsDatabase = !input.database;
+    const database = input.database ?? openGlobalDevFlowDatabase(undefined, { busyTimeoutMs: 250 });
+    try {
+        const taskSpec = input.taskSpec ?? loadTaskSpec(database, input.identity);
+        assertTaskSpecV1(taskSpec);
+        if (input.identity && stableRuntimeHash(input.identity) !== stableRuntimeHash(taskSpec.identity)) {
+            throw new Error('TASK_RUNTIME_IDENTITY_MISMATCH');
+        }
+        const eventId = `task-runtime:${stableRuntimeHash({
+            identity: taskSpec.identity,
+            kind: input.kind,
+            dedupeKey: input.dedupeKey,
+        }).slice(0, 32)}`;
+        const existing = database.getTaskRuntimeEvent(eventId);
+        if (existing) {
+            const expectedPayload = input.kind === 'task.spec.bound'
+                ? { ...(input.payload ?? {}), taskSpec }
+                : input.payload ?? {};
+            if (existing.kind !== input.kind
+                || existing.taskSpecHash !== taskSpec.specHash
+                || stableRuntimeHash(existing.payload) !== stableRuntimeHash(expectedPayload)) {
+                throw new Error(`TASK_RUNTIME_EVENT_CONFLICT:${eventId}`);
+            }
+            const snapshot = database.getTaskRuntimeSnapshot(taskSpec.identity.projectRoot, taskSpec.identity.sessionId, taskSpec.identity.turnId);
+            if (!snapshot)
+                throw new Error('TASK_RUNTIME_SNAPSHOT_MISSING');
+            return { mode, event: existing, snapshot: snapshot, replayed: true };
+        }
+        let previous = database.listTaskRuntimeEvents(taskSpec.identity.projectRoot, taskSpec.identity.sessionId, taskSpec.identity.turnId);
+        if (previous.length === 0 && input.kind !== 'task.spec.bound') {
+            appendTaskRuntimeBoundary({
+                ...input,
+                taskSpec,
+                identity: taskSpec.identity,
+                kind: 'task.spec.bound',
+                payload: {},
+                dedupeKey: taskSpec.specHash,
+                producer: 'task-runtime-bootstrap',
+                createdAt: taskSpec.createdAt,
+                database,
+            });
+            previous = database.listTaskRuntimeEvents(taskSpec.identity.projectRoot, taskSpec.identity.sessionId, taskSpec.identity.turnId);
+        }
+        const event = {
+            schemaVersion: 'task-runtime-event.v1',
+            producer: input.producer,
+            producerVersion: input.producerVersion ?? '1.0.0',
+            eventId,
+            sequence: previous.length + 1,
+            identity: taskSpec.identity,
+            taskSpecHash: taskSpec.specHash,
+            kind: input.kind,
+            payload: input.kind === 'task.spec.bound'
+                ? { ...(input.payload ?? {}), taskSpec }
+                : input.payload ?? {},
+            createdAt: input.createdAt ?? Date.now(),
+        };
+        const snapshot = reduceTaskRuntime(taskSpec, [...previous, event]);
+        const persisted = database.appendTaskRuntimeEventAndSnapshot(event, snapshot);
+        return { mode, event, snapshot: persisted, replayed: false };
+    }
+    finally {
+        if (ownsDatabase)
+            database.close();
+    }
+}
+export function loadTaskSpec(database, identity) {
+    if (!identity)
+        throw new Error('TASK_RUNTIME_IDENTITY_REQUIRED');
+    const first = database.listTaskRuntimeEvents(identity.projectRoot, identity.sessionId, identity.turnId)[0];
+    const candidate = first?.payload.taskSpec;
+    if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {
+        throw new Error('TASK_RUNTIME_SPEC_EVENT_MISSING');
+    }
+    return candidate;
+}
+//# sourceMappingURL=task-runtime-store.js.map

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

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

package/dist/task-runtime.d.ts

@@ -0,0 +1,114 @@
+import type { CanonicalTaskIdentity, ImmutableTaskIntentArtifact, IntentEvidence } from './types/task-semantic-control.js';
+import type { CanonicalTaskIntent } from './types/task-context-envelope.js';
+import type { RetrievalTaskAction } from './types/memory.js';
+export declare const TASK_SPEC_SCHEMA: "task-spec.v1";
+export declare const TASK_RUNTIME_EVENT_SCHEMA: "task-runtime-event.v1";
+export declare const TASK_RUNTIME_SNAPSHOT_SCHEMA: "task-runtime-snapshot.v1";
+export type ArtifactKind = 'component' | 'page' | 'route' | 'module' | 'test' | 'config' | 'resource' | 'source';
+export type ChannelRequirement = 'required' | 'optional' | 'not_required';
+export type ChannelResultStatus = 'satisfied' | 'intentional_abstention' | 'empty_valid' | 'degraded' | 'failed';
+export type TerminalOutcome = 'running' | 'retry_pending' | 'completed' | 'completed_with_degradation' | 'failed';
+export type RuntimeHealth = 'healthy' | 'degraded' | 'unavailable';
+export type ObligationState = 'pending' | 'satisfied' | 'degraded' | 'failed';
+export interface TaskSpecV1 {
+    schemaVersion: typeof TASK_SPEC_SCHEMA;
+    producer: string;
+    producerVersion: string;
+    identity: CanonicalTaskIdentity;
+    revision: number;
+    supersedesSpecHash?: string;
+    source: {
+        rawPromptRef: string;
+        normalizedPrompt: string;
+        sourceEventIds: string[];
+        sourceHash: string;
+    };
+    intent: {
+        kind: CanonicalTaskIntent;
+        action: RetrievalTaskAction;
+        explicitCommand?: string;
+        entities: string[];
+        constraints: string[];
+        evidence: IntentEvidence[];
+    };
+    artifacts: {
+        explicitAnchors: string[];
+        requestedKinds: ArtifactKind[];
+        requiredIdentityIds: string[];
+        ambiguityPolicy: 'reject' | 'request_disambiguation';
+    };
+    obligations: {
+        action: 'required' | 'not_required';
+        verification: 'required' | 'optional' | 'not_required';
+        memoryDecision: 'required';
+        knowledge: 'explicit' | 'automatic' | 'not_applicable';
+    };
+    budgets: {
+        hookDeadlineMs: number;
+        contextTokens: number;
+        responseReserveTokens: number;
+        perChannelMs: Partial<Record<'code' | 'memory' | 'knowledge', number>>;
+    };
+    specHash: string;
+    createdAt: number;
+}
+export type TaskRuntimeEventKind = 'task.spec.bound' | 'context.completed' | 'action.lease.issued' | 'action.started' | 'action.succeeded' | 'action.failed' | 'verification.succeeded' | 'verification.failed' | 'memory.committed' | 'memory.skipped' | 'memory.pending' | 'memory.failed' | 'durable_work.owned' | 'durable_work.completed' | 'durable_work.dead_lettered';
+export interface TaskRuntimeEventV1 {
+    schemaVersion: typeof TASK_RUNTIME_EVENT_SCHEMA;
+    producer: string;
+    producerVersion: string;
+    eventId: string;
+    sequence: number;
+    identity: CanonicalTaskIdentity;
+    taskSpecHash: string;
+    kind: TaskRuntimeEventKind;
+    payload: Record<string, unknown>;
+    createdAt: number;
+}
+export interface ChannelRuntimeState {
+    requirement: ChannelRequirement;
+    status: ChannelResultStatus;
+    reasonCode: string;
+    evidenceIds: string[];
+    material: boolean;
+}
+export interface ObligationRuntimeState {
+    requirement: ChannelRequirement;
+    state: ObligationState;
+    receiptId?: string;
+    reasonCode?: string;
+}
+export interface ArtifactResolutionSummary {
+    requiredIdentityIds: string[];
+    resolvedIdentityIds: string[];
+    ambiguousIdentityIds: string[];
+}
+export interface TaskRuntimeSnapshotV1 {
+    schemaVersion: typeof TASK_RUNTIME_SNAPSHOT_SCHEMA;
+    producer: string;
+    producerVersion: string;
+    identity: CanonicalTaskIdentity;
+    taskSpecHash: string;
+    lastEventSequence: number;
+    artifacts: ArtifactResolutionSummary;
+    channels: Partial<Record<'code' | 'memory' | 'knowledge', ChannelRuntimeState>>;
+    contextReceiptId?: string;
+    action: ObligationRuntimeState;
+    verification: ObligationRuntimeState;
+    memory: ObligationRuntimeState;
+    durableWorkIds: string[];
+    terminal: TerminalOutcome;
+    runtimeHealth: RuntimeHealth;
+    snapshotHash: string;
+    updatedAt: number;
+}
+export declare function taskSpecFromImmutableIntent(artifact: ImmutableTaskIntentArtifact, options?: {
+    hookDeadlineMs?: number;
+    contextTokens?: number;
+}): TaskSpecV1;
+export declare function assertTaskSpecV1(value: TaskSpecV1): void;
+export declare function assertTaskRuntimeEventV1(value: TaskRuntimeEventV1): void;
+export declare function assertTaskRuntimeSnapshotV1(value: TaskRuntimeSnapshotV1): void;
+export declare function stableRuntimeJson(value: unknown): string;
+export declare function stableRuntimeHash(value: unknown): string;
+//# sourceMappingURL=task-runtime.d.ts.map