@canonical/pragma-cli 0.34.0 → 0.36.0

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 (832) hide show
  1. package/README.md +153 -30
  2. package/bundled-skills/add-standard/SKILL.md +338 -0
  3. package/bundled-skills/adoption-a1-styles/SKILL.md +269 -0
  4. package/bundled-skills/adoption-a2-components/SKILL.md +291 -0
  5. package/bundled-skills/adoption-a3-forms/SKILL.md +260 -0
  6. package/bundled-skills/anatomy-author/ANATOMY_DSL_SPEC.md +406 -0
  7. package/bundled-skills/anatomy-author/SKILL.md +1226 -0
  8. package/bundled-skills/design-auditor/SKILL.md +455 -0
  9. package/bundled-skills/implement-component/SKILL.md +333 -0
  10. package/bundled-skills/specify-component/SKILL.md +331 -0
  11. package/bundled-skills/specify-pattern/SKILL.md +292 -0
  12. package/dist/.build-ok +0 -0
  13. package/dist/package.json +84 -0
  14. package/dist/pragma.conf.js +1016 -0
  15. package/dist/pragma.conf.js.map +1 -0
  16. package/dist/src/bin.js +356 -0
  17. package/dist/src/bin.js.map +1 -0
  18. package/dist/src/capabilities/capabilities/capabilities.render.js +70 -0
  19. package/dist/src/capabilities/capabilities/capabilities.render.js.map +1 -0
  20. package/dist/src/capabilities/capabilities/capabilities.verb.js +59 -0
  21. package/dist/src/capabilities/capabilities/capabilities.verb.js.map +1 -0
  22. package/dist/src/capabilities/capabilities/catalog.js +130 -0
  23. package/dist/src/capabilities/capabilities/catalog.js.map +1 -0
  24. package/dist/src/capabilities/capabilities/hints.js +195 -0
  25. package/dist/src/capabilities/capabilities/hints.js.map +1 -0
  26. package/dist/src/capabilities/capabilities/index.js +11 -0
  27. package/dist/src/capabilities/capabilities/index.js.map +1 -0
  28. package/dist/src/capabilities/capabilities/types.js +11 -0
  29. package/dist/src/capabilities/capabilities/types.js.map +1 -0
  30. package/dist/src/capabilities/colophon/collectColophon.js +83 -0
  31. package/dist/src/capabilities/colophon/collectColophon.js.map +1 -0
  32. package/dist/src/capabilities/colophon/colophon.render.js +59 -0
  33. package/dist/src/capabilities/colophon/colophon.render.js.map +1 -0
  34. package/dist/src/capabilities/colophon/colophon.verb.js +43 -0
  35. package/dist/src/capabilities/colophon/colophon.verb.js.map +1 -0
  36. package/dist/src/capabilities/colophon/index.js +5 -0
  37. package/dist/src/capabilities/colophon/index.js.map +1 -0
  38. package/dist/src/capabilities/colophon/markdownTerminal.js +90 -0
  39. package/dist/src/capabilities/colophon/markdownTerminal.js.map +1 -0
  40. package/dist/src/capabilities/colophon/types.js +10 -0
  41. package/dist/src/capabilities/colophon/types.js.map +1 -0
  42. package/dist/src/capabilities/config/collectConfigShow.js +59 -0
  43. package/dist/src/capabilities/config/collectConfigShow.js.map +1 -0
  44. package/dist/src/capabilities/config/field.render.js +22 -0
  45. package/dist/src/capabilities/config/field.render.js.map +1 -0
  46. package/dist/src/capabilities/config/fields.js +46 -0
  47. package/dist/src/capabilities/config/fields.js.map +1 -0
  48. package/dist/src/capabilities/config/get.verb.js +61 -0
  49. package/dist/src/capabilities/config/get.verb.js.map +1 -0
  50. package/dist/src/capabilities/config/index.js +5 -0
  51. package/dist/src/capabilities/config/index.js.map +1 -0
  52. package/dist/src/capabilities/config/runField.js +59 -0
  53. package/dist/src/capabilities/config/runField.js.map +1 -0
  54. package/dist/src/capabilities/config/runGet.js +28 -0
  55. package/dist/src/capabilities/config/runGet.js.map +1 -0
  56. package/dist/src/capabilities/config/runSet.js +53 -0
  57. package/dist/src/capabilities/config/runSet.js.map +1 -0
  58. package/dist/src/capabilities/config/set.verb.js +66 -0
  59. package/dist/src/capabilities/config/set.verb.js.map +1 -0
  60. package/dist/src/capabilities/config/show.render.js +84 -0
  61. package/dist/src/capabilities/config/show.render.js.map +1 -0
  62. package/dist/src/capabilities/config/show.verb.js +44 -0
  63. package/dist/src/capabilities/config/show.verb.js.map +1 -0
  64. package/dist/src/capabilities/config/types.js +5 -0
  65. package/dist/src/capabilities/config/types.js.map +1 -0
  66. package/dist/src/capabilities/config/unset.verb.js +49 -0
  67. package/dist/src/capabilities/config/unset.verb.js.map +1 -0
  68. package/dist/src/capabilities/create/cliProjection.js +195 -0
  69. package/dist/src/capabilities/create/cliProjection.js.map +1 -0
  70. package/dist/src/capabilities/create/constants.js +47 -0
  71. package/dist/src/capabilities/create/constants.js.map +1 -0
  72. package/dist/src/capabilities/create/create.render.js +100 -0
  73. package/dist/src/capabilities/create/create.render.js.map +1 -0
  74. package/dist/src/capabilities/create/create.verb.js +438 -0
  75. package/dist/src/capabilities/create/create.verb.js.map +1 -0
  76. package/dist/src/capabilities/create/createHelp.js +47 -0
  77. package/dist/src/capabilities/create/createHelp.js.map +1 -0
  78. package/dist/src/capabilities/create/createSurface.generated.js +394 -0
  79. package/dist/src/capabilities/create/createSurface.generated.js.map +1 -0
  80. package/dist/src/capabilities/create/generatorToVerbSpec.js +106 -0
  81. package/dist/src/capabilities/create/generatorToVerbSpec.js.map +1 -0
  82. package/dist/src/capabilities/create/index.js +18 -0
  83. package/dist/src/capabilities/create/index.js.map +1 -0
  84. package/dist/src/capabilities/create/messages.js +16 -0
  85. package/dist/src/capabilities/create/messages.js.map +1 -0
  86. package/dist/src/capabilities/create/mount.js +294 -0
  87. package/dist/src/capabilities/create/mount.js.map +1 -0
  88. package/dist/src/capabilities/create/pathJail.js +65 -0
  89. package/dist/src/capabilities/create/pathJail.js.map +1 -0
  90. package/dist/src/capabilities/create/pickGenerator.js +53 -0
  91. package/dist/src/capabilities/create/pickGenerator.js.map +1 -0
  92. package/dist/src/capabilities/create/types.js +2 -0
  93. package/dist/src/capabilities/create/types.js.map +1 -0
  94. package/dist/src/capabilities/distribution.js +40 -0
  95. package/dist/src/capabilities/distribution.js.map +1 -0
  96. package/dist/src/capabilities/doctor/checks/checkKeStore.js +40 -0
  97. package/dist/src/capabilities/doctor/checks/checkKeStore.js.map +1 -0
  98. package/dist/src/capabilities/doctor/checks/checkNodeVersion.js +21 -0
  99. package/dist/src/capabilities/doctor/checks/checkNodeVersion.js.map +1 -0
  100. package/dist/src/capabilities/doctor/checks/checkPackageRefs.js +148 -0
  101. package/dist/src/capabilities/doctor/checks/checkPackageRefs.js.map +1 -0
  102. package/dist/src/capabilities/doctor/checks/checkPragmaVersion.js +19 -0
  103. package/dist/src/capabilities/doctor/checks/checkPragmaVersion.js.map +1 -0
  104. package/dist/src/capabilities/doctor/checks/checkShellCompletions.js +199 -0
  105. package/dist/src/capabilities/doctor/checks/checkShellCompletions.js.map +1 -0
  106. package/dist/src/capabilities/doctor/checks/harnessInventory.js +195 -0
  107. package/dist/src/capabilities/doctor/checks/harnessInventory.js.map +1 -0
  108. package/dist/src/capabilities/doctor/checks/index.js +27 -0
  109. package/dist/src/capabilities/doctor/checks/index.js.map +1 -0
  110. package/dist/src/capabilities/doctor/checks/mcpCommand.js +57 -0
  111. package/dist/src/capabilities/doctor/checks/mcpCommand.js.map +1 -0
  112. package/dist/src/capabilities/doctor/checks/targetHealth.js +349 -0
  113. package/dist/src/capabilities/doctor/checks/targetHealth.js.map +1 -0
  114. package/dist/src/capabilities/doctor/doctor.render.js +164 -0
  115. package/dist/src/capabilities/doctor/doctor.render.js.map +1 -0
  116. package/dist/src/capabilities/doctor/doctor.verb.js +49 -0
  117. package/dist/src/capabilities/doctor/doctor.verb.js.map +1 -0
  118. package/dist/src/capabilities/doctor/index.js +5 -0
  119. package/dist/src/capabilities/doctor/index.js.map +1 -0
  120. package/dist/src/capabilities/doctor/runChecks.js +86 -0
  121. package/dist/src/capabilities/doctor/runChecks.js.map +1 -0
  122. package/dist/src/capabilities/doctor/types.js +5 -0
  123. package/dist/src/capabilities/doctor/types.js.map +1 -0
  124. package/dist/src/capabilities/graph/index.js +19 -0
  125. package/dist/src/capabilities/graph/index.js.map +1 -0
  126. package/dist/src/capabilities/graph/inspect.render.js +76 -0
  127. package/dist/src/capabilities/graph/inspect.render.js.map +1 -0
  128. package/dist/src/capabilities/graph/inspect.verb.js +53 -0
  129. package/dist/src/capabilities/graph/inspect.verb.js.map +1 -0
  130. package/dist/src/capabilities/graph/query.render.js +73 -0
  131. package/dist/src/capabilities/graph/query.render.js.map +1 -0
  132. package/dist/src/capabilities/graph/query.verb.js +49 -0
  133. package/dist/src/capabilities/graph/query.verb.js.map +1 -0
  134. package/dist/src/capabilities/graph/runQuery.js +41 -0
  135. package/dist/src/capabilities/graph/runQuery.js.map +1 -0
  136. package/dist/src/capabilities/index.js +56 -0
  137. package/dist/src/capabilities/index.js.map +1 -0
  138. package/dist/src/capabilities/info/collectInfo.js +72 -0
  139. package/dist/src/capabilities/info/collectInfo.js.map +1 -0
  140. package/dist/src/capabilities/info/index.js +5 -0
  141. package/dist/src/capabilities/info/index.js.map +1 -0
  142. package/dist/src/capabilities/info/info.render.js +57 -0
  143. package/dist/src/capabilities/info/info.render.js.map +1 -0
  144. package/dist/src/capabilities/info/info.verb.js +42 -0
  145. package/dist/src/capabilities/info/info.verb.js.map +1 -0
  146. package/dist/src/capabilities/info/types.js +5 -0
  147. package/dist/src/capabilities/info/types.js.map +1 -0
  148. package/dist/src/capabilities/meta/complete.verb.js +43 -0
  149. package/dist/src/capabilities/meta/complete.verb.js.map +1 -0
  150. package/dist/src/capabilities/meta/index.js +13 -0
  151. package/dist/src/capabilities/meta/index.js.map +1 -0
  152. package/dist/src/capabilities/meta/mcp.verb.js +34 -0
  153. package/dist/src/capabilities/meta/mcp.verb.js.map +1 -0
  154. package/dist/src/capabilities/ontology/index.js +21 -0
  155. package/dist/src/capabilities/ontology/index.js.map +1 -0
  156. package/dist/src/capabilities/ontology/queries.js +123 -0
  157. package/dist/src/capabilities/ontology/queries.js.map +1 -0
  158. package/dist/src/capabilities/ontology/render.js +66 -0
  159. package/dist/src/capabilities/ontology/render.js.map +1 -0
  160. package/dist/src/capabilities/ontology/verbs.js +181 -0
  161. package/dist/src/capabilities/ontology/verbs.js.map +1 -0
  162. package/dist/src/capabilities/prompt/index.js +16 -0
  163. package/dist/src/capabilities/prompt/index.js.map +1 -0
  164. package/dist/src/capabilities/prompt/prompt.render.js +78 -0
  165. package/dist/src/capabilities/prompt/prompt.render.js.map +1 -0
  166. package/dist/src/capabilities/prompt/types.js +10 -0
  167. package/dist/src/capabilities/prompt/types.js.map +1 -0
  168. package/dist/src/capabilities/prompt/verbs.js +93 -0
  169. package/dist/src/capabilities/prompt/verbs.js.map +1 -0
  170. package/dist/src/capabilities/resources/index.js +10 -0
  171. package/dist/src/capabilities/resources/index.js.map +1 -0
  172. package/dist/src/capabilities/resources/provider.js +423 -0
  173. package/dist/src/capabilities/resources/provider.js.map +1 -0
  174. package/dist/src/capabilities/setup/buildPlan.js +172 -0
  175. package/dist/src/capabilities/setup/buildPlan.js.map +1 -0
  176. package/dist/src/capabilities/setup/index.js +5 -0
  177. package/dist/src/capabilities/setup/index.js.map +1 -0
  178. package/dist/src/capabilities/setup/mode.js +53 -0
  179. package/dist/src/capabilities/setup/mode.js.map +1 -0
  180. package/dist/src/capabilities/setup/operations/index.js +39 -0
  181. package/dist/src/capabilities/setup/operations/index.js.map +1 -0
  182. package/dist/src/capabilities/setup/operations/setupCompletions.js +160 -0
  183. package/dist/src/capabilities/setup/operations/setupCompletions.js.map +1 -0
  184. package/dist/src/capabilities/setup/operations/setupConfig.js +101 -0
  185. package/dist/src/capabilities/setup/operations/setupConfig.js.map +1 -0
  186. package/dist/src/capabilities/setup/operations/setupGenerator.js +390 -0
  187. package/dist/src/capabilities/setup/operations/setupGenerator.js.map +1 -0
  188. package/dist/src/capabilities/setup/operations/setupLsp.js +329 -0
  189. package/dist/src/capabilities/setup/operations/setupLsp.js.map +1 -0
  190. package/dist/src/capabilities/setup/operations/setupMcp.js +253 -0
  191. package/dist/src/capabilities/setup/operations/setupMcp.js.map +1 -0
  192. package/dist/src/capabilities/setup/operations/setupSkills.js +594 -0
  193. package/dist/src/capabilities/setup/operations/setupSkills.js.map +1 -0
  194. package/dist/src/capabilities/setup/plan.js +128 -0
  195. package/dist/src/capabilities/setup/plan.js.map +1 -0
  196. package/dist/src/capabilities/setup/plan.render.js +271 -0
  197. package/dist/src/capabilities/setup/plan.render.js.map +1 -0
  198. package/dist/src/capabilities/setup/setup.render.js +54 -0
  199. package/dist/src/capabilities/setup/setup.render.js.map +1 -0
  200. package/dist/src/capabilities/setup/setup.verb.js +387 -0
  201. package/dist/src/capabilities/setup/setup.verb.js.map +1 -0
  202. package/dist/src/capabilities/setup/shell.js +196 -0
  203. package/dist/src/capabilities/setup/shell.js.map +1 -0
  204. package/dist/src/capabilities/setup/targets.js +328 -0
  205. package/dist/src/capabilities/setup/targets.js.map +1 -0
  206. package/dist/src/capabilities/setup/types.js +5 -0
  207. package/dist/src/capabilities/setup/types.js.map +1 -0
  208. package/dist/src/capabilities/shared/assertExecOk.js +137 -0
  209. package/dist/src/capabilities/shared/assertExecOk.js.map +1 -0
  210. package/dist/src/capabilities/shared/index.js +27 -0
  211. package/dist/src/capabilities/shared/index.js.map +1 -0
  212. package/dist/src/capabilities/shared/packageManager.js +349 -0
  213. package/dist/src/capabilities/shared/packageManager.js.map +1 -0
  214. package/dist/src/capabilities/shared/registry.js +55 -0
  215. package/dist/src/capabilities/shared/registry.js.map +1 -0
  216. package/dist/src/capabilities/skill/discover.js +281 -0
  217. package/dist/src/capabilities/skill/discover.js.map +1 -0
  218. package/dist/src/capabilities/skill/index.js +10 -0
  219. package/dist/src/capabilities/skill/index.js.map +1 -0
  220. package/dist/src/capabilities/skill/render.js +49 -0
  221. package/dist/src/capabilities/skill/render.js.map +1 -0
  222. package/dist/src/capabilities/skill/verbs.js +83 -0
  223. package/dist/src/capabilities/skill/verbs.js.map +1 -0
  224. package/dist/src/capabilities/sources/collectStatus.js +103 -0
  225. package/dist/src/capabilities/sources/collectStatus.js.map +1 -0
  226. package/dist/src/capabilities/sources/index.js +13 -0
  227. package/dist/src/capabilities/sources/index.js.map +1 -0
  228. package/dist/src/capabilities/sources/installSkills.js +309 -0
  229. package/dist/src/capabilities/sources/installSkills.js.map +1 -0
  230. package/dist/src/capabilities/sources/runUpdate.js +460 -0
  231. package/dist/src/capabilities/sources/runUpdate.js.map +1 -0
  232. package/dist/src/capabilities/sources/status.render.js +64 -0
  233. package/dist/src/capabilities/sources/status.render.js.map +1 -0
  234. package/dist/src/capabilities/sources/status.verb.js +40 -0
  235. package/dist/src/capabilities/sources/status.verb.js.map +1 -0
  236. package/dist/src/capabilities/sources/types.js +6 -0
  237. package/dist/src/capabilities/sources/types.js.map +1 -0
  238. package/dist/src/capabilities/sources/update.render.js +34 -0
  239. package/dist/src/capabilities/sources/update.render.js.map +1 -0
  240. package/dist/src/capabilities/sources/update.verb.js +55 -0
  241. package/dist/src/capabilities/sources/update.verb.js.map +1 -0
  242. package/dist/src/capabilities/upgrade/index.js +5 -0
  243. package/dist/src/capabilities/upgrade/index.js.map +1 -0
  244. package/dist/src/capabilities/upgrade/runUpgrade.js +135 -0
  245. package/dist/src/capabilities/upgrade/runUpgrade.js.map +1 -0
  246. package/dist/src/capabilities/upgrade/types.js +5 -0
  247. package/dist/src/capabilities/upgrade/types.js.map +1 -0
  248. package/dist/src/capabilities/upgrade/upgrade.render.js +52 -0
  249. package/dist/src/capabilities/upgrade/upgrade.render.js.map +1 -0
  250. package/dist/src/capabilities/upgrade/upgrade.verb.js +52 -0
  251. package/dist/src/capabilities/upgrade/upgrade.verb.js.map +1 -0
  252. package/dist/src/capabilities/version/index.js +10 -0
  253. package/dist/src/capabilities/version/index.js.map +1 -0
  254. package/dist/src/capabilities/version/version.verb.js +36 -0
  255. package/dist/src/capabilities/version/version.verb.js.map +1 -0
  256. package/dist/src/constants.js +87 -0
  257. package/dist/src/constants.js.map +1 -0
  258. package/dist/src/index.js +12 -0
  259. package/dist/src/index.js.map +1 -0
  260. package/dist/src/kernel/completion/complete.js +66 -0
  261. package/dist/src/kernel/completion/complete.js.map +1 -0
  262. package/dist/src/kernel/completion/emitScripts.js +92 -0
  263. package/dist/src/kernel/completion/emitScripts.js.map +1 -0
  264. package/dist/src/kernel/completion/entitySource.js +285 -0
  265. package/dist/src/kernel/completion/entitySource.js.map +1 -0
  266. package/dist/src/kernel/completion/index.js +14 -0
  267. package/dist/src/kernel/completion/index.js.map +1 -0
  268. package/dist/src/kernel/completion/model.js +301 -0
  269. package/dist/src/kernel/completion/model.js.map +1 -0
  270. package/dist/src/kernel/completion/parse.js +253 -0
  271. package/dist/src/kernel/completion/parse.js.map +1 -0
  272. package/dist/src/kernel/completion/rank.js +101 -0
  273. package/dist/src/kernel/completion/rank.js.map +1 -0
  274. package/dist/src/kernel/completion/resolve.js +100 -0
  275. package/dist/src/kernel/completion/resolve.js.map +1 -0
  276. package/dist/src/kernel/completion/templates/bash.js +209 -0
  277. package/dist/src/kernel/completion/templates/bash.js.map +1 -0
  278. package/dist/src/kernel/completion/templates/fish.js +214 -0
  279. package/dist/src/kernel/completion/templates/fish.js.map +1 -0
  280. package/dist/src/kernel/completion/templates/index.js +23 -0
  281. package/dist/src/kernel/completion/templates/index.js.map +1 -0
  282. package/dist/src/kernel/completion/templates/shared.js +98 -0
  283. package/dist/src/kernel/completion/templates/shared.js.map +1 -0
  284. package/dist/src/kernel/completion/templates/zsh.js +201 -0
  285. package/dist/src/kernel/completion/templates/zsh.js.map +1 -0
  286. package/dist/src/kernel/completion/types.js +13 -0
  287. package/dist/src/kernel/completion/types.js.map +1 -0
  288. package/dist/src/kernel/config/defaults.js +17 -0
  289. package/dist/src/kernel/config/defaults.js.map +1 -0
  290. package/dist/src/kernel/config/evaluateProjectConfig.js +126 -0
  291. package/dist/src/kernel/config/evaluateProjectConfig.js.map +1 -0
  292. package/dist/src/kernel/config/findProjectConfig.js +43 -0
  293. package/dist/src/kernel/config/findProjectConfig.js.map +1 -0
  294. package/dist/src/kernel/config/firstRun.js +34 -0
  295. package/dist/src/kernel/config/firstRun.js.map +1 -0
  296. package/dist/src/kernel/config/globalConfig.js +79 -0
  297. package/dist/src/kernel/config/globalConfig.js.map +1 -0
  298. package/dist/src/kernel/config/index.js +16 -0
  299. package/dist/src/kernel/config/index.js.map +1 -0
  300. package/dist/src/kernel/config/paths.js +35 -0
  301. package/dist/src/kernel/config/paths.js.map +1 -0
  302. package/dist/src/kernel/config/readConfig.js +78 -0
  303. package/dist/src/kernel/config/readConfig.js.map +1 -0
  304. package/dist/src/kernel/config/schema.js +130 -0
  305. package/dist/src/kernel/config/schema.js.map +1 -0
  306. package/dist/src/kernel/config/types.js +19 -0
  307. package/dist/src/kernel/config/types.js.map +1 -0
  308. package/dist/src/kernel/config/writeConfigField.js +59 -0
  309. package/dist/src/kernel/config/writeConfigField.js.map +1 -0
  310. package/dist/src/kernel/copy.js +43 -0
  311. package/dist/src/kernel/copy.js.map +1 -0
  312. package/dist/src/kernel/error/PragmaError.js +149 -0
  313. package/dist/src/kernel/error/PragmaError.js.map +1 -0
  314. package/dist/src/kernel/error/constants.js +40 -0
  315. package/dist/src/kernel/error/constants.js.map +1 -0
  316. package/dist/src/kernel/error/fromTaskError.js +96 -0
  317. package/dist/src/kernel/error/fromTaskError.js.map +1 -0
  318. package/dist/src/kernel/error/index.js +13 -0
  319. package/dist/src/kernel/error/index.js.map +1 -0
  320. package/dist/src/kernel/error/recovery.js +52 -0
  321. package/dist/src/kernel/error/recovery.js.map +1 -0
  322. package/dist/src/kernel/error/renderError.js +115 -0
  323. package/dist/src/kernel/error/renderError.js.map +1 -0
  324. package/dist/src/kernel/error/serialize.js +25 -0
  325. package/dist/src/kernel/error/serialize.js.map +1 -0
  326. package/dist/src/kernel/error/types.js +9 -0
  327. package/dist/src/kernel/error/types.js.map +1 -0
  328. package/dist/src/kernel/index.js +34 -0
  329. package/dist/src/kernel/index.js.map +1 -0
  330. package/dist/src/kernel/interactivity.js +68 -0
  331. package/dist/src/kernel/interactivity.js.map +1 -0
  332. package/dist/src/kernel/packs/collect.js +187 -0
  333. package/dist/src/kernel/packs/collect.js.map +1 -0
  334. package/dist/src/kernel/packs/compile.js +304 -0
  335. package/dist/src/kernel/packs/compile.js.map +1 -0
  336. package/dist/src/kernel/packs/disclosure.js +76 -0
  337. package/dist/src/kernel/packs/disclosure.js.map +1 -0
  338. package/dist/src/kernel/packs/glob.js +38 -0
  339. package/dist/src/kernel/packs/glob.js.map +1 -0
  340. package/dist/src/kernel/packs/graphql/buildLookupDocument.js +258 -0
  341. package/dist/src/kernel/packs/graphql/buildLookupDocument.js.map +1 -0
  342. package/dist/src/kernel/packs/graphql/fetchGraphqlLookup.js +157 -0
  343. package/dist/src/kernel/packs/graphql/fetchGraphqlLookup.js.map +1 -0
  344. package/dist/src/kernel/packs/graphql/index.js +20 -0
  345. package/dist/src/kernel/packs/graphql/index.js.map +1 -0
  346. package/dist/src/kernel/packs/graphql/nameMap.js +63 -0
  347. package/dist/src/kernel/packs/graphql/nameMap.js.map +1 -0
  348. package/dist/src/kernel/packs/index.js +34 -0
  349. package/dist/src/kernel/packs/index.js.map +1 -0
  350. package/dist/src/kernel/packs/iri.js +110 -0
  351. package/dist/src/kernel/packs/iri.js.map +1 -0
  352. package/dist/src/kernel/packs/renderPack.js +129 -0
  353. package/dist/src/kernel/packs/renderPack.js.map +1 -0
  354. package/dist/src/kernel/packs/resolveEntity.js +274 -0
  355. package/dist/src/kernel/packs/resolveEntity.js.map +1 -0
  356. package/dist/src/kernel/packs/runBodies.js +140 -0
  357. package/dist/src/kernel/packs/runBodies.js.map +1 -0
  358. package/dist/src/kernel/packs/sample.js +56 -0
  359. package/dist/src/kernel/packs/sample.js.map +1 -0
  360. package/dist/src/kernel/packs/schema.js +421 -0
  361. package/dist/src/kernel/packs/schema.js.map +1 -0
  362. package/dist/src/kernel/packs/sparql/applyFilters.js +167 -0
  363. package/dist/src/kernel/packs/sparql/applyFilters.js.map +1 -0
  364. package/dist/src/kernel/packs/sparql/applySearch.js +25 -0
  365. package/dist/src/kernel/packs/sparql/applySearch.js.map +1 -0
  366. package/dist/src/kernel/packs/sparql/buildLookupQuery.js +480 -0
  367. package/dist/src/kernel/packs/sparql/buildLookupQuery.js.map +1 -0
  368. package/dist/src/kernel/packs/sparql/escape.js +21 -0
  369. package/dist/src/kernel/packs/sparql/escape.js.map +1 -0
  370. package/dist/src/kernel/packs/sparql/index.js +31 -0
  371. package/dist/src/kernel/packs/sparql/index.js.map +1 -0
  372. package/dist/src/kernel/packs/sparql/runSelect.js +101 -0
  373. package/dist/src/kernel/packs/sparql/runSelect.js.map +1 -0
  374. package/dist/src/kernel/packs/types.js +30 -0
  375. package/dist/src/kernel/packs/types.js.map +1 -0
  376. package/dist/src/kernel/packs/uniqueness.js +30 -0
  377. package/dist/src/kernel/packs/uniqueness.js.map +1 -0
  378. package/dist/src/kernel/project/cli/buildProgram.js +263 -0
  379. package/dist/src/kernel/project/cli/buildProgram.js.map +1 -0
  380. package/dist/src/kernel/project/cli/constants.js +27 -0
  381. package/dist/src/kernel/project/cli/constants.js.map +1 -0
  382. package/dist/src/kernel/project/cli/dispatch.js +420 -0
  383. package/dist/src/kernel/project/cli/dispatch.js.map +1 -0
  384. package/dist/src/kernel/project/cli/exitCodes.js +66 -0
  385. package/dist/src/kernel/project/cli/exitCodes.js.map +1 -0
  386. package/dist/src/kernel/project/cli/globalFlags.js +219 -0
  387. package/dist/src/kernel/project/cli/globalFlags.js.map +1 -0
  388. package/dist/src/kernel/project/cli/helpFormat.js +58 -0
  389. package/dist/src/kernel/project/cli/helpFormat.js.map +1 -0
  390. package/dist/src/kernel/project/cli/index.js +14 -0
  391. package/dist/src/kernel/project/cli/index.js.map +1 -0
  392. package/dist/src/kernel/project/cli/rootHelp.js +227 -0
  393. package/dist/src/kernel/project/cli/rootHelp.js.map +1 -0
  394. package/dist/src/kernel/project/cli/suggest.js +75 -0
  395. package/dist/src/kernel/project/cli/suggest.js.map +1 -0
  396. package/dist/src/kernel/project/cli/suggestNames.js +96 -0
  397. package/dist/src/kernel/project/cli/suggestNames.js.map +1 -0
  398. package/dist/src/kernel/project/cli/verbHelp.js +131 -0
  399. package/dist/src/kernel/project/cli/verbHelp.js.map +1 -0
  400. package/dist/src/kernel/project/mcp/buildServer.js +67 -0
  401. package/dist/src/kernel/project/mcp/buildServer.js.map +1 -0
  402. package/dist/src/kernel/project/mcp/envelope.js +37 -0
  403. package/dist/src/kernel/project/mcp/envelope.js.map +1 -0
  404. package/dist/src/kernel/project/mcp/index.js +8 -0
  405. package/dist/src/kernel/project/mcp/index.js.map +1 -0
  406. package/dist/src/kernel/project/mcp/instructions.js +44 -0
  407. package/dist/src/kernel/project/mcp/instructions.js.map +1 -0
  408. package/dist/src/kernel/project/mcp/mcpError.js +42 -0
  409. package/dist/src/kernel/project/mcp/mcpError.js.map +1 -0
  410. package/dist/src/kernel/project/mcp/prompts/index.js +36 -0
  411. package/dist/src/kernel/project/mcp/prompts/index.js.map +1 -0
  412. package/dist/src/kernel/project/mcp/prompts/provider.js +98 -0
  413. package/dist/src/kernel/project/mcp/prompts/provider.js.map +1 -0
  414. package/dist/src/kernel/project/mcp/prompts/source.js +154 -0
  415. package/dist/src/kernel/project/mcp/prompts/source.js.map +1 -0
  416. package/dist/src/kernel/project/mcp/registerVerb.js +315 -0
  417. package/dist/src/kernel/project/mcp/registerVerb.js.map +1 -0
  418. package/dist/src/kernel/project/mcp/serve.js +35 -0
  419. package/dist/src/kernel/project/mcp/serve.js.map +1 -0
  420. package/dist/src/kernel/render/compactUri.js +24 -0
  421. package/dist/src/kernel/render/compactUri.js.map +1 -0
  422. package/dist/src/kernel/render/contracts.js +10 -0
  423. package/dist/src/kernel/render/contracts.js.map +1 -0
  424. package/dist/src/kernel/render/disclosure.js +34 -0
  425. package/dist/src/kernel/render/disclosure.js.map +1 -0
  426. package/dist/src/kernel/render/envelope.js +30 -0
  427. package/dist/src/kernel/render/envelope.js.map +1 -0
  428. package/dist/src/kernel/render/formatters.js +27 -0
  429. package/dist/src/kernel/render/formatters.js.map +1 -0
  430. package/dist/src/kernel/render/index.js +15 -0
  431. package/dist/src/kernel/render/index.js.map +1 -0
  432. package/dist/src/kernel/render/prefixes.js +46 -0
  433. package/dist/src/kernel/render/prefixes.js.map +1 -0
  434. package/dist/src/kernel/render/renderers.js +468 -0
  435. package/dist/src/kernel/render/renderers.js.map +1 -0
  436. package/dist/src/kernel/render/style.js +105 -0
  437. package/dist/src/kernel/render/style.js.map +1 -0
  438. package/dist/src/kernel/render/turtle.js +194 -0
  439. package/dist/src/kernel/render/turtle.js.map +1 -0
  440. package/dist/src/kernel/render/vocabulary.js +174 -0
  441. package/dist/src/kernel/render/vocabulary.js.map +1 -0
  442. package/dist/src/kernel/render/writeStdout.js +43 -0
  443. package/dist/src/kernel/render/writeStdout.js.map +1 -0
  444. package/dist/src/kernel/runtime/boot.js +49 -0
  445. package/dist/src/kernel/runtime/boot.js.map +1 -0
  446. package/dist/src/kernel/runtime/facade.js +39 -0
  447. package/dist/src/kernel/runtime/facade.js.map +1 -0
  448. package/dist/src/kernel/runtime/graphpack/build.js +122 -0
  449. package/dist/src/kernel/runtime/graphpack/build.js.map +1 -0
  450. package/dist/src/kernel/runtime/graphpack/buildIndex.js +303 -0
  451. package/dist/src/kernel/runtime/graphpack/buildIndex.js.map +1 -0
  452. package/dist/src/kernel/runtime/graphpack/embedded/pack.generated.js +6 -0
  453. package/dist/src/kernel/runtime/graphpack/embedded/pack.generated.js.map +1 -0
  454. package/dist/src/kernel/runtime/graphpack/embedded/pack.index.generated.js +4 -0
  455. package/dist/src/kernel/runtime/graphpack/embedded/pack.index.generated.js.map +1 -0
  456. package/dist/src/kernel/runtime/graphpack/embedded/pack.stories.generated.js +4 -0
  457. package/dist/src/kernel/runtime/graphpack/embedded/pack.stories.generated.js.map +1 -0
  458. package/dist/src/kernel/runtime/graphpack/embedded.js +82 -0
  459. package/dist/src/kernel/runtime/graphpack/embedded.js.map +1 -0
  460. package/dist/src/kernel/runtime/graphpack/hash.js +38 -0
  461. package/dist/src/kernel/runtime/graphpack/hash.js.map +1 -0
  462. package/dist/src/kernel/runtime/graphpack/index.js +11 -0
  463. package/dist/src/kernel/runtime/graphpack/index.js.map +1 -0
  464. package/dist/src/kernel/runtime/graphpack/manifest.js +145 -0
  465. package/dist/src/kernel/runtime/graphpack/manifest.js.map +1 -0
  466. package/dist/src/kernel/runtime/graphpack/read.js +92 -0
  467. package/dist/src/kernel/runtime/graphpack/read.js.map +1 -0
  468. package/dist/src/kernel/runtime/graphpack/schemas.js +70 -0
  469. package/dist/src/kernel/runtime/graphpack/schemas.js.map +1 -0
  470. package/dist/src/kernel/runtime/graphpack/stories.js +68 -0
  471. package/dist/src/kernel/runtime/graphpack/stories.js.map +1 -0
  472. package/dist/src/kernel/runtime/graphpack/types.js +55 -0
  473. package/dist/src/kernel/runtime/graphpack/types.js.map +1 -0
  474. package/dist/src/kernel/runtime/index.js +8 -0
  475. package/dist/src/kernel/runtime/index.js.map +1 -0
  476. package/dist/src/kernel/runtime/loadSession.js +34 -0
  477. package/dist/src/kernel/runtime/loadSession.js.map +1 -0
  478. package/dist/src/kernel/runtime/paths.js +78 -0
  479. package/dist/src/kernel/runtime/paths.js.map +1 -0
  480. package/dist/src/kernel/runtime/probe.js +37 -0
  481. package/dist/src/kernel/runtime/probe.js.map +1 -0
  482. package/dist/src/kernel/runtime/readEntity.js +363 -0
  483. package/dist/src/kernel/runtime/readEntity.js.map +1 -0
  484. package/dist/src/kernel/runtime/refs/gitOps.js +65 -0
  485. package/dist/src/kernel/runtime/refs/gitOps.js.map +1 -0
  486. package/dist/src/kernel/runtime/refs/index.js +29 -0
  487. package/dist/src/kernel/runtime/refs/index.js.map +1 -0
  488. package/dist/src/kernel/runtime/refs/parseRef.js +70 -0
  489. package/dist/src/kernel/runtime/refs/parseRef.js.map +1 -0
  490. package/dist/src/kernel/runtime/refs/resolve.js +332 -0
  491. package/dist/src/kernel/runtime/refs/resolve.js.map +1 -0
  492. package/dist/src/kernel/runtime/resolveSources.js +62 -0
  493. package/dist/src/kernel/runtime/resolveSources.js.map +1 -0
  494. package/dist/src/kernel/runtime/store.js +75 -0
  495. package/dist/src/kernel/runtime/store.js.map +1 -0
  496. package/dist/src/kernel/runtime/storeReadiness.js +51 -0
  497. package/dist/src/kernel/runtime/storeReadiness.js.map +1 -0
  498. package/dist/src/kernel/runtime/types.js +11 -0
  499. package/dist/src/kernel/runtime/types.js.map +1 -0
  500. package/dist/src/kernel/spec/asVerb.js +21 -0
  501. package/dist/src/kernel/spec/asVerb.js.map +1 -0
  502. package/dist/src/kernel/spec/emitReference.js +578 -0
  503. package/dist/src/kernel/spec/emitReference.js.map +1 -0
  504. package/dist/src/kernel/spec/emitSurface.js +202 -0
  505. package/dist/src/kernel/spec/emitSurface.js.map +1 -0
  506. package/dist/src/kernel/spec/index.js +11 -0
  507. package/dist/src/kernel/spec/index.js.map +1 -0
  508. package/dist/src/kernel/spec/surfaceConformance.js +103 -0
  509. package/dist/src/kernel/spec/surfaceConformance.js.map +1 -0
  510. package/dist/src/kernel/spec/types.js +14 -0
  511. package/dist/src/kernel/spec/types.js.map +1 -0
  512. package/dist/src/kernel/spec/validate.js +110 -0
  513. package/dist/src/kernel/spec/validate.js.map +1 -0
  514. package/dist/src/kernel/vocabulary.js +97 -0
  515. package/dist/src/kernel/vocabulary.js.map +1 -0
  516. package/dist/src/types.js +11 -0
  517. package/dist/src/types.js.map +1 -0
  518. package/package.json +22 -23
  519. package/pragma.conf.ts +486 -90
  520. package/src/bin.ts +274 -82
  521. package/src/capabilities/block.parity.test.ts +29 -12
  522. package/src/capabilities/block.shipped.exec.test.ts +282 -0
  523. package/src/capabilities/block.tierRank.exec.test.ts +300 -0
  524. package/src/capabilities/capabilities/capabilities.render.ts +1 -1
  525. package/src/capabilities/capabilities/capabilities.verb.ts +1 -1
  526. package/src/capabilities/capabilities/catalog.ts +3 -3
  527. package/src/capabilities/capabilities/hints.ts +32 -7
  528. package/src/capabilities/capabilities/index.ts +1 -1
  529. package/src/capabilities/colophon/collectColophon.ts +35 -24
  530. package/src/capabilities/colophon/colophon.render.ts +24 -1
  531. package/src/capabilities/colophon/colophon.test.ts +42 -21
  532. package/src/capabilities/colophon/colophon.verb.ts +4 -4
  533. package/src/capabilities/config/collectConfigShow.test.ts +1 -0
  534. package/src/capabilities/config/collectConfigShow.ts +3 -3
  535. package/src/capabilities/config/field.render.ts +4 -5
  536. package/src/capabilities/config/fields.ts +17 -10
  537. package/src/capabilities/config/get.verb.ts +70 -0
  538. package/src/capabilities/config/getUnset.test.ts +264 -0
  539. package/src/capabilities/config/index.ts +5 -1
  540. package/src/capabilities/config/runField.ts +40 -22
  541. package/src/capabilities/config/runGet.ts +34 -0
  542. package/src/capabilities/config/runSet.ts +35 -9
  543. package/src/capabilities/config/set.test.ts +48 -14
  544. package/src/capabilities/config/set.verb.ts +8 -7
  545. package/src/capabilities/config/show.render.ts +1 -1
  546. package/src/capabilities/config/show.verb.ts +9 -6
  547. package/src/capabilities/config/types.ts +18 -4
  548. package/src/capabilities/config/unset.verb.ts +58 -0
  549. package/src/capabilities/create/byteEquality.subprocess.test.ts +2 -3
  550. package/src/capabilities/create/byteEquality.test.ts +25 -11
  551. package/src/capabilities/create/cliProjection.ts +227 -0
  552. package/src/capabilities/create/constants.ts +36 -61
  553. package/src/capabilities/create/create.mcp.test.ts +89 -5
  554. package/src/capabilities/create/create.render.ts +71 -7
  555. package/src/capabilities/create/create.test.ts +433 -219
  556. package/src/capabilities/create/create.verb.ts +297 -328
  557. package/src/capabilities/create/createGrammar.test.ts +865 -0
  558. package/src/capabilities/create/createHelp.ts +71 -0
  559. package/src/capabilities/create/createSurface.generated.ts +400 -0
  560. package/src/capabilities/create/crossCli.subprocess.test.ts +745 -0
  561. package/src/capabilities/create/cwdJail.test.ts +24 -5
  562. package/src/capabilities/create/generatorToVerbSpec.test.ts +186 -0
  563. package/src/capabilities/create/generatorToVerbSpec.ts +13 -11
  564. package/src/capabilities/create/index.ts +7 -4
  565. package/src/capabilities/create/messages.ts +18 -0
  566. package/src/capabilities/create/mount.ts +391 -0
  567. package/src/capabilities/create/pathJail.test.ts +90 -0
  568. package/src/capabilities/create/pathJail.ts +8 -5
  569. package/src/capabilities/create/pickGenerator.ts +23 -35
  570. package/src/capabilities/create/shippedCreate.subprocess.test.ts +164 -0
  571. package/src/capabilities/create/types.ts +20 -0
  572. package/src/capabilities/distribution.parity.test.ts +4 -0
  573. package/src/capabilities/distribution.test.ts +3 -1
  574. package/src/capabilities/distribution.ts +10 -15
  575. package/src/capabilities/doctor/checks/checkKeStore.ts +7 -5
  576. package/src/capabilities/doctor/checks/checkPackageRefs.ts +75 -8
  577. package/src/capabilities/doctor/checks/checkPragmaVersion.ts +2 -2
  578. package/src/capabilities/doctor/checks/checkShellCompletions.test.ts +76 -29
  579. package/src/capabilities/doctor/checks/checkShellCompletions.ts +63 -17
  580. package/src/capabilities/doctor/checks/harnessInventory.test.ts +219 -0
  581. package/src/capabilities/doctor/checks/harnessInventory.ts +298 -0
  582. package/src/capabilities/doctor/checks/index.ts +27 -0
  583. package/src/capabilities/doctor/checks/mcpCommand.test.ts +100 -0
  584. package/src/capabilities/doctor/checks/mcpCommand.ts +69 -0
  585. package/src/capabilities/doctor/checks/targetHealth.ts +444 -0
  586. package/src/capabilities/doctor/doctor.render.test.ts +125 -38
  587. package/src/capabilities/doctor/doctor.render.ts +74 -74
  588. package/src/capabilities/doctor/doctor.test.ts +338 -37
  589. package/src/capabilities/doctor/doctor.verb.ts +8 -3
  590. package/src/capabilities/doctor/runChecks.ts +65 -63
  591. package/src/capabilities/doctor/types.ts +22 -15
  592. package/src/capabilities/emptyRecovery.test.ts +21 -8
  593. package/src/capabilities/graph/examples.exec.test.ts +107 -0
  594. package/src/capabilities/graph/index.ts +1 -1
  595. package/src/capabilities/graph/inspect.render.ts +70 -22
  596. package/src/capabilities/graph/inspect.test.ts +260 -5
  597. package/src/capabilities/graph/inspect.verb.ts +18 -6
  598. package/src/capabilities/graph/query.render.ts +15 -3
  599. package/src/capabilities/graph/query.verb.ts +3 -3
  600. package/src/capabilities/graph/runQuery.ts +2 -3
  601. package/src/capabilities/index.ts +3 -1
  602. package/src/capabilities/info/collectInfo.ts +13 -5
  603. package/src/capabilities/info/info.render.ts +7 -3
  604. package/src/capabilities/info/info.test.ts +37 -1
  605. package/src/capabilities/info/info.verb.ts +1 -1
  606. package/src/capabilities/info/types.ts +10 -2
  607. package/src/capabilities/lazy.test.ts +32 -0
  608. package/src/capabilities/meta/complete.verb.ts +1 -1
  609. package/src/capabilities/meta/index.ts +1 -1
  610. package/src/capabilities/meta/mcp.verb.ts +10 -8
  611. package/src/capabilities/ontology/index.ts +15 -11
  612. package/src/capabilities/ontology/ontology.test.ts +6 -55
  613. package/src/capabilities/ontology/queries.ts +2 -2
  614. package/src/capabilities/ontology/render.ts +3 -4
  615. package/src/capabilities/ontology/verbs.ts +27 -68
  616. package/src/capabilities/prompt/index.ts +2 -2
  617. package/src/capabilities/prompt/prompt.render.ts +6 -2
  618. package/src/capabilities/prompt/types.ts +1 -1
  619. package/src/capabilities/prompt/verbs.ts +4 -5
  620. package/src/capabilities/reference.test.ts +63 -0
  621. package/src/capabilities/renderVocabularySync.test.ts +82 -0
  622. package/src/capabilities/resources/provider.ts +342 -85
  623. package/src/capabilities/resources/resources.test.ts +355 -59
  624. package/src/capabilities/scopeTypeSync.test.ts +29 -15
  625. package/src/capabilities/setup/buildPlan.ts +240 -0
  626. package/src/capabilities/setup/index.ts +7 -7
  627. package/src/capabilities/setup/mode.ts +74 -0
  628. package/src/capabilities/setup/operations/index.ts +79 -0
  629. package/src/capabilities/setup/operations/setupCompletions.ts +97 -24
  630. package/src/capabilities/setup/operations/setupConfig.ts +124 -0
  631. package/src/capabilities/setup/operations/setupGenerator.ts +478 -334
  632. package/src/capabilities/setup/operations/setupLsp.ts +420 -67
  633. package/src/capabilities/setup/operations/setupMcp.ts +238 -127
  634. package/src/capabilities/setup/operations/setupSkills.ts +667 -105
  635. package/src/capabilities/setup/plan.render.ts +336 -0
  636. package/src/capabilities/setup/plan.ts +241 -0
  637. package/src/capabilities/setup/setup.mcp.correctness.test.ts +432 -0
  638. package/src/capabilities/setup/setup.render.test.ts +297 -75
  639. package/src/capabilities/setup/setup.render.ts +45 -77
  640. package/src/capabilities/setup/setup.test.ts +1819 -225
  641. package/src/capabilities/setup/setup.verb.ts +288 -78
  642. package/src/capabilities/setup/shell.test.ts +86 -0
  643. package/src/capabilities/setup/shell.ts +137 -11
  644. package/src/capabilities/setup/targets.ts +435 -0
  645. package/src/capabilities/setup/types.ts +23 -70
  646. package/src/capabilities/shared/assertExecOk.ts +68 -10
  647. package/src/capabilities/shared/index.ts +43 -0
  648. package/src/capabilities/shared/packageManager.test.ts +470 -0
  649. package/src/capabilities/shared/packageManager.ts +425 -34
  650. package/src/capabilities/skill/bundledSkills.test.ts +347 -0
  651. package/src/capabilities/skill/discover.ts +131 -10
  652. package/src/capabilities/skill/index.ts +1 -1
  653. package/src/capabilities/skill/render.ts +10 -9
  654. package/src/capabilities/skill/skill.test.ts +22 -7
  655. package/src/capabilities/skill/verbs.ts +3 -4
  656. package/src/capabilities/sources/collectStatus.ts +7 -2
  657. package/src/capabilities/sources/index.ts +1 -1
  658. package/src/capabilities/sources/installSkills.ts +265 -10
  659. package/src/capabilities/sources/runUpdate.ts +131 -23
  660. package/src/capabilities/sources/sources.test.ts +382 -2
  661. package/src/capabilities/sources/status.render.ts +1 -1
  662. package/src/capabilities/sources/status.verb.ts +1 -1
  663. package/src/capabilities/sources/update.render.ts +1 -1
  664. package/src/capabilities/sources/update.verb.ts +4 -4
  665. package/src/capabilities/surface.test.ts +136 -19
  666. package/src/capabilities/upgrade/runUpgrade.ts +53 -14
  667. package/src/capabilities/upgrade/types.ts +10 -2
  668. package/src/capabilities/upgrade/upgrade.render.ts +13 -7
  669. package/src/capabilities/upgrade/upgrade.test.ts +75 -3
  670. package/src/capabilities/upgrade/upgrade.verb.ts +1 -1
  671. package/src/capabilities/version/index.ts +12 -0
  672. package/src/capabilities/version/version.test.ts +66 -0
  673. package/src/capabilities/version/version.verb.ts +39 -0
  674. package/src/constants.ts +36 -1
  675. package/src/identity.test.ts +57 -29
  676. package/src/kernel/completion/__snapshots__/emitScripts.test.ts.snap +15 -13
  677. package/src/kernel/completion/complete.test.ts +12 -2
  678. package/src/kernel/completion/complete.ts +1 -1
  679. package/src/kernel/completion/emitScripts.ts +1 -1
  680. package/src/kernel/completion/entitySource.test.ts +16 -3
  681. package/src/kernel/completion/entitySource.ts +21 -8
  682. package/src/kernel/completion/model.test.ts +164 -12
  683. package/src/kernel/completion/model.ts +94 -14
  684. package/src/kernel/completion/parse.test.ts +4 -7
  685. package/src/kernel/completion/parse.ts +15 -0
  686. package/src/kernel/completion/resolve.test.ts +0 -1
  687. package/src/kernel/completion/safety.test.ts +50 -35
  688. package/src/kernel/completion/shellDrive.test.ts +28 -9
  689. package/src/kernel/completion/templates/bash.ts +7 -2
  690. package/src/kernel/completion/templates/index.ts +23 -0
  691. package/src/kernel/completion/types.ts +7 -0
  692. package/src/kernel/config/defaults.test.ts +27 -3
  693. package/src/kernel/config/defaults.ts +4 -3
  694. package/src/kernel/config/evaluateProjectConfig.ts +31 -8
  695. package/src/kernel/config/firstRun.test.ts +44 -38
  696. package/src/kernel/config/firstRun.ts +24 -88
  697. package/src/kernel/config/index.ts +1 -1
  698. package/src/kernel/config/readConfig.test.ts +6 -3
  699. package/src/kernel/config/readConfig.ts +1 -1
  700. package/src/kernel/config/schema.ts +3 -1
  701. package/src/kernel/config/types.ts +3 -1
  702. package/src/kernel/copy.test.ts +34 -4
  703. package/src/kernel/copy.ts +54 -0
  704. package/src/kernel/error/PragmaError.test.ts +5 -2
  705. package/src/kernel/error/PragmaError.ts +4 -2
  706. package/src/kernel/error/constants.ts +7 -5
  707. package/src/kernel/error/fromTaskError.ts +28 -6
  708. package/src/kernel/error/recovery.ts +14 -0
  709. package/src/kernel/error/renderError.ts +42 -1
  710. package/src/kernel/error/types.ts +21 -1
  711. package/src/kernel/index.ts +35 -0
  712. package/src/kernel/interactivity.test.ts +76 -0
  713. package/src/kernel/interactivity.ts +69 -0
  714. package/src/kernel/packs/collect.ts +12 -16
  715. package/src/kernel/packs/compile.test.ts +222 -1
  716. package/src/kernel/packs/compile.ts +93 -3
  717. package/src/kernel/packs/disclosure.ts +2 -2
  718. package/src/kernel/packs/graphql/buildLookupDocument.ts +1 -1
  719. package/src/kernel/packs/graphql/fetchGraphqlLookup.ts +3 -4
  720. package/src/kernel/packs/graphql/index.ts +20 -0
  721. package/src/kernel/packs/index.ts +40 -0
  722. package/src/kernel/packs/iri.test.ts +73 -0
  723. package/src/kernel/packs/iri.ts +66 -14
  724. package/src/kernel/packs/renderPack.ts +25 -6
  725. package/src/kernel/packs/resolveEntity.test.ts +274 -0
  726. package/src/kernel/packs/resolveEntity.ts +200 -42
  727. package/src/kernel/packs/runBodies.ts +86 -22
  728. package/src/kernel/packs/sample.ts +1 -1
  729. package/src/kernel/packs/schema.ts +78 -5
  730. package/src/kernel/packs/sparql/applyFilters.ts +136 -16
  731. package/src/kernel/packs/sparql/buildLookupQuery.test.ts +290 -0
  732. package/src/kernel/packs/sparql/buildLookupQuery.ts +367 -17
  733. package/src/kernel/packs/sparql/index.ts +37 -0
  734. package/src/kernel/packs/sparql/runSelect.test.ts +1 -1
  735. package/src/kernel/packs/sparql/runSelect.ts +3 -4
  736. package/src/kernel/packs/toolDescription.test.ts +77 -4
  737. package/src/kernel/packs/types.ts +136 -0
  738. package/src/kernel/packs/uniqueness.ts +1 -1
  739. package/src/kernel/project/cli/buildProgram.test.ts +218 -12
  740. package/src/kernel/project/cli/buildProgram.ts +84 -18
  741. package/src/kernel/project/cli/constants.ts +34 -0
  742. package/src/kernel/project/cli/dispatch.test.ts +160 -2
  743. package/src/kernel/project/cli/dispatch.ts +226 -45
  744. package/src/kernel/project/cli/exitCodes.ts +1 -1
  745. package/src/kernel/project/cli/globalFlags.test.ts +117 -1
  746. package/src/kernel/project/cli/globalFlags.ts +134 -31
  747. package/src/kernel/project/cli/helpFormat.ts +14 -2
  748. package/src/kernel/project/cli/rootHelp.ts +74 -12
  749. package/src/kernel/project/cli/suggest.test.ts +33 -1
  750. package/src/kernel/project/cli/suggest.ts +25 -1
  751. package/src/kernel/project/cli/verbHelp.test.ts +30 -0
  752. package/src/kernel/project/cli/verbHelp.ts +23 -7
  753. package/src/kernel/project/mcp/buildServer.ts +7 -4
  754. package/src/kernel/project/mcp/envelope.ts +2 -2
  755. package/src/kernel/project/mcp/instructions.ts +2 -2
  756. package/src/kernel/project/mcp/mcpError.ts +1 -1
  757. package/src/kernel/project/mcp/parity.test.ts +5 -2
  758. package/src/kernel/project/mcp/prompts/index.ts +37 -0
  759. package/src/kernel/project/mcp/prompts/source.ts +2 -2
  760. package/src/kernel/project/mcp/registerVerb.ts +55 -10
  761. package/src/kernel/project/mcp/serve.ts +2 -2
  762. package/src/kernel/render/__snapshots__/renderers.test.ts.snap +7 -4
  763. package/src/kernel/render/contracts.ts +21 -0
  764. package/src/kernel/render/envelope.ts +2 -3
  765. package/src/kernel/render/formatters.ts +1 -1
  766. package/src/kernel/render/renderers.test.ts +243 -6
  767. package/src/kernel/render/renderers.ts +222 -20
  768. package/src/kernel/render/style.test.ts +75 -24
  769. package/src/kernel/render/style.ts +59 -6
  770. package/src/kernel/render/turtle.ts +222 -0
  771. package/src/kernel/render/vocabulary.ts +276 -0
  772. package/src/kernel/runtime/graphpack/buildIndex.ts +1 -1
  773. package/src/kernel/runtime/graphpack/embedded/pack.generated.ts +3 -3
  774. package/src/kernel/runtime/graphpack/embedded/pack.index.generated.ts +1 -1
  775. package/src/kernel/runtime/graphpack/embedded.ts +3 -3
  776. package/src/kernel/runtime/graphpack/manifest.ts +1 -1
  777. package/src/kernel/runtime/graphpack/read.ts +1 -2
  778. package/src/kernel/runtime/loadSession.ts +1 -1
  779. package/src/kernel/runtime/probe.ts +6 -6
  780. package/src/kernel/runtime/readEntity.ts +472 -28
  781. package/src/kernel/runtime/refs/index.ts +39 -0
  782. package/src/kernel/runtime/refs/parseRef.ts +2 -2
  783. package/src/kernel/runtime/refs/resolve.ts +4 -4
  784. package/src/kernel/runtime/storeReadiness.ts +1 -2
  785. package/src/kernel/runtime/types.ts +15 -1
  786. package/src/kernel/runtime/wasmEmbed.test.ts +37 -39
  787. package/src/kernel/spec/emitReference.ts +105 -30
  788. package/src/kernel/spec/emitSurface.ts +48 -6
  789. package/src/kernel/spec/surfaceConformance.test.ts +4 -2
  790. package/src/kernel/spec/types.ts +277 -4
  791. package/src/testing/PARITY_GAPS.ts +9 -3
  792. package/src/testing/behavioral/docExamples.test.ts +16 -0
  793. package/src/testing/behavioral/errorMatrix.mcp.test.ts +112 -9
  794. package/src/testing/behavioral/firstRun.e2e.test.ts +24 -24
  795. package/src/testing/behavioral/journeys.cli.test.ts +1 -1
  796. package/src/testing/behavioral/journeys.defaultPack.test.ts +7 -7
  797. package/src/testing/behavioral/journeys.firstInstall.test.ts +7 -2
  798. package/src/testing/behavioral/journeys.implementation.test.ts +206 -0
  799. package/src/testing/behavioral/journeys.interactiveTty.e2e.test.ts +2 -2
  800. package/src/testing/behavioral/journeys.packageStories.test.ts +10 -7
  801. package/src/testing/behavioral/mcpServe.e2e.test.ts +57 -2
  802. package/src/testing/behavioral/mcpSurface.test.ts +1 -1
  803. package/src/testing/behavioral/rootCli.e2e.test.ts +26 -2
  804. package/src/testing/eval/__snapshots__/eval.test.ts.snap +26 -1
  805. package/src/testing/eval/cases/effectful.ts +3 -2
  806. package/src/testing/eval/cases/readNouns.ts +245 -9
  807. package/src/testing/fixtures/blockGraph.ts +104 -10
  808. package/src/testing/fixtures/graph/canonical.ts +182 -13
  809. package/src/testing/fixtures/graph/defaultPack.ts +1 -1
  810. package/src/testing/helpers/blankCanonicalRanges.ts +36 -0
  811. package/src/testing/helpers/projectMcp.ts +32 -6
  812. package/src/testing/helpers/runCli.ts +35 -18
  813. package/src/testing/perf/budgets.test.ts +20 -9
  814. package/src/testing/perf/budgets.ts +58 -9
  815. package/src/testing/perf/codegen.test.ts +126 -0
  816. package/src/testing/perf/globalSetup.test.ts +286 -0
  817. package/src/testing/perf/globalSetup.ts +505 -23
  818. package/src/testing/perf/measure.test.ts +38 -0
  819. package/src/testing/perf/measure.ts +23 -4
  820. package/src/testing/setupXdgIsolation.ts +81 -21
  821. package/src/testing/tempRoot.globalSetup.ts +122 -0
  822. package/dist/pragma +0 -0
  823. package/src/capabilities/create/compiledCreate.subprocess.test.ts +0 -189
  824. package/src/capabilities/create/templates.embedded.generated.ts +0 -28
  825. package/src/capabilities/doctor/checks/checkConfigFile.ts +0 -42
  826. package/src/capabilities/doctor/checks/checkMcpCommands.ts +0 -114
  827. package/src/capabilities/doctor/checks/checkMcpConfigured.ts +0 -68
  828. package/src/capabilities/doctor/checks/checkSkillsSymlinked.ts +0 -61
  829. package/src/capabilities/doctor/checks/deriveBand.test.ts +0 -42
  830. package/src/capabilities/doctor/checks/deriveBand.ts +0 -28
  831. package/src/capabilities/shared/bands.ts +0 -16
  832. package/src/kernel/config/__snapshots__/firstRun.test.ts.snap +0 -11
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pragma.conf.js","sourceRoot":"","sources":["../pragma.conf.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,356 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * CLI entry point for `pragma` (v2 kernel).
4
+ *
5
+ * The composition root. Ordered early exits keep the hot paths minimal and
6
+ * side-effect-free: `mcp serve` serves over stdio (D9); `__complete` resolves
7
+ * completions storelessly *before* first-run so the greeting never leaks into a
8
+ * shell buffer; `--version` prints and exits. Otherwise: parse global flags,
9
+ * reject a bad `--format`, run first-run onboarding, then build the Commander
10
+ * program from the capabilities and dispatch. Heavy modules are dynamic-imported
11
+ * so `--help`/`__complete` load neither zod nor any verb run body.
12
+ *
13
+ * @note Impure — reads argv/env, writes stdout/stderr, sets the exit code.
14
+ */
15
+ import { BIN_NAME, DETAIL_LEVELS, ISSUES_URL, PROGRAM_DESCRIPTION, VERSION, } from "./constants.js";
16
+ /**
17
+ * The flags a bare invocation answers itself. `--version` returns earlier; the
18
+ * help form falls through to the front door, which IS its answer — so the
19
+ * unknown-flag guard must not mistake it for a typo. One spelling per flag:
20
+ * no `-h`/`-v` shorts exist anywhere on the surface.
21
+ */
22
+ const ROOT_FLAGS = new Set(["--help", "--version"]);
23
+ async function main() {
24
+ const argv = process.argv.slice(2);
25
+ // 1. MCP server entry (D9) — `pragma mcp serve` serves over stdio.
26
+ // The exit is NARROW on purpose: argv must be EXACTLY those two tokens.
27
+ // The server's startup has to stay minimal and stdio-pure (no first-run
28
+ // banner, no config read, nothing on stdout but JSON-RPC), which is what
29
+ // this shortcut buys — but the noun itself is ordinary grammar, so
30
+ // `pragma mcp`, `pragma mcp --help` and `pragma mcp serve --help` fall
31
+ // through to the same help machinery every other noun uses, and root
32
+ // help's promise that `--help` works on any command becomes true.
33
+ // Matching on a PREFIX would extend that purity budget to malformed argv
34
+ // it was never bought for: `mcp serve extra` would serve instead of
35
+ // letting Commander reject the excess argument, and `mcp serve --version`
36
+ // would serve instead of answering the global flag. Anything suffixed
37
+ // falls through to the ordinary grammar, which owns both jobs.
38
+ if (argv.length === 2 && argv[0] === "mcp" && argv[1] === "serve") {
39
+ const [{ serveMcp }, { capabilities }] = await Promise.all([
40
+ import("./kernel/project/mcp/serve.js"),
41
+ import("./capabilities/index.js"),
42
+ ]);
43
+ await serveMcp(capabilities);
44
+ return;
45
+ }
46
+ // 2. Completion resolver — storeless, and reached before anything that could
47
+ // print, so a completion request is never polluted by a hint.
48
+ // Protocol: `pragma __complete -- <words…>`; the first `--` is framing
49
+ // (tolerated absent) and is stripped here so a later bare `--` stays the
50
+ // user's end-of-options. Candidates go to stdout newline-delimited (zero
51
+ // candidates → zero bytes); the entity tier reads the active pack's index
52
+ // (storeless), never the store; `runComplete` never throws.
53
+ if (argv[0] === "__complete") {
54
+ const [{ runComplete }, { indexCompletionEnv }, { capabilities }] = await Promise.all([
55
+ import("./kernel/completion/complete.js"),
56
+ import("./kernel/completion/entitySource.js"),
57
+ import("./capabilities/index.js"),
58
+ ]);
59
+ const words = argv[1] === "--" ? argv.slice(2) : argv.slice(1);
60
+ const matches = await runComplete(words, capabilities, indexCompletionEnv(process.cwd()));
61
+ if (matches.length > 0)
62
+ process.stdout.write(`${matches.join("\n")}\n`);
63
+ return;
64
+ }
65
+ // 2b. Internal store smoke probe — boots the embedded pack (oxigraph WASM +
66
+ // pack cache). Not a user command; the WASM-embed smoke test spawns it.
67
+ if (argv[0] === "__store-probe") {
68
+ const { runStoreProbe } = await import("./kernel/runtime/probe.js");
69
+ process.stdout.write(`${await runStoreProbe()}\n`);
70
+ return;
71
+ }
72
+ const { findValuedVerbose, parseGlobalFlags, readRawDetail, readRawFormat, stripGlobalFlags, } = await import("./kernel/project/cli/globalFlags.js");
73
+ const globalFlags = parseGlobalFlags(argv);
74
+ // 3. `--version` is global — print and exit wherever it appears.
75
+ if (argv.some((arg) => arg === "--version")) {
76
+ process.stdout.write(`${VERSION}\n`);
77
+ return;
78
+ }
79
+ // 4. Reject a bad global-flag value early (help still prints regardless):
80
+ // an unknown `--format`, an unrecognized `--detail` level (which used to
81
+ // be dropped silently — the same defect class as a filter that
82
+ // evaporates), and a valued `--verbose=<x>` (the flag takes no value;
83
+ // accepting-and-ignoring one would be a silent no-op).
84
+ const explicitHelp = argv.some((arg) => arg === "--help");
85
+ const jsonMode = globalFlags.format === "json";
86
+ if (!explicitHelp) {
87
+ const rawFormat = readRawFormat(argv);
88
+ if (rawFormat !== undefined &&
89
+ !["plain", "llm", "json"].includes(rawFormat)) {
90
+ await rejectGlobalValue("format", rawFormat, ["plain", "llm", "json"], jsonMode);
91
+ return;
92
+ }
93
+ const rawDetail = readRawDetail(argv);
94
+ if (rawDetail !== undefined &&
95
+ !DETAIL_LEVELS.includes(rawDetail)) {
96
+ await rejectGlobalValue("detail", rawDetail, [...DETAIL_LEVELS], jsonMode);
97
+ return;
98
+ }
99
+ const valuedVerbose = findValuedVerbose(argv);
100
+ if (valuedVerbose !== undefined) {
101
+ const { PragmaError } = await import("./kernel/error/PragmaError.js");
102
+ await renderStartupError(new PragmaError({
103
+ code: "INVALID_INPUT",
104
+ message: `\`--verbose\` takes no value; \`${valuedVerbose}\` is not a flag of this program.`,
105
+ recovery: { message: "Use `--verbose` on its own." },
106
+ }), jsonMode);
107
+ return;
108
+ }
109
+ }
110
+ // 5. Load the capability registry — the command tree's data. Commander and
111
+ // the program builder are NOT loaded yet: the bare-invocation branch
112
+ // below answers `--help` and the front door from the registry alone, so
113
+ // the help fast path never pays for the parser it will not run.
114
+ const { capabilities } = await import("./capabilities/index.js");
115
+ const args = stripGlobalFlags(argv);
116
+ // 6. A bare invocation (no command token — argv empty or only global flags)
117
+ // prints the curated front door instead of exiting silently. Uses the
118
+ // static capabilities — the front door never reads config or stories.
119
+ if (!args.some((arg) => !arg.startsWith("-"))) {
120
+ // `args` is argv with the global flags already stripped, so a token still
121
+ // starting with `-` here is a flag this program does not have — EXCEPT the
122
+ // two the front door itself answers, which reach this branch by design.
123
+ // Commander rejects unknown flags below the root; without this the ROOT
124
+ // answered a typo with the front door and exit 0, so `pragma --detial
125
+ // standard` read as success.
126
+ const unknownFlag = args.find((arg) => arg.startsWith("-") && !ROOT_FLAGS.has(arg));
127
+ if (unknownFlag !== undefined) {
128
+ const [{ PragmaError }, { renderErrorPlain, renderErrorJson }, { mapExitCode },] = await Promise.all([
129
+ import("./kernel/error/PragmaError.js"),
130
+ import("./kernel/error/renderError.js"),
131
+ import("./kernel/project/cli/exitCodes.js"),
132
+ ]);
133
+ const error = new PragmaError({
134
+ code: "INVALID_INPUT",
135
+ message: `Unknown option "${unknownFlag}".`,
136
+ recovery: {
137
+ message: "Run with `--help` to see the available options.",
138
+ },
139
+ });
140
+ process.stderr.write(`${globalFlags.format === "json"
141
+ ? renderErrorJson(error)
142
+ : renderErrorPlain(error)}\n`);
143
+ process.exitCode = mapExitCode(error.code);
144
+ return;
145
+ }
146
+ const { formatRootHelp } = await import("./kernel/project/cli/rootHelp.js");
147
+ const live = capabilities
148
+ .flatMap((module) => [...module.verbs])
149
+ .filter((verb) => !verb.hidden);
150
+ process.stdout.write(`${formatRootHelp(BIN_NAME, PROGRAM_DESCRIPTION, live, VERSION, ISSUES_URL, globalFlags)}\n`);
151
+ // The front door is a read, so it is where the un-set-up hint belongs: the
152
+ // machine's state is the presence of the global config, and nothing is
153
+ // written to discover it.
154
+ const { setupHintLines } = await import("./kernel/config/firstRun.js");
155
+ const hint = setupHintLines();
156
+ if (hint.length > 0)
157
+ process.stderr.write(`\n${hint.join("\n")}\n`);
158
+ return;
159
+ }
160
+ // A real command merges the package- and config-declared story packs into the
161
+ // tree (DISPATCH only); `--help` stays on the static, storeless capabilities
162
+ // so its budget and the golden hold. An invalid CONFIG story surfaces as a
163
+ // rendered error; a package story that cannot be used is named on stderr and
164
+ // the command carries on (it is third-party data, and failing here would take
165
+ // `sources update` and `doctor` — the only recoveries — down with it).
166
+ let modules = capabilities;
167
+ if (!explicitHelp) {
168
+ try {
169
+ const { loadEffectiveModules } = await import("./kernel/packs/collect.js");
170
+ const effective = await loadEffectiveModules(capabilities, process.cwd());
171
+ modules = effective.modules;
172
+ if (globalFlags.quiet !== true) {
173
+ for (const problem of effective.problems) {
174
+ process.stderr.write(`Ignored story ${problem.source}: ${problem.message}\n`);
175
+ }
176
+ }
177
+ }
178
+ catch (error) {
179
+ await renderStartupError(error, globalFlags.format === "json");
180
+ return;
181
+ }
182
+ }
183
+ const verbs = modules.flatMap((module) => [...module.verbs]);
184
+ // Module-owned noun mounts (CapabilityModule.cliProjection), keyed by the
185
+ // module's noun. A module's verbs all share their noun, so the module name
186
+ // is that noun for every module that declares a mount.
187
+ const mounts = new Map(modules.flatMap((module) => module.cliProjection
188
+ ? [[module.name, module.cliProjection]]
189
+ : []));
190
+ // A mount may defer its registration machinery behind `prepare()` (the
191
+ // fast paths import the projection hook without ever mounting) — resolve
192
+ // every deferred import before the tree is built, alongside the program
193
+ // builder's own deferred load.
194
+ const [{ buildProgram }] = await Promise.all([
195
+ import("./kernel/project/cli/buildProgram.js"),
196
+ ...[...mounts.values()].map((projection) => projection.prepare?.()),
197
+ ]);
198
+ const program = buildProgram(verbs, {
199
+ globalFlags,
200
+ programName: BIN_NAME,
201
+ description: PROGRAM_DESCRIPTION,
202
+ version: VERSION,
203
+ mounts,
204
+ });
205
+ // Silence Commander's default stderr writer on EVERY command, not just the
206
+ // root — otherwise a bad subcommand/option prints Commander's raw `error: …`
207
+ // line alongside (and duplicating) the designed diagnostic.
208
+ silenceCommanderErrors(program);
209
+ try {
210
+ await program.parseAsync(args, { from: "user" });
211
+ }
212
+ catch (error) {
213
+ await handleProgramError(error, argv, globalFlags.format, verbs);
214
+ }
215
+ }
216
+ /**
217
+ * Reject an invalid global-flag value before dispatch: one renderer for the
218
+ * `--format`/`--detail` guards, so every validated global value flag fails
219
+ * with the same invalid-input shape and its valid list.
220
+ */
221
+ async function rejectGlobalValue(name, value, validOptions, jsonMode) {
222
+ const { PragmaError } = await import("./kernel/error/PragmaError.js");
223
+ await renderStartupError(PragmaError.invalidInput(name, value, {
224
+ validOptions: [...validOptions],
225
+ }), jsonMode);
226
+ }
227
+ /**
228
+ * Render a startup error (e.g. an invalid config story pack) before the command
229
+ * tree is built, mapping it to stderr + an exit code — the same envelope
230
+ * dispatch uses, so a bad `stories` entry surfaces identically to a run error.
231
+ */
232
+ async function renderStartupError(error, jsonMode) {
233
+ const [{ PragmaError }, { renderErrorPlain, renderErrorJson }, { mapExitCode },] = await Promise.all([
234
+ import("./kernel/error/PragmaError.js"),
235
+ import("./kernel/error/renderError.js"),
236
+ import("./kernel/project/cli/exitCodes.js"),
237
+ ]);
238
+ const pragmaError = error instanceof PragmaError
239
+ ? error
240
+ : PragmaError.internalError(error instanceof Error ? error.message : String(error));
241
+ process.stderr.write(`${jsonMode ? renderErrorJson(pragmaError) : renderErrorPlain(pragmaError)}\n`);
242
+ process.exitCode = mapExitCode(pragmaError.code);
243
+ }
244
+ /** Silence Commander's built-in stderr writer on a command and all descendants. */
245
+ function silenceCommanderErrors(command) {
246
+ command.configureOutput({ writeErr: () => { } });
247
+ for (const child of command.commands)
248
+ silenceCommanderErrors(child);
249
+ }
250
+ /**
251
+ * Map a thrown parse error onto stderr + an exit code. Verb run errors are
252
+ * handled inside dispatch; this catches Commander parse failures.
253
+ */
254
+ async function handleProgramError(error, argv, format, verbs) {
255
+ const { CommanderError } = await import("commander");
256
+ if (error instanceof CommanderError) {
257
+ if (error.code === "commander.helpDisplayed" ||
258
+ error.code === "commander.version") {
259
+ process.exitCode = 0;
260
+ return;
261
+ }
262
+ if (error.code === "commander.help") {
263
+ // Respect the help error's OWN exit code: `help({ error: true })` — a
264
+ // bare namespace with children, help written to stderr — carries 1;
265
+ // a stdout help carries 0.
266
+ process.exitCode = error.exitCode;
267
+ return;
268
+ }
269
+ // A parse failure whose argv still speaks a retired module grammar gets
270
+ // that module's designed migration error (the module authors the text;
271
+ // the kernel only routes). Currently: `create component --framework`
272
+ // (R1) — scoped to the ONE command that ever had the flag, so
273
+ // `create package --framework …` keeps its honest unknown-option error
274
+ // instead of a migration message about a grammar it never spoke — and
275
+ // scoped to the pre-terminator span: after `--` the spelling is an
276
+ // operand, not the retired flag, so the real parse error stands.
277
+ const { selectScanSpan, stripGlobalFlags } = await import("./kernel/project/cli/globalFlags.js");
278
+ const strippedArgs = stripGlobalFlags(argv);
279
+ const strippedPositionals = strippedArgs.filter((arg) => !arg.startsWith("-"));
280
+ if (strippedPositionals[0] === "create" &&
281
+ strippedPositionals[1] === "component" &&
282
+ selectScanSpan(strippedArgs).some((arg) => arg === "--framework" || arg.startsWith("--framework="))) {
283
+ const [{ FRAMEWORK_FLAG_ERROR }, { PragmaError }, { renderErrorForFormat },] = await Promise.all([
284
+ import("./capabilities/create/messages.js"),
285
+ import("./kernel/error/PragmaError.js"),
286
+ import("./kernel/error/renderError.js"),
287
+ ]);
288
+ // Explicit --format json/llm envelope (the kernel's one gate+renderer
289
+ // decision); plain keeps the designed raw line.
290
+ const rendered = renderErrorForFormat(new PragmaError({
291
+ code: "INVALID_INPUT",
292
+ message: FRAMEWORK_FLAG_ERROR.replace(/^error:\s*/i, ""),
293
+ }), format);
294
+ process.stderr.write(`${rendered ?? FRAMEWORK_FLAG_ERROR}\n`);
295
+ process.exitCode = 2;
296
+ return;
297
+ }
298
+ if (error.code === "commander.unknownCommand") {
299
+ const { curatedSuggestions, nounVerbMap, resolveUnknownCommand } = await import("./kernel/project/cli/suggest.js");
300
+ const { stripGlobalFlags } = await import("./kernel/project/cli/globalFlags.js");
301
+ const positionals = stripGlobalFlags(argv).filter((arg) => !arg.startsWith("-"));
302
+ const unknown = resolveUnknownCommand(positionals, nounVerbMap(verbs));
303
+ if (unknown) {
304
+ // Route through the same PragmaError + renderers as every other error,
305
+ // so the plain path gets the `Error:` prefix and the shared "Did you
306
+ // mean?" list instead of a second, inline rendering — and an explicit
307
+ // machine format gets the same envelope every other usage error
308
+ // emits (the kernel's one gate+renderer decision; plain and json
309
+ // bytes unchanged by construction).
310
+ const [{ PragmaError }, { renderErrorForFormat, renderErrorPlain }, { suggestNames },] = await Promise.all([
311
+ import("./kernel/error/PragmaError.js"),
312
+ import("./kernel/error/renderError.js"),
313
+ import("./kernel/project/cli/suggestNames.js"),
314
+ ]);
315
+ const curated = curatedSuggestions(unknown.token);
316
+ const suggestions = curated
317
+ ? [...curated]
318
+ : suggestNames(unknown.token, [...unknown.candidates]);
319
+ const unknownError = PragmaError.unknownVerb(unknown.token, {
320
+ suggestions,
321
+ });
322
+ process.stderr.write(`${renderErrorForFormat(unknownError, format) ?? renderErrorPlain(unknownError)}\n`);
323
+ }
324
+ process.exitCode = 2;
325
+ return;
326
+ }
327
+ // Other usage errors (missing argument, unknown option, bad choice). Under
328
+ // an explicit --format json/llm these route through the same error
329
+ // envelope agents parse (the kernel's one gate+renderer decision — the
330
+ // llm half used to split this one taxonomy class: an excess positional
331
+ // enveloped while an unknown option stayed raw prose).
332
+ const [{ PragmaError }, { renderErrorForFormat }] = await Promise.all([
333
+ import("./kernel/error/PragmaError.js"),
334
+ import("./kernel/error/renderError.js"),
335
+ ]);
336
+ const rendered = renderErrorForFormat(new PragmaError({
337
+ code: "INVALID_INPUT",
338
+ message: error.message.replace(/^error:\s*/i, ""),
339
+ }), format);
340
+ process.stderr.write(`${rendered ?? error.message}\n`);
341
+ process.exitCode = 2;
342
+ return;
343
+ }
344
+ const [{ PragmaError }, { renderErrorPlain, renderErrorJson }, { mapExitCode },] = await Promise.all([
345
+ import("./kernel/error/PragmaError.js"),
346
+ import("./kernel/error/renderError.js"),
347
+ import("./kernel/project/cli/exitCodes.js"),
348
+ ]);
349
+ const pragmaError = error instanceof PragmaError
350
+ ? error
351
+ : PragmaError.internalError(error instanceof Error ? error.message : String(error));
352
+ process.stderr.write(`${format === "json" ? renderErrorJson(pragmaError) : renderErrorPlain(pragmaError)}\n`);
353
+ process.exitCode = mapExitCode(pragmaError.code);
354
+ }
355
+ await main();
356
+ //# sourceMappingURL=bin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,70 @@
1
+ /**
2
+ * Formatters for `pragma capabilities` — plain, llm, json.
3
+ *
4
+ * `plain` is ported from the old shell's `renderCapabilities`; `llm` is the same
5
+ * information as compact Markdown for agents; `json` is the raw structured map
6
+ * (what the MCP tool returns through the envelope).
7
+ */
8
+ import { BIN_NAME } from "../../constants.js";
9
+ /** Category display order for grouped tool listings. */
10
+ const CATEGORY_ORDER = [
11
+ "read",
12
+ "write",
13
+ "orientation",
14
+ "diagnostic",
15
+ ];
16
+ export const capabilitiesFormatters = {
17
+ plain(data) {
18
+ const lines = [`${BIN_NAME} v${data.version}`, ""];
19
+ lines.push("Conventions");
20
+ lines.push(` ${data.conventions.system}`);
21
+ lines.push(` ${data.conventions.model}`);
22
+ lines.push(` ${data.conventions.querying}`);
23
+ lines.push("");
24
+ lines.push("Discovery Sequence");
25
+ for (const stage of data.discovery_sequence) {
26
+ lines.push(` ${stage.stage}. ${stage.tool} — ${stage.purpose}`);
27
+ }
28
+ lines.push("");
29
+ for (const category of CATEGORY_ORDER) {
30
+ const tools = data.tools.filter((tool) => tool.category === category);
31
+ lines.push(`${category} (${tools.length})`);
32
+ for (const tool of tools) {
33
+ lines.push(` ${tool.name} — ${tool.use_when}`);
34
+ }
35
+ lines.push("");
36
+ }
37
+ const { counts } = data;
38
+ lines.push(`${counts.total} tools: ${counts.read} read, ${counts.write} write, ${counts.orientation} orientation, ${counts.diagnostic} diagnostic`);
39
+ lines.push(`output: ${data.limits.output_modes.join(", ")} | condensed: ${data.limits.condensed_available ? "yes" : "no"}`);
40
+ return lines.join("\n");
41
+ },
42
+ llm(data) {
43
+ const lines = [`# ${BIN_NAME} v${data.version}`, ""];
44
+ lines.push("## Conventions");
45
+ lines.push(`- ${data.conventions.system}`);
46
+ lines.push(`- ${data.conventions.model}`);
47
+ lines.push(`- ${data.conventions.querying}`);
48
+ lines.push("");
49
+ lines.push("## Discovery sequence");
50
+ for (const stage of data.discovery_sequence) {
51
+ lines.push(`${stage.stage}. \`${stage.tool}\` — ${stage.purpose}`);
52
+ }
53
+ lines.push("");
54
+ for (const category of CATEGORY_ORDER) {
55
+ const tools = data.tools.filter((tool) => tool.category === category);
56
+ lines.push(`## ${category} (${tools.length})`);
57
+ for (const tool of tools) {
58
+ lines.push(`- \`${tool.name}\` — ${tool.use_when}`);
59
+ }
60
+ lines.push("");
61
+ }
62
+ const { counts } = data;
63
+ lines.push(`${counts.total} tools: ${counts.read} read, ${counts.write} write, ${counts.orientation} orientation, ${counts.diagnostic} diagnostic.`);
64
+ return lines.join("\n").trimEnd();
65
+ },
66
+ json(data) {
67
+ return JSON.stringify(data);
68
+ },
69
+ };
70
+ //# sourceMappingURL=capabilities.render.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.render.js","sourceRoot":"","sources":["../../../../src/capabilities/capabilities/capabilities.render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C,wDAAwD;AACxD,MAAM,cAAc,GAA4B;IAC9C,MAAM;IACN,OAAO;IACP,aAAa;IACb,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAiC;IAClE,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAa,CAAC,GAAG,QAAQ,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAE7D,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,WAAW,iBAAiB,MAAM,CAAC,UAAU,aAAa,CACxI,CAAC;QACF,KAAK,CAAC,IAAI,CACR,WAAW,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAChH,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,IAAI;QACN,MAAM,KAAK,GAAa,CAAC,KAAK,QAAQ,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,WAAW,iBAAiB,MAAM,CAAC,UAAU,cAAc,CACzI,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,IAAI;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * The `capabilities` orientation verb (noun `capabilities`, self-verb).
3
+ *
4
+ * Storeless read: it returns the grammar-derived tool catalog + conventions +
5
+ * discovery sequence an agent reads at session start. It replaces the retired
6
+ * old-shell `llm` tool — the live-context half of that tool (tier/channel/entity
7
+ * counts) is deliberately DROPPED here (it would require a store boot at
8
+ * orientation) and lives in `info` / `config show` / `sources status` instead.
9
+ *
10
+ * `run` is a lazy thunk that dynamic-imports the catalog, the capability
11
+ * registry barrel and the dispatch-time merge, so building the command tree
12
+ * never pulls the derivation onto the `--help`/`__complete` fast path, and the
13
+ * tool never boots the store (`store.booted` stays false — the storeless-spy
14
+ * invariant).
15
+ *
16
+ * It reports the EFFECTIVE modules, not the static registry: the MCP server
17
+ * registers its tools from the same merge, so a catalog built from the static
18
+ * set would omit exactly the config- and package-declared nouns `tools/list`
19
+ * advertises — the hand-maintained drift this catalog exists to end. With no
20
+ * declared stories the merge returns the registry by identity, so the payload is
21
+ * unchanged.
22
+ */
23
+ import { BIN_NAME } from "../../constants.js";
24
+ import { asVerb } from "../../kernel/spec/asVerb.js";
25
+ import { capabilitiesFormatters } from "./capabilities.render.js";
26
+ const capabilitiesVerb = {
27
+ path: ["capabilities"],
28
+ summary: `Discover ${BIN_NAME} conventions, the annotated tool catalog, and the discovery sequence.`,
29
+ doc: "Storeless orientation for agents. Returns the conventions (KG / tier-channel / SPARQL model), a four-stage discovery sequence, and every live tool with a behavioural use_when hint and category — all derived from the live grammar, so it never drifts. Call it first at session start.",
30
+ params: [],
31
+ output: { formatters: capabilitiesFormatters },
32
+ examples: [
33
+ { cmd: `${BIN_NAME} capabilities`, note: "the annotated tool catalog" },
34
+ {
35
+ cmd: `${BIN_NAME} capabilities --format json`,
36
+ note: "the structured map",
37
+ },
38
+ ],
39
+ capability: {
40
+ needsStore: false,
41
+ mutates: false,
42
+ mcp: {
43
+ expose: true,
44
+ annotations: { readOnlyHint: true, openWorldHint: false },
45
+ },
46
+ },
47
+ run: async (_params, runtime) => {
48
+ const [catalog, registry, collect] = await Promise.all([
49
+ import("./catalog.js"),
50
+ import("../index.js"),
51
+ import("../../kernel/packs/collect.js"),
52
+ ]);
53
+ const { modules } = await collect.loadEffectiveModules(registry.capabilities, runtime.cwd);
54
+ return catalog.buildCapabilitiesData(modules);
55
+ },
56
+ };
57
+ /** The `capabilities` verb, widened for registry composition. */
58
+ export const capabilitiesSelfVerb = asVerb(capabilitiesVerb);
59
+ //# sourceMappingURL=capabilities.verb.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/capabilities/capabilities.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,gBAAgB,GAAwD;IAC5E,IAAI,EAAE,CAAC,cAAc,CAAC;IACtB,OAAO,EAAE,YAAY,QAAQ,uEAAuE;IACpG,GAAG,EAAE,2RAA2R;IAChS,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,sBAAsB,EAAE;IAC9C,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,eAAe,EAAE,IAAI,EAAE,4BAA4B,EAAE;QACvE;YACE,GAAG,EAAE,GAAG,QAAQ,6BAA6B;YAC7C,IAAI,EAAE,oBAAoB;SAC3B;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1D;KACF;IACD,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrD,MAAM,CAAC,cAAc,CAAC;YACtB,MAAM,CAAC,aAAa,CAAC;YACrB,MAAM,CAAC,+BAA+B,CAAC;SACxC,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,oBAAoB,CACpD,QAAQ,CAAC,YAAY,EACrB,OAAO,CAAC,GAAG,CACZ,CAAC;QACF,OAAO,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}