@happyvertical/smrt-cli 0.40.31 → 0.40.32

package/README.md

@@ -67,14 +67,17 @@ smrt db:migrate --postgres-timestamp-legacy-timezone UTC
 ```
 
 The option has no default and rejects every value other than `UTC`. On
-PostgreSQL, it allows the manifest-owned timestamp columns to be converted to
-`timestamptz` with `USING column AT TIME ZONE 'UTC'`, preserving the proven UTC
-instants. It is not safe for a database with any local-time writer; use an
-application-owned, provenance-aware migration in that case. Rehearse against a
-restored clone and keep a verified backup because type upgrades have no
-automatic down migration. `smrt db:diff --postgres-timestamp-legacy-timezone
-UTC` and `smrt db:migrate --dry-run --postgres-timestamp-legacy-timezone UTC`
-both preview the same conversion without writing it.
+PostgreSQL, `db:migrate` first converts framework-owned `_smrt_*` timestamp
+columns before migration-tracker bootstrap, then converts manifest-owned
+columns to `timestamptz` with `USING column AT TIME ZONE 'UTC'`. This preserves
+the proven UTC instants. It is not safe for a database with any local-time
+writer; use an application-owned, provenance-aware migration in that case.
+Rehearse against a restored clone and keep a verified backup because type
+upgrades have no automatic down migration. `smrt db:diff
+--postgres-timestamp-legacy-timezone UTC` previews manifest-owned changes;
+`smrt db:migrate --dry-run --postgres-timestamp-legacy-timezone UTC` also
+queries and prints the read-only `_smrt_*` conversion plan without initializing
+the tracker or writing to the database.
 
 ### Code Generation
 

package/dist/{commands-gjGWLmwD.js → commands-DA3gTMzR.js}

@@ -5,7 +5,7 @@ import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, writeFile
 import * as path from "node:path";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { ObjectRegistry, SchemaComparer, createQualifiedName, generateDDLForEngine, getClassName, isQualifiedName, parseQualifiedName } from "@happyvertical/smrt-core";
+import { ObjectRegistry, SchemaComparer, createQualifiedName, generateDDLForEngine, getClassName, isQualifiedName, migratePostgresSystemTimestamps, parseQualifiedName, planPostgresSystemTimestampMigrations } from "@happyvertical/smrt-core";
 import { loadExternalManifestSync } from "@happyvertical/smrt-core/manifest";
 import { access, cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { createLogger } from "@happyvertical/logger";
@@ -7187,6 +7187,7 @@ export default testManifest;
 			try {
 				const forceSelection = resolveForceMigrationSelection(options.force, options["force-migration"]);
 				const postgresTimestampMigration = resolvePostgresTimestampMigration(options["postgres-timestamp-legacy-timezone"]);
+				const isDryRun = options["dry-run"] ?? false;
 				const { getPackageConfig } = await import("@happyvertical/smrt-config");
 				const { DEFAULT_CLI_CONFIG } = await import("./config-BwrFRL8L.js");
 				const config = getPackageConfig("cli", DEFAULT_CLI_CONFIG);
@@ -7264,22 +7265,23 @@ export default testManifest;
 					return;
 				}
 				console.log(`✓ Connected to ${formatDatabaseDisplayUrl(dbType, dbUrl)}\n`);
+				const systemTimestampPreview = postgresTimestampMigration && isDryRun ? await planPostgresSystemTimestampMigrations(db, postgresTimestampMigration, dbType) : [];
+				if (postgresTimestampMigration && !isDryRun) await migratePostgresSystemTimestamps(db, postgresTimestampMigration, dbType);
 				const { MigrationTracker, shortChecksum } = await import("@happyvertical/smrt-core/migrations");
 				const tracker = new MigrationTracker({
 					db,
 					useConcurrentIndexes: options["postgres-safe"] ?? false
 				});
-				await tracker.initialize();
+				if (!isDryRun) await tracker.initialize();
 				if (options.verbose) {
 					const engine = tracker.getEngine();
-					console.log(`Migration tracker initialized (engine: ${engine})`);
+					console.log(isDryRun ? `Migration tracker preview configured (engine: ${engine})` : `Migration tracker initialized (engine: ${engine})`);
 					if (options["postgres-safe"] && engine === "postgres") console.log("PostgreSQL-safe mode enabled (CONCURRENTLY, lock_timeout)");
 					console.log();
 				}
 				const migrations = [];
 				const manualInterventions = [];
 				const tableErrorCount = 0;
-				const isDryRun = options["dry-run"] ?? false;
 				const applySchemaMigrations = shouldApplySchemaMigrations({ dryRun: isDryRun });
 				const repairData = Boolean(options["repair-data"] || options["upgrade-sti"]);
 				if (options["upgrade-sti"]) {
@@ -7323,7 +7325,7 @@ export default testManifest;
 					console.log("   Manual migration required (backup, recreate, restore as needed).\n");
 				}
 				const tablesCreated = diff.added_tables.length > 0;
-				const schemaUpToDate = migrations.length === 0 && manualInterventions.length === 0 && !tablesCreated;
+				const schemaUpToDate = migrations.length === 0 && manualInterventions.length === 0 && !tablesCreated && systemTimestampPreview.length === 0;
 				if (isDryRun) {
 					if (schemaUpToDate && !repairData) {
 						console.log("✅ Database schema is up to date - no migrations needed\n");
@@ -7332,6 +7334,11 @@ export default testManifest;
 					if (schemaUpToDate) console.log("✅ Database schema is up to date - no schema migrations needed\n");
 					else {
 						console.log("📋 Migration Preview (not executed):\n");
+						if (systemTimestampPreview.length > 0) {
+							console.log(`  🕰️  SMRT system timestamp columns to convert: ${systemTimestampPreview.length}`);
+							for (const migration of systemTimestampPreview) console.log(migration.kind === "column" ? `     ${migration.tableName}.${migration.columnName}` : "     _smrt_changes append function signature");
+							console.log();
+						}
 						const columnMigrations = migrations.filter((m) => m.type === "add_column");
 						const indexMigrations = migrations.filter((m) => m.type === "add_index");
 						const indexDrops = migrations.filter((m) => m.type === "drop_index");
@@ -7351,6 +7358,10 @@ export default testManifest;
 							console.log();
 						}
 						console.log("  SQL Statements:\n");
+						for (const migration of systemTimestampPreview) {
+							const terminator = migration.sql.trimEnd().endsWith(";") ? "" : ";";
+							console.log(`    ${migration.sql}${terminator}`);
+						}
 						for (const m of migrations) {
 							const sqlStatements = m.sqlStatements ?? (m.sql ? [m.sql] : []);
 							for (const sql of sqlStatements) console.log(`    ${sql};`);

package/dist/index.js

@@ -48,56 +48,56 @@ var _docsCommands = null;
 var _playgroundCommands = null;
 async function getGnodeCommands() {
 	if (!_gnodeCommands) {
-		const { gnodeCommands } = await import("./commands-gjGWLmwD.js");
+		const { gnodeCommands } = await import("./commands-DA3gTMzR.js");
 		_gnodeCommands = gnodeCommands;
 	}
 	return _gnodeCommands;
 }
 async function getGitCommands() {
 	if (!_gitCommands) {
-		const { gitCommands } = await import("./commands-gjGWLmwD.js");
+		const { gitCommands } = await import("./commands-DA3gTMzR.js");
 		_gitCommands = gitCommands;
 	}
 	return _gitCommands;
 }
 async function getGenerateCommands() {
 	if (!_generateCommands) {
-		const { generateCommands } = await import("./commands-gjGWLmwD.js");
+		const { generateCommands } = await import("./commands-DA3gTMzR.js");
 		_generateCommands = generateCommands;
 	}
 	return _generateCommands;
 }
 async function getInitCommands() {
 	if (!_initCommands) {
-		const { initCommands } = await import("./commands-gjGWLmwD.js");
+		const { initCommands } = await import("./commands-DA3gTMzR.js");
 		_initCommands = initCommands;
 	}
 	return _initCommands;
 }
 async function getUtilityCommands() {
 	if (!_utilityCommands) {
-		const { utilityCommands } = await import("./commands-gjGWLmwD.js");
+		const { utilityCommands } = await import("./commands-DA3gTMzR.js");
 		_utilityCommands = utilityCommands;
 	}
 	return _utilityCommands;
 }
 async function getDispatchCommands() {
 	if (!_dispatchCommands) {
-		const { dispatchCommands } = await import("./commands-gjGWLmwD.js");
+		const { dispatchCommands } = await import("./commands-DA3gTMzR.js");
 		_dispatchCommands = dispatchCommands;
 	}
 	return _dispatchCommands;
 }
 async function getDocsCommands() {
 	if (!_docsCommands) {
-		const { docsCommands } = await import("./commands-gjGWLmwD.js");
+		const { docsCommands } = await import("./commands-DA3gTMzR.js");
 		_docsCommands = docsCommands;
 	}
 	return _docsCommands;
 }
 async function getPlaygroundCommands() {
 	if (!_playgroundCommands) {
-		const { playgroundCommands } = await import("./commands-gjGWLmwD.js");
+		const { playgroundCommands } = await import("./commands-DA3gTMzR.js");
 		_playgroundCommands = playgroundCommands;
 	}
 	return _playgroundCommands;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-cli",
-  "version": "0.40.31",
+  "version": "0.40.32",
   "description": "Developer CLI for SMRT framework - introspection, testing, and project management",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,12 +32,12 @@
     "acorn": "^8.17.0",
     "fast-glob": "3.3.3",
     "tar": "^7.5.19",
-    "@happyvertical/smrt-agents": "0.40.31",
-    "@happyvertical/smrt-dev-mcp": "0.40.31",
-    "@happyvertical/smrt-core": "0.40.31",
-    "@happyvertical/smrt-types": "0.40.31",
-    "@happyvertical/smrt-playground": "0.40.31",
-    "@happyvertical/smrt-config": "0.40.31"
+    "@happyvertical/smrt-agents": "0.40.32",
+    "@happyvertical/smrt-core": "0.40.32",
+    "@happyvertical/smrt-playground": "0.40.32",
+    "@happyvertical/smrt-types": "0.40.32",
+    "@happyvertical/smrt-dev-mcp": "0.40.32",
+    "@happyvertical/smrt-config": "0.40.32"
   },
   "devDependencies": {
     "@types/node": "24.13.2",