@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.
- package/README.md +3 -1
- package/dist/application/application.d.ts +109 -0
- package/dist/application/application.js +97 -0
- package/dist/application/memory.d.ts +20 -0
- package/dist/application/memory.js +79 -0
- package/dist/application/store.d.ts +101 -0
- package/dist/application/store.js +25 -0
- package/dist/audience/audience.d.ts +36 -0
- package/dist/audience/audience.js +41 -0
- package/dist/audience/compose.d.ts +112 -0
- package/dist/audience/compose.js +134 -0
- package/dist/audience/memory.d.ts +14 -0
- package/dist/audience/memory.js +71 -0
- package/dist/audience/overlay-store.d.ts +343 -0
- package/dist/audience/overlay-store.js +217 -0
- package/dist/audience/rule.d.ts +121 -0
- package/dist/audience/rule.js +78 -0
- package/dist/cli/index.d.ts +3 -4
- package/dist/cli/index.js +3 -4
- package/dist/cli/templates.js +19 -0
- package/dist/data/adapter.d.ts +9 -1
- package/dist/data/adapter.js +2 -0
- package/dist/data/plan.js +0 -0
- package/dist/data/resolution.d.ts +23 -1
- package/dist/data/resolve.d.ts +31 -4
- package/dist/data/resolve.js +11 -3
- package/dist/ids.d.ts +10 -0
- package/dist/ids.js +11 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/dist/interpretation/anthropic.d.ts +1 -1
- package/dist/interpretation/anthropic.js +2 -22
- package/dist/interpretation/client.d.ts +1 -1
- package/dist/interpretation/materialize.js +67 -22
- package/dist/interpretation/openai-compatible.d.ts +36 -0
- package/dist/interpretation/openai-compatible.js +79 -0
- package/dist/interpretation/status.d.ts +19 -0
- package/dist/interpretation/status.js +26 -0
- package/dist/live/index.d.ts +73 -0
- package/dist/live/index.js +73 -0
- package/dist/live/pages.d.ts +187 -0
- package/dist/live/pages.js +161 -0
- package/dist/live/pull.d.ts +147 -0
- package/dist/live/pull.js +398 -0
- package/dist/live/pulling.d.ts +79 -0
- package/dist/live/pulling.js +117 -0
- package/dist/live/window.d.ts +129 -0
- package/dist/live/window.js +132 -0
- package/dist/patch.d.ts +54 -0
- package/dist/patch.js +44 -0
- package/dist/project/closing.d.ts +51 -0
- package/dist/project/closing.js +53 -0
- package/dist/project/memory.d.ts +20 -0
- package/dist/project/memory.js +97 -0
- package/dist/project/project.d.ts +90 -0
- package/dist/project/project.js +91 -0
- package/dist/project/store.d.ts +135 -0
- package/dist/project/store.js +41 -0
- package/dist/registered.d.ts +64 -0
- package/dist/registered.js +118 -0
- package/dist/render/addressed.d.ts +35 -0
- package/dist/render/addressed.js +79 -0
- package/dist/render/behaviour-adjust.d.ts +11 -19
- package/dist/render/behaviour-adjust.js +75 -21
- package/dist/render/behaviour-present.d.ts +8 -0
- package/dist/render/behaviour-present.js +57 -6
- package/dist/render/behaviour.d.ts +98 -17
- package/dist/render/behaviour.js +91 -26
- package/dist/render/control-name.d.ts +68 -0
- package/dist/render/control-name.js +37 -0
- package/dist/render/diagnostics.d.ts +72 -0
- package/dist/render/diagnostics.js +7 -0
- package/dist/render/document-theme.d.ts +70 -0
- package/dist/render/document-theme.js +139 -0
- package/dist/render/editable.d.ts +15 -1
- package/dist/render/editable.js +13 -1
- package/dist/render/expected.d.ts +98 -0
- package/dist/render/expected.js +88 -0
- package/dist/render/index.d.ts +4 -0
- package/dist/render/index.js +4 -0
- package/dist/render/reads.d.ts +11 -0
- package/dist/render/reads.js +12 -1
- package/dist/render/render.d.ts +11 -0
- package/dist/render/render.js +294 -53
- package/dist/render/request.d.ts +8 -1
- package/dist/render/request.js +1 -0
- package/dist/render/slots.d.ts +52 -0
- package/dist/render/slots.js +24 -0
- package/dist/render/theme.d.ts +54 -1
- package/dist/render/theme.js +23 -1
- package/dist/render/unshown.d.ts +152 -0
- package/dist/render/unshown.js +80 -0
- package/dist/runtime/analysis.d.ts +94 -9
- package/dist/runtime/analysis.js +54 -9
- package/dist/runtime/assessment.d.ts +36 -2
- package/dist/runtime/assessment.js +27 -2
- package/dist/runtime/auto-apply-ceiling.d.ts +54 -0
- package/dist/runtime/auto-apply-ceiling.js +66 -0
- package/dist/runtime/checks.d.ts +148 -0
- package/dist/runtime/checks.js +112 -0
- package/dist/runtime/disposition.d.ts +96 -0
- package/dist/runtime/disposition.js +46 -0
- package/dist/runtime/gate.js +91 -10
- package/dist/runtime/index.d.ts +4 -0
- package/dist/runtime/index.js +4 -0
- package/dist/runtime/irreversibility.d.ts +64 -0
- package/dist/runtime/irreversibility.js +45 -0
- package/dist/runtime/nesting.d.ts +13 -1
- package/dist/runtime/nesting.js +41 -24
- package/dist/runtime/pipeline.d.ts +43 -0
- package/dist/runtime/pipeline.js +10 -2
- package/dist/runtime/policy-change.d.ts +93 -0
- package/dist/runtime/policy-change.js +305 -0
- package/dist/runtime/policy-log.d.ts +406 -0
- package/dist/runtime/policy-log.js +285 -0
- package/dist/runtime/policy.d.ts +8 -6
- package/dist/runtime/policy.js +5 -2
- package/dist/runtime/repointing.js +0 -0
- package/dist/runtime/reversibility.d.ts +11 -9
- package/dist/runtime/stakes.d.ts +129 -1
- package/dist/runtime/stakes.js +240 -26
- package/dist/runtime/vocabulary.d.ts +164 -7
- package/dist/runtime/vocabulary.js +181 -8
- package/dist/sdk/audit.d.ts +174 -3
- package/dist/sdk/audit.js +176 -17
- package/dist/sdk/catalogue.d.ts +9 -1
- package/dist/sdk/conformance.d.ts +37 -3
- package/dist/sdk/conformance.js +25 -4
- package/dist/sdk/definition.d.ts +129 -5
- package/dist/sdk/definition.js +66 -0
- package/dist/sdk/registry.d.ts +45 -2
- package/dist/sdk/registry.js +102 -1
- package/dist/signals/acted.contract.d.ts +21 -0
- package/dist/signals/acted.contract.js +236 -0
- package/dist/signals/acted.d.ts +359 -0
- package/dist/signals/acted.js +135 -0
- package/dist/signals/action-change.d.ts +507 -0
- package/dist/signals/action-change.js +265 -0
- package/dist/signals/action.d.ts +331 -0
- package/dist/signals/action.js +182 -0
- package/dist/signals/agenda.d.ts +585 -0
- package/dist/signals/agenda.js +295 -0
- package/dist/signals/applied-window.contract.d.ts +23 -0
- package/dist/signals/applied-window.contract.js +160 -0
- package/dist/signals/arrivals.contract.d.ts +21 -0
- package/dist/signals/arrivals.contract.js +180 -0
- package/dist/signals/arrivals.d.ts +375 -0
- package/dist/signals/arrivals.js +254 -0
- package/dist/signals/arriving.d.ts +210 -0
- package/dist/signals/arriving.js +133 -0
- package/dist/signals/audiences.d.ts +528 -0
- package/dist/signals/audiences.js +255 -0
- package/dist/signals/broadcast.d.ts +33 -17
- package/dist/signals/broadcast.js +255 -32
- package/dist/signals/change.d.ts +378 -0
- package/dist/signals/change.js +327 -0
- package/dist/signals/collect.d.ts +169 -34
- package/dist/signals/collect.js +186 -38
- package/dist/signals/conversion.d.ts +348 -0
- package/dist/signals/conversion.js +235 -0
- package/dist/signals/copy-change.d.ts +553 -0
- package/dist/signals/copy-change.js +377 -0
- package/dist/signals/copy.d.ts +337 -0
- package/dist/signals/copy.js +211 -0
- package/dist/signals/correlated.contract.d.ts +24 -0
- package/dist/signals/correlated.contract.js +94 -0
- package/dist/signals/counters.d.ts +97 -0
- package/dist/signals/counters.js +160 -0
- package/dist/signals/deliver.d.ts +23 -4
- package/dist/signals/deliver.js +34 -6
- package/dist/signals/deployment-change.d.ts +395 -0
- package/dist/signals/deployment-change.js +309 -0
- package/dist/signals/deployment.d.ts +278 -0
- package/dist/signals/deployment.js +178 -0
- package/dist/signals/door.d.ts +114 -0
- package/dist/signals/door.js +77 -0
- package/dist/signals/expire.d.ts +192 -0
- package/dist/signals/expire.js +213 -0
- package/dist/signals/fold.d.ts +10 -0
- package/dist/signals/fold.js +5 -1
- package/dist/signals/form-action.d.ts +302 -0
- package/dist/signals/form-action.js +169 -0
- package/dist/signals/form-copy.d.ts +523 -0
- package/dist/signals/form-copy.js +346 -0
- package/dist/signals/forms.d.ts +247 -0
- package/dist/signals/forms.js +147 -0
- package/dist/signals/frontier.d.ts +268 -0
- package/dist/signals/frontier.js +145 -0
- package/dist/signals/funnel-change.d.ts +548 -0
- package/dist/signals/funnel-change.js +361 -0
- package/dist/signals/funnel-hours.contract.d.ts +21 -0
- package/dist/signals/funnel-hours.contract.js +221 -0
- package/dist/signals/funnel-hours.d.ts +293 -0
- package/dist/signals/funnel-hours.js +99 -0
- package/dist/signals/funnel.d.ts +592 -0
- package/dist/signals/funnel.js +231 -0
- package/dist/signals/health.d.ts +694 -0
- package/dist/signals/health.js +573 -0
- package/dist/signals/index.d.ts +60 -0
- package/dist/signals/index.js +60 -0
- package/dist/signals/ingest.d.ts +56 -1
- package/dist/signals/ingest.js +91 -1
- package/dist/signals/inside.d.ts +190 -0
- package/dist/signals/inside.js +263 -0
- package/dist/signals/join.d.ts +56 -0
- package/dist/signals/join.js +60 -0
- package/dist/signals/journal.d.ts +123 -9
- package/dist/signals/kept.contract.d.ts +22 -0
- package/dist/signals/kept.contract.js +111 -0
- package/dist/signals/kinds.d.ts +8 -6
- package/dist/signals/kinds.js +14 -6
- package/dist/signals/library-action.d.ts +430 -0
- package/dist/signals/library-action.js +336 -0
- package/dist/signals/library-agenda-change.d.ts +324 -0
- package/dist/signals/library-agenda-change.js +199 -0
- package/dist/signals/library-agenda.d.ts +258 -0
- package/dist/signals/library-agenda.js +167 -0
- package/dist/signals/library-change.d.ts +477 -0
- package/dist/signals/library-change.js +335 -0
- package/dist/signals/library-copy-change.d.ts +498 -0
- package/dist/signals/library-copy-change.js +476 -0
- package/dist/signals/library-pace.d.ts +319 -0
- package/dist/signals/library-pace.js +305 -0
- package/dist/signals/library-reach-change.d.ts +646 -0
- package/dist/signals/library-reach-change.js +542 -0
- package/dist/signals/library-reach.d.ts +377 -0
- package/dist/signals/library-reach.js +227 -0
- package/dist/signals/library-senders-change.d.ts +457 -0
- package/dist/signals/library-senders-change.js +367 -0
- package/dist/signals/library-senders-reach-change.d.ts +486 -0
- package/dist/signals/library-senders-reach-change.js +538 -0
- package/dist/signals/library-senders-reach.d.ts +340 -0
- package/dist/signals/library-senders-reach.js +252 -0
- package/dist/signals/library-senders.d.ts +271 -0
- package/dist/signals/library-senders.js +180 -0
- package/dist/signals/library-word-reach-change.d.ts +567 -0
- package/dist/signals/library-word-reach-change.js +564 -0
- package/dist/signals/library.d.ts +306 -0
- package/dist/signals/library.js +178 -0
- package/dist/signals/memory.d.ts +9 -0
- package/dist/signals/memory.js +246 -14
- package/dist/signals/migrate.d.ts +20 -4
- package/dist/signals/migrate.js +269 -8
- package/dist/signals/notice.d.ts +389 -0
- package/dist/signals/notice.js +250 -0
- package/dist/signals/pace-change.d.ts +501 -0
- package/dist/signals/pace-change.js +310 -0
- package/dist/signals/pace.d.ts +296 -0
- package/dist/signals/pace.js +291 -0
- package/dist/signals/page-views.d.ts +365 -0
- package/dist/signals/page-views.js +218 -0
- package/dist/signals/part-pace.d.ts +378 -0
- package/dist/signals/part-pace.js +333 -0
- package/dist/signals/parts.d.ts +354 -0
- package/dist/signals/parts.js +232 -0
- package/dist/signals/postgres.d.ts +16 -2
- package/dist/signals/postgres.js +753 -76
- package/dist/signals/progress.d.ts +212 -0
- package/dist/signals/progress.js +150 -0
- package/dist/signals/ratios.d.ts +108 -0
- package/dist/signals/ratios.js +40 -0
- package/dist/signals/reach.d.ts +309 -0
- package/dist/signals/reach.js +93 -0
- package/dist/signals/readable.d.ts +34 -0
- package/dist/signals/readable.js +34 -0
- package/dist/signals/readership.d.ts +381 -0
- package/dist/signals/readership.js +308 -0
- package/dist/signals/region-pages.d.ts +173 -0
- package/dist/signals/region-pages.js +62 -0
- package/dist/signals/region.d.ts +287 -0
- package/dist/signals/region.js +198 -0
- package/dist/signals/retention.d.ts +163 -0
- package/dist/signals/retention.js +75 -0
- package/dist/signals/rhythm.d.ts +302 -0
- package/dist/signals/rhythm.js +262 -0
- package/dist/signals/rollup.d.ts +194 -4
- package/dist/signals/rollup.js +0 -0
- package/dist/signals/schema.d.ts +1069 -1
- package/dist/signals/schema.js +393 -3
- package/dist/signals/signal.d.ts +237 -11
- package/dist/signals/signal.js +70 -10
- package/dist/signals/silence-census.d.ts +205 -0
- package/dist/signals/silence-census.js +87 -0
- package/dist/signals/silences.d.ts +1147 -0
- package/dist/signals/silences.js +996 -0
- package/dist/signals/subtrees.d.ts +123 -0
- package/dist/signals/subtrees.js +102 -0
- package/dist/signals/tally.d.ts +262 -12
- package/dist/signals/unread.d.ts +292 -0
- package/dist/signals/unread.js +137 -0
- package/dist/signals/window-agenda.d.ts +276 -0
- package/dist/signals/window-agenda.js +83 -0
- package/dist/signals/window-figures.d.ts +148 -0
- package/dist/signals/window-figures.js +42 -0
- package/dist/signals/window-funnels.d.ts +88 -0
- package/dist/signals/window-funnels.js +47 -0
- package/dist/signals/window.d.ts +866 -0
- package/dist/signals/window.js +693 -0
- package/dist/signals/words.d.ts +24 -0
- package/dist/signals/words.js +24 -0
- package/dist/store/cache.d.ts +101 -0
- package/dist/store/cache.js +149 -0
- package/dist/store/history.d.ts +82 -0
- package/dist/store/history.js +36 -0
- package/dist/store/index.d.ts +30 -0
- package/dist/store/index.js +30 -0
- package/dist/store/memory.d.ts +2 -1
- package/dist/store/memory.js +48 -12
- package/dist/store/migrate.d.ts +106 -0
- package/dist/store/migrate.js +323 -7
- package/dist/store/postgres-applications.d.ts +4 -0
- package/dist/store/postgres-applications.js +197 -0
- package/dist/store/postgres-audience.d.ts +14 -0
- package/dist/store/postgres-audience.js +272 -0
- package/dist/store/postgres-holds.d.ts +10 -1
- package/dist/store/postgres-holds.js +116 -101
- package/dist/store/postgres-policy-log.d.ts +14 -0
- package/dist/store/postgres-policy-log.js +240 -0
- package/dist/store/postgres-projects.d.ts +4 -0
- package/dist/store/postgres-projects.js +217 -0
- package/dist/store/postgres.d.ts +17 -1
- package/dist/store/postgres.js +60 -9
- package/dist/store/replay.d.ts +102 -1
- package/dist/store/replay.js +190 -19
- package/dist/store/reseed.d.ts +238 -0
- package/dist/store/reseed.js +308 -0
- package/dist/store/schema.d.ts +762 -2
- package/dist/store/schema.js +218 -5
- package/dist/store/source.d.ts +57 -1
- package/dist/store/source.js +65 -1
- package/dist/store/store.d.ts +29 -6
- package/dist/submit/resolve.d.ts +1 -1
- package/dist/submit/resolve.js +2 -1
- package/dist/telemetry/calibration.d.ts +25 -0
- package/dist/telemetry/calibration.js +27 -1
- package/dist/telemetry/event.d.ts +391 -33
- package/dist/telemetry/event.js +84 -20
- package/dist/telemetry/index.d.ts +2 -0
- package/dist/telemetry/index.js +2 -0
- package/dist/telemetry/journal.d.ts +104 -3
- package/dist/telemetry/journal.js +9 -0
- package/dist/telemetry/lookup.d.ts +27 -0
- package/dist/telemetry/lookup.js +18 -0
- package/dist/telemetry/memory.js +33 -1
- package/dist/telemetry/migrate.js +22 -1
- package/dist/telemetry/postgres.d.ts +10 -1
- package/dist/telemetry/postgres.js +188 -90
- package/dist/telemetry/remeasure.d.ts +78 -0
- package/dist/telemetry/remeasure.js +83 -0
- package/dist/telemetry/retention.d.ts +2 -2
- package/dist/telemetry/schema.d.ts +17 -0
- package/dist/telemetry/schema.js +27 -1
- package/dist/telemetry/sink.d.ts +2 -2
- package/dist/telemetry/window.d.ts +135 -0
- package/dist/telemetry/window.js +101 -0
- package/dist/testing/application-contract.d.ts +14 -0
- package/dist/testing/application-contract.js +270 -0
- package/dist/testing/audience-overlay-contract.d.ts +31 -0
- package/dist/testing/audience-overlay-contract.js +354 -0
- package/dist/testing/contracts.d.ts +13 -7
- package/dist/testing/contracts.js +13 -7
- package/dist/testing/definitions.d.ts +78 -0
- package/dist/testing/definitions.js +134 -9
- package/dist/testing/doubles.d.ts +103 -0
- package/dist/testing/doubles.js +143 -0
- package/dist/testing/index.d.ts +2 -2
- package/dist/testing/index.js +2 -2
- package/dist/testing/journal-contract.js +297 -6
- package/dist/testing/model-contract.d.ts +110 -0
- package/dist/testing/model-contract.js +150 -0
- package/dist/testing/policy-log-contract.d.ts +26 -0
- package/dist/testing/policy-log-contract.js +344 -0
- package/dist/testing/project-contract.d.ts +14 -0
- package/dist/testing/project-contract.js +266 -0
- package/dist/testing/reader-signal-contract.d.ts +27 -2
- package/dist/testing/reader-signal-contract.js +475 -5
- package/dist/testing/store-contract.d.ts +7 -1
- package/dist/testing/store-contract.js +84 -3
- package/dist/theme/apply.d.ts +20 -1
- package/dist/theme/apply.js +5 -3
- package/dist/theme/contrast.d.ts +19 -14
- package/dist/theme/contrast.js +181 -17
- package/dist/theme/derive.d.ts +22 -0
- package/dist/theme/derive.js +54 -1
- package/dist/theme/library.js +1 -1
- package/dist/theme/measure.d.ts +34 -0
- package/dist/theme/measure.js +30 -1
- package/dist/theme/palettes.js +7 -7
- package/dist/theme/ramp.d.ts +64 -0
- package/dist/theme/ramp.js +114 -0
- package/dist/theme/registry.d.ts +9 -0
- package/dist/theme/registry.js +11 -1
- package/dist/theme/separation.d.ts +97 -3
- package/dist/theme/separation.js +75 -0
- package/dist/tree/apply.js +13 -0
- package/dist/tree/compare.d.ts +9 -0
- package/dist/tree/compare.js +18 -0
- package/dist/tree/mutation.d.ts +18 -0
- package/dist/tree/mutation.js +24 -12
- package/dist/tree/navigation.d.ts +5 -0
- package/dist/tree/navigation.js +32 -10
- package/dist/tree/outline.d.ts +7 -0
- package/dist/tree/outline.js +9 -5
- package/dist/write/computed.d.ts +60 -0
- package/dist/write/computed.js +61 -0
- package/dist/write/held.d.ts +59 -0
- package/dist/write/index.d.ts +5 -2
- package/dist/write/index.js +5 -2
- package/dist/write/reseed.d.ts +151 -0
- package/dist/write/reseed.js +184 -0
- package/dist/write/revert.js +2 -16
- package/package.json +25 -3
- package/dist/runtime/inverse-interpreter.d.ts +0 -90
- package/dist/runtime/inverse-interpreter.js +0 -56
|
@@ -0,0 +1,305 @@
|
|
|
1
|
+
import { compareCeilings } from "./auto-apply-ceiling.js";
|
|
2
|
+
import { policyFingerprintOf } from "./policy-fingerprint.js";
|
|
3
|
+
import { compareStakes } from "./stake-level.js";
|
|
4
|
+
const compareStrings = (left, right) => left < right ? -1 : left > right ? 1 : 0;
|
|
5
|
+
const sorted = (values) => Array.from(new Set(values)).sort(compareStrings);
|
|
6
|
+
const missingFrom = (members, other) => {
|
|
7
|
+
const held = new Set(other);
|
|
8
|
+
return members.filter((member) => !held.has(member));
|
|
9
|
+
};
|
|
10
|
+
const list = (members) => members.join(", ");
|
|
11
|
+
/**
|
|
12
|
+
* The direction a gained-and-lost pair points in, given what gaining means.
|
|
13
|
+
*
|
|
14
|
+
* Written once because every set and map field in a policy is one of these two
|
|
15
|
+
* shapes and the fold is identical; what differs between fields is only whether
|
|
16
|
+
* a longer list is a tighter gate, which is the `gaining` argument.
|
|
17
|
+
*/
|
|
18
|
+
const directionOf = (gained, lost, gaining) => {
|
|
19
|
+
if (gained && lost)
|
|
20
|
+
return "mixed";
|
|
21
|
+
/**
|
|
22
|
+
* Total on purpose, as `policyShapeOf` is. No caller reaches it — each returns
|
|
23
|
+
* early when nothing moved — and a helper that answered `undefined` for the
|
|
24
|
+
* one case it cannot order would push the question to three call sites that
|
|
25
|
+
* have already decided it.
|
|
26
|
+
*/
|
|
27
|
+
if (!gained && !lost)
|
|
28
|
+
return "incomparable";
|
|
29
|
+
const losing = gaining === "stricter" ? "looser" : "stricter";
|
|
30
|
+
return gained ? gaining : losing;
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* A set field, compared.
|
|
34
|
+
*
|
|
35
|
+
* `gaining` is the field's own semantics and the only thing that varies: adding
|
|
36
|
+
* a protected primitive type elevates more changes, so the list getting longer
|
|
37
|
+
* is a tighter gate — while adding a registered primitive type permits an insert
|
|
38
|
+
* that was refused, so there it is a looser one.
|
|
39
|
+
*/
|
|
40
|
+
const setChange = (field, was, now, gaining) => {
|
|
41
|
+
const before = sorted(was);
|
|
42
|
+
const after = sorted(now);
|
|
43
|
+
const added = missingFrom(after, before);
|
|
44
|
+
const removed = missingFrom(before, after);
|
|
45
|
+
if (added.length === 0 && removed.length === 0)
|
|
46
|
+
return undefined;
|
|
47
|
+
const parts = [
|
|
48
|
+
...(added.length > 0 ? [`added ${list(added)}`] : []),
|
|
49
|
+
...(removed.length > 0 ? [`removed ${list(removed)}`] : []),
|
|
50
|
+
];
|
|
51
|
+
return {
|
|
52
|
+
field,
|
|
53
|
+
direction: directionOf(added.length > 0, removed.length > 0, gaining),
|
|
54
|
+
detail: parts.join("; "),
|
|
55
|
+
};
|
|
56
|
+
};
|
|
57
|
+
/**
|
|
58
|
+
* A number field, compared. `raising` is the field's semantics, as `gaining` is
|
|
59
|
+
* for a set: a higher `minimumConfidence` holds more changes back, while a
|
|
60
|
+
* higher `breadthThreshold` lets a broader change stay unremarkable.
|
|
61
|
+
*/
|
|
62
|
+
const numberChange = (field, was, now, raising) => {
|
|
63
|
+
if (was === now)
|
|
64
|
+
return undefined;
|
|
65
|
+
const lowering = raising === "stricter" ? "looser" : "stricter";
|
|
66
|
+
return {
|
|
67
|
+
field,
|
|
68
|
+
direction: now > was ? raising : lowering,
|
|
69
|
+
detail: `${was} became ${now}`,
|
|
70
|
+
};
|
|
71
|
+
};
|
|
72
|
+
/**
|
|
73
|
+
* The interactive-types vocabulary, compared as a map of conditions.
|
|
74
|
+
*
|
|
75
|
+
* An entry whose condition changed is counted as both a gain and a loss, so it
|
|
76
|
+
* reports `mixed` rather than picking a side: `always` becoming
|
|
77
|
+
* `when: ["href"]` narrows which nodes are treated as targets, and widening the
|
|
78
|
+
* prop list widens it back, and the two are not comparable through one entry's
|
|
79
|
+
* `whenProps` without claiming to know the host's tree.
|
|
80
|
+
*/
|
|
81
|
+
const interactiveChange = (was, now) => {
|
|
82
|
+
/**
|
|
83
|
+
* `Object.hasOwn` before the read, which is not belt-and-braces: these keys
|
|
84
|
+
* are primitive types a host wrote, and `interactivity.ts` records the trap —
|
|
85
|
+
* a type named `constructor` or `toString` reads a function off
|
|
86
|
+
* `Object.prototype` instead of answering "absent". Here that would be a
|
|
87
|
+
* comparison crashing on a policy the Gate judges perfectly well.
|
|
88
|
+
*/
|
|
89
|
+
const describe = (types, type) => {
|
|
90
|
+
const when = Object.hasOwn(types, type)
|
|
91
|
+
? types[type]
|
|
92
|
+
: undefined;
|
|
93
|
+
return when === undefined
|
|
94
|
+
? undefined
|
|
95
|
+
: when === "always"
|
|
96
|
+
? "always"
|
|
97
|
+
: `when ${list(sorted(when.whenProps))}`;
|
|
98
|
+
};
|
|
99
|
+
const types = sorted([...Object.keys(was), ...Object.keys(now)]);
|
|
100
|
+
const added = [];
|
|
101
|
+
const removed = [];
|
|
102
|
+
const altered = [];
|
|
103
|
+
for (const type of types) {
|
|
104
|
+
const before = describe(was, type);
|
|
105
|
+
const after = describe(now, type);
|
|
106
|
+
if (before === after)
|
|
107
|
+
continue;
|
|
108
|
+
if (before === undefined)
|
|
109
|
+
added.push(`${type} (${after})`);
|
|
110
|
+
else if (after === undefined)
|
|
111
|
+
removed.push(type);
|
|
112
|
+
else
|
|
113
|
+
altered.push(`${type} (${before} became ${after})`);
|
|
114
|
+
}
|
|
115
|
+
if (added.length === 0 && removed.length === 0 && altered.length === 0)
|
|
116
|
+
return undefined;
|
|
117
|
+
const parts = [
|
|
118
|
+
...(added.length > 0 ? [`added ${list(added)}`] : []),
|
|
119
|
+
...(removed.length > 0 ? [`removed ${list(removed)}`] : []),
|
|
120
|
+
...(altered.length > 0 ? [`changed ${list(altered)}`] : []),
|
|
121
|
+
];
|
|
122
|
+
return {
|
|
123
|
+
field: "interactiveTypes",
|
|
124
|
+
direction: directionOf(added.length > 0 || altered.length > 0, removed.length > 0 || altered.length > 0, "stricter"),
|
|
125
|
+
detail: parts.join("; "),
|
|
126
|
+
};
|
|
127
|
+
};
|
|
128
|
+
/**
|
|
129
|
+
* The per-origin ceilings, compared on the ceiling scale rather than as
|
|
130
|
+
* strings.
|
|
131
|
+
*
|
|
132
|
+
* `autoApplyCeiling` is the one map field with an ordered value, so an entry
|
|
133
|
+
* that moved has a direction of its own: raising a ceiling applies more without
|
|
134
|
+
* asking. An origin that gained an entry is read against `ceilingFor`'s own
|
|
135
|
+
* fallback of `low` rather than against nothing, because that is what the Gate
|
|
136
|
+
* does with an absent one — so writing `low` where there was no entry is not a
|
|
137
|
+
* change, and the comparison says so instead of reporting an edit that changed
|
|
138
|
+
* no decision.
|
|
139
|
+
*
|
|
140
|
+
* `nothing` is the bottom rung of that scale and not a value outside it
|
|
141
|
+
* (0405), so an origin switched off reads as a ceiling lowered, which is what
|
|
142
|
+
* it is: stricter, in the same column as every other tightening.
|
|
143
|
+
*/
|
|
144
|
+
const ceilingChange = (was, now) => {
|
|
145
|
+
const origins = sorted([...Object.keys(was), ...Object.keys(now)]);
|
|
146
|
+
const moved = [];
|
|
147
|
+
let raised = false;
|
|
148
|
+
let lowered = false;
|
|
149
|
+
/** The same own-property rule as above, for the same reason. */
|
|
150
|
+
const ceiling = (ceilings, origin) => (Object.hasOwn(ceilings, origin) ? ceilings[origin] ?? "low" : "low");
|
|
151
|
+
for (const origin of origins) {
|
|
152
|
+
const before = ceiling(was, origin);
|
|
153
|
+
const after = ceiling(now, origin);
|
|
154
|
+
if (before === after)
|
|
155
|
+
continue;
|
|
156
|
+
moved.push(`${origin} ${before} became ${after}`);
|
|
157
|
+
if (compareCeilings(after, before) > 0)
|
|
158
|
+
raised = true;
|
|
159
|
+
else
|
|
160
|
+
lowered = true;
|
|
161
|
+
}
|
|
162
|
+
if (moved.length === 0)
|
|
163
|
+
return undefined;
|
|
164
|
+
return {
|
|
165
|
+
field: "autoApplyCeiling",
|
|
166
|
+
direction: directionOf(raised, lowered, "looser"),
|
|
167
|
+
detail: list(moved),
|
|
168
|
+
};
|
|
169
|
+
};
|
|
170
|
+
/** The refusal floor, compared as a stake level. A higher floor refuses less. */
|
|
171
|
+
const floorChange = (was, now) => {
|
|
172
|
+
if (was === now)
|
|
173
|
+
return undefined;
|
|
174
|
+
return {
|
|
175
|
+
field: "refusalFloor",
|
|
176
|
+
direction: compareStakes(now, was) > 0 ? "looser" : "stricter",
|
|
177
|
+
detail: `${was} became ${now}`,
|
|
178
|
+
};
|
|
179
|
+
};
|
|
180
|
+
/**
|
|
181
|
+
* The direction of a run of field changes, folded over the ones that have a
|
|
182
|
+
* direction at all.
|
|
183
|
+
*
|
|
184
|
+
* `incomparable` is the identity: an edit with nothing ordered in it is
|
|
185
|
+
* incomparable, and a field with no order never drags an ordered one toward
|
|
186
|
+
* `mixed`. That is what makes a rename beside a raised threshold read as strict
|
|
187
|
+
* as the threshold made it.
|
|
188
|
+
*
|
|
189
|
+
* Used twice — over a whole edit, and over the two halves of
|
|
190
|
+
* `removalThresholds`, which is a pair of orderings under one field name.
|
|
191
|
+
*/
|
|
192
|
+
const foldDirection = (changes) => changes.reduce((folded, change) => {
|
|
193
|
+
if (change.direction === "incomparable")
|
|
194
|
+
return folded;
|
|
195
|
+
if (folded === "incomparable")
|
|
196
|
+
return change.direction;
|
|
197
|
+
if (folded === "mixed" || change.direction === "mixed")
|
|
198
|
+
return "mixed";
|
|
199
|
+
return folded === change.direction ? folded : "mixed";
|
|
200
|
+
}, "incomparable");
|
|
201
|
+
const COMPARISON = {
|
|
202
|
+
policyId: (was, now) => was.policyId === now.policyId
|
|
203
|
+
? undefined
|
|
204
|
+
: {
|
|
205
|
+
field: "policyId",
|
|
206
|
+
direction: "incomparable",
|
|
207
|
+
detail: `${was.policyId} became ${now.policyId}`,
|
|
208
|
+
},
|
|
209
|
+
/** A longer list elevates more changes. */
|
|
210
|
+
protectedPrimitiveTypes: (was, now) => setChange("protectedPrimitiveTypes", was.protectedPrimitiveTypes, now.protectedPrimitiveTypes, "stricter"),
|
|
211
|
+
/** A longer list treats more changes as irreversible. */
|
|
212
|
+
outOfTreeEffectTypes: (was, now) => setChange("outOfTreeEffectTypes", was.outOfTreeEffectTypes, now.outOfTreeEffectTypes, "stricter"),
|
|
213
|
+
protectedPropKeys: (was, now) => setChange("protectedPropKeys", was.protectedPropKeys, now.protectedPropKeys, "stricter"),
|
|
214
|
+
interactiveTypes: (was, now) => interactiveChange(was.interactiveTypes, now.interactiveTypes),
|
|
215
|
+
/**
|
|
216
|
+
* The one list where longer is looser, and the one where emptiness is not the
|
|
217
|
+
* zero of the ordering.
|
|
218
|
+
*
|
|
219
|
+
* `gatePolicySchema` documents it: an empty `registeredPrimitiveTypes` is
|
|
220
|
+
* *undeclared*, not a library of nothing, so an unrenderable insert is
|
|
221
|
+
* appended and reported at render. A list arriving where there was none is
|
|
222
|
+
* therefore a limit arriving where there was no limit — the strictest move
|
|
223
|
+
* this field can make — while every edit within a declared list reads the
|
|
224
|
+
* ordinary way round, and emptying it removes the check altogether.
|
|
225
|
+
*/
|
|
226
|
+
registeredPrimitiveTypes: (was, now) => {
|
|
227
|
+
const change = setChange("registeredPrimitiveTypes", was.registeredPrimitiveTypes, now.registeredPrimitiveTypes, "looser");
|
|
228
|
+
if (change === undefined)
|
|
229
|
+
return undefined;
|
|
230
|
+
const declared = (policy) => policy.registeredPrimitiveTypes.length > 0;
|
|
231
|
+
if (!declared(was) && declared(now)) {
|
|
232
|
+
return { ...change, direction: "stricter", detail: `${change.detail} (undeclared before)` };
|
|
233
|
+
}
|
|
234
|
+
if (declared(was) && !declared(now)) {
|
|
235
|
+
return { ...change, direction: "looser", detail: `${change.detail} (undeclared now)` };
|
|
236
|
+
}
|
|
237
|
+
return change;
|
|
238
|
+
},
|
|
239
|
+
/** A higher threshold lets a larger removal stay at lower stakes. */
|
|
240
|
+
removalThresholds: (was, now) => {
|
|
241
|
+
const medium = numberChange("removalThresholds", was.removalThresholds.medium, now.removalThresholds.medium, "looser");
|
|
242
|
+
const high = numberChange("removalThresholds", was.removalThresholds.high, now.removalThresholds.high, "looser");
|
|
243
|
+
const moved = [medium, high].flatMap((change) => (change === undefined ? [] : [change]));
|
|
244
|
+
if (moved.length === 0)
|
|
245
|
+
return undefined;
|
|
246
|
+
const parts = [
|
|
247
|
+
...(medium === undefined ? [] : [`medium ${medium.detail}`]),
|
|
248
|
+
...(high === undefined ? [] : [`high ${high.detail}`]),
|
|
249
|
+
];
|
|
250
|
+
return {
|
|
251
|
+
field: "removalThresholds",
|
|
252
|
+
direction: foldDirection(moved),
|
|
253
|
+
detail: list(parts),
|
|
254
|
+
};
|
|
255
|
+
},
|
|
256
|
+
breadthThreshold: (was, now) => numberChange("breadthThreshold", was.breadthThreshold, now.breadthThreshold, "looser"),
|
|
257
|
+
/**
|
|
258
|
+
* A deeper threshold means a change has to be nearer the root before it counts
|
|
259
|
+
* as restructuring, so raising it elevates fewer changes.
|
|
260
|
+
*/
|
|
261
|
+
shallowDepthThreshold: (was, now) => numberChange("shallowDepthThreshold", was.shallowDepthThreshold, now.shallowDepthThreshold, "looser"),
|
|
262
|
+
/** A bigger budget keeps more changes undoable, so raising it refuses fewer. */
|
|
263
|
+
inverseRetentionBudget: (was, now) => numberChange("inverseRetentionBudget", was.inverseRetentionBudget, now.inverseRetentionBudget, "looser"),
|
|
264
|
+
/** A higher bar holds more changes back for a person. */
|
|
265
|
+
minimumConfidence: (was, now) => numberChange("minimumConfidence", was.minimumConfidence, now.minimumConfidence, "stricter"),
|
|
266
|
+
/** A higher floor refuses more outright. */
|
|
267
|
+
confidenceFloor: (was, now) => numberChange("confidenceFloor", was.confidenceFloor, now.confidenceFloor, "stricter"),
|
|
268
|
+
autoApplyCeiling: (was, now) => ceilingChange(was.autoApplyCeiling, now.autoApplyCeiling),
|
|
269
|
+
refusalFloor: (was, now) => floorChange(was.refusalFloor, now.refusalFloor),
|
|
270
|
+
};
|
|
271
|
+
/**
|
|
272
|
+
* The order fields are reported in: the order `GatePolicy` declares them.
|
|
273
|
+
*
|
|
274
|
+
* Taken off the comparison table rather than sorted, because the schema's order
|
|
275
|
+
* is already the one a reader of the policy file knows — name, then the host
|
|
276
|
+
* vocabulary, then the structural thresholds, then the confidence bars, then the
|
|
277
|
+
* two stake knobs. Sorting alphabetically would scatter the pairs that belong
|
|
278
|
+
* side by side.
|
|
279
|
+
*/
|
|
280
|
+
const FIELDS = Object.keys(COMPARISON);
|
|
281
|
+
/**
|
|
282
|
+
* What changed between two policies, and which way it moved the Gate.
|
|
283
|
+
*
|
|
284
|
+
* Takes two whole policies rather than two fingerprints, because a digest is
|
|
285
|
+
* one-way: the pair is the only thing that can answer this, and a log that kept
|
|
286
|
+
* diffs instead of policies could not answer it about a pair it had not
|
|
287
|
+
* anticipated.
|
|
288
|
+
*/
|
|
289
|
+
export const policyChangeOf = (was, now) => {
|
|
290
|
+
const fields = FIELDS.flatMap((field) => {
|
|
291
|
+
const change = COMPARISON[field](was, now);
|
|
292
|
+
return change === undefined ? [] : [change];
|
|
293
|
+
});
|
|
294
|
+
return {
|
|
295
|
+
changed: fields.length > 0,
|
|
296
|
+
renamed: was.policyId !== now.policyId,
|
|
297
|
+
fields,
|
|
298
|
+
direction: foldDirection(fields),
|
|
299
|
+
fingerprints: {
|
|
300
|
+
was: policyFingerprintOf(was),
|
|
301
|
+
now: policyFingerprintOf(now),
|
|
302
|
+
},
|
|
303
|
+
};
|
|
304
|
+
};
|
|
305
|
+
//# sourceMappingURL=policy-change.js.map
|