agentera 3.0.0-dev.2 → 3.0.0-dev.20

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

@@ -0,0 +1,121 @@
+/**
+ * `state todo` query (TODO.md).
+ *
+ * Reads TODO.md, partitions entries by severity band (using the
+ * protocol glyphs as the section heading), and reports each entry
+ * with its severity, status, and description. Supports both the
+ * legacy structured YAML shape and the current markdown layout.
+ */
+import fs from "node:fs";
+import { emitStateStructured, extractEntries, filterByFieldValue, formatEntry, loadArtifact, printStatusCounts, sourceMetadata, statusCounts, structuredState, } from "../../stateQuery.js";
+import { artifactPath } from "../../appContext.js";
+import { isResolvedTodoMarkdownStatus, parseTodoMarkdownListItem } from "../../todoMarkdown.js";
+import { TODO_SEVERITY_ORDER_KEYS } from "../../todoSeverity.js";
+import { out, err } from "./shared.js";
+const TODO_SEV_GLYPHS = {
+    critical: "⇶",
+    degraded: "⇉",
+    warning: "⇉",
+    normal: "→",
+    info: "⇢",
+    annoying: "⇢",
+};
+export function normalizeSeverity(value, deflt = "normal") {
+    const text = String(value || deflt).toLowerCase();
+    for (const key of TODO_SEVERITY_ORDER_KEYS) {
+        if (text.includes(key))
+            return key;
+    }
+    return deflt;
+}
+export function queryTodo(args, schemas, io, openOnly = false) {
+    const o = out(io);
+    const info = schemas.todo ?? { path: "TODO.md", record: undefined, schema: {}, fields: {} };
+    const todoPath = artifactPath(info, "todo");
+    const severity = args.severity ?? null;
+    const status = args.status ?? null;
+    const format = args.format ?? "text";
+    if (!fs.existsSync(todoPath)) {
+        if (format !== "text") {
+            return emitStateStructured("todo", structuredState("todo", [], sourceMetadata("todo", todoPath), {
+                filters: { severity, status },
+            }), format, args.fields, o, err(io));
+        }
+        return 0;
+    }
+    const data = loadArtifact(todoPath);
+    let entries = extractEntries(data);
+    if (entries.length > 0) {
+        if (severity)
+            entries = filterByFieldValue(entries, "severity", severity);
+        if (status)
+            entries = filterByFieldValue(entries, "status", status);
+        if (openOnly) {
+            entries = entries.filter((entry) => !["done", "closed", "resolved"].includes(String(entry.status ?? "open").toLowerCase()));
+        }
+        if (format !== "text") {
+            return emitStateStructured("todo", structuredState("todo", entries, sourceMetadata("todo", todoPath), {
+                filters: { severity, status, open_only: openOnly || null },
+            }), format, args.fields, o, err(io));
+        }
+        printStatusCounts("TODO status", statusCounts(entries), o);
+        for (const entry of entries) {
+            const line = formatEntry(entry, ["severity", "status", "description", "title"]);
+            if (line)
+                o(line + "\n");
+        }
+        return 0;
+    }
+    const text = fs.readFileSync(todoPath, "utf8");
+    const marker = severity ? TODO_SEV_GLYPHS[severity.toLowerCase()] ?? severity : null;
+    let currentSection = null;
+    const markdownEntries = [];
+    for (const rawLine of text.split(/\r\n|\r|\n/)) {
+        const sline = rawLine.trim();
+        if (sline.startsWith("## ")) {
+            const section = sline.slice(3).trim();
+            if (section.toLowerCase().includes("resolved")) {
+                currentSection = null;
+                continue;
+            }
+            currentSection = section;
+            continue;
+        }
+        if (currentSection === null)
+            continue;
+        const parsed = parseTodoMarkdownListItem(sline);
+        if (!parsed)
+            continue;
+        if (marker && !currentSection.includes(marker))
+            continue;
+        const itemStatus = parsed.status;
+        if (openOnly && isResolvedTodoMarkdownStatus(itemStatus))
+            continue;
+        if (status) {
+            const want = status.toLowerCase();
+            const have = itemStatus.toLowerCase();
+            if (want === "open" || want === "todo") {
+                if (isResolvedTodoMarkdownStatus(have))
+                    continue;
+            }
+            else if (have !== want) {
+                continue;
+            }
+        }
+        markdownEntries.push({
+            severity: normalizeSeverity(currentSection),
+            status: itemStatus,
+            description: parsed.description,
+            section: currentSection,
+        });
+        if (format === "text")
+            o(`[${currentSection}] ${parsed.description}\n`);
+    }
+    if (format !== "text") {
+        return emitStateStructured("todo", structuredState("todo", markdownEntries, sourceMetadata("todo", todoPath), {
+            filters: { severity, status, open_only: openOnly || null },
+        }), format, args.fields, o, err(io));
+    }
+    return 0;
+}
+//# sourceMappingURL=todo.js.map

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

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

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

@@ -0,0 +1,341 @@
+import path from "node:path";
+import fs from "node:fs";
+import { emitInvalidInput } from "../../errors.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 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)
+        invalid({
+            class: "invalid_choice",
+            message: `verb "${verb}" does not apply to ${artifact}`,
+            valid_values: verbsForArtifact(artifact),
+        });
+    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);
+    const fields = projectedFields(spec);
+    const byFlag = new Map(fields.map((field) => [field.flag, field]));
+    const values = {};
+    const callerPayload = {};
+    const occurrences = new Map();
+    let format = "text";
+    let projectRoot = process.cwd();
+    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)
+        invalid({
+            class: "mutually_exclusive",
+            message: `--input cannot be combined with field flags for ${artifact} ${verb}`,
+        });
+    for (const field of fields.filter((candidate) => candidate.required)) {
+        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 (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 });
+        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":["../../../../src/cli/commands/state/write.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/upgrade.js

@@ -1,4 +1,9 @@
+import os from "node:os";
+import { expanduser, resolvePath } from "../../core/paths.js";
+import { resolveDoctorInstallRoot, resolveSourceRootStrict } from "../../upgrade/appModel.js";
 import { buildUpgradePlan, renderUpgradePlan, sortKeysDeep, upgradeExitCode, validateUpgradeApply, } from "../../upgrade/upgradeOrchestrator.js";
+import { restoreFromSnapshot } from "../../upgrade/upgradeSnapshot.js";
+import { renderRestoreSummary, renderVerifySummary, verifyUpgrade, } from "./upgradeVerify.js";
 /** Canonical stable-channel update entry point. */
 export const UPGRADE_COMMAND = "npx -y agentera@latest";
 function toOrchestratorArgs(args) {
@@ -11,6 +16,16 @@ 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,
+    };
+}
+function toVerifyContext(args) {
+    return {
+        installRoot: args.installRoot ?? null,
+        home: args.home ?? null,
+        project: args.project ?? null,
+        expectedVersion: args.expectedVersion ?? null,
     };
 }
 export function cmdUpgrade(args, io = {}) {
@@ -21,6 +36,55 @@ export function cmdUpgrade(args, io = {}) {
         err("upgrade error: --yes and --dry-run are mutually exclusive\n");
         return 2;
     }
+    if ((orchestratorArgs.runtime || orchestratorArgs.legacyCleanup)
+        && orchestratorArgs.only
+        && orchestratorArgs.only.length > 0) {
+        err("upgrade error: --only cannot be combined with --runtime or --legacy-cleanup; lifecycle preview must include the complete app phase\n");
+        return 2;
+    }
+    if (args.restore && (orchestratorArgs.yes
+        || orchestratorArgs.dryRun
+        || args.verify
+        || orchestratorArgs.runtime
+        || orchestratorArgs.legacyCleanup)) {
+        err("upgrade error: --restore is mutually exclusive with --yes, --dry-run, --verify, --runtime, and --legacy-cleanup\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.runtime || orchestratorArgs.legacyCleanup)) {
+        err("upgrade error: lifecycle selection with --verify requires --yes; preview lifecycle work with --dry-run instead\n");
+        return 2;
+    }
+    if (args.restore) {
+        let installRoot;
+        try {
+            const sourceRoot = resolveSourceRootStrict();
+            const home = resolvePath(expanduser(args.home ?? os.homedir()));
+            [installRoot] = resolveDoctorInstallRoot(args.installRoot ?? null, { home, sourceRoot });
+        }
+        catch (exc) {
+            err(`upgrade error: ${exc.message}\n`);
+            return 2;
+        }
+        const result = restoreFromSnapshot(installRoot);
+        out(renderRestoreSummary(installRoot, result));
+        return 0;
+    }
+    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;
     try {
         if (orchestratorArgs.yes) {
@@ -43,6 +107,20 @@ export function cmdUpgrade(args, io = {}) {
     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;
 }
 //# sourceMappingURL=upgrade.js.map

package/dist/cli/commands/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,oBAAoB,GAGrB,MAAM,sCAAsC,CAAC;AAiB9C,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD,SAAS,kBAAkB,CAAC,IAAiB;IAC3C,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;QACtB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC1D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,KAAS,EAAE;IACvD,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAElD,IAAI,gBAAgB,CAAC,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACpD,GAAG,CAAC,6DAA6D,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,MAAM,UAAU,GAAG,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACnE,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,kBAAkB,UAAU,IAAI,CAAC,CAAC;gBACtC,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,kBAAmB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,oBAAoB,GAGrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAqB5B,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD,SAAS,kBAAkB,CAAC,IAAiB;IAC3C,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;QACtB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC1D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAiB;IACxC,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,KAAS,EAAE;IACvD,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAElD,IAAI,gBAAgB,CAAC,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACpD,GAAG,CAAC,6DAA6D,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IACE,CAAC,gBAAgB,CAAC,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC;WACzD,gBAAgB,CAAC,IAAI;WACrB,gBAAgB,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EACnC,CAAC;QACD,GAAG,CAAC,sIAAsI,CAAC,CAAC;QAC5I,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,IAAI,CAClB,gBAAgB,CAAC,GAAG;WACjB,gBAAgB,CAAC,MAAM;WACvB,IAAI,CAAC,MAAM;WACX,gBAAgB,CAAC,OAAO;WACxB,gBAAgB,CAAC,aAAa,CAClC,EAAE,CAAC;QACF,GAAG,CAAC,mHAAmH,CAAC,CAAC;QACzH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,6DAA6D,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAC1C,gBAAgB,CAAC,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAC3D,EAAE,CAAC;QACF,GAAG,CAAC,kHAAkH,CAAC,CAAC;QACxH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,uBAAuB,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAChE,CAAC,WAAW,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,kBAAmB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAChD,GAAG,CAAC,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,kBAAmB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;QACrE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,MAAM,UAAU,GAAG,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACnE,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,kBAAkB,UAAU,IAAI,CAAC,CAAC;gBACtC,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,kBAAmB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,kBAAmB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,IAAI,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}