@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
@@ -4,9 +4,11 @@ import { primitiveTypeSchema } from "../primitive-type.js";
4
4
  import { assertNever } from "../result.js";
5
5
  import { dispositionReasonSchema, dispositionSchema, } from "../runtime/disposition.js";
6
6
  import { intentOriginSchema } from "../runtime/intent.js";
7
+ import { outOfTreeEffectTypesOf } from "../runtime/irreversibility.js";
7
8
  import { policyFingerprintOf } from "../runtime/policy-fingerprint.js";
8
9
  import { proposedChangeSchema } from "../runtime/proposal.js";
9
10
  import { stakeLevelSchema } from "../runtime/stake-level.js";
11
+ import { stakeFactorCodeSchema } from "../runtime/stakes.js";
10
12
  import { describeStoreError } from "../store/errors.js";
11
13
  import { describeTreeError } from "../tree/errors.js";
12
14
  /**
@@ -81,17 +83,72 @@ export const assessmentSummarySchema = z.object({
81
83
  configuredNodeCount: z.number().int().nonnegative(),
82
84
  touchedPrimitiveTypes: z.array(primitiveTypeSchema),
83
85
  /**
84
- * Bounded, non-identifying, a subset of the touched types, and the input to
85
- * the only `critical` stake factor. A corpus that cannot group by "the Gate
86
- * saw this type destroyed" cannot ask the question the factor exists for.
86
+ * Bounded, non-identifying, a subset of the touched types, and *which* types a
87
+ * removal destroyed. It was written as the input to "the only `critical` stake
88
+ * factor", which it no longer is — two later rules reach that level (0173,
89
+ * 0179), and `stakeFactorCodes` below carries all thirteen. What is left is
90
+ * the half a code cannot say: `protected-type-removed` says a rule fired, this
91
+ * says what it fired about.
87
92
  */
88
93
  removedPrimitiveTypes: z.array(primitiveTypeSchema).optional(),
89
94
  relocatedPrimitiveTypes: z.array(primitiveTypeSchema).optional(),
90
95
  relocatedNodeCount: z.number().int().nonnegative().optional(),
91
96
  shallowestAffectedDepth: z.number().int().nonnegative(),
97
+ /**
98
+ * How many nodes the change named, which is the one thing `broad-change`
99
+ * reads. `affectedNodeIds` itself is content — the ids name parts of a
100
+ * particular page and do not cross (0023) — and the rule compares its
101
+ * *length* against `breadthThreshold`, so the count is the whole of what a
102
+ * later reader needs and the ids never have to be journalled.
103
+ */
104
+ affectedNodeCount: z.number().int().nonnegative().optional(),
105
+ /**
106
+ * The prop names the change set, which is the only input to
107
+ * `protected-prop-configured`.
108
+ *
109
+ * Names and not values: a key is vocabulary the host registered, where a value
110
+ * is what a visitor will read. Bounded by the declaration that accepts them,
111
+ * for the reason `touchedPrimitiveTypes` is bounded by the catalogue.
112
+ */
113
+ configuredPropKeys: z.array(z.string().min(1)).optional(),
92
114
  /** Nodes the inverse would have to carry — the content a removal destroyed. */
93
115
  retainedNodeCount: z.number().int().nonnegative(),
94
116
  irreversibilityReasons: z.array(z.string().min(1)),
117
+ /**
118
+ * Which of the touched types this policy declared reach outside the page.
119
+ *
120
+ * `irreversibilityReasons` above keeps the codes, and for
121
+ * `retention-budget-exceeded` that is almost lossless — `retainedNodeCount`
122
+ * is journalled beside it, so a screen can say *this one takes nine parts off
123
+ * the page*. For `out-of-tree-effect` the code alone leaves a reader told to
124
+ * go and check something and not told what, and `touchedPrimitiveTypes` above
125
+ * cannot answer it: it is a superset, and naming one of its members as the
126
+ * offender would be a guess on the screen where a guess costs most.
127
+ *
128
+ * Non-identifying for the reason `removedPrimitiveTypes` above is: a type
129
+ * name is vocabulary the deployment registered, not content a visitor typed.
130
+ * Absent when no out-of-tree reason fired, and on a record written before the
131
+ * field existed (0045).
132
+ */
133
+ outOfTreeEffectTypes: z.array(primitiveTypeSchema).optional(),
134
+ /**
135
+ * Which rules the Gate raised, in the order it raised them (0198).
136
+ *
137
+ * `stakes` above is the highest level any of them reached, which is what the
138
+ * Gate compares against a ceiling and is not what a reader of the record wants
139
+ * to know. Three factors are `critical`, so *this project refused four changes
140
+ * as too risky* and *this project refused four changes because the model
141
+ * invented parts that do not exist here* were the same row, and only the
142
+ * second is something an operator can act on.
143
+ *
144
+ * The codes and not the factors: a code is one of thirteen fixed strings,
145
+ * while a factor's `detail` is a sentence naming nodes and types, which is
146
+ * content and does not cross (0023). The level does not cross either, because
147
+ * it is recoverable — twelve of the thirteen are fixed at their code, and
148
+ * `large-removal` is decided by `removedNodeCount` here against the
149
+ * `removalThresholds` of the policy `policyFingerprint` names.
150
+ */
151
+ stakeFactorCodes: z.array(stakeFactorCodeSchema).optional(),
95
152
  });
96
153
  export const telemetryEventSchema = z.discriminatedUnion("type", [
97
154
  z.object({ type: z.literal("intent-received"), intent: intentSummarySchema }),
@@ -222,23 +279,30 @@ const summariseIntent = (intent) => ({
222
279
  utteranceLength: intent.utterance.length,
223
280
  observedAt: intent.observedAt,
224
281
  });
225
- const summariseAssessment = (assessment) => ({
226
- proposalId: assessment.proposal.proposalId,
227
- stakes: assessment.stakes.level,
228
- reversible: assessment.reversibility.reversible,
229
- operationCount: assessment.analysis.operationCount,
230
- insertedNodeCount: assessment.analysis.insertedNodeCount,
231
- removedNodeCount: assessment.analysis.removedNodeCount,
232
- movedNodeCount: assessment.analysis.movedNodeCount,
233
- configuredNodeCount: assessment.analysis.configuredNodeCount,
234
- touchedPrimitiveTypes: assessment.analysis.touchedPrimitiveTypes,
235
- removedPrimitiveTypes: assessment.analysis.removedPrimitiveTypes,
236
- relocatedPrimitiveTypes: assessment.analysis.relocatedPrimitiveTypes,
237
- relocatedNodeCount: assessment.analysis.relocatedNodeCount,
238
- shallowestAffectedDepth: assessment.analysis.shallowestAffectedDepth,
239
- retainedNodeCount: assessment.reversibility.retainedNodeCount,
240
- irreversibilityReasons: assessment.reversibility.reasons.map((reason) => reason.code),
241
- });
282
+ const summariseAssessment = (assessment) => {
283
+ const outOfTreeEffectTypes = outOfTreeEffectTypesOf(assessment.reversibility.reasons);
284
+ return {
285
+ proposalId: assessment.proposal.proposalId,
286
+ stakes: assessment.stakes.level,
287
+ reversible: assessment.reversibility.reversible,
288
+ operationCount: assessment.analysis.operationCount,
289
+ insertedNodeCount: assessment.analysis.insertedNodeCount,
290
+ removedNodeCount: assessment.analysis.removedNodeCount,
291
+ movedNodeCount: assessment.analysis.movedNodeCount,
292
+ configuredNodeCount: assessment.analysis.configuredNodeCount,
293
+ touchedPrimitiveTypes: assessment.analysis.touchedPrimitiveTypes,
294
+ removedPrimitiveTypes: assessment.analysis.removedPrimitiveTypes,
295
+ relocatedPrimitiveTypes: assessment.analysis.relocatedPrimitiveTypes,
296
+ relocatedNodeCount: assessment.analysis.relocatedNodeCount,
297
+ shallowestAffectedDepth: assessment.analysis.shallowestAffectedDepth,
298
+ affectedNodeCount: assessment.analysis.affectedNodeIds.length,
299
+ configuredPropKeys: assessment.analysis.configuredPropKeys,
300
+ retainedNodeCount: assessment.reversibility.retainedNodeCount,
301
+ irreversibilityReasons: assessment.reversibility.reasons.map((reason) => reason.code),
302
+ ...(outOfTreeEffectTypes.length > 0 ? { outOfTreeEffectTypes } : {}),
303
+ stakeFactorCodes: assessment.stakes.factors.map((factor) => factor.code),
304
+ };
305
+ };
242
306
  /**
243
307
  * The narrowing, as one total function. Every variant is handled and the
244
308
  * exhaustiveness guard is what makes adding a `RuntimeEvent` a compile error
@@ -10,6 +10,8 @@ export * from "./episode.js";
10
10
  export * from "./event.js";
11
11
  export * from "./journal.js";
12
12
  export * from "./memory.js";
13
+ export * from "./remeasure.js";
13
14
  export * from "./retention.js";
14
15
  export * from "./sink.js";
16
+ export * from "./window.js";
15
17
  //# sourceMappingURL=index.d.ts.map
@@ -10,6 +10,8 @@ export * from "./episode.js";
10
10
  export * from "./event.js";
11
11
  export * from "./journal.js";
12
12
  export * from "./memory.js";
13
+ export * from "./remeasure.js";
13
14
  export * from "./retention.js";
14
15
  export * from "./sink.js";
16
+ export * from "./window.js";
15
17
  //# sourceMappingURL=index.js.map
@@ -1,7 +1,8 @@
1
- import type { TreeId } from "../ids.js";
1
+ import type { ProposalId, TreeId } from "../ids.js";
2
2
  import { type PageDirection, type PageEnds } from "../paging.js";
3
3
  import type { Result } from "../result.js";
4
- import type { TelemetryRecord } from "./event.js";
4
+ import type { AssessmentSummary, TelemetryRecord } from "./event.js";
5
+ import type { TelemetrySpan, TelemetryWindow } from "./window.js";
5
6
  /**
6
7
  * Where the narrated runtime goes to be read later.
7
8
  *
@@ -57,6 +58,23 @@ export type TelemetryReadRequest = {
57
58
  */
58
59
  readonly direction?: PageDirection;
59
60
  readonly limit?: number;
61
+ /**
62
+ * A stretch of wall-clock time, over `recordedAt`. Absent reads the whole
63
+ * journal, which is what every read did before windows existed.
64
+ *
65
+ * A window and a cursor are not alternatives and compose: the window says
66
+ * which records the read is about and the cursor says how far through them it
67
+ * has got. Paging a window walks that window and stops at its end — the
68
+ * `beyond` probe every implementation uses to name its cursors is taken
69
+ * *inside* the bound, so a reader paging to the end of last week is told it
70
+ * has reached the end of last week rather than handed a cursor out of it.
71
+ *
72
+ * One value rather than two bounds, because the two bounds are one idea and
73
+ * were checked against each other when `telemetryWindow` built them. A
74
+ * journal cannot be handed a window that is unreadable or runs backwards,
75
+ * which is why `TelemetryError` still has nothing to say about one.
76
+ */
77
+ readonly window?: TelemetryWindow;
60
78
  };
61
79
  export type TelemetryPage = PageEnds & {
62
80
  /**
@@ -68,6 +86,20 @@ export type TelemetryPage = PageEnds & {
68
86
  * responsible for knowing which — and silently wrong when it guessed.
69
87
  */
70
88
  readonly records: readonly RecordedTelemetry[];
89
+ /**
90
+ * The stretch this page turned out to cover, and `null` when it holds nothing.
91
+ *
92
+ * Beside the cursors rather than derived from the records by each consumer,
93
+ * because the two questions a paged journal is asked are *where am I* and
94
+ * *when is this* — and only the first had an answer. A consumer taking the
95
+ * ends off the first and last record gets an empty page wrong, and cannot
96
+ * tell *no answer* from *no time covered*.
97
+ *
98
+ * It is the page's own ends, never the window's: a window is what was asked
99
+ * for and may be wider at both ends than anything that landed in it, so a
100
+ * screen naming the window would overstate what it is describing.
101
+ */
102
+ readonly span: TelemetrySpan | null;
71
103
  };
72
104
  /**
73
105
  * Larger than a tree listing's, because these are read to be folded rather than
@@ -77,6 +109,56 @@ export type TelemetryPage = PageEnds & {
77
109
  export declare const DEFAULT_TELEMETRY_LIMIT = 200;
78
110
  export declare const MAX_TELEMETRY_LIMIT = 1000;
79
111
  export declare const clampTelemetryLimit: (limit: number | undefined) => number;
112
+ /**
113
+ * What a consumer asks when it is holding a list of proposals and wants the
114
+ * Gate's reading of each one.
115
+ *
116
+ * This is the join 0225 chose over a copy. The revision log holds a
117
+ * `proposalId` and no judgment, because 0016 makes the log the truth about the
118
+ * *page* and whether a change reached outside the page is not a fact about the
119
+ * page. The fact is therefore reachable, and until now only by paging a journal
120
+ * that grows forever — which on a screen showing twenty revisions is either
121
+ * twenty reads or a scan of everything ever narrated about the tree.
122
+ *
123
+ * `treeId` is the same filter `read` takes and the same thing it is there: a
124
+ * narrowing, not a boundary. What a handle may see at all is settled when the
125
+ * host builds it (0020), and a `proposalId` is unique without it.
126
+ */
127
+ export type AssessmentLookup = {
128
+ readonly proposalIds: readonly ProposalId[];
129
+ /** Absent looks across every tree the handle can see, as `read` does. */
130
+ readonly treeId?: TreeId;
131
+ };
132
+ /**
133
+ * The assessments that were found, and the ids this lookup did not reach.
134
+ *
135
+ * **A proposal nothing was recorded about is absent from the map, not an
136
+ * error** — the same reason there is no `not-found` above: a journal makes no
137
+ * claim that anything exists. A disposition without an assessment is a real
138
+ * history, not a fault; the Gate narrates `assessment-failed` when analysis
139
+ * itself fell over, and that record carries no summary to find.
140
+ *
141
+ * `unasked` exists because the alternative is a screen that quietly says
142
+ * nothing about a row. Every read in Loom is bounded, so a lookup naming more
143
+ * than `MAX_ASSESSMENT_LOOKUP` proposals cannot answer all of them in one call
144
+ * — and truncating silently would make *not looked up* and *nothing recorded*
145
+ * the same empty answer at the one place a reader is being asked to decide
146
+ * something. Naming the remainder costs one array and lets a caller chunk
147
+ * without arithmetic.
148
+ */
149
+ export type AssessmentLookupResult = {
150
+ readonly assessments: ReadonlyMap<ProposalId, AssessmentSummary>;
151
+ readonly unasked: readonly ProposalId[];
152
+ };
153
+ /**
154
+ * How many proposals one lookup answers, and it is a cap rather than a clamp.
155
+ *
156
+ * Deliberately larger than `MAX_LISTING_LIMIT`, so a caller that paged
157
+ * revisions at the store's widest page and asked about every one of them never
158
+ * meets this number. It bounds a hostile or careless caller and not the real
159
+ * one, which is the only job it has.
160
+ */
161
+ export declare const MAX_ASSESSMENT_LOOKUP = 400;
80
162
  /**
81
163
  * What a journal is asked to forget, expressed as a position rather than a rule.
82
164
  *
@@ -94,7 +176,7 @@ export type ForgetOutcome = {
94
176
  readonly removed: number;
95
177
  };
96
178
  /**
97
- * Three operations, and the asymmetry is deliberate: writes arrive in batches
179
+ * Four operations, and the asymmetry is deliberate: writes arrive in batches
98
180
  * because a request narrates several stages and should pay for one round trip
99
181
  * (0024), while reads are paged because a journal only grows.
100
182
  *
@@ -103,6 +185,12 @@ export type ForgetOutcome = {
103
185
  * it: an episode missing its disposition reads as a change that was proposed
104
186
  * and never judged, which is a fault report rather than a gap.
105
187
  *
188
+ * `assessments` is the only read that is not a page, and the exception earns
189
+ * itself: it answers about a *set of proposals a caller already holds* rather
190
+ * than about a position in the journal, so a cursor would be answering a
191
+ * question nobody asked. It is bounded all the same — by how many ids it will
192
+ * look at, which is the same promise a limit makes in a different currency.
193
+ *
106
194
  * `forget` is the only destructive operation anywhere in Loom's storage, and it
107
195
  * is on the journal rather than the store for the reason 0016 gives: telemetry
108
196
  * is narrowed from a log that keeps the truth, so forgetting it loses history
@@ -111,6 +199,19 @@ export type ForgetOutcome = {
111
199
  export interface TelemetryJournal {
112
200
  readonly record: (records: readonly TelemetryRecord[]) => Promise<Result<void, TelemetryError>>;
113
201
  readonly read: (request?: TelemetryReadRequest) => Promise<Result<TelemetryPage, TelemetryError>>;
202
+ readonly assessments: (request: AssessmentLookup) => Promise<Result<AssessmentLookupResult, TelemetryError>>;
114
203
  readonly forget: (request: ForgetRequest) => Promise<Result<ForgetOutcome, TelemetryError>>;
115
204
  }
205
+ /**
206
+ * The halves of the journal its two in-package consumers actually use.
207
+ *
208
+ * The argument is `TreeReader`'s, and a fourth method is the event that made it
209
+ * worth repeating here: depending on the whole journal to prune it or to write
210
+ * to it makes every stub of either grow a method the code under test never
211
+ * calls, which is how a test starts describing the interface instead of the
212
+ * behaviour. A `TelemetryJournal` satisfies both, so nothing a host builds
213
+ * changes.
214
+ */
215
+ export type TelemetryPruner = Pick<TelemetryJournal, "read" | "forget">;
216
+ export type TelemetryWriter = Pick<TelemetryJournal, "record">;
116
217
  //# sourceMappingURL=journal.d.ts.map
@@ -8,4 +8,13 @@ export const describeTelemetryError = (error) => `telemetry is unavailable: ${er
8
8
  export const DEFAULT_TELEMETRY_LIMIT = 200;
9
9
  export const MAX_TELEMETRY_LIMIT = 1000;
10
10
  export const clampTelemetryLimit = (limit) => clampLimit(limit, { fallback: DEFAULT_TELEMETRY_LIMIT, max: MAX_TELEMETRY_LIMIT });
11
+ /**
12
+ * How many proposals one lookup answers, and it is a cap rather than a clamp.
13
+ *
14
+ * Deliberately larger than `MAX_LISTING_LIMIT`, so a caller that paged
15
+ * revisions at the store's widest page and asked about every one of them never
16
+ * meets this number. It bounds a hostile or careless caller and not the real
17
+ * one, which is the only job it has.
18
+ */
19
+ export const MAX_ASSESSMENT_LOOKUP = 400;
11
20
  //# sourceMappingURL=journal.js.map
@@ -0,0 +1,27 @@
1
+ import type { ProposalId } from "../ids.js";
2
+ /**
3
+ * The arithmetic both journals do before they go looking, kept in one place so
4
+ * they cannot disagree about it.
5
+ *
6
+ * Deliberately not exported from the package. What a host needs to know is the
7
+ * cap and that a lookup says which ids it did not reach — both of which are on
8
+ * the contract. How the split is computed is not a published name, and a module
9
+ * nothing re-exports is the only way to say so (0045 is about fields; this is
10
+ * the same instinct about surface).
11
+ */
12
+ export type LookupSplit = {
13
+ /** Distinct, in the order the caller named them, capped. */
14
+ readonly asked: readonly ProposalId[];
15
+ readonly unasked: readonly ProposalId[];
16
+ };
17
+ /**
18
+ * Distinct first, then capped.
19
+ *
20
+ * The other order would let a caller spend its whole allowance on one id
21
+ * repeated four hundred times and be told the rest were unasked — true, and
22
+ * useless. Insertion order is kept because a caller that chunks `unasked` is
23
+ * walking its own list, and a lookup that reordered it would make the second
24
+ * call's result harder to line up than the first's.
25
+ */
26
+ export declare const splitLookup: (proposalIds: readonly ProposalId[]) => LookupSplit;
27
+ //# sourceMappingURL=lookup.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { MAX_ASSESSMENT_LOOKUP } from "./journal.js";
2
+ /**
3
+ * Distinct first, then capped.
4
+ *
5
+ * The other order would let a caller spend its whole allowance on one id
6
+ * repeated four hundred times and be told the rest were unasked — true, and
7
+ * useless. Insertion order is kept because a caller that chunks `unasked` is
8
+ * walking its own list, and a lookup that reordered it would make the second
9
+ * call's result harder to line up than the first's.
10
+ */
11
+ export const splitLookup = (proposalIds) => {
12
+ const distinct = [...new Set(proposalIds)];
13
+ return {
14
+ asked: distinct.slice(0, MAX_ASSESSMENT_LOOKUP),
15
+ unasked: distinct.slice(MAX_ASSESSMENT_LOOKUP),
16
+ };
17
+ };
18
+ //# sourceMappingURL=lookup.js.map
@@ -2,6 +2,8 @@ import { cursorPosition, pageEnds } from "../paging.js";
2
2
  import { ok } from "../result.js";
3
3
  import { systemClock } from "../runtime/events.js";
4
4
  import { clampTelemetryLimit, } from "./journal.js";
5
+ import { splitLookup } from "./lookup.js";
6
+ import { telemetrySpanOf, withinTelemetryWindow } from "./window.js";
5
7
  /**
6
8
  * The telemetry journal that keeps its records in the process.
7
9
  *
@@ -43,8 +45,15 @@ export const memoryTelemetryJournal = (clock = systemClock) => {
43
45
  const limit = clampTelemetryLimit(request?.limit);
44
46
  const from = cursorPosition(request?.cursor);
45
47
  const direction = request?.direction ?? "newer";
48
+ /**
49
+ * The window is applied here, before the limit, which is what makes the
50
+ * `beyond` probe below a statement about the window rather than about the
51
+ * journal. Filtering after the slice would hand back a short page and a
52
+ * cursor pointing at a record the window excludes.
53
+ */
46
54
  const matching = records.filter((record) => (request?.treeId === undefined || record.treeId === request.treeId) &&
47
- (from === undefined || (direction === "older" ? record.seq < from : record.seq > from)));
55
+ (from === undefined || (direction === "older" ? record.seq < from : record.seq > from)) &&
56
+ withinTelemetryWindow(request?.window, record.recordedAt));
48
57
  /**
49
58
  * `older` takes the page from the far end, which is a slice rather than a
50
59
  * reverse: the records that come back are still in arrival order, because
@@ -53,12 +62,35 @@ export const memoryTelemetryJournal = (clock = systemClock) => {
53
62
  const page = direction === "older" ? matching.slice(-limit) : matching.slice(0, limit);
54
63
  return Promise.resolve(ok({
55
64
  records: page,
65
+ span: telemetrySpanOf(page),
56
66
  ...pageEnds(page.map((record) => record.seq), direction, {
57
67
  beyond: matching.length > page.length,
58
68
  resumed: from !== undefined,
59
69
  }),
60
70
  }));
61
71
  },
72
+ /**
73
+ * A scan, because an array has no index — and the reference implementation
74
+ * is where the contract is written, not where it is made fast. What it has
75
+ * to get right is the answer: the *latest* assessment of a proposal wins, so
76
+ * it folds in arrival order and lets a later record overwrite an earlier
77
+ * one.
78
+ */
79
+ assessments: ({ proposalIds, treeId }) => {
80
+ const { asked, unasked } = splitLookup(proposalIds);
81
+ const wanted = new Set(asked);
82
+ const found = new Map();
83
+ for (const record of records) {
84
+ if (treeId !== undefined && record.treeId !== treeId)
85
+ continue;
86
+ if (record.event.type !== "change-assessed")
87
+ continue;
88
+ if (!wanted.has(record.event.assessment.proposalId))
89
+ continue;
90
+ found.set(record.event.assessment.proposalId, record.event.assessment);
91
+ }
92
+ return Promise.resolve(ok({ assessments: found, unasked }));
93
+ },
62
94
  /**
63
95
  * `nextSeq` is deliberately not rewound. A forgotten position must never be
64
96
  * handed out again: a cursor a reader is holding across a prune would
@@ -22,13 +22,34 @@ import { sql } from "drizzle-orm";
22
22
  */
23
23
  export const TELEMETRY_DDL = [
24
24
  `CREATE TABLE IF NOT EXISTS loom_telemetry (
25
+ application_id text NOT NULL DEFAULT 'app_default',
25
26
  seq bigserial PRIMARY KEY,
26
27
  tree_id text NOT NULL,
27
28
  occurred_at text NOT NULL,
28
29
  event jsonb NOT NULL,
29
30
  recorded_at timestamptz NOT NULL DEFAULT now()
30
31
  )`,
31
- `CREATE INDEX IF NOT EXISTS loom_telemetry_tree_seq_idx ON loom_telemetry (tree_id, seq)`,
32
+ /*
33
+ * **The project, for a database that predates it (0260).** No key widens
34
+ * here — `seq` is a surrogate and stays unique across the deployment, for the
35
+ * reason `schema.ts` gives. What changes is that both indexes lead with the
36
+ * project, so a read inside one does not walk another's rows.
37
+ *
38
+ * Dropped by name rather than created `IF NOT EXISTS`, because the names do
39
+ * not change: an existing index on the old columns would be left exactly as
40
+ * it was, and every read would go on scanning while appearing to be indexed.
41
+ */
42
+ `ALTER TABLE loom_telemetry ADD COLUMN IF NOT EXISTS application_id text NOT NULL DEFAULT 'app_default'`,
43
+ `DROP INDEX IF EXISTS loom_telemetry_tree_seq_idx`,
44
+ `CREATE INDEX IF NOT EXISTS loom_telemetry_tree_seq_idx ON loom_telemetry (application_id, tree_id, seq)`,
45
+ /**
46
+ * Additive, idempotent, and the only statement here that is not about the
47
+ * table's shape: it is what makes `assessments` on the journal a seek rather
48
+ * than a scan of everything ever narrated. A deployment that runs the DDL
49
+ * again gets it; one that never does keeps a correct journal and a slow lookup.
50
+ */
51
+ `DROP INDEX IF EXISTS loom_telemetry_assessed_proposal_idx`,
52
+ `CREATE INDEX IF NOT EXISTS loom_telemetry_assessed_proposal_idx ON loom_telemetry (application_id, (event -> 'assessment' ->> 'proposalId')) WHERE event ->> 'type' = 'change-assessed'`,
32
53
  `ALTER TABLE loom_telemetry ENABLE ROW LEVEL SECURITY`,
33
54
  ];
34
55
  /** Idempotent, so running it against a populated database is a no-op. */
@@ -1,6 +1,15 @@
1
+ import { type StoreScope } from "../application/application.js";
1
2
  import type { LoomDatabase } from "../store/database.js";
2
3
  import { type TelemetryJournal } from "./journal.js";
3
4
  export * from "./migrate.js";
4
5
  export * from "./schema.js";
5
- export declare const postgresTelemetryJournal: (db: LoomDatabase) => TelemetryJournal;
6
+ /**
7
+ * Every query is filtered by the project this handle speaks for (0260), and
8
+ * every write sets it.
9
+ *
10
+ * `seq` is not scoped and does not need to be — see `schema.ts`. What is scoped
11
+ * is every row this handle will ever see, so one project's gate decisions
12
+ * cannot appear on another's screen.
13
+ */
14
+ export declare const postgresTelemetryJournal: (db: LoomDatabase, scope?: StoreScope) => TelemetryJournal;
6
15
  //# sourceMappingURL=postgres.d.ts.map