footprintjs 9.48.2 → 10.0.0

package/dist/esm/lib/memory/placeholders.js

@@ -1,40 +0,0 @@
-/**
- * placeholders.ts — the string a redaction leaves where a value was, in the RECORD.
- *
- * WHY THIS FILE EXISTS. Before F4a six files each spelled a placeholder as a literal, and a spelling
- * kept in six places is a placeholder a reader can no longer match on. Every `src/` file that writes
- * the log's placeholder imports it from here, and `test/architecture/placeholders.test.ts` pins that
- * no other `src/` file spells it.
- *
- * ONE STRING HERE, ITS TWIN ON THE VERDICT'S SIDE (C4, review N2). A redaction leaves one of two
- * strings, and both are historical, so neither may change (stored recordings hold this one). Which
- * one a reader sees depends on WHERE it reads, and each has the owner its reader has:
- *   - {@link LOG_PLACEHOLDER} (`'REDACTED'`, here) is a RECORD byte: the commit log and everything
- *     served from it — written into the log by the record's scrub (`memory/scrub.ts`, L2), and
- *     passed by the two places that serve a mirror (`runner/ExecutionRuntime.ts`, the mirror's
- *     seed; `engine/handlers/SubflowExecutor.ts`, a subflow's served state). The readers
- *     (`slice/`, `time-travel/`) only name it in their docs: they meet it as data in the log;
- *   - `SCOPE_PLACEHOLDER` (`'[REDACTED]'`) is the ENGINE's: the scope channel's retained reads and
- *     writes, recorder events, the narrative. It lives beside the verdict that writes it
- *     (`memory/redaction.ts`, L4). Until C4 both sat in this file ("two placeholders, one leaf");
- *     the record took the engine's string with it.
- *
- * WHY A LEAF OF ITS OWN (and not beside `honesty.ts · HONESTY_CODES`). Different readers, different
- * reasons to change: this string is written on the engine's WRITE path on every redacted run, the
- * honesty registry is read by a reader that explains a recording — and the registry's sentences have
- * no business in the bundle of an app that only runs charts. This file imports NOTHING, so it is L0
- * (the layer table is `scripts/layering.config.cjs`).
- */
-/**
- * What the COMMIT LOG and the redacted MIRROR carry where a value was scrubbed.
- *
- * `memory/scrub.ts · scrubPatch` writes it into the patch the log records (both encodings), and the
- * mirror's seed is scrubbed with the same string (`runner/ExecutionRuntime.ts`), so a fold of the log
- * reproduces it (`stateAt` → `FoldedState.redactedPaths`) and a slice or an element birth, which
- * re-serve the log's bytes, show it too. A subflow's SERVED state is the subflow's own nested mirror
- * (9.20.0): `subflowResults[*].treeContext.globalContext` under `getSnapshot({ redact: true })`, and
- * `onSubflowExit.outputState` whenever a policy keeps that mirror — so those carry this string as
- * well, not the scope channel's `SCOPE_PLACEHOLDER` (`memory/redaction.ts`).
- */
-export const LOG_PLACEHOLDER = 'REDACTED';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGxhY2Vob2xkZXJzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9tZW1vcnkvcGxhY2Vob2xkZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQTBCRztBQUVIOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsVUFBVSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBwbGFjZWhvbGRlcnMudHMg4oCUIHRoZSBzdHJpbmcgYSByZWRhY3Rpb24gbGVhdmVzIHdoZXJlIGEgdmFsdWUgd2FzLCBpbiB0aGUgUkVDT1JELlxuICpcbiAqIFdIWSBUSElTIEZJTEUgRVhJU1RTLiBCZWZvcmUgRjRhIHNpeCBmaWxlcyBlYWNoIHNwZWxsZWQgYSBwbGFjZWhvbGRlciBhcyBhIGxpdGVyYWwsIGFuZCBhIHNwZWxsaW5nXG4gKiBrZXB0IGluIHNpeCBwbGFjZXMgaXMgYSBwbGFjZWhvbGRlciBhIHJlYWRlciBjYW4gbm8gbG9uZ2VyIG1hdGNoIG9uLiBFdmVyeSBgc3JjL2AgZmlsZSB0aGF0IHdyaXRlc1xuICogdGhlIGxvZydzIHBsYWNlaG9sZGVyIGltcG9ydHMgaXQgZnJvbSBoZXJlLCBhbmQgYHRlc3QvYXJjaGl0ZWN0dXJlL3BsYWNlaG9sZGVycy50ZXN0LnRzYCBwaW5zIHRoYXRcbiAqIG5vIG90aGVyIGBzcmMvYCBmaWxlIHNwZWxscyBpdC5cbiAqXG4gKiBPTkUgU1RSSU5HIEhFUkUsIElUUyBUV0lOIE9OIFRIRSBWRVJESUNUJ1MgU0lERSAoQzQsIHJldmlldyBOMikuIEEgcmVkYWN0aW9uIGxlYXZlcyBvbmUgb2YgdHdvXG4gKiBzdHJpbmdzLCBhbmQgYm90aCBhcmUgaGlzdG9yaWNhbCwgc28gbmVpdGhlciBtYXkgY2hhbmdlIChzdG9yZWQgcmVjb3JkaW5ncyBob2xkIHRoaXMgb25lKS4gV2hpY2hcbiAqIG9uZSBhIHJlYWRlciBzZWVzIGRlcGVuZHMgb24gV0hFUkUgaXQgcmVhZHMsIGFuZCBlYWNoIGhhcyB0aGUgb3duZXIgaXRzIHJlYWRlciBoYXM6XG4gKiAgIC0ge0BsaW5rIExPR19QTEFDRUhPTERFUn0gKGAnUkVEQUNURUQnYCwgaGVyZSkgaXMgYSBSRUNPUkQgYnl0ZTogdGhlIGNvbW1pdCBsb2cgYW5kIGV2ZXJ5dGhpbmdcbiAqICAgICBzZXJ2ZWQgZnJvbSBpdCDigJQgd3JpdHRlbiBpbnRvIHRoZSBsb2cgYnkgdGhlIHJlY29yZCdzIHNjcnViIChgbWVtb3J5L3NjcnViLnRzYCwgTDIpLCBhbmRcbiAqICAgICBwYXNzZWQgYnkgdGhlIHR3byBwbGFjZXMgdGhhdCBzZXJ2ZSBhIG1pcnJvciAoYHJ1bm5lci9FeGVjdXRpb25SdW50aW1lLnRzYCwgdGhlIG1pcnJvcidzXG4gKiAgICAgc2VlZDsgYGVuZ2luZS9oYW5kbGVycy9TdWJmbG93RXhlY3V0b3IudHNgLCBhIHN1YmZsb3cncyBzZXJ2ZWQgc3RhdGUpLiBUaGUgcmVhZGVyc1xuICogICAgIChgc2xpY2UvYCwgYHRpbWUtdHJhdmVsL2ApIG9ubHkgbmFtZSBpdCBpbiB0aGVpciBkb2NzOiB0aGV5IG1lZXQgaXQgYXMgZGF0YSBpbiB0aGUgbG9nO1xuICogICAtIGBTQ09QRV9QTEFDRUhPTERFUmAgKGAnW1JFREFDVEVEXSdgKSBpcyB0aGUgRU5HSU5FJ3M6IHRoZSBzY29wZSBjaGFubmVsJ3MgcmV0YWluZWQgcmVhZHMgYW5kXG4gKiAgICAgd3JpdGVzLCByZWNvcmRlciBldmVudHMsIHRoZSBuYXJyYXRpdmUuIEl0IGxpdmVzIGJlc2lkZSB0aGUgdmVyZGljdCB0aGF0IHdyaXRlcyBpdFxuICogICAgIChgbWVtb3J5L3JlZGFjdGlvbi50c2AsIEw0KS4gVW50aWwgQzQgYm90aCBzYXQgaW4gdGhpcyBmaWxlIChcInR3byBwbGFjZWhvbGRlcnMsIG9uZSBsZWFmXCIpO1xuICogICAgIHRoZSByZWNvcmQgdG9vayB0aGUgZW5naW5lJ3Mgc3RyaW5nIHdpdGggaXQuXG4gKlxuICogV0hZIEEgTEVBRiBPRiBJVFMgT1dOIChhbmQgbm90IGJlc2lkZSBgaG9uZXN0eS50cyDCtyBIT05FU1RZX0NPREVTYCkuIERpZmZlcmVudCByZWFkZXJzLCBkaWZmZXJlbnRcbiAqIHJlYXNvbnMgdG8gY2hhbmdlOiB0aGlzIHN0cmluZyBpcyB3cml0dGVuIG9uIHRoZSBlbmdpbmUncyBXUklURSBwYXRoIG9uIGV2ZXJ5IHJlZGFjdGVkIHJ1biwgdGhlXG4gKiBob25lc3R5IHJlZ2lzdHJ5IGlzIHJlYWQgYnkgYSByZWFkZXIgdGhhdCBleHBsYWlucyBhIHJlY29yZGluZyDigJQgYW5kIHRoZSByZWdpc3RyeSdzIHNlbnRlbmNlcyBoYXZlXG4gKiBubyBidXNpbmVzcyBpbiB0aGUgYnVuZGxlIG9mIGFuIGFwcCB0aGF0IG9ubHkgcnVucyBjaGFydHMuIFRoaXMgZmlsZSBpbXBvcnRzIE5PVEhJTkcsIHNvIGl0IGlzIEwwXG4gKiAodGhlIGxheWVyIHRhYmxlIGlzIGBzY3JpcHRzL2xheWVyaW5nLmNvbmZpZy5janNgKS5cbiAqL1xuXG4vKipcbiAqIFdoYXQgdGhlIENPTU1JVCBMT0cgYW5kIHRoZSByZWRhY3RlZCBNSVJST1IgY2Fycnkgd2hlcmUgYSB2YWx1ZSB3YXMgc2NydWJiZWQuXG4gKlxuICogYG1lbW9yeS9zY3J1Yi50cyDCtyBzY3J1YlBhdGNoYCB3cml0ZXMgaXQgaW50byB0aGUgcGF0Y2ggdGhlIGxvZyByZWNvcmRzIChib3RoIGVuY29kaW5ncyksIGFuZCB0aGVcbiAqIG1pcnJvcidzIHNlZWQgaXMgc2NydWJiZWQgd2l0aCB0aGUgc2FtZSBzdHJpbmcgKGBydW5uZXIvRXhlY3V0aW9uUnVudGltZS50c2ApLCBzbyBhIGZvbGQgb2YgdGhlIGxvZ1xuICogcmVwcm9kdWNlcyBpdCAoYHN0YXRlQXRgIOKGkiBgRm9sZGVkU3RhdGUucmVkYWN0ZWRQYXRoc2ApIGFuZCBhIHNsaWNlIG9yIGFuIGVsZW1lbnQgYmlydGgsIHdoaWNoXG4gKiByZS1zZXJ2ZSB0aGUgbG9nJ3MgYnl0ZXMsIHNob3cgaXQgdG9vLiBBIHN1YmZsb3cncyBTRVJWRUQgc3RhdGUgaXMgdGhlIHN1YmZsb3cncyBvd24gbmVzdGVkIG1pcnJvclxuICogKDkuMjAuMCk6IGBzdWJmbG93UmVzdWx0c1sqXS50cmVlQ29udGV4dC5nbG9iYWxDb250ZXh0YCB1bmRlciBgZ2V0U25hcHNob3QoeyByZWRhY3Q6IHRydWUgfSlgLCBhbmRcbiAqIGBvblN1YmZsb3dFeGl0Lm91dHB1dFN0YXRlYCB3aGVuZXZlciBhIHBvbGljeSBrZWVwcyB0aGF0IG1pcnJvciDigJQgc28gdGhvc2UgY2FycnkgdGhpcyBzdHJpbmcgYXNcbiAqIHdlbGwsIG5vdCB0aGUgc2NvcGUgY2hhbm5lbCdzIGBTQ09QRV9QTEFDRUhPTERFUmAgKGBtZW1vcnkvcmVkYWN0aW9uLnRzYCkuXG4gKi9cbmV4cG9ydCBjb25zdCBMT0dfUExBQ0VIT0xERVIgPSAnUkVEQUNURUQnO1xuIl19

package/dist/esm/lib/memory/recordCommit.d.ts

@@ -1,45 +0,0 @@
-/**
- * recordCommit — one stage's commit onto the record (C1, L3). The one owner of a bundle's bytes and
- * of where a commit lands: live state, the redacted mirror, the log.
- *
- * THE LAW:
- *   1. No payload (the stage staged no write) → an EMPTY bundle goes to the log, and nothing else
- *      moves: live state and the mirror keep their generation. Every executed stage is a cursor stop.
- *   2. A payload → its names are read first, so a stamp that cannot be read fails the commit before
- *      anything moves; then its raw rows build live state's next generation, `scrubPatch`
- *      (`scrub.ts`, the record's own) puts the placeholder at each redacted path that holds a value
- *      (in a spine copy, never in the raw patch), and the mirror and the log take the scrubbed rows —
- *      never the raw ones. The redacted paths are data by now: the engine decided them per write
- *      (`RecordFrame · write`); nothing here imports the engine's verdict (C4).
- *   3. The bundle's KEY ORDER is the record's bytes: `overwrite`, `updates`, `redactedPaths`, `trace`,
- *      `stage`, `stageId`, `runtimeStageId`, then `untrackedSources`, `tags` and `phase`, each only
- *      when it has something to say (absent, never empty). `EventLog · record` appends `idx`. The
- *      names are names: no redaction reads them, and no encoding (`commitValues`) changes them.
- *
- * The frame (`StageContext`) decides WHAT is committed — the payload, the names, whether the bundle
- * is a continuation — and keeps what is not the record: retention, diagnostics, the dev-mode
- * warnings and the commit observer.
- */
-import type { EventLog } from './EventLog.js';
-import type { SharedMemory } from './SharedMemory.js';
-import type { TransactionBuffer } from './TransactionBuffer.js';
-import type { CommitPhase, UntrackedSource } from './types.js';
-/** One stage's net change, as `TransactionBuffer · commit` hands it over. */
-export type CommitPayload = ReturnType<TransactionBuffer['commit']>;
-/** What names a commit on the record, beside its payload (law 3). */
-export interface CommitStamp {
-    stage: string;
-    stageId: string;
-    runtimeStageId: string;
-    untrackedSources?: ReadonlySet<UntrackedSource>;
-    tags?: readonly string[];
-    phase?: CommitPhase;
-}
-/** Where a commit lands: live state always; the mirror and the log when the run keeps them. */
-export interface CommitTargets {
-    state: SharedMemory;
-    mirror?: SharedMemory;
-    log?: EventLog;
-}
-/** Record one commit (the module law). `payload` absent = the empty commit. */
-export declare function recordCommit(payload: CommitPayload | undefined, stamp: CommitStamp, into: CommitTargets): void;

package/dist/esm/lib/memory/recordCommit.js

@@ -1,61 +0,0 @@
-/**
- * recordCommit — one stage's commit onto the record (C1, L3). The one owner of a bundle's bytes and
- * of where a commit lands: live state, the redacted mirror, the log.
- *
- * THE LAW:
- *   1. No payload (the stage staged no write) → an EMPTY bundle goes to the log, and nothing else
- *      moves: live state and the mirror keep their generation. Every executed stage is a cursor stop.
- *   2. A payload → its names are read first, so a stamp that cannot be read fails the commit before
- *      anything moves; then its raw rows build live state's next generation, `scrubPatch`
- *      (`scrub.ts`, the record's own) puts the placeholder at each redacted path that holds a value
- *      (in a spine copy, never in the raw patch), and the mirror and the log take the scrubbed rows —
- *      never the raw ones. The redacted paths are data by now: the engine decided them per write
- *      (`RecordFrame · write`); nothing here imports the engine's verdict (C4).
- *   3. The bundle's KEY ORDER is the record's bytes: `overwrite`, `updates`, `redactedPaths`, `trace`,
- *      `stage`, `stageId`, `runtimeStageId`, then `untrackedSources`, `tags` and `phase`, each only
- *      when it has something to say (absent, never empty). `EventLog · record` appends `idx`. The
- *      names are names: no redaction reads them, and no encoding (`commitValues`) changes them.
- *
- * The frame (`StageContext`) decides WHAT is committed — the payload, the names, whether the bundle
- * is a continuation — and keeps what is not the record: retention, diagnostics, the dev-mode
- * warnings and the commit observer.
- */
-import { scrubPatch } from './scrub.js';
-/** Record one commit (the module law). `payload` absent = the empty commit. */
-export function recordCommit(payload, stamp, into) {
-    if (payload === undefined) {
-        into.log?.record(bundleOf({}, {}, [], [], namesOf(stamp)));
-        return;
-    }
-    const names = namesOf(stamp);
-    const { redactedPaths, trace } = payload;
-    into.state.applyPatch(payload.overwrite, payload.updates, trace);
-    const overwrite = scrubPatch(payload.overwrite, redactedPaths);
-    const updates = scrubPatch(payload.updates, redactedPaths);
-    into.mirror?.applyPatch(overwrite, updates, trace);
-    into.log?.record(bundleOf(overwrite, updates, [...redactedPaths], trace, names));
-}
-/** THE bundle (law 3): the payload's four keys, the three names, then each optional name that has something to say. */
-function bundleOf(overwrite, updates, redactedPaths, trace, names) {
-    const { stage, stageId, runtimeStageId, untrackedSources, tags, phase } = names;
-    const bundle = { overwrite, updates, redactedPaths, trace, stage, stageId, runtimeStageId };
-    if (untrackedSources)
-        bundle.untrackedSources = untrackedSources;
-    if (tags)
-        bundle.tags = tags;
-    if (phase)
-        bundle.phase = phase;
-    return bundle;
-}
-/** The names, read once — before anything moves (law 2). An optional one with nothing to say is `undefined`. */
-function namesOf({ stage, stageId, runtimeStageId, untrackedSources, tags, phase }) {
-    return {
-        stage,
-        stageId,
-        runtimeStageId,
-        untrackedSources: !untrackedSources || untrackedSources.size === 0 ? undefined : [...untrackedSources],
-        tags: !tags || tags.length === 0 ? undefined : tags,
-        phase: phase || undefined,
-    };
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVjb3JkQ29tbWl0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9tZW1vcnkvcmVjb3JkQ29tbWl0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FxQkc7QUFHSCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBMkJ4QywrRUFBK0U7QUFDL0UsTUFBTSxVQUFVLFlBQVksQ0FBQyxPQUFrQyxFQUFFLEtBQWtCLEVBQUUsSUFBbUI7SUFDdEcsSUFBSSxPQUFPLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDMUIsSUFBSSxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsUUFBUSxDQUFDLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQzNELE9BQU87SUFDVCxDQUFDO0lBQ0QsTUFBTSxLQUFLLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQzdCLE1BQU0sRUFBRSxhQUFhLEVBQUUsS0FBSyxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBQ3pDLElBQUksQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLE9BQU8sRUFBRSxLQUFLLENBQUMsQ0FBQztJQUNqRSxNQUFNLFNBQVMsR0FBRyxVQUFVLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxhQUFhLENBQUMsQ0FBQztJQUMvRCxNQUFNLE9BQU8sR0FBRyxVQUFVLENBQUMsT0FBTyxDQUFDLE9BQU8sRUFBRSxhQUFhLENBQUMsQ0FBQztJQUMzRCxJQUFJLENBQUMsTUFBTSxFQUFFLFVBQVUsQ0FBQyxTQUFTLEVBQUUsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO0lBQ25ELElBQUksQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDLFFBQVEsQ0FBQyxTQUFTLEVBQUUsT0FBTyxFQUFFLENBQUMsR0FBRyxhQUFhLENBQUMsRUFBRSxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUMsQ0FBQztBQUNuRixDQUFDO0FBRUQsdUhBQXVIO0FBQ3ZILFNBQVMsUUFBUSxDQUNmLFNBQXNCLEVBQ3RCLE9BQW9CLEVBQ3BCLGFBQXVCLEVBQ3ZCLEtBQW1CLEVBQ25CLEtBQVk7SUFFWixNQUFNLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRSxjQUFjLEVBQUUsZ0JBQWdCLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxHQUFHLEtBQUssQ0FBQztJQUNoRixNQUFNLE1BQU0sR0FBaUIsRUFBRSxTQUFTLEVBQUUsT0FBTyxFQUFFLGFBQWEsRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRSxjQUFjLEVBQUUsQ0FBQztJQUMxRyxJQUFJLGdCQUFnQjtRQUFFLE1BQU0sQ0FBQyxnQkFBZ0IsR0FBRyxnQkFBZ0IsQ0FBQztJQUNqRSxJQUFJLElBQUk7UUFBRSxNQUFNLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztJQUM3QixJQUFJLEtBQUs7UUFBRSxNQUFNLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQztJQUNoQyxPQUFPLE1BQU0sQ0FBQztBQUNoQixDQUFDO0FBRUQsZ0hBQWdIO0FBQ2hILFNBQVMsT0FBTyxDQUFDLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRSxjQUFjLEVBQUUsZ0JBQWdCLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBZTtJQUM3RixPQUFPO1FBQ0wsS0FBSztRQUNMLE9BQU87UUFDUCxjQUFjO1FBQ2QsZ0JBQWdCLEVBQUUsQ0FBQyxnQkFBZ0IsSUFBSSxnQkFBZ0IsQ0FBQyxJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxnQkFBZ0IsQ0FBQztRQUN0RyxJQUFJLEVBQUUsQ0FBQyxJQUFJLElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsSUFBSTtRQUNuRCxLQUFLLEVBQUUsS0FBSyxJQUFJLFNBQVM7S0FDMUIsQ0FBQztBQUNKLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIHJlY29yZENvbW1pdCDigJQgb25lIHN0YWdlJ3MgY29tbWl0IG9udG8gdGhlIHJlY29yZCAoQzEsIEwzKS4gVGhlIG9uZSBvd25lciBvZiBhIGJ1bmRsZSdzIGJ5dGVzIGFuZFxuICogb2Ygd2hlcmUgYSBjb21taXQgbGFuZHM6IGxpdmUgc3RhdGUsIHRoZSByZWRhY3RlZCBtaXJyb3IsIHRoZSBsb2cuXG4gKlxuICogVEhFIExBVzpcbiAqICAgMS4gTm8gcGF5bG9hZCAodGhlIHN0YWdlIHN0YWdlZCBubyB3cml0ZSkg4oaSIGFuIEVNUFRZIGJ1bmRsZSBnb2VzIHRvIHRoZSBsb2csIGFuZCBub3RoaW5nIGVsc2VcbiAqICAgICAgbW92ZXM6IGxpdmUgc3RhdGUgYW5kIHRoZSBtaXJyb3Iga2VlcCB0aGVpciBnZW5lcmF0aW9uLiBFdmVyeSBleGVjdXRlZCBzdGFnZSBpcyBhIGN1cnNvciBzdG9wLlxuICogICAyLiBBIHBheWxvYWQg4oaSIGl0cyBuYW1lcyBhcmUgcmVhZCBmaXJzdCwgc28gYSBzdGFtcCB0aGF0IGNhbm5vdCBiZSByZWFkIGZhaWxzIHRoZSBjb21taXQgYmVmb3JlXG4gKiAgICAgIGFueXRoaW5nIG1vdmVzOyB0aGVuIGl0cyByYXcgcm93cyBidWlsZCBsaXZlIHN0YXRlJ3MgbmV4dCBnZW5lcmF0aW9uLCBgc2NydWJQYXRjaGBcbiAqICAgICAgKGBzY3J1Yi50c2AsIHRoZSByZWNvcmQncyBvd24pIHB1dHMgdGhlIHBsYWNlaG9sZGVyIGF0IGVhY2ggcmVkYWN0ZWQgcGF0aCB0aGF0IGhvbGRzIGEgdmFsdWVcbiAqICAgICAgKGluIGEgc3BpbmUgY29weSwgbmV2ZXIgaW4gdGhlIHJhdyBwYXRjaCksIGFuZCB0aGUgbWlycm9yIGFuZCB0aGUgbG9nIHRha2UgdGhlIHNjcnViYmVkIHJvd3Mg4oCUXG4gKiAgICAgIG5ldmVyIHRoZSByYXcgb25lcy4gVGhlIHJlZGFjdGVkIHBhdGhzIGFyZSBkYXRhIGJ5IG5vdzogdGhlIGVuZ2luZSBkZWNpZGVkIHRoZW0gcGVyIHdyaXRlXG4gKiAgICAgIChgUmVjb3JkRnJhbWUgwrcgd3JpdGVgKTsgbm90aGluZyBoZXJlIGltcG9ydHMgdGhlIGVuZ2luZSdzIHZlcmRpY3QgKEM0KS5cbiAqICAgMy4gVGhlIGJ1bmRsZSdzIEtFWSBPUkRFUiBpcyB0aGUgcmVjb3JkJ3MgYnl0ZXM6IGBvdmVyd3JpdGVgLCBgdXBkYXRlc2AsIGByZWRhY3RlZFBhdGhzYCwgYHRyYWNlYCxcbiAqICAgICAgYHN0YWdlYCwgYHN0YWdlSWRgLCBgcnVudGltZVN0YWdlSWRgLCB0aGVuIGB1bnRyYWNrZWRTb3VyY2VzYCwgYHRhZ3NgIGFuZCBgcGhhc2VgLCBlYWNoIG9ubHlcbiAqICAgICAgd2hlbiBpdCBoYXMgc29tZXRoaW5nIHRvIHNheSAoYWJzZW50LCBuZXZlciBlbXB0eSkuIGBFdmVudExvZyDCtyByZWNvcmRgIGFwcGVuZHMgYGlkeGAuIFRoZVxuICogICAgICBuYW1lcyBhcmUgbmFtZXM6IG5vIHJlZGFjdGlvbiByZWFkcyB0aGVtLCBhbmQgbm8gZW5jb2RpbmcgKGBjb21taXRWYWx1ZXNgKSBjaGFuZ2VzIHRoZW0uXG4gKlxuICogVGhlIGZyYW1lIChgU3RhZ2VDb250ZXh0YCkgZGVjaWRlcyBXSEFUIGlzIGNvbW1pdHRlZCDigJQgdGhlIHBheWxvYWQsIHRoZSBuYW1lcywgd2hldGhlciB0aGUgYnVuZGxlXG4gKiBpcyBhIGNvbnRpbnVhdGlvbiDigJQgYW5kIGtlZXBzIHdoYXQgaXMgbm90IHRoZSByZWNvcmQ6IHJldGVudGlvbiwgZGlhZ25vc3RpY3MsIHRoZSBkZXYtbW9kZVxuICogd2FybmluZ3MgYW5kIHRoZSBjb21taXQgb2JzZXJ2ZXIuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBFdmVudExvZyB9IGZyb20gJy4vRXZlbnRMb2cuanMnO1xuaW1wb3J0IHsgc2NydWJQYXRjaCB9IGZyb20gJy4vc2NydWIuanMnO1xuaW1wb3J0IHR5cGUgeyBTaGFyZWRNZW1vcnkgfSBmcm9tICcuL1NoYXJlZE1lbW9yeS5qcyc7XG5pbXBvcnQgdHlwZSB7IFRyYW5zYWN0aW9uQnVmZmVyIH0gZnJvbSAnLi9UcmFuc2FjdGlvbkJ1ZmZlci5qcyc7XG5pbXBvcnQgdHlwZSB7IENvbW1pdEJ1bmRsZSwgQ29tbWl0UGhhc2UsIE1lbW9yeVBhdGNoLCBUcmFjZUVudHJ5LCBVbnRyYWNrZWRTb3VyY2UgfSBmcm9tICcuL3R5cGVzLmpzJztcblxuLyoqIE9uZSBzdGFnZSdzIG5ldCBjaGFuZ2UsIGFzIGBUcmFuc2FjdGlvbkJ1ZmZlciDCtyBjb21taXRgIGhhbmRzIGl0IG92ZXIuICovXG5leHBvcnQgdHlwZSBDb21taXRQYXlsb2FkID0gUmV0dXJuVHlwZTxUcmFuc2FjdGlvbkJ1ZmZlclsnY29tbWl0J10+O1xuXG4vKiogV2hhdCBuYW1lcyBhIGNvbW1pdCBvbiB0aGUgcmVjb3JkLCBiZXNpZGUgaXRzIHBheWxvYWQgKGxhdyAzKS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29tbWl0U3RhbXAge1xuICBzdGFnZTogc3RyaW5nO1xuICBzdGFnZUlkOiBzdHJpbmc7XG4gIHJ1bnRpbWVTdGFnZUlkOiBzdHJpbmc7XG4gIHVudHJhY2tlZFNvdXJjZXM/OiBSZWFkb25seVNldDxVbnRyYWNrZWRTb3VyY2U+O1xuICB0YWdzPzogcmVhZG9ubHkgc3RyaW5nW107XG4gIHBoYXNlPzogQ29tbWl0UGhhc2U7XG59XG5cbi8qKiBXaGVyZSBhIGNvbW1pdCBsYW5kczogbGl2ZSBzdGF0ZSBhbHdheXM7IHRoZSBtaXJyb3IgYW5kIHRoZSBsb2cgd2hlbiB0aGUgcnVuIGtlZXBzIHRoZW0uICovXG5leHBvcnQgaW50ZXJmYWNlIENvbW1pdFRhcmdldHMge1xuICBzdGF0ZTogU2hhcmVkTWVtb3J5O1xuICBtaXJyb3I/OiBTaGFyZWRNZW1vcnk7XG4gIGxvZz86IEV2ZW50TG9nO1xufVxuXG50eXBlIE5hbWVzID0gUGljazxDb21taXRCdW5kbGUsICdzdGFnZScgfCAnc3RhZ2VJZCcgfCAncnVudGltZVN0YWdlSWQnIHwgJ3VudHJhY2tlZFNvdXJjZXMnIHwgJ3RhZ3MnIHwgJ3BoYXNlJz47XG5cbi8qKiBSZWNvcmQgb25lIGNvbW1pdCAodGhlIG1vZHVsZSBsYXcpLiBgcGF5bG9hZGAgYWJzZW50ID0gdGhlIGVtcHR5IGNvbW1pdC4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZWNvcmRDb21taXQocGF5bG9hZDogQ29tbWl0UGF5bG9hZCB8IHVuZGVmaW5lZCwgc3RhbXA6IENvbW1pdFN0YW1wLCBpbnRvOiBDb21taXRUYXJnZXRzKTogdm9pZCB7XG4gIGlmIChwYXlsb2FkID09PSB1bmRlZmluZWQpIHtcbiAgICBpbnRvLmxvZz8ucmVjb3JkKGJ1bmRsZU9mKHt9LCB7fSwgW10sIFtdLCBuYW1lc09mKHN0YW1wKSkpO1xuICAgIHJldHVybjtcbiAgfVxuICBjb25zdCBuYW1lcyA9IG5hbWVzT2Yoc3RhbXApO1xuICBjb25zdCB7IHJlZGFjdGVkUGF0aHMsIHRyYWNlIH0gPSBwYXlsb2FkO1xuICBpbnRvLnN0YXRlLmFwcGx5UGF0Y2gocGF5bG9hZC5vdmVyd3JpdGUsIHBheWxvYWQudXBkYXRlcywgdHJhY2UpO1xuICBjb25zdCBvdmVyd3JpdGUgPSBzY3J1YlBhdGNoKHBheWxvYWQub3ZlcndyaXRlLCByZWRhY3RlZFBhdGhzKTtcbiAgY29uc3QgdXBkYXRlcyA9IHNjcnViUGF0Y2gocGF5bG9hZC51cGRhdGVzLCByZWRhY3RlZFBhdGhzKTtcbiAgaW50by5taXJyb3I/LmFwcGx5UGF0Y2gob3ZlcndyaXRlLCB1cGRhdGVzLCB0cmFjZSk7XG4gIGludG8ubG9nPy5yZWNvcmQoYnVuZGxlT2Yob3ZlcndyaXRlLCB1cGRhdGVzLCBbLi4ucmVkYWN0ZWRQYXRoc10sIHRyYWNlLCBuYW1lcykpO1xufVxuXG4vKiogVEhFIGJ1bmRsZSAobGF3IDMpOiB0aGUgcGF5bG9hZCdzIGZvdXIga2V5cywgdGhlIHRocmVlIG5hbWVzLCB0aGVuIGVhY2ggb3B0aW9uYWwgbmFtZSB0aGF0IGhhcyBzb21ldGhpbmcgdG8gc2F5LiAqL1xuZnVuY3Rpb24gYnVuZGxlT2YoXG4gIG92ZXJ3cml0ZTogTWVtb3J5UGF0Y2gsXG4gIHVwZGF0ZXM6IE1lbW9yeVBhdGNoLFxuICByZWRhY3RlZFBhdGhzOiBzdHJpbmdbXSxcbiAgdHJhY2U6IFRyYWNlRW50cnlbXSxcbiAgbmFtZXM6IE5hbWVzLFxuKTogQ29tbWl0QnVuZGxlIHtcbiAgY29uc3QgeyBzdGFnZSwgc3RhZ2VJZCwgcnVudGltZVN0YWdlSWQsIHVudHJhY2tlZFNvdXJjZXMsIHRhZ3MsIHBoYXNlIH0gPSBuYW1lcztcbiAgY29uc3QgYnVuZGxlOiBDb21taXRCdW5kbGUgPSB7IG92ZXJ3cml0ZSwgdXBkYXRlcywgcmVkYWN0ZWRQYXRocywgdHJhY2UsIHN0YWdlLCBzdGFnZUlkLCBydW50aW1lU3RhZ2VJZCB9O1xuICBpZiAodW50cmFja2VkU291cmNlcykgYnVuZGxlLnVudHJhY2tlZFNvdXJjZXMgPSB1bnRyYWNrZWRTb3VyY2VzO1xuICBpZiAodGFncykgYnVuZGxlLnRhZ3MgPSB0YWdzO1xuICBpZiAocGhhc2UpIGJ1bmRsZS5waGFzZSA9IHBoYXNlO1xuICByZXR1cm4gYnVuZGxlO1xufVxuXG4vKiogVGhlIG5hbWVzLCByZWFkIG9uY2Ug4oCUIGJlZm9yZSBhbnl0aGluZyBtb3ZlcyAobGF3IDIpLiBBbiBvcHRpb25hbCBvbmUgd2l0aCBub3RoaW5nIHRvIHNheSBpcyBgdW5kZWZpbmVkYC4gKi9cbmZ1bmN0aW9uIG5hbWVzT2YoeyBzdGFnZSwgc3RhZ2VJZCwgcnVudGltZVN0YWdlSWQsIHVudHJhY2tlZFNvdXJjZXMsIHRhZ3MsIHBoYXNlIH06IENvbW1pdFN0YW1wKTogTmFtZXMge1xuICByZXR1cm4ge1xuICAgIHN0YWdlLFxuICAgIHN0YWdlSWQsXG4gICAgcnVudGltZVN0YWdlSWQsXG4gICAgdW50cmFja2VkU291cmNlczogIXVudHJhY2tlZFNvdXJjZXMgfHwgdW50cmFja2VkU291cmNlcy5zaXplID09PSAwID8gdW5kZWZpbmVkIDogWy4uLnVudHJhY2tlZFNvdXJjZXNdLFxuICAgIHRhZ3M6ICF0YWdzIHx8IHRhZ3MubGVuZ3RoID09PSAwID8gdW5kZWZpbmVkIDogdGFncyxcbiAgICBwaGFzZTogcGhhc2UgfHwgdW5kZWZpbmVkLFxuICB9O1xufVxuIl19

package/dist/esm/lib/memory/scrub.d.ts

@@ -1,53 +0,0 @@
-/**
- * scrub.ts — the commit log's scrub: the placeholder at every redacted path of a patch (C4, L2).
- *
- * The RECORD's half of a redaction. A redacted path is DATA by the time it reaches here — the
- * transaction buffer's `redactedPaths`, registered by `RecordFrame · write` from the scrub it was
- * handed — and this file only writes `LOG_PLACEHOLDER` (`placeholders.ts`) where such a path holds
- * a value. It never decides WHAT is secret: that is the engine's verdict (`redaction.ts`, L4 —
- * `RedactionRule` and the write decision), which also owns the OTHER placeholder, the scope channel's
- * `SCOPE_PLACEHOLDER`. Before C4 both halves lived in `redaction.ts`, so the record imported the
- * engine's policy module to write a string.
- *
- * THE LAW:
- *   1. A path is scrubbed only where it holds a DEFINED value — scrubbing never invents a field.
- *   2. Paths are scrubbed in the set's order, against the tree as scrubbed so far: a path under one
- *      already scrubbed finds a string, not a container, and is left alone.
- *   3. The input patch is never edited. `scrubPatch` copies only the spine of each scrubbed path
- *      (and nothing at all when nothing is scrubbed); `redactPatch` hands back a fresh deep copy.
- */
-import type { MemoryPatch } from './types.js';
-/**
- * The commit log's scrub: `patch` with {@link LOG_PLACEHOLDER} at every path in `redactedPaths` that
- * holds a defined value — the copy `recordCommit` records and feeds the redacted mirror.
- *
- * CLONE-FREE (9.33.0). The patch is the transaction buffer's commit-time payload, already the record's
- * own copy (`TransactionBuffer · commit` clones each surviving path once; the buffer is dropped at
- * commit), so the scrub copies only what it must not edit in place:
- *   - no path to scrub (no policy, no per-call mark — the common case) → `patch` ITSELF, no copy at all;
- *   - otherwise → a new root and a shallow copy of each container on a scrubbed path (`pathOps ·
- *     ownSpine`), every other subtree shared with `patch`. `patch` is never edited.
- * The engine called the public {@link redactPatch} (a whole `structuredClone`) twice per commit before
- * 9.33.0. The bytes are the same: a scrubbed path holds the placeholder, every other path the value the
- * buffer cloned (pinned by the 9.18.1 / 9.19.1 redaction byte tests).
- *
- * Paths are scrubbed in the set's order, against the tree as scrubbed so far: a path under one already
- * scrubbed finds a string, not a container, and is left alone (as before).
- *
- * INTERNAL — the result shares structure with `patch`. A caller outside the commit path wants
- * {@link redactPatch}.
- *
- * @param redactedPaths DELIM-joined paths (`TransactionBuffer`'s `redactedPaths`; a bundle's
- *   `redactedPaths` array works too).
- */
-export declare function scrubPatch(patch: MemoryPatch, redactedPaths: Iterable<string>): MemoryPatch;
-/**
- * Redacts sensitive values in a patch for logging/debugging — the PUBLIC scrub (`footprintjs/advanced`),
- * its contract unchanged since 4.x: a fresh deep copy of `patch` (`structuredClone`) with
- * {@link LOG_PLACEHOLDER} at every listed path that holds a defined value. Shares nothing with `patch`
- * and never edits it. (It lived in `memory/utils.ts` until 9.33.0 and in `memory/redaction.ts` until
- * C4; the engine's own commit path uses the clone-free {@link scrubPatch}.) No caller inside the
- * library: it stays on `footprintjs/advanced` for the consumers that import it until 10.0.0 (the trace
- * extraction, E6), which takes it off every door.
- */
-export declare function redactPatch(patch: MemoryPatch, redactedSet: Set<string>): MemoryPatch;

package/dist/esm/lib/memory/scrub.js

@@ -1,74 +0,0 @@
-/**
- * scrub.ts — the commit log's scrub: the placeholder at every redacted path of a patch (C4, L2).
- *
- * The RECORD's half of a redaction. A redacted path is DATA by the time it reaches here — the
- * transaction buffer's `redactedPaths`, registered by `RecordFrame · write` from the scrub it was
- * handed — and this file only writes `LOG_PLACEHOLDER` (`placeholders.ts`) where such a path holds
- * a value. It never decides WHAT is secret: that is the engine's verdict (`redaction.ts`, L4 —
- * `RedactionRule` and the write decision), which also owns the OTHER placeholder, the scope channel's
- * `SCOPE_PLACEHOLDER`. Before C4 both halves lived in `redaction.ts`, so the record imported the
- * engine's policy module to write a string.
- *
- * THE LAW:
- *   1. A path is scrubbed only where it holds a DEFINED value — scrubbing never invents a field.
- *   2. Paths are scrubbed in the set's order, against the tree as scrubbed so far: a path under one
- *      already scrubbed finds a string, not a container, and is left alone.
- *   3. The input patch is never edited. `scrubPatch` copies only the spine of each scrubbed path
- *      (and nothing at all when nothing is scrubbed); `redactPatch` hands back a fresh deep copy.
- */
-import { nativeGet, nativeHas, nativeSet, ownedRootOf, ownSpine } from './pathOps.js';
-import { DELIM } from './paths.js';
-import { LOG_PLACEHOLDER } from './placeholders.js';
-/**
- * The commit log's scrub: `patch` with {@link LOG_PLACEHOLDER} at every path in `redactedPaths` that
- * holds a defined value — the copy `recordCommit` records and feeds the redacted mirror.
- *
- * CLONE-FREE (9.33.0). The patch is the transaction buffer's commit-time payload, already the record's
- * own copy (`TransactionBuffer · commit` clones each surviving path once; the buffer is dropped at
- * commit), so the scrub copies only what it must not edit in place:
- *   - no path to scrub (no policy, no per-call mark — the common case) → `patch` ITSELF, no copy at all;
- *   - otherwise → a new root and a shallow copy of each container on a scrubbed path (`pathOps ·
- *     ownSpine`), every other subtree shared with `patch`. `patch` is never edited.
- * The engine called the public {@link redactPatch} (a whole `structuredClone`) twice per commit before
- * 9.33.0. The bytes are the same: a scrubbed path holds the placeholder, every other path the value the
- * buffer cloned (pinned by the 9.18.1 / 9.19.1 redaction byte tests).
- *
- * Paths are scrubbed in the set's order, against the tree as scrubbed so far: a path under one already
- * scrubbed finds a string, not a container, and is left alone (as before).
- *
- * INTERNAL — the result shares structure with `patch`. A caller outside the commit path wants
- * {@link redactPatch}.
- *
- * @param redactedPaths DELIM-joined paths (`TransactionBuffer`'s `redactedPaths`; a bundle's
- *   `redactedPaths` array works too).
- */
-export function scrubPatch(patch, redactedPaths) {
-    let out;
-    let owned;
-    for (const flat of redactedPaths) {
-        const segs = flat.split(DELIM);
-        const current = out ?? patch;
-        if (!nativeHas(current, segs) || nativeGet(current, segs) === undefined)
-            continue;
-        if (out === undefined) {
-            owned = new WeakSet();
-            out = ownedRootOf(patch, owned);
-        }
-        ownSpine(out, segs, owned);
-        nativeSet(out, segs, LOG_PLACEHOLDER);
-    }
-    return out ?? patch;
-}
-/**
- * Redacts sensitive values in a patch for logging/debugging — the PUBLIC scrub (`footprintjs/advanced`),
- * its contract unchanged since 4.x: a fresh deep copy of `patch` (`structuredClone`) with
- * {@link LOG_PLACEHOLDER} at every listed path that holds a defined value. Shares nothing with `patch`
- * and never edits it. (It lived in `memory/utils.ts` until 9.33.0 and in `memory/redaction.ts` until
- * C4; the engine's own commit path uses the clone-free {@link scrubPatch}.) No caller inside the
- * library: it stays on `footprintjs/advanced` for the consumers that import it until 10.0.0 (the trace
- * extraction, E6), which takes it off every door.
- */
-export function redactPatch(patch, redactedSet) {
-    return scrubPatch(structuredClone(patch), redactedSet);
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NydWIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL21lbW9yeS9zY3J1Yi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FpQkc7QUFFSCxPQUFPLEVBQUUsU0FBUyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsV0FBVyxFQUFFLFFBQVEsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUN0RixPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ25DLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUdwRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXNCRztBQUNILE1BQU0sVUFBVSxVQUFVLENBQUMsS0FBa0IsRUFBRSxhQUErQjtJQUM1RSxJQUFJLEdBQTRCLENBQUM7SUFDakMsSUFBSSxLQUFrQyxDQUFDO0lBQ3ZDLEtBQUssTUFBTSxJQUFJLElBQUksYUFBYSxFQUFFLENBQUM7UUFDakMsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUMvQixNQUFNLE9BQU8sR0FBRyxHQUFHLElBQUksS0FBSyxDQUFDO1FBQzdCLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxJQUFJLFNBQVMsQ0FBQyxPQUFPLEVBQUUsSUFBSSxDQUFDLEtBQUssU0FBUztZQUFFLFNBQVM7UUFDbEYsSUFBSSxHQUFHLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDdEIsS0FBSyxHQUFHLElBQUksT0FBTyxFQUFVLENBQUM7WUFDOUIsR0FBRyxHQUFHLFdBQVcsQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFnQixDQUFDO1FBQ2pELENBQUM7UUFDRCxRQUFRLENBQUMsR0FBRyxFQUFFLElBQUksRUFBRSxLQUFNLENBQUMsQ0FBQztRQUM1QixTQUFTLENBQUMsR0FBRyxFQUFFLElBQUksRUFBRSxlQUFlLENBQUMsQ0FBQztJQUN4QyxDQUFDO0lBQ0QsT0FBTyxHQUFHLElBQUksS0FBSyxDQUFDO0FBQ3RCLENBQUM7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sVUFBVSxXQUFXLENBQUMsS0FBa0IsRUFBRSxXQUF3QjtJQUN0RSxPQUFPLFVBQVUsQ0FBQyxlQUFlLENBQUMsS0FBSyxDQUFDLEVBQUUsV0FBVyxDQUFDLENBQUM7QUFDekQsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogc2NydWIudHMg4oCUIHRoZSBjb21taXQgbG9nJ3Mgc2NydWI6IHRoZSBwbGFjZWhvbGRlciBhdCBldmVyeSByZWRhY3RlZCBwYXRoIG9mIGEgcGF0Y2ggKEM0LCBMMikuXG4gKlxuICogVGhlIFJFQ09SRCdzIGhhbGYgb2YgYSByZWRhY3Rpb24uIEEgcmVkYWN0ZWQgcGF0aCBpcyBEQVRBIGJ5IHRoZSB0aW1lIGl0IHJlYWNoZXMgaGVyZSDigJQgdGhlXG4gKiB0cmFuc2FjdGlvbiBidWZmZXIncyBgcmVkYWN0ZWRQYXRoc2AsIHJlZ2lzdGVyZWQgYnkgYFJlY29yZEZyYW1lIMK3IHdyaXRlYCBmcm9tIHRoZSBzY3J1YiBpdCB3YXNcbiAqIGhhbmRlZCDigJQgYW5kIHRoaXMgZmlsZSBvbmx5IHdyaXRlcyBgTE9HX1BMQUNFSE9MREVSYCAoYHBsYWNlaG9sZGVycy50c2ApIHdoZXJlIHN1Y2ggYSBwYXRoIGhvbGRzXG4gKiBhIHZhbHVlLiBJdCBuZXZlciBkZWNpZGVzIFdIQVQgaXMgc2VjcmV0OiB0aGF0IGlzIHRoZSBlbmdpbmUncyB2ZXJkaWN0IChgcmVkYWN0aW9uLnRzYCwgTDQg4oCUXG4gKiBgUmVkYWN0aW9uUnVsZWAgYW5kIHRoZSB3cml0ZSBkZWNpc2lvbiksIHdoaWNoIGFsc28gb3ducyB0aGUgT1RIRVIgcGxhY2Vob2xkZXIsIHRoZSBzY29wZSBjaGFubmVsJ3NcbiAqIGBTQ09QRV9QTEFDRUhPTERFUmAuIEJlZm9yZSBDNCBib3RoIGhhbHZlcyBsaXZlZCBpbiBgcmVkYWN0aW9uLnRzYCwgc28gdGhlIHJlY29yZCBpbXBvcnRlZCB0aGVcbiAqIGVuZ2luZSdzIHBvbGljeSBtb2R1bGUgdG8gd3JpdGUgYSBzdHJpbmcuXG4gKlxuICogVEhFIExBVzpcbiAqICAgMS4gQSBwYXRoIGlzIHNjcnViYmVkIG9ubHkgd2hlcmUgaXQgaG9sZHMgYSBERUZJTkVEIHZhbHVlIOKAlCBzY3J1YmJpbmcgbmV2ZXIgaW52ZW50cyBhIGZpZWxkLlxuICogICAyLiBQYXRocyBhcmUgc2NydWJiZWQgaW4gdGhlIHNldCdzIG9yZGVyLCBhZ2FpbnN0IHRoZSB0cmVlIGFzIHNjcnViYmVkIHNvIGZhcjogYSBwYXRoIHVuZGVyIG9uZVxuICogICAgICBhbHJlYWR5IHNjcnViYmVkIGZpbmRzIGEgc3RyaW5nLCBub3QgYSBjb250YWluZXIsIGFuZCBpcyBsZWZ0IGFsb25lLlxuICogICAzLiBUaGUgaW5wdXQgcGF0Y2ggaXMgbmV2ZXIgZWRpdGVkLiBgc2NydWJQYXRjaGAgY29waWVzIG9ubHkgdGhlIHNwaW5lIG9mIGVhY2ggc2NydWJiZWQgcGF0aFxuICogICAgICAoYW5kIG5vdGhpbmcgYXQgYWxsIHdoZW4gbm90aGluZyBpcyBzY3J1YmJlZCk7IGByZWRhY3RQYXRjaGAgaGFuZHMgYmFjayBhIGZyZXNoIGRlZXAgY29weS5cbiAqL1xuXG5pbXBvcnQgeyBuYXRpdmVHZXQsIG5hdGl2ZUhhcywgbmF0aXZlU2V0LCBvd25lZFJvb3RPZiwgb3duU3BpbmUgfSBmcm9tICcuL3BhdGhPcHMuanMnO1xuaW1wb3J0IHsgREVMSU0gfSBmcm9tICcuL3BhdGhzLmpzJztcbmltcG9ydCB7IExPR19QTEFDRUhPTERFUiB9IGZyb20gJy4vcGxhY2Vob2xkZXJzLmpzJztcbmltcG9ydCB0eXBlIHsgTWVtb3J5UGF0Y2ggfSBmcm9tICcuL3R5cGVzLmpzJztcblxuLyoqXG4gKiBUaGUgY29tbWl0IGxvZydzIHNjcnViOiBgcGF0Y2hgIHdpdGgge0BsaW5rIExPR19QTEFDRUhPTERFUn0gYXQgZXZlcnkgcGF0aCBpbiBgcmVkYWN0ZWRQYXRoc2AgdGhhdFxuICogaG9sZHMgYSBkZWZpbmVkIHZhbHVlIOKAlCB0aGUgY29weSBgcmVjb3JkQ29tbWl0YCByZWNvcmRzIGFuZCBmZWVkcyB0aGUgcmVkYWN0ZWQgbWlycm9yLlxuICpcbiAqIENMT05FLUZSRUUgKDkuMzMuMCkuIFRoZSBwYXRjaCBpcyB0aGUgdHJhbnNhY3Rpb24gYnVmZmVyJ3MgY29tbWl0LXRpbWUgcGF5bG9hZCwgYWxyZWFkeSB0aGUgcmVjb3JkJ3NcbiAqIG93biBjb3B5IChgVHJhbnNhY3Rpb25CdWZmZXIgwrcgY29tbWl0YCBjbG9uZXMgZWFjaCBzdXJ2aXZpbmcgcGF0aCBvbmNlOyB0aGUgYnVmZmVyIGlzIGRyb3BwZWQgYXRcbiAqIGNvbW1pdCksIHNvIHRoZSBzY3J1YiBjb3BpZXMgb25seSB3aGF0IGl0IG11c3Qgbm90IGVkaXQgaW4gcGxhY2U6XG4gKiAgIC0gbm8gcGF0aCB0byBzY3J1YiAobm8gcG9saWN5LCBubyBwZXItY2FsbCBtYXJrIOKAlCB0aGUgY29tbW9uIGNhc2UpIOKGkiBgcGF0Y2hgIElUU0VMRiwgbm8gY29weSBhdCBhbGw7XG4gKiAgIC0gb3RoZXJ3aXNlIOKGkiBhIG5ldyByb290IGFuZCBhIHNoYWxsb3cgY29weSBvZiBlYWNoIGNvbnRhaW5lciBvbiBhIHNjcnViYmVkIHBhdGggKGBwYXRoT3BzIMK3XG4gKiAgICAgb3duU3BpbmVgKSwgZXZlcnkgb3RoZXIgc3VidHJlZSBzaGFyZWQgd2l0aCBgcGF0Y2hgLiBgcGF0Y2hgIGlzIG5ldmVyIGVkaXRlZC5cbiAqIFRoZSBlbmdpbmUgY2FsbGVkIHRoZSBwdWJsaWMge0BsaW5rIHJlZGFjdFBhdGNofSAoYSB3aG9sZSBgc3RydWN0dXJlZENsb25lYCkgdHdpY2UgcGVyIGNvbW1pdCBiZWZvcmVcbiAqIDkuMzMuMC4gVGhlIGJ5dGVzIGFyZSB0aGUgc2FtZTogYSBzY3J1YmJlZCBwYXRoIGhvbGRzIHRoZSBwbGFjZWhvbGRlciwgZXZlcnkgb3RoZXIgcGF0aCB0aGUgdmFsdWUgdGhlXG4gKiBidWZmZXIgY2xvbmVkIChwaW5uZWQgYnkgdGhlIDkuMTguMSAvIDkuMTkuMSByZWRhY3Rpb24gYnl0ZSB0ZXN0cykuXG4gKlxuICogUGF0aHMgYXJlIHNjcnViYmVkIGluIHRoZSBzZXQncyBvcmRlciwgYWdhaW5zdCB0aGUgdHJlZSBhcyBzY3J1YmJlZCBzbyBmYXI6IGEgcGF0aCB1bmRlciBvbmUgYWxyZWFkeVxuICogc2NydWJiZWQgZmluZHMgYSBzdHJpbmcsIG5vdCBhIGNvbnRhaW5lciwgYW5kIGlzIGxlZnQgYWxvbmUgKGFzIGJlZm9yZSkuXG4gKlxuICogSU5URVJOQUwg4oCUIHRoZSByZXN1bHQgc2hhcmVzIHN0cnVjdHVyZSB3aXRoIGBwYXRjaGAuIEEgY2FsbGVyIG91dHNpZGUgdGhlIGNvbW1pdCBwYXRoIHdhbnRzXG4gKiB7QGxpbmsgcmVkYWN0UGF0Y2h9LlxuICpcbiAqIEBwYXJhbSByZWRhY3RlZFBhdGhzIERFTElNLWpvaW5lZCBwYXRocyAoYFRyYW5zYWN0aW9uQnVmZmVyYCdzIGByZWRhY3RlZFBhdGhzYDsgYSBidW5kbGUnc1xuICogICBgcmVkYWN0ZWRQYXRoc2AgYXJyYXkgd29ya3MgdG9vKS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNjcnViUGF0Y2gocGF0Y2g6IE1lbW9yeVBhdGNoLCByZWRhY3RlZFBhdGhzOiBJdGVyYWJsZTxzdHJpbmc+KTogTWVtb3J5UGF0Y2gge1xuICBsZXQgb3V0OiBNZW1vcnlQYXRjaCB8IHVuZGVmaW5lZDtcbiAgbGV0IG93bmVkOiBXZWFrU2V0PG9iamVjdD4gfCB1bmRlZmluZWQ7XG4gIGZvciAoY29uc3QgZmxhdCBvZiByZWRhY3RlZFBhdGhzKSB7XG4gICAgY29uc3Qgc2VncyA9IGZsYXQuc3BsaXQoREVMSU0pO1xuICAgIGNvbnN0IGN1cnJlbnQgPSBvdXQgPz8gcGF0Y2g7XG4gICAgaWYgKCFuYXRpdmVIYXMoY3VycmVudCwgc2VncykgfHwgbmF0aXZlR2V0KGN1cnJlbnQsIHNlZ3MpID09PSB1bmRlZmluZWQpIGNvbnRpbnVlO1xuICAgIGlmIChvdXQgPT09IHVuZGVmaW5lZCkge1xuICAgICAgb3duZWQgPSBuZXcgV2Vha1NldDxvYmplY3Q+KCk7XG4gICAgICBvdXQgPSBvd25lZFJvb3RPZihwYXRjaCwgb3duZWQpIGFzIE1lbW9yeVBhdGNoO1xuICAgIH1cbiAgICBvd25TcGluZShvdXQsIHNlZ3MsIG93bmVkISk7XG4gICAgbmF0aXZlU2V0KG91dCwgc2VncywgTE9HX1BMQUNFSE9MREVSKTtcbiAgfVxuICByZXR1cm4gb3V0ID8/IHBhdGNoO1xufVxuXG4vKipcbiAqIFJlZGFjdHMgc2Vuc2l0aXZlIHZhbHVlcyBpbiBhIHBhdGNoIGZvciBsb2dnaW5nL2RlYnVnZ2luZyDigJQgdGhlIFBVQkxJQyBzY3J1YiAoYGZvb3RwcmludGpzL2FkdmFuY2VkYCksXG4gKiBpdHMgY29udHJhY3QgdW5jaGFuZ2VkIHNpbmNlIDQueDogYSBmcmVzaCBkZWVwIGNvcHkgb2YgYHBhdGNoYCAoYHN0cnVjdHVyZWRDbG9uZWApIHdpdGhcbiAqIHtAbGluayBMT0dfUExBQ0VIT0xERVJ9IGF0IGV2ZXJ5IGxpc3RlZCBwYXRoIHRoYXQgaG9sZHMgYSBkZWZpbmVkIHZhbHVlLiBTaGFyZXMgbm90aGluZyB3aXRoIGBwYXRjaGBcbiAqIGFuZCBuZXZlciBlZGl0cyBpdC4gKEl0IGxpdmVkIGluIGBtZW1vcnkvdXRpbHMudHNgIHVudGlsIDkuMzMuMCBhbmQgaW4gYG1lbW9yeS9yZWRhY3Rpb24udHNgIHVudGlsXG4gKiBDNDsgdGhlIGVuZ2luZSdzIG93biBjb21taXQgcGF0aCB1c2VzIHRoZSBjbG9uZS1mcmVlIHtAbGluayBzY3J1YlBhdGNofS4pIE5vIGNhbGxlciBpbnNpZGUgdGhlXG4gKiBsaWJyYXJ5OiBpdCBzdGF5cyBvbiBgZm9vdHByaW50anMvYWR2YW5jZWRgIGZvciB0aGUgY29uc3VtZXJzIHRoYXQgaW1wb3J0IGl0IHVudGlsIDEwLjAuMCAodGhlIHRyYWNlXG4gKiBleHRyYWN0aW9uLCBFNiksIHdoaWNoIHRha2VzIGl0IG9mZiBldmVyeSBkb29yLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVkYWN0UGF0Y2gocGF0Y2g6IE1lbW9yeVBhdGNoLCByZWRhY3RlZFNldDogU2V0PHN0cmluZz4pOiBNZW1vcnlQYXRjaCB7XG4gIHJldHVybiBzY3J1YlBhdGNoKHN0cnVjdHVyZWRDbG9uZShwYXRjaCksIHJlZGFjdGVkU2V0KTtcbn1cbiJdfQ==

package/dist/esm/lib/memory/types.d.ts

@@ -1,209 +0,0 @@
-/**
- * types.ts — the record's types: a bundle, its rows, its patches, its encoding, and the
- * execution tree as the record's readers read it.
- *
- * Imports nothing. The record names nothing outside itself (C6, `RECORD_FILES` in
- * scripts/layering.config.cjs): the engine's frame types — the stage snapshot, the flow
- * messages, the retention dials — live beside the frame, in `frameTypes.ts` (L4).
- */
-/** A flat key-value bag representing a state patch (overwrite or merge). */
-export interface MemoryPatch {
-    [key: string]: any;
-}
-/** A single entry in the chronological operation trace. */
-export interface TraceEntry {
-    /** Canonical path string (segments joined by DELIM). */
-    path: string;
-    /**
-     * Per-write read provenance (#P1) — the keys this stage had TRACKED-READ at
-     * the moment this path was (last) written: the temporal-prefix attribution
-     * that lets slices link a specific write to only the reads that could have
-     * fed it (a stage reading `a,b` and writing `x,y` no longer implies x←b).
-     * ABSENT unless the `writeProvenance: 'reads-prefix'` dial is on — charts
-     * that never enable it keep byte-identical commit logs. Read prefixes only
-     * grow during a stage, so under delta mode's one-entry-per-path dedup the
-     * LAST write's prefix == the union across all of that path's writes.
-     * Honest ceiling: a write with NO tracked reads before it records `[]` —
-     * "depended on no tracked reads" is information, not absence.
-     */
-    readKeys?: string[];
-    /**
-     * - `'set'`    — hard overwrite; `overwrite[path]` holds the full final value.
-     * - `'merge'`  — deep union merge; `updates[path]` holds the accumulated delta.
-     * - `'append'` — (#13c-B, produced only under {@link CommitValuesMode}
-     *   `'delta'`) the path's final value is its base value plus a tail of new
-     *   trailing elements; `overwrite[path]` holds ONLY the tail. Replay
-     *   reconstructs by concatenation. NOT idempotent — delta-mode bundles
-     *   carry exactly one trace entry per surviving path.
-     * - `'delete'` — (#13c-B, produced only under `'delta'`; absorbs backlog
-     *   B8) the key was explicitly removed via `deleteValue()`. Replay removes
-     *   the key. `overwrite[path]` still ENUMERATES the path (value
-     *   `undefined`) so key-set consumers keep seeing the changed key.
-     *
-     * `overwrite` values are therefore VERB-QUALIFIED: consumers that read
-     * `bundle.overwrite[key]` as "the full value written" must use
-     * `commitValueAt(commitLog, idx, key)` (from `footprintjs/trace`) when the
-     * log may contain delta-mode bundles.
-     */
-    verb: 'set' | 'merge' | 'append' | 'delete';
-}
-/**
- * RFC-003 D2 — read paths that BYPASS read tracking:
- * - `'args'`   — the stage called `getArgs()` / `$getArgs()` with non-empty
- *   run input (frozen, untracked by design)
- * - `'env'`    — the stage called `getEnv()` / `$getEnv()` with a non-empty
- *   execution environment (frozen, untracked by design)
- * - `'silent'` — the stage performed a silent read (`getValueSilent` /
- *   `getValueDirect`) of a key it never tracked-read in the same stage.
- *   Silent reads SHADOWED by a tracked read of the same key in the same
- *   stage (TypedScope array-proxy internals, `$batchArray`) are NOT
- *   flagged — their read→write edge is already captured.
- */
-export type UntrackedSource = 'args' | 'env' | 'silent';
-/** The atomic bundle produced by TransactionBuffer.commit(). */
-export interface CommitBundle {
-    /** Auto-assigned step index (set by EventLog.record). */
-    idx?: number;
-    /** Human-readable stage name. */
-    stage: string;
-    /** Stable stage identifier (matches spec node id). */
-    stageId: string;
-    /** Unique per-execution-step identifier. Format: [subflowPath/]stageId#executionIndex */
-    runtimeStageId: string;
-    /** Chronological write log for deterministic replay. */
-    trace: TraceEntry[];
-    /** Paths that should be redacted in UI (sensitive data). */
-    redactedPaths: string[];
-    /** Hard overwrite patches. */
-    overwrite: MemoryPatch;
-    /** Deep merge patches. */
-    updates: MemoryPatch;
-    /**
-     * RFC-003 D2 honesty markers — untracked read paths this stage consumed
-     * (see {@link UntrackedSource}). ABSENT when the stage used none, so
-     * charts that never touch those paths keep byte-identical commit logs.
-     * Causal-slice consumers (`causalChain`/`formatCausalChain`) surface this
-     * as "slice may be incomplete here". Residual limitation (by design):
-     * values smuggled through JS closures are undetectable.
-     */
-    untrackedSources?: ReadonlyArray<UntrackedSource>;
-    /**
-     * Declared tags (9.21.0) — the names the author put on this stage at build
-     * time (`FlowChartBuilder.tag` / `options.tags`), stamped here by the
-     * traverser so a stored recording carries its own milestones without a
-     * consumer's id conventions. ABSENT when the stage declares none, so an
-     * untagged chart's log is byte-identical to 9.20.0 (the law
-     * `untrackedSources` keeps). Recorded on the FIRST bundle of each execution
-     * of the stage — the stage's own bundle, the one without a `phase` — so
-     * retry attempts stamp it once, a continuation (a fork child's `'repeat'`,
-     * a mount's `'exit'` after its merge-back) carries none, and a mount whose
-     * exit is its only bundle (no `outputMapper`) carries them on that bundle. Free strings: footprintjs assigns
-     * them no meaning; `tagStops` (footprintjs/trace) keeps a stop when any of
-     * them matches.
-     */
-    tags?: readonly string[];
-    /**
-     * Which CONTINUATION of a stage's execution this bundle is (9.39.0) —
-     * stamped by the WRITER. THE LAW: the FIRST bundle per `runtimeStageId` is
-     * the stage's own and carries NO `phase`; only a bundle after it can:
-     *
-     * - `'exit'` — a subflow mount's exit commit (`SubflowExecutor`) after its
-     *   merge-back bundle (`outputMapper`). A mount without a merge-back (a lazy
-     *   mount, every `parallelForEach` branch, any mount with no mapper) has
-     *   its exit as its ONLY bundle — its own, so no `phase`; the execution
-     *   tree names it a mount.
-     * - `'repeat'` — the fan-out's settle commit of a fork child's frame
-     *   (`ChildrenExecutor`), after the child's own bundle.
-     *
-     * A reader groups a stage's bundles by `runtimeStageId` and reads this
-     * field to know what each continuation is; it never infers it from the
-     * log's shape. A log written before 9.39.0 carries no `phase` anywhere —
-     * see `inferLegacyPhases` (footprintjs/trace) for how it is still read.
-     */
-    phase?: CommitPhase;
-}
-/** The continuation a bundle records — see {@link CommitBundle.phase}. */
-export type CommitPhase = 'exit' | 'repeat';
-/**
- * Per-write read-provenance policy (#P1) — the fourth dial of the
- * readTracking/writeTracking/commitValues family, same 6-site propagation
- * pattern (executor option → ExecutionRuntime.use* → root StageContext →
- * createNext/createChild inheritance → SubflowExecutor duck-push).
- *
- * - `'off'` (default) — zero cost, byte-identical commit logs.
- * - `'reads-prefix'` — every committed {@link TraceEntry} carries
- *   `readKeys`: the keys tracked-read BEFORE that write (temporal-prefix
- *   attribution). Cost: one Set-to-array copy per write. Consumed by
- *   `causalChain`'s `edgeAttribution: 'per-write'` and the slice layer.
- */
-export type WriteProvenanceMode = 'off' | 'reads-prefix';
-/**
- * Policy for how commit-bundle VALUES are encoded into the commit log
- * (#13c-B) — completes the `readTracking`/`writeTracking` dial family.
- * Unlike those two (which gate lossy snapshot bookkeeping), this dial is
- * **lossless in both modes** — it changes the commit log's *encoding*,
- * never its *information*; any step's full state stays exactly
- * reconstructable by replay.
- *
- * - `'full'` (default) — every surviving `set` path stores the full final
- *   value, one trace entry per operation. Byte-identical to the historical
- *   behavior.
- * - `'delta'` — two changes, both replay-covered by `applySmartMerge`:
- *   1. **`append` detection**: when a path's net change is "the base array
- *      plus new trailing elements" (strict prefix), the bundle records ONLY
- *      the tail under a `verb: 'append'` trace entry — the growing-history
- *      commit log becomes linear in tail size instead of O(N²) retained.
- *      A real `verb: 'delete'` entry replaces the `set: undefined` flattening
- *      for `deleteValue()` (closes the documented MemoryPatch limitation).
- *   2. **One trace entry per surviving path** (append is not idempotent on
- *      replay): the verb is resolved from the path's base→final relationship
- *      and op mix; entries are ordered by each path's LAST touch.
- *
- * Honest cost note: append detection is NEW wall work — an O(|base|)
- * structural prefix compare per array-set path per commit (today's
- * `deepEqual` fast-fails on length in O(1) for a grown array). On a hit the
- * commit gets cheaper in both wall and heap (the O(|final|) clone shrinks to
- * O(|tail|)); on a miss it pays compare + full clone. `'full'` pays zero —
- * the detection branch is mode-gated.
- *
- * Set via `new FlowChartExecutor(chart, { commitValues })` or
- * `executor.setCommitValues(mode)` (before `run()`). The active mode is
- * surfaced as the snapshot discriminant `RuntimeSnapshot.commitValues`.
- */
-export type CommitValuesMode = 'full' | 'delta';
-/**
- * The execution tree as the record's readers read it (C6): the fields a reader touches and
- * nothing else. `commitStops` (and so `tagStops` and every strategy built on it) reads the mount
- * marker (`subflowId`) and the root's `id`; `keysReadFromExecutionTree` reads the keys of
- * `stageReads`; both key on `runtimeStageId` and walk `next` and `children`.
- *
- * A structural type the record owns, so the readers name nothing of the engine. The engine's
- * `StageSnapshot` (`getSnapshot().executionTree`) is one — a supertype of it, so every caller
- * that hands a snapshot's tree over compiles unchanged — and so is a stored recording's parsed
- * JSON with these fields. Every field is optional: a reader that finds one absent reads on.
- *
- * @example
- * ```typescript
- * import { type ExecutionTree, keysReadFromExecutionTree } from 'footprintjs/trace';
- *
- * const tree: ExecutionTree = {
- *   runtimeStageId: 'seed#0',
- *   next: { runtimeStageId: 'decide#1', stageReads: { creditTier: 'A' } },
- * };
- * keysReadFromExecutionTree(tree).lookup('decide#1'); // ['creditTier']
- * ```
- */
-export interface ExecutionTree {
-    /** The stage's id (prefixed inside a subflow). `commitStops` reads the root's to place a subflow's seed. */
-    readonly id?: string;
-    /** `[subflowPath/]stageId#executionIndex` — what a reader keys on. A node without one is not a stage. */
-    readonly runtimeStageId?: string;
-    /** Present on a subflow mount: the stop there says `kind: 'mount'`. */
-    readonly subflowId?: string;
-    /** What the stage tracked-read, by key. Only the KEYS are read: a `'summary'` marker serves as well as a value. */
-    readonly stageReads?: Readonly<Record<string, unknown>>;
-    /** The stage that ran next. */
-    readonly next?: ExecutionTree;
-    /** The stages that ran as this one's children (a fork's branches, a decider's chosen branch). */
-    readonly children?: readonly ExecutionTree[];
-}

package/dist/esm/lib/memory/types.js

@@ -1,10 +0,0 @@
-/**
- * types.ts — the record's types: a bundle, its rows, its patches, its encoding, and the
- * execution tree as the record's readers read it.
- *
- * Imports nothing. The record names nothing outside itself (C6, `RECORD_FILES` in
- * scripts/layering.config.cjs): the engine's frame types — the stage snapshot, the flow
- * messages, the retention dials — live beside the frame, in `frameTypes.ts` (L4).
- */
-export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL21lbW9yeS90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7OztHQU9HIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiB0eXBlcy50cyDigJQgdGhlIHJlY29yZCdzIHR5cGVzOiBhIGJ1bmRsZSwgaXRzIHJvd3MsIGl0cyBwYXRjaGVzLCBpdHMgZW5jb2RpbmcsIGFuZCB0aGVcbiAqIGV4ZWN1dGlvbiB0cmVlIGFzIHRoZSByZWNvcmQncyByZWFkZXJzIHJlYWQgaXQuXG4gKlxuICogSW1wb3J0cyBub3RoaW5nLiBUaGUgcmVjb3JkIG5hbWVzIG5vdGhpbmcgb3V0c2lkZSBpdHNlbGYgKEM2LCBgUkVDT1JEX0ZJTEVTYCBpblxuICogc2NyaXB0cy9sYXllcmluZy5jb25maWcuY2pzKTogdGhlIGVuZ2luZSdzIGZyYW1lIHR5cGVzIOKAlCB0aGUgc3RhZ2Ugc25hcHNob3QsIHRoZSBmbG93XG4gKiBtZXNzYWdlcywgdGhlIHJldGVudGlvbiBkaWFscyDigJQgbGl2ZSBiZXNpZGUgdGhlIGZyYW1lLCBpbiBgZnJhbWVUeXBlcy50c2AgKEw0KS5cbiAqL1xuXG4vLyDilIDilIAgUGF0Y2ggJiBUcmFjZSDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIBcblxuLyoqIEEgZmxhdCBrZXktdmFsdWUgYmFnIHJlcHJlc2VudGluZyBhIHN0YXRlIHBhdGNoIChvdmVyd3JpdGUgb3IgbWVyZ2UpLiAqL1xuZXhwb3J0IGludGVyZmFjZSBNZW1vcnlQYXRjaCB7XG4gIFtrZXk6IHN0cmluZ106IGFueTtcbn1cblxuLyoqIEEgc2luZ2xlIGVudHJ5IGluIHRoZSBjaHJvbm9sb2dpY2FsIG9wZXJhdGlvbiB0cmFjZS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVHJhY2VFbnRyeSB7XG4gIC8qKiBDYW5vbmljYWwgcGF0aCBzdHJpbmcgKHNlZ21lbnRzIGpvaW5lZCBieSBERUxJTSkuICovXG4gIHBhdGg6IHN0cmluZztcbiAgLyoqXG4gICAqIFBlci13cml0ZSByZWFkIHByb3ZlbmFuY2UgKCNQMSkg4oCUIHRoZSBrZXlzIHRoaXMgc3RhZ2UgaGFkIFRSQUNLRUQtUkVBRCBhdFxuICAgKiB0aGUgbW9tZW50IHRoaXMgcGF0aCB3YXMgKGxhc3QpIHdyaXR0ZW46IHRoZSB0ZW1wb3JhbC1wcmVmaXggYXR0cmlidXRpb25cbiAgICogdGhhdCBsZXRzIHNsaWNlcyBsaW5rIGEgc3BlY2lmaWMgd3JpdGUgdG8gb25seSB0aGUgcmVhZHMgdGhhdCBjb3VsZCBoYXZlXG4gICAqIGZlZCBpdCAoYSBzdGFnZSByZWFkaW5nIGBhLGJgIGFuZCB3cml0aW5nIGB4LHlgIG5vIGxvbmdlciBpbXBsaWVzIHjihpBiKS5cbiAgICogQUJTRU5UIHVubGVzcyB0aGUgYHdyaXRlUHJvdmVuYW5jZTogJ3JlYWRzLXByZWZpeCdgIGRpYWwgaXMgb24g4oCUIGNoYXJ0c1xuICAgKiB0aGF0IG5ldmVyIGVuYWJsZSBpdCBrZWVwIGJ5dGUtaWRlbnRpY2FsIGNvbW1pdCBsb2dzLiBSZWFkIHByZWZpeGVzIG9ubHlcbiAgICogZ3JvdyBkdXJpbmcgYSBzdGFnZSwgc28gdW5kZXIgZGVsdGEgbW9kZSdzIG9uZS1lbnRyeS1wZXItcGF0aCBkZWR1cCB0aGVcbiAgICogTEFTVCB3cml0ZSdzIHByZWZpeCA9PSB0aGUgdW5pb24gYWNyb3NzIGFsbCBvZiB0aGF0IHBhdGgncyB3cml0ZXMuXG4gICAqIEhvbmVzdCBjZWlsaW5nOiBhIHdyaXRlIHdpdGggTk8gdHJhY2tlZCByZWFkcyBiZWZvcmUgaXQgcmVjb3JkcyBgW11gIOKAlFxuICAgKiBcImRlcGVuZGVkIG9uIG5vIHRyYWNrZWQgcmVhZHNcIiBpcyBpbmZvcm1hdGlvbiwgbm90IGFic2VuY2UuXG4gICAqL1xuICByZWFkS2V5cz86IHN0cmluZ1tdO1xuICAvKipcbiAgICogLSBgJ3NldCdgICAgIOKAlCBoYXJkIG92ZXJ3cml0ZTsgYG92ZXJ3cml0ZVtwYXRoXWAgaG9sZHMgdGhlIGZ1bGwgZmluYWwgdmFsdWUuXG4gICAqIC0gYCdtZXJnZSdgICDigJQgZGVlcCB1bmlvbiBtZXJnZTsgYHVwZGF0ZXNbcGF0aF1gIGhvbGRzIHRoZSBhY2N1bXVsYXRlZCBkZWx0YS5cbiAgICogLSBgJ2FwcGVuZCdgIOKAlCAoIzEzYy1CLCBwcm9kdWNlZCBvbmx5IHVuZGVyIHtAbGluayBDb21taXRWYWx1ZXNNb2RlfVxuICAgKiAgIGAnZGVsdGEnYCkgdGhlIHBhdGgncyBmaW5hbCB2YWx1ZSBpcyBpdHMgYmFzZSB2YWx1ZSBwbHVzIGEgdGFpbCBvZiBuZXdcbiAgICogICB0cmFpbGluZyBlbGVtZW50czsgYG92ZXJ3cml0ZVtwYXRoXWAgaG9sZHMgT05MWSB0aGUgdGFpbC4gUmVwbGF5XG4gICAqICAgcmVjb25zdHJ1Y3RzIGJ5IGNvbmNhdGVuYXRpb24uIE5PVCBpZGVtcG90ZW50IOKAlCBkZWx0YS1tb2RlIGJ1bmRsZXNcbiAgICogICBjYXJyeSBleGFjdGx5IG9uZSB0cmFjZSBlbnRyeSBwZXIgc3Vydml2aW5nIHBhdGguXG4gICAqIC0gYCdkZWxldGUnYCDigJQgKCMxM2MtQiwgcHJvZHVjZWQgb25seSB1bmRlciBgJ2RlbHRhJ2A7IGFic29yYnMgYmFja2xvZ1xuICAgKiAgIEI4KSB0aGUga2V5IHdhcyBleHBsaWNpdGx5IHJlbW92ZWQgdmlhIGBkZWxldGVWYWx1ZSgpYC4gUmVwbGF5IHJlbW92ZXNcbiAgICogICB0aGUga2V5LiBgb3ZlcndyaXRlW3BhdGhdYCBzdGlsbCBFTlVNRVJBVEVTIHRoZSBwYXRoICh2YWx1ZVxuICAgKiAgIGB1bmRlZmluZWRgKSBzbyBrZXktc2V0IGNvbnN1bWVycyBrZWVwIHNlZWluZyB0aGUgY2hhbmdlZCBrZXkuXG4gICAqXG4gICAqIGBvdmVyd3JpdGVgIHZhbHVlcyBhcmUgdGhlcmVmb3JlIFZFUkItUVVBTElGSUVEOiBjb25zdW1lcnMgdGhhdCByZWFkXG4gICAqIGBidW5kbGUub3ZlcndyaXRlW2tleV1gIGFzIFwidGhlIGZ1bGwgdmFsdWUgd3JpdHRlblwiIG11c3QgdXNlXG4gICAqIGBjb21taXRWYWx1ZUF0KGNvbW1pdExvZywgaWR4LCBrZXkpYCAoZnJvbSBgZm9vdHByaW50anMvdHJhY2VgKSB3aGVuIHRoZVxuICAgKiBsb2cgbWF5IGNvbnRhaW4gZGVsdGEtbW9kZSBidW5kbGVzLlxuICAgKi9cbiAgdmVyYjogJ3NldCcgfCAnbWVyZ2UnIHwgJ2FwcGVuZCcgfCAnZGVsZXRlJztcbn1cblxuLyoqXG4gKiBSRkMtMDAzIEQyIOKAlCByZWFkIHBhdGhzIHRoYXQgQllQQVNTIHJlYWQgdHJhY2tpbmc6XG4gKiAtIGAnYXJncydgICAg4oCUIHRoZSBzdGFnZSBjYWxsZWQgYGdldEFyZ3MoKWAgLyBgJGdldEFyZ3MoKWAgd2l0aCBub24tZW1wdHlcbiAqICAgcnVuIGlucHV0IChmcm96ZW4sIHVudHJhY2tlZCBieSBkZXNpZ24pXG4gKiAtIGAnZW52J2AgICAg4oCUIHRoZSBzdGFnZSBjYWxsZWQgYGdldEVudigpYCAvIGAkZ2V0RW52KClgIHdpdGggYSBub24tZW1wdHlcbiAqICAgZXhlY3V0aW9uIGVudmlyb25tZW50IChmcm96ZW4sIHVudHJhY2tlZCBieSBkZXNpZ24pXG4gKiAtIGAnc2lsZW50J2Ag4oCUIHRoZSBzdGFnZSBwZXJmb3JtZWQgYSBzaWxlbnQgcmVhZCAoYGdldFZhbHVlU2lsZW50YCAvXG4gKiAgIGBnZXRWYWx1ZURpcmVjdGApIG9mIGEga2V5IGl0IG5ldmVyIHRyYWNrZWQtcmVhZCBpbiB0aGUgc2FtZSBzdGFnZS5cbiAqICAgU2lsZW50IHJlYWRzIFNIQURPV0VEIGJ5IGEgdHJhY2tlZCByZWFkIG9mIHRoZSBzYW1lIGtleSBpbiB0aGUgc2FtZVxuICogICBzdGFnZSAoVHlwZWRTY29wZSBhcnJheS1wcm94eSBpbnRlcm5hbHMsIGAkYmF0Y2hBcnJheWApIGFyZSBOT1RcbiAqICAgZmxhZ2dlZCDigJQgdGhlaXIgcmVhZOKGkndyaXRlIGVkZ2UgaXMgYWxyZWFkeSBjYXB0dXJlZC5cbiAqL1xuZXhwb3J0IHR5cGUgVW50cmFja2VkU291cmNlID0gJ2FyZ3MnIHwgJ2VudicgfCAnc2lsZW50JztcblxuLyoqIFRoZSBhdG9taWMgYnVuZGxlIHByb2R1Y2VkIGJ5IFRyYW5zYWN0aW9uQnVmZmVyLmNvbW1pdCgpLiAqL1xuZXhwb3J0IGludGVyZmFjZSBDb21taXRCdW5kbGUge1xuICAvKiogQXV0by1hc3NpZ25lZCBzdGVwIGluZGV4IChzZXQgYnkgRXZlbnRMb2cucmVjb3JkKS4gKi9cbiAgaWR4PzogbnVtYmVyO1xuICAvKiogSHVtYW4tcmVhZGFibGUgc3RhZ2UgbmFtZS4gKi9cbiAgc3RhZ2U6IHN0cmluZztcbiAgLyoqIFN0YWJsZSBzdGFnZSBpZGVudGlmaWVyIChtYXRjaGVzIHNwZWMgbm9kZSBpZCkuICovXG4gIHN0YWdlSWQ6IHN0cmluZztcbiAgLyoqIFVuaXF1ZSBwZXItZXhlY3V0aW9uLXN0ZXAgaWRlbnRpZmllci4gRm9ybWF0OiBbc3ViZmxvd1BhdGgvXXN0YWdlSWQjZXhlY3V0aW9uSW5kZXggKi9cbiAgcnVudGltZVN0YWdlSWQ6IHN0cmluZztcbiAgLyoqIENocm9ub2xvZ2ljYWwgd3JpdGUgbG9nIGZvciBkZXRlcm1pbmlzdGljIHJlcGxheS4gKi9cbiAgdHJhY2U6IFRyYWNlRW50cnlbXTtcbiAgLyoqIFBhdGhzIHRoYXQgc2hvdWxkIGJlIHJlZGFjdGVkIGluIFVJIChzZW5zaXRpdmUgZGF0YSkuICovXG4gIHJlZGFjdGVkUGF0aHM6IHN0cmluZ1tdO1xuICAvKiogSGFyZCBvdmVyd3JpdGUgcGF0Y2hlcy4gKi9cbiAgb3ZlcndyaXRlOiBNZW1vcnlQYXRjaDtcbiAgLyoqIERlZXAgbWVyZ2UgcGF0Y2hlcy4gKi9cbiAgdXBkYXRlczogTWVtb3J5UGF0Y2g7XG4gIC8qKlxuICAgKiBSRkMtMDAzIEQyIGhvbmVzdHkgbWFya2VycyDigJQgdW50cmFja2VkIHJlYWQgcGF0aHMgdGhpcyBzdGFnZSBjb25zdW1lZFxuICAgKiAoc2VlIHtAbGluayBVbnRyYWNrZWRTb3VyY2V9KS4gQUJTRU5UIHdoZW4gdGhlIHN0YWdlIHVzZWQgbm9uZSwgc29cbiAgICogY2hhcnRzIHRoYXQgbmV2ZXIgdG91Y2ggdGhvc2UgcGF0aHMga2VlcCBieXRlLWlkZW50aWNhbCBjb21taXQgbG9ncy5cbiAgICogQ2F1c2FsLXNsaWNlIGNvbnN1bWVycyAoYGNhdXNhbENoYWluYC9gZm9ybWF0Q2F1c2FsQ2hhaW5gKSBzdXJmYWNlIHRoaXNcbiAgICogYXMgXCJzbGljZSBtYXkgYmUgaW5jb21wbGV0ZSBoZXJlXCIuIFJlc2lkdWFsIGxpbWl0YXRpb24gKGJ5IGRlc2lnbik6XG4gICAqIHZhbHVlcyBzbXVnZ2xlZCB0aHJvdWdoIEpTIGNsb3N1cmVzIGFyZSB1bmRldGVjdGFibGUuXG4gICAqL1xuICB1bnRyYWNrZWRTb3VyY2VzPzogUmVhZG9ubHlBcnJheTxVbnRyYWNrZWRTb3VyY2U+O1xuICAvKipcbiAgICogRGVjbGFyZWQgdGFncyAoOS4yMS4wKSDigJQgdGhlIG5hbWVzIHRoZSBhdXRob3IgcHV0IG9uIHRoaXMgc3RhZ2UgYXQgYnVpbGRcbiAgICogdGltZSAoYEZsb3dDaGFydEJ1aWxkZXIudGFnYCAvIGBvcHRpb25zLnRhZ3NgKSwgc3RhbXBlZCBoZXJlIGJ5IHRoZVxuICAgKiB0cmF2ZXJzZXIgc28gYSBzdG9yZWQgcmVjb3JkaW5nIGNhcnJpZXMgaXRzIG93biBtaWxlc3RvbmVzIHdpdGhvdXQgYVxuICAgKiBjb25zdW1lcidzIGlkIGNvbnZlbnRpb25zLiBBQlNFTlQgd2hlbiB0aGUgc3RhZ2UgZGVjbGFyZXMgbm9uZSwgc28gYW5cbiAgICogdW50YWdnZWQgY2hhcnQncyBsb2cgaXMgYnl0ZS1pZGVudGljYWwgdG8gOS4yMC4wICh0aGUgbGF3XG4gICAqIGB1bnRyYWNrZWRTb3VyY2VzYCBrZWVwcykuIFJlY29yZGVkIG9uIHRoZSBGSVJTVCBidW5kbGUgb2YgZWFjaCBleGVjdXRpb25cbiAgICogb2YgdGhlIHN0YWdlIOKAlCB0aGUgc3RhZ2UncyBvd24gYnVuZGxlLCB0aGUgb25lIHdpdGhvdXQgYSBgcGhhc2VgIOKAlCBzb1xuICAgKiByZXRyeSBhdHRlbXB0cyBzdGFtcCBpdCBvbmNlLCBhIGNvbnRpbnVhdGlvbiAoYSBmb3JrIGNoaWxkJ3MgYCdyZXBlYXQnYCxcbiAgICogYSBtb3VudCdzIGAnZXhpdCdgIGFmdGVyIGl0cyBtZXJnZS1iYWNrKSBjYXJyaWVzIG5vbmUsIGFuZCBhIG1vdW50IHdob3NlXG4gICAqIGV4aXQgaXMgaXRzIG9ubHkgYnVuZGxlIChubyBgb3V0cHV0TWFwcGVyYCkgY2FycmllcyB0aGVtIG9uIHRoYXQgYnVuZGxlLiBGcmVlIHN0cmluZ3M6IGZvb3RwcmludGpzIGFzc2lnbnNcbiAgICogdGhlbSBubyBtZWFuaW5nOyBgdGFnU3RvcHNgIChmb290cHJpbnRqcy90cmFjZSkga2VlcHMgYSBzdG9wIHdoZW4gYW55IG9mXG4gICAqIHRoZW0gbWF0Y2hlcy5cbiAgICovXG4gIHRhZ3M/OiByZWFkb25seSBzdHJpbmdbXTtcbiAgLyoqXG4gICAqIFdoaWNoIENPTlRJTlVBVElPTiBvZiBhIHN0YWdlJ3MgZXhlY3V0aW9uIHRoaXMgYnVuZGxlIGlzICg5LjM5LjApIOKAlFxuICAgKiBzdGFtcGVkIGJ5IHRoZSBXUklURVIuIFRIRSBMQVc6IHRoZSBGSVJTVCBidW5kbGUgcGVyIGBydW50aW1lU3RhZ2VJZGAgaXNcbiAgICogdGhlIHN0YWdlJ3Mgb3duIGFuZCBjYXJyaWVzIE5PIGBwaGFzZWA7IG9ubHkgYSBidW5kbGUgYWZ0ZXIgaXQgY2FuOlxuICAgKlxuICAgKiAtIGAnZXhpdCdgIOKAlCBhIHN1YmZsb3cgbW91bnQncyBleGl0IGNvbW1pdCAoYFN1YmZsb3dFeGVjdXRvcmApIGFmdGVyIGl0c1xuICAgKiAgIG1lcmdlLWJhY2sgYnVuZGxlIChgb3V0cHV0TWFwcGVyYCkuIEEgbW91bnQgd2l0aG91dCBhIG1lcmdlLWJhY2sgKGEgbGF6eVxuICAgKiAgIG1vdW50LCBldmVyeSBgcGFyYWxsZWxGb3JFYWNoYCBicmFuY2gsIGFueSBtb3VudCB3aXRoIG5vIG1hcHBlcikgaGFzXG4gICAqICAgaXRzIGV4aXQgYXMgaXRzIE9OTFkgYnVuZGxlIOKAlCBpdHMgb3duLCBzbyBubyBgcGhhc2VgOyB0aGUgZXhlY3V0aW9uXG4gICAqICAgdHJlZSBuYW1lcyBpdCBhIG1vdW50LlxuICAgKiAtIGAncmVwZWF0J2Ag4oCUIHRoZSBmYW4tb3V0J3Mgc2V0dGxlIGNvbW1pdCBvZiBhIGZvcmsgY2hpbGQncyBmcmFtZVxuICAgKiAgIChgQ2hpbGRyZW5FeGVjdXRvcmApLCBhZnRlciB0aGUgY2hpbGQncyBvd24gYnVuZGxlLlxuICAgKlxuICAgKiBBIHJlYWRlciBncm91cHMgYSBzdGFnZSdzIGJ1bmRsZXMgYnkgYHJ1bnRpbWVTdGFnZUlkYCBhbmQgcmVhZHMgdGhpc1xuICAgKiBmaWVsZCB0byBrbm93IHdoYXQgZWFjaCBjb250aW51YXRpb24gaXM7IGl0IG5ldmVyIGluZmVycyBpdCBmcm9tIHRoZVxuICAgKiBsb2cncyBzaGFwZS4gQSBsb2cgd3JpdHRlbiBiZWZvcmUgOS4zOS4wIGNhcnJpZXMgbm8gYHBoYXNlYCBhbnl3aGVyZSDigJRcbiAgICogc2VlIGBpbmZlckxlZ2FjeVBoYXNlc2AgKGZvb3RwcmludGpzL3RyYWNlKSBmb3IgaG93IGl0IGlzIHN0aWxsIHJlYWQuXG4gICAqL1xuICBwaGFzZT86IENvbW1pdFBoYXNlO1xufVxuXG4vKiogVGhlIGNvbnRpbnVhdGlvbiBhIGJ1bmRsZSByZWNvcmRzIOKAlCBzZWUge0BsaW5rIENvbW1pdEJ1bmRsZS5waGFzZX0uICovXG5leHBvcnQgdHlwZSBDb21taXRQaGFzZSA9ICdleGl0JyB8ICdyZXBlYXQnO1xuXG4vKipcbiAqIFBlci13cml0ZSByZWFkLXByb3ZlbmFuY2UgcG9saWN5ICgjUDEpIOKAlCB0aGUgZm91cnRoIGRpYWwgb2YgdGhlXG4gKiByZWFkVHJhY2tpbmcvd3JpdGVUcmFja2luZy9jb21taXRWYWx1ZXMgZmFtaWx5LCBzYW1lIDYtc2l0ZSBwcm9wYWdhdGlvblxuICogcGF0dGVybiAoZXhlY3V0b3Igb3B0aW9uIOKGkiBFeGVjdXRpb25SdW50aW1lLnVzZSog4oaSIHJvb3QgU3RhZ2VDb250ZXh0IOKGklxuICogY3JlYXRlTmV4dC9jcmVhdGVDaGlsZCBpbmhlcml0YW5jZSDihpIgU3ViZmxvd0V4ZWN1dG9yIGR1Y2stcHVzaCkuXG4gKlxuICogLSBgJ29mZidgIChkZWZhdWx0KSDigJQgemVybyBjb3N0LCBieXRlLWlkZW50aWNhbCBjb21taXQgbG9ncy5cbiAqIC0gYCdyZWFkcy1wcmVmaXgnYCDigJQgZXZlcnkgY29tbWl0dGVkIHtAbGluayBUcmFjZUVudHJ5fSBjYXJyaWVzXG4gKiAgIGByZWFkS2V5c2A6IHRoZSBrZXlzIHRyYWNrZWQtcmVhZCBCRUZPUkUgdGhhdCB3cml0ZSAodGVtcG9yYWwtcHJlZml4XG4gKiAgIGF0dHJpYnV0aW9uKS4gQ29zdDogb25lIFNldC10by1hcnJheSBjb3B5IHBlciB3cml0ZS4gQ29uc3VtZWQgYnlcbiAqICAgYGNhdXNhbENoYWluYCdzIGBlZGdlQXR0cmlidXRpb246ICdwZXItd3JpdGUnYCBhbmQgdGhlIHNsaWNlIGxheWVyLlxuICovXG5leHBvcnQgdHlwZSBXcml0ZVByb3ZlbmFuY2VNb2RlID0gJ29mZicgfCAncmVhZHMtcHJlZml4JztcblxuLyoqXG4gKiBQb2xpY3kgZm9yIGhvdyBjb21taXQtYnVuZGxlIFZBTFVFUyBhcmUgZW5jb2RlZCBpbnRvIHRoZSBjb21taXQgbG9nXG4gKiAoIzEzYy1CKSDigJQgY29tcGxldGVzIHRoZSBgcmVhZFRyYWNraW5nYC9gd3JpdGVUcmFja2luZ2AgZGlhbCBmYW1pbHkuXG4gKiBVbmxpa2UgdGhvc2UgdHdvICh3aGljaCBnYXRlIGxvc3N5IHNuYXBzaG90IGJvb2trZWVwaW5nKSwgdGhpcyBkaWFsIGlzXG4gKiAqKmxvc3NsZXNzIGluIGJvdGggbW9kZXMqKiDigJQgaXQgY2hhbmdlcyB0aGUgY29tbWl0IGxvZydzICplbmNvZGluZyosXG4gKiBuZXZlciBpdHMgKmluZm9ybWF0aW9uKjsgYW55IHN0ZXAncyBmdWxsIHN0YXRlIHN0YXlzIGV4YWN0bHlcbiAqIHJlY29uc3RydWN0YWJsZSBieSByZXBsYXkuXG4gKlxuICogLSBgJ2Z1bGwnYCAoZGVmYXVsdCkg4oCUIGV2ZXJ5IHN1cnZpdmluZyBgc2V0YCBwYXRoIHN0b3JlcyB0aGUgZnVsbCBmaW5hbFxuICogICB2YWx1ZSwgb25lIHRyYWNlIGVudHJ5IHBlciBvcGVyYXRpb24uIEJ5dGUtaWRlbnRpY2FsIHRvIHRoZSBoaXN0b3JpY2FsXG4gKiAgIGJlaGF2aW9yLlxuICogLSBgJ2RlbHRhJ2Ag4oCUIHR3byBjaGFuZ2VzLCBib3RoIHJlcGxheS1jb3ZlcmVkIGJ5IGBhcHBseVNtYXJ0TWVyZ2VgOlxuICogICAxLiAqKmBhcHBlbmRgIGRldGVjdGlvbioqOiB3aGVuIGEgcGF0aCdzIG5ldCBjaGFuZ2UgaXMgXCJ0aGUgYmFzZSBhcnJheVxuICogICAgICBwbHVzIG5ldyB0cmFpbGluZyBlbGVtZW50c1wiIChzdHJpY3QgcHJlZml4KSwgdGhlIGJ1bmRsZSByZWNvcmRzIE9OTFlcbiAqICAgICAgdGhlIHRhaWwgdW5kZXIgYSBgdmVyYjogJ2FwcGVuZCdgIHRyYWNlIGVudHJ5IOKAlCB0aGUgZ3Jvd2luZy1oaXN0b3J5XG4gKiAgICAgIGNvbW1pdCBsb2cgYmVjb21lcyBsaW5lYXIgaW4gdGFpbCBzaXplIGluc3RlYWQgb2YgTyhOwrIpIHJldGFpbmVkLlxuICogICAgICBBIHJlYWwgYHZlcmI6ICdkZWxldGUnYCBlbnRyeSByZXBsYWNlcyB0aGUgYHNldDogdW5kZWZpbmVkYCBmbGF0dGVuaW5nXG4gKiAgICAgIGZvciBgZGVsZXRlVmFsdWUoKWAgKGNsb3NlcyB0aGUgZG9jdW1lbnRlZCBNZW1vcnlQYXRjaCBsaW1pdGF0aW9uKS5cbiAqICAgMi4gKipPbmUgdHJhY2UgZW50cnkgcGVyIHN1cnZpdmluZyBwYXRoKiogKGFwcGVuZCBpcyBub3QgaWRlbXBvdGVudCBvblxuICogICAgICByZXBsYXkpOiB0aGUgdmVyYiBpcyByZXNvbHZlZCBmcm9tIHRoZSBwYXRoJ3MgYmFzZeKGkmZpbmFsIHJlbGF0aW9uc2hpcFxuICogICAgICBhbmQgb3AgbWl4OyBlbnRyaWVzIGFyZSBvcmRlcmVkIGJ5IGVhY2ggcGF0aCdzIExBU1QgdG91Y2guXG4gKlxuICogSG9uZXN0IGNvc3Qgbm90ZTogYXBwZW5kIGRldGVjdGlvbiBpcyBORVcgd2FsbCB3b3JrIOKAlCBhbiBPKHxiYXNlfClcbiAqIHN0cnVjdHVyYWwgcHJlZml4IGNvbXBhcmUgcGVyIGFycmF5LXNldCBwYXRoIHBlciBjb21taXQgKHRvZGF5J3NcbiAqIGBkZWVwRXF1YWxgIGZhc3QtZmFpbHMgb24gbGVuZ3RoIGluIE8oMSkgZm9yIGEgZ3Jvd24gYXJyYXkpLiBPbiBhIGhpdCB0aGVcbiAqIGNvbW1pdCBnZXRzIGNoZWFwZXIgaW4gYm90aCB3YWxsIGFuZCBoZWFwICh0aGUgTyh8ZmluYWx8KSBjbG9uZSBzaHJpbmtzIHRvXG4gKiBPKHx0YWlsfCkpOyBvbiBhIG1pc3MgaXQgcGF5cyBjb21wYXJlICsgZnVsbCBjbG9uZS4gYCdmdWxsJ2AgcGF5cyB6ZXJvIOKAlFxuICogdGhlIGRldGVjdGlvbiBicmFuY2ggaXMgbW9kZS1nYXRlZC5cbiAqXG4gKiBTZXQgdmlhIGBuZXcgRmxvd0NoYXJ0RXhlY3V0b3IoY2hhcnQsIHsgY29tbWl0VmFsdWVzIH0pYCBvclxuICogYGV4ZWN1dG9yLnNldENvbW1pdFZhbHVlcyhtb2RlKWAgKGJlZm9yZSBgcnVuKClgKS4gVGhlIGFjdGl2ZSBtb2RlIGlzXG4gKiBzdXJmYWNlZCBhcyB0aGUgc25hcHNob3QgZGlzY3JpbWluYW50IGBSdW50aW1lU25hcHNob3QuY29tbWl0VmFsdWVzYC5cbiAqL1xuZXhwb3J0IHR5cGUgQ29tbWl0VmFsdWVzTW9kZSA9ICdmdWxsJyB8ICdkZWx0YSc7XG5cbi8vIOKUgOKUgCBUaGUgZXhlY3V0aW9uIHRyZWUsIGFzIHRoZSByZWNvcmQncyByZWFkZXJzIHJlYWQgaXQg4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSAXG5cbi8qKlxuICogVGhlIGV4ZWN1dGlvbiB0cmVlIGFzIHRoZSByZWNvcmQncyByZWFkZXJzIHJlYWQgaXQgKEM2KTogdGhlIGZpZWxkcyBhIHJlYWRlciB0b3VjaGVzIGFuZFxuICogbm90aGluZyBlbHNlLiBgY29tbWl0U3RvcHNgIChhbmQgc28gYHRhZ1N0b3BzYCBhbmQgZXZlcnkgc3RyYXRlZ3kgYnVpbHQgb24gaXQpIHJlYWRzIHRoZSBtb3VudFxuICogbWFya2VyIChgc3ViZmxvd0lkYCkgYW5kIHRoZSByb290J3MgYGlkYDsgYGtleXNSZWFkRnJvbUV4ZWN1dGlvblRyZWVgIHJlYWRzIHRoZSBrZXlzIG9mXG4gKiBgc3RhZ2VSZWFkc2A7IGJvdGgga2V5IG9uIGBydW50aW1lU3RhZ2VJZGAgYW5kIHdhbGsgYG5leHRgIGFuZCBgY2hpbGRyZW5gLlxuICpcbiAqIEEgc3RydWN0dXJhbCB0eXBlIHRoZSByZWNvcmQgb3ducywgc28gdGhlIHJlYWRlcnMgbmFtZSBub3RoaW5nIG9mIHRoZSBlbmdpbmUuIFRoZSBlbmdpbmUnc1xuICogYFN0YWdlU25hcHNob3RgIChgZ2V0U25hcHNob3QoKS5leGVjdXRpb25UcmVlYCkgaXMgb25lIOKAlCBhIHN1cGVydHlwZSBvZiBpdCwgc28gZXZlcnkgY2FsbGVyXG4gKiB0aGF0IGhhbmRzIGEgc25hcHNob3QncyB0cmVlIG92ZXIgY29tcGlsZXMgdW5jaGFuZ2VkIOKAlCBhbmQgc28gaXMgYSBzdG9yZWQgcmVjb3JkaW5nJ3MgcGFyc2VkXG4gKiBKU09OIHdpdGggdGhlc2UgZmllbGRzLiBFdmVyeSBmaWVsZCBpcyBvcHRpb25hbDogYSByZWFkZXIgdGhhdCBmaW5kcyBvbmUgYWJzZW50IHJlYWRzIG9uLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBpbXBvcnQgeyB0eXBlIEV4ZWN1dGlvblRyZWUsIGtleXNSZWFkRnJvbUV4ZWN1dGlvblRyZWUgfSBmcm9tICdmb290cHJpbnRqcy90cmFjZSc7XG4gKlxuICogY29uc3QgdHJlZTogRXhlY3V0aW9uVHJlZSA9IHtcbiAqICAgcnVudGltZVN0YWdlSWQ6ICdzZWVkIzAnLFxuICogICBuZXh0OiB7IHJ1bnRpbWVTdGFnZUlkOiAnZGVjaWRlIzEnLCBzdGFnZVJlYWRzOiB7IGNyZWRpdFRpZXI6ICdBJyB9IH0sXG4gKiB9O1xuICoga2V5c1JlYWRGcm9tRXhlY3V0aW9uVHJlZSh0cmVlKS5sb29rdXAoJ2RlY2lkZSMxJyk7IC8vIFsnY3JlZGl0VGllciddXG4gKiBgYGBcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBFeGVjdXRpb25UcmVlIHtcbiAgLyoqIFRoZSBzdGFnZSdzIGlkIChwcmVmaXhlZCBpbnNpZGUgYSBzdWJmbG93KS4gYGNvbW1pdFN0b3BzYCByZWFkcyB0aGUgcm9vdCdzIHRvIHBsYWNlIGEgc3ViZmxvdydzIHNlZWQuICovXG4gIHJlYWRvbmx5IGlkPzogc3RyaW5nO1xuICAvKiogYFtzdWJmbG93UGF0aC9dc3RhZ2VJZCNleGVjdXRpb25JbmRleGAg4oCUIHdoYXQgYSByZWFkZXIga2V5cyBvbi4gQSBub2RlIHdpdGhvdXQgb25lIGlzIG5vdCBhIHN0YWdlLiAqL1xuICByZWFkb25seSBydW50aW1lU3RhZ2VJZD86IHN0cmluZztcbiAgLyoqIFByZXNlbnQgb24gYSBzdWJmbG93IG1vdW50OiB0aGUgc3RvcCB0aGVyZSBzYXlzIGBraW5kOiAnbW91bnQnYC4gKi9cbiAgcmVhZG9ubHkgc3ViZmxvd0lkPzogc3RyaW5nO1xuICAvKiogV2hhdCB0aGUgc3RhZ2UgdHJhY2tlZC1yZWFkLCBieSBrZXkuIE9ubHkgdGhlIEtFWVMgYXJlIHJlYWQ6IGEgYCdzdW1tYXJ5J2AgbWFya2VyIHNlcnZlcyBhcyB3ZWxsIGFzIGEgdmFsdWUuICovXG4gIHJlYWRvbmx5IHN0YWdlUmVhZHM/OiBSZWFkb25seTxSZWNvcmQ8c3RyaW5nLCB1bmtub3duPj47XG4gIC8qKiBUaGUgc3RhZ2UgdGhhdCByYW4gbmV4dC4gKi9cbiAgcmVhZG9ubHkgbmV4dD86IEV4ZWN1dGlvblRyZWU7XG4gIC8qKiBUaGUgc3RhZ2VzIHRoYXQgcmFuIGFzIHRoaXMgb25lJ3MgY2hpbGRyZW4gKGEgZm9yaydzIGJyYW5jaGVzLCBhIGRlY2lkZXIncyBjaG9zZW4gYnJhbmNoKS4gKi9cbiAgcmVhZG9ubHkgY2hpbGRyZW4/OiByZWFkb25seSBFeGVjdXRpb25UcmVlW107XG59XG4iXX0=