topchester-ai 0.51.0 → 0.52.0

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as runTopchesterCli } from "./cli-DkzkXlKD.mjs";
+import { t as runTopchesterCli } from "./cli-yf0DNAUH.mjs";
 //#region src/bin.ts
 await runTopchesterCli();
 //#endregion

package/dist/{cli-DkzkXlKD.mjs → cli-yf0DNAUH.mjs}

@@ -15337,8 +15337,8 @@ function createTopchesterProgram() {
 		console.log(result.lines.join("\n"));
 		if (!result.ok) process.exitCode = 1;
 	});
-	const authCommand = program.command("auth").description("manage global provider authentication");
-	authCommand.command("login").description("log in to a provider").argument("<provider>", "provider id").option("--device", "use device-code login").action(async (provider, options) => {
+	const authCommand = program.command("auth").description("manage global provider authentication").addHelpText("after", formatAuthCommandHelp);
+	authCommand.command("login").usage("[options] <provider>").description("log in to a provider").argument("[provider]", "provider id").option("--device", "use device-code login").addHelpText("after", formatAuthLoginHelp).action(async (provider, options) => {
 		try {
 			await executeAuthLoginCommand(provider, options);
 		} catch (error) {
@@ -15471,19 +15471,66 @@ function printStartupSummary(context) {
 		}
 	}
 }
+const AUTH_PROVIDERS = [{
+	id: "codex",
+	name: "Codex / ChatGPT",
+	auth: "OAuth device-code login for Codex-backed model access.",
+	example: "topchester auth login codex --device"
+}];
+function formatAuthCommandHelp() {
+	return [
+		"",
+		ui.label("Supported providers:"),
+		...AUTH_PROVIDERS.map((provider) => `  ${ui.modelInline(provider.id.padEnd(8))} ${provider.name} - ${provider.auth}`),
+		"",
+		ui.label("Examples:"),
+		...AUTH_PROVIDERS.map((provider) => `  ${provider.example}`),
+		"  topchester auth status"
+	].join("\n");
+}
+function formatAuthLoginHelp() {
+	return [
+		"",
+		ui.label("Supported providers:"),
+		...AUTH_PROVIDERS.map((provider) => `  ${ui.modelInline(provider.id.padEnd(8))} ${provider.auth}`),
+		"",
+		ui.label("Examples:"),
+		...AUTH_PROVIDERS.map((provider) => `  ${provider.example}`),
+		"",
+		ui.label("What happens:"),
+		"  Topchester prints a browser URL and one-time code, waits for approval, then stores tokens in the global auth store."
+	].join("\n");
+}
+function formatAuthLoginUsageError(reason) {
+	return [
+		ui.error(reason),
+		"",
+		ui.label("Usage:"),
+		"  topchester auth login <provider> --device",
+		"",
+		ui.label("Supported providers:"),
+		...AUTH_PROVIDERS.map((provider) => `  ${provider.id.padEnd(8)} ${provider.name} - ${provider.auth}`),
+		"",
+		ui.label("Examples:"),
+		...AUTH_PROVIDERS.map((provider) => `  ${provider.example}`),
+		"",
+		"Run `topchester auth login --help` for details."
+	].join("\n");
+}
 async function executeAuthLoginCommand(provider, options) {
-	if (provider !== "codex") throw new Error(`Unsupported auth provider "${provider}". Supported providers: codex.`);
-	if (!options.device) throw new Error("Usage: topchester auth login codex --device");
+	if (!provider) throw new Error(formatAuthLoginUsageError("Missing provider."));
+	if (provider !== "codex") throw new Error(formatAuthLoginUsageError(`Unsupported auth provider "${provider}".`));
+	if (!options.device) throw new Error(formatAuthLoginUsageError("Codex login currently requires \"--device\"."));
 	const deviceCode = await requestCodexDeviceCode();
-	console.log("Codex device login");
-	console.log(`verification URL: ${deviceCode.verificationUrl}`);
-	console.log(`user code: ${deviceCode.userCode}`);
-	console.log(`expires: ${new Date(deviceCode.expiresAt).toISOString()}`);
-	console.log("Device codes are a common phishing target. Never share this code.");
-	console.log("Waiting for browser approval...");
+	console.log(ui.heading("Codex device login"));
+	console.log(`${ui.label("verification URL:")} ${deviceCode.verificationUrl}`);
+	console.log(`${ui.label("user code:")} ${ui.inverse(deviceCode.userCode)}`);
+	console.log(`${ui.label("expires:")} ${new Date(deviceCode.expiresAt).toISOString()}`);
+	console.log(ui.warn("Device codes are a common phishing target. Never share this code."));
+	console.log(ui.label("Waiting for browser approval..."));
 	await setAuthProvider("codex", await exchangeCodexAuthorizationCode(await pollCodexDeviceAuthorization(deviceCode), { issuer: deviceCode.issuer }));
 	await configureCodexGlobalProvider();
-	console.log("Codex login saved.");
+	console.log(ui.ok("Codex login saved."));
 	console.log("Configured global Codex provider and starter model choices.");
 }
 async function formatAuthStatus() {
@@ -15582,4 +15629,4 @@ function formatDryRunSyncStatus(status) {
 //#endregion
 export { runTopchesterCli as t };
 
-//# sourceMappingURL=cli-DkzkXlKD.mjs.map
+//# sourceMappingURL=cli-yf0DNAUH.mjs.map