@happyvertical/smrt-cli 0.40.66 → 0.40.68

package/AGENTS.md

@@ -6,6 +6,7 @@ Developer CLI with lazy-loaded commands, manifest discovery, and class introspec
 
 ```
 smrt introspect              # Discover SMRT objects in project
+smrt doctor                  # Umbrella diagnostics; can verify a generation snapshot
 smrt db:status               # Pending schema changes + failed migration classification
 smrt db:migrate              # Apply migrations
 smrt db:migrate --force-migration <exact-id> [--force-migration <exact-id>...] # Force exact generated migrations in one atomic batch

package/README.md

@@ -19,6 +19,25 @@ pnpm add -D @happyvertical/smrt-cli
 | `smrt objects` | List all registered s-m-r-t objects |
 | `smrt schema <object>` | Show detailed schema for an object |
 | `smrt status` | Show system status (database, AI, registry) |
+| `smrt doctor` | Run the umbrella project-health diagnostics (aliases: `check`, `diagnose`) |
+
+`smrt doctor` reports project-health and integration problems. Noun-scoped
+validators such as `smrt db:validate` retain their narrower contracts; do not
+use a generic `smrt validate` command as a second project-health entry point.
+Artifact consumers must still verify their own inputs and fail closed—running
+`doctor` is an observability aid, not a prerequisite for safe loading.
+
+To inspect the same generation-snapshot contract used by the Vite plugins:
+
+```bash
+smrt doctor \
+  --generation-snapshot .ci/smrt-generation-snapshot.json \
+  --generation-snapshot-sha256 "$SMRT_GENERATION_SNAPSHOT_SHA256" \
+  --generation-snapshot-provenance "$GITHUB_SHA" \
+  --generation-snapshot-source-root "$GITHUB_WORKSPACE"
+```
+
+The four snapshot options are atomic: supplying any one requires all four.
 
 ### Database
 

package/dist/{commands-BMFrPkA-.js → commands-U7gYv14z.js}

@@ -6441,8 +6441,7 @@ function getRowCount(result) {
 }
 function buildNullSafeIdentityPredicate(columns) {
 	return columns.map((column) => {
-		const quoted = quoteIdentifier(column);
-		return `(${quoted} = ? OR (${quoted} IS NULL AND ? IS NULL))`;
+		return `${quoteIdentifier(column)} IS NOT DISTINCT FROM ?`;
 	}).join(" AND ");
 }
 /**
@@ -6455,9 +6454,7 @@ function getRowId(row) {
 	return id == null ? null : id;
 }
 function getIdentityParams(row, columns) {
-	const params = [];
-	for (const column of columns) params.push(row[column], row[column]);
-	return params;
+	return columns.map((column) => row[column]);
 }
 function getStiConflictIdentityColumns(className) {
 	return ObjectRegistry.getConflictColumns(className).filter((column) => column !== "_meta_type");
@@ -7603,12 +7600,30 @@ export default testManifest;
 		description: "Diagnose and report on SMRT project health",
 		aliases: ["check", "diagnose"],
 		args: [],
-		options: { fix: {
-			type: "boolean",
-			description: "Attempt to fix issues automatically",
-			default: false,
-			short: "f"
-		} },
+		options: {
+			fix: {
+				type: "boolean",
+				description: "Attempt to fix issues automatically",
+				default: false,
+				short: "f"
+			},
+			"generation-snapshot": {
+				type: "string",
+				description: "Verify a transported SMRT generation snapshot"
+			},
+			"generation-snapshot-sha256": {
+				type: "string",
+				description: "Expected sha256:<hex> digest for the generation snapshot"
+			},
+			"generation-snapshot-provenance": {
+				type: "string",
+				description: "Expected source provenance for the generation snapshot"
+			},
+			"generation-snapshot-source-root": {
+				type: "string",
+				description: "Absolute current checkout root for portable snapshot paths"
+			}
+		},
 		handler: async (_args, options) => {
 			const { existsSync, readFileSync } = await import("node:fs");
 			const { resolve, join } = await import("node:path");
@@ -7666,6 +7681,30 @@ export default testManifest;
 				} else check("Packed publish artifact verification", false, void 0, "Pack verifier is unavailable in this SMRT CLI build");
 				console.log();
 			}
+			const snapshotOptionNames = [
+				"generation-snapshot",
+				"generation-snapshot-sha256",
+				"generation-snapshot-provenance",
+				"generation-snapshot-source-root"
+			];
+			if (snapshotOptionNames.some((name) => options[name] !== void 0)) {
+				console.log("📸 Generation Snapshot\n");
+				const missingOptions = snapshotOptionNames.filter((name) => !options[name]?.trim());
+				if (missingOptions.length > 0) check("Generation snapshot verified", false, `Missing required option(s): ${missingOptions.map((name) => `--${name}`).join(", ")}`);
+				else try {
+					const { loadVerifiedSmrtGenerationSnapshot } = await import("@happyvertical/smrt-core/vite-plugin");
+					const snapshot = loadVerifiedSmrtGenerationSnapshot({
+						path: options["generation-snapshot"] ?? "",
+						sha256: options["generation-snapshot-sha256"] ?? "",
+						provenance: options["generation-snapshot-provenance"] ?? "",
+						sourceRoot: options["generation-snapshot-source-root"] ?? ""
+					}, cwd);
+					check(`Generation snapshot verified (${Object.keys(snapshot.objects).length} object(s))`, true);
+				} catch (error) {
+					check("Generation snapshot verified", false, error instanceof Error ? error.message : String(error));
+				}
+				console.log();
+			}
 			console.log("⚙️  Configuration\n");
 			const smrtConfigTs = resolve(cwd, "smrt.config.ts");
 			const smrtConfigJs = resolve(cwd, "smrt.config.js");

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-cli",
-  "version": "0.40.66",
+  "version": "0.40.68",
   "description": "Developer CLI for SMRT framework - introspection, testing, and project management",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,20 +24,20 @@
     }
   },
   "dependencies": {
-    "@happyvertical/ai": "^0.86.3",
-    "@happyvertical/files": "^0.86.3",
-    "@happyvertical/logger": "^0.86.3",
-    "@happyvertical/sql": "^0.86.3",
-    "@happyvertical/utils": "^0.86.3",
+    "@happyvertical/ai": "^0.87.0",
+    "@happyvertical/files": "^0.87.0",
+    "@happyvertical/logger": "^0.87.0",
+    "@happyvertical/sql": "^0.87.0",
+    "@happyvertical/utils": "^0.87.0",
     "acorn": "^8.17.0",
     "fast-glob": "3.3.3",
     "tar": "^7.5.19",
-    "@happyvertical/smrt-agents": "0.40.66",
-    "@happyvertical/smrt-playground": "0.40.66",
-    "@happyvertical/smrt-config": "0.40.66",
-    "@happyvertical/smrt-types": "0.40.66",
-    "@happyvertical/smrt-dev-mcp": "0.40.66",
-    "@happyvertical/smrt-core": "0.40.66"
+    "@happyvertical/smrt-agents": "0.40.68",
+    "@happyvertical/smrt-config": "0.40.68",
+    "@happyvertical/smrt-core": "0.40.68",
+    "@happyvertical/smrt-dev-mcp": "0.40.68",
+    "@happyvertical/smrt-playground": "0.40.68",
+    "@happyvertical/smrt-types": "0.40.68"
   },
   "devDependencies": {
     "@types/node": "24.13.2",
@@ -72,7 +72,7 @@
     "clean": "rm -rf dist",
     "dev": "npm run build:watch",
     "test": "vitest run",
-    "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run src/commands/__tests__/db-migrate-uuid.test.ts src/commands/__tests__/db-migrate-force-postgres.test.ts",
+    "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run src/commands/__tests__/db-migrate-uuid.test.ts src/commands/__tests__/db-migrate-force-postgres.test.ts src/commands/__tests__/sti-upgrade.test.ts",
     "test:watch": "vitest",
     "typecheck": "tsc -p tsconfig.typecheck.json",
     "cli": "tsx src/index.ts"