@shrkcrft/inspector 0.1.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (705) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +15 -0
  3. package/dist/acceptance-replay.d.ts +63 -0
  4. package/dist/acceptance-replay.d.ts.map +1 -0
  5. package/dist/acceptance-replay.js +240 -0
  6. package/dist/action-hint-diagnostics.d.ts +32 -0
  7. package/dist/action-hint-diagnostics.d.ts.map +1 -0
  8. package/dist/action-hint-diagnostics.js +133 -0
  9. package/dist/adoption-check.d.ts +28 -0
  10. package/dist/adoption-check.d.ts.map +1 -0
  11. package/dist/adoption-check.js +181 -0
  12. package/dist/adoption-checkpoint.d.ts +97 -0
  13. package/dist/adoption-checkpoint.d.ts.map +1 -0
  14. package/dist/adoption-checkpoint.js +209 -0
  15. package/dist/adoption-merge-preview.d.ts +28 -0
  16. package/dist/adoption-merge-preview.d.ts.map +1 -0
  17. package/dist/adoption-merge-preview.js +254 -0
  18. package/dist/adoption-report-renderer.d.ts +33 -0
  19. package/dist/adoption-report-renderer.d.ts.map +1 -0
  20. package/dist/adoption-report-renderer.js +257 -0
  21. package/dist/adoption-state.d.ts +100 -0
  22. package/dist/adoption-state.d.ts.map +1 -0
  23. package/dist/adoption-state.js +296 -0
  24. package/dist/adoption-three-way.d.ts +46 -0
  25. package/dist/adoption-three-way.d.ts.map +1 -0
  26. package/dist/adoption-three-way.js +181 -0
  27. package/dist/agent-brief.d.ts +77 -0
  28. package/dist/agent-brief.d.ts.map +1 -0
  29. package/dist/agent-brief.js +490 -0
  30. package/dist/agent-contract-gate.d.ts +108 -0
  31. package/dist/agent-contract-gate.d.ts.map +1 -0
  32. package/dist/agent-contract-gate.js +412 -0
  33. package/dist/agent-contract-templates.d.ts +63 -0
  34. package/dist/agent-contract-templates.d.ts.map +1 -0
  35. package/dist/agent-contract-templates.js +346 -0
  36. package/dist/agent-contract.d.ts +65 -0
  37. package/dist/agent-contract.d.ts.map +1 -0
  38. package/dist/agent-contract.js +555 -0
  39. package/dist/agent-handoff.d.ts +123 -0
  40. package/dist/agent-handoff.d.ts.map +1 -0
  41. package/dist/agent-handoff.js +470 -0
  42. package/dist/agent-instructions.d.ts +2 -0
  43. package/dist/agent-instructions.d.ts.map +1 -0
  44. package/dist/agent-instructions.js +21 -0
  45. package/dist/agent-orchestration.d.ts +61 -0
  46. package/dist/agent-orchestration.d.ts.map +1 -0
  47. package/dist/agent-orchestration.js +285 -0
  48. package/dist/agent-task-prep.d.ts +31 -0
  49. package/dist/agent-task-prep.d.ts.map +1 -0
  50. package/dist/agent-task-prep.js +73 -0
  51. package/dist/ai-readiness.d.ts +30 -0
  52. package/dist/ai-readiness.d.ts.map +1 -0
  53. package/dist/ai-readiness.js +279 -0
  54. package/dist/api-report.d.ts +51 -0
  55. package/dist/api-report.d.ts.map +1 -0
  56. package/dist/api-report.js +254 -0
  57. package/dist/apply-dispatch-trace.d.ts +93 -0
  58. package/dist/apply-dispatch-trace.d.ts.map +1 -0
  59. package/dist/apply-dispatch-trace.js +283 -0
  60. package/dist/apply-gate-result.d.ts +52 -0
  61. package/dist/apply-gate-result.d.ts.map +1 -0
  62. package/dist/apply-gate-result.js +44 -0
  63. package/dist/architecture-map.d.ts +118 -0
  64. package/dist/architecture-map.d.ts.map +1 -0
  65. package/dist/architecture-map.js +543 -0
  66. package/dist/area-explore.d.ts +75 -0
  67. package/dist/area-explore.d.ts.map +1 -0
  68. package/dist/area-explore.js +438 -0
  69. package/dist/area-map.d.ts +43 -0
  70. package/dist/area-map.d.ts.map +1 -0
  71. package/dist/area-map.js +197 -0
  72. package/dist/asset-provenance.d.ts +123 -0
  73. package/dist/asset-provenance.d.ts.map +1 -0
  74. package/dist/asset-provenance.js +209 -0
  75. package/dist/barrel-operations.d.ts +45 -0
  76. package/dist/barrel-operations.d.ts.map +1 -0
  77. package/dist/barrel-operations.js +159 -0
  78. package/dist/boundaries-changed-only.d.ts +62 -0
  79. package/dist/boundaries-changed-only.d.ts.map +1 -0
  80. package/dist/boundaries-changed-only.js +97 -0
  81. package/dist/boundary-suggestions.d.ts +20 -0
  82. package/dist/boundary-suggestions.d.ts.map +1 -0
  83. package/dist/boundary-suggestions.js +51 -0
  84. package/dist/bundle-diff.d.ts +98 -0
  85. package/dist/bundle-diff.d.ts.map +1 -0
  86. package/dist/bundle-diff.js +531 -0
  87. package/dist/bundle-replay.d.ts +68 -0
  88. package/dist/bundle-replay.d.ts.map +1 -0
  89. package/dist/bundle-replay.js +273 -0
  90. package/dist/bundle-validate-html.d.ts +11 -0
  91. package/dist/bundle-validate-html.d.ts.map +1 -0
  92. package/dist/bundle-validate-html.js +60 -0
  93. package/dist/change-intent.d.ts +36 -0
  94. package/dist/change-intent.d.ts.map +1 -0
  95. package/dist/change-intent.js +259 -0
  96. package/dist/changed-preflight.d.ts +59 -0
  97. package/dist/changed-preflight.d.ts.map +1 -0
  98. package/dist/changed-preflight.js +358 -0
  99. package/dist/changed-scope.d.ts +112 -0
  100. package/dist/changed-scope.d.ts.map +1 -0
  101. package/dist/changed-scope.js +172 -0
  102. package/dist/changes-summary.d.ts +87 -0
  103. package/dist/changes-summary.d.ts.map +1 -0
  104. package/dist/changes-summary.js +323 -0
  105. package/dist/check-result-v1.d.ts +90 -0
  106. package/dist/check-result-v1.d.ts.map +1 -0
  107. package/dist/check-result-v1.js +335 -0
  108. package/dist/ci-integrity-report.d.ts +38 -0
  109. package/dist/ci-integrity-report.d.ts.map +1 -0
  110. package/dist/ci-integrity-report.js +324 -0
  111. package/dist/ci-permissions-fix.d.ts +38 -0
  112. package/dist/ci-permissions-fix.d.ts.map +1 -0
  113. package/dist/ci-permissions-fix.js +201 -0
  114. package/dist/ci-permissions.d.ts +51 -0
  115. package/dist/ci-permissions.d.ts.map +1 -0
  116. package/dist/ci-permissions.js +431 -0
  117. package/dist/ci-predict.d.ts +42 -0
  118. package/dist/ci-predict.d.ts.map +1 -0
  119. package/dist/ci-predict.js +300 -0
  120. package/dist/ci-scaffold.d.ts +47 -0
  121. package/dist/ci-scaffold.d.ts.map +1 -0
  122. package/dist/ci-scaffold.js +638 -0
  123. package/dist/codemod-assist.d.ts +97 -0
  124. package/dist/codemod-assist.d.ts.map +1 -0
  125. package/dist/codemod-assist.js +261 -0
  126. package/dist/command-recommender.d.ts +25 -0
  127. package/dist/command-recommender.d.ts.map +1 -0
  128. package/dist/command-recommender.js +145 -0
  129. package/dist/command-suggester.d.ts +61 -0
  130. package/dist/command-suggester.d.ts.map +1 -0
  131. package/dist/command-suggester.js +159 -0
  132. package/dist/command-taxonomy.d.ts +38 -0
  133. package/dist/command-taxonomy.d.ts.map +1 -0
  134. package/dist/command-taxonomy.js +164 -0
  135. package/dist/compliance-evidence.d.ts +58 -0
  136. package/dist/compliance-evidence.d.ts.map +1 -0
  137. package/dist/compliance-evidence.js +260 -0
  138. package/dist/compliance-profiles.d.ts +42 -0
  139. package/dist/compliance-profiles.d.ts.map +1 -0
  140. package/dist/compliance-profiles.js +171 -0
  141. package/dist/construct-adoption-diff.d.ts +55 -0
  142. package/dist/construct-adoption-diff.d.ts.map +1 -0
  143. package/dist/construct-adoption-diff.js +331 -0
  144. package/dist/construct-adoption.d.ts +71 -0
  145. package/dist/construct-adoption.d.ts.map +1 -0
  146. package/dist/construct-adoption.js +331 -0
  147. package/dist/construct-inference.d.ts +44 -0
  148. package/dist/construct-inference.d.ts.map +1 -0
  149. package/dist/construct-inference.js +391 -0
  150. package/dist/construct-registry.d.ts +32 -0
  151. package/dist/construct-registry.d.ts.map +1 -0
  152. package/dist/construct-registry.js +198 -0
  153. package/dist/contract-file-rule.d.ts +37 -0
  154. package/dist/contract-file-rule.d.ts.map +1 -0
  155. package/dist/contract-file-rule.js +99 -0
  156. package/dist/contract-template-registry.d.ts +28 -0
  157. package/dist/contract-template-registry.d.ts.map +1 -0
  158. package/dist/contract-template-registry.js +161 -0
  159. package/dist/contradictions.d.ts +52 -0
  160. package/dist/contradictions.d.ts.map +1 -0
  161. package/dist/contradictions.js +391 -0
  162. package/dist/convention-registry.d.ts +44 -0
  163. package/dist/convention-registry.d.ts.map +1 -0
  164. package/dist/convention-registry.js +195 -0
  165. package/dist/coverage-report.d.ts +25 -0
  166. package/dist/coverage-report.d.ts.map +1 -0
  167. package/dist/coverage-report.js +190 -0
  168. package/dist/custom-checks.d.ts +146 -0
  169. package/dist/custom-checks.d.ts.map +1 -0
  170. package/dist/custom-checks.js +260 -0
  171. package/dist/dashboard/dashboard-data.d.ts +59 -0
  172. package/dist/dashboard/dashboard-data.d.ts.map +1 -0
  173. package/dist/dashboard/dashboard-data.js +653 -0
  174. package/dist/dashboard-export.d.ts +67 -0
  175. package/dist/dashboard-export.d.ts.map +1 -0
  176. package/dist/dashboard-export.js +203 -0
  177. package/dist/decision-records.d.ts +47 -0
  178. package/dist/decision-records.d.ts.map +1 -0
  179. package/dist/decision-records.js +255 -0
  180. package/dist/demo-package.d.ts +49 -0
  181. package/dist/demo-package.d.ts.map +1 -0
  182. package/dist/demo-package.js +305 -0
  183. package/dist/demo-script.d.ts +25 -0
  184. package/dist/demo-script.d.ts.map +1 -0
  185. package/dist/demo-script.js +198 -0
  186. package/dist/demo-workflow.d.ts +28 -0
  187. package/dist/demo-workflow.d.ts.map +1 -0
  188. package/dist/demo-workflow.js +178 -0
  189. package/dist/dev-cycle.d.ts +41 -0
  190. package/dist/dev-cycle.d.ts.map +1 -0
  191. package/dist/dev-cycle.js +94 -0
  192. package/dist/dev-session-html.d.ts +13 -0
  193. package/dist/dev-session-html.d.ts.map +1 -0
  194. package/dist/dev-session-html.js +223 -0
  195. package/dist/dev-session-report.d.ts +11 -0
  196. package/dist/dev-session-report.d.ts.map +1 -0
  197. package/dist/dev-session-report.js +206 -0
  198. package/dist/dev-session.d.ts +257 -0
  199. package/dist/dev-session.d.ts.map +1 -0
  200. package/dist/dev-session.js +568 -0
  201. package/dist/diagnostics-suggest.d.ts +17 -0
  202. package/dist/diagnostics-suggest.d.ts.map +1 -0
  203. package/dist/diagnostics-suggest.js +69 -0
  204. package/dist/docs-check.d.ts +40 -0
  205. package/dist/docs-check.d.ts.map +1 -0
  206. package/dist/docs-check.js +221 -0
  207. package/dist/doctor-acknowledgements.d.ts +69 -0
  208. package/dist/doctor-acknowledgements.d.ts.map +1 -0
  209. package/dist/doctor-acknowledgements.js +150 -0
  210. package/dist/doctor-result.d.ts +51 -0
  211. package/dist/doctor-result.d.ts.map +1 -0
  212. package/dist/doctor-result.js +7 -0
  213. package/dist/doctor-suppressions.d.ts +91 -0
  214. package/dist/doctor-suppressions.d.ts.map +1 -0
  215. package/dist/doctor-suppressions.js +238 -0
  216. package/dist/drift-baseline.d.ts +29 -0
  217. package/dist/drift-baseline.d.ts.map +1 -0
  218. package/dist/drift-baseline.js +80 -0
  219. package/dist/drift.d.ts +38 -0
  220. package/dist/drift.d.ts.map +1 -0
  221. package/dist/drift.js +107 -0
  222. package/dist/entrypoint-matrix.d.ts +61 -0
  223. package/dist/entrypoint-matrix.d.ts.map +1 -0
  224. package/dist/entrypoint-matrix.js +221 -0
  225. package/dist/examples-check.d.ts +36 -0
  226. package/dist/examples-check.d.ts.map +1 -0
  227. package/dist/examples-check.js +168 -0
  228. package/dist/execution-graph.d.ts +98 -0
  229. package/dist/execution-graph.d.ts.map +1 -0
  230. package/dist/execution-graph.js +484 -0
  231. package/dist/export-bundle.d.ts +10 -0
  232. package/dist/export-bundle.d.ts.map +1 -0
  233. package/dist/export-bundle.js +90 -0
  234. package/dist/failure-diagnostics.d.ts +63 -0
  235. package/dist/failure-diagnostics.d.ts.map +1 -0
  236. package/dist/failure-diagnostics.js +243 -0
  237. package/dist/feature-bundle.d.ts +111 -0
  238. package/dist/feature-bundle.d.ts.map +1 -0
  239. package/dist/feature-bundle.js +211 -0
  240. package/dist/feedback-actions-v2.d.ts +65 -0
  241. package/dist/feedback-actions-v2.d.ts.map +1 -0
  242. package/dist/feedback-actions-v2.js +183 -0
  243. package/dist/feedback-ingestion.d.ts +96 -0
  244. package/dist/feedback-ingestion.d.ts.map +1 -0
  245. package/dist/feedback-ingestion.js +400 -0
  246. package/dist/fix-preview.d.ts +82 -0
  247. package/dist/fix-preview.d.ts.map +1 -0
  248. package/dist/fix-preview.js +365 -0
  249. package/dist/fuzzy-impact.d.ts +50 -0
  250. package/dist/fuzzy-impact.d.ts.map +1 -0
  251. package/dist/fuzzy-impact.js +446 -0
  252. package/dist/generated-code.d.ts +97 -0
  253. package/dist/generated-code.d.ts.map +1 -0
  254. package/dist/generated-code.js +395 -0
  255. package/dist/git-helpers.d.ts +26 -0
  256. package/dist/git-helpers.d.ts.map +1 -0
  257. package/dist/git-helpers.js +110 -0
  258. package/dist/golden-output.d.ts +33 -0
  259. package/dist/golden-output.d.ts.map +1 -0
  260. package/dist/golden-output.js +92 -0
  261. package/dist/grounding/build-grounding.d.ts +53 -0
  262. package/dist/grounding/build-grounding.d.ts.map +1 -0
  263. package/dist/grounding/build-grounding.js +51 -0
  264. package/dist/grounding/nx-projects.d.ts +29 -0
  265. package/dist/grounding/nx-projects.d.ts.map +1 -0
  266. package/dist/grounding/nx-projects.js +109 -0
  267. package/dist/grounding/validate-extracted-plan.d.ts +20 -0
  268. package/dist/grounding/validate-extracted-plan.d.ts.map +1 -0
  269. package/dist/grounding/validate-extracted-plan.js +127 -0
  270. package/dist/healing-plan.d.ts +33 -0
  271. package/dist/healing-plan.d.ts.map +1 -0
  272. package/dist/healing-plan.js +346 -0
  273. package/dist/helper-registry.d.ts +90 -0
  274. package/dist/helper-registry.d.ts.map +1 -0
  275. package/dist/helper-registry.js +529 -0
  276. package/dist/impact-analysis.d.ts +150 -0
  277. package/dist/impact-analysis.d.ts.map +1 -0
  278. package/dist/impact-analysis.js +697 -0
  279. package/dist/impact-graph-render.d.ts +51 -0
  280. package/dist/impact-graph-render.d.ts.map +1 -0
  281. package/dist/impact-graph-render.js +139 -0
  282. package/dist/impact-graph.d.ts +17 -0
  283. package/dist/impact-graph.d.ts.map +1 -0
  284. package/dist/impact-graph.js +119 -0
  285. package/dist/impact-render.d.ts +22 -0
  286. package/dist/impact-render.d.ts.map +1 -0
  287. package/dist/impact-render.js +413 -0
  288. package/dist/import-graph-analysis.d.ts +28 -0
  289. package/dist/import-graph-analysis.d.ts.map +1 -0
  290. package/dist/import-graph-analysis.js +193 -0
  291. package/dist/import-hygiene.d.ts +93 -0
  292. package/dist/import-hygiene.d.ts.map +1 -0
  293. package/dist/import-hygiene.js +366 -0
  294. package/dist/index.d.ts +223 -0
  295. package/dist/index.d.ts.map +1 -0
  296. package/dist/index.js +233 -0
  297. package/dist/ingest-adoption.d.ts +50 -0
  298. package/dist/ingest-adoption.d.ts.map +1 -0
  299. package/dist/ingest-adoption.js +183 -0
  300. package/dist/ingest-apply.d.ts +80 -0
  301. package/dist/ingest-apply.d.ts.map +1 -0
  302. package/dist/ingest-apply.js +227 -0
  303. package/dist/ingest-body-extractor.d.ts +28 -0
  304. package/dist/ingest-body-extractor.d.ts.map +1 -0
  305. package/dist/ingest-body-extractor.js +129 -0
  306. package/dist/ingest-drafts.d.ts +16 -0
  307. package/dist/ingest-drafts.d.ts.map +1 -0
  308. package/dist/ingest-drafts.js +482 -0
  309. package/dist/inspector-cache.d.ts +41 -0
  310. package/dist/inspector-cache.d.ts.map +1 -0
  311. package/dist/inspector-cache.js +104 -0
  312. package/dist/install-smoke.d.ts +44 -0
  313. package/dist/install-smoke.d.ts.map +1 -0
  314. package/dist/install-smoke.js +31 -0
  315. package/dist/knowledge-authoring.d.ts +151 -0
  316. package/dist/knowledge-authoring.d.ts.map +1 -0
  317. package/dist/knowledge-authoring.js +586 -0
  318. package/dist/knowledge-graph.d.ts +76 -0
  319. package/dist/knowledge-graph.d.ts.map +1 -0
  320. package/dist/knowledge-graph.js +336 -0
  321. package/dist/knowledge-lint.d.ts +97 -0
  322. package/dist/knowledge-lint.d.ts.map +1 -0
  323. package/dist/knowledge-lint.js +302 -0
  324. package/dist/knowledge-rename.d.ts +38 -0
  325. package/dist/knowledge-rename.d.ts.map +1 -0
  326. package/dist/knowledge-rename.js +88 -0
  327. package/dist/knowledge-stale.d.ts +124 -0
  328. package/dist/knowledge-stale.d.ts.map +1 -0
  329. package/dist/knowledge-stale.js +892 -0
  330. package/dist/languages/command-inference.d.ts +27 -0
  331. package/dist/languages/command-inference.d.ts.map +1 -0
  332. package/dist/languages/command-inference.js +214 -0
  333. package/dist/languages/dependency-scan.d.ts +33 -0
  334. package/dist/languages/dependency-scan.d.ts.map +1 -0
  335. package/dist/languages/dependency-scan.js +343 -0
  336. package/dist/languages/index.d.ts +14 -0
  337. package/dist/languages/index.d.ts.map +1 -0
  338. package/dist/languages/index.js +13 -0
  339. package/dist/languages/language-boundaries.d.ts +30 -0
  340. package/dist/languages/language-boundaries.d.ts.map +1 -0
  341. package/dist/languages/language-boundaries.js +176 -0
  342. package/dist/languages/language-cache.d.ts +54 -0
  343. package/dist/languages/language-cache.d.ts.map +1 -0
  344. package/dist/languages/language-cache.js +236 -0
  345. package/dist/languages/language-detection.d.ts +30 -0
  346. package/dist/languages/language-detection.d.ts.map +1 -0
  347. package/dist/languages/language-detection.js +584 -0
  348. package/dist/languages/language-id.d.ts +15 -0
  349. package/dist/languages/language-id.d.ts.map +1 -0
  350. package/dist/languages/language-id.js +15 -0
  351. package/dist/languages/language-runner.d.ts +90 -0
  352. package/dist/languages/language-runner.d.ts.map +1 -0
  353. package/dist/languages/language-runner.js +346 -0
  354. package/dist/languages/polyglot-boundary.d.ts +80 -0
  355. package/dist/languages/polyglot-boundary.d.ts.map +1 -0
  356. package/dist/languages/polyglot-boundary.js +373 -0
  357. package/dist/languages/polyglot-ci.d.ts +25 -0
  358. package/dist/languages/polyglot-ci.d.ts.map +1 -0
  359. package/dist/languages/polyglot-ci.js +278 -0
  360. package/dist/languages/test-impact.d.ts +19 -0
  361. package/dist/languages/test-impact.d.ts.map +1 -0
  362. package/dist/languages/test-impact.js +157 -0
  363. package/dist/loader-diagnostics.d.ts +40 -0
  364. package/dist/loader-diagnostics.d.ts.map +1 -0
  365. package/dist/loader-diagnostics.js +49 -0
  366. package/dist/memory-diff.d.ts +60 -0
  367. package/dist/memory-diff.d.ts.map +1 -0
  368. package/dist/memory-diff.js +302 -0
  369. package/dist/migration-profile-registry.d.ts +26 -0
  370. package/dist/migration-profile-registry.d.ts.map +1 -0
  371. package/dist/migration-profile-registry.js +135 -0
  372. package/dist/migration-readiness.d.ts +101 -0
  373. package/dist/migration-readiness.d.ts.map +1 -0
  374. package/dist/migration-readiness.js +253 -0
  375. package/dist/monorepo-onboarding.d.ts +51 -0
  376. package/dist/monorepo-onboarding.d.ts.map +1 -0
  377. package/dist/monorepo-onboarding.js +235 -0
  378. package/dist/onboarding-adoption-diff.d.ts +53 -0
  379. package/dist/onboarding-adoption-diff.d.ts.map +1 -0
  380. package/dist/onboarding-adoption-diff.js +285 -0
  381. package/dist/onboarding-adoption.d.ts +136 -0
  382. package/dist/onboarding-adoption.d.ts.map +1 -0
  383. package/dist/onboarding-adoption.js +702 -0
  384. package/dist/onboarding-agent-import.d.ts +40 -0
  385. package/dist/onboarding-agent-import.d.ts.map +1 -0
  386. package/dist/onboarding-agent-import.js +114 -0
  387. package/dist/onboarding-diff.d.ts +39 -0
  388. package/dist/onboarding-diff.d.ts.map +1 -0
  389. package/dist/onboarding-diff.js +240 -0
  390. package/dist/onboarding-drafts.d.ts +28 -0
  391. package/dist/onboarding-drafts.d.ts.map +1 -0
  392. package/dist/onboarding-drafts.js +234 -0
  393. package/dist/onboarding-report.d.ts +8 -0
  394. package/dist/onboarding-report.d.ts.map +1 -0
  395. package/dist/onboarding-report.js +239 -0
  396. package/dist/onboarding.d.ts +134 -0
  397. package/dist/onboarding.d.ts.map +1 -0
  398. package/dist/onboarding.js +729 -0
  399. package/dist/ownership.d.ts +38 -0
  400. package/dist/ownership.d.ts.map +1 -0
  401. package/dist/ownership.js +102 -0
  402. package/dist/pack-author-ux.d.ts +58 -0
  403. package/dist/pack-author-ux.d.ts.map +1 -0
  404. package/dist/pack-author-ux.js +219 -0
  405. package/dist/pack-author.d.ts +94 -0
  406. package/dist/pack-author.d.ts.map +1 -0
  407. package/dist/pack-author.js +208 -0
  408. package/dist/pack-compatibility.d.ts +21 -0
  409. package/dist/pack-compatibility.d.ts.map +1 -0
  410. package/dist/pack-compatibility.js +114 -0
  411. package/dist/pack-contributions-inventory.d.ts +121 -0
  412. package/dist/pack-contributions-inventory.d.ts.map +1 -0
  413. package/dist/pack-contributions-inventory.js +732 -0
  414. package/dist/pack-docs.d.ts +11 -0
  415. package/dist/pack-docs.d.ts.map +1 -0
  416. package/dist/pack-docs.js +101 -0
  417. package/dist/pack-doctor.d.ts +50 -0
  418. package/dist/pack-doctor.d.ts.map +1 -0
  419. package/dist/pack-doctor.js +302 -0
  420. package/dist/pack-helper-registry.d.ts +29 -0
  421. package/dist/pack-helper-registry.d.ts.map +1 -0
  422. package/dist/pack-helper-registry.js +144 -0
  423. package/dist/pack-pending.d.ts +68 -0
  424. package/dist/pack-pending.d.ts.map +1 -0
  425. package/dist/pack-pending.js +189 -0
  426. package/dist/pack-quality-score.d.ts +44 -0
  427. package/dist/pack-quality-score.d.ts.map +1 -0
  428. package/dist/pack-quality-score.js +155 -0
  429. package/dist/pack-release-check.d.ts +24 -0
  430. package/dist/pack-release-check.d.ts.map +1 -0
  431. package/dist/pack-release-check.js +258 -0
  432. package/dist/pack-signature-status.d.ts +72 -0
  433. package/dist/pack-signature-status.d.ts.map +1 -0
  434. package/dist/pack-signature-status.js +222 -0
  435. package/dist/pack-symbol-compat.d.ts +60 -0
  436. package/dist/pack-symbol-compat.d.ts.map +1 -0
  437. package/dist/pack-symbol-compat.js +371 -0
  438. package/dist/pack-test-runner.d.ts +59 -0
  439. package/dist/pack-test-runner.d.ts.map +1 -0
  440. package/dist/pack-test-runner.js +211 -0
  441. package/dist/pipeline-command-dictionary.d.ts +2 -0
  442. package/dist/pipeline-command-dictionary.d.ts.map +1 -0
  443. package/dist/pipeline-command-dictionary.js +20 -0
  444. package/dist/pipeline-lint.d.ts +30 -0
  445. package/dist/pipeline-lint.d.ts.map +1 -0
  446. package/dist/pipeline-lint.js +134 -0
  447. package/dist/plan-dependency-graph.d.ts +25 -0
  448. package/dist/plan-dependency-graph.d.ts.map +1 -0
  449. package/dist/plan-dependency-graph.js +195 -0
  450. package/dist/plan-review.d.ts +64 -0
  451. package/dist/plan-review.d.ts.map +1 -0
  452. package/dist/plan-review.js +242 -0
  453. package/dist/plan-simulation.d.ts +108 -0
  454. package/dist/plan-simulation.d.ts.map +1 -0
  455. package/dist/plan-simulation.js +767 -0
  456. package/dist/playbook-registry.d.ts +25 -0
  457. package/dist/playbook-registry.d.ts.map +1 -0
  458. package/dist/playbook-registry.js +148 -0
  459. package/dist/playbook-script.d.ts +60 -0
  460. package/dist/playbook-script.d.ts.map +1 -0
  461. package/dist/playbook-script.js +161 -0
  462. package/dist/plugin-lifecycle-profile-registry.d.ts +52 -0
  463. package/dist/plugin-lifecycle-profile-registry.d.ts.map +1 -0
  464. package/dist/plugin-lifecycle-profile-registry.js +202 -0
  465. package/dist/plugin-lifecycle.d.ts +132 -0
  466. package/dist/plugin-lifecycle.d.ts.map +1 -0
  467. package/dist/plugin-lifecycle.js +477 -0
  468. package/dist/policy-engine.d.ts +101 -0
  469. package/dist/policy-engine.d.ts.map +1 -0
  470. package/dist/policy-engine.js +321 -0
  471. package/dist/policy-override-audit.d.ts +18 -0
  472. package/dist/policy-override-audit.d.ts.map +1 -0
  473. package/dist/policy-override-audit.js +54 -0
  474. package/dist/policy-overrides.d.ts +35 -0
  475. package/dist/policy-overrides.d.ts.map +1 -0
  476. package/dist/policy-overrides.js +84 -0
  477. package/dist/policy-test.d.ts +83 -0
  478. package/dist/policy-test.d.ts.map +1 -0
  479. package/dist/policy-test.js +342 -0
  480. package/dist/pr-summary.d.ts +34 -0
  481. package/dist/pr-summary.d.ts.map +1 -0
  482. package/dist/pr-summary.js +220 -0
  483. package/dist/product-coherence.d.ts +21 -0
  484. package/dist/product-coherence.d.ts.map +1 -0
  485. package/dist/product-coherence.js +158 -0
  486. package/dist/profile-registry.d.ts +42 -0
  487. package/dist/profile-registry.d.ts.map +1 -0
  488. package/dist/profile-registry.js +104 -0
  489. package/dist/project-coupling-audit.d.ts +64 -0
  490. package/dist/project-coupling-audit.d.ts.map +1 -0
  491. package/dist/project-coupling-audit.js +282 -0
  492. package/dist/project-overview.d.ts +14 -0
  493. package/dist/project-overview.d.ts.map +1 -0
  494. package/dist/project-overview.js +27 -0
  495. package/dist/propose-knowledge.d.ts +64 -0
  496. package/dist/propose-knowledge.d.ts.map +1 -0
  497. package/dist/propose-knowledge.js +367 -0
  498. package/dist/quality-baseline.d.ts +123 -0
  499. package/dist/quality-baseline.d.ts.map +1 -0
  500. package/dist/quality-baseline.js +433 -0
  501. package/dist/quality-html.d.ts +7 -0
  502. package/dist/quality-html.d.ts.map +1 -0
  503. package/dist/quality-html.js +64 -0
  504. package/dist/quality-report.d.ts +49 -0
  505. package/dist/quality-report.d.ts.map +1 -0
  506. package/dist/quality-report.js +296 -0
  507. package/dist/query-resolver.d.ts +38 -0
  508. package/dist/query-resolver.d.ts.map +1 -0
  509. package/dist/query-resolver.js +163 -0
  510. package/dist/ranker-explainability.d.ts +91 -0
  511. package/dist/ranker-explainability.d.ts.map +1 -0
  512. package/dist/ranker-explainability.js +550 -0
  513. package/dist/reference-lookup.d.ts +8 -0
  514. package/dist/reference-lookup.d.ts.map +1 -0
  515. package/dist/reference-lookup.js +18 -0
  516. package/dist/registration-hint-registry.d.ts +55 -0
  517. package/dist/registration-hint-registry.d.ts.map +1 -0
  518. package/dist/registration-hint-registry.js +327 -0
  519. package/dist/registry-lifecycle.d.ts +47 -0
  520. package/dist/registry-lifecycle.d.ts.map +1 -0
  521. package/dist/registry-lifecycle.js +214 -0
  522. package/dist/release-readiness.d.ts +64 -0
  523. package/dist/release-readiness.d.ts.map +1 -0
  524. package/dist/release-readiness.js +456 -0
  525. package/dist/release-smoke.d.ts +138 -0
  526. package/dist/release-smoke.d.ts.map +1 -0
  527. package/dist/release-smoke.js +459 -0
  528. package/dist/release-train.d.ts +33 -0
  529. package/dist/release-train.d.ts.map +1 -0
  530. package/dist/release-train.js +104 -0
  531. package/dist/repo-memory.d.ts +95 -0
  532. package/dist/repo-memory.d.ts.map +1 -0
  533. package/dist/repo-memory.js +614 -0
  534. package/dist/report-site.d.ts +92 -0
  535. package/dist/report-site.d.ts.map +1 -0
  536. package/dist/report-site.js +658 -0
  537. package/dist/reposet.d.ts +56 -0
  538. package/dist/reposet.d.ts.map +1 -0
  539. package/dist/reposet.js +160 -0
  540. package/dist/repository-intelligence.d.ts +145 -0
  541. package/dist/repository-intelligence.d.ts.map +1 -0
  542. package/dist/repository-intelligence.js +729 -0
  543. package/dist/repository-knowledge-model.d.ts +218 -0
  544. package/dist/repository-knowledge-model.d.ts.map +1 -0
  545. package/dist/repository-knowledge-model.js +939 -0
  546. package/dist/repository-map.d.ts +72 -0
  547. package/dist/repository-map.d.ts.map +1 -0
  548. package/dist/repository-map.js +332 -0
  549. package/dist/repository-stats.d.ts +66 -0
  550. package/dist/repository-stats.d.ts.map +1 -0
  551. package/dist/repository-stats.js +329 -0
  552. package/dist/review-comment-renderer.d.ts +59 -0
  553. package/dist/review-comment-renderer.d.ts.map +1 -0
  554. package/dist/review-comment-renderer.js +181 -0
  555. package/dist/review-comment-v2.d.ts +9 -0
  556. package/dist/review-comment-v2.d.ts.map +1 -0
  557. package/dist/review-comment-v2.js +178 -0
  558. package/dist/review-html.d.ts +13 -0
  559. package/dist/review-html.d.ts.map +1 -0
  560. package/dist/review-html.js +79 -0
  561. package/dist/review-packet-v2.d.ts +29 -0
  562. package/dist/review-packet-v2.d.ts.map +1 -0
  563. package/dist/review-packet-v2.js +71 -0
  564. package/dist/review-packet-v3.d.ts +22 -0
  565. package/dist/review-packet-v3.d.ts.map +1 -0
  566. package/dist/review-packet-v3.js +181 -0
  567. package/dist/review-packet.d.ts +49 -0
  568. package/dist/review-packet.d.ts.map +1 -0
  569. package/dist/review-packet.js +129 -0
  570. package/dist/risk-signals.d.ts +28 -0
  571. package/dist/risk-signals.d.ts.map +1 -0
  572. package/dist/risk-signals.js +68 -0
  573. package/dist/role-views.d.ts +50 -0
  574. package/dist/role-views.d.ts.map +1 -0
  575. package/dist/role-views.js +334 -0
  576. package/dist/rounds.d.ts +52 -0
  577. package/dist/rounds.d.ts.map +1 -0
  578. package/dist/rounds.js +172 -0
  579. package/dist/rule-drift.d.ts +42 -0
  580. package/dist/rule-drift.d.ts.map +1 -0
  581. package/dist/rule-drift.js +148 -0
  582. package/dist/rule-quality.d.ts +73 -0
  583. package/dist/rule-quality.d.ts.map +1 -0
  584. package/dist/rule-quality.js +356 -0
  585. package/dist/rule-scaffold.d.ts +71 -0
  586. package/dist/rule-scaffold.d.ts.map +1 -0
  587. package/dist/rule-scaffold.js +258 -0
  588. package/dist/safety-audit-deep.d.ts +38 -0
  589. package/dist/safety-audit-deep.d.ts.map +1 -0
  590. package/dist/safety-audit-deep.js +162 -0
  591. package/dist/safety-audit.d.ts +91 -0
  592. package/dist/safety-audit.d.ts.map +1 -0
  593. package/dist/safety-audit.js +138 -0
  594. package/dist/safety-html.d.ts +7 -0
  595. package/dist/safety-html.d.ts.map +1 -0
  596. package/dist/safety-html.js +70 -0
  597. package/dist/scaffold-coverage.d.ts +46 -0
  598. package/dist/scaffold-coverage.d.ts.map +1 -0
  599. package/dist/scaffold-coverage.js +273 -0
  600. package/dist/scaffold-patterns.d.ts +38 -0
  601. package/dist/scaffold-patterns.d.ts.map +1 -0
  602. package/dist/scaffold-patterns.js +282 -0
  603. package/dist/schema-inventory.d.ts +55 -0
  604. package/dist/schema-inventory.d.ts.map +1 -0
  605. package/dist/schema-inventory.js +301 -0
  606. package/dist/search-index.d.ts +75 -0
  607. package/dist/search-index.d.ts.map +1 -0
  608. package/dist/search-index.js +531 -0
  609. package/dist/search-tuning-explain.d.ts +68 -0
  610. package/dist/search-tuning-explain.d.ts.map +1 -0
  611. package/dist/search-tuning-explain.js +207 -0
  612. package/dist/search-tuning-registry.d.ts +54 -0
  613. package/dist/search-tuning-registry.d.ts.map +1 -0
  614. package/dist/search-tuning-registry.js +303 -0
  615. package/dist/self-audit.d.ts +59 -0
  616. package/dist/self-audit.d.ts.map +1 -0
  617. package/dist/self-audit.js +192 -0
  618. package/dist/self-config-doctor-v2.d.ts +57 -0
  619. package/dist/self-config-doctor-v2.d.ts.map +1 -0
  620. package/dist/self-config-doctor-v2.js +653 -0
  621. package/dist/self-config-doctor.d.ts +47 -0
  622. package/dist/self-config-doctor.d.ts.map +1 -0
  623. package/dist/self-config-doctor.js +432 -0
  624. package/dist/sharkcraft-inspector.d.ts +73 -0
  625. package/dist/sharkcraft-inspector.d.ts.map +1 -0
  626. package/dist/sharkcraft-inspector.js +745 -0
  627. package/dist/spec/spec-cross-validate.d.ts +17 -0
  628. package/dist/spec/spec-cross-validate.d.ts.map +1 -0
  629. package/dist/spec/spec-cross-validate.js +53 -0
  630. package/dist/spec/spec-discovery.d.ts +27 -0
  631. package/dist/spec/spec-discovery.d.ts.map +1 -0
  632. package/dist/spec/spec-discovery.js +78 -0
  633. package/dist/spec/spec-review.d.ts +36 -0
  634. package/dist/spec/spec-review.d.ts.map +1 -0
  635. package/dist/spec/spec-review.js +37 -0
  636. package/dist/stability-map.d.ts +62 -0
  637. package/dist/stability-map.d.ts.map +1 -0
  638. package/dist/stability-map.js +404 -0
  639. package/dist/start-here.d.ts +49 -0
  640. package/dist/start-here.d.ts.map +1 -0
  641. package/dist/start-here.js +259 -0
  642. package/dist/surface-profile-detect.d.ts +42 -0
  643. package/dist/surface-profile-detect.d.ts.map +1 -0
  644. package/dist/surface-profile-detect.js +76 -0
  645. package/dist/symbol-index.d.ts +108 -0
  646. package/dist/symbol-index.d.ts.map +1 -0
  647. package/dist/symbol-index.js +483 -0
  648. package/dist/task-decompose.d.ts +38 -0
  649. package/dist/task-decompose.d.ts.map +1 -0
  650. package/dist/task-decompose.js +154 -0
  651. package/dist/task-packet.d.ts +104 -0
  652. package/dist/task-packet.d.ts.map +1 -0
  653. package/dist/task-packet.js +156 -0
  654. package/dist/task-ranker.d.ts +51 -0
  655. package/dist/task-ranker.d.ts.map +1 -0
  656. package/dist/task-ranker.js +410 -0
  657. package/dist/task-risk.d.ts +84 -0
  658. package/dist/task-risk.d.ts.map +1 -0
  659. package/dist/task-risk.js +731 -0
  660. package/dist/task-routing-hint-registry.d.ts +36 -0
  661. package/dist/task-routing-hint-registry.d.ts.map +1 -0
  662. package/dist/task-routing-hint-registry.js +186 -0
  663. package/dist/template-authoring.d.ts +113 -0
  664. package/dist/template-authoring.d.ts.map +1 -0
  665. package/dist/template-authoring.js +521 -0
  666. package/dist/template-body-inference-v2.d.ts +19 -0
  667. package/dist/template-body-inference-v2.d.ts.map +1 -0
  668. package/dist/template-body-inference-v2.js +468 -0
  669. package/dist/template-body-inference.d.ts +59 -0
  670. package/dist/template-body-inference.d.ts.map +1 -0
  671. package/dist/template-body-inference.js +277 -0
  672. package/dist/template-drift.d.ts +39 -0
  673. package/dist/template-drift.d.ts.map +1 -0
  674. package/dist/template-drift.js +353 -0
  675. package/dist/template-lint.d.ts +31 -0
  676. package/dist/template-lint.d.ts.map +1 -0
  677. package/dist/template-lint.js +113 -0
  678. package/dist/test-definitions.d.ts +41 -0
  679. package/dist/test-definitions.d.ts.map +1 -0
  680. package/dist/test-definitions.js +6 -0
  681. package/dist/test-impact.d.ts +30 -0
  682. package/dist/test-impact.d.ts.map +1 -0
  683. package/dist/test-impact.js +173 -0
  684. package/dist/test-runner.d.ts +87 -0
  685. package/dist/test-runner.d.ts.map +1 -0
  686. package/dist/test-runner.js +560 -0
  687. package/dist/uncertainty-report.d.ts +46 -0
  688. package/dist/uncertainty-report.d.ts.map +1 -0
  689. package/dist/uncertainty-report.js +108 -0
  690. package/dist/uncertainty.d.ts +38 -0
  691. package/dist/uncertainty.d.ts.map +1 -0
  692. package/dist/uncertainty.js +115 -0
  693. package/dist/universal-search.d.ts +64 -0
  694. package/dist/universal-search.d.ts.map +1 -0
  695. package/dist/universal-search.js +347 -0
  696. package/dist/upgrade-advisor.d.ts +22 -0
  697. package/dist/upgrade-advisor.d.ts.map +1 -0
  698. package/dist/upgrade-advisor.js +109 -0
  699. package/dist/why-file.d.ts +75 -0
  700. package/dist/why-file.d.ts.map +1 -0
  701. package/dist/why-file.js +202 -0
  702. package/dist/workflow-simulation.d.ts +46 -0
  703. package/dist/workflow-simulation.d.ts.map +1 -0
  704. package/dist/workflow-simulation.js +154 -0
  705. package/package.json +66 -0
@@ -0,0 +1,72 @@
1
+ /**
2
+ * `shrk map` — high-level repository overview.
3
+ *
4
+ * Read-only structural snapshot intended for humans and agents to gain a
5
+ * 30-second understanding of "what is this repo". Sources its data from
6
+ * the existing inspection so it never re-walks the filesystem from scratch.
7
+ *
8
+ * The map is deterministic: given the same project, two consecutive calls
9
+ * produce the same output (modulo `generatedAt`).
10
+ */
11
+ import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
12
+ export declare const REPOSITORY_MAP_SCHEMA = "sharkcraft.repository-map/v1";
13
+ export type MapFormat = 'text' | 'markdown' | 'html' | 'json';
14
+ export type MapInclude = 'constructs' | 'boundaries' | 'packages' | 'apps' | 'docs' | 'tests' | 'scripts' | 'all';
15
+ export interface IRepositoryMapPackage {
16
+ name: string;
17
+ path: string;
18
+ kind: 'package' | 'app' | 'example';
19
+ hasDist: boolean;
20
+ hasTests: boolean;
21
+ }
22
+ export interface IRepositoryMapConstruct {
23
+ kind: string;
24
+ count: number;
25
+ }
26
+ export interface IRepositoryMap {
27
+ schema: typeof REPOSITORY_MAP_SCHEMA;
28
+ generatedAt: string;
29
+ projectRoot: string;
30
+ rootSummary: {
31
+ name: string;
32
+ version: string;
33
+ private: boolean;
34
+ description: string;
35
+ packageManager: string;
36
+ };
37
+ detectedProfiles: readonly string[];
38
+ workspaces: readonly string[];
39
+ packages: readonly IRepositoryMapPackage[];
40
+ apps: readonly IRepositoryMapPackage[];
41
+ examples: readonly IRepositoryMapPackage[];
42
+ importantFolders: readonly {
43
+ path: string;
44
+ purpose: string;
45
+ }[];
46
+ constructs: readonly IRepositoryMapConstruct[];
47
+ boundariesCount: number;
48
+ policiesCount: number;
49
+ docsCount: number;
50
+ testsCount: number;
51
+ scriptsCount: number;
52
+ pathConventions: readonly {
53
+ id: string;
54
+ pattern: string;
55
+ }[];
56
+ ownershipSummary: {
57
+ areas: number;
58
+ rules: number;
59
+ };
60
+ recommendedFirstCommands: readonly string[];
61
+ /** Per-language file counts (typescript, java, python, go, rust, csharp, javascript). */
62
+ languageCounts?: Readonly<Record<string, number>>;
63
+ }
64
+ export interface IBuildRepositoryMapOptions {
65
+ include?: readonly MapInclude[];
66
+ }
67
+ export declare function buildRepositoryMap(inspection: ISharkcraftInspection, options?: IBuildRepositoryMapOptions): Promise<IRepositoryMap>;
68
+ export declare function renderRepositoryMapText(map: IRepositoryMap): string;
69
+ export declare function renderRepositoryMapMarkdown(map: IRepositoryMap): string;
70
+ export declare function renderRepositoryMapHtml(map: IRepositoryMap): string;
71
+ export declare function renderRepositoryMap(map: IRepositoryMap, format: MapFormat): string;
72
+ //# sourceMappingURL=repository-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"repository-map.d.ts","sourceRoot":"","sources":["../src/repository-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9D,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,KAAK,CAAC;AAEV,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACvC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,gBAAgB,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,gBAAgB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,wBAAwB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,yFAAyF;IACzF,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AA8GD,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,cAAc,CAAC,CAiFzB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CA2CnE;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAsCvE;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CA2BnE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAKlF"}
@@ -0,0 +1,332 @@
1
+ /**
2
+ * `shrk map` — high-level repository overview.
3
+ *
4
+ * Read-only structural snapshot intended for humans and agents to gain a
5
+ * 30-second understanding of "what is this repo". Sources its data from
6
+ * the existing inspection so it never re-walks the filesystem from scratch.
7
+ *
8
+ * The map is deterministic: given the same project, two consecutive calls
9
+ * produce the same output (modulo `generatedAt`).
10
+ */
11
+ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
12
+ import * as nodePath from 'node:path';
13
+ export const REPOSITORY_MAP_SCHEMA = 'sharkcraft.repository-map/v1';
14
+ function readJsonSafe(file) {
15
+ try {
16
+ return JSON.parse(readFileSync(file, 'utf8'));
17
+ }
18
+ catch {
19
+ return null;
20
+ }
21
+ }
22
+ function summarizeRoot(projectRoot) {
23
+ const pkg = readJsonSafe(nodePath.join(projectRoot, 'package.json'));
24
+ return {
25
+ name: pkg?.name ?? '(unknown)',
26
+ version: pkg?.version ?? '0.0.0',
27
+ private: pkg?.private === true,
28
+ description: pkg?.description ?? '',
29
+ packageManager: pkg?.packageManager ?? 'bun',
30
+ };
31
+ }
32
+ function safeReaddir(dir) {
33
+ try {
34
+ return readdirSync(dir);
35
+ }
36
+ catch {
37
+ return [];
38
+ }
39
+ }
40
+ function describePackage(absDir, projectRoot) {
41
+ const pkg = readJsonSafe(nodePath.join(absDir, 'package.json'));
42
+ if (!pkg)
43
+ return null;
44
+ const hasDist = existsSync(nodePath.join(absDir, 'dist'));
45
+ const hasTests = existsSync(nodePath.join(absDir, 'src', '__tests__')) ||
46
+ existsSync(nodePath.join(absDir, 'tests')) ||
47
+ existsSync(nodePath.join(absDir, 'test'));
48
+ const rel = nodePath.relative(projectRoot, absDir);
49
+ const isApp = rel.startsWith('apps/');
50
+ const isExample = rel.startsWith('examples/');
51
+ return {
52
+ name: pkg.name ?? rel,
53
+ path: rel,
54
+ kind: isApp ? 'app' : isExample ? 'example' : 'package',
55
+ hasDist,
56
+ hasTests,
57
+ };
58
+ }
59
+ function listWorkspacePackages(projectRoot) {
60
+ const out = [];
61
+ for (const root of ['packages', 'apps', 'examples']) {
62
+ const dir = nodePath.join(projectRoot, root);
63
+ if (!existsSync(dir))
64
+ continue;
65
+ for (const entry of safeReaddir(dir)) {
66
+ const full = nodePath.join(dir, entry);
67
+ try {
68
+ if (!statSync(full).isDirectory())
69
+ continue;
70
+ }
71
+ catch {
72
+ continue;
73
+ }
74
+ const p = describePackage(full, projectRoot);
75
+ if (p)
76
+ out.push(p);
77
+ }
78
+ }
79
+ out.sort((a, b) => a.path.localeCompare(b.path));
80
+ return out;
81
+ }
82
+ function countDirEntries(dir, pred) {
83
+ if (!existsSync(dir))
84
+ return 0;
85
+ let n = 0;
86
+ for (const entry of safeReaddir(dir)) {
87
+ if (pred(entry))
88
+ n += 1;
89
+ }
90
+ return n;
91
+ }
92
+ function listImportantFolders(projectRoot) {
93
+ const out = [];
94
+ const known = [
95
+ { dir: 'packages', purpose: 'monorepo libraries' },
96
+ { dir: 'apps', purpose: 'deployable applications' },
97
+ { dir: 'examples', purpose: 'consumer-style integration fixtures' },
98
+ { dir: 'docs', purpose: 'human-readable reference' },
99
+ { dir: 'scripts', purpose: 'release / build / lint tooling' },
100
+ { dir: 'sharkcraft', purpose: 'SharkCraft configuration + asset registries' },
101
+ { dir: 'e2e', purpose: 'end-to-end tests (Playwright)' },
102
+ { dir: '.sharkcraft', purpose: 'cached SharkCraft state (bundles, sessions, reports)' },
103
+ ];
104
+ for (const k of known) {
105
+ if (existsSync(nodePath.join(projectRoot, k.dir)))
106
+ out.push({ path: k.dir, purpose: k.purpose });
107
+ }
108
+ return out;
109
+ }
110
+ export async function buildRepositoryMap(inspection, options = {}) {
111
+ const projectRoot = inspection.projectRoot;
112
+ const include = options.include && options.include.length > 0 ? options.include : ['all'];
113
+ const wantAll = include.includes('all');
114
+ const want = (key) => wantAll || include.includes(key);
115
+ const root = summarizeRoot(projectRoot);
116
+ const allPackages = listWorkspacePackages(projectRoot);
117
+ const packages = want('packages') ? allPackages.filter((p) => p.kind === 'package') : [];
118
+ const apps = want('apps') ? allPackages.filter((p) => p.kind === 'app') : [];
119
+ const examples = want('packages') ? allPackages.filter((p) => p.kind === 'example') : [];
120
+ const docsDir = nodePath.join(projectRoot, 'docs');
121
+ const scriptsDir = nodePath.join(projectRoot, 'scripts');
122
+ const constructs = [];
123
+ const paths = inspection.pathService?.list?.() ?? [];
124
+ const presets = inspection.presetRegistry?.list?.() ?? [];
125
+ const boundaries = inspection.boundaryRegistry?.list?.() ?? [];
126
+ if (want('constructs')) {
127
+ constructs.push({ kind: 'rule', count: inspection.knowledgeEntries.length });
128
+ constructs.push({ kind: 'template', count: inspection.templates.length });
129
+ constructs.push({ kind: 'pipeline', count: inspection.pipelines.length });
130
+ constructs.push({ kind: 'path', count: paths.length });
131
+ constructs.push({ kind: 'preset', count: presets.length });
132
+ constructs.push({ kind: 'pack', count: inspection.packs?.discoveredPacks?.length ?? 0 });
133
+ }
134
+ const pathConventions = paths.slice(0, 12).map((p) => ({
135
+ id: p.id,
136
+ pattern: (p.pattern ?? p.id),
137
+ }));
138
+ const importantFolders = listImportantFolders(projectRoot);
139
+ const recommendedFirstCommands = [
140
+ 'shrk start-here',
141
+ 'shrk doctor',
142
+ 'shrk commands primary',
143
+ 'shrk brief "<task>"',
144
+ 'shrk release readiness',
145
+ ];
146
+ const frameworks = (inspection.workspace?.frameworks ?? []).map((f) => (f.id ?? f.label ?? '')).filter(Boolean);
147
+ const workspaces = readJsonSafe(nodePath.join(projectRoot, 'package.json'))?.workspaces ?? [];
148
+ // Language counts overlay. Best-effort — failure does not break the map.
149
+ let languageCounts;
150
+ try {
151
+ const { detectLanguageProfiles } = await import("./languages/index.js");
152
+ const profiles = detectLanguageProfiles(projectRoot);
153
+ languageCounts = {};
154
+ for (const p of profiles.profiles)
155
+ languageCounts[p.language] = p.fileCount;
156
+ }
157
+ catch {
158
+ languageCounts = undefined;
159
+ }
160
+ return {
161
+ schema: REPOSITORY_MAP_SCHEMA,
162
+ generatedAt: new Date().toISOString(),
163
+ projectRoot,
164
+ rootSummary: root,
165
+ detectedProfiles: frameworks,
166
+ workspaces: workspaces,
167
+ packages,
168
+ apps,
169
+ examples,
170
+ importantFolders,
171
+ constructs,
172
+ boundariesCount: boundaries.length,
173
+ policiesCount: 0,
174
+ docsCount: want('docs')
175
+ ? countDirEntries(docsDir, (e) => e.endsWith('.md'))
176
+ : 0,
177
+ testsCount: want('tests')
178
+ ? allPackages.filter((p) => p.hasTests).length
179
+ : 0,
180
+ scriptsCount: want('scripts')
181
+ ? countDirEntries(scriptsDir, (e) => e.endsWith('.ts') || e.endsWith('.js'))
182
+ : 0,
183
+ pathConventions,
184
+ ownershipSummary: {
185
+ areas: 0,
186
+ rules: inspection.knowledgeEntries.length,
187
+ },
188
+ recommendedFirstCommands,
189
+ ...(languageCounts ? { languageCounts } : {}),
190
+ };
191
+ }
192
+ export function renderRepositoryMapText(map) {
193
+ const lines = [];
194
+ lines.push(`# Repository map — ${map.rootSummary.name} @ ${map.rootSummary.version}`);
195
+ lines.push('');
196
+ lines.push(`Description: ${map.rootSummary.description}`);
197
+ lines.push(`Package manager: ${map.rootSummary.packageManager}`);
198
+ lines.push(`Profiles: ${map.detectedProfiles.join(', ') || '(none detected)'}`);
199
+ lines.push('');
200
+ lines.push('## Workspaces');
201
+ for (const ws of map.workspaces)
202
+ lines.push(` - ${ws}`);
203
+ if (map.workspaces.length === 0)
204
+ lines.push(' (none)');
205
+ lines.push('');
206
+ lines.push(`## Packages (${map.packages.length})`);
207
+ for (const p of map.packages)
208
+ lines.push(` - ${p.name} [${p.path}]${p.hasDist ? ' dist' : ''}${p.hasTests ? ' tests' : ''}`);
209
+ if (map.apps.length > 0) {
210
+ lines.push('');
211
+ lines.push(`## Apps (${map.apps.length})`);
212
+ for (const p of map.apps)
213
+ lines.push(` - ${p.name} [${p.path}]`);
214
+ }
215
+ if (map.examples.length > 0) {
216
+ lines.push('');
217
+ lines.push(`## Examples (${map.examples.length})`);
218
+ for (const p of map.examples)
219
+ lines.push(` - ${p.name} [${p.path}]`);
220
+ }
221
+ lines.push('');
222
+ lines.push('## Important folders');
223
+ for (const f of map.importantFolders)
224
+ lines.push(` - ${f.path}/ — ${f.purpose}`);
225
+ lines.push('');
226
+ lines.push('## Constructs');
227
+ for (const c of map.constructs)
228
+ lines.push(` - ${c.kind}: ${c.count}`);
229
+ lines.push(` - boundaries: ${map.boundariesCount}`);
230
+ lines.push(` - policies: ${map.policiesCount}`);
231
+ lines.push(` - docs: ${map.docsCount}`);
232
+ lines.push(` - scripts: ${map.scriptsCount}`);
233
+ lines.push('');
234
+ if (map.pathConventions.length > 0) {
235
+ lines.push('## Path conventions');
236
+ for (const p of map.pathConventions)
237
+ lines.push(` - ${p.id}: ${p.pattern}`);
238
+ lines.push('');
239
+ }
240
+ lines.push('## Recommended first commands');
241
+ for (const c of map.recommendedFirstCommands)
242
+ lines.push(` $ ${c}`);
243
+ return lines.join('\n') + '\n';
244
+ }
245
+ export function renderRepositoryMapMarkdown(map) {
246
+ const lines = [];
247
+ lines.push(`# Repository map — \`${map.rootSummary.name}\` @ \`${map.rootSummary.version}\``);
248
+ lines.push('');
249
+ lines.push(`> ${map.rootSummary.description}`);
250
+ lines.push('');
251
+ lines.push(`- **Package manager:** \`${map.rootSummary.packageManager}\``);
252
+ lines.push(`- **Profiles:** ${map.detectedProfiles.join(', ') || '_none detected_'}`);
253
+ lines.push(`- **Workspaces:** ${map.workspaces.join(', ') || '_none_'}`);
254
+ lines.push('');
255
+ lines.push('## Packages');
256
+ for (const p of map.packages) {
257
+ lines.push(`- \`${p.name}\` — \`${p.path}\`${p.hasDist ? ' · dist' : ''}${p.hasTests ? ' · tests' : ''}`);
258
+ }
259
+ if (map.apps.length > 0) {
260
+ lines.push('');
261
+ lines.push('## Apps');
262
+ for (const p of map.apps)
263
+ lines.push(`- \`${p.name}\` — \`${p.path}\``);
264
+ }
265
+ if (map.examples.length > 0) {
266
+ lines.push('');
267
+ lines.push('## Examples');
268
+ for (const p of map.examples)
269
+ lines.push(`- \`${p.name}\` — \`${p.path}\``);
270
+ }
271
+ lines.push('');
272
+ lines.push('## Important folders');
273
+ for (const f of map.importantFolders)
274
+ lines.push(`- \`${f.path}/\` — ${f.purpose}`);
275
+ lines.push('');
276
+ lines.push('## Constructs');
277
+ for (const c of map.constructs)
278
+ lines.push(`- ${c.kind}: ${c.count}`);
279
+ lines.push(`- boundaries: ${map.boundariesCount}`);
280
+ lines.push(`- policies: ${map.policiesCount}`);
281
+ lines.push(`- docs: ${map.docsCount}`);
282
+ lines.push(`- scripts: ${map.scriptsCount}`);
283
+ lines.push('');
284
+ lines.push('## Recommended first commands');
285
+ for (const c of map.recommendedFirstCommands)
286
+ lines.push(`\n\`\`\`bash\n${c}\n\`\`\``);
287
+ return lines.join('\n') + '\n';
288
+ }
289
+ function esc(s) {
290
+ return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
291
+ }
292
+ export function renderRepositoryMapHtml(map) {
293
+ const out = [];
294
+ out.push('<!doctype html><html><head><meta charset="utf-8"><title>Repository map</title>');
295
+ out.push('<style>');
296
+ out.push('body{font:14px/1.5 -apple-system,system-ui,sans-serif;max-width:920px;margin:24px auto;padding:0 16px;color:#1a1a1a;background:#fff}');
297
+ out.push('h1{font-size:22px}h2{font-size:16px;margin-top:24px;border-bottom:1px solid #e1e4e8;padding-bottom:4px}');
298
+ out.push('.muted{color:#586069}code,pre{font-family:ui-monospace,SFMono-Regular,Menlo,monospace}');
299
+ out.push('table{border-collapse:collapse}td,th{padding:4px 10px;border:1px solid #d0d7de}');
300
+ out.push('@media (prefers-color-scheme: dark){body{background:#0d1117;color:#c9d1d9}th{background:#161b22}.muted{color:#8b949e}}');
301
+ out.push('</style></head><body>');
302
+ out.push(`<h1>${esc(map.rootSummary.name)} <span class="muted">@ ${esc(map.rootSummary.version)}</span></h1>`);
303
+ out.push(`<p class="muted">${esc(map.rootSummary.description)}</p>`);
304
+ out.push('<h2>Packages</h2><ul>');
305
+ for (const p of map.packages)
306
+ out.push(`<li><code>${esc(p.name)}</code> — <code>${esc(p.path)}</code></li>`);
307
+ out.push('</ul>');
308
+ out.push('<h2>Constructs</h2><ul>');
309
+ for (const c of map.constructs)
310
+ out.push(`<li>${esc(c.kind)}: ${c.count}</li>`);
311
+ out.push(`<li>boundaries: ${map.boundariesCount}</li>`);
312
+ out.push(`<li>policies: ${map.policiesCount}</li>`);
313
+ out.push('</ul>');
314
+ out.push('<h2>Important folders</h2><ul>');
315
+ for (const f of map.importantFolders)
316
+ out.push(`<li><code>${esc(f.path)}/</code> — ${esc(f.purpose)}</li>`);
317
+ out.push('</ul>');
318
+ out.push('<h2>Recommended first commands</h2><ul>');
319
+ for (const c of map.recommendedFirstCommands)
320
+ out.push(`<li><code>${esc(c)}</code></li>`);
321
+ out.push('</ul></body></html>');
322
+ return out.join('\n') + '\n';
323
+ }
324
+ export function renderRepositoryMap(map, format) {
325
+ if (format === 'json')
326
+ return JSON.stringify(map, null, 2) + '\n';
327
+ if (format === 'markdown')
328
+ return renderRepositoryMapMarkdown(map);
329
+ if (format === 'html')
330
+ return renderRepositoryMapHtml(map);
331
+ return renderRepositoryMapText(map);
332
+ }
@@ -0,0 +1,66 @@
1
+ /**
2
+ * Repository statistics — per-language file counts, bytes, line totals,
3
+ * code/comment/blank line breakdowns, averages, and the top-N largest
4
+ * files in the workspace.
5
+ *
6
+ * Deterministic and read-only: given the same project, two consecutive
7
+ * calls produce the same output (modulo `generatedAt`).
8
+ *
9
+ * Comment detection is line-prefix based (`//`, `#`, `--`, `<!--`) and
10
+ * tracks the most common single-line and block forms per language. It is
11
+ * intentionally not a real parser — that would couple this module to
12
+ * every language toolchain we support.
13
+ */
14
+ export declare const REPOSITORY_STATS_SCHEMA = "sharkcraft.repository-stats/v1";
15
+ export interface IRepositoryStatsLanguage {
16
+ language: string;
17
+ extensions: readonly string[];
18
+ files: number;
19
+ bytes: number;
20
+ totalLines: number;
21
+ codeLines: number;
22
+ commentLines: number;
23
+ blankLines: number;
24
+ averageFileBytes: number;
25
+ averageFileLines: number;
26
+ largestFile: {
27
+ path: string;
28
+ bytes: number;
29
+ lines: number;
30
+ } | null;
31
+ }
32
+ export interface IRepositoryStatsTopFile {
33
+ path: string;
34
+ language: string;
35
+ bytes: number;
36
+ lines: number;
37
+ }
38
+ export interface IRepositoryStatsTotals {
39
+ files: number;
40
+ bytes: number;
41
+ totalLines: number;
42
+ codeLines: number;
43
+ commentLines: number;
44
+ blankLines: number;
45
+ }
46
+ export interface IRepositoryStats {
47
+ schema: typeof REPOSITORY_STATS_SCHEMA;
48
+ generatedAt: string;
49
+ projectRoot: string;
50
+ totals: IRepositoryStatsTotals;
51
+ byLanguage: readonly IRepositoryStatsLanguage[];
52
+ topFiles: readonly IRepositoryStatsTopFile[];
53
+ ignoredDirectories: readonly string[];
54
+ truncated: boolean;
55
+ }
56
+ export interface IBuildRepositoryStatsOptions {
57
+ cwd: string;
58
+ /** Top-N largest files to surface (default 10). */
59
+ maxTopFiles?: number;
60
+ /** Hard cap on files walked (default 50_000). */
61
+ maxFiles?: number;
62
+ /** Filter to a single language (e.g. 'typescript'). */
63
+ language?: string;
64
+ }
65
+ export declare function buildRepositoryStats(opts: IBuildRepositoryStatsOptions): Promise<IRepositoryStats>;
66
+ //# sourceMappingURL=repository-stats.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"repository-stats.d.ts","sourceRoot":"","sources":["../src/repository-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChD,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC7C,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+OD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,gBAAgB,CAAC,CA8G3B"}