@studiometa/forge-cli 0.0.1 → 0.2.0

package/dist/commands/security-rules/handlers.d.ts

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

package/dist/commands/security-rules/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/security-rules/handlers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsBvD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB1E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBzF;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5E;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5F"}

package/dist/commands/security-rules/help.d.ts

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

package/dist/commands/security-rules/help.d.ts.map

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

package/dist/commands/security-rules/index.d.ts

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

package/dist/commands/security-rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/security-rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

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

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

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * CLI handlers for servers commands.
+ * Delegates all HTTP logic to forge-core executors.
+ */
+import type { CommandContext } from "../../context.ts";
+/**
+ * List all servers.
+ */
+export declare function serversList(ctx: CommandContext): Promise<void>;
+/**
+ * Get a single server by ID or name.
+ */
+export declare function serversGet(args: string[], ctx: CommandContext): Promise<void>;
+/**
+ * Reboot a server by ID or name.
+ */
+export declare function serversReboot(args: string[], ctx: CommandContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CActF"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/sites/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,wBAAsB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBlE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCjF"}

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

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

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

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

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

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

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

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

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

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

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