@prisma-next/cli 0.3.0-dev.12 → 0.3.0-dev.123

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma-next/cli",
-  "version": "0.3.0-dev.12",
+  "version": "0.3.0-dev.123",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -11,79 +11,124 @@
     "prisma-next": "./dist/cli.js"
   },
   "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@dagrejs/dagre": "^3.0.0",
     "arktype": "^2.0.0",
     "c12": "^3.3.2",
+    "closest-match": "^1.3.3",
     "colorette": "^2.0.20",
     "commander": "^12.0.0",
-    "esbuild": "^0.19.0",
-    "ora": "^8.1.1",
-    "string-width": "^7.2.0",
+    "esbuild": "^0.25.11",
+    "pathe": "^2.0.3",
+    "string-width": "^8.2.0",
     "strip-ansi": "^7.1.2",
-    "wrap-ansi": "^9.0.2",
-    "@prisma-next/contract": "0.3.0-dev.12",
-    "@prisma-next/core-control-plane": "0.3.0-dev.12",
-    "@prisma-next/emitter": "0.3.0-dev.12",
-    "@prisma-next/utils": "0.3.0-dev.12"
+    "wrap-ansi": "^10.0.0",
+    "@prisma-next/config": "0.3.0-dev.123",
+    "@prisma-next/contract": "0.3.0-dev.123",
+    "@prisma-next/core-control-plane": "0.3.0-dev.123",
+    "@prisma-next/emitter": "0.3.0-dev.123",
+    "@prisma-next/psl-printer": "0.3.0-dev.123",
+    "@prisma-next/migration-tools": "0.3.0-dev.123",
+    "@prisma-next/utils": "0.3.0-dev.123"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
-    "@vitest/coverage-v8": "4.0.16",
-    "tsup": "8.5.1",
+    "tsdown": "0.18.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16",
-    "@prisma-next/sql-contract": "0.3.0-dev.12",
-    "@prisma-next/sql-contract-emitter": "0.3.0-dev.12",
-    "@prisma-next/sql-contract-ts": "0.3.0-dev.12",
-    "@prisma-next/sql-operations": "0.3.0-dev.12",
-    "@prisma-next/sql-runtime": "0.3.0-dev.12",
-    "@prisma-next/test-utils": "0.0.1"
+    "vitest": "4.0.17",
+    "@prisma-next/sql-contract": "0.3.0-dev.123",
+    "@prisma-next/sql-contract-emitter": "0.3.0-dev.123",
+    "@prisma-next/sql-contract-ts": "0.3.0-dev.123",
+    "@prisma-next/sql-operations": "0.3.0-dev.123",
+    "@prisma-next/test-utils": "0.0.1",
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0",
+    "@prisma-next/sql-runtime": "0.3.0-dev.123"
   },
   "exports": {
     ".": {
-      "types": "./dist/exports/index.d.ts",
-      "import": "./dist/exports/index.js"
+      "types": "./dist/exports/index.d.mts",
+      "import": "./dist/exports/index.mjs"
     },
     "./config-types": {
-      "types": "./dist/exports/config-types.d.ts",
-      "import": "./dist/exports/config-types.js"
+      "types": "./dist/exports/config-types.d.mts",
+      "import": "./dist/exports/config-types.mjs"
     },
     "./commands/db-init": {
-      "types": "./dist/commands/db-init.d.ts",
-      "import": "./dist/commands/db-init.js"
+      "types": "./dist/commands/db-init.d.mts",
+      "import": "./dist/commands/db-init.mjs"
     },
-    "./commands/db-introspect": {
-      "types": "./dist/commands/db-introspect.d.ts",
-      "import": "./dist/commands/db-introspect.js"
+    "./commands/db-update": {
+      "types": "./dist/commands/db-update.d.mts",
+      "import": "./dist/commands/db-update.mjs"
     },
-    "./commands/db-schema-verify": {
-      "types": "./dist/commands/db-schema-verify.d.ts",
-      "import": "./dist/commands/db-schema-verify.js"
+    "./commands/db-schema": {
+      "types": "./dist/commands/db-schema.d.mts",
+      "import": "./dist/commands/db-schema.mjs"
     },
     "./commands/db-sign": {
-      "types": "./dist/commands/db-sign.d.ts",
-      "import": "./dist/commands/db-sign.js"
+      "types": "./dist/commands/db-sign.d.mts",
+      "import": "./dist/commands/db-sign.mjs"
     },
     "./commands/db-verify": {
-      "types": "./dist/commands/db-verify.d.ts",
-      "import": "./dist/commands/db-verify.js"
+      "types": "./dist/commands/db-verify.d.mts",
+      "import": "./dist/commands/db-verify.mjs"
     },
     "./commands/contract-emit": {
-      "types": "./dist/commands/contract-emit.d.ts",
-      "import": "./dist/commands/contract-emit.js"
+      "types": "./dist/commands/contract-emit.d.mts",
+      "import": "./dist/commands/contract-emit.mjs"
+    },
+    "./commands/contract-infer": {
+      "types": "./dist/commands/contract-infer.d.mts",
+      "import": "./dist/commands/contract-infer.mjs"
+    },
+    "./commands/migration-plan": {
+      "types": "./dist/commands/migration-plan.d.mts",
+      "import": "./dist/commands/migration-plan.mjs"
+    },
+    "./commands/migration-show": {
+      "types": "./dist/commands/migration-show.d.mts",
+      "import": "./dist/commands/migration-show.mjs"
+    },
+    "./commands/migration-status": {
+      "types": "./dist/commands/migration-status.d.mts",
+      "import": "./dist/commands/migration-status.mjs"
+    },
+    "./commands/migration-verify": {
+      "types": "./dist/commands/migration-verify.d.mts",
+      "import": "./dist/commands/migration-verify.mjs"
+    },
+    "./commands/migration-apply": {
+      "types": "./dist/commands/migration-apply.d.mts",
+      "import": "./dist/commands/migration-apply.mjs"
+    },
+    "./commands/migration-ref": {
+      "types": "./dist/commands/migration-ref.d.mts",
+      "import": "./dist/commands/migration-ref.mjs"
     },
     "./config-loader": {
-      "types": "./dist/config-loader.d.ts",
-      "import": "./dist/config-loader.js"
+      "types": "./dist/config-loader.d.mts",
+      "import": "./dist/config-loader.mjs"
+    },
+    "./control-api": {
+      "types": "./dist/exports/control-api.d.mts",
+      "import": "./dist/exports/control-api.mjs"
     }
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/1-framework/3-tooling/cli"
+  },
   "scripts": {
-    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
+    "build": "tsdown && node ./scripts/write-cli-js-compat.mjs",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",
     "lint": "biome check . --error-on-warnings",
     "lint:fix": "biome check --write .",
     "lint:fix:unsafe": "biome check --write --unsafe .",
-    "clean": "node ../../../../scripts/clean.mjs"
+    "record": "tsx scripts/record.ts",
+    "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
   }
 }

package/src/cli.ts

@@ -1,13 +1,39 @@
 import { Command } from 'commander';
 import { createContractEmitCommand } from './commands/contract-emit';
+import { createContractInferCommand } from './commands/contract-infer';
+import { installShutdownHandlers } from './utils/shutdown';
+
+// Install SIGINT/SIGTERM handlers before anything else
+installShutdownHandlers();
+
 import { createDbInitCommand } from './commands/db-init';
-import { createDbIntrospectCommand } from './commands/db-introspect';
-import { createDbSchemaVerifyCommand } from './commands/db-schema-verify';
+import { createDbSchemaCommand } from './commands/db-schema';
 import { createDbSignCommand } from './commands/db-sign';
+import { createDbUpdateCommand } from './commands/db-update';
 import { createDbVerifyCommand } from './commands/db-verify';
+import { createMigrationApplyCommand } from './commands/migration-apply';
+import { createMigrationPlanCommand } from './commands/migration-plan';
+import { createMigrationRefCommand } from './commands/migration-ref';
+import { createMigrationShowCommand } from './commands/migration-show';
+import { createMigrationStatusCommand } from './commands/migration-status';
+import { createMigrationVerifyCommand } from './commands/migration-verify';
 import { setCommandDescriptions } from './utils/command-helpers';
+import { formatCommandHelp, formatRootHelp } from './utils/formatters/help';
 import { parseGlobalFlags } from './utils/global-flags';
-import { formatCommandHelp, formatRootHelp } from './utils/output';
+import { suggestCommands } from './utils/suggest-command';
+
+/**
+ * Formats the "Did you mean ...?" hint for an unknown command.
+ */
+function formatSuggestion(input: string, candidates: readonly string[]): string {
+  const suggestions = suggestCommands(
+    input,
+    candidates.map((c) => c),
+  );
+  if (suggestions.length === 0) return '';
+  if (suggestions.length === 1) return `\nDid you mean ${suggestions[0]}?\n`;
+  return `\nDid you mean one of these?\n${suggestions.map((s) => `  ${s}`).join('\n')}\n`;
+}
 
 const program = new Command();
 
@@ -43,14 +69,11 @@ program.configureHelp({
 // Commands handle structured errors themselves via process.exit()
 program.exitOverride((err) => {
   if (err) {
-    // Help requests are not errors - allow Commander to output help and exit normally
-    // Commander throws errors with codes like 'commander.help', 'commander.helpDisplayed', or 'outputHelp'
     const errorCode = (err as { code?: string }).code;
     const errorMessage = String(err.message ?? '');
     const errorName = err.name ?? '';
 
-    // Check for unknown command errors first (before other checks)
-    // Commander.js uses code 'commander.unknownCommand' or error message contains 'unknown command'
+    // Unknown command/argument → exit 2 (CLI usage error)
     const isUnknownCommandError =
       errorCode === 'commander.unknownCommand' ||
       errorCode === 'commander.unknownArgument' ||
@@ -58,40 +81,34 @@ program.exitOverride((err) => {
         (errorMessage.includes('unknown command') || errorMessage.includes('unknown argument')));
     if (isUnknownCommandError) {
       const flags = parseGlobalFlags({});
-      // Extract the command/subcommand name from the error message
-      // Error message format: "unknown command 'command-name'"
       const match = errorMessage.match(/unknown command ['"]([^'"]+)['"]/);
       const commandName = match ? match[1] : process.argv[3] || process.argv[2] || 'unknown';
 
-      // Determine which command context we're in
-      // Check if the first argument is a recognized parent command
       const firstArg = process.argv[2];
       const parentCommand = firstArg
         ? program.commands.find((cmd) => cmd.name() === firstArg)
         : undefined;
 
       if (parentCommand && commandName !== firstArg) {
-        // Unrecognized subcommand - show parent command help
-        // eslint-disable-next-line no-console
-        console.error(`Unknown command: ${commandName}`);
-        // eslint-disable-next-line no-console
-        console.error('');
+        const subNames = parentCommand.commands.map((c) => c.name());
+        process.stderr.write(
+          `Unknown command: ${commandName}${formatSuggestion(commandName!, subNames)}\n`,
+        );
         const helpText = formatCommandHelp({ command: parentCommand, flags });
-        // eslint-disable-next-line no-console
-        console.log(helpText);
+        process.stderr.write(`${helpText}\n`);
       } else {
-        // Unrecognized top-level command - show root help
-        // eslint-disable-next-line no-console
-        console.error(`Unknown command: ${commandName}`);
-        // eslint-disable-next-line no-console
-        console.error('');
+        const topNames = program.commands.map((c) => c.name());
+        process.stderr.write(
+          `Unknown command: ${commandName}${formatSuggestion(commandName!, topNames)}\n`,
+        );
         const helpText = formatRootHelp({ program, flags });
-        // eslint-disable-next-line no-console
-        console.log(helpText);
+        process.stderr.write(`${helpText}\n`);
       }
-      process.exit(1);
+      process.exit(2);
       return;
     }
+
+    // Help requests → exit 0
     const isHelpError =
       errorCode === 'commander.help' ||
       errorCode === 'commander.helpDisplayed' ||
@@ -103,25 +120,22 @@ program.exitOverride((err) => {
       process.exit(0);
       return;
     }
-    // Missing required arguments/subcommands - show help and exit with 0
-    // Commander throws errors with code 'commander.missingArgument' or 'commander.missingMandatoryOptionValue'
-    // or when a command with subcommands is called without a subcommand
+
+    // Missing required arguments → exit 2 (CLI usage error)
     const isMissingArgumentError =
       errorCode === 'commander.missingArgument' ||
       errorCode === 'commander.missingMandatoryOptionValue' ||
       (errorName === 'CommanderError' &&
         (errorMessage.includes('missing') || errorMessage.includes('required')));
     if (isMissingArgumentError) {
-      // Help was already displayed by Commander.js, just exit with 0
-      process.exit(0);
+      process.exit(2);
       return;
     }
-    // Unhandled error - fail fast with exit code 1
-    // eslint-disable-next-line no-console
-    console.error(`Unhandled error: ${err.message}`);
+
+    // Unhandled error → exit 1
+    process.stderr.write(`Unhandled error: ${err.message}\n`);
     if (err.stack) {
-      // eslint-disable-next-line no-console
-      console.error(err.stack);
+      process.stderr.write(`${err.stack}\n`);
     }
     process.exit(1);
   }
@@ -148,6 +162,10 @@ contractCommand.configureHelp({
 const contractEmitCommand = createContractEmitCommand();
 contractCommand.addCommand(contractEmitCommand);
 
+// Add infer subcommand to contract
+const contractInferCommand = createContractInferCommand();
+contractCommand.addCommand(contractInferCommand);
+
 // Register contract command
 program.addCommand(contractCommand);
 
@@ -175,13 +193,13 @@ dbCommand.addCommand(dbVerifyCommand);
 const dbInitCommand = createDbInitCommand();
 dbCommand.addCommand(dbInitCommand);
 
-// Add introspect subcommand to db
-const dbIntrospectCommand = createDbIntrospectCommand();
-dbCommand.addCommand(dbIntrospectCommand);
+// Add update subcommand to db
+const dbUpdateCommand = createDbUpdateCommand();
+dbCommand.addCommand(dbUpdateCommand);
 
-// Add schema-verify subcommand to db
-const dbSchemaVerifyCommand = createDbSchemaVerifyCommand();
-dbCommand.addCommand(dbSchemaVerifyCommand);
+// Add schema subcommand to db
+const dbSchemaCommand = createDbSchemaCommand();
+dbCommand.addCommand(dbSchemaCommand);
 
 // Add sign subcommand to db
 const dbSignCommand = createDbSignCommand();
@@ -190,6 +208,42 @@ dbCommand.addCommand(dbSignCommand);
 // Register db command
 program.addCommand(dbCommand);
 
+// Register migration subcommand
+const migrationCommand = new Command('migration');
+setCommandDescriptions(
+  migrationCommand,
+  'On-disk migration management commands',
+  'Plan, apply, verify, and scaffold on-disk migration packages. Migrations are\n' +
+    'contract-to-contract edges stored as versioned directories under migrations/.',
+);
+migrationCommand.configureHelp({
+  formatHelp: (cmd) => {
+    const flags = parseGlobalFlags({});
+    return formatCommandHelp({ command: cmd, flags });
+  },
+  subcommandDescription: () => '',
+});
+
+const migrationPlanCommand = createMigrationPlanCommand();
+migrationCommand.addCommand(migrationPlanCommand);
+
+const migrationShowCommand = createMigrationShowCommand();
+migrationCommand.addCommand(migrationShowCommand);
+
+const migrationStatusCommand = createMigrationStatusCommand();
+migrationCommand.addCommand(migrationStatusCommand);
+
+const migrationVerifyCommand = createMigrationVerifyCommand();
+migrationCommand.addCommand(migrationVerifyCommand);
+
+const migrationApplyCommand = createMigrationApplyCommand();
+migrationCommand.addCommand(migrationApplyCommand);
+
+const migrationRefCommand = createMigrationRefCommand();
+migrationCommand.addCommand(migrationRefCommand);
+
+program.addCommand(migrationCommand);
+
 // Create help command
 const helpCommand = new Command('help')
   .description('Show usage instructions')
@@ -202,8 +256,8 @@ const helpCommand = new Command('help')
   .action(() => {
     const flags = parseGlobalFlags({});
     const helpText = formatRootHelp({ program, flags });
-    // eslint-disable-next-line no-console
-    console.log(helpText);
+    // Help is decoration → stderr
+    process.stderr.write(`${helpText}\n`);
     process.exit(0);
   });
 
@@ -213,8 +267,7 @@ program.addCommand(helpCommand);
 program.action(() => {
   const flags = parseGlobalFlags({});
   const helpText = formatRootHelp({ program, flags });
-  // eslint-disable-next-line no-console
-  console.log(helpText);
+  process.stderr.write(`${helpText}\n`);
   process.exit(0);
 });
 
@@ -225,8 +278,8 @@ if (args.length > 0) {
   const commandName = args[0];
   // Handle version option explicitly since we suppress default output
   if (commandName === '--version' || commandName === '-V') {
-    // eslint-disable-next-line no-console
-    console.log(program.version());
+    // Version is data → stdout
+    process.stdout.write(`${program.version()}\n`);
     process.exit(0);
   }
   // Skip command check for global options like --help, -h
@@ -236,22 +289,20 @@ if (args.length > 0) {
     const command = program.commands.find((cmd) => cmd.name() === commandName);
 
     if (!command) {
-      // Unrecognized command - show error message and usage
+      // Unrecognized command → exit 2 (CLI usage error)
       const flags = parseGlobalFlags({});
-      // eslint-disable-next-line no-console
-      console.error(`Unknown command: ${commandName}`);
-      // eslint-disable-next-line no-console
-      console.error('');
+      const topNames = program.commands.map((c) => c.name());
+      process.stderr.write(
+        `Unknown command: ${commandName}${formatSuggestion(commandName!, topNames)}\n`,
+      );
       const helpText = formatRootHelp({ program, flags });
-      // eslint-disable-next-line no-console
-      console.log(helpText);
-      process.exit(1);
+      process.stderr.write(`${helpText}\n`);
+      process.exit(2);
     } else if (command.commands.length > 0 && args.length === 1) {
       // Parent command called with no subcommand - show help and exit with 0
       const flags = parseGlobalFlags({});
       const helpText = formatCommandHelp({ command, flags });
-      // eslint-disable-next-line no-console
-      console.log(helpText);
+      process.stderr.write(`${helpText}\n`);
       process.exit(0);
     }
   }