macro-agent 0.1.1 → 0.1.2

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 (406) hide show
  1. package/.sudocode/issues.jsonl +28 -0
  2. package/.sudocode/specs.jsonl +4 -0
  3. package/CLAUDE.md +9 -3
  4. package/dist/agent/agent-manager.d.ts.map +1 -1
  5. package/dist/agent/agent-manager.js +111 -48
  6. package/dist/agent/agent-manager.js.map +1 -1
  7. package/dist/agent/types.d.ts +7 -0
  8. package/dist/agent/types.d.ts.map +1 -1
  9. package/dist/agent/types.js.map +1 -1
  10. package/dist/api/server.d.ts +5 -1
  11. package/dist/api/server.d.ts.map +1 -1
  12. package/dist/api/server.js +100 -3
  13. package/dist/api/server.js.map +1 -1
  14. package/dist/api/types.d.ts +1 -1
  15. package/dist/api/types.d.ts.map +1 -1
  16. package/dist/cli/acp.d.ts.map +1 -1
  17. package/dist/cli/acp.js +71 -1
  18. package/dist/cli/acp.js.map +1 -1
  19. package/dist/cli/index.js +5 -1
  20. package/dist/cli/index.js.map +1 -1
  21. package/dist/cli/mcp.js +27 -8
  22. package/dist/cli/mcp.js.map +1 -1
  23. package/dist/config/project-config.d.ts +13 -2
  24. package/dist/config/project-config.d.ts.map +1 -1
  25. package/dist/config/project-config.js +12 -2
  26. package/dist/config/project-config.js.map +1 -1
  27. package/dist/index.d.ts +1 -0
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +2 -0
  30. package/dist/index.js.map +1 -1
  31. package/dist/lifecycle/handlers/index.d.ts +7 -3
  32. package/dist/lifecycle/handlers/index.d.ts.map +1 -1
  33. package/dist/lifecycle/handlers/index.js +25 -8
  34. package/dist/lifecycle/handlers/index.js.map +1 -1
  35. package/dist/lifecycle/types.d.ts +2 -0
  36. package/dist/lifecycle/types.d.ts.map +1 -1
  37. package/dist/lifecycle/types.js.map +1 -1
  38. package/dist/map/adapter/extensions/index.d.ts +4 -1
  39. package/dist/map/adapter/extensions/index.d.ts.map +1 -1
  40. package/dist/map/adapter/extensions/index.js +27 -0
  41. package/dist/map/adapter/extensions/index.js.map +1 -1
  42. package/dist/map/adapter/extensions/streams.d.ts +95 -0
  43. package/dist/map/adapter/extensions/streams.d.ts.map +1 -0
  44. package/dist/map/adapter/extensions/streams.js +515 -0
  45. package/dist/map/adapter/extensions/streams.js.map +1 -0
  46. package/dist/map/adapter/index.d.ts +1 -1
  47. package/dist/map/adapter/index.d.ts.map +1 -1
  48. package/dist/map/adapter/index.js +3 -1
  49. package/dist/map/adapter/index.js.map +1 -1
  50. package/dist/map/adapter/types.d.ts +1 -1
  51. package/dist/map/adapter/types.d.ts.map +1 -1
  52. package/dist/mcp/mcp-server.d.ts +2 -0
  53. package/dist/mcp/mcp-server.d.ts.map +1 -1
  54. package/dist/mcp/mcp-server.js +12 -3
  55. package/dist/mcp/mcp-server.js.map +1 -1
  56. package/dist/mcp/tools/done.d.ts.map +1 -1
  57. package/dist/mcp/tools/done.js +18 -0
  58. package/dist/mcp/tools/done.js.map +1 -1
  59. package/dist/roles/builtin/coordinator.d.ts.map +1 -1
  60. package/dist/roles/builtin/coordinator.js +2 -1
  61. package/dist/roles/builtin/coordinator.js.map +1 -1
  62. package/dist/roles/builtin/integrator.d.ts.map +1 -1
  63. package/dist/roles/builtin/integrator.js +2 -1
  64. package/dist/roles/builtin/integrator.js.map +1 -1
  65. package/dist/roles/builtin/worker.d.ts.map +1 -1
  66. package/dist/roles/builtin/worker.js +3 -1
  67. package/dist/roles/builtin/worker.js.map +1 -1
  68. package/dist/roles/capabilities.d.ts +6 -0
  69. package/dist/roles/capabilities.d.ts.map +1 -1
  70. package/dist/roles/capabilities.js +10 -0
  71. package/dist/roles/capabilities.js.map +1 -1
  72. package/dist/roles/config-loader.d.ts +1 -1
  73. package/dist/roles/config-loader.d.ts.map +1 -1
  74. package/dist/roles/config-loader.js +3 -2
  75. package/dist/roles/config-loader.js.map +1 -1
  76. package/dist/roles/types.d.ts +3 -1
  77. package/dist/roles/types.d.ts.map +1 -1
  78. package/dist/server/combined-server.d.ts +8 -1
  79. package/dist/server/combined-server.d.ts.map +1 -1
  80. package/dist/server/combined-server.js +6 -2
  81. package/dist/server/combined-server.js.map +1 -1
  82. package/dist/store/event-store.d.ts.map +1 -1
  83. package/dist/store/event-store.js +12 -5
  84. package/dist/store/event-store.js.map +1 -1
  85. package/dist/store/instance.d.ts +1 -1
  86. package/dist/store/instance.d.ts.map +1 -1
  87. package/dist/store/instance.js +2 -2
  88. package/dist/store/instance.js.map +1 -1
  89. package/dist/store/types/agents.d.ts +5 -0
  90. package/dist/store/types/agents.d.ts.map +1 -1
  91. package/dist/task/backend/opentasks/daemon-manager.d.ts.map +1 -1
  92. package/dist/task/backend/opentasks/daemon-manager.js +1 -1
  93. package/dist/task/backend/opentasks/daemon-manager.js.map +1 -1
  94. package/dist/teams/index.d.ts +3 -1
  95. package/dist/teams/index.d.ts.map +1 -1
  96. package/dist/teams/index.js +2 -0
  97. package/dist/teams/index.js.map +1 -1
  98. package/dist/teams/seed-defaults.d.ts +20 -0
  99. package/dist/teams/seed-defaults.d.ts.map +1 -0
  100. package/dist/teams/seed-defaults.js +71 -0
  101. package/dist/teams/seed-defaults.js.map +1 -0
  102. package/dist/teams/team-loader.d.ts +6 -2
  103. package/dist/teams/team-loader.d.ts.map +1 -1
  104. package/dist/teams/team-loader.js +154 -162
  105. package/dist/teams/team-loader.js.map +1 -1
  106. package/dist/teams/team-manager.d.ts +112 -0
  107. package/dist/teams/team-manager.d.ts.map +1 -0
  108. package/dist/teams/team-manager.js +305 -0
  109. package/dist/teams/team-manager.js.map +1 -0
  110. package/dist/teams/team-runtime.d.ts +125 -19
  111. package/dist/teams/team-runtime.d.ts.map +1 -1
  112. package/dist/teams/team-runtime.js +527 -119
  113. package/dist/teams/team-runtime.js.map +1 -1
  114. package/dist/teams/types.d.ts +41 -151
  115. package/dist/teams/types.d.ts.map +1 -1
  116. package/dist/teams/types.js +2 -3
  117. package/dist/teams/types.js.map +1 -1
  118. package/docs/teams.md +73 -0
  119. package/package.json +2 -1
  120. package/references/minimem/.claude/settings.json +7 -0
  121. package/references/minimem/.sudocode/issues.jsonl +18 -0
  122. package/references/minimem/.sudocode/specs.jsonl +1 -0
  123. package/references/minimem/CLAUDE.md +310 -0
  124. package/references/minimem/README.md +562 -0
  125. package/references/minimem/claude-plugin/.claude-plugin/plugin.json +10 -0
  126. package/references/minimem/claude-plugin/.mcp.json +7 -0
  127. package/references/minimem/claude-plugin/README.md +158 -0
  128. package/references/minimem/claude-plugin/commands/recall.md +47 -0
  129. package/references/minimem/claude-plugin/commands/remember.md +41 -0
  130. package/references/minimem/claude-plugin/hooks/__tests__/hooks.test.ts +272 -0
  131. package/references/minimem/claude-plugin/hooks/hooks.json +27 -0
  132. package/references/minimem/claude-plugin/hooks/session-end.sh +86 -0
  133. package/references/minimem/claude-plugin/hooks/session-start.sh +85 -0
  134. package/references/minimem/claude-plugin/skills/memory/SKILL.md +108 -0
  135. package/references/minimem/media/banner.png +0 -0
  136. package/references/minimem/package-lock.json +5373 -0
  137. package/references/minimem/package.json +72 -0
  138. package/references/minimem/scripts/postbuild.js +35 -0
  139. package/references/minimem/src/__tests__/edge-cases.test.ts +371 -0
  140. package/references/minimem/src/__tests__/errors.test.ts +265 -0
  141. package/references/minimem/src/__tests__/helpers.ts +199 -0
  142. package/references/minimem/src/__tests__/internal.test.ts +407 -0
  143. package/references/minimem/src/__tests__/knowledge.test.ts +287 -0
  144. package/references/minimem/src/__tests__/minimem.integration.test.ts +1127 -0
  145. package/references/minimem/src/__tests__/session.test.ts +190 -0
  146. package/references/minimem/src/cli/__tests__/commands.test.ts +759 -0
  147. package/references/minimem/src/cli/commands/__tests__/conflicts.test.ts +141 -0
  148. package/references/minimem/src/cli/commands/append.ts +76 -0
  149. package/references/minimem/src/cli/commands/config.ts +262 -0
  150. package/references/minimem/src/cli/commands/conflicts.ts +413 -0
  151. package/references/minimem/src/cli/commands/daemon.ts +169 -0
  152. package/references/minimem/src/cli/commands/index.ts +12 -0
  153. package/references/minimem/src/cli/commands/init.ts +88 -0
  154. package/references/minimem/src/cli/commands/mcp.ts +177 -0
  155. package/references/minimem/src/cli/commands/push-pull.ts +213 -0
  156. package/references/minimem/src/cli/commands/search.ts +158 -0
  157. package/references/minimem/src/cli/commands/status.ts +84 -0
  158. package/references/minimem/src/cli/commands/sync-init.ts +290 -0
  159. package/references/minimem/src/cli/commands/sync.ts +70 -0
  160. package/references/minimem/src/cli/commands/upsert.ts +197 -0
  161. package/references/minimem/src/cli/config.ts +584 -0
  162. package/references/minimem/src/cli/index.ts +264 -0
  163. package/references/minimem/src/cli/shared.ts +161 -0
  164. package/references/minimem/src/cli/sync/__tests__/central.test.ts +152 -0
  165. package/references/minimem/src/cli/sync/__tests__/conflicts.test.ts +209 -0
  166. package/references/minimem/src/cli/sync/__tests__/daemon.test.ts +118 -0
  167. package/references/minimem/src/cli/sync/__tests__/detection.test.ts +207 -0
  168. package/references/minimem/src/cli/sync/__tests__/integration.test.ts +476 -0
  169. package/references/minimem/src/cli/sync/__tests__/registry.test.ts +363 -0
  170. package/references/minimem/src/cli/sync/__tests__/state.test.ts +255 -0
  171. package/references/minimem/src/cli/sync/__tests__/validation.test.ts +193 -0
  172. package/references/minimem/src/cli/sync/__tests__/watcher.test.ts +178 -0
  173. package/references/minimem/src/cli/sync/central.ts +292 -0
  174. package/references/minimem/src/cli/sync/conflicts.ts +204 -0
  175. package/references/minimem/src/cli/sync/daemon.ts +407 -0
  176. package/references/minimem/src/cli/sync/detection.ts +138 -0
  177. package/references/minimem/src/cli/sync/index.ts +107 -0
  178. package/references/minimem/src/cli/sync/operations.ts +373 -0
  179. package/references/minimem/src/cli/sync/registry.ts +279 -0
  180. package/references/minimem/src/cli/sync/state.ts +355 -0
  181. package/references/minimem/src/cli/sync/validation.ts +206 -0
  182. package/references/minimem/src/cli/sync/watcher.ts +234 -0
  183. package/references/minimem/src/cli/version.ts +34 -0
  184. package/references/minimem/src/core/index.ts +9 -0
  185. package/references/minimem/src/core/indexer.ts +628 -0
  186. package/references/minimem/src/core/searcher.ts +221 -0
  187. package/references/minimem/src/db/schema.ts +183 -0
  188. package/references/minimem/src/db/sqlite-vec.ts +24 -0
  189. package/references/minimem/src/embeddings/__tests__/embeddings.test.ts +431 -0
  190. package/references/minimem/src/embeddings/batch-gemini.ts +392 -0
  191. package/references/minimem/src/embeddings/batch-openai.ts +409 -0
  192. package/references/minimem/src/embeddings/embeddings.ts +434 -0
  193. package/references/minimem/src/index.ts +109 -0
  194. package/references/minimem/src/internal.ts +299 -0
  195. package/references/minimem/src/minimem.ts +1276 -0
  196. package/references/minimem/src/search/__tests__/hybrid.test.ts +247 -0
  197. package/references/minimem/src/search/graph.ts +234 -0
  198. package/references/minimem/src/search/hybrid.ts +151 -0
  199. package/references/minimem/src/search/search.ts +256 -0
  200. package/references/minimem/src/server/__tests__/mcp.test.ts +341 -0
  201. package/references/minimem/src/server/__tests__/tools.test.ts +364 -0
  202. package/references/minimem/src/server/mcp.ts +326 -0
  203. package/references/minimem/src/server/tools.ts +720 -0
  204. package/references/minimem/src/session.ts +460 -0
  205. package/references/minimem/tsconfig.json +19 -0
  206. package/references/minimem/tsup.config.ts +26 -0
  207. package/references/minimem/vitest.config.ts +24 -0
  208. package/references/openteams/.claude/settings.json +6 -0
  209. package/references/openteams/README.md +1 -0
  210. package/references/openteams/SKILL.md +341 -0
  211. package/references/openteams/design.md +411 -0
  212. package/references/openteams/examples/bmad-method/prompts/analyst/ROLE.md +16 -0
  213. package/references/openteams/examples/bmad-method/prompts/analyst/SOUL.md +5 -0
  214. package/references/openteams/examples/bmad-method/prompts/architect/ROLE.md +24 -0
  215. package/references/openteams/examples/bmad-method/prompts/architect/SOUL.md +5 -0
  216. package/references/openteams/examples/bmad-method/prompts/developer/ROLE.md +25 -0
  217. package/references/openteams/examples/bmad-method/prompts/developer/SOUL.md +5 -0
  218. package/references/openteams/examples/bmad-method/prompts/master/ROLE.md +21 -0
  219. package/references/openteams/examples/bmad-method/prompts/master/SOUL.md +5 -0
  220. package/references/openteams/examples/bmad-method/prompts/pm/ROLE.md +20 -0
  221. package/references/openteams/examples/bmad-method/prompts/pm/SOUL.md +5 -0
  222. package/references/openteams/examples/bmad-method/prompts/qa/ROLE.md +17 -0
  223. package/references/openteams/examples/bmad-method/prompts/qa/SOUL.md +5 -0
  224. package/references/openteams/examples/bmad-method/prompts/quick-flow-dev/ROLE.md +23 -0
  225. package/references/openteams/examples/bmad-method/prompts/quick-flow-dev/SOUL.md +5 -0
  226. package/references/openteams/examples/bmad-method/prompts/scrum-master/ROLE.md +27 -0
  227. package/references/openteams/examples/bmad-method/prompts/scrum-master/SOUL.md +5 -0
  228. package/references/openteams/examples/bmad-method/prompts/tech-writer/ROLE.md +21 -0
  229. package/references/openteams/examples/bmad-method/prompts/tech-writer/SOUL.md +5 -0
  230. package/references/openteams/examples/bmad-method/prompts/ux-designer/ROLE.md +16 -0
  231. package/references/openteams/examples/bmad-method/prompts/ux-designer/SOUL.md +5 -0
  232. package/references/openteams/examples/bmad-method/roles/analyst.yaml +9 -0
  233. package/references/openteams/examples/bmad-method/roles/architect.yaml +9 -0
  234. package/references/openteams/examples/bmad-method/roles/developer.yaml +8 -0
  235. package/references/openteams/examples/bmad-method/roles/master.yaml +8 -0
  236. package/references/openteams/examples/bmad-method/roles/pm.yaml +9 -0
  237. package/references/openteams/examples/bmad-method/roles/qa.yaml +8 -0
  238. package/references/openteams/examples/bmad-method/roles/quick-flow-dev.yaml +8 -0
  239. package/references/openteams/examples/bmad-method/roles/scrum-master.yaml +9 -0
  240. package/references/openteams/examples/bmad-method/roles/tech-writer.yaml +8 -0
  241. package/references/openteams/examples/bmad-method/roles/ux-designer.yaml +8 -0
  242. package/references/openteams/examples/bmad-method/team.yaml +161 -0
  243. package/references/openteams/examples/get-shit-done/prompts/codebase-mapper/ROLE.md +17 -0
  244. package/references/openteams/examples/get-shit-done/prompts/codebase-mapper/SOUL.md +5 -0
  245. package/references/openteams/examples/get-shit-done/prompts/debugger/ROLE.md +25 -0
  246. package/references/openteams/examples/get-shit-done/prompts/debugger/SOUL.md +5 -0
  247. package/references/openteams/examples/get-shit-done/prompts/executor/ROLE.md +34 -0
  248. package/references/openteams/examples/get-shit-done/prompts/executor/SOUL.md +5 -0
  249. package/references/openteams/examples/get-shit-done/prompts/integration-checker/ROLE.md +18 -0
  250. package/references/openteams/examples/get-shit-done/prompts/integration-checker/SOUL.md +3 -0
  251. package/references/openteams/examples/get-shit-done/prompts/orchestrator/ROLE.md +42 -0
  252. package/references/openteams/examples/get-shit-done/prompts/orchestrator/SOUL.md +5 -0
  253. package/references/openteams/examples/get-shit-done/prompts/phase-researcher/ROLE.md +15 -0
  254. package/references/openteams/examples/get-shit-done/prompts/phase-researcher/SOUL.md +3 -0
  255. package/references/openteams/examples/get-shit-done/prompts/plan-checker/ROLE.md +17 -0
  256. package/references/openteams/examples/get-shit-done/prompts/plan-checker/SOUL.md +3 -0
  257. package/references/openteams/examples/get-shit-done/prompts/planner/ROLE.md +28 -0
  258. package/references/openteams/examples/get-shit-done/prompts/planner/SOUL.md +5 -0
  259. package/references/openteams/examples/get-shit-done/prompts/project-researcher/ROLE.md +16 -0
  260. package/references/openteams/examples/get-shit-done/prompts/project-researcher/SOUL.md +3 -0
  261. package/references/openteams/examples/get-shit-done/prompts/research-synthesizer/ROLE.md +13 -0
  262. package/references/openteams/examples/get-shit-done/prompts/research-synthesizer/SOUL.md +3 -0
  263. package/references/openteams/examples/get-shit-done/prompts/roadmapper/ROLE.md +14 -0
  264. package/references/openteams/examples/get-shit-done/prompts/roadmapper/SOUL.md +3 -0
  265. package/references/openteams/examples/get-shit-done/prompts/verifier/ROLE.md +19 -0
  266. package/references/openteams/examples/get-shit-done/prompts/verifier/SOUL.md +5 -0
  267. package/references/openteams/examples/get-shit-done/roles/codebase-mapper.yaml +8 -0
  268. package/references/openteams/examples/get-shit-done/roles/debugger.yaml +8 -0
  269. package/references/openteams/examples/get-shit-done/roles/executor.yaml +8 -0
  270. package/references/openteams/examples/get-shit-done/roles/integration-checker.yaml +8 -0
  271. package/references/openteams/examples/get-shit-done/roles/orchestrator.yaml +9 -0
  272. package/references/openteams/examples/get-shit-done/roles/phase-researcher.yaml +7 -0
  273. package/references/openteams/examples/get-shit-done/roles/plan-checker.yaml +8 -0
  274. package/references/openteams/examples/get-shit-done/roles/planner.yaml +8 -0
  275. package/references/openteams/examples/get-shit-done/roles/project-researcher.yaml +8 -0
  276. package/references/openteams/examples/get-shit-done/roles/research-synthesizer.yaml +7 -0
  277. package/references/openteams/examples/get-shit-done/roles/roadmapper.yaml +7 -0
  278. package/references/openteams/examples/get-shit-done/roles/verifier.yaml +8 -0
  279. package/references/openteams/examples/get-shit-done/team.yaml +154 -0
  280. package/references/openteams/package-lock.json +2181 -0
  281. package/references/openteams/package.json +48 -0
  282. package/references/openteams/schema/role.schema.json +125 -0
  283. package/references/openteams/schema/team.schema.json +284 -0
  284. package/references/openteams/src/cli/agent.ts +104 -0
  285. package/references/openteams/src/cli/cli.test.ts +381 -0
  286. package/references/openteams/src/cli/generate.ts +220 -0
  287. package/references/openteams/src/cli/message.ts +241 -0
  288. package/references/openteams/src/cli/task.ts +154 -0
  289. package/references/openteams/src/cli/team.ts +104 -0
  290. package/references/openteams/src/cli/template.ts +207 -0
  291. package/references/openteams/src/cli.ts +45 -0
  292. package/references/openteams/src/db/database.test.ts +185 -0
  293. package/references/openteams/src/db/database.ts +240 -0
  294. package/references/openteams/src/generators/agent-prompt-generator.test.ts +332 -0
  295. package/references/openteams/src/generators/agent-prompt-generator.ts +521 -0
  296. package/references/openteams/src/generators/package-generator.test.ts +129 -0
  297. package/references/openteams/src/generators/package-generator.ts +102 -0
  298. package/references/openteams/src/generators/skill-generator.test.ts +246 -0
  299. package/references/openteams/src/generators/skill-generator.ts +374 -0
  300. package/references/openteams/src/index.ts +104 -0
  301. package/references/openteams/src/services/agent-service.test.ts +158 -0
  302. package/references/openteams/src/services/agent-service.ts +84 -0
  303. package/references/openteams/src/services/communication-service.test.ts +455 -0
  304. package/references/openteams/src/services/communication-service.ts +371 -0
  305. package/references/openteams/src/services/message-service.test.ts +342 -0
  306. package/references/openteams/src/services/message-service.ts +203 -0
  307. package/references/openteams/src/services/task-service.test.ts +434 -0
  308. package/references/openteams/src/services/task-service.ts +239 -0
  309. package/references/openteams/src/services/team-service.test.ts +181 -0
  310. package/references/openteams/src/services/team-service.ts +139 -0
  311. package/references/openteams/src/services/template-service.test.ts +306 -0
  312. package/references/openteams/src/services/template-service.ts +182 -0
  313. package/references/openteams/src/spawner/acp-factory.ts +96 -0
  314. package/references/openteams/src/spawner/interface.ts +31 -0
  315. package/references/openteams/src/spawner/mock.test.ts +93 -0
  316. package/references/openteams/src/spawner/mock.ts +59 -0
  317. package/references/openteams/src/template/loader.test.ts +1319 -0
  318. package/references/openteams/src/template/loader.ts +698 -0
  319. package/references/openteams/src/template/types.ts +200 -0
  320. package/references/openteams/src/types.ts +205 -0
  321. package/references/openteams/tsconfig.json +18 -0
  322. package/references/openteams/vitest.config.ts +9 -0
  323. package/references/skill-tree/.claude/settings.json +6 -0
  324. package/references/skill-tree/.sudocode/issues.jsonl +11 -0
  325. package/references/skill-tree/.sudocode/specs.jsonl +1 -0
  326. package/references/skill-tree/CLAUDE.md +150 -0
  327. package/references/skill-tree/README.md +324 -0
  328. package/references/skill-tree/docs/GAPS_v1.md +221 -0
  329. package/references/skill-tree/docs/INTEGRATION_PLAN.md +467 -0
  330. package/references/skill-tree/docs/TODOS.md +91 -0
  331. package/references/skill-tree/docs/anthropic_skill_guide.md +1364 -0
  332. package/references/skill-tree/docs/design/federated-skill-trees.md +524 -0
  333. package/references/skill-tree/docs/design/multi-agent-sync.md +759 -0
  334. package/references/skill-tree/docs/scraper/BRAINSTORM.md +583 -0
  335. package/references/skill-tree/docs/scraper/POC_PLAN.md +420 -0
  336. package/references/skill-tree/docs/scraper/README.md +170 -0
  337. package/references/skill-tree/examples/basic-usage.ts +190 -0
  338. package/references/skill-tree/package-lock.json +1509 -0
  339. package/references/skill-tree/package.json +66 -0
  340. package/references/skill-tree/scraper/README.md +123 -0
  341. package/references/skill-tree/scraper/docs/DESIGN.md +683 -0
  342. package/references/skill-tree/scraper/docs/PLAN.md +336 -0
  343. package/references/skill-tree/scraper/drizzle.config.ts +10 -0
  344. package/references/skill-tree/scraper/package-lock.json +6329 -0
  345. package/references/skill-tree/scraper/package.json +68 -0
  346. package/references/skill-tree/scraper/test/fixtures/invalid-skill/missing-description.md +7 -0
  347. package/references/skill-tree/scraper/test/fixtures/invalid-skill/missing-name.md +7 -0
  348. package/references/skill-tree/scraper/test/fixtures/minimal-skill/SKILL.md +27 -0
  349. package/references/skill-tree/scraper/test/fixtures/skill-json/SKILL.json +21 -0
  350. package/references/skill-tree/scraper/test/fixtures/skill-with-meta/SKILL.md +54 -0
  351. package/references/skill-tree/scraper/test/fixtures/skill-with-meta/_meta.json +24 -0
  352. package/references/skill-tree/scraper/test/fixtures/valid-skill/SKILL.md +93 -0
  353. package/references/skill-tree/scraper/test/fixtures/valid-skill/_meta.json +22 -0
  354. package/references/skill-tree/scraper/tsup.config.ts +14 -0
  355. package/references/skill-tree/scraper/vitest.config.ts +17 -0
  356. package/references/skill-tree/scripts/convert-to-vitest.ts +166 -0
  357. package/references/skill-tree/skills/skill-writer/SKILL.md +339 -0
  358. package/references/skill-tree/skills/skill-writer/references/examples.md +326 -0
  359. package/references/skill-tree/skills/skill-writer/references/patterns.md +210 -0
  360. package/references/skill-tree/skills/skill-writer/references/quality-checklist.md +123 -0
  361. package/references/skill-tree/test/run-all.ts +106 -0
  362. package/references/skill-tree/test/utils.ts +128 -0
  363. package/references/skill-tree/vitest.config.ts +16 -0
  364. package/src/agent/agent-manager.ts +143 -72
  365. package/src/agent/types.ts +9 -0
  366. package/src/api/__tests__/server.test.ts +203 -4
  367. package/src/api/server.ts +130 -5
  368. package/src/api/types.ts +3 -1
  369. package/src/cli/acp.ts +68 -1
  370. package/src/cli/index.ts +5 -1
  371. package/src/cli/mcp.ts +27 -13
  372. package/src/config/project-config.ts +27 -3
  373. package/src/index.ts +3 -0
  374. package/src/lifecycle/__tests__/handlers.test.ts +53 -0
  375. package/src/lifecycle/handlers/index.ts +25 -8
  376. package/src/lifecycle/types.ts +3 -0
  377. package/src/map/adapter/__tests__/stream-extensions.test.ts +494 -0
  378. package/src/map/adapter/extensions/index.ts +36 -0
  379. package/src/map/adapter/extensions/streams.ts +839 -0
  380. package/src/map/adapter/index.ts +5 -0
  381. package/src/map/adapter/types.ts +8 -1
  382. package/src/mcp/mcp-server.ts +14 -3
  383. package/src/mcp/tools/done.ts +19 -0
  384. package/src/roles/builtin/coordinator.ts +2 -0
  385. package/src/roles/builtin/integrator.ts +2 -0
  386. package/src/roles/builtin/worker.ts +3 -0
  387. package/src/roles/capabilities.ts +11 -0
  388. package/src/roles/config-loader.ts +3 -2
  389. package/src/roles/types.ts +7 -0
  390. package/src/server/combined-server.ts +15 -1
  391. package/src/store/__tests__/event-store-oob.test.ts +109 -0
  392. package/src/store/event-store.ts +13 -3
  393. package/src/store/instance.ts +2 -2
  394. package/src/store/types/agents.ts +5 -0
  395. package/src/task/backend/__tests__/memory-pull-mode.test.ts +153 -0
  396. package/src/task/backend/opentasks/daemon-manager.ts +4 -1
  397. package/src/teams/CLAUDE.md +180 -0
  398. package/src/teams/__tests__/e2e/workspace-isolation.e2e.test.ts +1263 -0
  399. package/src/teams/__tests__/team-manager.test.ts +814 -0
  400. package/src/teams/__tests__/team-system.test.ts +1291 -8
  401. package/src/teams/index.ts +21 -3
  402. package/src/teams/seed-defaults.ts +79 -0
  403. package/src/teams/team-loader.ts +200 -234
  404. package/src/teams/team-manager.ts +387 -0
  405. package/src/teams/team-runtime.ts +590 -121
  406. package/src/teams/types.ts +99 -200
@@ -0,0 +1,68 @@
1
+ {
2
+ "name": "@skill-tree/indexer",
3
+ "version": "0.2.0",
4
+ "description": "AI-powered GitHub skills indexer with hierarchical taxonomy",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "bin": {
9
+ "skillindexer": "./dist/cli.js"
10
+ },
11
+ "scripts": {
12
+ "build": "tsup",
13
+ "dev": "tsup --watch",
14
+ "start": "node dist/cli.js",
15
+ "lint": "tsc --noEmit",
16
+ "test": "vitest run",
17
+ "test:watch": "vitest",
18
+ "test:coverage": "vitest run --coverage",
19
+ "db:generate": "drizzle-kit generate",
20
+ "db:migrate": "tsx src/database/migrate.ts",
21
+ "db:studio": "drizzle-kit studio"
22
+ },
23
+ "keywords": [
24
+ "skills",
25
+ "indexer",
26
+ "ai",
27
+ "taxonomy",
28
+ "github",
29
+ "claude",
30
+ "agents",
31
+ "acp"
32
+ ],
33
+ "author": "",
34
+ "license": "MIT",
35
+ "dependencies": {
36
+ "@anthropic-ai/sdk": "^0.39.0",
37
+ "acp-factory": "^0.1.9",
38
+ "better-sqlite3": "^11.7.0",
39
+ "commander": "^13.1.0",
40
+ "dotenv": "^16.4.7",
41
+ "drizzle-orm": "^0.38.4",
42
+ "gray-matter": "^4.0.3",
43
+ "marked": "^15.0.6",
44
+ "ora": "^8.1.1",
45
+ "pg": "^8.13.1",
46
+ "pgvector": "^0.2.0",
47
+ "picocolors": "^1.1.1",
48
+ "undici": "^7.3.0",
49
+ "uuid": "^11.0.5",
50
+ "zod": "^3.24.1"
51
+ },
52
+ "devDependencies": {
53
+ "@types/better-sqlite3": "^7.6.12",
54
+ "@types/node": "^22.12.0",
55
+ "@types/pg": "^8.11.10",
56
+ "@types/uuid": "^10.0.0",
57
+ "@vitest/coverage-v8": "^2.1.8",
58
+ "drizzle-kit": "^0.30.4",
59
+ "tsup": "^8.3.5",
60
+ "tsx": "^4.19.2",
61
+ "typescript": "^5.7.3",
62
+ "vitest": "^2.1.8",
63
+ "yaml": "^2.8.2"
64
+ },
65
+ "engines": {
66
+ "node": ">=20.0.0"
67
+ }
68
+ }
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: incomplete-skill
3
+ ---
4
+
5
+ # Incomplete Skill
6
+
7
+ This should fail to parse because it lacks a description.
@@ -0,0 +1,7 @@
1
+ ---
2
+ description: This skill is missing the required name field
3
+ ---
4
+
5
+ # Invalid Skill
6
+
7
+ This should fail to parse because it lacks a name.
@@ -0,0 +1,27 @@
1
+ ---
2
+ name: git-commit-helper
3
+ description: Helps write clear and conventional git commit messages.
4
+ ---
5
+
6
+ # Git Commit Helper
7
+
8
+ Write better commit messages following conventional commits format.
9
+
10
+ ## Format
11
+
12
+ ```
13
+ <type>(<scope>): <subject>
14
+
15
+ <body>
16
+
17
+ <footer>
18
+ ```
19
+
20
+ ## Types
21
+
22
+ - `feat`: New feature
23
+ - `fix`: Bug fix
24
+ - `docs`: Documentation
25
+ - `refactor`: Code refactoring
26
+ - `test`: Adding tests
27
+ - `chore`: Maintenance
@@ -0,0 +1,21 @@
1
+ {
2
+ "name": "api-client-generator",
3
+ "description": "Generates TypeScript API clients from OpenAPI/Swagger specifications. Use when you need to create type-safe HTTP clients for REST APIs.",
4
+ "version": "1.5.0",
5
+ "displayName": "API Client Generator",
6
+ "homepage": "https://openapi-generator.tech/",
7
+ "instructions": "Generate TypeScript API clients from OpenAPI specs.\n\n## Usage\n\n1. Provide the OpenAPI spec URL or file path\n2. Specify the output directory\n3. Choose generation options (fetch vs axios, etc.)\n\n## Example\n\n```bash\nnpx openapi-generator-cli generate \\\n -i https://api.example.com/openapi.json \\\n -g typescript-fetch \\\n -o ./src/api\n```",
8
+ "examples": [
9
+ "Generate client from remote spec: openapi-generator generate -i https://petstore.swagger.io/v2/swagger.json -g typescript-axios -o ./api",
10
+ "Generate from local file: openapi-generator generate -i ./openapi.yaml -g typescript-fetch -o ./src/generated"
11
+ ],
12
+ "tags": ["api", "typescript", "openapi", "codegen", "swagger"],
13
+ "requirements": {
14
+ "bins": ["npx", "java"],
15
+ "packages": ["@openapitools/openapi-generator-cli"]
16
+ },
17
+ "metadata": {
18
+ "category": "Development/API",
19
+ "difficulty": "intermediate"
20
+ }
21
+ }
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: docker-compose-helper
3
+ description: Assists with Docker Compose configuration, multi-container setups, and debugging container issues.
4
+ homepage: https://docs.docker.com/compose/
5
+ ---
6
+
7
+ # Docker Compose Helper
8
+
9
+ Manage multi-container Docker applications with ease.
10
+
11
+ ## Common Commands
12
+
13
+ ```bash
14
+ # Start services
15
+ docker-compose up -d
16
+
17
+ # View logs
18
+ docker-compose logs -f service_name
19
+
20
+ # Rebuild and restart
21
+ docker-compose up -d --build
22
+
23
+ # Stop all services
24
+ docker-compose down
25
+
26
+ # Remove volumes too
27
+ docker-compose down -v
28
+ ```
29
+
30
+ ## Example docker-compose.yml
31
+
32
+ ```yaml
33
+ version: '3.8'
34
+
35
+ services:
36
+ web:
37
+ build: .
38
+ ports:
39
+ - "3000:3000"
40
+ environment:
41
+ - DATABASE_URL=postgres://db:5432/app
42
+ depends_on:
43
+ - db
44
+
45
+ db:
46
+ image: postgres:15
47
+ volumes:
48
+ - postgres_data:/var/lib/postgresql/data
49
+ environment:
50
+ - POSTGRES_PASSWORD=secret
51
+
52
+ volumes:
53
+ postgres_data:
54
+ ```
@@ -0,0 +1,24 @@
1
+ {
2
+ "owner": "devops-team",
3
+ "slug": "docker-compose-helper-3",
4
+ "displayName": "Docker Compose Helper",
5
+ "latest": {
6
+ "version": "3.2.1",
7
+ "publishedAt": 1709251200000,
8
+ "commit": "https://github.com/example/skills/commit/latest123"
9
+ },
10
+ "history": [
11
+ {
12
+ "version": "3.2.0",
13
+ "publishedAt": 1708646400000
14
+ },
15
+ {
16
+ "version": "3.1.0",
17
+ "publishedAt": 1706140800000
18
+ },
19
+ {
20
+ "version": "3.0.0",
21
+ "publishedAt": 1703548800000
22
+ }
23
+ ]
24
+ }
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: react-testing-helper
3
+ description: Helps write and debug React component tests using React Testing Library. Use when writing unit tests for React components, debugging test failures, or setting up testing infrastructure.
4
+ homepage: https://testing-library.com/react
5
+ metadata:
6
+ clawdbot.emoji: "🧪"
7
+ clawdbot.requires:
8
+ packages:
9
+ - "@testing-library/react"
10
+ - "@testing-library/jest-dom"
11
+ ---
12
+
13
+ # React Testing Helper
14
+
15
+ A comprehensive skill for writing effective React component tests.
16
+
17
+ ## When to Use
18
+
19
+ - Writing unit tests for React components
20
+ - Debugging failing component tests
21
+ - Setting up React Testing Library
22
+ - Testing user interactions and async behavior
23
+
24
+ ## Quick Reference
25
+
26
+ ```javascript
27
+ import { render, screen, fireEvent, waitFor } from '@testing-library/react';
28
+ import userEvent from '@testing-library/user-event';
29
+
30
+ // Basic render
31
+ render(<MyComponent prop="value" />);
32
+
33
+ // Query elements
34
+ screen.getByRole('button', { name: /submit/i });
35
+ screen.getByText(/welcome/i);
36
+ screen.getByTestId('my-element');
37
+
38
+ // User interactions
39
+ await userEvent.click(button);
40
+ await userEvent.type(input, 'hello');
41
+
42
+ // Async assertions
43
+ await waitFor(() => {
44
+ expect(screen.getByText('loaded')).toBeInTheDocument();
45
+ });
46
+ ```
47
+
48
+ ## Best Practices
49
+
50
+ 1. **Query by accessibility**: Prefer `getByRole`, `getByLabelText` over `getByTestId`
51
+ 2. **Test behavior, not implementation**: Focus on what users see and do
52
+ 3. **Use userEvent over fireEvent**: More realistic user interactions
53
+ 4. **Avoid testing implementation details**: Don't test state or internal methods
54
+
55
+ ## Common Patterns
56
+
57
+ ### Testing Forms
58
+
59
+ ```javascript
60
+ test('submits form with user data', async () => {
61
+ const onSubmit = jest.fn();
62
+ render(<LoginForm onSubmit={onSubmit} />);
63
+
64
+ await userEvent.type(screen.getByLabelText(/email/i), 'test@example.com');
65
+ await userEvent.type(screen.getByLabelText(/password/i), 'password123');
66
+ await userEvent.click(screen.getByRole('button', { name: /submit/i }));
67
+
68
+ expect(onSubmit).toHaveBeenCalledWith({
69
+ email: 'test@example.com',
70
+ password: 'password123'
71
+ });
72
+ });
73
+ ```
74
+
75
+ ### Testing Async Components
76
+
77
+ ```javascript
78
+ test('loads and displays data', async () => {
79
+ render(<DataLoader />);
80
+
81
+ expect(screen.getByText(/loading/i)).toBeInTheDocument();
82
+
83
+ await waitFor(() => {
84
+ expect(screen.getByText(/data loaded/i)).toBeInTheDocument();
85
+ });
86
+ });
87
+ ```
88
+
89
+ ## Troubleshooting
90
+
91
+ - **Element not found**: Use `screen.debug()` to see current DOM
92
+ - **Act warnings**: Wrap state updates in `act()` or use `waitFor`
93
+ - **Stale queries**: Re-query elements after state changes
@@ -0,0 +1,22 @@
1
+ {
2
+ "owner": "community",
3
+ "slug": "react-testing-helper-1",
4
+ "displayName": "React Testing Helper",
5
+ "latest": {
6
+ "version": "2.1.0",
7
+ "publishedAt": 1706140800000,
8
+ "commit": "https://github.com/openclaw/skills/commit/abc123def456"
9
+ },
10
+ "history": [
11
+ {
12
+ "version": "2.0.0",
13
+ "publishedAt": 1703548800000,
14
+ "commit": "https://github.com/openclaw/skills/commit/789ghi"
15
+ },
16
+ {
17
+ "version": "1.0.0",
18
+ "publishedAt": 1700870400000,
19
+ "commit": "https://github.com/openclaw/skills/commit/initial"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,14 @@
1
+ import { defineConfig } from 'tsup';
2
+
3
+ export default defineConfig({
4
+ entry: ['src/index.ts', 'src/cli.ts'],
5
+ format: ['esm'],
6
+ dts: true,
7
+ clean: true,
8
+ sourcemap: true,
9
+ splitting: false,
10
+ treeshake: true,
11
+ minify: false,
12
+ target: 'node20',
13
+ outDir: 'dist',
14
+ });
@@ -0,0 +1,17 @@
1
+ import { defineConfig } from 'vitest/config';
2
+
3
+ export default defineConfig({
4
+ test: {
5
+ globals: true,
6
+ environment: 'node',
7
+ include: ['test/**/*.test.ts'],
8
+ coverage: {
9
+ provider: 'v8',
10
+ reporter: ['text', 'json', 'html'],
11
+ include: ['src/**/*.ts'],
12
+ exclude: ['src/**/*.d.ts', 'src/cli.ts'],
13
+ },
14
+ testTimeout: 30000,
15
+ hookTimeout: 30000,
16
+ },
17
+ });
@@ -0,0 +1,166 @@
1
+ /**
2
+ * Convert test files to vitest by wrapping runTests() in describe/it
3
+ * Preserves internal test structure
4
+ */
5
+
6
+ import * as fs from 'fs/promises';
7
+ import * as path from 'path';
8
+ import { execSync } from 'child_process';
9
+
10
+ const testDir = path.join(process.cwd(), 'test');
11
+
12
+ const filesToConvert = [
13
+ 'adapters.test.ts',
14
+ 'extraction.test.ts',
15
+ 'storage.test.ts',
16
+ 'lineage.test.ts',
17
+ 'skill-bank.test.ts',
18
+ 'matching.test.ts',
19
+ 'batch.test.ts',
20
+ 'composer.test.ts',
21
+ 'merge.test.ts',
22
+ 'hooks.test.ts',
23
+ 'sqlite.test.ts',
24
+ 'metrics.test.ts',
25
+ 'agents.test.ts',
26
+ 'validation.test.ts',
27
+ 'learning.test.ts',
28
+ 'import.test.ts',
29
+ 'sqlite-indexer.test.ts',
30
+ 'config.test.ts',
31
+ 'services-indexer.test.ts',
32
+ 'services-sync.test.ts',
33
+ 'skillbank-events.test.ts',
34
+ 'integration.test.ts',
35
+ 'serving.test.ts',
36
+ 'cli.test.ts',
37
+ 'sync.test.ts',
38
+ // Note: semver.test.ts is converted separately (native vitest format)
39
+ ];
40
+
41
+ function getTestName(filename: string): string {
42
+ return filename
43
+ .replace('.test.ts', '')
44
+ .split('-')
45
+ .map(word => word.charAt(0).toUpperCase() + word.slice(1))
46
+ .join(' ');
47
+ }
48
+
49
+ async function convertFile(filename: string) {
50
+ const filepath = path.join(testDir, filename);
51
+ let content = await fs.readFile(filepath, 'utf-8');
52
+ const testName = getTestName(filename);
53
+
54
+ // Add vitest import at the top
55
+ if (!content.includes("from 'vitest'")) {
56
+ content = `import { describe, it, expect } from 'vitest';\n` + content;
57
+ }
58
+
59
+ // Remove process.exit calls inside runTests (with various patterns)
60
+ // Pattern: process.exit(testCount === passedCount ? 0 : 1);
61
+ content = content.replace(
62
+ /\s*process\.exit\(testCount\s*===\s*passedCount\s*\?\s*0\s*:\s*1\);?/g,
63
+ '\n return testCount === passedCount ? 0 : 1;'
64
+ );
65
+
66
+ // Pattern: process.exit(failed > 0 ? 1 : 0);
67
+ content = content.replace(
68
+ /\s*process\.exit\(failed\s*>\s*0\s*\?\s*1\s*:\s*0\);?/g,
69
+ '\n return failed > 0 ? 1 : 0;'
70
+ );
71
+
72
+ // Pattern: if (failed > 0) { process.exit(1); }
73
+ content = content.replace(
74
+ /\s*if\s*\(failed\s*>\s*0\)\s*\{\s*process\.exit\(1\);\s*\}/g,
75
+ '\n return failed > 0 ? 1 : 0;'
76
+ );
77
+
78
+ // Pattern 1: runTests().then(failed => process.exit(failed));
79
+ content = content.replace(
80
+ /runTests\(\)\.then\(failed\s*=>\s*process\.exit\(failed\)\);?/,
81
+ `describe('${testName}', () => {
82
+ it('passes all tests', { timeout: 60000 }, async () => {
83
+ const failed = await runTests();
84
+ expect(failed).toBe(0);
85
+ });
86
+ });`
87
+ );
88
+
89
+ // Pattern 2: runTests().then((failed) => process.exit(failed));
90
+ content = content.replace(
91
+ /runTests\(\)\.then\(\(failed\)\s*=>\s*process\.exit\(failed\)\);?/,
92
+ `describe('${testName}', () => {
93
+ it('passes all tests', { timeout: 60000 }, async () => {
94
+ const failed = await runTests();
95
+ expect(failed).toBe(0);
96
+ });
97
+ });`
98
+ );
99
+
100
+ // Pattern 3: runTests().catch(...) - multiline
101
+ content = content.replace(
102
+ /runTests\(\)\.catch\([\s\S]*?\}\);?/,
103
+ `describe('${testName}', () => {
104
+ it('passes all tests', { timeout: 60000 }, async () => {
105
+ const result = await runTests();
106
+ if (typeof result === 'number') {
107
+ expect(result).toBe(0);
108
+ }
109
+ });
110
+ });`
111
+ );
112
+
113
+ // Pattern 3b: runTests().catch(console.error);
114
+ content = content.replace(
115
+ /runTests\(\)\.catch\(console\.error\);?/,
116
+ `describe('${testName}', () => {
117
+ it('passes all tests', { timeout: 60000 }, async () => {
118
+ const result = await runTests();
119
+ if (typeof result === 'number') {
120
+ expect(result).toBe(0);
121
+ }
122
+ });
123
+ });`
124
+ );
125
+
126
+ // Pattern 4: runTests();
127
+ content = content.replace(
128
+ /^runTests\(\);$/m,
129
+ `describe('${testName}', () => {
130
+ it('passes all tests', { timeout: 60000 }, async () => {
131
+ const result = await runTests();
132
+ if (typeof result === 'number') {
133
+ expect(result).toBe(0);
134
+ }
135
+ });
136
+ });`
137
+ );
138
+
139
+ // Clean up any duplicate vitest imports
140
+ const imports = content.match(/import \{ describe, it, expect \} from 'vitest';\n/g);
141
+ if (imports && imports.length > 1) {
142
+ content = content.replace(/import \{ describe, it, expect \} from 'vitest';\n/g, '');
143
+ content = `import { describe, it, expect } from 'vitest';\n` + content;
144
+ }
145
+
146
+ await fs.writeFile(filepath, content, 'utf-8');
147
+ console.log(`Converted: ${filename}`);
148
+ }
149
+
150
+ async function main() {
151
+ console.log('Converting test files to vitest format...\n');
152
+
153
+ for (const file of filesToConvert) {
154
+ try {
155
+ // Reset from git first
156
+ execSync(`git checkout test/${file}`, { stdio: 'pipe' });
157
+ await convertFile(file);
158
+ } catch (error) {
159
+ console.error(`Error converting ${file}:`, error);
160
+ }
161
+ }
162
+
163
+ console.log('\nDone!');
164
+ }
165
+
166
+ main();