@tailor-platform/sdk 1.83.0 → 1.85.0

package/dist/cli/commands/deploy/tailordb/index.d.mts

@@ -4,5 +4,7 @@ import "../../../../tailor-proto/src/tailor/v1/tailordb_pb.mjs";
 import "../../../../tailor-proto/src/tailor/v1/metadata_pb.mjs";
 import "../../../shared/client.mjs";
 import "../types.mjs";
+import "../../tailordb/migrate/config.mjs";
 import "../../tailordb/migrate/snapshot.mjs";
+import "../../tailordb/migrate/schema-checks.mjs";
 import "@bufbuild/protobuf";

package/dist/cli/commands/generate/seed/bundler.d.mts

@@ -19,8 +19,9 @@ type SeedBundleResult = {
  * 4. Exports as main() for TestExecScript
  * @param namespace - TailorDB namespace
  * @param typeNames - List of type names to include in the seed
+ * @param baseDir - Directory whose dependencies and tsconfig the generated entry uses
  * @returns Bundled seed script result
  */
-declare function bundleSeedScript(namespace: string, typeNames: string[]): Promise<SeedBundleResult>;
+declare function bundleSeedScript(namespace: string, typeNames: string[], baseDir?: string): Promise<SeedBundleResult>;
 //#endregion
 export { SeedBundleResult, bundleSeedScript };

package/dist/cli/commands/generate/service.d.mts

@@ -3,7 +3,7 @@ import "../../../plugin/types.mjs";
 import "../../../plugin/manager.mjs";
 import "../../shared/config-loader.mjs";
 import "../../services/application.mjs";
-import { CodeGenerator } from "./types.mjs";
+import "./types.mjs";
 import { GenerateOptions } from "./options.mjs";
 //#region src/cli/commands/generate/service.d.ts
 /**

package/dist/cli/commands/generate/types.d.mts

@@ -1,6 +1,6 @@
 import { PluginAttachment } from "../../../configure/services/tailordb/types.mjs";
 import { IdProvider, OAuth2Client } from "../../../types/auth.generated.mjs";
-import { PluginGeneratedTypeSource, TailorDBType, TypeSourceInfoEntry, UserDefinedTypeSource } from "../../../parser/service/tailordb/types.mjs";
+import { TailorDBType, TypeSourceInfoEntry } from "../../../parser/service/tailordb/types.mjs";
 import { Executor } from "../../../types/executor.generated.mjs";
 import { Resolver } from "../../../types/resolver.generated.mjs";
 import "../../../plugin/types.mjs";

package/dist/cli/commands/tailordb/migrate/diff-calculator.d.mts

@@ -174,6 +174,16 @@ interface MigrationDiff {
   warnings: WarningChangeInfo[];
   /** Whether a migration script is required to handle data migration */
   requiresMigrationScript: boolean;
+  /** Explicit acknowledgment that this migration needs no script despite breaking changes */
+  scriptSkipped?: ScriptSkippedInfo;
+}
+/**
+ * Acknowledgment that a migration requiring a script intentionally has none.
+ * Recorded by `tailordb migration script <n> --no-script --reason "..."`.
+ */
+interface ScriptSkippedInfo {
+  reason: string;
+  acknowledgedAt: string;
 }
 /**
  * Breaking change information in migration diff
@@ -219,4 +229,4 @@ declare function formatMigrationDiff(diff: MigrationDiff): string;
  */
 declare function formatDiffSummary(diff: MigrationDiff): string;
 //#endregion
-export { BreakingChangeInfo, DiffChange, FieldAddedChange, FieldModifiedChange, FieldRemovedChange, FileAddedChange, FileModifiedChange, FileRemovedChange, IndexAddedChange, IndexModifiedChange, IndexRemovedChange, MigrationDiff, PermissionModifiedChange, RelationshipAddedChange, RelationshipModifiedChange, RelationshipRemovedChange, SnapshotPermissionState, SnapshotTypeSettingsState, TypeAddedChange, TypeModifiedChange, TypeRemovedChange, TypeSettingsModifiedChange, TypeSettingsPatch, WarningChangeInfo, formatDiffSummary, formatMigrationDiff, hasChanges };
+export { BreakingChangeInfo, DiffChange, FieldAddedChange, FieldModifiedChange, FieldRemovedChange, FileAddedChange, FileModifiedChange, FileRemovedChange, IndexAddedChange, IndexModifiedChange, IndexRemovedChange, MigrationDiff, PermissionModifiedChange, RelationshipAddedChange, RelationshipModifiedChange, RelationshipRemovedChange, ScriptSkippedInfo, SnapshotPermissionState, SnapshotTypeSettingsState, TypeAddedChange, TypeModifiedChange, TypeRemovedChange, TypeSettingsModifiedChange, TypeSettingsPatch, WarningChangeInfo, formatDiffSummary, formatMigrationDiff, hasChanges };

package/dist/cli/commands/tailordb/migrate/schema-checks.d.mts

@@ -0,0 +1,5 @@
+import "../../../services/tailordb/service.mjs";
+import "../../../shared/config-loader.mjs";
+import "../../../shared/client.mjs";
+import "./config.mjs";
+import "./snapshot.mjs";

package/dist/cli/commands/tailordb/migrate/snapshot.d.mts

@@ -1,6 +1,6 @@
 import { TailorDBType } from "../../../../parser/service/tailordb/types.mjs";
 import "../../../../tailor-proto/src/tailor/v1/tailordb_resource_pb.mjs";
-import { NormalizedSchemaSnapshot, SchemaSnapshot, SnapshotActionPermission, SnapshotEnumValue, SnapshotFieldConfig, SnapshotFieldRefOperand, SnapshotGqlAction, SnapshotGqlPermission, SnapshotGqlPermissionPolicy, SnapshotHook, SnapshotIndexConfig, SnapshotPermissionCondition, SnapshotPermissionOperand, SnapshotPermissionOperator, SnapshotRecordPermission, SnapshotRelationship, SnapshotSerial, SnapshotValidation, SnapshotValueOperand, TailorDBSnapshotType } from "./snapshot-types.mjs";
+import { NormalizedSchemaSnapshot, SchemaSnapshot, SnapshotActionPermission, SnapshotEnumValue, SnapshotFieldConfig, SnapshotGqlPermission, SnapshotGqlPermissionPolicy, SnapshotIndexConfig, SnapshotPermissionCondition, SnapshotPermissionOperand, SnapshotRecordPermission, SnapshotRelationship, TailorDBSnapshotType } from "./snapshot-types.mjs";
 import { MigrationDiff } from "./diff-calculator.mjs";
 //#region src/cli/commands/tailordb/migrate/snapshot.d.ts
 /**

package/dist/cli/index.mjs

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import { r as parseInputFields } from "../schema-CYrle8JZ.mjs";
-import { At as PATScope, Ct as AuthInvokerSchema, E as CustomDomainStatus, W as FunctionExecution_Type } from "../workspace_resource_pb-UGK1SSn_.mjs";
+import { At as PATScope, Ct as AuthInvokerSchema, E as CustomDomainStatus, W as FunctionExecution_Type } from "../workspace_resource_pb-DXnO2AT-.mjs";
 import { t as assertDefined } from "../assert-DBxo8jPo.mjs";
 import { n as logger, r as styles } from "../logger-CXQq9YIp.mjs";
-import { $n as deploymentArgs, $t as handleOptionalToRequiredError, An as generateUserTypes, At as startCommand, Bn as loadConsoleBaseUrl, Ct as listCommand$7, Dn as resourceTrn, Dt as jobsCommand, E as listCommand$13, En as getNamespacesWithMigrations, F as openInConfiguredEditor, Fn as deleteUserTokens, G as treeCommand, Gn as readPlatformConfig, H as updateCommand$3, Hn as loadStoredUserTokens, Ht as listCommand$16, In as fetchLatestToken, J as getCommand$5, Jn as writePlatformConfig, Jt as ensureConfigId, K as listCommand$12, Kn as resolveUserTokenKey, Kt as formatKeyValueTable, L as showCommand, Ln as hasAnyUserTokenEntry, Lt as functionExecutionStatusToString, M as generateMigrationScript, Mn as apiCall, Mt as getCommand$6, N as writeDbTypesFile, Nn as assertWritable, On as sdkNameLabelKey, P as getConfiguredEditorCommand, Pn as loadConfig, Pt as executionsCommand, Q as listCommand$11, Qn as confirmationArgs, Qt as MIGRATION_LABEL_KEY, R as extractOwnedNamespaces, Rn as hasUserTokenEntry, Rt as getCommand$1, S as waitCommand, Sn as parseMigrationNumberArg, Tn as hasChanges, Un as loadWorkspaceId, V as removeCommand$1, Vn as loadMachineUserName, Vt as deployFromCLI, Wn as platformConfigFromProfile, Wt as createCommand$4, X as updateCommand$2, Xn as commonArgs, Yn as defineAppCommand, Yt as executeScript, Zn as configArg, _t as getCommand$2, ar as toPageDirection, bn as reconstructSnapshotFromMigrations, bt as webhookCommand, c as listCommand$15, ct as getCommand$3, dt as tokenCommand, en as parseMigrationLabelNumber, er as isVerbose, et as getCommand$4, f as restoreCommand, fn as createSnapshotFromLocalTypes, ft as listCommand$9, g as deleteCommand$5, gn as getMigrationFiles, hn as getMigrationFilePath, ht as listCommand$8, i as updateCommand$4, ir as resolveMachineUserInputSource, it as createCommand$3, j as generateCommand$1, jn as prompt, k as truncateCommand, kn as PluginManager, ln as assertValidMigrationFiles, m as getCommand$7, mt as generate, nn as generateAllTypeManifestsFromSnapshot, nr as pagedLogArgs, nt as deleteCommand$4, o as removeCommand, on as INITIAL_SCHEMA_NUMBER, or as workspaceArgs, ot as listCommand$10, pn as getLatestMigrationNumber, qn as saveUserTokens, qt as workspaceNameSchema, r as queryCommand, rn as protoGqlPermission, rr as paginationArgs, t as registerTypeScriptRuntime, tn as compareSnapshotWithRemote, tr as multiConfigArg, u as inviteCommand, un as compareLocalTypesWithSnapshot, vn as isValidMigrationNumber, w as resumeCommand, wn as formatMigrationDiff, x as healthCommand, xn as formatMigrationNumber, xt as triggerCommand, y as listCommand$14, yn as loadDiff, z as logBetaWarning, zn as loadAccessToken } from "../register-typescript-runtime-CCHyKeXO.mjs";
-import { A as defaultPlatformBaseUrl, D as hashContent$1, E as getDistDir, F as fetchPlatformMachineUserToken, H as initOperatorClient, I as fetchUserInfo, M as fetchAllTolerant, P as fetchPaged, S as resolveBundleLogLevel, U as isDefaultPlatform, V as initOAuth2Client, a as resolveInlineSourcemap, b as composeFunctionTreeshakeOptions, c as ResolverSchema, j as fetchAll, k as closeConnectionPool, p as buildResolverPermissionAndInputCheckExpr, s as WorkflowJobSchema, t as defineApplication, u as INVOKER_EXPR, v as resolveTSConfigWithFallback, x as createLogLevelTreeshakeOptions, y as platformBundleDefinePlugin, z as getOrNull } from "../application-Cp0FxIm2.mjs";
-import { n as ExecutorSchema } from "../service-B0MaodSg.mjs";
+import { $n as writePlatformConfig, $t as logRemoteDriftGuidance, An as hasChanges, At as startCommand, Bn as deleteUserTokens, Cn as isValidMigrationNumber, Ct as listCommand$7, Dn as parseMigrationNumberArg, Dt as jobsCommand, E as listCommand$13, En as formatMigrationNumber, F as openInConfiguredEditor, Fn as generateUserTypes, G as treeCommand, Gn as loadConsoleBaseUrl, H as updateCommand$3, Hn as hasAnyUserTokenEntry, Ht as listCommand$16, In as prompt, J as getCommand$5, Jn as loadWorkspaceId, Jt as ensureConfigId, K as listCommand$12, Kn as loadMachineUserName, Kt as formatKeyValueTable, L as showCommand, Ln as apiCall, Lt as functionExecutionStatusToString, M as generateMigrationScript, Mn as resourceTrn, Mt as getCommand$6, N as writeDbTypesFile, Nn as sdkNameLabelKey, On as formatDiffSummary, P as getConfiguredEditorCommand, Pn as PluginManager, Pt as executionsCommand, Q as listCommand$11, Qn as saveUserTokens, Qt as checkMigrationDiffs, R as extractOwnedNamespaces, Rn as assertWritable, Rt as getCommand$1, S as waitCommand, Tn as reconstructSnapshotFromMigrations, Un as hasUserTokenEntry, V as removeCommand$1, Vn as fetchLatestToken, Vt as deployFromCLI, Wn as loadAccessToken, Wt as createCommand$4, X as updateCommand$2, Xn as readPlatformConfig, Yn as platformConfigFromProfile, Yt as executeScript, Zn as resolveUserTokenKey, _n as formatSchemaDrifts, _t as getCommand$2, an as compareSnapshotWithRemote, ar as isVerbose, bn as getMigrationFilePath, bt as webhookCommand, c as listCommand$15, cr as paginationArgs, ct as getCommand$3, dr as workspaceArgs, dt as tokenCommand, en as toTailorDBDeployInput, er as defineAppCommand, et as getCommand$4, f as restoreCommand, ft as listCommand$9, g as deleteCommand$5, gn as createSnapshotFromLocalTypes, ht as listCommand$8, i as updateCommand$4, in as parseMigrationLabelNumber, ir as deploymentArgs, it as createCommand$3, j as generateCommand$1, jn as getNamespacesWithMigrations, k as truncateCommand, kn as formatMigrationDiff, lr as resolveMachineUserInputSource, m as getCommand$7, mn as compareLocalTypesWithSnapshot, mt as generate, nn as MIGRATION_LABEL_KEY, nr as configArg, nt as deleteCommand$4, o as removeCommand, on as generateAllTypeManifestsFromSnapshot, or as multiConfigArg, ot as listCommand$10, pn as assertValidMigrationFiles, qn as loadStoredUserTokens, qt as workspaceNameSchema, r as queryCommand, rn as handleOptionalToRequiredError, rr as confirmationArgs, sn as protoGqlPermission, sr as pagedLogArgs, t as registerTypeScriptRuntime, tn as verifyRemoteSchema, tr as commonArgs, u as inviteCommand, un as INITIAL_SCHEMA_NUMBER, ur as toPageDirection, vn as getLatestMigrationNumber, w as resumeCommand, wn as loadDiff, x as healthCommand, xn as getMigrationFiles, xt as triggerCommand, y as listCommand$14, z as logBetaWarning, zn as loadConfig } from "../register-typescript-runtime-nG-n9lPw.mjs";
+import { A as hashContent$1, C as createLogLevelTreeshakeOptions, F as fetchAllTolerant, G as initOperatorClient, H as getOrNull, K as isDefaultPlatform, L as fetchPaged, M as closeConnectionPool, N as defaultPlatformBaseUrl, P as fetchAll, R as fetchPlatformMachineUserToken, S as composeFunctionTreeshakeOptions, T as createBundleLog, W as initOAuth2Client, a as resolveInlineSourcemap, b as resolveTSConfigWithFallback, c as ResolverSchema, k as getDistDir, m as assertUniqueLocalTailorDBTypeNames, p as buildResolverPermissionAndInputCheckExpr, s as WorkflowJobSchema, t as defineApplication, u as INVOKER_EXPR, v as createGeneratedEntryResolverPlugin, w as resolveBundleLogLevel, x as platformBundleDefinePlugin, y as createTsconfigPathsPlugin, z as fetchUserInfo } from "../application-m5tYtz0-.mjs";
+import { n as ExecutorSchema } from "../service-CPJWhTLn.mjs";
 import { t as multiline } from "../multiline-sfHpTZZK.mjs";
 import { t as isPluginGeneratedType } from "../type-source-DH_LH20p.mjs";
 import { t as readPackageJson } from "../package-json-8b0O9TlX.mjs";
 import { t as userAgent } from "../user-agent-DX2Jnw0-.mjs";
 import { n as errorToJson, r as isCLIError, t as createCLIError } from "../errors-DVFS0AZk.mjs";
-import { t as OperatorService } from "../service_pb-BwZRiNug.mjs";
+import { t as OperatorService } from "../service_pb-D5--My_M.mjs";
 import { a as JSON_FOOTER_MARKER, i as CRASH_LOG_EXTENSION, o as parseCrashReportConfig, r as sendCrashReport, t as initCrashReporting } from "../crashreport-DMYuHnBN.mjs";
 import { arg, defineCommand, runCommand, runMain } from "politty";
 import { withCompletionCommand } from "politty/completion";
@@ -1706,22 +1706,29 @@ async function bundleForTestRun(options) {
 	const entryContent = generateEntry(detected, sourceFile, env, machineUser, workspaceId);
 	fs$1.writeFileSync(entryPath, entryContent);
 	const tsconfig = await resolveTSConfigWithFallback(baseDir);
+	const bundleLog = createBundleLog({ tsconfig });
+	const buildResult = await rolldown.build({
+		plugins: [
+			createGeneratedEntryResolverPlugin(entryPath, baseDir),
+			createTsconfigPathsPlugin(),
+			platformBundleDefinePlugin
+		],
+		input: entryPath,
+		write: false,
+		output: {
+			format: "esm",
+			sourcemap: inlineSourcemap ? "inline" : true,
+			minify: inlineSourcemap ? { mangle: { keepNames: true } } : true,
+			codeSplitting: false,
+			dir: process.cwd()
+		},
+		tsconfig,
+		treeshake: composeFunctionTreeshakeOptions([createLogLevelTreeshakeOptions(bundleLogLevel)]),
+		...bundleLog.options
+	});
+	bundleLog.assertAllResolved();
 	return {
-		bundledCode: (await rolldown.build({
-			plugins: [platformBundleDefinePlugin],
-			input: entryPath,
-			write: false,
-			output: {
-				format: "esm",
-				sourcemap: inlineSourcemap ? "inline" : true,
-				minify: inlineSourcemap ? { mangle: { keepNames: true } } : true,
-				codeSplitting: false,
-				dir: process.cwd()
-			},
-			tsconfig,
-			treeshake: composeFunctionTreeshakeOptions([createLogLevelTreeshakeOptions(bundleLogLevel)]),
-			logLevel: "silent"
-		})).output[0].code,
+		bundledCode: buildResult.output[0].code,
 		scriptName
 	};
 }
@@ -6469,6 +6476,42 @@ const erdCommand = defineCommand({
 * automatically require one.
 */
 /**
+* Record in diff.json that a migration requiring a script intentionally has none.
+* @param {MarkScriptSkippedOptions} options - Target migration and skip reason
+* @returns {ScriptSkippedInfo} The recorded acknowledgment
+*/
+function markMigrationScriptSkipped(options) {
+	const { migrationsDir, migrationNumber, reason } = options;
+	const label = formatMigrationNumber(migrationNumber);
+	const normalizedReason = reason.trim();
+	if (!normalizedReason) throw new Error("Migration script skip reason must not be empty.");
+	const diffPath = getMigrationFilePath(migrationsDir, migrationNumber, "diff");
+	if (!fs$1.existsSync(diffPath)) throw new Error(`Migration ${label} not found in ${migrationsDir}. Expected ${diffPath}.`);
+	const diff = loadDiff(diffPath);
+	if (!diff.requiresMigrationScript) throw new Error(`Migration ${label} does not require a migration script; nothing to skip.`);
+	if (diff.scriptSkipped) throw new Error(`Migration ${label} already has a script skip recorded (${diff.scriptSkipped.acknowledgedAt}: ${diff.scriptSkipped.reason}).`);
+	const migratePath = getMigrationFilePath(migrationsDir, migrationNumber, "migrate");
+	if (fs$1.existsSync(migratePath)) throw new Error(`Migration script exists at ${migratePath}. Delete migrate.ts first if this migration should run without a script.`);
+	const scriptSkipped = {
+		reason: normalizedReason,
+		acknowledgedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	const raw = JSON.parse(fs$1.readFileSync(diffPath, "utf-8"));
+	raw.scriptSkipped = scriptSkipped;
+	fs$1.writeFileSync(diffPath, JSON.stringify(raw, null, 2));
+	return scriptSkipped;
+}
+/**
+* Remove a script skip acknowledgment after a real migration script is created.
+* @param diffPath - Migration diff file to update
+*/
+function clearMigrationScriptSkipped(diffPath) {
+	const raw = JSON.parse(fs$1.readFileSync(diffPath, "utf-8"));
+	if (!Object.hasOwn(raw, "scriptSkipped")) return;
+	delete raw.scriptSkipped;
+	fs$1.writeFileSync(diffPath, JSON.stringify(raw, null, 2));
+}
+/**
 * Add a migrate.ts template to an existing migration directory.
 * @param {ScriptOptions} options - Command options
 */
@@ -6481,6 +6524,20 @@ async function script(options) {
 	if (namespacesWithMigrations.length === 0) throw new Error("No TailorDB services with migrations configuration found");
 	const targetNamespace = resolveTargetNamespace(namespacesWithMigrations, options.namespace);
 	const { migrationsDir } = assertDefined(namespacesWithMigrations.find((ns) => ns.namespace === targetNamespace), "namespace with migrations not found");
+	if (options.noScript) {
+		const reason = options.reason?.trim();
+		if (!reason) throw new Error("--reason is required with --no-script.");
+		const scriptSkipped = markMigrationScriptSkipped({
+			migrationsDir,
+			migrationNumber,
+			reason
+		});
+		logger.success(`Recorded that migration ${styles.bold(options.number)} in namespace ${styles.bold(targetNamespace)} intentionally has no migration script`);
+		logger.info(`  Reason: ${scriptSkipped.reason}`);
+		logger.info(`  Diff file: ${getMigrationFilePath(migrationsDir, migrationNumber, "diff")}`);
+		return;
+	}
+	if (options.reason !== void 0) throw new Error("--reason can only be used together with --no-script.");
 	const diffPath = getMigrationFilePath(migrationsDir, migrationNumber, "diff");
 	if (!fs$1.existsSync(diffPath)) throw new Error(`Migration ${options.number} not found in ${migrationsDir}. Expected ${diffPath}.`);
 	const migratePath = getMigrationFilePath(migrationsDir, migrationNumber, "migrate");
@@ -6491,6 +6548,7 @@ async function script(options) {
 	const scriptContent = generateMigrationScript(diff);
 	await fsPromises.writeFile(migratePath, scriptContent);
 	await writeDbTypesFile(previousSnapshot, migrationsDir, migrationNumber, diff);
+	clearMigrationScriptSkipped(diffPath);
 	logger.success(`Added migration script for migration ${styles.bold(options.number)} in namespace ${styles.bold(targetNamespace)}`);
 	logger.info(`  Migration script: ${migratePath}`);
 	logger.info(`  DB types: ${getMigrationFilePath(migrationsDir, migrationNumber, "db")}`);
@@ -6520,7 +6578,7 @@ function resolveTargetNamespace(namespacesWithMigrations, requested) {
 }
 const scriptCommand = defineAppCommand({
 	name: "script",
-	description: "Add a migration script (migrate.ts) template to an existing migration directory.",
+	description: "Add a migration script (migrate.ts) template to an existing migration directory, or record with --no-script that a migration intentionally has none.",
 	args: z.object({
 		...configArg,
 		number: arg(z.string(), {
@@ -6530,13 +6588,17 @@ const scriptCommand = defineAppCommand({
 		namespace: arg(z.string().optional(), {
 			alias: "n",
 			description: "Target TailorDB namespace (required if multiple namespaces exist)"
-		})
+		}),
+		"no-script": arg(z.boolean().optional(), { description: "Record that this migration intentionally runs without a migration script (requires --reason)" }),
+		reason: arg(z.string().optional(), { description: "Reason why no migration script is needed (used with --no-script)" })
 	}).strict(),
 	run: async (args) => {
 		await script({
 			configPath: args.config,
 			number: args.number,
-			namespace: args.namespace
+			namespace: args.namespace,
+			noScript: args["no-script"],
+			reason: args.reason
 		});
 	}
 });
@@ -6575,7 +6637,7 @@ async function set(options) {
 	let currentMigration;
 	try {
 		const { metadata } = await client.getMetadata({ trn });
-		const label = metadata?.labels["sdk-migration"];
+		const label = metadata?.labels[MIGRATION_LABEL_KEY];
 		currentMigration = label ? parseMigrationLabelNumber(label) ?? 0 : 0;
 	} catch {
 		currentMigration = 0;
@@ -6609,7 +6671,7 @@ async function set(options) {
 		trn,
 		labels: {
 			...existingLabels,
-			"sdk-migration": `m${formatMigrationNumber(migrationNumber)}`
+			[MIGRATION_LABEL_KEY]: `m${formatMigrationNumber(migrationNumber)}`
 		}
 	});
 	logger.success(`Migration checkpoint set to ${styles.bold(formatMigrationNumber(migrationNumber))} for namespace ${styles.bold(targetNamespace)}`);
@@ -6661,7 +6723,7 @@ async function collectMigrationStatuses(options) {
 		let currentMigration;
 		try {
 			const { metadata } = await client.getMetadata({ trn });
-			const label = metadata?.labels["sdk-migration"];
+			const label = metadata?.labels[MIGRATION_LABEL_KEY];
 			currentMigration = label ? parseMigrationLabelNumber(label) ?? 0 : 0;
 		} catch {
 			currentMigration = 0;
@@ -6784,7 +6846,7 @@ async function fetchRemoteTypes(client, workspaceId, namespace) {
 async function assertMigrationsReproduceLocalTypes(loaded, target) {
 	const { config, plugins } = loaded;
 	const pluginManager = plugins.length > 0 ? new PluginManager(plugins) : void 0;
-	const { defineApplication, generatePluginFilesIfNeeded } = await import("../application-CP7JKG9R.mjs");
+	const { defineApplication, generatePluginFilesIfNeeded } = await import("../application-C-zsrNjn.mjs");
 	const application = defineApplication({
 		config,
 		pluginManager
@@ -6796,7 +6858,7 @@ async function assertMigrationsReproduceLocalTypes(loaded, target) {
 		await service.processNamespacePlugins();
 	}
 	const pluginExecutorFiles = generatePluginFilesIfNeeded(pluginManager, application.tailorDBServices, config.path);
-	const executorService = application.executorService ?? (pluginExecutorFiles.length > 0 ? (await import("../service-KnAiVofD.mjs")).createExecutorService({
+	const executorService = application.executorService ?? (pluginExecutorFiles.length > 0 ? (await import("../service-Cigg_U-v.mjs")).createExecutorService({
 		config: { files: [] },
 		baseDir: path.dirname(config.path)
 	}) : void 0);
@@ -7015,6 +7077,204 @@ const syncCommand = defineAppCommand({
 	}
 });
 
+//#endregion
+//#region src/cli/commands/tailordb/migrate/validate.ts
+/**
+* Assert that every migration in the local history whose diff requires a data
+* migration script has a migrate.ts on disk or an explicit skip acknowledgment
+* @param {string} migrationsDir - Migrations directory path
+* @param {string} namespace - TailorDB namespace (for error messages)
+*/
+function assertRequiredMigrationScripts(migrationsDir, namespace) {
+	const missing = [];
+	for (const file of getMigrationFiles(migrationsDir)) {
+		if (file.type !== "diff") continue;
+		const diff = loadDiff(file.path);
+		if (!diff.requiresMigrationScript || diff.scriptSkipped) continue;
+		if (!fs$1.existsSync(getMigrationFilePath(migrationsDir, file.number, "migrate"))) missing.push(file.number);
+	}
+	if (missing.length > 0) throw new Error(`Migration(s) ${missing.map(formatMigrationNumber).join(", ")} in namespace "${namespace}" require a migration script but have no migrate.ts. Add one with 'tailor-sdk tailordb migration script <number>', or record that no script is needed with 'tailor-sdk tailordb migration script <number> --no-script --reason "..."'.`);
+}
+/**
+* Build per-namespace reports from the checks that completed
+* @param {BuildValidationReportsOptions} options - Completed validation results
+* @returns {NamespaceValidationReport[]} Validation reports per namespace
+*/
+function buildValidationReports(options) {
+	const { targetNamespaces, migrationFileErrors, localResults, remoteResults } = options;
+	return targetNamespaces.map((target) => {
+		const fileError = migrationFileErrors.get(target.namespace);
+		if (fileError !== void 0) return {
+			namespace: target.namespace,
+			valid: false,
+			migrationFiles: {
+				valid: false,
+				error: fileError
+			}
+		};
+		const local = assertDefined(localResults.find((result) => result.namespace === target.namespace), `local schema check result missing for namespace "${target.namespace}"`);
+		const localSchema = {
+			hasDiff: local.hasDiff,
+			...local.diff ? { diff: local.diff } : {}
+		};
+		if (remoteResults === void 0) return {
+			namespace: target.namespace,
+			valid: false,
+			migrationFiles: { valid: true },
+			localSchema,
+			remoteSchema: { skipped: "check_failed" }
+		};
+		const remote = assertDefined(remoteResults.find((result) => result.namespace === target.namespace), `remote schema check result missing for namespace "${target.namespace}"`);
+		const checkpointMissingLocal = remote.checkpointMissingLocal === true;
+		const remoteSchema = {
+			remoteMigrationNumber: remote.remoteMigrationNumber,
+			hasDrift: remote.hasDrift,
+			drifts: remote.drifts,
+			...remote.skipped ? { skipped: remote.skipped } : {},
+			...checkpointMissingLocal ? { checkpointMissingLocal: true } : {}
+		};
+		return {
+			namespace: target.namespace,
+			valid: !localSchema.hasDiff && !remoteSchema.hasDrift && !checkpointMissingLocal,
+			migrationFiles: { valid: true },
+			localSchema,
+			remoteSchema
+		};
+	});
+}
+/**
+* Run all migration validation checks and collect per-namespace reports
+* @param {ValidateOptions} options - Command options
+* @returns {Promise<CollectedValidationReports>} Validation reports and any remote error
+*/
+async function collectValidationReports(options) {
+	const { config, plugins } = await loadConfig(options.configPath);
+	const namespacesWithMigrations = getNamespacesWithMigrations(config, path.dirname(config.path));
+	if (namespacesWithMigrations.length === 0) throw new Error("No TailorDB services with migrations configuration found");
+	const targetNamespaces = options.namespace ? namespacesWithMigrations.filter((ns) => ns.namespace === options.namespace) : namespacesWithMigrations;
+	if (targetNamespaces.length === 0) throw new Error(`Namespace "${options.namespace}" not found or does not have migrations configured`);
+	const pluginManager = plugins.length > 0 ? new PluginManager(plugins) : void 0;
+	const { defineApplication } = await import("../application-C-zsrNjn.mjs");
+	const application = defineApplication({
+		config,
+		pluginManager
+	});
+	for (const service of application.tailorDBServices) {
+		await service.loadTypes();
+		await service.processNamespacePlugins();
+	}
+	assertUniqueLocalTailorDBTypeNames({ tailorDBServices: application.tailorDBServices });
+	for (const { namespace } of targetNamespaces) if (!application.tailorDBServices.some((s) => s.namespace === namespace)) throw new Error(`No TailorDB service found for namespace "${namespace}"`);
+	const tailorDBInputs = application.tailorDBServices.map(toTailorDBDeployInput);
+	const typesByNamespace = new Map(tailorDBInputs.map((input) => [input.namespace, input.types]));
+	const migrationFileErrors = /* @__PURE__ */ new Map();
+	const checkableNamespaces = [];
+	for (const target of targetNamespaces) try {
+		assertValidMigrationFiles(target.migrationsDir, target.namespace);
+		reconstructSnapshotFromMigrations(target.migrationsDir);
+		assertRequiredMigrationScripts(target.migrationsDir, target.namespace);
+		checkableNamespaces.push(target);
+	} catch (error) {
+		migrationFileErrors.set(target.namespace, error instanceof Error ? error.message : String(error));
+	}
+	const localReportOptions = {
+		targetNamespaces,
+		migrationFileErrors,
+		localResults: await checkMigrationDiffs(typesByNamespace, checkableNamespaces)
+	};
+	if (checkableNamespaces.length === 0) return { reports: buildValidationReports(localReportOptions) };
+	let remoteResults;
+	try {
+		remoteResults = await verifyRemoteSchema(await initOperatorClient(await loadAccessToken({ profile: options.profile })), await loadWorkspaceId({
+			workspaceId: options.workspaceId,
+			profile: options.profile
+		}), checkableNamespaces, config, tailorDBInputs);
+	} catch (remoteError) {
+		return {
+			reports: buildValidationReports(localReportOptions),
+			remoteError
+		};
+	}
+	return { reports: buildValidationReports({
+		...localReportOptions,
+		remoteResults
+	}) };
+}
+function printValidationReports(reports) {
+	for (const report of reports) {
+		logger.newline();
+		logger.info(`Namespace: ${styles.bold(report.namespace)}`);
+		if (!report.migrationFiles.valid) {
+			logger.log(`  Migration files: ${styles.error("invalid")}`);
+			logger.log(`    ${report.migrationFiles.error}`);
+			continue;
+		}
+		logger.log(`  Migration files: ${styles.success("OK")}`);
+		const local = report.localSchema;
+		if (local?.hasDiff) if (local.diff) {
+			logger.log(`  Local schema: ${styles.error("changes not in migration files")}`);
+			logger.log(`    ${formatDiffSummary(local.diff)}`);
+			logger.log(formatMigrationDiff(local.diff));
+		} else logger.log(`  Local schema: ${styles.error("no migration snapshot found")}`);
+		else logger.log(`  Local schema: ${styles.success("OK")}`);
+		const remote = report.remoteSchema;
+		if (remote?.skipped === "check_failed") logger.log(`  Remote schema: ${styles.error("not checked")}`);
+		else if (remote?.checkpointMissingLocal) logger.log(`  Remote schema: ${styles.error(`remote migration ${formatMigrationNumber(remote.remoteMigrationNumber)} is not in the local migration history`)}`);
+		else if (remote?.hasDrift) {
+			logger.log(`  Remote schema: ${styles.error("drift detected")} (remote migration: ${formatMigrationNumber(remote.remoteMigrationNumber)})`);
+			logger.log(formatSchemaDrifts(remote.drifts));
+		} else if (remote?.skipped === "not_deployed") logger.log(`  Remote schema: ${styles.dim("skipped (namespace not deployed)")}`);
+		else if (remote?.skipped === "no_migration_label") logger.log(`  Remote schema: ${styles.dim("skipped (deployed namespace has no migration state)")}`);
+		else if (remote?.skipped === "no_snapshot") logger.log(`  Remote schema: ${styles.dim(`skipped (no local snapshot for remote migration ${formatMigrationNumber(remote.remoteMigrationNumber)})`)}`);
+		else if (remote) logger.log(`  Remote schema: ${styles.success("OK")} (remote migration: ${formatMigrationNumber(remote.remoteMigrationNumber)})`);
+	}
+	logger.newline();
+}
+function printResolutionHints(reports) {
+	if (reports.some((r) => r.localSchema?.hasDiff && !r.localSchema.diff)) logger.info("Run 'tailor-sdk tailordb migration generate' to create the initial snapshot.");
+	if (reports.some((r) => r.localSchema?.diff)) logger.info("Run 'tailor-sdk tailordb migration generate' to create migration files.");
+	if (reports.some((r) => r.remoteSchema?.checkpointMissingLocal)) logger.info("The remote migration checkpoint is ahead of the local history. Pull the latest migration files, or run 'tailor-sdk tailordb migration status' to compare.");
+	if (reports.some((r) => r.remoteSchema?.hasDrift)) logRemoteDriftGuidance();
+}
+/**
+* Validate migration files and schema state without deploying
+* @param {ValidateOptions} options - Command options
+*/
+async function validate(options) {
+	logBetaWarning("tailordb migration");
+	const collected = await collectValidationReports(options);
+	const { reports } = collected;
+	const invalidCount = reports.filter((r) => !r.valid).length;
+	if (options.json) logger.out(reports);
+	else {
+		printValidationReports(reports);
+		if (invalidCount === 0 && !("remoteError" in collected)) logger.success("All migration validation checks passed.");
+		else printResolutionHints(reports);
+	}
+	if ("remoteError" in collected) throw collected.remoteError;
+	if (invalidCount > 0) throw new Error(`Migration validation failed for ${invalidCount} namespace(s)`);
+}
+const validateCommand = defineAppCommand({
+	name: "validate",
+	description: "Validate the full migration history and detect schema drift (local types vs. migration snapshot, remote schema vs. migration checkpoint) without deploying. This includes the migration and schema-drift checks used by 'deploy' and exits with a non-zero code when issues are found.",
+	args: z.object({
+		...deploymentArgs,
+		namespace: arg(z.string().optional(), {
+			alias: "n",
+			description: "Target TailorDB namespace (validates all namespaces if not specified)"
+		})
+	}).strict(),
+	run: async (args) => {
+		await validate({
+			configPath: args.config,
+			namespace: args.namespace,
+			workspaceId: args["workspace-id"],
+			profile: args.profile,
+			json: logger.jsonMode
+		});
+	}
+});
+
 //#endregion
 //#region src/cli/commands/tailordb/migrate/index.ts
 /**
@@ -7026,6 +7286,7 @@ const syncCommand = defineAppCommand({
 * - set:      Set migration checkpoint to a specific number
 * - status:   Show migration status for TailorDB namespaces
 * - sync:     Sync remote TailorDB schema to a specific migration snapshot
+* - validate: Validate migration files and detect schema drift without deploying
 */
 const migrationCommand = defineCommand({
 	name: "migration",
@@ -7035,7 +7296,8 @@ const migrationCommand = defineCommand({
 		script: scriptCommand,
 		set: setCommand,
 		status: statusCommand,
-		sync: syncCommand
+		sync: syncCommand,
+		validate: validateCommand
 	}
 });