@ybotok/loam 0.1.0-beta.3 → 0.2.0-alpha.13

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 (1256) hide show
  1. package/CHANGELOG.md +5992 -82
  2. package/COMPARISON.md +168 -63
  3. package/CONTRIBUTING.md +121 -0
  4. package/MIGRATING-from-OpenSpec.md +238 -55
  5. package/QUICKSTART.md +302 -0
  6. package/README.md +653 -144
  7. package/ROADMAP.md +1035 -0
  8. package/SCHEMA.md +3916 -263
  9. package/SECURITY.md +21 -3
  10. package/WORKFLOW.md +927 -0
  11. package/dist/cli.js +133 -21
  12. package/dist/cli.js.map +1 -1
  13. package/dist/commands/adopt/adopt.js +204 -0
  14. package/dist/commands/adopt/adopt.js.map +1 -0
  15. package/dist/commands/adopt/render.js +309 -0
  16. package/dist/commands/adopt/render.js.map +1 -0
  17. package/dist/commands/archive/archive.js +74 -0
  18. package/dist/commands/archive/archive.js.map +1 -0
  19. package/dist/commands/archive/closing.js +42 -0
  20. package/dist/commands/archive/closing.js.map +1 -0
  21. package/dist/commands/archive/plan/contracts/asyncapi.js +172 -0
  22. package/dist/commands/archive/plan/contracts/asyncapi.js.map +1 -0
  23. package/dist/commands/archive/plan/contracts/consumers.js +56 -0
  24. package/dist/commands/archive/plan/contracts/consumers.js.map +1 -0
  25. package/dist/commands/archive/plan/contracts/openapi.js +193 -0
  26. package/dist/commands/archive/plan/contracts/openapi.js.map +1 -0
  27. package/dist/commands/archive/plan/contracts/verdict-lines.js +103 -0
  28. package/dist/commands/archive/plan/contracts/verdict-lines.js.map +1 -0
  29. package/dist/commands/archive/plan/document/head.js +151 -0
  30. package/dist/commands/archive/plan/document/head.js.map +1 -0
  31. package/dist/commands/archive/plan/document/links.js +284 -0
  32. package/dist/commands/archive/plan/document/links.js.map +1 -0
  33. package/dist/commands/archive/plan/document/run.js +136 -0
  34. package/dist/commands/archive/plan/document/run.js.map +1 -0
  35. package/dist/commands/archive/plan/gate.js +319 -0
  36. package/dist/commands/archive/plan/gate.js.map +1 -0
  37. package/dist/commands/archive/plan/landscape.js +298 -0
  38. package/dist/commands/archive/plan/landscape.js.map +1 -0
  39. package/dist/commands/archive/plan/model/extending.js +85 -0
  40. package/dist/commands/archive/plan/model/extending.js.map +1 -0
  41. package/dist/commands/archive/plan/refusal.js +106 -0
  42. package/dist/commands/archive/plan/refusal.js.map +1 -0
  43. package/dist/commands/archive/plan/specs.js +318 -0
  44. package/dist/commands/archive/plan/specs.js.map +1 -0
  45. package/dist/commands/archive/plan/state.js +30 -0
  46. package/dist/commands/archive/plan/state.js.map +1 -0
  47. package/dist/commands/archive/run.js +355 -0
  48. package/dist/commands/archive/run.js.map +1 -0
  49. package/dist/commands/archive/shipped.js +49 -0
  50. package/dist/commands/archive/shipped.js.map +1 -0
  51. package/dist/commands/context/context.js +166 -0
  52. package/dist/commands/context/context.js.map +1 -0
  53. package/dist/commands/context/print.js +305 -0
  54. package/dist/commands/context/print.js.map +1 -0
  55. package/dist/commands/delta/delta.js +367 -0
  56. package/dist/commands/delta/delta.js.map +1 -0
  57. package/dist/commands/delta/print.js +221 -0
  58. package/dist/commands/delta/print.js.map +1 -0
  59. package/dist/commands/dependencies.js +6 -8
  60. package/dist/commands/dependencies.js.map +1 -1
  61. package/dist/commands/diff/diff.js +86 -0
  62. package/dist/commands/diff/diff.js.map +1 -0
  63. package/dist/commands/diff/print.js +38 -0
  64. package/dist/commands/diff/print.js.map +1 -0
  65. package/dist/commands/doctor.js +65 -5
  66. package/dist/commands/doctor.js.map +1 -1
  67. package/dist/commands/explain/explain.js +227 -0
  68. package/dist/commands/explain/explain.js.map +1 -0
  69. package/dist/commands/explore.js +39 -28
  70. package/dist/commands/explore.js.map +1 -1
  71. package/dist/commands/gate/gate.js +152 -0
  72. package/dist/commands/gate/gate.js.map +1 -0
  73. package/dist/commands/gate/print.js +66 -0
  74. package/dist/commands/gate/print.js.map +1 -0
  75. package/dist/commands/gherkin/commit.js +105 -0
  76. package/dist/commands/gherkin/commit.js.map +1 -0
  77. package/dist/commands/gherkin/gherkin.js +262 -0
  78. package/dist/commands/gherkin/gherkin.js.map +1 -0
  79. package/dist/commands/gherkin/reconcile.js +146 -0
  80. package/dist/commands/gherkin/reconcile.js.map +1 -0
  81. package/dist/commands/gherkin/render.js +77 -0
  82. package/dist/commands/gherkin/render.js.map +1 -0
  83. package/dist/commands/init/example.js +204 -0
  84. package/dist/commands/init/example.js.map +1 -0
  85. package/dist/commands/init/first-hour.js +72 -0
  86. package/dist/commands/init/first-hour.js.map +1 -0
  87. package/dist/commands/{init.js → init/init.js} +142 -71
  88. package/dist/commands/init/init.js.map +1 -0
  89. package/dist/commands/init/mcp.js +131 -0
  90. package/dist/commands/init/mcp.js.map +1 -0
  91. package/dist/commands/init/options.js +78 -0
  92. package/dist/commands/init/options.js.map +1 -0
  93. package/dist/commands/instructions.js +72 -14
  94. package/dist/commands/instructions.js.map +1 -1
  95. package/dist/commands/list/campaign/campaign.js +63 -0
  96. package/dist/commands/list/campaign/campaign.js.map +1 -0
  97. package/dist/commands/list/campaign/owners.js +65 -0
  98. package/dist/commands/list/campaign/owners.js.map +1 -0
  99. package/dist/commands/list/json.js +155 -0
  100. package/dist/commands/list/json.js.map +1 -0
  101. package/dist/commands/list/list.js +358 -0
  102. package/dist/commands/list/list.js.map +1 -0
  103. package/dist/commands/list/print.js +344 -0
  104. package/dist/commands/list/print.js.map +1 -0
  105. package/dist/commands/list/review.js +120 -0
  106. package/dist/commands/list/review.js.map +1 -0
  107. package/dist/commands/list/suites/suites.js +140 -0
  108. package/dist/commands/list/suites/suites.js.map +1 -0
  109. package/dist/commands/list/views.js +108 -0
  110. package/dist/commands/list/views.js.map +1 -0
  111. package/dist/commands/mcp/dispatch.js +238 -0
  112. package/dist/commands/mcp/dispatch.js.map +1 -0
  113. package/dist/commands/mcp/mcp.js +75 -0
  114. package/dist/commands/mcp/mcp.js.map +1 -0
  115. package/dist/commands/mcp/serve.js +55 -0
  116. package/dist/commands/mcp/serve.js.map +1 -0
  117. package/dist/commands/migrate-openspec/materialize/active.js +175 -0
  118. package/dist/commands/migrate-openspec/materialize/active.js.map +1 -0
  119. package/dist/commands/migrate-openspec/materialize/feature.js +41 -0
  120. package/dist/commands/migrate-openspec/materialize/feature.js.map +1 -0
  121. package/dist/commands/migrate-openspec/materialize/living.js +62 -0
  122. package/dist/commands/migrate-openspec/materialize/living.js.map +1 -0
  123. package/dist/commands/migrate-openspec/materialize/stage.js +143 -0
  124. package/dist/commands/migrate-openspec/materialize/stage.js.map +1 -0
  125. package/dist/commands/migrate-openspec/materialize/target.js +219 -0
  126. package/dist/commands/migrate-openspec/materialize/target.js.map +1 -0
  127. package/dist/commands/migrate-openspec/migrate-openspec.js +142 -0
  128. package/dist/commands/migrate-openspec/migrate-openspec.js.map +1 -0
  129. package/dist/commands/migrate-openspec/openspec/decisions.js +86 -0
  130. package/dist/commands/migrate-openspec/openspec/decisions.js.map +1 -0
  131. package/dist/commands/migrate-openspec/openspec/error.js +18 -0
  132. package/dist/commands/migrate-openspec/openspec/error.js.map +1 -0
  133. package/dist/commands/migrate-openspec/openspec/mapping.js +162 -0
  134. package/dist/commands/migrate-openspec/openspec/mapping.js.map +1 -0
  135. package/dist/commands/migrate-openspec/openspec/paths.js +40 -0
  136. package/dist/commands/migrate-openspec/openspec/paths.js.map +1 -0
  137. package/dist/commands/migrate-openspec/openspec/read.js +49 -0
  138. package/dist/commands/migrate-openspec/openspec/read.js.map +1 -0
  139. package/dist/commands/migrate-openspec/print.js +89 -0
  140. package/dist/commands/migrate-openspec/print.js.map +1 -0
  141. package/dist/commands/new/capability-template.js +118 -0
  142. package/dist/commands/new/capability-template.js.map +1 -0
  143. package/dist/commands/new/commit.js +62 -0
  144. package/dist/commands/new/commit.js.map +1 -0
  145. package/dist/commands/new/modifies.js +206 -0
  146. package/dist/commands/new/modifies.js.map +1 -0
  147. package/dist/commands/new/new.js +328 -0
  148. package/dist/commands/new/new.js.map +1 -0
  149. package/dist/commands/new/templates.js +279 -0
  150. package/dist/commands/new/templates.js.map +1 -0
  151. package/dist/commands/open.js +199 -0
  152. package/dist/commands/open.js.map +1 -0
  153. package/dist/commands/policy/format.js +152 -0
  154. package/dist/commands/policy/format.js.map +1 -0
  155. package/dist/commands/{docs-repo-gate.js → policy/gate.js} +38 -11
  156. package/dist/commands/policy/gate.js.map +1 -0
  157. package/dist/commands/rebase/edit.js +106 -0
  158. package/dist/commands/rebase/edit.js.map +1 -0
  159. package/dist/commands/rebase/living.js +185 -0
  160. package/dist/commands/rebase/living.js.map +1 -0
  161. package/dist/commands/rebase/plan.js +245 -0
  162. package/dist/commands/rebase/plan.js.map +1 -0
  163. package/dist/commands/rebase/rebase.js +300 -0
  164. package/dist/commands/rebase/rebase.js.map +1 -0
  165. package/dist/commands/seed/commit.js +221 -0
  166. package/dist/commands/seed/commit.js.map +1 -0
  167. package/dist/commands/seed/plan.js +278 -0
  168. package/dist/commands/seed/plan.js.map +1 -0
  169. package/dist/commands/seed/seed.js +174 -0
  170. package/dist/commands/seed/seed.js.map +1 -0
  171. package/dist/commands/show/feature.js +182 -0
  172. package/dist/commands/show/feature.js.map +1 -0
  173. package/dist/commands/show/introduced.js +157 -0
  174. package/dist/commands/show/introduced.js.map +1 -0
  175. package/dist/commands/show/marks.js +53 -0
  176. package/dist/commands/show/marks.js.map +1 -0
  177. package/dist/commands/show/service.js +239 -0
  178. package/dist/commands/show/service.js.map +1 -0
  179. package/dist/commands/show/show.js +87 -0
  180. package/dist/commands/show/show.js.map +1 -0
  181. package/dist/commands/status/fleet-next.js +90 -0
  182. package/dist/commands/status/fleet-next.js.map +1 -0
  183. package/dist/commands/status/json.js +47 -0
  184. package/dist/commands/status/json.js.map +1 -0
  185. package/dist/commands/status/print.js +209 -0
  186. package/dist/commands/status/print.js.map +1 -0
  187. package/dist/commands/status/status.js +115 -0
  188. package/dist/commands/status/status.js.map +1 -0
  189. package/dist/commands/steps/steps.js +269 -0
  190. package/dist/commands/steps/steps.js.map +1 -0
  191. package/dist/commands/subsystem/edit.js +192 -0
  192. package/dist/commands/subsystem/edit.js.map +1 -0
  193. package/dist/commands/subsystem/move.js +325 -0
  194. package/dist/commands/subsystem/move.js.map +1 -0
  195. package/dist/commands/subsystem/query.js +113 -0
  196. package/dist/commands/subsystem/query.js.map +1 -0
  197. package/dist/commands/subsystem/subsystem.js +98 -0
  198. package/dist/commands/subsystem/subsystem.js.map +1 -0
  199. package/dist/commands/subsystem/sync.js +318 -0
  200. package/dist/commands/subsystem/sync.js.map +1 -0
  201. package/dist/commands/subsystem/txn/exclude.js +132 -0
  202. package/dist/commands/subsystem/txn/exclude.js.map +1 -0
  203. package/dist/commands/subsystem/txn/links.js +128 -0
  204. package/dist/commands/subsystem/txn/links.js.map +1 -0
  205. package/dist/commands/subsystem/txn/report.js +174 -0
  206. package/dist/commands/subsystem/txn/report.js.map +1 -0
  207. package/dist/commands/subsystem/txn/txn.js +196 -0
  208. package/dist/commands/subsystem/txn/txn.js.map +1 -0
  209. package/dist/commands/subsystem/txn/views.js +249 -0
  210. package/dist/commands/subsystem/txn/views.js.map +1 -0
  211. package/dist/commands/tasks/actions.js +107 -0
  212. package/dist/commands/tasks/actions.js.map +1 -0
  213. package/dist/commands/tasks/render.js +253 -0
  214. package/dist/commands/tasks/render.js.map +1 -0
  215. package/dist/commands/tasks/tasks.js +119 -0
  216. package/dist/commands/tasks/tasks.js.map +1 -0
  217. package/dist/commands/unarchive/manifest.js +176 -0
  218. package/dist/commands/unarchive/manifest.js.map +1 -0
  219. package/dist/commands/unarchive/restore.js +254 -0
  220. package/dist/commands/unarchive/restore.js.map +1 -0
  221. package/dist/commands/unarchive/unarchive.js +59 -0
  222. package/dist/commands/unarchive/unarchive.js.map +1 -0
  223. package/dist/commands/validate/arch-coverage.js +245 -0
  224. package/dist/commands/validate/arch-coverage.js.map +1 -0
  225. package/dist/commands/validate/checks/fleet-shape.js +204 -0
  226. package/dist/commands/validate/checks/fleet-shape.js.map +1 -0
  227. package/dist/commands/validate/checks/health-deps.js +58 -0
  228. package/dist/commands/validate/checks/health-deps.js.map +1 -0
  229. package/dist/commands/validate/checks/introduced.js +102 -0
  230. package/dist/commands/validate/checks/introduced.js.map +1 -0
  231. package/dist/commands/validate/checks/requirements.js +264 -0
  232. package/dist/commands/validate/checks/requirements.js.map +1 -0
  233. package/dist/commands/validate/checks/sources.js +85 -0
  234. package/dist/commands/validate/checks/sources.js.map +1 -0
  235. package/dist/commands/validate/coverage/covers-after.js +105 -0
  236. package/dist/commands/validate/coverage/covers-after.js.map +1 -0
  237. package/dist/commands/validate/feature.js +222 -0
  238. package/dist/commands/validate/feature.js.map +1 -0
  239. package/dist/commands/validate/fleet/census.js +93 -0
  240. package/dist/commands/validate/fleet/census.js.map +1 -0
  241. package/dist/commands/validate/fleet/kind-tags.js +39 -0
  242. package/dist/commands/validate/fleet/kind-tags.js.map +1 -0
  243. package/dist/commands/validate/fleet/landscape.js +371 -0
  244. package/dist/commands/validate/fleet/landscape.js.map +1 -0
  245. package/dist/commands/validate/fleet/load.js +118 -0
  246. package/dist/commands/validate/fleet/load.js.map +1 -0
  247. package/dist/commands/validate/fleet/map/attest.js +98 -0
  248. package/dist/commands/validate/fleet/map/attest.js.map +1 -0
  249. package/dist/commands/validate/fleet/map/bindings.js +107 -0
  250. package/dist/commands/validate/fleet/map/bindings.js.map +1 -0
  251. package/dist/commands/validate/fleet/map/consumers.js +244 -0
  252. package/dist/commands/validate/fleet/map/consumers.js.map +1 -0
  253. package/dist/commands/validate/fleet/map/isolation.js +116 -0
  254. package/dist/commands/validate/fleet/map/isolation.js.map +1 -0
  255. package/dist/commands/validate/fleet/map/usecases.js +54 -0
  256. package/dist/commands/validate/fleet/map/usecases.js.map +1 -0
  257. package/dist/commands/validate/fleet/obligations.js +266 -0
  258. package/dist/commands/validate/fleet/obligations.js.map +1 -0
  259. package/dist/commands/validate/fleet/scorecard/adoption.js +102 -0
  260. package/dist/commands/validate/fleet/scorecard/adoption.js.map +1 -0
  261. package/dist/commands/validate/fleet/scorecard/contracts.js +98 -0
  262. package/dist/commands/validate/fleet/scorecard/contracts.js.map +1 -0
  263. package/dist/commands/validate/fleet/scorecard/print.js +71 -0
  264. package/dist/commands/validate/fleet/scorecard/print.js.map +1 -0
  265. package/dist/commands/validate/fleet/scorecard/scorecard.js +162 -0
  266. package/dist/commands/validate/fleet/scorecard/scorecard.js.map +1 -0
  267. package/dist/commands/validate/fleet/usecases/place.js +13 -0
  268. package/dist/commands/validate/fleet/usecases/place.js.map +1 -0
  269. package/dist/commands/validate/fleet/views/fleet-project.js +217 -0
  270. package/dist/commands/validate/fleet/views/fleet-project.js.map +1 -0
  271. package/dist/commands/validate/fleet/views/ids.js +75 -0
  272. package/dist/commands/validate/fleet/views/ids.js.map +1 -0
  273. package/dist/commands/validate/fleet/views/projects.js +278 -0
  274. package/dist/commands/validate/fleet/views/projects.js.map +1 -0
  275. package/dist/commands/validate/fleet/views/root-documents.js +83 -0
  276. package/dist/commands/validate/fleet/views/root-documents.js.map +1 -0
  277. package/dist/commands/validate/fleet/views/stale.js +52 -0
  278. package/dist/commands/validate/fleet/views/stale.js.map +1 -0
  279. package/dist/commands/validate/links/corpus.js +89 -0
  280. package/dist/commands/validate/links/corpus.js.map +1 -0
  281. package/dist/commands/validate/links/glossary.js +75 -0
  282. package/dist/commands/validate/links/glossary.js.map +1 -0
  283. package/dist/commands/validate/render/repeats.js +63 -0
  284. package/dist/commands/validate/render/repeats.js.map +1 -0
  285. package/dist/commands/validate/render/rollups.js +115 -0
  286. package/dist/commands/validate/render/rollups.js.map +1 -0
  287. package/dist/commands/validate/render/text.js +199 -0
  288. package/dist/commands/validate/render/text.js.map +1 -0
  289. package/dist/commands/validate/report.js +145 -0
  290. package/dist/commands/validate/report.js.map +1 -0
  291. package/dist/commands/validate/scope.js +113 -0
  292. package/dist/commands/validate/scope.js.map +1 -0
  293. package/dist/commands/validate/service/api.js +252 -0
  294. package/dist/commands/validate/service/api.js.map +1 -0
  295. package/dist/commands/validate/service/contracts/generated.js +134 -0
  296. package/dist/commands/validate/service/contracts/generated.js.map +1 -0
  297. package/dist/commands/validate/service/events/events.js +241 -0
  298. package/dist/commands/validate/service/events/events.js.map +1 -0
  299. package/dist/commands/validate/service/events/message-producers.js +77 -0
  300. package/dist/commands/validate/service/events/message-producers.js.map +1 -0
  301. package/dist/commands/validate/service/evidence-pins.js +177 -0
  302. package/dist/commands/validate/service/evidence-pins.js.map +1 -0
  303. package/dist/commands/validate/service/model/diverged.js +226 -0
  304. package/dist/commands/validate/service/model/diverged.js.map +1 -0
  305. package/dist/commands/validate/service/model/grade.js +163 -0
  306. package/dist/commands/validate/service/model/grade.js.map +1 -0
  307. package/dist/commands/validate/service/service.js +310 -0
  308. package/dist/commands/validate/service/service.js.map +1 -0
  309. package/dist/commands/validate/service/specs.js +279 -0
  310. package/dist/commands/validate/service/specs.js.map +1 -0
  311. package/dist/commands/validate/service/spine.js +148 -0
  312. package/dist/commands/validate/service/spine.js.map +1 -0
  313. package/dist/commands/validate/service/usecases/tags.js +113 -0
  314. package/dist/commands/validate/service/usecases/tags.js.map +1 -0
  315. package/dist/commands/validate/service/usecases/usecases.js +209 -0
  316. package/dist/commands/validate/service/usecases/usecases.js.map +1 -0
  317. package/dist/commands/validate/validate.js +363 -0
  318. package/dist/commands/validate/validate.js.map +1 -0
  319. package/dist/commands/verify/cross/diff.js +178 -0
  320. package/dist/commands/verify/cross/diff.js.map +1 -0
  321. package/dist/commands/verify/evidence/contract.js +32 -0
  322. package/dist/commands/verify/evidence/contract.js.map +1 -0
  323. package/dist/commands/verify/evidence/pins.js +52 -0
  324. package/dist/commands/verify/evidence/pins.js.map +1 -0
  325. package/dist/commands/verify/evidence/read.js +81 -0
  326. package/dist/commands/verify/evidence/read.js.map +1 -0
  327. package/dist/commands/verify/frozen.js +263 -0
  328. package/dist/commands/verify/frozen.js.map +1 -0
  329. package/dist/commands/verify/record.js +278 -0
  330. package/dist/commands/verify/record.js.map +1 -0
  331. package/dist/commands/verify/report.js +206 -0
  332. package/dist/commands/verify/report.js.map +1 -0
  333. package/dist/commands/verify/results.js +328 -0
  334. package/dist/commands/verify/results.js.map +1 -0
  335. package/dist/commands/verify/verify.js +220 -0
  336. package/dist/commands/verify/verify.js.map +1 -0
  337. package/dist/commands/vouch/contract.js +11 -0
  338. package/dist/commands/vouch/contract.js.map +1 -0
  339. package/dist/commands/vouch/pack/contract.js +2 -0
  340. package/dist/commands/vouch/pack/contract.js.map +1 -0
  341. package/dist/commands/vouch/pack/pack.js +266 -0
  342. package/dist/commands/vouch/pack/pack.js.map +1 -0
  343. package/dist/commands/vouch/pack/print.js +266 -0
  344. package/dist/commands/vouch/pack/print.js.map +1 -0
  345. package/dist/commands/vouch/pack/sections.js +141 -0
  346. package/dist/commands/vouch/pack/sections.js.map +1 -0
  347. package/dist/commands/vouch/prompt/confirm.js +46 -0
  348. package/dist/commands/vouch/prompt/confirm.js.map +1 -0
  349. package/dist/commands/vouch/report.js +101 -0
  350. package/dist/commands/vouch/report.js.map +1 -0
  351. package/dist/commands/vouch/run.js +230 -0
  352. package/dist/commands/vouch/run.js.map +1 -0
  353. package/dist/commands/vouch/sample/plan.js +111 -0
  354. package/dist/commands/vouch/sample/plan.js.map +1 -0
  355. package/dist/commands/vouch/sample/print.js +109 -0
  356. package/dist/commands/vouch/sample/print.js.map +1 -0
  357. package/dist/commands/vouch/vet/verify.js +155 -0
  358. package/dist/commands/vouch/vet/verify.js.map +1 -0
  359. package/dist/commands/vouch/vouch.js +169 -0
  360. package/dist/commands/vouch/vouch.js.map +1 -0
  361. package/dist/core/agent/agents-md/command-map.js +299 -0
  362. package/dist/core/agent/agents-md/command-map.js.map +1 -0
  363. package/dist/core/agent/agents-md/map/explain.js +46 -0
  364. package/dist/core/agent/agents-md/map/explain.js.map +1 -0
  365. package/dist/core/agent/agents-md/map/lenses/context.js +50 -0
  366. package/dist/core/agent/agents-md/map/lenses/context.js.map +1 -0
  367. package/dist/core/agent/agents-md/map/lenses/diff.js +59 -0
  368. package/dist/core/agent/agents-md/map/lenses/diff.js.map +1 -0
  369. package/dist/core/agent/agents-md/map/lenses/gate.js +65 -0
  370. package/dist/core/agent/agents-md/map/lenses/gate.js.map +1 -0
  371. package/dist/core/agent/agents-md/map/mcp.js +44 -0
  372. package/dist/core/agent/agents-md/map/mcp.js.map +1 -0
  373. package/dist/core/agent/agents-md/map/status.js +78 -0
  374. package/dist/core/agent/agents-md/map/status.js.map +1 -0
  375. package/dist/core/agent/agents-md/map/subsystem.js +104 -0
  376. package/dist/core/agent/agents-md/map/subsystem.js.map +1 -0
  377. package/dist/core/agent/agents-md/map/usecases.js +138 -0
  378. package/dist/core/agent/agents-md/map/usecases.js.map +1 -0
  379. package/dist/core/agent/agents-md/refusals.js +273 -0
  380. package/dist/core/agent/agents-md/refusals.js.map +1 -0
  381. package/dist/core/agent/agents-md.js +203 -0
  382. package/dist/core/agent/agents-md.js.map +1 -0
  383. package/dist/core/{agents-stamp.js → agent/agents-stamp.js} +60 -0
  384. package/dist/core/agent/agents-stamp.js.map +1 -0
  385. package/dist/core/agent/contract.js +2 -0
  386. package/dist/core/agent/contract.js.map +1 -0
  387. package/dist/core/agent/protocol.js +193 -0
  388. package/dist/core/agent/protocol.js.map +1 -0
  389. package/dist/core/agent/scaffold.js +254 -0
  390. package/dist/core/agent/scaffold.js.map +1 -0
  391. package/dist/core/agent/support/report.js +144 -0
  392. package/dist/core/agent/support/report.js.map +1 -0
  393. package/dist/core/agent/tools/dialects.js +151 -0
  394. package/dist/core/agent/tools/dialects.js.map +1 -0
  395. package/dist/core/agent/tools/registry.js +193 -0
  396. package/dist/core/agent/tools/registry.js.map +1 -0
  397. package/dist/core/agent/workflows/adopt.js +280 -0
  398. package/dist/core/agent/workflows/adopt.js.map +1 -0
  399. package/dist/core/agent/workflows/check.js +373 -0
  400. package/dist/core/agent/workflows/check.js.map +1 -0
  401. package/dist/core/agent/workflows/closing.js +323 -0
  402. package/dist/core/agent/workflows/closing.js.map +1 -0
  403. package/dist/core/agent/workflows/feature.js +220 -0
  404. package/dist/core/agent/workflows/feature.js.map +1 -0
  405. package/dist/core/agent/workflows/implement.js +188 -0
  406. package/dist/core/agent/workflows/implement.js.map +1 -0
  407. package/dist/core/agent/workflows/reference/authoring.js +311 -0
  408. package/dist/core/agent/workflows/reference/authoring.js.map +1 -0
  409. package/dist/core/agent/workflows/reference/codes.js +67 -0
  410. package/dist/core/agent/workflows/reference/codes.js.map +1 -0
  411. package/dist/core/agent/workflows/reference/done-check.js +210 -0
  412. package/dist/core/agent/workflows/reference/done-check.js.map +1 -0
  413. package/dist/core/agent/workflows/reference/drawing/drawing.js +253 -0
  414. package/dist/core/agent/workflows/reference/drawing/drawing.js.map +1 -0
  415. package/dist/core/agent/workflows/reference/reference.js +19 -0
  416. package/dist/core/agent/workflows/reference/reference.js.map +1 -0
  417. package/dist/core/agent/workflows/reference/spine.js +338 -0
  418. package/dist/core/agent/workflows/reference/spine.js.map +1 -0
  419. package/dist/core/asyncapi/baseline/plan.js +43 -0
  420. package/dist/core/asyncapi/baseline/plan.js.map +1 -0
  421. package/dist/core/asyncapi/baseline/surfaces.js +54 -0
  422. package/dist/core/asyncapi/baseline/surfaces.js.map +1 -0
  423. package/dist/core/asyncapi/depth.js +164 -0
  424. package/dist/core/asyncapi/depth.js.map +1 -0
  425. package/dist/core/asyncapi/digest.js +146 -0
  426. package/dist/core/asyncapi/digest.js.map +1 -0
  427. package/dist/core/asyncapi/merge/components.js +92 -0
  428. package/dist/core/asyncapi/merge/components.js.map +1 -0
  429. package/dist/core/asyncapi/merge/error.js +38 -0
  430. package/dist/core/asyncapi/merge/error.js.map +1 -0
  431. package/dist/core/asyncapi/merge/markers.js +290 -0
  432. package/dist/core/asyncapi/merge/markers.js.map +1 -0
  433. package/dist/core/asyncapi/merge/merge.js +195 -0
  434. package/dist/core/asyncapi/merge/merge.js.map +1 -0
  435. package/dist/core/asyncapi/merge/pin.js +83 -0
  436. package/dist/core/asyncapi/merge/pin.js.map +1 -0
  437. package/dist/core/asyncapi/model.js +11 -0
  438. package/dist/core/asyncapi/model.js.map +1 -0
  439. package/dist/core/asyncapi/producers.js +50 -0
  440. package/dist/core/asyncapi/producers.js.map +1 -0
  441. package/dist/core/asyncapi/read.js +263 -0
  442. package/dist/core/asyncapi/read.js.map +1 -0
  443. package/dist/core/brief/brief.js +285 -0
  444. package/dist/core/brief/brief.js.map +1 -0
  445. package/dist/core/brief/checks.js +385 -0
  446. package/dist/core/brief/checks.js.map +1 -0
  447. package/dist/core/brief/landscape.js +273 -0
  448. package/dist/core/brief/landscape.js.map +1 -0
  449. package/dist/core/brief/map/extend.js +84 -0
  450. package/dist/core/brief/map/extend.js.map +1 -0
  451. package/dist/core/brief/map/owed.js +266 -0
  452. package/dist/core/brief/map/owed.js.map +1 -0
  453. package/dist/core/brief/targets.js +304 -0
  454. package/dist/core/brief/targets.js.map +1 -0
  455. package/dist/core/brief/unchecked.js +58 -0
  456. package/dist/core/brief/unchecked.js.map +1 -0
  457. package/dist/core/c4/arch.js +190 -0
  458. package/dist/core/c4/arch.js.map +1 -0
  459. package/dist/core/c4/direction/direction.js +114 -0
  460. package/dist/core/c4/direction/direction.js.map +1 -0
  461. package/dist/core/c4/likec4.js +243 -0
  462. package/dist/core/c4/likec4.js.map +1 -0
  463. package/dist/core/c4/locate/unlocated.js +150 -0
  464. package/dist/core/c4/locate/unlocated.js.map +1 -0
  465. package/dist/core/c4/parsed/deployment.js +160 -0
  466. package/dist/core/c4/parsed/deployment.js.map +1 -0
  467. package/dist/core/c4/parsed/dynamic-views.js +132 -0
  468. package/dist/core/c4/parsed/dynamic-views.js.map +1 -0
  469. package/dist/core/c4/parsed/specification.js +78 -0
  470. package/dist/core/c4/parsed/specification.js.map +1 -0
  471. package/dist/core/c4/parsed/values.js +110 -0
  472. package/dist/core/c4/parsed/values.js.map +1 -0
  473. package/dist/core/c4/parsed/view-ids.js +113 -0
  474. package/dist/core/c4/parsed/view-ids.js.map +1 -0
  475. package/dist/core/c4/prefetch/fleet.js +134 -0
  476. package/dist/core/c4/prefetch/fleet.js.map +1 -0
  477. package/dist/core/c4/project/architecture.js +161 -0
  478. package/dist/core/c4/project/architecture.js.map +1 -0
  479. package/dist/core/c4/project/batch.js +140 -0
  480. package/dist/core/c4/project/batch.js.map +1 -0
  481. package/dist/core/c4/project/documents.js +89 -0
  482. package/dist/core/c4/project/documents.js.map +1 -0
  483. package/dist/core/c4/project/load.js +219 -0
  484. package/dist/core/c4/project/load.js.map +1 -0
  485. package/dist/core/c4/project/staged.js +277 -0
  486. package/dist/core/c4/project/staged.js.map +1 -0
  487. package/dist/core/c4/resolve/attested.js +0 -0
  488. package/dist/core/c4/resolve/attested.js.map +1 -0
  489. package/dist/core/c4/resolve/external.js +51 -0
  490. package/dist/core/c4/resolve/external.js.map +1 -0
  491. package/dist/core/c4/resolve/service.js +174 -0
  492. package/dist/core/c4/resolve/service.js.map +1 -0
  493. package/dist/core/c4/resolve/steps.js +290 -0
  494. package/dist/core/c4/resolve/steps.js.map +1 -0
  495. package/dist/core/c4/resolve/systems.js +154 -0
  496. package/dist/core/c4/resolve/systems.js.map +1 -0
  497. package/dist/core/c4/root-project/exclude.js +352 -0
  498. package/dist/core/c4/root-project/exclude.js.map +1 -0
  499. package/dist/core/c4/seed/fleet-file.js +201 -0
  500. package/dist/core/c4/seed/fleet-file.js.map +1 -0
  501. package/dist/core/c4/seed/items.js +91 -0
  502. package/dist/core/c4/seed/items.js.map +1 -0
  503. package/dist/core/c4/seed/stamp.js +48 -0
  504. package/dist/core/c4/seed/stamp.js.map +1 -0
  505. package/dist/core/c4/seed/template.js +173 -0
  506. package/dist/core/c4/seed/template.js.map +1 -0
  507. package/dist/core/c4/service-model/created/models.js +96 -0
  508. package/dist/core/c4/service-model/created/models.js.map +1 -0
  509. package/dist/core/c4/service-model/documents.js +47 -0
  510. package/dist/core/c4/service-model/documents.js.map +1 -0
  511. package/dist/core/c4/service-model/fleet/extending.js +82 -0
  512. package/dist/core/c4/service-model/fleet/extending.js.map +1 -0
  513. package/dist/core/c4/service-model/load.js +165 -0
  514. package/dist/core/c4/service-model/load.js.map +1 -0
  515. package/dist/core/c4/service-model/renderer.js +128 -0
  516. package/dist/core/c4/service-model/renderer.js.map +1 -0
  517. package/dist/core/c4/service-model/shape.js +106 -0
  518. package/dist/core/c4/service-model/shape.js.map +1 -0
  519. package/dist/core/c4/service-model/slice.js +188 -0
  520. package/dist/core/c4/service-model/slice.js.map +1 -0
  521. package/dist/core/c4/source-mask.js +369 -0
  522. package/dist/core/c4/source-mask.js.map +1 -0
  523. package/dist/core/c4/source-scan.js +308 -0
  524. package/dist/core/c4/source-scan.js.map +1 -0
  525. package/dist/core/c4/splice/authored-source.js +167 -0
  526. package/dist/core/c4/splice/authored-source.js.map +1 -0
  527. package/dist/core/c4/splice/contract.js +30 -0
  528. package/dist/core/c4/splice/contract.js.map +1 -0
  529. package/dist/core/c4/splice/delta-blocks.js +126 -0
  530. package/dist/core/c4/splice/delta-blocks.js.map +1 -0
  531. package/dist/core/c4/splice/identity/declared.js +87 -0
  532. package/dist/core/c4/splice/identity/declared.js.map +1 -0
  533. package/dist/core/c4/splice/identity/edges.js +73 -0
  534. package/dist/core/c4/splice/identity/edges.js.map +1 -0
  535. package/dist/core/c4/splice/identity/existing.js +80 -0
  536. package/dist/core/c4/splice/identity/existing.js.map +1 -0
  537. package/dist/core/c4/splice/identity/interior.js +80 -0
  538. package/dist/core/c4/splice/identity/interior.js.map +1 -0
  539. package/dist/core/c4/splice/identity/owner.js +50 -0
  540. package/dist/core/c4/splice/identity/owner.js.map +1 -0
  541. package/dist/core/c4/splice/landscape-merge.js +337 -0
  542. package/dist/core/c4/splice/landscape-merge.js.map +1 -0
  543. package/dist/core/c4/splice/model/merge.js +151 -0
  544. package/dist/core/c4/splice/model/merge.js.map +1 -0
  545. package/dist/core/c4/splice/placement.js +298 -0
  546. package/dist/core/c4/splice/placement.js.map +1 -0
  547. package/dist/core/c4/splice/text/spot.js +131 -0
  548. package/dist/core/c4/splice/text/spot.js.map +1 -0
  549. package/dist/core/c4/workspace.js +166 -0
  550. package/dist/core/c4/workspace.js.map +1 -0
  551. package/dist/core/capabilities/authoring/notes.js +141 -0
  552. package/dist/core/capabilities/authoring/notes.js.map +1 -0
  553. package/dist/core/capabilities/capabilities.js +124 -0
  554. package/dist/core/capabilities/capabilities.js.map +1 -0
  555. package/dist/core/capabilities/delta/doc.js +47 -0
  556. package/dist/core/capabilities/delta/doc.js.map +1 -0
  557. package/dist/core/capabilities/delta/overlay.js +129 -0
  558. package/dist/core/capabilities/delta/overlay.js.map +1 -0
  559. package/dist/core/capabilities/delta/summary.js +57 -0
  560. package/dist/core/capabilities/delta/summary.js.map +1 -0
  561. package/dist/core/capabilities/delta/tree.js +43 -0
  562. package/dist/core/capabilities/delta/tree.js.map +1 -0
  563. package/dist/core/capabilities/delta/uncovered.js +222 -0
  564. package/dist/core/capabilities/delta/uncovered.js.map +1 -0
  565. package/dist/core/capabilities/findings.js +338 -0
  566. package/dist/core/capabilities/findings.js.map +1 -0
  567. package/dist/core/capabilities/realizes/findings.js +174 -0
  568. package/dist/core/capabilities/realizes/findings.js.map +1 -0
  569. package/dist/core/capabilities/realizes/join.js +123 -0
  570. package/dist/core/capabilities/realizes/join.js.map +1 -0
  571. package/dist/core/capabilities/rollup.js +205 -0
  572. package/dist/core/capabilities/rollup.js.map +1 -0
  573. package/dist/core/capabilities/tree.js +104 -0
  574. package/dist/core/capabilities/tree.js.map +1 -0
  575. package/dist/core/capabilities/usecase-join.js +267 -0
  576. package/dist/core/capabilities/usecase-join.js.map +1 -0
  577. package/dist/core/coherence/authoring/scaffold.js +185 -0
  578. package/dist/core/coherence/authoring/scaffold.js.map +1 -0
  579. package/dist/core/coherence/authoring/sentinels.js +75 -0
  580. package/dist/core/coherence/authoring/sentinels.js.map +1 -0
  581. package/dist/core/coherence/calls/called.js +52 -0
  582. package/dist/core/coherence/calls/called.js.map +1 -0
  583. package/dist/core/coherence/coherence.js +332 -0
  584. package/dist/core/coherence/coherence.js.map +1 -0
  585. package/dist/core/coherence/consumed/operations.js +70 -0
  586. package/dist/core/coherence/consumed/operations.js.map +1 -0
  587. package/dist/core/coherence/consumed/refusal.js +38 -0
  588. package/dist/core/coherence/consumed/refusal.js.map +1 -0
  589. package/dist/core/coherence/covers/health.js +85 -0
  590. package/dist/core/coherence/covers/health.js.map +1 -0
  591. package/dist/core/coherence/declared.js +295 -0
  592. package/dist/core/coherence/declared.js.map +1 -0
  593. package/dist/core/coherence/events/declared.js +191 -0
  594. package/dist/core/coherence/events/declared.js.map +1 -0
  595. package/dist/core/coherence/events/events.js +335 -0
  596. package/dist/core/coherence/events/events.js.map +1 -0
  597. package/dist/core/coherence/events/grades.js +189 -0
  598. package/dist/core/coherence/events/grades.js.map +1 -0
  599. package/dist/core/coherence/events/lookups.js +63 -0
  600. package/dist/core/coherence/events/lookups.js.map +1 -0
  601. package/dist/core/coherence/events/produced.js +100 -0
  602. package/dist/core/coherence/events/produced.js.map +1 -0
  603. package/dist/core/coherence/living.js +198 -0
  604. package/dist/core/coherence/living.js.map +1 -0
  605. package/dist/core/coherence/lookups.js +95 -0
  606. package/dist/core/coherence/lookups.js.map +1 -0
  607. package/dist/core/coherence/pending.js +39 -0
  608. package/dist/core/coherence/pending.js.map +1 -0
  609. package/dist/core/coherence/retired/archived.js +285 -0
  610. package/dist/core/coherence/retired/archived.js.map +1 -0
  611. package/dist/core/coherence/retired/event-pair.js +62 -0
  612. package/dist/core/coherence/retired/event-pair.js.map +1 -0
  613. package/dist/core/coherence/retired/merged.js +79 -0
  614. package/dist/core/coherence/retired/merged.js.map +1 -0
  615. package/dist/core/coherence/retired/retirement.js +49 -0
  616. package/dist/core/coherence/retired/retirement.js.map +1 -0
  617. package/dist/core/coherence/retired/revival/arrivals.js +131 -0
  618. package/dist/core/coherence/retired/revival/arrivals.js.map +1 -0
  619. package/dist/core/coherence/retired/revival/revived.js +297 -0
  620. package/dist/core/coherence/retired/revival/revived.js.map +1 -0
  621. package/dist/core/conflict-markers.js +60 -0
  622. package/dist/core/conflict-markers.js.map +1 -0
  623. package/dist/core/consumers/after.js +113 -0
  624. package/dist/core/consumers/after.js.map +1 -0
  625. package/dist/core/consumers/consumers.js +296 -0
  626. package/dist/core/consumers/consumers.js.map +1 -0
  627. package/dist/core/consumers/current.js +211 -0
  628. package/dist/core/consumers/current.js.map +1 -0
  629. package/dist/core/consumers/scan.js +46 -0
  630. package/dist/core/consumers/scan.js.map +1 -0
  631. package/dist/core/consumers/state.js +27 -0
  632. package/dist/core/consumers/state.js.map +1 -0
  633. package/dist/core/delta/claims.js +73 -0
  634. package/dist/core/delta/claims.js.map +1 -0
  635. package/dist/core/delta/delta.js +341 -0
  636. package/dist/core/delta/delta.js.map +1 -0
  637. package/dist/core/delta/document.js +177 -0
  638. package/dist/core/delta/document.js.map +1 -0
  639. package/dist/core/delta/scope.js +48 -0
  640. package/dist/core/delta/scope.js.map +1 -0
  641. package/dist/core/delta/select.js +237 -0
  642. package/dist/core/delta/select.js.map +1 -0
  643. package/dist/core/dependencies/dependencies.js +141 -0
  644. package/dist/core/dependencies/dependencies.js.map +1 -0
  645. package/dist/core/dependencies/facts.js +165 -0
  646. package/dist/core/dependencies/facts.js.map +1 -0
  647. package/dist/core/dependencies/fanin.js +88 -0
  648. package/dist/core/dependencies/fanin.js.map +1 -0
  649. package/dist/core/dependencies/graph.js +106 -0
  650. package/dist/core/dependencies/graph.js.map +1 -0
  651. package/dist/core/deployment/delta.js +191 -0
  652. package/dist/core/deployment/delta.js.map +1 -0
  653. package/dist/core/deployment/objects.js +145 -0
  654. package/dist/core/deployment/objects.js.map +1 -0
  655. package/dist/core/diff/base-git.js +230 -0
  656. package/dist/core/diff/base-git.js.map +1 -0
  657. package/dist/core/diff/base-state.js +237 -0
  658. package/dist/core/diff/base-state.js.map +1 -0
  659. package/dist/core/diff/joins.js +136 -0
  660. package/dist/core/diff/joins.js.map +1 -0
  661. package/dist/core/diff/scope/changed-paths.js +204 -0
  662. package/dist/core/diff/scope/changed-paths.js.map +1 -0
  663. package/dist/core/diff/scope/edges.js +82 -0
  664. package/dist/core/diff/scope/edges.js.map +1 -0
  665. package/dist/core/diff/semantic.js +312 -0
  666. package/dist/core/diff/semantic.js.map +1 -0
  667. package/dist/core/docs.js +37 -85
  668. package/dist/core/docs.js.map +1 -1
  669. package/dist/core/doctor/agents.js +238 -0
  670. package/dist/core/doctor/agents.js.map +1 -0
  671. package/dist/core/doctor/config.js +139 -0
  672. package/dist/core/doctor/config.js.map +1 -0
  673. package/dist/core/doctor/doctor.js +355 -0
  674. package/dist/core/doctor/doctor.js.map +1 -0
  675. package/dist/core/doctor/report.js +13 -0
  676. package/dist/core/doctor/report.js.map +1 -0
  677. package/dist/core/doctor/reports/scan.js +242 -0
  678. package/dist/core/doctor/reports/scan.js.map +1 -0
  679. package/dist/core/doctor/residue.js +110 -0
  680. package/dist/core/doctor/residue.js.map +1 -0
  681. package/dist/core/document/apply.js +224 -0
  682. package/dist/core/document/apply.js.map +1 -0
  683. package/dist/core/{frontmatter.js → document/frontmatter.js} +103 -2
  684. package/dist/core/document/frontmatter.js.map +1 -0
  685. package/dist/core/document/grammar/directives.js +143 -0
  686. package/dist/core/document/grammar/directives.js.map +1 -0
  687. package/dist/core/document/parse.js +286 -0
  688. package/dist/core/document/parse.js.map +1 -0
  689. package/dist/core/document/scenarios.js +238 -0
  690. package/dist/core/document/scenarios.js.map +1 -0
  691. package/dist/core/document/spec.js +234 -0
  692. package/dist/core/document/spec.js.map +1 -0
  693. package/dist/core/{config.js → envelope/config.js} +89 -18
  694. package/dist/core/envelope/config.js.map +1 -0
  695. package/dist/core/envelope/json.js +209 -0
  696. package/dist/core/envelope/json.js.map +1 -0
  697. package/dist/core/{version.js → envelope/version.js} +3 -3
  698. package/dist/core/envelope/version.js.map +1 -0
  699. package/dist/core/explain/families.js +180 -0
  700. package/dist/core/explain/families.js.map +1 -0
  701. package/dist/core/explain/fix-tables.js +178 -0
  702. package/dist/core/explain/fix-tables.js.map +1 -0
  703. package/dist/core/explain/lookup.js +194 -0
  704. package/dist/core/explain/lookup.js.map +1 -0
  705. package/dist/core/explain/refusals.js +49 -0
  706. package/dist/core/explain/refusals.js.map +1 -0
  707. package/dist/core/explain/terms/documents.js +227 -0
  708. package/dist/core/explain/terms/documents.js.map +1 -0
  709. package/dist/core/explain/terms/done-check.js +144 -0
  710. package/dist/core/explain/terms/done-check.js.map +1 -0
  711. package/dist/core/explain/terms/entry.js +14 -0
  712. package/dist/core/explain/terms/entry.js.map +1 -0
  713. package/dist/core/explain/terms/stages.js +71 -0
  714. package/dist/core/explain/terms/stages.js.map +1 -0
  715. package/dist/core/explain/terms/tasks.js +97 -0
  716. package/dist/core/explain/terms/tasks.js.map +1 -0
  717. package/dist/core/explain/terms.js +103 -0
  718. package/dist/core/explain/terms.js.map +1 -0
  719. package/dist/core/explore/describe.js +105 -0
  720. package/dist/core/explore/describe.js.map +1 -0
  721. package/dist/core/explore/explore.js +204 -0
  722. package/dist/core/explore/explore.js.map +1 -0
  723. package/dist/core/fleet-context.js +174 -146
  724. package/dist/core/fleet-context.js.map +1 -1
  725. package/dist/core/gate/checks.js +208 -0
  726. package/dist/core/gate/checks.js.map +1 -0
  727. package/dist/core/gate/partners.js +246 -0
  728. package/dist/core/gate/partners.js.map +1 -0
  729. package/dist/core/gate/report.js +47 -0
  730. package/dist/core/gate/report.js.map +1 -0
  731. package/dist/core/gate/verification.js +176 -0
  732. package/dist/core/gate/verification.js.map +1 -0
  733. package/dist/core/gherkin/digest.js +60 -0
  734. package/dist/core/gherkin/digest.js.map +1 -0
  735. package/dist/core/gherkin/emit.js +177 -0
  736. package/dist/core/gherkin/emit.js.map +1 -0
  737. package/dist/core/gherkin/read.js +76 -0
  738. package/dist/core/gherkin/read.js.map +1 -0
  739. package/dist/core/gherkin/stale.js +210 -0
  740. package/dist/core/gherkin/stale.js.map +1 -0
  741. package/dist/core/gherkin/stamp.js +77 -0
  742. package/dist/core/gherkin/stamp.js.map +1 -0
  743. package/dist/core/gherkin/steps/catalogue.js +154 -0
  744. package/dist/core/gherkin/steps/catalogue.js.map +1 -0
  745. package/dist/core/gherkin/steps/inventory.js +98 -0
  746. package/dist/core/gherkin/steps/inventory.js.map +1 -0
  747. package/dist/core/gherkin/steps/phrase.js +72 -0
  748. package/dist/core/gherkin/steps/phrase.js.map +1 -0
  749. package/dist/core/glossary/delta.js +109 -0
  750. package/dist/core/glossary/delta.js.map +1 -0
  751. package/dist/core/glossary/tree.js +73 -0
  752. package/dist/core/glossary/tree.js.map +1 -0
  753. package/dist/core/{concurrency.js → kernel/concurrency.js} +19 -0
  754. package/dist/core/kernel/concurrency.js.map +1 -0
  755. package/dist/core/{document-bytes.js → kernel/document-bytes.js} +1 -1
  756. package/dist/core/kernel/document-bytes.js.map +1 -0
  757. package/dist/core/kernel/fences.js +42 -0
  758. package/dist/core/kernel/fences.js.map +1 -0
  759. package/dist/core/kernel/ids/capability.js +72 -0
  760. package/dist/core/kernel/ids/capability.js.map +1 -0
  761. package/dist/core/kernel/ids/dirs.js +33 -0
  762. package/dist/core/kernel/ids/dirs.js.map +1 -0
  763. package/dist/core/kernel/ids/feature.js +75 -0
  764. package/dist/core/kernel/ids/feature.js.map +1 -0
  765. package/dist/core/kernel/ids/fqn/ancestors.js +65 -0
  766. package/dist/core/kernel/ids/fqn/ancestors.js.map +1 -0
  767. package/dist/core/kernel/ids/service.js +156 -0
  768. package/dist/core/kernel/ids/service.js.map +1 -0
  769. package/dist/core/kernel/ids/subsystem.js +63 -0
  770. package/dist/core/kernel/ids/subsystem.js.map +1 -0
  771. package/dist/core/{path-safety.js → kernel/path-safety.js} +56 -4
  772. package/dist/core/kernel/path-safety.js.map +1 -0
  773. package/dist/core/{records.js → kernel/records.js} +11 -0
  774. package/dist/core/kernel/records.js.map +1 -0
  775. package/dist/core/links/backlinks.js +66 -0
  776. package/dist/core/links/backlinks.js.map +1 -0
  777. package/dist/core/links/case.js +74 -0
  778. package/dist/core/links/case.js.map +1 -0
  779. package/dist/core/links/corpus.js +118 -0
  780. package/dist/core/links/corpus.js.map +1 -0
  781. package/dist/core/links/findings.js +110 -0
  782. package/dist/core/links/findings.js.map +1 -0
  783. package/dist/core/links/parse.js +265 -0
  784. package/dist/core/links/parse.js.map +1 -0
  785. package/dist/core/mcp/argv.js +212 -0
  786. package/dist/core/mcp/argv.js.map +1 -0
  787. package/dist/core/mcp/author-tools.js +73 -0
  788. package/dist/core/mcp/author-tools.js.map +1 -0
  789. package/dist/core/mcp/framing.js +46 -0
  790. package/dist/core/mcp/framing.js.map +1 -0
  791. package/dist/core/mcp/protocol.js +280 -0
  792. package/dist/core/mcp/protocol.js.map +1 -0
  793. package/dist/core/mcp/tools.js +324 -0
  794. package/dist/core/mcp/tools.js.map +1 -0
  795. package/dist/core/obligations/obligations.js +106 -0
  796. package/dist/core/obligations/obligations.js.map +1 -0
  797. package/dist/core/openapi/baseline/gate.js +207 -0
  798. package/dist/core/openapi/baseline/gate.js.map +1 -0
  799. package/dist/core/openapi/baseline/plan.js +142 -0
  800. package/dist/core/openapi/baseline/plan.js.map +1 -0
  801. package/dist/core/openapi/baseline/record.js +174 -0
  802. package/dist/core/openapi/baseline/record.js.map +1 -0
  803. package/dist/core/openapi/contract-text.js +33 -0
  804. package/dist/core/openapi/contract-text.js.map +1 -0
  805. package/dist/core/openapi/contract-tree.js +301 -0
  806. package/dist/core/openapi/contract-tree.js.map +1 -0
  807. package/dist/core/openapi/depth.js +136 -0
  808. package/dist/core/openapi/depth.js.map +1 -0
  809. package/dist/core/openapi/digest.js +239 -0
  810. package/dist/core/openapi/digest.js.map +1 -0
  811. package/dist/core/{openapi.js → openapi/doc.js} +54 -108
  812. package/dist/core/openapi/doc.js.map +1 -0
  813. package/dist/core/openapi/merge/components.js +199 -0
  814. package/dist/core/openapi/merge/components.js.map +1 -0
  815. package/dist/core/openapi/merge/error.js +16 -0
  816. package/dist/core/openapi/merge/error.js.map +1 -0
  817. package/dist/core/openapi/merge/markers.js +204 -0
  818. package/dist/core/openapi/merge/markers.js.map +1 -0
  819. package/dist/core/openapi/merge/merge.js +232 -0
  820. package/dist/core/openapi/merge/merge.js.map +1 -0
  821. package/dist/core/openapi/merge/pin.js +110 -0
  822. package/dist/core/openapi/merge/pin.js.map +1 -0
  823. package/dist/core/openspec/decide/capabilities.js +244 -0
  824. package/dist/core/openspec/decide/capabilities.js.map +1 -0
  825. package/dist/core/openspec/decide/dispositions.js +63 -0
  826. package/dist/core/openspec/decide/dispositions.js.map +1 -0
  827. package/dist/core/openspec/decide/renames.js +179 -0
  828. package/dist/core/openspec/decide/renames.js.map +1 -0
  829. package/dist/core/openspec/decide/verdict.js +84 -0
  830. package/dist/core/openspec/decide/verdict.js.map +1 -0
  831. package/dist/core/openspec/inventory.js +220 -0
  832. package/dist/core/openspec/inventory.js.map +1 -0
  833. package/dist/core/openspec/model/mapping.js +78 -0
  834. package/dist/core/openspec/model/mapping.js.map +1 -0
  835. package/dist/core/openspec/model/model.js +70 -0
  836. package/dist/core/openspec/model/model.js.map +1 -0
  837. package/dist/core/openspec/scan/changes.js +241 -0
  838. package/dist/core/openspec/scan/changes.js.map +1 -0
  839. package/dist/core/openspec/scan/config.js +191 -0
  840. package/dist/core/openspec/scan/config.js.map +1 -0
  841. package/dist/core/openspec/scan/shape.js +304 -0
  842. package/dist/core/openspec/scan/shape.js.map +1 -0
  843. package/dist/core/openspec/scan/walk.js +116 -0
  844. package/dist/core/openspec/scan/walk.js.map +1 -0
  845. package/dist/core/openspec/scan/workspace.js +71 -0
  846. package/dist/core/openspec/scan/workspace.js.map +1 -0
  847. package/dist/core/owners/codeowners.js +141 -0
  848. package/dist/core/owners/codeowners.js.map +1 -0
  849. package/dist/core/pack/features.js +120 -0
  850. package/dist/core/pack/features.js.map +1 -0
  851. package/dist/core/pack/joins.js +112 -0
  852. package/dist/core/pack/joins.js.map +1 -0
  853. package/dist/core/pack/living.js +157 -0
  854. package/dist/core/pack/living.js.map +1 -0
  855. package/dist/core/pack/pack.js +120 -0
  856. package/dist/core/pack/pack.js.map +1 -0
  857. package/dist/core/permissions/permissions.js +87 -0
  858. package/dist/core/permissions/permissions.js.map +1 -0
  859. package/dist/core/projection/api.js +84 -0
  860. package/dist/core/projection/api.js.map +1 -0
  861. package/dist/core/projection/arch-slice.js +63 -0
  862. package/dist/core/projection/arch-slice.js.map +1 -0
  863. package/dist/core/projection/events.js +34 -0
  864. package/dist/core/projection/events.js.map +1 -0
  865. package/dist/core/projection/introduced.js +14 -0
  866. package/dist/core/projection/introduced.js.map +1 -0
  867. package/dist/core/provenance/findings.js +244 -0
  868. package/dist/core/provenance/findings.js.map +1 -0
  869. package/dist/core/provenance/git.js +201 -0
  870. package/dist/core/provenance/git.js.map +1 -0
  871. package/dist/core/provenance/gitq/moves.js +139 -0
  872. package/dist/core/provenance/gitq/moves.js.map +1 -0
  873. package/dist/core/provenance/gitq/vouched-ancestor.js +179 -0
  874. package/dist/core/provenance/gitq/vouched-ancestor.js.map +1 -0
  875. package/dist/core/provenance/sample/scope.js +238 -0
  876. package/dist/core/provenance/sample/scope.js.map +1 -0
  877. package/dist/core/provenance/sample/sections.js +61 -0
  878. package/dist/core/provenance/sample/sections.js.map +1 -0
  879. package/dist/core/provenance/sources.js +280 -0
  880. package/dist/core/provenance/sources.js.map +1 -0
  881. package/dist/core/provenance/stamp.js +220 -0
  882. package/dist/core/provenance/stamp.js.map +1 -0
  883. package/dist/core/provenance/walk.js +157 -0
  884. package/dist/core/provenance/walk.js.map +1 -0
  885. package/dist/core/repo/authored/paths.js +210 -0
  886. package/dist/core/repo/authored/paths.js.map +1 -0
  887. package/dist/core/repo/entries.js +126 -0
  888. package/dist/core/repo/entries.js.map +1 -0
  889. package/dist/core/repo/paths.js +322 -0
  890. package/dist/core/repo/paths.js.map +1 -0
  891. package/dist/core/repo/repo.js +308 -0
  892. package/dist/core/repo/repo.js.map +1 -0
  893. package/dist/core/repo/service-target.js +153 -0
  894. package/dist/core/repo/service-target.js.map +1 -0
  895. package/dist/core/repo/state.js +58 -0
  896. package/dist/core/repo/state.js.map +1 -0
  897. package/dist/core/repo/tree/find.js +61 -0
  898. package/dist/core/repo/tree/find.js.map +1 -0
  899. package/dist/core/repo/tree/fs.js +90 -0
  900. package/dist/core/repo/tree/fs.js.map +1 -0
  901. package/dist/core/repo/tree/marker.js +61 -0
  902. package/dist/core/repo/tree/marker.js.map +1 -0
  903. package/dist/core/repo/tree/render/body.js +258 -0
  904. package/dist/core/repo/tree/render/body.js.map +1 -0
  905. package/dist/core/repo/tree/render/projects.js +182 -0
  906. package/dist/core/repo/tree/render/projects.js.map +1 -0
  907. package/dist/core/repo/tree/render/service/header.js +125 -0
  908. package/dist/core/repo/tree/render/service/header.js.map +1 -0
  909. package/dist/core/repo/tree/render/service/peers.js +28 -0
  910. package/dist/core/repo/tree/render/service/peers.js.map +1 -0
  911. package/dist/core/repo/tree/render/service/view-id.js +67 -0
  912. package/dist/core/repo/tree/render/service/view-id.js.map +1 -0
  913. package/dist/core/repo/tree/render/service/views.js +78 -0
  914. package/dist/core/repo/tree/render/service/views.js.map +1 -0
  915. package/dist/core/repo/tree/render/stale.js +42 -0
  916. package/dist/core/repo/tree/render/stale.js.map +1 -0
  917. package/dist/core/repo/tree/render/text.js +84 -0
  918. package/dist/core/repo/tree/render/text.js.map +1 -0
  919. package/dist/core/repo/tree/render/views.js +293 -0
  920. package/dist/core/repo/tree/render/views.js.map +1 -0
  921. package/dist/core/repo/tree/walk.js +255 -0
  922. package/dist/core/repo/tree/walk.js.map +1 -0
  923. package/dist/core/results.js +146 -14
  924. package/dist/core/results.js.map +1 -1
  925. package/dist/core/scaffold/landscape.js +239 -0
  926. package/dist/core/scaffold/landscape.js.map +1 -0
  927. package/dist/core/scaffold/legacy.js +271 -0
  928. package/dist/core/scaffold/legacy.js.map +1 -0
  929. package/dist/core/scaffold/readme.js +84 -0
  930. package/dist/core/scaffold/readme.js.map +1 -0
  931. package/dist/core/staging/commit.js +252 -0
  932. package/dist/core/staging/commit.js.map +1 -0
  933. package/dist/core/staging/interrupted.js +96 -0
  934. package/dist/core/staging/interrupted.js.map +1 -0
  935. package/dist/core/staging/lock.js +268 -0
  936. package/dist/core/staging/lock.js.map +1 -0
  937. package/dist/core/staging/recovery/finding.js +35 -0
  938. package/dist/core/staging/recovery/finding.js.map +1 -0
  939. package/dist/core/staging/recovery/intent.js +95 -0
  940. package/dist/core/staging/recovery/intent.js.map +1 -0
  941. package/dist/core/staging/recovery/recover.js +204 -0
  942. package/dist/core/staging/recovery/recover.js.map +1 -0
  943. package/dist/core/staging/recovery/residue.js +62 -0
  944. package/dist/core/staging/recovery/residue.js.map +1 -0
  945. package/dist/core/staging/snapshot/manifest.js +188 -0
  946. package/dist/core/staging/snapshot/manifest.js.map +1 -0
  947. package/dist/core/staging/snapshot/snapshot.js +196 -0
  948. package/dist/core/staging/snapshot/snapshot.js.map +1 -0
  949. package/dist/core/staging/txn/forward.js +181 -0
  950. package/dist/core/staging/txn/forward.js.map +1 -0
  951. package/dist/core/staging/txn/journal.js +139 -0
  952. package/dist/core/staging/txn/journal.js.map +1 -0
  953. package/dist/core/staging/txn/transaction.js +75 -0
  954. package/dist/core/staging/txn/transaction.js.map +1 -0
  955. package/dist/core/staging/writes.js +113 -0
  956. package/dist/core/staging/writes.js.map +1 -0
  957. package/dist/core/status/actions/execution.js +60 -0
  958. package/dist/core/status/actions/execution.js.map +1 -0
  959. package/dist/core/status/contracts.js +126 -0
  960. package/dist/core/status/contracts.js.map +1 -0
  961. package/dist/core/status/feature/artifacts.js +196 -0
  962. package/dist/core/status/feature/artifacts.js.map +1 -0
  963. package/dist/core/status/feature/feature.js +214 -0
  964. package/dist/core/status/feature/feature.js.map +1 -0
  965. package/dist/core/status/feature/next.js +163 -0
  966. package/dist/core/status/feature/next.js.map +1 -0
  967. package/dist/core/status/feature/state.js +21 -0
  968. package/dist/core/status/feature/state.js.map +1 -0
  969. package/dist/core/status/feature/words.js +96 -0
  970. package/dist/core/status/feature/words.js.map +1 -0
  971. package/dist/core/status/fleet/fleet.js +216 -0
  972. package/dist/core/status/fleet/fleet.js.map +1 -0
  973. package/dist/core/status/fleet/next.js +302 -0
  974. package/dist/core/status/fleet/next.js.map +1 -0
  975. package/dist/core/status/interrupted.js +97 -0
  976. package/dist/core/status/interrupted.js.map +1 -0
  977. package/dist/core/status/report.js +31 -0
  978. package/dist/core/status/report.js.map +1 -0
  979. package/dist/core/status/scan.js +41 -0
  980. package/dist/core/status/scan.js.map +1 -0
  981. package/dist/core/status/verification.js +216 -0
  982. package/dist/core/status/verification.js.map +1 -0
  983. package/dist/core/tasks/packet.js +199 -0
  984. package/dist/core/tasks/packet.js.map +1 -0
  985. package/dist/core/tasks/record.js +43 -0
  986. package/dist/core/tasks/record.js.map +1 -0
  987. package/dist/core/tasks/sources.js +181 -0
  988. package/dist/core/tasks/sources.js.map +1 -0
  989. package/dist/core/tasks/stamps.js +76 -0
  990. package/dist/core/tasks/stamps.js.map +1 -0
  991. package/dist/core/tasks/unit.js +0 -0
  992. package/dist/core/tasks/unit.js.map +1 -0
  993. package/dist/core/usecases/capability.js +166 -0
  994. package/dist/core/usecases/capability.js.map +1 -0
  995. package/dist/core/usecases/delta/claims.js +140 -0
  996. package/dist/core/usecases/delta/claims.js.map +1 -0
  997. package/dist/core/usecases/delta/flows.js +101 -0
  998. package/dist/core/usecases/delta/flows.js.map +1 -0
  999. package/dist/core/usecases/delta/modified.js +315 -0
  1000. package/dist/core/usecases/delta/modified.js.map +1 -0
  1001. package/dist/core/usecases/delta/overlay.js +76 -0
  1002. package/dist/core/usecases/delta/overlay.js.map +1 -0
  1003. package/dist/core/usecases/fleet.js +296 -0
  1004. package/dist/core/usecases/fleet.js.map +1 -0
  1005. package/dist/core/usecases/grade/capability-tag.js +93 -0
  1006. package/dist/core/usecases/grade/capability-tag.js.map +1 -0
  1007. package/dist/core/usecases/grade/feature.js +88 -0
  1008. package/dist/core/usecases/grade/feature.js.map +1 -0
  1009. package/dist/core/usecases/grade/requirement-tag.js +94 -0
  1010. package/dist/core/usecases/grade/requirement-tag.js.map +1 -0
  1011. package/dist/core/usecases/grade/steps.js +266 -0
  1012. package/dist/core/usecases/grade/steps.js.map +1 -0
  1013. package/dist/core/usecases/grade/usecases.js +112 -0
  1014. package/dist/core/usecases/grade/usecases.js.map +1 -0
  1015. package/dist/core/usecases/operations.js +123 -0
  1016. package/dist/core/usecases/operations.js.map +1 -0
  1017. package/dist/core/usecases/place.js +44 -0
  1018. package/dist/core/usecases/place.js.map +1 -0
  1019. package/dist/core/usecases/service/exclude.js +119 -0
  1020. package/dist/core/usecases/service/exclude.js.map +1 -0
  1021. package/dist/core/usecases/service/flows.js +164 -0
  1022. package/dist/core/usecases/service/flows.js.map +1 -0
  1023. package/dist/core/usecases/suites/participants.js +83 -0
  1024. package/dist/core/usecases/suites/participants.js.map +1 -0
  1025. package/dist/core/usecases/suites/suites.js +45 -0
  1026. package/dist/core/usecases/suites/suites.js.map +1 -0
  1027. package/dist/core/usecases/touch.js +101 -0
  1028. package/dist/core/usecases/touch.js.map +1 -0
  1029. package/dist/core/verify/answers.js +180 -0
  1030. package/dist/core/verify/answers.js.map +1 -0
  1031. package/dist/core/verify/build.js +170 -0
  1032. package/dist/core/verify/build.js.map +1 -0
  1033. package/dist/core/verify/checklist.js +259 -0
  1034. package/dist/core/verify/checklist.js.map +1 -0
  1035. package/dist/core/verify/claims/identity.js +61 -0
  1036. package/dist/core/verify/claims/identity.js.map +1 -0
  1037. package/dist/core/verify/cross/diff.js +97 -0
  1038. package/dist/core/verify/cross/diff.js.map +1 -0
  1039. package/dist/core/verify/evidence/contract.js +169 -0
  1040. package/dist/core/verify/evidence/contract.js.map +1 -0
  1041. package/dist/core/verify/location.js +67 -0
  1042. package/dist/core/verify/location.js.map +1 -0
  1043. package/dist/core/verify/pins/lint.js +158 -0
  1044. package/dist/core/verify/pins/lint.js.map +1 -0
  1045. package/dist/core/verify/pins/pin.js +95 -0
  1046. package/dist/core/verify/pins/pin.js.map +1 -0
  1047. package/dist/core/verify/read/file.js +224 -0
  1048. package/dist/core/verify/read/file.js.map +1 -0
  1049. package/dist/core/verify/read/shape.js +169 -0
  1050. package/dist/core/verify/read/shape.js.map +1 -0
  1051. package/dist/core/verify/read/union.js +105 -0
  1052. package/dist/core/verify/read/union.js.map +1 -0
  1053. package/dist/core/verify/record.js +165 -0
  1054. package/dist/core/verify/record.js.map +1 -0
  1055. package/dist/core/verify/store/commit.js +99 -0
  1056. package/dist/core/verify/store/commit.js.map +1 -0
  1057. package/dist/core/verify/store/render.js +61 -0
  1058. package/dist/core/verify/store/render.js.map +1 -0
  1059. package/dist/core/vocabulary/health.js +91 -0
  1060. package/dist/core/vocabulary/health.js.map +1 -0
  1061. package/dist/core/vocabulary/issue.js +59 -0
  1062. package/dist/core/vocabulary/issue.js.map +1 -0
  1063. package/dist/core/vocabulary/maturity.js +216 -0
  1064. package/dist/core/vocabulary/maturity.js.map +1 -0
  1065. package/dist/core/vocabulary/report.js +90 -0
  1066. package/dist/core/vocabulary/report.js.map +1 -0
  1067. package/dist/core/vocabulary/steps.js +266 -0
  1068. package/dist/core/vocabulary/steps.js.map +1 -0
  1069. package/dist/core/workspace/discover.js +239 -0
  1070. package/dist/core/workspace/discover.js.map +1 -0
  1071. package/dist/core/workspace/render.js +52 -0
  1072. package/dist/core/workspace/render.js.map +1 -0
  1073. package/examples/README.md +232 -0
  1074. package/examples/docs/architecture/adrs/0001-transactional-outbox.md +33 -0
  1075. package/examples/docs/architecture/capabilities.yaml +31 -0
  1076. package/examples/docs/architecture/landscape.likec4 +336 -0
  1077. package/examples/docs/architecture/obligations.yaml +23 -0
  1078. package/examples/docs/architecture/permissions.yaml +50 -0
  1079. package/examples/docs/architecture/services.likec4 +70 -0
  1080. package/examples/docs/architecture/subsystems.likec4 +18 -0
  1081. package/examples/docs/architecture/usecases/order-notification.likec4 +74 -0
  1082. package/examples/docs/capabilities/checkout/spec.md +55 -0
  1083. package/examples/docs/capabilities/identity/tokens/spec.md +42 -0
  1084. package/examples/docs/capabilities/order-notifications/spec.md +43 -0
  1085. package/examples/docs/features/FEAT-101-payment-splitting/adrs/0001-dedicated-split-service.md +18 -0
  1086. package/examples/docs/features/FEAT-101-payment-splitting/delta.likec4 +94 -0
  1087. package/examples/docs/features/FEAT-101-payment-splitting/intent.md +44 -0
  1088. package/examples/docs/features/FEAT-101-payment-splitting/specs/checkout-web/spec.md +21 -0
  1089. package/examples/docs/features/FEAT-101-payment-splitting/specs/payment-service/asyncapi.yaml +132 -0
  1090. package/examples/docs/features/FEAT-101-payment-splitting/specs/payment-service/spec.md +36 -0
  1091. package/examples/docs/features/FEAT-101-payment-splitting/specs/payment-split-service/arch.spec.md +40 -0
  1092. package/examples/docs/features/FEAT-101-payment-splitting/specs/payment-split-service/openapi.yaml +116 -0
  1093. package/examples/docs/features/FEAT-101-payment-splitting/specs/payment-split-service/spec.md +55 -0
  1094. package/examples/docs/features/FEAT-112-retire-order-v1/intent.md +35 -0
  1095. package/examples/docs/features/FEAT-112-retire-order-v1/specs/order-service/openapi.yaml +31 -0
  1096. package/examples/docs/features/FEAT-112-retire-order-v1/specs/order-service/spec.md +17 -0
  1097. package/examples/docs/features/archive/FEAT-088-refunds/.loam-before/files/architecture/landscape.likec4 +253 -0
  1098. package/examples/docs/features/archive/FEAT-088-refunds/.loam-before/files/services/order-service/spec.md +121 -0
  1099. package/examples/docs/features/archive/FEAT-088-refunds/.loam-before/files/services/payment-service/openapi.yaml +111 -0
  1100. package/examples/docs/features/archive/FEAT-088-refunds/.loam-before/files/services/payment-service/spec.md +58 -0
  1101. package/examples/docs/features/archive/FEAT-088-refunds/.loam-before/manifest.json +32 -0
  1102. package/examples/docs/features/archive/FEAT-088-refunds/adrs/0001-refunds-stay-in-payment-service.md +26 -0
  1103. package/examples/docs/features/archive/FEAT-088-refunds/delta.likec4 +28 -0
  1104. package/examples/docs/features/archive/FEAT-088-refunds/intent.md +26 -0
  1105. package/examples/docs/features/archive/FEAT-088-refunds/specs/order-service/spec.md +37 -0
  1106. package/examples/docs/features/archive/FEAT-088-refunds/specs/payment-service/openapi.yaml +73 -0
  1107. package/examples/docs/features/archive/FEAT-088-refunds/specs/payment-service/spec.md +23 -0
  1108. package/examples/docs/features/archive/FEAT-088-refunds/verification.yaml +76 -0
  1109. package/examples/docs/features/archive/FEAT-120-refund-notification/.loam-before/files/architecture/landscape.likec4 +275 -0
  1110. package/examples/docs/features/archive/FEAT-120-refund-notification/.loam-before/files/services/payment-service/asyncapi.yaml +96 -0
  1111. package/examples/docs/features/archive/FEAT-120-refund-notification/.loam-before/files/services/payment-service/spec.md +82 -0
  1112. package/examples/docs/features/archive/FEAT-120-refund-notification/.loam-before/files/services/platform/notification-service/asyncapi.yaml +164 -0
  1113. package/examples/docs/features/archive/FEAT-120-refund-notification/.loam-before/files/services/platform/notification-service/spec.md +91 -0
  1114. package/examples/docs/features/archive/FEAT-120-refund-notification/.loam-before/manifest.json +46 -0
  1115. package/examples/docs/features/archive/FEAT-120-refund-notification/delta.likec4 +36 -0
  1116. package/examples/docs/features/archive/FEAT-120-refund-notification/intent.md +22 -0
  1117. package/examples/docs/features/archive/FEAT-120-refund-notification/scenario-report.json +10 -0
  1118. package/examples/docs/features/archive/FEAT-120-refund-notification/specs/notification-service/asyncapi.yaml +208 -0
  1119. package/examples/docs/features/archive/FEAT-120-refund-notification/specs/notification-service/spec.md +24 -0
  1120. package/examples/docs/features/archive/FEAT-120-refund-notification/specs/payment-service/asyncapi.yaml +137 -0
  1121. package/examples/docs/features/archive/FEAT-120-refund-notification/specs/payment-service/spec.md +31 -0
  1122. package/examples/docs/features/archive/FEAT-120-refund-notification/verification.yaml +84 -0
  1123. package/examples/docs/glossary/order.md +15 -0
  1124. package/examples/docs/glossary/payments/authorization.md +14 -0
  1125. package/examples/docs/likec4.config.json +8 -0
  1126. package/examples/docs/loam.json +3 -0
  1127. package/examples/docs/services/checkout-web/model.likec4 +92 -0
  1128. package/examples/docs/services/checkout-web/spec.md +91 -0
  1129. package/examples/docs/services/checkout-web/ui/pages/checkout.page.yaml +40 -0
  1130. package/examples/docs/services/checkout-web/ui/pages/order-status.page.yaml +24 -0
  1131. package/examples/docs/services/checkout-web/ui/pages/split-payment.page.yaml +26 -0
  1132. package/examples/docs/services/order-service/adrs/0001-orchestrated-order-lifecycle.md +52 -0
  1133. package/examples/docs/services/order-service/arch.spec.md +134 -0
  1134. package/examples/docs/services/order-service/asyncapi.yaml +109 -0
  1135. package/examples/docs/services/order-service/health.yaml +57 -0
  1136. package/examples/docs/services/order-service/model.likec4 +126 -0
  1137. package/examples/docs/services/order-service/openapi.yaml +257 -0
  1138. package/examples/docs/services/order-service/runbook.md +62 -0
  1139. package/examples/docs/services/order-service/spec.md +134 -0
  1140. package/examples/docs/services/payment-service/adrs/0001-payments-outbox.md +18 -0
  1141. package/examples/docs/services/payment-service/adrs/0002-idempotency-keys-on-authorization.md +27 -0
  1142. package/examples/docs/services/payment-service/arch.spec.md +76 -0
  1143. package/examples/docs/services/payment-service/asyncapi.yaml +130 -0
  1144. package/examples/docs/services/payment-service/health.yaml +39 -0
  1145. package/examples/docs/services/payment-service/model.likec4 +68 -0
  1146. package/examples/docs/services/payment-service/openapi.yaml +151 -0
  1147. package/examples/docs/services/payment-service/runbook.md +37 -0
  1148. package/examples/docs/services/payment-service/spec.md +88 -0
  1149. package/examples/docs/services/platform/identity-service/adrs/0001-token-introspection-over-local-validation.md +60 -0
  1150. package/examples/docs/services/platform/identity-service/arch.spec.md +120 -0
  1151. package/examples/docs/services/platform/identity-service/health.yaml +70 -0
  1152. package/examples/docs/services/platform/identity-service/model.likec4 +81 -0
  1153. package/examples/docs/services/platform/identity-service/openapi.yaml +197 -0
  1154. package/examples/docs/services/platform/identity-service/runbook.md +95 -0
  1155. package/examples/docs/services/platform/identity-service/spec.md +119 -0
  1156. package/examples/docs/services/platform/notification-service/asyncapi.yaml +200 -0
  1157. package/examples/docs/services/platform/notification-service/health.yaml +40 -0
  1158. package/examples/docs/services/platform/notification-service/model.likec4 +97 -0
  1159. package/examples/docs/services/platform/notification-service/runbook.md +48 -0
  1160. package/examples/docs/services/platform/notification-service/spec.md +112 -0
  1161. package/examples/docs/services/platform/subsystem.yaml +2 -0
  1162. package/examples/fleet.yaml +57 -0
  1163. package/package.json +19 -6
  1164. package/dist/commands/adopt.js +0 -240
  1165. package/dist/commands/adopt.js.map +0 -1
  1166. package/dist/commands/archive.js +0 -1313
  1167. package/dist/commands/archive.js.map +0 -1
  1168. package/dist/commands/delta.js +0 -388
  1169. package/dist/commands/delta.js.map +0 -1
  1170. package/dist/commands/docs-repo-gate.js.map +0 -1
  1171. package/dist/commands/format.js +0 -17
  1172. package/dist/commands/format.js.map +0 -1
  1173. package/dist/commands/gherkin.js +0 -309
  1174. package/dist/commands/gherkin.js.map +0 -1
  1175. package/dist/commands/init.js.map +0 -1
  1176. package/dist/commands/list.js +0 -295
  1177. package/dist/commands/list.js.map +0 -1
  1178. package/dist/commands/migrate-openspec.js +0 -950
  1179. package/dist/commands/migrate-openspec.js.map +0 -1
  1180. package/dist/commands/new.js +0 -413
  1181. package/dist/commands/new.js.map +0 -1
  1182. package/dist/commands/rebase.js +0 -356
  1183. package/dist/commands/rebase.js.map +0 -1
  1184. package/dist/commands/show.js +0 -320
  1185. package/dist/commands/show.js.map +0 -1
  1186. package/dist/commands/status.js +0 -262
  1187. package/dist/commands/status.js.map +0 -1
  1188. package/dist/commands/unarchive.js +0 -317
  1189. package/dist/commands/unarchive.js.map +0 -1
  1190. package/dist/commands/validate.js +0 -1773
  1191. package/dist/commands/validate.js.map +0 -1
  1192. package/dist/commands/verify.js +0 -775
  1193. package/dist/commands/verify.js.map +0 -1
  1194. package/dist/commands/vouch.js +0 -421
  1195. package/dist/commands/vouch.js.map +0 -1
  1196. package/dist/core/agent.js +0 -2173
  1197. package/dist/core/agent.js.map +0 -1
  1198. package/dist/core/agents-stamp.js.map +0 -1
  1199. package/dist/core/arch.js +0 -130
  1200. package/dist/core/arch.js.map +0 -1
  1201. package/dist/core/asyncapi.js +0 -253
  1202. package/dist/core/asyncapi.js.map +0 -1
  1203. package/dist/core/brief.js +0 -755
  1204. package/dist/core/brief.js.map +0 -1
  1205. package/dist/core/coherence.js +0 -577
  1206. package/dist/core/coherence.js.map +0 -1
  1207. package/dist/core/concurrency.js.map +0 -1
  1208. package/dist/core/config.js.map +0 -1
  1209. package/dist/core/delta.js +0 -476
  1210. package/dist/core/delta.js.map +0 -1
  1211. package/dist/core/dependencies.js +0 -356
  1212. package/dist/core/dependencies.js.map +0 -1
  1213. package/dist/core/doctor.js +0 -596
  1214. package/dist/core/doctor.js.map +0 -1
  1215. package/dist/core/document-bytes.js.map +0 -1
  1216. package/dist/core/explore.js +0 -225
  1217. package/dist/core/explore.js.map +0 -1
  1218. package/dist/core/frontmatter.js.map +0 -1
  1219. package/dist/core/gherkin.js +0 -463
  1220. package/dist/core/gherkin.js.map +0 -1
  1221. package/dist/core/health.js +0 -67
  1222. package/dist/core/health.js.map +0 -1
  1223. package/dist/core/ids.js +0 -122
  1224. package/dist/core/ids.js.map +0 -1
  1225. package/dist/core/issue.js +0 -9
  1226. package/dist/core/issue.js.map +0 -1
  1227. package/dist/core/json.js +0 -74
  1228. package/dist/core/json.js.map +0 -1
  1229. package/dist/core/likec4.js +0 -489
  1230. package/dist/core/likec4.js.map +0 -1
  1231. package/dist/core/maturity.js +0 -66
  1232. package/dist/core/maturity.js.map +0 -1
  1233. package/dist/core/openapi-merge.js +0 -552
  1234. package/dist/core/openapi-merge.js.map +0 -1
  1235. package/dist/core/openapi.js.map +0 -1
  1236. package/dist/core/openspec-inventory.js +0 -1440
  1237. package/dist/core/openspec-inventory.js.map +0 -1
  1238. package/dist/core/path-safety.js.map +0 -1
  1239. package/dist/core/provenance.js +0 -787
  1240. package/dist/core/provenance.js.map +0 -1
  1241. package/dist/core/records.js.map +0 -1
  1242. package/dist/core/repo.js +0 -438
  1243. package/dist/core/repo.js.map +0 -1
  1244. package/dist/core/report.js +0 -47
  1245. package/dist/core/report.js.map +0 -1
  1246. package/dist/core/spec.js +0 -505
  1247. package/dist/core/spec.js.map +0 -1
  1248. package/dist/core/staging.js +0 -890
  1249. package/dist/core/staging.js.map +0 -1
  1250. package/dist/core/status.js +0 -1132
  1251. package/dist/core/status.js.map +0 -1
  1252. package/dist/core/steps.js +0 -72
  1253. package/dist/core/steps.js.map +0 -1
  1254. package/dist/core/verify.js +0 -807
  1255. package/dist/core/verify.js.map +0 -1
  1256. package/dist/core/version.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list/list.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { configOrRefuse, emitJson, fail, repoPath } from \"../../core/envelope/json.js\";\nimport { maturityRollup } from \"../../core/vocabulary/maturity.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport { DocsRepoUnavailableError } from \"../../core/repo/state.js\";\nimport { capabilityRollup, type CapabilityRow } from \"../../core/capabilities/rollup.js\";\nimport { invalidVocabularyFinding } from \"../../core/capabilities/findings.js\";\nimport { promisesKeptByFlows } from \"../../core/usecases/capability.js\";\nimport { fleetAdrCount, listFeatures, listFleetTree, listServices } from \"../../core/repo/repo.js\";\nimport { readGlossary } from \"../../core/glossary/tree.js\";\nimport { backlinkIndex } from \"../../core/links/backlinks.js\";\nimport { glossaryDir } from \"../../core/repo/authored/paths.js\";\nimport { docsRepoReady, reportDocsRepoError, reportRepositoryUnavailable } from \"../policy/gate.js\";\nimport { featureRow, serviceViews, type ServiceView } from \"./views.js\";\nimport { capabilityJson, featureJson, glossaryJson, ownersJson, serviceRows, subsystemsJson } from \"./json.js\";\nimport {\n printCapabilities,\n printFeatures,\n printGlossary,\n printOwners,\n printServices,\n printWorklist,\n} from \"./print.js\";\nimport { fanInByService, reviewLandscape, reviewOrder } from \"./review.js\";\nimport { resolveSubsystemSlice } from \"./campaign/campaign.js\";\nimport { ownersJoin, type OwnersJoin } from \"./campaign/owners.js\";\nimport { suitesSection } from \"./suites/suites.js\";\n\ntype Section = \"services\" | \"features\" | \"capabilities\" | \"glossary\" | \"suites\";\nconst SECTIONS: Section[] = [\"services\", \"features\", \"capabilities\", \"glossary\", \"suites\"];\n/**\n * What a bare `loam list` shows. `capabilities` is explicit-only, NEVER part\n * of this default: the no-argument output and its `--json` payload are a\n * frozen contract, byte-identical whether or not a fleet declares capabilities.\n */\nconst DEFAULT_SECTIONS: Section[] = [\"services\", \"features\"];\n\ninterface ListOptions {\n json?: boolean;\n archived?: boolean;\n needsWork?: boolean;\n reviewOrder?: boolean;\n subsystem?: string;\n owners?: string;\n}\n\nexport function registerList(program: Command): void {\n program\n .command(\"list\")\n .argument(\"[section]\", \"services | features | capabilities | glossary | suites (default: services + features)\")\n .argument(\"[name]\", \"suites only: the one suite to show\")\n .description(\"List the services and features in the docs repo\")\n .option(\"--json\", \"emit the machine contract instead of the human view\")\n .option(\"--archived\", \"include archived features\")\n .option(\n \"--needs-work\",\n \"services only: the adoption worklist — every service below `vouched`, with what it is missing\",\n )\n .option(\n \"--review-order\",\n \"with --needs-work: order the worklist by blast radius — services the most other services depend on first\",\n )\n .option(\n \"--subsystem <name>\",\n \"services only: limit the listing to services filed under this subsystem, at any depth ('unfiled' selects the ones filed under none, while nothing in the tree claims that name)\",\n )\n .option(\n \"--owners <path>\",\n \"services only: group the listing by owning team from this CODEOWNERS file, resolved from the current directory (directory-pattern rules only; unsupported rules are listed as skipped, never guessed)\",\n )\n .action(async (section: string | undefined, name: string | undefined, opts: ListOptions) => {\n const json = opts.json === true;\n // The campaign flags grade services, so — exactly like --needs-work —\n // they narrow a bare `loam list` to the services section instead of\n // printing a features table the filter silently does not apply to.\n const campaign = opts.subsystem !== undefined || opts.owners !== undefined;\n const wanted =\n opts.needsWork || campaign\n ? DEFAULT_SECTIONS.filter((s) => s === \"services\")\n : section\n ? SECTIONS.filter((s) => s === section)\n : DEFAULT_SECTIONS;\n if (section && !SECTIONS.includes(section as Section)) {\n // `invalid-option`, same as show's bad --type: one mistake class, one code.\n fail(json, \"invalid-option\", `Unknown section '${section}'. Expected: ${SECTIONS.join(\" | \")}.`);\n return;\n }\n // Anywhere but suites a name would be silently ignored: refused, as commander's excess-argument error was.\n if (name !== undefined && section !== \"suites\") {\n fail(json, \"invalid-option\", `Only the suites section takes a name; drop '${name}'.`);\n return;\n }\n if (opts.needsWork && (section === \"features\" || section === \"suites\")) {\n fail(json, \"invalid-option\", `--needs-work is the service adoption worklist; drop the '${section}' section.`);\n return;\n }\n if (campaign && section !== undefined && section !== \"services\") {\n fail(json, \"invalid-option\", `--subsystem and --owners grade the services section; drop the '${section}' section.`);\n return;\n }\n // The flag ORDERS the worklist, so it requires the worklist explicitly:\n // silently implying --needs-work would make one flag change which rows\n // exist, not only their order.\n if (opts.reviewOrder && !opts.needsWork) {\n fail(json, \"invalid-option\", \"--review-order sorts the adoption worklist; add --needs-work.\");\n return;\n }\n\n const config = await configOrRefuse(json);\n if (config === null) return;\n const { docsDir } = config;\n // A docsDir that is not a docs repo is refused, never rendered as an empty\n // fleet — the whole point of the gate (see docs-repo-gate.ts).\n // `list features` alone does not need services/, so it asks for less;\n // the capability rollup walks every service's spec files, so it asks for\n // them, and a suite resolves its participants against them.\n const needsServices = wanted.some((s) => s !== \"features\");\n if (!docsRepoReady(json, docsDir, needsServices ? \"services\" : \"docs\")) return;\n\n try {\n // One context, one walk: the tree memo answers both the service\n // entries and the subsystem/unfiled counts beside them.\n const fleet = new FleetContext();\n const tree = wanted.includes(\"services\") ? await listFleetTree(docsDir, fleet) : undefined;\n const services = wanted.includes(\"services\") ? await listServices(docsDir, fleet) : undefined;\n // --review-order parses the landscape ONCE for both of its consumers —\n // serviceViews' `called` set (handed in as `preloaded`) and the fan-in\n // joins below. Without the flag, `undefined` keeps serviceViews' own\n // load-if-exists behaviour and the run byte-identical to today's.\n const land =\n opts.reviewOrder === true && services !== undefined\n ? await reviewLandscape(docsDir, fleet)\n : undefined;\n const views = services ? await serviceViews(docsDir, services, config.service, land) : undefined;\n // The slice is resolved AFTER the full-fleet views, and rows are\n // filtered rather than re-derived: fan-in, apiExpected and the missing\n // lists are fleet facts, and a slice-first derivation would recompute\n // them against a fleet with the callers outside the slice erased. The\n // composition is pinned as filter-first-then-rank — ranks stay\n // contiguous within the filtered set (test/list-campaign.test.ts).\n // `tree !== undefined` is a type NARROWING, not a branch: a campaign\n // flag forces the services section, so the tree always exists here.\n const slice =\n opts.subsystem !== undefined && tree !== undefined\n ? resolveSubsystemSlice(tree, opts.subsystem, json)\n : undefined;\n if (slice === null) return;\n // Membership is by DIRECTORY: leaf ids can collide across a broken\n // tree (`subsystem.name-collision`), and the directory is the row's\n // actual identity — campaign.ts's SubsystemSlice says why.\n const shown = slice === undefined ? views : views?.filter((v) => slice.members.has(v.entry.dir));\n // The fleet's own decision records. Read unconditionally — it is one\n // existsSync over `architecture/adrs/` and it belongs to the docs repo\n // rather than to any section, so `loam list features --json` reports it\n // as truthfully as `loam list services --json` does. Nothing grades it:\n // an absent directory is 0 and 0 is a fine, permanent answer.\n const fleetAdrs = await fleetAdrCount(docsDir);\n const features = wanted.includes(\"features\")\n ? await listFeatures(docsDir, { includeArchived: opts.archived }, fleet)\n : undefined;\n const featureRows = features\n ? await Promise.all(features.map((f) => featureRow(docsDir, f, fleet)))\n : undefined;\n\n // The capability section: the vocabulary's own verdict decides the shape.\n // An INVALID file refuses with `repository-unavailable` — an\n // empty-looking success over a broken file is the silent hole this\n // command already refuses elsewhere — while an ABSENT one is an honest\n // empty answer, because the file is the axis's opt-in. The message is\n // `capability.invalid`'s own sentence, not the fs-error helper's: the\n // file WAS read, it just is not a vocabulary, and one diagnosis should\n // have one spelling wherever it surfaces.\n const capabilityVocab = wanted.includes(\"capabilities\")\n ? await fleet.capabilities(docsDir)\n : undefined;\n const brokenVocab = capabilityVocab === undefined ? null : invalidVocabularyFinding(capabilityVocab);\n if (brokenVocab !== null) {\n fail(json, \"repository-unavailable\", brokenVocab.message);\n return;\n }\n // The SECOND corpus behind a capability's promises: the `#cap-`/`#req-`\n // tagged flows. Read only under `loam list capabilities`, and\n // `promisesKeptByFlows` carries `readUseCases`' byte gate, so a fleet\n // whose architecture/ never mentions the reserved tag prefix pays a\n // readdir here rather than a LikeC4 workspace.\n //\n // AN UNREADABLE architecture/ DEGRADES, it does not refuse — the\n // opposite of the invalid vocabulary above, and the difference is which\n // corpus broke. `architecture/capabilities.yaml` is what the ROWS are\n // built from: unreadable, there is no listing to print, so refusing is\n // the only honest answer. The flows are a second corpus over rows that\n // are already true, and refusing the whole listing because a use-case\n // document has a syntax error would take `loam list capabilities` away\n // during exactly the minutes somebody is fixing that document, while\n // `validate` already reports it as `landscape.invalid`. So the join is\n // withheld instead — every `keptBy` absent rather than `[]` — and the\n // reason is stated, which is `core/pack/joins.ts`' holes idiom: carry\n // what is true, name what could not be looked at, never let the two read\n // the same.\n const entries = capabilityVocab === undefined ? undefined : await listServices(docsDir, fleet);\n const promises =\n capabilityVocab === undefined || entries === undefined\n ? undefined\n : await promisesKeptByFlows({\n docsDir,\n vocab: capabilityVocab,\n known: new Set(entries.map((e) => e.id)),\n read: (p) => fleet.readRequirements(p),\n });\n const capabilities: CapabilityRow[] | undefined =\n capabilityVocab === undefined || entries === undefined\n ? undefined\n : await capabilityRollup({\n services: entries,\n vocab: capabilityVocab,\n read: (p) => fleet.readRequirements(p),\n ...(promises?.kind === \"read\" ? { keptByFlows: promises.kept } : {}),\n });\n\n // The glossary section: the tree, and who cites each term. The\n // citation index is the expensive half — it reads every authored\n // document in the repository — so it is built only when the section is\n // asked for, and not at all when `glossary/` does not exist. The\n // directory's existence is the axis's opt-in, exactly as it is for\n // `capabilities/`, so a fleet without one prints an empty section\n // rather than paying for a fleet-wide walk to say so.\n const glossary = wanted.includes(\"glossary\") ? await readGlossary(glossaryDir(docsDir)) : undefined;\n const citations =\n glossary !== undefined && glossary.terms.length > 0 ? await backlinkIndex(docsDir, fleet) : undefined;\n const terms = glossary?.terms.map((term) => ({\n term,\n linkedBy: citations === undefined ? [] : citations.linkersOf(term.path),\n }));\n // Use cases by `#suite-` tag and what each suite needs up; `null` = already refused.\n const suites = wanted.includes(\"suites\") ? await suitesSection({ docsDir, name, json, fleet }) : undefined;\n if (suites === null) return;\n\n // Every row that still owes something — `missing` is non-empty below\n // `vouched` by construction, and at `vouched` exactly when a stamped\n // document moved under its vouch. The test used to be the rung alone,\n // so a service whose spec was edited after the person read it dropped\n // off the worklist and the footer said \"nothing to do\".\n const worklist = (shown ?? []).filter((v) => v.missing.length > 0);\n // The ranked review queue, derived never stored: fan-in is computed\n // FLEET-WIDE (the joins need every service's slice anyway — and a\n // --subsystem filter must never change a service's count, only which\n // rows appear) while ranks are assigned over the WORKLIST only — a\n // service that owes nothing needs no review, and ranking it would put\n // gaps in the queue. The worklist is already sliced, so under\n // --subsystem the ranks are contiguous within the filtered set.\n let ranked: { queue: ServiceView[]; fanIn: ReadonlyMap<string, number> } | undefined;\n if (opts.reviewOrder === true && services !== undefined) {\n const fanIn = await fanInByService(services, fleet, land ?? null);\n ranked = { queue: reviewOrder(worklist, fanIn), fanIn };\n }\n\n // THE row set of this listing, spelled once: the owners join, the\n // `services[]` payload and the text view must all be about the same\n // rows — `owners.teams[]` is only \"that team's campaign worklist\"\n // while it was computed over the rows `services[]` lists — and three\n // copies of this expression is how they would drift apart.\n const rows = shown === undefined ? undefined : (ranked?.queue ?? (opts.needsWork ? worklist : shown));\n\n let owned: OwnersJoin | undefined;\n if (opts.owners !== undefined && rows !== undefined) {\n const join = await ownersJoin({\n path: opts.owners,\n rows: rows.map((v) => ({ id: v.entry.id, repoDir: repoPath(docsDir, v.entry.dir) })),\n json,\n });\n if (join === null) return;\n owned = join;\n }\n\n if (json) {\n emitJson({\n command: \"list\",\n docsDir,\n // Additive, unconditional and flat, mirroring the per-service\n // `adrs` key one row down rather than inventing a second shape for\n // the same number. Not nested under the services section: the fleet\n // has decision records whether or not this run listed services.\n fleetAdrs,\n ...(rows && shown\n ? {\n services: serviceRows(docsDir, ranked ?? rows),\n // Under --subsystem the dial is the SLICE's — the filter's\n // whole answer — while unfiltered runs keep the full fleet's\n // rollup, byte-identical to before the flag existed.\n maturity: maturityRollup(shown),\n // The tree beside the table — additive keys, wave 3 of the\n // subsystem item: the groups, and how many services sit\n // unfiled (a permanent, normal state, so a count, never a\n // finding). Under --subsystem the rows narrow to the named\n // group and its descendants; memberCount stays transitive\n // because the full tree's services back the modified copy.\n subsystems: subsystemsJson(\n docsDir,\n slice === undefined ? tree! : { ...tree!, subsystems: slice.subsystems },\n ),\n // `unfiledServices` is a fleet-root fact: under a filter it\n // is omitted rather than reported as 0, which would lie.\n ...(slice === undefined\n ? { unfiledServices: tree!.services.filter((s) => s.subsystem.length === 0).length }\n : {}),\n }\n : {}),\n ...(owned !== undefined ? { owners: ownersJson(owned) } : {}),\n ...(featureRows\n ? { features: featureRows.map((row) => featureJson(docsDir, row)) }\n : {}),\n ...(capabilities ? { capabilities: capabilities.map(capabilityJson) } : {}),\n ...(terms ? { glossary: terms.map((t) => glossaryJson(t.term, t.linkedBy, docsDir)) } : {}),\n // What the citation walk could not read, beside the rows it\n // decorates — `useCases` below is the same shape for the same\n // reason. An empty `linkedBy` means loam read every authored\n // document and none cites the term; this key is how a reader tells\n // that from \"one of them would not decode\".\n ...(citations ? { links: { unreadable: citations.unreadable } } : {}),\n ...suites?.payload,\n // The use-case corpus's own health, beside the rows it decorates —\n // `status --json` and `delta --json` already spell this key this\n // way. It is what makes an absent `keptBy` legible: `unreadable:\n // false` with no `keptBy` on a row means the document declares that\n // promise and no flow keeps it, while `unreadable: true` means\n // nobody could look. Emitted only with the capabilities section, so\n // bare `loam list --json` is untouched.\n ...(promises === undefined\n ? {}\n : {\n useCases: {\n unreadable: promises.kind === \"unreadable\",\n ...(promises.kind === \"unreadable\" && promises.errors[0] !== undefined\n ? { error: promises.errors[0] }\n : {}),\n },\n }),\n });\n return;\n }\n\n if (slice !== undefined && shown !== undefined) {\n console.log(`filtered to ${slice.label}: ${shown.length} of ${views!.length} service(s)`);\n }\n if (owned !== undefined && rows !== undefined && shown !== undefined) {\n if (opts.needsWork && rows.length === 0) {\n // printWorklist's own affordance — called rather than respelled —\n // kept under the grouping flag: empty owner groups would answer\n // \"who owns the work\" without saying there is none.\n printWorklist([], shown.length);\n return;\n }\n const kind = opts.needsWork\n ? `${rows.length} of ${shown.length} service(s) need work`\n : `services (${rows.length})`;\n const ordered =\n ranked === undefined ? \"\" : \" — review order (fan-in: services depending on each)\";\n console.log(`${kind} — by owner (${owned.path})${ordered}`);\n printOwners(owned, new Map(rows.map((v) => [repoPath(docsDir, v.entry.dir), v])), ranked?.fanIn);\n return;\n }\n if (opts.needsWork) {\n printWorklist(ranked === undefined ? worklist : ranked.queue, shown!.length, ranked?.fanIn);\n return;\n }\n // Under --subsystem the tree dial (subsystem and unfiled counts) is a\n // fleet-root fact the filtered table must not claim, so no tree. The\n // fleet's ADR count is not derived from the rows at all and stays.\n if (shown) printServices(shown, { tree: slice === undefined ? tree : undefined, adrs: fleetAdrs });\n if (views && features) console.log(\"\");\n if (featureRows) printFeatures(featureRows);\n if (capabilities) {\n if (capabilityVocab!.present) printCapabilities(capabilities, promises!);\n else console.log(\"no architecture/capabilities.yaml — the fleet declares no capabilities\");\n }\n if (terms && glossary) {\n if (glossary.present) {\n printGlossary(\n terms.map((t) => ({ id: t.term.id, linkedBy: t.linkedBy })),\n citations?.unreadable ?? [],\n );\n } else {\n console.log(\"no glossary/ — the fleet defines no domain terms\");\n }\n }\n suites?.print();\n } catch (err) {\n if (err instanceof DocsRepoUnavailableError) {\n reportDocsRepoError(json, err);\n return;\n }\n // One unreadable file used to escape as a stack trace (`internal` in\n // --json), naming nothing. The enumeration is all-or-nothing — it reads\n // every service's frontmatter to build one table — so the honest answer\n // is a refusal that says WHICH path could not be read.\n reportRepositoryUnavailable(json, err, \"the listing would be missing a service\", docsDir);\n }\n });\n}\n\n"]}
@@ -0,0 +1,344 @@
1
+ /**
2
+ * The columns a person reads, and the worklist under them.
3
+ *
4
+ * The worklist is the point of the command rather than a summary: a fleet list
5
+ * that only listed would leave the reader to work out which services are
6
+ * behind, which is the question they opened it with.
7
+ */
8
+ import { MATURITY_LADDER, maturityRollup } from "../../core/vocabulary/maturity.js";
9
+ import {} from "../../core/capabilities/rollup.js";
10
+ import { compareIds } from "../../core/repo/entries.js";
11
+ import { answeredSplit } from "../../core/verify/record.js";
12
+ import {} from "./views.js";
13
+ /**
14
+ * Fixed-width presence flags. `a` and `A` are deliberately the same letter in
15
+ * two cases: the arch spec and the API are the two things a reader most often
16
+ * mistakes for each other, and one is lowercase because it is optional.
17
+ */
18
+ function serviceFlags(v) {
19
+ const s = v.entry;
20
+ return [
21
+ s.has.model ? "M" : "-",
22
+ s.has.spec ? "S" : "-",
23
+ v.archSpec ? "a" : "-",
24
+ s.has.openapi ? "A" : "-",
25
+ // The async contract, lowercase like the arch spec and for the same reason:
26
+ // it is optional. A fleet where most services own no topic must not read as
27
+ // a fleet with a column of gaps in it.
28
+ s.has.asyncapi ? "e" : "-",
29
+ s.has.runbook ? "R" : "-",
30
+ s.has.health ? "H" : "-",
31
+ ].join(" ");
32
+ }
33
+ /**
34
+ * The rung as a person reads it. `vouched (sampled)` is a DISPLAY string, not
35
+ * a rung: the ladder, the rollup below and `--needs-work` all still see
36
+ * `vouched`, because that string is a published contract and the document
37
+ * really is stamped by a person. What the suffix says is what the stamp says
38
+ * — they read a recorded sample of it, and `loam validate` will report
39
+ * `sources.sampled-vouch` until somebody reads the rest. Without it, the one
40
+ * line a fleet lead scans for trust would show a sampled vouch and a full one
41
+ * as the same word.
42
+ *
43
+ * Only on `vouched`: a lower rung already says less than "a person vouched",
44
+ * and hanging a scope note on it would explain a claim nothing is making.
45
+ *
46
+ * `vouched (stale)` is the same kind of string for the other thing a stamp can
47
+ * hide: the document's words moved after the person read them, and `loam
48
+ * validate` reports `content.stale` until somebody re-vouches. Both can hold at
49
+ * once — `vouched (sampled, stale)` — because they are different gaps.
50
+ */
51
+ function rungLabel(v) {
52
+ const qualifiers = vouchQualifiers(v);
53
+ return qualifiers.length === 0 ? v.maturity : `${v.maturity} (${qualifiers.join(", ")})`;
54
+ }
55
+ /** What a `vouched` row's stamp does not cover: a sample, and words moved since. Empty below the rung. */
56
+ function vouchQualifiers(v) {
57
+ if (v.maturity !== "vouched")
58
+ return [];
59
+ return [
60
+ ...(v.entry.vouchScope === "sampled" ? ["sampled"] : []),
61
+ ...(v.entry.contentStale.length > 0 ? ["stale"] : []),
62
+ ];
63
+ }
64
+ export function printServices(views, fleet) {
65
+ console.log(
66
+ // One key per column serviceFlags prints, in its order — the `e` column
67
+ // shipped without one, so the legend explained six of seven.
68
+ `services (${views.length}) [M]odel [S]pec [a]rch-spec [A]pi [e]vents [R]unbook [H]ealth`);
69
+ const width = Math.max(0, ...views.map((v) => v.entry.id.length));
70
+ // Measured over the DISPLAY strings, so the column does not shear the first
71
+ // time a sampled row appears in a fleet.
72
+ const rungWidth = Math.max(0, ...views.map((v) => rungLabel(v).length));
73
+ for (const v of views) {
74
+ const s = v.entry;
75
+ const adrs = s.adrs > 0 ? ` (${s.adrs} adr${s.adrs === 1 ? "" : "s"})` : "";
76
+ // The rung per service, not only in the rollup: "12 partial" tells a reader
77
+ // the fleet is unfinished and nothing about which twelve, which is the one
78
+ // question the line is read to answer.
79
+ console.log(` ${serviceFlags(v)} ${s.id.padEnd(width)} ${rungLabel(v).padEnd(rungWidth)}${adrs}`.trimEnd());
80
+ }
81
+ // How much of the fleet anyone has actually vouched for. On 100+ services this
82
+ // is the number that says whether the docs can be trusted at all.
83
+ if (views.length > 0) {
84
+ const counted = new Map();
85
+ for (const v of views) {
86
+ const key = v.entry.status ?? "unmarked";
87
+ counted.set(key, (counted.get(key) ?? 0) + 1);
88
+ }
89
+ const parts = [...counted.entries()]
90
+ .sort((a, b) => compareIds(a[0], b[0]))
91
+ .map(([status, n]) => `${n} ${status}`);
92
+ console.log(` status: ${parts.join(" · ")}`);
93
+ // The campaign dial next to the trust dial: rungs in ladder order, so the
94
+ // line reads as progress left to right. Presence and provenance state only
95
+ // — completeness is unchecked, so this line never says "adopted".
96
+ const rollup = maturityRollup(views);
97
+ // The rollup itself is untouched — the rung IS `vouched`, and both the
98
+ // `--json` payload and `--needs-work` are computed from it. What the TEXT
99
+ // line adds is the qualifier the per-row suffix already carries, because
100
+ // this is the line a fleet lead reads for the trust answer, and recovering
101
+ // "how many of those 118 did anybody read in full" by scanning 118 rows is
102
+ // not an answer. Same layout as the validate scorecard's provenance row,
103
+ // and the same two qualifiers the per-row suffix carries, each counted.
104
+ const qualified = (q) => views.filter((v) => vouchQualifiers(v).includes(q)).length;
105
+ const notes = ["sampled", "stale"].filter((q) => qualified(q) > 0).map((q) => `${qualified(q)} ${q}`);
106
+ const rungs = MATURITY_LADDER.filter((m) => rollup[m] > 0).map((m) => `${rollup[m]} ${m}${m === "vouched" && notes.length > 0 ? ` (${notes.join(", ")})` : ""}`);
107
+ console.log(` maturity: ${rungs.join(" · ")}`);
108
+ // The tree dial, only once a tree exists: unfiled is permanent and normal
109
+ // (a count, never a finding), and a flat fleet has nothing to say here —
110
+ // printing "5 unfiled" over a fleet nobody groups would read as work.
111
+ if (fleet.tree !== undefined && fleet.tree.subsystems.length > 0) {
112
+ const unfiled = fleet.tree.services.filter((s) => s.subsystem.length === 0).length;
113
+ console.log(` subsystems: ${fleet.tree.subsystems.length} · unfiled: ${unfiled}`);
114
+ }
115
+ }
116
+ // OUTSIDE the rollup block above, which only runs when the fleet has
117
+ // services: a fleet can record a decision about how it will build services
118
+ // before it holds one, and that count would otherwise be printed by nothing.
119
+ // Silent at zero, exactly like the per-service `(3 adrs)` column: no fleet
120
+ // owes any fleet-level ADR, so "adrs: 0" would read as a gap.
121
+ if (fleet.adrs > 0) {
122
+ console.log(` adrs: ${fleet.adrs} fleet decision${fleet.adrs === 1 ? "" : "s"} (architecture/adrs/)`);
123
+ }
124
+ }
125
+ /**
126
+ * The one-shot adoption worklist. Onboarding ten legacy services means asking
127
+ * "what is left" once a day for a month, and the answer used to require reading
128
+ * a presence table and a rollup and joining them by eye. A service whose
129
+ * provenance cannot be judged from here is LISTED, tagged, never dropped:
130
+ * omitting it would read as done.
131
+ */
132
+ export function printWorklist(views, total, fanIn) {
133
+ if (views.length === 0) {
134
+ console.log(`nothing to do — all ${total} service(s) are vouched`);
135
+ return;
136
+ }
137
+ // Under --review-order the caller hands the rows pre-sorted; the header
138
+ // names the derivation as a caller count, never a priority judgement — the
139
+ // number is who depends on the service, not how important it is.
140
+ const ordered = fanIn === undefined ? "" : " — review order (fan-in: services depending on each)";
141
+ console.log(`${views.length} of ${total} service(s) need work${ordered}`);
142
+ const width = Math.max(0, ...views.map((v) => v.entry.id.length));
143
+ const rungWidth = Math.max(0, ...views.map((v) => rungLabel(v).length));
144
+ const cells = fanIn === undefined ? undefined : views.map((v) => `fan-in: ${fanIn.get(v.entry.id) ?? 0}`);
145
+ const cellWidth = cells === undefined ? 0 : Math.max(0, ...cells.map((c) => c.length));
146
+ for (const [i, v] of views.entries()) {
147
+ const note = v.unverifiableFromHere ? " (provenance: unverifiable-from-here)" : "";
148
+ // Indexing the same array the loop walks, like printFeatures' cells below.
149
+ const cell = cells === undefined ? "" : ` ${cells[i].padEnd(cellWidth)}`;
150
+ console.log(` ${v.entry.id.padEnd(width)} ${rungLabel(v).padEnd(rungWidth)}${cell} missing: ${v.missing.join(", ")}${note}`);
151
+ }
152
+ }
153
+ /**
154
+ * The owner-grouped view under `--owners`: every row of the current listing
155
+ * filed under the team CODEOWNERS names for its directory, unowned last —
156
+ * the per-team campaign queues, each in the exact order the ungrouped
157
+ * listing would print. Text side only; the ids-per-team contract is
158
+ * json.ts's `ownersJson`.
159
+ */
160
+ export function printOwners(join, byDir, fanIn) {
161
+ const row = (r) => {
162
+ // Joined back by DIRECTORY, the row's identity — ids can collide across
163
+ // a broken tree, and an id-keyed map would print one twin's cells under
164
+ // the other twin's team. The join was computed from these same rows so a
165
+ // miss is unreachable, but it is a key join on purpose (docs/CODE-STYLE.md:
166
+ // never join two arrays by position) — and a miss prints the bare id
167
+ // LOUDLY rather than vanishing, so a future row-set drift shows itself.
168
+ const v = byDir.get(r.repoDir);
169
+ if (v === undefined) {
170
+ console.log(` ${r.id}`);
171
+ return;
172
+ }
173
+ const cell = fanIn === undefined ? "" : ` fan-in: ${fanIn.get(r.id) ?? 0}`;
174
+ const missing = v.missing.length > 0 ? ` missing: ${v.missing.join(", ")}` : "";
175
+ console.log(` ${r.id} ${rungLabel(v)}${cell}${missing}`);
176
+ };
177
+ for (const team of join.teams) {
178
+ console.log(` ${team.owner} (${team.services.length})`);
179
+ for (const r of team.services)
180
+ row(r);
181
+ }
182
+ // Explicit even in a heading: an unmatched service silently absent from
183
+ // every team's queue would read as somebody else's work.
184
+ if (join.unowned.length > 0) {
185
+ console.log(` unowned (${join.unowned.length})`);
186
+ for (const r of join.unowned)
187
+ row(r);
188
+ }
189
+ if (join.skipped.length > 0) {
190
+ // Line AND pattern: `* @org/all` is the most common CODEOWNERS opener,
191
+ // and a note naming only "line 1" would leave the reader unable to tell
192
+ // the fleet-wide default was skipped rather than some docs rule.
193
+ console.log(` note: ${join.skipped.length} rule(s) outside the supported CODEOWNERS subset skipped: ${join.skipped
194
+ .map((rule) => `line ${rule.line} (${rule.pattern})`)
195
+ .join(", ")}`);
196
+ }
197
+ }
198
+ /**
199
+ * The capability table: what the fleet promises, and how much of each promise
200
+ * anything claims to implement. The `0 — unrealized` marker is the row's whole
201
+ * point — a declared capability nothing realizes is the drift this section
202
+ * exists to make visible — and the draft/verified split says how much of a
203
+ * realized one rests on vouched documents rather than drafts.
204
+ *
205
+ * `promises` is the use-case corpus's health, and it is a REQUIRED argument
206
+ * rather than an optional decoration: the two states it separates are "no flow
207
+ * keeps this promise" and "loam could not read the flows", and a default would
208
+ * silently pick the first. A caller with nothing to say here has no business
209
+ * printing a promises column at all.
210
+ */
211
+ export function printCapabilities(rows, promises) {
212
+ console.log(`capabilities (${rows.length})`);
213
+ if (rows.length === 0)
214
+ return;
215
+ const width = Math.max(0, ...rows.map((row) => row.id.length));
216
+ for (const row of rows) {
217
+ const count = row.realizedBy.length;
218
+ const cells = count === 0
219
+ ? ["0 — unrealized"]
220
+ : [
221
+ `${count} requirement${count === 1 ? "" : "s"}`,
222
+ row.services.join(", "),
223
+ Object.entries(row.statuses)
224
+ .map(([status, n]) => `${n} ${status}`)
225
+ .join(" · "),
226
+ ];
227
+ cells.push(...promiseCells(row, promises.kind === "read"));
228
+ const owner = row.owner === undefined ? "" : ` (owner: ${row.owner})`;
229
+ console.log(` ${row.id.padEnd(width)} ${cells.join(" · ")}${owner}`);
230
+ }
231
+ // ONE note for the table, not one per row: every row is equally unanswered,
232
+ // and the reader needs to be told the column is missing rather than empty.
233
+ // The wording says UNKNOWN rather than none deliberately — this is the same
234
+ // refusal `capability.requirement-unrealized` makes under `validate` when the
235
+ // project did not parse, and the two surfaces must not read differently. The
236
+ // parser's own message goes on its own line, exactly as `loam context` and
237
+ // `loam delta` print theirs: a LikeC4 error is several lines of expected-token
238
+ // list, and inlining it would push the sentence off the reader's screen.
239
+ if (promises.kind === "unreadable") {
240
+ console.log(" note: architecture/ did not parse, so no business flow could be read — " +
241
+ "which promises a use case keeps is UNKNOWN here, not none");
242
+ if (promises.errors[0] !== undefined)
243
+ console.log(` ${promises.errors[0]}`);
244
+ }
245
+ }
246
+ /**
247
+ * The promises cell(s) for one row: how many of a capability document's own
248
+ * requirements anything keeps, and which flows keep any of them.
249
+ *
250
+ * Only for a capability that HAS a document — `requirements` absent means there
251
+ * is no document to promise anything, and a `0 of 0` on such a row would read as
252
+ * a gap where there is not even a claim.
253
+ *
254
+ * `flowsRead` false marks the count as PARTIAL in the cell itself and not only
255
+ * in the note below the table. Without the suffix, a fleet whose promises are
256
+ * all kept by flows prints `0 of 4 promises kept` over an unreadable
257
+ * `architecture/` — a number a reader would act on before reaching the note,
258
+ * and the exact false negative this axis exists to refuse.
259
+ */
260
+ function promiseCells(row, flowsRead) {
261
+ if (row.requirements === undefined)
262
+ return [];
263
+ const total = row.requirements.length;
264
+ if (total === 0)
265
+ return [];
266
+ const kept = row.requirements.filter((req) => req.realizedBy.length > 0 || (req.keptBy?.length ?? 0) > 0).length;
267
+ // Distinct flows across the whole capability, sorted: the per-requirement
268
+ // lists are already sorted, and a reader scanning this column wants the
269
+ // documents to open, not the pairing (the `--json` rows carry that).
270
+ const flows = [...new Set(row.requirements.flatMap((req) => req.keptBy ?? []))].sort(compareIds);
271
+ const partial = flowsRead ? "" : " (flows unread)";
272
+ return [`${kept} of ${total} promise${total === 1 ? "" : "s"} kept${partial}`]
273
+ .concat(flows.length === 0 ? [] : [`flows: ${flows.join(", ")}`]);
274
+ }
275
+ /** Narrow verification cell: confirmed/claims when a record answers, one word when it does not. */
276
+ function verificationMark(v) {
277
+ if (v === null)
278
+ return "-";
279
+ if (v.state === "stale")
280
+ return "stale";
281
+ // `11/11` and `11/11 attested` are different facts — the first is a
282
+ // digest-matched green run, the second is somebody's word about one. Without
283
+ // the suffix a complete count is the same glyph either way, which is exactly
284
+ // the reading `verify`, `status` and the JSON envelope stopped giving.
285
+ //
286
+ // And who answered the confirmed ones, beside it. The verdict turns on the
287
+ // scenario claims alone, so `7/7` under a verified record still read as seven
288
+ // runs where two were an agent's word about a permission or an edge — the
289
+ // split `--json` carried in `answered` and this column did not.
290
+ const split = v.confirmed > 0 ? ` (${answeredSplit(v.answered)})` : "";
291
+ return `${v.confirmed}/${v.claims}${v.verdict === "attested" ? " attested" : ""}${split}`;
292
+ }
293
+ /** How wide the title column may grow before a title is cut with an ellipsis. */
294
+ const TITLE_WIDTH = 40;
295
+ export function printFeatures(rows) {
296
+ const features = rows.map((r) => r.feature);
297
+ const active = features.filter((f) => !f.archived).length;
298
+ const archived = features.length - active;
299
+ const counts = `${active} active${archived > 0 ? `, ${archived} archived` : ""}`;
300
+ // Not `verified`: the column reports three verdicts and only one of them is
301
+ // that one. A heading that names the strong verdict makes every other cell
302
+ // read as it.
303
+ console.log(`features (${counts}) [I]ntent [D]elta verification`);
304
+ const width = Math.max(0, ...features.map((f) => f.id.length));
305
+ // The title beside the id: an id is a key, and a table of keys told a
306
+ // newcomer which rows existed but not which change any of them was.
307
+ const titles = rows.map((r) => {
308
+ const t = r.title ?? "";
309
+ return t.length > TITLE_WIDTH ? `${t.slice(0, TITLE_WIDTH - 1)}…` : t;
310
+ });
311
+ const titleWidth = Math.max(0, ...titles.map((t) => t.length));
312
+ const cells = rows.map((r) => verificationMark(r.cell));
313
+ const cellWidth = Math.max(0, ...cells.map((c) => c.length));
314
+ for (const [i, f] of features.entries()) {
315
+ const flags = `${f.has.intent ? "I" : "-"} ${f.has.delta ? "D" : "-"}`;
316
+ const svcs = f.services.length > 0 ? f.services.join(", ") : "—";
317
+ const tag = f.archived ? " (archived)" : "";
318
+ const title = titleWidth === 0 ? "" : `${titles[i].padEnd(titleWidth)} `;
319
+ console.log(` ${flags} ${f.id.padEnd(width)} ${title}${cells[i].padEnd(cellWidth)} ${svcs}${tag}`);
320
+ }
321
+ }
322
+ /**
323
+ * The glossary table: what the domain's words are, and who actually uses each.
324
+ *
325
+ * The citation count is the column that matters — a definition nothing cites is
326
+ * the drift `glossary.unlinked` warns about, and this is where a reader sees it
327
+ * before the gate does. `unreadable` is printed as a note rather than folded
328
+ * into the counts for `printCapabilities`' reason one section over: "cited by
329
+ * nobody" and "loam could not read everybody" are different answers, and a
330
+ * table that let them look alike would be the more comfortable of the two.
331
+ */
332
+ export function printGlossary(rows, unreadable) {
333
+ console.log(`glossary (${rows.length} term${rows.length === 1 ? "" : "s"})`);
334
+ const width = Math.max(0, ...rows.map((row) => row.id.length));
335
+ for (const row of rows) {
336
+ const n = row.linkedBy.length;
337
+ console.log(` ${row.id.padEnd(width)} ${n === 0 ? "cited by nothing" : `${n} document${n === 1 ? "" : "s"}`}`);
338
+ }
339
+ if (unreadable.length > 0) {
340
+ console.log(` note: ${unreadable.length} document(s) could not be read, so a citation from one of them is not counted here — ` +
341
+ `\`loam validate --all\` names each as link.unreadable`);
342
+ }
343
+ }
344
+ //# sourceMappingURL=print.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/commands/list/print.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The columns a person reads, and the worklist under them.\n *\n * The worklist is the point of the command rather than a summary: a fleet list\n * that only listed would leave the reader to work out which services are\n * behind, which is the question they opened it with.\n */\nimport { MATURITY_LADDER, maturityRollup } from \"../../core/vocabulary/maturity.js\";\nimport { type CapabilityRow } from \"../../core/capabilities/rollup.js\";\nimport { compareIds } from \"../../core/repo/entries.js\";\nimport type { PromisesKept } from \"../../core/usecases/capability.js\";\nimport { answeredSplit } from \"../../core/verify/record.js\";\nimport type { FleetTree } from \"../../core/repo/tree/walk.js\";\nimport type { OwnedRow, OwnersJoin } from \"./campaign/owners.js\";\nimport { type FeatureRow, type ServiceView, type VerificationCell } from \"./views.js\";\n\n/**\n * Fixed-width presence flags. `a` and `A` are deliberately the same letter in\n * two cases: the arch spec and the API are the two things a reader most often\n * mistakes for each other, and one is lowercase because it is optional.\n */\nfunction serviceFlags(v: ServiceView): string {\n const s = v.entry;\n return [\n s.has.model ? \"M\" : \"-\",\n s.has.spec ? \"S\" : \"-\",\n v.archSpec ? \"a\" : \"-\",\n s.has.openapi ? \"A\" : \"-\",\n // The async contract, lowercase like the arch spec and for the same reason:\n // it is optional. A fleet where most services own no topic must not read as\n // a fleet with a column of gaps in it.\n s.has.asyncapi ? \"e\" : \"-\",\n s.has.runbook ? \"R\" : \"-\",\n s.has.health ? \"H\" : \"-\",\n ].join(\" \");\n}\n\n/**\n * The rung as a person reads it. `vouched (sampled)` is a DISPLAY string, not\n * a rung: the ladder, the rollup below and `--needs-work` all still see\n * `vouched`, because that string is a published contract and the document\n * really is stamped by a person. What the suffix says is what the stamp says\n * — they read a recorded sample of it, and `loam validate` will report\n * `sources.sampled-vouch` until somebody reads the rest. Without it, the one\n * line a fleet lead scans for trust would show a sampled vouch and a full one\n * as the same word.\n *\n * Only on `vouched`: a lower rung already says less than \"a person vouched\",\n * and hanging a scope note on it would explain a claim nothing is making.\n *\n * `vouched (stale)` is the same kind of string for the other thing a stamp can\n * hide: the document's words moved after the person read them, and `loam\n * validate` reports `content.stale` until somebody re-vouches. Both can hold at\n * once — `vouched (sampled, stale)` — because they are different gaps.\n */\nfunction rungLabel(v: ServiceView): string {\n const qualifiers = vouchQualifiers(v);\n return qualifiers.length === 0 ? v.maturity : `${v.maturity} (${qualifiers.join(\", \")})`;\n}\n\n/** What a `vouched` row's stamp does not cover: a sample, and words moved since. Empty below the rung. */\nfunction vouchQualifiers(v: ServiceView): string[] {\n if (v.maturity !== \"vouched\") return [];\n return [\n ...(v.entry.vouchScope === \"sampled\" ? [\"sampled\"] : []),\n ...(v.entry.contentStale.length > 0 ? [\"stale\"] : []),\n ];\n}\n\n/**\n * The two facts printed under the table that are not about any row — and they\n * are withheld differently, which is the whole reason to name the record\n * instead of passing two arguments and hoping the next caller notices.\n */\nexport interface FleetFacts {\n /**\n * The subsystem tree, or undefined under `--subsystem`. A slice's own\n * \"unfiled: 0\" would be read as a fact about the slice, and it is not one.\n */\n tree: FleetTree | undefined;\n /**\n * Markdown files in `architecture/adrs/`. NEVER withheld: unlike the tree\n * dial it is not derived from the rows at all — the same fleet documents are\n * there whichever services this run listed — and the line names the directory\n * so it cannot be misread as a subsystem's own decisions. 0 prints nothing.\n */\n adrs: number;\n}\n\nexport function printServices(views: ServiceView[], fleet: FleetFacts): void {\n console.log(\n // One key per column serviceFlags prints, in its order — the `e` column\n // shipped without one, so the legend explained six of seven.\n `services (${views.length}) [M]odel [S]pec [a]rch-spec [A]pi [e]vents [R]unbook [H]ealth`,\n );\n const width = Math.max(0, ...views.map((v) => v.entry.id.length));\n // Measured over the DISPLAY strings, so the column does not shear the first\n // time a sampled row appears in a fleet.\n const rungWidth = Math.max(0, ...views.map((v) => rungLabel(v).length));\n for (const v of views) {\n const s = v.entry;\n const adrs = s.adrs > 0 ? ` (${s.adrs} adr${s.adrs === 1 ? \"\" : \"s\"})` : \"\";\n // The rung per service, not only in the rollup: \"12 partial\" tells a reader\n // the fleet is unfinished and nothing about which twelve, which is the one\n // question the line is read to answer.\n console.log(\n ` ${serviceFlags(v)} ${s.id.padEnd(width)} ${rungLabel(v).padEnd(rungWidth)}${adrs}`.trimEnd(),\n );\n }\n // How much of the fleet anyone has actually vouched for. On 100+ services this\n // is the number that says whether the docs can be trusted at all.\n if (views.length > 0) {\n const counted = new Map<string, number>();\n for (const v of views) {\n const key = v.entry.status ?? \"unmarked\";\n counted.set(key, (counted.get(key) ?? 0) + 1);\n }\n const parts = [...counted.entries()]\n .sort((a, b) => compareIds(a[0], b[0]))\n .map(([status, n]) => `${n} ${status}`);\n console.log(` status: ${parts.join(\" · \")}`);\n // The campaign dial next to the trust dial: rungs in ladder order, so the\n // line reads as progress left to right. Presence and provenance state only\n // — completeness is unchecked, so this line never says \"adopted\".\n const rollup = maturityRollup(views);\n // The rollup itself is untouched — the rung IS `vouched`, and both the\n // `--json` payload and `--needs-work` are computed from it. What the TEXT\n // line adds is the qualifier the per-row suffix already carries, because\n // this is the line a fleet lead reads for the trust answer, and recovering\n // \"how many of those 118 did anybody read in full\" by scanning 118 rows is\n // not an answer. Same layout as the validate scorecard's provenance row,\n // and the same two qualifiers the per-row suffix carries, each counted.\n const qualified = (q: string): number => views.filter((v) => vouchQualifiers(v).includes(q)).length;\n const notes = [\"sampled\", \"stale\"].filter((q) => qualified(q) > 0).map((q) => `${qualified(q)} ${q}`);\n const rungs = MATURITY_LADDER.filter((m) => rollup[m] > 0).map(\n (m) => `${rollup[m]} ${m}${m === \"vouched\" && notes.length > 0 ? ` (${notes.join(\", \")})` : \"\"}`,\n );\n console.log(` maturity: ${rungs.join(\" · \")}`);\n // The tree dial, only once a tree exists: unfiled is permanent and normal\n // (a count, never a finding), and a flat fleet has nothing to say here —\n // printing \"5 unfiled\" over a fleet nobody groups would read as work.\n if (fleet.tree !== undefined && fleet.tree.subsystems.length > 0) {\n const unfiled = fleet.tree.services.filter((s) => s.subsystem.length === 0).length;\n console.log(` subsystems: ${fleet.tree.subsystems.length} · unfiled: ${unfiled}`);\n }\n }\n // OUTSIDE the rollup block above, which only runs when the fleet has\n // services: a fleet can record a decision about how it will build services\n // before it holds one, and that count would otherwise be printed by nothing.\n // Silent at zero, exactly like the per-service `(3 adrs)` column: no fleet\n // owes any fleet-level ADR, so \"adrs: 0\" would read as a gap.\n if (fleet.adrs > 0) {\n console.log(` adrs: ${fleet.adrs} fleet decision${fleet.adrs === 1 ? \"\" : \"s\"} (architecture/adrs/)`);\n }\n}\n\n/**\n * The one-shot adoption worklist. Onboarding ten legacy services means asking\n * \"what is left\" once a day for a month, and the answer used to require reading\n * a presence table and a rollup and joining them by eye. A service whose\n * provenance cannot be judged from here is LISTED, tagged, never dropped:\n * omitting it would read as done.\n */\nexport function printWorklist(\n views: ServiceView[],\n total: number,\n fanIn?: ReadonlyMap<string, number>,\n): void {\n if (views.length === 0) {\n console.log(`nothing to do — all ${total} service(s) are vouched`);\n return;\n }\n // Under --review-order the caller hands the rows pre-sorted; the header\n // names the derivation as a caller count, never a priority judgement — the\n // number is who depends on the service, not how important it is.\n const ordered = fanIn === undefined ? \"\" : \" — review order (fan-in: services depending on each)\";\n console.log(`${views.length} of ${total} service(s) need work${ordered}`);\n const width = Math.max(0, ...views.map((v) => v.entry.id.length));\n const rungWidth = Math.max(0, ...views.map((v) => rungLabel(v).length));\n const cells = fanIn === undefined ? undefined : views.map((v) => `fan-in: ${fanIn.get(v.entry.id) ?? 0}`);\n const cellWidth = cells === undefined ? 0 : Math.max(0, ...cells.map((c) => c.length));\n for (const [i, v] of views.entries()) {\n const note = v.unverifiableFromHere ? \" (provenance: unverifiable-from-here)\" : \"\";\n // Indexing the same array the loop walks, like printFeatures' cells below.\n const cell = cells === undefined ? \"\" : ` ${cells[i]!.padEnd(cellWidth)}`;\n console.log(\n ` ${v.entry.id.padEnd(width)} ${rungLabel(v).padEnd(rungWidth)}${cell} missing: ${v.missing.join(\", \")}${note}`,\n );\n }\n}\n\n/**\n * The owner-grouped view under `--owners`: every row of the current listing\n * filed under the team CODEOWNERS names for its directory, unowned last —\n * the per-team campaign queues, each in the exact order the ungrouped\n * listing would print. Text side only; the ids-per-team contract is\n * json.ts's `ownersJson`.\n */\nexport function printOwners(\n join: OwnersJoin,\n byDir: ReadonlyMap<string, ServiceView>,\n fanIn?: ReadonlyMap<string, number>,\n): void {\n const row = (r: OwnedRow): void => {\n // Joined back by DIRECTORY, the row's identity — ids can collide across\n // a broken tree, and an id-keyed map would print one twin's cells under\n // the other twin's team. The join was computed from these same rows so a\n // miss is unreachable, but it is a key join on purpose (docs/CODE-STYLE.md:\n // never join two arrays by position) — and a miss prints the bare id\n // LOUDLY rather than vanishing, so a future row-set drift shows itself.\n const v = byDir.get(r.repoDir);\n if (v === undefined) {\n console.log(` ${r.id}`);\n return;\n }\n const cell = fanIn === undefined ? \"\" : ` fan-in: ${fanIn.get(r.id) ?? 0}`;\n const missing = v.missing.length > 0 ? ` missing: ${v.missing.join(\", \")}` : \"\";\n console.log(` ${r.id} ${rungLabel(v)}${cell}${missing}`);\n };\n for (const team of join.teams) {\n console.log(` ${team.owner} (${team.services.length})`);\n for (const r of team.services) row(r);\n }\n // Explicit even in a heading: an unmatched service silently absent from\n // every team's queue would read as somebody else's work.\n if (join.unowned.length > 0) {\n console.log(` unowned (${join.unowned.length})`);\n for (const r of join.unowned) row(r);\n }\n if (join.skipped.length > 0) {\n // Line AND pattern: `* @org/all` is the most common CODEOWNERS opener,\n // and a note naming only \"line 1\" would leave the reader unable to tell\n // the fleet-wide default was skipped rather than some docs rule.\n console.log(\n ` note: ${join.skipped.length} rule(s) outside the supported CODEOWNERS subset skipped: ${join.skipped\n .map((rule) => `line ${rule.line} (${rule.pattern})`)\n .join(\", \")}`,\n );\n }\n}\n\n/**\n * The capability table: what the fleet promises, and how much of each promise\n * anything claims to implement. The `0 — unrealized` marker is the row's whole\n * point — a declared capability nothing realizes is the drift this section\n * exists to make visible — and the draft/verified split says how much of a\n * realized one rests on vouched documents rather than drafts.\n *\n * `promises` is the use-case corpus's health, and it is a REQUIRED argument\n * rather than an optional decoration: the two states it separates are \"no flow\n * keeps this promise\" and \"loam could not read the flows\", and a default would\n * silently pick the first. A caller with nothing to say here has no business\n * printing a promises column at all.\n */\nexport function printCapabilities(rows: CapabilityRow[], promises: PromisesKept): void {\n console.log(`capabilities (${rows.length})`);\n if (rows.length === 0) return;\n const width = Math.max(0, ...rows.map((row) => row.id.length));\n for (const row of rows) {\n const count = row.realizedBy.length;\n const cells =\n count === 0\n ? [\"0 — unrealized\"]\n : [\n `${count} requirement${count === 1 ? \"\" : \"s\"}`,\n row.services.join(\", \"),\n Object.entries(row.statuses)\n .map(([status, n]) => `${n} ${status}`)\n .join(\" · \"),\n ];\n cells.push(...promiseCells(row, promises.kind === \"read\"));\n const owner = row.owner === undefined ? \"\" : ` (owner: ${row.owner})`;\n console.log(` ${row.id.padEnd(width)} ${cells.join(\" · \")}${owner}`);\n }\n // ONE note for the table, not one per row: every row is equally unanswered,\n // and the reader needs to be told the column is missing rather than empty.\n // The wording says UNKNOWN rather than none deliberately — this is the same\n // refusal `capability.requirement-unrealized` makes under `validate` when the\n // project did not parse, and the two surfaces must not read differently. The\n // parser's own message goes on its own line, exactly as `loam context` and\n // `loam delta` print theirs: a LikeC4 error is several lines of expected-token\n // list, and inlining it would push the sentence off the reader's screen.\n if (promises.kind === \"unreadable\") {\n console.log(\n \" note: architecture/ did not parse, so no business flow could be read — \" +\n \"which promises a use case keeps is UNKNOWN here, not none\",\n );\n if (promises.errors[0] !== undefined) console.log(` ${promises.errors[0]}`);\n }\n}\n\n/**\n * The promises cell(s) for one row: how many of a capability document's own\n * requirements anything keeps, and which flows keep any of them.\n *\n * Only for a capability that HAS a document — `requirements` absent means there\n * is no document to promise anything, and a `0 of 0` on such a row would read as\n * a gap where there is not even a claim.\n *\n * `flowsRead` false marks the count as PARTIAL in the cell itself and not only\n * in the note below the table. Without the suffix, a fleet whose promises are\n * all kept by flows prints `0 of 4 promises kept` over an unreadable\n * `architecture/` — a number a reader would act on before reaching the note,\n * and the exact false negative this axis exists to refuse.\n */\nfunction promiseCells(row: CapabilityRow, flowsRead: boolean): string[] {\n if (row.requirements === undefined) return [];\n const total = row.requirements.length;\n if (total === 0) return [];\n const kept = row.requirements.filter(\n (req) => req.realizedBy.length > 0 || (req.keptBy?.length ?? 0) > 0,\n ).length;\n // Distinct flows across the whole capability, sorted: the per-requirement\n // lists are already sorted, and a reader scanning this column wants the\n // documents to open, not the pairing (the `--json` rows carry that).\n const flows = [...new Set(row.requirements.flatMap((req) => req.keptBy ?? []))].sort(compareIds);\n const partial = flowsRead ? \"\" : \" (flows unread)\";\n return [`${kept} of ${total} promise${total === 1 ? \"\" : \"s\"} kept${partial}`]\n .concat(flows.length === 0 ? [] : [`flows: ${flows.join(\", \")}`]);\n}\n\n/** Narrow verification cell: confirmed/claims when a record answers, one word when it does not. */\nfunction verificationMark(v: VerificationCell | null): string {\n if (v === null) return \"-\";\n if (v.state === \"stale\") return \"stale\";\n // `11/11` and `11/11 attested` are different facts — the first is a\n // digest-matched green run, the second is somebody's word about one. Without\n // the suffix a complete count is the same glyph either way, which is exactly\n // the reading `verify`, `status` and the JSON envelope stopped giving.\n //\n // And who answered the confirmed ones, beside it. The verdict turns on the\n // scenario claims alone, so `7/7` under a verified record still read as seven\n // runs where two were an agent's word about a permission or an edge — the\n // split `--json` carried in `answered` and this column did not.\n const split = v.confirmed > 0 ? ` (${answeredSplit(v.answered)})` : \"\";\n return `${v.confirmed}/${v.claims}${v.verdict === \"attested\" ? \" attested\" : \"\"}${split}`;\n}\n\n/** How wide the title column may grow before a title is cut with an ellipsis. */\nconst TITLE_WIDTH = 40;\n\nexport function printFeatures(rows: FeatureRow[]): void {\n const features = rows.map((r) => r.feature);\n const active = features.filter((f) => !f.archived).length;\n const archived = features.length - active;\n const counts = `${active} active${archived > 0 ? `, ${archived} archived` : \"\"}`;\n // Not `verified`: the column reports three verdicts and only one of them is\n // that one. A heading that names the strong verdict makes every other cell\n // read as it.\n console.log(`features (${counts}) [I]ntent [D]elta verification`);\n const width = Math.max(0, ...features.map((f) => f.id.length));\n // The title beside the id: an id is a key, and a table of keys told a\n // newcomer which rows existed but not which change any of them was.\n const titles = rows.map((r) => {\n const t = r.title ?? \"\";\n return t.length > TITLE_WIDTH ? `${t.slice(0, TITLE_WIDTH - 1)}…` : t;\n });\n const titleWidth = Math.max(0, ...titles.map((t) => t.length));\n const cells = rows.map((r) => verificationMark(r.cell));\n const cellWidth = Math.max(0, ...cells.map((c) => c.length));\n for (const [i, f] of features.entries()) {\n const flags = `${f.has.intent ? \"I\" : \"-\"} ${f.has.delta ? \"D\" : \"-\"}`;\n const svcs = f.services.length > 0 ? f.services.join(\", \") : \"—\";\n const tag = f.archived ? \" (archived)\" : \"\";\n const title = titleWidth === 0 ? \"\" : `${titles[i]!.padEnd(titleWidth)} `;\n console.log(` ${flags} ${f.id.padEnd(width)} ${title}${cells[i]!.padEnd(cellWidth)} ${svcs}${tag}`);\n }\n}\n\n/**\n * The glossary table: what the domain's words are, and who actually uses each.\n *\n * The citation count is the column that matters — a definition nothing cites is\n * the drift `glossary.unlinked` warns about, and this is where a reader sees it\n * before the gate does. `unreadable` is printed as a note rather than folded\n * into the counts for `printCapabilities`' reason one section over: \"cited by\n * nobody\" and \"loam could not read everybody\" are different answers, and a\n * table that let them look alike would be the more comfortable of the two.\n */\nexport function printGlossary(\n rows: Array<{ id: string; linkedBy: string[] }>,\n unreadable: string[],\n): void {\n console.log(`glossary (${rows.length} term${rows.length === 1 ? \"\" : \"s\"})`);\n const width = Math.max(0, ...rows.map((row) => row.id.length));\n for (const row of rows) {\n const n = row.linkedBy.length;\n console.log(` ${row.id.padEnd(width)} ${n === 0 ? \"cited by nothing\" : `${n} document${n === 1 ? \"\" : \"s\"}`}`);\n }\n if (unreadable.length > 0) {\n console.log(\n ` note: ${unreadable.length} document(s) could not be read, so a citation from one of them is not counted here — ` +\n `\\`loam validate --all\\` names each as link.unreadable`,\n );\n }\n}\n"]}
@@ -0,0 +1,120 @@
1
+ /**
2
+ * The review-order gathering and sort behind `loam list --needs-work
3
+ * --review-order`: per-service contract reads (contained per read), the one
4
+ * landscape load, and the deterministic ordering. The derivation itself is
5
+ * pure and lives in core/dependencies/fanin.ts.
6
+ *
7
+ * Fifth and LAST file of the list package — the next module added here forces
8
+ * a split along a named seam (docs/CODE-STYLE.md, the five-file limit).
9
+ */
10
+ import { existsSync } from "node:fs";
11
+ import { readAsyncapi } from "../../core/asyncapi/read.js";
12
+ import {} from "../../core/c4/likec4.js";
13
+ import { serviceResolver } from "../../core/c4/resolve/service.js";
14
+ import { fleetFanIn } from "../../core/dependencies/fanin.js";
15
+ import {} from "../../core/fleet-context.js";
16
+ import { inOrder } from "../../core/kernel/concurrency.js";
17
+ import { compareIds } from "../../core/repo/entries.js";
18
+ import { landscapePath, servicePathsAt } from "../../core/repo/paths.js";
19
+ import {} from "./views.js";
20
+ /**
21
+ * The landscape for the review path, loaded ONCE through the run's memo and
22
+ * handed both to serviceViews (as `preloaded`) and to the fan-in joins — a
23
+ * second parse of a document the run already holds is the cost the shared
24
+ * load exists to retire.
25
+ *
26
+ * Deliberately NOT `readLandscape` from commands/validate/fleet/load.ts: that
27
+ * import would add a list→validate/fleet package edge while
28
+ * validate/fleet/scorecard→list already exists, and the containment is four
29
+ * lines.
30
+ */
31
+ export async function reviewLandscape(docsDir, fleet) {
32
+ const lp = landscapePath(docsDir);
33
+ // Absent is `null` — the same "there is none" serviceViews' own load
34
+ // spells. An UNREADABLE file is deliberately not contained here: bare
35
+ // `loam list` refuses `repository-unavailable` when serviceViews' load
36
+ // throws on it, and a rendering flag must never change what the run
37
+ // refuses — a swallowed throw here answered ok over the exact file the
38
+ // flagless run refuses on, with rows CHANGED by the silent null
39
+ // (`proven: false` flips apiExpected and the missing lists). The throw
40
+ // reaches list.ts's existing handler, so both paths refuse identically.
41
+ if (!existsSync(lp))
42
+ return null;
43
+ return fleet.loadLikeC4(lp);
44
+ }
45
+ /**
46
+ * One service's contract slice for the message join, contained PER READ, not
47
+ * per slice. The distinction is somebody else's rank: a slice is a caller's
48
+ * evidence about OTHER services' fan-in, not only its own row, so a slice
49
+ * that discarded its readable spec.md because its arch.spec.md is broken
50
+ * would silently under-report every producer that spec subscribes to.
51
+ */
52
+ async function contractSlice(entry, fleet) {
53
+ const paths = servicePathsAt(entry.dir);
54
+ const [sent, specConsumes, archConsumes] = await Promise.all([
55
+ readOr([], async () => {
56
+ const events = await readAsyncapi(paths.asyncapi, fleet);
57
+ // An unreadable contract declares nothing this join may count —
58
+ // swallowing it into its parsed subset would grade a broken file as a
59
+ // thin one (the scorecard's contracts.ts spells the same rule).
60
+ return events.unreadable === true ? [] : events.sent;
61
+ }),
62
+ readOr([], () => livingConsumes(paths.spec, fleet)),
63
+ readOr([], () => livingConsumes(paths.archSpec, fleet)),
64
+ ]);
65
+ return { sent, consumed: [...specConsumes, ...archConsumes] };
66
+ }
67
+ /** `Consumes:` names of a spec file's living requirements; absent file, nothing. */
68
+ async function livingConsumes(path, fleet) {
69
+ if (!existsSync(path))
70
+ return [];
71
+ // A REMOVED requirement is on its way out and subscribes to nothing, from
72
+ // either spec namespace.
73
+ return (await fleet.readRequirements(path)).filter((r) => r.kind !== "REMOVED").flatMap((r) => r.consumes);
74
+ }
75
+ /**
76
+ * The containment: an unreadable artifact contributes nothing — and ONLY that
77
+ * artifact's evidence, per the doctrine above. The catch also exists for a
78
+ * mechanical reason (commands/validate/fleet/scorecard/contracts.ts): these
79
+ * are memoized reads whose REJECTION rejects again on every await, so an
80
+ * uncontained one would delete the whole queue from inside the pool.
81
+ */
82
+ async function readOr(fallback, read) {
83
+ try {
84
+ return await read();
85
+ }
86
+ catch {
87
+ // Unreadable reads as "declares nothing" — never as a refusal, and never
88
+ // as its neighbours' silence.
89
+ return fallback;
90
+ }
91
+ }
92
+ /**
93
+ * Fan-in per service id, FLEET-WIDE — the joins need every service's slice
94
+ * anyway; the caller ranks only the worklist, so vouched services carry a
95
+ * count without occupying a rank.
96
+ */
97
+ export async function fanInByService(services, fleet, land) {
98
+ const known = new Set(services.map((s) => s.id));
99
+ const slices = await inOrder(services, async (s) => [s.id, await contractSlice(s, fleet)]);
100
+ const request = {
101
+ services: services.map((s) => s.id),
102
+ contracts: new Map(slices),
103
+ };
104
+ if (land !== null && land.errors.length === 0) {
105
+ return fleetFanIn({
106
+ ...request,
107
+ landscape: { parses: true, relationships: land.relationships, svcOf: serviceResolver(land.elements, known) },
108
+ });
109
+ }
110
+ return fleetFanIn({ ...request, landscape: { parses: false } });
111
+ }
112
+ /**
113
+ * The queue: fan-in descending, ties broken by id — fully deterministic, no
114
+ * clocks, no readdir order, so two runs over one repository are byte-identical
115
+ * (fan-in is a set size and both joins are order-insensitive).
116
+ */
117
+ export function reviewOrder(views, fanIn) {
118
+ return [...views].sort((a, b) => (fanIn.get(b.entry.id) ?? 0) - (fanIn.get(a.entry.id) ?? 0) || compareIds(a.entry.id, b.entry.id));
119
+ }
120
+ //# sourceMappingURL=review.js.map