opencode-swarm-plugin 0.28.1 → 0.29.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 $ bun build ./src/index.ts --outdir ./dist --target node --external @electric-sql/pglite --external swarm-mail && bun build ./src/plugin.ts --outfile ./dist/plugin.js --target node --external @electric-sql/pglite --external swarm-mail && tsc
-Bundled 200 modules in 34ms
+Bundled 200 modules in 35ms
 
   index.js  1.20 MB  (entry point)
 

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # opencode-swarm-plugin
 
+## 0.29.0
+
+### Minor Changes
+
+- [`a2ff1f4`](https://github.com/joelhooks/swarm-tools/commit/a2ff1f4257a2e9857f63abe4e9b941a573f44380) Thanks [@joelhooks](https://github.com/joelhooks)! - ## 🐝 Cell IDs Now Wear Their Project Colors
+
+  > _"We may fantasize about being International Men of Mystery, but our code needs to be mundane and clear. One of the most important parts of clear code is good names."_
+  > — Martin Fowler, _Refactoring_
+
+  Cell IDs finally know where they came from. Instead of anonymous `bd-xxx` prefixes,
+  new cells proudly display their project name: `swarm-mail-lf2p4u-abc123`.
+
+  ### What Changed
+
+  **swarm-mail:**
+
+  - `generateBeadId()` now reads `package.json` name field from project directory
+  - Added `slugifyProjectName()` for safe ID generation (lowercase, special chars → dashes)
+  - Falls back to `cell-` prefix if no package.json or no name field
+
+  **opencode-swarm-plugin:**
+
+  - Removed all `bd` CLI usage from `swarm-orchestrate.ts` - now uses HiveAdapter
+  - Improved compaction hook swarm detection with confidence levels (high/medium/low)
+  - Added fallback detection prompt for uncertain swarm states
+
+  ### Examples
+
+  | Before                  | After                           |
+  | ----------------------- | ------------------------------- |
+  | `bd-lf2p4u-mjbneh7mqah` | `swarm-mail-lf2p4u-mjbneh7mqah` |
+  | `bd-abc123-xyz`         | `my-cool-app-abc123-xyz`        |
+  | (no package.json)       | `cell-abc123-xyz`               |
+
+  ### Why It Matters
+
+  - **Identifiable at a glance** - Know which project a cell belongs to without looking it up
+  - **Multi-project workspaces** - Filter/search cells by project prefix
+  - **Terminology cleanup** - Removes legacy "bead" (`bd-`) from user-facing IDs
+
+  ### Backward Compatible
+
+  Existing `bd-*` IDs still work fine. No migration needed - only NEW cells get project prefixes.
+
+  ### Compaction: Keeping the Swarm Alive
+
+  > _"Intelligent and structured group dynamics that emerge not from a leader, but from the local interactions of the elements themselves."_
+  > — Daniel Shiffman, _The Nature of Code_
+
+  The compaction hook now uses multi-signal detection to keep swarms cooking through context compression:
+
+  - **HIGH confidence:** Active reservations, in_progress cells → full swarm context
+  - **MEDIUM confidence:** Open subtasks, unclosed epics → full swarm context
+  - **LOW confidence:** Any cells exist → fallback detection prompt
+
+  Philosophy: Err on the side of continuation. A false positive costs context space. A false negative loses the swarm.
+
+### Patch Changes
+
+- Updated dependencies [[`a2ff1f4`](https://github.com/joelhooks/swarm-tools/commit/a2ff1f4257a2e9857f63abe4e9b941a573f44380)]:
+  - swarm-mail@0.4.0
+
+## 0.28.2
+
+### Patch Changes
+
+- Updated dependencies [[`90409ef`](https://github.com/joelhooks/swarm-tools/commit/90409ef4f353844b25fe04221bc80d6f930eced2)]:
+  - swarm-mail@0.3.4
+
 ## 0.28.1
 
 ### Patch Changes

package/dist/compaction-hook.d.ts

@@ -5,6 +5,12 @@
  * When context is compacted, this hook injects instructions for the summarizer
  * to preserve swarm coordination state and enable seamless resumption.
  *
+ * ## Philosophy: Err on the Side of Continuation
+ *
+ * It's better to inject swarm context unnecessarily than to lose an active swarm.
+ * The cost of a false positive (extra context) is low.
+ * The cost of a false negative (lost swarm) is high - wasted work, confused agents.
+ *
  * Hook signature (from @opencode-ai/plugin):
  * ```typescript
  * "experimental.session.compacting"?: (
@@ -33,11 +39,23 @@
  * autonomously after context compression.
  */
 export declare const SWARM_COMPACTION_CONTEXT = "## \uD83D\uDC1D SWARM ACTIVE - Keep Cooking\n\nYou are the **COORDINATOR** of an active swarm. Context was compacted but the swarm is still running.\n\n**YOUR JOB:** Keep orchestrating. Spawn agents. Monitor progress. Unblock work. Ship it.\n\n### Preserve in Summary\n\nExtract from session context:\n\n1. **Epic & Subtasks** - IDs, titles, status, file assignments\n2. **What's Running** - Which agents are active, what they're working on  \n3. **What's Blocked** - Blockers and what's needed to unblock\n4. **What's Done** - Completed work and any follow-ups needed\n5. **What's Next** - Pending subtasks ready to spawn\n\n### Summary Format\n\n```\n## \uD83D\uDC1D Swarm State\n\n**Epic:** <bd-xxx> - <title>\n**Project:** <path>\n**Progress:** X/Y subtasks complete\n\n**Active:**\n- <bd-xxx>: <title> [in_progress] \u2192 <agent> working on <files>\n\n**Blocked:**\n- <bd-xxx>: <title> - BLOCKED: <reason>\n\n**Completed:**\n- <bd-xxx>: <title> \u2713\n\n**Ready to Spawn:**\n- <bd-xxx>: <title> (files: <...>)\n```\n\n### On Resume - IMMEDIATELY\n\n1. `swarm_status(epic_id=\"<epic>\", project_key=\"<path>\")` - Get current state\n2. `swarmmail_inbox(limit=5)` - Check for agent messages\n3. **Spawn ready subtasks** - Don't wait, fire them off\n4. **Unblock blocked work** - Resolve dependencies, reassign if needed\n5. **Collect completed work** - Close done subtasks, verify quality\n\n### Keep the Swarm Cooking\n\n- **Spawn aggressively** - If a subtask is ready and unblocked, spawn an agent\n- **Monitor actively** - Check status, read messages, respond to blockers\n- **Close the loop** - When all subtasks done, verify and close the epic\n- **Don't stop** - The swarm runs until the epic is closed\n\n**You are not waiting for instructions. You are the coordinator. Coordinate.**\n";
+/**
+ * Fallback detection prompt - tells the compactor what to look for
+ *
+ * Used when we can't definitively detect a swarm but want to be safe.
+ * The compactor can check the conversation context for these patterns.
+ */
+export declare const SWARM_DETECTION_FALLBACK = "## \uD83D\uDC1D Swarm Detection - Check Your Context\n\n**IMPORTANT:** Before summarizing, check if this session involves an active swarm.\n\nLook for ANY of these patterns in the conversation:\n\n### Tool Calls (definite swarm sign)\n- `swarm_decompose`, `swarm_spawn_subtask`, `swarm_status`, `swarm_complete`\n- `swarmmail_init`, `swarmmail_reserve`, `swarmmail_send`\n- `hive_create_epic`, `hive_start`, `hive_close`\n\n### IDs and Names\n- Cell IDs: `bd-xxx`, `bd-xxx.N` (subtask format)\n- Agent names: BlueLake, RedMountain, GreenValley, etc.\n- Epic references: \"epic\", \"subtask\", \"parent\"\n\n### Coordination Language\n- \"spawn\", \"worker\", \"coordinator\"\n- \"reserve\", \"reservation\", \"files\"\n- \"blocked\", \"unblock\", \"dependency\"\n- \"progress\", \"complete\", \"in_progress\"\n\n### If You Find Swarm Evidence\n\nInclude this in your summary:\n1. Epic ID and title\n2. Project path\n3. Subtask status (running/blocked/done/pending)\n4. Any blockers or issues\n5. What should happen next\n\n**Then tell the resumed session:**\n\"This is an active swarm. Check swarm_status and swarmmail_inbox immediately.\"\n";
 /**
  * Create the compaction hook for use in plugin registration
  *
- * Only injects swarm context if there's an active swarm (in-progress beads).
- * This keeps the coordinator cooking after compaction.
+ * Injects swarm context based on detection confidence:
+ * - HIGH/MEDIUM: Full swarm context (definitely/probably a swarm)
+ * - LOW: Fallback detection prompt (let compactor check context)
+ * - NONE: No injection (probably not a swarm)
+ *
+ * Philosophy: Err on the side of continuation. A false positive costs
+ * a bit of context space. A false negative loses the swarm.
  *
  * @example
  * ```typescript

package/dist/compaction-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../src/compaction-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,2wDAsDpC,CAAC;AAyCF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,KAEhC,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,KAC5B,OAAO,CAAC,IAAI,CAAC,CAMjB"}
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../src/compaction-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AASH;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,2wDAsDpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,0nCAiCpC,CAAC;AAoIF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,KAEhC,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,KAC5B,OAAO,CAAC,IAAI,CAAC,CAcjB"}

package/dist/hive.d.ts

@@ -301,11 +301,11 @@ export declare const hive_sync: {
 export declare const hive_link_thread: {
     description: string;
     args: {
-        cell_id: z.ZodString;
+        bead_id: z.ZodString;
         thread_id: z.ZodString;
     };
     execute(args: {
-        cell_id: string;
+        bead_id: string;
         thread_id: string;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
@@ -461,11 +461,11 @@ export declare const hiveTools: {
     hive_link_thread: {
         description: string;
         args: {
-            cell_id: z.ZodString;
+            bead_id: z.ZodString;
             thread_id: z.ZodString;
         };
         execute(args: {
-            cell_id: string;
+            bead_id: string;
             thread_id: string;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };
@@ -648,11 +648,11 @@ export declare const beads_sync: {
 export declare const beads_link_thread: {
     description: string;
     args: {
-        cell_id: z.ZodString;
+        bead_id: z.ZodString;
         thread_id: z.ZodString;
     };
     execute(args: {
-        cell_id: string;
+        bead_id: string;
         thread_id: string;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
@@ -811,11 +811,11 @@ export declare const beadsTools: {
     beads_link_thread: {
         description: string;
         args: {
-            cell_id: z.ZodString;
+            bead_id: z.ZodString;
             thread_id: z.ZodString;
         };
         execute(args: {
-            cell_id: string;
+            bead_id: string;
             thread_id: string;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };

package/dist/index.d.ts

@@ -1287,11 +1287,11 @@ export declare const allTools: {
     readonly hive_link_thread: {
         description: string;
         args: {
-            cell_id: import("zod").ZodString;
+            bead_id: import("zod").ZodString;
             thread_id: import("zod").ZodString;
         };
         execute(args: {
-            cell_id: string;
+            bead_id: string;
             thread_id: string;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };

package/dist/index.js

@@ -28258,30 +28258,30 @@ var hive_sync = tool({
 var hive_link_thread = tool({
   description: "Add metadata linking cell to Agent Mail thread",
   args: {
-    cell_id: tool.schema.string().describe("Cell ID"),
+    bead_id: tool.schema.string().describe("Cell ID"),
     thread_id: tool.schema.string().describe("Agent Mail thread ID")
   },
   async execute(args, ctx) {
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
     try {
-      const cell = await adapter.getCell(projectKey, args.cell_id);
+      const cell = await adapter.getCell(projectKey, args.bead_id);
       if (!cell) {
-        throw new HiveError(`Cell not found: ${args.cell_id}`, "hive_link_thread");
+        throw new HiveError(`Cell not found: ${args.bead_id}`, "hive_link_thread");
       }
       const existingDesc = cell.description || "";
       const threadMarker = `[thread:${args.thread_id}]`;
       if (existingDesc.includes(threadMarker)) {
-        return `Cell ${args.cell_id} already linked to thread ${args.thread_id}`;
+        return `Cell ${args.bead_id} already linked to thread ${args.thread_id}`;
       }
       const newDesc = existingDesc ? `${existingDesc}
 
 ${threadMarker}` : threadMarker;
-      await adapter.updateCell(projectKey, args.cell_id, {
+      await adapter.updateCell(projectKey, args.bead_id, {
         description: newDesc
       });
-      await adapter.markDirty(projectKey, args.cell_id);
-      return `Linked cell ${args.cell_id} to thread ${args.thread_id}`;
+      await adapter.markDirty(projectKey, args.bead_id);
+      return `Linked cell ${args.bead_id} to thread ${args.thread_id}`;
     } catch (error45) {
       const message = error45 instanceof Error ? error45.message : String(error45);
       throw new HiveError(`Failed to link thread: ${message}`, "hive_link_thread");
@@ -28523,27 +28523,11 @@ var toolCheckers = {
     }
   },
   beads: async () => {
-    const exists = await commandExists("bd");
-    if (!exists) {
-      return {
-        available: false,
-        checkedAt: new Date().toISOString(),
-        error: "bd command not found"
-      };
-    }
-    try {
-      const result = await Bun.$`bd --version`.quiet().nothrow();
-      return {
-        available: result.exitCode === 0,
-        checkedAt: new Date().toISOString()
-      };
-    } catch (e) {
-      return {
-        available: false,
-        checkedAt: new Date().toISOString(),
-        error: String(e)
-      };
-    }
+    return {
+      available: false,
+      checkedAt: new Date().toISOString(),
+      error: "bd CLI is deprecated - use hive_* tools with HiveAdapter instead"
+    };
   },
   "swarm-mail": async () => {
     try {
@@ -32663,27 +32647,25 @@ var reviewTools = {
 };
 
 // src/swarm-orchestrate.ts
-async function queryEpicSubtasks(epicId) {
-  const beadsAvailable = await isToolAvailable("beads");
-  if (!beadsAvailable) {
-    warnMissingTool("beads");
-    return [];
-  }
-  const result = await Bun.$`bd list --parent ${epicId} --json`.quiet().nothrow();
-  if (result.exitCode !== 0) {
-    console.error(`[swarm] ERROR: Failed to query subtasks for epic ${epicId}:`, result.stderr.toString());
-    return [];
-  }
+async function queryEpicSubtasks(projectKey, epicId) {
   try {
-    const parsed = JSON.parse(result.stdout.toString());
-    return exports_external.array(BeadSchema).parse(parsed);
+    const adapter = await getHiveAdapter(projectKey);
+    const cells = await adapter.queryCells(projectKey, { parent_id: epicId });
+    return cells.filter((cell) => cell.status !== "tombstone").map((cell) => ({
+      id: cell.id,
+      title: cell.title,
+      description: cell.description || "",
+      status: cell.status,
+      priority: cell.priority,
+      issue_type: cell.type,
+      created_at: new Date(cell.created_at).toISOString(),
+      updated_at: cell.updated_at ? new Date(cell.updated_at).toISOString() : undefined,
+      dependencies: [],
+      metadata: {}
+    }));
   } catch (error45) {
-    if (error45 instanceof exports_external.ZodError) {
-      console.error(`[swarm] ERROR: Invalid bead data for epic ${epicId}:`, error45.message);
-      return [];
-    }
-    console.error(`[swarm] ERROR: Failed to parse beads for epic ${epicId}:`, error45);
-    throw error45;
+    console.error(`[swarm] ERROR: Failed to query subtasks for epic ${epicId}:`, error45 instanceof Error ? error45.message : String(error45));
+    return [];
   }
 }
 async function querySwarmMessages(projectKey, threadId) {
@@ -33035,7 +33017,7 @@ var swarm_status = tool({
     project_key: tool.schema.string().describe("Project path (for Agent Mail queries)")
   },
   async execute(args) {
-    const subtasks = await queryEpicSubtasks(args.epic_id);
+    const subtasks = await queryEpicSubtasks(args.project_key, args.epic_id);
     const statusCounts = {
       running: 0,
       completed: 0,
@@ -33110,8 +33092,13 @@ var swarm_progress = tool({
     };
     const validated = AgentProgressSchema.parse(progress);
     if (args.status === "blocked" || args.status === "in_progress") {
-      const beadStatus = args.status === "blocked" ? "blocked" : "in_progress";
-      await Bun.$`bd update ${args.bead_id} --status ${beadStatus} --json`.quiet().nothrow();
+      try {
+        const adapter = await getHiveAdapter(args.project_key);
+        const newStatus = args.status === "blocked" ? "blocked" : "in_progress";
+        await adapter.changeCellStatus(args.project_key, args.bead_id, newStatus);
+      } catch (error45) {
+        console.error(`[swarm] Failed to update cell status: ${error45 instanceof Error ? error45.message : String(error45)}`);
+      }
     }
     const epicId = args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id;
     await sendSwarmMessage3({
@@ -33255,6 +33242,22 @@ Or use skip_review=true to bypass (not recommended for production work).`
     }
     try {
       const projectKey = args.project_key.replace(/\//g, "-").replace(/\\/g, "-");
+      const adapter = await getHiveAdapter(args.project_key);
+      const cell = await adapter.getCell(projectKey, args.bead_id);
+      if (!cell) {
+        return JSON.stringify({
+          success: false,
+          error: `Bead not found: ${args.bead_id}`,
+          hint: "Check the bead ID is correct. Use hive_query to list open cells."
+        });
+      }
+      if (cell.status === "closed") {
+        return JSON.stringify({
+          success: false,
+          error: `Bead already closed: ${args.bead_id}`,
+          hint: "This bead was already completed. No action needed."
+        });
+      }
       let agentRegistered = false;
       let registrationWarning = "";
       try {
@@ -33339,32 +33342,25 @@ Continuing with completion, but this should be fixed for future subtasks.`;
           }, null, 2);
         }
       }
-      const closeResult = await Bun.$`bd close ${args.bead_id} --reason ${args.summary} --json`.cwd(args.project_key).quiet().nothrow();
-      if (closeResult.exitCode !== 0) {
-        const stderrOutput = closeResult.stderr.toString().trim();
-        const stdoutOutput = closeResult.stdout.toString().trim();
-        const isNoDatabaseError = stderrOutput.includes("no beads database found");
-        const isNotFoundError = stderrOutput.includes("not found") || stderrOutput.includes("does not exist");
+      try {
+        await adapter.closeCell(args.project_key, args.bead_id, args.summary);
+      } catch (closeError) {
+        const errorMessage = closeError instanceof Error ? closeError.message : String(closeError);
         return JSON.stringify({
           success: false,
           error: "Failed to close cell",
-          failed_step: "bd close",
-          details: stderrOutput || stdoutOutput || "Unknown error from bd close command",
+          failed_step: "closeCell",
+          details: errorMessage,
           bead_id: args.bead_id,
           project_key: args.project_key,
           recovery: {
-            steps: isNoDatabaseError ? [
-              `1. Verify project_key is correct: "${args.project_key}"`,
-              `2. Check .beads/ exists in that directory`,
-              `3. Cell ID prefix "${args.bead_id.split("-")[0]}" should match project`,
-              `4. Try: hive_close(id="${args.bead_id}", reason="...")`
-            ] : [
-              `1. Check cell exists: bd show ${args.bead_id}`,
-              `2. Check cell status (might already be closed): hive_query()`,
+            steps: [
+              `1. Check cell exists: hive_query()`,
+              `2. Check cell status (might already be closed)`,
               `3. If cell is blocked, unblock first: hive_update(id="${args.bead_id}", status="in_progress")`,
               `4. Try closing directly: hive_close(id="${args.bead_id}", reason="...")`
             ],
-            hint: isNoDatabaseError ? `The project_key "${args.project_key}" doesn't have a .beads/ directory. Make sure you're using the correct project path.` : isNotFoundError ? `Cell "${args.bead_id}" not found. It may have been closed already or the ID is incorrect.` : "If cell is in 'blocked' status, you must change it to 'in_progress' or 'open' before closing."
+            hint: "Cell may already be closed, or the ID is incorrect."
           }
         }, null, 2);
       }
@@ -33565,12 +33561,13 @@ ${errorStack.slice(0, 1000)}
       }
       return JSON.stringify({
         success: false,
-        error: errorMessage,
+        error: `swarm_complete failed: ${errorMessage}`,
         failed_step: failedStep,
         bead_id: args.bead_id,
         agent_name: args.agent_name,
         coordinator_notified: notificationSent,
         stack_trace: errorStack?.slice(0, 500),
+        hint: "Check the error message above. Common issues: bead not found, session not initialized.",
         context: {
           summary: args.summary,
           files_touched: args.files_touched || [],
@@ -35890,6 +35887,7 @@ async function resetStorage() {
 init_skills();
 
 // src/compaction-hook.ts
+import { checkSwarmHealth as checkSwarmHealth3 } from "swarm-mail";
 var SWARM_COMPACTION_CONTEXT = `## \uD83D\uDC1D SWARM ACTIVE - Keep Cooking
 
 You are the **COORDINATOR** of an active swarm. Context was compacted but the swarm is still running.
@@ -35945,23 +35943,128 @@ Extract from session context:
 
 **You are not waiting for instructions. You are the coordinator. Coordinate.**
 `;
-async function hasSwarmSign() {
+var SWARM_DETECTION_FALLBACK = `## \uD83D\uDC1D Swarm Detection - Check Your Context
+
+**IMPORTANT:** Before summarizing, check if this session involves an active swarm.
+
+Look for ANY of these patterns in the conversation:
+
+### Tool Calls (definite swarm sign)
+- \`swarm_decompose\`, \`swarm_spawn_subtask\`, \`swarm_status\`, \`swarm_complete\`
+- \`swarmmail_init\`, \`swarmmail_reserve\`, \`swarmmail_send\`
+- \`hive_create_epic\`, \`hive_start\`, \`hive_close\`
+
+### IDs and Names
+- Cell IDs: \`bd-xxx\`, \`bd-xxx.N\` (subtask format)
+- Agent names: BlueLake, RedMountain, GreenValley, etc.
+- Epic references: "epic", "subtask", "parent"
+
+### Coordination Language
+- "spawn", "worker", "coordinator"
+- "reserve", "reservation", "files"
+- "blocked", "unblock", "dependency"
+- "progress", "complete", "in_progress"
+
+### If You Find Swarm Evidence
+
+Include this in your summary:
+1. Epic ID and title
+2. Project path
+3. Subtask status (running/blocked/done/pending)
+4. Any blockers or issues
+5. What should happen next
+
+**Then tell the resumed session:**
+"This is an active swarm. Check swarm_status and swarmmail_inbox immediately."
+`;
+async function detectSwarm() {
+  const reasons = [];
+  let highConfidence = false;
+  let mediumConfidence = false;
+  let lowConfidence = false;
   try {
     const projectKey = getHiveWorkingDirectory();
-    const adapter = await getHiveAdapter(projectKey);
-    const cells = await adapter.queryCells(projectKey, {});
-    if (!Array.isArray(cells))
-      return false;
-    return cells.some((c) => c.status === "in_progress" || c.status === "open" && c.parent_id || c.type === "epic" && c.status !== "closed");
+    try {
+      const health = await checkSwarmHealth3(projectKey);
+      if (health.healthy && health.stats) {
+        if (health.stats.reservations > 0) {
+          highConfidence = true;
+          reasons.push(`${health.stats.reservations} active file reservations`);
+        }
+        if (health.stats.agents > 0) {
+          mediumConfidence = true;
+          reasons.push(`${health.stats.agents} registered agents`);
+        }
+        if (health.stats.messages > 0) {
+          lowConfidence = true;
+          reasons.push(`${health.stats.messages} swarm messages`);
+        }
+      }
+    } catch {}
+    try {
+      const adapter = await getHiveAdapter(projectKey);
+      const cells = await adapter.queryCells(projectKey, {});
+      if (Array.isArray(cells) && cells.length > 0) {
+        const inProgress = cells.filter((c) => c.status === "in_progress");
+        if (inProgress.length > 0) {
+          highConfidence = true;
+          reasons.push(`${inProgress.length} cells in_progress`);
+        }
+        const subtasks = cells.filter((c) => c.status === "open" && c.parent_id);
+        if (subtasks.length > 0) {
+          mediumConfidence = true;
+          reasons.push(`${subtasks.length} open subtasks`);
+        }
+        const openEpics = cells.filter((c) => c.type === "epic" && c.status !== "closed");
+        if (openEpics.length > 0) {
+          mediumConfidence = true;
+          reasons.push(`${openEpics.length} unclosed epics`);
+        }
+        const oneHourAgo = Date.now() - 60 * 60 * 1000;
+        const recentCells = cells.filter((c) => c.updated_at > oneHourAgo);
+        if (recentCells.length > 0) {
+          mediumConfidence = true;
+          reasons.push(`${recentCells.length} cells updated in last hour`);
+        }
+        if (cells.length > 0) {
+          lowConfidence = true;
+          reasons.push(`${cells.length} total cells in hive`);
+        }
+      }
+    } catch {}
   } catch {
-    return false;
+    lowConfidence = true;
+    reasons.push("Could not detect project, using fallback");
+  }
+  let confidence;
+  if (highConfidence) {
+    confidence = "high";
+  } else if (mediumConfidence) {
+    confidence = "medium";
+  } else if (lowConfidence) {
+    confidence = "low";
+  } else {
+    confidence = "none";
   }
+  return {
+    detected: confidence !== "none",
+    confidence,
+    reasons
+  };
 }
 function createCompactionHook() {
   return async (_input, output) => {
-    const hasSign = await hasSwarmSign();
-    if (hasSign) {
-      output.context.push(SWARM_COMPACTION_CONTEXT);
+    const detection = await detectSwarm();
+    if (detection.confidence === "high" || detection.confidence === "medium") {
+      const header = `[Swarm detected: ${detection.reasons.join(", ")}]
+
+`;
+      output.context.push(header + SWARM_COMPACTION_CONTEXT);
+    } else if (detection.confidence === "low") {
+      const header = `[Possible swarm: ${detection.reasons.join(", ")}]
+
+`;
+      output.context.push(header + SWARM_DETECTION_FALLBACK);
     }
   };
 }