@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,519 @@
1
+ /**
2
+ * Plugin-api symbol compatibility diff.
3
+ *
4
+ * Reads `import { … } from '@shrkcrft/plugin-api'` lines from each pack
5
+ * contribution file, resolves the consumer's installed plugin-api source,
6
+ * and reports which symbols the pack uses that the consumer's plugin-api
7
+ * does not export.
8
+ *
9
+ * Default mode (`'ts'`) walks ESM exports with the TypeScript compiler
10
+ * API — multi-line export blocks, multi-declarator `export const`,
11
+ * `export type { … }`, and transitive `export * from` re-exports are
12
+ * resolved correctly. CJS bundles (`Object.defineProperty(exports, 'X')`,
13
+ * `exports.X = …`) still use the regex scanner, since those shapes don't
14
+ * surface as `ExportDeclaration` nodes in the AST.
15
+ *
16
+ * `mode: 'fast'` falls back to the legacy regex-only scanner — useful
17
+ * when the typescript module can't be loaded or when speed matters more
18
+ * than completeness.
19
+ */
20
+ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
21
+ import * as nodePath from 'node:path';
22
+ import * as ts from 'typescript';
23
+ export const PACK_SYMBOL_COMPAT_SCHEMA = 'sharkcraft.pack-symbol-compat/v1';
24
+ const NAMED_IMPORT_RE = /^\s*import\s*(?:type\s+)?\{([^}]+)\}\s*from\s*['"]@shrkcrft\/plugin-api['"]/;
25
+ const DEFAULT_IMPORT_RE = /^\s*import\s+(\w+)\s*(?:,\s*\{([^}]+)\})?\s*from\s*['"]@shrkcrft\/plugin-api['"]/;
26
+ function listContributionFiles(packPath) {
27
+ const out = [];
28
+ const walk = (dir) => {
29
+ let entries;
30
+ try {
31
+ entries = readdirSync(dir);
32
+ }
33
+ catch {
34
+ return;
35
+ }
36
+ for (const entry of entries) {
37
+ if (entry === 'node_modules' || entry.startsWith('.'))
38
+ continue;
39
+ const full = nodePath.join(dir, entry);
40
+ let stat;
41
+ try {
42
+ stat = statSync(full);
43
+ }
44
+ catch {
45
+ continue;
46
+ }
47
+ if (stat.isDirectory())
48
+ walk(full);
49
+ else if (/\.(ts|tsx|mts|cts|js|mjs|cjs)$/.test(entry) && !entry.endsWith('.d.ts')) {
50
+ out.push(full);
51
+ }
52
+ }
53
+ };
54
+ const srcDir = nodePath.join(packPath, 'src');
55
+ walk(existsSync(srcDir) ? srcDir : packPath);
56
+ return out;
57
+ }
58
+ function extractImports(file) {
59
+ let body;
60
+ try {
61
+ body = readFileSync(file, 'utf8');
62
+ }
63
+ catch {
64
+ return [];
65
+ }
66
+ const names = [];
67
+ for (const raw of body.split(/\r?\n/)) {
68
+ const named = raw.match(NAMED_IMPORT_RE);
69
+ if (named) {
70
+ for (const symbol of named[1].split(',')) {
71
+ const clean = symbol.replace(/\s+as\s+\w+/, '').trim();
72
+ if (clean)
73
+ names.push(clean);
74
+ }
75
+ continue;
76
+ }
77
+ const def = raw.match(DEFAULT_IMPORT_RE);
78
+ if (def) {
79
+ // Default import — track as a symbol name. Plugin-api has no default
80
+ // export today, so this is mostly diagnostic.
81
+ names.push(def[1]);
82
+ if (def[2]) {
83
+ for (const symbol of def[2].split(',')) {
84
+ const clean = symbol.replace(/\s+as\s+\w+/, '').trim();
85
+ if (clean)
86
+ names.push(clean);
87
+ }
88
+ }
89
+ }
90
+ }
91
+ return names;
92
+ }
93
+ function inferSourceMode(rel) {
94
+ if (rel.startsWith('src/'))
95
+ return 'source';
96
+ if (rel.endsWith('.d.ts'))
97
+ return 'declaration';
98
+ if (rel.endsWith('.js') || rel.endsWith('.cjs') || rel.endsWith('.mjs'))
99
+ return 'dist-js';
100
+ return 'fallback';
101
+ }
102
+ function resolvePluginApi(consumerRoot, packPath) {
103
+ const candidates = [];
104
+ if (consumerRoot) {
105
+ candidates.push({
106
+ dir: nodePath.join(consumerRoot, 'node_modules', '@shrkcrft', 'plugin-api'),
107
+ resolution: 'consumer-node-modules',
108
+ });
109
+ }
110
+ candidates.push({
111
+ dir: nodePath.join(packPath, 'node_modules', '@shrkcrft', 'plugin-api'),
112
+ resolution: 'pack-node-modules',
113
+ });
114
+ for (const c of candidates) {
115
+ if (!existsSync(c.dir))
116
+ continue;
117
+ // Prefer the source `src/index.ts` (symlinked monorepo); fall back to
118
+ // `dist/index.js` / `dist/index.d.ts`.
119
+ const choices = [
120
+ 'src/index.ts',
121
+ 'dist/index.d.ts',
122
+ 'dist/index.js',
123
+ 'dist/index.mjs',
124
+ 'dist/index.cjs',
125
+ 'index.d.ts',
126
+ 'index.js',
127
+ 'index.cjs',
128
+ ];
129
+ for (const rel of choices) {
130
+ const full = nodePath.join(c.dir, rel);
131
+ if (existsSync(full)) {
132
+ const resolution = rel.startsWith('src/') && c.resolution === 'consumer-node-modules'
133
+ ? 'consumer-symlink'
134
+ : c.resolution;
135
+ return { source: full, resolution, sourceMode: inferSourceMode(rel) };
136
+ }
137
+ }
138
+ }
139
+ return { source: '', resolution: 'not-found', sourceMode: 'none' };
140
+ }
141
+ /**
142
+ * Collect CJS/UMD-style exports from a built JavaScript bundle.
143
+ * Handles the patterns that bun, tsc, esbuild and rollup emit:
144
+ * - `Object.defineProperty(exports, "X", { ... })`
145
+ * - `exports.X = ...`
146
+ * - `module.exports.X = ...`
147
+ * - `module.exports = { X, Y }`
148
+ * - ESM bundles: `export const X`, `export { X }`, `export function X`
149
+ */
150
+ const CJS_DEFINE_PROP_RE = /Object\.defineProperty\(\s*exports\s*,\s*['"]([A-Za-z_$][\w$]*)['"]/g;
151
+ const CJS_EXPORTS_ASSIGN_RE = /\bexports\s*\.\s*([A-Za-z_$][\w$]*)\s*=/g;
152
+ const CJS_MODULE_EXPORTS_PROP_RE = /\bmodule\s*\.\s*exports\s*\.\s*([A-Za-z_$][\w$]*)\s*=/g;
153
+ const CJS_MODULE_EXPORTS_OBJECT_RE = /\bmodule\s*\.\s*exports\s*=\s*\{([^}]+)\}/;
154
+ function collectJsExports(file) {
155
+ const out = new Set();
156
+ let body;
157
+ try {
158
+ body = readFileSync(file, 'utf8');
159
+ }
160
+ catch {
161
+ return out;
162
+ }
163
+ for (const m of body.matchAll(CJS_DEFINE_PROP_RE)) {
164
+ if (m[1] && m[1] !== '__esModule')
165
+ out.add(m[1]);
166
+ }
167
+ for (const m of body.matchAll(CJS_EXPORTS_ASSIGN_RE)) {
168
+ if (m[1] && m[1] !== '__esModule')
169
+ out.add(m[1]);
170
+ }
171
+ for (const m of body.matchAll(CJS_MODULE_EXPORTS_PROP_RE)) {
172
+ if (m[1] && m[1] !== '__esModule')
173
+ out.add(m[1]);
174
+ }
175
+ const objMatch = body.match(CJS_MODULE_EXPORTS_OBJECT_RE);
176
+ if (objMatch && objMatch[1]) {
177
+ for (const piece of objMatch[1].split(',')) {
178
+ const name = piece.split(':')[0]?.trim();
179
+ if (name && /^[A-Za-z_$][\w$]*$/.test(name))
180
+ out.add(name);
181
+ }
182
+ }
183
+ // Also pick up ESM-style `export const`/`export function`/`export { X }`
184
+ for (const raw of body.split(/\r?\n/)) {
185
+ const named = raw.match(EXPORT_NAMED_RE);
186
+ if (named && named[1])
187
+ out.add(named[1]);
188
+ const block = raw.match(EXPORT_BLOCK_RE);
189
+ if (block && !/from\s+['"]/.test(raw)) {
190
+ for (const symbol of block[1].split(',')) {
191
+ const clean = symbol.replace(/\s+as\s+(\w+)/, '$1').trim();
192
+ if (clean && /^[A-Za-z_$][\w$]*$/.test(clean))
193
+ out.add(clean);
194
+ }
195
+ }
196
+ }
197
+ return out;
198
+ }
199
+ const EXPORT_NAMED_RE = /^\s*export\s+(?:async\s+)?(?:declare\s+)?(?:function|class|interface|enum|type|const|let|var)\s+(\w+)/;
200
+ const EXPORT_BLOCK_RE = /^\s*export\s*\{([^}]+)\}/;
201
+ const RE_EXPORT_RE = /^\s*export\s*\*\s+from\s*['"]([^'"]+)['"]/;
202
+ const RE_EXPORT_NAMED_RE = /^\s*export\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]/;
203
+ function scriptKindFor(file) {
204
+ if (file.endsWith('.tsx'))
205
+ return ts.ScriptKind.TSX;
206
+ if (file.endsWith('.jsx'))
207
+ return ts.ScriptKind.JSX;
208
+ if (file.endsWith('.js') || file.endsWith('.mjs') || file.endsWith('.cjs'))
209
+ return ts.ScriptKind.JS;
210
+ return ts.ScriptKind.TS;
211
+ }
212
+ function hasExportModifier(node) {
213
+ const modifiers = (ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined) ?? [];
214
+ return modifiers.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
215
+ }
216
+ function collectBindingNames(name, out) {
217
+ if (ts.isIdentifier(name)) {
218
+ out.add(name.text);
219
+ return;
220
+ }
221
+ if (ts.isObjectBindingPattern(name) || ts.isArrayBindingPattern(name)) {
222
+ for (const element of name.elements) {
223
+ if (ts.isBindingElement(element)) {
224
+ collectBindingNames(element.name, out);
225
+ }
226
+ }
227
+ }
228
+ }
229
+ /**
230
+ * Walk ESM exports of `file` using the TypeScript compiler API, following
231
+ * `export * from` re-exports transitively. CJS-specific shapes are NOT
232
+ * resolved here — call {@link collectJsExports} alongside for those.
233
+ *
234
+ * Returns an empty set on parse failure so callers can union with the
235
+ * regex fallback.
236
+ */
237
+ function collectExportsTs(file, visited) {
238
+ if (visited.has(file))
239
+ return new Set();
240
+ visited.add(file);
241
+ const out = new Set();
242
+ let body;
243
+ try {
244
+ body = readFileSync(file, 'utf8');
245
+ }
246
+ catch {
247
+ return out;
248
+ }
249
+ let source;
250
+ try {
251
+ source = ts.createSourceFile(file, body, ts.ScriptTarget.Latest, /*setParentNodes*/ false, scriptKindFor(file));
252
+ }
253
+ catch {
254
+ return out;
255
+ }
256
+ for (const stmt of source.statements) {
257
+ if (ts.isExportDeclaration(stmt)) {
258
+ const moduleSpec = stmt.moduleSpecifier && ts.isStringLiteral(stmt.moduleSpecifier) ? stmt.moduleSpecifier.text : null;
259
+ if (!stmt.exportClause) {
260
+ // `export * from '...'` — recurse through the barrel.
261
+ if (moduleSpec) {
262
+ const target = resolveRelative(file, moduleSpec);
263
+ if (target) {
264
+ for (const sym of collectExportsTs(target, visited))
265
+ out.add(sym);
266
+ }
267
+ }
268
+ continue;
269
+ }
270
+ if (ts.isNamedExports(stmt.exportClause)) {
271
+ for (const spec of stmt.exportClause.elements) {
272
+ out.add(spec.name.text);
273
+ }
274
+ continue;
275
+ }
276
+ if (ts.isNamespaceExport(stmt.exportClause)) {
277
+ // `export * as ns from '...'` — the namespace itself is the export.
278
+ out.add(stmt.exportClause.name.text);
279
+ continue;
280
+ }
281
+ }
282
+ else if (ts.isFunctionDeclaration(stmt) && stmt.name && hasExportModifier(stmt)) {
283
+ out.add(stmt.name.text);
284
+ }
285
+ else if (ts.isClassDeclaration(stmt) && stmt.name && hasExportModifier(stmt)) {
286
+ out.add(stmt.name.text);
287
+ }
288
+ else if (ts.isInterfaceDeclaration(stmt) && hasExportModifier(stmt)) {
289
+ out.add(stmt.name.text);
290
+ }
291
+ else if (ts.isTypeAliasDeclaration(stmt) && hasExportModifier(stmt)) {
292
+ out.add(stmt.name.text);
293
+ }
294
+ else if (ts.isEnumDeclaration(stmt) && hasExportModifier(stmt)) {
295
+ out.add(stmt.name.text);
296
+ }
297
+ else if (ts.isModuleDeclaration(stmt) && stmt.name && hasExportModifier(stmt)) {
298
+ if (ts.isIdentifier(stmt.name))
299
+ out.add(stmt.name.text);
300
+ }
301
+ else if (ts.isVariableStatement(stmt) && hasExportModifier(stmt)) {
302
+ for (const decl of stmt.declarationList.declarations) {
303
+ collectBindingNames(decl.name, out);
304
+ }
305
+ }
306
+ }
307
+ return out;
308
+ }
309
+ function collectExports(file, visited) {
310
+ if (visited.has(file))
311
+ return new Set();
312
+ visited.add(file);
313
+ const out = new Set();
314
+ let body;
315
+ try {
316
+ body = readFileSync(file, 'utf8');
317
+ }
318
+ catch {
319
+ return out;
320
+ }
321
+ for (const raw of body.split(/\r?\n/)) {
322
+ const named = raw.match(EXPORT_NAMED_RE);
323
+ if (named) {
324
+ out.add(named[1]);
325
+ continue;
326
+ }
327
+ const block = raw.match(EXPORT_BLOCK_RE);
328
+ if (block && !/from\s+['"]/.test(raw)) {
329
+ for (const symbol of block[1].split(',')) {
330
+ const clean = symbol.replace(/\s+as\s+(\w+)/, '$1').trim();
331
+ if (clean)
332
+ out.add(clean);
333
+ }
334
+ continue;
335
+ }
336
+ const reExport = raw.match(RE_EXPORT_RE);
337
+ if (reExport) {
338
+ const childRel = reExport[1];
339
+ const candidate = resolveRelative(file, childRel);
340
+ if (candidate) {
341
+ for (const symbol of collectExports(candidate, visited))
342
+ out.add(symbol);
343
+ }
344
+ continue;
345
+ }
346
+ const reExportNamed = raw.match(RE_EXPORT_NAMED_RE);
347
+ if (reExportNamed) {
348
+ for (const symbol of reExportNamed[1].split(',')) {
349
+ const clean = symbol.replace(/\s+as\s+(\w+)/, '$1').trim();
350
+ if (clean)
351
+ out.add(clean);
352
+ }
353
+ }
354
+ }
355
+ return out;
356
+ }
357
+ function resolveRelative(fromFile, rel) {
358
+ if (!rel.startsWith('.'))
359
+ return null;
360
+ const base = nodePath.resolve(nodePath.dirname(fromFile), rel);
361
+ const candidates = [
362
+ base, // Verbatim with extension (e.g. './foo.ts' under NodeNext).
363
+ base + '.ts',
364
+ base + '.tsx',
365
+ base + '.d.ts',
366
+ base + '.mts',
367
+ base + '.cts',
368
+ base + '.js',
369
+ base + '.mjs',
370
+ base + '.cjs',
371
+ nodePath.join(base, 'index.ts'),
372
+ nodePath.join(base, 'index.tsx'),
373
+ nodePath.join(base, 'index.d.ts'),
374
+ nodePath.join(base, 'index.mts'),
375
+ nodePath.join(base, 'index.js'),
376
+ nodePath.join(base, 'index.mjs'),
377
+ ];
378
+ for (const c of candidates) {
379
+ if (existsSync(c)) {
380
+ try {
381
+ if (statSync(c).isFile())
382
+ return c;
383
+ }
384
+ catch {
385
+ continue;
386
+ }
387
+ }
388
+ }
389
+ return null;
390
+ }
391
+ function confidenceFor(mode, count) {
392
+ if (mode === 'source' || mode === 'declaration')
393
+ return 'high';
394
+ if (mode === 'dist-js' && count >= 3)
395
+ return 'medium';
396
+ if (mode === 'dist-js')
397
+ return 'low';
398
+ if (mode === 'none')
399
+ return 'low';
400
+ return 'low';
401
+ }
402
+ export function checkPackSymbolCompat(input) {
403
+ const packAbs = nodePath.resolve(input.packPath);
404
+ const consumerRoot = input.consumerRoot ? nodePath.resolve(input.consumerRoot) : null;
405
+ const resolved = resolvePluginApi(consumerRoot, packAbs);
406
+ const filesInspected = [];
407
+ let availableSet = new Set();
408
+ let usedMode = resolved.sourceMode;
409
+ const useTs = (input.mode ?? 'ts') === 'ts';
410
+ if (resolved.source.length > 0) {
411
+ if (resolved.sourceMode === 'dist-js') {
412
+ // CJS shapes only show up in the regex scanner; ESM shapes show up
413
+ // in either. Union the two so a bundle that mixes both is covered.
414
+ availableSet = collectJsExports(resolved.source);
415
+ if (useTs) {
416
+ for (const sym of collectExportsTs(resolved.source, new Set()))
417
+ availableSet.add(sym);
418
+ }
419
+ filesInspected.push(resolved.source);
420
+ }
421
+ else if (useTs) {
422
+ availableSet = collectExportsTs(resolved.source, new Set());
423
+ // Fallback union — if the TS walker returns nothing (parse failure),
424
+ // we still want a best-effort symbol list from the regex scanner.
425
+ if (availableSet.size === 0) {
426
+ availableSet = collectExports(resolved.source, new Set());
427
+ }
428
+ filesInspected.push(resolved.source);
429
+ }
430
+ else {
431
+ availableSet = collectExports(resolved.source, new Set());
432
+ filesInspected.push(resolved.source);
433
+ }
434
+ }
435
+ // Dist-aware mode — when explicitly requested, also scan dist/*.js to
436
+ // pick up exports a declaration file omits.
437
+ if (input.distAware && consumerRoot) {
438
+ const distDir = nodePath.join(consumerRoot, 'node_modules', '@shrkcrft', 'plugin-api', 'dist');
439
+ if (existsSync(distDir)) {
440
+ for (const entry of safeReaddir(distDir)) {
441
+ if (!/\.(js|cjs|mjs)$/.test(entry))
442
+ continue;
443
+ const full = nodePath.join(distDir, entry);
444
+ for (const s of collectJsExports(full))
445
+ availableSet.add(s);
446
+ if (useTs) {
447
+ for (const s of collectExportsTs(full, new Set()))
448
+ availableSet.add(s);
449
+ }
450
+ filesInspected.push(full);
451
+ }
452
+ if (resolved.sourceMode === 'declaration')
453
+ usedMode = 'dist-js';
454
+ }
455
+ }
456
+ const importsByFile = [];
457
+ const symbolToFiles = new Map();
458
+ for (const file of listContributionFiles(packAbs)) {
459
+ const symbols = extractImports(file);
460
+ if (symbols.length === 0)
461
+ continue;
462
+ importsByFile.push({ file, importedSymbols: symbols });
463
+ for (const s of symbols) {
464
+ let list = symbolToFiles.get(s);
465
+ if (!list) {
466
+ list = new Set();
467
+ symbolToFiles.set(s, list);
468
+ }
469
+ list.add(file);
470
+ }
471
+ }
472
+ const findings = [];
473
+ for (const [symbol, files] of symbolToFiles) {
474
+ const status = availableSet.has(symbol) ? 'available' : 'missing';
475
+ findings.push({ symbol, files: [...files], status });
476
+ }
477
+ findings.sort((a, b) => a.symbol.localeCompare(b.symbol));
478
+ const missingSymbols = findings.filter((f) => f.status === 'missing').map((f) => f.symbol);
479
+ const suggestions = [];
480
+ if (missingSymbols.length === 0) {
481
+ if (resolved.resolution === 'not-found') {
482
+ suggestions.push('No installed @shrkcrft/plugin-api was found. Pass --consumer-root to point at the consumer workspace if symbols differ across versions.');
483
+ }
484
+ }
485
+ else {
486
+ suggestions.push(`Pack imports ${missingSymbols.length} symbol(s) that the consumer's @shrkcrft/plugin-api does not export.`);
487
+ suggestions.push(`1. Bump @shrkcrft/plugin-api in the consumer workspace to a version that exports ${missingSymbols
488
+ .slice(0, 4)
489
+ .map((s) => '`' + s + '`')
490
+ .join(', ')}${missingSymbols.length > 4 ? ', …' : ''}.`);
491
+ suggestions.push('2. Widen `peerDependencies."@shrkcrft/plugin-api"` only if those symbols are stable across the range.');
492
+ suggestions.push('3. Replace the helper imports with plain structural object literals (`export default ([...] as const)`).');
493
+ suggestions.push('4. Drop the import entirely if the helper is no longer needed by your contributions.');
494
+ }
495
+ return {
496
+ schema: PACK_SYMBOL_COMPAT_SCHEMA,
497
+ packPath: packAbs,
498
+ consumerRoot,
499
+ pluginApiSource: resolved.source || null,
500
+ pluginApiResolution: resolved.resolution,
501
+ availableSymbols: [...availableSet].sort(),
502
+ findings,
503
+ missingSymbols,
504
+ imports: importsByFile,
505
+ compatible: missingSymbols.length === 0,
506
+ suggestions,
507
+ sourceMode: usedMode,
508
+ confidence: confidenceFor(usedMode, availableSet.size),
509
+ filesInspected,
510
+ };
511
+ }
512
+ function safeReaddir(dir) {
513
+ try {
514
+ return readdirSync(dir);
515
+ }
516
+ catch {
517
+ return [];
518
+ }
519
+ }
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Pack test runner.
3
+ *
4
+ * Test case model: `definePackTest({ id, task, expect*Ids?, mustNotIncludeIds?, maxTokens? })`.
5
+ * Test cases live in either:
6
+ * <packRoot>/sharkcraft/pack-tests.ts
7
+ * <packRoot>/src/assets/pack-tests.ts
8
+ *
9
+ * The runner:
10
+ * 1. Loads the pack tests via dynamic import (Bun handles TS natively).
11
+ * 2. For each test case, builds a task packet against an isolated inspection.
12
+ * 3. Validates the packet contains every `expect*Ids` and none of the
13
+ * `mustNotIncludeIds`, optionally capping the token budget.
14
+ * 4. Emits a structured diagnostic report.
15
+ */
16
+ export interface IPackTestCase {
17
+ id: string;
18
+ task: string;
19
+ description?: string;
20
+ expectKnowledgeIds?: ReadonlyArray<string>;
21
+ expectRuleIds?: ReadonlyArray<string>;
22
+ expectTemplateIds?: ReadonlyArray<string>;
23
+ expectPipelineIds?: ReadonlyArray<string>;
24
+ expectPlaybookIds?: ReadonlyArray<string>;
25
+ expectConstructIds?: ReadonlyArray<string>;
26
+ mustNotIncludeIds?: ReadonlyArray<string>;
27
+ maxTokens?: number;
28
+ }
29
+ export declare function definePackTest<T extends IPackTestCase>(t: T): T;
30
+ export interface IPackTestResult {
31
+ id: string;
32
+ task: string;
33
+ passed: boolean;
34
+ diagnostics: ReadonlyArray<{
35
+ code: 'missing-id' | 'unexpected-id' | 'token-budget' | 'load-error';
36
+ field?: string;
37
+ expected?: string;
38
+ actual?: string;
39
+ suggestion?: string;
40
+ message: string;
41
+ }>;
42
+ tokenEstimate?: number;
43
+ }
44
+ export interface IPackTestReport {
45
+ schema: 'sharkcraft.pack-test-report/v1';
46
+ packPath: string;
47
+ testsFile: string | null;
48
+ ran: number;
49
+ passed: number;
50
+ failed: number;
51
+ cases: ReadonlyArray<IPackTestResult>;
52
+ }
53
+ export declare function runPackTests(input: {
54
+ packPath: string;
55
+ caseId?: string;
56
+ updateSnapshots?: boolean;
57
+ }): Promise<IPackTestReport>;
58
+ export declare function renderPackTestReportText(report: IPackTestReport): string;
59
+ //# sourceMappingURL=pack-test-runner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pack-test-runner.d.ts","sourceRoot":"","sources":["../src/pack-test-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAE/D;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,aAAa,CAAC;QACzB,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,CAAC;QACrE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gCAAgC,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACvC;AA4HD,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,eAAe,CAAC,CAgE3B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAiBxE"}