agentera 3.0.0-dev.6 → 3.0.0-dev.7

package/dist/upgrade/doctorClassifier.js

@@ -0,0 +1,177 @@
+import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, } from "./doctor.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 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/",
+            legacyAppRoot: ctx.installRoot,
+            managedAppRoot: ctx.roots.managedAppRoot,
+        });
+    }
+    appendManagedStaleSignals(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/installedHooksRetirement.js

@@ -0,0 +1,190 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isFile, pathExists, resolvePath } from "../core/paths.js";
+import { doctorRoots } from "./appModel.js";
+export const INSTALLED_HOOKS_SURFACE_LABEL = "hooks/";
+export const RETIRE_INSTALLED_HOOKS_ACTION = "retire-installed-hooks";
+const V2_HOOK_INVOCATION_PATTERNS = [
+    /\buv run\b[^"'\n]*hooks\/[^"'\n]*\.py/,
+    /\$\{AGENTERA_HOME\}\/hooks\/[^"'\n]*\.py/,
+    /\$\{AGENTERA_HOME\}\/app\/hooks\/[^"'\n]*\.py/,
+    /\$\{PLUGIN_ROOT\}\/hooks\/[^"'\n]*\.py/,
+];
+const SKIP_HOOK_SCAN_PARTS = new Set([".agentera", "sessions", "benchmarks", "intermediate", "backup"]);
+function hooksDirHasPythonFiles(hooksDir) {
+    if (!pathExists(hooksDir) || !fs.statSync(hooksDir).isDirectory()) {
+        return false;
+    }
+    return fs.readdirSync(hooksDir).some((name) => name.endsWith(".py"));
+}
+function listInstalledHookDirs(appHome) {
+    const resolved = resolvePath(appHome);
+    const roots = doctorRoots(resolved);
+    const candidates = [
+        path.join(resolved, "hooks"),
+        path.join(roots.managedAppRoot, "hooks"),
+        path.join(roots.activeBundleRoot, "hooks"),
+    ];
+    const seen = new Set();
+    const out = [];
+    for (const hooksDir of candidates) {
+        const normalized = path.resolve(hooksDir);
+        if (seen.has(normalized) || !hooksDirHasPythonFiles(hooksDir)) {
+            continue;
+        }
+        seen.add(normalized);
+        out.push(hooksDir);
+    }
+    return out;
+}
+export function installedBundleUsesV2PythonHooks(appHome) {
+    return listInstalledHookDirs(appHome).length > 0;
+}
+export function textReferencesV2InstalledHooks(text) {
+    return V2_HOOK_INVOCATION_PATTERNS.some((pattern) => pattern.test(text));
+}
+function shouldScanInstalledHookFile(name) {
+    return (name.endsWith(".json") ||
+        name.endsWith(".toml") ||
+        name.endsWith(".js") ||
+        name.endsWith(".md") ||
+        name.endsWith(".yaml") ||
+        name.endsWith(".yml"));
+}
+/** Scan installed hook manifests for shipped v2 hook command invocations. */
+export function scanInstalledBundleForV2HookInvocations(appHome) {
+    const resolved = resolvePath(appHome);
+    const hits = [];
+    for (const hooksDir of listInstalledHookDirs(resolved)) {
+        const walk = (current) => {
+            for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+                const full = path.join(current, entry.name);
+                if (entry.isDirectory()) {
+                    walk(full);
+                    continue;
+                }
+                if (!shouldScanInstalledHookFile(entry.name)) {
+                    continue;
+                }
+                const rel = path.relative(resolved, full);
+                const text = fs.readFileSync(full, "utf8");
+                if (textReferencesV2InstalledHooks(text)) {
+                    hits.push(rel);
+                }
+            }
+        };
+        walk(hooksDir);
+    }
+    return hits;
+}
+export function detectStaleInstalledHooksSurface(appHome) {
+    return (installedBundleUsesV2PythonHooks(appHome) ||
+        scanInstalledBundleForV2HookInvocations(appHome).length > 0);
+}
+export function retireInstalledV2Hooks(appHome) {
+    const removed = [];
+    for (const hooksDir of listInstalledHookDirs(appHome)) {
+        fs.rmSync(hooksDir, { recursive: true, force: true });
+        removed.push(path.relative(resolvePath(appHome), hooksDir) || "hooks");
+    }
+    return removed;
+}
+function retireItemStatus(stale) {
+    return stale ? "pending" : "noop";
+}
+export function planInstalledHooksRetirementItems(ctx) {
+    const appHome = resolvePath(ctx.appHome);
+    const hookDirs = listInstalledHookDirs(appHome);
+    const invocationHits = scanInstalledBundleForV2HookInvocations(appHome);
+    const stale = hookDirs.length > 0 || invocationHits.length > 0;
+    if (!stale) {
+        return [
+            {
+                status: "noop",
+                action: RETIRE_INSTALLED_HOOKS_ACTION,
+                runtime: "installed-app",
+                source: appHome,
+                message: "installed app home has no v2 Python hooks surface",
+            },
+        ];
+    }
+    const items = [];
+    for (const hooksDir of hookDirs) {
+        items.push({
+            status: "pending",
+            action: RETIRE_INSTALLED_HOOKS_ACTION,
+            runtime: "installed-app",
+            source: hooksDir,
+            target: appHome,
+            message: `will retire v2 Python hooks at ${path.relative(appHome, hooksDir) || "hooks"}`,
+            removedPreview: fs.readdirSync(hooksDir).filter((name) => name.endsWith(".py")),
+        });
+    }
+    if (invocationHits.length > 0) {
+        items.push({
+            status: retireItemStatus(true),
+            action: RETIRE_INSTALLED_HOOKS_ACTION,
+            runtime: "installed-app",
+            source: appHome,
+            message: `will remove installed bundle files still invoking uv run hooks/*.py (${invocationHits.join(", ")})`,
+            removedPreview: invocationHits,
+        });
+    }
+    return items;
+}
+export function applyInstalledHooksRetirementItems(items, ctx) {
+    const pending = items.filter((item) => item.action === RETIRE_INSTALLED_HOOKS_ACTION && item.status === "pending");
+    if (pending.length === 0) {
+        return;
+    }
+    try {
+        const removed = retireInstalledV2Hooks(ctx.appHome);
+        for (const item of pending) {
+            item.status = "applied";
+            item.message =
+                removed.length > 0
+                    ? `retired v2 Python hooks (${removed.join(", ")})`
+                    : "retired v2 Python hook invocations from installed bundle";
+        }
+    }
+    catch (exc) {
+        for (const item of pending) {
+            item.status = "failed";
+            item.message = `${RETIRE_INSTALLED_HOOKS_ACTION} failed: ${exc.message}`;
+        }
+    }
+}
+export function installedHookPathsAfterMigration(appHome) {
+    const resolved = resolvePath(appHome);
+    const out = [];
+    const walk = (current) => {
+        if (!pathExists(current)) {
+            return;
+        }
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            if (SKIP_HOOK_SCAN_PARTS.has(entry.name)) {
+                continue;
+            }
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "hooks") {
+                    for (const hookEntry of fs.readdirSync(full)) {
+                        if (hookEntry.endsWith(".py")) {
+                            out.push(path.relative(resolved, path.join(full, hookEntry)));
+                        }
+                    }
+                }
+                walk(full);
+            }
+        }
+    };
+    walk(resolved);
+    return out;
+}
+export function installedBundleHasV2HookInvocationText(appHome) {
+    return scanInstalledBundleForV2HookInvocations(appHome).length > 0;
+}
+export function isV2HookScript(filePath) {
+    return isFile(filePath) && filePath.endsWith(".py") && filePath.includes(`${path.sep}hooks${path.sep}`);
+}
+//# sourceMappingURL=installedHooksRetirement.js.map

package/dist/upgrade/installedHooksRetirement.js.map

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

package/dist/upgrade/legacyAgentCleanup.js

@@ -0,0 +1,116 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isFile, pathExists, resolvePath } from "../core/paths.js";
+import { opencodeConfigDir } from "../setup/opencode.js";
+export const REMOVE_LEGACY_AGENT_ACTION = "remove-legacy-agent";
+/** Closed set of v2 Swedish-verb agent files left orphaned after v3 single-agent copy (#20). */
+export const V2_SWEDISH_VERB_AGENT_FILES = [
+    "dokumentera.md",
+    "hej.md",
+    "inspektera.md",
+    "inspirera.md",
+    "optimera.md",
+    "orkestrera.md",
+    "planera.md",
+    "profilera.md",
+    "realisera.md",
+    "resonera.md",
+    "visionera.md",
+    "visualisera.md",
+];
+const V2_SWEDISH_VERB_AGENT_SET = new Set(V2_SWEDISH_VERB_AGENT_FILES);
+export function isV2SwedishVerbAgentFile(name) {
+    return V2_SWEDISH_VERB_AGENT_SET.has(name);
+}
+export function legacyAgentScanTargets(ctx) {
+    const project = resolvePath(ctx.project);
+    const home = resolvePath(ctx.home);
+    const appHome = resolvePath(ctx.appHome);
+    const env = ctx.env ?? process.env;
+    const targets = [];
+    const seen = new Set();
+    const push = (runtime, agentsDir) => {
+        const normalized = path.resolve(agentsDir);
+        if (seen.has(normalized)) {
+            return;
+        }
+        seen.add(normalized);
+        targets.push({ runtime, agentsDir: normalized });
+    };
+    push("cursor", path.join(project, ".cursor", "agents"));
+    push("cursor", path.join(home, ".cursor", "agents"));
+    if (appHome !== project && appHome !== home) {
+        push("cursor", path.join(appHome, ".cursor", "agents"));
+    }
+    push("opencode", path.join(opencodeConfigDir(home, env), "agents"));
+    return targets;
+}
+export function scanLegacySwedishVerbAgentPaths(agentsDir) {
+    if (!pathExists(agentsDir) || !fs.statSync(agentsDir).isDirectory()) {
+        return [];
+    }
+    const hits = [];
+    for (const name of fs.readdirSync(agentsDir)) {
+        if (!isV2SwedishVerbAgentFile(name)) {
+            continue;
+        }
+        const filePath = path.join(agentsDir, name);
+        if (isFile(filePath)) {
+            hits.push(filePath);
+        }
+    }
+    return hits.sort();
+}
+/** Scan a tree for reintroduced Swedish-verb agents (v1LegacyCruft-style guard). */
+export function scanLegacySwedishVerbAgentViolations(root) {
+    const resolved = resolvePath(root);
+    const violations = [];
+    const agentDirs = [
+        path.join(resolved, ".cursor", "agents"),
+        path.join(resolved, ".opencode", "agents"),
+    ];
+    for (const agentsDir of agentDirs) {
+        for (const filePath of scanLegacySwedishVerbAgentPaths(agentsDir)) {
+            violations.push(path.relative(resolved, filePath));
+        }
+    }
+    return violations.sort();
+}
+export function planLegacyAgentCleanupItems(ctx) {
+    const items = [];
+    for (const { runtime, agentsDir } of legacyAgentScanTargets(ctx)) {
+        for (const source of scanLegacySwedishVerbAgentPaths(agentsDir)) {
+            items.push({
+                status: "pending",
+                action: REMOVE_LEGACY_AGENT_ACTION,
+                runtime,
+                source,
+                message: `will remove orphaned v2 Swedish-verb agent ${path.basename(source)}`,
+            });
+        }
+    }
+    return items;
+}
+export function applyLegacyAgentCleanupItems(items) {
+    for (const item of items) {
+        if (item.status !== "pending" || item.action !== REMOVE_LEGACY_AGENT_ACTION || !item.source) {
+            continue;
+        }
+        const basename = path.basename(item.source);
+        try {
+            if (!isV2SwedishVerbAgentFile(basename) || !isFile(item.source)) {
+                item.status = "noop";
+                item.message = `legacy agent already absent at ${item.source}`;
+                continue;
+            }
+            fs.rmSync(item.source, { force: true });
+            item.status = "applied";
+            item.message = `removed orphaned v2 Swedish-verb agent ${basename}`;
+        }
+        catch (exc) {
+            item.status = "failed";
+            item.message = `${REMOVE_LEGACY_AGENT_ACTION} failed: ${exc.message}`;
+        }
+    }
+}
+//# sourceMappingURL=legacyAgentCleanup.js.map

package/dist/upgrade/legacyAgentCleanup.js.map

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

package/dist/upgrade/migrateArtifactsV2ToV3.js

@@ -5,11 +5,13 @@ import { BUNDLE_MARKER } from "../state/installRoot.js";
 import { doctorRoots } from "./appModel.js";
 import { AGENTERA_USER_STATE_NAMES, } from "./doctor.js";
 import { applyV1ArtifactsPhase, planV1ArtifactsPhase, } from "./migrateArtifactsV1ToV2.js";
-import { appHomeHasUnrecognizedEntriesWithPreflight, resolveMigrationUserStatePreflight, } from "../migrate/v2HandoffManifest.js";
+import { appHomeHasUnrecognizedEntriesWithPreflight, handoffCatalogMessage, resolveMigrationUserStatePreflight, } from "../migrate/v2HandoffManifest.js";
+import { applyAppContentRefreshItems, planAppContentRefreshItems, } from "./appContentRefresh.js";
+import { applyLegacyAgentCleanupItems, planLegacyAgentCleanupItems, } from "./legacyAgentCleanup.js";
 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 = [
@@ -140,10 +142,15 @@ export function applyRuntimeRewirePhase(phase, ctx) {
     phase.status = updated.status;
     phase.summary = updated.summary;
 }
-function hasManagedBundleEvidence(managedAppRoot) {
-    return (isFile(path.join(managedAppRoot, BUNDLE_MARKER)) ||
-        (isFile(path.join(managedAppRoot, "scripts", "agentera")) &&
-            isFile(path.join(managedAppRoot, "skills", "agentera", "SKILL.md"))));
+/** Whether `app/` under app-home still carries a managed bundle worth removing during v2→v3 cleanup. */
+export function hasManagedBundleEvidence(managedAppRoot) {
+    // v3 npm-managed installs write BUNDLE_MARKER at pack/refresh time.
+    if (isFile(path.join(managedAppRoot, BUNDLE_MARKER))) {
+        return true;
+    }
+    // Legacy v2 Python-managed installs lacked the marker but always shipped this pair.
+    return (isFile(path.join(managedAppRoot, "scripts", "agentera")) &&
+        isFile(path.join(managedAppRoot, "skills", "agentera", "SKILL.md")));
 }
 function listManagedBundlePreview(managedAppRoot, limit = 20) {
     if (!pathExists(managedAppRoot)) {
@@ -173,35 +180,50 @@ export function planCleanupPhase(ctx) {
     const appHome = resolvePath(ctx.appHome);
     const roots = doctorRoots(appHome);
     const managedAppRoot = roots.managedAppRoot;
-    const preflight = resolveMigrationUserStatePreflight(appHome);
+    const preflight = resolveMigrationUserStatePreflight(appHome, {
+        home: ctx.home,
+        env: ctx.env,
+    });
     const preserved = preflight.preservedAbsolutePaths;
     const unknown = appHomeHasUnrecognizedEntriesWithPreflight(appHome, preflight);
+    const items = [
+        ...preflight.handoffCatalog.map((entry) => ({
+            status: "noop",
+            action: "catalog-handoff",
+            source: entry.root,
+            preserved: entry.entries,
+            message: handoffCatalogMessage(entry),
+        })),
+        ...planAppContentRefreshItems(ctx),
+        ...planLegacyAgentCleanupItems(ctx),
+    ];
     if (unknown.length > 0 && !ctx.force) {
-        return summarizePhase("cleanup", [
-            {
-                status: "blocked",
-                action: "remove-managed-app-home",
-                source: appHome,
-                preserved,
-                message: "app home contains unrecognized entries outside preserved user state; cleanup blocked without --force",
-            },
-        ]);
+        items.push({
+            status: "blocked",
+            action: "remove-managed-app-home",
+            source: appHome,
+            preserved,
+            message: "app home contains unrecognized entries outside preserved user state; cleanup blocked without --force",
+        });
+        return summarizePhase("cleanup", items);
     }
     if (!hasManagedBundleEvidence(managedAppRoot)) {
-        return summarizePhase("cleanup", [], "no managed Python app-home bundle to remove");
+        if (items.length === 0) {
+            return summarizePhase("cleanup", [], "no managed Python app-home bundle to remove");
+        }
+        return summarizePhase("cleanup", items);
     }
     const removedPreview = listManagedBundlePreview(managedAppRoot);
-    return summarizePhase("cleanup", [
-        {
-            status: "pending",
-            action: "remove-managed-app-home",
-            source: managedAppRoot,
-            target: appHome,
-            preserved,
-            removedPreview,
-            message: "will remove managed Python app-home bundle under app/ while preserving user state at app-home root",
-        },
-    ]);
+    items.push({
+        status: "pending",
+        action: "remove-managed-app-home",
+        source: managedAppRoot,
+        target: appHome,
+        preserved,
+        removedPreview,
+        message: "will remove managed Python app-home bundle under app/ while preserving user state at app-home root",
+    });
+    return summarizePhase("cleanup", items);
 }
 function removeDirectoryRecursive(dir) {
     if (!pathExists(dir)) {
@@ -209,9 +231,13 @@ function removeDirectoryRecursive(dir) {
     }
     fs.rmSync(dir, { recursive: true, force: true });
 }
-export function applyCleanupPhase(phase) {
+export function applyCleanupPhase(phase, ctx) {
+    if (ctx) {
+        applyAppContentRefreshItems(phase.items, ctx);
+    }
+    applyLegacyAgentCleanupItems(phase.items);
     for (const item of phase.items) {
-        if (item.status !== "pending" || !item.source) {
+        if (item.status !== "pending" || item.action !== "remove-managed-app-home" || !item.source) {
             continue;
         }
         try {
@@ -248,7 +274,7 @@ export function applyMigrationPhases(ctx, preview, only = ["artifacts", "runtime
         applyRuntimeRewirePhase(result.runtime, ctx);
     }
     if (only.includes("cleanup")) {
-        applyCleanupPhase(result.cleanup);
+        applyCleanupPhase(result.cleanup, ctx);
     }
     return result;
 }