swarm-engine 1.0.0

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 (431) hide show
  1. package/AGENTS.md +72 -0
  2. package/CLAUDE.md +89 -0
  3. package/LICENSE +21 -0
  4. package/README.md +235 -0
  5. package/agents/accessibility-reviewer.md +118 -0
  6. package/agents/api-contract-reviewer.md +99 -0
  7. package/agents/concurrency-reviewer.md +111 -0
  8. package/agents/data-integrity-reviewer.md +103 -0
  9. package/agents/debugger.md +99 -0
  10. package/agents/dependency-reviewer.md +115 -0
  11. package/agents/devils-advocate.md +94 -0
  12. package/agents/documentation-reviewer.md +114 -0
  13. package/agents/documenter.md +78 -0
  14. package/agents/error-handling-reviewer.md +113 -0
  15. package/agents/grounding.md +99 -0
  16. package/agents/guardian.md +87 -0
  17. package/agents/implementer.md +141 -0
  18. package/agents/integrator.md +95 -0
  19. package/agents/judge.md +79 -0
  20. package/agents/librarian.md +90 -0
  21. package/agents/orchestrator.md +331 -0
  22. package/agents/performance-reviewer.md +93 -0
  23. package/agents/planner.md +106 -0
  24. package/agents/refactorer.md +92 -0
  25. package/agents/researcher.md +97 -0
  26. package/agents/reviewer.md +117 -0
  27. package/agents/security-reviewer.md +107 -0
  28. package/agents/sentinel.md +92 -0
  29. package/agents/tester.md +93 -0
  30. package/agents/testing-reviewer.md +112 -0
  31. package/commands/diff-review.md +64 -0
  32. package/commands/fix-pr.md +78 -0
  33. package/commands/red-team.md +82 -0
  34. package/commands/research.md +59 -0
  35. package/commands/resume.md +80 -0
  36. package/commands/review-cycle.md +123 -0
  37. package/commands/swarm-setup.md +28 -0
  38. package/commands/swarm.md +126 -0
  39. package/commands/tdd.md +91 -0
  40. package/dist/cli/bin.d.ts +3 -0
  41. package/dist/cli/bin.d.ts.map +1 -0
  42. package/dist/cli/bin.js +3 -0
  43. package/dist/cli/bin.js.map +1 -0
  44. package/dist/cli/commands/acp.d.ts +3 -0
  45. package/dist/cli/commands/acp.d.ts.map +1 -0
  46. package/dist/cli/commands/acp.js +29 -0
  47. package/dist/cli/commands/acp.js.map +1 -0
  48. package/dist/cli/commands/agents.d.ts +3 -0
  49. package/dist/cli/commands/agents.d.ts.map +1 -0
  50. package/dist/cli/commands/agents.js +344 -0
  51. package/dist/cli/commands/agents.js.map +1 -0
  52. package/dist/cli/commands/backends.d.ts +3 -0
  53. package/dist/cli/commands/backends.d.ts.map +1 -0
  54. package/dist/cli/commands/backends.js +22 -0
  55. package/dist/cli/commands/backends.js.map +1 -0
  56. package/dist/cli/commands/completions.d.ts +3 -0
  57. package/dist/cli/commands/completions.d.ts.map +1 -0
  58. package/dist/cli/commands/completions.js +85 -0
  59. package/dist/cli/commands/completions.js.map +1 -0
  60. package/dist/cli/commands/compound.d.ts +3 -0
  61. package/dist/cli/commands/compound.d.ts.map +1 -0
  62. package/dist/cli/commands/compound.js +119 -0
  63. package/dist/cli/commands/compound.js.map +1 -0
  64. package/dist/cli/commands/configure.d.ts +3 -0
  65. package/dist/cli/commands/configure.d.ts.map +1 -0
  66. package/dist/cli/commands/configure.js +151 -0
  67. package/dist/cli/commands/configure.js.map +1 -0
  68. package/dist/cli/commands/convert.d.ts +15 -0
  69. package/dist/cli/commands/convert.d.ts.map +1 -0
  70. package/dist/cli/commands/convert.js +218 -0
  71. package/dist/cli/commands/convert.js.map +1 -0
  72. package/dist/cli/commands/doctor.d.ts +3 -0
  73. package/dist/cli/commands/doctor.d.ts.map +1 -0
  74. package/dist/cli/commands/doctor.js +96 -0
  75. package/dist/cli/commands/doctor.js.map +1 -0
  76. package/dist/cli/commands/init.d.ts +3 -0
  77. package/dist/cli/commands/init.d.ts.map +1 -0
  78. package/dist/cli/commands/init.js +154 -0
  79. package/dist/cli/commands/init.js.map +1 -0
  80. package/dist/cli/commands/learn.d.ts +3 -0
  81. package/dist/cli/commands/learn.d.ts.map +1 -0
  82. package/dist/cli/commands/learn.js +163 -0
  83. package/dist/cli/commands/learn.js.map +1 -0
  84. package/dist/cli/commands/mcp.d.ts +3 -0
  85. package/dist/cli/commands/mcp.d.ts.map +1 -0
  86. package/dist/cli/commands/mcp.js +89 -0
  87. package/dist/cli/commands/mcp.js.map +1 -0
  88. package/dist/cli/commands/memory.d.ts +3 -0
  89. package/dist/cli/commands/memory.d.ts.map +1 -0
  90. package/dist/cli/commands/memory.js +134 -0
  91. package/dist/cli/commands/memory.js.map +1 -0
  92. package/dist/cli/commands/orchestrate.d.ts +3 -0
  93. package/dist/cli/commands/orchestrate.d.ts.map +1 -0
  94. package/dist/cli/commands/orchestrate.js +237 -0
  95. package/dist/cli/commands/orchestrate.js.map +1 -0
  96. package/dist/cli/commands/patterns.d.ts +3 -0
  97. package/dist/cli/commands/patterns.d.ts.map +1 -0
  98. package/dist/cli/commands/patterns.js +25 -0
  99. package/dist/cli/commands/patterns.js.map +1 -0
  100. package/dist/cli/commands/plan.d.ts +3 -0
  101. package/dist/cli/commands/plan.d.ts.map +1 -0
  102. package/dist/cli/commands/plan.js +77 -0
  103. package/dist/cli/commands/plan.js.map +1 -0
  104. package/dist/cli/commands/plugin.d.ts +3 -0
  105. package/dist/cli/commands/plugin.d.ts.map +1 -0
  106. package/dist/cli/commands/plugin.js +124 -0
  107. package/dist/cli/commands/plugin.js.map +1 -0
  108. package/dist/cli/commands/resume.d.ts +3 -0
  109. package/dist/cli/commands/resume.d.ts.map +1 -0
  110. package/dist/cli/commands/resume.js +55 -0
  111. package/dist/cli/commands/resume.js.map +1 -0
  112. package/dist/cli/commands/run.d.ts +3 -0
  113. package/dist/cli/commands/run.d.ts.map +1 -0
  114. package/dist/cli/commands/run.js +78 -0
  115. package/dist/cli/commands/run.js.map +1 -0
  116. package/dist/cli/commands/share.d.ts +3 -0
  117. package/dist/cli/commands/share.d.ts.map +1 -0
  118. package/dist/cli/commands/share.js +34 -0
  119. package/dist/cli/commands/share.js.map +1 -0
  120. package/dist/cli/commands/status.d.ts +3 -0
  121. package/dist/cli/commands/status.d.ts.map +1 -0
  122. package/dist/cli/commands/status.js +148 -0
  123. package/dist/cli/commands/status.js.map +1 -0
  124. package/dist/cli/commands/template.d.ts +3 -0
  125. package/dist/cli/commands/template.d.ts.map +1 -0
  126. package/dist/cli/commands/template.js +213 -0
  127. package/dist/cli/commands/template.js.map +1 -0
  128. package/dist/cli/commands/vault.d.ts +3 -0
  129. package/dist/cli/commands/vault.d.ts.map +1 -0
  130. package/dist/cli/commands/vault.js +402 -0
  131. package/dist/cli/commands/vault.js.map +1 -0
  132. package/dist/cli/commands/verify.d.ts +3 -0
  133. package/dist/cli/commands/verify.d.ts.map +1 -0
  134. package/dist/cli/commands/verify.js +38 -0
  135. package/dist/cli/commands/verify.js.map +1 -0
  136. package/dist/cli/commands/version.d.ts +3 -0
  137. package/dist/cli/commands/version.d.ts.map +1 -0
  138. package/dist/cli/commands/version.js +19 -0
  139. package/dist/cli/commands/version.js.map +1 -0
  140. package/dist/cli/commands/watch.d.ts +3 -0
  141. package/dist/cli/commands/watch.d.ts.map +1 -0
  142. package/dist/cli/commands/watch.js +179 -0
  143. package/dist/cli/commands/watch.js.map +1 -0
  144. package/dist/cli/index.d.ts +3 -0
  145. package/dist/cli/index.d.ts.map +1 -0
  146. package/dist/cli/index.js +118 -0
  147. package/dist/cli/index.js.map +1 -0
  148. package/dist/core/checkpoint.d.ts +35 -0
  149. package/dist/core/checkpoint.d.ts.map +1 -0
  150. package/dist/core/checkpoint.js +80 -0
  151. package/dist/core/checkpoint.js.map +1 -0
  152. package/dist/core/event-bus.d.ts +41 -0
  153. package/dist/core/event-bus.d.ts.map +1 -0
  154. package/dist/core/event-bus.js +115 -0
  155. package/dist/core/event-bus.js.map +1 -0
  156. package/dist/core/lifecycle.d.ts +30 -0
  157. package/dist/core/lifecycle.d.ts.map +1 -0
  158. package/dist/core/lifecycle.js +72 -0
  159. package/dist/core/lifecycle.js.map +1 -0
  160. package/dist/core/patterns.d.ts +43 -0
  161. package/dist/core/patterns.d.ts.map +1 -0
  162. package/dist/core/patterns.js +372 -0
  163. package/dist/core/patterns.js.map +1 -0
  164. package/dist/core/permissions.d.ts +40 -0
  165. package/dist/core/permissions.d.ts.map +1 -0
  166. package/dist/core/permissions.js +113 -0
  167. package/dist/core/permissions.js.map +1 -0
  168. package/dist/core/registry.d.ts +80 -0
  169. package/dist/core/registry.d.ts.map +1 -0
  170. package/dist/core/registry.js +308 -0
  171. package/dist/core/registry.js.map +1 -0
  172. package/dist/core/snapshots.d.ts +20 -0
  173. package/dist/core/snapshots.d.ts.map +1 -0
  174. package/dist/core/snapshots.js +73 -0
  175. package/dist/core/snapshots.js.map +1 -0
  176. package/dist/core/types.d.ts +168 -0
  177. package/dist/core/types.d.ts.map +1 -0
  178. package/dist/core/types.js +33 -0
  179. package/dist/core/types.js.map +1 -0
  180. package/dist/hooks/cli.d.ts +11 -0
  181. package/dist/hooks/cli.d.ts.map +1 -0
  182. package/dist/hooks/cli.js +32 -0
  183. package/dist/hooks/cli.js.map +1 -0
  184. package/dist/hooks/index.d.ts +23 -0
  185. package/dist/hooks/index.d.ts.map +1 -0
  186. package/dist/hooks/index.js +58 -0
  187. package/dist/hooks/index.js.map +1 -0
  188. package/dist/index.d.ts +82 -0
  189. package/dist/index.d.ts.map +1 -0
  190. package/dist/index.js +49 -0
  191. package/dist/index.js.map +1 -0
  192. package/dist/memory/index.d.ts +105 -0
  193. package/dist/memory/index.d.ts.map +1 -0
  194. package/dist/memory/index.js +298 -0
  195. package/dist/memory/index.js.map +1 -0
  196. package/dist/memory/schema.d.ts +6 -0
  197. package/dist/memory/schema.d.ts.map +1 -0
  198. package/dist/memory/schema.js +71 -0
  199. package/dist/memory/schema.js.map +1 -0
  200. package/dist/plugin/index.d.ts +6 -0
  201. package/dist/plugin/index.d.ts.map +1 -0
  202. package/dist/plugin/index.js +182 -0
  203. package/dist/plugin/index.js.map +1 -0
  204. package/dist/runtime/acp.d.ts +41 -0
  205. package/dist/runtime/acp.d.ts.map +1 -0
  206. package/dist/runtime/acp.js +137 -0
  207. package/dist/runtime/acp.js.map +1 -0
  208. package/dist/runtime/adaptive.d.ts +34 -0
  209. package/dist/runtime/adaptive.d.ts.map +1 -0
  210. package/dist/runtime/adaptive.js +229 -0
  211. package/dist/runtime/adaptive.js.map +1 -0
  212. package/dist/runtime/autonomy.d.ts +21 -0
  213. package/dist/runtime/autonomy.d.ts.map +1 -0
  214. package/dist/runtime/autonomy.js +74 -0
  215. package/dist/runtime/autonomy.js.map +1 -0
  216. package/dist/runtime/backends/claude.d.ts +9 -0
  217. package/dist/runtime/backends/claude.d.ts.map +1 -0
  218. package/dist/runtime/backends/claude.js +134 -0
  219. package/dist/runtime/backends/claude.js.map +1 -0
  220. package/dist/runtime/backends/codex.d.ts +9 -0
  221. package/dist/runtime/backends/codex.d.ts.map +1 -0
  222. package/dist/runtime/backends/codex.js +132 -0
  223. package/dist/runtime/backends/codex.js.map +1 -0
  224. package/dist/runtime/backends/gemini.d.ts +9 -0
  225. package/dist/runtime/backends/gemini.d.ts.map +1 -0
  226. package/dist/runtime/backends/gemini.js +103 -0
  227. package/dist/runtime/backends/gemini.js.map +1 -0
  228. package/dist/runtime/backends/index.d.ts +17 -0
  229. package/dist/runtime/backends/index.d.ts.map +1 -0
  230. package/dist/runtime/backends/index.js +39 -0
  231. package/dist/runtime/backends/index.js.map +1 -0
  232. package/dist/runtime/backends/mock.d.ts +21 -0
  233. package/dist/runtime/backends/mock.d.ts.map +1 -0
  234. package/dist/runtime/backends/mock.js +46 -0
  235. package/dist/runtime/backends/mock.js.map +1 -0
  236. package/dist/runtime/backends/types.d.ts +34 -0
  237. package/dist/runtime/backends/types.d.ts.map +1 -0
  238. package/dist/runtime/backends/types.js +2 -0
  239. package/dist/runtime/backends/types.js.map +1 -0
  240. package/dist/runtime/backends/vercel-ai.d.ts +14 -0
  241. package/dist/runtime/backends/vercel-ai.d.ts.map +1 -0
  242. package/dist/runtime/backends/vercel-ai.js +137 -0
  243. package/dist/runtime/backends/vercel-ai.js.map +1 -0
  244. package/dist/runtime/cache-optimizer.d.ts +37 -0
  245. package/dist/runtime/cache-optimizer.d.ts.map +1 -0
  246. package/dist/runtime/cache-optimizer.js +54 -0
  247. package/dist/runtime/cache-optimizer.js.map +1 -0
  248. package/dist/runtime/cascade.d.ts +26 -0
  249. package/dist/runtime/cascade.d.ts.map +1 -0
  250. package/dist/runtime/cascade.js +54 -0
  251. package/dist/runtime/cascade.js.map +1 -0
  252. package/dist/runtime/chunker.d.ts +36 -0
  253. package/dist/runtime/chunker.d.ts.map +1 -0
  254. package/dist/runtime/chunker.js +210 -0
  255. package/dist/runtime/chunker.js.map +1 -0
  256. package/dist/runtime/compaction.d.ts +22 -0
  257. package/dist/runtime/compaction.d.ts.map +1 -0
  258. package/dist/runtime/compaction.js +36 -0
  259. package/dist/runtime/compaction.js.map +1 -0
  260. package/dist/runtime/compounder.d.ts +66 -0
  261. package/dist/runtime/compounder.d.ts.map +1 -0
  262. package/dist/runtime/compounder.js +276 -0
  263. package/dist/runtime/compounder.js.map +1 -0
  264. package/dist/runtime/cost-model.d.ts +24 -0
  265. package/dist/runtime/cost-model.d.ts.map +1 -0
  266. package/dist/runtime/cost-model.js +120 -0
  267. package/dist/runtime/cost-model.js.map +1 -0
  268. package/dist/runtime/distiller.d.ts +21 -0
  269. package/dist/runtime/distiller.d.ts.map +1 -0
  270. package/dist/runtime/distiller.js +70 -0
  271. package/dist/runtime/distiller.js.map +1 -0
  272. package/dist/runtime/engine.d.ts +123 -0
  273. package/dist/runtime/engine.d.ts.map +1 -0
  274. package/dist/runtime/engine.js +969 -0
  275. package/dist/runtime/engine.js.map +1 -0
  276. package/dist/runtime/executor.d.ts +71 -0
  277. package/dist/runtime/executor.d.ts.map +1 -0
  278. package/dist/runtime/executor.js +283 -0
  279. package/dist/runtime/executor.js.map +1 -0
  280. package/dist/runtime/heuristics.d.ts +33 -0
  281. package/dist/runtime/heuristics.d.ts.map +1 -0
  282. package/dist/runtime/heuristics.js +188 -0
  283. package/dist/runtime/heuristics.js.map +1 -0
  284. package/dist/runtime/living-spec.d.ts +34 -0
  285. package/dist/runtime/living-spec.d.ts.map +1 -0
  286. package/dist/runtime/living-spec.js +91 -0
  287. package/dist/runtime/living-spec.js.map +1 -0
  288. package/dist/runtime/lsp.d.ts +50 -0
  289. package/dist/runtime/lsp.d.ts.map +1 -0
  290. package/dist/runtime/lsp.js +110 -0
  291. package/dist/runtime/lsp.js.map +1 -0
  292. package/dist/runtime/mcp.d.ts +27 -0
  293. package/dist/runtime/mcp.d.ts.map +1 -0
  294. package/dist/runtime/mcp.js +154 -0
  295. package/dist/runtime/mcp.js.map +1 -0
  296. package/dist/runtime/model-router.d.ts +22 -0
  297. package/dist/runtime/model-router.d.ts.map +1 -0
  298. package/dist/runtime/model-router.js +94 -0
  299. package/dist/runtime/model-router.js.map +1 -0
  300. package/dist/runtime/panes.d.ts +76 -0
  301. package/dist/runtime/panes.d.ts.map +1 -0
  302. package/dist/runtime/panes.js +279 -0
  303. package/dist/runtime/panes.js.map +1 -0
  304. package/dist/runtime/plan-search.d.ts +41 -0
  305. package/dist/runtime/plan-search.d.ts.map +1 -0
  306. package/dist/runtime/plan-search.js +140 -0
  307. package/dist/runtime/plan-search.js.map +1 -0
  308. package/dist/runtime/plugins.d.ts +59 -0
  309. package/dist/runtime/plugins.d.ts.map +1 -0
  310. package/dist/runtime/plugins.js +121 -0
  311. package/dist/runtime/plugins.js.map +1 -0
  312. package/dist/runtime/reflexion.d.ts +22 -0
  313. package/dist/runtime/reflexion.d.ts.map +1 -0
  314. package/dist/runtime/reflexion.js +85 -0
  315. package/dist/runtime/reflexion.js.map +1 -0
  316. package/dist/runtime/review-schema.d.ts +75 -0
  317. package/dist/runtime/review-schema.d.ts.map +1 -0
  318. package/dist/runtime/review-schema.js +223 -0
  319. package/dist/runtime/review-schema.js.map +1 -0
  320. package/dist/runtime/rewriter.d.ts +8 -0
  321. package/dist/runtime/rewriter.d.ts.map +1 -0
  322. package/dist/runtime/rewriter.js +81 -0
  323. package/dist/runtime/rewriter.js.map +1 -0
  324. package/dist/runtime/sharing.d.ts +15 -0
  325. package/dist/runtime/sharing.d.ts.map +1 -0
  326. package/dist/runtime/sharing.js +48 -0
  327. package/dist/runtime/sharing.js.map +1 -0
  328. package/dist/runtime/stats.d.ts +53 -0
  329. package/dist/runtime/stats.d.ts.map +1 -0
  330. package/dist/runtime/stats.js +160 -0
  331. package/dist/runtime/stats.js.map +1 -0
  332. package/dist/runtime/templates.d.ts +77 -0
  333. package/dist/runtime/templates.d.ts.map +1 -0
  334. package/dist/runtime/templates.js +221 -0
  335. package/dist/runtime/templates.js.map +1 -0
  336. package/dist/runtime/traces.d.ts +60 -0
  337. package/dist/runtime/traces.d.ts.map +1 -0
  338. package/dist/runtime/traces.js +166 -0
  339. package/dist/runtime/traces.js.map +1 -0
  340. package/dist/runtime/verifier.d.ts +54 -0
  341. package/dist/runtime/verifier.d.ts.map +1 -0
  342. package/dist/runtime/verifier.js +172 -0
  343. package/dist/runtime/verifier.js.map +1 -0
  344. package/dist/runtime/worktree.d.ts +24 -0
  345. package/dist/runtime/worktree.d.ts.map +1 -0
  346. package/dist/runtime/worktree.js +82 -0
  347. package/dist/runtime/worktree.js.map +1 -0
  348. package/dist/tui/dashboard.d.ts +65 -0
  349. package/dist/tui/dashboard.d.ts.map +1 -0
  350. package/dist/tui/dashboard.js +496 -0
  351. package/dist/tui/dashboard.js.map +1 -0
  352. package/dist/tui/progress.d.ts +32 -0
  353. package/dist/tui/progress.d.ts.map +1 -0
  354. package/dist/tui/progress.js +257 -0
  355. package/dist/tui/progress.js.map +1 -0
  356. package/dist/tui/renderer.d.ts +72 -0
  357. package/dist/tui/renderer.d.ts.map +1 -0
  358. package/dist/tui/renderer.js +205 -0
  359. package/dist/tui/renderer.js.map +1 -0
  360. package/dist/utils/compact-format.d.ts +35 -0
  361. package/dist/utils/compact-format.d.ts.map +1 -0
  362. package/dist/utils/compact-format.js +106 -0
  363. package/dist/utils/compact-format.js.map +1 -0
  364. package/dist/utils/config.d.ts +73 -0
  365. package/dist/utils/config.d.ts.map +1 -0
  366. package/dist/utils/config.js +70 -0
  367. package/dist/utils/config.js.map +1 -0
  368. package/dist/utils/env.d.ts +6 -0
  369. package/dist/utils/env.d.ts.map +1 -0
  370. package/dist/utils/env.js +28 -0
  371. package/dist/utils/env.js.map +1 -0
  372. package/dist/utils/errors.d.ts +14 -0
  373. package/dist/utils/errors.d.ts.map +1 -0
  374. package/dist/utils/errors.js +120 -0
  375. package/dist/utils/errors.js.map +1 -0
  376. package/dist/utils/logger.d.ts +14 -0
  377. package/dist/utils/logger.d.ts.map +1 -0
  378. package/dist/utils/logger.js +56 -0
  379. package/dist/utils/logger.js.map +1 -0
  380. package/dist/utils/output.d.ts +10 -0
  381. package/dist/utils/output.d.ts.map +1 -0
  382. package/dist/utils/output.js +26 -0
  383. package/dist/utils/output.js.map +1 -0
  384. package/dist/utils/paths.d.ts +7 -0
  385. package/dist/utils/paths.d.ts.map +1 -0
  386. package/dist/utils/paths.js +16 -0
  387. package/dist/utils/paths.js.map +1 -0
  388. package/dist/utils/project-config.d.ts +18 -0
  389. package/dist/utils/project-config.d.ts.map +1 -0
  390. package/dist/utils/project-config.js +46 -0
  391. package/dist/utils/project-config.js.map +1 -0
  392. package/dist/utils/redact.d.ts +5 -0
  393. package/dist/utils/redact.d.ts.map +1 -0
  394. package/dist/utils/redact.js +25 -0
  395. package/dist/utils/redact.js.map +1 -0
  396. package/dist/utils/schemas.d.ts +109 -0
  397. package/dist/utils/schemas.d.ts.map +1 -0
  398. package/dist/utils/schemas.js +63 -0
  399. package/dist/utils/schemas.js.map +1 -0
  400. package/dist/utils/terminal.d.ts +33 -0
  401. package/dist/utils/terminal.d.ts.map +1 -0
  402. package/dist/utils/terminal.js +82 -0
  403. package/dist/utils/terminal.js.map +1 -0
  404. package/dist/utils/tokens.d.ts +9 -0
  405. package/dist/utils/tokens.d.ts.map +1 -0
  406. package/dist/utils/tokens.js +11 -0
  407. package/dist/utils/tokens.js.map +1 -0
  408. package/package.json +71 -0
  409. package/skills/design-system/SKILL.md +195 -0
  410. package/skills/orchestration-patterns/SKILL.md +81 -0
  411. package/skills/orchestration-patterns/examples/example-workflows.md +290 -0
  412. package/skills/orchestration-patterns/references/adversarial.md +51 -0
  413. package/skills/orchestration-patterns/references/batch.md +63 -0
  414. package/skills/orchestration-patterns/references/chaos.md +43 -0
  415. package/skills/orchestration-patterns/references/competitive.md +84 -0
  416. package/skills/orchestration-patterns/references/debate.md +44 -0
  417. package/skills/orchestration-patterns/references/emergence.md +50 -0
  418. package/skills/orchestration-patterns/references/fan-out-fan-in.md +74 -0
  419. package/skills/orchestration-patterns/references/iterative.md +99 -0
  420. package/skills/orchestration-patterns/references/pipeline.md +72 -0
  421. package/skills/swarm-output-style/SKILL.md +85 -0
  422. package/templates/add-endpoint.yml +44 -0
  423. package/templates/add-feature.yml +30 -0
  424. package/templates/agent-template.md +73 -0
  425. package/templates/bug-fix.yml +31 -0
  426. package/templates/explore.yml +21 -0
  427. package/templates/fix-pr.yml +30 -0
  428. package/templates/migration.yml +36 -0
  429. package/templates/refactor.yml +35 -0
  430. package/templates/security-audit.yml +27 -0
  431. package/templates/workflow-template.md +63 -0
@@ -0,0 +1,257 @@
1
+ import { COLORS } from './renderer.js';
2
+ const { reset, bold, dim, green, yellow, red, cyan, blue, magenta } = COLORS;
3
+ // Spinner frames
4
+ const SPINNER = ['\u280B', '\u2819', '\u2839', '\u2838', '\u283C', '\u2834', '\u2826', '\u2827', '\u2807', '\u280F'];
5
+ export class ProgressRenderer {
6
+ bus;
7
+ phases = [];
8
+ orchestrationName = '';
9
+ pattern = '';
10
+ totalTokens = 0;
11
+ totalCost = 0;
12
+ startedAt = 0;
13
+ estimatedDurationMs = 0;
14
+ spinnerFrame = 0;
15
+ spinnerInterval = null;
16
+ lastLineCount = 0;
17
+ active = false;
18
+ constructor(bus) {
19
+ this.bus = bus;
20
+ }
21
+ start(name, pattern, phaseCount, estimatedDurationMs) {
22
+ this.orchestrationName = name;
23
+ this.pattern = pattern;
24
+ this.startedAt = Date.now();
25
+ this.estimatedDurationMs = estimatedDurationMs ?? 0;
26
+ this.active = true;
27
+ this.subscribe();
28
+ // Start spinner animation
29
+ this.spinnerInterval = setInterval(() => {
30
+ this.spinnerFrame = (this.spinnerFrame + 1) % SPINNER.length;
31
+ if (this.active)
32
+ this.render();
33
+ }, 120);
34
+ // Print header (stays in scrollback)
35
+ console.log(`\n${cyan}${bold}\u26A1 Swarm Engine${reset} ${dim}\u2014 ${pattern} pattern${reset}\n`);
36
+ }
37
+ stop() {
38
+ this.active = false;
39
+ if (this.spinnerInterval) {
40
+ clearInterval(this.spinnerInterval);
41
+ this.spinnerInterval = null;
42
+ }
43
+ // Clear the live section one final time
44
+ this.clearLiveSection();
45
+ }
46
+ /** Print the completion summary box */
47
+ printSummary(status, usage, gitDiff) {
48
+ const elapsed = formatMs(usage.durationMs);
49
+ const tokens = formatNum(usage.totalTokens);
50
+ const cost = `$${usage.costUsd.toFixed(4)}`;
51
+ const agents = this.phases.reduce((n, p) => n + p.agents.length, 0);
52
+ const icon = status === 'completed' ? `${green}\u2713${reset}` : `${red}\u2717${reset}`;
53
+ const statusText = status === 'completed' ? `${green}${bold}Orchestration complete${reset}` : `${red}${bold}Orchestration ${status}${reset}`;
54
+ const lines = [];
55
+ lines.push('');
56
+ lines.push(` ${dim}\u250C${'\u2500'.repeat(53)}\u2510${reset}`);
57
+ lines.push(` ${dim}\u2502${reset} ${icon} ${statusText}${' '.repeat(Math.max(0, 35 - stripAnsi(statusText).length))}${dim}\u2502${reset}`);
58
+ lines.push(` ${dim}\u2502${reset}${' '.repeat(53)}${dim}\u2502${reset}`);
59
+ lines.push(` ${dim}\u2502${reset} Pattern: ${bold}${this.pattern}${reset} (${this.phases.length} phases, ${agents} agents)${' '.repeat(Math.max(0, 20 - String(agents).length - this.pattern.length))}${dim}\u2502${reset}`);
60
+ lines.push(` ${dim}\u2502${reset} Duration: ${bold}${elapsed}${reset}${' '.repeat(Math.max(0, 42 - elapsed.length))}${dim}\u2502${reset}`);
61
+ lines.push(` ${dim}\u2502${reset} Tokens: ${bold}${tokens}${reset}${' '.repeat(Math.max(0, 42 - tokens.length))}${dim}\u2502${reset}`);
62
+ lines.push(` ${dim}\u2502${reset} Cost: ${bold}${cost}${reset}${' '.repeat(Math.max(0, 42 - cost.length))}${dim}\u2502${reset}`);
63
+ if (gitDiff) {
64
+ lines.push(` ${dim}\u2502${reset}${' '.repeat(53)}${dim}\u2502${reset}`);
65
+ lines.push(` ${dim}\u2502${reset} ${dim}Changes:${reset}${' '.repeat(45)}${dim}\u2502${reset}`);
66
+ const diffLines = gitDiff.split('\n').filter(Boolean).slice(0, 6);
67
+ for (const line of diffLines) {
68
+ const trimmed = line.trim().slice(0, 49);
69
+ lines.push(` ${dim}\u2502${reset} ${dim}${trimmed}${reset}${' '.repeat(Math.max(0, 49 - trimmed.length))}${dim}\u2502${reset}`);
70
+ }
71
+ }
72
+ lines.push(` ${dim}\u2514${'\u2500'.repeat(53)}\u2518${reset}`);
73
+ // Terminal bell
74
+ lines.push('\x07');
75
+ console.log(lines.join('\n'));
76
+ }
77
+ // ─── Event Subscriptions ──────────────────────────────────
78
+ subscribe() {
79
+ this.bus.on('orchestration:phase-start', (event) => {
80
+ const data = event.data;
81
+ const name = String(data.phase ?? '');
82
+ const agentCount = Number(data.agentCount ?? 0);
83
+ // Find or create phase
84
+ let phase = this.phases.find(p => p.name === name);
85
+ if (!phase) {
86
+ phase = { name, status: 'running', agents: [], startedAt: Date.now() };
87
+ this.phases.push(phase);
88
+ }
89
+ else {
90
+ phase.status = 'running';
91
+ phase.startedAt = Date.now();
92
+ }
93
+ });
94
+ this.bus.on('orchestration:phase-complete', (event) => {
95
+ const data = event.data;
96
+ const name = String(data.phase ?? '');
97
+ const phase = this.phases.find(p => p.name === name);
98
+ if (phase) {
99
+ phase.status = String(data.status ?? 'completed') === 'failed' ? 'failed' : 'completed';
100
+ phase.completedAt = Date.now();
101
+ }
102
+ });
103
+ this.bus.on('agent:running', (event) => {
104
+ const data = event.data;
105
+ const runningPhase = this.phases.find(p => p.status === 'running');
106
+ if (runningPhase) {
107
+ const existing = runningPhase.agents.find(a => a.id === String(data.agentId));
108
+ if (existing) {
109
+ existing.status = 'running';
110
+ existing.startedAt = Date.now();
111
+ }
112
+ else {
113
+ runningPhase.agents.push({
114
+ id: String(data.agentId ?? ''),
115
+ name: String(data.agentType ?? ''),
116
+ type: String(data.agentType ?? ''),
117
+ model: '',
118
+ backend: String(data.backend ?? ''),
119
+ status: 'running',
120
+ tokens: 0,
121
+ detail: String(data.task ?? '').slice(0, 40),
122
+ startedAt: Date.now(),
123
+ });
124
+ }
125
+ }
126
+ });
127
+ this.bus.on('agent:idle', (event) => {
128
+ const data = event.data;
129
+ const usage = data.usage;
130
+ const tokens = usage?.totalTokens ?? 0;
131
+ this.totalTokens += tokens;
132
+ this.totalCost += usage?.costUsd ?? this.estimateCost(tokens, '');
133
+ // Find the agent across all phases
134
+ for (const phase of this.phases) {
135
+ const agent = phase.agents.find(a => a.id === String(data.agentId));
136
+ if (agent) {
137
+ agent.status = 'done';
138
+ agent.tokens = tokens;
139
+ agent.completedAt = Date.now();
140
+ break;
141
+ }
142
+ }
143
+ });
144
+ this.bus.on('agent:error', (event) => {
145
+ const data = event.data;
146
+ for (const phase of this.phases) {
147
+ const agent = phase.agents.find(a => a.id === String(data.agentId));
148
+ if (agent) {
149
+ agent.status = 'error';
150
+ agent.detail = String(data.error ?? '').slice(0, 40);
151
+ agent.completedAt = Date.now();
152
+ break;
153
+ }
154
+ }
155
+ });
156
+ }
157
+ // ─── Rendering ────────────────────────────────────────────
158
+ render() {
159
+ const lines = [];
160
+ for (const phase of this.phases) {
161
+ // Phase header with progress bar
162
+ const progress = this.phaseProgress(phase);
163
+ const elapsed = phase.startedAt ? formatMs(Date.now() - phase.startedAt) : '';
164
+ const bar = this.progressBar(progress, 20);
165
+ const statusColor = phase.status === 'completed' ? green : phase.status === 'failed' ? red : phase.status === 'running' ? yellow : dim;
166
+ const statusText = phase.status === 'completed' ? 'done' : phase.status === 'failed' ? 'FAIL' : phase.status === 'running' ? elapsed : 'pending';
167
+ lines.push(` ${statusColor}Phase: ${phase.name}${reset} ${bar} ${dim}${statusText}${reset}`);
168
+ // Agents
169
+ for (const agent of phase.agents) {
170
+ const icon = agent.status === 'done' ? `${green}\u2713${reset}`
171
+ : agent.status === 'error' ? `${red}\u2717${reset}`
172
+ : agent.status === 'timeout' ? `${red}\u23F1${reset}`
173
+ : agent.status === 'running' ? `${yellow}${SPINNER[this.spinnerFrame]}${reset}`
174
+ : `${dim}\u25CB${reset}`;
175
+ const tokenStr = agent.tokens > 0 ? `${dim}${formatNum(agent.tokens)} tok${reset}` : '';
176
+ const backendStr = agent.backend ? `${dim}${agent.backend}${reset}` : '';
177
+ const agentElapsed = agent.startedAt && agent.status === 'running'
178
+ ? `${dim}${formatMs(Date.now() - agent.startedAt)}${reset}`
179
+ : agent.startedAt && agent.completedAt
180
+ ? `${dim}${formatMs(agent.completedAt - agent.startedAt)}${reset}`
181
+ : '';
182
+ lines.push(` ${icon} ${agent.name.padEnd(24)} ${backendStr.padEnd(16)} ${tokenStr.padEnd(14)} ${agentElapsed}`);
183
+ }
184
+ // Show waiting agents for pending phases
185
+ if (phase.status === 'pending' && phase.agents.length === 0) {
186
+ lines.push(` ${dim}\u25CB waiting${reset}`);
187
+ }
188
+ lines.push('');
189
+ }
190
+ // Footer: running totals
191
+ const elapsed = formatMs(Date.now() - this.startedAt);
192
+ const remaining = this.estimatedDurationMs > 0
193
+ ? `~${formatMs(Math.max(0, this.estimatedDurationMs - (Date.now() - this.startedAt)))} remaining`
194
+ : '';
195
+ lines.push(` ${cyan}${formatNum(this.totalTokens)} tokens${reset} ${dim}|${reset} ${cyan}$${this.totalCost.toFixed(4)}${reset} ${dim}|${reset} ${elapsed} ${dim}${remaining}${reset}`);
196
+ // Write: clear previous lines, write new ones
197
+ this.clearLiveSection();
198
+ const output = lines.join('\n');
199
+ process.stdout.write(output + '\n');
200
+ this.lastLineCount = lines.length;
201
+ }
202
+ clearLiveSection() {
203
+ if (this.lastLineCount > 0) {
204
+ // Move cursor up and clear each line
205
+ process.stdout.write(`\x1b[${this.lastLineCount}A`);
206
+ for (let i = 0; i < this.lastLineCount; i++) {
207
+ process.stdout.write('\x1b[2K\n');
208
+ }
209
+ process.stdout.write(`\x1b[${this.lastLineCount}A`);
210
+ }
211
+ }
212
+ progressBar(progress, width) {
213
+ const filled = Math.round(progress * width);
214
+ const empty = width - filled;
215
+ const bar = '\u2501'.repeat(filled) + '\u2500'.repeat(empty);
216
+ const color = progress >= 1 ? green : progress > 0 ? yellow : dim;
217
+ return `${color}${bar}${reset}`;
218
+ }
219
+ phaseProgress(phase) {
220
+ if (phase.status === 'completed')
221
+ return 1;
222
+ if (phase.status === 'pending')
223
+ return 0;
224
+ const total = phase.agents.length;
225
+ if (total === 0)
226
+ return 0;
227
+ const done = phase.agents.filter(a => a.status === 'done' || a.status === 'error' || a.status === 'timeout').length;
228
+ return done / total;
229
+ }
230
+ estimateCost(tokens, model) {
231
+ // Rough estimate: assume sonnet pricing as default
232
+ const inputPrice = 3.0 / 1_000_000;
233
+ const outputPrice = 15.0 / 1_000_000;
234
+ return tokens * 0.6 * inputPrice + tokens * 0.4 * outputPrice;
235
+ }
236
+ }
237
+ // ─── Utilities ──────────────────────────────────────────────
238
+ function formatMs(ms) {
239
+ if (ms < 1000)
240
+ return `${ms}ms`;
241
+ if (ms < 60000)
242
+ return `${(ms / 1000).toFixed(1)}s`;
243
+ const m = Math.floor(ms / 60000);
244
+ const s = Math.floor((ms % 60000) / 1000);
245
+ return `${m}m ${s}s`;
246
+ }
247
+ function formatNum(n) {
248
+ if (n >= 1000000)
249
+ return `${(n / 1000000).toFixed(1)}M`;
250
+ if (n >= 1000)
251
+ return `${(n / 1000).toFixed(1)}K`;
252
+ return String(n);
253
+ }
254
+ function stripAnsi(str) {
255
+ return str.replace(/\x1b\[[0-9;]*m/g, '');
256
+ }
257
+ //# sourceMappingURL=progress.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/tui/progress.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Low-level terminal rendering utilities.
3
+ *
4
+ * Zero dependencies — raw ANSI escape codes and Node built-ins only.
5
+ * Provides alternate screen buffer, cursor control, color helpers,
6
+ * Unicode box drawing, progress bars, and terminal size detection.
7
+ */
8
+ export declare const COLORS: {
9
+ reset: string;
10
+ bold: string;
11
+ dim: string;
12
+ white: string;
13
+ gray: string;
14
+ green: string;
15
+ yellow: string;
16
+ red: string;
17
+ blue: string;
18
+ magenta: string;
19
+ cyan: string;
20
+ bgBlack: string;
21
+ bgGray: string;
22
+ bgDarkBlue: string;
23
+ bgDarkGreen: string;
24
+ bgDarkYellow: string;
25
+ bgDarkRed: string;
26
+ bgDarkPurple: string;
27
+ };
28
+ /** Enter the alternate screen buffer (preserves scrollback). */
29
+ export declare function enterAltScreen(): void;
30
+ /** Exit the alternate screen buffer (restores previous content). */
31
+ export declare function exitAltScreen(): void;
32
+ /** Hide the terminal cursor. */
33
+ export declare function hideCursor(): void;
34
+ /** Show the terminal cursor. */
35
+ export declare function showCursor(): void;
36
+ /** Move cursor to a specific row and column (1-based). */
37
+ export declare function moveTo(row: number, col: number): void;
38
+ /** Clear the entire screen. */
39
+ export declare function clearScreen(): void;
40
+ /** Get the current terminal dimensions. */
41
+ export declare function getTermSize(): {
42
+ rows: number;
43
+ cols: number;
44
+ };
45
+ /** Strip ANSI escape codes from a string to get its visible length. */
46
+ export declare function stripAnsi(text: string): string;
47
+ /** Get the visible length of a string (ignoring ANSI codes). */
48
+ export declare function visibleLength(text: string): number;
49
+ /** Truncate text to a max visible length, adding ellipsis if needed. */
50
+ export declare function truncate(text: string, maxLen: number): string;
51
+ /** Pad a string to a fixed visible width. */
52
+ export declare function padRight(text: string, width: number): string;
53
+ /** Write text at a specific position with optional color. */
54
+ export declare function drawText(row: number, col: number, text: string, color?: string): void;
55
+ /**
56
+ * Draw a Unicode box at the given position.
57
+ * Optional title is rendered in the top border.
58
+ * Optional rightTitle is rendered right-aligned in the top border.
59
+ */
60
+ export declare function drawBox(row: number, col: number, width: number, height: number, title?: string, rightTitle?: string): void;
61
+ /** Draw a horizontal separator line within a box (├─...─┤). */
62
+ export declare function drawSeparator(row: number, col: number, width: number): void;
63
+ /**
64
+ * Draw a progress bar at the given position.
65
+ * @param progress - Value between 0 and 1
66
+ */
67
+ export declare function drawProgressBar(row: number, col: number, width: number, progress: number, color: string): void;
68
+ /** Format a number with comma separators. */
69
+ export declare function formatNumber(n: number): string;
70
+ /** Format elapsed milliseconds as human-readable duration. */
71
+ export declare function formatElapsed(ms: number): string;
72
+ //# sourceMappingURL=renderer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/tui/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;CAqBlB,CAAC;AAIF,gEAAgE;AAChE,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAID,gCAAgC;AAChC,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,gCAAgC;AAChC,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAID,2CAA2C;AAC3C,wBAAgB,WAAW,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAK5D;AAID,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AAID,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAOrF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAuDN;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,IAAI,CAeN;AAID,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAWhD"}
@@ -0,0 +1,205 @@
1
+ /**
2
+ * Low-level terminal rendering utilities.
3
+ *
4
+ * Zero dependencies — raw ANSI escape codes and Node built-ins only.
5
+ * Provides alternate screen buffer, cursor control, color helpers,
6
+ * Unicode box drawing, progress bars, and terminal size detection.
7
+ */
8
+ // ─── Color Constants ────────────────────────────────────────────────
9
+ export const COLORS = {
10
+ reset: '\x1b[0m',
11
+ bold: '\x1b[1m',
12
+ dim: '\x1b[2m',
13
+ // Foreground
14
+ white: '\x1b[97m',
15
+ gray: '\x1b[90m',
16
+ green: '\x1b[32m',
17
+ yellow: '\x1b[33m',
18
+ red: '\x1b[31m',
19
+ blue: '\x1b[34m',
20
+ magenta: '\x1b[35m',
21
+ cyan: '\x1b[36m',
22
+ // Background
23
+ bgBlack: '\x1b[40m',
24
+ bgGray: '\x1b[48;5;236m',
25
+ bgDarkBlue: '\x1b[48;5;17m',
26
+ bgDarkGreen: '\x1b[48;5;22m',
27
+ bgDarkYellow: '\x1b[48;5;58m',
28
+ bgDarkRed: '\x1b[48;5;52m',
29
+ bgDarkPurple: '\x1b[48;5;53m',
30
+ };
31
+ // ─── Screen Buffer ──────────────────────────────────────────────────
32
+ /** Enter the alternate screen buffer (preserves scrollback). */
33
+ export function enterAltScreen() {
34
+ process.stdout.write('\x1b[?1049h');
35
+ }
36
+ /** Exit the alternate screen buffer (restores previous content). */
37
+ export function exitAltScreen() {
38
+ process.stdout.write('\x1b[?1049l');
39
+ }
40
+ // ─── Cursor Control ─────────────────────────────────────────────────
41
+ /** Hide the terminal cursor. */
42
+ export function hideCursor() {
43
+ process.stdout.write('\x1b[?25l');
44
+ }
45
+ /** Show the terminal cursor. */
46
+ export function showCursor() {
47
+ process.stdout.write('\x1b[?25h');
48
+ }
49
+ /** Move cursor to a specific row and column (1-based). */
50
+ export function moveTo(row, col) {
51
+ process.stdout.write(`\x1b[${row};${col}H`);
52
+ }
53
+ /** Clear the entire screen. */
54
+ export function clearScreen() {
55
+ process.stdout.write('\x1b[2J');
56
+ }
57
+ // ─── Terminal Size ──────────────────────────────────────────────────
58
+ /** Get the current terminal dimensions. */
59
+ export function getTermSize() {
60
+ return {
61
+ rows: process.stdout.rows || 24,
62
+ cols: process.stdout.columns || 80,
63
+ };
64
+ }
65
+ // ─── Text Utilities ─────────────────────────────────────────────────
66
+ /** Strip ANSI escape codes from a string to get its visible length. */
67
+ export function stripAnsi(text) {
68
+ // eslint-disable-next-line no-control-regex
69
+ return text.replace(/\x1b\[[0-9;]*m/g, '');
70
+ }
71
+ /** Get the visible length of a string (ignoring ANSI codes). */
72
+ export function visibleLength(text) {
73
+ return stripAnsi(text).length;
74
+ }
75
+ /** Truncate text to a max visible length, adding ellipsis if needed. */
76
+ export function truncate(text, maxLen) {
77
+ if (maxLen <= 0)
78
+ return '';
79
+ const stripped = stripAnsi(text);
80
+ if (stripped.length <= maxLen)
81
+ return text;
82
+ if (maxLen <= 3)
83
+ return stripped.slice(0, maxLen);
84
+ return stripped.slice(0, maxLen - 1) + '\u2026';
85
+ }
86
+ /** Pad a string to a fixed visible width. */
87
+ export function padRight(text, width) {
88
+ const visible = visibleLength(text);
89
+ if (visible >= width)
90
+ return text;
91
+ return text + ' '.repeat(width - visible);
92
+ }
93
+ // ─── Drawing ────────────────────────────────────────────────────────
94
+ /** Write text at a specific position with optional color. */
95
+ export function drawText(row, col, text, color) {
96
+ moveTo(row, col);
97
+ if (color) {
98
+ process.stdout.write(`${color}${text}${COLORS.reset}`);
99
+ }
100
+ else {
101
+ process.stdout.write(text);
102
+ }
103
+ }
104
+ /**
105
+ * Draw a Unicode box at the given position.
106
+ * Optional title is rendered in the top border.
107
+ * Optional rightTitle is rendered right-aligned in the top border.
108
+ */
109
+ export function drawBox(row, col, width, height, title, rightTitle) {
110
+ const borderColor = COLORS.dim + COLORS.gray;
111
+ // Top border
112
+ let top = '\u250c'; // ┌
113
+ const innerWidth = width - 2;
114
+ if (title || rightTitle) {
115
+ const leftText = title ? ` ${stripAnsi(title)} ` : '';
116
+ const rightText = rightTitle ? ` ${stripAnsi(rightTitle)} ` : '';
117
+ const fillLen = innerWidth - leftText.length - rightText.length;
118
+ const fill = fillLen > 0 ? '\u2500'.repeat(fillLen) : '';
119
+ moveTo(row, col);
120
+ process.stdout.write(borderColor + '\u250c' + COLORS.reset);
121
+ if (title) {
122
+ process.stdout.write(borderColor + '\u2500 ' + COLORS.reset);
123
+ process.stdout.write(`${COLORS.bold}${COLORS.white}${stripAnsi(title)}${COLORS.reset}`);
124
+ process.stdout.write(borderColor + ' ' + COLORS.reset);
125
+ const leftUsed = leftText.length;
126
+ const remainingFill = innerWidth - leftUsed - rightText.length;
127
+ if (rightTitle) {
128
+ process.stdout.write(borderColor + '\u2500'.repeat(Math.max(0, remainingFill)) + COLORS.reset);
129
+ process.stdout.write(borderColor + ' ' + COLORS.reset);
130
+ process.stdout.write(`${COLORS.dim}${COLORS.cyan}${stripAnsi(rightTitle)}${COLORS.reset}`);
131
+ process.stdout.write(borderColor + ' ' + COLORS.reset);
132
+ }
133
+ else {
134
+ process.stdout.write(borderColor + '\u2500'.repeat(Math.max(0, remainingFill)) + COLORS.reset);
135
+ }
136
+ }
137
+ else if (rightTitle) {
138
+ const fillBeforeRight = innerWidth - rightText.length;
139
+ process.stdout.write(borderColor + '\u2500'.repeat(Math.max(0, fillBeforeRight)) + COLORS.reset);
140
+ process.stdout.write(borderColor + ' ' + COLORS.reset);
141
+ process.stdout.write(`${COLORS.dim}${COLORS.cyan}${stripAnsi(rightTitle)}${COLORS.reset}`);
142
+ process.stdout.write(borderColor + ' ' + COLORS.reset);
143
+ }
144
+ else {
145
+ process.stdout.write(borderColor + '\u2500'.repeat(innerWidth) + COLORS.reset);
146
+ }
147
+ process.stdout.write(borderColor + '\u2510' + COLORS.reset); // ┐
148
+ }
149
+ else {
150
+ top += '\u2500'.repeat(innerWidth) + '\u2510'; // ─...─┐
151
+ drawText(row, col, top, borderColor);
152
+ }
153
+ // Side borders
154
+ for (let r = 1; r < height - 1; r++) {
155
+ drawText(row + r, col, '\u2502', borderColor); // │
156
+ drawText(row + r, col + width - 1, '\u2502', borderColor); // │
157
+ }
158
+ // Bottom border
159
+ const bottom = '\u2514' + '\u2500'.repeat(innerWidth) + '\u2518'; // └─...─┘
160
+ drawText(row + height - 1, col, bottom, borderColor);
161
+ }
162
+ /** Draw a horizontal separator line within a box (├─...─┤). */
163
+ export function drawSeparator(row, col, width) {
164
+ const borderColor = COLORS.dim + COLORS.gray;
165
+ const inner = '\u2500'.repeat(width - 2);
166
+ drawText(row, col, `\u251c${inner}\u2524`, borderColor);
167
+ }
168
+ /**
169
+ * Draw a progress bar at the given position.
170
+ * @param progress - Value between 0 and 1
171
+ */
172
+ export function drawProgressBar(row, col, width, progress, color) {
173
+ const clamped = Math.max(0, Math.min(1, progress));
174
+ const innerWidth = Math.max(0, width - 2);
175
+ const filled = Math.round(innerWidth * clamped);
176
+ const empty = innerWidth - filled;
177
+ moveTo(row, col);
178
+ process.stdout.write(COLORS.dim + COLORS.gray + '[' + COLORS.reset);
179
+ if (filled > 0) {
180
+ process.stdout.write(color + '\u2588'.repeat(filled) + COLORS.reset);
181
+ }
182
+ if (empty > 0) {
183
+ process.stdout.write(COLORS.dim + '\u2591'.repeat(empty) + COLORS.reset);
184
+ }
185
+ process.stdout.write(COLORS.dim + COLORS.gray + ']' + COLORS.reset);
186
+ }
187
+ // ─── Formatting Helpers ─────────────────────────────────────────────
188
+ /** Format a number with comma separators. */
189
+ export function formatNumber(n) {
190
+ return n.toLocaleString('en-US');
191
+ }
192
+ /** Format elapsed milliseconds as human-readable duration. */
193
+ export function formatElapsed(ms) {
194
+ const totalSeconds = Math.floor(ms / 1000);
195
+ if (totalSeconds < 60)
196
+ return `${totalSeconds}s`;
197
+ const minutes = Math.floor(totalSeconds / 60);
198
+ const seconds = totalSeconds % 60;
199
+ if (minutes < 60)
200
+ return `${minutes}m ${seconds}s`;
201
+ const hours = Math.floor(minutes / 60);
202
+ const remainingMinutes = minutes % 60;
203
+ return `${hours}h ${remainingMinutes}m`;
204
+ }
205
+ //# sourceMappingURL=renderer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/tui/renderer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Compact format for structured data exchange between phases.
3
+ * Inspired by TOON (Token-Oriented Object Notation) but simpler —
4
+ * reduces token count by 30-50% compared to JSON for typical agent outputs.
5
+ *
6
+ * Format:
7
+ * key: value (one per line)
8
+ * key: [item1, item2, item3] (inline arrays)
9
+ * ---section--- (section separators)
10
+ */
11
+ export interface StructuredResult {
12
+ summary: string;
13
+ confidence: string;
14
+ files: string[];
15
+ findings: string[];
16
+ blockers: string[];
17
+ metadata: Record<string, string>;
18
+ }
19
+ /**
20
+ * Convert a structured result to compact format (~40% fewer tokens than JSON).
21
+ */
22
+ export declare function toCompact(result: StructuredResult): string;
23
+ /**
24
+ * Parse compact format back to structured result.
25
+ */
26
+ export declare function fromCompact(text: string): Partial<StructuredResult>;
27
+ /**
28
+ * Estimate token savings vs JSON for the same data.
29
+ */
30
+ export declare function estimateSavings(result: StructuredResult): {
31
+ json: number;
32
+ compact: number;
33
+ savingsPercent: number;
34
+ };
35
+ //# sourceMappingURL=compact-format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compact-format.d.ts","sourceRoot":"","sources":["../../src/utils/compact-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgC1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0CnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAWnH"}