@studiometa/forge-cli 0.4.5 → 0.4.7

package/dist/commands/completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2pBH,wBAAgB,kBAAkB,IAAI,IAAI,CA2CzC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAM,GACxD,IAAI,CAoEN"}
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkvBH,wBAAgB,kBAAkB,IAAI,IAAI,CA2CzC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAM,GACxD,IAAI,CAoEN"}

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

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

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

@@ -1,6 +1,7 @@
 import type { CommandContext } from "../../context.ts";
 export declare function daemonsList(ctx: CommandContext): Promise<void>;
 export declare function daemonsGet(args: string[], ctx: CommandContext): Promise<void>;
+export declare function daemonsLogs(args: string[], ctx: CommandContext): Promise<void>;
 export declare function daemonsUpdate(args: string[], ctx: CommandContext): Promise<void>;
 export declare function daemonsRestart(args: string[], ctx: CommandContext): Promise<void>;
 //# sourceMappingURL=handlers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/daemons/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,CAmBpE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCnF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BvF"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/daemons/handlers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCnF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BpF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BvF"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/deployments/command.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,6GAQnC,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/deployments/command.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,wBAAwB,6GAYnC,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/deployments/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCxE;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE1E"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/deployments/handlers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCxE;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CxF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC1E;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+E1E"}

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

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

package/dist/commands/env/env-diff.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Compare two .env files by variable name, without exposing any value.
+ */
+import type { Drift } from "../../utils/drift.ts";
+export interface EnvDiff {
+    /** Names only in the local file. */
+    added: string[];
+    /** Names only on Forge. */
+    removed: string[];
+    /** Names in both, with a different value. */
+    changed: string[];
+}
+/**
+ * Parse a .env file into a map of name to value, with the dotenv rules used by Laravel:
+ * an optional `export ` prefix, quoted values that can span lines, and ` #` inline comments
+ * after unquoted values. Blank lines, comments and lines without a valid name are ignored,
+ * so a part of a value can never show as a name.
+ */
+export declare function parseEnv(content: string): Map<string, string>;
+/**
+ * Compare the variables of two .env files. Returns only variable names.
+ */
+export declare function diffEnv(remote: string, local: string): EnvDiff;
+/**
+ * Turn an env diff into a drift report, or null when the variables are the same.
+ * The report holds variable names only, never values, because CI logs are often shared.
+ */
+export declare function envDrift(remote: string, local: string): Drift | null;
+//# sourceMappingURL=env-diff.d.ts.map

package/dist/commands/env/env-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-diff.d.ts","sourceRoot":"","sources":["../../../src/commands/env/env-diff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,OAAO;IACtB,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA8B7D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAoB9D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAQpE"}

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/env/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,wBAAsB,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC/D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqClE"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/env/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD,wBAAsB,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC/D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmClE"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/nginx/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCjE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCpE"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/nginx/handlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOvD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCjE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCpE"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/php/command.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,gBAAgB,6GAsB3B,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { CommandContext } from "../../context.ts";
+/**
+ * List the PHP versions installed on a server.
+ */
+export declare function phpList(ctx: CommandContext): Promise<void>;
+/**
+ * Print a PHP configuration file (cli, fpm or pool).
+ */
+export declare function phpConfig(ctx: CommandContext): Promise<void>;
+/**
+ * Replace a PHP configuration file, or compare it with Forge when --check is set.
+ */
+export declare function phpUpdateConfig(ctx: CommandContext): Promise<void>;
+/**
+ * Print the PHP max upload size, in megabytes.
+ */
+export declare function phpMaxUploadSize(ctx: CommandContext): Promise<void>;
+/**
+ * Set the PHP max upload size, in megabytes.
+ */
+export declare function phpSetMaxUploadSize(args: string[], ctx: CommandContext): Promise<void>;
+/**
+ * Print the PHP max execution time, in seconds.
+ */
+export declare function phpMaxExecutionTime(ctx: CommandContext): Promise<void>;
+/**
+ * Set the PHP max execution time, in seconds.
+ */
+export declare function phpSetMaxExecutionTime(args: string[], ctx: CommandContext): Promise<void>;
+/**
+ * Print whether OPcache is enabled.
+ */
+export declare function phpOpcache(ctx: CommandContext): Promise<void>;
+/**
+ * Enable OPcache.
+ */
+export declare function phpEnableOpcache(ctx: CommandContext): Promise<void>;
+/**
+ * Disable OPcache.
+ */
+export declare function phpDisableOpcache(ctx: CommandContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/php/handlers.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiGvD;;GAEG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E"}

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,10 @@
+import type { CommandContext } from "../../context.ts";
+/**
+ * List services on a server with a derived availability flag.
+ */
+export declare function servicesList(args: string[], ctx: CommandContext): Promise<void>;
+/**
+ * Restart a service on a server.
+ */
+export declare function servicesRestart(args: string[], ctx: CommandContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/services/handlers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBrF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCxF"}

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +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"}
+{"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,CAuEzD"}

package/dist/commands/ssh-keys/sync-plan.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pure logic for `forge ssh-keys sync`: parse an authorized_keys file, give each key
+ * a stable managed name, and compare the file with the keys on a server.
+ *
+ * The Forge API does not return public keys, so keys are matched by name. The name
+ * ends with a fingerprint of the key, so a changed key gets a new name.
+ */
+/**
+ * Check the base64 key data of a public key, as OpenSSH does: it must be canonical
+ * base64, and the decoded key must start with its own type as a length-prefixed string.
+ */
+export declare function isValidKeyBlob(type: string, blob: string): boolean;
+/** A public key from the file, with the name it gets on Forge. */
+export interface FileKey {
+    name: string;
+    /** Public key as sent to Forge: "<type> <base64> [comment]". */
+    key: string;
+    /** Line number in the file (1-based). */
+    line: number;
+}
+/** A key that exists on a server. */
+export interface ServerKey {
+    id: number;
+    name: string;
+    user: string;
+}
+export interface SyncPlan {
+    /** File keys that are not on the server. */
+    add: FileKey[];
+    /** Keys of the user on the server that are not in the file. */
+    remove: ServerKey[];
+    /** File keys that are already on the server. */
+    unchanged: FileKey[];
+}
+/**
+ * Convert a key comment to a name prefix: lowercase, `[a-z0-9-]` only, "key" when empty.
+ */
+export declare function slugify(comment: string): string;
+/**
+ * Managed name of a key: "<slug(comment)>-<first 8 hex chars of the SHA-256 of the key blob>".
+ * The blob is the decoded base64 field, as in an OpenSSH fingerprint.
+ */
+export declare function managedKeyName(comment: string, blob: string): string;
+/**
+ * Parse an authorized_keys file: one "<type> <base64> [comment]" per line.
+ * Blank lines and "#" comments are ignored.
+ *
+ * @throws ValidationError for a malformed or duplicate key, with its line number.
+ */
+export declare function parseAuthorizedKeys(content: string): FileKey[];
+/**
+ * Compare the file keys with the keys on a server, for one user.
+ * Keys of other users are ignored.
+ */
+export declare function planSync(fileKeys: FileKey[], serverKeys: ServerKey[], user: string): SyncPlan;
+//# sourceMappingURL=sync-plan.d.ts.map

package/dist/commands/ssh-keys/sync-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-plan.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/sync-plan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED,kEAAkE;AAClE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,4CAA4C;IAC5C,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,+DAA+D;IAC/D,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,OAAO,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAyC9D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAU7F"}

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

@@ -0,0 +1,6 @@
+import type { CommandContext } from "../../context.ts";
+/**
+ * Make the SSH keys of a user on one or more servers match an authorized_keys file.
+ */
+export declare function sshKeysSync(ctx: CommandContext): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA8KvD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHpE"}

package/dist/{error-handler-peS_8nl4.js → error-handler-Adi84RcF.js}

@@ -195,6 +195,17 @@ var OutputFormatter = class {
 		}
 	}
 	/**
+	* Output raw text such as a log. Human and table formats print the text
+	* verbatim (a log is not tabular data); JSON wraps it as a JSON string.
+	*/
+	outputText(text) {
+		if (this.format === "json") {
+			console.log(JSON.stringify(text));
+			return;
+		}
+		console.log(text);
+	}
+	/**
 	* Output a list with a human-readable one-liner per item and a table for table format.
 	* Falls back to JSON for json format.
 	*
@@ -414,14 +425,19 @@ async function runCommand(fn, formatter) {
 	}
 }
 /**
-* Exits with a validation error for a missing required argument.
+* Outputs an error and exits.
 */
-function exitWithValidationError(field, usage, formatter) {
-	const error = ValidationError.required(field, [`Usage: ${usage}`]);
+function exitWithError(error, formatter) {
 	handleError(error, formatter);
 	throw error;
 }
+/**
+* Exits with a validation error for a missing required argument.
+*/
+function exitWithValidationError(field, usage, formatter) {
+	exitWithError(ValidationError.required(field, [`Usage: ${usage}`]), formatter);
+}
 //#endregion
-export { isOutputFormat as S, ApiError as _, createContext as a, ValidationError as b, colors as c, deleteToken as d, getConfig as f, setToken as g, setOrganizationSlug as h, runCommand as i, setColorEnabled as l, getToken$1 as m, exitWithValidationError as n, createTestContext as o, getOrganizationSlug as p, handleError as r, OutputFormatter as s, ExitCode as t, createConfigStore$1 as u, CliError as v, isCliError as x, ConfigError as y };
+export { isOutputFormat as C, isCliError as S, setToken as _, runCommand as a, ConfigError as b, OutputFormatter as c, createConfigStore$1 as d, deleteToken as f, setOrganizationSlug as g, getToken$1 as h, handleError as i, colors as l, getOrganizationSlug as m, exitWithError as n, createContext as o, getConfig as p, exitWithValidationError as r, createTestContext as s, ExitCode as t, setColorEnabled as u, ApiError as v, ValidationError as x, CliError as y };
 
-//# sourceMappingURL=error-handler-peS_8nl4.js.map
+//# sourceMappingURL=error-handler-Adi84RcF.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler-Adi84RcF.js","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/config.ts","../src/utils/colors.ts","../src/output.ts","../src/context.ts","../src/error-handler.ts"],"sourcesContent":["// CLI-specific types for forge\n\nexport type OutputFormat = \"json\" | \"human\" | \"table\";\n\nexport function isOutputFormat(value: unknown): value is OutputFormat {\n  return value === \"json\" || value === \"human\" || value === \"table\";\n}\n\nexport interface CliOptions {\n  format?: OutputFormat;\n  quiet?: boolean;\n  noColor?: boolean;\n}\n","/**\n * Error types for forge.\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 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 code = (error as { statusCode: unknown }).statusCode;\n      return new ApiError(\n        error.message,\n        typeof code === \"number\" ? code : undefined,\n        undefined,\n        error,\n      );\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.\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 {\n  createConfigStore,\n  getToken,\n  setToken,\n  deleteToken,\n  getOrganizationSlug,\n  setOrganizationSlug,\n} 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","/* eslint-disable typescript-eslint/no-base-to-string -- generic formatter converts unknown values to strings */\nimport 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      default:\n        console.log(data);\n        break;\n    }\n  }\n\n  /**\n   * Output raw text such as a log. Human and table formats print the text\n   * verbatim (a log is not tabular data); JSON wraps it as a JSON string.\n   */\n  outputText(text: string): void {\n    if (this.format === \"json\") {\n      console.log(JSON.stringify(text));\n      return;\n    }\n    console.log(text);\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}\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, isOutputFormat } from \"./types.ts\";\n\nimport { HttpClient as ForgeHttpClient } from \"@studiometa/forge-api\";\nimport { ConfigError } from \"./errors.ts\";\nimport { createConfigStore, getToken, getOrganizationSlug } 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 rawFormat = options.format ?? options.f ?? \"human\";\n  const format: OutputFormat = isOutputFormat(rawFormat) ? rawFormat : \"human\";\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: HttpClient = new ForgeHttpClient({ token });\n      const orgSlug =\n        (typeof options.org === \"string\" && options.org) ||\n        getOrganizationSlug(createConfigStore()) ||\n        undefined;\n      return { client, organizationSlug: orgSlug };\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 rawFormat = opts.format ?? \"json\";\n  const format: OutputFormat = isOutputFormat(rawFormat) ? rawFormat : \"json\";\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, organizationSlug: \"test-org\" };\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.\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  if (formatter.isJson()) {\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 * Outputs an error and exits.\n */\nexport function exitWithError(error: CliError, formatter: OutputFormatter): never {\n  handleError(error, formatter);\n  // Unreachable in production\n  throw error;\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  exitWithError(ValidationError.required(field, [`Usage: ${usage}`]), formatter);\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

@@ -2,6 +2,7 @@
  * Centralized error handling for forge.
  */
 import type { OutputFormatter } from "./output.ts";
+import { CliError } from "./errors.ts";
 /**
  * Exit codes for different error categories.
  */
@@ -28,6 +29,10 @@ export declare function handleError(error: unknown, formatter: OutputFormatter,
  * Wraps a command function with automatic error handling.
  */
 export declare function runCommand<T>(fn: () => Promise<T>, formatter: OutputFormatter): Promise<T | undefined>;
+/**
+ * Outputs an error and exits.
+ */
+export declare function exitWithError(error: CliError, formatter: OutputFormatter): never;
 /**
  * Exits with a validation error for a missing required argument.
  */

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

@@ -1 +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;aACnB,OAAO,EAAE,CAAC;aACV,aAAa,EAAE,CAAC;aAChB,oBAAoB,EAAE,CAAC;aACvB,gBAAgB,EAAE,CAAC;aACnB,YAAY,EAAE,CAAC;aACf,eAAe,EAAE,CAAC;CACV,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,CAwBV;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"}
+{"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;AAEnD,OAAO,EAAY,QAAQ,EAA4C,MAAM,aAAa,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,QAAQ;aACnB,OAAO,EAAE,CAAC;aACV,aAAa,EAAE,CAAC;aAChB,oBAAoB,EAAE,CAAC;aACvB,gBAAgB,EAAE,CAAC;aACnB,YAAY,EAAE,CAAC;aACf,eAAe,EAAE,CAAC;CACV,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,CAwBV;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,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,KAAK,CAIhF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,eAAe,GACzB,KAAK,CAEP;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,GAAG,KAAK,CAIrE"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { _ as ApiError, a as createContext, b as ValidationError, f as getConfig, i as runCommand, o as createTestContext, r as handleError, s as OutputFormatter, t as ExitCode, v as CliError, x as isCliError, y as ConfigError } from "./error-handler-peS_8nl4.js";
+import { S as isCliError, a as runCommand, b as ConfigError, c as OutputFormatter, i as handleError, o as createContext, p as getConfig, s as createTestContext, t as ExitCode, v as ApiError, x as ValidationError, y as CliError } from "./error-handler-Adi84RcF.js";
 export { ApiError, CliError, ConfigError, ExitCode, OutputFormatter, ValidationError, createContext, createTestContext, getConfig, handleError, isCliError, runCommand };

package/dist/output.d.ts

@@ -16,6 +16,11 @@ export declare class OutputFormatter {
      * Use format='json' for AI agents and structured data.
      */
     output(data: unknown): void;
+    /**
+     * Output raw text such as a log. Human and table formats print the text
+     * verbatim (a log is not tabular data); JSON wraps it as a JSON string.
+     */
+    outputText(text: string): void;
     /**
      * Output a list with a human-readable one-liner per item and a table for table format.
      * Falls back to JSON for json format.

package/dist/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;GAGG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAFjB,YACU,MAAM,GAAE,YAAsB,EAC9B,OAAO,GAAE,OAAe,EAC9B;IAEJ;;OAEG;IACH,MAAM,IAAI,OAAO,CAEhB;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAY1B;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EACzB,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,EAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAC/B,IAAI,CAoCN;IAED;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAuBxE;IAED,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM7B;IAED,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAS9C;IAED,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM7B;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM1B;IAED,OAAO,CAAC,WAAW;CAwBpB"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;GAGG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAFjB,YACU,MAAM,GAAE,YAAsB,EAC9B,OAAO,GAAE,OAAe,EAC9B;IAEJ;;OAEG;IACH,MAAM,IAAI,OAAO,CAEhB;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAY1B;IAED;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM7B;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EACzB,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,EAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAC/B,IAAI,CAoCN;IAED;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAuBxE;IAED,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM7B;IAED,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAS9C;IAED,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM7B;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM1B;IAED,OAAO,CAAC,WAAW;CAwBpB"}

package/dist/utils/args.d.ts

@@ -12,4 +12,10 @@ export interface ParsedArgs {
 export declare function parseArgs(argv?: string[]): ParsedArgs;
 export declare function getOption(options: Record<string, OptionValue>, names: string[], defaultValue?: string): string | undefined;
 export declare function hasFlag(options: Record<string, OptionValue>, names: string[]): boolean;
+/**
+ * Whether the arguments ask for the CLI version: a bare `--version` or `-v`
+ * with no command. Commands such as `php config` and `services restart` take
+ * `--version <value>`, so a bare `--version` after a command is not a version request.
+ */
+export declare function isVersionRequest({ command, options }: ParsedArgs): boolean;
 //# sourceMappingURL=args.d.ts.map

package/dist/utils/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/utils/args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,UAAU,CAwD5E;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACpC,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtF"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/utils/args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAqCD,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,UAAU,CAwD5E;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACpC,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,OAAO,CAE1E"}

package/dist/utils/content-source.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Read the content of an update command from a file, stdin or an inline option.
+ */
+import type { CommandOptions } from "../context.ts";
+import type { OutputFormatter } from "../output.ts";
+import type { OptionValue } from "./args.ts";
+export interface ContentSource {
+    /** What the content is, in lower case, e.g. "deployment script". */
+    label: string;
+    /** Usage line shown in validation errors. */
+    usage: string;
+    formatter: OutputFormatter;
+}
+/**
+ * Read content from a file path, or from stdin when the path is "-".
+ * Exits with a validation error when the path is missing, the file cannot be read or it is empty.
+ */
+export declare function readContentFile(path: OptionValue | undefined, field: string, source: ContentSource): string;
+/**
+ * Read content from exactly one of `--file <path|->` or `--content <string>`.
+ * Exits with a validation error when both or none are given, or when the content is empty.
+ */
+export declare function readContentOption(options: CommandOptions, source: ContentSource): string;
+//# sourceMappingURL=content-source.d.ts.map

package/dist/utils/content-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-source.d.ts","sourceRoot":"","sources":["../../src/utils/content-source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,eAAe,CAAC;CAC5B;AAYD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,GACpB,MAAM,CAuBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CA6BxF"}

package/dist/utils/drift.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Compare local content with the content on Forge for `--check`.
+ */
+import type { OutputFormatter } from "../output.ts";
+/**
+ * Normalize CRLF to LF and drop a single trailing newline,
+ * so editor and platform differences do not count as drift.
+ */
+export declare function normalizeContent(text: string): string;
+/**
+ * Build a unified-style line diff from `remote` to `local`, with `context`
+ * unchanged lines around each change. Returns an empty string when both
+ * are equal after normalization.
+ */
+export declare function unifiedDiff(remote: string, local: string, context?: number): string;
+/**
+ * A difference found by `--check`: `text` for human output, `json` for json output.
+ */
+export interface Drift {
+    text: string;
+    json: unknown;
+}
+/**
+ * Print the result of a `--check` and set exit code 1 when the local content differs from Forge.
+ * It sets `process.exitCode` and does not call `process.exit`, so a long diff
+ * written to a pipe is not cut. JSON output is `{ inSync: true }` or `{ inSync: false, diff }`.
+ */
+export declare function reportDrift(label: string, drift: Drift | null, formatter: OutputFormatter): void;
+/**
+ * Check `local` against `remote` as text and report a line diff.
+ */
+export declare function reportTextDrift(label: string, remote: string, local: string, formatter: OutputFormatter): void;
+//# sourceMappingURL=drift.d.ts.map

package/dist/utils/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/utils/drift.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD;AAeD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CAsD9E;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI,CAehG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,eAAe,GACzB,IAAI,CAGN"}

package/dist/utils/resolve.d.ts

@@ -13,6 +13,14 @@ import type { ExecutorContext } from "@studiometa/forge-core";
  *   - 2+ matches → ValidationError listing ambiguous matches
  */
 export declare function resolveServerId(value: string, execCtx: ExecutorContext): Promise<string>;
+/**
+ * Resolve a --server value to a numeric server ID string, against a list of servers
+ * that is already loaded. Same rules as {@link resolveServerId}, with no API call.
+ */
+export declare function matchServerId(value: string, servers: Array<{
+    id: number;
+    name: string;
+}>): string;
 /**
  * Resolve a --site value to a numeric site ID string.
  *

package/dist/utils/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/utils/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B9F;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA+BjB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/utils/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CA4BjG;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA+BjB"}