@planu/cli 0.90.2 → 0.92.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 (913) hide show
  1. package/dist/config/domain-best-practices.json +413 -0
  2. package/dist/config/ide-registry.json +25 -0
  3. package/dist/config/license-plans.json +61 -2
  4. package/dist/engine/ai-integration/agent-frameworks/autogen-exporter.d.ts +11 -0
  5. package/dist/engine/ai-integration/agent-frameworks/autogen-exporter.d.ts.map +1 -0
  6. package/dist/engine/ai-integration/agent-frameworks/autogen-exporter.js +52 -0
  7. package/dist/engine/ai-integration/agent-frameworks/autogen-exporter.js.map +1 -0
  8. package/dist/engine/ai-integration/agent-frameworks/crewai-exporter.d.ts +11 -0
  9. package/dist/engine/ai-integration/agent-frameworks/crewai-exporter.d.ts.map +1 -0
  10. package/dist/engine/ai-integration/agent-frameworks/crewai-exporter.js +89 -0
  11. package/dist/engine/ai-integration/agent-frameworks/crewai-exporter.js.map +1 -0
  12. package/dist/engine/ai-integration/agent-frameworks/index.d.ts +4 -0
  13. package/dist/engine/ai-integration/agent-frameworks/index.d.ts.map +1 -0
  14. package/dist/engine/ai-integration/agent-frameworks/index.js +5 -0
  15. package/dist/engine/ai-integration/agent-frameworks/index.js.map +1 -0
  16. package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.d.ts +11 -0
  17. package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.d.ts.map +1 -0
  18. package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.js +71 -0
  19. package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.js.map +1 -0
  20. package/dist/engine/ai-integration/agents-md/generator.d.ts +11 -0
  21. package/dist/engine/ai-integration/agents-md/generator.d.ts.map +1 -0
  22. package/dist/engine/ai-integration/agents-md/generator.js +139 -0
  23. package/dist/engine/ai-integration/agents-md/generator.js.map +1 -0
  24. package/dist/engine/ai-integration/agents-md/index.d.ts +3 -0
  25. package/dist/engine/ai-integration/agents-md/index.d.ts.map +1 -0
  26. package/dist/engine/ai-integration/agents-md/index.js +4 -0
  27. package/dist/engine/ai-integration/agents-md/index.js.map +1 -0
  28. package/dist/engine/ai-integration/agents-md/updater.d.ts +10 -0
  29. package/dist/engine/ai-integration/agents-md/updater.d.ts.map +1 -0
  30. package/dist/engine/ai-integration/agents-md/updater.js +33 -0
  31. package/dist/engine/ai-integration/agents-md/updater.js.map +1 -0
  32. package/dist/engine/ai-integration/aider/aider-config-generator.d.ts +5 -0
  33. package/dist/engine/ai-integration/aider/aider-config-generator.d.ts.map +1 -0
  34. package/dist/engine/ai-integration/aider/aider-config-generator.js +34 -0
  35. package/dist/engine/ai-integration/aider/aider-config-generator.js.map +1 -0
  36. package/dist/engine/ai-integration/cline/clinerules-generator.d.ts +5 -0
  37. package/dist/engine/ai-integration/cline/clinerules-generator.d.ts.map +1 -0
  38. package/dist/engine/ai-integration/cline/clinerules-generator.js +86 -0
  39. package/dist/engine/ai-integration/cline/clinerules-generator.js.map +1 -0
  40. package/dist/engine/ai-integration/cline/index.d.ts +3 -0
  41. package/dist/engine/ai-integration/cline/index.d.ts.map +1 -0
  42. package/dist/engine/ai-integration/cline/index.js +3 -0
  43. package/dist/engine/ai-integration/cline/index.js.map +1 -0
  44. package/dist/engine/ai-integration/codex/agent-roles-generator.d.ts +12 -0
  45. package/dist/engine/ai-integration/codex/agent-roles-generator.d.ts.map +1 -0
  46. package/dist/engine/ai-integration/codex/agent-roles-generator.js +62 -0
  47. package/dist/engine/ai-integration/codex/agent-roles-generator.js.map +1 -0
  48. package/dist/engine/ai-integration/codex/agents-md-generator.d.ts +10 -0
  49. package/dist/engine/ai-integration/codex/agents-md-generator.d.ts.map +1 -0
  50. package/dist/engine/ai-integration/codex/agents-md-generator.js +114 -0
  51. package/dist/engine/ai-integration/codex/agents-md-generator.js.map +1 -0
  52. package/dist/engine/ai-integration/codex/config-generator.d.ts +9 -0
  53. package/dist/engine/ai-integration/codex/config-generator.d.ts.map +1 -0
  54. package/dist/engine/ai-integration/codex/config-generator.js +66 -0
  55. package/dist/engine/ai-integration/codex/config-generator.js.map +1 -0
  56. package/dist/engine/ai-integration/codex/hooks-generator.d.ts +6 -0
  57. package/dist/engine/ai-integration/codex/hooks-generator.d.ts.map +1 -0
  58. package/dist/engine/ai-integration/codex/hooks-generator.js +55 -0
  59. package/dist/engine/ai-integration/codex/hooks-generator.js.map +1 -0
  60. package/dist/engine/ai-integration/codex/index.d.ts +5 -0
  61. package/dist/engine/ai-integration/codex/index.d.ts.map +1 -0
  62. package/dist/engine/ai-integration/codex/index.js +6 -0
  63. package/dist/engine/ai-integration/codex/index.js.map +1 -0
  64. package/dist/engine/ai-integration/continue/ai-checks-generator.d.ts +12 -0
  65. package/dist/engine/ai-integration/continue/ai-checks-generator.d.ts.map +1 -0
  66. package/dist/engine/ai-integration/continue/ai-checks-generator.js +63 -0
  67. package/dist/engine/ai-integration/continue/ai-checks-generator.js.map +1 -0
  68. package/dist/engine/ai-integration/continue/config-generator.d.ts +5 -0
  69. package/dist/engine/ai-integration/continue/config-generator.d.ts.map +1 -0
  70. package/dist/engine/ai-integration/continue/config-generator.js +56 -0
  71. package/dist/engine/ai-integration/continue/config-generator.js.map +1 -0
  72. package/dist/engine/ai-integration/continue/index.d.ts +5 -0
  73. package/dist/engine/ai-integration/continue/index.d.ts.map +1 -0
  74. package/dist/engine/ai-integration/continue/index.js +4 -0
  75. package/dist/engine/ai-integration/continue/index.js.map +1 -0
  76. package/dist/engine/ai-integration/cursor/cursorrules-generator.d.ts +5 -0
  77. package/dist/engine/ai-integration/cursor/cursorrules-generator.d.ts.map +1 -0
  78. package/dist/engine/ai-integration/cursor/cursorrules-generator.js +75 -0
  79. package/dist/engine/ai-integration/cursor/cursorrules-generator.js.map +1 -0
  80. package/dist/engine/ai-integration/detector.d.ts +5 -0
  81. package/dist/engine/ai-integration/detector.d.ts.map +1 -0
  82. package/dist/engine/ai-integration/detector.js +127 -0
  83. package/dist/engine/ai-integration/detector.js.map +1 -0
  84. package/dist/engine/ai-integration/gemini/extensions-advisor.d.ts +4 -0
  85. package/dist/engine/ai-integration/gemini/extensions-advisor.d.ts.map +1 -0
  86. package/dist/engine/ai-integration/gemini/extensions-advisor.js +64 -0
  87. package/dist/engine/ai-integration/gemini/extensions-advisor.js.map +1 -0
  88. package/dist/engine/ai-integration/gemini/gemini-md-generator.d.ts +4 -0
  89. package/dist/engine/ai-integration/gemini/gemini-md-generator.d.ts.map +1 -0
  90. package/dist/engine/ai-integration/gemini/gemini-md-generator.js +94 -0
  91. package/dist/engine/ai-integration/gemini/gemini-md-generator.js.map +1 -0
  92. package/dist/engine/ai-integration/gemini/index.d.ts +5 -0
  93. package/dist/engine/ai-integration/gemini/index.d.ts.map +1 -0
  94. package/dist/engine/ai-integration/gemini/index.js +6 -0
  95. package/dist/engine/ai-integration/gemini/index.js.map +1 -0
  96. package/dist/engine/ai-integration/gemini/policy-generator.d.ts +6 -0
  97. package/dist/engine/ai-integration/gemini/policy-generator.d.ts.map +1 -0
  98. package/dist/engine/ai-integration/gemini/policy-generator.js +63 -0
  99. package/dist/engine/ai-integration/gemini/policy-generator.js.map +1 -0
  100. package/dist/engine/ai-integration/gemini/settings-generator.d.ts +4 -0
  101. package/dist/engine/ai-integration/gemini/settings-generator.d.ts.map +1 -0
  102. package/dist/engine/ai-integration/gemini/settings-generator.js +191 -0
  103. package/dist/engine/ai-integration/gemini/settings-generator.js.map +1 -0
  104. package/dist/engine/ai-integration/github-copilot/index.d.ts +4 -0
  105. package/dist/engine/ai-integration/github-copilot/index.d.ts.map +1 -0
  106. package/dist/engine/ai-integration/github-copilot/index.js +5 -0
  107. package/dist/engine/ai-integration/github-copilot/index.js.map +1 -0
  108. package/dist/engine/ai-integration/github-copilot/instructions-generator.d.ts +5 -0
  109. package/dist/engine/ai-integration/github-copilot/instructions-generator.d.ts.map +1 -0
  110. package/dist/engine/ai-integration/github-copilot/instructions-generator.js +102 -0
  111. package/dist/engine/ai-integration/github-copilot/instructions-generator.js.map +1 -0
  112. package/dist/engine/ai-integration/github-copilot/prompt-files-generator.d.ts +11 -0
  113. package/dist/engine/ai-integration/github-copilot/prompt-files-generator.d.ts.map +1 -0
  114. package/dist/engine/ai-integration/github-copilot/prompt-files-generator.js +86 -0
  115. package/dist/engine/ai-integration/github-copilot/prompt-files-generator.js.map +1 -0
  116. package/dist/engine/ai-integration/github-copilot/workspace-bridge.d.ts +3 -0
  117. package/dist/engine/ai-integration/github-copilot/workspace-bridge.d.ts.map +1 -0
  118. package/dist/engine/ai-integration/github-copilot/workspace-bridge.js +39 -0
  119. package/dist/engine/ai-integration/github-copilot/workspace-bridge.js.map +1 -0
  120. package/dist/engine/ai-integration/kiro/hooks-generator.d.ts +6 -0
  121. package/dist/engine/ai-integration/kiro/hooks-generator.d.ts.map +1 -0
  122. package/dist/engine/ai-integration/kiro/hooks-generator.js +74 -0
  123. package/dist/engine/ai-integration/kiro/hooks-generator.js.map +1 -0
  124. package/dist/engine/ai-integration/kiro/index.d.ts +4 -0
  125. package/dist/engine/ai-integration/kiro/index.d.ts.map +1 -0
  126. package/dist/engine/ai-integration/kiro/index.js +5 -0
  127. package/dist/engine/ai-integration/kiro/index.js.map +1 -0
  128. package/dist/engine/ai-integration/kiro/spec-exporter.d.ts +6 -0
  129. package/dist/engine/ai-integration/kiro/spec-exporter.d.ts.map +1 -0
  130. package/dist/engine/ai-integration/kiro/spec-exporter.js +57 -0
  131. package/dist/engine/ai-integration/kiro/spec-exporter.js.map +1 -0
  132. package/dist/engine/ai-integration/kiro/steering-generator.d.ts +6 -0
  133. package/dist/engine/ai-integration/kiro/steering-generator.d.ts.map +1 -0
  134. package/dist/engine/ai-integration/kiro/steering-generator.js +112 -0
  135. package/dist/engine/ai-integration/kiro/steering-generator.js.map +1 -0
  136. package/dist/engine/ai-integration/mastra/agent-scaffold.d.ts +16 -0
  137. package/dist/engine/ai-integration/mastra/agent-scaffold.d.ts.map +1 -0
  138. package/dist/engine/ai-integration/mastra/agent-scaffold.js +111 -0
  139. package/dist/engine/ai-integration/mastra/agent-scaffold.js.map +1 -0
  140. package/dist/engine/ai-integration/mastra/config-generator.d.ts +12 -0
  141. package/dist/engine/ai-integration/mastra/config-generator.d.ts.map +1 -0
  142. package/dist/engine/ai-integration/mastra/config-generator.js +64 -0
  143. package/dist/engine/ai-integration/mastra/config-generator.js.map +1 -0
  144. package/dist/engine/ai-integration/mastra/index.d.ts +3 -0
  145. package/dist/engine/ai-integration/mastra/index.d.ts.map +1 -0
  146. package/dist/engine/ai-integration/mastra/index.js +4 -0
  147. package/dist/engine/ai-integration/mastra/index.js.map +1 -0
  148. package/dist/engine/ai-integration/universal-config-generator.d.ts +4 -0
  149. package/dist/engine/ai-integration/universal-config-generator.d.ts.map +1 -0
  150. package/dist/engine/ai-integration/universal-config-generator.js +87 -0
  151. package/dist/engine/ai-integration/universal-config-generator.js.map +1 -0
  152. package/dist/engine/ai-integration/windsurf/windsurfrules-generator.d.ts +5 -0
  153. package/dist/engine/ai-integration/windsurf/windsurfrules-generator.d.ts.map +1 -0
  154. package/dist/engine/ai-integration/windsurf/windsurfrules-generator.js +75 -0
  155. package/dist/engine/ai-integration/windsurf/windsurfrules-generator.js.map +1 -0
  156. package/dist/engine/api-spec-generator/ac-builder.d.ts +5 -0
  157. package/dist/engine/api-spec-generator/ac-builder.d.ts.map +1 -0
  158. package/dist/engine/api-spec-generator/ac-builder.js +114 -0
  159. package/dist/engine/api-spec-generator/ac-builder.js.map +1 -0
  160. package/dist/engine/api-spec-generator/graphql-parser.d.ts +3 -0
  161. package/dist/engine/api-spec-generator/graphql-parser.d.ts.map +1 -0
  162. package/dist/engine/api-spec-generator/graphql-parser.js +166 -0
  163. package/dist/engine/api-spec-generator/graphql-parser.js.map +1 -0
  164. package/dist/engine/api-spec-generator/openapi-parser.d.ts +3 -0
  165. package/dist/engine/api-spec-generator/openapi-parser.d.ts.map +1 -0
  166. package/dist/engine/api-spec-generator/openapi-parser.js +161 -0
  167. package/dist/engine/api-spec-generator/openapi-parser.js.map +1 -0
  168. package/dist/engine/approval-workflow.d.ts +21 -0
  169. package/dist/engine/approval-workflow.d.ts.map +1 -0
  170. package/dist/engine/approval-workflow.js +82 -0
  171. package/dist/engine/approval-workflow.js.map +1 -0
  172. package/dist/engine/batch-script-generator/index.d.ts +6 -0
  173. package/dist/engine/batch-script-generator/index.d.ts.map +1 -0
  174. package/dist/engine/batch-script-generator/index.js +126 -0
  175. package/dist/engine/batch-script-generator/index.js.map +1 -0
  176. package/dist/engine/best-practices-library.d.ts +31 -0
  177. package/dist/engine/best-practices-library.d.ts.map +1 -0
  178. package/dist/engine/best-practices-library.js +111 -0
  179. package/dist/engine/best-practices-library.js.map +1 -0
  180. package/dist/engine/ci-generator/index.d.ts.map +1 -1
  181. package/dist/engine/ci-generator/index.js +32 -1
  182. package/dist/engine/ci-generator/index.js.map +1 -1
  183. package/dist/engine/ci-generator/output-formats.d.ts +15 -0
  184. package/dist/engine/ci-generator/output-formats.d.ts.map +1 -0
  185. package/dist/engine/ci-generator/output-formats.js +52 -0
  186. package/dist/engine/ci-generator/output-formats.js.map +1 -0
  187. package/dist/engine/claude-config-auditor/claudemd-auditor.d.ts.map +1 -1
  188. package/dist/engine/claude-config-auditor/claudemd-auditor.js +139 -31
  189. package/dist/engine/claude-config-auditor/claudemd-auditor.js.map +1 -1
  190. package/dist/engine/claude-config-auditor/rules-auditor.d.ts.map +1 -1
  191. package/dist/engine/claude-config-auditor/rules-auditor.js +87 -49
  192. package/dist/engine/claude-config-auditor/rules-auditor.js.map +1 -1
  193. package/dist/engine/claude-config-auditor/scoring.d.ts.map +1 -1
  194. package/dist/engine/claude-config-auditor/scoring.js +37 -1
  195. package/dist/engine/claude-config-auditor/scoring.js.map +1 -1
  196. package/dist/engine/claude-config-auditor/settings-auditor.d.ts.map +1 -1
  197. package/dist/engine/claude-config-auditor/settings-auditor.js +55 -40
  198. package/dist/engine/claude-config-auditor/settings-auditor.js.map +1 -1
  199. package/dist/engine/config-schemas.d.ts.map +1 -1
  200. package/dist/engine/config-schemas.js +1 -0
  201. package/dist/engine/config-schemas.js.map +1 -1
  202. package/dist/engine/confluence-exporter.d.ts +27 -0
  203. package/dist/engine/confluence-exporter.d.ts.map +1 -0
  204. package/dist/engine/confluence-exporter.js +238 -0
  205. package/dist/engine/confluence-exporter.js.map +1 -0
  206. package/dist/engine/context-advisor/btw-advisor.d.ts +11 -0
  207. package/dist/engine/context-advisor/btw-advisor.d.ts.map +1 -0
  208. package/dist/engine/context-advisor/btw-advisor.js +29 -0
  209. package/dist/engine/context-advisor/btw-advisor.js.map +1 -0
  210. package/dist/engine/cross-repo-searcher.d.ts +13 -0
  211. package/dist/engine/cross-repo-searcher.d.ts.map +1 -0
  212. package/dist/engine/cross-repo-searcher.js +51 -0
  213. package/dist/engine/cross-repo-searcher.js.map +1 -0
  214. package/dist/engine/desktop-notifier.d.ts +16 -0
  215. package/dist/engine/desktop-notifier.d.ts.map +1 -0
  216. package/dist/engine/desktop-notifier.js +64 -0
  217. package/dist/engine/desktop-notifier.js.map +1 -0
  218. package/dist/engine/domain-detector.d.ts +12 -0
  219. package/dist/engine/domain-detector.d.ts.map +1 -0
  220. package/dist/engine/domain-detector.js +286 -0
  221. package/dist/engine/domain-detector.js.map +1 -0
  222. package/dist/engine/email-digest-generator.d.ts +8 -0
  223. package/dist/engine/email-digest-generator.d.ts.map +1 -0
  224. package/dist/engine/email-digest-generator.js +192 -0
  225. package/dist/engine/email-digest-generator.js.map +1 -0
  226. package/dist/engine/email-sender.d.ts +22 -0
  227. package/dist/engine/email-sender.d.ts.map +1 -0
  228. package/dist/engine/email-sender.js +78 -0
  229. package/dist/engine/email-sender.js.map +1 -0
  230. package/dist/engine/estimation-calibrator.d.ts +19 -0
  231. package/dist/engine/estimation-calibrator.d.ts.map +1 -0
  232. package/dist/engine/estimation-calibrator.js +176 -0
  233. package/dist/engine/estimation-calibrator.js.map +1 -0
  234. package/dist/engine/facilitate/context-loader.d.ts +12 -0
  235. package/dist/engine/facilitate/context-loader.d.ts.map +1 -0
  236. package/dist/engine/facilitate/context-loader.js +156 -0
  237. package/dist/engine/facilitate/context-loader.js.map +1 -0
  238. package/dist/engine/facilitate/intent-classifier.d.ts +6 -0
  239. package/dist/engine/facilitate/intent-classifier.d.ts.map +1 -0
  240. package/dist/engine/facilitate/intent-classifier.js +153 -0
  241. package/dist/engine/facilitate/intent-classifier.js.map +1 -0
  242. package/dist/engine/facilitate/plan-parser.d.ts +7 -0
  243. package/dist/engine/facilitate/plan-parser.d.ts.map +1 -0
  244. package/dist/engine/facilitate/plan-parser.js +115 -0
  245. package/dist/engine/facilitate/plan-parser.js.map +1 -0
  246. package/dist/engine/facilitate/router.d.ts +6 -0
  247. package/dist/engine/facilitate/router.d.ts.map +1 -0
  248. package/dist/engine/facilitate/router.js +71 -0
  249. package/dist/engine/facilitate/router.js.map +1 -0
  250. package/dist/engine/hooks/context-injector.d.ts +11 -0
  251. package/dist/engine/hooks/context-injector.d.ts.map +1 -0
  252. package/dist/engine/hooks/context-injector.js +163 -0
  253. package/dist/engine/hooks/context-injector.js.map +1 -0
  254. package/dist/engine/hooks/custom-commands-generator.d.ts +11 -0
  255. package/dist/engine/hooks/custom-commands-generator.d.ts.map +1 -0
  256. package/dist/engine/hooks/custom-commands-generator.js +88 -0
  257. package/dist/engine/hooks/custom-commands-generator.js.map +1 -0
  258. package/dist/engine/hooks/effort-configurator.d.ts +13 -0
  259. package/dist/engine/hooks/effort-configurator.d.ts.map +1 -0
  260. package/dist/engine/hooks/effort-configurator.js +54 -0
  261. package/dist/engine/hooks/effort-configurator.js.map +1 -0
  262. package/dist/engine/hooks/full-spectrum-generator.d.ts +31 -0
  263. package/dist/engine/hooks/full-spectrum-generator.d.ts.map +1 -0
  264. package/dist/engine/hooks/full-spectrum-generator.js +115 -0
  265. package/dist/engine/hooks/full-spectrum-generator.js.map +1 -0
  266. package/dist/engine/hooks/hook-templates.d.ts +16 -0
  267. package/dist/engine/hooks/hook-templates.d.ts.map +1 -0
  268. package/dist/engine/hooks/hook-templates.js +148 -0
  269. package/dist/engine/hooks/hook-templates.js.map +1 -0
  270. package/dist/engine/hooks/plan-mode-detector.d.ts +27 -0
  271. package/dist/engine/hooks/plan-mode-detector.d.ts.map +1 -0
  272. package/dist/engine/hooks/plan-mode-detector.js +68 -0
  273. package/dist/engine/hooks/plan-mode-detector.js.map +1 -0
  274. package/dist/engine/hooks/plan-mode-scripts.d.ts +10 -0
  275. package/dist/engine/hooks/plan-mode-scripts.d.ts.map +1 -0
  276. package/dist/engine/hooks/plan-mode-scripts.js +45 -0
  277. package/dist/engine/hooks/plan-mode-scripts.js.map +1 -0
  278. package/dist/engine/hooks/profile-generator.d.ts +21 -0
  279. package/dist/engine/hooks/profile-generator.d.ts.map +1 -0
  280. package/dist/engine/hooks/profile-generator.js +90 -0
  281. package/dist/engine/hooks/profile-generator.js.map +1 -0
  282. package/dist/engine/ide-config/generators.d.ts.map +1 -1
  283. package/dist/engine/ide-config/generators.js +28 -1
  284. package/dist/engine/ide-config/generators.js.map +1 -1
  285. package/dist/engine/importers/csv-importer.d.ts +9 -0
  286. package/dist/engine/importers/csv-importer.d.ts.map +1 -0
  287. package/dist/engine/importers/csv-importer.js +116 -0
  288. package/dist/engine/importers/csv-importer.js.map +1 -0
  289. package/dist/engine/importers/jira-importer.d.ts +7 -0
  290. package/dist/engine/importers/jira-importer.d.ts.map +1 -0
  291. package/dist/engine/importers/jira-importer.js +57 -0
  292. package/dist/engine/importers/jira-importer.js.map +1 -0
  293. package/dist/engine/importers/linear-importer.d.ts +6 -0
  294. package/dist/engine/importers/linear-importer.d.ts.map +1 -0
  295. package/dist/engine/importers/linear-importer.js +59 -0
  296. package/dist/engine/importers/linear-importer.js.map +1 -0
  297. package/dist/engine/importers/markdown-importer.d.ts +7 -0
  298. package/dist/engine/importers/markdown-importer.d.ts.map +1 -0
  299. package/dist/engine/importers/markdown-importer.js +74 -0
  300. package/dist/engine/importers/markdown-importer.js.map +1 -0
  301. package/dist/engine/model-router/complexity-analyzer.d.ts +9 -1
  302. package/dist/engine/model-router/complexity-analyzer.d.ts.map +1 -1
  303. package/dist/engine/model-router/complexity-analyzer.js +44 -1
  304. package/dist/engine/model-router/complexity-analyzer.js.map +1 -1
  305. package/dist/engine/model-router/rules-engine.d.ts.map +1 -1
  306. package/dist/engine/model-router/rules-engine.js +14 -1
  307. package/dist/engine/model-router/rules-engine.js.map +1 -1
  308. package/dist/engine/nfr-profile-detector.d.ts.map +1 -1
  309. package/dist/engine/nfr-profile-detector.js +2 -1
  310. package/dist/engine/nfr-profile-detector.js.map +1 -1
  311. package/dist/engine/outbound-webhook-dispatcher.d.ts +4 -0
  312. package/dist/engine/outbound-webhook-dispatcher.d.ts.map +1 -0
  313. package/dist/engine/outbound-webhook-dispatcher.js +94 -0
  314. package/dist/engine/outbound-webhook-dispatcher.js.map +1 -0
  315. package/dist/engine/performance-analyzer.d.ts +18 -0
  316. package/dist/engine/performance-analyzer.d.ts.map +1 -0
  317. package/dist/engine/performance-analyzer.js +152 -0
  318. package/dist/engine/performance-analyzer.js.map +1 -0
  319. package/dist/engine/registry/composio-publisher.d.ts +17 -0
  320. package/dist/engine/registry/composio-publisher.d.ts.map +1 -0
  321. package/dist/engine/registry/composio-publisher.js +51 -0
  322. package/dist/engine/registry/composio-publisher.js.map +1 -0
  323. package/dist/engine/registry/glama-publisher.d.ts +17 -0
  324. package/dist/engine/registry/glama-publisher.d.ts.map +1 -0
  325. package/dist/engine/registry/glama-publisher.js +43 -0
  326. package/dist/engine/registry/glama-publisher.js.map +1 -0
  327. package/dist/engine/registry/index.d.ts +4 -0
  328. package/dist/engine/registry/index.d.ts.map +1 -1
  329. package/dist/engine/registry/index.js +5 -0
  330. package/dist/engine/registry/index.js.map +1 -1
  331. package/dist/engine/registry/mcp-official-publisher.d.ts +16 -0
  332. package/dist/engine/registry/mcp-official-publisher.d.ts.map +1 -0
  333. package/dist/engine/registry/mcp-official-publisher.js +44 -0
  334. package/dist/engine/registry/mcp-official-publisher.js.map +1 -0
  335. package/dist/engine/registry/smithery-generator.d.ts +16 -0
  336. package/dist/engine/registry/smithery-generator.d.ts.map +1 -0
  337. package/dist/engine/registry/smithery-generator.js +71 -0
  338. package/dist/engine/registry/smithery-generator.js.map +1 -0
  339. package/dist/engine/reverse-engineer/test-file-parser.d.ts +26 -0
  340. package/dist/engine/reverse-engineer/test-file-parser.d.ts.map +1 -0
  341. package/dist/engine/reverse-engineer/test-file-parser.js +165 -0
  342. package/dist/engine/reverse-engineer/test-file-parser.js.map +1 -0
  343. package/dist/engine/slack-dispatcher.d.ts +15 -0
  344. package/dist/engine/slack-dispatcher.d.ts.map +1 -0
  345. package/dist/engine/slack-dispatcher.js +73 -0
  346. package/dist/engine/slack-dispatcher.js.map +1 -0
  347. package/dist/engine/spec-coverage/core.js.map +1 -1
  348. package/dist/engine/spec-differ.d.ts +15 -0
  349. package/dist/engine/spec-differ.d.ts.map +1 -0
  350. package/dist/engine/spec-differ.js +115 -0
  351. package/dist/engine/spec-differ.js.map +1 -0
  352. package/dist/engine/spec-exporter.d.ts +27 -0
  353. package/dist/engine/spec-exporter.d.ts.map +1 -0
  354. package/dist/engine/spec-exporter.js +122 -0
  355. package/dist/engine/spec-exporter.js.map +1 -0
  356. package/dist/engine/spec-searcher.d.ts +31 -0
  357. package/dist/engine/spec-searcher.d.ts.map +1 -0
  358. package/dist/engine/spec-searcher.js +240 -0
  359. package/dist/engine/spec-searcher.js.map +1 -0
  360. package/dist/engine/spec-splitter.d.ts +11 -1
  361. package/dist/engine/spec-splitter.d.ts.map +1 -1
  362. package/dist/engine/spec-splitter.js +178 -0
  363. package/dist/engine/spec-splitter.js.map +1 -1
  364. package/dist/engine/team-analytics-calculator.d.ts +14 -0
  365. package/dist/engine/team-analytics-calculator.d.ts.map +1 -0
  366. package/dist/engine/team-analytics-calculator.js +114 -0
  367. package/dist/engine/team-analytics-calculator.js.map +1 -0
  368. package/dist/engine/team-planner/writer-reviewer.d.ts +12 -0
  369. package/dist/engine/team-planner/writer-reviewer.d.ts.map +1 -0
  370. package/dist/engine/team-planner/writer-reviewer.js +48 -0
  371. package/dist/engine/team-planner/writer-reviewer.js.map +1 -0
  372. package/dist/engine/telemetry/error-reporter.d.ts +16 -0
  373. package/dist/engine/telemetry/error-reporter.d.ts.map +1 -0
  374. package/dist/engine/telemetry/error-reporter.js +46 -0
  375. package/dist/engine/telemetry/error-reporter.js.map +1 -0
  376. package/dist/engine/tool-groups/group-manager.js.map +1 -1
  377. package/dist/engine/velocity-calculator.d.ts +44 -0
  378. package/dist/engine/velocity-calculator.d.ts.map +1 -0
  379. package/dist/engine/velocity-calculator.js +425 -0
  380. package/dist/engine/velocity-calculator.js.map +1 -0
  381. package/dist/index.js +55 -3
  382. package/dist/index.js.map +1 -1
  383. package/dist/storage/actuals-store.d.ts +8 -0
  384. package/dist/storage/actuals-store.d.ts.map +1 -0
  385. package/dist/storage/actuals-store.js +57 -0
  386. package/dist/storage/actuals-store.js.map +1 -0
  387. package/dist/storage/approval-store.d.ts +12 -0
  388. package/dist/storage/approval-store.d.ts.map +1 -0
  389. package/dist/storage/approval-store.js +46 -0
  390. package/dist/storage/approval-store.js.map +1 -0
  391. package/dist/storage/comments-store.d.ts +38 -0
  392. package/dist/storage/comments-store.d.ts.map +1 -0
  393. package/dist/storage/comments-store.js +167 -0
  394. package/dist/storage/comments-store.js.map +1 -0
  395. package/dist/storage/confluence-store.d.ts +35 -0
  396. package/dist/storage/confluence-store.d.ts.map +1 -0
  397. package/dist/storage/confluence-store.js +85 -0
  398. package/dist/storage/confluence-store.js.map +1 -0
  399. package/dist/storage/desktop-notification-store.d.ts +19 -0
  400. package/dist/storage/desktop-notification-store.d.ts.map +1 -0
  401. package/dist/storage/desktop-notification-store.js +44 -0
  402. package/dist/storage/desktop-notification-store.js.map +1 -0
  403. package/dist/storage/drift-cache-store.js.map +1 -1
  404. package/dist/storage/email-digest-store.d.ts +19 -0
  405. package/dist/storage/email-digest-store.d.ts.map +1 -0
  406. package/dist/storage/email-digest-store.js +51 -0
  407. package/dist/storage/email-digest-store.js.map +1 -0
  408. package/dist/storage/error-telemetry-store.js.map +1 -1
  409. package/dist/storage/federation-store.js.map +1 -1
  410. package/dist/storage/global-projects-store.d.ts +27 -0
  411. package/dist/storage/global-projects-store.d.ts.map +1 -0
  412. package/dist/storage/global-projects-store.js +78 -0
  413. package/dist/storage/global-projects-store.js.map +1 -0
  414. package/dist/storage/global-store.js.map +1 -1
  415. package/dist/storage/index.d.ts +2 -0
  416. package/dist/storage/index.d.ts.map +1 -1
  417. package/dist/storage/index.js +2 -0
  418. package/dist/storage/index.js.map +1 -1
  419. package/dist/storage/living-dashboard-store.js.map +1 -1
  420. package/dist/storage/metrics-store.js.map +1 -1
  421. package/dist/storage/outbound-webhook-store.d.ts +9 -0
  422. package/dist/storage/outbound-webhook-store.d.ts.map +1 -0
  423. package/dist/storage/outbound-webhook-store.js +105 -0
  424. package/dist/storage/outbound-webhook-store.js.map +1 -0
  425. package/dist/storage/rbac-store.js.map +1 -1
  426. package/dist/storage/slack-store.d.ts +22 -0
  427. package/dist/storage/slack-store.d.ts.map +1 -0
  428. package/dist/storage/slack-store.js +55 -0
  429. package/dist/storage/slack-store.js.map +1 -0
  430. package/dist/storage/spec-lock-store.d.ts +22 -0
  431. package/dist/storage/spec-lock-store.d.ts.map +1 -0
  432. package/dist/storage/spec-lock-store.js +99 -0
  433. package/dist/storage/spec-lock-store.js.map +1 -0
  434. package/dist/storage/spec-observability-store.js.map +1 -1
  435. package/dist/storage/worker-metrics-store.js.map +1 -1
  436. package/dist/storage/worker-store.js.map +1 -1
  437. package/dist/tools/ai-ecosystem-status.d.ts +13 -0
  438. package/dist/tools/ai-ecosystem-status.d.ts.map +1 -0
  439. package/dist/tools/ai-ecosystem-status.js +219 -0
  440. package/dist/tools/ai-ecosystem-status.js.map +1 -0
  441. package/dist/tools/api-spec-generator-handler.d.ts +3 -0
  442. package/dist/tools/api-spec-generator-handler.d.ts.map +1 -0
  443. package/dist/tools/api-spec-generator-handler.js +193 -0
  444. package/dist/tools/api-spec-generator-handler.js.map +1 -0
  445. package/dist/tools/approval-handler.d.ts +6 -0
  446. package/dist/tools/approval-handler.d.ts.map +1 -0
  447. package/dist/tools/approval-handler.js +193 -0
  448. package/dist/tools/approval-handler.js.map +1 -0
  449. package/dist/tools/checkpoint-handler.d.ts.map +1 -1
  450. package/dist/tools/checkpoint-handler.js +31 -0
  451. package/dist/tools/checkpoint-handler.js.map +1 -1
  452. package/dist/tools/clarify-requirements/interview-mode.d.ts +42 -0
  453. package/dist/tools/clarify-requirements/interview-mode.d.ts.map +1 -0
  454. package/dist/tools/clarify-requirements/interview-mode.js +342 -0
  455. package/dist/tools/clarify-requirements/interview-mode.js.map +1 -0
  456. package/dist/tools/comments-handler.d.ts +6 -0
  457. package/dist/tools/comments-handler.d.ts.map +1 -0
  458. package/dist/tools/comments-handler.js +137 -0
  459. package/dist/tools/comments-handler.js.map +1 -0
  460. package/dist/tools/configure-workers-handler.d.ts.map +1 -1
  461. package/dist/tools/configure-workers-handler.js +81 -0
  462. package/dist/tools/configure-workers-handler.js.map +1 -1
  463. package/dist/tools/confluence-handler.d.ts +6 -0
  464. package/dist/tools/confluence-handler.d.ts.map +1 -0
  465. package/dist/tools/confluence-handler.js +220 -0
  466. package/dist/tools/confluence-handler.js.map +1 -0
  467. package/dist/tools/cross-repo-search-handler.d.ts +19 -0
  468. package/dist/tools/cross-repo-search-handler.d.ts.map +1 -0
  469. package/dist/tools/cross-repo-search-handler.js +151 -0
  470. package/dist/tools/cross-repo-search-handler.js.map +1 -0
  471. package/dist/tools/desktop-notification-handler.d.ts +17 -0
  472. package/dist/tools/desktop-notification-handler.d.ts.map +1 -0
  473. package/dist/tools/desktop-notification-handler.js +90 -0
  474. package/dist/tools/desktop-notification-handler.js.map +1 -0
  475. package/dist/tools/domain-criteria-handler.d.ts +16 -0
  476. package/dist/tools/domain-criteria-handler.d.ts.map +1 -0
  477. package/dist/tools/domain-criteria-handler.js +216 -0
  478. package/dist/tools/domain-criteria-handler.js.map +1 -0
  479. package/dist/tools/email-digest-handler.d.ts +6 -0
  480. package/dist/tools/email-digest-handler.d.ts.map +1 -0
  481. package/dist/tools/email-digest-handler.js +198 -0
  482. package/dist/tools/email-digest-handler.js.map +1 -0
  483. package/dist/tools/estimate.d.ts.map +1 -1
  484. package/dist/tools/estimate.js +22 -0
  485. package/dist/tools/estimate.js.map +1 -1
  486. package/dist/tools/estimation-accuracy-handler.d.ts +5 -0
  487. package/dist/tools/estimation-accuracy-handler.d.ts.map +1 -0
  488. package/dist/tools/estimation-accuracy-handler.js +171 -0
  489. package/dist/tools/estimation-accuracy-handler.js.map +1 -0
  490. package/dist/tools/facilitate.d.ts +1 -5
  491. package/dist/tools/facilitate.d.ts.map +1 -1
  492. package/dist/tools/facilitate.js +100 -23
  493. package/dist/tools/facilitate.js.map +1 -1
  494. package/dist/tools/generate-automation-guide.d.ts +10 -0
  495. package/dist/tools/generate-automation-guide.d.ts.map +1 -0
  496. package/dist/tools/generate-automation-guide.js +266 -0
  497. package/dist/tools/generate-automation-guide.js.map +1 -0
  498. package/dist/tools/generate-batch-script.d.ts +27 -0
  499. package/dist/tools/generate-batch-script.d.ts.map +1 -0
  500. package/dist/tools/generate-batch-script.js +77 -0
  501. package/dist/tools/generate-batch-script.js.map +1 -0
  502. package/dist/tools/generate-sub-agent.d.ts.map +1 -1
  503. package/dist/tools/generate-sub-agent.js +16 -2
  504. package/dist/tools/generate-sub-agent.js.map +1 -1
  505. package/dist/tools/git/branch-ops.d.ts +18 -0
  506. package/dist/tools/git/branch-ops.d.ts.map +1 -1
  507. package/dist/tools/git/branch-ops.js +121 -0
  508. package/dist/tools/git/branch-ops.js.map +1 -1
  509. package/dist/tools/git/pr-ops.d.ts.map +1 -1
  510. package/dist/tools/git/pr-ops.js +7 -0
  511. package/dist/tools/git/pr-ops.js.map +1 -1
  512. package/dist/tools/import-spec-handler.d.ts +10 -0
  513. package/dist/tools/import-spec-handler.d.ts.map +1 -0
  514. package/dist/tools/import-spec-handler.js +242 -0
  515. package/dist/tools/import-spec-handler.js.map +1 -0
  516. package/dist/tools/init-project/claude-md-generator.d.ts +1 -0
  517. package/dist/tools/init-project/claude-md-generator.d.ts.map +1 -1
  518. package/dist/tools/init-project/claude-md-generator.js +35 -0
  519. package/dist/tools/init-project/claude-md-generator.js.map +1 -1
  520. package/dist/tools/init-project/handler.d.ts.map +1 -1
  521. package/dist/tools/init-project/handler.js +4 -1
  522. package/dist/tools/init-project/handler.js.map +1 -1
  523. package/dist/tools/init-project/hooks-configurator.d.ts +17 -0
  524. package/dist/tools/init-project/hooks-configurator.d.ts.map +1 -0
  525. package/dist/tools/init-project/hooks-configurator.js +102 -0
  526. package/dist/tools/init-project/hooks-configurator.js.map +1 -0
  527. package/dist/tools/init-project/planu-workflow-generator.d.ts +21 -0
  528. package/dist/tools/init-project/planu-workflow-generator.d.ts.map +1 -0
  529. package/dist/tools/init-project/planu-workflow-generator.js +84 -0
  530. package/dist/tools/init-project/planu-workflow-generator.js.map +1 -0
  531. package/dist/tools/init-project/rules-generator.d.ts +26 -0
  532. package/dist/tools/init-project/rules-generator.d.ts.map +1 -0
  533. package/dist/tools/init-project/rules-generator.js +189 -0
  534. package/dist/tools/init-project/rules-generator.js.map +1 -0
  535. package/dist/tools/init-project/scaffold-writer.d.ts +4 -0
  536. package/dist/tools/init-project/scaffold-writer.d.ts.map +1 -1
  537. package/dist/tools/init-project/scaffold-writer.js +42 -0
  538. package/dist/tools/init-project/scaffold-writer.js.map +1 -1
  539. package/dist/tools/integrate-pm.js.map +1 -1
  540. package/dist/tools/list-sessions.d.ts.map +1 -1
  541. package/dist/tools/list-sessions.js +8 -0
  542. package/dist/tools/list-sessions.js.map +1 -1
  543. package/dist/tools/list-specs.d.ts.map +1 -1
  544. package/dist/tools/list-specs.js +11 -1
  545. package/dist/tools/list-specs.js.map +1 -1
  546. package/dist/tools/manage-git.d.ts.map +1 -1
  547. package/dist/tools/manage-git.js +15 -1
  548. package/dist/tools/manage-git.js.map +1 -1
  549. package/dist/tools/orchestrate/state.js.map +1 -1
  550. package/dist/tools/outbound-webhook-handler.d.ts +13 -0
  551. package/dist/tools/outbound-webhook-handler.d.ts.map +1 -0
  552. package/dist/tools/outbound-webhook-handler.js +161 -0
  553. package/dist/tools/outbound-webhook-handler.js.map +1 -0
  554. package/dist/tools/performance-analysis-handler.d.ts +3 -0
  555. package/dist/tools/performance-analysis-handler.d.ts.map +1 -0
  556. package/dist/tools/performance-analysis-handler.js +95 -0
  557. package/dist/tools/performance-analysis-handler.js.map +1 -0
  558. package/dist/tools/recommend-model-handler.d.ts.map +1 -1
  559. package/dist/tools/recommend-model-handler.js +7 -0
  560. package/dist/tools/recommend-model-handler.js.map +1 -1
  561. package/dist/tools/register-api-spec-generator.d.ts +3 -0
  562. package/dist/tools/register-api-spec-generator.d.ts.map +1 -0
  563. package/dist/tools/register-api-spec-generator.js +49 -0
  564. package/dist/tools/register-api-spec-generator.js.map +1 -0
  565. package/dist/tools/register-approval-tools.d.ts +3 -0
  566. package/dist/tools/register-approval-tools.d.ts.map +1 -0
  567. package/dist/tools/register-approval-tools.js +87 -0
  568. package/dist/tools/register-approval-tools.js.map +1 -0
  569. package/dist/tools/register-comments-tools.d.ts +3 -0
  570. package/dist/tools/register-comments-tools.d.ts.map +1 -0
  571. package/dist/tools/register-comments-tools.js +79 -0
  572. package/dist/tools/register-comments-tools.js.map +1 -0
  573. package/dist/tools/register-confluence-tools.d.ts +3 -0
  574. package/dist/tools/register-confluence-tools.d.ts.map +1 -0
  575. package/dist/tools/register-confluence-tools.js +62 -0
  576. package/dist/tools/register-confluence-tools.js.map +1 -0
  577. package/dist/tools/register-cross-repo-search-tools.d.ts +10 -0
  578. package/dist/tools/register-cross-repo-search-tools.d.ts.map +1 -0
  579. package/dist/tools/register-cross-repo-search-tools.js +82 -0
  580. package/dist/tools/register-cross-repo-search-tools.js.map +1 -0
  581. package/dist/tools/register-desktop-notification-tools.d.ts +3 -0
  582. package/dist/tools/register-desktop-notification-tools.d.ts.map +1 -0
  583. package/dist/tools/register-desktop-notification-tools.js +56 -0
  584. package/dist/tools/register-desktop-notification-tools.js.map +1 -0
  585. package/dist/tools/register-domain-criteria-tools.d.ts +3 -0
  586. package/dist/tools/register-domain-criteria-tools.d.ts.map +1 -0
  587. package/dist/tools/register-domain-criteria-tools.js +46 -0
  588. package/dist/tools/register-domain-criteria-tools.js.map +1 -0
  589. package/dist/tools/register-email-digest-tools.d.ts +3 -0
  590. package/dist/tools/register-email-digest-tools.d.ts.map +1 -0
  591. package/dist/tools/register-email-digest-tools.js +109 -0
  592. package/dist/tools/register-email-digest-tools.js.map +1 -0
  593. package/dist/tools/register-estimation-accuracy-tools.d.ts +3 -0
  594. package/dist/tools/register-estimation-accuracy-tools.d.ts.map +1 -0
  595. package/dist/tools/register-estimation-accuracy-tools.js +71 -0
  596. package/dist/tools/register-estimation-accuracy-tools.js.map +1 -0
  597. package/dist/tools/register-facilitator-tools.d.ts.map +1 -1
  598. package/dist/tools/register-facilitator-tools.js +12 -7
  599. package/dist/tools/register-facilitator-tools.js.map +1 -1
  600. package/dist/tools/register-generate-automation-guide.d.ts +3 -0
  601. package/dist/tools/register-generate-automation-guide.d.ts.map +1 -0
  602. package/dist/tools/register-generate-automation-guide.js +10 -0
  603. package/dist/tools/register-generate-automation-guide.js.map +1 -0
  604. package/dist/tools/register-generate-batch-script.d.ts +3 -0
  605. package/dist/tools/register-generate-batch-script.d.ts.map +1 -0
  606. package/dist/tools/register-generate-batch-script.js +10 -0
  607. package/dist/tools/register-generate-batch-script.js.map +1 -0
  608. package/dist/tools/register-hooks-tools.d.ts.map +1 -1
  609. package/dist/tools/register-hooks-tools.js +27 -0
  610. package/dist/tools/register-hooks-tools.js.map +1 -1
  611. package/dist/tools/register-import-tools.d.ts +3 -0
  612. package/dist/tools/register-import-tools.d.ts.map +1 -0
  613. package/dist/tools/register-import-tools.js +63 -0
  614. package/dist/tools/register-import-tools.js.map +1 -0
  615. package/dist/tools/register-outbound-webhook-tools.d.ts +3 -0
  616. package/dist/tools/register-outbound-webhook-tools.d.ts.map +1 -0
  617. package/dist/tools/register-outbound-webhook-tools.js +79 -0
  618. package/dist/tools/register-outbound-webhook-tools.js.map +1 -0
  619. package/dist/tools/register-performance-analysis-tools.d.ts +3 -0
  620. package/dist/tools/register-performance-analysis-tools.d.ts.map +1 -0
  621. package/dist/tools/register-performance-analysis-tools.js +24 -0
  622. package/dist/tools/register-performance-analysis-tools.js.map +1 -0
  623. package/dist/tools/register-platform-tools/design-stack-tools.d.ts.map +1 -1
  624. package/dist/tools/register-platform-tools/design-stack-tools.js +4 -0
  625. package/dist/tools/register-platform-tools/design-stack-tools.js.map +1 -1
  626. package/dist/tools/register-slack-tools.d.ts +3 -0
  627. package/dist/tools/register-slack-tools.d.ts.map +1 -0
  628. package/dist/tools/register-slack-tools.js +55 -0
  629. package/dist/tools/register-slack-tools.js.map +1 -0
  630. package/dist/tools/register-spec-export-tools.d.ts +3 -0
  631. package/dist/tools/register-spec-export-tools.d.ts.map +1 -0
  632. package/dist/tools/register-spec-export-tools.js +67 -0
  633. package/dist/tools/register-spec-export-tools.js.map +1 -0
  634. package/dist/tools/register-spec-lock-tools.d.ts +3 -0
  635. package/dist/tools/register-spec-lock-tools.d.ts.map +1 -0
  636. package/dist/tools/register-spec-lock-tools.js +72 -0
  637. package/dist/tools/register-spec-lock-tools.js.map +1 -0
  638. package/dist/tools/register-spec-search-tools.d.ts +3 -0
  639. package/dist/tools/register-spec-search-tools.d.ts.map +1 -0
  640. package/dist/tools/register-spec-search-tools.js +122 -0
  641. package/dist/tools/register-spec-search-tools.js.map +1 -0
  642. package/dist/tools/register-spec-split-tools.d.ts +3 -0
  643. package/dist/tools/register-spec-split-tools.d.ts.map +1 -0
  644. package/dist/tools/register-spec-split-tools.js +51 -0
  645. package/dist/tools/register-spec-split-tools.js.map +1 -0
  646. package/dist/tools/register-spec-tools/core-spec-tools.d.ts.map +1 -1
  647. package/dist/tools/register-spec-tools/core-spec-tools.js +20 -2
  648. package/dist/tools/register-spec-tools/core-spec-tools.js.map +1 -1
  649. package/dist/tools/register-team-analytics-tools.d.ts +3 -0
  650. package/dist/tools/register-team-analytics-tools.d.ts.map +1 -0
  651. package/dist/tools/register-team-analytics-tools.js +37 -0
  652. package/dist/tools/register-team-analytics-tools.js.map +1 -0
  653. package/dist/tools/register-test-reverse-engineer-tools.d.ts +3 -0
  654. package/dist/tools/register-test-reverse-engineer-tools.d.ts.map +1 -0
  655. package/dist/tools/register-test-reverse-engineer-tools.js +10 -0
  656. package/dist/tools/register-test-reverse-engineer-tools.js.map +1 -0
  657. package/dist/tools/register-velocity-tools.d.ts +3 -0
  658. package/dist/tools/register-velocity-tools.d.ts.map +1 -0
  659. package/dist/tools/register-velocity-tools.js +72 -0
  660. package/dist/tools/register-velocity-tools.js.map +1 -0
  661. package/dist/tools/register-versioning-tools.d.ts.map +1 -1
  662. package/dist/tools/register-versioning-tools.js +55 -0
  663. package/dist/tools/register-versioning-tools.js.map +1 -1
  664. package/dist/tools/restore-session.d.ts.map +1 -1
  665. package/dist/tools/restore-session.js +10 -0
  666. package/dist/tools/restore-session.js.map +1 -1
  667. package/dist/tools/safe-handler.d.ts.map +1 -1
  668. package/dist/tools/safe-handler.js +5 -0
  669. package/dist/tools/safe-handler.js.map +1 -1
  670. package/dist/tools/schemas/ide-config.d.ts +4 -2
  671. package/dist/tools/schemas/ide-config.d.ts.map +1 -1
  672. package/dist/tools/schemas/ide-config.js +2 -1
  673. package/dist/tools/schemas/ide-config.js.map +1 -1
  674. package/dist/tools/schemas/output-schemas.d.ts +24 -0
  675. package/dist/tools/schemas/output-schemas.d.ts.map +1 -1
  676. package/dist/tools/schemas/output-schemas.js +30 -0
  677. package/dist/tools/schemas/output-schemas.js.map +1 -1
  678. package/dist/tools/schemas/workers-schema.d.ts +1 -0
  679. package/dist/tools/schemas/workers-schema.d.ts.map +1 -1
  680. package/dist/tools/schemas/workers-schema.js +10 -2
  681. package/dist/tools/schemas/workers-schema.js.map +1 -1
  682. package/dist/tools/search-handler.d.ts +4 -0
  683. package/dist/tools/search-handler.d.ts.map +1 -0
  684. package/dist/tools/search-handler.js +62 -0
  685. package/dist/tools/search-handler.js.map +1 -0
  686. package/dist/tools/slack-handler.d.ts +6 -0
  687. package/dist/tools/slack-handler.d.ts.map +1 -0
  688. package/dist/tools/slack-handler.js +162 -0
  689. package/dist/tools/slack-handler.js.map +1 -0
  690. package/dist/tools/spec-diff-handler.d.ts +6 -0
  691. package/dist/tools/spec-diff-handler.d.ts.map +1 -0
  692. package/dist/tools/spec-diff-handler.js +94 -0
  693. package/dist/tools/spec-diff-handler.js.map +1 -0
  694. package/dist/tools/spec-export-handler.d.ts +5 -0
  695. package/dist/tools/spec-export-handler.d.ts.map +1 -0
  696. package/dist/tools/spec-export-handler.js +64 -0
  697. package/dist/tools/spec-export-handler.js.map +1 -0
  698. package/dist/tools/spec-lock-handler.d.ts +10 -0
  699. package/dist/tools/spec-lock-handler.d.ts.map +1 -0
  700. package/dist/tools/spec-lock-handler.js +163 -0
  701. package/dist/tools/spec-lock-handler.js.map +1 -0
  702. package/dist/tools/spec-split-handler.d.ts +4 -0
  703. package/dist/tools/spec-split-handler.d.ts.map +1 -0
  704. package/dist/tools/spec-split-handler.js +250 -0
  705. package/dist/tools/spec-split-handler.js.map +1 -0
  706. package/dist/tools/start-hooks.d.ts.map +1 -1
  707. package/dist/tools/start-hooks.js +104 -1
  708. package/dist/tools/start-hooks.js.map +1 -1
  709. package/dist/tools/status-handler.d.ts.map +1 -1
  710. package/dist/tools/status-handler.js +49 -3
  711. package/dist/tools/status-handler.js.map +1 -1
  712. package/dist/tools/sync-ai-configs.d.ts +15 -0
  713. package/dist/tools/sync-ai-configs.d.ts.map +1 -0
  714. package/dist/tools/sync-ai-configs.js +86 -0
  715. package/dist/tools/sync-ai-configs.js.map +1 -0
  716. package/dist/tools/team-analytics-handler.d.ts +5 -0
  717. package/dist/tools/team-analytics-handler.d.ts.map +1 -0
  718. package/dist/tools/team-analytics-handler.js +67 -0
  719. package/dist/tools/team-analytics-handler.js.map +1 -0
  720. package/dist/tools/test-reverse-engineer-handler.d.ts +15 -0
  721. package/dist/tools/test-reverse-engineer-handler.d.ts.map +1 -0
  722. package/dist/tools/test-reverse-engineer-handler.js +94 -0
  723. package/dist/tools/test-reverse-engineer-handler.js.map +1 -0
  724. package/dist/tools/update-status/index.d.ts.map +1 -1
  725. package/dist/tools/update-status/index.js +135 -20
  726. package/dist/tools/update-status/index.js.map +1 -1
  727. package/dist/tools/update-status/response-builder.d.ts +1 -1
  728. package/dist/tools/update-status/response-builder.d.ts.map +1 -1
  729. package/dist/tools/update-status/response-builder.js +4 -1
  730. package/dist/tools/update-status/response-builder.js.map +1 -1
  731. package/dist/tools/update-status/side-effects.d.ts.map +1 -1
  732. package/dist/tools/update-status/side-effects.js +71 -0
  733. package/dist/tools/update-status/side-effects.js.map +1 -1
  734. package/dist/tools/update-status/transition-guard.d.ts +8 -0
  735. package/dist/tools/update-status/transition-guard.d.ts.map +1 -1
  736. package/dist/tools/update-status/transition-guard.js +23 -0
  737. package/dist/tools/update-status/transition-guard.js.map +1 -1
  738. package/dist/tools/update-status-actions.d.ts +1 -0
  739. package/dist/tools/update-status-actions.d.ts.map +1 -1
  740. package/dist/tools/update-status-actions.js +15 -1
  741. package/dist/tools/update-status-actions.js.map +1 -1
  742. package/dist/tools/velocity-handler.d.ts +4 -0
  743. package/dist/tools/velocity-handler.d.ts.map +1 -0
  744. package/dist/tools/velocity-handler.js +103 -0
  745. package/dist/tools/velocity-handler.js.map +1 -0
  746. package/dist/types/actuals.d.ts +100 -0
  747. package/dist/types/actuals.d.ts.map +1 -0
  748. package/dist/types/actuals.js +2 -0
  749. package/dist/types/actuals.js.map +1 -0
  750. package/dist/types/agent-frameworks.d.ts +62 -0
  751. package/dist/types/agent-frameworks.d.ts.map +1 -0
  752. package/dist/types/agent-frameworks.js +3 -0
  753. package/dist/types/agent-frameworks.js.map +1 -0
  754. package/dist/types/agents-md.d.ts +20 -0
  755. package/dist/types/agents-md.d.ts.map +1 -0
  756. package/dist/types/agents-md.js +3 -0
  757. package/dist/types/agents-md.js.map +1 -0
  758. package/dist/types/ai-integration.d.ts +65 -0
  759. package/dist/types/ai-integration.d.ts.map +1 -0
  760. package/dist/types/ai-integration.js +3 -0
  761. package/dist/types/ai-integration.js.map +1 -0
  762. package/dist/types/analysis.d.ts +8 -0
  763. package/dist/types/analysis.d.ts.map +1 -1
  764. package/dist/types/api-contract.d.ts +154 -0
  765. package/dist/types/api-contract.d.ts.map +1 -0
  766. package/dist/types/api-contract.js +3 -0
  767. package/dist/types/api-contract.js.map +1 -0
  768. package/dist/types/approval.d.ts +82 -0
  769. package/dist/types/approval.d.ts.map +1 -0
  770. package/dist/types/approval.js +3 -0
  771. package/dist/types/approval.js.map +1 -0
  772. package/dist/types/batch-script.d.ts +36 -0
  773. package/dist/types/batch-script.d.ts.map +1 -0
  774. package/dist/types/batch-script.js +3 -0
  775. package/dist/types/batch-script.js.map +1 -0
  776. package/dist/types/ci.d.ts +4 -0
  777. package/dist/types/ci.d.ts.map +1 -1
  778. package/dist/types/cline-integration.d.ts +30 -0
  779. package/dist/types/cline-integration.d.ts.map +1 -0
  780. package/dist/types/cline-integration.js +3 -0
  781. package/dist/types/cline-integration.js.map +1 -0
  782. package/dist/types/codex-integration.d.ts +55 -0
  783. package/dist/types/codex-integration.d.ts.map +1 -0
  784. package/dist/types/codex-integration.js +3 -0
  785. package/dist/types/codex-integration.js.map +1 -0
  786. package/dist/types/comments.d.ts +68 -0
  787. package/dist/types/comments.d.ts.map +1 -0
  788. package/dist/types/comments.js +3 -0
  789. package/dist/types/comments.js.map +1 -0
  790. package/dist/types/common/tech-enums.d.ts +1 -1
  791. package/dist/types/common/tech-enums.d.ts.map +1 -1
  792. package/dist/types/confluence.d.ts +102 -0
  793. package/dist/types/confluence.d.ts.map +1 -0
  794. package/dist/types/confluence.js +3 -0
  795. package/dist/types/confluence.js.map +1 -0
  796. package/dist/types/cross-repo-search.d.ts +104 -0
  797. package/dist/types/cross-repo-search.d.ts.map +1 -0
  798. package/dist/types/cross-repo-search.js +2 -0
  799. package/dist/types/cross-repo-search.js.map +1 -0
  800. package/dist/types/desktop-notification.d.ts +38 -0
  801. package/dist/types/desktop-notification.d.ts.map +1 -0
  802. package/dist/types/desktop-notification.js +3 -0
  803. package/dist/types/desktop-notification.js.map +1 -0
  804. package/dist/types/domain-criteria.d.ts +62 -0
  805. package/dist/types/domain-criteria.d.ts.map +1 -0
  806. package/dist/types/domain-criteria.js +3 -0
  807. package/dist/types/domain-criteria.js.map +1 -0
  808. package/dist/types/email-digest.d.ts +119 -0
  809. package/dist/types/email-digest.d.ts.map +1 -0
  810. package/dist/types/email-digest.js +3 -0
  811. package/dist/types/email-digest.js.map +1 -0
  812. package/dist/types/execution.d.ts +9 -0
  813. package/dist/types/execution.d.ts.map +1 -1
  814. package/dist/types/facilitator.d.ts +67 -0
  815. package/dist/types/facilitator.d.ts.map +1 -1
  816. package/dist/types/file-hooks.d.ts +7 -0
  817. package/dist/types/file-hooks.d.ts.map +1 -1
  818. package/dist/types/file-hooks.js +0 -1
  819. package/dist/types/file-hooks.js.map +1 -1
  820. package/dist/types/gemini-integration.d.ts +40 -0
  821. package/dist/types/gemini-integration.d.ts.map +1 -0
  822. package/dist/types/gemini-integration.js +3 -0
  823. package/dist/types/gemini-integration.js.map +1 -0
  824. package/dist/types/git.d.ts +12 -0
  825. package/dist/types/git.d.ts.map +1 -1
  826. package/dist/types/github-copilot-integration.d.ts +30 -0
  827. package/dist/types/github-copilot-integration.d.ts.map +1 -0
  828. package/dist/types/github-copilot-integration.js +3 -0
  829. package/dist/types/github-copilot-integration.js.map +1 -0
  830. package/dist/types/hooks-advanced.d.ts +34 -0
  831. package/dist/types/hooks-advanced.d.ts.map +1 -0
  832. package/dist/types/hooks-advanced.js +3 -0
  833. package/dist/types/hooks-advanced.js.map +1 -0
  834. package/dist/types/hooks.d.ts +77 -0
  835. package/dist/types/hooks.d.ts.map +1 -1
  836. package/dist/types/ide.d.ts +1 -1
  837. package/dist/types/ide.d.ts.map +1 -1
  838. package/dist/types/import-spec.d.ts +123 -0
  839. package/dist/types/import-spec.d.ts.map +1 -0
  840. package/dist/types/import-spec.js +3 -0
  841. package/dist/types/import-spec.js.map +1 -0
  842. package/dist/types/index.d.ts +30 -0
  843. package/dist/types/index.d.ts.map +1 -1
  844. package/dist/types/index.js +30 -0
  845. package/dist/types/index.js.map +1 -1
  846. package/dist/types/kiro-integration.d.ts +44 -0
  847. package/dist/types/kiro-integration.d.ts.map +1 -0
  848. package/dist/types/kiro-integration.js +3 -0
  849. package/dist/types/kiro-integration.js.map +1 -0
  850. package/dist/types/model-routing.d.ts +16 -0
  851. package/dist/types/model-routing.d.ts.map +1 -1
  852. package/dist/types/outbound-webhook.d.ts +51 -0
  853. package/dist/types/outbound-webhook.d.ts.map +1 -0
  854. package/dist/types/outbound-webhook.js +3 -0
  855. package/dist/types/outbound-webhook.js.map +1 -0
  856. package/dist/types/performance-analysis.d.ts +33 -0
  857. package/dist/types/performance-analysis.d.ts.map +1 -0
  858. package/dist/types/performance-analysis.js +3 -0
  859. package/dist/types/performance-analysis.js.map +1 -0
  860. package/dist/types/project/planu-config.d.ts +6 -0
  861. package/dist/types/project/planu-config.d.ts.map +1 -1
  862. package/dist/types/registry-publishers.d.ts +63 -0
  863. package/dist/types/registry-publishers.d.ts.map +1 -0
  864. package/dist/types/registry-publishers.js +4 -0
  865. package/dist/types/registry-publishers.js.map +1 -0
  866. package/dist/types/search.d.ts +49 -0
  867. package/dist/types/search.d.ts.map +1 -0
  868. package/dist/types/search.js +3 -0
  869. package/dist/types/search.js.map +1 -0
  870. package/dist/types/session.d.ts +2 -0
  871. package/dist/types/session.d.ts.map +1 -1
  872. package/dist/types/slack.d.ts +41 -0
  873. package/dist/types/slack.d.ts.map +1 -0
  874. package/dist/types/slack.js +3 -0
  875. package/dist/types/slack.js.map +1 -0
  876. package/dist/types/spec/inputs.d.ts +46 -2
  877. package/dist/types/spec/inputs.d.ts.map +1 -1
  878. package/dist/types/spec-export.d.ts +18 -0
  879. package/dist/types/spec-export.d.ts.map +1 -0
  880. package/dist/types/spec-export.js +3 -0
  881. package/dist/types/spec-export.js.map +1 -0
  882. package/dist/types/spec-lock.d.ts +42 -0
  883. package/dist/types/spec-lock.d.ts.map +1 -0
  884. package/dist/types/spec-lock.js +3 -0
  885. package/dist/types/spec-lock.js.map +1 -0
  886. package/dist/types/spec-versioning.d.ts +35 -0
  887. package/dist/types/spec-versioning.d.ts.map +1 -1
  888. package/dist/types/stack/recommend.d.ts +1 -0
  889. package/dist/types/stack/recommend.d.ts.map +1 -1
  890. package/dist/types/status.d.ts +7 -0
  891. package/dist/types/status.d.ts.map +1 -1
  892. package/dist/types/team-analytics.d.ts +52 -0
  893. package/dist/types/team-analytics.d.ts.map +1 -0
  894. package/dist/types/team-analytics.js +3 -0
  895. package/dist/types/team-analytics.js.map +1 -0
  896. package/dist/types/team-planner.d.ts +18 -0
  897. package/dist/types/team-planner.d.ts.map +1 -1
  898. package/dist/types/telemetry.d.ts +1 -1
  899. package/dist/types/telemetry.d.ts.map +1 -1
  900. package/dist/types/test-reverse-engineer.d.ts +32 -0
  901. package/dist/types/test-reverse-engineer.d.ts.map +1 -0
  902. package/dist/types/test-reverse-engineer.js +3 -0
  903. package/dist/types/test-reverse-engineer.js.map +1 -0
  904. package/dist/types/velocity.d.ts +147 -0
  905. package/dist/types/velocity.d.ts.map +1 -0
  906. package/dist/types/velocity.js +4 -0
  907. package/dist/types/velocity.js.map +1 -0
  908. package/dist/types/workers.d.ts +1 -1
  909. package/dist/types/workers.d.ts.map +1 -1
  910. package/package.json +10 -10
  911. package/src/config/domain-best-practices.json +413 -0
  912. package/src/config/ide-registry.json +25 -0
  913. package/src/config/license-plans.json +61 -2
@@ -1,13 +1,15 @@
1
1
  import { scoreAmbiguity, shouldBlock } from '../engine/ambiguity-detector.js';
2
2
  import { setFocus, getFocus, checkFocusDrift, parseChangeFocusDirective, } from '../engine/focus-tracker.js';
3
3
  import { getParadigmRecommendations, formatParadigmObservations, } from '../engine/paradigm-advisor.js';
4
+ import { classifyIntent } from '../engine/facilitate/intent-classifier.js';
5
+ import { loadContext } from '../engine/facilitate/context-loader.js';
6
+ import { route } from '../engine/facilitate/router.js';
7
+ import { parsePlanContent } from '../engine/facilitate/plan-parser.js';
4
8
  // ---------------------------------------------------------------------------
5
- // Scenario detection
9
+ // Scenario detection (SPEC-037 legacy — kept for backward compatibility)
6
10
  // ---------------------------------------------------------------------------
7
11
  function detectScenario(description) {
8
12
  const lower = description.toLowerCase();
9
- // Concrete problem indicators — check before existing_project to avoid
10
- // false positives with phrases like "existing spec"
11
13
  if (lower.includes('how to') ||
12
14
  lower.includes('how do i') ||
13
15
  lower.includes('what tool') ||
@@ -17,13 +19,11 @@ function detectScenario(description) {
17
19
  lower.includes('problem')) {
18
20
  return 'concrete_problem';
19
21
  }
20
- // Existing project indicators
21
22
  if (lower.includes('already have') ||
22
23
  lower.includes('my project') ||
23
24
  lower.includes('our project') ||
24
25
  /existing project/i.test(description) ||
25
- lower.includes('/') // path-like input
26
- ) {
26
+ lower.includes('/')) {
27
27
  return 'existing_project';
28
28
  }
29
29
  return 'new_project';
@@ -44,7 +44,6 @@ function buildNewProjectResponse(step, collectedInfo) {
44
44
  : `Got it! ${Object.values(collectedInfo).join(', ')}\n\n`;
45
45
  return `${intro}Step ${step + 1}/3: ${question}`;
46
46
  }
47
- // All 3 steps complete — suggest create_spec
48
47
  const info = Object.values(collectedInfo).join(' | ');
49
48
  return (`Great — I have enough context to generate your spec.\n\n` +
50
49
  `Summary: ${info}\n\n` +
@@ -97,10 +96,6 @@ function buildConcreteProblemResponse(description) {
97
96
  // ---------------------------------------------------------------------------
98
97
  // Paradigm observations (SPEC-035b)
99
98
  // ---------------------------------------------------------------------------
100
- /**
101
- * Builds paradigm expert voice observations from a pre-computed ParadigmReport.
102
- * Degrades gracefully when no detection data is available.
103
- */
104
99
  export function buildParadigmObservations(paradigmReport) {
105
100
  if (!paradigmReport) {
106
101
  return '';
@@ -145,11 +140,97 @@ function generateExpertObservations(description) {
145
140
  return observations;
146
141
  }
147
142
  // ---------------------------------------------------------------------------
143
+ // SPEC-264: Routing suggestion text
144
+ // ---------------------------------------------------------------------------
145
+ function buildRoutingSuggestion(decision) {
146
+ switch (decision.action) {
147
+ case 'resume':
148
+ return `Resume work on spec ${decision.specId} — it matches your request and is in progress.`;
149
+ case 'create-spec':
150
+ return `Create a new spec for this ${decision.type} request using \`create_spec\`.`;
151
+ case 'direct':
152
+ return decision.reason;
153
+ case 'clarify':
154
+ return decision.question;
155
+ }
156
+ }
157
+ // ---------------------------------------------------------------------------
158
+ // SPEC-264: Smart orchestrator path
159
+ // ---------------------------------------------------------------------------
160
+ async function runSmartOrchestrator(description, projectId, planContent) {
161
+ // 1. Classify intent
162
+ const intent = classifyIntent(description);
163
+ // 2. Load context from project data
164
+ const projectPath = projectId ?? process.cwd();
165
+ const ctx = await loadContext(projectPath, intent.keywords);
166
+ // 3. Handle Plan Mode content
167
+ let parsedPlan = null;
168
+ let effectiveDescription = description;
169
+ if (planContent) {
170
+ parsedPlan = parsePlanContent(planContent);
171
+ if (parsedPlan) {
172
+ effectiveDescription =
173
+ `${parsedPlan.title}: ` + parsedPlan.acceptanceCriteria.slice(0, 3).join('; ');
174
+ }
175
+ }
176
+ // 4. Route
177
+ const decision = route(intent, ctx, effectiveDescription);
178
+ // 5. Build compact response (≤150 tokens main content)
179
+ const result = {
180
+ action: 'facilitate',
181
+ routing: decision,
182
+ context: {
183
+ activeCount: ctx.activeSpecs.length,
184
+ relatedFound: ctx.relatedSpecs.map((s) => s.id),
185
+ },
186
+ intent: {
187
+ type: intent.type,
188
+ complexity: intent.complexity,
189
+ confidence: intent.confidence,
190
+ },
191
+ suggestion: buildRoutingSuggestion(decision),
192
+ };
193
+ if (parsedPlan) {
194
+ result.parsedPlan = {
195
+ title: parsedPlan.title,
196
+ acCount: parsedPlan.acceptanceCriteria.length,
197
+ estimatedComplexity: parsedPlan.estimatedComplexity,
198
+ };
199
+ }
200
+ return result;
201
+ }
202
+ // ---------------------------------------------------------------------------
148
203
  // Main handler
149
204
  // ---------------------------------------------------------------------------
150
- export function handleFacilitate(params) {
151
- const { description, projectId, sessionId, scenario: explicitScenario, collectedInfo = {}, step = 0, targetTool, checkFocus = false, changeFocus, paradigmReport, } = params;
205
+ export async function handleFacilitate(params) {
206
+ const { description, projectId, sessionId, scenario: explicitScenario, collectedInfo = {}, step = 0, targetTool, checkFocus = false, changeFocus, paradigmReport, planContent, } = params;
152
207
  const sessionKey = sessionId ?? projectId ?? 'default';
208
+ // SPEC-264: When planContent provided OR no explicit scenario/control params given,
209
+ // use the smart orchestrator path.
210
+ const useSmartOrchestrator = planContent !== undefined ||
211
+ (explicitScenario === undefined &&
212
+ targetTool === undefined &&
213
+ !checkFocus &&
214
+ changeFocus === undefined);
215
+ if (useSmartOrchestrator) {
216
+ try {
217
+ const orchestratorResult = await runSmartOrchestrator(description, projectId, planContent);
218
+ const observations = generateExpertObservations(description);
219
+ const paradigmObs = buildParadigmObservations(paradigmReport);
220
+ const merged = { ...orchestratorResult };
221
+ if (observations.length > 0) {
222
+ merged.expertObservations = observations;
223
+ }
224
+ if (paradigmObs) {
225
+ merged.paradigmObservations = paradigmObs;
226
+ }
227
+ return ok(merged);
228
+ }
229
+ catch (err) {
230
+ const message = err instanceof Error ? err.message : String(err);
231
+ return ok({ action: 'facilitate', error: message, fallback: true });
232
+ }
233
+ }
153
234
  try {
154
235
  // --- Focus change directive ---
155
236
  const changeFocusText = changeFocus ?? parseChangeFocusDirective(description);
@@ -204,9 +285,8 @@ export function handleFacilitate(params) {
204
285
  message: `Request is clear enough for \`${targetTool}\`. Proceed.`,
205
286
  });
206
287
  }
207
- // --- Main facilitate flow ---
288
+ // --- Main facilitate flow (legacy scenario-based) ---
208
289
  const scenario = explicitScenario ?? detectScenario(description);
209
- // Set initial focus for new sessions
210
290
  const existingFocus = getFocus(sessionKey);
211
291
  if (!existingFocus) {
212
292
  setFocus(sessionKey, {
@@ -214,12 +294,10 @@ export function handleFacilitate(params) {
214
294
  startedAt: new Date().toISOString(),
215
295
  });
216
296
  }
217
- // Generate expert observations (non-blocking)
218
297
  const observations = generateExpertObservations(description);
219
298
  let guidance;
220
299
  switch (scenario) {
221
300
  case 'new_project': {
222
- // Merge current description into collectedInfo for current step
223
301
  const updatedInfo = step === 0
224
302
  ? { ...collectedInfo, step0: description }
225
303
  : { ...collectedInfo, [`step${step}`]: description };
@@ -233,22 +311,21 @@ export function handleFacilitate(params) {
233
311
  guidance = buildConcreteProblemResponse(description);
234
312
  break;
235
313
  }
236
- const result = {
314
+ const legacyResult = {
237
315
  action: 'facilitate',
238
316
  scenario,
239
317
  step,
240
318
  guidance,
241
319
  };
242
320
  if (observations.length > 0) {
243
- result.expertObservations = observations;
244
- result.expertNote = 'Expert observations added below — these do not block execution.';
321
+ legacyResult.expertObservations = observations;
322
+ legacyResult.expertNote = 'Expert observations added below — these do not block execution.';
245
323
  }
246
- // SPEC-035b: Append paradigm expert voice observations when detection data is available
247
324
  const paradigmObservations = buildParadigmObservations(paradigmReport);
248
325
  if (paradigmObservations) {
249
- result.paradigmObservations = paradigmObservations;
326
+ legacyResult.paradigmObservations = paradigmObservations;
250
327
  }
251
- return ok(result);
328
+ return ok(legacyResult);
252
329
  }
253
330
  catch (error) {
254
331
  const message = error instanceof Error ? error.message : String(error);
@@ -1 +1 @@
1
- {"version":3,"file":"facilitate.js","sourceRoot":"","sources":["../../src/tools/facilitate.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"facilitate.js","sourceRoot":"","sources":["../../src/tools/facilitate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { z } from 'zod';
2
+ import type { ToolResult } from '../types/index.js';
3
+ export declare const GenerateAutomationGuideInputSchema: z.ZodObject<{
4
+ projectPath: z.ZodString;
5
+ saveToDisk: z.ZodOptional<z.ZodBoolean>;
6
+ includeExamples: z.ZodOptional<z.ZodBoolean>;
7
+ }, z.core.$strip>;
8
+ export type GenerateAutomationGuideInput = z.infer<typeof GenerateAutomationGuideInputSchema>;
9
+ export declare function handleGenerateAutomationGuide(args: GenerateAutomationGuideInput): Promise<ToolResult>;
10
+ //# sourceMappingURL=generate-automation-guide.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-automation-guide.d.ts","sourceRoot":"","sources":["../../src/tools/generate-automation-guide.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD,eAAO,MAAM,kCAAkC;;;;iBAO7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAoS9F,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,UAAU,CAAC,CAiCrB"}
@@ -0,0 +1,266 @@
1
+ // tools/generate-automation-guide.ts — Generate Claude Code automation guide (SPEC-257)
2
+ import { mkdir, writeFile } from 'fs/promises';
3
+ import { dirname } from 'path';
4
+ import { z } from 'zod';
5
+ import { buildClaudeCommand, generateStreamJsonPipeline, getJobPermissionMode, } from '../engine/ci-generator/output-formats.js';
6
+ export const GenerateAutomationGuideInputSchema = z.object({
7
+ projectPath: z.string().describe('Absolute path to the project root'),
8
+ saveToDisk: z.boolean().optional().describe('Save guide to docs/automation-guide.md'),
9
+ includeExamples: z
10
+ .boolean()
11
+ .optional()
12
+ .describe('Include code examples for each section (default: true)'),
13
+ });
14
+ function buildGuide(includeExamples) {
15
+ const sections = [];
16
+ sections.push('# Claude Code Automation Guide');
17
+ sections.push('');
18
+ sections.push('> This guide covers how to automate Claude Code in CI pipelines, scheduled tasks, and non-interactive workflows.');
19
+ sections.push('');
20
+ // Section 1: Non-interactive mode
21
+ sections.push('## 1. Non-Interactive Mode (`claude -p`)');
22
+ sections.push('');
23
+ sections.push('The `-p` flag runs Claude non-interactively — a single prompt, then Claude exits. Ideal for one-off queries and CI pipelines.');
24
+ sections.push('');
25
+ if (includeExamples) {
26
+ sections.push('```bash');
27
+ sections.push(buildClaudeCommand({ prompt: 'Summarize all failing tests', nonInteractive: true }));
28
+ sections.push(buildClaudeCommand({
29
+ prompt: 'Check for security issues',
30
+ nonInteractive: true,
31
+ permissionMode: 'plan',
32
+ }));
33
+ sections.push('```');
34
+ sections.push('');
35
+ }
36
+ // Section 2: Output formats
37
+ sections.push('## 2. Output Formats');
38
+ sections.push('');
39
+ sections.push('Three output formats are available. Choose based on your integration needs:');
40
+ sections.push('');
41
+ sections.push('| Format | Description | Best for |');
42
+ sections.push('|--------|-------------|----------|');
43
+ sections.push('| `text` | Plain text response (default) | Human-readable output, logs |');
44
+ sections.push('| `json` | Full conversation as JSON | Structured parsing, audit trails |');
45
+ sections.push('| `stream-json` | Real-time JSON events streamed | Live dashboards, piping to `jq` |');
46
+ sections.push('');
47
+ if (includeExamples) {
48
+ sections.push('```bash');
49
+ sections.push('# text (default)');
50
+ sections.push(buildClaudeCommand({ prompt: 'List all TODOs', nonInteractive: true }));
51
+ sections.push('');
52
+ sections.push('# json — full conversation object');
53
+ sections.push(buildClaudeCommand({
54
+ prompt: 'Audit dependencies',
55
+ nonInteractive: true,
56
+ outputFormat: 'json',
57
+ }));
58
+ sections.push('');
59
+ sections.push('# stream-json — pipe to jq for filtering');
60
+ sections.push(generateStreamJsonPipeline('Run linter and report issues', '.content'));
61
+ sections.push('```');
62
+ sections.push('');
63
+ }
64
+ // Section 3: Permission modes
65
+ sections.push('## 3. Permission Modes');
66
+ sections.push('');
67
+ sections.push('Permission modes control what actions Claude can take without asking for confirmation:');
68
+ sections.push('');
69
+ sections.push('| Mode | Description | When to use |');
70
+ sections.push('|------|-------------|-------------|');
71
+ sections.push('| `plan` | Read-only analysis — no file writes | Safe exploration, spec validation |');
72
+ sections.push('| `acceptEdits` | Can edit files, asks before running commands | Iterating on code while reviewing |');
73
+ sections.push('| `auto` | Long tasks, reduces prompt fatigue | Requires Team plan + Sonnet/Opus 4.6 |');
74
+ sections.push('| `dontAsk` | Pre-approved tools only, no confirmations | Locked CI environments |');
75
+ sections.push('| `bypassPermissions` | No safety checks — full autonomy | Containers/VMs only |');
76
+ sections.push('');
77
+ sections.push('**Recommended modes per CI job type:**');
78
+ sections.push('');
79
+ sections.push(`- validate → \`${getJobPermissionMode('validate')}\` — safe, read-only spec checks`);
80
+ sections.push(`- lint → \`${getJobPermissionMode('lint')}\` — pre-approved linting tools only`);
81
+ sections.push(`- migrate → \`${getJobPermissionMode('migrate')}\` — automated migrations with Team plan`);
82
+ sections.push(`- container → \`${getJobPermissionMode('container')}\` — full autonomy inside isolated VMs`);
83
+ sections.push(`- review → \`${getJobPermissionMode('review')}\` — edits files while you review commands`);
84
+ sections.push('');
85
+ if (includeExamples) {
86
+ sections.push('```bash');
87
+ sections.push(buildClaudeCommand({
88
+ prompt: 'validate all specs',
89
+ nonInteractive: true,
90
+ permissionMode: 'plan',
91
+ }));
92
+ sections.push('```');
93
+ sections.push('');
94
+ }
95
+ // Section 4: Scheduled tasks
96
+ sections.push('## 4. Scheduled Tasks');
97
+ sections.push('');
98
+ sections.push('Multiple scheduling options exist — choose based on your access requirements:');
99
+ sections.push('');
100
+ sections.push('| Method | Runs when offline | Access to | Best for |');
101
+ sections.push('|--------|-------------------|-----------|----------|');
102
+ sections.push('| **Cloud** (`claude.ai/code`) | Yes | Remote repos only | Background jobs independent of your machine |');
103
+ sections.push('| **Desktop** | No (requires local machine) | Local files, uncommitted changes | Dev-time checks on local work |');
104
+ sections.push('| **GitHub Actions** | Yes | Repo at event time | Repo-event-driven automation |');
105
+ sections.push('| **`/loop`** | No (session only) | Current context | Quick session-scoped repetition |');
106
+ sections.push('');
107
+ sections.push('> **Note**: `/loop` is cancelled when the session exits — not suitable for production automation.');
108
+ sections.push('');
109
+ // Section 5: Fan-out pattern
110
+ sections.push('## 5. Fan-Out Pattern');
111
+ sections.push('');
112
+ sections.push('Process multiple files in parallel by looping with `claude -p` and `--allowedTools`:');
113
+ sections.push('');
114
+ if (includeExamples) {
115
+ sections.push('```bash');
116
+ sections.push('# Fan-out: lint every changed file independently');
117
+ sections.push('for file in $(git diff --name-only HEAD~1); do');
118
+ sections.push(` ${buildClaudeCommand({
119
+ prompt: 'Review this file for issues: $file',
120
+ nonInteractive: true,
121
+ permissionMode: 'plan',
122
+ allowedTools: ['Read', 'Grep'],
123
+ })} &`);
124
+ sections.push('done');
125
+ sections.push('wait # wait for all parallel jobs');
126
+ sections.push('```');
127
+ sections.push('');
128
+ }
129
+ // Section 6: Session resume
130
+ sections.push('## 6. Session Resume');
131
+ sections.push('');
132
+ sections.push('Resume previous Claude sessions to maintain context across invocations:');
133
+ sections.push('');
134
+ sections.push('| Flag | Behavior |');
135
+ sections.push('|------|----------|');
136
+ sections.push('| `--continue` | Resume the most recent session |');
137
+ sections.push('| `--resume <name>` | Resume a named session by identifier |');
138
+ sections.push('| `--from-pr <N>` | Start a session pre-loaded with PR #N context |');
139
+ sections.push('');
140
+ if (includeExamples) {
141
+ sections.push('```bash');
142
+ sections.push('# Continue the last session and run non-interactively');
143
+ sections.push('claude --continue -p "Summarize what was accomplished in the last session"');
144
+ sections.push('');
145
+ sections.push('# Resume a named session');
146
+ sections.push('claude --resume my-migration-session -p "Continue the migration"');
147
+ sections.push('');
148
+ sections.push('# Start from a PR context');
149
+ sections.push('claude --from-pr 42 -p "Review the changes in this PR"');
150
+ sections.push('```');
151
+ sections.push('');
152
+ }
153
+ // Section 7: dontAsk for CI
154
+ sections.push('## 7. `dontAsk` for CI Environments');
155
+ sections.push('');
156
+ sections.push('Use `dontAsk` permission mode in locked CI environments where only pre-approved tools should run. Combined with `--allowedTools`, this gives deterministic, safe automation:');
157
+ sections.push('');
158
+ if (includeExamples) {
159
+ sections.push('```yaml');
160
+ sections.push('# .github/workflows/planu-validate.yml');
161
+ sections.push('name: Planu Spec Validation');
162
+ sections.push('');
163
+ sections.push('on:');
164
+ sections.push(' pull_request:');
165
+ sections.push(' branches: [main, develop]');
166
+ sections.push('');
167
+ sections.push('jobs:');
168
+ sections.push(' validate:');
169
+ sections.push(' name: Validate Specs');
170
+ sections.push(' runs-on: ubuntu-latest');
171
+ sections.push(' steps:');
172
+ sections.push(' - uses: actions/checkout@v4');
173
+ sections.push('');
174
+ sections.push(' - name: Install Claude Code');
175
+ sections.push(' run: npm install -g @anthropic-ai/claude-code');
176
+ sections.push('');
177
+ sections.push(' - name: Validate all specs');
178
+ sections.push(` run: ${buildClaudeCommand({
179
+ prompt: 'validate all specs and report any issues',
180
+ nonInteractive: true,
181
+ permissionMode: 'dontAsk',
182
+ allowedTools: ['Read', 'Glob', 'Grep'],
183
+ })}`);
184
+ sections.push(' env:');
185
+ sections.push(' ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}');
186
+ sections.push('```');
187
+ sections.push('');
188
+ }
189
+ // Section 8: Agent Teams Orchestration
190
+ sections.push('## 8. Agent Teams Orchestration');
191
+ sections.push('');
192
+ sections.push('When implementing 3+ independent specs in parallel, use Agent Teams to maximize throughput:');
193
+ sections.push('');
194
+ sections.push('**When to use teams:**');
195
+ sections.push('- 3+ specs are approved and ready to implement simultaneously');
196
+ sections.push('- Estimated total effort > 8h');
197
+ sections.push('- Specs touch different modules (clear file ownership boundaries)');
198
+ sections.push('- Monorepo or multi-layer architecture');
199
+ sections.push('');
200
+ if (includeExamples) {
201
+ sections.push('```bash');
202
+ sections.push('# Step 1: Plan team distribution — assigns exclusive file ownership');
203
+ sections.push(buildClaudeCommand({
204
+ prompt: 'plan_team_distribution with specIds ["SPEC-010", "SPEC-011", "SPEC-012"]',
205
+ nonInteractive: true,
206
+ permissionMode: 'plan',
207
+ }));
208
+ sections.push('');
209
+ sections.push('# Step 2: Generate isolated prompt for each teammate');
210
+ sections.push(buildClaudeCommand({
211
+ prompt: 'generate_teammate_prompt for teammate assignment from plan_team_distribution',
212
+ nonInteractive: true,
213
+ permissionMode: 'plan',
214
+ }));
215
+ sections.push('');
216
+ sections.push('# Step 3: Spawn N agents in parallel (one per teammate)');
217
+ sections.push('claude -p "<teammate-1-prompt>" &');
218
+ sections.push('claude -p "<teammate-2-prompt>" &');
219
+ sections.push('claude -p "<teammate-3-prompt>" &');
220
+ sections.push('wait # wait for all agents to complete');
221
+ sections.push('');
222
+ sections.push('# Step 4: Validate merged results');
223
+ sections.push(buildClaudeCommand({
224
+ prompt: 'validate_team_results for projectPath /path/to/project',
225
+ nonInteractive: true,
226
+ permissionMode: 'plan',
227
+ }));
228
+ sections.push('```');
229
+ sections.push('');
230
+ }
231
+ sections.push('> See `.claude/rules/agent-teams.md` for full rules on file ownership and team patterns.');
232
+ sections.push('');
233
+ return sections.join('\n');
234
+ }
235
+ export async function handleGenerateAutomationGuide(args) {
236
+ const includeExamples = args.includeExamples ?? true;
237
+ const guide = buildGuide(includeExamples);
238
+ if (args.saveToDisk === true) {
239
+ const outputPath = `${args.projectPath}/docs/automation-guide.md`;
240
+ await mkdir(dirname(outputPath), { recursive: true });
241
+ await writeFile(outputPath, guide, 'utf-8');
242
+ return {
243
+ content: [
244
+ {
245
+ type: 'text',
246
+ text: [
247
+ '## Automation Guide Generated',
248
+ '',
249
+ `Saved to: \`${outputPath}\``,
250
+ '',
251
+ guide,
252
+ ].join('\n'),
253
+ },
254
+ ],
255
+ };
256
+ }
257
+ return {
258
+ content: [
259
+ {
260
+ type: 'text',
261
+ text: guide,
262
+ },
263
+ ],
264
+ };
265
+ }
266
+ //# sourceMappingURL=generate-automation-guide.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-automation-guide.js","sourceRoot":"","sources":["../../src/tools/generate-automation-guide.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import { z } from 'zod';
2
+ import type { BatchScriptInput, ToolResult } from '../types/index.js';
3
+ export declare const GenerateBatchScriptInputSchema: z.ZodObject<{
4
+ projectPath: z.ZodString;
5
+ taskDescription: z.ZodString;
6
+ fileGlob: z.ZodString;
7
+ specId: z.ZodOptional<z.ZodString>;
8
+ allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
9
+ outputFormat: z.ZodOptional<z.ZodEnum<{
10
+ text: "text";
11
+ json: "json";
12
+ "stream-json": "stream-json";
13
+ }>>;
14
+ permissionMode: z.ZodOptional<z.ZodEnum<{
15
+ auto: "auto";
16
+ dontAsk: "dontAsk";
17
+ default: "default";
18
+ }>>;
19
+ pilotCount: z.ZodOptional<z.ZodNumber>;
20
+ dryRun: z.ZodOptional<z.ZodBoolean>;
21
+ }, z.core.$strip>;
22
+ /**
23
+ * Handle the generate_batch_script tool.
24
+ * Generates full and pilot bash scripts for fan-out batch processing with claude -p.
25
+ */
26
+ export declare function handleGenerateBatchScript(args: BatchScriptInput): Promise<ToolResult>;
27
+ //# sourceMappingURL=generate-batch-script.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-batch-script.d.ts","sourceRoot":"","sources":["../../src/tools/generate-batch-script.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;iBAsCzC,CAAC;AAEH;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAsCrB"}