@fragno-dev/cli 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,15 @@
+$ tsdown
+ℹ tsdown v0.15.9 powered by rolldown v1.0.0-beta.44
+ℹ Using tsdown config: /home/runner/work/fragno/fragno/apps/fragno-cli/tsdown.config.ts
+ℹ entry: src/cli.ts
+ℹ target: node20.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        16.07 kB │ gzip: 3.50 kB
+ℹ dist/cli.js.map    30.92 kB │ gzip: 6.79 kB
+ℹ dist/cli.d.ts.map   0.23 kB │ gzip: 0.19 kB
+ℹ dist/cli.d.ts       0.39 kB │ gzip: 0.19 kB
+ℹ 4 files, total: 47.61 kB
+✔ Build complete in 8325ms

package/.turbo/turbo-types$colon$check.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @fragno-dev/cli
+
+## 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/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { Command } from "gunshi";
+
+//#region src/cli.d.ts
+declare const generateCommand: Command;
+declare const migrateCommand: Command;
+declare const infoCommand: Command;
+declare const dbCommand: Command;
+declare const mainCommand: Command;
+//#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/cli.ts"],"sourcesContent":[],"mappings":";;;;cAQa,iBAAiB;cAkCjB,gBAAgB;AAlChB,cAyDA,WA1BZ,EA0ByB,OA1BzB;AAGY,cAwDA,SApCZ,EAoCuB,OAxDK;AAuBhB,cA4CA,WA5Ca,EA4CA,OAlCzB"}

package/dist/cli.js

@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+import { cli, parseArgs, resolveArgs } from "gunshi";
+import { mkdir, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { FragnoDatabase, isFragnoDatabase } from "@fragno-dev/db";
+import { instantiatedFragmentFakeSymbol } from "@fragno-dev/core/api/fragment-instantiation";
+
+//#region src/utils/find-fragno-databases.ts
+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);
+		console.log(`Found FragnoDatabase instance: ${key}`);
+	} else if (isFragnoInstantiatedFragment(value)) {
+		const additionalContext = value.additionalContext;
+		if (!additionalContext || !additionalContextIsDatabaseContext(additionalContext)) {
+			console.warn(`Instantiated fragment ${key} has no database context`);
+			continue;
+		}
+		const { databaseSchema, databaseNamespace, databaseAdapter } = additionalContext;
+		fragnoDatabases.push(new FragnoDatabase({
+			namespace: databaseNamespace,
+			schema: databaseSchema,
+			adapter: databaseAdapter
+		}));
+		console.log(`Found database context in instantiated fragment: ${key}`);
+	}
+	return fragnoDatabases;
+}
+
+//#endregion
+//#region src/commands/db/generate.ts
+async function generate(ctx) {
+	const target = ctx.values["target"];
+	const output = ctx.values["output"];
+	const toVersion = ctx.values["to"];
+	const fromVersion = ctx.values["from"];
+	const prefix = ctx.values["prefix"];
+	if (!target || typeof target !== "string") throw new Error("Target file path is required and must be a string");
+	if (typeof output === "number" || typeof output === "boolean") throw new Error("Output file path is required and must be a string");
+	if (toVersion !== void 0 && typeof toVersion !== "string" && typeof toVersion !== "number") throw new Error("Version must be a number or string");
+	if (fromVersion !== void 0 && typeof fromVersion !== "string" && typeof fromVersion !== "number") throw new Error("Version must be a number or string");
+	if (prefix !== void 0 && typeof prefix !== "string") throw new Error("Prefix must be a string");
+	const targetPath = resolve(process.cwd(), target);
+	console.log(`Loading target file: ${targetPath}`);
+	let targetModule;
+	try {
+		targetModule = await import(targetPath);
+	} catch (error) {
+		throw new Error(`Failed to import target file: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const fragnoDatabases = findFragnoDatabases(targetModule);
+	if (fragnoDatabases.length === 0) throw new Error(`No FragnoDatabase instances found in ${target}.\nMake sure you export either:\n  - A FragnoDatabase instance created with .create(adapter)\n  - An instantiated fragment with embedded database definition\n`);
+	if (fragnoDatabases.length > 1) console.warn(`Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`);
+	const fragnoDb = fragnoDatabases[0];
+	const targetVersion = toVersion !== void 0 ? parseInt(String(toVersion), 10) : void 0;
+	const sourceVersion = fromVersion !== void 0 ? parseInt(String(fromVersion), 10) : void 0;
+	if (targetVersion !== void 0 && isNaN(targetVersion)) throw new Error(`Invalid version number: ${toVersion}`);
+	if (sourceVersion !== void 0 && isNaN(sourceVersion)) throw new Error(`Invalid version number: ${fromVersion}`);
+	if (sourceVersion !== void 0 && targetVersion !== void 0) console.log(`Generating schema for namespace: ${fragnoDb.namespace} (from version ${sourceVersion} to version ${targetVersion})`);
+	else if (targetVersion !== void 0) console.log(`Generating schema for namespace: ${fragnoDb.namespace} (to version ${targetVersion})`);
+	else if (sourceVersion !== void 0) console.log(`Generating schema for namespace: ${fragnoDb.namespace} (from version ${sourceVersion})`);
+	else console.log(`Generating schema for namespace: ${fragnoDb.namespace}`);
+	let isDirectory = false;
+	if (output) {
+		const resolvedOutput = resolve(process.cwd(), output);
+		try {
+			isDirectory = (await stat(resolvedOutput)).isDirectory();
+		} catch {
+			isDirectory = output.endsWith("/");
+		}
+	}
+	let result;
+	try {
+		result = await fragnoDb.generateSchema({
+			path: isDirectory ? void 0 : output,
+			toVersion: targetVersion,
+			fromVersion: sourceVersion
+		});
+	} catch (error) {
+		throw new Error(`Failed to generate schema: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	let finalOutputPath;
+	if (isDirectory && output) finalOutputPath = join(resolve(process.cwd(), output), basename(result.path));
+	else if (output) finalOutputPath = resolve(process.cwd(), output);
+	else finalOutputPath = 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 {
+		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(`✓ Schema generated successfully: ${finalOutputPath}`);
+	console.log(`  Namespace: ${fragnoDb.namespace}`);
+	console.log(`  Schema version: ${fragnoDb.schema.version}`);
+}
+
+//#endregion
+//#region src/commands/db/migrate.ts
+async function migrate(ctx) {
+	const target = ctx.values["target"];
+	const version = ctx.values["to"];
+	const fromVersion = ctx.values["from"];
+	if (!target || typeof target !== "string") throw new Error("Target file path is required and must be a string");
+	if (version !== void 0 && typeof version !== "string" && typeof version !== "number") throw new Error("Version must be a number or string");
+	if (fromVersion !== void 0 && typeof fromVersion !== "string" && typeof fromVersion !== "number") throw new Error("Version must be a number or string");
+	const targetPath = resolve(process.cwd(), target);
+	console.log(`Loading target file: ${targetPath}`);
+	let targetModule;
+	try {
+		targetModule = await import(targetPath);
+	} catch (error) {
+		throw new Error(`Failed to import target file: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const fragnoDatabases = findFragnoDatabases(targetModule);
+	if (fragnoDatabases.length === 0) throw new Error(`No FragnoDatabase instances found in ${target}.\nMake sure you export either:\n  - A FragnoDatabase instance created with .create(adapter)\n  - An instantiated fragment with embedded database definition\n`);
+	if (fragnoDatabases.length > 1) console.warn(`Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`);
+	const fragnoDb = fragnoDatabases[0];
+	console.log(`Migrating database for namespace: ${fragnoDb.namespace}`);
+	if (!fragnoDb.adapter.createMigrationEngine) throw new Error("Adapter does not support running migrations. The adapter only supports schema generation.\nTry using 'fragno db generate' instead to generate schema files.");
+	const targetVersion = version !== void 0 ? parseInt(String(version), 10) : void 0;
+	const expectedFromVersion = fromVersion !== void 0 ? parseInt(String(fromVersion), 10) : void 0;
+	if (targetVersion !== void 0 && isNaN(targetVersion)) throw new Error(`Invalid version number: ${version}`);
+	if (expectedFromVersion !== void 0 && isNaN(expectedFromVersion)) throw new Error(`Invalid version number: ${fromVersion}`);
+	let didMigrate;
+	try {
+		if (targetVersion !== void 0) {
+			console.log(`Migrating to version ${targetVersion}...`);
+			const migrator = fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);
+			const currentVersion = await migrator.getVersion();
+			console.log(`Current version: ${currentVersion}`);
+			if (expectedFromVersion !== void 0 && currentVersion !== expectedFromVersion) throw new Error(`Current database version (${currentVersion}) does not match expected --from version (${expectedFromVersion})`);
+			const preparedMigration = await migrator.prepareMigrationTo(targetVersion, { updateSettings: true });
+			if (preparedMigration.operations.length === 0) {
+				console.log("✓ Database is already at the target version. No migrations needed.");
+				didMigrate = false;
+			} else {
+				await preparedMigration.execute();
+				didMigrate = true;
+			}
+		} else {
+			console.log(`Migrating to latest version (${fragnoDb.schema.version})...`);
+			didMigrate = await fragnoDb.runMigrations();
+		}
+	} catch (error) {
+		throw new Error(`Failed to run migrations: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (didMigrate) {
+		console.log(`✓ Migration completed successfully`);
+		console.log(`  Namespace: ${fragnoDb.namespace}`);
+		if (targetVersion !== void 0) console.log(`  New version: ${targetVersion}`);
+		else console.log(`  New version: ${fragnoDb.schema.version}`);
+	}
+}
+
+//#endregion
+//#region src/commands/db/info.ts
+async function info(ctx) {
+	const target = ctx.values["target"];
+	if (!target || typeof target !== "string") throw new Error("Target file path is required and must be a string");
+	const targetPath = resolve(process.cwd(), target);
+	console.log(`Loading target file: ${targetPath}`);
+	let targetModule;
+	try {
+		targetModule = await import(targetPath);
+	} catch (error) {
+		throw new Error(`Failed to import target file: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const fragnoDatabases = [];
+	for (const [key, value] of Object.entries(targetModule)) if (isFragnoDatabase(value)) {
+		fragnoDatabases.push(value);
+		console.log(`Found FragnoDatabase instance: ${key}`);
+	}
+	if (fragnoDatabases.length === 0) throw new Error(`No FragnoDatabase instances found in ${target}.\n`);
+	if (fragnoDatabases.length > 1) console.warn(`Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`);
+	const fragnoDb = fragnoDatabases[0];
+	console.log("");
+	console.log("Database Information");
+	console.log("=".repeat(50));
+	console.log(`Namespace: ${fragnoDb.namespace}`);
+	console.log(`Latest Schema Version: ${fragnoDb.schema.version}`);
+	if (!fragnoDb.adapter.createMigrationEngine) {
+		console.log(`Migration Support: No`);
+		console.log("");
+		console.log("Note: This adapter does not support running migrations.");
+		console.log("Use 'fragno db generate' to generate schema files.");
+		return;
+	}
+	console.log(`Migration Support: Yes`);
+	try {
+		const currentVersion = await fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace).getVersion();
+		console.log(`Current Database Version: ${currentVersion}`);
+		const pendingVersions = fragnoDb.schema.version - currentVersion;
+		if (pendingVersions > 0) {
+			console.log("");
+			console.log(`⚠ Pending Migrations: ${pendingVersions} version(s) behind`);
+			console.log(`  Run '@fragno-dev/cli db migrate --target ${target}' to update`);
+		} else if (pendingVersions === 0) {
+			console.log("");
+			console.log(`✓ Database is up to date`);
+		}
+	} catch (error) {
+		console.log("");
+		console.log(`Warning: Could not retrieve current version: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	console.log("=".repeat(50));
+}
+
+//#endregion
+//#region src/cli.ts
+const generateCommand = {
+	name: "generate",
+	description: "Generate schema files from FragnoDatabase definitions",
+	args: {
+		target: {
+			type: "positional",
+			description: "Path to the file that exports a FragnoDatabase instance"
+		},
+		output: {
+			type: "string",
+			short: "o",
+			description: "Output path for the generated schema file (default: schema.sql for Kysely, schema.ts for Drizzle)"
+		},
+		from: {
+			type: "string",
+			short: "f",
+			description: "Source version to generate migration from (default: current database version)"
+		},
+		to: {
+			type: "string",
+			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: generate
+};
+const migrateCommand = {
+	name: "migrate",
+	description: "Run database migrations",
+	args: {
+		target: {
+			type: "positional",
+			description: "Path to the file that exports a FragnoDatabase instance"
+		},
+		from: {
+			type: "string",
+			short: "f",
+			description: "Expected current database version (validates before migrating)"
+		},
+		to: {
+			type: "string",
+			short: "t",
+			description: "Target version to migrate to (default: latest schema version)"
+		}
+	},
+	run: migrate
+};
+const infoCommand = {
+	name: "info",
+	description: "Display database information and migration status",
+	args: { target: {
+		type: "positional",
+		description: "Path to the file that exports a FragnoDatabase instance"
+	} },
+	run: info
+};
+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-dev/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-dev/cli db <command> --help' for more information.");
+}
+const dbCommand = {
+	name: "db",
+	description: "Database management commands",
+	run: printDbHelp
+};
+const rootSubCommands = /* @__PURE__ */ new Map();
+rootSubCommands.set("db", dbCommand);
+const mainCommand = {
+	name: "@fragno-dev/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-dev/cli <command> [options]");
+		console.log("");
+		console.log("Commands:");
+		console.log("  db    Database management commands");
+		console.log("");
+		console.log("Run '@fragno-dev/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":["fragnoDatabases: FragnoDatabase<AnySchema>[]","targetModule: Record<string, unknown>","result: { schema: string; path: string }","finalOutputPath: string","targetModule: Record<string, unknown>","didMigrate: boolean","targetModule: Record<string, unknown>","fragnoDatabases: FragnoDatabase<AnySchema>[]","generateCommand: Command","migrateCommand: Command","infoCommand: Command","dbCommand: Command","mainCommand: Command"],"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 type { AnySchema } from \"@fragno-dev/db/schema\";\nimport {\n  instantiatedFragmentFakeSymbol,\n  type FragnoInstantiatedFragment,\n} from \"@fragno-dev/core/api/fragment-instantiation\";\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      console.log(`Found FragnoDatabase instance: ${key}`);\n    } else if (isFragnoInstantiatedFragment(value)) {\n      const additionalContext = value.additionalContext;\n\n      if (!additionalContext || !additionalContextIsDatabaseContext(additionalContext)) {\n        console.warn(`Instantiated fragment ${key} has no database context`);\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      console.log(`Found database context in instantiated fragment: ${key}`);\n    }\n  }\n\n  return fragnoDatabases;\n}\n","import { writeFile, stat, mkdir } from \"node:fs/promises\";\nimport { resolve, join, dirname, basename } from \"node:path\";\nimport type { CommandContext } from \"gunshi\";\nimport { findFragnoDatabases } from \"../../utils/find-fragno-databases.js\";\n\nexport async function generate(ctx: CommandContext) {\n  const target = ctx.values[\"target\"];\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  if (!target || typeof target !== \"string\") {\n    throw new Error(\"Target file path is required and must be a string\");\n  }\n\n  if (typeof output === \"number\" || typeof output === \"boolean\") {\n    throw new Error(\"Output file path is required and must be a string\");\n  }\n\n  if (toVersion !== undefined && typeof toVersion !== \"string\" && typeof toVersion !== \"number\") {\n    throw new Error(\"Version must be a number or string\");\n  }\n\n  if (\n    fromVersion !== undefined &&\n    typeof fromVersion !== \"string\" &&\n    typeof fromVersion !== \"number\"\n  ) {\n    throw new Error(\"Version must be a number or string\");\n  }\n\n  if (prefix !== undefined && typeof prefix !== \"string\") {\n    throw new Error(\"Prefix must be a string\");\n  }\n\n  // Resolve the target file path relative to current working directory\n  const targetPath = resolve(process.cwd(), target);\n\n  console.log(`Loading target file: ${targetPath}`);\n\n  // Dynamically import the target file\n  let targetModule: Record<string, unknown>;\n  try {\n    targetModule = await import(targetPath);\n  } catch (error) {\n    throw new Error(\n      `Failed to import target file: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  // Find all FragnoDatabase instances or instantiated fragments with databases\n  const fragnoDatabases = findFragnoDatabases(targetModule);\n\n  if (fragnoDatabases.length === 0) {\n    throw new Error(\n      `No FragnoDatabase instances found in ${target}.\\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  }\n\n  if (fragnoDatabases.length > 1) {\n    console.warn(\n      `Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`,\n    );\n  }\n\n  // Use the first FragnoDatabase instance\n  const fragnoDb = fragnoDatabases[0];\n\n  // Parse versions if provided\n  const targetVersion = toVersion !== undefined ? parseInt(String(toVersion), 10) : undefined;\n  const sourceVersion = fromVersion !== undefined ? parseInt(String(fromVersion), 10) : undefined;\n\n  if (targetVersion !== undefined && isNaN(targetVersion)) {\n    throw new Error(`Invalid version number: ${toVersion}`);\n  }\n\n  if (sourceVersion !== undefined && isNaN(sourceVersion)) {\n    throw new Error(`Invalid version number: ${fromVersion}`);\n  }\n\n  if (sourceVersion !== undefined && targetVersion !== undefined) {\n    console.log(\n      `Generating schema for namespace: ${fragnoDb.namespace} (from version ${sourceVersion} to version ${targetVersion})`,\n    );\n  } else if (targetVersion !== undefined) {\n    console.log(\n      `Generating schema for namespace: ${fragnoDb.namespace} (to version ${targetVersion})`,\n    );\n  } else if (sourceVersion !== undefined) {\n    console.log(\n      `Generating schema for namespace: ${fragnoDb.namespace} (from version ${sourceVersion})`,\n    );\n  } else {\n    console.log(`Generating schema for namespace: ${fragnoDb.namespace}`);\n  }\n\n  // Determine if output is a directory or file\n  let isDirectory = false;\n\n  if (output) {\n    const resolvedOutput = resolve(process.cwd(), output);\n    try {\n      const stats = await stat(resolvedOutput);\n      isDirectory = stats.isDirectory();\n    } catch {\n      // Path doesn't exist - check if it looks like a directory (ends with /)\n      isDirectory = output.endsWith(\"/\");\n    }\n  }\n\n  // Generate schema\n  let result: { schema: string; path: string };\n  try {\n    // If output is a directory, pass undefined to get the default file name\n    // Otherwise pass the output path as-is\n    result = await fragnoDb.generateSchema({\n      path: isDirectory ? undefined : output,\n      toVersion: targetVersion,\n      fromVersion: sourceVersion,\n    });\n  } catch (error) {\n    throw new Error(\n      `Failed to generate schema: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  // Resolve final output path\n  let finalOutputPath: string;\n  if (isDirectory && output) {\n    // Combine directory with generated file name\n    const resolvedDir = resolve(process.cwd(), output);\n    finalOutputPath = join(resolvedDir, basename(result.path));\n  } else if (output) {\n    // Use the provided path as-is\n    finalOutputPath = resolve(process.cwd(), output);\n  } else {\n    // Use the generated file name in current directory\n    finalOutputPath = resolve(process.cwd(), result.path);\n  }\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(`✓ Schema generated successfully: ${finalOutputPath}`);\n  console.log(`  Namespace: ${fragnoDb.namespace}`);\n  console.log(`  Schema version: ${fragnoDb.schema.version}`);\n}\n","import { resolve } from \"node:path\";\nimport type { CommandContext } from \"gunshi\";\nimport { findFragnoDatabases } from \"../../utils/find-fragno-databases\";\n\nexport async function migrate(ctx: CommandContext) {\n  const target = ctx.values[\"target\"];\n  const version = ctx.values[\"to\"];\n  const fromVersion = ctx.values[\"from\"];\n\n  if (!target || typeof target !== \"string\") {\n    throw new Error(\"Target file path is required and must be a string\");\n  }\n\n  if (version !== undefined && typeof version !== \"string\" && typeof version !== \"number\") {\n    throw new Error(\"Version must be a number or string\");\n  }\n\n  if (\n    fromVersion !== undefined &&\n    typeof fromVersion !== \"string\" &&\n    typeof fromVersion !== \"number\"\n  ) {\n    throw new Error(\"Version must be a number or string\");\n  }\n\n  // Resolve the target file path relative to current working directory\n  const targetPath = resolve(process.cwd(), target);\n\n  console.log(`Loading target file: ${targetPath}`);\n\n  // Dynamically import the target file\n  let targetModule: Record<string, unknown>;\n  try {\n    targetModule = await import(targetPath);\n  } catch (error) {\n    throw new Error(\n      `Failed to import target file: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  // Find all FragnoDatabase instances or instantiated fragments with databases\n  const fragnoDatabases = findFragnoDatabases(targetModule);\n\n  if (fragnoDatabases.length === 0) {\n    throw new Error(\n      `No FragnoDatabase instances found in ${target}.\\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  }\n\n  if (fragnoDatabases.length > 1) {\n    console.warn(\n      `Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`,\n    );\n  }\n\n  // Use the first FragnoDatabase instance\n  const fragnoDb = fragnoDatabases[0];\n\n  console.log(`Migrating database for namespace: ${fragnoDb.namespace}`);\n\n  // Check if the adapter supports migrations\n  if (!fragnoDb.adapter.createMigrationEngine) {\n    throw new Error(\n      `Adapter does not support running migrations. The adapter only supports schema generation.\\n` +\n        `Try using 'fragno db generate' instead to generate schema files.`,\n    );\n  }\n\n  // Parse versions if provided\n  const targetVersion = version !== undefined ? parseInt(String(version), 10) : undefined;\n  const expectedFromVersion =\n    fromVersion !== undefined ? parseInt(String(fromVersion), 10) : undefined;\n\n  if (targetVersion !== undefined && isNaN(targetVersion)) {\n    throw new Error(`Invalid version number: ${version}`);\n  }\n\n  if (expectedFromVersion !== undefined && isNaN(expectedFromVersion)) {\n    throw new Error(`Invalid version number: ${fromVersion}`);\n  }\n\n  // Run migrations\n  let didMigrate: boolean;\n  try {\n    if (targetVersion !== undefined) {\n      console.log(`Migrating to version ${targetVersion}...`);\n      const migrator = fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);\n      const currentVersion = await migrator.getVersion();\n      console.log(`Current version: ${currentVersion}`);\n\n      // Validate from version if provided\n      if (expectedFromVersion !== undefined && currentVersion !== expectedFromVersion) {\n        throw new Error(\n          `Current database version (${currentVersion}) does not match expected --from version (${expectedFromVersion})`,\n        );\n      }\n\n      const preparedMigration = await migrator.prepareMigrationTo(targetVersion, {\n        updateSettings: true,\n      });\n\n      if (preparedMigration.operations.length === 0) {\n        console.log(\"✓ Database is already at the target version. No migrations needed.\");\n        didMigrate = false;\n      } else {\n        await preparedMigration.execute();\n        didMigrate = true;\n      }\n    } else {\n      console.log(`Migrating to latest version (${fragnoDb.schema.version})...`);\n      didMigrate = await fragnoDb.runMigrations();\n    }\n  } catch (error) {\n    throw new Error(\n      `Failed to run migrations: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  if (didMigrate) {\n    console.log(`✓ Migration completed successfully`);\n    console.log(`  Namespace: ${fragnoDb.namespace}`);\n    if (targetVersion !== undefined) {\n      console.log(`  New version: ${targetVersion}`);\n    } else {\n      console.log(`  New version: ${fragnoDb.schema.version}`);\n    }\n  }\n}\n","import { isFragnoDatabase, type FragnoDatabase } from \"@fragno-dev/db\";\nimport type { AnySchema } from \"@fragno-dev/db/schema\";\nimport { resolve } from \"node:path\";\nimport type { CommandContext } from \"gunshi\";\n\nexport async function info(ctx: CommandContext) {\n  const target = ctx.values[\"target\"];\n\n  if (!target || typeof target !== \"string\") {\n    throw new Error(\"Target file path is required and must be a string\");\n  }\n\n  // Resolve the target file path relative to current working directory\n  const targetPath = resolve(process.cwd(), target);\n\n  console.log(`Loading target file: ${targetPath}`);\n\n  // Dynamically import the target file\n  let targetModule: Record<string, unknown>;\n  try {\n    targetModule = await import(targetPath);\n  } catch (error) {\n    throw new Error(\n      `Failed to import target file: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  // Find all FragnoDatabase instances in the exported values\n  const fragnoDatabases: FragnoDatabase<AnySchema>[] = [];\n\n  for (const [key, value] of Object.entries(targetModule)) {\n    if (isFragnoDatabase(value)) {\n      fragnoDatabases.push(value);\n      console.log(`Found FragnoDatabase instance: ${key}`);\n    }\n  }\n\n  if (fragnoDatabases.length === 0) {\n    throw new Error(`No FragnoDatabase instances found in ${target}.\\n`);\n  }\n\n  if (fragnoDatabases.length > 1) {\n    console.warn(\n      `Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`,\n    );\n  }\n\n  // Use the first FragnoDatabase instance\n  const fragnoDb = fragnoDatabases[0];\n\n  console.log(\"\");\n  console.log(\"Database Information\");\n  console.log(\"=\".repeat(50));\n  console.log(`Namespace: ${fragnoDb.namespace}`);\n  console.log(`Latest Schema Version: ${fragnoDb.schema.version}`);\n\n  // Check if the adapter supports migrations\n  if (!fragnoDb.adapter.createMigrationEngine) {\n    console.log(`Migration Support: No`);\n    console.log(\"\");\n    console.log(\"Note: This adapter does not support running migrations.\");\n    console.log(\"Use 'fragno db generate' to generate schema files.\");\n    return;\n  }\n\n  console.log(`Migration Support: Yes`);\n\n  // Get current database version\n  try {\n    const migrator = fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);\n    const currentVersion = await migrator.getVersion();\n\n    console.log(`Current Database Version: ${currentVersion}`);\n\n    // Check if migrations are pending\n    const pendingVersions = fragnoDb.schema.version - currentVersion;\n    if (pendingVersions > 0) {\n      console.log(\"\");\n      console.log(`⚠ Pending Migrations: ${pendingVersions} version(s) behind`);\n      console.log(`  Run '@fragno-dev/cli db migrate --target ${target}' to update`);\n    } else if (pendingVersions === 0) {\n      console.log(\"\");\n      console.log(`✓ Database is up to date`);\n    }\n  } catch (error) {\n    console.log(\"\");\n    console.log(\n      `Warning: Could not retrieve current version: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  console.log(\"=\".repeat(50));\n}\n","#!/usr/bin/env node\n\nimport { cli, type Command, parseArgs, resolveArgs } from \"gunshi\";\nimport { generate } from \"./commands/db/generate.js\";\nimport { migrate } from \"./commands/db/migrate.js\";\nimport { info } from \"./commands/db/info.js\";\n\n// Define the db generate command\nexport const generateCommand: Command = {\n  name: \"generate\",\n  description: \"Generate schema files from FragnoDatabase definitions\",\n  args: {\n    target: {\n      type: \"positional\" as const,\n      description: \"Path to the file that exports a FragnoDatabase instance\",\n    },\n    output: {\n      type: \"string\" as const,\n      short: \"o\",\n      description:\n        \"Output path for the generated schema file (default: schema.sql for Kysely, schema.ts for Drizzle)\",\n    },\n    from: {\n      type: \"string\" as const,\n      short: \"f\",\n      description: \"Source version to generate migration from (default: current database version)\",\n    },\n    to: {\n      type: \"string\" as const,\n      short: \"t\",\n      description: \"Target version to generate migration to (default: latest schema version)\",\n    },\n    prefix: {\n      type: \"string\" as const,\n      short: \"p\",\n      description: \"String to prepend to the generated file (e.g., '/* eslint-disable */')\",\n    },\n  },\n  run: generate,\n};\n\n// Define the db migrate command\nexport const migrateCommand: Command = {\n  name: \"migrate\",\n  description: \"Run database migrations\",\n  args: {\n    target: {\n      type: \"positional\" as const,\n      description: \"Path to the file that exports a FragnoDatabase instance\",\n    },\n    from: {\n      type: \"string\" as const,\n      short: \"f\",\n      description: \"Expected current database version (validates before migrating)\",\n    },\n    to: {\n      type: \"string\" as const,\n      short: \"t\",\n      description: \"Target version to migrate to (default: latest schema version)\",\n    },\n  },\n  run: migrate,\n};\n\n// Define the db info command\nexport const infoCommand: Command = {\n  name: \"info\",\n  description: \"Display database information and migration status\",\n  args: {\n    target: {\n      type: \"positional\" as const,\n      description: \"Path to the file that exports a FragnoDatabase instance\",\n    },\n  },\n  run: info,\n};\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-dev/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-dev/cli db <command> --help' for more information.\");\n}\n\n// Define the db command\nexport const dbCommand: Command = {\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\nexport const mainCommand: Command = {\n  name: \"@fragno-dev/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-dev/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-dev/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"],"mappings":"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"}

package/package.json

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

package/src/cli.ts

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+
+import { cli, type Command, parseArgs, resolveArgs } from "gunshi";
+import { generate } from "./commands/db/generate.js";
+import { migrate } from "./commands/db/migrate.js";
+import { info } from "./commands/db/info.js";
+
+// Define the db generate command
+export const generateCommand: Command = {
+  name: "generate",
+  description: "Generate schema files from FragnoDatabase definitions",
+  args: {
+    target: {
+      type: "positional" as const,
+      description: "Path to the file that exports a FragnoDatabase instance",
+    },
+    output: {
+      type: "string" as const,
+      short: "o",
+      description:
+        "Output path for the generated schema file (default: schema.sql for Kysely, schema.ts for Drizzle)",
+    },
+    from: {
+      type: "string" as const,
+      short: "f",
+      description: "Source version to generate migration from (default: current database version)",
+    },
+    to: {
+      type: "string" as const,
+      short: "t",
+      description: "Target version to generate migration to (default: latest schema version)",
+    },
+    prefix: {
+      type: "string" as const,
+      short: "p",
+      description: "String to prepend to the generated file (e.g., '/* eslint-disable */')",
+    },
+  },
+  run: generate,
+};
+
+// Define the db migrate command
+export const migrateCommand: Command = {
+  name: "migrate",
+  description: "Run database migrations",
+  args: {
+    target: {
+      type: "positional" as const,
+      description: "Path to the file that exports a FragnoDatabase instance",
+    },
+    from: {
+      type: "string" as const,
+      short: "f",
+      description: "Expected current database version (validates before migrating)",
+    },
+    to: {
+      type: "string" as const,
+      short: "t",
+      description: "Target version to migrate to (default: latest schema version)",
+    },
+  },
+  run: migrate,
+};
+
+// Define the db info command
+export const infoCommand: Command = {
+  name: "info",
+  description: "Display database information and migration status",
+  args: {
+    target: {
+      type: "positional" as const,
+      description: "Path to the file that exports a FragnoDatabase instance",
+    },
+  },
+  run: info,
+};
+
+// 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-dev/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-dev/cli db <command> --help' for more information.");
+}
+
+// Define the db command
+export const dbCommand: Command = {
+  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
+export const mainCommand: Command = {
+  name: "@fragno-dev/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-dev/cli <command> [options]");
+    console.log("");
+    console.log("Commands:");
+    console.log("  db    Database management commands");
+    console.log("");
+    console.log("Run '@fragno-dev/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);
+  }
+}

package/src/commands/db/generate.ts

@@ -0,0 +1,168 @@
+import { writeFile, stat, mkdir } from "node:fs/promises";
+import { resolve, join, dirname, basename } from "node:path";
+import type { CommandContext } from "gunshi";
+import { findFragnoDatabases } from "../../utils/find-fragno-databases.js";
+
+export async function generate(ctx: CommandContext) {
+  const target = ctx.values["target"];
+  const output = ctx.values["output"];
+  const toVersion = ctx.values["to"];
+  const fromVersion = ctx.values["from"];
+  const prefix = ctx.values["prefix"];
+
+  if (!target || typeof target !== "string") {
+    throw new Error("Target file path is required and must be a string");
+  }
+
+  if (typeof output === "number" || typeof output === "boolean") {
+    throw new Error("Output file path is required and must be a string");
+  }
+
+  if (toVersion !== undefined && typeof toVersion !== "string" && typeof toVersion !== "number") {
+    throw new Error("Version must be a number or string");
+  }
+
+  if (
+    fromVersion !== undefined &&
+    typeof fromVersion !== "string" &&
+    typeof fromVersion !== "number"
+  ) {
+    throw new Error("Version must be a number or string");
+  }
+
+  if (prefix !== undefined && typeof prefix !== "string") {
+    throw new Error("Prefix must be a string");
+  }
+
+  // Resolve the target file path relative to current working directory
+  const targetPath = resolve(process.cwd(), target);
+
+  console.log(`Loading target file: ${targetPath}`);
+
+  // Dynamically import the target file
+  let targetModule: Record<string, unknown>;
+  try {
+    targetModule = await import(targetPath);
+  } catch (error) {
+    throw new Error(
+      `Failed to import target file: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  // Find all FragnoDatabase instances or instantiated fragments with databases
+  const fragnoDatabases = findFragnoDatabases(targetModule);
+
+  if (fragnoDatabases.length === 0) {
+    throw new Error(
+      `No FragnoDatabase instances found in ${target}.\n` +
+        `Make sure you export either:\n` +
+        `  - A FragnoDatabase instance created with .create(adapter)\n` +
+        `  - An instantiated fragment with embedded database definition\n`,
+    );
+  }
+
+  if (fragnoDatabases.length > 1) {
+    console.warn(
+      `Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`,
+    );
+  }
+
+  // Use the first FragnoDatabase instance
+  const fragnoDb = fragnoDatabases[0];
+
+  // Parse versions if provided
+  const targetVersion = toVersion !== undefined ? parseInt(String(toVersion), 10) : undefined;
+  const sourceVersion = fromVersion !== undefined ? parseInt(String(fromVersion), 10) : undefined;
+
+  if (targetVersion !== undefined && isNaN(targetVersion)) {
+    throw new Error(`Invalid version number: ${toVersion}`);
+  }
+
+  if (sourceVersion !== undefined && isNaN(sourceVersion)) {
+    throw new Error(`Invalid version number: ${fromVersion}`);
+  }
+
+  if (sourceVersion !== undefined && targetVersion !== undefined) {
+    console.log(
+      `Generating schema for namespace: ${fragnoDb.namespace} (from version ${sourceVersion} to version ${targetVersion})`,
+    );
+  } else if (targetVersion !== undefined) {
+    console.log(
+      `Generating schema for namespace: ${fragnoDb.namespace} (to version ${targetVersion})`,
+    );
+  } else if (sourceVersion !== undefined) {
+    console.log(
+      `Generating schema for namespace: ${fragnoDb.namespace} (from version ${sourceVersion})`,
+    );
+  } else {
+    console.log(`Generating schema for namespace: ${fragnoDb.namespace}`);
+  }
+
+  // Determine if output is a directory or file
+  let isDirectory = false;
+
+  if (output) {
+    const resolvedOutput = resolve(process.cwd(), output);
+    try {
+      const stats = await stat(resolvedOutput);
+      isDirectory = stats.isDirectory();
+    } catch {
+      // Path doesn't exist - check if it looks like a directory (ends with /)
+      isDirectory = output.endsWith("/");
+    }
+  }
+
+  // Generate schema
+  let result: { schema: string; path: string };
+  try {
+    // If output is a directory, pass undefined to get the default file name
+    // Otherwise pass the output path as-is
+    result = await fragnoDb.generateSchema({
+      path: isDirectory ? undefined : output,
+      toVersion: targetVersion,
+      fromVersion: sourceVersion,
+    });
+  } catch (error) {
+    throw new Error(
+      `Failed to generate schema: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  // Resolve final output path
+  let finalOutputPath: string;
+  if (isDirectory && output) {
+    // Combine directory with generated file name
+    const resolvedDir = resolve(process.cwd(), output);
+    finalOutputPath = join(resolvedDir, basename(result.path));
+  } else if (output) {
+    // Use the provided path as-is
+    finalOutputPath = resolve(process.cwd(), output);
+  } else {
+    // Use the generated file name in current directory
+    finalOutputPath = 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(`✓ Schema generated successfully: ${finalOutputPath}`);
+  console.log(`  Namespace: ${fragnoDb.namespace}`);
+  console.log(`  Schema version: ${fragnoDb.schema.version}`);
+}

package/src/commands/db/info.ts

@@ -0,0 +1,93 @@
+import { isFragnoDatabase, type FragnoDatabase } from "@fragno-dev/db";
+import type { AnySchema } from "@fragno-dev/db/schema";
+import { resolve } from "node:path";
+import type { CommandContext } from "gunshi";
+
+export async function info(ctx: CommandContext) {
+  const target = ctx.values["target"];
+
+  if (!target || typeof target !== "string") {
+    throw new Error("Target file path is required and must be a string");
+  }
+
+  // Resolve the target file path relative to current working directory
+  const targetPath = resolve(process.cwd(), target);
+
+  console.log(`Loading target file: ${targetPath}`);
+
+  // Dynamically import the target file
+  let targetModule: Record<string, unknown>;
+  try {
+    targetModule = await import(targetPath);
+  } catch (error) {
+    throw new Error(
+      `Failed to import target file: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  // Find all FragnoDatabase instances in the exported values
+  const fragnoDatabases: FragnoDatabase<AnySchema>[] = [];
+
+  for (const [key, value] of Object.entries(targetModule)) {
+    if (isFragnoDatabase(value)) {
+      fragnoDatabases.push(value);
+      console.log(`Found FragnoDatabase instance: ${key}`);
+    }
+  }
+
+  if (fragnoDatabases.length === 0) {
+    throw new Error(`No FragnoDatabase instances found in ${target}.\n`);
+  }
+
+  if (fragnoDatabases.length > 1) {
+    console.warn(
+      `Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`,
+    );
+  }
+
+  // Use the first FragnoDatabase instance
+  const fragnoDb = fragnoDatabases[0];
+
+  console.log("");
+  console.log("Database Information");
+  console.log("=".repeat(50));
+  console.log(`Namespace: ${fragnoDb.namespace}`);
+  console.log(`Latest Schema Version: ${fragnoDb.schema.version}`);
+
+  // Check if the adapter supports migrations
+  if (!fragnoDb.adapter.createMigrationEngine) {
+    console.log(`Migration Support: No`);
+    console.log("");
+    console.log("Note: This adapter does not support running migrations.");
+    console.log("Use 'fragno db generate' to generate schema files.");
+    return;
+  }
+
+  console.log(`Migration Support: Yes`);
+
+  // Get current database version
+  try {
+    const migrator = fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);
+    const currentVersion = await migrator.getVersion();
+
+    console.log(`Current Database Version: ${currentVersion}`);
+
+    // Check if migrations are pending
+    const pendingVersions = fragnoDb.schema.version - currentVersion;
+    if (pendingVersions > 0) {
+      console.log("");
+      console.log(`⚠ Pending Migrations: ${pendingVersions} version(s) behind`);
+      console.log(`  Run '@fragno-dev/cli db migrate --target ${target}' to update`);
+    } else if (pendingVersions === 0) {
+      console.log("");
+      console.log(`✓ Database is up to date`);
+    }
+  } catch (error) {
+    console.log("");
+    console.log(
+      `Warning: Could not retrieve current version: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  console.log("=".repeat(50));
+}

package/src/commands/db/migrate.ts

@@ -0,0 +1,131 @@
+import { resolve } from "node:path";
+import type { CommandContext } from "gunshi";
+import { findFragnoDatabases } from "../../utils/find-fragno-databases";
+
+export async function migrate(ctx: CommandContext) {
+  const target = ctx.values["target"];
+  const version = ctx.values["to"];
+  const fromVersion = ctx.values["from"];
+
+  if (!target || typeof target !== "string") {
+    throw new Error("Target file path is required and must be a string");
+  }
+
+  if (version !== undefined && typeof version !== "string" && typeof version !== "number") {
+    throw new Error("Version must be a number or string");
+  }
+
+  if (
+    fromVersion !== undefined &&
+    typeof fromVersion !== "string" &&
+    typeof fromVersion !== "number"
+  ) {
+    throw new Error("Version must be a number or string");
+  }
+
+  // Resolve the target file path relative to current working directory
+  const targetPath = resolve(process.cwd(), target);
+
+  console.log(`Loading target file: ${targetPath}`);
+
+  // Dynamically import the target file
+  let targetModule: Record<string, unknown>;
+  try {
+    targetModule = await import(targetPath);
+  } catch (error) {
+    throw new Error(
+      `Failed to import target file: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  // Find all FragnoDatabase instances or instantiated fragments with databases
+  const fragnoDatabases = findFragnoDatabases(targetModule);
+
+  if (fragnoDatabases.length === 0) {
+    throw new Error(
+      `No FragnoDatabase instances found in ${target}.\n` +
+        `Make sure you export either:\n` +
+        `  - A FragnoDatabase instance created with .create(adapter)\n` +
+        `  - An instantiated fragment with embedded database definition\n`,
+    );
+  }
+
+  if (fragnoDatabases.length > 1) {
+    console.warn(
+      `Warning: Multiple FragnoDatabase instances found (${fragnoDatabases.length}). Using the first one.`,
+    );
+  }
+
+  // Use the first FragnoDatabase instance
+  const fragnoDb = fragnoDatabases[0];
+
+  console.log(`Migrating database for namespace: ${fragnoDb.namespace}`);
+
+  // Check if the adapter supports migrations
+  if (!fragnoDb.adapter.createMigrationEngine) {
+    throw new Error(
+      `Adapter does not support running migrations. The adapter only supports schema generation.\n` +
+        `Try using 'fragno db generate' instead to generate schema files.`,
+    );
+  }
+
+  // Parse versions if provided
+  const targetVersion = version !== undefined ? parseInt(String(version), 10) : undefined;
+  const expectedFromVersion =
+    fromVersion !== undefined ? parseInt(String(fromVersion), 10) : undefined;
+
+  if (targetVersion !== undefined && isNaN(targetVersion)) {
+    throw new Error(`Invalid version number: ${version}`);
+  }
+
+  if (expectedFromVersion !== undefined && isNaN(expectedFromVersion)) {
+    throw new Error(`Invalid version number: ${fromVersion}`);
+  }
+
+  // Run migrations
+  let didMigrate: boolean;
+  try {
+    if (targetVersion !== undefined) {
+      console.log(`Migrating to version ${targetVersion}...`);
+      const migrator = fragnoDb.adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);
+      const currentVersion = await migrator.getVersion();
+      console.log(`Current version: ${currentVersion}`);
+
+      // Validate from version if provided
+      if (expectedFromVersion !== undefined && currentVersion !== expectedFromVersion) {
+        throw new Error(
+          `Current database version (${currentVersion}) does not match expected --from version (${expectedFromVersion})`,
+        );
+      }
+
+      const preparedMigration = await migrator.prepareMigrationTo(targetVersion, {
+        updateSettings: true,
+      });
+
+      if (preparedMigration.operations.length === 0) {
+        console.log("✓ Database is already at the target version. No migrations needed.");
+        didMigrate = false;
+      } else {
+        await preparedMigration.execute();
+        didMigrate = true;
+      }
+    } else {
+      console.log(`Migrating to latest version (${fragnoDb.schema.version})...`);
+      didMigrate = await fragnoDb.runMigrations();
+    }
+  } catch (error) {
+    throw new Error(
+      `Failed to run migrations: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  if (didMigrate) {
+    console.log(`✓ Migration completed successfully`);
+    console.log(`  Namespace: ${fragnoDb.namespace}`);
+    if (targetVersion !== undefined) {
+      console.log(`  New version: ${targetVersion}`);
+    } else {
+      console.log(`  New version: ${fragnoDb.schema.version}`);
+    }
+  }
+}

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

@@ -0,0 +1,69 @@
+import { isFragnoDatabase, type DatabaseAdapter, FragnoDatabase } from "@fragno-dev/db";
+import type { AnySchema } from "@fragno-dev/db/schema";
+import {
+  instantiatedFragmentFakeSymbol,
+  type FragnoInstantiatedFragment,
+} from "@fragno-dev/core/api/fragment-instantiation";
+
+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);
+      console.log(`Found FragnoDatabase instance: ${key}`);
+    } else if (isFragnoInstantiatedFragment(value)) {
+      const additionalContext = value.additionalContext;
+
+      if (!additionalContext || !additionalContextIsDatabaseContext(additionalContext)) {
+        console.warn(`Instantiated fragment ${key} has no database context`);
+        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,
+        }),
+      );
+      console.log(`Found database context in instantiated fragment: ${key}`);
+    }
+  }
+
+  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);