@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,221 @@
1
+ /**
2
+ * Entrypoint matrix.
3
+ *
4
+ * Classifies SharkCraft's many "get me context" / "what should I do?" surfaces
5
+ * into four discrete entrypoint classes:
6
+ *
7
+ * - human-interactive — shells / TTY use; primary first answer.
8
+ * - agent-mcp — what an AI coding agent should call first.
9
+ * - machine-json — non-human, machine-consumable JSON packets.
10
+ * - debug-explainability — ranker / boundary / search debugging.
11
+ *
12
+ * This is pure curated data. The CLI exposes it via `shrk commands matrix`,
13
+ * and individual commands (`shrk task`, `shrk context`, `shrk recommend`)
14
+ * include a one-line banner referencing this matrix so the operator sees
15
+ * which class they reached.
16
+ */
17
+ export const ENTRYPOINT_MATRIX_SCHEMA = 'sharkcraft.entrypoint-matrix/v1';
18
+ export var EntrypointClass;
19
+ (function (EntrypointClass) {
20
+ EntrypointClass["HumanInteractive"] = "human-interactive";
21
+ EntrypointClass["AgentMcp"] = "agent-mcp";
22
+ EntrypointClass["MachineJson"] = "machine-json";
23
+ EntrypointClass["DebugExplainability"] = "debug-explainability";
24
+ })(EntrypointClass || (EntrypointClass = {}));
25
+ const MATRIX_ENTRIES = [
26
+ {
27
+ id: 'recommend',
28
+ class: EntrypointClass.HumanInteractive,
29
+ callShape: 'shrk recommend "<task>"',
30
+ whenToUse: 'You are a human at a terminal and want "what should I do?" — primary interactive entrypoint.',
31
+ safety: 'read-only',
32
+ docs: 'docs/recommend.md',
33
+ seeAlso: ['start-here', 'task-context'],
34
+ },
35
+ {
36
+ id: 'start-here',
37
+ class: EntrypointClass.HumanInteractive,
38
+ callShape: 'shrk start-here [--flow <name>]',
39
+ whenToUse: 'First-time onboarding overview — 30-second explanation, primary flows, safety pledge.',
40
+ safety: 'read-only',
41
+ docs: 'docs/start-here.md',
42
+ seeAlso: ['recommend'],
43
+ },
44
+ {
45
+ id: 'context',
46
+ class: EntrypointClass.HumanInteractive,
47
+ callShape: 'shrk context --task "<task>"',
48
+ whenToUse: 'Build a focused, token-budgeted context bundle for a specific task. For action-like tasks, commands surface first.',
49
+ safety: 'read-only',
50
+ docs: 'docs/context.md',
51
+ seeAlso: ['recommend', 'task-context'],
52
+ },
53
+ {
54
+ id: 'prepare-agent-task',
55
+ class: EntrypointClass.AgentMcp,
56
+ callShape: 'mcp__sharkcraft__prepare_agent_task',
57
+ whenToUse: 'An AI agent\'s first MCP call for a task — returns brief + plan + verification commands. Read-only.',
58
+ safety: 'read-only',
59
+ docs: 'docs/agent-task-prep.md',
60
+ seeAlso: ['get-relevant-context', 'get-task-packet'],
61
+ },
62
+ {
63
+ id: 'get-relevant-context',
64
+ class: EntrypointClass.AgentMcp,
65
+ callShape: 'mcp__sharkcraft__get_relevant_context',
66
+ whenToUse: 'Agent-side equivalent of `shrk context`. Token-budgeted, read-only.',
67
+ safety: 'read-only',
68
+ },
69
+ {
70
+ id: 'get-task-packet',
71
+ class: EntrypointClass.AgentMcp,
72
+ callShape: 'mcp__sharkcraft__get_task_packet',
73
+ whenToUse: 'Agent-side equivalent of `shrk task` — full task packet.',
74
+ safety: 'read-only',
75
+ },
76
+ {
77
+ id: 'task',
78
+ class: EntrypointClass.MachineJson,
79
+ callShape: 'shrk task "<task>" --json',
80
+ whenToUse: 'Machine-readable JSON envelope of rules + templates + pipelines + commands. Pipe into another tool.',
81
+ safety: 'read-only',
82
+ seeAlso: ['get-task-packet', 'context'],
83
+ },
84
+ {
85
+ id: 'search',
86
+ class: EntrypointClass.MachineJson,
87
+ callShape: 'shrk search "<query>" [--json]',
88
+ whenToUse: 'Registry search across knowledge, rules, templates, playbooks, etc. JSON for piping; text for humans.',
89
+ safety: 'read-only',
90
+ },
91
+ {
92
+ id: 'why',
93
+ class: EntrypointClass.DebugExplainability,
94
+ callShape: 'shrk why <id> | shrk why-not <id>',
95
+ whenToUse: 'Debug the ranker — why a registry entry was / was not surfaced for a task.',
96
+ safety: 'read-only',
97
+ docs: 'docs/why.md',
98
+ seeAlso: ['recommend', 'context'],
99
+ },
100
+ {
101
+ id: 'graph-why',
102
+ class: EntrypointClass.DebugExplainability,
103
+ callShape: 'shrk graph why <a> <b>',
104
+ whenToUse: 'Shortest-path explanation between two graph nodes.',
105
+ safety: 'read-only',
106
+ seeAlso: ['why'],
107
+ },
108
+ {
109
+ id: 'apply-explain-dispatch',
110
+ class: EntrypointClass.DebugExplainability,
111
+ callShape: 'shrk apply <plan> --explain-dispatch',
112
+ whenToUse: 'Describe which dispatch path apply would take (template / helper / plugin-lifecycle / registration-hint / synthetic) without applying anything.',
113
+ safety: 'read-only',
114
+ },
115
+ // Distinguish `shrk task` text output (machine packet) from
116
+ // `task --json` (the canonical machine surface).
117
+ {
118
+ id: 'task-text',
119
+ class: EntrypointClass.MachineJson,
120
+ callShape: 'shrk task "<task>"',
121
+ whenToUse: 'Machine packet rendered as text. For a human answer prefer `shrk recommend`; for piping prefer `shrk task --json`.',
122
+ safety: 'read-only',
123
+ seeAlso: ['recommend', 'task', 'get-task-packet'],
124
+ },
125
+ // Make `shrk search` self-evidently a registry search, not
126
+ // "what should I do?".
127
+ {
128
+ id: 'search-registry',
129
+ class: EntrypointClass.MachineJson,
130
+ callShape: 'shrk search "<query>"',
131
+ whenToUse: 'Registry search over knowledge / rules / templates / playbooks. NOT "what should I do?" — for that use `shrk recommend`.',
132
+ safety: 'read-only',
133
+ seeAlso: ['recommend', 'context'],
134
+ },
135
+ ];
136
+ const DECISION_TREE = [
137
+ {
138
+ when: 'You are a HUMAN in a terminal asking "what should I do?"',
139
+ use: 'shrk recommend "<task>"',
140
+ },
141
+ {
142
+ when: 'You are a HUMAN exploring SharkCraft for the first time',
143
+ use: 'shrk start-here',
144
+ },
145
+ {
146
+ when: 'You are an AGENT making your first MCP call for a task',
147
+ use: 'mcp__sharkcraft__prepare_agent_task',
148
+ },
149
+ {
150
+ when: 'You want a MACHINE-readable JSON packet',
151
+ use: 'shrk task "<task>" --json',
152
+ },
153
+ {
154
+ when: 'You are DEBUGGING the ranker / boundary / dispatch',
155
+ use: 'shrk why <id> / shrk graph why <a> <b> / shrk apply <plan> --explain-dispatch',
156
+ },
157
+ ];
158
+ export function buildEntrypointMatrix() {
159
+ return {
160
+ schema: ENTRYPOINT_MATRIX_SCHEMA,
161
+ entries: MATRIX_ENTRIES,
162
+ decisionTree: DECISION_TREE,
163
+ };
164
+ }
165
+ export function renderEntrypointMatrixText(report) {
166
+ const lines = [];
167
+ lines.push('# SharkCraft entrypoint matrix');
168
+ lines.push('');
169
+ lines.push('## When you are …');
170
+ for (const d of report.decisionTree)
171
+ lines.push(` • ${d.when}\n → ${d.use}`);
172
+ lines.push('');
173
+ lines.push('## By class');
174
+ const grouped = new Map();
175
+ for (const e of report.entries) {
176
+ const arr = grouped.get(e.class) ?? [];
177
+ arr.push(e);
178
+ grouped.set(e.class, arr);
179
+ }
180
+ for (const [cls, list] of grouped) {
181
+ lines.push('');
182
+ lines.push(`### ${cls}`);
183
+ for (const e of list) {
184
+ lines.push(` $ ${e.callShape}`);
185
+ lines.push(` ${e.whenToUse}`);
186
+ lines.push(` safety: ${e.safety}${e.docs ? ` docs: ${e.docs}` : ''}`);
187
+ if (e.seeAlso && e.seeAlso.length > 0) {
188
+ lines.push(` see also: ${e.seeAlso.join(', ')}`);
189
+ }
190
+ }
191
+ }
192
+ return lines.join('\n') + '\n';
193
+ }
194
+ /**
195
+ * Short banner each command can print to make its role explicit.
196
+ * Wording aligned with the canonical-entrypoint message so every
197
+ * overlapping surface points back at `shrk recommend` for the
198
+ * "what should I do?" question.
199
+ *
200
+ * shrk recommend — canonical human entrypoint.
201
+ * shrk context — context for doing the task; recommend is the workflow.
202
+ * shrk task — machine/task-packet surface; recommend is the workflow.
203
+ * shrk search — registry search; recommend is the workflow.
204
+ * shrk why — ranker reasoning; recommend is the workflow.
205
+ */
206
+ export function entrypointBanner(id) {
207
+ switch (id) {
208
+ case 'task':
209
+ return 'Entrypoint class: machine-json — task packet for agents / JSON pipes. For human workflow guidance run `shrk recommend "<task>"`. For agent grounding prefer `prepare_agent_task`.';
210
+ case 'task-json':
211
+ return 'Entrypoint class: machine-json (--json). Pipe into another tool; humans usually want `shrk recommend` or `shrk context`.';
212
+ case 'context':
213
+ return 'Entrypoint class: human-interactive — context for doing the task. For step-by-step workflow guidance run `shrk recommend "<task>"`.';
214
+ case 'recommend':
215
+ return 'Entrypoint class: human-interactive — canonical human entrypoint for "what should I do?".';
216
+ case 'search':
217
+ return 'Entrypoint class: machine-json — searches registries/contributions. For workflow guidance run `shrk recommend "<query>"`; for ranking explanation run `shrk why <id> --for-task "<query>"`.';
218
+ case 'why':
219
+ return 'Entrypoint class: debug-explainability — explains ranker decisions. Not the main workflow entrypoint — for that run `shrk recommend`.';
220
+ }
221
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * `shrk examples check` — verify the examples/ tree is sound.
3
+ *
4
+ * Read-only. Verifies:
5
+ * - examples/ exists
6
+ * - each example directory has a package.json
7
+ * - example commands referenced in known scripts are present in the catalog
8
+ * (best-effort)
9
+ * - no destructive commands in any included demo script
10
+ */
11
+ export declare const EXAMPLES_CHECK_SCHEMA = "sharkcraft.examples-check/v1";
12
+ export interface IExamplesCheckFinding {
13
+ code: 'examples-dir-missing' | 'example-missing-package-json' | 'destructive-command-detected' | 'unknown-command-reference' | 'demo-script-unsafe';
14
+ severity: 'info' | 'warning' | 'error';
15
+ message: string;
16
+ file?: string;
17
+ suggestion?: string;
18
+ }
19
+ export interface IExamplesCheckReport {
20
+ schema: typeof EXAMPLES_CHECK_SCHEMA;
21
+ generatedAt: string;
22
+ projectRoot: string;
23
+ examples: readonly {
24
+ name: string;
25
+ path: string;
26
+ hasPackageJson: boolean;
27
+ }[];
28
+ findings: readonly IExamplesCheckFinding[];
29
+ ok: boolean;
30
+ }
31
+ export interface IBuildExamplesCheckOptions {
32
+ knownCommands?: readonly string[];
33
+ }
34
+ export declare function buildExamplesCheck(projectRoot: string, options?: IBuildExamplesCheckOptions): IExamplesCheckReport;
35
+ export declare function renderExamplesCheckText(report: IExamplesCheckReport): string;
36
+ //# sourceMappingURL=examples-check.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"examples-check.d.ts","sourceRoot":"","sources":["../src/examples-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EACA,sBAAsB,GACtB,8BAA8B,GAC9B,8BAA8B,GAC9B,2BAA2B,GAC3B,oBAAoB,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC7E,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,EAAE,EAAE,OAAO,CAAC;CACb;AAiCD,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CAmGtB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAgB5E"}
@@ -0,0 +1,168 @@
1
+ /**
2
+ * `shrk examples check` — verify the examples/ tree is sound.
3
+ *
4
+ * Read-only. Verifies:
5
+ * - examples/ exists
6
+ * - each example directory has a package.json
7
+ * - example commands referenced in known scripts are present in the catalog
8
+ * (best-effort)
9
+ * - no destructive commands in any included demo script
10
+ */
11
+ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
12
+ import * as nodePath from 'node:path';
13
+ export const EXAMPLES_CHECK_SCHEMA = 'sharkcraft.examples-check/v1';
14
+ const DESTRUCTIVE_PATTERNS = [
15
+ /\brm\s+-rf\b/,
16
+ /\brm\s+-fr\b/,
17
+ />\s*\/dev\/null\s*2>&1\s*&&\s*rm\b/,
18
+ /\bdd\s+if=/,
19
+ /\bmkfs\b/,
20
+ ];
21
+ function safeReaddir(dir) {
22
+ try {
23
+ return readdirSync(dir);
24
+ }
25
+ catch {
26
+ return [];
27
+ }
28
+ }
29
+ function listScriptFiles(dir) {
30
+ const out = [];
31
+ for (const entry of safeReaddir(dir)) {
32
+ const full = nodePath.join(dir, entry);
33
+ try {
34
+ const stat = statSync(full);
35
+ if (stat.isDirectory())
36
+ out.push(...listScriptFiles(full));
37
+ else if (entry.endsWith('.sh') || entry.endsWith('.bash'))
38
+ out.push(full);
39
+ }
40
+ catch {
41
+ /* skip */
42
+ }
43
+ }
44
+ return out;
45
+ }
46
+ export function buildExamplesCheck(projectRoot, options = {}) {
47
+ const findings = [];
48
+ const examplesDir = nodePath.join(projectRoot, 'examples');
49
+ const examples = [];
50
+ if (!existsSync(examplesDir)) {
51
+ findings.push({
52
+ code: 'examples-dir-missing',
53
+ severity: 'warning',
54
+ message: 'No examples/ directory found at the project root.',
55
+ suggestion: 'Create at least one example so the demo flow has a target.',
56
+ });
57
+ return {
58
+ schema: EXAMPLES_CHECK_SCHEMA,
59
+ generatedAt: new Date().toISOString(),
60
+ projectRoot,
61
+ examples: [],
62
+ findings,
63
+ ok: false,
64
+ };
65
+ }
66
+ for (const entry of safeReaddir(examplesDir)) {
67
+ const full = nodePath.join(examplesDir, entry);
68
+ try {
69
+ if (!statSync(full).isDirectory())
70
+ continue;
71
+ }
72
+ catch {
73
+ continue;
74
+ }
75
+ const pkg = nodePath.join(full, 'package.json');
76
+ const hasPackageJson = existsSync(pkg);
77
+ if (!hasPackageJson) {
78
+ findings.push({
79
+ code: 'example-missing-package-json',
80
+ severity: 'warning',
81
+ message: `examples/${entry}/ has no package.json.`,
82
+ file: `examples/${entry}/package.json`,
83
+ suggestion: 'Add a package.json so the example resolves as a workspace.',
84
+ });
85
+ }
86
+ examples.push({
87
+ name: entry,
88
+ path: `examples/${entry}`,
89
+ hasPackageJson,
90
+ });
91
+ }
92
+ const scriptFiles = listScriptFiles(examplesDir);
93
+ for (const file of scriptFiles) {
94
+ let body = '';
95
+ try {
96
+ body = readFileSync(file, 'utf8');
97
+ }
98
+ catch {
99
+ continue;
100
+ }
101
+ for (const re of DESTRUCTIVE_PATTERNS) {
102
+ if (re.test(body)) {
103
+ findings.push({
104
+ code: 'destructive-command-detected',
105
+ severity: 'error',
106
+ message: `Destructive command pattern in ${nodePath.relative(projectRoot, file)}`,
107
+ file: nodePath.relative(projectRoot, file),
108
+ suggestion: 'Remove or comment out destructive lines. SharkCraft demos must be safe to run.',
109
+ });
110
+ break;
111
+ }
112
+ }
113
+ if (options.knownCommands && options.knownCommands.length > 0) {
114
+ const re = /\bshrk\s+([\w-]+(?:\s+[\w-]+)?)/g;
115
+ const seen = new Set();
116
+ let m;
117
+ while ((m = re.exec(body))) {
118
+ const cmd = `shrk ${m[1].trim()}`;
119
+ if (seen.has(cmd))
120
+ continue;
121
+ seen.add(cmd);
122
+ let known = false;
123
+ for (const k of options.knownCommands) {
124
+ if (k === cmd || k.startsWith(cmd) || cmd.startsWith(k)) {
125
+ known = true;
126
+ break;
127
+ }
128
+ }
129
+ if (!known) {
130
+ findings.push({
131
+ code: 'unknown-command-reference',
132
+ severity: 'info',
133
+ message: `${nodePath.relative(projectRoot, file)} references "${cmd}" which is not in the command catalog.`,
134
+ file: nodePath.relative(projectRoot, file),
135
+ });
136
+ }
137
+ }
138
+ }
139
+ }
140
+ const ok = findings.filter((f) => f.severity === 'error').length === 0;
141
+ return {
142
+ schema: EXAMPLES_CHECK_SCHEMA,
143
+ generatedAt: new Date().toISOString(),
144
+ projectRoot,
145
+ examples,
146
+ findings,
147
+ ok,
148
+ };
149
+ }
150
+ export function renderExamplesCheckText(report) {
151
+ const lines = [];
152
+ lines.push('# Examples check');
153
+ lines.push(`OK: ${report.ok ? 'yes' : 'no'} · examples: ${report.examples.length}`);
154
+ for (const e of report.examples) {
155
+ lines.push(` - ${e.name} [${e.hasPackageJson ? 'pkg' : 'no pkg'}]`);
156
+ }
157
+ if (report.findings.length === 0)
158
+ lines.push('No findings.');
159
+ else {
160
+ lines.push('Findings:');
161
+ for (const f of report.findings) {
162
+ lines.push(` [${f.severity}] ${f.code}: ${f.message}`);
163
+ if (f.suggestion)
164
+ lines.push(` → ${f.suggestion}`);
165
+ }
166
+ }
167
+ return lines.join('\n') + '\n';
168
+ }
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Task execution graph.
3
+ *
4
+ * Combine intent, risk, memory (when present), contract, constructs,
5
+ * policies, boundaries, playbooks, templates, plans, gates, validations,
6
+ * and reports into a structured graph (nodes + edges). Pure data — no
7
+ * execution, no writes.
8
+ */
9
+ import { type IAgentContract } from './agent-contract.js';
10
+ import { type IMemoryRiskReport } from './repo-memory.js';
11
+ import { type IChangeIntent } from './change-intent.js';
12
+ import { type ITaskRiskReport } from './task-risk.js';
13
+ import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
14
+ export declare const EXECUTION_GRAPH_SCHEMA = "sharkcraft.execution-graph/v1";
15
+ export declare enum ExecutionNodeKind {
16
+ Task = "task",
17
+ Intent = "intent",
18
+ Risk = "risk",
19
+ Memory = "memory",
20
+ Contract = "contract",
21
+ Construct = "construct",
22
+ Policy = "policy",
23
+ Boundary = "boundary",
24
+ Playbook = "playbook",
25
+ Template = "template",
26
+ Plan = "plan",
27
+ ReviewGate = "review-gate",
28
+ HumanApproval = "human-approval",
29
+ Validation = "validation",
30
+ ReportArtifact = "report-artifact",
31
+ Done = "done"
32
+ }
33
+ export declare enum ExecutionEdgeKind {
34
+ Requires = "requires",
35
+ Informs = "informs",
36
+ Blocks = "blocks",
37
+ Validates = "validates",
38
+ Produces = "produces",
39
+ Reviews = "reviews",
40
+ Forbids = "forbids",
41
+ Recommends = "recommends"
42
+ }
43
+ export interface IExecutionNode {
44
+ id: string;
45
+ kind: ExecutionNodeKind;
46
+ label: string;
47
+ detail?: string;
48
+ }
49
+ export interface IExecutionEdge {
50
+ from: string;
51
+ to: string;
52
+ kind: ExecutionEdgeKind;
53
+ detail?: string;
54
+ }
55
+ export interface ITaskExecutionGraph {
56
+ schema: typeof EXECUTION_GRAPH_SCHEMA;
57
+ generatedAt: string;
58
+ task: string;
59
+ role: string;
60
+ mode: string;
61
+ intent: IChangeIntent;
62
+ taskRisk: ITaskRiskReport;
63
+ contract: IAgentContract;
64
+ memoryRisk?: IMemoryRiskReport;
65
+ nodes: readonly IExecutionNode[];
66
+ edges: readonly IExecutionEdge[];
67
+ notes: readonly string[];
68
+ }
69
+ export interface IBuildExecutionGraphOptions {
70
+ role?: string;
71
+ mode?: string;
72
+ files?: readonly string[];
73
+ since?: string;
74
+ staged?: boolean;
75
+ }
76
+ export declare function buildTaskExecutionGraph(task: string, inspection: ISharkcraftInspection, options?: IBuildExecutionGraphOptions): Promise<ITaskExecutionGraph>;
77
+ export declare function renderExecutionGraphText(g: ITaskExecutionGraph): string;
78
+ export declare function renderExecutionGraphMarkdown(g: ITaskExecutionGraph): string;
79
+ export declare function renderExecutionGraphMermaid(g: ITaskExecutionGraph): string;
80
+ export declare function renderExecutionGraphDot(g: ITaskExecutionGraph): string;
81
+ export declare function renderExecutionGraphClusteredDot(g: ITaskExecutionGraph): string;
82
+ export interface IExecutionGraphQueryResult {
83
+ schema: typeof EXECUTION_GRAPH_SCHEMA;
84
+ query: string;
85
+ matchedNodes: readonly IExecutionNode[];
86
+ matchedEdges: readonly IExecutionEdge[];
87
+ notes: readonly string[];
88
+ }
89
+ /**
90
+ * Query syntax (lowercased token before ':'):
91
+ * - blocks:<nodeId> → nodes/edges blocking the named node
92
+ * - kind:<kind> → nodes of that kind
93
+ * - edge:<kind> → edges of that kind
94
+ * - text:<substring> → nodes whose id/label/detail contains substring
95
+ */
96
+ export declare function queryExecutionGraph(graph: ITaskExecutionGraph, query: string): IExecutionGraphQueryResult;
97
+ export declare function renderExecutionGraphHtml(g: ITaskExecutionGraph): string;
98
+ //# sourceMappingURL=execution-graph.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-graph.d.ts","sourceRoot":"","sources":["../src/execution-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2C,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,UAAU,gBAAgB;IAC1B,aAAa,mBAAmB;IAChC,UAAU,eAAe;IACzB,cAAc,oBAAoB;IAClC,IAAI,SAAS;CACd;AAED,oBAAY,iBAAiB;IAC3B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,mBAAmB,CAAC,CA8J9B;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAcvE;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAa3E;AAWD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAS1E;AAUD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAYtE;AAyED,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAkD/E;AAMD,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,MAAM,GACZ,0BAA0B,CA4F5B;AAWD,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CASvE"}