opencode-swarm 7.23.0 → 7.24.0

package/dist/cli/index.js

@@ -34,7 +34,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.23.0",
+    version: "7.24.0",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -34292,6 +34292,14 @@ function gitExec(args) {
   }
   return result.stdout;
 }
+function appendRetentionEvent(directory, event) {
+  try {
+    const eventsPath = path9.join(directory, ".swarm", "events.jsonl");
+    const line = `${JSON.stringify({ ...event, timestamp: new Date().toISOString() })}
+`;
+    fs6.appendFileSync(eventsPath, line);
+  } catch {}
+}
 function getCurrentSha() {
   const output = gitExec(["rev-parse", "HEAD"]);
   return output.trim();
@@ -34343,6 +34351,17 @@ function handleSave(label, directory) {
       sha: newSha,
       timestamp
     });
+    if (log2.checkpoints.length > maxCheckpoints) {
+      const evicted = log2.checkpoints.splice(0, log2.checkpoints.length - maxCheckpoints);
+      try {
+        appendRetentionEvent(directory, {
+          event: "checkpoint_retention_applied",
+          evicted_labels: evicted.map((e) => e.label),
+          evicted_count: evicted.length,
+          remaining_count: log2.checkpoints.length
+        });
+      } catch {}
+    }
     writeCheckpointLog(log2, directory);
     return JSON.stringify({
       action: "save",
@@ -43447,7 +43466,7 @@ var init_handoff_service = __esm(() => {
 });
 
 // src/session/snapshot-writer.ts
-import { mkdirSync as mkdirSync10, renameSync as renameSync6 } from "fs";
+import { closeSync as closeSync3, fsyncSync as fsyncSync2, mkdirSync as mkdirSync10, openSync as openSync3, renameSync as renameSync6 } from "fs";
 import * as path27 from "path";
 function serializeAgentSession(s) {
   const gateLog = {};
@@ -43464,6 +43483,12 @@ function serializeAgentSession(s) {
   const catastrophicPhaseWarnings = Array.from(s.catastrophicPhaseWarnings ?? new Set);
   const phaseAgentsDispatched = Array.from(s.phaseAgentsDispatched ?? new Set);
   const lastCompletedPhaseAgentsDispatched = Array.from(s.lastCompletedPhaseAgentsDispatched ?? new Set);
+  const stageBCompletion = {};
+  if (s.stageBCompletion) {
+    for (const [taskId, agents] of s.stageBCompletion) {
+      stageBCompletion[taskId] = Array.from(agents);
+    }
+  }
   const windows = {};
   const rawWindows = s.windows ?? {};
   for (const [key, win] of Object.entries(rawWindows)) {
@@ -43520,7 +43545,8 @@ function serializeAgentSession(s) {
     fullAutoInteractionCount: s.fullAutoInteractionCount ?? 0,
     fullAutoDeadlockCount: s.fullAutoDeadlockCount ?? 0,
     fullAutoLastQuestionHash: s.fullAutoLastQuestionHash ?? null,
-    sessionRehydratedAt: s.sessionRehydratedAt ?? 0
+    sessionRehydratedAt: s.sessionRehydratedAt ?? 0,
+    ...Object.keys(stageBCompletion).length > 0 && { stageBCompletion }
   };
 }
 async function writeSnapshot(directory, state) {
@@ -43542,6 +43568,14 @@ async function writeSnapshot(directory, state) {
     mkdirSync10(dir, { recursive: true });
     const tempPath = `${resolvedPath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2)}`;
     await bunWrite(tempPath, content);
+    try {
+      const fd = openSync3(tempPath, "r+");
+      try {
+        fsyncSync2(fd);
+      } finally {
+        closeSync3(fd);
+      }
+    } catch {}
     renameSync6(tempPath, resolvedPath);
   } catch (error93) {
     log("[snapshot-writer] write failed", {

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.23.0",
+    version: "7.24.0",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -41417,6 +41417,14 @@ function gitExec(args2) {
   }
   return result.stdout;
 }
+function appendRetentionEvent(directory, event) {
+  try {
+    const eventsPath = path14.join(directory, ".swarm", "events.jsonl");
+    const line = `${JSON.stringify({ ...event, timestamp: new Date().toISOString() })}
+`;
+    fs11.appendFileSync(eventsPath, line);
+  } catch {}
+}
 function getCurrentSha() {
   const output = gitExec(["rev-parse", "HEAD"]);
   return output.trim();
@@ -41468,6 +41476,17 @@ function handleSave(label, directory) {
       sha: newSha,
       timestamp
     });
+    if (log2.checkpoints.length > maxCheckpoints) {
+      const evicted = log2.checkpoints.splice(0, log2.checkpoints.length - maxCheckpoints);
+      try {
+        appendRetentionEvent(directory, {
+          event: "checkpoint_retention_applied",
+          evicted_labels: evicted.map((e) => e.label),
+          evicted_count: evicted.length,
+          remaining_count: log2.checkpoints.length
+        });
+      } catch {}
+    }
     writeCheckpointLog(log2, directory);
     return JSON.stringify({
       action: "save",
@@ -52386,7 +52405,7 @@ var init_handoff_service = __esm(() => {
 });
 
 // src/session/snapshot-writer.ts
-import { mkdirSync as mkdirSync13, renameSync as renameSync9 } from "node:fs";
+import { closeSync as closeSync3, fsyncSync as fsyncSync2, mkdirSync as mkdirSync13, openSync as openSync3, renameSync as renameSync9 } from "node:fs";
 import * as path33 from "node:path";
 function serializeAgentSession(s) {
   const gateLog = {};
@@ -52403,6 +52422,12 @@ function serializeAgentSession(s) {
   const catastrophicPhaseWarnings = Array.from(s.catastrophicPhaseWarnings ?? new Set);
   const phaseAgentsDispatched = Array.from(s.phaseAgentsDispatched ?? new Set);
   const lastCompletedPhaseAgentsDispatched = Array.from(s.lastCompletedPhaseAgentsDispatched ?? new Set);
+  const stageBCompletion = {};
+  if (s.stageBCompletion) {
+    for (const [taskId, agents] of s.stageBCompletion) {
+      stageBCompletion[taskId] = Array.from(agents);
+    }
+  }
   const windows = {};
   const rawWindows = s.windows ?? {};
   for (const [key, win] of Object.entries(rawWindows)) {
@@ -52459,7 +52484,8 @@ function serializeAgentSession(s) {
     fullAutoInteractionCount: s.fullAutoInteractionCount ?? 0,
     fullAutoDeadlockCount: s.fullAutoDeadlockCount ?? 0,
     fullAutoLastQuestionHash: s.fullAutoLastQuestionHash ?? null,
-    sessionRehydratedAt: s.sessionRehydratedAt ?? 0
+    sessionRehydratedAt: s.sessionRehydratedAt ?? 0,
+    ...Object.keys(stageBCompletion).length > 0 && { stageBCompletion }
   };
 }
 async function writeSnapshot(directory, state) {
@@ -52481,6 +52507,14 @@ async function writeSnapshot(directory, state) {
     mkdirSync13(dir, { recursive: true });
     const tempPath = `${resolvedPath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2)}`;
     await bunWrite(tempPath, content);
+    try {
+      const fd = openSync3(tempPath, "r+");
+      try {
+        fsyncSync2(fd);
+      } finally {
+        closeSync3(fd);
+      }
+    } catch {}
     renameSync9(tempPath, resolvedPath);
   } catch (error93) {
     log("[snapshot-writer] write failed", {
@@ -62618,7 +62652,17 @@ If the user answered the gate question, immediately follow up with ONE more ques
 - locked: true
 - recorded_at: <ISO timestamp>
 \`\`\`
-If the user accepts the default (1), skip writing this section entirely — serial execution is the default and needs no config.`;
+If the user accepts the default (1), skip writing this section entirely — serial execution is the default and needs no config.
+
+After asking the parallelization question (regardless of whether the user chose serial or parallel), immediately follow up with ONE more question: "Commit frequency for completed tasks? (default: phase-level only; optional per-task checkpoint commit after each task completion)".
+
+If the user chooses per-task commits, write this section to \`.swarm/context.md\`:
+\`\`\`
+## Task Completion Commit Policy
+- commit_after_each_completed_task: true
+- recorded_at: <ISO timestamp>
+\`\`\`
+If the user keeps the default phase-level behavior, do not write this section.`;
 }
 function buildAvailableToolsList(council) {
   const tools = AGENT_TOOL_MAP.architect ?? [];
@@ -64107,7 +64151,10 @@ save_plan({
 After \`save_plan\` succeeds, read \`.swarm/context.md\`:
 - If a \`## Pending QA Gate Selection\` section exists: parse the gate values, call \`set_qa_gates\` with those flags, confirm with the user ("QA gates applied: <list>"), then remove the section from context.md.
 - If a \`## Pending Parallelization Config\` section also exists: parse the values and call \`save_plan\` again with \`execution_profile\` set to \`{ parallelization_enabled: <parsed>, max_concurrent_tasks: <parsed>, council_parallel: false, locked: true }\`. Then remove the section from context.md. If the plan already had \`execution_profile.locked: true\`, skip this step — the profile is already locked and immutable.
+- If a \`## Task Completion Commit Policy\` section exists: preserve it in \`.swarm/context.md\` (do NOT remove). This section is execution-time guidance for optional per-task checkpoint commits after \`update_task_status(status="completed")\`.
 - If no pending section exists: {{QA_GATE_DIALOGUE_PLAN}}
+- If a \`## Task Completion Commit Policy\` section already exists in context.md, honor it as execution-time guidance (do NOT remove).
+- If no \`## Task Completion Commit Policy\` section exists AND the \`{{QA_GATE_DIALOGUE_PLAN}}\` template was not rendered (pending sections were pre-written), ask the commit-frequency question now. Write the section to context.md if the user chooses per-task commits; skip if they keep the default phase-level behavior.
 <!-- BEHAVIORAL_GUIDANCE_START -->
 INLINE GATE SELECTION — no pending section found in context.md. You MUST ask now.
   ✗ "I'll call set_qa_gates with defaults and move on"
@@ -64392,7 +64439,14 @@ This step supplements (not replaces) the existing regression-sweep and test-drif
   Any blank "value: ___" field = gate was not run = task is NOT complete.
   Filling this checklist from memory ("I think I ran it") is INVALID. Each value must come from actual tool/agent output in this session.
 
-    5o. Call update_task_status with status "completed", proceed to next task.
+    5p. Call update_task_status with status "completed".
+    5q. OPTIONAL TASK-COMPLETION COMMIT POLICY: read \`.swarm/context.md\`.
+        - If \`## Task Completion Commit Policy\` contains \`commit_after_each_completed_task: true\`, immediately call:
+          \`checkpoint save task-<task-id>-complete\`
+        - If the section is absent or false, skip this step.
+        - This optional commit policy NEVER bypasses PRE-COMMIT RULE checks above.
+        - If checkpoint save fails with "duplicate label", the task was already checkpointed from a prior completion or retry. Silently skip — the existing checkpoint is valid.
+    5r. Proceed to next task.
 
 ## ⛔ RETROSPECTIVE GATE
 
@@ -83611,8 +83665,8 @@ ${formattedIndex}
         } else {
           if (existingContent.length > 0 && !existingContent.endsWith(`
 `)) {
-            updatedContent = existingContent + `
-` + newSection;
+            updatedContent = `${existingContent}
+${newSection}`;
           } else {
             updatedContent = existingContent + newSection;
           }
@@ -85196,6 +85250,12 @@ function deserializeAgentSession(s) {
   const catastrophicPhaseWarnings = new Set(s.catastrophicPhaseWarnings ?? []);
   const phaseAgentsDispatched = new Set(s.phaseAgentsDispatched ?? []);
   const lastCompletedPhaseAgentsDispatched = new Set(s.lastCompletedPhaseAgentsDispatched ?? []);
+  const stageBCompletion = new Map;
+  if (s.stageBCompletion) {
+    for (const [taskId, agents] of Object.entries(s.stageBCompletion)) {
+      stageBCompletion.set(taskId, new Set(agents));
+    }
+  }
   const windows = {};
   for (const [key, win] of Object.entries(s.windows ?? {})) {
     windows[key] = {
@@ -85250,7 +85310,8 @@ function deserializeAgentSession(s) {
     prmLastPatternDetected: null,
     prmTrajectoryStep: 0,
     prmHardStopPending: false,
-    sessionRehydratedAt: s.sessionRehydratedAt ?? 0
+    sessionRehydratedAt: s.sessionRehydratedAt ?? 0,
+    stageBCompletion
   };
 }
 async function readSnapshot(directory) {
@@ -87087,7 +87148,7 @@ ${body2}`);
 
 // src/council/council-evidence-writer.ts
 import {
-  appendFileSync as appendFileSync11,
+  appendFileSync as appendFileSync12,
   existsSync as existsSync53,
   mkdirSync as mkdirSync24,
   readFileSync as readFileSync44,
@@ -87171,7 +87232,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
       timestamp: synthesis.timestamp,
       vetoedBy: synthesis.vetoedBy
     });
-    appendFileSync11(join83(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
+    appendFileSync12(join83(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
 `);
   } catch (auditError) {
     console.warn(`writeCouncilEvidence: failed to append round-history audit log: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
@@ -103946,7 +104007,27 @@ function checkReviewerGate(taskId, workingDirectory, stageBParallelEnabled = fal
       }
     }
     const currentStateStr = stateEntries.length > 0 ? stateEntries.join(", ") : "no active sessions";
-    const finalReason = evidenceIncompleteReason ?? `Task ${taskId} has not passed QA gates. Current state by session: [${currentStateStr}]. Missing required state: tests_run or complete in at least one valid session. Do not write directly to plan files — use update_task_status after running the reviewer and test_engineer agents.`;
+    const chainEntries = [];
+    for (const [sessionId, chain] of swarmState.delegationChains) {
+      const session = swarmState.agentSessions.get(sessionId);
+      if (session && (session.currentTaskId === taskId || session.lastCoderDelegationTaskId === taskId)) {
+        const targets = chain.map((d) => stripKnownSwarmPrefix(d.to));
+        chainEntries.push(`${sessionId}: [${targets.join(", ")}]`);
+      }
+    }
+    const chainSummary = chainEntries.length > 0 ? chainEntries.join("; ") : "no chains for this task";
+    const rehydratedSessionCount = [
+      ...swarmState.agentSessions.values()
+    ].filter((s) => s.sessionRehydratedAt > 0).length;
+    const finalReason = [
+      `Task ${taskId} has not passed QA gates.`,
+      `  Session states: [${currentStateStr}].`,
+      `  Delegation chains: [${chainSummary}].`,
+      `  Evidence: [${evidenceIncompleteReason ?? "no evidence file found"}].`,
+      `  Rehydrated sessions: ${rehydratedSessionCount}.`,
+      `  Missing required state: tests_run or complete.`
+    ].join(`
+`);
     telemetry.gateFailed("", "qa_gate", taskId, evidenceIncompleteReason ? `Missing gates: evidence incomplete` : `Missing state: tests_run or complete`);
     return {
       blocked: true,
@@ -103968,7 +104049,7 @@ async function checkReviewerGateWithScope(taskId, workingDirectory, sessionID) {
 ${scopeWarning}` : scopeWarning
   };
 }
-function recoverTaskStateFromDelegations(taskId) {
+function recoverTaskStateFromDelegations(taskId, directory) {
   let hasReviewer = false;
   let hasTestEngineer = false;
   for (const [sessionId, chain] of swarmState.delegationChains) {
@@ -103983,8 +104064,24 @@ function recoverTaskStateFromDelegations(taskId) {
       }
     }
   }
+  if ((!hasReviewer || !hasTestEngineer) && directory) {
+    try {
+      const evidence = readTaskEvidenceRaw(directory, taskId);
+      if (evidence && evidence.gates && Array.isArray(evidence.required_gates)) {
+        if (evidence.gates.reviewer != null)
+          hasReviewer = true;
+        if (evidence.gates.test_engineer != null)
+          hasTestEngineer = true;
+      }
+    } catch {}
+  }
   if (!hasReviewer && !hasTestEngineer)
     return;
+  if (swarmState.agentSessions.size === 0) {
+    try {
+      startAgentSession("recovery-session", "architect");
+    } catch {}
+  }
   for (const [, session] of swarmState.agentSessions) {
     if (!(session.taskWorkflowStates instanceof Map))
       continue;
@@ -104128,7 +104225,7 @@ async function executeUpdateTaskStatus(args2, fallbackDir, ctx) {
     } catch {}
   }
   if (args2.status === "completed") {
-    recoverTaskStateFromDelegations(args2.task_id);
+    recoverTaskStateFromDelegations(args2.task_id, directory);
     let phaseRequiresReviewer = true;
     try {
       const planPath = path137.join(directory, ".swarm", "plan.json");

package/dist/session/snapshot-writer.d.ts

@@ -59,6 +59,8 @@ export interface SerializedAgentSession {
     fullAutoLastQuestionHash?: string | null;
     /** Timestamp when session was rehydrated from snapshot (0 if never rehydrated) */
     sessionRehydratedAt?: number;
+    /** Stage B completion tracking: per-task set of completed Stage B agents. Optional for backward compat with old snapshots. */
+    stageBCompletion?: Record<string, string[]>;
 }
 /**
  * Minimal interface for serialized InvocationWindow

package/dist/tools/update-task-status.d.ts

@@ -71,9 +71,14 @@ export declare function checkReviewerGateWithScope(taskId: string, workingDirect
  * missing), this function advances the task state so that checkReviewerGate can
  * make an accurate decision without attributing unrelated delegation activity.
  *
+ * Falls back to reading durable evidence files when delegation chains are empty
+ * (e.g., after a crash or session restart without snapshot). This ensures
+ * recovery works even when no in-memory delegation history exists.
+ *
  * @param taskId - The task ID to recover state for
+ * @param directory - Optional project directory for evidence file fallback
  */
-export declare function recoverTaskStateFromDelegations(taskId: string): void;
+export declare function recoverTaskStateFromDelegations(taskId: string, directory?: string): void;
 /**
  * Result of the council-gate check used when transitioning to 'completed'.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.23.0",
+	"version": "7.24.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",