triflux 10.9.13 → 10.9.14

package/hub/lib/spawn-trace.mjs

@@ -9,7 +9,7 @@ const DEDUPE_WINDOW_MS = 5_000;
 const RATE_WINDOW_MS = 1_000;
 export const MAX_SPAWN_PER_SEC = resolvePositiveInteger(
   process.env.TRIFLUX_MAX_SPAWN_RATE,
-  10,
+  30,
 );
 export const MAX_TOTAL_DESCENDANTS = resolvePositiveInteger(
   process.env.TRIFLUX_MAX_DESCENDANTS,

package/hub/server.mjs

@@ -2,6 +2,7 @@
 
 import { execSync as execSyncHub } from "node:child_process";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
+import { EventEmitter } from "node:events";
 import {
   existsSync,
   mkdirSync,
@@ -40,7 +41,10 @@ import {
   writeState,
 } from "./state.mjs";
 import { createStoreAdapter } from "./store-adapter.mjs";
+import { createGitPreflight } from "./team/git-preflight.mjs";
 import { nativeProxy } from "./team/nativeProxy.mjs";
+import { createSwarmLocks } from "./team/swarm-locks.mjs";
+import { createSynapseRegistry } from "./team/synapse-registry.mjs";
 import { registerTeamBridge } from "./team-bridge.mjs";
 import { createTools } from "./tools.mjs";
 import { createDelegatorMcpWorker } from "./workers/delegator-mcp.mjs";
@@ -573,6 +577,22 @@ export async function startHub({
   }
   const delegatorService = new DelegatorService({ worker: delegatorWorker });
 
+  // Synapse Layer 4: session registry + git preflight + swarm locks
+  const synapseEmitter = new EventEmitter();
+  synapseEmitter.setMaxListeners(50);
+  const synapseRegistry = createSynapseRegistry({
+    persistPath: join(CACHE_DIR, "tfx-hub", "synapse-sessions.json"),
+    emitter: synapseEmitter,
+  });
+  const swarmLocks = createSwarmLocks({
+    repoRoot: PROJECT_ROOT,
+    persistPath: join(CACHE_DIR, "tfx-hub", "swarm-locks.json"),
+  });
+  const gitPreflight = createGitPreflight({
+    registry: synapseRegistry,
+    locks: swarmLocks,
+  });
+
   const hitl = createHitlManager(store, router);
   const pipe = createPipeServer({
     router,
@@ -1521,6 +1541,7 @@ export async function startHub({
             await pipe.stop();
             await assignCallbacks.stop();
             await delegatorWorker.stop().catch(() => {});
+            try { synapseRegistry.destroy(); } catch {}
             store.close();
             try {
               unlinkSync(PID_FILE);

package/hub/team/synapse-registry.mjs

@@ -42,6 +42,7 @@ function sanitizeSession(raw, fallbackSessionId = "") {
 export function createSynapseRegistry(opts = {}) {
   const {
     persistPath,
+    emitter = null,
     localHeartbeatIntervalMs = DEFAULT_LOCAL_HEARTBEAT_INTERVAL_MS,
     localTimeoutMs = DEFAULT_LOCAL_TIMEOUT_MS,
     remoteHeartbeatIntervalMs = DEFAULT_REMOTE_HEARTBEAT_INTERVAL_MS,
@@ -67,6 +68,8 @@ export function createSynapseRegistry(opts = {}) {
     return session.isRemote ? remoteTimeoutMs : localTimeoutMs;
   }
 
+  let persistTimer = null;
+
   function persist() {
     if (!persistPath) return;
     try {
@@ -80,6 +83,15 @@ export function createSynapseRegistry(opts = {}) {
     }
   }
 
+  function schedulePersist() {
+    if (persistTimer) return;
+    persistTimer = setTimeout(() => {
+      persistTimer = null;
+      persist();
+    }, 200);
+    if (typeof persistTimer.unref === "function") persistTimer.unref();
+  }
+
   function restore() {
     if (!persistPath || !existsSync(persistPath)) return;
     try {
@@ -101,10 +113,11 @@ export function createSynapseRegistry(opts = {}) {
   }
 
   function notifyStale(session) {
-    // TODO: emit synapse.session.stale via Hub deliveryEmitter
+    const clone = cloneSession(session);
+    emitter?.emit("synapse.session.stale", { sessionId: session.sessionId, session: clone });
     for (const callback of staleCallbacks) {
       try {
-        callback(cloneSession(session));
+        callback(clone);
       } catch {
         /* no-op */
       }
@@ -112,10 +125,11 @@ export function createSynapseRegistry(opts = {}) {
   }
 
   function notifyRemoved(session) {
-    // TODO: emit synapse.session.removed via Hub deliveryEmitter
+    const clone = cloneSession(session);
+    emitter?.emit("synapse.session.removed", { sessionId: session.sessionId, session: clone });
     for (const callback of removedCallbacks) {
       try {
-        callback(cloneSession(session));
+        callback(clone);
       } catch {
         /* no-op */
       }
@@ -134,8 +148,10 @@ export function createSynapseRegistry(opts = {}) {
 
       const elapsedMs = now() - current.lastHeartbeat;
       if (elapsedMs > timeoutFor(current) && current.status !== "stale") {
-        current.status = "stale";
-        notifyStale(current);
+        const staled = { ...current, status: "stale" };
+        sessions.set(sessionId, staled);
+        schedulePersist();
+        setImmediate(() => notifyStale(staled));
       }
     }, intervalFor(session));
 
@@ -150,8 +166,13 @@ export function createSynapseRegistry(opts = {}) {
 
   function register(meta) {
     const sessionId = normalizeSessionId(meta?.sessionId);
-    if (!sessionId || sessions.has(sessionId)) {
-      return { ok: false, sessionId };
+    if (!sessionId) {
+      return { ok: false, sessionId, reason: "invalid_id" };
+    }
+
+    if (sessions.has(sessionId)) {
+      console.warn("[synapse-registry] duplicate registration rejected:", sessionId);
+      return { ok: false, sessionId, reason: "duplicate" };
     }
 
     const session = sanitizeSession(
@@ -168,7 +189,7 @@ export function createSynapseRegistry(opts = {}) {
     startMonitor(sessionId);
     persist();
 
-    // TODO: emit synapse.session.started via Hub deliveryEmitter
+    emitter?.emit("synapse.session.started", { sessionId, session: cloneSession(session) });
     return { ok: true, sessionId };
   }
 
@@ -190,33 +211,35 @@ export function createSynapseRegistry(opts = {}) {
     if (!session) return false;
 
     const wasRemote = session.isRemote;
-
-    session.lastHeartbeat = now();
-    session.status = "active";
+    const updated = { ...session, lastHeartbeat: now(), status: "active" };
 
     if (partialMeta && typeof partialMeta === "object") {
-      if (typeof partialMeta.host === "string") session.host = partialMeta.host;
+      if (typeof partialMeta.host === "string") updated.host = partialMeta.host;
       if (typeof partialMeta.worktreePath === "string") {
-        session.worktreePath = partialMeta.worktreePath;
+        updated.worktreePath = partialMeta.worktreePath;
       }
-      if (typeof partialMeta.branch === "string") session.branch = partialMeta.branch;
+      if (typeof partialMeta.branch === "string") updated.branch = partialMeta.branch;
       if (Array.isArray(partialMeta.dirtyFiles)) {
-        session.dirtyFiles = [...partialMeta.dirtyFiles];
+        updated.dirtyFiles = partialMeta.dirtyFiles.filter(
+          (f) => typeof f === "string" && f.length > 0,
+        );
       }
       if (typeof partialMeta.taskSummary === "string") {
-        session.taskSummary = partialMeta.taskSummary;
+        updated.taskSummary = partialMeta.taskSummary;
       }
       if (typeof partialMeta.isRemote === "boolean") {
-        session.isRemote = partialMeta.isRemote;
+        updated.isRemote = partialMeta.isRemote;
       }
     }
 
-    if (session.isRemote !== wasRemote) {
+    sessions.set(normalized, updated);
+
+    if (updated.isRemote !== wasRemote) {
       startMonitor(normalized);
     }
 
-    persist();
-    // TODO: emit synapse.session.heartbeat via Hub deliveryEmitter
+    schedulePersist();
+    emitter?.emit("synapse.session.heartbeat", { sessionId: normalized, session: cloneSession(updated), partial: partialMeta });
     return true;
   }
 
@@ -257,6 +280,10 @@ export function createSynapseRegistry(opts = {}) {
     for (const sessionId of monitors.keys()) {
       stopMonitor(sessionId);
     }
+    if (persistTimer) {
+      clearTimeout(persistTimer);
+      persistTimer = null;
+    }
     persist();
   }
 
@@ -272,4 +299,4 @@ export function createSynapseRegistry(opts = {}) {
     snapshot,
     destroy,
   });
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.9.13",
+  "version": "10.9.14",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {