ftown-bridge 0.11.2 → 0.12.0

package/dist/loop-store.js

@@ -0,0 +1,128 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { v4 as uuidv4 } from 'uuid';
+import { computeNextRun } from './loop-schedule.js';
+function loopsPath() {
+    return join(homedir(), '.ftown', 'loops.json');
+}
+/** Tolerant loader: returns { loops: [] } on a missing OR corrupt file. Never throws. */
+function loadLoops() {
+    try {
+        const path = loopsPath();
+        if (!existsSync(path))
+            return { loops: [] };
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return { loops: Array.isArray(parsed.loops) ? parsed.loops : [] };
+    }
+    catch {
+        return { loops: [] };
+    }
+}
+function saveLoops(data) {
+    mkdirSync(join(homedir(), '.ftown'), { recursive: true, mode: 0o700 });
+    const path = loopsPath();
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
+    renameSync(tmp, path); // atomic
+}
+export function listLoops() {
+    return loadLoops().loops;
+}
+export function getLoop(id) {
+    return loadLoops().loops.find((loop) => loop.id === id);
+}
+/**
+ * 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 function createLoop(draft) {
+    const data = loadLoops();
+    const now = new Date();
+    const loop = {
+        ...draft,
+        id: uuidv4(),
+        createdAt: now.toISOString(),
+        updatedAt: now.toISOString(),
+        nextRunAt: new Date(computeNextRun(draft.schedule, now.getTime())).toISOString(),
+        runCount: 0,
+        skipCount: 0,
+    };
+    data.loops.push(loop);
+    saveLoops(data);
+    return 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 function updateLoop(id, patch) {
+    const data = loadLoops();
+    const index = data.loops.findIndex((loop) => loop.id === id);
+    if (index === -1)
+        return null;
+    const existing = data.loops[index];
+    const updated = {
+        ...existing,
+        ...patch,
+        id: existing.id,
+        // A loop is owned by exactly one bridge (the one it is persisted on); its
+        // bridgeId is the RPC routing key. Never let a patch move it — a stray
+        // patch.bridgeId would otherwise desync the record from the routing guard.
+        bridgeId: existing.bridgeId,
+        createdAt: existing.createdAt,
+        updatedAt: new Date().toISOString(),
+    };
+    if (patch.schedule) {
+        updated.nextRunAt = new Date(computeNextRun(updated.schedule, Date.now())).toISOString();
+    }
+    data.loops[index] = updated;
+    saveLoops(data);
+    return updated;
+}
+export function deleteLoop(id) {
+    const data = loadLoops();
+    const remaining = data.loops.filter((loop) => loop.id !== id);
+    if (remaining.length === data.loops.length)
+        return false;
+    data.loops = remaining;
+    saveLoops(data);
+    return true;
+}
+/** Insert a loop, or replace the existing one with the same id, in place. */
+export function upsertLoop(loop) {
+    const data = loadLoops();
+    const index = data.loops.findIndex((existing) => existing.id === loop.id);
+    if (index === -1)
+        data.loops.push(loop);
+    else
+        data.loops[index] = loop;
+    saveLoops(data);
+}
+/**
+ * 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 function mutateLoopRuntime(id, fn) {
+    const data = loadLoops();
+    const index = data.loops.findIndex((loop) => loop.id === id);
+    if (index === -1)
+        return null;
+    const loop = data.loops[index];
+    fn(loop);
+    data.loops[index] = loop;
+    saveLoops(data);
+    return loop;
+}
+//# sourceMappingURL=loop-store.js.map

package/dist/loop-store.js.map

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

package/dist/loop-validation.d.ts

@@ -0,0 +1,14 @@
+import type { LoopDraft, LoopSchedule } from './types.js';
+/**
+ * Loop payload validation, extracted from index.ts so it is unit-testable
+ * without importing the CLI entrypoint (which calls program.parse() on load).
+ * Every validator returns an error string, or null when the input is valid.
+ */
+export declare const LOOP_HARNESSES: ReadonlySet<string>;
+/** Validate a loop schedule (interval floor + cron parseability). */
+export declare function validateSchedule(schedule: LoopSchedule | undefined): string | null;
+export declare function validateRetention(retention: LoopDraft['retention'] | undefined): string | null;
+/** Full-draft validation for create_loop. */
+export declare function validateLoopDraft(draft: Partial<LoopDraft>): string | null;
+/** Partial validation for update_loop — only the fields present in the patch. */
+export declare function validateLoopPatch(patch: Partial<LoopDraft>): string | null;

package/dist/loop-validation.js

@@ -0,0 +1,95 @@
+import { computeNextRun } from './loop-schedule.js';
+/**
+ * Loop payload validation, extracted from index.ts so it is unit-testable
+ * without importing the CLI entrypoint (which calls program.parse() on load).
+ * Every validator returns an error string, or null when the input is valid.
+ */
+export const LOOP_HARNESSES = new Set([
+    'claude',
+    'cursor',
+    'codex',
+    'opencode',
+    'shell',
+]);
+/** Validate a loop schedule (interval floor + cron parseability). */
+export function validateSchedule(schedule) {
+    if (!schedule || typeof schedule !== 'object')
+        return 'schedule is required';
+    if (schedule.kind === 'interval') {
+        if (typeof schedule.everyMs !== 'number' || !Number.isFinite(schedule.everyMs) || schedule.everyMs < 1000) {
+            return 'interval everyMs must be a finite number >= 1000';
+        }
+        return null;
+    }
+    if (schedule.kind === 'cron') {
+        if (typeof schedule.expression !== 'string' || !schedule.expression.trim()) {
+            return 'cron expression is required';
+        }
+        try {
+            computeNextRun(schedule, Date.now());
+        }
+        catch {
+            return `Invalid cron expression: ${schedule.expression}`;
+        }
+        return null;
+    }
+    return 'schedule.kind must be "interval" or "cron"';
+}
+export function validateRetention(retention) {
+    const value = retention?.autoClearAfterRuns;
+    const ok = value === null || (typeof value === 'number' && Number.isFinite(value) && value >= 0);
+    return retention && ok ? null : 'retention.autoClearAfterRuns must be null or a non-negative number';
+}
+/** Full-draft validation for create_loop. */
+export function validateLoopDraft(draft) {
+    if (!draft || typeof draft !== 'object')
+        return 'Invalid loop payload';
+    // Required so a create can never slip past the bridge-routing guard and get
+    // duplicated across every connected bridge (create mints a fresh id).
+    if (typeof draft.bridgeId !== 'string' || !draft.bridgeId.trim())
+        return 'bridgeId is required';
+    if (typeof draft.name !== 'string' || !draft.name.trim())
+        return 'Loop name is required';
+    if (typeof draft.task !== 'string' || !draft.task.trim())
+        return 'Loop task is required';
+    if (typeof draft.harness !== 'string' || !LOOP_HARNESSES.has(draft.harness)) {
+        return `Invalid harness: ${String(draft.harness)}`;
+    }
+    if (draft.overlapPolicy !== 'skip' && draft.overlapPolicy !== 'allow') {
+        return 'overlapPolicy must be "skip" or "allow"';
+    }
+    if (typeof draft.enabled !== 'boolean')
+        return 'enabled must be a boolean';
+    const retentionError = validateRetention(draft.retention);
+    if (retentionError)
+        return retentionError;
+    return validateSchedule(draft.schedule);
+}
+/** Partial validation for update_loop — only the fields present in the patch. */
+export function validateLoopPatch(patch) {
+    if (!patch || typeof patch !== 'object')
+        return 'Invalid patch';
+    if ('name' in patch && (typeof patch.name !== 'string' || !patch.name.trim())) {
+        return 'Loop name must be a non-empty string';
+    }
+    if ('task' in patch && (typeof patch.task !== 'string' || !patch.task.trim())) {
+        return 'Loop task must be a non-empty string';
+    }
+    if ('harness' in patch && (typeof patch.harness !== 'string' || !LOOP_HARNESSES.has(patch.harness))) {
+        return `Invalid harness: ${String(patch.harness)}`;
+    }
+    if ('overlapPolicy' in patch && patch.overlapPolicy !== 'skip' && patch.overlapPolicy !== 'allow') {
+        return 'overlapPolicy must be "skip" or "allow"';
+    }
+    if ('enabled' in patch && typeof patch.enabled !== 'boolean')
+        return 'enabled must be a boolean';
+    if ('retention' in patch) {
+        const retentionError = validateRetention(patch.retention);
+        if (retentionError)
+            return retentionError;
+    }
+    if ('schedule' in patch)
+        return validateSchedule(patch.schedule);
+    return null;
+}
+//# sourceMappingURL=loop-validation.js.map

package/dist/loop-validation.js.map

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

package/dist/types.d.ts

@@ -19,12 +19,72 @@ export interface Session {
     parentSessionId?: string;
     runtime?: SessionRuntime;
     errorReason?: string;
+    loopId?: string;
 }
 export type SessionStatus = 'pending' | 'running' | 'completed' | 'error';
 /** Tombstone written to <dataDir>/archive.jsonl when a session is removed. */
 export interface ArchivedSession extends Session {
     removedAt: string;
 }
+export type LoopHarness = 'claude' | 'cursor' | 'codex' | 'opencode' | 'shell';
+export type LoopRunStatus = 'ok' | 'error' | 'running' | 'skipped';
+export type LoopSchedule = {
+    kind: 'interval';
+    everyMs: number;
+} | {
+    kind: 'cron';
+    expression: string;
+    tz?: string;
+};
+export interface LoopFlight {
+    command: string;
+    timeoutMs?: number;
+}
+export interface LoopPostflight {
+    command: string;
+    timeoutMs?: number;
+    /** Run postflight even when the fire was preflight-skipped. Default false. */
+    runOnSkip?: boolean;
+}
+export interface LoopRetention {
+    /** Keep newest N run-sessions; prune older ones. null = keep all. Default 10. */
+    autoClearAfterRuns: number | null;
+}
+/** Client-authored fields (create/edit form). */
+export interface LoopDraft {
+    name: string;
+    bridgeId: string;
+    schedule: LoopSchedule;
+    harness: LoopHarness;
+    workdir?: string;
+    task: string;
+    model?: string;
+    enabled: boolean;
+    overlapPolicy: 'skip' | 'allow';
+    retention: LoopRetention;
+    preflight?: LoopFlight;
+    postflight?: LoopPostflight;
+    /** Optional deterministic backstop: force-stop + mark 'error' if a flight runs longer. */
+    maxRuntimeMs?: number;
+}
+/** Full server-authoritative record (LoopDraft + runtime state). */
+export interface Loop extends LoopDraft {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    lastRunAt?: string;
+    nextRunAt?: string;
+    lastStatus?: LoopRunStatus;
+    lastSessionId?: string;
+    runCount: number;
+    skipCount: number;
+    /** Transient manual-fire flag; set by run_loop_now, cleared on the next tick. */
+    runNowRequested?: boolean;
+}
+/** A "run" is exactly a Session whose loopId === loop.id. No separate store record. */
+export type LoopRun = Session & {
+    loopId: string;
+};
 /** Inter-agent mail stored in <dataDir>/sessions/<id>/inbox.jsonl. */
 export interface MailMessage {
     id: string;
@@ -52,7 +112,7 @@ export interface Command {
     payload: CommandPayload;
     requestId: string;
 }
-export type CommandType = 'create_session' | 'stop_session' | 'list_sessions' | 'get_history' | 'retry_session' | 'send_message' | 'rename_session' | 'remove_session' | 'bridge_exec' | 'clear_terminal' | 'update_session_parent';
+export type CommandType = 'create_session' | 'stop_session' | 'list_sessions' | 'get_history' | 'retry_session' | 'send_message' | 'rename_session' | 'remove_session' | 'bridge_exec' | 'clear_terminal' | 'update_session_parent' | 'create_loop' | 'list_loops' | 'update_loop' | 'delete_loop' | 'run_loop_now' | 'get_loop_runs';
 export interface CreateSessionPayload {
     command: string;
     prompt?: string;
@@ -101,7 +161,30 @@ export interface RemoveSessionPayload {
 export interface ClearTerminalPayload {
     sessionId: string;
 }
-export type CommandPayload = CreateSessionPayload | StopSessionPayload | GetHistoryPayload | RenameSessionPayload | RemoveSessionPayload | BridgeExecPayload | ClearTerminalPayload | UpdateSessionParentPayload | Record<string, unknown>;
+export interface CreateLoopPayload extends LoopDraft {
+    bridgeId: string;
+}
+export interface ListLoopsPayload {
+    bridgeId?: string;
+}
+export interface UpdateLoopPayload {
+    bridgeId: string;
+    loopId: string;
+    patch: Partial<LoopDraft>;
+}
+export interface DeleteLoopPayload {
+    bridgeId: string;
+    loopId: string;
+}
+export interface RunLoopNowPayload {
+    bridgeId: string;
+    loopId: string;
+}
+export interface GetLoopRunsPayload {
+    bridgeId: string;
+    loopId: string;
+}
+export type CommandPayload = CreateSessionPayload | StopSessionPayload | GetHistoryPayload | RenameSessionPayload | RemoveSessionPayload | BridgeExecPayload | ClearTerminalPayload | UpdateSessionParentPayload | CreateLoopPayload | ListLoopsPayload | UpdateLoopPayload | DeleteLoopPayload | RunLoopNowPayload | GetLoopRunsPayload | Record<string, unknown>;
 export interface CommandResponse {
     requestId: string;
     success: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ftown-bridge",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "description": "CLI bridge for ftown — generic PTY-over-Centrifugo relay",
   "type": "module",
   "main": "dist/index.js",
@@ -48,6 +48,7 @@
     "@xterm/headless": "^6.0.0",
     "centrifuge": "^5.2.2",
     "commander": "^13.1.0",
+    "cron-parser": "^4.9.0",
     "node-pty": "^1.2.0-beta.12",
     "uuid": "^11.1.0",
     "ws": "^8.18.0"