agentera 3.0.0-dev.22 → 3.0.0-dev.25

package/dist/state/entityCutover.js

@@ -0,0 +1,390 @@
+import { createHash, randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { dumpYamlMapping, loadYamlMapping } from "../core/yaml.js";
+import { writeFileAtomic } from "../upgrade/atomicWriter.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 MIGRATION_STAGING = `${MIGRATION_ROOT}/staging`;
+export const FORWARD_MANIFEST = `${MIGRATION_ROOT}/forward.yaml`;
+export const ENTITY_MODE_MARKER = ".agentera/state-mode.yaml";
+const STAGING_PROJECT = `${MIGRATION_STAGING}/project`;
+const MANIFEST_SCHEMA = "agentera.entityCutoverManifest.v1";
+const MARKER_BYTES = dumpYamlMapping({ schemaVersion: "agentera.stateMode.v1", mode: "entities", cutover: "one_way_git" });
+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 manifestBytes(manifest) {
+    return dumpYamlMapping(manifest);
+}
+function parseForwardManifest(bytes) {
+    const value = loadYamlMapping(bytes.toString("utf8"));
+    if (!exactKeys(value, ["schemaVersion", "phase", "source", "targets", "marker"])
+        || value.schemaVersion !== MANIFEST_SCHEMA
+        || !["publishing_entities", "entities_published"].includes(String(value.phase))
+        || !mapping(value.source)
+        || !exactKeys(value.source, ["head", "source_fingerprint", "preview_digest"])
+        || typeof value.source.head !== "string"
+        || !/^[a-f0-9]{40,64}$/.test(value.source.head)
+        || typeof value.source.source_fingerprint !== "string"
+        || !SHA256.test(value.source.source_fingerprint)
+        || typeof value.source.preview_digest !== "string"
+        || !SHA256.test(value.source.preview_digest)
+        || !mapping(value.marker)
+        || !exactKeys(value.marker, ["path", "sha256"])
+        || value.marker.path !== ENTITY_MODE_MARKER
+        || value.marker.sha256 !== hash(MARKER_BYTES)
+        || !Array.isArray(value.targets)) {
+        throw new EntityCutoverError(`forward 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(`forward cutover manifest '${FORWARD_MANIFEST}' has an invalid target`);
+        }
+        return { path: raw.path, sha256: raw.sha256 };
+    });
+    if (new Set(targets.map(({ path: target }) => target)).size !== targets.length
+        || canonicalRecordJson([...targets].sort((a, b) => a.path.localeCompare(b.path))) !== canonicalRecordJson(targets)) {
+        throw new EntityCutoverError(`forward cutover manifest '${FORWARD_MANIFEST}' targets must be unique and sorted`);
+    }
+    return {
+        schemaVersion: MANIFEST_SCHEMA,
+        phase: value.phase,
+        source: value.source,
+        targets,
+        marker: value.marker,
+    };
+}
+function loadForwardManifest(project) {
+    const observed = readProjectFileSnapshot(validateRealProjectRoot(project), FORWARD_MANIFEST);
+    if (observed.kind === "missing")
+        return null;
+    if (observed.kind !== "file")
+        throw new EntityCutoverError(`forward cutover manifest '${FORWARD_MANIFEST}' is unsafe`);
+    return parseForwardManifest(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(`migration source '${entry.source_identity}' has no safe canonical target`);
+        const id = target.id;
+        const artifact = entry.artifact;
+        const bytes = canonicalEntityEnvelopeBytes({ id, artifact, record: entry.record });
+        const sha256 = hash(bytes);
+        if (entry.target_sha256 !== sha256)
+            throw new EntityCutoverError(`migration source '${entry.source_identity}' target digest is not deterministic`);
+        return { path: target.path, sha256 };
+    }).sort((a, b) => a.path.localeCompare(b.path));
+    if (new Set(targets.map(({ path: target }) => target)).size !== targets.length)
+        throw new EntityCutoverError("entity cutover target paths are not unique");
+    return targets;
+}
+function assertPlanReady(plan, sourceRoot) {
+    if (plan.counts.blockers > 0)
+        throw new EntityCutoverError(`entity migration inventory has ${plan.counts.blockers} blocker(s); repair the read-only preview before upgrade`);
+    const invalid = validateEntityMigrationTargets(plan.project, plan.entries, sourceRoot)[0];
+    if (invalid)
+        throw new EntityCutoverError(`mapped record '${invalid.sourceIdentity}' is invalid: ${invalid.message}`);
+}
+function listFiles(project, relativeRoot) {
+    const absoluteRoot = path.join(project, relativeRoot);
+    if (!fs.existsSync(absoluteRoot))
+        return [];
+    const rootStat = fs.lstatSync(absoluteRoot);
+    if (!rootStat.isDirectory() || rootStat.isSymbolicLink() || fs.realpathSync(absoluteRoot) !== absoluteRoot)
+        throw new EntityCutoverError(`cutover path '${relativeRoot}' must be a real project directory`);
+    const found = [];
+    const visit = (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(`cutover path '${relative}' must not be a symbolic link`);
+            if (entry.isDirectory()) {
+                if (fs.realpathSync(absolute) !== absolute)
+                    throw new EntityCutoverError(`cutover directory '${relative}' is unsafe`);
+                visit(absolute);
+            }
+            else if (entry.isFile())
+                found.push(relative);
+            else
+                throw new EntityCutoverError(`cutover path '${relative}' must be a regular file or directory`);
+        }
+    };
+    visit(absoluteRoot);
+    return found.sort();
+}
+function validateExistingCanonicalTargets(project, targets, requireAll) {
+    const expected = new Map(targets.map((target) => [target.path, target]));
+    for (const relative of listFiles(project, ".agentera/entities")) {
+        const target = expected.get(relative);
+        if (!target)
+            throw new EntityCutoverError(`canonical entity '${relative}' is outside the bounded forward manifest`);
+    }
+    for (const target of targets) {
+        const observed = readProjectFileSnapshot(validateRealProjectRoot(project), target.path);
+        if (observed.kind === "missing") {
+            if (requireAll)
+                throw new EntityCutoverError(`canonical entity '${target.path}' is missing after entity publication`);
+            continue;
+        }
+        if (observed.kind !== "file" || hash(observed.bytes) !== target.sha256)
+            throw new EntityCutoverError(`canonical entity '${target.path}' diverges from the bounded forward manifest`);
+    }
+}
+function assertManifestMatchesPlan(manifest, plan, head, targets) {
+    if ((head !== null && manifest.source.head !== head)
+        || manifest.source.source_fingerprint !== plan.source_fingerprint
+        || manifest.source.preview_digest !== plan.preview_digest
+        || canonicalRecordJson(manifest.targets) !== canonicalRecordJson(targets)) {
+        throw new EntityCutoverError("forward cutover manifest does not match the current Git-pinned migration source");
+    }
+}
+function validateActiveEntityCutover(project, markerBytes, sourceRoot) {
+    const targets = loadEntityCutoverTargetsForMarker(project, markerBytes);
+    const result = validateEntityState(project, sourceRoot);
+    if (!result.valid)
+        throw new EntityCutoverError(`active entity state is invalid: ${result.issues.map(({ message }) => message).join("; ")}`);
+    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 === "one_way_git") {
+        const manifest = loadForwardManifest(project);
+        if (!manifest || manifest.phase !== "entities_published" || manifest.marker.sha256 !== hash(bytes))
+            throw new EntityCutoverError("one-way entity marker has no matching completed forward manifest");
+        return manifest.targets;
+    }
+    if (typeof marker.migration_id === "string")
+        return loadLegacyEntityCutoverTargets(project, bytes);
+    throw new EntityCutoverError("entity marker has no supported one-way or historical cutover binding");
+}
+function inspect(projectRoot, sourceRoot, requireGit, writerLockHeld = false) {
+    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(`state marker '${ENTITY_MODE_MARKER}' is unsafe`);
+    const plan = planEntityMigration(project, sourceRoot);
+    assertPlanReady(plan, sourceRoot);
+    const targets = targetsForPlan(plan);
+    const manifest = loadForwardManifest(project);
+    if (manifest)
+        assertManifestMatchesPlan(manifest, plan, null, targets);
+    validateExistingCanonicalTargets(project, targets, manifest?.phase === "entities_published");
+    if (!manifest && listFiles(project, ".agentera/entities").length > 0)
+        throw new EntityCutoverError("canonical entity state exists without the bounded forward manifest");
+    let head;
+    if (requireGit) {
+        const allowedPaths = new Set([FORWARD_MANIFEST, ENTITY_MODE_MARKER]);
+        if (manifest)
+            for (const target of targets)
+                allowedPaths.add(target.path);
+        const binding = verifyEntityCutoverGitSource(project, plan, { paths: allowedPaths, prefixes: [MIGRATION_STAGING, ...(writerLockHeld ? [".agentera/.writer.lock"] : [])] });
+        head = binding.head;
+        if (manifest)
+            assertManifestMatchesPlan(manifest, plan, head, targets);
+    }
+    return { inspection: { phase: manifest?.phase ?? "ready", entityCount: targets.length }, plan, ...(head ? { head } : {}) };
+}
+export function inspectEntityCutoverForUpgrade(projectRoot, sourceRoot, requireGit = false) {
+    return inspect(projectRoot, sourceRoot, requireGit).inspection;
+}
+export function prepareEntityCutoverForUpgrade(projectRoot, sourceRoot) {
+    const current = inspect(projectRoot, sourceRoot, true);
+    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(`cutover directory '${path.relative(project, current)}' is unsafe`);
+    }
+}
+function removeStaging(project) {
+    const staging = path.join(project, MIGRATION_STAGING);
+    if (!fs.existsSync(staging))
+        return;
+    const stat = fs.lstatSync(staging);
+    if (!stat.isDirectory() || stat.isSymbolicLink() || fs.realpathSync(staging) !== staging)
+        throw new EntityCutoverError(`known cutover staging '${MIGRATION_STAGING}' is unsafe and was not removed`);
+    fs.rmSync(staging, { recursive: true });
+}
+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 buildStaging(project, sourceRoot, plan, manifest) {
+    removeStaging(project);
+    ensureDirectory(project, STAGING_PROJECT);
+    for (const entry of plan.entries) {
+        const target = entry.proposed_target;
+        if (typeof target.id !== "string" || typeof entry.artifact !== "string")
+            throw new EntityCutoverError(`migration source '${entry.source_identity}' has no canonical identity`);
+        const id = target.id;
+        const artifact = entry.artifact;
+        const staged = path.join(project, STAGING_PROJECT, target.path);
+        ensureDirectory(project, path.relative(project, path.dirname(staged)).split(path.sep).join("/"));
+        writeDurable(staged, canonicalEntityEnvelopeBytes({ id, artifact, record: entry.record }));
+    }
+    const validation = validateEntityState(path.join(project, STAGING_PROJECT), sourceRoot);
+    if (!validation.valid || validation.entityCount !== manifest.targets.length)
+        throw new EntityCutoverError(`staged entity graph is invalid (${validation.entityCount}/${manifest.targets.length})`);
+    writeDurable(path.join(project, MIGRATION_STAGING, "forward.yaml"), manifestBytes(manifest));
+    fault("staging_built");
+}
+function publishForwardManifest(project) {
+    ensureDirectory(project, MIGRATION_ROOT);
+    const target = path.join(project, FORWARD_MANIFEST);
+    if (fs.existsSync(target))
+        throw new EntityCutoverError(`forward cutover manifest '${FORWARD_MANIFEST}' already exists`);
+    fs.renameSync(path.join(project, MIGRATION_STAGING, "forward.yaml"), target);
+    fault("manifest_published");
+}
+function publishCanonicalTargets(project, manifest) {
+    for (const target of manifest.targets) {
+        const canonical = path.join(project, target.path);
+        const observed = readProjectFileSnapshot(validateRealProjectRoot(project), target.path);
+        if (observed.kind === "file") {
+            if (hash(observed.bytes) !== target.sha256)
+                throw new EntityCutoverError(`canonical entity '${target.path}' diverges from the bounded forward manifest`);
+            continue;
+        }
+        if (observed.kind !== "missing")
+            throw new EntityCutoverError(`canonical entity '${target.path}' is unsafe`);
+        ensureDirectory(project, path.relative(project, path.dirname(canonical)).split(path.sep).join("/"));
+        fs.renameSync(path.join(project, STAGING_PROJECT, target.path), canonical);
+        fault("entity_published");
+    }
+}
+function validatePublishedGraph(project, sourceRoot, manifest) {
+    validateExistingCanonicalTargets(project, manifest.targets, true);
+    const validation = validateEntityState(project, sourceRoot);
+    if (!validation.valid || validation.entityCount !== manifest.targets.length)
+        throw new EntityCutoverError(`published entity graph is invalid (${validation.entityCount}/${manifest.targets.length})`);
+}
+function publishMarker(project) {
+    const existing = markerSnapshot(project);
+    if (existing.kind === "file") {
+        if (!existing.bytes.equals(Buffer.from(MARKER_BYTES)))
+            throw new EntityCutoverError(`state marker '${ENTITY_MODE_MARKER}' has unexpected bytes`);
+        return;
+    }
+    if (existing.kind !== "missing")
+        throw new EntityCutoverError(`state marker '${ENTITY_MODE_MARKER}' is unsafe`);
+    ensureDirectory(project, ".agentera");
+    const temporary = path.join(project, `.agentera/.state-mode-${randomUUID()}.tmp`);
+    try {
+        writeDurable(temporary, MARKER_BYTES);
+        if (fs.existsSync(path.join(project, ENTITY_MODE_MARKER)))
+            throw new EntityCutoverError(`state marker '${ENTITY_MODE_MARKER}' appeared during publication`);
+        fs.renameSync(temporary, path.join(project, ENTITY_MODE_MARKER));
+    }
+    finally {
+        fs.rmSync(temporary, { force: true });
+    }
+}
+function fault(phase) {
+    if (process.env.NODE_ENV === "test" && process.env.AGENTERA_FAULT_INJECT_ENTITY_MIGRATION_AFTER_PHASE === phase)
+        throw new EntityCutoverError(`simulated entity cutover interruption after ${phase}`);
+}
+export function applyPreparedEntityCutover(prepared) {
+    const before = inspect(prepared.project, prepared.sourceRoot, true);
+    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("Git-pinned entity cutover preparation changed before apply");
+    const lock = acquireWriterLock(prepared.project, 2000);
+    try {
+        const current = inspect(prepared.project, prepared.sourceRoot, true, true);
+        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("Git-pinned entity cutover source changed before its first publication effect");
+        const targets = targetsForPlan(plan);
+        let manifest = loadForwardManifest(prepared.project);
+        if (!manifest) {
+            manifest = { schemaVersion: MANIFEST_SCHEMA, phase: "publishing_entities", source: { head: current.head, source_fingerprint: plan.source_fingerprint, preview_digest: plan.preview_digest }, targets, marker: { path: ENTITY_MODE_MARKER, sha256: hash(MARKER_BYTES) } };
+            buildStaging(prepared.project, prepared.sourceRoot, plan, manifest);
+            publishForwardManifest(prepared.project);
+        }
+        else if (manifest.phase === "publishing_entities") {
+            buildStaging(prepared.project, prepared.sourceRoot, plan, manifest);
+        }
+        if (manifest.phase === "publishing_entities") {
+            publishCanonicalTargets(prepared.project, manifest);
+            validatePublishedGraph(prepared.project, prepared.sourceRoot, manifest);
+            manifest = { ...manifest, phase: "entities_published" };
+            writeFileAtomic(path.join(prepared.project, FORWARD_MANIFEST), manifestBytes(manifest));
+        }
+        else {
+            validatePublishedGraph(prepared.project, prepared.sourceRoot, manifest);
+        }
+        removeStaging(prepared.project);
+        fault("entities_published");
+        publishMarker(prepared.project);
+        const marker = markerSnapshot(prepared.project);
+        if (marker.kind !== "file")
+            throw new EntityCutoverError("entity authority marker was not published");
+        const entityCount = validateActiveEntityCutover(prepared.project, marker.bytes, prepared.sourceRoot);
+        return { status: "complete", phase: "active", idempotent: false, mutation_performed: true, entity_count: entityCount };
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=entityCutover.js.map

package/dist/state/entityCutover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityCutover.js","sourceRoot":"","sources":["../../src/state/entityCutover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAmC,MAAM,6BAA6B,CAAC;AACnI,OAAO,EAAE,8BAA8B,EAAmC,MAAM,kCAAkC,CAAC;AACnH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAG,+BAA+B,CAAC;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,cAAc,UAAU,CAAC;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,cAAc,eAAe,CAAC;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAE9D,MAAM,eAAe,GAAG,GAAG,iBAAiB,UAAU,CAAC;AACvD,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAC5D,MAAM,YAAY,GAAG,eAAe,CAAC,EAAE,aAAa,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC3H,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAiChC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,SAAS,IAAI,CAAC,KAAsB;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAAC,KAA8B,EAAE,QAAkB;IACnE,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,mBAAmB,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC;WACzC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;WACvB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;WACrB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,uBAAuB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,aAAa,CAAC,QAAyB;IAC9C,OAAO,eAAe,CAAC,QAA8C,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;WAC3E,KAAK,CAAC,aAAa,KAAK,eAAe;WACvC,CAAC,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;WAC5E,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;WACtB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;WAC1E,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;WACrC,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;WAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,kBAAkB,KAAK,QAAQ;WACnD,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC;WAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,cAAc,KAAK,QAAQ;WAC/C,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;WACzC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;WACtB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;WAC5C,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,kBAAkB;WACxC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,YAAY,CAAC;WAC1C,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,gBAAgB,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAA8B,EAAE;QACpE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChL,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,gBAAgB,yBAAyB,CAAC,CAAC;QACvG,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM;WACzE,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACrH,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,gBAAgB,qCAAqC,CAAC,CAAC;IACnH,CAAC;IACD,OAAO;QACL,aAAa,EAAE,eAAe;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAqB;QAClC,MAAM,EAAE,KAAK,CAAC,MAAmC;QACjD,OAAO;QACP,MAAM,EAAE,KAAK,CAAC,MAAmC;KAClD,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,QAAQ,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC7F,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,gBAAgB,aAAa,CAAC,CAAC;IACvH,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,IAAgC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAA8B,EAAE;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC;QACrC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,KAAK,CAAC,eAAe,gCAAgC,CAAC,CAAC;QACzN,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,KAAK,GAAG,4BAA4B,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,aAAa,KAAK,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,KAAK,CAAC,eAAe,sCAAsC,CAAC,CAAC;QACnJ,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,kBAAkB,CAAC,4CAA4C,CAAC,CAAC;IAC3J,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,IAAgC,EAAE,UAAkB;IAC3E,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,kCAAkC,IAAI,CAAC,MAAM,CAAC,QAAQ,0DAA0D,CAAC,CAAC;IAC7K,MAAM,OAAO,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,IAAI,OAAO;QAAE,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,OAAO,CAAC,cAAc,iBAAiB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACxH,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,YAAoB;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,YAAY;QAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,YAAY,oCAAoC,CAAC,CAAC;IAC5M,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAQ,EAAE;QACxC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACpH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5E,IAAI,KAAK,CAAC,cAAc,EAAE;gBAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,QAAQ,+BAA+B,CAAC,CAAC;YACnH,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,QAAQ;oBAAE,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,QAAQ,aAAa,CAAC,CAAC;gBACtH,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;;gBAC3C,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,QAAQ,uCAAuC,CAAC,CAAC;QACtG,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,YAAY,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,gCAAgC,CAAC,OAAe,EAAE,OAAqC,EAAE,UAAmB;IACnH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,QAAQ,2CAA2C,CAAC,CAAC;IACtH,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACxF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,UAAU;gBAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,MAAM,CAAC,IAAI,uCAAuC,CAAC,CAAC;YACtH,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,MAAM,CAAC,IAAI,8CAA8C,CAAC,CAAC;IACvL,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAyB,EAAE,IAAgC,EAAE,IAAmB,EAAE,OAAqC;IACxJ,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;WAC/C,QAAQ,CAAC,MAAM,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB;WAC9D,QAAQ,CAAC,MAAM,CAAC,cAAc,KAAK,IAAI,CAAC,cAAc;WACtD,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,kBAAkB,CAAC,iFAAiF,CAAC,CAAC;IAClH,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,OAAe,EAAE,WAAmB,EAAE,UAAkB;IAC3F,MAAM,OAAO,GAAG,iCAAiC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7I,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,cAAc,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvJ,MAAM,IAAI,kBAAkB,CAAC,yBAAyB,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,WAAmB,EAAE,KAAa;IAClF,MAAM,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,aAAa,KAAK,uBAAuB,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,MAAM,IAAI,kBAAkB,CAAC,4CAA4C,CAAC,CAAC;IAC/J,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,oBAAoB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,kEAAkE,CAAC,CAAC;QACrM,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,8BAA8B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACnG,MAAM,IAAI,kBAAkB,CAAC,sEAAsE,CAAC,CAAC;AACvG,CAAC;AAED,SAAS,OAAO,CAAC,WAAmB,EAAE,UAAkB,EAAE,UAAmB,EAAE,cAAc,GAAG,KAAK;IACnG,MAAM,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;IACpJ,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,kBAAkB,aAAa,CAAC,CAAC;IAE9G,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtD,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,QAAQ;QAAE,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,gCAAgC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,oBAAoB,CAAC,CAAC;IAC7F,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,oEAAoE,CAAC,CAAC;IAEzK,IAAI,IAAwB,CAAC;IAC7B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC7E,IAAI,QAAQ;YAAE,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3K,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACpB,IAAI,QAAQ;YAAE,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7H,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAmB,EAAE,UAAkB,EAAE,UAAU,GAAG,KAAK;IACxG,OAAO,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,UAAU,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAmB,EAAE,UAAkB;IACpF,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,MAAM,IAAI,kBAAkB,CAAC,yEAAyE,CAAC,CAAC;IACrL,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;AAC3K,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,iBAAyB;IACjE,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,OAAO;YAAE,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7L,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACpC,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,OAAO;QAAE,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,iBAAiB,iCAAiC,CAAC,CAAC;IACrM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACzI,IAAI,CAAC;QAAC,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,UAAkB,EAAE,IAAgC,EAAE,QAAyB;IACpH,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,eAAgB,CAAC;QACtC,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,KAAK,CAAC,eAAe,6BAA6B,CAAC,CAAC;QAC/K,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACjG,YAAY,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,UAAU,CAAC,CAAC;IACxF,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,WAAW,KAAK,QAAQ,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,UAAU,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACnM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7F,KAAK,CAAC,eAAe,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe;IAC7C,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACpD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,gBAAgB,kBAAkB,CAAC,CAAC;IACzH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7E,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAe,EAAE,QAAyB;IACzE,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACxF,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,MAAM,CAAC,IAAI,8CAA8C,CAAC,CAAC;YACzJ,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,MAAM,CAAC,IAAI,aAAa,CAAC,CAAC;QAC7G,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3E,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,UAAkB,EAAE,QAAyB;IAC5F,gCAAgC,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,WAAW,KAAK,QAAQ,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,UAAU,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AACxM,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,kBAAkB,wBAAwB,CAAC,CAAC;QACjJ,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,kBAAkB,aAAa,CAAC,CAAC;IAChH,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,UAAU,EAAE,MAAM,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACtC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,kBAAkB,+BAA+B,CAAC,CAAC;QAC5J,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACnE,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kDAAkD,KAAK,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,+CAA+C,KAAK,EAAE,CAAC,CAAC;AACxM,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAA+B;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACnL,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,KAAK,QAAQ,CAAC,iBAAiB,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,aAAa;QAAE,MAAM,IAAI,kBAAkB,CAAC,4DAA4D,CAAC,CAAC;IAExQ,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACrL,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,kBAAkB,KAAK,QAAQ,CAAC,iBAAiB,IAAI,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,aAAa;YAAE,MAAM,IAAI,kBAAkB,CAAC,8EAA8E,CAAC,CAAC;QAC7P,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YAC1Q,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACpE,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,qBAAqB,EAAE,CAAC;YACpD,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,KAAK,qBAAqB,EAAE,CAAC;YAC7C,uBAAuB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpD,sBAAsB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxE,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACxD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,sBAAsB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC1E,CAAC;QACD,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5B,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,2CAA2C,CAAC,CAAC;QACtG,MAAM,WAAW,GAAG,2BAA2B,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;IACzH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/state/entityCutoverGit.js

@@ -0,0 +1,128 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { validateRealProjectRoot } from "./projectRoot.js";
+import { readProjectFileSnapshot } from "./safeProjectFile.js";
+export class EntityCutoverGitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EntityCutoverGitError";
+    }
+}
+function hash(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function gitEnvironment() {
+    const env = { ...process.env };
+    for (const name of ["GIT_INDEX_FILE", "GIT_DIR", "GIT_WORK_TREE", "GIT_COMMON_DIR"])
+        delete env[name];
+    return env;
+}
+function git(project, args, encoding = "utf8") {
+    const result = spawnSync("git", args, { cwd: project, env: gitEnvironment(), encoding: encoding ?? "buffer" });
+    if (result.error)
+        throw new EntityCutoverGitError(`Git preflight failed: ${result.error.message}`);
+    return { status: result.status ?? 2, stdout: result.stdout ?? (encoding === null ? Buffer.alloc(0) : "") };
+}
+function gitText(project, args) {
+    const result = git(project, args);
+    if (result.status !== 0)
+        throw new EntityCutoverGitError(`Git preflight command failed: git ${args.join(" ")}`);
+    return String(result.stdout).trim();
+}
+function safeRelative(value) {
+    return value.length > 0
+        && !value.includes("\0")
+        && !value.includes("\\")
+        && !path.isAbsolute(value)
+        && value.split("/").every((part) => part !== "" && part !== "." && part !== "..");
+}
+function assertCleanTrackedState(project) {
+    const working = git(project, ["diff", "--quiet", "--no-ext-diff", "--"]);
+    if (working.status === 1)
+        throw new EntityCutoverGitError("Git worktree has modified or renamed tracked paths; commit or restore them before v2-to-v3 upgrade");
+    if (working.status !== 0)
+        throw new EntityCutoverGitError("Git could not verify the working tree before v2-to-v3 upgrade");
+    const staged = git(project, ["diff", "--cached", "--quiet", "--no-ext-diff", "HEAD", "--"]);
+    if (staged.status === 1)
+        throw new EntityCutoverGitError("Git index has staged or renamed paths; commit or restore them before v2-to-v3 upgrade");
+    if (staged.status !== 0)
+        throw new EntityCutoverGitError("Git could not verify the index before v2-to-v3 upgrade");
+}
+function assertNoUnapprovedUntracked(project, allowlist) {
+    const result = git(project, ["ls-files", "--others", "--exclude-standard", "-z"]);
+    if (result.status !== 0)
+        throw new EntityCutoverGitError("Git could not inventory untracked paths before v2-to-v3 upgrade");
+    const paths = new Set(allowlist.paths ?? []);
+    const prefixes = [...(allowlist.prefixes ?? [])].map((prefix) => prefix.endsWith("/") ? prefix : `${prefix}/`);
+    const unexpected = String(result.stdout).split("\0").filter(Boolean).find((candidate) => !paths.has(candidate) && !prefixes.some((prefix) => candidate.startsWith(prefix)));
+    if (unexpected)
+        throw new EntityCutoverGitError(`Git worktree has untracked path '${unexpected}'; commit, ignore, or remove it before v2-to-v3 upgrade`);
+}
+function headEntry(project, relativePath) {
+    const result = git(project, ["ls-tree", "-z", "HEAD", "--", relativePath]);
+    if (result.status !== 0)
+        throw new EntityCutoverGitError(`Git could not inspect HEAD path '${relativePath}'`);
+    const records = String(result.stdout).split("\0").filter(Boolean);
+    if (records.length === 0)
+        return null;
+    if (records.length !== 1)
+        throw new EntityCutoverGitError(`Git HEAD path '${relativePath}' is ambiguous`);
+    const match = /^([0-7]{6}) (blob|commit) ([a-f0-9]+)\t(.+)$/.exec(records[0]);
+    if (!match || match[4] !== relativePath || match[2] !== "blob" || !["100644", "100755"].includes(match[1])) {
+        throw new EntityCutoverGitError(`migration input '${relativePath}' must be a regular tracked file in HEAD`);
+    }
+    return { mode: match[1], oid: match[3] };
+}
+function assertSourceMatchesHead(project, source) {
+    const lookupPath = source.path.endsWith("/") ? source.path.slice(0, -1) : source.path;
+    if (!safeRelative(lookupPath))
+        throw new EntityCutoverGitError(`migration input path '${source.path}' is unsafe`);
+    if (source.presence === "missing") {
+        const tracked = source.path.endsWith("/")
+            ? gitText(project, ["ls-tree", "-r", "--name-only", "HEAD", "--", `${lookupPath}/`]) !== ""
+            : headEntry(project, lookupPath) !== null;
+        if (tracked)
+            throw new EntityCutoverGitError(`migration input '${source.path}' is tracked in HEAD but absent from the worktree`);
+        const observed = readProjectFileSnapshot(validateRealProjectRoot(project), lookupPath);
+        if (observed.kind !== "missing")
+            throw new EntityCutoverGitError(`migration input '${source.path}' is absent from HEAD but present or unsafe in the worktree`);
+        return;
+    }
+    const tracked = headEntry(project, lookupPath);
+    if (!tracked)
+        throw new EntityCutoverGitError(`migration input '${source.path}' is ignored or untracked; v2-to-v3 upgrade consumes only HEAD`);
+    const observed = readProjectFileSnapshot(validateRealProjectRoot(project), lookupPath);
+    if (observed.kind !== "file")
+        throw new EntityCutoverGitError(`migration input '${source.path}' must be a safe regular tracked file`);
+    const blob = git(project, ["cat-file", "blob", tracked.oid], null);
+    if (blob.status !== 0 || !Buffer.isBuffer(blob.stdout))
+        throw new EntityCutoverGitError(`Git could not read HEAD bytes for migration input '${source.path}'`);
+    const executable = (observed.mode & 0o111) !== 0;
+    const expectedMode = executable ? "100755" : "100644";
+    if (tracked.mode !== expectedMode
+        || source.mode !== observed.mode
+        || source.type !== "file"
+        || source.sha256 !== hash(observed.bytes)
+        || !observed.bytes.equals(blob.stdout)) {
+        throw new EntityCutoverGitError(`migration input '${source.path}' differs from HEAD in bytes, type, mode, or symlink form`);
+    }
+}
+export function verifyEntityCutoverGitSource(projectRoot, plan, allowlist = {}) {
+    const project = validateRealProjectRoot(projectRoot).path;
+    const top = fs.realpathSync(gitText(project, ["rev-parse", "--show-toplevel"]));
+    if (top !== project)
+        throw new EntityCutoverGitError(`project '${project}' must be the Git worktree root for v2-to-v3 upgrade`);
+    const head = gitText(project, ["rev-parse", "--verify", "HEAD^{commit}"]);
+    if (!/^[a-f0-9]{40,64}$/.test(head))
+        throw new EntityCutoverGitError("Git HEAD is missing or invalid; commit the v2 project before upgrade");
+    assertCleanTrackedState(project);
+    assertNoUnapprovedUntracked(project, allowlist);
+    for (const source of plan.sources)
+        assertSourceMatchesHead(project, source);
+    if (gitText(project, ["rev-parse", "--verify", "HEAD^{commit}"]) !== head)
+        throw new EntityCutoverGitError("Git HEAD changed during v2-to-v3 preflight");
+    return { head };
+}
+//# sourceMappingURL=entityCutoverGit.js.map

package/dist/state/entityCutoverGit.js.map

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