@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,336 @@
|
|
|
1
|
+
import { everyMemberOf } from "../closed-set.js";
|
|
2
|
+
import { PRIMITIVE_ROLES } from "../role.js";
|
|
3
|
+
import { pageActionOf, } from "./action.js";
|
|
4
|
+
import { readingKeyOf } from "./audiences.js";
|
|
5
|
+
import { atDoorScale, doorOf } from "./door.js";
|
|
6
|
+
import { kindKeyOf } from "./library.js";
|
|
7
|
+
import { pageViewsFor, } from "./page-views.js";
|
|
8
|
+
export const KIND_ACTION_SILENCES = everyMemberOf()([
|
|
9
|
+
"unread",
|
|
10
|
+
"unplaced",
|
|
11
|
+
"unscaled",
|
|
12
|
+
"unopened",
|
|
13
|
+
"uncounted",
|
|
14
|
+
"unenterable",
|
|
15
|
+
"unwalked",
|
|
16
|
+
]);
|
|
17
|
+
/** One line per silence, for a surface saying why a kind has no share of its readers' actions. */
|
|
18
|
+
export const describeKindActionSilence = (silence) => {
|
|
19
|
+
switch (silence) {
|
|
20
|
+
case "unread":
|
|
21
|
+
return "nothing reported a reader reaching any place this kind of part stands that has an inside";
|
|
22
|
+
case "unplaced":
|
|
23
|
+
return "nothing in the pages read is of this kind";
|
|
24
|
+
case "unenterable":
|
|
25
|
+
return "no place this kind of part stands has anything inside it, so there is nothing a reader could act in";
|
|
26
|
+
case "unwalked":
|
|
27
|
+
return "a page behind the figure holds actions and credits none of them to a reader";
|
|
28
|
+
case "unscaled":
|
|
29
|
+
return "two or more pages are behind the figure and one of them has no page views counted at the door, so they cannot be weighed against each other";
|
|
30
|
+
case "unopened":
|
|
31
|
+
return "a page behind the figure has a row and nothing has said a page view began";
|
|
32
|
+
case "uncounted":
|
|
33
|
+
return "a page behind the figure has readers and no window of their reading has been counted yet";
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
/** The kind-level reason a page's reason causes, which is the same state at the other subject. */
|
|
37
|
+
const KIND_ACTION_OF_REACH = Object.freeze({
|
|
38
|
+
unmeasured: "unscaled",
|
|
39
|
+
unopened: "unopened",
|
|
40
|
+
uncounted: "uncounted",
|
|
41
|
+
});
|
|
42
|
+
const NO_STANDINGS = Object.freeze({
|
|
43
|
+
acted: 0,
|
|
44
|
+
untouched: 0,
|
|
45
|
+
unknown: 0,
|
|
46
|
+
});
|
|
47
|
+
const tallying = (kind) => ({
|
|
48
|
+
kind,
|
|
49
|
+
role: null,
|
|
50
|
+
placements: 0,
|
|
51
|
+
insides: 0,
|
|
52
|
+
leaves: 0,
|
|
53
|
+
verdicts: 0,
|
|
54
|
+
unknown: 0,
|
|
55
|
+
unmet: 0,
|
|
56
|
+
roots: 0,
|
|
57
|
+
unreconciled: 0,
|
|
58
|
+
standings: { ...NO_STANDINGS },
|
|
59
|
+
terms: new Map(),
|
|
60
|
+
});
|
|
61
|
+
/**
|
|
62
|
+
* One placement's contribution, which is nothing at all unless it has an inside
|
|
63
|
+
* and a window could speak for it.
|
|
64
|
+
*
|
|
65
|
+
* The order is the order the claims have to be ruled out in: a leaf is excluded
|
|
66
|
+
* before any row is read, because its nought is a filing rule whatever the
|
|
67
|
+
* window said, and an absent row is excluded before a reach of nought, because
|
|
68
|
+
* *nothing was reported* and *nobody got there* are the two states 0242 exists
|
|
69
|
+
* to keep apart.
|
|
70
|
+
*/
|
|
71
|
+
const add = (into, part, page) => {
|
|
72
|
+
into.placements += 1;
|
|
73
|
+
into.standings[part.standing] += 1;
|
|
74
|
+
if (part.depth === 0)
|
|
75
|
+
into.roots += 1;
|
|
76
|
+
if (!part.bearsParts) {
|
|
77
|
+
into.leaves += 1;
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
into.insides += 1;
|
|
81
|
+
const { reached, within } = part;
|
|
82
|
+
if (reached === undefined || within === undefined) {
|
|
83
|
+
into.unknown += 1;
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
into.verdicts += 1;
|
|
87
|
+
const standing = into.terms.get(page.revision);
|
|
88
|
+
const terms = standing ?? {
|
|
89
|
+
reached: 0,
|
|
90
|
+
within: 0,
|
|
91
|
+
door: page.door,
|
|
92
|
+
unwalked: page.unwalked,
|
|
93
|
+
};
|
|
94
|
+
if (standing === undefined)
|
|
95
|
+
into.terms.set(page.revision, terms);
|
|
96
|
+
if (within > reached)
|
|
97
|
+
into.unreconciled += 1;
|
|
98
|
+
if (reached === 0) {
|
|
99
|
+
into.unmet += 1;
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
terms.reached += reached;
|
|
103
|
+
terms.within += within;
|
|
104
|
+
};
|
|
105
|
+
/**
|
|
106
|
+
* The figures, or the reason there are none, with the reasons tried in the order
|
|
107
|
+
* they have to be tried in.
|
|
108
|
+
*
|
|
109
|
+
* Nothing of the kind first, because *there is no such part in this library* is
|
|
110
|
+
* a better answer than every reason below it and they are all true of it by
|
|
111
|
+
* accident. Then the structural reason, because a kind with no inside anywhere
|
|
112
|
+
* is answered by the census and not by waiting for readers. Then the window:
|
|
113
|
+
* no row, then no reader, because a kind nobody reached has no denominator
|
|
114
|
+
* whether or not its pages could be scaled. Then the sender, before the door,
|
|
115
|
+
* because a page crediting nobody is the sharper diagnosis and the one that
|
|
116
|
+
* does not resolve itself. The door last, and only where two pages have to be
|
|
117
|
+
* weighed against each other.
|
|
118
|
+
*/
|
|
119
|
+
const figuresOf = (of, weighing) => {
|
|
120
|
+
const none = {
|
|
121
|
+
met: null,
|
|
122
|
+
acted: null,
|
|
123
|
+
ignored: null,
|
|
124
|
+
share: null,
|
|
125
|
+
onDoorScale: false,
|
|
126
|
+
drift: 0,
|
|
127
|
+
pending: 0,
|
|
128
|
+
};
|
|
129
|
+
if (of.placements === 0)
|
|
130
|
+
return { ...none, silence: "unplaced" };
|
|
131
|
+
if (of.insides === 0)
|
|
132
|
+
return { ...none, silence: "unenterable" };
|
|
133
|
+
if (of.verdicts === 0)
|
|
134
|
+
return { ...none, silence: "unread" };
|
|
135
|
+
const first = weighing[0];
|
|
136
|
+
if (first === undefined)
|
|
137
|
+
return { ...none, silence: "unread" };
|
|
138
|
+
const drift = weighing.reduce((sum, terms) => sum + terms.door.drift, 0);
|
|
139
|
+
const pending = weighing.reduce((sum, terms) => sum + terms.door.pending, 0);
|
|
140
|
+
if (weighing.some((terms) => terms.unwalked)) {
|
|
141
|
+
return { ...none, drift, pending, silence: "unwalked" };
|
|
142
|
+
}
|
|
143
|
+
/** The first page the door could not scale, as that page's own reason. */
|
|
144
|
+
const blocked = weighing.reduce((found, terms) => found ?? terms.door.silence, null);
|
|
145
|
+
/**
|
|
146
|
+
* One page's own figure, with no scale in it at all.
|
|
147
|
+
*
|
|
148
|
+
* Reported with `onDoorScale: false` rather than with the door's numbers,
|
|
149
|
+
* because this page has none: its share is sound and its counts are on the
|
|
150
|
+
* counters' own scale, which is not a scale any other row's counts could be
|
|
151
|
+
* added to.
|
|
152
|
+
*/
|
|
153
|
+
if (blocked !== null && weighing.length === 1) {
|
|
154
|
+
return {
|
|
155
|
+
met: null,
|
|
156
|
+
acted: null,
|
|
157
|
+
ignored: null,
|
|
158
|
+
share: first.within / first.reached,
|
|
159
|
+
onDoorScale: false,
|
|
160
|
+
drift,
|
|
161
|
+
pending,
|
|
162
|
+
silence: null,
|
|
163
|
+
};
|
|
164
|
+
}
|
|
165
|
+
if (blocked !== null) {
|
|
166
|
+
return { ...none, drift, pending, silence: KIND_ACTION_OF_REACH[blocked] };
|
|
167
|
+
}
|
|
168
|
+
const met = weighing.reduce((sum, terms) => sum + atDoorScale(terms.reached, terms.door), 0);
|
|
169
|
+
const acted = weighing.reduce((sum, terms) => sum + atDoorScale(terms.within, terms.door), 0);
|
|
170
|
+
return {
|
|
171
|
+
met,
|
|
172
|
+
acted,
|
|
173
|
+
ignored: met - acted,
|
|
174
|
+
share: acted / met,
|
|
175
|
+
onDoorScale: true,
|
|
176
|
+
drift,
|
|
177
|
+
pending,
|
|
178
|
+
silence: null,
|
|
179
|
+
};
|
|
180
|
+
};
|
|
181
|
+
const rowOf = (of) => {
|
|
182
|
+
const weighing = [...of.terms.values()].filter((terms) => terms.reached > 0);
|
|
183
|
+
const figures = figuresOf(of, weighing);
|
|
184
|
+
return {
|
|
185
|
+
kind: of.kind,
|
|
186
|
+
role: of.kind.by === "type" ? of.role : null,
|
|
187
|
+
placements: of.placements,
|
|
188
|
+
insides: of.insides,
|
|
189
|
+
leaves: of.leaves,
|
|
190
|
+
verdicts: of.verdicts,
|
|
191
|
+
unknown: of.unknown,
|
|
192
|
+
unmet: of.unmet,
|
|
193
|
+
roots: of.roots,
|
|
194
|
+
standings: of.standings,
|
|
195
|
+
pages: of.terms.size,
|
|
196
|
+
weighed: weighing.length,
|
|
197
|
+
...figures,
|
|
198
|
+
settled: figures.silence === null &&
|
|
199
|
+
figures.pending === 0 &&
|
|
200
|
+
of.unreconciled === 0,
|
|
201
|
+
unreconciled: of.unreconciled,
|
|
202
|
+
};
|
|
203
|
+
};
|
|
204
|
+
/** The name a row is ordered by, which is the key's own and never the row's position. */
|
|
205
|
+
const nameOf = (kind) => kind.by === "type" ? kind.type : (kind.role ?? "");
|
|
206
|
+
/**
|
|
207
|
+
* The worse of two, which is the ranking rule spelled once.
|
|
208
|
+
*
|
|
209
|
+
* Most readers ignored, then the lower share, then by name — so a kind with no
|
|
210
|
+
* share at all sorts after one with a share of nought rather than above it, and
|
|
211
|
+
* a scale-free row sorts on its share rather than on a count it does not have.
|
|
212
|
+
*/
|
|
213
|
+
const worseOf = (one, other) => (other.ignored ?? -1) - (one.ignored ?? -1) ||
|
|
214
|
+
(one.share ?? 2) - (other.share ?? 2) ||
|
|
215
|
+
nameOf(one.kind).localeCompare(nameOf(other.kind));
|
|
216
|
+
/** Tree id, then newest revision first, which is the order the page-view rows are read in. */
|
|
217
|
+
const byPage = (one, other) => one.treeId.localeCompare(other.treeId) || other.revision - one.revision;
|
|
218
|
+
/**
|
|
219
|
+
* What a deployment's library gets its readers to do, by kind of part.
|
|
220
|
+
*
|
|
221
|
+
* Takes the readings and the whole window of page-view rows a deployment holds —
|
|
222
|
+
* each page's own row is picked out of them by the published matching rule
|
|
223
|
+
* (`pageViewsFor`) rather than by a fourth hand-written copy of it, because the
|
|
224
|
+
* pairing is the part of every join here that fails quietly when it is got
|
|
225
|
+
* wrong.
|
|
226
|
+
*
|
|
227
|
+
* Linear in the parts of the readings times the rows, with one pass that fills
|
|
228
|
+
* both groupings.
|
|
229
|
+
*/
|
|
230
|
+
export const libraryActionOf = (readings, rows) => {
|
|
231
|
+
const tallies = new Map();
|
|
232
|
+
const seen = new Set();
|
|
233
|
+
const trees = new Set();
|
|
234
|
+
const unscaled = [];
|
|
235
|
+
const unwalked = [];
|
|
236
|
+
const disagreed = new Set();
|
|
237
|
+
const standings = { ...NO_STANDINGS };
|
|
238
|
+
let pages = 0;
|
|
239
|
+
let placements = 0;
|
|
240
|
+
let insides = 0;
|
|
241
|
+
let leaves = 0;
|
|
242
|
+
let arrivals = 0;
|
|
243
|
+
let scaled = 0;
|
|
244
|
+
let duplicated = 0;
|
|
245
|
+
let duplicatedRows = 0;
|
|
246
|
+
/**
|
|
247
|
+
* Every role in the vocabulary gets a row whether or not anything plays it,
|
|
248
|
+
* the way the other two library readings' role rows do: a role nothing plays
|
|
249
|
+
* is a fact about the library worth having, and a surface that had to tell a
|
|
250
|
+
* missing row from an empty one would be reading the vocabulary itself.
|
|
251
|
+
*/
|
|
252
|
+
for (const role of [...PRIMITIVE_ROLES, null]) {
|
|
253
|
+
const kind = { by: "role", role };
|
|
254
|
+
tallies.set(kindKeyOf(kind), tallying(kind));
|
|
255
|
+
}
|
|
256
|
+
for (const reading of readings) {
|
|
257
|
+
const revision = readingKeyOf(reading);
|
|
258
|
+
if (seen.has(revision)) {
|
|
259
|
+
duplicated += 1;
|
|
260
|
+
continue;
|
|
261
|
+
}
|
|
262
|
+
seen.add(revision);
|
|
263
|
+
trees.add(reading.treeId);
|
|
264
|
+
pages += 1;
|
|
265
|
+
const found = pageViewsFor(reading, rows);
|
|
266
|
+
const door = doorOf(found.measured);
|
|
267
|
+
const action = pageActionOf(reading);
|
|
268
|
+
duplicatedRows += found.duplicated;
|
|
269
|
+
arrivals += door.opened;
|
|
270
|
+
if (door.silence === null)
|
|
271
|
+
scaled += 1;
|
|
272
|
+
if (action.unwalked)
|
|
273
|
+
unwalked.push({ treeId: reading.treeId, revision: reading.revision });
|
|
274
|
+
/**
|
|
275
|
+
* A page the door cannot scale is listed only where a window could speak for
|
|
276
|
+
* something on it: a page nobody read is not a page whose readers could not
|
|
277
|
+
* be counted, and listing it would put the commonest healthy state on a list
|
|
278
|
+
* that is meant to be empty.
|
|
279
|
+
*/
|
|
280
|
+
if (door.silence !== null &&
|
|
281
|
+
reading.standings.unknown < reading.parts.length) {
|
|
282
|
+
unscaled.push({
|
|
283
|
+
treeId: reading.treeId,
|
|
284
|
+
revision: reading.revision,
|
|
285
|
+
silence: door.silence,
|
|
286
|
+
});
|
|
287
|
+
}
|
|
288
|
+
const page = { revision, door, unwalked: action.unwalked };
|
|
289
|
+
for (const part of action.parts) {
|
|
290
|
+
const keys = [
|
|
291
|
+
{ by: "type", type: part.type },
|
|
292
|
+
{ by: "role", role: part.role },
|
|
293
|
+
];
|
|
294
|
+
placements += 1;
|
|
295
|
+
standings[part.standing] += 1;
|
|
296
|
+
if (part.bearsParts)
|
|
297
|
+
insides += 1;
|
|
298
|
+
else
|
|
299
|
+
leaves += 1;
|
|
300
|
+
for (const kind of keys) {
|
|
301
|
+
const key = kindKeyOf(kind);
|
|
302
|
+
const tally = tallies.get(key) ?? tallying(kind);
|
|
303
|
+
if (kind.by === "type") {
|
|
304
|
+
if (tally.placements === 0)
|
|
305
|
+
tally.role = part.role;
|
|
306
|
+
else if (tally.role !== part.role)
|
|
307
|
+
disagreed.add(part.type);
|
|
308
|
+
}
|
|
309
|
+
add(tally, part, page);
|
|
310
|
+
tallies.set(key, tally);
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
const built = [...tallies.values()].map(rowOf);
|
|
315
|
+
const byType = built.filter((row) => row.kind.by === "type").sort(worseOf);
|
|
316
|
+
return {
|
|
317
|
+
byType,
|
|
318
|
+
byRole: built.filter((row) => row.kind.by === "role").sort(worseOf),
|
|
319
|
+
pages,
|
|
320
|
+
trees: trees.size,
|
|
321
|
+
placements,
|
|
322
|
+
insides,
|
|
323
|
+
leaves,
|
|
324
|
+
arrivals,
|
|
325
|
+
standings,
|
|
326
|
+
mostIgnored: byType.find((row) => (row.ignored ?? 0) > 0 && row.roots < row.placements) ?? null,
|
|
327
|
+
unranked: byType.filter((row) => row.share !== null && row.ignored === null && row.roots < row.placements).length,
|
|
328
|
+
scaled,
|
|
329
|
+
unscaled: [...unscaled].sort(byPage),
|
|
330
|
+
unwalked: [...unwalked].sort(byPage),
|
|
331
|
+
duplicated,
|
|
332
|
+
duplicatedRows,
|
|
333
|
+
roleDisagreed: [...disagreed].sort((one, other) => one.localeCompare(other)),
|
|
334
|
+
};
|
|
335
|
+
};
|
|
336
|
+
//# sourceMappingURL=library-action.js.map
|
|
@@ -0,0 +1,324 @@
|
|
|
1
|
+
import type { PrimitiveRole } from "../role.js";
|
|
2
|
+
import { type KindKey } from "./library.js";
|
|
3
|
+
import type { KindReachSilence } from "./library-reach.js";
|
|
4
|
+
import type { LibraryAgenda, LibraryAgendaRow, LibraryWork } from "./library-agenda.js";
|
|
5
|
+
/**
|
|
6
|
+
* **Whether a deployment's component fix-list moved, and which of its errands a
|
|
7
|
+
* release can be said to have finished.**
|
|
8
|
+
*
|
|
9
|
+
* [`library-agenda.ts`](library-agenda.ts) joins the order of readers a
|
|
10
|
+
* library's components miss to the order of what their silence costs and
|
|
11
|
+
* publishes one errand per component: rewrite it, repair its sender, both, or
|
|
12
|
+
* nothing
|
|
13
|
+
* ([0413](../../decisions/0413-the-component-to-fix-first-is-withdrawn-from-the-order-of-readers-missed-when-its-own-silence-made-the-figure.md)).
|
|
14
|
+
* It is read of **one** window, and a fix-list read once says what to do. It
|
|
15
|
+
* never says whether doing it worked.
|
|
16
|
+
*
|
|
17
|
+
* Every other reading over a deployment's library has a comparison beside it —
|
|
18
|
+
* reach, senders, silence, words, pace — and the fix-list is the one that does
|
|
19
|
+
* not, which is the reading an operator opens twice. *I repaired the accordion's
|
|
20
|
+
* sender last week; has it left the list?* is not answerable by eye from two
|
|
21
|
+
* agendas, because the thing to compare is a **word** rather than a figure and
|
|
22
|
+
* two of its four members mean different things in two windows.
|
|
23
|
+
*
|
|
24
|
+
* ## The one direction it is dangerous in, and it is a new one
|
|
25
|
+
*
|
|
26
|
+
* `LibraryWork` `none` is two states and says so: *neither reading asks for
|
|
27
|
+
* anything about this component*, and *nothing could be said about it*. One
|
|
28
|
+
* row, two sentences, and the agenda publishes the silences that distinguish
|
|
29
|
+
* them. Held against itself across two windows, that conflation becomes a
|
|
30
|
+
* statement about progress, in the direction that flatters the deployment:
|
|
31
|
+
*
|
|
32
|
+
* > The accordion asked to be rewritten last week. This week the rollup is
|
|
33
|
+
* > behind on the page it stands on, so the order of readers missed can say
|
|
34
|
+
* > nothing about it, so its errand is `none`.
|
|
35
|
+
*
|
|
36
|
+
* Read as a shift, that is **done**. Nothing was done. A fix-list that reports
|
|
37
|
+
* its own blindness as progress is 0330's defect one reading along: the figure
|
|
38
|
+
* is not merely wrong, it is wrong in the direction nobody checks.
|
|
39
|
+
*
|
|
40
|
+
* So the rule, and it is the whole of this file: **a shift is read only where
|
|
41
|
+
* the order of readers missed spoke about the component in both windows.**
|
|
42
|
+
* Everywhere else the shift is `unknown`, and
|
|
43
|
+
* {@link LibraryAgendaChangeRow.silenced} says which window could not say while
|
|
44
|
+
* {@link LibraryAgendaChangeRow.silence} says why, in that reading's own
|
|
45
|
+
* vocabulary.
|
|
46
|
+
*
|
|
47
|
+
* **It withholds the ambiguity exactly, and that is provable rather than
|
|
48
|
+
* hoped for.** An errand is the answer to two questions — *do readers miss it*
|
|
49
|
+
* and *are its senders faulted* — and a reach silence is one of the two
|
|
50
|
+
* unasked. `library` and `both` each require a rank, a rank requires `missed`,
|
|
51
|
+
* and `missed` is `null` under every reason the reach reading has for saying
|
|
52
|
+
* nothing; so a silent side's errand is always `none` or `collection`, the two
|
|
53
|
+
* that are read off an absence. The rule therefore fires on every row whose
|
|
54
|
+
* errand rests on a question nobody asked and on no other row, which is
|
|
55
|
+
* asserted in the test file rather than argued here.
|
|
56
|
+
*
|
|
57
|
+
* The case worth reading twice is the one where the withheld errand is **true**.
|
|
58
|
+
* A component whose only copy is unclaimed has a real sender errand and no rank
|
|
59
|
+
* at all: `collection` is the right word for that window, and the shift is
|
|
60
|
+
* still withheld, because `turned` would say the rewrite errand ended and
|
|
61
|
+
* nothing in either window knows whether it did.
|
|
62
|
+
*
|
|
63
|
+
* ## Why the other half of the agenda needs no silence of its own
|
|
64
|
+
*
|
|
65
|
+
* The errand is decided off three questions — was it ranked, are its senders
|
|
66
|
+
* faulted, and is the rank evidence — and only the first of the three can be
|
|
67
|
+
* withheld. `ranked` is `missed > 0`, and `missed` is `null` under every reason
|
|
68
|
+
* a kind's reach reading has for saying nothing. `faulted` and `spoiled` are
|
|
69
|
+
* read off `silent` and `indeterminate`, which are **counts of placements**: a
|
|
70
|
+
* census of the senders answers them whether or not a door could be scaled or a
|
|
71
|
+
* window folded, and `librarySendersReachOf` publishes them beside a `silence`
|
|
72
|
+
* that is about its share and not about them.
|
|
73
|
+
*
|
|
74
|
+
* A kind nobody stood inside has `silent: 0` and so is not faulted, which is
|
|
75
|
+
* the right answer rather than a withheld one: no sender defect is demonstrable
|
|
76
|
+
* where nothing was there to demonstrate it. That asymmetry is the reason this
|
|
77
|
+
* reading publishes **no silence set of its own**: there is one reading that can
|
|
78
|
+
* be silent about an errand, its vocabulary is already asked of a kind, and a
|
|
79
|
+
* member of this file's own would be a second name for one state. What is
|
|
80
|
+
* published beside it is the one fact that is this reading's — *which of the two
|
|
81
|
+
* windows* — as {@link LibraryAgendaSide}.
|
|
82
|
+
*
|
|
83
|
+
* ## A contested row is carried, and it is not a withholding
|
|
84
|
+
*
|
|
85
|
+
* 0413 withdraws a component from the order of readers missed when its own
|
|
86
|
+
* silent copies made the rank. **There is no rank here to withdraw**: a shift is
|
|
87
|
+
* a word about an errand, and a spoiled component's errand — repair its sender —
|
|
88
|
+
* is the correct errand on the strength of the silence itself. So
|
|
89
|
+
* {@link LibraryAgendaChange.contested} is a **slice** of the rows and never a
|
|
90
|
+
* withholding, and a component repaired between two windows reports `done`
|
|
91
|
+
* exactly as it should.
|
|
92
|
+
*
|
|
93
|
+
* What it is for is the sentence on the card: *this component was contested last
|
|
94
|
+
* week*, which is what tells an operator why its errand changed hands rather
|
|
95
|
+
* than finished.
|
|
96
|
+
*
|
|
97
|
+
* ## It publishes no figure of its own
|
|
98
|
+
*
|
|
99
|
+
* Every number on a row is a source agenda's own, on that agenda's own row
|
|
100
|
+
* (0265, 0327), and both rows are carried whole. Three things a comparison of
|
|
101
|
+
* two orders might have published, and did not:
|
|
102
|
+
*
|
|
103
|
+
* - **No movement in rank.** The two orders are over two windows' populations,
|
|
104
|
+
* so a component can rise five places because four others stopped being
|
|
105
|
+
* placed. A position in two differently-populated orders is not a comparison
|
|
106
|
+
* of anything, and subtracting the two would publish a figure whose commonest
|
|
107
|
+
* cause is a release.
|
|
108
|
+
* - **No corrected loss**, which is the figure the 16 November finding asks
|
|
109
|
+
* about and is still neither agenda's.
|
|
110
|
+
* - **No count of what the deployment collected.** `DeploymentAgenda.subject`
|
|
111
|
+
* is the one word about that (0326), and a second copy of it computed here is
|
|
112
|
+
* how two screens come to disagree about one deployment.
|
|
113
|
+
*
|
|
114
|
+
* ## A component is counted once, however many lists name it
|
|
115
|
+
*
|
|
116
|
+
* The permanent mistake available to a comparison of two joins is a row counted
|
|
117
|
+
* twice (0158). Both inputs publish one row per kind; a duplicate arrives only
|
|
118
|
+
* from a hand-built agenda, and it is deduplicated on `kindKeyOf` with the first
|
|
119
|
+
* appearance kept and counted in {@link LibraryAgendaChange.duplicated}. The
|
|
120
|
+
* published lists walk their source agendas' own orders and take each key at
|
|
121
|
+
* most once, so a component twice in an input is not a component twice in a
|
|
122
|
+
* list.
|
|
123
|
+
*
|
|
124
|
+
* Pure, linear in the two agendas, and reaches no store, clock or DOM.
|
|
125
|
+
*/
|
|
126
|
+
/**
|
|
127
|
+
* Which of the two windows could not speak about a component.
|
|
128
|
+
*
|
|
129
|
+
* Published beside the reason rather than folded into it, because the reason is
|
|
130
|
+
* the reach reading's own vocabulary and the **window** is this reading's own
|
|
131
|
+
* fact. A card saying *the rollup is behind on a page it stands on* has to say
|
|
132
|
+
* which week, or it sends a deployment to wait for a window that has already
|
|
133
|
+
* caught up.
|
|
134
|
+
*/
|
|
135
|
+
export type LibraryAgendaSide = "earlier" | "later" | "both";
|
|
136
|
+
export declare const LIBRARY_AGENDA_SIDES: readonly LibraryAgendaSide[];
|
|
137
|
+
/** One line per side, for a surface saying which window is missing. */
|
|
138
|
+
export declare const describeLibraryAgendaSide: (side: LibraryAgendaSide) => string;
|
|
139
|
+
/**
|
|
140
|
+
* What became of one component's errand between two windows.
|
|
141
|
+
*
|
|
142
|
+
* The axis is the **errand** and not a figure, which is what makes the set
|
|
143
|
+
* small and the words plain: an operator reads a fix-list to find work, and
|
|
144
|
+
* reads it again to find out whether the work is still there.
|
|
145
|
+
*/
|
|
146
|
+
export type LibraryAgendaShift =
|
|
147
|
+
/**
|
|
148
|
+
* It asked for work in the earlier window and asks for none now.
|
|
149
|
+
*
|
|
150
|
+
* The only member that says a release finished something, and the reason the
|
|
151
|
+
* silence above is withheld rather than guessed: `none` is also what a window
|
|
152
|
+
* that cannot speak about a component publishes.
|
|
153
|
+
*/
|
|
154
|
+
"done"
|
|
155
|
+
/** It asked for nothing in the earlier window and asks for work now. */
|
|
156
|
+
| "arrived"
|
|
157
|
+
/**
|
|
158
|
+
* It asks for work in both windows and it is different work.
|
|
159
|
+
*
|
|
160
|
+
* *Readers were skipping it; now its sender is broken* and its opposite are
|
|
161
|
+
* both this, and the two rows carry which. An errand that changed hands is
|
|
162
|
+
* not an errand finished, which is the distinction a single *still open*
|
|
163
|
+
* member would lose.
|
|
164
|
+
*/
|
|
165
|
+
| "turned"
|
|
166
|
+
/** It asks for the same work in both windows. */
|
|
167
|
+
| "standing"
|
|
168
|
+
/** Neither window asked for anything about it, and both windows could speak. */
|
|
169
|
+
| "clear"
|
|
170
|
+
/**
|
|
171
|
+
* One of the two windows could not speak about it, so there is no before and
|
|
172
|
+
* after to read.
|
|
173
|
+
*
|
|
174
|
+
* {@link LibraryAgendaChangeRow.silence} says which reason, and the two
|
|
175
|
+
* windows' own errands stand on the row either way: withheld here means *this
|
|
176
|
+
* reading will not call it progress*, never *the agendas said nothing*.
|
|
177
|
+
*/
|
|
178
|
+
| "unknown";
|
|
179
|
+
export declare const LIBRARY_AGENDA_SHIFTS: readonly LibraryAgendaShift[];
|
|
180
|
+
/** One line per member, for a surface saying what became of a component's errand. */
|
|
181
|
+
export declare const describeLibraryAgendaShift: (shift: LibraryAgendaShift) => string;
|
|
182
|
+
/** One kind of part's errand, held against itself across two windows. */
|
|
183
|
+
export type LibraryAgendaChangeRow = {
|
|
184
|
+
readonly kind: KindKey;
|
|
185
|
+
/**
|
|
186
|
+
* What part the type plays (0114), or `null`.
|
|
187
|
+
*
|
|
188
|
+
* The later window's answer, so a surface reading a row is reading today's
|
|
189
|
+
* library. Always a type key here, never a role.
|
|
190
|
+
*/
|
|
191
|
+
readonly role: PrimitiveRole | null;
|
|
192
|
+
readonly shift: LibraryAgendaShift;
|
|
193
|
+
/** The errand the earlier window published, whatever this reading says about progress. */
|
|
194
|
+
readonly was: LibraryWork;
|
|
195
|
+
/** The errand the later window publishes. */
|
|
196
|
+
readonly now: LibraryWork;
|
|
197
|
+
/** True where either window's rank was made by the component's own silent copies (0413). */
|
|
198
|
+
readonly contested: boolean;
|
|
199
|
+
readonly spoiledWas: boolean;
|
|
200
|
+
readonly spoiledNow: boolean;
|
|
201
|
+
/**
|
|
202
|
+
* Why there is no before and after, in **the reach reading's own vocabulary**
|
|
203
|
+
* rather than a second spelling of it.
|
|
204
|
+
*
|
|
205
|
+
* Reused outright, not respelled, the way a funnel answer reuses a page's
|
|
206
|
+
* reach silence: the subject is a kind in both readings and the state of the
|
|
207
|
+
* world is the same one — the order of readers missed had nothing to say
|
|
208
|
+
* about this kind of part. A member of its own here would be a second name
|
|
209
|
+
* for one state, which is the thing this subsystem spends the most care not
|
|
210
|
+
* to publish.
|
|
211
|
+
*
|
|
212
|
+
* **The later window's reason where both windows have one**, because that is
|
|
213
|
+
* the reason a deployment still has a remedy for; {@link silenced} says which
|
|
214
|
+
* window, and the earlier window's own reason stands whole on
|
|
215
|
+
* {@link earlier}.
|
|
216
|
+
*/
|
|
217
|
+
readonly silence: KindReachSilence | null;
|
|
218
|
+
/** Which window could not speak, or `null` where both could. */
|
|
219
|
+
readonly silenced: LibraryAgendaSide | null;
|
|
220
|
+
/** The earlier agenda's whole row, so a surface never holds two lists side by side. */
|
|
221
|
+
readonly earlier: LibraryAgendaRow;
|
|
222
|
+
/** The later agenda's whole row. */
|
|
223
|
+
readonly later: LibraryAgendaRow;
|
|
224
|
+
};
|
|
225
|
+
/** Where the one thing to do first stood in each window. */
|
|
226
|
+
export type LibraryAgendaHead = {
|
|
227
|
+
/** The component at the head of the earlier agenda, or `null` where it asked for nothing. */
|
|
228
|
+
readonly earlier: KindKey | null;
|
|
229
|
+
readonly later: KindKey | null;
|
|
230
|
+
/**
|
|
231
|
+
* Whether it is the same component, two `null`s included.
|
|
232
|
+
*
|
|
233
|
+
* Read off each agenda's own `first` rather than recomputed, so a surface
|
|
234
|
+
* saying *the top of your list has not moved in a week* is saying what those
|
|
235
|
+
* two screens said.
|
|
236
|
+
*/
|
|
237
|
+
readonly same: boolean;
|
|
238
|
+
};
|
|
239
|
+
/** What two windows of a deployment's component fix-list say about each other. */
|
|
240
|
+
export type LibraryAgendaChange = {
|
|
241
|
+
/** Every component on both agendas, by type, in the later agenda's own row order. */
|
|
242
|
+
readonly rows: readonly LibraryAgendaChangeRow[];
|
|
243
|
+
/**
|
|
244
|
+
* Components that asked for work and ask for none now, in the **earlier**
|
|
245
|
+
* agenda's own orders — readers missed first, then readings lost — each
|
|
246
|
+
* component once.
|
|
247
|
+
*
|
|
248
|
+
* The earlier agenda's order because the later one no longer ranks them: a
|
|
249
|
+
* component with no errand is in neither of its lists.
|
|
250
|
+
*/
|
|
251
|
+
readonly done: readonly LibraryAgendaChangeRow[];
|
|
252
|
+
/** Components that ask for work now and asked for none, in the **later** agenda's own orders. */
|
|
253
|
+
readonly arrived: readonly LibraryAgendaChangeRow[];
|
|
254
|
+
/**
|
|
255
|
+
* Components asking for work in both windows, in the later agenda's own
|
|
256
|
+
* orders.
|
|
257
|
+
*
|
|
258
|
+
* The shifts `standing` and `turned` together, because *still on the list* is
|
|
259
|
+
* one question and an errand that changed hands is still on the list. Which
|
|
260
|
+
* of the two a row is, and what it turned from, is on the row.
|
|
261
|
+
*/
|
|
262
|
+
readonly outstanding: readonly LibraryAgendaChangeRow[];
|
|
263
|
+
/**
|
|
264
|
+
* Rows whose shift this reading will not call progress, carrying both
|
|
265
|
+
* windows' errands.
|
|
266
|
+
*
|
|
267
|
+
* A **slice** of {@link rows} and never a list beside it, so the counts in
|
|
268
|
+
* {@link shifts} add to the rows there are (0158), and never dropped quietly:
|
|
269
|
+
* a component this reading has nothing to say about is findable with the
|
|
270
|
+
* reason it has nothing to say (0301, 0326).
|
|
271
|
+
*/
|
|
272
|
+
readonly withheld: readonly LibraryAgendaChangeRow[];
|
|
273
|
+
/**
|
|
274
|
+
* Rows where either window's rank was its own silence's doing.
|
|
275
|
+
*
|
|
276
|
+
* A slice of {@link rows}, and **not** a withholding: an errand is not a
|
|
277
|
+
* rank, so a contested component's shift is read like any other's. It is the
|
|
278
|
+
* sentence that says why an errand changed hands rather than finished.
|
|
279
|
+
*/
|
|
280
|
+
readonly contested: readonly LibraryAgendaChangeRow[];
|
|
281
|
+
/** How many components each shift covers, over {@link rows}. */
|
|
282
|
+
readonly shifts: Readonly<Record<LibraryAgendaShift, number>>;
|
|
283
|
+
/** Where the one thing to do first stood in each window. */
|
|
284
|
+
readonly head: LibraryAgendaHead;
|
|
285
|
+
/**
|
|
286
|
+
* Components one agenda named and the other did not, which is nought for a
|
|
287
|
+
* caller that read two windows of the same deployment.
|
|
288
|
+
*
|
|
289
|
+
* Both agendas are over *the pages their caller read*, so a caller holding
|
|
290
|
+
* agendas of two different sets of pages gets a comparison silently of the
|
|
291
|
+
* intersection.
|
|
292
|
+
*/
|
|
293
|
+
readonly unpaired: {
|
|
294
|
+
readonly earlier: number;
|
|
295
|
+
readonly later: number;
|
|
296
|
+
};
|
|
297
|
+
/** Rows for a component beyond the first, on either side, which were dropped (0158). */
|
|
298
|
+
readonly duplicated: number;
|
|
299
|
+
};
|
|
300
|
+
/**
|
|
301
|
+
* Hold a deployment's component fix-list against an earlier reading of it, and
|
|
302
|
+
* publish what became of each errand.
|
|
303
|
+
*
|
|
304
|
+
* ```ts
|
|
305
|
+
* const moved = libraryAgendaChangeOf(
|
|
306
|
+
* libraryAgendaOf(lastWeek.reach, lastWeek.senders),
|
|
307
|
+
* libraryAgendaOf(thisWeek.reach, thisWeek.senders)
|
|
308
|
+
* )
|
|
309
|
+
* ```
|
|
310
|
+
*
|
|
311
|
+
* The two agendas are handed in rather than derived here, on the terms every
|
|
312
|
+
* derived reading in this subsystem takes readings: each is separately useful
|
|
313
|
+
* and separately drawn, and deriving either a second time is how two screens
|
|
314
|
+
* come to disagree about one deployment (0330).
|
|
315
|
+
*
|
|
316
|
+
* @param earlier The agenda of the earlier window, as `libraryAgendaOf`
|
|
317
|
+
* answered it.
|
|
318
|
+
* @param later The agenda of the later window. **Both are required**, on the
|
|
319
|
+
* terms every input of a fix-list is required (0322, 0343): an argument a caller
|
|
320
|
+
* may omit is a comparison that type-checks, runs, and calls a deployment's
|
|
321
|
+
* whole library finished.
|
|
322
|
+
*/
|
|
323
|
+
export declare const libraryAgendaChangeOf: (earlier: LibraryAgenda, later: LibraryAgenda) => LibraryAgendaChange;
|
|
324
|
+
//# sourceMappingURL=library-agenda-change.d.ts.map
|