@devflow-tools/workflow-engine 0.16.21 → 0.16.23

package/dist/workers/host-launcher.d.ts

@@ -0,0 +1,21 @@
+import { type ChildProcess } from 'node:child_process';
+import type { HostAdapter, HostWorkerLaunchProjection } from '@devflow-tools/sdk';
+import type { WorkerCoordinationPaths, WorkerHandoff, WorkerLaunchRequest, WorkerTaskEnvelope } from './types.js';
+export interface WorkerProcessResult {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    cancelled: boolean;
+    handoff?: WorkerHandoff;
+}
+export declare function createWorkerArtifacts(paths: WorkerCoordinationPaths, envelope: WorkerTaskEnvelope): void;
+export declare function projectWorkerLaunch(adapter: HostAdapter, request: WorkerLaunchRequest): HostWorkerLaunchProjection;
+export declare function launchWorker(adapter: HostAdapter, request: WorkerLaunchRequest, paths: WorkerCoordinationPaths, options?: {
+    parentEnv?: NodeJS.ProcessEnv;
+    onHeartbeat?: () => void;
+}): {
+    child: ChildProcess;
+    completion: Promise<WorkerProcessResult>;
+    cancel: () => void;
+};
+//# sourceMappingURL=host-launcher.d.ts.map

package/dist/workers/host-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-launcher.d.ts","sourceRoot":"","sources":["../../src/workers/host-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,kBAAkB,GAC3B,IAAI,CAQN;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,mBAAmB,GAC3B,0BAA0B,CAgB5B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;CAAO,GACxE;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CA4DvF"}

package/dist/workers/host-launcher.js

@@ -0,0 +1,99 @@
+import { spawn } from 'node:child_process';
+import { closeSync, mkdirSync, openSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { readWorkerHandoff, writeJsonAtomic, writeWorkerTask } from './handoff.js';
+const ALLOWED_ENV_KEYS = new Set([
+    'PATH', 'HOME', 'USER', 'SHELL', 'TMPDIR', 'LANG', 'LC_ALL',
+    'CODEX_HOME', 'ANTHROPIC_API_KEY', 'OPENAI_API_KEY',
+]);
+export function createWorkerArtifacts(paths, envelope) {
+    mkdirSync(paths.root, { recursive: true, mode: 0o700 });
+    writeWorkerTask(paths.taskFile, envelope);
+    writeJsonAtomic(paths.statusFile, {
+        workerId: envelope.workerId,
+        state: 'planned',
+        updatedAt: Date.now(),
+    });
+}
+export function projectWorkerLaunch(adapter, request) {
+    if (!adapter.workers) {
+        return {
+            status: 'unavailable', args: [], env: {}, detached: false,
+            completionFormat: 'handoff-file', reason: `Host ${adapter.id} does not support isolated workers.`,
+        };
+    }
+    const projection = adapter.workers.project(request);
+    if (projection.command?.includes('\0') || projection.args.some(arg => arg.includes('\0'))) {
+        throw new Error('WORKER_LAUNCH_INVALID_ARGUMENT');
+    }
+    return {
+        ...projection,
+        env: Object.fromEntries(Object.entries(projection.env)
+            .filter(([key, value]) => key.startsWith('DEVFLOW_') && typeof value === 'string')),
+    };
+}
+export function launchWorker(adapter, request, paths, options = {}) {
+    const projection = projectWorkerLaunch(adapter, request);
+    if (projection.status !== 'supported' || !projection.command) {
+        throw new Error(`WORKER_HOST_UNAVAILABLE:${projection.reason ?? adapter.id}`);
+    }
+    mkdirSync(dirname(paths.stdoutFile), { recursive: true });
+    const stdoutFd = openSync(paths.stdoutFile, 'a', 0o600);
+    const stderrFd = openSync(paths.stderrFile, 'a', 0o600);
+    const parentEnv = Object.fromEntries(Object.entries(options.parentEnv ?? process.env)
+        .filter(([key, value]) => ALLOWED_ENV_KEYS.has(key) && typeof value === 'string'));
+    const child = spawn(projection.command, projection.args, {
+        cwd: request.worktreePath,
+        shell: false,
+        detached: projection.detached,
+        stdio: ['ignore', stdoutFd, stderrFd],
+        env: { ...parentEnv, ...projection.env },
+    });
+    if (projection.detached)
+        child.unref();
+    closeSync(stdoutFd);
+    closeSync(stderrFd);
+    let timedOut = false;
+    let cancelled = false;
+    const terminate = () => {
+        if (child.exitCode !== null)
+            return;
+        child.kill('SIGTERM');
+        setTimeout(() => child.kill('SIGKILL'), 2_000).unref();
+    };
+    const timer = setTimeout(() => { timedOut = true; terminate(); }, request.timeoutMs);
+    timer.unref();
+    const heartbeat = setInterval(() => options.onHeartbeat?.(), 10_000);
+    heartbeat.unref();
+    const completion = new Promise((resolve, reject) => {
+        child.on('error', error => {
+            clearTimeout(timer);
+            clearInterval(heartbeat);
+            reject(error);
+        });
+        child.on('close', (exitCode, signal) => {
+            clearTimeout(timer);
+            clearInterval(heartbeat);
+            let handoff;
+            try {
+                handoff = readWorkerHandoff(paths.handoffFile, {
+                    workerId: request.workerId,
+                    runId: request.runId,
+                    stepId: request.stepId,
+                    contextReceipt: request.contextReceipt,
+                    worktreePath: request.worktreePath,
+                });
+            }
+            catch {
+                // Process exit is only a report event; missing handoff is handled by verification.
+            }
+            resolve({ exitCode, signal, timedOut, cancelled, handoff });
+        });
+    });
+    return {
+        child,
+        completion,
+        cancel: () => { cancelled = true; terminate(); },
+    };
+}
+//# sourceMappingURL=host-launcher.js.map

package/dist/workers/host-launcher.js.map

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

package/dist/workers/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types.js';
+export * from './paths.js';
+export * from './git-worktree.js';
+export * from './handoff.js';
+export * from './host-launcher.js';
+export * from './file-ownership.js';
+export * from './scheduler.js';
+export * from './context-session.js';
+export * from './verifier.js';
+export * from './merge-queue.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/workers/index.js

@@ -0,0 +1,11 @@
+export * from './types.js';
+export * from './paths.js';
+export * from './git-worktree.js';
+export * from './handoff.js';
+export * from './host-launcher.js';
+export * from './file-ownership.js';
+export * from './scheduler.js';
+export * from './context-session.js';
+export * from './verifier.js';
+export * from './merge-queue.js';
+//# sourceMappingURL=index.js.map

package/dist/workers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/workers/merge-queue.d.ts

@@ -0,0 +1,55 @@
+import type { WorkerVerificationResult } from './verifier.js';
+export interface MergeQueueRecord {
+    mergeId: string;
+    workerId: string;
+    projectRoot: string;
+    state: 'waiting' | 'ready' | 'conflict' | 'merged' | 'rejected';
+    parentRevision: string;
+    candidateRevision: string;
+    graderReceipts: string[];
+    simulationHash?: string;
+}
+export interface MergeQueueStore {
+    enqueueWorkflowMerge(input: {
+        workerId: string;
+        projectRoot: string;
+        baseRevision: string;
+        parentRevision: string;
+        candidateRevision: string;
+        graderReceipts: string[];
+        simulationHash?: string;
+    }): MergeQueueRecord | Promise<MergeQueueRecord>;
+    transitionWorkflowMerge(projectRoot: string, mergeId: string, target: MergeQueueRecord['state'], update?: {
+        parentRevision?: string;
+        simulationHash?: string;
+        mergeCommit?: string;
+        reason?: string;
+    }): MergeQueueRecord | Promise<MergeQueueRecord>;
+}
+export declare class SerializedWorkerMergeQueue {
+    private readonly store;
+    private readonly lifecycle;
+    constructor(store: MergeQueueStore, lifecycle?: {
+        onMerged?: (input: {
+            workerId: string;
+            mergeCommit: string;
+        }) => void | Promise<void>;
+        scheduleCleanup?: (input: {
+            workerId: string;
+            mergeCommit: string;
+        }) => void | Promise<void>;
+    });
+    enqueueAndMerge(input: {
+        workerId: string;
+        projectRoot: string;
+        baseRevision: string;
+        verification: WorkerVerificationResult;
+        message: string;
+    }): Promise<{
+        state: 'merged' | 'conflict';
+        mergeCommit?: string;
+        reason?: string;
+    }>;
+    private serialize;
+}
+//# sourceMappingURL=merge-queue.d.ts.map

package/dist/workers/merge-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-queue.d.ts","sourceRoot":"","sources":["../../src/workers/merge-queue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,KAAK,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjD,uBAAuB,CACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACjC,MAAM,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACnG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjD;AAID,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,KAAK,EAAE,eAAe,EACtB,SAAS,GAAE;QAC1B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACtF,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzF;IAGF,eAAe,CAAC,KAAK,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,wBAAwB,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAiDtE,SAAS;CAYxB"}

package/dist/workers/merge-queue.js

@@ -0,0 +1,76 @@
+import { createHash } from 'node:crypto';
+import { gitRevision, runGit, simulateMerge } from './git-worktree.js';
+const projectQueues = new Map();
+export class SerializedWorkerMergeQueue {
+    store;
+    lifecycle;
+    constructor(store, lifecycle = {}) {
+        this.store = store;
+        this.lifecycle = lifecycle;
+    }
+    async enqueueAndMerge(input) {
+        if (!input.verification.passed || !input.verification.finalRevision || !input.verification.simulationHash) {
+            throw new Error('WORKER_MERGE_REQUIRES_VERIFIED_EVIDENCE');
+        }
+        const record = await this.store.enqueueWorkflowMerge({
+            workerId: input.workerId,
+            projectRoot: input.projectRoot,
+            baseRevision: input.baseRevision,
+            parentRevision: input.verification.parentRevision,
+            candidateRevision: input.verification.finalRevision,
+            graderReceipts: input.verification.graderReceipts,
+            simulationHash: input.verification.simulationHash,
+        });
+        return this.serialize(input.projectRoot, async () => {
+            const currentParent = await gitRevision(input.projectRoot, 'HEAD');
+            if (currentParent !== record.parentRevision) {
+                await this.store.transitionWorkflowMerge(input.projectRoot, record.mergeId, 'conflict', {
+                    parentRevision: currentParent, reason: 'parent_advanced_after_simulation',
+                });
+                return { state: 'conflict', reason: 'parent_advanced_after_simulation' };
+            }
+            const simulation = await simulateMerge(input.projectRoot, currentParent, record.candidateRevision);
+            const currentHash = createHash('sha256').update(JSON.stringify({
+                parent: currentParent, candidate: record.candidateRevision, exitCode: simulation.exitCode,
+                stdout: simulation.stdout, stderr: simulation.stderr,
+            })).digest('hex');
+            if (simulation.exitCode !== 0 || currentHash !== record.simulationHash) {
+                await this.store.transitionWorkflowMerge(input.projectRoot, record.mergeId, 'conflict', {
+                    simulationHash: currentHash, reason: 'merge_simulation_changed',
+                });
+                return { state: 'conflict', reason: 'merge_simulation_changed' };
+            }
+            await this.store.transitionWorkflowMerge(input.projectRoot, record.mergeId, 'ready');
+            const merged = await runGit(input.projectRoot, [
+                'merge', '--no-ff', '--no-edit', '-m', input.message.slice(0, 500), record.candidateRevision,
+            ], { timeoutMs: 120_000, maxOutputBytes: 1_000_000 });
+            if (merged.exitCode !== 0) {
+                await runGit(input.projectRoot, ['merge', '--abort']);
+                await this.store.transitionWorkflowMerge(input.projectRoot, record.mergeId, 'conflict', { reason: 'merge_command_conflict' });
+                return { state: 'conflict', reason: 'merge_command_conflict' };
+            }
+            const mergeCommit = await gitRevision(input.projectRoot, 'HEAD');
+            await this.store.transitionWorkflowMerge(input.projectRoot, record.mergeId, 'merged', { mergeCommit });
+            await this.lifecycle.onMerged?.({ workerId: input.workerId, mergeCommit });
+            await this.lifecycle.scheduleCleanup?.({ workerId: input.workerId, mergeCommit });
+            return { state: 'merged', mergeCommit };
+        });
+    }
+    async serialize(projectRoot, operation) {
+        const prior = projectQueues.get(projectRoot) ?? Promise.resolve();
+        let release;
+        const current = new Promise(resolve => { release = resolve; });
+        const queued = prior.then(() => current);
+        projectQueues.set(projectRoot, queued);
+        await prior.catch(() => undefined);
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (projectQueues.get(projectRoot) === queued)
+                projectQueues.delete(projectRoot);
+        }
+    }
+}
+//# sourceMappingURL=merge-queue.js.map

package/dist/workers/merge-queue.js.map

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

package/dist/workers/paths.d.ts

@@ -0,0 +1,8 @@
+export declare function sanitizeWorkerSlug(value: string, fallback?: string): string;
+export declare function projectWorktreeHash(repositoryRoot: string): string;
+export declare function workerBranch(runId: string, stepId: string): string;
+export declare function workerWorktreePath(repositoryRoot: string, runId: string, stepId: string, home?: string): string;
+export declare function workerCoordinationRoot(workerId: string, home?: string): string;
+export declare function isPathInside(parent: string, candidate: string): boolean;
+export declare function assertSafeWorkerPath(repositoryRoot: string, candidate: string, home?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/workers/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/workers/paths.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAW,GAAG,MAAM,CAM7E;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,SAAY,GACf,MAAM,CAGR;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAY,GAAG,MAAM,CAEjF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,SAAY,GACf,MAAM,CAkBR"}

package/dist/workers/paths.js

@@ -0,0 +1,49 @@
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { basename, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { existsSync, realpathSync } from 'node:fs';
+export function sanitizeWorkerSlug(value, fallback = 'worker') {
+    const slug = value.trim().toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^[._-]+|[._-]+$/g, '')
+        .slice(0, 64);
+    return slug || fallback;
+}
+export function projectWorktreeHash(repositoryRoot) {
+    return createHash('sha256').update(resolve(repositoryRoot)).digest('hex').slice(0, 16);
+}
+export function workerBranch(runId, stepId) {
+    return `devflow/${sanitizeWorkerSlug(runId, 'run')}/${sanitizeWorkerSlug(stepId, 'step')}`;
+}
+export function workerWorktreePath(repositoryRoot, runId, stepId, home = homedir()) {
+    const name = `${sanitizeWorkerSlug(runId, 'run')}-${sanitizeWorkerSlug(stepId, 'step')}`;
+    return join(home, '.devflow', 'worktrees', projectWorktreeHash(repositoryRoot), name);
+}
+export function workerCoordinationRoot(workerId, home = homedir()) {
+    return join(home, '.devflow', 'workers', sanitizeWorkerSlug(workerId));
+}
+export function isPathInside(parent, candidate) {
+    const rel = relative(resolve(parent), resolve(candidate));
+    return rel === '' || (!rel.startsWith(`..${sep}`) && rel !== '..' && !isAbsolute(rel));
+}
+export function assertSafeWorkerPath(repositoryRoot, candidate, home = homedir()) {
+    const expectedRoot = resolve(home, '.devflow', 'worktrees', projectWorktreeHash(repositoryRoot));
+    const resolvedCandidate = resolve(candidate);
+    if (!isPathInside(expectedRoot, resolvedCandidate) || resolvedCandidate === expectedRoot) {
+        throw new Error(`WORKTREE_PATH_OUTSIDE_MANAGED_ROOT:${candidate}`);
+    }
+    if (isPathInside(repositoryRoot, resolvedCandidate)) {
+        throw new Error(`WORKTREE_PATH_INSIDE_SOURCE:${candidate}`);
+    }
+    const parent = resolve(resolvedCandidate, '..');
+    if (existsSync(parent)) {
+        const realParent = realpathSync(parent);
+        if (!isPathInside(expectedRoot, realParent)) {
+            throw new Error(`WORKTREE_PATH_SYMLINK_ESCAPE:${candidate}`);
+        }
+    }
+    if (!basename(resolvedCandidate).trim())
+        throw new Error('WORKTREE_PATH_EMPTY_NAME');
+    return resolvedCandidate;
+}
+//# sourceMappingURL=paths.js.map

package/dist/workers/paths.js.map

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

package/dist/workers/scheduler.d.ts

@@ -0,0 +1,19 @@
+import type { StepInstruction, WorkflowStepDef } from '@devflow-tools/sdk';
+import { type FileOwnership } from './file-ownership.js';
+export interface ScheduledWorkerStep<T> {
+    step: T;
+    ownership: FileOwnership;
+    eligible: boolean;
+    reason?: string;
+}
+export interface WorkerSchedule<T> {
+    batches: Array<Array<ScheduledWorkerStep<T>>>;
+    maxConcurrency: number;
+    recursiveRequestRejected: boolean;
+}
+export declare function resolveWorkerConcurrency(env?: NodeJS.ProcessEnv): number;
+export declare function scheduleWorkerSteps<T extends WorkflowStepDef | StepInstruction>(steps: T[], inputs?: Map<string, Record<string, unknown>>, options?: {
+    maxConcurrency?: number;
+    recursiveRequest?: boolean;
+}): WorkerSchedule<T>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/workers/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/workers/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAA2C,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElG,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIrF;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAC7E,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa,EACxD,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACpE,cAAc,CAAC,CAAC,CAAC,CA0BnB"}

package/dist/workers/scheduler.js

@@ -0,0 +1,37 @@
+import { ownershipOverlaps, predictFileOwnership } from './file-ownership.js';
+export function resolveWorkerConcurrency(env = process.env) {
+    const requested = Number(env.DEVFLOW_WORKER_CONCURRENCY ?? 3);
+    if (!Number.isFinite(requested))
+        return 3;
+    return Math.max(1, Math.min(3, Math.floor(requested)));
+}
+export function scheduleWorkerSteps(steps, inputs = new Map(), options = {}) {
+    const maxConcurrency = Math.max(1, Math.min(3, options.maxConcurrency ?? resolveWorkerConcurrency()));
+    if (options.recursiveRequest) {
+        return { batches: [], maxConcurrency, recursiveRequestRejected: true };
+    }
+    const scheduled = steps.map(step => {
+        const ownership = predictFileOwnership(step, inputs.get(step.id) ?? {});
+        return {
+            step,
+            ownership,
+            eligible: ownership.risk === 'low',
+            ...(ownership.risk === 'high' ? { reason: ownership.reasons.join(',') } : {}),
+        };
+    });
+    const batches = [];
+    for (const candidate of scheduled) {
+        if (!candidate.eligible) {
+            batches.push([candidate]);
+            continue;
+        }
+        const batch = batches.find(current => current.length < maxConcurrency
+            && current.every(existing => existing.eligible && !ownershipOverlaps(existing.ownership, candidate.ownership)));
+        if (batch)
+            batch.push(candidate);
+        else
+            batches.push([candidate]);
+    }
+    return { batches, maxConcurrency, recursiveRequestRejected: false };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/workers/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/workers/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAsB,MAAM,qBAAqB,CAAC;AAelG,MAAM,UAAU,wBAAwB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3E,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAU,EACV,SAA+C,IAAI,GAAG,EAAE,EACxD,UAAmE,EAAE;IAErE,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,IAAI,wBAAwB,EAAE,CAAC,CAAC,CAAC;IACtG,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACjC,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO;YACL,IAAI;YACJ,SAAS;YACT,QAAQ,EAAE,SAAS,CAAC,IAAI,KAAK,KAAK;YAClC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAyC,EAAE,CAAC;IACzD,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,cAAc;eAChE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClH,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC;AACtE,CAAC"}

package/dist/workers/types.d.ts

@@ -0,0 +1,78 @@
+export type WorkerHost = 'claude-code' | 'codex' | 'custom';
+export interface WorkerLaunchRequest {
+    workerId: string;
+    runId: string;
+    stepId: string;
+    host: WorkerHost;
+    worktreePath: string;
+    taskFile: string;
+    handoffFile: string;
+    statusFile: string;
+    sessionId: string;
+    executionId: string;
+    contextReceipt: string;
+    timeoutMs: number;
+}
+export interface WorkerTaskEnvelope {
+    workerId: string;
+    runId: string;
+    stepId: string;
+    projectRoot: string;
+    worktreePath: string;
+    baseRevision: string;
+    contextReceipt: string;
+    retrievalSessionId?: string;
+    allowedFiles: string[];
+    requiredTools: string[];
+    task: Record<string, unknown>;
+    verification: {
+        commands: Array<{
+            command: string;
+            args: string[];
+        }>;
+        graders: string[];
+    };
+    constraints: {
+        recursiveWorkers: false;
+        maxContextCycles: number;
+    };
+}
+export interface WorkerHandoff {
+    workerId: string;
+    runId: string;
+    stepId: string;
+    baseRevision: string;
+    finalRevision: string;
+    changedFiles: string[];
+    contextReceipt: string;
+    toolReceipts: string[];
+    reportReceipts: string[];
+    verificationIntent: string[];
+    summary: string;
+    hostStatus: 'completed' | 'failed' | 'cancelled' | 'timed_out';
+}
+export interface WorkerCoordinationPaths {
+    root: string;
+    taskFile: string;
+    handoffFile: string;
+    statusFile: string;
+    stdoutFile: string;
+    stderrFile: string;
+}
+export interface GitCommandResult {
+    command: string;
+    args: string[];
+    cwd: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    truncated: boolean;
+}
+export interface WorktreeDescriptor {
+    repositoryRoot: string;
+    worktreePath: string;
+    branch: string;
+    baseRevision: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,YAAY,EAAE;QACZ,QAAQ,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,WAAW,EAAE;QACX,gBAAgB,EAAE,KAAK,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;CAChE;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/workers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":""}

package/dist/workers/verifier.d.ts

@@ -0,0 +1,66 @@
+import type { WorkerHandoff } from './types.js';
+export interface WorkerGraderResult {
+    graderId: string;
+    kind: 'deterministic' | 'model' | 'human';
+    status: 'passed' | 'failed' | 'unavailable';
+    receipt: string;
+    reason?: string;
+}
+export interface WorkerGraderSummary {
+    status: 'passed' | 'failed' | 'unavailable';
+    results: WorkerGraderResult[];
+    blockingFailures: string[];
+    unavailableBlocking: string[];
+}
+export interface WorkerGraderRunner {
+    run(context: {
+        taskKind: string;
+        projectRoot: string;
+        evidence: Record<string, unknown>;
+    }, graderIds?: string[]): Promise<WorkerGraderSummary>;
+}
+export interface WorkerVerificationInput {
+    workerId: string;
+    projectRoot: string;
+    worktreePath: string;
+    baseRevision: string;
+    parentRevision: string;
+    contextReceipt: string;
+    allowedFiles: string[];
+    handoff: WorkerHandoff;
+    hostAction: {
+        state: string;
+        evidenceHash?: string;
+        report: Record<string, unknown>;
+    };
+    graderRunner?: WorkerGraderRunner;
+    graderIds?: string[];
+    verificationCommands?: Array<{
+        command: string;
+        args: string[];
+        timeoutMs?: number;
+    }>;
+}
+export interface WorkerVerificationResult {
+    passed: boolean;
+    state: 'merge_ready' | 'hold' | 'failed';
+    reason?: string;
+    finalRevision?: string;
+    changedFiles: string[];
+    graderReceipts: string[];
+    simulationHash?: string;
+    parentRevision: string;
+}
+export declare function verifyWorkerOutput(input: WorkerVerificationInput): Promise<WorkerVerificationResult>;
+export declare function runVerificationCommands(cwd: string, commands: Array<{
+    command: string;
+    args: string[];
+    timeoutMs?: number;
+}>): Promise<Array<{
+    command: string;
+    args: string[];
+    exitCode: number;
+    timedOut: boolean;
+    outputHash: string;
+}>>;
+//# sourceMappingURL=verifier.d.ts.map

package/dist/workers/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/workers/verifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1C,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC5C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA2D1G;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAoC9G"}