@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
@@ -0,0 +1,184 @@
1
+ import { inverseInterpreter } from "../runtime/inverse.js";
2
+ import { describeReseedPlan, planReseed, reseedDiscards, } from "../store/reseed.js";
3
+ import { commitIntent, describeWriteOutcome } from "./commit.js";
4
+ import { computedChangeRuntime } from "./computed.js";
5
+ /**
6
+ * Putting a page back, as a change like any other — and the half that makes the
7
+ * operation pressable.
8
+ *
9
+ * `planReseed` has been able to say *here are the operations that carry this
10
+ * stored page to the tree its builder produces now* since 0268. Nothing
11
+ * proposed them. The gap that left is the one `Loom marketing` filed on 12
12
+ * October, and it filed it as a cost rather than as a gap, which is the version
13
+ * that says who is blocked:
14
+ *
15
+ * > **Merging a marketing pull request no longer changes the marketing site.**
16
+ *
17
+ * Every page of that surface is already a row on any deployment that has been
18
+ * visited once. Seeding is create-if-absent and must stay that way — a deploy
19
+ * that wrote over a stored page would throw away every change somebody accepted
20
+ * in the portal, which is the trade 0259 took deliberately. So an edited builder
21
+ * finds the same tree id it found yesterday, leaves it alone, and the authored
22
+ * page stops being the served one.
23
+ *
24
+ * This is `revertRevision`'s sibling and takes the same seven steps: interpreted
25
+ * (deterministically), proposed, assessed, gated, applied, and appended to the
26
+ * log as a new revision. A reseed is therefore attributable to whoever asked for
27
+ * it, refusable by the Gate, holdable for confirmation, visible to telemetry,
28
+ * and itself revertable. The log says *this page was put back on this date, by
29
+ * this person, over these revisions* rather than the history simply ending.
30
+ *
31
+ * ## The question this does not answer, and does not need to
32
+ *
33
+ * The entry asked for one decision beyond the operation: **who presses it.** It
34
+ * set out three answers — only a person, on every deploy, or a button on the
35
+ * page's own screen beside its history — and preferred the third.
36
+ *
37
+ * The Gate already answers it, and the answer is better than any of the three
38
+ * because it is not a fourth switch. 0035 made discarded work a *rule* rather
39
+ * than a level: a change that writes over work already in the log is never
40
+ * applied without a person, whatever latitude its origin has. `reseedDiscards`
41
+ * reads the log and declares what this reseed costs, so:
42
+ *
43
+ * - a page nobody has edited since it was seeded declares nothing, and the
44
+ * reseed applies. A deploy step may call this, and the authored page wins,
45
+ * which is the right default for a page no one has touched.
46
+ * - a page somebody has edited through the portal declares those revisions, and
47
+ * the reseed is **held** — the same hold a reviewer answers on
48
+ * `/portal/trust`, carrying the sentence that names what it would overwrite.
49
+ * A deploy step may call this too, and it cannot quietly discard the edit.
50
+ *
51
+ * So the caller does not choose the safety; the cost of the particular reseed
52
+ * does. The surfaces are then free to offer the button wherever it belongs
53
+ * (`Loom portal`'s to place), because every route to it is the same route.
54
+ *
55
+ * ## What this does not become
56
+ *
57
+ * `TreeStore` still gains nothing — no delete, no reseed method, nothing that
58
+ * writes a tree without being proposed (0268). Seeding is still create-only.
59
+ * What is new is one function a surface can call, and it goes through the one
60
+ * write path (0017) like everything else that becomes history.
61
+ */
62
+ /** What produced the delta, for `Provenance.interpreter`. Not a model. */
63
+ export const RESEED_INTERPRETER = "loom/reseed";
64
+ const countOf = (count, noun) => `${count} ${noun}${count === 1 ? "" : "s"}`;
65
+ /**
66
+ * What the reseed is for, and — when there is one — what it costs.
67
+ *
68
+ * Stated in the rationale as well as declared in `discards`, for the reason
69
+ * `revertRevision` gives: the Gate reads the declaration and the person
70
+ * answering the hold reads this (0019 — a reviewer is shown the reason, not a
71
+ * verdict).
72
+ *
73
+ * The shape of the page is named before the cost, because the two answer
74
+ * different halves of a reviewer's question. *What does this do to the page* is
75
+ * the operations, the nodes it removes and the ids it brings back. *What does it
76
+ * take away from me* is the revisions. A reviewer who is told only the second
77
+ * cannot tell a headline being restored from the page being emptied.
78
+ */
79
+ const rationaleFor = (plan, discards) => {
80
+ const puts = `Puts the page back to the tree its builder produces, at head ${plan.headRevision}: ${countOf(plan.operations.length, "operation")}${plan.retires.length === 0 ? "" : `, removing ${countOf(plan.retires.length, "node")}`}${plan.revives.length === 0 ? "" : `, reviving ${countOf(plan.revives.length, "id")}`}.`;
81
+ if (discards.length === 0)
82
+ return `${puts} Nothing in the log has touched the nodes it changes.`;
83
+ const revisions = discards.map((discarded) => discarded.revision).join(", ");
84
+ return `${puts} Revision${discards.length === 1 ? "" : "s"} ${revisions} changed nodes this reseed touches, and applying it writes over what they did.`;
85
+ };
86
+ /**
87
+ * The same interpreter every reseed uses, with the plan's half filled in.
88
+ *
89
+ * Everything specific to a reseed is here — the stamp that says the runtime
90
+ * planned this against a builder, the rationale a reviewer reads, and the
91
+ * discards the log read found. What is left is `inverseInterpreter`: the head
92
+ * check, the provenance of a computed change, and the shape of the proposal are
93
+ * one implementation rather than two that drift.
94
+ *
95
+ * `undoes` is **absent**, and that is not an omission. It names the one revision
96
+ * a change puts back, and a reseed puts back no revision — it carries the page
97
+ * to a tree that was never in the log, over however many entries stand in the
98
+ * way. Stamping any number there would be a claim the log cannot support; the
99
+ * revisions it writes over are in `discards`, where they are true.
100
+ */
101
+ export const reseedInterpreter = (plan, discards, idFactory, clock) => inverseInterpreter({
102
+ operations: plan.operations,
103
+ /**
104
+ * The plan and its cost were both measured at one head. Judging them at a
105
+ * different one would be judging a different question, so the interpreter
106
+ * declines rather than proposing something whose reasoning has expired.
107
+ */
108
+ headRevision: plan.headRevision,
109
+ interpreter: RESEED_INTERPRETER,
110
+ rationale: rationaleFor(plan, discards),
111
+ /**
112
+ * Declared only when there is something to declare, so absence keeps
113
+ * meaning "nobody looked at a log" rather than "a log was checked and was
114
+ * clean" (0035). Here a log was always read — the empty case is said in
115
+ * the rationale in words instead, which is the only place it can be said
116
+ * without lying in a field.
117
+ */
118
+ ...(discards.length === 0 ? {} : { discards }),
119
+ }, idFactory, clock);
120
+ export const describeReseedOutcome = (outcome) => {
121
+ switch (outcome.kind) {
122
+ case "already-authored":
123
+ return `already authored: revision ${outcome.headRevision} is the page the builder produces`;
124
+ case "not-reseedable":
125
+ return `not reseedable: ${describeReseedPlan(outcome.plan)}`;
126
+ default:
127
+ return describeWriteOutcome(outcome);
128
+ }
129
+ };
130
+ /**
131
+ * Puts a page back to its authored shape, if it can be expressed and the Gate
132
+ * agrees.
133
+ *
134
+ * Reads head itself rather than taking the stored tree, because the head the
135
+ * plan is made against and the head the intent names have to be the same
136
+ * revision — and a caller passing one it read earlier is a caller that can pass
137
+ * a stale one. The write path checks the intent against head again before
138
+ * interpreting, and the interpreter refuses a tree at a revision the plan was
139
+ * not made against, so a page that moves between the read and the commit ends as
140
+ * a `revision-conflict` rather than as a reseed to the wrong arrangement.
141
+ *
142
+ * The intent is synthesised here, for the reason the revert path gives: the
143
+ * utterance behind a reseed is not a sentence anybody typed. `origin` and
144
+ * `actor` are the caller's, and they are what the Gate weighs and what the
145
+ * provenance records — putting a page back is still someone asking for a change.
146
+ */
147
+ export const reseedPage = async (path, request) => {
148
+ const head = await path.store.head(request.treeId);
149
+ if (!head.ok)
150
+ return { kind: "not-written", error: head.error };
151
+ const plan = planReseed(head.value, request.authored);
152
+ if (plan.outcome === "already-authored") {
153
+ return { kind: "already-authored", headRevision: plan.headRevision };
154
+ }
155
+ if (plan.outcome !== "reseedable")
156
+ return { kind: "not-reseedable", plan };
157
+ /**
158
+ * The cost is read before anything is proposed, and a log that cannot be read
159
+ * stops the reseed. Proposing it with an empty declaration would tell the Gate
160
+ * the log was clean, and the Gate would apply it over somebody's accepted edit.
161
+ */
162
+ const discards = await reseedDiscards(path.store, {
163
+ treeId: request.treeId,
164
+ operations: plan.operations,
165
+ });
166
+ if (!discards.ok)
167
+ return { kind: "not-written", error: discards.error };
168
+ const { idFactory, clock } = path.runtime;
169
+ const intent = {
170
+ intentId: idFactory.intentId(),
171
+ treeId: request.treeId,
172
+ baseRevision: plan.headRevision,
173
+ origin: request.origin,
174
+ ...(request.actor === undefined ? {} : { actor: request.actor }),
175
+ utterance: "Put this page back to the version in the repository.",
176
+ observedAt: clock.now(),
177
+ };
178
+ return commitIntent({
179
+ store: path.store,
180
+ holds: path.holds,
181
+ runtime: computedChangeRuntime(path.runtime, reseedInterpreter(plan, discards.value, idFactory, clock)),
182
+ }, intent);
183
+ };
184
+ //# sourceMappingURL=reseed.js.map
@@ -1,6 +1,7 @@
1
1
  import { inverseInterpreter } from "../runtime/inverse.js";
2
2
  import { describeRevertPlan, planRevert } from "../store/revert.js";
3
3
  import { commitIntent, describeWriteOutcome } from "./commit.js";
4
+ import { computedChangeRuntime } from "./computed.js";
4
5
  /**
5
6
  * Undo, as a change like any other.
6
7
  *
@@ -80,21 +81,6 @@ export const revertInterpreter = (plan, idFactory, clock) => inverseInterpreter(
80
81
  export const describeRevertOutcome = (outcome) => outcome.kind === "not-revertable"
81
82
  ? `not revertable: ${describeRevertPlan(outcome.plan)}`
82
83
  : describeWriteOutcome(outcome);
83
- /**
84
- * The same runtime, interpreting reverts.
85
- *
86
- * Built field by field rather than spread, so that dropping the repairer is a
87
- * statement instead of an omission: repair (0006) exists to let a model try a
88
- * smaller version of what the Gate refused, and there is no smaller version of
89
- * an undo. A revert the Gate refuses is refused.
90
- */
91
- const revertingRuntime = (runtime, interpreter) => ({
92
- interpreter,
93
- policySource: runtime.policySource,
94
- events: runtime.events,
95
- clock: runtime.clock,
96
- idFactory: runtime.idFactory,
97
- });
98
84
  /**
99
85
  * Undoes a revision, if the log allows it and the Gate agrees.
100
86
  *
@@ -128,7 +114,7 @@ export const revertRevision = async (path, request) => {
128
114
  return commitIntent({
129
115
  store: path.store,
130
116
  holds: path.holds,
131
- runtime: revertingRuntime(path.runtime, revertInterpreter(plan, idFactory, clock)),
117
+ runtime: computedChangeRuntime(path.runtime, revertInterpreter(plan, idFactory, clock)),
132
118
  }, intent);
133
119
  };
134
120
  //# sourceMappingURL=revert.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jam-overture/loom",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "description": "Loom — an AI-powered adaptive UI runtime",
5
5
  "license": "MIT",
6
6
  "author": "jam-overture",
@@ -36,10 +36,18 @@
36
36
  "types": "./dist/interpretation/anthropic.d.ts",
37
37
  "default": "./dist/interpretation/anthropic.js"
38
38
  },
39
+ "./openai-compatible": {
40
+ "types": "./dist/interpretation/openai-compatible.d.ts",
41
+ "default": "./dist/interpretation/openai-compatible.js"
42
+ },
39
43
  "./react": {
40
44
  "types": "./dist/render/index.d.ts",
41
45
  "default": "./dist/render/index.js"
42
46
  },
47
+ "./addressed": {
48
+ "types": "./dist/render/addressed.d.ts",
49
+ "default": "./dist/render/addressed.js"
50
+ },
43
51
  "./sdk": {
44
52
  "types": "./dist/sdk/index.d.ts",
45
53
  "default": "./dist/sdk/index.js"
@@ -60,6 +68,10 @@
60
68
  "types": "./dist/store/postgres.d.ts",
61
69
  "default": "./dist/store/postgres.js"
62
70
  },
71
+ "./live": {
72
+ "types": "./dist/live/index.d.ts",
73
+ "default": "./dist/live/index.js"
74
+ },
63
75
  "./signals": {
64
76
  "types": "./dist/signals/index.d.ts",
65
77
  "default": "./dist/signals/index.js"
@@ -118,6 +130,7 @@
118
130
  "devDependencies": {
119
131
  "@anthropic-ai/sdk": "^0.115.0",
120
132
  "@electric-sql/pglite": "^0.5.4",
133
+ "@types/jsdom": "^30.0.0",
121
134
  "@types/node": "^26.1.2",
122
135
  "@types/react": "^19.2.17",
123
136
  "@types/react-dom": "^19.2.3",
@@ -147,14 +160,23 @@
147
160
  "test": "vitest run",
148
161
  "test:watch": "vitest",
149
162
  "test:coverage": "vitest run --coverage",
150
- "verify": "pnpm build && pnpm typecheck && pnpm test && pnpm findings:check && pnpm --filter @loom/app verify && pnpm prerender:check",
163
+ "verify": "pnpm build && pnpm typecheck && pnpm test && pnpm findings:check && pnpm reports:check && pnpm --filter @loom/app verify && pnpm prerender:check",
151
164
  "findings:check": "tsx tools/findings/main.ts",
165
+ "fences": "tsx tools/sources/fences/generate.ts",
152
166
  "build": "tsc -p tsconfig.build.json",
153
167
  "clean": "rm -rf dist apps/loom/.next",
154
168
  "decisions:index": "tsx tools/decisions/build-index.ts",
155
169
  "prerender:check": "tsx tools/prerender/main.ts",
156
170
  "queue": "tsx tools/queue/main.ts",
171
+ "package:primitives": "tsx tools/package/main.ts",
157
172
  "shoot": "tsx tools/screenshot/shoot.ts",
158
- "specimen": "tsx tools/specimen/main.ts"
173
+ "weigh": "tsx tools/weigh/main.ts",
174
+ "posted": "tsx tools/posted/main.ts",
175
+ "specimen": "tsx tools/specimen/main.ts",
176
+ "reports:check": "tsx tools/reports/main.ts",
177
+ "reports:shrink": "tsx tools/reports/shrink.ts",
178
+ "portal:account": "pnpm --filter @loom/app portal:account",
179
+ "signals:key": "pnpm --filter @loom/app signals:key",
180
+ "simulate": "pnpm --filter @loom/app simulate"
159
181
  }
160
182
  }
@@ -1,90 +0,0 @@
1
- import type { IdFactory } from "../ids.js";
2
- import type { TreeOperation } from "../tree/delta.js";
3
- import type { Clock } from "./events.js";
4
- import type { ChangeInterpreter } from "./interpreter.js";
5
- import type { DiscardedWork } from "./proposal.js";
6
- /**
7
- * Proposing an inverse that is already in hand.
8
- *
9
- * The runtime computes the inverse of every change at assessment time
10
- * (`assessReversibility`), and until now the only way to *offer* one back was
11
- * `revertRevision`, which plans an undo by replaying a store. That is the right
12
- * path when the undo is being recovered from a log — it has to read one to know
13
- * what has been built on top since (0035).
14
- *
15
- * It is the wrong path, and an unreachable one, when the inverse never left the
16
- * process. A surface that composed a change and still holds the `Reversibility`
17
- * it produced has no log to replay and nothing to contest: the whole of what it
18
- * needs is the short piece between *here is an inverse* and *here is a proposal
19
- * the Gate can weigh*. `Loom marketing` wrote that piece by hand on 5 September
20
- * to make the front door's *Put it back* do what it says, and filed it, because
21
- * the alternative is every stateless surface rebuilding the same thirty lines
22
- * with its own idea of what an undo's provenance says.
23
- *
24
- * So this is the assembled version, and `revertInterpreter` is now it plus the
25
- * two things only a log can supply: a rationale naming the revision, and the
26
- * declaration of what applying it writes over.
27
- */
28
- /**
29
- * The inverse, as little of it as proposing one needs.
30
- *
31
- * A `TreeDelta` satisfies this, which is the common case — it is what
32
- * `Reversibility.inverse` hands back. A caller holding operations and the
33
- * revision they were computed against, and no delta yet, satisfies it too: the
34
- * delta id and tree id belong to the delta this proposes, not to the inverse it
35
- * proposes from.
36
- */
37
- export type ProposableInverse = {
38
- /** The revision the operations were computed against. */
39
- readonly baseRevision: number;
40
- readonly operations: readonly TreeOperation[];
41
- };
42
- /**
43
- * What the interpreter cannot compute, because it depends on where the inverse
44
- * came from.
45
- *
46
- * Both are required rather than defaulted. A default interpreter id would put
47
- * one stamp on undos planned by unrelated callers, and reading that stamp back
48
- * is how a surface tells an undo from a change — `(demo)` does exactly that
49
- * against `REVERT_INTERPRETER`. A default rationale would be the runtime
50
- * writing a sentence about a provenance it does not know, on the one field the
51
- * person answering a hold actually reads (0019).
52
- */
53
- export type InverseTerms = {
54
- /** What produced the delta, for `Provenance.interpreter`. Not a model. */
55
- readonly interpreter: string;
56
- /** Why, in the words the person answering a hold is shown. */
57
- readonly rationale: string;
58
- /**
59
- * Work applying this inverse would write over. Only a caller holding a log
60
- * can know of any, and absence keeps meaning "nobody looked at a log" rather
61
- * than "a log was checked and was clean" (0035).
62
- */
63
- readonly discards?: readonly DiscardedWork[];
64
- /**
65
- * The revision this puts back, recorded on the provenance the log keeps.
66
- *
67
- * Optional because not every inverse has one to name. A stateless surface
68
- * undoing a change it made in the same session has no revision — nothing was
69
- * ever appended — and stamping a number it does not have would be worse than
70
- * the absence. A caller that planned the undo off a log always does.
71
- */
72
- readonly undoes?: number;
73
- };
74
- /**
75
- * An interpreter that has nothing to interpret.
76
- *
77
- * The seam exists because interpretation is the non-deterministic step (0005),
78
- * not because it is always a model — and an undo is the case that proves the
79
- * seam was drawn in the right place. Everything downstream of it cannot tell
80
- * that no model was involved, which is exactly what makes an undo gateable on
81
- * the same terms as an AI-authored change.
82
- *
83
- * `confidence` is 1 because the inverse is computed, not guessed. That is the
84
- * honest self-grade (0007), and it is also why `authoredBy` is `runtime`: a 1
85
- * nobody graded is not a claim, and calibration (0031) segments these out of its
86
- * score rather than letting every undo walk the top band toward a perfect record
87
- * the model never earned.
88
- */
89
- export declare const inverseInterpreter: (inverse: ProposableInverse, terms: InverseTerms, idFactory: IdFactory, clock: Clock) => ChangeInterpreter;
90
- //# sourceMappingURL=inverse-interpreter.d.ts.map
@@ -1,56 +0,0 @@
1
- import { err, ok } from "../result.js";
2
- /**
3
- * An interpreter that has nothing to interpret.
4
- *
5
- * The seam exists because interpretation is the non-deterministic step (0005),
6
- * not because it is always a model — and an undo is the case that proves the
7
- * seam was drawn in the right place. Everything downstream of it cannot tell
8
- * that no model was involved, which is exactly what makes an undo gateable on
9
- * the same terms as an AI-authored change.
10
- *
11
- * `confidence` is 1 because the inverse is computed, not guessed. That is the
12
- * honest self-grade (0007), and it is also why `authoredBy` is `runtime`: a 1
13
- * nobody graded is not a claim, and calibration (0031) segments these out of its
14
- * score rather than letting every undo walk the top band toward a perfect record
15
- * the model never earned.
16
- */
17
- export const inverseInterpreter = (inverse, terms, idFactory, clock) => ({
18
- interpret: (intent, tree) => Promise.resolve(
19
- /**
20
- * An inverse is computed against one arrangement of a tree. Offering it
21
- * against another would be proposing something whose reasoning has
22
- * expired, so it declines rather than proposing. The write path refuses a
23
- * moved head before reaching here; this is what keeps the interpreter safe
24
- * to wire into a runtime directly, which a stateless caller does.
25
- */
26
- tree.revision === inverse.baseRevision
27
- ? ok({
28
- proposalId: idFactory.proposalId(),
29
- intentId: intent.intentId,
30
- delta: {
31
- deltaId: idFactory.deltaId(),
32
- treeId: tree.treeId,
33
- baseRevision: tree.revision,
34
- operations: inverse.operations,
35
- },
36
- rationale: terms.rationale,
37
- ...(terms.discards === undefined || terms.discards.length === 0
38
- ? {}
39
- : { discards: terms.discards }),
40
- provenance: {
41
- origin: intent.origin,
42
- ...(intent.actor === undefined ? {} : { actor: intent.actor }),
43
- interpreter: terms.interpreter,
44
- /** Computed, not inferred — so calibration leaves it out (0031). */
45
- authoredBy: "runtime",
46
- ...(terms.undoes === undefined ? {} : { undoes: terms.undoes }),
47
- confidence: 1,
48
- interpretedAt: clock.now(),
49
- },
50
- })
51
- : err({
52
- code: "refused",
53
- detail: `the inverse was computed against revision ${inverse.baseRevision}, and this tree is at ${tree.revision}`,
54
- })),
55
- });
56
- //# sourceMappingURL=inverse-interpreter.js.map