opencode-swarm-plugin 0.30.7 → 0.31.1

package/CHANGELOG.md

@@ -1,5 +1,135 @@
 # opencode-swarm-plugin
 
+## 0.31.1
+
+### Patch Changes
+
+- [`19995a6`](https://github.com/joelhooks/swarm-tools/commit/19995a68dd1283de1d13afa6fc028bd1273d1b27) Thanks [@joelhooks](https://github.com/joelhooks)! - ## 🐝 Squashed the BigInt Date Bug
+
+  PGLite returns BIGINT columns as JavaScript `bigint` type. The `Date` constructor throws when given a bigint:
+
+  ```javascript
+  new Date(1734628445371n); // TypeError: Cannot convert a BigInt value to a number
+  ```
+
+  This caused `Invalid Date` errors in all hive operations (`hive_query`, `hive_create`, etc).
+
+  **Fix:** Wrap timestamps in `Number()` before passing to `Date`:
+
+  ```typescript
+  // Before (broken)
+  new Date(cell.created_at);
+
+  // After (works with both number and bigint)
+  new Date(Number(cell.created_at));
+  ```
+
+  **Files fixed:**
+
+  - `swarm-mail/src/hive/jsonl.ts` - JSONL export functions
+  - `opencode-swarm-plugin/src/hive.ts` - `formatCellForOutput()`
+
+  **Tests added:** 6 new tests covering bigint date handling edge cases.
+
+- Updated dependencies [[`19995a6`](https://github.com/joelhooks/swarm-tools/commit/19995a68dd1283de1d13afa6fc028bd1273d1b27)]:
+  - swarm-mail@1.1.1
+
+## 0.31.0
+
+### Minor Changes
+
+- [`39593d7`](https://github.com/joelhooks/swarm-tools/commit/39593d7ee817c683ad1877af52ad5f2ca140c4e2) Thanks [@joelhooks](https://github.com/joelhooks)! - ## Smart ID Resolution: Git-Style Partial Hashes for Hive
+
+  ```
+  ┌─────────────────────────────────────────────────────────────┐
+  │  BEFORE: hive_close(id="opencode-swarm-monorepo-lf2p4u-mjcadqq3fb9")  │
+  │  AFTER:  hive_close(id="mjcadqq3fb9")                                 │
+  └─────────────────────────────────────────────────────────────┘
+  ```
+
+  Cell IDs got long. Now you can use just the hash portion.
+
+  **What changed:**
+
+  ### swarm-mail
+
+  - Added `resolvePartialId(adapter, partialId)` to resolve partial hashes to full cell IDs
+  - Supports exact match, prefix match, suffix match, and substring match
+  - Returns helpful error messages for ambiguous matches ("Found 3 cells matching 'abc': ...")
+  - 36 new tests covering all resolution scenarios
+
+  ### opencode-swarm-plugin
+
+  - `hive_update`, `hive_close`, `hive_start` now accept partial IDs
+  - Resolution happens transparently - full ID returned in response
+  - Backward compatible - full IDs still work
+
+  **JSONL Fix (bonus):**
+
+  - `serializeToJSONL()` now adds trailing newline for POSIX compliance
+  - Prevents parse errors when appending to existing files
+
+  **Why it matters:**
+
+  - Less typing, fewer copy-paste errors
+  - Matches git's partial SHA workflow (muscle memory)
+  - Ambiguous matches fail fast with actionable error messages
+
+  > "The best interface is no interface" - Golden Krishna
+  > (But if you must have one, make it forgive typos)
+
+  ***
+
+  ## Auto-Sync at Key Events
+
+  ```
+  ┌─────────────────────────────────────────┐
+  │  hive_create_epic  →  auto-sync         │
+  │  swarm_complete    →  auto-sync         │
+  │  process.exit      →  safety net sync   │
+  └─────────────────────────────────────────┘
+  ```
+
+  Cells no longer get lost when processes exit unexpectedly.
+
+  **What changed:**
+
+  - `hive_create_epic` syncs after creating epic + subtasks (workers can see them immediately)
+  - `swarm_complete` syncs before worker exits (completed work persists)
+  - `process.on('beforeExit')` hook catches any remaining dirty cells
+
+  **Why it matters:**
+
+  - Spawned workers couldn't see cells created by coordinator (race condition)
+  - Worker crashes could lose completed work
+  - Now the lazy-write pattern has strategic checkpoints
+
+  ***
+
+  ## Removed Arbitrary Subtask Limits
+
+  ```
+  BEFORE: max_subtasks capped at 10 (why tho?)
+  AFTER:  no limit - LLM decides based on task complexity
+  ```
+
+  **What changed:**
+
+  - Removed `.max(10)` from `swarm_decompose` and `swarm_plan_prompt`
+  - `max_subtasks` is now optional with no default
+  - Prompt says "as many as needed" instead of "2-10"
+
+  **Why it matters:**
+
+  - Complex epics need more than 10 subtasks
+  - Arbitrary limits force awkward decomposition
+  - Trust the coordinator to make good decisions
+
+### Patch Changes
+
+- Updated dependencies [[`39593d7`](https://github.com/joelhooks/swarm-tools/commit/39593d7ee817c683ad1877af52ad5f2ca140c4e2)]:
+  - swarm-mail@1.1.0
+
 ## 0.30.7
 
 ### Patch Changes

package/dist/hive.d.ts.map

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

package/dist/index.d.ts

@@ -967,7 +967,7 @@ export declare const allTools: {
                 "risk-based": "risk-based";
                 auto: "auto";
             }>>;
-            max_subtasks: import("zod").ZodDefault<import("zod").ZodNumber>;
+            max_subtasks: import("zod").ZodOptional<import("zod").ZodNumber>;
             context: import("zod").ZodOptional<import("zod").ZodString>;
             query_cass: import("zod").ZodOptional<import("zod").ZodBoolean>;
             cass_limit: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -975,8 +975,8 @@ export declare const allTools: {
         };
         execute(args: {
             task: string;
-            max_subtasks: number;
             strategy?: "file-based" | "feature-based" | "risk-based" | "auto" | undefined;
+            max_subtasks?: number | undefined;
             context?: string | undefined;
             query_cass?: boolean | undefined;
             cass_limit?: number | undefined;
@@ -987,14 +987,14 @@ export declare const allTools: {
         description: string;
         args: {
             task: import("zod").ZodString;
-            max_subtasks: import("zod").ZodDefault<import("zod").ZodNumber>;
+            max_subtasks: import("zod").ZodOptional<import("zod").ZodNumber>;
             context: import("zod").ZodOptional<import("zod").ZodString>;
             query_cass: import("zod").ZodOptional<import("zod").ZodBoolean>;
             cass_limit: import("zod").ZodOptional<import("zod").ZodNumber>;
         };
         execute(args: {
             task: string;
-            max_subtasks: number;
+            max_subtasks?: number | undefined;
             context?: string | undefined;
             query_cass?: boolean | undefined;
             cass_limit?: number | undefined;
@@ -1014,7 +1014,7 @@ export declare const allTools: {
         args: {
             task: import("zod").ZodString;
             context: import("zod").ZodOptional<import("zod").ZodString>;
-            max_subtasks: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+            max_subtasks: import("zod").ZodOptional<import("zod").ZodNumber>;
             strategy: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
                 "file-based": "file-based";
                 "feature-based": "feature-based";
@@ -1025,10 +1025,10 @@ export declare const allTools: {
         };
         execute(args: {
             task: string;
-            max_subtasks: number;
             strategy: "file-based" | "feature-based" | "risk-based" | "auto";
             query_cass: boolean;
             context?: string | undefined;
+            max_subtasks?: number | undefined;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };
     readonly swarm_plan_interactive: {

package/dist/index.js

@@ -27084,7 +27084,8 @@ import {
   FlushManager,
   importFromJSONL,
   syncMemories,
-  getSwarmMail
+  getSwarmMail,
+  resolvePartialId
 } from "swarm-mail";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -27935,6 +27936,43 @@ async function importJsonlToPGLite(projectPath) {
   return { imported, updated, errors: errors3 };
 }
 var adapterCache = new Map;
+var exitHookRegistered = false;
+var exitHookRunning = false;
+function registerExitHook() {
+  if (exitHookRegistered) {
+    return;
+  }
+  exitHookRegistered = true;
+  process.on("beforeExit", async (code) => {
+    if (exitHookRunning) {
+      return;
+    }
+    exitHookRunning = true;
+    try {
+      const flushPromises = [];
+      for (const [projectKey, adapter] of adapterCache.entries()) {
+        const flushPromise = (async () => {
+          try {
+            ensureHiveDirectory(projectKey);
+            const flushManager = new FlushManager({
+              adapter,
+              projectKey,
+              outputPath: `${projectKey}/.hive/issues.jsonl`
+            });
+            await flushManager.flush();
+          } catch (error45) {
+            console.warn(`[hive exit hook] Failed to flush ${projectKey}:`, error45 instanceof Error ? error45.message : String(error45));
+          }
+        })();
+        flushPromises.push(flushPromise);
+      }
+      await Promise.all(flushPromises);
+    } finally {
+      exitHookRunning = false;
+    }
+  });
+}
+registerExitHook();
 async function getHiveAdapter(projectKey) {
   if (adapterCache.has(projectKey)) {
     return adapterCache.get(projectKey);
@@ -27980,9 +28018,9 @@ function formatCellForOutput(adapterCell) {
     status: adapterCell.status,
     priority: adapterCell.priority,
     issue_type: adapterCell.type,
-    created_at: new Date(adapterCell.created_at).toISOString(),
-    updated_at: new Date(adapterCell.updated_at).toISOString(),
-    closed_at: adapterCell.closed_at ? new Date(adapterCell.closed_at).toISOString() : undefined,
+    created_at: new Date(Number(adapterCell.created_at)).toISOString(),
+    updated_at: new Date(Number(adapterCell.updated_at)).toISOString(),
+    closed_at: adapterCell.closed_at ? new Date(Number(adapterCell.closed_at)).toISOString() : undefined,
     parent_id: adapterCell.parent_id || undefined,
     dependencies: [],
     metadata: {}
@@ -28089,6 +28127,17 @@ var hive_create_epic = tool({
           console.warn("[hive_create_epic] Failed to emit DecompositionGeneratedEvent:", error45);
         }
       }
+      try {
+        ensureHiveDirectory(projectKey);
+        const flushManager = new FlushManager({
+          adapter,
+          projectKey,
+          outputPath: `${projectKey}/.hive/issues.jsonl`
+        });
+        await flushManager.flush();
+      } catch (error45) {
+        console.warn("[hive_create_epic] Failed to sync to JSONL:", error45);
+      }
       return JSON.stringify(result, null, 2);
     } catch (error45) {
       const rollbackErrors = [];
@@ -28153,7 +28202,7 @@ var hive_query = tool({
 var hive_update = tool({
   description: "Update cell status/description",
   args: {
-    id: tool.schema.string().describe("Cell ID"),
+    id: tool.schema.string().describe("Cell ID or partial hash"),
     status: tool.schema.enum(["open", "in_progress", "blocked", "closed"]).optional().describe("New status"),
     description: tool.schema.string().optional().describe("New description"),
     priority: tool.schema.number().min(0).max(3).optional().describe("New priority")
@@ -28163,27 +28212,34 @@ var hive_update = tool({
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
     try {
+      const cellId = await resolvePartialId(adapter, projectKey, validated.id) || validated.id;
       let cell;
       if (validated.status) {
-        cell = await adapter.changeCellStatus(projectKey, validated.id, validated.status);
+        cell = await adapter.changeCellStatus(projectKey, cellId, validated.status);
       }
       if (validated.description !== undefined || validated.priority !== undefined) {
-        cell = await adapter.updateCell(projectKey, validated.id, {
+        cell = await adapter.updateCell(projectKey, cellId, {
           description: validated.description,
           priority: validated.priority
         });
       } else if (!validated.status) {
-        const existingCell = await adapter.getCell(projectKey, validated.id);
+        const existingCell = await adapter.getCell(projectKey, cellId);
         if (!existingCell) {
           throw new HiveError(`Cell not found: ${validated.id}`, "hive_update");
         }
         cell = existingCell;
       }
-      await adapter.markDirty(projectKey, validated.id);
+      await adapter.markDirty(projectKey, cellId);
       const formatted = formatCellForOutput(cell);
       return JSON.stringify(formatted, null, 2);
     } catch (error45) {
       const message = error45 instanceof Error ? error45.message : String(error45);
+      if (message.includes("Ambiguous hash")) {
+        throw new HiveError(`Ambiguous ID '${validated.id}': multiple cells match. Please provide more characters.`, "hive_update");
+      }
+      if (message.includes("Bead not found") || message.includes("Cell not found")) {
+        throw new HiveError(`No cell found matching ID '${validated.id}'`, "hive_update");
+      }
       throw new HiveError(`Failed to update cell: ${message}`, "hive_update");
     }
   }
@@ -28191,7 +28247,7 @@ var hive_update = tool({
 var hive_close = tool({
   description: "Close a cell with reason",
   args: {
-    id: tool.schema.string().describe("Cell ID"),
+    id: tool.schema.string().describe("Cell ID or partial hash"),
     reason: tool.schema.string().describe("Completion reason")
   },
   async execute(args, ctx) {
@@ -28199,11 +28255,18 @@ var hive_close = tool({
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
     try {
-      const cell = await adapter.closeCell(projectKey, validated.id, validated.reason);
-      await adapter.markDirty(projectKey, validated.id);
+      const cellId = await resolvePartialId(adapter, projectKey, validated.id) || validated.id;
+      const cell = await adapter.closeCell(projectKey, cellId, validated.reason);
+      await adapter.markDirty(projectKey, cellId);
       return `Closed ${cell.id}: ${validated.reason}`;
     } catch (error45) {
       const message = error45 instanceof Error ? error45.message : String(error45);
+      if (message.includes("Ambiguous hash")) {
+        throw new HiveError(`Ambiguous ID '${validated.id}': multiple cells match. Please provide more characters.`, "hive_close");
+      }
+      if (message.includes("Bead not found") || message.includes("Cell not found")) {
+        throw new HiveError(`No cell found matching ID '${validated.id}'`, "hive_close");
+      }
       throw new HiveError(`Failed to close cell: ${message}`, "hive_close");
     }
   }
@@ -28211,17 +28274,24 @@ var hive_close = tool({
 var hive_start = tool({
   description: "Mark a cell as in-progress (shortcut for update --status in_progress)",
   args: {
-    id: tool.schema.string().describe("Cell ID")
+    id: tool.schema.string().describe("Cell ID or partial hash")
   },
   async execute(args, ctx) {
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
     try {
-      const cell = await adapter.changeCellStatus(projectKey, args.id, "in_progress");
-      await adapter.markDirty(projectKey, args.id);
+      const cellId = await resolvePartialId(adapter, projectKey, args.id) || args.id;
+      const cell = await adapter.changeCellStatus(projectKey, cellId, "in_progress");
+      await adapter.markDirty(projectKey, cellId);
       return `Started: ${cell.id}`;
     } catch (error45) {
       const message = error45 instanceof Error ? error45.message : String(error45);
+      if (message.includes("Ambiguous hash")) {
+        throw new HiveError(`Ambiguous ID '${args.id}': multiple cells match. Please provide more characters.`, "hive_start");
+      }
+      if (message.includes("Bead not found") || message.includes("Cell not found")) {
+        throw new HiveError(`No cell found matching ID '${args.id}'`, "hive_start");
+      }
       throw new HiveError(`Failed to start cell: ${message}`, "hive_start");
     }
   }
@@ -30685,7 +30755,7 @@ Agents MUST update their bead status as they work. No silent progress.
 
 ## Requirements
 
-1. **Break into 2-{max_subtasks} independent subtasks** that can run in parallel
+1. **Break into independent subtasks** that can run in parallel (as many as needed)
 2. **Assign files** - each subtask must specify which files it will modify
 3. **No file overlap** - files cannot appear in multiple subtasks (they get exclusive locks)
 4. **Order by dependency** - if subtask B needs subtask A's output, A must come first in the array
@@ -30758,7 +30828,7 @@ Agents MUST update their bead status as they work. No silent progress.
 
 ## Requirements
 
-1. **Break into 2-{max_subtasks} independent subtasks** that can run in parallel
+1. **Break into independent subtasks** that can run in parallel (as many as needed)
 2. **Assign files** - each subtask must specify which files it will modify
 3. **No file overlap** - files cannot appear in multiple subtasks (they get exclusive locks)
 4. **Order by dependency** - if subtask B needs subtask A's output, A must come first in the array
@@ -30924,10 +30994,10 @@ var swarm_decompose = tool({
   description: "Generate decomposition prompt for breaking task into parallelizable subtasks. Optionally queries CASS for similar past tasks.",
   args: {
     task: tool.schema.string().min(1).describe("Task description to decompose"),
-    max_subtasks: tool.schema.number().int().min(2).max(10).default(5).describe("Maximum number of subtasks (default: 5)"),
+    max_subtasks: tool.schema.number().int().min(1).optional().describe("Suggested max subtasks (optional - LLM decides if not specified)"),
     context: tool.schema.string().optional().describe("Additional context (codebase info, constraints, etc.)"),
     query_cass: tool.schema.boolean().optional().describe("Query CASS for similar past tasks (default: true)"),
-    cass_limit: tool.schema.number().int().min(1).max(10).optional().describe("Max CASS results to include (default: 3)")
+    cass_limit: tool.schema.number().int().min(1).optional().describe("Max CASS results to include (default: 3)")
   },
   async execute(args) {
     const { formatMemoryQueryForDecomposition: formatMemoryQueryForDecomposition2 } = await Promise.resolve().then(() => (init_learning(), exports_learning));
@@ -31055,7 +31125,7 @@ var swarm_delegate_planning = tool({
   args: {
     task: tool.schema.string().min(1).describe("The task to decompose"),
     context: tool.schema.string().optional().describe("Additional context to include"),
-    max_subtasks: tool.schema.number().int().min(2).max(10).optional().default(5).describe("Maximum number of subtasks (default: 5)"),
+    max_subtasks: tool.schema.number().int().min(1).optional().describe("Suggested max subtasks (optional - LLM decides if not specified)"),
     strategy: tool.schema.enum(["auto", "file-based", "feature-based", "risk-based"]).optional().default("auto").describe("Decomposition strategy (default: auto-detect)"),
     query_cass: tool.schema.boolean().optional().default(true).describe("Query CASS for similar past tasks (default: true)")
   },
@@ -34356,6 +34426,21 @@ This will be recorded as a negative learning signal.`;
           }
         }, null, 2);
       }
+      let syncSuccess = false;
+      let syncError;
+      try {
+        const previousWorkingDir = getHiveWorkingDirectory();
+        setHiveWorkingDirectory(args.project_key);
+        try {
+          const syncResult = await hive_sync.execute({ auto_pull: false }, _ctx);
+          syncSuccess = !syncResult.includes("error");
+        } finally {
+          setHiveWorkingDirectory(previousWorkingDir);
+        }
+      } catch (error45) {
+        syncError = error45 instanceof Error ? error45.message : String(error45);
+        console.warn(`[swarm_complete] Auto-sync failed (non-fatal): ${syncError}`);
+      }
       try {
         const epicId3 = args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id;
         const durationMs2 = args.start_time ? Date.now() - args.start_time : 0;
@@ -34441,6 +34526,8 @@ This will be recorded as a negative learning signal.`;
         bead_id: args.bead_id,
         closed: true,
         reservations_released: true,
+        synced: syncSuccess,
+        sync_error: syncError,
         message_sent: messageSent,
         message_error: messageError,
         agent_registration: {
@@ -35117,7 +35204,7 @@ Agents MUST update their cell status as they work. No silent progress.
 
 ## Requirements
 
-1. **Break into 2-{max_subtasks} independent subtasks** that can run in parallel
+1. **Break into independent subtasks** that can run in parallel (as many as needed)
 2. **Assign files** - each subtask must specify which files it will modify
 3. **No file overlap** - files cannot appear in multiple subtasks (they get exclusive locks)
 4. **Order by dependency** - if subtask B needs subtask A's output, A must come first in the array
@@ -35745,10 +35832,10 @@ var swarm_plan_prompt = tool({
   args: {
     task: tool.schema.string().min(1).describe("Task description to decompose"),
     strategy: tool.schema.enum(["file-based", "feature-based", "risk-based", "auto"]).optional().describe("Decomposition strategy (default: auto-detect)"),
-    max_subtasks: tool.schema.number().int().min(2).max(10).default(5).describe("Maximum number of subtasks (default: 5)"),
+    max_subtasks: tool.schema.number().int().min(1).optional().describe("Suggested max subtasks (optional - LLM decides if not specified)"),
     context: tool.schema.string().optional().describe("Additional context (codebase info, constraints, etc.)"),
     query_cass: tool.schema.boolean().optional().describe("Query CASS for similar past tasks (default: true)"),
-    cass_limit: tool.schema.number().int().min(1).max(10).optional().describe("Max CASS results to include (default: 3)"),
+    cass_limit: tool.schema.number().int().min(1).optional().describe("Max CASS results to include (default: 3)"),
     include_skills: tool.schema.boolean().optional().describe("Include available skills in context (default: true)")
   },
   async execute(args) {