@nikelyh/metamorph 2.0.1 → 2.0.3

package/README.md

@@ -2,14 +2,28 @@
 
 **The AI Multi-Agent Migration CLI**
 
-Metamorph is a revolutionary CLI tool powered by [Mozaik AI](https://github.com/jigjoy-ai/mozaik) that automates complex architectural shifts and framework migrations in your codebase. Instead of doing it manually, Metamorph spawns a swarm of specialized AI agents that safely refactor your code in an isolated "Shadow Workspace".
+[![npm version](https://img.shields.io/npm/v/@nikelyh/metamorph.svg?style=flat-square&color=blue&logo=npm)](https://www.npmjs.com/package/@nikelyh/metamorph)
+[![Powered by Mozaik](https://img.shields.io/badge/Powered%20by-Mozaik-6366f1.svg?style=flat-square&logo=github)](https://github.com/jigjoy-ai/mozaik)
+
+<p>
+  <img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" />
+  <img src="https://img.shields.io/badge/Node.js-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js" />
+  <img src="https://img.shields.io/badge/React-20232A?style=flat-square&logo=react&logoColor=61DAFB" alt="React" />
+  <img src="https://img.shields.io/badge/Turborepo-EF4444?style=flat-square&logo=turborepo&logoColor=white" alt="Turborepo" />
+  <img src="https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=flat-square&logo=tailwind-css&logoColor=white" alt="Tailwind CSS" />
+  <img src="https://img.shields.io/badge/SQLite-003B57?style=flat-square&logo=sqlite&logoColor=white" alt="SQLite" />
+</p>
+
+Metamorph is a CLI tool powered by [Mozaik](https://github.com/jigjoy-ai/mozaik) that automates complex architectural shifts and framework migrations in your codebase. Instead of doing it manually, Metamorph spawns a swarm of specialized AI agents that safely refactor your code in an isolated "Shadow Workspace".
+
+📚 **[Read the Full Documentation](https://metamorph.nikelyh.tech/docs)**
 
 ## 🚀 Features
 
-- **Multi-Agent Concurrency**: Utilizes Mapper, Worker, Reviewer, and PackageManager agents to migrate code flawlessly.
+- **Multi-Agent Concurrency**: Utilizes Mapper, Worker, Reviewer, and PackageManager agents to migrate code.
 - **Zero Risk**: All migrations happen in a `.metamorph/shadow` workspace. Your original code is completely untouched until you explicitly approve and integrate the changes.
 - **Visual Dashboard**: Watch your agents work in real-time through the built-in local dashboard UI.
-- **Extensive Framework Support**: Easily migrate between popular frameworks.
+- **Extensive Framework Support**: Easily migrate between popular frameworks automatically.
 
 ## 📦 Installation
 
@@ -19,47 +33,66 @@ Install Metamorph globally via NPM:
 npm install -g @nikelyh/metamorph
 ```
 
-## 🛠️ Usage
+## 🛠️ Typical Workflow
 
-Navigate to the project you want to migrate and run:
+You can run the entire migration lifecycle using just your terminal. 
+
+### 1. Help & Options
+To see all available commands and options at any time, run:
+```bash
+metamorph --help
+```
 
+### 2. Start a Migration
+Navigate to the root of the project you want to migrate and run:
 ```bash
 metamorph run
 ```
+Metamorph will automatically detect your current stack (e.g. Express, React) and prompt you to select the target framework. Alternatively, you can bypass the interactive prompt by passing the source explicitly:
+```bash
+metamorph run --from express
+```
 
-Metamorph will automatically detect your current stack and prompt you to select the target framework. 
-Once started, the AI swarm will begin working in the background.
+### 3. Monitor the Agents (Dashboard UI)
+Once a migration is running, the AI swarm begins working in the background. To see their real-time progress, open a **new terminal tab** in the same folder and run:
+```bash
+metamorph ui
+```
+This will start the internal dashboard server and open a Neo-Brutalist interface in your default browser. You can specify a port with `--port 8080`.
 
-### View the Dashboard
+### 4. Review and Apply
+After the AI finishes the migration in the isolated Shadow Workspace, you will receive a `runId`. You can apply the completed migration to your actual repository (which automatically creates a new git branch for safety):
+```bash
+metamorph apply <runId> .
+```
 
-To see the real-time progress of your AI agents, open a new terminal in the same folder and run:
+### 5. Managing Migrations
+If you want to discard a run without applying it:
+```bash
+metamorph rollback <runId>
+```
+To see a history of all migrations:
+```bash
+metamorph list
+```
+To clear the local database and reset all events:
+```bash
+metamorph reset
+```
 
+### Utility Commands
+To test the technology detection on your repository without starting a migration:
 ```bash
-metamorph ui
+metamorph detect .
 ```
-This will start the internal dashboard and open it in your browser.
 
-### Other Commands
+## 🔄 Supported Migrations
 
-- `metamorph apply <runId> <targetPath>`: Applies a completed migration to your repository, creating a new git branch.
-- `metamorph rollback <runId>`: Discards an unapplied migration and cleans up the shadow workspace.
-- `metamorph list`: Lists all migration history.
-- `metamorph detect [path]`: Detects frameworks and libraries in the current project.
-- `metamorph reset`: Clears all migration history and events from the local database.
+As Metamorph's AI capabilities are constantly expanding, the list of supported architectural shifts is updated frequently.
 
-## 🔄 Supported Migrations
+To see the complete, up-to-date list of all supported frontend and backend framework migrations, please visit our official documentation:
 
-**Backend Refactoring**
-- Express ⇄ Fastify
-- Express ➔ NestJS
-- Fastify ➔ NestJS
-
-**Frontend Modernization**
-- React ➔ Next.js
-- Vue ➔ React
-- Vue ➔ Next.js
-- Angular ➔ React
-- Svelte ➔ Next.js
+👉 **[View Supported Migrations](https://metamorph.nikelyh.tech/docs/migrations)**
 
 ---
 *Built with ❤️ using Mozaik.*

package/bin/metamorph.js

@@ -1,18 +1,4 @@
 #!/usr/bin/env node
 
-// For development, we use tsx to run the typescript file directly.
-import { spawnSync } from 'child_process';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const indexPath = resolve(__dirname, '../src/index.ts');
-
-const result = spawnSync('npx', ['tsx', indexPath, ...process.argv.slice(2)], {
-  stdio: 'inherit',
-  shell: true
-});
-
-process.exit(result.status || 0);
+// Production entry point for the CLI
+import '../dist/index.js';

package/dist/{TechDetector-YCDEZ6OR.js → TechDetector-TKTX5YAM.js}

@@ -1,7 +1,7 @@
 import {
   detectTechnologies
 } from "./chunk-3QN2Q75J.js";
-import "./chunk-VS2QQHAK.js";
+import "./chunk-3RG5ZIWI.js";
 export {
   detectTechnologies
 };

package/dist/chunk-3RG5ZIWI.js

@@ -0,0 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};

package/dist/{chunk-DJO6FY4K.js → chunk-GNWRSZXT.js}

@@ -1,9 +1,5 @@
-import {
-  RuntimeState,
-  defineRuntime
-} from "./chunk-XHQSMB6V.js";
-
 // ../application/src/runtime.ts
+import { defineRuntime, RuntimeState } from "@mozaik-ai/core";
 var MetamorphState = class extends RuntimeState {
   constructor(repository) {
     super();