agentera 3.0.0-dev.20 → 3.0.0-dev.21

package/dist/state/decisionOverlay.js

@@ -0,0 +1,255 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { dumpYamlMapping, loadYamlMapping } from "../core/yaml.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { assertRealpathBoundary } from "../registries/artifactRegistry.js";
+import { decisionOverlayContract, } from "./archiveDiscovery.js";
+import { reject } from "./write/errors.js";
+function isMapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function mapping(value) {
+    return isMapping(value) ? value : {};
+}
+function valueAt(value, field) {
+    let current = value;
+    for (const part of field.split(".")) {
+        if (!isMapping(current))
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function setAt(target, field, value) {
+    const parts = field.split(".");
+    let current = target;
+    for (const part of parts.slice(0, -1)) {
+        const next = current[part];
+        if (!isMapping(next))
+            current[part] = {};
+        current = current[part];
+    }
+    current[parts.at(-1)] = structuredClone(value);
+}
+function pathAllowed(field, contract) {
+    return contract.mutablePaths.some((mutable) => mutable === field || mutable.startsWith(`${field}.`));
+}
+function validateValueTypes(field, value, contract, violations) {
+    if (field.endsWith(".state")) {
+        if (typeof value !== "string" || !contract.stateValues.includes(value)) {
+            violations.push(`${field} must be one of: ${contract.stateValues.join(", ")}`);
+        }
+        return;
+    }
+    if (field.endsWith(".evidence") || field.endsWith(".confirmed_by") || field.endsWith(".confirmed_at")) {
+        if (typeof value !== "string")
+            violations.push(`${field} must be a string`);
+    }
+}
+function validateOverlayValue(value, contract, prefix = "", violations = []) {
+    if (!isMapping(value)) {
+        violations.push(`${prefix || "overlay entry"} must be a mapping`);
+        return violations;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const field = prefix ? `${prefix}.${key}` : key;
+        if (!pathAllowed(field, contract)) {
+            violations.push(`${field} is not an authority-declared mutable overlay field`);
+            continue;
+        }
+        if (isMapping(child))
+            validateOverlayValue(child, contract, field, violations);
+        else
+            validateValueTypes(field, child, contract, violations);
+    }
+    return violations;
+}
+function decisionNumberFromId(id, contract) {
+    const prefix = `${contract.identityPrefix}:`;
+    if (!id.startsWith(prefix))
+        return null;
+    const number = id.slice(prefix.length);
+    if (!/^[1-9][0-9]*$/.test(number))
+        return null;
+    const parsed = Number(number);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+}
+export function decisionOverlayPath(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const contract = decisionOverlayContract(sourceRoot);
+    const target = path.resolve(projectRoot, contract.location);
+    assertRealpathBoundary(projectRoot, target, "decision overlay");
+    return target;
+}
+export function decisionOverlayViolations(document, contract = decisionOverlayContract()) {
+    if (!isMapping(document))
+        return ["decision overlay root must be a mapping keyed by stable decision ID"];
+    const violations = [];
+    for (const [stableId, value] of Object.entries(document)) {
+        if (decisionNumberFromId(stableId, contract) === null) {
+            violations.push(`${stableId} is not a valid ${contract.identityKey} key`);
+            continue;
+        }
+        validateOverlayValue(value, contract, "", violations);
+    }
+    return violations;
+}
+function readOverlayDocument(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const contract = decisionOverlayContract(sourceRoot);
+    const target = decisionOverlayPath(projectRoot, sourceRoot);
+    if (!fs.existsSync(target))
+        return { path: target, document: {}, contract };
+    const bytes = fs.readFileSync(target, "utf8");
+    let document;
+    try {
+        document = loadYamlMapping(bytes);
+    }
+    catch (error) {
+        throw new Error(`cannot parse decision overlay '${target}': ${error.message}`);
+    }
+    const violations = decisionOverlayViolations(document, contract);
+    if (violations.length > 0)
+        throw new Error(`decision overlay '${target}' is invalid: ${violations.join("; ")}`);
+    return { path: target, document: document, contract };
+}
+export function loadDecisionOverlay(projectRoot = process.cwd(), sourceRoot = resolveSourceRoot()) {
+    return readOverlayDocument(projectRoot, sourceRoot).document;
+}
+export function hydrateDecisionRecords(entries, source = process.cwd()) {
+    const overlay = typeof source === "string" ? loadDecisionOverlay(source) : source;
+    const contract = decisionOverlayContract();
+    return entries.map((entry) => {
+        const number = entry.number;
+        const stableId = typeof number === "number" || typeof number === "string" ? `decisions:${number}` : null;
+        return composeDecisionOverlay(entry, stableId ? overlay[stableId] : undefined, contract);
+    });
+}
+export function composeDecisionOverlay(entry, overlay, contract = decisionOverlayContract()) {
+    if (!overlay)
+        return structuredClone(entry);
+    const hydrated = structuredClone(entry);
+    const historicalSatisfaction = mapping(hydrated.satisfaction);
+    const overlaySatisfaction = mapping(overlay.satisfaction);
+    const composedSatisfaction = { ...historicalSatisfaction };
+    for (const field of contract.mutablePaths) {
+        const relative = field.startsWith("satisfaction.") ? field.slice("satisfaction.".length) : field;
+        const value = valueAt(overlaySatisfaction, relative);
+        if (value !== undefined)
+            setAt(composedSatisfaction, relative, value);
+    }
+    hydrated.satisfaction = composedSatisfaction;
+    return hydrated;
+}
+function requestedSatisfaction(requested, contract) {
+    const violations = validateOverlayValue({ satisfaction: requested }, contract);
+    if (violations.length > 0) {
+        reject({
+            class: "schema_violation",
+            message: "decision satisfaction update contains invalid overlay fields",
+            violations,
+            syntax: "agentera state decisions update --number N --satisfaction-state STATE --format json",
+            example: "agentera state decisions update --number 53 --satisfaction-state provisionally_satisfied --satisfaction-evidence 'verified' --format json",
+        });
+    }
+    const result = {};
+    for (const field of contract.mutablePaths) {
+        const relative = field.startsWith("satisfaction.") ? field.slice("satisfaction.".length) : field;
+        const value = valueAt(requested, relative);
+        if (value !== undefined)
+            setAt(result, relative, value);
+    }
+    return result;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function statePath(contract) {
+    return contract.mutablePaths.find((field) => field.endsWith(".state"))?.slice("satisfaction.".length) ?? "state";
+}
+function evidencePath(contract) {
+    return contract.mutablePaths.find((field) => field.endsWith(".evidence"))?.slice("satisfaction.".length) ?? "evidence";
+}
+function confirmationPaths(contract) {
+    return contract.mutablePaths
+        .filter((field) => field.includes("user_confirmation."))
+        .map((field) => field.slice("satisfaction.".length));
+}
+function effectiveState(overlay, historicalSatisfaction) {
+    return valueAt(overlay?.satisfaction, "state") ?? valueAt(historicalSatisfaction, "state");
+}
+function validateTransition(requested, currentOverlay, historicalSatisfaction, contract) {
+    const nextState = valueAt(requested, statePath(contract));
+    const evidence = valueAt(requested, evidencePath(contract));
+    const confirmation = mapping(requested.user_confirmation);
+    if (nextState === "provisionally_satisfied" && !nonEmptyString(evidence)) {
+        reject({
+            class: "schema_violation",
+            message: "provisionally_satisfied requires non-empty --satisfaction-evidence",
+            syntax: "agentera state decisions update --number N --satisfaction-state STATE --satisfaction-evidence TEXT --format json",
+            example: "agentera state decisions update --number 53 --satisfaction-state provisionally_satisfied --satisfaction-evidence 'verified' --format json",
+        });
+    }
+    if (nextState === "user_confirmed_satisfied") {
+        const paths = confirmationPaths(contract);
+        if (paths.some((field) => !nonEmptyString(valueAt(confirmation, field.split(".").at(-1))))) {
+            reject({
+                class: "schema_violation",
+                message: "user_confirmed_satisfied requires explicit current user confirmation metadata",
+                syntax: "agentera state decisions update --number N --satisfaction-state user_confirmed_satisfied --confirmed-by USER --confirmed-at TIME --format json",
+                example: "agentera state decisions update --number 53 --satisfaction-state user_confirmed_satisfied --confirmed-by user --confirmed-at 2026-07-13T12:00:00Z --format json",
+            });
+        }
+    }
+    const currentState = effectiveState(currentOverlay, historicalSatisfaction);
+    if (typeof currentState === "string" && contract.stateValues.includes(currentState)) {
+        if (!contract.allowedNext[currentState]?.includes(String(nextState))) {
+            const downgradeConfirmation = confirmationPaths(contract).every((field) => nonEmptyString(valueAt(confirmation, field.split(".").at(-1))));
+            if (!(currentState === "user_confirmed_satisfied" && downgradeConfirmation)) {
+                reject({
+                    class: "conflict",
+                    message: `decision satisfaction cannot transition from ${currentState} to ${String(nextState)} without explicit current user confirmation`,
+                    syntax: "agentera state decisions update --number N --satisfaction-state STATE --format json",
+                    example: "agentera state decisions update --number 53 --satisfaction-state user_confirmed_satisfied --confirmed-by user --confirmed-at 2026-07-13T12:00:00Z --format json",
+                });
+            }
+        }
+    }
+}
+export function updateDecisionOverlay(projectRoot, decisionNumber, requested, historicalSatisfaction, transaction, publish = true, sourceRoot = resolveSourceRoot()) {
+    const current = readOverlayDocument(projectRoot, sourceRoot);
+    const stableId = `${current.contract.identityPrefix}:${decisionNumber}`;
+    const currentEntry = current.document[stableId];
+    const satisfaction = requestedSatisfaction(requested, current.contract);
+    validateTransition(satisfaction, currentEntry, historicalSatisfaction, current.contract);
+    const nextDocument = structuredClone(current.document);
+    const replay = Boolean(currentEntry && isDeepStrictEqual(currentEntry.satisfaction, satisfaction));
+    if (!replay)
+        nextDocument[stableId] = { satisfaction };
+    if (!replay && publish) {
+        const bytes = dumpYamlMapping(nextDocument);
+        const violations = decisionOverlayViolations(nextDocument, current.contract);
+        if (violations.length > 0) {
+            reject({
+                class: "schema_violation",
+                message: "decision overlay publication failed validation",
+                violations,
+            });
+        }
+        const stage = transaction.stageProjection(current.path, bytes);
+        try {
+            transaction.syncStaged(stage);
+            transaction.publishProjection(stage, current.path);
+        }
+        finally {
+            transaction.removeStage(stage);
+        }
+    }
+    return {
+        path: current.path,
+        satisfaction,
+        replay,
+        before: current.document,
+        after: nextDocument,
+    };
+}
+//# sourceMappingURL=decisionOverlay.js.map

package/dist/state/decisionOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionOverlay.js","sourceRoot":"","sources":["../../src/state/decisionOverlay.ts"],"names":[],"mappings":"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"}

package/dist/state/directRetrieval.js

@@ -0,0 +1,322 @@
+import fs from "node:fs";
+import { loadYamlMapping } from "../core/yaml.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { canonicalRecordJson, decisionOverlayContract, numberedArchiveArtifacts, numberedArchiveContract, readNumberedArchiveEntry, stateCurrentProjectionPath, validateStateRecord, } from "./archiveDiscovery.js";
+import { composeDecisionOverlay, decisionOverlayPath, loadDecisionOverlay } from "./decisionOverlay.js";
+import { decisionContextEntry } from "../cli/commands/state/decisions.js";
+import { assertRealpathBoundary } from "../registries/artifactRegistry.js";
+import { legacyEntryNumber, legacyIdentity } from "./legacyIdentity.js";
+export class StateRetrievalFailure extends Error {
+    body;
+    exitCode;
+    constructor(body, exitCode) {
+        super(body.error.message);
+        this.body = body;
+        this.exitCode = exitCode;
+    }
+}
+function isMapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function stateSyntax(artifactId = "<artifact-id>") {
+    return `agentera state ${artifactId} get --number N --format json`;
+}
+function stateExample(artifactId, entryNumber = null) {
+    return `agentera state ${artifactId} get --number ${entryNumber ?? 1} --format json`;
+}
+function failure(exitCode, className, message, options) {
+    const artifactId = options.artifactId;
+    const entryNumber = options.entryNumber;
+    const stableId = artifactId && entryNumber ? `${artifactId}:${entryNumber}` : undefined;
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: className,
+            message,
+            syntax: stateSyntax(artifactId),
+            example: artifactId ? stateExample(artifactId, entryNumber ?? null) : stateExample("progress"),
+            recovery: options.recovery,
+            ...(artifactId ? { artifact_id: artifactId } : {}),
+            ...(entryNumber ? { entry_number: entryNumber } : {}),
+            ...(stableId ? { stable_id: stableId } : {}),
+            ...(options.validValues ? { valid_values: options.validValues } : {}),
+            ...(options.details ? { details: options.details } : {}),
+        },
+    }, exitCode);
+}
+function inspectCurrentProjection(projectRoot, artifactId, entryNumber, contract, sourceRoot) {
+    const projectionPath = stateCurrentProjectionPath(projectRoot, artifactId, sourceRoot);
+    try {
+        assertRealpathBoundary(projectRoot, projectionPath, `${artifactId} projection`);
+    }
+    catch (error) {
+        throw failure(1, "corrupt", `current ${artifactId} projection path is unsafe`, {
+            artifactId,
+            entryNumber,
+            recovery: "Preserve the project state, repair the unsafe projection path, then retry the direct get command.",
+            details: { path: projectionPath, reason: error.message },
+        });
+    }
+    let projectionStat;
+    try {
+        projectionStat = fs.lstatSync(projectionPath);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { path: projectionPath, state: "missing" };
+        throw failure(1, "corrupt", `cannot read current ${artifactId} projection`, {
+            artifactId,
+            entryNumber,
+            recovery: "Preserve the current projection for diagnostics, repair its file permissions or path, then retry the direct get command.",
+            details: { path: projectionPath, reason: error.message },
+        });
+    }
+    if (projectionStat.isSymbolicLink() || !projectionStat.isFile()) {
+        throw failure(1, "corrupt", `current ${artifactId} projection is not a regular file`, {
+            artifactId,
+            entryNumber,
+            recovery: "Restore the declared current projection as a regular project-local file, then retry the direct get command.",
+            details: { path: projectionPath },
+        });
+    }
+    let document;
+    try {
+        document = loadYamlMapping(fs.readFileSync(projectionPath, "utf8"));
+    }
+    catch (error) {
+        throw failure(1, "corrupt", `cannot parse current ${artifactId} projection: ${error.message}`, {
+            artifactId,
+            entryNumber,
+            recovery: "Preserve the current projection for diagnostics, repair its YAML, then retry the direct get command.",
+            details: { path: projectionPath },
+        });
+    }
+    const active = document[contract.entryCollection];
+    if (!Array.isArray(active)) {
+        throw failure(1, "corrupt", `current ${artifactId} projection is missing its '${contract.entryCollection}' collection`, {
+            artifactId,
+            entryNumber,
+            recovery: "Restore a valid current projection with its declared entry collection, then retry the direct get command.",
+            details: { path: projectionPath, collection: contract.entryCollection },
+        });
+    }
+    let matchingActive;
+    for (const candidate of active) {
+        if (!isMapping(candidate))
+            continue;
+        if (legacyEntryNumber(candidate, artifactId, contract.entryNumberField) !== entryNumber)
+            continue;
+        if (matchingActive) {
+            throw failure(1, "ambiguous", `current ${artifactId} projection contains duplicate identity ${artifactId}:${entryNumber}`, {
+                artifactId,
+                entryNumber,
+                recovery: "Preserve the duplicate current entries, remove the identity conflict according to the artifact schema, then retry.",
+                details: { path: projectionPath, collection: contract.entryCollection },
+            });
+        }
+        matchingActive = candidate;
+    }
+    if (matchingActive) {
+        try {
+            const violations = validateStateRecord(sourceRoot, artifactId, matchingActive);
+            return {
+                path: projectionPath,
+                state: violations.length === 0 ? "full" : "summary",
+                identity: legacyIdentity(matchingActive, artifactId, contract.entryNumberField).kind,
+                record: matchingActive,
+            };
+        }
+        catch (error) {
+            throw failure(1, "unsupported_state", `current ${artifactId} projection could not be validated: ${error.message}`, {
+                artifactId,
+                entryNumber,
+                recovery: "Use a state schema supported by the storage authority, repair the current projection, then retry.",
+                details: { path: projectionPath },
+            });
+        }
+    }
+    const archive = document.archive;
+    if (Array.isArray(archive)) {
+        for (const candidate of archive) {
+            if (legacyEntryNumber(candidate, artifactId, contract.entryNumberField) !== entryNumber)
+                continue;
+            return {
+                path: projectionPath,
+                state: "summary",
+                identity: legacyIdentity(candidate, artifactId, contract.entryNumberField).kind,
+                record: isMapping(candidate) ? candidate : { summary: candidate },
+            };
+        }
+    }
+    return { path: projectionPath, state: "absent" };
+}
+function overlayFor(projectRoot, sourceRoot, artifactId, entryNumber, record) {
+    if (artifactId !== "decisions")
+        return { record, applied: false, fields: [], path: "" };
+    const contract = decisionOverlayContract(sourceRoot);
+    const overlayPath = decisionOverlayPath(projectRoot, sourceRoot);
+    let overlay;
+    try {
+        overlay = loadDecisionOverlay(projectRoot, sourceRoot);
+    }
+    catch (error) {
+        throw failure(1, "corrupt", `cannot read decision overlay: ${error.message}`, {
+            artifactId,
+            entryNumber,
+            recovery: "Preserve the decision overlay for diagnostics, repair its YAML and whitelisted fields, then retry.",
+            details: { path: overlayPath },
+        });
+    }
+    const stableId = `decisions:${entryNumber}`;
+    const selected = overlay[stableId];
+    const fields = selected
+        ? contract.mutablePaths.filter((field) => {
+            let value = selected;
+            for (const part of field.split(".")) {
+                if (!isMapping(value))
+                    return false;
+                value = value[part];
+            }
+            return value !== undefined;
+        })
+        : [];
+    const composed = composeDecisionOverlay(record, selected, contract);
+    return {
+        record: decisionContextEntry(composed, { inferOutcome: false }),
+        applied: fields.length > 0,
+        fields,
+        path: overlayPath,
+    };
+}
+function compose(projectRoot, sourceRoot, artifactId, entryNumber, current, archivePath, archiveRecord, archiveHash) {
+    const record = archiveRecord ?? current.record;
+    if (!record) {
+        throw failure(1, "incomplete", `state ${artifactId}:${entryNumber} has no complete record available`, {
+            artifactId,
+            entryNumber,
+            recovery: "Restore or publish the validated numbered archive for this ID before retrying; missing fields are not reconstructed.",
+            details: { current_projection_path: current.path, archive_path: archivePath, current_representation: current.state },
+        });
+    }
+    if (!archiveRecord && current.state === "summary" && current.identity !== "explicit_decision_shorthand") {
+        throw failure(1, "incomplete", `state ${artifactId}:${entryNumber} is represented only by an irrecoverable legacy summary`, {
+            artifactId,
+            entryNumber,
+            recovery: "Restore or publish the validated numbered archive for this ID before retrying; missing fields are not reconstructed.",
+            details: { current_projection_path: current.path, archive_path: archivePath, current_representation: current.state },
+        });
+    }
+    const complete = archiveRecord !== undefined || current.state === "full";
+    const overlay = complete ? overlayFor(projectRoot, sourceRoot, artifactId, entryNumber, record) : { record, applied: false, fields: [], path: "" };
+    const source = archiveRecord ? "archive" : current.state === "summary" ? "legacy_summary" : "legacy_full";
+    const compatibility = archiveRecord ? "complete" : "degraded";
+    return {
+        stable_id: `${artifactId}:${entryNumber}`,
+        artifact_id: artifactId,
+        entry_number: entryNumber,
+        record: overlay.record,
+        source,
+        detail_availability: complete ? "full" : "summary",
+        compatibility,
+        provenance: {
+            archive: {
+                path: archivePath,
+                available: archiveRecord !== undefined,
+                verified: archiveRecord !== undefined,
+                ...(archiveHash ? { record_sha256: archiveHash } : {}),
+            },
+            current_projection: {
+                path: current.path,
+                present: current.state !== "missing" && current.state !== "absent",
+                representation: current.state,
+            },
+            ...(artifactId === "decisions" && complete
+                ? { overlay: { path: overlay.path, applied: overlay.applied, fields: overlay.fields } }
+                : {}),
+        },
+    };
+}
+export function retrieveStateEntry(projectRoot, artifactId, entryNumber, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const artifacts = numberedArchiveArtifacts(sourceRoot);
+    if (!artifacts.includes(artifactId)) {
+        throw failure(2, "unsupported_artifact", `unsupported state artifact '${artifactId}'`, {
+            recovery: "Use a supported numbered state artifact and retry the direct get command.",
+            validValues: artifacts,
+        });
+    }
+    const contract = numberedArchiveContract(artifactId, sourceRoot);
+    let current;
+    try {
+        current = inspectCurrentProjection(projectRoot, artifactId, entryNumber, contract, sourceRoot);
+    }
+    catch (error) {
+        if (error instanceof StateRetrievalFailure)
+            throw error;
+        throw failure(1, "unsupported_state", `state authority could not read ${artifactId}:${entryNumber}: ${error.message}`, {
+            artifactId,
+            entryNumber,
+            recovery: "Use a state format supported by the storage authority, then retry the direct get command.",
+        });
+    }
+    const lookup = readNumberedArchiveEntry(projectRoot, artifactId, entryNumber, { sourceRoot });
+    if (lookup.rejection) {
+        const unsupported = lookup.rejection.class === "unsupported_artifact" ||
+            lookup.rejection.reason === "unsupported_artifact" ||
+            (lookup.rejection.reason === "invalid_envelope" && lookup.rejection.message.startsWith("schemaVersion must be"));
+        throw failure(1, unsupported ? "unsupported_state" : "corrupt", lookup.rejection.message, {
+            artifactId,
+            entryNumber,
+            recovery: unsupported
+                ? "Use a numbered archive schema supported by the storage authority, then retry the direct get command."
+                : "Preserve the affected archive bytes for diagnostics, repair the numbered record, then retry the direct get command.",
+            details: { archive_path: lookup.path, rejection: lookup.rejection.reason },
+        });
+    }
+    const archiveRecord = lookup.entry?.record;
+    if (!archiveRecord && current.state === "missing") {
+        throw failure(1, "not_found", `state ${artifactId}:${entryNumber} was not found in the current projection or numbered archive`, {
+            artifactId,
+            entryNumber,
+            recovery: "Use an existing stable ID or restore/publish this numbered record before retrying.",
+            details: { current_projection_path: current.path, archive_path: lookup.path },
+        });
+    }
+    if (!archiveRecord && current.state === "absent") {
+        throw failure(1, "not_found", `state ${artifactId}:${entryNumber} was not found in the current projection or numbered archive`, {
+            artifactId,
+            entryNumber,
+            recovery: "Use an existing stable ID or restore/publish this numbered record before retrying.",
+            details: { current_projection_path: current.path, archive_path: lookup.path },
+        });
+    }
+    if (archiveRecord && current.record && current.state === "full") {
+        try {
+            if (canonicalRecordJson(archiveRecord) !== canonicalRecordJson(current.record)) {
+                throw failure(1, "immutable_conflict", `state ${artifactId}:${entryNumber} differs between archive and current projection`, {
+                    artifactId,
+                    entryNumber,
+                    recovery: "Preserve the immutable archive bytes and reconcile the conflicting current record before retrying.",
+                    details: { current_projection_path: current.path, archive_path: lookup.path },
+                });
+            }
+        }
+        catch (error) {
+            if (error instanceof StateRetrievalFailure)
+                throw error;
+            throw failure(1, "corrupt", `state ${artifactId}:${entryNumber} could not be compared safely`, {
+                artifactId,
+                entryNumber,
+                recovery: "Preserve both records for diagnostics, repair their serialized state, then retry.",
+                details: { current_projection_path: current.path, archive_path: lookup.path },
+            });
+        }
+    }
+    return {
+        command: `state ${artifactId} get`,
+        status: "ok",
+        entry: compose(projectRoot, sourceRoot, artifactId, entryNumber, current, lookup.path, archiveRecord, lookup.entry?.recordSha256),
+    };
+}
+//# sourceMappingURL=directRetrieval.js.map

package/dist/state/directRetrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directRetrieval.js","sourceRoot":"","sources":["../../src/state/directRetrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GAGpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AA+BjG,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IACA;IAFlB,YACkB,IAAsB,EACtB,QAAe;QAE/B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHV,SAAI,GAAJ,IAAI,CAAkB;QACtB,aAAQ,GAAR,QAAQ,CAAO;IAGjC,CAAC;CACF;AAiCD,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,UAAU,GAAG,eAAe;IAC/C,OAAO,kBAAkB,UAAU,+BAA+B,CAAC;AACrE,CAAC;AAED,SAAS,YAAY,CAAC,UAAkB,EAAE,cAA6B,IAAI;IACzE,OAAO,kBAAkB,UAAU,iBAAiB,WAAW,IAAI,CAAC,gBAAgB,CAAC;AACvF,CAAC;AAED,SAAS,OAAO,CACd,QAAe,EACf,SAA4B,EAC5B,OAAe,EACf,OAMC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,OAAO,IAAI,qBAAqB,CAC9B;QACE,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,MAAM;QACd,KAAK,EAAE;YACL,KAAK,EAAE,SAAS;YAChB,OAAO;YACP,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC;YAC/B,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC;YAC9F,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD;KACF,EACD,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,WAAmB,EACnB,UAAkB,EAClB,WAAmB,EACnB,QAAiC,EACjC,UAAkB;IAElB,MAAM,cAAc,GAAG,0BAA0B,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACvF,IAAI,CAAC;QACH,sBAAsB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,UAAU,aAAa,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,UAAU,4BAA4B,EAAE;YAC7E,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,mGAAmG;YAC7G,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAG,KAAe,CAAC,OAAO,EAAE;SACpE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,cAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,cAAc,GAAG,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC1G,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,uBAAuB,UAAU,aAAa,EAAE;YAC1E,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,0HAA0H;YACpI,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAG,KAAe,CAAC,OAAO,EAAE;SACpE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;QAChE,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,UAAU,mCAAmC,EAAE;YACpF,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,6GAA6G;YACvH,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAiC,CAAC;IACtC,IAAI,CAAC;QACH,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,wBAAwB,UAAU,gBAAiB,KAAe,CAAC,OAAO,EAAE,EAAE;YACxG,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,sGAAsG;YAChH,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,UAAU,+BAA+B,QAAQ,CAAC,eAAe,cAAc,EAAE;YACtH,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,2GAA2G;YACrH,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,CAAC,eAAe,EAAE;SACxE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,cAAsC,CAAC;IAC3C,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;YAAE,SAAS;QACpC,IAAI,iBAAiB,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,WAAW;YAAE,SAAS;QAClG,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,UAAU,2CAA2C,UAAU,IAAI,WAAW,EAAE,EAAE;gBACzH,UAAU;gBACV,WAAW;gBACX,QAAQ,EAAE,oHAAoH;gBAC9H,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,CAAC,eAAe,EAAE;aACxE,CAAC,CAAC;QACL,CAAC;QACD,cAAc,GAAG,SAAS,CAAC;IAC7B,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;YAC/E,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACnD,QAAQ,EAAE,cAAc,CAAC,cAAc,EAAE,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,IAAI;gBACpF,MAAM,EAAE,cAAc;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,CAAC,EAAE,mBAAmB,EAAE,WAAW,UAAU,uCAAwC,KAAe,CAAC,OAAO,EAAE,EAAE;gBAC5H,UAAU;gBACV,WAAW;gBACX,QAAQ,EAAE,mGAAmG;gBAC7G,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;aAClC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,IAAI,iBAAiB,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,WAAW;gBAAE,SAAS;YAClG,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,IAAI;gBAC/E,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;aAClE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CACjB,WAAmB,EACnB,UAAkB,EAClB,UAAkB,EAClB,WAAmB,EACnB,MAAkB;IAElB,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACxF,MAAM,QAAQ,GAA4B,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,iCAAkC,KAAe,CAAC,OAAO,EAAE,EAAE;YACvF,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,oGAAoG;YAC9G,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,aAAa,WAAW,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,QAAQ;QACrB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACrC,IAAI,KAAK,GAAY,QAAQ,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACpC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,KAAK,KAAK,SAAS,CAAC;QAC7B,CAAC,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpE,OAAO;QACL,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;QAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;QAC1B,MAAM;QACN,IAAI,EAAE,WAAW;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CACd,WAAmB,EACnB,UAAkB,EAClB,UAAkB,EAClB,WAAmB,EACnB,OAA0B,EAC1B,WAAmB,EACnB,aAAqC,EACrC,WAA+B;IAE/B,MAAM,MAAM,GAAG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,UAAU,IAAI,WAAW,mCAAmC,EAAE;YACpG,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,sHAAsH;YAChI,OAAO,EAAE,EAAE,uBAAuB,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,CAAC,KAAK,EAAE;SACrH,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,6BAA6B,EAAE,CAAC;QACxG,MAAM,OAAO,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,UAAU,IAAI,WAAW,yDAAyD,EAAE;YAC1H,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,sHAAsH;YAChI,OAAO,EAAE,EAAE,uBAAuB,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,CAAC,KAAK,EAAE;SACrH,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC;IACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACnJ,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1G,MAAM,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9D,OAAO;QACL,SAAS,EAAE,GAAG,UAAU,IAAI,WAAW,EAAE;QACzC,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,WAAW;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM;QACN,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAClD,aAAa;QACb,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,aAAa,KAAK,SAAS;gBACtC,QAAQ,EAAE,aAAa,KAAK,SAAS;gBACrC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAClE,cAAc,EAAE,OAAO,CAAC,KAAK;aAC9B;YACD,GAAG,CAAC,UAAU,KAAK,WAAW,IAAI,QAAQ;gBACxC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE;gBACvF,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,UAAkB,EAClB,WAAmB,EACnB,UAAmC,EAAE;IAErC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,CAAC,CAAC,EAAE,sBAAsB,EAAE,+BAA+B,UAAU,GAAG,EAAE;YACrF,QAAQ,EAAE,2EAA2E;YACrF,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,OAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB;YAAE,MAAM,KAAK,CAAC;QACxD,MAAM,OAAO,CAAC,CAAC,EAAE,mBAAmB,EAAE,kCAAkC,UAAU,IAAI,WAAW,KAAM,KAAe,CAAC,OAAO,EAAE,EAAE;YAChI,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,2FAA2F;SACtG,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9F,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,WAAW,GACf,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,sBAAsB;YACjD,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,sBAAsB;YAClD,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,kBAAkB,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACnH,MAAM,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE;YACxF,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,WAAW;gBACnB,CAAC,CAAC,sGAAsG;gBACxG,CAAC,CAAC,qHAAqH;YACzH,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;SAC3E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IAC3C,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClD,MAAM,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,UAAU,IAAI,WAAW,8DAA8D,EAAE;YAC9H,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,oFAAoF;YAC9F,OAAO,EAAE,EAAE,uBAAuB,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE;SAC9E,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,UAAU,IAAI,WAAW,8DAA8D,EAAE;YAC9H,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,oFAAoF;YAC9F,OAAO,EAAE,EAAE,uBAAuB,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE;SAC9E,CAAC,CAAC;IACL,CAAC;IACD,IAAI,aAAa,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAChE,IAAI,CAAC;YACH,IAAI,mBAAmB,CAAC,aAAa,CAAC,KAAK,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/E,MAAM,OAAO,CAAC,CAAC,EAAE,oBAAoB,EAAE,SAAS,UAAU,IAAI,WAAW,iDAAiD,EAAE;oBAC1H,UAAU;oBACV,WAAW;oBACX,QAAQ,EAAE,oGAAoG;oBAC9G,OAAO,EAAE,EAAE,uBAAuB,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE;iBAC9E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,qBAAqB;gBAAE,MAAM,KAAK,CAAC;YACxD,MAAM,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,UAAU,IAAI,WAAW,+BAA+B,EAAE;gBAC7F,UAAU;gBACV,WAAW;gBACX,QAAQ,EAAE,mFAAmF;gBAC7F,OAAO,EAAE,EAAE,uBAAuB,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,SAAS,UAAU,MAAM;QAClC,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,OAAO,CACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,OAAO,EACP,MAAM,CAAC,IAAI,EACX,aAAa,EACb,MAAM,CAAC,KAAK,EAAE,YAAY,CAC3B;KACF,CAAC;AACJ,CAAC"}