@decibelsystems/tools 2.0.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 (478) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +342 -0
  3. package/dist/agentic/compiler.d.ts +21 -0
  4. package/dist/agentic/compiler.d.ts.map +1 -0
  5. package/dist/agentic/compiler.js +267 -0
  6. package/dist/agentic/compiler.js.map +1 -0
  7. package/dist/agentic/golden.d.ts +25 -0
  8. package/dist/agentic/golden.d.ts.map +1 -0
  9. package/dist/agentic/golden.js +255 -0
  10. package/dist/agentic/golden.js.map +1 -0
  11. package/dist/agentic/index.d.ts +17 -0
  12. package/dist/agentic/index.d.ts.map +1 -0
  13. package/dist/agentic/index.js +153 -0
  14. package/dist/agentic/index.js.map +1 -0
  15. package/dist/agentic/linter.d.ts +20 -0
  16. package/dist/agentic/linter.d.ts.map +1 -0
  17. package/dist/agentic/linter.js +340 -0
  18. package/dist/agentic/linter.js.map +1 -0
  19. package/dist/agentic/renderer.d.ts +17 -0
  20. package/dist/agentic/renderer.d.ts.map +1 -0
  21. package/dist/agentic/renderer.js +277 -0
  22. package/dist/agentic/renderer.js.map +1 -0
  23. package/dist/agentic/types.d.ts +199 -0
  24. package/dist/agentic/types.d.ts.map +1 -0
  25. package/dist/agentic/types.js +8 -0
  26. package/dist/agentic/types.js.map +1 -0
  27. package/dist/architectAdrs.d.ts +32 -0
  28. package/dist/architectAdrs.d.ts.map +1 -0
  29. package/dist/architectAdrs.js +162 -0
  30. package/dist/architectAdrs.js.map +1 -0
  31. package/dist/client/facade-client.d.ts +41 -0
  32. package/dist/client/facade-client.d.ts.map +1 -0
  33. package/dist/client/facade-client.js +243 -0
  34. package/dist/client/facade-client.js.map +1 -0
  35. package/dist/client/index.d.ts +4 -0
  36. package/dist/client/index.d.ts.map +1 -0
  37. package/dist/client/index.js +18 -0
  38. package/dist/client/index.js.map +1 -0
  39. package/dist/client/transports.d.ts +78 -0
  40. package/dist/client/transports.d.ts.map +1 -0
  41. package/dist/client/transports.js +258 -0
  42. package/dist/client/transports.js.map +1 -0
  43. package/dist/client/types.d.ts +49 -0
  44. package/dist/client/types.d.ts.map +1 -0
  45. package/dist/client/types.js +8 -0
  46. package/dist/client/types.js.map +1 -0
  47. package/dist/config.d.ts +8 -0
  48. package/dist/config.d.ts.map +1 -0
  49. package/dist/config.js +19 -0
  50. package/dist/config.js.map +1 -0
  51. package/dist/daemon.d.ts +77 -0
  52. package/dist/daemon.d.ts.map +1 -0
  53. package/dist/daemon.js +374 -0
  54. package/dist/daemon.js.map +1 -0
  55. package/dist/daemonConfig.d.ts +43 -0
  56. package/dist/daemonConfig.d.ts.map +1 -0
  57. package/dist/daemonConfig.js +113 -0
  58. package/dist/daemonConfig.js.map +1 -0
  59. package/dist/dataRoot.d.ts +5 -0
  60. package/dist/dataRoot.d.ts.map +1 -0
  61. package/dist/dataRoot.js +23 -0
  62. package/dist/dataRoot.js.map +1 -0
  63. package/dist/decibelPaths.d.ts +42 -0
  64. package/dist/decibelPaths.d.ts.map +1 -0
  65. package/dist/decibelPaths.js +150 -0
  66. package/dist/decibelPaths.js.map +1 -0
  67. package/dist/facades/definitions.d.ts +6 -0
  68. package/dist/facades/definitions.d.ts.map +1 -0
  69. package/dist/facades/definitions.js +450 -0
  70. package/dist/facades/definitions.js.map +1 -0
  71. package/dist/facades/index.d.ts +27 -0
  72. package/dist/facades/index.d.ts.map +1 -0
  73. package/dist/facades/index.js +124 -0
  74. package/dist/facades/index.js.map +1 -0
  75. package/dist/facades/types.d.ts +38 -0
  76. package/dist/facades/types.d.ts.map +1 -0
  77. package/dist/facades/types.js +8 -0
  78. package/dist/facades/types.js.map +1 -0
  79. package/dist/httpServer.d.ts +66 -0
  80. package/dist/httpServer.d.ts.map +1 -0
  81. package/dist/httpServer.js +1723 -0
  82. package/dist/httpServer.js.map +1 -0
  83. package/dist/kernel.d.ts +87 -0
  84. package/dist/kernel.d.ts.map +1 -0
  85. package/dist/kernel.js +256 -0
  86. package/dist/kernel.js.map +1 -0
  87. package/dist/lib/agent-services/assumptions.d.ts +16 -0
  88. package/dist/lib/agent-services/assumptions.d.ts.map +1 -0
  89. package/dist/lib/agent-services/assumptions.js +284 -0
  90. package/dist/lib/agent-services/assumptions.js.map +1 -0
  91. package/dist/lib/agent-services/context-pack.d.ts +6 -0
  92. package/dist/lib/agent-services/context-pack.d.ts.map +1 -0
  93. package/dist/lib/agent-services/context-pack.js +354 -0
  94. package/dist/lib/agent-services/context-pack.js.map +1 -0
  95. package/dist/lib/agent-services/drift-guard.d.ts +14 -0
  96. package/dist/lib/agent-services/drift-guard.d.ts.map +1 -0
  97. package/dist/lib/agent-services/drift-guard.js +355 -0
  98. package/dist/lib/agent-services/drift-guard.js.map +1 -0
  99. package/dist/lib/agent-services/index.d.ts +5 -0
  100. package/dist/lib/agent-services/index.d.ts.map +1 -0
  101. package/dist/lib/agent-services/index.js +10 -0
  102. package/dist/lib/agent-services/index.js.map +1 -0
  103. package/dist/lib/benchmark.d.ts +110 -0
  104. package/dist/lib/benchmark.d.ts.map +1 -0
  105. package/dist/lib/benchmark.js +338 -0
  106. package/dist/lib/benchmark.js.map +1 -0
  107. package/dist/lib/supabase.d.ts +123 -0
  108. package/dist/lib/supabase.d.ts.map +1 -0
  109. package/dist/lib/supabase.js +91 -0
  110. package/dist/lib/supabase.js.map +1 -0
  111. package/dist/license.d.ts +30 -0
  112. package/dist/license.d.ts.map +1 -0
  113. package/dist/license.js +131 -0
  114. package/dist/license.js.map +1 -0
  115. package/dist/projectPaths.d.ts +27 -0
  116. package/dist/projectPaths.d.ts.map +1 -0
  117. package/dist/projectPaths.js +86 -0
  118. package/dist/projectPaths.js.map +1 -0
  119. package/dist/projectRegistry.d.ts +97 -0
  120. package/dist/projectRegistry.d.ts.map +1 -0
  121. package/dist/projectRegistry.js +374 -0
  122. package/dist/projectRegistry.js.map +1 -0
  123. package/dist/sentinelIssues.d.ts +65 -0
  124. package/dist/sentinelIssues.d.ts.map +1 -0
  125. package/dist/sentinelIssues.js +297 -0
  126. package/dist/sentinelIssues.js.map +1 -0
  127. package/dist/server.d.ts +3 -0
  128. package/dist/server.d.ts.map +1 -0
  129. package/dist/server.js +195 -0
  130. package/dist/server.js.map +1 -0
  131. package/dist/test.d.ts +7 -0
  132. package/dist/test.d.ts.map +1 -0
  133. package/dist/test.js +77 -0
  134. package/dist/test.js.map +1 -0
  135. package/dist/tools/agentic/index.d.ts +7 -0
  136. package/dist/tools/agentic/index.d.ts.map +1 -0
  137. package/dist/tools/agentic/index.js +203 -0
  138. package/dist/tools/agentic/index.js.map +1 -0
  139. package/dist/tools/architect/index.d.ts +11 -0
  140. package/dist/tools/architect/index.d.ts.map +1 -0
  141. package/dist/tools/architect/index.js +506 -0
  142. package/dist/tools/architect/index.js.map +1 -0
  143. package/dist/tools/architect.d.ts +19 -0
  144. package/dist/tools/architect.d.ts.map +1 -0
  145. package/dist/tools/architect.js +88 -0
  146. package/dist/tools/architect.js.map +1 -0
  147. package/dist/tools/auditor/index.d.ts +10 -0
  148. package/dist/tools/auditor/index.d.ts.map +1 -0
  149. package/dist/tools/auditor/index.js +310 -0
  150. package/dist/tools/auditor/index.js.map +1 -0
  151. package/dist/tools/auditor.d.ts +149 -0
  152. package/dist/tools/auditor.d.ts.map +1 -0
  153. package/dist/tools/auditor.js +775 -0
  154. package/dist/tools/auditor.js.map +1 -0
  155. package/dist/tools/bench/index.d.ts +3 -0
  156. package/dist/tools/bench/index.d.ts.map +1 -0
  157. package/dist/tools/bench/index.js +220 -0
  158. package/dist/tools/bench/index.js.map +1 -0
  159. package/dist/tools/bench.d.ts +89 -0
  160. package/dist/tools/bench.d.ts.map +1 -0
  161. package/dist/tools/bench.js +826 -0
  162. package/dist/tools/bench.js.map +1 -0
  163. package/dist/tools/context/index.d.ts +11 -0
  164. package/dist/tools/context/index.d.ts.map +1 -0
  165. package/dist/tools/context/index.js +482 -0
  166. package/dist/tools/context/index.js.map +1 -0
  167. package/dist/tools/context.d.ts +146 -0
  168. package/dist/tools/context.d.ts.map +1 -0
  169. package/dist/tools/context.js +481 -0
  170. package/dist/tools/context.js.map +1 -0
  171. package/dist/tools/coordinator/coordinator.d.ts +168 -0
  172. package/dist/tools/coordinator/coordinator.d.ts.map +1 -0
  173. package/dist/tools/coordinator/coordinator.js +535 -0
  174. package/dist/tools/coordinator/coordinator.js.map +1 -0
  175. package/dist/tools/coordinator/index.d.ts +12 -0
  176. package/dist/tools/coordinator/index.d.ts.map +1 -0
  177. package/dist/tools/coordinator/index.js +381 -0
  178. package/dist/tools/coordinator/index.js.map +1 -0
  179. package/dist/tools/corpus/index.d.ts +5 -0
  180. package/dist/tools/corpus/index.d.ts.map +1 -0
  181. package/dist/tools/corpus/index.js +105 -0
  182. package/dist/tools/corpus/index.js.map +1 -0
  183. package/dist/tools/corpus.d.ts +33 -0
  184. package/dist/tools/corpus.d.ts.map +1 -0
  185. package/dist/tools/corpus.js +180 -0
  186. package/dist/tools/corpus.js.map +1 -0
  187. package/dist/tools/crit.d.ts +63 -0
  188. package/dist/tools/crit.d.ts.map +1 -0
  189. package/dist/tools/crit.js +159 -0
  190. package/dist/tools/crit.js.map +1 -0
  191. package/dist/tools/data-inspector.d.ts +189 -0
  192. package/dist/tools/data-inspector.d.ts.map +1 -0
  193. package/dist/tools/data-inspector.js +669 -0
  194. package/dist/tools/data-inspector.js.map +1 -0
  195. package/dist/tools/deck.d.ts +11 -0
  196. package/dist/tools/deck.d.ts.map +1 -0
  197. package/dist/tools/deck.js +188 -0
  198. package/dist/tools/deck.js.map +1 -0
  199. package/dist/tools/designer/index.d.ts +11 -0
  200. package/dist/tools/designer/index.d.ts.map +1 -0
  201. package/dist/tools/designer/index.js +442 -0
  202. package/dist/tools/designer/index.js.map +1 -0
  203. package/dist/tools/designer/lateral-tools.d.ts +6 -0
  204. package/dist/tools/designer/lateral-tools.d.ts.map +1 -0
  205. package/dist/tools/designer/lateral-tools.js +190 -0
  206. package/dist/tools/designer/lateral-tools.js.map +1 -0
  207. package/dist/tools/designer.d.ts +122 -0
  208. package/dist/tools/designer.d.ts.map +1 -0
  209. package/dist/tools/designer.js +495 -0
  210. package/dist/tools/designer.js.map +1 -0
  211. package/dist/tools/dojo/index.d.ts +13 -0
  212. package/dist/tools/dojo/index.d.ts.map +1 -0
  213. package/dist/tools/dojo/index.js +613 -0
  214. package/dist/tools/dojo/index.js.map +1 -0
  215. package/dist/tools/dojo.d.ts +254 -0
  216. package/dist/tools/dojo.d.ts.map +1 -0
  217. package/dist/tools/dojo.js +933 -0
  218. package/dist/tools/dojo.js.map +1 -0
  219. package/dist/tools/dojoBench.d.ts +49 -0
  220. package/dist/tools/dojoBench.d.ts.map +1 -0
  221. package/dist/tools/dojoBench.js +205 -0
  222. package/dist/tools/dojoBench.js.map +1 -0
  223. package/dist/tools/dojoGraduated.d.ts +50 -0
  224. package/dist/tools/dojoGraduated.d.ts.map +1 -0
  225. package/dist/tools/dojoGraduated.js +174 -0
  226. package/dist/tools/dojoGraduated.js.map +1 -0
  227. package/dist/tools/dojoPolicy.d.ts +65 -0
  228. package/dist/tools/dojoPolicy.d.ts.map +1 -0
  229. package/dist/tools/dojoPolicy.js +263 -0
  230. package/dist/tools/dojoPolicy.js.map +1 -0
  231. package/dist/tools/feedback/index.d.ts +5 -0
  232. package/dist/tools/feedback/index.d.ts.map +1 -0
  233. package/dist/tools/feedback/index.js +153 -0
  234. package/dist/tools/feedback/index.js.map +1 -0
  235. package/dist/tools/feedback.d.ts +61 -0
  236. package/dist/tools/feedback.d.ts.map +1 -0
  237. package/dist/tools/feedback.js +209 -0
  238. package/dist/tools/feedback.js.map +1 -0
  239. package/dist/tools/forecast/index.d.ts +8 -0
  240. package/dist/tools/forecast/index.d.ts.map +1 -0
  241. package/dist/tools/forecast/index.js +283 -0
  242. package/dist/tools/forecast/index.js.map +1 -0
  243. package/dist/tools/forecast.d.ts +147 -0
  244. package/dist/tools/forecast.d.ts.map +1 -0
  245. package/dist/tools/forecast.js +417 -0
  246. package/dist/tools/forecast.js.map +1 -0
  247. package/dist/tools/friction/index.d.ts +7 -0
  248. package/dist/tools/friction/index.d.ts.map +1 -0
  249. package/dist/tools/friction/index.js +265 -0
  250. package/dist/tools/friction/index.js.map +1 -0
  251. package/dist/tools/friction.d.ts +82 -0
  252. package/dist/tools/friction.d.ts.map +1 -0
  253. package/dist/tools/friction.js +331 -0
  254. package/dist/tools/friction.js.map +1 -0
  255. package/dist/tools/git/index.d.ts +9 -0
  256. package/dist/tools/git/index.d.ts.map +1 -0
  257. package/dist/tools/git/index.js +237 -0
  258. package/dist/tools/git/index.js.map +1 -0
  259. package/dist/tools/git-sentinel/index.d.ts +7 -0
  260. package/dist/tools/git-sentinel/index.d.ts.map +1 -0
  261. package/dist/tools/git-sentinel/index.js +178 -0
  262. package/dist/tools/git-sentinel/index.js.map +1 -0
  263. package/dist/tools/git-sentinel.d.ts +78 -0
  264. package/dist/tools/git-sentinel.d.ts.map +1 -0
  265. package/dist/tools/git-sentinel.js +391 -0
  266. package/dist/tools/git-sentinel.js.map +1 -0
  267. package/dist/tools/git.d.ts +134 -0
  268. package/dist/tools/git.d.ts.map +1 -0
  269. package/dist/tools/git.js +374 -0
  270. package/dist/tools/git.js.map +1 -0
  271. package/dist/tools/guardian/index.d.ts +8 -0
  272. package/dist/tools/guardian/index.d.ts.map +1 -0
  273. package/dist/tools/guardian/index.js +171 -0
  274. package/dist/tools/guardian/index.js.map +1 -0
  275. package/dist/tools/guardian.d.ts +62 -0
  276. package/dist/tools/guardian.d.ts.map +1 -0
  277. package/dist/tools/guardian.js +332 -0
  278. package/dist/tools/guardian.js.map +1 -0
  279. package/dist/tools/hygiene/codebase-scanner.d.ts +38 -0
  280. package/dist/tools/hygiene/codebase-scanner.d.ts.map +1 -0
  281. package/dist/tools/hygiene/codebase-scanner.js +411 -0
  282. package/dist/tools/hygiene/codebase-scanner.js.map +1 -0
  283. package/dist/tools/hygiene/config-scanner.d.ts +33 -0
  284. package/dist/tools/hygiene/config-scanner.d.ts.map +1 -0
  285. package/dist/tools/hygiene/config-scanner.js +482 -0
  286. package/dist/tools/hygiene/config-scanner.js.map +1 -0
  287. package/dist/tools/hygiene/coverage-scanner.d.ts +41 -0
  288. package/dist/tools/hygiene/coverage-scanner.d.ts.map +1 -0
  289. package/dist/tools/hygiene/coverage-scanner.js +331 -0
  290. package/dist/tools/hygiene/coverage-scanner.js.map +1 -0
  291. package/dist/tools/hygiene/index.d.ts +7 -0
  292. package/dist/tools/hygiene/index.d.ts.map +1 -0
  293. package/dist/tools/hygiene/index.js +291 -0
  294. package/dist/tools/hygiene/index.js.map +1 -0
  295. package/dist/tools/hygiene/oracle-hygiene.d.ts +68 -0
  296. package/dist/tools/hygiene/oracle-hygiene.d.ts.map +1 -0
  297. package/dist/tools/hygiene/oracle-hygiene.js +324 -0
  298. package/dist/tools/hygiene/oracle-hygiene.js.map +1 -0
  299. package/dist/tools/index.d.ts +6 -0
  300. package/dist/tools/index.d.ts.map +1 -0
  301. package/dist/tools/index.js +130 -0
  302. package/dist/tools/index.js.map +1 -0
  303. package/dist/tools/lateral.d.ts +114 -0
  304. package/dist/tools/lateral.d.ts.map +1 -0
  305. package/dist/tools/lateral.js +536 -0
  306. package/dist/tools/lateral.js.map +1 -0
  307. package/dist/tools/learnings/index.d.ts +5 -0
  308. package/dist/tools/learnings/index.d.ts.map +1 -0
  309. package/dist/tools/learnings/index.js +138 -0
  310. package/dist/tools/learnings/index.js.map +1 -0
  311. package/dist/tools/learnings.d.ts +41 -0
  312. package/dist/tools/learnings.d.ts.map +1 -0
  313. package/dist/tools/learnings.js +149 -0
  314. package/dist/tools/learnings.js.map +1 -0
  315. package/dist/tools/oracle/index.d.ts +6 -0
  316. package/dist/tools/oracle/index.d.ts.map +1 -0
  317. package/dist/tools/oracle/index.js +217 -0
  318. package/dist/tools/oracle/index.js.map +1 -0
  319. package/dist/tools/oracle.d.ts +90 -0
  320. package/dist/tools/oracle.d.ts.map +1 -0
  321. package/dist/tools/oracle.js +529 -0
  322. package/dist/tools/oracle.js.map +1 -0
  323. package/dist/tools/policy.d.ts +119 -0
  324. package/dist/tools/policy.d.ts.map +1 -0
  325. package/dist/tools/policy.js +406 -0
  326. package/dist/tools/policy.js.map +1 -0
  327. package/dist/tools/provenance/index.d.ts +4 -0
  328. package/dist/tools/provenance/index.d.ts.map +1 -0
  329. package/dist/tools/provenance/index.js +63 -0
  330. package/dist/tools/provenance/index.js.map +1 -0
  331. package/dist/tools/provenance.d.ts +75 -0
  332. package/dist/tools/provenance.d.ts.map +1 -0
  333. package/dist/tools/provenance.js +224 -0
  334. package/dist/tools/provenance.js.map +1 -0
  335. package/dist/tools/rateLimiter.d.ts +45 -0
  336. package/dist/tools/rateLimiter.d.ts.map +1 -0
  337. package/dist/tools/rateLimiter.js +91 -0
  338. package/dist/tools/rateLimiter.js.map +1 -0
  339. package/dist/tools/registry/index.d.ts +10 -0
  340. package/dist/tools/registry/index.d.ts.map +1 -0
  341. package/dist/tools/registry/index.js +506 -0
  342. package/dist/tools/registry/index.js.map +1 -0
  343. package/dist/tools/registry.d.ts +3 -0
  344. package/dist/tools/registry.d.ts.map +1 -0
  345. package/dist/tools/registry.js +189 -0
  346. package/dist/tools/registry.js.map +1 -0
  347. package/dist/tools/roadmap/index.d.ts +11 -0
  348. package/dist/tools/roadmap/index.d.ts.map +1 -0
  349. package/dist/tools/roadmap/index.js +364 -0
  350. package/dist/tools/roadmap/index.js.map +1 -0
  351. package/dist/tools/roadmap.d.ts +103 -0
  352. package/dist/tools/roadmap.d.ts.map +1 -0
  353. package/dist/tools/roadmap.js +407 -0
  354. package/dist/tools/roadmap.js.map +1 -0
  355. package/dist/tools/senken.d.ts +11 -0
  356. package/dist/tools/senken.d.ts.map +1 -0
  357. package/dist/tools/senken.js +482 -0
  358. package/dist/tools/senken.js.map +1 -0
  359. package/dist/tools/sentinel/index.d.ts +21 -0
  360. package/dist/tools/sentinel/index.d.ts.map +1 -0
  361. package/dist/tools/sentinel/index.js +1067 -0
  362. package/dist/tools/sentinel/index.js.map +1 -0
  363. package/dist/tools/sentinel-scan-data.d.ts +90 -0
  364. package/dist/tools/sentinel-scan-data.d.ts.map +1 -0
  365. package/dist/tools/sentinel-scan-data.js +122 -0
  366. package/dist/tools/sentinel-scan-data.js.map +1 -0
  367. package/dist/tools/sentinel.d.ts +156 -0
  368. package/dist/tools/sentinel.d.ts.map +1 -0
  369. package/dist/tools/sentinel.js +603 -0
  370. package/dist/tools/sentinel.js.map +1 -0
  371. package/dist/tools/shared/index.d.ts +5 -0
  372. package/dist/tools/shared/index.d.ts.map +1 -0
  373. package/dist/tools/shared/index.js +8 -0
  374. package/dist/tools/shared/index.js.map +1 -0
  375. package/dist/tools/shared/project.d.ts +17 -0
  376. package/dist/tools/shared/project.d.ts.map +1 -0
  377. package/dist/tools/shared/project.js +36 -0
  378. package/dist/tools/shared/project.js.map +1 -0
  379. package/dist/tools/shared/response.d.ts +15 -0
  380. package/dist/tools/shared/response.d.ts.map +1 -0
  381. package/dist/tools/shared/response.js +77 -0
  382. package/dist/tools/shared/response.js.map +1 -0
  383. package/dist/tools/shared/runTracker.d.ts +87 -0
  384. package/dist/tools/shared/runTracker.d.ts.map +1 -0
  385. package/dist/tools/shared/runTracker.js +225 -0
  386. package/dist/tools/shared/runTracker.js.map +1 -0
  387. package/dist/tools/shared/validation.d.ts +10 -0
  388. package/dist/tools/shared/validation.d.ts.map +1 -0
  389. package/dist/tools/shared/validation.js +26 -0
  390. package/dist/tools/shared/validation.js.map +1 -0
  391. package/dist/tools/studio/cloud-spine.d.ts +27 -0
  392. package/dist/tools/studio/cloud-spine.d.ts.map +1 -0
  393. package/dist/tools/studio/cloud-spine.js +845 -0
  394. package/dist/tools/studio/cloud-spine.js.map +1 -0
  395. package/dist/tools/studio/index.d.ts +154 -0
  396. package/dist/tools/studio/index.d.ts.map +1 -0
  397. package/dist/tools/studio/index.js +541 -0
  398. package/dist/tools/studio/index.js.map +1 -0
  399. package/dist/tools/testSpec.d.ts +122 -0
  400. package/dist/tools/testSpec.d.ts.map +1 -0
  401. package/dist/tools/testSpec.js +525 -0
  402. package/dist/tools/testSpec.js.map +1 -0
  403. package/dist/tools/toolsIndex.d.ts +5 -0
  404. package/dist/tools/toolsIndex.d.ts.map +1 -0
  405. package/dist/tools/toolsIndex.js +37 -0
  406. package/dist/tools/toolsIndex.js.map +1 -0
  407. package/dist/tools/types.d.ts +47 -0
  408. package/dist/tools/types.d.ts.map +1 -0
  409. package/dist/tools/types.js +7 -0
  410. package/dist/tools/types.js.map +1 -0
  411. package/dist/tools/vector/index.d.ts +13 -0
  412. package/dist/tools/vector/index.d.ts.map +1 -0
  413. package/dist/tools/vector/index.js +592 -0
  414. package/dist/tools/vector/index.js.map +1 -0
  415. package/dist/tools/vector.d.ts +189 -0
  416. package/dist/tools/vector.d.ts.map +1 -0
  417. package/dist/tools/vector.js +570 -0
  418. package/dist/tools/vector.js.map +1 -0
  419. package/dist/tools/velocity/index.d.ts +9 -0
  420. package/dist/tools/velocity/index.d.ts.map +1 -0
  421. package/dist/tools/velocity/index.js +306 -0
  422. package/dist/tools/velocity/index.js.map +1 -0
  423. package/dist/tools/velocity.d.ts +143 -0
  424. package/dist/tools/velocity.d.ts.map +1 -0
  425. package/dist/tools/velocity.js +628 -0
  426. package/dist/tools/velocity.js.map +1 -0
  427. package/dist/tools/voice/index.d.ts +8 -0
  428. package/dist/tools/voice/index.d.ts.map +1 -0
  429. package/dist/tools/voice/index.js +203 -0
  430. package/dist/tools/voice/index.js.map +1 -0
  431. package/dist/tools/voice.d.ts +291 -0
  432. package/dist/tools/voice.d.ts.map +1 -0
  433. package/dist/tools/voice.js +734 -0
  434. package/dist/tools/voice.js.map +1 -0
  435. package/dist/tools/workflow/index.d.ts +8 -0
  436. package/dist/tools/workflow/index.d.ts.map +1 -0
  437. package/dist/tools/workflow/index.js +199 -0
  438. package/dist/tools/workflow/index.js.map +1 -0
  439. package/dist/tools/workflow.d.ts +123 -0
  440. package/dist/tools/workflow.d.ts.map +1 -0
  441. package/dist/tools/workflow.js +647 -0
  442. package/dist/tools/workflow.js.map +1 -0
  443. package/dist/transports/bridge.d.ts +22 -0
  444. package/dist/transports/bridge.d.ts.map +1 -0
  445. package/dist/transports/bridge.js +177 -0
  446. package/dist/transports/bridge.js.map +1 -0
  447. package/dist/transports/http.d.ts +9 -0
  448. package/dist/transports/http.d.ts.map +1 -0
  449. package/dist/transports/http.js +35 -0
  450. package/dist/transports/http.js.map +1 -0
  451. package/dist/transports/index.d.ts +6 -0
  452. package/dist/transports/index.d.ts.map +1 -0
  453. package/dist/transports/index.js +8 -0
  454. package/dist/transports/index.js.map +1 -0
  455. package/dist/transports/mcp.d.ts +9 -0
  456. package/dist/transports/mcp.d.ts.map +1 -0
  457. package/dist/transports/mcp.js +51 -0
  458. package/dist/transports/mcp.js.map +1 -0
  459. package/dist/transports/stdio.d.ts +9 -0
  460. package/dist/transports/stdio.d.ts.map +1 -0
  461. package/dist/transports/stdio.js +26 -0
  462. package/dist/transports/stdio.js.map +1 -0
  463. package/dist/transports/types.d.ts +27 -0
  464. package/dist/transports/types.d.ts.map +1 -0
  465. package/dist/transports/types.js +8 -0
  466. package/dist/transports/types.js.map +1 -0
  467. package/dist/types/agent-services.d.ts +193 -0
  468. package/dist/types/agent-services.d.ts.map +1 -0
  469. package/dist/types/agent-services.js +8 -0
  470. package/dist/types/agent-services.js.map +1 -0
  471. package/dist/types/index.d.ts +2 -0
  472. package/dist/types/index.d.ts.map +1 -0
  473. package/dist/types/index.js +7 -0
  474. package/dist/types/index.js.map +1 -0
  475. package/package.json +72 -0
  476. package/templates/AGENT.md +87 -0
  477. package/templates/com.decibel.daemon.plist +47 -0
  478. package/templates/sentinel/ISSUE_TEMPLATE.md +20 -0
@@ -0,0 +1,331 @@
1
+ // ============================================================================
2
+ // Coverage Scanner - Test Coverage Gap Analysis
3
+ // ============================================================================
4
+ // Detects test coverage gaps by analyzing test file presence, coverage reports,
5
+ // and test-to-source file ratios.
6
+ // ============================================================================
7
+ import * as fs from 'fs';
8
+ import * as path from 'path';
9
+ // ============================================================================
10
+ // Configuration
11
+ // ============================================================================
12
+ // Patterns that indicate critical code paths
13
+ const CRITICAL_PATH_PATTERNS = [
14
+ /auth/i,
15
+ /payment/i,
16
+ /security/i,
17
+ /crypto/i,
18
+ /database/i,
19
+ /api/i,
20
+ /middleware/i,
21
+ /validation/i,
22
+ /session/i,
23
+ /token/i,
24
+ ];
25
+ // Patterns to identify test files
26
+ const TEST_FILE_PATTERNS = [
27
+ /\.test\.[jt]sx?$/,
28
+ /\.spec\.[jt]sx?$/,
29
+ /_test\.[jt]sx?$/,
30
+ /_spec\.[jt]sx?$/,
31
+ /test_.*\.py$/,
32
+ /.*_test\.py$/,
33
+ /.*_test\.go$/,
34
+ /.*_test\.rs$/,
35
+ ];
36
+ // Patterns to identify source files (not tests, not config)
37
+ const SOURCE_FILE_PATTERNS = [
38
+ /\.[jt]sx?$/,
39
+ /\.py$/,
40
+ /\.go$/,
41
+ /\.rs$/,
42
+ ];
43
+ // Directories to exclude from analysis
44
+ const EXCLUDE_DIRS = [
45
+ 'node_modules',
46
+ 'dist',
47
+ 'build',
48
+ '.git',
49
+ 'vendor',
50
+ '__pycache__',
51
+ '.next',
52
+ 'coverage',
53
+ '.nyc_output',
54
+ ];
55
+ // ============================================================================
56
+ // File Classification
57
+ // ============================================================================
58
+ function isTestFile(fileName) {
59
+ return TEST_FILE_PATTERNS.some(pattern => pattern.test(fileName));
60
+ }
61
+ function isSourceFile(fileName) {
62
+ if (isTestFile(fileName))
63
+ return false;
64
+ // Exclude common config files
65
+ const configPatterns = [
66
+ /\.config\.[jt]sx?$/,
67
+ /\.d\.ts$/,
68
+ /index\.[jt]sx?$/, // Often just re-exports
69
+ /types?\.[jt]sx?$/, // Type definitions
70
+ ];
71
+ if (configPatterns.some(p => p.test(fileName))) {
72
+ return false;
73
+ }
74
+ return SOURCE_FILE_PATTERNS.some(pattern => pattern.test(fileName));
75
+ }
76
+ function isCriticalPath(dirPath) {
77
+ return CRITICAL_PATH_PATTERNS.some(pattern => pattern.test(dirPath));
78
+ }
79
+ // ============================================================================
80
+ // Directory Analysis
81
+ // ============================================================================
82
+ function analyzeDirectory(dirPath, baseDir) {
83
+ const sourceFiles = [];
84
+ const testFiles = [];
85
+ try {
86
+ const entries = fs.readdirSync(dirPath, { withFileTypes: true });
87
+ for (const entry of entries) {
88
+ const fullPath = path.join(dirPath, entry.name);
89
+ if (entry.isDirectory()) {
90
+ // Skip excluded directories
91
+ if (EXCLUDE_DIRS.includes(entry.name))
92
+ continue;
93
+ // Recursively analyze subdirectories
94
+ const subResult = analyzeDirectory(fullPath, baseDir);
95
+ sourceFiles.push(...subResult.sourceFiles);
96
+ testFiles.push(...subResult.testFiles);
97
+ }
98
+ else if (entry.isFile()) {
99
+ const relativePath = path.relative(baseDir, fullPath);
100
+ if (isTestFile(entry.name)) {
101
+ testFiles.push(relativePath);
102
+ }
103
+ else if (isSourceFile(entry.name)) {
104
+ sourceFiles.push(relativePath);
105
+ }
106
+ }
107
+ }
108
+ }
109
+ catch {
110
+ // Directory not readable
111
+ }
112
+ return { sourceFiles, testFiles };
113
+ }
114
+ function getDirectoryMap(projectPath) {
115
+ const dirMap = new Map();
116
+ function walk(dir) {
117
+ try {
118
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
119
+ for (const entry of entries) {
120
+ if (entry.isDirectory()) {
121
+ if (EXCLUDE_DIRS.includes(entry.name))
122
+ continue;
123
+ const fullPath = path.join(dir, entry.name);
124
+ const relativePath = path.relative(projectPath, fullPath);
125
+ // Initialize directory entry
126
+ if (!dirMap.has(relativePath)) {
127
+ dirMap.set(relativePath, { sourceFiles: [], testFiles: [] });
128
+ }
129
+ walk(fullPath);
130
+ }
131
+ else if (entry.isFile()) {
132
+ const dirRelativePath = path.relative(projectPath, dir);
133
+ const fileRelativePath = path.relative(projectPath, path.join(dir, entry.name));
134
+ if (!dirMap.has(dirRelativePath)) {
135
+ dirMap.set(dirRelativePath, { sourceFiles: [], testFiles: [] });
136
+ }
137
+ const dirEntry = dirMap.get(dirRelativePath);
138
+ if (isTestFile(entry.name)) {
139
+ dirEntry.testFiles.push(fileRelativePath);
140
+ }
141
+ else if (isSourceFile(entry.name)) {
142
+ dirEntry.sourceFiles.push(fileRelativePath);
143
+ }
144
+ }
145
+ }
146
+ }
147
+ catch {
148
+ // Directory not readable
149
+ }
150
+ }
151
+ walk(projectPath);
152
+ return dirMap;
153
+ }
154
+ function findCoverageReport(projectPath) {
155
+ // Look for common coverage report locations
156
+ const reportLocations = [
157
+ 'coverage/coverage-summary.json', // Istanbul
158
+ 'coverage/lcov.info', // LCOV
159
+ 'coverage.xml', // Cobertura
160
+ '.nyc_output/coverage.json', // NYC
161
+ ];
162
+ for (const loc of reportLocations) {
163
+ const fullPath = path.join(projectPath, loc);
164
+ if (fs.existsSync(fullPath)) {
165
+ try {
166
+ if (loc.endsWith('.json')) {
167
+ const content = JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
168
+ // Istanbul format
169
+ if (content.total?.lines?.pct !== undefined) {
170
+ return {
171
+ found: true,
172
+ type: 'istanbul',
173
+ overallPercent: content.total.lines.pct,
174
+ };
175
+ }
176
+ }
177
+ // For other formats, just note we found one
178
+ return { found: true, type: 'unknown' };
179
+ }
180
+ catch {
181
+ // Parse error
182
+ }
183
+ }
184
+ }
185
+ return { found: false, type: 'unknown' };
186
+ }
187
+ // ============================================================================
188
+ // Main Scanner
189
+ // ============================================================================
190
+ export async function scanCoverage(input) {
191
+ const startTime = Date.now();
192
+ const minCoverage = input.thresholds?.minCoveragePercent ?? 70;
193
+ const findings = [];
194
+ const directoryCoverage = [];
195
+ // Get directory-level analysis
196
+ const dirMap = getDirectoryMap(input.projectPath);
197
+ let totalSourceFiles = 0;
198
+ let totalTestFiles = 0;
199
+ let dirsWithNoTests = 0;
200
+ let criticalUntested = 0;
201
+ // Analyze each directory
202
+ for (const [dirPath, files] of dirMap) {
203
+ // Skip directories with no source files
204
+ if (files.sourceFiles.length === 0)
205
+ continue;
206
+ totalSourceFiles += files.sourceFiles.length;
207
+ totalTestFiles += files.testFiles.length;
208
+ const coverageRatio = files.testFiles.length / files.sourceFiles.length;
209
+ const hasTests = files.testFiles.length > 0;
210
+ const isCritical = isCriticalPath(dirPath);
211
+ directoryCoverage.push({
212
+ directory: dirPath,
213
+ sourceFiles: files.sourceFiles.length,
214
+ testFiles: files.testFiles.length,
215
+ coverageRatio,
216
+ hasTests,
217
+ isCritical,
218
+ });
219
+ // Generate findings for directories with issues
220
+ if (!hasTests) {
221
+ dirsWithNoTests++;
222
+ if (isCritical) {
223
+ criticalUntested++;
224
+ findings.push({
225
+ id: `no-tests-critical-${dirPath.replace(/\//g, '-')}`,
226
+ category: 'coverage',
227
+ severity: 'critical',
228
+ type: 'untested_critical',
229
+ title: `Critical path without tests: ${dirPath}`,
230
+ description: `Directory "${dirPath}" appears to contain critical code (${files.sourceFiles.length} source files) but has no test files.`,
231
+ directory: dirPath,
232
+ suggestion: 'Add test files for critical authentication, payment, or security code paths.',
233
+ metadata: {
234
+ sourceFiles: files.sourceFiles.length,
235
+ criticalPatternMatch: CRITICAL_PATH_PATTERNS.find(p => p.test(dirPath))?.source,
236
+ },
237
+ });
238
+ }
239
+ else if (files.sourceFiles.length > 3) {
240
+ // Only report non-critical dirs if they have substantial code
241
+ findings.push({
242
+ id: `no-tests-${dirPath.replace(/\//g, '-')}`,
243
+ category: 'coverage',
244
+ severity: 'medium',
245
+ type: 'no_tests',
246
+ title: `No tests for ${dirPath}`,
247
+ description: `Directory "${dirPath}" has ${files.sourceFiles.length} source files but no test files.`,
248
+ directory: dirPath,
249
+ suggestion: 'Consider adding test files to improve coverage.',
250
+ metadata: { sourceFiles: files.sourceFiles.length },
251
+ });
252
+ }
253
+ }
254
+ else if (coverageRatio < 0.5 && files.sourceFiles.length > 5) {
255
+ // Low test-to-source ratio for substantial directories
256
+ findings.push({
257
+ id: `low-ratio-${dirPath.replace(/\//g, '-')}`,
258
+ category: 'coverage',
259
+ severity: isCritical ? 'high' : 'low',
260
+ type: 'low_coverage',
261
+ title: `Low test coverage ratio: ${dirPath}`,
262
+ description: `Only ${files.testFiles.length} test files for ${files.sourceFiles.length} source files (${Math.round(coverageRatio * 100)}% ratio).`,
263
+ directory: dirPath,
264
+ suggestion: 'Add more tests to improve the test-to-source ratio.',
265
+ metadata: { coverageRatio, sourceFiles: files.sourceFiles.length, testFiles: files.testFiles.length },
266
+ });
267
+ }
268
+ }
269
+ // Check for coverage report
270
+ const coverageReport = findCoverageReport(input.projectPath);
271
+ if (coverageReport.found && coverageReport.overallPercent !== undefined) {
272
+ if (coverageReport.overallPercent < minCoverage) {
273
+ findings.push({
274
+ id: 'low-overall-coverage',
275
+ category: 'coverage',
276
+ severity: coverageReport.overallPercent < 50 ? 'high' : 'medium',
277
+ type: 'low_coverage',
278
+ title: `Overall code coverage is ${coverageReport.overallPercent.toFixed(1)}%`,
279
+ description: `Code coverage is below the ${minCoverage}% threshold.`,
280
+ suggestion: 'Run your test suite with coverage enabled and add tests for uncovered code.',
281
+ metadata: { actual: coverageReport.overallPercent, threshold: minCoverage },
282
+ });
283
+ }
284
+ }
285
+ // Calculate score
286
+ let score = 100;
287
+ // Penalize based on findings
288
+ for (const finding of findings) {
289
+ switch (finding.severity) {
290
+ case 'critical':
291
+ score -= 20;
292
+ break;
293
+ case 'high':
294
+ score -= 10;
295
+ break;
296
+ case 'medium':
297
+ score -= 5;
298
+ break;
299
+ case 'low':
300
+ score -= 2;
301
+ break;
302
+ }
303
+ }
304
+ // Bonus points for having coverage report
305
+ if (coverageReport.found && coverageReport.overallPercent !== undefined) {
306
+ if (coverageReport.overallPercent >= minCoverage) {
307
+ score = Math.min(100, score + 10);
308
+ }
309
+ }
310
+ score = Math.max(0, score);
311
+ const overallCoverageRatio = totalSourceFiles > 0 ? totalTestFiles / totalSourceFiles : 0;
312
+ return {
313
+ findings,
314
+ score,
315
+ directories: directoryCoverage.sort((a, b) => {
316
+ // Sort by: critical first, then by source file count
317
+ if (a.isCritical !== b.isCritical)
318
+ return a.isCritical ? -1 : 1;
319
+ return b.sourceFiles - a.sourceFiles;
320
+ }),
321
+ summary: {
322
+ totalSourceFiles,
323
+ totalTestFiles,
324
+ overallCoverageRatio,
325
+ directoriesWithNoTests: dirsWithNoTests,
326
+ criticalPathsUntested: criticalUntested,
327
+ },
328
+ scanDuration: Date.now() - startTime,
329
+ };
330
+ }
331
+ //# sourceMappingURL=coverage-scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"coverage-scanner.js","sourceRoot":"","sources":["../../../src/tools/hygiene/coverage-scanner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import { ToolSpec } from '../types.js';
2
+ export declare const sentinelScanCodebaseTool: ToolSpec;
3
+ export declare const sentinelScanCoverageTool: ToolSpec;
4
+ export declare const sentinelScanConfigTool: ToolSpec;
5
+ export declare const oracleHygieneReportTool: ToolSpec;
6
+ export declare const hygieneTools: ToolSpec[];
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/hygiene/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC,eAAO,MAAM,wBAAwB,EAAE,QA0FtC,CAAC;AAMF,eAAO,MAAM,wBAAwB,EAAE,QAqEtC,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,QA2DpC,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,QA0CrC,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,QAAQ,EAKlC,CAAC"}
@@ -0,0 +1,291 @@
1
+ // ============================================================================
2
+ // Hygiene Scanner Domain Tools
3
+ // ============================================================================
4
+ // Tools for detecting AI-induced technical debt and operational blindspots.
5
+ // - sentinel_scan_codebase: Structural code analysis
6
+ // - sentinel_scan_coverage: Test coverage gaps
7
+ // - sentinel_scan_config: Configuration and secrets issues
8
+ // - oracle_hygiene_report: Correlate findings with Vector run history
9
+ // ============================================================================
10
+ import { toolSuccess, toolError } from '../shared/index.js';
11
+ import { resolveProjectPaths } from '../../projectRegistry.js';
12
+ import { scanCodebase } from './codebase-scanner.js';
13
+ import { scanCoverage } from './coverage-scanner.js';
14
+ import { scanConfig } from './config-scanner.js';
15
+ import { generateHygieneReport } from './oracle-hygiene.js';
16
+ // ============================================================================
17
+ // Codebase Scanner Tool
18
+ // ============================================================================
19
+ export const sentinelScanCodebaseTool = {
20
+ definition: {
21
+ name: 'sentinel_scan_codebase',
22
+ description: 'Scan codebase for structural technical debt: god scripts (>500 LOC), rule sprawl (>10 elif chains), duplicated blocks, hardcoded values, and deep nesting. Returns findings with severity and suggestions.',
23
+ annotations: {
24
+ title: 'Scan Codebase',
25
+ readOnlyHint: true,
26
+ destructiveHint: false,
27
+ },
28
+ inputSchema: {
29
+ type: 'object',
30
+ properties: {
31
+ projectId: {
32
+ type: 'string',
33
+ description: 'Optional project identifier. Uses default project if not specified.',
34
+ },
35
+ path: {
36
+ type: 'string',
37
+ description: 'Optional path to scan (relative to project root). Defaults to entire project.',
38
+ },
39
+ thresholds: {
40
+ type: 'object',
41
+ description: 'Optional custom thresholds for detection',
42
+ properties: {
43
+ godScriptLines: {
44
+ type: 'number',
45
+ description: 'Lines of code threshold for god scripts (default: 500)',
46
+ },
47
+ ruleSprawlChains: {
48
+ type: 'number',
49
+ description: 'elif/else-if chain length threshold (default: 10)',
50
+ },
51
+ nestingDepth: {
52
+ type: 'number',
53
+ description: 'Maximum nesting depth (default: 5)',
54
+ },
55
+ },
56
+ },
57
+ includePatterns: {
58
+ type: 'array',
59
+ items: { type: 'string' },
60
+ description: 'Glob patterns to include (default: ["**/*.ts", "**/*.js", "**/*.py", ...])',
61
+ },
62
+ excludePatterns: {
63
+ type: 'array',
64
+ items: { type: 'string' },
65
+ description: 'Glob patterns to exclude (default: ["node_modules/**", "dist/**", ...])',
66
+ },
67
+ },
68
+ },
69
+ },
70
+ handler: async (args) => {
71
+ try {
72
+ // Resolve project path
73
+ const resolved = resolveProjectPaths(args.projectId);
74
+ const projectPath = args.path
75
+ ? `${resolved.projectPath}/${args.path}`
76
+ : resolved.projectPath;
77
+ const input = {
78
+ projectPath,
79
+ thresholds: args.thresholds,
80
+ includePatterns: args.includePatterns,
81
+ excludePatterns: args.excludePatterns,
82
+ };
83
+ const result = await scanCodebase(input);
84
+ // Format for Vector compatibility
85
+ return toolSuccess({
86
+ score: result.score,
87
+ findings: result.findings.map(f => ({
88
+ id: f.id,
89
+ category: 'structural',
90
+ severity: f.severity,
91
+ type: f.type,
92
+ title: f.title,
93
+ description: f.description,
94
+ file: f.file,
95
+ line: f.line,
96
+ suggestion: f.suggestion,
97
+ })),
98
+ summary: result.summary,
99
+ scanDuration: result.scanDuration,
100
+ });
101
+ }
102
+ catch (err) {
103
+ return toolError(err instanceof Error ? err.message : String(err));
104
+ }
105
+ },
106
+ };
107
+ // ============================================================================
108
+ // Coverage Scanner Tool
109
+ // ============================================================================
110
+ export const sentinelScanCoverageTool = {
111
+ definition: {
112
+ name: 'sentinel_scan_coverage',
113
+ description: 'Analyze test coverage gaps by directory. Identifies directories without tests, critical untested paths (auth, payments, security), and low test-to-source ratios.',
114
+ annotations: {
115
+ title: 'Scan Coverage',
116
+ readOnlyHint: true,
117
+ destructiveHint: false,
118
+ },
119
+ inputSchema: {
120
+ type: 'object',
121
+ properties: {
122
+ projectId: {
123
+ type: 'string',
124
+ description: 'Optional project identifier. Uses default project if not specified.',
125
+ },
126
+ path: {
127
+ type: 'string',
128
+ description: 'Optional path to scan (relative to project root). Defaults to entire project.',
129
+ },
130
+ thresholds: {
131
+ type: 'object',
132
+ description: 'Optional custom thresholds',
133
+ properties: {
134
+ minCoveragePercent: {
135
+ type: 'number',
136
+ description: 'Minimum acceptable coverage percentage (default: 70)',
137
+ },
138
+ },
139
+ },
140
+ },
141
+ },
142
+ },
143
+ handler: async (args) => {
144
+ try {
145
+ // Resolve project path
146
+ const resolved = resolveProjectPaths(args.projectId);
147
+ const projectPath = args.path
148
+ ? `${resolved.projectPath}/${args.path}`
149
+ : resolved.projectPath;
150
+ const input = {
151
+ projectPath,
152
+ thresholds: args.thresholds,
153
+ };
154
+ const result = await scanCoverage(input);
155
+ return toolSuccess({
156
+ score: result.score,
157
+ findings: result.findings.map(f => ({
158
+ id: f.id,
159
+ category: 'coverage',
160
+ severity: f.severity,
161
+ type: f.type,
162
+ title: f.title,
163
+ description: f.description,
164
+ directory: f.directory,
165
+ suggestion: f.suggestion,
166
+ })),
167
+ directories: result.directories,
168
+ summary: result.summary,
169
+ scanDuration: result.scanDuration,
170
+ });
171
+ }
172
+ catch (err) {
173
+ return toolError(err instanceof Error ? err.message : String(err));
174
+ }
175
+ },
176
+ };
177
+ // ============================================================================
178
+ // Config Scanner Tool
179
+ // ============================================================================
180
+ export const sentinelScanConfigTool = {
181
+ definition: {
182
+ name: 'sentinel_scan_config',
183
+ description: 'Scan for configuration issues: exposed secrets, env drift between environments, missing .env.example, and insecure defaults. Critical for security hygiene.',
184
+ annotations: {
185
+ title: 'Scan Config',
186
+ readOnlyHint: true,
187
+ destructiveHint: false,
188
+ },
189
+ inputSchema: {
190
+ type: 'object',
191
+ properties: {
192
+ projectId: {
193
+ type: 'string',
194
+ description: 'Optional project identifier. Uses default project if not specified.',
195
+ },
196
+ path: {
197
+ type: 'string',
198
+ description: 'Optional path to scan (relative to project root). Defaults to entire project.',
199
+ },
200
+ },
201
+ },
202
+ },
203
+ handler: async (args) => {
204
+ try {
205
+ // Resolve project path
206
+ const resolved = resolveProjectPaths(args.projectId);
207
+ const projectPath = args.path
208
+ ? `${resolved.projectPath}/${args.path}`
209
+ : resolved.projectPath;
210
+ const input = {
211
+ projectPath,
212
+ };
213
+ const result = await scanConfig(input);
214
+ return toolSuccess({
215
+ score: result.score,
216
+ findings: result.findings.map(f => ({
217
+ id: f.id,
218
+ category: 'config',
219
+ severity: f.severity,
220
+ type: f.type,
221
+ title: f.title,
222
+ description: f.description,
223
+ file: f.file,
224
+ line: f.line,
225
+ suggestion: f.suggestion,
226
+ })),
227
+ envFiles: result.envFiles,
228
+ summary: result.summary,
229
+ scanDuration: result.scanDuration,
230
+ });
231
+ }
232
+ catch (err) {
233
+ return toolError(err instanceof Error ? err.message : String(err));
234
+ }
235
+ },
236
+ };
237
+ // ============================================================================
238
+ // Oracle Hygiene Report Tool
239
+ // ============================================================================
240
+ export const oracleHygieneReportTool = {
241
+ definition: {
242
+ name: 'oracle_hygiene_report',
243
+ description: 'Generate a comprehensive hygiene report with drift correlation. Runs all scanners (structural, coverage, config), correlates findings with Vector run history to identify files that cause agent struggles, and generates prioritized hotspots for remediation.',
244
+ annotations: {
245
+ title: 'Hygiene Report',
246
+ readOnlyHint: true,
247
+ destructiveHint: false,
248
+ },
249
+ inputSchema: {
250
+ type: 'object',
251
+ properties: {
252
+ projectId: {
253
+ type: 'string',
254
+ description: 'Optional project identifier. Uses default project if not specified.',
255
+ },
256
+ runLimit: {
257
+ type: 'number',
258
+ description: 'How many recent Vector runs to analyze for correlation (default: 50)',
259
+ },
260
+ correlateWithDrift: {
261
+ type: 'boolean',
262
+ description: 'Whether to correlate findings with Vector run history (default: true)',
263
+ },
264
+ },
265
+ },
266
+ },
267
+ handler: async (args) => {
268
+ try {
269
+ const input = {
270
+ projectId: args.projectId,
271
+ runLimit: args.runLimit,
272
+ correlateWithDrift: args.correlateWithDrift,
273
+ };
274
+ const result = await generateHygieneReport(input);
275
+ return toolSuccess(result);
276
+ }
277
+ catch (err) {
278
+ return toolError(err instanceof Error ? err.message : String(err));
279
+ }
280
+ },
281
+ };
282
+ // ============================================================================
283
+ // Domain Export
284
+ // ============================================================================
285
+ export const hygieneTools = [
286
+ sentinelScanCodebaseTool,
287
+ sentinelScanCoverageTool,
288
+ sentinelScanConfigTool,
289
+ oracleHygieneReportTool,
290
+ ];
291
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/hygiene/index.ts"],"names":[],"mappings":"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"}