agentera 3.0.0-dev.6 → 3.0.0-next.1

package/dist/upgrade/doctorClassifier.js

@@ -0,0 +1,208 @@
+import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, } from "./doctor.js";
+import { inProcessProbe } from "./cliProbe.js";
+function blockedRootRecoveryMessage(_rootSource) {
+    return "choose a different Agentera directory, or use --force only if you checked this directory and want Agentera to replace files there";
+}
+function recoverableStaleDefaultSignal(appHome, roots) {
+    return {
+        status: APP_REPAIR_NEEDED,
+        kind: "recoverable_stale_default",
+        message: "Agentera found an old app directory and can repair it without asking you to edit shell settings",
+        deprecatedDefaultAppHome: appHome,
+        managedAppRoot: roots.managedAppRoot,
+    };
+}
+function userDataOnlySignal(appHome, roots) {
+    return {
+        status: APP_REPAIR_NEEDED,
+        kind: "user_data_only_app_home",
+        message: "This Agentera directory only has your Agentera data, so Agentera can safely add fresh app files under app/",
+        appHome,
+        managedAppRoot: roots.managedAppRoot,
+    };
+}
+function classifyMissingDefault(_ctx) {
+    return {
+        rootStatus: "missing",
+        blocked: false,
+        signals: [
+            {
+                status: APP_REPAIR_NEEDED,
+                kind: "missing_bundle",
+                message: "Agentera is not installed in the normal directory yet",
+            },
+        ],
+    };
+}
+function classifyMissingExplicitOrEnvironment(ctx) {
+    if (ctx.recoverableStaleDefault) {
+        return {
+            rootStatus: "missing",
+            blocked: false,
+            signals: [recoverableStaleDefaultSignal(ctx.installRoot, ctx.roots)],
+        };
+    }
+    return {
+        rootStatus: "missing",
+        blocked: true,
+        signals: [
+            {
+                status: APP_MANUAL_REVIEW_NEEDED,
+                kind: "invalid_install_root",
+                message: "Agentera was told to use a directory that does not exist. " +
+                    "Choose an existing Agentera directory, or install into the normal Agentera directory.",
+            },
+        ],
+    };
+}
+function classifyFileValuedRoot(ctx) {
+    return {
+        rootStatus: "invalid",
+        blocked: true,
+        signals: [
+            {
+                status: APP_MANUAL_REVIEW_NEEDED,
+                kind: "invalid_install_root",
+                message: `Agentera was told to use a file instead of a directory; ${blockedRootRecoveryMessage(ctx.rootSource)}`,
+            },
+        ],
+    };
+}
+function classifyInvalidBundle(ctx) {
+    if (ctx.recoverableStaleDefault) {
+        return {
+            rootStatus: "stale_default",
+            blocked: false,
+            signals: [recoverableStaleDefaultSignal(ctx.installRoot, ctx.roots)],
+        };
+    }
+    return {
+        rootStatus: "invalid",
+        blocked: true,
+        signals: [
+            {
+                status: APP_MANUAL_REVIEW_NEEDED,
+                kind: "invalid_bundle",
+                message: `This directory looks like a broken Agentera install; ${blockedRootRecoveryMessage(ctx.rootSource)}`,
+            },
+        ],
+    };
+}
+function classifyUnmanagedDirectory(ctx) {
+    if (ctx.recoverableStaleDefault) {
+        return {
+            rootStatus: "stale_default",
+            blocked: false,
+            signals: [recoverableStaleDefaultSignal(ctx.installRoot, ctx.roots)],
+        };
+    }
+    if (ctx.userDataOnly) {
+        return {
+            rootStatus: "user_data_only",
+            blocked: false,
+            signals: [userDataOnlySignal(ctx.installRoot, ctx.roots)],
+        };
+    }
+    return {
+        rootStatus: "unmanaged",
+        blocked: true,
+        signals: [
+            {
+                status: APP_MANUAL_REVIEW_NEEDED,
+                kind: "unmanaged_install_root",
+                message: `This directory already has files Agentera does not recognize, so Agentera will not change it automatically; ${blockedRootRecoveryMessage(ctx.rootSource)}`,
+            },
+        ],
+    };
+}
+function appendManagedStaleSignals(ctx, signals) {
+    const reason = ctx.classification.diagnostic.evidence.reason;
+    if (ctx.classification.kind !== "managed_stale") {
+        return;
+    }
+    if (reason === "missing_marker") {
+        if (ctx.recoverableStaleDefault) {
+            signals.push(recoverableStaleDefaultSignal(ctx.installRoot, ctx.roots));
+        }
+        signals.push({
+            status: APP_REPAIR_NEEDED,
+            kind: "missing_marker",
+            message: "Agentera app files need repair",
+        });
+    }
+    else if (reason === "version_mismatch") {
+        if (ctx.recoverableStaleDefault) {
+            signals.push(recoverableStaleDefaultSignal(ctx.installRoot, ctx.roots));
+        }
+        signals.push({
+            status: APP_OUTDATED,
+            kind: "version_mismatch",
+            expected: ctx.expected,
+            actual: ctx.markerVersion,
+            message: "Agentera app files are valid but need an update to the expected version",
+        });
+    }
+}
+function appendCliProbeSignals(ctx, signals) {
+    const probe = ctx.probeCli
+        ? (ctx.probeRunner ?? inProcessProbe)({
+            bundleRoot: ctx.roots.activeBundleRoot,
+            appHome: ctx.installRoot,
+            project: ctx.project,
+            expectedCommands: ctx.expectedCommands,
+        })
+        : { ok: true };
+    if (probe.ok) {
+        return;
+    }
+    let kind = "cli_probe_unavailable";
+    if (probe.returnCode !== null && probe.returnCode !== undefined && probe.returnCode !== 0) {
+        kind = "cli_probe_failed";
+    }
+    else if (probe.missingCommands && probe.missingCommands.length > 0) {
+        kind = "missing_command";
+    }
+    signals.push({
+        status: APP_REPAIR_NEEDED,
+        kind,
+        message: probe.message,
+        returnCode: probe.returnCode ?? null,
+        missingCommands: probe.missingCommands ?? [],
+        stdoutTail: probe.stdoutTail ?? [],
+        stderrTail: probe.stderrTail ?? [],
+    });
+}
+function classifyManaged(ctx) {
+    const signals = [];
+    if (ctx.legacyBundleRoot) {
+        signals.push({
+            status: APP_MIGRATION_NEEDED,
+            kind: APP_MIGRATION_NEEDED,
+            message: "Agentera app files are in the old place and can be moved into app/",
+            legacyBundleRoot: ctx.installRoot,
+            managedAppRoot: ctx.roots.managedAppRoot,
+        });
+    }
+    appendManagedStaleSignals(ctx, signals);
+    appendCliProbeSignals(ctx, signals);
+    return {
+        rootStatus: "managed",
+        blocked: false,
+        signals,
+    };
+}
+const ROOT_CLASSIFIERS = {
+    missing_default: classifyMissingDefault,
+    missing_explicit_or_environment: classifyMissingExplicitOrEnvironment,
+    file_valued_root: classifyFileValuedRoot,
+    invalid_bundle: classifyInvalidBundle,
+    unmanaged_directory: classifyUnmanagedDirectory,
+    managed_fresh: classifyManaged,
+    managed_stale: classifyManaged,
+};
+export function classifyInstallRootStatus(ctx) {
+    const kind = ctx.classification.kind;
+    const classifier = ROOT_CLASSIFIERS[kind] ?? classifyManaged;
+    return classifier(ctx);
+}
+//# sourceMappingURL=doctorClassifier.js.map

package/dist/upgrade/doctorClassifier.js.map

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

package/dist/upgrade/migrateArtifactsV2ToV3.js

@@ -9,7 +9,7 @@ import { appHomeHasUnrecognizedEntriesWithPreflight, resolveMigrationUserStatePr
 import { applyRuntimeMigrationItems, planRuntimeMigrationItems, resolveNpxHookCommands, rewireRuntimeText, } from "./runtimeMigration.js";
 /**
  * v2→v3 migration phases: artifacts (noop for YAML), runtime rewire, cleanup.
- * v1 Markdown→YAML migration stays separate (prime.ts V1_ARTIFACT_PAIRS).
+ * v1 Markdown→YAML migration uses detectV1ArtifactPairs (shared with prime).
  */
 export const MIGRATION_STATUSES = ["pending", "applied", "noop", "blocked", "failed", "skipped"];
 export const V1_ARTIFACT_PAIRS = [

package/dist/upgrade/nextMajorDoctor.js

@@ -58,12 +58,16 @@ let testSuccessorAnnouncedOverride = null;
 export function setSuccessorAnnouncedOverrideForTests(value) {
     testSuccessorAnnouncedOverride = value;
 }
-/** True when stable-channel successor metadata exists and is announced for doctor/prime. */
-export function isStableSuccessorAnnounced(sourceRoot) {
+/**
+ * True when the resolved channel's successor metadata exists and is announced
+ * for doctor/prime. Defaults to the stable channel so legacy callers that
+ * omit the argument behave identically to pre-fix behavior.
+ */
+export function isStableSuccessorAnnounced(sourceRoot, channel = "stable") {
     if (testSuccessorAnnouncedOverride !== null) {
         return testSuccessorAnnouncedOverride;
     }
-    const block = loadChannelNextMajor(sourceRoot, "stable");
+    const block = loadChannelNextMajor(sourceRoot, channel);
     return block?.announced === true;
 }
 export function loadChannelNextMajor(sourceRoot, channel) {

package/dist/upgrade/nextMajorDoctor.js.map

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

package/dist/upgrade/npxPlatformStatus.js

@@ -0,0 +1,24 @@
+import { expanduser } from "../core/paths.js";
+import { resolvePlatformAppHome } from "./appModel.js";
+import { buildDoctorStatus } from "./doctor.js";
+/** Shared npx platform app-home resolution for prime and projectIntegration. */
+export function resolveNpxPlatformStatus(opts) {
+    const env = { ...process.env, ...(opts.env ?? {}), HOME: expanduser(opts.home) };
+    const platformRoot = resolvePlatformAppHome(opts.home, env);
+    const doctorOpts = {
+        rootSource: "default",
+        sourceRoot: opts.sourceRoot,
+        home: opts.home,
+        project: opts.project,
+        expectedCommands: opts.expectedCommands ?? ["prime"],
+        probeCli: false,
+        skipNpxBundleShortCircuit: true,
+        env,
+    };
+    if (opts.expectedVersion !== undefined) {
+        doctorOpts.expectedVersion = opts.expectedVersion;
+    }
+    const platformStatus = buildDoctorStatus(platformRoot, doctorOpts);
+    return { platformRoot, platformStatus };
+}
+//# sourceMappingURL=npxPlatformStatus.js.map

package/dist/upgrade/npxPlatformStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npxPlatformStatus.js","sourceRoot":"","sources":["../../src/upgrade/npxPlatformStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAiC,MAAM,aAAa,CAAC;AAiB/E,gFAAgF;AAChF,MAAM,UAAU,wBAAwB,CACtC,IAAqC;IAErC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACjF,MAAM,YAAY,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,UAAU,GAA6B;QAC3C,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC;QACpD,QAAQ,EAAE,KAAK;QACf,yBAAyB,EAAE,IAAI;QAC/B,GAAG;KACJ,CAAC;IACF,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACvC,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;IACpD,CAAC;IACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AAC1C,CAAC"}

package/dist/upgrade/projectIntegration.js

@@ -1,15 +1,17 @@
 import { expanduser, isFile, resolvePath } from "../core/paths.js";
 import { isNpxBundleRoot } from "../core/sourceRoot.js";
-import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE, buildDoctorStatus, } from "./doctor.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 { resolvePlatformAppHome } from "./appModel.js";
-import { buildUpgradeCommands } from "./upgradeCommands.js";
 import { isStableSuccessorAnnounced } from "./nextMajorDoctor.js";
+import { buildUpgradeCommands } from "./upgradeCommands.js";
+import { classifyIntegrationScenario, integrationScenarioMessage, integrationScenarioNeedsInstallRoot, integrationScenarioOnlyPhases, integrationScenarioRecommendation, } from "./projectIntegrationDecision.js";
 import { classifyUpgradeOutcome, shouldIncludeCrossMajorPlanItems, } from "./versionResolution.js";
+const MAJOR_BOUNDARY_BLOCK_MESSAGE = "v3 successor line is not announced yet; v2 managed app files remain current on the stable channel";
 function migrationContext(args, channel) {
     const home = resolvePath(expanduser(args.home));
     const env = { ...(args.env ?? process.env), HOME: home };
@@ -117,20 +119,16 @@ function resolveIntegrationTargets(args) {
             crossMajorBoundary: args.crossMajorBoundary ?? false,
         };
     }
-    const platformRoot = resolvePlatformAppHome(args.home, args.env);
-    const platformStatus = buildDoctorStatus(platformRoot, {
-        rootSource: "default",
-        sourceRoot: args.sourceRoot,
+    const { platformRoot, platformStatus } = resolveNpxPlatformStatus({
         home: args.home,
+        sourceRoot: args.sourceRoot,
         project: args.project,
-        expectedCommands: ["prime"],
-        probeCli: false,
-        skipNpxBundleShortCircuit: true,
         env: args.env,
     });
     return {
         installRoot: platformRoot,
         bundleStatus: args.bundleStatus,
+        platformBundleStatus: platformStatus.status,
         crossMajorBoundary: Boolean(platformStatus.crossMajorBoundary),
     };
 }
@@ -157,7 +155,21 @@ export function summarizeProjectIntegration(args) {
     const crossMajorDetected = args.crossMajorBoundary ??
         integrationTargets.crossMajorBoundary ??
         crossMajorBoundaryApplies(install, args.sourceRoot);
-    const crossMajor = crossMajorDetected && isStableSuccessorAnnounced(args.sourceRoot);
+    const successorAnnounced = isStableSuccessorAnnounced(args.sourceRoot, channel.channel);
+    const crossMajor = crossMajorDetected && successorAnnounced;
+    if (crossMajorBoundaryApplies(install, args.sourceRoot) && !successorAnnounced) {
+        return {
+            recommendation: "stay",
+            message: MAJOR_BOUNDARY_BLOCK_MESSAGE,
+            pending_runtime: 0,
+            pending_runtimes: [],
+            pending_artifacts: 0,
+            dry_run_command: null,
+            apply_command: null,
+            update_channel: channel.channel,
+            major_boundary_block: MAJOR_BOUNDARY_BLOCK_MESSAGE,
+        };
+    }
     const upgradeOutcome = classifyUpgradeOutcome({
         appHome: integrationTargets.installRoot,
         sourceRoot: args.sourceRoot,
@@ -172,56 +184,47 @@ export function summarizeProjectIntegration(args) {
     ];
     const crossMajorMigration = crossMajor && shouldIncludeCrossMajorPlanItems(channel, upgradeOutcome);
     const crossMajorNeedsPreview = crossMajor && !crossMajorMigration;
-    const needsAppUpgrade = isNpxBundleRoot(args.sourceRoot) && args.bundleStatus === APP_UP_TO_DATE
-        ? false
-        : appNeedsUpgrade(integrationTargets.bundleStatus);
-    const artifactsOnly = v1Artifacts.length > 0 && !crossMajorMigration && !crossMajorNeedsPreview && !needsAppUpgrade;
-    const runtimeOnly = pending.length > 0 &&
-        !artifactsOnly &&
-        !crossMajorMigration &&
-        !crossMajorNeedsPreview &&
-        !needsAppUpgrade;
-    if (integrationTargets.bundleStatus === APP_MANUAL_REVIEW_NEEDED &&
-        pending.length === 0 &&
-        v1Artifacts.length === 0 &&
-        !crossMajor) {
-        return {
-            recommendation: "stay",
-            message: "Agentera needs manual review for your app directory before this project can be upgraded safely.",
-            pending_runtime: 0,
-            pending_runtimes: [],
-            pending_artifacts: 0,
-            dry_run_command: null,
-            apply_command: null,
-            update_channel: channel.channel,
-        };
-    }
-    if (!artifactsOnly &&
-        !runtimeOnly &&
-        !crossMajorMigration &&
-        !crossMajorNeedsPreview &&
-        !needsAppUpgrade &&
-        integrationTargets.bundleStatus === APP_UP_TO_DATE &&
-        pending.length === 0 &&
-        v1Artifacts.length === 0) {
+    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 scenario = classifyIntegrationScenario({
+        bundleStatus: classificationBundleStatus,
+        pendingRuntimeCount: pending.length,
+        pendingArtifactCount: v1Artifacts.length,
+        crossMajor,
+        crossMajorMigration,
+        crossMajorNeedsPreview,
+        needsAppUpgrade,
+    });
+    const recommendation = integrationScenarioRecommendation(scenario);
+    const message = integrationScenarioMessage(scenario, {
+        projectLevelRuntimeHooks: projectHasProjectLevelRuntimeHooks(args.project),
+        pendingRuntimes,
+    });
+    if (recommendation === "stay") {
         return {
             recommendation: "stay",
-            message: "This project matches your current Agentera install; no upgrade is needed.",
+            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 onlyPhases = artifactsOnly
-        ? ["artifacts"]
-        : runtimeOnly
-            ? ["runtime"]
-            : undefined;
-    const installRootForCommands = crossMajorMigration || crossMajorNeedsPreview || needsAppUpgrade ? integrationTargets.installRoot : null;
+    const onlyPhases = integrationScenarioOnlyPhases(scenario);
+    const installRootForCommands = integrationScenarioNeedsInstallRoot(scenario)
+        ? integrationTargets.installRoot
+        : null;
     const cmds = buildUpgradeCommands({
         project: args.project,
         installRoot: installRootForCommands,
@@ -229,27 +232,6 @@ export function summarizeProjectIntegration(args) {
         only: onlyPhases,
         cwdDefault: true,
     });
-    let message;
-    if (artifactsOnly) {
-        message =
-            "This project still uses v1 Markdown artifacts; preview migrating them to v2 YAML before continuing.";
-    }
-    else if (crossMajorMigration || crossMajorNeedsPreview) {
-        message =
-            "Your Agentera app copy is still on v2 while the CLI is on v3; preview the one-way v2→v3 migration before applying.";
-    }
-    else if (needsAppUpgrade) {
-        message = "Your Agentera app copy is out of date; preview the repair or upgrade before applying.";
-    }
-    else if (pending.length > 0) {
-        const runtimes = pendingRuntimes.length > 0 ? pendingRuntimes.join(", ") : "runtime configs";
-        message = projectHasProjectLevelRuntimeHooks(args.project)
-            ? `This project still uses older Agentera runtime wiring (${runtimes}); preview rewiring hooks to the current npm entrypoint.`
-            : `Your user-level Agentera runtime wiring (${runtimes}) is stale; preview rewiring hooks to the current npm entrypoint.`;
-    }
-    else {
-        message = "Preview Agentera upgrade changes for this project before applying.";
-    }
     return {
         recommendation: "upgrade",
         message,
@@ -260,6 +242,7 @@ export function summarizeProjectIntegration(args) {
         apply_command: cmds.applyCommand,
         update_channel: cmdsChannel.channel,
         upgrade_only: onlyPhases,
+        major_boundary_block: null,
     };
 }
 export function projectIntegrationAttention(summary) {

package/dist/upgrade/projectIntegration.js.map

@@ -1 +1 @@
-{"version":3,"file":"projectIntegration.js","sourceRoot":"","sources":["../../src/upgrade/projectIntegration.ts"],"names":[],"mappings":"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"}
+{"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,93 @@
+import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE } from "./doctor.js";
+export function classifyIntegrationScenario(facts) {
+    const { bundleStatus, pendingRuntimeCount, pendingArtifactCount, crossMajor, crossMajorMigration, crossMajorNeedsPreview, needsAppUpgrade, } = facts;
+    if (bundleStatus === APP_MANUAL_REVIEW_NEEDED &&
+        pendingRuntimeCount === 0 &&
+        pendingArtifactCount === 0 &&
+        !crossMajor) {
+        return "stay_manual_review";
+    }
+    const artifactsOnly = pendingArtifactCount > 0 && !crossMajorMigration && !crossMajorNeedsPreview && !needsAppUpgrade;
+    const runtimeOnly = pendingRuntimeCount > 0 &&
+        !artifactsOnly &&
+        !crossMajorMigration &&
+        !crossMajorNeedsPreview &&
+        !needsAppUpgrade;
+    if (!artifactsOnly &&
+        !runtimeOnly &&
+        !crossMajorMigration &&
+        !crossMajorNeedsPreview &&
+        !needsAppUpgrade &&
+        bundleStatus === APP_UP_TO_DATE &&
+        pendingRuntimeCount === 0 &&
+        pendingArtifactCount === 0) {
+        return "stay_up_to_date";
+    }
+    if (crossMajorMigration || crossMajorNeedsPreview) {
+        return crossMajorMigration ? "upgrade_cross_major" : "upgrade_cross_major_preview";
+    }
+    if (needsAppUpgrade) {
+        if (bundleStatus === APP_OUTDATED) {
+            return "upgrade_app_outdated";
+        }
+        if (bundleStatus === APP_REPAIR_NEEDED) {
+            return "upgrade_app_repair";
+        }
+        if (bundleStatus === APP_MIGRATION_NEEDED) {
+            return "upgrade_app_migration";
+        }
+        return "upgrade_app_outdated";
+    }
+    if (artifactsOnly) {
+        return "upgrade_artifacts_only";
+    }
+    if (runtimeOnly) {
+        return "upgrade_runtime_only";
+    }
+    if (pendingRuntimeCount > 0) {
+        return "upgrade_runtime_mixed";
+    }
+    return "upgrade_generic";
+}
+export function integrationScenarioRecommendation(scenario) {
+    return scenario === "stay_manual_review" || scenario === "stay_up_to_date" ? "stay" : "upgrade";
+}
+export function integrationScenarioOnlyPhases(scenario) {
+    if (scenario === "upgrade_artifacts_only") {
+        return ["artifacts"];
+    }
+    if (scenario === "upgrade_runtime_only") {
+        return ["runtime"];
+    }
+    return undefined;
+}
+export function integrationScenarioNeedsInstallRoot(scenario) {
+    return (scenario === "upgrade_cross_major" ||
+        scenario === "upgrade_cross_major_preview" ||
+        scenario === "upgrade_app_outdated" ||
+        scenario === "upgrade_app_repair" ||
+        scenario === "upgrade_app_migration");
+}
+const SCENARIO_MESSAGES = {
+    stay_manual_review: "Agentera needs manual review for your app directory before this project can be upgraded safely.",
+    stay_up_to_date: "This project matches your current Agentera install; no upgrade is needed.",
+    upgrade_artifacts_only: "This project still uses v1 Markdown artifacts; preview migrating them to v2 YAML before continuing.",
+    upgrade_cross_major: "Your Agentera app copy is still on v2 while the CLI is on v3; preview the one-way v2→v3 migration before applying.",
+    upgrade_cross_major_preview: "Your Agentera app copy is still on v2 while the CLI is on v3; preview the one-way v2→v3 migration before applying.",
+    upgrade_app_outdated: "Your Agentera app copy is out of date; preview the update with agentera upgrade before applying.",
+    upgrade_app_repair: "Your Agentera app copy needs repair; preview the repair with agentera upgrade before applying.",
+    upgrade_app_migration: "Your Agentera app copy needs migration; preview the migration with agentera upgrade before applying.",
+    upgrade_runtime_only: "",
+    upgrade_runtime_mixed: "",
+    upgrade_generic: "Preview Agentera upgrade changes for this project before applying.",
+};
+export function integrationScenarioMessage(scenario, opts) {
+    if (scenario === "upgrade_runtime_only" || scenario === "upgrade_runtime_mixed") {
+        const runtimes = opts.pendingRuntimes.length > 0 ? opts.pendingRuntimes.join(", ") : "runtime configs";
+        return opts.projectLevelRuntimeHooks
+            ? `This project still uses older Agentera runtime wiring (${runtimes}); preview rewiring hooks to the current npm entrypoint.`
+            : `Your user-level Agentera runtime wiring (${runtimes}) is stale; preview rewiring hooks to the current npm entrypoint.`;
+    }
+    return SCENARIO_MESSAGES[scenario];
+}
+//# 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":"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"}