@jam-overture/loom 0.1.0 → 0.2.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 (290) 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/cli/templates.js +19 -0
  11. package/dist/data/plan.js +0 -0
  12. package/dist/data/resolution.d.ts +23 -1
  13. package/dist/data/resolve.d.ts +30 -3
  14. package/dist/data/resolve.js +11 -3
  15. package/dist/ids.d.ts +10 -0
  16. package/dist/ids.js +11 -1
  17. package/dist/index.d.ts +1 -0
  18. package/dist/index.js +1 -0
  19. package/dist/patch.d.ts +54 -0
  20. package/dist/patch.js +44 -0
  21. package/dist/project/closing.d.ts +51 -0
  22. package/dist/project/closing.js +53 -0
  23. package/dist/project/memory.d.ts +20 -0
  24. package/dist/project/memory.js +97 -0
  25. package/dist/project/project.d.ts +90 -0
  26. package/dist/project/project.js +91 -0
  27. package/dist/project/store.d.ts +135 -0
  28. package/dist/project/store.js +41 -0
  29. package/dist/registered.d.ts +64 -0
  30. package/dist/registered.js +118 -0
  31. package/dist/render/behaviour-adjust.d.ts +11 -19
  32. package/dist/render/behaviour-adjust.js +75 -21
  33. package/dist/render/behaviour-present.d.ts +8 -0
  34. package/dist/render/behaviour-present.js +57 -6
  35. package/dist/render/behaviour.d.ts +98 -17
  36. package/dist/render/behaviour.js +91 -26
  37. package/dist/render/control-name.d.ts +68 -0
  38. package/dist/render/control-name.js +37 -0
  39. package/dist/render/diagnostics.d.ts +72 -0
  40. package/dist/render/diagnostics.js +7 -0
  41. package/dist/render/index.d.ts +2 -0
  42. package/dist/render/index.js +2 -0
  43. package/dist/render/reads.d.ts +11 -0
  44. package/dist/render/reads.js +12 -1
  45. package/dist/render/render.js +102 -7
  46. package/dist/render/slots.d.ts +52 -0
  47. package/dist/render/slots.js +24 -0
  48. package/dist/render/theme.d.ts +54 -1
  49. package/dist/render/theme.js +23 -1
  50. package/dist/render/unshown.d.ts +152 -0
  51. package/dist/render/unshown.js +80 -0
  52. package/dist/runtime/analysis.d.ts +94 -9
  53. package/dist/runtime/analysis.js +54 -9
  54. package/dist/runtime/assessment.d.ts +36 -2
  55. package/dist/runtime/assessment.js +27 -2
  56. package/dist/runtime/checks.d.ts +148 -0
  57. package/dist/runtime/checks.js +112 -0
  58. package/dist/runtime/disposition.d.ts +96 -0
  59. package/dist/runtime/disposition.js +46 -0
  60. package/dist/runtime/gate.js +22 -0
  61. package/dist/runtime/index.d.ts +3 -0
  62. package/dist/runtime/index.js +3 -0
  63. package/dist/runtime/irreversibility.d.ts +64 -0
  64. package/dist/runtime/irreversibility.js +45 -0
  65. package/dist/runtime/pipeline.d.ts +43 -0
  66. package/dist/runtime/pipeline.js +10 -2
  67. package/dist/runtime/policy-change.d.ts +93 -0
  68. package/dist/runtime/policy-change.js +299 -0
  69. package/dist/runtime/policy-log.d.ts +406 -0
  70. package/dist/runtime/policy-log.js +285 -0
  71. package/dist/runtime/reversibility.d.ts +11 -9
  72. package/dist/runtime/stakes.d.ts +129 -1
  73. package/dist/runtime/stakes.js +240 -26
  74. package/dist/runtime/vocabulary.d.ts +164 -7
  75. package/dist/runtime/vocabulary.js +181 -8
  76. package/dist/sdk/audit.d.ts +174 -3
  77. package/dist/sdk/audit.js +176 -17
  78. package/dist/sdk/catalogue.d.ts +9 -1
  79. package/dist/sdk/conformance.d.ts +37 -3
  80. package/dist/sdk/conformance.js +25 -4
  81. package/dist/sdk/definition.d.ts +65 -0
  82. package/dist/sdk/definition.js +22 -0
  83. package/dist/sdk/registry.d.ts +29 -2
  84. package/dist/sdk/registry.js +63 -1
  85. package/dist/signals/action-change.d.ts +507 -0
  86. package/dist/signals/action-change.js +265 -0
  87. package/dist/signals/action.d.ts +331 -0
  88. package/dist/signals/action.js +182 -0
  89. package/dist/signals/applied-window.contract.d.ts +23 -0
  90. package/dist/signals/applied-window.contract.js +160 -0
  91. package/dist/signals/arriving.d.ts +210 -0
  92. package/dist/signals/arriving.js +133 -0
  93. package/dist/signals/audiences.d.ts +528 -0
  94. package/dist/signals/audiences.js +255 -0
  95. package/dist/signals/broadcast.d.ts +8 -2
  96. package/dist/signals/broadcast.js +58 -8
  97. package/dist/signals/change.d.ts +378 -0
  98. package/dist/signals/change.js +327 -0
  99. package/dist/signals/collect.d.ts +41 -0
  100. package/dist/signals/collect.js +88 -7
  101. package/dist/signals/copy-change.d.ts +553 -0
  102. package/dist/signals/copy-change.js +377 -0
  103. package/dist/signals/copy.d.ts +337 -0
  104. package/dist/signals/copy.js +211 -0
  105. package/dist/signals/counters.d.ts +46 -0
  106. package/dist/signals/counters.js +102 -0
  107. package/dist/signals/deliver.d.ts +23 -4
  108. package/dist/signals/deliver.js +34 -6
  109. package/dist/signals/deployment-change.d.ts +371 -0
  110. package/dist/signals/deployment-change.js +268 -0
  111. package/dist/signals/deployment.d.ts +265 -0
  112. package/dist/signals/deployment.js +152 -0
  113. package/dist/signals/door.d.ts +92 -0
  114. package/dist/signals/door.js +53 -0
  115. package/dist/signals/fold.d.ts +10 -0
  116. package/dist/signals/fold.js +5 -1
  117. package/dist/signals/form-action.d.ts +302 -0
  118. package/dist/signals/form-action.js +169 -0
  119. package/dist/signals/form-copy.d.ts +523 -0
  120. package/dist/signals/form-copy.js +346 -0
  121. package/dist/signals/forms.d.ts +247 -0
  122. package/dist/signals/forms.js +147 -0
  123. package/dist/signals/funnel-change.d.ts +548 -0
  124. package/dist/signals/funnel-change.js +361 -0
  125. package/dist/signals/funnel.d.ts +532 -0
  126. package/dist/signals/funnel.js +216 -0
  127. package/dist/signals/health.d.ts +497 -0
  128. package/dist/signals/health.js +361 -0
  129. package/dist/signals/index.d.ts +41 -0
  130. package/dist/signals/index.js +41 -0
  131. package/dist/signals/ingest.d.ts +56 -1
  132. package/dist/signals/ingest.js +91 -1
  133. package/dist/signals/journal.d.ts +11 -0
  134. package/dist/signals/kinds.d.ts +8 -6
  135. package/dist/signals/kinds.js +14 -6
  136. package/dist/signals/library-action.d.ts +430 -0
  137. package/dist/signals/library-action.js +336 -0
  138. package/dist/signals/library-change.d.ts +477 -0
  139. package/dist/signals/library-change.js +335 -0
  140. package/dist/signals/library-copy-change.d.ts +498 -0
  141. package/dist/signals/library-copy-change.js +476 -0
  142. package/dist/signals/library-pace.d.ts +319 -0
  143. package/dist/signals/library-pace.js +305 -0
  144. package/dist/signals/library-reach-change.d.ts +636 -0
  145. package/dist/signals/library-reach-change.js +534 -0
  146. package/dist/signals/library-reach.d.ts +377 -0
  147. package/dist/signals/library-reach.js +227 -0
  148. package/dist/signals/library-word-reach-change.d.ts +567 -0
  149. package/dist/signals/library-word-reach-change.js +568 -0
  150. package/dist/signals/library.d.ts +306 -0
  151. package/dist/signals/library.js +178 -0
  152. package/dist/signals/memory.d.ts +9 -0
  153. package/dist/signals/memory.js +105 -14
  154. package/dist/signals/migrate.d.ts +17 -2
  155. package/dist/signals/migrate.js +122 -5
  156. package/dist/signals/notice.d.ts +334 -0
  157. package/dist/signals/notice.js +228 -0
  158. package/dist/signals/pace-change.d.ts +501 -0
  159. package/dist/signals/pace-change.js +310 -0
  160. package/dist/signals/pace.d.ts +296 -0
  161. package/dist/signals/pace.js +291 -0
  162. package/dist/signals/page-views.d.ts +365 -0
  163. package/dist/signals/page-views.js +218 -0
  164. package/dist/signals/parts.d.ts +344 -0
  165. package/dist/signals/parts.js +273 -0
  166. package/dist/signals/postgres.d.ts +16 -2
  167. package/dist/signals/postgres.js +390 -87
  168. package/dist/signals/progress.d.ts +212 -0
  169. package/dist/signals/progress.js +150 -0
  170. package/dist/signals/ratios.d.ts +108 -0
  171. package/dist/signals/ratios.js +40 -0
  172. package/dist/signals/reach.d.ts +309 -0
  173. package/dist/signals/reach.js +93 -0
  174. package/dist/signals/readable.d.ts +34 -0
  175. package/dist/signals/readable.js +34 -0
  176. package/dist/signals/readership.d.ts +381 -0
  177. package/dist/signals/readership.js +308 -0
  178. package/dist/signals/region-pages.d.ts +173 -0
  179. package/dist/signals/region-pages.js +62 -0
  180. package/dist/signals/region.d.ts +287 -0
  181. package/dist/signals/region.js +198 -0
  182. package/dist/signals/retention.d.ts +141 -0
  183. package/dist/signals/retention.js +58 -0
  184. package/dist/signals/rollup.d.ts +67 -3
  185. package/dist/signals/rollup.js +0 -0
  186. package/dist/signals/schema.d.ts +432 -1
  187. package/dist/signals/schema.js +157 -3
  188. package/dist/signals/signal.d.ts +237 -11
  189. package/dist/signals/signal.js +70 -10
  190. package/dist/signals/silence-census.d.ts +205 -0
  191. package/dist/signals/silence-census.js +87 -0
  192. package/dist/signals/silences.d.ts +848 -0
  193. package/dist/signals/silences.js +753 -0
  194. package/dist/signals/tally.d.ts +140 -11
  195. package/dist/signals/window-figures.d.ts +148 -0
  196. package/dist/signals/window-figures.js +42 -0
  197. package/dist/signals/window.d.ts +866 -0
  198. package/dist/signals/window.js +693 -0
  199. package/dist/signals/words.d.ts +24 -0
  200. package/dist/signals/words.js +24 -0
  201. package/dist/store/index.d.ts +19 -0
  202. package/dist/store/index.js +19 -0
  203. package/dist/store/memory.d.ts +2 -1
  204. package/dist/store/memory.js +48 -12
  205. package/dist/store/migrate.d.ts +80 -0
  206. package/dist/store/migrate.js +259 -7
  207. package/dist/store/postgres-applications.d.ts +4 -0
  208. package/dist/store/postgres-applications.js +197 -0
  209. package/dist/store/postgres-holds.d.ts +10 -1
  210. package/dist/store/postgres-holds.js +116 -101
  211. package/dist/store/postgres-policy-log.d.ts +14 -0
  212. package/dist/store/postgres-policy-log.js +240 -0
  213. package/dist/store/postgres-projects.d.ts +4 -0
  214. package/dist/store/postgres-projects.js +217 -0
  215. package/dist/store/postgres.d.ts +16 -1
  216. package/dist/store/postgres.js +59 -9
  217. package/dist/store/replay.d.ts +102 -1
  218. package/dist/store/replay.js +190 -19
  219. package/dist/store/reseed.d.ts +238 -0
  220. package/dist/store/reseed.js +308 -0
  221. package/dist/store/schema.d.ts +450 -2
  222. package/dist/store/schema.js +141 -5
  223. package/dist/store/store.d.ts +29 -6
  224. package/dist/submit/resolve.js +2 -1
  225. package/dist/telemetry/calibration.d.ts +25 -0
  226. package/dist/telemetry/calibration.js +27 -1
  227. package/dist/telemetry/event.d.ts +391 -33
  228. package/dist/telemetry/event.js +84 -20
  229. package/dist/telemetry/index.d.ts +1 -0
  230. package/dist/telemetry/index.js +1 -0
  231. package/dist/telemetry/journal.d.ts +72 -3
  232. package/dist/telemetry/journal.js +9 -0
  233. package/dist/telemetry/lookup.d.ts +27 -0
  234. package/dist/telemetry/lookup.js +18 -0
  235. package/dist/telemetry/memory.js +23 -0
  236. package/dist/telemetry/migrate.js +22 -1
  237. package/dist/telemetry/postgres.d.ts +10 -1
  238. package/dist/telemetry/postgres.js +172 -90
  239. package/dist/telemetry/remeasure.d.ts +78 -0
  240. package/dist/telemetry/remeasure.js +83 -0
  241. package/dist/telemetry/retention.d.ts +2 -2
  242. package/dist/telemetry/schema.d.ts +17 -0
  243. package/dist/telemetry/schema.js +27 -1
  244. package/dist/telemetry/sink.d.ts +2 -2
  245. package/dist/testing/application-contract.d.ts +14 -0
  246. package/dist/testing/application-contract.js +270 -0
  247. package/dist/testing/contracts.d.ts +12 -7
  248. package/dist/testing/contracts.js +12 -7
  249. package/dist/testing/definitions.d.ts +78 -0
  250. package/dist/testing/definitions.js +134 -9
  251. package/dist/testing/doubles.d.ts +103 -0
  252. package/dist/testing/doubles.js +143 -0
  253. package/dist/testing/index.d.ts +2 -2
  254. package/dist/testing/index.js +2 -2
  255. package/dist/testing/journal-contract.js +140 -2
  256. package/dist/testing/model-contract.d.ts +110 -0
  257. package/dist/testing/model-contract.js +150 -0
  258. package/dist/testing/policy-log-contract.d.ts +26 -0
  259. package/dist/testing/policy-log-contract.js +344 -0
  260. package/dist/testing/project-contract.d.ts +14 -0
  261. package/dist/testing/project-contract.js +266 -0
  262. package/dist/testing/reader-signal-contract.d.ts +27 -2
  263. package/dist/testing/reader-signal-contract.js +475 -5
  264. package/dist/testing/store-contract.d.ts +7 -1
  265. package/dist/testing/store-contract.js +84 -3
  266. package/dist/theme/apply.d.ts +20 -1
  267. package/dist/theme/apply.js +5 -3
  268. package/dist/theme/derive.d.ts +22 -0
  269. package/dist/theme/derive.js +54 -1
  270. package/dist/theme/library.js +1 -1
  271. package/dist/theme/measure.d.ts +34 -0
  272. package/dist/theme/measure.js +30 -1
  273. package/dist/theme/palettes.js +7 -7
  274. package/dist/theme/ramp.d.ts +64 -0
  275. package/dist/theme/ramp.js +114 -0
  276. package/dist/theme/registry.d.ts +9 -0
  277. package/dist/theme/registry.js +11 -1
  278. package/dist/theme/separation.d.ts +97 -3
  279. package/dist/theme/separation.js +75 -0
  280. package/dist/tree/compare.d.ts +9 -0
  281. package/dist/tree/compare.js +18 -0
  282. package/dist/write/computed.d.ts +60 -0
  283. package/dist/write/computed.js +61 -0
  284. package/dist/write/held.d.ts +59 -0
  285. package/dist/write/index.d.ts +5 -2
  286. package/dist/write/index.js +5 -2
  287. package/dist/write/reseed.d.ts +151 -0
  288. package/dist/write/reseed.js +184 -0
  289. package/dist/write/revert.js +2 -16
  290. package/package.json +98 -19
@@ -58,15 +58,31 @@ export type AppendRequest = {
58
58
  /**
59
59
  * What a listing says about a tree without loading it.
60
60
  *
61
- * `revision` is the whole summary, and it is enough: it starts at 0 and
62
- * increments once per accepted delta, so it is also the number of entries in the
63
- * log. There is no timestamp because a `LoomTree` carries none — §1 kept time out
64
- * of the document deliberately, and a listing that invented one would be a field
65
- * only some implementations could fill honestly.
61
+ * `revision` starts at 0 and increments once per accepted delta, so it is also
62
+ * the number of entries in the log.
63
+ *
64
+ * `changedAt` is the stamped field 0020 named as the way out of its own
65
+ * ordering decision, and it is not invented here: it is the `appliedAt` of the
66
+ * newest entry in that tree's log, which is the same clock `StoredRevision`
67
+ * already publishes and the same value a caller reading `revisions` would see.
68
+ * A `LoomTree` still carries no time of its own — §1 kept time out of the
69
+ * document, and this is the store's fact about the tree rather than the
70
+ * document's fact about itself, which is why it can be told honestly here and
71
+ * could not be told there.
72
+ *
73
+ * **Absent means the tree has never been appended to**, which is exactly
74
+ * `revision === 0`: a tree is created without a log entry, and a store that
75
+ * filled this with the creation time would be answering a question nobody
76
+ * asked — *when did this appear* is not *when did this change*, and 0020 is
77
+ * explicit that `create` takes no stamp the way `append` takes an `appliedAt`.
78
+ * A reader may rely on the two agreeing: `changedAt` is present if and only if
79
+ * `revision` is greater than 0.
66
80
  */
67
81
  export type TreeListing = {
68
82
  readonly treeId: TreeId;
69
83
  readonly revision: number;
84
+ /** The newest log entry's `appliedAt`; absent when `revision` is 0. */
85
+ readonly changedAt?: string;
70
86
  };
71
87
  export type ListRequest = {
72
88
  /**
@@ -210,7 +226,14 @@ export declare const clampListingLimit: (limit: number | undefined) => number;
210
226
  * **Pages are ordered by `treeId`, ascending.** Not by recency, however much a
211
227
  * portal would prefer it: ordering has to be total and stable for a cursor to
212
228
  * mean anything, and `treeId` is the only key every implementation is guaranteed
213
- * to have. Recency is a view over data the store does not hold.
229
+ * to have.
230
+ *
231
+ * Recency is no longer a view over data the store does not hold — every listing
232
+ * carries `changedAt` (0277) — but the *order* is still by id, and that half of
233
+ * 0020 stands until somebody decides the second one. A caller sorting a page it
234
+ * holds is sorting that page and not the store: beyond one page, the newest
235
+ * tree overall may sit on a page this caller never asked for. Ordering by
236
+ * recency is proposed separately and is not implemented.
214
237
  */
215
238
  export interface TreeStore {
216
239
  readonly create: (tree: LoomTree) => Promise<Result<LoomTree, StoreError>>;
@@ -1,4 +1,5 @@
1
1
  import { ceilingOf, describeCeiling, withCeiling } from "../deadline.js";
2
+ import { describeRegistered } from "../registered.js";
2
3
  import { err } from "../result.js";
3
4
  import { planTreeSubmissions, submissionPlanIsEmpty } from "./plan.js";
4
5
  import { buildSubmissionResolution, EMPTY_SUBMISSION_RESOLUTION, } from "./resolution.js";
@@ -16,7 +17,7 @@ const askOne = async (to, options) => {
16
17
  if (!registered) {
17
18
  return err({
18
19
  reason: "no-such-endpoint",
19
- detail: `registered: ${options.registry.endpoints.map((entry) => entry.id).join(", ") || "none"}`,
20
+ detail: `registered: ${describeRegistered(to, options.registry.endpoints.map((entry) => entry.id))}`,
20
21
  });
21
22
  }
22
23
  const ceiling = ceilingOf(options.ceilingMs, DEFAULT_ENDPOINT_CEILING_MS);
@@ -1,3 +1,4 @@
1
+ import { type WriteCheck } from "../runtime/checks.js";
1
2
  import type { EpisodeFold, ProposalEpisode } from "./episode.js";
2
3
  /**
3
4
  * Confidence is self-graded and trusted on purpose, on one condition: that it
@@ -97,6 +98,30 @@ export type PolicyCalibration = {
97
98
  * of length one would say it was.
98
99
  */
99
100
  readonly unfingerprinted: number;
101
+ /**
102
+ * The distinct sets of optional write-path checks the judgments in this
103
+ * segment were made under, each in canonical order.
104
+ *
105
+ * The fingerprint above proves which *rules* judged these claims and cannot
106
+ * reach the two seams a composition root hands over separately, either of
107
+ * which can turn an `accepted` into a `rejected` (0179, 0208). So a segment
108
+ * whose `fingerprints` has one member is a segment that was judged under one
109
+ * set of rules, and this is the rest of the sentence: whether it was judged by
110
+ * one write path. More than one member here and a survival rate that moved is
111
+ * explained by the wiring rather than by the model.
112
+ *
113
+ * Sets rather than a verdict, for the reason `fingerprints` is a list rather
114
+ * than a `RulesetContinuity`: `checksContinuityOf` reads this, and the lists
115
+ * themselves are what a host matches against its own composition root.
116
+ */
117
+ readonly checkSets: readonly (readonly WriteCheck[])[];
118
+ /**
119
+ * Judged claims in this segment whose disposition named no check list. Kept
120
+ * beside the sets for the reason `unfingerprinted` is kept beside the
121
+ * fingerprints: one set plus twelve judgments that recorded none is not a
122
+ * segment shown to have been judged by one write path.
123
+ */
124
+ readonly unrecordedChecks: number;
100
125
  };
101
126
  export type CalibrationReport = {
102
127
  readonly overall: CalibrationScore;
@@ -1,4 +1,5 @@
1
1
  import { everyMemberOf } from "../closed-set.js";
2
+ import { canonicalChecksOf } from "../runtime/checks.js";
2
3
  /**
3
4
  * The buckets a fold has to open before the first proposal arrives, so a reason
4
5
  * nobody hit still reads as zero rather than as missing.
@@ -106,7 +107,13 @@ export const calibrationOf = (fold) => {
106
107
  const existing = byPolicy.get(policyId);
107
108
  if (existing)
108
109
  return existing;
109
- const fresh = { bands: emptyBands(), fingerprints: new Set(), unfingerprinted: 0 };
110
+ const fresh = {
111
+ bands: emptyBands(),
112
+ fingerprints: new Set(),
113
+ unfingerprinted: 0,
114
+ checkSets: new Map(),
115
+ unrecordedChecks: 0,
116
+ };
110
117
  byPolicy.set(policyId, fresh);
111
118
  return fresh;
112
119
  };
@@ -131,6 +138,13 @@ export const calibrationOf = (fold) => {
131
138
  segment.unfingerprinted += 1;
132
139
  else
133
140
  segment.fingerprints.add(fingerprint);
141
+ const wired = proposal.disposition?.wiredChecks;
142
+ if (wired === undefined)
143
+ segment.unrecordedChecks += 1;
144
+ else {
145
+ const canonical = canonicalChecksOf(wired);
146
+ segment.checkSets.set(canonical.join(","), canonical);
147
+ }
134
148
  }
135
149
  }
136
150
  return {
@@ -142,6 +156,18 @@ export const calibrationOf = (fold) => {
142
156
  buckets: bucketsOf(segment.bands),
143
157
  fingerprints: Array.from(segment.fingerprints).sort(),
144
158
  unfingerprinted: segment.unfingerprinted,
159
+ /**
160
+ * Looked back up by key rather than carried out of the map's values, so
161
+ * the order is the canonical key's and a `flatMap` over arrays cannot
162
+ * quietly flatten the sets into one list.
163
+ */
164
+ checkSets: Array.from(segment.checkSets.keys())
165
+ .sort()
166
+ .flatMap((key) => {
167
+ const set = segment.checkSets.get(key);
168
+ return set === undefined ? [] : [set];
169
+ }),
170
+ unrecordedChecks: segment.unrecordedChecks,
145
171
  })).sort(byPolicyName),
146
172
  unjudged,
147
173
  unattributed: fold.unattributed.length,