@tailor-platform/sdk 1.84.0 → 1.85.0

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

@@ -6,4 +6,5 @@ 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/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/index.mjs

@@ -3,8 +3,8 @@ 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-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-BCvWR3HC.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-CnCljDwk.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";
@@ -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
 	};
 }
@@ -6630,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;
@@ -6664,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)}`);
@@ -6716,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;
@@ -6839,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-5FOWIxFQ.mjs");
+	const { defineApplication, generatePluginFilesIfNeeded } = await import("../application-C-zsrNjn.mjs");
 	const application = defineApplication({
 		config,
 		pluginManager
@@ -7070,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
 /**
@@ -7081,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",
@@ -7090,7 +7296,8 @@ const migrationCommand = defineCommand({
 		script: scriptCommand,
 		set: setCommand,
 		status: statusCommand,
-		sync: syncCommand
+		sync: syncCommand,
+		validate: validateCommand
 	}
 });