opencode-swarm-plugin 0.43.0 → 0.44.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/bin/cass.characterization.test.ts +422 -0
  2. package/bin/swarm.serve.test.ts +6 -4
  3. package/bin/swarm.test.ts +68 -0
  4. package/bin/swarm.ts +81 -8
  5. package/dist/compaction-prompt-scoring.js +139 -0
  6. package/dist/contributor-tools.d.ts +42 -0
  7. package/dist/contributor-tools.d.ts.map +1 -0
  8. package/dist/eval-capture.js +12811 -0
  9. package/dist/hive.d.ts.map +1 -1
  10. package/dist/index.d.ts +12 -0
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +7728 -62590
  13. package/dist/plugin.js +23833 -78695
  14. package/dist/sessions/agent-discovery.d.ts +59 -0
  15. package/dist/sessions/agent-discovery.d.ts.map +1 -0
  16. package/dist/sessions/index.d.ts +10 -0
  17. package/dist/sessions/index.d.ts.map +1 -0
  18. package/dist/swarm-orchestrate.d.ts.map +1 -1
  19. package/dist/swarm-prompts.d.ts.map +1 -1
  20. package/dist/swarm-review.d.ts.map +1 -1
  21. package/package.json +17 -5
  22. package/.changeset/swarm-insights-data-layer.md +0 -63
  23. package/.hive/analysis/eval-failure-analysis-2025-12-25.md +0 -331
  24. package/.hive/analysis/session-data-quality-audit.md +0 -320
  25. package/.hive/eval-results.json +0 -483
  26. package/.hive/issues.jsonl +0 -138
  27. package/.hive/memories.jsonl +0 -729
  28. package/.opencode/eval-history.jsonl +0 -327
  29. package/.turbo/turbo-build.log +0 -9
  30. package/CHANGELOG.md +0 -2255
  31. package/SCORER-ANALYSIS.md +0 -598
  32. package/docs/analysis/subagent-coordination-patterns.md +0 -902
  33. package/docs/analysis-socratic-planner-pattern.md +0 -504
  34. package/docs/planning/ADR-001-monorepo-structure.md +0 -171
  35. package/docs/planning/ADR-002-package-extraction.md +0 -393
  36. package/docs/planning/ADR-003-performance-improvements.md +0 -451
  37. package/docs/planning/ADR-004-message-queue-features.md +0 -187
  38. package/docs/planning/ADR-005-devtools-observability.md +0 -202
  39. package/docs/planning/ADR-007-swarm-enhancements-worktree-review.md +0 -168
  40. package/docs/planning/ADR-008-worker-handoff-protocol.md +0 -293
  41. package/docs/planning/ADR-009-oh-my-opencode-patterns.md +0 -353
  42. package/docs/planning/ROADMAP.md +0 -368
  43. package/docs/semantic-memory-cli-syntax.md +0 -123
  44. package/docs/swarm-mail-architecture.md +0 -1147
  45. package/docs/testing/context-recovery-test.md +0 -470
  46. package/evals/ARCHITECTURE.md +0 -1189
  47. package/evals/README.md +0 -768
  48. package/evals/compaction-prompt.eval.ts +0 -149
  49. package/evals/compaction-resumption.eval.ts +0 -289
  50. package/evals/coordinator-behavior.eval.ts +0 -307
  51. package/evals/coordinator-session.eval.ts +0 -154
  52. package/evals/evalite.config.ts.bak +0 -15
  53. package/evals/example.eval.ts +0 -31
  54. package/evals/fixtures/compaction-cases.ts +0 -350
  55. package/evals/fixtures/compaction-prompt-cases.ts +0 -311
  56. package/evals/fixtures/coordinator-sessions.ts +0 -328
  57. package/evals/fixtures/decomposition-cases.ts +0 -105
  58. package/evals/lib/compaction-loader.test.ts +0 -248
  59. package/evals/lib/compaction-loader.ts +0 -320
  60. package/evals/lib/data-loader.evalite-test.ts +0 -289
  61. package/evals/lib/data-loader.test.ts +0 -345
  62. package/evals/lib/data-loader.ts +0 -281
  63. package/evals/lib/llm.ts +0 -115
  64. package/evals/scorers/compaction-prompt-scorers.ts +0 -145
  65. package/evals/scorers/compaction-scorers.ts +0 -305
  66. package/evals/scorers/coordinator-discipline.evalite-test.ts +0 -539
  67. package/evals/scorers/coordinator-discipline.ts +0 -325
  68. package/evals/scorers/index.test.ts +0 -146
  69. package/evals/scorers/index.ts +0 -328
  70. package/evals/scorers/outcome-scorers.evalite-test.ts +0 -27
  71. package/evals/scorers/outcome-scorers.ts +0 -349
  72. package/evals/swarm-decomposition.eval.ts +0 -121
  73. package/examples/commands/swarm.md +0 -745
  74. package/examples/plugin-wrapper-template.ts +0 -2426
  75. package/examples/skills/hive-workflow/SKILL.md +0 -212
  76. package/examples/skills/skill-creator/SKILL.md +0 -223
  77. package/examples/skills/swarm-coordination/SKILL.md +0 -292
  78. package/global-skills/cli-builder/SKILL.md +0 -344
  79. package/global-skills/cli-builder/references/advanced-patterns.md +0 -244
  80. package/global-skills/learning-systems/SKILL.md +0 -644
  81. package/global-skills/skill-creator/LICENSE.txt +0 -202
  82. package/global-skills/skill-creator/SKILL.md +0 -352
  83. package/global-skills/skill-creator/references/output-patterns.md +0 -82
  84. package/global-skills/skill-creator/references/workflows.md +0 -28
  85. package/global-skills/swarm-coordination/SKILL.md +0 -995
  86. package/global-skills/swarm-coordination/references/coordinator-patterns.md +0 -235
  87. package/global-skills/swarm-coordination/references/strategies.md +0 -138
  88. package/global-skills/system-design/SKILL.md +0 -213
  89. package/global-skills/testing-patterns/SKILL.md +0 -430
  90. package/global-skills/testing-patterns/references/dependency-breaking-catalog.md +0 -586
  91. package/opencode-swarm-plugin-0.30.7.tgz +0 -0
  92. package/opencode-swarm-plugin-0.31.0.tgz +0 -0
  93. package/scripts/cleanup-test-memories.ts +0 -346
  94. package/scripts/init-skill.ts +0 -222
  95. package/scripts/migrate-unknown-sessions.ts +0 -349
  96. package/scripts/validate-skill.ts +0 -204
  97. package/src/agent-mail.ts +0 -1724
  98. package/src/anti-patterns.test.ts +0 -1167
  99. package/src/anti-patterns.ts +0 -448
  100. package/src/compaction-capture.integration.test.ts +0 -257
  101. package/src/compaction-hook.test.ts +0 -838
  102. package/src/compaction-hook.ts +0 -1204
  103. package/src/compaction-observability.integration.test.ts +0 -139
  104. package/src/compaction-observability.test.ts +0 -187
  105. package/src/compaction-observability.ts +0 -324
  106. package/src/compaction-prompt-scorers.test.ts +0 -475
  107. package/src/compaction-prompt-scoring.ts +0 -300
  108. package/src/dashboard.test.ts +0 -611
  109. package/src/dashboard.ts +0 -462
  110. package/src/error-enrichment.test.ts +0 -403
  111. package/src/error-enrichment.ts +0 -219
  112. package/src/eval-capture.test.ts +0 -1015
  113. package/src/eval-capture.ts +0 -929
  114. package/src/eval-gates.test.ts +0 -306
  115. package/src/eval-gates.ts +0 -218
  116. package/src/eval-history.test.ts +0 -508
  117. package/src/eval-history.ts +0 -214
  118. package/src/eval-learning.test.ts +0 -378
  119. package/src/eval-learning.ts +0 -360
  120. package/src/eval-runner.test.ts +0 -223
  121. package/src/eval-runner.ts +0 -402
  122. package/src/export-tools.test.ts +0 -476
  123. package/src/export-tools.ts +0 -257
  124. package/src/hive.integration.test.ts +0 -2241
  125. package/src/hive.ts +0 -1628
  126. package/src/index.ts +0 -935
  127. package/src/learning.integration.test.ts +0 -1815
  128. package/src/learning.ts +0 -1079
  129. package/src/logger.test.ts +0 -189
  130. package/src/logger.ts +0 -135
  131. package/src/mandate-promotion.test.ts +0 -473
  132. package/src/mandate-promotion.ts +0 -239
  133. package/src/mandate-storage.integration.test.ts +0 -601
  134. package/src/mandate-storage.test.ts +0 -578
  135. package/src/mandate-storage.ts +0 -794
  136. package/src/mandates.ts +0 -540
  137. package/src/memory-tools.test.ts +0 -195
  138. package/src/memory-tools.ts +0 -344
  139. package/src/memory.integration.test.ts +0 -334
  140. package/src/memory.test.ts +0 -158
  141. package/src/memory.ts +0 -527
  142. package/src/model-selection.test.ts +0 -188
  143. package/src/model-selection.ts +0 -68
  144. package/src/observability-tools.test.ts +0 -359
  145. package/src/observability-tools.ts +0 -871
  146. package/src/output-guardrails.test.ts +0 -438
  147. package/src/output-guardrails.ts +0 -381
  148. package/src/pattern-maturity.test.ts +0 -1160
  149. package/src/pattern-maturity.ts +0 -525
  150. package/src/planning-guardrails.test.ts +0 -491
  151. package/src/planning-guardrails.ts +0 -438
  152. package/src/plugin.ts +0 -23
  153. package/src/post-compaction-tracker.test.ts +0 -251
  154. package/src/post-compaction-tracker.ts +0 -237
  155. package/src/query-tools.test.ts +0 -636
  156. package/src/query-tools.ts +0 -324
  157. package/src/rate-limiter.integration.test.ts +0 -466
  158. package/src/rate-limiter.ts +0 -774
  159. package/src/replay-tools.test.ts +0 -496
  160. package/src/replay-tools.ts +0 -240
  161. package/src/repo-crawl.integration.test.ts +0 -441
  162. package/src/repo-crawl.ts +0 -610
  163. package/src/schemas/cell-events.test.ts +0 -347
  164. package/src/schemas/cell-events.ts +0 -807
  165. package/src/schemas/cell.ts +0 -257
  166. package/src/schemas/evaluation.ts +0 -166
  167. package/src/schemas/index.test.ts +0 -199
  168. package/src/schemas/index.ts +0 -286
  169. package/src/schemas/mandate.ts +0 -232
  170. package/src/schemas/swarm-context.ts +0 -115
  171. package/src/schemas/task.ts +0 -161
  172. package/src/schemas/worker-handoff.test.ts +0 -302
  173. package/src/schemas/worker-handoff.ts +0 -131
  174. package/src/skills.integration.test.ts +0 -1192
  175. package/src/skills.test.ts +0 -643
  176. package/src/skills.ts +0 -1549
  177. package/src/storage.integration.test.ts +0 -341
  178. package/src/storage.ts +0 -884
  179. package/src/structured.integration.test.ts +0 -817
  180. package/src/structured.test.ts +0 -1046
  181. package/src/structured.ts +0 -762
  182. package/src/swarm-decompose.test.ts +0 -188
  183. package/src/swarm-decompose.ts +0 -1302
  184. package/src/swarm-deferred.integration.test.ts +0 -157
  185. package/src/swarm-deferred.test.ts +0 -38
  186. package/src/swarm-insights.test.ts +0 -214
  187. package/src/swarm-insights.ts +0 -459
  188. package/src/swarm-mail.integration.test.ts +0 -970
  189. package/src/swarm-mail.ts +0 -739
  190. package/src/swarm-orchestrate.integration.test.ts +0 -282
  191. package/src/swarm-orchestrate.test.ts +0 -548
  192. package/src/swarm-orchestrate.ts +0 -3084
  193. package/src/swarm-prompts.test.ts +0 -1270
  194. package/src/swarm-prompts.ts +0 -2077
  195. package/src/swarm-research.integration.test.ts +0 -701
  196. package/src/swarm-research.test.ts +0 -698
  197. package/src/swarm-research.ts +0 -472
  198. package/src/swarm-review.integration.test.ts +0 -285
  199. package/src/swarm-review.test.ts +0 -879
  200. package/src/swarm-review.ts +0 -709
  201. package/src/swarm-strategies.ts +0 -407
  202. package/src/swarm-worktree.test.ts +0 -501
  203. package/src/swarm-worktree.ts +0 -575
  204. package/src/swarm.integration.test.ts +0 -2377
  205. package/src/swarm.ts +0 -38
  206. package/src/tool-adapter.integration.test.ts +0 -1221
  207. package/src/tool-availability.ts +0 -461
  208. package/tsconfig.json +0 -28
@@ -1,838 +0,0 @@
1
- /**
2
- * Tests for Swarm-Aware Compaction Hook
3
- */
4
-
5
- import { describe, expect, it, mock, beforeEach } from "bun:test";
6
- import {
7
- SWARM_COMPACTION_CONTEXT,
8
- SWARM_DETECTION_FALLBACK,
9
- createCompactionHook,
10
- scanSessionMessages,
11
- type ScannedSwarmState,
12
- } from "./compaction-hook";
13
-
14
- // Track log calls for verification
15
- let logCalls: Array<{ level: string; data: any; message?: string }> = [];
16
-
17
- // Mock logger factory
18
- const createMockLogger = () => ({
19
- info: (data: any, message?: string) => {
20
- logCalls.push({ level: "info", data, message });
21
- },
22
- debug: (data: any, message?: string) => {
23
- logCalls.push({ level: "debug", data, message });
24
- },
25
- warn: (data: any, message?: string) => {
26
- logCalls.push({ level: "warn", data, message });
27
- },
28
- error: (data: any, message?: string) => {
29
- logCalls.push({ level: "error", data, message });
30
- },
31
- });
32
-
33
- // Mock the dependencies
34
- mock.module("./hive", () => ({
35
- getHiveWorkingDirectory: () => "/test/project",
36
- getHiveAdapter: async () => ({
37
- queryCells: async () => [],
38
- }),
39
- }));
40
-
41
- mock.module("swarm-mail", () => ({
42
- checkSwarmHealth: async () => ({
43
- healthy: true,
44
- database: "connected",
45
- stats: {
46
- events: 0,
47
- agents: 0,
48
- messages: 0,
49
- reservations: 0,
50
- },
51
- }),
52
- }));
53
-
54
- // Mock logger module
55
- mock.module("./logger", () => ({
56
- createChildLogger: () => createMockLogger(),
57
- }));
58
-
59
- describe("Compaction Hook", () => {
60
- beforeEach(() => {
61
- // Reset log calls before each test
62
- logCalls = [];
63
- });
64
- describe("SWARM_COMPACTION_CONTEXT", () => {
65
- it("contains coordinator instructions", () => {
66
- expect(SWARM_COMPACTION_CONTEXT).toContain("COORDINATOR");
67
- expect(SWARM_COMPACTION_CONTEXT).toContain("YOU ARE THE COORDINATOR");
68
- });
69
-
70
- it("contains prohibition-first anti-patterns", () => {
71
- expect(SWARM_COMPACTION_CONTEXT).toContain("NEVER");
72
- expect(SWARM_COMPACTION_CONTEXT).toContain("edit");
73
- expect(SWARM_COMPACTION_CONTEXT).toContain("write");
74
- expect(SWARM_COMPACTION_CONTEXT).toContain("SPAWN A WORKER");
75
- });
76
-
77
- it("contains resume instructions", () => {
78
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_status");
79
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarmmail_inbox");
80
- });
81
-
82
- it("contains summary format", () => {
83
- expect(SWARM_COMPACTION_CONTEXT).toContain("Swarm State");
84
- expect(SWARM_COMPACTION_CONTEXT).toContain("Active:");
85
- expect(SWARM_COMPACTION_CONTEXT).toContain("Blocked:");
86
- expect(SWARM_COMPACTION_CONTEXT).toContain("Completed:");
87
- });
88
-
89
- // NEW: Full coordinator workflow must be present post-compaction
90
- it("contains FULL coordinator workflow phases", () => {
91
- // Phase 1.5: Research Phase
92
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_spawn_researcher");
93
-
94
- // Phase 3: Decompose
95
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_select_strategy");
96
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_plan_prompt");
97
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_validate_decomposition");
98
-
99
- // Phase 4: Create Cells
100
- expect(SWARM_COMPACTION_CONTEXT).toContain("hive_create_epic");
101
-
102
- // Phase 6: Spawn Workers
103
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_spawn_subtask");
104
-
105
- // Phase 7: Review Loop
106
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_review");
107
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_review_feedback");
108
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_spawn_retry");
109
- });
110
-
111
- it("contains forbidden tools section with ALL forbidden tools", () => {
112
- // Repository fetching
113
- expect(SWARM_COMPACTION_CONTEXT).toContain("repo-crawl_file");
114
- expect(SWARM_COMPACTION_CONTEXT).toContain("repo-autopsy");
115
-
116
- // Web/documentation fetching
117
- expect(SWARM_COMPACTION_CONTEXT).toContain("webfetch");
118
- expect(SWARM_COMPACTION_CONTEXT).toContain("fetch_fetch");
119
- expect(SWARM_COMPACTION_CONTEXT).toContain("context7");
120
-
121
- // Knowledge base
122
- expect(SWARM_COMPACTION_CONTEXT).toContain("pdf-brain");
123
- });
124
-
125
- it("contains strategy reference table", () => {
126
- expect(SWARM_COMPACTION_CONTEXT).toContain("file-based");
127
- expect(SWARM_COMPACTION_CONTEXT).toContain("feature-based");
128
- expect(SWARM_COMPACTION_CONTEXT).toContain("risk-based");
129
- });
130
- });
131
-
132
- describe("SWARM_DETECTION_FALLBACK", () => {
133
- it("contains detection patterns", () => {
134
- expect(SWARM_DETECTION_FALLBACK).toContain("swarm_decompose");
135
- expect(SWARM_DETECTION_FALLBACK).toContain("swarmmail_init");
136
- expect(SWARM_DETECTION_FALLBACK).toContain("hive_create_epic");
137
- });
138
-
139
- it("contains ID patterns", () => {
140
- expect(SWARM_DETECTION_FALLBACK).toContain("bd-xxx");
141
- expect(SWARM_DETECTION_FALLBACK).toContain("Agent names");
142
- });
143
-
144
- it("contains coordination language", () => {
145
- expect(SWARM_DETECTION_FALLBACK).toContain("spawn");
146
- expect(SWARM_DETECTION_FALLBACK).toContain("coordinator");
147
- expect(SWARM_DETECTION_FALLBACK).toContain("reservation");
148
- });
149
- });
150
-
151
- describe("createCompactionHook", () => {
152
- it("returns a function", () => {
153
- const hook = createCompactionHook();
154
- expect(typeof hook).toBe("function");
155
- });
156
-
157
- it("accepts input and output parameters", async () => {
158
- const hook = createCompactionHook();
159
- const input = { sessionID: "test-session" };
160
- const output = { context: [] as string[] };
161
-
162
- // Should not throw
163
- await hook(input, output);
164
- });
165
-
166
- it("does not inject context when no swarm detected", async () => {
167
- const hook = createCompactionHook();
168
- const output = { context: [] as string[] };
169
-
170
- await hook({ sessionID: "test" }, output);
171
-
172
- // With mocked empty data, should not inject
173
- expect(output.context.length).toBe(0);
174
- });
175
- });
176
-
177
- describe("Detection confidence levels", () => {
178
- it("HIGH confidence triggers full context", async () => {
179
- // This would need proper mocking of active reservations
180
- // For now, just verify the context strings exist
181
- expect(SWARM_COMPACTION_CONTEXT).toContain("YOU ARE THE COORDINATOR");
182
- });
183
-
184
- it("LOW confidence triggers fallback prompt", async () => {
185
- expect(SWARM_DETECTION_FALLBACK).toContain("Swarm Detection");
186
- expect(SWARM_DETECTION_FALLBACK).toContain("Check Your Context");
187
- });
188
- });
189
-
190
- describe("Forbidden tools anti-pattern (TDD red phase)", () => {
191
- it("SWARM_COMPACTION_CONTEXT includes 'NEVER fetch directly' rule", () => {
192
- // Should warn against direct fetching
193
- expect(SWARM_COMPACTION_CONTEXT).toContain("NEVER");
194
- expect(SWARM_COMPACTION_CONTEXT).toContain("repo-crawl");
195
- expect(SWARM_COMPACTION_CONTEXT).toContain("webfetch");
196
- expect(SWARM_COMPACTION_CONTEXT).toContain("fetch_fetch");
197
- expect(SWARM_COMPACTION_CONTEXT).toContain("context7");
198
- expect(SWARM_COMPACTION_CONTEXT).toContain("pdf-brain");
199
- });
200
-
201
- it("SWARM_COMPACTION_CONTEXT instructs to spawn researcher instead", () => {
202
- expect(SWARM_COMPACTION_CONTEXT).toContain("SPAWN A RESEARCHER");
203
- expect(SWARM_COMPACTION_CONTEXT).toContain("swarm_spawn_researcher");
204
- });
205
-
206
- it("lists all forbidden repo-crawl tools", () => {
207
- const forbiddenTools = [
208
- "repo-crawl_file",
209
- "repo-crawl_readme",
210
- "repo-crawl_search",
211
- "repo-crawl_structure",
212
- "repo-crawl_tree"
213
- ];
214
-
215
- for (const tool of forbiddenTools) {
216
- expect(SWARM_COMPACTION_CONTEXT).toContain(tool);
217
- }
218
- });
219
-
220
- it("lists all forbidden repo-autopsy tools", () => {
221
- expect(SWARM_COMPACTION_CONTEXT).toContain("repo-autopsy");
222
- });
223
-
224
- it("lists all forbidden context7 tools", () => {
225
- const forbiddenTools = [
226
- "context7_resolve-library-id",
227
- "context7_get-library-docs"
228
- ];
229
-
230
- for (const tool of forbiddenTools) {
231
- expect(SWARM_COMPACTION_CONTEXT).toContain(tool);
232
- }
233
- });
234
-
235
- it("lists all forbidden pdf-brain tools", () => {
236
- const forbiddenTools = [
237
- "pdf-brain_search",
238
- "pdf-brain_read"
239
- ];
240
-
241
- for (const tool of forbiddenTools) {
242
- expect(SWARM_COMPACTION_CONTEXT).toContain(tool);
243
- }
244
- });
245
- });
246
-
247
- describe("Coordinator identity reinforcement (TDD red phase)", () => {
248
- it("includes ASCII header for coordinator identity", () => {
249
- // Should have prominent visual indicator
250
- expect(SWARM_COMPACTION_CONTEXT).toMatch(/[╔═╗║╚╝]|[┌─┐│└┘]|[█▀▄]/);
251
- });
252
-
253
- it("repeats 'YOU ARE THE COORDINATOR' multiple times", () => {
254
- const matches = SWARM_COMPACTION_CONTEXT.match(/YOU ARE THE COORDINATOR/gi);
255
- expect(matches).toBeDefined();
256
- expect(matches!.length).toBeGreaterThanOrEqual(2);
257
- });
258
-
259
- it("uses strong imperative language NEVER/ALWAYS/NON-NEGOTIABLE", () => {
260
- expect(SWARM_COMPACTION_CONTEXT).toContain("NEVER");
261
- expect(SWARM_COMPACTION_CONTEXT).toContain("ALWAYS");
262
- expect(SWARM_COMPACTION_CONTEXT).toContain("NON-NEGOTIABLE");
263
- });
264
-
265
- it("makes role unmistakable with multiple strong statements", () => {
266
- // Check for strong coordinator identity statements
267
- const identityPatterns = [
268
- /YOU ARE THE COORDINATOR/i,
269
- /NOT A WORKER/i,
270
- /ORCHESTRATE/i,
271
- /DO NOT IMPLEMENT/i
272
- ];
273
-
274
- let matchCount = 0;
275
- for (const pattern of identityPatterns) {
276
- if (pattern.test(SWARM_COMPACTION_CONTEXT)) {
277
- matchCount++;
278
- }
279
- }
280
-
281
- expect(matchCount).toBeGreaterThanOrEqual(3);
282
- });
283
- });
284
-
285
- describe("Specific swarm state injection (TDD red phase)", () => {
286
- it("includes specific epic ID when in_progress epic exists", async () => {
287
- // Mock hive with an in_progress epic
288
- mock.module("./hive", () => ({
289
- getHiveWorkingDirectory: () => "/test/project",
290
- getHiveAdapter: async () => ({
291
- queryCells: async () => [
292
- {
293
- id: "bd-epic-123",
294
- title: "Add authentication system",
295
- type: "epic",
296
- status: "in_progress",
297
- parent_id: null,
298
- updated_at: Date.now(),
299
- },
300
- ],
301
- }),
302
- }));
303
-
304
- const hook = createCompactionHook();
305
- const input = { sessionID: "test-session" };
306
- const output = { context: [] as string[] };
307
-
308
- await hook(input, output);
309
-
310
- // Should inject context with the SPECIFIC epic ID, not a placeholder
311
- expect(output.context.length).toBeGreaterThan(0);
312
- const injectedContext = output.context[0];
313
- expect(injectedContext).toContain("bd-epic-123");
314
- expect(injectedContext).toContain("Add authentication system");
315
- });
316
-
317
- it("includes subtask status summary in injected context", async () => {
318
- // Mock hive with epic + subtasks in various states
319
- mock.module("./hive", () => ({
320
- getHiveWorkingDirectory: () => "/test/project",
321
- getHiveAdapter: async () => ({
322
- queryCells: async () => [
323
- {
324
- id: "bd-epic-456",
325
- title: "Refactor auth flow",
326
- type: "epic",
327
- status: "in_progress",
328
- parent_id: null,
329
- updated_at: Date.now(),
330
- },
331
- {
332
- id: "bd-epic-456.1",
333
- title: "Update schema",
334
- type: "task",
335
- status: "closed",
336
- parent_id: "bd-epic-456",
337
- updated_at: Date.now(),
338
- },
339
- {
340
- id: "bd-epic-456.2",
341
- title: "Implement service layer",
342
- type: "task",
343
- status: "in_progress",
344
- parent_id: "bd-epic-456",
345
- updated_at: Date.now(),
346
- },
347
- {
348
- id: "bd-epic-456.3",
349
- title: "Add tests",
350
- type: "task",
351
- status: "open",
352
- parent_id: "bd-epic-456",
353
- updated_at: Date.now(),
354
- },
355
- ],
356
- }),
357
- }));
358
-
359
- const hook = createCompactionHook();
360
- const input = { sessionID: "test-session" };
361
- const output = { context: [] as string[] };
362
-
363
- await hook(input, output);
364
-
365
- expect(output.context.length).toBeGreaterThan(0);
366
- const injectedContext = output.context[0];
367
-
368
- // Should show subtask counts: 1 closed, 1 in_progress, 1 open
369
- expect(injectedContext).toMatch(/1.*closed/i);
370
- expect(injectedContext).toMatch(/1.*in_progress/i);
371
- expect(injectedContext).toMatch(/1.*open/i);
372
- });
373
-
374
- it("includes project path in context", async () => {
375
- mock.module("./hive", () => ({
376
- getHiveWorkingDirectory: () => "/Users/joel/test-project",
377
- getHiveAdapter: async () => ({
378
- queryCells: async () => [
379
- {
380
- id: "bd-epic-789",
381
- title: "Feature work",
382
- type: "epic",
383
- status: "in_progress",
384
- parent_id: null,
385
- updated_at: Date.now(),
386
- },
387
- ],
388
- }),
389
- }));
390
-
391
- const hook = createCompactionHook();
392
- const input = { sessionID: "test-session" };
393
- const output = { context: [] as string[] };
394
-
395
- await hook(input, output);
396
-
397
- expect(output.context.length).toBeGreaterThan(0);
398
- const injectedContext = output.context[0];
399
-
400
- // Should include the actual project path, not a placeholder
401
- expect(injectedContext).toContain("/Users/joel/test-project");
402
- });
403
-
404
- it("includes actionable swarm_status call with epic ID", async () => {
405
- mock.module("./hive", () => ({
406
- getHiveWorkingDirectory: () => "/test/project",
407
- getHiveAdapter: async () => ({
408
- queryCells: async () => [
409
- {
410
- id: "bd-epic-999",
411
- title: "Critical fix",
412
- type: "epic",
413
- status: "in_progress",
414
- parent_id: null,
415
- updated_at: Date.now(),
416
- },
417
- ],
418
- }),
419
- }));
420
-
421
- const hook = createCompactionHook();
422
- const input = { sessionID: "test-session" };
423
- const output = { context: [] as string[] };
424
-
425
- await hook(input, output);
426
-
427
- expect(output.context.length).toBeGreaterThan(0);
428
- const injectedContext = output.context[0];
429
-
430
- // Should include actionable swarm_status call with the SPECIFIC epic ID
431
- expect(injectedContext).toContain('swarm_status(epic_id="bd-epic-999"');
432
- expect(injectedContext).toContain('project_key="/test/project"');
433
- });
434
-
435
- it("includes coordinator role reminder - NOT worker commands", async () => {
436
- // Mock an in-progress epic with subtasks
437
- mock.module("./hive", () => ({
438
- getHiveWorkingDirectory: () => "/test/project",
439
- getHiveAdapter: async () => ({
440
- queryCells: async () => [
441
- {
442
- id: "bd-epic-123",
443
- title: "Test Epic",
444
- type: "epic",
445
- status: "in_progress",
446
- parent_id: null,
447
- updated_at: Date.now(),
448
- },
449
- {
450
- id: "bd-task-1",
451
- type: "task",
452
- status: "open",
453
- parent_id: "bd-epic-123",
454
- updated_at: Date.now(),
455
- },
456
- ],
457
- }),
458
- }));
459
-
460
- const hook = createCompactionHook();
461
- const input = { sessionID: "test-session" };
462
- const output = { context: [] as string[] };
463
-
464
- await hook(input, output);
465
-
466
- expect(output.context.length).toBeGreaterThan(0);
467
- const injectedContext = output.context[0];
468
-
469
- // Should remind coordinator of their ROLE
470
- expect(injectedContext).toContain("YOU ARE THE COORDINATOR");
471
- expect(injectedContext).toContain("Spawn workers");
472
-
473
- // Should include coordinator commands
474
- expect(injectedContext).toContain("swarm_spawn_subtask");
475
- expect(injectedContext).toContain("swarm_review");
476
- });
477
- });
478
-
479
- describe("Logging instrumentation", () => {
480
- it("logs compaction start with session_id", async () => {
481
- const hook = createCompactionHook();
482
- const input = { sessionID: "test-session-123" };
483
- const output = { context: [] as string[] };
484
-
485
- await hook(input, output);
486
-
487
- const startLog = logCalls.find(
488
- (log) => log.level === "info" && log.message === "compaction started",
489
- );
490
- expect(startLog).toBeDefined();
491
- expect(startLog?.data).toHaveProperty("session_id", "test-session-123");
492
- });
493
-
494
- it("logs detection phase with confidence and reasons", async () => {
495
- const hook = createCompactionHook();
496
- const input = { sessionID: "test-session" };
497
- const output = { context: [] as string[] };
498
-
499
- await hook(input, output);
500
-
501
- const detectionLog = logCalls.find(
502
- (log) =>
503
- log.level === "debug" && log.message === "swarm detection complete",
504
- );
505
- expect(detectionLog).toBeDefined();
506
- expect(detectionLog?.data).toHaveProperty("confidence");
507
- expect(detectionLog?.data).toHaveProperty("detected");
508
- expect(detectionLog?.data).toHaveProperty("reason_count");
509
- });
510
-
511
- it("logs context injection when swarm detected", async () => {
512
- const hook = createCompactionHook();
513
- const input = { sessionID: "test-session" };
514
- const output = { context: [] as string[] };
515
-
516
- // Mock detection to return medium confidence
517
- mock.module("./hive", () => ({
518
- getHiveWorkingDirectory: () => "/test/project",
519
- getHiveAdapter: async () => ({
520
- queryCells: async () => [
521
- {
522
- id: "bd-123",
523
- type: "epic",
524
- status: "open",
525
- parent_id: null,
526
- updated_at: Date.now(),
527
- },
528
- ],
529
- }),
530
- }));
531
-
532
- await hook(input, output);
533
-
534
- const injectionLog = logCalls.find(
535
- (log) =>
536
- log.level === "info" && log.message === "injected swarm context",
537
- );
538
- expect(injectionLog).toBeDefined();
539
- expect(injectionLog?.data).toHaveProperty("confidence");
540
- expect(injectionLog?.data).toHaveProperty("context_length");
541
- });
542
-
543
- it("logs completion with duration and success", async () => {
544
- const hook = createCompactionHook();
545
- const input = { sessionID: "test-session" };
546
- const output = { context: [] as string[] };
547
-
548
- await hook(input, output);
549
-
550
- const completeLog = logCalls.find(
551
- (log) => log.level === "info" && log.message === "compaction complete",
552
- );
553
- expect(completeLog).toBeDefined();
554
- expect(completeLog?.data).toHaveProperty("duration_ms");
555
- expect(completeLog?.data.duration_ms).toBeGreaterThanOrEqual(0);
556
- expect(completeLog?.data).toHaveProperty("success", true);
557
- });
558
-
559
- it("logs detailed detection sources (hive, swarm-mail)", async () => {
560
- const hook = createCompactionHook();
561
- const input = { sessionID: "test-session" };
562
- const output = { context: [] as string[] };
563
-
564
- await hook(input, output);
565
-
566
- // Should log details about checking swarm-mail
567
- const swarmMailLog = logCalls.find(
568
- (log) => log.level === "debug" && log.message?.includes("swarm-mail"),
569
- );
570
- // Should log details about checking hive
571
- const hiveLog = logCalls.find(
572
- (log) => log.level === "debug" && log.message?.includes("hive"),
573
- );
574
-
575
- // At least one source should be checked
576
- expect(logCalls.length).toBeGreaterThan(0);
577
- });
578
-
579
- it("logs errors without throwing when detection fails", async () => {
580
- // Mock hive to throw
581
- mock.module("./hive", () => ({
582
- getHiveWorkingDirectory: () => {
583
- throw new Error("Hive not available");
584
- },
585
- getHiveAdapter: async () => {
586
- throw new Error("Hive not available");
587
- },
588
- }));
589
-
590
- const hook = createCompactionHook();
591
- const input = { sessionID: "test-session" };
592
- const output = { context: [] as string[] };
593
-
594
- // Should not throw
595
- await expect(hook(input, output)).resolves.toBeUndefined();
596
-
597
- // Should still complete successfully
598
- const completeLog = logCalls.find(
599
- (log) => log.level === "info" && log.message === "compaction complete",
600
- );
601
- expect(completeLog).toBeDefined();
602
- });
603
-
604
- it("includes context size when injecting", async () => {
605
- const hook = createCompactionHook();
606
- const input = { sessionID: "test-session" };
607
- const output = { context: [] as string[] };
608
-
609
- await hook(input, output);
610
-
611
- // If context was injected, should log the size
612
- if (output.context.length > 0) {
613
- const injectionLog = logCalls.find(
614
- (log) =>
615
- log.level === "info" && log.message === "injected swarm context",
616
- );
617
- expect(injectionLog?.data.context_length).toBeGreaterThan(0);
618
- }
619
- });
620
- });
621
-
622
- describe("scanSessionMessages", () => {
623
- it("returns empty state when client is undefined", async () => {
624
- const state = await scanSessionMessages(undefined, "test-session");
625
- expect(state.epicId).toBeUndefined();
626
- expect(state.agentName).toBeUndefined();
627
- expect(state.subtasks.size).toBe(0);
628
- });
629
-
630
- it("returns empty state when client is null", async () => {
631
- const state = await scanSessionMessages(null, "test-session");
632
- expect(state.epicId).toBeUndefined();
633
- expect(state.subtasks.size).toBe(0);
634
- });
635
-
636
- it("extracts epic data from hive_create_epic tool call", async () => {
637
- const mockClient = {
638
- session: {
639
- messages: async () => ({
640
- data: [
641
- {
642
- info: { id: "msg-1", sessionID: "test-session" },
643
- parts: [
644
- {
645
- type: "tool",
646
- tool: "hive_create_epic",
647
- state: {
648
- status: "completed",
649
- input: { epic_title: "Test Epic" },
650
- output: JSON.stringify({ epic: { id: "epic-123" } }),
651
- time: { start: 1000, end: 2000 },
652
- },
653
- },
654
- ],
655
- },
656
- ],
657
- }),
658
- },
659
- };
660
-
661
- const state = await scanSessionMessages(mockClient, "test-session");
662
- expect(state.epicId).toBe("epic-123");
663
- expect(state.epicTitle).toBe("Test Epic");
664
- });
665
-
666
- it("extracts agent name from swarmmail_init tool call", async () => {
667
- const mockClient = {
668
- session: {
669
- messages: async () => ({
670
- data: [
671
- {
672
- info: { id: "msg-1", sessionID: "test-session" },
673
- parts: [
674
- {
675
- type: "tool",
676
- tool: "swarmmail_init",
677
- state: {
678
- status: "completed",
679
- input: {},
680
- output: JSON.stringify({
681
- agent_name: "BlueLake",
682
- project_key: "/test/project",
683
- }),
684
- time: { start: 1000, end: 2000 },
685
- },
686
- },
687
- ],
688
- },
689
- ],
690
- }),
691
- },
692
- };
693
-
694
- const state = await scanSessionMessages(mockClient, "test-session");
695
- expect(state.agentName).toBe("BlueLake");
696
- expect(state.projectPath).toBe("/test/project");
697
- });
698
-
699
- it("tracks subtasks from swarm_spawn_subtask tool calls", async () => {
700
- const mockClient = {
701
- session: {
702
- messages: async () => ({
703
- data: [
704
- {
705
- info: { id: "msg-1", sessionID: "test-session" },
706
- parts: [
707
- {
708
- type: "tool",
709
- tool: "swarm_spawn_subtask",
710
- state: {
711
- status: "completed",
712
- input: {
713
- bead_id: "bd-123.1",
714
- epic_id: "epic-123",
715
- subtask_title: "Add auth",
716
- files: ["src/auth.ts"],
717
- },
718
- output: JSON.stringify({ worker: "RedMountain" }),
719
- time: { start: 1000, end: 2000 },
720
- },
721
- },
722
- ],
723
- },
724
- ],
725
- }),
726
- },
727
- };
728
-
729
- const state = await scanSessionMessages(mockClient, "test-session");
730
- expect(state.subtasks.size).toBe(1);
731
- const subtask = state.subtasks.get("bd-123.1");
732
- expect(subtask?.title).toBe("Add auth");
733
- expect(subtask?.status).toBe("spawned");
734
- expect(subtask?.worker).toBe("RedMountain");
735
- expect(subtask?.files).toEqual(["src/auth.ts"]);
736
- });
737
-
738
- it("marks subtasks as completed from swarm_complete tool calls", async () => {
739
- const mockClient = {
740
- session: {
741
- messages: async () => ({
742
- data: [
743
- {
744
- info: { id: "msg-1", sessionID: "test-session" },
745
- parts: [
746
- {
747
- type: "tool",
748
- tool: "swarm_spawn_subtask",
749
- state: {
750
- status: "completed",
751
- input: {
752
- bead_id: "bd-123.1",
753
- subtask_title: "Add auth",
754
- },
755
- output: "{}",
756
- time: { start: 1000, end: 2000 },
757
- },
758
- },
759
- {
760
- type: "tool",
761
- tool: "swarm_complete",
762
- state: {
763
- status: "completed",
764
- input: { bead_id: "bd-123.1" },
765
- output: "{}",
766
- time: { start: 3000, end: 4000 },
767
- },
768
- },
769
- ],
770
- },
771
- ],
772
- }),
773
- },
774
- };
775
-
776
- const state = await scanSessionMessages(mockClient, "test-session");
777
- const subtask = state.subtasks.get("bd-123.1");
778
- expect(subtask?.status).toBe("completed");
779
- });
780
-
781
- it("tracks last action", async () => {
782
- const mockClient = {
783
- session: {
784
- messages: async () => ({
785
- data: [
786
- {
787
- info: { id: "msg-1", sessionID: "test-session" },
788
- parts: [
789
- {
790
- type: "tool",
791
- tool: "swarm_status",
792
- state: {
793
- status: "completed",
794
- input: { epic_id: "epic-123", project_key: "/test" },
795
- output: "{}",
796
- time: { start: 5000, end: 6000 },
797
- },
798
- },
799
- ],
800
- },
801
- ],
802
- }),
803
- },
804
- };
805
-
806
- const state = await scanSessionMessages(mockClient, "test-session");
807
- expect(state.lastAction?.tool).toBe("swarm_status");
808
- expect(state.lastAction?.timestamp).toBe(6000);
809
- });
810
-
811
- it("handles SDK errors gracefully", async () => {
812
- const mockClient = {
813
- session: {
814
- messages: async () => {
815
- throw new Error("SDK error");
816
- },
817
- },
818
- };
819
-
820
- // Should not throw, just return empty state
821
- const state = await scanSessionMessages(mockClient, "test-session");
822
- expect(state.subtasks.size).toBe(0);
823
- });
824
-
825
- it("respects limit parameter", async () => {
826
- const mockClient = {
827
- session: {
828
- messages: async (opts: { query?: { limit?: number } }) => {
829
- expect(opts.query?.limit).toBe(50);
830
- return { data: [] };
831
- },
832
- },
833
- };
834
-
835
- await scanSessionMessages(mockClient, "test-session", 50);
836
- });
837
- });
838
- });