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/data-table.html ADDED
@@ -0,0 +1,540 @@
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>Requirements Audit — Reference Template</title>
7
+ <!--
8
+ Reference template for the visual-explainer skill: data tables.
9
+ Rose/cranberry palette — distinctly different from terracotta (architecture)
10
+ and teal (mermaid) templates so agents absorb variety.
11
+ Key patterns demonstrated:
12
+ - Rose/cranberry palette (NOT indigo/violet)
13
+ - KPI summary cards above the table (visual hook before the data)
14
+ - Collapsible <details> section (replaces static callout)
15
+ - Depth tiers: elevated KPIs, default table, collapsible for secondary
16
+ - Real <table> element with sticky header, alternating rows
17
+ - Status indicator badges (match, gap, partial)
18
+ - Text wrapping in wide columns, code references in cells
19
+ - Summary footer row with aggregate status
20
+ - Staggered row animation via --i variable
21
+ - Both light and dark themes via prefers-color-scheme
22
+ - Responsive horizontal scroll wrapper
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=Instrument+Serif&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
27
+ <style>
28
+ /* ============ THEME ============ */
29
+ :root {
30
+ --font-body: 'Instrument Serif', 'Georgia', serif;
31
+ --font-mono: 'JetBrains Mono', 'SF Mono', Consolas, monospace;
32
+ --font-sans: system-ui, -apple-system, sans-serif;
33
+
34
+ --bg: #fff5f5;
35
+ --surface: #ffffff;
36
+ --surface2: #fef0ee;
37
+ --surface-elevated: #fff8f7;
38
+ --border: rgba(0, 0, 0, 0.07);
39
+ --border-bright: rgba(0, 0, 0, 0.14);
40
+ --text: #1c1917;
41
+ --text-dim: #78716c;
42
+ --accent: #be123c;
43
+ --accent-dim: rgba(190, 18, 60, 0.06);
44
+ --green: #16a34a;
45
+ --green-dim: rgba(22, 163, 74, 0.08);
46
+ --red: #dc2626;
47
+ --red-dim: rgba(220, 38, 38, 0.08);
48
+ --orange: #d97706;
49
+ --orange-dim: rgba(217, 119, 6, 0.08);
50
+ }
51
+
52
+ @media (prefers-color-scheme: dark) {
53
+ :root {
54
+ --bg: #1a0a0a;
55
+ --surface: #231414;
56
+ --surface2: #2e1b1b;
57
+ --surface-elevated: #351f1f;
58
+ --border: rgba(255, 255, 255, 0.06);
59
+ --border-bright: rgba(255, 255, 255, 0.12);
60
+ --text: #fde2e2;
61
+ --text-dim: #c9a3a3;
62
+ --accent: #fb7185;
63
+ --accent-dim: rgba(251, 113, 133, 0.12);
64
+ --green: #4ade80;
65
+ --green-dim: rgba(74, 222, 128, 0.1);
66
+ --red: #f87171;
67
+ --red-dim: rgba(248, 113, 113, 0.1);
68
+ --orange: #fbbf24;
69
+ --orange-dim: rgba(251, 191, 36, 0.1);
70
+ }
71
+ }
72
+
73
+ /* ============ RESET + BASE ============ */
74
+ * { margin: 0; padding: 0; box-sizing: border-box; }
75
+
76
+ body {
77
+ background: var(--bg);
78
+ background-image:
79
+ radial-gradient(ellipse at 30% 0%, var(--accent-dim) 0%, transparent 50%),
80
+ radial-gradient(ellipse at 70% 100%, var(--green-dim) 0%, transparent 40%);
81
+ color: var(--text);
82
+ font-family: var(--font-sans);
83
+ padding: 40px;
84
+ min-height: 100vh;
85
+ }
86
+
87
+ /* ============ ANIMATION ============ */
88
+ @keyframes fadeUp {
89
+ from { opacity: 0; transform: translateY(10px); }
90
+ to { opacity: 1; transform: translateY(0); }
91
+ }
92
+
93
+ .animate {
94
+ animation: fadeUp 0.35s ease-out both;
95
+ animation-delay: calc(var(--i, 0) * 0.04s);
96
+ }
97
+
98
+ @media (prefers-reduced-motion: reduce) {
99
+ *, *::before, *::after {
100
+ animation-duration: 0.01ms !important;
101
+ animation-delay: 0ms !important;
102
+ transition-duration: 0.01ms !important;
103
+ }
104
+ }
105
+
106
+ /* ============ CONTAINER ============ */
107
+ .container {
108
+ max-width: 1000px;
109
+ margin: 0 auto;
110
+ }
111
+
112
+ /* ============ HEADER ============ */
113
+ h1 {
114
+ font-family: var(--font-body);
115
+ font-size: 32px;
116
+ font-weight: 400;
117
+ letter-spacing: -0.3px;
118
+ margin-bottom: 6px;
119
+ }
120
+
121
+ .subtitle {
122
+ color: var(--text-dim);
123
+ font-family: var(--font-mono);
124
+ font-size: 12px;
125
+ margin-bottom: 32px;
126
+ }
127
+
128
+ /* ============ LEGEND ============ */
129
+ .legend {
130
+ display: flex;
131
+ gap: 16px;
132
+ flex-wrap: wrap;
133
+ margin-bottom: 20px;
134
+ }
135
+
136
+ .legend-item {
137
+ display: flex;
138
+ align-items: center;
139
+ gap: 6px;
140
+ font-family: var(--font-mono);
141
+ font-size: 11px;
142
+ color: var(--text-dim);
143
+ }
144
+
145
+ .legend-swatch {
146
+ width: 10px;
147
+ height: 10px;
148
+ border-radius: 3px;
149
+ }
150
+
151
+ /* ============ TABLE WRAPPER ============ */
152
+ .table-wrap {
153
+ background: var(--surface);
154
+ border: 1px solid var(--border);
155
+ border-radius: 12px;
156
+ overflow: hidden;
157
+ margin-bottom: 24px;
158
+ }
159
+
160
+ .table-scroll {
161
+ overflow-x: auto;
162
+ -webkit-overflow-scrolling: touch;
163
+ }
164
+
165
+ /* ============ TABLE ============ */
166
+ .data-table {
167
+ width: 100%;
168
+ border-collapse: collapse;
169
+ font-size: 13px;
170
+ line-height: 1.55;
171
+ }
172
+
173
+ /* Header */
174
+ .data-table thead {
175
+ position: sticky;
176
+ top: 0;
177
+ z-index: 2;
178
+ }
179
+
180
+ .data-table th {
181
+ background: var(--surface2);
182
+ font-family: var(--font-mono);
183
+ font-size: 10px;
184
+ font-weight: 600;
185
+ text-transform: uppercase;
186
+ letter-spacing: 1.2px;
187
+ color: var(--text-dim);
188
+ text-align: left;
189
+ padding: 14px 16px;
190
+ border-bottom: 2px solid var(--border-bright);
191
+ white-space: nowrap;
192
+ }
193
+
194
+ /* Cells */
195
+ .data-table td {
196
+ padding: 14px 16px;
197
+ border-bottom: 1px solid var(--border);
198
+ vertical-align: top;
199
+ }
200
+
201
+ .data-table tbody tr:last-child td {
202
+ border-bottom: none;
203
+ }
204
+
205
+ /* Wide text column */
206
+ .data-table .wide {
207
+ min-width: 220px;
208
+ max-width: 440px;
209
+ }
210
+
211
+ /* Alternating rows */
212
+ .data-table tbody tr:nth-child(even) {
213
+ background: var(--accent-dim);
214
+ }
215
+
216
+ /* Row hover + animation stagger */
217
+ .data-table tbody tr {
218
+ transition: background 0.15s ease;
219
+ animation: fadeUp 0.35s ease-out both;
220
+ animation-delay: calc(var(--i, 0) * 0.04s);
221
+ }
222
+
223
+ .data-table tbody tr:hover {
224
+ background: var(--border);
225
+ }
226
+
227
+ /* Code in cells */
228
+ .data-table code {
229
+ font-family: var(--font-mono);
230
+ font-size: 11px;
231
+ background: var(--accent-dim);
232
+ color: var(--accent);
233
+ padding: 1px 5px;
234
+ border-radius: 3px;
235
+ }
236
+
237
+ /* Secondary text */
238
+ .data-table small {
239
+ display: block;
240
+ color: var(--text-dim);
241
+ font-size: 11px;
242
+ margin-top: 3px;
243
+ }
244
+
245
+ /* ============ STATUS BADGES ============ */
246
+ .status {
247
+ display: inline-flex;
248
+ align-items: center;
249
+ gap: 5px;
250
+ font-family: var(--font-mono);
251
+ font-size: 10px;
252
+ font-weight: 600;
253
+ padding: 3px 10px;
254
+ border-radius: 6px;
255
+ white-space: nowrap;
256
+ letter-spacing: 0.3px;
257
+ }
258
+
259
+ .status--match {
260
+ background: var(--green-dim);
261
+ color: var(--green);
262
+ }
263
+
264
+ .status--gap {
265
+ background: var(--red-dim);
266
+ color: var(--red);
267
+ }
268
+
269
+ .status--partial {
270
+ background: var(--orange-dim);
271
+ color: var(--orange);
272
+ }
273
+
274
+ /* Dot before status text */
275
+ .status::before {
276
+ content: '';
277
+ width: 6px;
278
+ height: 6px;
279
+ border-radius: 50%;
280
+ background: currentColor;
281
+ }
282
+
283
+ /* ============ FOOTER ROW ============ */
284
+ .data-table tfoot td {
285
+ background: var(--surface2);
286
+ font-weight: 600;
287
+ font-family: var(--font-mono);
288
+ font-size: 12px;
289
+ border-top: 2px solid var(--border-bright);
290
+ border-bottom: none;
291
+ padding: 14px 16px;
292
+ }
293
+
294
+ /* ============ KPI SUMMARY ============ */
295
+ .kpi-row {
296
+ display: grid;
297
+ grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
298
+ gap: 14px;
299
+ margin-bottom: 20px;
300
+ }
301
+
302
+ .kpi-card {
303
+ background: var(--surface-elevated, var(--surface));
304
+ border: 1px solid var(--border);
305
+ border-radius: 10px;
306
+ padding: 18px;
307
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05);
308
+ }
309
+
310
+ .kpi-card__value {
311
+ font-family: var(--font-body);
312
+ font-size: 32px;
313
+ font-weight: 400;
314
+ line-height: 1.1;
315
+ font-variant-numeric: tabular-nums;
316
+ }
317
+
318
+ .kpi-card__value--green { color: var(--green); }
319
+ .kpi-card__value--red { color: var(--red); }
320
+ .kpi-card__value--orange { color: var(--orange); }
321
+
322
+ .kpi-card__label {
323
+ font-family: var(--font-mono);
324
+ font-size: 10px;
325
+ font-weight: 600;
326
+ text-transform: uppercase;
327
+ letter-spacing: 1.2px;
328
+ color: var(--text-dim);
329
+ margin-top: 6px;
330
+ }
331
+
332
+ /* ============ COLLAPSIBLE ============ */
333
+ details.collapsible {
334
+ border: 1px solid var(--border);
335
+ border-radius: 10px;
336
+ overflow: hidden;
337
+ }
338
+
339
+ details.collapsible summary {
340
+ padding: 14px 20px;
341
+ background: var(--surface);
342
+ font-family: var(--font-mono);
343
+ font-size: 12px;
344
+ font-weight: 600;
345
+ cursor: pointer;
346
+ list-style: none;
347
+ display: flex;
348
+ align-items: center;
349
+ gap: 8px;
350
+ color: var(--text);
351
+ transition: background 0.15s ease;
352
+ }
353
+
354
+ details.collapsible summary:hover {
355
+ background: var(--surface-elevated, var(--surface));
356
+ }
357
+
358
+ details.collapsible summary::-webkit-details-marker { display: none; }
359
+
360
+ details.collapsible summary::before {
361
+ content: '▸';
362
+ font-size: 11px;
363
+ color: var(--text-dim);
364
+ transition: transform 0.15s ease;
365
+ }
366
+
367
+ details.collapsible[open] summary::before {
368
+ transform: rotate(90deg);
369
+ }
370
+
371
+ details.collapsible .collapsible__body {
372
+ padding: 16px 20px;
373
+ border-top: 1px solid var(--border);
374
+ font-size: 13px;
375
+ line-height: 1.6;
376
+ color: var(--text-dim);
377
+ }
378
+
379
+ details.collapsible .collapsible__body strong {
380
+ color: var(--text);
381
+ font-weight: 600;
382
+ }
383
+
384
+ details.collapsible .collapsible__body code {
385
+ font-family: var(--font-mono);
386
+ font-size: 11px;
387
+ background: var(--accent-dim);
388
+ color: var(--accent);
389
+ padding: 1px 5px;
390
+ border-radius: 3px;
391
+ }
392
+
393
+ /* ============ RESPONSIVE ============ */
394
+ @media (max-width: 768px) {
395
+ body { padding: 16px; }
396
+ h1 { font-size: 24px; }
397
+ .data-table th,
398
+ .data-table td { padding: 10px 12px; }
399
+ }
400
+ </style>
401
+ </head>
402
+ <body>
403
+
404
+ <div class="container">
405
+
406
+ <h1 class="animate" style="--i:0">Requirements Audit</h1>
407
+ <p class="subtitle animate" style="--i:1">victoria's email vs. implementation plan &mdash; point-by-point review</p>
408
+
409
+ <div class="kpi-row animate" style="--i:2">
410
+ <div class="kpi-card">
411
+ <div class="kpi-card__value">14</div>
412
+ <div class="kpi-card__label">Items Reviewed</div>
413
+ </div>
414
+ <div class="kpi-card">
415
+ <div class="kpi-card__value kpi-card__value--green">13</div>
416
+ <div class="kpi-card__label">Match</div>
417
+ </div>
418
+ <div class="kpi-card">
419
+ <div class="kpi-card__value kpi-card__value--red">1</div>
420
+ <div class="kpi-card__label">Gap</div>
421
+ </div>
422
+ <div class="kpi-card">
423
+ <div class="kpi-card__value" style="color:var(--accent)">93%</div>
424
+ <div class="kpi-card__label">Coverage</div>
425
+ </div>
426
+ </div>
427
+
428
+ <div class="legend animate" style="--i:3">
429
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--green)"></div> Match</div>
430
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--red)"></div> Gap</div>
431
+ <div class="legend-item"><div class="legend-swatch" style="background:var(--orange)"></div> Partial</div>
432
+ </div>
433
+
434
+ <div class="table-wrap animate" style="--i:4">
435
+ <div class="table-scroll">
436
+ <table class="data-table">
437
+ <thead>
438
+ <tr>
439
+ <th class="wide">Request</th>
440
+ <th class="wide">Plan</th>
441
+ <th>Status</th>
442
+ </tr>
443
+ </thead>
444
+ <tbody>
445
+ <tr style="--i:4">
446
+ <td class="wide">Template: <code>yoth-special-edition</code> only</td>
447
+ <td class="wide">Plan scopes everything to this template.</td>
448
+ <td><span class="status status--match">Match</span></td>
449
+ </tr>
450
+ <tr style="--i:5">
451
+ <td class="wide">EOD tomorrow (Friday), Tuesday AM launch</td>
452
+ <td class="wide">Plan header says same.</td>
453
+ <td><span class="status status--match">Match</span></td>
454
+ </tr>
455
+ <tr style="--i:6">
456
+ <td class="wide">Update BIS button label and pop up text</td>
457
+ <td class="wide">Button text + modal description configurable via settings.</td>
458
+ <td><span class="status status--match">Match</span></td>
459
+ </tr>
460
+ <tr style="--i:7">
461
+ <td class="wide">Use Stoq's API to trigger events</td>
462
+ <td class="wide">Uses <code>openInlineForm</code>, <code>openModal</code>, <code>removeInlineForm</code>.</td>
463
+ <td><span class="status status--match">Match</span></td>
464
+ </tr>
465
+ <tr style="--i:8">
466
+ <td class="wide">Custom button + modal with text settings in buy buttons block</td>
467
+ <td class="wide">Schema settings in <code>buy_buttons</code> block.</td>
468
+ <td><span class="status status--match">Match</span></td>
469
+ </tr>
470
+ <tr style="--i:9">
471
+ <td class="wide">Default values = current behavior when empty</td>
472
+ <td class="wide">Blank settings = Stoq default "Notify Me" behavior.</td>
473
+ <td><span class="status status--match">Match</span></td>
474
+ </tr>
475
+ <tr style="--i:10">
476
+ <td class="wide">Only display for OOS variants</td>
477
+ <td class="wide">DOM-based sold-out detection.</td>
478
+ <td><span class="status status--match">Match</span></td>
479
+ </tr>
480
+ <tr style="--i:11">
481
+ <td class="wide">Exclude products with <code>excludebis</code> tag</td>
482
+ <td class="wide">Checked in both PDP and PLP Liquid.</td>
483
+ <td><span class="status status--match">Match</span></td>
484
+ </tr>
485
+ <tr style="--i:12">
486
+ <td class="wide"><code>openInlineForm</code> to load Stoq form in modal</td>
487
+ <td class="wide">PDP modal uses <code>openInlineForm</code>.</td>
488
+ <td><span class="status status--match">Match</span></td>
489
+ </tr>
490
+ <tr style="--i:13">
491
+ <td class="wide">Updated Button Label: "Join the waitlist"</td>
492
+ <td class="wide">Pre-populated in template JSON.</td>
493
+ <td><span class="status status--match">Match</span></td>
494
+ </tr>
495
+ <tr style="--i:14">
496
+ <td class="wide">Updated Pop Up Text: "Sign up to be notified when we restock this or other embroidered styles."</td>
497
+ <td class="wide"><code>bis_modal_description</code> setting.</td>
498
+ <td><span class="status status--match">Match</span></td>
499
+ </tr>
500
+ <tr style="--i:15">
501
+ <td class="wide">Theme: Huha 2.0 - Giddy Up Collection D2C Launch</td>
502
+ <td class="wide">Clone ID <code>145580556374</code>.</td>
503
+ <td><span class="status status--match">Match</span></td>
504
+ </tr>
505
+ <tr style="--i:16">
506
+ <td class="wide">Changes made locally</td>
507
+ <td class="wide">Local dev + theme push.</td>
508
+ <td><span class="status status--match">Match</span></td>
509
+ </tr>
510
+ <tr style="--i:17">
511
+ <td class="wide">Run <code>stoq:restock-modal:submitted</code> when form is submitted</td>
512
+ <td class="wide">Not mentioned in plan.
513
+ <small>When using <code>openInlineForm</code> inside a custom modal, unclear if Stoq fires this event automatically or if manual dispatch is needed.</small>
514
+ </td>
515
+ <td><span class="status status--gap">Gap</span></td>
516
+ </tr>
517
+ </tbody>
518
+ <tfoot>
519
+ <tr>
520
+ <td>14 items reviewed</td>
521
+ <td></td>
522
+ <td>13 match &middot; 1 gap</td>
523
+ </tr>
524
+ </tfoot>
525
+ </table>
526
+ </div>
527
+ </div>
528
+
529
+ <details class="collapsible animate" style="--i:19">
530
+ <summary>Gap Analysis Detail</summary>
531
+ <div class="collapsible__body">
532
+ <strong>Gap: <code>stoq:restock-modal:submitted</code> event.</strong>
533
+ Michael explicitly requests firing this event on form submission. The plan uses Stoq's <code>openInlineForm</code> inside a custom modal, but doesn't address whether Stoq dispatches this event automatically in that context. If other integrations (Klaviyo, analytics, theme JS) listen for it, missing it could silently break the submission pipeline. Recommend adding an explicit <code>dispatchEvent</code> call as a safety net.
534
+ </div>
535
+ </details>
536
+
537
+ </div>
538
+
539
+ </body>
540
+ </html>