kortext 2.2.0 → 3.0.0

package/dist/server/orchestrator/approval-queue.js

@@ -0,0 +1,83 @@
+export class ApprovalQueue {
+    repos;
+    pollIntervalMs;
+    constructor(opts) {
+        this.repos = opts.repos;
+        this.pollIntervalMs = opts.pollIntervalMs ?? 500;
+    }
+    enqueue(input) {
+        const created = this.repos.pendingQuestions.create({
+            run_id: input.runId,
+            step_id: input.stepId ?? null,
+            question: input.question,
+            choices: input.choices ?? [],
+        });
+        this.repos.auditLog.append({
+            actor: 'orchestrator',
+            action: 'gate.awaiting-approval',
+            resource_type: 'pending_question',
+            resource_id: String(created.id),
+            payload: {
+                run_id: input.runId,
+                question: input.question,
+                choices: input.choices ?? [],
+            },
+        });
+        return created;
+    }
+    answer(id, answer, answered_by) {
+        const answered = this.repos.pendingQuestions.answer(id, answer, answered_by);
+        this.repos.auditLog.append({
+            actor: answered_by,
+            action: 'gate.answered',
+            resource_type: 'pending_question',
+            resource_id: String(id),
+            payload: { answer, run_id: answered.run_id },
+        });
+        return answered;
+    }
+    /** Returns the first open question for a run (oldest by created_at). */
+    findOpenForRun(runId) {
+        const open = this.repos.pendingQuestions.listOpen();
+        return open.find((q) => q.run_id === runId) ?? null;
+    }
+    async waitForAnswer(id, opts = {}) {
+        const signal = opts.signal;
+        while (true) {
+            if (signal?.aborted) {
+                throw new Error('waitForAnswer aborted');
+            }
+            const current = this.repos.pendingQuestions.get(id);
+            if (!current)
+                throw new Error(`pending_question not found: ${id}`);
+            if (current.status === 'answered')
+                return current;
+            if (current.status === 'expired' || current.status === 'cancelled') {
+                throw new Error(`pending_question ${id} ended without answer: ${current.status}`);
+            }
+            await delay(this.pollIntervalMs, signal);
+        }
+    }
+}
+function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('waitForAnswer aborted'));
+            return;
+        }
+        const t = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            cleanup();
+            reject(new Error('waitForAnswer aborted'));
+        };
+        const cleanup = () => {
+            clearTimeout(t);
+            signal?.removeEventListener('abort', onAbort);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=approval-queue.js.map

package/dist/server/orchestrator/approval-queue.js.map

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

package/dist/server/orchestrator/blueprint-watcher.js

@@ -0,0 +1,94 @@
+import { existsSync, readFileSync, watch } from 'node:fs';
+export class BlueprintWatcher {
+    opts;
+    lastSeenStatus = null;
+    inFlight = null;
+    fsWatcher = null;
+    debounceTimer = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    start() {
+        if (this.fsWatcher)
+            return;
+        if (!existsSync(this.opts.filePath)) {
+            // Watch the directory and look for the file appearing later.
+            // For Faz 3 we keep it simple and require the file to exist already.
+            return;
+        }
+        this.fsWatcher = watch(this.opts.filePath, () => {
+            if (this.debounceTimer)
+                clearTimeout(this.debounceTimer);
+            this.debounceTimer = setTimeout(() => {
+                void this.handleChange();
+            }, this.opts.debounceMs ?? 150);
+        });
+    }
+    stop() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.fsWatcher) {
+            this.fsWatcher.close();
+            this.fsWatcher = null;
+        }
+    }
+    async handleChange() {
+        if (this.inFlight)
+            return this.inFlight;
+        this.inFlight = this.doHandleChange().finally(() => {
+            this.inFlight = null;
+        });
+        return this.inFlight;
+    }
+    async doHandleChange() {
+        if (!existsSync(this.opts.filePath)) {
+            return { triggered: false, reason: 'file-missing' };
+        }
+        const status = readStatusFrontmatter(this.opts.filePath);
+        if (status === null) {
+            return { triggered: false, reason: 'no-status' };
+        }
+        const previous = this.lastSeenStatus;
+        this.lastSeenStatus = status;
+        if (status !== 'approved') {
+            return { triggered: false, reason: 'not-approved' };
+        }
+        if (previous === 'approved') {
+            return { triggered: false, reason: 'unchanged' };
+        }
+        try {
+            await this.opts.onApproved(this.opts.filePath);
+            return { triggered: true };
+        }
+        catch {
+            // Reset cache so the next change can retry the trigger.
+            this.lastSeenStatus = previous;
+            return { triggered: false, reason: 'callback-failed' };
+        }
+    }
+}
+function readStatusFrontmatter(path) {
+    let body;
+    try {
+        body = readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    if (!body.startsWith('---'))
+        return null;
+    const end = body.indexOf('\n---', 3);
+    if (end < 0)
+        return null;
+    const block = body.slice(3, end);
+    for (const raw of block.split('\n')) {
+        const line = raw.trim();
+        if (line.startsWith('status:')) {
+            return line.slice('status:'.length).trim().replace(/^['"]|['"]$/g, '');
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=blueprint-watcher.js.map

package/dist/server/orchestrator/blueprint-watcher.js.map

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

package/dist/server/orchestrator/orchestrator.js

@@ -0,0 +1,283 @@
+import { buildGraph } from "../engine/dag.js";
+import { runWorkflow, } from "../engine/worker-pool.js";
+import { chainNextWorkflow } from "./pipeline-chainer.js";
+import { BlueprintWatcher } from "./blueprint-watcher.js";
+export class Orchestrator {
+    opts;
+    maxParallelRuns;
+    active = 0;
+    waiters = [];
+    watcher = null;
+    constructor(opts) {
+        this.opts = opts;
+        this.maxParallelRuns = Math.max(1, opts.maxParallelRuns ?? 3);
+        if (opts.blueprint) {
+            this.watcher = new BlueprintWatcher({
+                filePath: opts.blueprint.filePath,
+                onApproved: async () => {
+                    await this.triggerWorkflow(opts.blueprint.triggerWorkflowId);
+                },
+            });
+        }
+    }
+    setMaxParallelRuns(n) {
+        this.maxParallelRuns = Math.max(1, n);
+        // Wake waiters if we just raised the limit.
+        while (this.active < this.maxParallelRuns && this.waiters.length > 0) {
+            const wake = this.waiters.shift();
+            wake?.();
+        }
+    }
+    start() {
+        this.watcher?.start();
+    }
+    stop() {
+        this.watcher?.stop();
+    }
+    /** Exposed so tests (and future webhooks) can poke the watcher directly. */
+    async handleBlueprintChange() {
+        if (!this.watcher)
+            return;
+        await this.watcher.handleChange();
+    }
+    async triggerWorkflow(workflowId) {
+        await this.acquireSlot();
+        try {
+            return await this.runOne(workflowId);
+        }
+        finally {
+            this.releaseSlot();
+        }
+    }
+    async triggerMany(workflowIds) {
+        return Promise.all(workflowIds.map((id) => this.triggerWorkflow(id)));
+    }
+    /**
+     * Retry a previously rejected run.
+     *
+     * Preconditions:
+     *   - the run exists, is `cancelled`, and its `error_message` starts with `rejected:`
+     *   - the workflow definition is still resolvable via `loadWorkflowById`
+     *
+     * Behaviour:
+     *   - succeeded steps from the original run are marked `skipped` (resumed) on
+     *     the new run so the scheduler picks up at the next layer
+     *   - the previous worktree is reused (no new acquireWorktree call)
+     */
+    async retryRun(runId) {
+        const previous = this.opts.repos.runs.getRun(runId);
+        if (!previous)
+            return { ok: false, reason: 'run-not-found' };
+        const msg = previous.error_message ?? '';
+        const retryable = previous.status === 'cancelled' &&
+            (msg.startsWith('rejected:') || msg.startsWith('orphaned:'));
+        if (!retryable)
+            return { ok: false, reason: 'not-retryable' };
+        const def = this.opts.loadWorkflowById(previous.workflow_id);
+        if (!def)
+            return { ok: false, reason: 'workflow-not-found' };
+        await this.acquireSlot();
+        try {
+            const graph = buildGraph(def);
+            const indexToKey = new Map();
+            for (const node of graph.nodes.values()) {
+                indexToKey.set(node.step.index, node.step.key);
+            }
+            const completedKeys = new Set();
+            for (const step of this.opts.repos.runs.listSteps(previous.id)) {
+                if (step.status === 'succeeded') {
+                    const key = indexToKey.get(step.step_index);
+                    if (key)
+                        completedKeys.add(key);
+                }
+            }
+            this.opts.repos.auditLog.append({
+                actor: 'orchestrator',
+                action: 'run.retry',
+                resource_type: 'run',
+                resource_id: String(previous.id),
+                payload: {
+                    workflow_id: previous.workflow_id,
+                    resumed_step_keys: [...completedKeys],
+                    worktree_path: previous.worktree_path,
+                },
+            });
+            const result = await runWorkflow(graph, this.opts.executor, this.opts.repos, {
+                concurrency: this.opts.runOptions?.concurrency,
+                safety: this.opts.runOptions?.safety,
+                triggeredBy: `retry:${previous.id}`,
+                itemId: previous.item_id,
+                worktreePath: previous.worktree_path ?? undefined,
+                gates: def.gates,
+                gateController: this.opts.gateController,
+                preCompletedStepKeys: completedKeys,
+            });
+            const succeeded = result.run.status === 'succeeded';
+            await this.dispatch(succeeded ? 'pipeline.succeeded' : 'pipeline.failed', {
+                runId: result.run.id,
+                workflowId: def.id,
+                summary: succeeded
+                    ? `${def.title} succeeded after retry`
+                    : `${def.title} failed after retry`,
+                payload: {
+                    workflow_id: def.id,
+                    retry_of: previous.id,
+                },
+            });
+            return { ok: true, run: result.run, chainedRuns: [] };
+        }
+        finally {
+            this.releaseSlot();
+        }
+    }
+    async runOne(workflowId) {
+        const def = this.opts.loadWorkflowById(workflowId);
+        if (!def) {
+            this.opts.repos.auditLog.append({
+                actor: 'orchestrator',
+                action: 'pipeline.trigger-skipped',
+                resource_type: 'workflow',
+                resource_id: workflowId,
+                payload: { reason: 'workflow-not-found' },
+            });
+            return { ok: false, reason: 'workflow-not-found' };
+        }
+        const graph = buildGraph(def);
+        if (this.opts.gateEnforcer) {
+            const gate = await this.opts.gateEnforcer.check(graph);
+            if (!gate.ok) {
+                this.opts.repos.auditLog.append({
+                    actor: 'orchestrator',
+                    action: 'pipeline.trigger-skipped',
+                    resource_type: 'workflow',
+                    resource_id: workflowId,
+                    payload: { reason: 'gate-failed', failures: gate.failures },
+                });
+                return { ok: false, reason: 'gate-failed', details: gate.failures };
+            }
+        }
+        let worktreePath;
+        let release = null;
+        if (this.opts.acquireWorktree) {
+            // We need an id to key the worktree. Create a placeholder run row first.
+            const placeholder = this.opts.repos.runs.createRun({
+                workflow_id: def.id,
+                item_id: null,
+                status: 'queued',
+                worktree_path: null,
+                triggered_by: 'orchestrator',
+            });
+            const handle = await this.opts.acquireWorktree(placeholder.id);
+            worktreePath = handle.path;
+            release = handle.release;
+            // We mark the placeholder cancelled — runWorkflow will create its own row.
+            this.opts.repos.runs.transitionRun(placeholder.id, 'cancelled');
+        }
+        try {
+            await this.dispatch('pipeline.started', {
+                runId: 0,
+                workflowId: def.id,
+                summary: `${def.title} starting`,
+                payload: { workflow_id: def.id },
+            });
+            const result = await runWorkflow(graph, this.opts.executor, this.opts.repos, {
+                concurrency: this.opts.runOptions?.concurrency,
+                safety: this.opts.runOptions?.safety,
+                triggeredBy: 'orchestrator',
+                itemId: null,
+                worktreePath,
+                gates: def.gates,
+                gateController: this.opts.gateController,
+            });
+            const succeeded = result.run.status === 'succeeded';
+            await this.dispatch(succeeded ? 'pipeline.succeeded' : 'pipeline.failed', {
+                runId: result.run.id,
+                workflowId: def.id,
+                summary: succeeded
+                    ? `${def.title} succeeded`
+                    : `${def.title} failed at step ${result.failedStepKey ?? '?'}`,
+                payload: {
+                    workflow_id: def.id,
+                    failed_step_key: result.failedStepKey,
+                },
+            });
+            if (release)
+                await release({ success: succeeded });
+            const chainedRuns = [];
+            if (succeeded) {
+                await this.followChain(result.run, def, chainedRuns);
+            }
+            return { ok: true, run: result.run, chainedRuns };
+        }
+        catch (err) {
+            if (release)
+                await release({ success: false });
+            const message = err instanceof Error ? err.message : String(err);
+            this.opts.repos.auditLog.append({
+                actor: 'orchestrator',
+                action: 'pipeline.execution-error',
+                resource_type: 'workflow',
+                resource_id: workflowId,
+                payload: { message },
+            });
+            return { ok: false, reason: 'execution-error', details: message };
+        }
+    }
+    async followChain(previousRun, previousDef, accumulated) {
+        if (!previousDef.nextWorkflowId)
+            return;
+        const chained = await chainNextWorkflow(previousRun, previousDef, {
+            repos: this.opts.repos,
+            executor: this.opts.executor,
+            loadWorkflowById: this.opts.loadWorkflowById,
+            gateEnforcer: this.opts.gateEnforcer,
+            acquireWorktree: this.opts.acquireWorktree,
+            runOptions: this.opts.runOptions,
+        });
+        if (!chained.chained)
+            return;
+        accumulated.push(chained.run);
+        const succeeded = chained.run.status === 'succeeded';
+        await this.dispatch(succeeded ? 'pipeline.succeeded' : 'pipeline.failed', {
+            runId: chained.run.id,
+            workflowId: chained.definition.id,
+            summary: succeeded
+                ? `${chained.definition.title} succeeded (chained)`
+                : `${chained.definition.title} failed (chained)`,
+            payload: { workflow_id: chained.definition.id, chained_from: previousDef.id },
+        });
+        if (succeeded) {
+            await this.followChain(chained.run, chained.definition, accumulated);
+        }
+    }
+    async dispatch(kind, event) {
+        if (!this.opts.dispatcher)
+            return;
+        try {
+            await this.opts.dispatcher.dispatch({ kind, ...event });
+        }
+        catch {
+            // Dispatcher errors must never break the run loop.
+        }
+    }
+    async acquireSlot() {
+        if (this.active < this.maxParallelRuns) {
+            this.active += 1;
+            return;
+        }
+        await new Promise((resolve) => {
+            this.waiters.push(() => {
+                this.active += 1;
+                resolve();
+            });
+        });
+    }
+    releaseSlot() {
+        this.active -= 1;
+        if (this.waiters.length > 0 && this.active < this.maxParallelRuns) {
+            const wake = this.waiters.shift();
+            wake?.();
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/server/orchestrator/orchestrator.js.map

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

package/dist/server/orchestrator/pipeline-chainer.js

@@ -0,0 +1,96 @@
+import { buildGraph } from "../engine/dag.js";
+import { runWorkflow } from "../engine/worker-pool.js";
+export async function chainNextWorkflow(previousRun, previousDefinition, opts) {
+    const { repos } = opts;
+    if (previousRun.status !== 'succeeded') {
+        recordSkipped(repos, previousRun, previousDefinition, 'previous-not-succeeded');
+        return { chained: false, reason: 'previous-not-succeeded' };
+    }
+    const nextId = previousDefinition.nextWorkflowId;
+    if (!nextId) {
+        recordSkipped(repos, previousRun, previousDefinition, 'no-next-workflow');
+        return { chained: false, reason: 'no-next-workflow' };
+    }
+    const nextDef = opts.loadWorkflowById(nextId);
+    if (!nextDef) {
+        recordSkipped(repos, previousRun, previousDefinition, 'next-workflow-not-found', {
+            requested_id: nextId,
+        });
+        return { chained: false, reason: 'next-workflow-not-found' };
+    }
+    const nextGraph = buildGraph(nextDef);
+    if (opts.gateEnforcer) {
+        const gate = await opts.gateEnforcer.check(nextGraph, {
+            previousWorkflowId: previousDefinition.id,
+        });
+        if (!gate.ok) {
+            recordSkipped(repos, previousRun, previousDefinition, 'gate-failed', {
+                failures: gate.failures,
+            });
+            return { chained: false, reason: 'gate-failed', details: gate.failures };
+        }
+    }
+    let worktreePath;
+    let release = null;
+    if (opts.acquireWorktree) {
+        // We don't have a run id yet — acquireWorktree is keyed on the *next* run.
+        // Allocate a transient id by inserting a placeholder run first.
+        const placeholder = repos.runs.createRun({
+            workflow_id: nextDef.id,
+            item_id: previousRun.item_id,
+            status: 'queued',
+            worktree_path: null,
+            triggered_by: `chain:${previousDefinition.id}`,
+        });
+        const handle = await opts.acquireWorktree(placeholder.id);
+        worktreePath = handle.path;
+        release = handle.release;
+        // We don't keep the placeholder — runWorkflow creates its own row.
+        // Mark it cancelled so audit history stays clean.
+        repos.runs.transitionRun(placeholder.id, 'cancelled');
+    }
+    try {
+        const result = await runWorkflow(nextGraph, opts.executor, repos, {
+            concurrency: opts.runOptions?.concurrency,
+            safety: opts.runOptions?.safety,
+            triggeredBy: `chain:${previousDefinition.id}`,
+            itemId: previousRun.item_id,
+            worktreePath,
+        });
+        repos.auditLog.append({
+            actor: 'orchestrator',
+            action: 'pipeline.chained',
+            resource_type: 'run',
+            resource_id: String(previousRun.id),
+            payload: {
+                from_workflow: previousDefinition.id,
+                to_workflow: nextDef.id,
+                next_run_id: result.run.id,
+                failed_step_key: result.failedStepKey,
+            },
+        });
+        if (release)
+            await release({ success: result.run.status === 'succeeded' });
+        return { chained: true, run: result.run, definition: nextDef };
+    }
+    catch (err) {
+        if (release)
+            await release({ success: false });
+        throw err;
+    }
+}
+function recordSkipped(repos, previousRun, previousDefinition, reason, extra) {
+    repos.auditLog.append({
+        actor: 'orchestrator',
+        action: 'pipeline.chain-skipped',
+        resource_type: 'run',
+        resource_id: String(previousRun.id),
+        payload: {
+            from_workflow: previousDefinition.id,
+            next_workflow: previousDefinition.nextWorkflowId,
+            reason,
+            ...extra,
+        },
+    });
+}
+//# sourceMappingURL=pipeline-chainer.js.map

package/dist/server/orchestrator/pipeline-chainer.js.map

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

package/dist/server/orchestrator/resume.js

@@ -0,0 +1,36 @@
+/**
+ * Resume / orphan-recovery on server boot.
+ *
+ * A 'running' run in the DB after restart is a zombie — the worker-pool that
+ * was driving it is gone. We flip these to 'cancelled' with a distinguishable
+ * error_message prefix so:
+ *
+ *   - the dashboard can render them as "interrupted" rather than "failed"
+ *   - `Orchestrator.retryRun()` can re-pick them up alongside rejected runs
+ *
+ * We deliberately do NOT auto-restart: the user must explicitly retry so they
+ * can inspect / fix the worktree first.
+ */
+export const ORPHANED_PREFIX = 'orphaned:';
+export const ORPHANED_MESSAGE = `${ORPHANED_PREFIX} server restarted`;
+export function resumeOrphanedRuns(repos) {
+    const running = repos.runs.listRuns({ status: 'running', limit: 1000 });
+    const recovered = [];
+    for (const run of running) {
+        repos.runs.transitionRun(run.id, 'cancelled', { error_message: ORPHANED_MESSAGE });
+        repos.auditLog.append({
+            actor: 'system',
+            action: 'run.orphaned-recovered',
+            resource_type: 'run',
+            resource_id: String(run.id),
+            payload: {
+                previous_status: 'running',
+                workflow_id: run.workflow_id,
+                worktree_path: run.worktree_path,
+            },
+        });
+        recovered.push(run.id);
+    }
+    return { recovered };
+}
+//# sourceMappingURL=resume.js.map

package/dist/server/orchestrator/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../server/orchestrator/resume.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,eAAe,mBAAmB,CAAC;AAMtE,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnF,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,wBAAwB;YAChC,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE;gBACP,eAAe,EAAE,SAAS;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;aACjC;SACF,CAAC,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}