forge-server 0.1.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 (412) hide show
  1. package/.claude/hooks/worktree-create.sh +64 -0
  2. package/.claude/hooks/worktree-remove.sh +57 -0
  3. package/.claude/settings.local.json +29 -0
  4. package/.forge/knowledge/conventions.yaml +1 -0
  5. package/.forge/knowledge/decisions.yaml +1 -0
  6. package/.forge/knowledge/gotchas.yaml +1 -0
  7. package/.forge/knowledge/patterns.yaml +1 -0
  8. package/.forge/manifest.yaml +6 -0
  9. package/CLAUDE.md +144 -0
  10. package/bin/setup-forge.sh +132 -0
  11. package/dist/cli.d.ts +3 -0
  12. package/dist/cli.d.ts.map +1 -0
  13. package/dist/cli.js +553 -0
  14. package/dist/cli.js.map +1 -0
  15. package/dist/context/codebase.d.ts +57 -0
  16. package/dist/context/codebase.d.ts.map +1 -0
  17. package/dist/context/codebase.js +301 -0
  18. package/dist/context/codebase.js.map +1 -0
  19. package/dist/context/injector.d.ts +147 -0
  20. package/dist/context/injector.d.ts.map +1 -0
  21. package/dist/context/injector.js +533 -0
  22. package/dist/context/injector.js.map +1 -0
  23. package/dist/context/memory.d.ts +32 -0
  24. package/dist/context/memory.d.ts.map +1 -0
  25. package/dist/context/memory.js +140 -0
  26. package/dist/context/memory.js.map +1 -0
  27. package/dist/context/session-index.d.ts +54 -0
  28. package/dist/context/session-index.d.ts.map +1 -0
  29. package/dist/context/session-index.js +265 -0
  30. package/dist/context/session-index.js.map +1 -0
  31. package/dist/context/session.d.ts +42 -0
  32. package/dist/context/session.d.ts.map +1 -0
  33. package/dist/context/session.js +121 -0
  34. package/dist/context/session.js.map +1 -0
  35. package/dist/index.d.ts +3 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +37 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/ingestion/chunker.d.ts +19 -0
  40. package/dist/ingestion/chunker.d.ts.map +1 -0
  41. package/dist/ingestion/chunker.js +189 -0
  42. package/dist/ingestion/chunker.js.map +1 -0
  43. package/dist/ingestion/embedder.d.ts +45 -0
  44. package/dist/ingestion/embedder.d.ts.map +1 -0
  45. package/dist/ingestion/embedder.js +152 -0
  46. package/dist/ingestion/embedder.js.map +1 -0
  47. package/dist/ingestion/git-analyzer.d.ts +77 -0
  48. package/dist/ingestion/git-analyzer.d.ts.map +1 -0
  49. package/dist/ingestion/git-analyzer.js +437 -0
  50. package/dist/ingestion/git-analyzer.js.map +1 -0
  51. package/dist/ingestion/indexer.d.ts +79 -0
  52. package/dist/ingestion/indexer.d.ts.map +1 -0
  53. package/dist/ingestion/indexer.js +766 -0
  54. package/dist/ingestion/indexer.js.map +1 -0
  55. package/dist/ingestion/markdown-chunker.d.ts +19 -0
  56. package/dist/ingestion/markdown-chunker.d.ts.map +1 -0
  57. package/dist/ingestion/markdown-chunker.js +243 -0
  58. package/dist/ingestion/markdown-chunker.js.map +1 -0
  59. package/dist/ingestion/markdown-knowledge.d.ts +21 -0
  60. package/dist/ingestion/markdown-knowledge.d.ts.map +1 -0
  61. package/dist/ingestion/markdown-knowledge.js +129 -0
  62. package/dist/ingestion/markdown-knowledge.js.map +1 -0
  63. package/dist/ingestion/parser.d.ts +20 -0
  64. package/dist/ingestion/parser.d.ts.map +1 -0
  65. package/dist/ingestion/parser.js +429 -0
  66. package/dist/ingestion/parser.js.map +1 -0
  67. package/dist/ingestion/watcher.d.ts +28 -0
  68. package/dist/ingestion/watcher.d.ts.map +1 -0
  69. package/dist/ingestion/watcher.js +147 -0
  70. package/dist/ingestion/watcher.js.map +1 -0
  71. package/dist/knowledge/hydrator.d.ts +37 -0
  72. package/dist/knowledge/hydrator.d.ts.map +1 -0
  73. package/dist/knowledge/hydrator.js +220 -0
  74. package/dist/knowledge/hydrator.js.map +1 -0
  75. package/dist/knowledge/registry.d.ts +129 -0
  76. package/dist/knowledge/registry.d.ts.map +1 -0
  77. package/dist/knowledge/registry.js +361 -0
  78. package/dist/knowledge/registry.js.map +1 -0
  79. package/dist/knowledge/search.d.ts +114 -0
  80. package/dist/knowledge/search.d.ts.map +1 -0
  81. package/dist/knowledge/search.js +428 -0
  82. package/dist/knowledge/search.js.map +1 -0
  83. package/dist/knowledge/store.d.ts +76 -0
  84. package/dist/knowledge/store.d.ts.map +1 -0
  85. package/dist/knowledge/store.js +230 -0
  86. package/dist/knowledge/store.js.map +1 -0
  87. package/dist/learning/confidence.d.ts +30 -0
  88. package/dist/learning/confidence.d.ts.map +1 -0
  89. package/dist/learning/confidence.js +165 -0
  90. package/dist/learning/confidence.js.map +1 -0
  91. package/dist/learning/patterns.d.ts +52 -0
  92. package/dist/learning/patterns.d.ts.map +1 -0
  93. package/dist/learning/patterns.js +290 -0
  94. package/dist/learning/patterns.js.map +1 -0
  95. package/dist/learning/trajectory.d.ts +55 -0
  96. package/dist/learning/trajectory.d.ts.map +1 -0
  97. package/dist/learning/trajectory.js +200 -0
  98. package/dist/learning/trajectory.js.map +1 -0
  99. package/dist/memory/memory-compat.d.ts +100 -0
  100. package/dist/memory/memory-compat.d.ts.map +1 -0
  101. package/dist/memory/memory-compat.js +146 -0
  102. package/dist/memory/memory-compat.js.map +1 -0
  103. package/dist/memory/observation-store.d.ts +57 -0
  104. package/dist/memory/observation-store.d.ts.map +1 -0
  105. package/dist/memory/observation-store.js +154 -0
  106. package/dist/memory/observation-store.js.map +1 -0
  107. package/dist/memory/session-tracker.d.ts +81 -0
  108. package/dist/memory/session-tracker.d.ts.map +1 -0
  109. package/dist/memory/session-tracker.js +262 -0
  110. package/dist/memory/session-tracker.js.map +1 -0
  111. package/dist/pipeline/engine.d.ts +179 -0
  112. package/dist/pipeline/engine.d.ts.map +1 -0
  113. package/dist/pipeline/engine.js +691 -0
  114. package/dist/pipeline/engine.js.map +1 -0
  115. package/dist/pipeline/events.d.ts +54 -0
  116. package/dist/pipeline/events.d.ts.map +1 -0
  117. package/dist/pipeline/events.js +157 -0
  118. package/dist/pipeline/events.js.map +1 -0
  119. package/dist/pipeline/parallel.d.ts +83 -0
  120. package/dist/pipeline/parallel.d.ts.map +1 -0
  121. package/dist/pipeline/parallel.js +277 -0
  122. package/dist/pipeline/parallel.js.map +1 -0
  123. package/dist/pipeline/state-machine.d.ts +65 -0
  124. package/dist/pipeline/state-machine.d.ts.map +1 -0
  125. package/dist/pipeline/state-machine.js +176 -0
  126. package/dist/pipeline/state-machine.js.map +1 -0
  127. package/dist/query/graph-queries.d.ts +84 -0
  128. package/dist/query/graph-queries.d.ts.map +1 -0
  129. package/dist/query/graph-queries.js +216 -0
  130. package/dist/query/graph-queries.js.map +1 -0
  131. package/dist/query/hybrid-search.d.ts +34 -0
  132. package/dist/query/hybrid-search.d.ts.map +1 -0
  133. package/dist/query/hybrid-search.js +263 -0
  134. package/dist/query/hybrid-search.js.map +1 -0
  135. package/dist/query/intent-detector.d.ts +35 -0
  136. package/dist/query/intent-detector.d.ts.map +1 -0
  137. package/dist/query/intent-detector.js +115 -0
  138. package/dist/query/intent-detector.js.map +1 -0
  139. package/dist/query/ranking.d.ts +57 -0
  140. package/dist/query/ranking.d.ts.map +1 -0
  141. package/dist/query/ranking.js +109 -0
  142. package/dist/query/ranking.js.map +1 -0
  143. package/dist/server.d.ts +3 -0
  144. package/dist/server.d.ts.map +1 -0
  145. package/dist/server.js +291 -0
  146. package/dist/server.js.map +1 -0
  147. package/dist/storage/falkordb-store.d.ts +73 -0
  148. package/dist/storage/falkordb-store.d.ts.map +1 -0
  149. package/dist/storage/falkordb-store.js +346 -0
  150. package/dist/storage/falkordb-store.js.map +1 -0
  151. package/dist/storage/file-cache.d.ts +32 -0
  152. package/dist/storage/file-cache.d.ts.map +1 -0
  153. package/dist/storage/file-cache.js +115 -0
  154. package/dist/storage/file-cache.js.map +1 -0
  155. package/dist/storage/interfaces.d.ts +151 -0
  156. package/dist/storage/interfaces.d.ts.map +1 -0
  157. package/dist/storage/interfaces.js +7 -0
  158. package/dist/storage/interfaces.js.map +1 -0
  159. package/dist/storage/qdrant-store.d.ts +110 -0
  160. package/dist/storage/qdrant-store.d.ts.map +1 -0
  161. package/dist/storage/qdrant-store.js +467 -0
  162. package/dist/storage/qdrant-store.js.map +1 -0
  163. package/dist/storage/schema.d.ts +4 -0
  164. package/dist/storage/schema.d.ts.map +1 -0
  165. package/dist/storage/schema.js +136 -0
  166. package/dist/storage/schema.js.map +1 -0
  167. package/dist/storage/sqlite.d.ts +35 -0
  168. package/dist/storage/sqlite.d.ts.map +1 -0
  169. package/dist/storage/sqlite.js +132 -0
  170. package/dist/storage/sqlite.js.map +1 -0
  171. package/dist/tools/collaboration-tools.d.ts +111 -0
  172. package/dist/tools/collaboration-tools.d.ts.map +1 -0
  173. package/dist/tools/collaboration-tools.js +174 -0
  174. package/dist/tools/collaboration-tools.js.map +1 -0
  175. package/dist/tools/context-tools.d.ts +293 -0
  176. package/dist/tools/context-tools.d.ts.map +1 -0
  177. package/dist/tools/context-tools.js +437 -0
  178. package/dist/tools/context-tools.js.map +1 -0
  179. package/dist/tools/graph-tools.d.ts +129 -0
  180. package/dist/tools/graph-tools.d.ts.map +1 -0
  181. package/dist/tools/graph-tools.js +237 -0
  182. package/dist/tools/graph-tools.js.map +1 -0
  183. package/dist/tools/ingestion-tools.d.ts +96 -0
  184. package/dist/tools/ingestion-tools.d.ts.map +1 -0
  185. package/dist/tools/ingestion-tools.js +90 -0
  186. package/dist/tools/ingestion-tools.js.map +1 -0
  187. package/dist/tools/learning-tools.d.ts +168 -0
  188. package/dist/tools/learning-tools.d.ts.map +1 -0
  189. package/dist/tools/learning-tools.js +158 -0
  190. package/dist/tools/learning-tools.js.map +1 -0
  191. package/dist/tools/memory-tools.d.ts +183 -0
  192. package/dist/tools/memory-tools.d.ts.map +1 -0
  193. package/dist/tools/memory-tools.js +197 -0
  194. package/dist/tools/memory-tools.js.map +1 -0
  195. package/dist/tools/phase-tools.d.ts +954 -0
  196. package/dist/tools/phase-tools.d.ts.map +1 -0
  197. package/dist/tools/phase-tools.js +1215 -0
  198. package/dist/tools/phase-tools.js.map +1 -0
  199. package/dist/tools/pipeline-tools.d.ts +140 -0
  200. package/dist/tools/pipeline-tools.d.ts.map +1 -0
  201. package/dist/tools/pipeline-tools.js +162 -0
  202. package/dist/tools/pipeline-tools.js.map +1 -0
  203. package/dist/tools/registration-tools.d.ts +220 -0
  204. package/dist/tools/registration-tools.d.ts.map +1 -0
  205. package/dist/tools/registration-tools.js +391 -0
  206. package/dist/tools/registration-tools.js.map +1 -0
  207. package/dist/util/circuit-breaker.d.ts +75 -0
  208. package/dist/util/circuit-breaker.d.ts.map +1 -0
  209. package/dist/util/circuit-breaker.js +159 -0
  210. package/dist/util/circuit-breaker.js.map +1 -0
  211. package/dist/util/config.d.ts +23 -0
  212. package/dist/util/config.d.ts.map +1 -0
  213. package/dist/util/config.js +164 -0
  214. package/dist/util/config.js.map +1 -0
  215. package/dist/util/logger.d.ts +13 -0
  216. package/dist/util/logger.d.ts.map +1 -0
  217. package/dist/util/logger.js +45 -0
  218. package/dist/util/logger.js.map +1 -0
  219. package/dist/util/token-counter.d.ts +24 -0
  220. package/dist/util/token-counter.d.ts.map +1 -0
  221. package/dist/util/token-counter.js +48 -0
  222. package/dist/util/token-counter.js.map +1 -0
  223. package/dist/util/types.d.ts +525 -0
  224. package/dist/util/types.d.ts.map +1 -0
  225. package/dist/util/types.js +5 -0
  226. package/dist/util/types.js.map +1 -0
  227. package/docker-compose.yml +20 -0
  228. package/docs/plans/2026-02-27-swarm-coordination/architecture.md +203 -0
  229. package/docs/plans/2026-02-27-swarm-coordination/vision.md +57 -0
  230. package/docs/plans/completed/2026-02-26-forge-plugin-bundling/architecture.md +1 -0
  231. package/docs/plans/completed/2026-02-26-forge-plugin-bundling/vision.md +300 -0
  232. package/docs/plans/completed/2026-02-27-forge-swarm-learning/architecture.md +480 -0
  233. package/docs/plans/completed/2026-02-27-forge-swarm-learning/verification-checklist.md +462 -0
  234. package/docs/plans/completed/2026-02-27-git-history-atlassian/git-jira-plan.md +181 -0
  235. package/package.json +39 -0
  236. package/plugin/.claude-plugin/plugin.json +8 -0
  237. package/plugin/.mcp.json +15 -0
  238. package/plugin/README.md +134 -0
  239. package/plugin/agents/architect.md +367 -0
  240. package/plugin/agents/backend-specialist.md +263 -0
  241. package/plugin/agents/brainstormer.md +122 -0
  242. package/plugin/agents/data-specialist.md +266 -0
  243. package/plugin/agents/designer.md +408 -0
  244. package/plugin/agents/frontend-specialist.md +241 -0
  245. package/plugin/agents/inspector.md +406 -0
  246. package/plugin/agents/knowledge-keeper.md +443 -0
  247. package/plugin/agents/platform-engineer.md +326 -0
  248. package/plugin/agents/product-manager.md +268 -0
  249. package/plugin/agents/product-owner.md +438 -0
  250. package/plugin/agents/pulse-checker.md +73 -0
  251. package/plugin/agents/qa-strategist.md +500 -0
  252. package/plugin/agents/self-improver.md +310 -0
  253. package/plugin/agents/strategist.md +360 -0
  254. package/plugin/agents/supervisor.md +380 -0
  255. package/plugin/commands/brainstorm.md +25 -0
  256. package/plugin/commands/forge.md +88 -0
  257. package/plugin/docs/atlassian-integration.md +110 -0
  258. package/plugin/docs/workflow.md +126 -0
  259. package/plugin/skills/agent-development/.skillfish.json +10 -0
  260. package/plugin/skills/agent-development/SKILL.md +415 -0
  261. package/plugin/skills/agent-development/examples/agent-creation-prompt.md +238 -0
  262. package/plugin/skills/agent-development/examples/complete-agent-examples.md +427 -0
  263. package/plugin/skills/agent-development/references/agent-creation-system-prompt.md +207 -0
  264. package/plugin/skills/agent-development/references/system-prompt-design.md +411 -0
  265. package/plugin/skills/agent-development/references/triggering-examples.md +491 -0
  266. package/plugin/skills/agent-development/scripts/validate-agent.sh +217 -0
  267. package/plugin/skills/agent-handoff/SKILL.md +335 -0
  268. package/plugin/skills/anti-stub/SKILL.md +317 -0
  269. package/plugin/skills/brainstorm/SKILL.md +31 -0
  270. package/plugin/skills/debugging/SKILL.md +276 -0
  271. package/plugin/skills/fix/SKILL.md +62 -0
  272. package/plugin/skills/frontend-design/.skillfish.json +10 -0
  273. package/plugin/skills/frontend-design/SKILL.md +42 -0
  274. package/plugin/skills/gotchas/SKILL.md +61 -0
  275. package/plugin/skills/graph-orchestrator/SKILL.md +38 -0
  276. package/plugin/skills/history/SKILL.md +58 -0
  277. package/plugin/skills/impact/SKILL.md +59 -0
  278. package/plugin/skills/implementation-execution/SKILL.md +291 -0
  279. package/plugin/skills/index-repo/SKILL.md +55 -0
  280. package/plugin/skills/interviewing/SKILL.md +225 -0
  281. package/plugin/skills/knowledge-curation/SKILL.md +393 -0
  282. package/plugin/skills/learn/SKILL.md +69 -0
  283. package/plugin/skills/mcp-integration/.skillfish.json +10 -0
  284. package/plugin/skills/mcp-integration/SKILL.md +554 -0
  285. package/plugin/skills/mcp-integration/examples/http-server.json +20 -0
  286. package/plugin/skills/mcp-integration/examples/sse-server.json +19 -0
  287. package/plugin/skills/mcp-integration/examples/stdio-server.json +26 -0
  288. package/plugin/skills/mcp-integration/references/authentication.md +549 -0
  289. package/plugin/skills/mcp-integration/references/server-types.md +536 -0
  290. package/plugin/skills/mcp-integration/references/tool-usage.md +538 -0
  291. package/plugin/skills/nestjs/.skillfish.json +10 -0
  292. package/plugin/skills/nestjs/SKILL.md +669 -0
  293. package/plugin/skills/nestjs/drizzle-reference.md +1894 -0
  294. package/plugin/skills/nestjs/reference.md +1447 -0
  295. package/plugin/skills/nestjs/workflow-optimization.md +229 -0
  296. package/plugin/skills/parallel-dispatch/SKILL.md +308 -0
  297. package/plugin/skills/project-discovery/SKILL.md +304 -0
  298. package/plugin/skills/search/SKILL.md +56 -0
  299. package/plugin/skills/security-audit/SKILL.md +362 -0
  300. package/plugin/skills/skill-development/.skillfish.json +10 -0
  301. package/plugin/skills/skill-development/SKILL.md +637 -0
  302. package/plugin/skills/skill-development/references/skill-creator-original.md +209 -0
  303. package/plugin/skills/tdd/SKILL.md +273 -0
  304. package/plugin/skills/terminal-presentation/SKILL.md +395 -0
  305. package/plugin/skills/test-strategy/SKILL.md +365 -0
  306. package/plugin/skills/verification-protocol/SKILL.md +256 -0
  307. package/plugin/skills/visual-explainer/CHANGELOG.md +97 -0
  308. package/plugin/skills/visual-explainer/LICENSE +21 -0
  309. package/plugin/skills/visual-explainer/README.md +137 -0
  310. package/plugin/skills/visual-explainer/SKILL.md +352 -0
  311. package/plugin/skills/visual-explainer/banner.png +0 -0
  312. package/plugin/skills/visual-explainer/package.json +11 -0
  313. package/plugin/skills/visual-explainer/prompts/diff-review.md +68 -0
  314. package/plugin/skills/visual-explainer/prompts/fact-check.md +63 -0
  315. package/plugin/skills/visual-explainer/prompts/generate-slides.md +18 -0
  316. package/plugin/skills/visual-explainer/prompts/generate-web-diagram.md +10 -0
  317. package/plugin/skills/visual-explainer/prompts/plan-review.md +86 -0
  318. package/plugin/skills/visual-explainer/prompts/project-recap.md +61 -0
  319. package/plugin/skills/visual-explainer/references/css-patterns.md +1188 -0
  320. package/plugin/skills/visual-explainer/references/libraries.md +470 -0
  321. package/plugin/skills/visual-explainer/references/responsive-nav.md +212 -0
  322. package/plugin/skills/visual-explainer/references/slide-patterns.md +1403 -0
  323. package/plugin/skills/visual-explainer/templates/architecture.html +596 -0
  324. package/plugin/skills/visual-explainer/templates/data-table.html +540 -0
  325. package/plugin/skills/visual-explainer/templates/mermaid-flowchart.html +435 -0
  326. package/plugin/skills/visual-explainer/templates/slide-deck.html +913 -0
  327. package/src/cli.ts +655 -0
  328. package/src/context/.gitkeep +0 -0
  329. package/src/context/codebase.ts +393 -0
  330. package/src/context/injector.ts +797 -0
  331. package/src/context/memory.ts +187 -0
  332. package/src/context/session-index.ts +327 -0
  333. package/src/context/session.ts +152 -0
  334. package/src/index.ts +47 -0
  335. package/src/ingestion/.gitkeep +0 -0
  336. package/src/ingestion/chunker.ts +277 -0
  337. package/src/ingestion/embedder.ts +167 -0
  338. package/src/ingestion/git-analyzer.ts +545 -0
  339. package/src/ingestion/indexer.ts +984 -0
  340. package/src/ingestion/markdown-chunker.ts +337 -0
  341. package/src/ingestion/markdown-knowledge.ts +175 -0
  342. package/src/ingestion/parser.ts +475 -0
  343. package/src/ingestion/watcher.ts +182 -0
  344. package/src/knowledge/.gitkeep +0 -0
  345. package/src/knowledge/hydrator.ts +246 -0
  346. package/src/knowledge/registry.ts +463 -0
  347. package/src/knowledge/search.ts +565 -0
  348. package/src/knowledge/store.ts +262 -0
  349. package/src/learning/.gitkeep +0 -0
  350. package/src/learning/confidence.ts +193 -0
  351. package/src/learning/patterns.ts +360 -0
  352. package/src/learning/trajectory.ts +268 -0
  353. package/src/memory/.gitkeep +0 -0
  354. package/src/memory/memory-compat.ts +233 -0
  355. package/src/memory/observation-store.ts +224 -0
  356. package/src/memory/session-tracker.ts +332 -0
  357. package/src/pipeline/.gitkeep +0 -0
  358. package/src/pipeline/engine.ts +1139 -0
  359. package/src/pipeline/events.ts +253 -0
  360. package/src/pipeline/parallel.ts +394 -0
  361. package/src/pipeline/state-machine.ts +199 -0
  362. package/src/query/.gitkeep +0 -0
  363. package/src/query/graph-queries.ts +262 -0
  364. package/src/query/hybrid-search.ts +337 -0
  365. package/src/query/intent-detector.ts +131 -0
  366. package/src/query/ranking.ts +161 -0
  367. package/src/server.ts +352 -0
  368. package/src/storage/.gitkeep +0 -0
  369. package/src/storage/falkordb-store.ts +388 -0
  370. package/src/storage/file-cache.ts +141 -0
  371. package/src/storage/interfaces.ts +201 -0
  372. package/src/storage/qdrant-store.ts +557 -0
  373. package/src/storage/schema.ts +139 -0
  374. package/src/storage/sqlite.ts +168 -0
  375. package/src/tools/.gitkeep +0 -0
  376. package/src/tools/collaboration-tools.ts +208 -0
  377. package/src/tools/context-tools.ts +493 -0
  378. package/src/tools/graph-tools.ts +295 -0
  379. package/src/tools/ingestion-tools.ts +122 -0
  380. package/src/tools/learning-tools.ts +181 -0
  381. package/src/tools/memory-tools.ts +234 -0
  382. package/src/tools/phase-tools.ts +1452 -0
  383. package/src/tools/pipeline-tools.ts +188 -0
  384. package/src/tools/registration-tools.ts +450 -0
  385. package/src/util/.gitkeep +0 -0
  386. package/src/util/circuit-breaker.ts +193 -0
  387. package/src/util/config.ts +177 -0
  388. package/src/util/logger.ts +53 -0
  389. package/src/util/token-counter.ts +52 -0
  390. package/src/util/types.ts +710 -0
  391. package/tests/context/.gitkeep +0 -0
  392. package/tests/integration/.gitkeep +0 -0
  393. package/tests/knowledge/.gitkeep +0 -0
  394. package/tests/learning/.gitkeep +0 -0
  395. package/tests/pipeline/.gitkeep +0 -0
  396. package/tests/tools/.gitkeep +0 -0
  397. package/tsconfig.json +21 -0
  398. package/vitest.config.ts +10 -0
  399. package/vscode-extension/.vscodeignore +7 -0
  400. package/vscode-extension/README.md +43 -0
  401. package/vscode-extension/out/edge-collector.js +274 -0
  402. package/vscode-extension/out/edge-collector.js.map +1 -0
  403. package/vscode-extension/out/extension.js +264 -0
  404. package/vscode-extension/out/extension.js.map +1 -0
  405. package/vscode-extension/out/forge-client.js +318 -0
  406. package/vscode-extension/out/forge-client.js.map +1 -0
  407. package/vscode-extension/package-lock.json +59 -0
  408. package/vscode-extension/package.json +71 -0
  409. package/vscode-extension/src/edge-collector.ts +320 -0
  410. package/vscode-extension/src/extension.ts +269 -0
  411. package/vscode-extension/src/forge-client.ts +364 -0
  412. package/vscode-extension/tsconfig.json +19 -0
package/plugin/skills/visual-explainer/templates/architecture.html ADDED
@@ -0,0 +1,596 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Architecture Diagram — Reference Template</title>
7
+ <!--
8
+ Reference template for the visual-explainer skill: CSS Grid architecture layout.
9
+ Warm terracotta/sage palette — distinctly different from the teal (mermaid)
10
+ and rose (data-table) templates so agents absorb variety, not a single palette.
11
+ Key patterns demonstrated:
12
+ - Warm non-default palette (terracotta + sage, NOT indigo/violet)
13
+ - Depth tiers: hero (input sources), default (mid sections), recessed (callout)
14
+ - Asymmetric background atmosphere (off-center gradient mesh)
15
+ - Large heading (38px) for typographic contrast
16
+ - Section cards with colored accent borders and dot labels
17
+ - Vertical flow arrows between sections (inline SVG)
18
+ - Horizontal pipeline with step boxes and arrow separators
19
+ - Parallel branch within a pipeline
20
+ - Color-coded legend, three-column output row
21
+ - Staggered fade-in via --i CSS variable (works with interleaved elements)
22
+ - Reduced motion respect, responsive single-column fallback
23
+ -->
24
+ <link rel="preconnect" href="https://fonts.googleapis.com">
25
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
26
+ <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@400;500;600;700&display=swap" rel="stylesheet">
27
+ <style>
28
+ /* ============ THEME ============ */
29
+ :root {
30
+ --font-body: 'IBM Plex Sans', system-ui, sans-serif;
31
+ --font-mono: 'IBM Plex Mono', 'SF Mono', Consolas, monospace;
32
+
33
+ /* Light theme — warm terracotta + sage palette */
34
+ --bg: #faf7f5;
35
+ --surface: #ffffff;
36
+ --surface2: #f5f0ec;
37
+ --surface-elevated: #fff9f5;
38
+ --border: rgba(0, 0, 0, 0.07);
39
+ --border-bright: rgba(0, 0, 0, 0.14);
40
+ --text: #292017;
41
+ --text-dim: #8a7e72;
42
+ --accent: #c2410c;
43
+ --accent-dim: rgba(194, 65, 12, 0.07);
44
+ --green: #4d7c0f;
45
+ --green-dim: rgba(77, 124, 15, 0.07);
46
+ --orange: #b45309;
47
+ --orange-dim: rgba(180, 83, 9, 0.07);
48
+ --sage: #65a30d;
49
+ --sage-dim: rgba(101, 163, 13, 0.07);
50
+ --teal: #0f766e;
51
+ --teal-dim: rgba(15, 118, 110, 0.07);
52
+ --plum: #9f1239;
53
+ --plum-dim: rgba(159, 18, 57, 0.07);
54
+ }
55
+
56
+ @media (prefers-color-scheme: dark) {
57
+ :root {
58
+ --bg: #1a1412;
59
+ --surface: #231d1a;
60
+ --surface2: #2e2622;
61
+ --surface-elevated: #352d28;
62
+ --border: rgba(255, 255, 255, 0.06);
63
+ --border-bright: rgba(255, 255, 255, 0.12);
64
+ --text: #ede5dd;
65
+ --text-dim: #a69889;
66
+ --accent: #fb923c;
67
+ --accent-dim: rgba(251, 146, 60, 0.12);
68
+ --green: #a3e635;
69
+ --green-dim: rgba(163, 230, 53, 0.1);
70
+ --orange: #fbbf24;
71
+ --orange-dim: rgba(251, 191, 36, 0.1);
72
+ --sage: #bef264;
73
+ --sage-dim: rgba(190, 242, 100, 0.1);
74
+ --teal: #5eead4;
75
+ --teal-dim: rgba(94, 234, 212, 0.1);
76
+ --plum: #fda4af;
77
+ --plum-dim: rgba(253, 164, 175, 0.1);
78
+ }
79
+ }
80
+
81
+ /* ============ RESET + BASE ============ */
82
+ * { margin: 0; padding: 0; box-sizing: border-box; }
83
+
84
+ body {
85
+ background: var(--bg);
86
+ background-image:
87
+ radial-gradient(ellipse at 20% 0%, var(--accent-dim) 0%, transparent 50%),
88
+ radial-gradient(ellipse at 80% 100%, var(--sage-dim) 0%, transparent 40%);
89
+ color: var(--text);
90
+ font-family: var(--font-body);
91
+ padding: 40px;
92
+ min-height: 100vh;
93
+ }
94
+
95
+ /* ============ ANIMATION ============ */
96
+ @keyframes fadeUp {
97
+ from { opacity: 0; transform: translateY(12px); }
98
+ to { opacity: 1; transform: translateY(0); }
99
+ }
100
+
101
+ .section, .flow-arrow {
102
+ animation: fadeUp 0.4s ease-out both;
103
+ animation-delay: calc(var(--i, 0) * 0.06s);
104
+ }
105
+
106
+ @media (prefers-reduced-motion: reduce) {
107
+ *, *::before, *::after {
108
+ animation-duration: 0.01ms !important;
109
+ animation-delay: 0ms !important;
110
+ transition-duration: 0.01ms !important;
111
+ }
112
+ }
113
+
114
+ /* ============ TYPOGRAPHY ============ */
115
+ h1 {
116
+ font-size: 38px;
117
+ font-weight: 700;
118
+ letter-spacing: -1px;
119
+ margin-bottom: 6px;
120
+ text-wrap: balance;
121
+ }
122
+
123
+ .subtitle {
124
+ color: var(--text-dim);
125
+ font-size: 14px;
126
+ margin-bottom: 40px;
127
+ font-family: var(--font-mono);
128
+ }
129
+
130
+ /* ============ LAYOUT ============ */
131
+ .diagram {
132
+ display: grid;
133
+ grid-template-columns: 1fr;
134
+ gap: 24px;
135
+ max-width: 1100px;
136
+ margin: 0 auto;
137
+ }
138
+
139
+ /* ============ SECTION CARD ============ */
140
+ .section {
141
+ background: var(--surface);
142
+ border: 1px solid var(--border);
143
+ border-radius: 12px;
144
+ padding: 20px 24px;
145
+ }
146
+
147
+ .section--hero {
148
+ background: var(--surface-elevated);
149
+ border-color: color-mix(in srgb, var(--border) 50%, var(--accent) 50%);
150
+ box-shadow: 0 4px 20px rgba(0, 0, 0, 0.06);
151
+ padding: 28px 32px;
152
+ }
153
+
154
+ .section--recessed {
155
+ background: var(--surface2);
156
+ box-shadow: inset 0 1px 3px rgba(0, 0, 0, 0.04);
157
+ }
158
+
159
+ .section-label {
160
+ font-family: var(--font-mono);
161
+ font-size: 11px;
162
+ font-weight: 600;
163
+ text-transform: uppercase;
164
+ letter-spacing: 1.5px;
165
+ margin-bottom: 16px;
166
+ display: flex;
167
+ align-items: center;
168
+ gap: 8px;
169
+ }
170
+
171
+ .section-label .dot {
172
+ width: 8px;
173
+ height: 8px;
174
+ border-radius: 50%;
175
+ display: inline-block;
176
+ }
177
+
178
+ /* Color variants */
179
+ .section--accent { border-color: var(--accent-dim); }
180
+ .section--accent .section-label { color: var(--accent); }
181
+ .section--accent .section-label .dot { background: var(--accent); }
182
+
183
+ .section--green { border-color: var(--green-dim); }
184
+ .section--green .section-label { color: var(--green); }
185
+ .section--green .section-label .dot { background: var(--green); }
186
+
187
+ .section--orange { border-color: var(--orange-dim); }
188
+ .section--orange .section-label { color: var(--orange); }
189
+ .section--orange .section-label .dot { background: var(--orange); }
190
+
191
+ .section--sage { border-color: var(--sage-dim); }
192
+ .section--sage .section-label { color: var(--sage); }
193
+ .section--sage .section-label .dot { background: var(--sage); }
194
+
195
+ .section--teal { border-color: var(--teal-dim); }
196
+ .section--teal .section-label { color: var(--teal); }
197
+ .section--teal .section-label .dot { background: var(--teal); }
198
+
199
+ .section--plum { border-color: var(--plum-dim); }
200
+ .section--plum .section-label { color: var(--plum); }
201
+ .section--plum .section-label .dot { background: var(--plum); }
202
+
203
+ /* ============ INNER GRID ============ */
204
+ .inner-grid {
205
+ display: grid;
206
+ grid-template-columns: 1fr 1fr;
207
+ gap: 12px;
208
+ }
209
+
210
+ .inner-card {
211
+ background: var(--surface2);
212
+ border: 1px solid var(--border);
213
+ border-radius: 8px;
214
+ padding: 12px 16px;
215
+ }
216
+
217
+ .inner-card .title {
218
+ font-weight: 600;
219
+ font-size: 13px;
220
+ margin-bottom: 4px;
221
+ }
222
+
223
+ .inner-card .desc {
224
+ color: var(--text-dim);
225
+ font-size: 12px;
226
+ line-height: 1.5;
227
+ }
228
+
229
+ .inner-card code {
230
+ font-family: var(--font-mono);
231
+ font-size: 11px;
232
+ background: var(--accent-dim);
233
+ color: var(--accent);
234
+ padding: 1px 5px;
235
+ border-radius: 3px;
236
+ }
237
+
238
+ /* ============ FLOW ARROW ============ */
239
+ .flow-arrow {
240
+ display: flex;
241
+ justify-content: center;
242
+ align-items: center;
243
+ gap: 8px;
244
+ color: var(--text-dim);
245
+ font-family: var(--font-mono);
246
+ font-size: 12px;
247
+ padding: 4px 0;
248
+ }
249
+
250
+ .flow-arrow svg {
251
+ width: 20px;
252
+ height: 20px;
253
+ fill: none;
254
+ stroke: var(--border-bright);
255
+ stroke-width: 2;
256
+ stroke-linecap: round;
257
+ stroke-linejoin: round;
258
+ }
259
+
260
+ /* ============ PIPELINE ============ */
261
+ .pipeline {
262
+ display: flex;
263
+ gap: 0;
264
+ align-items: stretch;
265
+ overflow-x: auto;
266
+ padding-bottom: 4px;
267
+ }
268
+
269
+ .pipeline-step {
270
+ background: var(--surface);
271
+ border: 1px solid var(--border);
272
+ border-radius: 8px;
273
+ padding: 10px 12px;
274
+ min-width: 120px;
275
+ flex-shrink: 0;
276
+ text-align: center;
277
+ }
278
+
279
+ .pipeline-step .step-num {
280
+ font-family: var(--font-mono);
281
+ font-size: 10px;
282
+ font-weight: 600;
283
+ margin-bottom: 4px;
284
+ }
285
+
286
+ .pipeline-step .step-name {
287
+ font-size: 12px;
288
+ font-weight: 600;
289
+ margin-bottom: 3px;
290
+ }
291
+
292
+ .pipeline-step .step-detail {
293
+ font-size: 10px;
294
+ color: var(--text-dim);
295
+ line-height: 1.4;
296
+ }
297
+
298
+ /* Step color variants */
299
+ .pipeline-step--teal { border-color: var(--teal-dim); }
300
+ .pipeline-step--teal .step-num { color: var(--teal); }
301
+
302
+ .pipeline-step--sage { border-color: var(--sage-dim); }
303
+ .pipeline-step--sage .step-num { color: var(--sage); }
304
+
305
+ .pipeline-step--orange { border-color: var(--orange-dim); }
306
+ .pipeline-step--orange .step-num { color: var(--orange); }
307
+
308
+ .pipeline-step--green { border-color: var(--green-dim); }
309
+ .pipeline-step--green .step-num { color: var(--green); }
310
+
311
+ .pipeline-arrow {
312
+ display: flex;
313
+ align-items: center;
314
+ padding: 0 2px;
315
+ color: var(--border-bright);
316
+ font-size: 16px;
317
+ flex-shrink: 0;
318
+ }
319
+
320
+ .pipeline-parallel {
321
+ display: flex;
322
+ flex-direction: column;
323
+ gap: 4px;
324
+ }
325
+
326
+ /* ============ THREE COLUMN ROW ============ */
327
+ .three-col {
328
+ display: grid;
329
+ grid-template-columns: 1fr 1fr 1fr;
330
+ gap: 16px;
331
+ }
332
+
333
+ /* ============ LIST ============ */
334
+ .node-list {
335
+ list-style: none;
336
+ font-size: 12px;
337
+ line-height: 1.8;
338
+ }
339
+
340
+ .node-list li {
341
+ padding-left: 14px;
342
+ position: relative;
343
+ }
344
+
345
+ .node-list li::before {
346
+ content: '›';
347
+ color: var(--text-dim);
348
+ font-weight: 600;
349
+ position: absolute;
350
+ left: 0;
351
+ }
352
+
353
+ .node-list code {
354
+ font-family: var(--font-mono);
355
+ font-size: 11px;
356
+ background: var(--accent-dim);
357
+ color: var(--accent);
358
+ padding: 1px 5px;
359
+ border-radius: 3px;
360
+ }
361
+
362
+ /* ============ CALLOUT ============ */
363
+ .callout {
364
+ background: var(--surface2);
365
+ border: 1px solid var(--border);
366
+ border-left: 3px solid var(--accent);
367
+ border-radius: 0 8px 8px 0;
368
+ padding: 14px 18px;
369
+ font-size: 13px;
370
+ line-height: 1.6;
371
+ color: var(--text-dim);
372
+ }
373
+
374
+ .callout strong { color: var(--text); font-weight: 600; }
375
+
376
+ .callout code {
377
+ font-family: var(--font-mono);
378
+ font-size: 11px;
379
+ background: var(--accent-dim);
380
+ color: var(--accent);
381
+ padding: 1px 5px;
382
+ border-radius: 3px;
383
+ }
384
+
385
+ /* ============ LEGEND ============ */
386
+ .legend {
387
+ display: flex;
388
+ gap: 20px;
389
+ flex-wrap: wrap;
390
+ }
391
+
392
+ .legend-item {
393
+ display: flex;
394
+ align-items: center;
395
+ gap: 6px;
396
+ font-size: 11px;
397
+ color: var(--text-dim);
398
+ font-family: var(--font-mono);
399
+ }
400
+
401
+ .legend-swatch {
402
+ width: 12px;
403
+ height: 12px;
404
+ border-radius: 3px;
405
+ }
406
+
407
+ /* ============ SOURCE PILLS ============ */
408
+ .sources {
409
+ display: flex;
410
+ gap: 12px;
411
+ flex-wrap: wrap;
412
+ justify-content: center;
413
+ }
414
+
415
+ .source {
416
+ background: var(--surface2);
417
+ border: 1px solid var(--border);
418
+ border-radius: 8px;
419
+ padding: 10px 18px;
420
+ font-family: var(--font-mono);
421
+ font-size: 13px;
422
+ font-weight: 500;
423
+ display: flex;
424
+ align-items: center;
425
+ gap: 8px;
426
+ transition: border-color 0.2s;
427
+ }
428
+
429
+ .source:hover { border-color: var(--border-bright); }
430
+
431
+ /* ============ RESPONSIVE ============ */
432
+ @media (max-width: 768px) {
433
+ body { padding: 20px; }
434
+ .inner-grid { grid-template-columns: 1fr; }
435
+ .three-col { grid-template-columns: 1fr; }
436
+ .pipeline { flex-wrap: wrap; gap: 6px; }
437
+ .pipeline-arrow { display: none; }
438
+ }
439
+ </style>
440
+ </head>
441
+ <body>
442
+
443
+ <h1>System Architecture</h1>
444
+ <p class="subtitle">reference template &mdash; architecture diagram pattern</p>
445
+
446
+ <div class="diagram">
447
+
448
+ <!-- Source pills row — hero depth for the entry point -->
449
+ <div class="section section--hero" style="--i:0">
450
+ <div class="section-label"><span class="dot" style="background:var(--text-dim)"></span> Input Sources</div>
451
+ <div class="sources">
452
+ <div class="source"><span>💬</span> Slack</div>
453
+ <div class="source"><span>🐙</span> GitHub</div>
454
+ <div class="source"><span>📧</span> Email</div>
455
+ </div>
456
+ </div>
457
+
458
+ <!-- Flow arrow -->
459
+ <div class="flow-arrow" style="--i:1">
460
+ <svg viewBox="0 0 20 20"><path d="M10 4 L10 16 M6 12 L10 16 L14 12"/></svg>
461
+ incoming events
462
+ </div>
463
+
464
+ <!-- Gateway section with inner grid -->
465
+ <div class="section section--accent" style="--i:2">
466
+ <div class="section-label"><span class="dot"></span> Gateway Layer</div>
467
+ <div class="inner-grid">
468
+ <div class="inner-card">
469
+ <div class="title">Router</div>
470
+ <div class="desc">Routes messages to agents via <code>resolveRoute()</code></div>
471
+ </div>
472
+ <div class="inner-card">
473
+ <div class="title">HTTP Server</div>
474
+ <div class="desc">Plugin routes + handlers for webhooks and API</div>
475
+ </div>
476
+ </div>
477
+ </div>
478
+
479
+ <div class="flow-arrow" style="--i:3">
480
+ <svg viewBox="0 0 20 20"><path d="M10 4 L10 16 M6 12 L10 16 L14 12"/></svg>
481
+ pipeline entry
482
+ </div>
483
+
484
+ <!-- Pipeline section -->
485
+ <div class="section section--green" style="--i:4">
486
+ <div class="section-label"><span class="dot"></span> Processing Pipeline</div>
487
+ <div class="legend" style="margin-bottom:14px">
488
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--teal-dim);border:1px solid var(--teal)"></div>no LLM</div>
489
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--sage-dim);border:1px solid var(--sage)"></div>LLM call</div>
490
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--orange-dim);border:1px solid var(--orange)"></div>embedding</div>
491
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--green-dim);border:1px solid var(--green)"></div>DB write</div>
492
+ </div>
493
+ <div class="pipeline">
494
+ <div class="pipeline-step pipeline-step--teal">
495
+ <div class="step-num">STEP 0</div>
496
+ <div class="step-name">Pre-filter</div>
497
+ <div class="step-detail">Allowlist, bots,<br>dedup check</div>
498
+ </div>
499
+ <div class="pipeline-arrow">→</div>
500
+ <div class="pipeline-step pipeline-step--sage">
501
+ <div class="step-num">STEP 1</div>
502
+ <div class="step-name">Relevance</div>
503
+ <div class="step-detail">Cheap LLM<br>boolean check</div>
504
+ </div>
505
+ <div class="pipeline-arrow">→</div>
506
+ <div class="pipeline-step pipeline-step--sage">
507
+ <div class="step-num">STEP 2</div>
508
+ <div class="step-name">Classify</div>
509
+ <div class="step-detail">JSON schema<br>validated output</div>
510
+ </div>
511
+ <div class="pipeline-arrow">→</div>
512
+ <div class="pipeline-parallel">
513
+ <div class="pipeline-step pipeline-step--orange">
514
+ <div class="step-num">STEP 3</div>
515
+ <div class="step-name">Embed</div>
516
+ <div class="step-detail">Vector embedding</div>
517
+ </div>
518
+ <div class="pipeline-step pipeline-step--teal">
519
+ <div class="step-num">STEP 5</div>
520
+ <div class="step-name">Enrich</div>
521
+ <div class="step-detail">User resolution</div>
522
+ </div>
523
+ </div>
524
+ <div class="pipeline-arrow">→</div>
525
+ <div class="pipeline-step pipeline-step--green">
526
+ <div class="step-num">STEP 4</div>
527
+ <div class="step-name">Cluster</div>
528
+ <div class="step-detail">Cosine similarity<br>+ INSERT</div>
529
+ </div>
530
+ </div>
531
+ </div>
532
+
533
+ <div class="flow-arrow" style="--i:5">
534
+ <svg viewBox="0 0 20 20"><path d="M10 4 L10 16 M6 12 L10 16 L14 12"/></svg>
535
+ stored and queryable
536
+ </div>
537
+
538
+ <!-- Database section -->
539
+ <div class="section section--orange" style="--i:6">
540
+ <div class="section-label"><span class="dot"></span> Database</div>
541
+ <div class="inner-grid">
542
+ <div class="inner-card">
543
+ <div class="title">feedback_items</div>
544
+ <div class="desc">Classification, embedding, cluster assignment, source dedup</div>
545
+ </div>
546
+ <div class="inner-card">
547
+ <div class="title">clusters</div>
548
+ <div class="desc">Centroid vectors, trends, ticket links, severity rollup</div>
549
+ </div>
550
+ </div>
551
+ </div>
552
+
553
+ <div class="flow-arrow" style="--i:7">
554
+ <svg viewBox="0 0 20 20"><path d="M10 4 L10 16 M6 12 L10 16 L14 12"/></svg>
555
+ consumed by
556
+ </div>
557
+
558
+ <!-- Three column output -->
559
+ <div class="three-col">
560
+ <div class="section section--sage" style="--i:8">
561
+ <div class="section-label"><span class="dot"></span> Agent Tools</div>
562
+ <ul class="node-list">
563
+ <li><code>search</code> semantic vector search</li>
564
+ <li><code>clusters</code> browse and filter</li>
565
+ <li><code>stats</code> aggregate metrics</li>
566
+ </ul>
567
+ </div>
568
+ <div class="section section--plum" style="--i:9">
569
+ <div class="section-label"><span class="dot"></span> Actions</div>
570
+ <ul class="node-list">
571
+ <li>Create tickets from clusters</li>
572
+ <li>Notify customers on ship</li>
573
+ <li>Generate release notes</li>
574
+ </ul>
575
+ </div>
576
+ <div class="section section--teal" style="--i:10">
577
+ <div class="section-label"><span class="dot"></span> Dashboard</div>
578
+ <ul class="node-list">
579
+ <li>Metrics overview</li>
580
+ <li>Feedback stream</li>
581
+ <li>NL chat interface</li>
582
+ </ul>
583
+ </div>
584
+ </div>
585
+
586
+ <!-- Callout — recessed depth for secondary info -->
587
+ <div class="callout section section--recessed" style="--i:11">
588
+ <strong>Multi-tenant</strong> &mdash; Each agent gets an isolated database at
589
+ <code>{agentDir}/intelligence/feedback.db</code> with per-agent config overlay
590
+ and credential isolation.
591
+ </div>
592
+
593
+ </div>
594
+
595
+ </body>
596
+ </html>