@jam-overture/loom 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (414) hide show
  1. package/README.md +3 -1
  2. package/dist/application/application.d.ts +109 -0
  3. package/dist/application/application.js +97 -0
  4. package/dist/application/memory.d.ts +20 -0
  5. package/dist/application/memory.js +79 -0
  6. package/dist/application/store.d.ts +101 -0
  7. package/dist/application/store.js +25 -0
  8. package/dist/audience/audience.d.ts +36 -0
  9. package/dist/audience/audience.js +41 -0
  10. package/dist/audience/compose.d.ts +112 -0
  11. package/dist/audience/compose.js +134 -0
  12. package/dist/audience/memory.d.ts +14 -0
  13. package/dist/audience/memory.js +71 -0
  14. package/dist/audience/overlay-store.d.ts +343 -0
  15. package/dist/audience/overlay-store.js +217 -0
  16. package/dist/audience/rule.d.ts +121 -0
  17. package/dist/audience/rule.js +78 -0
  18. package/dist/cli/index.d.ts +3 -4
  19. package/dist/cli/index.js +3 -4
  20. package/dist/cli/templates.js +19 -0
  21. package/dist/data/adapter.d.ts +9 -1
  22. package/dist/data/adapter.js +2 -0
  23. package/dist/data/plan.js +0 -0
  24. package/dist/data/resolution.d.ts +23 -1
  25. package/dist/data/resolve.d.ts +31 -4
  26. package/dist/data/resolve.js +11 -3
  27. package/dist/ids.d.ts +10 -0
  28. package/dist/ids.js +11 -1
  29. package/dist/index.d.ts +1 -0
  30. package/dist/index.js +1 -0
  31. package/dist/interpretation/anthropic.d.ts +1 -1
  32. package/dist/interpretation/anthropic.js +2 -22
  33. package/dist/interpretation/client.d.ts +1 -1
  34. package/dist/interpretation/materialize.js +67 -22
  35. package/dist/interpretation/openai-compatible.d.ts +36 -0
  36. package/dist/interpretation/openai-compatible.js +79 -0
  37. package/dist/interpretation/status.d.ts +19 -0
  38. package/dist/interpretation/status.js +26 -0
  39. package/dist/live/index.d.ts +73 -0
  40. package/dist/live/index.js +73 -0
  41. package/dist/live/pages.d.ts +187 -0
  42. package/dist/live/pages.js +161 -0
  43. package/dist/live/pull.d.ts +147 -0
  44. package/dist/live/pull.js +398 -0
  45. package/dist/live/pulling.d.ts +79 -0
  46. package/dist/live/pulling.js +117 -0
  47. package/dist/live/window.d.ts +129 -0
  48. package/dist/live/window.js +132 -0
  49. package/dist/patch.d.ts +54 -0
  50. package/dist/patch.js +44 -0
  51. package/dist/project/closing.d.ts +51 -0
  52. package/dist/project/closing.js +53 -0
  53. package/dist/project/memory.d.ts +20 -0
  54. package/dist/project/memory.js +97 -0
  55. package/dist/project/project.d.ts +90 -0
  56. package/dist/project/project.js +91 -0
  57. package/dist/project/store.d.ts +135 -0
  58. package/dist/project/store.js +41 -0
  59. package/dist/registered.d.ts +64 -0
  60. package/dist/registered.js +118 -0
  61. package/dist/render/addressed.d.ts +35 -0
  62. package/dist/render/addressed.js +79 -0
  63. package/dist/render/behaviour-adjust.d.ts +11 -19
  64. package/dist/render/behaviour-adjust.js +75 -21
  65. package/dist/render/behaviour-present.d.ts +8 -0
  66. package/dist/render/behaviour-present.js +57 -6
  67. package/dist/render/behaviour.d.ts +98 -17
  68. package/dist/render/behaviour.js +91 -26
  69. package/dist/render/control-name.d.ts +68 -0
  70. package/dist/render/control-name.js +37 -0
  71. package/dist/render/diagnostics.d.ts +72 -0
  72. package/dist/render/diagnostics.js +7 -0
  73. package/dist/render/document-theme.d.ts +70 -0
  74. package/dist/render/document-theme.js +139 -0
  75. package/dist/render/editable.d.ts +15 -1
  76. package/dist/render/editable.js +13 -1
  77. package/dist/render/expected.d.ts +98 -0
  78. package/dist/render/expected.js +88 -0
  79. package/dist/render/index.d.ts +4 -0
  80. package/dist/render/index.js +4 -0
  81. package/dist/render/reads.d.ts +11 -0
  82. package/dist/render/reads.js +12 -1
  83. package/dist/render/render.d.ts +11 -0
  84. package/dist/render/render.js +294 -53
  85. package/dist/render/request.d.ts +8 -1
  86. package/dist/render/request.js +1 -0
  87. package/dist/render/slots.d.ts +52 -0
  88. package/dist/render/slots.js +24 -0
  89. package/dist/render/theme.d.ts +54 -1
  90. package/dist/render/theme.js +23 -1
  91. package/dist/render/unshown.d.ts +152 -0
  92. package/dist/render/unshown.js +80 -0
  93. package/dist/runtime/analysis.d.ts +94 -9
  94. package/dist/runtime/analysis.js +54 -9
  95. package/dist/runtime/assessment.d.ts +36 -2
  96. package/dist/runtime/assessment.js +27 -2
  97. package/dist/runtime/auto-apply-ceiling.d.ts +54 -0
  98. package/dist/runtime/auto-apply-ceiling.js +66 -0
  99. package/dist/runtime/checks.d.ts +148 -0
  100. package/dist/runtime/checks.js +112 -0
  101. package/dist/runtime/disposition.d.ts +96 -0
  102. package/dist/runtime/disposition.js +46 -0
  103. package/dist/runtime/gate.js +91 -10
  104. package/dist/runtime/index.d.ts +4 -0
  105. package/dist/runtime/index.js +4 -0
  106. package/dist/runtime/irreversibility.d.ts +64 -0
  107. package/dist/runtime/irreversibility.js +45 -0
  108. package/dist/runtime/nesting.d.ts +13 -1
  109. package/dist/runtime/nesting.js +41 -24
  110. package/dist/runtime/pipeline.d.ts +43 -0
  111. package/dist/runtime/pipeline.js +10 -2
  112. package/dist/runtime/policy-change.d.ts +93 -0
  113. package/dist/runtime/policy-change.js +305 -0
  114. package/dist/runtime/policy-log.d.ts +406 -0
  115. package/dist/runtime/policy-log.js +285 -0
  116. package/dist/runtime/policy.d.ts +8 -6
  117. package/dist/runtime/policy.js +5 -2
  118. package/dist/runtime/repointing.js +0 -0
  119. package/dist/runtime/reversibility.d.ts +11 -9
  120. package/dist/runtime/stakes.d.ts +129 -1
  121. package/dist/runtime/stakes.js +240 -26
  122. package/dist/runtime/vocabulary.d.ts +164 -7
  123. package/dist/runtime/vocabulary.js +181 -8
  124. package/dist/sdk/audit.d.ts +174 -3
  125. package/dist/sdk/audit.js +176 -17
  126. package/dist/sdk/catalogue.d.ts +9 -1
  127. package/dist/sdk/conformance.d.ts +37 -3
  128. package/dist/sdk/conformance.js +25 -4
  129. package/dist/sdk/definition.d.ts +129 -5
  130. package/dist/sdk/definition.js +66 -0
  131. package/dist/sdk/registry.d.ts +45 -2
  132. package/dist/sdk/registry.js +102 -1
  133. package/dist/signals/acted.contract.d.ts +21 -0
  134. package/dist/signals/acted.contract.js +236 -0
  135. package/dist/signals/acted.d.ts +359 -0
  136. package/dist/signals/acted.js +135 -0
  137. package/dist/signals/action-change.d.ts +507 -0
  138. package/dist/signals/action-change.js +265 -0
  139. package/dist/signals/action.d.ts +331 -0
  140. package/dist/signals/action.js +182 -0
  141. package/dist/signals/agenda.d.ts +585 -0
  142. package/dist/signals/agenda.js +295 -0
  143. package/dist/signals/applied-window.contract.d.ts +23 -0
  144. package/dist/signals/applied-window.contract.js +160 -0
  145. package/dist/signals/arrivals.contract.d.ts +21 -0
  146. package/dist/signals/arrivals.contract.js +180 -0
  147. package/dist/signals/arrivals.d.ts +375 -0
  148. package/dist/signals/arrivals.js +254 -0
  149. package/dist/signals/arriving.d.ts +210 -0
  150. package/dist/signals/arriving.js +133 -0
  151. package/dist/signals/audiences.d.ts +528 -0
  152. package/dist/signals/audiences.js +255 -0
  153. package/dist/signals/broadcast.d.ts +33 -17
  154. package/dist/signals/broadcast.js +255 -32
  155. package/dist/signals/change.d.ts +378 -0
  156. package/dist/signals/change.js +327 -0
  157. package/dist/signals/collect.d.ts +169 -34
  158. package/dist/signals/collect.js +186 -38
  159. package/dist/signals/conversion.d.ts +348 -0
  160. package/dist/signals/conversion.js +235 -0
  161. package/dist/signals/copy-change.d.ts +553 -0
  162. package/dist/signals/copy-change.js +377 -0
  163. package/dist/signals/copy.d.ts +337 -0
  164. package/dist/signals/copy.js +211 -0
  165. package/dist/signals/correlated.contract.d.ts +24 -0
  166. package/dist/signals/correlated.contract.js +94 -0
  167. package/dist/signals/counters.d.ts +97 -0
  168. package/dist/signals/counters.js +160 -0
  169. package/dist/signals/deliver.d.ts +23 -4
  170. package/dist/signals/deliver.js +34 -6
  171. package/dist/signals/deployment-change.d.ts +395 -0
  172. package/dist/signals/deployment-change.js +309 -0
  173. package/dist/signals/deployment.d.ts +278 -0
  174. package/dist/signals/deployment.js +178 -0
  175. package/dist/signals/door.d.ts +114 -0
  176. package/dist/signals/door.js +77 -0
  177. package/dist/signals/expire.d.ts +192 -0
  178. package/dist/signals/expire.js +213 -0
  179. package/dist/signals/fold.d.ts +10 -0
  180. package/dist/signals/fold.js +5 -1
  181. package/dist/signals/form-action.d.ts +302 -0
  182. package/dist/signals/form-action.js +169 -0
  183. package/dist/signals/form-copy.d.ts +523 -0
  184. package/dist/signals/form-copy.js +346 -0
  185. package/dist/signals/forms.d.ts +247 -0
  186. package/dist/signals/forms.js +147 -0
  187. package/dist/signals/frontier.d.ts +268 -0
  188. package/dist/signals/frontier.js +145 -0
  189. package/dist/signals/funnel-change.d.ts +548 -0
  190. package/dist/signals/funnel-change.js +361 -0
  191. package/dist/signals/funnel-hours.contract.d.ts +21 -0
  192. package/dist/signals/funnel-hours.contract.js +221 -0
  193. package/dist/signals/funnel-hours.d.ts +293 -0
  194. package/dist/signals/funnel-hours.js +99 -0
  195. package/dist/signals/funnel.d.ts +592 -0
  196. package/dist/signals/funnel.js +231 -0
  197. package/dist/signals/health.d.ts +694 -0
  198. package/dist/signals/health.js +573 -0
  199. package/dist/signals/index.d.ts +60 -0
  200. package/dist/signals/index.js +60 -0
  201. package/dist/signals/ingest.d.ts +56 -1
  202. package/dist/signals/ingest.js +91 -1
  203. package/dist/signals/inside.d.ts +190 -0
  204. package/dist/signals/inside.js +263 -0
  205. package/dist/signals/join.d.ts +56 -0
  206. package/dist/signals/join.js +60 -0
  207. package/dist/signals/journal.d.ts +123 -9
  208. package/dist/signals/kept.contract.d.ts +22 -0
  209. package/dist/signals/kept.contract.js +111 -0
  210. package/dist/signals/kinds.d.ts +8 -6
  211. package/dist/signals/kinds.js +14 -6
  212. package/dist/signals/library-action.d.ts +430 -0
  213. package/dist/signals/library-action.js +336 -0
  214. package/dist/signals/library-agenda-change.d.ts +324 -0
  215. package/dist/signals/library-agenda-change.js +199 -0
  216. package/dist/signals/library-agenda.d.ts +258 -0
  217. package/dist/signals/library-agenda.js +167 -0
  218. package/dist/signals/library-change.d.ts +477 -0
  219. package/dist/signals/library-change.js +335 -0
  220. package/dist/signals/library-copy-change.d.ts +498 -0
  221. package/dist/signals/library-copy-change.js +476 -0
  222. package/dist/signals/library-pace.d.ts +319 -0
  223. package/dist/signals/library-pace.js +305 -0
  224. package/dist/signals/library-reach-change.d.ts +646 -0
  225. package/dist/signals/library-reach-change.js +542 -0
  226. package/dist/signals/library-reach.d.ts +377 -0
  227. package/dist/signals/library-reach.js +227 -0
  228. package/dist/signals/library-senders-change.d.ts +457 -0
  229. package/dist/signals/library-senders-change.js +367 -0
  230. package/dist/signals/library-senders-reach-change.d.ts +486 -0
  231. package/dist/signals/library-senders-reach-change.js +538 -0
  232. package/dist/signals/library-senders-reach.d.ts +340 -0
  233. package/dist/signals/library-senders-reach.js +252 -0
  234. package/dist/signals/library-senders.d.ts +271 -0
  235. package/dist/signals/library-senders.js +180 -0
  236. package/dist/signals/library-word-reach-change.d.ts +567 -0
  237. package/dist/signals/library-word-reach-change.js +564 -0
  238. package/dist/signals/library.d.ts +306 -0
  239. package/dist/signals/library.js +178 -0
  240. package/dist/signals/memory.d.ts +9 -0
  241. package/dist/signals/memory.js +246 -14
  242. package/dist/signals/migrate.d.ts +20 -4
  243. package/dist/signals/migrate.js +269 -8
  244. package/dist/signals/notice.d.ts +389 -0
  245. package/dist/signals/notice.js +250 -0
  246. package/dist/signals/pace-change.d.ts +501 -0
  247. package/dist/signals/pace-change.js +310 -0
  248. package/dist/signals/pace.d.ts +296 -0
  249. package/dist/signals/pace.js +291 -0
  250. package/dist/signals/page-views.d.ts +365 -0
  251. package/dist/signals/page-views.js +218 -0
  252. package/dist/signals/part-pace.d.ts +378 -0
  253. package/dist/signals/part-pace.js +333 -0
  254. package/dist/signals/parts.d.ts +354 -0
  255. package/dist/signals/parts.js +232 -0
  256. package/dist/signals/postgres.d.ts +16 -2
  257. package/dist/signals/postgres.js +753 -76
  258. package/dist/signals/progress.d.ts +212 -0
  259. package/dist/signals/progress.js +150 -0
  260. package/dist/signals/ratios.d.ts +108 -0
  261. package/dist/signals/ratios.js +40 -0
  262. package/dist/signals/reach.d.ts +309 -0
  263. package/dist/signals/reach.js +93 -0
  264. package/dist/signals/readable.d.ts +34 -0
  265. package/dist/signals/readable.js +34 -0
  266. package/dist/signals/readership.d.ts +381 -0
  267. package/dist/signals/readership.js +308 -0
  268. package/dist/signals/region-pages.d.ts +173 -0
  269. package/dist/signals/region-pages.js +62 -0
  270. package/dist/signals/region.d.ts +287 -0
  271. package/dist/signals/region.js +198 -0
  272. package/dist/signals/retention.d.ts +163 -0
  273. package/dist/signals/retention.js +75 -0
  274. package/dist/signals/rhythm.d.ts +302 -0
  275. package/dist/signals/rhythm.js +262 -0
  276. package/dist/signals/rollup.d.ts +194 -4
  277. package/dist/signals/rollup.js +0 -0
  278. package/dist/signals/schema.d.ts +1069 -1
  279. package/dist/signals/schema.js +393 -3
  280. package/dist/signals/signal.d.ts +237 -11
  281. package/dist/signals/signal.js +70 -10
  282. package/dist/signals/silence-census.d.ts +205 -0
  283. package/dist/signals/silence-census.js +87 -0
  284. package/dist/signals/silences.d.ts +1147 -0
  285. package/dist/signals/silences.js +996 -0
  286. package/dist/signals/subtrees.d.ts +123 -0
  287. package/dist/signals/subtrees.js +102 -0
  288. package/dist/signals/tally.d.ts +262 -12
  289. package/dist/signals/unread.d.ts +292 -0
  290. package/dist/signals/unread.js +137 -0
  291. package/dist/signals/window-agenda.d.ts +276 -0
  292. package/dist/signals/window-agenda.js +83 -0
  293. package/dist/signals/window-figures.d.ts +148 -0
  294. package/dist/signals/window-figures.js +42 -0
  295. package/dist/signals/window-funnels.d.ts +88 -0
  296. package/dist/signals/window-funnels.js +47 -0
  297. package/dist/signals/window.d.ts +866 -0
  298. package/dist/signals/window.js +693 -0
  299. package/dist/signals/words.d.ts +24 -0
  300. package/dist/signals/words.js +24 -0
  301. package/dist/store/cache.d.ts +101 -0
  302. package/dist/store/cache.js +149 -0
  303. package/dist/store/history.d.ts +82 -0
  304. package/dist/store/history.js +36 -0
  305. package/dist/store/index.d.ts +30 -0
  306. package/dist/store/index.js +30 -0
  307. package/dist/store/memory.d.ts +2 -1
  308. package/dist/store/memory.js +48 -12
  309. package/dist/store/migrate.d.ts +106 -0
  310. package/dist/store/migrate.js +323 -7
  311. package/dist/store/postgres-applications.d.ts +4 -0
  312. package/dist/store/postgres-applications.js +197 -0
  313. package/dist/store/postgres-audience.d.ts +14 -0
  314. package/dist/store/postgres-audience.js +272 -0
  315. package/dist/store/postgres-holds.d.ts +10 -1
  316. package/dist/store/postgres-holds.js +116 -101
  317. package/dist/store/postgres-policy-log.d.ts +14 -0
  318. package/dist/store/postgres-policy-log.js +240 -0
  319. package/dist/store/postgres-projects.d.ts +4 -0
  320. package/dist/store/postgres-projects.js +217 -0
  321. package/dist/store/postgres.d.ts +17 -1
  322. package/dist/store/postgres.js +60 -9
  323. package/dist/store/replay.d.ts +102 -1
  324. package/dist/store/replay.js +190 -19
  325. package/dist/store/reseed.d.ts +238 -0
  326. package/dist/store/reseed.js +308 -0
  327. package/dist/store/schema.d.ts +762 -2
  328. package/dist/store/schema.js +218 -5
  329. package/dist/store/source.d.ts +57 -1
  330. package/dist/store/source.js +65 -1
  331. package/dist/store/store.d.ts +29 -6
  332. package/dist/submit/resolve.d.ts +1 -1
  333. package/dist/submit/resolve.js +2 -1
  334. package/dist/telemetry/calibration.d.ts +25 -0
  335. package/dist/telemetry/calibration.js +27 -1
  336. package/dist/telemetry/event.d.ts +391 -33
  337. package/dist/telemetry/event.js +84 -20
  338. package/dist/telemetry/index.d.ts +2 -0
  339. package/dist/telemetry/index.js +2 -0
  340. package/dist/telemetry/journal.d.ts +104 -3
  341. package/dist/telemetry/journal.js +9 -0
  342. package/dist/telemetry/lookup.d.ts +27 -0
  343. package/dist/telemetry/lookup.js +18 -0
  344. package/dist/telemetry/memory.js +33 -1
  345. package/dist/telemetry/migrate.js +22 -1
  346. package/dist/telemetry/postgres.d.ts +10 -1
  347. package/dist/telemetry/postgres.js +188 -90
  348. package/dist/telemetry/remeasure.d.ts +78 -0
  349. package/dist/telemetry/remeasure.js +83 -0
  350. package/dist/telemetry/retention.d.ts +2 -2
  351. package/dist/telemetry/schema.d.ts +17 -0
  352. package/dist/telemetry/schema.js +27 -1
  353. package/dist/telemetry/sink.d.ts +2 -2
  354. package/dist/telemetry/window.d.ts +135 -0
  355. package/dist/telemetry/window.js +101 -0
  356. package/dist/testing/application-contract.d.ts +14 -0
  357. package/dist/testing/application-contract.js +270 -0
  358. package/dist/testing/audience-overlay-contract.d.ts +31 -0
  359. package/dist/testing/audience-overlay-contract.js +354 -0
  360. package/dist/testing/contracts.d.ts +13 -7
  361. package/dist/testing/contracts.js +13 -7
  362. package/dist/testing/definitions.d.ts +78 -0
  363. package/dist/testing/definitions.js +134 -9
  364. package/dist/testing/doubles.d.ts +103 -0
  365. package/dist/testing/doubles.js +143 -0
  366. package/dist/testing/index.d.ts +2 -2
  367. package/dist/testing/index.js +2 -2
  368. package/dist/testing/journal-contract.js +297 -6
  369. package/dist/testing/model-contract.d.ts +110 -0
  370. package/dist/testing/model-contract.js +150 -0
  371. package/dist/testing/policy-log-contract.d.ts +26 -0
  372. package/dist/testing/policy-log-contract.js +344 -0
  373. package/dist/testing/project-contract.d.ts +14 -0
  374. package/dist/testing/project-contract.js +266 -0
  375. package/dist/testing/reader-signal-contract.d.ts +27 -2
  376. package/dist/testing/reader-signal-contract.js +475 -5
  377. package/dist/testing/store-contract.d.ts +7 -1
  378. package/dist/testing/store-contract.js +84 -3
  379. package/dist/theme/apply.d.ts +20 -1
  380. package/dist/theme/apply.js +5 -3
  381. package/dist/theme/contrast.d.ts +19 -14
  382. package/dist/theme/contrast.js +181 -17
  383. package/dist/theme/derive.d.ts +22 -0
  384. package/dist/theme/derive.js +54 -1
  385. package/dist/theme/library.js +1 -1
  386. package/dist/theme/measure.d.ts +34 -0
  387. package/dist/theme/measure.js +30 -1
  388. package/dist/theme/palettes.js +7 -7
  389. package/dist/theme/ramp.d.ts +64 -0
  390. package/dist/theme/ramp.js +114 -0
  391. package/dist/theme/registry.d.ts +9 -0
  392. package/dist/theme/registry.js +11 -1
  393. package/dist/theme/separation.d.ts +97 -3
  394. package/dist/theme/separation.js +75 -0
  395. package/dist/tree/apply.js +13 -0
  396. package/dist/tree/compare.d.ts +9 -0
  397. package/dist/tree/compare.js +18 -0
  398. package/dist/tree/mutation.d.ts +18 -0
  399. package/dist/tree/mutation.js +24 -12
  400. package/dist/tree/navigation.d.ts +5 -0
  401. package/dist/tree/navigation.js +32 -10
  402. package/dist/tree/outline.d.ts +7 -0
  403. package/dist/tree/outline.js +9 -5
  404. package/dist/write/computed.d.ts +60 -0
  405. package/dist/write/computed.js +61 -0
  406. package/dist/write/held.d.ts +59 -0
  407. package/dist/write/index.d.ts +5 -2
  408. package/dist/write/index.js +5 -2
  409. package/dist/write/reseed.d.ts +151 -0
  410. package/dist/write/reseed.js +184 -0
  411. package/dist/write/revert.js +2 -16
  412. package/package.json +25 -3
  413. package/dist/runtime/inverse-interpreter.d.ts +0 -90
  414. package/dist/runtime/inverse-interpreter.js +0 -56
@@ -3,11 +3,19 @@ import { childrenOf } from "./node.js";
3
3
  * Read-only traversal. Every function here takes a root and derives a view;
4
4
  * nothing caches, because a cache would be a second source of truth about a
5
5
  * structure that changes on every accepted delta.
6
+ *
7
+ * **Nothing here recurses into the tree**, which is a correctness requirement
8
+ * rather than a preference (0372): a page's depth is data, so a walk that
9
+ * spends a call frame per level stops answering at a depth a tree is allowed to
10
+ * reach. Every walk below carries an explicit stack and is linear in nodes.
6
11
  */
7
12
  export function* walkTree(root) {
8
- yield root;
9
- for (const child of childrenOf(root))
10
- yield* walkTree(child);
13
+ const pending = [root];
14
+ for (let node = pending.pop(); node !== undefined; node = pending.pop()) {
15
+ yield node;
16
+ for (const child of [...childrenOf(node)].reverse())
17
+ pending.push(child);
18
+ }
11
19
  }
12
20
  export const collectNodeIds = (root) => Array.from(walkTree(root), (node) => node.id);
13
21
  export const findNode = (root, nodeId) => {
@@ -25,18 +33,26 @@ export const findParent = (root, nodeId) => {
25
33
  }
26
34
  return null;
27
35
  };
36
+ const chainTo = (descent) => {
37
+ const chain = [];
38
+ for (let step = descent; step !== null; step = step.from) {
39
+ chain.push(step.node);
40
+ }
41
+ return chain.reverse();
42
+ };
28
43
  /**
29
44
  * The chain of nodes from the root down to and including `nodeId`, or null when
30
45
  * the node is absent. Paths are derived on demand and never persisted — the id
31
46
  * is the stable address, the path is the current position.
32
47
  */
33
48
  export const nodePath = (root, nodeId) => {
34
- if (root.id === nodeId)
35
- return [root];
36
- for (const child of childrenOf(root)) {
37
- const childPath = nodePath(child, nodeId);
38
- if (childPath)
39
- return [root, ...childPath];
49
+ const pending = [{ node: root, from: null }];
50
+ for (let descent = pending.pop(); descent !== undefined; descent = pending.pop()) {
51
+ if (descent.node.id === nodeId)
52
+ return chainTo(descent);
53
+ for (const child of [...childrenOf(descent.node)].reverse()) {
54
+ pending.push({ node: child, from: descent });
55
+ }
40
56
  }
41
57
  return null;
42
58
  };
@@ -46,7 +62,13 @@ export const isDescendantOf = (root, ancestorId, nodeId) => {
46
62
  const ancestor = findNode(root, ancestorId);
47
63
  if (!ancestor)
48
64
  return false;
49
- return childrenOf(ancestor).some((child) => child.id === nodeId || isDescendantOf(child, child.id, nodeId));
65
+ const beneath = walkTree(ancestor);
66
+ beneath.next(); // a node is not its own descendant, and the walk yields it first
67
+ for (const node of beneath) {
68
+ if (node.id === nodeId)
69
+ return true;
70
+ }
71
+ return false;
50
72
  };
51
73
  /**
52
74
  * What a node says: every text node under it, in tree order, concatenated.
@@ -13,6 +13,13 @@ import { type LoomNode } from "./node.js";
13
13
  * `index` is the position among the parent's children, which is the same number
14
14
  * an `insert` or a `move` names — an outline row is therefore enough to address
15
15
  * a position, not only a node.
16
+ *
17
+ * The walk carries an **explicit stack** and is not recursive, which is a
18
+ * correctness requirement rather than a preference (0372). A recursive
19
+ * generator delegating with `yield*` passes every value back up through each
20
+ * delegating frame, so a node at depth *d* costs *d*, the walk costs the sum of
21
+ * the depths rather than the number of nodes, and past about two thousand deep
22
+ * it does not return at all.
16
23
  */
17
24
  export type OutlineEntry = {
18
25
  readonly node: LoomNode;
@@ -1,10 +1,14 @@
1
1
  import { childrenOf } from "./node.js";
2
- function* walkOutline(node, depth, parentId, index) {
3
- yield { node, depth, parentId, index };
4
- for (const [childIndex, child] of childrenOf(node).entries()) {
5
- yield* walkOutline(child, depth + 1, node.id, childIndex);
2
+ function* walkOutline(root) {
3
+ const pending = [{ node: root, depth: 0, parentId: null, index: 0 }];
4
+ for (let entry = pending.pop(); entry !== undefined; entry = pending.pop()) {
5
+ yield entry;
6
+ const nested = Array.from(childrenOf(entry.node).entries()).reverse();
7
+ for (const [index, child] of nested) {
8
+ pending.push({ node: child, depth: entry.depth + 1, parentId: entry.node.id, index });
9
+ }
6
10
  }
7
11
  }
8
12
  /** Pre-order, so a row is always preceded by the row it is nested inside. */
9
- export const outlineTree = (root) => Array.from(walkOutline(root, 0, null, 0));
13
+ export const outlineTree = (root) => Array.from(walkOutline(root));
10
14
  //# sourceMappingURL=outline.js.map
@@ -0,0 +1,60 @@
1
+ import type { ChangeInterpreter } from "../runtime/interpreter.js";
2
+ import type { CompositionRuntime } from "../runtime/pipeline.js";
3
+ /**
4
+ * The runtime a change the runtime computed is judged under.
5
+ *
6
+ * An undo and a reseed are both changes nothing interpreted: the operations are
7
+ * derived, and what reaches the Gate is a proposal wearing a deterministic
8
+ * interpreter instead of a model (`inverseInterpreter`). Both therefore want the
9
+ * same thing from the host's runtime — every seam that *judges* a change, and
10
+ * not the one that would offer a smaller version of it.
11
+ *
12
+ * ## Why this is a function and not two object literals
13
+ *
14
+ * `revertRevision` built its runtime field by field, and the comment above it
15
+ * said why: dropping the repairer should be a statement rather than an omission.
16
+ * That reasoning was right about the repairer and wrong about the method, and the
17
+ * difference only showed when `CompositionRuntime` grew. `propsVocabulary` and
18
+ * `bindingReader` arrived afterwards (0179, 0208), and a literal that names five
19
+ * fields does not fail to compile when a sixth appears — it silently stops
20
+ * passing it.
21
+ *
22
+ * So every undo was judged as though the host had wired neither check. Two
23
+ * consequences, and the second is worse than the first:
24
+ *
25
+ * - a deployment that refuses AI-authored props its own schemas reject did not
26
+ * refuse them on the undo path, which is a real hole in a real check;
27
+ * - `Disposition.wiredChecks` recorded the undo as judged with both seams
28
+ * absent, which is **0248's point inverted**. That field exists because the
29
+ * policy fingerprint cannot see a seam, so wiring one has to leave a record of
30
+ * the day it was wired. A record saying a wired check was not wired is worse
31
+ * than no record, because a later reading of the log cannot tell it from the
32
+ * truth.
33
+ *
34
+ * Nothing was failing. Nothing was going to start failing on its own, either:
35
+ * the drop is invisible to every test that does not wire a vocabulary *and* then
36
+ * undo something, and it would have been copied into the reseed path by anybody
37
+ * reading the revert path as the pattern — which is exactly what this run set
38
+ * out to do.
39
+ *
40
+ * ## How the drop is made impossible rather than remembered
41
+ *
42
+ * The repairer is removed by name and everything else is carried by the rest
43
+ * element, so the statement is still a statement — `repairer` is written down,
44
+ * right here, as the one field a computed change does not get — while a seventh
45
+ * seam on `CompositionRuntime` reaches the Gate on the day it lands without
46
+ * anybody editing this file.
47
+ *
48
+ * Repair (0006) exists to let a model try a smaller version of what the Gate
49
+ * refused, and there is no smaller version of putting something back. A computed
50
+ * change the Gate refuses is refused.
51
+ */
52
+ /**
53
+ * The host's runtime, with every judging seam carried and the repairer dropped.
54
+ *
55
+ * `repairer` is removed by name and the rest is spread, so the omission is still
56
+ * written down while a seam added to `CompositionRuntime` tomorrow reaches the
57
+ * Gate without anybody editing this file.
58
+ */
59
+ export declare const computedChangeRuntime: (runtime: CompositionRuntime, interpreter: ChangeInterpreter) => CompositionRuntime;
60
+ //# sourceMappingURL=computed.d.ts.map
@@ -0,0 +1,61 @@
1
+ /**
2
+ * The runtime a change the runtime computed is judged under.
3
+ *
4
+ * An undo and a reseed are both changes nothing interpreted: the operations are
5
+ * derived, and what reaches the Gate is a proposal wearing a deterministic
6
+ * interpreter instead of a model (`inverseInterpreter`). Both therefore want the
7
+ * same thing from the host's runtime — every seam that *judges* a change, and
8
+ * not the one that would offer a smaller version of it.
9
+ *
10
+ * ## Why this is a function and not two object literals
11
+ *
12
+ * `revertRevision` built its runtime field by field, and the comment above it
13
+ * said why: dropping the repairer should be a statement rather than an omission.
14
+ * That reasoning was right about the repairer and wrong about the method, and the
15
+ * difference only showed when `CompositionRuntime` grew. `propsVocabulary` and
16
+ * `bindingReader` arrived afterwards (0179, 0208), and a literal that names five
17
+ * fields does not fail to compile when a sixth appears — it silently stops
18
+ * passing it.
19
+ *
20
+ * So every undo was judged as though the host had wired neither check. Two
21
+ * consequences, and the second is worse than the first:
22
+ *
23
+ * - a deployment that refuses AI-authored props its own schemas reject did not
24
+ * refuse them on the undo path, which is a real hole in a real check;
25
+ * - `Disposition.wiredChecks` recorded the undo as judged with both seams
26
+ * absent, which is **0248's point inverted**. That field exists because the
27
+ * policy fingerprint cannot see a seam, so wiring one has to leave a record of
28
+ * the day it was wired. A record saying a wired check was not wired is worse
29
+ * than no record, because a later reading of the log cannot tell it from the
30
+ * truth.
31
+ *
32
+ * Nothing was failing. Nothing was going to start failing on its own, either:
33
+ * the drop is invisible to every test that does not wire a vocabulary *and* then
34
+ * undo something, and it would have been copied into the reseed path by anybody
35
+ * reading the revert path as the pattern — which is exactly what this run set
36
+ * out to do.
37
+ *
38
+ * ## How the drop is made impossible rather than remembered
39
+ *
40
+ * The repairer is removed by name and everything else is carried by the rest
41
+ * element, so the statement is still a statement — `repairer` is written down,
42
+ * right here, as the one field a computed change does not get — while a seventh
43
+ * seam on `CompositionRuntime` reaches the Gate on the day it lands without
44
+ * anybody editing this file.
45
+ *
46
+ * Repair (0006) exists to let a model try a smaller version of what the Gate
47
+ * refused, and there is no smaller version of putting something back. A computed
48
+ * change the Gate refuses is refused.
49
+ */
50
+ /**
51
+ * The host's runtime, with every judging seam carried and the repairer dropped.
52
+ *
53
+ * `repairer` is removed by name and the rest is spread, so the omission is still
54
+ * written down while a seam added to `CompositionRuntime` tomorrow reaches the
55
+ * Gate without anybody editing this file.
56
+ */
57
+ export const computedChangeRuntime = (runtime, interpreter) => {
58
+ const { repairer: _norepair, ...judging } = runtime;
59
+ return { ...judging, interpreter };
60
+ };
61
+ //# sourceMappingURL=computed.js.map
@@ -319,6 +319,29 @@ export declare const heldProposalSchema: z.ZodObject<{
319
319
  confidence: z.ZodNumber;
320
320
  policyId: z.ZodDefault<z.ZodString>;
321
321
  policyFingerprint: z.ZodOptional<z.ZodString>;
322
+ wiredChecks: z.ZodOptional<z.ZodArray<z.ZodEnum<["props", "bindings", "regions"]>, "many">>;
323
+ irreversibilityReasons: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"code", [z.ZodObject<{
324
+ code: z.ZodLiteral<"out-of-tree-effect">;
325
+ primitiveTypes: z.ZodArray<z.ZodBranded<z.ZodString, "PrimitiveType">, "many">;
326
+ }, "strip", z.ZodTypeAny, {
327
+ code: "out-of-tree-effect";
328
+ primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
329
+ }, {
330
+ code: "out-of-tree-effect";
331
+ primitiveTypes: string[];
332
+ }>, z.ZodObject<{
333
+ code: z.ZodLiteral<"retention-budget-exceeded">;
334
+ retainedNodeCount: z.ZodNumber;
335
+ budget: z.ZodNumber;
336
+ }, "strip", z.ZodTypeAny, {
337
+ code: "retention-budget-exceeded";
338
+ retainedNodeCount: number;
339
+ budget: number;
340
+ }, {
341
+ code: "retention-budget-exceeded";
342
+ retainedNodeCount: number;
343
+ budget: number;
344
+ }>]>, "many">>;
322
345
  }, "strip", z.ZodTypeAny, {
323
346
  kind: "rejected" | "accepted" | "requires-confirmation";
324
347
  confidence: number;
@@ -330,6 +353,15 @@ export declare const heldProposalSchema: z.ZodObject<{
330
353
  stakes: "low" | "medium" | "high" | "critical";
331
354
  reversible: boolean;
332
355
  policyFingerprint?: string | undefined;
356
+ wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
357
+ irreversibilityReasons?: ({
358
+ code: "out-of-tree-effect";
359
+ primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
360
+ } | {
361
+ code: "retention-budget-exceeded";
362
+ retainedNodeCount: number;
363
+ budget: number;
364
+ })[] | undefined;
333
365
  }, {
334
366
  kind: "rejected" | "accepted" | "requires-confirmation";
335
367
  confidence: number;
@@ -341,6 +373,15 @@ export declare const heldProposalSchema: z.ZodObject<{
341
373
  reversible: boolean;
342
374
  policyId?: string | undefined;
343
375
  policyFingerprint?: string | undefined;
376
+ wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
377
+ irreversibilityReasons?: ({
378
+ code: "out-of-tree-effect";
379
+ primitiveTypes: string[];
380
+ } | {
381
+ code: "retention-budget-exceeded";
382
+ retainedNodeCount: number;
383
+ budget: number;
384
+ })[] | undefined;
344
385
  }>;
345
386
  heldAt: z.ZodString;
346
387
  }, "strip", z.ZodTypeAny, {
@@ -402,6 +443,15 @@ export declare const heldProposalSchema: z.ZodObject<{
402
443
  stakes: "low" | "medium" | "high" | "critical";
403
444
  reversible: boolean;
404
445
  policyFingerprint?: string | undefined;
446
+ wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
447
+ irreversibilityReasons?: ({
448
+ code: "out-of-tree-effect";
449
+ primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
450
+ } | {
451
+ code: "retention-budget-exceeded";
452
+ retainedNodeCount: number;
453
+ budget: number;
454
+ })[] | undefined;
405
455
  };
406
456
  intent: {
407
457
  treeId: string & z.BRAND<"TreeId">;
@@ -473,6 +523,15 @@ export declare const heldProposalSchema: z.ZodObject<{
473
523
  reversible: boolean;
474
524
  policyId?: string | undefined;
475
525
  policyFingerprint?: string | undefined;
526
+ wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
527
+ irreversibilityReasons?: ({
528
+ code: "out-of-tree-effect";
529
+ primitiveTypes: string[];
530
+ } | {
531
+ code: "retention-budget-exceeded";
532
+ retainedNodeCount: number;
533
+ budget: number;
534
+ })[] | undefined;
476
535
  };
477
536
  intent: {
478
537
  treeId: string;
@@ -1,11 +1,14 @@
1
1
  /**
2
2
  * Committing a judged change, and taking one back.
3
3
  *
4
- * The three operations that move a tree forward or backward in the store once the
5
- * gate has had its say.
4
+ * The operations that move a tree forward or backward in the store once the gate
5
+ * has had its say — including the two it computes itself, which take the same
6
+ * path as the ones a model proposes.
6
7
  */
7
8
  export * from "./commit.js";
9
+ export * from "./computed.js";
8
10
  export * from "./held.js";
9
11
  export * from "./liveness.js";
12
+ export * from "./reseed.js";
10
13
  export * from "./revert.js";
11
14
  //# sourceMappingURL=index.d.ts.map
@@ -1,11 +1,14 @@
1
1
  /**
2
2
  * Committing a judged change, and taking one back.
3
3
  *
4
- * The three operations that move a tree forward or backward in the store once the
5
- * gate has had its say.
4
+ * The operations that move a tree forward or backward in the store once the gate
5
+ * has had its say — including the two it computes itself, which take the same
6
+ * path as the ones a model proposes.
6
7
  */
7
8
  export * from "./commit.js";
9
+ export * from "./computed.js";
8
10
  export * from "./held.js";
9
11
  export * from "./liveness.js";
12
+ export * from "./reseed.js";
10
13
  export * from "./revert.js";
11
14
  //# sourceMappingURL=index.js.map
@@ -0,0 +1,151 @@
1
+ import type { IdFactory, TreeId } from "../ids.js";
2
+ import type { Clock } from "../runtime/events.js";
3
+ import type { IntentOrigin } from "../runtime/intent.js";
4
+ import type { ChangeInterpreter } from "../runtime/interpreter.js";
5
+ import type { DiscardedWork } from "../runtime/proposal.js";
6
+ import { type ReseedPlan, type UnreseedablePlan } from "../store/reseed.js";
7
+ import type { LoomTree } from "../tree/tree.js";
8
+ import { type WriteOutcome, type WritePath } from "./commit.js";
9
+ /**
10
+ * Putting a page back, as a change like any other — and the half that makes the
11
+ * operation pressable.
12
+ *
13
+ * `planReseed` has been able to say *here are the operations that carry this
14
+ * stored page to the tree its builder produces now* since 0268. Nothing
15
+ * proposed them. The gap that left is the one `Loom marketing` filed on 12
16
+ * October, and it filed it as a cost rather than as a gap, which is the version
17
+ * that says who is blocked:
18
+ *
19
+ * > **Merging a marketing pull request no longer changes the marketing site.**
20
+ *
21
+ * Every page of that surface is already a row on any deployment that has been
22
+ * visited once. Seeding is create-if-absent and must stay that way — a deploy
23
+ * that wrote over a stored page would throw away every change somebody accepted
24
+ * in the portal, which is the trade 0259 took deliberately. So an edited builder
25
+ * finds the same tree id it found yesterday, leaves it alone, and the authored
26
+ * page stops being the served one.
27
+ *
28
+ * This is `revertRevision`'s sibling and takes the same seven steps: interpreted
29
+ * (deterministically), proposed, assessed, gated, applied, and appended to the
30
+ * log as a new revision. A reseed is therefore attributable to whoever asked for
31
+ * it, refusable by the Gate, holdable for confirmation, visible to telemetry,
32
+ * and itself revertable. The log says *this page was put back on this date, by
33
+ * this person, over these revisions* rather than the history simply ending.
34
+ *
35
+ * ## The question this does not answer, and does not need to
36
+ *
37
+ * The entry asked for one decision beyond the operation: **who presses it.** It
38
+ * set out three answers — only a person, on every deploy, or a button on the
39
+ * page's own screen beside its history — and preferred the third.
40
+ *
41
+ * The Gate already answers it, and the answer is better than any of the three
42
+ * because it is not a fourth switch. 0035 made discarded work a *rule* rather
43
+ * than a level: a change that writes over work already in the log is never
44
+ * applied without a person, whatever latitude its origin has. `reseedDiscards`
45
+ * reads the log and declares what this reseed costs, so:
46
+ *
47
+ * - a page nobody has edited since it was seeded declares nothing, and the
48
+ * reseed applies. A deploy step may call this, and the authored page wins,
49
+ * which is the right default for a page no one has touched.
50
+ * - a page somebody has edited through the portal declares those revisions, and
51
+ * the reseed is **held** — the same hold a reviewer answers on
52
+ * `/portal/trust`, carrying the sentence that names what it would overwrite.
53
+ * A deploy step may call this too, and it cannot quietly discard the edit.
54
+ *
55
+ * So the caller does not choose the safety; the cost of the particular reseed
56
+ * does. The surfaces are then free to offer the button wherever it belongs
57
+ * (`Loom portal`'s to place), because every route to it is the same route.
58
+ *
59
+ * ## What this does not become
60
+ *
61
+ * `TreeStore` still gains nothing — no delete, no reseed method, nothing that
62
+ * writes a tree without being proposed (0268). Seeding is still create-only.
63
+ * What is new is one function a surface can call, and it goes through the one
64
+ * write path (0017) like everything else that becomes history.
65
+ */
66
+ /** What produced the delta, for `Provenance.interpreter`. Not a model. */
67
+ export declare const RESEED_INTERPRETER = "loom/reseed";
68
+ export type ReseedablePlan = Extract<ReseedPlan, {
69
+ readonly outcome: "reseedable";
70
+ }>;
71
+ /** Everything that stops a reseed being proposed. `already-authored` is not one — see `ReseedOutcome`. */
72
+ export type UnproposableReseed = Exclude<UnreseedablePlan, {
73
+ readonly outcome: "already-authored";
74
+ }>;
75
+ /**
76
+ * The same interpreter every reseed uses, with the plan's half filled in.
77
+ *
78
+ * Everything specific to a reseed is here — the stamp that says the runtime
79
+ * planned this against a builder, the rationale a reviewer reads, and the
80
+ * discards the log read found. What is left is `inverseInterpreter`: the head
81
+ * check, the provenance of a computed change, and the shape of the proposal are
82
+ * one implementation rather than two that drift.
83
+ *
84
+ * `undoes` is **absent**, and that is not an omission. It names the one revision
85
+ * a change puts back, and a reseed puts back no revision — it carries the page
86
+ * to a tree that was never in the log, over however many entries stand in the
87
+ * way. Stamping any number there would be a claim the log cannot support; the
88
+ * revisions it writes over are in `discards`, where they are true.
89
+ */
90
+ export declare const reseedInterpreter: (plan: ReseedablePlan, discards: readonly DiscardedWork[], idFactory: IdFactory, clock: Clock) => ChangeInterpreter;
91
+ export type ReseedRequest = {
92
+ readonly treeId: TreeId;
93
+ /**
94
+ * A fresh build of the page — what the builder in the repository produces now.
95
+ *
96
+ * The caller's rather than something this module could obtain, because a
97
+ * builder is the host's: §3 has no registry of pages and no way to run one.
98
+ * The surfaces hold theirs already, and both sides of the comparison being
99
+ * passed in is what keeps this testable without a build step.
100
+ */
101
+ readonly authored: LoomTree;
102
+ readonly origin: IntentOrigin;
103
+ readonly actor?: string;
104
+ };
105
+ export type ReseedOutcome = WriteOutcome
106
+ /**
107
+ * The stored page is already the tree the builder produces, so nothing was
108
+ * proposed and nothing needed to be.
109
+ *
110
+ * Its own ending rather than one of the obstacles below, which is the
111
+ * difference between this and `revertRevision`. A reseed is the kind of
112
+ * operation that gets pressed twice — by a person who cannot see whether the
113
+ * first took, and by a deploy that runs on every release — so *the page is
114
+ * already right* is the healthy answer, and a caller that could not tell it
115
+ * from *the page cannot be put back* would report a success as a failure on
116
+ * every release after the first.
117
+ */
118
+ | {
119
+ readonly kind: "already-authored";
120
+ readonly headRevision: number;
121
+ }
122
+ /**
123
+ * Nothing was proposed, because no reseed could be planned: the two trees are
124
+ * different pages, or they differ by something no operation can express.
125
+ * Writing over accepted work is not one of these — that is a proposal the Gate
126
+ * holds, not a plan that failed (0035).
127
+ */
128
+ | {
129
+ readonly kind: "not-reseedable";
130
+ readonly plan: UnproposableReseed;
131
+ };
132
+ export declare const describeReseedOutcome: (outcome: ReseedOutcome) => string;
133
+ /**
134
+ * Puts a page back to its authored shape, if it can be expressed and the Gate
135
+ * agrees.
136
+ *
137
+ * Reads head itself rather than taking the stored tree, because the head the
138
+ * plan is made against and the head the intent names have to be the same
139
+ * revision — and a caller passing one it read earlier is a caller that can pass
140
+ * a stale one. The write path checks the intent against head again before
141
+ * interpreting, and the interpreter refuses a tree at a revision the plan was
142
+ * not made against, so a page that moves between the read and the commit ends as
143
+ * a `revision-conflict` rather than as a reseed to the wrong arrangement.
144
+ *
145
+ * The intent is synthesised here, for the reason the revert path gives: the
146
+ * utterance behind a reseed is not a sentence anybody typed. `origin` and
147
+ * `actor` are the caller's, and they are what the Gate weighs and what the
148
+ * provenance records — putting a page back is still someone asking for a change.
149
+ */
150
+ export declare const reseedPage: (path: WritePath, request: ReseedRequest) => Promise<ReseedOutcome>;
151
+ //# sourceMappingURL=reseed.d.ts.map