@prisma-next/core-control-plane 0.3.0-dev.7 → 0.3.0-dev.71

package/src/errors.ts

@@ -3,6 +3,7 @@
  * This is the serialized form of a CliStructuredError.
  */
 export interface CliErrorEnvelope {
+  readonly ok: false;
   readonly code: string;
   readonly domain: string;
   readonly severity: 'error' | 'warn' | 'info';
@@ -66,7 +67,7 @@ export class CliStructuredError extends Error {
     this.domain = options?.domain ?? 'CLI';
     this.severity = options?.severity ?? 'error';
     this.why = options?.why;
-    this.fix = options?.fix;
+    this.fix = options?.fix === options?.why ? undefined : options?.fix;
     this.where = options?.where
       ? {
           path: options.where.path,
@@ -83,6 +84,7 @@ export class CliStructuredError extends Error {
   toEnvelope(): CliErrorEnvelope {
     const codePrefix = this.domain === 'CLI' ? 'PN-CLI-' : 'PN-RTM-';
     return {
+      ok: false as const,
       code: `${codePrefix}${this.code}`,
       domain: this.domain,
       severity: this.severity,
@@ -94,6 +96,23 @@ export class CliStructuredError extends Error {
       docsUrl: this.docsUrl,
     };
   }
+
+  /**
+   * Type guard to check if an error is a CliStructuredError.
+   * Uses duck-typing to work across module boundaries where instanceof may fail.
+   */
+  static is(error: unknown): error is CliStructuredError {
+    if (!(error instanceof Error)) {
+      return false;
+    }
+    const candidate = error as CliStructuredError;
+    return (
+      candidate.name === 'CliStructuredError' &&
+      typeof candidate.code === 'string' &&
+      (candidate.domain === 'CLI' || candidate.domain === 'RTM') &&
+      typeof candidate.toEnvelope === 'function'
+    );
+  }
 }
 
 // ============================================================================
@@ -171,13 +190,15 @@ export function errorFileNotFound(
 }
 
 /**
- * Database URL is required but not provided.
+ * Database connection is required but not provided.
  */
-export function errorDatabaseUrlRequired(options?: { readonly why?: string }): CliStructuredError {
-  return new CliStructuredError('4005', 'Database URL is required', {
+export function errorDatabaseConnectionRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError {
+  return new CliStructuredError('4005', 'Database connection is required', {
     domain: 'CLI',
-    why: options?.why ?? 'Database URL is required for this command',
-    fix: 'Provide `--db <url>` or set `db: { url: "postgres://…" }` in prisma-next.config.ts',
+    why: options?.why ?? 'Database connection is required for this command',
+    fix: 'Provide `--db <url>` or set `db: { connection: "postgres://…" }` in prisma-next.config.ts',
   });
 }
 
@@ -316,16 +337,16 @@ export function errorConfigValidation(
     readonly why?: string;
   },
 ): CliStructuredError {
-  return new CliStructuredError('4001', 'Config file not found', {
+  return new CliStructuredError('4009', 'Config validation error', {
     domain: 'CLI',
     why: options?.why ?? `Config must have a "${field}" field`,
-    fix: "Run 'prisma-next init' to create a config file",
+    fix: 'Check your prisma-next.config.ts and ensure all required fields are provided',
     docsUrl: 'https://prisma-next.dev/docs/cli/config',
   });
 }
 
 // ============================================================================
-// Runtime Errors (PN-RTM-3000-3003)
+// Runtime Errors (PN-RTM-3000-3030)
 // ============================================================================
 
 /**
@@ -335,10 +356,10 @@ export function errorMarkerMissing(options?: {
   readonly why?: string;
   readonly dbUrl?: string;
 }): CliStructuredError {
-  return new CliStructuredError('3001', 'Marker missing', {
+  return new CliStructuredError('3001', 'Database not signed', {
     domain: 'RTM',
-    why: options?.why ?? 'Contract marker not found in database',
-    fix: 'Run `prisma-next db sign --db <url>` to create marker',
+    why: options?.why ?? 'No database signature (marker) found',
+    fix: 'Run `prisma-next db sign --db <url>` to sign the database',
   });
 }
 
@@ -385,6 +406,59 @@ export function errorTargetMismatch(
   });
 }
 
+/**
+ * Database marker is required but not found.
+ * Used by commands that require a pre-existing marker as a precondition.
+ */
+export function errorMarkerRequired(options?: {
+  readonly why?: string;
+  readonly fix?: string;
+}): CliStructuredError {
+  return new CliStructuredError('3010', 'Database must be signed first', {
+    domain: 'RTM',
+    why: options?.why ?? 'No database signature (marker) found',
+    fix: options?.fix ?? 'Run `prisma-next db init` first to sign the database',
+  });
+}
+
+/**
+ * Migration runner failed during execution.
+ */
+export function errorRunnerFailed(
+  summary: string,
+  options?: {
+    readonly why?: string;
+    readonly fix?: string;
+    readonly meta?: Record<string, unknown>;
+  },
+): CliStructuredError {
+  return new CliStructuredError('3020', summary, {
+    domain: 'RTM',
+    why: options?.why ?? 'Migration runner failed',
+    fix: options?.fix ?? 'Inspect the reported conflict and reconcile schema drift',
+    ...(options?.meta ? { meta: options.meta } : {}),
+  });
+}
+
+/**
+ * Destructive operations require explicit confirmation via --accept-data-loss.
+ */
+export function errorDestructiveChanges(
+  summary: string,
+  options?: {
+    readonly why?: string;
+    readonly fix?: string;
+    readonly meta?: Record<string, unknown>;
+  },
+): CliStructuredError {
+  return new CliStructuredError('3030', summary, {
+    domain: 'RTM',
+    why: options?.why ?? 'Planned operations include destructive changes that require confirmation',
+    fix: options?.fix ?? 'Use `--plan` to preview, then re-run with `--accept-data-loss`',
+    ...(options?.meta ? { meta: options.meta } : {}),
+  });
+}
+
 /**
  * Generic runtime error.
  */

package/src/exports/constants.ts

@@ -0,0 +1 @@
+export { EMPTY_CONTRACT_HASH } from '../constants';

package/src/exports/emission.ts

@@ -2,5 +2,5 @@
 
 export { canonicalizeContract } from '../emission/canonicalization';
 export { emit } from '../emission/emit';
-export { computeCoreHash, computeProfileHash } from '../emission/hashing';
+export { computeExecutionHash, computeProfileHash, computeStorageHash } from '../emission/hashing';
 export type { EmitOptions, EmitResult } from '../emission/types';

package/src/exports/errors.ts

@@ -6,15 +6,18 @@ export {
   errorContractConfigMissing,
   errorContractMissingExtensionPacks,
   errorContractValidationFailed,
-  errorDatabaseUrlRequired,
+  errorDatabaseConnectionRequired,
+  errorDestructiveChanges,
   errorDriverRequired,
   errorFamilyReadMarkerSqlRequired,
   errorFileNotFound,
   errorHashMismatch,
   errorJsonFormatNotSupported,
   errorMarkerMissing,
+  errorMarkerRequired,
   errorMigrationPlanningFailed,
   errorQueryRunnerFactoryRequired,
+  errorRunnerFailed,
   errorRuntime,
   errorTargetMigrationNotSupported,
   errorTargetMismatch,

package/src/exports/stack.ts

@@ -0,0 +1 @@
+export { createControlPlaneStack } from '../stack';

package/src/exports/types.ts

@@ -8,6 +8,7 @@ export type {
   ControlExtensionInstance,
   ControlFamilyDescriptor,
   ControlFamilyInstance,
+  ControlPlaneStack,
   ControlTargetDescriptor,
   ControlTargetInstance,
   EmitContractResult,

package/src/migrations.ts

@@ -10,6 +10,7 @@
  */
 
 import type { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
+import type { ContractIR } from '@prisma-next/contract/ir';
 import type { Result } from '@prisma-next/utils/result';
 import type { ControlDriverInstance, ControlFamilyInstance } from './types';
 
@@ -49,6 +50,10 @@ export interface MigrationPlanOperation {
   readonly operationClass: MigrationOperationClass;
 }
 
+// ============================================================================
+// Plan Types (Display-Oriented)
+// ============================================================================
+
 /**
  * A migration plan for display purposes.
  * Contains only the fields needed for CLI output (summary, JSON envelope).
@@ -56,9 +61,17 @@ export interface MigrationPlanOperation {
 export interface MigrationPlan {
   /** The target ID this plan is for (e.g., 'postgres'). */
   readonly targetId: string;
+  /**
+   * Origin contract identity that the plan expects the database to currently be at.
+   * If omitted or null, the runner skips origin validation entirely.
+   */
+  readonly origin?: {
+    readonly storageHash: string;
+    readonly profileHash?: string;
+  } | null;
   /** Destination contract identity that the plan intends to reach. */
   readonly destination: {
-    readonly coreHash: string;
+    readonly storageHash: string;
     readonly profileHash?: string;
   };
   /** Ordered list of operations to execute. */
@@ -244,4 +257,12 @@ export interface TargetMigrationsCapability<
 > {
   createPlanner(family: TFamilyInstance): MigrationPlanner<TFamilyId, TTargetId>;
   createRunner(family: TFamilyInstance): MigrationRunner<TFamilyId, TTargetId>;
+  /**
+   * Synthesizes a family-specific schema IR from a contract for offline planning.
+   * The returned schema can be passed to `planner.plan({ schema })` as the "from" state.
+   *
+   * @param contract - The contract to convert, or null for a new project (empty schema).
+   * @returns Family-specific schema IR (e.g., `SqlSchemaIR` for SQL targets).
+   */
+  contractToSchema(contract: ContractIR | null): unknown;
 }

package/src/stack.ts

@@ -0,0 +1,38 @@
+import type {
+  ControlAdapterDescriptor,
+  ControlDriverDescriptor,
+  ControlExtensionDescriptor,
+  ControlPlaneStack,
+  ControlTargetDescriptor,
+} from './types';
+
+/**
+ * Creates a ControlPlaneStack from component descriptors.
+ *
+ * Provides sensible defaults:
+ * - `driver` defaults to `undefined` (optional for commands that don't need DB connection)
+ * - `extensionPacks` defaults to `[]` (empty array)
+ *
+ * @example
+ * ```ts
+ * const stack = createControlPlaneStack({
+ *   target: postgresTarget,
+ *   adapter: postgresAdapter,
+ *   driver: postgresDriver, // optional
+ *   extensionPacks: [pgvector], // optional
+ * });
+ * ```
+ */
+export function createControlPlaneStack<TFamilyId extends string, TTargetId extends string>(input: {
+  readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;
+  readonly driver?: ControlDriverDescriptor<TFamilyId, TTargetId> | undefined;
+  readonly extensionPacks?: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[] | undefined;
+}): ControlPlaneStack<TFamilyId, TTargetId> {
+  return {
+    target: input.target,
+    adapter: input.adapter,
+    driver: input.driver,
+    extensionPacks: input.extensionPacks ?? [],
+  };
+}

package/src/types.ts

@@ -53,17 +53,17 @@ export interface ControlFamilyInstance<TFamilyId extends string, TSchemaIR = unk
    * Mappings are runtime-only and should not be part of ContractIR.
    *
    * Note: The returned ContractIR may include additional fields from the emitted contract
-   * (like coreHash, profileHash) that are not part of the ContractIR type but are preserved
+   * (like storageHash/executionHash, profileHash) that are not part of the ContractIR type but are preserved
    * for use by verify/sign operations.
    */
   validateContractIR(contractJson: unknown): ContractIR;
 
   /**
    * Verifies the database marker against the contract.
-   * Compares target, coreHash, and profileHash.
+   * Compares target, storageHash, and profileHash.
    *
    * @param options.contractIR - The validated contract (from validateContractIR). Must have
-   *   coreHash and target fields for verification. These fields are present in emitted
+   *   storageHash and target fields for verification. These fields are present in emitted
    *   contracts but not in the ContractIR type definition.
    */
   verify(options: {
@@ -236,6 +236,23 @@ export interface OperationContext {
 // Control*Descriptor Interfaces (ADR 151)
 // ============================================================================
 
+/**
+ * A bundle of control-plane component descriptors for a specific family and target.
+ *
+ * This struct groups the target, adapter, driver (optional), and extension packs
+ * needed to create a family instance and run CLI commands. Use `createControlPlaneStack()`
+ * to construct with sensible defaults.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface ControlPlaneStack<TFamilyId extends string, TTargetId extends string> {
+  readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;
+  readonly driver: ControlDriverDescriptor<TFamilyId, TTargetId> | undefined;
+  readonly extensionPacks: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[];
+}
+
 /**
  * Descriptor for a control-plane family (e.g., SQL).
  * Provides the family hook and factory method.
@@ -248,12 +265,7 @@ export interface ControlFamilyDescriptor<
   TFamilyInstance extends ControlFamilyInstance<TFamilyId> = ControlFamilyInstance<TFamilyId>,
 > extends FamilyDescriptor<TFamilyId> {
   readonly hook: TargetFamilyHook;
-  create<TTargetId extends string>(options: {
-    readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;
-    readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;
-    readonly driver: ControlDriverDescriptor<TFamilyId, TTargetId>;
-    readonly extensionPacks: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[];
-  }): TFamilyInstance;
+  create<TTargetId extends string>(stack: ControlPlaneStack<TFamilyId, TTargetId>): TFamilyInstance;
 }
 
 /**
@@ -304,9 +316,14 @@ export interface ControlAdapterDescriptor<
 /**
  * Descriptor for a control-plane driver component (e.g., Postgres driver).
  *
+ * The connection input type is driver-specific. For example:
+ * - Postgres uses a connection string (URL)
+ * - Other drivers may accept structured objects (e.g., file paths, credentials)
+ *
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
  * @template TDriverInstance - The driver instance type
+ * @template TConnection - The connection input type (defaults to `string` for URL-based drivers)
  */
 export interface ControlDriverDescriptor<
   TFamilyId extends string,
@@ -315,8 +332,9 @@ export interface ControlDriverDescriptor<
     TFamilyId,
     TTargetId
   >,
+  TConnection = string,
 > extends DriverDescriptor<TFamilyId, TTargetId> {
-  create(url: string): Promise<TDriverInstance>;
+  create(connection: TConnection): Promise<TDriverInstance>;
 }
 
 /**
@@ -345,11 +363,11 @@ export interface VerifyDatabaseResult {
   readonly code?: string;
   readonly summary: string;
   readonly contract: {
-    readonly coreHash: string;
+    readonly storageHash: string;
     readonly profileHash?: string;
   };
   readonly marker?: {
-    readonly coreHash?: string;
+    readonly storageHash?: string;
     readonly profileHash?: string;
   };
   readonly target: {
@@ -381,15 +399,20 @@ export interface SchemaIssue {
     | 'extra_unique_constraint'
     | 'extra_index'
     | 'type_mismatch'
+    | 'type_missing'
+    | 'type_values_mismatch'
     | 'nullability_mismatch'
     | 'primary_key_mismatch'
     | 'foreign_key_mismatch'
     | 'unique_constraint_mismatch'
     | 'index_mismatch'
-    | 'extension_missing';
+    | 'extension_missing'
+    | 'default_missing'
+    | 'default_mismatch';
   readonly table: string;
   readonly column?: string;
   readonly indexOrConstraint?: string;
+  readonly typeName?: string;
   readonly expected?: string;
   readonly actual?: string;
   readonly message: string;
@@ -419,7 +442,7 @@ export interface VerifyDatabaseSchemaResult {
   readonly code?: string;
   readonly summary: string;
   readonly contract: {
-    readonly coreHash: string;
+    readonly storageHash: string;
     readonly profileHash?: string;
   };
   readonly target: {
@@ -452,7 +475,8 @@ export interface VerifyDatabaseSchemaResult {
 export interface EmitContractResult {
   readonly contractJson: string;
   readonly contractDts: string;
-  readonly coreHash: string;
+  readonly storageHash: string;
+  readonly executionHash?: string;
   readonly profileHash: string;
 }
 
@@ -487,7 +511,7 @@ export interface SignDatabaseResult {
   readonly ok: boolean;
   readonly summary: string;
   readonly contract: {
-    readonly coreHash: string;
+    readonly storageHash: string;
     readonly profileHash?: string;
   };
   readonly target: {
@@ -498,7 +522,7 @@ export interface SignDatabaseResult {
     readonly created: boolean;
     readonly updated: boolean;
     readonly previous?: {
-      readonly coreHash?: string;
+      readonly storageHash?: string;
       readonly profileHash?: string;
     };
   };

package/dist/chunk-U5RYT6PT.js

@@ -1,229 +0,0 @@
-// src/errors.ts
-var CliStructuredError = class extends Error {
-  code;
-  domain;
-  severity;
-  why;
-  fix;
-  where;
-  meta;
-  docsUrl;
-  constructor(code, summary, options) {
-    super(summary);
-    this.name = "CliStructuredError";
-    this.code = code;
-    this.domain = options?.domain ?? "CLI";
-    this.severity = options?.severity ?? "error";
-    this.why = options?.why;
-    this.fix = options?.fix;
-    this.where = options?.where ? {
-      path: options.where.path,
-      line: options.where.line
-    } : void 0;
-    this.meta = options?.meta;
-    this.docsUrl = options?.docsUrl;
-  }
-  /**
-   * Converts this error to a CLI error envelope for output formatting.
-   */
-  toEnvelope() {
-    const codePrefix = this.domain === "CLI" ? "PN-CLI-" : "PN-RTM-";
-    return {
-      code: `${codePrefix}${this.code}`,
-      domain: this.domain,
-      severity: this.severity,
-      summary: this.message,
-      why: this.why,
-      fix: this.fix,
-      where: this.where,
-      meta: this.meta,
-      docsUrl: this.docsUrl
-    };
-  }
-};
-function errorConfigFileNotFound(configPath, options) {
-  return new CliStructuredError("4001", "Config file not found", {
-    domain: "CLI",
-    ...options?.why ? { why: options.why } : { why: "Config file not found" },
-    fix: "Run 'prisma-next init' to create a config file",
-    docsUrl: "https://prisma-next.dev/docs/cli/config",
-    ...configPath ? { where: { path: configPath } } : {}
-  });
-}
-function errorContractConfigMissing(options) {
-  return new CliStructuredError("4002", "Contract configuration missing", {
-    domain: "CLI",
-    why: options?.why ?? "The contract configuration is required for emit",
-    fix: "Add contract configuration to your prisma-next.config.ts",
-    docsUrl: "https://prisma-next.dev/docs/cli/contract-emit"
-  });
-}
-function errorContractValidationFailed(reason, options) {
-  return new CliStructuredError("4003", "Contract validation failed", {
-    domain: "CLI",
-    why: reason,
-    fix: "Re-run `prisma-next contract emit`, or fix the contract file and try again",
-    docsUrl: "https://prisma-next.dev/docs/contracts",
-    ...options?.where ? { where: options.where } : {}
-  });
-}
-function errorFileNotFound(filePath, options) {
-  return new CliStructuredError("4004", "File not found", {
-    domain: "CLI",
-    why: options?.why ?? `File not found: ${filePath}`,
-    fix: options?.fix ?? "Check that the file path is correct",
-    where: { path: filePath },
-    ...options?.docsUrl ? { docsUrl: options.docsUrl } : {}
-  });
-}
-function errorDatabaseUrlRequired(options) {
-  return new CliStructuredError("4005", "Database URL is required", {
-    domain: "CLI",
-    why: options?.why ?? "Database URL is required for this command",
-    fix: 'Provide `--db <url>` or set `db: { url: "postgres://\u2026" }` in prisma-next.config.ts'
-  });
-}
-function errorQueryRunnerFactoryRequired(options) {
-  return new CliStructuredError("4006", "Query runner factory is required", {
-    domain: "CLI",
-    why: options?.why ?? "Config.db.queryRunnerFactory is required for db verify",
-    fix: "Add db.queryRunnerFactory to prisma-next.config.ts",
-    docsUrl: "https://prisma-next.dev/docs/cli/db-verify"
-  });
-}
-function errorFamilyReadMarkerSqlRequired(options) {
-  return new CliStructuredError("4007", "Family readMarker() is required", {
-    domain: "CLI",
-    why: options?.why ?? "Family verify.readMarker is required for db verify",
-    fix: "Ensure family.verify.readMarker() is exported by your family package",
-    docsUrl: "https://prisma-next.dev/docs/cli/db-verify"
-  });
-}
-function errorJsonFormatNotSupported(options) {
-  return new CliStructuredError("4008", "Unsupported JSON format", {
-    domain: "CLI",
-    why: `The ${options.command} command does not support --json ${options.format}`,
-    fix: `Use --json ${options.supportedFormats.join(" or ")}, or omit --json for human output`,
-    meta: {
-      command: options.command,
-      format: options.format,
-      supportedFormats: options.supportedFormats
-    }
-  });
-}
-function errorDriverRequired(options) {
-  return new CliStructuredError("4010", "Driver is required for DB-connected commands", {
-    domain: "CLI",
-    why: options?.why ?? "Config.driver is required for DB-connected commands",
-    fix: "Add a control-plane driver to prisma-next.config.ts (e.g. import a driver descriptor and set `driver: postgresDriver`)",
-    docsUrl: "https://prisma-next.dev/docs/cli/config"
-  });
-}
-function errorContractMissingExtensionPacks(options) {
-  const missing = [...options.missingExtensionPacks].sort();
-  return new CliStructuredError("4011", "Missing extension packs in config", {
-    domain: "CLI",
-    why: missing.length === 1 ? `Contract requires extension pack '${missing[0]}', but CLI config does not provide a matching descriptor.` : `Contract requires extension packs ${missing.map((p) => `'${p}'`).join(", ")}, but CLI config does not provide matching descriptors.`,
-    fix: "Add the missing extension descriptors to `extensions` in prisma-next.config.ts",
-    docsUrl: "https://prisma-next.dev/docs/cli/config",
-    meta: {
-      missingExtensionPacks: missing,
-      providedComponentIds: [...options.providedComponentIds].sort()
-    }
-  });
-}
-function errorMigrationPlanningFailed(options) {
-  const conflictSummaries = options.conflicts.map((c) => c.summary);
-  const computedWhy = options.why ?? conflictSummaries.join("\n");
-  const conflictFixes = options.conflicts.map((c) => c.why).filter((why) => typeof why === "string");
-  const computedFix = conflictFixes.length > 0 ? conflictFixes.join("\n") : "Use `db schema-verify` to inspect conflicts, or ensure the database is empty";
-  return new CliStructuredError("4020", "Migration planning failed", {
-    domain: "CLI",
-    why: computedWhy,
-    fix: computedFix,
-    meta: { conflicts: options.conflicts },
-    docsUrl: "https://prisma-next.dev/docs/cli/db-init"
-  });
-}
-function errorTargetMigrationNotSupported(options) {
-  return new CliStructuredError("4021", "Target does not support migrations", {
-    domain: "CLI",
-    why: options?.why ?? "The configured target does not provide migration planner/runner",
-    fix: "Select a target that provides migrations (it must export `target.migrations` for db init)",
-    docsUrl: "https://prisma-next.dev/docs/cli/db-init"
-  });
-}
-function errorConfigValidation(field, options) {
-  return new CliStructuredError("4001", "Config file not found", {
-    domain: "CLI",
-    why: options?.why ?? `Config must have a "${field}" field`,
-    fix: "Run 'prisma-next init' to create a config file",
-    docsUrl: "https://prisma-next.dev/docs/cli/config"
-  });
-}
-function errorMarkerMissing(options) {
-  return new CliStructuredError("3001", "Marker missing", {
-    domain: "RTM",
-    why: options?.why ?? "Contract marker not found in database",
-    fix: "Run `prisma-next db sign --db <url>` to create marker"
-  });
-}
-function errorHashMismatch(options) {
-  return new CliStructuredError("3002", "Hash mismatch", {
-    domain: "RTM",
-    why: options?.why ?? "Contract hash does not match database marker",
-    fix: "Migrate database or re-sign if intentional",
-    ...options?.expected || options?.actual ? {
-      meta: {
-        ...options.expected ? { expected: options.expected } : {},
-        ...options.actual ? { actual: options.actual } : {}
-      }
-    } : {}
-  });
-}
-function errorTargetMismatch(expected, actual, options) {
-  return new CliStructuredError("3003", "Target mismatch", {
-    domain: "RTM",
-    why: options?.why ?? `Contract target does not match config target (expected: ${expected}, actual: ${actual})`,
-    fix: "Align contract target and config target",
-    meta: { expected, actual }
-  });
-}
-function errorRuntime(summary, options) {
-  return new CliStructuredError("3000", summary, {
-    domain: "RTM",
-    ...options?.why ? { why: options.why } : { why: "Verification failed" },
-    ...options?.fix ? { fix: options.fix } : { fix: "Check contract and database state" },
-    ...options?.meta ? { meta: options.meta } : {}
-  });
-}
-function errorUnexpected(message, options) {
-  return new CliStructuredError("4999", "Unexpected error", {
-    domain: "CLI",
-    why: options?.why ?? message,
-    fix: options?.fix ?? "Check the error message and try again"
-  });
-}
-
-export {
-  CliStructuredError,
-  errorConfigFileNotFound,
-  errorContractConfigMissing,
-  errorContractValidationFailed,
-  errorFileNotFound,
-  errorDatabaseUrlRequired,
-  errorQueryRunnerFactoryRequired,
-  errorFamilyReadMarkerSqlRequired,
-  errorJsonFormatNotSupported,
-  errorDriverRequired,
-  errorContractMissingExtensionPacks,
-  errorMigrationPlanningFailed,
-  errorTargetMigrationNotSupported,
-  errorConfigValidation,
-  errorMarkerMissing,
-  errorHashMismatch,
-  errorTargetMismatch,
-  errorRuntime,
-  errorUnexpected
-};
-//# sourceMappingURL=chunk-U5RYT6PT.js.map