@fragno-dev/cli 0.0.0-canary-18943940612-1-20251030142344

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+
+> @fragno-dev/cli@0.1.13 build /home/runner/work/fragno/fragno/apps/fragno-cli
+> tsdown
+
+ℹ tsdown v0.15.12 powered by rolldown v1.0.0-beta.45
+ℹ Using tsdown config: /home/runner/work/fragno/fragno/apps/fragno-cli/tsdown.config.ts
+ℹ entry: src/cli.ts
+ℹ target: node22.0.0
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Granting execute permission to dist/cli.d.ts
+ℹ Granting execute permission to dist/cli.js
+ℹ dist/cli.js        15.22 kB │ gzip: 3.96 kB
+ℹ dist/cli.js.map    30.08 kB │ gzip: 7.78 kB
+ℹ dist/cli.d.ts.map   0.51 kB │ gzip: 0.29 kB
+ℹ dist/cli.d.ts       0.94 kB │ gzip: 0.30 kB
+ℹ 4 files, total: 46.75 kB
+✔ Build complete in 2653ms

package/CHANGELOG.md

@@ -0,0 +1,142 @@
+# @fragno-dev/cli
+
+## 0.0.0-canary-18943940612-1-20251030142344
+
+### Patch Changes
+
+- Updated dependencies [2900bfa]
+- Updated dependencies [fdb5aaf]
+  - @fragno-dev/db@0.0.0-canary-18943940612-1-20251030142344
+
+## 0.1.13
+
+### Patch Changes
+
+- Updated dependencies [b6dd67a]
+- Updated dependencies [ec1aed0]
+- Updated dependencies [9a58d8c]
+  - @fragno-dev/core@0.1.5
+  - @fragno-dev/db@0.1.11
+
+## 0.1.12
+
+### Patch Changes
+
+- Updated dependencies [ca57fac]
+  - @fragno-dev/core@0.1.4
+  - @fragno-dev/db@0.1.10
+
+## 0.1.11
+
+### Patch Changes
+
+- Updated dependencies [ad3e63b]
+  - @fragno-dev/db@0.1.10
+
+## 0.1.10
+
+### Patch Changes
+
+- Updated dependencies [8fcceb6]
+  - @fragno-dev/db@0.1.9
+
+## 0.1.9
+
+### Patch Changes
+
+- Updated dependencies [f3cdb1d]
+  - @fragno-dev/db@0.1.8
+
+## 0.1.8
+
+### Patch Changes
+
+- ab6c4bf: fix: make Fragment loading in the CLI more robust
+- Updated dependencies [e36dbcd]
+- Updated dependencies [ab6c4bf]
+- Updated dependencies [d1feecd]
+  - @fragno-dev/db@0.1.7
+
+## 0.1.7
+
+### Patch Changes
+
+- d330bb9: fix: change `bin` to `fragno-cli`
+- Updated dependencies [70bdcb2]
+  - @fragno-dev/db@0.1.6
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [8b2859c]
+- Updated dependencies [bef9f6c]
+- Updated dependencies [711226d]
+  - @fragno-dev/db@0.1.5
+  - @fragno-dev/core@0.1.3
+
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [5d56f48]
+- Updated dependencies [fd3ddd2]
+  - @fragno-dev/db@0.1.4
+
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [0723f84]
+  - @fragno-dev/db@0.1.3
+
+## 0.1.3
+
+### Patch Changes
+
+- a8b1f81: `db generate` command now supports targeting multiple Fragment files
+- a8b1f81: `db info` command now supports targeting multiple files
+- be17727: Added support for generating migrations in multi-Fragment applications
+- Updated dependencies [e7122f2]
+- Updated dependencies [921ef11]
+- Updated dependencies [be17727]
+- Updated dependencies [8362d9a]
+- Updated dependencies [8362d9a]
+- Updated dependencies [c70de59]
+  - @fragno-dev/db@0.1.2
+  - @fragno-dev/core@0.1.2
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [4c1c806]
+  - @fragno-dev/db@0.1.1
+  - @fragno-dev/core@0.1.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [74a615c]
+  - @fragno-dev/core@0.1.0
+  - @fragno-dev/db@0.1.0
+
+## 0.1.0
+
+### Minor Changes
+
+- 2c583a9: Initial release of @fragno-dev/db
+
+### Patch Changes
+
+- Updated dependencies [2c583a9]
+  - @fragno-dev/db@0.1.0
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [1fa71f3]
+- Updated dependencies [c1483c6]
+  - @fragno-dev/core@0.0.7

package/LICENSE.md

@@ -0,0 +1,16 @@
+Copyright 2025 - present "ReJot Nederland B.V.", and individual contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the “Software”), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/cli.d.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import * as gunshi5 from "gunshi";
+
+//#region src/commands/db/generate.d.ts
+declare const generateCommand: gunshi5.Command<{
+  output: {
+    type: "string";
+    short: string;
+    description: string;
+  };
+  from: {
+    type: "number";
+    short: string;
+    description: string;
+  };
+  to: {
+    type: "number";
+    short: string;
+    description: string;
+  };
+  prefix: {
+    type: "string";
+    short: string;
+    description: string;
+  };
+}>;
+//#endregion
+//#region src/commands/db/migrate.d.ts
+declare const migrateCommand: gunshi5.Command<{}>;
+//#endregion
+//#region src/commands/db/info.d.ts
+declare const infoCommand: gunshi5.Command<{}>;
+//#endregion
+//#region src/cli.d.ts
+declare const dbCommand: gunshi5.Command<gunshi5.Args>;
+declare const mainCommand: gunshi5.Command<gunshi5.Args>;
+//#endregion
+export { dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","names":[],"sources":["../src/commands/db/generate.ts","../src/commands/db/migrate.ts","../src/commands/db/info.ts","../src/cli.ts"],"sourcesContent":[],"mappings":";;;;cAOa,iBAyGX,OAAA,CAzG0B;;;;IAAf,WAAA,EAAA,MAyGX;;;;IC3GW,KAAA,EAAA,MAqEX;;;;ICtEW,IAAA,EAAA,QA4HX;;;;ECpGW,MAAA,EAAA;IAWA,IAAA,EAAA,QAaX;;;;;;;cF/CW,gBAqEX,OAAA,CArEyB;;;cCDd,aA4HX,OAAA,CA5HsB;;;AFGX,cGqBA,SHoFX,EGpFoB,OAAA,CAAA,OHrBM,CGyB1B,OAAA,CAJoB,IAAA,CHrBM;cGgCf,aAAW,OAAA,CAAA,QAatB,OAAA,CAbsB,IAAA"}

package/dist/cli.js

@@ -0,0 +1,333 @@
+#!/usr/bin/env node
+import { cli, define, parseArgs, resolveArgs } from "gunshi";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve } from "node:path";
+import { executeMigrations, generateMigrationsOrSchema } from "@fragno-dev/db/generation-engine";
+import { FragnoDatabase, isFragnoDatabase } from "@fragno-dev/db";
+import { fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "@fragno-dev/db/adapters";
+import { instantiatedFragmentFakeSymbol } from "@fragno-dev/core/api/fragment-instantiation";
+import { loadConfig } from "c12";
+
+//#region src/utils/find-fragno-databases.ts
+async function importFragmentFile(path) {
+	const { config } = await loadConfig({ configFile: path });
+	const databases = findFragnoDatabases(config);
+	const adapterNames = databases.map((db) => `${db.adapter[fragnoDatabaseAdapterNameFakeSymbol]}@${db.adapter[fragnoDatabaseAdapterVersionFakeSymbol]}`);
+	if ([...new Set(adapterNames)].length > 1) throw new Error(`All Fragno databases must use the same adapter name and version. Found mismatch: (${adapterNames.join(", ")})`);
+	return {
+		adapter: databases[0].adapter,
+		databases
+	};
+}
+/**
+* Imports multiple fragment files and validates they all use the same adapter.
+* Returns the combined databases from all files.
+*/
+async function importFragmentFiles(paths) {
+	const uniquePaths = Array.from(new Set(paths));
+	if (uniquePaths.length === 0) throw new Error("No fragment files provided");
+	const allDatabases = [];
+	let adapter;
+	let firstAdapterFile;
+	const cwd = process.cwd();
+	for (const path of uniquePaths) {
+		const relativePath = relative(cwd, path);
+		try {
+			const result = await importFragmentFile(path);
+			const databases = result["databases"];
+			const fileAdapter = result["adapter"];
+			if (databases.length === 0) {
+				console.warn(`Warning: No FragnoDatabase instances found in ${relativePath}.\nMake sure you export either:\n  - A FragnoDatabase instance created with .create(adapter)\n  - An instantiated fragment with embedded database definition\n`);
+				continue;
+			}
+			if (!adapter) {
+				adapter = fileAdapter;
+				firstAdapterFile = relativePath;
+			}
+			const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];
+			const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];
+			const fileAdapterName = fileAdapter[fragnoDatabaseAdapterNameFakeSymbol];
+			const fileAdapterVersion = fileAdapter[fragnoDatabaseAdapterVersionFakeSymbol];
+			if (firstAdapterName !== fileAdapterName || firstAdapterVersion !== fileAdapterVersion) {
+				const firstAdapterInfo = `${firstAdapterName}@${firstAdapterVersion}`;
+				const fileAdapterInfo = `${fileAdapterName}@${fileAdapterVersion}`;
+				throw new Error(`All fragments must use the same database adapter. Mixed adapters found:\n  - ${firstAdapterFile}: ${firstAdapterInfo}\n  - ${relativePath}: ${fileAdapterInfo}\n\nMake sure all fragments use the same adapter name and version.`);
+			}
+			allDatabases.push(...databases);
+			console.log(`  Found ${databases.length} database(s) in ${relativePath}`);
+		} catch (error) {
+			throw new Error(`Failed to import fragment file ${relativePath}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+	if (allDatabases.length === 0) throw new Error("No FragnoDatabase instances found in any of the target files.\nMake sure your files export either:\n  - A FragnoDatabase instance created with .create(adapter)\n  - An instantiated fragment with embedded database definition\n");
+	if (!adapter) throw new Error("No adapter found in any of the fragment files");
+	return {
+		adapter,
+		databases: allDatabases
+	};
+}
+function isFragnoInstantiatedFragment(value) {
+	return typeof value === "object" && value !== null && instantiatedFragmentFakeSymbol in value && value[instantiatedFragmentFakeSymbol] === instantiatedFragmentFakeSymbol;
+}
+function additionalContextIsDatabaseContext(additionalContext) {
+	return typeof additionalContext === "object" && additionalContext !== null && "databaseSchema" in additionalContext && "databaseNamespace" in additionalContext && "databaseAdapter" in additionalContext;
+}
+/**
+* Finds all FragnoDatabase instances in a module, including those embedded
+* in instantiated fragments.
+*/
+function findFragnoDatabases(targetModule) {
+	const fragnoDatabases = [];
+	for (const [_key, value] of Object.entries(targetModule)) if (isFragnoDatabase(value)) fragnoDatabases.push(value);
+	else if (isFragnoInstantiatedFragment(value)) {
+		const additionalContext = value.additionalContext;
+		if (!additionalContext || !additionalContextIsDatabaseContext(additionalContext)) continue;
+		const { databaseSchema, databaseNamespace, databaseAdapter } = additionalContext;
+		fragnoDatabases.push(new FragnoDatabase({
+			namespace: databaseNamespace,
+			schema: databaseSchema,
+			adapter: databaseAdapter
+		}));
+	}
+	return fragnoDatabases;
+}
+
+//#endregion
+//#region src/commands/db/generate.ts
+const generateCommand = define({
+	name: "generate",
+	description: "Generate schema files from FragnoDatabase definitions",
+	args: {
+		output: {
+			type: "string",
+			short: "o",
+			description: "Output path: for single file, exact file path; for multiple files, output directory (default: current directory)"
+		},
+		from: {
+			type: "number",
+			short: "f",
+			description: "Source version to generate migration from (default: current database version)"
+		},
+		to: {
+			type: "number",
+			short: "t",
+			description: "Target version to generate migration to (default: latest schema version)"
+		},
+		prefix: {
+			type: "string",
+			short: "p",
+			description: "String to prepend to the generated file (e.g., '/* eslint-disable */')"
+		}
+	},
+	run: async (ctx) => {
+		const targets = ctx.positionals;
+		const output = ctx.values.output;
+		const toVersion = ctx.values.to;
+		const fromVersion = ctx.values.from;
+		const prefix = ctx.values.prefix;
+		const { databases: allFragnoDatabases, adapter } = await importFragmentFiles(targets.map((target) => resolve(process.cwd(), target)));
+		if (!adapter.createSchemaGenerator && !adapter.createMigrationEngine) throw new Error("The adapter does not support schema generation. Please use an adapter that implements either createSchemaGenerator or createMigrationEngine.");
+		console.log("Generating schema...");
+		let results;
+		try {
+			results = await generateMigrationsOrSchema(allFragnoDatabases, {
+				path: output,
+				toVersion,
+				fromVersion
+			});
+		} catch (error) {
+			throw new Error(`Failed to generate schema: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		for (const result of results) {
+			const finalOutputPath = output && results.length === 1 ? resolve(process.cwd(), output) : output ? resolve(process.cwd(), output, result.path) : resolve(process.cwd(), result.path);
+			const parentDir = dirname(finalOutputPath);
+			try {
+				await mkdir(parentDir, { recursive: true });
+			} catch (error) {
+				throw new Error(`Failed to create directory: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			try {
+				await writeFile(finalOutputPath, prefix ? `${prefix}\n${result.schema}` : result.schema, { encoding: "utf-8" });
+			} catch (error) {
+				throw new Error(`Failed to write schema file: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			console.log(`✓ Generated: ${finalOutputPath}`);
+		}
+		console.log(`\n✓ Schema generated successfully!`);
+		console.log(`  Files generated: ${results.length}`);
+		console.log(`  Fragments:`);
+		for (const db of allFragnoDatabases) console.log(`    - ${db.namespace} (version ${db.schema.version})`);
+	}
+});
+
+//#endregion
+//#region src/commands/db/migrate.ts
+const migrateCommand = define({
+	name: "migrate",
+	description: "Run database migrations for all fragments to their latest versions",
+	args: {},
+	run: async (ctx) => {
+		const targets = ctx.positionals;
+		if (targets.length === 0) throw new Error("At least one target file path is required");
+		const { databases: allFragnoDatabases } = await importFragmentFiles(targets.map((target) => resolve(process.cwd(), target)));
+		console.log("\nMigrating all fragments to their latest versions...\n");
+		let results;
+		try {
+			results = await executeMigrations(allFragnoDatabases);
+		} catch (error) {
+			throw new Error(`Migration failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		for (const result of results) {
+			console.log(`Fragment: ${result.namespace}`);
+			console.log(`  Current version: ${result.fromVersion}`);
+			console.log(`  Target version: ${result.toVersion}`);
+			if (result.didMigrate) console.log(`  ✓ Migration completed: v${result.fromVersion} → v${result.toVersion}\n`);
+			else console.log(`  ✓ Already at latest version. No migration needed.\n`);
+		}
+		console.log("═══════════════════════════════════════");
+		console.log("Migration Summary");
+		console.log("═══════════════════════════════════════");
+		const migrated = results.filter((r) => r.didMigrate);
+		const skipped = results.filter((r) => !r.didMigrate);
+		if (migrated.length > 0) {
+			console.log(`\n✓ Migrated ${migrated.length} fragment(s):`);
+			for (const r of migrated) console.log(`  - ${r.namespace}: v${r.fromVersion} → v${r.toVersion}`);
+		}
+		if (skipped.length > 0) {
+			console.log(`\n○ Skipped ${skipped.length} fragment(s) (already up-to-date):`);
+			for (const r of skipped) console.log(`  - ${r.namespace}: v${r.toVersion}`);
+		}
+		for (const db of allFragnoDatabases) await db.adapter.close();
+		console.log("\n✓ All migrations completed successfully");
+	}
+});
+
+//#endregion
+//#region src/commands/db/info.ts
+const infoCommand = define({
+	name: "info",
+	description: "Display database information and migration status",
+	args: {},
+	run: async (ctx) => {
+		const targets = ctx.positionals;
+		if (targets.length === 0) throw new Error("At least one target file path is required");
+		const { databases: allFragnoDatabases } = await importFragmentFiles(targets.map((target) => resolve(process.cwd(), target)));
+		const dbInfos = await Promise.all(allFragnoDatabases.map(async (fragnoDb) => {
+			const info = {
+				namespace: fragnoDb.namespace,
+				schemaVersion: fragnoDb.schema.version,
+				migrationSupport: !!fragnoDb.adapter.createMigrationEngine
+			};
+			if (fragnoDb.adapter.createMigrationEngine) try {
+				const currentVersion = await fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace).getVersion();
+				info.currentVersion = currentVersion;
+				info.pendingVersions = fragnoDb.schema.version - currentVersion;
+				if (info.pendingVersions > 0) info.status = `Pending (${info.pendingVersions} migration(s))`;
+				else if (info.pendingVersions === 0) info.status = "Up to date";
+			} catch (error) {
+				info.error = error instanceof Error ? error.message : String(error);
+				info.status = "Error";
+			}
+			else info.status = "Schema only";
+			return info;
+		}));
+		const hasMigrationSupport = dbInfos.some((info) => info.migrationSupport);
+		console.log("");
+		console.log(`Database Information:`);
+		console.log("");
+		const namespaceHeader = "Namespace";
+		const versionHeader = "Schema";
+		const currentHeader = "Current";
+		const statusHeader = "Status";
+		const maxNamespaceLen = Math.max(9, ...dbInfos.map((info) => info.namespace.length));
+		const namespaceWidth = Math.max(maxNamespaceLen + 2, 20);
+		const versionWidth = 8;
+		const currentWidth = 9;
+		const statusWidth = 25;
+		console.log(namespaceHeader.padEnd(namespaceWidth) + versionHeader.padEnd(versionWidth) + (hasMigrationSupport ? currentHeader.padEnd(currentWidth) : "") + statusHeader);
+		console.log("-".repeat(namespaceWidth) + "-".repeat(versionWidth) + (hasMigrationSupport ? "-".repeat(currentWidth) : "") + "-".repeat(statusWidth));
+		for (const info of dbInfos) {
+			const currentVersionStr = info.currentVersion !== void 0 ? String(info.currentVersion) : "-";
+			console.log(info.namespace.padEnd(namespaceWidth) + String(info.schemaVersion).padEnd(versionWidth) + (hasMigrationSupport ? currentVersionStr.padEnd(currentWidth) : "") + (info.status || "-"));
+		}
+		console.log("");
+		if (!hasMigrationSupport) {
+			console.log("Note: These adapters do not support migrations.");
+			console.log("Use 'fragno-cli db generate' to generate schema files.");
+		} else if (dbInfos.some((info) => info.pendingVersions && info.pendingVersions > 0)) console.log("Run 'fragno-cli db migrate <target>' to apply pending migrations.");
+	}
+});
+
+//#endregion
+//#region src/cli.ts
+const dbSubCommands = /* @__PURE__ */ new Map();
+dbSubCommands.set("generate", generateCommand);
+dbSubCommands.set("migrate", migrateCommand);
+dbSubCommands.set("info", infoCommand);
+function printDbHelp() {
+	console.log("Database management commands for Fragno");
+	console.log("");
+	console.log("Usage: fragno-cli db <command> [options]");
+	console.log("");
+	console.log("Commands:");
+	console.log("  generate    Generate schema files from FragnoDatabase definitions");
+	console.log("  migrate     Run database migrations");
+	console.log("  info        Display database information and migration status");
+	console.log("");
+	console.log("Run 'fragno-cli db <command> --help' for more information.");
+}
+const dbCommand = define({
+	name: "db",
+	description: "Database management commands",
+	run: printDbHelp
+});
+const rootSubCommands = /* @__PURE__ */ new Map();
+rootSubCommands.set("db", dbCommand);
+const mainCommand = define({
+	name: "fragno-cli",
+	description: "Fragno CLI - Tools for working with Fragno fragments",
+	run: () => {
+		console.log("Fragno CLI - Tools for working with Fragno fragments");
+		console.log("");
+		console.log("Usage: fragno-cli <command> [options]");
+		console.log("");
+		console.log("Commands:");
+		console.log("  db    Database management commands");
+		console.log("");
+		console.log("Run 'fragno-cli <command> --help' for more information.");
+	}
+});
+if (import.meta.main) try {
+	const args = process.argv.slice(2);
+	if (args[0] === "db" && args.length > 1) {
+		const subCommandName = args[1];
+		if (subCommandName === "--help" || subCommandName === "-h") {
+			printDbHelp();
+			process.exit(0);
+		}
+		const subCommand = dbSubCommands.get(subCommandName);
+		if (!subCommand) {
+			console.error(`Unknown command: ${subCommandName}`);
+			console.log("");
+			printDbHelp();
+			process.exit(1);
+		}
+		const subArgs = args.slice(2);
+		const isSubCommandHelp = subArgs.includes("--help") || subArgs.includes("-h");
+		let hasValidationError = false;
+		if (!isSubCommandHelp && subCommand.args) {
+			const tokens = parseArgs(subArgs);
+			hasValidationError = !!resolveArgs(subCommand.args, tokens).error;
+		}
+		await cli(subArgs, subCommand);
+		if (hasValidationError) process.exit(1);
+	} else if (args[0] === "db") printDbHelp();
+	else await cli(args, mainCommand, { subCommands: rootSubCommands });
+} catch (error) {
+	console.error("Error:", error instanceof Error ? error.message : error);
+	process.exit(1);
+}
+
+//#endregion
+export { dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":["allDatabases: FragnoDatabase<AnySchema>[]","adapter: DatabaseAdapter | undefined","firstAdapterFile: string | undefined","fragnoDatabases: FragnoDatabase<AnySchema>[]","results: { schema: string; path: string; namespace: string }[]","results: ExecuteMigrationResult[]","info: {\n          namespace: string;\n          schemaVersion: number;\n          migrationSupport: boolean;\n          currentVersion?: number;\n          pendingVersions?: number;\n          status?: string;\n          error?: string;\n        }"],"sources":["../src/utils/find-fragno-databases.ts","../src/commands/db/generate.ts","../src/commands/db/migrate.ts","../src/commands/db/info.ts","../src/cli.ts"],"sourcesContent":["import { isFragnoDatabase, type DatabaseAdapter, FragnoDatabase } from \"@fragno-dev/db\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"@fragno-dev/db/adapters\";\nimport type { AnySchema } from \"@fragno-dev/db/schema\";\nimport {\n  instantiatedFragmentFakeSymbol,\n  type FragnoInstantiatedFragment,\n} from \"@fragno-dev/core/api/fragment-instantiation\";\nimport { loadConfig } from \"c12\";\nimport { relative } from \"node:path\";\n\nexport async function importFragmentFile(path: string): Promise<Record<string, unknown>> {\n  const { config } = await loadConfig({\n    configFile: path,\n  });\n\n  const databases = findFragnoDatabases(config);\n  const adapterNames = databases.map(\n    (db) =>\n      `${db.adapter[fragnoDatabaseAdapterNameFakeSymbol]}@${db.adapter[fragnoDatabaseAdapterVersionFakeSymbol]}`,\n  );\n  const uniqueAdapterNames = [...new Set(adapterNames)];\n\n  if (uniqueAdapterNames.length > 1) {\n    throw new Error(\n      `All Fragno databases must use the same adapter name and version. ` +\n        `Found mismatch: (${adapterNames.join(\", \")})`,\n    );\n  }\n\n  return {\n    adapter: databases[0].adapter,\n    databases,\n  };\n}\n\n/**\n * Imports multiple fragment files and validates they all use the same adapter.\n * Returns the combined databases from all files.\n */\nexport async function importFragmentFiles(paths: string[]): Promise<{\n  adapter: DatabaseAdapter;\n  databases: FragnoDatabase<AnySchema>[];\n}> {\n  // De-duplicate paths (in case same file was specified multiple times)\n  const uniquePaths = Array.from(new Set(paths));\n\n  if (uniquePaths.length === 0) {\n    throw new Error(\"No fragment files provided\");\n  }\n\n  const allDatabases: FragnoDatabase<AnySchema>[] = [];\n  let adapter: DatabaseAdapter | undefined;\n  let firstAdapterFile: string | undefined;\n  const cwd = process.cwd();\n\n  for (const path of uniquePaths) {\n    const relativePath = relative(cwd, path);\n\n    try {\n      const result = await importFragmentFile(path);\n      const databases = result[\"databases\"] as FragnoDatabase<AnySchema>[];\n      const fileAdapter = result[\"adapter\"] as DatabaseAdapter;\n\n      if (databases.length === 0) {\n        console.warn(\n          `Warning: No FragnoDatabase instances found in ${relativePath}.\\n` +\n            `Make sure you export either:\\n` +\n            `  - A FragnoDatabase instance created with .create(adapter)\\n` +\n            `  - An instantiated fragment with embedded database definition\\n`,\n        );\n        continue;\n      }\n\n      // Set the adapter from the first file with databases\n      if (!adapter) {\n        adapter = fileAdapter;\n        firstAdapterFile = relativePath;\n      }\n\n      // Validate all files use the same adapter name and version\n      const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];\n      const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n      const fileAdapterName = fileAdapter[fragnoDatabaseAdapterNameFakeSymbol];\n      const fileAdapterVersion = fileAdapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n      if (firstAdapterName !== fileAdapterName || firstAdapterVersion !== fileAdapterVersion) {\n        const firstAdapterInfo = `${firstAdapterName}@${firstAdapterVersion}`;\n        const fileAdapterInfo = `${fileAdapterName}@${fileAdapterVersion}`;\n\n        throw new Error(\n          `All fragments must use the same database adapter. Mixed adapters found:\\n` +\n            `  - ${firstAdapterFile}: ${firstAdapterInfo}\\n` +\n            `  - ${relativePath}: ${fileAdapterInfo}\\n\\n` +\n            `Make sure all fragments use the same adapter name and version.`,\n        );\n      }\n\n      allDatabases.push(...databases);\n      console.log(`  Found ${databases.length} database(s) in ${relativePath}`);\n    } catch (error) {\n      throw new Error(\n        `Failed to import fragment file ${relativePath}: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n\n  if (allDatabases.length === 0) {\n    throw new Error(\n      `No FragnoDatabase instances found in any of the target files.\\n` +\n        `Make sure your files export either:\\n` +\n        `  - A FragnoDatabase instance created with .create(adapter)\\n` +\n        `  - An instantiated fragment with embedded database definition\\n`,\n    );\n  }\n\n  if (!adapter) {\n    throw new Error(\"No adapter found in any of the fragment files\");\n  }\n\n  return {\n    adapter,\n    databases: allDatabases,\n  };\n}\n\nfunction isFragnoInstantiatedFragment(\n  value: unknown,\n): value is FragnoInstantiatedFragment<[], {}, {}, {}> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    instantiatedFragmentFakeSymbol in value &&\n    value[instantiatedFragmentFakeSymbol] === instantiatedFragmentFakeSymbol\n  );\n}\n\nfunction additionalContextIsDatabaseContext(additionalContext: unknown): additionalContext is {\n  databaseSchema: AnySchema;\n  databaseNamespace: string;\n  databaseAdapter: DatabaseAdapter;\n} {\n  return (\n    typeof additionalContext === \"object\" &&\n    additionalContext !== null &&\n    \"databaseSchema\" in additionalContext &&\n    \"databaseNamespace\" in additionalContext &&\n    \"databaseAdapter\" in additionalContext\n  );\n}\n\n/**\n * Finds all FragnoDatabase instances in a module, including those embedded\n * in instantiated fragments.\n */\nexport function findFragnoDatabases(\n  targetModule: Record<string, unknown>,\n): FragnoDatabase<AnySchema>[] {\n  const fragnoDatabases: FragnoDatabase<AnySchema>[] = [];\n\n  for (const [_key, value] of Object.entries(targetModule)) {\n    if (isFragnoDatabase(value)) {\n      fragnoDatabases.push(value);\n    } else if (isFragnoInstantiatedFragment(value)) {\n      const additionalContext = value.additionalContext;\n\n      if (!additionalContext || !additionalContextIsDatabaseContext(additionalContext)) {\n        continue;\n      }\n\n      // Extract database schema, namespace, and adapter from instantiated fragment's additionalContext\n      const { databaseSchema, databaseNamespace, databaseAdapter } = additionalContext;\n\n      fragnoDatabases.push(\n        new FragnoDatabase({\n          namespace: databaseNamespace,\n          schema: databaseSchema,\n          adapter: databaseAdapter,\n        }),\n      );\n    }\n  }\n\n  return fragnoDatabases;\n}\n","import { writeFile, mkdir } from \"node:fs/promises\";\nimport { resolve, dirname } from \"node:path\";\nimport { define } from \"gunshi\";\nimport { generateMigrationsOrSchema } from \"@fragno-dev/db/generation-engine\";\nimport { importFragmentFiles } from \"../../utils/find-fragno-databases\";\n\n// Define the db generate command with type safety\nexport const generateCommand = define({\n  name: \"generate\",\n  description: \"Generate schema files from FragnoDatabase definitions\",\n  args: {\n    output: {\n      type: \"string\",\n      short: \"o\",\n      description:\n        \"Output path: for single file, exact file path; for multiple files, output directory (default: current directory)\",\n    },\n    from: {\n      type: \"number\",\n      short: \"f\",\n      description: \"Source version to generate migration from (default: current database version)\",\n    },\n    to: {\n      type: \"number\",\n      short: \"t\",\n      description: \"Target version to generate migration to (default: latest schema version)\",\n    },\n    prefix: {\n      type: \"string\",\n      short: \"p\",\n      description: \"String to prepend to the generated file (e.g., '/* eslint-disable */')\",\n    },\n  },\n  run: async (ctx) => {\n    // With `define()` and `multiple: true`, targets is properly typed as string[]\n    const targets = ctx.positionals;\n    const output = ctx.values.output;\n    const toVersion = ctx.values.to;\n    const fromVersion = ctx.values.from;\n    const prefix = ctx.values.prefix;\n\n    // Resolve all target paths\n    const targetPaths = targets.map((target) => resolve(process.cwd(), target));\n\n    // Import all fragment files and validate they use the same adapter\n    const { databases: allFragnoDatabases, adapter } = await importFragmentFiles(targetPaths);\n\n    // Check if adapter supports any form of schema generation\n    if (!adapter.createSchemaGenerator && !adapter.createMigrationEngine) {\n      throw new Error(\n        `The adapter does not support schema generation. ` +\n          `Please use an adapter that implements either createSchemaGenerator or createMigrationEngine.`,\n      );\n    }\n\n    // Generate schema for all fragments\n    console.log(\"Generating schema...\");\n\n    let results: { schema: string; path: string; namespace: string }[];\n    try {\n      results = await generateMigrationsOrSchema(allFragnoDatabases, {\n        path: output,\n        toVersion,\n        fromVersion,\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to generate schema: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n\n    // Write all generated files\n    for (const result of results) {\n      // For single file: use output as exact file path\n      // For multiple files: use output as base directory\n      const finalOutputPath =\n        output && results.length === 1\n          ? resolve(process.cwd(), output)\n          : output\n            ? resolve(process.cwd(), output, result.path)\n            : resolve(process.cwd(), result.path);\n\n      // Ensure parent directory exists\n      const parentDir = dirname(finalOutputPath);\n      try {\n        await mkdir(parentDir, { recursive: true });\n      } catch (error) {\n        throw new Error(\n          `Failed to create directory: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n\n      // Write schema to file\n      try {\n        const content = prefix ? `${prefix}\\n${result.schema}` : result.schema;\n        await writeFile(finalOutputPath, content, { encoding: \"utf-8\" });\n      } catch (error) {\n        throw new Error(\n          `Failed to write schema file: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n\n      console.log(`✓ Generated: ${finalOutputPath}`);\n    }\n\n    console.log(`\\n✓ Schema generated successfully!`);\n    console.log(`  Files generated: ${results.length}`);\n    console.log(`  Fragments:`);\n    for (const db of allFragnoDatabases) {\n      console.log(`    - ${db.namespace} (version ${db.schema.version})`);\n    }\n  },\n});\n","import { resolve } from \"node:path\";\nimport { define } from \"gunshi\";\nimport { importFragmentFiles } from \"../../utils/find-fragno-databases\";\nimport { executeMigrations, type ExecuteMigrationResult } from \"@fragno-dev/db/generation-engine\";\n\nexport const migrateCommand = define({\n  name: \"migrate\",\n  description: \"Run database migrations for all fragments to their latest versions\",\n  args: {},\n  run: async (ctx) => {\n    const targets = ctx.positionals;\n\n    if (targets.length === 0) {\n      throw new Error(\"At least one target file path is required\");\n    }\n\n    // Resolve all target paths\n    const targetPaths = targets.map((target) => resolve(process.cwd(), target));\n\n    // Import all fragment files and validate they use the same adapter\n    const { databases: allFragnoDatabases } = await importFragmentFiles(targetPaths);\n\n    console.log(\"\\nMigrating all fragments to their latest versions...\\n\");\n\n    let results: ExecuteMigrationResult[];\n    try {\n      results = await executeMigrations(allFragnoDatabases);\n    } catch (error) {\n      throw new Error(\n        `Migration failed: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n\n    // Display progress for each result\n    for (const result of results) {\n      console.log(`Fragment: ${result.namespace}`);\n      console.log(`  Current version: ${result.fromVersion}`);\n      console.log(`  Target version: ${result.toVersion}`);\n\n      if (result.didMigrate) {\n        console.log(`  ✓ Migration completed: v${result.fromVersion} → v${result.toVersion}\\n`);\n      } else {\n        console.log(`  ✓ Already at latest version. No migration needed.\\n`);\n      }\n    }\n\n    // Summary\n    console.log(\"═══════════════════════════════════════\");\n    console.log(\"Migration Summary\");\n    console.log(\"═══════════════════════════════════════\");\n\n    const migrated = results.filter((r) => r.didMigrate);\n    const skipped = results.filter((r) => !r.didMigrate);\n\n    if (migrated.length > 0) {\n      console.log(`\\n✓ Migrated ${migrated.length} fragment(s):`);\n      for (const r of migrated) {\n        console.log(`  - ${r.namespace}: v${r.fromVersion} → v${r.toVersion}`);\n      }\n    }\n\n    if (skipped.length > 0) {\n      console.log(`\\n○ Skipped ${skipped.length} fragment(s) (already up-to-date):`);\n      for (const r of skipped) {\n        console.log(`  - ${r.namespace}: v${r.toVersion}`);\n      }\n    }\n\n    for (const db of allFragnoDatabases) {\n      await db.adapter.close();\n    }\n\n    console.log(\"\\n✓ All migrations completed successfully\");\n  },\n});\n","import { resolve } from \"node:path\";\nimport { define } from \"gunshi\";\nimport { importFragmentFiles } from \"../../utils/find-fragno-databases\";\n\nexport const infoCommand = define({\n  name: \"info\",\n  description: \"Display database information and migration status\",\n  args: {},\n  run: async (ctx) => {\n    const targets = ctx.positionals;\n\n    if (targets.length === 0) {\n      throw new Error(\"At least one target file path is required\");\n    }\n\n    // Resolve all target paths\n    const targetPaths = targets.map((target) => resolve(process.cwd(), target));\n\n    // Import all fragment files\n    const { databases: allFragnoDatabases } = await importFragmentFiles(targetPaths);\n\n    // Collect database information\n    const dbInfos = await Promise.all(\n      allFragnoDatabases.map(async (fragnoDb) => {\n        const info: {\n          namespace: string;\n          schemaVersion: number;\n          migrationSupport: boolean;\n          currentVersion?: number;\n          pendingVersions?: number;\n          status?: string;\n          error?: string;\n        } = {\n          namespace: fragnoDb.namespace,\n          schemaVersion: fragnoDb.schema.version,\n          migrationSupport: !!fragnoDb.adapter.createMigrationEngine,\n        };\n\n        // Get current database version if migrations are supported\n        if (fragnoDb.adapter.createMigrationEngine) {\n          try {\n            const migrator = fragnoDb.adapter.createMigrationEngine(\n              fragnoDb.schema,\n              fragnoDb.namespace,\n            );\n            const currentVersion = await migrator.getVersion();\n            info.currentVersion = currentVersion;\n            info.pendingVersions = fragnoDb.schema.version - currentVersion;\n\n            if (info.pendingVersions > 0) {\n              info.status = `Pending (${info.pendingVersions} migration(s))`;\n            } else if (info.pendingVersions === 0) {\n              info.status = \"Up to date\";\n            }\n          } catch (error) {\n            info.error = error instanceof Error ? error.message : String(error);\n            info.status = \"Error\";\n          }\n        } else {\n          info.status = \"Schema only\";\n        }\n\n        return info;\n      }),\n    );\n\n    // Determine if any database supports migrations\n    const hasMigrationSupport = dbInfos.some((info) => info.migrationSupport);\n\n    // Print compact table\n    console.log(\"\");\n    console.log(`Database Information:`);\n    console.log(\"\");\n\n    // Table header\n    const namespaceHeader = \"Namespace\";\n    const versionHeader = \"Schema\";\n    const currentHeader = \"Current\";\n    const statusHeader = \"Status\";\n\n    const maxNamespaceLen = Math.max(\n      namespaceHeader.length,\n      ...dbInfos.map((info) => info.namespace.length),\n    );\n    const namespaceWidth = Math.max(maxNamespaceLen + 2, 20);\n    const versionWidth = 8;\n    const currentWidth = 9;\n    const statusWidth = 25;\n\n    // Print table\n    console.log(\n      namespaceHeader.padEnd(namespaceWidth) +\n        versionHeader.padEnd(versionWidth) +\n        (hasMigrationSupport ? currentHeader.padEnd(currentWidth) : \"\") +\n        statusHeader,\n    );\n    console.log(\n      \"-\".repeat(namespaceWidth) +\n        \"-\".repeat(versionWidth) +\n        (hasMigrationSupport ? \"-\".repeat(currentWidth) : \"\") +\n        \"-\".repeat(statusWidth),\n    );\n\n    for (const info of dbInfos) {\n      const currentVersionStr =\n        info.currentVersion !== undefined ? String(info.currentVersion) : \"-\";\n      console.log(\n        info.namespace.padEnd(namespaceWidth) +\n          String(info.schemaVersion).padEnd(versionWidth) +\n          (hasMigrationSupport ? currentVersionStr.padEnd(currentWidth) : \"\") +\n          (info.status || \"-\"),\n      );\n    }\n\n    // Print help text\n    console.log(\"\");\n    if (!hasMigrationSupport) {\n      console.log(\"Note: These adapters do not support migrations.\");\n      console.log(\"Use 'fragno-cli db generate' to generate schema files.\");\n    } else {\n      const hasPendingMigrations = dbInfos.some(\n        (info) => info.pendingVersions && info.pendingVersions > 0,\n      );\n      if (hasPendingMigrations) {\n        console.log(\"Run 'fragno-cli db migrate <target>' to apply pending migrations.\");\n      }\n    }\n  },\n});\n","#!/usr/bin/env node\n\nimport { cli, define, parseArgs, resolveArgs } from \"gunshi\";\nimport { generateCommand } from \"./commands/db/generate.js\";\nimport { migrateCommand } from \"./commands/db/migrate.js\";\nimport { infoCommand } from \"./commands/db/info.js\";\n\n// Create a Map of db sub-commands\nconst dbSubCommands = new Map();\ndbSubCommands.set(\"generate\", generateCommand);\ndbSubCommands.set(\"migrate\", migrateCommand);\ndbSubCommands.set(\"info\", infoCommand);\n\n// Helper function to print db command help\nfunction printDbHelp() {\n  console.log(\"Database management commands for Fragno\");\n  console.log(\"\");\n  console.log(\"Usage: fragno-cli db <command> [options]\");\n  console.log(\"\");\n  console.log(\"Commands:\");\n  console.log(\"  generate    Generate schema files from FragnoDatabase definitions\");\n  console.log(\"  migrate     Run database migrations\");\n  console.log(\"  info        Display database information and migration status\");\n  console.log(\"\");\n  console.log(\"Run 'fragno-cli db <command> --help' for more information.\");\n}\n\n// Define the db command with type safety\nexport const dbCommand = define({\n  name: \"db\",\n  description: \"Database management commands\",\n  run: printDbHelp,\n});\n\n// Create a Map of root sub-commands\nconst rootSubCommands = new Map();\nrootSubCommands.set(\"db\", dbCommand);\n\n// Define the main command with type safety\nexport const mainCommand = define({\n  name: \"fragno-cli\",\n  description: \"Fragno CLI - Tools for working with Fragno fragments\",\n  run: () => {\n    console.log(\"Fragno CLI - Tools for working with Fragno fragments\");\n    console.log(\"\");\n    console.log(\"Usage: fragno-cli <command> [options]\");\n    console.log(\"\");\n    console.log(\"Commands:\");\n    console.log(\"  db    Database management commands\");\n    console.log(\"\");\n    console.log(\"Run 'fragno-cli <command> --help' for more information.\");\n  },\n});\n\nif (import.meta.main) {\n  try {\n    // Parse arguments to handle nested subcommands\n    const args = process.argv.slice(2);\n\n    // Check if we're calling a db subcommand directly\n    if (args[0] === \"db\" && args.length > 1) {\n      const subCommandName = args[1];\n\n      // Check if it's a help request\n      if (subCommandName === \"--help\" || subCommandName === \"-h\") {\n        printDbHelp();\n        process.exit(0);\n      }\n\n      const subCommand = dbSubCommands.get(subCommandName);\n\n      if (!subCommand) {\n        console.error(`Unknown command: ${subCommandName}`);\n        console.log(\"\");\n        printDbHelp();\n        process.exit(1);\n      }\n\n      // Run the specific subcommand with its args\n      const subArgs = args.slice(2);\n      const isSubCommandHelp = subArgs.includes(\"--help\") || subArgs.includes(\"-h\");\n\n      // Check for validation errors before running\n      let hasValidationError = false;\n      if (!isSubCommandHelp && subCommand.args) {\n        const tokens = parseArgs(subArgs);\n        const resolved = resolveArgs(subCommand.args, tokens);\n        hasValidationError = !!resolved.error;\n      }\n\n      // Run the command (let gunshi handle printing errors/help)\n      await cli(subArgs, subCommand);\n\n      // Exit with error code if there was a validation error\n      if (hasValidationError) {\n        process.exit(1);\n      }\n    } else if (args[0] === \"db\") {\n      // \"db\" command with no subcommand - show db help\n      printDbHelp();\n    } else {\n      // Run the main CLI\n      await cli(args, mainCommand, {\n        subCommands: rootSubCommands,\n      });\n    }\n  } catch (error) {\n    console.error(\"Error:\", error instanceof Error ? error.message : error);\n    process.exit(1);\n  }\n}\n\nexport { generateCommand, migrateCommand, infoCommand };\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@fragno-dev/cli",
+  "version": "0.0.0-canary-18943940612-1-20251030142344",
+  "exports": {
+    ".": {
+      "development": "./src/cli.ts",
+      "types": "./dist/cli.d.ts",
+      "default": "./dist/cli.js"
+    }
+  },
+  "type": "module",
+  "bin": {
+    "fragno-cli": "./dist/cli.js"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "@fragno-private/typescript-config": "0.0.1",
+    "@fragno-private/vitest-config": "0.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "c12": "^3.3.1",
+    "gunshi": "^0.26.3",
+    "@fragno-dev/core": "0.1.5",
+    "@fragno-dev/db": "0.0.0-canary-18943940612-1-20251030142344"
+  },
+  "main": "./dist/cli.js",
+  "module": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "scripts": {
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "types:check": "tsc --noEmit"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+import { cli, define, parseArgs, resolveArgs } from "gunshi";
+import { generateCommand } from "./commands/db/generate.js";
+import { migrateCommand } from "./commands/db/migrate.js";
+import { infoCommand } from "./commands/db/info.js";
+
+// Create a Map of db sub-commands
+const dbSubCommands = new Map();
+dbSubCommands.set("generate", generateCommand);
+dbSubCommands.set("migrate", migrateCommand);
+dbSubCommands.set("info", infoCommand);
+
+// Helper function to print db command help
+function printDbHelp() {
+  console.log("Database management commands for Fragno");
+  console.log("");
+  console.log("Usage: fragno-cli db <command> [options]");
+  console.log("");
+  console.log("Commands:");
+  console.log("  generate    Generate schema files from FragnoDatabase definitions");
+  console.log("  migrate     Run database migrations");
+  console.log("  info        Display database information and migration status");
+  console.log("");
+  console.log("Run 'fragno-cli db <command> --help' for more information.");
+}
+
+// Define the db command with type safety
+export const dbCommand = define({
+  name: "db",
+  description: "Database management commands",
+  run: printDbHelp,
+});
+
+// Create a Map of root sub-commands
+const rootSubCommands = new Map();
+rootSubCommands.set("db", dbCommand);
+
+// Define the main command with type safety
+export const mainCommand = define({
+  name: "fragno-cli",
+  description: "Fragno CLI - Tools for working with Fragno fragments",
+  run: () => {
+    console.log("Fragno CLI - Tools for working with Fragno fragments");
+    console.log("");
+    console.log("Usage: fragno-cli <command> [options]");
+    console.log("");
+    console.log("Commands:");
+    console.log("  db    Database management commands");
+    console.log("");
+    console.log("Run 'fragno-cli <command> --help' for more information.");
+  },
+});
+
+if (import.meta.main) {
+  try {
+    // Parse arguments to handle nested subcommands
+    const args = process.argv.slice(2);
+
+    // Check if we're calling a db subcommand directly
+    if (args[0] === "db" && args.length > 1) {
+      const subCommandName = args[1];
+
+      // Check if it's a help request
+      if (subCommandName === "--help" || subCommandName === "-h") {
+        printDbHelp();
+        process.exit(0);
+      }
+
+      const subCommand = dbSubCommands.get(subCommandName);
+
+      if (!subCommand) {
+        console.error(`Unknown command: ${subCommandName}`);
+        console.log("");
+        printDbHelp();
+        process.exit(1);
+      }
+
+      // Run the specific subcommand with its args
+      const subArgs = args.slice(2);
+      const isSubCommandHelp = subArgs.includes("--help") || subArgs.includes("-h");
+
+      // Check for validation errors before running
+      let hasValidationError = false;
+      if (!isSubCommandHelp && subCommand.args) {
+        const tokens = parseArgs(subArgs);
+        const resolved = resolveArgs(subCommand.args, tokens);
+        hasValidationError = !!resolved.error;
+      }
+
+      // Run the command (let gunshi handle printing errors/help)
+      await cli(subArgs, subCommand);
+
+      // Exit with error code if there was a validation error
+      if (hasValidationError) {
+        process.exit(1);
+      }
+    } else if (args[0] === "db") {
+      // "db" command with no subcommand - show db help
+      printDbHelp();
+    } else {
+      // Run the main CLI
+      await cli(args, mainCommand, {
+        subCommands: rootSubCommands,
+      });
+    }
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+
+export { generateCommand, migrateCommand, infoCommand };

package/src/commands/db/generate.ts

@@ -0,0 +1,113 @@
+import { writeFile, mkdir } from "node:fs/promises";
+import { resolve, dirname } from "node:path";
+import { define } from "gunshi";
+import { generateMigrationsOrSchema } from "@fragno-dev/db/generation-engine";
+import { importFragmentFiles } from "../../utils/find-fragno-databases";
+
+// Define the db generate command with type safety
+export const generateCommand = define({
+  name: "generate",
+  description: "Generate schema files from FragnoDatabase definitions",
+  args: {
+    output: {
+      type: "string",
+      short: "o",
+      description:
+        "Output path: for single file, exact file path; for multiple files, output directory (default: current directory)",
+    },
+    from: {
+      type: "number",
+      short: "f",
+      description: "Source version to generate migration from (default: current database version)",
+    },
+    to: {
+      type: "number",
+      short: "t",
+      description: "Target version to generate migration to (default: latest schema version)",
+    },
+    prefix: {
+      type: "string",
+      short: "p",
+      description: "String to prepend to the generated file (e.g., '/* eslint-disable */')",
+    },
+  },
+  run: async (ctx) => {
+    // With `define()` and `multiple: true`, targets is properly typed as string[]
+    const targets = ctx.positionals;
+    const output = ctx.values.output;
+    const toVersion = ctx.values.to;
+    const fromVersion = ctx.values.from;
+    const prefix = ctx.values.prefix;
+
+    // Resolve all target paths
+    const targetPaths = targets.map((target) => resolve(process.cwd(), target));
+
+    // Import all fragment files and validate they use the same adapter
+    const { databases: allFragnoDatabases, adapter } = await importFragmentFiles(targetPaths);
+
+    // Check if adapter supports any form of schema generation
+    if (!adapter.createSchemaGenerator && !adapter.createMigrationEngine) {
+      throw new Error(
+        `The adapter does not support schema generation. ` +
+          `Please use an adapter that implements either createSchemaGenerator or createMigrationEngine.`,
+      );
+    }
+
+    // Generate schema for all fragments
+    console.log("Generating schema...");
+
+    let results: { schema: string; path: string; namespace: string }[];
+    try {
+      results = await generateMigrationsOrSchema(allFragnoDatabases, {
+        path: output,
+        toVersion,
+        fromVersion,
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to generate schema: ${error instanceof Error ? error.message : String(error)}`,
+      );
+    }
+
+    // Write all generated files
+    for (const result of results) {
+      // For single file: use output as exact file path
+      // For multiple files: use output as base directory
+      const finalOutputPath =
+        output && results.length === 1
+          ? resolve(process.cwd(), output)
+          : output
+            ? resolve(process.cwd(), output, result.path)
+            : resolve(process.cwd(), result.path);
+
+      // Ensure parent directory exists
+      const parentDir = dirname(finalOutputPath);
+      try {
+        await mkdir(parentDir, { recursive: true });
+      } catch (error) {
+        throw new Error(
+          `Failed to create directory: ${error instanceof Error ? error.message : String(error)}`,
+        );
+      }
+
+      // Write schema to file
+      try {
+        const content = prefix ? `${prefix}\n${result.schema}` : result.schema;
+        await writeFile(finalOutputPath, content, { encoding: "utf-8" });
+      } catch (error) {
+        throw new Error(
+          `Failed to write schema file: ${error instanceof Error ? error.message : String(error)}`,
+        );
+      }
+
+      console.log(`✓ Generated: ${finalOutputPath}`);
+    }
+
+    console.log(`\n✓ Schema generated successfully!`);
+    console.log(`  Files generated: ${results.length}`);
+    console.log(`  Fragments:`);
+    for (const db of allFragnoDatabases) {
+      console.log(`    - ${db.namespace} (version ${db.schema.version})`);
+    }
+  },
+});

package/src/commands/db/info.ts

@@ -0,0 +1,129 @@
+import { resolve } from "node:path";
+import { define } from "gunshi";
+import { importFragmentFiles } from "../../utils/find-fragno-databases";
+
+export const infoCommand = define({
+  name: "info",
+  description: "Display database information and migration status",
+  args: {},
+  run: async (ctx) => {
+    const targets = ctx.positionals;
+
+    if (targets.length === 0) {
+      throw new Error("At least one target file path is required");
+    }
+
+    // Resolve all target paths
+    const targetPaths = targets.map((target) => resolve(process.cwd(), target));
+
+    // Import all fragment files
+    const { databases: allFragnoDatabases } = await importFragmentFiles(targetPaths);
+
+    // Collect database information
+    const dbInfos = await Promise.all(
+      allFragnoDatabases.map(async (fragnoDb) => {
+        const info: {
+          namespace: string;
+          schemaVersion: number;
+          migrationSupport: boolean;
+          currentVersion?: number;
+          pendingVersions?: number;
+          status?: string;
+          error?: string;
+        } = {
+          namespace: fragnoDb.namespace,
+          schemaVersion: fragnoDb.schema.version,
+          migrationSupport: !!fragnoDb.adapter.createMigrationEngine,
+        };
+
+        // Get current database version if migrations are supported
+        if (fragnoDb.adapter.createMigrationEngine) {
+          try {
+            const migrator = fragnoDb.adapter.createMigrationEngine(
+              fragnoDb.schema,
+              fragnoDb.namespace,
+            );
+            const currentVersion = await migrator.getVersion();
+            info.currentVersion = currentVersion;
+            info.pendingVersions = fragnoDb.schema.version - currentVersion;
+
+            if (info.pendingVersions > 0) {
+              info.status = `Pending (${info.pendingVersions} migration(s))`;
+            } else if (info.pendingVersions === 0) {
+              info.status = "Up to date";
+            }
+          } catch (error) {
+            info.error = error instanceof Error ? error.message : String(error);
+            info.status = "Error";
+          }
+        } else {
+          info.status = "Schema only";
+        }
+
+        return info;
+      }),
+    );
+
+    // Determine if any database supports migrations
+    const hasMigrationSupport = dbInfos.some((info) => info.migrationSupport);
+
+    // Print compact table
+    console.log("");
+    console.log(`Database Information:`);
+    console.log("");
+
+    // Table header
+    const namespaceHeader = "Namespace";
+    const versionHeader = "Schema";
+    const currentHeader = "Current";
+    const statusHeader = "Status";
+
+    const maxNamespaceLen = Math.max(
+      namespaceHeader.length,
+      ...dbInfos.map((info) => info.namespace.length),
+    );
+    const namespaceWidth = Math.max(maxNamespaceLen + 2, 20);
+    const versionWidth = 8;
+    const currentWidth = 9;
+    const statusWidth = 25;
+
+    // Print table
+    console.log(
+      namespaceHeader.padEnd(namespaceWidth) +
+        versionHeader.padEnd(versionWidth) +
+        (hasMigrationSupport ? currentHeader.padEnd(currentWidth) : "") +
+        statusHeader,
+    );
+    console.log(
+      "-".repeat(namespaceWidth) +
+        "-".repeat(versionWidth) +
+        (hasMigrationSupport ? "-".repeat(currentWidth) : "") +
+        "-".repeat(statusWidth),
+    );
+
+    for (const info of dbInfos) {
+      const currentVersionStr =
+        info.currentVersion !== undefined ? String(info.currentVersion) : "-";
+      console.log(
+        info.namespace.padEnd(namespaceWidth) +
+          String(info.schemaVersion).padEnd(versionWidth) +
+          (hasMigrationSupport ? currentVersionStr.padEnd(currentWidth) : "") +
+          (info.status || "-"),
+      );
+    }
+
+    // Print help text
+    console.log("");
+    if (!hasMigrationSupport) {
+      console.log("Note: These adapters do not support migrations.");
+      console.log("Use 'fragno-cli db generate' to generate schema files.");
+    } else {
+      const hasPendingMigrations = dbInfos.some(
+        (info) => info.pendingVersions && info.pendingVersions > 0,
+      );
+      if (hasPendingMigrations) {
+        console.log("Run 'fragno-cli db migrate <target>' to apply pending migrations.");
+      }
+    }
+  },
+});

package/src/commands/db/migrate.ts

@@ -0,0 +1,75 @@
+import { resolve } from "node:path";
+import { define } from "gunshi";
+import { importFragmentFiles } from "../../utils/find-fragno-databases";
+import { executeMigrations, type ExecuteMigrationResult } from "@fragno-dev/db/generation-engine";
+
+export const migrateCommand = define({
+  name: "migrate",
+  description: "Run database migrations for all fragments to their latest versions",
+  args: {},
+  run: async (ctx) => {
+    const targets = ctx.positionals;
+
+    if (targets.length === 0) {
+      throw new Error("At least one target file path is required");
+    }
+
+    // Resolve all target paths
+    const targetPaths = targets.map((target) => resolve(process.cwd(), target));
+
+    // Import all fragment files and validate they use the same adapter
+    const { databases: allFragnoDatabases } = await importFragmentFiles(targetPaths);
+
+    console.log("\nMigrating all fragments to their latest versions...\n");
+
+    let results: ExecuteMigrationResult[];
+    try {
+      results = await executeMigrations(allFragnoDatabases);
+    } catch (error) {
+      throw new Error(
+        `Migration failed: ${error instanceof Error ? error.message : String(error)}`,
+      );
+    }
+
+    // Display progress for each result
+    for (const result of results) {
+      console.log(`Fragment: ${result.namespace}`);
+      console.log(`  Current version: ${result.fromVersion}`);
+      console.log(`  Target version: ${result.toVersion}`);
+
+      if (result.didMigrate) {
+        console.log(`  ✓ Migration completed: v${result.fromVersion} → v${result.toVersion}\n`);
+      } else {
+        console.log(`  ✓ Already at latest version. No migration needed.\n`);
+      }
+    }
+
+    // Summary
+    console.log("═══════════════════════════════════════");
+    console.log("Migration Summary");
+    console.log("═══════════════════════════════════════");
+
+    const migrated = results.filter((r) => r.didMigrate);
+    const skipped = results.filter((r) => !r.didMigrate);
+
+    if (migrated.length > 0) {
+      console.log(`\n✓ Migrated ${migrated.length} fragment(s):`);
+      for (const r of migrated) {
+        console.log(`  - ${r.namespace}: v${r.fromVersion} → v${r.toVersion}`);
+      }
+    }
+
+    if (skipped.length > 0) {
+      console.log(`\n○ Skipped ${skipped.length} fragment(s) (already up-to-date):`);
+      for (const r of skipped) {
+        console.log(`  - ${r.namespace}: v${r.toVersion}`);
+      }
+    }
+
+    for (const db of allFragnoDatabases) {
+      await db.adapter.close();
+    }
+
+    console.log("\n✓ All migrations completed successfully");
+  },
+});

package/src/utils/find-fragno-databases.ts

@@ -0,0 +1,187 @@
+import { isFragnoDatabase, type DatabaseAdapter, FragnoDatabase } from "@fragno-dev/db";
+import {
+  fragnoDatabaseAdapterNameFakeSymbol,
+  fragnoDatabaseAdapterVersionFakeSymbol,
+} from "@fragno-dev/db/adapters";
+import type { AnySchema } from "@fragno-dev/db/schema";
+import {
+  instantiatedFragmentFakeSymbol,
+  type FragnoInstantiatedFragment,
+} from "@fragno-dev/core/api/fragment-instantiation";
+import { loadConfig } from "c12";
+import { relative } from "node:path";
+
+export async function importFragmentFile(path: string): Promise<Record<string, unknown>> {
+  const { config } = await loadConfig({
+    configFile: path,
+  });
+
+  const databases = findFragnoDatabases(config);
+  const adapterNames = databases.map(
+    (db) =>
+      `${db.adapter[fragnoDatabaseAdapterNameFakeSymbol]}@${db.adapter[fragnoDatabaseAdapterVersionFakeSymbol]}`,
+  );
+  const uniqueAdapterNames = [...new Set(adapterNames)];
+
+  if (uniqueAdapterNames.length > 1) {
+    throw new Error(
+      `All Fragno databases must use the same adapter name and version. ` +
+        `Found mismatch: (${adapterNames.join(", ")})`,
+    );
+  }
+
+  return {
+    adapter: databases[0].adapter,
+    databases,
+  };
+}
+
+/**
+ * Imports multiple fragment files and validates they all use the same adapter.
+ * Returns the combined databases from all files.
+ */
+export async function importFragmentFiles(paths: string[]): Promise<{
+  adapter: DatabaseAdapter;
+  databases: FragnoDatabase<AnySchema>[];
+}> {
+  // De-duplicate paths (in case same file was specified multiple times)
+  const uniquePaths = Array.from(new Set(paths));
+
+  if (uniquePaths.length === 0) {
+    throw new Error("No fragment files provided");
+  }
+
+  const allDatabases: FragnoDatabase<AnySchema>[] = [];
+  let adapter: DatabaseAdapter | undefined;
+  let firstAdapterFile: string | undefined;
+  const cwd = process.cwd();
+
+  for (const path of uniquePaths) {
+    const relativePath = relative(cwd, path);
+
+    try {
+      const result = await importFragmentFile(path);
+      const databases = result["databases"] as FragnoDatabase<AnySchema>[];
+      const fileAdapter = result["adapter"] as DatabaseAdapter;
+
+      if (databases.length === 0) {
+        console.warn(
+          `Warning: No FragnoDatabase instances found in ${relativePath}.\n` +
+            `Make sure you export either:\n` +
+            `  - A FragnoDatabase instance created with .create(adapter)\n` +
+            `  - An instantiated fragment with embedded database definition\n`,
+        );
+        continue;
+      }
+
+      // Set the adapter from the first file with databases
+      if (!adapter) {
+        adapter = fileAdapter;
+        firstAdapterFile = relativePath;
+      }
+
+      // Validate all files use the same adapter name and version
+      const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];
+      const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];
+      const fileAdapterName = fileAdapter[fragnoDatabaseAdapterNameFakeSymbol];
+      const fileAdapterVersion = fileAdapter[fragnoDatabaseAdapterVersionFakeSymbol];
+
+      if (firstAdapterName !== fileAdapterName || firstAdapterVersion !== fileAdapterVersion) {
+        const firstAdapterInfo = `${firstAdapterName}@${firstAdapterVersion}`;
+        const fileAdapterInfo = `${fileAdapterName}@${fileAdapterVersion}`;
+
+        throw new Error(
+          `All fragments must use the same database adapter. Mixed adapters found:\n` +
+            `  - ${firstAdapterFile}: ${firstAdapterInfo}\n` +
+            `  - ${relativePath}: ${fileAdapterInfo}\n\n` +
+            `Make sure all fragments use the same adapter name and version.`,
+        );
+      }
+
+      allDatabases.push(...databases);
+      console.log(`  Found ${databases.length} database(s) in ${relativePath}`);
+    } catch (error) {
+      throw new Error(
+        `Failed to import fragment file ${relativePath}: ${error instanceof Error ? error.message : String(error)}`,
+      );
+    }
+  }
+
+  if (allDatabases.length === 0) {
+    throw new Error(
+      `No FragnoDatabase instances found in any of the target files.\n` +
+        `Make sure your files export either:\n` +
+        `  - A FragnoDatabase instance created with .create(adapter)\n` +
+        `  - An instantiated fragment with embedded database definition\n`,
+    );
+  }
+
+  if (!adapter) {
+    throw new Error("No adapter found in any of the fragment files");
+  }
+
+  return {
+    adapter,
+    databases: allDatabases,
+  };
+}
+
+function isFragnoInstantiatedFragment(
+  value: unknown,
+): value is FragnoInstantiatedFragment<[], {}, {}, {}> {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    instantiatedFragmentFakeSymbol in value &&
+    value[instantiatedFragmentFakeSymbol] === instantiatedFragmentFakeSymbol
+  );
+}
+
+function additionalContextIsDatabaseContext(additionalContext: unknown): additionalContext is {
+  databaseSchema: AnySchema;
+  databaseNamespace: string;
+  databaseAdapter: DatabaseAdapter;
+} {
+  return (
+    typeof additionalContext === "object" &&
+    additionalContext !== null &&
+    "databaseSchema" in additionalContext &&
+    "databaseNamespace" in additionalContext &&
+    "databaseAdapter" in additionalContext
+  );
+}
+
+/**
+ * Finds all FragnoDatabase instances in a module, including those embedded
+ * in instantiated fragments.
+ */
+export function findFragnoDatabases(
+  targetModule: Record<string, unknown>,
+): FragnoDatabase<AnySchema>[] {
+  const fragnoDatabases: FragnoDatabase<AnySchema>[] = [];
+
+  for (const [_key, value] of Object.entries(targetModule)) {
+    if (isFragnoDatabase(value)) {
+      fragnoDatabases.push(value);
+    } else if (isFragnoInstantiatedFragment(value)) {
+      const additionalContext = value.additionalContext;
+
+      if (!additionalContext || !additionalContextIsDatabaseContext(additionalContext)) {
+        continue;
+      }
+
+      // Extract database schema, namespace, and adapter from instantiated fragment's additionalContext
+      const { databaseSchema, databaseNamespace, databaseAdapter } = additionalContext;
+
+      fragnoDatabases.push(
+        new FragnoDatabase({
+          namespace: databaseNamespace,
+          schema: databaseSchema,
+          adapter: databaseAdapter,
+        }),
+      );
+    }
+  }
+
+  return fragnoDatabases;
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@fragno-private/typescript-config/tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "composite": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsdown.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: "./src/cli.ts",
+  dts: true,
+});

package/vitest.config.ts

@@ -0,0 +1,4 @@
+import { defineConfig } from "vitest/config";
+import { baseConfig } from "@fragno-private/vitest-config";
+
+export default defineConfig(baseConfig);