opencode-swarm-plugin 0.31.1 → 0.31.3

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # opencode-swarm-plugin
 
+## 0.31.3
+
+### Patch Changes
+
+- [`fdddd27`](https://github.com/joelhooks/swarm-tools/commit/fdddd27f9c8627f7de2b9f108827c66c7040b049) Thanks [@joelhooks](https://github.com/joelhooks)! - ## 🐝 Short Hashes Now Welcome
+
+  The WorkerHandoff schema was too strict - it rejected short project names and partial hashes.
+
+  **Before:** Required 3+ hyphen-separated segments (regex nightmare)
+
+  ```
+  /^[a-z0-9]+(-[a-z0-9]+){2,}(\.[\w-]+)?$/
+  ```
+
+  **After:** Any non-empty string, validated at runtime via `resolvePartialId()`
+
+  Now you can use:
+
+  - Full IDs: `opencode-swarm-monorepo-lf2p4u-mjd4pjujc7e`
+  - Short hashes: `mjd4pjujc7e`
+  - Partial hashes: `mjd4pjuj`
+
+  The hive tools already had smart ID resolution - we just needed to stop blocking it at the schema level.
+
+## 0.31.2
+
+### Patch Changes
+
+- [`d5ec86e`](https://github.com/joelhooks/swarm-tools/commit/d5ec86e77bdb1cd06cf168946aaaff91208dfac1) Thanks [@joelhooks](https://github.com/joelhooks)! - Rebuild with fixed swarm-mail dependency (bigint date fix)
+
 ## 0.31.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.31.1",
+  "version": "0.31.3",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",

package/src/hive.integration.test.ts

@@ -662,6 +662,39 @@ describe("beads integration", () => {
       }
     });
 
+    it("short hashes work with all ID-taking tools", async () => {
+      // Use last 6-8 chars of hash (or full hash if short)
+      const shortHash = hash.substring(Math.max(0, hash.length - 8));
+      
+      try {
+        // Test hive_update
+        await hive_update.execute(
+          { id: shortHash, description: "Updated via short hash" },
+          mockContext,
+        );
+
+        // Test hive_start
+        await hive_start.execute({ id: shortHash }, mockContext);
+
+        // Test hive_close  
+        const result = await hive_close.execute(
+          { id: shortHash, reason: "Closed via short hash" },
+          mockContext,
+        );
+
+        expect(result).toContain("Closed");
+        expect(result).toContain(fullId);
+      } catch (error) {
+        // If ambiguous, verify error message is helpful
+        if (error instanceof Error && error.message.includes("Ambiguous")) {
+          expect(error.message).toMatch(/ambiguous.*multiple/i);
+          expect(error.message).toContain(shortHash);
+        } else {
+          throw error;
+        }
+      }
+    });
+
     describe("hive_update", () => {
       it("accepts full cell ID (no resolution needed)", async () => {
         const result = await hive_update.execute(

package/src/schemas/worker-handoff.test.ts

@@ -81,9 +81,9 @@ describe("WorkerHandoffContractSchema", () => {
     }
   });
 
-  test("invalid task_id format fails", () => {
+  test("empty task_id fails", () => {
     const invalidContract = {
-      task_id: "invalid-format", // Missing hash component
+      task_id: "", // Empty string not allowed
       files_owned: ["src/auth.ts"],
       files_readonly: [],
       dependencies_completed: [],
@@ -92,6 +92,37 @@ describe("WorkerHandoffContractSchema", () => {
 
     const result = WorkerHandoffContractSchema.safeParse(invalidContract);
     expect(result.success).toBe(false);
+    if (!result.success) {
+      expect(result.error.issues[0].message).toContain("cannot be empty");
+    }
+  });
+
+  test("short project name with hash is valid", () => {
+    // Regression test: single-word project names like "swarm-lf2p4u-abc123" should work
+    const shortProjectContract = {
+      task_id: "swarm-lf2p4u-abc123", // Only 2 segments before timestamp
+      files_owned: ["src/auth.ts"],
+      files_readonly: [],
+      dependencies_completed: [],
+      success_criteria: ["Auth works"],
+    };
+
+    const result = WorkerHandoffContractSchema.safeParse(shortProjectContract);
+    expect(result.success).toBe(true);
+  });
+
+  test("partial hash is valid (resolvePartialId will expand it)", () => {
+    // Partial hashes should be accepted - resolvePartialId will expand them
+    const partialHashContract = {
+      task_id: "mjd4pjuj", // Short hash only
+      files_owned: ["src/auth.ts"],
+      files_readonly: [],
+      dependencies_completed: [],
+      success_criteria: ["Auth works"],
+    };
+
+    const result = WorkerHandoffContractSchema.safeParse(partialHashContract);
+    expect(result.success).toBe(true);
   });
 });
 

package/src/schemas/worker-handoff.ts

@@ -18,17 +18,17 @@ import { z } from "zod";
 export const WorkerHandoffContractSchema = z.object({
   /**
    * Cell ID for this subtask.
-   * Format: `{project}-{hash}` or `{project}-{hash}.{index}`
-   * Example: `opencode-swarm-monorepo-lf2p4u-abc123`
+   * Can be a full cell ID, hash, or partial hash.
+   * Examples: 
+   * - Full ID: `opencode-swarm-monorepo-lf2p4u-abc123`
+   * - Hash only: `lf2p4u`
+   * - Partial hash: `mjd4pjuj`
    *
-   * Requires at least 3 segments (project can be multi-word, must have hash).
+   * The hive tools use resolvePartialId() to expand short IDs before lookup.
    */
   task_id: z
     .string()
-    .regex(
-      /^[a-z0-9]+(-[a-z0-9]+){2,}(\.[\w-]+)?$/,
-      "Invalid task ID format (expected: project-slug-hash with minimum 3 segments)",
-    ),
+    .min(1, "Task ID cannot be empty"),
 
   /**
    * Files this worker owns (exclusive write access).