@fragno-dev/cli 0.2.0 → 0.2.3

package/dist/cli.js

@@ -1,186 +1,12 @@
 #!/usr/bin/env node
+import { n as importFragmentFiles } from "./find-fragno-databases-Depht1jV.js";
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { cli, define } from "gunshi";
-import { access, mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join, relative, resolve } from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
 import { executeMigrations, generateSchemaArtifacts } from "@fragno-dev/db/generation-engine";
-import { FragnoDatabase, isFragnoDatabase } from "@fragno-dev/db";
-import { fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "@fragno-dev/db/adapters";
-import { instantiatedFragmentFakeSymbol } from "@fragno-dev/core/internal/symbols";
-import "@fragno-dev/core";
-import { loadConfig } from "c12";
-import { constants, readFileSync } from "node:fs";
-import { getAllSubjectIdsInOrder, getAllSubjects, getCategoryTitle, getSubject, getSubjectChildren, getSubjectParent, getSubjects, isCategory } from "@fragno-dev/corpus";
-import { marked } from "marked";
-import { markedTerminal } from "marked-terminal";
-import { stripVTControlCharacters } from "node:util";
-import { fileURLToPath } from "node:url";
-
-//#region src/utils/load-config.ts
-/**
-* Checks if a file exists using async API.
-*/
-async function fileExists(path) {
-	try {
-		await access(path, constants.F_OK);
-		return true;
-	} catch {
-		return false;
-	}
-}
-/**
-* Walks up the directory tree from the target path to find a tsconfig.json file.
-*/
-async function findTsconfig(startPath) {
-	let currentDir = dirname(startPath);
-	const root = resolve("/");
-	while (currentDir !== root) {
-		const tsconfigPath = join(currentDir, "tsconfig.json");
-		if (await fileExists(tsconfigPath)) return tsconfigPath;
-		currentDir = dirname(currentDir);
-	}
-	return null;
-}
-/**
-* Strips comments from JSONC (JSON with Comments) content.
-*/
-function stripJsonComments(jsonc) {
-	let result = jsonc.replace(/\/\/[^\n]*/g, "");
-	result = result.replace(/\/\*[\s\S]*?\*\//g, "");
-	return result;
-}
-/**
-* Converts TypeScript path aliases to jiti alias format.
-* Strips trailing '*' from aliases and paths, and resolves paths relative to baseUrl.
-*/
-function convertTsconfigPathsToJitiAlias(tsconfigPaths, baseUrlResolved) {
-	return Object.fromEntries(Object.entries(tsconfigPaths).map(([_alias, paths]) => {
-		const pathsArray = paths;
-		return [_alias.endsWith("*") ? _alias.slice(0, -1) : _alias, resolve(baseUrlResolved, pathsArray[0].endsWith("*") ? pathsArray[0].slice(0, -1) : pathsArray[0])];
-	}));
-}
-/**
-* Resolves tsconfig path aliases for use with jiti.
-*/
-async function resolveTsconfigAliases(targetPath) {
-	const tsconfigPath = await findTsconfig(targetPath);
-	if (!tsconfigPath) return {};
-	try {
-		const jsonContent = stripJsonComments(await readFile(tsconfigPath, "utf-8"));
-		const tsconfig = JSON.parse(jsonContent);
-		const tsconfigPaths = tsconfig?.compilerOptions?.paths;
-		if (!tsconfigPaths || typeof tsconfigPaths !== "object") return {};
-		return convertTsconfigPathsToJitiAlias(tsconfigPaths, resolve(dirname(tsconfigPath), tsconfig?.compilerOptions?.baseUrl || "."));
-	} catch (error) {
-		console.warn(`Warning: Failed to parse tsconfig at ${tsconfigPath}:`, error);
-		return {};
-	}
-}
-/**
-* Loads a config file using c12 with automatic tsconfig path alias resolution.
-*/
-async function loadConfig$1(path) {
-	const { config } = await loadConfig({
-		configFile: path,
-		jitiOptions: { alias: await resolveTsconfigAliases(path) }
-	});
-	return config;
-}
-
-//#endregion
-//#region src/utils/find-fragno-databases.ts
-async function importFragmentFile(path) {
-	process.env["FRAGNO_INIT_DRY_RUN"] = "true";
-	try {
-		const databases = findFragnoDatabases(await loadConfig$1(path));
-		const adapterNames = databases.map((db) => `${db.adapter[fragnoDatabaseAdapterNameFakeSymbol]}@${db.adapter[fragnoDatabaseAdapterVersionFakeSymbol]}`);
-		if ([...new Set(adapterNames)].length > 1) throw new Error(`All Fragno databases must use the same adapter name and version. Found mismatch: (${adapterNames.join(", ")})`);
-		return {
-			adapter: databases[0].adapter,
-			databases
-		};
-	} finally {
-		delete process.env["FRAGNO_INIT_DRY_RUN"];
-	}
-}
-/**
-* Imports multiple fragment files and validates they all use the same adapter.
-* Returns the combined databases from all files.
-*/
-async function importFragmentFiles(paths) {
-	const uniquePaths = Array.from(new Set(paths));
-	if (uniquePaths.length === 0) throw new Error("No fragment files provided");
-	const allDatabases = [];
-	let adapter;
-	let firstAdapterFile;
-	const cwd = process.cwd();
-	for (const path of uniquePaths) {
-		const relativePath = relative(cwd, path);
-		try {
-			const result = await importFragmentFile(path);
-			const databases = result["databases"];
-			const fileAdapter = result["adapter"];
-			if (databases.length === 0) {
-				console.warn(`Warning: No FragnoDatabase instances found in ${relativePath}.\nMake sure you export either:\n  - A FragnoDatabase instance created with .create(adapter)\n  - An instantiated fragment with embedded database definition\n`);
-				continue;
-			}
-			if (!adapter) {
-				adapter = fileAdapter;
-				firstAdapterFile = relativePath;
-			}
-			const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];
-			const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];
-			const fileAdapterName = fileAdapter[fragnoDatabaseAdapterNameFakeSymbol];
-			const fileAdapterVersion = fileAdapter[fragnoDatabaseAdapterVersionFakeSymbol];
-			if (firstAdapterName !== fileAdapterName || firstAdapterVersion !== fileAdapterVersion) {
-				const firstAdapterInfo = `${firstAdapterName}@${firstAdapterVersion}`;
-				const fileAdapterInfo = `${fileAdapterName}@${fileAdapterVersion}`;
-				throw new Error(`All fragments must use the same database adapter. Mixed adapters found:\n  - ${firstAdapterFile}: ${firstAdapterInfo}\n  - ${relativePath}: ${fileAdapterInfo}\n\nMake sure all fragments use the same adapter name and version.`);
-			}
-			allDatabases.push(...databases);
-			console.log(`  Found ${databases.length} database(s) in ${relativePath}`);
-		} catch (error) {
-			throw new Error(`Failed to import fragment file ${relativePath}: ${error instanceof Error ? error.message : String(error)}`);
-		}
-	}
-	if (allDatabases.length === 0) throw new Error("No FragnoDatabase instances found in any of the target files.\nMake sure your files export either:\n  - A FragnoDatabase instance created with .create(adapter)\n  - An instantiated fragment with embedded database definition\n");
-	if (!adapter) throw new Error("No adapter found in any of the fragment files");
-	return {
-		adapter,
-		databases: allDatabases
-	};
-}
-function isNewFragnoInstantiatedFragment(value) {
-	return typeof value === "object" && value !== null && instantiatedFragmentFakeSymbol in value && value[instantiatedFragmentFakeSymbol] === instantiatedFragmentFakeSymbol;
-}
-/**
-* Finds all FragnoDatabase instances in a module, including those embedded
-* in instantiated fragments.
-*/
-function findFragnoDatabases(targetModule) {
-	const fragnoDatabases = [];
-	for (const [_key, value] of Object.entries(targetModule)) if (isFragnoDatabase(value)) fragnoDatabases.push(value);
-	else if (isNewFragnoInstantiatedFragment(value)) {
-		const internal = value.$internal;
-		const deps = internal.deps;
-		const options = internal.options;
-		if (!deps["db"] || !deps["schema"]) continue;
-		const schema = deps["schema"];
-		const namespace = deps["namespace"];
-		const databaseAdapter = options["databaseAdapter"];
-		if (!databaseAdapter) {
-			console.warn(`Warning: Fragment '${value.name}' appears to be a database fragment but no databaseAdapter found in options.`);
-			continue;
-		}
-		fragnoDatabases.push(new FragnoDatabase({
-			namespace,
-			schema,
-			adapter: databaseAdapter
-		}));
-	}
-	return fragnoDatabases;
-}
 
-//#endregion
 //#region src/commands/db/generate.ts
 const generateCommand = define({
 	name: "generate",
@@ -264,48 +90,6 @@ const generateCommand = define({
 	}
 });
 
-//#endregion
-//#region src/commands/db/migrate.ts
-const migrateCommand = define({
-	name: "migrate",
-	description: "Run SQL database migrations for all fragments to their latest versions",
-	args: {},
-	run: async (ctx) => {
-		const targets = ctx.positionals;
-		if (targets.length === 0) throw new Error("At least one target file path is required");
-		const { databases: allFragnoDatabases } = await importFragmentFiles(targets.map((target) => resolve(process.cwd(), target)));
-		console.log("\nMigrating all fragments to their latest versions...\n");
-		let results;
-		try {
-			results = await executeMigrations(allFragnoDatabases);
-		} catch (error) {
-			throw new Error(`Migration failed: ${error instanceof Error ? error.message : String(error)}`);
-		}
-		for (const result of results) {
-			console.log(`Fragment: ${result.namespace}`);
-			console.log(`  Current version: ${result.fromVersion}`);
-			console.log(`  Target version: ${result.toVersion}`);
-			if (result.didMigrate) console.log(`  ✓ Migration completed: v${result.fromVersion} → v${result.toVersion}\n`);
-			else console.log(`  ✓ Already at latest version. No migration needed.\n`);
-		}
-		console.log("═══════════════════════════════════════");
-		console.log("Migration Summary");
-		console.log("═══════════════════════════════════════");
-		const migrated = results.filter((r) => r.didMigrate);
-		const skipped = results.filter((r) => !r.didMigrate);
-		if (migrated.length > 0) {
-			console.log(`\n✓ Migrated ${migrated.length} fragment(s):`);
-			for (const r of migrated) console.log(`  - ${r.namespace}: v${r.fromVersion} → v${r.toVersion}`);
-		}
-		if (skipped.length > 0) {
-			console.log(`\n○ Skipped ${skipped.length} fragment(s) (already up-to-date):`);
-			for (const r of skipped) console.log(`  - ${r.namespace}: v${r.toVersion}`);
-		}
-		for (const db of allFragnoDatabases) await db.adapter.close();
-		console.log("\n✓ All migrations completed successfully");
-	}
-});
-
 //#endregion
 //#region src/commands/db/info.ts
 const infoCommand = define({
@@ -368,6 +152,48 @@ const infoCommand = define({
 	}
 });
 
+//#endregion
+//#region src/commands/db/migrate.ts
+const migrateCommand = define({
+	name: "migrate",
+	description: "Run SQL database migrations for all fragments to their latest versions",
+	args: {},
+	run: async (ctx) => {
+		const targets = ctx.positionals;
+		if (targets.length === 0) throw new Error("At least one target file path is required");
+		const { databases: allFragnoDatabases } = await importFragmentFiles(targets.map((target) => resolve(process.cwd(), target)));
+		console.log("\nMigrating all fragments to their latest versions...\n");
+		let results;
+		try {
+			results = await executeMigrations(allFragnoDatabases);
+		} catch (error) {
+			throw new Error(`Migration failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		for (const result of results) {
+			console.log(`Fragment: ${result.namespace}`);
+			console.log(`  Current version: ${result.fromVersion}`);
+			console.log(`  Target version: ${result.toVersion}`);
+			if (result.didMigrate) console.log(`  ✓ Migration completed: v${result.fromVersion} → v${result.toVersion}\n`);
+			else console.log(`  ✓ Already at latest version. No migration needed.\n`);
+		}
+		console.log("═══════════════════════════════════════");
+		console.log("Migration Summary");
+		console.log("═══════════════════════════════════════");
+		const migrated = results.filter((r) => r.didMigrate);
+		const skipped = results.filter((r) => !r.didMigrate);
+		if (migrated.length > 0) {
+			console.log(`\n✓ Migrated ${migrated.length} fragment(s):`);
+			for (const r of migrated) console.log(`  - ${r.namespace}: v${r.fromVersion} → v${r.toVersion}`);
+		}
+		if (skipped.length > 0) {
+			console.log(`\n○ Skipped ${skipped.length} fragment(s) (already up-to-date):`);
+			for (const r of skipped) console.log(`  - ${r.namespace}: v${r.toVersion}`);
+		}
+		for (const db of allFragnoDatabases) await db.adapter.close();
+		console.log("\n✓ All migrations completed successfully");
+	}
+});
+
 //#endregion
 //#region src/utils/format-search-results.ts
 /**
@@ -498,403 +324,6 @@ const searchCommand = define({
 	}
 });
 
-//#endregion
-//#region src/commands/corpus.ts
-marked.use(markedTerminal());
-/**
-* Build markdown content for multiple subjects
-*/
-function buildSubjectsMarkdown(subjects) {
-	let fullMarkdown = "";
-	for (const subject of subjects) {
-		fullMarkdown += `# ${subject.title}\n\n`;
-		if (subject.description) fullMarkdown += `${subject.description}\n\n`;
-		if (subject.imports) fullMarkdown += `### Imports\n\n\`\`\`typescript\n${subject.imports}\n\`\`\`\n\n`;
-		if (subject.prelude.length > 0) {
-			fullMarkdown += `### Prelude\n\n`;
-			for (const block of subject.prelude) fullMarkdown += `\`\`\`typescript\n${block.code}\n\`\`\`\n\n`;
-		}
-		for (const section of subject.sections) fullMarkdown += `## ${section.heading}\n\n${section.content}\n\n`;
-	}
-	return fullMarkdown;
-}
-/**
-* Add line numbers to content
-*/
-function addLineNumbers(content, startFrom = 1) {
-	const lines = content.split("\n");
-	const maxDigits = String(startFrom + lines.length - 1).length;
-	return lines.map((line, index) => {
-		const lineNum = startFrom + index;
-		return `${String(lineNum).padStart(maxDigits, " ")}│ ${line}`;
-	}).join("\n");
-}
-/**
-* Filter content by line range
-*/
-function filterByLineRange(content, startLine, endLine) {
-	const lines = content.split("\n");
-	const start = Math.max(0, startLine - 1);
-	const end = Math.min(lines.length, endLine);
-	return lines.slice(start, end).join("\n");
-}
-/**
-* Extract headings and code block information with line numbers
-*/
-function extractHeadingsAndBlocks(subjects) {
-	let output = "";
-	let currentLine = 1;
-	let lastOutputLine = 0;
-	const addGapIfNeeded = () => {
-		if (lastOutputLine > 0 && currentLine > lastOutputLine + 1) output += `    │\n`;
-	};
-	output += "Use --start N --end N flags to show specific line ranges\n\n";
-	for (const subject of subjects) {
-		addGapIfNeeded();
-		output += `${currentLine.toString().padStart(4, " ")}│ # ${subject.title}\n`;
-		lastOutputLine = currentLine;
-		currentLine += 1;
-		output += `${currentLine.toString().padStart(4, " ")}│\n`;
-		lastOutputLine = currentLine;
-		currentLine += 1;
-		if (subject.description) {
-			const descLines = subject.description.split("\n");
-			for (const line of descLines) {
-				output += `${currentLine.toString().padStart(4, " ")}│ ${line}\n`;
-				lastOutputLine = currentLine;
-				currentLine += 1;
-			}
-			output += `${currentLine.toString().padStart(4, " ")}│\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-		}
-		if (subject.imports) {
-			addGapIfNeeded();
-			output += `${currentLine.toString().padStart(4, " ")}│ ### Imports\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			output += `${currentLine.toString().padStart(4, " ")}│\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			output += `${currentLine.toString().padStart(4, " ")}│ \`\`\`typescript\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			const importLines = subject.imports.split("\n");
-			for (const line of importLines) {
-				output += `${currentLine.toString().padStart(4, " ")}│ ${line}\n`;
-				lastOutputLine = currentLine;
-				currentLine += 1;
-			}
-			output += `${currentLine.toString().padStart(4, " ")}│ \`\`\`\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			output += `${currentLine.toString().padStart(4, " ")}│\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-		}
-		if (subject.prelude.length > 0) {
-			addGapIfNeeded();
-			output += `${currentLine.toString().padStart(4, " ")}│ ### Prelude\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			output += `${currentLine.toString().padStart(4, " ")}│\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			for (const block of subject.prelude) {
-				const id = block.id || "(no-id)";
-				const blockStartLine = currentLine + 1;
-				const codeLines = block.code.split("\n").length;
-				const blockEndLine = currentLine + 1 + codeLines;
-				output += `${currentLine.toString().padStart(4, " ")}│   - id: \`${id}\`, L${blockStartLine}-${blockEndLine}\n`;
-				lastOutputLine = currentLine;
-				currentLine += codeLines + 3;
-			}
-			lastOutputLine = currentLine - 1;
-		}
-		const sectionToExamples = /* @__PURE__ */ new Map();
-		for (const example of subject.examples) for (const section of subject.sections) if (section.content.includes(example.code.substring(0, Math.min(50, example.code.length)))) {
-			if (!sectionToExamples.has(section.heading)) sectionToExamples.set(section.heading, []);
-			sectionToExamples.get(section.heading).push(example);
-			break;
-		}
-		for (const section of subject.sections) {
-			addGapIfNeeded();
-			output += `${currentLine.toString().padStart(4, " ")}│ ## ${section.heading}\n`;
-			lastOutputLine = currentLine;
-			currentLine += 1;
-			const examples = sectionToExamples.get(section.heading) || [];
-			if (examples.length > 0) {
-				const sectionStartLine = currentLine;
-				const lines = section.content.split("\n");
-				for (const example of examples) {
-					const id = example.id || "(no-id)";
-					let blockStartLine = sectionStartLine;
-					let blockEndLine = sectionStartLine;
-					let foundBlock = false;
-					for (let i = 0; i < lines.length; i++) if (lines[i].trim().startsWith("```") && true) {
-						const codeStart = i + 1;
-						let matches = true;
-						const exampleLines = example.code.split("\n");
-						for (let j = 0; j < Math.min(3, exampleLines.length); j++) if (lines[codeStart + j]?.trim() !== exampleLines[j]?.trim()) {
-							matches = false;
-							break;
-						}
-						if (matches) {
-							blockStartLine = sectionStartLine + i + 1;
-							blockEndLine = sectionStartLine + i + exampleLines.length;
-							foundBlock = true;
-							break;
-						}
-					}
-					if (foundBlock) output += `${currentLine.toString().padStart(4, " ")}│   - id: \`${id}\`, L${blockStartLine}-${blockEndLine}\n`;
-					else output += `${currentLine.toString().padStart(4, " ")}│   - id: \`${id}\`\n`;
-					lastOutputLine = currentLine;
-				}
-			}
-			const sectionLines = section.content.split("\n");
-			for (const _line of sectionLines) currentLine += 1;
-			currentLine += 1;
-			lastOutputLine = currentLine - 1;
-		}
-	}
-	return output;
-}
-/**
-* Print subjects with the given options
-*/
-async function printSubjects(subjects, options) {
-	if (options.headingsOnly) {
-		const headingsOutput = extractHeadingsAndBlocks(subjects);
-		console.log(headingsOutput);
-		return;
-	}
-	const markdown = buildSubjectsMarkdown(subjects);
-	let output = await marked.parse(markdown);
-	const startLine = options.startLine ?? 1;
-	if (options.startLine !== void 0 || options.endLine !== void 0) {
-		const end = options.endLine ?? output.split("\n").length;
-		output = filterByLineRange(output, startLine, end);
-	}
-	if (options.showLineNumbers) output = addLineNumbers(output, startLine);
-	console.log(output);
-}
-/**
-* Find and print code blocks by ID
-*/
-async function printCodeBlockById(id, topics, showLineNumbers) {
-	const subjects = topics.length > 0 ? getSubject(...topics) : getAllSubjects();
-	const matches = [];
-	for (const subject of subjects) {
-		const fullMarkdown = buildSubjectsMarkdown([subject]);
-		const renderedLines = (await marked.parse(fullMarkdown)).split("\n");
-		for (const block of subject.prelude) if (block.id === id) {
-			let startLine;
-			let endLine;
-			const codeLines = block.code.split("\n");
-			const firstCodeLine = codeLines[0].trim();
-			for (let i = 0; i < renderedLines.length; i++) if (stripVTControlCharacters(renderedLines[i]).trim() === firstCodeLine) {
-				startLine = i + 1;
-				endLine = i + codeLines.length;
-				break;
-			}
-			matches.push({
-				subjectId: subject.id,
-				subjectTitle: subject.title,
-				section: "Prelude",
-				code: block.code,
-				type: "prelude",
-				startLine,
-				endLine
-			});
-		}
-		for (const example of subject.examples) if (example.id === id) {
-			let sectionName = "Unknown Section";
-			let startLine;
-			let endLine;
-			for (const section of subject.sections) if (section.content.includes(example.code.substring(0, Math.min(50, example.code.length)))) {
-				sectionName = section.heading;
-				const codeLines = example.code.split("\n");
-				const firstCodeLine = codeLines[0].trim();
-				for (let i = 0; i < renderedLines.length; i++) if (stripVTControlCharacters(renderedLines[i]).trim() === firstCodeLine) {
-					startLine = i + 1;
-					endLine = i + codeLines.length;
-					break;
-				}
-				break;
-			}
-			matches.push({
-				subjectId: subject.id,
-				subjectTitle: subject.title,
-				section: sectionName,
-				code: example.code,
-				type: "example",
-				startLine,
-				endLine
-			});
-		}
-	}
-	if (matches.length === 0) {
-		console.error(`Error: No code block found with id "${id}"`);
-		if (topics.length > 0) console.error(`Searched in topics: ${topics.join(", ")}`);
-		else console.error("Searched in all available topics");
-		process.exit(1);
-	}
-	for (let i = 0; i < matches.length; i++) {
-		const match = matches[i];
-		if (matches.length > 1 && i > 0) console.log("\n---\n");
-		let matchMarkdown = `# ${match.subjectTitle}\n\n`;
-		matchMarkdown += `## ${match.section}\n\n`;
-		if (showLineNumbers && match.startLine && match.endLine) console.log(`Lines ${match.startLine}-${match.endLine} (use with --start/--end)\n`);
-		matchMarkdown += `\`\`\`typescript\n${match.code}\n\`\`\`\n`;
-		const rendered = await marked.parse(matchMarkdown);
-		console.log(rendered);
-	}
-}
-/**
-* Print only the topic tree
-*/
-function printTopicTree() {
-	const subjects = getSubjects();
-	const subjectMap = new Map(subjects.map((s) => [s.id, s]));
-	function getTitle(subjectId) {
-		if (isCategory(subjectId)) return getCategoryTitle(subjectId);
-		const subject = subjectMap.get(subjectId);
-		return subject ? subject.title : subjectId;
-	}
-	function displayNode(subjectId, indent, isLast, isRoot) {
-		const title = getTitle(subjectId);
-		if (isRoot) console.log(`  ${subjectId.padEnd(30)} ${title}`);
-		else {
-			const connector = isLast ? "└─" : "├─";
-			console.log(`${indent}${connector} ${subjectId.padEnd(26)} ${title}`);
-		}
-		const children = getSubjectChildren(subjectId);
-		if (children.length > 0) {
-			const childIndent = isRoot ? "    " : indent + (isLast ? "   " : "│  ");
-			for (let i = 0; i < children.length; i++) displayNode(children[i], childIndent, i === children.length - 1, false);
-		}
-	}
-	const rootIds = getAllSubjectIdsInOrder().filter((id) => !getSubjectParent(id));
-	for (const subjectId of rootIds) displayNode(subjectId, "", false, true);
-}
-/**
-* Print information about the corpus command
-*/
-function printCorpusHelp() {
-	console.log("Fragno Corpus - Code examples and documentation (similar to LLMs.txt");
-	console.log("");
-	console.log("Usage: fragno-cli corpus [options] [topic...]");
-	console.log("");
-	console.log("Options:");
-	console.log("  -n, --no-line-numbers      Hide line numbers (shown by default)");
-	console.log("  -s, --start N              Starting line number to display from");
-	console.log("  -e, --end N                Ending line number to display to");
-	console.log("  --headings                 Show only headings and code block IDs");
-	console.log("  --id <id>                  Retrieve a specific code block by ID");
-	console.log("  --tree                     Show only the topic tree");
-	console.log("");
-	console.log("Examples:");
-	console.log("  fragno-cli corpus                           # List all available topics");
-	console.log("  fragno-cli corpus --tree                    # Show only the topic tree");
-	console.log("  fragno-cli corpus defining-routes           # Show route definition examples");
-	console.log("  fragno-cli corpus --headings database-querying");
-	console.log("                                              # Show structure overview");
-	console.log("  fragno-cli corpus --start 10 --end 50 database-querying");
-	console.log("                                              # Show specific lines");
-	console.log("  fragno-cli corpus --id create-user          # Get code block by ID");
-	console.log("  fragno-cli corpus database-adapters kysely-adapter");
-	console.log("                                              # Show multiple topics");
-	console.log("");
-	console.log("Available topics:");
-	printTopicTree();
-}
-const corpusCommand = define({
-	name: "corpus",
-	description: "View code examples and documentation for Fragno",
-	args: {
-		"no-line-numbers": {
-			type: "boolean",
-			short: "n",
-			description: "Hide line numbers (line numbers are shown by default)"
-		},
-		start: {
-			type: "number",
-			short: "s",
-			description: "Starting line number (1-based) to display from"
-		},
-		end: {
-			type: "number",
-			short: "e",
-			description: "Ending line number (1-based) to display to"
-		},
-		headings: {
-			type: "boolean",
-			description: "Show only section headings and code block IDs with line numbers"
-		},
-		id: {
-			type: "string",
-			description: "Retrieve a specific code block by ID"
-		},
-		tree: {
-			type: "boolean",
-			description: "Show only the topic tree (without help text)"
-		}
-	},
-	run: async (ctx) => {
-		const topics = ctx.positionals;
-		const showLineNumbers = !(ctx.values["no-line-numbers"] ?? false);
-		const startLine = ctx.values.start;
-		const endLine = ctx.values.end;
-		const headingsOnly = ctx.values.headings ?? false;
-		const codeBlockId = ctx.values.id;
-		const treeOnly = ctx.values.tree ?? false;
-		if (codeBlockId) {
-			await printCodeBlockById(codeBlockId, topics, showLineNumbers);
-			return;
-		}
-		if (treeOnly) {
-			printTopicTree();
-			return;
-		}
-		if (topics.length === 0) {
-			printCorpusHelp();
-			return;
-		}
-		if (startLine !== void 0 && endLine !== void 0 && startLine > endLine) {
-			console.error("Error: --start must be less than or equal to --end");
-			process.exit(1);
-		}
-		try {
-			await printSubjects(getSubject(...topics), {
-				showLineNumbers,
-				startLine,
-				endLine,
-				headingsOnly
-			});
-		} catch (error) {
-			if (error instanceof Error && error.message.includes("ENOENT")) {
-				const missingTopics = topics.filter((topic) => {
-					try {
-						getSubject(topic);
-						return false;
-					} catch {
-						return true;
-					}
-				});
-				if (missingTopics.length === 1) console.error(`Error: Subject '${missingTopics[0]}' not found.`);
-				else if (missingTopics.length > 1) console.error(`Error: Subjects not found: ${missingTopics.map((t) => `'${t}'`).join(", ")}`);
-				else console.error("Error: One or more subjects not found.");
-				console.log("\nAvailable topics:");
-				printTopicTree();
-			} else {
-				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 __dirname = dirname(fileURLToPath(import.meta.url));
@@ -918,11 +347,13 @@ async function run() {
 			name: "fragno-cli search",
 			version
 		});
-		else if (args[0] === "corpus") await cli(args.slice(1), corpusCommand, {
-			name: "fragno-cli corpus",
-			version
-		});
-		else if (args[0] === "db") {
+		else if (args[0] === "serve") {
+			const { serveCommand } = await import("./serve-eh3Tpjhc.js");
+			await cli(args.slice(1), serveCommand, {
+				name: "fragno-cli serve",
+				version
+			});
+		} else if (args[0] === "db") {
 			const subCommandName = args[1];
 			if (!subCommandName || subCommandName === "--help" || subCommandName === "-h") {
 				console.log("Database management commands");
@@ -964,14 +395,14 @@ async function run() {
 			console.log("  fragno-cli <COMMAND>");
 			console.log("");
 			console.log("COMMANDS:");
+			console.log("  serve                 Start a local HTTP server to serve fragments");
 			console.log("  db                    Database management commands");
 			console.log("  search                Search the Fragno documentation");
-			console.log("  corpus                View code examples and documentation for Fragno");
 			console.log("");
 			console.log("For more info, run any command with the `--help` flag:");
+			console.log("  fragno-cli serve --help");
 			console.log("  fragno-cli db --help");
 			console.log("  fragno-cli search --help");
-			console.log("  fragno-cli corpus --help");
 			console.log("");
 			console.log("OPTIONS:");
 			console.log("  -h, --help             Display this help message");
@@ -991,5 +422,5 @@ async function run() {
 if (import.meta.main) await run();
 
 //#endregion
-export { corpusCommand, dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand, run, searchCommand };
+export { dbCommand, generateCommand, infoCommand, mainCommand, migrateCommand, run, searchCommand };
 //# sourceMappingURL=cli.js.map