@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
package/dist/tree/navigation.js
CHANGED
|
@@ -3,11 +3,19 @@ import { childrenOf } from "./node.js";
|
|
|
3
3
|
* Read-only traversal. Every function here takes a root and derives a view;
|
|
4
4
|
* nothing caches, because a cache would be a second source of truth about a
|
|
5
5
|
* structure that changes on every accepted delta.
|
|
6
|
+
*
|
|
7
|
+
* **Nothing here recurses into the tree**, which is a correctness requirement
|
|
8
|
+
* rather than a preference (0372): a page's depth is data, so a walk that
|
|
9
|
+
* spends a call frame per level stops answering at a depth a tree is allowed to
|
|
10
|
+
* reach. Every walk below carries an explicit stack and is linear in nodes.
|
|
6
11
|
*/
|
|
7
12
|
export function* walkTree(root) {
|
|
8
|
-
|
|
9
|
-
for (
|
|
10
|
-
yield
|
|
13
|
+
const pending = [root];
|
|
14
|
+
for (let node = pending.pop(); node !== undefined; node = pending.pop()) {
|
|
15
|
+
yield node;
|
|
16
|
+
for (const child of [...childrenOf(node)].reverse())
|
|
17
|
+
pending.push(child);
|
|
18
|
+
}
|
|
11
19
|
}
|
|
12
20
|
export const collectNodeIds = (root) => Array.from(walkTree(root), (node) => node.id);
|
|
13
21
|
export const findNode = (root, nodeId) => {
|
|
@@ -25,18 +33,26 @@ export const findParent = (root, nodeId) => {
|
|
|
25
33
|
}
|
|
26
34
|
return null;
|
|
27
35
|
};
|
|
36
|
+
const chainTo = (descent) => {
|
|
37
|
+
const chain = [];
|
|
38
|
+
for (let step = descent; step !== null; step = step.from) {
|
|
39
|
+
chain.push(step.node);
|
|
40
|
+
}
|
|
41
|
+
return chain.reverse();
|
|
42
|
+
};
|
|
28
43
|
/**
|
|
29
44
|
* The chain of nodes from the root down to and including `nodeId`, or null when
|
|
30
45
|
* the node is absent. Paths are derived on demand and never persisted — the id
|
|
31
46
|
* is the stable address, the path is the current position.
|
|
32
47
|
*/
|
|
33
48
|
export const nodePath = (root, nodeId) => {
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
49
|
+
const pending = [{ node: root, from: null }];
|
|
50
|
+
for (let descent = pending.pop(); descent !== undefined; descent = pending.pop()) {
|
|
51
|
+
if (descent.node.id === nodeId)
|
|
52
|
+
return chainTo(descent);
|
|
53
|
+
for (const child of [...childrenOf(descent.node)].reverse()) {
|
|
54
|
+
pending.push({ node: child, from: descent });
|
|
55
|
+
}
|
|
40
56
|
}
|
|
41
57
|
return null;
|
|
42
58
|
};
|
|
@@ -46,7 +62,13 @@ export const isDescendantOf = (root, ancestorId, nodeId) => {
|
|
|
46
62
|
const ancestor = findNode(root, ancestorId);
|
|
47
63
|
if (!ancestor)
|
|
48
64
|
return false;
|
|
49
|
-
|
|
65
|
+
const beneath = walkTree(ancestor);
|
|
66
|
+
beneath.next(); // a node is not its own descendant, and the walk yields it first
|
|
67
|
+
for (const node of beneath) {
|
|
68
|
+
if (node.id === nodeId)
|
|
69
|
+
return true;
|
|
70
|
+
}
|
|
71
|
+
return false;
|
|
50
72
|
};
|
|
51
73
|
/**
|
|
52
74
|
* What a node says: every text node under it, in tree order, concatenated.
|
package/dist/tree/outline.d.ts
CHANGED
|
@@ -13,6 +13,13 @@ import { type LoomNode } from "./node.js";
|
|
|
13
13
|
* `index` is the position among the parent's children, which is the same number
|
|
14
14
|
* an `insert` or a `move` names — an outline row is therefore enough to address
|
|
15
15
|
* a position, not only a node.
|
|
16
|
+
*
|
|
17
|
+
* The walk carries an **explicit stack** and is not recursive, which is a
|
|
18
|
+
* correctness requirement rather than a preference (0372). A recursive
|
|
19
|
+
* generator delegating with `yield*` passes every value back up through each
|
|
20
|
+
* delegating frame, so a node at depth *d* costs *d*, the walk costs the sum of
|
|
21
|
+
* the depths rather than the number of nodes, and past about two thousand deep
|
|
22
|
+
* it does not return at all.
|
|
16
23
|
*/
|
|
17
24
|
export type OutlineEntry = {
|
|
18
25
|
readonly node: LoomNode;
|
package/dist/tree/outline.js
CHANGED
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
import { childrenOf } from "./node.js";
|
|
2
|
-
function* walkOutline(
|
|
3
|
-
|
|
4
|
-
for (
|
|
5
|
-
yield
|
|
2
|
+
function* walkOutline(root) {
|
|
3
|
+
const pending = [{ node: root, depth: 0, parentId: null, index: 0 }];
|
|
4
|
+
for (let entry = pending.pop(); entry !== undefined; entry = pending.pop()) {
|
|
5
|
+
yield entry;
|
|
6
|
+
const nested = Array.from(childrenOf(entry.node).entries()).reverse();
|
|
7
|
+
for (const [index, child] of nested) {
|
|
8
|
+
pending.push({ node: child, depth: entry.depth + 1, parentId: entry.node.id, index });
|
|
9
|
+
}
|
|
6
10
|
}
|
|
7
11
|
}
|
|
8
12
|
/** Pre-order, so a row is always preceded by the row it is nested inside. */
|
|
9
|
-
export const outlineTree = (root) => Array.from(walkOutline(root
|
|
13
|
+
export const outlineTree = (root) => Array.from(walkOutline(root));
|
|
10
14
|
//# sourceMappingURL=outline.js.map
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import type { ChangeInterpreter } from "../runtime/interpreter.js";
|
|
2
|
+
import type { CompositionRuntime } from "../runtime/pipeline.js";
|
|
3
|
+
/**
|
|
4
|
+
* The runtime a change the runtime computed is judged under.
|
|
5
|
+
*
|
|
6
|
+
* An undo and a reseed are both changes nothing interpreted: the operations are
|
|
7
|
+
* derived, and what reaches the Gate is a proposal wearing a deterministic
|
|
8
|
+
* interpreter instead of a model (`inverseInterpreter`). Both therefore want the
|
|
9
|
+
* same thing from the host's runtime — every seam that *judges* a change, and
|
|
10
|
+
* not the one that would offer a smaller version of it.
|
|
11
|
+
*
|
|
12
|
+
* ## Why this is a function and not two object literals
|
|
13
|
+
*
|
|
14
|
+
* `revertRevision` built its runtime field by field, and the comment above it
|
|
15
|
+
* said why: dropping the repairer should be a statement rather than an omission.
|
|
16
|
+
* That reasoning was right about the repairer and wrong about the method, and the
|
|
17
|
+
* difference only showed when `CompositionRuntime` grew. `propsVocabulary` and
|
|
18
|
+
* `bindingReader` arrived afterwards (0179, 0208), and a literal that names five
|
|
19
|
+
* fields does not fail to compile when a sixth appears — it silently stops
|
|
20
|
+
* passing it.
|
|
21
|
+
*
|
|
22
|
+
* So every undo was judged as though the host had wired neither check. Two
|
|
23
|
+
* consequences, and the second is worse than the first:
|
|
24
|
+
*
|
|
25
|
+
* - a deployment that refuses AI-authored props its own schemas reject did not
|
|
26
|
+
* refuse them on the undo path, which is a real hole in a real check;
|
|
27
|
+
* - `Disposition.wiredChecks` recorded the undo as judged with both seams
|
|
28
|
+
* absent, which is **0248's point inverted**. That field exists because the
|
|
29
|
+
* policy fingerprint cannot see a seam, so wiring one has to leave a record of
|
|
30
|
+
* the day it was wired. A record saying a wired check was not wired is worse
|
|
31
|
+
* than no record, because a later reading of the log cannot tell it from the
|
|
32
|
+
* truth.
|
|
33
|
+
*
|
|
34
|
+
* Nothing was failing. Nothing was going to start failing on its own, either:
|
|
35
|
+
* the drop is invisible to every test that does not wire a vocabulary *and* then
|
|
36
|
+
* undo something, and it would have been copied into the reseed path by anybody
|
|
37
|
+
* reading the revert path as the pattern — which is exactly what this run set
|
|
38
|
+
* out to do.
|
|
39
|
+
*
|
|
40
|
+
* ## How the drop is made impossible rather than remembered
|
|
41
|
+
*
|
|
42
|
+
* The repairer is removed by name and everything else is carried by the rest
|
|
43
|
+
* element, so the statement is still a statement — `repairer` is written down,
|
|
44
|
+
* right here, as the one field a computed change does not get — while a seventh
|
|
45
|
+
* seam on `CompositionRuntime` reaches the Gate on the day it lands without
|
|
46
|
+
* anybody editing this file.
|
|
47
|
+
*
|
|
48
|
+
* Repair (0006) exists to let a model try a smaller version of what the Gate
|
|
49
|
+
* refused, and there is no smaller version of putting something back. A computed
|
|
50
|
+
* change the Gate refuses is refused.
|
|
51
|
+
*/
|
|
52
|
+
/**
|
|
53
|
+
* The host's runtime, with every judging seam carried and the repairer dropped.
|
|
54
|
+
*
|
|
55
|
+
* `repairer` is removed by name and the rest is spread, so the omission is still
|
|
56
|
+
* written down while a seam added to `CompositionRuntime` tomorrow reaches the
|
|
57
|
+
* Gate without anybody editing this file.
|
|
58
|
+
*/
|
|
59
|
+
export declare const computedChangeRuntime: (runtime: CompositionRuntime, interpreter: ChangeInterpreter) => CompositionRuntime;
|
|
60
|
+
//# sourceMappingURL=computed.d.ts.map
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The runtime a change the runtime computed is judged under.
|
|
3
|
+
*
|
|
4
|
+
* An undo and a reseed are both changes nothing interpreted: the operations are
|
|
5
|
+
* derived, and what reaches the Gate is a proposal wearing a deterministic
|
|
6
|
+
* interpreter instead of a model (`inverseInterpreter`). Both therefore want the
|
|
7
|
+
* same thing from the host's runtime — every seam that *judges* a change, and
|
|
8
|
+
* not the one that would offer a smaller version of it.
|
|
9
|
+
*
|
|
10
|
+
* ## Why this is a function and not two object literals
|
|
11
|
+
*
|
|
12
|
+
* `revertRevision` built its runtime field by field, and the comment above it
|
|
13
|
+
* said why: dropping the repairer should be a statement rather than an omission.
|
|
14
|
+
* That reasoning was right about the repairer and wrong about the method, and the
|
|
15
|
+
* difference only showed when `CompositionRuntime` grew. `propsVocabulary` and
|
|
16
|
+
* `bindingReader` arrived afterwards (0179, 0208), and a literal that names five
|
|
17
|
+
* fields does not fail to compile when a sixth appears — it silently stops
|
|
18
|
+
* passing it.
|
|
19
|
+
*
|
|
20
|
+
* So every undo was judged as though the host had wired neither check. Two
|
|
21
|
+
* consequences, and the second is worse than the first:
|
|
22
|
+
*
|
|
23
|
+
* - a deployment that refuses AI-authored props its own schemas reject did not
|
|
24
|
+
* refuse them on the undo path, which is a real hole in a real check;
|
|
25
|
+
* - `Disposition.wiredChecks` recorded the undo as judged with both seams
|
|
26
|
+
* absent, which is **0248's point inverted**. That field exists because the
|
|
27
|
+
* policy fingerprint cannot see a seam, so wiring one has to leave a record of
|
|
28
|
+
* the day it was wired. A record saying a wired check was not wired is worse
|
|
29
|
+
* than no record, because a later reading of the log cannot tell it from the
|
|
30
|
+
* truth.
|
|
31
|
+
*
|
|
32
|
+
* Nothing was failing. Nothing was going to start failing on its own, either:
|
|
33
|
+
* the drop is invisible to every test that does not wire a vocabulary *and* then
|
|
34
|
+
* undo something, and it would have been copied into the reseed path by anybody
|
|
35
|
+
* reading the revert path as the pattern — which is exactly what this run set
|
|
36
|
+
* out to do.
|
|
37
|
+
*
|
|
38
|
+
* ## How the drop is made impossible rather than remembered
|
|
39
|
+
*
|
|
40
|
+
* The repairer is removed by name and everything else is carried by the rest
|
|
41
|
+
* element, so the statement is still a statement — `repairer` is written down,
|
|
42
|
+
* right here, as the one field a computed change does not get — while a seventh
|
|
43
|
+
* seam on `CompositionRuntime` reaches the Gate on the day it lands without
|
|
44
|
+
* anybody editing this file.
|
|
45
|
+
*
|
|
46
|
+
* Repair (0006) exists to let a model try a smaller version of what the Gate
|
|
47
|
+
* refused, and there is no smaller version of putting something back. A computed
|
|
48
|
+
* change the Gate refuses is refused.
|
|
49
|
+
*/
|
|
50
|
+
/**
|
|
51
|
+
* The host's runtime, with every judging seam carried and the repairer dropped.
|
|
52
|
+
*
|
|
53
|
+
* `repairer` is removed by name and the rest is spread, so the omission is still
|
|
54
|
+
* written down while a seam added to `CompositionRuntime` tomorrow reaches the
|
|
55
|
+
* Gate without anybody editing this file.
|
|
56
|
+
*/
|
|
57
|
+
export const computedChangeRuntime = (runtime, interpreter) => {
|
|
58
|
+
const { repairer: _norepair, ...judging } = runtime;
|
|
59
|
+
return { ...judging, interpreter };
|
|
60
|
+
};
|
|
61
|
+
//# sourceMappingURL=computed.js.map
|
package/dist/write/held.d.ts
CHANGED
|
@@ -319,6 +319,29 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
319
319
|
confidence: z.ZodNumber;
|
|
320
320
|
policyId: z.ZodDefault<z.ZodString>;
|
|
321
321
|
policyFingerprint: z.ZodOptional<z.ZodString>;
|
|
322
|
+
wiredChecks: z.ZodOptional<z.ZodArray<z.ZodEnum<["props", "bindings", "regions"]>, "many">>;
|
|
323
|
+
irreversibilityReasons: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"code", [z.ZodObject<{
|
|
324
|
+
code: z.ZodLiteral<"out-of-tree-effect">;
|
|
325
|
+
primitiveTypes: z.ZodArray<z.ZodBranded<z.ZodString, "PrimitiveType">, "many">;
|
|
326
|
+
}, "strip", z.ZodTypeAny, {
|
|
327
|
+
code: "out-of-tree-effect";
|
|
328
|
+
primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
|
|
329
|
+
}, {
|
|
330
|
+
code: "out-of-tree-effect";
|
|
331
|
+
primitiveTypes: string[];
|
|
332
|
+
}>, z.ZodObject<{
|
|
333
|
+
code: z.ZodLiteral<"retention-budget-exceeded">;
|
|
334
|
+
retainedNodeCount: z.ZodNumber;
|
|
335
|
+
budget: z.ZodNumber;
|
|
336
|
+
}, "strip", z.ZodTypeAny, {
|
|
337
|
+
code: "retention-budget-exceeded";
|
|
338
|
+
retainedNodeCount: number;
|
|
339
|
+
budget: number;
|
|
340
|
+
}, {
|
|
341
|
+
code: "retention-budget-exceeded";
|
|
342
|
+
retainedNodeCount: number;
|
|
343
|
+
budget: number;
|
|
344
|
+
}>]>, "many">>;
|
|
322
345
|
}, "strip", z.ZodTypeAny, {
|
|
323
346
|
kind: "rejected" | "accepted" | "requires-confirmation";
|
|
324
347
|
confidence: number;
|
|
@@ -330,6 +353,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
330
353
|
stakes: "low" | "medium" | "high" | "critical";
|
|
331
354
|
reversible: boolean;
|
|
332
355
|
policyFingerprint?: string | undefined;
|
|
356
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
357
|
+
irreversibilityReasons?: ({
|
|
358
|
+
code: "out-of-tree-effect";
|
|
359
|
+
primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
|
|
360
|
+
} | {
|
|
361
|
+
code: "retention-budget-exceeded";
|
|
362
|
+
retainedNodeCount: number;
|
|
363
|
+
budget: number;
|
|
364
|
+
})[] | undefined;
|
|
333
365
|
}, {
|
|
334
366
|
kind: "rejected" | "accepted" | "requires-confirmation";
|
|
335
367
|
confidence: number;
|
|
@@ -341,6 +373,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
341
373
|
reversible: boolean;
|
|
342
374
|
policyId?: string | undefined;
|
|
343
375
|
policyFingerprint?: string | undefined;
|
|
376
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
377
|
+
irreversibilityReasons?: ({
|
|
378
|
+
code: "out-of-tree-effect";
|
|
379
|
+
primitiveTypes: string[];
|
|
380
|
+
} | {
|
|
381
|
+
code: "retention-budget-exceeded";
|
|
382
|
+
retainedNodeCount: number;
|
|
383
|
+
budget: number;
|
|
384
|
+
})[] | undefined;
|
|
344
385
|
}>;
|
|
345
386
|
heldAt: z.ZodString;
|
|
346
387
|
}, "strip", z.ZodTypeAny, {
|
|
@@ -402,6 +443,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
402
443
|
stakes: "low" | "medium" | "high" | "critical";
|
|
403
444
|
reversible: boolean;
|
|
404
445
|
policyFingerprint?: string | undefined;
|
|
446
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
447
|
+
irreversibilityReasons?: ({
|
|
448
|
+
code: "out-of-tree-effect";
|
|
449
|
+
primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
|
|
450
|
+
} | {
|
|
451
|
+
code: "retention-budget-exceeded";
|
|
452
|
+
retainedNodeCount: number;
|
|
453
|
+
budget: number;
|
|
454
|
+
})[] | undefined;
|
|
405
455
|
};
|
|
406
456
|
intent: {
|
|
407
457
|
treeId: string & z.BRAND<"TreeId">;
|
|
@@ -473,6 +523,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
473
523
|
reversible: boolean;
|
|
474
524
|
policyId?: string | undefined;
|
|
475
525
|
policyFingerprint?: string | undefined;
|
|
526
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
527
|
+
irreversibilityReasons?: ({
|
|
528
|
+
code: "out-of-tree-effect";
|
|
529
|
+
primitiveTypes: string[];
|
|
530
|
+
} | {
|
|
531
|
+
code: "retention-budget-exceeded";
|
|
532
|
+
retainedNodeCount: number;
|
|
533
|
+
budget: number;
|
|
534
|
+
})[] | undefined;
|
|
476
535
|
};
|
|
477
536
|
intent: {
|
|
478
537
|
treeId: string;
|
package/dist/write/index.d.ts
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Committing a judged change, and taking one back.
|
|
3
3
|
*
|
|
4
|
-
* The
|
|
5
|
-
*
|
|
4
|
+
* The operations that move a tree forward or backward in the store once the gate
|
|
5
|
+
* has had its say — including the two it computes itself, which take the same
|
|
6
|
+
* path as the ones a model proposes.
|
|
6
7
|
*/
|
|
7
8
|
export * from "./commit.js";
|
|
9
|
+
export * from "./computed.js";
|
|
8
10
|
export * from "./held.js";
|
|
9
11
|
export * from "./liveness.js";
|
|
12
|
+
export * from "./reseed.js";
|
|
10
13
|
export * from "./revert.js";
|
|
11
14
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/write/index.js
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Committing a judged change, and taking one back.
|
|
3
3
|
*
|
|
4
|
-
* The
|
|
5
|
-
*
|
|
4
|
+
* The operations that move a tree forward or backward in the store once the gate
|
|
5
|
+
* has had its say — including the two it computes itself, which take the same
|
|
6
|
+
* path as the ones a model proposes.
|
|
6
7
|
*/
|
|
7
8
|
export * from "./commit.js";
|
|
9
|
+
export * from "./computed.js";
|
|
8
10
|
export * from "./held.js";
|
|
9
11
|
export * from "./liveness.js";
|
|
12
|
+
export * from "./reseed.js";
|
|
10
13
|
export * from "./revert.js";
|
|
11
14
|
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
import type { IdFactory, TreeId } from "../ids.js";
|
|
2
|
+
import type { Clock } from "../runtime/events.js";
|
|
3
|
+
import type { IntentOrigin } from "../runtime/intent.js";
|
|
4
|
+
import type { ChangeInterpreter } from "../runtime/interpreter.js";
|
|
5
|
+
import type { DiscardedWork } from "../runtime/proposal.js";
|
|
6
|
+
import { type ReseedPlan, type UnreseedablePlan } from "../store/reseed.js";
|
|
7
|
+
import type { LoomTree } from "../tree/tree.js";
|
|
8
|
+
import { type WriteOutcome, type WritePath } from "./commit.js";
|
|
9
|
+
/**
|
|
10
|
+
* Putting a page back, as a change like any other — and the half that makes the
|
|
11
|
+
* operation pressable.
|
|
12
|
+
*
|
|
13
|
+
* `planReseed` has been able to say *here are the operations that carry this
|
|
14
|
+
* stored page to the tree its builder produces now* since 0268. Nothing
|
|
15
|
+
* proposed them. The gap that left is the one `Loom marketing` filed on 12
|
|
16
|
+
* October, and it filed it as a cost rather than as a gap, which is the version
|
|
17
|
+
* that says who is blocked:
|
|
18
|
+
*
|
|
19
|
+
* > **Merging a marketing pull request no longer changes the marketing site.**
|
|
20
|
+
*
|
|
21
|
+
* Every page of that surface is already a row on any deployment that has been
|
|
22
|
+
* visited once. Seeding is create-if-absent and must stay that way — a deploy
|
|
23
|
+
* that wrote over a stored page would throw away every change somebody accepted
|
|
24
|
+
* in the portal, which is the trade 0259 took deliberately. So an edited builder
|
|
25
|
+
* finds the same tree id it found yesterday, leaves it alone, and the authored
|
|
26
|
+
* page stops being the served one.
|
|
27
|
+
*
|
|
28
|
+
* This is `revertRevision`'s sibling and takes the same seven steps: interpreted
|
|
29
|
+
* (deterministically), proposed, assessed, gated, applied, and appended to the
|
|
30
|
+
* log as a new revision. A reseed is therefore attributable to whoever asked for
|
|
31
|
+
* it, refusable by the Gate, holdable for confirmation, visible to telemetry,
|
|
32
|
+
* and itself revertable. The log says *this page was put back on this date, by
|
|
33
|
+
* this person, over these revisions* rather than the history simply ending.
|
|
34
|
+
*
|
|
35
|
+
* ## The question this does not answer, and does not need to
|
|
36
|
+
*
|
|
37
|
+
* The entry asked for one decision beyond the operation: **who presses it.** It
|
|
38
|
+
* set out three answers — only a person, on every deploy, or a button on the
|
|
39
|
+
* page's own screen beside its history — and preferred the third.
|
|
40
|
+
*
|
|
41
|
+
* The Gate already answers it, and the answer is better than any of the three
|
|
42
|
+
* because it is not a fourth switch. 0035 made discarded work a *rule* rather
|
|
43
|
+
* than a level: a change that writes over work already in the log is never
|
|
44
|
+
* applied without a person, whatever latitude its origin has. `reseedDiscards`
|
|
45
|
+
* reads the log and declares what this reseed costs, so:
|
|
46
|
+
*
|
|
47
|
+
* - a page nobody has edited since it was seeded declares nothing, and the
|
|
48
|
+
* reseed applies. A deploy step may call this, and the authored page wins,
|
|
49
|
+
* which is the right default for a page no one has touched.
|
|
50
|
+
* - a page somebody has edited through the portal declares those revisions, and
|
|
51
|
+
* the reseed is **held** — the same hold a reviewer answers on
|
|
52
|
+
* `/portal/trust`, carrying the sentence that names what it would overwrite.
|
|
53
|
+
* A deploy step may call this too, and it cannot quietly discard the edit.
|
|
54
|
+
*
|
|
55
|
+
* So the caller does not choose the safety; the cost of the particular reseed
|
|
56
|
+
* does. The surfaces are then free to offer the button wherever it belongs
|
|
57
|
+
* (`Loom portal`'s to place), because every route to it is the same route.
|
|
58
|
+
*
|
|
59
|
+
* ## What this does not become
|
|
60
|
+
*
|
|
61
|
+
* `TreeStore` still gains nothing — no delete, no reseed method, nothing that
|
|
62
|
+
* writes a tree without being proposed (0268). Seeding is still create-only.
|
|
63
|
+
* What is new is one function a surface can call, and it goes through the one
|
|
64
|
+
* write path (0017) like everything else that becomes history.
|
|
65
|
+
*/
|
|
66
|
+
/** What produced the delta, for `Provenance.interpreter`. Not a model. */
|
|
67
|
+
export declare const RESEED_INTERPRETER = "loom/reseed";
|
|
68
|
+
export type ReseedablePlan = Extract<ReseedPlan, {
|
|
69
|
+
readonly outcome: "reseedable";
|
|
70
|
+
}>;
|
|
71
|
+
/** Everything that stops a reseed being proposed. `already-authored` is not one — see `ReseedOutcome`. */
|
|
72
|
+
export type UnproposableReseed = Exclude<UnreseedablePlan, {
|
|
73
|
+
readonly outcome: "already-authored";
|
|
74
|
+
}>;
|
|
75
|
+
/**
|
|
76
|
+
* The same interpreter every reseed uses, with the plan's half filled in.
|
|
77
|
+
*
|
|
78
|
+
* Everything specific to a reseed is here — the stamp that says the runtime
|
|
79
|
+
* planned this against a builder, the rationale a reviewer reads, and the
|
|
80
|
+
* discards the log read found. What is left is `inverseInterpreter`: the head
|
|
81
|
+
* check, the provenance of a computed change, and the shape of the proposal are
|
|
82
|
+
* one implementation rather than two that drift.
|
|
83
|
+
*
|
|
84
|
+
* `undoes` is **absent**, and that is not an omission. It names the one revision
|
|
85
|
+
* a change puts back, and a reseed puts back no revision — it carries the page
|
|
86
|
+
* to a tree that was never in the log, over however many entries stand in the
|
|
87
|
+
* way. Stamping any number there would be a claim the log cannot support; the
|
|
88
|
+
* revisions it writes over are in `discards`, where they are true.
|
|
89
|
+
*/
|
|
90
|
+
export declare const reseedInterpreter: (plan: ReseedablePlan, discards: readonly DiscardedWork[], idFactory: IdFactory, clock: Clock) => ChangeInterpreter;
|
|
91
|
+
export type ReseedRequest = {
|
|
92
|
+
readonly treeId: TreeId;
|
|
93
|
+
/**
|
|
94
|
+
* A fresh build of the page — what the builder in the repository produces now.
|
|
95
|
+
*
|
|
96
|
+
* The caller's rather than something this module could obtain, because a
|
|
97
|
+
* builder is the host's: §3 has no registry of pages and no way to run one.
|
|
98
|
+
* The surfaces hold theirs already, and both sides of the comparison being
|
|
99
|
+
* passed in is what keeps this testable without a build step.
|
|
100
|
+
*/
|
|
101
|
+
readonly authored: LoomTree;
|
|
102
|
+
readonly origin: IntentOrigin;
|
|
103
|
+
readonly actor?: string;
|
|
104
|
+
};
|
|
105
|
+
export type ReseedOutcome = WriteOutcome
|
|
106
|
+
/**
|
|
107
|
+
* The stored page is already the tree the builder produces, so nothing was
|
|
108
|
+
* proposed and nothing needed to be.
|
|
109
|
+
*
|
|
110
|
+
* Its own ending rather than one of the obstacles below, which is the
|
|
111
|
+
* difference between this and `revertRevision`. A reseed is the kind of
|
|
112
|
+
* operation that gets pressed twice — by a person who cannot see whether the
|
|
113
|
+
* first took, and by a deploy that runs on every release — so *the page is
|
|
114
|
+
* already right* is the healthy answer, and a caller that could not tell it
|
|
115
|
+
* from *the page cannot be put back* would report a success as a failure on
|
|
116
|
+
* every release after the first.
|
|
117
|
+
*/
|
|
118
|
+
| {
|
|
119
|
+
readonly kind: "already-authored";
|
|
120
|
+
readonly headRevision: number;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Nothing was proposed, because no reseed could be planned: the two trees are
|
|
124
|
+
* different pages, or they differ by something no operation can express.
|
|
125
|
+
* Writing over accepted work is not one of these — that is a proposal the Gate
|
|
126
|
+
* holds, not a plan that failed (0035).
|
|
127
|
+
*/
|
|
128
|
+
| {
|
|
129
|
+
readonly kind: "not-reseedable";
|
|
130
|
+
readonly plan: UnproposableReseed;
|
|
131
|
+
};
|
|
132
|
+
export declare const describeReseedOutcome: (outcome: ReseedOutcome) => string;
|
|
133
|
+
/**
|
|
134
|
+
* Puts a page back to its authored shape, if it can be expressed and the Gate
|
|
135
|
+
* agrees.
|
|
136
|
+
*
|
|
137
|
+
* Reads head itself rather than taking the stored tree, because the head the
|
|
138
|
+
* plan is made against and the head the intent names have to be the same
|
|
139
|
+
* revision — and a caller passing one it read earlier is a caller that can pass
|
|
140
|
+
* a stale one. The write path checks the intent against head again before
|
|
141
|
+
* interpreting, and the interpreter refuses a tree at a revision the plan was
|
|
142
|
+
* not made against, so a page that moves between the read and the commit ends as
|
|
143
|
+
* a `revision-conflict` rather than as a reseed to the wrong arrangement.
|
|
144
|
+
*
|
|
145
|
+
* The intent is synthesised here, for the reason the revert path gives: the
|
|
146
|
+
* utterance behind a reseed is not a sentence anybody typed. `origin` and
|
|
147
|
+
* `actor` are the caller's, and they are what the Gate weighs and what the
|
|
148
|
+
* provenance records — putting a page back is still someone asking for a change.
|
|
149
|
+
*/
|
|
150
|
+
export declare const reseedPage: (path: WritePath, request: ReseedRequest) => Promise<ReseedOutcome>;
|
|
151
|
+
//# sourceMappingURL=reseed.d.ts.map
|