@studiometa/forge-cli 0.5.1 → 0.5.2

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;AAszBH,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;AA0zBH,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/sites/apply/apply.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Read the state of Forge for a site file, and run a plan against Forge.
+ */
+import type { CliExecutorContext } from "../../../context.ts";
+import { CliError } from "../../../errors.ts";
+import { type Change, type Plan, type RemoteState, type Site } from "./plan.ts";
+import type { SiteFile } from "./site-file.ts";
+/** Error of `apply` that is not a validation error, e.g. a site that never gets installed. */
+export declare class ApplyError extends CliError {
+    readonly code = "APPLY_ERROR";
+    readonly isRecoverable = false;
+}
+/**
+ * Resolve the server of the site file, always with an exact name (never a partial match).
+ */
+export declare function resolveApplyServer(server: string | number, ctx: CliExecutorContext): Promise<string>;
+/**
+ * The site named `domain` on the server, compared without case. A partial match never counts.
+ */
+export declare function findSite(sites: Site[], domain: string): Site | null;
+/**
+ * Read from Forge what the site file manages, and nothing else.
+ */
+export declare function readRemoteState(file: SiteFile, serverId: string, ctx: CliExecutorContext): Promise<RemoteState>;
+/**
+ * Exit with a validation error when the site does not exist and the site file cannot create it.
+ */
+export declare function assertCanCreateSite(file: SiteFile, state: RemoteState): void;
+/** A random password for a database user: 32 characters, letters and digits only. */
+export declare function generatePassword(): string;
+/** Write a value for a .env file, quoted when it needs quotes. */
+export declare function formatEnvValue(value: string): string;
+/**
+ * Set .env variables: replace the line of a variable that exists, append the others.
+ */
+export declare function setEnvValues(content: string, values: Map<string, string>): string;
+export interface ApplyOptions {
+    /** Wait between two reads of a new site; injectable for tests. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Time between two reads of a new site, in ms. */
+    pollIntervalMs?: number;
+    /** Time to wait for a new site to be installed, in ms. */
+    timeoutMs?: number;
+    /** Called before each change. */
+    onChange?: (change: Change) => void;
+    /** Generate a password; injectable for tests. */
+    generatePassword?: () => string;
+}
+/**
+ * Apply a site file: create the site when it does not exist and wait until Forge installs it,
+ * then read the state again and run the other changes. Returns the plan that ran first.
+ */
+export declare function applySiteFile(file: SiteFile, serverId: string, ctx: CliExecutorContext, options?: ApplyOptions): Promise<Plan>;
+//# sourceMappingURL=apply.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/apply.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAmB,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,IAAI,EAAa,MAAM,WAAW,CAAC;AAC3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,8FAA8F;AAC9F,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,aAAa,SAAS;CAChC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC,CAkCtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAQ5E;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBjF;AAED,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;CACjC;AA6LD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,EACvB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/commands/sites/apply/handler.d.ts

@@ -0,0 +1,8 @@
+import type { CommandContext } from "../../../context.ts";
+import { type ApplyOptions } from "./apply.ts";
+/**
+ * `forge sites apply --file site.json [--check]`: make a Forge site match a site file.
+ * With `--check`, print the plan and exit 1 when Forge differs, without any change.
+ */
+export declare function sitesApply(ctx: CommandContext, applyOptions?: ApplyOptions): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/commands/sites/apply/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACL,KAAK,YAAY,EAKlB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,cAAc,EACnB,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/commands/sites/apply/ownership.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Path and command helpers of `forge sites apply`: normalize commands so that
+ * equivalent spellings compare equal, and find which site owns a daemon or a scheduled job.
+ *
+ * Ownership is strict on purpose: `apply` deletes the workers and scheduled jobs of a site
+ * that the site file does not declare, and a server often hosts many sites.
+ */
+/** A site, as far as ownership is concerned. */
+export interface SiteRoots {
+    id: number;
+    /** Absolute paths that belong to the site, e.g. `/home/forge/example.com`. */
+    roots: string[];
+}
+/**
+ * Normalize an absolute path: resolve `.` and `..`, collapse repeated slashes
+ * and drop the trailing slash.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Whether `path` is `root` or inside it, compared on whole path segments:
+ * `/home/forge/a.com` contains `/home/forge/a.com/current` but not `/home/forge/a.com-staging`.
+ */
+export declare function isPathInside(path: string, root: string): boolean;
+/**
+ * Resolve `path` against `base` when it is relative.
+ */
+export declare function resolvePath(base: string, path: string): string;
+/**
+ * Whether a shell command uses `root` as a whole path: `root` must start the command or follow
+ * a space, a quote, `=` or a shell operator, and must end the command or be followed by `/`,
+ * a space, a quote or a shell operator. `/home/forge/a.com` is not found in
+ * `/home/forge/a.com-staging/artisan`, `/home/forge/a.com.old` or `/home/forge/*`.
+ */
+export declare function commandUsesPath(command: string, root: string): boolean;
+/**
+ * Split a shell command into words, with the quoting rules of a POSIX shell:
+ * single quotes keep everything, double quotes and a backslash escape one character.
+ */
+export declare function splitCommand(command: string): string[];
+/**
+ * Quote a word for a POSIX shell when it needs quotes.
+ */
+export declare function quoteWord(word: string): string;
+/**
+ * Write a command in one canonical form, so that equivalent spellings compare equal:
+ * quotes only where needed, single spaces, and a relative `artisan` (or `./artisan`)
+ * replaced by its absolute path in `directory`.
+ *
+ * `php artisan queue:work 'database'  --queue="default"` in `/home/forge/example.com/`
+ * gives `php /home/forge/example.com/artisan queue:work database --queue=default`.
+ */
+export declare function canonicalCommand(command: string, directory: string | null): string;
+/**
+ * The site whose root holds `path`: the most specific root wins, so a site in
+ * `/home/forge/a.com/admin` is not owned by `/home/forge/a.com`. Returns null when no site holds it.
+ */
+export declare function siteOfPath(path: string, sites: SiteRoots[]): number | null;
+/**
+ * The sites whose roots a command uses as a path.
+ */
+export declare function sitesOfCommand(command: string, sites: SiteRoots[]): number[];
+/**
+ * Who owns a daemon or a scheduled job, from the point of view of one site:
+ * - `site`: it belongs to the site; `apply` can match it, and delete it when it is not declared
+ * - `ambiguous`: it may belong to the site; `apply` can match it but never deletes it
+ * - `other`: it belongs to another site, to the server, or to nobody known; `apply` ignores it
+ */
+export type Ownership = "site" | "ambiguous" | "other";
+/**
+ * Ownership of a daemon (a Forge background process).
+ *
+ * - With a directory: the site that holds the directory (see {@link siteOfPath}).
+ * - Without a directory: `ambiguous` when the command uses the site root, `site` only when
+ *   the command uses no other site root and Forge also associates the daemon with the site.
+ */
+export declare function daemonOwnership(daemon: {
+    directory: string | null;
+    command: string;
+}, siteId: number, sites: SiteRoots[], associatedWithSite: boolean): Ownership;
+/**
+ * Ownership of a scheduled job. Forge lists the jobs of a site on a site route: those
+ * belong to the site. A job of the server belongs to the site when its command uses the
+ * site root and no other site root; when it uses several site roots, it is `ambiguous`.
+ */
+export declare function scheduledJobOwnership(job: {
+    command: string;
+}, siteId: number, sites: SiteRoots[], listedOnSite: boolean): Ownership;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/commands/sites/apply/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/ownership.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsCtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAUlF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAW1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAI5E;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACrD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAAE,EAClB,kBAAkB,EAAE,OAAO,GAC1B,SAAS,CAQX;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAAE,EAClB,YAAY,EAAE,OAAO,GACpB,SAAS,CAKX"}

package/dist/commands/sites/apply/plan.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Compare a site file with the state of Forge and list the changes that `apply` makes.
+ * Pure functions: no API call here.
+ */
+import type { BackgroundProcessAttributes, DatabaseAttributes, DatabaseUserAttributes, ScheduledJobAttributes, SiteAttributes } from "@studiometa/forge-api";
+import type { SiteFile } from "./site-file.ts";
+import { type SiteRoots } from "./ownership.ts";
+export type Site = SiteAttributes & {
+    id: number;
+};
+export type Daemon = BackgroundProcessAttributes & {
+    id: number;
+};
+export type ScheduledJob = ScheduledJobAttributes & {
+    id: number;
+};
+export type Database = DatabaseAttributes & {
+    id: number;
+};
+export type DatabaseUser = DatabaseUserAttributes & {
+    id: number;
+};
+/** Shown in place of a generated password. */
+export declare const GENERATED = "<generated>";
+/** What `apply` reads from Forge. A list is undefined when the site file does not manage it. */
+export interface RemoteState {
+    /** All sites of the server. */
+    sites: Site[];
+    /** The site of the file, or null when it does not exist yet. */
+    site: Site | null;
+    databases?: Database[];
+    databaseUsers?: DatabaseUser[];
+    /** Content of the site .env; null when the site does not exist. */
+    env?: string | null;
+    /** All daemons of the server. */
+    daemons?: Daemon[];
+    /** IDs of the daemons that Forge associates with the site. */
+    siteDaemonIds?: ReadonlySet<number>;
+    /** All scheduled jobs of the server, with the jobs of the site. */
+    jobs?: ScheduledJob[];
+    /** IDs of the scheduled jobs that Forge lists on the site. */
+    siteJobIds?: ReadonlySet<number>;
+}
+export interface SiteSettings {
+    type?: string;
+    php_version?: string;
+    web_directory?: string;
+    source_control_provider?: string;
+    repository?: string;
+    branch?: string;
+}
+export type Change = {
+    action: "create-site";
+    name: string;
+    settings: SiteSettings;
+} | {
+    action: "update-site";
+    changes: Array<{
+        field: string;
+        from: string | null;
+        to: string;
+    }>;
+} | {
+    action: "add-alias";
+    name: string;
+} | {
+    action: "create-database";
+    name: string;
+} | {
+    action: "create-database-user";
+    name: string;
+    database: string;
+} | {
+    action: "add-env";
+    keys: string[];
+    generated: string[];
+} | {
+    action: "create-worker";
+    command: string;
+    directory: string;
+    processes: number;
+} | {
+    action: "delete-worker";
+    id: number;
+    command: string;
+    directory: string | null;
+    processes: number;
+} | {
+    action: "create-job";
+    command: string;
+    frequency: string;
+    cron?: string;
+} | {
+    action: "delete-job";
+    id: number;
+    command: string;
+    frequency: string;
+    cron: string;
+    onSite: boolean;
+};
+export interface Plan {
+    changes: Change[];
+    /** Differences that `apply` does not change, e.g. a different .env value. */
+    warnings: string[];
+}
+/** The path of the site folder, e.g. `/home/forge/example.com`. */
+export declare function siteHome(site: Pick<Site, "user" | "name">): string;
+/** The directory that workers run in and relative `artisan` resolves against. */
+export declare function siteWorkDirectory(site: Pick<Site, "user" | "name" | "root_directory">): string;
+/** The paths that belong to each site, for ownership. */
+export declare function siteRoots(sites: Site[]): SiteRoots[];
+/** `PHP 8.3`, `php83` and `php8.3` all give `php83`. */
+export declare function normalizePhp(version: string | null | undefined): string | null;
+/**
+ * Compare the site file with the state of Forge. Keys that the file does not have are not
+ * compared. The plan creates and updates what differs, and deletes only the workers and
+ * scheduled jobs that surely belong to the site and that the file does not declare.
+ */
+export declare function buildPlan(file: SiteFile, state: RemoteState): Plan;
+/**
+ * One line per change, for human output. Values of .env keys never show.
+ */
+export declare function describeChange(change: Change): string;
+/**
+ * The plan as text: one line per change, then the warnings.
+ */
+export declare function formatPlan(plan: Plan): string;
+//# sourceMappingURL=plan.d.ts.map

package/dist/commands/sites/apply/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/plan.ts"],"names":[],"mappings":"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"}

package/dist/commands/sites/apply/site-file.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The site file of `forge sites apply`: a JSON file that declares one Forge site.
+ * A key that is absent is not managed; only `server` and `domain` are required.
+ */
+import * as v from "valibot";
+/** URL of the JSON Schema of the site file, published with the package. */
+export declare const SITE_FILE_SCHEMA_URL = "https://unpkg.com/@studiometa/forge-cli/schemas/site.schema.json";
+export declare const SITE_TYPES: readonly ["laravel", "symfony", "statamic", "wordpress", "phpmyadmin", "php", "nextjs", "nuxtjs", "static-html", "other", "custom"];
+export declare const SOURCE_CONTROL_PROVIDERS: readonly ["github", "gitlab", "bitbucket", "gitlab-custom", "custom"];
+export declare const SCHEDULE_FREQUENCIES: readonly ["minutely", "hourly", "nightly", "weekly", "monthly", "reboot", "custom"];
+export declare const WorkerSchema: v.StrictObjectSchema<{
+    readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    readonly processes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, 1>;
+    readonly directory: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+}, undefined>;
+export declare const ScheduledJobSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+    readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    readonly frequency: v.PicklistSchema<readonly ["minutely", "hourly", "nightly", "weekly", "monthly", "reboot", "custom"], undefined>;
+    readonly cron: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+}, undefined>, v.CheckAction<{
+    command: string;
+    frequency: "custom" | "hourly" | "minutely" | "monthly" | "nightly" | "reboot" | "weekly";
+    cron?: string | undefined;
+}, "cron is required with the custom frequency, and only with it">]>;
+export declare const SiteFileSchema: v.StrictObjectSchema<{
+    readonly $schema: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly server: v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>], undefined>;
+    readonly domain: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    readonly aliases: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>, undefined>;
+    readonly type: v.OptionalSchema<v.PicklistSchema<readonly ["laravel", "symfony", "statamic", "wordpress", "phpmyadmin", "php", "nextjs", "nuxtjs", "static-html", "other", "custom"], undefined>, undefined>;
+    readonly php: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "php must look like php83">]>, undefined>;
+    readonly webDirectory: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    readonly repository: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly provider: v.PicklistSchema<readonly ["github", "gitlab", "bitbucket", "gitlab-custom", "custom"], undefined>;
+        readonly url: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    }, undefined>, undefined>;
+    readonly database: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly user: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    }, undefined>, undefined>;
+    readonly env: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>], undefined>, undefined>, undefined>;
+    readonly workers: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly processes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, 1>;
+        readonly directory: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    readonly schedule: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+        readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly frequency: v.PicklistSchema<readonly ["minutely", "hourly", "nightly", "weekly", "monthly", "reboot", "custom"], undefined>;
+        readonly cron: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    }, undefined>, v.CheckAction<{
+        command: string;
+        frequency: "custom" | "hourly" | "minutely" | "monthly" | "nightly" | "reboot" | "weekly";
+        cron?: string | undefined;
+    }, "cron is required with the custom frequency, and only with it">]>, undefined>, undefined>;
+}, undefined>;
+export type SiteFile = v.InferOutput<typeof SiteFileSchema>;
+export type WorkerDeclaration = v.InferOutput<typeof WorkerSchema>;
+export type ScheduledJobDeclaration = v.InferOutput<typeof ScheduledJobSchema>;
+/**
+ * Validate parsed JSON as a site file. Throws a ValidationError that lists every issue.
+ */
+export declare function parseSiteFile(data: unknown, source?: string): SiteFile;
+/**
+ * Read and validate a site file from disk.
+ */
+export declare function readSiteFile(path: string): SiteFile;
+//# sourceMappingURL=site-file.d.ts.map

package/dist/commands/sites/apply/site-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-file.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/site-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAI7B,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,qEACmC,CAAC;AAIrE,eAAO,MAAM,UAAU,YACrB,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,QAAQ,CACA,CAAC;AAEX,eAAO,MAAM,wBAAwB,YACnC,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,eAAe,EACf,QAAQ,CACA,CAAC;AAEX,eAAO,MAAM,oBAAoB,YAC/B,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,CACA,CAAC;AAEX,eAAO,MAAM,YAAY;;;;aAIvB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;oEAU9B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwBzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;AACnE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/E;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAc,GAAG,QAAQ,CAU3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAkBnD"}

package/dist/commands/sites/apply/test-fixtures.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Fixtures of Forge resources for the tests of `forge sites apply`.
+ */
+import type { CliExecutorContext } from "../../../context.ts";
+import type { Daemon, ScheduledJob, Site } from "./plan.ts";
+export declare function site(id: number, name: string, overrides?: Partial<Site>): Site;
+export declare function daemon(id: number, command: string, directory: string | null, overrides?: Partial<Daemon>): Daemon;
+export declare function job(id: number, command: string, overrides?: Partial<ScheduledJob>): ScheduledJob;
+type Call = [method: string, url: string, body?: unknown];
+export interface FakeForge {
+    sites: Site[];
+    daemons: Daemon[];
+    siteDaemonIds: number[];
+    jobs: ScheduledJob[];
+    siteJobIds: number[];
+    databases: Array<{
+        id: number;
+        name: string;
+    }>;
+    users: Array<{
+        id: number;
+        name: string;
+    }>;
+    env: string;
+    /** Statuses a new site goes through, one per read. */
+    newSiteStatuses: string[];
+}
+/**
+ * A fake Forge API client, enough for `apply`. It records every call.
+ */
+export declare function fakeForge(initial?: Partial<FakeForge>): {
+    ctx: CliExecutorContext;
+    calls: Call[];
+    state: FakeForge;
+    client: {
+        get: import("vitest").Mock<(url: string) => Promise<{
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            }[];
+            links: {};
+            meta: {
+                per_page: number;
+                next_cursor: null;
+                prev_cursor: null;
+            };
+        } | {
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            };
+        }>>;
+        post: import("vitest").Mock<(raw: string, body: Record<string, unknown>) => Promise<{
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            };
+        }>>;
+        put: import("vitest").Mock<(raw: string, body: Record<string, unknown>) => Promise<{
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            };
+        } | null>>;
+        delete: import("vitest").Mock<(url: string) => Promise<void>>;
+        patch: import("vitest").Mock<import("@vitest/spy").Procedure>;
+    };
+};
+export {};
+//# sourceMappingURL=test-fixtures.d.ts.map

package/dist/commands/sites/apply/test-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/test-fixtures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5D,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,IAAI,CAmClF;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,SAAS,GAAE,OAAO,CAAC,MAAM,CAAM,GAC9B,MAAM,CAWR;AAED,wBAAgB,GAAG,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACpC,YAAY,CAcd;AAED,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAsD1D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,OAAO,CAAC,SAAS,CAAM;;;;;yCAiB/B,MAAM;;;;;;;;gBA5ErB,QAAQ;gBAAM,WAAW;gBAAQ,WAAW;;;;;;;;;0CA6H5B,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;yCAsCtC,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;4CASlC,MAAM;;;EAYnC"}

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

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

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

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

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

@@ -1 +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"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA8K3E;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHpE"}

package/dist/context.d.ts

@@ -7,13 +7,27 @@
 import type { HttpClient } from "@studiometa/forge-api";
 import type { ExecutorContext } from "@studiometa/forge-core";
 import { OutputFormatter } from "./output.ts";
+/**
+ * Executor context of the CLI. It also tells the resolvers of --server and --site
+ * how to match names.
+ */
+export interface CliExecutorContext extends ExecutorContext {
+    /** Accept only a numeric ID or an exact name (`--exact` or `FORGE_EXACT_MATCH=1`). */
+    readonly exactMatch: boolean;
+}
 export interface CommandOptions {
     [key: string]: string | boolean | string[] | undefined;
     format?: string;
     f?: string;
     token?: string;
     "no-color"?: boolean;
+    exact?: boolean;
 }
+/**
+ * Whether --server and --site must match an exact name: the `--exact` flag or the
+ * `FORGE_EXACT_MATCH` environment variable (`1` or `true`) turns it on.
+ */
+export declare function isExactMatch(options: CommandOptions, env?: Record<string, string | undefined>): boolean;
 /**
  * Context containing all dependencies needed by command handlers.
  */
@@ -23,7 +37,7 @@ export interface CommandContext {
     /** Raw CLI options */
     readonly options: CommandOptions;
     /** Create an ExecutorContext from this command context */
-    createExecutorContext(token: string): ExecutorContext;
+    createExecutorContext(token: string): CliExecutorContext;
     /** Resolve the API token or throw ConfigError */
     getToken(): string;
 }

package/dist/context.d.ts.map

@@ -1 +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,CAiC1E;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,CA0BjB"}
+{"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;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,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;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,OAAO,CAGT;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,kBAAkB,CAAC;IACzD,iDAAiD;IACjD,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,cAAc,CAkC1E;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,CA8BjB"}

package/dist/{error-handler-Adi84RcF.js → error-handler-s-BOJ1-h.js}

@@ -319,17 +319,28 @@ var OutputFormatter = class {
 //#endregion
 //#region src/context.ts
 /**
+* Whether --server and --site must match an exact name: the `--exact` flag or the
+* `FORGE_EXACT_MATCH` environment variable (`1` or `true`) turns it on.
+*/
+function isExactMatch(options, env = process.env) {
+	const value = env.FORGE_EXACT_MATCH?.trim().toLowerCase();
+	return options.exact === true || value === "1" || value === "true";
+}
+/**
 * Creates a command context from CLI options.
 */
 function createContext(options = {}) {
 	const rawFormat = options.format ?? options.f ?? "human";
+	const formatter = new OutputFormatter(isOutputFormat(rawFormat) ? rawFormat : "human", options["no-color"] === true);
+	const exactMatch = isExactMatch(options);
 	return {
-		formatter: new OutputFormatter(isOutputFormat(rawFormat) ? rawFormat : "human", options["no-color"] === true),
+		formatter,
 		options,
 		createExecutorContext(token) {
 			return {
 				client: new HttpClient({ token }),
-				organizationSlug: typeof options.org === "string" && options.org || getOrganizationSlug(createConfigStore$1()) || void 0
+				organizationSlug: typeof options.org === "string" && options.org || getOrganizationSlug(createConfigStore$1()) || void 0,
+				exactMatch
 			};
 		},
 		getToken() {
@@ -364,7 +375,8 @@ function createTestContext(overrides) {
 			if (!overrides.mockClient) throw new Error("createTestContext: provide mockClient to use createExecutorContext in tests");
 			return {
 				client: overrides.mockClient,
-				organizationSlug: "test-org"
+				organizationSlug: "test-org",
+				exactMatch: isExactMatch(opts, {})
 			};
 		},
 		getToken() {
@@ -440,4 +452,4 @@ function exitWithValidationError(field, usage, formatter) {
 //#endregion
 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-Adi84RcF.js.map
+//# sourceMappingURL=error-handler-s-BOJ1-h.js.map