@sparkleideas/agentic-flow 2.0.2-alpha-patch.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (641) hide show
  1. package/README.md +2026 -0
  2. package/agentic-flow/.claude/agents/MIGRATION_SUMMARY.md +222 -0
  3. package/agentic-flow/.claude/agents/README.md +89 -0
  4. package/agentic-flow/.claude/agents/analysis/analyze-code-quality.md +180 -0
  5. package/agentic-flow/.claude/agents/analysis/code-analyzer.md +209 -0
  6. package/agentic-flow/.claude/agents/architecture/arch-system-design.md +156 -0
  7. package/agentic-flow/.claude/agents/base-template-generator.md +268 -0
  8. package/agentic-flow/.claude/agents/consensus/README.md +253 -0
  9. package/agentic-flow/.claude/agents/consensus/byzantine-coordinator.md +63 -0
  10. package/agentic-flow/.claude/agents/consensus/crdt-synchronizer.md +997 -0
  11. package/agentic-flow/.claude/agents/consensus/gossip-coordinator.md +63 -0
  12. package/agentic-flow/.claude/agents/consensus/performance-benchmarker.md +851 -0
  13. package/agentic-flow/.claude/agents/consensus/quorum-manager.md +823 -0
  14. package/agentic-flow/.claude/agents/consensus/raft-manager.md +63 -0
  15. package/agentic-flow/.claude/agents/consensus/security-manager.md +622 -0
  16. package/agentic-flow/.claude/agents/core/coder.md +416 -0
  17. package/agentic-flow/.claude/agents/core/planner.md +337 -0
  18. package/agentic-flow/.claude/agents/core/researcher.md +331 -0
  19. package/agentic-flow/.claude/agents/core/reviewer.md +483 -0
  20. package/agentic-flow/.claude/agents/core/tester.md +476 -0
  21. package/agentic-flow/.claude/agents/custom/test-long-runner.md +44 -0
  22. package/agentic-flow/.claude/agents/data/data-ml-model.md +444 -0
  23. package/agentic-flow/.claude/agents/development/dev-backend-api.md +345 -0
  24. package/agentic-flow/.claude/agents/devops/ops-cicd-github.md +164 -0
  25. package/agentic-flow/.claude/agents/documentation/docs-api-openapi.md +354 -0
  26. package/agentic-flow/.claude/agents/flow-nexus/app-store.md +88 -0
  27. package/agentic-flow/.claude/agents/flow-nexus/authentication.md +69 -0
  28. package/agentic-flow/.claude/agents/flow-nexus/challenges.md +81 -0
  29. package/agentic-flow/.claude/agents/flow-nexus/neural-network.md +88 -0
  30. package/agentic-flow/.claude/agents/flow-nexus/payments.md +83 -0
  31. package/agentic-flow/.claude/agents/flow-nexus/sandbox.md +76 -0
  32. package/agentic-flow/.claude/agents/flow-nexus/swarm.md +76 -0
  33. package/agentic-flow/.claude/agents/flow-nexus/user-tools.md +96 -0
  34. package/agentic-flow/.claude/agents/flow-nexus/workflow.md +84 -0
  35. package/agentic-flow/.claude/agents/github/code-review-swarm.md +377 -0
  36. package/agentic-flow/.claude/agents/github/github-modes.md +173 -0
  37. package/agentic-flow/.claude/agents/github/issue-tracker.md +576 -0
  38. package/agentic-flow/.claude/agents/github/multi-repo-swarm.md +553 -0
  39. package/agentic-flow/.claude/agents/github/pr-manager.md +438 -0
  40. package/agentic-flow/.claude/agents/github/project-board-sync.md +509 -0
  41. package/agentic-flow/.claude/agents/github/release-manager.md +605 -0
  42. package/agentic-flow/.claude/agents/github/release-swarm.md +583 -0
  43. package/agentic-flow/.claude/agents/github/repo-architect.md +398 -0
  44. package/agentic-flow/.claude/agents/github/swarm-issue.md +573 -0
  45. package/agentic-flow/.claude/agents/github/swarm-pr.md +428 -0
  46. package/agentic-flow/.claude/agents/github/sync-coordinator.md +452 -0
  47. package/agentic-flow/.claude/agents/github/workflow-automation.md +903 -0
  48. package/agentic-flow/.claude/agents/goal/agent.md +816 -0
  49. package/agentic-flow/.claude/agents/goal/goal-planner.md +73 -0
  50. package/agentic-flow/.claude/agents/optimization/README.md +250 -0
  51. package/agentic-flow/.claude/agents/optimization/benchmark-suite.md +665 -0
  52. package/agentic-flow/.claude/agents/optimization/load-balancer.md +431 -0
  53. package/agentic-flow/.claude/agents/optimization/performance-monitor.md +672 -0
  54. package/agentic-flow/.claude/agents/optimization/resource-allocator.md +674 -0
  55. package/agentic-flow/.claude/agents/optimization/topology-optimizer.md +808 -0
  56. package/agentic-flow/.claude/agents/payments/agentic-payments.md +126 -0
  57. package/agentic-flow/.claude/agents/sona/sona-learning-optimizer.md +496 -0
  58. package/agentic-flow/.claude/agents/sparc/architecture.md +699 -0
  59. package/agentic-flow/.claude/agents/sparc/pseudocode.md +520 -0
  60. package/agentic-flow/.claude/agents/sparc/refinement.md +802 -0
  61. package/agentic-flow/.claude/agents/sparc/specification.md +478 -0
  62. package/agentic-flow/.claude/agents/specialized/spec-mobile-react-native.md +226 -0
  63. package/agentic-flow/.claude/agents/sublinear/consensus-coordinator.md +338 -0
  64. package/agentic-flow/.claude/agents/sublinear/matrix-optimizer.md +185 -0
  65. package/agentic-flow/.claude/agents/sublinear/pagerank-analyzer.md +299 -0
  66. package/agentic-flow/.claude/agents/sublinear/performance-optimizer.md +368 -0
  67. package/agentic-flow/.claude/agents/sublinear/trading-predictor.md +246 -0
  68. package/agentic-flow/.claude/agents/swarm/README.md +190 -0
  69. package/agentic-flow/.claude/agents/swarm/adaptive-coordinator.md +1127 -0
  70. package/agentic-flow/.claude/agents/swarm/hierarchical-coordinator.md +710 -0
  71. package/agentic-flow/.claude/agents/swarm/mesh-coordinator.md +963 -0
  72. package/agentic-flow/.claude/agents/templates/automation-smart-agent.md +205 -0
  73. package/agentic-flow/.claude/agents/templates/coordinator-swarm-init.md +90 -0
  74. package/agentic-flow/.claude/agents/templates/github-pr-manager.md +177 -0
  75. package/agentic-flow/.claude/agents/templates/implementer-sparc-coder.md +259 -0
  76. package/agentic-flow/.claude/agents/templates/memory-coordinator.md +187 -0
  77. package/agentic-flow/.claude/agents/templates/migration-plan.md +746 -0
  78. package/agentic-flow/.claude/agents/templates/orchestrator-task.md +139 -0
  79. package/agentic-flow/.claude/agents/templates/performance-analyzer.md +199 -0
  80. package/agentic-flow/.claude/agents/templates/sparc-coordinator.md +514 -0
  81. package/agentic-flow/.claude/agents/testing/production-validator.md +395 -0
  82. package/agentic-flow/.claude/agents/testing/tdd-london-swarm.md +244 -0
  83. package/agentic-flow/.claude/answer.md +1 -0
  84. package/agentic-flow/.claude/commands/agents/README.md +10 -0
  85. package/agentic-flow/.claude/commands/agents/agent-capabilities.md +21 -0
  86. package/agentic-flow/.claude/commands/agents/agent-coordination.md +28 -0
  87. package/agentic-flow/.claude/commands/agents/agent-spawning.md +28 -0
  88. package/agentic-flow/.claude/commands/agents/agent-types.md +26 -0
  89. package/agentic-flow/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +54 -0
  90. package/agentic-flow/.claude/commands/analysis/README.md +9 -0
  91. package/agentic-flow/.claude/commands/analysis/bottleneck-detect.md +162 -0
  92. package/agentic-flow/.claude/commands/analysis/performance-bottlenecks.md +59 -0
  93. package/agentic-flow/.claude/commands/analysis/performance-report.md +25 -0
  94. package/agentic-flow/.claude/commands/analysis/token-efficiency.md +45 -0
  95. package/agentic-flow/.claude/commands/analysis/token-usage.md +25 -0
  96. package/agentic-flow/.claude/commands/automation/README.md +9 -0
  97. package/agentic-flow/.claude/commands/automation/auto-agent.md +122 -0
  98. package/agentic-flow/.claude/commands/automation/self-healing.md +106 -0
  99. package/agentic-flow/.claude/commands/automation/session-memory.md +90 -0
  100. package/agentic-flow/.claude/commands/automation/smart-agents.md +73 -0
  101. package/agentic-flow/.claude/commands/automation/smart-spawn.md +25 -0
  102. package/agentic-flow/.claude/commands/automation/workflow-select.md +25 -0
  103. package/agentic-flow/.claude/commands/claude-flow-help.md +103 -0
  104. package/agentic-flow/.claude/commands/claude-flow-memory.md +107 -0
  105. package/agentic-flow/.claude/commands/claude-flow-swarm.md +205 -0
  106. package/agentic-flow/.claude/commands/flow-nexus/app-store.md +124 -0
  107. package/agentic-flow/.claude/commands/flow-nexus/challenges.md +120 -0
  108. package/agentic-flow/.claude/commands/flow-nexus/login-registration.md +65 -0
  109. package/agentic-flow/.claude/commands/flow-nexus/neural-network.md +134 -0
  110. package/agentic-flow/.claude/commands/flow-nexus/payments.md +116 -0
  111. package/agentic-flow/.claude/commands/flow-nexus/sandbox.md +83 -0
  112. package/agentic-flow/.claude/commands/flow-nexus/swarm.md +87 -0
  113. package/agentic-flow/.claude/commands/flow-nexus/user-tools.md +152 -0
  114. package/agentic-flow/.claude/commands/flow-nexus/workflow.md +115 -0
  115. package/agentic-flow/.claude/commands/github/README.md +11 -0
  116. package/agentic-flow/.claude/commands/github/code-review-swarm.md +514 -0
  117. package/agentic-flow/.claude/commands/github/code-review.md +25 -0
  118. package/agentic-flow/.claude/commands/github/github-modes.md +147 -0
  119. package/agentic-flow/.claude/commands/github/github-swarm.md +121 -0
  120. package/agentic-flow/.claude/commands/github/issue-tracker.md +292 -0
  121. package/agentic-flow/.claude/commands/github/issue-triage.md +25 -0
  122. package/agentic-flow/.claude/commands/github/multi-repo-swarm.md +519 -0
  123. package/agentic-flow/.claude/commands/github/pr-enhance.md +26 -0
  124. package/agentic-flow/.claude/commands/github/pr-manager.md +170 -0
  125. package/agentic-flow/.claude/commands/github/project-board-sync.md +471 -0
  126. package/agentic-flow/.claude/commands/github/release-manager.md +338 -0
  127. package/agentic-flow/.claude/commands/github/release-swarm.md +544 -0
  128. package/agentic-flow/.claude/commands/github/repo-analyze.md +25 -0
  129. package/agentic-flow/.claude/commands/github/repo-architect.md +367 -0
  130. package/agentic-flow/.claude/commands/github/swarm-issue.md +482 -0
  131. package/agentic-flow/.claude/commands/github/swarm-pr.md +285 -0
  132. package/agentic-flow/.claude/commands/github/sync-coordinator.md +301 -0
  133. package/agentic-flow/.claude/commands/github/workflow-automation.md +442 -0
  134. package/agentic-flow/.claude/commands/hive-mind/README.md +17 -0
  135. package/agentic-flow/.claude/commands/hive-mind/hive-mind-consensus.md +8 -0
  136. package/agentic-flow/.claude/commands/hive-mind/hive-mind-init.md +18 -0
  137. package/agentic-flow/.claude/commands/hive-mind/hive-mind-memory.md +8 -0
  138. package/agentic-flow/.claude/commands/hive-mind/hive-mind-metrics.md +8 -0
  139. package/agentic-flow/.claude/commands/hive-mind/hive-mind-resume.md +8 -0
  140. package/agentic-flow/.claude/commands/hive-mind/hive-mind-sessions.md +8 -0
  141. package/agentic-flow/.claude/commands/hive-mind/hive-mind-spawn.md +21 -0
  142. package/agentic-flow/.claude/commands/hive-mind/hive-mind-status.md +8 -0
  143. package/agentic-flow/.claude/commands/hive-mind/hive-mind-stop.md +8 -0
  144. package/agentic-flow/.claude/commands/hive-mind/hive-mind-wizard.md +8 -0
  145. package/agentic-flow/.claude/commands/hive-mind/hive-mind.md +27 -0
  146. package/agentic-flow/.claude/commands/hooks/README.md +11 -0
  147. package/agentic-flow/.claude/commands/hooks/overview.md +58 -0
  148. package/agentic-flow/.claude/commands/hooks/post-edit.md +117 -0
  149. package/agentic-flow/.claude/commands/hooks/post-task.md +112 -0
  150. package/agentic-flow/.claude/commands/hooks/pre-edit.md +113 -0
  151. package/agentic-flow/.claude/commands/hooks/pre-task.md +111 -0
  152. package/agentic-flow/.claude/commands/hooks/session-end.md +118 -0
  153. package/agentic-flow/.claude/commands/hooks/setup.md +103 -0
  154. package/agentic-flow/.claude/commands/monitoring/README.md +9 -0
  155. package/agentic-flow/.claude/commands/monitoring/agent-metrics.md +25 -0
  156. package/agentic-flow/.claude/commands/monitoring/agents.md +44 -0
  157. package/agentic-flow/.claude/commands/monitoring/real-time-view.md +25 -0
  158. package/agentic-flow/.claude/commands/monitoring/status.md +46 -0
  159. package/agentic-flow/.claude/commands/monitoring/swarm-monitor.md +25 -0
  160. package/agentic-flow/.claude/commands/optimization/README.md +9 -0
  161. package/agentic-flow/.claude/commands/optimization/auto-topology.md +62 -0
  162. package/agentic-flow/.claude/commands/optimization/cache-manage.md +25 -0
  163. package/agentic-flow/.claude/commands/optimization/parallel-execute.md +25 -0
  164. package/agentic-flow/.claude/commands/optimization/parallel-execution.md +50 -0
  165. package/agentic-flow/.claude/commands/optimization/topology-optimize.md +25 -0
  166. package/agentic-flow/.claude/commands/pair/README.md +261 -0
  167. package/agentic-flow/.claude/commands/pair/commands.md +546 -0
  168. package/agentic-flow/.claude/commands/pair/config.md +510 -0
  169. package/agentic-flow/.claude/commands/pair/examples.md +512 -0
  170. package/agentic-flow/.claude/commands/pair/modes.md +348 -0
  171. package/agentic-flow/.claude/commands/pair/session.md +407 -0
  172. package/agentic-flow/.claude/commands/pair/start.md +209 -0
  173. package/agentic-flow/.claude/commands/sparc/analyzer.md +52 -0
  174. package/agentic-flow/.claude/commands/sparc/architect.md +53 -0
  175. package/agentic-flow/.claude/commands/sparc/ask.md +97 -0
  176. package/agentic-flow/.claude/commands/sparc/batch-executor.md +54 -0
  177. package/agentic-flow/.claude/commands/sparc/code.md +89 -0
  178. package/agentic-flow/.claude/commands/sparc/coder.md +54 -0
  179. package/agentic-flow/.claude/commands/sparc/debug.md +83 -0
  180. package/agentic-flow/.claude/commands/sparc/debugger.md +54 -0
  181. package/agentic-flow/.claude/commands/sparc/designer.md +53 -0
  182. package/agentic-flow/.claude/commands/sparc/devops.md +109 -0
  183. package/agentic-flow/.claude/commands/sparc/docs-writer.md +80 -0
  184. package/agentic-flow/.claude/commands/sparc/documenter.md +54 -0
  185. package/agentic-flow/.claude/commands/sparc/innovator.md +54 -0
  186. package/agentic-flow/.claude/commands/sparc/integration.md +83 -0
  187. package/agentic-flow/.claude/commands/sparc/mcp.md +117 -0
  188. package/agentic-flow/.claude/commands/sparc/memory-manager.md +54 -0
  189. package/agentic-flow/.claude/commands/sparc/optimizer.md +54 -0
  190. package/agentic-flow/.claude/commands/sparc/orchestrator.md +132 -0
  191. package/agentic-flow/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -0
  192. package/agentic-flow/.claude/commands/sparc/refinement-optimization-mode.md +83 -0
  193. package/agentic-flow/.claude/commands/sparc/researcher.md +54 -0
  194. package/agentic-flow/.claude/commands/sparc/reviewer.md +54 -0
  195. package/agentic-flow/.claude/commands/sparc/security-review.md +80 -0
  196. package/agentic-flow/.claude/commands/sparc/sparc-modes.md +174 -0
  197. package/agentic-flow/.claude/commands/sparc/sparc.md +111 -0
  198. package/agentic-flow/.claude/commands/sparc/spec-pseudocode.md +80 -0
  199. package/agentic-flow/.claude/commands/sparc/supabase-admin.md +348 -0
  200. package/agentic-flow/.claude/commands/sparc/swarm-coordinator.md +54 -0
  201. package/agentic-flow/.claude/commands/sparc/tdd.md +54 -0
  202. package/agentic-flow/.claude/commands/sparc/tester.md +54 -0
  203. package/agentic-flow/.claude/commands/sparc/tutorial.md +79 -0
  204. package/agentic-flow/.claude/commands/sparc/workflow-manager.md +54 -0
  205. package/agentic-flow/.claude/commands/sparc.md +166 -0
  206. package/agentic-flow/.claude/commands/stream-chain/pipeline.md +121 -0
  207. package/agentic-flow/.claude/commands/stream-chain/run.md +70 -0
  208. package/agentic-flow/.claude/commands/swarm/README.md +15 -0
  209. package/agentic-flow/.claude/commands/swarm/analysis.md +95 -0
  210. package/agentic-flow/.claude/commands/swarm/development.md +96 -0
  211. package/agentic-flow/.claude/commands/swarm/examples.md +168 -0
  212. package/agentic-flow/.claude/commands/swarm/maintenance.md +102 -0
  213. package/agentic-flow/.claude/commands/swarm/optimization.md +117 -0
  214. package/agentic-flow/.claude/commands/swarm/research.md +136 -0
  215. package/agentic-flow/.claude/commands/swarm/swarm-analysis.md +8 -0
  216. package/agentic-flow/.claude/commands/swarm/swarm-background.md +8 -0
  217. package/agentic-flow/.claude/commands/swarm/swarm-init.md +19 -0
  218. package/agentic-flow/.claude/commands/swarm/swarm-modes.md +8 -0
  219. package/agentic-flow/.claude/commands/swarm/swarm-monitor.md +8 -0
  220. package/agentic-flow/.claude/commands/swarm/swarm-spawn.md +19 -0
  221. package/agentic-flow/.claude/commands/swarm/swarm-status.md +8 -0
  222. package/agentic-flow/.claude/commands/swarm/swarm-strategies.md +8 -0
  223. package/agentic-flow/.claude/commands/swarm/swarm.md +27 -0
  224. package/agentic-flow/.claude/commands/swarm/testing.md +131 -0
  225. package/agentic-flow/.claude/commands/training/README.md +9 -0
  226. package/agentic-flow/.claude/commands/training/model-update.md +25 -0
  227. package/agentic-flow/.claude/commands/training/neural-patterns.md +74 -0
  228. package/agentic-flow/.claude/commands/training/neural-train.md +25 -0
  229. package/agentic-flow/.claude/commands/training/pattern-learn.md +25 -0
  230. package/agentic-flow/.claude/commands/training/specialization.md +63 -0
  231. package/agentic-flow/.claude/commands/truth/start.md +143 -0
  232. package/agentic-flow/.claude/commands/verify/check.md +50 -0
  233. package/agentic-flow/.claude/commands/verify/start.md +128 -0
  234. package/agentic-flow/.claude/commands/workflows/README.md +9 -0
  235. package/agentic-flow/.claude/commands/workflows/development.md +78 -0
  236. package/agentic-flow/.claude/commands/workflows/research.md +63 -0
  237. package/agentic-flow/.claude/commands/workflows/workflow-create.md +25 -0
  238. package/agentic-flow/.claude/commands/workflows/workflow-execute.md +25 -0
  239. package/agentic-flow/.claude/commands/workflows/workflow-export.md +25 -0
  240. package/agentic-flow/.claude/helpers/checkpoint-manager.sh +251 -0
  241. package/agentic-flow/.claude/helpers/github-safe.js +106 -0
  242. package/agentic-flow/.claude/helpers/github-setup.sh +28 -0
  243. package/agentic-flow/.claude/helpers/quick-start.sh +19 -0
  244. package/agentic-flow/.claude/helpers/setup-mcp.sh +18 -0
  245. package/agentic-flow/.claude/helpers/standard-checkpoint-hooks.sh +179 -0
  246. package/agentic-flow/.claude/mcp.json +13 -0
  247. package/agentic-flow/.claude/openrouter-models-research.md +411 -0
  248. package/agentic-flow/.claude/openrouter-quick-reference.md +113 -0
  249. package/agentic-flow/.claude/settings-backup.json +130 -0
  250. package/agentic-flow/.claude/settings-optimized.json +116 -0
  251. package/agentic-flow/.claude/settings-simple.json +78 -0
  252. package/agentic-flow/.claude/settings.json +238 -0
  253. package/agentic-flow/.claude/settings.local.json +14 -0
  254. package/agentic-flow/.claude/skills/agentic-flow-quickstart/skill.md +69 -0
  255. package/agentic-flow/.claude/skills/hooks-automation/skill.md +155 -0
  256. package/agentic-flow/.claude/skills/memory-patterns/skill.md +110 -0
  257. package/agentic-flow/.claude/skills/sparc-methodology/skill.md +137 -0
  258. package/agentic-flow/.claude/skills/swarm-coordination/skill.md +94 -0
  259. package/agentic-flow/.claude/skills/worker-benchmarks/skill.md +135 -0
  260. package/agentic-flow/.claude/skills/worker-integration/skill.md +154 -0
  261. package/agentic-flow/.claude/statusline.mjs +109 -0
  262. package/agentic-flow/.claude/statusline.sh +71 -0
  263. package/agentic-flow/CHANGELOG.md +68 -0
  264. package/agentic-flow/README.md +2047 -0
  265. package/agentic-flow/dist/reasoningbank/config/reasoningbank.yaml +145 -0
  266. package/agentic-flow/dist/reasoningbank/prompts/distill-failure.json +111 -0
  267. package/agentic-flow/dist/reasoningbank/prompts/distill-success.json +74 -0
  268. package/agentic-flow/dist/reasoningbank/prompts/judge.json +101 -0
  269. package/agentic-flow/dist/reasoningbank/prompts/matts-aggregate.json +119 -0
  270. package/agentic-flow/docs/CLAUDE.md +352 -0
  271. package/agentic-flow/docs/DOCKER-VERIFICATION.md +207 -0
  272. package/agentic-flow/docs/IMPROVEMENT_ROADMAP.md +184 -0
  273. package/agentic-flow/docs/ISSUE-55-VALIDATION.md +171 -0
  274. package/agentic-flow/docs/LICENSE +21 -0
  275. package/agentic-flow/docs/NPX_AGENTDB_SETUP.md +175 -0
  276. package/agentic-flow/docs/OPTIMIZATIONS.md +460 -0
  277. package/agentic-flow/docs/PUBLISH_GUIDE.md +438 -0
  278. package/agentic-flow/docs/README.md +217 -0
  279. package/agentic-flow/docs/RELEASE-v1.10.0-COMPLETE.md +382 -0
  280. package/agentic-flow/docs/architecture/EXECUTIVE_SUMMARY.md +310 -0
  281. package/agentic-flow/docs/architecture/FEDERATION-DATA-LIFECYCLE.md +520 -0
  282. package/agentic-flow/docs/architecture/IMPROVEMENT_PLAN.md +11 -0
  283. package/agentic-flow/docs/architecture/INTEGRATION-STATUS.md +290 -0
  284. package/agentic-flow/docs/architecture/MULTI_MODEL_ROUTER_PLAN.md +620 -0
  285. package/agentic-flow/docs/architecture/PACKAGE_STRUCTURE.md +199 -0
  286. package/agentic-flow/docs/architecture/QUIC-IMPLEMENTATION-SUMMARY.md +490 -0
  287. package/agentic-flow/docs/architecture/QUIC-SWARM-INTEGRATION.md +593 -0
  288. package/agentic-flow/docs/architecture/QUICK_WINS.md +333 -0
  289. package/agentic-flow/docs/architecture/README.md +15 -0
  290. package/agentic-flow/docs/architecture/RESEARCH_SUMMARY.md +652 -0
  291. package/agentic-flow/docs/archive/.agentdb-instructions.md +66 -0
  292. package/agentic-flow/docs/archive/AGENT-BOOSTER-STATUS.md +292 -0
  293. package/agentic-flow/docs/archive/CHANGELOG-v1.3.0.md +120 -0
  294. package/agentic-flow/docs/archive/COMPLETION_REPORT_v1.7.1.md +335 -0
  295. package/agentic-flow/docs/archive/IMPLEMENTATION_SUMMARY_v1.7.1.md +241 -0
  296. package/agentic-flow/docs/archive/SUPABASE-INTEGRATION-COMPLETE.md +357 -0
  297. package/agentic-flow/docs/archive/TESTING_QUICK_START.md +223 -0
  298. package/agentic-flow/docs/archive/TOOL-EMULATION-INTEGRATION-ISSUE.md +669 -0
  299. package/agentic-flow/docs/archive/VALIDATION_v1.7.1.md +234 -0
  300. package/agentic-flow/docs/archived/COMPLETE_VALIDATION_SUMMARY.md +405 -0
  301. package/agentic-flow/docs/archived/DOCKER_MCP_VALIDATION.md +358 -0
  302. package/agentic-flow/docs/archived/DOCKER_OPENROUTER_VALIDATION.md +443 -0
  303. package/agentic-flow/docs/archived/FASTMCP_COMPLETE.md +428 -0
  304. package/agentic-flow/docs/archived/FASTMCP_INTEGRATION_STATUS.md +288 -0
  305. package/agentic-flow/docs/archived/FINAL_SDK_VALIDATION.md +328 -0
  306. package/agentic-flow/docs/archived/FINAL_SYSTEM_VALIDATION.md +458 -0
  307. package/agentic-flow/docs/archived/FINAL_VALIDATION_SUMMARY.md +409 -0
  308. package/agentic-flow/docs/archived/FIXES-APPLIED-STATUS.md +331 -0
  309. package/agentic-flow/docs/archived/FLOW-NEXUS-COMPLETE.md +269 -0
  310. package/agentic-flow/docs/archived/HOTFIX_1.1.7.md +133 -0
  311. package/agentic-flow/docs/archived/INTEGRATION_CONFIRMED.md +351 -0
  312. package/agentic-flow/docs/archived/MCP_CLI_TOOLS_VALIDATION.md +266 -0
  313. package/agentic-flow/docs/archived/MCP_INTEGRATION_SUCCESS.md +305 -0
  314. package/agentic-flow/docs/archived/MCP_PROXY_VALIDATION.md +185 -0
  315. package/agentic-flow/docs/archived/MODEL_VALIDATION_REPORT.md +386 -0
  316. package/agentic-flow/docs/archived/ONNX_ENV_VARS.md +564 -0
  317. package/agentic-flow/docs/archived/ONNX_FINAL_REPORT.md +312 -0
  318. package/agentic-flow/docs/archived/ONNX_IMPLEMENTATION_COMPLETE.md +215 -0
  319. package/agentic-flow/docs/archived/ONNX_IMPLEMENTATION_SUMMARY.md +197 -0
  320. package/agentic-flow/docs/archived/ONNX_INTEGRATION.md +422 -0
  321. package/agentic-flow/docs/archived/ONNX_OPTIMIZATION_SUMMARY.md +374 -0
  322. package/agentic-flow/docs/archived/ONNX_PHI4_RESEARCH.md +220 -0
  323. package/agentic-flow/docs/archived/ONNX_RUNTIME_INTEGRATION_PLAN.md +866 -0
  324. package/agentic-flow/docs/archived/ONNX_SUCCESS_REPORT.md +271 -0
  325. package/agentic-flow/docs/archived/ONNX_VS_CLAUDE_QUALITY.md +442 -0
  326. package/agentic-flow/docs/archived/OPENROUTER-FIX-VALIDATION.md +333 -0
  327. package/agentic-flow/docs/archived/OPENROUTER-SUCCESS-REPORT.md +520 -0
  328. package/agentic-flow/docs/archived/OPENROUTER_ISSUES_AND_FIXES.md +277 -0
  329. package/agentic-flow/docs/archived/OPENROUTER_PROXY_COMPLETE.md +494 -0
  330. package/agentic-flow/docs/archived/OPENROUTER_VALIDATION_COMPLETE.md +382 -0
  331. package/agentic-flow/docs/archived/OPTIMIZATION_SUMMARY.md +181 -0
  332. package/agentic-flow/docs/archived/PACKAGE-COMPLETE.md +138 -0
  333. package/agentic-flow/docs/archived/PHI4_HYPEROPTIMIZATION_PLAN.md +2488 -0
  334. package/agentic-flow/docs/archived/PROVIDER_INSTRUCTION_OPTIMIZATION.md +139 -0
  335. package/agentic-flow/docs/archived/PROXY_VALIDATION.md +239 -0
  336. package/agentic-flow/docs/archived/README.md +20 -0
  337. package/agentic-flow/docs/archived/README_SDK_VALIDATION.md +356 -0
  338. package/agentic-flow/docs/archived/README_V1.1.11.md +280 -0
  339. package/agentic-flow/docs/archived/RELEASE-NOTES-v1.1.13.md +392 -0
  340. package/agentic-flow/docs/archived/RELEASE-SUMMARY-v1.1.14-beta.1.md +336 -0
  341. package/agentic-flow/docs/archived/RESEARCH_COMPLETE.txt +335 -0
  342. package/agentic-flow/docs/archived/ROUTER_VALIDATION.md +311 -0
  343. package/agentic-flow/docs/archived/SDK-SETUP-COMPLETE.md +252 -0
  344. package/agentic-flow/docs/archived/SDK_INTEGRATION_COMPLETE.md +336 -0
  345. package/agentic-flow/docs/archived/TOOL_INSTRUCTION_ENHANCEMENT.md +200 -0
  346. package/agentic-flow/docs/archived/V1.1.10_VALIDATION.md +194 -0
  347. package/agentic-flow/docs/archived/V1.1.11_COMPLETE_VALIDATION.md +308 -0
  348. package/agentic-flow/docs/archived/V1.1.11_MCP_PROXY_FIX.md +374 -0
  349. package/agentic-flow/docs/archived/V1.1.14-BETA-READY.md +418 -0
  350. package/agentic-flow/docs/archived/VALIDATION-RESULTS.md +279 -0
  351. package/agentic-flow/docs/archived/VALIDATION_COMPLETE.md +178 -0
  352. package/agentic-flow/docs/archived/VALIDATION_SUMMARY.md +224 -0
  353. package/agentic-flow/docs/archived/claude-flow-integration.md +463 -0
  354. package/agentic-flow/docs/archived/docker-cli-validation.md +289 -0
  355. package/agentic-flow/docs/archived/docker-memory-coordination-status.md +261 -0
  356. package/agentic-flow/docs/archived/mcp-validation-summary.md +264 -0
  357. package/agentic-flow/docs/archived/quick-wins-validation.md +377 -0
  358. package/agentic-flow/docs/benchmarks/optimization-guide.md +531 -0
  359. package/agentic-flow/docs/benchmarks/quic-results.md +494 -0
  360. package/agentic-flow/docs/docker-tests/TEST-V1.7.8.Dockerfile +13 -0
  361. package/agentic-flow/docs/docker-tests/TEST-V1.7.9-NODE20.Dockerfile +13 -0
  362. package/agentic-flow/docs/docker-tests/TEST-V1.7.9.Dockerfile +14 -0
  363. package/agentic-flow/docs/embeddings/EMBEDDING_GEOMETRY.md +935 -0
  364. package/agentic-flow/docs/federation/AGENT-DEBUG-STREAMING.md +403 -0
  365. package/agentic-flow/docs/federation/DEBUG-STREAMING-COMPLETE.md +432 -0
  366. package/agentic-flow/docs/federation/DEBUG-STREAMING.md +537 -0
  367. package/agentic-flow/docs/federation/DEPLOYMENT-VALIDATION-SUCCESS.md +394 -0
  368. package/agentic-flow/docs/federation/DOCKER-FEDERATION-DEEP-REVIEW.md +478 -0
  369. package/agentic-flow/docs/guides/ADDING-MCP-SERVERS-CLI.md +515 -0
  370. package/agentic-flow/docs/guides/ADDING-MCP-SERVERS.md +642 -0
  371. package/agentic-flow/docs/guides/AGENT-BOOSTER.md +435 -0
  372. package/agentic-flow/docs/guides/ALTERNATIVE_LLM_MODELS.md +524 -0
  373. package/agentic-flow/docs/guides/CLAUDE-CODE-INTEGRATION.md +403 -0
  374. package/agentic-flow/docs/guides/DEPLOYMENT.md +906 -0
  375. package/agentic-flow/docs/guides/DOCKER_AGENT_USAGE.md +352 -0
  376. package/agentic-flow/docs/guides/IMPLEMENTATION_EXAMPLES.md +960 -0
  377. package/agentic-flow/docs/guides/MCP-TOOLS.md +1166 -0
  378. package/agentic-flow/docs/guides/MODEL-ID-MAPPING.md +193 -0
  379. package/agentic-flow/docs/guides/MULTI-MODEL-ROUTER.md +702 -0
  380. package/agentic-flow/docs/guides/NPM-PUBLISH.md +218 -0
  381. package/agentic-flow/docs/guides/ONNX-PROXY-IMPLEMENTATION.md +254 -0
  382. package/agentic-flow/docs/guides/ONNX_CLI_USAGE.md +344 -0
  383. package/agentic-flow/docs/guides/ONNX_OPTIMIZATION_GUIDE.md +665 -0
  384. package/agentic-flow/docs/guides/OPENROUTER_DEPLOYMENT.md +495 -0
  385. package/agentic-flow/docs/guides/PROXY-ARCHITECTURE-AND-EXTENSION.md +708 -0
  386. package/agentic-flow/docs/guides/QUIC-SWARM-QUICKSTART.md +543 -0
  387. package/agentic-flow/docs/guides/QUICK-START-v1.7.1.md +399 -0
  388. package/agentic-flow/docs/guides/README.md +17 -0
  389. package/agentic-flow/docs/guides/REASONINGBANK.md +721 -0
  390. package/agentic-flow/docs/guides/STANDALONE_PROXY_GUIDE.md +437 -0
  391. package/agentic-flow/docs/guides/agent-sdk.md +234 -0
  392. package/agentic-flow/docs/integration-docs/AGENT-BOOSTER-INTEGRATION.md +379 -0
  393. package/agentic-flow/docs/integration-docs/CLAUDE-FLOW-INTEGRATION-ANALYSIS.md +653 -0
  394. package/agentic-flow/docs/integration-docs/CLI-INTEGRATION-COMPLETE.md +283 -0
  395. package/agentic-flow/docs/integration-docs/IMPLEMENTATION_SUMMARY.md +369 -0
  396. package/agentic-flow/docs/integration-docs/INTEGRATION-COMPLETE.md +291 -0
  397. package/agentic-flow/docs/integration-docs/INTEGRATION-QUICK-SUMMARY.md +249 -0
  398. package/agentic-flow/docs/integration-docs/INTEGRATION-STATUS-CORRECTED.md +488 -0
  399. package/agentic-flow/docs/integration-docs/INTEGRATION_COMPLETE_SUMMARY.md +780 -0
  400. package/agentic-flow/docs/integration-docs/QUIC-WASM-INTEGRATION.md +537 -0
  401. package/agentic-flow/docs/integration-docs/README.md +61 -0
  402. package/agentic-flow/docs/integration-docs/WASM_ESM_FIX.md +180 -0
  403. package/agentic-flow/docs/integration-docs/WASM_INTEGRATION_COMPLETE.md +344 -0
  404. package/agentic-flow/docs/integrations/CLAUDE_AGENTS_INTEGRATION.md +356 -0
  405. package/agentic-flow/docs/integrations/CLAUDE_FLOW_INTEGRATION.md +535 -0
  406. package/agentic-flow/docs/integrations/FASTMCP_CLI_INTEGRATION.md +503 -0
  407. package/agentic-flow/docs/integrations/FLOW-NEXUS-INTEGRATION.md +319 -0
  408. package/agentic-flow/docs/integrations/README.md +18 -0
  409. package/agentic-flow/docs/integrations/fastmcp-implementation-plan.md +2516 -0
  410. package/agentic-flow/docs/integrations/fastmcp-poc-integration.md +198 -0
  411. package/agentic-flow/docs/issues/ISSUE-SUPABASE-INTEGRATION.md +536 -0
  412. package/agentic-flow/docs/issues/ISSUE-xenova-transformers-dependency.md +380 -0
  413. package/agentic-flow/docs/mcp-validation/IMPLEMENTATION-SUMMARY.md +493 -0
  414. package/agentic-flow/docs/mcp-validation/MCP-CLI-VALIDATION-REPORT.md +322 -0
  415. package/agentic-flow/docs/mcp-validation/README.md +43 -0
  416. package/agentic-flow/docs/mcp-validation/strange-loops-test.md +63 -0
  417. package/agentic-flow/docs/plans/QUIC/BUILD_INSTRUCTIONS.md +220 -0
  418. package/agentic-flow/docs/plans/QUIC/IMPLEMENTATION_STATUS.md +234 -0
  419. package/agentic-flow/docs/plans/QUIC/QUIC-INTEGRATION-SUMMARY.md +545 -0
  420. package/agentic-flow/docs/plans/QUIC/QUIC-INTEGRATION.md +502 -0
  421. package/agentic-flow/docs/plans/QUIC/QUIC-README.md +226 -0
  422. package/agentic-flow/docs/plans/QUIC/QUIC_IMPLEMENTATION_SUMMARY.md +607 -0
  423. package/agentic-flow/docs/plans/QUIC/README-CONDENSED.md +447 -0
  424. package/agentic-flow/docs/plans/QUIC/quic-research.md +1415 -0
  425. package/agentic-flow/docs/plans/QUIC/quic-tutorial.md +485 -0
  426. package/agentic-flow/docs/plans/agent-booster/00-INDEX.md +230 -0
  427. package/agentic-flow/docs/plans/agent-booster/00-OVERVIEW.md +454 -0
  428. package/agentic-flow/docs/plans/agent-booster/01-ARCHITECTURE.md +699 -0
  429. package/agentic-flow/docs/plans/agent-booster/02-INTEGRATION.md +771 -0
  430. package/agentic-flow/docs/plans/agent-booster/03-BENCHMARKS.md +616 -0
  431. package/agentic-flow/docs/plans/agent-booster/04-NPM-SDK.md +673 -0
  432. package/agentic-flow/docs/plans/agent-booster/GITHUB-ISSUE.md +523 -0
  433. package/agentic-flow/docs/plans/agent-booster/README.md +576 -0
  434. package/agentic-flow/docs/plans/agent-booster-cli-integration.md +317 -0
  435. package/agentic-flow/docs/plans/requesty/00-overview.md +176 -0
  436. package/agentic-flow/docs/plans/requesty/01-api-research.md +573 -0
  437. package/agentic-flow/docs/plans/requesty/02-architecture.md +1076 -0
  438. package/agentic-flow/docs/plans/requesty/03-implementation-phases.md +1129 -0
  439. package/agentic-flow/docs/plans/requesty/04-testing-strategy.md +905 -0
  440. package/agentic-flow/docs/plans/requesty/05-migration-guide.md +576 -0
  441. package/agentic-flow/docs/plans/requesty/README.md +290 -0
  442. package/agentic-flow/docs/providers/LANDING-PAGE-PROVIDER-CONTENT.md +204 -0
  443. package/agentic-flow/docs/providers/PROVIDER-FALLBACK-GUIDE.md +619 -0
  444. package/agentic-flow/docs/providers/PROVIDER-FALLBACK-SUMMARY.md +418 -0
  445. package/agentic-flow/docs/quantum-goap/DEPENDENCY_GRAPH.mermaid +133 -0
  446. package/agentic-flow/docs/quantum-goap/EXECUTION_SUMMARY.md +199 -0
  447. package/agentic-flow/docs/quantum-goap/GOAP_IMPLEMENTATION_PLAN.md +2406 -0
  448. package/agentic-flow/docs/quantum-goap/QUICK_START.md +301 -0
  449. package/agentic-flow/docs/quantum-research/QUANTUM_RESEARCH_LITERATURE_REVIEW.md +2071 -0
  450. package/agentic-flow/docs/quantum-research/README.md +94 -0
  451. package/agentic-flow/docs/quic/FINAL-VALIDATION.md +336 -0
  452. package/agentic-flow/docs/quic/IMPLEMENTATION-COMPLETE-SUMMARY.md +349 -0
  453. package/agentic-flow/docs/quic/PERFORMANCE-VALIDATION.md +282 -0
  454. package/agentic-flow/docs/quic/QUIC-STATUS-OLD.md +513 -0
  455. package/agentic-flow/docs/quic/QUIC-STATUS.md +451 -0
  456. package/agentic-flow/docs/quic/QUIC-VALIDATION-REPORT.md +370 -0
  457. package/agentic-flow/docs/quic/QUIC_FINAL_STATUS.md +399 -0
  458. package/agentic-flow/docs/quic/README_QUIC_PHASE1.md +117 -0
  459. package/agentic-flow/docs/quic/WASM-INTEGRATION-COMPLETE.md +382 -0
  460. package/agentic-flow/docs/reasoningbank/MEMORY_VALIDATION_REPORT.md +417 -0
  461. package/agentic-flow/docs/reasoningbank/README.md +43 -0
  462. package/agentic-flow/docs/reasoningbank/REASONING-AGENTS.md +482 -0
  463. package/agentic-flow/docs/reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md +166 -0
  464. package/agentic-flow/docs/reasoningbank/REASONINGBANK-BENCHMARK.md +396 -0
  465. package/agentic-flow/docs/reasoningbank/REASONINGBANK-CLI-INTEGRATION.md +455 -0
  466. package/agentic-flow/docs/reasoningbank/REASONINGBANK-DEMO.md +419 -0
  467. package/agentic-flow/docs/reasoningbank/REASONINGBANK-VALIDATION.md +532 -0
  468. package/agentic-flow/docs/reasoningbank/REASONINGBANK_ARCHITECTURE.md +663 -0
  469. package/agentic-flow/docs/reasoningbank/REASONINGBANK_BACKENDS.md +375 -0
  470. package/agentic-flow/docs/reasoningbank/REASONINGBANK_FIXES.md +455 -0
  471. package/agentic-flow/docs/reasoningbank/REASONINGBANK_IMPLEMENTATION_STATUS.md +478 -0
  472. package/agentic-flow/docs/reasoningbank/REASONINGBANK_INTEGRATION_PLAN.md +1059 -0
  473. package/agentic-flow/docs/reasoningbank/REASONINGBANK_INVESTIGATION.md +380 -0
  474. package/agentic-flow/docs/releases/GITHUB-ISSUE-ADDENDUM-v1.4.6.md +1529 -0
  475. package/agentic-flow/docs/releases/GITHUB-ISSUE-REASONINGBANK-BENCHMARK.md +643 -0
  476. package/agentic-flow/docs/releases/GITHUB-ISSUE-v1.4.6.md +1453 -0
  477. package/agentic-flow/docs/releases/GITHUB-ISSUE-v1.5.0.md +468 -0
  478. package/agentic-flow/docs/releases/HOTFIX-v1.2.1.md +315 -0
  479. package/agentic-flow/docs/releases/NPM-PUBLISH-GUIDE-v1.2.0.md +440 -0
  480. package/agentic-flow/docs/releases/PUBLISH-COMPLETE-v1.2.0.md +308 -0
  481. package/agentic-flow/docs/releases/PUBLISH_CHECKLIST_v1.10.0.md +396 -0
  482. package/agentic-flow/docs/releases/PUBLISH_SUMMARY_v1.7.1.md +198 -0
  483. package/agentic-flow/docs/releases/README.md +18 -0
  484. package/agentic-flow/docs/releases/RELEASE-v1.2.0.md +339 -0
  485. package/agentic-flow/docs/releases/RELEASE-v1.8.13.md +426 -0
  486. package/agentic-flow/docs/releases/RELEASE_NOTES_v1.10.0.md +464 -0
  487. package/agentic-flow/docs/releases/RELEASE_NOTES_v1.7.0.md +297 -0
  488. package/agentic-flow/docs/releases/RELEASE_v1.7.1.md +327 -0
  489. package/agentic-flow/docs/releases/v1.4.6-reasoningbank-release.md +541 -0
  490. package/agentic-flow/docs/releases/v1.4.7-bugfix.md +212 -0
  491. package/agentic-flow/docs/releases/v1.5.14-QUIC-TRANSPORT.md +201 -0
  492. package/agentic-flow/docs/reports/QUIC_PHASE1_COMPLETE.md +409 -0
  493. package/agentic-flow/docs/reports/QUIC_PHASE1_COMPLETION.md +323 -0
  494. package/agentic-flow/docs/reviews/quic-implementation-review.md +1076 -0
  495. package/agentic-flow/docs/router/README.md +552 -0
  496. package/agentic-flow/docs/router/ROUTER_CONFIG_REFERENCE.md +577 -0
  497. package/agentic-flow/docs/router/ROUTER_USER_GUIDE.md +865 -0
  498. package/agentic-flow/docs/router/TOP20_MODELS_MATRIX.md +80 -0
  499. package/agentic-flow/docs/supabase/IMPLEMENTATION-SUMMARY.md +498 -0
  500. package/agentic-flow/docs/supabase/INDEX.md +358 -0
  501. package/agentic-flow/docs/supabase/QUICKSTART.md +365 -0
  502. package/agentic-flow/docs/supabase/README.md +318 -0
  503. package/agentic-flow/docs/supabase/SUPABASE-REALTIME-FEDERATION.md +575 -0
  504. package/agentic-flow/docs/supabase/TEST-REPORT.md +446 -0
  505. package/agentic-flow/docs/supabase/migrations/001_create_federation_tables.sql +339 -0
  506. package/agentic-flow/docs/testing/AGENT-SYSTEM-VALIDATION.md +517 -0
  507. package/agentic-flow/docs/testing/AGENTDB_TESTING.md +411 -0
  508. package/agentic-flow/docs/testing/FINAL-TESTING-SUMMARY.md +362 -0
  509. package/agentic-flow/docs/testing/README.md +46 -0
  510. package/agentic-flow/docs/testing/REGRESSION-TEST-RESULTS.md +269 -0
  511. package/agentic-flow/docs/testing/STREAMING-AND-MCP-VALIDATION.md +517 -0
  512. package/agentic-flow/docs/validation-reports/BENCHMARK_AND_OPTIMIZATION_REPORT.md +470 -0
  513. package/agentic-flow/docs/validation-reports/DOCKER_VALIDATION_RESULTS.md +391 -0
  514. package/agentic-flow/docs/validation-reports/NO_REGRESSIONS_CONFIRMED.md +384 -0
  515. package/agentic-flow/docs/validation-reports/NPM-PACKAGE-ANALYSIS-FINAL.md +543 -0
  516. package/agentic-flow/docs/validation-reports/README.md +43 -0
  517. package/agentic-flow/docs/validation-reports/V2.7.0-ALPHA.10_FINAL_VALIDATION.md +817 -0
  518. package/agentic-flow/docs/validation-reports/V2.7.0-ALPHA.9_VALIDATION.md +546 -0
  519. package/agentic-flow/docs/validation-reports/v1.6.0-QUIC-CLI-VALIDATION.md +558 -0
  520. package/agentic-flow/docs/validation-reports/v1.6.1-NPM-PUBLISH-VALIDATION.md +532 -0
  521. package/agentic-flow/docs/version-releases/PUBLICATION_REPORT_v1.5.11.md +421 -0
  522. package/agentic-flow/docs/version-releases/README.md +82 -0
  523. package/agentic-flow/docs/version-releases/v1.5.9-DOCKER-VERIFICATION.md +263 -0
  524. package/agentic-flow/docs/version-releases/v1.5.9-RELEASE-SUMMARY.md +222 -0
  525. package/agentic-flow/scripts/build.sh +30 -0
  526. package/agentic-flow/scripts/claude +31 -0
  527. package/agentic-flow/scripts/claude-code +56 -0
  528. package/agentic-flow/scripts/claude-flow +81 -0
  529. package/agentic-flow/scripts/claude-flow.bat +18 -0
  530. package/agentic-flow/scripts/claude-flow.ps1 +24 -0
  531. package/agentic-flow/scripts/postinstall.js +139 -0
  532. package/agentic-flow/scripts/run-validation.sh +165 -0
  533. package/agentic-flow/scripts/test-agentdb.sh +153 -0
  534. package/agentic-flow/scripts/test-all-commands.sh +46 -0
  535. package/agentic-flow/scripts/test-claude-flow-sdk.sh +46 -0
  536. package/agentic-flow/scripts/test-fastmcp-docker.sh +132 -0
  537. package/agentic-flow/scripts/test-fastmcp-poc.sh +26 -0
  538. package/agentic-flow/scripts/test-functionality.sh +50 -0
  539. package/agentic-flow/scripts/test-onnx-docker.sh +176 -0
  540. package/agentic-flow/scripts/test-router-docker.sh +105 -0
  541. package/agentic-flow/scripts/validate-mcp-cli-tools.sh +104 -0
  542. package/agentic-flow/scripts/validate-providers.sh +50 -0
  543. package/agentic-flow/wasm/quic/README.md +75 -0
  544. package/agentic-flow/wasm/quic/agentic_flow_quic.js +779 -0
  545. package/agentic-flow/wasm/quic/agentic_flow_quic_bg.wasm +0 -0
  546. package/agentic-flow/wasm/quic/package.json +20 -0
  547. package/agentic-flow/wasm/reasoningbank/package.json +34 -0
  548. package/agentic-flow/wasm/reasoningbank/reasoningbank_wasm.js +5 -0
  549. package/agentic-flow/wasm/reasoningbank/reasoningbank_wasm_bg.js +555 -0
  550. package/agentic-flow/wasm/reasoningbank/reasoningbank_wasm_bg.wasm +0 -0
  551. package/docs/CHANGELOG.md +272 -0
  552. package/docs/LICENSE +21 -0
  553. package/docs/README.md +127 -0
  554. package/package.json +279 -0
  555. package/packages/agentic-jujutsu/.cargo/config.toml +14 -0
  556. package/packages/agentic-jujutsu/BUILD.md +292 -0
  557. package/packages/agentic-jujutsu/CHANGELOG.md +143 -0
  558. package/packages/agentic-jujutsu/CHANGELOG_v2.2.0.md +203 -0
  559. package/packages/agentic-jujutsu/CRATE_README.md +269 -0
  560. package/packages/agentic-jujutsu/Dockerfile +8 -0
  561. package/packages/agentic-jujutsu/Dockerfile.test +81 -0
  562. package/packages/agentic-jujutsu/FUNCTIONALITY_VERIFICATION.md +377 -0
  563. package/packages/agentic-jujutsu/LICENSE +21 -0
  564. package/packages/agentic-jujutsu/NAPI_CI_CD_FILES.txt +162 -0
  565. package/packages/agentic-jujutsu/QUANTUM_INTEGRATION_SUMMARY.txt +67 -0
  566. package/packages/agentic-jujutsu/README.md +2248 -0
  567. package/packages/agentic-jujutsu/README_QUANTUM_INTEGRATION.md +195 -0
  568. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.0.tgz +0 -0
  569. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.1.tgz +0 -0
  570. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.2.tgz +0 -0
  571. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.3.tgz +0 -0
  572. package/packages/agentic-jujutsu/agentic-jujutsu.linux-x64-gnu.node +0 -0
  573. package/packages/agentic-jujutsu/benchmarks/README.md +403 -0
  574. package/packages/agentic-jujutsu/benchmarks/docker/.env.example +24 -0
  575. package/packages/agentic-jujutsu/benchmarks/docker/Dockerfile.git +55 -0
  576. package/packages/agentic-jujutsu/benchmarks/docker/Dockerfile.jujutsu +67 -0
  577. package/packages/agentic-jujutsu/benchmarks/docker/Dockerfile.swarm-coordinator +45 -0
  578. package/packages/agentic-jujutsu/benchmarks/docker/config/prometheus.yml +20 -0
  579. package/packages/agentic-jujutsu/benchmarks/docker/docker-compose.yml +152 -0
  580. package/packages/agentic-jujutsu/benchmarks/docker/scripts/collect-metrics.sh +143 -0
  581. package/packages/agentic-jujutsu/benchmarks/docker/scripts/generate-reports.sh +150 -0
  582. package/packages/agentic-jujutsu/benchmarks/docker/scripts/run-benchmarks.sh +80 -0
  583. package/packages/agentic-jujutsu/benchmarks/docker/scripts/setup-repos.sh +88 -0
  584. package/packages/agentic-jujutsu/bin/cli.js +286 -0
  585. package/packages/agentic-jujutsu/bin/mcp-server.js +20 -0
  586. package/packages/agentic-jujutsu/build.rs +134 -0
  587. package/packages/agentic-jujutsu/check-methods.js +26 -0
  588. package/packages/agentic-jujutsu/helpers/encryption.js +234 -0
  589. package/packages/agentic-jujutsu/index.d.ts +853 -0
  590. package/packages/agentic-jujutsu/index.js +321 -0
  591. package/packages/agentic-jujutsu/package-lock.json +1163 -0
  592. package/packages/agentic-jujutsu/package.json +108 -0
  593. package/packages/agentic-jujutsu/pkg/bundler/LICENSE +21 -0
  594. package/packages/agentic-jujutsu/pkg/bundler/README.md +361 -0
  595. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu.d.ts +554 -0
  596. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu.js +5 -0
  597. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu_bg.js +1821 -0
  598. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu_bg.wasm +0 -0
  599. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu_bg.wasm.d.ts +113 -0
  600. package/packages/agentic-jujutsu/pkg/bundler/package.json +34 -0
  601. package/packages/agentic-jujutsu/pkg/deno/LICENSE +21 -0
  602. package/packages/agentic-jujutsu/pkg/deno/README.md +361 -0
  603. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu.d.ts +554 -0
  604. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu.js +1802 -0
  605. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu_bg.wasm +0 -0
  606. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu_bg.wasm.d.ts +113 -0
  607. package/packages/agentic-jujutsu/pkg/node/LICENSE +21 -0
  608. package/packages/agentic-jujutsu/pkg/node/README.md +361 -0
  609. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu.d.ts +554 -0
  610. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu.js +1830 -0
  611. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu_bg.wasm +0 -0
  612. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu_bg.wasm.d.ts +113 -0
  613. package/packages/agentic-jujutsu/pkg/node/package.json +28 -0
  614. package/packages/agentic-jujutsu/pkg/web/LICENSE +21 -0
  615. package/packages/agentic-jujutsu/pkg/web/README.md +361 -0
  616. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu.d.ts +691 -0
  617. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu.js +1913 -0
  618. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu_bg.wasm +0 -0
  619. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu_bg.wasm.d.ts +113 -0
  620. package/packages/agentic-jujutsu/pkg/web/package.json +32 -0
  621. package/packages/agentic-jujutsu/quantum-bridge.d.ts +115 -0
  622. package/packages/agentic-jujutsu/scripts/agentic-flow-integration.js +178 -0
  623. package/packages/agentic-jujutsu/scripts/analyze-size.sh +23 -0
  624. package/packages/agentic-jujutsu/scripts/coverage.sh +57 -0
  625. package/packages/agentic-jujutsu/scripts/docker-test.sh +56 -0
  626. package/packages/agentic-jujutsu/scripts/final-validation.sh +85 -0
  627. package/packages/agentic-jujutsu/scripts/install-jj.js +197 -0
  628. package/packages/agentic-jujutsu/scripts/mcp-server.js +98 -0
  629. package/packages/agentic-jujutsu/scripts/test-all.sh +68 -0
  630. package/packages/agentic-jujutsu/scripts/verify-build.sh +32 -0
  631. package/packages/agentic-jujutsu/scripts/verify-napi-config.sh +122 -0
  632. package/packages/agentic-jujutsu/scripts/wasm-pack-build.sh +76 -0
  633. package/packages/agentic-jujutsu/test-agentdb-cli.js +119 -0
  634. package/packages/agentic-jujutsu/test-agentdb.js +105 -0
  635. package/packages/agentic-jujutsu/test-failures.js +53 -0
  636. package/packages/agentic-jujutsu/test-napi.js +40 -0
  637. package/packages/agentic-jujutsu/test-quick.js +61 -0
  638. package/packages/agentic-jujutsu/test-repo/test-file.txt +1 -0
  639. package/packages/agentic-jujutsu/typescript/hooks-integration.ts +370 -0
  640. package/packages/agentic-jujutsu/typescript/index.d.ts +415 -0
  641. package/reasoningbank/README.md +217 -0
@@ -0,0 +1,113 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ export const memory: WebAssembly.Memory;
4
+ export const __wbg_jjconfig_free: (a: number, b: number) => void;
5
+ export const __wbg_get_jjconfig_timeout_ms: (a: number) => bigint;
6
+ export const __wbg_set_jjconfig_timeout_ms: (a: number, b: bigint) => void;
7
+ export const __wbg_get_jjconfig_verbose: (a: number) => number;
8
+ export const __wbg_set_jjconfig_verbose: (a: number, b: number) => void;
9
+ export const __wbg_get_jjconfig_max_log_entries: (a: number) => number;
10
+ export const __wbg_set_jjconfig_max_log_entries: (a: number, b: number) => void;
11
+ export const __wbg_get_jjconfig_enable_agentdb_sync: (a: number) => number;
12
+ export const __wbg_set_jjconfig_enable_agentdb_sync: (a: number, b: number) => void;
13
+ export const jjconfig_default_config: () => number;
14
+ export const jjconfig_jj_path: (a: number, b: number) => void;
15
+ export const jjconfig_set_jj_path: (a: number, b: number, c: number) => void;
16
+ export const jjconfig_repo_path: (a: number, b: number) => void;
17
+ export const jjconfig_set_repo_path: (a: number, b: number, c: number) => void;
18
+ export const jjconfig_with_jj_path: (a: number, b: number, c: number) => number;
19
+ export const jjconfig_with_repo_path: (a: number, b: number, c: number) => number;
20
+ export const jjconfig_with_timeout: (a: number, b: bigint) => number;
21
+ export const jjconfig_with_verbose: (a: number, b: number) => number;
22
+ export const jjconfig_with_max_log_entries: (a: number, b: number) => number;
23
+ export const jjconfig_with_agentdb_sync: (a: number, b: number) => number;
24
+ export const __wbg_jjoperation_free: (a: number, b: number) => void;
25
+ export const __wbg_get_jjoperation_duration_ms: (a: number) => bigint;
26
+ export const __wbg_set_jjoperation_duration_ms: (a: number, b: bigint) => void;
27
+ export const __wbg_get_jjoperation_success: (a: number) => number;
28
+ export const __wbg_set_jjoperation_success: (a: number, b: number) => void;
29
+ export const jjoperation_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
30
+ export const jjoperation_id: (a: number, b: number) => void;
31
+ export const jjoperation_operation_id: (a: number, b: number) => void;
32
+ export const jjoperation_command: (a: number, b: number) => void;
33
+ export const jjoperation_user: (a: number, b: number) => void;
34
+ export const jjoperation_hostname: (a: number, b: number) => void;
35
+ export const jjoperation_parent_id: (a: number, b: number) => void;
36
+ export const jjoperation_error: (a: number, b: number) => void;
37
+ export const jjoperation_operation_type_str: (a: number, b: number) => void;
38
+ export const jjoperation_set_operation_type: (a: number, b: number, c: number) => void;
39
+ export const jjoperation_timestamp_iso: (a: number, b: number) => void;
40
+ export const jjoperation_short_id: (a: number, b: number) => void;
41
+ export const jjoperation_is_snapshot: (a: number) => number;
42
+ export const jjoperation_is_user_initiated: (a: number) => number;
43
+ export const jjoperation_modifies_history: (a: number) => number;
44
+ export const jjoperation_is_remote_operation: (a: number) => number;
45
+ export const jjoperation_tags_json: (a: number, b: number) => void;
46
+ export const jjoperation_metadata_json: (a: number, b: number) => void;
47
+ export const jjresult_new: (a: number, b: number, c: number, d: number, e: number, f: bigint) => number;
48
+ export const jjresult_stdout: (a: number, b: number) => void;
49
+ export const jjresult_stderr: (a: number, b: number) => void;
50
+ export const jjresult_success: (a: number) => number;
51
+ export const jjresult_output: (a: number, b: number) => void;
52
+ export const __wbg_jjcommit_free: (a: number, b: number) => void;
53
+ export const __wbg_get_jjcommit_is_merge: (a: number) => number;
54
+ export const __wbg_set_jjcommit_is_merge: (a: number, b: number) => void;
55
+ export const __wbg_get_jjcommit_has_conflicts: (a: number) => number;
56
+ export const __wbg_set_jjcommit_has_conflicts: (a: number, b: number) => void;
57
+ export const __wbg_get_jjcommit_is_empty: (a: number) => number;
58
+ export const __wbg_set_jjcommit_is_empty: (a: number, b: number) => void;
59
+ export const jjcommit_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => number;
60
+ export const jjcommit_id: (a: number, b: number) => void;
61
+ export const jjcommit_change_id: (a: number, b: number) => void;
62
+ export const jjcommit_message: (a: number, b: number) => void;
63
+ export const jjcommit_author: (a: number, b: number) => void;
64
+ export const jjcommit_author_email: (a: number, b: number) => void;
65
+ export const jjcommit_timestamp_iso: (a: number, b: number) => void;
66
+ export const jjcommit_parent_count: (a: number) => number;
67
+ export const jjcommit_short_id: (a: number, b: number) => void;
68
+ export const jjcommit_short_change_id: (a: number, b: number) => void;
69
+ export const jjcommit_parents_json: (a: number, b: number) => void;
70
+ export const jjcommit_branches_json: (a: number, b: number) => void;
71
+ export const __wbg_jjbranch_free: (a: number, b: number) => void;
72
+ export const __wbg_get_jjbranch_is_remote: (a: number) => number;
73
+ export const __wbg_set_jjbranch_is_remote: (a: number, b: number) => void;
74
+ export const __wbg_get_jjbranch_is_tracking: (a: number) => number;
75
+ export const __wbg_set_jjbranch_is_tracking: (a: number, b: number) => void;
76
+ export const __wbg_get_jjbranch_is_current: (a: number) => number;
77
+ export const __wbg_set_jjbranch_is_current: (a: number, b: number) => void;
78
+ export const jjbranch_new: (a: number, b: number, c: number, d: number, e: number) => number;
79
+ export const jjbranch_name: (a: number, b: number) => void;
80
+ export const jjbranch_target: (a: number, b: number) => void;
81
+ export const jjbranch_remote: (a: number, b: number) => void;
82
+ export const jjbranch_set_remote: (a: number, b: number, c: number) => void;
83
+ export const jjbranch_full_name: (a: number, b: number) => void;
84
+ export const jjbranch_short_target: (a: number, b: number) => void;
85
+ export const jjbranch_created_at_iso: (a: number, b: number) => void;
86
+ export const __wbg_jjconflict_free: (a: number, b: number) => void;
87
+ export const __wbg_get_jjconflict_num_conflicts: (a: number) => number;
88
+ export const __wbg_set_jjconflict_num_conflicts: (a: number, b: number) => void;
89
+ export const __wbg_get_jjconflict_is_binary: (a: number) => number;
90
+ export const __wbg_set_jjconflict_is_binary: (a: number, b: number) => void;
91
+ export const __wbg_get_jjconflict_is_resolved: (a: number) => number;
92
+ export const __wbg_set_jjconflict_is_resolved: (a: number, b: number) => void;
93
+ export const jjconflict_new: (a: number, b: number, c: number, d: number, e: number) => number;
94
+ export const jjconflict_id: (a: number, b: number) => void;
95
+ export const jjconflict_path: (a: number, b: number) => void;
96
+ export const jjconflict_conflict_type: (a: number, b: number) => void;
97
+ export const jjconflict_resolution_strategy: (a: number, b: number) => void;
98
+ export const jjconflict_add_side: (a: number, b: number, c: number) => void;
99
+ export const jjconflict_num_sides: (a: number) => number;
100
+ export const jjconflict_sides_json: (a: number, b: number) => void;
101
+ export const wasm_init: () => void;
102
+ export const jjconfig_new: () => number;
103
+ export const __wbg_set_jjresult_exit_code: (a: number, b: number) => void;
104
+ export const __wbg_set_jjresult_execution_time_ms: (a: number, b: bigint) => void;
105
+ export const __wbg_get_jjresult_exit_code: (a: number) => number;
106
+ export const __wbg_get_jjresult_execution_time_ms: (a: number) => bigint;
107
+ export const __wbg_jjresult_free: (a: number, b: number) => void;
108
+ export const __wbindgen_export: (a: number, b: number, c: number) => void;
109
+ export const __wbindgen_export2: (a: number) => void;
110
+ export const __wbindgen_export3: (a: number, b: number) => number;
111
+ export const __wbindgen_export4: (a: number, b: number, c: number, d: number) => number;
112
+ export const __wbindgen_add_to_stack_pointer: (a: number) => number;
113
+ export const __wbindgen_start: () => void;
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Agentic Flow Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,361 @@
1
+ # agentic-jujutsu
2
+
3
+ **AI-powered Jujutsu VCS wrapper for multi-agent collaboration with WASM support**
4
+
5
+ [![crates.io](https://img.shields.io/crates/v/agentic-jujutsu.svg)](https://crates.io/crates/agentic-jujutsu)
6
+ [![Documentation](https://docs.rs/agentic-jujutsu/badge.svg)](https://docs.rs/agentic-jujutsu)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
+
9
+ ## Overview
10
+
11
+ `agentic-jujutsu` provides a Rust/WASM library for AI agents to interact with [Jujutsu VCS](https://github.com/martinvonz/jj), offering **10-100x faster** concurrent operations compared to Git. Perfect for multi-agent systems, autonomous workflows, and collaborative AI applications.
12
+
13
+ ## Features
14
+
15
+ - 🚀 **10-100x Performance** - Lock-free concurrency for parallel agent operations
16
+ - 🧠 **AI-First Design** - Structured conflicts, operation logs, pattern learning
17
+ - 🌐 **Universal Runtime** - Browser (WASM), Node.js, Deno, native Rust
18
+ - 🔌 **MCP Protocol** - Model Context Protocol with stdio/SSE transports
19
+ - 🗄️ **AgentDB Integration** - Persistent memory and pattern recognition
20
+ - 📊 **Operation Tracking** - Complete audit trail with ReasoningBank
21
+ - ✅ **Production Ready** - 70/70 tests passing, security hardened
22
+
23
+ ## Quick Start
24
+
25
+ ### Rust
26
+
27
+ Add to `Cargo.toml`:
28
+
29
+ ```toml
30
+ [dependencies]
31
+ agentic-jujutsu = "0.1"
32
+ ```
33
+
34
+ Basic usage:
35
+
36
+ ```rust
37
+ use agentic_jujutsu::{JJWrapper, JJConfig};
38
+
39
+ #[tokio::main]
40
+ async fn main() -> Result<(), Box<dyn std::error::Error>> {
41
+ let config = JJConfig::default();
42
+ let jj = JJWrapper::with_config(config)?;
43
+
44
+ // Check status
45
+ let status = jj.status().await?;
46
+ println!("{}", status.stdout);
47
+
48
+ // Create commit
49
+ jj.describe("Add new feature").await?;
50
+
51
+ // Check for conflicts
52
+ let conflicts = jj.getConflicts().await?;
53
+ if !conflicts.is_empty() {
54
+ println!("Conflicts detected: {:?}", conflicts);
55
+ }
56
+
57
+ Ok(())
58
+ }
59
+ ```
60
+
61
+ ### WASM (JavaScript/TypeScript)
62
+
63
+ ```javascript
64
+ import { JJWrapper } from '@agentic-flow/jujutsu';
65
+
66
+ const jj = await JJWrapper.new();
67
+ const status = await jj.status();
68
+ console.log(status.stdout);
69
+ ```
70
+
71
+ ## Key Capabilities
72
+
73
+ ### 1. Lock-Free Concurrent Operations
74
+
75
+ ```rust
76
+ // Multiple agents can commit simultaneously - no locks!
77
+ let agent1 = JJWrapper::new()?;
78
+ let agent2 = JJWrapper::new()?;
79
+
80
+ tokio::join!(
81
+ agent1.new_commit("Agent 1: Implement auth"),
82
+ agent2.new_commit("Agent 2: Update schema")
83
+ );
84
+ // Both commits succeed immediately
85
+ ```
86
+
87
+ ### 2. Structured Conflict Resolution
88
+
89
+ ```rust
90
+ let conflicts = jj.getConflicts().await?;
91
+
92
+ for conflict in conflicts {
93
+ println!("File: {}", conflict.path);
94
+ println!("Sides: {} ({})", conflict.left_side, conflict.right_side);
95
+ // AI can parse and resolve automatically
96
+ }
97
+ ```
98
+
99
+ ### 3. Operation Log for Learning
100
+
101
+ ```rust
102
+ use agentic_jujutsu::JJOperationLog;
103
+
104
+ let log = JJOperationLog::new();
105
+
106
+ // Track all operations
107
+ let op = jj.describe("Implement feature").await?;
108
+ log.add_operation(op);
109
+
110
+ // Query history
111
+ let recent = log.get_recent_operations(10);
112
+ let by_user = log.filter_by_user("agent-1");
113
+ ```
114
+
115
+ ### 4. MCP Integration (New!)
116
+
117
+ ```rust
118
+ use agentic_jujutsu::{AgentDBSync, mcp::MCPClientConfig};
119
+
120
+ // Connect to MCP server
121
+ let mcp_config = MCPClientConfig::stdio();
122
+ let agentdb = AgentDBSync::with_mcp(true, mcp_config).await?;
123
+
124
+ // Store operation for learning
125
+ agentdb.store_episode(&episode).await?;
126
+
127
+ // Find similar past operations
128
+ let similar = agentdb.query_similar_operations("implement auth", 5).await?;
129
+ ```
130
+
131
+ ### 5. Hooks for Agentic Flow
132
+
133
+ ```rust
134
+ use agentic_jujutsu::{JJHooksIntegration, HookContext};
135
+
136
+ let ctx = HookContext::new(
137
+ "agent-1".to_string(),
138
+ "session-001".to_string(),
139
+ "Implement feature".to_string()
140
+ );
141
+
142
+ let mut hooks = JJHooksIntegration::new(jj, true);
143
+
144
+ // Pre-task
145
+ hooks.on_pre_task(ctx.clone()).await?;
146
+
147
+ // Post-edit
148
+ hooks.on_post_edit("src/main.rs", ctx.clone()).await?;
149
+
150
+ // Post-task
151
+ let operations = hooks.on_post_task(ctx).await?;
152
+ ```
153
+
154
+ ## Performance
155
+
156
+ Real-world testing on agentic-flow codebase (10 agents, 200 commits):
157
+
158
+ | Metric | Git Baseline | Jujutsu | Improvement |
159
+ |--------|--------------|---------|-------------|
160
+ | **Concurrent commits** | 15 ops/s | 350 ops/s | **23x** |
161
+ | **Context switching** | 500-1000ms | 50-100ms | **5-10x** |
162
+ | **Conflict auto-resolution** | 30-40% | 87% | **2.5x** |
163
+ | **Lock waiting** | 50 min/day | 0 min | **∞** |
164
+ | **Full workflow** | 295 min | 39 min | **7.6x** |
165
+
166
+ ## Feature Flags
167
+
168
+ ```toml
169
+ [dependencies.agentic-jujutsu]
170
+ version = "0.1"
171
+ features = ["mcp-full"] # Include MCP support
172
+
173
+ # Or minimal build
174
+ default-features = false
175
+ features = ["native"] # Native runtime only
176
+ ```
177
+
178
+ Available features:
179
+ - `native` (default) - Native Rust execution
180
+ - `wasm` - WebAssembly support
181
+ - `cli` - CLI tools (jj-agent-hook)
182
+ - `mcp` - MCP protocol support
183
+ - `mcp-full` - MCP + native runtime
184
+
185
+ ## Architecture
186
+
187
+ ```
188
+ ┌─────────────────────────────────────────────────────┐
189
+ │ AI Agent Layer │
190
+ │ (Claude, GPT-4, Local LLMs) │
191
+ └─────────────────┬───────────────────────────────────┘
192
+
193
+ ┌─────────────────▼───────────────────────────────────┐
194
+ │ agentic-jujutsu (This Library) │
195
+ │ • Zero-overhead WASM bindings │
196
+ │ • Structured conflict API │
197
+ │ • Operation log & learning │
198
+ │ • MCP protocol (stdio/SSE) │
199
+ └─────────────────┬───────────────────────────────────┘
200
+
201
+ ┌─────────────────▼───────────────────────────────────┐
202
+ │ Jujutsu VCS (jj) │
203
+ │ • Lock-free operations │
204
+ │ • Multi-workspace support │
205
+ │ • Native Git interop │
206
+ └─────────────────────────────────────────────────────┘
207
+ ```
208
+
209
+ ## Examples
210
+
211
+ ### Multi-Agent Collaboration
212
+
213
+ ```rust
214
+ use agentic_jujutsu::JJWrapper;
215
+
216
+ async fn agent_workflow(agent_id: &str, task: &str) -> Result<(), Box<dyn std::error::Error>> {
217
+ let jj = JJWrapper::new()?;
218
+
219
+ // Create isolated workspace
220
+ jj.new_commit(&format!("[{}] {}", agent_id, task)).await?;
221
+
222
+ // Do work...
223
+ jj.describe(&format!("[{}] Complete: {}", agent_id, task)).await?;
224
+
225
+ Ok(())
226
+ }
227
+
228
+ #[tokio::main]
229
+ async fn main() {
230
+ // Run 10 agents concurrently - no lock contention!
231
+ let handles: Vec<_> = (0..10)
232
+ .map(|i| tokio::spawn(agent_workflow(&format!("agent-{}", i), "implement feature")))
233
+ .collect();
234
+
235
+ for handle in handles {
236
+ handle.await.unwrap().unwrap();
237
+ }
238
+ }
239
+ ```
240
+
241
+ ### Conflict-Aware Agent
242
+
243
+ ```rust
244
+ use agentic_jujutsu::JJWrapper;
245
+
246
+ async fn auto_resolve_conflicts(jj: &JJWrapper) -> Result<(), Box<dyn std::error::Error>> {
247
+ let conflicts = jj.getConflicts().await?;
248
+
249
+ for conflict in conflicts {
250
+ println!("Auto-resolving conflict in: {}", conflict.path);
251
+
252
+ // AI-powered resolution
253
+ let resolution = ai_resolve_conflict(&conflict).await?;
254
+
255
+ // Apply resolution
256
+ std::fs::write(&conflict.path, resolution)?;
257
+ jj.describe(&format!("Auto-resolve conflict in {}", conflict.path)).await?;
258
+ }
259
+
260
+ Ok(())
261
+ }
262
+ ```
263
+
264
+ ### Learning from History
265
+
266
+ ```rust
267
+ use agentic_jujutsu::{AgentDBSync, AgentDBEpisode, JJOperation};
268
+
269
+ async fn learn_from_operations(ops: Vec<JJOperation>) -> Result<(), Box<dyn std::error::Error>> {
270
+ let agentdb = AgentDBSync::new(true);
271
+
272
+ for op in ops {
273
+ let episode = AgentDBEpisode::from_operation(
274
+ &op,
275
+ "session-001".to_string(),
276
+ "agent-1".to_string()
277
+ )
278
+ .with_success(true, 0.95);
279
+
280
+ agentdb.store_episode(&episode).await?;
281
+ }
282
+
283
+ // Query for similar work
284
+ let similar = agentdb.query_similar_operations("implement authentication", 5).await?;
285
+ println!("Found {} similar past operations", similar.len());
286
+
287
+ Ok(())
288
+ }
289
+ ```
290
+
291
+ ## Documentation
292
+
293
+ - [Complete API Documentation](https://docs.rs/agentic-jujutsu)
294
+ - [MCP Implementation Guide](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/docs/MCP_IMPLEMENTATION_COMPLETE.md)
295
+ - [Benchmarks](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/docs/benchmarks/BENCHMARK_EXECUTIVE_SUMMARY.md)
296
+ - [Architecture](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/docs/architecture/ARCHITECTURE.md)
297
+ - [GitHub Repository](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu)
298
+
299
+ ## Why Jujutsu for AI Agents?
300
+
301
+ Traditional Git struggles with concurrent AI agents due to lock contention and text-based conflicts. Jujutsu solves this:
302
+
303
+ - **Lock-Free** — No `.git/index.lock` blocking your agents
304
+ - **23x Faster** — Concurrent commits without waiting
305
+ - **87% Auto-Resolve** — Structured conflict API for AI
306
+ - **True Multi-Workspace** — Isolated environments per agent
307
+ - **Complete Audit Trail** — Every operation permanently logged
308
+ - **Git Compatible** — Works with existing Git repositories
309
+
310
+ ## Hybrid Approach
311
+
312
+ Use Jujutsu locally for speed, Git for ecosystem compatibility:
313
+
314
+ ```bash
315
+ # Initialize with co-located .git/
316
+ jj init --git-repo .
317
+
318
+ # Use jj for local operations (fast!)
319
+ jj new -m "Feature work"
320
+
321
+ # Use git for remote operations (compatible!)
322
+ jj git push
323
+ ```
324
+
325
+ ✅ **10-100x speedup** for agents
326
+ ✅ **Zero migration risk** (Git fallback)
327
+ ✅ **Full GitHub compatibility**
328
+
329
+ ## SEO Keywords
330
+
331
+ AI agents • autonomous agents • multi-agent systems • version control • VCS • Jujutsu • Git alternative • WASM • WebAssembly • concurrent operations • lock-free • Model Context Protocol • MCP • AgentDB • pattern learning • collaborative AI • distributed AI • agentic workflows • AI infrastructure • ruv.io
332
+
333
+ ## Related Projects
334
+
335
+ - **[agentic-flow](https://github.com/ruvnet/agentic-flow)** - Multi-agent orchestration framework
336
+ - **[Agent Booster](https://github.com/ruvnet/agentic-flow/tree/main/agent-booster)** - 352x faster code transformations
337
+ - **[AgentDB](https://github.com/ruvnet/agentic-flow/packages/agentdb)** - Vector database for agent memory
338
+ - **[ruv.io](https://ruv.io)** - AI Agent Infrastructure Platform
339
+
340
+ ## Contributing
341
+
342
+ Contributions are welcome! See [CONTRIBUTING.md](https://github.com/ruvnet/agentic-flow/blob/main/CONTRIBUTING.md) for guidelines.
343
+
344
+ ## License
345
+
346
+ MIT License - see [LICENSE](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/LICENSE) for details.
347
+
348
+ ## Support
349
+
350
+ - **Issues:** [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
351
+ - **Discussions:** [GitHub Discussions](https://github.com/ruvnet/agentic-flow/discussions)
352
+ - **Documentation:** [docs.rs/agentic-jujutsu](https://docs.rs/agentic-jujutsu)
353
+ - **Website:** [ruv.io](https://ruv.io)
354
+
355
+ ---
356
+
357
+ **Made with ❤️ for AI Agents**
358
+
359
+ [Get Started](https://docs.rs/agentic-jujutsu) • [Benchmarks](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu/docs/benchmarks) • [API Docs](https://docs.rs/agentic-jujutsu) • [Examples](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu/examples)
360
+
361
+ 🤖 Part of the [agentic-flow](https://github.com/ruvnet/agentic-flow) ecosystem by [ruv.io](https://ruv.io)