ftown-bridge 0.11.2 → 0.12.0

package/dist/loop-scheduler.js

@@ -0,0 +1,487 @@
+import { spawn } from 'node:child_process';
+import { computeNextRun, isDue } from './loop-schedule.js';
+import { listLoops, mutateLoopRuntime } from './loop-store.js';
+/** Base tick cadence; also the finalize grace so a just-spawned PTY is not mistaken for exited. */
+export const LOOP_TICK_INTERVAL_MS = 30_000;
+const iso = (ms) => new Date(ms).toISOString();
+/**
+ * Runs child_process.exec and normalizes the result to { stdout, stderr,
+ * exitCode }. Never rejects — the exit code is the signal (a timeout maps to
+ * 124, any other failure to the real exit code or 1).
+ *
+ * The hard budget is enforced by SIGKILL on the whole process GROUP, NOT by
+ * exec's built-in `timeout`. exec's timeout only sends SIGTERM to the spawned
+ * `/bin/sh`; a detached grandchild that keeps the stdout pipe open, or a child
+ * that traps SIGTERM, would keep the exec callback from ever firing — and since
+ * the scheduler awaits every flight inside a single re-entrancy-guarded tick,
+ * ONE such flight would wedge the entire scheduler permanently. Spawning
+ * `detached` makes the child its own group leader, so `kill(-pid, SIGKILL)`
+ * takes down the whole tree and the flight can never exceed its budget.
+ */
+export function runFlightCommand(command, cwd, timeoutMs = 30_000, extraEnv) {
+    const env = extraEnv ? { ...process.env, ...extraEnv } : process.env;
+    const MAX_CAPTURE = 1024 * 1024;
+    return new Promise((resolve) => {
+        let settled = false;
+        let stdout = '';
+        let stderr = '';
+        let exitCode = null;
+        let killedByTimeout = false;
+        let exitGrace;
+        // Own process group (detached ⇒ the sh is its own group leader) so the hard
+        // timeout can SIGKILL the WHOLE tree, including a grandchild that outlived
+        // its parent's SIGTERM or kept the stdout pipe open. This is what stops one
+        // runaway flight from wedging the awaiting tick forever.
+        const child = spawn('/bin/sh', ['-c', command], {
+            cwd: cwd ?? process.cwd(),
+            env,
+            detached: true,
+        });
+        const settle = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(hardTimer);
+            clearTimeout(exitGrace);
+            // Release the pipe read-ends so a still-open grandchild write-end cannot
+            // keep the bridge's event loop (or the test runner) alive after we return.
+            child.stdout?.destroy();
+            child.stderr?.destroy();
+            child.unref?.();
+            resolve({ stdout, stderr, exitCode: killedByTimeout ? 124 : (exitCode ?? 1) });
+        };
+        const recordExit = (code, signal) => {
+            if (exitCode === null)
+                exitCode = typeof code === 'number' ? code : signal ? 1 : 0;
+        };
+        child.stdout?.on('data', (d) => {
+            if (stdout.length < MAX_CAPTURE)
+                stdout += d.toString('utf8');
+        });
+        child.stderr?.on('data', (d) => {
+            if (stderr.length < MAX_CAPTURE)
+                stderr += d.toString('utf8');
+        });
+        child.on('error', () => {
+            if (exitCode === null)
+                exitCode = 1;
+            settle();
+        });
+        // Settle on 'exit' (the shell terminated), NOT 'close' (all stdio closed):
+        // a backgrounded/detached grandchild keeps the pipe open, so 'close' may
+        // never come. 'close' still wins the race when it fires first (full stdout);
+        // otherwise a short grace after 'exit' lets the parent's own output flush.
+        child.on('exit', (code, signal) => {
+            recordExit(code, signal);
+            exitGrace = setTimeout(settle, 150);
+            exitGrace.unref?.();
+        });
+        child.on('close', (code, signal) => {
+            recordExit(code, signal);
+            settle();
+        });
+        const hardTimer = setTimeout(() => {
+            killedByTimeout = true;
+            if (child.pid) {
+                try {
+                    process.kill(-child.pid, 'SIGKILL'); // whole process group
+                }
+                catch {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        /* already gone */
+                    }
+                }
+            }
+            settle();
+        }, timeoutMs);
+        hardTimer.unref?.();
+    });
+}
+/** Byte-accurate tail: keep the last `maxBytes` of a (possibly huge) terminal log. */
+function truncateTail(text, maxBytes) {
+    const buf = Buffer.from(text, 'utf8');
+    if (buf.length <= maxBytes)
+        return text;
+    return buf.subarray(buf.length - maxBytes).toString('utf8');
+}
+/**
+ * Resolve a finished run to ok/error. ONLY a cleanly `completed` run is 'ok';
+ * a missing record (removed/lost) OR a store status still stuck at
+ * running/pending at finalize time (the process died without a clean status
+ * transition) is a crash ⇒ 'error'. Never reports a crashed run as success.
+ */
+function resolveRunStatus(run) {
+    return run?.status === 'completed' ? 'ok' : 'error';
+}
+/**
+ * The scheduled-loops engine. On each 30s tick it FINALIZES each loop's
+ * in-flight run(s) (Phase A) before deciding whether to FIRE a new one
+ * (Phase B). All side effects go through injected collaborators so it is
+ * unit-testable without a live bridge, real fs or real timers (mirrors
+ * workflow-runner.ts).
+ *
+ * Persistence rule: the scheduler NEVER writes a whole detached Loop back
+ * across an await. Every runtime-field change goes through
+ * store.mutateLoopRuntime (fresh-read → mutate → save), so a loop deleted or
+ * user-edited during a long flight is neither resurrected nor clobbered.
+ */
+export class LoopScheduler {
+    store;
+    runner;
+    centrifugo;
+    userId;
+    spawnSession;
+    removeSession;
+    loops;
+    runFlight;
+    now;
+    /** Re-entrancy guard: tick N+1 never overlaps N. */
+    tickRunning = false;
+    /** Set once start() runs (after reconcileOnStart). kick() no-ops before this so an
+     *  early run_loop_now cannot trigger an un-reconciled tick that stampedes overdue loops. */
+    started = false;
+    /** Per-loop in-memory fire lock, shared by tick + run_loop_now/kick. */
+    firingLoops = new Set();
+    /** loopId -> (runSessionId -> fire-time ms). Every run THIS process spawned, so under
+     *  overlapPolicy:'allow' each concurrent run is finalized/postflighted/maxRuntime-checked
+     *  independently — not just the newest. Rebuilt lazily from the persisted primary on restart. */
+    inFlight = new Map();
+    timer;
+    constructor(deps) {
+        this.store = deps.store;
+        this.runner = deps.runner;
+        this.centrifugo = deps.centrifugo;
+        this.userId = deps.userId;
+        this.spawnSession = deps.spawnSession;
+        this.removeSession = deps.removeSession;
+        this.loops = deps.loops ?? { listLoops, mutateLoopRuntime };
+        this.runFlight = deps.runFlight ?? runFlightCommand;
+        this.now = deps.now ?? (() => Date.now());
+    }
+    start() {
+        this.started = true;
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, LOOP_TICK_INTERVAL_MS);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    /** Immediate, guarded, out-of-band tick (used by run_loop_now). No-op until start()
+     *  has run, so a kick that races startup cannot fire before reconcileOnStart. */
+    kick() {
+        if (!this.started)
+            return;
+        if (!this.tickRunning)
+            void this.tick();
+    }
+    /** Drop scheduler tracking for a deleted loop and stop any run it left alive, so a
+     *  just-deleted loop never leaks a live AI session with nothing left to finalize it. */
+    onLoopDeleted(loop) {
+        const ids = new Set();
+        const tracked = this.inFlight.get(loop.id);
+        if (tracked)
+            for (const id of tracked.keys())
+                ids.add(id);
+        if (loop.lastStatus === 'running' && loop.lastSessionId)
+            ids.add(loop.lastSessionId);
+        for (const id of ids) {
+            if (this.runner.isRunning(id))
+                this.runner.stop(id);
+        }
+        this.inFlight.delete(loop.id);
+    }
+    /**
+     * Missed-schedule policy, run once before the first tick: for every loop whose
+     * nextRunAt is missing or already past, recompute it from now (skip missed
+     * occurrences; never stampede overdue loops). runNowRequested is preserved so a
+     * manual override survives a restart and still fires on the first tick. A loop
+     * with a corrupt persisted schedule is skipped here (logged) and reported as an
+     * error on its first fire.
+     */
+    async reconcileOnStart(now = this.now()) {
+        for (const loop of this.loops.listLoops()) {
+            try {
+                const overdue = loop.nextRunAt ? Date.parse(loop.nextRunAt) <= now : true;
+                if (!overdue)
+                    continue;
+                const nextRunMs = computeNextRun(loop.schedule, now); // may throw on a corrupt cron
+                await this.persist(loop.id, (l) => {
+                    l.nextRunAt = iso(nextRunMs);
+                    l.updatedAt = iso(now);
+                });
+            }
+            catch (err) {
+                console.error(`[LoopScheduler] reconcile failed for loop ${loop.id}:`, err);
+            }
+        }
+    }
+    async tick(now = this.now()) {
+        if (this.tickRunning)
+            return; // tick N+1 never overlaps N
+        this.tickRunning = true;
+        try {
+            for (const loop of this.loops.listLoops()) {
+                try {
+                    await this.processLoop(loop, now);
+                }
+                catch (err) {
+                    // One bad loop must not kill the tick (mirrors resurrectSessions).
+                    console.error(`[LoopScheduler] loop ${loop.id} failed:`, err);
+                }
+            }
+        }
+        finally {
+            this.tickRunning = false;
+        }
+    }
+    async processLoop(loop, now) {
+        await this.finalizePhase(loop, now); // Phase A — finalize before fire
+        await this.firePhase(loop, now); // Phase B
+    }
+    /** Phase A: finalize each in-flight run once its PTY is confirmed gone (past grace)
+     *  or over its per-run maxRuntime budget. Under 'allow' this walks every tracked run,
+     *  not just the newest, so none is orphaned. */
+    async finalizePhase(loop, now) {
+        this.ensureTracked(loop);
+        const tracked = this.inFlight.get(loop.id);
+        if (!tracked || tracked.size === 0)
+            return;
+        // Snapshot: finalizeRun mutates the map while we iterate.
+        for (const [runId, startedMs] of [...tracked]) {
+            const running = this.runner.isRunning(runId);
+            const elapsed = now - startedMs;
+            if (running && loop.maxRuntimeMs && elapsed > loop.maxRuntimeMs) {
+                this.runner.stop(runId);
+                await this.finalizeRun(loop, now, runId, true);
+            }
+            else if (!running && elapsed >= LOOP_TICK_INTERVAL_MS) {
+                await this.finalizeRun(loop, now, runId, false);
+            }
+            // else: still running, or still inside the grace window — leave it.
+        }
+    }
+    /** Seed the persisted primary run into in-memory tracking after a restart (when this
+     *  process has spawned nothing yet for the loop), so a run left 'running' by a prior
+     *  process is still finalized. */
+    ensureTracked(loop) {
+        if (loop.lastStatus !== 'running' || !loop.lastSessionId)
+            return;
+        const existing = this.inFlight.get(loop.id);
+        if (existing && existing.size > 0)
+            return; // already tracking this process's run(s)
+        const parsed = Date.parse(loop.lastRunAt ?? '');
+        const startedMs = Number.isNaN(parsed) ? this.now() : parsed;
+        const map = existing ?? new Map();
+        map.set(loop.lastSessionId, startedMs);
+        this.inFlight.set(loop.id, map);
+    }
+    track(loopId, sessionId, startedMs) {
+        const map = this.inFlight.get(loopId) ?? new Map();
+        map.set(sessionId, startedMs);
+        this.inFlight.set(loopId, map);
+    }
+    /** Phase B: fire the loop if due, honoring the per-loop lock and the overlap policy. */
+    async firePhase(loop, now) {
+        if (!isDue(loop, now))
+            return;
+        if (this.firingLoops.has(loop.id))
+            return;
+        // A previous run that has EXITED but was not yet finalized (still inside the
+        // grace window) must be finalized BEFORE we decide to fire. Otherwise a
+        // skip-policy loop double-fires in the grace window (isRunning is already
+        // false, so the overlap guard below misses it) and the just-finished run is
+        // orphaned — its finalize/postflight never runs.
+        if (loop.lastStatus === 'running' && loop.lastSessionId && !this.runner.isRunning(loop.lastSessionId)) {
+            await this.finalizeRun(loop, now, loop.lastSessionId, false);
+            const fresh = this.loops.listLoops().find((l) => l.id === loop.id);
+            if (!fresh)
+                return; // deleted during finalize
+            loop = fresh;
+        }
+        // Overlap guard: a skip-policy loop whose previous run is STILL alive advances
+        // its schedule only — no new fire, no skipCount bump (overlap-skip is not a
+        // preflight-skip).
+        if (loop.overlapPolicy === 'skip' &&
+            loop.lastStatus === 'running' &&
+            loop.lastSessionId &&
+            this.runner.isRunning(loop.lastSessionId)) {
+            await this.persist(loop.id, (l) => {
+                try {
+                    l.nextRunAt = iso(computeNextRun(l.schedule, now));
+                }
+                catch {
+                    /* corrupt schedule surfaces as an error on the fire path, not here */
+                }
+                l.runNowRequested = false;
+                l.updatedAt = iso(now);
+            });
+            return;
+        }
+        this.firingLoops.add(loop.id);
+        try {
+            await this.fireLoop(loop, now);
+        }
+        finally {
+            this.firingLoops.delete(loop.id);
+        }
+    }
+    /** Advance the schedule up front (so failures/skips never stampede), then preflight → flight. */
+    async fireLoop(loop, now) {
+        // Compute the next fire first so a persisted-corrupt schedule is reported as an
+        // error (with a bounded backoff) instead of silently re-throwing every tick.
+        let nextRunMs;
+        try {
+            nextRunMs = computeNextRun(loop.schedule, now);
+        }
+        catch (err) {
+            await this.persist(loop.id, (l) => {
+                l.lastRunAt = iso(now);
+                l.nextRunAt = iso(now + LOOP_TICK_INTERVAL_MS); // bounded backoff — no stampede
+                l.runNowRequested = false;
+                l.lastStatus = 'error';
+                l.updatedAt = iso(now);
+            });
+            console.error(`[LoopScheduler] bad schedule for loop ${loop.id}:`, err);
+            return;
+        }
+        try {
+            let preflightOut = '';
+            if (loop.preflight) {
+                const r = await this.runFlight(loop.preflight.command, loop.workdir, loop.preflight.timeoutMs);
+                preflightOut = r.stdout;
+                if (r.exitCode !== 0) {
+                    // ABORT: skip (not error), no session, no run-node.
+                    const skipped = await this.persist(loop.id, (l) => {
+                        l.lastRunAt = iso(now);
+                        l.nextRunAt = iso(nextRunMs);
+                        l.runNowRequested = false;
+                        l.lastStatus = 'skipped';
+                        l.skipCount += 1;
+                        l.updatedAt = iso(now);
+                    });
+                    if (skipped && loop.postflight?.runOnSkip) {
+                        await this.runPostflight(loop, { status: 'skipped', sessionId: '', output: '' });
+                    }
+                    return;
+                }
+            }
+            const task = loop.task.replaceAll('{{preflight}}', preflightOut);
+            const session = await this.spawnSession({
+                shellType: loop.harness,
+                prompt: task,
+                workingDir: loop.workdir,
+                model: loop.model,
+                env: preflightOut ? { FTOWN_PREFLIGHT_OUTPUT: preflightOut } : undefined,
+                loopId: loop.id,
+                suppressBriefing: true, // no child/orchestrator briefing paragraph in the task
+                name: `${loop.name} · ${iso(now)}`,
+                // parentSessionId intentionally omitted — loopId is the sole grouping key.
+            });
+            const updated = await this.persist(loop.id, (l) => {
+                l.lastRunAt = iso(now);
+                l.nextRunAt = iso(nextRunMs);
+                l.runNowRequested = false;
+                l.lastSessionId = session.id;
+                l.lastStatus = 'running';
+                l.runCount += 1;
+                l.updatedAt = iso(now);
+            });
+            if (!updated) {
+                // The loop was deleted during preflight/spawn: do not resurrect it and do
+                // not leave an orphan run that nothing would ever finalize or prune.
+                this.runner.stop(session.id);
+                await this.removeSession(session.id).catch(() => undefined);
+                return;
+            }
+            this.track(loop.id, session.id, now);
+        }
+        catch (err) {
+            // A failure after the schedule was computed: record error + persist so the
+            // loop resumes its cadence instead of stampede-retrying every tick.
+            await this.persist(loop.id, (l) => {
+                l.lastRunAt = iso(now);
+                l.nextRunAt = iso(nextRunMs);
+                l.runNowRequested = false;
+                l.lastStatus = 'error';
+                l.updatedAt = iso(now);
+            });
+            console.error(`[LoopScheduler] fire failed for loop ${loop.id}:`, err);
+        }
+    }
+    /** Resolve one finished run to ok/error, update the loop badge (only if this is the
+     *  loop's tracked/latest run), then run postflight + retention for it. */
+    async finalizeRun(loop, now, runId, forcedError) {
+        const tracked = this.inFlight.get(loop.id);
+        if (tracked) {
+            tracked.delete(runId);
+            if (tracked.size === 0)
+                this.inFlight.delete(loop.id);
+        }
+        const run = runId ? await this.store.loadSession(runId) : null;
+        const status = forcedError ? 'error' : resolveRunStatus(run);
+        const output = truncateTail(runId ? await this.store.loadTerminalLog(runId) : '', 65_536);
+        // Only the loop's most-recently-STARTED run (lastSessionId) drives the badge;
+        // an older overlapping 'allow' run finalizes silently (still postflight +
+        // retention) without flipping the badge away from a newer run's state.
+        const updated = await this.persist(loop.id, (l) => {
+            if (l.lastSessionId === runId)
+                l.lastStatus = status;
+            l.updatedAt = iso(now);
+        });
+        void updated;
+        if (loop.postflight) {
+            await this.runPostflight(loop, { status, sessionId: runId, output });
+        }
+        await this.pruneRuns(loop);
+    }
+    async runPostflight(loop, ctx) {
+        if (!loop.postflight)
+            return;
+        await this.runFlight(loop.postflight.command, loop.workdir, loop.postflight.timeoutMs, {
+            FTOWN_RUN_STATUS: ctx.status,
+            FTOWN_RUN_SESSION_ID: ctx.sessionId,
+            FTOWN_RUN_OUTPUT: ctx.output,
+        });
+    }
+    /** Keep the newest N run-sessions for this loop; prune older finished ones. */
+    async pruneRuns(loop) {
+        const keep = loop.retention.autoClearAfterRuns;
+        if (keep == null)
+            return;
+        const runs = (await this.store.listSessions())
+            .filter((s) => s.loopId === loop.id)
+            .sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt));
+        for (const run of runs.slice(keep)) {
+            if (this.runner.isRunning(run.id))
+                continue;
+            if (run.id === loop.lastSessionId)
+                continue;
+            await this.removeSession(run.id, { onlyIfFinished: true });
+        }
+    }
+    async persist(id, fn) {
+        const updated = this.loops.mutateLoopRuntime(id, fn);
+        if (updated)
+            await this.publish(updated);
+        return updated;
+    }
+    async publish(loop) {
+        try {
+            await this.centrifugo.publishLoopUpdate(this.userId, loop);
+        }
+        catch (err) {
+            // A UI-sync failure must never break the scheduler (matches session create).
+            console.error(`[LoopScheduler] Failed to publish loop update for ${loop.id}:`, err);
+        }
+    }
+}
+//# sourceMappingURL=loop-scheduler.js.map

package/dist/loop-scheduler.js.map

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

package/dist/loop-store.d.ts

@@ -0,0 +1,36 @@
+import type { Loop, LoopDraft } from './types.js';
+export declare function listLoops(): Loop[];
+export declare function getLoop(id: string): Loop | undefined;
+/**
+ * Mint a Loop from a client draft: fresh id/timestamps, zeroed counters, and a
+ * nextRunAt computed from now — even when created disabled, so re-enabling has a
+ * target. Throws (via computeNextRun) on a malformed cron expression.
+ */
+export declare function createLoop(draft: LoopDraft): Loop;
+/**
+ * Merge `patch` over an existing loop. id + createdAt are immutable; updatedAt is
+ * bumped. A schedule change recomputes nextRunAt from now (the old target is
+ * stale). Returns null when no loop has that id.
+ */
+export declare function updateLoop(id: string, patch: Partial<LoopDraft>): Loop | null;
+export declare function deleteLoop(id: string): boolean;
+/** Insert a loop, or replace the existing one with the same id, in place. */
+export declare function upsertLoop(loop: Loop): void;
+/** The scheduler-owned runtime fields a tick is allowed to mutate. Everything
+ * else on a Loop (name, schedule, enabled, task, retention, …) is user-owned
+ * and edited exclusively through updateLoop. */
+export type LoopRuntimeMutator = (loop: Loop) => void;
+/**
+ * Atomically apply a scheduler-owned mutation: reload the loop FRESH from disk,
+ * apply `fn`, then save. Returns the merged loop, or null when the id no longer
+ * exists (deleted concurrently) — the caller then skips its publish so a deleted
+ * loop is never resurrected.
+ *
+ * The scheduler holds a detached Loop snapshot across long awaits (a 20s
+ * preflight, an in-process spawn). Writing that whole stale snapshot back would
+ * (a) resurrect a loop deleted mid-flight and (b) clobber a concurrent
+ * update_loop patch to user-owned fields. Because `fn` runs on the
+ * freshly-loaded record and touches only runtime fields, both hazards are gone:
+ * a delete wins (null), and an unrelated enabled/schedule/task patch survives.
+ */
+export declare function mutateLoopRuntime(id: string, fn: LoopRuntimeMutator): Loop | null;