@intentius/chant-lexicon-grafana 0.97.0 → 0.99.0

package/dist/validate-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-output.d.ts","sourceRoot":"","sources":["../src/validate-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAOrD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AA2CD,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzD;AAoCD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA0DvE;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAkClE;AAaD,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAyBnE;AAsBD,wBAAgB,SAAS,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAiC7D;AAID,wBAAgB,aAAa,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA2BjE;AAID,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAa/D;AAYD,kCAAkC;AAClC,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAErF;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAEzE"}
+{"version":3,"file":"validate-output.d.ts","sourceRoot":"","sources":["../src/validate-output.ts"],"names":[],"mappings":"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"}

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AASvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEvF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,UAsB1B,CAAC;AAIF,wBAAsB,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CA2DxD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AASvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEvF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,UAoC1B,CAAC;AAIF,wBAAsB,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CA2DxD"}

package/dist/variables.d.ts

@@ -9,7 +9,7 @@
  * or query, and the reference becomes `${name}`.
  */
 import type { Declarable } from "@intentius/chant/declarable";
-import type { DatasourceEntity, DatasourceRef } from "./datasource.js";
+import type { DatasourceEntity, DatasourceRef, ExternalDatasourceEntity } from "./datasource.js";
 import type { VariableOption } from "./schema/dashboard.gen.js";
 export type VariableKind = "query" | "custom" | "interval" | "datasource" | "constant" | "textbox";
 /** Where the variable shows: with its label, without it, or not at all. */
@@ -32,7 +32,7 @@ interface MultiValueProps {
     allValue?: string;
 }
 /** A variable anything can hold before its datasource is known: its own datasource ref or a datasource variable. */
-export type VariableDatasource = DatasourceEntity<any> | DatasourceRef | DatasourceVariableEntity<any>;
+export type VariableDatasource = DatasourceEntity<any> | ExternalDatasourceEntity<any> | DatasourceRef | DatasourceVariableEntity<any>;
 export interface QueryVariableProps extends CommonVariableProps, MultiValueProps {
     datasource: VariableDatasource;
     /** The datasource's variable query, e.g. `label_values(up, job)` for Prometheus. */
@@ -44,6 +44,11 @@ export interface QueryVariableProps extends CommonVariableProps, MultiValueProps
     sort?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
 }
 export interface CustomVariableProps extends CommonVariableProps, MultiValueProps {
+    /**
+     * The values, in Grafana's syntax: `"Production : prod"` shows
+     * `Production` and sets `prod`. A comma is part of the value (written as
+     * `\,`, and one already escaped is kept).
+     */
     values: string[];
 }
 export interface IntervalVariableProps extends CommonVariableProps {

package/dist/variables.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-grafana",
-  "version": "0.97.0",
+  "version": "0.99.0",
   "description": "Grafana lexicon for chant — typed dashboards, panels, queries and datasources, serialized to dashboard JSON and Grafana provisioning files",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -43,6 +43,11 @@
       "types": "./dist/*.d.ts",
       "default": "./src/*.ts"
     },
+    "./op/activities": {
+      "development": "./src/op/activities/index.ts",
+      "types": "./dist/op/activities/index.d.ts",
+      "default": "./src/op/activities/index.ts"
+    },
     "./lint/post-synth": {
       "development": "./src/lint/post-synth/index.ts",
       "types": "./dist/lint/post-synth/index.d.ts",
@@ -61,6 +66,7 @@
     "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && find dist -type f \\( -name \"*.js\" -o -name \"*.js.map\" \\) -delete"
   },
   "dependencies": {
+    "@intentius/chant-lexicon-k8s": "*",
     "@intentius/chant-lexicon-otel": "*",
     "@intentius/chant-lexicon-prometheus": "*",
     "ajv": "^8.20.0",
@@ -70,10 +76,12 @@
     "@intentius/chant": "*",
     "@types/js-yaml": "^4.0.9",
     "tsc-alias": "^1.8.17",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.97.0",
-    "typescript": "^5.9.3"
+    "@intentius/chant": "^0.99.0",
+    "typescript": "^5.9.3",
+    "zod": "^4.3.6"
   }
 }

package/src/actions/actions.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, test } from "vitest";
+import { GrafanaActions, grafanaActionsFor } from "./grafana";
+
+describe("GrafanaActions", () => {
+  test("every action is a Grafana RBAC action name (<resource>:<verb>), with no duplicate in a group", () => {
+    for (const actions of Object.values(GrafanaActions)) {
+      for (const a of actions) expect(a).toMatch(/^[a-z]+(\.[a-z]+)*:[a-z]+$/);
+      expect(new Set(actions).size).toBe(actions.length);
+    }
+  });
+
+  test("apply and prune together cover every call the applier makes", () => {
+    expect(grafanaActionsFor("Apply", "Prune")).toEqual(
+      expect.arrayContaining(["dashboards:create", "dashboards:write", "dashboards:delete", "folders:create", "folders:delete", "library.panels:create", "library.panels:write"]),
+    );
+    expect(grafanaActionsFor("Prune")).not.toContain("library.panels:delete");
+  });
+
+  test("levels are merged without duplicates", () => {
+    const merged = grafanaActionsFor("Observe", "Apply");
+    expect(new Set(merged).size).toBe(merged.length);
+    expect(merged[0]).toBe("dashboards:read");
+  });
+});

package/src/actions/grafana.ts

@@ -0,0 +1,40 @@
+/**
+ * The Grafana RBAC actions chant's live paths call, for a custom role on the
+ * service account whose token a `grafana.profiles.<env>` entry names. The
+ * basic Editor role covers all of them; these are for a narrower role.
+ *
+ * - `Observe`: `chant lifecycle diff --live` and `chant import --from`
+ *   (#2946), which read dashboards, folders and datasources.
+ * - `Apply`: the API applier (#2948), which also reads what it writes to
+ *   compare, and writes folders, library panels and dashboards.
+ * - `Prune`: the applier with `prune`, which deletes dashboards and folders
+ *   (never library panels or datasources).
+ *
+ * Grant them on `folders:*` and `dashboards:*` scopes, or on the folders
+ * chant writes to.
+ */
+export const GrafanaActions = {
+  Observe: ["dashboards:read", "folders:read", "datasources:read"],
+  Apply: [
+    "dashboards:read",
+    "dashboards:create",
+    "dashboards:write",
+    "folders:read",
+    "folders:create",
+    "folders:write",
+    "library.panels:read",
+    "library.panels:create",
+    "library.panels:write",
+  ],
+  Prune: ["dashboards:read", "dashboards:delete", "folders:read", "folders:delete"],
+} as const;
+
+export type GrafanaAccessLevel = keyof typeof GrafanaActions;
+
+// A Map-backed lookup, so evaluable code avoids computed element access (EVL003).
+const GRAFANA_ACTIONS = new Map<GrafanaAccessLevel, readonly string[]>(Object.entries(GrafanaActions) as [GrafanaAccessLevel, readonly string[]][]);
+
+/** The actions for one or more access levels, deduplicated, in first-seen order. */
+export function grafanaActionsFor(...levels: GrafanaAccessLevel[]): string[] {
+  return [...new Set(levels.flatMap((l) => GRAFANA_ACTIONS.get(l) ?? []))];
+}

package/src/actions/index.ts

@@ -0,0 +1 @@
+export { GrafanaActions, grafanaActionsFor, type GrafanaAccessLevel } from "./grafana";

package/src/alerting-build.ts

@@ -0,0 +1,376 @@
+/**
+ * From alerting entities to Grafana's alerting provisioning file,
+ * `provisioning/alerting/chant.yaml`.
+ *
+ * The file is what Grafana's file provisioner reads
+ * (`pkg/services/provisioning/alerting`, the same at v12.4.11 and v13.2.2)
+ * and what `GET /api/v1/provisioning/*\/export` writes: `apiVersion: 1`
+ * and the lists `groups`, `contactPoints`, `policies`, `muteTimes` and
+ * `templates`. Mount `provisioning/` at `/etc/grafana/provisioning`, as for
+ * datasources and dashboards.
+ *
+ * Plain functions, so a test or another lexicon can render the same file
+ * with `alertingYaml()` without a build.
+ */
+
+import { dump } from "js-yaml";
+import type { Declarable } from "@intentius/chant/declarable";
+import { durationMs, isValidDuration } from "@intentius/chant-lexicon-prometheus/duration";
+import {
+  EXPRESSION_DATASOURCE_UID,
+  isAlertQueryEntity,
+  isAlertRuleGroupEntity,
+  isContactPointEntity,
+  isExpressionEntity,
+  isMuteTimingEntity,
+  isNotificationPolicyEntity,
+  isNotificationTemplateEntity,
+  type AlertDuration,
+  type AlertRuleData,
+  type AlertRuleEntity,
+  type AlertRuleGroupEntity,
+  type ContactPointEntity,
+  type MuteTimingEntity,
+  type NotificationPolicyEntity,
+  type NotificationTemplateEntity,
+  type PolicyRoute,
+  type RelativeTimeRange,
+} from "./alerting";
+import { isDashboardEntity } from "./dashboard";
+import { isQueryEntity, type QueryEntity } from "./query";
+import { isDatasourceVariable } from "./variables";
+import { compact, slugUid } from "./util";
+// build.ts imports this module too; only functions cross the cycle, and only at call time.
+import { datasourceRef, targetJson } from "./build";
+
+/** Where the alerting provisioning file goes, relative to the build output directory. */
+export const ALERTING_FILE = "provisioning/alerting/chant.yaml";
+
+/** The time range a query reads when neither it nor its rule sets one: the last 10 minutes, Grafana's editor default. */
+export const DEFAULT_RELATIVE_TIME_RANGE = { from: 600, to: 0 } as const;
+
+/** A rule group's evaluation interval when it sets none. */
+export const DEFAULT_GROUP_INTERVAL = "1m";
+
+type Json = Record<string, unknown>;
+
+/** One entry of a rule's `data` in the file. */
+export interface ProvisionedAlertQuery {
+  refId: string;
+  queryType?: string;
+  relativeTimeRange?: { from: number; to: number };
+  datasourceUid: string;
+  model: Json;
+}
+
+export interface ProvisionedAlertRule {
+  uid: string;
+  title: string;
+  condition?: string;
+  data: ProvisionedAlertQuery[];
+  dashboardUid?: string;
+  panelId?: number;
+  noDataState?: string;
+  execErrState?: string;
+  for?: string;
+  keepFiringFor?: string;
+  missing_series_evals_to_resolve?: number;
+  annotations?: Record<string, string>;
+  labels?: Record<string, string>;
+  isPaused?: boolean;
+  notification_settings?: Json;
+  record?: Json;
+}
+
+export interface ProvisionedRuleGroup {
+  orgId?: number;
+  name: string;
+  folder: string;
+  interval: string;
+  rules: ProvisionedAlertRule[];
+}
+
+export interface ProvisionedContactPoint {
+  orgId?: number;
+  name: string;
+  receivers: Array<{ uid: string; type: string; settings: Json; disableResolveMessage?: boolean }>;
+}
+
+export interface ProvisionedMuteTiming {
+  orgId?: number;
+  name: string;
+  time_intervals: Json[];
+}
+
+export interface ProvisionedTemplate {
+  orgId?: number;
+  name: string;
+  template: string;
+}
+
+/** The alerting provisioning file, parsed. */
+export interface AlertingFile {
+  apiVersion: 1;
+  groups?: ProvisionedRuleGroup[];
+  contactPoints?: ProvisionedContactPoint[];
+  policies?: Json[];
+  muteTimes?: ProvisionedMuteTiming[];
+  templates?: ProvisionedTemplate[];
+}
+
+/** The keys an alerting provisioning file can hold, from `AlertingFileV1`. */
+export const ALERTING_FILE_KEYS = [
+  "apiVersion",
+  "groups",
+  "deleteRules",
+  "contactPoints",
+  "deleteContactPoints",
+  "policies",
+  "resetPolicies",
+  "muteTimes",
+  "deleteMuteTimes",
+  "templates",
+  "deleteTemplates",
+] as const;
+
+// ── Durations ───────────────────────────────────────────────────
+
+/** A duration as whole seconds: a number is taken as seconds, a string as a Prometheus duration. */
+export function durationSeconds(value: AlertDuration, what: string): number {
+  if (typeof value === "number") {
+    if (!Number.isInteger(value) || value < 0) throw new Error(`grafana: ${what} must be a whole number of seconds, got ${value}`);
+    return value;
+  }
+  if (!isValidDuration(value)) throw new Error(`grafana: ${what} "${value}" is not a duration like 10m or 1h`);
+  return Math.floor(durationMs(value)! / 1000);
+}
+
+function timeRange(range: RelativeTimeRange, what: string): { from: number; to: number } {
+  return { from: durationSeconds(range.from, `${what} from`), to: durationSeconds(range.to ?? 0, `${what} to`) };
+}
+
+// ── References ──────────────────────────────────────────────────
+
+function receiverName(receiver: ContactPointEntity | string): string {
+  return typeof receiver === "string" ? receiver : receiver.props.name;
+}
+
+function timingNames(list: Array<MuteTimingEntity | string> | undefined): string[] | undefined {
+  return list?.map((t) => (typeof t === "string" ? t : t.props.name));
+}
+
+// ── Rules ───────────────────────────────────────────────────────
+
+const REF_IDS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+function refIdAt(i: number): string {
+  return i < REF_IDS.length ? REF_IDS[i] : `${REF_IDS[Math.floor(i / REF_IDS.length) - 1]}${REF_IDS[i % REF_IDS.length]}`;
+}
+
+/** The uid a query's datasource resolves to, and its type when known. */
+function datasourceOf(input: unknown, where: string): { uid: string; type?: string } {
+  if (input === undefined || input === null) throw new Error(`grafana: ${where} has no datasource; an alert query must name one`);
+  if (typeof input === "string") return { uid: input };
+  if (isDatasourceVariable(input)) {
+    throw new Error(`grafana: ${where} uses a DatasourceVariable; alert rules are evaluated without dashboard variables, so name the datasource itself`);
+  }
+  const ref = datasourceRef(input as Parameters<typeof datasourceRef>[0])!;
+  return { uid: ref.uid!, ...(ref.type ? { type: ref.type } : {}) };
+}
+
+function typedQueryModel(query: QueryEntity, refId: string, where: string): { uid: string; model: Json } {
+  const ds = datasourceOf((query.props as Json).datasource, where);
+  const model = targetJson(query, 0, ds.type ? { type: ds.type, uid: ds.uid } : undefined);
+  return { uid: ds.uid, model: { ...model, refId } };
+}
+
+/** One entry of `data`, as the file holds it. */
+export function alertQueryJson(item: AlertRuleData, index: number, ruleRange: RelativeTimeRange | undefined, rule: string): ProvisionedAlertQuery {
+  const where = `alert rule "${rule}" data[${index}]`;
+  const fallbackRange = ruleRange ? timeRange(ruleRange, `${where} relativeTimeRange`) : { ...DEFAULT_RELATIVE_TIME_RANGE };
+  if (isExpressionEntity(item)) {
+    const { refId: ownRefId, relativeTimeRange, ...rest } = item.props as Json & { refId?: string; relativeTimeRange?: RelativeTimeRange };
+    const refId = ownRefId ?? refIdAt(index);
+    return compact({
+      refId,
+      relativeTimeRange: relativeTimeRange ? timeRange(relativeTimeRange, `${where} relativeTimeRange`) : undefined,
+      datasourceUid: EXPRESSION_DATASOURCE_UID,
+      model: { datasource: { type: EXPRESSION_DATASOURCE_UID, uid: EXPRESSION_DATASOURCE_UID }, refId, type: item.expressionKind, ...rest },
+    });
+  }
+  if (isAlertQueryEntity(item)) {
+    const p = item.props;
+    const refId = p.refId ?? refIdAt(index);
+    const range = p.relativeTimeRange ? timeRange(p.relativeTimeRange, `${where} relativeTimeRange`) : fallbackRange;
+    let uid: string;
+    let model: Json;
+    if (p.query) {
+      const typed = typedQueryModel(p.query, refId, where);
+      const own = p.datasource !== undefined ? datasourceOf(p.datasource, where) : undefined;
+      uid = own?.uid ?? typed.uid;
+      model = { ...typed.model, ...(p.model ?? {}) };
+    } else {
+      uid = datasourceOf(p.datasource, where).uid;
+      model = p.model ?? {};
+    }
+    return compact({ refId, queryType: p.queryType, relativeTimeRange: range, datasourceUid: uid, model });
+  }
+  if (isQueryEntity(item)) {
+    const refId = ((item.props as Json).refId as string | undefined) ?? refIdAt(index);
+    const typed = typedQueryModel(item, refId, where);
+    return { refId, relativeTimeRange: fallbackRange, datasourceUid: typed.uid, model: typed.model };
+  }
+  throw new Error(`grafana: ${where} must be a query (PromQuery, AlertQuery, ...) or an expression (ReduceExpression, ...)`);
+}
+
+/** One rule as the file holds it. */
+export function alertRuleJson(rule: AlertRuleEntity): ProvisionedAlertRule {
+  const p = rule.props;
+  const data = (p.data ?? []).map((d, i) => alertQueryJson(d, i, p.relativeTimeRange, p.title));
+  const condition = p.condition ?? (p.record ? undefined : data[data.length - 1]?.refId);
+  const dashboardUid = p.dashboardUid === undefined ? undefined : isDashboardEntity(p.dashboardUid) ? (p.dashboardUid.props.uid ?? slugUid(p.dashboardUid.props.title)) : p.dashboardUid;
+  const ns = p.notification_settings;
+  return compact({
+    uid: p.uid ?? slugUid(p.title),
+    title: p.title,
+    condition,
+    data,
+    dashboardUid,
+    panelId: p.panelId,
+    noDataState: p.noDataState,
+    execErrState: p.execErrState,
+    for: p.for,
+    keepFiringFor: p.keepFiringFor,
+    missing_series_evals_to_resolve: p.missing_series_evals_to_resolve,
+    annotations: p.annotations,
+    labels: p.labels,
+    isPaused: p.isPaused,
+    notification_settings: ns
+      ? {
+          receiver: receiverName(ns.receiver),
+          group_by: ns.group_by,
+          group_wait: ns.group_wait,
+          group_interval: ns.group_interval,
+          repeat_interval: ns.repeat_interval,
+          mute_time_intervals: timingNames(ns.mute_time_intervals),
+          active_time_intervals: timingNames(ns.active_time_intervals),
+        }
+      : undefined,
+    record: p.record ? { ...p.record } : undefined,
+  });
+}
+
+/** One rule group as the file holds it. */
+export function ruleGroupJson(group: AlertRuleGroupEntity): ProvisionedRuleGroup {
+  const p = group.props;
+  return compact({
+    orgId: p.orgId,
+    name: p.name,
+    folder: p.folder,
+    interval: p.interval ?? DEFAULT_GROUP_INTERVAL,
+    rules: (p.rules ?? []).map(alertRuleJson),
+  });
+}
+
+// ── Notifications ───────────────────────────────────────────────
+
+/** One contact point as the file holds it. A receiver without a uid gets one from the name and the integration type. */
+export function contactPointJson(cp: ContactPointEntity): ProvisionedContactPoint {
+  const p = cp.props;
+  const taken = new Set<string>();
+  const receivers = (p.receivers ?? []).map((r) => {
+    let uid = r.uid ?? slugUid(`${p.name} ${r.type}`);
+    if (r.uid === undefined) for (let n = 2; taken.has(uid); n++) uid = slugUid(`${p.name} ${r.type} ${n}`);
+    taken.add(uid);
+    return compact({ uid, type: r.type, settings: r.settings ?? {}, disableResolveMessage: r.disableResolveMessage });
+  });
+  return compact({ orgId: p.orgId, name: p.name, receivers });
+}
+
+function routeJson(route: PolicyRoute): Json {
+  return compact({
+    receiver: route.receiver === undefined ? undefined : receiverName(route.receiver),
+    group_by: route.group_by,
+    object_matchers: route.object_matchers?.map((m) => [...m]),
+    matchers: route.matchers,
+    match: route.match,
+    match_re: route.match_re,
+    continue: route.continue,
+    group_wait: route.group_wait,
+    group_interval: route.group_interval,
+    repeat_interval: route.repeat_interval,
+    mute_time_intervals: timingNames(route.mute_time_intervals),
+    active_time_intervals: timingNames(route.active_time_intervals),
+    routes: route.routes?.map(routeJson),
+  });
+}
+
+/** One organisation's policy tree as the file holds it. */
+export function notificationPolicyJson(policy: NotificationPolicyEntity): Json {
+  const p = policy.props;
+  return compact({
+    orgId: p.orgId,
+    receiver: receiverName(p.receiver),
+    group_by: p.group_by,
+    group_wait: p.group_wait,
+    group_interval: p.group_interval,
+    repeat_interval: p.repeat_interval,
+    mute_time_intervals: timingNames(p.mute_time_intervals),
+    active_time_intervals: timingNames(p.active_time_intervals),
+    routes: p.routes?.map(routeJson),
+  });
+}
+
+export function muteTimingJson(t: MuteTimingEntity): ProvisionedMuteTiming {
+  return compact({ orgId: t.props.orgId, name: t.props.name, time_intervals: (t.props.time_intervals ?? []) as unknown as Json[] });
+}
+
+export function notificationTemplateJson(t: NotificationTemplateEntity): ProvisionedTemplate {
+  return compact({ orgId: t.props.orgId, name: t.props.name, template: t.props.template });
+}
+
+// ── The file ────────────────────────────────────────────────────
+
+/** The alerting provisioning file as YAML text. */
+export function alertingYaml(file: AlertingFile): string {
+  return `# Grafana alerting provisioning, generated by chant.\n${dump(file, { lineWidth: -1, noRefs: true, quotingType: '"' })}`;
+}
+
+/** Summary of the alerting a build provisions, for the build index. */
+export interface AlertingIndex {
+  ruleGroups: Array<{ name: string; folder: string; rules: number }>;
+  contactPoints: string[];
+  policies: number;
+  muteTimings: string[];
+  templates: string[];
+}
+
+/** The alerting provisioning file for the alerting entities among these, or undefined when there are none. */
+export function buildAlerting(entities: Iterable<Declarable>): { file: AlertingFile; index: AlertingIndex } | undefined {
+  const all = [...entities];
+  const byName = <T extends { name: string }>(a: T, b: T) => a.name.localeCompare(b.name);
+  const groups = all
+    .filter(isAlertRuleGroupEntity)
+    .map(ruleGroupJson)
+    .sort((a, b) => a.folder.localeCompare(b.folder) || a.name.localeCompare(b.name));
+  const contactPoints = all.filter(isContactPointEntity).map(contactPointJson).sort(byName);
+  const policies = all.filter(isNotificationPolicyEntity).map(notificationPolicyJson);
+  const muteTimes = all.filter(isMuteTimingEntity).map(muteTimingJson).sort(byName);
+  const templates = all.filter(isNotificationTemplateEntity).map(notificationTemplateJson).sort(byName);
+  if (groups.length + contactPoints.length + policies.length + muteTimes.length + templates.length === 0) return undefined;
+  const file: AlertingFile = compact({
+    apiVersion: 1 as const,
+    groups: groups.length > 0 ? groups : undefined,
+    contactPoints: contactPoints.length > 0 ? contactPoints : undefined,
+    policies: policies.length > 0 ? policies : undefined,
+    muteTimes: muteTimes.length > 0 ? muteTimes : undefined,
+    templates: templates.length > 0 ? templates : undefined,
+  });
+  const index: AlertingIndex = {
+    ruleGroups: groups.map((g) => ({ name: g.name, folder: g.folder, rules: g.rules.length })),
+    contactPoints: contactPoints.map((c) => c.name),
+    policies: policies.length,
+    muteTimings: muteTimes.map((m) => m.name),
+    templates: templates.map((t) => t.name),
+  };
+  return { file, index };
+}