agentera 3.0.0-dev.4 → 3.0.0-dev.41

package/dist/state/durability.js

@@ -0,0 +1,325 @@
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { resolvePath } from "../core/paths.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { stateDurabilityContract, } from "./archiveDiscovery.js";
+import { canonicalEntityEnvelope, discoverEntities, entityBoundariesForArtifact } from "./entityStorage.js";
+import { validateRealProjectRoot } from "./projectRoot.js";
+import { readProjectFileSnapshot } from "./safeProjectFile.js";
+const GIT_TIMEOUT_MS = 1_000;
+const GIT_MAX_BUFFER = 2 * 1024 * 1024;
+const REFLOG_LIMIT = "32";
+function defaultGitRunner(args, cwd) {
+    const result = spawnSync("git", args, {
+        cwd,
+        encoding: "utf8",
+        timeout: GIT_TIMEOUT_MS,
+        maxBuffer: GIT_MAX_BUFFER,
+        shell: false,
+        windowsHide: true,
+    });
+    return {
+        status: result.status,
+        stdout: typeof result.stdout === "string" ? result.stdout : "",
+        timedOut: result.error?.code === "ETIMEDOUT" || result.signal === "SIGTERM",
+        ...(result.error?.code
+            ? { error: result.error.code }
+            : {}),
+    };
+}
+function successful(result) {
+    return result.status === 0 && !result.timedOut && !result.error;
+}
+function probeFailure(result, fallback) {
+    if (result.timedOut)
+        return "git_probe_timeout";
+    if (result.error || result.status === null)
+        return "git_probe_error";
+    return fallback;
+}
+function commandOutput(run, args, cwd) {
+    const result = run(args, cwd);
+    if (successful(result) && result.stdout.trim())
+        return { value: result.stdout.trim(), reason: "available" };
+    return { reason: probeFailure(result, "git_probe_error") };
+}
+function hasGitMetadata(projectRoot) {
+    let current = path.resolve(projectRoot);
+    for (;;) {
+        try {
+            fs.lstatSync(path.join(current, ".git"));
+            return true;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                return true;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return false;
+        current = parent;
+    }
+}
+function readHead(run, root) {
+    const result = run(["rev-parse", "--verify", "HEAD^{commit}"], root);
+    if (successful(result) && result.stdout.trim())
+        return { value: result.stdout.trim(), reason: "stable" };
+    return { reason: probeFailure(result, "missing_commit") };
+}
+function gitContext(projectRoot, run) {
+    if (!hasGitMetadata(projectRoot)) {
+        return { available: false, reason: "non_git", beforeReason: "non_git", shallow: false, run };
+    }
+    const inside = commandOutput(run, ["rev-parse", "--is-inside-work-tree"], projectRoot);
+    if (!inside.value || inside.value !== "true") {
+        const reason = inside.value ? "git_unavailable" : inside.reason;
+        return {
+            available: false,
+            reason,
+            beforeReason: reason,
+            shallow: false,
+            run,
+        };
+    }
+    const rootValue = commandOutput(run, ["rev-parse", "--show-toplevel"], projectRoot);
+    if (!rootValue.value) {
+        return {
+            available: false,
+            reason: rootValue.reason,
+            beforeReason: rootValue.reason,
+            shallow: false,
+            run,
+        };
+    }
+    const root = resolvePath(rootValue.value);
+    const beforeProbe = readHead(run, root);
+    const shallowProbe = commandOutput(run, ["rev-parse", "--is-shallow-repository"], root);
+    const probeIssue = shallowProbe.reason === "available" ? undefined : shallowProbe.reason;
+    return {
+        available: true,
+        reason: beforeProbe.value ? "available" : beforeProbe.reason,
+        root,
+        ...(beforeProbe.value ? { before: beforeProbe.value } : {}),
+        beforeReason: beforeProbe.reason,
+        ...(probeIssue ? { probeIssue } : {}),
+        shallow: shallowProbe.value === "true",
+        run,
+    };
+}
+function gitRelativePath(target, root) {
+    const relative = path.relative(root, target);
+    if (!relative || relative.startsWith(".." + path.sep) || path.isAbsolute(relative))
+        return undefined;
+    return relative.split(path.sep).join("/");
+}
+function statusForPath(context, relative) {
+    if (!context.root)
+        return undefined;
+    const result = context.run(["status", "--porcelain=v1", "--untracked-files=all", "--", relative], context.root);
+    return successful(result) ? result.stdout.trim() : undefined;
+}
+function blobAtHead(context, relative, head) {
+    if (!context.root)
+        return undefined;
+    const result = context.run(["cat-file", "-p", `${head}:${relative}`], context.root);
+    return successful(result) ? result.stdout : undefined;
+}
+function historyWasRewritten(context, relative, bytes, head) {
+    if (!context.root)
+        return false;
+    const reflog = context.run(["reflog", "show", `--format=%H%x09%gs`, "--max-count", REFLOG_LIMIT, "HEAD"], context.root);
+    if (!successful(reflog))
+        return false;
+    for (const line of reflog.stdout.split(/\r?\n/)) {
+        const match = /^([0-9a-f]{40})\t/.exec(line);
+        if (!match || match[1] === head)
+            continue;
+        const prior = blobAtHead(context, relative, match[1]);
+        if (prior !== bytes)
+            continue;
+        const ancestor = context.run(["merge-base", "--is-ancestor", match[1], head], context.root);
+        if (ancestor.status === 1 && !ancestor.timedOut)
+            return true;
+    }
+    return false;
+}
+function entryStatus(local, git) {
+    if (local === "verified" && (git.status === "verified" || git.reason === "non_git"))
+        return "complete";
+    if (local === "unavailable" && git.status === "unavailable")
+        return "unavailable";
+    if (local === "corrupt" && git.status === "unavailable")
+        return "unavailable";
+    return "degraded";
+}
+function buildGitEvidence(candidate, context, afterHead, headChanged) {
+    if (!context.available) {
+        return { status: "unavailable", reason: context.reason, reachableRecovery: false };
+    }
+    if (context.probeIssue) {
+        return { status: "unavailable", reason: context.probeIssue, reachableRecovery: false };
+    }
+    if (!context.before || !afterHead) {
+        return { status: "unavailable", reason: context.beforeReason, reachableRecovery: false };
+    }
+    if (headChanged)
+        return { status: "degraded", reason: "changed_head", reachableRecovery: false };
+    const relative = context.root ? gitRelativePath(candidate.path, context.root) : undefined;
+    if (!relative)
+        return { status: "unavailable", reason: "project_boundary", reachableRecovery: false };
+    const workingTreeStatus = statusForPath(context, relative);
+    if (workingTreeStatus === undefined) {
+        return { status: "unavailable", reason: "git_unavailable", reachableRecovery: false };
+    }
+    const committedBytes = blobAtHead(context, relative, context.before);
+    const reachable = committedBytes !== undefined;
+    if (candidate.local !== "unavailable" && candidate.bytes !== undefined && committedBytes === candidate.bytes) {
+        if (workingTreeStatus !== "") {
+            return { status: "degraded", reason: "dirty_archive", reachableRecovery: true };
+        }
+        if (context.shallow)
+            return { status: "degraded", reason: "shallow_history", reachableRecovery: true };
+        return { status: "verified", reason: "reachable_head", reachableRecovery: true };
+    }
+    if (candidate.local === "unavailable" && reachable) {
+        return { status: "verified", reason: "reachable_head", reachableRecovery: true };
+    }
+    if (candidate.local === "corrupt") {
+        return { status: "unavailable", reason: reachable ? "committed_content_mismatch" : "not_committed", reachableRecovery: reachable };
+    }
+    if (candidate.bytes !== undefined &&
+        historyWasRewritten(context, relative, candidate.bytes, context.before)) {
+        return { status: "degraded", reason: "history_rewritten", reachableRecovery: false };
+    }
+    if (context.shallow)
+        return { status: "degraded", reason: "shallow_history", reachableRecovery: reachable };
+    if (workingTreeStatus !== "")
+        return { status: "degraded", reason: "dirty_archive", reachableRecovery: reachable };
+    return { status: "unavailable", reason: reachable ? "committed_content_mismatch" : "not_committed", reachableRecovery: reachable };
+}
+function inspectEntityDurability(projectRoot, artifact, id, contract, run, sourceRoot) {
+    const entityCommand = "agentera check durability --project PATH --artifact ARTIFACT --id ID --format json";
+    const git = gitContext(projectRoot, run);
+    const discovery = discoverEntities(projectRoot, sourceRoot);
+    const boundaries = entityBoundariesForArtifact(artifact, sourceRoot);
+    const relativeTargets = boundaries.map((boundary) => `.agentera/entities/${artifact}/${boundary}/${id}.yaml`);
+    const targetPaths = new Set(relativeTargets.map((relative) => path.join(projectRoot, ...relative.split("/"))));
+    const matches = discovery.entities.filter((entity) => targetPaths.has(entity.path));
+    const canonical = matches.length === 1 && matches[0].classification === "valid" ? matches[0] : undefined;
+    let local = canonical ? "verified" : matches.length ? "corrupt" : "unavailable";
+    let bytes;
+    let localMessage;
+    const sourceBoundMalformed = matches.length === 1
+        && matches[0].classification === "malformed"
+        && (matches[0].migrationProvenance !== null || matches[0].record?.migration_provenance !== undefined)
+        ? matches[0]
+        : undefined;
+    const readableMatch = canonical ?? sourceBoundMalformed;
+    if (readableMatch) {
+        try {
+            const snapshot = readProjectFileSnapshot(validateRealProjectRoot(projectRoot), readableMatch.relativePath);
+            if (snapshot.kind === "file")
+                bytes = snapshot.bytes.toString("utf8");
+            else
+                throw new Error(snapshot.kind === "missing" ? "entity disappeared" : `unsafe entity path (${snapshot.reason})`);
+        }
+        catch (error) {
+            local = "corrupt";
+            localMessage = `cannot read canonical entity: ${error.message}`;
+        }
+    }
+    if (matches.length > 1)
+        localMessage = `entity ID '${id}' has conflicting ownership for artifact '${artifact}'`;
+    else if (!canonical && matches.length === 1 && !localMessage)
+        localMessage = `entity '${matches[0].relativePath}' is not canonical`;
+    let committedPath;
+    let committedFailure;
+    if (git.available && git.root && git.before) {
+        const projectPrefix = path.relative(git.root, projectRoot).split(path.sep).join("/");
+        const valid = [];
+        let invalid = 0;
+        for (let index = 0; index < relativeTargets.length; index += 1) {
+            const relative = `${projectPrefix ? `${projectPrefix}/` : ""}${relativeTargets[index]}`;
+            const committed = blobAtHead(git, relative, git.before);
+            if (committed === undefined)
+                continue;
+            try {
+                canonicalEntityEnvelope(committed, { artifact, boundary: boundaries[index], id }, sourceRoot, {
+                    kind: "git_commit",
+                    commit: git.before,
+                    readSource: (sourcePath) => blobAtHead(git, `${projectPrefix ? `${projectPrefix}/` : ""}${sourcePath}`, git.before),
+                });
+                valid.push(relative);
+            }
+            catch {
+                invalid += 1;
+            }
+        }
+        if (valid.length === 1 && invalid === 0)
+            committedPath = path.join(git.root, ...valid[0].split("/"));
+        else if (valid.length > 1)
+            committedFailure = "committed_entity_conflict";
+        else if (invalid > 0)
+            committedFailure = "committed_entity_invalid";
+    }
+    const target = canonical?.path ?? matches[0]?.path ?? committedPath ?? [...targetPaths][0] ?? path.join(projectRoot, ".agentera", "entities", artifact, `${id}.yaml`);
+    const candidate = { path: target, stableId: id, artifactId: artifact, entryNumber: 0, local, ...(bytes !== undefined ? { bytes } : {}), ...(localMessage ? { localMessage } : {}) };
+    let evidence = committedFailure
+        ? { status: "unavailable", reason: committedFailure, reachableRecovery: false }
+        : buildGitEvidence(candidate, git, git.before, false);
+    const ending = git.available && git.root ? readHead(run, git.root) : undefined;
+    const after = ending?.value;
+    const changed = Boolean(git.before && after && git.before !== after);
+    if (git.available && git.before && !after)
+        evidence = { status: "degraded", reason: "final_head_unavailable", reachableRecovery: false };
+    else if (changed)
+        evidence = { status: "degraded", reason: "changed_head", reachableRecovery: false };
+    const status = entryStatus(local, evidence);
+    const get = artifact === "plan" ? `agentera state plan get --id ${id} --format json` : `agentera state ${artifact} get --id ${id} --format json`;
+    const diagnostics = [];
+    if (local !== "verified")
+        diagnostics.push({ class: local === "corrupt" ? "canonical_entity_corrupt" : "canonical_entity_missing", message: localMessage ?? `canonical ${artifact} entity '${id}' was not found`, recovery: `Run agentera check validate state, then recover exact detail with '${get}'; no state was changed.` });
+    if (evidence.status !== "verified")
+        diagnostics.push({ class: evidence.reason, message: `${artifact} entity '${id}' has no verified committed recovery (${evidence.reason})`, recovery: `Use '${get}' for local recovery and do not require Git for state writes.` });
+    return {
+        command: entityCommand,
+        status,
+        project: projectRoot,
+        read_only: true,
+        remote_contact: false,
+        head: { status: !git.available || !git.before || !after ? "unavailable" : changed ? "changed" : "stable" },
+        counts: { discovered: matches.length, returned: 1, local_verified: local === "verified" ? 1 : 0, local_unavailable: local === "unavailable" ? 1 : 0, local_corrupt: local === "corrupt" ? 1 : 0, reachable_recovery: evidence.reachableRecovery ? 1 : 0 },
+        entries: [{ id, artifact, status, local: { status: local, detail_availability: local === "verified" ? "full" : "unavailable", path: path.relative(projectRoot, target).split(path.sep).join("/"), ...(localMessage ? { message: localMessage } : {}) }, git: { status: evidence.status, reason: evidence.reason, reachable_recovery: evidence.reachableRecovery }, retrieval: { get } }],
+        diagnostics: diagnostics.sort((a, b) => a.class.localeCompare(b.class)),
+        source_contract: { syntax: entityCommand, status_values: contract.statusValues, local_values: contract.localValues, git_values: contract.gitValues, read_only: true, remote_contact: false, writes_independent: true },
+    };
+}
+export function inspectDurability(project, args = {}, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const contract = stateDurabilityContract(sourceRoot);
+    const projectRoot = resolvePath(project);
+    const run = options.runGit ?? defaultGitRunner;
+    if (!args.artifact || !args.id)
+        throw new Error("entity-mode durability requires --artifact ARTIFACT --id ID");
+    return inspectEntityDurability(projectRoot, args.artifact, args.id, contract, run, sourceRoot);
+}
+export function renderDurabilityText(response, out) {
+    out(`status=${response.status} | project=${response.project} | head=${response.head.status}\n`);
+    out(`counts=discovered:${response.counts.discovered} returned:${response.counts.returned} ` +
+        `local_verified:${response.counts.local_verified} local_unavailable:${response.counts.local_unavailable} ` +
+        `local_corrupt:${response.counts.local_corrupt} reachable_recovery:${response.counts.reachable_recovery}\n`);
+    for (const entry of response.entries) {
+        const identity = "id" in entry ? `${entry.artifact}:${entry.id}` : entry.stable_id;
+        out(`- ${identity} | status=${entry.status} | local=${entry.local.status} ` +
+            `| git=${entry.git.status} | reason=${entry.git.reason} | ` +
+            `reachable_recovery=${entry.git.reachable_recovery}\n`);
+    }
+    for (const diagnostic of response.diagnostics) {
+        out(`diagnostic=${diagnostic.class} | ${diagnostic.message}\n`);
+    }
+}
+export function durabilityAuthority(sourceRoot) {
+    return stateDurabilityContract(sourceRoot);
+}
+//# sourceMappingURL=durability.js.map

package/dist/state/durability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durability.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/durability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,uBAAuB,GAExB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACvC,MAAM,YAAY,GAAG,IAAI,CAAC;AAyH1B,SAAS,gBAAgB,CAAC,IAAc,EAAE,GAAW;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE;QACpC,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,cAAc;QACzB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9D,QAAQ,EAAG,MAAM,CAAC,KAA2C,EAAE,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAClH,GAAG,CAAE,MAAM,CAAC,KAA2C,EAAE,IAAI;YAC3D,CAAC,CAAC,EAAE,KAAK,EAAG,MAAM,CAAC,KAA+B,CAAC,IAAI,EAAE;YACzD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAwB;IAC1C,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,MAAwB,EAAE,QAAgB;IAC9D,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IAChD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,iBAAiB,CAAC;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CACpB,GAAqB,EACrB,IAAc,EACd,GAAW;IAEX,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC5G,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;QACtE,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAqB,EAAE,IAAY;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACzG,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB,EAAE,GAAqB;IAC5D,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,WAAW,CAAC,CAAC;IACvF,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAChE,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM;YACN,YAAY,EAAE,MAAM;YACpB,OAAO,EAAE,KAAK;YACd,GAAG;SACJ,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,WAAW,CAAC,CAAC;IACpF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,YAAY,EAAE,SAAS,CAAC,MAAM;YAC9B,OAAO,EAAE,KAAK;YACd,GAAG;SACJ,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,yBAAyB,CAAC,EAAE,IAAI,CAAC,CAAC;IACxF,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;IACzF,OAAO;QACL,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM;QAC5D,IAAI;QACJ,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,YAAY,EAAE,WAAW,CAAC,MAAM;QAChC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,YAAY,CAAC,KAAK,KAAK,MAAM;QACtC,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,IAAY;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACrG,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,aAAa,CAAC,OAAmB,EAAE,QAAgB;IAC1D,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CACxB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,CAAC,EACrE,OAAO,CAAC,IAAI,CACb,CAAC;IACF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED,SAAS,UAAU,CAAC,OAAmB,EAAE,QAAgB,EAAE,IAAY;IACrE,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAAmB,EACnB,QAAgB,EAChB,KAAa,EACb,IAAY;IAEZ,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CACxB,CAAC,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,EAC7E,OAAO,CAAC,IAAI,CACb,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,SAAS;QAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAA4B,EAAE,GAAgB;IACjE,IAAI,KAAK,KAAK,UAAU,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IACvG,IAAI,KAAK,KAAK,aAAa,IAAI,GAAG,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAClF,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAC9E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAoB,EACpB,OAAmB,EACnB,SAA6B,EAC7B,WAAoB;IAEpB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IAC3F,CAAC;IACD,IAAI,WAAW;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACjG,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACtG,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3D,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,cAAc,KAAK,SAAS,CAAC;IAC/C,IAAI,SAAS,CAAC,KAAK,KAAK,aAAa,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7G,IAAI,iBAAiB,KAAK,EAAE,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAClF,CAAC;QACD,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QACvG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,aAAa,IAAI,SAAS,EAAE,CAAC;QACnD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;IACrI,CAAC;IACD,IACE,SAAS,CAAC,KAAK,KAAK,SAAS;QAC7B,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EACvE,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;IAC5G,IAAI,iBAAiB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;IACnH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACrI,CAAC;AAED,SAAS,uBAAuB,CAC9B,WAAmB,EACnB,QAAgB,EAChB,EAAU,EACV,QAAiC,EACjC,GAAqB,EACrB,UAAkB;IAElB,MAAM,aAAa,GAAG,oFAAoF,CAAC;IAC3G,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,2BAA2B,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,sBAAsB,QAAQ,IAAI,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9G,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/G,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzG,IAAI,KAAK,GAA0B,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IACvG,IAAI,KAAyB,CAAC;IAC9B,IAAI,YAAgC,CAAC;IACrC,MAAM,oBAAoB,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC;WAC5C,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,KAAK,WAAW;WACzC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,oBAAoB,KAAK,SAAS,CAAC;QACrG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACZ,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,aAAa,GAAG,SAAS,IAAI,oBAAoB,CAAC;IACxD,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;YAC3G,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;gBAAE,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;;gBACjE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,uBAAuB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACvH,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YAAC,KAAK,GAAG,SAAS,CAAC;YAAC,YAAY,GAAG,iCAAkC,KAAe,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IAClH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,YAAY,GAAG,cAAc,EAAE,6CAA6C,QAAQ,GAAG,CAAC;SAC3G,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY;QAAE,YAAY,GAAG,WAAW,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,oBAAoB,CAAC;IACpI,IAAI,aAAiC,CAAC;IACtC,IAAI,gBAAoC,CAAC;IACzC,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YACxF,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,SAAS,KAAK,SAAS;gBAAE,SAAS;YACtC,IAAI,CAAC;gBACH,uBAAuB,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE;oBAC5F,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,EAAE,GAAG,CAAC,MAAO,CAAC;iBACrH,CAAC,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;YACD,MAAM,CAAC;gBAAC,OAAO,IAAI,CAAC,CAAC;YAAC,CAAC;QACzB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC;YAAE,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;aAChG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,gBAAgB,GAAG,2BAA2B,CAAC;aACrE,IAAI,OAAO,GAAG,CAAC;YAAE,gBAAgB,GAAG,0BAA0B,CAAC;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,EAAE,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,aAAa,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACtK,MAAM,SAAS,GAAc,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/L,IAAI,QAAQ,GAAG,gBAAgB;QAC7B,CAAC,CAAC,EAAE,MAAM,EAAE,aAAsB,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,KAAK,EAAE;QACxF,CAAC,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;IACrE,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK;QAAE,QAAQ,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;SACpI,IAAI,OAAO;QAAE,QAAQ,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACtG,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,gCAAgC,EAAE,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,QAAQ,aAAa,EAAE,gBAAgB,CAAC;IACjJ,MAAM,WAAW,GAAsC,EAAE,CAAC;IAC1D,IAAI,KAAK,KAAK,UAAU;QAAE,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,0BAA0B,EAAE,OAAO,EAAE,YAAY,IAAI,aAAa,QAAQ,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,sEAAsE,GAAG,0BAA0B,EAAE,CAAC,CAAC;IACnU,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;QAAE,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,YAAY,EAAE,yCAAyC,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,+DAA+D,EAAE,CAAC,CAAC;IACtQ,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,MAAM;QACN,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,KAAK;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC1G,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QACzP,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;QACxX,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvE,eAAe,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE;KACvN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,OAAmD,EAAE,EACrD,UAA6B,EAAE;IAE/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC/G,OAAO,uBAAuB,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA4B,EAAE,GAA2B;IAC5F,GAAG,CAAC,UAAU,QAAQ,CAAC,MAAM,cAAc,QAAQ,CAAC,OAAO,WAAW,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChG,GAAG,CACD,qBAAqB,QAAQ,CAAC,MAAM,CAAC,UAAU,aAAa,QAAQ,CAAC,MAAM,CAAC,QAAQ,GAAG;QACrF,kBAAkB,QAAQ,CAAC,MAAM,CAAC,cAAc,sBAAsB,QAAQ,CAAC,MAAM,CAAC,iBAAiB,GAAG;QAC1G,iBAAiB,QAAQ,CAAC,MAAM,CAAC,aAAa,uBAAuB,QAAQ,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAC9G,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;QACnF,GAAG,CACD,KAAK,QAAQ,aAAa,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG;YACrE,SAAS,KAAK,CAAC,GAAG,CAAC,MAAM,aAAa,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK;YAC3D,sBAAsB,KAAK,CAAC,GAAG,CAAC,kBAAkB,IAAI,CACzD,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC9C,GAAG,CAAC,cAAc,UAAU,CAAC,KAAK,MAAM,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC"}

package/dist/state/entityCutover.js

@@ -0,0 +1,294 @@
+import { createHash, randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { dumpYamlMapping, loadYamlMapping } from "../core/yaml.js";
+import { canonicalRecordJson } from "./archiveDiscovery.js";
+import { verifyEntityCutoverGitSource } from "./entityCutoverGit.js";
+import { canonicalEntityEnvelopeBytes, validateEntityState } from "./entityStorage.js";
+import { planEntityMigration, validateEntityMigrationTargets } from "./entityMigrationPreview.js";
+import { loadLegacyEntityCutoverTargets } from "./legacyEntityCutoverEvidence.js";
+import { validateRealProjectRoot } from "./projectRoot.js";
+import { readProjectFileSnapshot } from "./safeProjectFile.js";
+import { acquireWriterLock } from "./write/lock.js";
+export const MIGRATION_ROOT = ".agentera/migrations/entities";
+export const FORWARD_MANIFEST = `${MIGRATION_ROOT}/forward.yaml`;
+export const ENTITY_MODE_MARKER = ".agentera/state-mode.yaml";
+const MANIFEST_SCHEMA = "agentera.entityCutoverManifest.v1";
+const SHA256 = /^[a-f0-9]{64}$/;
+export class EntityCutoverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EntityCutoverError";
+    }
+}
+function hash(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function exactKeys(value, expected) {
+    return canonicalRecordJson(Object.keys(value).sort()) === canonicalRecordJson([...expected].sort());
+}
+function safeTarget(value) {
+    return value.startsWith(".agentera/entities/")
+        && !path.isAbsolute(value)
+        && !value.includes("\\")
+        && value.split("/").every((part) => part !== "" && part !== "." && part !== "..");
+}
+function markerSnapshot(project) {
+    return readProjectFileSnapshot(validateRealProjectRoot(project), ENTITY_MODE_MARKER);
+}
+function parseHistoricalForwardManifest(bytes) {
+    const value = loadYamlMapping(bytes.toString("utf8"));
+    if (!exactKeys(value, ["schemaVersion", "phase", "source", "targets", "marker"])
+        || value.schemaVersion !== MANIFEST_SCHEMA
+        || value.phase !== "entities_published"
+        || !mapping(value.marker)
+        || value.marker.path !== ENTITY_MODE_MARKER
+        || typeof value.marker.sha256 !== "string"
+        || !SHA256.test(value.marker.sha256)
+        || !Array.isArray(value.targets)) {
+        throw new EntityCutoverError(`historical cutover manifest '${FORWARD_MANIFEST}' is invalid`);
+    }
+    const targets = value.targets.map((raw) => {
+        if (!mapping(raw) || !exactKeys(raw, ["path", "sha256"]) || typeof raw.path !== "string" || !safeTarget(raw.path) || typeof raw.sha256 !== "string" || !SHA256.test(raw.sha256)) {
+            throw new EntityCutoverError(`historical cutover manifest '${FORWARD_MANIFEST}' has an invalid target`);
+        }
+        return { path: raw.path, sha256: raw.sha256 };
+    });
+    return { schemaVersion: MANIFEST_SCHEMA, phase: "entities_published", targets, marker: value.marker };
+}
+function loadHistoricalForwardManifest(project) {
+    const observed = readProjectFileSnapshot(validateRealProjectRoot(project), FORWARD_MANIFEST);
+    if (observed.kind === "missing")
+        return null;
+    if (observed.kind !== "file")
+        throw new EntityCutoverError(`historical cutover manifest '${FORWARD_MANIFEST}' is unsafe`);
+    return parseHistoricalForwardManifest(observed.bytes);
+}
+function targetsForPlan(plan) {
+    const targets = plan.entries.map((entry) => {
+        const target = entry.proposed_target;
+        if (!target || typeof target.id !== "string" || typeof entry.artifact !== "string" || !safeTarget(target.path))
+            throw new EntityCutoverError(`first unresolved path '${entry.source_paths[0] ?? ".agentera"}': source has no safe canonical target`);
+        const bytes = canonicalEntityEnvelopeBytes({ id: target.id, artifact: entry.artifact, record: entry.record, migrationProvenance: entry.canonical_migration_provenance });
+        if (entry.target_sha256 !== hash(bytes))
+            throw new EntityCutoverError(`first unresolved path '${target.path}': converted entity bytes are not deterministic`);
+        return { path: target.path, sha256: hash(bytes) };
+    }).sort((a, b) => a.path.localeCompare(b.path));
+    if (new Set(targets.map(({ path: target }) => target)).size !== targets.length)
+        throw new EntityCutoverError("first unresolved path '.agentera/entities': converted target paths are not unique");
+    return targets;
+}
+function assertPlanReady(plan, sourceRoot) {
+    const blocker = plan.diagnostics[0];
+    if (plan.counts.blockers > 0)
+        throw new EntityCutoverError(`first unresolved path '${blocker?.path ?? ".agentera"}': ${blocker?.message ?? `${plan.counts.blockers} migration blocker(s)`}`);
+    const invalid = validateEntityMigrationTargets(plan.project, plan.entries, sourceRoot)[0];
+    if (invalid)
+        throw new EntityCutoverError(`first unresolved path '${invalid.path}': ${invalid.message}`);
+}
+function listFiles(project, relativeRoot) {
+    const absoluteRoot = path.join(project, relativeRoot);
+    if (!fs.existsSync(absoluteRoot))
+        return [];
+    const found = [];
+    const visit = (directory) => {
+        const stat = fs.lstatSync(directory);
+        if (!stat.isDirectory() || stat.isSymbolicLink() || fs.realpathSync(directory) !== directory)
+            throw new EntityCutoverError(`first unresolved path '${path.relative(project, directory)}': expected a real project directory`);
+        for (const entry of fs.readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+            const absolute = path.join(directory, entry.name);
+            const relative = path.relative(project, absolute).split(path.sep).join("/");
+            if (entry.isSymbolicLink())
+                throw new EntityCutoverError(`first unresolved path '${relative}': symbolic links are not import targets`);
+            if (entry.isDirectory())
+                visit(absolute);
+            else if (entry.isFile())
+                found.push(relative);
+            else
+                throw new EntityCutoverError(`first unresolved path '${relative}': expected a regular file`);
+        }
+    };
+    visit(absoluteRoot);
+    return found.sort();
+}
+function validateExistingTargets(project, targets) {
+    const expected = new Map(targets.map((target) => [target.path, target]));
+    for (const relative of listFiles(project, ".agentera/entities")) {
+        if (!expected.has(relative))
+            throw new EntityCutoverError(`first unresolved path '${relative}': entity is not part of the converted v2 input`);
+    }
+    for (const target of targets) {
+        const observed = readProjectFileSnapshot(validateRealProjectRoot(project), target.path);
+        if (observed.kind === "missing")
+            continue;
+        if (observed.kind !== "file" || hash(observed.bytes) !== target.sha256)
+            throw new EntityCutoverError(`first unresolved path '${target.path}': existing target is not an exact converted match`);
+    }
+}
+function validateActiveEntityCutover(project, markerBytes, sourceRoot) {
+    const result = validateEntityState(project, sourceRoot);
+    if (!result.valid || result.entityCount === 0)
+        throw new EntityCutoverError(`active entity state is invalid: ${result.entityCount === 0 ? "no canonical entities were published" : result.issues.map(({ message }) => message).join("; ")}`);
+    const targets = loadEntityCutoverTargetsForMarker(project, markerBytes);
+    const byPath = new Map(result.entities.map((entity) => [entity.relativePath, entity]));
+    for (const target of targets) {
+        const entity = byPath.get(target.path);
+        if (!entity || entity.classification !== "valid" || (target.id && entity.id !== target.id) || (target.artifact && entity.artifact !== target.artifact))
+            throw new EntityCutoverError(`active entity target '${target.path}' is missing or invalid`);
+    }
+    return result.entityCount;
+}
+export function loadEntityCutoverTargetsForMarker(projectRoot, bytes) {
+    const project = validateRealProjectRoot(projectRoot).path;
+    const marker = loadYamlMapping(bytes.toString("utf8"));
+    if (marker.schemaVersion !== "agentera.stateMode.v1" || marker.mode !== "entities")
+        throw new EntityCutoverError("state marker is not valid entity authority");
+    if (marker.cutover === undefined && marker.migration_id === undefined)
+        return [];
+    if (marker.cutover === "one_way_git") {
+        const manifest = loadHistoricalForwardManifest(project);
+        if (!manifest || manifest.marker.sha256 !== hash(bytes))
+            throw new EntityCutoverError("historical one-way entity marker has no matching completed manifest");
+        return manifest.targets;
+    }
+    if (typeof marker.migration_id === "string")
+        return loadLegacyEntityCutoverTargets(project, bytes);
+    throw new EntityCutoverError("entity marker has no supported cutover binding");
+}
+function inspect(projectRoot, sourceRoot, requireGit, writerLockHeld = false, activeUpgradeLockPaths = []) {
+    const project = validateRealProjectRoot(projectRoot).path;
+    const marker = markerSnapshot(project);
+    if (marker.kind === "file")
+        return { inspection: { phase: "active", entityCount: validateActiveEntityCutover(project, marker.bytes, sourceRoot) } };
+    if (marker.kind !== "missing")
+        throw new EntityCutoverError(`first unresolved path '${ENTITY_MODE_MARKER}': marker path is unsafe`);
+    const plan = planEntityMigration(project, sourceRoot);
+    assertPlanReady(plan, sourceRoot);
+    const targets = targetsForPlan(plan);
+    validateExistingTargets(project, targets);
+    let head;
+    if (requireGit) {
+        const allowedPaths = new Set([FORWARD_MANIFEST, ENTITY_MODE_MARKER, ...targets.map(({ path: target }) => target)]);
+        for (const activeLockPath of activeUpgradeLockPaths) {
+            const relative = path.relative(project, path.resolve(activeLockPath));
+            if (relative !== "" && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative))
+                allowedPaths.add(relative.split(path.sep).join("/"));
+        }
+        const binding = verifyEntityCutoverGitSource(project, plan, { paths: allowedPaths, prefixes: writerLockHeld ? [".agentera/.writer.lock"] : [] });
+        head = binding.head;
+    }
+    return { inspection: { phase: "ready", entityCount: targets.length }, plan, ...(head ? { head } : {}) };
+}
+export function inspectEntityCutoverForUpgrade(projectRoot, sourceRoot, requireGit = false, activeUpgradeLockPaths = []) {
+    return inspect(projectRoot, sourceRoot, requireGit, false, activeUpgradeLockPaths).inspection;
+}
+export function prepareEntityCutoverForUpgrade(projectRoot, sourceRoot, activeUpgradeLockPaths = []) {
+    const current = inspect(projectRoot, sourceRoot, true, false, activeUpgradeLockPaths);
+    if (current.inspection.phase === "active" || !current.plan || !current.head)
+        throw new EntityCutoverError("entity authority is already active; no cutover preparation is available");
+    return { project: current.plan.project, sourceRoot, head: current.head, sourceFingerprint: current.plan.source_fingerprint, previewDigest: current.plan.preview_digest };
+}
+function ensureDirectory(project, relativeDirectory) {
+    let current = project;
+    for (const segment of relativeDirectory.split("/").filter(Boolean)) {
+        current = path.join(current, segment);
+        if (!fs.existsSync(current))
+            fs.mkdirSync(current, { mode: 0o700 });
+        const stat = fs.lstatSync(current);
+        if (!stat.isDirectory() || stat.isSymbolicLink() || fs.realpathSync(current) !== current)
+            throw new EntityCutoverError(`first unresolved path '${path.relative(project, current)}': target directory is unsafe`);
+    }
+}
+function writeDurable(file, bytes) {
+    const fd = fs.openSync(file, fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL | (fs.constants.O_NOFOLLOW ?? 0), 0o600);
+    try {
+        fs.writeFileSync(fd, bytes);
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+function fault(phase) {
+    if (process.env.NODE_ENV === "test" && process.env.AGENTERA_FAULT_INJECT_ENTITY_MIGRATION_AFTER_PHASE === phase)
+        throw new EntityCutoverError(`simulated entity import interruption after ${phase}`);
+}
+function publishTargets(project, plan) {
+    for (const entry of plan.entries.slice().sort((a, b) => a.proposed_target.path.localeCompare(b.proposed_target.path))) {
+        const target = entry.proposed_target;
+        const bytes = canonicalEntityEnvelopeBytes({ id: target.id, artifact: entry.artifact, record: entry.record, migrationProvenance: entry.canonical_migration_provenance });
+        const observed = readProjectFileSnapshot(validateRealProjectRoot(project), target.path);
+        if (observed.kind === "file") {
+            if (hash(observed.bytes) !== hash(bytes))
+                throw new EntityCutoverError(`first unresolved path '${target.path}': existing target is not an exact converted match`);
+            continue;
+        }
+        if (observed.kind !== "missing")
+            throw new EntityCutoverError(`first unresolved path '${target.path}': target is unsafe`);
+        ensureDirectory(project, path.relative(project, path.dirname(path.join(project, target.path))).split(path.sep).join("/"));
+        try {
+            writeDurable(path.join(project, target.path), bytes);
+        }
+        catch (error) {
+            throw new EntityCutoverError(`first unresolved path '${target.path}': ${error.message}`);
+        }
+        fault("entity_published");
+    }
+}
+function publishMarker(project, plan) {
+    const markerBytes = dumpYamlMapping({ schemaVersion: "agentera.stateMode.v1", mode: "entities", source_fingerprint: plan.source_fingerprint, preview_digest: plan.preview_digest });
+    const existing = markerSnapshot(project);
+    if (existing.kind === "file") {
+        if (!existing.bytes.equals(Buffer.from(markerBytes)))
+            throw new EntityCutoverError(`first unresolved path '${ENTITY_MODE_MARKER}': marker has unexpected bytes`);
+        return;
+    }
+    if (existing.kind !== "missing")
+        throw new EntityCutoverError(`first unresolved path '${ENTITY_MODE_MARKER}': marker path is unsafe`);
+    ensureDirectory(project, ".agentera");
+    const temporary = path.join(project, `.agentera/.state-mode-${randomUUID()}.tmp`);
+    try {
+        writeDurable(temporary, markerBytes);
+        fault("before_marker");
+        if (fs.existsSync(path.join(project, ENTITY_MODE_MARKER)))
+            throw new EntityCutoverError(`first unresolved path '${ENTITY_MODE_MARKER}': marker appeared during publication`);
+        fs.renameSync(temporary, path.join(project, ENTITY_MODE_MARKER));
+    }
+    finally {
+        fs.rmSync(temporary, { force: true });
+    }
+}
+export function applyPreparedEntityCutover(prepared, activeUpgradeLockPaths = []) {
+    const before = inspect(prepared.project, prepared.sourceRoot, true, false, activeUpgradeLockPaths);
+    if (before.inspection.phase === "active")
+        return { status: "complete", phase: "active", idempotent: true, mutation_performed: false, entity_count: before.inspection.entityCount };
+    if (!before.plan || before.head !== prepared.head || before.plan.source_fingerprint !== prepared.sourceFingerprint || before.plan.preview_digest !== prepared.previewDigest)
+        throw new EntityCutoverError("first unresolved path '.agentera': converted input changed before apply");
+    const lock = acquireWriterLock(prepared.project, 2000);
+    try {
+        const current = inspect(prepared.project, prepared.sourceRoot, true, true, activeUpgradeLockPaths);
+        if (current.inspection.phase === "active")
+            return { status: "complete", phase: "active", idempotent: true, mutation_performed: false, entity_count: current.inspection.entityCount };
+        const plan = current.plan;
+        if (current.head !== prepared.head || plan.source_fingerprint !== prepared.sourceFingerprint || plan.preview_digest !== prepared.previewDigest)
+            throw new EntityCutoverError("first unresolved path '.agentera': converted input changed before its first effect");
+        publishTargets(prepared.project, plan);
+        const validation = validateEntityState(prepared.project, prepared.sourceRoot, { kind: "migration_preview", projectRoot: prepared.project });
+        if (!validation.valid || validation.entityCount !== plan.entries.length) {
+            const issue = validation.issues[0];
+            throw new EntityCutoverError(`first unresolved path '${issue?.path ?? ".agentera/entities"}': converted entity graph is invalid (${validation.entityCount}/${plan.entries.length})${issue ? `: ${issue.message}` : ""}`);
+        }
+        publishMarker(prepared.project, plan);
+        const marker = markerSnapshot(prepared.project);
+        if (marker.kind !== "file")
+            throw new EntityCutoverError(`first unresolved path '${ENTITY_MODE_MARKER}': marker was not published`);
+        return { status: "complete", phase: "active", idempotent: false, mutation_performed: true, entity_count: validateActiveEntityCutover(prepared.project, marker.bytes, prepared.sourceRoot) };
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=entityCutover.js.map