@intentius/chant-lexicon-grafana 0.97.0 → 0.99.0

package/dist/panels.d.ts.map

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

package/dist/pin.d.ts

@@ -5,12 +5,19 @@
  * kinds. `grafana/grafana-foundation-sdk` runs them through cog and
  * publishes, beside its builder libraries, one JSON Schema per kind under
  * `jsonschema/`. This lexicon vendors the files it uses into `src/spec/schemas/`
- * (exact bytes, at the commit below) and generates `src/schema/*.gen.ts`
- * from them. Nothing is fetched at build or test time.
+ * (exact bytes, at the commit below), applies the correction overlay in
+ * `src/spec/overlay/` (see `src/spec/overlay.ts`), and generates
+ * `src/schema/*.gen.ts` from the result. Nothing is fetched at build or test
+ * time.
+ *
+ * The types track Grafana 12.4 and 13.x: v0.0.20 is labelled with the
+ * v11.6.x kind registry, but its dashboard schema largely matches those
+ * releases, and the overlay covers the rest.
  *
  * Bumping the pin: change `ref` and `commit`, run `just fetch-schemas`
  * (downloads and prints the new digests), paste the digests here, run
- * `npm run generate`, and review the diff of `src/schema/`.
+ * `npm run generate` (it refuses overlay patches the new schemas already
+ * carry; delete those), and review the diff of `src/schema/`.
  */
 export interface GrafanaSchemaPin {
     /** Where the schema files come from. */
@@ -19,14 +26,29 @@ export interface GrafanaSchemaPin {
     ref: string;
     /** The exact commit the vendored files were taken from. */
     commit: string;
-    /** The Grafana kind registry version cog generated the schemas from. */
+    /**
+     * The kind registry label the SDK publishes the schemas under. It lags the
+     * content: the v0.0.20 schemas are labelled v11.6.x and cover 12.4 and 13.x.
+     */
     kindRegistry: string;
     /** sha256 of each vendored file, keyed by schema name (`src/spec/schemas/<name>.jsonschema.json`). */
-    files: Readonly<Record<SchemaName, string>>;
+    files: Readonly<Record<VendoredSchemaName, string>>;
 }
-export declare const SCHEMA_NAMES: readonly ["dashboard", "timeseries", "stat", "gauge", "table", "logs", "heatmap", "text", "prometheus", "tempo", "loki"];
+export declare const SCHEMA_NAMES: readonly ["dashboard", "timeseries", "stat", "gauge", "table", "logs", "heatmap", "text", "barchart", "bargauge", "piechart", "statetimeline", "statushistory", "histogram", "nodegraph", "xychart", "trend", "canvas", "geomap", "prometheus", "tempo", "loki", "expr"];
 export type SchemaName = (typeof SCHEMA_NAMES)[number];
+/**
+ * Schemas vendored from the same commit for reading, not for types: no
+ * `.gen.ts` is generated from them and GRAF107 does not use them, since chant
+ * builds classic dashboards. `dashboardv2` is the v2 dashboard kind the
+ * importer reads (#2947); `src/import/v2.test.ts` checks the importer knows
+ * every key it defines.
+ */
+export declare const IMPORT_ONLY_SCHEMA_NAMES: readonly ["dashboardv2"];
+export type ImportOnlySchemaName = (typeof IMPORT_ONLY_SCHEMA_NAMES)[number];
+/** Every schema file under `src/spec/schemas/`. */
+export type VendoredSchemaName = SchemaName | ImportOnlySchemaName;
+export declare const VENDORED_SCHEMA_NAMES: readonly VendoredSchemaName[];
 export declare const GRAFANA_SCHEMA_PIN: GrafanaSchemaPin;
 /** The raw URL of one schema file at the pinned commit. */
-export declare function schemaUrl(name: SchemaName, pin?: GrafanaSchemaPin): string;
+export declare function schemaUrl(name: VendoredSchemaName, pin?: GrafanaSchemaPin): string;
 //# sourceMappingURL=pin.d.ts.map

package/dist/pin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../src/pin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,YAAY,0HAYf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,kBAAkB,EAAE,gBAkB/B,CAAC;AAEH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,gBAAqC,GAAG,MAAM,CAE9F"}
+{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../src/pin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,eAAO,MAAM,YAAY,0QAwBf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,0BAA2B,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAEnE,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAAmD,CAAC;AAEnH,eAAO,MAAM,kBAAkB,EAAE,gBA+B/B,CAAC;AAEH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,GAAE,gBAAqC,GAAG,MAAM,CAEtG"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA0B9D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,aAgF3B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAkD9D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,aA0H3B,CAAC"}

package/dist/promql-check.d.ts

@@ -0,0 +1,51 @@
+/**
+ * GRAF108: the PromQL a dashboard sends to Prometheus, syntax-checked with
+ * the prometheus lexicon's `checkPromql` (the grammar behind the Prometheus
+ * web UI's editor, `@prometheus-io/lezer-promql`).
+ *
+ * Only queries that reach a Prometheus datasource are parsed, as
+ * `datasourceUses()` resolves them: a query's own ref, else its panel's, a
+ * datasource variable's plugin type, or an undeclared ref's own `type`. A
+ * query whose datasource can't be told (no ref at all, a `-- Mixed --` panel
+ * query with none of its own) is left alone.
+ *
+ * Grafana interpolates template variables before Prometheus sees the query,
+ * so `$var`, `${var}`, `${var:format}`, `[[var]]` and the `$__` macros are
+ * replaced with a placeholder that parses where they stand: a duration
+ * inside `[...]` or after `offset`, a number for the `_ms`/`_s` macros and
+ * `$__from`/`$__to`, an identifier anywhere else. Inside a string literal
+ * they are left as they are.
+ */
+import { type KnownDatasource } from "./datasource-refs.js";
+type Json = Record<string, unknown>;
+export interface Substituted {
+    text: string;
+    /** Maps an offset in `text` back to one in the original query. */
+    originalOffset(at: number): number;
+}
+/** Replace every template variable outside a string literal with a placeholder that parses in its place. */
+export declare function substituteTemplateVariables(query: string): Substituted;
+export type PromqlSyntax = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+/** Check one query's PromQL syntax after substituting its template variables. */
+export declare function checkGrafanaPromql(query: string): PromqlSyntax;
+/**
+ * The PromQL inside a Prometheus query variable's query. Grafana handles
+ * `label_names()`, `label_values(selector, label)`, `metrics(regex)` and
+ * `query_result(expr)` itself and sends only the selector or expression; any
+ * other text is a series selector (`/api/v1/series?match[]=`).
+ */
+export declare function variablePromql(query: string): string[];
+/** One piece of PromQL a dashboard sends to Prometheus, and where it is written. */
+export interface PromqlUse {
+    where: string;
+    expr: string;
+}
+/** Every PromQL query a dashboard sends to Prometheus: panel queries, query variables and the library panels an export embeds in `__elements`. */
+export declare function prometheusQueries(dashboard: Json, known: ReadonlyMap<string, KnownDatasource>): PromqlUse[];
+export {};
+//# sourceMappingURL=promql-check.d.ts.map

package/dist/promql-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promql-check.d.ts","sourceRoot":"","sources":["../src/promql-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtF,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsBpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,4GAA4G;AAC5G,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA0DtE;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAS9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtD;AASD,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,kJAAkJ;AAClJ,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAAE,CAa3G"}

package/dist/query.d.ts

@@ -3,23 +3,24 @@
  * `TempoQuery` (TraceQL) and `LokiQuery` (LogQL), each typed from that
  * plugin's query schema at `GRAFANA_SCHEMA_PIN`.
  *
- * The expression is a string; this lexicon does not parse PromQL, TraceQL or
- * LogQL. What it does check is where the query goes: `datasource` only
- * accepts a datasource of the query's own plugin type, and GRAF101, GRAF102
- * and GRAF103 check the emitted references after a build.
+ * The expression is a string. What the lexicon checks is where the query
+ * goes: `datasource` only accepts a datasource of the query's own plugin
+ * type, and GRAF101, GRAF102 and GRAF103 check the emitted references after
+ * a build. GRAF108 parses the PromQL of every query that reaches a
+ * Prometheus; TraceQL and LogQL are not parsed.
  *
  * `defineQuery` is the extension point for any other datasource plugin, and
  * the three built-ins are defined through it.
  */
 import type { Declarable } from "@intentius/chant/declarable";
-import type { DatasourceEntity, DatasourceRef } from "./datasource.js";
+import type { DatasourceEntity, DatasourceRef, ExternalDatasourceEntity } from "./datasource.js";
 import type { DatasourceVariableEntity } from "./variables.js";
 import type { SchemaName } from "./pin.js";
 import type { Dataquery as PrometheusDataquery } from "./schema/prometheus.gen.js";
 import type { Dataquery as TempoDataquery } from "./schema/tempo.gen.js";
 import type { Dataquery as LokiDataquery } from "./schema/loki.gen.js";
-/** Where a query or panel sends its request: a declared datasource, a datasource variable, or the ref of one declared elsewhere. */
-export type DatasourceInput<T extends string = string> = DatasourceEntity<T> | DatasourceVariableEntity<T> | DatasourceRef<T>;
+/** Where a query or panel sends its request: a declared or external datasource, a datasource variable, or the ref of one declared elsewhere. */
+export type DatasourceInput<T extends string = string> = DatasourceEntity<T> | ExternalDatasourceEntity<T> | DatasourceVariableEntity<T> | DatasourceRef<T>;
 /** A query model's fields, less what chant fills in (`datasource`, `refId` stays optional). */
 export type QueryModel<M> = Omit<M, "datasource">;
 export type QueryProps<M, T extends string> = QueryModel<M> & {
@@ -67,7 +68,7 @@ export declare function queryDefinitionFor(datasourceType: string): QueryDefinit
  * });
  * ```
  */
-export declare function defineQuery<M>(): <T extends string>(def: Omit<QueryDefinition<T, M>, "builtin">) => QueryClass<T, M>;
+export declare function defineQuery<M = Record<string, unknown>>(): <T extends string>(def: Omit<QueryDefinition<T, M>, "builtin">) => QueryClass<T, M>;
 export declare function isQueryEntity(value: unknown): value is QueryEntity;
 /** A Prometheus query: `expr` is PromQL. */
 export declare const PromQuery: QueryClass<"prometheus", PrometheusDataquery>;

package/dist/query.d.ts.map

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

package/dist/rules/graf101.ts

@@ -1,7 +1,7 @@
 /**
- * GRAF101: A panel, query or variable uses a datasource no Datasource in the build declares
+ * GRAF101: A panel, query or variable uses a datasource no Datasource or ExternalDatasource in the build declares
  *
- * Grafana shows "datasource not found" on the panel. Typed references cannot go wrong this way, so it mostly catches a { type, uid } ref or a hand-edited dashboard. A panel with queries and no datasource at all is a warning: Grafana sends them to its default datasource. This check joins dashboards against the Datasource declarations of the same build root, so it goes silent across build roots (chant #1939): with no Datasource declared in the build it reports nothing, and a datasource declared in another build root looks undeclared. Keep datasources and the dashboards that use them in one build root.
+ * Grafana shows "datasource not found" on the panel. Typed references cannot go wrong this way, so it mostly catches a { type, uid } ref or a hand-edited dashboard. A datasource variable whose plugin type no declared datasource has is an error too. A panel with queries and no datasource at all is a warning: Grafana sends them to its default datasource. This check joins dashboards against the datasources of the same build root (chant #1939): declare one that exists in Grafana but is provisioned elsewhere with ExternalDatasource, which the check counts and the build never provisions. A build that declares no datasource at all gets one warning per dashboard that references any, since nothing can be checked.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
@@ -9,7 +9,7 @@ import { grafanaDiagnostics } from "./grafana-helpers";
 
 export const graf101: PostSynthCheck = {
   id: "GRAF101",
-  description: "A panel, query or variable uses a datasource no Datasource in the build declares",
+  description: "A panel, query or variable uses a datasource no Datasource or ExternalDatasource in the build declares",
 
   check(ctx: PostSynthContext): PostSynthDiagnostic[] {
     return grafanaDiagnostics(ctx, "GRAF101");

package/dist/rules/graf102.ts

@@ -1,7 +1,7 @@
 /**
  * GRAF102: A query is sent to a datasource of another plugin type
  *
- * A PromQL query sent to Tempo fails at query time. The typed classes prevent this at compile time; the check catches refs, datasource variables of the wrong plugin type and hand-edited dashboards. Like GRAF101 it joins against the Datasource declarations of the same build root and goes silent across build roots (chant #1939).
+ * A PromQL query sent to Tempo fails at query time. The typed classes prevent this at compile time; the check catches refs, datasource variables of the wrong plugin type and hand-edited dashboards. Like GRAF101 it joins against the Datasource and ExternalDatasource declarations of the same build root (chant #1939).
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/graf107.ts

@@ -1,7 +1,7 @@
 /**
  * GRAF107: A dashboard does not match the pinned Grafana schema
  *
- * The dashboard is validated against the dashboard schema at GRAFANA_SCHEMA_PIN, and each panel's options, fieldConfig.defaults.custom and queries against their plugin's schema with required fields relaxed (Grafana fills those in). What fails is a key the schema does not have or a value it does not allow: the edits Grafana would otherwise need on import.
+ * The dashboard is validated against the dashboard schema at GRAFANA_SCHEMA_PIN, with the correction overlay in src/spec/overlay/ applied, and each panel's options, fieldConfig.defaults.custom and queries against their plugin's schema with required fields relaxed (Grafana fills those in). Library panel models embedded in an export's __elements are checked the same way. A value the schema does not allow is an error: the edits Grafana would otherwise need on import. A key the schema does not know is a warning, since newer Grafana versions add keys before the pin catches up.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/graf108.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF108: A query sent to Prometheus is not valid PromQL
+ *
+ * Each panel query, query variable and alert rule query whose datasource resolves to a prometheus datasource is parsed with the prometheus lexicon's checkPromql (@prometheus-io/lezer-promql), after its template variables ($var, ${var}, [[var]], $__interval, $__rate_interval, $__range and the other $__ macros) are replaced with placeholders that parse where they stand. A query whose datasource can't be told is not parsed; an alert rule query is parsed when its datasourceUid is a declared prometheus datasource or its model says `datasource.type: prometheus`. It is a syntax check: an unbalanced bracket or a bad duration fails, rate over an instant vector does not.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf108: PostSynthCheck = {
+  id: "GRAF108",
+  description: "A query sent to Prometheus is not valid PromQL",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF108");
+  },
+};

package/dist/rules/graf109.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF109: Dashboard provisioning puts a dashboard somewhere other than its declared folder, or loads it twice
+ *
+ * Read from the dashboard provisioning file and where each dashboard file sits under dashboards/. Two providers in one org whose paths are the same or nested load every dashboard twice, and Grafana then takes database writes away from both: an error. A provider that sets folder and folderUid with foldersFromFilesStructure is refused by Grafana: an error; with one of them, that folder is ignored: a warning. Dashboards that declare a folder when no provider sets foldersFromFilesStructure all land in the provider's folder: a warning. A nested folder ("Platform/Kubernetes") is a warning: Grafana 13.1 and later nest the folders, 12.4 and 13.0 use only the last level; past Grafana's default depth of 4 it says so, and past its hard limit of 7 it is an error.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf109: PostSynthCheck = {
+  id: "GRAF109",
+  description: "Dashboard provisioning puts a dashboard somewhere other than its declared folder, or loads it twice",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF109");
+  },
+};

package/dist/rules/graf111.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF111: An alert rule's condition, expression inputs or refIds do not fit together
+ *
+ * Each alert rule's condition, each server-side expression's inputs (a reduce, threshold or resample `expression`, the `$A` references of a math expression, a classic condition's query) and a recording rule's record.from must name a refId of the same rule; refIds must be unique, and a rule needs a condition unless it records. Each expression model is also validated against the pinned `expr` schema (a missing reducer, an unknown evaluator type). Grafana refuses such a rule, and a refused rule stops it provisioning every alerting file at startup.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf111: PostSynthCheck = {
+  id: "GRAF111",
+  description: "An alert rule's condition, expression inputs or refIds do not fit together",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF111");
+  },
+};

package/dist/rules/graf112.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF112: An alert rule queries a datasource the build does not declare, or of another type
+ *
+ * Each alert rule query's datasourceUid must be a datasource the build declares: a Datasource it provisions or an ExternalDatasource that already exists in Grafana. A query whose model states a datasource type (model.datasource.type) must match the declared type, and a recording rule's targetDatasourceUid must be a declared Prometheus datasource. With no datasource declared at all, it warns once that it cannot check.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf112: PostSynthCheck = {
+  id: "GRAF112",
+  description: "An alert rule queries a datasource the build does not declare, or of another type",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF112");
+  },
+};

package/dist/rules/graf113.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF113: Alerting routes to a contact point or mute timing the build does not declare, or a policy matcher does not parse
+ *
+ * The notification policy tree's receivers, every rule's notification_settings.receiver, and each mute_time_intervals and active_time_intervals entry must name a ContactPoint or MuteTiming the build declares (grafana-default-email exists in every Grafana). Policy object_matchers must be [label, op, value] with op =, !=, =~ or !~ and a valid regex; matchers must parse as Alertmanager matchers. With no contact point or mute timing declared it warns once that it cannot check.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf113: PostSynthCheck = {
+  id: "GRAF113",
+  description: "Alerting routes to a contact point or mute timing the build does not declare, or a policy matcher does not parse",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF113");
+  },
+};

package/dist/rules/graf114.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF114: An alerting uid, name, title or interval Grafana rejects, or one declared twice
+ *
+ * Rule uids and contact point receiver uids must be 1-40 letters, digits, - and _; rules need a title of at most 190 characters; groups need a name, a folder and an interval that is a positive multiple of 10s; for and keepFiringFor must be durations; noDataState and execErrState must be values Grafana knows. Rule uids, group names within a folder, contact point names, receiver uids, mute timing and template names must be unique per organisation, and each organisation has one policy tree. Grafana refuses the file otherwise, and one refused file stops it provisioning every alerting file.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf114: PostSynthCheck = {
+  id: "GRAF114",
+  description: "An alerting uid, name, title or interval Grafana rejects, or one declared twice",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF114");
+  },
+};

package/dist/rules/graf115.ts

@@ -0,0 +1,17 @@
+/**
+ * GRAF115: A unit Grafana doesn't know
+ *
+ * Each panel's `fieldConfig.defaults.unit`, every `unit` override, a heatmap's `options.yAxis.unit` and `options.cellValues.unit`, and a legacy graph panel's `yaxes[].format` are looked up in Grafana's unit registry at v13.2.2 (`src/spec/units.gen.ts`). Custom units (`prefix:`, `suffix:`, `time:`, `si:`, `count:`, `currency:`, `bool:`) pass. Anything else Grafana shows as a literal suffix, so it is a warning that names the closest registered id.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { grafanaDiagnostics } from "./grafana-helpers";
+
+export const graf115: PostSynthCheck = {
+  id: "GRAF115",
+  description: "A panel unit Grafana doesn't know, which it shows as a literal suffix",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return grafanaDiagnostics(ctx, "GRAF115");
+  },
+};

package/dist/rules/grafana-helpers.ts

@@ -1,18 +1,21 @@
 /**
- * Shared plumbing for the grafana post-synth checks: find the dashboards and
- * provisioned datasources in a build's output, and run the plain-function
- * checks in `validate-output.ts` over them.
+ * Shared plumbing for the grafana post-synth checks: find the dashboards,
+ * provisioned datasources, dashboard providers and alerting provisioning
+ * files in a build's output, and run the plain-function checks in
+ * `validate-output.ts` over them.
  *
  * Any output file shaped like a dashboard or a datasource provisioning file
  * counts, not only the grafana lexicon's own, so a dashboard another lexicon
- * embeds is checked the same way.
+ * embeds is checked the same way. `ExternalDatasource` declarations are never
+ * written to a provisioning file, so they come from the build's entities.
  */
 
 import type { PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
 import type { SerializerResult } from "@intentius/chant/serializer";
 import { loadAll } from "js-yaml";
-import { looksLikeDashboard, looksLikeDatasourceProvisioning } from "../../detect";
-import type { ProvisionedDatasource } from "../../build";
+import { looksLikeAlertingProvisioning, looksLikeDashboard, looksLikeDashboardProvisioning, looksLikeDatasourceProvisioning } from "../../detect";
+import { externalDatasourceRecord, type ProvisionedDatasource } from "../../build";
+import { isExternalDatasource } from "../../datasource";
 import { issuesFor, type GrafanaArtifacts, type GrafanaIssueCode } from "../../validate-output";
 
 function parse(text: string, name: string): unknown[] {
@@ -30,9 +33,10 @@ function parse(text: string, name: string): unknown[] {
   }
 }
 
-/** Every dashboard and provisioned datasource in the build's output. */
+/** Every dashboard, provisioned datasource and dashboard provider and alerting provisioning file in the build's output, and every `ExternalDatasource` it declares. */
 export function grafanaArtifacts(ctx: PostSynthContext): GrafanaArtifacts {
-  const out: GrafanaArtifacts = { dashboards: [], datasources: [] };
+  const externalDatasources = [...(ctx.entities?.values() ?? [])].filter(isExternalDatasource).map(externalDatasourceRecord);
+  const out: GrafanaArtifacts = { dashboards: [], datasources: [], externalDatasources, providers: [], alerting: [] };
   for (const [lexicon, output] of ctx.outputs) {
     const texts: Array<[string, string]> =
       typeof output === "string"
@@ -42,6 +46,9 @@ export function grafanaArtifacts(ctx: PostSynthContext): GrafanaArtifacts {
       if (!text) continue;
       for (const doc of parse(text, source)) {
         if (looksLikeDashboard(doc)) out.dashboards.push({ source, json: doc });
+        else if (looksLikeDashboardProvisioning(doc)) {
+          for (const p of doc.providers) if (p && typeof p === "object" && !Array.isArray(p)) out.providers!.push(p as Record<string, unknown>);
+        } else if (looksLikeAlertingProvisioning(doc)) out.alerting!.push({ source, json: doc });
         else if (looksLikeDatasourceProvisioning(doc)) {
           for (const d of doc.datasources) {
             if (d && typeof d === "object" && typeof (d as ProvisionedDatasource).name === "string") {

package/dist/rules/literal-secret.ts

@@ -1,15 +1,38 @@
 import * as ts from "typescript";
 import type { LintRule, LintDiagnostic, LintContext } from "@intentius/chant/lint/rule";
 import { constInitializers, constructorArgs, literalText, position, propertyName, resolveObject } from "./grafana-ast";
+import { CONTACT_POINT_SECRET_SETTINGS, EXPANDED_VALUE as EXPANDED } from "../../contact-point-secrets";
 
-/** How Grafana provisioning reads a value from outside the file: `$VAR`, `${VAR}`, `$__env{…}`, `$__file{…}`, `$__vault{…}`. */
-const EXPANDED = /\$(\{[A-Za-z_][A-Za-z0-9_]*\}|[A-Za-z_][A-Za-z0-9_]*|__(env|file|vault)\{[^}]+\})/;
+/** Follow an identifier to the array literal it was declared as, when it is one in this file. */
+function resolveArray(node: ts.Expression, consts: Map<string, ts.Expression>, depth = 0): ts.ArrayLiteralExpression | undefined {
+  let n: ts.Expression = node;
+  while (ts.isAsExpression(n) || ts.isSatisfiesExpression(n) || ts.isParenthesizedExpression(n)) n = n.expression;
+  if (ts.isArrayLiteralExpression(n)) return n;
+  if (ts.isIdentifier(n) && depth < 5) {
+    const init = consts.get(n.text);
+    if (init) return resolveArray(init, consts, depth + 1);
+  }
+  return undefined;
+}
+
+/** The value of a property, `name: value` or the shorthand `name` (followed as an identifier). */
+function prop(obj: ts.ObjectLiteralExpression, name: string): ts.Expression | undefined {
+  for (const p of obj.properties) {
+    if (propertyName(p) === name) return (p as ts.PropertyAssignment).initializer;
+    if (ts.isShorthandPropertyAssignment(p) && p.name.text === name) return p.name;
+  }
+  return undefined;
+}
 
 /**
- * GRAF002: a datasource secret written as a literal.
+ * GRAF002: a datasource or contact point secret written as a literal.
  *
- * `secureJsonData` holds passwords, tokens and TLS keys. A literal there is a
- * secret in the repository and in the emitted provisioning file. Grafana
+ * A datasource's `secureJsonData` holds passwords, tokens and TLS keys, and
+ * so do the settings Grafana stores encrypted for each contact point
+ * integration (a Slack webhook `url`, a PagerDuty `integrationKey`, a
+ * webhook's `authorization_credentials`; see `CONTACT_POINT_SECRET_SETTINGS`).
+ * A literal there is a secret in the repository and in the emitted
+ * provisioning file. Grafana
  * expands `$__env{NAME}`, `$__file{/path}` and `${NAME}` when it reads the
  * file, so the declaration never needs the value. A value written as a
  * named `const` in the same file is followed.
@@ -18,7 +41,7 @@ export const literalSecretRule: LintRule = {
   id: "GRAF002",
   severity: "error",
   category: "security",
-  description: "Datasource secureJsonData value declared as a literal instead of $__env{...} or $__file{...}",
+  description: "Datasource secureJsonData or contact point secret setting declared as a literal instead of $__env{...} or $__file{...}",
 
   check(context: LintContext): LintDiagnostic[] {
     const diagnostics: LintDiagnostic[] = [];
@@ -43,6 +66,37 @@ export const literalSecretRule: LintRule = {
         }
       }
     }
+    for (const { arg } of constructorArgs(source, (n) => n === "ContactPoint")) {
+      const receivers = prop(arg, "receivers");
+      const list = receivers ? resolveArray(receivers, consts) : undefined;
+      for (const el of list?.elements ?? []) {
+        const receiver = resolveObject(el as ts.Expression, consts);
+        if (!receiver) continue;
+        const typeNode = prop(receiver, "type");
+        const type = typeNode ? literalText(typeNode) : undefined;
+        const settingsNode = prop(receiver, "settings");
+        const settings = settingsNode ? resolveObject(settingsNode, consts) : undefined;
+        if (!type || !settings) continue;
+        for (const path of CONTACT_POINT_SECRET_SETTINGS[type] ?? []) {
+          let node: ts.ObjectLiteralExpression | undefined = settings;
+          const segments = path.split(".");
+          for (const seg of segments.slice(0, -1)) {
+            const next: ts.Expression | undefined = node ? prop(node, seg) : undefined;
+            node = next ? resolveObject(next, consts) : undefined;
+          }
+          const valueNode = node ? prop(node, segments[segments.length - 1]) : undefined;
+          const text = valueNode ? literalText(valueNode) : undefined;
+          if (!valueNode || text === undefined || text === "" || EXPANDED.test(text)) continue;
+          diagnostics.push({
+            ruleId: "GRAF002",
+            severity: "error",
+            message: `${type} contact point setting ${path} is a literal secret; write "$__env{NAME}" or "$__file{/path}" and let Grafana read it`,
+            file: context.filePath,
+            ...position(source, valueNode),
+          });
+        }
+      }
+    }
     return diagnostics;
   },
 };