@adammcarter/use-cases 0.1.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 (704) hide show
  1. package/.agents/skills/migration/SKILL.md +85 -0
  2. package/.agents/skills/showcase/SKILL.md +60 -0
  3. package/.agents/skills/use-cases/SKILL.md +161 -0
  4. package/.agents/skills/walkthrough/SKILL.md +48 -0
  5. package/.claude-plugin/plugin.json +14 -0
  6. package/.codex-plugin/plugin.json +33 -0
  7. package/.mcp.json +8 -0
  8. package/.opencode/plugin/use-cases.js +32 -0
  9. package/CHANGELOG.md +125 -0
  10. package/LICENSE +21 -0
  11. package/README.md +112 -0
  12. package/bootstrap/use-cases.md +60 -0
  13. package/docs/README.md +51 -0
  14. package/docs/acceptance.md +16 -0
  15. package/docs/activation.md +89 -0
  16. package/docs/adr/0001-p0-bootstrap-decisions.md +107 -0
  17. package/docs/adr/0002-p1-schema-contracts.md +136 -0
  18. package/docs/adr/0003-p2-use-case-matrix-contracts.md +67 -0
  19. package/docs/adr/0004-p3-evidence-ledger-contracts.md +85 -0
  20. package/docs/adr/0005-p4-cli-contract.md +70 -0
  21. package/docs/adr/0006-trusted-user-approval-path.md +125 -0
  22. package/docs/cli.md +108 -0
  23. package/docs/data-model.md +56 -0
  24. package/docs/getting-started.md +296 -0
  25. package/docs/hosts.md +30 -0
  26. package/docs/markers-adoption.md +100 -0
  27. package/docs/mcp.md +114 -0
  28. package/docs/migration.md +90 -0
  29. package/docs/reference/error-codes.md +123 -0
  30. package/docs/reference/stability.md +123 -0
  31. package/docs/release.md +26 -0
  32. package/docs/security/ci-hardening.md +144 -0
  33. package/docs/security/key-management.md +158 -0
  34. package/docs/security.md +66 -0
  35. package/docs/showcase.md +39 -0
  36. package/docs/tutorials/python-pytest.md +188 -0
  37. package/examples/basic-product/demo-capsules/product-search.yml +23 -0
  38. package/examples/basic-product/evidence/by-id/ev/evidence-basic-search.jsonl +1 -0
  39. package/examples/basic-product/showcase-runs/run.basic.product.search/events.jsonl +4 -0
  40. package/examples/basic-product/use-cases/product.yml +85 -0
  41. package/examples/basic-product/use-cases.yml +9 -0
  42. package/examples/damaged-product/evidence/broken.jsonl +1 -0
  43. package/examples/damaged-product/use-cases/duplicate-a.yml +28 -0
  44. package/examples/damaged-product/use-cases/duplicate-b.yml +28 -0
  45. package/examples/damaged-product/use-cases/malformed.yml +14 -0
  46. package/examples/damaged-product/use-cases/valid-sibling.yml +28 -0
  47. package/examples/damaged-product/use-cases.yml +9 -0
  48. package/examples/host-projections/use-cases.yml +9 -0
  49. package/examples/python-pytest/README.md +39 -0
  50. package/examples/python-pytest/pytest.ini +8 -0
  51. package/examples/python-pytest/src/coupon.py +32 -0
  52. package/examples/python-pytest/tests/use_cases/example.checkout.apply_coupon_test.py +31 -0
  53. package/examples/python-pytest/use-cases/checkout.yml +47 -0
  54. package/examples/python-pytest/use-cases.yml +19 -0
  55. package/hooks/hooks-codex.json +16 -0
  56. package/hooks/hooks.json +16 -0
  57. package/hooks/session-start +42 -0
  58. package/hosts/claude.yml +29 -0
  59. package/hosts/codex.yml +29 -0
  60. package/hosts/copilot.yml +29 -0
  61. package/hosts/opencode.yml +29 -0
  62. package/package.json +81 -0
  63. package/packages/cli/README.md +37 -0
  64. package/packages/cli/dist/args/parse.d.ts +6 -0
  65. package/packages/cli/dist/args/parse.d.ts.map +1 -0
  66. package/packages/cli/dist/args/parse.js +55 -0
  67. package/packages/cli/dist/args/parse.js.map +1 -0
  68. package/packages/cli/dist/args/validate.d.ts +3 -0
  69. package/packages/cli/dist/args/validate.d.ts.map +1 -0
  70. package/packages/cli/dist/args/validate.js +80 -0
  71. package/packages/cli/dist/args/validate.js.map +1 -0
  72. package/packages/cli/dist/builtins.d.ts +2 -0
  73. package/packages/cli/dist/builtins.d.ts.map +1 -0
  74. package/packages/cli/dist/builtins.js +235 -0
  75. package/packages/cli/dist/builtins.js.map +1 -0
  76. package/packages/cli/dist/command/dispatch.d.ts +4 -0
  77. package/packages/cli/dist/command/dispatch.d.ts.map +1 -0
  78. package/packages/cli/dist/command/dispatch.js +45 -0
  79. package/packages/cli/dist/command/dispatch.js.map +1 -0
  80. package/packages/cli/dist/command/help-catalog.d.ts +13 -0
  81. package/packages/cli/dist/command/help-catalog.d.ts.map +1 -0
  82. package/packages/cli/dist/command/help-catalog.js +42 -0
  83. package/packages/cli/dist/command/help-catalog.js.map +1 -0
  84. package/packages/cli/dist/command/registry.d.ts +3 -0
  85. package/packages/cli/dist/command/registry.d.ts.map +1 -0
  86. package/packages/cli/dist/command/registry.js +33 -0
  87. package/packages/cli/dist/command/registry.js.map +1 -0
  88. package/packages/cli/dist/command/types.d.ts +32 -0
  89. package/packages/cli/dist/command/types.d.ts.map +1 -0
  90. package/packages/cli/dist/command/types.js +6 -0
  91. package/packages/cli/dist/command/types.js.map +1 -0
  92. package/packages/cli/dist/commands/capsule.d.ts +7 -0
  93. package/packages/cli/dist/commands/capsule.d.ts.map +1 -0
  94. package/packages/cli/dist/commands/capsule.js +178 -0
  95. package/packages/cli/dist/commands/capsule.js.map +1 -0
  96. package/packages/cli/dist/commands/common.d.ts +7 -0
  97. package/packages/cli/dist/commands/common.d.ts.map +1 -0
  98. package/packages/cli/dist/commands/common.js +32 -0
  99. package/packages/cli/dist/commands/common.js.map +1 -0
  100. package/packages/cli/dist/commands/doctor.d.ts +6 -0
  101. package/packages/cli/dist/commands/doctor.d.ts.map +1 -0
  102. package/packages/cli/dist/commands/doctor.js +133 -0
  103. package/packages/cli/dist/commands/doctor.js.map +1 -0
  104. package/packages/cli/dist/commands/evidence.d.ts +6 -0
  105. package/packages/cli/dist/commands/evidence.d.ts.map +1 -0
  106. package/packages/cli/dist/commands/evidence.js +191 -0
  107. package/packages/cli/dist/commands/evidence.js.map +1 -0
  108. package/packages/cli/dist/commands/host.d.ts +6 -0
  109. package/packages/cli/dist/commands/host.d.ts.map +1 -0
  110. package/packages/cli/dist/commands/host.js +180 -0
  111. package/packages/cli/dist/commands/host.js.map +1 -0
  112. package/packages/cli/dist/commands/keygen.d.ts +4 -0
  113. package/packages/cli/dist/commands/keygen.d.ts.map +1 -0
  114. package/packages/cli/dist/commands/keygen.js +132 -0
  115. package/packages/cli/dist/commands/keygen.js.map +1 -0
  116. package/packages/cli/dist/commands/markers.d.ts +8 -0
  117. package/packages/cli/dist/commands/markers.d.ts.map +1 -0
  118. package/packages/cli/dist/commands/markers.js +455 -0
  119. package/packages/cli/dist/commands/markers.js.map +1 -0
  120. package/packages/cli/dist/commands/matrix.d.ts +8 -0
  121. package/packages/cli/dist/commands/matrix.d.ts.map +1 -0
  122. package/packages/cli/dist/commands/matrix.js +237 -0
  123. package/packages/cli/dist/commands/matrix.js.map +1 -0
  124. package/packages/cli/dist/commands/migrate.d.ts +4 -0
  125. package/packages/cli/dist/commands/migrate.d.ts.map +1 -0
  126. package/packages/cli/dist/commands/migrate.js +82 -0
  127. package/packages/cli/dist/commands/migrate.js.map +1 -0
  128. package/packages/cli/dist/commands/plan.d.ts +6 -0
  129. package/packages/cli/dist/commands/plan.d.ts.map +1 -0
  130. package/packages/cli/dist/commands/plan.js +129 -0
  131. package/packages/cli/dist/commands/plan.js.map +1 -0
  132. package/packages/cli/dist/commands/recover.d.ts +4 -0
  133. package/packages/cli/dist/commands/recover.d.ts.map +1 -0
  134. package/packages/cli/dist/commands/recover.js +352 -0
  135. package/packages/cli/dist/commands/recover.js.map +1 -0
  136. package/packages/cli/dist/commands/schema.d.ts +5 -0
  137. package/packages/cli/dist/commands/schema.d.ts.map +1 -0
  138. package/packages/cli/dist/commands/schema.js +51 -0
  139. package/packages/cli/dist/commands/schema.js.map +1 -0
  140. package/packages/cli/dist/commands/showcase.d.ts +14 -0
  141. package/packages/cli/dist/commands/showcase.d.ts.map +1 -0
  142. package/packages/cli/dist/commands/showcase.js +638 -0
  143. package/packages/cli/dist/commands/showcase.js.map +1 -0
  144. package/packages/cli/dist/commands/workflow.d.ts +5 -0
  145. package/packages/cli/dist/commands/workflow.d.ts.map +1 -0
  146. package/packages/cli/dist/commands/workflow.js +107 -0
  147. package/packages/cli/dist/commands/workflow.js.map +1 -0
  148. package/packages/cli/dist/coreLoader.d.ts +6 -0
  149. package/packages/cli/dist/coreLoader.d.ts.map +1 -0
  150. package/packages/cli/dist/coreLoader.js +34 -0
  151. package/packages/cli/dist/coreLoader.js.map +1 -0
  152. package/packages/cli/dist/index.d.ts +5 -0
  153. package/packages/cli/dist/index.d.ts.map +1 -0
  154. package/packages/cli/dist/index.js +83 -0
  155. package/packages/cli/dist/index.js.map +1 -0
  156. package/packages/cli/dist/render.d.ts +2 -0
  157. package/packages/cli/dist/render.d.ts.map +1 -0
  158. package/packages/cli/dist/render.js +88 -0
  159. package/packages/cli/dist/render.js.map +1 -0
  160. package/packages/cli/dist/runtime.d.ts +25 -0
  161. package/packages/cli/dist/runtime.d.ts.map +1 -0
  162. package/packages/cli/dist/runtime.js +89 -0
  163. package/packages/cli/dist/runtime.js.map +1 -0
  164. package/packages/cli/package.json +38 -0
  165. package/packages/core/README.md +37 -0
  166. package/packages/core/dist/capsules/index.d.ts +4 -0
  167. package/packages/core/dist/capsules/index.d.ts.map +1 -0
  168. package/packages/core/dist/capsules/index.js +4 -0
  169. package/packages/core/dist/capsules/index.js.map +1 -0
  170. package/packages/core/dist/capsules/loadCapsule.d.ts +11 -0
  171. package/packages/core/dist/capsules/loadCapsule.d.ts.map +1 -0
  172. package/packages/core/dist/capsules/loadCapsule.js +167 -0
  173. package/packages/core/dist/capsules/loadCapsule.js.map +1 -0
  174. package/packages/core/dist/capsules/runCapsule.d.ts +3 -0
  175. package/packages/core/dist/capsules/runCapsule.d.ts.map +1 -0
  176. package/packages/core/dist/capsules/runCapsule.js +333 -0
  177. package/packages/core/dist/capsules/runCapsule.js.map +1 -0
  178. package/packages/core/dist/capsules/types.d.ts +106 -0
  179. package/packages/core/dist/capsules/types.d.ts.map +1 -0
  180. package/packages/core/dist/capsules/types.js +2 -0
  181. package/packages/core/dist/capsules/types.js.map +1 -0
  182. package/packages/core/dist/durableWrite.d.ts +2 -0
  183. package/packages/core/dist/durableWrite.d.ts.map +1 -0
  184. package/packages/core/dist/durableWrite.js +34 -0
  185. package/packages/core/dist/durableWrite.js.map +1 -0
  186. package/packages/core/dist/errors/registry.d.ts +122 -0
  187. package/packages/core/dist/errors/registry.d.ts.map +1 -0
  188. package/packages/core/dist/errors/registry.js +206 -0
  189. package/packages/core/dist/errors/registry.js.map +1 -0
  190. package/packages/core/dist/errors/render.d.ts +3 -0
  191. package/packages/core/dist/errors/render.d.ts.map +1 -0
  192. package/packages/core/dist/errors/render.js +64 -0
  193. package/packages/core/dist/errors/render.js.map +1 -0
  194. package/packages/core/dist/errors.d.ts +5 -0
  195. package/packages/core/dist/errors.d.ts.map +1 -0
  196. package/packages/core/dist/errors.js +9 -0
  197. package/packages/core/dist/errors.js.map +1 -0
  198. package/packages/core/dist/evidence/appendEvidenceEvent.d.ts +27 -0
  199. package/packages/core/dist/evidence/appendEvidenceEvent.d.ts.map +1 -0
  200. package/packages/core/dist/evidence/appendEvidenceEvent.js +218 -0
  201. package/packages/core/dist/evidence/appendEvidenceEvent.js.map +1 -0
  202. package/packages/core/dist/evidence/assurance.d.ts +18 -0
  203. package/packages/core/dist/evidence/assurance.d.ts.map +1 -0
  204. package/packages/core/dist/evidence/assurance.js +38 -0
  205. package/packages/core/dist/evidence/assurance.js.map +1 -0
  206. package/packages/core/dist/evidence/index.d.ts +8 -0
  207. package/packages/core/dist/evidence/index.d.ts.map +1 -0
  208. package/packages/core/dist/evidence/index.js +8 -0
  209. package/packages/core/dist/evidence/index.js.map +1 -0
  210. package/packages/core/dist/evidence/jsonlLedger.d.ts +13 -0
  211. package/packages/core/dist/evidence/jsonlLedger.d.ts.map +1 -0
  212. package/packages/core/dist/evidence/jsonlLedger.js +171 -0
  213. package/packages/core/dist/evidence/jsonlLedger.js.map +1 -0
  214. package/packages/core/dist/evidence/linkEvidence.d.ts +4 -0
  215. package/packages/core/dist/evidence/linkEvidence.d.ts.map +1 -0
  216. package/packages/core/dist/evidence/linkEvidence.js +53 -0
  217. package/packages/core/dist/evidence/linkEvidence.js.map +1 -0
  218. package/packages/core/dist/evidence/replayEvidence.d.ts +6 -0
  219. package/packages/core/dist/evidence/replayEvidence.d.ts.map +1 -0
  220. package/packages/core/dist/evidence/replayEvidence.js +216 -0
  221. package/packages/core/dist/evidence/replayEvidence.js.map +1 -0
  222. package/packages/core/dist/evidence/results.d.ts +4 -0
  223. package/packages/core/dist/evidence/results.d.ts.map +1 -0
  224. package/packages/core/dist/evidence/results.js +32 -0
  225. package/packages/core/dist/evidence/results.js.map +1 -0
  226. package/packages/core/dist/evidence/types.d.ts +149 -0
  227. package/packages/core/dist/evidence/types.d.ts.map +1 -0
  228. package/packages/core/dist/evidence/types.js +2 -0
  229. package/packages/core/dist/evidence/types.js.map +1 -0
  230. package/packages/core/dist/host-profiles/claude.yml +29 -0
  231. package/packages/core/dist/host-profiles/codex.yml +29 -0
  232. package/packages/core/dist/host-profiles/copilot.yml +29 -0
  233. package/packages/core/dist/host-profiles/opencode.yml +29 -0
  234. package/packages/core/dist/hosts/conformanceStatus.d.ts +16 -0
  235. package/packages/core/dist/hosts/conformanceStatus.d.ts.map +1 -0
  236. package/packages/core/dist/hosts/conformanceStatus.js +160 -0
  237. package/packages/core/dist/hosts/conformanceStatus.js.map +1 -0
  238. package/packages/core/dist/hosts/index.d.ts +5 -0
  239. package/packages/core/dist/hosts/index.d.ts.map +1 -0
  240. package/packages/core/dist/hosts/index.js +5 -0
  241. package/packages/core/dist/hosts/index.js.map +1 -0
  242. package/packages/core/dist/hosts/loadHostProfile.d.ts +6 -0
  243. package/packages/core/dist/hosts/loadHostProfile.d.ts.map +1 -0
  244. package/packages/core/dist/hosts/loadHostProfile.js +41 -0
  245. package/packages/core/dist/hosts/loadHostProfile.js.map +1 -0
  246. package/packages/core/dist/hosts/projectHostFiles.d.ts +16 -0
  247. package/packages/core/dist/hosts/projectHostFiles.d.ts.map +1 -0
  248. package/packages/core/dist/hosts/projectHostFiles.js +272 -0
  249. package/packages/core/dist/hosts/projectHostFiles.js.map +1 -0
  250. package/packages/core/dist/hosts/types.d.ts +122 -0
  251. package/packages/core/dist/hosts/types.d.ts.map +1 -0
  252. package/packages/core/dist/hosts/types.js +2 -0
  253. package/packages/core/dist/hosts/types.js.map +1 -0
  254. package/packages/core/dist/index.d.ts +26 -0
  255. package/packages/core/dist/index.d.ts.map +1 -0
  256. package/packages/core/dist/index.js +31 -0
  257. package/packages/core/dist/index.js.map +1 -0
  258. package/packages/core/dist/init/index.d.ts +2 -0
  259. package/packages/core/dist/init/index.d.ts.map +1 -0
  260. package/packages/core/dist/init/index.js +3 -0
  261. package/packages/core/dist/init/index.js.map +1 -0
  262. package/packages/core/dist/init/scaffold.d.ts +28 -0
  263. package/packages/core/dist/init/scaffold.d.ts.map +1 -0
  264. package/packages/core/dist/init/scaffold.js +293 -0
  265. package/packages/core/dist/init/scaffold.js.map +1 -0
  266. package/packages/core/dist/markers/appendOnly.d.ts +23 -0
  267. package/packages/core/dist/markers/appendOnly.d.ts.map +1 -0
  268. package/packages/core/dist/markers/appendOnly.js +75 -0
  269. package/packages/core/dist/markers/appendOnly.js.map +1 -0
  270. package/packages/core/dist/markers/bindingSetHash.d.ts +28 -0
  271. package/packages/core/dist/markers/bindingSetHash.d.ts.map +1 -0
  272. package/packages/core/dist/markers/bindingSetHash.js +33 -0
  273. package/packages/core/dist/markers/bindingSetHash.js.map +1 -0
  274. package/packages/core/dist/markers/canonicalJson.d.ts +4 -0
  275. package/packages/core/dist/markers/canonicalJson.d.ts.map +1 -0
  276. package/packages/core/dist/markers/canonicalJson.js +51 -0
  277. package/packages/core/dist/markers/canonicalJson.js.map +1 -0
  278. package/packages/core/dist/markers/ciAuthority.d.ts +17 -0
  279. package/packages/core/dist/markers/ciAuthority.d.ts.map +1 -0
  280. package/packages/core/dist/markers/ciAuthority.js +131 -0
  281. package/packages/core/dist/markers/ciAuthority.js.map +1 -0
  282. package/packages/core/dist/markers/cli/bind.d.ts +48 -0
  283. package/packages/core/dist/markers/cli/bind.d.ts.map +1 -0
  284. package/packages/core/dist/markers/cli/bind.js +198 -0
  285. package/packages/core/dist/markers/cli/bind.js.map +1 -0
  286. package/packages/core/dist/markers/cli/index.d.ts +9 -0
  287. package/packages/core/dist/markers/cli/index.d.ts.map +1 -0
  288. package/packages/core/dist/markers/cli/index.js +15 -0
  289. package/packages/core/dist/markers/cli/index.js.map +1 -0
  290. package/packages/core/dist/markers/cli/io.d.ts +18 -0
  291. package/packages/core/dist/markers/cli/io.d.ts.map +1 -0
  292. package/packages/core/dist/markers/cli/io.js +62 -0
  293. package/packages/core/dist/markers/cli/io.js.map +1 -0
  294. package/packages/core/dist/markers/cli/precommit.d.ts +32 -0
  295. package/packages/core/dist/markers/cli/precommit.d.ts.map +1 -0
  296. package/packages/core/dist/markers/cli/precommit.js +174 -0
  297. package/packages/core/dist/markers/cli/precommit.js.map +1 -0
  298. package/packages/core/dist/markers/cli/prove.d.ts +69 -0
  299. package/packages/core/dist/markers/cli/prove.d.ts.map +1 -0
  300. package/packages/core/dist/markers/cli/prove.js +381 -0
  301. package/packages/core/dist/markers/cli/prove.js.map +1 -0
  302. package/packages/core/dist/markers/cli/scan.d.ts +63 -0
  303. package/packages/core/dist/markers/cli/scan.d.ts.map +1 -0
  304. package/packages/core/dist/markers/cli/scan.js +233 -0
  305. package/packages/core/dist/markers/cli/scan.js.map +1 -0
  306. package/packages/core/dist/markers/cli/shared.d.ts +25 -0
  307. package/packages/core/dist/markers/cli/shared.d.ts.map +1 -0
  308. package/packages/core/dist/markers/cli/shared.js +123 -0
  309. package/packages/core/dist/markers/cli/shared.js.map +1 -0
  310. package/packages/core/dist/markers/cli/validateLedger.d.ts +38 -0
  311. package/packages/core/dist/markers/cli/validateLedger.d.ts.map +1 -0
  312. package/packages/core/dist/markers/cli/validateLedger.js +81 -0
  313. package/packages/core/dist/markers/cli/validateLedger.js.map +1 -0
  314. package/packages/core/dist/markers/cli/verify.d.ts +65 -0
  315. package/packages/core/dist/markers/cli/verify.d.ts.map +1 -0
  316. package/packages/core/dist/markers/cli/verify.js +245 -0
  317. package/packages/core/dist/markers/cli/verify.js.map +1 -0
  318. package/packages/core/dist/markers/commentPrefix.d.ts +7 -0
  319. package/packages/core/dist/markers/commentPrefix.d.ts.map +1 -0
  320. package/packages/core/dist/markers/commentPrefix.js +79 -0
  321. package/packages/core/dist/markers/commentPrefix.js.map +1 -0
  322. package/packages/core/dist/markers/constants.d.ts +10 -0
  323. package/packages/core/dist/markers/constants.d.ts.map +1 -0
  324. package/packages/core/dist/markers/constants.js +13 -0
  325. package/packages/core/dist/markers/constants.js.map +1 -0
  326. package/packages/core/dist/markers/evidenceLedger.d.ts +150 -0
  327. package/packages/core/dist/markers/evidenceLedger.d.ts.map +1 -0
  328. package/packages/core/dist/markers/evidenceLedger.js +391 -0
  329. package/packages/core/dist/markers/evidenceLedger.js.map +1 -0
  330. package/packages/core/dist/markers/freshness.d.ts +125 -0
  331. package/packages/core/dist/markers/freshness.d.ts.map +1 -0
  332. package/packages/core/dist/markers/freshness.js +605 -0
  333. package/packages/core/dist/markers/freshness.js.map +1 -0
  334. package/packages/core/dist/markers/index.d.ts +26 -0
  335. package/packages/core/dist/markers/index.d.ts.map +1 -0
  336. package/packages/core/dist/markers/index.js +38 -0
  337. package/packages/core/dist/markers/index.js.map +1 -0
  338. package/packages/core/dist/markers/keygen.d.ts +6 -0
  339. package/packages/core/dist/markers/keygen.d.ts.map +1 -0
  340. package/packages/core/dist/markers/keygen.js +18 -0
  341. package/packages/core/dist/markers/keygen.js.map +1 -0
  342. package/packages/core/dist/markers/keyring.d.ts +23 -0
  343. package/packages/core/dist/markers/keyring.d.ts.map +1 -0
  344. package/packages/core/dist/markers/keyring.js +93 -0
  345. package/packages/core/dist/markers/keyring.js.map +1 -0
  346. package/packages/core/dist/markers/markerLine.d.ts +35 -0
  347. package/packages/core/dist/markers/markerLine.d.ts.map +1 -0
  348. package/packages/core/dist/markers/markerLine.js +125 -0
  349. package/packages/core/dist/markers/markerLine.js.map +1 -0
  350. package/packages/core/dist/markers/physicalLines.d.ts +10 -0
  351. package/packages/core/dist/markers/physicalLines.d.ts.map +1 -0
  352. package/packages/core/dist/markers/physicalLines.js +48 -0
  353. package/packages/core/dist/markers/physicalLines.js.map +1 -0
  354. package/packages/core/dist/markers/policyHash.d.ts +4 -0
  355. package/packages/core/dist/markers/policyHash.d.ts.map +1 -0
  356. package/packages/core/dist/markers/policyHash.js +14 -0
  357. package/packages/core/dist/markers/policyHash.js.map +1 -0
  358. package/packages/core/dist/markers/proofSignature.d.ts +29 -0
  359. package/packages/core/dist/markers/proofSignature.d.ts.map +1 -0
  360. package/packages/core/dist/markers/proofSignature.js +106 -0
  361. package/packages/core/dist/markers/proofSignature.js.map +1 -0
  362. package/packages/core/dist/markers/reconcile.d.ts +26 -0
  363. package/packages/core/dist/markers/reconcile.d.ts.map +1 -0
  364. package/packages/core/dist/markers/reconcile.js +52 -0
  365. package/packages/core/dist/markers/reconcile.js.map +1 -0
  366. package/packages/core/dist/markers/registry.d.ts +53 -0
  367. package/packages/core/dist/markers/registry.d.ts.map +1 -0
  368. package/packages/core/dist/markers/registry.js +161 -0
  369. package/packages/core/dist/markers/registry.js.map +1 -0
  370. package/packages/core/dist/markers/rowHash.d.ts +2 -0
  371. package/packages/core/dist/markers/rowHash.d.ts.map +1 -0
  372. package/packages/core/dist/markers/rowHash.js +10 -0
  373. package/packages/core/dist/markers/rowHash.js.map +1 -0
  374. package/packages/core/dist/markers/scanner.d.ts +67 -0
  375. package/packages/core/dist/markers/scanner.d.ts.map +1 -0
  376. package/packages/core/dist/markers/scanner.js +292 -0
  377. package/packages/core/dist/markers/scanner.js.map +1 -0
  378. package/packages/core/dist/markers/schemas/binding-registry-event.schema.json +41 -0
  379. package/packages/core/dist/markers/schemas/freshness-status.schema.json +134 -0
  380. package/packages/core/dist/markers/schemas/proof-event.schema.json +170 -0
  381. package/packages/core/dist/markers/spanCanon.d.ts +4 -0
  382. package/packages/core/dist/markers/spanCanon.d.ts.map +1 -0
  383. package/packages/core/dist/markers/spanCanon.js +42 -0
  384. package/packages/core/dist/markers/spanCanon.js.map +1 -0
  385. package/packages/core/dist/markers/swiftFuncRecognizer.d.ts +36 -0
  386. package/packages/core/dist/markers/swiftFuncRecognizer.d.ts.map +1 -0
  387. package/packages/core/dist/markers/swiftFuncRecognizer.js +638 -0
  388. package/packages/core/dist/markers/swiftFuncRecognizer.js.map +1 -0
  389. package/packages/core/dist/markers/validators.d.ts +13 -0
  390. package/packages/core/dist/markers/validators.d.ts.map +1 -0
  391. package/packages/core/dist/markers/validators.js +64 -0
  392. package/packages/core/dist/markers/validators.js.map +1 -0
  393. package/packages/core/dist/markers/verificationContextHash.d.ts +23 -0
  394. package/packages/core/dist/markers/verificationContextHash.d.ts.map +1 -0
  395. package/packages/core/dist/markers/verificationContextHash.js +96 -0
  396. package/packages/core/dist/markers/verificationContextHash.js.map +1 -0
  397. package/packages/core/dist/markers/verifierPresets.d.ts +18 -0
  398. package/packages/core/dist/markers/verifierPresets.d.ts.map +1 -0
  399. package/packages/core/dist/markers/verifierPresets.js +71 -0
  400. package/packages/core/dist/markers/verifierPresets.js.map +1 -0
  401. package/packages/core/dist/markers/verifierResolver.d.ts +27 -0
  402. package/packages/core/dist/markers/verifierResolver.d.ts.map +1 -0
  403. package/packages/core/dist/markers/verifierResolver.js +151 -0
  404. package/packages/core/dist/markers/verifierResolver.js.map +1 -0
  405. package/packages/core/dist/migration/index.d.ts +2 -0
  406. package/packages/core/dist/migration/index.d.ts.map +1 -0
  407. package/packages/core/dist/migration/index.js +2 -0
  408. package/packages/core/dist/migration/index.js.map +1 -0
  409. package/packages/core/dist/migration/testMatrix.d.ts +42 -0
  410. package/packages/core/dist/migration/testMatrix.d.ts.map +1 -0
  411. package/packages/core/dist/migration/testMatrix.js +351 -0
  412. package/packages/core/dist/migration/testMatrix.js.map +1 -0
  413. package/packages/core/dist/package/index.d.ts +2 -0
  414. package/packages/core/dist/package/index.d.ts.map +1 -0
  415. package/packages/core/dist/package/index.js +2 -0
  416. package/packages/core/dist/package/index.js.map +1 -0
  417. package/packages/core/dist/package/inspectPackage.d.ts +67 -0
  418. package/packages/core/dist/package/inspectPackage.d.ts.map +1 -0
  419. package/packages/core/dist/package/inspectPackage.js +371 -0
  420. package/packages/core/dist/package/inspectPackage.js.map +1 -0
  421. package/packages/core/dist/presentation/candidates.d.ts +13 -0
  422. package/packages/core/dist/presentation/candidates.d.ts.map +1 -0
  423. package/packages/core/dist/presentation/candidates.js +86 -0
  424. package/packages/core/dist/presentation/candidates.js.map +1 -0
  425. package/packages/core/dist/presentation/index.d.ts +8 -0
  426. package/packages/core/dist/presentation/index.d.ts.map +1 -0
  427. package/packages/core/dist/presentation/index.js +8 -0
  428. package/packages/core/dist/presentation/index.js.map +1 -0
  429. package/packages/core/dist/presentation/items.d.ts +18 -0
  430. package/packages/core/dist/presentation/items.d.ts.map +1 -0
  431. package/packages/core/dist/presentation/items.js +228 -0
  432. package/packages/core/dist/presentation/items.js.map +1 -0
  433. package/packages/core/dist/presentation/ordering.d.ts +8 -0
  434. package/packages/core/dist/presentation/ordering.d.ts.map +1 -0
  435. package/packages/core/dist/presentation/ordering.js +31 -0
  436. package/packages/core/dist/presentation/ordering.js.map +1 -0
  437. package/packages/core/dist/presentation/planHelpers.d.ts +26 -0
  438. package/packages/core/dist/presentation/planHelpers.d.ts.map +1 -0
  439. package/packages/core/dist/presentation/planHelpers.js +62 -0
  440. package/packages/core/dist/presentation/planHelpers.js.map +1 -0
  441. package/packages/core/dist/presentation/presentationFormat.d.ts +39 -0
  442. package/packages/core/dist/presentation/presentationFormat.d.ts.map +1 -0
  443. package/packages/core/dist/presentation/presentationFormat.js +58 -0
  444. package/packages/core/dist/presentation/presentationFormat.js.map +1 -0
  445. package/packages/core/dist/presentation/renderCard.d.ts +37 -0
  446. package/packages/core/dist/presentation/renderCard.d.ts.map +1 -0
  447. package/packages/core/dist/presentation/renderCard.js +129 -0
  448. package/packages/core/dist/presentation/renderCard.js.map +1 -0
  449. package/packages/core/dist/presentation/scoring.d.ts +10 -0
  450. package/packages/core/dist/presentation/scoring.d.ts.map +1 -0
  451. package/packages/core/dist/presentation/scoring.js +82 -0
  452. package/packages/core/dist/presentation/scoring.js.map +1 -0
  453. package/packages/core/dist/presentation/selectPlan.d.ts +4 -0
  454. package/packages/core/dist/presentation/selectPlan.d.ts.map +1 -0
  455. package/packages/core/dist/presentation/selectPlan.js +122 -0
  456. package/packages/core/dist/presentation/selectPlan.js.map +1 -0
  457. package/packages/core/dist/presentation/selectShowcasePlan.d.ts +3 -0
  458. package/packages/core/dist/presentation/selectShowcasePlan.d.ts.map +1 -0
  459. package/packages/core/dist/presentation/selectShowcasePlan.js +6 -0
  460. package/packages/core/dist/presentation/selectShowcasePlan.js.map +1 -0
  461. package/packages/core/dist/presentation/selectWalkthroughPlan.d.ts +3 -0
  462. package/packages/core/dist/presentation/selectWalkthroughPlan.d.ts.map +1 -0
  463. package/packages/core/dist/presentation/selectWalkthroughPlan.js +6 -0
  464. package/packages/core/dist/presentation/selectWalkthroughPlan.js.map +1 -0
  465. package/packages/core/dist/presentation/selection.d.ts +7 -0
  466. package/packages/core/dist/presentation/selection.d.ts.map +1 -0
  467. package/packages/core/dist/presentation/selection.js +20 -0
  468. package/packages/core/dist/presentation/selection.js.map +1 -0
  469. package/packages/core/dist/presentation/snapshot.d.ts +12 -0
  470. package/packages/core/dist/presentation/snapshot.d.ts.map +1 -0
  471. package/packages/core/dist/presentation/snapshot.js +53 -0
  472. package/packages/core/dist/presentation/snapshot.js.map +1 -0
  473. package/packages/core/dist/presentation/types.d.ts +172 -0
  474. package/packages/core/dist/presentation/types.d.ts.map +1 -0
  475. package/packages/core/dist/presentation/types.js +2 -0
  476. package/packages/core/dist/presentation/types.js.map +1 -0
  477. package/packages/core/dist/redact.d.ts +11 -0
  478. package/packages/core/dist/redact.d.ts.map +1 -0
  479. package/packages/core/dist/redact.js +17 -0
  480. package/packages/core/dist/redact.js.map +1 -0
  481. package/packages/core/dist/roots.d.ts +81 -0
  482. package/packages/core/dist/roots.d.ts.map +1 -0
  483. package/packages/core/dist/roots.js +220 -0
  484. package/packages/core/dist/roots.js.map +1 -0
  485. package/packages/core/dist/schema/cliResult.d.ts +34 -0
  486. package/packages/core/dist/schema/cliResult.d.ts.map +1 -0
  487. package/packages/core/dist/schema/cliResult.js +35 -0
  488. package/packages/core/dist/schema/cliResult.js.map +1 -0
  489. package/packages/core/dist/schema/diagnostic.d.ts +26 -0
  490. package/packages/core/dist/schema/diagnostic.d.ts.map +1 -0
  491. package/packages/core/dist/schema/diagnostic.js +28 -0
  492. package/packages/core/dist/schema/diagnostic.js.map +1 -0
  493. package/packages/core/dist/schema/index.d.ts +8 -0
  494. package/packages/core/dist/schema/index.d.ts.map +1 -0
  495. package/packages/core/dist/schema/index.js +9 -0
  496. package/packages/core/dist/schema/index.js.map +1 -0
  497. package/packages/core/dist/schema/registry.d.ts +15 -0
  498. package/packages/core/dist/schema/registry.d.ts.map +1 -0
  499. package/packages/core/dist/schema/registry.js +206 -0
  500. package/packages/core/dist/schema/registry.js.map +1 -0
  501. package/packages/core/dist/schema/syntheticContracts.d.ts +3 -0
  502. package/packages/core/dist/schema/syntheticContracts.d.ts.map +1 -0
  503. package/packages/core/dist/schema/syntheticContracts.js +342 -0
  504. package/packages/core/dist/schema/syntheticContracts.js.map +1 -0
  505. package/packages/core/dist/schema/validate.d.ts +21 -0
  506. package/packages/core/dist/schema/validate.d.ts.map +1 -0
  507. package/packages/core/dist/schema/validate.js +210 -0
  508. package/packages/core/dist/schema/validate.js.map +1 -0
  509. package/packages/core/dist/schemas/v1/authority.schema.json +70 -0
  510. package/packages/core/dist/schemas/v1/cli-result.schema.json +30 -0
  511. package/packages/core/dist/schemas/v1/common.schema.json +274 -0
  512. package/packages/core/dist/schemas/v1/demo-capsule.schema.json +78 -0
  513. package/packages/core/dist/schemas/v1/evidence-append-result.schema.json +14 -0
  514. package/packages/core/dist/schemas/v1/evidence-event.schema.json +181 -0
  515. package/packages/core/dist/schemas/v1/evidence-status-result.schema.json +68 -0
  516. package/packages/core/dist/schemas/v1/host-profile.schema.json +94 -0
  517. package/packages/core/dist/schemas/v1/host-status-result.schema.json +49 -0
  518. package/packages/core/dist/schemas/v1/keyring.schema.json +77 -0
  519. package/packages/core/dist/schemas/v1/ledger.schema.json +99 -0
  520. package/packages/core/dist/schemas/v1/marker.schema.json +84 -0
  521. package/packages/core/dist/schemas/v1/matrix-list-result.schema.json +67 -0
  522. package/packages/core/dist/schemas/v1/matrix-mutation-result.schema.json +49 -0
  523. package/packages/core/dist/schemas/v1/matrix-validation-result.schema.json +77 -0
  524. package/packages/core/dist/schemas/v1/mcp-tool-results.schema.json +34 -0
  525. package/packages/core/dist/schemas/v1/migration-test-matrix-result.schema.json +76 -0
  526. package/packages/core/dist/schemas/v1/presentation-plan-result.schema.json +62 -0
  527. package/packages/core/dist/schemas/v1/presentation-plan.schema.json +259 -0
  528. package/packages/core/dist/schemas/v1/release-gate-result.schema.json +136 -0
  529. package/packages/core/dist/schemas/v1/showcase-approval-result.schema.json +5 -0
  530. package/packages/core/dist/schemas/v1/showcase-event-append-result.schema.json +17 -0
  531. package/packages/core/dist/schemas/v1/showcase-event.schema.json +235 -0
  532. package/packages/core/dist/schemas/v1/showcase-finish-result.schema.json +5 -0
  533. package/packages/core/dist/schemas/v1/showcase-run-status-result.schema.json +70 -0
  534. package/packages/core/dist/schemas/v1/showcase-start-result.schema.json +5 -0
  535. package/packages/core/dist/schemas/v1/use-case-file.schema.json +178 -0
  536. package/packages/core/dist/schemas/v1/workflow-mode.schema.json +16 -0
  537. package/packages/core/dist/schemas/v1/workspace-config.schema.json +58 -0
  538. package/packages/core/dist/showcase/appendShowcaseEvent.d.ts +116 -0
  539. package/packages/core/dist/showcase/appendShowcaseEvent.d.ts.map +1 -0
  540. package/packages/core/dist/showcase/appendShowcaseEvent.js +353 -0
  541. package/packages/core/dist/showcase/appendShowcaseEvent.js.map +1 -0
  542. package/packages/core/dist/showcase/approval.d.ts +2 -0
  543. package/packages/core/dist/showcase/approval.d.ts.map +1 -0
  544. package/packages/core/dist/showcase/approval.js +2 -0
  545. package/packages/core/dist/showcase/approval.js.map +1 -0
  546. package/packages/core/dist/showcase/approvalAuthority.d.ts +19 -0
  547. package/packages/core/dist/showcase/approvalAuthority.d.ts.map +1 -0
  548. package/packages/core/dist/showcase/approvalAuthority.js +46 -0
  549. package/packages/core/dist/showcase/approvalAuthority.js.map +1 -0
  550. package/packages/core/dist/showcase/index.d.ts +11 -0
  551. package/packages/core/dist/showcase/index.d.ts.map +1 -0
  552. package/packages/core/dist/showcase/index.js +11 -0
  553. package/packages/core/dist/showcase/index.js.map +1 -0
  554. package/packages/core/dist/showcase/jsonlLedger.d.ts +11 -0
  555. package/packages/core/dist/showcase/jsonlLedger.d.ts.map +1 -0
  556. package/packages/core/dist/showcase/jsonlLedger.js +50 -0
  557. package/packages/core/dist/showcase/jsonlLedger.js.map +1 -0
  558. package/packages/core/dist/showcase/planBinding.d.ts +5 -0
  559. package/packages/core/dist/showcase/planBinding.d.ts.map +1 -0
  560. package/packages/core/dist/showcase/planBinding.js +33 -0
  561. package/packages/core/dist/showcase/planBinding.js.map +1 -0
  562. package/packages/core/dist/showcase/replayRun.d.ts +5 -0
  563. package/packages/core/dist/showcase/replayRun.d.ts.map +1 -0
  564. package/packages/core/dist/showcase/replayRun.js +199 -0
  565. package/packages/core/dist/showcase/replayRun.js.map +1 -0
  566. package/packages/core/dist/showcase/results.d.ts +3 -0
  567. package/packages/core/dist/showcase/results.d.ts.map +1 -0
  568. package/packages/core/dist/showcase/results.js +4 -0
  569. package/packages/core/dist/showcase/results.js.map +1 -0
  570. package/packages/core/dist/showcase/revisionEpochs.d.ts +2 -0
  571. package/packages/core/dist/showcase/revisionEpochs.d.ts.map +1 -0
  572. package/packages/core/dist/showcase/revisionEpochs.js +2 -0
  573. package/packages/core/dist/showcase/revisionEpochs.js.map +1 -0
  574. package/packages/core/dist/showcase/startRun.d.ts +2 -0
  575. package/packages/core/dist/showcase/startRun.d.ts.map +1 -0
  576. package/packages/core/dist/showcase/startRun.js +2 -0
  577. package/packages/core/dist/showcase/startRun.js.map +1 -0
  578. package/packages/core/dist/showcase/types.d.ts +66 -0
  579. package/packages/core/dist/showcase/types.d.ts.map +1 -0
  580. package/packages/core/dist/showcase/types.js +2 -0
  581. package/packages/core/dist/showcase/types.js.map +1 -0
  582. package/packages/core/dist/skills/canonicalSkills.d.ts +3 -0
  583. package/packages/core/dist/skills/canonicalSkills.d.ts.map +1 -0
  584. package/packages/core/dist/skills/canonicalSkills.js +7 -0
  585. package/packages/core/dist/skills/canonicalSkills.js.map +1 -0
  586. package/packages/core/dist/skills/index.d.ts +4 -0
  587. package/packages/core/dist/skills/index.d.ts.map +1 -0
  588. package/packages/core/dist/skills/index.js +4 -0
  589. package/packages/core/dist/skills/index.js.map +1 -0
  590. package/packages/core/dist/skills/types.d.ts +26 -0
  591. package/packages/core/dist/skills/types.d.ts.map +1 -0
  592. package/packages/core/dist/skills/types.js +2 -0
  593. package/packages/core/dist/skills/types.js.map +1 -0
  594. package/packages/core/dist/skills/validateSkillAssets.d.ts +6 -0
  595. package/packages/core/dist/skills/validateSkillAssets.d.ts.map +1 -0
  596. package/packages/core/dist/skills/validateSkillAssets.js +218 -0
  597. package/packages/core/dist/skills/validateSkillAssets.js.map +1 -0
  598. package/packages/core/dist/useCases/integrity.d.ts +11 -0
  599. package/packages/core/dist/useCases/integrity.d.ts.map +1 -0
  600. package/packages/core/dist/useCases/integrity.js +178 -0
  601. package/packages/core/dist/useCases/integrity.js.map +1 -0
  602. package/packages/core/dist/useCases/loadUseCaseMatrix.d.ts +7 -0
  603. package/packages/core/dist/useCases/loadUseCaseMatrix.d.ts.map +1 -0
  604. package/packages/core/dist/useCases/loadUseCaseMatrix.js +74 -0
  605. package/packages/core/dist/useCases/loadUseCaseMatrix.js.map +1 -0
  606. package/packages/core/dist/useCases/mutateUseCaseMatrix.d.ts +25 -0
  607. package/packages/core/dist/useCases/mutateUseCaseMatrix.d.ts.map +1 -0
  608. package/packages/core/dist/useCases/mutateUseCaseMatrix.js +198 -0
  609. package/packages/core/dist/useCases/mutateUseCaseMatrix.js.map +1 -0
  610. package/packages/core/dist/useCases/query.d.ts +12 -0
  611. package/packages/core/dist/useCases/query.d.ts.map +1 -0
  612. package/packages/core/dist/useCases/query.js +47 -0
  613. package/packages/core/dist/useCases/query.js.map +1 -0
  614. package/packages/core/dist/useCases/types.d.ts +149 -0
  615. package/packages/core/dist/useCases/types.d.ts.map +1 -0
  616. package/packages/core/dist/useCases/types.js +2 -0
  617. package/packages/core/dist/useCases/types.js.map +1 -0
  618. package/packages/core/dist/useCases/validateUseCaseFile.d.ts +9 -0
  619. package/packages/core/dist/useCases/validateUseCaseFile.d.ts.map +1 -0
  620. package/packages/core/dist/useCases/validateUseCaseFile.js +107 -0
  621. package/packages/core/dist/useCases/validateUseCaseFile.js.map +1 -0
  622. package/packages/core/dist/version.d.ts +9 -0
  623. package/packages/core/dist/version.d.ts.map +1 -0
  624. package/packages/core/dist/version.js +17 -0
  625. package/packages/core/dist/version.js.map +1 -0
  626. package/packages/core/package.json +39 -0
  627. package/packages/mcp/README.md +48 -0
  628. package/packages/mcp/dist/index.d.ts +20 -0
  629. package/packages/mcp/dist/index.d.ts.map +1 -0
  630. package/packages/mcp/dist/index.js +180 -0
  631. package/packages/mcp/dist/index.js.map +1 -0
  632. package/packages/mcp/dist/prompts.d.ts +32 -0
  633. package/packages/mcp/dist/prompts.d.ts.map +1 -0
  634. package/packages/mcp/dist/prompts.js +199 -0
  635. package/packages/mcp/dist/prompts.js.map +1 -0
  636. package/packages/mcp/dist/resources.d.ts +22 -0
  637. package/packages/mcp/dist/resources.d.ts.map +1 -0
  638. package/packages/mcp/dist/resources.js +342 -0
  639. package/packages/mcp/dist/resources.js.map +1 -0
  640. package/packages/mcp/dist/toolHandlers.d.ts +28 -0
  641. package/packages/mcp/dist/toolHandlers.d.ts.map +1 -0
  642. package/packages/mcp/dist/toolHandlers.js +592 -0
  643. package/packages/mcp/dist/toolHandlers.js.map +1 -0
  644. package/packages/mcp/dist/toolSchemas.d.ts +23 -0
  645. package/packages/mcp/dist/toolSchemas.d.ts.map +1 -0
  646. package/packages/mcp/dist/toolSchemas.js +223 -0
  647. package/packages/mcp/dist/toolSchemas.js.map +1 -0
  648. package/packages/mcp/dist/tools.d.ts +22 -0
  649. package/packages/mcp/dist/tools.d.ts.map +1 -0
  650. package/packages/mcp/dist/tools.js +65 -0
  651. package/packages/mcp/dist/tools.js.map +1 -0
  652. package/packages/mcp/package.json +38 -0
  653. package/plugin.json +6 -0
  654. package/schemas/v1/authority.schema.json +70 -0
  655. package/schemas/v1/cli-result.schema.json +30 -0
  656. package/schemas/v1/common.schema.json +274 -0
  657. package/schemas/v1/demo-capsule.schema.json +78 -0
  658. package/schemas/v1/evidence-append-result.schema.json +14 -0
  659. package/schemas/v1/evidence-event.schema.json +181 -0
  660. package/schemas/v1/evidence-status-result.schema.json +68 -0
  661. package/schemas/v1/host-profile.schema.json +94 -0
  662. package/schemas/v1/host-status-result.schema.json +49 -0
  663. package/schemas/v1/keyring.schema.json +77 -0
  664. package/schemas/v1/ledger.schema.json +99 -0
  665. package/schemas/v1/marker.schema.json +84 -0
  666. package/schemas/v1/matrix-list-result.schema.json +67 -0
  667. package/schemas/v1/matrix-mutation-result.schema.json +49 -0
  668. package/schemas/v1/matrix-validation-result.schema.json +77 -0
  669. package/schemas/v1/mcp-tool-results.schema.json +34 -0
  670. package/schemas/v1/migration-test-matrix-result.schema.json +76 -0
  671. package/schemas/v1/presentation-plan-result.schema.json +62 -0
  672. package/schemas/v1/presentation-plan.schema.json +259 -0
  673. package/schemas/v1/release-gate-result.schema.json +136 -0
  674. package/schemas/v1/showcase-approval-result.schema.json +5 -0
  675. package/schemas/v1/showcase-event-append-result.schema.json +17 -0
  676. package/schemas/v1/showcase-event.schema.json +235 -0
  677. package/schemas/v1/showcase-finish-result.schema.json +5 -0
  678. package/schemas/v1/showcase-run-status-result.schema.json +70 -0
  679. package/schemas/v1/showcase-start-result.schema.json +5 -0
  680. package/schemas/v1/use-case-file.schema.json +178 -0
  681. package/schemas/v1/workflow-mode.schema.json +16 -0
  682. package/schemas/v1/workspace-config.schema.json +58 -0
  683. package/use-cases/capsule/demos.yml +212 -0
  684. package/use-cases/capsule/runner.yml +49 -0
  685. package/use-cases/diagnostics/contracts.yml +239 -0
  686. package/use-cases/evidence/core.yml +32 -0
  687. package/use-cases/evidence/ledger.yml +330 -0
  688. package/use-cases/hosts/profiles.yml +365 -0
  689. package/use-cases/hosts/projections.yml +96 -0
  690. package/use-cases/lifecycle/loop.yml +229 -0
  691. package/use-cases/matrix/core.yml +92 -0
  692. package/use-cases/matrix/product.yml +289 -0
  693. package/use-cases/mcp/surface.yml +257 -0
  694. package/use-cases/mcp/wrapper.yml +100 -0
  695. package/use-cases/migration/importer.yml +171 -0
  696. package/use-cases/migration/test-matrix.yml +32 -0
  697. package/use-cases/planning/cards.yml +215 -0
  698. package/use-cases/release/package.yml +80 -0
  699. package/use-cases/release/proof.yml +180 -0
  700. package/use-cases/roadmap/deferred.yml +184 -0
  701. package/use-cases/showcase/flow.yml +269 -0
  702. package/use-cases/showcase/live.yml +44 -0
  703. package/use-cases/skills/assets.yml +92 -0
  704. package/use-cases.yml +9 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runCapsule.js","sourceRoot":"","sources":["../../src/capsules/runCapsule.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,106 @@
1
+ import type { Diagnostic } from "../schema/index.js";
2
+ import type { PresentationPlanResult, PresentationMode } from "../presentation/types.js";
3
+ import type { ResolvedWorkspaceContext } from "../roots.js";
4
+ import type { ShowcaseActorType, ShowcaseRunStatus } from "../showcase/types.js";
5
+ import type { HostSurface } from "../useCases/types.js";
6
+ export type DemoCapsuleCommandStep = {
7
+ kind: "command";
8
+ executable: string;
9
+ argv: string[];
10
+ working_directory: string;
11
+ expected_exit_codes: number[];
12
+ };
13
+ export type DemoCapsuleRunbookStep = {
14
+ kind: "instruction";
15
+ text: string;
16
+ } | {
17
+ kind: "observation";
18
+ text: string;
19
+ } | DemoCapsuleCommandStep;
20
+ export type DemoCapsuleItem = {
21
+ use_case_id: string;
22
+ scenario_ids?: string[];
23
+ runbook: DemoCapsuleRunbookStep[];
24
+ };
25
+ export type DemoCapsule = {
26
+ schema_version: 1;
27
+ capsule_id: string;
28
+ title: string;
29
+ mode: PresentationMode;
30
+ description: string;
31
+ audience: string;
32
+ timebox_seconds: number;
33
+ items: DemoCapsuleItem[];
34
+ permissions: {
35
+ command_execution: boolean;
36
+ };
37
+ extensions?: Record<string, unknown>;
38
+ };
39
+ export type LoadedDemoCapsule = {
40
+ capsule: DemoCapsule;
41
+ path: string;
42
+ semantic_hash: string;
43
+ };
44
+ export type CapsuleFileResult = {
45
+ path: string;
46
+ status: "loaded" | "parse_error" | "schema_error" | "io_error" | "symlink_rejected" | "path_escape";
47
+ file_hash?: string;
48
+ };
49
+ export type CapsuleSnapshot = {
50
+ schema_version: 1;
51
+ complete: boolean;
52
+ files: CapsuleFileResult[];
53
+ capsules: LoadedDemoCapsule[];
54
+ diagnostics: Diagnostic[];
55
+ };
56
+ export type CapsulePlanResult = {
57
+ schema_version: 1;
58
+ outcome: "generated" | "capsule_not_found" | "integrity_blocked";
59
+ capsule: LoadedDemoCapsule | null;
60
+ plan_result: PresentationPlanResult | null;
61
+ diagnostics: Diagnostic[];
62
+ };
63
+ export type DemoCapsuleRunOptions = {
64
+ context: ResolvedWorkspaceContext;
65
+ capsuleId: string;
66
+ executeCommands?: boolean;
67
+ actorType?: Exclude<ShowcaseActorType, "user">;
68
+ hostSurface?: HostSurface;
69
+ idempotencyKey?: string;
70
+ recordedAt?: string;
71
+ commandTimeoutMs?: number;
72
+ };
73
+ export type DemoCapsulePendingStep = {
74
+ item_index: number;
75
+ step_index: number;
76
+ use_case_id: string;
77
+ reason: "command_execution_not_requested" | "runtime_observation_required";
78
+ };
79
+ export type DemoCapsuleCommandResult = {
80
+ item_index: number;
81
+ step_index: number;
82
+ use_case_id: string;
83
+ executable: string;
84
+ argv: string[];
85
+ working_directory: string;
86
+ exit_code: number | null;
87
+ signal: string | null;
88
+ stdout: string;
89
+ stderr: string;
90
+ expected_exit_codes: number[];
91
+ matched_expected_exit_code: boolean;
92
+ };
93
+ export type DemoCapsuleRunResult = {
94
+ schema_version: 1;
95
+ outcome: "performed" | "blocked";
96
+ complete: boolean;
97
+ capsule_id: string | null;
98
+ run_id: string | null;
99
+ events_written: string[];
100
+ pending_steps: DemoCapsulePendingStep[];
101
+ command_results: DemoCapsuleCommandResult[];
102
+ status: ShowcaseRunStatus | null;
103
+ plan_result: PresentationPlanResult | null;
104
+ diagnostics: Diagnostic[];
105
+ };
106
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/capsules/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/capsules/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export declare function fsyncBestEffortForTemp(fd: number, path: string): void;
2
+ //# sourceMappingURL=durableWrite.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durableWrite.d.ts","sourceRoot":"","sources":["../src/durableWrite.ts"],"names":[],"mappings":"AAOA,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CASrE"}
@@ -0,0 +1,34 @@
1
+ import { fsyncSync, realpathSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import { isAbsolute, relative, resolve } from "node:path";
4
+ const BEST_EFFORT_TEMP_SYNC_CODES = new Set(["EIO", "EINVAL", "ENOSYS", "ENOTSUP"]);
5
+ //: @use-case: evidence.ledger.crash_durable_ledger_writes
6
+ export function fsyncBestEffortForTemp(fd, path) {
7
+ try {
8
+ fsyncSync(fd);
9
+ }
10
+ catch (error) {
11
+ if (isBestEffortTempSyncError(error, path)) {
12
+ return;
13
+ }
14
+ throw error;
15
+ }
16
+ }
17
+ //: @use-case: end evidence.ledger.crash_durable_ledger_writes
18
+ function isBestEffortTempSyncError(error, path) {
19
+ const code = error.code;
20
+ return typeof code === "string" && BEST_EFFORT_TEMP_SYNC_CODES.has(code) && isInsideTempRoot(path);
21
+ }
22
+ function isInsideTempRoot(path) {
23
+ const rel = relative(realPathOrResolved(tmpdir()), realPathOrResolved(path));
24
+ return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
25
+ }
26
+ function realPathOrResolved(path) {
27
+ try {
28
+ return realpathSync(path);
29
+ }
30
+ catch {
31
+ return resolve(path);
32
+ }
33
+ }
34
+ //# sourceMappingURL=durableWrite.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durableWrite.js","sourceRoot":"","sources":["../src/durableWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpF,0DAA0D;AAC1D,MAAM,UAAU,sBAAsB,CAAC,EAAU,EAAE,IAAY;IAC7D,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,yBAAyB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AACD,8DAA8D;AAE9D,SAAS,yBAAyB,CAAC,KAAc,EAAE,IAAY;IAC7D,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
@@ -0,0 +1,122 @@
1
+ import { EvidenceErrorCode } from "../markers/evidenceLedger.js";
2
+ import { MarkerErrorCode } from "../markers/markerLine.js";
3
+ import { SignatureFailureCode } from "../markers/proofSignature.js";
4
+ import { RegistryErrorCode } from "../markers/registry.js";
5
+ import { SwiftFuncErrorCode } from "../markers/swiftFuncRecognizer.js";
6
+ /** Declared severity of an error code. */
7
+ export type UcmErrorSeverity = "error" | "warning" | "info";
8
+ /** The surface a code originates from (groups codes in the docs + diagnostics). */
9
+ export type UcmErrorSurface = "marker" | "registry" | "evidence" | "signature" | "swift" | "workspace" | "migration" | "showcase" | "path";
10
+ /** A single registry entry, keyed by its `UCM_*` code. */
11
+ export interface UcmErrorEntry {
12
+ /** Human-readable message template (may contain `'...'` placeholders). */
13
+ readonly message: string;
14
+ readonly severity: UcmErrorSeverity;
15
+ readonly surface: UcmErrorSurface;
16
+ /** Relative docs path, e.g. `errors/UCM_MARKER_MALFORMED`. */
17
+ readonly docs: string;
18
+ }
19
+ declare const REGISTRY: {
20
+ readonly UCM_MARKER_FORBIDDEN_PAYLOAD: UcmErrorEntry;
21
+ readonly UCM_MARKER_MALFORMED: UcmErrorEntry;
22
+ readonly UCM_MARKER_END_MALFORMED: UcmErrorEntry;
23
+ readonly UCM_MARKER_END_MISMATCHED: UcmErrorEntry;
24
+ readonly UCM_MARKER_END_WITHOUT_START: UcmErrorEntry;
25
+ readonly UCM_MARKER_UNSUPPORTED_INFERENCE: UcmErrorEntry;
26
+ readonly UCM_MARKER_NESTED_SPAN: UcmErrorEntry;
27
+ readonly UCM_MARKER_DUPLICATE_BINDING_SLUG: UcmErrorEntry;
28
+ readonly UCM_REGISTRY_JSON_PARSE: UcmErrorEntry;
29
+ readonly UCM_REGISTRY_SCHEMA_INVALID: UcmErrorEntry;
30
+ readonly UCM_REGISTRY_SLUG_PREFIX_MISMATCH: UcmErrorEntry;
31
+ readonly UCM_REGISTRY_ROW_MISSING: UcmErrorEntry;
32
+ readonly UCM_REGISTRY_DUPLICATE_REGISTRATION: UcmErrorEntry;
33
+ readonly UCM_REGISTRY_SLUG_ROW_CONFLICT: UcmErrorEntry;
34
+ readonly UCM_EVIDENCE_JSON_PARSE: UcmErrorEntry;
35
+ readonly UCM_EVIDENCE_SCHEMA_INVALID: UcmErrorEntry;
36
+ readonly UCM_EVIDENCE_PRODUCER_NOT_TRUSTED: UcmErrorEntry;
37
+ readonly UCM_EVIDENCE_VERIFICATION_NOT_PASS: UcmErrorEntry;
38
+ readonly UCM_EVIDENCE_BINDING_SET_HASH_MISMATCH: UcmErrorEntry;
39
+ readonly UCM_EVIDENCE_ROW_MISSING: UcmErrorEntry;
40
+ readonly UCM_EVIDENCE_APPEND_ONLY_VIOLATION: UcmErrorEntry;
41
+ readonly UCM_EVIDENCE_LEDGER_DAMAGED: UcmErrorEntry;
42
+ readonly UCM_EVIDENCE_IDEMPOTENCY_CONFLICT: UcmErrorEntry;
43
+ readonly UCM_EVIDENCE_INVALID_TRANSITION: UcmErrorEntry;
44
+ readonly UCM_EVIDENCE_EXPECTED_HEAD_MISMATCH: UcmErrorEntry;
45
+ readonly UCM_EVIDENCE_LOCK_TIMEOUT: UcmErrorEntry;
46
+ readonly UCM_LEDGER_CHAIN_BROKEN: UcmErrorEntry;
47
+ readonly UCM_LEDGER_INDEX_GAP: UcmErrorEntry;
48
+ readonly UCM_LEDGER_DUPLICATE_INDEX: UcmErrorEntry;
49
+ readonly UCM_SIGNATURE_MISSING: UcmErrorEntry;
50
+ readonly UCM_SIGNATURE_ALG_UNSUPPORTED: UcmErrorEntry;
51
+ readonly UCM_SIGNATURE_UNKNOWN_KEY_ID: UcmErrorEntry;
52
+ readonly UCM_SIGNATURE_BAD: UcmErrorEntry;
53
+ readonly UCM_SWIFT_NO_PARSER: UcmErrorEntry;
54
+ readonly UCM_SWIFT_PARSE_ERROR: UcmErrorEntry;
55
+ readonly UCM_SWIFT_MARKER_NOT_ADJACENT: UcmErrorEntry;
56
+ readonly UCM_SWIFT_MARKER_INSIDE_ATTACHED: UcmErrorEntry;
57
+ readonly UCM_SWIFT_NEXT_NODE_NOT_FUNC: UcmErrorEntry;
58
+ readonly UCM_SWIFT_FUNC_NO_BODY: UcmErrorEntry;
59
+ readonly UCM_SWIFT_FUNC_NO_CLOSING_BRACE: UcmErrorEntry;
60
+ readonly UCM_SWIFT_NESTED_FUNC_UNSUPPORTED: UcmErrorEntry;
61
+ readonly UCM_SWIFT_CONDITIONAL_COMPILATION: UcmErrorEntry;
62
+ readonly UCM_SWIFT_MARKER_INSIDE_SPAN: UcmErrorEntry;
63
+ readonly UCM_SWIFT_MULTIPLE_CANDIDATES: UcmErrorEntry;
64
+ readonly UCM_WORKSPACE_COMPONENT_UNKNOWN: UcmErrorEntry;
65
+ readonly UCM_WORKSPACE_CONFIG_PARSE: UcmErrorEntry;
66
+ readonly UCM_WORKSPACE_CONFIG_INVALID: UcmErrorEntry;
67
+ readonly UCM_PATH_ESCAPE: UcmErrorEntry;
68
+ readonly UCM_INVALID_ID: UcmErrorEntry;
69
+ readonly UCM_MIGRATION_UNSAFE_SOURCE_PATH: UcmErrorEntry;
70
+ readonly UCM_MIGRATION_UNSAFE_OUTPUT_PATH: UcmErrorEntry;
71
+ readonly UCM_SHOWCASE_PLAN_UNREADABLE: UcmErrorEntry;
72
+ readonly UCM_SHOWCASE_PLAN_PLACEHOLDER_HASH: UcmErrorEntry;
73
+ readonly UCM_SHOWCASE_PLAN_HASH_MISMATCH: UcmErrorEntry;
74
+ readonly UCM_SHOWCASE_PLAN_INVALID: UcmErrorEntry;
75
+ readonly UCM_SHOWCASE_USER_APPROVAL_REQUIRED: UcmErrorEntry;
76
+ readonly UCM_SHOWCASE_TRUSTED_CONFIRMATION_REQUIRED: UcmErrorEntry;
77
+ readonly UCM_SHOWCASE_FINISH_REQUIRED: UcmErrorEntry;
78
+ readonly UCM_SHOWCASE_KNOWN_GAP_ACK_REQUIRED: UcmErrorEntry;
79
+ readonly UCM_SHOWCASE_LEDGER_DAMAGED: UcmErrorEntry;
80
+ readonly UCM_SHOWCASE_IDEMPOTENCY_CONFLICT: UcmErrorEntry;
81
+ readonly UCM_SHOWCASE_RUN_ID_CONFLICT: UcmErrorEntry;
82
+ readonly UCM_SHOWCASE_VERDICT_REQUIRES_OBSERVATION: UcmErrorEntry;
83
+ readonly UCM_SHOWCASE_INVALID_FAILURE_DECISION_TARGET: UcmErrorEntry;
84
+ readonly UCM_SHOWCASE_FAILURE_DECISION_REQUIRED: UcmErrorEntry;
85
+ readonly UCM_SHOWCASE_INVALID_CORRECTION_TARGET: UcmErrorEntry;
86
+ };
87
+ /** The typed union of every stable public `UCM_*` error code. */
88
+ export type UcmErrorCode = keyof typeof REGISTRY;
89
+ /** The single source-of-truth registry of stable `UCM_*` error codes. */
90
+ export declare const UCM_ERROR_REGISTRY: Readonly<Record<UcmErrorCode, UcmErrorEntry>>;
91
+ /** Every `UCM_*` code, in stable (sorted) order. */
92
+ export declare const UCM_ERROR_CODES: readonly UcmErrorCode[];
93
+ /** Look up a registry entry by its `UCM_*` code. */
94
+ export declare function getUcmErrorEntry(code: UcmErrorCode): UcmErrorEntry;
95
+ /** The legacy enum families covered by the registry. */
96
+ export type UcmErrorFamily = "marker" | "registry" | "evidence" | "swiftFunc" | "signature";
97
+ export declare const LEGACY_ENUM_CODE_MAP: {
98
+ readonly marker: Readonly<Record<MarkerErrorCode, UcmErrorCode>>;
99
+ readonly registry: Readonly<Record<RegistryErrorCode, UcmErrorCode>>;
100
+ readonly evidence: Readonly<Record<EvidenceErrorCode, UcmErrorCode>>;
101
+ readonly swiftFunc: Readonly<Record<SwiftFuncErrorCode, UcmErrorCode>>;
102
+ readonly signature: Readonly<Record<SignatureFailureCode, UcmErrorCode>>;
103
+ };
104
+ /**
105
+ * Map an existing internal enum value to its stable `UCM_*` public code.
106
+ * The `family` selects which enum the code belongs to (the same legacy string,
107
+ * e.g. `SIGNATURE_MISSING`, exists in more than one family).
108
+ */
109
+ export declare function mapEnumCode(family: "marker", code: MarkerErrorCode): UcmErrorCode;
110
+ export declare function mapEnumCode(family: "registry", code: RegistryErrorCode): UcmErrorCode;
111
+ export declare function mapEnumCode(family: "evidence", code: EvidenceErrorCode): UcmErrorCode;
112
+ export declare function mapEnumCode(family: "swiftFunc", code: SwiftFuncErrorCode): UcmErrorCode;
113
+ export declare function mapEnumCode(family: "signature", code: SignatureFailureCode): UcmErrorCode;
114
+ /**
115
+ * Map a legacy `UseCasesPluginError` string-literal code to its stable
116
+ * `UCM_*` public code. Returns `undefined` for unmapped/unknown codes.
117
+ */
118
+ export declare const LEGACY_STRING_CODE_MAP: Readonly<Record<string, UcmErrorCode>>;
119
+ /** Map a legacy string-literal diagnostic code to its `UCM_*` code, if known. */
120
+ export declare function mapStringCode(code: string): UcmErrorCode | undefined;
121
+ export {};
122
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/errors/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,206 @@
1
+ // Centralized, stable `UCM_*` error-code registry (additive).
2
+ //
3
+ // This module is the single source of truth for the public error codes that are
4
+ // part of the v1 contract (see `docs/reference/stability.md`). It does NOT
5
+ // replace the existing internal enum families or the ~21 `UseCasesPluginError`
6
+ // string-literal codes; instead it gives each of them a stable public `UCM_*`
7
+ // code and a mapping helper, so diagnostics can be annotated with a stable code
8
+ // without renaming every internal call site at once.
9
+ //
10
+ // The on-disk reference page `docs/reference/error-codes.md` is generated from
11
+ // this registry (see `./render.ts` and `scripts/generate-error-codes.mjs`) and a
12
+ // test keeps the two in sync.
13
+ import { EvidenceErrorCode } from "../markers/evidenceLedger.js";
14
+ import { MarkerErrorCode } from "../markers/markerLine.js";
15
+ import { SignatureFailureCode } from "../markers/proofSignature.js";
16
+ import { RegistryErrorCode } from "../markers/registry.js";
17
+ import { SwiftFuncErrorCode } from "../markers/swiftFuncRecognizer.js";
18
+ function entry(surface, message, code, severity = "error") {
19
+ return { message, severity, surface, docs: `errors/${code}` };
20
+ }
21
+ // The registry. Keys are the stable public `UCM_*` codes; never rename or remove
22
+ // a key without a major version bump (see stability policy).
23
+ const REGISTRY = {
24
+ // --- marker grammar (surface: marker) -----------------------------------
25
+ UCM_MARKER_FORBIDDEN_PAYLOAD: entry("marker", "Marker line carries a forbidden payload.", "UCM_MARKER_FORBIDDEN_PAYLOAD"),
26
+ UCM_MARKER_MALFORMED: entry("marker", "Marker line is malformed.", "UCM_MARKER_MALFORMED"),
27
+ UCM_MARKER_END_MALFORMED: entry("marker", "Marker end line is malformed.", "UCM_MARKER_END_MALFORMED"),
28
+ UCM_MARKER_END_MISMATCHED: entry("marker", "Marker end line does not match its open marker.", "UCM_MARKER_END_MISMATCHED"),
29
+ UCM_MARKER_END_WITHOUT_START: entry("marker", "Marker end line has no matching start.", "UCM_MARKER_END_WITHOUT_START"),
30
+ UCM_MARKER_UNSUPPORTED_INFERENCE: entry("marker", "Marker span uses an unsupported inference.", "UCM_MARKER_UNSUPPORTED_INFERENCE"),
31
+ UCM_MARKER_NESTED_SPAN: entry("marker", "Marker spans may not be nested.", "UCM_MARKER_NESTED_SPAN"),
32
+ UCM_MARKER_DUPLICATE_BINDING_SLUG: entry("marker", "Duplicate binding slug within the same source.", "UCM_MARKER_DUPLICATE_BINDING_SLUG"),
33
+ // --- binding registry (surface: registry) -------------------------------
34
+ UCM_REGISTRY_JSON_PARSE: entry("registry", "Binding registry is not valid JSON.", "UCM_REGISTRY_JSON_PARSE"),
35
+ UCM_REGISTRY_SCHEMA_INVALID: entry("registry", "Binding registry does not match its schema.", "UCM_REGISTRY_SCHEMA_INVALID"),
36
+ UCM_REGISTRY_SLUG_PREFIX_MISMATCH: entry("registry", "Binding slug prefix does not match the registry.", "UCM_REGISTRY_SLUG_PREFIX_MISMATCH"),
37
+ UCM_REGISTRY_ROW_MISSING: entry("registry", "Referenced registry row is missing.", "UCM_REGISTRY_ROW_MISSING"),
38
+ UCM_REGISTRY_DUPLICATE_REGISTRATION: entry("registry", "Duplicate registration in the binding registry.", "UCM_REGISTRY_DUPLICATE_REGISTRATION"),
39
+ UCM_REGISTRY_SLUG_ROW_CONFLICT: entry("registry", "Binding slug conflicts with an existing registry row.", "UCM_REGISTRY_SLUG_ROW_CONFLICT"),
40
+ // --- evidence ledger (surface: evidence) --------------------------------
41
+ UCM_EVIDENCE_JSON_PARSE: entry("evidence", "Evidence ledger line is not valid JSON.", "UCM_EVIDENCE_JSON_PARSE"),
42
+ UCM_EVIDENCE_SCHEMA_INVALID: entry("evidence", "Evidence event does not match its schema.", "UCM_EVIDENCE_SCHEMA_INVALID"),
43
+ UCM_EVIDENCE_PRODUCER_NOT_TRUSTED: entry("evidence", "Evidence producer is not trusted.", "UCM_EVIDENCE_PRODUCER_NOT_TRUSTED"),
44
+ UCM_EVIDENCE_VERIFICATION_NOT_PASS: entry("evidence", "Evidence verification did not pass.", "UCM_EVIDENCE_VERIFICATION_NOT_PASS"),
45
+ UCM_EVIDENCE_BINDING_SET_HASH_MISMATCH: entry("evidence", "Evidence binding-set hash does not match.", "UCM_EVIDENCE_BINDING_SET_HASH_MISMATCH"),
46
+ UCM_EVIDENCE_ROW_MISSING: entry("evidence", "Referenced evidence row is missing.", "UCM_EVIDENCE_ROW_MISSING"),
47
+ UCM_EVIDENCE_APPEND_ONLY_VIOLATION: entry("evidence", "Evidence ledger is append-only; rewrite rejected.", "UCM_EVIDENCE_APPEND_ONLY_VIOLATION"),
48
+ UCM_EVIDENCE_LEDGER_DAMAGED: entry("evidence", "Refusing to append to damaged evidence history.", "UCM_EVIDENCE_LEDGER_DAMAGED"),
49
+ UCM_EVIDENCE_IDEMPOTENCY_CONFLICT: entry("evidence", "Idempotency key was reused with different intent.", "UCM_EVIDENCE_IDEMPOTENCY_CONFLICT"),
50
+ UCM_EVIDENCE_INVALID_TRANSITION: entry("evidence", "Evidence aggregate is not in a state that allows this transition.", "UCM_EVIDENCE_INVALID_TRANSITION"),
51
+ UCM_EVIDENCE_EXPECTED_HEAD_MISMATCH: entry("evidence", "Expected head event does not match current head.", "UCM_EVIDENCE_EXPECTED_HEAD_MISMATCH"),
52
+ UCM_EVIDENCE_LOCK_TIMEOUT: entry("evidence", "Timed out acquiring evidence append lock.", "UCM_EVIDENCE_LOCK_TIMEOUT"),
53
+ // --- tamper-evident hash chain (surface: evidence) ----------------------
54
+ UCM_LEDGER_CHAIN_BROKEN: entry("evidence", "Evidence ledger hash chain is broken: an entry's previous_entry_hash does not match the preceding entry.", "UCM_LEDGER_CHAIN_BROKEN"),
55
+ UCM_LEDGER_INDEX_GAP: entry("evidence", "Evidence ledger entry_index does not match its actual position (gap, reorder, or truncation).", "UCM_LEDGER_INDEX_GAP"),
56
+ UCM_LEDGER_DUPLICATE_INDEX: entry("evidence", "Evidence ledger contains a duplicate entry_index.", "UCM_LEDGER_DUPLICATE_INDEX"),
57
+ // --- signature / proof verification (surface: signature) ----------------
58
+ UCM_SIGNATURE_MISSING: entry("signature", "Proof event is missing a signature.", "UCM_SIGNATURE_MISSING"),
59
+ UCM_SIGNATURE_ALG_UNSUPPORTED: entry("signature", "Proof signature algorithm is unsupported.", "UCM_SIGNATURE_ALG_UNSUPPORTED"),
60
+ UCM_SIGNATURE_UNKNOWN_KEY_ID: entry("signature", "Proof signature references an unknown key id.", "UCM_SIGNATURE_UNKNOWN_KEY_ID"),
61
+ UCM_SIGNATURE_BAD: entry("signature", "Proof signature is invalid.", "UCM_SIGNATURE_BAD"),
62
+ // --- swift function recognizer (surface: swift) -------------------------
63
+ UCM_SWIFT_NO_PARSER: entry("swift", "No Swift parser is available.", "UCM_SWIFT_NO_PARSER"),
64
+ UCM_SWIFT_PARSE_ERROR: entry("swift", "Swift parse error within the marker region.", "UCM_SWIFT_PARSE_ERROR"),
65
+ UCM_SWIFT_MARKER_NOT_ADJACENT: entry("swift", "Marker is not adjacent to a declaration.", "UCM_SWIFT_MARKER_NOT_ADJACENT"),
66
+ UCM_SWIFT_MARKER_INSIDE_ATTACHED: entry("swift", "Marker is inside an attached declaration.", "UCM_SWIFT_MARKER_INSIDE_ATTACHED"),
67
+ UCM_SWIFT_NEXT_NODE_NOT_FUNC: entry("swift", "The node following the marker is not a function.", "UCM_SWIFT_NEXT_NODE_NOT_FUNC"),
68
+ UCM_SWIFT_FUNC_NO_BODY: entry("swift", "Marked function has no body.", "UCM_SWIFT_FUNC_NO_BODY"),
69
+ UCM_SWIFT_FUNC_NO_CLOSING_BRACE: entry("swift", "Marked function body has no closing brace.", "UCM_SWIFT_FUNC_NO_CLOSING_BRACE"),
70
+ UCM_SWIFT_NESTED_FUNC_UNSUPPORTED: entry("swift", "Nested functions are unsupported in a marked span.", "UCM_SWIFT_NESTED_FUNC_UNSUPPORTED"),
71
+ UCM_SWIFT_CONDITIONAL_COMPILATION: entry("swift", "Conditional compilation directive inside a marked span.", "UCM_SWIFT_CONDITIONAL_COMPILATION"),
72
+ UCM_SWIFT_MARKER_INSIDE_SPAN: entry("swift", "Another marker appears inside a marked span.", "UCM_SWIFT_MARKER_INSIDE_SPAN"),
73
+ UCM_SWIFT_MULTIPLE_CANDIDATES: entry("swift", "Multiple candidate declarations for the marker.", "UCM_SWIFT_MULTIPLE_CANDIDATES"),
74
+ // --- workspace config (surface: workspace) ------------------------------
75
+ UCM_WORKSPACE_COMPONENT_UNKNOWN: entry("workspace", "Unknown component '...'; does not match the declared component.", "UCM_WORKSPACE_COMPONENT_UNKNOWN"),
76
+ UCM_WORKSPACE_CONFIG_PARSE: entry("workspace", "Unable to parse use-cases.yml.", "UCM_WORKSPACE_CONFIG_PARSE"),
77
+ UCM_WORKSPACE_CONFIG_INVALID: entry("workspace", "Invalid use-cases.yml.", "UCM_WORKSPACE_CONFIG_INVALID"),
78
+ // --- path safety (surface: path) ----------------------------------------
79
+ UCM_PATH_ESCAPE: entry("path", "Unsafe relative path escapes its root boundary.", "UCM_PATH_ESCAPE"),
80
+ UCM_INVALID_ID: entry("path", "Identifier is not a canonical id; refusing to use it as a path segment.", "UCM_INVALID_ID"),
81
+ // --- migration test matrix (surface: migration) -------------------------
82
+ UCM_MIGRATION_UNSAFE_SOURCE_PATH: entry("migration", "Migration source path must stay inside the repository.", "UCM_MIGRATION_UNSAFE_SOURCE_PATH"),
83
+ UCM_MIGRATION_UNSAFE_OUTPUT_PATH: entry("migration", "Migration output path must stay inside the data root.", "UCM_MIGRATION_UNSAFE_OUTPUT_PATH"),
84
+ // --- showcase lifecycle (surface: showcase) -----------------------------
85
+ UCM_SHOWCASE_PLAN_UNREADABLE: entry("showcase", "Presentation plan file could not be read.", "UCM_SHOWCASE_PLAN_UNREADABLE"),
86
+ UCM_SHOWCASE_PLAN_PLACEHOLDER_HASH: entry("showcase", "Plan content hash must not be a placeholder.", "UCM_SHOWCASE_PLAN_PLACEHOLDER_HASH"),
87
+ UCM_SHOWCASE_PLAN_HASH_MISMATCH: entry("showcase", "Plan content hash does not match plan body.", "UCM_SHOWCASE_PLAN_HASH_MISMATCH"),
88
+ UCM_SHOWCASE_PLAN_INVALID: entry("showcase", "Presentation plan file is not a v1 plan.", "UCM_SHOWCASE_PLAN_INVALID"),
89
+ UCM_SHOWCASE_USER_APPROVAL_REQUIRED: entry("showcase", "Agent cannot record user-required approval.", "UCM_SHOWCASE_USER_APPROVAL_REQUIRED"),
90
+ UCM_SHOWCASE_TRUSTED_CONFIRMATION_REQUIRED: entry("showcase", "User approval requires a trusted interactive user confirmation path.", "UCM_SHOWCASE_TRUSTED_CONFIRMATION_REQUIRED"),
91
+ UCM_SHOWCASE_FINISH_REQUIRED: entry("showcase", "User approval/rejection requires a finished showcase run.", "UCM_SHOWCASE_FINISH_REQUIRED"),
92
+ UCM_SHOWCASE_KNOWN_GAP_ACK_REQUIRED: entry("showcase", "Partial plan requires known-gap acknowledgement.", "UCM_SHOWCASE_KNOWN_GAP_ACK_REQUIRED"),
93
+ UCM_SHOWCASE_LEDGER_DAMAGED: entry("showcase", "Refusing to append to damaged showcase history.", "UCM_SHOWCASE_LEDGER_DAMAGED"),
94
+ UCM_SHOWCASE_IDEMPOTENCY_CONFLICT: entry("showcase", "Idempotency key was reused with different intent.", "UCM_SHOWCASE_IDEMPOTENCY_CONFLICT"),
95
+ UCM_SHOWCASE_RUN_ID_CONFLICT: entry("showcase", "Showcase run id already exists.", "UCM_SHOWCASE_RUN_ID_CONFLICT"),
96
+ UCM_SHOWCASE_VERDICT_REQUIRES_OBSERVATION: entry("showcase", "Verdict requires a prior observation.", "UCM_SHOWCASE_VERDICT_REQUIRES_OBSERVATION"),
97
+ UCM_SHOWCASE_INVALID_FAILURE_DECISION_TARGET: entry("showcase", "Failure decision target must be a failed or blocked verdict event.", "UCM_SHOWCASE_INVALID_FAILURE_DECISION_TARGET"),
98
+ UCM_SHOWCASE_FAILURE_DECISION_REQUIRED: entry("showcase", "Cannot finish until each failed or blocked verdict has a failure decision.", "UCM_SHOWCASE_FAILURE_DECISION_REQUIRED"),
99
+ UCM_SHOWCASE_INVALID_CORRECTION_TARGET: entry("showcase", "Correction target must be a verdict event.", "UCM_SHOWCASE_INVALID_CORRECTION_TARGET")
100
+ };
101
+ /** The single source-of-truth registry of stable `UCM_*` error codes. */
102
+ export const UCM_ERROR_REGISTRY = Object.freeze(REGISTRY);
103
+ /** Every `UCM_*` code, in stable (sorted) order. */
104
+ export const UCM_ERROR_CODES = Object.freeze(Object.keys(REGISTRY).sort());
105
+ /** Look up a registry entry by its `UCM_*` code. */
106
+ export function getUcmErrorEntry(code) {
107
+ return UCM_ERROR_REGISTRY[code];
108
+ }
109
+ export const LEGACY_ENUM_CODE_MAP = Object.freeze({
110
+ marker: Object.freeze({
111
+ FORBIDDEN_MARKER_PAYLOAD: "UCM_MARKER_FORBIDDEN_PAYLOAD",
112
+ MALFORMED_MARKER: "UCM_MARKER_MALFORMED",
113
+ MALFORMED_END_MARKER: "UCM_MARKER_END_MALFORMED",
114
+ MISMATCHED_END_MARKER: "UCM_MARKER_END_MISMATCHED",
115
+ END_WITHOUT_START: "UCM_MARKER_END_WITHOUT_START",
116
+ UNSUPPORTED_INFERENCE: "UCM_MARKER_UNSUPPORTED_INFERENCE",
117
+ NESTED_SPAN: "UCM_MARKER_NESTED_SPAN",
118
+ DUPLICATE_BINDING_SLUG: "UCM_MARKER_DUPLICATE_BINDING_SLUG"
119
+ }),
120
+ registry: Object.freeze({
121
+ JSON_PARSE_ERROR: "UCM_REGISTRY_JSON_PARSE",
122
+ REGISTRY_SCHEMA_INVALID: "UCM_REGISTRY_SCHEMA_INVALID",
123
+ SLUG_PREFIX_MISMATCH: "UCM_REGISTRY_SLUG_PREFIX_MISMATCH",
124
+ REGISTRY_ROW_MISSING: "UCM_REGISTRY_ROW_MISSING",
125
+ DUPLICATE_REGISTRATION: "UCM_REGISTRY_DUPLICATE_REGISTRATION",
126
+ SLUG_ROW_CONFLICT: "UCM_REGISTRY_SLUG_ROW_CONFLICT"
127
+ }),
128
+ evidence: Object.freeze({
129
+ JSON_PARSE_ERROR: "UCM_EVIDENCE_JSON_PARSE",
130
+ EVIDENCE_SCHEMA_INVALID: "UCM_EVIDENCE_SCHEMA_INVALID",
131
+ SIGNATURE_MISSING: "UCM_SIGNATURE_MISSING",
132
+ SIGNATURE_ALG_UNSUPPORTED: "UCM_SIGNATURE_ALG_UNSUPPORTED",
133
+ UNKNOWN_KEY_ID: "UCM_SIGNATURE_UNKNOWN_KEY_ID",
134
+ BAD_SIGNATURE: "UCM_SIGNATURE_BAD",
135
+ PRODUCER_NOT_TRUSTED: "UCM_EVIDENCE_PRODUCER_NOT_TRUSTED",
136
+ VERIFICATION_NOT_PASS: "UCM_EVIDENCE_VERIFICATION_NOT_PASS",
137
+ BINDING_SET_HASH_MISMATCH: "UCM_EVIDENCE_BINDING_SET_HASH_MISMATCH",
138
+ EVIDENCE_ROW_MISSING: "UCM_EVIDENCE_ROW_MISSING",
139
+ APPEND_ONLY_VIOLATION: "UCM_EVIDENCE_APPEND_ONLY_VIOLATION"
140
+ }),
141
+ swiftFunc: Object.freeze({
142
+ NO_SWIFT_PARSER: "UCM_SWIFT_NO_PARSER",
143
+ SWIFT_PARSE_ERROR_IN_REGION: "UCM_SWIFT_PARSE_ERROR",
144
+ MARKER_NOT_ADJACENT_TO_DECLARATION: "UCM_SWIFT_MARKER_NOT_ADJACENT",
145
+ MARKER_INSIDE_ATTACHED_DECLARATION: "UCM_SWIFT_MARKER_INSIDE_ATTACHED",
146
+ NEXT_NODE_NOT_FUNC: "UCM_SWIFT_NEXT_NODE_NOT_FUNC",
147
+ FUNC_HAS_NO_BODY: "UCM_SWIFT_FUNC_NO_BODY",
148
+ FUNC_BODY_HAS_NO_CLOSING_BRACE: "UCM_SWIFT_FUNC_NO_CLOSING_BRACE",
149
+ NESTED_FUNC_UNSUPPORTED: "UCM_SWIFT_NESTED_FUNC_UNSUPPORTED",
150
+ CONDITIONAL_COMPILATION_IN_SPAN: "UCM_SWIFT_CONDITIONAL_COMPILATION",
151
+ ANOTHER_MARKER_INSIDE_SPAN: "UCM_SWIFT_MARKER_INSIDE_SPAN",
152
+ MULTIPLE_CANDIDATE_DECLARATIONS: "UCM_SWIFT_MULTIPLE_CANDIDATES"
153
+ }),
154
+ signature: Object.freeze({
155
+ SIGNATURE_MISSING: "UCM_SIGNATURE_MISSING",
156
+ SIGNATURE_ALG_UNSUPPORTED: "UCM_SIGNATURE_ALG_UNSUPPORTED",
157
+ UNKNOWN_KEY_ID: "UCM_SIGNATURE_UNKNOWN_KEY_ID",
158
+ BAD_SIGNATURE: "UCM_SIGNATURE_BAD"
159
+ })
160
+ });
161
+ export function mapEnumCode(family, code) {
162
+ const familyMap = LEGACY_ENUM_CODE_MAP[family];
163
+ const mapped = familyMap[code];
164
+ if (!mapped) {
165
+ throw new Error(`No UCM_* code mapped for ${family} code '${code}'.`);
166
+ }
167
+ return mapped;
168
+ }
169
+ /**
170
+ * Map a legacy `UseCasesPluginError` string-literal code to its stable
171
+ * `UCM_*` public code. Returns `undefined` for unmapped/unknown codes.
172
+ */
173
+ export const LEGACY_STRING_CODE_MAP = Object.freeze({
174
+ "component.unknown": "UCM_WORKSPACE_COMPONENT_UNKNOWN",
175
+ "workspace_config.parse_error": "UCM_WORKSPACE_CONFIG_PARSE",
176
+ "workspace_config.schema_error": "UCM_WORKSPACE_CONFIG_INVALID",
177
+ "path.escape": "UCM_PATH_ESCAPE",
178
+ "path.invalid_id": "UCM_INVALID_ID",
179
+ migration_unsafe_source_path: "UCM_MIGRATION_UNSAFE_SOURCE_PATH",
180
+ migration_unsafe_output_path: "UCM_MIGRATION_UNSAFE_OUTPUT_PATH",
181
+ showcase_plan_file_unreadable: "UCM_SHOWCASE_PLAN_UNREADABLE",
182
+ showcase_plan_placeholder_hash: "UCM_SHOWCASE_PLAN_PLACEHOLDER_HASH",
183
+ showcase_plan_hash_mismatch: "UCM_SHOWCASE_PLAN_HASH_MISMATCH",
184
+ showcase_plan_file_invalid: "UCM_SHOWCASE_PLAN_INVALID",
185
+ "showcase.user_required_approval": "UCM_SHOWCASE_USER_APPROVAL_REQUIRED",
186
+ "showcase.trusted_user_confirmation_required": "UCM_SHOWCASE_TRUSTED_CONFIRMATION_REQUIRED",
187
+ "showcase.finish_required_for_approval": "UCM_SHOWCASE_FINISH_REQUIRED",
188
+ evidence_ledger_damaged: "UCM_EVIDENCE_LEDGER_DAMAGED",
189
+ evidence_idempotency_conflict: "UCM_EVIDENCE_IDEMPOTENCY_CONFLICT",
190
+ evidence_invalid_transition: "UCM_EVIDENCE_INVALID_TRANSITION",
191
+ evidence_expected_head_mismatch: "UCM_EVIDENCE_EXPECTED_HEAD_MISMATCH",
192
+ evidence_lock_timeout: "UCM_EVIDENCE_LOCK_TIMEOUT",
193
+ showcase_known_gap_ack_required: "UCM_SHOWCASE_KNOWN_GAP_ACK_REQUIRED",
194
+ showcase_ledger_damaged: "UCM_SHOWCASE_LEDGER_DAMAGED",
195
+ showcase_idempotency_conflict: "UCM_SHOWCASE_IDEMPOTENCY_CONFLICT",
196
+ showcase_run_id_conflict: "UCM_SHOWCASE_RUN_ID_CONFLICT",
197
+ showcase_verdict_requires_observation: "UCM_SHOWCASE_VERDICT_REQUIRES_OBSERVATION",
198
+ showcase_invalid_failure_decision_target: "UCM_SHOWCASE_INVALID_FAILURE_DECISION_TARGET",
199
+ showcase_failure_decision_required: "UCM_SHOWCASE_FAILURE_DECISION_REQUIRED",
200
+ showcase_invalid_correction_target: "UCM_SHOWCASE_INVALID_CORRECTION_TARGET"
201
+ });
202
+ /** Map a legacy string-literal diagnostic code to its `UCM_*` code, if known. */
203
+ export function mapStringCode(code) {
204
+ return LEGACY_STRING_CODE_MAP[code];
205
+ }
206
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/errors/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ /** Render the full `error-codes.md` page (with trailing newline). */
2
+ export declare function renderErrorCodesMarkdown(): string;
3
+ //# sourceMappingURL=render.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/errors/render.ts"],"names":[],"mappings":"AAmCA,qEAAqE;AACrE,wBAAgB,wBAAwB,IAAI,MAAM,CAyCjD"}
@@ -0,0 +1,64 @@
1
+ // Renders the `docs/reference/error-codes.md` reference page from the registry.
2
+ // Internal (not part of the public export surface) — consumed by the doc-sync
3
+ // test and `scripts/generate-error-codes.mjs`.
4
+ import { UCM_ERROR_CODES, UCM_ERROR_REGISTRY } from "./registry.js";
5
+ const SURFACE_TITLES = {
6
+ marker: "Marker grammar",
7
+ registry: "Binding registry",
8
+ evidence: "Evidence ledger",
9
+ signature: "Signature / proof verification",
10
+ swift: "Swift function recognizer",
11
+ workspace: "Workspace config",
12
+ migration: "Migration",
13
+ showcase: "Showcase lifecycle",
14
+ path: "Path safety"
15
+ };
16
+ // Stable surface ordering for the document.
17
+ const SURFACE_ORDER = [
18
+ "marker",
19
+ "registry",
20
+ "evidence",
21
+ "signature",
22
+ "swift",
23
+ "workspace",
24
+ "migration",
25
+ "showcase",
26
+ "path"
27
+ ];
28
+ function escapeCell(value) {
29
+ return value.replace(/\|/g, "\\|");
30
+ }
31
+ /** Render the full `error-codes.md` page (with trailing newline). */
32
+ export function renderErrorCodesMarkdown() {
33
+ const lines = [];
34
+ lines.push("<!-- GENERATED FILE — do not edit by hand.");
35
+ lines.push(" Regenerate with `node packages/core/scripts/generate-error-codes.mjs`");
36
+ lines.push(" (source of truth: packages/core/src/errors/registry.ts). -->");
37
+ lines.push("");
38
+ lines.push("# Error Codes");
39
+ lines.push("");
40
+ lines.push("Stable `UCM_*` error codes are part of the [public API](./stability.md). Each");
41
+ lines.push("code below is a versioned contract: a code is only removed or repurposed in a");
42
+ lines.push("**major** release; new codes ship additively in a **minor**. Diagnostics carry");
43
+ lines.push("the code in their `code` field.");
44
+ lines.push("");
45
+ lines.push(`There are **${UCM_ERROR_CODES.length}** codes across **${SURFACE_ORDER.length}** surfaces.`);
46
+ lines.push("");
47
+ for (const surface of SURFACE_ORDER) {
48
+ const codes = UCM_ERROR_CODES.filter((code) => UCM_ERROR_REGISTRY[code].surface === surface);
49
+ if (codes.length === 0) {
50
+ continue;
51
+ }
52
+ lines.push(`## ${SURFACE_TITLES[surface]}`);
53
+ lines.push("");
54
+ lines.push("| Code | Severity | Message |");
55
+ lines.push("|---|---|---|");
56
+ for (const code of codes) {
57
+ const item = UCM_ERROR_REGISTRY[code];
58
+ lines.push(`| \`${code}\` | ${item.severity} | ${escapeCell(item.message)} |`);
59
+ }
60
+ lines.push("");
61
+ }
62
+ return lines.join("\n");
63
+ }
64
+ //# sourceMappingURL=render.js.map