@devflow-tools/sdk 0.17.1 → 0.17.3

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,yBAAyB,GAE1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAKlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAkC9D,oFAAoF;AACpF,MAAM,UAAU,gCAAgC,CAC9C,KAA4C;IAE5C,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,yBAAyB,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,qBAAqB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClG,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;QAC3F,OAAO,yBAAyB,CAAC;YAC/B,GAAG,QAAQ;YACX,QAAQ,EAAE,QAAiC;YAC3C,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,YAAY;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,WAAmB,EACnB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,SAAS,GAAG,GAAG,CAAC,6BAA6B,CAAC;IACpD,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,iCAAiC,IAAI,EAAE,CAAC;SAClE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,IAAI,SAAS,GAAG,WAAW,CAAC;IAC5B,IAAI,CAAC;QAAC,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,6DAA6D,CAAC,CAAC;IACtH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAqC;IAErC,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACtE,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,yBAAyB,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1E,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjG,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,OAAO,GAAG,gBAAgB,iBAAiB,CAAC;YAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB;gBACtD,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE;gBACxC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;YACxB,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;mBAC3B,QAAQ,CAAC,YAAY,KAAK,QAAQ,CAAC,QAAQ;mBAC3C,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,iBAAiB,CAAC,eAAe,CAAC,EAAE,CAAC;gBAChF,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,sBAAsB,CAC9C,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACrF,CAAC;YACF,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAChE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAA8B,EAAE,QAAQ,EAAE,QAAiC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtH,CAAC;QACD,IAAI,QAAQ,GAAG,QAAQ,CAAC,qBAAqB,CAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAC7D,CAAC;QAC1B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC9D,yBAAyB,CAAC;gBACxB,GAAG,KAAK;gBACR,QAAQ;gBACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,QAAQ,CAAC,QAAQ;gBAC5B,QAAQ,EAAE,wBAAwB;gBAClC,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,QAAQ;aACT,CAAC,CAAC;YACH,QAAQ,GAAG,QAAQ,CAAC,qBAAqB,CACvC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAC7D,CAAC;QAC5B,CAAC;QACD,MAAM,KAAK,GAAuB;YAChC,aAAa,EAAE,uBAAuB;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,OAAO;YACjD,OAAO;YACP,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,YAAY,EAAE,QAAQ,CAAC,QAAQ;YAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,IAAI,KAAK,iBAAiB;gBACvC,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE;gBACxC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE;YACvB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SACzC,CAAC;QACF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,iCAAiC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAkC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACxF,CAAC;YAAS,CAAC;QACT,IAAI,YAAY;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAyB,EACzB,QAAyC;IAEzC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,qBAAqB,CAC1C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAC1D,CAAC,CAAC,CAAC,CAAC;IACL,MAAM,SAAS,GAAG,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC;IAC1C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,SAAkC,CAAC;AAC5C,CAAC"}

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

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

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

package/dist/task-runtime.js

@@ -0,0 +1,157 @@
+import { createHash } from 'node:crypto';
+export const TASK_SPEC_SCHEMA = 'task-spec.v1';
+export const TASK_RUNTIME_EVENT_SCHEMA = 'task-runtime-event.v1';
+export const TASK_RUNTIME_SNAPSHOT_SCHEMA = 'task-runtime-snapshot.v1';
+export function taskSpecFromImmutableIntent(artifact, options = {}) {
+    const actionRequired = isExecutionObligation(artifact.intent, artifact.action);
+    const verification = actionRequired
+        ? 'required'
+        : artifact.intent === 'review' || artifact.intent === 'performance'
+            ? 'optional' : 'not_required';
+    const body = {
+        schemaVersion: TASK_SPEC_SCHEMA,
+        producer: 'devflow-task-intent-adapter',
+        producerVersion: '1.0.0',
+        identity: artifact.identity,
+        revision: artifact.version,
+        ...(artifact.supersedesHash ? { supersedesSpecHash: artifact.supersedesHash } : {}),
+        source: {
+            rawPromptRef: artifact.rawPrompt,
+            normalizedPrompt: artifact.normalizedPrompt,
+            sourceEventIds: [...artifact.sourceEventIds],
+            sourceHash: artifact.sourceHash,
+        },
+        intent: {
+            kind: artifact.intent,
+            action: artifact.action,
+            ...(artifact.command ? { explicitCommand: artifact.command } : {}),
+            entities: [...artifact.entities],
+            constraints: [...artifact.policyConstraints],
+            evidence: artifact.classificationEvidence.map(item => ({ ...item })),
+        },
+        artifacts: {
+            explicitAnchors: [...artifact.targetAnchors],
+            requestedKinds: requestedArtifactKinds(artifact.normalizedPrompt),
+            requiredIdentityIds: [],
+            ambiguityPolicy: 'request_disambiguation',
+        },
+        obligations: {
+            action: actionRequired ? 'required' : 'not_required',
+            verification,
+            memoryDecision: 'required',
+            knowledge: artifact.intent === 'knowledge'
+                ? 'explicit'
+                : artifact.intent === 'memory' ? 'not_applicable' : 'automatic',
+        },
+        budgets: {
+            hookDeadlineMs: options.hookDeadlineMs ?? 100,
+            contextTokens: options.contextTokens ?? 8_000,
+            responseReserveTokens: 2_048,
+            perChannelMs: { code: 500, memory: 300, knowledge: 500 },
+        },
+        createdAt: artifact.createdAt,
+    };
+    return { ...body, specHash: stableRuntimeHash(body) };
+}
+export function assertTaskSpecV1(value) {
+    assertSchema(value.schemaVersion, TASK_SPEC_SCHEMA);
+    assertProducer(value.producer, value.producerVersion);
+    assertIdentity(value.identity);
+    if (!Number.isSafeInteger(value.revision) || value.revision < 1)
+        throw new Error('TASK_SPEC_REVISION_INVALID');
+    assertJson(value);
+    const { specHash: _hash, ...body } = value;
+    if (stableRuntimeHash(body) !== value.specHash)
+        throw new Error('TASK_SPEC_HASH_MISMATCH');
+}
+export function assertTaskRuntimeEventV1(value) {
+    assertSchema(value.schemaVersion, TASK_RUNTIME_EVENT_SCHEMA);
+    assertProducer(value.producer, value.producerVersion);
+    assertIdentity(value.identity);
+    if (!value.eventId.trim() || !value.taskSpecHash.trim())
+        throw new Error('TASK_RUNTIME_EVENT_IDENTITY_INVALID');
+    if (!Number.isSafeInteger(value.sequence) || value.sequence < 1)
+        throw new Error('TASK_RUNTIME_SEQUENCE_INVALID');
+    assertJson(value.payload);
+}
+export function assertTaskRuntimeSnapshotV1(value) {
+    assertSchema(value.schemaVersion, TASK_RUNTIME_SNAPSHOT_SCHEMA);
+    assertProducer(value.producer, value.producerVersion);
+    assertIdentity(value.identity);
+    if (!Number.isSafeInteger(value.lastEventSequence) || value.lastEventSequence < 1) {
+        throw new Error('TASK_RUNTIME_SEQUENCE_INVALID');
+    }
+    if (value.terminal === 'retry_pending' && value.durableWorkIds.length === 0) {
+        throw new Error('TASK_RUNTIME_RETRY_OWNER_MISSING');
+    }
+    if ((value.terminal === 'completed' || value.terminal === 'completed_with_degradation')
+        && (requiredFailed(value.action) || requiredFailed(value.verification))) {
+        throw new Error('TASK_RUNTIME_FALSE_SUCCESS');
+    }
+    assertJson(value);
+}
+export function stableRuntimeJson(value) {
+    return JSON.stringify(canonicalize(value));
+}
+export function stableRuntimeHash(value) {
+    return createHash('sha256').update(stableRuntimeJson(value)).digest('hex');
+}
+function isExecutionObligation(intent, action) {
+    return ['create', 'modify', 'debug', 'test', 'format', 'build', 'install', 'release'].includes(action)
+        || ['feature', 'refactor', 'performance'].includes(intent);
+}
+function requestedArtifactKinds(prompt) {
+    const result = new Set();
+    if (/component|组件/iu.test(prompt))
+        result.add('component');
+    if (/\bpage\b|页面/iu.test(prompt))
+        result.add('page');
+    if (/route|routing|路由/iu.test(prompt))
+        result.add('route');
+    if (/\btests?\b|测试/iu.test(prompt))
+        result.add('test');
+    if (/\bconfig\b|配置/iu.test(prompt))
+        result.add('config');
+    return [...result];
+}
+function assertSchema(actual, expected) {
+    if (actual !== expected)
+        throw new Error(`TASK_RUNTIME_SCHEMA_UNSUPPORTED:${actual}`);
+}
+function assertProducer(producer, version) {
+    if (!producer.trim() || !version.trim())
+        throw new Error('TASK_RUNTIME_PRODUCER_INVALID');
+}
+function assertIdentity(identity) {
+    for (const [key, value] of Object.entries(identity)) {
+        if (key !== 'executionId' && (typeof value !== 'string' || !value.trim())) {
+            throw new Error(`TASK_RUNTIME_IDENTITY_INVALID:${key}`);
+        }
+    }
+    if (identity.executionId !== undefined && !identity.executionId.trim()) {
+        throw new Error('TASK_RUNTIME_IDENTITY_INVALID:executionId');
+    }
+}
+function requiredFailed(value) {
+    return value.requirement === 'required' && value.state === 'failed';
+}
+function assertJson(value) {
+    canonicalize(value);
+}
+function canonicalize(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || Object.is(value, -0))
+            throw new Error('TASK_RUNTIME_JSON_INVALID');
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (!value || typeof value !== 'object' || Object.getPrototypeOf(value) !== Object.prototype) {
+        throw new Error('TASK_RUNTIME_JSON_INVALID');
+    }
+    return Object.fromEntries(Object.keys(value)
+        .sort().map(key => [key, canonicalize(value[key])]));
+}
+//# sourceMappingURL=task-runtime.js.map

package/dist/task-runtime.js.map

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

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

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

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

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

package/dist/task-runtime.test.js

@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import { assertTaskRuntimeEventV1, assertTaskRuntimeSnapshotV1, taskSpecFromImmutableIntent, } from './task-runtime.js';
+const identity = {
+    projectRoot: '/project', projectId: 'project:1', hostId: 'claude-code',
+    sessionId: 'session:1', turnId: 'turn:1', requestId: 'request:1',
+};
+function event() {
+    return {
+        schemaVersion: 'task-runtime-event.v1', producer: 'test', producerVersion: '1.0.0',
+        eventId: 'event:1', sequence: 1, identity, taskSpecHash: 'spec:1',
+        kind: 'task.spec.bound', payload: {}, createdAt: 1,
+    };
+}
+function snapshot() {
+    return {
+        schemaVersion: 'task-runtime-snapshot.v1', producer: 'test', producerVersion: '1.0.0',
+        identity, taskSpecHash: 'spec:1', lastEventSequence: 1,
+        artifacts: { requiredIdentityIds: [], resolvedIdentityIds: [], ambiguousIdentityIds: [] },
+        channels: {},
+        action: { requirement: 'required', state: 'pending' },
+        verification: { requirement: 'required', state: 'pending' },
+        memory: { requirement: 'required', state: 'pending' },
+        durableWorkIds: [], terminal: 'running', runtimeHealth: 'healthy',
+        snapshotHash: 'snapshot:1', updatedAt: 1,
+    };
+}
+describe('task runtime contracts', () => {
+    it('accepts v1 events and rejects unknown major versions', () => {
+        expect(() => assertTaskRuntimeEventV1(event())).not.toThrow();
+        expect(() => assertTaskRuntimeEventV1({
+            ...event(), schemaVersion: 'task-runtime-event.v2',
+        })).toThrow('TASK_RUNTIME_SCHEMA_UNSUPPORTED');
+    });
+    it('requires retry ownership and rejects false success', () => {
+        expect(() => assertTaskRuntimeSnapshotV1({
+            ...snapshot(), terminal: 'retry_pending', durableWorkIds: [],
+        })).toThrow('TASK_RUNTIME_RETRY_OWNER_MISSING');
+        expect(() => assertTaskRuntimeSnapshotV1({
+            ...snapshot(), terminal: 'completed',
+            action: { requirement: 'required', state: 'failed' },
+        })).toThrow('TASK_RUNTIME_FALSE_SUCCESS');
+    });
+    it('adapts legacy intent to one stable TaskSpec hash', () => {
+        const artifact = {
+            identity, version: 1, rawPrompt: '生成登录组件', normalizedPrompt: '生成登录组件',
+            slashArgs: [], intent: 'feature', action: 'create', entities: [], targetAnchors: [],
+            policyConstraints: ['formatting'], classificationEvidence: [],
+            sourceEventIds: ['source:1'], sourceHash: 'source-hash', artifactHash: 'artifact-hash', createdAt: 1,
+        };
+        const first = taskSpecFromImmutableIntent(artifact);
+        const second = taskSpecFromImmutableIntent(artifact);
+        expect(second.specHash).toBe(first.specHash);
+        expect(first).toMatchObject({
+            schemaVersion: 'task-spec.v1', revision: 1,
+            obligations: { action: 'required', verification: 'required', memoryDecision: 'required' },
+            artifacts: { requestedKinds: ['component'] },
+        });
+    });
+});
+//# sourceMappingURL=task-runtime.test.js.map

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

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

package/dist/types/task-context-envelope.d.ts

@@ -28,9 +28,12 @@ export interface CanonicalTaskRequest {
     queryPlanHash?: string;
 }
 export type ContextFileRole = 'target' | 'caller' | 'dependency' | 'resource' | 'route' | 'test' | 'config';
+export type ArtifactContextRole = 'operation_target' | 'supporting_file' | 'reference_pattern';
 export interface SelectedCodeFile {
     path: string;
     role: ContextFileRole;
+    /** Authoritative mutation role. `role` remains for compatibility and display grouping. */
+    artifactRole: ArtifactContextRole;
     score: number;
     symbols: string[];
     evidence: string[];
@@ -105,6 +108,20 @@ export interface CanonicalAction {
         targetAnchors: string[];
         requiredContextReceipt: string;
         requiredPolicyFacets: import('./memory.js').PolicyFacet[];
+        operationMode?: 'create' | 'modify' | 'delete' | 'analyze' | 'debug' | 'format' | 'unknown';
+        normalizedInputHash?: string;
+        operationTargets?: Array<{
+            path: string;
+            expectedState: 'existing' | 'missing' | 'unknown';
+            contentHash?: string;
+        }>;
+        safeInputVariations?: Record<string, {
+            type: 'string' | 'number' | 'boolean';
+            enum?: Array<string | number | boolean>;
+            minimum?: number;
+            maximum?: number;
+            pattern?: string;
+        }>;
     };
     verificationPlan: Array<{
         kind: 'formatter' | 'lint' | 'typecheck' | 'test' | 'build' | 'generated_files';
@@ -112,6 +129,7 @@ export interface CanonicalAction {
         policyFacet?: import('./memory.js').PolicyFacet;
         mode?: 'check' | 'write';
     }>;
+    actionLease?: import('../action-lease.js').ActionLeaseV1;
 }
 export interface StructuredRetrievalDegradation {
     category: string;

package/dist/types/task-context-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-context-envelope.d.ts","sourceRoot":"","sources":["../../src/types/task-context-envelope.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-context-envelope.d.ts","sourceRoot":"","sources":["../../src/types/task-context-envelope.ts"],"names":[],"mappings":"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"}