@happyvertical/smrt-cli 0.49.3 → 0.49.5

package/AGENTS.md

@@ -1,6 +1,6 @@
 # @happyvertical/smrt-cli
 
-Developer CLI with lazy-loaded commands, manifest discovery, and class introspection.
+CLI with lazy-loaded commands, manifest discovery, and class introspection.
 
 ## Commands
 
@@ -16,7 +16,8 @@ smrt db:migrate --postgres-safe # PostgreSQL concurrent-index mode (see below)
 smrt db:migrate --force-migration <exact-id> [--force-migration <exact-id>...] # Force exact generated migrations in one atomic batch
 smrt db:migrate --apply-unblocked / --null-orphans # agents/db-migrate-partial-apply.md
 smrt db:migrate-uuid         # Convert schema-declared UUID text columns after data remap
-smrt db:migrate-int8         # Explicitly widen pre-#2373 int4 columns after preflight
+smrt db:migrate-int8
+smrt db:migrate-null-equal-indexes # ../core/agents/null-equal-indexes.md
 smrt db:drop-framework-base-tables # One-time drop of the five #2644-orphaned framework-base tables
 smrt db:drop-framework-base-tables --dry-run # Print the drop plan without executing
 smrt db:diff                 # Show schema differences without generating migration files

package/dist/{commands-DEHkYYWF.js → commands-DxvVdCOS.js}

@@ -23,7 +23,7 @@ import { homedir, tmpdir } from "node:os";
 import { extract } from "tar";
 import { importWorkspaceModule } from "@happyvertical/smrt-core/utils/import-workspace-module";
 import { renderForeignKeyAddStatements } from "@happyvertical/smrt-core/schema";
-import { FRAMEWORK_BASE_TABLE_NAMES, buildIntegerWidthTableStatements, collectIntegerWidthTargets, dropFrameworkBaseTables, parsePostgresTimeoutMs, planFrameworkBaseTableDrop, preflightIntegerWidthWidening, widenIntegerColumnsToBigInt } from "@happyvertical/smrt-core/migrations";
+import { FRAMEWORK_BASE_TABLE_NAMES, buildIntegerWidthTableStatements, collectIntegerWidthTargets, collectNullEqualIndexTargets, dropFrameworkBaseTables, migrateNullEqualIndexes, nullEqualIndexStatements, parsePostgresTimeoutMs, planFrameworkBaseTableDrop, preflightIntegerWidthWidening, preflightNullEqualIndexes, widenIntegerColumnsToBigInt } from "@happyvertical/smrt-core/migrations";
 import { buildArchitectureContext, buildKnowledgeIndex, buildReviewContext, checkKnowledgeFreshness, compactContextResult, diffKnowledgeIndex, renderFreshnessResult, renderKnowledgeIndexMarkdown } from "@happyvertical/smrt-dev-mcp/knowledge";
 import { RUNTIME_TOOLS } from "@happyvertical/smrt-dev-mcp/runtime";
 //#region src/commands/db-command-utils.ts
@@ -6952,6 +6952,59 @@ var dbMigrateInt8Command = {
 	}
 };
 //#endregion
+//#region src/commands/db-migrate-null-equal-indexes.ts
+var dbMigrateNullEqualIndexesCommand = {
+	name: "db:migrate-null-equal-indexes",
+	description: "Upgrade framework nullable conflict indexes on PostgreSQL 15+ in an explicit maintenance window. Run after db:migrate.",
+	args: [],
+	options: { "dry-run": {
+		type: "boolean",
+		default: false,
+		description: "Inspect readiness, duplicates and proposed DDL without writing."
+	} },
+	handler: async (_args, options) => {
+		let db;
+		try {
+			const { getPackageConfig } = await import("@happyvertical/smrt-config");
+			const { DEFAULT_CLI_CONFIG } = await import("./config-DfBo4hHU.js").then((n) => n.n);
+			const config = getPackageConfig("cli", DEFAULT_CLI_CONFIG);
+			if (!config.database?.url || config.database.url === ":memory:") throw new Error("Database configuration required: set database.url in smrt.config.ts (or DATABASE_URL).");
+			await autoDiscoverAndLoad();
+			const schemas = ObjectRegistry.getAllSchemasAsDefinitions();
+			if (!Object.keys(schemas).length) throw new Error("No SMRT schemas discovered. Run from the project root after generating manifests.");
+			const type = config.database.type || "sqlite";
+			const { getDatabase } = await import("@happyvertical/sql");
+			db = await getDatabase({
+				type,
+				url: config.database.url
+			});
+			console.log(`Connected to ${formatDatabaseDisplayUrl(type, config.database.url)}`);
+			const targets = collectNullEqualIndexTargets(schemas);
+			const preflight = await preflightNullEqualIndexes(db, targets, { engineHint: type });
+			console.log(preflight.summary);
+			for (const index of preflight.indexes) {
+				console.log(`${index.table}.${index.index}: ${index.state}${index.reason ? ` — ${index.reason}` : ""}`);
+				if (index.state === "blocked") console.log(`Detector: ${index.detectorSql};`);
+				if (index.state === "pending") for (const sql of nullEqualIndexStatements(index)) console.log(`${sql};`);
+			}
+			if (preflight.indexes.some((index) => index.state === "blocked")) throw new Error("Preflight blocked. Resolve the reported identities or dependencies; no changes applied.");
+			if (!preflight.supported || options["dry-run"]) return;
+			const result = await migrateNullEqualIndexes(db, targets, {
+				engineHint: type,
+				lockTimeout: config.migrations?.postgres?.lockTimeout,
+				statementTimeout: config.migrations?.postgres?.statementTimeout
+			});
+			console.log(`Applied ${result.statements.length} index statements atomically.`);
+			console.log("Refresh/restart database connections in EVERY application process to clear cached index capability probes. Until then the existing upsert fallback remains correct.");
+		} catch (error) {
+			console.error(`NULL-equal conflict-index migration failed: ${error instanceof Error ? error.message : String(error)}`);
+			process.exitCode = 1;
+		} finally {
+			await closeDatabaseConnection(db);
+		}
+	}
+};
+//#endregion
 //#region src/commands/db-migrate-uuid.ts
 /**
 * db:migrate-uuid Command
@@ -10623,6 +10676,7 @@ export default testManifest;
 	"db:generate": dbGenerateCommand,
 	"db:migrate-uuid": dbMigrateUuidCommand,
 	"db:migrate-int8": dbMigrateInt8Command,
+	"db:migrate-null-equal-indexes": dbMigrateNullEqualIndexesCommand,
 	"db:migrate-agent-schedule-slugs": dbMigrateAgentScheduleSlugsCommand,
 	"db:drop-framework-base-tables": dbDropFrameworkBaseTablesCommand,
 	"db:orphans": dbOrphansCommand,

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-cli",
-  "version": "0.49.3",
+  "version": "0.49.5",
   "description": "Developer CLI for SMRT framework - introspection, testing, and project management",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,12 +28,12 @@
     "@happyvertical/ai": "^0.89.6",
     "@happyvertical/files": "^0.89.6",
     "@happyvertical/logger": "^0.89.6",
-    "@happyvertical/smrt-agents": "0.49.3",
-    "@happyvertical/smrt-config": "0.49.3",
-    "@happyvertical/smrt-core": "0.49.3",
-    "@happyvertical/smrt-dev-mcp": "0.49.3",
-    "@happyvertical/smrt-playground": "0.49.3",
-    "@happyvertical/smrt-types": "0.49.3",
+    "@happyvertical/smrt-agents": "0.49.5",
+    "@happyvertical/smrt-config": "0.49.5",
+    "@happyvertical/smrt-core": "0.49.5",
+    "@happyvertical/smrt-dev-mcp": "0.49.5",
+    "@happyvertical/smrt-playground": "0.49.5",
+    "@happyvertical/smrt-types": "0.49.5",
     "@happyvertical/sql": "^0.89.6",
     "@happyvertical/utils": "^0.89.6",
     "acorn": "^8.17.0",