@shrkcrft/inspector 0.1.0-alpha.2

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 (705) 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 +43 -0
  70. package/dist/area-map.d.ts.map +1 -0
  71. package/dist/area-map.js +197 -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 +201 -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 +26 -0
  256. package/dist/git-helpers.d.ts.map +1 -0
  257. package/dist/git-helpers.js +110 -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 +413 -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 +223 -0
  295. package/dist/index.d.ts.map +1 -0
  296. package/dist/index.js +233 -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.d.ts +28 -0
  391. package/dist/onboarding-drafts.d.ts.map +1 -0
  392. package/dist/onboarding-drafts.js +234 -0
  393. package/dist/onboarding-report.d.ts +8 -0
  394. package/dist/onboarding-report.d.ts.map +1 -0
  395. package/dist/onboarding-report.js +239 -0
  396. package/dist/onboarding.d.ts +134 -0
  397. package/dist/onboarding.d.ts.map +1 -0
  398. package/dist/onboarding.js +729 -0
  399. package/dist/ownership.d.ts +38 -0
  400. package/dist/ownership.d.ts.map +1 -0
  401. package/dist/ownership.js +102 -0
  402. package/dist/pack-author-ux.d.ts +58 -0
  403. package/dist/pack-author-ux.d.ts.map +1 -0
  404. package/dist/pack-author-ux.js +219 -0
  405. package/dist/pack-author.d.ts +94 -0
  406. package/dist/pack-author.d.ts.map +1 -0
  407. package/dist/pack-author.js +208 -0
  408. package/dist/pack-compatibility.d.ts +21 -0
  409. package/dist/pack-compatibility.d.ts.map +1 -0
  410. package/dist/pack-compatibility.js +114 -0
  411. package/dist/pack-contributions-inventory.d.ts +121 -0
  412. package/dist/pack-contributions-inventory.d.ts.map +1 -0
  413. package/dist/pack-contributions-inventory.js +732 -0
  414. package/dist/pack-docs.d.ts +11 -0
  415. package/dist/pack-docs.d.ts.map +1 -0
  416. package/dist/pack-docs.js +101 -0
  417. package/dist/pack-doctor.d.ts +50 -0
  418. package/dist/pack-doctor.d.ts.map +1 -0
  419. package/dist/pack-doctor.js +302 -0
  420. package/dist/pack-helper-registry.d.ts +29 -0
  421. package/dist/pack-helper-registry.d.ts.map +1 -0
  422. package/dist/pack-helper-registry.js +144 -0
  423. package/dist/pack-pending.d.ts +68 -0
  424. package/dist/pack-pending.d.ts.map +1 -0
  425. package/dist/pack-pending.js +189 -0
  426. package/dist/pack-quality-score.d.ts +44 -0
  427. package/dist/pack-quality-score.d.ts.map +1 -0
  428. package/dist/pack-quality-score.js +155 -0
  429. package/dist/pack-release-check.d.ts +24 -0
  430. package/dist/pack-release-check.d.ts.map +1 -0
  431. package/dist/pack-release-check.js +258 -0
  432. package/dist/pack-signature-status.d.ts +72 -0
  433. package/dist/pack-signature-status.d.ts.map +1 -0
  434. package/dist/pack-signature-status.js +222 -0
  435. package/dist/pack-symbol-compat.d.ts +60 -0
  436. package/dist/pack-symbol-compat.d.ts.map +1 -0
  437. package/dist/pack-symbol-compat.js +371 -0
  438. package/dist/pack-test-runner.d.ts +59 -0
  439. package/dist/pack-test-runner.d.ts.map +1 -0
  440. package/dist/pack-test-runner.js +211 -0
  441. package/dist/pipeline-command-dictionary.d.ts +2 -0
  442. package/dist/pipeline-command-dictionary.d.ts.map +1 -0
  443. package/dist/pipeline-command-dictionary.js +20 -0
  444. package/dist/pipeline-lint.d.ts +30 -0
  445. package/dist/pipeline-lint.d.ts.map +1 -0
  446. package/dist/pipeline-lint.js +134 -0
  447. package/dist/plan-dependency-graph.d.ts +25 -0
  448. package/dist/plan-dependency-graph.d.ts.map +1 -0
  449. package/dist/plan-dependency-graph.js +195 -0
  450. package/dist/plan-review.d.ts +64 -0
  451. package/dist/plan-review.d.ts.map +1 -0
  452. package/dist/plan-review.js +242 -0
  453. package/dist/plan-simulation.d.ts +108 -0
  454. package/dist/plan-simulation.d.ts.map +1 -0
  455. package/dist/plan-simulation.js +767 -0
  456. package/dist/playbook-registry.d.ts +25 -0
  457. package/dist/playbook-registry.d.ts.map +1 -0
  458. package/dist/playbook-registry.js +148 -0
  459. package/dist/playbook-script.d.ts +60 -0
  460. package/dist/playbook-script.d.ts.map +1 -0
  461. package/dist/playbook-script.js +161 -0
  462. package/dist/plugin-lifecycle-profile-registry.d.ts +52 -0
  463. package/dist/plugin-lifecycle-profile-registry.d.ts.map +1 -0
  464. package/dist/plugin-lifecycle-profile-registry.js +202 -0
  465. package/dist/plugin-lifecycle.d.ts +132 -0
  466. package/dist/plugin-lifecycle.d.ts.map +1 -0
  467. package/dist/plugin-lifecycle.js +477 -0
  468. package/dist/policy-engine.d.ts +101 -0
  469. package/dist/policy-engine.d.ts.map +1 -0
  470. package/dist/policy-engine.js +321 -0
  471. package/dist/policy-override-audit.d.ts +18 -0
  472. package/dist/policy-override-audit.d.ts.map +1 -0
  473. package/dist/policy-override-audit.js +54 -0
  474. package/dist/policy-overrides.d.ts +35 -0
  475. package/dist/policy-overrides.d.ts.map +1 -0
  476. package/dist/policy-overrides.js +84 -0
  477. package/dist/policy-test.d.ts +83 -0
  478. package/dist/policy-test.d.ts.map +1 -0
  479. package/dist/policy-test.js +342 -0
  480. package/dist/pr-summary.d.ts +34 -0
  481. package/dist/pr-summary.d.ts.map +1 -0
  482. package/dist/pr-summary.js +220 -0
  483. package/dist/product-coherence.d.ts +21 -0
  484. package/dist/product-coherence.d.ts.map +1 -0
  485. package/dist/product-coherence.js +158 -0
  486. package/dist/profile-registry.d.ts +42 -0
  487. package/dist/profile-registry.d.ts.map +1 -0
  488. package/dist/profile-registry.js +104 -0
  489. package/dist/project-coupling-audit.d.ts +64 -0
  490. package/dist/project-coupling-audit.d.ts.map +1 -0
  491. package/dist/project-coupling-audit.js +282 -0
  492. package/dist/project-overview.d.ts +14 -0
  493. package/dist/project-overview.d.ts.map +1 -0
  494. package/dist/project-overview.js +27 -0
  495. package/dist/propose-knowledge.d.ts +64 -0
  496. package/dist/propose-knowledge.d.ts.map +1 -0
  497. package/dist/propose-knowledge.js +367 -0
  498. package/dist/quality-baseline.d.ts +123 -0
  499. package/dist/quality-baseline.d.ts.map +1 -0
  500. package/dist/quality-baseline.js +433 -0
  501. package/dist/quality-html.d.ts +7 -0
  502. package/dist/quality-html.d.ts.map +1 -0
  503. package/dist/quality-html.js +64 -0
  504. package/dist/quality-report.d.ts +49 -0
  505. package/dist/quality-report.d.ts.map +1 -0
  506. package/dist/quality-report.js +296 -0
  507. package/dist/query-resolver.d.ts +38 -0
  508. package/dist/query-resolver.d.ts.map +1 -0
  509. package/dist/query-resolver.js +163 -0
  510. package/dist/ranker-explainability.d.ts +91 -0
  511. package/dist/ranker-explainability.d.ts.map +1 -0
  512. package/dist/ranker-explainability.js +550 -0
  513. package/dist/reference-lookup.d.ts +8 -0
  514. package/dist/reference-lookup.d.ts.map +1 -0
  515. package/dist/reference-lookup.js +18 -0
  516. package/dist/registration-hint-registry.d.ts +55 -0
  517. package/dist/registration-hint-registry.d.ts.map +1 -0
  518. package/dist/registration-hint-registry.js +327 -0
  519. package/dist/registry-lifecycle.d.ts +47 -0
  520. package/dist/registry-lifecycle.d.ts.map +1 -0
  521. package/dist/registry-lifecycle.js +214 -0
  522. package/dist/release-readiness.d.ts +64 -0
  523. package/dist/release-readiness.d.ts.map +1 -0
  524. package/dist/release-readiness.js +456 -0
  525. package/dist/release-smoke.d.ts +138 -0
  526. package/dist/release-smoke.d.ts.map +1 -0
  527. package/dist/release-smoke.js +459 -0
  528. package/dist/release-train.d.ts +33 -0
  529. package/dist/release-train.d.ts.map +1 -0
  530. package/dist/release-train.js +104 -0
  531. package/dist/repo-memory.d.ts +95 -0
  532. package/dist/repo-memory.d.ts.map +1 -0
  533. package/dist/repo-memory.js +614 -0
  534. package/dist/report-site.d.ts +92 -0
  535. package/dist/report-site.d.ts.map +1 -0
  536. package/dist/report-site.js +658 -0
  537. package/dist/reposet.d.ts +56 -0
  538. package/dist/reposet.d.ts.map +1 -0
  539. package/dist/reposet.js +160 -0
  540. package/dist/repository-intelligence.d.ts +145 -0
  541. package/dist/repository-intelligence.d.ts.map +1 -0
  542. package/dist/repository-intelligence.js +729 -0
  543. package/dist/repository-knowledge-model.d.ts +218 -0
  544. package/dist/repository-knowledge-model.d.ts.map +1 -0
  545. package/dist/repository-knowledge-model.js +939 -0
  546. package/dist/repository-map.d.ts +72 -0
  547. package/dist/repository-map.d.ts.map +1 -0
  548. package/dist/repository-map.js +332 -0
  549. package/dist/repository-stats.d.ts +66 -0
  550. package/dist/repository-stats.d.ts.map +1 -0
  551. package/dist/repository-stats.js +329 -0
  552. package/dist/review-comment-renderer.d.ts +59 -0
  553. package/dist/review-comment-renderer.d.ts.map +1 -0
  554. package/dist/review-comment-renderer.js +181 -0
  555. package/dist/review-comment-v2.d.ts +9 -0
  556. package/dist/review-comment-v2.d.ts.map +1 -0
  557. package/dist/review-comment-v2.js +178 -0
  558. package/dist/review-html.d.ts +13 -0
  559. package/dist/review-html.d.ts.map +1 -0
  560. package/dist/review-html.js +79 -0
  561. package/dist/review-packet-v2.d.ts +29 -0
  562. package/dist/review-packet-v2.d.ts.map +1 -0
  563. package/dist/review-packet-v2.js +71 -0
  564. package/dist/review-packet-v3.d.ts +22 -0
  565. package/dist/review-packet-v3.d.ts.map +1 -0
  566. package/dist/review-packet-v3.js +181 -0
  567. package/dist/review-packet.d.ts +49 -0
  568. package/dist/review-packet.d.ts.map +1 -0
  569. package/dist/review-packet.js +129 -0
  570. package/dist/risk-signals.d.ts +28 -0
  571. package/dist/risk-signals.d.ts.map +1 -0
  572. package/dist/risk-signals.js +68 -0
  573. package/dist/role-views.d.ts +50 -0
  574. package/dist/role-views.d.ts.map +1 -0
  575. package/dist/role-views.js +334 -0
  576. package/dist/rounds.d.ts +52 -0
  577. package/dist/rounds.d.ts.map +1 -0
  578. package/dist/rounds.js +172 -0
  579. package/dist/rule-drift.d.ts +42 -0
  580. package/dist/rule-drift.d.ts.map +1 -0
  581. package/dist/rule-drift.js +148 -0
  582. package/dist/rule-quality.d.ts +73 -0
  583. package/dist/rule-quality.d.ts.map +1 -0
  584. package/dist/rule-quality.js +356 -0
  585. package/dist/rule-scaffold.d.ts +71 -0
  586. package/dist/rule-scaffold.d.ts.map +1 -0
  587. package/dist/rule-scaffold.js +258 -0
  588. package/dist/safety-audit-deep.d.ts +38 -0
  589. package/dist/safety-audit-deep.d.ts.map +1 -0
  590. package/dist/safety-audit-deep.js +162 -0
  591. package/dist/safety-audit.d.ts +91 -0
  592. package/dist/safety-audit.d.ts.map +1 -0
  593. package/dist/safety-audit.js +138 -0
  594. package/dist/safety-html.d.ts +7 -0
  595. package/dist/safety-html.d.ts.map +1 -0
  596. package/dist/safety-html.js +70 -0
  597. package/dist/scaffold-coverage.d.ts +46 -0
  598. package/dist/scaffold-coverage.d.ts.map +1 -0
  599. package/dist/scaffold-coverage.js +273 -0
  600. package/dist/scaffold-patterns.d.ts +38 -0
  601. package/dist/scaffold-patterns.d.ts.map +1 -0
  602. package/dist/scaffold-patterns.js +282 -0
  603. package/dist/schema-inventory.d.ts +55 -0
  604. package/dist/schema-inventory.d.ts.map +1 -0
  605. package/dist/schema-inventory.js +301 -0
  606. package/dist/search-index.d.ts +75 -0
  607. package/dist/search-index.d.ts.map +1 -0
  608. package/dist/search-index.js +531 -0
  609. package/dist/search-tuning-explain.d.ts +68 -0
  610. package/dist/search-tuning-explain.d.ts.map +1 -0
  611. package/dist/search-tuning-explain.js +207 -0
  612. package/dist/search-tuning-registry.d.ts +54 -0
  613. package/dist/search-tuning-registry.d.ts.map +1 -0
  614. package/dist/search-tuning-registry.js +303 -0
  615. package/dist/self-audit.d.ts +59 -0
  616. package/dist/self-audit.d.ts.map +1 -0
  617. package/dist/self-audit.js +192 -0
  618. package/dist/self-config-doctor-v2.d.ts +57 -0
  619. package/dist/self-config-doctor-v2.d.ts.map +1 -0
  620. package/dist/self-config-doctor-v2.js +653 -0
  621. package/dist/self-config-doctor.d.ts +47 -0
  622. package/dist/self-config-doctor.d.ts.map +1 -0
  623. package/dist/self-config-doctor.js +432 -0
  624. package/dist/sharkcraft-inspector.d.ts +73 -0
  625. package/dist/sharkcraft-inspector.d.ts.map +1 -0
  626. package/dist/sharkcraft-inspector.js +745 -0
  627. package/dist/spec/spec-cross-validate.d.ts +17 -0
  628. package/dist/spec/spec-cross-validate.d.ts.map +1 -0
  629. package/dist/spec/spec-cross-validate.js +53 -0
  630. package/dist/spec/spec-discovery.d.ts +27 -0
  631. package/dist/spec/spec-discovery.d.ts.map +1 -0
  632. package/dist/spec/spec-discovery.js +78 -0
  633. package/dist/spec/spec-review.d.ts +36 -0
  634. package/dist/spec/spec-review.d.ts.map +1 -0
  635. package/dist/spec/spec-review.js +37 -0
  636. package/dist/stability-map.d.ts +62 -0
  637. package/dist/stability-map.d.ts.map +1 -0
  638. package/dist/stability-map.js +404 -0
  639. package/dist/start-here.d.ts +49 -0
  640. package/dist/start-here.d.ts.map +1 -0
  641. package/dist/start-here.js +259 -0
  642. package/dist/surface-profile-detect.d.ts +42 -0
  643. package/dist/surface-profile-detect.d.ts.map +1 -0
  644. package/dist/surface-profile-detect.js +76 -0
  645. package/dist/symbol-index.d.ts +108 -0
  646. package/dist/symbol-index.d.ts.map +1 -0
  647. package/dist/symbol-index.js +483 -0
  648. package/dist/task-decompose.d.ts +38 -0
  649. package/dist/task-decompose.d.ts.map +1 -0
  650. package/dist/task-decompose.js +154 -0
  651. package/dist/task-packet.d.ts +104 -0
  652. package/dist/task-packet.d.ts.map +1 -0
  653. package/dist/task-packet.js +156 -0
  654. package/dist/task-ranker.d.ts +51 -0
  655. package/dist/task-ranker.d.ts.map +1 -0
  656. package/dist/task-ranker.js +410 -0
  657. package/dist/task-risk.d.ts +84 -0
  658. package/dist/task-risk.d.ts.map +1 -0
  659. package/dist/task-risk.js +731 -0
  660. package/dist/task-routing-hint-registry.d.ts +36 -0
  661. package/dist/task-routing-hint-registry.d.ts.map +1 -0
  662. package/dist/task-routing-hint-registry.js +186 -0
  663. package/dist/template-authoring.d.ts +113 -0
  664. package/dist/template-authoring.d.ts.map +1 -0
  665. package/dist/template-authoring.js +521 -0
  666. package/dist/template-body-inference-v2.d.ts +19 -0
  667. package/dist/template-body-inference-v2.d.ts.map +1 -0
  668. package/dist/template-body-inference-v2.js +468 -0
  669. package/dist/template-body-inference.d.ts +59 -0
  670. package/dist/template-body-inference.d.ts.map +1 -0
  671. package/dist/template-body-inference.js +277 -0
  672. package/dist/template-drift.d.ts +39 -0
  673. package/dist/template-drift.d.ts.map +1 -0
  674. package/dist/template-drift.js +353 -0
  675. package/dist/template-lint.d.ts +31 -0
  676. package/dist/template-lint.d.ts.map +1 -0
  677. package/dist/template-lint.js +113 -0
  678. package/dist/test-definitions.d.ts +41 -0
  679. package/dist/test-definitions.d.ts.map +1 -0
  680. package/dist/test-definitions.js +6 -0
  681. package/dist/test-impact.d.ts +30 -0
  682. package/dist/test-impact.d.ts.map +1 -0
  683. package/dist/test-impact.js +173 -0
  684. package/dist/test-runner.d.ts +87 -0
  685. package/dist/test-runner.d.ts.map +1 -0
  686. package/dist/test-runner.js +560 -0
  687. package/dist/uncertainty-report.d.ts +46 -0
  688. package/dist/uncertainty-report.d.ts.map +1 -0
  689. package/dist/uncertainty-report.js +108 -0
  690. package/dist/uncertainty.d.ts +38 -0
  691. package/dist/uncertainty.d.ts.map +1 -0
  692. package/dist/uncertainty.js +115 -0
  693. package/dist/universal-search.d.ts +64 -0
  694. package/dist/universal-search.d.ts.map +1 -0
  695. package/dist/universal-search.js +347 -0
  696. package/dist/upgrade-advisor.d.ts +22 -0
  697. package/dist/upgrade-advisor.d.ts.map +1 -0
  698. package/dist/upgrade-advisor.js +109 -0
  699. package/dist/why-file.d.ts +75 -0
  700. package/dist/why-file.d.ts.map +1 -0
  701. package/dist/why-file.js +202 -0
  702. package/dist/workflow-simulation.d.ts +46 -0
  703. package/dist/workflow-simulation.d.ts.map +1 -0
  704. package/dist/workflow-simulation.js +154 -0
  705. package/package.json +66 -0
@@ -0,0 +1,470 @@
1
+ /**
2
+ * Agent handoff packet.
3
+ *
4
+ * `brief` is the *pre-work* context for an agent. `handoff` is the
5
+ * *continue-from-here* context: it captures current task status, what was
6
+ * already done, what remains, and the single next safe command — so a
7
+ * different agent (or the same agent after a context reset) can pick up
8
+ * without redoing discovery.
9
+ *
10
+ * Read-only. Sources state from:
11
+ * - a passed-in task string + inspection
12
+ * - an existing dev session (sessionId)
13
+ * - an existing feature bundle (bundleId)
14
+ * - optionally a git ref (`since`) for changed-files surfacing
15
+ *
16
+ * Never writes (the CLI write step is the caller's responsibility).
17
+ */
18
+ import * as nodePath from 'node:path';
19
+ import { readFeatureBundle } from "./feature-bundle.js";
20
+ import { scanDevSession, DevSessionPlanStatus } from "./dev-session.js";
21
+ import { buildAgentBrief, BriefMode } from "./agent-brief.js";
22
+ import { getChangedFiles } from "./git-helpers.js";
23
+ import { buildTaskRiskReport } from "./task-risk.js";
24
+ import { buildAgentContract } from "./agent-contract.js";
25
+ import { buildTaskExecutionGraph } from "./execution-graph.js";
26
+ import { simulatePlan } from "./plan-simulation.js";
27
+ import { loadRepositoryMemory, memoryRiskForTask } from "./repo-memory.js";
28
+ import { buildUncertaintyReport } from "./uncertainty-report.js";
29
+ export const AGENT_HANDOFF_SCHEMA = 'sharkcraft.agent-handoff/v1';
30
+ function tokensEstimate(s) {
31
+ // SharkCraft convention: ~4 chars per token, with a floor of 1.
32
+ return Math.max(1, Math.ceil(s.length / 4));
33
+ }
34
+ function formatList(items, bullet = '-') {
35
+ if (items.length === 0)
36
+ return '(none)';
37
+ return items.map((i) => `${bullet} ${i}`).join('\n');
38
+ }
39
+ function buildSafetyNote() {
40
+ return [
41
+ 'Before any write step:',
42
+ ' - Generation: `shrk gen --dry-run --save-plan /tmp/plan.json`, then `shrk plan review`,',
43
+ ' then `shrk apply --verify-signature`.',
44
+ ' - MCP tools never write to disk. The CLI is the only write path.',
45
+ ' - Pack-contributed verification commands are NOT auto-run.',
46
+ ].join('\n');
47
+ }
48
+ function describeSession(load) {
49
+ const state = load.state;
50
+ const artifacts = [];
51
+ const approvals = [];
52
+ if (!state) {
53
+ return { status: 'legacy', next: `shrk dev status ${load.id}`, artifacts, approvals };
54
+ }
55
+ if (state.briefFile)
56
+ artifacts.push({ kind: 'brief', path: state.briefFile });
57
+ for (const a of state.appliedPlans ?? []) {
58
+ artifacts.push({ kind: 'applied-plan', path: a.file });
59
+ }
60
+ for (const v of state.validations ?? []) {
61
+ artifacts.push({ kind: 'validation', path: v.startedAt });
62
+ }
63
+ const next = state.nextAction ? state.nextAction : `shrk dev status ${state.id}`;
64
+ for (const p of state.plans ?? []) {
65
+ if (p.status === DevSessionPlanStatus.Saved || p.status === DevSessionPlanStatus.Reviewed) {
66
+ approvals.push(`Review + apply plan "${p.file}".`);
67
+ }
68
+ }
69
+ return { status: state.phase, next, artifacts, approvals };
70
+ }
71
+ function describeBundle(bundle) {
72
+ const artifacts = [];
73
+ for (const plan of bundle.plans ?? []) {
74
+ if (plan.file)
75
+ artifacts.push({ kind: 'plan', path: plan.file });
76
+ }
77
+ for (const v of bundle.validations ?? []) {
78
+ artifacts.push({ kind: 'validation', path: v.startedAt });
79
+ }
80
+ const next = bundle.nextAction ?? 'shrk bundle show ' + bundle.id;
81
+ const approvals = [];
82
+ for (const plan of bundle.plans ?? []) {
83
+ if (plan.status === 'saved' || plan.status === 'reviewed' || plan.status === 'intent') {
84
+ approvals.push(`Apply plan "${plan.name}" (${plan.file}).`);
85
+ }
86
+ }
87
+ return { status: bundle.status, next, artifacts, approvals };
88
+ }
89
+ function chunkBody(sectionId, title, body, order) {
90
+ const file = `${String(order).padStart(2, '0')}-${sectionId}.md`;
91
+ return {
92
+ file,
93
+ sectionId,
94
+ title,
95
+ body,
96
+ tokenEstimate: tokensEstimate(body),
97
+ };
98
+ }
99
+ export async function buildAgentHandoff(inspection, input) {
100
+ const projectRoot = inspection.projectRoot;
101
+ let session = null;
102
+ if (input.sessionId) {
103
+ session = scanDevSession(projectRoot, input.sessionId);
104
+ }
105
+ let bundle = null;
106
+ if (input.bundleId) {
107
+ bundle = readFeatureBundle(projectRoot, input.bundleId);
108
+ }
109
+ const sessionState = session?.state ?? null;
110
+ const task = input.task ?? sessionState?.task ?? bundle?.task ?? '(no task supplied)';
111
+ const knownContext = [];
112
+ const doNotTouch = [
113
+ 'Do not bypass `shrk apply --verify-signature`.',
114
+ 'Do not commit changes inside `node_modules/`, `dist/`, or `.sharkcraft/cache/`.',
115
+ 'Do not modify generated bundle JSON by hand — re-run the generator instead.',
116
+ ];
117
+ const relevantRules = [];
118
+ const relevantFiles = [];
119
+ let status = 'pending';
120
+ let next = 'shrk doctor';
121
+ let approvals = [];
122
+ const artifacts = [];
123
+ if (session) {
124
+ const d = describeSession(session);
125
+ const sessionId = sessionState?.id ?? session.id;
126
+ status = `session ${sessionId} in phase ${d.status}`;
127
+ next = d.next;
128
+ approvals.push(...d.approvals);
129
+ artifacts.push(...d.artifacts);
130
+ knownContext.push(`Active dev session: ${sessionId}`);
131
+ if (sessionState?.briefFile) {
132
+ knownContext.push(`Brief file: ${sessionState.briefFile}`);
133
+ relevantFiles.push(sessionState.briefFile);
134
+ }
135
+ for (const plan of sessionState?.plans ?? []) {
136
+ relevantFiles.push(plan.file);
137
+ }
138
+ }
139
+ if (bundle) {
140
+ const d = describeBundle(bundle);
141
+ status = session ? `${status}; bundle ${bundle.id} (${d.status})` : `bundle ${bundle.id} (${d.status})`;
142
+ next = next === 'shrk doctor' ? d.next : next;
143
+ approvals.push(...d.approvals);
144
+ artifacts.push(...d.artifacts);
145
+ knownContext.push(`Active feature bundle: ${bundle.id} (${bundle.status})`);
146
+ for (const file of bundle.affectedFiles ?? [])
147
+ relevantFiles.push(file);
148
+ }
149
+ if (input.since) {
150
+ const changed = getChangedFiles(projectRoot, { since: input.since });
151
+ if (changed.length > 0) {
152
+ knownContext.push(`${changed.length} changed file(s) since ${input.since}`);
153
+ for (const f of changed)
154
+ relevantFiles.push(f);
155
+ }
156
+ }
157
+ // Pull the most relevant top-priority rules from the inspection so the
158
+ // handoff carries enough behavioural context.
159
+ for (const r of inspection.knowledgeEntries.slice(0, 10)) {
160
+ relevantRules.push(`${r.id}: ${r.title}`);
161
+ }
162
+ // Render a brief alongside for the chunked path so the agent has the same
163
+ // pre-work context as a fresh `shrk brief`.
164
+ let brief = null;
165
+ if (input.chunked) {
166
+ brief = await buildAgentBrief(inspection, {
167
+ ...(task !== '(no task supplied)' ? { task } : {}),
168
+ mode: BriefMode.Handoff,
169
+ files: [...new Set(relevantFiles)],
170
+ ...(input.sessionId ? { sessionId: input.sessionId } : {}),
171
+ ...(input.bundleId ? { bundleId: input.bundleId } : {}),
172
+ chunked: true,
173
+ });
174
+ }
175
+ const validationExpectations = [
176
+ 'bun x tsc -p tsconfig.base.json --noEmit',
177
+ 'bun test',
178
+ 'shrk doctor',
179
+ 'shrk check boundaries',
180
+ ];
181
+ const humanApprovalPoints = approvals.length > 0 ? approvals : [
182
+ 'After plan generation, a human must run `shrk plan review` and `shrk apply --verify-signature`.',
183
+ ];
184
+ const safetyNote = buildSafetyNote();
185
+ const sourceKind = session && bundle ? 'session+bundle' : session ? 'session' : bundle ? 'bundle' : 'task-only';
186
+ // Compose the markdown body.
187
+ const lines = [];
188
+ lines.push(`# Agent handoff — ${task}`);
189
+ lines.push('');
190
+ lines.push(`Generated: ${new Date().toISOString()}`);
191
+ lines.push(`Project: ${projectRoot}`);
192
+ lines.push(`Source: ${sourceKind}`);
193
+ lines.push('');
194
+ lines.push('## Known context');
195
+ lines.push('');
196
+ lines.push(formatList(knownContext));
197
+ lines.push('');
198
+ lines.push('## Do NOT touch');
199
+ lines.push('');
200
+ lines.push(formatList(doNotTouch));
201
+ lines.push('');
202
+ lines.push('## Current status');
203
+ lines.push('');
204
+ lines.push(status);
205
+ lines.push('');
206
+ lines.push('## Next safe command');
207
+ lines.push('');
208
+ lines.push('```');
209
+ lines.push(next);
210
+ lines.push('```');
211
+ lines.push('');
212
+ lines.push('## Validation expectations');
213
+ lines.push('');
214
+ lines.push(formatList(validationExpectations));
215
+ lines.push('');
216
+ lines.push('## Human approval points');
217
+ lines.push('');
218
+ lines.push(formatList(humanApprovalPoints));
219
+ lines.push('');
220
+ lines.push('## Relevant files');
221
+ lines.push('');
222
+ lines.push(formatList(relevantFiles));
223
+ lines.push('');
224
+ lines.push('## Relevant rules');
225
+ lines.push('');
226
+ lines.push(formatList(relevantRules));
227
+ lines.push('');
228
+ lines.push('## Available artifacts');
229
+ lines.push('');
230
+ if (artifacts.length === 0)
231
+ lines.push('(none)');
232
+ else
233
+ for (const a of artifacts)
234
+ lines.push(`- [${a.kind}] ${a.path}`);
235
+ lines.push('');
236
+ lines.push('## Safety note');
237
+ lines.push('');
238
+ lines.push(safetyNote);
239
+ if (brief) {
240
+ lines.push('');
241
+ lines.push('## Pre-work brief (reference)');
242
+ lines.push('');
243
+ lines.push(brief.markdown);
244
+ }
245
+ const markdown = lines.join('\n');
246
+ const chunks = [];
247
+ if (input.chunked) {
248
+ chunks.push(chunkBody('00-overview', 'Overview', `# ${task}\n\nSource: ${sourceKind}\nStatus: ${status}\n`, 0));
249
+ chunks.push(chunkBody('next-command', 'Next safe command', `\`\`\`\n${next}\n\`\`\``, 1));
250
+ chunks.push(chunkBody('known-context', 'Known context', formatList(knownContext), 2));
251
+ chunks.push(chunkBody('do-not-touch', 'Do not touch', formatList(doNotTouch), 3));
252
+ chunks.push(chunkBody('validation', 'Validation expectations', formatList(validationExpectations), 4));
253
+ chunks.push(chunkBody('approvals', 'Human approval points', formatList(humanApprovalPoints), 5));
254
+ chunks.push(chunkBody('relevant-files', 'Relevant files', formatList(relevantFiles), 6));
255
+ chunks.push(chunkBody('relevant-rules', 'Relevant rules', formatList(relevantRules), 7));
256
+ chunks.push(chunkBody('safety', 'Safety note', safetyNote, 8));
257
+ if (brief) {
258
+ chunks.push(chunkBody('brief', 'Pre-work brief', brief.markdown, 9));
259
+ }
260
+ }
261
+ // Attach a task-risk summary if a task is provided. Best-effort.
262
+ let taskRiskSummary;
263
+ let taskRiskFull;
264
+ if (input.task && input.task.trim().length > 0) {
265
+ try {
266
+ const r = await buildTaskRiskReport(input.task, inspection, {
267
+ ...(input.since ? { since: input.since } : {}),
268
+ ...(input.includeMemory ? { includeMemory: true } : {}),
269
+ });
270
+ taskRiskFull = r;
271
+ taskRiskSummary = {
272
+ level: r.riskLevel,
273
+ score: r.score,
274
+ reasons: r.reasons.slice(0, 5).map((reason) => `[${reason.code}] ${reason.message}`),
275
+ };
276
+ }
277
+ catch {
278
+ /* best-effort */
279
+ }
280
+ }
281
+ // Contract, execution graph, plan simulation, memory.
282
+ let contract;
283
+ let contractSummary;
284
+ if (input.includeContract && input.task && input.task.trim().length > 0) {
285
+ try {
286
+ contract = await buildAgentContract(input.task, inspection, {
287
+ ...(input.role ? { role: input.role } : {}),
288
+ ...(input.mode ? { mode: input.mode } : {}),
289
+ ...(input.since ? { since: input.since } : {}),
290
+ });
291
+ const { computeContractHash } = await import("./agent-contract-gate.js");
292
+ contractSummary = {
293
+ role: contract.role,
294
+ mode: contract.mode,
295
+ forbiddenCommands: contract.forbiddenCommands.slice(0, 6),
296
+ requiredValidations: contract.requiredValidations,
297
+ requiredReviews: contract.requiredReviews,
298
+ humanApprovalGates: contract.humanApprovalGates,
299
+ recommendedNextCommand: contract.recommendedNextCommand,
300
+ contractHash: computeContractHash(contract),
301
+ };
302
+ }
303
+ catch {
304
+ /* best-effort */
305
+ }
306
+ }
307
+ let executionGraph;
308
+ let executionGraphSummary;
309
+ if (input.includeExecutionGraph && input.task && input.task.trim().length > 0) {
310
+ try {
311
+ executionGraph = await buildTaskExecutionGraph(input.task, inspection, {
312
+ ...(input.role ? { role: input.role } : {}),
313
+ ...(input.mode ? { mode: input.mode } : {}),
314
+ ...(input.since ? { since: input.since } : {}),
315
+ });
316
+ const approvalNodes = executionGraph.nodes
317
+ .filter((n) => n.kind === 'human-approval')
318
+ .map((n) => n.label);
319
+ executionGraphSummary = {
320
+ nodes: executionGraph.nodes.length,
321
+ edges: executionGraph.edges.length,
322
+ humanApprovalNodes: approvalNodes,
323
+ };
324
+ }
325
+ catch {
326
+ /* best-effort */
327
+ }
328
+ }
329
+ let planSimulation;
330
+ if (input.includePlanSimulation) {
331
+ try {
332
+ const planPath = input.includePlanSimulation;
333
+ const absPlan = nodePath.isAbsolute(planPath)
334
+ ? planPath
335
+ : nodePath.resolve(projectRoot, planPath);
336
+ planSimulation = await simulatePlan(inspection, absPlan, {
337
+ includeBoundaries: true,
338
+ includeImpact: true,
339
+ includeOwnership: true,
340
+ });
341
+ }
342
+ catch {
343
+ /* best-effort */
344
+ }
345
+ }
346
+ let memoryRisk;
347
+ if (input.includeMemory && input.task && input.task.trim().length > 0) {
348
+ try {
349
+ const idx = loadRepositoryMemory(projectRoot);
350
+ memoryRisk = memoryRiskForTask(idx, input.task);
351
+ }
352
+ catch {
353
+ /* best-effort */
354
+ }
355
+ }
356
+ // Extend the markdown body with the included summaries.
357
+ let unifiedMarkdown = markdown;
358
+ if (contractSummary) {
359
+ unifiedMarkdown += '\n\n## Agent contract\n\n';
360
+ unifiedMarkdown += `- role: ${contractSummary.role}\n- mode: ${contractSummary.mode}\n- hash: \`${contractSummary.contractHash.slice(0, 16)}…\`\n`;
361
+ if (contractSummary.humanApprovalGates.length > 0) {
362
+ unifiedMarkdown += '\n### Human approval gates\n\n' + formatList(contractSummary.humanApprovalGates) + '\n';
363
+ }
364
+ if (contractSummary.forbiddenCommands.length > 0) {
365
+ unifiedMarkdown += '\n### Forbidden commands\n\n' + formatList(contractSummary.forbiddenCommands) + '\n';
366
+ }
367
+ if (contractSummary.requiredValidations.length > 0) {
368
+ unifiedMarkdown += '\n### Required validations\n\n' + formatList(contractSummary.requiredValidations) + '\n';
369
+ }
370
+ unifiedMarkdown += `\nRecommended next command: \`${contractSummary.recommendedNextCommand}\`\n`;
371
+ }
372
+ if (memoryRisk) {
373
+ unifiedMarkdown += '\n\n## Memory-driven warnings\n\n';
374
+ unifiedMarkdown += `- overlap: **${memoryRisk.recommendation}**\n`;
375
+ if (memoryRisk.matchedFiles.length > 0) {
376
+ unifiedMarkdown += `- top risky files:\n`;
377
+ for (const f of memoryRisk.matchedFiles.slice(0, 8))
378
+ unifiedMarkdown += ` - ${f.path} (touches=${f.touchCount}, conflicts=${f.conflictCount})\n`;
379
+ }
380
+ }
381
+ if (executionGraphSummary) {
382
+ unifiedMarkdown += '\n\n## Execution graph\n\n';
383
+ unifiedMarkdown += `- nodes: ${executionGraphSummary.nodes}\n- edges: ${executionGraphSummary.edges}\n`;
384
+ if (executionGraphSummary.humanApprovalNodes.length > 0) {
385
+ unifiedMarkdown += `- human approval: ${executionGraphSummary.humanApprovalNodes.join(' | ')}\n`;
386
+ }
387
+ }
388
+ if (planSimulation) {
389
+ unifiedMarkdown += '\n\n## Plan simulation\n\n';
390
+ unifiedMarkdown += `- source: \`${planSimulation.source}\`\n- readiness: **${planSimulation.applyReadiness}**\n- public API touched: ${planSimulation.publicApiTouched ? 'yes' : 'no'}\n- ownership review required: ${planSimulation.ownershipReviewRequired ? 'yes' : 'no'}\n`;
391
+ }
392
+ return {
393
+ schema: AGENT_HANDOFF_SCHEMA,
394
+ generatedAt: new Date().toISOString(),
395
+ projectRoot,
396
+ task,
397
+ knownContext,
398
+ doNotTouch,
399
+ relevantFiles,
400
+ relevantRules,
401
+ currentStatus: status,
402
+ nextSafeCommand: next,
403
+ validationExpectations,
404
+ humanApprovalPoints,
405
+ availableArtifacts: artifacts,
406
+ safetyNote,
407
+ markdown: unifiedMarkdown,
408
+ ...(taskRiskFull ? { taskRisk: taskRiskFull } : {}),
409
+ ...(contract ? { contract } : {}),
410
+ ...(contractSummary ? { contractSummary } : {}),
411
+ ...(executionGraph ? { executionGraph } : {}),
412
+ ...(executionGraphSummary ? { executionGraphSummary } : {}),
413
+ ...(planSimulation ? { planSimulation } : {}),
414
+ ...(memoryRisk ? { memoryRisk } : {}),
415
+ ...(chunks.length > 0 ? { chunks } : {}),
416
+ ...(taskRiskSummary ? { taskRiskSummary } : {}),
417
+ source: {
418
+ kind: sourceKind,
419
+ ...(input.sessionId ? { sessionId: input.sessionId } : {}),
420
+ ...(input.bundleId ? { bundleId: input.bundleId } : {}),
421
+ },
422
+ uncertainty: buildHandoffUncertainty({
423
+ taskRiskSummary,
424
+ relevantFiles,
425
+ knownContext,
426
+ sourceKind,
427
+ }),
428
+ };
429
+ }
430
+ function buildHandoffUncertainty(input) {
431
+ let confidence = 'medium';
432
+ const reasons = [];
433
+ const missing = [];
434
+ if (input.sourceKind === 'task-only') {
435
+ confidence = 'low';
436
+ reasons.push('Handoff derived from task only — no session or bundle context.');
437
+ missing.push({ id: 'no-session', message: 'No session context attached.' });
438
+ missing.push({ id: 'no-bundle', message: 'No bundle context attached.' });
439
+ }
440
+ if (input.taskRiskSummary && input.taskRiskSummary.level === 'high') {
441
+ confidence = 'low';
442
+ reasons.push(`Task risk is HIGH (score ${input.taskRiskSummary.score}).`);
443
+ }
444
+ if (input.relevantFiles.length === 0) {
445
+ missing.push({ id: 'no-relevant-files', message: 'No relevant files identified.' });
446
+ if (confidence !== 'low')
447
+ confidence = 'medium';
448
+ }
449
+ if (input.knownContext.length === 0) {
450
+ missing.push({ id: 'no-known-context', message: 'No known context paragraphs.' });
451
+ }
452
+ return buildUncertaintyReport({
453
+ confidence,
454
+ reasons,
455
+ missingSignals: missing,
456
+ suggestedCommands: [
457
+ 'shrk task "<task>" --commands-first',
458
+ 'shrk dev status',
459
+ ],
460
+ safeFallbackCommand: 'shrk start-here',
461
+ });
462
+ }
463
+ export function defaultHandoffOutputPath(projectRoot, task) {
464
+ const slug = task
465
+ .toLowerCase()
466
+ .replace(/[^a-z0-9]+/g, '-')
467
+ .replace(/^-+|-+$/g, '')
468
+ .slice(0, 40);
469
+ return nodePath.join(projectRoot, '.sharkcraft', 'handoffs', `${Date.now()}-${slug || 'handoff'}.md`);
470
+ }
@@ -0,0 +1,2 @@
1
+ export declare const AGENT_INSTRUCTIONS: string;
2
+ //# sourceMappingURL=agent-instructions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../src/agent-instructions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAoBvB,CAAC"}
@@ -0,0 +1,21 @@
1
+ export const AGENT_INSTRUCTIONS = `
2
+ You are an AI agent integrated with SharkCraft.
3
+
4
+ Default behavior:
5
+ - Do not read every documentation file.
6
+ - Use MCP tools to retrieve only the information you actually need.
7
+ - For task context, call get_relevant_context with the current task and a tight maxTokens.
8
+ - For rules, call get_relevant_rules — never list_rules unless you need an inventory.
9
+ - For generation, list_templates → get_template → create_generation_plan (dry-run by default).
10
+ - Respect path conventions (list_path_conventions, get_path_convention).
11
+
12
+ Safety:
13
+ - Never write files unless the user explicitly asks; always prefer dry-run first.
14
+ - Never overwrite existing files unless the plan resolves all conflicts.
15
+ - Don't modify files outside the project root.
16
+
17
+ Quality:
18
+ - Quote the knowledge entry id you used so the user can trace it.
19
+ - If you skip a section, say so and explain why.
20
+ - If a query returns nothing, refine the task description and retry, then ask the user.
21
+ `.trim();
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Agent orchestration planner.
3
+ *
4
+ * Given a task, produce a safe, read-only plan describing how an
5
+ * agent/human should proceed: phases, commands to suggest, MCP tools,
6
+ * expected artifacts, human-approval points, stop conditions.
7
+ *
8
+ * This is not execution. It does not apply, it does not write source.
9
+ *
10
+ * Modes:
11
+ * - conservative: more review/checkpoints; only drafts/plans suggested
12
+ * - balanced: dev session + plan review + apply hint
13
+ * - aggressive: still no auto-apply, but suggests bundle/dev flow faster
14
+ */
15
+ import { type IChangeIntent } from './change-intent.js';
16
+ import { type IRiskSignals } from './risk-signals.js';
17
+ import { type ITaskRiskReport } from './task-risk.js';
18
+ import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
19
+ export declare const AGENT_ORCHESTRATION_SCHEMA = "sharkcraft.agent-orchestration/v1";
20
+ export declare enum OrchestrationMode {
21
+ Conservative = "conservative",
22
+ Balanced = "balanced",
23
+ Aggressive = "aggressive"
24
+ }
25
+ export interface IOrchestrationPhase {
26
+ id: string;
27
+ title: string;
28
+ purpose: string;
29
+ recommendedCommands: readonly string[];
30
+ mcpTools: readonly string[];
31
+ expectedArtifacts: readonly string[];
32
+ humanApprovalRequired: boolean;
33
+ stopConditions: readonly string[];
34
+ safetyNotes: readonly string[];
35
+ }
36
+ export interface IAgentOrchestrationPlan {
37
+ schema: typeof AGENT_ORCHESTRATION_SCHEMA;
38
+ generatedAt: string;
39
+ task: string;
40
+ intent: IChangeIntent;
41
+ mode: OrchestrationMode;
42
+ phases: readonly IOrchestrationPhase[];
43
+ firstCommand: string;
44
+ forbiddenActions: readonly string[];
45
+ validationCommands: readonly string[];
46
+ reviewCheckpoints: readonly string[];
47
+ risk?: IRiskSignals;
48
+ taskRisk?: ITaskRiskReport;
49
+ riskAware: boolean;
50
+ }
51
+ export interface IOrchestrationOptions {
52
+ mode?: OrchestrationMode;
53
+ bundle?: boolean;
54
+ session?: boolean;
55
+ /** When true, fold risk signals into the plan (extra phases / approvals when risk is high). */
56
+ riskAware?: boolean;
57
+ }
58
+ export declare function buildAgentOrchestrationPlan(task: string, inspection: ISharkcraftInspection, options?: IOrchestrationOptions): Promise<IAgentOrchestrationPlan>;
59
+ export declare function renderOrchestrationText(plan: IAgentOrchestrationPlan): string;
60
+ export declare function renderOrchestrationMarkdown(plan: IAgentOrchestrationPlan): string;
61
+ //# sourceMappingURL=agent-orchestration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-orchestration.d.ts","sourceRoot":"","sources":["../src/agent-orchestration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA0C,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAsC,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,oBAAY,iBAAiB;IAC3B,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,0BAA0B,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA6JD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAiElC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAkB7E;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CA8BjF"}