zelari-code 1.25.0 → 1.27.0

package/dist/cli/kraken/executor.js

@@ -0,0 +1,420 @@
+/**
+ * KrakenGraphExecutor — F3: drives a TaskGraph to convergence.
+ *
+ * Consumes the pure primitives from `@zelari/core` (getReadyNodes,
+ * selectParallelWave, isSettled/isConverged) and the F2 tentacle runner
+ * (`runTentacle`) to execute a validated `TaskGraph`:
+ *   - repeatedly forms a parallel-safe "wave" of ready nodes (bounded by
+ *     ZELARI_KRAKEN_MAX_PARALLEL) and runs it concurrently;
+ *   - retries a failed node up to `node.maxRetries`, then spawns a `fix`
+ *     node (bounded by a global fix budget) that inherits the failed
+ *     node's deps/scope/acceptance; a node that still fails is left
+ *     terminally `error` and does NOT abort independent branches — nodes
+ *     that transitively depend on it are cascade-marked `skipped` so the
+ *     graph can still settle;
+ *   - merges worktree-isolated `general`/`fix` tentacles SEQUENTIALLY when
+ *     a `merge` node's deps complete (Correction 4 — no concurrent merges
+ *     into the same parent HEAD); on conflict the branch/worktree is kept
+ *     and surfaced, never auto-resolved;
+ *   - optionally gates final convergence on `run_backtest` (Level 3) when
+ *     `.zelari/world/checks.json` exists and ZELARI_SCHEMA_LOOP != '0'.
+ *
+ * Also drives the F5 observability surface: the graph-level live tracker
+ * in `./graphStatus.js` (start/update/end around the scheduling loop, for
+ * the StatusBar "graph x/y · n↑" chip) alongside the `graph_*`/`node_*`
+ * radio events emitted throughout.
+ *
+ * Explicitly NOT this module's job (deferred to F6):
+ *   - planning a graph from a prompt — that's `./planner.js` (F4); the
+ *     executor only executes the graph it's given;
+ *   - wiring into any slash command, headless flag, or `useChatTurn`.
+ *
+ * @since v0.10.x — Kraken graph engine (F3)
+ */
+import { getReadyNodes, isSettled, isConverged, failedNodeIds, countByStatus, selectParallelWave, } from '@zelari/core';
+import { runTentacle, } from './tentacle.js';
+import { mergeKrakenWorktree, } from '../tools/krakenWorktree.js';
+import { appendKrakenRadio } from '../tools/krakenRadio.js';
+import { runBacktest } from '../workspace/worldModel.js';
+import { startKrakenGraphLive, updateKrakenGraphLive, endKrakenGraphLive, } from './graphStatus.js';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+/** Default cap on concurrently-running tentacles across the whole graph. */
+export const DEFAULT_MAX_PARALLEL = 12;
+/** Default number of `fix` nodes the executor may spawn across one graph run. */
+export const DEFAULT_FIX_BUDGET = 3;
+export function resolveMaxParallel(env = process.env) {
+    const raw = env.ZELARI_KRAKEN_MAX_PARALLEL;
+    if (raw === undefined || raw === '')
+        return DEFAULT_MAX_PARALLEL;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : DEFAULT_MAX_PARALLEL;
+}
+export function resolveFixBudget(env = process.env) {
+    const raw = env.ZELARI_KRAKEN_FIX_BUDGET;
+    if (raw === undefined || raw === '')
+        return DEFAULT_FIX_BUDGET;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n >= 0 ? n : DEFAULT_FIX_BUDGET;
+}
+/**
+ * Default wall-clock bound per tentacle run (ms). The graph executor calls
+ * `runTentacle` directly, bypassing the `task` tool's own `timeoutMs: 300_000`
+ * enforcement (that only applies when a parent AgentHarness invokes `task`
+ * as a tool-call) — so without an executor-level bound, one stuck sub-agent
+ * (a hung bash command, a stalled fetch) hangs `execute()` forever, which
+ * hangs the whole headless process (main.ts only calls `process.exit()`
+ * after `runHeadless()`'s promise resolves), which leaves the Desktop app's
+ * "running" state stuck permanently. Matches the task tool's own budget.
+ */
+export const DEFAULT_NODE_TIMEOUT_MS = 300_000;
+/** Set ZELARI_KRAKEN_NODE_TIMEOUT_MS=0 to disable (not recommended). */
+export function resolveNodeTimeoutMs(env = process.env) {
+    const raw = env.ZELARI_KRAKEN_NODE_TIMEOUT_MS;
+    if (raw === undefined || raw === '')
+        return DEFAULT_NODE_TIMEOUT_MS;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n >= 0 ? n : DEFAULT_NODE_TIMEOUT_MS;
+}
+/**
+ * F6 kill-switch: the `/kraken graph` slash command and `--kraken-graph`
+ * headless flag both check this before planning/executing anything. On by
+ * default, like every other Kraken env toggle (only the literal '0' turns
+ * it off — see ZELARI_SCHEMA_LOOP / ZELARI_MEMORY / ZELARI_BROWSER).
+ */
+export function isKrakenGraphEnabled(env = process.env) {
+    return env.ZELARI_KRAKEN_GRAPH !== '0';
+}
+/** Whether the optional Level-3 world-model convergence gate should run. */
+export function isWorldModelGateEnabled(cwd, env = process.env, checksExists = defaultChecksExists) {
+    if ((env.ZELARI_SCHEMA_LOOP ?? '').trim() === '0')
+        return false;
+    return checksExists(cwd);
+}
+function defaultChecksExists(cwd) {
+    try {
+        return existsSync(path.join(cwd, '.zelari', 'world', 'checks.json'));
+    }
+    catch {
+        return false;
+    }
+}
+export class KrakenGraphExecutor {
+    deps;
+    parentCwd;
+    sessionId;
+    maxParallel;
+    nodeTimeoutMs;
+    fixBudgetRemaining;
+    worldModelGateOverride;
+    runTentacleFn;
+    mergeFn;
+    backtestFn;
+    nodeRunState = new Map();
+    fixCounter = 0;
+    constructor(opts) {
+        this.deps = opts.taskToolDeps;
+        this.parentCwd = opts.parentCwd;
+        this.sessionId = opts.sessionId;
+        this.maxParallel = opts.maxParallel ?? resolveMaxParallel();
+        this.nodeTimeoutMs = opts.nodeTimeoutMs ?? resolveNodeTimeoutMs();
+        this.fixBudgetRemaining = opts.fixBudget ?? resolveFixBudget();
+        this.worldModelGateOverride = opts.worldModelGate;
+        this.runTentacleFn = opts.runTentacleFn ?? runTentacle;
+        this.mergeFn = opts.mergeFn ?? mergeKrakenWorktree;
+        this.backtestFn = opts.backtestFn ?? runBacktest;
+    }
+    /** Execute the graph in place (mutates node statuses) until it settles. */
+    async execute(graph) {
+        // Anti-explosion / self-inflicted-hang guard: cap total loop iterations
+        // at a generous multiple of the node count instead of trusting the
+        // graph to always shrink monotonically (fix-node spawns grow it).
+        const maxIterations = Math.max(64, graph.nodes.size * 8);
+        let iterations = 0;
+        startKrakenGraphLive(graph);
+        while (!isSettled(graph)) {
+            iterations += 1;
+            if (iterations > maxIterations) {
+                this.radio('graph_failed', {
+                    description: 'graph executor',
+                    detail: `exceeded ${maxIterations} scheduling iterations without settling`,
+                    ok: false,
+                });
+                break;
+            }
+            const ready = getReadyNodes(graph);
+            if (ready.length === 0) {
+                // Nothing is ready but the graph hasn't settled: some pending nodes
+                // are permanently blocked by a failed/skipped dependency. Cascade
+                // skip them so the loop can terminate.
+                const skippedAny = this.skipBlockedNodes(graph);
+                if (!skippedAny) {
+                    // Nothing ready and nothing to skip — should not happen for a
+                    // validated DAG, but bail out rather than spin forever.
+                    break;
+                }
+                continue;
+            }
+            const wave = selectParallelWave(ready).slice(0, this.maxParallel);
+            for (const node of wave)
+                node.status = 'running';
+            const results = await Promise.all(wave.map((node) => this.runNode(node, graph)));
+            for (let i = 0; i < wave.length; i++) {
+                this.applyResult(graph, wave[i], results[i]);
+            }
+            updateKrakenGraphLive(graph);
+        }
+        let backtest;
+        const converged = isConverged(graph);
+        if (converged) {
+            const gateOn = this.worldModelGateOverride ?? isWorldModelGateEnabled(this.parentCwd);
+            if (gateOn) {
+                backtest = await this.backtestFn(this.parentCwd);
+            }
+            this.radio('graph_converged', {
+                description: 'graph executor',
+                detail: backtest ? `backtest: ${backtest.passed}/${backtest.total} passed` : undefined,
+                ok: backtest ? backtest.ok : true,
+            });
+        }
+        else {
+            this.radio('graph_failed', {
+                description: 'graph executor',
+                detail: `failed nodes: ${failedNodeIds(graph).join(', ') || 'none'}`,
+                ok: false,
+            });
+        }
+        endKrakenGraphLive(graph, converged);
+        return {
+            graph,
+            converged,
+            failedNodeIds: failedNodeIds(graph),
+            counts: countByStatus(graph),
+            ...(backtest ? { backtest } : {}),
+        };
+    }
+    /** Run one node: dispatch to the merge handler for `merge` nodes, else a tentacle. */
+    async runNode(node, graph) {
+        this.radio('node_start', { description: node.label, agent: node.kind });
+        if (node.kind === 'merge') {
+            return this.runMergeNode(node, graph);
+        }
+        const usesWorktree = node.kind === 'general' || node.kind === 'fix';
+        const agent = node.kind === 'fix' ? 'general' : node.kind;
+        const res = await this.withNodeTimeout(this.runTentacleFn({
+            deps: this.deps,
+            args: {
+                description: node.label,
+                prompt: node.prompt,
+                scope: node.scope,
+                acceptance: node.acceptance,
+            },
+            agent,
+            thoroughness: 'medium',
+            parentCwd: this.parentCwd,
+            sessionId: this.sessionId,
+            // Defer merge for writers so the executor controls merge ordering
+            // (Correction 4); explore/verify never create a worktree.
+            deferMerge: usesWorktree,
+            graphId: graph.id,
+            nodeId: node.id,
+        }), agent);
+        if (res.ok && usesWorktree) {
+            this.nodeRunState.set(node.id, { worktreeHandle: res.worktreeHandle });
+        }
+        return res;
+    }
+    /**
+     * Bound a tentacle run to `nodeTimeoutMs` wall-clock. On timeout, resolves
+     * to a synthetic `TentacleFailure` so the normal retry/fix/cascade-skip
+     * path handles it — this only bounds how long the EXECUTOR waits, it does
+     * not (cannot) forcibly cancel the underlying sub-agent run; the point is
+     * to guarantee `execute()` itself always settles so the caller's process
+     * can exit instead of hanging forever on one stuck node.
+     */
+    withNodeTimeout(promise, agent) {
+        if (this.nodeTimeoutMs <= 0)
+            return promise;
+        const ms = this.nodeTimeoutMs;
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                resolve({ ok: false, agent, error: `tentacle timed out after ${ms}ms` });
+            }, ms);
+        });
+        return Promise.race([promise, timeout]).finally(() => {
+            if (timer)
+                clearTimeout(timer);
+        });
+    }
+    /**
+     * Sequentially merge every dep node's deferred worktree (in dep order) into
+     * parent HEAD. Deps without a recorded worktree handle (worktree isolation
+     * disabled, or a read-only node) are a no-op. On conflict the branch is
+     * kept and the conflict is surfaced in the merge node's error — remaining
+     * deps still attempt to merge (independent branches shouldn't be blocked
+     * by one conflict).
+     */
+    async runMergeNode(node, graph) {
+        const conflicts = [];
+        const merged = [];
+        for (const depId of node.deps) {
+            const state = this.nodeRunState.get(depId);
+            const handle = state?.worktreeHandle;
+            if (!handle)
+                continue; // nothing to merge for this dep
+            let result;
+            try {
+                result = await this.mergeFn(handle, {
+                    message: `kraken: merge ${graph.nodes.get(depId)?.label ?? depId}`.slice(0, 200),
+                });
+            }
+            catch (err) {
+                result = {
+                    ok: false,
+                    merged: false,
+                    committed: false,
+                    conflict: true,
+                    message: `merge threw: ${err instanceof Error ? err.message : String(err)}`,
+                };
+            }
+            if (!result.ok) {
+                conflicts.push(`${depId}: ${result.message}`);
+            }
+            else {
+                merged.push(depId);
+            }
+        }
+        if (conflicts.length > 0) {
+            return {
+                ok: false,
+                agent: 'general',
+                error: `merge: ${conflicts.length} conflict(s) — ${conflicts.join('; ')}`,
+            };
+        }
+        return {
+            ok: true,
+            agent: 'general',
+            thoroughness: 'medium',
+            model: 'n/a',
+            result: merged.length > 0 ? `merged: ${merged.join(', ')}` : 'nothing to merge',
+            footer: '',
+            worktreePath: null,
+            worktreeHandle: null,
+        };
+    }
+    /** Apply a tentacle result to its node: success, retry, fix-spawn, or terminal failure. */
+    applyResult(graph, node, res) {
+        if (res.ok) {
+            node.status = 'done';
+            node.result = res.result;
+            this.radio('node_end', { description: node.label, agent: node.kind, ok: true });
+            return;
+        }
+        node.error = res.error;
+        if (node.retryCount < node.maxRetries) {
+            node.retryCount += 1;
+            node.status = 'pending';
+            this.radio('node_retry', {
+                description: node.label,
+                agent: node.kind,
+                detail: `retry ${node.retryCount}/${node.maxRetries}: ${res.error}`,
+                ok: false,
+            });
+            return;
+        }
+        if (this.fixBudgetRemaining > 0 && node.kind !== 'fix') {
+            this.fixBudgetRemaining -= 1;
+            this.fixCounter += 1;
+            const fixNode = this.spawnFixNode(graph, node);
+            this.radio('node_fix', {
+                description: fixNode.label,
+                agent: fixNode.kind,
+                detail: `spawned to address failure of "${node.label}": ${res.error}`,
+                ok: false,
+            });
+            node.status = 'error';
+            return;
+        }
+        // Retries and fix budget exhausted (or this was itself a fix node):
+        // terminal failure. Independent branches keep running; dependents are
+        // cascade-skipped by the scheduling loop.
+        node.status = 'error';
+        this.radio('node_end', {
+            description: node.label,
+            agent: node.kind,
+            detail: res.error,
+            ok: false,
+        });
+    }
+    /**
+     * Create a `fix` node that attempts to redo the failed node's work, wired
+     * so downstream dependents of the failed node also wait on the fix.
+     */
+    spawnFixNode(graph, failed) {
+        const fixId = `fix-${failed.id}-${this.fixCounter}`;
+        const fixNode = {
+            id: fixId,
+            kind: 'fix',
+            label: `fix: ${failed.label}`,
+            prompt: `The previous attempt at this task failed and must be redone/repaired.\n\n` +
+                `## Original task\n${failed.prompt}\n\n` +
+                `## Failure\n${failed.error ?? 'unknown error'}`,
+            scope: failed.scope,
+            acceptance: failed.acceptance,
+            deps: [...failed.deps],
+            status: 'pending',
+            retryCount: 0,
+            maxRetries: 0,
+            // no further retries — one fix attempt per failed node in v1
+        };
+        graph.nodes.set(fixId, fixNode);
+        // Downstream dependents wait on the fix attempt INSTEAD of the failed
+        // node (not in addition to it) — the failed node never becomes `done`,
+        // so leaving it in `deps` would strand dependents forever.
+        for (const other of graph.nodes.values()) {
+            if (other.id === fixId)
+                continue;
+            if (other.deps.includes(failed.id)) {
+                other.deps = other.deps.map((d) => (d === failed.id ? fixId : d));
+            }
+        }
+        return fixNode;
+    }
+    /**
+     * Mark every `pending` node whose deps include a terminally-failed or
+     * skipped node as `skipped`, transitively, so the graph can settle.
+     * Returns true if any node was newly skipped.
+     */
+    skipBlockedNodes(graph) {
+        let changed = false;
+        let progressed = true;
+        while (progressed) {
+            progressed = false;
+            for (const node of graph.nodes.values()) {
+                if (node.status !== 'pending')
+                    continue;
+                const blocked = node.deps.some((d) => {
+                    const dep = graph.nodes.get(d);
+                    return dep?.status === 'error' || dep?.status === 'skipped';
+                });
+                if (blocked) {
+                    node.status = 'skipped';
+                    changed = true;
+                    progressed = true;
+                }
+            }
+        }
+        return changed;
+    }
+    radio(kind, fields) {
+        appendKrakenRadio(this.parentCwd, this.sessionId, {
+            kind,
+            agent: fields.agent ?? 'graph',
+            description: fields.description,
+            ...(fields.detail !== undefined ? { detail: fields.detail } : {}),
+            ...(fields.ok !== undefined ? { ok: fields.ok } : {}),
+        });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/cli/kraken/executor.js.map

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

package/dist/cli/kraken/graphStatus.js

@@ -0,0 +1,114 @@
+/**
+ * Kraken graph engine — observability (F5).
+ *
+ * Two independent pieces:
+ *   - `formatKrakenGraphAscii` — a pure renderer of a `TaskGraph`'s topology
+ *     and current node statuses (`/kraken graph` status block).
+ *   - a lightweight in-process "current graph" live tracker, mirroring
+ *     `krakenLive.ts`'s per-tentacle tracker but at the whole-graph level
+ *     (needed for accurate pending/skipped/merge-node counts that a
+ *     per-tentacle view can't see), feeding a StatusBar chip
+ *     ("graph 3/8 · 2↑") the same way `formatKrakenLiveSummary` does for
+ *     individual tentacles.
+ *
+ * Complements the `graph_*`/`node_*` radio events emitted by the F3
+ * executor (`src/cli/kraken/executor.ts`), which is also what drives this
+ * tracker via start/update/end calls around its scheduling loop.
+ *
+ * @since v0.10.x — Kraken graph engine (F5)
+ */
+import { topoLevels, countByStatus, } from '@zelari/core';
+const STATUS_ICON = {
+    pending: '·',
+    running: '…',
+    done: '✓',
+    error: '✗',
+    skipped: '»',
+};
+/** Multi-line ASCII rendering of a graph's topology + current node statuses. */
+export function formatKrakenGraphAscii(graph) {
+    const counts = countByStatus(graph);
+    const summaryParts = [`${counts.done}/${graph.nodes.size} done`];
+    if (counts.running)
+        summaryParts.push(`${counts.running} running`);
+    if (counts.error)
+        summaryParts.push(`${counts.error} failed`);
+    if (counts.skipped)
+        summaryParts.push(`${counts.skipped} skipped`);
+    const summary = `Kraken graph "${graph.id}" — ${summaryParts.join(', ')}`;
+    const levels = topoLevels(graph);
+    const lines = levels.map((ids, i) => {
+        const cells = ids.map((id) => {
+            const n = graph.nodes.get(id);
+            if (!n)
+                return `[?] ${id}`;
+            const icon = STATUS_ICON[n.status];
+            const scope = n.scope && n.scope.length > 0 ? `(${n.scope.join(',')})` : '';
+            return `[${icon}] ${n.id}${scope}`;
+        });
+        return `L${i}: ${cells.join('  ')}`;
+    });
+    if (lines.length === 0)
+        return summary;
+    return [summary, ...lines].join('\n');
+}
+function state() {
+    return globalThis;
+}
+/** Called by the executor when a graph run starts. */
+export function startKrakenGraphLive(graph) {
+    const counts = countByStatus(graph);
+    state().__zelariKrakenGraphLive = {
+        graphId: graph.id,
+        total: graph.nodes.size,
+        pending: counts.pending,
+        running: counts.running,
+        done: counts.done,
+        error: counts.error,
+        skipped: counts.skipped,
+        startedAt: Date.now(),
+    };
+}
+/** Called by the executor after each scheduling pass to refresh counts. */
+export function updateKrakenGraphLive(graph) {
+    const live = state().__zelariKrakenGraphLive;
+    if (!live || live.graphId !== graph.id)
+        return;
+    const counts = countByStatus(graph);
+    live.total = graph.nodes.size;
+    live.pending = counts.pending;
+    live.running = counts.running;
+    live.done = counts.done;
+    live.error = counts.error;
+    live.skipped = counts.skipped;
+}
+/** Called by the executor once the graph settles. */
+export function endKrakenGraphLive(graph, converged) {
+    updateKrakenGraphLive(graph);
+    const live = state().__zelariKrakenGraphLive;
+    if (!live || live.graphId !== graph.id)
+        return;
+    live.endedAt = Date.now();
+    live.converged = converged;
+}
+/** Clear the tracked graph (e.g. before starting a new one, or in tests). */
+export function resetKrakenGraphLive() {
+    state().__zelariKrakenGraphLive = null;
+}
+/** The currently (or most recently) tracked graph's live summary, if any. */
+export function getKrakenGraphLive() {
+    return state().__zelariKrakenGraphLive ?? null;
+}
+/** One-line chip for StatusBar: "graph 3/8 · 2↑" or null if no graph tracked. */
+export function formatKrakenGraphSummary() {
+    const live = getKrakenGraphLive();
+    if (!live)
+        return null;
+    const parts = [`${live.done}/${live.total}`];
+    if (live.running)
+        parts.push(`${live.running}↑`);
+    if (live.error)
+        parts.push(`${live.error}✗`);
+    return `graph ${parts.join(' · ')}`;
+}
+//# sourceMappingURL=graphStatus.js.map

package/dist/cli/kraken/graphStatus.js.map

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