@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,412 @@
1
+ /**
2
+ * Agent contract gates.
3
+ *
4
+ * The base agent contract is advisory. This module adds an opt-in
5
+ * gate system that turns a contract into pass/fail signals — and,
6
+ * optionally, a hard gate for `shrk apply --contract`.
7
+ *
8
+ * Read-only. No source writes from this module. Approval writing is a
9
+ * CLI-only explicit action handled by the command layer.
10
+ */
11
+ import { createHash, createHmac } from 'node:crypto';
12
+ import { existsSync, readFileSync } from 'node:fs';
13
+ import { TaskRiskLevel } from "./task-risk.js";
14
+ import { simulatePlan } from "./plan-simulation.js";
15
+ import { matchContractFileRule, rulesFromLegacyStrings, } from "./contract-file-rule.js";
16
+ export const AGENT_CONTRACT_APPROVAL_SCHEMA = 'sharkcraft.agent-contract-approval/v1';
17
+ export const AGENT_CONTRACT_GATE_SCHEMA = 'sharkcraft.agent-contract-gate/v1';
18
+ export var ContractGateStatus;
19
+ (function (ContractGateStatus) {
20
+ ContractGateStatus["Pass"] = "pass";
21
+ ContractGateStatus["RequiresApproval"] = "requires-approval";
22
+ ContractGateStatus["Fail"] = "fail";
23
+ ContractGateStatus["Warn"] = "warn";
24
+ })(ContractGateStatus || (ContractGateStatus = {}));
25
+ export var ContractApprovalExpiryStatus;
26
+ (function (ContractApprovalExpiryStatus) {
27
+ ContractApprovalExpiryStatus["Valid"] = "valid";
28
+ ContractApprovalExpiryStatus["ExpiresSoon"] = "expires-soon";
29
+ ContractApprovalExpiryStatus["Expired"] = "expired";
30
+ ContractApprovalExpiryStatus["NoExpiry"] = "no-expiry";
31
+ ContractApprovalExpiryStatus["Absent"] = "absent";
32
+ })(ContractApprovalExpiryStatus || (ContractApprovalExpiryStatus = {}));
33
+ const APPROVAL_SECRET_ENV_DEFAULT = 'SHARKCRAFT_CONTRACT_SECRET';
34
+ function canonicalContractJson(contract) {
35
+ // Deterministic JSON for hashing — exclude `generatedAt` so hashes stay
36
+ // stable across re-builds of the same task.
37
+ const { generatedAt: _drop, ...rest } = contract;
38
+ void _drop;
39
+ return JSON.stringify(rest, Object.keys(rest).sort());
40
+ }
41
+ export function computeContractHash(contract) {
42
+ const h = createHash('sha256');
43
+ h.update(canonicalContractJson(contract));
44
+ return h.digest('hex');
45
+ }
46
+ function canonicalApprovalJson(a) {
47
+ const { signature: _drop, ...rest } = a;
48
+ void _drop;
49
+ return JSON.stringify(rest, Object.keys(rest).sort());
50
+ }
51
+ export function signApproval(a, secret) {
52
+ const hmac = createHmac('sha256', secret);
53
+ hmac.update(canonicalApprovalJson(a));
54
+ return {
55
+ ...a,
56
+ signature: { algo: 'sha256', hmac: hmac.digest('hex'), signedAt: new Date().toISOString() },
57
+ };
58
+ }
59
+ export function verifyApproval(a, secret) {
60
+ if (!a.signature)
61
+ return { ok: false, message: 'No signature.' };
62
+ const hmac = createHmac('sha256', secret);
63
+ hmac.update(canonicalApprovalJson(a));
64
+ const expected = hmac.digest('hex');
65
+ if (expected !== a.signature.hmac)
66
+ return { ok: false, message: 'Signature mismatch.' };
67
+ return { ok: true, message: 'verified' };
68
+ }
69
+ export function buildApproval(input) {
70
+ const approval = {
71
+ schema: AGENT_CONTRACT_APPROVAL_SCHEMA,
72
+ contractHash: input.contractHash,
73
+ approvedBy: input.approvedBy,
74
+ reason: input.reason,
75
+ approvedAt: new Date().toISOString(),
76
+ approvedGates: input.approvedGates ? [...input.approvedGates] : [],
77
+ };
78
+ if (input.contractId !== undefined)
79
+ approval.contractId = input.contractId;
80
+ if (input.expiresAt !== undefined)
81
+ approval.expiresAt = input.expiresAt;
82
+ const secret = process.env[input.secretEnv ?? APPROVAL_SECRET_ENV_DEFAULT];
83
+ if (secret)
84
+ return signApproval(approval, secret);
85
+ return approval;
86
+ }
87
+ function readJson(file) {
88
+ return JSON.parse(readFileSync(file, 'utf8'));
89
+ }
90
+ function isExpired(a) {
91
+ if (!a.expiresAt)
92
+ return false;
93
+ const t = Date.parse(a.expiresAt);
94
+ if (Number.isNaN(t))
95
+ return false;
96
+ return t < Date.now();
97
+ }
98
+ const EXPIRES_SOON_WINDOW_MS = 4 * 60 * 60 * 1000; // 4 hours
99
+ /**
100
+ * Parse a relative expiry string like `1h`, `2d`, `30m`, `45s`, `1w` and return
101
+ * an absolute ISO timestamp from `from` (default now). Returns null when the
102
+ * input cannot be parsed.
103
+ */
104
+ export function parseRelativeExpiry(input, from = new Date()) {
105
+ const m = /^([0-9]+)\s*(s|m|h|d|w)$/i.exec(input.trim());
106
+ if (!m)
107
+ return null;
108
+ const n = Number.parseInt(m[1], 10);
109
+ const unit = m[2].toLowerCase();
110
+ const ms = unit === 's' ? n * 1000 :
111
+ unit === 'm' ? n * 60 * 1000 :
112
+ unit === 'h' ? n * 60 * 60 * 1000 :
113
+ unit === 'd' ? n * 24 * 60 * 60 * 1000 :
114
+ unit === 'w' ? n * 7 * 24 * 60 * 60 * 1000 : 0;
115
+ if (ms <= 0)
116
+ return null;
117
+ return new Date(from.getTime() + ms).toISOString();
118
+ }
119
+ function classifyExpiry(contract, approval) {
120
+ if (!approval)
121
+ return { status: ContractApprovalExpiryStatus.Absent };
122
+ if (!approval.expiresAt) {
123
+ const risk = contract.taskRisk.riskLevel;
124
+ const out = { status: ContractApprovalExpiryStatus.NoExpiry };
125
+ if (risk === TaskRiskLevel.High || risk === TaskRiskLevel.Critical) {
126
+ out.noExpiryWarning =
127
+ `Approval has no --expires-in / --expires-at and task risk is ${risk}; long-lived approvals should be avoided.`;
128
+ }
129
+ return out;
130
+ }
131
+ const t = Date.parse(approval.expiresAt);
132
+ if (Number.isNaN(t)) {
133
+ return { status: ContractApprovalExpiryStatus.NoExpiry, expiresAt: approval.expiresAt };
134
+ }
135
+ const remaining = t - Date.now();
136
+ if (remaining < 0) {
137
+ return {
138
+ status: ContractApprovalExpiryStatus.Expired,
139
+ expiresInMs: remaining,
140
+ expiresAt: approval.expiresAt,
141
+ expiredAt: approval.expiresAt,
142
+ };
143
+ }
144
+ if (remaining < EXPIRES_SOON_WINDOW_MS) {
145
+ return {
146
+ status: ContractApprovalExpiryStatus.ExpiresSoon,
147
+ expiresInMs: remaining,
148
+ expiresAt: approval.expiresAt,
149
+ };
150
+ }
151
+ return {
152
+ status: ContractApprovalExpiryStatus.Valid,
153
+ expiresInMs: remaining,
154
+ expiresAt: approval.expiresAt,
155
+ };
156
+ }
157
+ function classifyApproval(contract, a, secret) {
158
+ if (!a)
159
+ return { status: 'absent' };
160
+ const hash = computeContractHash(contract);
161
+ if (a.contractHash !== hash) {
162
+ return {
163
+ status: 'mismatched',
164
+ message: `Approval is for a different contract (expected hash ${hash.slice(0, 12)}…, got ${a.contractHash.slice(0, 12)}…).`,
165
+ };
166
+ }
167
+ if (isExpired(a))
168
+ return { status: 'expired', message: `Approval expired at ${a.expiresAt}.` };
169
+ if (a.signature) {
170
+ if (!secret)
171
+ return { status: 'present', message: 'Signature present but no secret configured to verify.' };
172
+ const v = verifyApproval(a, secret);
173
+ return v.ok
174
+ ? { status: 'verified', message: v.message }
175
+ : { status: 'invalid', message: v.message };
176
+ }
177
+ return { status: 'unsigned' };
178
+ }
179
+ function gate(id, description, status, detail) {
180
+ return detail === undefined ? { id, description, status } : { id, description, status, detail };
181
+ }
182
+ export async function checkAgentContract(inspection, contract, options = {}) {
183
+ const notes = [];
184
+ let planSimulation;
185
+ // Resolve approval if provided.
186
+ let approval;
187
+ if (options.approvalPath) {
188
+ if (!existsSync(options.approvalPath)) {
189
+ notes.push(`Approval file not found: ${options.approvalPath}`);
190
+ }
191
+ else {
192
+ try {
193
+ approval = readJson(options.approvalPath);
194
+ }
195
+ catch (e) {
196
+ notes.push(`Failed to parse approval: ${e.message}`);
197
+ }
198
+ }
199
+ }
200
+ const secret = process.env[options.secretEnv ?? APPROVAL_SECRET_ENV_DEFAULT];
201
+ const approvalClassification = classifyApproval(contract, approval, secret);
202
+ const approvalAccepted = approval !== undefined &&
203
+ (approvalClassification.status === 'unsigned' ||
204
+ approvalClassification.status === 'verified' ||
205
+ approvalClassification.status === 'present');
206
+ // Run plan simulation if a plan path was supplied.
207
+ if (options.planPath) {
208
+ try {
209
+ planSimulation = await simulatePlan(inspection, options.planPath, {
210
+ includeBoundaries: true,
211
+ includeImpact: true,
212
+ includeOwnership: true,
213
+ });
214
+ }
215
+ catch (e) {
216
+ notes.push(`Plan simulation failed: ${e.message}`);
217
+ }
218
+ }
219
+ else if (contract.requiredPlanReviews.length > 0) {
220
+ notes.push('Contract requires plan review(s) but no --plan was supplied; gate `required-plan-review` cannot validate.');
221
+ }
222
+ const gates = [];
223
+ // Gate 1: human approval gates listed in the contract.
224
+ if (contract.humanApprovalGates.length === 0) {
225
+ gates.push(gate('human-approval', 'Human approval gate(s).', ContractGateStatus.Pass, 'No human approval required by this contract.'));
226
+ }
227
+ else if (approvalAccepted) {
228
+ gates.push(gate('human-approval', 'Human approval gate(s).', ContractGateStatus.Pass, `Approved by ${approval.approvedBy}.`));
229
+ }
230
+ else {
231
+ gates.push(gate('human-approval', 'Human approval gate(s).', ContractGateStatus.RequiresApproval, contract.humanApprovalGates.join(' / ')));
232
+ }
233
+ // Gate 2: required plan reviews — must have plan supplied + simulation ready.
234
+ if (contract.requiredPlanReviews.length > 0) {
235
+ if (!planSimulation) {
236
+ gates.push(gate('required-plan-review', 'Required plan review.', ContractGateStatus.Fail, 'No --plan supplied or plan simulation failed.'));
237
+ }
238
+ else if (planSimulation.applyReadiness === 'blocked-conflicts' ||
239
+ planSimulation.applyReadiness === 'blocked-boundary' ||
240
+ planSimulation.applyReadiness === 'blocked-policy' ||
241
+ planSimulation.applyReadiness === 'blocked-signature' ||
242
+ planSimulation.applyReadiness === 'blocked-missing-review') {
243
+ gates.push(gate('required-plan-review', 'Required plan review.', ContractGateStatus.Fail, `Plan simulation: ${planSimulation.applyReadiness}.`));
244
+ }
245
+ else {
246
+ gates.push(gate('required-plan-review', 'Required plan review.', planSimulation.applyReadiness === 'ready-with-review'
247
+ ? ContractGateStatus.Warn
248
+ : ContractGateStatus.Pass, `Plan simulation: ${planSimulation.applyReadiness}.`));
249
+ }
250
+ }
251
+ else {
252
+ gates.push(gate('required-plan-review', 'Required plan review.', ContractGateStatus.Pass, 'Not required.'));
253
+ }
254
+ // Gate 3: forbidden files not touched.
255
+ // Prefer detailed rules. Fall back to legacy string[] (contains-match).
256
+ const detailedRules = contract.forbiddenFilesDetailed && contract.forbiddenFilesDetailed.length > 0
257
+ ? contract.forbiddenFilesDetailed
258
+ : rulesFromLegacyStrings(contract.forbiddenFiles.map((s) => s.split(' ')[0].replace(/\*\*$/, '').replace(/\*$/, '')).filter((s) => s.length > 0));
259
+ if (detailedRules.length > 0 && planSimulation) {
260
+ const matches = [];
261
+ for (const f of planSimulation.files) {
262
+ for (const r of detailedRules) {
263
+ if (matchContractFileRule(r, f.relativePath))
264
+ matches.push({ file: f.relativePath, rule: r });
265
+ }
266
+ }
267
+ if (matches.length > 0) {
268
+ const summary = matches
269
+ .slice(0, 8)
270
+ .map((m) => `${m.file} (rule: ${m.rule.kind}=${m.rule.pattern})`)
271
+ .join(', ');
272
+ gates.push(gate('forbidden-files', 'Forbidden files not touched.', ContractGateStatus.Fail, `Plan touches: ${summary}${matches.length > 8 ? ` (+${matches.length - 8} more)` : ''}.`));
273
+ }
274
+ else {
275
+ gates.push(gate('forbidden-files', 'Forbidden files not touched.', ContractGateStatus.Pass));
276
+ }
277
+ }
278
+ else if (detailedRules.length > 0) {
279
+ gates.push(gate('forbidden-files', 'Forbidden files not touched.', ContractGateStatus.Warn, 'No --plan supplied; cannot verify forbidden-file gate.'));
280
+ }
281
+ else {
282
+ gates.push(gate('forbidden-files', 'Forbidden files not touched.', ContractGateStatus.Pass, 'None forbidden.'));
283
+ }
284
+ // Gate 4: required validations are listed (informational — runtime is the human's job).
285
+ gates.push(gate('required-validations', 'Required validations listed.', contract.requiredValidations.length > 0 ? ContractGateStatus.Pass : ContractGateStatus.Warn, contract.requiredValidations.length > 0
286
+ ? `${contract.requiredValidations.length} validation(s) listed.`
287
+ : 'No validations listed.'));
288
+ // Gate 5: public-API review required.
289
+ const publicApi = contract.publicApiRisks.length > 0 || (planSimulation?.publicApiTouched ?? false);
290
+ if (publicApi) {
291
+ const reviewsHasApi = contract.requiredReviews.some((r) => r.toLowerCase().includes('api'));
292
+ if (reviewsHasApi) {
293
+ gates.push(gate('public-api-review', 'Public-API review required when API touched.', ContractGateStatus.Pass));
294
+ }
295
+ else if (approvalAccepted) {
296
+ gates.push(gate('public-api-review', 'Public-API review required.', ContractGateStatus.Pass, `Approved by ${approval.approvedBy}.`));
297
+ }
298
+ else {
299
+ gates.push(gate('public-api-review', 'Public-API review required.', ContractGateStatus.RequiresApproval, 'Contract does not list an explicit API review.'));
300
+ }
301
+ }
302
+ else {
303
+ gates.push(gate('public-api-review', 'Public-API review required when API touched.', ContractGateStatus.Pass, 'No public API touched.'));
304
+ }
305
+ // Gate 6: risk requires approval.
306
+ const highRisk = contract.taskRisk.riskLevel === TaskRiskLevel.High || contract.taskRisk.riskLevel === TaskRiskLevel.Critical;
307
+ if (highRisk || contract.taskRisk.humanApprovalRequired) {
308
+ if (approvalAccepted) {
309
+ gates.push(gate('risk-approval', 'High-risk approval.', ContractGateStatus.Pass, `Approved by ${approval.approvedBy}.`));
310
+ }
311
+ else {
312
+ gates.push(gate('risk-approval', 'High-risk approval.', ContractGateStatus.RequiresApproval, `Risk: ${contract.taskRisk.riskLevel} (score ${contract.taskRisk.score}).`));
313
+ }
314
+ }
315
+ else {
316
+ gates.push(gate('risk-approval', 'High-risk approval.', ContractGateStatus.Pass, 'Not high-risk.'));
317
+ }
318
+ // Gate 7: memory adjustment elevates required approval if non-trivial.
319
+ if (contract.taskRisk.memory && contract.taskRisk.memory.score >= 4) {
320
+ if (approvalAccepted) {
321
+ gates.push(gate('memory-elevated-approval', 'Memory-elevated approval.', ContractGateStatus.Pass, `Approved by ${approval.approvedBy}.`));
322
+ }
323
+ else {
324
+ gates.push(gate('memory-elevated-approval', 'Memory-elevated approval.', ContractGateStatus.RequiresApproval, `Memory adjustment +${contract.taskRisk.memory.score} suggests review.`));
325
+ }
326
+ }
327
+ else if (contract.taskRisk.memory && contract.taskRisk.memory.missing) {
328
+ gates.push(gate('memory-elevated-approval', 'Memory-elevated approval.', ContractGateStatus.Warn, 'Memory index missing.'));
329
+ }
330
+ else {
331
+ gates.push(gate('memory-elevated-approval', 'Memory-elevated approval.', ContractGateStatus.Pass));
332
+ }
333
+ const blockingGates = gates.filter((g) => g.status === ContractGateStatus.Fail || g.status === ContractGateStatus.RequiresApproval).map((g) => g.id);
334
+ const warnGates = gates.filter((g) => g.status === ContractGateStatus.Warn).map((g) => g.id);
335
+ const pass = blockingGates.length === 0;
336
+ // Surface approval expiry detail + warn when a high/critical-risk
337
+ // approval has no expiry.
338
+ const approvalExpiry = classifyExpiry(contract, approval);
339
+ if (approvalExpiry.noExpiryWarning)
340
+ notes.push(approvalExpiry.noExpiryWarning);
341
+ if (approvalExpiry.status === ContractApprovalExpiryStatus.ExpiresSoon) {
342
+ notes.push(`Approval expires in ${Math.round((approvalExpiry.expiresInMs ?? 0) / 60000)} min — re-approve before then.`);
343
+ }
344
+ const result = {
345
+ schema: AGENT_CONTRACT_GATE_SCHEMA,
346
+ generatedAt: new Date().toISOString(),
347
+ contractHash: computeContractHash(contract),
348
+ task: contract.task,
349
+ role: contract.role,
350
+ mode: contract.mode,
351
+ gates,
352
+ approvalStatus: approvalClassification.status,
353
+ approvalExpiry,
354
+ pass,
355
+ blockingGates,
356
+ warnGates,
357
+ notes,
358
+ };
359
+ if (approval)
360
+ result.approval = approval;
361
+ if (approvalClassification.message)
362
+ result.approvalMessage = approvalClassification.message;
363
+ if (planSimulation)
364
+ result.planSimulation = planSimulation;
365
+ return result;
366
+ }
367
+ export function renderContractCheckText(r) {
368
+ let out = `=== Contract check ===\n`;
369
+ out += ` task ${r.task || '(empty)'}\n`;
370
+ out += ` role/mode ${r.role} / ${r.mode}\n`;
371
+ out += ` contract hash ${r.contractHash.slice(0, 12)}…\n`;
372
+ out += ` approval ${r.approvalStatus}${r.approvalMessage ? ' — ' + r.approvalMessage : ''}\n`;
373
+ out += ` overall ${r.pass ? 'PASS' : 'BLOCK'}\n\n`;
374
+ out += `Gates:\n`;
375
+ for (const g of r.gates) {
376
+ out += ` [${g.status.toUpperCase().padEnd(18)}] ${g.id.padEnd(28)} ${g.description}${g.detail ? ' — ' + g.detail : ''}\n`;
377
+ }
378
+ if (r.blockingGates.length > 0) {
379
+ out += `\nBlocking: ${r.blockingGates.join(', ')}\n`;
380
+ }
381
+ if (r.warnGates.length > 0)
382
+ out += `Warnings: ${r.warnGates.join(', ')}\n`;
383
+ if (r.notes.length > 0) {
384
+ out += `\nNotes:\n`;
385
+ for (const n of r.notes)
386
+ out += ` • ${n}\n`;
387
+ }
388
+ return out;
389
+ }
390
+ export function renderContractCheckMarkdown(r) {
391
+ let out = `# Contract check\n\n`;
392
+ out += `- **task**: ${r.task || '(empty)'}\n`;
393
+ out += `- **role / mode**: ${r.role} / ${r.mode}\n`;
394
+ out += `- **contract hash**: \`${r.contractHash.slice(0, 16)}…\`\n`;
395
+ out += `- **approval**: ${r.approvalStatus}${r.approvalMessage ? ' — ' + r.approvalMessage : ''}\n`;
396
+ out += `- **overall**: ${r.pass ? '✅ PASS' : '❌ BLOCK'}\n\n`;
397
+ out += `## Gates\n\n`;
398
+ out += `| Status | Gate | Description | Detail |\n| --- | --- | --- | --- |\n`;
399
+ for (const g of r.gates) {
400
+ out += `| ${g.status} | \`${g.id}\` | ${g.description} | ${g.detail ?? ''} |\n`;
401
+ }
402
+ if (r.blockingGates.length > 0)
403
+ out += `\n**Blocking**: ${r.blockingGates.join(', ')}\n`;
404
+ if (r.warnGates.length > 0)
405
+ out += `**Warnings**: ${r.warnGates.join(', ')}\n`;
406
+ if (r.notes.length > 0) {
407
+ out += `\n## Notes\n`;
408
+ for (const n of r.notes)
409
+ out += `- ${n}\n`;
410
+ }
411
+ return out;
412
+ }
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Reusable agent-contract templates.
3
+ *
4
+ * `buildAgentContract` derives a contract from inspection + intent. Templates
5
+ * are reusable starting points that capture *intent classes* — "release task",
6
+ * "public-API change", "polyglot service change", etc. They are deterministic
7
+ * dictionaries; rendering merges them with the live contract output.
8
+ */
9
+ import { type IContractFileRule } from './contract-file-rule.js';
10
+ import { RoleId } from './role-views.js';
11
+ import { AgentContractMode } from './agent-contract.js';
12
+ export declare const AGENT_CONTRACT_TEMPLATE_SCHEMA = "sharkcraft.agent-contract-template/v1";
13
+ export declare enum AgentContractTemplateMatch {
14
+ Exact = "exact",
15
+ Partial = "partial",
16
+ None = "none"
17
+ }
18
+ export interface IAgentContractTemplateAppliesWhen {
19
+ /** Lowercase substrings that should appear in the task. Any-of. */
20
+ taskKeywords?: readonly string[];
21
+ /** Intent kinds that should match (e.g. `release`, `migration`). */
22
+ intentKinds?: readonly string[];
23
+ /** Roles this template is intended for. */
24
+ roles?: readonly RoleId[];
25
+ }
26
+ export interface IAgentContractTemplate {
27
+ schema: typeof AGENT_CONTRACT_TEMPLATE_SCHEMA;
28
+ id: string;
29
+ title: string;
30
+ description: string;
31
+ role: RoleId;
32
+ mode: AgentContractMode;
33
+ defaultForbiddenFilesDetailed: readonly IContractFileRule[];
34
+ defaultRequiredValidations: readonly string[];
35
+ defaultHumanApprovalGates: readonly string[];
36
+ defaultDefinitionOfDone: readonly string[];
37
+ defaultRollbackPlan: readonly string[];
38
+ appliesWhen: IAgentContractTemplateAppliesWhen;
39
+ }
40
+ export declare const AI_AGENT_SAFE_CHANGE_TEMPLATE: IAgentContractTemplate;
41
+ export declare const PUBLIC_API_CHANGE_TEMPLATE: IAgentContractTemplate;
42
+ export declare const RELEASE_TASK_TEMPLATE: IAgentContractTemplate;
43
+ export declare const MIGRATION_TASK_TEMPLATE: IAgentContractTemplate;
44
+ export declare const SECURITY_SENSITIVE_CHANGE_TEMPLATE: IAgentContractTemplate;
45
+ export declare const POLYGLOT_SERVICE_CHANGE_TEMPLATE: IAgentContractTemplate;
46
+ /**
47
+ * Project-specific contract templates
48
+ * now live in packs and are merged via `loadAllContractTemplates`. The
49
+ * engine ships only generic templates here.
50
+ */
51
+ export declare const ALL_CONTRACT_TEMPLATES: readonly IAgentContractTemplate[];
52
+ export declare function listContractTemplates(): readonly IAgentContractTemplate[];
53
+ export declare function getContractTemplate(id: string): IAgentContractTemplate | null;
54
+ export interface IContractTemplateMatchResult {
55
+ template: IAgentContractTemplate;
56
+ match: AgentContractTemplateMatch;
57
+ reason: string;
58
+ }
59
+ /** Score each template against a task + optional role. Highest score wins. */
60
+ export declare function recommendContractTemplate(task: string, role?: RoleId, intentKind?: string): readonly IContractTemplateMatchResult[];
61
+ export declare function renderContractTemplateMarkdown(t: IAgentContractTemplate, task?: string): string;
62
+ export declare function renderContractTemplateText(t: IAgentContractTemplate, task?: string): string;
63
+ //# sourceMappingURL=agent-contract-templates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-contract-templates.d.ts","sourceRoot":"","sources":["../src/agent-contract-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,8BAA8B,0CAA0C,CAAC;AAEtF,oBAAY,0BAA0B;IACpC,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,iCAAiC;IAChD,mEAAmE;IACnE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,oEAAoE;IACpE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,8BAA8B,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,6BAA6B,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5D,0BAA0B,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,WAAW,EAAE,iCAAiC,CAAC;CAChD;AAcD,eAAO,MAAM,6BAA6B,EAAE,sBA0B1C,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,sBA2BvC,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,sBAkClC,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,sBA2BpC,CAAC;AAEH,eAAO,MAAM,kCAAkC,EAAE,sBAmC/C,CAAC;AAEH,eAAO,MAAM,gCAAgC,EAAE,sBAkC7C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,sBAAsB,EAOnE,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,SAAS,sBAAsB,EAAE,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAE7E;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,KAAK,EAAE,0BAA0B,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,SAAS,4BAA4B,EAAE,CA4BzC;AAED,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC/F;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC3F"}