opencode-swarm 7.98.1 → 7.98.2

package/dist/cli/{evidence-summary-service-g4x5e3e3.js → evidence-summary-service-559nas1m.js}

@@ -6,10 +6,10 @@ import {
   loadPlanJsonOnly,
   mergeDurableGateEntriesFromEvidence,
   readDurableGateEvidence
-} from "./index-4c5jpmn9.js";
+} from "./index-yrzfbqqh.js";
 import"./index-mh1ej70w.js";
 import"./index-kv4dd5c5.js";
-import"./index-gn8n22th.js";
+import"./index-we94wkty.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{guardrail-explain-cm08h4mt.js → guardrail-explain-xktjjh53.js}

@@ -1,21 +1,21 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-0rgde8qc.js";
-import"./index-zgba613y.js";
+} from "./index-rvweaxsd.js";
+import"./index-72k57f21.js";
 import"./index-5z2e78tv.js";
 import"./index-2a6ppa65.js";
 import"./index-fjxjb66n.js";
 import"./index-hb10a2g8.js";
 import"./index-zy22fg5h.js";
 import"./index-471qxz9g.js";
-import"./index-4c5jpmn9.js";
+import"./index-yrzfbqqh.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";
 import"./index-mh1ej70w.js";
 import"./index-kv4dd5c5.js";
-import"./index-sf08zj91.js";
-import"./index-gn8n22th.js";
+import"./index-a0dv2c7k.js";
+import"./index-we94wkty.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{index-zgba613y.js → index-72k57f21.js}

@@ -114,7 +114,7 @@ import {
   transientBackoff,
   validateProjectRoot,
   writeProjectedSpecSync
-} from "./index-4c5jpmn9.js";
+} from "./index-yrzfbqqh.js";
 import {
   _internals as _internals2,
   _internals1 as _internals3,
@@ -138,12 +138,12 @@ import {
   listActive,
   subscribe,
   unsubscribe
-} from "./index-sf08zj91.js";
+} from "./index-a0dv2c7k.js";
 import {
   readSwarmFileAsync,
   safeHook,
   validateSwarmPath
-} from "./index-gn8n22th.js";
+} from "./index-we94wkty.js";
 import {
   deepMerge
 } from "./index-p0arc26j.js";
@@ -909,7 +909,7 @@ var init_executor = __esm(() => {
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.98.1",
+  version: "7.98.2",
   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",
@@ -5474,6 +5474,9 @@ function startAgentSession(sessionId, agentName, staleDurationMs = 7200000, dire
     swarmState.pendingRehydrations.add(rehydrationPromise);
   }
 }
+function endAgentSession(sessionId) {
+  swarmState.agentSessions.delete(sessionId);
+}
 function getAgentSession(sessionId) {
   return swarmState.agentSessions.get(sessionId);
 }
@@ -5978,7 +5981,7 @@ function hasActiveEpicMode(sessionID) {
 async function rehydratePrSubscriptions(sessionID, directory) {
   const map = new Map;
   try {
-    const { listActive: listActive2 } = await import("./pr-subscriptions-2565fpsc.js");
+    const { listActive: listActive2 } = await import("./pr-subscriptions-ttvr1ta9.js");
     const records = await listActive2(directory);
     for (const record of records) {
       if (record.sessionID !== sessionID)
@@ -13652,6 +13655,10 @@ This project was already finalized in a previous /swarm close run. The plan has
       ctx.warnings.push(`Failed to write close-summary.md: ${msg}`);
       console.warn("[close-command] Failed to write close-summary.md:", error2);
     }
+    const sessionIdsToEnd = [...swarmState.agentSessions.keys()];
+    for (const sessionId of sessionIdsToEnd) {
+      _internals20.endAgentSession(sessionId);
+    }
     _internals20.resetSwarmStatePreservingSingletons();
     const retroWarnings = ctx.warnings.filter((w) => w.includes("Retrospective write") || w.includes("retrospective write") || w.includes("Session retrospective"));
     const otherWarnings = ctx.warnings.filter((w) => !w.includes("Retrospective write") && !w.includes("retrospective write") && !w.includes("Session retrospective"));
@@ -13744,7 +13751,8 @@ var _internals20 = {
   runCleanStage,
   runAlignStage,
   archiveEvidence,
-  closePlanTerminalState
+  closePlanTerminalState,
+  endAgentSession
 };
 
 // src/commands/codebase-review.ts
@@ -17605,7 +17613,7 @@ async function handleEvidenceCommand(directory, args) {
   return formatTaskEvidenceMarkdown(evidenceData);
 }
 async function handleEvidenceSummaryCommand(directory) {
-  const { buildEvidenceSummary } = await import("./evidence-summary-service-g4x5e3e3.js");
+  const { buildEvidenceSummary } = await import("./evidence-summary-service-559nas1m.js");
   const artifact = await buildEvidenceSummary(directory);
   if (!artifact) {
     return "No plan found. Run `/swarm plan` to check plan status.";
@@ -31856,7 +31864,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-attgb1ma.js");
+    const { buildHelpText } = await import("./index-chan9mkv.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -31865,7 +31873,7 @@ async function handleHelpCommand(ctx) {
     return _internals45.buildDetailedHelp(resolved.key, resolved.entry);
   }
   const similar = _internals45.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-attgb1ma.js");
+  const { buildHelpText: fullHelp } = await import("./index-chan9mkv.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -31998,7 +32006,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-cm08h4mt.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-xktjjh53.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",

package/dist/cli/{index-sf08zj91.js → index-a0dv2c7k.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   validateSwarmPath
-} from "./index-gn8n22th.js";
+} from "./index-we94wkty.js";
 import {
   log
 } from "./index-zgwm4ryv.js";

package/dist/cli/{index-attgb1ma.js → index-chan9mkv.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-0rgde8qc.js";
+} from "./index-rvweaxsd.js";
 import {
   handleGuardrailLog
 } from "./index-gnd1280x.js";
@@ -78,7 +78,7 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-zgba613y.js";
+} from "./index-72k57f21.js";
 import"./index-5z2e78tv.js";
 import"./index-2a6ppa65.js";
 import"./index-fjxjb66n.js";
@@ -89,13 +89,13 @@ import {
   ORCHESTRATOR_NAME,
   stripKnownSwarmPrefix
 } from "./index-471qxz9g.js";
-import"./index-4c5jpmn9.js";
+import"./index-yrzfbqqh.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";
 import"./index-mh1ej70w.js";
 import"./index-kv4dd5c5.js";
-import"./index-sf08zj91.js";
-import"./index-gn8n22th.js";
+import"./index-a0dv2c7k.js";
+import"./index-we94wkty.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{index-0rgde8qc.js → index-rvweaxsd.js}

@@ -12,7 +12,7 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-zgba613y.js";
+} from "./index-72k57f21.js";
 import {
   checkFileAuthority,
   classifyFile,

package/dist/cli/{index-gn8n22th.js → index-we94wkty.js}

@@ -14,7 +14,13 @@ import {
 
 // src/hooks/utils.ts
 import * as path from "path";
-var _internals = { safeHook, composeHandlers, validateSwarmPath, readSwarmFileAsync };
+var _internals = {
+  safeHook,
+  composeHandlers,
+  validateSwarmPath,
+  readSwarmFileAsync,
+  readCachedTextFile
+};
 function safeHook(fn) {
   return async (input, output) => {
     try {
@@ -67,13 +73,23 @@ function validateSwarmPath(directory, filename) {
   }
   return resolved;
 }
-async function readSwarmFileAsync(directory, filename) {
+async function readSwarmFileAsync(directory, filename, cache) {
+  if (cache !== undefined) {
+    const key = `${directory}::${filename}`;
+    const cached = cache.get(key);
+    if (cached !== undefined) {
+      return cached;
+    }
+    const promise = readSwarmFileAsync(directory, filename);
+    cache.set(key, promise);
+    return promise;
+  }
   const maxAttempts = 5;
   const retryDelayMs = 10;
   for (let attempt = 0;attempt < maxAttempts; attempt++) {
     try {
       const resolvedPath = _internals.validateSwarmPath(directory, filename);
-      return await readCachedTextFile(resolvedPath, async () => {
+      return await _internals.readCachedTextFile(resolvedPath, async () => {
         const file = bunFile(resolvedPath);
         return await file.text();
       });

package/dist/cli/{index-4c5jpmn9.js → index-yrzfbqqh.js}

@@ -8,7 +8,7 @@ import {
 import {
   readSwarmFileAsync,
   validateSwarmPath
-} from "./index-gn8n22th.js";
+} from "./index-we94wkty.js";
 import {
   readCachedParsedFile
 } from "./index-jtqkh8jf.js";
@@ -2162,8 +2162,8 @@ function extractPlanHashFromMarkdown(markdown) {
   const match = markdown.match(/<!--\s*PLAN_HASH:\s*(\S+)\s*-->/);
   return match ? match[1] : null;
 }
-async function isPlanMdInSync(directory, plan) {
-  const planMdContent = await readSwarmFileAsync(directory, "plan.md");
+async function isPlanMdInSync(directory, plan, cache) {
+  const planMdContent = await readSwarmFileAsync(directory, "plan.md", cache);
   if (planMdContent === null) {
     return false;
   }
@@ -2197,8 +2197,8 @@ ${markdown}`;
     } catch {}
   }
 }
-async function loadPlan(directory) {
-  const planJsonContent = await readSwarmFileAsync(directory, "plan.json");
+async function loadPlan(directory, cache) {
+  const planJsonContent = await readSwarmFileAsync(directory, "plan.json", cache);
   if (planJsonContent !== null) {
     if (planJsonContent.includes("\x00") || planJsonContent.includes("\uFFFD")) {
       warn("Plan rejected: .swarm/plan.json contains null bytes or invalid encoding");
@@ -2208,7 +2208,7 @@ async function loadPlan(directory) {
         if (validated === null) {
           warn("[loadPlan] plan.json disappeared during cached parse. Falling back to plan.md migration or ledger recovery.");
         } else {
-          const inSync = await isPlanMdInSync(directory, validated);
+          const inSync = await isPlanMdInSync(directory, validated, cache);
           if (!inSync) {
             try {
               await _internals4.regeneratePlanMarkdown(directory, validated);
@@ -2331,7 +2331,7 @@ async function loadPlan(directory) {
             }
           }
         }
-        const planMdContent2 = await readSwarmFileAsync(directory, "plan.md");
+        const planMdContent2 = await readSwarmFileAsync(directory, "plan.md", cache);
         if (planMdContent2 !== null) {
           const migrated = migrateLegacyPlan(planMdContent2);
           const { removedCount } = await savePlanWithAutoAcknowledgedRemovals(directory, migrated, "load_plan_migration_from_md", "migrate legacy plan.md to plan.json");
@@ -2346,7 +2346,7 @@ async function loadPlan(directory) {
       }
     }
   }
-  const planMdContent = await readSwarmFileAsync(directory, "plan.md");
+  const planMdContent = await readSwarmFileAsync(directory, "plan.md", cache);
   if (planMdContent !== null) {
     const migrated = migrateLegacyPlan(planMdContent);
     await savePlan(directory, migrated);

package/dist/cli/index.js

@@ -7,7 +7,7 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-zgba613y.js";
+} from "./index-72k57f21.js";
 import"./index-5z2e78tv.js";
 import"./index-2a6ppa65.js";
 import"./index-fjxjb66n.js";
@@ -16,13 +16,13 @@ import"./index-zy22fg5h.js";
 import {
   DEFAULT_AGENT_CONFIGS
 } from "./index-471qxz9g.js";
-import"./index-4c5jpmn9.js";
+import"./index-yrzfbqqh.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";
 import"./index-mh1ej70w.js";
 import"./index-kv4dd5c5.js";
-import"./index-sf08zj91.js";
-import"./index-gn8n22th.js";
+import"./index-a0dv2c7k.js";
+import"./index-we94wkty.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{pending-delegations-shqbvfjc.js → pending-delegations-8b2js1vq.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   validateSwarmPath
-} from "./index-gn8n22th.js";
+} from "./index-we94wkty.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{pr-subscriptions-2565fpsc.js → pr-subscriptions-ttvr1ta9.js}

@@ -9,8 +9,8 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-sf08zj91.js";
-import"./index-gn8n22th.js";
+} from "./index-a0dv2c7k.js";
+import"./index-we94wkty.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/commands/close.d.ts

@@ -8,7 +8,7 @@ import { checkHivePromotions } from '../hooks/hive-promoter';
 import { curateAndStoreSwarm } from '../hooks/knowledge-curator';
 import { closePlanTerminalState } from '../plan/manager';
 import { type SessionReflectionResult } from '../services/session-reflection';
-import { resetSwarmStatePreservingSingletons } from '../state';
+import { endAgentSession, resetSwarmStatePreservingSingletons } from '../state';
 interface PlanPhase {
     id: number;
     name: string;
@@ -197,5 +197,6 @@ export declare const _internals: {
     runAlignStage: typeof runAlignStage;
     archiveEvidence: typeof archiveEvidence;
     closePlanTerminalState: typeof closePlanTerminalState;
+    endAgentSession: typeof endAgentSession;
 };
 export {};

package/dist/hooks/system-enhancer.d.ts

@@ -46,4 +46,4 @@ export type ArchitectMode = 'DISCOVER' | 'PLAN' | 'EXECUTE' | 'PHASE-WRAP' | 'UN
  * @param directory - The project directory to check
  * @returns The current architect mode based on plan state
  */
-export declare function detectArchitectMode(directory: string): Promise<ArchitectMode>;
+export declare function detectArchitectMode(directory: string, cache?: Map<string, Promise<string | null>>): Promise<ArchitectMode>;

package/dist/hooks/utils.d.ts

@@ -5,6 +5,7 @@
  * including error handling, handler composition, file I/O, and
  * token estimation for swarm-related operations.
  */
+import { readCachedTextFile } from '../utils/swarm-artifact-cache';
 /**
  * Test-only dependency-injection seam. Production code calls
  * `_internals.<fn>(...)` so tests can replace the function on this object
@@ -18,6 +19,7 @@ export declare const _internals: {
     composeHandlers: typeof composeHandlers;
     validateSwarmPath: typeof validateSwarmPath;
     readSwarmFileAsync: typeof readSwarmFileAsync;
+    readCachedTextFile: typeof readCachedTextFile;
 };
 export declare function safeHook<I, O>(fn: (input: I, output: O) => Promise<void>): (input: I, output: O) => Promise<void>;
 /**
@@ -70,5 +72,5 @@ export declare function composeBlockingHandlers<I, O>(...fns: Array<(input: I, o
  * @throws Error if the filename is invalid or attempts path traversal
  */
 export declare function validateSwarmPath(directory: string, filename: string): string;
-export declare function readSwarmFileAsync(directory: string, filename: string): Promise<string | null>;
+export declare function readSwarmFileAsync(directory: string, filename: string, cache?: Map<string, Promise<string | null>>): Promise<string | null>;
 export declare function estimateTokens(text: string): number;

package/dist/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.98.1",
+    version: "7.98.2",
     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",
@@ -18167,13 +18167,23 @@ function validateSwarmPath(directory, filename) {
   }
   return resolved;
 }
-async function readSwarmFileAsync(directory, filename) {
+async function readSwarmFileAsync(directory, filename, cache) {
+  if (cache !== undefined) {
+    const key = `${directory}::${filename}`;
+    const cached2 = cache.get(key);
+    if (cached2 !== undefined) {
+      return cached2;
+    }
+    const promise2 = readSwarmFileAsync(directory, filename);
+    cache.set(key, promise2);
+    return promise2;
+  }
   const maxAttempts = 5;
   const retryDelayMs = 10;
   for (let attempt = 0;attempt < maxAttempts; attempt++) {
     try {
       const resolvedPath = _internals3.validateSwarmPath(directory, filename);
-      return await readCachedTextFile(resolvedPath, async () => {
+      return await _internals3.readCachedTextFile(resolvedPath, async () => {
         const file2 = bunFile(resolvedPath);
         return await file2.text();
       });
@@ -18198,7 +18208,13 @@ var init_utils2 = __esm(() => {
   init_utils();
   init_bun_compat();
   init_swarm_artifact_cache();
-  _internals3 = { safeHook, composeHandlers, validateSwarmPath, readSwarmFileAsync };
+  _internals3 = {
+    safeHook,
+    composeHandlers,
+    validateSwarmPath,
+    readSwarmFileAsync,
+    readCachedTextFile
+  };
 });
 
 // src/utils/git-binary-missing-error.ts
@@ -20452,8 +20468,8 @@ function extractPlanHashFromMarkdown(markdown) {
   const match = markdown.match(/<!--\s*PLAN_HASH:\s*(\S+)\s*-->/);
   return match ? match[1] : null;
 }
-async function isPlanMdInSync(directory, plan) {
-  const planMdContent = await readSwarmFileAsync(directory, "plan.md");
+async function isPlanMdInSync(directory, plan, cache) {
+  const planMdContent = await readSwarmFileAsync(directory, "plan.md", cache);
   if (planMdContent === null) {
     return false;
   }
@@ -20487,8 +20503,8 @@ ${markdown}`;
     } catch {}
   }
 }
-async function loadPlan(directory) {
-  const planJsonContent = await readSwarmFileAsync(directory, "plan.json");
+async function loadPlan(directory, cache) {
+  const planJsonContent = await readSwarmFileAsync(directory, "plan.json", cache);
   if (planJsonContent !== null) {
     if (planJsonContent.includes("\x00") || planJsonContent.includes("�")) {
       warn("Plan rejected: .swarm/plan.json contains null bytes or invalid encoding");
@@ -20498,7 +20514,7 @@ async function loadPlan(directory) {
         if (validated === null) {
           warn("[loadPlan] plan.json disappeared during cached parse. Falling back to plan.md migration or ledger recovery.");
         } else {
-          const inSync = await isPlanMdInSync(directory, validated);
+          const inSync = await isPlanMdInSync(directory, validated, cache);
           if (!inSync) {
             try {
               await _internals8.regeneratePlanMarkdown(directory, validated);
@@ -20621,7 +20637,7 @@ async function loadPlan(directory) {
             }
           }
         }
-        const planMdContent2 = await readSwarmFileAsync(directory, "plan.md");
+        const planMdContent2 = await readSwarmFileAsync(directory, "plan.md", cache);
         if (planMdContent2 !== null) {
           const migrated = migrateLegacyPlan(planMdContent2);
           const { removedCount } = await savePlanWithAutoAcknowledgedRemovals(directory, migrated, "load_plan_migration_from_md", "migrate legacy plan.md to plan.json");
@@ -20636,7 +20652,7 @@ async function loadPlan(directory) {
       }
     }
   }
-  const planMdContent = await readSwarmFileAsync(directory, "plan.md");
+  const planMdContent = await readSwarmFileAsync(directory, "plan.md", cache);
   if (planMdContent !== null) {
     const migrated = migrateLegacyPlan(planMdContent);
     await savePlan(directory, migrated);
@@ -73875,6 +73891,10 @@ This project was already finalized in a previous /swarm close run. The plan has
       ctx.warnings.push(`Failed to write close-summary.md: ${msg}`);
       console.warn("[close-command] Failed to write close-summary.md:", error93);
     }
+    const sessionIdsToEnd = [...swarmState.agentSessions.keys()];
+    for (const sessionId of sessionIdsToEnd) {
+      _internals38.endAgentSession(sessionId);
+    }
     _internals38.resetSwarmStatePreservingSingletons();
     const retroWarnings = ctx.warnings.filter((w) => w.includes("Retrospective write") || w.includes("retrospective write") || w.includes("Session retrospective"));
     const otherWarnings = ctx.warnings.filter((w) => !w.includes("Retrospective write") && !w.includes("retrospective write") && !w.includes("Session retrospective"));
@@ -74041,7 +74061,8 @@ var init_close = __esm(() => {
     runCleanStage,
     runAlignStage,
     archiveEvidence,
-    closePlanTerminalState
+    closePlanTerminalState,
+    endAgentSession
   };
 });
 
@@ -119725,6 +119746,7 @@ function createSystemEnhancerHook(config3, directory) {
             return;
           }
         }
+        const planReadCache = new Map;
         const maxInjectionTokens = config3.context_budget?.max_injection_tokens ?? 4000;
         let injectedTokens = 0;
         let actualDemand = 0;
@@ -119739,7 +119761,7 @@ function createSystemEnhancerHook(config3, directory) {
         } else {
           seAllocation = maxInjectionTokens;
         }
-        const contextContent = await readSwarmFileAsync(directory, "context.md");
+        const contextContent = await readSwarmFileAsync(directory, "context.md", planReadCache);
         try {
           const { scanDocIndex: scanDocIndex2 } = await Promise.resolve().then(() => (init_doc_scan(), exports_doc_scan));
           const { manifest, cached: cached3 } = await scanDocIndex2(directory);
@@ -119799,19 +119821,19 @@ function createSystemEnhancerHook(config3, directory) {
         if (!scoringEnabled) {
           let plan2 = null;
           try {
-            plan2 = await loadPlan(directory);
+            plan2 = await loadPlan(directory, planReadCache);
           } catch (error93) {
             warn(`Failed to load plan: ${error93 instanceof Error ? error93.message : String(error93)}`);
           }
           maybeAppendSpecDriftAdvisory(output, directory, plan2);
-          const mode = await detectArchitectMode(directory);
+          const mode = await detectArchitectMode(directory, planReadCache);
           let planContent = null;
           let phaseHeader = "";
           if (plan2 && plan2.migration_status !== "migration_failed") {
             phaseHeader = extractCurrentPhaseFromPlan(plan2) || "";
-            planContent = await readSwarmFileAsync(directory, "plan.md");
+            planContent = await readSwarmFileAsync(directory, "plan.md", planReadCache);
           } else {
-            planContent = await readSwarmFileAsync(directory, "plan.md");
+            planContent = await readSwarmFileAsync(directory, "plan.md", planReadCache);
             phaseHeader = planContent ? extractCurrentPhase(planContent) || "" : "";
           }
           if (phaseHeader) {
@@ -119823,7 +119845,7 @@ function createSystemEnhancerHook(config3, directory) {
           }
           if (mode !== "DISCOVER") {
             try {
-              const handoffContent = await readSwarmFileAsync(directory, "handoff.md");
+              const handoffContent = await readSwarmFileAsync(directory, "handoff.md", planReadCache);
               if (handoffContent) {
                 const handoffPath = validateSwarmPath(directory, "handoff.md");
                 const consumedPath = validateSwarmPath(directory, "handoff-consumed.md");
@@ -120187,7 +120209,7 @@ ${budgetWarning}`);
           } else {}
           return;
         }
-        const mode_b = await detectArchitectMode(directory);
+        const mode_b = await detectArchitectMode(directory, planReadCache);
         const userScoringConfig = config3.context_budget?.scoring;
         const candidates = [];
         let idCounter = 0;
@@ -120199,7 +120221,7 @@ ${budgetWarning}`);
         } : DEFAULT_SCORING_CONFIG;
         let plan = null;
         try {
-          plan = await loadPlan(directory);
+          plan = await loadPlan(directory, planReadCache);
         } catch (error93) {
           warn(`Failed to load plan: ${error93 instanceof Error ? error93.message : String(error93)}`);
         }
@@ -120210,7 +120232,7 @@ ${budgetWarning}`);
           currentPhase = extractCurrentPhaseFromPlan(plan);
           currentTask = extractCurrentTaskFromPlan(plan);
         } else {
-          planContentForCursor = await readSwarmFileAsync(directory, "plan.md");
+          planContentForCursor = await readSwarmFileAsync(directory, "plan.md", planReadCache);
           if (planContentForCursor) {
             currentPhase = extractCurrentPhase(planContentForCursor);
             currentTask = extractCurrentTask(planContentForCursor);
@@ -120254,7 +120276,7 @@ ${budgetWarning}`);
         }
         if (mode_b !== "DISCOVER") {
           try {
-            const handoffContent = await readSwarmFileAsync(directory, "handoff.md");
+            const handoffContent = await readSwarmFileAsync(directory, "handoff.md", planReadCache);
             if (handoffContent) {
               const handoffPath = validateSwarmPath(directory, "handoff.md");
               const consumedPath = validateSwarmPath(directory, "handoff-consumed.md");
@@ -120753,9 +120775,9 @@ ${activitySection}`;
   }
   return contextSummary;
 }
-async function detectArchitectMode(directory) {
+async function detectArchitectMode(directory, cache4) {
   try {
-    const plan = await loadPlan(directory);
+    const plan = await loadPlan(directory, cache4);
     if (!plan) {
       return "DISCOVER";
     }

package/dist/plan/manager.d.ts

@@ -108,7 +108,7 @@ export declare function regeneratePlanMarkdown(directory: string, plan: Plan): P
  * 3. .swarm/plan.md exists only -> migrate from plan.md, save both files, return Plan
  * 4. Neither exists -> return null
  */
-export declare function loadPlan(directory: string): Promise<RuntimePlan | null>;
+export declare function loadPlan(directory: string, cache?: Map<string, Promise<string | null>>): Promise<RuntimePlan | null>;
 /**
  * Recovery-path helper for callers that legitimately need to replace the
  * plan task set without explicit per-id acknowledgement (e.g. rebuilding

package/dist/state.d.ts

@@ -391,9 +391,9 @@ export declare function resetSwarmStatePreservingSingletons(): void;
 export declare function startAgentSession(sessionId: string, agentName: string, staleDurationMs?: number, directory?: string): void;
 /**
  * End an agent session by removing it from the state.
- * NOTE: Currently unused in production — no session lifecycle teardown is wired up.
- * Sessions accumulate for the process lifetime. Callers should integrate this into
- * a session TTL or idle-timeout mechanism to prevent unbounded Map growth.
+ * Called at session terminal state transitions (task completion, error, or session
+ * teardown) to prevent unbounded Map growth. Double-calls are safe: Map.delete is
+ * a no-op for missing keys (FR-010).
  * @param sessionId - The session identifier to remove
  */
 export declare function endAgentSession(sessionId: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.98.1",
+	"version": "7.98.2",
 	"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",