@nikelyh/metamorph 2.1.1 → 2.1.2

package/dist/index.js

@@ -12,14 +12,17 @@ import {
   createRenameFileTool,
   createRunBuildTool,
   createWriteFileTool
-} from "./chunk-L7B6KUCW.js";
+} from "./chunk-APRESSUR.js";
 import {
   formatCatalogRules,
-  resolveMigrationCatalog
-} from "./chunk-VEAYUIOZ.js";
+  resolveMigrationCatalog,
+  resolvePackageManagerCommands
+} from "./chunk-WLHSZWET.js";
 import {
-  detectTechnologies
-} from "./chunk-3QN2Q75J.js";
+  detectMonorepo,
+  inspectManifest,
+  inspectProject
+} from "./chunk-XLD7NXYU.js";
 import {
   MetamorphState,
   initializeRuntime,
@@ -381,7 +384,7 @@ async function startWorkerLoop(planId, filePath, prompt, participant) {
     const shadowRoot = findShadowRoot2(filePath);
     let workerTools = participant.getTools();
     if (shadowRoot) {
-      const { createShadowTools } = await import("./src-JHOGUCRS.js");
+      const { createShadowTools } = await import("./src-Q3DGKZEQ.js");
       workerTools = createShadowTools(shadowRoot);
     }
     const tempAgent = createMozaikAgent({
@@ -1216,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);
@@ -1317,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);
@@ -1336,7 +1339,7 @@ var startWatchdogProcessor = {
             occurredAt: /* @__PURE__ */ new Date(),
             payload: {
               planId: p.planId,
-              message: "Coordinator watchdog timed out after 30 minutes. Integration never became ready or the run stalled.",
+              message: "Migration session timed out after 30 minutes: task completion could not be verified.",
               level: "error"
             }
           }, producerId);
@@ -1395,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-JHOGUCRS.js");
+  const { ShadowWorkspace: ShadowWorkspace2 } = await import("./src-Q3DGKZEQ.js");
   return new ShadowWorkspace2().getShadowPath(plan.runId);
 }
 function fallbackReport(params) {
@@ -1404,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
@@ -1415,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).
 
@@ -1548,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}
 
@@ -1560,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.
 
@@ -1596,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) {
@@ -1677,14 +1688,15 @@ var completedProcessor = {
       phase: effectivePhase,
       tasks: plan.tasks || [],
       notes: board.notes,
-      startedAt: board.startedAt
+      startedAt: board.startedAt,
+      packageManager: plan.packageManager
     });
     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, effectivePhase, draft);
@@ -1692,11 +1704,11 @@ var completedProcessor = {
       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");
     }
   }
 };
@@ -1895,23 +1907,24 @@ var integrationProcessor = {
         createRunBuildTool: createRunBuildTool2,
         runInShadowWorkspace,
         parseImplicatedFiles
-      } = await import("./src-JHOGUCRS.js");
+      } = await import("./src-Q3DGKZEQ.js");
       const { collectShadowIssues, collectRepairTargets } = await import("./registry-7WZ5RTGE.js");
-      const { resolveMigrationCatalog: resolveMigrationCatalog2 } = await import("./src-UC3SN46X.js");
+      const { resolveMigrationCatalog: resolveMigrationCatalog2 } = await import("./src-YPCIVBLZ.js");
       const shadowPath = payload.shadowWorkspacePath || new ShadowWorkspace2().getShadowPath(plan.runId);
+      const pmCommands = resolvePackageManagerCommands(plan.packageManager);
       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.`
+        `Source files transformed. Installing dependencies in shadow workspace with ${pmCommands.cleanInstall}...`
       );
-      console.log(`[IntegrationAgent] npm install starting in ${shadowPath}`);
+      console.log(`[IntegrationAgent] ${pmCommands.cleanInstall} starting in ${shadowPath}`);
       let lastInstallBeat = Date.now();
       const install = await runInShadowWorkspace(
         shadowPath,
-        "npm install --no-fund --no-audit",
+        pmCommands.cleanInstall,
         (chunk) => {
           process.stdout.write(chunk);
           if (Date.now() - lastInstallBeat >= 15e3) {
@@ -1919,27 +1932,27 @@ var integrationProcessor = {
             log2(
               producerId,
               planId,
-              "npm install is still running in the shadow workspace. Wait \u2014 this is not finished."
+              `${pmCommands.cleanInstall} is in progress in the shadow workspace...`
             );
           }
         }
       );
       if (!install.ok) {
         console.warn(
-          "[IntegrationAgent] npm install failed in shadow:",
+          `[IntegrationAgent] ${pmCommands.cleanInstall} failed in shadow:`,
           install.output.slice(0, 2e3)
         );
         log2(
           producerId,
           planId,
-          "npm install failed in the shadow workspace. Halting build to avoid noisy compile errors.",
+          `${pmCommands.cleanInstall} failed in the shadow workspace. Halting to diagnose dependency conflicts.`,
           "error"
         );
         if (lastRound) {
           await failMigration(
             producerId,
             planId,
-            `npm install failed in the shadow workspace after ${MAX_INTEGRATION_ROUNDS} integration rounds. The migration is not successful.`
+            `${pmCommands.cleanInstall} failed in the shadow workspace after ${MAX_INTEGRATION_ROUNDS} integration rounds. The migration could not complete.`
           );
           return;
         }
@@ -1949,7 +1962,7 @@ var integrationProcessor = {
           producerId,
           planId,
           [pkgPath],
-          [`npm install failed in shadow workspace:
+          [`${pmCommands.cleanInstall} failed in shadow workspace:
 ${install.output.slice(0, 2500)}`]
         );
         return;
@@ -1957,12 +1970,12 @@ ${install.output.slice(0, 2500)}`]
       log2(
         producerId,
         planId,
-        "npm install finished. Next: npm run build in the shadow workspace."
+        `Dependencies installed successfully. Running verification build (${pmCommands.runBuild})...`
       );
       let lastBuildBeat = Date.now();
       let build = await runInShadowWorkspace(
         shadowPath,
-        "npm run build",
+        pmCommands.runBuild,
         (chunk) => {
           process.stdout.write(chunk);
           if (Date.now() - lastBuildBeat >= 15e3) {
@@ -1970,7 +1983,7 @@ ${install.output.slice(0, 2500)}`]
             log2(
               producerId,
               planId,
-              "npm run build is still running in the shadow workspace. Wait \u2014 this is not finished."
+              `${pmCommands.runBuild} is in progress in the shadow workspace...`
             );
           }
         }
@@ -1979,7 +1992,7 @@ ${install.output.slice(0, 2500)}`]
         log2(
           producerId,
           planId,
-          "Shadow build failed. IntegrationAgent will attempt local repairs before requeueing files."
+          "Verification build encountered errors. Analyzing diagnostics for automated repair..."
         );
         const shadowTools = [
           createReadFileTool2(shadowPath),
@@ -2057,7 +2070,7 @@ When you have applied fixes (or cannot fix further), stop. A deterministic rebui
         await completeMigration(
           producerId,
           planId,
-          "Shadow build succeeded. Reporter is writing MIGRATION.md next. Then Apply copies the result into your project.",
+          "Verification build succeeded cleanly. Generating final migration report and instructions...",
           "info"
         );
         return;
@@ -2074,16 +2087,16 @@ 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(
@@ -2097,7 +2110,7 @@ ${build.output.slice(0, 2500)}`]
       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);
@@ -2767,11 +2780,14 @@ var MigrationRunner = class {
     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" }
@@ -2791,7 +2807,8 @@ var MigrationRunner = class {
         payload: {
           planId,
           profile: plan.profile,
-          shadowWorkspacePath: shadowPath
+          shadowWorkspacePath: shadowPath,
+          packageManager: resolvedPackageManager
         }
       },
       dispatcherId
@@ -2880,7 +2897,7 @@ function logStartupContext() {
   }
 }
 var program = new Command();
-program.name("metamorph").description("AI-powered technology migration tool using Mozaik Agents").version("2.1.1");
+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 || ".";
@@ -2897,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.`));
@@ -3057,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)}`));