@intentius/sql-yodeler 0.1.0 → 0.3.0

package/dist/config/define.d.ts

@@ -10,12 +10,16 @@
  * export default defineConfig({
  *   environments: {
  *     dev: { topology: "single" },
- *     prod: { topology: "cluster:main", history: { database: "yodeler" }, lockTtl: 1800 },
+ *     prod: { topology: "cluster:main", history: { database: "yodeler" }, lockTtl: 1800, lockWait: 600 },
  *   },
  * });
  * ```
  */
 import type { Topology } from "@intentius/chant-lexicon-sql/clickhouse/topology";
+import type { LevelSetting, LintRuleId } from "../lint/rules.js";
+import type { DdlSource } from "../sources/index.js";
+import type { NotifyConfig } from "../notify/index.js";
+export type { NotifyConfig };
 export type { Topology };
 /**
  * A ClickHouse topology in its string form (`single`, `cluster:<name>`,
@@ -39,12 +43,228 @@ export interface EnvironmentConfig {
     };
     /** The apply lock's TTL, in seconds. Default: `YODEL_LOCK_TTL`, then 900. */
     lockTtl?: number;
+    /**
+     * How long, in seconds, an apply waits for the lock another apply holds
+     * before it gives up (exit 5). `yodel apply --lock-wait` overrides it.
+     * Default: `YODEL_LOCK_WAIT`, then 0 (give up at once).
+     */
+    lockWait?: number;
+    /**
+     * A tenant set (#56): the environment is many targets with one schema,
+     * each a ClickHouse database or a Postgres schema of the profile's server.
+     * The profile names one database (ClickHouse `databases`) or schema
+     * (Postgres `schemas`), the template the migrations are written against;
+     * each tenant gets them with that name replaced by its own. A tenant is
+     * named `<env>/<tenant>` (`yodel apply prod/acme`), keeps a history of its
+     * own (`<history database>_<tenant>`), and its wave applies to every
+     * tenant behind one gate. See {@link TenantSet}.
+     */
+    tenants?: TenantSet;
+}
+/**
+ * The tenants of an environment: a list of names, a file of them (one per
+ * line, or a JSON array), or a read-only SQL query whose first column lists
+ * them, run on the environment's server with its profile (its reader
+ * outside an apply job).
+ *
+ * ```ts
+ * tenants: ["acme", "globex"]
+ * tenants: { file: "tenants.txt" }
+ * tenants: { query: "SELECT nspname FROM pg_namespace WHERE nspname LIKE 'tenant_%'" }
+ * ```
+ */
+export type TenantSet = string[] | {
+    file: string;
+} | {
+    query: string;
+};
+/** When an environment's wave waits for an approval (chant's wave gate policy). */
+export type WaveGate = "always" | "on-destructive" | "never";
+export declare const WAVE_GATES: readonly WaveGate[];
+/**
+ * One wave of the apply pipeline: an environment, applied after the waves
+ * before it, behind its own gate.
+ */
+export interface WaveConfig {
+    /** The environment, by its name in `sql.profiles`. */
+    env: string;
+    /**
+     * When the wave waits for an approval of its plan:
+     *
+     * - `always` (the default): whenever it has a migration to apply;
+     * - `on-destructive`: when a pending step is destructive, a Postgres
+     *   rewrite or lock-heavy statement, a ClickHouse mutation or rebuild, or
+     *   an Op or manual step;
+     * - `never`: never. Review and branch protection are all that stand in
+     *   front of it.
+     *
+     * The pipeline reads it from the commit a change merges onto, never from
+     * the change itself.
+     */
+    gate?: WaveGate;
+    /**
+     * The environment that must have applied a migration first: `yodel
+     * apply <env>` reads its history (with its reader) and refuses, exit 4,
+     * any pending migration it does not record as applied with the same
+     * checksum. Default: the wave before this one; `false` for none. Both
+     * the working tree's and the base commit's requirement are enforced, so a
+     * change cannot drop its own.
+     */
+    requires?: string | false;
+    /**
+     * A tenant set's wave (#56): split it into a deciding job, which plans
+     * every tenant and decides the gate once over all of them, and this many
+     * share jobs, each applying a slice of the tenants. A share job refuses
+     * (exit 4), naming it, a tenant whose plan moved since the decision, and
+     * applies the rest. Default 1: one job plans, decides and applies.
+     */
+    shares?: number;
+}
+/** A forge `yodel ci` renders pipelines for. */
+export type CiForge = "github" | "gitlab" | "forgejo";
+export declare const CI_FORGES: readonly CiForge[];
+/** `yodel ci` (#65): what the project's pipelines are rendered for. */
+export interface CiConfig {
+    /** The forges to render for. Default: all three. A forge left out gets no files, and `yodel ci --check` does not read its old ones. */
+    forges?: CiForge[];
+    /**
+     * The project's own jobs: a module, relative to the project (such as
+     * `ci/jobs.ts`), exporting `actions` (jobs declared with the github
+     * lexicon, for GitHub and Forgejo) and `gitlab` (the gitlab lexicon's),
+     * each keyed by the job's name. `yodel ci` adds them to the pull request
+     * pipeline after yodel's own jobs, so they survive every render.
+     */
+    jobs?: string;
+    /**
+     * The image every job runs in (#66): the CI image
+     * `ghcr.io/intentius/sql-yodeler:<version>@sha256:<digest>`, pinned by its
+     * digest, which carries node, yodel, chant and the lexicons. Jobs then run
+     * no `npm ci`. Default: `node:22-bookworm`, and each job runs `npm ci`.
+     */
+    image?: string;
 }
 export interface YodelConfig {
     /** Keyed by the environment's name in `sql.profiles`. */
     environments?: Record<string, EnvironmentConfig>;
-    /** Reserved for `yodel lint`'s rule levels. */
-    lint?: Record<string, unknown>;
+    /**
+     * The apply pipeline's waves, in order. An environment no wave names
+     * waits for an approval whenever it has a migration to apply, as under
+     * gate `always`.
+     */
+    waves?: WaveConfig[];
+    /** `yodel lint`'s rule levels: `{ rules: { destructive: "warning" } }`. A misspelled rule name is a type error. */
+    lint?: LintConfig;
+    /** Rules over the plan (#53) that `yodel plan` reports and `yodel apply` enforces; see {@link PolicyConfig}. */
+    policy?: PolicyConfig;
+    /**
+     * Webhook events (#61): the NAMES of the environment variables holding a
+     * webhook's URL and signing key, and optionally a Slack incoming webhook's
+     * URL. `{ webhook: "YODEL_WEBHOOK_URL", key: "YODEL_WEBHOOK_KEY" }`.
+     */
+    notify?: NotifyConfig;
+    /**
+     * DDL sources (#67): schema an ORM defines, read from the DDL it prints,
+     * keyed by a name. Each is written out as declarations in
+     * `<sourceDir>/<name>.generated.ts` before every build. See
+     * {@link DdlSource}.
+     */
+    sources?: Record<string, DdlSource>;
+    /** `yodel ci`: the forges to render the pipelines for, and the project's own jobs; see {@link CiConfig}. */
+    ci?: CiConfig;
+}
+/**
+ * Rules over the versioned plan (#53). `yodel plan` shows each rule's
+ * outcome, and `yodel apply` refuses (exit 4) a plan a rule denies, unless
+ * someone {@link PolicyConfig.overriders} lists recorded an override of that
+ * rule for exactly that plan digest (`yodel override <env> --rule <id>
+ * --reason <text>`).
+ *
+ * ```ts
+ * policy: {
+ *   overriders: ["alice", "bob"],
+ *   rules: [
+ *     { id: "no-drops-in-prod", environments: ["prod"], refuse: { classes: ["drop"], destructive: true } },
+ *     { id: "silences-cite-a-ticket", silences: { reason: /\b[A-Z]+-\d+\b/ } },
+ *     { id: "no-rebuilds-in-hours", environments: ["prod"], check: (plan) => {
+ *         const hour = new Date(plan.now).getUTCHours();
+ *         const rebuilds = plan.pending.flatMap((m) => m.steps.filter((s) => s.classes.includes("rebuild")));
+ *         return hour >= 8 && hour < 18 && rebuilds.length > 0 ? "a rebuild between 08:00 and 18:00 UTC" : undefined;
+ *       } },
+ *   ],
+ * }
+ * ```
+ */
+export interface PolicyConfig {
+    rules: PolicyRule[];
+    /** Who may override a rule: an override recorded by anyone else does not count. None listed, no override counts. */
+    overriders?: string[];
+}
+/** One rule. It denies the plan when any of `refuse`, `silences` or `check` does. */
+export interface PolicyRule {
+    /** Names it in output, in the refusal and in `yodel override --rule`: lowercase letters, digits, `-` and `_`. */
+    id: string;
+    description?: string;
+    /** The environments it applies to. Default: every one. */
+    environments?: string[];
+    /** Denies a pending step of one of these classes (`drop`, `rebuild`, `rewrite`, ...), or a destructive one when `destructive` is true. */
+    refuse?: {
+        classes?: string[];
+        destructive?: boolean;
+    };
+    /** Denies a `-- yodel:allow` silence (of one of `rules`, default any) whose reason does not match `reason`. */
+    silences?: {
+        rules?: string[];
+        reason: RegExp;
+    };
+    /** A predicate over the plan: a message (or several) or `false` denies it; `undefined`, `true` or `[]` allows it. */
+    check?: (plan: PolicyPlan) => string | string[] | boolean | undefined;
+}
+/** What a policy rule sees: the plan `yodel apply` would run. Plain JSON. */
+export interface PolicyPlan {
+    environment: string;
+    dialect: "clickhouse" | "postgres";
+    /** When the plan is evaluated, ISO 8601 in UTC. */
+    now: string;
+    /** The migrations the run would apply, in order. For a revert, the one migration reverted, its steps the revert's statements. */
+    pending: PolicyMigration[];
+    /** Present when the plan is a revert (`yodel revert`): the migration undone and the one it goes back to (null: an empty schema). */
+    revert?: {
+        id: string;
+        to: string | null;
+    };
+}
+export interface PolicyMigration {
+    id: string;
+    checksum: string;
+    outOfOrder: boolean;
+    steps: PolicyStep[];
+    /** Its `-- yodel:allow` silences. */
+    silences: Array<{
+        step: number;
+        rule: string;
+        reason: string;
+    }>;
+}
+export interface PolicyStep {
+    index: number;
+    kind: "statement" | "op" | "manual";
+    object: string;
+    name: string;
+    /** A statement's class, or every class an Op or manual step's changes have. */
+    classes: string[];
+    destructive: boolean;
+    /** The rules that classified it. */
+    rules: string[];
+    /** A statement's SQL. */
+    sql?: string;
+    /** An Op step's Op. */
+    op?: string;
+}
+/** The rules `lint.rules` can set: every lint rule, and the replay check's. */
+export type LintRuleName = LintRuleId | "replay";
+export interface LintConfig {
+    /** Each rule's level. The integrity rules (fork, directory, checksum, unreadable-object) are always errors. */
+    rules?: Partial<Record<LintRuleName, LevelSetting>>;
 }
 /** Returns `config` as is; it types the default export of `yodel.config.ts`. */
 export declare const defineConfig: (config: YodelConfig) => YodelConfig;

package/dist/config/define.js

@@ -10,11 +10,13 @@
  * export default defineConfig({
  *   environments: {
  *     dev: { topology: "single" },
- *     prod: { topology: "cluster:main", history: { database: "yodeler" }, lockTtl: 1800 },
+ *     prod: { topology: "cluster:main", history: { database: "yodeler" }, lockTtl: 1800, lockWait: 600 },
  *   },
  * });
  * ```
  */
+export const WAVE_GATES = ["always", "on-destructive", "never"];
+export const CI_FORGES = ["github", "gitlab", "forgejo"];
 /** Returns `config` as is; it types the default export of `yodel.config.ts`. */
 export const defineConfig = (config) => config;
 //# sourceMappingURL=define.js.map

package/dist/config/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/config/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsCH,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAe,EAAE,CAAC,MAAM,CAAC"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/config/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAwEH,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AA6CrF,MAAM,CAAC,MAAM,SAAS,GAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AA6I7E,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAe,EAAE,CAAC,MAAM,CAAC"}

package/dist/config/index.d.ts

@@ -5,7 +5,9 @@
  *   defineConfig({ environments: { <env>: { topology, history, lockTtl } } })
  *   loadYodelConfig(dir, profiles)          the file, checked; undefined when there is none
  *   environmentSettings(project, env)       topology, history database, lock TTL, with their fallbacks
+ *   loadYodelConfigAtBase(dir)              the file as the base commit has it (./base.ts)
  */
+export * from "./base.js";
 export * from "./define.js";
 export * from "./load.js";
 export * from "./settings.js";

package/dist/config/index.js

@@ -5,7 +5,9 @@
  *   defineConfig({ environments: { <env>: { topology, history, lockTtl } } })
  *   loadYodelConfig(dir, profiles)          the file, checked; undefined when there is none
  *   environmentSettings(project, env)       topology, history database, lock TTL, with their fallbacks
+ *   loadYodelConfigAtBase(dir)              the file as the base commit has it (./base.ts)
  */
+export * from "./base.js";
 export * from "./define.js";
 export * from "./load.js";
 export * from "./settings.js";

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/config/load.d.ts

@@ -2,7 +2,7 @@
  * Finding, loading and checking `yodel.config.ts`. The file is optional; a
  * project without one gets `undefined` and every setting's default.
  */
-import type { YodelConfig } from "./define.js";
+import { type YodelConfig } from "./define.js";
 export declare const CONFIG_FILE = "yodel.config.ts";
 /**
  * Checks a loaded config's shape. `environments` names each environment by

package/dist/config/load.js

@@ -7,6 +7,10 @@ import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { parseTopology } from "@intentius/chant-lexicon-sql/clickhouse/topology";
 import { YodelError } from "../project.js";
+import { CI_FORGES, WAVE_GATES } from "./define.js";
+import { notifyConfigProblem } from "../notify/index.js";
+import { checkSources } from "../sources/index.js";
+import { TENANT_NAME } from "../tenants/target.js";
 export const CONFIG_FILE = "yodel.config.ts";
 const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 const TOPOLOGY_KINDS = ["single", "cluster", "replicated", "cloud"];
@@ -39,9 +43,11 @@ function checkEnvironment(value, where) {
     if (!isRecord(value))
         throw new YodelError(`${where}: expected an object`);
     for (const k of Object.keys(value)) {
-        if (!["topology", "history", "lockTtl"].includes(k))
-            throw new YodelError(`${where}.${k}: unknown setting (expected topology, history, lockTtl)`);
+        if (!["topology", "history", "lockTtl", "lockWait", "tenants"].includes(k))
+            throw new YodelError(`${where}.${k}: unknown setting (expected topology, history, lockTtl, lockWait, tenants)`);
     }
+    if (value.tenants !== undefined)
+        checkTenants(value.tenants, `${where}.tenants`);
     if (value.topology !== undefined)
         checkTopology(value.topology, `${where}.topology`);
     if (value.history !== undefined) {
@@ -57,8 +63,134 @@ function checkEnvironment(value, where) {
     if (value.lockTtl !== undefined && !(typeof value.lockTtl === "number" && Number.isFinite(value.lockTtl) && value.lockTtl > 0)) {
         throw new YodelError(`${where}.lockTtl: expected a number of seconds greater than 0`);
     }
+    if (value.lockWait !== undefined && !(typeof value.lockWait === "number" && Number.isFinite(value.lockWait) && value.lockWait >= 0)) {
+        throw new YodelError(`${where}.lockWait: expected a number of seconds, 0 or more`);
+    }
     return value;
 }
+function checkTenants(value, where) {
+    if (Array.isArray(value)) {
+        const bad = value.filter((t) => typeof t !== "string" || !TENANT_NAME.test(t));
+        if (bad.length > 0)
+            throw new YodelError(`${where}: ${bad.map((b) => JSON.stringify(b)).join(", ")} ${bad.length === 1 ? "is not a tenant name" : "are not tenant names"} (letters, digits and _, not starting with a digit)`);
+        if (new Set(value).size !== value.length)
+            throw new YodelError(`${where}: a tenant is listed twice`);
+        return;
+    }
+    const keys = isRecord(value) ? Object.keys(value) : [];
+    if (!isRecord(value) || keys.length !== 1 || !["file", "query"].includes(keys[0] ?? "") || typeof value[keys[0] ?? ""] !== "string" || value[keys[0] ?? ""] === "") {
+        throw new YodelError(`${where}: expected a list of tenant names, { file: "<path>" } or { query: "<SQL>" }`);
+    }
+}
+const RULE_ID = /^[a-z0-9][a-z0-9_-]*$/;
+function checkPolicy(value, where, profiles) {
+    if (!isRecord(value))
+        throw new YodelError(`${where}: expected { rules: [...], overriders?: [...] }`);
+    for (const k of Object.keys(value))
+        if (k !== "rules" && k !== "overriders")
+            throw new YodelError(`${where}.${k}: unknown setting (expected rules, overriders)`);
+    if (value.overriders !== undefined && !(Array.isArray(value.overriders) && value.overriders.every((o) => typeof o === "string" && o !== ""))) {
+        throw new YodelError(`${where}.overriders: expected a list of names`);
+    }
+    if (!Array.isArray(value.rules))
+        throw new YodelError(`${where}.rules: expected a list of rules`);
+    const seen = new Set();
+    for (const [i, rule] of value.rules.entries()) {
+        const at = `${where}.rules[${String(i)}]`;
+        if (!isRecord(rule))
+            throw new YodelError(`${at}: expected an object`);
+        for (const k of Object.keys(rule)) {
+            if (!["id", "description", "environments", "refuse", "silences", "check"].includes(k))
+                throw new YodelError(`${at}.${k}: unknown setting (expected id, description, environments, refuse, silences, check)`);
+        }
+        if (typeof rule.id !== "string" || !RULE_ID.test(rule.id))
+            throw new YodelError(`${at}.id: lowercase letters, digits, - and _, got ${JSON.stringify(rule.id)}`);
+        if (seen.has(rule.id))
+            throw new YodelError(`${at}.id: two rules are named ${rule.id}`);
+        seen.add(rule.id);
+        if (rule.environments !== undefined) {
+            if (!Array.isArray(rule.environments) || !rule.environments.every((e) => typeof e === "string"))
+                throw new YodelError(`${at}.environments: expected a list of environment names`);
+            const unknown = profiles ? rule.environments.filter((e) => !profiles.includes(e)) : [];
+            if (unknown.length > 0)
+                throw new YodelError(`${at}.environments: ${unknown.join(", ")} ${unknown.length === 1 ? "is not an environment" : "are not environments"} chant.config.ts declares`);
+        }
+        if (rule.refuse === undefined && rule.silences === undefined && rule.check === undefined)
+            throw new YodelError(`${at}: a rule needs refuse, silences or check`);
+        if (rule.refuse !== undefined) {
+            const r = rule.refuse;
+            if (!isRecord(r) || Object.keys(r).some((k) => k !== "classes" && k !== "destructive"))
+                throw new YodelError(`${at}.refuse: expected { classes?: [...], destructive?: true }`);
+            if (r.classes !== undefined && !(Array.isArray(r.classes) && r.classes.every((c) => typeof c === "string")))
+                throw new YodelError(`${at}.refuse.classes: expected a list of classes`);
+            if (r.destructive !== undefined && typeof r.destructive !== "boolean")
+                throw new YodelError(`${at}.refuse.destructive: expected true or false`);
+        }
+        if (rule.silences !== undefined) {
+            const s = rule.silences;
+            if (!isRecord(s) || !(s.reason instanceof RegExp) || Object.keys(s).some((k) => k !== "rules" && k !== "reason"))
+                throw new YodelError(`${at}.silences: expected { reason: /pattern/, rules?: [...] }`);
+            if (s.rules !== undefined && !(Array.isArray(s.rules) && s.rules.every((x) => typeof x === "string")))
+                throw new YodelError(`${at}.silences.rules: expected a list of lint rules`);
+        }
+        if (rule.check !== undefined && typeof rule.check !== "function")
+            throw new YodelError(`${at}.check: expected a function of the plan`);
+    }
+}
+const notDeclared = (profiles) => (profiles.length > 0 ? ` (sql.profiles: ${profiles.join(", ")})` : " (it declares no sql.profiles)");
+function checkWaves(value, where, profiles) {
+    if (!Array.isArray(value))
+        throw new YodelError(`${where}: expected a list of { env, gate }, in the order they apply`);
+    const seen = new Set();
+    value.forEach((wave, i) => {
+        const at = `${where}[${String(i)}]`;
+        if (!isRecord(wave))
+            throw new YodelError(`${at}: expected { env, gate }`);
+        for (const k of Object.keys(wave))
+            if (!["env", "gate", "requires", "shares"].includes(k))
+                throw new YodelError(`${at}.${k}: unknown setting (expected env, gate, requires, shares)`);
+        if (wave.shares !== undefined && !(typeof wave.shares === "number" && Number.isInteger(wave.shares) && wave.shares >= 1))
+            throw new YodelError(`${at}.shares: expected a whole number from 1`);
+        const env = wave.env;
+        if (typeof env !== "string" || env === "")
+            throw new YodelError(`${at}.env: expected an environment's name`);
+        if (profiles && !profiles.includes(env))
+            throw new YodelError(`${at}.env: ${env} is not an environment chant.config.ts declares${notDeclared(profiles)}`);
+        if (seen.has(env))
+            throw new YodelError(`${at}.env: ${env} has a wave already; an environment is one wave`);
+        seen.add(env);
+        if (wave.gate !== undefined && !WAVE_GATES.includes(wave.gate)) {
+            throw new YodelError(`${at}.gate: ${JSON.stringify(wave.gate)} is not a gate policy (expected ${WAVE_GATES.join(", ")})`);
+        }
+        const req = wave.requires;
+        if (req !== undefined && req !== false) {
+            if (typeof req !== "string" || req === "")
+                throw new YodelError(`${at}.requires: expected an environment's name, or false`);
+            if (req === env)
+                throw new YodelError(`${at}.requires: ${env} cannot require itself`);
+            if (profiles && !profiles.includes(req))
+                throw new YodelError(`${at}.requires: ${req} is not an environment chant.config.ts declares${notDeclared(profiles)}`);
+        }
+    });
+}
+/** An image reference pinned by digest. */
+const CI_IMAGE = /^[^\s@]+@sha256:[0-9a-f]{64}$/;
+function checkCi(value, where) {
+    if (!isRecord(value))
+        throw new YodelError(`${where}: expected { forges?, jobs?, image? }`);
+    for (const k of Object.keys(value))
+        if (!["forges", "jobs", "image"].includes(k))
+            throw new YodelError(`${where}.${k}: unknown setting (expected forges, jobs, image)`);
+    if (value.image !== undefined && (typeof value.image !== "string" || !CI_IMAGE.test(value.image))) {
+        throw new YodelError(`${where}.image: the CI image pinned by its digest, ghcr.io/intentius/sql-yodeler:<version>@sha256:<digest> (the release's image job writes the digest to its summary)`);
+    }
+    const forges = value.forges;
+    if (forges !== undefined && !(Array.isArray(forges) && forges.length > 0 && forges.every((f) => CI_FORGES.includes(f)))) {
+        throw new YodelError(`${where}.forges: a list of ${CI_FORGES.join(", ")}`);
+    }
+    if (value.jobs !== undefined && (typeof value.jobs !== "string" || value.jobs === ""))
+        throw new YodelError(`${where}.jobs: the path of the module that declares the project's own jobs, such as "ci/jobs.ts"`);
+}
 /**
  * Checks a loaded config's shape. `environments` names each environment by
  * its `sql.profiles` name; one that chant.config.ts does not declare is an
@@ -68,9 +200,22 @@ export function checkYodelConfig(value, path, profiles) {
     if (!isRecord(value))
         throw new YodelError(`${path}: the default export must be a config object (export default defineConfig({ ... }))`);
     for (const k of Object.keys(value)) {
-        if (k !== "environments" && k !== "lint")
-            throw new YodelError(`${path}: unknown setting ${k} (expected environments, lint)`);
+        if (!["environments", "lint", "policy", "notify", "sources", "waves", "ci"].includes(k))
+            throw new YodelError(`${path}: unknown setting ${k} (expected environments, lint, policy, notify, sources, waves, ci)`);
+    }
+    if (value.ci !== undefined)
+        checkCi(value.ci, `${path}: ci`);
+    if (value.sources !== undefined)
+        checkSources(value.sources, `${path}: sources`);
+    if (value.notify !== undefined) {
+        const problem = notifyConfigProblem(value.notify);
+        if (problem)
+            throw new YodelError(`${path}: ${problem}`);
     }
+    if (value.policy !== undefined)
+        checkPolicy(value.policy, `${path}: policy`, profiles);
+    if (value.waves !== undefined)
+        checkWaves(value.waves, `${path}: waves`, profiles);
     if (value.lint !== undefined && !isRecord(value.lint))
         throw new YodelError(`${path}: lint: expected an object`);
     if (value.environments !== undefined) {
@@ -79,7 +224,7 @@ export function checkYodelConfig(value, path, profiles) {
         for (const [name, env] of Object.entries(value.environments)) {
             checkEnvironment(env, `${path}: environments.${name}`);
             if (profiles && !profiles.includes(name)) {
-                throw new YodelError(`${path}: environments.${name} is not an environment chant.config.ts declares` + (profiles.length > 0 ? ` (sql.profiles: ${profiles.join(", ")})` : " (it declares no sql.profiles)"));
+                throw new YodelError(`${path}: environments.${name} is not an environment chant.config.ts declares${notDeclared(profiles)}`);
             }
         }
     }

package/dist/config/load.js.map

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"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"}

package/dist/config/settings.d.ts

@@ -7,6 +7,12 @@
  * | topology         | `environments.<env>.topology`          | `sql.profiles.<env>.topology`     | `YODEL_TOPOLOGY`        | `single` |
  * | history database | `environments.<env>.history.database`  |                                   | `YODEL_HISTORY_DATABASE`| `yodeler`|
  * | lock TTL         | `environments.<env>.lockTtl` (seconds) |                                   | `YODEL_LOCK_TTL`        | 900      |
+ * | lock wait        | `environments.<env>.lockWait` (seconds)|                                   | `YODEL_LOCK_WAIT`       | 0        |
+ *
+ * `yodel apply --lock-wait <duration>` sets the lock wait over all three.
+ *
+ * A tenant (`<env>/<tenant>`, #56) has its environment's settings, its
+ * history database suffixed with `_<tenant>`.
  */
 import { type Topology } from "@intentius/chant-lexicon-sql/clickhouse/topology";
 import type { HistoryTopology } from "../history/topology.js";
@@ -24,17 +30,27 @@ export interface EnvironmentSettings {
     historyTopology: HistoryTopology;
     historyDatabase: string;
     lockTtlMs: number;
+    /** How long an apply waits for a lock another apply holds; 0 gives up at once (exit 5). */
+    lockWaitMs: number;
 }
+/** The variable that sets the lock wait (a duration, as {@link parseDuration} reads it). */
+export declare const LOCK_WAIT_ENV = "YODEL_LOCK_WAIT";
+/**
+ * A duration in milliseconds: `90` (seconds), `500ms`, `30s`, `10m`, `1h`,
+ * or a sum of them (`1m30s`). `what` names it in the error.
+ */
+export declare function parseDuration(text: string, what: string): number;
 /** The topology the history's DDL is written for. */
 export declare function historyTopologyOf(t: Topology): HistoryTopology;
 /** The settings of environment `name`; see the module comment for the order. */
-export declare function environmentSettings(project: Pick<Project, "config" | "yodel">, name: string, env?: NodeJS.ProcessEnv): EnvironmentSettings;
+export declare function environmentSettings(project: Pick<Project, "config" | "yodel">, target: string, env?: NodeJS.ProcessEnv): EnvironmentSettings;
 /** `cluster:main (yodel.config.ts)`, for a report's header. */
 export declare const describeSettingsTopology: (s: Pick<EnvironmentSettings, "topology" | "topologySource">) => string;
 /**
  * The declarative path (`yodel plan`, `yodel apply` without migrations) runs
  * chant's planner and applier, which render for `sql.profiles.<env>.topology`
  * and do not read `yodel.config.ts`. A topology set only in yodel.config.ts
- * would be ignored there, so it is refused unless chant's profile says the same.
+ * would be ignored there, so it is refused unless chant's profile says the same
+ * (an unset profile topology is a single node, as chant renders it).
  */
 export declare function declarativeTopologyRefusal(project: Pick<Project, "config" | "yodel">, name: string): YodelError | undefined;