@planu/cli 1.1.1 → 1.2.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 (459) hide show
  1. package/dist/config/license-plans.json +110 -9
  2. package/dist/config/spec-cookbook.json +341 -0
  3. package/dist/engine/asana-sync.d.ts +12 -0
  4. package/dist/engine/asana-sync.d.ts.map +1 -0
  5. package/dist/engine/asana-sync.js +72 -0
  6. package/dist/engine/asana-sync.js.map +1 -0
  7. package/dist/engine/code-impact-analyzer.d.ts +6 -0
  8. package/dist/engine/code-impact-analyzer.d.ts.map +1 -0
  9. package/dist/engine/code-impact-analyzer.js +152 -0
  10. package/dist/engine/code-impact-analyzer.js.map +1 -0
  11. package/dist/engine/compliance-reporter.d.ts +11 -0
  12. package/dist/engine/compliance-reporter.d.ts.map +1 -0
  13. package/dist/engine/compliance-reporter.js +245 -0
  14. package/dist/engine/compliance-reporter.js.map +1 -0
  15. package/dist/engine/context-manager.d.ts +7 -0
  16. package/dist/engine/context-manager.d.ts.map +1 -0
  17. package/dist/engine/context-manager.js +76 -0
  18. package/dist/engine/context-manager.js.map +1 -0
  19. package/dist/engine/cost-budget-manager.d.ts +10 -0
  20. package/dist/engine/cost-budget-manager.d.ts.map +1 -0
  21. package/dist/engine/cost-budget-manager.js +165 -0
  22. package/dist/engine/cost-budget-manager.js.map +1 -0
  23. package/dist/engine/dependency-impact-analyzer.d.ts +14 -0
  24. package/dist/engine/dependency-impact-analyzer.d.ts.map +1 -0
  25. package/dist/engine/dependency-impact-analyzer.js +133 -0
  26. package/dist/engine/dependency-impact-analyzer.js.map +1 -0
  27. package/dist/engine/diff-spec-generator.d.ts +6 -0
  28. package/dist/engine/diff-spec-generator.d.ts.map +1 -0
  29. package/dist/engine/diff-spec-generator.js +181 -0
  30. package/dist/engine/diff-spec-generator.js.map +1 -0
  31. package/dist/engine/drift-monitor.d.ts +5 -0
  32. package/dist/engine/drift-monitor.d.ts.map +1 -0
  33. package/dist/engine/drift-monitor.js +92 -0
  34. package/dist/engine/drift-monitor.js.map +1 -0
  35. package/dist/engine/global-rules-manager.d.ts +10 -0
  36. package/dist/engine/global-rules-manager.d.ts.map +1 -0
  37. package/dist/engine/global-rules-manager.js +214 -0
  38. package/dist/engine/global-rules-manager.js.map +1 -0
  39. package/dist/engine/knowledge-base.d.ts +12 -0
  40. package/dist/engine/knowledge-base.d.ts.map +1 -0
  41. package/dist/engine/knowledge-base.js +250 -0
  42. package/dist/engine/knowledge-base.js.map +1 -0
  43. package/dist/engine/monday-sync.d.ts +10 -0
  44. package/dist/engine/monday-sync.d.ts.map +1 -0
  45. package/dist/engine/monday-sync.js +56 -0
  46. package/dist/engine/monday-sync.js.map +1 -0
  47. package/dist/engine/notion-sync.d.ts +13 -0
  48. package/dist/engine/notion-sync.d.ts.map +1 -0
  49. package/dist/engine/notion-sync.js +87 -0
  50. package/dist/engine/notion-sync.js.map +1 -0
  51. package/dist/engine/onboarding-engine.d.ts +11 -0
  52. package/dist/engine/onboarding-engine.d.ts.map +1 -0
  53. package/dist/engine/onboarding-engine.js +575 -0
  54. package/dist/engine/onboarding-engine.js.map +1 -0
  55. package/dist/engine/parallel-safety-engine.d.ts +8 -0
  56. package/dist/engine/parallel-safety-engine.d.ts.map +1 -0
  57. package/dist/engine/parallel-safety-engine.js +106 -0
  58. package/dist/engine/parallel-safety-engine.js.map +1 -0
  59. package/dist/engine/schema-generator.d.ts +6 -0
  60. package/dist/engine/schema-generator.d.ts.map +1 -0
  61. package/dist/engine/schema-generator.js +321 -0
  62. package/dist/engine/schema-generator.js.map +1 -0
  63. package/dist/engine/spec-cookbook.d.ts +12 -0
  64. package/dist/engine/spec-cookbook.d.ts.map +1 -0
  65. package/dist/engine/spec-cookbook.js +176 -0
  66. package/dist/engine/spec-cookbook.js.map +1 -0
  67. package/dist/engine/spec-diff-engine.d.ts +8 -0
  68. package/dist/engine/spec-diff-engine.d.ts.map +1 -0
  69. package/dist/engine/spec-diff-engine.js +321 -0
  70. package/dist/engine/spec-diff-engine.js.map +1 -0
  71. package/dist/engine/spec-hooks-engine.d.ts +12 -0
  72. package/dist/engine/spec-hooks-engine.d.ts.map +1 -0
  73. package/dist/engine/spec-hooks-engine.js +79 -0
  74. package/dist/engine/spec-hooks-engine.js.map +1 -0
  75. package/dist/engine/spec-lint-engine.d.ts +6 -0
  76. package/dist/engine/spec-lint-engine.d.ts.map +1 -0
  77. package/dist/engine/spec-lint-engine.js +164 -0
  78. package/dist/engine/spec-lint-engine.js.map +1 -0
  79. package/dist/engine/spec-scheduler.d.ts +13 -0
  80. package/dist/engine/spec-scheduler.d.ts.map +1 -0
  81. package/dist/engine/spec-scheduler.js +154 -0
  82. package/dist/engine/spec-scheduler.js.map +1 -0
  83. package/dist/engine/spec-source-sync.d.ts +14 -0
  84. package/dist/engine/spec-source-sync.d.ts.map +1 -0
  85. package/dist/engine/spec-source-sync.js +148 -0
  86. package/dist/engine/spec-source-sync.js.map +1 -0
  87. package/dist/engine/tech-debt-manager.d.ts +12 -0
  88. package/dist/engine/tech-debt-manager.d.ts.map +1 -0
  89. package/dist/engine/tech-debt-manager.js +152 -0
  90. package/dist/engine/tech-debt-manager.js.map +1 -0
  91. package/dist/engine/validation-loop.d.ts +4 -0
  92. package/dist/engine/validation-loop.d.ts.map +1 -0
  93. package/dist/engine/validation-loop.js +133 -0
  94. package/dist/engine/validation-loop.js.map +1 -0
  95. package/dist/engine/webhook-server.d.ts +19 -0
  96. package/dist/engine/webhook-server.d.ts.map +1 -0
  97. package/dist/engine/webhook-server.js +169 -0
  98. package/dist/engine/webhook-server.js.map +1 -0
  99. package/dist/engine/workspace-manager.d.ts +8 -0
  100. package/dist/engine/workspace-manager.d.ts.map +1 -0
  101. package/dist/engine/workspace-manager.js +255 -0
  102. package/dist/engine/workspace-manager.js.map +1 -0
  103. package/dist/index.js +50 -0
  104. package/dist/index.js.map +1 -1
  105. package/dist/storage/api-surfaces-store.d.ts +8 -0
  106. package/dist/storage/api-surfaces-store.d.ts.map +1 -0
  107. package/dist/storage/api-surfaces-store.js +31 -0
  108. package/dist/storage/api-surfaces-store.js.map +1 -0
  109. package/dist/storage/asana-config-store.d.ts +9 -0
  110. package/dist/storage/asana-config-store.d.ts.map +1 -0
  111. package/dist/storage/asana-config-store.js +51 -0
  112. package/dist/storage/asana-config-store.js.map +1 -0
  113. package/dist/storage/context-config-store.d.ts +4 -0
  114. package/dist/storage/context-config-store.d.ts.map +1 -0
  115. package/dist/storage/context-config-store.js +20 -0
  116. package/dist/storage/context-config-store.js.map +1 -0
  117. package/dist/storage/cost-budget-store.d.ts +6 -0
  118. package/dist/storage/cost-budget-store.d.ts.map +1 -0
  119. package/dist/storage/cost-budget-store.js +42 -0
  120. package/dist/storage/cost-budget-store.js.map +1 -0
  121. package/dist/storage/drift-monitor-store.d.ts +9 -0
  122. package/dist/storage/drift-monitor-store.d.ts.map +1 -0
  123. package/dist/storage/drift-monitor-store.js +45 -0
  124. package/dist/storage/drift-monitor-store.js.map +1 -0
  125. package/dist/storage/monday-config-store.d.ts +9 -0
  126. package/dist/storage/monday-config-store.d.ts.map +1 -0
  127. package/dist/storage/monday-config-store.js +51 -0
  128. package/dist/storage/monday-config-store.js.map +1 -0
  129. package/dist/storage/notion-config-store.d.ts +9 -0
  130. package/dist/storage/notion-config-store.d.ts.map +1 -0
  131. package/dist/storage/notion-config-store.js +51 -0
  132. package/dist/storage/notion-config-store.js.map +1 -0
  133. package/dist/storage/onboarding-store.d.ts +4 -0
  134. package/dist/storage/onboarding-store.d.ts.map +1 -0
  135. package/dist/storage/onboarding-store.js +14 -0
  136. package/dist/storage/onboarding-store.js.map +1 -0
  137. package/dist/storage/retention-policy-store.d.ts +4 -0
  138. package/dist/storage/retention-policy-store.d.ts.map +1 -0
  139. package/dist/storage/retention-policy-store.js +20 -0
  140. package/dist/storage/retention-policy-store.js.map +1 -0
  141. package/dist/storage/spec-bindings-store.d.ts +8 -0
  142. package/dist/storage/spec-bindings-store.d.ts.map +1 -0
  143. package/dist/storage/spec-bindings-store.js +44 -0
  144. package/dist/storage/spec-bindings-store.js.map +1 -0
  145. package/dist/storage/spec-hooks-store.d.ts +8 -0
  146. package/dist/storage/spec-hooks-store.d.ts.map +1 -0
  147. package/dist/storage/spec-hooks-store.js +56 -0
  148. package/dist/storage/spec-hooks-store.js.map +1 -0
  149. package/dist/storage/spec-lint-rules-store.d.ts +5 -0
  150. package/dist/storage/spec-lint-rules-store.d.ts.map +1 -0
  151. package/dist/storage/spec-lint-rules-store.js +40 -0
  152. package/dist/storage/spec-lint-rules-store.js.map +1 -0
  153. package/dist/storage/tech-debt-store.d.ts +12 -0
  154. package/dist/storage/tech-debt-store.d.ts.map +1 -0
  155. package/dist/storage/tech-debt-store.js +51 -0
  156. package/dist/storage/tech-debt-store.js.map +1 -0
  157. package/dist/storage/webhook-server-store.d.ts +5 -0
  158. package/dist/storage/webhook-server-store.d.ts.map +1 -0
  159. package/dist/storage/webhook-server-store.js +14 -0
  160. package/dist/storage/webhook-server-store.js.map +1 -0
  161. package/dist/tools/asana-handler.d.ts +6 -0
  162. package/dist/tools/asana-handler.d.ts.map +1 -0
  163. package/dist/tools/asana-handler.js +199 -0
  164. package/dist/tools/asana-handler.js.map +1 -0
  165. package/dist/tools/code-impact-handler.d.ts +6 -0
  166. package/dist/tools/code-impact-handler.d.ts.map +1 -0
  167. package/dist/tools/code-impact-handler.js +158 -0
  168. package/dist/tools/code-impact-handler.js.map +1 -0
  169. package/dist/tools/compliance-audit-handler.d.ts +6 -0
  170. package/dist/tools/compliance-audit-handler.d.ts.map +1 -0
  171. package/dist/tools/compliance-audit-handler.js +87 -0
  172. package/dist/tools/compliance-audit-handler.js.map +1 -0
  173. package/dist/tools/context-manager-handler.d.ts +8 -0
  174. package/dist/tools/context-manager-handler.d.ts.map +1 -0
  175. package/dist/tools/context-manager-handler.js +180 -0
  176. package/dist/tools/context-manager-handler.js.map +1 -0
  177. package/dist/tools/cost-budget-handler.d.ts +7 -0
  178. package/dist/tools/cost-budget-handler.d.ts.map +1 -0
  179. package/dist/tools/cost-budget-handler.js +242 -0
  180. package/dist/tools/cost-budget-handler.js.map +1 -0
  181. package/dist/tools/dependency-impact-handler.d.ts +6 -0
  182. package/dist/tools/dependency-impact-handler.d.ts.map +1 -0
  183. package/dist/tools/dependency-impact-handler.js +100 -0
  184. package/dist/tools/dependency-impact-handler.js.map +1 -0
  185. package/dist/tools/diff-spec-generator-handler.d.ts +22 -0
  186. package/dist/tools/diff-spec-generator-handler.d.ts.map +1 -0
  187. package/dist/tools/diff-spec-generator-handler.js +87 -0
  188. package/dist/tools/diff-spec-generator-handler.js.map +1 -0
  189. package/dist/tools/drift-monitor-handler.d.ts +25 -0
  190. package/dist/tools/drift-monitor-handler.d.ts.map +1 -0
  191. package/dist/tools/drift-monitor-handler.js +95 -0
  192. package/dist/tools/drift-monitor-handler.js.map +1 -0
  193. package/dist/tools/global-rules-handler.d.ts +17 -0
  194. package/dist/tools/global-rules-handler.d.ts.map +1 -0
  195. package/dist/tools/global-rules-handler.js +178 -0
  196. package/dist/tools/global-rules-handler.js.map +1 -0
  197. package/dist/tools/incoming-webhook-handler.d.ts +6 -0
  198. package/dist/tools/incoming-webhook-handler.d.ts.map +1 -0
  199. package/dist/tools/incoming-webhook-handler.js +247 -0
  200. package/dist/tools/incoming-webhook-handler.js.map +1 -0
  201. package/dist/tools/knowledge-base-handler.d.ts +7 -0
  202. package/dist/tools/knowledge-base-handler.d.ts.map +1 -0
  203. package/dist/tools/knowledge-base-handler.js +137 -0
  204. package/dist/tools/knowledge-base-handler.js.map +1 -0
  205. package/dist/tools/monday-handler.d.ts +6 -0
  206. package/dist/tools/monday-handler.d.ts.map +1 -0
  207. package/dist/tools/monday-handler.js +190 -0
  208. package/dist/tools/monday-handler.js.map +1 -0
  209. package/dist/tools/notion-handler.d.ts +6 -0
  210. package/dist/tools/notion-handler.d.ts.map +1 -0
  211. package/dist/tools/notion-handler.js +197 -0
  212. package/dist/tools/notion-handler.js.map +1 -0
  213. package/dist/tools/onboarding-handler.d.ts +7 -0
  214. package/dist/tools/onboarding-handler.d.ts.map +1 -0
  215. package/dist/tools/onboarding-handler.js +59 -0
  216. package/dist/tools/onboarding-handler.js.map +1 -0
  217. package/dist/tools/parallel-safety-handler.d.ts +7 -0
  218. package/dist/tools/parallel-safety-handler.d.ts.map +1 -0
  219. package/dist/tools/parallel-safety-handler.js +29 -0
  220. package/dist/tools/parallel-safety-handler.js.map +1 -0
  221. package/dist/tools/register-asana-tools.d.ts +3 -0
  222. package/dist/tools/register-asana-tools.d.ts.map +1 -0
  223. package/dist/tools/register-asana-tools.js +74 -0
  224. package/dist/tools/register-asana-tools.js.map +1 -0
  225. package/dist/tools/register-code-impact-tools.d.ts +3 -0
  226. package/dist/tools/register-code-impact-tools.d.ts.map +1 -0
  227. package/dist/tools/register-code-impact-tools.js +58 -0
  228. package/dist/tools/register-code-impact-tools.js.map +1 -0
  229. package/dist/tools/register-compliance-audit-tools.d.ts +3 -0
  230. package/dist/tools/register-compliance-audit-tools.d.ts.map +1 -0
  231. package/dist/tools/register-compliance-audit-tools.js +106 -0
  232. package/dist/tools/register-compliance-audit-tools.js.map +1 -0
  233. package/dist/tools/register-context-manager-tools.d.ts +3 -0
  234. package/dist/tools/register-context-manager-tools.d.ts.map +1 -0
  235. package/dist/tools/register-context-manager-tools.js +138 -0
  236. package/dist/tools/register-context-manager-tools.js.map +1 -0
  237. package/dist/tools/register-cost-budget-tools.d.ts +3 -0
  238. package/dist/tools/register-cost-budget-tools.d.ts.map +1 -0
  239. package/dist/tools/register-cost-budget-tools.js +98 -0
  240. package/dist/tools/register-cost-budget-tools.js.map +1 -0
  241. package/dist/tools/register-dependency-impact-tools.d.ts +3 -0
  242. package/dist/tools/register-dependency-impact-tools.d.ts.map +1 -0
  243. package/dist/tools/register-dependency-impact-tools.js +63 -0
  244. package/dist/tools/register-dependency-impact-tools.js.map +1 -0
  245. package/dist/tools/register-diff-spec-tools.d.ts +3 -0
  246. package/dist/tools/register-diff-spec-tools.d.ts.map +1 -0
  247. package/dist/tools/register-diff-spec-tools.js +55 -0
  248. package/dist/tools/register-diff-spec-tools.js.map +1 -0
  249. package/dist/tools/register-drift-monitor-tools.d.ts +3 -0
  250. package/dist/tools/register-drift-monitor-tools.d.ts.map +1 -0
  251. package/dist/tools/register-drift-monitor-tools.js +64 -0
  252. package/dist/tools/register-drift-monitor-tools.js.map +1 -0
  253. package/dist/tools/register-global-rules-tools.d.ts +3 -0
  254. package/dist/tools/register-global-rules-tools.d.ts.map +1 -0
  255. package/dist/tools/register-global-rules-tools.js +44 -0
  256. package/dist/tools/register-global-rules-tools.js.map +1 -0
  257. package/dist/tools/register-incoming-webhook-tools.d.ts +3 -0
  258. package/dist/tools/register-incoming-webhook-tools.d.ts.map +1 -0
  259. package/dist/tools/register-incoming-webhook-tools.js +50 -0
  260. package/dist/tools/register-incoming-webhook-tools.js.map +1 -0
  261. package/dist/tools/register-knowledge-base-tools.d.ts +3 -0
  262. package/dist/tools/register-knowledge-base-tools.d.ts.map +1 -0
  263. package/dist/tools/register-knowledge-base-tools.js +66 -0
  264. package/dist/tools/register-knowledge-base-tools.js.map +1 -0
  265. package/dist/tools/register-monday-tools.d.ts +3 -0
  266. package/dist/tools/register-monday-tools.d.ts.map +1 -0
  267. package/dist/tools/register-monday-tools.js +69 -0
  268. package/dist/tools/register-monday-tools.js.map +1 -0
  269. package/dist/tools/register-notion-tools.d.ts +3 -0
  270. package/dist/tools/register-notion-tools.d.ts.map +1 -0
  271. package/dist/tools/register-notion-tools.js +76 -0
  272. package/dist/tools/register-notion-tools.js.map +1 -0
  273. package/dist/tools/register-onboarding-tools.d.ts +3 -0
  274. package/dist/tools/register-onboarding-tools.d.ts.map +1 -0
  275. package/dist/tools/register-onboarding-tools.js +70 -0
  276. package/dist/tools/register-onboarding-tools.js.map +1 -0
  277. package/dist/tools/register-parallel-safety-tools.d.ts +3 -0
  278. package/dist/tools/register-parallel-safety-tools.d.ts.map +1 -0
  279. package/dist/tools/register-parallel-safety-tools.js +18 -0
  280. package/dist/tools/register-parallel-safety-tools.js.map +1 -0
  281. package/dist/tools/register-schema-generator-tools.d.ts +3 -0
  282. package/dist/tools/register-schema-generator-tools.d.ts.map +1 -0
  283. package/dist/tools/register-schema-generator-tools.js +46 -0
  284. package/dist/tools/register-schema-generator-tools.js.map +1 -0
  285. package/dist/tools/register-spec-cookbook-tools.d.ts +3 -0
  286. package/dist/tools/register-spec-cookbook-tools.d.ts.map +1 -0
  287. package/dist/tools/register-spec-cookbook-tools.js +90 -0
  288. package/dist/tools/register-spec-cookbook-tools.js.map +1 -0
  289. package/dist/tools/register-spec-diff-tools.d.ts +3 -0
  290. package/dist/tools/register-spec-diff-tools.d.ts.map +1 -0
  291. package/dist/tools/register-spec-diff-tools.js +67 -0
  292. package/dist/tools/register-spec-diff-tools.js.map +1 -0
  293. package/dist/tools/register-spec-hooks-tools.d.ts +3 -0
  294. package/dist/tools/register-spec-hooks-tools.d.ts.map +1 -0
  295. package/dist/tools/register-spec-hooks-tools.js +124 -0
  296. package/dist/tools/register-spec-hooks-tools.js.map +1 -0
  297. package/dist/tools/register-spec-lint-tools.d.ts +3 -0
  298. package/dist/tools/register-spec-lint-tools.d.ts.map +1 -0
  299. package/dist/tools/register-spec-lint-tools.js +79 -0
  300. package/dist/tools/register-spec-lint-tools.js.map +1 -0
  301. package/dist/tools/register-spec-scheduler-tools.d.ts +3 -0
  302. package/dist/tools/register-spec-scheduler-tools.d.ts.map +1 -0
  303. package/dist/tools/register-spec-scheduler-tools.js +73 -0
  304. package/dist/tools/register-spec-scheduler-tools.js.map +1 -0
  305. package/dist/tools/register-spec-source-tools.d.ts +3 -0
  306. package/dist/tools/register-spec-source-tools.d.ts.map +1 -0
  307. package/dist/tools/register-spec-source-tools.js +48 -0
  308. package/dist/tools/register-spec-source-tools.js.map +1 -0
  309. package/dist/tools/register-tech-debt-tools.d.ts +3 -0
  310. package/dist/tools/register-tech-debt-tools.d.ts.map +1 -0
  311. package/dist/tools/register-tech-debt-tools.js +95 -0
  312. package/dist/tools/register-tech-debt-tools.js.map +1 -0
  313. package/dist/tools/register-validation-loop-tools.d.ts +3 -0
  314. package/dist/tools/register-validation-loop-tools.d.ts.map +1 -0
  315. package/dist/tools/register-validation-loop-tools.js +77 -0
  316. package/dist/tools/register-validation-loop-tools.js.map +1 -0
  317. package/dist/tools/register-workspace-dashboard-tools.d.ts +3 -0
  318. package/dist/tools/register-workspace-dashboard-tools.d.ts.map +1 -0
  319. package/dist/tools/register-workspace-dashboard-tools.js +98 -0
  320. package/dist/tools/register-workspace-dashboard-tools.js.map +1 -0
  321. package/dist/tools/schema-generator-handler.d.ts +4 -0
  322. package/dist/tools/schema-generator-handler.d.ts.map +1 -0
  323. package/dist/tools/schema-generator-handler.js +129 -0
  324. package/dist/tools/schema-generator-handler.js.map +1 -0
  325. package/dist/tools/spec-cookbook-handler.d.ts +7 -0
  326. package/dist/tools/spec-cookbook-handler.d.ts.map +1 -0
  327. package/dist/tools/spec-cookbook-handler.js +83 -0
  328. package/dist/tools/spec-cookbook-handler.js.map +1 -0
  329. package/dist/tools/spec-hooks-handler.d.ts +7 -0
  330. package/dist/tools/spec-hooks-handler.d.ts.map +1 -0
  331. package/dist/tools/spec-hooks-handler.js +112 -0
  332. package/dist/tools/spec-hooks-handler.js.map +1 -0
  333. package/dist/tools/spec-lint-handler.d.ts +6 -0
  334. package/dist/tools/spec-lint-handler.d.ts.map +1 -0
  335. package/dist/tools/spec-lint-handler.js +165 -0
  336. package/dist/tools/spec-lint-handler.js.map +1 -0
  337. package/dist/tools/spec-scheduler-handler.d.ts +6 -0
  338. package/dist/tools/spec-scheduler-handler.d.ts.map +1 -0
  339. package/dist/tools/spec-scheduler-handler.js +108 -0
  340. package/dist/tools/spec-scheduler-handler.js.map +1 -0
  341. package/dist/tools/spec-source-handler.d.ts +21 -0
  342. package/dist/tools/spec-source-handler.d.ts.map +1 -0
  343. package/dist/tools/spec-source-handler.js +75 -0
  344. package/dist/tools/spec-source-handler.js.map +1 -0
  345. package/dist/tools/spec-visual-diff-handler.d.ts +7 -0
  346. package/dist/tools/spec-visual-diff-handler.d.ts.map +1 -0
  347. package/dist/tools/spec-visual-diff-handler.js +130 -0
  348. package/dist/tools/spec-visual-diff-handler.js.map +1 -0
  349. package/dist/tools/tech-debt-handler.d.ts +8 -0
  350. package/dist/tools/tech-debt-handler.d.ts.map +1 -0
  351. package/dist/tools/tech-debt-handler.js +150 -0
  352. package/dist/tools/tech-debt-handler.js.map +1 -0
  353. package/dist/tools/validation-loop-handler.d.ts +5 -0
  354. package/dist/tools/validation-loop-handler.d.ts.map +1 -0
  355. package/dist/tools/validation-loop-handler.js +59 -0
  356. package/dist/tools/validation-loop-handler.js.map +1 -0
  357. package/dist/tools/workspace-dashboard-handler.d.ts +8 -0
  358. package/dist/tools/workspace-dashboard-handler.d.ts.map +1 -0
  359. package/dist/tools/workspace-dashboard-handler.js +108 -0
  360. package/dist/tools/workspace-dashboard-handler.js.map +1 -0
  361. package/dist/types/code-impact.d.ts +57 -0
  362. package/dist/types/code-impact.d.ts.map +1 -0
  363. package/dist/types/code-impact.js +3 -0
  364. package/dist/types/code-impact.js.map +1 -0
  365. package/dist/types/compliance-audit.d.ts +55 -0
  366. package/dist/types/compliance-audit.d.ts.map +1 -0
  367. package/dist/types/compliance-audit.js +3 -0
  368. package/dist/types/compliance-audit.js.map +1 -0
  369. package/dist/types/context-manager.d.ts +57 -0
  370. package/dist/types/context-manager.d.ts.map +1 -0
  371. package/dist/types/context-manager.js +3 -0
  372. package/dist/types/context-manager.js.map +1 -0
  373. package/dist/types/cost-budget.d.ts +84 -0
  374. package/dist/types/cost-budget.d.ts.map +1 -0
  375. package/dist/types/cost-budget.js +3 -0
  376. package/dist/types/cost-budget.js.map +1 -0
  377. package/dist/types/dependency-impact.d.ts +45 -0
  378. package/dist/types/dependency-impact.d.ts.map +1 -0
  379. package/dist/types/dependency-impact.js +3 -0
  380. package/dist/types/dependency-impact.js.map +1 -0
  381. package/dist/types/diff-spec-types.d.ts +39 -0
  382. package/dist/types/diff-spec-types.d.ts.map +1 -0
  383. package/dist/types/diff-spec-types.js +3 -0
  384. package/dist/types/diff-spec-types.js.map +1 -0
  385. package/dist/types/drift-monitor-types.d.ts +47 -0
  386. package/dist/types/drift-monitor-types.d.ts.map +1 -0
  387. package/dist/types/drift-monitor-types.js +3 -0
  388. package/dist/types/drift-monitor-types.js.map +1 -0
  389. package/dist/types/global-rules-types.d.ts +31 -0
  390. package/dist/types/global-rules-types.d.ts.map +1 -0
  391. package/dist/types/global-rules-types.js +3 -0
  392. package/dist/types/global-rules-types.js.map +1 -0
  393. package/dist/types/incoming-webhook.d.ts +40 -0
  394. package/dist/types/incoming-webhook.d.ts.map +1 -0
  395. package/dist/types/incoming-webhook.js +3 -0
  396. package/dist/types/incoming-webhook.js.map +1 -0
  397. package/dist/types/index.d.ts +23 -0
  398. package/dist/types/index.d.ts.map +1 -1
  399. package/dist/types/index.js +23 -0
  400. package/dist/types/index.js.map +1 -1
  401. package/dist/types/knowledge-base.d.ts +57 -0
  402. package/dist/types/knowledge-base.d.ts.map +1 -0
  403. package/dist/types/knowledge-base.js +3 -0
  404. package/dist/types/knowledge-base.js.map +1 -0
  405. package/dist/types/notion-asana-monday.d.ts +196 -0
  406. package/dist/types/notion-asana-monday.d.ts.map +1 -0
  407. package/dist/types/notion-asana-monday.js +3 -0
  408. package/dist/types/notion-asana-monday.js.map +1 -0
  409. package/dist/types/onboarding-types.d.ts +69 -0
  410. package/dist/types/onboarding-types.d.ts.map +1 -0
  411. package/dist/types/onboarding-types.js +3 -0
  412. package/dist/types/onboarding-types.js.map +1 -0
  413. package/dist/types/parallel-safety-types.d.ts +14 -0
  414. package/dist/types/parallel-safety-types.d.ts.map +1 -0
  415. package/dist/types/parallel-safety-types.js +3 -0
  416. package/dist/types/parallel-safety-types.js.map +1 -0
  417. package/dist/types/schema-generator.d.ts +61 -0
  418. package/dist/types/schema-generator.d.ts.map +1 -0
  419. package/dist/types/schema-generator.js +3 -0
  420. package/dist/types/schema-generator.js.map +1 -0
  421. package/dist/types/spec-cookbook-types.d.ts +45 -0
  422. package/dist/types/spec-cookbook-types.d.ts.map +1 -0
  423. package/dist/types/spec-cookbook-types.js +3 -0
  424. package/dist/types/spec-cookbook-types.js.map +1 -0
  425. package/dist/types/spec-diff-visual-types.d.ts +75 -0
  426. package/dist/types/spec-diff-visual-types.d.ts.map +1 -0
  427. package/dist/types/spec-diff-visual-types.js +3 -0
  428. package/dist/types/spec-diff-visual-types.js.map +1 -0
  429. package/dist/types/spec-hooks.d.ts +62 -0
  430. package/dist/types/spec-hooks.d.ts.map +1 -0
  431. package/dist/types/spec-hooks.js +3 -0
  432. package/dist/types/spec-hooks.js.map +1 -0
  433. package/dist/types/spec-lint.d.ts +79 -0
  434. package/dist/types/spec-lint.d.ts.map +1 -0
  435. package/dist/types/spec-lint.js +3 -0
  436. package/dist/types/spec-lint.js.map +1 -0
  437. package/dist/types/spec-scheduler.d.ts +58 -0
  438. package/dist/types/spec-scheduler.d.ts.map +1 -0
  439. package/dist/types/spec-scheduler.js +3 -0
  440. package/dist/types/spec-scheduler.js.map +1 -0
  441. package/dist/types/spec-source-types.d.ts +37 -0
  442. package/dist/types/spec-source-types.d.ts.map +1 -0
  443. package/dist/types/spec-source-types.js +3 -0
  444. package/dist/types/spec-source-types.js.map +1 -0
  445. package/dist/types/tech-debt.d.ts +66 -0
  446. package/dist/types/tech-debt.d.ts.map +1 -0
  447. package/dist/types/tech-debt.js +3 -0
  448. package/dist/types/tech-debt.js.map +1 -0
  449. package/dist/types/validation-loop.d.ts +39 -0
  450. package/dist/types/validation-loop.d.ts.map +1 -0
  451. package/dist/types/validation-loop.js +3 -0
  452. package/dist/types/validation-loop.js.map +1 -0
  453. package/dist/types/workspace-dashboard-types.d.ts +74 -0
  454. package/dist/types/workspace-dashboard-types.d.ts.map +1 -0
  455. package/dist/types/workspace-dashboard-types.js +3 -0
  456. package/dist/types/workspace-dashboard-types.js.map +1 -0
  457. package/package.json +2 -1
  458. package/src/config/license-plans.json +110 -9
  459. package/src/config/spec-cookbook.json +341 -0
@@ -0,0 +1,165 @@
1
+ // engine/cost-budget-manager.ts — Cost Budget & Alerts Manager (SPEC-367)
2
+ import { createHash } from 'node:crypto';
3
+ // ---------------------------------------------------------------------------
4
+ // ID generation
5
+ // ---------------------------------------------------------------------------
6
+ export function generateAlertRuleId(trigger, threshold) {
7
+ const hash = createHash('sha256')
8
+ .update(`${trigger}-${String(threshold)}-${Date.now()}`)
9
+ .digest('hex')
10
+ .slice(0, 8);
11
+ return `alert-${hash}`;
12
+ }
13
+ // ---------------------------------------------------------------------------
14
+ // Period spend calculation
15
+ // ---------------------------------------------------------------------------
16
+ function getPeriodStart(period) {
17
+ const now = new Date();
18
+ switch (period) {
19
+ case 'daily': {
20
+ const d = new Date(now);
21
+ d.setHours(0, 0, 0, 0);
22
+ return d;
23
+ }
24
+ case 'weekly': {
25
+ const d = new Date(now);
26
+ d.setDate(d.getDate() - 6);
27
+ d.setHours(0, 0, 0, 0);
28
+ return d;
29
+ }
30
+ case 'monthly': {
31
+ const d = new Date(now);
32
+ d.setDate(1);
33
+ d.setHours(0, 0, 0, 0);
34
+ return d;
35
+ }
36
+ case 'total':
37
+ return new Date(0);
38
+ }
39
+ }
40
+ function getDaysRemainingInPeriod(period) {
41
+ const now = new Date();
42
+ switch (period) {
43
+ case 'daily':
44
+ return 1;
45
+ case 'weekly': {
46
+ const start = getPeriodStart('weekly');
47
+ const total = 7;
48
+ const elapsed = Math.floor((now.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
49
+ return Math.max(0, total - elapsed);
50
+ }
51
+ case 'monthly': {
52
+ const lastDay = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
53
+ return lastDay - now.getDate() + 1;
54
+ }
55
+ case 'total':
56
+ return 365;
57
+ }
58
+ }
59
+ // ---------------------------------------------------------------------------
60
+ // Forecast
61
+ // ---------------------------------------------------------------------------
62
+ export function computeForecast(history, period, currency) {
63
+ const MIN_DATA_POINTS = 3;
64
+ const daysRemaining = getDaysRemainingInPeriod(period);
65
+ if (history.length < MIN_DATA_POINTS) {
66
+ const currentSpend = history.reduce((acc, h) => acc + h.spendUSD, 0);
67
+ return {
68
+ currentPeriodSpendUSD: currentSpend,
69
+ projectedPeriodSpendUSD: null,
70
+ daysRemaining,
71
+ currency,
72
+ dataPoints: history.length,
73
+ insufficientData: true,
74
+ };
75
+ }
76
+ const recentDays = history.slice(-7);
77
+ const avgDailySpend = recentDays.reduce((acc, h) => acc + h.spendUSD, 0) / recentDays.length;
78
+ const currentSpend = history.reduce((acc, h) => acc + h.spendUSD, 0);
79
+ const projectedRemaining = avgDailySpend * daysRemaining;
80
+ return {
81
+ currentPeriodSpendUSD: currentSpend,
82
+ projectedPeriodSpendUSD: currentSpend + projectedRemaining,
83
+ daysRemaining,
84
+ currency,
85
+ dataPoints: history.length,
86
+ insufficientData: false,
87
+ };
88
+ }
89
+ // ---------------------------------------------------------------------------
90
+ // Budget status
91
+ // ---------------------------------------------------------------------------
92
+ export function computeBudgetStatus(data, currentSpendUSD) {
93
+ if (data.budget === undefined) {
94
+ return {
95
+ budget: null,
96
+ currentSpendUSD,
97
+ percentUsed: null,
98
+ triggeredAlerts: [],
99
+ status: 'no-budget',
100
+ };
101
+ }
102
+ const budget = data.budget;
103
+ const percentUsed = (currentSpendUSD / budget.maxUSD) * 100;
104
+ const triggeredAlerts = [];
105
+ const now = new Date().toISOString();
106
+ for (const rule of data.alertRules) {
107
+ const shouldTrigger = shouldRuleTrigger(rule, currentSpendUSD, percentUsed, budget);
108
+ if (!shouldTrigger) {
109
+ continue;
110
+ }
111
+ // Check cooldown
112
+ if (rule.lastTriggeredAt !== undefined) {
113
+ const elapsed = (new Date(now).getTime() - new Date(rule.lastTriggeredAt).getTime()) / (1000 * 60);
114
+ if (elapsed < rule.cooldownMinutes) {
115
+ continue;
116
+ }
117
+ }
118
+ triggeredAlerts.push(`Alert "${rule.id}": ${rule.trigger} threshold ${String(rule.threshold)} reached ` +
119
+ `(current: ${currentSpendUSD.toFixed(4)} USD, ${percentUsed.toFixed(1)}%). ` +
120
+ `Channels: ${rule.channels.join(', ')}`);
121
+ }
122
+ let status;
123
+ if (percentUsed >= 100) {
124
+ status = 'critical';
125
+ }
126
+ else if (budget.alertThresholds.length > 0 &&
127
+ percentUsed >= (budget.alertThresholds[budget.alertThresholds.length - 1] ?? 80)) {
128
+ status = 'warning';
129
+ }
130
+ else {
131
+ status = 'ok';
132
+ }
133
+ return { budget, currentSpendUSD, percentUsed, triggeredAlerts, status };
134
+ }
135
+ function shouldRuleTrigger(rule, currentSpendUSD, percentUsed, _budget) {
136
+ if (rule.trigger === 'budget-percent') {
137
+ return percentUsed >= rule.threshold;
138
+ }
139
+ return currentSpendUSD >= rule.threshold;
140
+ }
141
+ // ---------------------------------------------------------------------------
142
+ // History helpers
143
+ // ---------------------------------------------------------------------------
144
+ export function buildHistoryFromEntries(entries, days) {
145
+ const cutoff = new Date();
146
+ cutoff.setDate(cutoff.getDate() - days);
147
+ const byDate = new Map();
148
+ for (const entry of entries) {
149
+ const entryDate = new Date(entry.timestamp);
150
+ if (entryDate < cutoff) {
151
+ continue;
152
+ }
153
+ const dateKey = entry.timestamp.slice(0, 10);
154
+ const existing = byDate.get(dateKey);
155
+ if (existing !== undefined) {
156
+ existing.spendUSD += entry.costUsd;
157
+ existing.tokens += entry.totalTokens;
158
+ }
159
+ else {
160
+ byDate.set(dateKey, { date: dateKey, spendUSD: entry.costUsd, tokens: entry.totalTokens });
161
+ }
162
+ }
163
+ return Array.from(byDate.values()).sort((a, b) => a.date.localeCompare(b.date));
164
+ }
165
+ //# sourceMappingURL=cost-budget-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cost-budget-manager.js","sourceRoot":"","sources":["../../src/engine/cost-budget-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { ApiSurface, BreakingChangesResult } from '../types/index.js';
2
+ /**
3
+ * Given a modified specId and a change description, find all other specs
4
+ * that have registered surfaces potentially impacted by the change.
5
+ */
6
+ export declare function analyzeBreakingChanges(sourceSpecId: string, changeDescription: string, allSurfaces: ApiSurface[]): BreakingChangesResult;
7
+ /** Generate HTML report for dependency impact analysis. */
8
+ export declare function generateImpactReport(result: BreakingChangesResult): string;
9
+ /** Check which specs depend on a given spec's surfaces. */
10
+ export declare function checkApiCompatibility(specId: string, allSurfaces: ApiSurface[]): {
11
+ dependents: string[];
12
+ surfaceCount: number;
13
+ };
14
+ //# sourceMappingURL=dependency-impact-analyzer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dependency-impact-analyzer.d.ts","sourceRoot":"","sources":["../../src/engine/dependency-impact-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAqC3B;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,UAAU,EAAE,GACxB,qBAAqB,CAwCvB;AAMD,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAuC1E;AAMD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,UAAU,EAAE,GACxB;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAuBhD"}
@@ -0,0 +1,133 @@
1
+ // ---------------------------------------------------------------------------
2
+ // Impact classification
3
+ // ---------------------------------------------------------------------------
4
+ /** Determine impact level based on surface types and breakingIfRemoved flag. */
5
+ function classifyImpact(surface) {
6
+ const hasBreaking = surface.surfaces.some((s) => s.isBreakingIfRemoved === true);
7
+ if (hasBreaking) {
8
+ return 'high';
9
+ }
10
+ const highImpactTypes = new Set(['rest-endpoint', 'database-schema', 'typescript-interface']);
11
+ const hasHighType = surface.surfaces.some((s) => highImpactTypes.has(s.type));
12
+ if (hasHighType) {
13
+ return 'medium';
14
+ }
15
+ return 'low';
16
+ }
17
+ /** Check if a surface references terms from a change description. */
18
+ function surfaceMatchesChange(surface, changeDescription) {
19
+ const descLower = changeDescription.toLowerCase();
20
+ return surface.surfaces.some((s) => {
21
+ const defLower = s.definition.toLowerCase();
22
+ // Check if any word in definition appears in change description
23
+ const words = defLower.split(/\s+/).filter((w) => w.length > 3);
24
+ return words.some((w) => descLower.includes(w));
25
+ });
26
+ }
27
+ // ---------------------------------------------------------------------------
28
+ // Analyze breaking changes
29
+ // ---------------------------------------------------------------------------
30
+ /**
31
+ * Given a modified specId and a change description, find all other specs
32
+ * that have registered surfaces potentially impacted by the change.
33
+ */
34
+ export function analyzeBreakingChanges(sourceSpecId, changeDescription, allSurfaces) {
35
+ const affectedSpecs = [];
36
+ for (const surface of allSurfaces) {
37
+ if (surface.specId === sourceSpecId) {
38
+ continue;
39
+ }
40
+ // Check if this spec references surfaces related to the changed spec
41
+ const isRelated = surfaceMatchesChange(surface, changeDescription);
42
+ if (!isRelated) {
43
+ continue;
44
+ }
45
+ const level = classifyImpact(surface);
46
+ affectedSpecs.push({
47
+ specId: surface.specId,
48
+ reason: `References surfaces that overlap with: "${changeDescription.slice(0, 80)}"`,
49
+ impactLevel: level,
50
+ });
51
+ }
52
+ // Overall impact = highest individual impact
53
+ let overallImpact = 'low';
54
+ for (const a of affectedSpecs) {
55
+ if (a.impactLevel === 'high') {
56
+ overallImpact = 'high';
57
+ break;
58
+ }
59
+ if (a.impactLevel === 'medium') {
60
+ overallImpact = 'medium';
61
+ }
62
+ }
63
+ return {
64
+ sourceSpecId,
65
+ changeDescription,
66
+ affectedSpecs,
67
+ overallImpact,
68
+ };
69
+ }
70
+ // ---------------------------------------------------------------------------
71
+ // HTML report
72
+ // ---------------------------------------------------------------------------
73
+ /** Generate HTML report for dependency impact analysis. */
74
+ export function generateImpactReport(result) {
75
+ const impactColor = {
76
+ high: '#dc2626',
77
+ medium: '#d97706',
78
+ low: '#16a34a',
79
+ };
80
+ const badge = (level) => `<span style="background:${impactColor[level]};color:#fff;padding:2px 6px;border-radius:4px;font-size:12px">${level}</span>`;
81
+ const rows = result.affectedSpecs
82
+ .map((a) => `
83
+ <tr>
84
+ <td>${a.specId}</td>
85
+ <td>${a.reason}</td>
86
+ <td>${badge(a.impactLevel)}</td>
87
+ </tr>`)
88
+ .join('');
89
+ return `<!DOCTYPE html>
90
+ <html>
91
+ <head><title>Dependency Impact Report</title>
92
+ <style>body{font-family:sans-serif;padding:20px}table{border-collapse:collapse;width:100%}
93
+ th,td{border:1px solid #ddd;padding:8px;text-align:left}th{background:#f3f4f6}</style>
94
+ </head>
95
+ <body>
96
+ <h1>Dependency Impact Report</h1>
97
+ <p>Source spec: <strong>${result.sourceSpecId}</strong></p>
98
+ <p>Change: <em>${result.changeDescription}</em></p>
99
+ <p>Overall impact: ${badge(result.overallImpact)}</p>
100
+ <h2>Affected Specs (${String(result.affectedSpecs.length)})</h2>
101
+ <table>
102
+ <tr><th>Spec ID</th><th>Reason</th><th>Impact</th></tr>
103
+ ${rows || '<tr><td colspan="3">No affected specs found.</td></tr>'}
104
+ </table>
105
+ </body>
106
+ </html>`;
107
+ }
108
+ // ---------------------------------------------------------------------------
109
+ // Compatibility check
110
+ // ---------------------------------------------------------------------------
111
+ /** Check which specs depend on a given spec's surfaces. */
112
+ export function checkApiCompatibility(specId, allSurfaces) {
113
+ const own = allSurfaces.find((s) => s.specId === specId);
114
+ if (!own) {
115
+ return { dependents: [], surfaceCount: 0 };
116
+ }
117
+ const ownTerms = own.surfaces
118
+ .flatMap((s) => s.definition.toLowerCase().split(/\s+/))
119
+ .filter((w) => w.length > 3);
120
+ const dependents = [];
121
+ for (const surface of allSurfaces) {
122
+ if (surface.specId === specId) {
123
+ continue;
124
+ }
125
+ const otherText = surface.surfaces.map((s) => s.definition.toLowerCase()).join(' ');
126
+ const overlaps = ownTerms.some((t) => otherText.includes(t));
127
+ if (overlaps) {
128
+ dependents.push(surface.specId);
129
+ }
130
+ }
131
+ return { dependents, surfaceCount: own.surfaces.length };
132
+ }
133
+ //# sourceMappingURL=dependency-impact-analyzer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dependency-impact-analyzer.js","sourceRoot":"","sources":["../../src/engine/dependency-impact-analyzer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { DiffAnalysis, GeneratedSpecDraft } from '../types/index.js';
2
+ export declare function analyzeDiff(rawDiff: string, commitRange?: string): DiffAnalysis;
3
+ export declare function generateSpecDraft(analysis: DiffAnalysis, sourceType: GeneratedSpecDraft['sourceType'], sourceRef: string, titleOverride?: string): GeneratedSpecDraft;
4
+ export declare function runGitDiff(repoPath: string, commitRange?: string): string;
5
+ export declare function runGhPrDiff(repoPath: string, prNumber: number): string;
6
+ //# sourceMappingURL=diff-spec-generator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diff-spec-generator.d.ts","sourceRoot":"","sources":["../../src/engine/diff-spec-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAgE/E;AAMD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAC5C,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,kBAAkB,CAkBpB;AAMD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAYzE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYtE"}
@@ -0,0 +1,181 @@
1
+ // engine/diff-spec-generator.ts — Diff-to-Spec generator (SPEC-350)
2
+ import { execSync } from 'node:child_process';
3
+ // ---------------------------------------------------------------------------
4
+ // Diff analysis
5
+ // ---------------------------------------------------------------------------
6
+ export function analyzeDiff(rawDiff, commitRange) {
7
+ const lines = rawDiff.split('\n');
8
+ const modifiedFiles = [];
9
+ const addedFiles = [];
10
+ const deletedFiles = [];
11
+ const addedFunctions = [];
12
+ const removedFunctions = [];
13
+ const addedEndpoints = [];
14
+ for (const line of lines) {
15
+ // File changes
16
+ if (line.startsWith('+++ b/')) {
17
+ const file = line.slice(6);
18
+ if (!modifiedFiles.includes(file)) {
19
+ modifiedFiles.push(file);
20
+ }
21
+ }
22
+ else if (line.startsWith('new file mode')) {
23
+ // handled below via diff --name-status
24
+ }
25
+ else if (line.startsWith('diff --git a/')) {
26
+ const parts = line.split(' b/');
27
+ if (parts[1] !== undefined && !modifiedFiles.includes(parts[1])) {
28
+ modifiedFiles.push(parts[1]);
29
+ }
30
+ }
31
+ // Added functions (TypeScript/JavaScript/Python)
32
+ const fnMatch = /^\+\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)/.exec(line);
33
+ if (fnMatch?.[1] !== undefined && !addedFunctions.includes(fnMatch[1])) {
34
+ addedFunctions.push(fnMatch[1]);
35
+ }
36
+ // Arrow function / method
37
+ const arrowMatch = /^\+\s*(?:export\s+)?(?:const|let)\s+(\w+)\s*=\s*(?:async\s*)?\(/.exec(line);
38
+ if (arrowMatch?.[1] !== undefined && !addedFunctions.includes(arrowMatch[1])) {
39
+ addedFunctions.push(arrowMatch[1]);
40
+ }
41
+ // Removed functions
42
+ const removedFnMatch = /^-\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)/.exec(line);
43
+ if (removedFnMatch?.[1] !== undefined && !removedFunctions.includes(removedFnMatch[1])) {
44
+ removedFunctions.push(removedFnMatch[1]);
45
+ }
46
+ // Endpoints (Express/Fastify/Hono pattern)
47
+ const endpointMatch = /^\+\s*(?:app|router|server)\.(get|post|put|patch|delete|head)\s*\(['"`]([^'"`]+)/.exec(line);
48
+ if (endpointMatch?.[1] !== undefined && endpointMatch[2] !== undefined) {
49
+ const ep = `${endpointMatch[1].toUpperCase()} ${endpointMatch[2]}`;
50
+ if (!addedEndpoints.includes(ep)) {
51
+ addedEndpoints.push(ep);
52
+ }
53
+ }
54
+ }
55
+ return {
56
+ modifiedFiles: [...new Set(modifiedFiles)],
57
+ addedFiles,
58
+ deletedFiles,
59
+ addedFunctions,
60
+ removedFunctions,
61
+ addedEndpoints,
62
+ rawDiff,
63
+ commitRange,
64
+ };
65
+ }
66
+ // ---------------------------------------------------------------------------
67
+ // Spec draft generation
68
+ // ---------------------------------------------------------------------------
69
+ export function generateSpecDraft(analysis, sourceType, sourceRef, titleOverride) {
70
+ const now = new Date().toISOString();
71
+ const title = titleOverride ?? inferTitle(analysis, sourceRef);
72
+ const description = buildDescription(analysis);
73
+ const acceptanceCriteria = buildCriteria(analysis);
74
+ const estimatedEffort = estimateEffort(analysis);
75
+ return {
76
+ title,
77
+ description,
78
+ acceptanceCriteria,
79
+ estimatedEffort,
80
+ affectedFiles: analysis.modifiedFiles,
81
+ sourceType,
82
+ sourceRef,
83
+ generatedAt: now,
84
+ };
85
+ }
86
+ // ---------------------------------------------------------------------------
87
+ // Git integration helpers
88
+ // ---------------------------------------------------------------------------
89
+ export function runGitDiff(repoPath, commitRange) {
90
+ const range = commitRange ?? 'HEAD~1..HEAD';
91
+ const cmd = `git -C "${repoPath}" diff ${range}`;
92
+ try {
93
+ return execSync(cmd, { encoding: 'utf-8', timeout: 15_000 });
94
+ }
95
+ catch (err) {
96
+ throw new Error(`Failed to run git diff: ${err instanceof Error ? err.message : String(err)}. ` +
97
+ `Ensure the path is a valid git repository.`, { cause: err });
98
+ }
99
+ }
100
+ export function runGhPrDiff(repoPath, prNumber) {
101
+ const cmd = `gh pr diff ${prNumber} --repo "${repoPath}"`;
102
+ try {
103
+ return execSync(cmd, { encoding: 'utf-8', timeout: 20_000 });
104
+ }
105
+ catch (err) {
106
+ throw new Error(`Failed to run gh pr diff: ${err instanceof Error ? err.message : String(err)}. ` +
107
+ `Ensure the GitHub CLI (gh) is installed and authenticated. ` +
108
+ `Run: gh auth login`, { cause: err });
109
+ }
110
+ }
111
+ // ---------------------------------------------------------------------------
112
+ // Internal helpers
113
+ // ---------------------------------------------------------------------------
114
+ function inferTitle(analysis, sourceRef) {
115
+ if (analysis.addedFunctions.length > 0) {
116
+ const names = analysis.addedFunctions.slice(0, 2).join(', ');
117
+ return `Add ${names}`;
118
+ }
119
+ if (analysis.addedEndpoints.length > 0) {
120
+ return `Add endpoints: ${analysis.addedEndpoints.slice(0, 2).join(', ')}`;
121
+ }
122
+ if (analysis.modifiedFiles.length > 0) {
123
+ const first = analysis.modifiedFiles[0] ?? '';
124
+ const base = first.split('/').pop() ?? first;
125
+ return `Update ${base}`;
126
+ }
127
+ return `Changes from ${sourceRef}`;
128
+ }
129
+ function buildDescription(analysis) {
130
+ const parts = [];
131
+ if (analysis.modifiedFiles.length > 0) {
132
+ parts.push(`Modified ${analysis.modifiedFiles.length} file(s): ${analysis.modifiedFiles.slice(0, 3).join(', ')}${analysis.modifiedFiles.length > 3 ? '...' : ''}.`);
133
+ }
134
+ if (analysis.addedFunctions.length > 0) {
135
+ parts.push(`Added functions: ${analysis.addedFunctions.join(', ')}.`);
136
+ }
137
+ if (analysis.removedFunctions.length > 0) {
138
+ parts.push(`Removed functions: ${analysis.removedFunctions.join(', ')}.`);
139
+ }
140
+ if (analysis.addedEndpoints.length > 0) {
141
+ parts.push(`New endpoints: ${analysis.addedEndpoints.join(', ')}.`);
142
+ }
143
+ return parts.length > 0 ? parts.join(' ') : 'Auto-generated spec from code changes.';
144
+ }
145
+ function buildCriteria(analysis) {
146
+ const criteria = [];
147
+ for (const fn of analysis.addedFunctions.slice(0, 5)) {
148
+ criteria.push(`${fn} function is implemented and returns expected output`);
149
+ }
150
+ for (const ep of analysis.addedEndpoints.slice(0, 5)) {
151
+ criteria.push(`${ep} endpoint responds with correct status code`);
152
+ }
153
+ if (analysis.modifiedFiles.length > 0) {
154
+ criteria.push('All modified files compile without errors');
155
+ criteria.push('Existing tests continue to pass');
156
+ }
157
+ if (criteria.length === 0) {
158
+ criteria.push('Code changes are covered by unit tests');
159
+ criteria.push('No regressions introduced');
160
+ }
161
+ return criteria;
162
+ }
163
+ function estimateEffort(analysis) {
164
+ const signals = analysis.modifiedFiles.length +
165
+ analysis.addedFunctions.length * 2 +
166
+ analysis.addedEndpoints.length * 3;
167
+ if (signals < 5) {
168
+ return 'XS (< 1h)';
169
+ }
170
+ if (signals < 15) {
171
+ return 'S (1-4h)';
172
+ }
173
+ if (signals < 35) {
174
+ return 'M (4-8h)';
175
+ }
176
+ if (signals < 70) {
177
+ return 'L (1-2d)';
178
+ }
179
+ return 'XL (> 2d)';
180
+ }
181
+ //# sourceMappingURL=diff-spec-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diff-spec-generator.js","sourceRoot":"","sources":["../../src/engine/diff-spec-generator.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,WAAoB;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,eAAe;QACf,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,uCAAuC;QACzC,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,MAAM,OAAO,GAAG,mDAAmD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAED,0BAA0B;QAC1B,MAAM,UAAU,GAAG,iEAAiE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChG,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,oBAAoB;QACpB,MAAM,cAAc,GAAG,kDAAkD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,2CAA2C;QAC3C,MAAM,aAAa,GACjB,kFAAkF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChG,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAC1C,UAAU;QACV,YAAY;QACZ,cAAc;QACd,gBAAgB;QAChB,cAAc;QACd,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,EACtB,UAA4C,EAC5C,SAAiB,EACjB,aAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,KAAK,GAAG,aAAa,IAAI,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,kBAAkB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEjD,OAAO;QACL,KAAK;QACL,WAAW;QACX,kBAAkB;QAClB,eAAe;QACf,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,UAAU;QACV,SAAS;QACT,WAAW,EAAE,GAAG;KACjB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,WAAoB;IAC/D,MAAM,KAAK,GAAG,WAAW,IAAI,cAAc,CAAC;IAC5C,MAAM,GAAG,GAAG,WAAW,QAAQ,UAAU,KAAK,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI;YAC7E,4CAA4C,EAC9C,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB;IAC5D,MAAM,GAAG,GAAG,cAAc,QAAQ,YAAY,QAAQ,GAAG,CAAC;IAC1D,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI;YAC/E,6DAA6D;YAC7D,oBAAoB,EACtB,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,UAAU,CAAC,QAAsB,EAAE,SAAiB;IAC3D,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,OAAO,KAAK,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,kBAAkB,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;QAC7C,OAAO,UAAU,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,gBAAgB,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAsB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CACR,YAAY,QAAQ,CAAC,aAAa,CAAC,MAAM,aAAa,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CACxJ,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,wCAAwC,CAAC;AACvF,CAAC;AAED,SAAS,aAAa,CAAC,QAAsB;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,sDAAsD,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,QAAsB;IAC5C,MAAM,OAAO,GACX,QAAQ,CAAC,aAAa,CAAC,MAAM;QAC7B,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAClC,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IAErC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { DriftMonitorConfig, DriftAlertRule, DriftSummaryReport } from '../types/index.js';
2
+ export declare function buildDriftMonitorConfig(projectPath: string, existing: DriftMonitorConfig | null, enabled: boolean, scheduleHours: number, threshold: number): DriftMonitorConfig;
3
+ export declare function buildAlertRules(rules: Omit<DriftAlertRule, 'id' | 'createdAt'>[]): DriftAlertRule[];
4
+ export declare function computeSummaryReport(projectPath: string, specList: string[], config: DriftMonitorConfig | null, rules: DriftAlertRule[]): DriftSummaryReport;
5
+ //# sourceMappingURL=drift-monitor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift-monitor.d.ts","sourceRoot":"","sources":["../../src/engine/drift-monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAM3B,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAUpB;AAMD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,WAAW,CAAC,EAAE,GAChD,cAAc,EAAE,CAUlB;AAMD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,KAAK,EAAE,cAAc,EAAE,GACtB,kBAAkB,CAuCpB"}
@@ -0,0 +1,92 @@
1
+ // ---------------------------------------------------------------------------
2
+ // Config builder
3
+ // ---------------------------------------------------------------------------
4
+ export function buildDriftMonitorConfig(projectPath, existing, enabled, scheduleHours, threshold) {
5
+ const now = new Date().toISOString();
6
+ return {
7
+ projectPath,
8
+ enabled,
9
+ scheduleHours,
10
+ threshold,
11
+ createdAt: existing?.createdAt ?? now,
12
+ updatedAt: now,
13
+ };
14
+ }
15
+ // ---------------------------------------------------------------------------
16
+ // Alert rules builder
17
+ // ---------------------------------------------------------------------------
18
+ export function buildAlertRules(rules) {
19
+ const now = new Date().toISOString();
20
+ return rules.map((r, i) => ({
21
+ id: `rule-${Date.now()}-${i}`,
22
+ name: r.name,
23
+ specIdPattern: r.specIdPattern,
24
+ thresholdOverride: r.thresholdOverride,
25
+ enabled: r.enabled,
26
+ createdAt: now,
27
+ }));
28
+ }
29
+ // ---------------------------------------------------------------------------
30
+ // Summary report (on-demand, pure computation)
31
+ // ---------------------------------------------------------------------------
32
+ export function computeSummaryReport(projectPath, specList, config, rules) {
33
+ const now = new Date().toISOString();
34
+ const threshold = config?.threshold ?? 50;
35
+ const alerts = [];
36
+ let drifted = 0;
37
+ let clean = 0;
38
+ for (const specId of specList) {
39
+ const score = computeDriftScore(specId);
40
+ const effectiveThreshold = resolveThreshold(specId, rules, threshold);
41
+ if (score > effectiveThreshold) {
42
+ drifted++;
43
+ const matchedRule = rules.find((r) => r.enabled && matchPattern(specId, r.specIdPattern));
44
+ alerts.push({
45
+ specId,
46
+ driftScore: score,
47
+ ruleId: matchedRule?.id,
48
+ ruleName: matchedRule?.name,
49
+ triggeredAt: now,
50
+ });
51
+ }
52
+ else {
53
+ clean++;
54
+ }
55
+ }
56
+ const overallDriftScore = specList.length > 0 ? Math.round((drifted / specList.length) * 100) : 0;
57
+ return {
58
+ projectPath,
59
+ generatedAt: now,
60
+ totalSpecs: specList.length,
61
+ driftedSpecs: drifted,
62
+ cleanSpecs: clean,
63
+ unreachableSpecs: 0,
64
+ overallDriftScore,
65
+ alerts,
66
+ };
67
+ }
68
+ // ---------------------------------------------------------------------------
69
+ // Internal helpers
70
+ // ---------------------------------------------------------------------------
71
+ function computeDriftScore(specId) {
72
+ // Deterministic pseudo-score for testing purposes
73
+ let hash = 0;
74
+ for (let i = 0; i < specId.length; i++) {
75
+ hash = (hash * 31 + specId.charCodeAt(i)) & 0xffffffff;
76
+ }
77
+ return Math.abs(hash % 101);
78
+ }
79
+ function matchPattern(specId, pattern) {
80
+ if (pattern === '*' || pattern === 'SPEC-*') {
81
+ return true;
82
+ }
83
+ if (pattern.endsWith('*')) {
84
+ return specId.startsWith(pattern.slice(0, -1));
85
+ }
86
+ return specId === pattern;
87
+ }
88
+ function resolveThreshold(specId, rules, defaultThreshold) {
89
+ const match = rules.find((r) => r.enabled && r.thresholdOverride !== undefined && matchPattern(specId, r.specIdPattern));
90
+ return match?.thresholdOverride ?? defaultThreshold;
91
+ }
92
+ //# sourceMappingURL=drift-monitor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift-monitor.js","sourceRoot":"","sources":["../../src/engine/drift-monitor.ts"],"names":[],"mappings":"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"}