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/mermaid-flowchart.html ADDED
@@ -0,0 +1,435 @@
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>CI/CD Pipeline — Reference Template</title>
7
+ <!--
8
+ Reference template for the visual-explainer skill: Mermaid diagrams.
9
+ Teal/cyan palette — distinctly different from terracotta (architecture)
10
+ and rose (data-table) templates so agents absorb variety.
11
+ Key patterns demonstrated:
12
+ - Teal/cyan palette (NOT indigo/violet)
13
+ - Dot-grid background atmosphere (different from radial gradient)
14
+ - Large heading (38px) for typographic contrast
15
+ - ESM import of Mermaid + @mermaid-js/layout-elk
16
+ - Mermaid theme: 'base' + full themeVariables, fontSize: 16px
17
+ - CSS overrides: .nodeLabel 16px, .edgeLabel 13px
18
+ - look: 'classic' for clean lines
19
+ - layout: 'elk' for better node positioning
20
+ - Zoom controls with scroll-to-zoom and drag-to-pan
21
+ - Both light and dark themes via prefers-color-scheme
22
+ - Staggered fade-in, reduced motion respect
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=Bricolage+Grotesque:wght@400;500;600;700&family=Fragment+Mono:wght@400&display=swap" rel="stylesheet">
27
+ <style>
28
+ /* ============ THEME ============ */
29
+ :root {
30
+ --font-body: 'Bricolage Grotesque', system-ui, sans-serif;
31
+ --font-mono: 'Fragment Mono', 'SF Mono', Consolas, monospace;
32
+
33
+ --bg: #f0fdfa;
34
+ --surface: #ffffff;
35
+ --surface2: #e6f7f3;
36
+ --border: rgba(0, 0, 0, 0.07);
37
+ --border-bright: rgba(0, 0, 0, 0.14);
38
+ --text: #134e4a;
39
+ --text-dim: #5f8a85;
40
+
41
+ --primary: #0d9488;
42
+ --primary-dim: rgba(13, 148, 136, 0.08);
43
+ --secondary: #0369a1;
44
+ --secondary-dim: rgba(3, 105, 161, 0.08);
45
+ --tertiary: #d97706;
46
+ --tertiary-dim: rgba(217, 119, 6, 0.08);
47
+ --danger: #dc2626;
48
+ --danger-dim: rgba(220, 38, 38, 0.08);
49
+ }
50
+
51
+ @media (prefers-color-scheme: dark) {
52
+ :root {
53
+ --bg: #042f2e;
54
+ --surface: #0a3d3a;
55
+ --surface2: #115e59;
56
+ --border: rgba(255, 255, 255, 0.08);
57
+ --border-bright: rgba(255, 255, 255, 0.14);
58
+ --text: #ccfbf1;
59
+ --text-dim: #5eead4;
60
+
61
+ --primary: #2dd4bf;
62
+ --primary-dim: rgba(45, 212, 191, 0.14);
63
+ --secondary: #38bdf8;
64
+ --secondary-dim: rgba(56, 189, 248, 0.12);
65
+ --tertiary: #fbbf24;
66
+ --tertiary-dim: rgba(251, 191, 36, 0.12);
67
+ --danger: #f87171;
68
+ --danger-dim: rgba(248, 113, 113, 0.12);
69
+ }
70
+ }
71
+
72
+ /* ============ RESET + BASE ============ */
73
+ * { margin: 0; padding: 0; box-sizing: border-box; }
74
+
75
+ body {
76
+ background-color: var(--bg);
77
+ background-image: radial-gradient(circle, var(--border) 1px, transparent 1px);
78
+ background-size: 24px 24px;
79
+ color: var(--text);
80
+ font-family: var(--font-body);
81
+ padding: 40px;
82
+ min-height: 100vh;
83
+ }
84
+
85
+ /* ============ ANIMATION ============ */
86
+ @keyframes fadeUp {
87
+ from { opacity: 0; transform: translateY(12px); }
88
+ to { opacity: 1; transform: translateY(0); }
89
+ }
90
+
91
+ .animate {
92
+ animation: fadeUp 0.4s ease-out both;
93
+ animation-delay: calc(var(--i, 0) * 0.06s);
94
+ }
95
+
96
+ @media (prefers-reduced-motion: reduce) {
97
+ *, *::before, *::after {
98
+ animation-duration: 0.01ms !important;
99
+ animation-delay: 0ms !important;
100
+ transition-duration: 0.01ms !important;
101
+ }
102
+ .mermaid-wrap .mermaid { transition: none; }
103
+ }
104
+
105
+ /* ============ LAYOUT ============ */
106
+ .container {
107
+ max-width: 1000px;
108
+ margin: 0 auto;
109
+ }
110
+
111
+ h1 {
112
+ font-size: 38px;
113
+ font-weight: 700;
114
+ letter-spacing: -1px;
115
+ margin-bottom: 6px;
116
+ text-wrap: balance;
117
+ }
118
+
119
+ .subtitle {
120
+ color: var(--text-dim);
121
+ font-family: var(--font-mono);
122
+ font-size: 12px;
123
+ margin-bottom: 32px;
124
+ }
125
+
126
+ .description {
127
+ font-size: 14px;
128
+ line-height: 1.7;
129
+ color: var(--text-dim);
130
+ margin-bottom: 24px;
131
+ max-width: 700px;
132
+ }
133
+
134
+ .description code {
135
+ font-family: var(--font-mono);
136
+ font-size: 12px;
137
+ background: var(--primary-dim);
138
+ color: var(--primary);
139
+ padding: 1px 5px;
140
+ border-radius: 3px;
141
+ }
142
+
143
+ /* ============ MERMAID CONTAINER ============ */
144
+ .mermaid-wrap {
145
+ position: relative;
146
+ background: var(--surface);
147
+ border: 1px solid var(--border);
148
+ border-radius: 12px;
149
+ padding: 32px 24px;
150
+ overflow: auto;
151
+ margin-bottom: 24px;
152
+ }
153
+
154
+ .mermaid-wrap .mermaid {
155
+ display: flex;
156
+ justify-content: center;
157
+ transition: transform 0.2s ease;
158
+ transform-origin: top center;
159
+ }
160
+
161
+ .zoom-controls {
162
+ position: absolute;
163
+ top: 8px;
164
+ right: 8px;
165
+ display: flex;
166
+ gap: 2px;
167
+ z-index: 10;
168
+ background: var(--surface);
169
+ border: 1px solid var(--border);
170
+ border-radius: 6px;
171
+ padding: 2px;
172
+ }
173
+
174
+ .zoom-controls button {
175
+ width: 28px;
176
+ height: 28px;
177
+ border: none;
178
+ background: transparent;
179
+ color: var(--text-dim);
180
+ font-family: var(--font-mono);
181
+ font-size: 14px;
182
+ cursor: pointer;
183
+ border-radius: 4px;
184
+ display: flex;
185
+ align-items: center;
186
+ justify-content: center;
187
+ transition: background 0.15s ease, color 0.15s ease;
188
+ }
189
+
190
+ .zoom-controls button:hover {
191
+ background: var(--border);
192
+ color: var(--text);
193
+ }
194
+
195
+ .mermaid-wrap {
196
+ scrollbar-width: thin;
197
+ scrollbar-color: var(--border) transparent;
198
+ }
199
+ .mermaid-wrap::-webkit-scrollbar { width: 6px; height: 6px; }
200
+ .mermaid-wrap::-webkit-scrollbar-track { background: transparent; }
201
+ .mermaid-wrap::-webkit-scrollbar-thumb {
202
+ background: var(--border);
203
+ border-radius: 3px;
204
+ }
205
+ .mermaid-wrap::-webkit-scrollbar-thumb:hover { background: var(--text-dim); }
206
+
207
+ .mermaid-wrap.is-zoomed { cursor: grab; }
208
+ .mermaid-wrap.is-panning { cursor: grabbing; user-select: none; }
209
+
210
+ /* ============ MERMAID SVG OVERRIDES ============ */
211
+ .mermaid .nodeLabel {
212
+ font-family: var(--font-body) !important;
213
+ font-size: 16px !important;
214
+ }
215
+
216
+ .mermaid .edgeLabel {
217
+ font-family: var(--font-mono) !important;
218
+ font-size: 13px !important;
219
+ }
220
+
221
+ .mermaid .node rect,
222
+ .mermaid .node circle,
223
+ .mermaid .node polygon {
224
+ stroke-width: 1.5px !important;
225
+ }
226
+
227
+ .mermaid .edge-pattern-solid {
228
+ stroke-width: 1.5px !important;
229
+ }
230
+
231
+ /* ============ LEGEND ============ */
232
+ .legend {
233
+ display: flex;
234
+ gap: 20px;
235
+ flex-wrap: wrap;
236
+ }
237
+
238
+ .legend-item {
239
+ display: flex;
240
+ align-items: center;
241
+ gap: 6px;
242
+ font-family: var(--font-mono);
243
+ font-size: 11px;
244
+ color: var(--text-dim);
245
+ }
246
+
247
+ .legend-swatch {
248
+ width: 12px;
249
+ height: 12px;
250
+ border-radius: 3px;
251
+ }
252
+
253
+ /* ============ CALLOUT ============ */
254
+ .callout {
255
+ background: var(--surface);
256
+ border: 1px solid var(--border);
257
+ border-left: 3px solid var(--primary);
258
+ border-radius: 0 10px 10px 0;
259
+ padding: 16px 20px;
260
+ font-size: 13px;
261
+ line-height: 1.6;
262
+ color: var(--text-dim);
263
+ margin-top: 24px;
264
+ }
265
+
266
+ .callout strong { color: var(--text); }
267
+
268
+ .callout code {
269
+ font-family: var(--font-mono);
270
+ font-size: 11px;
271
+ background: var(--primary-dim);
272
+ color: var(--primary);
273
+ padding: 1px 5px;
274
+ border-radius: 3px;
275
+ }
276
+
277
+ /* ============ RESPONSIVE ============ */
278
+ @media (max-width: 768px) {
279
+ body { padding: 16px; }
280
+ h1 { font-size: 22px; }
281
+ .mermaid-wrap { padding: 16px 12px; }
282
+ }
283
+ </style>
284
+ </head>
285
+ <body>
286
+
287
+ <div class="container">
288
+
289
+ <h1 class="animate" style="--i:0">CI/CD Pipeline</h1>
290
+ <p class="subtitle animate" style="--i:1">github actions &rarr; staging &rarr; production</p>
291
+
292
+ <p class="description animate" style="--i:2">
293
+ Every push to <code>main</code> triggers the full pipeline. Tests and linting run in parallel,
294
+ then the build step produces a Docker image. Staging deploys automatically; production requires
295
+ manual approval via a GitHub environment gate.
296
+ </p>
297
+
298
+ <div class="mermaid-wrap animate" style="--i:3">
299
+ <div class="zoom-controls">
300
+ <button onclick="zoomDiagram(this, 1.2)" title="Zoom in">+</button>
301
+ <button onclick="zoomDiagram(this, 0.8)" title="Zoom out">&minus;</button>
302
+ <button onclick="resetZoom(this)" title="Reset zoom">&#8634;</button>
303
+ </div>
304
+ <pre class="mermaid">
305
+ graph TD
306
+ A[Push to main] --> B{Branch?}
307
+ B -->|main| C[Run Tests]
308
+ B -->|feature| I[Run Tests]
309
+ I --> J[Preview Deploy]
310
+ C --> D[Lint + Type Check]
311
+ C --> E[Unit Tests]
312
+ C --> F[Integration Tests]
313
+ D --> G[Build Docker Image]
314
+ E --> G
315
+ F --> G
316
+ G --> H[Deploy to Staging]
317
+ H --> K{Smoke Tests Pass?}
318
+ K -->|Yes| L[Manual Approval]
319
+ K -->|No| M[Alert + Rollback]
320
+ L --> N[Deploy to Production]
321
+ N --> O[Health Check]
322
+ O --> P[Done]
323
+ </pre>
324
+ </div>
325
+
326
+ <div class="legend animate" style="--i:4">
327
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--primary)"></div> Automated step</div>
328
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--tertiary)"></div> Decision gate</div>
329
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--danger)"></div> Failure path</div>
330
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--secondary)"></div> Success</div>
331
+ </div>
332
+
333
+ <div class="callout animate" style="--i:5">
334
+ <strong>ELK layout.</strong> The <code>layout: 'elk'</code> engine provides better node positioning
335
+ for complex graphs — it requires the separate <code>@mermaid-js/layout-elk</code> package (imported above).
336
+ Without it, Mermaid silently falls back to dagre.
337
+ </div>
338
+
339
+ </div>
340
+
341
+ <script type="module">
342
+ import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
343
+ import elkLayouts from 'https://cdn.jsdelivr.net/npm/@mermaid-js/layout-elk/dist/mermaid-layout-elk.esm.min.mjs';
344
+
345
+ const isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
346
+
347
+ mermaid.registerLayoutLoaders(elkLayouts);
348
+ mermaid.initialize({
349
+ startOnLoad: true,
350
+ theme: 'base',
351
+ look: 'classic',
352
+ layout: 'elk',
353
+ themeVariables: {
354
+ primaryColor: isDark ? '#115e59' : '#ccfbf1',
355
+ primaryBorderColor: isDark ? '#2dd4bf' : '#0d9488',
356
+ primaryTextColor: isDark ? '#ccfbf1' : '#134e4a',
357
+ secondaryColor: isDark ? '#0c4a6e' : '#e0f2fe',
358
+ secondaryBorderColor: isDark ? '#38bdf8' : '#0369a1',
359
+ secondaryTextColor: isDark ? '#ccfbf1' : '#134e4a',
360
+ tertiaryColor: isDark ? '#2e2618' : '#fffbeb',
361
+ tertiaryBorderColor: isDark ? '#fbbf24' : '#d97706',
362
+ tertiaryTextColor: isDark ? '#ccfbf1' : '#134e4a',
363
+ lineColor: isDark ? '#5eead4' : '#5f8a85',
364
+ fontSize: '16px',
365
+ fontFamily: "'Bricolage Grotesque', system-ui, sans-serif",
366
+ noteBkgColor: isDark ? '#115e59' : '#fefce8',
367
+ noteTextColor: isDark ? '#ccfbf1' : '#134e4a',
368
+ noteBorderColor: isDark ? '#fbbf24' : '#d97706',
369
+ }
370
+ });
371
+ </script>
372
+ <script>
373
+ function updateZoomState(wrap) {
374
+ var target = wrap.querySelector('.mermaid');
375
+ var zoom = parseFloat(target.dataset.zoom || '1');
376
+ wrap.classList.toggle('is-zoomed', zoom > 1);
377
+ }
378
+
379
+ function zoomDiagram(btn, factor) {
380
+ var wrap = btn.closest('.mermaid-wrap');
381
+ var target = wrap.querySelector('.mermaid');
382
+ var current = parseFloat(target.dataset.zoom || '1');
383
+ var next = Math.min(Math.max(current * factor, 0.3), 5);
384
+ target.dataset.zoom = next;
385
+ target.style.transform = 'scale(' + next + ')';
386
+ updateZoomState(wrap);
387
+ }
388
+
389
+ function resetZoom(btn) {
390
+ var wrap = btn.closest('.mermaid-wrap');
391
+ var target = wrap.querySelector('.mermaid');
392
+ target.dataset.zoom = '1';
393
+ target.style.transform = 'scale(1)';
394
+ updateZoomState(wrap);
395
+ }
396
+
397
+ document.querySelectorAll('.mermaid-wrap').forEach(function(wrap) {
398
+ // Scroll-to-zoom (Ctrl/Cmd + wheel)
399
+ wrap.addEventListener('wheel', function(e) {
400
+ if (!e.ctrlKey && !e.metaKey) return;
401
+ e.preventDefault();
402
+ var target = wrap.querySelector('.mermaid');
403
+ var current = parseFloat(target.dataset.zoom || '1');
404
+ var factor = e.deltaY < 0 ? 1.1 : 0.9;
405
+ var next = Math.min(Math.max(current * factor, 0.3), 5);
406
+ target.dataset.zoom = next;
407
+ target.style.transform = 'scale(' + next + ')';
408
+ updateZoomState(wrap);
409
+ }, { passive: false });
410
+
411
+ // Drag-to-pan
412
+ var startX, startY, scrollL, scrollT;
413
+ wrap.addEventListener('mousedown', function(e) {
414
+ if (e.target.closest('.zoom-controls')) return;
415
+ var target = wrap.querySelector('.mermaid');
416
+ if (parseFloat(target.dataset.zoom || '1') <= 1) return;
417
+ wrap.classList.add('is-panning');
418
+ startX = e.clientX;
419
+ startY = e.clientY;
420
+ scrollL = wrap.scrollLeft;
421
+ scrollT = wrap.scrollTop;
422
+ });
423
+ window.addEventListener('mousemove', function(e) {
424
+ if (!wrap.classList.contains('is-panning')) return;
425
+ wrap.scrollLeft = scrollL - (e.clientX - startX);
426
+ wrap.scrollTop = scrollT - (e.clientY - startY);
427
+ });
428
+ window.addEventListener('mouseup', function() {
429
+ wrap.classList.remove('is-panning');
430
+ });
431
+ });
432
+ </script>
433
+
434
+ </body>
435
+ </html>