claude-flow-novice 2.0.3 → 2.0.4

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 (272) hide show
  1. package/dist/src/cli/commands/guidance.js +487 -668
  2. package/dist/src/cli/commands/index-validate.js +18 -29
  3. package/dist/src/cli/commands/mcp-troubleshoot.js +230 -282
  4. package/dist/src/cli/commands/neural-goal-init.js +92 -125
  5. package/dist/src/cli/commands/swarm-exec.js +317 -393
  6. package/dist/src/cli/commands/swarm.js +1 -1
  7. package/dist/src/cli/commands/validate-framework.js +983 -1100
  8. package/dist/src/cli/commands/validate.js +144 -223
  9. package/dist/src/cli/simple-commands/__tests__/agent.test.js +265 -277
  10. package/dist/src/cli/simple-commands/__tests__/memory.test.js +6 -7
  11. package/dist/src/cli/simple-commands/__tests__/swarm.test.js +373 -356
  12. package/dist/src/cli/simple-commands/__tests__/task.test.js +6 -7
  13. package/dist/src/cli/simple-commands/agent.js +157 -193
  14. package/dist/src/cli/simple-commands/analysis.js +336 -446
  15. package/dist/src/cli/simple-commands/automation-executor.js +1095 -1339
  16. package/dist/src/cli/simple-commands/automation.js +481 -469
  17. package/dist/src/cli/simple-commands/batch-manager.js +261 -313
  18. package/dist/src/cli/simple-commands/claude-telemetry.js +241 -267
  19. package/dist/src/cli/simple-commands/claude-track.js +68 -90
  20. package/dist/src/cli/simple-commands/concurrent-display.js +266 -320
  21. package/dist/src/cli/simple-commands/config.js +245 -290
  22. package/dist/src/cli/simple-commands/coordination.js +182 -234
  23. package/dist/src/cli/simple-commands/enhanced-ui-views.js +812 -615
  24. package/dist/src/cli/simple-commands/enhanced-webui-complete.js +922 -981
  25. package/dist/src/cli/simple-commands/fix-hook-variables.js +274 -294
  26. package/dist/src/cli/simple-commands/github/gh-coordinator.js +378 -457
  27. package/dist/src/cli/simple-commands/github/github-api.js +535 -574
  28. package/dist/src/cli/simple-commands/github/init.js +276 -303
  29. package/dist/src/cli/simple-commands/github.js +222 -247
  30. package/dist/src/cli/simple-commands/goal.js +51 -63
  31. package/dist/src/cli/simple-commands/hive-mind/auto-save-middleware.js +208 -278
  32. package/dist/src/cli/simple-commands/hive-mind/communication.js +601 -696
  33. package/dist/src/cli/simple-commands/hive-mind/core.js +907 -979
  34. package/dist/src/cli/simple-commands/hive-mind/db-optimizer.js +406 -655
  35. package/dist/src/cli/simple-commands/hive-mind/mcp-wrapper.js +1125 -1245
  36. package/dist/src/cli/simple-commands/hive-mind/memory.js +854 -1090
  37. package/dist/src/cli/simple-commands/hive-mind/performance-optimizer.js +459 -574
  38. package/dist/src/cli/simple-commands/hive-mind/performance-test.js +263 -347
  39. package/dist/src/cli/simple-commands/hive-mind/queen.js +727 -768
  40. package/dist/src/cli/simple-commands/hive-mind/session-manager.js +745 -1049
  41. package/dist/src/cli/simple-commands/hive-mind-optimize.js +227 -283
  42. package/dist/src/cli/simple-commands/hive-mind-wizard.js +174 -217
  43. package/dist/src/cli/simple-commands/hive-mind.js +1842 -2283
  44. package/dist/src/cli/simple-commands/hive.js +90 -79
  45. package/dist/src/cli/simple-commands/hook-safety.js +431 -521
  46. package/dist/src/cli/simple-commands/hooks/session-start-soul.js +203 -254
  47. package/dist/src/cli/simple-commands/hooks.js +1064 -1204
  48. package/dist/src/cli/simple-commands/init/agent-copier.js +294 -319
  49. package/dist/src/cli/simple-commands/init/batch-init.js +496 -562
  50. package/dist/src/cli/simple-commands/init/claude-commands/claude-flow-commands.js +13 -19
  51. package/dist/src/cli/simple-commands/init/claude-commands/optimized-claude-flow-commands.js +13 -19
  52. package/dist/src/cli/simple-commands/init/claude-commands/optimized-slash-commands.js +61 -88
  53. package/dist/src/cli/simple-commands/init/claude-commands/optimized-sparc-commands.js +125 -150
  54. package/dist/src/cli/simple-commands/init/claude-commands/slash-commands.js +42 -49
  55. package/dist/src/cli/simple-commands/init/claude-commands/sparc-commands.js +43 -61
  56. package/dist/src/cli/simple-commands/init/copy-revised-templates.js +141 -147
  57. package/dist/src/cli/simple-commands/init/executable-wrapper.js +31 -44
  58. package/dist/src/cli/simple-commands/init/gitignore-updater.js +64 -90
  59. package/dist/src/cli/simple-commands/init/help.js +104 -107
  60. package/dist/src/cli/simple-commands/init/hive-mind-init.js +509 -528
  61. package/dist/src/cli/simple-commands/init/index.js +1510 -1759
  62. package/dist/src/cli/simple-commands/init/performance-monitor.js +234 -317
  63. package/dist/src/cli/simple-commands/init/rollback/backup-manager.js +441 -504
  64. package/dist/src/cli/simple-commands/init/rollback/index.js +289 -364
  65. package/dist/src/cli/simple-commands/init/rollback/recovery-manager.js +652 -728
  66. package/dist/src/cli/simple-commands/init/rollback/rollback-executor.js +416 -481
  67. package/dist/src/cli/simple-commands/init/rollback/state-tracker.js +369 -448
  68. package/dist/src/cli/simple-commands/init/sparc/roo-readme.js +1 -2
  69. package/dist/src/cli/simple-commands/init/sparc/roomodes-config.js +122 -99
  70. package/dist/src/cli/simple-commands/init/sparc/workflows.js +32 -37
  71. package/dist/src/cli/simple-commands/init/sparc-structure.js +55 -62
  72. package/dist/src/cli/simple-commands/init/template-copier.js +421 -533
  73. package/dist/src/cli/simple-commands/init/templates/coordination-md.js +3 -6
  74. package/dist/src/cli/simple-commands/init/templates/enhanced-templates.js +344 -318
  75. package/dist/src/cli/simple-commands/init/templates/github-safe-enhanced.js +173 -218
  76. package/dist/src/cli/simple-commands/init/templates/github-safe.js +65 -75
  77. package/dist/src/cli/simple-commands/init/templates/memory-bank-md.js +3 -6
  78. package/dist/src/cli/simple-commands/init/templates/readme-files.js +2 -4
  79. package/dist/src/cli/simple-commands/init/templates/safe-hook-patterns.js +187 -230
  80. package/dist/src/cli/simple-commands/init/templates/sparc-modes.js +53 -80
  81. package/dist/src/cli/simple-commands/init/templates/verification-claude-md.js +101 -85
  82. package/dist/src/cli/simple-commands/init/validation/config-validator.js +283 -330
  83. package/dist/src/cli/simple-commands/init/validation/health-checker.js +495 -561
  84. package/dist/src/cli/simple-commands/init/validation/index.js +302 -358
  85. package/dist/src/cli/simple-commands/init/validation/mode-validator.js +308 -359
  86. package/dist/src/cli/simple-commands/init/validation/post-init-validator.js +389 -366
  87. package/dist/src/cli/simple-commands/init/validation/pre-init-validator.js +270 -268
  88. package/dist/src/cli/simple-commands/init/validation/test-runner.js +427 -447
  89. package/dist/src/cli/simple-commands/init.js +1 -2
  90. package/dist/src/cli/simple-commands/mcp-health.js +131 -158
  91. package/dist/src/cli/simple-commands/mcp-integration-layer.js +533 -634
  92. package/dist/src/cli/simple-commands/mcp.js +345 -400
  93. package/dist/src/cli/simple-commands/memory-consolidation.js +426 -537
  94. package/dist/src/cli/simple-commands/memory.js +247 -311
  95. package/dist/src/cli/simple-commands/migrate-hooks.js +39 -46
  96. package/dist/src/cli/simple-commands/monitor.js +294 -363
  97. package/dist/src/cli/simple-commands/neural.js +51 -65
  98. package/dist/src/cli/simple-commands/pair-autofix-only.js +538 -662
  99. package/dist/src/cli/simple-commands/pair-basic.js +528 -656
  100. package/dist/src/cli/simple-commands/pair-old.js +430 -543
  101. package/dist/src/cli/simple-commands/pair-working.js +615 -751
  102. package/dist/src/cli/simple-commands/pair.js +615 -751
  103. package/dist/src/cli/simple-commands/performance-hooks.js +83 -111
  104. package/dist/src/cli/simple-commands/performance-metrics.js +348 -433
  105. package/dist/src/cli/simple-commands/process-ui-enhanced.js +708 -787
  106. package/dist/src/cli/simple-commands/process-ui.js +230 -254
  107. package/dist/src/cli/simple-commands/realtime-update-system.js +525 -611
  108. package/dist/src/cli/simple-commands/sparc/architecture.js +1704 -1530
  109. package/dist/src/cli/simple-commands/sparc/commands.js +438 -516
  110. package/dist/src/cli/simple-commands/sparc/completion.js +1224 -1481
  111. package/dist/src/cli/simple-commands/sparc/coordinator.js +913 -978
  112. package/dist/src/cli/simple-commands/sparc/index.js +241 -298
  113. package/dist/src/cli/simple-commands/sparc/phase-base.js +314 -390
  114. package/dist/src/cli/simple-commands/sparc/pseudocode.js +965 -869
  115. package/dist/src/cli/simple-commands/sparc/refinement.js +980 -1273
  116. package/dist/src/cli/simple-commands/sparc/specification.js +559 -645
  117. package/dist/src/cli/simple-commands/sparc-modes/architect.js +1 -1
  118. package/dist/src/cli/simple-commands/sparc-modes/ask.js +1 -1
  119. package/dist/src/cli/simple-commands/sparc-modes/code.js +1 -1
  120. package/dist/src/cli/simple-commands/sparc-modes/debug.js +1 -1
  121. package/dist/src/cli/simple-commands/sparc-modes/devops.js +1 -1
  122. package/dist/src/cli/simple-commands/sparc-modes/docs-writer.js +1 -1
  123. package/dist/src/cli/simple-commands/sparc-modes/generic.js +1 -1
  124. package/dist/src/cli/simple-commands/sparc-modes/index.js +47 -55
  125. package/dist/src/cli/simple-commands/sparc-modes/integration.js +1 -1
  126. package/dist/src/cli/simple-commands/sparc-modes/mcp.js +1 -1
  127. package/dist/src/cli/simple-commands/sparc-modes/monitoring.js +1 -1
  128. package/dist/src/cli/simple-commands/sparc-modes/optimization.js +1 -1
  129. package/dist/src/cli/simple-commands/sparc-modes/security-review.js +1 -1
  130. package/dist/src/cli/simple-commands/sparc-modes/sparc-orchestrator.js +1 -1
  131. package/dist/src/cli/simple-commands/sparc-modes/spec-pseudocode.js +1 -1
  132. package/dist/src/cli/simple-commands/sparc-modes/supabase-admin.js +1 -1
  133. package/dist/src/cli/simple-commands/sparc-modes/swarm.js +101 -87
  134. package/dist/src/cli/simple-commands/sparc-modes/tdd.js +1 -1
  135. package/dist/src/cli/simple-commands/sparc-modes/tutorial.js +1 -1
  136. package/dist/src/cli/simple-commands/sparc.js +465 -493
  137. package/dist/src/cli/simple-commands/start-ui.js +108 -132
  138. package/dist/src/cli/simple-commands/start-wrapper.js +240 -268
  139. package/dist/src/cli/simple-commands/start.js +1 -1
  140. package/dist/src/cli/simple-commands/status.js +254 -275
  141. package/dist/src/cli/simple-commands/stream-chain-clean.js +128 -171
  142. package/dist/src/cli/simple-commands/stream-chain-fixed.js +61 -82
  143. package/dist/src/cli/simple-commands/stream-chain-real.js +267 -331
  144. package/dist/src/cli/simple-commands/stream-chain-working.js +211 -263
  145. package/dist/src/cli/simple-commands/stream-chain.js +260 -318
  146. package/dist/src/cli/simple-commands/stream-processor.js +290 -315
  147. package/dist/src/cli/simple-commands/swarm-executor.js +189 -222
  148. package/dist/src/cli/simple-commands/swarm-metrics-integration.js +208 -300
  149. package/dist/src/cli/simple-commands/swarm-ui.js +623 -703
  150. package/dist/src/cli/simple-commands/swarm-webui-integration.js +258 -286
  151. package/dist/src/cli/simple-commands/swarm.js +887 -1082
  152. package/dist/src/cli/simple-commands/task.js +161 -206
  153. package/dist/src/cli/simple-commands/timestamp-fix.js +59 -89
  154. package/dist/src/cli/simple-commands/token-tracker.js +258 -316
  155. package/dist/src/cli/simple-commands/tool-execution-framework.js +433 -519
  156. package/dist/src/cli/simple-commands/train-and-stream.js +275 -331
  157. package/dist/src/cli/simple-commands/training-pipeline.js +619 -725
  158. package/dist/src/cli/simple-commands/training.js +170 -227
  159. package/dist/src/cli/simple-commands/verification-hooks.js +261 -284
  160. package/dist/src/cli/simple-commands/verification-integration.js +389 -417
  161. package/dist/src/cli/simple-commands/verification-training-integration.js +486 -606
  162. package/dist/src/cli/simple-commands/verification.js +493 -513
  163. package/dist/src/cli/simple-commands/web-server.js +766 -836
  164. package/dist/src/cli/simple-commands/webui-validator.js +106 -124
  165. package/dist/src/coordination/event-bus/demo-wasm-integration.js +212 -251
  166. package/dist/src/coordination/event-bus/qe-event-bus.js +608 -748
  167. package/dist/src/coordination/event-bus/qe-event-bus.test.js +379 -454
  168. package/dist/src/coordination/iteration-tracker.js +363 -454
  169. package/dist/src/enterprise/analytics-manager.js +1135 -0
  170. package/dist/src/enterprise/audit-manager.js +1115 -0
  171. package/dist/src/enterprise/cloud-manager.js +891 -0
  172. package/dist/src/enterprise/deployment-manager.js +966 -0
  173. package/dist/src/enterprise/index.js +6 -0
  174. package/dist/src/enterprise/project-manager.js +584 -0
  175. package/dist/src/enterprise/security-manager.js +991 -0
  176. package/dist/src/index.js +1 -1
  177. package/dist/src/mcp/DEPRECATED.js +46 -60
  178. package/dist/src/mcp/fixes/mcp-error-fixes.js +115 -134
  179. package/dist/src/mcp/implementations/agent-tracker.js +114 -128
  180. package/dist/src/mcp/implementations/daa-tools.js +292 -350
  181. package/dist/src/mcp/implementations/workflow-tools.js +329 -361
  182. package/dist/src/mcp/mcp-config-manager.js +1183 -1331
  183. package/dist/src/mcp/mcp-server-novice-simplified.js +11 -17
  184. package/dist/src/mcp/mcp-server-novice.js +11 -17
  185. package/dist/src/mcp/mcp-server-sdk.js +11 -17
  186. package/dist/src/mcp/mcp-server.js +1620 -1484
  187. package/dist/src/mcp/ruv-swarm-wrapper.js +209 -239
  188. package/dist/src/memory/advanced-serializer.js +609 -589
  189. package/dist/src/memory/enhanced-examples.js +220 -305
  190. package/dist/src/memory/enhanced-memory.js +295 -336
  191. package/dist/src/memory/enhanced-session-serializer.js +408 -492
  192. package/dist/src/memory/fallback-memory-system.js +900 -1021
  193. package/dist/src/memory/fallback-store.js +93 -131
  194. package/dist/src/memory/high-performance-serialization.js +592 -730
  195. package/dist/src/memory/in-memory-store.js +161 -213
  196. package/dist/src/memory/index.js +123 -157
  197. package/dist/src/memory/lock-free-structures.js +578 -764
  198. package/dist/src/memory/memory-mapped-persistence.js +585 -766
  199. package/dist/src/memory/memory-pressure-manager.js +569 -707
  200. package/dist/src/memory/migration.js +358 -445
  201. package/dist/src/memory/shared-memory.js +641 -768
  202. package/dist/src/memory/sqlite-store.js +245 -325
  203. package/dist/src/memory/sqlite-wrapper.js +122 -151
  204. package/dist/src/memory/swarm-memory.js +470 -603
  205. package/dist/src/memory/test-example.js +126 -134
  206. package/dist/src/memory/ultra-fast-memory-store.js +622 -821
  207. package/dist/src/memory/unified-memory-manager.js +356 -437
  208. package/dist/src/migration/index.js +92 -0
  209. package/dist/src/migration/logger.js +121 -0
  210. package/dist/src/migration/migration-analyzer.js +268 -0
  211. package/dist/src/migration/migration-runner.js +522 -0
  212. package/dist/src/migration/migration-validator.js +285 -0
  213. package/dist/src/migration/progress-reporter.js +150 -0
  214. package/dist/src/migration/rollback-manager.js +321 -0
  215. package/dist/src/migration/tests/migration-system.test.js +7 -0
  216. package/dist/src/migration/types.js +3 -0
  217. package/dist/src/swarm/CodeRefactoringSwarm.js +777 -952
  218. package/dist/src/swarm/__tests__/integration.test.js +227 -0
  219. package/dist/src/swarm/__tests__/prompt-copier.test.js +344 -0
  220. package/dist/src/swarm/advanced-orchestrator.js +1095 -0
  221. package/dist/src/swarm/claude-code-interface.js +961 -0
  222. package/dist/src/swarm/claude-flow-executor.js +229 -0
  223. package/dist/src/swarm/consensus-coordinator.js +475 -0
  224. package/dist/src/swarm/coordinator.js +2993 -0
  225. package/dist/src/swarm/direct-executor.js +1180 -0
  226. package/dist/src/swarm/error-recovery/advanced-error-detection.js +691 -0
  227. package/dist/src/swarm/error-recovery/automated-recovery-workflows.js +998 -0
  228. package/dist/src/swarm/error-recovery/error-recovery-coordinator.js +1197 -0
  229. package/dist/src/swarm/error-recovery/recovery-monitoring.js +772 -0
  230. package/dist/src/swarm/error-recovery/resilience-architecture.js +714 -0
  231. package/dist/src/swarm/error-recovery/self-healing-mechanisms.js +1319 -0
  232. package/dist/src/swarm/error-recovery/test-error-recovery-effectiveness.js +808 -0
  233. package/dist/src/swarm/executor-v2.js +322 -0
  234. package/dist/src/swarm/executor.js +815 -0
  235. package/dist/src/swarm/hive-mind-integration.js +703 -0
  236. package/dist/src/swarm/index.js +41 -0
  237. package/dist/src/swarm/json-output-aggregator.js +267 -0
  238. package/dist/src/swarm/large-scale-coordinator.js +542 -0
  239. package/dist/src/swarm/mcp-integration-wrapper.js +628 -0
  240. package/dist/src/swarm/memory.js +1117 -0
  241. package/dist/src/swarm/optimizations/__tests__/optimization.test.js +348 -0
  242. package/dist/src/swarm/optimizations/async-file-manager.js +285 -0
  243. package/dist/src/swarm/optimizations/circular-buffer.js +162 -0
  244. package/dist/src/swarm/optimizations/connection-pool.js +244 -0
  245. package/dist/src/swarm/optimizations/index.js +28 -0
  246. package/dist/src/swarm/optimizations/optimized-executor.js +320 -0
  247. package/dist/src/swarm/optimizations/ttl-map.js +234 -0
  248. package/dist/src/swarm/prompt-cli.js +200 -0
  249. package/dist/src/swarm/prompt-copier-enhanced.js +202 -0
  250. package/dist/src/swarm/prompt-copier.js +381 -0
  251. package/dist/src/swarm/prompt-manager.js +295 -0
  252. package/dist/src/swarm/prompt-utils.js +310 -0
  253. package/dist/src/swarm/result-aggregator.js +718 -0
  254. package/dist/src/swarm/sparc-executor.js +1568 -0
  255. package/dist/src/swarm/strategies/auto.js +758 -0
  256. package/dist/src/swarm/strategies/base.js +128 -0
  257. package/dist/src/swarm/strategies/research.js +914 -0
  258. package/dist/src/swarm/strategies/strategy-metrics-patch.js +2 -0
  259. package/dist/src/swarm/types.js +52 -0
  260. package/dist/src/swarm/workers/copy-worker.js +56 -0
  261. package/dist/src/utils/__tests__/github-cli-safety-wrapper.test.js +332 -400
  262. package/dist/src/utils/github-cli-safe.js +56 -64
  263. package/dist/src/utils/github-cli-safety-wrapper.js +451 -546
  264. package/dist/src/utils/npx-isolated-cache.js +104 -119
  265. package/dist/src/utils/preference-manager.js +622 -652
  266. package/dist/src/utils/timezone-utils.js +86 -105
  267. package/dist/src/validators/epic-config-schema.js +214 -0
  268. package/dist/src/validators/index.js +10 -0
  269. package/dist/src/validators/swarm-init-validator.js +259 -0
  270. package/dist/src/validators/todowrite-batching-validator.js +215 -0
  271. package/dist/src/validators/todowrite-integration.js +187 -0
  272. package/package.json +2 -2
@@ -1,24 +1,19 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
3
  * GitHub init command - Initialize GitHub-specific hooks and checkpoint system
4
- */
5
-
6
- import { existsSync } from 'fs';
7
- import { access, constants, mkdir, readFile, writeFile } from 'fs/promises';
8
- import { join, dirname } from 'path';
9
- import { printSuccess, printError, printWarning, printInfo } from '../../utils.js';
10
- import { spawn } from 'child_process';
11
- import { promisify } from 'util';
4
+ */ import { existsSync } from "fs";
5
+ import { mkdir, readFile, writeFile } from "node:fs/promises";
6
+ import { join, dirname } from "path";
7
+ import { printSuccess, printError, printWarning } from "../../utils.js";
8
+ import { spawn } from "child_process";
9
+ import { promisify } from "util";
12
10
  const exec = promisify(spawn);
13
-
14
11
  /**
15
12
  * Create GitHub-specific checkpoint hooks
16
- */
17
- async function createGitHubCheckpointHooks() {
18
- const helpersDir = join(process.cwd(), '.claude', 'helpers');
19
- const checkpointHooksPath = join(helpersDir, 'github-checkpoint-hooks.sh');
20
-
21
- const content = `#!/bin/bash
13
+ */ async function createGitHubCheckpointHooks() {
14
+ const helpersDir = join(process.cwd(), '.claude', 'helpers');
15
+ const checkpointHooksPath = join(helpersDir, 'github-checkpoint-hooks.sh');
16
+ const content = `#!/bin/bash
22
17
  # GitHub-specific checkpoint hook functions for Claude settings.json
23
18
 
24
19
  # Function to handle pre-edit checkpoints
@@ -237,307 +232,285 @@ case "$1" in
237
232
  ;;
238
233
  esac
239
234
  `;
240
-
241
- await writeFile(checkpointHooksPath, content, { mode: 0o755 });
242
- return checkpointHooksPath;
235
+ await writeFile(checkpointHooksPath, content, {
236
+ mode: 0o755
237
+ });
238
+ return checkpointHooksPath;
243
239
  }
244
-
245
240
  /**
246
241
  * Create GitHub-specific settings.json
247
- */
248
- async function createGitHubSettingsJson() {
249
- const settingsPath = join(process.cwd(), '.claude', 'settings.json');
250
-
251
- const settings = {
252
- env: {
253
- CLAUDE_FLOW_AUTO_COMMIT: 'false',
254
- CLAUDE_FLOW_AUTO_PUSH: 'false',
255
- CLAUDE_FLOW_HOOKS_ENABLED: 'true',
256
- CLAUDE_FLOW_TELEMETRY_ENABLED: 'true',
257
- CLAUDE_FLOW_REMOTE_EXECUTION: 'true',
258
- CLAUDE_FLOW_GITHUB_INTEGRATION: 'true',
259
- CLAUDE_FLOW_CHECKPOINTS_ENABLED: 'true',
260
- CREATE_GH_RELEASE: 'true',
261
- },
262
- permissions: {
263
- allow: [
264
- 'Bash(npx claude-flow-novice *)',
265
- 'Bash(npm run lint)',
266
- 'Bash(npm run test:*)',
267
- 'Bash(npm test *)',
268
- 'Bash(git status)',
269
- 'Bash(git diff *)',
270
- 'Bash(git log *)',
271
- 'Bash(git add *)',
272
- 'Bash(git commit *)',
273
- 'Bash(git push)',
274
- 'Bash(git config *)',
275
- 'Bash(git tag *)',
276
- 'Bash(git branch *)',
277
- 'Bash(git checkout *)',
278
- 'Bash(git stash *)',
279
- 'Bash(git reset *)',
280
- 'Bash(git rev-parse *)',
281
- 'Bash(git ls-files *)',
282
- 'Bash(gh *)',
283
- 'Bash(node *)',
284
- 'Bash(which *)',
285
- 'Bash(pwd)',
286
- 'Bash(ls *)',
287
- 'Bash(jq *)',
288
- 'Bash(test *)',
289
- 'Bash(find *)',
290
- 'Bash(grep *)',
291
- 'Bash(sed *)',
292
- 'Bash(awk *)',
293
- 'Bash(curl *)',
294
- 'Bash(mkdir *)',
295
- 'Bash(cd *)',
296
- 'Bash(cat *)',
297
- 'Bash(echo *)',
298
- 'Bash(npx claude-flow@alpha *)',
299
- 'Bash(./claude-flow-novice *)',
300
- 'Bash(./.claude/helpers/*)',
301
- ],
302
- deny: ['Bash(rm -rf /)', 'Bash(curl * | bash)', 'Bash(wget * | sh)', 'Bash(eval *)'],
303
- },
304
- hooks: {
305
- PreToolUse: [
306
- {
307
- matcher: 'Bash',
308
- hooks: [
309
- {
310
- type: 'command',
311
- command:
312
- "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks pre-command --command '{}' --validate-safety true --prepare-resources true",
313
- },
314
- ],
315
- },
316
- {
317
- matcher: 'Write|Edit|MultiEdit',
318
- hooks: [
319
- {
320
- type: 'command',
321
- command:
322
- "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks pre-edit --file '{}' --auto-assign-agents true --load-context true",
323
- },
324
- {
325
- type: 'command',
326
- command: 'bash .claude/helpers/github-checkpoint-hooks.sh pre-edit "{{tool_input}}"',
327
- },
328
- ],
329
- },
330
- ],
331
- PostToolUse: [
332
- {
333
- matcher: 'Bash',
334
- hooks: [
335
- {
336
- type: 'command',
337
- command:
338
- "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-command --command '{}' --track-metrics true --store-results true",
339
- },
340
- ],
341
- },
342
- {
343
- matcher: 'Write|Edit|MultiEdit',
344
- hooks: [
345
- {
346
- type: 'command',
347
- command:
348
- "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-edit --file '{}' --format true --update-memory true",
349
- },
350
- {
351
- type: 'command',
352
- command: 'bash .claude/helpers/github-checkpoint-hooks.sh post-edit "{{tool_input}}"',
353
- },
354
- ],
242
+ */ async function createGitHubSettingsJson() {
243
+ const settingsPath = join(process.cwd(), '.claude', 'settings.json');
244
+ const settings = {
245
+ env: {
246
+ CLAUDE_FLOW_AUTO_COMMIT: 'false',
247
+ CLAUDE_FLOW_AUTO_PUSH: 'false',
248
+ CLAUDE_FLOW_HOOKS_ENABLED: 'true',
249
+ CLAUDE_FLOW_TELEMETRY_ENABLED: 'true',
250
+ CLAUDE_FLOW_REMOTE_EXECUTION: 'true',
251
+ CLAUDE_FLOW_GITHUB_INTEGRATION: 'true',
252
+ CLAUDE_FLOW_CHECKPOINTS_ENABLED: 'true',
253
+ CREATE_GH_RELEASE: 'true'
355
254
  },
356
- ],
357
- UserPromptSubmit: [
358
- {
359
- hooks: [
360
- {
361
- type: 'command',
362
- command: 'bash .claude/helpers/github-checkpoint-hooks.sh task "{{user_prompt}}"',
363
- },
364
- ],
255
+ permissions: {
256
+ allow: [
257
+ 'Bash(npx claude-flow-novice *)',
258
+ 'Bash(npm run lint)',
259
+ 'Bash(npm run test:*)',
260
+ 'Bash(npm test *)',
261
+ 'Bash(git status)',
262
+ 'Bash(git diff *)',
263
+ 'Bash(git log *)',
264
+ 'Bash(git add *)',
265
+ 'Bash(git commit *)',
266
+ 'Bash(git push)',
267
+ 'Bash(git config *)',
268
+ 'Bash(git tag *)',
269
+ 'Bash(git branch *)',
270
+ 'Bash(git checkout *)',
271
+ 'Bash(git stash *)',
272
+ 'Bash(git reset *)',
273
+ 'Bash(git rev-parse *)',
274
+ 'Bash(git ls-files *)',
275
+ 'Bash(gh *)',
276
+ 'Bash(node *)',
277
+ 'Bash(which *)',
278
+ 'Bash(pwd)',
279
+ 'Bash(ls *)',
280
+ 'Bash(jq *)',
281
+ 'Bash(test *)',
282
+ 'Bash(find *)',
283
+ 'Bash(grep *)',
284
+ 'Bash(sed *)',
285
+ 'Bash(awk *)',
286
+ 'Bash(curl *)',
287
+ 'Bash(mkdir *)',
288
+ 'Bash(cd *)',
289
+ 'Bash(cat *)',
290
+ 'Bash(echo *)',
291
+ 'Bash(npx claude-flow@alpha *)',
292
+ 'Bash(./claude-flow-novice *)',
293
+ 'Bash(./.claude/helpers/*)'
294
+ ],
295
+ deny: [
296
+ 'Bash(rm -rf /)',
297
+ 'Bash(curl * | bash)',
298
+ 'Bash(wget * | sh)',
299
+ 'Bash(eval *)'
300
+ ]
365
301
  },
366
- ],
367
- Stop: [
368
- {
369
- hooks: [
370
- {
371
- type: 'command',
372
- command:
373
- 'npx claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true',
374
- },
375
- {
376
- type: 'command',
377
- command: 'bash .claude/helpers/github-checkpoint-hooks.sh session-end',
378
- },
379
- ],
302
+ hooks: {
303
+ PreToolUse: [
304
+ {
305
+ matcher: 'Bash',
306
+ hooks: [
307
+ {
308
+ type: 'command',
309
+ command: "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks pre-command --command '{}' --validate-safety true --prepare-resources true"
310
+ }
311
+ ]
312
+ },
313
+ {
314
+ matcher: 'Write|Edit|MultiEdit',
315
+ hooks: [
316
+ {
317
+ type: 'command',
318
+ command: "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks pre-edit --file '{}' --auto-assign-agents true --load-context true"
319
+ },
320
+ {
321
+ type: 'command',
322
+ command: 'bash .claude/helpers/github-checkpoint-hooks.sh pre-edit "{{tool_input}}"'
323
+ }
324
+ ]
325
+ }
326
+ ],
327
+ PostToolUse: [
328
+ {
329
+ matcher: 'Bash',
330
+ hooks: [
331
+ {
332
+ type: 'command',
333
+ command: "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-command --command '{}' --track-metrics true --store-results true"
334
+ }
335
+ ]
336
+ },
337
+ {
338
+ matcher: 'Write|Edit|MultiEdit',
339
+ hooks: [
340
+ {
341
+ type: 'command',
342
+ command: "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-edit --file '{}' --format true --update-memory true"
343
+ },
344
+ {
345
+ type: 'command',
346
+ command: 'bash .claude/helpers/github-checkpoint-hooks.sh post-edit "{{tool_input}}"'
347
+ }
348
+ ]
349
+ }
350
+ ],
351
+ UserPromptSubmit: [
352
+ {
353
+ hooks: [
354
+ {
355
+ type: 'command',
356
+ command: 'bash .claude/helpers/github-checkpoint-hooks.sh task "{{user_prompt}}"'
357
+ }
358
+ ]
359
+ }
360
+ ],
361
+ Stop: [
362
+ {
363
+ hooks: [
364
+ {
365
+ type: 'command',
366
+ command: 'npx claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true'
367
+ },
368
+ {
369
+ type: 'command',
370
+ command: 'bash .claude/helpers/github-checkpoint-hooks.sh session-end'
371
+ }
372
+ ]
373
+ }
374
+ ],
375
+ PreCompact: [
376
+ {
377
+ matcher: 'manual',
378
+ hooks: [
379
+ {
380
+ type: 'command',
381
+ command: '/bin/bash -c \'INPUT=$(cat); CUSTOM=$(echo "$INPUT" | jq -r ".custom_instructions // \"\""); echo "🔄 PreCompact Guidance:"; echo "📋 IMPORTANT: Review CLAUDE.md in project root for:"; echo " • 54 available agents and concurrent usage patterns"; echo " • Swarm coordination strategies (hierarchical, mesh, adaptive)"; echo " • SPARC methodology workflows with batchtools optimization"; echo " • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)"; if [ -n "$CUSTOM" ]; then echo "🎯 Custom compact instructions: $CUSTOM"; fi; echo "✅ Ready for compact operation"\''
382
+ }
383
+ ]
384
+ },
385
+ {
386
+ matcher: 'auto',
387
+ hooks: [
388
+ {
389
+ type: 'command',
390
+ command: '/bin/bash -c \'echo "🔄 Auto-Compact Guidance (Context Window Full):"; echo "📋 CRITICAL: Before compacting, ensure you understand:"; echo " • All 54 agents available in .claude/agents/ directory"; echo " • Concurrent execution patterns from CLAUDE.md"; echo " • Batchtools optimization for 300% performance gains"; echo " • Swarm coordination strategies for complex tasks"; echo "⚡ Apply GOLDEN RULE: Always batch operations in single messages"; echo "✅ Auto-compact proceeding with full agent context"\''
391
+ }
392
+ ]
393
+ }
394
+ ]
380
395
  },
381
- ],
382
- PreCompact: [
383
- {
384
- matcher: 'manual',
385
- hooks: [
386
- {
387
- type: 'command',
388
- command:
389
- '/bin/bash -c \'INPUT=$(cat); CUSTOM=$(echo "$INPUT" | jq -r ".custom_instructions // \"\""); echo "🔄 PreCompact Guidance:"; echo "📋 IMPORTANT: Review CLAUDE.md in project root for:"; echo " • 54 available agents and concurrent usage patterns"; echo " • Swarm coordination strategies (hierarchical, mesh, adaptive)"; echo " • SPARC methodology workflows with batchtools optimization"; echo " • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)"; if [ -n "$CUSTOM" ]; then echo "🎯 Custom compact instructions: $CUSTOM"; fi; echo "✅ Ready for compact operation"\'',
390
- },
391
- ],
392
- },
393
- {
394
- matcher: 'auto',
395
- hooks: [
396
- {
397
- type: 'command',
398
- command:
399
- '/bin/bash -c \'echo "🔄 Auto-Compact Guidance (Context Window Full):"; echo "📋 CRITICAL: Before compacting, ensure you understand:"; echo " • All 54 agents available in .claude/agents/ directory"; echo " • Concurrent execution patterns from CLAUDE.md"; echo " • Batchtools optimization for 300% performance gains"; echo " • Swarm coordination strategies for complex tasks"; echo "⚡ Apply GOLDEN RULE: Always batch operations in single messages"; echo "✅ Auto-compact proceeding with full agent context"\'',
400
- },
401
- ],
402
- },
403
- ],
404
- },
405
- includeCoAuthoredBy: true,
406
- enabledMcpjsonServers: ['claude-flow', 'ruv-swarm'],
407
- };
408
-
409
- await writeFile(settingsPath, JSON.stringify(settings, null, 2));
410
- return settingsPath;
396
+ includeCoAuthoredBy: true,
397
+ enabledMcpjsonServers: [
398
+ 'claude-flow',
399
+ 'ruv-swarm'
400
+ ]
401
+ };
402
+ await writeFile(settingsPath, JSON.stringify(settings, null, 2));
403
+ return settingsPath;
411
404
  }
412
-
413
405
  /**
414
406
  * Initialize GitHub-specific hooks and checkpoint system
415
- */
416
- export async function githubInitCommand(flags = {}) {
417
- try {
418
- console.log('🐙 Initializing GitHub-specific hooks and checkpoint system...\n');
419
-
420
- // Check if we're in a git repository
407
+ */ export async function githubInitCommand(flags = {}) {
421
408
  try {
422
- const { execSync } = await import('child_process');
423
- execSync('git rev-parse --git-dir', { stdio: 'ignore' });
424
- } catch (error) {
425
- printError('❌ Not in a git repository. Please initialize git first.');
426
- return;
427
- }
428
-
429
- // Check if gh CLI is available
430
- let ghAvailable = false;
431
- try {
432
- const { execSync } = await import('child_process');
433
- execSync('gh --version', { stdio: 'ignore' });
434
- ghAvailable = true;
435
- printSuccess('✅ GitHub CLI detected');
436
- } catch (error) {
437
- printWarning('⚠️ GitHub CLI not found. Some features will be limited.');
438
- console.log(' Install gh: https://cli.github.com/');
439
- }
440
-
441
- // Create .claude directory structure
442
- const claudeDir = join(process.cwd(), '.claude');
443
- const helpersDir = join(claudeDir, 'helpers');
444
- const checkpointsDir = join(claudeDir, 'checkpoints');
445
-
446
- await mkdir(claudeDir, { recursive: true });
447
- await mkdir(helpersDir, { recursive: true });
448
- await mkdir(checkpointsDir, { recursive: true });
449
-
450
- // Check if settings.json already exists
451
- const settingsPath = join(claudeDir, 'settings.json');
452
- if (existsSync(settingsPath) && !flags.force) {
453
- printWarning('⚠️ settings.json already exists. Use --force to overwrite.');
454
- return;
455
- }
456
-
457
- // Create GitHub checkpoint hooks
458
- const hooksPath = await createGitHubCheckpointHooks();
459
- printSuccess(`✅ Created GitHub checkpoint hooks: ${hooksPath}`);
460
-
461
- // Copy standard checkpoint manager
462
- const checkpointManagerPath = join(helpersDir, 'checkpoint-manager.sh');
463
- const checkpointManagerContent = await readFile(
464
- join(
465
- dirname(import.meta.url).replace('file://', ''),
466
- '..',
467
- 'init',
468
- 'templates',
469
- 'commands',
470
- 'helpers',
471
- 'checkpoint-manager.sh',
472
- ),
473
- 'utf8',
474
- ).catch(() => {
475
- // Fallback content if template not found
476
- return `#!/bin/bash
409
+ console.log('🐙 Initializing GitHub-specific hooks and checkpoint system...\n');
410
+ // Check if we're in a git repository
411
+ try {
412
+ const { execSync } = await import("child_process");
413
+ execSync('git rev-parse --git-dir', {
414
+ stdio: 'ignore'
415
+ });
416
+ } catch (error) {
417
+ printError('❌ Not in a git repository. Please initialize git first.');
418
+ return;
419
+ }
420
+ // Check if gh CLI is available
421
+ let ghAvailable = false;
422
+ try {
423
+ const { execSync } = await import("child_process");
424
+ execSync('gh --version', {
425
+ stdio: 'ignore'
426
+ });
427
+ ghAvailable = true;
428
+ printSuccess('✅ GitHub CLI detected');
429
+ } catch (error) {
430
+ printWarning('⚠️ GitHub CLI not found. Some features will be limited.');
431
+ console.log(' Install gh: https://cli.github.com/');
432
+ }
433
+ // Create .claude directory structure
434
+ const claudeDir = join(process.cwd(), '.claude');
435
+ const helpersDir = join(claudeDir, 'helpers');
436
+ const checkpointsDir = join(claudeDir, 'checkpoints');
437
+ await mkdir(claudeDir, {
438
+ recursive: true
439
+ });
440
+ await mkdir(helpersDir, {
441
+ recursive: true
442
+ });
443
+ await mkdir(checkpointsDir, {
444
+ recursive: true
445
+ });
446
+ // Check if settings.json already exists
447
+ const settingsPath = join(claudeDir, 'settings.json');
448
+ if (existsSync(settingsPath) && !flags.force) {
449
+ printWarning('⚠️ settings.json already exists. Use --force to overwrite.');
450
+ return;
451
+ }
452
+ // Create GitHub checkpoint hooks
453
+ const hooksPath = await createGitHubCheckpointHooks();
454
+ printSuccess(`✅ Created GitHub checkpoint hooks: ${hooksPath}`);
455
+ // Copy standard checkpoint manager
456
+ const checkpointManagerPath = join(helpersDir, 'checkpoint-manager.sh');
457
+ const checkpointManagerContent = await readFile(join(dirname(import.meta.url).replace('file://', ''), '..', 'init', 'templates', 'commands', 'helpers', 'checkpoint-manager.sh'), 'utf8').catch(()=>{
458
+ // Fallback content if template not found
459
+ return `#!/bin/bash
477
460
  # Checkpoint manager for Claude Flow
478
461
  # Use github-checkpoint-hooks.sh for checkpoint operations
479
462
  `;
480
- });
481
-
482
- await writeFile(checkpointManagerPath, checkpointManagerContent, { mode: 0o755 });
483
- printSuccess(`✅ Created checkpoint manager: ${checkpointManagerPath}`);
484
-
485
- // Create GitHub-specific settings.json
486
- await createGitHubSettingsJson();
487
- printSuccess(`✅ Created GitHub settings: ${settingsPath}`);
488
-
489
- // Initialize first checkpoint
490
- try {
491
- const { execSync } = await import('child_process');
492
- execSync(`bash ${hooksPath} task "Initialize GitHub checkpoint system"`, {
493
- stdio: 'inherit',
494
- });
495
- printSuccess('✅ Created initial checkpoint');
463
+ });
464
+ await writeFile(checkpointManagerPath, checkpointManagerContent, {
465
+ mode: 0o755
466
+ });
467
+ printSuccess(`✅ Created checkpoint manager: ${checkpointManagerPath}`);
468
+ // Create GitHub-specific settings.json
469
+ await createGitHubSettingsJson();
470
+ printSuccess(`✅ Created GitHub settings: ${settingsPath}`);
471
+ // Initialize first checkpoint
472
+ try {
473
+ const { execSync } = await import("child_process");
474
+ execSync(`bash ${hooksPath} task "Initialize GitHub checkpoint system"`, {
475
+ stdio: 'inherit'
476
+ });
477
+ printSuccess('✅ Created initial checkpoint');
478
+ } catch (error) {
479
+ printWarning('⚠️ Could not create initial checkpoint: ' + error.message);
480
+ }
481
+ // Show completion message
482
+ console.log('\n' + '='.repeat(60));
483
+ printSuccess('🎉 GitHub hooks initialized successfully!');
484
+ console.log('='.repeat(60) + '\n');
485
+ console.log("📋 What's been set up:\n");
486
+ console.log(' 1. GitHub-specific checkpoint hooks in .claude/helpers/');
487
+ console.log(' 2. Automatic GitHub releases for checkpoints' + (ghAvailable ? ' ✅' : ' (requires gh CLI)'));
488
+ console.log(' 3. Enhanced rollback with GitHub integration');
489
+ console.log(' 4. Session summaries with GitHub releases');
490
+ console.log(' 5. Full GitHub CLI permissions in settings.json');
491
+ console.log('\n🚀 Quick Start:\n');
492
+ console.log(' 1. Edit any file - automatic checkpoint created');
493
+ console.log(' 2. Start new tasks - task checkpoints with GitHub releases');
494
+ console.log(' 3. End sessions - comprehensive GitHub summary');
495
+ console.log('\n📚 Checkpoint Management:\n');
496
+ console.log(' # List all checkpoints');
497
+ console.log(' .claude/helpers/checkpoint-manager.sh list');
498
+ console.log('');
499
+ console.log(' # View GitHub releases');
500
+ console.log(' gh release list');
501
+ console.log('');
502
+ console.log(' # Rollback to checkpoint');
503
+ console.log(' .claude/helpers/checkpoint-manager.sh rollback checkpoint-YYYYMMDD-HHMMSS');
504
+ console.log('');
505
+ console.log(' # Download release');
506
+ console.log(' gh release download checkpoint-YYYYMMDD-HHMMSS');
507
+ if (!ghAvailable) {
508
+ console.log('\n⚠️ Note: Install GitHub CLI for full features:');
509
+ console.log(' https://cli.github.com/');
510
+ }
511
+ console.log('\n💡 Pro tip: GitHub releases make it easy to share checkpoints with your team!');
496
512
  } catch (error) {
497
- printWarning('⚠️ Could not create initial checkpoint: ' + error.message);
513
+ printError(`❌ Failed to initialize GitHub hooks: ${error.message}`);
514
+ console.error(error);
498
515
  }
499
-
500
- // Show completion message
501
- console.log('\n' + '='.repeat(60));
502
- printSuccess('🎉 GitHub hooks initialized successfully!');
503
- console.log('='.repeat(60) + '\n');
504
-
505
- console.log("📋 What's been set up:\n");
506
- console.log(' 1. GitHub-specific checkpoint hooks in .claude/helpers/');
507
- console.log(
508
- ' 2. Automatic GitHub releases for checkpoints' +
509
- (ghAvailable ? ' ✅' : ' (requires gh CLI)'),
510
- );
511
- console.log(' 3. Enhanced rollback with GitHub integration');
512
- console.log(' 4. Session summaries with GitHub releases');
513
- console.log(' 5. Full GitHub CLI permissions in settings.json');
514
-
515
- console.log('\n🚀 Quick Start:\n');
516
- console.log(' 1. Edit any file - automatic checkpoint created');
517
- console.log(' 2. Start new tasks - task checkpoints with GitHub releases');
518
- console.log(' 3. End sessions - comprehensive GitHub summary');
519
-
520
- console.log('\n📚 Checkpoint Management:\n');
521
- console.log(' # List all checkpoints');
522
- console.log(' .claude/helpers/checkpoint-manager.sh list');
523
- console.log('');
524
- console.log(' # View GitHub releases');
525
- console.log(' gh release list');
526
- console.log('');
527
- console.log(' # Rollback to checkpoint');
528
- console.log(' .claude/helpers/checkpoint-manager.sh rollback checkpoint-YYYYMMDD-HHMMSS');
529
- console.log('');
530
- console.log(' # Download release');
531
- console.log(' gh release download checkpoint-YYYYMMDD-HHMMSS');
532
-
533
- if (!ghAvailable) {
534
- console.log('\n⚠️ Note: Install GitHub CLI for full features:');
535
- console.log(' https://cli.github.com/');
536
- }
537
-
538
- console.log('\n💡 Pro tip: GitHub releases make it easy to share checkpoints with your team!');
539
- } catch (error) {
540
- printError(`❌ Failed to initialize GitHub hooks: ${error.message}`);
541
- console.error(error);
542
- }
543
516
  }