agentera 3.0.0-dev.3 → 3.0.0-dev.31

package/dist/cli/commands/state/write.js

@@ -0,0 +1,418 @@
+import path from "node:path";
+import fs from "node:fs";
+import { emitInvalidInput } from "../../errors.js";
+import { emitStructured } from "../../structured.js";
+import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
+import { normalizeArtifactProtocolId, VALIDATE_ARTIFACT_PROTOCOL_IDS, } from "../../../registries/artifactProtocolIds.js";
+import { buildExplain, exampleFor, executeStateWrite, isWritableArtifact, loadStructuredInput, operationSpec, projectedFields, renderExplainText, StateWriteInputError, verbsForArtifact, WRITABLE_ARTIFACTS, } from "../../../state/write/index.js";
+function formatFromArgv(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === "--format" && argv[i + 1] === "json")
+            return "json";
+        if (argv[i] === "--format=json")
+            return "json";
+    }
+    return "text";
+}
+function invalid(body) {
+    throw new StateWriteInputError(body);
+}
+function emitRetrievalFailure(error, format, io) {
+    if (format === "json") {
+        emitStructured(error.body, "json", io.out ?? ((text) => process.stdout.write(text)));
+    }
+    else {
+        const detail = error.body.error;
+        (io.err ?? ((text) => process.stderr.write(text)))([
+            `Error: ${detail.message}`,
+            `Syntax: ${detail.syntax}`,
+            `Example: ${detail.example}`,
+            `Recovery: ${detail.recovery}`,
+        ].join("\n") + "\n");
+    }
+    return error.exitCode;
+}
+function setNested(target, field, value) {
+    const parts = field.split(".");
+    let cursor = target;
+    for (const part of parts.slice(0, -1)) {
+        if (!cursor[part] || typeof cursor[part] !== "object" || Array.isArray(cursor[part]))
+            cursor[part] = {};
+        cursor = cursor[part];
+    }
+    cursor[parts.at(-1)] = value;
+}
+function readFlag(argv, index) {
+    const token = argv[index];
+    const equals = token.indexOf("=");
+    if (equals > 0)
+        return { name: token.slice(0, equals), value: token.slice(equals + 1), consumed: 1 };
+    return { name: token, value: argv[index + 1] ?? null, consumed: 2 };
+}
+function converted(field, raw) {
+    if (field.kind === "integer" || field.kind === "integer_list") {
+        const number = Number(raw);
+        if (!Number.isInteger(number))
+            invalid({
+                class: "invalid_int",
+                message: `argument ${field.flag}: invalid int value: '${raw}'`,
+                syntax: `${field.flag} N`,
+            });
+        return field.kind === "integer" ? number : String(number);
+    }
+    if (field.kind === "date" && !/^\d{4}-\d{2}-\d{2}$/.test(raw)) {
+        invalid({
+            class: "invalid_format",
+            message: `argument ${field.flag}: expected YYYY-MM-DD, got '${raw}'`,
+            syntax: `${field.flag} YYYY-MM-DD`,
+        });
+    }
+    if (field.kind === "datetime" && !/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(raw)) {
+        invalid({
+            class: "invalid_format",
+            message: `argument ${field.flag}: expected YYYY-MM-DD HH:MM, got '${raw}'`,
+            syntax: `${field.flag} "YYYY-MM-DD HH:MM"`,
+        });
+    }
+    if (field.validValues && !field.validValues.includes(raw)) {
+        invalid({
+            class: "invalid_choice",
+            message: `argument ${field.flag}: invalid choice: '${raw}' (choose from ${field.validValues.map((v) => `'${v}'`).join(", ")})`,
+            valid_values: field.validValues,
+        });
+    }
+    return raw;
+}
+function artifactOrReject(raw) {
+    const normalized = normalizeArtifactProtocolId(raw);
+    if (normalized === null) {
+        invalid({
+            class: "unsupported_target",
+            message: `unsupported artifact "${raw}"; valid artifact_id values: ${VALIDATE_ARTIFACT_PROTOCOL_IDS.join(", ")}`,
+            valid_values: [...WRITABLE_ARTIFACTS],
+        });
+    }
+    if (!isWritableArtifact(normalized)) {
+        invalid({
+            class: "unsupported_target",
+            message: `artifact "${normalized}" is read-only through the state writer`,
+            valid_values: [...WRITABLE_ARTIFACTS],
+            example: 'agentera state progress append --type fix --phase build --what "..." --intent "..."',
+        });
+    }
+    return normalized;
+}
+function specOrReject(artifact, verb) {
+    const spec = operationSpec(artifact, verb);
+    if (!spec) {
+        const retrievalVerbs = artifact === "plan" ? ["list", "get", "tasks"] : artifact === "experiments" ? ["list", "get"] : [];
+        invalid({
+            class: "invalid_choice",
+            message: `verb "${verb}" does not apply to ${artifact}`,
+            valid_values: [...retrievalVerbs, ...verbsForArtifact(artifact)],
+            example: artifact === "experiments"
+                ? "agentera state experiments list --objective OBJECTIVE_ID --format json"
+                : `agentera state ${artifact} ${artifact === "plan" ? "list --format json" : "explain --format json"}`,
+        });
+    }
+    return spec;
+}
+function parseWrite(artifactRaw, argv) {
+    const artifact = artifactOrReject(artifactRaw);
+    const verb = argv[0];
+    if (!verb)
+        invalid({
+            class: "missing_argument",
+            message: `write verb is required for ${artifact}`,
+            valid_values: verbsForArtifact(artifact),
+        });
+    const spec = specOrReject(artifact, verb);
+    let initialProjectRoot = process.cwd();
+    for (let index = 1; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--project" && argv[index + 1])
+            initialProjectRoot = path.resolve(argv[index + 1]);
+        else if (token.startsWith("--project="))
+            initialProjectRoot = path.resolve(token.slice("--project=".length));
+    }
+    const entityPlan = artifact === "plan" && verb !== "create";
+    let fields = projectedFields(spec);
+    if (entityPlan) {
+        fields = fields.filter((field) => field.flag !== "--task").map((field) => field.flag === "--depends-on" ? { ...field, kind: "string_list" } : field);
+        if (["update", "set-status", "supersede", "record-evaluation"].includes(verb))
+            fields.unshift({ flag: "--id", field: "id", kind: "string", required: true });
+        fields.unshift({ flag: "--plan", field: "plan", kind: "string" });
+    }
+    const byFlag = new Map(fields.map((field) => [field.flag, field]));
+    const values = {};
+    const callerPayload = {};
+    const occurrences = new Map();
+    let format = "text";
+    let projectRoot = initialProjectRoot;
+    let dryRun = false;
+    let force = false;
+    let inputSource = null;
+    for (let i = 1; i < argv.length;) {
+        const token = argv[i];
+        if (!token.startsWith("--"))
+            invalid({ class: "unrecognized_argument", message: `unrecognized arguments: ${token}` });
+        if (token === "--dry-run") {
+            dryRun = true;
+            i += 1;
+            continue;
+        }
+        if (token === "--force") {
+            force = true;
+            i += 1;
+            continue;
+        }
+        const parsed = readFlag(argv, i);
+        if (parsed.value === null || parsed.value.startsWith("--"))
+            invalid({
+                class: "missing_argument",
+                message: `${parsed.name} requires a value`,
+                syntax: `${parsed.name} VALUE`,
+            });
+        i += parsed.consumed;
+        if (parsed.name === "--format") {
+            if (parsed.value !== "text" && parsed.value !== "json")
+                invalid({
+                    class: "invalid_choice",
+                    message: `argument --format: invalid choice: '${parsed.value}' (choose from 'text', 'json')`,
+                    valid_values: ["text", "json"],
+                });
+            format = parsed.value;
+            continue;
+        }
+        if (parsed.name === "--project") {
+            projectRoot = path.resolve(parsed.value);
+            continue;
+        }
+        if (parsed.name === "--input") {
+            inputSource = parsed.value;
+            continue;
+        }
+        if (parsed.name === "--number" && verb === "append") {
+            invalid({
+                class: "unrecognized_argument",
+                message: "--number is assigned by the CLI on append and cannot be supplied",
+                example: exampleFor(artifact, verb),
+            });
+        }
+        const field = byFlag.get(parsed.name);
+        if (!field) {
+            if (spec.inputRoot)
+                invalid({
+                    class: "mutually_exclusive",
+                    message: `--input cannot be combined with ${parsed.name}`,
+                });
+            invalid({
+                class: "unrecognized_argument",
+                message: `unrecognized arguments: ${parsed.name}`,
+                example: exampleFor(artifact, verb),
+            });
+        }
+        const count = (occurrences.get(parsed.name) ?? 0) + 1;
+        occurrences.set(parsed.name, count);
+        if (!field.repeatable && count > 1) {
+            const message = parsed.name === "--alternative-chosen"
+                ? `exactly one alternative must be chosen (DV3); received ${count} --alternative-chosen flags`
+                : `${parsed.name} may only be supplied once`;
+            invalid({ class: "mutually_exclusive", message });
+        }
+        const value = converted(field, parsed.value);
+        if (field.repeatable) {
+            const current = mappingPath(values, field.field) ?? [];
+            setNested(values, field.field, [...current, value]);
+            setNested(callerPayload, field.field, [...current, value]);
+        }
+        else {
+            setNested(values, field.field, value);
+            setNested(callerPayload, field.field, value);
+        }
+    }
+    if (force && !spec.allowForce)
+        invalid({
+            class: "unrecognized_argument",
+            message: `--force does not apply to ${artifact} ${verb}`,
+        });
+    if (inputSource && !spec.inputRoot)
+        invalid({
+            class: "mutually_exclusive",
+            message: `${artifact} ${verb} accepts field flags, not --input`,
+            example: exampleFor(artifact, verb),
+        });
+    if (spec.inputRoot && !inputSource)
+        invalid({
+            class: "missing_argument",
+            message: `--input is required for ${artifact} ${verb}`,
+            syntax: "--input PATH",
+            example: exampleFor(artifact, verb),
+        });
+    if (spec.inputRoot && Object.keys(values).length && !(["objective", "experiments", "docs"].includes(artifact)))
+        invalid({
+            class: "mutually_exclusive",
+            message: `--input cannot be combined with field flags for ${artifact} ${verb}`,
+        });
+    if (artifact === "health" && verb === "repair") {
+        invalid({
+            class: "unsupported_target",
+            message: "canonical health audit entities are immutable and cannot be row-deduplicated",
+            syntax: "agentera check validate state",
+            example: "agentera check validate state --format json",
+            recovery: "Validate malformed envelopes, duplicate IDs, or conflicting ownership and repair the canonical entity files without inventing audit history.",
+        });
+    }
+    const entityExperiments = artifact === "experiments";
+    for (const field of fields.filter((candidate) => candidate.required && !(entityExperiments && candidate.field === "number"))) {
+        if (mappingPath(values, field.field) === undefined) {
+            invalid({
+                class: "missing_argument",
+                message: `${field.flag} is required for ${artifact} ${verb}`,
+                valid_values: field.validValues,
+                syntax: `${field.flag} VALUE`,
+                example: exampleFor(artifact, verb),
+            });
+        }
+    }
+    if (artifact === "decisions" && (verb === "update" || verb === "amend")) {
+        const id = mappingPath(values, "id");
+        const number = mappingPath(values, "number");
+        if (number !== undefined)
+            invalid({ class: "unrecognized_argument", message: "numeric decision selectors are unavailable in entity mode; use --id ID" });
+        if (id === undefined)
+            invalid({ class: "missing_argument", message: `--id is required for decisions ${verb} in entity mode` });
+        if (verb === "amend" && mappingPath(values, "base_sha256") === undefined)
+            invalid({ class: "missing_argument", message: "--base-sha256 is required for decisions amend in entity mode" });
+    }
+    if (artifact === "plan" && verb !== "create") {
+        const taskVerb = ["update", "set-status", "supersede", "record-evaluation"].includes(verb);
+        const id = mappingPath(values, "id");
+        const task = mappingPath(values, "task");
+        if (task !== undefined)
+            invalid({ class: "unrecognized_argument", message: "numeric task selectors are unavailable in entity mode; use --id ID" });
+        if (taskVerb && id === undefined)
+            invalid({ class: "missing_argument", message: `--id is required for plan ${verb} in entity mode` });
+        if (force)
+            invalid({ class: "unrecognized_argument", message: "--force is unavailable for entity plans; incomplete plans remain canonical history" });
+    }
+    if (artifact === "plan" && verb === "create" && force)
+        invalid({ class: "unrecognized_argument", message: "--force is unavailable for entity plan create because multiple open plans coexist" });
+    if (artifact === "experiments" && verb === "publish") {
+        const number = mappingPath(values, "number");
+        if (number !== undefined)
+            invalid({ class: "unrecognized_argument", message: "numeric experiment selectors are unavailable in entity mode; omit --number" });
+    }
+    if (verb === "update" &&
+        artifact === "plan" &&
+        Object.keys(values).every((key) => key === "task")) {
+        invalid({
+            class: "missing_argument",
+            message: "plan update requires at least one task field or --surprise",
+        });
+    }
+    return { artifact, spec, format, projectRoot, dryRun, force, values, callerPayload, inputSource };
+}
+function mappingPath(entry, field) {
+    let value = entry;
+    for (const part of field.split(".")) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            return undefined;
+        value = value[part];
+    }
+    return value;
+}
+function explainArgs(argv) {
+    let format = "text";
+    let project = process.cwd();
+    let verb = null;
+    for (let i = 1; i < argv.length;) {
+        const parsed = readFlag(argv, i);
+        if (parsed.value === null || parsed.value.startsWith("--"))
+            invalid({ class: "missing_argument", message: `${parsed.name} requires a value` });
+        i += parsed.consumed;
+        if (parsed.name === "--format") {
+            if (parsed.value !== "text" && parsed.value !== "json")
+                invalid({
+                    class: "invalid_choice",
+                    message: `argument --format: invalid choice: '${parsed.value}' (choose from 'text', 'json')`,
+                    valid_values: ["text", "json"],
+                });
+            format = parsed.value;
+        }
+        else if (parsed.name === "--project")
+            project = path.resolve(parsed.value);
+        else if (parsed.name === "--verb")
+            verb = parsed.value;
+        else
+            invalid({
+                class: "unrecognized_argument",
+                message: `unrecognized arguments: ${parsed.name}`,
+            });
+    }
+    return { format, project, verb };
+}
+export function runStateWrite(artifactRaw, argv, io) {
+    const out = io.out ?? ((text) => process.stdout.write(text));
+    const err = io.err ?? ((text) => process.stderr.write(text));
+    const detectedFormat = formatFromArgv(argv);
+    try {
+        const artifact = artifactOrReject(artifactRaw);
+        if (argv[0] === "explain") {
+            const args = explainArgs(argv);
+            const explanation = buildExplain(artifact, args.project, args.verb);
+            if (args.format === "json")
+                out(JSON.stringify(explanation, null, 2) + "\n");
+            else
+                out(renderExplainText(explanation));
+            return 0;
+        }
+        const parsed = parseWrite(artifactRaw, argv);
+        let input = null;
+        if (parsed.inputSource) {
+            try {
+                input = loadStructuredInput(parsed.inputSource, io.stdin ?? (() => fsStdin()));
+            }
+            catch (error) {
+                const message = error.message;
+                invalid({
+                    class: message.startsWith("input file") ? "unsupported_target" : "invalid_format",
+                    message,
+                    syntax: "--input PATH",
+                    example: exampleFor(parsed.artifact, parsed.spec.verb),
+                });
+            }
+            for (const owned of parsed.spec.cliOwnedFields ?? []) {
+                if (owned in input)
+                    invalid({
+                        class: "schema_violation",
+                        message: `${parsed.artifact} ${parsed.spec.verb} assigns ${owned}; remove '${owned}' from the input document`,
+                        violations: [`CLI-owned field: ${owned}`],
+                    });
+            }
+            parsed.callerPayload = structuredClone(input);
+        }
+        const envelope = executeStateWrite({ ...parsed, input });
+        if (parsed.format === "json")
+            out(JSON.stringify(envelope, null, 2) + "\n");
+        else if (parsed.dryRun)
+            out(String(envelope.diff ?? "No changes.\n"));
+        else {
+            const operation = envelope.operation;
+            out(`${envelope.command}: ${operation.idempotent_replay ? "idempotent replay" : "wrote"} ${envelope.path}\n`);
+        }
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof StateWriteInputError)
+            return emitInvalidInput(io, { format: detectedFormat, body: error.body });
+        if (error instanceof StateRetrievalFailure)
+            return emitRetrievalFailure(error, detectedFormat, io);
+        err(`Error: ${error.message}\n`);
+        return 1;
+    }
+}
+function fsStdin() {
+    return process.stdin.isTTY ? "" : fs.readFileSync(0, "utf8");
+}
+//# sourceMappingURL=write.js.map

package/dist/cli/commands/state/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/state/write.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/upgrade.js

@@ -1,4 +1,8 @@
 import { buildUpgradePlan, renderUpgradePlan, sortKeysDeep, upgradeExitCode, validateUpgradeApply, } from "../../upgrade/upgradeOrchestrator.js";
+import { renderVerifySummary, verifyOneWayUpgrade, verifyUpgrade, } from "./upgradeVerify.js";
+import { detectStateMode } from "../../state/stateMode.js";
+import { UpgradeLockError } from "../../upgrade/upgradeLock.js";
+import { fullEntityUpgradeCommand } from "../../upgrade/upgradeCommands.js";
 /** Canonical stable-channel update entry point. */
 export const UPGRADE_COMMAND = "npx -y agentera@latest";
 function toOrchestratorArgs(args) {
@@ -11,38 +15,176 @@ function toOrchestratorArgs(args) {
         dryRun: args.dryRun ?? false,
         only: args.only && args.only.length > 0 ? args.only : null,
         force: args.force ?? false,
+        runtime: args.runtime ?? null,
+        legacyCleanup: args.legacyCleanup ?? null,
     };
 }
-export function cmdUpgrade(args, io = {}) {
+function toVerifyContext(args) {
+    return {
+        installRoot: args.installRoot ?? null,
+        home: args.home ?? null,
+        project: args.project ?? null,
+        expectedVersion: args.expectedVersion ?? null,
+    };
+}
+function renderOneWayResult(verification, applyPassed, json) {
+    const verificationPassed = verification.state_validation.status === "passed"
+        && verification.startup_validation.status === "passed";
+    const result = {
+        phase: applyPassed ? (verificationPassed ? "complete" : "verification") : "apply",
+        startup_validation: verification.startup_validation,
+        state_validation: verification.state_validation,
+        status: applyPassed && verificationPassed ? "success" : "failed",
+    };
+    if (json)
+        return JSON.stringify(result, null, 2) + "\n";
+    return result.status === "success"
+        ? "Agentera upgraded this project from v2 to v3; state and startup validation passed.\n"
+        : "Agentera could not verify the v2-to-v3 upgrade.\n";
+}
+function entityAuthorityConfirmedActive(project) {
+    try {
+        return detectStateMode(project) === "entities";
+    }
+    catch {
+        return false;
+    }
+}
+export function cmdUpgrade(args, io = {}, dependencies = {}) {
     const out = io.out ?? ((t) => process.stdout.write(t));
     const err = io.err ?? ((t) => process.stderr.write(t));
     const orchestratorArgs = toOrchestratorArgs(args);
+    if (orchestratorArgs.runtime) {
+        err(`upgrade error: --runtime ${orchestratorArgs.runtime} is retired; Agentera now uses the shared skill at ` +
+            "~/.agents/skills/agentera plus the CLI. Remove --runtime and rerun. " +
+            "For explicit Agentera-owned native resource cleanup, use --legacy-cleanup RESOURCE_ID.\n");
+        return 2;
+    }
     if (orchestratorArgs.yes && orchestratorArgs.dryRun) {
         err("upgrade error: --yes and --dry-run are mutually exclusive\n");
         return 2;
     }
+    if (orchestratorArgs.yes && orchestratorArgs.only?.length) {
+        err(`upgrade error: --only is preview-only; apply must run as one full upgrade --yes\nRecovery: ${fullEntityUpgradeCommand(path.resolve(args.project ?? process.cwd()))}\n`);
+        return 2;
+    }
+    if (orchestratorArgs.legacyCleanup
+        && orchestratorArgs.only
+        && orchestratorArgs.only.length > 0) {
+        err("upgrade error: --only cannot be combined with --legacy-cleanup; cleanup preview must include the complete app phase\n");
+        return 2;
+    }
+    if (args.verify && orchestratorArgs.dryRun) {
+        err("upgrade error: --verify cannot be combined with --dry-run\n");
+        return 2;
+    }
+    if (args.verify && !orchestratorArgs.yes && (orchestratorArgs.legacyCleanup)) {
+        err("upgrade error: legacy cleanup with --verify requires --yes; preview cleanup with --dry-run instead\n");
+        return 2;
+    }
+    if (args.verify && !orchestratorArgs.yes) {
+        let result;
+        try {
+            result = verifyUpgrade(toVerifyContext(args));
+        }
+        catch (exc) {
+            err(`upgrade error: ${exc.message}\n`);
+            return 2;
+        }
+        out(renderVerifySummary(result, (args.format ?? "text") === "json"));
+        return result.passed ? 0 : 1;
+    }
     let plan;
+    let fullEntityCutoverApply = false;
     try {
         if (orchestratorArgs.yes) {
             const preview = buildUpgradePlan({ ...orchestratorArgs, yes: false });
+            fullEntityCutoverApply = !orchestratorArgs.only && (preview.crossMajorBoundary || preview.phases.some((phase) => phase.name === "entities" && phase.items.some((item) => item.action === "entity-cutover" && item.status === "pending")));
             const applyError = validateUpgradeApply(orchestratorArgs, preview);
             if (applyError) {
-                err(`upgrade error: ${applyError}\n`);
+                if (preview.crossMajorBoundary) {
+                    if (orchestratorArgs.only) {
+                        err("upgrade error: v2-to-v3 apply must run as one full upgrade --yes; --only is preview-only.\n");
+                    }
+                    else if (preview.channel.distributionMajor < 3) {
+                        err("upgrade error: v2-to-v3 apply requires the development channel; preview there, then retry with --yes.\n");
+                    }
+                    else if (!entityAuthorityConfirmedActive(preview.project)) {
+                        err(`upgrade error: v2-to-v3 preflight failed: ${applyError}. Recover the tracked v2 checkout with Git and retry.\n`);
+                    }
+                    else {
+                        err("upgrade error: v2-to-v3 preflight failed. Rerun the same upgrade command to continue forward.\n");
+                    }
+                }
+                else {
+                    err(`upgrade error: ${applyError}\n`);
+                }
                 return 1;
             }
         }
         plan = buildUpgradePlan(orchestratorArgs);
     }
     catch (exc) {
-        err(`upgrade error: ${exc.message}\n`);
+        if (exc instanceof UpgradeLockError) {
+            err(`upgrade error: ${exc.message}\n`);
+        }
+        else if (fullEntityCutoverApply) {
+            err(`upgrade error: ${exc.message}. Rerun the same upgrade command to continue forward.\n`);
+        }
+        else {
+            err(`upgrade error: ${exc.message}\n`);
+        }
         return 2;
     }
+    if (fullEntityCutoverApply) {
+        const applyExit = upgradeExitCode(plan);
+        const verification = (dependencies.verifyOneWayUpgrade ?? verifyOneWayUpgrade)(toVerifyContext(args));
+        const authorityActive = entityAuthorityConfirmedActive(plan.project);
+        const verificationPassed = verification.state_validation.status === "passed"
+            && verification.startup_validation.status === "passed";
+        out(renderOneWayResult(verification, applyExit === 0 && authorityActive, (args.format ?? "text") === "json"));
+        if (applyExit !== 0 || !authorityActive || !verificationPassed) {
+            if (!authorityActive) {
+                err("Recover the tracked v2 checkout with Git and retry; no v3 authority was activated.\n");
+            }
+            else {
+                const unresolved = plan.phases
+                    .filter((phase) => ["runtime", "cleanup", "lifecycle"].includes(phase.name))
+                    .flatMap((phase) => phase.items)
+                    .find((item) => item.status === "blocked" || item.status === "failed");
+                if (unresolved) {
+                    const unresolvedPath = unresolved.source ?? unresolved.target ?? unresolved.action;
+                    err(`action-required after entity activation: ${unresolvedPath}: ${unresolved.message}. Rerun the same upgrade command to continue forward.\n`);
+                }
+                else {
+                    err("Rerun the same upgrade command to continue forward; verification is read-only and no completed effect was reversed.\n");
+                }
+            }
+            return 1;
+        }
+        return 0;
+    }
     if ((args.format ?? "text") === "json") {
         out(JSON.stringify(sortKeysDeep(plan), null, 2) + "\n");
     }
     else {
         out(renderUpgradePlan(plan));
     }
-    return upgradeExitCode(plan);
+    let exit = upgradeExitCode(plan);
+    if (args.verify && orchestratorArgs.yes) {
+        let result;
+        try {
+            result = verifyUpgrade(toVerifyContext(args));
+        }
+        catch (exc) {
+            err(`upgrade error: ${exc.message}\n`);
+            return 2;
+        }
+        err(renderVerifySummary(result, false));
+        if (!result.passed)
+            exit = 1;
+    }
+    return exit;
 }
+import path from "node:path";
 //# sourceMappingURL=upgrade.js.map