agentera 3.0.0-dev.1 → 3.0.0-dev.11

package/dist/upgrade/projectIntegration.js

@@ -0,0 +1,233 @@
+import { expanduser, isFile, resolvePath } from "../core/paths.js";
+import { isNpxBundleRoot } from "../core/sourceRoot.js";
+import { APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE, } from "./doctor.js";
+import { resolveNpxPlatformStatus } from "./npxPlatformStatus.js";
+import { classifyInstall, crossMajorBoundaryApplies } from "./compatibility.js";
+import { resolveInvokedUpdateChannel } from "./channels.js";
+import fs from "node:fs";
+import { detectV1ArtifactPairs, planRuntimeRewirePhase, } from "./migrateArtifactsV2ToV3.js";
+import { projectHasProjectLevelRuntimeHooks, textUsesPythonManagedEntrypoint, } from "./runtimeMigration.js";
+import { isStableSuccessorAnnounced } from "./nextMajorDoctor.js";
+import { buildUpgradeCommands } from "./upgradeCommands.js";
+import { classifyIntegrationScenario, integrationScenarioMessage, integrationScenarioRecommendation, } from "./projectIntegrationDecision.js";
+import { classifyUpgradeOutcome, parseSemverMajor, resolveRunningVersion, shouldIncludeCrossMajorPlanItems, } from "./versionResolution.js";
+const MAJOR_BOUNDARY_BLOCK_MESSAGE_PREFIX = "v3 successor line is not announced yet; v2 managed app files remain current on the";
+function majorBoundaryBlockMessage(channelName) {
+    const label = channelName.trim() || "current";
+    return `${MAJOR_BOUNDARY_BLOCK_MESSAGE_PREFIX} ${label} channel`;
+}
+function migrationContext(args, channel) {
+    const home = resolvePath(expanduser(args.home));
+    const env = { ...(args.env ?? process.env), HOME: home };
+    return {
+        appHome: args.installRoot,
+        project: resolvePath(args.project),
+        home,
+        sourceRoot: args.sourceRoot,
+        channel: args.channel ?? channel.channel,
+        env,
+    };
+}
+function isPendingRuntimeMigrationItem(item) {
+    if (item.status !== "pending" || item.action === "configure") {
+        return false;
+    }
+    if (item.action === "rewire-runtime") {
+        if (!item.source) {
+            return false;
+        }
+        try {
+            return textUsesPythonManagedEntrypoint(fs.readFileSync(item.source, "utf8"));
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+function isGlobalStaleRuntimeItem(item, ctx) {
+    const homeRoot = resolvePath(ctx.home);
+    if (!item.source?.startsWith(homeRoot)) {
+        return false;
+    }
+    if (item.action === "rewire-runtime" || item.action === "retire-hooks") {
+        return true;
+    }
+    if (item.action === "copy-plugin" && item.target) {
+        try {
+            if (isFile(item.target)) {
+                return textUsesPythonManagedEntrypoint(fs.readFileSync(item.target, "utf8"));
+            }
+            return item.source ? textUsesPythonManagedEntrypoint(fs.readFileSync(item.source, "utf8")) : false;
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+export function pendingRuntimeMigrationItems(ctx) {
+    const phase = planRuntimeRewirePhase(ctx);
+    const projectRoot = resolvePath(ctx.project);
+    const hasProjectHooks = projectHasProjectLevelRuntimeHooks(ctx.project);
+    return phase.items.filter((item) => {
+        if (item.status !== "pending" || item.action === "configure") {
+            return false;
+        }
+        if (hasProjectHooks) {
+            return (item.source?.startsWith(projectRoot) ?? false) && isPendingRuntimeMigrationItem(item);
+        }
+        return isGlobalStaleRuntimeItem(item, ctx);
+    });
+}
+function appNeedsUpgrade(bundleStatus) {
+    return (bundleStatus === APP_OUTDATED ||
+        bundleStatus === APP_REPAIR_NEEDED ||
+        bundleStatus === APP_MIGRATION_NEEDED);
+}
+function resolveIntegrationTargets(args) {
+    if (!isNpxBundleRoot(args.sourceRoot)) {
+        return {
+            installRoot: args.installRoot,
+            bundleStatus: args.bundleStatus,
+            crossMajorBoundary: args.crossMajorBoundary ?? false,
+            crossMajorBoundaryDetected: args.crossMajorBoundaryDetected ?? false,
+        };
+    }
+    const { platformRoot, platformStatus } = resolveNpxPlatformStatus({
+        home: args.home,
+        sourceRoot: args.sourceRoot,
+        project: args.project,
+        env: args.env,
+    });
+    return {
+        installRoot: platformRoot,
+        bundleStatus: args.bundleStatus,
+        platformBundleStatus: platformStatus.status,
+        crossMajorBoundary: Boolean(platformStatus.crossMajorBoundary),
+        crossMajorBoundaryDetected: Boolean(platformStatus.crossMajorBoundaryDetected),
+    };
+}
+function commandChannel(args, channel, crossMajor, upgradeOutcome) {
+    if (crossMajor && !shouldIncludeCrossMajorPlanItems(channel, upgradeOutcome)) {
+        return resolveInvokedUpdateChannel({
+            channel: "development",
+            env: args.env,
+            home: args.home,
+            sourceRoot: args.sourceRoot,
+        });
+    }
+    return channel;
+}
+export function summarizeProjectIntegration(args) {
+    const channel = resolveInvokedUpdateChannel({
+        channel: args.channel ?? null,
+        env: args.env,
+        home: args.home,
+        sourceRoot: args.sourceRoot,
+    });
+    const integrationTargets = resolveIntegrationTargets(args);
+    const install = classifyInstall({ appHome: integrationTargets.installRoot, sourceRoot: args.sourceRoot });
+    const crossMajorDetected = args.crossMajorBoundaryDetected ??
+        crossMajorBoundaryApplies(install, args.sourceRoot);
+    const successorAnnounced = isStableSuccessorAnnounced(args.sourceRoot, "stable");
+    const crossMajor = crossMajorDetected && successorAnnounced;
+    const runningMajor = parseSemverMajor(resolveRunningVersion({
+        appHome: integrationTargets.installRoot,
+        sourceRoot: args.sourceRoot,
+        install,
+    })) ?? 0;
+    if (crossMajorDetected && !successorAnnounced && runningMajor > 0 && runningMajor < 3) {
+        const blockMessage = majorBoundaryBlockMessage(channel.channel);
+        return {
+            recommendation: "stay",
+            message: blockMessage,
+            pending_runtime: 0,
+            pending_runtimes: [],
+            pending_artifacts: 0,
+            dry_run_command: null,
+            apply_command: null,
+            update_channel: channel.channel,
+            major_boundary_block: blockMessage,
+        };
+    }
+    const upgradeOutcome = classifyUpgradeOutcome({
+        appHome: integrationTargets.installRoot,
+        sourceRoot: args.sourceRoot,
+        install,
+        channel,
+    });
+    const ctx = migrationContext({ ...args, installRoot: integrationTargets.installRoot }, channel);
+    const v1Artifacts = detectV1ArtifactPairs(args.project);
+    const pending = pendingRuntimeMigrationItems(ctx);
+    const pendingRuntimes = [
+        ...new Set(pending.map((item) => item.runtime).filter((runtime) => Boolean(runtime))),
+    ];
+    const crossMajorMigration = crossMajor && shouldIncludeCrossMajorPlanItems(channel, upgradeOutcome);
+    const crossMajorNeedsPreview = crossMajor && !crossMajorMigration;
+    const isNpx = isNpxBundleRoot(args.sourceRoot);
+    const classificationBundleStatus = isNpx && integrationTargets.platformBundleStatus !== undefined
+        ? integrationTargets.platformBundleStatus
+        : integrationTargets.bundleStatus;
+    const needsAppUpgrade = isNpx && integrationTargets.bundleStatus === APP_UP_TO_DATE
+        ? appNeedsUpgrade(integrationTargets.platformBundleStatus ?? APP_UP_TO_DATE) &&
+            pending.length === 0 &&
+            v1Artifacts.length === 0
+        : appNeedsUpgrade(classificationBundleStatus);
+    const facts = {
+        bundleStatus: classificationBundleStatus,
+        pendingRuntimeCount: pending.length,
+        pendingArtifactCount: v1Artifacts.length,
+        crossMajor,
+        crossMajorMigration,
+        crossMajorNeedsPreview,
+        needsAppUpgrade,
+    };
+    const scenario = classifyIntegrationScenario(facts);
+    const recommendation = integrationScenarioRecommendation(scenario);
+    const message = integrationScenarioMessage(scenario, facts);
+    if (recommendation === "stay") {
+        return {
+            recommendation: "stay",
+            message,
+            pending_runtime: 0,
+            pending_runtimes: [],
+            pending_artifacts: 0,
+            dry_run_command: null,
+            apply_command: null,
+            update_channel: channel.channel,
+            major_boundary_block: null,
+        };
+    }
+    const cmdsChannel = commandChannel(args, channel, crossMajor, upgradeOutcome);
+    const cmds = buildUpgradeCommands({
+        project: args.project,
+        installRoot: null,
+        channel: cmdsChannel,
+        only: null,
+        cwdDefault: true,
+    });
+    return {
+        recommendation: "upgrade",
+        message,
+        pending_runtime: pendingRuntimes.length,
+        pending_runtimes: pendingRuntimes,
+        pending_artifacts: v1Artifacts.length,
+        dry_run_command: cmds.dryRunCommand,
+        apply_command: cmds.applyCommand,
+        update_channel: cmdsChannel.channel,
+        upgrade_only: undefined,
+        major_boundary_block: null,
+    };
+}
+export function projectIntegrationAttention(summary) {
+    if (summary.recommendation === "stay") {
+        return null;
+    }
+    const preview = summary.dry_run_command ? `\`${summary.dry_run_command}\`` : "the preview command";
+    const prefix = summary.pending_artifacts > 0 || summary.pending_runtime > 0
+        ? "normal"
+        : "degraded";
+    return `${prefix}: ${summary.message} Preview ${preview}.`;
+}
+//# sourceMappingURL=projectIntegration.js.map

package/dist/upgrade/projectIntegration.js.map

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

package/dist/upgrade/projectIntegrationDecision.js

@@ -0,0 +1,42 @@
+import { APP_MANUAL_REVIEW_NEEDED, APP_UP_TO_DATE } from "./doctor.js";
+export function classifyIntegrationScenario(facts) {
+    if (facts.pendingRuntimeCount === 0 &&
+        facts.pendingArtifactCount === 0 &&
+        !facts.crossMajor &&
+        !facts.crossMajorMigration &&
+        !facts.crossMajorNeedsPreview &&
+        (facts.bundleStatus === APP_UP_TO_DATE || facts.bundleStatus === APP_MANUAL_REVIEW_NEEDED)) {
+        return "stay";
+    }
+    if (facts.crossMajorNeedsPreview) {
+        return "blocked";
+    }
+    return "upgrade";
+}
+export function integrationScenarioRecommendation(scenario) {
+    if (scenario === "stay")
+        return "stay";
+    if (scenario === "blocked")
+        return "stay";
+    return "upgrade";
+}
+export function integrationScenarioMessage(scenario, facts) {
+    if (scenario === "stay")
+        return "Your Agentera install is up to date.";
+    if (scenario === "blocked") {
+        return "Cross-major version boundary detected; v3 successor not yet announced. Stay on the current channel.";
+    }
+    const reasons = [];
+    if (facts.pendingRuntimeCount > 0)
+        reasons.push("runtime wiring needs sync");
+    if (facts.pendingArtifactCount > 0)
+        reasons.push("v1 artifacts need migration");
+    if (facts.needsAppUpgrade)
+        reasons.push("app bundle needs update");
+    if (facts.crossMajorMigration)
+        reasons.push("cross-major version migration needed");
+    if (reasons.length === 0)
+        reasons.push("project changes pending");
+    return `This project needs an Agentera upgrade (${reasons.join(", ")}). Preview the upgrade command.`;
+}
+//# sourceMappingURL=projectIntegrationDecision.js.map

package/dist/upgrade/projectIntegrationDecision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectIntegrationDecision.js","sourceRoot":"","sources":["../../src/upgrade/projectIntegrationDecision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAcvE,MAAM,UAAU,2BAA2B,CAAC,KAA+B;IACzE,IACE,KAAK,CAAC,mBAAmB,KAAK,CAAC;QAC/B,KAAK,CAAC,oBAAoB,KAAK,CAAC;QAChC,CAAC,KAAK,CAAC,UAAU;QACjB,CAAC,KAAK,CAAC,mBAAmB;QAC1B,CAAC,KAAK,CAAC,sBAAsB;QAC7B,CAAC,KAAK,CAAC,YAAY,KAAK,cAAc,IAAI,KAAK,CAAC,YAAY,KAAK,wBAAwB,CAAC,EAC1F,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,QAA6B;IAC7E,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC1C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAA6B,EAC7B,KAA+B;IAE/B,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,sCAAsC,CAAC;IACvE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,qGAAqG,CAAC;IAC/G,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,mBAAmB;QAAE,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAClE,OAAO,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,CAAC;AACxG,CAAC"}