topchester-ai 0.28.0 → 0.29.0

package/dist/cli.d.mts

@@ -1 +1,7 @@
-export { };
+//#region src/cli.d.ts
+declare function runTopchesterCli(argv?: string[], options?: {
+  exitOverride?: boolean;
+}): Promise<void>;
+//#endregion
+export { runTopchesterCli };
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.mjs

@@ -2,6 +2,7 @@
 import { createRequire } from "node:module";
 import { cwd, stderr, stdout } from "node:process";
 import { basename, delimiter, dirname, extname, isAbsolute, join, parse, relative, resolve, sep, win32 } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command } from "commander";
 import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 import { generateText, streamText, tool } from "ai";
@@ -11,7 +12,6 @@ import { execFile, spawn } from "node:child_process";
 import { constants, existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { parse as parse$1, parseDocument } from "yaml";
-import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
 import pino from "pino";
 import picomatch from "picomatch";
@@ -13413,104 +13413,112 @@ function defaultSelfUpdateRunner(command, args) {
 }
 //#endregion
 //#region src/cli.ts
-const program = new Command();
-program.name("topchester").description("KB-first terminal coding agent").version(getTopchesterVersion());
-program.option("-c, --config <path>", "explicit config file path").option("--workspace <path>", "workspace root", cwd()).option("--resume <session>", "resume a project session: latest or an exact session id").option("--dev <flag>", "enable a development flag", collectDevFlag, []);
-program.action(async () => {
-	const context = createContextFromOptions();
-	const options = program.opts();
-	try {
-		if (options.resume) {
-			const loaded = await loadSession(context.workspaceRoot, options.resume);
-			const session = await loadSessionForAppend(context.workspaceRoot, loaded.sessionId);
-			const rehydrated = rehydrateSession(loaded.events);
-			await new TopchesterTuiShell(context, void 0, {
-				session,
-				initialMessages: rehydrated.messages,
-				initialTaskPlan: rehydrated.taskPlan
-			}).render();
-			return;
+async function runTopchesterCli(argv = process.argv, options = {}) {
+	const program = createTopchesterProgram();
+	if (options.exitOverride) program.exitOverride();
+	await program.parseAsync(argv);
+}
+function createTopchesterProgram() {
+	const program = new Command();
+	program.name("topchester").description("KB-first terminal coding agent").version(getTopchesterVersion());
+	program.option("-c, --config <path>", "explicit config file path").option("--workspace <path>", "workspace root", cwd()).option("--resume <session>", "resume a project session: latest or an exact session id").option("--dev <flag>", "enable a development flag", collectDevFlag, []);
+	program.action(async () => {
+		const context = createContextFromOptions(program);
+		const options = program.opts();
+		try {
+			if (options.resume) {
+				const loaded = await loadSession(context.workspaceRoot, options.resume);
+				const session = await loadSessionForAppend(context.workspaceRoot, loaded.sessionId);
+				const rehydrated = rehydrateSession(loaded.events);
+				await new TopchesterTuiShell(context, void 0, {
+					session,
+					initialMessages: rehydrated.messages,
+					initialTaskPlan: rehydrated.taskPlan
+				}).render();
+				return;
+			}
+			await new TopchesterTuiShell(context).render();
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
 		}
-		await new TopchesterTuiShell(context).render();
-	} catch (error) {
-		console.error(formatStartupError(error));
-		process.exitCode = 1;
-	}
-});
-program.command("dev").description("start local development mode").action(() => {
-	const context = createContextFromOptions();
-	console.log("Topchester local dev mode");
-	printStartupSummary(context);
-});
-program.command("run").description("run one prompt or slash command without opening the TUI").argument("<prompt...>", "prompt text or slash command").option("--model <model>", "override the agent.primary model for this run").option("--timeout <ms>", "timeout for the run in milliseconds", parsePositiveInteger).option("--json", "write JSONL run events to stdout").option("--output-json <path>", "write JSONL run events to a file").action(async (promptParts, options) => {
-	const context = createContextFromOptions();
-	const globalOptions = program.opts();
-	try {
-		await executeRunCommand(context, {
-			prompt: promptParts.join(" "),
-			model: options.model,
-			timeoutMs: options.timeout,
-			json: options.json,
-			outputJson: options.outputJson,
-			resume: globalOptions.resume
-		});
-	} catch (error) {
-		console.error(formatStartupError(error));
-		process.exitCode = 1;
-	}
-});
-program.command("search").description("search compiled L1 knowledge entries").argument("<query...>", "search query").option("--limit <count>", "maximum number of matches", parsePositiveInteger).option("--json", "write full JSON search result to stdout").action(async (queryParts, options) => {
-	await executeKbSearchCommand(queryParts, options);
-});
-const kbCommand = program.command("kb").description("knowledge base commands");
-kbCommand.command("init").description("initialize a project knowledge base").action(async () => {
-	const context = createContextFromOptions();
-	const result = await ui.progress("Preparing project knowledge folders...", (report) => initializeKnowledgeBase(context.workspaceRoot, { onProgress: (event) => report(event.message) }));
-	console.log(formatKnowledgeInitResult(result).join("\n"));
-});
-kbCommand.command("dry-run").description("list project files that would be synced into the knowledge base").action(async () => {
-	const context = createContextFromOptions();
-	const result = await ui.spinner("Listing project files for KB sync...", () => dryRunKnowledgeCompile(context.workspaceRoot, { config: context.config }));
-	console.log(formatKnowledgeCompileDryRunResult(result, { formatSyncStatus: formatDryRunSyncStatus }).join("\n"));
-});
-kbCommand.command("sync").description("sync project files into the knowledge base").option("--full", "sync all in-scope files and remove orphaned L1 entries").action(async (options) => {
-	const context = createContextFromOptions();
-	const result = await ui.progress(options.full ? "Syncing all L1 file entries..." : "Syncing non-clean L1 file entries...", (report) => syncKnowledgeBase(context.workspaceRoot, {
-		model: context.modelGateway,
-		requireModel: true,
-		config: context.config,
-		full: options.full,
-		onProgress: (event) => report(event.message)
-	}));
-	console.log(formatKnowledgeSyncResult(result, { title: options.full ? "KB sync --full" : "KB sync" }).join("\n"));
-	if (isPartialKnowledgeCompileResult(result)) process.exitCode = 2;
-});
-kbCommand.command("search").alias("query").description("search compiled L1 knowledge entries").argument("<query...>", "search query").option("--limit <count>", "maximum number of matches", parsePositiveInteger).option("--json", "write full JSON search result to stdout").action(async (queryParts, options) => {
-	await executeKbSearchCommand(queryParts, options);
-});
-kbCommand.command("context").description("create an L1 context pack for a query").argument("<query...>", "context query").option("--limit <count>", "maximum number of relevant files", parsePositiveInteger).option("--min-score <score>", "minimum match score", parseNonNegativeNumber).option("--json", "write JSON context pack to stdout").option("--full-l1", "include full raw L1 entries in JSON output").action(async (queryParts, options) => {
-	await executeKbContextCommand(queryParts, options);
-});
-kbCommand.command("reset").description("delete the local project knowledge base and cache").action(async () => {
-	const context = createContextFromOptions();
-	const result = await ui.progress("Resetting project knowledge base...", (report) => resetKnowledgeBase(context.workspaceRoot, { onProgress: (event) => report(event.message) }));
-	console.log(formatKnowledgeResetResult(result).join("\n"));
-});
-kbCommand.command("status").description("show project files that are not current in the knowledge base").action(async () => {
-	const context = createContextFromOptions();
-	const result = await ui.spinner("Checking KB file status...", async () => filterNonCleanKnowledgeCompileResult(await dryRunKnowledgeCompile(context.workspaceRoot, { config: context.config })));
-	console.log(formatKnowledgeCompileStatusResult(result, { formatSyncStatus: formatDryRunSyncStatus }).join("\n"));
-});
-program.command("update").alias("upgrade").description("update Topchester with the package manager that installed it").argument("[target]", "version or npm dist tag to install", "latest").action(async (target) => {
-	try {
-		const command = await runSelfUpdate({ target });
-		console.log(formatSelfUpdateSuccess(command).join("\n"));
-	} catch (error) {
-		console.error(formatStartupError(error));
-		process.exitCode = 1;
-	}
-});
-await program.parseAsync();
+	});
+	program.command("dev").description("start local development mode").action(() => {
+		const context = createContextFromOptions(program);
+		console.log("Topchester local dev mode");
+		printStartupSummary(context);
+	});
+	program.command("run").description("run one prompt or slash command without opening the TUI").argument("<prompt...>", "prompt text or slash command").option("--model <model>", "override the agent.primary model for this run").option("--timeout <ms>", "timeout for the run in milliseconds", parsePositiveInteger).option("--json", "write JSONL run events to stdout").option("--output-json <path>", "write JSONL run events to a file").action(async (promptParts, options) => {
+		const context = createContextFromOptions(program);
+		const globalOptions = program.opts();
+		try {
+			await executeRunCommand(context, {
+				prompt: promptParts.join(" "),
+				model: options.model,
+				timeoutMs: options.timeout,
+				json: options.json,
+				outputJson: options.outputJson,
+				resume: globalOptions.resume
+			});
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	program.command("search").description("search compiled L1 knowledge entries").argument("<query...>", "search query").option("--limit <count>", "maximum number of matches", parsePositiveInteger).option("--json", "write full JSON search result to stdout").action(async (queryParts, options) => {
+		await executeKbSearchCommand(program, queryParts, options);
+	});
+	const kbCommand = program.command("kb").description("knowledge base commands");
+	kbCommand.command("init").description("initialize a project knowledge base").action(async () => {
+		const context = createContextFromOptions(program);
+		const result = await ui.progress("Preparing project knowledge folders...", (report) => initializeKnowledgeBase(context.workspaceRoot, { onProgress: (event) => report(event.message) }));
+		console.log(formatKnowledgeInitResult(result).join("\n"));
+	});
+	kbCommand.command("dry-run").description("list project files that would be synced into the knowledge base").action(async () => {
+		const context = createContextFromOptions(program);
+		const result = await ui.spinner("Listing project files for KB sync...", () => dryRunKnowledgeCompile(context.workspaceRoot, { config: context.config }));
+		console.log(formatKnowledgeCompileDryRunResult(result, { formatSyncStatus: formatDryRunSyncStatus }).join("\n"));
+	});
+	kbCommand.command("sync").description("sync project files into the knowledge base").option("--full", "sync all in-scope files and remove orphaned L1 entries").action(async (options) => {
+		const context = createContextFromOptions(program);
+		const result = await ui.progress(options.full ? "Syncing all L1 file entries..." : "Syncing non-clean L1 file entries...", (report) => syncKnowledgeBase(context.workspaceRoot, {
+			model: context.modelGateway,
+			requireModel: true,
+			config: context.config,
+			full: options.full,
+			onProgress: (event) => report(event.message)
+		}));
+		console.log(formatKnowledgeSyncResult(result, { title: options.full ? "KB sync --full" : "KB sync" }).join("\n"));
+		if (isPartialKnowledgeCompileResult(result)) process.exitCode = 2;
+	});
+	kbCommand.command("search").alias("query").description("search compiled L1 knowledge entries").argument("<query...>", "search query").option("--limit <count>", "maximum number of matches", parsePositiveInteger).option("--json", "write full JSON search result to stdout").action(async (queryParts, options) => {
+		await executeKbSearchCommand(program, queryParts, options);
+	});
+	kbCommand.command("context").description("create an L1 context pack for a query").argument("<query...>", "context query").option("--limit <count>", "maximum number of relevant files", parsePositiveInteger).option("--min-score <score>", "minimum match score", parseNonNegativeNumber).option("--json", "write JSON context pack to stdout").option("--full-l1", "include full raw L1 entries in JSON output").action(async (queryParts, options) => {
+		await executeKbContextCommand(program, queryParts, options);
+	});
+	kbCommand.command("reset").description("delete the local project knowledge base and cache").action(async () => {
+		const context = createContextFromOptions(program);
+		const result = await ui.progress("Resetting project knowledge base...", (report) => resetKnowledgeBase(context.workspaceRoot, { onProgress: (event) => report(event.message) }));
+		console.log(formatKnowledgeResetResult(result).join("\n"));
+	});
+	kbCommand.command("status").description("show project files that are not current in the knowledge base").action(async () => {
+		const context = createContextFromOptions(program);
+		const result = await ui.spinner("Checking KB file status...", async () => filterNonCleanKnowledgeCompileResult(await dryRunKnowledgeCompile(context.workspaceRoot, { config: context.config })));
+		console.log(formatKnowledgeCompileStatusResult(result, { formatSyncStatus: formatDryRunSyncStatus }).join("\n"));
+	});
+	program.command("update").alias("upgrade").description("update Topchester with the package manager that installed it").argument("[target]", "version or npm dist tag to install", "latest").action(async (target) => {
+		try {
+			const command = await runSelfUpdate({ target });
+			console.log(formatSelfUpdateSuccess(command).join("\n"));
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
+	return program;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) await runTopchesterCli();
 function printStartupSummary(context) {
 	const assignments = context.config.models?.assignments ?? {};
 	const providers = context.config.models?.providers ?? {};
@@ -13538,7 +13546,7 @@ function printStartupSummary(context) {
 		}
 	}
 }
-function createContextFromOptions() {
+function createContextFromOptions(program) {
 	const options = program.opts();
 	return createAppContext({
 		workspaceRoot: options.workspace,
@@ -13546,8 +13554,8 @@ function createContextFromOptions() {
 		devFlags: options.dev
 	});
 }
-async function executeKbSearchCommand(queryParts, options) {
-	const context = createContextFromOptions();
+async function executeKbSearchCommand(program, queryParts, options) {
+	const context = createContextFromOptions(program);
 	const query = queryParts.join(" ");
 	const result = options.json ? await searchL1Knowledge(context.workspaceRoot, query, { limit: options.limit }) : await ui.spinner("Searching L1 knowledge entries...", () => searchL1Knowledge(context.workspaceRoot, query, { limit: options.limit }));
 	if (options.json) {
@@ -13556,8 +13564,8 @@ async function executeKbSearchCommand(queryParts, options) {
 	}
 	console.log(formatL1KnowledgeSearchResult(result).join("\n"));
 }
-async function executeKbContextCommand(queryParts, options) {
-	const context = createContextFromOptions();
+async function executeKbContextCommand(program, queryParts, options) {
+	const context = createContextFromOptions(program);
 	const query = queryParts.join(" ");
 	const contextPackOptions = {
 		limit: options.limit,
@@ -13595,6 +13603,6 @@ function formatDryRunSyncStatus(status) {
 	return ui.warn(status);
 }
 //#endregion
-export {};
+export { runTopchesterCli };
 
 //# sourceMappingURL=cli.mjs.map