@intentius/chant-lexicon-prometheus 0.97.0 → 0.99.0

package/README.md

@@ -27,10 +27,14 @@ export { api, oncall, fallback, root };
 |---|---|
 | `RuleGroup` | rule file |
 | `Slo` (composite) | rule file: SLI recording rules, error budget and multiwindow burn-rate alerts |
-| `Route`, `Receiver` (webhook, email, Slack, PagerDuty), `InhibitRule`, `TimeInterval`, `AlertmanagerSettings` | `alertmanager.yml` |
+| `Route`, `Receiver` (every Alertmanager integration), `InhibitRule`, `TimeInterval`, `AlertmanagerSettings` | `alertmanager.yml` |
 
 Types follow Prometheus `v3.15.0` and Alertmanager `v0.34.1` (`PROMETHEUS_PIN`).
 
+## Importing existing files
+
+`chant import rules.yml --output src` and `chant import alertmanager.yml --output src` turn an existing rule file or Alertmanager config into this lexicon's TypeScript (`--lexicon prometheus` skips detection). Rules stay plain objects in a `Rule[]` const beside each `RuleGroup`; a group an `Slo()` built comes back as the `Slo` call. Routes reference receivers and time intervals by variable. `*_file` credential paths and Go templates are kept as written, and a literal credential is imported as found for PROM001 to report. `chant build` on the result gives back the same files: the round-trip tests in `src/import/roundtrip.test.ts` hold every example's output, `Slo()` output, and samples from the Prometheus docs and Alertmanager's example configs to that, and run `promtool` and `amtool` over the rebuilt files when installed.
+
 ## Checks
 
 PROM001 to PROM003 run on source (literal credentials, PromQL syntax in literals, `Slo` objective, window and SLI literals). PROM101 to PROM107 run over the built rule file: unique group names, duplicate rules, durations, PromQL syntax, rule shape, severity labels and summaries. PROM201 to PROM209 run over `alertmanager.yml`: receivers and time intervals that exist, every alert severity routed (PROM202, one build root at a time), root route shape, matcher syntax, unused receivers, durations and integrations without a destination.
@@ -54,5 +58,6 @@ PromQL is parsed with `@prometheus-io/lezer-promql`, the Prometheus project's ow
 - `src/promql.ts`, `src/matchers.ts`, `src/duration.ts`: parsing
 - `src/validate-config.ts`, `src/lint/`: checks
 - `src/tools.ts`: promtool and amtool
+- `src/import/`: `chant import` for rule files and `alertmanager.yml` (parser, generator, `Slo` recognition, round-trip tests and fixtures)
 - `src/rule-eval.ts`: a small rule evaluator the SLO tests run over synthetic series
 - `examples/`: getting-started, alerting, rules-from-data, slo, k3d-stack

package/dist/alertmanager.d.ts

@@ -12,7 +12,7 @@
  * objects.
  */
 import type { Declarable } from "@intentius/chant/declarable";
-import type { AlertmanagerGlobalConfig, InhibitRuleConfig, ReceiverConfig, RouteConfig, TimeIntervalConfig } from "./model.js";
+import type { AlertmanagerGlobalConfig, AlertmanagerTracingConfig, InhibitRuleConfig, ReceiverConfig, RouteConfig, TimeIntervalConfig } from "./model.js";
 export declare const RECEIVER_TYPE = "Prometheus::Alertmanager::Receiver";
 export declare const ROUTE_TYPE = "Prometheus::Alertmanager::Route";
 export declare const INHIBIT_RULE_TYPE = "Prometheus::Alertmanager::InhibitRule";
@@ -64,11 +64,13 @@ export interface AlertmanagerSettingsProps {
     global?: AlertmanagerGlobalConfig;
     /** Paths of notification template files. */
     templates?: string[];
+    /** Where Alertmanager sends its own traces. */
+    tracing?: AlertmanagerTracingConfig;
 }
 export interface AlertmanagerSettingsEntity extends Declarable {
     readonly props: AlertmanagerSettingsProps;
 }
-/** The `global:` block and `templates:` list. Optional; declare at most one. */
+/** The `global:` block, `templates:` list and `tracing:` block. Optional; declare at most one. */
 export declare const AlertmanagerSettings: Ctor<AlertmanagerSettingsProps, AlertmanagerSettingsEntity>;
 export declare const isReceiver: (value: unknown) => value is ReceiverEntity;
 export declare const isRoute: (value: unknown) => value is RouteEntity;

package/dist/alertmanager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alertmanager.d.ts","sourceRoot":"","sources":["../src/alertmanager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"alertmanager.d.ts","sourceRoot":"","sources":["../src/alertmanager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,aAAa,uCAAuC,CAAC;AAClE,eAAO,MAAM,UAAU,oCAAoC,CAAC;AAC5D,eAAO,MAAM,iBAAiB,0CAA0C,CAAC;AACzE,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAC3E,eAAO,MAAM,aAAa,uCAAuC,CAAC;AAElE,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AActC,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,sCAEnB,CAAC;AAIH,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEnD,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,mEAAmE;AACnE,eAAO,MAAM,YAAY,8CAEvB,CAAC;AAIH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;IAC5H,iFAAiF;IACjF,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,eAAe,EAAE,CAAC;IACxC,qBAAqB,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wFAAwF;AACxF,eAAO,MAAM,KAAK,+BAA4D,CAAC;AAI/E,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAEjD,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAED,+FAA+F;AAC/F,eAAO,MAAM,WAAW,4CAAqF,CAAC;AAI9G,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,WAAW,0BAA2B,SAAQ,UAAU;IAC5D,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;CAC3C;AAED,kGAAkG;AAClG,eAAO,MAAM,oBAAoB,6DAGhC,CAAC;AASF,eAAO,MAAM,UAAU,UAJN,OAAO,KAAG,KAAK,kBAI+B,CAAC;AAChE,eAAO,MAAM,OAAO,UALH,OAAO,KAAG,KAAK,eAKsB,CAAC;AACvD,eAAO,MAAM,aAAa,UANT,OAAO,KAAG,KAAK,qBAMyC,CAAC;AAC1E,eAAO,MAAM,cAAc,UAPV,OAAO,KAAG,KAAK,sBAO4C,CAAC;AAC7E,eAAO,MAAM,sBAAsB,UARlB,OAAO,KAAG,KAAK,8BAQuD,CAAC;AAExF,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5D"}

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAc9D,OAAO,KAAK,EACV,kBAAkB,EAIlB,cAAc,EAEf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AA4B7E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,aAAa,CAUrG;AAID,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;CACf;AA8BD,iHAAiH;AACjH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAiEnH;AAID,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAE7F;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAEjG"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAc9D,OAAO,KAAK,EACV,kBAAkB,EAIlB,cAAc,EAEf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AA4B7E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,aAAa,CAUrG;AAID,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;CACf;AA+BD,iHAAiH;AACjH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAkEnH;AAID,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAE7F;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAEjG"}

package/dist/codegen/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4EH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9E"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgFH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9E"}

package/dist/import/embedded.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Rule groups embedded in another lexicon's resource, for `chant import`
+ * (#2962): a k8s `PrometheusRule`'s `spec.groups`, or a rule file held as
+ * text in a ConfigMap.
+ *
+ * The groups are imported exactly as `chant import rules.yml` would import
+ * them, into a directory of its own. `spec.groups` becomes the list of the
+ * declared groups (an `Slo`'s by its `rules` member), which the k8s
+ * serializer renders as the same groups; a rule file becomes
+ * `ruleFileYaml([...])`, the text the prometheus serializer writes.
+ */
+import type { EmbeddedContentImporter } from "@intentius/chant/import/embedded";
+export declare const ruleGroupsImporter: EmbeddedContentImporter;
+//# sourceMappingURL=embedded.d.ts.map

package/dist/import/embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded.d.ts","sourceRoot":"","sources":["../../src/import/embedded.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAkB,MAAM,kCAAkC,CAAC;AAOhG,eAAO,MAAM,kBAAkB,EAAE,uBAwBhC,CAAC"}

package/dist/import/generator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `TemplateIR` -> TypeScript, for `chant import`.
+ *
+ * Writes the files the way the lexicon's examples are written: nested
+ * settings lifted into named consts typed by the model (COR001), at most
+ * eight declarables per module (COR009), and an `export { ... }` list at the
+ * end of each module (COR004 flags an exported declaration nothing in its
+ * file uses).
+ *
+ * A rule file becomes `rules.ts`: per group, its rules as a `Rule[]` const
+ * of plain objects, the same shape `ruleGroupConfig` emits, and a
+ * `RuleGroup`. A group an `Slo()` built is written as that `Slo` call in
+ * `slos.ts` instead (see ./slo.ts).
+ *
+ * An `alertmanager.yml` becomes `receivers.ts`, `time-intervals.ts`,
+ * `routes.ts` (the root `Route`, its children as `RouteProps` objects),
+ * `inhibit-rules.ts` and `settings.ts`. Routes name their receivers and time
+ * intervals by the declared variable, imported from the module that
+ * declares it; a name nothing declares stays a string, and PROM201 / PROM204
+ * report it.
+ */
+import type { GeneratedFile, TypeScriptGenerator } from "@intentius/chant/import/generator";
+import type { TemplateIR } from "@intentius/chant/import/parser";
+import type { AlertmanagerConfig, RuleFileConfig } from "../model.js";
+/** A value as a TypeScript expression, starting at column `col`, indented by `indent` spaces. */
+export declare function tsLiteral(v: unknown, indent: number, col?: number): string;
+/** Generate the TypeScript declaring one rule file. */
+export declare function generateRuleFileFiles(file: RuleFileConfig): GeneratedFile[];
+/** A rule group's declaration: the module and variable, and `rules` when it is an `Slo`'s group. */
+export interface GroupDeclaration {
+    readonly path: string;
+    readonly name: string;
+    readonly member?: "rules";
+}
+/**
+ * Generate the TypeScript declaring one rule file, and say where each of its
+ * groups is declared, in the file's order (#2962: a PrometheusRule's
+ * `spec.groups` refers to them).
+ */
+export declare function generateRuleFile(file: RuleFileConfig): {
+    files: GeneratedFile[];
+    groups: GroupDeclaration[];
+};
+/** Generate the TypeScript declaring one `alertmanager.yml`. */
+export declare function generateAlertmanagerFiles(config: AlertmanagerConfig): GeneratedFile[];
+/** The rule file and `alertmanager.yml` TypeScript generator `chant import` runs. */
+export declare class PrometheusGenerator implements TypeScriptGenerator {
+    generate(ir: TemplateIR): GeneratedFile[];
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/import/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/import/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EAIlB,cAAc,EAGf,MAAM,UAAU,CAAC;AAmFlB,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAmB1E;AAyID,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,EAAE,CAE3E;AAED,oGAAoG;AACpG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CA4D7G;AAgCD,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,EAAE,CAmLrF;AAED,qFAAqF;AACrF,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,aAAa,EAAE;CAY1C"}

package/dist/import/parser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Rule file or `alertmanager.yml` -> `TemplateIR`, for `chant import`.
+ *
+ * Either file is one document whose parts name each other (a route names a
+ * receiver and time intervals), so the IR carries the whole file as one
+ * resource and the generator lays out the modules itself, turning those
+ * names into imports of declared entities. Core splits an IR with more than
+ * three resources into one generate() call per category and keeps only the
+ * first file of each, which would lose the imports between a route and the
+ * receivers it names.
+ *
+ * Values are carried as written: `*_file` credential paths, Go templates in
+ * annotations and notifier fields, and literal credentials, which PROM001
+ * then reports in the generated source. What the lexicon has no place for is
+ * named in `warnings`. Two deprecated Alertmanager spellings are rewritten to
+ * the ones Alertmanager treats the same way: `match` / `match_re` (and the
+ * inhibit rules' `source_match*` / `target_match*`) become matcher strings,
+ * and the top-level `mute_time_intervals` list joins `time_intervals`.
+ */
+import type { TemplateIR, TemplateParser } from "@intentius/chant/import/parser";
+import { type AlertmanagerConfig, type RuleFileConfig } from "../model.js";
+/** The IR resource type for a whole rule file. */
+export declare const RULE_FILE_RESOURCE_TYPE = "Prometheus::RuleFile";
+/** The IR resource type for a whole `alertmanager.yml`. */
+export declare const ALERTMANAGER_RESOURCE_TYPE = "Prometheus::Alertmanager::Config";
+/** `properties` of the `Prometheus::RuleFile` resource. */
+export interface RuleFileResourceProperties {
+    file: RuleFileConfig;
+}
+/** `properties` of the `Prometheus::Alertmanager::Config` resource. */
+export interface AlertmanagerResourceProperties {
+    config: AlertmanagerConfig;
+}
+/** What the parser read. */
+export type ParsedPrometheusFile = {
+    kind: "rules";
+    file: RuleFileConfig;
+    warnings: string[];
+} | {
+    kind: "alertmanager";
+    config: AlertmanagerConfig;
+    warnings: string[];
+};
+/** A matcher string Alertmanager parses back to `name op value`. */
+export declare function matcherString(name: string, op: "=" | "=~", value: string): string;
+/** Parse a rule file or `alertmanager.yml`, telling them apart by shape. */
+export declare function parsePrometheusYaml(content: string): ParsedPrometheusFile;
+/** The rule file and `alertmanager.yml` parser `chant import` runs. */
+export declare class PrometheusParser implements TemplateParser {
+    parse(content: string): TemplateIR;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/import/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/import/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAKL,KAAK,kBAAkB,EAKvB,KAAK,cAAc,EAGpB,MAAM,UAAU,CAAC;AAGlB,kDAAkD;AAClD,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAC9D,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAE7E,2DAA2D;AAC3D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,4BAA4B;AAC5B,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAgH7E,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjF;AA4JD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAezE;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,YAAW,cAAc;IACrD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;CAgBnC"}

package/dist/import/slo.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Recognise a rule group that `Slo()` built, so the importer can write the
+ * `Slo` declaration instead of its forty-odd lines of rules.
+ *
+ * The group's name, recorded series, objective and burn-rate alerts give
+ * back candidate props; the candidate is accepted only when `Slo()` builds
+ * it to the same group, rule for rule. Anything else (a hand-edited
+ * threshold, an extra rule, a different description) fails that check and
+ * the group is imported as a plain `RuleGroup`.
+ */
+import { type SloProps } from "../composites/slo.js";
+import { type RuleGroupConfig } from "../model.js";
+/** The `Slo` props that build exactly `group`, or `undefined` when no `Slo()` call does. */
+export declare function recognizeSlo(group: RuleGroupConfig): SloProps | undefined;
+//# sourceMappingURL=slo.d.ts.map

package/dist/import/slo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slo.d.ts","sourceRoot":"","sources":["../../src/import/slo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsE,KAAK,QAAQ,EAAuB,MAAM,mBAAmB,CAAC;AAG3I,OAAO,EAAuF,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AA8DrI,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,GAAG,SAAS,CAiGzE"}