mastra 1.0.0-beta.17 → 1.0.0-beta.19

package/dist/commands/actions/migrate.d.ts

@@ -0,0 +1,8 @@
+export declare const migrate: (args: {
+    dir?: string;
+    root?: string;
+    env?: string;
+    debug?: boolean;
+    yes?: boolean;
+}) => Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/actions/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/commands/actions/migrate.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,GAAU,MAAM;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,kBAehH,CAAC"}

package/dist/commands/create/create.js

@@ -1,4 +1,4 @@
-export { create } from '../../chunk-Q2XMQYH7.js';
+export { create } from '../../chunk-5I4BC7I4.js';
 import '../../chunk-3MHPDBSK.js';
 //# sourceMappingURL=create.js.map
 //# sourceMappingURL=create.js.map

package/dist/commands/migrate/MigrateBundler.d.ts

@@ -0,0 +1,12 @@
+import { BuildBundler } from '../build/BuildBundler.js';
+export declare class MigrateBundler extends BuildBundler {
+    private customEnvFile?;
+    constructor(customEnvFile?: string);
+    getEnvFiles(): Promise<string[]>;
+    bundle(entryFile: string, outputDirectory: string, { toolsPaths, projectRoot }: {
+        toolsPaths: (string | string[])[];
+        projectRoot: string;
+    }): Promise<void>;
+    protected getEntry(): string;
+}
+//# sourceMappingURL=MigrateBundler.d.ts.map

package/dist/commands/migrate/MigrateBundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrateBundler.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/MigrateBundler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,aAAa,CAAC,EAAE,MAAM;IAKzB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBnC,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE;QAAE,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GACtF,OAAO,CAAC,IAAI,CAAC;cAIG,QAAQ,IAAI,MAAM;CAmEtC"}

package/dist/commands/migrate/migrate.d.ts

@@ -0,0 +1,8 @@
+export declare function migrate({ dir, root, env, debug, yes, }: {
+    dir?: string;
+    root?: string;
+    env?: string;
+    debug: boolean;
+    yes: boolean;
+}): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/migrate.ts"],"names":[],"mappings":"AAkBA,wBAAsB,OAAO,CAAC,EAC5B,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,GACJ,EAAE;IACD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,iBA+IA"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AAcnE,eAAO,MAAM,OAAO,oBAAoB,CAAC;AAEzC,eAAO,MAAM,SAAS,kBAIpB,CAAC;AAMH,eAAO,MAAM,MAAM,EAA0C,UAAU,CAAC;AAwIxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AAenE,eAAO,MAAM,OAAO,oBAAoB,CAAC;AAEzC,eAAO,MAAM,SAAS,kBAIpB,CAAC;AAMH,eAAO,MAAM,MAAM,EAA0C,UAAU,CAAC;AAkJxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,10 +1,10 @@
 #! /usr/bin/env node
-import { package_default, COMPONENTS, parseComponents, LLMProvider, parseLlmProvider, parseMcp, create, checkForPkgJson, getVersionTag, isGitInitialized, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService, createLogger, shouldSkipDotenvLoading, DepsService } from './chunk-Q2XMQYH7.js';
-export { create } from './chunk-Q2XMQYH7.js';
+import { package_default, COMPONENTS, parseComponents, LLMProvider, parseLlmProvider, parseMcp, create, checkForPkgJson, getVersionTag, isGitInitialized, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService, createLogger, shouldSkipDotenvLoading, DepsService } from './chunk-5I4BC7I4.js';
+export { create } from './chunk-5I4BC7I4.js';
 import { PosthogAnalytics, setAnalytics } from './chunk-3MHPDBSK.js';
 export { PosthogAnalytics } from './chunk-3MHPDBSK.js';
 import { Command } from 'commander';
-import pc2 from 'picocolors';
+import pc3 from 'picocolors';
 import * as p2 from '@clack/prompts';
 import fs, { existsSync, readFileSync } from 'fs';
 import path, { dirname, join } from 'path';
@@ -15,10 +15,10 @@ import * as fsExtra from 'fs-extra';
 import { copy } from 'fs-extra';
 import { getDeployer, FileService as FileService$1 } from '@mastra/deployer';
 import stripJsonComments from 'strip-json-comments';
+import process3 from 'process';
+import { execa } from 'execa';
 import { writeFile, mkdir } from 'fs/promises';
-import process2 from 'process';
 import devcert from '@expo/devcert';
-import { execa } from 'execa';
 import getPort from 'get-port';
 import { getPackageInfo } from 'local-pkg';
 import { spawn } from 'child_process';
@@ -408,7 +408,7 @@ async function initializeScorer(scorer, customPath) {
 }
 function showSuccessNote() {
   p2.note(`
-        ${pc2.green("To use: Add the Scorer to your workflow or agent!")}
+        ${pc3.green("To use: Add the Scorer to your workflow or agent!")}
         `);
 }
 async function showInteractivePrompt(providedCustomDir) {
@@ -419,7 +419,7 @@ async function showInteractivePrompt(providedCustomDir) {
   let customPath = providedCustomDir;
   if (!providedCustomDir) {
     const useCustomDir = await p2.confirm({
-      message: `Would you like to use a custom directory?${pc2.gray("(Default: src/mastra/scorers)")}`,
+      message: `Would you like to use a custom directory?${pc3.gray("(Default: src/mastra/scorers)")}`,
       initialValue: false
     });
     if (p2.isCancel(useCustomDir)) {
@@ -895,15 +895,15 @@ function formatTable(scorers) {
   const idWidth = Math.max(2, Math.max(...scorers.map((s) => s.id.length)));
   const typeWidth = Math.max(4, Math.max(...scorers.map((s) => s.type.length)));
   const descWidth = Math.max(11, Math.max(...scorers.map((s) => s.description.length)));
-  const header = `${pc2.bold("Name".padEnd(nameWidth))} \u2502 ${pc2.bold("ID".padEnd(idWidth))} \u2502 ${pc2.bold("Type".padEnd(typeWidth))} \u2502 ${pc2.bold("Description".padEnd(descWidth))}`;
+  const header = `${pc3.bold("Name".padEnd(nameWidth))} \u2502 ${pc3.bold("ID".padEnd(idWidth))} \u2502 ${pc3.bold("Type".padEnd(typeWidth))} \u2502 ${pc3.bold("Description".padEnd(descWidth))}`;
   const separator = "\u2500".repeat(nameWidth) + "\u2500\u253C\u2500" + "\u2500".repeat(idWidth) + "\u2500\u253C\u2500" + "\u2500".repeat(typeWidth) + "\u2500\u253C\u2500" + "\u2500".repeat(descWidth) + "\u2500";
   const rows = scorers.map(
-    (scorer) => `${(scorer?.name ?? scorer?.id).padEnd(nameWidth)} \u2502 ${pc2.dim(scorer.id.padEnd(idWidth))} \u2502 ${scorer.type.padEnd(typeWidth)} \u2502 ${pc2.dim(scorer.description.padEnd(descWidth))}`
+    (scorer) => `${(scorer?.name ?? scorer?.id).padEnd(nameWidth)} \u2502 ${pc3.dim(scorer.id.padEnd(idWidth))} \u2502 ${scorer.type.padEnd(typeWidth)} \u2502 ${pc3.dim(scorer.description.padEnd(descWidth))}`
   );
   return [header, separator, ...rows].join("\n");
 }
 function listAllScorers() {
-  p2.intro(pc2.inverse(" Available Scorers "));
+  p2.intro(pc3.inverse(" Available Scorers "));
   const groupedScorers = AVAILABLE_SCORERS.reduce(
     (acc, scorer) => {
       if (!acc[scorer.category]) {
@@ -915,7 +915,7 @@ function listAllScorers() {
     {}
   );
   for (const [category, scorers] of Object.entries(groupedScorers)) {
-    p2.log.info(`${pc2.bold(pc2.cyan(formatCategoryName(category)))} Scorers:`);
+    p2.log.info(`${pc3.bold(pc3.cyan(formatCategoryName(category)))} Scorers:`);
     p2.log.message(formatTable(scorers));
   }
 }
@@ -932,6 +932,241 @@ var listScorers = async (args) => {
     origin: origin5
   });
 };
+var MigrateBundler = class extends BuildBundler {
+  customEnvFile;
+  constructor(customEnvFile) {
+    super({ studio: false });
+    this.customEnvFile = customEnvFile;
+  }
+  getEnvFiles() {
+    if (shouldSkipDotenvLoading()) {
+      return Promise.resolve([]);
+    }
+    const possibleFiles = [".env.development", ".env.local", ".env"];
+    if (this.customEnvFile) {
+      possibleFiles.unshift(this.customEnvFile);
+    }
+    try {
+      const fileService = new FileService$2();
+      const envFile = fileService.getFirstExistingFile(possibleFiles);
+      return Promise.resolve([envFile]);
+    } catch {
+    }
+    return Promise.resolve([]);
+  }
+  async bundle(entryFile, outputDirectory, { toolsPaths, projectRoot }) {
+    return this._bundle(this.getEntry(), entryFile, { outputDirectory, projectRoot }, toolsPaths);
+  }
+  getEntry() {
+    return `
+    import { mastra } from '#mastra';
+
+    async function runMigration() {
+      const storage = mastra.getStorage();
+
+      if (!storage) {
+        console.log(JSON.stringify({
+          success: false,
+          alreadyMigrated: false,
+          duplicatesRemoved: 0,
+          message: 'Storage not configured. Please configure storage in your Mastra instance.',
+        }));
+        process.exit(1);
+      }
+
+      // Access the observability store directly from storage.stores
+      const observabilityStore = storage.stores?.observability;
+
+      if (!observabilityStore) {
+        console.log(JSON.stringify({
+          success: false,
+          alreadyMigrated: false,
+          duplicatesRemoved: 0,
+          message: 'Observability storage not configured. Migration not required.',
+        }));
+        process.exit(0);
+      }
+
+      // Check if the store has a migrateSpans method
+      if (typeof observabilityStore.migrateSpans !== 'function') {
+        console.log(JSON.stringify({
+          success: false,
+          alreadyMigrated: false,
+          duplicatesRemoved: 0,
+          message: 'Migration not supported for this storage backend.',
+        }));
+        process.exit(1);
+      }
+
+      try {
+        // Run the migration - migrateSpans handles everything internally
+        const result = await observabilityStore.migrateSpans();
+
+        console.log(JSON.stringify({
+          success: result.success,
+          alreadyMigrated: result.alreadyMigrated,
+          duplicatesRemoved: result.duplicatesRemoved,
+          message: result.message,
+        }));
+
+        process.exit(result.success ? 0 : 1);
+      } catch (error) {
+        console.log(JSON.stringify({
+          success: false,
+          alreadyMigrated: false,
+          duplicatesRemoved: 0,
+          message: error instanceof Error ? error.message : 'Unknown error during migration',
+        }));
+        process.exit(1);
+      }
+    }
+
+    runMigration();
+    `;
+  }
+};
+
+// src/commands/migrate/migrate.ts
+async function migrate({
+  dir: dir2,
+  root,
+  env,
+  debug,
+  yes
+}) {
+  const logger2 = createLogger(debug);
+  const rootDir = root || process3.cwd();
+  const mastraDir = dir2 ? dir2.startsWith("/") ? dir2 : join(process3.cwd(), dir2) : join(process3.cwd(), "src", "mastra");
+  const dotMastraPath = join(rootDir, ".mastra");
+  p2.intro(pc3.cyan("Mastra Storage Migration"));
+  if (!yes) {
+    p2.log.warn(pc3.yellow("Warning: This migration will modify your database."));
+    p2.log.message("Before proceeding, please ensure you have:");
+    p2.log.message("  \u2022 Created a backup of your database");
+    p2.log.message("  \u2022 Tested this migration in a non-production environment");
+    const confirmed = await p2.confirm({
+      message: "Have you backed up your database and are ready to proceed?",
+      initialValue: false
+    });
+    if (p2.isCancel(confirmed) || !confirmed) {
+      p2.log.info("Migration cancelled. Please back up your database before running this command.");
+      p2.log.message(pc3.dim("Tip: Use --yes or -y to skip this prompt in CI/automation."));
+      process3.exit(0);
+    }
+  }
+  try {
+    const fileService = new FileService$1();
+    const entryFile = fileService.getFirstExistingFile([join(mastraDir, "index.ts"), join(mastraDir, "index.js")]);
+    const bundler = new MigrateBundler(env);
+    bundler.__setLogger(logger2);
+    logger2.info("Building project for migration...");
+    await bundler.prepare(dotMastraPath);
+    const discoveredTools = bundler.getAllToolPaths(mastraDir, []);
+    await bundler.bundle(entryFile, dotMastraPath, {
+      toolsPaths: discoveredTools,
+      projectRoot: rootDir
+    });
+    logger2.info("Running migration...");
+    logger2.info(pc3.dim("This may take a while for large tables."));
+    logger2.info("");
+    const loadedEnv = await bundler.loadEnvVars();
+    const migrationProcess = execa(process3.execPath, [join(dotMastraPath, "output", "index.mjs")], {
+      cwd: rootDir,
+      env: {
+        NODE_ENV: "production",
+        MASTRA_DISABLE_STORAGE_INIT: "true",
+        // Prevent MIGRATION_REQUIRED error during import
+        ...Object.fromEntries(loadedEnv)
+      },
+      stdio: ["inherit", "pipe", "pipe"],
+      reject: false
+    });
+    let stdoutData = "";
+    let stderrData = "";
+    migrationProcess.stdout?.on("data", (data) => {
+      stdoutData += data.toString();
+    });
+    migrationProcess.stderr?.on("data", (data) => {
+      stderrData += data.toString();
+      if (debug) {
+        process3.stderr.write(data);
+      }
+    });
+    const processResult = await migrationProcess;
+    let result;
+    try {
+      const jsonMatch = stdoutData.match(/\{[^{}]*"success"[^{}]*\}/g);
+      if (jsonMatch && jsonMatch.length > 0) {
+        result = JSON.parse(jsonMatch[jsonMatch.length - 1]);
+      }
+    } catch {
+    }
+    if (result) {
+      if (result.success) {
+        if (result.alreadyMigrated) {
+          logger2.info(pc3.green("\u2713 Migration already complete."));
+        } else {
+          logger2.info(pc3.green("\u2713 Migration completed successfully!"));
+          if (result.duplicatesRemoved > 0) {
+            logger2.info(`  Removed ${result.duplicatesRemoved} duplicate entries.`);
+          }
+        }
+        logger2.info(`  ${result.message}`);
+      } else {
+        logger2.error(pc3.red("\u2717 Migration failed."));
+        logger2.error(`  ${result.message}`);
+        process3.exit(1);
+      }
+    } else {
+      if (processResult.exitCode !== 0) {
+        logger2.error(pc3.red("\u2717 Migration failed."));
+        if (stderrData) {
+          logger2.error(stderrData);
+        }
+        if (stdoutData && !stdoutData.includes('"success"')) {
+          logger2.error(stdoutData);
+        }
+        process3.exit(1);
+      } else {
+        logger2.info(pc3.green("\u2713 Migration completed."));
+      }
+    }
+  } catch (error) {
+    if (error.code === "ERR_MODULE_NOT_FOUND" || error.message?.includes("Cannot find module")) {
+      logger2.error(pc3.red("Error: Could not find Mastra entry file."));
+      logger2.info("");
+      logger2.info("Make sure you have a mastra directory with an index.ts or index.js file.");
+      logger2.info(`Expected location: ${mastraDir}`);
+      logger2.info("");
+      logger2.info("You can specify a custom directory:");
+      logger2.info(pc3.cyan("  npx mastra migrate --dir path/to/mastra"));
+    } else {
+      logger2.error(pc3.red(`Error: ${error.message}`));
+      if (debug) {
+        logger2.error(error);
+      }
+    }
+    process3.exit(1);
+  }
+}
+
+// src/commands/actions/migrate.ts
+var migrate2 = async (args) => {
+  await analytics.trackCommandExecution({
+    command: "mastra migrate",
+    args: { ...args },
+    execution: async () => {
+      await migrate({
+        dir: args?.dir,
+        root: args?.root,
+        env: args?.env,
+        debug: args?.debug ?? false,
+        yes: args?.yes ?? false
+      });
+    },
+    origin: origin2
+  });
+};
 var DevLogger = class {
   options;
   constructor(options = {}) {
@@ -943,32 +1178,32 @@ var DevLogger = class {
   }
   formatTime() {
     if (!this.options.timestamp) return "";
-    return pc2.dim((/* @__PURE__ */ new Date()).toLocaleTimeString());
+    return pc3.dim((/* @__PURE__ */ new Date()).toLocaleTimeString());
   }
   formatPrefix(text2, color2) {
     const time = this.formatTime();
-    const prefix = pc2.bold(color2(text2));
+    const prefix = pc3.bold(color2(text2));
     return time ? `${time} ${prefix}` : prefix;
   }
   info(message) {
-    const prefix = this.formatPrefix("\u25D0", pc2.cyan);
+    const prefix = this.formatPrefix("\u25D0", pc3.cyan);
     console.info(`${prefix} ${message}`);
   }
   success(message) {
-    const prefix = this.formatPrefix("\u2713", pc2.green);
-    console.info(`${prefix} ${pc2.green(message)}`);
+    const prefix = this.formatPrefix("\u2713", pc3.green);
+    console.info(`${prefix} ${pc3.green(message)}`);
   }
   warn(message) {
-    const prefix = this.formatPrefix("\u26A0", pc2.yellow);
-    console.info(`${prefix} ${pc2.yellow(message)}`);
+    const prefix = this.formatPrefix("\u26A0", pc3.yellow);
+    console.info(`${prefix} ${pc3.yellow(message)}`);
   }
   error(message) {
-    const prefix = this.formatPrefix("\u2717", pc2.red);
-    console.info(`${prefix} ${pc2.red(message)}`);
+    const prefix = this.formatPrefix("\u2717", pc3.red);
+    console.info(`${prefix} ${pc3.red(message)}`);
   }
   starting() {
-    const prefix = this.formatPrefix("\u25C7", pc2.blue);
-    console.info(`${prefix} ${pc2.blue("Starting Mastra dev server...")}`);
+    const prefix = this.formatPrefix("\u25C7", pc3.blue);
+    console.info(`${prefix} ${pc3.blue("Starting Mastra dev server...")}`);
   }
   ready(host, port, studioBasePath, startTime, https) {
     let protocol = "http";
@@ -977,62 +1212,62 @@ var DevLogger = class {
     }
     console.info("");
     const timing = startTime ? `${Date.now() - startTime} ms` : "XXX ms";
-    console.info(pc2.inverse(pc2.green(" mastra ")) + ` ${pc2.green(version)} ${pc2.gray("ready in")} ${timing}`);
+    console.info(pc3.inverse(pc3.green(" mastra ")) + ` ${pc3.green(version)} ${pc3.gray("ready in")} ${timing}`);
     console.info("");
-    console.info(`${pc2.dim("\u2502")} ${pc2.bold("Studio:")} ${pc2.cyan(`${protocol}://${host}:${port}${studioBasePath}`)}`);
-    console.info(`${pc2.dim("\u2502")} ${pc2.bold("API:")}    ${`${protocol}://${host}:${port}/api`}`);
+    console.info(`${pc3.dim("\u2502")} ${pc3.bold("Studio:")} ${pc3.cyan(`${protocol}://${host}:${port}${studioBasePath}`)}`);
+    console.info(`${pc3.dim("\u2502")} ${pc3.bold("API:")}    ${`${protocol}://${host}:${port}/api`}`);
     console.info("");
   }
   bundling() {
-    const prefix = this.formatPrefix("\u25D0", pc2.magenta);
-    console.info(`${prefix} ${pc2.magenta("Bundling...")}`);
+    const prefix = this.formatPrefix("\u25D0", pc3.magenta);
+    console.info(`${prefix} ${pc3.magenta("Bundling...")}`);
   }
   bundleComplete() {
-    const prefix = this.formatPrefix("\u2713", pc2.green);
-    console.info(`${prefix} ${pc2.green("Bundle complete")}`);
+    const prefix = this.formatPrefix("\u2713", pc3.green);
+    console.info(`${prefix} ${pc3.green("Bundle complete")}`);
   }
   watching() {
     const time = this.formatTime();
-    const icon = pc2.dim("\u25EF");
-    const message = pc2.dim("watching for file changes...");
+    const icon = pc3.dim("\u25EF");
+    const message = pc3.dim("watching for file changes...");
     const fullMessage = `${icon} ${message}`;
     console.info(time ? `${time} ${fullMessage}` : fullMessage);
   }
   restarting() {
-    const prefix = this.formatPrefix("\u21BB", pc2.blue);
-    console.info(`${prefix} ${pc2.blue("Restarting server...")}`);
+    const prefix = this.formatPrefix("\u21BB", pc3.blue);
+    console.info(`${prefix} ${pc3.blue("Restarting server...")}`);
   }
   fileChange(file) {
-    const prefix = this.formatPrefix("\u26A1", pc2.cyan);
+    const prefix = this.formatPrefix("\u26A1", pc3.cyan);
     const fileName = path.basename(file);
-    console.info(`${prefix} ${pc2.cyan("File changed:")} ${pc2.dim(fileName)}`);
+    console.info(`${prefix} ${pc3.cyan("File changed:")} ${pc3.dim(fileName)}`);
   }
   // Enhanced error reporting
   serverError(error) {
     console.info("");
-    console.info(pc2.red("  \u2717 ") + pc2.bold(pc2.red("Server Error")));
+    console.info(pc3.red("  \u2717 ") + pc3.bold(pc3.red("Server Error")));
     console.info("");
-    console.info(`  ${pc2.red("\u2502")} ${error}`);
+    console.info(`  ${pc3.red("\u2502")} ${error}`);
     console.info("");
   }
   shutdown() {
     console.info("");
-    const prefix = this.formatPrefix("\u2713", pc2.green);
-    console.info(`${prefix} ${pc2.green("Dev server stopped")}`);
+    const prefix = this.formatPrefix("\u2713", pc3.green);
+    console.info(`${prefix} ${pc3.green("Dev server stopped")}`);
   }
   envInfo(info) {
     console.info("");
-    console.info(`  ${pc2.dim("\u2502")} ${pc2.bold("Environment:")} ${pc2.cyan(info.env || "development")}`);
-    console.info(`  ${pc2.dim("\u2502")} ${pc2.bold("Root:")} ${pc2.dim(info.root)}`);
-    console.info(`  ${pc2.dim("\u2502")} ${pc2.bold("Port:")} ${pc2.cyan(info.port.toString())}`);
+    console.info(`  ${pc3.dim("\u2502")} ${pc3.bold("Environment:")} ${pc3.cyan(info.env || "development")}`);
+    console.info(`  ${pc3.dim("\u2502")} ${pc3.bold("Root:")} ${pc3.dim(info.root)}`);
+    console.info(`  ${pc3.dim("\u2502")} ${pc3.bold("Port:")} ${pc3.cyan(info.port.toString())}`);
   }
   raw(message) {
     console.info(message);
   }
   debug(message) {
     if (process.env.DEBUG || process.env.MASTRA_DEBUG) {
-      const prefix = this.formatPrefix("\u25E6", pc2.gray);
-      console.info(`${prefix} ${pc2.gray(message)}`);
+      const prefix = this.formatPrefix("\u25E6", pc3.gray);
+      console.info(`${prefix} ${pc3.gray(message)}`);
     }
   }
   spinnerChars = ["\u25D0", "\u25D3", "\u25D1", "\u25D2"];
@@ -1047,7 +1282,7 @@ var DevLogger = class {
   }
   update(message) {
     this.clearLine();
-    const prefix = this.formatPrefix(this.getSpinnerChar(), pc2.cyan);
+    const prefix = this.formatPrefix(this.getSpinnerChar(), pc3.cyan);
     process.stdout.write(`${prefix} ${message}`);
   }
 };
@@ -1253,7 +1488,7 @@ var startServer = async (dotMastraPath, { port, host, studioBasePath, publicDir
       await writeFile(packagesFilePath, JSON.stringify(startOptions.mastraPackages), "utf-8");
     }
     await mkdir(publicDir, { recursive: true });
-    currentServerProcess = execa(process2.execPath, commands, {
+    currentServerProcess = execa(process3.execPath, commands, {
       cwd: publicDir,
       env: {
         NODE_ENV: "production",
@@ -1281,7 +1516,7 @@ var startServer = async (dotMastraPath, { port, host, studioBasePath, publicDir
       currentServerProcess.stdout.on("data", (data) => {
         const output = data.toString();
         if (!output.includes("Studio available") && !output.includes("\u{1F468}\u200D\u{1F4BB}") && !output.includes("Mastra API running on ")) {
-          process2.stdout.write(output);
+          process3.stdout.write(output);
         }
       });
     }
@@ -1289,7 +1524,7 @@ var startServer = async (dotMastraPath, { port, host, studioBasePath, publicDir
       currentServerProcess.stderr.on("data", (data) => {
         const output = data.toString();
         if (!output.includes("Studio available") && !output.includes("\u{1F468}\u200D\u{1F4BB}") && !output.includes("Mastra API running on ")) {
-          process2.stderr.write(output);
+          process3.stderr.write(output);
         }
       });
     }
@@ -1340,7 +1575,7 @@ var startServer = async (dotMastraPath, { port, host, studioBasePath, publicDir
         errorRestartCount++;
         if (errorRestartCount > ON_ERROR_MAX_RESTARTS) {
           devLogger.error(`Server failed to start after ${ON_ERROR_MAX_RESTARTS} error attempts. Giving up.`);
-          process2.exit(1);
+          process3.exit(1);
         }
         devLogger.warn(
           `Attempting to restart server after error... (Attempt ${errorRestartCount}/${ON_ERROR_MAX_RESTARTS})`
@@ -1393,7 +1628,7 @@ async function rebundleAndRestart(dotMastraPath, { port, host, studioBasePath, p
     }
     const env = await bundler.loadEnvVars();
     for (const [key, value] of env.entries()) {
-      process2.env[key] = value;
+      process3.env[key] = value;
     }
     await startServer(
       join(dotMastraPath, "output"),
@@ -1421,8 +1656,8 @@ async function dev({
   https,
   debug
 }) {
-  const rootDir = root || process2.cwd();
-  const mastraDir = dir2 ? dir2.startsWith("/") ? dir2 : join(process2.cwd(), dir2) : join(process2.cwd(), "src", "mastra");
+  const rootDir = root || process3.cwd();
+  const mastraDir = dir2 ? dir2.startsWith("/") ? dir2 : join(process3.cwd(), dir2) : join(process3.cwd(), "src", "mastra");
   const dotMastraPath = join(rootDir, ".mastra");
   const fileService = new FileService$1();
   const entryFile = fileService.getFirstExistingFile([join(mastraDir, "index.ts"), join(mastraDir, "index.js")]);
@@ -1431,11 +1666,11 @@ async function dev({
   const discoveredTools = bundler.getAllToolPaths(mastraDir, tools ?? []);
   const loadedEnv = await bundler.loadEnvVars();
   for (const [key, value] of loadedEnv.entries()) {
-    process2.env[key] = value;
+    process3.env[key] = value;
   }
   const serverOptions = await getServerOptions(entryFile, join(dotMastraPath, "output"));
-  let portToUse = serverOptions?.port ?? process2.env.PORT;
-  let hostToUse = serverOptions?.host ?? process2.env.HOST ?? "localhost";
+  let portToUse = serverOptions?.port ?? process3.env.PORT;
+  let hostToUse = serverOptions?.host ?? process3.env.HOST ?? "localhost";
   const studioBasePathToUse = normalizeStudioBase(serverOptions?.studioBase ?? "/");
   if (!portToUse || isNaN(Number(portToUse))) {
     const portList = Array.from({ length: 21 }, (_, i) => 4111 + i);
@@ -1490,13 +1725,13 @@ async function dev({
       );
     }
   });
-  process2.on("SIGINT", () => {
+  process3.on("SIGINT", () => {
     devLogger.shutdown();
     if (currentServerProcess) {
       currentServerProcess.kill();
     }
     watcher.close().catch(() => {
-    }).finally(() => process2.exit(0));
+    }).finally(() => process3.exit(0));
   });
 }
 
@@ -1672,7 +1907,7 @@ var origin2 = process.env.MASTRA_ANALYTICS_ORIGIN;
 program.name("mastra").version(`${version}`, "-v, --version").addHelpText(
   "before",
   `
-${pc2.bold(pc2.cyan("Mastra"))} is a typescript framework for building AI applications, agents, and workflows.
+${pc3.bold(pc3.cyan("Mastra"))} is a typescript framework for building AI applications, agents, and workflows.
 `
 ).action(() => {
   program.help();
@@ -1715,6 +1950,7 @@ program.command("dev").description("Start mastra server").option("-d, --dir <dir
 program.command("build").description("Build your Mastra project").option("-d, --dir <path>", "Path to your Mastra Folder").option("-r, --root <path>", "Path to your root folder").option("-t, --tools <toolsDirs>", "Comma-separated list of paths to tool files to include").option("-s, --studio", "Bundle the studio UI with the build").option("--debug", "Enable debug logs", false).action(buildProject);
 program.command("start").description("Start your built Mastra application").option("-d, --dir <path>", "Path to your built Mastra output directory (default: .mastra/output)").option("-e, --env <env>", "Custom env file to include in the start").action(startProject);
 program.command("studio").description("Start the Mastra studio").option("-p, --port <port>", "Port to run the studio on (default: 3000)").option("-e, --env <env>", "Custom env file to include in the studio").option("-h, --server-host <serverHost>", "Host of the Mastra API server (default: localhost)").option("-s, --server-port <serverPort>", "Port of the Mastra API server (default: 4111)").option("-x, --server-protocol <serverProtocol>", "Protocol of the Mastra API server (default: http)").action(studio);
+program.command("migrate").description("Run database migrations to update storage schema").option("-d, --dir <path>", "Path to your Mastra folder").option("-r, --root <path>", "Path to your root folder").option("-e, --env <env>", "Custom env file to include").option("--debug", "Enable debug logs", false).option("-y, --yes", "Skip confirmation prompt (for CI/automation)").action(migrate2);
 var scorersCommand = program.command("scorers").description("Manage scorers for evaluating AI outputs");
 scorersCommand.command("add [scorer-name]").description("Add a new scorer to your project").option("-d, --dir <path>", "Path to your Mastra directory (default: auto-detect)").action(addScorer);
 scorersCommand.command("list").description("List available scorer templates").action(listScorers);