opencode-swarm-plugin 0.36.0 → 0.37.0

package/CHANGELOG.md

@@ -1,5 +1,118 @@
 # opencode-swarm-plugin
 
+## 0.37.0
+
+### Minor Changes
+
+- [`66b5795`](https://github.com/joelhooks/swarm-tools/commit/66b57951e2c114702c663b98829d5f7626607a16) Thanks [@joelhooks](https://github.com/joelhooks)! - ## 🐝 `swarm cells` - Query Your Hive Like a Pro
+
+  New CLI command AND plugin tool for querying cells directly from the database.
+
+  ### CLI: `swarm cells`
+
+  ```bash
+  swarm cells                      # List all cells (table format)
+  swarm cells --status open        # Filter by status
+  swarm cells --type bug           # Filter by type
+  swarm cells --ready              # Next unblocked cell
+  swarm cells mjkmd                # Partial ID lookup
+  swarm cells --json               # Raw JSON for scripting
+  ```
+
+  **Replaces:** The awkward `swarm tool hive_query --json '{"status":"open"}'` pattern.
+
+  ### Plugin Tool: `hive_cells`
+
+  ```typescript
+  // Agents can now query cells directly
+  hive_cells({ status: "open", type: "task" });
+  hive_cells({ id: "mjkmd" }); // Partial ID works!
+  hive_cells({ ready: true }); // Next unblocked
+  ```
+
+  **Why this matters:**
+
+  - Reads from DATABASE (fast, indexed) not JSONL files
+  - Partial ID resolution built-in
+  - Consistent JSON array output
+  - Rich descriptions encourage agentic use
+
+  ### Also Fixed
+
+  - `swarm_review_feedback` tests updated for coordinator-driven retry architecture
+  - 425 tests passing
+
+## 0.36.1
+
+### Patch Changes
+
+- [`9c1f3f3`](https://github.com/joelhooks/swarm-tools/commit/9c1f3f3e7204f02c133c4a036fa34e83d8376a8c) Thanks [@joelhooks](https://github.com/joelhooks)! - ## 🐝 Coordinator Discipline: Prohibition-First Enforcement
+
+  Coordinators kept "just doing it themselves" after compaction. Now they can't.
+
+  **The Problem:**
+  After context compaction, coordinators would ignore their own instructions to "spawn workers for remaining subtasks" and edit files directly. The compaction context was narrative ("do this") rather than prescriptive ("NEVER do that").
+
+  **The Fix:**
+
+  ### 1. Prohibition-First Compaction Context
+
+  The `SWARM_COMPACTION_CONTEXT` now leads with explicit anti-patterns:
+
+  ```markdown
+  ### ⛔ NEVER DO THESE (Coordinator Anti-Patterns)
+
+  - ❌ **NEVER** use `edit` or `write` tools - SPAWN A WORKER
+  - ❌ **NEVER** run tests with `bash` - SPAWN A WORKER
+  - ❌ **NEVER** implement features yourself - SPAWN A WORKER
+  - ❌ **NEVER** "just do it myself to save time" - NO. SPAWN A WORKER.
+  ```
+
+  ### 2. Runtime Violation Detection
+
+  `detectCoordinatorViolation()` is now wired up in `tool.execute.before`:
+
+  - Detects when coordinators call `edit`, `write`, or test commands
+  - Emits warnings to help coordinators self-correct
+  - Captures VIOLATION events for post-hoc analysis
+
+  ### 3. Coordinator Context Tracking
+
+  New functions track when we're in coordinator mode:
+
+  - `setCoordinatorContext()` - Activated when `hive_create_epic` or `swarm_decompose` is called
+  - `isInCoordinatorContext()` - Checks if we're currently coordinating
+  - `clearCoordinatorContext()` - Cleared when epic is closed
+
+  **Why This Matters:**
+
+  Coordinators that do implementation work burn context, create conflicts, and defeat the purpose of swarm coordination. This fix makes the anti-pattern visible and provides guardrails to prevent it.
+
+  **Validation:**
+
+  - Check `~/.config/swarm-tools/sessions/` for VIOLATION events
+  - Run `coordinator-behavior.eval.ts` to score coordinator discipline
+
+- [`4c23c7a`](https://github.com/joelhooks/swarm-tools/commit/4c23c7a31013bc6537d83a9294b51540056cde93) Thanks [@joelhooks](https://github.com/joelhooks)! - ## Fix Double Hook Registration
+
+  The compaction hook was firing twice per compaction event because OpenCode's plugin loader
+  calls ALL exports as plugin functions. We were exporting `SwarmPlugin` as both:
+
+  1. Named export: `export const SwarmPlugin`
+  2. Default export: `export default SwarmPlugin`
+
+  This caused the plugin to register twice, doubling all hook invocations.
+
+  **Fix:** Changed to default-only export pattern:
+
+  - `src/index.ts`: `const SwarmPlugin` (no export keyword)
+  - `src/plugin.ts`: `export default SwarmPlugin` (no named re-export)
+
+  **Impact:** Compaction hooks now fire once. LLM calls during compaction reduced by 50%.
+
+- Updated dependencies [[`e0c422d`](https://github.com/joelhooks/swarm-tools/commit/e0c422de3f5e15c117cc0cc655c0b03242245be4), [`43c8c93`](https://github.com/joelhooks/swarm-tools/commit/43c8c93ef90b2f04ce59317192334f69d7c4204e)]:
+  - swarm-mail@1.5.1
+
 ## 0.36.0
 
 ### Minor Changes

package/bin/swarm.test.ts

@@ -197,6 +197,112 @@ READ-ONLY research agent. Never modifies code - only gathers intel and stores fi
 // Log Command Tests (TDD)
 // ============================================================================
 
+// ============================================================================
+// Cells Command Tests (TDD)
+// ============================================================================
+
+/**
+ * Format cells as table output
+ */
+function formatCellsTable(cells: Array<{
+  id: string;
+  title: string;
+  status: string;
+  priority: number;
+}>): string {
+  if (cells.length === 0) {
+    return "No cells found";
+  }
+
+  const rows = cells.map(c => ({
+    id: c.id,
+    title: c.title.length > 50 ? c.title.slice(0, 47) + "..." : c.title,
+    status: c.status,
+    priority: String(c.priority),
+  }));
+
+  // Calculate column widths
+  const widths = {
+    id: Math.max(2, ...rows.map(r => r.id.length)),
+    title: Math.max(5, ...rows.map(r => r.title.length)),
+    status: Math.max(6, ...rows.map(r => r.status.length)),
+    priority: Math.max(8, ...rows.map(r => r.priority.length)),
+  };
+
+  // Build header
+  const header = [
+    "ID".padEnd(widths.id),
+    "TITLE".padEnd(widths.title),
+    "STATUS".padEnd(widths.status),
+    "PRIORITY".padEnd(widths.priority),
+  ].join("  ");
+
+  const separator = "-".repeat(header.length);
+
+  // Build rows
+  const bodyRows = rows.map(r =>
+    [
+      r.id.padEnd(widths.id),
+      r.title.padEnd(widths.title),
+      r.status.padEnd(widths.status),
+      r.priority.padEnd(widths.priority),
+    ].join("  ")
+  );
+
+  return [header, separator, ...bodyRows].join("\n");
+}
+
+describe("Cells command", () => {
+  describe("formatCellsTable", () => {
+    test("formats cells as table with id, title, status, priority", () => {
+      const cells = [
+        {
+          id: "test-abc123-xyz",
+          title: "Fix bug",
+          status: "open",
+          priority: 0,
+          type: "bug",
+          created_at: 1234567890,
+          updated_at: 1234567890,
+        },
+        {
+          id: "test-def456-abc",
+          title: "Add feature",
+          status: "in_progress",
+          priority: 2,
+          type: "feature",
+          created_at: 1234567890,
+          updated_at: 1234567890,
+        },
+      ];
+
+      const table = formatCellsTable(cells);
+
+      // Should contain headers
+      expect(table).toContain("ID");
+      expect(table).toContain("TITLE");
+      expect(table).toContain("STATUS");
+      expect(table).toContain("PRIORITY");
+
+      // Should contain cell data
+      expect(table).toContain("test-abc123-xyz");
+      expect(table).toContain("Fix bug");
+      expect(table).toContain("open");
+      expect(table).toContain("0");
+
+      expect(table).toContain("test-def456-abc");
+      expect(table).toContain("Add feature");
+      expect(table).toContain("in_progress");
+      expect(table).toContain("2");
+    });
+
+    test("returns 'No cells found' for empty array", () => {
+      const table = formatCellsTable([]);
+      expect(table).toBe("No cells found");
+    });
+  });
+});
+
 describe("Log command helpers", () => {
   let testDir: string;