@nikelyh/metamorph 2.1.0 → 2.1.2

package/dist/index.js

@@ -12,14 +12,17 @@ import {
   createRenameFileTool,
   createRunBuildTool,
   createWriteFileTool
-} from "./chunk-OXXEISZT.js";
+} from "./chunk-APRESSUR.js";
 import {
-  findMigrationCatalogEntry,
-  formatCatalogRules
-} from "./chunk-VEAYUIOZ.js";
+  formatCatalogRules,
+  resolveMigrationCatalog,
+  resolvePackageManagerCommands
+} from "./chunk-WLHSZWET.js";
 import {
-  detectTechnologies
-} from "./chunk-3QN2Q75J.js";
+  detectMonorepo,
+  inspectManifest,
+  inspectProject
+} from "./chunk-XLD7NXYU.js";
 import {
   MetamorphState,
   initializeRuntime,
@@ -33,6 +36,16 @@ import {
   collectFileHints,
   registerMigrationPlugin
 } from "./chunk-O2QLEES3.js";
+import {
+  analyzeReactToNextStructure,
+  findShadowRoot,
+  hasNextAppRoutes,
+  isFsdPageComponent,
+  isSpaPagesTreeFile,
+  isSpaRootComponent,
+  listAppRouterFiles,
+  nextMigrationFileHint
+} from "./chunk-H2LZEPNI.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -118,7 +131,7 @@ import {
   createAgent as createAgent2,
   SituationSpecification as SituationSpecification2
 } from "@mozaik-ai/core";
-import * as fs4 from "fs";
+import * as fs3 from "fs";
 
 // ../application/src/utils/FileTreeBuilder.ts
 import * as path2 from "path";
@@ -180,312 +193,15 @@ function buildFileTree(filePaths) {
 }
 
 // ../application/src/utils/NeighborContext.ts
-import * as fs3 from "fs";
-import * as path4 from "path";
-
-// ../application/src/utils/NextMigrationHints.ts
 import * as fs2 from "fs";
 import * as path3 from "path";
-function findShadowRoot(filePath) {
-  const normalized = filePath.replace(/\\/g, "/");
-  const marker = "/.metamorph/shadow/";
-  const index = normalized.indexOf(marker);
-  if (index === -1) return null;
-  const after = normalized.slice(index + marker.length);
-  const runId = after.split("/")[0];
-  if (!runId) return null;
-  return filePath.slice(0, index + marker.length + runId.length);
-}
-function isFsdPageComponent(filePath) {
-  return /[/\\]src[/\\]pages[/\\][^/\\]+[/\\]ui[/\\]/i.test(filePath);
-}
-function isSpaRootComponent(filePath) {
-  return /[/\\](App|main|index)\.(t|j)sx?$/i.test(filePath) && !/[/\\]src[/\\]app[/\\]/i.test(filePath) && !isFsdPageComponent(filePath);
-}
-function hasNextAppRoutes(shadowRoot) {
-  const appDir = path3.join(shadowRoot, "src", "app");
-  if (!fs2.existsSync(appDir)) return false;
-  const stack = [appDir];
-  while (stack.length > 0) {
-    const dir = stack.pop();
-    for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
-      if (entry.isDirectory()) {
-        stack.push(path3.join(dir, entry.name));
-      } else if (entry.name === "page.tsx" || entry.name === "page.jsx" || entry.name === "page.js") {
-        return true;
-      }
-    }
-  }
-  return false;
-}
-function nextMigrationFileHint(filePath, target) {
-  if (target !== "next") return "";
-  if (isFsdPageComponent(filePath) || isSpaPagesTreeFile(filePath)) {
-    return `
-This file sits under src/pages. In Next.js that directory is the Pages Router.
-Move this file out of src/pages (keep the component and its business logic) into a folder Next does not treat as routes.
-Then add or update src/app/<route>/page.tsx so the App Router imports that screen for the former URL.
-The home route ("/") is src/app/page.tsx and must render the former "/" screen \u2014 not an empty shell, null, a TODO, or a deleted App.tsx.
-Delete the old src/pages copy after the screen exists elsewhere.
-`;
-  }
-  if (isSpaRootComponent(filePath)) {
-    return `
-This is a SPA root/entry file (App.tsx / main.tsx / index.tsx).
-Read it and map each route to src/app/<path>/page.tsx that imports the actual screen component (after moving anything that lived under src/pages).
-src/app/page.tsx must render the home screen. Never import App from the new page (App is being removed).
-Never write a stub that the root component "could not be resolved". After App Router files exist with real UI, delete this legacy root file.
-`;
-  }
-  if (/[/\\]src[/\\]app[/\\].*page\.(t|j)sx$/i.test(filePath)) {
-    return `
-This is a Next App Router page. Import the existing screen component and return it.
-Do not paste that screen's JSX here. Do not rename its public props at the wrapper.
-Do not hollow out the module you imported from.
-`;
-  }
-  return "";
-}
-var NEXT_PAGES_RESERVED = /(?:^|[/\\])(_app|_document|_error|404|500)\.(t|j)sx?$/i;
-function isSpaPagesTreeFile(filePath) {
-  const normalized = filePath.replace(/\\/g, "/");
-  if (!/\/src\/pages\//i.test(normalized)) return false;
-  if (/\/src\/pages\/api\//i.test(normalized)) return false;
-  if (NEXT_PAGES_RESERVED.test(normalized)) return false;
-  return true;
-}
-function listFilesRecursive(dir) {
-  if (!fs2.existsSync(dir)) return [];
-  const out = [];
-  const stack = [dir];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    for (const entry of fs2.readdirSync(current, { withFileTypes: true })) {
-      const full = path3.join(current, entry.name);
-      if (entry.isDirectory()) stack.push(full);
-      else if (/\.(t|j)sx?$/.test(entry.name)) out.push(full);
-    }
-  }
-  return out;
-}
-function findAppRouterHome(shadowRoot) {
-  const candidates = [
-    path3.join(shadowRoot, "src", "app", "page.tsx"),
-    path3.join(shadowRoot, "src", "app", "page.jsx"),
-    path3.join(shadowRoot, "app", "page.tsx"),
-    path3.join(shadowRoot, "app", "page.jsx")
-  ];
-  return candidates.find((file) => fs2.existsSync(file)) || null;
-}
-function listAppRouterFiles(shadowRoot) {
-  const roots = [path3.join(shadowRoot, "src", "app"), path3.join(shadowRoot, "app")];
-  const names = /^(page|layout)\.(t|j)sx$/i;
-  return roots.flatMap((dir) => listFilesRecursive(dir).filter((file) => names.test(path3.basename(file))));
-}
-function isHollowView(content) {
-  const withoutComments = content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
-  const hasFeatureImports = /from\s+['"][^'"]*\/(features|entities|widgets)\//.test(withoutComments);
-  const tinyTree = /<h1[^>]*>[^<]{0,40}<\/h1>/.test(withoutComments) && !hasFeatureImports;
-  const emptyMain = /<main>\s*<h1>/.test(withoutComments) && !hasFeatureImports;
-  return tinyTree || emptyMain;
-}
-function findViewPages(shadowRoot) {
-  const viewsDir = path3.join(shadowRoot, "src", "views");
-  return listFilesRecursive(viewsDir).filter((file) => /(?:^|[/\\])(?:.+Page|page)\.(t|j)sx$/i.test(file));
-}
-function localTsxImports(fromFile, content) {
-  const dir = path3.dirname(fromFile);
-  const out = [];
-  const re = /import\s+(?:\{([^}]+)\}|(\w+))\s+from\s+['"](\.\.?\/[^'"]+|@\/[^'"]+)['"]/g;
-  let match;
-  while ((match = re.exec(content)) !== null) {
-    const resolved = match[3].startsWith("@/") ? path3.join(findSrcRoot(fromFile), match[3].slice(2)) : path3.resolve(dir, match[3]);
-    const candidates = [
-      resolved,
-      `${resolved}.tsx`,
-      `${resolved}.jsx`,
-      `${resolved}.ts`,
-      path3.join(resolved, "index.tsx"),
-      path3.join(resolved, "index.ts")
-    ];
-    const absPath = candidates.find((file) => fs2.existsSync(file));
-    if (!absPath) continue;
-    if (match[2]) out.push({ tag: match[2], absPath });
-    if (match[1]) {
-      for (const part of match[1].split(",")) {
-        const name = part.trim().split(/\s+as\s+/).pop()?.trim();
-        if (name) out.push({ tag: name, absPath });
-      }
-    }
-  }
-  return out;
-}
-function findSrcRoot(filePath) {
-  const normalized = filePath.replace(/\\/g, "/");
-  const idx = normalized.lastIndexOf("/src/");
-  if (idx === -1) return path3.dirname(filePath);
-  return filePath.slice(0, idx + 4);
-}
-function declaredCallbackProps(componentSource) {
-  const names = /* @__PURE__ */ new Set();
-  const iface = /interface\s+\w+\s*\{([^}]+)\}/g;
-  let block;
-  while ((block = iface.exec(componentSource)) !== null) {
-    const field = /(\b(?:on[A-Z]\w+|action[A-Z]\w+)\??)\s*:/g;
-    let f;
-    while ((f = field.exec(block[1])) !== null) names.add(f[1].replace("?", ""));
-  }
-  const dest = /export\s+(?:default\s+)?function\s+\w+\s*\(\s*\{\s*([^}]+)\}/;
-  const d = dest.exec(componentSource);
-  if (d) {
-    for (const part of d[1].split(",")) {
-      const name = part.trim().split(":")[0].trim();
-      if (/^(on[A-Z]|action[A-Z])/.test(name)) names.add(name);
-    }
-  }
-  return [...names];
-}
-function jsxCallbackProps(callerSource, tag) {
-  const names = [];
-  const tagRe = new RegExp(`<${tag}\\b([^>]*)\\/?>`, "g");
-  let match;
-  while ((match = tagRe.exec(callerSource)) !== null) {
-    const propRe = /\b((?:on|action)[A-Z]\w+)\s*=/g;
-    let p;
-    while ((p = propRe.exec(match[1])) !== null) names.push(p[1]);
-  }
-  return names;
-}
-function analyzeCallbackPropMismatches(shadowRoot) {
-  const issues = [];
-  const files = [
-    ...listFilesRecursive(path3.join(shadowRoot, "src", "app")),
-    ...listFilesRecursive(path3.join(shadowRoot, "app")),
-    ...listFilesRecursive(path3.join(shadowRoot, "src", "views"))
-  ].filter((file) => /\.(t|j)sx$/.test(file));
-  for (const file of files) {
-    const content = fs2.readFileSync(file, "utf-8");
-    for (const imp of localTsxImports(file, content)) {
-      let callee;
-      try {
-        callee = fs2.readFileSync(imp.absPath, "utf-8");
-      } catch {
-        continue;
-      }
-      const expected = declaredCallbackProps(callee);
-      if (expected.length === 0) continue;
-      const passed = jsxCallbackProps(content, imp.tag);
-      const missing = expected.filter((name) => !passed.includes(name));
-      const extra = passed.filter((name) => !expected.includes(name));
-      if (missing.length === 0 && extra.length === 0) continue;
-      issues.push({
-        filePath: file,
-        errors: [
-          `<${imp.tag}> public callback props do not match ${path3.relative(shadowRoot, imp.absPath)}. Expected: ${expected.join(", ") || "(none)"}. Passed: ${passed.join(", ") || "(none)"}. Do not rename props when wrapping a screen in a router file.`
-        ]
-      });
-    }
-  }
-  return issues;
-}
-function analyzeReactToNextComposition(shadowRoot) {
-  const issues = [];
-  const home = findAppRouterHome(shadowRoot);
-  if (!home) return issues;
-  const homeContent = fs2.readFileSync(home, "utf-8");
-  const views = findViewPages(shadowRoot);
-  const hollowViews = views.filter((file) => isHollowView(fs2.readFileSync(file, "utf-8")));
-  const homeImportsView = views.some((file) => {
-    const stem = path3.basename(file).replace(/\.(t|j)sx$/, "");
-    return homeContent.includes(stem);
-  });
-  const homeAssemblesFeatures = /from\s+['"][^'"]*\/(features|entities|widgets)\//.test(homeContent);
-  if (views.length > 0 && !homeImportsView && homeAssemblesFeatures) {
-    issues.push({
-      filePath: home,
-      errors: [
-        "The App Router home reassembles the UI from lower-level modules instead of importing the existing route-level screen. Import that screen and return it. Renaming props at the wrapper causes runtime TypeError while next build still succeeds."
-      ]
-    });
-  }
-  for (const file of hollowViews) {
-    issues.push({
-      filePath: file,
-      errors: [
-        "This screen was hollowed out. Restore the original UI here. The App Router page should import this file, not replace it with a stub heading."
-      ]
-    });
-  }
-  return issues;
-}
-function isStubAppRouterPage(content) {
-  const hasLocalImport = /from\s+['"](\.\.?\/|@\/)/.test(content);
-  const emptyish = /return\s*\(\s*<main\s*\/>\s*\)|return\s+null\s*;?|return\s*\(\s*<>\s*<\/>\s*\)|TODO:|could not be resolved/i.test(content);
-  const onlyLayoutShell = /<main\s*\/>/.test(content) && !hasLocalImport;
-  return !hasLocalImport || emptyish || onlyLayoutShell;
-}
-function analyzeReactToNextStructure(shadowRoot) {
-  const issues = [];
-  const pagesDir = path3.join(shadowRoot, "src", "pages");
-  if (fs2.existsSync(pagesDir)) {
-    for (const file of listFilesRecursive(pagesDir)) {
-      if (!isSpaPagesTreeFile(file)) continue;
-      issues.push({
-        filePath: file,
-        errors: [
-          "This UI still lives under src/pages. Next.js will treat it as a Pages Router route. Move it to a folder Next does not reserve, then import it from src/app/**/page.tsx for the old URL. Remove the src/pages copy."
-        ]
-      });
-    }
-  }
-  const home = findAppRouterHome(shadowRoot);
-  if (!home) {
-    issues.push({
-      filePath: path3.join(shadowRoot, "src", "app", "page.tsx"),
-      errors: [
-        'Missing App Router home (src/app/page.tsx). Create it so it imports and renders the screen the SPA showed at "/".'
-      ]
-    });
-    return issues;
-  }
-  const homeContent = fs2.readFileSync(home, "utf-8");
-  if (isStubAppRouterPage(homeContent)) {
-    issues.push({
-      filePath: home,
-      errors: [
-        "src/app/page.tsx does not render the application UI. Import the former home screen component (after moving any SPA UI out of src/pages if needed). Do not return an empty shell, null, a TODO, or a deleted App.tsx."
-      ]
-    });
-  }
-  issues.push(...analyzeReactToNextComposition(shadowRoot));
-  issues.push(...analyzeCallbackPropMismatches(shadowRoot));
-  const pkgPath = path3.join(shadowRoot, "package.json");
-  if (fs2.existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
-      const viteScripts = Object.entries(pkg.scripts || {}).filter(([, cmd]) => /\bvite\b/.test(cmd));
-      if (viteScripts.length > 0) {
-        issues.push({
-          filePath: pkgPath,
-          errors: [
-            `package.json still runs Vite in scripts (${viteScripts.map(([name]) => name).join(", ")}). After moving to Next, drop leftover preview/vite scripts.`
-          ]
-        });
-      }
-    } catch {
-    }
-  }
-  return issues;
-}
-
-// ../application/src/utils/NeighborContext.ts
 var MAX_FILES = 8;
 var MAX_FILE_CHARS = 4e3;
 var MAX_TOTAL_CHARS = 24e3;
 function readTruncated(filePath) {
   try {
-    if (!fs3.existsSync(filePath) || !fs3.statSync(filePath).isFile()) return null;
-    const raw = fs3.readFileSync(filePath, "utf-8");
+    if (!fs2.existsSync(filePath) || !fs2.statSync(filePath).isFile()) return null;
+    const raw = fs2.readFileSync(filePath, "utf-8");
     if (raw.length <= MAX_FILE_CHARS) return raw;
     return `${raw.slice(0, MAX_FILE_CHARS)}
 
@@ -494,18 +210,18 @@ function readTruncated(filePath) {
     return null;
   }
 }
-function findSrcRoot2(filePath) {
+function findSrcRoot(filePath) {
   const normalized = filePath.replace(/\\/g, "/");
   const idx = normalized.lastIndexOf("/src/");
   if (idx === -1) return null;
   return filePath.slice(0, idx + 4);
 }
 function resolveImport(fromFile, spec) {
-  const dir = path4.dirname(fromFile);
+  const dir = path3.dirname(fromFile);
   const base = spec.startsWith("@/") ? (() => {
-    const src = findSrcRoot2(fromFile);
-    return src ? path4.join(src, spec.slice(2)) : path4.resolve(dir, spec);
-  })() : path4.resolve(dir, spec);
+    const src = findSrcRoot(fromFile);
+    return src ? path3.join(src, spec.slice(2)) : path3.resolve(dir, spec);
+  })() : path3.resolve(dir, spec);
   const candidates = [
     base,
     `${base}.tsx`,
@@ -514,12 +230,12 @@ function resolveImport(fromFile, spec) {
     `${base}.js`,
     `${base}.vue`,
     `${base}.svelte`,
-    path4.join(base, "index.tsx"),
-    path4.join(base, "index.ts"),
-    path4.join(base, "index.vue"),
-    path4.join(base, "index.svelte")
+    path3.join(base, "index.tsx"),
+    path3.join(base, "index.ts"),
+    path3.join(base, "index.vue"),
+    path3.join(base, "index.svelte")
   ];
-  return candidates.find((file) => fs3.existsSync(file) && fs3.statSync(file).isFile()) || null;
+  return candidates.find((file) => fs2.existsSync(file) && fs2.statSync(file).isFile()) || null;
 }
 function localImportSpecs(content) {
   const specs = [];
@@ -530,8 +246,8 @@ function localImportSpecs(content) {
 }
 function listNearbyModules(fromFile, limit) {
   const shadow = findShadowRoot(fromFile);
-  const src = findSrcRoot2(fromFile) || (shadow ? path4.join(shadow, "src") : path4.dirname(fromFile));
-  if (!fs3.existsSync(src)) return [];
+  const src = findSrcRoot(fromFile) || (shadow ? path3.join(shadow, "src") : path3.dirname(fromFile));
+  if (!fs2.existsSync(src)) return [];
   const interesting = /(?:Page|page|View|Screen|layout|Layout|main|App|routes|Routes|app\.routes)\.(t|j)sx?$|\.(vue|svelte)$/;
   const out = [];
   const stack = [src];
@@ -539,13 +255,13 @@ function listNearbyModules(fromFile, limit) {
     const dir = stack.pop();
     let entries;
     try {
-      entries = fs3.readdirSync(dir, { withFileTypes: true });
+      entries = fs2.readdirSync(dir, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const entry of entries) {
       if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-      const full = path4.join(dir, entry.name);
+      const full = path3.join(dir, entry.name);
       if (entry.isDirectory()) stack.push(full);
       else if (interesting.test(entry.name)) out.push(full);
       if (out.length >= limit) break;
@@ -575,15 +291,15 @@ ${body}
 `);
   }
   const importSpecs = self ? localImportSpecs(self) : [];
-  const resolved = importSpecs.map((spec) => resolveImport(filePath, spec)).filter((file) => Boolean(file && file !== path4.resolve(filePath)));
+  const resolved = importSpecs.map((spec) => resolveImport(filePath, spec)).filter((file) => Boolean(file && file !== path3.resolve(filePath)));
   const unique = [...new Set(resolved)].slice(0, MAX_FILES);
   for (const dep of unique) {
     const body = readTruncated(dep);
     if (body) push(`imported: ${dep}`, body);
   }
-  const nearby = listNearbyModules(filePath, 24).filter((file) => path4.resolve(file) !== path4.resolve(filePath));
+  const nearby = listNearbyModules(filePath, 24).filter((file) => path3.resolve(file) !== path3.resolve(filePath));
   if (nearby.length > 0) {
-    const listing = nearby.map((file) => path4.relative(findShadowRoot(filePath) || path4.dirname(filePath), file)).join("\n");
+    const listing = nearby.map((file) => path3.relative(findShadowRoot(filePath) || path3.dirname(filePath), file)).join("\n");
     sections.push(`### Nearby screen / bootstrap files (paths only \u2014 read before inventing a new UI)
 ${listing}
 `);
@@ -594,6 +310,12 @@ Evidence from disk (read this before editing; match existing exports and callbac
 ${sections.join("\n")}`;
 }
 
+// ../application/src/utils/workerCompletion.ts
+var MISSING_AFTER_WORKER = "File missing after worker inference (missing_after_worker)";
+function workerCompletionKind(fileExists) {
+  return fileExists ? "migrated" : "failed_missing";
+}
+
 // ../application/src/agents/WorkerAgent.ts
 var MAX_RETRIES = 2;
 var ConcurrencyQueue = class {
@@ -648,7 +370,7 @@ var WhenInferenceCompleted = class extends SituationSpecification2 {
 async function startWorkerLoop(planId, filePath, prompt, participant) {
   return new Promise(async (originalResolve) => {
     let isDone = false;
-    const resolve5 = () => {
+    const resolve4 = () => {
       if (!isDone) {
         isDone = true;
         originalResolve();
@@ -658,28 +380,51 @@ async function startWorkerLoop(planId, filePath, prompt, participant) {
     const repository = runtime.state.repository;
     await repository.updateTaskStatus(planId, filePath, "in_progress");
     const { createAgent: createMozaikAgent } = await import("@mozaik-ai/core");
+    const { findShadowRoot: findShadowRoot2 } = await import("./NextMigrationHints-BGO2W3K4.js");
+    const shadowRoot = findShadowRoot2(filePath);
+    let workerTools = participant.getTools();
+    if (shadowRoot) {
+      const { createShadowTools } = await import("./src-Q3DGKZEQ.js");
+      workerTools = createShadowTools(shadowRoot);
+    }
     const tempAgent = createMozaikAgent({
       name: `Worker-${Date.now()}-${Math.floor(Math.random() * 1e3)}`,
       capabilities: ["code_refactoring", "inference"],
       instruction: "You are a staff engineer migrating a real codebase. Deduce from files on disk: read the target and every local module it imports before writing. Never invent callback prop names or re-implement a screen you could import. Prefer evidence over catalog examples.",
-      tools: participant.getTools(),
+      tools: workerTools,
       handlers: [
         {
           specification: new WhenInferenceCompleted(),
           processor: {
-            async apply({ event: completionEvent, participant: tempParticipant }) {
-              console.log(`[WorkerAgent:${tempParticipant.getId()}] Inference completed. Emitting FILE_MIGRATED.`);
-              let fileContent = "No content available";
+            async apply({ participant: tempParticipant }) {
+              if (isDone) {
+                return;
+              }
+              const exists = fs3.existsSync(filePath);
+              if (workerCompletionKind(exists) === "failed_missing") {
+                console.warn(`[WorkerAgent:${tempParticipant.getId()}] File not found on disk after inference: ${filePath}`);
+                await repository.updateTaskStatus(planId, filePath, "failed", MISSING_AFTER_WORKER);
+                sendEvent(
+                  {
+                    type: "file.failed" /* FILE_FAILED */,
+                    producerId: tempParticipant.getId(),
+                    occurredAt: /* @__PURE__ */ new Date(),
+                    payload: { planId, filePath, reason: MISSING_AFTER_WORKER }
+                  },
+                  tempParticipant.getId()
+                );
+                leave(tempParticipant);
+                resolve4();
+                return;
+              }
+              let fileContent = "";
               try {
-                if (fs4.existsSync(filePath)) {
-                  fileContent = fs4.readFileSync(filePath, "utf-8");
-                  console.log(`[WorkerAgent:${tempParticipant.getId()}] Read ${fileContent.length} chars from ${filePath}`);
-                } else {
-                  console.warn(`[WorkerAgent:${tempParticipant.getId()}] File not found on disk: ${filePath}`);
-                }
+                fileContent = fs3.readFileSync(filePath, "utf-8");
+                console.log(`[WorkerAgent:${tempParticipant.getId()}] Read ${fileContent.length} chars from ${filePath}`);
               } catch (e) {
                 console.error(`[WorkerAgent:${tempParticipant.getId()}] Error reading file:`, e);
               }
+              console.log(`[WorkerAgent:${tempParticipant.getId()}] Inference completed. Emitting FILE_MIGRATED.`);
               await repository.updateTaskStatus(planId, filePath, "in_progress");
               sendEvent(
                 {
@@ -695,7 +440,7 @@ async function startWorkerLoop(planId, filePath, prompt, participant) {
                 tempParticipant.getId()
               );
               leave(tempParticipant);
-              resolve5();
+              resolve4();
             }
           }
         }
@@ -712,18 +457,18 @@ async function startWorkerLoop(planId, filePath, prompt, participant) {
       });
       setTimeout(async () => {
         if (!isDone) {
-          console.error(`[WorkerAgent:${tempAgent.getId()}] Inference timed out.`);
-          await repository.updateTaskStatus(planId, filePath, "failed", "Inference timed out");
+          console.error(`[WorkerAgent:${tempAgent.getId()}] Inference timed out after 120s.`);
+          await repository.updateTaskStatus(planId, filePath, "failed", "Inference timed out after 120s");
           sendEvent({
             type: "file.failed" /* FILE_FAILED */,
             producerId: tempAgent.getId(),
             occurredAt: /* @__PURE__ */ new Date(),
-            payload: { planId, filePath, reason: "Inference timed out" }
+            payload: { planId, filePath, reason: "Inference timed out after 120s" }
           }, tempAgent.getId());
           leave(tempAgent);
-          resolve5();
+          resolve4();
         }
-      }, 45e3);
+      }, 12e4);
     } catch (error) {
       console.error(`[WorkerAgent:${tempAgent.getId()}] Sync error:`, error);
       if (!isDone) {
@@ -736,7 +481,7 @@ async function startWorkerLoop(planId, filePath, prompt, participant) {
           payload: { planId, filePath, reason: errorMessage || "Sync error" }
         }, tempAgent.getId());
         leave(tempAgent);
-        resolve5();
+        resolve4();
       }
     }
   });
@@ -752,7 +497,7 @@ var workOnFileProcessor = {
     if (plan) {
       prompt += `Migration Profile: Transform from ${plan.profile.source} to ${plan.profile.target}.
 `;
-      const catalogEntry = findMigrationCatalogEntry(plan.profile.source, plan.profile.target);
+      const catalogEntry = resolveMigrationCatalog(plan.profile.source, plan.profile.target);
       if (catalogEntry) {
         prompt += `
 Architectural rules (all \u2192 ${catalogEntry.layer} \u2192 frameworks \u2192 this pair):
@@ -858,7 +603,7 @@ ${payload.errors.join("\n")}
     if (plan) {
       prompt += `Migration Profile: Transform from ${plan.profile.source} to ${plan.profile.target}.
 `;
-      const catalogEntry = findMigrationCatalogEntry(plan.profile.source, plan.profile.target);
+      const catalogEntry = resolveMigrationCatalog(plan.profile.source, plan.profile.target);
       if (catalogEntry) {
         prompt += `
 Architectural rules (all \u2192 ${catalogEntry.layer} \u2192 frameworks \u2192 this pair):
@@ -934,6 +679,115 @@ import {
   SituationSpecification as SituationSpecification3
 } from "@mozaik-ai/core";
 import * as path5 from "path";
+
+// ../application/src/utils/classifyMissingFile.ts
+import * as fs4 from "fs";
+import * as path4 from "path";
+var NEXT_CONFIG_NAMES = [
+  "next.config.js",
+  "next.config.mjs",
+  "next.config.ts",
+  "next.config.cjs"
+];
+var CONFIG_FILE_PATTERN = /[/\\](vite\.config|craco\.config|webpack\.config)\.(js|ts|mjs|cjs)$/i;
+function classifyMissingFile(input) {
+  const { filePath, target } = input;
+  const fileExists = input.fileExists || fs4.existsSync;
+  const shadowRoot = input.shadowRoot !== void 0 ? input.shadowRoot : findShadowRoot(filePath);
+  const normalizedTarget = target.toLowerCase();
+  const normalizedPath = filePath.replace(/\\/g, "/");
+  if (CONFIG_FILE_PATTERN.test(filePath)) {
+    if (normalizedTarget === "next" && shadowRoot) {
+      const hasNextConfig = NEXT_CONFIG_NAMES.some(
+        (cfg) => fileExists(path4.join(shadowRoot, cfg))
+      );
+      if (hasNextConfig) {
+        return {
+          verdict: "approved",
+          reason: `Config file removed because a Next.js configuration exists in shadow workspace.`
+        };
+      }
+      return {
+        verdict: "rejected",
+        errors: [
+          `Configuration file was removed, but no Next.js configuration (next.config.js/mjs/ts) was found in the project root.`
+        ]
+      };
+    }
+  }
+  if (/[/\\]index\.html$/i.test(filePath)) {
+    if (normalizedTarget === "next" && shadowRoot) {
+      const layoutCandidates = [
+        path4.join(shadowRoot, "src", "app", "layout.tsx"),
+        path4.join(shadowRoot, "src", "app", "layout.jsx"),
+        path4.join(shadowRoot, "src", "app", "layout.js"),
+        path4.join(shadowRoot, "app", "layout.tsx"),
+        path4.join(shadowRoot, "app", "layout.jsx"),
+        path4.join(shadowRoot, "app", "layout.js"),
+        path4.join(shadowRoot, "src", "pages", "_document.tsx"),
+        path4.join(shadowRoot, "pages", "_document.tsx")
+      ];
+      const hasLayout = layoutCandidates.some((candidate) => fileExists(candidate));
+      if (hasLayout) {
+        return {
+          verdict: "approved",
+          reason: `index.html was removed because Next.js root layout or _document exists.`
+        };
+      }
+      return {
+        verdict: "rejected",
+        errors: [
+          `index.html was removed, but no Next.js root layout (app/layout.tsx) or _document was created to provide the HTML structure.`
+        ]
+      };
+    }
+  }
+  if (isSpaRootComponent(filePath)) {
+    if (normalizedTarget === "next") {
+      const hasRoutes = shadowRoot ? hasNextAppRoutes(shadowRoot) : false;
+      if (hasRoutes) {
+        return {
+          verdict: "approved",
+          reason: `SPA root component was removed because Next.js App Router routes exist.`
+        };
+      }
+      return {
+        verdict: "rejected",
+        errors: [
+          `The SPA root was deleted before src/app/**/page.tsx existed with real UI. Recreate routing as Next App Router pages that import the original screen components. Do not import App from those pages.`
+        ]
+      };
+    }
+  }
+  if (isFsdPageComponent(filePath) || isSpaPagesTreeFile(filePath)) {
+    if (normalizedTarget === "next") {
+      const viewsReplacement = filePath.replace(/([/\\])src\1pages\1/, "$1src$1views$1");
+      const screensReplacement = filePath.replace(/([/\\])src\1pages\1/, "$1src$1screens$1");
+      const compReplacement = filePath.replace(/([/\\])src\1pages\1/, "$1src$1components$1pages$1");
+      if (fileExists(viewsReplacement) || fileExists(screensReplacement) || fileExists(compReplacement)) {
+        return {
+          verdict: "approved",
+          reason: `File moved out of src/pages into a non-reserved directory for Next.js.`
+        };
+      }
+      return {
+        verdict: "rejected",
+        errors: [
+          `This file lived under src/pages as SPA UI. Next.js reserves src/pages for the Pages Router \u2014 move the tree to a non-reserved folder (e.g. src/views) and import those screens from src/app. Do not delete the UI without a replacement.`
+        ]
+      };
+    }
+  }
+  const fileName = path4.basename(filePath);
+  return {
+    verdict: "rejected",
+    errors: [
+      `File "${fileName}" does not exist on disk and has no demonstrable replacement or migration successor. Code migrations must preserve UI or migrate to a target equivalent.`
+    ]
+  };
+}
+
+// ../application/src/agents/ReviewerAgent.ts
 var ConcurrencyQueue2 = class {
   constructor(concurrencyLimit) {
     this.concurrencyLimit = concurrencyLimit;
@@ -970,15 +824,9 @@ var WhenFileMigrated = class extends SituationSpecification3 {
 };
 var WhenReviewCompleted = class extends SituationSpecification3 {
   isSatisfiedBy({ event, participant }) {
-    console.log(`[DEBUG:WhenReviewCompleted] Event received -> type: "${event.type}", producerId: "${event.producerId}", participantId: "${participant.getId()}", match: ${event.type === "model.answer" && event.producerId === participant.getId()}`);
     return event.type === "model.answer" && event.producerId === participant.getId();
   }
 };
-var WhenAnythingHappens = class extends SituationSpecification3 {
-  isSatisfiedBy() {
-    return true;
-  }
-};
 var reviewFileProcessor = {
   async apply({ event, participant }) {
     const payload = event.payload;
@@ -986,10 +834,9 @@ var reviewFileProcessor = {
     reviewerQueue.enqueue(async () => {
       return new Promise(async (originalResolve) => {
         let isDone = false;
-        const resolve5 = () => {
+        const resolve4 = () => {
           if (!isDone) {
             isDone = true;
-            console.log(`[DEBUG:ReviewerAgent] Promise resolved for ${payload.filePath}`);
             originalResolve();
           }
         };
@@ -1003,33 +850,22 @@ var reviewFileProcessor = {
           tools: [],
           // No tools to avoid Gemini thought_signature crash
           handlers: [
-            // DEBUG: Catch-all handler to log every event this agent receives
-            {
-              specification: new WhenAnythingHappens(),
-              processor: {
-                async apply({ event: anyEvent, participant: anyParticipant }) {
-                  console.log(`[DEBUG:ReviewerAgent:${reviewerId}:CATCH_ALL] Event -> type: "${anyEvent.type}", producerId: "${anyEvent.producerId}", myId: "${anyParticipant.getId()}", payload keys: ${Object.keys(anyEvent.payload || {}).join(",")}`);
-                }
-              }
-            },
             {
               specification: new WhenReviewCompleted(),
               processor: {
                 async apply({ event: event2, participant: tempParticipant }) {
-                  console.log(`[DEBUG:ReviewerAgent:${reviewerId}] model.answer RECEIVED!`);
+                  if (isDone) {
+                    return;
+                  }
                   const answerItem = event2.payload.answer;
                   const answerText = answerItem?.content?.text || answerItem?.text || null;
-                  console.log(`[DEBUG:ReviewerAgent:${reviewerId}] answerText:`, answerText);
                   let reviewResult = null;
                   if (answerText) {
                     try {
                       reviewResult = JSON.parse(answerText);
-                      console.log(`[DEBUG:ReviewerAgent:${reviewerId}] Parsed result:`, JSON.stringify(reviewResult));
                     } catch (e) {
                       console.error(`[ReviewerAgent:${reviewerId}] Failed to parse JSON:`, e);
                     }
-                  } else {
-                    console.warn(`[DEBUG:ReviewerAgent:${reviewerId}] answerItem has no extractable text.`);
                   }
                   if (reviewResult) {
                     const participantId = tempParticipant.getId();
@@ -1066,28 +902,39 @@ var reviewFileProcessor = {
                     }
                   }
                   leave(tempParticipant);
-                  resolve5();
+                  resolve4();
                 }
               }
             }
           ]
         });
-        console.log(`[DEBUG:ReviewerAgent:${reviewerId}] tempAgent created with id: ${tempAgent.getId()}`);
         join(tempAgent);
-        console.log(`[DEBUG:ReviewerAgent:${reviewerId}] tempAgent joined the runtime`);
         const runtime = resolveRuntime();
         const { existsSync: existsSync8 } = await import("fs");
         if (!existsSync8(payload.filePath)) {
           const { sendEvent: sendEvent4 } = await import("./runtime-L7VOQROE.js");
           const planForMissing = await runtime.state.repository.getPlan(payload.planId);
-          const target = planForMissing?.profile.target;
+          const sourceFramework = planForMissing?.profile.source || "react";
+          const targetFramework = planForMissing?.profile.target || "next";
           const shadowRoot = findShadowRoot(payload.filePath);
-          const deletedFsdPage = target === "next" && isFsdPageComponent(payload.filePath);
-          const viewsReplacement = payload.filePath.replace(/([/\\])src\1pages\1/, "$1src$1views$1");
-          const fsdMovedToViews = deletedFsdPage && existsSync8(viewsReplacement);
-          const deletedRootWithoutRoutes = target === "next" && isSpaRootComponent(payload.filePath) && (!shadowRoot || !hasNextAppRoutes(shadowRoot));
-          if (deletedFsdPage && !fsdMovedToViews || deletedRootWithoutRoutes) {
-            console.log(`[ReviewerAgent:${reviewerId}] Missing ${payload.filePath} is not a valid Next.js move. Rejecting.`);
+          const classification = classifyMissingFile({
+            filePath: payload.filePath,
+            source: sourceFramework,
+            target: targetFramework,
+            shadowRoot,
+            fileExists: existsSync8
+          });
+          if (classification.verdict === "approved") {
+            console.log(`[ReviewerAgent:${reviewerId}] Missing ${payload.filePath} approved: ${classification.reason}`);
+            await runtime.state.repository.updateTaskStatus(payload.planId, payload.filePath, "completed");
+            sendEvent4({
+              type: "file.reviewed" /* FILE_REVIEWED */,
+              producerId: tempAgent.getId(),
+              occurredAt: /* @__PURE__ */ new Date(),
+              payload: { planId: payload.planId, filePath: payload.filePath }
+            }, tempAgent.getId());
+          } else {
+            console.log(`[ReviewerAgent:${reviewerId}] Missing ${payload.filePath} rejected:`, classification.errors);
             sendEvent4({
               type: "file.rejected" /* FILE_REJECTED */,
               producerId: tempAgent.getId(),
@@ -1095,27 +942,12 @@ var reviewFileProcessor = {
               payload: {
                 planId: payload.planId,
                 filePath: payload.filePath,
-                errors: deletedFsdPage ? [
-                  "This file lived under src/pages as SPA UI. Next.js reserves src/pages for the Pages Router \u2014 move the tree to a non-reserved folder and import those screens from src/app. Do not delete the UI without a replacement."
-                ] : [
-                  "The SPA root was deleted before src/app/**/page.tsx existed with real UI. Recreate routing as Next App Router pages that import the original screen components. Do not import App from those pages."
-                ]
+                errors: classification.errors || ["File does not exist and has no demonstrable replacement"]
               }
             }, tempAgent.getId());
-            leave(tempAgent);
-            resolve5();
-            return;
           }
-          console.log(`[ReviewerAgent:${reviewerId}] File ${payload.filePath} does not exist on disk (likely intentionally deleted/moved). Auto-approving.`);
-          await runtime.state.repository.updateTaskStatus(payload.planId, payload.filePath, "completed");
-          sendEvent4({
-            type: "file.reviewed" /* FILE_REVIEWED */,
-            producerId: tempAgent.getId(),
-            occurredAt: /* @__PURE__ */ new Date(),
-            payload: { planId: payload.planId, filePath: payload.filePath }
-          }, tempAgent.getId());
           leave(tempAgent);
-          resolve5();
+          resolve4();
           return;
         }
         if (payload.filePath.endsWith(".ts") || payload.filePath.endsWith(".tsx")) {
@@ -1139,7 +971,7 @@ var reviewFileProcessor = {
                 }
               }, tempAgent.getId());
               leave(tempAgent);
-              resolve5();
+              resolve4();
               return;
             }
           } catch (e) {
@@ -1164,7 +996,7 @@ var reviewFileProcessor = {
                 payload: { planId: payload.planId, filePath: payload.filePath, errors }
               }, tempAgent.getId());
               leave(tempAgent);
-              resolve5();
+              resolve4();
               return;
             }
           }
@@ -1174,7 +1006,7 @@ var reviewFileProcessor = {
         if (plan) {
           prompt += `Migration Profile: Transform from ${plan.profile.source} to ${plan.profile.target}.
 `;
-          const catalogEntry = findMigrationCatalogEntry(plan.profile.source, plan.profile.target);
+          const catalogEntry = resolveMigrationCatalog(plan.profile.source, plan.profile.target);
           if (catalogEntry) {
             prompt += `
 Architectural rules (all \u2192 ${catalogEntry.layer} \u2192 frameworks \u2192 this pair; apply only if relevant to this file):
@@ -1196,7 +1028,6 @@ Compare the diff to imported modules in the evidence. If props/exports do not ma
         const modelToUse = process.env.METAMORPH_REVIEWER_MODEL || process.env.METAMORPH_MODEL || "gpt-5.4";
         console.log(`[ReviewerAgent:${reviewerId}] Starting inference loop for ${payload.filePath} with model ${modelToUse}...`);
         try {
-          console.log(`[DEBUG:ReviewerAgent:${reviewerId}] Calling runLoop with agentId: ${tempAgent.getId()}`);
           runLoop(tempAgent.getId(), prompt, {
             model: modelToUse,
             context: tempAgent.getMemory().getContext(),
@@ -1214,23 +1045,22 @@ Compare the diff to imported modules in the evidence. If props/exports do not ma
               strict: true
             }
           });
-          console.log(`[DEBUG:ReviewerAgent:${reviewerId}] runLoop called successfully (fire-and-forget)`);
           setTimeout(async () => {
             if (!isDone) {
-              console.error(`[ReviewerAgent:${reviewerId}] \u23F0 TIMEOUT after 45s for ${payload.filePath}. Model never responded.`);
+              console.error(`[ReviewerAgent:${reviewerId}] \u23F0 TIMEOUT after 120s for ${payload.filePath}. Model never responded.`);
               const { resolveRuntime: resolveRuntime2 } = await import("./runtime-L7VOQROE.js");
               const runtime2 = resolveRuntime2();
-              await runtime2.state.repository.updateTaskStatus(payload.planId, payload.filePath, "failed", "Inference timed out after 45s");
+              await runtime2.state.repository.updateTaskStatus(payload.planId, payload.filePath, "failed", "Inference timed out after 120s");
               sendEvent3({
                 type: "file.failed" /* FILE_FAILED */,
                 producerId: tempAgent.getId(),
                 occurredAt: /* @__PURE__ */ new Date(),
-                payload: { planId: payload.planId, filePath: payload.filePath, reason: "Inference timed out after 45s" }
+                payload: { planId: payload.planId, filePath: payload.filePath, reason: "Inference timed out after 120s" }
               }, tempAgent.getId());
               leave(tempAgent);
-              resolve5();
+              resolve4();
             }
-          }, 45e3);
+          }, 12e4);
         } catch (error) {
           console.error(`[ReviewerAgent:${reviewerId}] Sync error:`, error);
           if (!isDone) {
@@ -1245,7 +1075,7 @@ Compare the diff to imported modules in the evidence. If props/exports do not ma
               payload: { planId: payload.planId, filePath: payload.filePath, reason: errorMessage || "Sync error" }
             }, tempAgent.getId());
             leave(tempAgent);
-            resolve5();
+            resolve4();
           }
         }
       });
@@ -1312,7 +1142,7 @@ var managePackagesProcessor = {
       await emitPackagesReady("failed");
       return;
     }
-    const catalogEntry = findMigrationCatalogEntry(plan.profile.source, plan.profile.target);
+    const catalogEntry = resolveMigrationCatalog(plan.profile.source, plan.profile.target);
     if (!catalogEntry) {
       console.log(`[PackageManagerAgent] No catalog entry found for ${plan.profile.source} -> ${plan.profile.target}`);
       await emitPackagesReady("failed");
@@ -1389,7 +1219,7 @@ var managePackagesProcessor = {
           type: "system.log" /* SYSTEM_LOG */,
           producerId: participant.getId(),
           occurredAt: /* @__PURE__ */ new Date(),
-          payload: { planId: payload.planId, message: "PackageManager updated package.json. IntegrationAgent will run npm install in the shadow workspace \u2014 the original project is untouched until you Apply.", level: "info" }
+          payload: { planId: payload.planId, message: "Dependencies updated in package.json: target framework libraries and build scripts configured.", level: "info" }
         }, participant.getId());
       } catch (err) {
         console.error(`[PackageManagerAgent] Error editing package.json:`, err);
@@ -1490,7 +1320,7 @@ var startWatchdogProcessor = {
       occurredAt: /* @__PURE__ */ new Date(),
       payload: {
         planId: p.planId,
-        message: "Coordinator watchdog is on: if file work settles and Integration never starts, it will kick within 8s. No extra model calls.",
+        message: "Swarm coordinator active: orchestrating agent tasks and monitoring workflow progress.",
         level: "info"
       }
     }, producerId);
@@ -1509,10 +1339,26 @@ var startWatchdogProcessor = {
             occurredAt: /* @__PURE__ */ new Date(),
             payload: {
               planId: p.planId,
-              message: "Coordinator watchdog stopped after 30 minutes. Integration never became ready (files still in progress, or the run stalled).",
-              level: "warning"
+              message: "Migration session timed out after 30 minutes: task completion could not be verified.",
+              level: "error"
             }
           }, producerId);
+          const currentPlan = await runtime.state.repository.getPlan(p.planId);
+          if (currentPlan && currentPlan.phase !== "completed" && currentPlan.phase !== "failed") {
+            currentPlan.phase = "failed";
+            currentPlan.outcome = "failed";
+            await runtime.state.repository.savePlan(currentPlan);
+            sendEvent({
+              type: "migration.completed" /* MIGRATION_COMPLETED */,
+              producerId,
+              occurredAt: /* @__PURE__ */ new Date(),
+              payload: {
+                planId: p.planId,
+                outcome: "failed",
+                reason: "Migration timed out after 30 minutes watchdog budget."
+              }
+            }, producerId);
+          }
           return;
         }
         await emitIntegrationIfReady(producerId, p.planId);
@@ -1552,7 +1398,7 @@ function log(participantId, planId, message, level = "info") {
 }
 async function shadowPathFor(plan, journal) {
   if (journal?.shadowPath) return journal.shadowPath;
-  const { ShadowWorkspace: ShadowWorkspace2 } = await import("./src-2UXWWNPF.js");
+  const { ShadowWorkspace: ShadowWorkspace2 } = await import("./src-Q3DGKZEQ.js");
   return new ShadowWorkspace2().getShadowPath(plan.runId);
 }
 function fallbackReport(params) {
@@ -1561,10 +1407,15 @@ function fallbackReport(params) {
   const rejected = params.notes.filter((n) => n.outcome === "rejected" || n.outcome === "fatal");
   const fileLines = params.tasks.filter((t) => !t.filePath.startsWith("system:")).slice(0, 40).map((t) => `- \`${t.filePath}\` \u2014 ${t.status}${t.error ? ` (${t.error})` : ""}`).join("\n");
   const riskLines = rejected.slice(0, 12).map((n) => `- \`${n.filePath}\`: ${n.detail || n.outcome}`).join("\n");
+  const pm = params.packageManager || "npm";
+  const devCmd = pm === "yarn" ? "yarn dev" : `${pm} run dev`;
+  const buildCmd = pm === "yarn" ? "yarn build" : `${pm} run build`;
   return `# What changed
 
 Metamorph migrated this project from **${params.source}** to **${params.target}**.
-${params.phase === "failed" ? "\n**Status:** shadow `npm run build` (or catalog checks) did not pass. Treat this as an incomplete migration.\n" : ""}
+${params.phase === "failed" ? `
+**Status:** shadow \`${buildCmd}\` (or catalog checks) did not pass. Treat this as an incomplete migration.
+` : ""}
 Your original files were not overwritten until you click **Apply Migration**. After apply, the result lives on a git branch named like \`metamorph/${params.runId}\`.
 
 ## How to run it
@@ -1572,8 +1423,8 @@ Your original files were not overwritten until you click **Apply Migration**. Af
 1. Apply the migration in the dashboard (or keep working in the shadow workspace).
 2. From the project folder:
    \`\`\`bash
-   npm install
-   npm run dev
+   ${pm} install
+   ${devCmd}
    \`\`\`
 3. Open the URL the framework prints (\`next dev\` \u2192 port 3000, Vite \u2192 5173).
 
@@ -1705,6 +1556,8 @@ var fatalProcessor = {
 };
 function draftPrompt(params) {
   const notable = params.notes.filter((n) => n.outcome === "rejected" || n.outcome === "fatal").slice(-15).map((n) => `${n.filePath}: ${n.detail || n.outcome}`).join("\n");
+  const pm = params.plan.packageManager || "npm";
+  const devCmd = pm === "yarn" ? "yarn dev" : `${pm} run dev`;
   return `Write a user-facing migration briefing to this exact path:
 ${params.reportAbs}
 
@@ -1717,10 +1570,10 @@ Run id: ${params.plan.runId}
 
 Include these sections, in this order, with markdown headings:
 1. What changed \u2014 1-2 short paragraphs in plain language
-2. How to run it \u2014 concrete commands (npm install, npm run dev, which port if you can infer from package.json)
+2. How to run it \u2014 concrete commands (${pm} install, ${devCmd}, which port if you can infer from package.json)
 3. What we touched \u2014 group by area (routes, styles, config, dependencies). Do not dump every file as a checklist unless there are under 12 files.
 4. Watch out for \u2014 honest risks from the notes below and from reading package.json / the new entry files
-5. Next steps after Apply \u2014 git branch checkout if they applied, npm install on the real project
+5. Next steps after Apply \u2014 git branch checkout if they applied, ${pm} install on the real project
 
 You may read package.json, README, src/app/layout.tsx, src/main.tsx, index.html, or MIGRATION.md if they exist.
 
@@ -1753,7 +1606,8 @@ var draftDuringInstallProcessor = {
       phase: plan.phase,
       tasks: plan.tasks || [],
       notes: board.notes,
-      startedAt: board.startedAt
+      startedAt: board.startedAt,
+      packageManager: plan.packageManager
     });
     const tools = participant.getTools();
     if (tools.length === 0) {
@@ -1824,34 +1678,37 @@ var completedProcessor = {
     const plan = await runtime.state.repository.getPlan(p.planId);
     if (!plan) return;
     const shadowPath = await shadowPathFor(plan, board);
+    const isFailed = plan.phase === "failed" || plan.outcome === "failed" || p.outcome === "failed";
+    const effectivePhase = isFailed ? "failed" : plan.phase || "completed";
     const draft = fallbackReport({
       source: plan.profile.source,
       target: plan.profile.target,
       targetPath: plan.targetPath,
       runId: plan.runId,
-      phase: plan.phase,
+      phase: effectivePhase,
       tasks: plan.tasks || [],
       notes: board.notes,
-      startedAt: board.startedAt
+      startedAt: board.startedAt,
+      packageManager: plan.packageManager
     });
-    board.pendingStatusPhase = plan.phase === "failed" ? "failed" : "completed";
+    board.pendingStatusPhase = isFailed ? "failed" : "completed";
     try {
       const path12 = await import("path");
       const dest = path12.join(shadowPath, "MIGRATION.md");
       if (board.reportLoopActive) {
-        log(participant.getId(), p.planId, "Reporter draft is still running; Status will be patched when it finishes (no second model call).");
+        log(participant.getId(), p.planId, "Compiling comprehensive migration briefing in the background...");
         return;
       }
-      const result = await writeOrPatchMigrationMd(dest, plan.phase, draft);
+      const result = await writeOrPatchMigrationMd(dest, effectivePhase, draft);
       board.pendingStatusPhase = void 0;
       log(
         participant.getId(),
         p.planId,
-        result === "patched" ? "Reporter patched MIGRATION.md with the final build Status (no extra model call)." : "Reporter finished. Open MIGRATION.md in the shadow workspace (it is copied to your project when you Apply)."
+        result === "patched" ? "Updated MIGRATION.md with final build verification status." : "Migration report ready in MIGRATION.md: review changes and run Apply to merge into your project."
       );
     } catch (error) {
       console.error("[ReporterAgent] Could not ensure MIGRATION.md:", error);
-      log(participant.getId(), p.planId, "Reporter could not write MIGRATION.md.", "warning");
+      log(participant.getId(), p.planId, "Could not generate MIGRATION.md report.", "warning");
     }
   }
 };
@@ -1890,44 +1747,81 @@ async function completeMigration(participantId, planId, message, level) {
   const runtime = resolveRuntime();
   const plan = await runtime.state.repository.getPlan(planId);
   if (plan) {
+    let swept = 0;
+    for (const task of plan.tasks) {
+      if (task.status === "failed" && !task.filePath.startsWith("system:")) {
+        await runtime.state.repository.updateTaskStatus(
+          planId,
+          task.filePath,
+          "completed"
+        );
+        swept++;
+      }
+    }
+    if (swept > 0) {
+      console.log(
+        `[IntegrationAgent] Swept ${swept} residual failed task(s) \u2192 completed (shadow build passed).`
+      );
+    }
     plan.phase = "completed";
+    plan.outcome = "success";
     await runtime.state.repository.savePlan(plan);
   }
-  sendEvent({
-    type: "system.log" /* SYSTEM_LOG */,
-    producerId: participantId,
-    occurredAt: /* @__PURE__ */ new Date(),
-    payload: { planId, message, level }
-  }, participantId);
-  sendEvent({
-    type: "migration.completed" /* MIGRATION_COMPLETED */,
-    producerId: participantId,
-    occurredAt: /* @__PURE__ */ new Date(),
-    payload: { planId }
-  }, participantId);
+  sendEvent(
+    {
+      type: "system.log" /* SYSTEM_LOG */,
+      producerId: participantId,
+      occurredAt: /* @__PURE__ */ new Date(),
+      payload: { planId, message, level }
+    },
+    participantId
+  );
+  sendEvent(
+    {
+      type: "migration.completed" /* MIGRATION_COMPLETED */,
+      producerId: participantId,
+      occurredAt: /* @__PURE__ */ new Date(),
+      payload: {
+        planId,
+        outcome: "success"
+      }
+    },
+    participantId
+  );
 }
 function log2(participantId, planId, message, level = "info") {
-  sendEvent({
-    type: "system.log" /* SYSTEM_LOG */,
-    producerId: participantId,
-    occurredAt: /* @__PURE__ */ new Date(),
-    payload: { planId, message, level }
-  }, participantId);
+  sendEvent(
+    {
+      type: "system.log" /* SYSTEM_LOG */,
+      producerId: participantId,
+      occurredAt: /* @__PURE__ */ new Date(),
+      payload: { planId, message, level }
+    },
+    participantId
+  );
 }
 async function failMigration(participantId, planId, message) {
   const runtime = resolveRuntime();
   const plan = await runtime.state.repository.getPlan(planId);
   if (plan) {
     plan.phase = "failed";
+    plan.outcome = "failed";
     await runtime.state.repository.savePlan(plan);
   }
   log2(participantId, planId, message, "error");
-  sendEvent({
-    type: "migration.completed" /* MIGRATION_COMPLETED */,
-    producerId: participantId,
-    occurredAt: /* @__PURE__ */ new Date(),
-    payload: { planId }
-  }, participantId);
+  sendEvent(
+    {
+      type: "migration.completed" /* MIGRATION_COMPLETED */,
+      producerId: participantId,
+      occurredAt: /* @__PURE__ */ new Date(),
+      payload: {
+        planId,
+        outcome: "failed",
+        reason: message
+      }
+    },
+    participantId
+  );
 }
 async function requeueBrokenFiles(producerId, planId, files, errors) {
   const runtime = resolveRuntime();
@@ -1945,17 +1839,20 @@ async function requeueBrokenFiles(producerId, planId, files, errors) {
       "pending",
       errors.slice(0, 3).join("\n").slice(0, 1500)
     );
-    sendEvent({
-      type: "file.rejected" /* FILE_REJECTED */,
-      producerId,
-      occurredAt: /* @__PURE__ */ new Date(),
-      payload: {
-        planId,
-        filePath,
-        errors,
-        source: "integration"
-      }
-    }, producerId);
+    sendEvent(
+      {
+        type: "file.rejected" /* FILE_REJECTED */,
+        producerId,
+        occurredAt: /* @__PURE__ */ new Date(),
+        payload: {
+          planId,
+          filePath,
+          errors,
+          source: "integration"
+        }
+      },
+      producerId
+    );
   }
   const plan = await runtime.state.repository.getPlan(planId);
   if (plan) {
@@ -1970,7 +1867,9 @@ var integrationProcessor = {
     const producerId = participant.getId();
     const locks = resolveRuntime().state.integrationLocks;
     if (locks.has(planId)) {
-      console.log(`[IntegrationAgent] Integration already running for ${planId}. Ignoring duplicate phase event.`);
+      console.log(
+        `[IntegrationAgent] Integration already running for ${planId}. Ignoring duplicate phase event.`
+      );
       return;
     }
     locks.add(planId);
@@ -1982,7 +1881,9 @@ var integrationProcessor = {
         return;
       }
       if (plan.phase === "completed" || plan.phase === "failed") {
-        console.log(`[IntegrationAgent] Plan ${planId} already finished (${plan.phase}). Ignoring extra integration phase.`);
+        console.log(
+          `[IntegrationAgent] Plan ${planId} already finished (${plan.phase}). Ignoring extra integration phase.`
+        );
         return;
       }
       plan.phase = "integration";
@@ -1998,37 +1899,101 @@ var integrationProcessor = {
       plan.integrationRounds = currentRound + 1;
       await runtime.state.repository.savePlan(plan);
       const lastRound = plan.integrationRounds >= MAX_INTEGRATION_ROUNDS;
-      const { ShadowWorkspace: ShadowWorkspace2, createReadFileTool: createReadFileTool2, createWriteFileTool: createWriteFileTool2, createListDirectoryTool: createListDirectoryTool2, createRunBuildTool: createRunBuildTool2, runInShadowWorkspace, parseImplicatedFiles } = await import("./src-2UXWWNPF.js");
+      const {
+        ShadowWorkspace: ShadowWorkspace2,
+        createReadFileTool: createReadFileTool2,
+        createWriteFileTool: createWriteFileTool2,
+        createListDirectoryTool: createListDirectoryTool2,
+        createRunBuildTool: createRunBuildTool2,
+        runInShadowWorkspace,
+        parseImplicatedFiles
+      } = await import("./src-Q3DGKZEQ.js");
       const { collectShadowIssues, collectRepairTargets } = await import("./registry-7WZ5RTGE.js");
-      const { findMigrationCatalogEntry: findMigrationCatalogEntry2 } = await import("./src-UC3SN46X.js");
+      const { resolveMigrationCatalog: resolveMigrationCatalog2 } = await import("./src-YPCIVBLZ.js");
       const shadowPath = payload.shadowWorkspacePath || new ShadowWorkspace2().getShadowPath(plan.runId);
-      console.log(`[IntegrationAgent] Shadow build round ${plan.integrationRounds}/${MAX_INTEGRATION_ROUNDS} in ${shadowPath}`);
-      log2(producerId, planId, `File migration is done. Next: install dependencies in the shadow workspace (npm install). This can take several minutes \u2014 counters staying at 0 is expected.`);
-      console.log(`[IntegrationAgent] npm install starting in ${shadowPath}`);
+      const pmCommands = resolvePackageManagerCommands(plan.packageManager);
+      console.log(
+        `[IntegrationAgent] Shadow build round ${plan.integrationRounds}/${MAX_INTEGRATION_ROUNDS} in ${shadowPath}`
+      );
+      log2(
+        producerId,
+        planId,
+        `Source files transformed. Installing dependencies in shadow workspace with ${pmCommands.cleanInstall}...`
+      );
+      console.log(`[IntegrationAgent] ${pmCommands.cleanInstall} starting in ${shadowPath}`);
       let lastInstallBeat = Date.now();
-      const install = await runInShadowWorkspace(shadowPath, "npm install --no-fund --no-audit", (chunk) => {
-        process.stdout.write(chunk);
-        if (Date.now() - lastInstallBeat >= 15e3) {
-          lastInstallBeat = Date.now();
-          log2(producerId, planId, "npm install is still running in the shadow workspace. Wait \u2014 this is not finished.");
+      const install = await runInShadowWorkspace(
+        shadowPath,
+        pmCommands.cleanInstall,
+        (chunk) => {
+          process.stdout.write(chunk);
+          if (Date.now() - lastInstallBeat >= 15e3) {
+            lastInstallBeat = Date.now();
+            log2(
+              producerId,
+              planId,
+              `${pmCommands.cleanInstall} is in progress in the shadow workspace...`
+            );
+          }
         }
-      });
+      );
       if (!install.ok) {
-        console.warn("[IntegrationAgent] npm install failed in shadow:", install.output.slice(0, 2e3));
-        log2(producerId, planId, "npm install failed in the shadow workspace. Continuing to build anyway.", "warning");
-      } else {
-        log2(producerId, planId, "npm install finished. Next: npm run build in the shadow workspace.");
+        console.warn(
+          `[IntegrationAgent] ${pmCommands.cleanInstall} failed in shadow:`,
+          install.output.slice(0, 2e3)
+        );
+        log2(
+          producerId,
+          planId,
+          `${pmCommands.cleanInstall} failed in the shadow workspace. Halting to diagnose dependency conflicts.`,
+          "error"
+        );
+        if (lastRound) {
+          await failMigration(
+            producerId,
+            planId,
+            `${pmCommands.cleanInstall} failed in the shadow workspace after ${MAX_INTEGRATION_ROUNDS} integration rounds. The migration could not complete.`
+          );
+          return;
+        }
+        const path12 = await import("path");
+        const pkgPath = path12.join(shadowPath, "package.json");
+        await requeueBrokenFiles(
+          producerId,
+          planId,
+          [pkgPath],
+          [`${pmCommands.cleanInstall} failed in shadow workspace:
+${install.output.slice(0, 2500)}`]
+        );
+        return;
       }
+      log2(
+        producerId,
+        planId,
+        `Dependencies installed successfully. Running verification build (${pmCommands.runBuild})...`
+      );
       let lastBuildBeat = Date.now();
-      let build = await runInShadowWorkspace(shadowPath, "npm run build", (chunk) => {
-        process.stdout.write(chunk);
-        if (Date.now() - lastBuildBeat >= 15e3) {
-          lastBuildBeat = Date.now();
-          log2(producerId, planId, "npm run build is still running in the shadow workspace. Wait \u2014 this is not finished.");
+      let build = await runInShadowWorkspace(
+        shadowPath,
+        pmCommands.runBuild,
+        (chunk) => {
+          process.stdout.write(chunk);
+          if (Date.now() - lastBuildBeat >= 15e3) {
+            lastBuildBeat = Date.now();
+            log2(
+              producerId,
+              planId,
+              `${pmCommands.runBuild} is in progress in the shadow workspace...`
+            );
+          }
         }
-      });
+      );
       if (!build.ok) {
-        log2(producerId, planId, "Shadow build failed. IntegrationAgent will attempt local repairs before requeueing files.");
+        log2(
+          producerId,
+          planId,
+          "Verification build encountered errors. Analyzing diagnostics for automated repair..."
+        );
         const shadowTools = [
           createReadFileTool2(shadowPath),
           createWriteFileTool2(shadowPath),
@@ -2038,7 +2003,7 @@ var integrationProcessor = {
         const { createAgent: createMozaikAgent } = await import("@mozaik-ai/core");
         await new Promise((originalResolve) => {
           let isDone = false;
-          const resolve5 = () => {
+          const resolve4 = () => {
             if (!isDone) {
               isDone = true;
               originalResolve();
@@ -2063,32 +2028,51 @@ Build output:
 ${excerpt}
 
 When you have applied fixes (or cannot fix further), stop. A deterministic rebuild will run after you finish.`;
-          Promise.resolve(runLoop(tempAgent.getId(), prompt, {
-            model: modelToUse,
-            context: tempAgent.getMemory().getContext(),
-            tools: shadowTools
-          })).catch((error) => {
+          Promise.resolve(
+            runLoop(tempAgent.getId(), prompt, {
+              model: modelToUse,
+              context: tempAgent.getMemory().getContext(),
+              tools: shadowTools
+            })
+          ).catch((error) => {
             console.error("[IntegrationAgent] runLoop error:", error);
             leave(tempAgent);
-            resolve5();
+            resolve4();
           });
           setTimeout(() => {
             if (!isDone) {
-              console.warn("[IntegrationAgent] Repair loop timed out; continuing with deterministic rebuild.");
+              console.warn(
+                "[IntegrationAgent] Repair loop timed out; continuing with deterministic rebuild."
+              );
               leave(tempAgent);
-              resolve5();
+              resolve4();
             }
           }, REPAIR_TIMEOUT_MS);
         });
         build = await runInShadowWorkspace(shadowPath, "npm run build");
       }
-      const pluginCtx = { source: plan.profile.source, target: plan.profile.target };
-      const catalogEntry = findMigrationCatalogEntry2(plan.profile.source, plan.profile.target);
-      const structureIssues = collectShadowIssues(shadowPath, pluginCtx, catalogEntry?.layer);
+      const pluginCtx = {
+        source: plan.profile.source,
+        target: plan.profile.target
+      };
+      const catalogEntry = resolveMigrationCatalog2(
+        plan.profile.source,
+        plan.profile.target
+      );
+      const structureIssues = collectShadowIssues(
+        shadowPath,
+        pluginCtx,
+        catalogEntry?.layer
+      );
       const buildFailed = !build.ok || !install.ok;
       const verifierFailed = structureIssues.length > 0;
       if (!buildFailed && !verifierFailed) {
-        await completeMigration(producerId, planId, "Shadow build succeeded. Reporter is writing MIGRATION.md next. Then Apply copies the result into your project.", "info");
+        await completeMigration(
+          producerId,
+          planId,
+          "Verification build succeeded cleanly. Generating final migration report and instructions...",
+          "info"
+        );
         return;
       }
       const implicated = parseImplicatedFiles(
@@ -2103,29 +2087,38 @@ When you have applied fixes (or cannot fix further), stop. A deterministic rebui
       });
       const errors = [
         ...structureIssues.flatMap((issue) => issue.errors),
-        ...install.ok ? [] : [`npm install failed:
+        ...install.ok ? [] : [`${pmCommands.cleanInstall} failed:
 ${install.output.slice(0, 1500)}`],
-        ...build.ok ? [] : [`npm run build failed:
+        ...build.ok ? [] : [`${pmCommands.runBuild} failed:
 ${build.output.slice(0, 2500)}`]
       ];
       if (!lastRound && repairFiles.length > 0) {
         log2(
           producerId,
           planId,
-          buildFailed ? "npm run build (or npm install) failed. Assigning repair tasks to Worker \u2014 the run is not finished." : `Shadow compile may succeed while the app is still wrong: ${structureIssues.length} verifier issue(s). Assigning repair tasks.`,
+          buildFailed ? `Verification build failed. Reopening implicated files for automated repair...` : `Structure verifier identified ${structureIssues.length} architectural issue(s). Reopening files for repair...`,
           "warning"
         );
-        await requeueBrokenFiles(producerId, planId, repairFiles, errors.length > 0 ? errors : ["Shadow verification failed."]);
+        await requeueBrokenFiles(
+          producerId,
+          planId,
+          repairFiles,
+          errors.length > 0 ? errors : ["Shadow verification failed."]
+        );
         return;
       }
       await failMigration(
         producerId,
         planId,
-        lastRound ? `npm run build still does not pass after ${MAX_INTEGRATION_ROUNDS} integration rounds. The migration is not successful.` : "Shadow verification failed and no repair files could be assigned."
+        lastRound ? `Verification build did not pass after ${MAX_INTEGRATION_ROUNDS} integration rounds. Please inspect MIGRATION.md for diagnostic details.` : "Shadow verification failed and no repair targets could be assigned."
       );
     } catch (error) {
       console.error(`[IntegrationAgent] Error:`, error);
-      await failMigration(producerId, planId, "Integration Phase encountered an error. The migration is not successful.");
+      await failMigration(
+        producerId,
+        planId,
+        "Integration Phase encountered an error. The migration is not successful."
+      );
     } finally {
       resolveRuntime().state.integrationLocks.delete(planId);
     }
@@ -2781,16 +2774,21 @@ var MigrationRunner = class {
    */
   async startMigration(request) {
     this.ensureInitialized();
-    await this.store.reset();
-    this.workspace.cleanupOldRuns(3);
+    const existing = await this.store.getAllPlans();
+    const protectedRunIds = existing.filter((p) => p.appliedAt).map((p) => p.runId);
+    this.workspace.cleanupOldRuns(3, protectedRunIds);
     const runId = `run_${Date.now()}`;
     const shadowPath = this.workspace.cloneDirectory(request.targetPath, runId);
     const planId = `plan_${randomUUID()}`;
+    const manifest = inspectManifest(request.targetPath);
+    const resolvedPackageManager = request.packageManager || manifest.packageManager || "npm";
     const plan = {
       id: planId,
       runId,
       profile: { source: request.from, target: request.to },
       targetPath: request.targetPath,
+      packageManager: resolvedPackageManager,
+      phase: "files",
       tasks: [
         { filePath: "system:package_manager", status: "pending" }
       ],
@@ -2809,7 +2807,8 @@ var MigrationRunner = class {
         payload: {
           planId,
           profile: plan.profile,
-          shadowWorkspacePath: shadowPath
+          shadowWorkspacePath: shadowPath,
+          packageManager: resolvedPackageManager
         }
       },
       dispatcherId
@@ -2889,9 +2888,18 @@ function bootstrapMetamorph(repository, tools = []) {
 }
 
 // src/index.ts
+function logStartupContext() {
+  const isDev = process.env.METAMORPH_DEV === "1";
+  console.log(chalk.gray(`[Metamorph] CWD: ${process.cwd()}`));
+  console.log(chalk.gray(`[Metamorph] Binary: ${import.meta.url}`));
+  if (!isDev && import.meta.url.includes("/src/")) {
+    console.log(chalk.yellow(`[Metamorph] Notice: Running directly from source without METAMORPH_DEV=1.`));
+  }
+}
 var program = new Command();
-program.name("metamorph").description("AI-powered technology migration tool using Mozaik Agents").version("1.0.0");
+program.name("metamorph").description("AI-powered technology migration tool using Mozaik Agents").version("2.1.2");
 program.command("run [path]").description("Run a migration on the specified directory").option("--from <source>", "Source framework (e.g. express)").option("--to <target>", "Target framework (e.g. fastify)").action(async (targetPathArg, options) => {
+  logStartupContext();
   let targetPath = targetPathArg || ".";
   const { select, input } = await import("@inquirer/prompts");
   let from = options.from;
@@ -2906,15 +2914,42 @@ program.command("run [path]").description("Run a migration on the specified dire
     angular: ["react", "next", "vue", "svelte"],
     svelte: ["react", "next", "vue", "angular"]
   };
+  const monorepo = detectMonorepo(targetPath);
+  if (monorepo.isMonorepo && monorepo.packages.length > 0) {
+    console.log(chalk.cyan(`
+\u{1F4E6} Monorepo detected (${monorepo.tool || "workspaces"} with ${monorepo.packages.length} packages).`));
+    const chosenPath = await select({
+      message: "Select the workspace package you want to migrate:",
+      choices: [
+        ...monorepo.packages.map((p) => ({
+          name: `${p.name} (${p.relativePath})`,
+          value: p.absolutePath
+        })),
+        {
+          name: `Whole root directory (${targetPath})`,
+          value: targetPath
+        }
+      ]
+    });
+    targetPath = chosenPath;
+  }
   if (!from) {
     console.log(chalk.gray(`
 \u{1F50D} Scanning directory: ${targetPath}`));
-    const detected = detectTechnologies(targetPath);
-    const supportedDetected = detected.filter((d) => Object.keys(SUPPORTED_MIGRATIONS).includes(d.framework));
-    if (supportedDetected.length > 0) {
+    const profiles = inspectProject(targetPath);
+    const supportedProfiles = profiles.filter((p) => Object.keys(SUPPORTED_MIGRATIONS).includes(p.framework));
+    if (supportedProfiles.length > 0) {
       from = await select({
         message: "What technology do you want to migrate FROM?",
-        choices: supportedDetected.map((d) => ({ name: `${d.framework} (Detected ${d.confidence}%)`, value: d.framework }))
+        choices: supportedProfiles.map((p) => {
+          const details = [
+            p.variant !== "none" ? p.variant : null,
+            p.bundler !== "unknown" ? p.bundler : null,
+            p.language === "typescript" ? "TS" : "JS"
+          ].filter(Boolean).join(" | ");
+          const label = details ? `${p.framework} (${details} - ${p.confidence}%)` : `${p.framework} (${p.confidence}%)`;
+          return { name: label, value: p.framework };
+        })
       });
     } else {
       console.log(chalk.yellow(`No supported technologies detected in the current directory.`));
@@ -2975,11 +3010,41 @@ program.command("run [path]").description("Run a migration on the specified dire
     spinner.succeed(`Migration dispatched! Plan: ${result.planId}`);
     console.log(chalk.gray(`Shadow: ${result.shadowPath}`));
     console.log(chalk.blue(`
-\u23F3 Agents are now working...`));
-    await new Promise((resolve5) => setTimeout(resolve5, 2e4));
-    console.log(chalk.green(`
-\u2705 Migration simulation finished.`));
-    process.exit(0);
+\u23F3 Swarm is executing migration in shadow workspace...`));
+    const waitSpinner = ora("Waiting for swarm to complete migration...").start();
+    const startTime = Date.now();
+    const MAX_TIMEOUT_MS = 30 * 60 * 1e3;
+    while (true) {
+      if (Date.now() - startTime >= MAX_TIMEOUT_MS) {
+        waitSpinner.fail(chalk.red(`Migration timed out after 30 minutes.`));
+        process.exit(1);
+      }
+      await new Promise((r) => setTimeout(r, 2e3));
+      const plan = await store.getPlan(result.planId);
+      if (!plan) continue;
+      const terminalTasks = plan.tasks.filter((t) => t.status === "completed" || t.status === "failed");
+      const inProgressTasks = plan.tasks.filter((t) => t.status === "in_progress");
+      const pendingTasks = plan.tasks.filter((t) => t.status === "pending");
+      waitSpinner.text = `Phase: ${plan.phase || "files"} | Tasks: ${terminalTasks.length}/${plan.tasks.length} terminal (${inProgressTasks.length} in progress, ${pendingTasks.length} pending)`;
+      if (plan.outcome === "success") {
+        waitSpinner.succeed(chalk.green(`
+\u2705 Migration finished successfully in shadow workspace!`));
+        console.log(chalk.white(`
+Next steps:`));
+        console.log(chalk.gray(`  1. Review changes in shadow workspace: `) + chalk.cyan(result.shadowPath));
+        console.log(chalk.gray(`  2. Apply changes to a dedicated Git branch: `) + chalk.cyan(`metamorph apply ${result.runId} ${targetPath}
+`));
+        process.exit(0);
+      }
+      if (plan.phase === "failed" || plan.outcome === "failed") {
+        waitSpinner.fail(chalk.red(`
+\u274C Migration failed in shadow workspace.`));
+        console.log(chalk.yellow(`Check .metamorph/shadow/${result.runId}/MIGRATION.md or run 'metamorph ui' for failure details.`));
+        console.log(chalk.gray(`Your original codebase in "${targetPath}" remains completely untouched.
+`));
+        process.exit(1);
+      }
+    }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     spinner.fail(`Migration failed: ${errorMessage}`);
@@ -2988,8 +3053,27 @@ program.command("run [path]").description("Run a migration on the specified dire
 });
 program.command("apply <runId> <targetPath>").description("Apply a completed migration to the target project (requires Git at the project or monorepo root)").action(async (runId, targetPath) => {
   try {
+    const store = new SQLiteStateStore(".metamorph");
+    const plans = await store.getAllPlans();
+    const plan = plans.find((p) => p.runId === runId);
+    if (!plan) {
+      throw new Error(`Plan for run "${runId}" not found in database.`);
+    }
+    if (plan.phase !== "completed" || plan.outcome !== "success") {
+      throw new Error(
+        `Cannot apply migration: plan is not completed successfully (phase: "${plan.phase}", outcome: "${plan.outcome || "none"}"). Only successful migrations can be applied.`
+      );
+    }
+    if (plan.appliedAt) {
+      throw new Error(
+        `Migration for run "${runId}" has already been applied at ${new Date(plan.appliedAt).toISOString()} to branch ${plan.appliedBranch || "unknown"}.`
+      );
+    }
     const integrator = new MigrationIntegrator(new ShadowWorkspace());
     const result = await integrator.applyMigration(runId, targetPath);
+    plan.appliedAt = /* @__PURE__ */ new Date();
+    plan.appliedBranch = result.branch;
+    await store.savePlan(plan);
     console.log(chalk.green(`\u2705 ${result.message}`));
   } catch (error) {
     console.error(chalk.red(`\u274C Failed to apply migration: ${error instanceof Error ? error.message : String(error)}`));
@@ -3017,16 +3101,35 @@ program.command("reset").description("Clear all migration history and events fro
     process.exit(1);
   }
 });
-program.command("detect [path]").description("Detect frameworks and libraries in a directory").action(async (targetPath) => {
+program.command("detect [path]").description("Detect frameworks, architectural variants and monorepo structure in a directory").action(async (targetPath) => {
   try {
-    const detected = detectTechnologies(targetPath || ".");
-    if (detected.length === 0) {
-      console.log(chalk.yellow(`No known technologies detected.`));
+    const resolved = targetPath || ".";
+    const monorepo = detectMonorepo(resolved);
+    if (monorepo.isMonorepo) {
+      console.log(chalk.cyan(`
+\u{1F4E6} Monorepo Detected: ${monorepo.tool || "workspaces"}`));
+      console.log(chalk.gray(`Root: ${monorepo.rootPath}`));
+      console.log(chalk.gray(`Workspace Packages (${monorepo.packages.length}):`));
+      monorepo.packages.forEach((p) => console.log(`  \u2022 ${chalk.white(p.name)}: ${chalk.gray(p.relativePath)}`));
+    }
+    const profiles = inspectProject(resolved);
+    if (profiles.length === 0) {
+      console.log(chalk.yellow(`
+No supported technologies detected.`));
     } else {
       console.log(chalk.blue(`
-\u{1F50D} Detected Technologies:`));
-      detected.forEach((d) => console.log(` - ${chalk.green(d.framework)} (Confidence: ${d.confidence}%) 
-    Evidence: ${chalk.gray(d.evidence.join(", "))}`));
+\u{1F50D} Detected Technologies & Architecture:`));
+      profiles.forEach((p) => {
+        console.log(`
+  \u2022 ${chalk.bold.green(p.framework)} (Confidence: ${p.confidence}%)`);
+        console.log(`    Category: ${chalk.cyan(p.category)} | Variant: ${chalk.cyan(p.variant)} | Bundler: ${chalk.cyan(p.bundler)} | Lang: ${chalk.cyan(p.language.toUpperCase())}`);
+        if (p.subsumedDependencies.length > 0) {
+          console.log(`    Subsumed Dependencies: ${chalk.yellow(p.subsumedDependencies.join(", "))}`);
+        }
+        console.log(`    Suggested Targets: ${chalk.magenta(p.suggestedTargets.join(", "))}`);
+        console.log(`    Evidence: ${chalk.gray(p.evidence.join("; "))}`);
+      });
+      console.log("");
     }
   } catch (error) {
     console.error(chalk.red(`\u274C Detection failed: ${error instanceof Error ? error.message : String(error)}`));
@@ -3052,6 +3155,7 @@ program.command("list").description("List past migration plans").action(async ()
   }
 });
 program.command("ui").description("Start the Metamorph Dashboard API server").option("-p, --port <number>", "Port for the API server", "9876").action(async (options) => {
+  logStartupContext();
   let desiredPort = parseInt(options.port, 10);
   const spinner = ora("Starting Metamorph API server...").start();
   try {