monomind 1.16.11 → 1.17.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 (148) hide show
  1. package/.claude/agents/engineering/engineering-security-engineer.md +1 -1
  2. package/.claude/agents/github/code-review-swarm.md +19 -19
  3. package/.claude/agents/github/github-modes.md +4 -4
  4. package/.claude/agents/github/multi-repo-swarm.md +24 -24
  5. package/.claude/agents/github/project-board-sync.md +28 -28
  6. package/.claude/agents/github/swarm-issue.md +26 -26
  7. package/.claude/agents/github/swarm-pr.md +18 -18
  8. package/.claude/agents/github/workflow-automation.md +27 -27
  9. package/.claude/agents/reengineer-squad/git-manager.md +2 -2
  10. package/.claude/commands/mastermind/_repeat.md +4 -0
  11. package/.claude/commands/mastermind/master.md +61 -4
  12. package/.claude/commands/mastermind/references/antigravity-tools.md +60 -0
  13. package/.claude/commands/mastermind/references/claude-code-tools.md +50 -0
  14. package/.claude/commands/mastermind/references/codex-tools.md +64 -0
  15. package/.claude/commands/mastermind/references/copilot-tools.md +49 -0
  16. package/.claude/commands/mastermind/references/gemini-tools.md +63 -0
  17. package/.claude/commands/mastermind/references/pi-tools.md +28 -0
  18. package/.claude/helpers/mastermind-activate.cjs +53 -0
  19. package/.claude/scheduled_tasks.lock +1 -1
  20. package/.claude/settings.json +4 -0
  21. package/.claude/skills/mastermind/_repeat.md +2 -0
  22. package/.claude/skills/mastermind/runorg.md +14 -0
  23. package/.claude/skills/mastermind/techport.md +5 -5
  24. package/README.md +1 -1
  25. package/package.json +6 -5
  26. package/packages/@monomind/cli/.claude/agents/engineering/engineering-security-engineer.md +1 -1
  27. package/packages/@monomind/cli/.claude/agents/github/code-review-swarm.md +19 -19
  28. package/packages/@monomind/cli/.claude/agents/github/github-modes.md +4 -4
  29. package/packages/@monomind/cli/.claude/agents/github/multi-repo-swarm.md +24 -24
  30. package/packages/@monomind/cli/.claude/agents/github/project-board-sync.md +28 -28
  31. package/packages/@monomind/cli/.claude/agents/github/swarm-issue.md +26 -26
  32. package/packages/@monomind/cli/.claude/agents/github/swarm-pr.md +18 -18
  33. package/packages/@monomind/cli/.claude/agents/github/workflow-automation.md +27 -27
  34. package/packages/@monomind/cli/.claude/agents/reengineer-squad/git-manager.md +2 -2
  35. package/packages/@monomind/cli/.claude/commands/mastermind/_repeat.md +4 -0
  36. package/packages/@monomind/cli/.claude/commands/mastermind/master.md +61 -4
  37. package/packages/@monomind/cli/.claude/commands/mastermind/references/antigravity-tools.md +60 -0
  38. package/packages/@monomind/cli/.claude/commands/mastermind/references/claude-code-tools.md +50 -0
  39. package/packages/@monomind/cli/.claude/commands/mastermind/references/codex-tools.md +64 -0
  40. package/packages/@monomind/cli/.claude/commands/mastermind/references/copilot-tools.md +49 -0
  41. package/packages/@monomind/cli/.claude/commands/mastermind/references/gemini-tools.md +63 -0
  42. package/packages/@monomind/cli/.claude/commands/mastermind/references/pi-tools.md +28 -0
  43. package/packages/@monomind/cli/.claude/helpers/mastermind-activate.cjs +53 -0
  44. package/packages/@monomind/cli/.claude/skills/mastermind/_repeat.md +2 -0
  45. package/packages/@monomind/cli/.claude/skills/mastermind/runorg.md +14 -0
  46. package/packages/@monomind/cli/.claude/skills/mastermind/techport.md +5 -5
  47. package/packages/@monomind/cli/README.md +1 -1
  48. package/packages/@monomind/cli/dist/src/__tests__/browse-analyzer.test.js +42 -59
  49. package/packages/@monomind/cli/dist/src/browser/dashboard/server.js +18 -0
  50. package/packages/@monomind/cli/dist/src/commands/agent-lifecycle.d.ts +17 -0
  51. package/packages/@monomind/cli/dist/src/commands/agent-lifecycle.js +320 -0
  52. package/packages/@monomind/cli/dist/src/commands/agent-ops.d.ts +9 -0
  53. package/packages/@monomind/cli/dist/src/commands/agent-ops.js +329 -0
  54. package/packages/@monomind/cli/dist/src/commands/agent.js +5 -907
  55. package/packages/@monomind/cli/dist/src/commands/analyze-ast.d.ts +26 -0
  56. package/packages/@monomind/cli/dist/src/commands/analyze-ast.js +284 -0
  57. package/packages/@monomind/cli/dist/src/commands/analyze-boundaries.d.ts +14 -0
  58. package/packages/@monomind/cli/dist/src/commands/analyze-boundaries.js +295 -0
  59. package/packages/@monomind/cli/dist/src/commands/analyze-diff.d.ts +8 -0
  60. package/packages/@monomind/cli/dist/src/commands/analyze-diff.js +395 -0
  61. package/packages/@monomind/cli/dist/src/commands/analyze-graph.d.ts +14 -0
  62. package/packages/@monomind/cli/dist/src/commands/analyze-graph.js +304 -0
  63. package/packages/@monomind/cli/dist/src/commands/analyze-imports.d.ts +11 -0
  64. package/packages/@monomind/cli/dist/src/commands/analyze-imports.js +287 -0
  65. package/packages/@monomind/cli/dist/src/commands/analyze-symbols.d.ts +14 -0
  66. package/packages/@monomind/cli/dist/src/commands/analyze-symbols.js +302 -0
  67. package/packages/@monomind/cli/dist/src/commands/analyze.d.ts +38 -0
  68. package/packages/@monomind/cli/dist/src/commands/analyze.js +12 -1827
  69. package/packages/@monomind/cli/dist/src/commands/doctor-env-checks.d.ts +26 -0
  70. package/packages/@monomind/cli/dist/src/commands/doctor-env-checks.js +189 -0
  71. package/packages/@monomind/cli/dist/src/commands/doctor-project-checks.d.ts +19 -0
  72. package/packages/@monomind/cli/dist/src/commands/doctor-project-checks.js +388 -0
  73. package/packages/@monomind/cli/dist/src/commands/doctor.js +51 -942
  74. package/packages/@monomind/cli/dist/src/commands/hive-mind-comms.d.ts +11 -0
  75. package/packages/@monomind/cli/dist/src/commands/hive-mind-comms.js +242 -0
  76. package/packages/@monomind/cli/dist/src/commands/hive-mind-helpers.d.ts +35 -0
  77. package/packages/@monomind/cli/dist/src/commands/hive-mind-helpers.js +203 -0
  78. package/packages/@monomind/cli/dist/src/commands/hive-mind-ops.d.ts +8 -0
  79. package/packages/@monomind/cli/dist/src/commands/hive-mind-ops.js +233 -0
  80. package/packages/@monomind/cli/dist/src/commands/hive-mind-spawn.d.ts +12 -0
  81. package/packages/@monomind/cli/dist/src/commands/hive-mind-spawn.js +274 -0
  82. package/packages/@monomind/cli/dist/src/commands/hive-mind.js +10 -1129
  83. package/packages/@monomind/cli/dist/src/commands/hooks-coverage-commands.d.ts +4 -4
  84. package/packages/@monomind/cli/dist/src/commands/hooks-coverage-commands.js +19 -819
  85. package/packages/@monomind/cli/dist/src/commands/hooks-coverage-gaps.d.ts +7 -0
  86. package/packages/@monomind/cli/dist/src/commands/hooks-coverage-gaps.js +334 -0
  87. package/packages/@monomind/cli/dist/src/commands/hooks-coverage-routing.d.ts +7 -0
  88. package/packages/@monomind/cli/dist/src/commands/hooks-coverage-routing.js +399 -0
  89. package/packages/@monomind/cli/dist/src/commands/index.js +0 -2
  90. package/packages/@monomind/cli/dist/src/commands/init-subcommands.d.ts +8 -0
  91. package/packages/@monomind/cli/dist/src/commands/init-subcommands.js +156 -0
  92. package/packages/@monomind/cli/dist/src/commands/init-upgrade.d.ts +6 -0
  93. package/packages/@monomind/cli/dist/src/commands/init-upgrade.js +203 -0
  94. package/packages/@monomind/cli/dist/src/commands/init-wizard.d.ts +6 -0
  95. package/packages/@monomind/cli/dist/src/commands/init-wizard.js +246 -0
  96. package/packages/@monomind/cli/dist/src/commands/init.js +6 -623
  97. package/packages/@monomind/cli/dist/src/commands/memory-admin.d.ts +10 -0
  98. package/packages/@monomind/cli/dist/src/commands/memory-admin.js +433 -0
  99. package/packages/@monomind/cli/dist/src/commands/memory-crud.d.ts +9 -0
  100. package/packages/@monomind/cli/dist/src/commands/memory-crud.js +342 -0
  101. package/packages/@monomind/cli/dist/src/commands/memory-list.d.ts +10 -0
  102. package/packages/@monomind/cli/dist/src/commands/memory-list.js +321 -0
  103. package/packages/@monomind/cli/dist/src/commands/memory-transfer.d.ts +9 -0
  104. package/packages/@monomind/cli/dist/src/commands/memory-transfer.js +372 -0
  105. package/packages/@monomind/cli/dist/src/commands/memory.d.ts +6 -0
  106. package/packages/@monomind/cli/dist/src/commands/memory.js +10 -1441
  107. package/packages/@monomind/cli/dist/src/commands/neural-core.d.ts +8 -0
  108. package/packages/@monomind/cli/dist/src/commands/neural-core.js +274 -0
  109. package/packages/@monomind/cli/dist/src/commands/neural-optimize.d.ts +7 -0
  110. package/packages/@monomind/cli/dist/src/commands/neural-optimize.js +332 -0
  111. package/packages/@monomind/cli/dist/src/commands/neural-registry.d.ts +7 -0
  112. package/packages/@monomind/cli/dist/src/commands/neural-registry.js +290 -0
  113. package/packages/@monomind/cli/dist/src/commands/neural.js +3 -974
  114. package/packages/@monomind/cli/dist/src/commands/platforms.js +327 -7
  115. package/packages/@monomind/cli/dist/src/commands/security-cve.d.ts +6 -0
  116. package/packages/@monomind/cli/dist/src/commands/security-cve.js +310 -0
  117. package/packages/@monomind/cli/dist/src/commands/security-misc.d.ts +9 -0
  118. package/packages/@monomind/cli/dist/src/commands/security-misc.js +293 -0
  119. package/packages/@monomind/cli/dist/src/commands/security-scan.d.ts +18 -0
  120. package/packages/@monomind/cli/dist/src/commands/security-scan.js +328 -0
  121. package/packages/@monomind/cli/dist/src/commands/security.js +3 -958
  122. package/packages/@monomind/cli/dist/src/commands/session.js +1 -1
  123. package/packages/@monomind/cli/dist/src/commands/swarm.js +23 -17
  124. package/packages/@monomind/cli/dist/src/init/executor.js +0 -24
  125. package/packages/@monomind/cli/dist/src/init/statusline-generator.js +0 -45
  126. package/packages/@monomind/cli/dist/src/init/types.d.ts +0 -2
  127. package/packages/@monomind/cli/dist/src/init/types.js +0 -2
  128. package/packages/@monomind/cli/dist/src/mcp-tools/swarm-tools.js +77 -0
  129. package/packages/@monomind/cli/dist/src/parser.js +11 -6
  130. package/packages/@monomind/cli/dist/src/routing/llm-caller.js +1 -2
  131. package/packages/@monomind/cli/dist/src/ui/dashboard.html +82 -75
  132. package/packages/@monomind/cli/dist/src/ui/server.mjs +41 -4
  133. package/packages/@monomind/cli/package.json +3 -4
  134. package/packages/@monomind/cli/scripts/understand-analyze.mjs +1 -1
  135. package/packages/@monomind/guidance/README.md +0 -1
  136. package/packages/@monomind/guidance/package.json +2 -14
  137. package/scripts/verify-appliance.sh +16 -20
  138. package/.claude-plugin/README.md +0 -704
  139. package/.claude-plugin/docs/INSTALLATION.md +0 -258
  140. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +0 -358
  141. package/.claude-plugin/docs/QUICKSTART.md +0 -357
  142. package/.claude-plugin/docs/STRUCTURE.md +0 -122
  143. package/.claude-plugin/hooks/hooks.json +0 -74
  144. package/.claude-plugin/marketplace.json +0 -98
  145. package/.claude-plugin/plugin.json +0 -70
  146. package/.claude-plugin/scripts/install.sh +0 -234
  147. package/.claude-plugin/scripts/uninstall.sh +0 -36
  148. package/.claude-plugin/scripts/verify.sh +0 -102
@@ -19,14 +19,14 @@ Transform GitHub Issues into intelligent swarm tasks, enabling automatic task de
19
19
  ISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)
20
20
 
21
21
  # Create swarm from issue
22
- npx ruv-swarm github issue-to-swarm 456 \
22
+ npx monomind github issue-to-swarm 456 \
23
23
  --issue-data "$ISSUE_DATA" \
24
24
  --auto-decompose \
25
25
  --assign-agents
26
26
 
27
27
  # Batch process multiple issues
28
28
  ISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels)
29
- npx ruv-swarm github issues-batch \
29
+ npx monomind github issues-batch \
30
30
  --issues "$ISSUES" \
31
31
  --parallel
32
32
 
@@ -107,7 +107,7 @@ body:
107
107
  ### Dynamic Agent Assignment
108
108
  ```bash
109
109
  # Assign agents based on issue content
110
- npx ruv-swarm github issue-analyze 456 \
110
+ npx monomind github issue-analyze 456 \
111
111
  --suggest-agents \
112
112
  --estimate-complexity \
113
113
  --create-subtasks
@@ -130,7 +130,7 @@ REFERENCES=$(gh issue view 456 --json body --jq '.body' | \
130
130
  done | jq -s '.')
131
131
 
132
132
  # Initialize swarm
133
- npx ruv-swarm github issue-init 456 \
133
+ npx monomind github issue-init 456 \
134
134
  --issue-data "$ISSUE" \
135
135
  --references "$REFERENCES" \
136
136
  --load-comments \
@@ -148,7 +148,7 @@ gh issue comment 456 --body "🐝 Swarm initialized for this issue"
148
148
  ISSUE_BODY=$(gh issue view 456 --json body --jq '.body')
149
149
 
150
150
  # Decompose into subtasks
151
- SUBTASKS=$(npx ruv-swarm github issue-decompose 456 \
151
+ SUBTASKS=$(npx monomind github issue-decompose 456 \
152
152
  --body "$ISSUE_BODY" \
153
153
  --max-subtasks 10 \
154
154
  --assign-priorities)
@@ -183,11 +183,11 @@ done
183
183
  CURRENT=$(gh issue view 456 --json body,labels)
184
184
 
185
185
  # Get swarm progress
186
- PROGRESS=$(npx ruv-swarm github issue-progress 456)
186
+ PROGRESS=$(npx monomind github issue-progress 456)
187
187
 
188
188
  # Update checklist in issue body
189
189
  UPDATED_BODY=$(echo "$CURRENT" | jq -r '.body' | \
190
- npx ruv-swarm github update-checklist --progress "$PROGRESS")
190
+ npx monomind github update-checklist --progress "$PROGRESS")
191
191
 
192
192
  # Edit issue with updated body
193
193
  gh issue edit 456 --body "$UPDATED_BODY"
@@ -224,7 +224,7 @@ fi
224
224
  ### 1. Issue Dependencies
225
225
  ```bash
226
226
  # Handle issue dependencies
227
- npx ruv-swarm github issue-deps 456 \
227
+ npx monomind github issue-deps 456 \
228
228
  --resolve-order \
229
229
  --parallel-safe \
230
230
  --update-blocking
@@ -233,7 +233,7 @@ npx ruv-swarm github issue-deps 456 \
233
233
  ### 2. Epic Management
234
234
  ```bash
235
235
  # Coordinate epic-level swarms
236
- npx ruv-swarm github epic-swarm \
236
+ npx monomind github epic-swarm \
237
237
  --epic 123 \
238
238
  --child-issues "456,457,458" \
239
239
  --orchestrate
@@ -242,7 +242,7 @@ npx ruv-swarm github epic-swarm \
242
242
  ### 3. Issue Templates
243
243
  ```bash
244
244
  # Generate issue from swarm analysis
245
- npx ruv-swarm github create-issues \
245
+ npx monomind github create-issues \
246
246
  --from-analysis \
247
247
  --template "bug-report" \
248
248
  --auto-assign
@@ -267,14 +267,14 @@ jobs:
267
267
  with:
268
268
  command: |
269
269
  if [[ "${{ github.event.label.name }}" == "swarm-ready" ]]; then
270
- npx ruv-swarm github issue-init ${{ github.event.issue.number }}
270
+ npx monomind github issue-init ${{ github.event.issue.number }}
271
271
  fi
272
272
  ```
273
273
 
274
274
  ### Issue Board Integration
275
275
  ```bash
276
276
  # Sync with project board
277
- npx ruv-swarm github issue-board-sync \
277
+ npx monomind github issue-board-sync \
278
278
  --project "Development" \
279
279
  --column-mapping '{
280
280
  "To Do": "pending",
@@ -288,7 +288,7 @@ npx ruv-swarm github issue-board-sync \
288
288
  ### Bug Reports
289
289
  ```bash
290
290
  # Specialized bug handling
291
- npx ruv-swarm github bug-swarm 456 \
291
+ npx monomind github bug-swarm 456 \
292
292
  --reproduce \
293
293
  --isolate \
294
294
  --fix \
@@ -298,7 +298,7 @@ npx ruv-swarm github bug-swarm 456 \
298
298
  ### Feature Requests
299
299
  ```bash
300
300
  # Feature implementation swarm
301
- npx ruv-swarm github feature-swarm 456 \
301
+ npx monomind github feature-swarm 456 \
302
302
  --design \
303
303
  --implement \
304
304
  --document \
@@ -308,7 +308,7 @@ npx ruv-swarm github feature-swarm 456 \
308
308
  ### Technical Debt
309
309
  ```bash
310
310
  # Refactoring swarm
311
- npx ruv-swarm github debt-swarm 456 \
311
+ npx monomind github debt-swarm 456 \
312
312
  --analyze-impact \
313
313
  --plan-migration \
314
314
  --execute \
@@ -331,7 +331,7 @@ echo "$STALE_ISSUES" | jq -r '.number' | while read -r num; do
331
331
  ISSUE=$(gh issue view $num --json title,body,comments,labels)
332
332
 
333
333
  # Analyze with swarm
334
- ACTION=$(npx ruv-swarm github analyze-stale \
334
+ ACTION=$(npx monomind github analyze-stale \
335
335
  --issue "$ISSUE" \
336
336
  --suggest-action)
337
337
 
@@ -364,7 +364,7 @@ gh issue list --label stale --state open --json number,updatedAt \
364
364
  ### Issue Triage
365
365
  ```bash
366
366
  # Automated triage system
367
- npx ruv-swarm github triage \
367
+ npx monomind github triage \
368
368
  --unlabeled \
369
369
  --analyze-content \
370
370
  --suggest-labels \
@@ -374,7 +374,7 @@ npx ruv-swarm github triage \
374
374
  ### Duplicate Detection
375
375
  ```bash
376
376
  # Find duplicate issues
377
- npx ruv-swarm github find-duplicates \
377
+ npx monomind github find-duplicates \
378
378
  --threshold 0.8 \
379
379
  --link-related \
380
380
  --close-duplicates
@@ -385,7 +385,7 @@ npx ruv-swarm github find-duplicates \
385
385
  ### 1. Issue-PR Linking
386
386
  ```bash
387
387
  # Link issues to PRs automatically
388
- npx ruv-swarm github link-pr \
388
+ npx monomind github link-pr \
389
389
  --issue 456 \
390
390
  --pr 789 \
391
391
  --update-both
@@ -394,7 +394,7 @@ npx ruv-swarm github link-pr \
394
394
  ### 2. Milestone Coordination
395
395
  ```bash
396
396
  # Coordinate milestone swarms
397
- npx ruv-swarm github milestone-swarm \
397
+ npx monomind github milestone-swarm \
398
398
  --milestone "v2.0" \
399
399
  --parallel-issues \
400
400
  --track-progress
@@ -403,7 +403,7 @@ npx ruv-swarm github milestone-swarm \
403
403
  ### 3. Cross-Repo Issues
404
404
  ```bash
405
405
  # Handle issues across repositories
406
- npx ruv-swarm github cross-repo \
406
+ npx monomind github cross-repo \
407
407
  --issue "org/repo#456" \
408
408
  --related "org/other-repo#123" \
409
409
  --coordinate
@@ -414,7 +414,7 @@ npx ruv-swarm github cross-repo \
414
414
  ### Issue Resolution Time
415
415
  ```bash
416
416
  # Analyze swarm performance
417
- npx ruv-swarm github issue-metrics \
417
+ npx monomind github issue-metrics \
418
418
  --issue 456 \
419
419
  --metrics "time-to-close,agent-efficiency,subtask-completion"
420
420
  ```
@@ -422,7 +422,7 @@ npx ruv-swarm github issue-metrics \
422
422
  ### Swarm Effectiveness
423
423
  ```bash
424
424
  # Generate effectiveness report
425
- npx ruv-swarm github effectiveness \
425
+ npx monomind github effectiveness \
426
426
  --issues "closed:>2024-01-01" \
427
427
  --compare "with-swarm,without-swarm"
428
428
  ```
@@ -459,7 +459,7 @@ npx ruv-swarm github effectiveness \
459
459
  ### Complex Bug Investigation
460
460
  ```bash
461
461
  # Issue #789: Memory leak in production
462
- npx ruv-swarm github issue-init 789 \
462
+ npx monomind github issue-init 789 \
463
463
  --topology hierarchical \
464
464
  --agents "debugger,analyst,tester,monitor" \
465
465
  --priority critical \
@@ -469,7 +469,7 @@ npx ruv-swarm github issue-init 789 \
469
469
  ### Feature Implementation
470
470
  ```bash
471
471
  # Issue #234: Add OAuth integration
472
- npx ruv-swarm github issue-init 234 \
472
+ npx monomind github issue-init 234 \
473
473
  --topology mesh \
474
474
  --agents "architect,coder,security,tester" \
475
475
  --create-design-doc \
@@ -479,7 +479,7 @@ npx ruv-swarm github issue-init 234 \
479
479
  ### Documentation Update
480
480
  ```bash
481
481
  # Issue #567: Update API documentation
482
- npx ruv-swarm github issue-init 567 \
482
+ npx monomind github issue-init 567 \
483
483
  --topology ring \
484
484
  --agents "researcher,writer,reviewer" \
485
485
  --check-links \
@@ -17,14 +17,14 @@ Create and manage AI swarms directly from GitHub Pull Requests, enabling seamles
17
17
 
18
18
  ```bash
19
19
  # Create swarm from PR description using gh CLI
20
- gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
20
+ gh pr view 123 --json body,title,labels,files | npx monomind swarm create-from-pr
21
21
 
22
22
  # Auto-spawn agents based on PR labels
23
- gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
23
+ gh pr view 123 --json labels | npx monomind swarm auto-spawn
24
24
 
25
25
  # Create swarm with PR context
26
26
  gh pr view 123 --json body,labels,author,assignees | \
27
- npx ruv-swarm swarm init --from-pr-data
27
+ npx monomind swarm init --from-pr-data
28
28
  ```
29
29
 
30
30
  ### 2. PR Comment Commands
@@ -59,7 +59,7 @@ jobs:
59
59
  - name: Handle Swarm Command
60
60
  run: |
61
61
  if [[ "${{ github.event.comment.body }}" == /swarm* ]]; then
62
- npx ruv-swarm github handle-comment \
62
+ npx monomind github handle-comment \
63
63
  --pr ${{ github.event.pull_request.number }} \
64
64
  --comment "${{ github.event.comment.body }}"
65
65
  fi
@@ -89,7 +89,7 @@ Map PR labels to agent types:
89
89
  # Small PR (< 100 lines): ring topology
90
90
  # Medium PR (100-500 lines): mesh topology
91
91
  # Large PR (> 500 lines): hierarchical topology
92
- npx ruv-swarm github pr-topology --pr 123
92
+ npx monomind github pr-topology --pr 123
93
93
  ```
94
94
 
95
95
  ## PR Swarm Commands
@@ -101,7 +101,7 @@ npx ruv-swarm github pr-topology --pr 123
101
101
  PR_DIFF=$(gh pr diff 123)
102
102
  PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
103
103
 
104
- npx ruv-swarm github pr-init 123 \
104
+ npx monomind github pr-init 123 \
105
105
  --auto-agents \
106
106
  --pr-data "$PR_INFO" \
107
107
  --diff "$PR_DIFF" \
@@ -112,7 +112,7 @@ npx ruv-swarm github pr-init 123 \
112
112
 
113
113
  ```bash
114
114
  # Post swarm progress to PR using gh CLI
115
- PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
115
+ PROGRESS=$(npx monomind github pr-progress 123 --format markdown)
116
116
 
117
117
  gh pr comment 123 --body "$PROGRESS"
118
118
 
@@ -129,7 +129,7 @@ fi
129
129
  PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
130
130
 
131
131
  # Run swarm review
132
- REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
132
+ REVIEW_RESULTS=$(npx monomind github pr-review 123 \
133
133
  --agents "security,performance,style" \
134
134
  --files "$PR_FILES")
135
135
 
@@ -149,7 +149,7 @@ done
149
149
 
150
150
  ```bash
151
151
  # Coordinate swarms across related PRs
152
- npx ruv-swarm github multi-pr \
152
+ npx monomind github multi-pr \
153
153
  --prs "123,124,125" \
154
154
  --strategy "parallel" \
155
155
  --share-memory
@@ -159,7 +159,7 @@ npx ruv-swarm github multi-pr \
159
159
 
160
160
  ```bash
161
161
  # Analyze PR dependencies
162
- npx ruv-swarm github pr-deps 123 \
162
+ npx monomind github pr-deps 123 \
163
163
  --spawn-agents \
164
164
  --resolve-conflicts
165
165
  ```
@@ -168,7 +168,7 @@ npx ruv-swarm github pr-deps 123 \
168
168
 
169
169
  ```bash
170
170
  # Auto-fix PR issues
171
- npx ruv-swarm github pr-fix 123 \
171
+ npx monomind github pr-fix 123 \
172
172
  --issues "lint,test-failures" \
173
173
  --commit-fixes
174
174
  ```
@@ -209,7 +209,7 @@ required_status_checks:
209
209
  ```bash
210
210
  # Auto-merge when swarm completes using gh CLI
211
211
  # Check swarm completion status
212
- SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
212
+ SWARM_STATUS=$(npx monomind github pr-status 123)
213
213
 
214
214
  if [[ "$SWARM_STATUS" == "complete" ]]; then
215
215
  # Check review requirements
@@ -236,7 +236,7 @@ createServer((req, res) => {
236
236
  const event = JSON.parse(body);
237
237
 
238
238
  if (event.action === "opened" && event.pull_request) {
239
- execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
239
+ execSync(`npx monomind github pr-init ${event.pull_request.number}`);
240
240
  }
241
241
 
242
242
  res.writeHead(200);
@@ -251,7 +251,7 @@ createServer((req, res) => {
251
251
 
252
252
  ```bash
253
253
  # PR #456: Add user authentication
254
- npx ruv-swarm github pr-init 456 \
254
+ npx monomind github pr-init 456 \
255
255
  --topology hierarchical \
256
256
  --agents "architect,coder,tester,security" \
257
257
  --auto-assign-tasks
@@ -261,7 +261,7 @@ npx ruv-swarm github pr-init 456 \
261
261
 
262
262
  ```bash
263
263
  # PR #789: Fix memory leak
264
- npx ruv-swarm github pr-init 789 \
264
+ npx monomind github pr-init 789 \
265
265
  --topology mesh \
266
266
  --agents "debugger,analyst,tester" \
267
267
  --priority high
@@ -271,7 +271,7 @@ npx ruv-swarm github pr-init 789 \
271
271
 
272
272
  ```bash
273
273
  # PR #321: Update API docs
274
- npx ruv-swarm github pr-init 321 \
274
+ npx monomind github pr-init 321 \
275
275
  --topology ring \
276
276
  --agents "researcher,writer,reviewer" \
277
277
  --validate-links
@@ -283,7 +283,7 @@ npx ruv-swarm github pr-init 321 \
283
283
 
284
284
  ```bash
285
285
  # Generate PR swarm report
286
- npx ruv-swarm github pr-report 123 \
286
+ npx monomind github pr-report 123 \
287
287
  --metrics "completion-time,agent-efficiency,token-usage" \
288
288
  --format markdown
289
289
  ```
@@ -292,7 +292,7 @@ npx ruv-swarm github pr-report 123 \
292
292
 
293
293
  ```bash
294
294
  # Export to GitHub Insights
295
- npx ruv-swarm github export-metrics \
295
+ npx monomind github export-metrics \
296
296
  --pr 123 \
297
297
  --to-insights
298
298
  ```
@@ -34,7 +34,7 @@ jobs:
34
34
 
35
35
  - name: Analyze Changes
36
36
  run: |
37
- npx ruv-swarm actions analyze \
37
+ npx monomind actions analyze \
38
38
  --commit ${{ github.sha }} \
39
39
  --suggest-tests \
40
40
  --optimize-pipeline
@@ -44,7 +44,7 @@ jobs:
44
44
 
45
45
  ```bash
46
46
  # Generate workflows based on code analysis
47
- npx ruv-swarm actions generate-workflow \
47
+ npx monomind actions generate-workflow \
48
48
  --analyze-codebase \
49
49
  --detect-languages \
50
50
  --create-optimal-pipeline
@@ -56,7 +56,7 @@ npx ruv-swarm actions generate-workflow \
56
56
  # Smart test runner
57
57
  - name: Swarm Test Selection
58
58
  run: |
59
- npx ruv-swarm actions smart-test \
59
+ npx monomind actions smart-test \
60
60
  --changed-files ${{ steps.files.outputs.all }} \
61
61
  --impact-analysis \
62
62
  --parallel-safe
@@ -80,12 +80,12 @@ jobs:
80
80
  - name: Detect Languages
81
81
  id: detect
82
82
  run: |
83
- npx ruv-swarm actions detect-stack \
83
+ npx monomind actions detect-stack \
84
84
  --output json > stack.json
85
85
 
86
86
  - name: Dynamic Build Matrix
87
87
  run: |
88
- npx ruv-swarm actions create-matrix \
88
+ npx monomind actions create-matrix \
89
89
  --from stack.json \
90
90
  --parallel-builds
91
91
  ```
@@ -107,7 +107,7 @@ jobs:
107
107
  - name: Security Analysis Swarm
108
108
  run: |
109
109
  # Use gh CLI for issue creation
110
- SECURITY_ISSUES=$(npx ruv-swarm actions security \
110
+ SECURITY_ISSUES=$(npx monomind actions security \
111
111
  --deep-scan \
112
112
  --format json)
113
113
 
@@ -129,7 +129,7 @@ jobs:
129
129
 
130
130
  ```bash
131
131
  # Optimize existing workflows
132
- npx ruv-swarm actions optimize \
132
+ npx monomind actions optimize \
133
133
  --workflow ".github/workflows/ci.yml" \
134
134
  --suggest-parallelization \
135
135
  --reduce-redundancy \
@@ -141,7 +141,7 @@ npx ruv-swarm actions optimize \
141
141
  ```bash
142
142
  # Analyze failed runs using gh CLI
143
143
  gh run view ${{ github.run_id }} --json jobs,conclusion | \
144
- npx ruv-swarm actions analyze-failure \
144
+ npx monomind actions analyze-failure \
145
145
  --suggest-fixes \
146
146
  --auto-retry-flaky
147
147
 
@@ -158,7 +158,7 @@ fi
158
158
 
159
159
  ```bash
160
160
  # Optimize resource usage
161
- npx ruv-swarm actions resources \
161
+ npx monomind actions resources \
162
162
  --analyze-usage \
163
163
  --suggest-runners \
164
164
  --cost-optimize
@@ -180,7 +180,7 @@ jobs:
180
180
  steps:
181
181
  - name: Diagnose and Fix
182
182
  run: |
183
- npx ruv-swarm actions self-heal \
183
+ npx monomind actions self-heal \
184
184
  --run-id ${{ github.event.workflow_run.id }} \
185
185
  --auto-fix-common \
186
186
  --create-pr-complex
@@ -202,13 +202,13 @@ jobs:
202
202
  - name: Analyze Risk
203
203
  id: risk
204
204
  run: |
205
- npx ruv-swarm actions deploy-risk \
205
+ npx monomind actions deploy-risk \
206
206
  --changes ${{ github.sha }} \
207
207
  --history 30d
208
208
 
209
209
  - name: Choose Strategy
210
210
  run: |
211
- npx ruv-swarm actions deploy-strategy \
211
+ npx monomind actions deploy-strategy \
212
212
  --risk ${{ steps.risk.outputs.level }} \
213
213
  --auto-execute
214
214
  ```
@@ -226,7 +226,7 @@ jobs:
226
226
  steps:
227
227
  - name: Performance Analysis
228
228
  run: |
229
- npx ruv-swarm actions perf-test \
229
+ npx monomind actions perf-test \
230
230
  --baseline main \
231
231
  --threshold 10% \
232
232
  --auto-profile-regression
@@ -246,7 +246,7 @@ runs: using: "node16";
246
246
  main: "dist/index.js";
247
247
 
248
248
  // index.js
249
- const { SwarmAction } = require("ruv-swarm");
249
+ const { SwarmAction } = require("monomind");
250
250
 
251
251
  async function run() {
252
252
  const swarm = new SwarmAction({
@@ -271,7 +271,7 @@ jobs:
271
271
  steps:
272
272
  - id: set-matrix
273
273
  run: |
274
- MATRIX=$(npx ruv-swarm actions test-matrix \
274
+ MATRIX=$(npx monomind actions test-matrix \
275
275
  --detect-frameworks \
276
276
  --optimize-coverage)
277
277
  echo "matrix=${MATRIX}" >> $GITHUB_OUTPUT
@@ -286,7 +286,7 @@ jobs:
286
286
 
287
287
  ```bash
288
288
  # Determine optimal parallelization
289
- npx ruv-swarm actions parallel-strategy \
289
+ npx monomind actions parallel-strategy \
290
290
  --analyze-dependencies \
291
291
  --time-estimates \
292
292
  --cost-aware
@@ -298,7 +298,7 @@ npx ruv-swarm actions parallel-strategy \
298
298
 
299
299
  ```bash
300
300
  # Analyze workflow performance
301
- npx ruv-swarm actions analytics \
301
+ npx monomind actions analytics \
302
302
  --workflow "ci.yml" \
303
303
  --period 30d \
304
304
  --identify-bottlenecks \
@@ -309,7 +309,7 @@ npx ruv-swarm actions analytics \
309
309
 
310
310
  ```bash
311
311
  # Optimize GitHub Actions costs
312
- npx ruv-swarm actions cost-optimize \
312
+ npx monomind actions cost-optimize \
313
313
  --analyze-usage \
314
314
  --suggest-caching \
315
315
  --recommend-self-hosted
@@ -319,7 +319,7 @@ npx ruv-swarm actions cost-optimize \
319
319
 
320
320
  ```bash
321
321
  # Identify failure patterns
322
- npx ruv-swarm actions failure-patterns \
322
+ npx monomind actions failure-patterns \
323
323
  --period 90d \
324
324
  --classify-failures \
325
325
  --suggest-preventions
@@ -343,7 +343,7 @@ jobs:
343
343
  PR_DATA=$(gh pr view ${{ github.event.pull_request.number }} --json files,labels)
344
344
 
345
345
  # Run validation with swarm
346
- RESULTS=$(npx ruv-swarm actions pr-validate \
346
+ RESULTS=$(npx monomind actions pr-validate \
347
347
  --spawn-agents "linter,tester,security,docs" \
348
348
  --parallel \
349
349
  --pr-data "$PR_DATA")
@@ -367,7 +367,7 @@ jobs:
367
367
  steps:
368
368
  - name: Release Swarm
369
369
  run: |
370
- npx ruv-swarm actions release \
370
+ npx monomind actions release \
371
371
  --analyze-changes \
372
372
  --generate-notes \
373
373
  --create-artifacts \
@@ -388,7 +388,7 @@ jobs:
388
388
  steps:
389
389
  - name: Documentation Swarm
390
390
  run: |
391
- npx ruv-swarm actions update-docs \
391
+ npx monomind actions update-docs \
392
392
  --analyze-changes \
393
393
  --update-api-docs \
394
394
  --check-examples
@@ -423,7 +423,7 @@ jobs:
423
423
 
424
424
  ```bash
425
425
  # Predict potential failures
426
- npx ruv-swarm actions predict \
426
+ npx monomind actions predict \
427
427
  --analyze-history \
428
428
  --identify-risks \
429
429
  --suggest-preventive
@@ -433,7 +433,7 @@ npx ruv-swarm actions predict \
433
433
 
434
434
  ```bash
435
435
  # Get workflow recommendations
436
- npx ruv-swarm actions recommend \
436
+ npx monomind actions recommend \
437
437
  --analyze-repo \
438
438
  --suggest-workflows \
439
439
  --industry-best-practices
@@ -443,7 +443,7 @@ npx ruv-swarm actions recommend \
443
443
 
444
444
  ```bash
445
445
  # Continuously optimize workflows
446
- npx ruv-swarm actions auto-optimize \
446
+ npx monomind actions auto-optimize \
447
447
  --monitor-performance \
448
448
  --apply-improvements \
449
449
  --track-savings
@@ -456,7 +456,7 @@ npx ruv-swarm actions auto-optimize \
456
456
  ```yaml
457
457
  - name: Debug Swarm
458
458
  run: |
459
- npx ruv-swarm actions debug \
459
+ npx monomind actions debug \
460
460
  --verbose \
461
461
  --trace-agents \
462
462
  --export-logs
@@ -466,7 +466,7 @@ npx ruv-swarm actions auto-optimize \
466
466
 
467
467
  ```bash
468
468
  # Profile workflow performance
469
- npx ruv-swarm actions profile \
469
+ npx monomind actions profile \
470
470
  --workflow "ci.yml" \
471
471
  --identify-slow-steps \
472
472
  --suggest-optimizations
@@ -58,8 +58,8 @@ feat(port): <description> (from <source-module>)
58
58
 
59
59
  Examples:
60
60
  ```
61
- feat(port): add EventBus with typed subscribers (from ruv-swarm/event-system)
62
- feat(port): add PluginLoader with lazy resolution (from ruv-swarm/plugins)
61
+ feat(port): add EventBus with typed subscribers (from upstream/event-system)
62
+ feat(port): add PluginLoader with lazy resolution (from upstream/plugins)
63
63
  test(port): add EventBus behavioral contract tests
64
64
  ```
65
65
 
@@ -325,6 +325,8 @@ RECENT_HIL=$(find . -maxdepth 3 \( -name "humaninloop*.md" -o -name "humaninloop
325
325
 
326
326
  **Skip this section if `tillend_mode` is not true.** Proceed to section 5.
327
327
 
328
+ **`LOOP_ASYNC_PENDING` escape hatch:** If the calling skill set `LOOP_ASYNC_PENDING=true` before invoking the postamble (because it spawned background agents whose results have not yet arrived in this turn), skip the empty-round check entirely — treat this round as non-empty and go directly to section 6 to schedule the next run. The next scheduled run will evaluate results from the agents that are currently in-flight. Output: `[tillend] Async work in flight — deferring empty-round check to run <next_rep>.`
329
+
328
330
  After each run in tillend mode, evaluate whether this run produced **zero findings and zero actions**. The loop stops only when a complete round finds nothing new and makes no changes — not when the AI predicts there is nothing left.
329
331
 
330
332
  **You (the AI running the loop) must now assess your own output from this run.** Answer these two questions:
@@ -459,6 +461,8 @@ curl -s -X POST "${CTRL_URL}/api/mastermind/event" \
459
461
 
460
462
  ## Notes for Calling Commands
461
463
 
464
+ - **Async agents in loop mode**: In `--repeat` or `--tillend` mode, all subagents MUST be synchronous (`run_in_background: false` or omitted). The postamble's empty-round check runs in the same turn as the command — background agents complete in a later turn and their output is invisible to the check. If a skill must go async (e.g. it needs to spawn a long-running agent), set `LOOP_ASYNC_PENDING=true` before invoking the postamble; section 4 will skip the empty-round check and schedule the next run unconditionally. The next run will then evaluate the results.
465
+ - **Loop state is durable across turns**: The counter and all loop parameters survive across `ScheduleWakeup` fires via two mechanisms: (1) `--rep <N> --loop <ID>` is re-encoded in every ScheduleWakeup prompt, and (2) the `.monomind/loops/<ID>.json` file stores current state persistently. There is no in-memory counter — the counter is always re-read from the prompt flags or the file.
462
466
  - **`<command_slug>`**: lowercase command name without namespace (`build` for `/mastermind:build`, `mastermind-idea` for `/mastermind:idea`)
463
467
  - **Dashboard**: the monomind panel reads `.monomind/loops/*.json`; `type` field is `"repeat"` or `"tillend"`; HIL status shows as `"hil:pending"`
464
468
  - **Stopping a loop**: create `.monomind/loops/${LOOP_ID}.stop` or delete the `.json` file; the next wake-up detects it