@studiometa/forge-cli 0.0.1 → 0.1.0

package/dist/commands/ssh-keys/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/command.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,6GAO/B,CAAC"}

package/dist/commands/ssh-keys/handlers.d.ts

@@ -0,0 +1,4 @@
+import type { CommandContext } from "../../context.ts";
+export declare function sshKeysList(ctx: CommandContext): Promise<void>;
+export declare function sshKeysGet(args: string[], ctx: CommandContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/commands/ssh-keys/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBpE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BnF"}

package/dist/commands/ssh-keys/help.d.ts

@@ -0,0 +1,2 @@
+export declare function showSshKeysHelp(subcommand?: string): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/ssh-keys/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAiCzD"}

package/dist/commands/ssh-keys/index.d.ts

@@ -0,0 +1,3 @@
+export { handleSshKeysCommand } from "./command.ts";
+export { showSshKeysHelp } from "./help.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/ssh-keys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/commands/user/command.d.ts

@@ -0,0 +1,2 @@
+export declare const handleUserCommand: (subcommand: string, args: string[], options: Record<string, string | boolean | string[]>) => Promise<void>;
+//# sourceMappingURL=command.d.ts.map

package/dist/commands/user/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/user/command.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,6GAK5B,CAAC"}

package/dist/commands/user/handlers.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContext } from "../../context.ts";
+export declare function userGet(ctx: CommandContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/commands/user/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/user/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,wBAAsB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhE"}

package/dist/commands/user/help.d.ts

@@ -0,0 +1,2 @@
+export declare function showUserHelp(subcommand?: string): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/user/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/user/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CA2BtD"}

package/dist/commands/user/index.d.ts

@@ -0,0 +1,3 @@
+export { handleUserCommand } from "./command.ts";
+export { showUserHelp } from "./help.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/user/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/user/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Config loading for forge-cli.
+ *
+ * Resolution priority (highest to lowest):
+ * 1. CLI arguments (--token)
+ * 2. Environment variable (FORGE_API_TOKEN)
+ * 3. Config file (XDG-compliant)
+ */
+export interface ForgeCliConfig {
+    /** Forge API token */
+    apiToken: string | undefined;
+}
+/**
+ * Resolve config from multiple sources with priority order.
+ */
+export declare function getConfig(cliOptions?: Record<string, string | boolean | string[]>): ForgeCliConfig;
+export { createConfigStore, getToken, setToken, deleteToken } from "@studiometa/forge-api";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,GACvD,cAAc,CAUhB;AAED,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CLI execution context with dependency injection.
+ *
+ * Instead of hidden dependencies in command handlers, this module provides
+ * explicit dependency passing for testability and transparency.
+ */
+import type { HttpClient } from "@studiometa/forge-api";
+import type { ExecutorContext } from "@studiometa/forge-core";
+import { OutputFormatter } from "./output.ts";
+export interface CommandOptions {
+    [key: string]: string | boolean | string[] | undefined;
+    format?: string;
+    f?: string;
+    token?: string;
+    "no-color"?: boolean;
+}
+/**
+ * Context containing all dependencies needed by command handlers.
+ */
+export interface CommandContext {
+    /** Output formatter for the current format */
+    readonly formatter: OutputFormatter;
+    /** Raw CLI options */
+    readonly options: CommandOptions;
+    /** Create an ExecutorContext from this command context */
+    createExecutorContext(token: string): ExecutorContext;
+    /** Resolve the API token or throw ConfigError */
+    getToken(): string;
+}
+/**
+ * Creates a command context from CLI options.
+ */
+export declare function createContext(options?: CommandOptions): CommandContext;
+/**
+ * Creates a test context for unit tests.
+ *
+ * @example
+ * ```typescript
+ * const ctx = createTestContext({
+ *   mockClient: { get: async () => ({ servers: [] }) } as never,
+ * });
+ * ```
+ */
+export declare function createTestContext(overrides: {
+    options?: CommandOptions;
+    formatter?: OutputFormatter;
+    token?: string;
+    mockClient?: HttpClient;
+}): CommandContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,0DAA0D;IAC1D,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;IACtD,iDAAiD;IACjD,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,cAAc,CA4B1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE;IAC3C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,GAAG,cAAc,CAyBjB"}

package/dist/error-handler-BahHMt6t.js

@@ -0,0 +1,396 @@
+import { HttpClient, createConfigStore, createConfigStore as createConfigStore$1, deleteToken, getToken, getToken as getToken$1, setToken } from "@studiometa/forge-api";
+/**
+* Error types for forge-cli.
+*
+* Provides specific error types for different failure scenarios with
+* recovery hints for both humans and AI agents.
+*/
+/**
+* Base error class for all CLI errors.
+*/
+var CliError = class extends Error {
+	constructor(message, hints, cause) {
+		super(message);
+		this.hints = hints;
+		this.cause = cause;
+		this.name = this.constructor.name;
+		Error.captureStackTrace?.(this, this.constructor);
+	}
+	toJSON() {
+		return {
+			error: this.code,
+			name: this.name,
+			message: this.message,
+			isRecoverable: this.isRecoverable,
+			...this.hints && this.hints.length > 0 ? { hints: this.hints } : {},
+			...this.cause instanceof Error ? { cause: { message: this.cause.message } } : {}
+		};
+	}
+	toFormattedMessage() {
+		let msg = this.message;
+		if (this.hints && this.hints.length > 0) msg += "\n\nHints:\n" + this.hints.map((h) => `  • ${h}`).join("\n");
+		return msg;
+	}
+};
+var ConfigError = class ConfigError extends CliError {
+	code = "CONFIG_ERROR";
+	isRecoverable = true;
+	static missingToken() {
+		return new ConfigError("API token not configured", [
+			"Set via CLI flag: --token <token>",
+			"Set via environment: export FORGE_API_TOKEN=<token>",
+			"Set via config: forge-cli config set YOUR_TOKEN"
+		]);
+	}
+};
+var ValidationError = class ValidationError extends CliError {
+	code = "VALIDATION_ERROR";
+	isRecoverable = true;
+	constructor(message, field, hints, cause) {
+		super(message, hints, cause);
+		this.field = field;
+	}
+	toJSON() {
+		return {
+			...super.toJSON(),
+			field: this.field
+		};
+	}
+	static required(field, hints) {
+		return new ValidationError(`${field} is required`, field, hints);
+	}
+};
+var ApiError = class ApiError extends CliError {
+	code = "API_ERROR";
+	isRecoverable;
+	constructor(message, statusCode, hints, cause) {
+		super(message, hints ?? getApiErrorHints(statusCode), cause);
+		this.statusCode = statusCode;
+		this.isRecoverable = statusCode === void 0 || statusCode >= 500 && statusCode < 600;
+	}
+	toJSON() {
+		return {
+			...super.toJSON(),
+			statusCode: this.statusCode
+		};
+	}
+	static fromForgeError(error) {
+		if (error instanceof Error && "statusCode" in error) {
+			const e = error;
+			return new ApiError(e.message, e.statusCode, void 0, e);
+		}
+		if (error instanceof Error) return new ApiError(error.message, void 0, void 0, error);
+		return new ApiError(String(error));
+	}
+};
+function getApiErrorHints(statusCode) {
+	if (statusCode === 401) return ["Check that your API token is valid", "Set via: export FORGE_API_TOKEN=<token>"];
+	if (statusCode === 403) return ["You may not have permission to access this resource"];
+	if (statusCode === 404) return [
+		"The resource may not exist",
+		"Verify the ID is correct",
+		"Use the list command to find valid IDs"
+	];
+	if (statusCode === 429) return ["Too many requests — wait before retrying"];
+	if (statusCode !== void 0 && statusCode >= 500) return ["Server error — try again later"];
+	return [];
+}
+function isCliError(error) {
+	return error instanceof CliError;
+}
+/**
+* Config loading for forge-cli.
+*
+* Resolution priority (highest to lowest):
+* 1. CLI arguments (--token)
+* 2. Environment variable (FORGE_API_TOKEN)
+* 3. Config file (XDG-compliant)
+*/
+/**
+* Resolve config from multiple sources with priority order.
+*/
+function getConfig(cliOptions) {
+	const cliToken = cliOptions?.token;
+	const storedToken = getToken(createConfigStore());
+	return { apiToken: typeof cliToken === "string" ? cliToken : storedToken ?? void 0 };
+}
+/**
+* ANSI color utilities using native Node.js.
+* Provides terminal colors without external dependencies.
+*/
+var RESET = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var FG_RED = "\x1B[31m";
+var FG_GREEN = "\x1B[32m";
+var FG_YELLOW = "\x1B[33m";
+var FG_CYAN = "\x1B[36m";
+var FG_GRAY = "\x1B[90m";
+var colorEnabled = process.env.NO_COLOR === void 0;
+function setColorEnabled(enabled) {
+	colorEnabled = enabled;
+}
+function colorize(text, code) {
+	if (!colorEnabled) return text;
+	return `${code}${text}${RESET}`;
+}
+const colors = {
+	reset: (text) => colorEnabled ? `${RESET}${text}` : text,
+	bold: (text) => colorize(text, BOLD),
+	dim: (text) => colorize(text, DIM),
+	red: (text) => colorize(text, FG_RED),
+	green: (text) => colorize(text, FG_GREEN),
+	yellow: (text) => colorize(text, FG_YELLOW),
+	cyan: (text) => colorize(text, FG_CYAN),
+	gray: (text) => colorize(text, FG_GRAY)
+};
+/**
+* Output formatter for CLI commands.
+* Supports human-readable, JSON, and table formats.
+*/
+var OutputFormatter = class {
+	constructor(format = "human", noColor = false) {
+		this.format = format;
+		this.noColor = noColor;
+	}
+	/**
+	* Returns true when the current format is JSON.
+	*/
+	isJson() {
+		return this.format === "json";
+	}
+	/**
+	* Output data in the configured format.
+	* Use format='json' for AI agents and structured data.
+	*/
+	output(data) {
+		switch (this.format) {
+			case "json":
+				console.log(JSON.stringify(data, null, 2));
+				break;
+			case "table":
+				this.outputTable(data);
+				break;
+			default:
+				console.log(data);
+				break;
+		}
+	}
+	/**
+	* Output a list with a human-readable one-liner per item and a table for table format.
+	* Falls back to JSON for json format.
+	*
+	* @param data - Array of items to display
+	* @param columns - Ordered list of field names to include in human/table output
+	* @param emptyMessage - Message shown when data is empty (human format only)
+	* @param lineFormat - Optional custom line formatter for human format
+	*/
+	outputList(data, columns, emptyMessage, lineFormat) {
+		if (this.format === "json") {
+			console.log(JSON.stringify(data, null, 2));
+			return;
+		}
+		if (this.format === "table") {
+			this.outputTable(data.map((item) => Object.fromEntries(columns.map((c) => [c, item[c]]))));
+			return;
+		}
+		if (data.length === 0) {
+			console.log(colors.cyan(emptyMessage));
+			return;
+		}
+		if (lineFormat) {
+			for (const item of data) console.log(lineFormat(item));
+			return;
+		}
+		const widths = columns.map((col) => Math.max(col.length, ...data.map((item) => String(item[col] ?? "").length)));
+		for (const item of data) {
+			const row = item;
+			const line = columns.map((col, i) => String(row[col] ?? "").padEnd(widths[i])).join("  ");
+			console.log(line.trimEnd());
+		}
+	}
+	/**
+	* Output a single resource in human-readable format.
+	* For json format, uses JSON.stringify. For table format, uses a two-column key/value table.
+	*
+	* @param data - Object to display
+	* @param fields - Ordered list of fields to display (defaults to all keys)
+	*/
+	outputOne(data, fields) {
+		if (this.format === "json") {
+			console.log(JSON.stringify(data, null, 2));
+			return;
+		}
+		const record = data;
+		const keys = fields ?? Object.keys(record);
+		if (this.format === "table") {
+			const rows = keys.map((k) => ({
+				field: k,
+				value: String(record[k] ?? "")
+			}));
+			this.outputTable(rows);
+			return;
+		}
+		const keyWidth = Math.max(...keys.map((k) => k.length));
+		for (const key of keys) {
+			const value = record[key];
+			const valueStr = value !== null && typeof value === "object" ? JSON.stringify(value) : String(value ?? "");
+			console.log(`${colors.cyan(key.padEnd(keyWidth))}  ${valueStr}`);
+		}
+	}
+	success(message) {
+		if (this.format === "json") console.log(JSON.stringify({
+			status: "success",
+			message
+		}));
+		else console.log(colors.green(`✓ ${message}`));
+	}
+	error(message, details) {
+		if (this.format === "json") console.error(JSON.stringify({
+			status: "error",
+			message,
+			details
+		}));
+		else {
+			console.error(colors.red(`✗ ${message}`));
+			if (details !== void 0) console.error(details);
+		}
+	}
+	warning(message) {
+		if (this.format === "json") console.log(JSON.stringify({
+			status: "warning",
+			message
+		}));
+		else console.log(colors.yellow(`⚠ ${message}`));
+	}
+	info(message) {
+		if (this.format === "json") console.log(JSON.stringify({
+			status: "info",
+			message
+		}));
+		else console.log(colors.cyan(message));
+	}
+	outputTable(data) {
+		if (Array.isArray(data) && data.length > 0) {
+			const headers = Object.keys(data[0]);
+			const colWidths = headers.map((h) => {
+				const maxDataWidth = Math.max(...data.map((row) => String(row[h] ?? "").length));
+				return Math.max(h.length, maxDataWidth);
+			});
+			const headerRow = headers.map((h, i) => h.padEnd(colWidths[i])).join(" | ");
+			console.log(headerRow);
+			console.log(colWidths.map((w) => "-".repeat(w)).join("-+-"));
+			for (const row of data) {
+				const rowStr = headers.map((h, i) => String(row[h] ?? "").padEnd(colWidths[i])).join(" | ");
+				console.log(rowStr);
+			}
+		}
+	}
+};
+/**
+* Creates a command context from CLI options.
+*/
+function createContext(options = {}) {
+	return {
+		formatter: new OutputFormatter(options.format ?? options.f ?? "human", options["no-color"] === true),
+		options,
+		createExecutorContext(token) {
+			return { client: new HttpClient({ token }) };
+		},
+		getToken() {
+			if (typeof options.token === "string" && options.token) return options.token;
+			const stored = getToken$1(createConfigStore$1());
+			if (stored) return stored;
+			throw ConfigError.missingToken();
+		}
+	};
+}
+/**
+* Creates a test context for unit tests.
+*
+* @example
+* ```typescript
+* const ctx = createTestContext({
+*   mockClient: { get: async () => ({ servers: [] }) } as never,
+* });
+* ```
+*/
+function createTestContext(overrides) {
+	const opts = overrides.options ?? {
+		format: "json",
+		"no-color": true
+	};
+	const format = opts.format ?? "json";
+	return {
+		formatter: overrides.formatter ?? new OutputFormatter(format, true),
+		options: opts,
+		createExecutorContext(_token) {
+			if (!overrides.mockClient) throw new Error("createTestContext: provide mockClient to use createExecutorContext in tests");
+			return { client: overrides.mockClient };
+		},
+		getToken() {
+			if (overrides.token) return overrides.token;
+			if (typeof opts.token === "string") return opts.token;
+			return "test-token";
+		}
+	};
+}
+/**
+* Exit codes for different error categories.
+*/
+const ExitCode = {
+	SUCCESS: 0,
+	GENERAL_ERROR: 1,
+	AUTHENTICATION_ERROR: 2,
+	VALIDATION_ERROR: 3,
+	CONFIG_ERROR: 4,
+	NOT_FOUND_ERROR: 5
+};
+/**
+* Determine the appropriate exit code for an error.
+*/
+function getExitCode(error) {
+	if (error instanceof ValidationError) return ExitCode.VALIDATION_ERROR;
+	if (error instanceof ApiError) {
+		if (error.statusCode === 401) return ExitCode.AUTHENTICATION_ERROR;
+		if (error.statusCode === 404) return ExitCode.NOT_FOUND_ERROR;
+	}
+	if (isCliError(error) && error.code === "CONFIG_ERROR") return ExitCode.CONFIG_ERROR;
+	return ExitCode.GENERAL_ERROR;
+}
+/**
+* Central error handler for all commands.
+*/
+function handleError(error, formatter, options) {
+	const shouldExit = options?.exit ?? true;
+	let cliError;
+	if (isCliError(error)) cliError = error;
+	else cliError = ApiError.fromForgeError(error);
+	if (formatter.format === "json") formatter.output(cliError.toJSON());
+	else formatter.error(cliError.toFormattedMessage());
+	const exitCode = getExitCode(cliError);
+	if (shouldExit) process.exit(exitCode);
+	return exitCode;
+}
+/**
+* Wraps a command function with automatic error handling.
+*/
+async function runCommand(fn, formatter) {
+	try {
+		return await fn();
+	} catch (error) {
+		handleError(error, formatter);
+		return;
+	}
+}
+/**
+* Exits with a validation error for a missing required argument.
+*/
+function exitWithValidationError(field, usage, formatter) {
+	const error = ValidationError.required(field, [`Usage: ${usage}`]);
+	handleError(error, formatter);
+	throw error;
+}
+export { ConfigError as _, createContext as a, colors as c, deleteToken as d, getConfig as f, CliError as g, ApiError as h, runCommand as i, setColorEnabled as l, setToken as m, exitWithValidationError as n, createTestContext as o, getToken$1 as p, handleError as r, OutputFormatter as s, ExitCode as t, createConfigStore$1 as u, ValidationError as v, isCliError as y };
+
+//# sourceMappingURL=error-handler-BahHMt6t.js.map

package/dist/error-handler-BahHMt6t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler-BahHMt6t.js","names":[],"sources":["../src/errors.ts","../src/config.ts","../src/utils/colors.ts","../src/output.ts","../src/context.ts","../src/error-handler.ts"],"sourcesContent":["/**\n * Error types for forge-cli.\n *\n * Provides specific error types for different failure scenarios with\n * recovery hints for both humans and AI agents.\n */\n\n/**\n * Base error class for all CLI errors.\n */\nexport abstract class CliError extends Error {\n  abstract readonly code: string;\n  abstract readonly isRecoverable: boolean;\n\n  constructor(\n    message: string,\n    public readonly hints?: string[],\n    public readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = this.constructor.name;\n\n    Error.captureStackTrace?.(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      error: this.code,\n      name: this.name,\n      message: this.message,\n      isRecoverable: this.isRecoverable,\n      ...(this.hints && this.hints.length > 0 ? { hints: this.hints } : {}),\n      ...(this.cause instanceof Error ? { cause: { message: this.cause.message } } : {}),\n    };\n  }\n\n  toFormattedMessage(): string {\n    let msg = this.message;\n    if (this.hints && this.hints.length > 0) {\n      msg += \"\\n\\nHints:\\n\" + this.hints.map((h) => `  • ${h}`).join(\"\\n\");\n    }\n    return msg;\n  }\n}\n\n// ── Config Errors ────────────────────────────────────\n\nexport class ConfigError extends CliError {\n  readonly code = \"CONFIG_ERROR\";\n  readonly isRecoverable = true;\n\n  static missingToken(): ConfigError {\n    return new ConfigError(\"API token not configured\", [\n      \"Set via CLI flag: --token <token>\",\n      \"Set via environment: export FORGE_API_TOKEN=<token>\",\n      \"Set via config: forge-cli config set YOUR_TOKEN\",\n    ]);\n  }\n}\n\n// ── Validation Errors ────────────────────────────────\n\nexport class ValidationError extends CliError {\n  readonly code = \"VALIDATION_ERROR\";\n  readonly isRecoverable = true;\n\n  constructor(\n    message: string,\n    public readonly field?: string,\n    hints?: string[],\n    cause?: unknown,\n  ) {\n    super(message, hints, cause);\n  }\n\n  override toJSON() {\n    return { ...super.toJSON(), field: this.field };\n  }\n\n  static required(field: string, hints?: string[]): ValidationError {\n    return new ValidationError(`${field} is required`, field, hints);\n  }\n}\n\n// ── API Errors ───────────────────────────────────────\n\nexport class ApiError extends CliError {\n  readonly code = \"API_ERROR\";\n  readonly isRecoverable: boolean;\n\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    hints?: string[],\n    cause?: unknown,\n  ) {\n    super(message, hints ?? getApiErrorHints(statusCode), cause);\n    this.isRecoverable = statusCode === undefined || (statusCode >= 500 && statusCode < 600);\n  }\n\n  override toJSON() {\n    return { ...super.toJSON(), statusCode: this.statusCode };\n  }\n\n  static fromForgeError(error: unknown): ApiError {\n    if (error instanceof Error && \"statusCode\" in error) {\n      const e = error as Error & { statusCode?: number };\n      return new ApiError(e.message, e.statusCode, undefined, e);\n    }\n    if (error instanceof Error) {\n      return new ApiError(error.message, undefined, undefined, error);\n    }\n    return new ApiError(String(error));\n  }\n}\n\nfunction getApiErrorHints(statusCode?: number): string[] {\n  if (statusCode === 401) {\n    return [\"Check that your API token is valid\", \"Set via: export FORGE_API_TOKEN=<token>\"];\n  }\n  if (statusCode === 403) {\n    return [\"You may not have permission to access this resource\"];\n  }\n  if (statusCode === 404) {\n    return [\n      \"The resource may not exist\",\n      \"Verify the ID is correct\",\n      \"Use the list command to find valid IDs\",\n    ];\n  }\n  if (statusCode === 429) {\n    return [\"Too many requests — wait before retrying\"];\n  }\n  if (statusCode !== undefined && statusCode >= 500) {\n    return [\"Server error — try again later\"];\n  }\n  return [];\n}\n\n// ── Type Guards ──────────────────────────────────────\n\nexport function isCliError(error: unknown): error is CliError {\n  return error instanceof CliError;\n}\n","/**\n * Config loading for forge-cli.\n *\n * Resolution priority (highest to lowest):\n * 1. CLI arguments (--token)\n * 2. Environment variable (FORGE_API_TOKEN)\n * 3. Config file (XDG-compliant)\n */\n\nimport { createConfigStore, getToken } from \"@studiometa/forge-api\";\n\nexport interface ForgeCliConfig {\n  /** Forge API token */\n  apiToken: string | undefined;\n}\n\n/**\n * Resolve config from multiple sources with priority order.\n */\nexport function getConfig(\n  cliOptions?: Record<string, string | boolean | string[]>,\n): ForgeCliConfig {\n  // 1. CLI argument --token\n  const cliToken = cliOptions?.token;\n\n  // 2. Environment variable / config file (handled by getToken)\n  const storedToken = getToken(createConfigStore());\n\n  return {\n    apiToken: typeof cliToken === \"string\" ? cliToken : (storedToken ?? undefined),\n  };\n}\n\nexport { createConfigStore, getToken, setToken, deleteToken } from \"@studiometa/forge-api\";\n","/**\n * ANSI color utilities using native Node.js.\n * Provides terminal colors without external dependencies.\n */\n\n// ANSI escape codes\nconst RESET = \"\\x1b[0m\";\nconst BOLD = \"\\x1b[1m\";\nconst DIM = \"\\x1b[2m\";\n\n// Foreground colors\nconst FG_RED = \"\\x1b[31m\";\nconst FG_GREEN = \"\\x1b[32m\";\nconst FG_YELLOW = \"\\x1b[33m\";\nconst FG_CYAN = \"\\x1b[36m\";\nconst FG_GRAY = \"\\x1b[90m\";\n\n// Colors enabled by default, disabled by NO_COLOR env var\nlet colorEnabled = process.env.NO_COLOR === undefined;\n\nexport function setColorEnabled(enabled: boolean): void {\n  colorEnabled = enabled;\n}\n\nexport function isColorEnabled(): boolean {\n  return colorEnabled;\n}\n\nfunction colorize(text: string, code: string): string {\n  if (!colorEnabled) return text;\n  return `${code}${text}${RESET}`;\n}\n\nexport const colors = {\n  reset: (text: string) => (colorEnabled ? `${RESET}${text}` : text),\n  bold: (text: string) => colorize(text, BOLD),\n  dim: (text: string) => colorize(text, DIM),\n  red: (text: string) => colorize(text, FG_RED),\n  green: (text: string) => colorize(text, FG_GREEN),\n  yellow: (text: string) => colorize(text, FG_YELLOW),\n  cyan: (text: string) => colorize(text, FG_CYAN),\n  gray: (text: string) => colorize(text, FG_GRAY),\n};\n","import type { OutputFormat } from \"./types.ts\";\n\nimport { colors } from \"./utils/colors.ts\";\n\n/**\n * Output formatter for CLI commands.\n * Supports human-readable, JSON, and table formats.\n */\nexport class OutputFormatter {\n  constructor(\n    private format: OutputFormat = \"human\",\n    private noColor: boolean = false,\n  ) {}\n\n  /**\n   * Returns true when the current format is JSON.\n   */\n  isJson(): boolean {\n    return this.format === \"json\";\n  }\n\n  /**\n   * Output data in the configured format.\n   * Use format='json' for AI agents and structured data.\n   */\n  output(data: unknown): void {\n    switch (this.format) {\n      case \"json\":\n        console.log(JSON.stringify(data, null, 2));\n        break;\n      case \"table\":\n        this.outputTable(data);\n        break;\n      case \"human\":\n      default:\n        console.log(data);\n        break;\n    }\n  }\n\n  /**\n   * Output a list with a human-readable one-liner per item and a table for table format.\n   * Falls back to JSON for json format.\n   *\n   * @param data - Array of items to display\n   * @param columns - Ordered list of field names to include in human/table output\n   * @param emptyMessage - Message shown when data is empty (human format only)\n   * @param lineFormat - Optional custom line formatter for human format\n   */\n  outputList<T extends object>(\n    data: T[],\n    columns: (keyof T & string)[],\n    emptyMessage: string,\n    lineFormat?: (item: T) => string,\n  ): void {\n    if (this.format === \"json\") {\n      console.log(JSON.stringify(data, null, 2));\n      return;\n    }\n\n    if (this.format === \"table\") {\n      this.outputTable(data.map((item) => Object.fromEntries(columns.map((c) => [c, item[c]]))));\n      return;\n    }\n\n    // human\n    if (data.length === 0) {\n      console.log(colors.cyan(emptyMessage));\n      return;\n    }\n\n    if (lineFormat) {\n      for (const item of data) {\n        console.log(lineFormat(item));\n      }\n      return;\n    }\n\n    // Default: padded columns\n    const widths = columns.map((col) =>\n      Math.max(\n        col.length,\n        ...data.map((item) => String((item as Record<string, unknown>)[col] ?? \"\").length),\n      ),\n    );\n    for (const item of data) {\n      const row = item as Record<string, unknown>;\n      const line = columns.map((col, i) => String(row[col] ?? \"\").padEnd(widths[i])).join(\"  \");\n      console.log(line.trimEnd());\n    }\n  }\n\n  /**\n   * Output a single resource in human-readable format.\n   * For json format, uses JSON.stringify. For table format, uses a two-column key/value table.\n   *\n   * @param data - Object to display\n   * @param fields - Ordered list of fields to display (defaults to all keys)\n   */\n  outputOne<T extends object>(data: T, fields?: (keyof T & string)[]): void {\n    if (this.format === \"json\") {\n      console.log(JSON.stringify(data, null, 2));\n      return;\n    }\n\n    const record = data as Record<string, unknown>;\n    const keys = fields ?? (Object.keys(record) as (keyof T & string)[]);\n\n    if (this.format === \"table\") {\n      const rows = keys.map((k) => ({ field: k, value: String(record[k] ?? \"\") }));\n      this.outputTable(rows);\n      return;\n    }\n\n    // human: key: value pairs\n    const keyWidth = Math.max(...keys.map((k) => k.length));\n    for (const key of keys) {\n      const value = record[key];\n      const valueStr =\n        value !== null && typeof value === \"object\" ? JSON.stringify(value) : String(value ?? \"\");\n      console.log(`${colors.cyan(key.padEnd(keyWidth))}  ${valueStr}`);\n    }\n  }\n\n  success(message: string): void {\n    if (this.format === \"json\") {\n      console.log(JSON.stringify({ status: \"success\", message }));\n    } else {\n      console.log(colors.green(`✓ ${message}`));\n    }\n  }\n\n  error(message: string, details?: unknown): void {\n    if (this.format === \"json\") {\n      console.error(JSON.stringify({ status: \"error\", message, details }));\n    } else {\n      console.error(colors.red(`✗ ${message}`));\n      if (details !== undefined) {\n        console.error(details);\n      }\n    }\n  }\n\n  warning(message: string): void {\n    if (this.format === \"json\") {\n      console.log(JSON.stringify({ status: \"warning\", message }));\n    } else {\n      console.log(colors.yellow(`⚠ ${message}`));\n    }\n  }\n\n  info(message: string): void {\n    if (this.format === \"json\") {\n      console.log(JSON.stringify({ status: \"info\", message }));\n    } else {\n      console.log(colors.cyan(message));\n    }\n  }\n\n  private outputTable(data: unknown): void {\n    if (Array.isArray(data) && data.length > 0) {\n      const headers = Object.keys(data[0] as Record<string, unknown>);\n      const colWidths = headers.map((h) => {\n        const maxDataWidth = Math.max(\n          ...data.map((row) => String((row as Record<string, unknown>)[h] ?? \"\").length),\n        );\n        return Math.max(h.length, maxDataWidth);\n      });\n\n      // Header\n      const headerRow = headers.map((h, i) => h.padEnd(colWidths[i])).join(\" | \");\n      console.log(headerRow);\n      console.log(colWidths.map((w) => \"-\".repeat(w)).join(\"-+-\"));\n\n      // Rows\n      for (const row of data) {\n        const rowStr = headers\n          .map((h, i) => String((row as Record<string, unknown>)[h] ?? \"\").padEnd(colWidths[i]))\n          .join(\" | \");\n        console.log(rowStr);\n      }\n    }\n  }\n}\nexport const x = { a: 1, b: 2 };\n","/**\n * CLI execution context with dependency injection.\n *\n * Instead of hidden dependencies in command handlers, this module provides\n * explicit dependency passing for testability and transparency.\n */\n\nimport type { HttpClient } from \"@studiometa/forge-api\";\nimport type { ExecutorContext } from \"@studiometa/forge-core\";\n\nimport type { OutputFormat } from \"./types.ts\";\n\nimport { HttpClient as ForgeHttpClient } from \"@studiometa/forge-api\";\nimport { ConfigError } from \"./errors.ts\";\nimport { createConfigStore, getToken } from \"./config.ts\";\nimport { OutputFormatter } from \"./output.ts\";\n\nexport interface CommandOptions {\n  [key: string]: string | boolean | string[] | undefined;\n  format?: string;\n  f?: string;\n  token?: string;\n  \"no-color\"?: boolean;\n}\n\n/**\n * Context containing all dependencies needed by command handlers.\n */\nexport interface CommandContext {\n  /** Output formatter for the current format */\n  readonly formatter: OutputFormatter;\n  /** Raw CLI options */\n  readonly options: CommandOptions;\n  /** Create an ExecutorContext from this command context */\n  createExecutorContext(token: string): ExecutorContext;\n  /** Resolve the API token or throw ConfigError */\n  getToken(): string;\n}\n\n/**\n * Creates a command context from CLI options.\n */\nexport function createContext(options: CommandOptions = {}): CommandContext {\n  const format = (options.format ?? options.f ?? \"human\") as OutputFormat;\n  const noColor = options[\"no-color\"] === true;\n  const formatter = new OutputFormatter(format, noColor);\n\n  return {\n    formatter,\n    options,\n\n    createExecutorContext(token: string): ExecutorContext {\n      const client = new ForgeHttpClient({ token }) as unknown as HttpClient;\n      return { client };\n    },\n\n    getToken(): string {\n      // 1. CLI arg\n      if (typeof options.token === \"string\" && options.token) {\n        return options.token;\n      }\n      // 2. Env var / config file\n      const stored = getToken(createConfigStore());\n      if (stored) {\n        return stored;\n      }\n      // 3. Not found — throw\n      throw ConfigError.missingToken();\n    },\n  };\n}\n\n/**\n * Creates a test context for unit tests.\n *\n * @example\n * ```typescript\n * const ctx = createTestContext({\n *   mockClient: { get: async () => ({ servers: [] }) } as never,\n * });\n * ```\n */\nexport function createTestContext(overrides: {\n  options?: CommandOptions;\n  formatter?: OutputFormatter;\n  token?: string;\n  mockClient?: HttpClient;\n}): CommandContext {\n  const opts: CommandOptions = overrides.options ?? {\n    format: \"json\",\n    \"no-color\": true,\n  };\n  const format = (opts.format ?? \"json\") as OutputFormat;\n  const formatter = overrides.formatter ?? new OutputFormatter(format, true);\n\n  return {\n    formatter,\n    options: opts,\n    createExecutorContext(_token: string): ExecutorContext {\n      if (!overrides.mockClient) {\n        throw new Error(\n          \"createTestContext: provide mockClient to use createExecutorContext in tests\",\n        );\n      }\n      return { client: overrides.mockClient };\n    },\n    getToken(): string {\n      if (overrides.token) return overrides.token;\n      if (typeof opts.token === \"string\") return opts.token;\n      return \"test-token\";\n    },\n  };\n}\n","/**\n * Centralized error handling for forge-cli.\n */\n\nimport type { OutputFormatter } from \"./output.ts\";\n\nimport { ApiError, CliError, ConfigError, ValidationError, isCliError } from \"./errors.ts\";\n\n/**\n * Exit codes for different error categories.\n */\nexport const ExitCode = {\n  SUCCESS: 0,\n  GENERAL_ERROR: 1,\n  AUTHENTICATION_ERROR: 2,\n  VALIDATION_ERROR: 3,\n  CONFIG_ERROR: 4,\n  NOT_FOUND_ERROR: 5,\n} as const;\n\nexport type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];\n\n/**\n * Determine the appropriate exit code for an error.\n */\nexport function getExitCode(error: unknown): ExitCode {\n  if (error instanceof ValidationError) {\n    return ExitCode.VALIDATION_ERROR;\n  }\n  if (error instanceof ApiError) {\n    if (error.statusCode === 401) return ExitCode.AUTHENTICATION_ERROR;\n    if (error.statusCode === 404) return ExitCode.NOT_FOUND_ERROR;\n  }\n  if (isCliError(error) && error.code === \"CONFIG_ERROR\") {\n    return ExitCode.CONFIG_ERROR;\n  }\n  return ExitCode.GENERAL_ERROR;\n}\n\n/**\n * Central error handler for all commands.\n */\nexport function handleError(\n  error: unknown,\n  formatter: OutputFormatter,\n  options?: { exit?: boolean },\n): ExitCode {\n  const shouldExit = options?.exit ?? true;\n\n  let cliError: CliError;\n  if (isCliError(error)) {\n    cliError = error;\n  } else {\n    cliError = ApiError.fromForgeError(error);\n  }\n\n  // Output error in appropriate format\n  const opts = formatter as unknown as { format?: string };\n  if (opts.format === \"json\") {\n    formatter.output(cliError.toJSON());\n  } else {\n    formatter.error(cliError.toFormattedMessage());\n  }\n\n  const exitCode = getExitCode(cliError);\n\n  if (shouldExit) {\n    process.exit(exitCode);\n  }\n\n  return exitCode;\n}\n\n/**\n * Wraps a command function with automatic error handling.\n */\nexport async function runCommand<T>(\n  fn: () => Promise<T>,\n  formatter: OutputFormatter,\n): Promise<T | undefined> {\n  try {\n    return await fn();\n  } catch (error) {\n    handleError(error, formatter);\n    return undefined; // unreachable due to process.exit\n  }\n}\n\n/**\n * Exits with a validation error for a missing required argument.\n */\nexport function exitWithValidationError(\n  field: string,\n  usage: string,\n  formatter: OutputFormatter,\n): never {\n  const error = ValidationError.required(field, [`Usage: ${usage}`]);\n  handleError(error, formatter);\n  // Unreachable in production\n  throw error;\n}\n\n/**\n * Exits with a config error when token is missing.\n */\nexport function exitWithConfigError(formatter: OutputFormatter): never {\n  const error = ConfigError.missingToken();\n  handleError(error, formatter);\n  throw error;\n}\n"],"mappings":"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"}

package/dist/error-handler.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Centralized error handling for forge-cli.
+ */
+import type { OutputFormatter } from "./output.ts";
+/**
+ * Exit codes for different error categories.
+ */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly AUTHENTICATION_ERROR: 2;
+    readonly VALIDATION_ERROR: 3;
+    readonly CONFIG_ERROR: 4;
+    readonly NOT_FOUND_ERROR: 5;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+/**
+ * Determine the appropriate exit code for an error.
+ */
+export declare function getExitCode(error: unknown): ExitCode;
+/**
+ * Central error handler for all commands.
+ */
+export declare function handleError(error: unknown, formatter: OutputFormatter, options?: {
+    exit?: boolean;
+}): ExitCode;
+/**
+ * Wraps a command function with automatic error handling.
+ */
+export declare function runCommand<T>(fn: () => Promise<T>, formatter: OutputFormatter): Promise<T | undefined>;
+/**
+ * Exits with a validation error for a missing required argument.
+ */
+export declare function exitWithValidationError(field: string, usage: string, formatter: OutputFormatter): never;
+/**
+ * Exits with a config error when token is missing.
+ */
+export declare function exitWithConfigError(formatter: OutputFormatter): never;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAYpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,QAAQ,CAyBV;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAOxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,eAAe,GACzB,KAAK,CAKP;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,GAAG,KAAK,CAIrE"}