@prisma-next/cli 0.5.0-dev.25 → 0.5.0-dev.27

package/dist/{migrations-CSaDHNpB.mjs → migrations-CYYmURZx.mjs}

@@ -87,8 +87,7 @@ function formatMigrationShowOutput(result, flags) {
 	const formatYellow = createColorFormatter(useColor, yellow);
 	const formatDimText = (text) => formatDim(useColor, text);
 	lines.push(`${formatGreen("✔")} ${result.dirName}`);
-	lines.push(`${formatDimText(`  kind: ${result.kind}`)}`);
-	lines.push(`${formatDimText(`  from: ${result.from}`)}`);
+	lines.push(`${formatDimText(`  from: ${result.from ?? "(baseline)"}`)}`);
 	lines.push(`${formatDimText(`  to:   ${result.to}`)}`);
 	lines.push(`${formatDimText(`  migrationHash: ${result.migrationHash}`)}`);
 	lines.push(`${formatDimText(`  created: ${result.createdAt}`)}`);
@@ -150,4 +149,4 @@ function formatMigrationJson(result) {
 
 //#endregion
 export { formatMigrationShowOutput as a, formatMigrationPlanOutput as i, formatMigrationApplyOutput as n, formatMigrationJson as r, formatMigrationApplyCommandOutput as t };
-//# sourceMappingURL=migrations-CSaDHNpB.mjs.map
+//# sourceMappingURL=migrations-CYYmURZx.mjs.map

package/dist/{migrations-CSaDHNpB.mjs.map → migrations-CYYmURZx.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"migrations-CSaDHNpB.mjs","names":["lines: string[]"],"sources":["../src/utils/formatters/migrations.ts"],"sourcesContent":["import { green, yellow } from 'colorette';\n\nimport type { GlobalFlags } from '../global-flags';\nimport { createColorFormatter, formatDim, isVerbose } from './helpers';\n\n// ============================================================================\n// Migration Command Output Formatters (shared by db init and db update)\n// ============================================================================\n\n/**\n * Shared CLI output type for migration commands (db init, db update).\n */\nexport interface MigrationCommandResult {\n  readonly ok: true;\n  readonly mode: 'plan' | 'apply';\n  readonly plan: {\n    readonly targetId: string;\n    readonly destination: {\n      readonly storageHash: string;\n      readonly profileHash?: string;\n    };\n    readonly operations: readonly {\n      readonly id: string;\n      readonly label: string;\n      readonly operationClass: string;\n    }[];\n    readonly sql?: readonly string[];\n  };\n  readonly execution?: {\n    readonly operationsPlanned: number;\n    readonly operationsExecuted: number;\n  };\n  readonly marker?: {\n    readonly storageHash: string;\n    readonly profileHash?: string;\n  };\n  readonly summary: string;\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\n/**\n * Formats human-readable output for migration commands (db init, db update) in plan mode.\n */\nexport function formatMigrationPlanOutput(\n  result: MigrationCommandResult,\n  flags: GlobalFlags,\n): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  // Plan summary\n  const operationCount = result.plan?.operations.length ?? 0;\n  lines.push(`${formatGreen('✔')} Planned ${operationCount} operation(s)`);\n\n  // Show operations tree\n  if (result.plan?.operations && result.plan.operations.length > 0) {\n    const formatYellow = createColorFormatter(useColor, yellow);\n    lines.push(`${formatDimText('│')}`);\n    for (let i = 0; i < result.plan.operations.length; i++) {\n      const op = result.plan.operations[i];\n      if (!op) continue;\n      const isLast = i === result.plan.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      const opClassLabel =\n        op.operationClass === 'destructive'\n          ? formatYellow(`[${op.operationClass}]`)\n          : formatDimText(`[${op.operationClass}]`);\n      lines.push(`${formatDimText(treeChar)}─ ${op.label} ${opClassLabel}`);\n    }\n\n    const hasDestructive = result.plan.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${formatYellow('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n  }\n\n  // Destination hash\n  if (result.plan?.destination) {\n    lines.push('');\n    lines.push(`${formatDimText(`Destination hash: ${result.plan.destination.storageHash}`)}`);\n  }\n\n  // SQL DDL preview (SQL family only)\n  const planSql = result.plan?.sql;\n  if (planSql) {\n    lines.push('');\n    lines.push(`${formatDimText('DDL preview')}`);\n    if (planSql.length === 0) {\n      lines.push(`${formatDimText('No DDL operations.')}`);\n    } else {\n      lines.push('');\n      for (const statement of planSql) {\n        const trimmed = statement.trim();\n        if (!trimmed) continue;\n        const line = trimmed.endsWith(';') ? trimmed : `${trimmed};`;\n        lines.push(`${line}`);\n      }\n    }\n  }\n\n  // Timings in verbose mode\n  if (isVerbose(flags, 1)) {\n    lines.push(`${formatDimText(`Total time: ${result.timings.total}ms`)}`);\n  }\n\n  // Note about dry run\n  lines.push('');\n  lines.push(`${formatDimText('This is a dry run. No changes were applied.')}`);\n  lines.push(`${formatDimText('Run without --dry-run to apply changes.')}`);\n\n  return lines.join('\\n');\n}\n\nexport interface MigrationApplyCommandOutputResult {\n  readonly migrationsApplied: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly dirName: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly timings?: {\n    readonly total: number;\n  };\n}\n\nexport function formatMigrationApplyCommandOutput(\n  result: MigrationApplyCommandOutputResult,\n  flags: GlobalFlags,\n): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  if (result.migrationsApplied === 0) {\n    lines.push(`${formatGreen('✔')} ${result.summary}`);\n    lines.push(formatDimText(`  marker: ${result.markerHash}`));\n    return lines.join('\\n');\n  }\n\n  lines.push(`${formatGreen('✔')} ${result.summary}`);\n  lines.push('');\n\n  for (let i = 0; i < result.applied.length; i++) {\n    const migration = result.applied[i]!;\n    const isLast = i === result.applied.length - 1;\n    const treeChar = isLast ? '└' : '├';\n    lines.push(\n      `${formatDimText(treeChar)}─ ${migration.dirName} ${formatDimText(`[${migration.operationsExecuted} op(s)]`)}`,\n    );\n  }\n\n  lines.push('');\n  lines.push(formatDimText(`marker: ${result.markerHash}`));\n\n  if (isVerbose(flags, 1) && result.timings) {\n    lines.push('');\n    lines.push(formatDimText(`Total time: ${result.timings.total}ms`));\n  }\n\n  return lines.join('\\n');\n}\n\ninterface MigrationShowResult {\n  readonly dirName: string;\n  readonly dirPath: string;\n  readonly from: string;\n  readonly to: string;\n  readonly migrationHash: string;\n  readonly kind: string;\n  readonly createdAt: string;\n  readonly operations: readonly {\n    readonly id: string;\n    readonly label: string;\n    readonly operationClass: string;\n  }[];\n  readonly sql: readonly string[];\n  readonly summary: string;\n}\n\nexport function formatMigrationShowOutput(result: MigrationShowResult, flags: GlobalFlags): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatYellow = createColorFormatter(useColor, yellow);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  lines.push(`${formatGreen('✔')} ${result.dirName}`);\n  lines.push(`${formatDimText(`  kind: ${result.kind}`)}`);\n  lines.push(`${formatDimText(`  from: ${result.from}`)}`);\n  lines.push(`${formatDimText(`  to:   ${result.to}`)}`);\n  lines.push(`${formatDimText(`  migrationHash: ${result.migrationHash}`)}`);\n  lines.push(`${formatDimText(`  created: ${result.createdAt}`)}`);\n\n  lines.push('');\n  lines.push(`${result.operations.length} operation(s)`);\n\n  if (result.operations.length > 0) {\n    lines.push(`${formatDimText('│')}`);\n    for (let i = 0; i < result.operations.length; i++) {\n      const op = result.operations[i]!;\n      const isLast = i === result.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      const opClassLabel =\n        op.operationClass === 'destructive'\n          ? formatYellow(`[${op.operationClass}]`)\n          : formatDimText(`[${op.operationClass}]`);\n      lines.push(`${formatDimText(treeChar)}─ ${op.label} ${opClassLabel}`);\n    }\n\n    const hasDestructive = result.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${formatYellow('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n  }\n\n  if (result.sql.length > 0) {\n    lines.push('');\n    lines.push(`${formatDimText('DDL preview')}`);\n    lines.push('');\n    for (const statement of result.sql) {\n      const trimmed = statement.trim();\n      if (!trimmed) continue;\n      const line = trimmed.endsWith(';') ? trimmed : `${trimmed};`;\n      lines.push(`${line}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Formats human-readable output for migration commands (db init, db update) in apply mode.\n */\nexport function formatMigrationApplyOutput(\n  result: MigrationCommandResult,\n  flags: GlobalFlags,\n): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  if (result.ok) {\n    // Success summary\n    const executed = result.execution?.operationsExecuted ?? 0;\n    if (executed === 0) {\n      lines.push(`${formatGreen('✔')} Database already matches contract`);\n    } else {\n      lines.push(`${formatGreen('✔')} Applied ${executed} operation(s)`);\n    }\n\n    // Marker info\n    if (result.marker) {\n      lines.push(`${formatDimText(`  Signature: ${result.marker.storageHash}`)}`);\n      if (result.marker.profileHash) {\n        lines.push(`${formatDimText(`  Profile hash: ${result.marker.profileHash}`)}`);\n      }\n    }\n\n    // Timings in verbose mode\n    if (isVerbose(flags, 1)) {\n      lines.push(`${formatDimText(`  Total time: ${result.timings.total}ms`)}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Formats JSON output for migration commands (db init, db update).\n */\nexport function formatMigrationJson(result: MigrationCommandResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":"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"}
+{"version":3,"file":"migrations-CYYmURZx.mjs","names":["lines: string[]"],"sources":["../src/utils/formatters/migrations.ts"],"sourcesContent":["import { green, yellow } from 'colorette';\n\nimport type { GlobalFlags } from '../global-flags';\nimport { createColorFormatter, formatDim, isVerbose } from './helpers';\n\n// ============================================================================\n// Migration Command Output Formatters (shared by db init and db update)\n// ============================================================================\n\n/**\n * Shared CLI output type for migration commands (db init, db update).\n */\nexport interface MigrationCommandResult {\n  readonly ok: true;\n  readonly mode: 'plan' | 'apply';\n  readonly plan: {\n    readonly targetId: string;\n    readonly destination: {\n      readonly storageHash: string;\n      readonly profileHash?: string;\n    };\n    readonly operations: readonly {\n      readonly id: string;\n      readonly label: string;\n      readonly operationClass: string;\n    }[];\n    readonly sql?: readonly string[];\n  };\n  readonly execution?: {\n    readonly operationsPlanned: number;\n    readonly operationsExecuted: number;\n  };\n  readonly marker?: {\n    readonly storageHash: string;\n    readonly profileHash?: string;\n  };\n  readonly summary: string;\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\n/**\n * Formats human-readable output for migration commands (db init, db update) in plan mode.\n */\nexport function formatMigrationPlanOutput(\n  result: MigrationCommandResult,\n  flags: GlobalFlags,\n): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  // Plan summary\n  const operationCount = result.plan?.operations.length ?? 0;\n  lines.push(`${formatGreen('✔')} Planned ${operationCount} operation(s)`);\n\n  // Show operations tree\n  if (result.plan?.operations && result.plan.operations.length > 0) {\n    const formatYellow = createColorFormatter(useColor, yellow);\n    lines.push(`${formatDimText('│')}`);\n    for (let i = 0; i < result.plan.operations.length; i++) {\n      const op = result.plan.operations[i];\n      if (!op) continue;\n      const isLast = i === result.plan.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      const opClassLabel =\n        op.operationClass === 'destructive'\n          ? formatYellow(`[${op.operationClass}]`)\n          : formatDimText(`[${op.operationClass}]`);\n      lines.push(`${formatDimText(treeChar)}─ ${op.label} ${opClassLabel}`);\n    }\n\n    const hasDestructive = result.plan.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${formatYellow('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n  }\n\n  // Destination hash\n  if (result.plan?.destination) {\n    lines.push('');\n    lines.push(`${formatDimText(`Destination hash: ${result.plan.destination.storageHash}`)}`);\n  }\n\n  // SQL DDL preview (SQL family only)\n  const planSql = result.plan?.sql;\n  if (planSql) {\n    lines.push('');\n    lines.push(`${formatDimText('DDL preview')}`);\n    if (planSql.length === 0) {\n      lines.push(`${formatDimText('No DDL operations.')}`);\n    } else {\n      lines.push('');\n      for (const statement of planSql) {\n        const trimmed = statement.trim();\n        if (!trimmed) continue;\n        const line = trimmed.endsWith(';') ? trimmed : `${trimmed};`;\n        lines.push(`${line}`);\n      }\n    }\n  }\n\n  // Timings in verbose mode\n  if (isVerbose(flags, 1)) {\n    lines.push(`${formatDimText(`Total time: ${result.timings.total}ms`)}`);\n  }\n\n  // Note about dry run\n  lines.push('');\n  lines.push(`${formatDimText('This is a dry run. No changes were applied.')}`);\n  lines.push(`${formatDimText('Run without --dry-run to apply changes.')}`);\n\n  return lines.join('\\n');\n}\n\nexport interface MigrationApplyCommandOutputResult {\n  readonly migrationsApplied: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly dirName: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly timings?: {\n    readonly total: number;\n  };\n}\n\nexport function formatMigrationApplyCommandOutput(\n  result: MigrationApplyCommandOutputResult,\n  flags: GlobalFlags,\n): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  if (result.migrationsApplied === 0) {\n    lines.push(`${formatGreen('✔')} ${result.summary}`);\n    lines.push(formatDimText(`  marker: ${result.markerHash}`));\n    return lines.join('\\n');\n  }\n\n  lines.push(`${formatGreen('✔')} ${result.summary}`);\n  lines.push('');\n\n  for (let i = 0; i < result.applied.length; i++) {\n    const migration = result.applied[i]!;\n    const isLast = i === result.applied.length - 1;\n    const treeChar = isLast ? '└' : '├';\n    lines.push(\n      `${formatDimText(treeChar)}─ ${migration.dirName} ${formatDimText(`[${migration.operationsExecuted} op(s)]`)}`,\n    );\n  }\n\n  lines.push('');\n  lines.push(formatDimText(`marker: ${result.markerHash}`));\n\n  if (isVerbose(flags, 1) && result.timings) {\n    lines.push('');\n    lines.push(formatDimText(`Total time: ${result.timings.total}ms`));\n  }\n\n  return lines.join('\\n');\n}\n\ninterface MigrationShowResult {\n  readonly dirName: string;\n  readonly dirPath: string;\n  readonly from: string | null;\n  readonly to: string;\n  readonly migrationHash: string;\n  readonly createdAt: string;\n  readonly operations: readonly {\n    readonly id: string;\n    readonly label: string;\n    readonly operationClass: string;\n  }[];\n  readonly sql: readonly string[];\n  readonly summary: string;\n}\n\nexport function formatMigrationShowOutput(result: MigrationShowResult, flags: GlobalFlags): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatYellow = createColorFormatter(useColor, yellow);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  lines.push(`${formatGreen('✔')} ${result.dirName}`);\n  lines.push(`${formatDimText(`  from: ${result.from ?? '(baseline)'}`)}`);\n  lines.push(`${formatDimText(`  to:   ${result.to}`)}`);\n  lines.push(`${formatDimText(`  migrationHash: ${result.migrationHash}`)}`);\n  lines.push(`${formatDimText(`  created: ${result.createdAt}`)}`);\n\n  lines.push('');\n  lines.push(`${result.operations.length} operation(s)`);\n\n  if (result.operations.length > 0) {\n    lines.push(`${formatDimText('│')}`);\n    for (let i = 0; i < result.operations.length; i++) {\n      const op = result.operations[i]!;\n      const isLast = i === result.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      const opClassLabel =\n        op.operationClass === 'destructive'\n          ? formatYellow(`[${op.operationClass}]`)\n          : formatDimText(`[${op.operationClass}]`);\n      lines.push(`${formatDimText(treeChar)}─ ${op.label} ${opClassLabel}`);\n    }\n\n    const hasDestructive = result.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${formatYellow('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n  }\n\n  if (result.sql.length > 0) {\n    lines.push('');\n    lines.push(`${formatDimText('DDL preview')}`);\n    lines.push('');\n    for (const statement of result.sql) {\n      const trimmed = statement.trim();\n      if (!trimmed) continue;\n      const line = trimmed.endsWith(';') ? trimmed : `${trimmed};`;\n      lines.push(`${line}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Formats human-readable output for migration commands (db init, db update) in apply mode.\n */\nexport function formatMigrationApplyOutput(\n  result: MigrationCommandResult,\n  flags: GlobalFlags,\n): string {\n  if (flags.quiet) {\n    return '';\n  }\n\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  if (result.ok) {\n    // Success summary\n    const executed = result.execution?.operationsExecuted ?? 0;\n    if (executed === 0) {\n      lines.push(`${formatGreen('✔')} Database already matches contract`);\n    } else {\n      lines.push(`${formatGreen('✔')} Applied ${executed} operation(s)`);\n    }\n\n    // Marker info\n    if (result.marker) {\n      lines.push(`${formatDimText(`  Signature: ${result.marker.storageHash}`)}`);\n      if (result.marker.profileHash) {\n        lines.push(`${formatDimText(`  Profile hash: ${result.marker.profileHash}`)}`);\n      }\n    }\n\n    // Timings in verbose mode\n    if (isVerbose(flags, 1)) {\n      lines.push(`${formatDimText(`  Total time: ${result.timings.total}ms`)}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Formats JSON output for migration commands (db init, db update).\n */\nexport function formatMigrationJson(result: MigrationCommandResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma-next/cli",
-  "version": "0.5.0-dev.25",
+  "version": "0.5.0-dev.27",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -15,6 +15,7 @@
     "@dagrejs/dagre": "^3.0.0",
     "arktype": "^2.0.0",
     "c12": "^3.3.2",
+    "clipanion": "4.0.0-rc.4",
     "closest-match": "^1.3.3",
     "colorette": "^2.0.20",
     "commander": "^12.0.0",
@@ -25,27 +26,27 @@
     "string-width": "^8.2.0",
     "strip-ansi": "^7.1.2",
     "wrap-ansi": "^10.0.0",
-    "@prisma-next/contract": "0.5.0-dev.25",
-    "@prisma-next/emitter": "0.5.0-dev.25",
-    "@prisma-next/framework-components": "0.5.0-dev.25",
-    "@prisma-next/config": "0.5.0-dev.25",
-    "@prisma-next/errors": "0.5.0-dev.25",
-    "@prisma-next/migration-tools": "0.5.0-dev.25",
-    "@prisma-next/psl-printer": "0.5.0-dev.25",
-    "@prisma-next/utils": "0.5.0-dev.25"
+    "@prisma-next/config": "0.5.0-dev.27",
+    "@prisma-next/contract": "0.5.0-dev.27",
+    "@prisma-next/emitter": "0.5.0-dev.27",
+    "@prisma-next/framework-components": "0.5.0-dev.27",
+    "@prisma-next/migration-tools": "0.5.0-dev.27",
+    "@prisma-next/errors": "0.5.0-dev.27",
+    "@prisma-next/utils": "0.5.0-dev.27",
+    "@prisma-next/psl-printer": "0.5.0-dev.27"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
-    "@prisma-next/sql-contract": "0.5.0-dev.25",
-    "@prisma-next/sql-contract-ts": "0.5.0-dev.25",
-    "@prisma-next/sql-contract-emitter": "0.5.0-dev.25",
-    "@prisma-next/sql-runtime": "0.5.0-dev.25",
-    "@prisma-next/sql-operations": "0.5.0-dev.25",
-    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/sql-contract": "0.5.0-dev.27",
+    "@prisma-next/sql-contract-emitter": "0.5.0-dev.27",
+    "@prisma-next/sql-operations": "0.5.0-dev.27",
+    "@prisma-next/sql-contract-ts": "0.5.0-dev.27",
+    "@prisma-next/sql-runtime": "0.5.0-dev.27",
     "@prisma-next/test-utils": "0.0.1",
+    "@prisma-next/tsconfig": "0.0.0",
     "@prisma-next/tsdown": "0.0.0"
   },
   "exports": {

package/src/cli.ts

@@ -50,8 +50,18 @@ program.configureOutput({
   writeErr: () => {
     // Suppress all default error output - we handle errors in exitOverride
   },
-  writeOut: () => {
-    // Suppress all default output - our custom formatters handle everything
+  writeOut: (str) => {
+    // Commander routes explicitly-requested `--help` (success-path help)
+    // through writeOut; per the Style Guide § Output Conventions rule 8,
+    // user-requested help is data and goes to stdout. Error-path help
+    // (e.g. usage shown after an unknown command) goes through writeErr,
+    // which stays suppressed because we render that ourselves with the
+    // matching error envelope.
+    //
+    // Explicit `--version` is short-circuited before `program.parse()`
+    // (see the argv pre-scan at the bottom of this file), so it does not
+    // reach this writer.
+    process.stdout.write(str);
   },
 });
 
@@ -261,14 +271,25 @@ const helpCommand = new Command('help')
   .action(() => {
     const flags = parseGlobalFlags({});
     const helpText = formatRootHelp({ program, flags });
-    // Help is decoration → stderr
-    process.stderr.write(`${helpText}\n`);
+    // The `help` command was invoked explicitly: help is the data the
+    // caller asked for. Per Style Guide § Output Conventions rule 8,
+    // explicit help goes to stdout with exit code 0.
+    process.stdout.write(`${helpText}\n`);
     process.exit(0);
   });
 
 program.addCommand(helpCommand);
 
-// Set help as the default action when no command is provided
+// Set help as the default action when no command is provided. The user
+// did not invoke `--help`; we are voluntarily showing usage to help them
+// recover from an underspecified invocation, so the help text is
+// decoration around an implicit "what did you want me to do?" and goes
+// to stderr (Style Guide § Output Conventions rule 8).
+//
+// FOLLOW-UP: the exit code here is 0 today, but a no-arg invocation is
+// arguably a usage error (PRECONDITION → exit 2) for consistency with
+// the unknown-command path. Out of scope for the explicit-help routing
+// work; revisit when tightening exit-code semantics across the CLI.
 program.action(() => {
   const flags = parseGlobalFlags({});
   const helpText = formatRootHelp({ program, flags });
@@ -304,7 +325,12 @@ if (args.length > 0) {
       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
+      // Parent command called with no subcommand. Same shape as the
+      // no-args case above: the user did not request help, we are
+      // voluntarily rendering it as decoration around an underspecified
+      // invocation, so it goes to stderr per Style Guide § Output
+      // Conventions rule 8. Exit code 0 today; the FOLLOW-UP note on
+      // `program.action` applies here too (arguably should be 2).
       const flags = parseGlobalFlags({});
       const helpText = formatCommandHelp({ command, flags });
       process.stderr.write(`${helpText}\n`);

package/src/commands/migration-apply.ts

@@ -50,7 +50,7 @@ export interface MigrationApplyResult {
   readonly markerHash: string;
   readonly applied: readonly {
     readonly dirName: string;
-    readonly from: string;
+    readonly from: string | null;
     readonly to: string;
     readonly operationsExecuted: number;
   }[];

package/src/commands/migration-new.ts

@@ -12,7 +12,6 @@ import { readFileSync } from 'node:fs';
 import type { Contract } from '@prisma-next/contract/types';
 import { getEmittedArtifactPaths } from '@prisma-next/emitter';
 import { createControlStack } from '@prisma-next/framework-components/control';
-import { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';
 import { MigrationToolsError } from '@prisma-next/migration-tools/errors';
 import { computeMigrationHash } from '@prisma-next/migration-tools/hash';
 import {
@@ -62,7 +61,7 @@ interface MigrationNewOptions extends CommonCommandOptions {
 interface MigrationNewResult {
   readonly ok: true;
   readonly dir: string;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
   readonly summary: string;
 }
@@ -117,7 +116,7 @@ async function executeMigrationNewCommand(
   }
 
   let fromContract: Contract | null = null;
-  let fromHash: string = EMPTY_CONTRACT_HASH;
+  let fromHash: string | null = null;
   let fromContractSourceDir: string | null = null;
 
   try {
@@ -181,7 +180,6 @@ async function executeMigrationNewCommand(
   const baseMetadata: Omit<MigrationMetadata, 'migrationHash'> = {
     from: fromHash,
     to: toStorageHash,
-    kind: 'regular',
     fromContract,
     toContract: toContractJson,
     hints: {

package/src/commands/migration-plan.ts

@@ -5,7 +5,6 @@ import {
   createControlStack,
   type MigrationPlanOperation,
 } from '@prisma-next/framework-components/control';
-import { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';
 import { MigrationToolsError } from '@prisma-next/migration-tools/errors';
 import { computeMigrationHash } from '@prisma-next/migration-tools/hash';
 import { deriveProvidedInvariants } from '@prisma-next/migration-tools/invariants';
@@ -58,7 +57,7 @@ interface MigrationPlanOptions extends CommonCommandOptions {
 export interface MigrationPlanResult {
   readonly ok: boolean;
   readonly noOp: boolean;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
   readonly dir?: string;
   readonly operations: readonly {
@@ -160,7 +159,7 @@ async function executeMigrationPlanCommand(
 
   // Read existing migrations and determine "from" contract
   let fromContract: Contract | null = null;
-  let fromHash: string = EMPTY_CONTRACT_HASH;
+  let fromHash: string | null = null;
   let fromContractSourceDir: string | null = null;
 
   try {
@@ -252,7 +251,6 @@ async function executeMigrationPlanCommand(
   const baseMetadata: Omit<MigrationMetadata, 'migrationHash' | 'providedInvariants'> = {
     from: fromHash,
     to: toStorageHash,
-    kind: 'regular',
     fromContract,
     toContract: toContractJson,
     hints: {

package/src/commands/migration-show.ts

@@ -37,10 +37,9 @@ export interface MigrationShowResult {
   readonly ok: true;
   readonly dirName: string;
   readonly dirPath: string;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
   readonly migrationHash: string;
-  readonly kind: string;
   readonly createdAt: string;
   readonly operations: readonly {
     readonly id: string;
@@ -184,7 +183,6 @@ async function executeMigrationShowCommand(
     from: pkg.metadata.from,
     to: pkg.metadata.to,
     migrationHash: pkg.metadata.migrationHash,
-    kind: pkg.metadata.kind,
     createdAt: pkg.metadata.createdAt,
     operations: ops.map((op) => ({
       id: op.id,

package/src/control-api/operations/db-init.ts

@@ -84,8 +84,9 @@ export async function executeDbInit<TFamilyId extends string, TTargetId extends
     schema: schemaIR,
     policy,
     // `db init` does not produce a `migration.ts`, so the from-hash on the
-    // resulting plan is never surfaced to authoring — pass empty string.
-    fromHash: '',
+    // resulting plan is never surfaced to authoring — pass null (the
+    // baseline encoding for `MigrationPlanner.plan({ fromHash })`).
+    fromHash: null,
     frameworkComponents,
   });
 

package/src/control-api/operations/db-update.ts

@@ -84,8 +84,9 @@ export async function executeDbUpdate<TFamilyId extends string, TTargetId extend
     schema: schemaIR,
     policy,
     // `db update` does not produce a `migration.ts`, so the from-hash on the
-    // resulting plan is never surfaced to authoring — pass empty string.
-    fromHash: '',
+    // resulting plan is never surfaced to authoring — pass null (the
+    // baseline encoding for `MigrationPlanner.plan({ fromHash })`).
+    fromHash: null,
     frameworkComponents,
   });
   if (plannerResult.kind === 'failure') {

package/src/control-api/operations/migration-apply.ts

@@ -79,15 +79,19 @@ export async function executeMigrationApply<TFamilyId extends string, TTargetId
 
   const firstMigration = pendingMigrations[0]!;
   const lastMigration = pendingMigrations[pendingMigrations.length - 1]!;
-  if (firstMigration.from !== originHash || lastMigration.to !== destinationHash) {
+  // Manifest `from` is `string | null` (null = baseline). The live-marker
+  // layer encodes "no prior state" as EMPTY_CONTRACT_HASH; bridge here so the
+  // string comparisons below work uniformly.
+  const firstFromMarker = firstMigration.from ?? EMPTY_CONTRACT_HASH;
+  if (firstFromMarker !== originHash || lastMigration.to !== destinationHash) {
     return notOk({
       code: 'MIGRATION_PATH_NOT_FOUND' as const,
       summary: 'Migration apply path does not match requested origin and destination',
-      why: `Path resolved as ${firstMigration.from} -> ${lastMigration.to}, but requested ${originHash} -> ${destinationHash}`,
+      why: `Path resolved as ${firstFromMarker} -> ${lastMigration.to}, but requested ${originHash} -> ${destinationHash}`,
       meta: {
         originHash,
         destinationHash,
-        pathOrigin: firstMigration.from,
+        pathOrigin: firstFromMarker,
         pathDestination: lastMigration.to,
       },
     });
@@ -96,18 +100,19 @@ export async function executeMigrationApply<TFamilyId extends string, TTargetId
   for (let i = 1; i < pendingMigrations.length; i++) {
     const previous = pendingMigrations[i - 1]!;
     const current = pendingMigrations[i]!;
-    if (previous.to !== current.from) {
+    const currentFromMarker = current.from ?? EMPTY_CONTRACT_HASH;
+    if (previous.to !== currentFromMarker) {
       return notOk({
         code: 'MIGRATION_PATH_NOT_FOUND' as const,
         summary: 'Migration apply path contains a discontinuity between adjacent migrations',
-        why: `Migration "${previous.dirName}" ends at ${previous.to}, but next migration "${current.dirName}" starts at ${current.from}`,
+        why: `Migration "${previous.dirName}" ends at ${previous.to}, but next migration "${current.dirName}" starts at ${currentFromMarker}`,
         meta: {
           originHash,
           destinationHash,
           previousDirName: previous.dirName,
           previousTo: previous.to,
           currentDirName: current.dirName,
-          currentFrom: current.from,
+          currentFrom: currentFromMarker,
           discontinuityIndex: i,
         },
       });
@@ -135,11 +140,11 @@ export async function executeMigrationApply<TFamilyId extends string, TTargetId
       allowedOperationClasses: ['additive', 'widening', 'destructive', 'data'] as const,
     };
 
-    // EMPTY_CONTRACT_HASH means "no prior state" — the runner expects origin: null
-    // for a fresh database (no marker present).
+    // Manifest `from === null` means "no prior state" — the runner expects
+    // `origin: null` for a fresh database (no marker present).
     const plan = {
       targetId,
-      origin: migration.from === EMPTY_CONTRACT_HASH ? null : { storageHash: migration.from },
+      origin: migration.from === null ? null : { storageHash: migration.from },
       destination: { storageHash: migration.to },
       operations,
     };

package/src/control-api/types.ts

@@ -432,7 +432,7 @@ export type EmitResult = Result<EmitSuccess, EmitFailure>;
  */
 export interface MigrationApplyStep {
   readonly dirName: string;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
   readonly toContract: Contract;
   readonly operations: readonly MigrationPlanOperation[];
@@ -471,7 +471,7 @@ export interface MigrationApplyOptions {
  */
 export interface MigrationApplyAppliedEntry {
   readonly dirName: string;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
   readonly operationsExecuted: number;
 }