@claude-flow/cli 3.6.30 → 3.7.0-alpha.10

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 (492) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/coder.md +452 -452
  15. package/.claude/agents/core/planner.md +374 -374
  16. package/.claude/agents/core/researcher.md +368 -368
  17. package/.claude/agents/core/reviewer.md +519 -519
  18. package/.claude/agents/core/tester.md +511 -511
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/data-ml-model.md +444 -444
  21. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  22. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  23. package/.claude/agents/development/dev-backend-api.md +344 -344
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  25. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  27. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  28. package/.claude/agents/flow-nexus/app-store.md +87 -87
  29. package/.claude/agents/flow-nexus/authentication.md +68 -68
  30. package/.claude/agents/flow-nexus/challenges.md +80 -80
  31. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  32. package/.claude/agents/flow-nexus/payments.md +82 -82
  33. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  34. package/.claude/agents/flow-nexus/swarm.md +75 -75
  35. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  36. package/.claude/agents/flow-nexus/workflow.md +83 -83
  37. package/.claude/agents/github/code-review-swarm.md +377 -377
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +575 -575
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +437 -437
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +604 -604
  44. package/.claude/agents/github/release-swarm.md +582 -582
  45. package/.claude/agents/github/repo-architect.md +397 -397
  46. package/.claude/agents/github/swarm-issue.md +572 -572
  47. package/.claude/agents/github/swarm-pr.md +427 -427
  48. package/.claude/agents/github/sync-coordinator.md +451 -451
  49. package/.claude/agents/github/workflow-automation.md +902 -902
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/goal-planner.md +72 -72
  52. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  53. package/.claude/agents/optimization/load-balancer.md +430 -430
  54. package/.claude/agents/optimization/performance-monitor.md +671 -671
  55. package/.claude/agents/optimization/resource-allocator.md +673 -673
  56. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  57. package/.claude/agents/payments/agentic-payments.md +126 -126
  58. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  59. package/.claude/agents/sparc/architecture.md +698 -698
  60. package/.claude/agents/sparc/pseudocode.md +519 -519
  61. package/.claude/agents/sparc/refinement.md +801 -801
  62. package/.claude/agents/sparc/specification.md +477 -477
  63. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  64. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  65. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  66. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  67. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  68. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  69. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  70. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  71. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  72. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  73. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  74. package/.claude/agents/templates/base-template-generator.md +289 -289
  75. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  76. package/.claude/agents/templates/github-pr-manager.md +176 -176
  77. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  78. package/.claude/agents/templates/memory-coordinator.md +186 -186
  79. package/.claude/agents/templates/orchestrator-task.md +138 -138
  80. package/.claude/agents/templates/performance-analyzer.md +198 -198
  81. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  82. package/.claude/agents/testing/production-validator.md +394 -394
  83. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  84. package/.claude/agents/v3/adr-architect.md +184 -184
  85. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  86. package/.claude/agents/v3/claims-authorizer.md +208 -208
  87. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  88. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  89. package/.claude/agents/v3/injection-analyst.md +236 -236
  90. package/.claude/agents/v3/memory-specialist.md +995 -995
  91. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  92. package/.claude/agents/v3/pii-detector.md +151 -151
  93. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  94. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  95. package/.claude/agents/v3/security-architect.md +867 -867
  96. package/.claude/agents/v3/security-auditor.md +771 -771
  97. package/.claude/agents/v3/sparc-orchestrator.md +182 -182
  98. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  99. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  100. package/.claude/commands/agents/README.md +50 -50
  101. package/.claude/commands/agents/agent-capabilities.md +140 -140
  102. package/.claude/commands/agents/agent-coordination.md +28 -28
  103. package/.claude/commands/agents/agent-spawning.md +28 -28
  104. package/.claude/commands/agents/agent-types.md +216 -216
  105. package/.claude/commands/agents/health.md +139 -139
  106. package/.claude/commands/agents/list.md +100 -100
  107. package/.claude/commands/agents/logs.md +130 -130
  108. package/.claude/commands/agents/metrics.md +122 -122
  109. package/.claude/commands/agents/pool.md +127 -127
  110. package/.claude/commands/agents/spawn.md +140 -140
  111. package/.claude/commands/agents/status.md +115 -115
  112. package/.claude/commands/agents/stop.md +102 -102
  113. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  114. package/.claude/commands/analysis/README.md +9 -9
  115. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  116. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  117. package/.claude/commands/analysis/performance-report.md +25 -25
  118. package/.claude/commands/analysis/token-efficiency.md +44 -44
  119. package/.claude/commands/analysis/token-usage.md +25 -25
  120. package/.claude/commands/automation/README.md +9 -9
  121. package/.claude/commands/automation/auto-agent.md +122 -122
  122. package/.claude/commands/automation/self-healing.md +105 -105
  123. package/.claude/commands/automation/session-memory.md +89 -89
  124. package/.claude/commands/automation/smart-agents.md +72 -72
  125. package/.claude/commands/automation/smart-spawn.md +25 -25
  126. package/.claude/commands/automation/workflow-select.md +25 -25
  127. package/.claude/commands/claude-flow-help.md +103 -103
  128. package/.claude/commands/claude-flow-memory.md +107 -107
  129. package/.claude/commands/claude-flow-swarm.md +205 -205
  130. package/.claude/commands/coordination/README.md +9 -9
  131. package/.claude/commands/coordination/agent-spawn.md +25 -25
  132. package/.claude/commands/coordination/init.md +44 -44
  133. package/.claude/commands/coordination/orchestrate.md +43 -43
  134. package/.claude/commands/coordination/spawn.md +45 -45
  135. package/.claude/commands/coordination/swarm-init.md +85 -85
  136. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  137. package/.claude/commands/flow-nexus/app-store.md +123 -123
  138. package/.claude/commands/flow-nexus/challenges.md +119 -119
  139. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  140. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  141. package/.claude/commands/flow-nexus/payments.md +115 -115
  142. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  143. package/.claude/commands/flow-nexus/swarm.md +86 -86
  144. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  145. package/.claude/commands/flow-nexus/workflow.md +114 -114
  146. package/.claude/commands/github/README.md +11 -11
  147. package/.claude/commands/github/code-review-swarm.md +513 -513
  148. package/.claude/commands/github/code-review.md +25 -25
  149. package/.claude/commands/github/github-modes.md +146 -146
  150. package/.claude/commands/github/github-swarm.md +121 -121
  151. package/.claude/commands/github/issue-tracker.md +291 -291
  152. package/.claude/commands/github/issue-triage.md +25 -25
  153. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  154. package/.claude/commands/github/pr-enhance.md +26 -26
  155. package/.claude/commands/github/pr-manager.md +169 -169
  156. package/.claude/commands/github/project-board-sync.md +470 -470
  157. package/.claude/commands/github/release-manager.md +337 -337
  158. package/.claude/commands/github/release-swarm.md +543 -543
  159. package/.claude/commands/github/repo-analyze.md +25 -25
  160. package/.claude/commands/github/repo-architect.md +366 -366
  161. package/.claude/commands/github/swarm-issue.md +481 -481
  162. package/.claude/commands/github/swarm-pr.md +284 -284
  163. package/.claude/commands/github/sync-coordinator.md +300 -300
  164. package/.claude/commands/github/workflow-automation.md +441 -441
  165. package/.claude/commands/hive-mind/README.md +17 -17
  166. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  168. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  173. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  177. package/.claude/commands/hooks/README.md +11 -11
  178. package/.claude/commands/hooks/overview.md +57 -57
  179. package/.claude/commands/hooks/post-edit.md +117 -117
  180. package/.claude/commands/hooks/post-task.md +112 -112
  181. package/.claude/commands/hooks/pre-edit.md +113 -113
  182. package/.claude/commands/hooks/pre-task.md +111 -111
  183. package/.claude/commands/hooks/session-end.md +118 -118
  184. package/.claude/commands/hooks/setup.md +102 -102
  185. package/.claude/commands/memory/README.md +9 -9
  186. package/.claude/commands/memory/memory-persist.md +25 -25
  187. package/.claude/commands/memory/memory-search.md +25 -25
  188. package/.claude/commands/memory/memory-usage.md +25 -25
  189. package/.claude/commands/memory/neural.md +47 -47
  190. package/.claude/commands/monitoring/README.md +9 -9
  191. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  192. package/.claude/commands/monitoring/agents.md +44 -44
  193. package/.claude/commands/monitoring/real-time-view.md +25 -25
  194. package/.claude/commands/monitoring/status.md +46 -46
  195. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  196. package/.claude/commands/optimization/README.md +9 -9
  197. package/.claude/commands/optimization/auto-topology.md +61 -61
  198. package/.claude/commands/optimization/cache-manage.md +25 -25
  199. package/.claude/commands/optimization/parallel-execute.md +25 -25
  200. package/.claude/commands/optimization/parallel-execution.md +49 -49
  201. package/.claude/commands/optimization/topology-optimize.md +25 -25
  202. package/.claude/commands/pair/README.md +260 -260
  203. package/.claude/commands/pair/commands.md +545 -545
  204. package/.claude/commands/pair/config.md +509 -509
  205. package/.claude/commands/pair/examples.md +511 -511
  206. package/.claude/commands/pair/modes.md +347 -347
  207. package/.claude/commands/pair/session.md +406 -406
  208. package/.claude/commands/pair/start.md +208 -208
  209. package/.claude/commands/sparc/analyzer.md +51 -51
  210. package/.claude/commands/sparc/architect.md +53 -53
  211. package/.claude/commands/sparc/ask.md +97 -97
  212. package/.claude/commands/sparc/batch-executor.md +54 -54
  213. package/.claude/commands/sparc/code.md +89 -89
  214. package/.claude/commands/sparc/coder.md +54 -54
  215. package/.claude/commands/sparc/debug.md +83 -83
  216. package/.claude/commands/sparc/debugger.md +54 -54
  217. package/.claude/commands/sparc/designer.md +53 -53
  218. package/.claude/commands/sparc/devops.md +109 -109
  219. package/.claude/commands/sparc/docs-writer.md +80 -80
  220. package/.claude/commands/sparc/documenter.md +54 -54
  221. package/.claude/commands/sparc/innovator.md +54 -54
  222. package/.claude/commands/sparc/integration.md +83 -83
  223. package/.claude/commands/sparc/mcp.md +117 -117
  224. package/.claude/commands/sparc/memory-manager.md +54 -54
  225. package/.claude/commands/sparc/optimizer.md +54 -54
  226. package/.claude/commands/sparc/orchestrator.md +131 -131
  227. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  228. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  229. package/.claude/commands/sparc/researcher.md +54 -54
  230. package/.claude/commands/sparc/reviewer.md +54 -54
  231. package/.claude/commands/sparc/security-review.md +80 -80
  232. package/.claude/commands/sparc/sparc-modes.md +174 -174
  233. package/.claude/commands/sparc/sparc.md +111 -111
  234. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  235. package/.claude/commands/sparc/supabase-admin.md +348 -348
  236. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  237. package/.claude/commands/sparc/tdd.md +54 -54
  238. package/.claude/commands/sparc/tester.md +54 -54
  239. package/.claude/commands/sparc/tutorial.md +79 -79
  240. package/.claude/commands/sparc/workflow-manager.md +54 -54
  241. package/.claude/commands/sparc.md +166 -166
  242. package/.claude/commands/stream-chain/pipeline.md +120 -120
  243. package/.claude/commands/stream-chain/run.md +69 -69
  244. package/.claude/commands/swarm/README.md +15 -15
  245. package/.claude/commands/swarm/analysis.md +95 -95
  246. package/.claude/commands/swarm/development.md +96 -96
  247. package/.claude/commands/swarm/examples.md +168 -168
  248. package/.claude/commands/swarm/maintenance.md +102 -102
  249. package/.claude/commands/swarm/optimization.md +117 -117
  250. package/.claude/commands/swarm/research.md +136 -136
  251. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  252. package/.claude/commands/swarm/swarm-background.md +8 -8
  253. package/.claude/commands/swarm/swarm-init.md +19 -19
  254. package/.claude/commands/swarm/swarm-modes.md +8 -8
  255. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  256. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  257. package/.claude/commands/swarm/swarm-status.md +8 -8
  258. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  259. package/.claude/commands/swarm/swarm.md +87 -87
  260. package/.claude/commands/swarm/testing.md +131 -131
  261. package/.claude/commands/training/README.md +9 -9
  262. package/.claude/commands/training/model-update.md +25 -25
  263. package/.claude/commands/training/neural-patterns.md +107 -107
  264. package/.claude/commands/training/neural-train.md +75 -75
  265. package/.claude/commands/training/pattern-learn.md +25 -25
  266. package/.claude/commands/training/specialization.md +62 -62
  267. package/.claude/commands/truth/start.md +142 -142
  268. package/.claude/commands/verify/check.md +49 -49
  269. package/.claude/commands/verify/start.md +127 -127
  270. package/.claude/commands/workflows/README.md +9 -9
  271. package/.claude/commands/workflows/development.md +77 -77
  272. package/.claude/commands/workflows/research.md +62 -62
  273. package/.claude/commands/workflows/workflow-create.md +25 -25
  274. package/.claude/commands/workflows/workflow-execute.md +25 -25
  275. package/.claude/commands/workflows/workflow-export.md +25 -25
  276. package/.claude/helpers/README.md +96 -96
  277. package/.claude/helpers/adr-compliance.sh +186 -186
  278. package/.claude/helpers/auto-commit.sh +178 -178
  279. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  280. package/.claude/helpers/checkpoint-manager.sh +251 -251
  281. package/.claude/helpers/daemon-manager.sh +252 -252
  282. package/.claude/helpers/ddd-tracker.sh +144 -144
  283. package/.claude/helpers/github-safe.js +121 -121
  284. package/.claude/helpers/github-setup.sh +28 -28
  285. package/.claude/helpers/guidance-hook.sh +13 -13
  286. package/.claude/helpers/guidance-hooks.sh +102 -102
  287. package/.claude/helpers/health-monitor.sh +108 -108
  288. package/.claude/helpers/hook-handler.cjs +278 -278
  289. package/.claude/helpers/intelligence.cjs +1031 -1031
  290. package/.claude/helpers/learning-hooks.sh +329 -329
  291. package/.claude/helpers/learning-optimizer.sh +127 -127
  292. package/.claude/helpers/learning-service.mjs +1144 -1144
  293. package/.claude/helpers/memory.js +83 -83
  294. package/.claude/helpers/metrics-db.mjs +488 -488
  295. package/.claude/helpers/pattern-consolidator.sh +86 -86
  296. package/.claude/helpers/perf-worker.sh +160 -160
  297. package/.claude/helpers/post-commit +16 -16
  298. package/.claude/helpers/pre-commit +26 -26
  299. package/.claude/helpers/quick-start.sh +19 -19
  300. package/.claude/helpers/router.js +66 -66
  301. package/.claude/helpers/security-scanner.sh +127 -127
  302. package/.claude/helpers/session.js +135 -135
  303. package/.claude/helpers/setup-mcp.sh +18 -18
  304. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  305. package/.claude/helpers/statusline-hook.sh +21 -21
  306. package/.claude/helpers/statusline.cjs +575 -575
  307. package/.claude/helpers/statusline.js +321 -321
  308. package/.claude/helpers/swarm-comms.sh +353 -353
  309. package/.claude/helpers/swarm-hooks.sh +761 -761
  310. package/.claude/helpers/swarm-monitor.sh +210 -210
  311. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  312. package/.claude/helpers/update-v3-progress.sh +165 -165
  313. package/.claude/helpers/v3-quick-status.sh +57 -57
  314. package/.claude/helpers/v3.sh +110 -110
  315. package/.claude/helpers/validate-v3-config.sh +215 -215
  316. package/.claude/helpers/worker-manager.sh +170 -170
  317. package/.claude/settings.json +182 -182
  318. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  319. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  320. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  321. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  322. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  323. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  324. package/.claude/skills/aidefence-scan.md +151 -151
  325. package/.claude/skills/aidefence.yaml +297 -297
  326. package/.claude/skills/browser/SKILL.md +204 -204
  327. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  328. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  329. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  330. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  331. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  332. package/.claude/skills/github-project-management/SKILL.md +1290 -1277
  333. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  334. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  335. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  336. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  337. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  338. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  339. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  340. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  341. package/.claude/skills/secure-review.md +181 -181
  342. package/.claude/skills/skill-builder/SKILL.md +910 -910
  343. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  344. package/.claude/skills/stream-chain/SKILL.md +563 -563
  345. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  346. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  347. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  348. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  349. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  350. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  351. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  352. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  353. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  354. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  355. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  356. package/.claude/skills/verification-quality/SKILL.md +649 -649
  357. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  358. package/.claude/skills/worker-integration/skill.md +154 -154
  359. package/README.md +393 -391
  360. package/bin/cli.js +220 -220
  361. package/bin/mcp-server.js +224 -224
  362. package/bin/preinstall.cjs +2 -2
  363. package/dist/src/commands/agent-wasm.js +2 -2
  364. package/dist/src/commands/agent-wasm.js.map +1 -1
  365. package/dist/src/commands/completions.js +409 -409
  366. package/dist/src/commands/daemon.d.ts.map +1 -1
  367. package/dist/src/commands/daemon.js +19 -3
  368. package/dist/src/commands/daemon.js.map +1 -1
  369. package/dist/src/commands/doctor.d.ts.map +1 -1
  370. package/dist/src/commands/doctor.js +105 -23
  371. package/dist/src/commands/doctor.js.map +1 -1
  372. package/dist/src/commands/embeddings.js +26 -26
  373. package/dist/src/commands/hive-mind.d.ts.map +1 -1
  374. package/dist/src/commands/hive-mind.js +122 -104
  375. package/dist/src/commands/hive-mind.js.map +1 -1
  376. package/dist/src/commands/hooks.d.ts.map +1 -1
  377. package/dist/src/commands/hooks.js +34 -21
  378. package/dist/src/commands/hooks.js.map +1 -1
  379. package/dist/src/commands/memory.d.ts.map +1 -1
  380. package/dist/src/commands/memory.js +68 -0
  381. package/dist/src/commands/memory.js.map +1 -1
  382. package/dist/src/commands/ruvector/backup.js +23 -23
  383. package/dist/src/commands/ruvector/benchmark.js +31 -31
  384. package/dist/src/commands/ruvector/import.js +14 -14
  385. package/dist/src/commands/ruvector/init.js +115 -115
  386. package/dist/src/commands/ruvector/migrate.js +99 -99
  387. package/dist/src/commands/ruvector/optimize.js +51 -51
  388. package/dist/src/commands/ruvector/setup.js +624 -624
  389. package/dist/src/commands/ruvector/status.js +38 -38
  390. package/dist/src/index.d.ts +5 -1
  391. package/dist/src/index.d.ts.map +1 -1
  392. package/dist/src/index.js +59 -18
  393. package/dist/src/index.js.map +1 -1
  394. package/dist/src/init/claudemd-generator.js +226 -226
  395. package/dist/src/init/executor.d.ts.map +1 -1
  396. package/dist/src/init/executor.js +511 -453
  397. package/dist/src/init/executor.js.map +1 -1
  398. package/dist/src/init/helpers-generator.js +645 -645
  399. package/dist/src/init/settings-generator.d.ts.map +1 -1
  400. package/dist/src/init/settings-generator.js +11 -5
  401. package/dist/src/init/settings-generator.js.map +1 -1
  402. package/dist/src/init/statusline-generator.js +858 -858
  403. package/dist/src/init/types.d.ts +7 -0
  404. package/dist/src/init/types.d.ts.map +1 -1
  405. package/dist/src/init/types.js.map +1 -1
  406. package/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
  407. package/dist/src/mcp-tools/agentdb-tools.d.ts.map +1 -1
  408. package/dist/src/mcp-tools/agentdb-tools.js +108 -0
  409. package/dist/src/mcp-tools/agentdb-tools.js.map +1 -1
  410. package/dist/src/mcp-tools/hooks-tools.d.ts.map +1 -1
  411. package/dist/src/mcp-tools/hooks-tools.js +4 -2
  412. package/dist/src/mcp-tools/hooks-tools.js.map +1 -1
  413. package/dist/src/mcp-tools/memory-tools.d.ts.map +1 -1
  414. package/dist/src/mcp-tools/memory-tools.js +19 -0
  415. package/dist/src/mcp-tools/memory-tools.js.map +1 -1
  416. package/dist/src/mcp-tools/neural-tools.d.ts.map +1 -1
  417. package/dist/src/mcp-tools/neural-tools.js +14 -1
  418. package/dist/src/mcp-tools/neural-tools.js.map +1 -1
  419. package/dist/src/mcp-tools/security-tools.d.ts.map +1 -1
  420. package/dist/src/mcp-tools/security-tools.js +28 -3
  421. package/dist/src/mcp-tools/security-tools.js.map +1 -1
  422. package/dist/src/mcp-tools/swarm-tools.d.ts.map +1 -1
  423. package/dist/src/mcp-tools/swarm-tools.js +72 -3
  424. package/dist/src/mcp-tools/swarm-tools.js.map +1 -1
  425. package/dist/src/mcp-tools/types.d.ts +4 -33
  426. package/dist/src/mcp-tools/types.d.ts.map +1 -1
  427. package/dist/src/mcp-tools/types.js +4 -14
  428. package/dist/src/mcp-tools/types.js.map +1 -1
  429. package/dist/src/mcp-tools/validate-input.d.ts +5 -57
  430. package/dist/src/mcp-tools/validate-input.d.ts.map +1 -1
  431. package/dist/src/mcp-tools/validate-input.js +5 -233
  432. package/dist/src/mcp-tools/validate-input.js.map +1 -1
  433. package/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
  434. package/dist/src/mcp-tools/wasm-agent-tools.js.map +1 -1
  435. package/dist/src/memory/intelligence.d.ts.map +1 -1
  436. package/dist/src/memory/intelligence.js +28 -3
  437. package/dist/src/memory/intelligence.js.map +1 -1
  438. package/dist/src/memory/memory-bridge.d.ts +69 -0
  439. package/dist/src/memory/memory-bridge.d.ts.map +1 -1
  440. package/dist/src/memory/memory-bridge.js +319 -66
  441. package/dist/src/memory/memory-bridge.js.map +1 -1
  442. package/dist/src/memory/memory-initializer.d.ts +5 -0
  443. package/dist/src/memory/memory-initializer.d.ts.map +1 -1
  444. package/dist/src/memory/memory-initializer.js +369 -363
  445. package/dist/src/memory/memory-initializer.js.map +1 -1
  446. package/dist/src/memory/neural-package-bridge.d.ts +48 -0
  447. package/dist/src/memory/neural-package-bridge.d.ts.map +1 -0
  448. package/dist/src/memory/neural-package-bridge.js +87 -0
  449. package/dist/src/memory/neural-package-bridge.js.map +1 -0
  450. package/dist/src/memory/rabitq-index.js +5 -5
  451. package/dist/src/memory/sona-optimizer.d.ts.map +1 -1
  452. package/dist/src/memory/sona-optimizer.js +1 -0
  453. package/dist/src/memory/sona-optimizer.js.map +1 -1
  454. package/dist/src/output.d.ts +6 -130
  455. package/dist/src/output.d.ts.map +1 -1
  456. package/dist/src/output.js +6 -511
  457. package/dist/src/output.js.map +1 -1
  458. package/dist/src/parser.d.ts +9 -0
  459. package/dist/src/parser.d.ts.map +1 -1
  460. package/dist/src/parser.js +11 -0
  461. package/dist/src/parser.js.map +1 -1
  462. package/dist/src/runtime/headless.js +28 -28
  463. package/dist/src/ruvector/agent-wasm.d.ts.map +1 -1
  464. package/dist/src/ruvector/agent-wasm.js +4 -1
  465. package/dist/src/ruvector/agent-wasm.js.map +1 -1
  466. package/dist/src/ruvector/index.d.ts +0 -2
  467. package/dist/src/ruvector/index.d.ts.map +1 -1
  468. package/dist/src/ruvector/index.js +8 -2
  469. package/dist/src/ruvector/index.js.map +1 -1
  470. package/dist/src/ruvector/model-router.d.ts +22 -1
  471. package/dist/src/ruvector/model-router.d.ts.map +1 -1
  472. package/dist/src/ruvector/model-router.js +125 -5
  473. package/dist/src/ruvector/model-router.js.map +1 -1
  474. package/dist/src/services/headless-worker-executor.js +84 -84
  475. package/dist/src/transfer/deploy-seraphine.js +23 -23
  476. package/dist/src/types.d.ts +10 -195
  477. package/dist/src/types.d.ts.map +1 -1
  478. package/dist/src/types.js +10 -35
  479. package/dist/src/types.js.map +1 -1
  480. package/dist/tsconfig.tsbuildinfo +1 -1
  481. package/package.json +6 -4
  482. package/scripts/deploy-ipfs-node.sh +153 -153
  483. package/scripts/postinstall.cjs +153 -153
  484. package/scripts/publish-registry.ts +345 -345
  485. package/scripts/publish.sh +57 -57
  486. package/scripts/setup-ipfs-registry.md +366 -366
  487. package/dist/src/services/event-stream.d.ts.map +0 -1
  488. package/dist/src/services/event-stream.js.map +0 -1
  489. package/dist/src/services/loop-worker-runner.d.ts.map +0 -1
  490. package/dist/src/services/loop-worker-runner.js.map +0 -1
  491. package/dist/src/services/runtime-capabilities.d.ts.map +0 -1
  492. package/dist/src/services/runtime-capabilities.js.map +0 -1
@@ -1,1031 +1,1031 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Intelligence Layer (ADR-050)
4
- *
5
- * Closes the intelligence loop by wiring PageRank-ranked memory into
6
- * the hook system. Pure CJS — no ESM imports of @claude-flow/memory.
7
- *
8
- * Data files (all under .claude-flow/data/):
9
- * auto-memory-store.json — written by auto-memory-hook.mjs
10
- * graph-state.json — serialized graph (nodes + edges + pageRanks)
11
- * ranked-context.json — pre-computed ranked entries for fast lookup
12
- * pending-insights.jsonl — append-only edit/task log
13
- */
14
-
15
- 'use strict';
16
-
17
- const fs = require('fs');
18
- const path = require('path');
19
-
20
- const DATA_DIR = path.join(process.cwd(), '.claude-flow', 'data');
21
- const STORE_PATH = path.join(DATA_DIR, 'auto-memory-store.json');
22
- const GRAPH_PATH = path.join(DATA_DIR, 'graph-state.json');
23
- const RANKED_PATH = path.join(DATA_DIR, 'ranked-context.json');
24
- const PENDING_PATH = path.join(DATA_DIR, 'pending-insights.jsonl');
25
- const SESSION_DIR = path.join(process.cwd(), '.claude-flow', 'sessions');
26
- const SESSION_FILE = path.join(SESSION_DIR, 'current.json');
27
-
28
- // ── Safety limits (fixes #1530, #1531) ─────────────────────────────────────
29
- const MAX_DATA_FILE_SIZE = 10 * 1024 * 1024; // 10 MB — skip files larger than this
30
- const MAX_GRAPH_NODES = 5000; // skip PageRank if graph exceeds this
31
-
32
- // ── Stop words for trigram matching ──────────────────────────────────────────
33
-
34
- const STOP_WORDS = new Set([
35
- 'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
36
- 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
37
- 'should', 'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'for',
38
- 'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
39
- 'before', 'after', 'and', 'but', 'or', 'nor', 'not', 'so', 'yet',
40
- 'both', 'either', 'neither', 'each', 'every', 'all', 'any', 'few',
41
- 'more', 'most', 'other', 'some', 'such', 'no', 'only', 'own', 'same',
42
- 'than', 'too', 'very', 'just', 'because', 'if', 'when', 'which',
43
- 'who', 'whom', 'this', 'that', 'these', 'those', 'it', 'its',
44
- ]);
45
-
46
- // ── Helpers ──────────────────────────────────────────────────────────────────
47
-
48
- function ensureDataDir() {
49
- if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
50
- }
51
-
52
- function readJSON(filePath) {
53
- // Safety: skip files exceeding MAX_DATA_FILE_SIZE (#1531)
54
- try {
55
- const stat = fs.statSync(filePath);
56
- if (stat.size > MAX_DATA_FILE_SIZE) {
57
- process.stderr.write("[INTELLIGENCE] WARN: Skipping " + path.basename(filePath) + " (" + Math.round(stat.size / 1048576) + "MB exceeds 10MB limit)\n");
58
- return null;
59
- }
60
- } catch { /* file may not exist yet */ }
61
- try {
62
- if (fs.existsSync(filePath)) return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
63
- } catch { /* corrupt file — start fresh */ }
64
- return null;
65
- }
66
-
67
- function writeJSON(filePath, data) {
68
- ensureDataDir();
69
- fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
70
- }
71
-
72
- function tokenize(text) {
73
- if (!text) return [];
74
- return text.toLowerCase()
75
- .replace(/[^a-z0-9\s-]/g, ' ')
76
- .split(/\s+/)
77
- .filter(w => w.length > 2 && !STOP_WORDS.has(w));
78
- }
79
-
80
- function trigrams(words) {
81
- const t = new Set();
82
- for (const w of words) {
83
- for (let i = 0; i <= w.length - 3; i++) t.add(w.slice(i, i + 3));
84
- }
85
- return t;
86
- }
87
-
88
- function jaccardSimilarity(setA, setB) {
89
- if (setA.size === 0 && setB.size === 0) return 0;
90
- let intersection = 0;
91
- for (const item of setA) { if (setB.has(item)) intersection++; }
92
- return intersection / (setA.size + setB.size - intersection);
93
- }
94
-
95
- // ── Deduplication helper (fixes #1518) ──────────────────────────────────────
96
-
97
- function deduplicateById(entries) {
98
- if (!entries || !Array.isArray(entries)) return entries;
99
- const seen = new Map();
100
- for (const entry of entries) {
101
- const id = entry.id || entry.key;
102
- if (id) {
103
- seen.set(id, entry);
104
- } else {
105
- seen.set(`__no_id_${seen.size}`, entry);
106
- }
107
- }
108
- return Array.from(seen.values());
109
- }
110
-
111
- // ADR-095 G6 — content-hash dedup. The April audit measured 5,706 entries
112
- // in the auto-memory store with only ~20 unique by content; 5,686 dupes
113
- // were the same MEMORY.md sections imported from sibling project dirs
114
- // with different IDs. deduplicateById can't catch these (the IDs really
115
- // are different); we need a content fingerprint.
116
- //
117
- // Fast non-cryptographic fingerprint — collisions on 64-bit FNV-1a are
118
- // vanishingly rare for human prose at the scale of an auto-memory store.
119
- // Whitespace-normalized so trivially-different formatting doesn't bypass dedup.
120
- function fingerprintContent(text) {
121
- if (typeof text !== 'string' || text.length === 0) return '0';
122
- const norm = text.replace(/\s+/g, ' ').trim().toLowerCase();
123
- // FNV-1a 64-bit (split into 32-bit halves to stay within Number safe int)
124
- let h1 = 0x811c9dc5, h2 = 0xcbf29ce4;
125
- for (let i = 0; i < norm.length; i++) {
126
- const c = norm.charCodeAt(i);
127
- h1 ^= c; h1 = Math.imul(h1, 0x01000193) >>> 0;
128
- h2 ^= c; h2 = Math.imul(h2, 0x100000001b3 & 0xffffffff) >>> 0;
129
- }
130
- return `${h1.toString(16)}_${h2.toString(16)}_${norm.length}`;
131
- }
132
-
133
- function deduplicateByContent(entries) {
134
- if (!entries || !Array.isArray(entries)) return entries;
135
- const seen = new Map();
136
- for (const entry of entries) {
137
- const content = entry.content || entry.summary || entry.value || '';
138
- const fp = fingerprintContent(typeof content === 'string' ? content : JSON.stringify(content));
139
- if (!seen.has(fp)) {
140
- seen.set(fp, entry);
141
- } else {
142
- // Keep the entry with the higher accessCount or earlier createdAt
143
- const existing = seen.get(fp);
144
- const existingAccess = existing.accessCount || 0;
145
- const candidateAccess = entry.accessCount || 0;
146
- if (candidateAccess > existingAccess) seen.set(fp, entry);
147
- }
148
- }
149
- return Array.from(seen.values());
150
- }
151
-
152
- // ── Session state helpers ────────────────────────────────────────────────────
153
-
154
- function sessionGet(key) {
155
- try {
156
- if (!fs.existsSync(SESSION_FILE)) return null;
157
- const session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
158
- return key ? (session.context || {})[key] : session.context;
159
- } catch { return null; }
160
- }
161
-
162
- function sessionSet(key, value) {
163
- try {
164
- if (!fs.existsSync(SESSION_DIR)) fs.mkdirSync(SESSION_DIR, { recursive: true });
165
- let session = {};
166
- if (fs.existsSync(SESSION_FILE)) {
167
- session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
168
- }
169
- if (!session.context) session.context = {};
170
- session.context[key] = value;
171
- session.updatedAt = new Date().toISOString();
172
- fs.writeFileSync(SESSION_FILE, JSON.stringify(session, null, 2), 'utf-8');
173
- } catch { /* best effort */ }
174
- }
175
-
176
- // ── PageRank ─────────────────────────────────────────────────────────────────
177
-
178
- function computePageRank(nodes, edges, damping, maxIter) {
179
- damping = damping || 0.85;
180
- maxIter = maxIter || 30;
181
-
182
- const ids = Object.keys(nodes);
183
- const n = ids.length;
184
- if (n === 0) return {};
185
-
186
- // Build adjacency: outgoing edges per node
187
- const outLinks = {};
188
- const inLinks = {};
189
- for (const id of ids) { outLinks[id] = []; inLinks[id] = []; }
190
- for (const edge of edges) {
191
- if (outLinks[edge.sourceId]) outLinks[edge.sourceId].push(edge.targetId);
192
- if (inLinks[edge.targetId]) inLinks[edge.targetId].push(edge.sourceId);
193
- }
194
-
195
- // Initialize ranks
196
- const ranks = {};
197
- for (const id of ids) ranks[id] = 1 / n;
198
-
199
- // Power iteration (with dangling node redistribution)
200
- for (let iter = 0; iter < maxIter; iter++) {
201
- const newRanks = {};
202
- let diff = 0;
203
-
204
- // Collect rank from dangling nodes (no outgoing edges)
205
- let danglingSum = 0;
206
- for (const id of ids) {
207
- if (outLinks[id].length === 0) danglingSum += ranks[id];
208
- }
209
-
210
- for (const id of ids) {
211
- let sum = 0;
212
- for (const src of inLinks[id]) {
213
- const outCount = outLinks[src].length;
214
- if (outCount > 0) sum += ranks[src] / outCount;
215
- }
216
- // Dangling rank distributed evenly + teleport
217
- newRanks[id] = (1 - damping) / n + damping * (sum + danglingSum / n);
218
- diff += Math.abs(newRanks[id] - ranks[id]);
219
- }
220
-
221
- for (const id of ids) ranks[id] = newRanks[id];
222
- if (diff < 1e-6) break; // converged
223
- }
224
-
225
- return ranks;
226
- }
227
-
228
- // ── Edge building ────────────────────────────────────────────────────────────
229
-
230
- function buildEdges(entries) {
231
- const edges = [];
232
- const byCategory = {};
233
-
234
- for (const entry of entries) {
235
- const cat = entry.category || entry.namespace || 'default';
236
- if (!byCategory[cat]) byCategory[cat] = [];
237
- byCategory[cat].push(entry);
238
- }
239
-
240
- // Temporal edges: entries from same sourceFile
241
- const byFile = {};
242
- for (const entry of entries) {
243
- const file = (entry.metadata && entry.metadata.sourceFile) || null;
244
- if (file) {
245
- if (!byFile[file]) byFile[file] = [];
246
- byFile[file].push(entry);
247
- }
248
- }
249
- for (const file of Object.keys(byFile)) {
250
- const group = byFile[file];
251
- for (let i = 0; i < group.length - 1; i++) {
252
- edges.push({
253
- sourceId: group[i].id,
254
- targetId: group[i + 1].id,
255
- type: 'temporal',
256
- weight: 0.5,
257
- });
258
- }
259
- }
260
-
261
- // Similarity edges within categories (Jaccard > 0.3).
262
- // ADR-095 G6 perf: hoist the trigram computation outside the inner
263
- // loop. Previously we re-tokenized + re-trigrammed group[j] for every
264
- // i — O(n²) extra work for nothing. Now compute once per entry.
265
- for (const cat of Object.keys(byCategory)) {
266
- const group = byCategory[cat];
267
- if (group.length < 2) continue;
268
-
269
- // Cache trigram sets for every entry in the group.
270
- const triCache = new Array(group.length);
271
- for (let i = 0; i < group.length; i++) {
272
- triCache[i] = trigrams(tokenize(group[i].content || group[i].summary || ''));
273
- }
274
-
275
- for (let i = 0; i < group.length; i++) {
276
- const triA = triCache[i];
277
- for (let j = i + 1; j < group.length; j++) {
278
- const sim = jaccardSimilarity(triA, triCache[j]);
279
- if (sim > 0.3) {
280
- edges.push({
281
- sourceId: group[i].id,
282
- targetId: group[j].id,
283
- type: 'similar',
284
- weight: sim,
285
- });
286
- }
287
- }
288
- }
289
- }
290
-
291
- return edges;
292
- }
293
-
294
- // ── Bootstrap from MEMORY.md files ───────────────────────────────────────────
295
-
296
- /**
297
- * If auto-memory-store.json is empty, bootstrap by parsing MEMORY.md and
298
- * topic files from the auto-memory directory. This removes the dependency
299
- * on @claude-flow/memory for the initial seed.
300
- */
301
- function bootstrapFromMemoryFiles() {
302
- const entries = [];
303
- const cwd = process.cwd();
304
-
305
- // Search for auto-memory directories
306
- const candidates = [
307
- // Claude Code auto-memory (project-scoped)
308
- path.join(require('os').homedir(), '.claude', 'projects'),
309
- // Local project memory
310
- path.join(cwd, '.claude-flow', 'memory'),
311
- path.join(cwd, '.claude', 'memory'),
312
- ];
313
-
314
- // Find MEMORY.md in project-scoped dirs
315
- for (const base of candidates) {
316
- if (!fs.existsSync(base)) continue;
317
-
318
- // For the projects dir, scope to CURRENT project only (not all 51+ dirs)
319
- if (base.endsWith('projects')) {
320
- try {
321
- const projectSlug = cwd.replace(/^\//, '').replace(/\//g, '-');
322
- const memDir = path.join(base, projectSlug, 'memory');
323
- if (fs.existsSync(memDir)) {
324
- parseMemoryDir(memDir, entries);
325
- }
326
- } catch { /* skip */ }
327
- } else if (fs.existsSync(base)) {
328
- parseMemoryDir(base, entries);
329
- }
330
- }
331
-
332
- return entries;
333
- }
334
-
335
- function parseMemoryDir(dir, entries) {
336
- try {
337
- const files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
338
- for (const file of files) {
339
- const filePath = path.join(dir, file);
340
- const content = fs.readFileSync(filePath, 'utf-8');
341
- if (!content.trim()) continue;
342
-
343
- // Parse markdown sections as separate entries
344
- const sections = content.split(/^##?\s+/m).filter(Boolean);
345
- for (let sIdx = 0; sIdx < sections.length; sIdx++) {
346
- const section = sections[sIdx];
347
- const lines = section.trim().split('\n');
348
- const title = lines[0].trim();
349
- const body = lines.slice(1).join('\n').trim();
350
- if (!body || body.length < 10) continue;
351
-
352
- const id = `mem-${file.replace('.md', '')}-${title.replace(/[^a-z0-9]/gi, '-').toLowerCase().slice(0, 30)}-${sIdx}`;
353
- entries.push({
354
- id,
355
- key: title.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50),
356
- content: body.slice(0, 500),
357
- summary: title,
358
- namespace: file === 'MEMORY.md' ? 'core' : file.replace('.md', ''),
359
- type: 'semantic',
360
- metadata: { sourceFile: filePath, bootstrapped: true },
361
- createdAt: Date.now(),
362
- });
363
- }
364
- }
365
- } catch { /* skip unreadable dirs */ }
366
- }
367
-
368
- // ── Exported functions ───────────────────────────────────────────────────────
369
-
370
- /**
371
- * init() — Called from session-restore. Budget: <200ms.
372
- * Reads auto-memory-store.json, builds graph, computes PageRank, writes caches.
373
- * If store is empty, bootstraps from MEMORY.md files directly.
374
- */
375
- function init() {
376
- ensureDataDir();
377
-
378
- // Check if graph-state.json is fresh (within 60s of store)
379
- const graphState = readJSON(GRAPH_PATH);
380
- let store = readJSON(STORE_PATH);
381
-
382
- // Bootstrap from MEMORY.md files if store is empty
383
- if (!store || !Array.isArray(store) || store.length === 0) {
384
- const bootstrapped = bootstrapFromMemoryFiles();
385
- if (bootstrapped.length > 0) {
386
- store = bootstrapped;
387
- writeJSON(STORE_PATH, store);
388
- } else {
389
- return { nodes: 0, edges: 0, message: 'No memory entries to index' };
390
- }
391
- }
392
-
393
- // Deduplicate store entries by ID (fixes #1518 — 194MB → ~79KB)
394
- let deduped = deduplicateById(store);
395
- // ADR-095 G6: also dedupe by content fingerprint. The April audit
396
- // measured 5,706 entries with only ~20 unique by content because the
397
- // same MEMORY.md sections get imported from sibling project dirs with
398
- // different IDs. deduplicateById can't catch that; deduplicateByContent
399
- // can. Cuts the graph from O(n²) over near-identical duplicates down
400
- // to O(unique²), which is the difference between a 100MB graph-state
401
- // and a kilobytes-scale one for typical workloads.
402
- const beforeContentDedup = deduped.length;
403
- deduped = deduplicateByContent(deduped);
404
- if (deduped.length < store.length) {
405
- process.stderr.write(
406
- `[INTELLIGENCE] Deduped store: ${store.length} -> ${deduped.length} entries ` +
407
- `(by-id: ${store.length - beforeContentDedup} dropped, by-content: ${beforeContentDedup - deduped.length} dropped)\n`
408
- );
409
- writeJSON(STORE_PATH, deduped);
410
- }
411
-
412
- // Skip rebuild if graph is fresh and store hasn't changed
413
- if (graphState && graphState.nodeCount === deduped.length) {
414
- const age = Date.now() - (graphState.updatedAt || 0);
415
- if (age < 60000) {
416
- return {
417
- nodes: graphState.nodeCount || Object.keys(graphState.nodes || {}).length,
418
- edges: (graphState.edges || []).length,
419
- message: 'Graph cache hit',
420
- };
421
- }
422
- }
423
-
424
- // Build nodes from deduped entries
425
- const nodes = {};
426
- for (const entry of deduped) {
427
- const id = entry.id || entry.key || `entry-${Math.random().toString(36).slice(2, 8)}`;
428
- nodes[id] = {
429
- id,
430
- category: entry.namespace || entry.type || 'default',
431
- confidence: (entry.metadata && entry.metadata.confidence) || 0.5,
432
- accessCount: (entry.metadata && entry.metadata.accessCount) || 0,
433
- createdAt: entry.createdAt || Date.now(),
434
- };
435
- // Ensure entry has id for edge building
436
- entry.id = id;
437
- }
438
-
439
- // Build edges
440
- const edges = buildEdges(deduped);
441
-
442
- // Compute PageRank (skip if graph too large — #1531)
443
- const nodeCount = Object.keys(nodes).length;
444
- let pageRanks = {};
445
- if (nodeCount > MAX_GRAPH_NODES) {
446
- process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank\n");
447
- for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
448
- } else {
449
- pageRanks = computePageRank(nodes, edges, 0.85, 30);
450
- }
451
-
452
- // Write graph state
453
- const graph = {
454
- version: 1,
455
- updatedAt: Date.now(),
456
- nodeCount: Object.keys(nodes).length,
457
- nodes,
458
- edges,
459
- pageRanks,
460
- };
461
- writeJSON(GRAPH_PATH, graph);
462
-
463
- // Build ranked context for fast lookup
464
- const rankedEntries = deduped.map(entry => {
465
- const id = entry.id;
466
- const content = entry.content || entry.value || '';
467
- const summary = entry.summary || entry.key || '';
468
- const words = tokenize(content + ' ' + summary);
469
- return {
470
- id,
471
- content,
472
- summary,
473
- category: entry.namespace || entry.type || 'default',
474
- confidence: nodes[id] ? nodes[id].confidence : 0.5,
475
- pageRank: pageRanks[id] || 0,
476
- accessCount: nodes[id] ? nodes[id].accessCount : 0,
477
- words,
478
- };
479
- }).sort((a, b) => {
480
- const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
481
- const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
482
- return scoreB - scoreA;
483
- });
484
-
485
- const ranked = {
486
- version: 1,
487
- computedAt: Date.now(),
488
- entries: rankedEntries,
489
- };
490
- writeJSON(RANKED_PATH, ranked);
491
-
492
- return {
493
- nodes: Object.keys(nodes).length,
494
- edges: edges.length,
495
- message: 'Graph built and ranked',
496
- };
497
- }
498
-
499
- /**
500
- * getContext(prompt) — Called from route. Budget: <15ms.
501
- * Matches prompt to ranked entries, returns top-5 formatted context.
502
- */
503
- function getContext(prompt) {
504
- if (!prompt) return null;
505
-
506
- const ranked = readJSON(RANKED_PATH);
507
- if (!ranked || !ranked.entries || ranked.entries.length === 0) return null;
508
-
509
- const promptWords = tokenize(prompt);
510
- if (promptWords.length === 0) return null;
511
- const promptTrigrams = trigrams(promptWords);
512
-
513
- const ALPHA = 0.6; // content match weight
514
- const MIN_THRESHOLD = 0.05;
515
- const TOP_K = 5;
516
-
517
- // Score each entry
518
- const scored = [];
519
- for (const entry of ranked.entries) {
520
- const entryTrigrams = trigrams(entry.words || []);
521
- const contentMatch = jaccardSimilarity(promptTrigrams, entryTrigrams);
522
- const score = ALPHA * contentMatch + (1 - ALPHA) * (entry.pageRank || 0);
523
- if (score >= MIN_THRESHOLD) {
524
- scored.push({ ...entry, score });
525
- }
526
- }
527
-
528
- if (scored.length === 0) return null;
529
-
530
- // Sort by score descending, take top-K
531
- scored.sort((a, b) => b.score - a.score);
532
- const topEntries = scored.slice(0, TOP_K);
533
-
534
- // Boost previously matched patterns (implicit success: user continued working)
535
- const prevMatched = sessionGet('lastMatchedPatterns');
536
-
537
- // Store NEW matched IDs in session state for feedback
538
- const matchedIds = topEntries.map(e => e.id);
539
- sessionSet('lastMatchedPatterns', matchedIds);
540
-
541
- // Only boost previous if they differ from current (avoid double-boosting)
542
- if (prevMatched && Array.isArray(prevMatched)) {
543
- const newSet = new Set(matchedIds);
544
- const toBoost = prevMatched.filter(id => !newSet.has(id));
545
- if (toBoost.length > 0) boostConfidence(toBoost, 0.03);
546
- }
547
-
548
- // Format output
549
- const lines = ['[INTELLIGENCE] Relevant patterns for this task:'];
550
- for (let i = 0; i < topEntries.length; i++) {
551
- const e = topEntries[i];
552
- const display = (e.summary || e.content || '').slice(0, 80);
553
- const accessed = e.accessCount || 0;
554
- lines.push(` * (${e.score.toFixed(2)}) ${display} [rank #${i + 1}, ${accessed}x accessed]`);
555
- }
556
-
557
- return lines.join('\n');
558
- }
559
-
560
- /**
561
- * recordEdit(file) — Called from post-edit. Budget: <2ms.
562
- * Appends to pending-insights.jsonl.
563
- */
564
- function recordEdit(file) {
565
- ensureDataDir();
566
- const entry = JSON.stringify({
567
- type: 'edit',
568
- file: file || 'unknown',
569
- timestamp: Date.now(),
570
- sessionId: sessionGet('sessionId') || null,
571
- });
572
- fs.appendFileSync(PENDING_PATH, entry + '\n', 'utf-8');
573
- }
574
-
575
- /**
576
- * feedback(success) — Called from post-task. Budget: <10ms.
577
- * Boosts or decays confidence for last-matched patterns.
578
- */
579
- function feedback(success) {
580
- const matchedIds = sessionGet('lastMatchedPatterns');
581
- if (!matchedIds || !Array.isArray(matchedIds)) return;
582
-
583
- const amount = success ? 0.05 : -0.02;
584
- boostConfidence(matchedIds, amount);
585
- }
586
-
587
- function boostConfidence(ids, amount) {
588
- const ranked = readJSON(RANKED_PATH);
589
- if (!ranked || !ranked.entries) return;
590
-
591
- let changed = false;
592
- for (const entry of ranked.entries) {
593
- if (ids.includes(entry.id)) {
594
- entry.confidence = Math.max(0, Math.min(1, (entry.confidence || 0.5) + amount));
595
- entry.accessCount = (entry.accessCount || 0) + 1;
596
- changed = true;
597
- }
598
- }
599
-
600
- if (changed) writeJSON(RANKED_PATH, ranked);
601
-
602
- // Also update graph-state confidence
603
- const graph = readJSON(GRAPH_PATH);
604
- if (graph && graph.nodes) {
605
- for (const id of ids) {
606
- if (graph.nodes[id]) {
607
- graph.nodes[id].confidence = Math.max(0, Math.min(1, (graph.nodes[id].confidence || 0.5) + amount));
608
- graph.nodes[id].accessCount = (graph.nodes[id].accessCount || 0) + 1;
609
- }
610
- }
611
- writeJSON(GRAPH_PATH, graph);
612
- }
613
- }
614
-
615
- /**
616
- * consolidate() — Called from session-end. Budget: <500ms.
617
- * Processes pending insights, rebuilds edges, recomputes PageRank.
618
- */
619
- function consolidate() {
620
- ensureDataDir();
621
-
622
- let store = readJSON(STORE_PATH);
623
- if (!store || !Array.isArray(store)) {
624
- return { entries: 0, edges: 0, newEntries: 0, message: 'No store to consolidate' };
625
- }
626
-
627
- // Deduplicate store entries by ID before processing (fixes #1518)
628
- const preDedupCount = store.length;
629
- store = deduplicateById(store);
630
-
631
- // 1. Process pending insights
632
- let newEntries = 0;
633
- if (fs.existsSync(PENDING_PATH)) {
634
- const lines = fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean);
635
- const editCounts = {};
636
- for (const line of lines) {
637
- try {
638
- const insight = JSON.parse(line);
639
- if (insight.file) {
640
- editCounts[insight.file] = (editCounts[insight.file] || 0) + 1;
641
- }
642
- } catch { /* skip malformed */ }
643
- }
644
-
645
- // Create entries for frequently-edited files (3+ edits)
646
- for (const [file, count] of Object.entries(editCounts)) {
647
- if (count >= 3) {
648
- const exists = store.some(e =>
649
- (e.metadata && e.metadata.sourceFile === file && e.metadata.autoGenerated)
650
- );
651
- if (!exists) {
652
- store.push({
653
- id: `insight-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
654
- key: `frequent-edit-${path.basename(file)}`,
655
- content: `File ${file} was edited ${count} times this session — likely a hot path worth monitoring.`,
656
- summary: `Frequently edited: ${path.basename(file)} (${count}x)`,
657
- namespace: 'insights',
658
- type: 'procedural',
659
- metadata: { sourceFile: file, editCount: count, autoGenerated: true },
660
- createdAt: Date.now(),
661
- });
662
- newEntries++;
663
- }
664
- }
665
- }
666
-
667
- // Clear pending
668
- fs.writeFileSync(PENDING_PATH, '', 'utf-8');
669
- }
670
-
671
- // 2. Confidence decay for unaccessed entries
672
- const graph = readJSON(GRAPH_PATH);
673
- if (graph && graph.nodes) {
674
- const now = Date.now();
675
- for (const id of Object.keys(graph.nodes)) {
676
- const node = graph.nodes[id];
677
- const hoursSinceCreation = (now - (node.createdAt || now)) / (1000 * 60 * 60);
678
- if (node.accessCount === 0 && hoursSinceCreation > 24) {
679
- node.confidence = Math.max(0.05, (node.confidence || 0.5) - 0.005 * Math.floor(hoursSinceCreation / 24));
680
- }
681
- }
682
- }
683
-
684
- // 3. Rebuild edges with updated store
685
- for (const entry of store) {
686
- if (!entry.id) entry.id = `entry-${Math.random().toString(36).slice(2, 8)}`;
687
- }
688
- const edges = buildEdges(store);
689
-
690
- // 4. Build updated nodes
691
- const nodes = {};
692
- for (const entry of store) {
693
- nodes[entry.id] = {
694
- id: entry.id,
695
- category: entry.namespace || entry.type || 'default',
696
- confidence: (graph && graph.nodes && graph.nodes[entry.id])
697
- ? graph.nodes[entry.id].confidence
698
- : (entry.metadata && entry.metadata.confidence) || 0.5,
699
- accessCount: (graph && graph.nodes && graph.nodes[entry.id])
700
- ? graph.nodes[entry.id].accessCount
701
- : (entry.metadata && entry.metadata.accessCount) || 0,
702
- createdAt: entry.createdAt || Date.now(),
703
- };
704
- }
705
-
706
- // 5. Recompute PageRank (skip if graph too large — #1531)
707
- const nodeCount = Object.keys(nodes).length;
708
- let pageRanks = {};
709
- if (nodeCount > MAX_GRAPH_NODES) {
710
- process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank in consolidate\n");
711
- for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
712
- } else {
713
- pageRanks = computePageRank(nodes, edges, 0.85, 30);
714
- }
715
-
716
- // 6. Write updated graph
717
- writeJSON(GRAPH_PATH, {
718
- version: 1,
719
- updatedAt: Date.now(),
720
- nodeCount: Object.keys(nodes).length,
721
- nodes,
722
- edges,
723
- pageRanks,
724
- });
725
-
726
- // 7. Write updated ranked context
727
- const rankedEntries = store.map(entry => {
728
- const id = entry.id;
729
- const content = entry.content || entry.value || '';
730
- const summary = entry.summary || entry.key || '';
731
- const words = tokenize(content + ' ' + summary);
732
- return {
733
- id,
734
- content,
735
- summary,
736
- category: entry.namespace || entry.type || 'default',
737
- confidence: nodes[id] ? nodes[id].confidence : 0.5,
738
- pageRank: pageRanks[id] || 0,
739
- accessCount: nodes[id] ? nodes[id].accessCount : 0,
740
- words,
741
- };
742
- }).sort((a, b) => {
743
- const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
744
- const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
745
- return scoreB - scoreA;
746
- });
747
-
748
- writeJSON(RANKED_PATH, {
749
- version: 1,
750
- computedAt: Date.now(),
751
- entries: rankedEntries,
752
- });
753
-
754
- // 8. Persist updated store (deduped or with new insight entries)
755
- if (newEntries > 0 || store.length < preDedupCount) writeJSON(STORE_PATH, store);
756
-
757
- // 9. Save snapshot for delta tracking
758
- const updatedGraph = readJSON(GRAPH_PATH);
759
- const updatedRanked = readJSON(RANKED_PATH);
760
- saveSnapshot(updatedGraph, updatedRanked);
761
-
762
- return {
763
- entries: store.length,
764
- edges: edges.length,
765
- newEntries,
766
- message: 'Consolidated',
767
- };
768
- }
769
-
770
- // ── Snapshot for delta tracking ─────────────────────────────────────────────
771
-
772
- const SNAPSHOT_PATH = path.join(DATA_DIR, 'intelligence-snapshot.json');
773
-
774
- function saveSnapshot(graph, ranked) {
775
- const snap = {
776
- timestamp: Date.now(),
777
- nodes: graph ? Object.keys(graph.nodes || {}).length : 0,
778
- edges: graph ? (graph.edges || []).length : 0,
779
- pageRankSum: 0,
780
- confidences: [],
781
- accessCounts: [],
782
- topPatterns: [],
783
- };
784
-
785
- if (graph && graph.pageRanks) {
786
- for (const v of Object.values(graph.pageRanks)) snap.pageRankSum += v;
787
- }
788
- if (graph && graph.nodes) {
789
- for (const n of Object.values(graph.nodes)) {
790
- snap.confidences.push(n.confidence || 0.5);
791
- snap.accessCounts.push(n.accessCount || 0);
792
- }
793
- }
794
- if (ranked && ranked.entries) {
795
- snap.topPatterns = ranked.entries.slice(0, 10).map(e => ({
796
- id: e.id,
797
- summary: (e.summary || '').slice(0, 60),
798
- confidence: e.confidence || 0.5,
799
- pageRank: e.pageRank || 0,
800
- accessCount: e.accessCount || 0,
801
- }));
802
- }
803
-
804
- // Keep history: append to array, cap at 50
805
- let history = readJSON(SNAPSHOT_PATH);
806
- if (!Array.isArray(history)) history = [];
807
- history.push(snap);
808
- if (history.length > 50) history = history.slice(-50);
809
- writeJSON(SNAPSHOT_PATH, history);
810
- }
811
-
812
- /**
813
- * stats() — Diagnostic report showing intelligence health and improvement.
814
- * Can be called as: node intelligence.cjs stats [--json]
815
- */
816
- function stats(outputJson) {
817
- const graph = readJSON(GRAPH_PATH);
818
- const ranked = readJSON(RANKED_PATH);
819
- const history = readJSON(SNAPSHOT_PATH) || [];
820
- const pending = fs.existsSync(PENDING_PATH)
821
- ? fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean).length
822
- : 0;
823
-
824
- // Current state
825
- const nodes = graph ? Object.keys(graph.nodes || {}).length : 0;
826
- const edges = graph ? (graph.edges || []).length : 0;
827
- const density = nodes > 1 ? (2 * edges) / (nodes * (nodes - 1)) : 0;
828
-
829
- // Confidence distribution
830
- const confidences = [];
831
- const accessCounts = [];
832
- if (graph && graph.nodes) {
833
- for (const n of Object.values(graph.nodes)) {
834
- confidences.push(n.confidence || 0.5);
835
- accessCounts.push(n.accessCount || 0);
836
- }
837
- }
838
- confidences.sort((a, b) => a - b);
839
- const confMin = confidences.length ? confidences[0] : 0;
840
- const confMax = confidences.length ? confidences[confidences.length - 1] : 0;
841
- const confMean = confidences.length ? confidences.reduce((s, c) => s + c, 0) / confidences.length : 0;
842
- const confMedian = confidences.length ? confidences[Math.floor(confidences.length / 2)] : 0;
843
-
844
- // Access stats
845
- const totalAccess = accessCounts.reduce((s, c) => s + c, 0);
846
- const accessedCount = accessCounts.filter(c => c > 0).length;
847
-
848
- // PageRank stats
849
- let prSum = 0, prMax = 0, prMaxId = '';
850
- if (graph && graph.pageRanks) {
851
- for (const [id, pr] of Object.entries(graph.pageRanks)) {
852
- prSum += pr;
853
- if (pr > prMax) { prMax = pr; prMaxId = id; }
854
- }
855
- }
856
-
857
- // Top patterns by composite score
858
- const topPatterns = (ranked && ranked.entries || []).slice(0, 10).map((e, i) => ({
859
- rank: i + 1,
860
- summary: (e.summary || '').slice(0, 60),
861
- confidence: (e.confidence || 0.5).toFixed(3),
862
- pageRank: (e.pageRank || 0).toFixed(4),
863
- accessed: e.accessCount || 0,
864
- score: (0.6 * (e.pageRank || 0) + 0.4 * (e.confidence || 0.5)).toFixed(4),
865
- }));
866
-
867
- // Edge type breakdown
868
- const edgeTypes = {};
869
- if (graph && graph.edges) {
870
- for (const e of graph.edges) {
871
- edgeTypes[e.type || 'unknown'] = (edgeTypes[e.type || 'unknown'] || 0) + 1;
872
- }
873
- }
874
-
875
- // Delta from previous snapshot
876
- let delta = null;
877
- if (history.length >= 2) {
878
- const prev = history[history.length - 2];
879
- const curr = history[history.length - 1];
880
- const elapsed = (curr.timestamp - prev.timestamp) / 1000;
881
- const prevConfMean = prev.confidences.length
882
- ? prev.confidences.reduce((s, c) => s + c, 0) / prev.confidences.length : 0;
883
- const currConfMean = curr.confidences.length
884
- ? curr.confidences.reduce((s, c) => s + c, 0) / curr.confidences.length : 0;
885
- const prevAccess = prev.accessCounts.reduce((s, c) => s + c, 0);
886
- const currAccess = curr.accessCounts.reduce((s, c) => s + c, 0);
887
-
888
- delta = {
889
- elapsed: elapsed < 3600 ? `${Math.round(elapsed / 60)}m` : `${(elapsed / 3600).toFixed(1)}h`,
890
- nodes: curr.nodes - prev.nodes,
891
- edges: curr.edges - prev.edges,
892
- confidenceMean: currConfMean - prevConfMean,
893
- totalAccess: currAccess - prevAccess,
894
- };
895
- }
896
-
897
- // Trend over all history
898
- let trend = null;
899
- if (history.length >= 3) {
900
- const first = history[0];
901
- const last = history[history.length - 1];
902
- const sessions = history.length;
903
- const firstConfMean = first.confidences.length
904
- ? first.confidences.reduce((s, c) => s + c, 0) / first.confidences.length : 0;
905
- const lastConfMean = last.confidences.length
906
- ? last.confidences.reduce((s, c) => s + c, 0) / last.confidences.length : 0;
907
- trend = {
908
- sessions,
909
- nodeGrowth: last.nodes - first.nodes,
910
- edgeGrowth: last.edges - first.edges,
911
- confidenceDrift: lastConfMean - firstConfMean,
912
- direction: lastConfMean > firstConfMean ? 'improving' :
913
- lastConfMean < firstConfMean ? 'declining' : 'stable',
914
- };
915
- }
916
-
917
- const report = {
918
- graph: { nodes, edges, density: +density.toFixed(4) },
919
- confidence: {
920
- min: +confMin.toFixed(3), max: +confMax.toFixed(3),
921
- mean: +confMean.toFixed(3), median: +confMedian.toFixed(3),
922
- },
923
- access: { total: totalAccess, patternsAccessed: accessedCount, patternsNeverAccessed: nodes - accessedCount },
924
- pageRank: { sum: +prSum.toFixed(4), topNode: prMaxId, topNodeRank: +prMax.toFixed(4) },
925
- edgeTypes,
926
- pendingInsights: pending,
927
- snapshots: history.length,
928
- topPatterns,
929
- delta,
930
- trend,
931
- };
932
-
933
- if (outputJson) {
934
- console.log(JSON.stringify(report, null, 2));
935
- return report;
936
- }
937
-
938
- // Human-readable output
939
- const bar = '+' + '-'.repeat(62) + '+';
940
- console.log(bar);
941
- console.log('|' + ' Intelligence Diagnostics (ADR-050)'.padEnd(62) + '|');
942
- console.log(bar);
943
- console.log('');
944
-
945
- console.log(' Graph');
946
- console.log(` Nodes: ${nodes}`);
947
- console.log(` Edges: ${edges} (${Object.entries(edgeTypes).map(([t,c]) => `${c} ${t}`).join(', ') || 'none'})`);
948
- console.log(` Density: ${(density * 100).toFixed(1)}%`);
949
- console.log('');
950
-
951
- console.log(' Confidence');
952
- console.log(` Min: ${confMin.toFixed(3)}`);
953
- console.log(` Max: ${confMax.toFixed(3)}`);
954
- console.log(` Mean: ${confMean.toFixed(3)}`);
955
- console.log(` Median: ${confMedian.toFixed(3)}`);
956
- console.log('');
957
-
958
- console.log(' Access');
959
- console.log(` Total accesses: ${totalAccess}`);
960
- console.log(` Patterns used: ${accessedCount}/${nodes}`);
961
- console.log(` Never accessed: ${nodes - accessedCount}`);
962
- console.log(` Pending insights: ${pending}`);
963
- console.log('');
964
-
965
- console.log(' PageRank');
966
- console.log(` Sum: ${prSum.toFixed(4)} (should be ~1.0)`);
967
- console.log(` Top node: ${prMaxId || '(none)'} (${prMax.toFixed(4)})`);
968
- console.log('');
969
-
970
- if (topPatterns.length > 0) {
971
- console.log(' Top Patterns (by composite score)');
972
- console.log(' ' + '-'.repeat(60));
973
- for (const p of topPatterns) {
974
- console.log(` #${p.rank} ${p.summary}`);
975
- console.log(` conf=${p.confidence} pr=${p.pageRank} score=${p.score} accessed=${p.accessed}x`);
976
- }
977
- console.log('');
978
- }
979
-
980
- if (delta) {
981
- console.log(` Last Delta (${delta.elapsed} ago)`);
982
- const sign = v => v > 0 ? `+${v}` : `${v}`;
983
- console.log(` Nodes: ${sign(delta.nodes)}`);
984
- console.log(` Edges: ${sign(delta.edges)}`);
985
- console.log(` Confidence: ${delta.confidenceMean >= 0 ? '+' : ''}${delta.confidenceMean.toFixed(4)}`);
986
- console.log(` Accesses: ${sign(delta.totalAccess)}`);
987
- console.log('');
988
- }
989
-
990
- if (trend) {
991
- console.log(` Trend (${trend.sessions} snapshots)`);
992
- console.log(` Node growth: ${trend.nodeGrowth >= 0 ? '+' : ''}${trend.nodeGrowth}`);
993
- console.log(` Edge growth: ${trend.edgeGrowth >= 0 ? '+' : ''}${trend.edgeGrowth}`);
994
- console.log(` Confidence drift: ${trend.confidenceDrift >= 0 ? '+' : ''}${trend.confidenceDrift.toFixed(4)}`);
995
- console.log(` Direction: ${trend.direction.toUpperCase()}`);
996
- console.log('');
997
- }
998
-
999
- if (!delta && !trend) {
1000
- console.log(' No history yet — run more sessions to see deltas and trends.');
1001
- console.log('');
1002
- }
1003
-
1004
- console.log(bar);
1005
- return report;
1006
- }
1007
-
1008
- module.exports = { init, getContext, recordEdit, feedback, consolidate, stats };
1009
-
1010
- // ── CLI entrypoint ──────────────────────────────────────────────────────────
1011
- if (require.main === module) {
1012
- const cmd = process.argv[2];
1013
- const jsonFlag = process.argv.includes('--json');
1014
-
1015
- const cmds = {
1016
- init: () => { const r = init(); console.log(JSON.stringify(r)); },
1017
- stats: () => { stats(jsonFlag); },
1018
- consolidate: () => { const r = consolidate(); console.log(JSON.stringify(r)); },
1019
- };
1020
-
1021
- if (cmd && cmds[cmd]) {
1022
- cmds[cmd]();
1023
- } else {
1024
- console.log('Usage: intelligence.cjs <stats|init|consolidate> [--json]');
1025
- console.log('');
1026
- console.log(' stats Show intelligence diagnostics and trends');
1027
- console.log(' stats --json Output as JSON for programmatic use');
1028
- console.log(' init Build graph and rank entries');
1029
- console.log(' consolidate Process pending insights and recompute');
1030
- }
1031
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Intelligence Layer (ADR-050)
4
+ *
5
+ * Closes the intelligence loop by wiring PageRank-ranked memory into
6
+ * the hook system. Pure CJS — no ESM imports of @claude-flow/memory.
7
+ *
8
+ * Data files (all under .claude-flow/data/):
9
+ * auto-memory-store.json — written by auto-memory-hook.mjs
10
+ * graph-state.json — serialized graph (nodes + edges + pageRanks)
11
+ * ranked-context.json — pre-computed ranked entries for fast lookup
12
+ * pending-insights.jsonl — append-only edit/task log
13
+ */
14
+
15
+ 'use strict';
16
+
17
+ const fs = require('fs');
18
+ const path = require('path');
19
+
20
+ const DATA_DIR = path.join(process.cwd(), '.claude-flow', 'data');
21
+ const STORE_PATH = path.join(DATA_DIR, 'auto-memory-store.json');
22
+ const GRAPH_PATH = path.join(DATA_DIR, 'graph-state.json');
23
+ const RANKED_PATH = path.join(DATA_DIR, 'ranked-context.json');
24
+ const PENDING_PATH = path.join(DATA_DIR, 'pending-insights.jsonl');
25
+ const SESSION_DIR = path.join(process.cwd(), '.claude-flow', 'sessions');
26
+ const SESSION_FILE = path.join(SESSION_DIR, 'current.json');
27
+
28
+ // ── Safety limits (fixes #1530, #1531) ─────────────────────────────────────
29
+ const MAX_DATA_FILE_SIZE = 10 * 1024 * 1024; // 10 MB — skip files larger than this
30
+ const MAX_GRAPH_NODES = 5000; // skip PageRank if graph exceeds this
31
+
32
+ // ── Stop words for trigram matching ──────────────────────────────────────────
33
+
34
+ const STOP_WORDS = new Set([
35
+ 'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
36
+ 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
37
+ 'should', 'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'for',
38
+ 'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
39
+ 'before', 'after', 'and', 'but', 'or', 'nor', 'not', 'so', 'yet',
40
+ 'both', 'either', 'neither', 'each', 'every', 'all', 'any', 'few',
41
+ 'more', 'most', 'other', 'some', 'such', 'no', 'only', 'own', 'same',
42
+ 'than', 'too', 'very', 'just', 'because', 'if', 'when', 'which',
43
+ 'who', 'whom', 'this', 'that', 'these', 'those', 'it', 'its',
44
+ ]);
45
+
46
+ // ── Helpers ──────────────────────────────────────────────────────────────────
47
+
48
+ function ensureDataDir() {
49
+ if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
50
+ }
51
+
52
+ function readJSON(filePath) {
53
+ // Safety: skip files exceeding MAX_DATA_FILE_SIZE (#1531)
54
+ try {
55
+ const stat = fs.statSync(filePath);
56
+ if (stat.size > MAX_DATA_FILE_SIZE) {
57
+ process.stderr.write("[INTELLIGENCE] WARN: Skipping " + path.basename(filePath) + " (" + Math.round(stat.size / 1048576) + "MB exceeds 10MB limit)\n");
58
+ return null;
59
+ }
60
+ } catch { /* file may not exist yet */ }
61
+ try {
62
+ if (fs.existsSync(filePath)) return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
63
+ } catch { /* corrupt file — start fresh */ }
64
+ return null;
65
+ }
66
+
67
+ function writeJSON(filePath, data) {
68
+ ensureDataDir();
69
+ fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
70
+ }
71
+
72
+ function tokenize(text) {
73
+ if (!text) return [];
74
+ return text.toLowerCase()
75
+ .replace(/[^a-z0-9\s-]/g, ' ')
76
+ .split(/\s+/)
77
+ .filter(w => w.length > 2 && !STOP_WORDS.has(w));
78
+ }
79
+
80
+ function trigrams(words) {
81
+ const t = new Set();
82
+ for (const w of words) {
83
+ for (let i = 0; i <= w.length - 3; i++) t.add(w.slice(i, i + 3));
84
+ }
85
+ return t;
86
+ }
87
+
88
+ function jaccardSimilarity(setA, setB) {
89
+ if (setA.size === 0 && setB.size === 0) return 0;
90
+ let intersection = 0;
91
+ for (const item of setA) { if (setB.has(item)) intersection++; }
92
+ return intersection / (setA.size + setB.size - intersection);
93
+ }
94
+
95
+ // ── Deduplication helper (fixes #1518) ──────────────────────────────────────
96
+
97
+ function deduplicateById(entries) {
98
+ if (!entries || !Array.isArray(entries)) return entries;
99
+ const seen = new Map();
100
+ for (const entry of entries) {
101
+ const id = entry.id || entry.key;
102
+ if (id) {
103
+ seen.set(id, entry);
104
+ } else {
105
+ seen.set(`__no_id_${seen.size}`, entry);
106
+ }
107
+ }
108
+ return Array.from(seen.values());
109
+ }
110
+
111
+ // ADR-095 G6 — content-hash dedup. The April audit measured 5,706 entries
112
+ // in the auto-memory store with only ~20 unique by content; 5,686 dupes
113
+ // were the same MEMORY.md sections imported from sibling project dirs
114
+ // with different IDs. deduplicateById can't catch these (the IDs really
115
+ // are different); we need a content fingerprint.
116
+ //
117
+ // Fast non-cryptographic fingerprint — collisions on 64-bit FNV-1a are
118
+ // vanishingly rare for human prose at the scale of an auto-memory store.
119
+ // Whitespace-normalized so trivially-different formatting doesn't bypass dedup.
120
+ function fingerprintContent(text) {
121
+ if (typeof text !== 'string' || text.length === 0) return '0';
122
+ const norm = text.replace(/\s+/g, ' ').trim().toLowerCase();
123
+ // FNV-1a 64-bit (split into 32-bit halves to stay within Number safe int)
124
+ let h1 = 0x811c9dc5, h2 = 0xcbf29ce4;
125
+ for (let i = 0; i < norm.length; i++) {
126
+ const c = norm.charCodeAt(i);
127
+ h1 ^= c; h1 = Math.imul(h1, 0x01000193) >>> 0;
128
+ h2 ^= c; h2 = Math.imul(h2, 0x100000001b3 & 0xffffffff) >>> 0;
129
+ }
130
+ return `${h1.toString(16)}_${h2.toString(16)}_${norm.length}`;
131
+ }
132
+
133
+ function deduplicateByContent(entries) {
134
+ if (!entries || !Array.isArray(entries)) return entries;
135
+ const seen = new Map();
136
+ for (const entry of entries) {
137
+ const content = entry.content || entry.summary || entry.value || '';
138
+ const fp = fingerprintContent(typeof content === 'string' ? content : JSON.stringify(content));
139
+ if (!seen.has(fp)) {
140
+ seen.set(fp, entry);
141
+ } else {
142
+ // Keep the entry with the higher accessCount or earlier createdAt
143
+ const existing = seen.get(fp);
144
+ const existingAccess = existing.accessCount || 0;
145
+ const candidateAccess = entry.accessCount || 0;
146
+ if (candidateAccess > existingAccess) seen.set(fp, entry);
147
+ }
148
+ }
149
+ return Array.from(seen.values());
150
+ }
151
+
152
+ // ── Session state helpers ────────────────────────────────────────────────────
153
+
154
+ function sessionGet(key) {
155
+ try {
156
+ if (!fs.existsSync(SESSION_FILE)) return null;
157
+ const session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
158
+ return key ? (session.context || {})[key] : session.context;
159
+ } catch { return null; }
160
+ }
161
+
162
+ function sessionSet(key, value) {
163
+ try {
164
+ if (!fs.existsSync(SESSION_DIR)) fs.mkdirSync(SESSION_DIR, { recursive: true });
165
+ let session = {};
166
+ if (fs.existsSync(SESSION_FILE)) {
167
+ session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
168
+ }
169
+ if (!session.context) session.context = {};
170
+ session.context[key] = value;
171
+ session.updatedAt = new Date().toISOString();
172
+ fs.writeFileSync(SESSION_FILE, JSON.stringify(session, null, 2), 'utf-8');
173
+ } catch { /* best effort */ }
174
+ }
175
+
176
+ // ── PageRank ─────────────────────────────────────────────────────────────────
177
+
178
+ function computePageRank(nodes, edges, damping, maxIter) {
179
+ damping = damping || 0.85;
180
+ maxIter = maxIter || 30;
181
+
182
+ const ids = Object.keys(nodes);
183
+ const n = ids.length;
184
+ if (n === 0) return {};
185
+
186
+ // Build adjacency: outgoing edges per node
187
+ const outLinks = {};
188
+ const inLinks = {};
189
+ for (const id of ids) { outLinks[id] = []; inLinks[id] = []; }
190
+ for (const edge of edges) {
191
+ if (outLinks[edge.sourceId]) outLinks[edge.sourceId].push(edge.targetId);
192
+ if (inLinks[edge.targetId]) inLinks[edge.targetId].push(edge.sourceId);
193
+ }
194
+
195
+ // Initialize ranks
196
+ const ranks = {};
197
+ for (const id of ids) ranks[id] = 1 / n;
198
+
199
+ // Power iteration (with dangling node redistribution)
200
+ for (let iter = 0; iter < maxIter; iter++) {
201
+ const newRanks = {};
202
+ let diff = 0;
203
+
204
+ // Collect rank from dangling nodes (no outgoing edges)
205
+ let danglingSum = 0;
206
+ for (const id of ids) {
207
+ if (outLinks[id].length === 0) danglingSum += ranks[id];
208
+ }
209
+
210
+ for (const id of ids) {
211
+ let sum = 0;
212
+ for (const src of inLinks[id]) {
213
+ const outCount = outLinks[src].length;
214
+ if (outCount > 0) sum += ranks[src] / outCount;
215
+ }
216
+ // Dangling rank distributed evenly + teleport
217
+ newRanks[id] = (1 - damping) / n + damping * (sum + danglingSum / n);
218
+ diff += Math.abs(newRanks[id] - ranks[id]);
219
+ }
220
+
221
+ for (const id of ids) ranks[id] = newRanks[id];
222
+ if (diff < 1e-6) break; // converged
223
+ }
224
+
225
+ return ranks;
226
+ }
227
+
228
+ // ── Edge building ────────────────────────────────────────────────────────────
229
+
230
+ function buildEdges(entries) {
231
+ const edges = [];
232
+ const byCategory = {};
233
+
234
+ for (const entry of entries) {
235
+ const cat = entry.category || entry.namespace || 'default';
236
+ if (!byCategory[cat]) byCategory[cat] = [];
237
+ byCategory[cat].push(entry);
238
+ }
239
+
240
+ // Temporal edges: entries from same sourceFile
241
+ const byFile = {};
242
+ for (const entry of entries) {
243
+ const file = (entry.metadata && entry.metadata.sourceFile) || null;
244
+ if (file) {
245
+ if (!byFile[file]) byFile[file] = [];
246
+ byFile[file].push(entry);
247
+ }
248
+ }
249
+ for (const file of Object.keys(byFile)) {
250
+ const group = byFile[file];
251
+ for (let i = 0; i < group.length - 1; i++) {
252
+ edges.push({
253
+ sourceId: group[i].id,
254
+ targetId: group[i + 1].id,
255
+ type: 'temporal',
256
+ weight: 0.5,
257
+ });
258
+ }
259
+ }
260
+
261
+ // Similarity edges within categories (Jaccard > 0.3).
262
+ // ADR-095 G6 perf: hoist the trigram computation outside the inner
263
+ // loop. Previously we re-tokenized + re-trigrammed group[j] for every
264
+ // i — O(n²) extra work for nothing. Now compute once per entry.
265
+ for (const cat of Object.keys(byCategory)) {
266
+ const group = byCategory[cat];
267
+ if (group.length < 2) continue;
268
+
269
+ // Cache trigram sets for every entry in the group.
270
+ const triCache = new Array(group.length);
271
+ for (let i = 0; i < group.length; i++) {
272
+ triCache[i] = trigrams(tokenize(group[i].content || group[i].summary || ''));
273
+ }
274
+
275
+ for (let i = 0; i < group.length; i++) {
276
+ const triA = triCache[i];
277
+ for (let j = i + 1; j < group.length; j++) {
278
+ const sim = jaccardSimilarity(triA, triCache[j]);
279
+ if (sim > 0.3) {
280
+ edges.push({
281
+ sourceId: group[i].id,
282
+ targetId: group[j].id,
283
+ type: 'similar',
284
+ weight: sim,
285
+ });
286
+ }
287
+ }
288
+ }
289
+ }
290
+
291
+ return edges;
292
+ }
293
+
294
+ // ── Bootstrap from MEMORY.md files ───────────────────────────────────────────
295
+
296
+ /**
297
+ * If auto-memory-store.json is empty, bootstrap by parsing MEMORY.md and
298
+ * topic files from the auto-memory directory. This removes the dependency
299
+ * on @claude-flow/memory for the initial seed.
300
+ */
301
+ function bootstrapFromMemoryFiles() {
302
+ const entries = [];
303
+ const cwd = process.cwd();
304
+
305
+ // Search for auto-memory directories
306
+ const candidates = [
307
+ // Claude Code auto-memory (project-scoped)
308
+ path.join(require('os').homedir(), '.claude', 'projects'),
309
+ // Local project memory
310
+ path.join(cwd, '.claude-flow', 'memory'),
311
+ path.join(cwd, '.claude', 'memory'),
312
+ ];
313
+
314
+ // Find MEMORY.md in project-scoped dirs
315
+ for (const base of candidates) {
316
+ if (!fs.existsSync(base)) continue;
317
+
318
+ // For the projects dir, scope to CURRENT project only (not all 51+ dirs)
319
+ if (base.endsWith('projects')) {
320
+ try {
321
+ const projectSlug = cwd.replace(/^\//, '').replace(/\//g, '-');
322
+ const memDir = path.join(base, projectSlug, 'memory');
323
+ if (fs.existsSync(memDir)) {
324
+ parseMemoryDir(memDir, entries);
325
+ }
326
+ } catch { /* skip */ }
327
+ } else if (fs.existsSync(base)) {
328
+ parseMemoryDir(base, entries);
329
+ }
330
+ }
331
+
332
+ return entries;
333
+ }
334
+
335
+ function parseMemoryDir(dir, entries) {
336
+ try {
337
+ const files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
338
+ for (const file of files) {
339
+ const filePath = path.join(dir, file);
340
+ const content = fs.readFileSync(filePath, 'utf-8');
341
+ if (!content.trim()) continue;
342
+
343
+ // Parse markdown sections as separate entries
344
+ const sections = content.split(/^##?\s+/m).filter(Boolean);
345
+ for (let sIdx = 0; sIdx < sections.length; sIdx++) {
346
+ const section = sections[sIdx];
347
+ const lines = section.trim().split('\n');
348
+ const title = lines[0].trim();
349
+ const body = lines.slice(1).join('\n').trim();
350
+ if (!body || body.length < 10) continue;
351
+
352
+ const id = `mem-${file.replace('.md', '')}-${title.replace(/[^a-z0-9]/gi, '-').toLowerCase().slice(0, 30)}-${sIdx}`;
353
+ entries.push({
354
+ id,
355
+ key: title.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50),
356
+ content: body.slice(0, 500),
357
+ summary: title,
358
+ namespace: file === 'MEMORY.md' ? 'core' : file.replace('.md', ''),
359
+ type: 'semantic',
360
+ metadata: { sourceFile: filePath, bootstrapped: true },
361
+ createdAt: Date.now(),
362
+ });
363
+ }
364
+ }
365
+ } catch { /* skip unreadable dirs */ }
366
+ }
367
+
368
+ // ── Exported functions ───────────────────────────────────────────────────────
369
+
370
+ /**
371
+ * init() — Called from session-restore. Budget: <200ms.
372
+ * Reads auto-memory-store.json, builds graph, computes PageRank, writes caches.
373
+ * If store is empty, bootstraps from MEMORY.md files directly.
374
+ */
375
+ function init() {
376
+ ensureDataDir();
377
+
378
+ // Check if graph-state.json is fresh (within 60s of store)
379
+ const graphState = readJSON(GRAPH_PATH);
380
+ let store = readJSON(STORE_PATH);
381
+
382
+ // Bootstrap from MEMORY.md files if store is empty
383
+ if (!store || !Array.isArray(store) || store.length === 0) {
384
+ const bootstrapped = bootstrapFromMemoryFiles();
385
+ if (bootstrapped.length > 0) {
386
+ store = bootstrapped;
387
+ writeJSON(STORE_PATH, store);
388
+ } else {
389
+ return { nodes: 0, edges: 0, message: 'No memory entries to index' };
390
+ }
391
+ }
392
+
393
+ // Deduplicate store entries by ID (fixes #1518 — 194MB → ~79KB)
394
+ let deduped = deduplicateById(store);
395
+ // ADR-095 G6: also dedupe by content fingerprint. The April audit
396
+ // measured 5,706 entries with only ~20 unique by content because the
397
+ // same MEMORY.md sections get imported from sibling project dirs with
398
+ // different IDs. deduplicateById can't catch that; deduplicateByContent
399
+ // can. Cuts the graph from O(n²) over near-identical duplicates down
400
+ // to O(unique²), which is the difference between a 100MB graph-state
401
+ // and a kilobytes-scale one for typical workloads.
402
+ const beforeContentDedup = deduped.length;
403
+ deduped = deduplicateByContent(deduped);
404
+ if (deduped.length < store.length) {
405
+ process.stderr.write(
406
+ `[INTELLIGENCE] Deduped store: ${store.length} -> ${deduped.length} entries ` +
407
+ `(by-id: ${store.length - beforeContentDedup} dropped, by-content: ${beforeContentDedup - deduped.length} dropped)\n`
408
+ );
409
+ writeJSON(STORE_PATH, deduped);
410
+ }
411
+
412
+ // Skip rebuild if graph is fresh and store hasn't changed
413
+ if (graphState && graphState.nodeCount === deduped.length) {
414
+ const age = Date.now() - (graphState.updatedAt || 0);
415
+ if (age < 60000) {
416
+ return {
417
+ nodes: graphState.nodeCount || Object.keys(graphState.nodes || {}).length,
418
+ edges: (graphState.edges || []).length,
419
+ message: 'Graph cache hit',
420
+ };
421
+ }
422
+ }
423
+
424
+ // Build nodes from deduped entries
425
+ const nodes = {};
426
+ for (const entry of deduped) {
427
+ const id = entry.id || entry.key || `entry-${Math.random().toString(36).slice(2, 8)}`;
428
+ nodes[id] = {
429
+ id,
430
+ category: entry.namespace || entry.type || 'default',
431
+ confidence: (entry.metadata && entry.metadata.confidence) || 0.5,
432
+ accessCount: (entry.metadata && entry.metadata.accessCount) || 0,
433
+ createdAt: entry.createdAt || Date.now(),
434
+ };
435
+ // Ensure entry has id for edge building
436
+ entry.id = id;
437
+ }
438
+
439
+ // Build edges
440
+ const edges = buildEdges(deduped);
441
+
442
+ // Compute PageRank (skip if graph too large — #1531)
443
+ const nodeCount = Object.keys(nodes).length;
444
+ let pageRanks = {};
445
+ if (nodeCount > MAX_GRAPH_NODES) {
446
+ process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank\n");
447
+ for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
448
+ } else {
449
+ pageRanks = computePageRank(nodes, edges, 0.85, 30);
450
+ }
451
+
452
+ // Write graph state
453
+ const graph = {
454
+ version: 1,
455
+ updatedAt: Date.now(),
456
+ nodeCount: Object.keys(nodes).length,
457
+ nodes,
458
+ edges,
459
+ pageRanks,
460
+ };
461
+ writeJSON(GRAPH_PATH, graph);
462
+
463
+ // Build ranked context for fast lookup
464
+ const rankedEntries = deduped.map(entry => {
465
+ const id = entry.id;
466
+ const content = entry.content || entry.value || '';
467
+ const summary = entry.summary || entry.key || '';
468
+ const words = tokenize(content + ' ' + summary);
469
+ return {
470
+ id,
471
+ content,
472
+ summary,
473
+ category: entry.namespace || entry.type || 'default',
474
+ confidence: nodes[id] ? nodes[id].confidence : 0.5,
475
+ pageRank: pageRanks[id] || 0,
476
+ accessCount: nodes[id] ? nodes[id].accessCount : 0,
477
+ words,
478
+ };
479
+ }).sort((a, b) => {
480
+ const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
481
+ const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
482
+ return scoreB - scoreA;
483
+ });
484
+
485
+ const ranked = {
486
+ version: 1,
487
+ computedAt: Date.now(),
488
+ entries: rankedEntries,
489
+ };
490
+ writeJSON(RANKED_PATH, ranked);
491
+
492
+ return {
493
+ nodes: Object.keys(nodes).length,
494
+ edges: edges.length,
495
+ message: 'Graph built and ranked',
496
+ };
497
+ }
498
+
499
+ /**
500
+ * getContext(prompt) — Called from route. Budget: <15ms.
501
+ * Matches prompt to ranked entries, returns top-5 formatted context.
502
+ */
503
+ function getContext(prompt) {
504
+ if (!prompt) return null;
505
+
506
+ const ranked = readJSON(RANKED_PATH);
507
+ if (!ranked || !ranked.entries || ranked.entries.length === 0) return null;
508
+
509
+ const promptWords = tokenize(prompt);
510
+ if (promptWords.length === 0) return null;
511
+ const promptTrigrams = trigrams(promptWords);
512
+
513
+ const ALPHA = 0.6; // content match weight
514
+ const MIN_THRESHOLD = 0.05;
515
+ const TOP_K = 5;
516
+
517
+ // Score each entry
518
+ const scored = [];
519
+ for (const entry of ranked.entries) {
520
+ const entryTrigrams = trigrams(entry.words || []);
521
+ const contentMatch = jaccardSimilarity(promptTrigrams, entryTrigrams);
522
+ const score = ALPHA * contentMatch + (1 - ALPHA) * (entry.pageRank || 0);
523
+ if (score >= MIN_THRESHOLD) {
524
+ scored.push({ ...entry, score });
525
+ }
526
+ }
527
+
528
+ if (scored.length === 0) return null;
529
+
530
+ // Sort by score descending, take top-K
531
+ scored.sort((a, b) => b.score - a.score);
532
+ const topEntries = scored.slice(0, TOP_K);
533
+
534
+ // Boost previously matched patterns (implicit success: user continued working)
535
+ const prevMatched = sessionGet('lastMatchedPatterns');
536
+
537
+ // Store NEW matched IDs in session state for feedback
538
+ const matchedIds = topEntries.map(e => e.id);
539
+ sessionSet('lastMatchedPatterns', matchedIds);
540
+
541
+ // Only boost previous if they differ from current (avoid double-boosting)
542
+ if (prevMatched && Array.isArray(prevMatched)) {
543
+ const newSet = new Set(matchedIds);
544
+ const toBoost = prevMatched.filter(id => !newSet.has(id));
545
+ if (toBoost.length > 0) boostConfidence(toBoost, 0.03);
546
+ }
547
+
548
+ // Format output
549
+ const lines = ['[INTELLIGENCE] Relevant patterns for this task:'];
550
+ for (let i = 0; i < topEntries.length; i++) {
551
+ const e = topEntries[i];
552
+ const display = (e.summary || e.content || '').slice(0, 80);
553
+ const accessed = e.accessCount || 0;
554
+ lines.push(` * (${e.score.toFixed(2)}) ${display} [rank #${i + 1}, ${accessed}x accessed]`);
555
+ }
556
+
557
+ return lines.join('\n');
558
+ }
559
+
560
+ /**
561
+ * recordEdit(file) — Called from post-edit. Budget: <2ms.
562
+ * Appends to pending-insights.jsonl.
563
+ */
564
+ function recordEdit(file) {
565
+ ensureDataDir();
566
+ const entry = JSON.stringify({
567
+ type: 'edit',
568
+ file: file || 'unknown',
569
+ timestamp: Date.now(),
570
+ sessionId: sessionGet('sessionId') || null,
571
+ });
572
+ fs.appendFileSync(PENDING_PATH, entry + '\n', 'utf-8');
573
+ }
574
+
575
+ /**
576
+ * feedback(success) — Called from post-task. Budget: <10ms.
577
+ * Boosts or decays confidence for last-matched patterns.
578
+ */
579
+ function feedback(success) {
580
+ const matchedIds = sessionGet('lastMatchedPatterns');
581
+ if (!matchedIds || !Array.isArray(matchedIds)) return;
582
+
583
+ const amount = success ? 0.05 : -0.02;
584
+ boostConfidence(matchedIds, amount);
585
+ }
586
+
587
+ function boostConfidence(ids, amount) {
588
+ const ranked = readJSON(RANKED_PATH);
589
+ if (!ranked || !ranked.entries) return;
590
+
591
+ let changed = false;
592
+ for (const entry of ranked.entries) {
593
+ if (ids.includes(entry.id)) {
594
+ entry.confidence = Math.max(0, Math.min(1, (entry.confidence || 0.5) + amount));
595
+ entry.accessCount = (entry.accessCount || 0) + 1;
596
+ changed = true;
597
+ }
598
+ }
599
+
600
+ if (changed) writeJSON(RANKED_PATH, ranked);
601
+
602
+ // Also update graph-state confidence
603
+ const graph = readJSON(GRAPH_PATH);
604
+ if (graph && graph.nodes) {
605
+ for (const id of ids) {
606
+ if (graph.nodes[id]) {
607
+ graph.nodes[id].confidence = Math.max(0, Math.min(1, (graph.nodes[id].confidence || 0.5) + amount));
608
+ graph.nodes[id].accessCount = (graph.nodes[id].accessCount || 0) + 1;
609
+ }
610
+ }
611
+ writeJSON(GRAPH_PATH, graph);
612
+ }
613
+ }
614
+
615
+ /**
616
+ * consolidate() — Called from session-end. Budget: <500ms.
617
+ * Processes pending insights, rebuilds edges, recomputes PageRank.
618
+ */
619
+ function consolidate() {
620
+ ensureDataDir();
621
+
622
+ let store = readJSON(STORE_PATH);
623
+ if (!store || !Array.isArray(store)) {
624
+ return { entries: 0, edges: 0, newEntries: 0, message: 'No store to consolidate' };
625
+ }
626
+
627
+ // Deduplicate store entries by ID before processing (fixes #1518)
628
+ const preDedupCount = store.length;
629
+ store = deduplicateById(store);
630
+
631
+ // 1. Process pending insights
632
+ let newEntries = 0;
633
+ if (fs.existsSync(PENDING_PATH)) {
634
+ const lines = fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean);
635
+ const editCounts = {};
636
+ for (const line of lines) {
637
+ try {
638
+ const insight = JSON.parse(line);
639
+ if (insight.file) {
640
+ editCounts[insight.file] = (editCounts[insight.file] || 0) + 1;
641
+ }
642
+ } catch { /* skip malformed */ }
643
+ }
644
+
645
+ // Create entries for frequently-edited files (3+ edits)
646
+ for (const [file, count] of Object.entries(editCounts)) {
647
+ if (count >= 3) {
648
+ const exists = store.some(e =>
649
+ (e.metadata && e.metadata.sourceFile === file && e.metadata.autoGenerated)
650
+ );
651
+ if (!exists) {
652
+ store.push({
653
+ id: `insight-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
654
+ key: `frequent-edit-${path.basename(file)}`,
655
+ content: `File ${file} was edited ${count} times this session — likely a hot path worth monitoring.`,
656
+ summary: `Frequently edited: ${path.basename(file)} (${count}x)`,
657
+ namespace: 'insights',
658
+ type: 'procedural',
659
+ metadata: { sourceFile: file, editCount: count, autoGenerated: true },
660
+ createdAt: Date.now(),
661
+ });
662
+ newEntries++;
663
+ }
664
+ }
665
+ }
666
+
667
+ // Clear pending
668
+ fs.writeFileSync(PENDING_PATH, '', 'utf-8');
669
+ }
670
+
671
+ // 2. Confidence decay for unaccessed entries
672
+ const graph = readJSON(GRAPH_PATH);
673
+ if (graph && graph.nodes) {
674
+ const now = Date.now();
675
+ for (const id of Object.keys(graph.nodes)) {
676
+ const node = graph.nodes[id];
677
+ const hoursSinceCreation = (now - (node.createdAt || now)) / (1000 * 60 * 60);
678
+ if (node.accessCount === 0 && hoursSinceCreation > 24) {
679
+ node.confidence = Math.max(0.05, (node.confidence || 0.5) - 0.005 * Math.floor(hoursSinceCreation / 24));
680
+ }
681
+ }
682
+ }
683
+
684
+ // 3. Rebuild edges with updated store
685
+ for (const entry of store) {
686
+ if (!entry.id) entry.id = `entry-${Math.random().toString(36).slice(2, 8)}`;
687
+ }
688
+ const edges = buildEdges(store);
689
+
690
+ // 4. Build updated nodes
691
+ const nodes = {};
692
+ for (const entry of store) {
693
+ nodes[entry.id] = {
694
+ id: entry.id,
695
+ category: entry.namespace || entry.type || 'default',
696
+ confidence: (graph && graph.nodes && graph.nodes[entry.id])
697
+ ? graph.nodes[entry.id].confidence
698
+ : (entry.metadata && entry.metadata.confidence) || 0.5,
699
+ accessCount: (graph && graph.nodes && graph.nodes[entry.id])
700
+ ? graph.nodes[entry.id].accessCount
701
+ : (entry.metadata && entry.metadata.accessCount) || 0,
702
+ createdAt: entry.createdAt || Date.now(),
703
+ };
704
+ }
705
+
706
+ // 5. Recompute PageRank (skip if graph too large — #1531)
707
+ const nodeCount = Object.keys(nodes).length;
708
+ let pageRanks = {};
709
+ if (nodeCount > MAX_GRAPH_NODES) {
710
+ process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank in consolidate\n");
711
+ for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
712
+ } else {
713
+ pageRanks = computePageRank(nodes, edges, 0.85, 30);
714
+ }
715
+
716
+ // 6. Write updated graph
717
+ writeJSON(GRAPH_PATH, {
718
+ version: 1,
719
+ updatedAt: Date.now(),
720
+ nodeCount: Object.keys(nodes).length,
721
+ nodes,
722
+ edges,
723
+ pageRanks,
724
+ });
725
+
726
+ // 7. Write updated ranked context
727
+ const rankedEntries = store.map(entry => {
728
+ const id = entry.id;
729
+ const content = entry.content || entry.value || '';
730
+ const summary = entry.summary || entry.key || '';
731
+ const words = tokenize(content + ' ' + summary);
732
+ return {
733
+ id,
734
+ content,
735
+ summary,
736
+ category: entry.namespace || entry.type || 'default',
737
+ confidence: nodes[id] ? nodes[id].confidence : 0.5,
738
+ pageRank: pageRanks[id] || 0,
739
+ accessCount: nodes[id] ? nodes[id].accessCount : 0,
740
+ words,
741
+ };
742
+ }).sort((a, b) => {
743
+ const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
744
+ const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
745
+ return scoreB - scoreA;
746
+ });
747
+
748
+ writeJSON(RANKED_PATH, {
749
+ version: 1,
750
+ computedAt: Date.now(),
751
+ entries: rankedEntries,
752
+ });
753
+
754
+ // 8. Persist updated store (deduped or with new insight entries)
755
+ if (newEntries > 0 || store.length < preDedupCount) writeJSON(STORE_PATH, store);
756
+
757
+ // 9. Save snapshot for delta tracking
758
+ const updatedGraph = readJSON(GRAPH_PATH);
759
+ const updatedRanked = readJSON(RANKED_PATH);
760
+ saveSnapshot(updatedGraph, updatedRanked);
761
+
762
+ return {
763
+ entries: store.length,
764
+ edges: edges.length,
765
+ newEntries,
766
+ message: 'Consolidated',
767
+ };
768
+ }
769
+
770
+ // ── Snapshot for delta tracking ─────────────────────────────────────────────
771
+
772
+ const SNAPSHOT_PATH = path.join(DATA_DIR, 'intelligence-snapshot.json');
773
+
774
+ function saveSnapshot(graph, ranked) {
775
+ const snap = {
776
+ timestamp: Date.now(),
777
+ nodes: graph ? Object.keys(graph.nodes || {}).length : 0,
778
+ edges: graph ? (graph.edges || []).length : 0,
779
+ pageRankSum: 0,
780
+ confidences: [],
781
+ accessCounts: [],
782
+ topPatterns: [],
783
+ };
784
+
785
+ if (graph && graph.pageRanks) {
786
+ for (const v of Object.values(graph.pageRanks)) snap.pageRankSum += v;
787
+ }
788
+ if (graph && graph.nodes) {
789
+ for (const n of Object.values(graph.nodes)) {
790
+ snap.confidences.push(n.confidence || 0.5);
791
+ snap.accessCounts.push(n.accessCount || 0);
792
+ }
793
+ }
794
+ if (ranked && ranked.entries) {
795
+ snap.topPatterns = ranked.entries.slice(0, 10).map(e => ({
796
+ id: e.id,
797
+ summary: (e.summary || '').slice(0, 60),
798
+ confidence: e.confidence || 0.5,
799
+ pageRank: e.pageRank || 0,
800
+ accessCount: e.accessCount || 0,
801
+ }));
802
+ }
803
+
804
+ // Keep history: append to array, cap at 50
805
+ let history = readJSON(SNAPSHOT_PATH);
806
+ if (!Array.isArray(history)) history = [];
807
+ history.push(snap);
808
+ if (history.length > 50) history = history.slice(-50);
809
+ writeJSON(SNAPSHOT_PATH, history);
810
+ }
811
+
812
+ /**
813
+ * stats() — Diagnostic report showing intelligence health and improvement.
814
+ * Can be called as: node intelligence.cjs stats [--json]
815
+ */
816
+ function stats(outputJson) {
817
+ const graph = readJSON(GRAPH_PATH);
818
+ const ranked = readJSON(RANKED_PATH);
819
+ const history = readJSON(SNAPSHOT_PATH) || [];
820
+ const pending = fs.existsSync(PENDING_PATH)
821
+ ? fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean).length
822
+ : 0;
823
+
824
+ // Current state
825
+ const nodes = graph ? Object.keys(graph.nodes || {}).length : 0;
826
+ const edges = graph ? (graph.edges || []).length : 0;
827
+ const density = nodes > 1 ? (2 * edges) / (nodes * (nodes - 1)) : 0;
828
+
829
+ // Confidence distribution
830
+ const confidences = [];
831
+ const accessCounts = [];
832
+ if (graph && graph.nodes) {
833
+ for (const n of Object.values(graph.nodes)) {
834
+ confidences.push(n.confidence || 0.5);
835
+ accessCounts.push(n.accessCount || 0);
836
+ }
837
+ }
838
+ confidences.sort((a, b) => a - b);
839
+ const confMin = confidences.length ? confidences[0] : 0;
840
+ const confMax = confidences.length ? confidences[confidences.length - 1] : 0;
841
+ const confMean = confidences.length ? confidences.reduce((s, c) => s + c, 0) / confidences.length : 0;
842
+ const confMedian = confidences.length ? confidences[Math.floor(confidences.length / 2)] : 0;
843
+
844
+ // Access stats
845
+ const totalAccess = accessCounts.reduce((s, c) => s + c, 0);
846
+ const accessedCount = accessCounts.filter(c => c > 0).length;
847
+
848
+ // PageRank stats
849
+ let prSum = 0, prMax = 0, prMaxId = '';
850
+ if (graph && graph.pageRanks) {
851
+ for (const [id, pr] of Object.entries(graph.pageRanks)) {
852
+ prSum += pr;
853
+ if (pr > prMax) { prMax = pr; prMaxId = id; }
854
+ }
855
+ }
856
+
857
+ // Top patterns by composite score
858
+ const topPatterns = (ranked && ranked.entries || []).slice(0, 10).map((e, i) => ({
859
+ rank: i + 1,
860
+ summary: (e.summary || '').slice(0, 60),
861
+ confidence: (e.confidence || 0.5).toFixed(3),
862
+ pageRank: (e.pageRank || 0).toFixed(4),
863
+ accessed: e.accessCount || 0,
864
+ score: (0.6 * (e.pageRank || 0) + 0.4 * (e.confidence || 0.5)).toFixed(4),
865
+ }));
866
+
867
+ // Edge type breakdown
868
+ const edgeTypes = {};
869
+ if (graph && graph.edges) {
870
+ for (const e of graph.edges) {
871
+ edgeTypes[e.type || 'unknown'] = (edgeTypes[e.type || 'unknown'] || 0) + 1;
872
+ }
873
+ }
874
+
875
+ // Delta from previous snapshot
876
+ let delta = null;
877
+ if (history.length >= 2) {
878
+ const prev = history[history.length - 2];
879
+ const curr = history[history.length - 1];
880
+ const elapsed = (curr.timestamp - prev.timestamp) / 1000;
881
+ const prevConfMean = prev.confidences.length
882
+ ? prev.confidences.reduce((s, c) => s + c, 0) / prev.confidences.length : 0;
883
+ const currConfMean = curr.confidences.length
884
+ ? curr.confidences.reduce((s, c) => s + c, 0) / curr.confidences.length : 0;
885
+ const prevAccess = prev.accessCounts.reduce((s, c) => s + c, 0);
886
+ const currAccess = curr.accessCounts.reduce((s, c) => s + c, 0);
887
+
888
+ delta = {
889
+ elapsed: elapsed < 3600 ? `${Math.round(elapsed / 60)}m` : `${(elapsed / 3600).toFixed(1)}h`,
890
+ nodes: curr.nodes - prev.nodes,
891
+ edges: curr.edges - prev.edges,
892
+ confidenceMean: currConfMean - prevConfMean,
893
+ totalAccess: currAccess - prevAccess,
894
+ };
895
+ }
896
+
897
+ // Trend over all history
898
+ let trend = null;
899
+ if (history.length >= 3) {
900
+ const first = history[0];
901
+ const last = history[history.length - 1];
902
+ const sessions = history.length;
903
+ const firstConfMean = first.confidences.length
904
+ ? first.confidences.reduce((s, c) => s + c, 0) / first.confidences.length : 0;
905
+ const lastConfMean = last.confidences.length
906
+ ? last.confidences.reduce((s, c) => s + c, 0) / last.confidences.length : 0;
907
+ trend = {
908
+ sessions,
909
+ nodeGrowth: last.nodes - first.nodes,
910
+ edgeGrowth: last.edges - first.edges,
911
+ confidenceDrift: lastConfMean - firstConfMean,
912
+ direction: lastConfMean > firstConfMean ? 'improving' :
913
+ lastConfMean < firstConfMean ? 'declining' : 'stable',
914
+ };
915
+ }
916
+
917
+ const report = {
918
+ graph: { nodes, edges, density: +density.toFixed(4) },
919
+ confidence: {
920
+ min: +confMin.toFixed(3), max: +confMax.toFixed(3),
921
+ mean: +confMean.toFixed(3), median: +confMedian.toFixed(3),
922
+ },
923
+ access: { total: totalAccess, patternsAccessed: accessedCount, patternsNeverAccessed: nodes - accessedCount },
924
+ pageRank: { sum: +prSum.toFixed(4), topNode: prMaxId, topNodeRank: +prMax.toFixed(4) },
925
+ edgeTypes,
926
+ pendingInsights: pending,
927
+ snapshots: history.length,
928
+ topPatterns,
929
+ delta,
930
+ trend,
931
+ };
932
+
933
+ if (outputJson) {
934
+ console.log(JSON.stringify(report, null, 2));
935
+ return report;
936
+ }
937
+
938
+ // Human-readable output
939
+ const bar = '+' + '-'.repeat(62) + '+';
940
+ console.log(bar);
941
+ console.log('|' + ' Intelligence Diagnostics (ADR-050)'.padEnd(62) + '|');
942
+ console.log(bar);
943
+ console.log('');
944
+
945
+ console.log(' Graph');
946
+ console.log(` Nodes: ${nodes}`);
947
+ console.log(` Edges: ${edges} (${Object.entries(edgeTypes).map(([t,c]) => `${c} ${t}`).join(', ') || 'none'})`);
948
+ console.log(` Density: ${(density * 100).toFixed(1)}%`);
949
+ console.log('');
950
+
951
+ console.log(' Confidence');
952
+ console.log(` Min: ${confMin.toFixed(3)}`);
953
+ console.log(` Max: ${confMax.toFixed(3)}`);
954
+ console.log(` Mean: ${confMean.toFixed(3)}`);
955
+ console.log(` Median: ${confMedian.toFixed(3)}`);
956
+ console.log('');
957
+
958
+ console.log(' Access');
959
+ console.log(` Total accesses: ${totalAccess}`);
960
+ console.log(` Patterns used: ${accessedCount}/${nodes}`);
961
+ console.log(` Never accessed: ${nodes - accessedCount}`);
962
+ console.log(` Pending insights: ${pending}`);
963
+ console.log('');
964
+
965
+ console.log(' PageRank');
966
+ console.log(` Sum: ${prSum.toFixed(4)} (should be ~1.0)`);
967
+ console.log(` Top node: ${prMaxId || '(none)'} (${prMax.toFixed(4)})`);
968
+ console.log('');
969
+
970
+ if (topPatterns.length > 0) {
971
+ console.log(' Top Patterns (by composite score)');
972
+ console.log(' ' + '-'.repeat(60));
973
+ for (const p of topPatterns) {
974
+ console.log(` #${p.rank} ${p.summary}`);
975
+ console.log(` conf=${p.confidence} pr=${p.pageRank} score=${p.score} accessed=${p.accessed}x`);
976
+ }
977
+ console.log('');
978
+ }
979
+
980
+ if (delta) {
981
+ console.log(` Last Delta (${delta.elapsed} ago)`);
982
+ const sign = v => v > 0 ? `+${v}` : `${v}`;
983
+ console.log(` Nodes: ${sign(delta.nodes)}`);
984
+ console.log(` Edges: ${sign(delta.edges)}`);
985
+ console.log(` Confidence: ${delta.confidenceMean >= 0 ? '+' : ''}${delta.confidenceMean.toFixed(4)}`);
986
+ console.log(` Accesses: ${sign(delta.totalAccess)}`);
987
+ console.log('');
988
+ }
989
+
990
+ if (trend) {
991
+ console.log(` Trend (${trend.sessions} snapshots)`);
992
+ console.log(` Node growth: ${trend.nodeGrowth >= 0 ? '+' : ''}${trend.nodeGrowth}`);
993
+ console.log(` Edge growth: ${trend.edgeGrowth >= 0 ? '+' : ''}${trend.edgeGrowth}`);
994
+ console.log(` Confidence drift: ${trend.confidenceDrift >= 0 ? '+' : ''}${trend.confidenceDrift.toFixed(4)}`);
995
+ console.log(` Direction: ${trend.direction.toUpperCase()}`);
996
+ console.log('');
997
+ }
998
+
999
+ if (!delta && !trend) {
1000
+ console.log(' No history yet — run more sessions to see deltas and trends.');
1001
+ console.log('');
1002
+ }
1003
+
1004
+ console.log(bar);
1005
+ return report;
1006
+ }
1007
+
1008
+ module.exports = { init, getContext, recordEdit, feedback, consolidate, stats };
1009
+
1010
+ // ── CLI entrypoint ──────────────────────────────────────────────────────────
1011
+ if (require.main === module) {
1012
+ const cmd = process.argv[2];
1013
+ const jsonFlag = process.argv.includes('--json');
1014
+
1015
+ const cmds = {
1016
+ init: () => { const r = init(); console.log(JSON.stringify(r)); },
1017
+ stats: () => { stats(jsonFlag); },
1018
+ consolidate: () => { const r = consolidate(); console.log(JSON.stringify(r)); },
1019
+ };
1020
+
1021
+ if (cmd && cmds[cmd]) {
1022
+ cmds[cmd]();
1023
+ } else {
1024
+ console.log('Usage: intelligence.cjs <stats|init|consolidate> [--json]');
1025
+ console.log('');
1026
+ console.log(' stats Show intelligence diagnostics and trends');
1027
+ console.log(' stats --json Output as JSON for programmatic use');
1028
+ console.log(' init Build graph and rank entries');
1029
+ console.log(' consolidate Process pending insights and recompute');
1030
+ }
1031
+ }