@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
@@ -0,0 +1,299 @@
1
+ import { policyFingerprintOf } from "./policy-fingerprint.js";
2
+ import { compareStakes } from "./stake-level.js";
3
+ const compareStrings = (left, right) => left < right ? -1 : left > right ? 1 : 0;
4
+ const sorted = (values) => Array.from(new Set(values)).sort(compareStrings);
5
+ const missingFrom = (members, other) => {
6
+ const held = new Set(other);
7
+ return members.filter((member) => !held.has(member));
8
+ };
9
+ const list = (members) => members.join(", ");
10
+ /**
11
+ * The direction a gained-and-lost pair points in, given what gaining means.
12
+ *
13
+ * Written once because every set and map field in a policy is one of these two
14
+ * shapes and the fold is identical; what differs between fields is only whether
15
+ * a longer list is a tighter gate, which is the `gaining` argument.
16
+ */
17
+ const directionOf = (gained, lost, gaining) => {
18
+ if (gained && lost)
19
+ return "mixed";
20
+ /**
21
+ * Total on purpose, as `policyShapeOf` is. No caller reaches it — each returns
22
+ * early when nothing moved — and a helper that answered `undefined` for the
23
+ * one case it cannot order would push the question to three call sites that
24
+ * have already decided it.
25
+ */
26
+ if (!gained && !lost)
27
+ return "incomparable";
28
+ const losing = gaining === "stricter" ? "looser" : "stricter";
29
+ return gained ? gaining : losing;
30
+ };
31
+ /**
32
+ * A set field, compared.
33
+ *
34
+ * `gaining` is the field's own semantics and the only thing that varies: adding
35
+ * a protected primitive type elevates more changes, so the list getting longer
36
+ * is a tighter gate — while adding a registered primitive type permits an insert
37
+ * that was refused, so there it is a looser one.
38
+ */
39
+ const setChange = (field, was, now, gaining) => {
40
+ const before = sorted(was);
41
+ const after = sorted(now);
42
+ const added = missingFrom(after, before);
43
+ const removed = missingFrom(before, after);
44
+ if (added.length === 0 && removed.length === 0)
45
+ return undefined;
46
+ const parts = [
47
+ ...(added.length > 0 ? [`added ${list(added)}`] : []),
48
+ ...(removed.length > 0 ? [`removed ${list(removed)}`] : []),
49
+ ];
50
+ return {
51
+ field,
52
+ direction: directionOf(added.length > 0, removed.length > 0, gaining),
53
+ detail: parts.join("; "),
54
+ };
55
+ };
56
+ /**
57
+ * A number field, compared. `raising` is the field's semantics, as `gaining` is
58
+ * for a set: a higher `minimumConfidence` holds more changes back, while a
59
+ * higher `breadthThreshold` lets a broader change stay unremarkable.
60
+ */
61
+ const numberChange = (field, was, now, raising) => {
62
+ if (was === now)
63
+ return undefined;
64
+ const lowering = raising === "stricter" ? "looser" : "stricter";
65
+ return {
66
+ field,
67
+ direction: now > was ? raising : lowering,
68
+ detail: `${was} became ${now}`,
69
+ };
70
+ };
71
+ /**
72
+ * The interactive-types vocabulary, compared as a map of conditions.
73
+ *
74
+ * An entry whose condition changed is counted as both a gain and a loss, so it
75
+ * reports `mixed` rather than picking a side: `always` becoming
76
+ * `when: ["href"]` narrows which nodes are treated as targets, and widening the
77
+ * prop list widens it back, and the two are not comparable through one entry's
78
+ * `whenProps` without claiming to know the host's tree.
79
+ */
80
+ const interactiveChange = (was, now) => {
81
+ /**
82
+ * `Object.hasOwn` before the read, which is not belt-and-braces: these keys
83
+ * are primitive types a host wrote, and `interactivity.ts` records the trap —
84
+ * a type named `constructor` or `toString` reads a function off
85
+ * `Object.prototype` instead of answering "absent". Here that would be a
86
+ * comparison crashing on a policy the Gate judges perfectly well.
87
+ */
88
+ const describe = (types, type) => {
89
+ const when = Object.hasOwn(types, type)
90
+ ? types[type]
91
+ : undefined;
92
+ return when === undefined
93
+ ? undefined
94
+ : when === "always"
95
+ ? "always"
96
+ : `when ${list(sorted(when.whenProps))}`;
97
+ };
98
+ const types = sorted([...Object.keys(was), ...Object.keys(now)]);
99
+ const added = [];
100
+ const removed = [];
101
+ const altered = [];
102
+ for (const type of types) {
103
+ const before = describe(was, type);
104
+ const after = describe(now, type);
105
+ if (before === after)
106
+ continue;
107
+ if (before === undefined)
108
+ added.push(`${type} (${after})`);
109
+ else if (after === undefined)
110
+ removed.push(type);
111
+ else
112
+ altered.push(`${type} (${before} became ${after})`);
113
+ }
114
+ if (added.length === 0 && removed.length === 0 && altered.length === 0)
115
+ return undefined;
116
+ const parts = [
117
+ ...(added.length > 0 ? [`added ${list(added)}`] : []),
118
+ ...(removed.length > 0 ? [`removed ${list(removed)}`] : []),
119
+ ...(altered.length > 0 ? [`changed ${list(altered)}`] : []),
120
+ ];
121
+ return {
122
+ field: "interactiveTypes",
123
+ direction: directionOf(added.length > 0 || altered.length > 0, removed.length > 0 || altered.length > 0, "stricter"),
124
+ detail: parts.join("; "),
125
+ };
126
+ };
127
+ /**
128
+ * The per-origin ceilings, compared as stake levels rather than as strings.
129
+ *
130
+ * `autoApplyCeiling` is the one map field with an ordered value, so an entry
131
+ * that moved has a direction of its own: raising a ceiling applies more without
132
+ * asking. An origin that gained an entry is read against `ceilingFor`'s own
133
+ * fallback of `low` rather than against nothing, because that is what the Gate
134
+ * does with an absent one — so writing `low` where there was no entry is not a
135
+ * change, and the comparison says so instead of reporting an edit that changed
136
+ * no decision.
137
+ */
138
+ const ceilingChange = (was, now) => {
139
+ const origins = sorted([...Object.keys(was), ...Object.keys(now)]);
140
+ const moved = [];
141
+ let raised = false;
142
+ let lowered = false;
143
+ /** The same own-property rule as above, for the same reason. */
144
+ const ceiling = (ceilings, origin) => (Object.hasOwn(ceilings, origin) ? ceilings[origin] ?? "low" : "low");
145
+ for (const origin of origins) {
146
+ const before = ceiling(was, origin);
147
+ const after = ceiling(now, origin);
148
+ if (before === after)
149
+ continue;
150
+ moved.push(`${origin} ${before} became ${after}`);
151
+ if (compareStakes(after, before) > 0)
152
+ raised = true;
153
+ else
154
+ lowered = true;
155
+ }
156
+ if (moved.length === 0)
157
+ return undefined;
158
+ return {
159
+ field: "autoApplyCeiling",
160
+ direction: directionOf(raised, lowered, "looser"),
161
+ detail: list(moved),
162
+ };
163
+ };
164
+ /** The refusal floor, compared as a stake level. A higher floor refuses less. */
165
+ const floorChange = (was, now) => {
166
+ if (was === now)
167
+ return undefined;
168
+ return {
169
+ field: "refusalFloor",
170
+ direction: compareStakes(now, was) > 0 ? "looser" : "stricter",
171
+ detail: `${was} became ${now}`,
172
+ };
173
+ };
174
+ /**
175
+ * The direction of a run of field changes, folded over the ones that have a
176
+ * direction at all.
177
+ *
178
+ * `incomparable` is the identity: an edit with nothing ordered in it is
179
+ * incomparable, and a field with no order never drags an ordered one toward
180
+ * `mixed`. That is what makes a rename beside a raised threshold read as strict
181
+ * as the threshold made it.
182
+ *
183
+ * Used twice — over a whole edit, and over the two halves of
184
+ * `removalThresholds`, which is a pair of orderings under one field name.
185
+ */
186
+ const foldDirection = (changes) => changes.reduce((folded, change) => {
187
+ if (change.direction === "incomparable")
188
+ return folded;
189
+ if (folded === "incomparable")
190
+ return change.direction;
191
+ if (folded === "mixed" || change.direction === "mixed")
192
+ return "mixed";
193
+ return folded === change.direction ? folded : "mixed";
194
+ }, "incomparable");
195
+ const COMPARISON = {
196
+ policyId: (was, now) => was.policyId === now.policyId
197
+ ? undefined
198
+ : {
199
+ field: "policyId",
200
+ direction: "incomparable",
201
+ detail: `${was.policyId} became ${now.policyId}`,
202
+ },
203
+ /** A longer list elevates more changes. */
204
+ protectedPrimitiveTypes: (was, now) => setChange("protectedPrimitiveTypes", was.protectedPrimitiveTypes, now.protectedPrimitiveTypes, "stricter"),
205
+ /** A longer list treats more changes as irreversible. */
206
+ outOfTreeEffectTypes: (was, now) => setChange("outOfTreeEffectTypes", was.outOfTreeEffectTypes, now.outOfTreeEffectTypes, "stricter"),
207
+ protectedPropKeys: (was, now) => setChange("protectedPropKeys", was.protectedPropKeys, now.protectedPropKeys, "stricter"),
208
+ interactiveTypes: (was, now) => interactiveChange(was.interactiveTypes, now.interactiveTypes),
209
+ /**
210
+ * The one list where longer is looser, and the one where emptiness is not the
211
+ * zero of the ordering.
212
+ *
213
+ * `gatePolicySchema` documents it: an empty `registeredPrimitiveTypes` is
214
+ * *undeclared*, not a library of nothing, so an unrenderable insert is
215
+ * appended and reported at render. A list arriving where there was none is
216
+ * therefore a limit arriving where there was no limit — the strictest move
217
+ * this field can make — while every edit within a declared list reads the
218
+ * ordinary way round, and emptying it removes the check altogether.
219
+ */
220
+ registeredPrimitiveTypes: (was, now) => {
221
+ const change = setChange("registeredPrimitiveTypes", was.registeredPrimitiveTypes, now.registeredPrimitiveTypes, "looser");
222
+ if (change === undefined)
223
+ return undefined;
224
+ const declared = (policy) => policy.registeredPrimitiveTypes.length > 0;
225
+ if (!declared(was) && declared(now)) {
226
+ return { ...change, direction: "stricter", detail: `${change.detail} (undeclared before)` };
227
+ }
228
+ if (declared(was) && !declared(now)) {
229
+ return { ...change, direction: "looser", detail: `${change.detail} (undeclared now)` };
230
+ }
231
+ return change;
232
+ },
233
+ /** A higher threshold lets a larger removal stay at lower stakes. */
234
+ removalThresholds: (was, now) => {
235
+ const medium = numberChange("removalThresholds", was.removalThresholds.medium, now.removalThresholds.medium, "looser");
236
+ const high = numberChange("removalThresholds", was.removalThresholds.high, now.removalThresholds.high, "looser");
237
+ const moved = [medium, high].flatMap((change) => (change === undefined ? [] : [change]));
238
+ if (moved.length === 0)
239
+ return undefined;
240
+ const parts = [
241
+ ...(medium === undefined ? [] : [`medium ${medium.detail}`]),
242
+ ...(high === undefined ? [] : [`high ${high.detail}`]),
243
+ ];
244
+ return {
245
+ field: "removalThresholds",
246
+ direction: foldDirection(moved),
247
+ detail: list(parts),
248
+ };
249
+ },
250
+ breadthThreshold: (was, now) => numberChange("breadthThreshold", was.breadthThreshold, now.breadthThreshold, "looser"),
251
+ /**
252
+ * A deeper threshold means a change has to be nearer the root before it counts
253
+ * as restructuring, so raising it elevates fewer changes.
254
+ */
255
+ shallowDepthThreshold: (was, now) => numberChange("shallowDepthThreshold", was.shallowDepthThreshold, now.shallowDepthThreshold, "looser"),
256
+ /** A bigger budget keeps more changes undoable, so raising it refuses fewer. */
257
+ inverseRetentionBudget: (was, now) => numberChange("inverseRetentionBudget", was.inverseRetentionBudget, now.inverseRetentionBudget, "looser"),
258
+ /** A higher bar holds more changes back for a person. */
259
+ minimumConfidence: (was, now) => numberChange("minimumConfidence", was.minimumConfidence, now.minimumConfidence, "stricter"),
260
+ /** A higher floor refuses more outright. */
261
+ confidenceFloor: (was, now) => numberChange("confidenceFloor", was.confidenceFloor, now.confidenceFloor, "stricter"),
262
+ autoApplyCeiling: (was, now) => ceilingChange(was.autoApplyCeiling, now.autoApplyCeiling),
263
+ refusalFloor: (was, now) => floorChange(was.refusalFloor, now.refusalFloor),
264
+ };
265
+ /**
266
+ * The order fields are reported in: the order `GatePolicy` declares them.
267
+ *
268
+ * Taken off the comparison table rather than sorted, because the schema's order
269
+ * is already the one a reader of the policy file knows — name, then the host
270
+ * vocabulary, then the structural thresholds, then the confidence bars, then the
271
+ * two stake knobs. Sorting alphabetically would scatter the pairs that belong
272
+ * side by side.
273
+ */
274
+ const FIELDS = Object.keys(COMPARISON);
275
+ /**
276
+ * What changed between two policies, and which way it moved the Gate.
277
+ *
278
+ * Takes two whole policies rather than two fingerprints, because a digest is
279
+ * one-way: the pair is the only thing that can answer this, and a log that kept
280
+ * diffs instead of policies could not answer it about a pair it had not
281
+ * anticipated.
282
+ */
283
+ export const policyChangeOf = (was, now) => {
284
+ const fields = FIELDS.flatMap((field) => {
285
+ const change = COMPARISON[field](was, now);
286
+ return change === undefined ? [] : [change];
287
+ });
288
+ return {
289
+ changed: fields.length > 0,
290
+ renamed: was.policyId !== now.policyId,
291
+ fields,
292
+ direction: foldDirection(fields),
293
+ fingerprints: {
294
+ was: policyFingerprintOf(was),
295
+ now: policyFingerprintOf(now),
296
+ },
297
+ };
298
+ };
299
+ //# sourceMappingURL=policy-change.js.map