@shrkcrft/inspector 0.1.0-alpha.1

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 (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +15 -0
  3. package/dist/acceptance-replay.d.ts +63 -0
  4. package/dist/acceptance-replay.d.ts.map +1 -0
  5. package/dist/acceptance-replay.js +240 -0
  6. package/dist/action-hint-diagnostics.d.ts +32 -0
  7. package/dist/action-hint-diagnostics.d.ts.map +1 -0
  8. package/dist/action-hint-diagnostics.js +133 -0
  9. package/dist/adoption-check.d.ts +28 -0
  10. package/dist/adoption-check.d.ts.map +1 -0
  11. package/dist/adoption-check.js +181 -0
  12. package/dist/adoption-checkpoint.d.ts +97 -0
  13. package/dist/adoption-checkpoint.d.ts.map +1 -0
  14. package/dist/adoption-checkpoint.js +209 -0
  15. package/dist/adoption-merge-preview.d.ts +28 -0
  16. package/dist/adoption-merge-preview.d.ts.map +1 -0
  17. package/dist/adoption-merge-preview.js +254 -0
  18. package/dist/adoption-report-renderer.d.ts +33 -0
  19. package/dist/adoption-report-renderer.d.ts.map +1 -0
  20. package/dist/adoption-report-renderer.js +257 -0
  21. package/dist/adoption-state.d.ts +100 -0
  22. package/dist/adoption-state.d.ts.map +1 -0
  23. package/dist/adoption-state.js +296 -0
  24. package/dist/adoption-three-way.d.ts +46 -0
  25. package/dist/adoption-three-way.d.ts.map +1 -0
  26. package/dist/adoption-three-way.js +181 -0
  27. package/dist/agent-brief.d.ts +77 -0
  28. package/dist/agent-brief.d.ts.map +1 -0
  29. package/dist/agent-brief.js +490 -0
  30. package/dist/agent-contract-gate.d.ts +108 -0
  31. package/dist/agent-contract-gate.d.ts.map +1 -0
  32. package/dist/agent-contract-gate.js +412 -0
  33. package/dist/agent-contract-templates.d.ts +63 -0
  34. package/dist/agent-contract-templates.d.ts.map +1 -0
  35. package/dist/agent-contract-templates.js +346 -0
  36. package/dist/agent-contract.d.ts +65 -0
  37. package/dist/agent-contract.d.ts.map +1 -0
  38. package/dist/agent-contract.js +555 -0
  39. package/dist/agent-handoff.d.ts +123 -0
  40. package/dist/agent-handoff.d.ts.map +1 -0
  41. package/dist/agent-handoff.js +470 -0
  42. package/dist/agent-instructions.d.ts +2 -0
  43. package/dist/agent-instructions.d.ts.map +1 -0
  44. package/dist/agent-instructions.js +21 -0
  45. package/dist/agent-orchestration.d.ts +61 -0
  46. package/dist/agent-orchestration.d.ts.map +1 -0
  47. package/dist/agent-orchestration.js +285 -0
  48. package/dist/agent-task-prep.d.ts +31 -0
  49. package/dist/agent-task-prep.d.ts.map +1 -0
  50. package/dist/agent-task-prep.js +73 -0
  51. package/dist/ai-readiness.d.ts +30 -0
  52. package/dist/ai-readiness.d.ts.map +1 -0
  53. package/dist/ai-readiness.js +279 -0
  54. package/dist/api-report.d.ts +51 -0
  55. package/dist/api-report.d.ts.map +1 -0
  56. package/dist/api-report.js +254 -0
  57. package/dist/apply-dispatch-trace.d.ts +93 -0
  58. package/dist/apply-dispatch-trace.d.ts.map +1 -0
  59. package/dist/apply-dispatch-trace.js +283 -0
  60. package/dist/apply-gate-result.d.ts +52 -0
  61. package/dist/apply-gate-result.d.ts.map +1 -0
  62. package/dist/apply-gate-result.js +44 -0
  63. package/dist/architecture-map.d.ts +118 -0
  64. package/dist/architecture-map.d.ts.map +1 -0
  65. package/dist/architecture-map.js +543 -0
  66. package/dist/area-explore.d.ts +75 -0
  67. package/dist/area-explore.d.ts.map +1 -0
  68. package/dist/area-explore.js +438 -0
  69. package/dist/area-map.d.ts +57 -0
  70. package/dist/area-map.d.ts.map +1 -0
  71. package/dist/area-map.js +214 -0
  72. package/dist/asset-provenance.d.ts +123 -0
  73. package/dist/asset-provenance.d.ts.map +1 -0
  74. package/dist/asset-provenance.js +209 -0
  75. package/dist/barrel-operations.d.ts +45 -0
  76. package/dist/barrel-operations.d.ts.map +1 -0
  77. package/dist/barrel-operations.js +159 -0
  78. package/dist/boundaries-changed-only.d.ts +62 -0
  79. package/dist/boundaries-changed-only.d.ts.map +1 -0
  80. package/dist/boundaries-changed-only.js +97 -0
  81. package/dist/boundary-suggestions.d.ts +20 -0
  82. package/dist/boundary-suggestions.d.ts.map +1 -0
  83. package/dist/boundary-suggestions.js +51 -0
  84. package/dist/bundle-diff.d.ts +98 -0
  85. package/dist/bundle-diff.d.ts.map +1 -0
  86. package/dist/bundle-diff.js +531 -0
  87. package/dist/bundle-replay.d.ts +68 -0
  88. package/dist/bundle-replay.d.ts.map +1 -0
  89. package/dist/bundle-replay.js +273 -0
  90. package/dist/bundle-validate-html.d.ts +11 -0
  91. package/dist/bundle-validate-html.d.ts.map +1 -0
  92. package/dist/bundle-validate-html.js +60 -0
  93. package/dist/change-intent.d.ts +36 -0
  94. package/dist/change-intent.d.ts.map +1 -0
  95. package/dist/change-intent.js +259 -0
  96. package/dist/changed-preflight.d.ts +59 -0
  97. package/dist/changed-preflight.d.ts.map +1 -0
  98. package/dist/changed-preflight.js +358 -0
  99. package/dist/changed-scope.d.ts +112 -0
  100. package/dist/changed-scope.d.ts.map +1 -0
  101. package/dist/changed-scope.js +172 -0
  102. package/dist/changes-summary.d.ts +87 -0
  103. package/dist/changes-summary.d.ts.map +1 -0
  104. package/dist/changes-summary.js +323 -0
  105. package/dist/check-result-v1.d.ts +90 -0
  106. package/dist/check-result-v1.d.ts.map +1 -0
  107. package/dist/check-result-v1.js +335 -0
  108. package/dist/ci-integrity-report.d.ts +38 -0
  109. package/dist/ci-integrity-report.d.ts.map +1 -0
  110. package/dist/ci-integrity-report.js +324 -0
  111. package/dist/ci-permissions-fix.d.ts +38 -0
  112. package/dist/ci-permissions-fix.d.ts.map +1 -0
  113. package/dist/ci-permissions-fix.js +382 -0
  114. package/dist/ci-permissions.d.ts +51 -0
  115. package/dist/ci-permissions.d.ts.map +1 -0
  116. package/dist/ci-permissions.js +431 -0
  117. package/dist/ci-predict.d.ts +42 -0
  118. package/dist/ci-predict.d.ts.map +1 -0
  119. package/dist/ci-predict.js +300 -0
  120. package/dist/ci-scaffold.d.ts +47 -0
  121. package/dist/ci-scaffold.d.ts.map +1 -0
  122. package/dist/ci-scaffold.js +638 -0
  123. package/dist/codemod-assist.d.ts +97 -0
  124. package/dist/codemod-assist.d.ts.map +1 -0
  125. package/dist/codemod-assist.js +261 -0
  126. package/dist/command-recommender.d.ts +25 -0
  127. package/dist/command-recommender.d.ts.map +1 -0
  128. package/dist/command-recommender.js +145 -0
  129. package/dist/command-suggester.d.ts +61 -0
  130. package/dist/command-suggester.d.ts.map +1 -0
  131. package/dist/command-suggester.js +159 -0
  132. package/dist/command-taxonomy.d.ts +38 -0
  133. package/dist/command-taxonomy.d.ts.map +1 -0
  134. package/dist/command-taxonomy.js +164 -0
  135. package/dist/compliance-evidence.d.ts +58 -0
  136. package/dist/compliance-evidence.d.ts.map +1 -0
  137. package/dist/compliance-evidence.js +260 -0
  138. package/dist/compliance-profiles.d.ts +42 -0
  139. package/dist/compliance-profiles.d.ts.map +1 -0
  140. package/dist/compliance-profiles.js +171 -0
  141. package/dist/construct-adoption-diff.d.ts +55 -0
  142. package/dist/construct-adoption-diff.d.ts.map +1 -0
  143. package/dist/construct-adoption-diff.js +331 -0
  144. package/dist/construct-adoption.d.ts +71 -0
  145. package/dist/construct-adoption.d.ts.map +1 -0
  146. package/dist/construct-adoption.js +331 -0
  147. package/dist/construct-inference.d.ts +44 -0
  148. package/dist/construct-inference.d.ts.map +1 -0
  149. package/dist/construct-inference.js +391 -0
  150. package/dist/construct-registry.d.ts +32 -0
  151. package/dist/construct-registry.d.ts.map +1 -0
  152. package/dist/construct-registry.js +198 -0
  153. package/dist/contract-file-rule.d.ts +37 -0
  154. package/dist/contract-file-rule.d.ts.map +1 -0
  155. package/dist/contract-file-rule.js +99 -0
  156. package/dist/contract-template-registry.d.ts +28 -0
  157. package/dist/contract-template-registry.d.ts.map +1 -0
  158. package/dist/contract-template-registry.js +161 -0
  159. package/dist/contradictions.d.ts +52 -0
  160. package/dist/contradictions.d.ts.map +1 -0
  161. package/dist/contradictions.js +391 -0
  162. package/dist/convention-registry.d.ts +44 -0
  163. package/dist/convention-registry.d.ts.map +1 -0
  164. package/dist/convention-registry.js +195 -0
  165. package/dist/coverage-report.d.ts +25 -0
  166. package/dist/coverage-report.d.ts.map +1 -0
  167. package/dist/coverage-report.js +190 -0
  168. package/dist/custom-checks.d.ts +146 -0
  169. package/dist/custom-checks.d.ts.map +1 -0
  170. package/dist/custom-checks.js +260 -0
  171. package/dist/dashboard/dashboard-data.d.ts +59 -0
  172. package/dist/dashboard/dashboard-data.d.ts.map +1 -0
  173. package/dist/dashboard/dashboard-data.js +653 -0
  174. package/dist/dashboard-export.d.ts +67 -0
  175. package/dist/dashboard-export.d.ts.map +1 -0
  176. package/dist/dashboard-export.js +203 -0
  177. package/dist/decision-records.d.ts +47 -0
  178. package/dist/decision-records.d.ts.map +1 -0
  179. package/dist/decision-records.js +255 -0
  180. package/dist/demo-package.d.ts +49 -0
  181. package/dist/demo-package.d.ts.map +1 -0
  182. package/dist/demo-package.js +305 -0
  183. package/dist/demo-script.d.ts +25 -0
  184. package/dist/demo-script.d.ts.map +1 -0
  185. package/dist/demo-script.js +198 -0
  186. package/dist/demo-workflow.d.ts +28 -0
  187. package/dist/demo-workflow.d.ts.map +1 -0
  188. package/dist/demo-workflow.js +178 -0
  189. package/dist/dev-cycle.d.ts +41 -0
  190. package/dist/dev-cycle.d.ts.map +1 -0
  191. package/dist/dev-cycle.js +94 -0
  192. package/dist/dev-session-html.d.ts +13 -0
  193. package/dist/dev-session-html.d.ts.map +1 -0
  194. package/dist/dev-session-html.js +223 -0
  195. package/dist/dev-session-report.d.ts +11 -0
  196. package/dist/dev-session-report.d.ts.map +1 -0
  197. package/dist/dev-session-report.js +206 -0
  198. package/dist/dev-session.d.ts +257 -0
  199. package/dist/dev-session.d.ts.map +1 -0
  200. package/dist/dev-session.js +568 -0
  201. package/dist/diagnostics-suggest.d.ts +17 -0
  202. package/dist/diagnostics-suggest.d.ts.map +1 -0
  203. package/dist/diagnostics-suggest.js +69 -0
  204. package/dist/docs-check.d.ts +40 -0
  205. package/dist/docs-check.d.ts.map +1 -0
  206. package/dist/docs-check.js +221 -0
  207. package/dist/doctor-acknowledgements.d.ts +69 -0
  208. package/dist/doctor-acknowledgements.d.ts.map +1 -0
  209. package/dist/doctor-acknowledgements.js +150 -0
  210. package/dist/doctor-result.d.ts +51 -0
  211. package/dist/doctor-result.d.ts.map +1 -0
  212. package/dist/doctor-result.js +7 -0
  213. package/dist/doctor-suppressions.d.ts +91 -0
  214. package/dist/doctor-suppressions.d.ts.map +1 -0
  215. package/dist/doctor-suppressions.js +238 -0
  216. package/dist/drift-baseline.d.ts +29 -0
  217. package/dist/drift-baseline.d.ts.map +1 -0
  218. package/dist/drift-baseline.js +80 -0
  219. package/dist/drift.d.ts +38 -0
  220. package/dist/drift.d.ts.map +1 -0
  221. package/dist/drift.js +107 -0
  222. package/dist/entrypoint-matrix.d.ts +61 -0
  223. package/dist/entrypoint-matrix.d.ts.map +1 -0
  224. package/dist/entrypoint-matrix.js +221 -0
  225. package/dist/examples-check.d.ts +36 -0
  226. package/dist/examples-check.d.ts.map +1 -0
  227. package/dist/examples-check.js +168 -0
  228. package/dist/execution-graph.d.ts +98 -0
  229. package/dist/execution-graph.d.ts.map +1 -0
  230. package/dist/execution-graph.js +484 -0
  231. package/dist/export-bundle.d.ts +10 -0
  232. package/dist/export-bundle.d.ts.map +1 -0
  233. package/dist/export-bundle.js +90 -0
  234. package/dist/failure-diagnostics.d.ts +63 -0
  235. package/dist/failure-diagnostics.d.ts.map +1 -0
  236. package/dist/failure-diagnostics.js +243 -0
  237. package/dist/feature-bundle.d.ts +111 -0
  238. package/dist/feature-bundle.d.ts.map +1 -0
  239. package/dist/feature-bundle.js +211 -0
  240. package/dist/feedback-actions-v2.d.ts +65 -0
  241. package/dist/feedback-actions-v2.d.ts.map +1 -0
  242. package/dist/feedback-actions-v2.js +183 -0
  243. package/dist/feedback-ingestion.d.ts +96 -0
  244. package/dist/feedback-ingestion.d.ts.map +1 -0
  245. package/dist/feedback-ingestion.js +400 -0
  246. package/dist/fix-preview.d.ts +82 -0
  247. package/dist/fix-preview.d.ts.map +1 -0
  248. package/dist/fix-preview.js +365 -0
  249. package/dist/fuzzy-impact.d.ts +50 -0
  250. package/dist/fuzzy-impact.d.ts.map +1 -0
  251. package/dist/fuzzy-impact.js +446 -0
  252. package/dist/generated-code.d.ts +97 -0
  253. package/dist/generated-code.d.ts.map +1 -0
  254. package/dist/generated-code.js +395 -0
  255. package/dist/git-helpers.d.ts +38 -0
  256. package/dist/git-helpers.d.ts.map +1 -0
  257. package/dist/git-helpers.js +173 -0
  258. package/dist/golden-output.d.ts +33 -0
  259. package/dist/golden-output.d.ts.map +1 -0
  260. package/dist/golden-output.js +92 -0
  261. package/dist/grounding/build-grounding.d.ts +53 -0
  262. package/dist/grounding/build-grounding.d.ts.map +1 -0
  263. package/dist/grounding/build-grounding.js +51 -0
  264. package/dist/grounding/nx-projects.d.ts +29 -0
  265. package/dist/grounding/nx-projects.d.ts.map +1 -0
  266. package/dist/grounding/nx-projects.js +109 -0
  267. package/dist/grounding/validate-extracted-plan.d.ts +20 -0
  268. package/dist/grounding/validate-extracted-plan.d.ts.map +1 -0
  269. package/dist/grounding/validate-extracted-plan.js +127 -0
  270. package/dist/healing-plan.d.ts +33 -0
  271. package/dist/healing-plan.d.ts.map +1 -0
  272. package/dist/healing-plan.js +346 -0
  273. package/dist/helper-registry.d.ts +90 -0
  274. package/dist/helper-registry.d.ts.map +1 -0
  275. package/dist/helper-registry.js +529 -0
  276. package/dist/impact-analysis.d.ts +150 -0
  277. package/dist/impact-analysis.d.ts.map +1 -0
  278. package/dist/impact-analysis.js +697 -0
  279. package/dist/impact-graph-render.d.ts +51 -0
  280. package/dist/impact-graph-render.d.ts.map +1 -0
  281. package/dist/impact-graph-render.js +139 -0
  282. package/dist/impact-graph.d.ts +17 -0
  283. package/dist/impact-graph.d.ts.map +1 -0
  284. package/dist/impact-graph.js +119 -0
  285. package/dist/impact-render.d.ts +22 -0
  286. package/dist/impact-render.d.ts.map +1 -0
  287. package/dist/impact-render.js +422 -0
  288. package/dist/import-graph-analysis.d.ts +28 -0
  289. package/dist/import-graph-analysis.d.ts.map +1 -0
  290. package/dist/import-graph-analysis.js +193 -0
  291. package/dist/import-hygiene.d.ts +93 -0
  292. package/dist/import-hygiene.d.ts.map +1 -0
  293. package/dist/import-hygiene.js +366 -0
  294. package/dist/index.d.ts +224 -0
  295. package/dist/index.d.ts.map +1 -0
  296. package/dist/index.js +234 -0
  297. package/dist/ingest-adoption.d.ts +50 -0
  298. package/dist/ingest-adoption.d.ts.map +1 -0
  299. package/dist/ingest-adoption.js +183 -0
  300. package/dist/ingest-apply.d.ts +80 -0
  301. package/dist/ingest-apply.d.ts.map +1 -0
  302. package/dist/ingest-apply.js +227 -0
  303. package/dist/ingest-body-extractor.d.ts +28 -0
  304. package/dist/ingest-body-extractor.d.ts.map +1 -0
  305. package/dist/ingest-body-extractor.js +129 -0
  306. package/dist/ingest-drafts.d.ts +16 -0
  307. package/dist/ingest-drafts.d.ts.map +1 -0
  308. package/dist/ingest-drafts.js +482 -0
  309. package/dist/inspector-cache.d.ts +41 -0
  310. package/dist/inspector-cache.d.ts.map +1 -0
  311. package/dist/inspector-cache.js +104 -0
  312. package/dist/install-smoke.d.ts +44 -0
  313. package/dist/install-smoke.d.ts.map +1 -0
  314. package/dist/install-smoke.js +31 -0
  315. package/dist/knowledge-authoring.d.ts +151 -0
  316. package/dist/knowledge-authoring.d.ts.map +1 -0
  317. package/dist/knowledge-authoring.js +586 -0
  318. package/dist/knowledge-graph.d.ts +76 -0
  319. package/dist/knowledge-graph.d.ts.map +1 -0
  320. package/dist/knowledge-graph.js +336 -0
  321. package/dist/knowledge-lint.d.ts +97 -0
  322. package/dist/knowledge-lint.d.ts.map +1 -0
  323. package/dist/knowledge-lint.js +302 -0
  324. package/dist/knowledge-rename.d.ts +38 -0
  325. package/dist/knowledge-rename.d.ts.map +1 -0
  326. package/dist/knowledge-rename.js +88 -0
  327. package/dist/knowledge-stale.d.ts +124 -0
  328. package/dist/knowledge-stale.d.ts.map +1 -0
  329. package/dist/knowledge-stale.js +892 -0
  330. package/dist/languages/command-inference.d.ts +27 -0
  331. package/dist/languages/command-inference.d.ts.map +1 -0
  332. package/dist/languages/command-inference.js +214 -0
  333. package/dist/languages/dependency-scan.d.ts +33 -0
  334. package/dist/languages/dependency-scan.d.ts.map +1 -0
  335. package/dist/languages/dependency-scan.js +343 -0
  336. package/dist/languages/index.d.ts +14 -0
  337. package/dist/languages/index.d.ts.map +1 -0
  338. package/dist/languages/index.js +13 -0
  339. package/dist/languages/language-boundaries.d.ts +30 -0
  340. package/dist/languages/language-boundaries.d.ts.map +1 -0
  341. package/dist/languages/language-boundaries.js +176 -0
  342. package/dist/languages/language-cache.d.ts +54 -0
  343. package/dist/languages/language-cache.d.ts.map +1 -0
  344. package/dist/languages/language-cache.js +236 -0
  345. package/dist/languages/language-detection.d.ts +30 -0
  346. package/dist/languages/language-detection.d.ts.map +1 -0
  347. package/dist/languages/language-detection.js +584 -0
  348. package/dist/languages/language-id.d.ts +15 -0
  349. package/dist/languages/language-id.d.ts.map +1 -0
  350. package/dist/languages/language-id.js +15 -0
  351. package/dist/languages/language-runner.d.ts +90 -0
  352. package/dist/languages/language-runner.d.ts.map +1 -0
  353. package/dist/languages/language-runner.js +346 -0
  354. package/dist/languages/polyglot-boundary.d.ts +80 -0
  355. package/dist/languages/polyglot-boundary.d.ts.map +1 -0
  356. package/dist/languages/polyglot-boundary.js +373 -0
  357. package/dist/languages/polyglot-ci.d.ts +25 -0
  358. package/dist/languages/polyglot-ci.d.ts.map +1 -0
  359. package/dist/languages/polyglot-ci.js +278 -0
  360. package/dist/languages/test-impact.d.ts +19 -0
  361. package/dist/languages/test-impact.d.ts.map +1 -0
  362. package/dist/languages/test-impact.js +157 -0
  363. package/dist/loader-diagnostics.d.ts +40 -0
  364. package/dist/loader-diagnostics.d.ts.map +1 -0
  365. package/dist/loader-diagnostics.js +49 -0
  366. package/dist/memory-diff.d.ts +60 -0
  367. package/dist/memory-diff.d.ts.map +1 -0
  368. package/dist/memory-diff.js +302 -0
  369. package/dist/migration-profile-registry.d.ts +26 -0
  370. package/dist/migration-profile-registry.d.ts.map +1 -0
  371. package/dist/migration-profile-registry.js +135 -0
  372. package/dist/migration-readiness.d.ts +101 -0
  373. package/dist/migration-readiness.d.ts.map +1 -0
  374. package/dist/migration-readiness.js +253 -0
  375. package/dist/monorepo-onboarding.d.ts +51 -0
  376. package/dist/monorepo-onboarding.d.ts.map +1 -0
  377. package/dist/monorepo-onboarding.js +235 -0
  378. package/dist/onboarding-adoption-diff.d.ts +53 -0
  379. package/dist/onboarding-adoption-diff.d.ts.map +1 -0
  380. package/dist/onboarding-adoption-diff.js +285 -0
  381. package/dist/onboarding-adoption.d.ts +136 -0
  382. package/dist/onboarding-adoption.d.ts.map +1 -0
  383. package/dist/onboarding-adoption.js +702 -0
  384. package/dist/onboarding-agent-import.d.ts +40 -0
  385. package/dist/onboarding-agent-import.d.ts.map +1 -0
  386. package/dist/onboarding-agent-import.js +114 -0
  387. package/dist/onboarding-diff.d.ts +39 -0
  388. package/dist/onboarding-diff.d.ts.map +1 -0
  389. package/dist/onboarding-diff.js +240 -0
  390. package/dist/onboarding-drafts-merge.d.ts +71 -0
  391. package/dist/onboarding-drafts-merge.d.ts.map +1 -0
  392. package/dist/onboarding-drafts-merge.js +174 -0
  393. package/dist/onboarding-drafts.d.ts +42 -0
  394. package/dist/onboarding-drafts.d.ts.map +1 -0
  395. package/dist/onboarding-drafts.js +268 -0
  396. package/dist/onboarding-report.d.ts +8 -0
  397. package/dist/onboarding-report.d.ts.map +1 -0
  398. package/dist/onboarding-report.js +239 -0
  399. package/dist/onboarding.d.ts +134 -0
  400. package/dist/onboarding.d.ts.map +1 -0
  401. package/dist/onboarding.js +729 -0
  402. package/dist/ownership.d.ts +38 -0
  403. package/dist/ownership.d.ts.map +1 -0
  404. package/dist/ownership.js +102 -0
  405. package/dist/pack-author-ux.d.ts +58 -0
  406. package/dist/pack-author-ux.d.ts.map +1 -0
  407. package/dist/pack-author-ux.js +219 -0
  408. package/dist/pack-author.d.ts +94 -0
  409. package/dist/pack-author.d.ts.map +1 -0
  410. package/dist/pack-author.js +208 -0
  411. package/dist/pack-compatibility.d.ts +21 -0
  412. package/dist/pack-compatibility.d.ts.map +1 -0
  413. package/dist/pack-compatibility.js +114 -0
  414. package/dist/pack-contributions-inventory.d.ts +121 -0
  415. package/dist/pack-contributions-inventory.d.ts.map +1 -0
  416. package/dist/pack-contributions-inventory.js +732 -0
  417. package/dist/pack-docs.d.ts +11 -0
  418. package/dist/pack-docs.d.ts.map +1 -0
  419. package/dist/pack-docs.js +101 -0
  420. package/dist/pack-doctor.d.ts +50 -0
  421. package/dist/pack-doctor.d.ts.map +1 -0
  422. package/dist/pack-doctor.js +302 -0
  423. package/dist/pack-helper-registry.d.ts +29 -0
  424. package/dist/pack-helper-registry.d.ts.map +1 -0
  425. package/dist/pack-helper-registry.js +144 -0
  426. package/dist/pack-pending.d.ts +68 -0
  427. package/dist/pack-pending.d.ts.map +1 -0
  428. package/dist/pack-pending.js +189 -0
  429. package/dist/pack-quality-score.d.ts +44 -0
  430. package/dist/pack-quality-score.d.ts.map +1 -0
  431. package/dist/pack-quality-score.js +155 -0
  432. package/dist/pack-release-check.d.ts +24 -0
  433. package/dist/pack-release-check.d.ts.map +1 -0
  434. package/dist/pack-release-check.js +258 -0
  435. package/dist/pack-signature-status.d.ts +72 -0
  436. package/dist/pack-signature-status.d.ts.map +1 -0
  437. package/dist/pack-signature-status.js +222 -0
  438. package/dist/pack-symbol-compat.d.ts +73 -0
  439. package/dist/pack-symbol-compat.d.ts.map +1 -0
  440. package/dist/pack-symbol-compat.js +519 -0
  441. package/dist/pack-test-runner.d.ts +59 -0
  442. package/dist/pack-test-runner.d.ts.map +1 -0
  443. package/dist/pack-test-runner.js +211 -0
  444. package/dist/pipeline-command-dictionary.d.ts +2 -0
  445. package/dist/pipeline-command-dictionary.d.ts.map +1 -0
  446. package/dist/pipeline-command-dictionary.js +20 -0
  447. package/dist/pipeline-lint.d.ts +30 -0
  448. package/dist/pipeline-lint.d.ts.map +1 -0
  449. package/dist/pipeline-lint.js +134 -0
  450. package/dist/plan-dependency-graph.d.ts +25 -0
  451. package/dist/plan-dependency-graph.d.ts.map +1 -0
  452. package/dist/plan-dependency-graph.js +195 -0
  453. package/dist/plan-review.d.ts +64 -0
  454. package/dist/plan-review.d.ts.map +1 -0
  455. package/dist/plan-review.js +242 -0
  456. package/dist/plan-simulation.d.ts +108 -0
  457. package/dist/plan-simulation.d.ts.map +1 -0
  458. package/dist/plan-simulation.js +767 -0
  459. package/dist/playbook-registry.d.ts +25 -0
  460. package/dist/playbook-registry.d.ts.map +1 -0
  461. package/dist/playbook-registry.js +148 -0
  462. package/dist/playbook-script.d.ts +60 -0
  463. package/dist/playbook-script.d.ts.map +1 -0
  464. package/dist/playbook-script.js +161 -0
  465. package/dist/plugin-lifecycle-profile-registry.d.ts +52 -0
  466. package/dist/plugin-lifecycle-profile-registry.d.ts.map +1 -0
  467. package/dist/plugin-lifecycle-profile-registry.js +202 -0
  468. package/dist/plugin-lifecycle.d.ts +132 -0
  469. package/dist/plugin-lifecycle.d.ts.map +1 -0
  470. package/dist/plugin-lifecycle.js +477 -0
  471. package/dist/policy-engine.d.ts +101 -0
  472. package/dist/policy-engine.d.ts.map +1 -0
  473. package/dist/policy-engine.js +321 -0
  474. package/dist/policy-override-audit.d.ts +18 -0
  475. package/dist/policy-override-audit.d.ts.map +1 -0
  476. package/dist/policy-override-audit.js +54 -0
  477. package/dist/policy-overrides.d.ts +35 -0
  478. package/dist/policy-overrides.d.ts.map +1 -0
  479. package/dist/policy-overrides.js +84 -0
  480. package/dist/policy-test.d.ts +83 -0
  481. package/dist/policy-test.d.ts.map +1 -0
  482. package/dist/policy-test.js +342 -0
  483. package/dist/pr-summary.d.ts +34 -0
  484. package/dist/pr-summary.d.ts.map +1 -0
  485. package/dist/pr-summary.js +220 -0
  486. package/dist/product-coherence.d.ts +21 -0
  487. package/dist/product-coherence.d.ts.map +1 -0
  488. package/dist/product-coherence.js +158 -0
  489. package/dist/profile-registry.d.ts +42 -0
  490. package/dist/profile-registry.d.ts.map +1 -0
  491. package/dist/profile-registry.js +104 -0
  492. package/dist/project-coupling-audit.d.ts +64 -0
  493. package/dist/project-coupling-audit.d.ts.map +1 -0
  494. package/dist/project-coupling-audit.js +282 -0
  495. package/dist/project-overview.d.ts +14 -0
  496. package/dist/project-overview.d.ts.map +1 -0
  497. package/dist/project-overview.js +27 -0
  498. package/dist/propose-knowledge.d.ts +64 -0
  499. package/dist/propose-knowledge.d.ts.map +1 -0
  500. package/dist/propose-knowledge.js +367 -0
  501. package/dist/quality-baseline.d.ts +123 -0
  502. package/dist/quality-baseline.d.ts.map +1 -0
  503. package/dist/quality-baseline.js +433 -0
  504. package/dist/quality-html.d.ts +7 -0
  505. package/dist/quality-html.d.ts.map +1 -0
  506. package/dist/quality-html.js +64 -0
  507. package/dist/quality-report.d.ts +49 -0
  508. package/dist/quality-report.d.ts.map +1 -0
  509. package/dist/quality-report.js +296 -0
  510. package/dist/query-resolver.d.ts +38 -0
  511. package/dist/query-resolver.d.ts.map +1 -0
  512. package/dist/query-resolver.js +163 -0
  513. package/dist/ranker-explainability.d.ts +91 -0
  514. package/dist/ranker-explainability.d.ts.map +1 -0
  515. package/dist/ranker-explainability.js +550 -0
  516. package/dist/reference-lookup.d.ts +8 -0
  517. package/dist/reference-lookup.d.ts.map +1 -0
  518. package/dist/reference-lookup.js +18 -0
  519. package/dist/registration-hint-registry.d.ts +55 -0
  520. package/dist/registration-hint-registry.d.ts.map +1 -0
  521. package/dist/registration-hint-registry.js +327 -0
  522. package/dist/registry-lifecycle.d.ts +47 -0
  523. package/dist/registry-lifecycle.d.ts.map +1 -0
  524. package/dist/registry-lifecycle.js +214 -0
  525. package/dist/release-readiness.d.ts +64 -0
  526. package/dist/release-readiness.d.ts.map +1 -0
  527. package/dist/release-readiness.js +456 -0
  528. package/dist/release-smoke.d.ts +138 -0
  529. package/dist/release-smoke.d.ts.map +1 -0
  530. package/dist/release-smoke.js +459 -0
  531. package/dist/release-train.d.ts +33 -0
  532. package/dist/release-train.d.ts.map +1 -0
  533. package/dist/release-train.js +104 -0
  534. package/dist/repo-memory.d.ts +95 -0
  535. package/dist/repo-memory.d.ts.map +1 -0
  536. package/dist/repo-memory.js +614 -0
  537. package/dist/report-site.d.ts +92 -0
  538. package/dist/report-site.d.ts.map +1 -0
  539. package/dist/report-site.js +658 -0
  540. package/dist/reposet.d.ts +56 -0
  541. package/dist/reposet.d.ts.map +1 -0
  542. package/dist/reposet.js +160 -0
  543. package/dist/repository-intelligence.d.ts +145 -0
  544. package/dist/repository-intelligence.d.ts.map +1 -0
  545. package/dist/repository-intelligence.js +729 -0
  546. package/dist/repository-knowledge-model.d.ts +218 -0
  547. package/dist/repository-knowledge-model.d.ts.map +1 -0
  548. package/dist/repository-knowledge-model.js +939 -0
  549. package/dist/repository-map.d.ts +72 -0
  550. package/dist/repository-map.d.ts.map +1 -0
  551. package/dist/repository-map.js +332 -0
  552. package/dist/repository-stats.d.ts +66 -0
  553. package/dist/repository-stats.d.ts.map +1 -0
  554. package/dist/repository-stats.js +329 -0
  555. package/dist/review-comment-renderer.d.ts +59 -0
  556. package/dist/review-comment-renderer.d.ts.map +1 -0
  557. package/dist/review-comment-renderer.js +181 -0
  558. package/dist/review-comment-v2.d.ts +9 -0
  559. package/dist/review-comment-v2.d.ts.map +1 -0
  560. package/dist/review-comment-v2.js +178 -0
  561. package/dist/review-html.d.ts +13 -0
  562. package/dist/review-html.d.ts.map +1 -0
  563. package/dist/review-html.js +79 -0
  564. package/dist/review-packet-v2.d.ts +29 -0
  565. package/dist/review-packet-v2.d.ts.map +1 -0
  566. package/dist/review-packet-v2.js +81 -0
  567. package/dist/review-packet-v3.d.ts +22 -0
  568. package/dist/review-packet-v3.d.ts.map +1 -0
  569. package/dist/review-packet-v3.js +181 -0
  570. package/dist/review-packet.d.ts +49 -0
  571. package/dist/review-packet.d.ts.map +1 -0
  572. package/dist/review-packet.js +129 -0
  573. package/dist/risk-signals.d.ts +28 -0
  574. package/dist/risk-signals.d.ts.map +1 -0
  575. package/dist/risk-signals.js +68 -0
  576. package/dist/role-views.d.ts +50 -0
  577. package/dist/role-views.d.ts.map +1 -0
  578. package/dist/role-views.js +334 -0
  579. package/dist/rounds.d.ts +52 -0
  580. package/dist/rounds.d.ts.map +1 -0
  581. package/dist/rounds.js +172 -0
  582. package/dist/rule-drift.d.ts +42 -0
  583. package/dist/rule-drift.d.ts.map +1 -0
  584. package/dist/rule-drift.js +148 -0
  585. package/dist/rule-quality.d.ts +73 -0
  586. package/dist/rule-quality.d.ts.map +1 -0
  587. package/dist/rule-quality.js +356 -0
  588. package/dist/rule-scaffold.d.ts +71 -0
  589. package/dist/rule-scaffold.d.ts.map +1 -0
  590. package/dist/rule-scaffold.js +258 -0
  591. package/dist/safety-audit-deep.d.ts +38 -0
  592. package/dist/safety-audit-deep.d.ts.map +1 -0
  593. package/dist/safety-audit-deep.js +162 -0
  594. package/dist/safety-audit.d.ts +91 -0
  595. package/dist/safety-audit.d.ts.map +1 -0
  596. package/dist/safety-audit.js +138 -0
  597. package/dist/safety-html.d.ts +7 -0
  598. package/dist/safety-html.d.ts.map +1 -0
  599. package/dist/safety-html.js +70 -0
  600. package/dist/scaffold-coverage.d.ts +46 -0
  601. package/dist/scaffold-coverage.d.ts.map +1 -0
  602. package/dist/scaffold-coverage.js +273 -0
  603. package/dist/scaffold-patterns.d.ts +38 -0
  604. package/dist/scaffold-patterns.d.ts.map +1 -0
  605. package/dist/scaffold-patterns.js +282 -0
  606. package/dist/schema-inventory.d.ts +55 -0
  607. package/dist/schema-inventory.d.ts.map +1 -0
  608. package/dist/schema-inventory.js +301 -0
  609. package/dist/search-index.d.ts +75 -0
  610. package/dist/search-index.d.ts.map +1 -0
  611. package/dist/search-index.js +531 -0
  612. package/dist/search-tuning-explain.d.ts +68 -0
  613. package/dist/search-tuning-explain.d.ts.map +1 -0
  614. package/dist/search-tuning-explain.js +207 -0
  615. package/dist/search-tuning-registry.d.ts +54 -0
  616. package/dist/search-tuning-registry.d.ts.map +1 -0
  617. package/dist/search-tuning-registry.js +303 -0
  618. package/dist/self-audit.d.ts +59 -0
  619. package/dist/self-audit.d.ts.map +1 -0
  620. package/dist/self-audit.js +192 -0
  621. package/dist/self-config-doctor-v2.d.ts +57 -0
  622. package/dist/self-config-doctor-v2.d.ts.map +1 -0
  623. package/dist/self-config-doctor-v2.js +653 -0
  624. package/dist/self-config-doctor.d.ts +47 -0
  625. package/dist/self-config-doctor.d.ts.map +1 -0
  626. package/dist/self-config-doctor.js +432 -0
  627. package/dist/sharkcraft-inspector.d.ts +73 -0
  628. package/dist/sharkcraft-inspector.d.ts.map +1 -0
  629. package/dist/sharkcraft-inspector.js +745 -0
  630. package/dist/spec/spec-cross-validate.d.ts +17 -0
  631. package/dist/spec/spec-cross-validate.d.ts.map +1 -0
  632. package/dist/spec/spec-cross-validate.js +53 -0
  633. package/dist/spec/spec-discovery.d.ts +27 -0
  634. package/dist/spec/spec-discovery.d.ts.map +1 -0
  635. package/dist/spec/spec-discovery.js +78 -0
  636. package/dist/spec/spec-review.d.ts +36 -0
  637. package/dist/spec/spec-review.d.ts.map +1 -0
  638. package/dist/spec/spec-review.js +37 -0
  639. package/dist/stability-map.d.ts +62 -0
  640. package/dist/stability-map.d.ts.map +1 -0
  641. package/dist/stability-map.js +404 -0
  642. package/dist/start-here.d.ts +49 -0
  643. package/dist/start-here.d.ts.map +1 -0
  644. package/dist/start-here.js +259 -0
  645. package/dist/surface-profile-detect.d.ts +42 -0
  646. package/dist/surface-profile-detect.d.ts.map +1 -0
  647. package/dist/surface-profile-detect.js +76 -0
  648. package/dist/symbol-index.d.ts +108 -0
  649. package/dist/symbol-index.d.ts.map +1 -0
  650. package/dist/symbol-index.js +483 -0
  651. package/dist/task-decompose.d.ts +38 -0
  652. package/dist/task-decompose.d.ts.map +1 -0
  653. package/dist/task-decompose.js +154 -0
  654. package/dist/task-packet.d.ts +104 -0
  655. package/dist/task-packet.d.ts.map +1 -0
  656. package/dist/task-packet.js +156 -0
  657. package/dist/task-ranker.d.ts +51 -0
  658. package/dist/task-ranker.d.ts.map +1 -0
  659. package/dist/task-ranker.js +410 -0
  660. package/dist/task-risk.d.ts +84 -0
  661. package/dist/task-risk.d.ts.map +1 -0
  662. package/dist/task-risk.js +731 -0
  663. package/dist/task-routing-hint-registry.d.ts +36 -0
  664. package/dist/task-routing-hint-registry.d.ts.map +1 -0
  665. package/dist/task-routing-hint-registry.js +186 -0
  666. package/dist/template-authoring.d.ts +113 -0
  667. package/dist/template-authoring.d.ts.map +1 -0
  668. package/dist/template-authoring.js +521 -0
  669. package/dist/template-body-inference-v2.d.ts +19 -0
  670. package/dist/template-body-inference-v2.d.ts.map +1 -0
  671. package/dist/template-body-inference-v2.js +468 -0
  672. package/dist/template-body-inference.d.ts +59 -0
  673. package/dist/template-body-inference.d.ts.map +1 -0
  674. package/dist/template-body-inference.js +277 -0
  675. package/dist/template-drift.d.ts +39 -0
  676. package/dist/template-drift.d.ts.map +1 -0
  677. package/dist/template-drift.js +353 -0
  678. package/dist/template-lint.d.ts +31 -0
  679. package/dist/template-lint.d.ts.map +1 -0
  680. package/dist/template-lint.js +113 -0
  681. package/dist/test-definitions.d.ts +41 -0
  682. package/dist/test-definitions.d.ts.map +1 -0
  683. package/dist/test-definitions.js +6 -0
  684. package/dist/test-impact.d.ts +30 -0
  685. package/dist/test-impact.d.ts.map +1 -0
  686. package/dist/test-impact.js +173 -0
  687. package/dist/test-runner.d.ts +87 -0
  688. package/dist/test-runner.d.ts.map +1 -0
  689. package/dist/test-runner.js +560 -0
  690. package/dist/uncertainty-report.d.ts +46 -0
  691. package/dist/uncertainty-report.d.ts.map +1 -0
  692. package/dist/uncertainty-report.js +108 -0
  693. package/dist/uncertainty.d.ts +38 -0
  694. package/dist/uncertainty.d.ts.map +1 -0
  695. package/dist/uncertainty.js +115 -0
  696. package/dist/universal-search.d.ts +64 -0
  697. package/dist/universal-search.d.ts.map +1 -0
  698. package/dist/universal-search.js +347 -0
  699. package/dist/upgrade-advisor.d.ts +22 -0
  700. package/dist/upgrade-advisor.d.ts.map +1 -0
  701. package/dist/upgrade-advisor.js +109 -0
  702. package/dist/why-file.d.ts +75 -0
  703. package/dist/why-file.d.ts.map +1 -0
  704. package/dist/why-file.js +202 -0
  705. package/dist/workflow-simulation.d.ts +46 -0
  706. package/dist/workflow-simulation.d.ts.map +1 -0
  707. package/dist/workflow-simulation.js +154 -0
  708. package/package.json +65 -0
@@ -0,0 +1,433 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
3
+ import * as nodePath from 'node:path';
4
+ import { buildAiReadinessReport } from "./ai-readiness.js";
5
+ import { buildCoverageReport } from "./coverage-report.js";
6
+ import { buildQualityReport } from "./quality-report.js";
7
+ export const QUALITY_BASELINE_SCHEMA = 'sharkcraft.quality-baseline/v1';
8
+ function nowIso() {
9
+ return new Date().toISOString();
10
+ }
11
+ function gateNumeric(gate, key) {
12
+ const v = gate.data?.[key];
13
+ return typeof v === 'number' ? v : 0;
14
+ }
15
+ function readSharkcraftVersion(projectRoot) {
16
+ // Best-effort: look for the toolkit's own package.json next to the inspector.
17
+ // Falls back to '0.0.0' rather than throwing if discovery fails.
18
+ const candidates = [
19
+ nodePath.join(projectRoot, 'package.json'),
20
+ ];
21
+ try {
22
+ // Walk up from this file to find packages/inspector/package.json.
23
+ const here = new URL('.', import.meta.url).pathname;
24
+ const insp = nodePath.resolve(here, '..', 'package.json');
25
+ candidates.unshift(insp);
26
+ }
27
+ catch {
28
+ /* ignore */
29
+ }
30
+ for (const p of candidates) {
31
+ try {
32
+ if (!existsSync(p))
33
+ continue;
34
+ const v = JSON.parse(readFileSync(p, 'utf8'));
35
+ if (v.version)
36
+ return v.version;
37
+ }
38
+ catch {
39
+ /* ignore */
40
+ }
41
+ }
42
+ return '0.0.0';
43
+ }
44
+ function configHashFor(inspection) {
45
+ const file = inspection.configFile;
46
+ if (!file || !existsSync(file))
47
+ return null;
48
+ try {
49
+ const content = readFileSync(file, 'utf8');
50
+ return createHash('sha256').update(content).digest('hex').slice(0, 16);
51
+ }
52
+ catch {
53
+ return null;
54
+ }
55
+ }
56
+ function packSignaturesSummary(inspection) {
57
+ const summary = {
58
+ total: 0,
59
+ verified: 0,
60
+ unverified: 0,
61
+ invalid: 0,
62
+ notChecked: 0,
63
+ };
64
+ for (const pack of inspection.packs.validPacks ?? []) {
65
+ summary.total += 1;
66
+ const status = pack.signatureStatus;
67
+ if (status === 'verified')
68
+ summary.verified += 1;
69
+ else if (status === 'invalid-signature')
70
+ summary.invalid += 1;
71
+ else if (status === 'not-checked' || !status)
72
+ summary.notChecked += 1;
73
+ else
74
+ summary.unverified += 1;
75
+ }
76
+ return summary;
77
+ }
78
+ function categoryScoresFrom(inspection) {
79
+ const out = [];
80
+ try {
81
+ const cov = buildCoverageReport(inspection);
82
+ for (const c of cov.categories) {
83
+ out.push({ id: `coverage:${c.id}`, score: c.score });
84
+ }
85
+ out.push({ id: 'coverage:overall', score: cov.overall });
86
+ }
87
+ catch {
88
+ /* ignore */
89
+ }
90
+ try {
91
+ const r = buildAiReadinessReport(inspection);
92
+ out.push({ id: 'readiness:overall', score: r.score });
93
+ }
94
+ catch {
95
+ /* ignore */
96
+ }
97
+ return out;
98
+ }
99
+ function extractBaseline(inspection, report) {
100
+ const drift = report.drift;
101
+ const readiness = (() => {
102
+ try {
103
+ return buildAiReadinessReport(inspection).score;
104
+ }
105
+ catch {
106
+ return 0;
107
+ }
108
+ })();
109
+ return {
110
+ schema: QUALITY_BASELINE_SCHEMA,
111
+ createdAt: nowIso(),
112
+ projectRoot: inspection.projectRoot,
113
+ sharkcraftVersion: readSharkcraftVersion(inspection.projectRoot),
114
+ configHash: configHashFor(inspection),
115
+ qualityScore: report.score,
116
+ readinessScore: readiness,
117
+ blockers: report.blockers,
118
+ warnings: report.warnings,
119
+ gates: report.gates.map((g) => ({
120
+ id: g.id,
121
+ passed: g.passed,
122
+ errors: gateNumeric(g, 'errors'),
123
+ warnings: gateNumeric(g, 'warnings'),
124
+ })),
125
+ categoryScores: categoryScoresFrom(inspection),
126
+ driftFindings: drift?.findings.length ?? 0,
127
+ driftErrors: drift?.counts.error ?? 0,
128
+ driftWarnings: drift?.counts.warning ?? 0,
129
+ packSignatures: packSignaturesSummary(inspection),
130
+ };
131
+ }
132
+ export async function createQualityBaseline(inspection, outFile) {
133
+ const report = await buildQualityReport({
134
+ inspection,
135
+ config: {},
136
+ });
137
+ const baseline = extractBaseline(inspection, report);
138
+ mkdirSync(nodePath.dirname(outFile), { recursive: true });
139
+ writeFileSync(outFile, JSON.stringify(baseline, null, 2) + '\n', 'utf8');
140
+ return baseline;
141
+ }
142
+ export function readQualityBaseline(file) {
143
+ if (!existsSync(file))
144
+ return null;
145
+ try {
146
+ return JSON.parse(readFileSync(file, 'utf8'));
147
+ }
148
+ catch {
149
+ return null;
150
+ }
151
+ }
152
+ export function diffQualityBaselineFiles(oldFile, newFile) {
153
+ const oldBaseline = readQualityBaseline(oldFile);
154
+ const newBaseline = readQualityBaseline(newFile);
155
+ if (!oldBaseline || !newBaseline)
156
+ return null;
157
+ const categoryDeltas = [];
158
+ const newCats = new Map((newBaseline.categoryScores ?? []).map((c) => [c.id, c.score]));
159
+ for (const oldCat of oldBaseline.categoryScores ?? []) {
160
+ const cur = newCats.get(oldCat.id) ?? 0;
161
+ if (cur === oldCat.score)
162
+ continue;
163
+ categoryDeltas.push({ id: oldCat.id, old: oldCat.score, new: cur, delta: cur - oldCat.score });
164
+ }
165
+ // Per-gate warning movement: gates that flipped passed→failed produce "new warnings".
166
+ const oldGates = new Map(oldBaseline.gates.map((g) => [g.id, g]));
167
+ const newWarnings = [];
168
+ const resolvedWarnings = [];
169
+ for (const g of newBaseline.gates) {
170
+ const b = oldGates.get(g.id);
171
+ if (!b)
172
+ continue;
173
+ if (b.passed && !g.passed)
174
+ newWarnings.push(`gate ${g.id} now failing`);
175
+ if (!b.passed && g.passed)
176
+ resolvedWarnings.push(`gate ${g.id} now passing`);
177
+ if (g.warnings > b.warnings)
178
+ newWarnings.push(`gate ${g.id} warnings +${g.warnings - b.warnings}`);
179
+ if (g.warnings < b.warnings)
180
+ resolvedWarnings.push(`gate ${g.id} warnings -${b.warnings - g.warnings}`);
181
+ }
182
+ return {
183
+ schema: 'sharkcraft.quality-baseline-diff/v1',
184
+ oldFile,
185
+ newFile,
186
+ oldBaseline,
187
+ newBaseline,
188
+ scoreDelta: newBaseline.qualityScore - oldBaseline.qualityScore,
189
+ blockersDelta: newBaseline.blockers - oldBaseline.blockers,
190
+ warningsDelta: newBaseline.warnings - oldBaseline.warnings,
191
+ categoryDeltas,
192
+ resolvedWarnings,
193
+ newWarnings,
194
+ signatureChanges: {
195
+ addedVerified: Math.max(0, newBaseline.packSignatures.verified - oldBaseline.packSignatures.verified),
196
+ lostVerified: Math.max(0, oldBaseline.packSignatures.verified - newBaseline.packSignatures.verified),
197
+ },
198
+ configHashChanged: oldBaseline.configHash !== newBaseline.configHash,
199
+ };
200
+ }
201
+ export function listQualityBaselineHistory(cwd, baselineDir) {
202
+ const dir = baselineDir ?? nodePath.join(cwd, '.sharkcraft', 'baselines');
203
+ const entries = [];
204
+ if (existsSync(dir)) {
205
+ try {
206
+ for (const f of readdirSync(dir)) {
207
+ if (!f.endsWith('.json'))
208
+ continue;
209
+ const full = nodePath.join(dir, f);
210
+ try {
211
+ if (!statSync(full).isFile())
212
+ continue;
213
+ }
214
+ catch {
215
+ continue;
216
+ }
217
+ const b = readQualityBaseline(full);
218
+ if (!b)
219
+ continue;
220
+ entries.push({
221
+ file: full,
222
+ createdAt: b.createdAt,
223
+ qualityScore: b.qualityScore,
224
+ readinessScore: b.readinessScore,
225
+ blockers: b.blockers,
226
+ warnings: b.warnings,
227
+ configHash: b.configHash ?? null,
228
+ signaturesVerified: b.packSignatures?.verified ?? 0,
229
+ signaturesTotal: b.packSignatures?.total ?? 0,
230
+ });
231
+ }
232
+ }
233
+ catch {
234
+ /* ignore */
235
+ }
236
+ }
237
+ // Sort newest first by createdAt.
238
+ entries.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
239
+ return {
240
+ schema: 'sharkcraft.quality-baseline-history/v1',
241
+ baselineDir: dir,
242
+ entries,
243
+ latest: entries[0] ?? null,
244
+ previous: entries[1] ?? null,
245
+ };
246
+ }
247
+ export function pruneQualityBaselines(input) {
248
+ const dir = input.baselineDir ?? nodePath.join(input.cwd, '.sharkcraft', 'baselines');
249
+ const keep = Math.max(1, input.keep ?? 10);
250
+ if (!existsSync(dir)) {
251
+ return {
252
+ schema: 'sharkcraft.quality-baseline-prune/v1',
253
+ baselineDir: dir,
254
+ kept: [],
255
+ pruned: [],
256
+ dryRun: !input.write,
257
+ };
258
+ }
259
+ const files = [];
260
+ try {
261
+ for (const f of readdirSync(dir)) {
262
+ if (!f.endsWith('.json'))
263
+ continue;
264
+ const full = nodePath.join(dir, f);
265
+ try {
266
+ if (!statSync(full).isFile())
267
+ continue;
268
+ }
269
+ catch {
270
+ continue;
271
+ }
272
+ files.push(full);
273
+ }
274
+ }
275
+ catch {
276
+ /* ignore */
277
+ }
278
+ // Sort by createdAt inside each baseline (descending). Fallback: filename.
279
+ files.sort((a, b) => {
280
+ const ba = readQualityBaseline(a)?.createdAt ?? a;
281
+ const bb = readQualityBaseline(b)?.createdAt ?? b;
282
+ return bb.localeCompare(ba);
283
+ });
284
+ const kept = files.slice(0, keep);
285
+ const pruned = files.slice(keep);
286
+ if (input.write) {
287
+ for (const f of pruned) {
288
+ try {
289
+ unlinkSync(f);
290
+ }
291
+ catch {
292
+ /* ignore */
293
+ }
294
+ }
295
+ }
296
+ return {
297
+ schema: 'sharkcraft.quality-baseline-prune/v1',
298
+ baselineDir: dir,
299
+ kept,
300
+ pruned,
301
+ dryRun: !input.write,
302
+ };
303
+ }
304
+ const HIGHER_IS_BETTER = new Set(['qualityScore', 'readinessScore']);
305
+ const LOWER_IS_BETTER = new Set([
306
+ 'blockers',
307
+ 'warnings',
308
+ 'driftFindings',
309
+ 'driftErrors',
310
+ 'driftWarnings',
311
+ ]);
312
+ function classify(metric, delta) {
313
+ if (delta === 0)
314
+ return 'unchanged';
315
+ if (HIGHER_IS_BETTER.has(metric))
316
+ return delta > 0 ? 'improved' : 'regressed';
317
+ if (LOWER_IS_BETTER.has(metric))
318
+ return delta < 0 ? 'improved' : 'regressed';
319
+ return 'unchanged';
320
+ }
321
+ export async function compareQualityBaseline(inspection, baselineFile) {
322
+ const baseline = readQualityBaseline(baselineFile);
323
+ if (!baseline)
324
+ return null;
325
+ const report = await buildQualityReport({ inspection, config: {} });
326
+ const current = extractBaseline(inspection, report);
327
+ const deltas = [];
328
+ const scalarMetrics = [
329
+ 'qualityScore',
330
+ 'readinessScore',
331
+ 'blockers',
332
+ 'warnings',
333
+ 'driftFindings',
334
+ 'driftErrors',
335
+ 'driftWarnings',
336
+ ];
337
+ for (const metric of scalarMetrics) {
338
+ const b = baseline[metric];
339
+ const c = current[metric];
340
+ const delta = c - b;
341
+ deltas.push({
342
+ metric,
343
+ baseline: b,
344
+ current: c,
345
+ delta,
346
+ direction: classify(metric, delta),
347
+ });
348
+ }
349
+ // Gate-level deltas (passes only).
350
+ const baselineGates = new Map(baseline.gates.map((g) => [g.id, g]));
351
+ for (const g of current.gates) {
352
+ const b = baselineGates.get(g.id);
353
+ if (!b)
354
+ continue;
355
+ if (b.passed === g.passed)
356
+ continue;
357
+ deltas.push({
358
+ metric: `gate:${g.id}`,
359
+ baseline: b.passed ? 1 : 0,
360
+ current: g.passed ? 1 : 0,
361
+ delta: (g.passed ? 1 : 0) - (b.passed ? 1 : 0),
362
+ direction: g.passed ? 'improved' : 'regressed',
363
+ });
364
+ }
365
+ // Category score deltas.
366
+ const baselineCats = new Map((baseline.categoryScores ?? []).map((c) => [c.id, c]));
367
+ for (const c of current.categoryScores ?? []) {
368
+ const b = baselineCats.get(c.id);
369
+ if (!b)
370
+ continue;
371
+ const delta = c.score - b.score;
372
+ if (delta === 0)
373
+ continue;
374
+ deltas.push({
375
+ metric: `category:${c.id}`,
376
+ baseline: b.score,
377
+ current: c.score,
378
+ delta,
379
+ // Category scores are always "higher is better".
380
+ direction: delta > 0 ? 'improved' : 'regressed',
381
+ });
382
+ }
383
+ return {
384
+ schema: 'sharkcraft.quality-baseline-comparison/v1',
385
+ baselineFile,
386
+ baseline,
387
+ current,
388
+ deltas,
389
+ regressions: deltas.filter((d) => d.direction === 'regressed'),
390
+ improvements: deltas.filter((d) => d.direction === 'improved'),
391
+ };
392
+ }
393
+ function esc(s) {
394
+ return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
395
+ }
396
+ export function renderQualityBaselineHtml(baseline, comparison) {
397
+ const parts = [];
398
+ parts.push('<!doctype html><html><head><meta charset="utf-8">');
399
+ parts.push('<title>SharkCraft quality baseline</title>');
400
+ parts.push('<style>body{font:14px/1.4 -apple-system,sans-serif;max-width:980px;margin:24px auto;padding:0 16px;color:#1f2328}');
401
+ parts.push('h1{font-size:20px;border-bottom:1px solid #d0d7de;padding-bottom:8px}h2{font-size:16px;margin-top:24px}');
402
+ parts.push('table{border-collapse:collapse;width:100%;margin:8px 0}th,td{border:1px solid #d0d7de;padding:6px 10px;text-align:left}th{background:#f6f8fa}');
403
+ parts.push('.tag{display:inline-block;padding:2px 8px;border-radius:9999px;font-size:11px;font-weight:600}');
404
+ parts.push('.tag.improved{background:#dafbe1;color:#1a7f37}.tag.regressed{background:#ffebe9;color:#cf222e}.tag.unchanged{background:#eaeef2;color:#57606a}');
405
+ parts.push('</style></head><body>');
406
+ parts.push('<h1>SharkCraft quality baseline</h1>');
407
+ parts.push(`<p><strong>Captured:</strong> ${esc(baseline.createdAt)}<br>`);
408
+ parts.push(`<strong>Toolkit version:</strong> ${esc(baseline.sharkcraftVersion)} ·`);
409
+ parts.push(`<strong>Config hash:</strong> <code>${esc(baseline.configHash ?? '(none)')}</code></p>`);
410
+ parts.push('<h2>Headline metrics</h2><table><thead><tr><th>Metric</th><th>Value</th></tr></thead><tbody>');
411
+ parts.push(`<tr><td>Quality score</td><td>${baseline.qualityScore}</td></tr>`);
412
+ parts.push(`<tr><td>Readiness score</td><td>${baseline.readinessScore}</td></tr>`);
413
+ parts.push(`<tr><td>Blockers</td><td>${baseline.blockers}</td></tr>`);
414
+ parts.push(`<tr><td>Warnings</td><td>${baseline.warnings}</td></tr>`);
415
+ parts.push(`<tr><td>Drift findings</td><td>${baseline.driftFindings}</td></tr>`);
416
+ parts.push(`<tr><td>Pack signatures</td><td>${baseline.packSignatures.verified}/${baseline.packSignatures.total} verified</td></tr>`);
417
+ parts.push('</tbody></table>');
418
+ parts.push('<h2>Category scores</h2><table><thead><tr><th>Category</th><th>Score</th></tr></thead><tbody>');
419
+ for (const c of baseline.categoryScores) {
420
+ parts.push(`<tr><td>${esc(c.id)}</td><td>${c.score}</td></tr>`);
421
+ }
422
+ parts.push('</tbody></table>');
423
+ if (comparison) {
424
+ parts.push('<h2>Comparison</h2><table><thead><tr><th>Metric</th><th>Baseline</th><th>Current</th><th>Δ</th><th>Direction</th></tr></thead><tbody>');
425
+ for (const d of comparison.deltas) {
426
+ parts.push(`<tr><td>${esc(d.metric)}</td><td>${d.baseline}</td><td>${d.current}</td><td>${d.delta}</td><td><span class="tag ${d.direction}">${d.direction}</span></td></tr>`);
427
+ }
428
+ parts.push('</tbody></table>');
429
+ }
430
+ parts.push('<p><em>Generated by SharkCraft quality baseline v2.</em></p>');
431
+ parts.push('</body></html>');
432
+ return parts.join('\n') + '\n';
433
+ }
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Self-contained HTML rendering for the quality report. No external assets,
3
+ * no JS, dark-mode aware.
4
+ */
5
+ import type { IQualityReport } from './quality-report.js';
6
+ export declare function renderQualityHtml(report: IQualityReport): string;
7
+ //# sourceMappingURL=quality-html.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quality-html.d.ts","sourceRoot":"","sources":["../src/quality-html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA2B1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAwChE"}
@@ -0,0 +1,64 @@
1
+ const CSS = `
2
+ *{box-sizing:border-box}body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;margin:0;background:#0f1419;color:#e6e1cf;padding:2rem;line-height:1.55}
3
+ h1,h2,h3{margin-top:1.4rem;color:#bae67e}
4
+ table{border-collapse:collapse;width:100%;margin:.8rem 0}
5
+ th,td{text-align:left;padding:.4rem .6rem;border-bottom:1px solid #2a3138}
6
+ th{background:#1c2329;color:#9aa5b0}
7
+ .badge{display:inline-block;padding:.1rem .5rem;border-radius:.25rem;font-size:.75rem;font-weight:600;text-transform:uppercase}
8
+ .b-pass{background:#28432e;color:#bae67e}.b-warn{background:#3a3a2e;color:#ffd580}.b-fail{background:#5a1f1f;color:#ff9f9f}
9
+ .b-skip{background:#2e3a4a;color:#7fd0ff}
10
+ pre{background:#1c2329;padding:.8rem;border-radius:.4rem;overflow-x:auto}
11
+ code{background:#1c2329;padding:.05rem .3rem;border-radius:.2rem}
12
+ .score{font-size:2.2rem;font-weight:700}
13
+ @media (prefers-color-scheme: light){body{background:#fafaf7;color:#1f2329}h1,h2,h3{color:#266a2e}th{background:#eee;color:#222}pre,code{background:#eee}}
14
+ `;
15
+ function escapeHtml(s) {
16
+ return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
17
+ }
18
+ function badgeFor(overall) {
19
+ if (overall === 'pass')
20
+ return `<span class="badge b-pass">${overall}</span>`;
21
+ if (overall === 'warn')
22
+ return `<span class="badge b-warn">${overall}</span>`;
23
+ return `<span class="badge b-fail">${overall}</span>`;
24
+ }
25
+ export function renderQualityHtml(report) {
26
+ const out = [];
27
+ out.push('<!doctype html>');
28
+ out.push('<html lang="en"><head><meta charset="utf-8"><title>SharkCraft quality report</title>');
29
+ out.push(`<style>${CSS}</style></head><body>`);
30
+ out.push('<h1>SharkCraft quality report</h1>');
31
+ out.push('<p>');
32
+ out.push(`<span class="score">${report.score}</span>&nbsp;${badgeFor(report.overall)}`);
33
+ out.push(`&nbsp;blockers <strong>${report.blockers}</strong> · warnings <strong>${report.warnings}</strong>`);
34
+ out.push('</p>');
35
+ out.push('<h2>Gates</h2>');
36
+ out.push('<table><thead><tr><th>Gate</th><th>Verdict</th><th>Blocking</th><th>Executed</th><th>Notes</th></tr></thead><tbody>');
37
+ for (const g of report.gates) {
38
+ const tag = g.passed ? 'b-pass' : g.blocking ? 'b-fail' : 'b-warn';
39
+ const verdict = g.passed ? 'pass' : g.blocking ? 'fail' : 'warn';
40
+ out.push(`<tr><td><code>${escapeHtml(g.id)}</code> — ${escapeHtml(g.label)}</td>` +
41
+ `<td><span class="badge ${tag}">${verdict}</span></td>` +
42
+ `<td>${g.blocking ? 'yes' : 'no'}</td>` +
43
+ `<td>${g.executed ? 'yes' : `<span class="badge b-skip">skipped</span>`}</td>` +
44
+ `<td>${g.notes.map(escapeHtml).join('<br>')}</td></tr>`);
45
+ }
46
+ out.push('</tbody></table>');
47
+ if (report.drift) {
48
+ out.push('<h2>Drift</h2>');
49
+ const counts = report.drift.counts ?? {};
50
+ out.push('<table><tbody>');
51
+ for (const [k, v] of Object.entries(counts)) {
52
+ out.push(`<tr><th>${escapeHtml(k)}</th><td>${v}</td></tr>`);
53
+ }
54
+ out.push('</tbody></table>');
55
+ }
56
+ if (report.nextRecommendations.length > 0) {
57
+ out.push('<h2>Next recommendations</h2><ul>');
58
+ for (const r of report.nextRecommendations)
59
+ out.push(`<li>${escapeHtml(r)}</li>`);
60
+ out.push('</ul>');
61
+ }
62
+ out.push('</body></html>');
63
+ return out.join('\n') + '\n';
64
+ }
@@ -0,0 +1,49 @@
1
+ import { type IDriftReport } from './drift.js';
2
+ import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
3
+ export interface IQualityGateResult {
4
+ id: string;
5
+ label: string;
6
+ passed: boolean;
7
+ blocking: boolean;
8
+ /** When true, the gate would normally run a shell command. MCP skips these. */
9
+ runsShell: boolean;
10
+ /** Whether the gate was actually executed in this run (false ⇒ skipped). */
11
+ executed: boolean;
12
+ notes: readonly string[];
13
+ data?: Record<string, unknown>;
14
+ }
15
+ export interface IQualityReport {
16
+ overall: 'pass' | 'fail' | 'warn';
17
+ blockers: number;
18
+ warnings: number;
19
+ score: number;
20
+ gates: readonly IQualityGateResult[];
21
+ nextRecommendations: readonly string[];
22
+ /** Drift report attached when the drift gate ran. */
23
+ drift?: IDriftReport;
24
+ }
25
+ export interface IQualityConfig {
26
+ minReadiness?: number;
27
+ requireBoundaryClean?: boolean;
28
+ requireDriftClean?: boolean;
29
+ requireAgentTests?: boolean;
30
+ requireContextTests?: boolean;
31
+ requirePackSignatures?: boolean;
32
+ }
33
+ export interface IBuildQualityReportInput {
34
+ inspection: ISharkcraftInspection;
35
+ config: IQualityConfig;
36
+ strict?: boolean;
37
+ /**
38
+ * When true, skip gates whose `runsShell` would be true and record them as
39
+ * `executed: false` with a note pointing to the CLI command. Used by the MCP
40
+ * read-only path so the server never executes shell commands.
41
+ */
42
+ skipShell?: boolean;
43
+ }
44
+ /**
45
+ * Build a quality report from an inspection. Pure orchestration over the
46
+ * existing inspector helpers — no IO outside what those helpers already do.
47
+ */
48
+ export declare function buildQualityReport(input: IBuildQualityReportInput): Promise<IQualityReport>;
49
+ //# sourceMappingURL=quality-report.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quality-report.d.ts","sourceRoot":"","sources":["../src/quality-report.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAUjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,qDAAqD;IACrD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,qBAAqB,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,cAAc,CAAC,CA0OzB"}