@shrkcrft/cli 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 (450) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +15 -0
  3. package/dist/asset-preview/apply-action-hint-stub.d.ts +28 -0
  4. package/dist/asset-preview/apply-action-hint-stub.d.ts.map +1 -0
  5. package/dist/asset-preview/apply-action-hint-stub.js +170 -0
  6. package/dist/asset-preview/apply-asset-preview.d.ts +31 -0
  7. package/dist/asset-preview/apply-asset-preview.d.ts.map +1 -0
  8. package/dist/asset-preview/apply-asset-preview.js +210 -0
  9. package/dist/asset-preview/apply-knowledge-stale-fix.d.ts +37 -0
  10. package/dist/asset-preview/apply-knowledge-stale-fix.d.ts.map +1 -0
  11. package/dist/asset-preview/apply-knowledge-stale-fix.js +344 -0
  12. package/dist/asset-preview/apply-missing-barrel.d.ts +15 -0
  13. package/dist/asset-preview/apply-missing-barrel.d.ts.map +1 -0
  14. package/dist/asset-preview/apply-missing-barrel.js +65 -0
  15. package/dist/asset-preview/apply-template-drift-fix.d.ts +21 -0
  16. package/dist/asset-preview/apply-template-drift-fix.d.ts.map +1 -0
  17. package/dist/asset-preview/apply-template-drift-fix.js +125 -0
  18. package/dist/asset-preview/apply-template-update.d.ts +43 -0
  19. package/dist/asset-preview/apply-template-update.d.ts.map +1 -0
  20. package/dist/asset-preview/apply-template-update.js +257 -0
  21. package/dist/asset-preview/entry-mutator.d.ts +106 -0
  22. package/dist/asset-preview/entry-mutator.d.ts.map +1 -0
  23. package/dist/asset-preview/entry-mutator.js +428 -0
  24. package/dist/authoring/authoring-kit.d.ts +36 -0
  25. package/dist/authoring/authoring-kit.d.ts.map +1 -0
  26. package/dist/authoring/authoring-kit.js +106 -0
  27. package/dist/command-registry.d.ts +158 -0
  28. package/dist/command-registry.d.ts.map +1 -0
  29. package/dist/command-registry.js +348 -0
  30. package/dist/commands/apply.command.d.ts +3 -0
  31. package/dist/commands/apply.command.d.ts.map +1 -0
  32. package/dist/commands/apply.command.js +879 -0
  33. package/dist/commands/architecture.command.d.ts +5 -0
  34. package/dist/commands/architecture.command.d.ts.map +1 -0
  35. package/dist/commands/architecture.command.js +141 -0
  36. package/dist/commands/ask.command.d.ts +3 -0
  37. package/dist/commands/ask.command.d.ts.map +1 -0
  38. package/dist/commands/ask.command.js +58 -0
  39. package/dist/commands/audit.command.d.ts +3 -0
  40. package/dist/commands/audit.command.d.ts.map +1 -0
  41. package/dist/commands/audit.command.js +141 -0
  42. package/dist/commands/biome.command.d.ts +7 -0
  43. package/dist/commands/biome.command.d.ts.map +1 -0
  44. package/dist/commands/biome.command.js +350 -0
  45. package/dist/commands/boundaries.command.d.ts +9 -0
  46. package/dist/commands/boundaries.command.d.ts.map +1 -0
  47. package/dist/commands/boundaries.command.js +314 -0
  48. package/dist/commands/brief.command.d.ts +3 -0
  49. package/dist/commands/brief.command.d.ts.map +1 -0
  50. package/dist/commands/brief.command.js +206 -0
  51. package/dist/commands/bundle.command.d.ts +3 -0
  52. package/dist/commands/bundle.command.d.ts.map +1 -0
  53. package/dist/commands/bundle.command.js +1183 -0
  54. package/dist/commands/changes.command.d.ts +3 -0
  55. package/dist/commands/changes.command.d.ts.map +1 -0
  56. package/dist/commands/changes.command.js +155 -0
  57. package/dist/commands/check.command.d.ts +3 -0
  58. package/dist/commands/check.command.d.ts.map +1 -0
  59. package/dist/commands/check.command.js +553 -0
  60. package/dist/commands/checks.command.d.ts +29 -0
  61. package/dist/commands/checks.command.d.ts.map +1 -0
  62. package/dist/commands/checks.command.js +521 -0
  63. package/dist/commands/ci.command.d.ts +3 -0
  64. package/dist/commands/ci.command.d.ts.map +1 -0
  65. package/dist/commands/ci.command.js +680 -0
  66. package/dist/commands/codemod.command.d.ts +3 -0
  67. package/dist/commands/codemod.command.d.ts.map +1 -0
  68. package/dist/commands/codemod.command.js +130 -0
  69. package/dist/commands/command-catalog.d.ts +265 -0
  70. package/dist/commands/command-catalog.d.ts.map +1 -0
  71. package/dist/commands/command-catalog.js +3242 -0
  72. package/dist/commands/commands.command.d.ts +92 -0
  73. package/dist/commands/commands.command.d.ts.map +1 -0
  74. package/dist/commands/commands.command.js +1208 -0
  75. package/dist/commands/constructs.command.d.ts +15 -0
  76. package/dist/commands/constructs.command.d.ts.map +1 -0
  77. package/dist/commands/constructs.command.js +669 -0
  78. package/dist/commands/context.command.d.ts +3 -0
  79. package/dist/commands/context.command.d.ts.map +1 -0
  80. package/dist/commands/context.command.js +120 -0
  81. package/dist/commands/contract-gate.command.d.ts +5 -0
  82. package/dist/commands/contract-gate.command.d.ts.map +1 -0
  83. package/dist/commands/contract-gate.command.js +208 -0
  84. package/dist/commands/contract-templates.command.d.ts +8 -0
  85. package/dist/commands/contract-templates.command.d.ts.map +1 -0
  86. package/dist/commands/contract-templates.command.js +151 -0
  87. package/dist/commands/contract.command.d.ts +3 -0
  88. package/dist/commands/contract.command.d.ts.map +1 -0
  89. package/dist/commands/contract.command.js +105 -0
  90. package/dist/commands/conventions.command.d.ts +8 -0
  91. package/dist/commands/conventions.command.d.ts.map +1 -0
  92. package/dist/commands/conventions.command.js +169 -0
  93. package/dist/commands/coverage.command.d.ts +3 -0
  94. package/dist/commands/coverage.command.d.ts.map +1 -0
  95. package/dist/commands/coverage.command.js +56 -0
  96. package/dist/commands/daily.commands.d.ts +5 -0
  97. package/dist/commands/daily.commands.d.ts.map +1 -0
  98. package/dist/commands/daily.commands.js +224 -0
  99. package/dist/commands/dashboard-export.command.d.ts +4 -0
  100. package/dist/commands/dashboard-export.command.d.ts.map +1 -0
  101. package/dist/commands/dashboard-export.command.js +86 -0
  102. package/dist/commands/dashboard.command.d.ts +3 -0
  103. package/dist/commands/dashboard.command.d.ts.map +1 -0
  104. package/dist/commands/dashboard.command.js +106 -0
  105. package/dist/commands/dev.command.d.ts +3 -0
  106. package/dist/commands/dev.command.d.ts.map +1 -0
  107. package/dist/commands/dev.command.js +1392 -0
  108. package/dist/commands/diagnostics.command.d.ts +5 -0
  109. package/dist/commands/diagnostics.command.d.ts.map +1 -0
  110. package/dist/commands/diagnostics.command.js +97 -0
  111. package/dist/commands/docs.command.d.ts +4 -0
  112. package/dist/commands/docs.command.d.ts.map +1 -0
  113. package/dist/commands/docs.command.js +34 -0
  114. package/dist/commands/doctor.command.d.ts +7 -0
  115. package/dist/commands/doctor.command.d.ts.map +1 -0
  116. package/dist/commands/doctor.command.js +681 -0
  117. package/dist/commands/drift.command.d.ts +3 -0
  118. package/dist/commands/drift.command.d.ts.map +1 -0
  119. package/dist/commands/drift.command.js +124 -0
  120. package/dist/commands/eslint.command.d.ts +7 -0
  121. package/dist/commands/eslint.command.d.ts.map +1 -0
  122. package/dist/commands/eslint.command.js +423 -0
  123. package/dist/commands/explore.command.d.ts +3 -0
  124. package/dist/commands/explore.command.d.ts.map +1 -0
  125. package/dist/commands/explore.command.js +65 -0
  126. package/dist/commands/export-bundle.command.d.ts +6 -0
  127. package/dist/commands/export-bundle.command.d.ts.map +1 -0
  128. package/dist/commands/export-bundle.command.js +96 -0
  129. package/dist/commands/export.command.d.ts +3 -0
  130. package/dist/commands/export.command.d.ts.map +1 -0
  131. package/dist/commands/export.command.js +83 -0
  132. package/dist/commands/feedback-dispatch.command.d.ts +12 -0
  133. package/dist/commands/feedback-dispatch.command.d.ts.map +1 -0
  134. package/dist/commands/feedback-dispatch.command.js +63 -0
  135. package/dist/commands/feedback.command.d.ts +11 -0
  136. package/dist/commands/feedback.command.d.ts.map +1 -0
  137. package/dist/commands/feedback.command.js +336 -0
  138. package/dist/commands/fix.command.d.ts +3 -0
  139. package/dist/commands/fix.command.d.ts.map +1 -0
  140. package/dist/commands/fix.command.js +776 -0
  141. package/dist/commands/gen.command.d.ts +3 -0
  142. package/dist/commands/gen.command.d.ts.map +1 -0
  143. package/dist/commands/gen.command.js +136 -0
  144. package/dist/commands/git.command.d.ts +6 -0
  145. package/dist/commands/git.command.d.ts.map +1 -0
  146. package/dist/commands/git.command.js +81 -0
  147. package/dist/commands/graph.command.d.ts +3 -0
  148. package/dist/commands/graph.command.d.ts.map +1 -0
  149. package/dist/commands/graph.command.js +287 -0
  150. package/dist/commands/grounding.command.d.ts +7 -0
  151. package/dist/commands/grounding.command.d.ts.map +1 -0
  152. package/dist/commands/grounding.command.js +54 -0
  153. package/dist/commands/help.command.d.ts +20 -0
  154. package/dist/commands/help.command.d.ts.map +1 -0
  155. package/dist/commands/help.command.js +127 -0
  156. package/dist/commands/helper.command.d.ts +6 -0
  157. package/dist/commands/helper.command.d.ts.map +1 -0
  158. package/dist/commands/helper.command.js +170 -0
  159. package/dist/commands/ide.command.d.ts +6 -0
  160. package/dist/commands/ide.command.d.ts.map +1 -0
  161. package/dist/commands/ide.command.js +340 -0
  162. package/dist/commands/impact.command.d.ts +3 -0
  163. package/dist/commands/impact.command.d.ts.map +1 -0
  164. package/dist/commands/impact.command.js +819 -0
  165. package/dist/commands/import.command.d.ts +3 -0
  166. package/dist/commands/import.command.d.ts.map +1 -0
  167. package/dist/commands/import.command.js +115 -0
  168. package/dist/commands/infer.command.d.ts +3 -0
  169. package/dist/commands/infer.command.d.ts.map +1 -0
  170. package/dist/commands/infer.command.js +227 -0
  171. package/dist/commands/ingest.command.d.ts +6 -0
  172. package/dist/commands/ingest.command.d.ts.map +1 -0
  173. package/dist/commands/ingest.command.js +532 -0
  174. package/dist/commands/init.command.d.ts +3 -0
  175. package/dist/commands/init.command.d.ts.map +1 -0
  176. package/dist/commands/init.command.js +301 -0
  177. package/dist/commands/inspect.command.d.ts +3 -0
  178. package/dist/commands/inspect.command.d.ts.map +1 -0
  179. package/dist/commands/inspect.command.js +122 -0
  180. package/dist/commands/knowledge-author.command.d.ts +22 -0
  181. package/dist/commands/knowledge-author.command.d.ts.map +1 -0
  182. package/dist/commands/knowledge-author.command.js +366 -0
  183. package/dist/commands/knowledge-propose.command.d.ts +3 -0
  184. package/dist/commands/knowledge-propose.command.d.ts.map +1 -0
  185. package/dist/commands/knowledge-propose.command.js +125 -0
  186. package/dist/commands/knowledge.command.d.ts +18 -0
  187. package/dist/commands/knowledge.command.d.ts.map +1 -0
  188. package/dist/commands/knowledge.command.js +538 -0
  189. package/dist/commands/languages.command.d.ts +3 -0
  190. package/dist/commands/languages.command.d.ts.map +1 -0
  191. package/dist/commands/languages.command.js +300 -0
  192. package/dist/commands/lint.command.d.ts +15 -0
  193. package/dist/commands/lint.command.d.ts.map +1 -0
  194. package/dist/commands/lint.command.js +194 -0
  195. package/dist/commands/mcp.command.d.ts +3 -0
  196. package/dist/commands/mcp.command.d.ts.map +1 -0
  197. package/dist/commands/mcp.command.js +74 -0
  198. package/dist/commands/memory.command.d.ts +11 -0
  199. package/dist/commands/memory.command.d.ts.map +1 -0
  200. package/dist/commands/memory.command.js +264 -0
  201. package/dist/commands/onboard.command.d.ts +3 -0
  202. package/dist/commands/onboard.command.d.ts.map +1 -0
  203. package/dist/commands/onboard.command.js +650 -0
  204. package/dist/commands/orchestrate.command.d.ts +3 -0
  205. package/dist/commands/orchestrate.command.d.ts.map +1 -0
  206. package/dist/commands/orchestrate.command.js +49 -0
  207. package/dist/commands/owners.command.d.ts +5 -0
  208. package/dist/commands/owners.command.d.ts.map +1 -0
  209. package/dist/commands/owners.command.js +113 -0
  210. package/dist/commands/ownership.command.d.ts +5 -0
  211. package/dist/commands/ownership.command.d.ts.map +1 -0
  212. package/dist/commands/ownership.command.js +117 -0
  213. package/dist/commands/pack-author.command.d.ts +30 -0
  214. package/dist/commands/pack-author.command.d.ts.map +1 -0
  215. package/dist/commands/pack-author.command.js +242 -0
  216. package/dist/commands/packs-new.d.ts +27 -0
  217. package/dist/commands/packs-new.d.ts.map +1 -0
  218. package/dist/commands/packs-new.js +805 -0
  219. package/dist/commands/packs.command.d.ts +15 -0
  220. package/dist/commands/packs.command.d.ts.map +1 -0
  221. package/dist/commands/packs.command.js +958 -0
  222. package/dist/commands/paths.command.d.ts +6 -0
  223. package/dist/commands/paths.command.d.ts.map +1 -0
  224. package/dist/commands/paths.command.js +97 -0
  225. package/dist/commands/pipelines.command.d.ts +9 -0
  226. package/dist/commands/pipelines.command.d.ts.map +1 -0
  227. package/dist/commands/pipelines.command.js +308 -0
  228. package/dist/commands/plan-check.command.d.ts +27 -0
  229. package/dist/commands/plan-check.command.d.ts.map +1 -0
  230. package/dist/commands/plan-check.command.js +150 -0
  231. package/dist/commands/plan-simulate.command.d.ts +3 -0
  232. package/dist/commands/plan-simulate.command.d.ts.map +1 -0
  233. package/dist/commands/plan-simulate.command.js +60 -0
  234. package/dist/commands/plan.command.d.ts +8 -0
  235. package/dist/commands/plan.command.d.ts.map +1 -0
  236. package/dist/commands/plan.command.js +139 -0
  237. package/dist/commands/playbooks.command.d.ts +10 -0
  238. package/dist/commands/playbooks.command.d.ts.map +1 -0
  239. package/dist/commands/playbooks.command.js +296 -0
  240. package/dist/commands/plugin.command.d.ts +11 -0
  241. package/dist/commands/plugin.command.d.ts.map +1 -0
  242. package/dist/commands/plugin.command.js +394 -0
  243. package/dist/commands/policy.command.d.ts +8 -0
  244. package/dist/commands/policy.command.d.ts.map +1 -0
  245. package/dist/commands/policy.command.js +451 -0
  246. package/dist/commands/pr.command.d.ts +3 -0
  247. package/dist/commands/pr.command.d.ts.map +1 -0
  248. package/dist/commands/pr.command.js +132 -0
  249. package/dist/commands/preflight.command.d.ts +3 -0
  250. package/dist/commands/preflight.command.d.ts.map +1 -0
  251. package/dist/commands/preflight.command.js +102 -0
  252. package/dist/commands/presets.command.d.ts +17 -0
  253. package/dist/commands/presets.command.d.ts.map +1 -0
  254. package/dist/commands/presets.command.js +647 -0
  255. package/dist/commands/profiles.command.d.ts +7 -0
  256. package/dist/commands/profiles.command.d.ts.map +1 -0
  257. package/dist/commands/profiles.command.js +151 -0
  258. package/dist/commands/provenance.command.d.ts +26 -0
  259. package/dist/commands/provenance.command.d.ts.map +1 -0
  260. package/dist/commands/provenance.command.js +237 -0
  261. package/dist/commands/quality.command.d.ts +5 -0
  262. package/dist/commands/quality.command.d.ts.map +1 -0
  263. package/dist/commands/quality.command.js +69 -0
  264. package/dist/commands/recommend.command.d.ts +4 -0
  265. package/dist/commands/recommend.command.d.ts.map +1 -0
  266. package/dist/commands/recommend.command.js +270 -0
  267. package/dist/commands/registrations.command.d.ts +3 -0
  268. package/dist/commands/registrations.command.d.ts.map +1 -0
  269. package/dist/commands/registrations.command.js +300 -0
  270. package/dist/commands/registry.command.d.ts +4 -0
  271. package/dist/commands/registry.command.d.ts.map +1 -0
  272. package/dist/commands/registry.command.js +37 -0
  273. package/dist/commands/release.command.d.ts +4 -0
  274. package/dist/commands/release.command.d.ts.map +1 -0
  275. package/dist/commands/release.command.js +639 -0
  276. package/dist/commands/repo.command.d.ts +3 -0
  277. package/dist/commands/repo.command.d.ts.map +1 -0
  278. package/dist/commands/repo.command.js +24 -0
  279. package/dist/commands/report.command.d.ts +3 -0
  280. package/dist/commands/report.command.d.ts.map +1 -0
  281. package/dist/commands/report.command.js +511 -0
  282. package/dist/commands/reposet.command.d.ts +6 -0
  283. package/dist/commands/reposet.command.d.ts.map +1 -0
  284. package/dist/commands/reposet.command.js +120 -0
  285. package/dist/commands/review.command.d.ts +3 -0
  286. package/dist/commands/review.command.d.ts.map +1 -0
  287. package/dist/commands/review.command.js +354 -0
  288. package/dist/commands/risk.command.d.ts +3 -0
  289. package/dist/commands/risk.command.d.ts.map +1 -0
  290. package/dist/commands/risk.command.js +56 -0
  291. package/dist/commands/rounds.command.d.ts +8 -0
  292. package/dist/commands/rounds.command.d.ts.map +1 -0
  293. package/dist/commands/rounds.command.js +180 -0
  294. package/dist/commands/rules.command.d.ts +49 -0
  295. package/dist/commands/rules.command.d.ts.map +1 -0
  296. package/dist/commands/rules.command.js +435 -0
  297. package/dist/commands/runtime.command.d.ts +3 -0
  298. package/dist/commands/runtime.command.d.ts.map +1 -0
  299. package/dist/commands/runtime.command.js +56 -0
  300. package/dist/commands/safety.command.d.ts +3 -0
  301. package/dist/commands/safety.command.d.ts.map +1 -0
  302. package/dist/commands/safety.command.js +117 -0
  303. package/dist/commands/scaffolds.command.d.ts +5 -0
  304. package/dist/commands/scaffolds.command.d.ts.map +1 -0
  305. package/dist/commands/scaffolds.command.js +122 -0
  306. package/dist/commands/schemas.command.d.ts +21 -0
  307. package/dist/commands/schemas.command.d.ts.map +1 -0
  308. package/dist/commands/schemas.command.js +296 -0
  309. package/dist/commands/search.command.d.ts +12 -0
  310. package/dist/commands/search.command.d.ts.map +1 -0
  311. package/dist/commands/search.command.js +275 -0
  312. package/dist/commands/self-config.command.d.ts +7 -0
  313. package/dist/commands/self-config.command.d.ts.map +1 -0
  314. package/dist/commands/self-config.command.js +156 -0
  315. package/dist/commands/self.command.d.ts +3 -0
  316. package/dist/commands/self.command.d.ts.map +1 -0
  317. package/dist/commands/self.command.js +117 -0
  318. package/dist/commands/simulate.command.d.ts +3 -0
  319. package/dist/commands/simulate.command.d.ts.map +1 -0
  320. package/dist/commands/simulate.command.js +54 -0
  321. package/dist/commands/spec.command.d.ts +29 -0
  322. package/dist/commands/spec.command.d.ts.map +1 -0
  323. package/dist/commands/spec.command.js +985 -0
  324. package/dist/commands/start-here.command.d.ts +3 -0
  325. package/dist/commands/start-here.command.d.ts.map +1 -0
  326. package/dist/commands/start-here.command.js +35 -0
  327. package/dist/commands/stats.command.d.ts +3 -0
  328. package/dist/commands/stats.command.d.ts.map +1 -0
  329. package/dist/commands/stats.command.js +88 -0
  330. package/dist/commands/surface.command.d.ts +15 -0
  331. package/dist/commands/surface.command.d.ts.map +1 -0
  332. package/dist/commands/surface.command.js +328 -0
  333. package/dist/commands/task-context.command.d.ts +7 -0
  334. package/dist/commands/task-context.command.d.ts.map +1 -0
  335. package/dist/commands/task-context.command.js +646 -0
  336. package/dist/commands/task.command.d.ts +3 -0
  337. package/dist/commands/task.command.d.ts.map +1 -0
  338. package/dist/commands/task.command.js +301 -0
  339. package/dist/commands/template-quality.command.d.ts +5 -0
  340. package/dist/commands/template-quality.command.d.ts.map +1 -0
  341. package/dist/commands/template-quality.command.js +128 -0
  342. package/dist/commands/templates.command.d.ts +26 -0
  343. package/dist/commands/templates.command.d.ts.map +1 -0
  344. package/dist/commands/templates.command.js +964 -0
  345. package/dist/commands/test.command.d.ts +3 -0
  346. package/dist/commands/test.command.d.ts.map +1 -0
  347. package/dist/commands/test.command.js +262 -0
  348. package/dist/commands/tests.command.d.ts +5 -0
  349. package/dist/commands/tests.command.d.ts.map +1 -0
  350. package/dist/commands/tests.command.js +97 -0
  351. package/dist/commands/trace.command.d.ts +3 -0
  352. package/dist/commands/trace.command.d.ts.map +1 -0
  353. package/dist/commands/trace.command.js +121 -0
  354. package/dist/commands/upgrade.command.d.ts +4 -0
  355. package/dist/commands/upgrade.command.d.ts.map +1 -0
  356. package/dist/commands/upgrade.command.js +43 -0
  357. package/dist/commands/version.command.d.ts +3 -0
  358. package/dist/commands/version.command.d.ts.map +1 -0
  359. package/dist/commands/version.command.js +10 -0
  360. package/dist/commands/why.command.d.ts +24 -0
  361. package/dist/commands/why.command.d.ts.map +1 -0
  362. package/dist/commands/why.command.js +119 -0
  363. package/dist/dashboard/dashboard-api-server.d.ts +21 -0
  364. package/dist/dashboard/dashboard-api-server.d.ts.map +1 -0
  365. package/dist/dashboard/dashboard-api-server.js +410 -0
  366. package/dist/dashboard/live-session-server.d.ts +18 -0
  367. package/dist/dashboard/live-session-server.d.ts.map +1 -0
  368. package/dist/dashboard/live-session-server.js +133 -0
  369. package/dist/diff/collect-changed-paths.d.ts +27 -0
  370. package/dist/diff/collect-changed-paths.d.ts.map +1 -0
  371. package/dist/diff/collect-changed-paths.js +68 -0
  372. package/dist/doctor/doctor-tags.d.ts +63 -0
  373. package/dist/doctor/doctor-tags.d.ts.map +1 -0
  374. package/dist/doctor/doctor-tags.js +146 -0
  375. package/dist/export/export-formats.d.ts +22 -0
  376. package/dist/export/export-formats.d.ts.map +1 -0
  377. package/dist/export/export-formats.js +135 -0
  378. package/dist/index.d.ts +22 -0
  379. package/dist/index.d.ts.map +1 -0
  380. package/dist/index.js +21 -0
  381. package/dist/init/detected-block.d.ts +57 -0
  382. package/dist/init/detected-block.d.ts.map +1 -0
  383. package/dist/init/detected-block.js +197 -0
  384. package/dist/init/gitignore.d.ts +30 -0
  385. package/dist/init/gitignore.d.ts.map +1 -0
  386. package/dist/init/gitignore.js +110 -0
  387. package/dist/init/init-templates.d.ts +6 -0
  388. package/dist/init/init-templates.d.ts.map +1 -0
  389. package/dist/init/init-templates.js +413 -0
  390. package/dist/main.d.ts +18 -0
  391. package/dist/main.d.ts.map +1 -0
  392. package/dist/main.js +699 -0
  393. package/dist/output/failure-hints.d.ts +55 -0
  394. package/dist/output/failure-hints.d.ts.map +1 -0
  395. package/dist/output/failure-hints.js +159 -0
  396. package/dist/output/format-output.d.ts +9 -0
  397. package/dist/output/format-output.d.ts.map +1 -0
  398. package/dist/output/format-output.js +26 -0
  399. package/dist/output/print-error.d.ts +3 -0
  400. package/dist/output/print-error.d.ts.map +1 -0
  401. package/dist/output/print-error.js +14 -0
  402. package/dist/output/watch-loop.d.ts +37 -0
  403. package/dist/output/watch-loop.d.ts.map +1 -0
  404. package/dist/output/watch-loop.js +115 -0
  405. package/dist/schemas/json-schemas.d.ts +1630 -0
  406. package/dist/schemas/json-schemas.d.ts.map +1 -0
  407. package/dist/schemas/json-schemas.js +811 -0
  408. package/dist/surface/about.d.ts +10 -0
  409. package/dist/surface/about.d.ts.map +1 -0
  410. package/dist/surface/about.js +53 -0
  411. package/dist/surface/load-surface-context.d.ts +34 -0
  412. package/dist/surface/load-surface-context.d.ts.map +1 -0
  413. package/dist/surface/load-surface-context.js +100 -0
  414. package/dist/surface/no-args-landing.d.ts +7 -0
  415. package/dist/surface/no-args-landing.d.ts.map +1 -0
  416. package/dist/surface/no-args-landing.js +36 -0
  417. package/dist/surface/not-enabled-error.d.ts +24 -0
  418. package/dist/surface/not-enabled-error.d.ts.map +1 -0
  419. package/dist/surface/not-enabled-error.js +36 -0
  420. package/dist/surface/profiles.d.ts +37 -0
  421. package/dist/surface/profiles.d.ts.map +1 -0
  422. package/dist/surface/profiles.js +151 -0
  423. package/dist/surface/shape-defaults.d.ts +21 -0
  424. package/dist/surface/shape-defaults.d.ts.map +1 -0
  425. package/dist/surface/shape-defaults.js +50 -0
  426. package/dist/surface/spine-extractor.d.ts +38 -0
  427. package/dist/surface/spine-extractor.d.ts.map +1 -0
  428. package/dist/surface/spine-extractor.js +100 -0
  429. package/dist/surface/surface-config-writer.d.ts +59 -0
  430. package/dist/surface/surface-config-writer.d.ts.map +1 -0
  431. package/dist/surface/surface-config-writer.js +135 -0
  432. package/dist/surface/surface-summary.d.ts +66 -0
  433. package/dist/surface/surface-summary.d.ts.map +1 -0
  434. package/dist/surface/surface-summary.js +162 -0
  435. package/dist/surface/tier.d.ts +100 -0
  436. package/dist/surface/tier.d.ts.map +1 -0
  437. package/dist/surface/tier.js +172 -0
  438. package/dist/task-next/apply-batch-runner.d.ts +42 -0
  439. package/dist/task-next/apply-batch-runner.d.ts.map +1 -0
  440. package/dist/task-next/apply-batch-runner.js +192 -0
  441. package/dist/task-next/task-next-ranker.d.ts +75 -0
  442. package/dist/task-next/task-next-ranker.d.ts.map +1 -0
  443. package/dist/task-next/task-next-ranker.js +179 -0
  444. package/dist/usage/usage-log.d.ts +54 -0
  445. package/dist/usage/usage-log.d.ts.map +1 -0
  446. package/dist/usage/usage-log.js +105 -0
  447. package/dist/validation/run-validation-loop.d.ts +38 -0
  448. package/dist/validation/run-validation-loop.d.ts.map +1 -0
  449. package/dist/validation/run-validation-loop.js +100 -0
  450. package/package.json +73 -0
@@ -0,0 +1,532 @@
1
+ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
2
+ import * as nodePath from 'node:path';
3
+ import { applyIngestPlan, buildContradictionReport, buildGeneratedCodeReport, buildIngestAdoptionPlan, buildIngestApplyPlan, buildRepositoryKnowledgeModel, buildStabilityMap, inspectSharkcraft, IngestAdoptionStatus, IngestDepth, IngestSection, loadIngestApplyPlan, renderContradictionReportHtml, renderContradictionReportJson, renderContradictionReportMarkdown, renderContradictionReportText, renderGeneratedCodeReportJson, renderGeneratedCodeReportMarkdown, renderGeneratedCodeReportText, renderIngestAdoptionPatch, renderIngestAdoptionPlanMarkdown, renderIngestApplyReviewMarkdown, renderRepositoryKnowledgeModelHtml, renderRepositoryKnowledgeModelJson, renderRepositoryKnowledgeModelMarkdown, renderRepositoryKnowledgeModelText, renderStabilityMapJson, renderStabilityMapMarkdown, renderStabilityMapText, saveIngestApplyPlan, signIngestApplyPlan, writeIngestAdoption, writeIngestDrafts, } from '@shrkcrft/inspector';
4
+ import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
5
+ import { asJson, header, kv } from "../output/format-output.js";
6
+ const INGEST_BASE = nodePath.join('sharkcraft', 'ingestion');
7
+ export const ingestCommand = {
8
+ name: 'ingest',
9
+ description: 'Deeply ingest a repository into a SharkCraft repository knowledge model. Dry-run by default; writes drafts under sharkcraft/ingestion/. `repository` (default sub-verb) builds the knowledge model; `status` / `report` / `diff` / `adopt` / `clean` / `refresh` manage the lifecycle.',
10
+ usage: 'shrk [--cwd <dir>] ingest [repository|refresh|status|report|adopt|diff|clean] [options]',
11
+ async run(args) {
12
+ const sub = args.positional[0] ?? 'repository';
13
+ const rest = { ...args, positional: args.positional.slice(1) };
14
+ switch (sub) {
15
+ case 'repository':
16
+ return runRepository(rest);
17
+ case 'refresh':
18
+ return runRefresh(rest);
19
+ case 'status':
20
+ return runStatus(rest);
21
+ case 'report':
22
+ return runReport(rest);
23
+ case 'adopt':
24
+ return runAdopt(rest);
25
+ case 'diff':
26
+ return runDiff(rest);
27
+ case 'clean':
28
+ return runClean(rest);
29
+ default:
30
+ return runRepository(args);
31
+ }
32
+ },
33
+ };
34
+ async function buildModel(args, cwd) {
35
+ const depthRaw = (flagString(args, 'depth') ?? 'standard').toLowerCase();
36
+ const depthMap = {
37
+ shallow: IngestDepth.Shallow,
38
+ standard: IngestDepth.Standard,
39
+ deep: IngestDepth.Deep,
40
+ extreme: IngestDepth.Extreme,
41
+ };
42
+ const depth = depthMap[depthRaw] ?? IngestDepth.Standard;
43
+ const include = flagList(args, 'include').map(parseSection).filter(Boolean);
44
+ const exclude = flagList(args, 'exclude').map(parseSection).filter(Boolean);
45
+ const forcedPresets = flagList(args, 'preset');
46
+ const task = flagString(args, 'task');
47
+ const docsFirst = flagBool(args, 'docs-first');
48
+ const inspection = await inspectSharkcraft({ cwd });
49
+ const model = await buildRepositoryKnowledgeModel({
50
+ inspection,
51
+ depth,
52
+ selectedSections: include.length > 0 ? include : undefined,
53
+ excludedSections: exclude.length > 0 ? exclude : undefined,
54
+ forcedPresetIds: forcedPresets,
55
+ ...(task ? { task } : {}),
56
+ docsFirst: docsFirst || undefined,
57
+ });
58
+ return { inspection, model };
59
+ }
60
+ async function runRepository(args) {
61
+ const cwd = resolveCwd(args);
62
+ const writeDrafts = flagBool(args, 'write-drafts');
63
+ const adopt = flagBool(args, 'adopt');
64
+ const json = flagBool(args, 'json');
65
+ const format = parseFormat(flagString(args, 'format'));
66
+ const output = flagString(args, 'output');
67
+ const profile = flagString(args, 'profile');
68
+ const { model } = await buildModel(args, cwd);
69
+ let writtenDrafts;
70
+ if (writeDrafts) {
71
+ writtenDrafts = writeIngestDrafts(model, { projectRoot: cwd });
72
+ }
73
+ let adoption;
74
+ let writtenAdoption;
75
+ if (adopt) {
76
+ adoption = buildIngestAdoptionPlan({ model });
77
+ writtenAdoption = writeIngestAdoption({ plan: adoption });
78
+ }
79
+ const payload = {
80
+ mode: writeDrafts ? (adopt ? 'write-drafts+adopt' : 'write-drafts') : (adopt ? 'adopt-only' : 'dry-run'),
81
+ profile,
82
+ sections: model.selectedSections,
83
+ presets: model.presets.map((p) => ({
84
+ id: p.preset.id,
85
+ score: p.score,
86
+ confidence: p.confidence,
87
+ reasons: p.reasons,
88
+ })),
89
+ transformationalIntents: model.transformationalIntents,
90
+ confidence: model.confidence.overall,
91
+ contradictions: model.contradictions.findings.length,
92
+ riskAreas: model.riskAreas.length,
93
+ generatedRoots: model.generatedVsHandwritten.generatedRoots.length,
94
+ stabilityAreas: model.stableExperimentalDeprecated.areas.length,
95
+ written: writtenDrafts
96
+ ? {
97
+ outDir: writtenDrafts.outDir,
98
+ files: writtenDrafts.files.map((f) => ({ path: f.path, bytes: f.bytes })),
99
+ }
100
+ : undefined,
101
+ adoption: adoption
102
+ ? {
103
+ counts: adoption.counts,
104
+ reviewRequired: adoption.reviewRequired,
105
+ adoptionOutDir: writtenAdoption?.outDir,
106
+ }
107
+ : undefined,
108
+ };
109
+ if (json || format === 'json') {
110
+ const body = format === 'json'
111
+ ? renderRepositoryKnowledgeModelJson(model)
112
+ : asJson(payload);
113
+ if (output)
114
+ writeOutput(cwd, output, body);
115
+ else
116
+ process.stdout.write(body + '\n');
117
+ return 0;
118
+ }
119
+ if (format === 'markdown') {
120
+ const body = renderRepositoryKnowledgeModelMarkdown(model);
121
+ if (output)
122
+ writeOutput(cwd, output, body);
123
+ else
124
+ process.stdout.write(body + '\n');
125
+ return 0;
126
+ }
127
+ if (format === 'html') {
128
+ const body = renderRepositoryKnowledgeModelHtml(model);
129
+ if (output)
130
+ writeOutput(cwd, output, body);
131
+ else
132
+ process.stdout.write(body + '\n');
133
+ return 0;
134
+ }
135
+ // Human-readable summary.
136
+ process.stdout.write(header('SharkCraft ingest'));
137
+ process.stdout.write(kv('mode', payload.mode) + '\n');
138
+ process.stdout.write(kv('depth', model.depth) + '\n');
139
+ process.stdout.write(kv('project', model.repositoryOverview.projectName) + '\n');
140
+ process.stdout.write(kv('confidence', `${model.confidence.overall}/100`) + '\n');
141
+ process.stdout.write(kv('contradictions', model.contradictions.findings.length) + '\n');
142
+ process.stdout.write(kv('risk areas', model.riskAreas.length) + '\n');
143
+ process.stdout.write(kv('generated roots', model.generatedVsHandwritten.generatedRoots.length) + '\n');
144
+ process.stdout.write(kv('stability areas', model.stableExperimentalDeprecated.areas.length) + '\n');
145
+ process.stdout.write('\n');
146
+ process.stdout.write(renderRepositoryKnowledgeModelText(model));
147
+ process.stdout.write('\n');
148
+ if (writtenDrafts) {
149
+ process.stdout.write(`\nWrote ${writtenDrafts.files.length} draft files under ${writtenDrafts.outDir}\n`);
150
+ }
151
+ if (writtenAdoption) {
152
+ process.stdout.write(`\nWrote adoption plan under ${writtenAdoption.outDir} (review required: ${adoption?.reviewRequired ? 'yes' : 'no'})\n`);
153
+ }
154
+ if (model.transformationalIntents.length > 0) {
155
+ process.stdout.write('\nTransformational intents:\n');
156
+ for (const t of model.transformationalIntents)
157
+ process.stdout.write(` - ${t}\n`);
158
+ }
159
+ process.stdout.write('\nNext steps:\n');
160
+ process.stdout.write(' • shrk ingest report --format markdown\n');
161
+ process.stdout.write(' • shrk ingest diff\n');
162
+ if (!writeDrafts)
163
+ process.stdout.write(' • Re-run with --write-drafts to materialise drafts under sharkcraft/ingestion/\n');
164
+ if (!adopt)
165
+ process.stdout.write(' • Re-run with --adopt to produce an adoption patch under sharkcraft/ingestion/adoption/\n');
166
+ return 0;
167
+ }
168
+ async function runRefresh(args) {
169
+ // Same as repository but always reads the cache fresh; alias for now.
170
+ return runRepository(args);
171
+ }
172
+ async function runStatus(args) {
173
+ const cwd = resolveCwd(args);
174
+ const json = flagBool(args, 'json');
175
+ const ingestDir = nodePath.join(cwd, INGEST_BASE);
176
+ const modelPath = nodePath.join(ingestDir, 'repository-knowledge-model.json');
177
+ const adoptionPath = nodePath.join(ingestDir, 'adoption', 'ingest-adoption-state.json');
178
+ const status = {
179
+ ingestDirExists: existsSync(ingestDir),
180
+ modelExists: existsSync(modelPath),
181
+ adoptionExists: existsSync(adoptionPath),
182
+ modelPath,
183
+ adoptionPath,
184
+ files: existsSync(ingestDir) ? listFilesRecursive(ingestDir).map((f) => nodePath.relative(cwd, f)) : [],
185
+ };
186
+ if (json) {
187
+ process.stdout.write(asJson(status) + '\n');
188
+ return 0;
189
+ }
190
+ process.stdout.write(header('SharkCraft ingest status'));
191
+ process.stdout.write(kv('ingest dir', status.ingestDirExists ? 'present' : 'missing') + '\n');
192
+ process.stdout.write(kv('model', status.modelExists ? 'present' : 'missing') + '\n');
193
+ process.stdout.write(kv('adoption', status.adoptionExists ? 'present' : 'missing') + '\n');
194
+ if (status.files.length > 0) {
195
+ process.stdout.write(`\nFiles (${status.files.length}):\n`);
196
+ for (const f of status.files.slice(0, 30))
197
+ process.stdout.write(` - ${f}\n`);
198
+ if (status.files.length > 30)
199
+ process.stdout.write(` ... ${status.files.length - 30} more\n`);
200
+ }
201
+ return 0;
202
+ }
203
+ async function runReport(args) {
204
+ const cwd = resolveCwd(args);
205
+ const format = parseFormat(flagString(args, 'format'));
206
+ const modelPath = nodePath.join(cwd, INGEST_BASE, 'repository-knowledge-model.json');
207
+ if (!existsSync(modelPath)) {
208
+ process.stderr.write(`No saved model — run \`shrk ingest repository --write-drafts\` first.\n`);
209
+ return 1;
210
+ }
211
+ const body = readFileSync(modelPath, 'utf8');
212
+ if (format === 'json') {
213
+ process.stdout.write(body);
214
+ return 0;
215
+ }
216
+ // Rebuild a renderable model from the JSON shape.
217
+ const model = JSON.parse(body);
218
+ if (format === 'markdown')
219
+ process.stdout.write(renderRepositoryKnowledgeModelMarkdown(model) + '\n');
220
+ else if (format === 'html')
221
+ process.stdout.write(renderRepositoryKnowledgeModelHtml(model) + '\n');
222
+ else
223
+ process.stdout.write(renderRepositoryKnowledgeModelText(model) + '\n');
224
+ return 0;
225
+ }
226
+ async function runAdopt(args) {
227
+ // `ingest adopt plan|review|apply` removed; use `onboard adopt`.
228
+ const sub = args.positional[0];
229
+ if (sub === 'plan' || sub === 'review' || sub === 'apply') {
230
+ process.stderr.write('`ingest adopt ' + sub + '` was removed. Use `shrk onboard adopt` (the canonical adoption surface).\n');
231
+ return 2;
232
+ }
233
+ const cwd = resolveCwd(args);
234
+ const json = flagBool(args, 'json');
235
+ const writePatch = flagBool(args, 'write-patch');
236
+ const { model } = await buildModel(args, cwd);
237
+ const plan = buildIngestAdoptionPlan({ model });
238
+ let written;
239
+ if (writePatch)
240
+ written = writeIngestAdoption({ plan });
241
+ if (json) {
242
+ process.stdout.write(asJson({
243
+ plan: {
244
+ counts: plan.counts,
245
+ reviewRequired: plan.reviewRequired,
246
+ },
247
+ written: written?.outDir,
248
+ }) + '\n');
249
+ return 0;
250
+ }
251
+ process.stdout.write(header('Ingest adopt'));
252
+ process.stdout.write(kv('review required', plan.reviewRequired ? 'yes' : 'no') + '\n');
253
+ process.stdout.write(`\n${renderIngestAdoptionPlanMarkdown(plan)}\n`);
254
+ if (written)
255
+ process.stdout.write(`\nWrote adoption files to ${written.outDir}\n`);
256
+ return 0;
257
+ }
258
+ async function runAdoptPlan(args) {
259
+ const cwd = resolveCwd(args);
260
+ const includeFlag = flagList(args, 'include');
261
+ const outputFlag = flagString(args, 'output');
262
+ const includeManualReview = flagBool(args, 'include-manual-review');
263
+ const includeBody = flagBool(args, 'include-body');
264
+ const { model } = await buildModel(args, cwd);
265
+ const adoption = buildIngestAdoptionPlan({ model });
266
+ const include = includeFlag.length > 0
267
+ ? includeFlag.map((s) => s)
268
+ : [IngestAdoptionStatus.SafeAppend];
269
+ const built = buildIngestApplyPlan({
270
+ plan: adoption,
271
+ include,
272
+ includeManualReview,
273
+ ...(includeBody ? { includeBody: true } : {}),
274
+ note: 'Generated by `shrk ingest adopt plan`.',
275
+ });
276
+ const secret = process.env.SHARKCRAFT_PLAN_SECRET;
277
+ const finalPlan = secret ? signIngestApplyPlan(built.plan, secret) : built.plan;
278
+ const outFile = outputFlag
279
+ ? (nodePath.isAbsolute(outputFlag) ? outputFlag : nodePath.join(cwd, outputFlag))
280
+ : nodePath.join(cwd, INGEST_BASE, 'adoption', 'ingest-adopt-plan.json');
281
+ saveIngestApplyPlan(finalPlan, outFile);
282
+ process.stdout.write(`Wrote ${outFile}\n`);
283
+ process.stdout.write(` changes: ${finalPlan.expectedChanges.length}\n`);
284
+ process.stdout.write(` signed: ${finalPlan.signature ? 'yes' : 'no — set SHARKCRAFT_PLAN_SECRET to sign'}\n`);
285
+ process.stdout.write(` skipped: ${built.skipped.length}\n`);
286
+ if (built.bodyStatuses && built.bodyStatuses.length > 0) {
287
+ const m = built.bodyStatuses.filter((b) => b.status === 'materialised').length;
288
+ const s = built.bodyStatuses.filter((b) => b.status === 'stubbed').length;
289
+ const sk = built.bodyStatuses.filter((b) => b.status === 'skipped').length;
290
+ const c = built.bodyStatuses.filter((b) => b.status === 'conflict').length;
291
+ process.stdout.write(` bodies: ${m} materialised, ${s} stubbed, ${sk} skipped, ${c} conflict\n`);
292
+ }
293
+ process.stdout.write(`\nNext: shrk ingest adopt review ${outFile}\n`);
294
+ return 0;
295
+ }
296
+ async function runAdoptReview(args) {
297
+ const cwd = resolveCwd(args);
298
+ const planFile = args.positional[0] ?? nodePath.join(cwd, INGEST_BASE, 'adoption', 'ingest-adopt-plan.json');
299
+ const plan = loadIngestApplyPlan(nodePath.isAbsolute(planFile) ? planFile : nodePath.join(cwd, planFile));
300
+ if (!plan) {
301
+ process.stderr.write(`Plan not found or invalid: ${planFile}\n`);
302
+ return 1;
303
+ }
304
+ process.stdout.write(renderIngestApplyReviewMarkdown(plan) + '\n');
305
+ return 0;
306
+ }
307
+ async function runAdoptApply(args) {
308
+ const cwd = resolveCwd(args);
309
+ const verifySignature = flagBool(args, 'verify-signature');
310
+ const planFile = args.positional[0] ?? nodePath.join(cwd, INGEST_BASE, 'adoption', 'ingest-adopt-plan.json');
311
+ const planAbs = nodePath.isAbsolute(planFile) ? planFile : nodePath.join(cwd, planFile);
312
+ const plan = loadIngestApplyPlan(planAbs);
313
+ if (!plan) {
314
+ process.stderr.write(`Plan not found or invalid: ${planFile}\n`);
315
+ return 1;
316
+ }
317
+ const secret = process.env.SHARKCRAFT_PLAN_SECRET;
318
+ if (verifySignature && !secret) {
319
+ process.stderr.write('--verify-signature requested but SHARKCRAFT_PLAN_SECRET is not set.\n');
320
+ return 1;
321
+ }
322
+ // Rebuild the bodies from the adoption state — keeps `apply` deterministic.
323
+ const { model } = await buildModel(args, cwd);
324
+ const adoption = buildIngestAdoptionPlan({ model });
325
+ const include = plan.expectedChanges.length > 0 ? [IngestAdoptionStatus.SafeAppend] : [IngestAdoptionStatus.SafeAppend];
326
+ const built = buildIngestApplyPlan({ plan: adoption, include });
327
+ const result = applyIngestPlan({
328
+ plan,
329
+ files: built.files,
330
+ requireSignature: verifySignature,
331
+ ...(secret ? { secret } : {}),
332
+ });
333
+ process.stdout.write(`Applied ${result.applied.length} change(s).\n`);
334
+ for (const a of result.applied)
335
+ process.stdout.write(` - wrote ${a.path} (+${a.bytesWritten}B)\n`);
336
+ if (result.skipped.length > 0) {
337
+ process.stdout.write(`\nSkipped:\n`);
338
+ for (const s of result.skipped)
339
+ process.stdout.write(` - ${s.path}: ${s.reason}\n`);
340
+ }
341
+ return 0;
342
+ }
343
+ async function runDiff(args) {
344
+ const cwd = resolveCwd(args);
345
+ const format = parseFormat(flagString(args, 'format'));
346
+ const json = flagBool(args, 'json');
347
+ const { model } = await buildModel(args, cwd);
348
+ const plan = buildIngestAdoptionPlan({ model });
349
+ if (json) {
350
+ process.stdout.write(asJson({ counts: plan.counts, entries: plan.entries }) + '\n');
351
+ return 0;
352
+ }
353
+ const body = format === 'markdown' ? renderIngestAdoptionPlanMarkdown(plan) : renderIngestAdoptionPatch(plan);
354
+ process.stdout.write(body + '\n');
355
+ return 0;
356
+ }
357
+ async function runClean(args) {
358
+ const cwd = resolveCwd(args);
359
+ const write = flagBool(args, 'write');
360
+ const dryRun = flagBool(args, 'dry-run') || !write;
361
+ const ingestDir = nodePath.join(cwd, INGEST_BASE);
362
+ if (!existsSync(ingestDir)) {
363
+ process.stdout.write('Nothing to clean — sharkcraft/ingestion/ does not exist.\n');
364
+ return 0;
365
+ }
366
+ const files = listFilesRecursive(ingestDir);
367
+ if (dryRun) {
368
+ process.stdout.write(`Would remove ${files.length} files from ${ingestDir}\n`);
369
+ for (const f of files.slice(0, 30))
370
+ process.stdout.write(` - ${nodePath.relative(cwd, f)}\n`);
371
+ if (files.length > 30)
372
+ process.stdout.write(` ... ${files.length - 30} more\n`);
373
+ process.stdout.write('\nRe-run with --write to actually delete.\n');
374
+ return 0;
375
+ }
376
+ rmSync(ingestDir, { recursive: true, force: true });
377
+ process.stdout.write(`Removed ${ingestDir}\n`);
378
+ return 0;
379
+ }
380
+ function parseFormat(raw) {
381
+ switch ((raw ?? 'text').toLowerCase()) {
382
+ case 'markdown':
383
+ case 'md':
384
+ return 'markdown';
385
+ case 'html':
386
+ return 'html';
387
+ case 'json':
388
+ return 'json';
389
+ default:
390
+ return 'text';
391
+ }
392
+ }
393
+ function parseSection(raw) {
394
+ for (const s of Object.values(IngestSection)) {
395
+ if (s === raw)
396
+ return s;
397
+ }
398
+ return undefined;
399
+ }
400
+ function writeOutput(cwd, relOrAbs, body) {
401
+ const full = nodePath.isAbsolute(relOrAbs) ? relOrAbs : nodePath.join(cwd, relOrAbs);
402
+ const dir = nodePath.dirname(full);
403
+ if (!existsSync(dir))
404
+ mkdirSync(dir, { recursive: true });
405
+ writeFileSync(full, body, 'utf8');
406
+ process.stderr.write(`wrote ${full}\n`);
407
+ }
408
+ function listFilesRecursive(dir) {
409
+ const out = [];
410
+ const visit = (d) => {
411
+ let entries;
412
+ try {
413
+ entries = readdirSync(d);
414
+ }
415
+ catch {
416
+ return;
417
+ }
418
+ for (const e of entries) {
419
+ const full = nodePath.join(d, e);
420
+ let st;
421
+ try {
422
+ st = statSync(full);
423
+ }
424
+ catch {
425
+ continue;
426
+ }
427
+ if (st.isDirectory())
428
+ visit(full);
429
+ else
430
+ out.push(full);
431
+ }
432
+ };
433
+ visit(dir);
434
+ return out;
435
+ }
436
+ // Companion top-level commands that share the same backbone.
437
+ export const contradictionsCommand = {
438
+ name: 'contradictions',
439
+ description: 'Detect contradictions between docs/configs and the actual repo (missing paths, deprecated CLI usage, missing commands). Read-only.',
440
+ usage: 'shrk [--cwd <dir>] contradictions [--format text|markdown|html|json]',
441
+ async run(args) {
442
+ const cwd = resolveCwd(args);
443
+ const format = parseFormat(flagString(args, 'format'));
444
+ const inspection = await inspectSharkcraft({ cwd });
445
+ const report = buildContradictionReport({ inspection });
446
+ if (format === 'json')
447
+ process.stdout.write(renderContradictionReportJson(report) + '\n');
448
+ else if (format === 'markdown')
449
+ process.stdout.write(renderContradictionReportMarkdown(report) + '\n');
450
+ else if (format === 'html')
451
+ process.stdout.write(renderContradictionReportHtml(report) + '\n');
452
+ else
453
+ process.stdout.write(renderContradictionReportText(report) + '\n');
454
+ return 0;
455
+ },
456
+ };
457
+ export const generatedCommand = {
458
+ name: 'generated',
459
+ description: 'Generated-code classifier. Subcommands: `report` (default), `protect --write-drafts`. Read-only by default.',
460
+ usage: 'shrk [--cwd <dir>] generated [report|protect] [--format text|markdown|json] [--write-drafts]',
461
+ async run(args) {
462
+ const sub = args.positional[0] === 'protect' ? 'protect' : 'report';
463
+ const rest = { ...args, positional: args.positional.slice(args.positional[0] === 'report' || args.positional[0] === 'protect' ? 1 : 0) };
464
+ const cwd = resolveCwd(rest);
465
+ const format = parseFormat(flagString(rest, 'format'));
466
+ const inspection = await inspectSharkcraft({ cwd });
467
+ const report = buildGeneratedCodeReport({ inspection });
468
+ if (sub === 'protect') {
469
+ const writeDrafts = flagBool(rest, 'write-drafts');
470
+ const outDir = nodePath.join(cwd, INGEST_BASE);
471
+ if (writeDrafts) {
472
+ if (!existsSync(outDir))
473
+ mkdirSync(outDir, { recursive: true });
474
+ const target = nodePath.join(outDir, 'GENERATED_PROTECT.md');
475
+ writeFileSync(target, renderGeneratedCodeReportMarkdown(report), 'utf8');
476
+ process.stdout.write(`Wrote ${target}\n`);
477
+ return 0;
478
+ }
479
+ process.stdout.write(renderGeneratedCodeReportMarkdown(report) + '\n');
480
+ process.stdout.write('\nRe-run with --write-drafts to save the recommended protect rules under sharkcraft/ingestion/.\n');
481
+ return 0;
482
+ }
483
+ if (format === 'json')
484
+ process.stdout.write(renderGeneratedCodeReportJson(report) + '\n');
485
+ else if (format === 'markdown')
486
+ process.stdout.write(renderGeneratedCodeReportMarkdown(report) + '\n');
487
+ else
488
+ process.stdout.write(renderGeneratedCodeReportText(report) + '\n');
489
+ return 0;
490
+ },
491
+ };
492
+ export const stabilityCommand = {
493
+ name: 'stability',
494
+ description: 'Stability classification (stable/experimental/deprecated/legacy/generated/internal/public-api/high-risk). Read-only.',
495
+ usage: 'shrk [--cwd <dir>] stability [map|area <id>] [--format text|markdown|json]',
496
+ async run(args) {
497
+ const sub = args.positional[0];
498
+ const cwd = resolveCwd(args);
499
+ const format = parseFormat(flagString(args, 'format'));
500
+ const inspection = await inspectSharkcraft({ cwd });
501
+ const generated = buildGeneratedCodeReport({ inspection });
502
+ const map = buildStabilityMap({
503
+ inspection,
504
+ generatedRoots: generated.generatedRoots.map((r) => r.path),
505
+ });
506
+ if (sub === 'area') {
507
+ const id = args.positional[1];
508
+ if (!id) {
509
+ process.stderr.write('Usage: shrk stability area <id>\n');
510
+ return 1;
511
+ }
512
+ const area = map.areas.find((a) => a.id === id || a.path === id);
513
+ if (!area) {
514
+ process.stderr.write(`No stability area found for "${id}".\n`);
515
+ return 1;
516
+ }
517
+ if (format === 'json')
518
+ process.stdout.write(asJson(area) + '\n');
519
+ else
520
+ process.stdout.write(`${area.kind} (${area.confidence})\n path: ${area.path}\n signals: ${area.signals.join(', ')}\n` + (area.note ? ` note: ${area.note}\n` : ''));
521
+ return 0;
522
+ }
523
+ if (format === 'json')
524
+ process.stdout.write(renderStabilityMapJson(map) + '\n');
525
+ else if (format === 'markdown')
526
+ process.stdout.write(renderStabilityMapMarkdown(map) + '\n');
527
+ else
528
+ process.stdout.write(renderStabilityMapText(map) + '\n');
529
+ return 0;
530
+ },
531
+ };
532
+ void parseFormat;
@@ -0,0 +1,3 @@
1
+ import { type ICommandHandler } from '../command-registry.js';
2
+ export declare const initCommand: ICommandHandler;
3
+ //# sourceMappingURL=init.command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../src/commands/init.command.ts"],"names":[],"mappings":"AAeA,OAAO,EAAwB,KAAK,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AAuQjH,eAAO,MAAM,WAAW,EAAE,eA2FzB,CAAC"}