@fragno-dev/cli 0.1.13 → 0.1.14

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fragno-dev/cli@0.1.13 build /home/runner/work/fragno/fragno/apps/fragno-cli
+> @fragno-dev/cli@0.1.14 build /home/runner/work/fragno/fragno/apps/fragno-cli
 > tsdown
 
 ℹ tsdown v0.15.12 powered by rolldown v1.0.0-beta.45
@@ -10,9 +10,9 @@
 ℹ 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 14018ms
+ℹ dist/cli.js        22.08 kB │ gzip:  5.68 kB
+ℹ dist/cli.js.map    44.37 kB │ gzip: 11.22 kB
+ℹ dist/cli.d.ts.map   0.71 kB │ gzip:  0.33 kB
+ℹ dist/cli.d.ts       1.51 kB │ gzip:  0.39 kB
+ℹ 4 files, total: 68.67 kB
+✔ Build complete in 9366ms

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @fragno-dev/cli
 
+## 0.1.14
+
+### Patch Changes
+
+- 4ec7e78: feat: add search command for documentation lookup
+
+  Add a new `search` command to fragno-cli that searches the Fragno documentation directly from the
+  command line. Results are automatically grouped by page URL with all relevant sections displayed
+  together.
+
+- 4ec7e78: feat: add corpus command to view code examples and documentation
+
+  The new `corpus` command allows users and LLMs to access tested, type-checked code examples
+  organized by subject. Examples include route definition, database querying, and adapter setup. Use
+  `fragno-cli corpus [topic...]` to view one or more topics.
+
+- 27cc540: fix: Corpus dependency issue
+- Updated dependencies [be1a630]
+- Updated dependencies [b2a88aa]
+- Updated dependencies [2900bfa]
+- Updated dependencies [27cc540]
+- Updated dependencies [059a249]
+- Updated dependencies [f3f7bc2]
+- Updated dependencies [a9f8159]
+- Updated dependencies [9d4cd3a]
+- Updated dependencies [fdb5aaf]
+  - @fragno-dev/core@0.1.6
+  - @fragno-dev/db@0.1.12
+  - @fragno-dev/corpus@0.0.2
+
 ## 0.1.13
 
 ### Patch Changes

package/dist/cli.d.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import * as gunshi4 from "gunshi";
+import * as gunshi5 from "gunshi";
 
 //#region src/commands/db/generate.d.ts
-declare const generateCommand: gunshi4.Command<{
+declare const generateCommand: gunshi5.Command<{
   output: {
     type: "string";
     short: string;
@@ -26,14 +26,41 @@ declare const generateCommand: gunshi4.Command<{
 }>;
 //#endregion
 //#region src/commands/db/migrate.d.ts
-declare const migrateCommand: gunshi4.Command<{}>;
+declare const migrateCommand: gunshi5.Command<{}>;
 //#endregion
 //#region src/commands/db/info.d.ts
-declare const infoCommand: gunshi4.Command<{}>;
+declare const infoCommand: gunshi5.Command<{}>;
+//#endregion
+//#region src/commands/search.d.ts
+declare const searchCommand: gunshi5.Command<{
+  limit: {
+    type: "number";
+    description: string;
+    default: number;
+  };
+  json: {
+    type: "boolean";
+    description: string;
+    default: false;
+  };
+  markdown: {
+    type: "boolean";
+    description: string;
+    default: true;
+  };
+  "base-url": {
+    type: "string";
+    description: string;
+    default: string;
+  };
+}>;
+//#endregion
+//#region src/commands/corpus.d.ts
+declare const corpusCommand: gunshi5.Command<gunshi5.Args>;
 //#endregion
 //#region src/cli.d.ts
-declare const dbCommand: gunshi4.Command<gunshi4.Args>;
-declare const mainCommand: gunshi4.Command<gunshi4.Args>;
+declare const dbCommand: gunshi5.Command<gunshi5.Args>;
+declare const mainCommand: gunshi5.Command<gunshi5.Args>;
 //#endregion
-export { dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand };
+export { corpusCommand, dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand, searchCommand };
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"cli.d.ts","names":[],"sources":["../src/commands/db/generate.ts","../src/commands/db/migrate.ts","../src/commands/db/info.ts","../src/commands/search.ts","../src/commands/corpus.ts","../src/cli.ts"],"sourcesContent":[],"mappings":";;;;cAOa,iBAyGX,OAAA,CAzG0B;;;;IAAf,WAAA,EAAA,MAyGX;;;;IC3GW,KAAA,EAAA,MAqEX;;;;ICtEW,IAAA,EAAA,QA4HX;;;;EC5GW,MAAA,EAAA;;;;ECoDA,CAAA;;;;cHnEA,gBAqEX,OAAA,CArEyB;;;cCDd,aA4HX,OAAA,CA5HsB;;;cCgBX,eAoFX,OAAA,CApFwB;;;;IHbb,OAAA,EAAA,MAyGX;;;;IC3GW,WAAA,EAqEX,MAAA;;;;ICtEW,IAAA,EAAA,SA4HX;;;;EC5GW,UAAA,EAAA;;;;ECoDA,CAAA;;;;cAAA,eAAa,OAAA,CAAA,QA6BxB,OAAA,CA7BwB,IAAA;;;cC1Cb,WAAS,OAAA,CAAA,QAIpB,OAAA,CAJoB,IAAA;cAaT,aAAW,OAAA,CAAA,QAetB,OAAA,CAfsB,IAAA"}

package/dist/cli.js

@@ -7,6 +7,7 @@ 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";
+import { getSubject, getSubjects } from "@fragno-dev/corpus";
 
 //#region src/utils/find-fragno-databases.ts
 async function importFragmentFile(path) {
@@ -258,6 +259,215 @@ const infoCommand = define({
 	}
 });
 
+//#endregion
+//#region src/utils/format-search-results.ts
+/**
+* Merge search results by URL, grouping sections and content under each URL (without hash)
+*/
+function mergeResultsByUrl(results, baseUrl) {
+	const mergedMap = /* @__PURE__ */ new Map();
+	for (const result of results) {
+		const baseUrlWithoutHash = result.url.split("#")[0];
+		const existing = mergedMap.get(baseUrlWithoutHash);
+		if (existing) existing.sections.push({
+			content: result.content,
+			type: result.type
+		});
+		else {
+			const urlWithMd = `${baseUrlWithoutHash}.md`;
+			const fullUrl = `https://${baseUrl}${baseUrlWithoutHash}`;
+			const fullUrlWithMd = `https://${baseUrl}${urlWithMd}`;
+			mergedMap.set(baseUrlWithoutHash, {
+				url: baseUrlWithoutHash,
+				urlWithMd,
+				fullUrl,
+				fullUrlWithMd,
+				title: result.type === "page" ? result.content : void 0,
+				breadcrumbs: result.breadcrumbs,
+				type: result.type,
+				sections: [{
+					content: result.content,
+					type: result.type
+				}]
+			});
+		}
+	}
+	return Array.from(mergedMap.values());
+}
+/**
+* Format merged results as markdown
+*/
+function formatAsMarkdown(mergedResults) {
+	const lines = [];
+	for (const result of mergedResults) {
+		const title = result.title || result.sections[0]?.content || "Untitled";
+		lines.push(`## Page: '${title}'`);
+		if (result.breadcrumbs && result.breadcrumbs.length > 0) {
+			lines.push("   " + result.breadcrumbs.join(" > "));
+			lines.push("");
+		}
+		lines.push("URLs:");
+		lines.push(`  - ${result.fullUrl}`);
+		lines.push(`  - ${result.fullUrlWithMd}`);
+		lines.push("");
+		if (result.sections.length > 1) {
+			lines.push("Relevant sections:");
+			for (let i = 0; i < result.sections.length; i++) {
+				const section = result.sections[i];
+				if (i === 0 && result.type === "page" && section.content === result.title) continue;
+				lines.push(`  - ${section.content}`);
+			}
+			lines.push("");
+		}
+		lines.push("---");
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Format merged results as JSON
+*/
+function formatAsJson(mergedResults) {
+	return JSON.stringify(mergedResults, null, 2);
+}
+
+//#endregion
+//#region src/commands/search.ts
+const searchCommand = define({
+	name: "search",
+	description: "Search the Fragno documentation",
+	args: {
+		limit: {
+			type: "number",
+			description: "Maximum number of results to show",
+			default: 10
+		},
+		json: {
+			type: "boolean",
+			description: "Output results in JSON format",
+			default: false
+		},
+		markdown: {
+			type: "boolean",
+			description: "Output results in Markdown format (default)",
+			default: true
+		},
+		"base-url": {
+			type: "string",
+			description: "Base URL for the documentation site",
+			default: "fragno.dev"
+		}
+	},
+	run: async (ctx) => {
+		const query = ctx.positionals.join(" ");
+		if (!query || query.trim().length === 0) throw new Error("Please provide a search query");
+		const jsonMode = ctx.values.json;
+		const baseUrl = ctx.values["base-url"];
+		if (!jsonMode) console.log(`Searching for: "${query}"\n`);
+		try {
+			const encodedQuery = encodeURIComponent(query);
+			const response = await fetch(`https://${baseUrl}/api/search?query=${encodedQuery}`);
+			if (!response.ok) throw new Error(`API request failed with status ${response.status}`);
+			const results = await response.json();
+			const limit = ctx.values.limit;
+			const limitedResults = results.slice(0, limit);
+			if (limitedResults.length === 0) {
+				if (jsonMode) console.log("[]");
+				else console.log("No results found.");
+				return;
+			}
+			const mergedResults = mergeResultsByUrl(limitedResults, baseUrl);
+			if (jsonMode) console.log(formatAsJson(mergedResults));
+			else {
+				console.log(`Found ${results.length} result${results.length === 1 ? "" : "s"}${results.length > limit ? ` (showing ${limit})` : ""}\n`);
+				console.log(formatAsMarkdown(mergedResults));
+			}
+		} catch (error) {
+			if (error instanceof Error) throw new Error(`Search failed: ${error.message}`);
+			throw new Error("Search failed: An unknown error occurred");
+		}
+	}
+});
+
+//#endregion
+//#region src/commands/corpus.ts
+/**
+* Print a subject with its examples
+*/
+function printSubject(subject) {
+	console.log(`\n${"=".repeat(60)}`);
+	console.log(`${subject.title}`);
+	console.log(`${"=".repeat(60)}\n`);
+	if (subject.description) {
+		console.log(subject.description);
+		console.log();
+	}
+	if (subject.imports) {
+		console.log("### Imports\n");
+		console.log("```typescript");
+		console.log(subject.imports);
+		console.log("```\n");
+	}
+	if (subject.init) {
+		console.log("### Initialization\n");
+		console.log("```typescript");
+		console.log(subject.init);
+		console.log("```\n");
+	}
+	for (let i = 0; i < subject.examples.length; i++) {
+		const example = subject.examples[i];
+		console.log(`### Example ${i + 1}\n`);
+		console.log("```typescript");
+		console.log(example.code);
+		console.log("```");
+		if (example.explanation) {
+			console.log();
+			console.log(example.explanation);
+		}
+		console.log();
+	}
+}
+/**
+* Print information about the corpus command
+*/
+function printCorpusHelp() {
+	console.log("Fragno Corpus - Code examples and documentation");
+	console.log("");
+	console.log("Usage: fragno-cli corpus [topic...]");
+	console.log("");
+	console.log("Examples:");
+	console.log("  fragno-cli corpus                           # List all available topics");
+	console.log("  fragno-cli corpus defining-routes           # Show route definition examples");
+	console.log("  fragno-cli corpus database-adapters kysely-adapter");
+	console.log("                                              # Show multiple topics");
+	console.log("");
+	console.log("Available topics:");
+	const subjects = getSubjects();
+	for (const subject of subjects) console.log(`  ${subject.id.padEnd(30)} ${subject.title}`);
+}
+const corpusCommand = define({
+	name: "corpus",
+	description: "View code examples and documentation for Fragno",
+	run: (ctx) => {
+		const topics = ctx.positionals;
+		if (topics.length === 0) {
+			printCorpusHelp();
+			return;
+		}
+		try {
+			const subjects = getSubject(...topics);
+			for (const subject of subjects) printSubject(subject);
+			console.log(`${"=".repeat(60)}`);
+			console.log(`Displayed ${subjects.length} topic(s)`);
+			console.log(`${"=".repeat(60)}\n`);
+		} catch (error) {
+			console.error("Error loading topics:", error instanceof Error ? error.message : error);
+			console.log("\nRun 'fragno-cli corpus' to see available topics.");
+			process.exit(1);
+		}
+	}
+});
+
 //#endregion
 //#region src/cli.ts
 const dbSubCommands = /* @__PURE__ */ new Map();
@@ -283,6 +493,8 @@ const dbCommand = define({
 });
 const rootSubCommands = /* @__PURE__ */ new Map();
 rootSubCommands.set("db", dbCommand);
+rootSubCommands.set("search", searchCommand);
+rootSubCommands.set("corpus", corpusCommand);
 const mainCommand = define({
 	name: "fragno-cli",
 	description: "Fragno CLI - Tools for working with Fragno fragments",
@@ -292,14 +504,18 @@ const mainCommand = define({
 		console.log("Usage: fragno-cli <command> [options]");
 		console.log("");
 		console.log("Commands:");
-		console.log("  db    Database management commands");
+		console.log("  db       Database management commands");
+		console.log("  search   Search the Fragno documentation");
+		console.log("  corpus   View code examples and documentation");
 		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) {
+	if (args[0] === "search") await cli(args.slice(1), searchCommand);
+	else if (args[0] === "corpus") await cli(args.slice(1), corpusCommand);
+	else if (args[0] === "db" && args.length > 1) {
 		const subCommandName = args[1];
 		if (subCommandName === "--help" || subCommandName === "-h") {
 			printDbHelp();
@@ -329,5 +545,5 @@ if (import.meta.main) try {
 }
 
 //#endregion
-export { dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand };
+export { corpusCommand, dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand, searchCommand };
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +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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"}
+{"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        }","lines: string[]"],"sources":["../src/utils/find-fragno-databases.ts","../src/commands/db/generate.ts","../src/commands/db/migrate.ts","../src/commands/db/info.ts","../src/utils/format-search-results.ts","../src/commands/search.ts","../src/commands/corpus.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","interface SearchResult {\n  id: string;\n  type: \"page\" | \"heading\" | \"text\";\n  content: string;\n  breadcrumbs?: string[];\n  contentWithHighlights?: Array<{\n    type: string;\n    content: string;\n    styles?: { highlight?: boolean };\n  }>;\n  url: string;\n}\n\ninterface MergedResult {\n  url: string;\n  urlWithMd: string;\n  fullUrl: string;\n  fullUrlWithMd: string;\n  title?: string;\n  breadcrumbs?: string[];\n  type: \"page\" | \"heading\" | \"text\";\n  sections: Array<{\n    content: string;\n    type: \"page\" | \"heading\" | \"text\";\n  }>;\n}\n\n/**\n * Merge search results by URL, grouping sections and content under each URL (without hash)\n */\nexport function mergeResultsByUrl(results: SearchResult[], baseUrl: string): MergedResult[] {\n  const mergedMap = new Map<string, MergedResult>();\n\n  for (const result of results) {\n    // Strip hash to get base URL for merging\n    const baseUrlWithoutHash = result.url.split(\"#\")[0];\n    const existing = mergedMap.get(baseUrlWithoutHash);\n\n    if (existing) {\n      // Add this result as a section\n      existing.sections.push({\n        content: result.content,\n        type: result.type,\n      });\n    } else {\n      // Create new merged result\n      const urlWithMd = `${baseUrlWithoutHash}.md`;\n\n      const fullUrl = `https://${baseUrl}${baseUrlWithoutHash}`;\n      const fullUrlWithMd = `https://${baseUrl}${urlWithMd}`;\n\n      mergedMap.set(baseUrlWithoutHash, {\n        url: baseUrlWithoutHash,\n        urlWithMd,\n        fullUrl,\n        fullUrlWithMd,\n        title: result.type === \"page\" ? result.content : undefined,\n        breadcrumbs: result.breadcrumbs,\n        type: result.type,\n        sections: [\n          {\n            content: result.content,\n            type: result.type,\n          },\n        ],\n      });\n    }\n  }\n\n  return Array.from(mergedMap.values());\n}\n\n/**\n * Format merged results as markdown\n */\nexport function formatAsMarkdown(mergedResults: MergedResult[]): string {\n  const lines: string[] = [];\n\n  for (const result of mergedResults) {\n    // Title (use first section content if it's a page, or just use content)\n    const title = result.title || result.sections[0]?.content || \"Untitled\";\n    lines.push(`## Page: '${title}'`);\n    // Breadcrumbs\n    if (result.breadcrumbs && result.breadcrumbs.length > 0) {\n      lines.push(\"   \" + result.breadcrumbs.join(\" > \"));\n      lines.push(\"\");\n    }\n\n    // Both URLs\n    lines.push(\"URLs:\");\n    lines.push(`  - ${result.fullUrl}`);\n    lines.push(`  - ${result.fullUrlWithMd}`);\n    lines.push(\"\");\n\n    // Show all sections found on this page\n    if (result.sections.length > 1) {\n      lines.push(\"Relevant sections:\");\n      for (let i = 0; i < result.sections.length; i++) {\n        const section = result.sections[i];\n        // Skip the first section if it's just the page title repeated\n        if (i === 0 && result.type === \"page\" && section.content === result.title) {\n          continue;\n        }\n        lines.push(`  - ${section.content}`);\n      }\n      lines.push(\"\");\n    }\n\n    lines.push(\"---\");\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format merged results as JSON\n */\nexport function formatAsJson(mergedResults: MergedResult[]): string {\n  return JSON.stringify(mergedResults, null, 2);\n}\n","import { define } from \"gunshi\";\nimport {\n  mergeResultsByUrl,\n  formatAsMarkdown,\n  formatAsJson,\n} from \"../utils/format-search-results.js\";\n\ninterface SearchResult {\n  id: string;\n  type: \"page\" | \"heading\" | \"text\";\n  content: string;\n  breadcrumbs?: string[];\n  contentWithHighlights?: Array<{\n    type: string;\n    content: string;\n    styles?: { highlight?: boolean };\n  }>;\n  url: string;\n}\n\nexport const searchCommand = define({\n  name: \"search\",\n  description: \"Search the Fragno documentation\",\n  args: {\n    limit: {\n      type: \"number\",\n      description: \"Maximum number of results to show\",\n      default: 10,\n    },\n    json: {\n      type: \"boolean\",\n      description: \"Output results in JSON format\",\n      default: false,\n    },\n    markdown: {\n      type: \"boolean\",\n      description: \"Output results in Markdown format (default)\",\n      default: true,\n    },\n    \"base-url\": {\n      type: \"string\",\n      description: \"Base URL for the documentation site\",\n      default: \"fragno.dev\",\n    },\n  },\n  run: async (ctx) => {\n    const query = ctx.positionals.join(\" \");\n\n    if (!query || query.trim().length === 0) {\n      throw new Error(\"Please provide a search query\");\n    }\n\n    // Determine output mode\n    const jsonMode = ctx.values.json as boolean;\n    const baseUrl = ctx.values[\"base-url\"] as string;\n\n    if (!jsonMode) {\n      console.log(`Searching for: \"${query}\"\\n`);\n    }\n\n    try {\n      // Make request to the docs search API\n      const encodedQuery = encodeURIComponent(query);\n      const response = await fetch(`https://${baseUrl}/api/search?query=${encodedQuery}`);\n\n      if (!response.ok) {\n        throw new Error(`API request failed with status ${response.status}`);\n      }\n\n      const results = (await response.json()) as SearchResult[];\n\n      // Apply limit\n      const limit = ctx.values.limit as number;\n      const limitedResults = results.slice(0, limit);\n\n      if (limitedResults.length === 0) {\n        if (jsonMode) {\n          console.log(\"[]\");\n        } else {\n          console.log(\"No results found.\");\n        }\n        return;\n      }\n\n      // Merge results by URL\n      const mergedResults = mergeResultsByUrl(limitedResults, baseUrl);\n\n      // Output based on mode\n      if (jsonMode) {\n        console.log(formatAsJson(mergedResults));\n      } else {\n        // Markdown mode (default)\n        console.log(\n          `Found ${results.length} result${results.length === 1 ? \"\" : \"s\"}${results.length > limit ? ` (showing ${limit})` : \"\"}\\n`,\n        );\n        console.log(formatAsMarkdown(mergedResults));\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new Error(`Search failed: ${error.message}`);\n      }\n      throw new Error(\"Search failed: An unknown error occurred\");\n    }\n  },\n});\n","import { define } from \"gunshi\";\nimport { getSubjects, getSubject } from \"@fragno-dev/corpus\";\n\n/**\n * Print a subject with its examples\n */\nfunction printSubject(subject: ReturnType<typeof getSubject>[number]): void {\n  console.log(`\\n${\"=\".repeat(60)}`);\n  console.log(`${subject.title}`);\n  console.log(`${\"=\".repeat(60)}\\n`);\n\n  if (subject.description) {\n    console.log(subject.description);\n    console.log();\n  }\n\n  // Print imports block if present\n  if (subject.imports) {\n    console.log(\"### Imports\\n\");\n    console.log(\"```typescript\");\n    console.log(subject.imports);\n    console.log(\"```\\n\");\n  }\n\n  // Print init block if present\n  if (subject.init) {\n    console.log(\"### Initialization\\n\");\n    console.log(\"```typescript\");\n    console.log(subject.init);\n    console.log(\"```\\n\");\n  }\n\n  // Print examples\n  for (let i = 0; i < subject.examples.length; i++) {\n    const example = subject.examples[i];\n\n    console.log(`### Example ${i + 1}\\n`);\n    console.log(\"```typescript\");\n    console.log(example.code);\n    console.log(\"```\");\n\n    if (example.explanation) {\n      console.log();\n      console.log(example.explanation);\n    }\n\n    console.log();\n  }\n}\n\n/**\n * Print information about the corpus command\n */\nfunction printCorpusHelp(): void {\n  console.log(\"Fragno Corpus - Code examples and documentation\");\n  console.log(\"\");\n  console.log(\"Usage: fragno-cli corpus [topic...]\");\n  console.log(\"\");\n  console.log(\"Examples:\");\n  console.log(\"  fragno-cli corpus                           # List all available topics\");\n  console.log(\"  fragno-cli corpus defining-routes           # Show route definition examples\");\n  console.log(\"  fragno-cli corpus database-adapters kysely-adapter\");\n  console.log(\"                                              # Show multiple topics\");\n  console.log(\"\");\n  console.log(\"Available topics:\");\n\n  const subjects = getSubjects();\n  for (const subject of subjects) {\n    console.log(`  ${subject.id.padEnd(30)} ${subject.title}`);\n  }\n}\n\nexport const corpusCommand = define({\n  name: \"corpus\",\n  description: \"View code examples and documentation for Fragno\",\n  run: (ctx) => {\n    const topics = ctx.positionals;\n\n    // No topics provided - show help\n    if (topics.length === 0) {\n      printCorpusHelp();\n      return;\n    }\n\n    // Load and display requested topics\n    try {\n      const subjects = getSubject(...topics);\n\n      for (const subject of subjects) {\n        printSubject(subject);\n      }\n\n      console.log(`${\"=\".repeat(60)}`);\n      console.log(`Displayed ${subjects.length} topic(s)`);\n      console.log(`${\"=\".repeat(60)}\\n`);\n    } catch (error) {\n      console.error(\"Error loading topics:\", error instanceof Error ? error.message : error);\n      console.log(\"\\nRun 'fragno-cli corpus' to see available topics.\");\n      process.exit(1);\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\";\nimport { searchCommand } from \"./commands/search.js\";\nimport { corpusCommand } from \"./commands/corpus.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);\nrootSubCommands.set(\"search\", searchCommand);\nrootSubCommands.set(\"corpus\", corpusCommand);\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(\"  search   Search the Fragno documentation\");\n    console.log(\"  corpus   View code examples and documentation\");\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 the search or corpus command directly\n    if (args[0] === \"search\") {\n      const searchArgs = args.slice(1);\n      await cli(searchArgs, searchCommand);\n    } else if (args[0] === \"corpus\") {\n      const corpusArgs = args.slice(1);\n      await cli(corpusArgs, corpusCommand);\n    } else 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, searchCommand, corpusCommand };\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/cli",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "exports": {
     ".": {
       "development": "./src/cli.ts",
@@ -24,8 +24,9 @@
     "@clack/prompts": "^0.11.0",
     "c12": "^3.3.1",
     "gunshi": "^0.26.3",
-    "@fragno-dev/core": "0.1.5",
-    "@fragno-dev/db": "0.1.11"
+    "@fragno-dev/core": "0.1.6",
+    "@fragno-dev/db": "0.1.12",
+    "@fragno-dev/corpus": "0.0.2"
   },
   "main": "./dist/cli.js",
   "module": "./dist/cli.js",

package/src/cli.ts

@@ -4,6 +4,8 @@ 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";
+import { searchCommand } from "./commands/search.js";
+import { corpusCommand } from "./commands/corpus.js";
 
 // Create a Map of db sub-commands
 const dbSubCommands = new Map();
@@ -35,6 +37,8 @@ export const dbCommand = define({
 // Create a Map of root sub-commands
 const rootSubCommands = new Map();
 rootSubCommands.set("db", dbCommand);
+rootSubCommands.set("search", searchCommand);
+rootSubCommands.set("corpus", corpusCommand);
 
 // Define the main command with type safety
 export const mainCommand = define({
@@ -46,7 +50,9 @@ export const mainCommand = define({
     console.log("Usage: fragno-cli <command> [options]");
     console.log("");
     console.log("Commands:");
-    console.log("  db    Database management commands");
+    console.log("  db       Database management commands");
+    console.log("  search   Search the Fragno documentation");
+    console.log("  corpus   View code examples and documentation");
     console.log("");
     console.log("Run 'fragno-cli <command> --help' for more information.");
   },
@@ -57,8 +63,14 @@ if (import.meta.main) {
     // 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) {
+    // Check if we're calling the search or corpus command directly
+    if (args[0] === "search") {
+      const searchArgs = args.slice(1);
+      await cli(searchArgs, searchCommand);
+    } else if (args[0] === "corpus") {
+      const corpusArgs = args.slice(1);
+      await cli(corpusArgs, corpusCommand);
+    } else if (args[0] === "db" && args.length > 1) {
       const subCommandName = args[1];
 
       // Check if it's a help request
@@ -110,4 +122,4 @@ if (import.meta.main) {
   }
 }
 
-export { generateCommand, migrateCommand, infoCommand };
+export { generateCommand, migrateCommand, infoCommand, searchCommand, corpusCommand };

package/src/commands/corpus.ts

@@ -0,0 +1,102 @@
+import { define } from "gunshi";
+import { getSubjects, getSubject } from "@fragno-dev/corpus";
+
+/**
+ * Print a subject with its examples
+ */
+function printSubject(subject: ReturnType<typeof getSubject>[number]): void {
+  console.log(`\n${"=".repeat(60)}`);
+  console.log(`${subject.title}`);
+  console.log(`${"=".repeat(60)}\n`);
+
+  if (subject.description) {
+    console.log(subject.description);
+    console.log();
+  }
+
+  // Print imports block if present
+  if (subject.imports) {
+    console.log("### Imports\n");
+    console.log("```typescript");
+    console.log(subject.imports);
+    console.log("```\n");
+  }
+
+  // Print init block if present
+  if (subject.init) {
+    console.log("### Initialization\n");
+    console.log("```typescript");
+    console.log(subject.init);
+    console.log("```\n");
+  }
+
+  // Print examples
+  for (let i = 0; i < subject.examples.length; i++) {
+    const example = subject.examples[i];
+
+    console.log(`### Example ${i + 1}\n`);
+    console.log("```typescript");
+    console.log(example.code);
+    console.log("```");
+
+    if (example.explanation) {
+      console.log();
+      console.log(example.explanation);
+    }
+
+    console.log();
+  }
+}
+
+/**
+ * Print information about the corpus command
+ */
+function printCorpusHelp(): void {
+  console.log("Fragno Corpus - Code examples and documentation");
+  console.log("");
+  console.log("Usage: fragno-cli corpus [topic...]");
+  console.log("");
+  console.log("Examples:");
+  console.log("  fragno-cli corpus                           # List all available topics");
+  console.log("  fragno-cli corpus defining-routes           # Show route definition examples");
+  console.log("  fragno-cli corpus database-adapters kysely-adapter");
+  console.log("                                              # Show multiple topics");
+  console.log("");
+  console.log("Available topics:");
+
+  const subjects = getSubjects();
+  for (const subject of subjects) {
+    console.log(`  ${subject.id.padEnd(30)} ${subject.title}`);
+  }
+}
+
+export const corpusCommand = define({
+  name: "corpus",
+  description: "View code examples and documentation for Fragno",
+  run: (ctx) => {
+    const topics = ctx.positionals;
+
+    // No topics provided - show help
+    if (topics.length === 0) {
+      printCorpusHelp();
+      return;
+    }
+
+    // Load and display requested topics
+    try {
+      const subjects = getSubject(...topics);
+
+      for (const subject of subjects) {
+        printSubject(subject);
+      }
+
+      console.log(`${"=".repeat(60)}`);
+      console.log(`Displayed ${subjects.length} topic(s)`);
+      console.log(`${"=".repeat(60)}\n`);
+    } catch (error) {
+      console.error("Error loading topics:", error instanceof Error ? error.message : error);
+      console.log("\nRun 'fragno-cli corpus' to see available topics.");
+      process.exit(1);
+    }
+  },
+});

package/src/commands/search.ts

@@ -0,0 +1,105 @@
+import { define } from "gunshi";
+import {
+  mergeResultsByUrl,
+  formatAsMarkdown,
+  formatAsJson,
+} from "../utils/format-search-results.js";
+
+interface SearchResult {
+  id: string;
+  type: "page" | "heading" | "text";
+  content: string;
+  breadcrumbs?: string[];
+  contentWithHighlights?: Array<{
+    type: string;
+    content: string;
+    styles?: { highlight?: boolean };
+  }>;
+  url: string;
+}
+
+export const searchCommand = define({
+  name: "search",
+  description: "Search the Fragno documentation",
+  args: {
+    limit: {
+      type: "number",
+      description: "Maximum number of results to show",
+      default: 10,
+    },
+    json: {
+      type: "boolean",
+      description: "Output results in JSON format",
+      default: false,
+    },
+    markdown: {
+      type: "boolean",
+      description: "Output results in Markdown format (default)",
+      default: true,
+    },
+    "base-url": {
+      type: "string",
+      description: "Base URL for the documentation site",
+      default: "fragno.dev",
+    },
+  },
+  run: async (ctx) => {
+    const query = ctx.positionals.join(" ");
+
+    if (!query || query.trim().length === 0) {
+      throw new Error("Please provide a search query");
+    }
+
+    // Determine output mode
+    const jsonMode = ctx.values.json as boolean;
+    const baseUrl = ctx.values["base-url"] as string;
+
+    if (!jsonMode) {
+      console.log(`Searching for: "${query}"\n`);
+    }
+
+    try {
+      // Make request to the docs search API
+      const encodedQuery = encodeURIComponent(query);
+      const response = await fetch(`https://${baseUrl}/api/search?query=${encodedQuery}`);
+
+      if (!response.ok) {
+        throw new Error(`API request failed with status ${response.status}`);
+      }
+
+      const results = (await response.json()) as SearchResult[];
+
+      // Apply limit
+      const limit = ctx.values.limit as number;
+      const limitedResults = results.slice(0, limit);
+
+      if (limitedResults.length === 0) {
+        if (jsonMode) {
+          console.log("[]");
+        } else {
+          console.log("No results found.");
+        }
+        return;
+      }
+
+      // Merge results by URL
+      const mergedResults = mergeResultsByUrl(limitedResults, baseUrl);
+
+      // Output based on mode
+      if (jsonMode) {
+        console.log(formatAsJson(mergedResults));
+      } else {
+        // Markdown mode (default)
+        console.log(
+          `Found ${results.length} result${results.length === 1 ? "" : "s"}${results.length > limit ? ` (showing ${limit})` : ""}\n`,
+        );
+        console.log(formatAsMarkdown(mergedResults));
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`Search failed: ${error.message}`);
+      }
+      throw new Error("Search failed: An unknown error occurred");
+    }
+  },
+});

package/src/utils/format-search-results.ts

@@ -0,0 +1,121 @@
+interface SearchResult {
+  id: string;
+  type: "page" | "heading" | "text";
+  content: string;
+  breadcrumbs?: string[];
+  contentWithHighlights?: Array<{
+    type: string;
+    content: string;
+    styles?: { highlight?: boolean };
+  }>;
+  url: string;
+}
+
+interface MergedResult {
+  url: string;
+  urlWithMd: string;
+  fullUrl: string;
+  fullUrlWithMd: string;
+  title?: string;
+  breadcrumbs?: string[];
+  type: "page" | "heading" | "text";
+  sections: Array<{
+    content: string;
+    type: "page" | "heading" | "text";
+  }>;
+}
+
+/**
+ * Merge search results by URL, grouping sections and content under each URL (without hash)
+ */
+export function mergeResultsByUrl(results: SearchResult[], baseUrl: string): MergedResult[] {
+  const mergedMap = new Map<string, MergedResult>();
+
+  for (const result of results) {
+    // Strip hash to get base URL for merging
+    const baseUrlWithoutHash = result.url.split("#")[0];
+    const existing = mergedMap.get(baseUrlWithoutHash);
+
+    if (existing) {
+      // Add this result as a section
+      existing.sections.push({
+        content: result.content,
+        type: result.type,
+      });
+    } else {
+      // Create new merged result
+      const urlWithMd = `${baseUrlWithoutHash}.md`;
+
+      const fullUrl = `https://${baseUrl}${baseUrlWithoutHash}`;
+      const fullUrlWithMd = `https://${baseUrl}${urlWithMd}`;
+
+      mergedMap.set(baseUrlWithoutHash, {
+        url: baseUrlWithoutHash,
+        urlWithMd,
+        fullUrl,
+        fullUrlWithMd,
+        title: result.type === "page" ? result.content : undefined,
+        breadcrumbs: result.breadcrumbs,
+        type: result.type,
+        sections: [
+          {
+            content: result.content,
+            type: result.type,
+          },
+        ],
+      });
+    }
+  }
+
+  return Array.from(mergedMap.values());
+}
+
+/**
+ * Format merged results as markdown
+ */
+export function formatAsMarkdown(mergedResults: MergedResult[]): string {
+  const lines: string[] = [];
+
+  for (const result of mergedResults) {
+    // Title (use first section content if it's a page, or just use content)
+    const title = result.title || result.sections[0]?.content || "Untitled";
+    lines.push(`## Page: '${title}'`);
+    // Breadcrumbs
+    if (result.breadcrumbs && result.breadcrumbs.length > 0) {
+      lines.push("   " + result.breadcrumbs.join(" > "));
+      lines.push("");
+    }
+
+    // Both URLs
+    lines.push("URLs:");
+    lines.push(`  - ${result.fullUrl}`);
+    lines.push(`  - ${result.fullUrlWithMd}`);
+    lines.push("");
+
+    // Show all sections found on this page
+    if (result.sections.length > 1) {
+      lines.push("Relevant sections:");
+      for (let i = 0; i < result.sections.length; i++) {
+        const section = result.sections[i];
+        // Skip the first section if it's just the page title repeated
+        if (i === 0 && result.type === "page" && section.content === result.title) {
+          continue;
+        }
+        lines.push(`  - ${section.content}`);
+      }
+      lines.push("");
+    }
+
+    lines.push("---");
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+/**
+ * Format merged results as JSON
+ */
+export function formatAsJson(mergedResults: MergedResult[]): string {
+  return JSON.stringify(mergedResults, null, 2);
+}