@intentius/chant-lexicon-prometheus 0.100.0 → 0.102.0

package/dist/lint/post-synth/prom-helpers.d.ts

@@ -26,7 +26,7 @@ export interface FoundDocs {
 export declare function prometheusDocs(ctx: PostSynthContext): FoundDocs;
 /** Diagnostics for one rule-file code (PROM101-PROM107) across every rule file in the output. */
 export declare function ruleFileDiagnostics(ctx: PostSynthContext, code: PrometheusIssueCode): PostSynthDiagnostic[];
-/** Diagnostics for one Alertmanager code (PROM201, PROM203-PROM209) across every `alertmanager.yml` in the output. */
+/** Diagnostics for one Alertmanager code (PROM201, PROM203-PROM210) across every `alertmanager.yml` in the output. */
 export declare function alertmanagerDiagnostics(ctx: PostSynthContext, code: PrometheusIssueCode): PostSynthDiagnostic[];
 /** PROM202: joins every rule file in the output against every Alertmanager config in it. Silent when either is absent. */
 export declare function routingDiagnostics(ctx: PostSynthContext): PostSynthDiagnostic[];

package/dist/lint/post-synth/prom208.d.ts

@@ -1,7 +1,7 @@
 /**
  * PROM208: An Alertmanager duration is not a duration
  *
- * group_wait, group_interval, repeat_interval, resolve_timeout and webhook timeout take durations such as 30s or 4h.
+ * group_wait, group_interval, repeat_interval, resolve_timeout and Jira reopen_duration take Prometheus durations (30s, 4h, 1d); the timeout of webhook, Slack, PagerDuty and incident.io, and Pushover retry, expire and ttl take Go durations (10s, 1m30s, 500ms).
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const prom208: PostSynthCheck;

package/dist/lint/post-synth/prom209.d.ts

@@ -1,7 +1,7 @@
 /**
  * PROM209: A receiver integration is missing its destination or credential
  *
- * A webhook needs url or url_file, Slack an api_url (or the global one), PagerDuty a routing_key or service_key, and email a to address, a smarthost and a from address (or their global defaults).
+ * Every one of Alertmanager's 18 integrations is checked for the destination, credential and required fields its config validation asks for, with the global defaults it falls back to: e.g. a webhook url, an Opsgenie api_key (or global.opsgenie_api_key), a Telegram chat_id and bot token, a Webex room_id and authorization, an SNS target, a Jira project and issue_type.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const prom209: PostSynthCheck;

package/dist/lint/post-synth/prom210.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PROM210: A receiver integration or global setting is one Alertmanager rejects
+ *
+ * Two settings that exclude each other (a value and its *_file, a Slack api_url and app_token, Pushover html and monospace, two SNS targets), or a value outside the allowed set (WeChat message_type, Telegram parse_mode, Jira api_type, an Opsgenie responder type, a VictorOps reserved custom field, a smarthost that is not host:port, a Slack or Mattermost field without title and value).
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const prom210: PostSynthCheck;
+//# sourceMappingURL=prom210.d.ts.map

package/dist/lint/post-synth/prom210.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prom210.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/prom210.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "prometheus",
-  "version": "0.100.0",
+  "version": "0.102.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Prometheus",
   "intrinsics": [],

package/dist/okf/index.md

@@ -32,3 +32,4 @@ okf_version: '0.2'
 * [PROM207](/rules/PROM207.md) - A receiver is declared but no route sends to it
 * [PROM208](/rules/PROM208.md) - An Alertmanager duration is not a duration
 * [PROM209](/rules/PROM209.md) - A receiver integration is missing its destination or credential
+* [PROM210](/rules/PROM210.md) - A receiver integration or global setting is one Alertmanager rejects

package/dist/okf/rules/PROM210.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: PROM210
+description: A receiver integration or global setting is one Alertmanager rejects
+id: PROM210
+severity: error
+category: post-synth
+lexicon: prometheus
+docs: https://intentius.io/chant/lexicons/prometheus/rules/
+---
+A receiver integration or global setting is one Alertmanager rejects

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;AA+B9D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAyG9B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+B9D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,aA6G9B,CAAC"}

package/dist/rule-eval.d.ts

@@ -7,10 +7,15 @@
  * The PromQL it understands is the subset the lexicon's generated rules use:
  * number literals, vector and range selectors with `=`, `!=`, `=~` and `!~`
  * matchers, `rate`, `increase`, `avg_over_time`, `sum_over_time`,
- * `count_over_time`, `vector`, `sum` (with `by` or `without`), the
- * arithmetic and comparison operators and `and`, `or` and `unless` (with
- * `on` or `ignoring`). Anything else throws, so a test never passes by
- * silently evaluating something it does not understand.
+ * `count_over_time`, `vector`, `histogram_quantile`, `sum` (with `by` or
+ * `without`), the arithmetic and comparison operators (one-to-one, or
+ * many-to-one with `group_left` and no extra labels) and `and`, `or` and
+ * `unless` (with `on` or `ignoring`). Anything else throws, so a test never
+ * passes by silently evaluating something it does not understand.
+ *
+ * `histogram_quantile` interpolates linearly inside the bucket the rank
+ * falls in, as Prometheus does for classic buckets, and returns the upper
+ * bound of the highest finite bucket when the rank falls in `+Inf`.
  *
  * `rate` is the increase between the first and last sample in the range
  * over the time between them, without Prometheus's extrapolation to the
@@ -61,6 +66,7 @@ export declare class RuleEvaluator {
     private node;
     private args;
     private call;
+    private histogramQuantile;
     private aggregate;
     private binary;
 }

package/dist/rule-eval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-eval.d.ts","sourceRoot":"","sources":["../src/rule-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAA8D,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAI3G,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AACD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAiCD,8DAA8D;AAC9D,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAErC,MAAM,EAAE,eAAe,EAAE;IAEtD,wEAAwE;IACxE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAU/C,yFAAyF;IACzF,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IA8B9B,yFAAyF;IACzF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAK/C,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,MAAM;IAId,iCAAiC;IACjC,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IAuCZ,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,MAAM;CA0Gf"}
+{"version":3,"file":"rule-eval.d.ts","sourceRoot":"","sources":["../src/rule-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAA8D,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAI3G,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AACD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAkCD,8DAA8D;AAC9D,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,YAA6B,MAAM,EAAE,eAAe,EAAE,EAAI;IAE1D,wEAAwE;IACxE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ9C;IAED,yFAAyF;IACzF,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CA4B7B;IAED,yFAAyF;IACzF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAG9C;IAED,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,MAAM;IAId,iCAAiC;IACjC,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IA0CZ,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,MAAM;CA2Hf"}

package/dist/rules/prom-helpers.ts

@@ -71,7 +71,7 @@ export function ruleFileDiagnostics(ctx: PostSynthContext, code: PrometheusIssue
   );
 }
 
-/** Diagnostics for one Alertmanager code (PROM201, PROM203-PROM209) across every `alertmanager.yml` in the output. */
+/** Diagnostics for one Alertmanager code (PROM201, PROM203-PROM210) across every `alertmanager.yml` in the output. */
 export function alertmanagerDiagnostics(ctx: PostSynthContext, code: PrometheusIssueCode): PostSynthDiagnostic[] {
   return prometheusDocs(ctx).alertmanager.flatMap(({ source, config }) =>
     validateAlertmanagerConfig(config)

package/dist/rules/prom208.ts

@@ -1,7 +1,7 @@
 /**
  * PROM208: An Alertmanager duration is not a duration
  *
- * group_wait, group_interval, repeat_interval, resolve_timeout and webhook timeout take durations such as 30s or 4h.
+ * group_wait, group_interval, repeat_interval, resolve_timeout and Jira reopen_duration take Prometheus durations (30s, 4h, 1d); the timeout of webhook, Slack, PagerDuty and incident.io, and Pushover retry, expire and ttl take Go durations (10s, 1m30s, 500ms).
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/prom209.ts

@@ -1,7 +1,7 @@
 /**
  * PROM209: A receiver integration is missing its destination or credential
  *
- * A webhook needs url or url_file, Slack an api_url (or the global one), PagerDuty a routing_key or service_key, and email a to address, a smarthost and a from address (or their global defaults).
+ * Every one of Alertmanager's 18 integrations is checked for the destination, credential and required fields its config validation asks for, with the global defaults it falls back to: e.g. a webhook url, an Opsgenie api_key (or global.opsgenie_api_key), a Telegram chat_id and bot token, a Webex room_id and authorization, an SNS target, a Jira project and issue_type.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/prom210.ts

@@ -0,0 +1,17 @@
+/**
+ * PROM210: A receiver integration or global setting is one Alertmanager rejects
+ *
+ * Two settings that exclude each other (a value and its *_file, a Slack api_url and app_token, Pushover html and monospace, two SNS targets), or a value outside the allowed set (WeChat message_type, Telegram parse_mode, Jira api_type, an Opsgenie responder type, a VictorOps reserved custom field, a smarthost that is not host:port, a Slack or Mattermost field without title and value).
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { alertmanagerDiagnostics } from "./prom-helpers";
+
+export const prom210: PostSynthCheck = {
+  id: "PROM210",
+  description: "A receiver integration or global setting is one Alertmanager rejects",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return alertmanagerDiagnostics(ctx, "PROM210");
+  },
+};

package/dist/skill-defs.d.ts

@@ -1,3 +1,3 @@
 /** The prometheus lexicon's AI skills, read from src/skills/. */
-export declare const prometheusSkills: () => import("packages/core/src").SkillDefinition[];
+export declare const prometheusSkills: () => import("@intentius/chant").SkillDefinition[];
 //# sourceMappingURL=skill-defs.d.ts.map

package/dist/skill-defs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-defs.d.ts","sourceRoot":"","sources":["../src/skill-defs.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,qDAuC3B,CAAC"}
+{"version":3,"file":"skill-defs.d.ts","sourceRoot":"","sources":["../src/skill-defs.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,oDAuC3B,CAAC"}

package/dist/skills/chant-prometheus-alertmanager.md

@@ -57,6 +57,8 @@ Import it rather than retyping it: `chant import alertmanager.yml --output src`
 - Routes name receivers and time intervals that exist (PROM201, PROM204). Reference the entity rather than a string and TypeScript does most of this.
 - Every `severity` an alert in the same build root carries is matched by some route below the root (PROM202). The check only sees one build root (chant #1939): keep the rules and the Alertmanager config in the same one, or it goes quiet.
 - Credentials go in `*_file` fields. Alertmanager does not expand environment variables in its config, and a literal `api_url`, `routing_key` or `auth_password` is flagged (PROM001).
-- Each integration has somewhere to send (PROM209): a webhook `url`, a Slack `api_url` (or `global.slack_api_url`), a PagerDuty key, an email `to`/`smarthost`/`from` (or the global SMTP defaults).
+- Each integration has its destination, credential and required fields, or the `global` default it falls back to (PROM209): a webhook `url`, a Slack `api_url` or app token, an Opsgenie `api_key`, a Telegram `chat_id` and bot token, a Webex `room_id` and `http_config.authorization`, one SNS target, a Jira `project` and `issue_type`, an email `to`/`smarthost`/`from`, and so on.
+- No setting Alertmanager rejects (PROM210): a value and its `*_file` both set, a Slack `api_url` with an app token, `update_message` without `api_url: https://slack.com/api/chat.postMessage`, a WeChat `message_type` other than `text`/`markdown`, a Telegram `parse_mode` other than `Markdown`/`MarkdownV2`/`HTML`.
+- Durations parse (PROM208). Route timers and `resolve_timeout` take `1d`; the integration `timeout`s and Pushover `retry`/`expire`/`ttl` are Go durations and take `24h`, not `1d`.
 
 Run `amtoolCheckConfig(alertmanagerYaml(entities))` in a test to have `amtool check-config` confirm it when installed.

package/dist/skills/chant-prometheus.md

@@ -100,3 +100,25 @@ sloMetrics(checkout).errorRatio["1h"]; // "slo:sli_error:ratio_rate1h"
 - Write the objective as a fraction strictly between 0 and 1, and put `{{window}}` where each SLI expression's range goes (PROM003).
 - Alerts carry `severity` `page` or `ticket`; route both (PROM202).
 - Read series names from `sloMetrics()` in dashboards instead of repeating them.
+
+## GenAI rules
+
+`GenAiRules` builds rules for the otel lexicon's GenAI collector preset from the same `genAiMetrics(options)` the collector was built with: request rate, error ratio (also by `error.type`) and p50/p95/p99 latency per provider, model and operation, token rates, spend per second from a price table the project declares, and per-tool call rate, error ratio and p95 latency. Alerts are off unless `alerts` names them.
+
+```ts
+import { genAiMetrics } from "@intentius/chant-lexicon-otel";
+import { GenAiRules, genAiRuleMetrics } from "@intentius/chant-lexicon-prometheus";
+
+export const genai = GenAiRules({
+  genAi: genAiMetrics({ clientMetrics: "derive" }),
+  prices: [{ provider: "anthropic", model: "claude-x", inputPerMTok: 3, outputPerMTok: 15, currency: "USD", source: "https://example.com/pricing", asOf: "2026-09-29" }],
+  alerts: { errorRatio: true, latency: { thresholdSeconds: 20 }, budgets: [{ amount: 50, currency: "USD", per: "day" }] },
+});
+
+genAiRuleMetrics(genai).cost; // "gen_ai:cost:rate5m"
+```
+
+- Pass the collector's own options to `genAiMetrics()`; never write a metric name by hand.
+- Ship no prices in a lexicon or template. The project declares them, with `currency` and `source` on each.
+- A model missing from `prices` gets no cost series, so a sum of the cost series covers priced models only.
+- Read series names from `genAiRuleMetrics()` in dashboards.

package/dist/validate-config.d.ts

@@ -7,7 +7,7 @@
  * `PrometheusRule`'s groups, or on a file parsed by some other tool.
  */
 import { type AlertmanagerConfig, type RuleFileConfig } from "./model.js";
-export type PrometheusIssueCode = "PROM101" | "PROM102" | "PROM103" | "PROM104" | "PROM105" | "PROM106" | "PROM107" | "PROM201" | "PROM202" | "PROM203" | "PROM204" | "PROM205" | "PROM206" | "PROM207" | "PROM208" | "PROM209";
+export type PrometheusIssueCode = "PROM101" | "PROM102" | "PROM103" | "PROM104" | "PROM105" | "PROM106" | "PROM107" | "PROM201" | "PROM202" | "PROM203" | "PROM204" | "PROM205" | "PROM206" | "PROM207" | "PROM208" | "PROM209" | "PROM210";
 export interface PrometheusIssue {
     code: PrometheusIssueCode;
     severity: "error" | "warning";
@@ -19,7 +19,7 @@ export interface PrometheusIssue {
 export declare function validateRuleFile(file: RuleFileConfig): PrometheusIssue[];
 /** Every severity value an alert in these rule files carries, with the alerts carrying it. */
 export declare function alertSeverities(files: RuleFileConfig[]): Map<string, string[]>;
-/** Check an `alertmanager.yml` on its own (PROM201, PROM203-PROM209). */
+/** Check an `alertmanager.yml` on its own (PROM201, PROM203-PROM210). */
 export declare function validateAlertmanagerConfig(config: AlertmanagerConfig): PrometheusIssue[];
 /**
  * PROM202: every severity an alert carries is taken by some route below the

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

@@ -1 +1 @@
-{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../src/validate-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,kBAAkB,EAIvB,KAAK,cAAc,EAEpB,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmBD,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,CAsHxE;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAa9E;AAsBD,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,EAAE,CA4HxF;AAYD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe,EAAE,CA6BlH"}
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../src/validate-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,kBAAkB,EAIvB,KAAK,cAAc,EAEpB,MAAM,SAAS,CAAC;AAIjB,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmBD,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,CAsHxE;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAa9E;AAsBD,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,EAAE,CAmGxF;AAYD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe,EAAE,CA6BlH"}

package/dist/validate-integrations.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Receiver integration and `global:` checks for `alertmanager.yml`
+ * (PROM208-PROM210), one case per validation Alertmanager v0.34.1 makes when
+ * it loads the file (see ./pin.ts). Sources, under
+ * github.com/prometheus/alertmanager at that tag:
+ *
+ * - `config/notifiers.go`: the `UnmarshalYAML` of the Email, Slack (and its
+ *   fields, actions and confirmations), WeChat, VictorOps, Pushover, SNS,
+ *   Rocket.Chat and Webex configs.
+ * - `notify/<name>/config.go`: the `UnmarshalYAML` of the Discord,
+ *   incident.io, Jira, Mattermost (and its fields), MS Teams, MS Teams v2,
+ *   Opsgenie, PagerDuty, Telegram and webhook configs.
+ * - `config/config.go`: `Config.UnmarshalYAML`, which fills each
+ *   integration from its `global:` default and then rejects what is still
+ *   missing, and the `global:` "at most one of" checks; `HostPort` for
+ *   `smarthost`.
+ *
+ * Durations come in two grammars. `model.Duration` fields (`resolve_timeout`,
+ * the route timers, Jira `reopen_duration`) use Prometheus's, see
+ * ./duration.ts. `time.Duration` fields (the `timeout` of webhook, Slack,
+ * PagerDuty and incident.io, and Pushover's `retry`, `expire` and `ttl`)
+ * use Go's `time.ParseDuration`: `1.5s` and `300ms` are valid, `1d` is not.
+ *
+ * Alertmanager stops at the first error; these checks report every one.
+ * PROM209 is something missing (a destination, credential or required
+ * field), PROM210 a setting Alertmanager rejects (two settings that exclude
+ * each other, or a value outside the allowed set), PROM208 a duration.
+ */
+import type { AlertmanagerGlobalConfig, ReceiverConfig } from "./model.js";
+import type { PrometheusIssue } from "./validate-config.js";
+/** True when `value` is a Go `time.ParseDuration` duration (`0`, `1.5s`, `1h30m`, `300ms`). */
+export declare function isValidGoDuration(value: unknown): boolean;
+/** PROM208-PROM210 findings for every integration of one receiver. */
+export declare function validateReceiverIntegrations(receiver: ReceiverConfig, global: AlertmanagerGlobalConfig): PrometheusIssue[];
+/** PROM208 and PROM210 findings for `global:` (config/config.go `Config.UnmarshalYAML`). */
+export declare function validateGlobalSettings(global: AlertmanagerGlobalConfig): PrometheusIssue[];
+//# sourceMappingURL=validate-integrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-integrations.d.ts","sourceRoot":"","sources":["../src/validate-integrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAoB,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAwBzD,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKzD;AA6RD,sEAAsE;AACtE,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,wBAAwB,GAAG,eAAe,EAAE,CAS1H;AAgBD,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,eAAe,EAAE,CAe1F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-prometheus",
-  "version": "0.100.0",
+  "version": "0.102.0",
   "description": "Prometheus lexicon for chant — typed recording and alerting rule groups and Alertmanager routing, serialized to a rule file and alertmanager.yml",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -56,9 +56,10 @@
     "validate": "tsx src/validate-cli.ts",
     "docs": "tsx src/codegen/docs-cli.ts",
     "prepack": "npm run generate && npm run bundle && npm run validate && npm run build",
-    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && find dist -type f \\( -name \"*.js\" -o -name \"*.js.map\" \\) -delete"
+    "build": "../../scripts/tsc7.sh -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-otel": "*",
     "@lezer/highlight": "^1.2.4",
     "@lezer/lr": "^1.4.10",
     "@prometheus-io/lezer-promql": "0.315.0",
@@ -71,7 +72,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.100.0",
+    "@intentius/chant": "^0.102.0",
     "typescript": "^5.9.3"
   }
 }

package/src/codegen/docs.ts

@@ -42,6 +42,11 @@ The \`Slo\` composite builds a service level objective to a \`RuleGroup\`:
 error ratios per window, the error budget left, and the SRE Workbook's
 multiwindow multi-burn-rate alerts. See [SLOs](./slos/).
 
+The \`GenAiRules\` composite builds recording rules, opt-in alerts and spend
+from a declared price table for the otel lexicon's GenAI collector preset,
+reading every metric name from its \`GenAiMetrics\`. See
+[GenAI Rules](./genai-rules/).
+
 Checks run at build time: PromQL syntax in every \`expr\` (PROM104), unique
 group names (PROM101), valid durations (PROM103), routes that name
 declared receivers (PROM201), and every alert severity routed by some route

package/src/composites/catalog.test.ts

@@ -19,7 +19,7 @@ const catalogued = compositeCatalog.map((entry) => entry.name).sort();
 
 describe("the prometheus composite catalog", () => {
   test("every exported composite has an entry, and every entry names an exported composite", () => {
-    expect(exported).toEqual(["Slo"]);
+    expect(exported).toEqual(["GenAiRules", "Slo"]);
     expect(catalogued, "regenerate with `npm run generate:composite-catalogs -- prometheus`").toEqual(exported);
   });
 

package/src/composites/catalog.ts

@@ -4,6 +4,76 @@
 import type { CompositeEntry } from "@intentius/chant/lexicon";
 
 export const compositeCatalog: CompositeEntry[] = [
+  {
+    "name": "GenAiRules",
+    "lexicon": "prometheus",
+    "description": "Recording rules and opt-in alerts for GenAI calls, from the otel preset's metrics.",
+    "bundles": [
+      "RuleGroup"
+    ],
+    "params": [
+      {
+        "name": "genAi",
+        "type": "GenAiMetrics | { metrics: GenAiMetrics }",
+        "required": true,
+        "description": "The preset's metrics: `genAiMetrics(options)` with the options the collector was built with, or `genAiComponents(options)`."
+      },
+      {
+        "name": "source",
+        "type": "\"client\" | \"spans\"",
+        "required": false,
+        "description": "Which metrics the model rules read (default `client` when the metrics include the conventions' client metrics, else `spans`)."
+      },
+      {
+        "name": "prices",
+        "type": "GenAiPrice[]",
+        "required": false,
+        "description": "Prices per provider and model."
+      },
+      {
+        "name": "alerts",
+        "type": "GenAiAlerting",
+        "required": false,
+        "description": "Opt-in alerts (default: none)."
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "required": false,
+        "description": "The rule group's name (default `genai`)."
+      },
+      {
+        "name": "prefix",
+        "type": "string",
+        "required": false,
+        "description": "The first part of every recorded series name (default `gen_ai`)."
+      },
+      {
+        "name": "rateWindow",
+        "type": "string",
+        "required": false,
+        "description": "The range every `rate` reads (default `5m`)."
+      },
+      {
+        "name": "groupBy",
+        "type": "string[]",
+        "required": false,
+        "description": "More Prometheus labels every rule keeps, e.g. `job` or `service_name`."
+      },
+      {
+        "name": "labels",
+        "type": "LabelSet",
+        "required": false,
+        "description": "Labels added to every rule, e.g. `team`."
+      },
+      {
+        "name": "interval",
+        "type": "string",
+        "required": false,
+        "description": "Evaluation interval of the group (default: Prometheus's `evaluation_interval`)."
+      }
+    ]
+  },
   {
     "name": "Slo",
     "lexicon": "prometheus",