@intentius/chant-lexicon-otel 0.124.45 → 0.124.48

package/dist/model.d.ts

@@ -84,7 +84,7 @@ export interface ComponentTypeAlias {
 }
 /**
  * The renamed built-ins. chant emits `builtin`, which the pinned collector
- * (`COLLECTOR_PIN`, v0.130.0) knows and newer ones still accept. A config
+ * (`COLLECTOR_PIN`) still accepts as each component's deprecated type. A config
  * written for a newer collector may use `type`, so code that reads a config
  * (the importer, the checks, the k8s composites) accepts both.
  */

package/dist/model.js

@@ -60,7 +60,7 @@ export function looksLikeCollectorConfig(value) {
 }
 /**
  * The renamed built-ins. chant emits `builtin`, which the pinned collector
- * (`COLLECTOR_PIN`, v0.130.0) knows and newer ones still accept. A config
+ * (`COLLECTOR_PIN`) still accepts as each component's deprecated type. A config
  * written for a newer collector may use `type`, so code that reads a config
  * (the importer, the checks, the k8s composites) accepts both.
  */

package/dist/okf/index.md

@@ -6,6 +6,7 @@ okf_version: '0.2'
 
 * [AttributesProcessor](/types/AttributesProcessor.md) - OTel::Processor::attributes
 * [BatchProcessor](/types/BatchProcessor.md) - OTel::Processor::batch
+* [ClickHouseExporter](/types/ClickHouseExporter.md) - OTel::Exporter::clickhouse
 * [CountConnector](/types/CountConnector.md) - OTel::Connector::count
 * [DebugExporter](/types/DebugExporter.md) - OTel::Exporter::debug
 * [DeltaToCumulativeProcessor](/types/DeltaToCumulativeProcessor.md) - OTel::Processor::deltatocumulative
@@ -71,3 +72,5 @@ okf_version: '0.2'
 * [OTEL125](/rules/OTEL125.md) - A pipeline sends to a remote otlp or otlphttp exporter without batching
 * [OTEL126](/rules/OTEL126.md) - k8sattributes extracts a metadata field it does not support
 * [OTEL127](/rules/OTEL127.md) - resourcedetection lists a detector that does not exist
+* [OTEL128](/rules/OTEL128.md) - The collector config uses a component the declared Distribution does not build
+* [OTEL129](/rules/OTEL129.md) - A clickhouse exporter writes a table the sql build in the same root does not declare

package/dist/okf/rules/OTEL128.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL128
+description: The collector config uses a component the declared Distribution does not build
+id: OTEL128
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+The collector config uses a component the declared Distribution does not build

package/dist/okf/rules/OTEL129.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL129
+description: A clickhouse exporter writes a table the sql build in the same root does not declare
+id: OTEL129
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+A clickhouse exporter writes a table the sql build in the same root does not declare

package/dist/okf/types/ClickHouseExporter.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: ClickHouseExporter
+description: otel resource type OTel::Exporter::clickhouse
+name: ClickHouseExporter
+lexicon: otel
+resource_type: OTel::Exporter::clickhouse
+---
+`OTel::Exporter::clickhouse`, a resource type of the otel lexicon.

package/dist/op/activities/collector-audit.d.ts

@@ -16,10 +16,12 @@
  *
  * `mode` says what to do with the findings: `report` returns them;
  * `issue` keeps one open issue current; `pull-request` also bumps the pins
- * in the lexicon's `src/define.ts` on a proposal branch and opens (or
+ * (`OTELCOL_CONTRIB_VERSION` in `src/spec/pin.ts` for `COLLECTOR_PIN`, and
+ * `GENAI_SEMCONV_PIN` in `src/define.ts`) on a proposal branch and opens (or
  * edits) a pull request with the findings as its body. Only the pin values
- * change: the config types written against the old pin are the reviewer's
- * to move, which the body says.
+ * change: refreshing the schema snapshot the config types are generated from
+ * (`just snapshot`, #3361) is the reviewer's, which the body says, and
+ * generation refuses until it is done.
  */
 import type { ComponentKind } from "../../model.js";
 import { type CommandRunner } from "./github.js";
@@ -84,11 +86,21 @@ export type Stability = Record<string, string>;
 export declare function parseStability(text: string): Stability | undefined;
 /** Findings for one component, from its stability at the pin and at the newest release. */
 export declare function stabilityFindings(c: BuiltinComponent, atPin: Stability | undefined, atLatest: Stability, pin: string, latest: string): CollectorAuditFinding[];
-/** `src/define.ts` with `COLLECTOR_PIN` and `GENAI_SEMCONV_PIN` moved to the given versions. */
-export declare function bumpPins(text: string, to: {
+/**
+ * The pin files with `COLLECTOR_PIN` and `GENAI_SEMCONV_PIN` moved to the
+ * given versions: `COLLECTOR_PIN` follows `OTELCOL_CONTRIB_VERSION` in
+ * `src/spec/pin.ts`, and `GENAI_SEMCONV_PIN` is in `src/define.ts`.
+ */
+export declare function bumpPins(texts: {
+    define: string;
+    pin: string;
+}, to: {
     collector?: string;
     genai?: string;
-}): string;
+}): {
+    define: string;
+    pin: string;
+};
 export declare function renderCollectorAuditSummary(r: Omit<CollectorAuditResult, "summary" | "mode">): string;
 /** Audit the otel lexicon's pins and its built-in components against upstream releases. */
 export declare function collectorAudit(args?: CollectorAuditArgs): Promise<CollectorAuditResult>;

package/dist/op/activities/collector-audit.d.ts.map

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

package/dist/op/activities/collector-audit.js

@@ -16,10 +16,12 @@
  *
  * `mode` says what to do with the findings: `report` returns them;
  * `issue` keeps one open issue current; `pull-request` also bumps the pins
- * in the lexicon's `src/define.ts` on a proposal branch and opens (or
+ * (`OTELCOL_CONTRIB_VERSION` in `src/spec/pin.ts` for `COLLECTOR_PIN`, and
+ * `GENAI_SEMCONV_PIN` in `src/define.ts`) on a proposal branch and opens (or
  * edits) a pull request with the findings as its body. Only the pin values
- * change: the config types written against the old pin are the reviewer's
- * to move, which the body says.
+ * change: refreshing the schema snapshot the config types are generated from
+ * (`just snapshot`, #3361) is the reviewer's, which the body says, and
+ * generation refuses until it is done.
  */
 import { mkdtempSync, readFileSync } from "node:fs";
 import { tmpdir } from "node:os";
@@ -113,20 +115,26 @@ export function stabilityFindings(c, atPin, atLatest, pin, latest) {
 function behindCount(releases, pin) {
     return releases.filter((r) => compareSemver(r.tag, pin) > 0).length;
 }
-/** `src/define.ts` with `COLLECTOR_PIN` and `GENAI_SEMCONV_PIN` moved to the given versions. */
-export function bumpPins(text, to) {
-    let out = text;
-    const bump = (name, version) => {
-        const re = new RegExp(`(export const ${name}: SchemaPin = Object\\.freeze\\(\\{[^}]*?version:\\s*")([^"]+)(")`);
-        if (!re.test(out))
-            throw new Error(`define.ts has no ${name} with a version to bump`);
-        out = out.replace(re, `$1${version}$3`);
-    };
-    if (to.collector)
-        bump("COLLECTOR_PIN", to.collector);
-    if (to.genai)
-        bump("GENAI_SEMCONV_PIN", to.genai);
-    return out;
+/**
+ * The pin files with `COLLECTOR_PIN` and `GENAI_SEMCONV_PIN` moved to the
+ * given versions: `COLLECTOR_PIN` follows `OTELCOL_CONTRIB_VERSION` in
+ * `src/spec/pin.ts`, and `GENAI_SEMCONV_PIN` is in `src/define.ts`.
+ */
+export function bumpPins(texts, to) {
+    let { define, pin } = texts;
+    if (to.collector) {
+        const re = /(export const OTELCOL_CONTRIB_VERSION = ")([^"]+)(")/;
+        if (!re.test(pin))
+            throw new Error("spec/pin.ts has no OTELCOL_CONTRIB_VERSION (COLLECTOR_PIN) to bump");
+        pin = pin.replace(re, `$1${to.collector}$3`);
+    }
+    if (to.genai) {
+        const re = /(export const GENAI_SEMCONV_PIN: SchemaPin = Object\.freeze\(\{[^}]*?version:\s*")([^"]+)(")/;
+        if (!re.test(define))
+            throw new Error("define.ts has no GENAI_SEMCONV_PIN with a version to bump");
+        define = define.replace(re, `$1${to.genai}$3`);
+    }
+    return { define, pin };
 }
 export function renderCollectorAuditSummary(r) {
     let out = "## Collector audit\n\n";
@@ -197,15 +205,23 @@ export async function collectorAudit(args = {}) {
     const lexiconDir = resolve(args.lexiconDir ?? join(cwd, "lexicons", "otel"));
     const root = (await run("git", ["rev-parse", "--show-toplevel"], lexiconDir)).trim();
     const definePath = join(lexiconDir, "src", "define.ts");
-    const content = bumpPins(readFileSync(definePath, "utf8"), to);
+    const pinPath = join(lexiconDir, "src", "spec", "pin.ts");
+    const bumped = bumpPins({ define: readFileSync(definePath, "utf8"), pin: readFileSync(pinPath, "utf8") }, to);
+    const files = [
+        ...(to.collector ? [{ path: relative(root, pinPath), content: bumped.pin }] : []),
+        ...(to.genai ? [{ path: relative(root, definePath), content: bumped.define }] : []),
+    ];
     const moved = [to.collector ? `COLLECTOR_PIN to ${to.collector}` : "", to.genai ? `GENAI_SEMCONV_PIN to ${to.genai}` : ""].filter(Boolean).join(" and ");
     result.prUrl = await proposePullRequest(run, {
         root,
         branch: args.branch ?? "chant/otel-pins",
         title: `chore(otel): move ${moved}`,
-        body: `${summary}\n\nThis moves the pin values only. The config types, defaults and checks written against ${collector.pin} ` +
-            "still need reading against the release notes before this merges.\n",
-        files: [{ path: relative(root, definePath), content }],
+        body: `${summary}\n\nThis moves the pin values only. ` +
+            (to.collector
+                ? "Run `just snapshot` in lexicons/otel, paste the printed OTEL_SPEC_PIN and regenerate: the config types are generated from the snapshot, and generation refuses a snapshot taken at another version. "
+                : "") +
+            `The defaults and checks written against ${collector.pin} still need reading against the release notes before this merges.\n`,
+        files,
         commitMessage: `chore(otel): move ${moved}`,
         worktreeDir: join(mkdtempSync(join(tmpdir(), "chant-otel-pins-")), "wt"),
     });

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;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aA4GxB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA4C9D;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aAkJxB,CAAC"}

package/dist/plugin.js

@@ -15,6 +15,16 @@ import { compositeCatalog } from "./composites/catalog.js";
 import { DEFAULT_TEMPLATE, GENAI_TEMPLATE, K8S_AGENT_TEMPLATE } from "./init-templates.js";
 import { COLLECTOR_PIN } from "./define.js";
 import { collectorTopologyOf } from "./topology.js";
+import { otelWorkspaceLinks } from "./workspace-links.js";
+/** opentelemetry-collector-releases also tags its tools (`cmd/builder/v0.163.2`); only the plain release tags are distributions. */
+function releaseTag(tag) {
+    return /^v\d+\.\d+\.\d+$/.test(tag) ? tag : null;
+}
+const SNAPSHOT_MOVES = "The schema snapshot and its digest move with the version: set the version in src/spec/pin.ts, run `just snapshot` " +
+    "(lexicons/otel) on a networked machine, paste the printed OTEL_SPEC_PIN into src/spec/pin.ts, run `npm run generate`, " +
+    "and read the diffs of src/spec/otel-schemas.snapshot.json and the generated types. Moving otelcol-contrib also moves " +
+    "COLLECTOR_PIN and COLLECTOR_IMAGE, the default image of the k8s, docker and fly collector composites, so it is a " +
+    "level-0 change that needs an entry on the exceptions list (#2525).";
 const catalogResource = {
     uri: "otel:resource-catalog",
     name: "OpenTelemetry Collector component catalog",
@@ -45,16 +55,44 @@ export const otelPlugin = {
         const { printValidationResult } = await import("@intentius/chant/codegen/validate");
         printValidationResult(await validate());
     },
-    async coverage(_options) {
-        const components = BUILTIN_CATALOG.filter((c) => c.type !== undefined);
-        const byKind = new Map();
-        for (const c of components)
-            byKind.set(c.kind, [...(byKind.get(c.kind) ?? []), c.type]);
-        console.error(`otel: ${components.length} built-in components, typed against ${COLLECTOR_PIN.source} ${COLLECTOR_PIN.version}`);
-        for (const [kind, types] of byKind)
-            console.error(`  ${kind}s: ${types.join(", ")}`);
+    async coverage(options) {
+        const { coverageReport, formatCoverage } = await import("./coverage.js");
+        const report = coverageReport();
+        console.error(formatCoverage(report));
+        if (options?.verbose) {
+            for (const d of report.distributions) {
+                console.error(`  ${d.distribution}, reached through defineComponent: ${[...d.schemaNotBuiltin, ...d.noSchemaNotBuiltin].join(", ")}`);
+            }
+        }
         console.error("  anything else: defineComponent (see docs: custom components)");
     },
+    // #3361: coverage against the otelcol-contrib manifest, offline from the
+    // committed schema snapshot.
+    async coverageReport() {
+        const { coverageReport } = await import("./coverage.js");
+        return coverageReport();
+    },
+    // The distribution manifests the generated config types are scoped by
+    // (#3361): otelcol-contrib, which COLLECTOR_PIN and COLLECTOR_IMAGE follow,
+    // and otelcol-k8s for the coverage report.
+    upstreamPin: {
+        label: "otelcol-contrib",
+        file: "src/spec/pin.ts",
+        pattern: /export const OTELCOL_CONTRIB_VERSION = "([^"]+)"/,
+        replace: (v, line) => line.replace(/= "[^"]+"/, `= "${v}"`),
+        alsoMoves: SNAPSHOT_MOVES,
+        upstream: { owner: "open-telemetry", repo: "opentelemetry-collector-releases", kind: "releases", tagVersion: releaseTag },
+    },
+    upstreamPins: [
+        {
+            label: "otelcol-k8s",
+            file: "src/spec/pin.ts",
+            pattern: /export const OTELCOL_K8S_VERSION = "([^"]+)"/,
+            replace: (v, line) => line.replace(/= "[^"]+"/, `= "${v}"`),
+            alsoMoves: SNAPSHOT_MOVES,
+            upstream: { owner: "open-telemetry", repo: "opentelemetry-collector-releases", kind: "releases", tagVersion: releaseTag },
+        },
+    ],
     async package(options) {
         const { packageLexicon } = await import("./codegen/package.js");
         const { writeBundleSpec } = await import("@intentius/chant/codegen/package");
@@ -77,6 +115,11 @@ export const otelPlugin = {
             return undefined;
         return { collector: topology };
     },
+    // The tables and columns a clickhouse exporter writes, as links to the sql
+    // member that declares them (#4397), for `chant workspace check`.
+    workspaceLinks(entities) {
+        return otelWorkspaceLinks(entities);
+    },
     postSynthChecks() {
         return postSynthChecks;
     },

package/dist/rules/otel-helpers.ts

@@ -68,7 +68,7 @@ export function collectorConfigs(ctx: PostSynthContext): FoundCollectorConfig[]
   return out;
 }
 
-function toDiagnostic(issue: CollectorIssue, found?: Omit<FoundCollectorConfig, "config">): PostSynthDiagnostic {
+export function toDiagnostic(issue: CollectorIssue, found?: Omit<FoundCollectorConfig, "config">): PostSynthDiagnostic {
   const where = found?.configMap
     ? describeConfigMapConfig(found.configMap)
     : found?.operator

package/dist/rules/otel119.ts

@@ -1,7 +1,7 @@
 /**
  * OTEL119: A collector config sets a field deprecated at or before the pinned release
  *
- * `invert_match: true` in a `tail_sampling` policy (inverted decisions are deprecated in collector-contrib v0.126.0 for a `drop` policy), `service.telemetry.metrics.address` (deprecated in collector v0.111.0 for `readers`), and `dimensions_cache_size` on `spanmetrics` (deprecated in collector-contrib v0.125.0 for `aggregation_cardinality_limit`). The collector still reads each at v0.130.0, and a later release drops it.
+ * `invert_match: true` in a `tail_sampling` policy (inverted decisions are deprecated in collector-contrib v0.126.0 for a `drop` policy, and v0.155.0 removed the gate that kept them), `service.telemetry.metrics.address` (deprecated in collector v0.111.0 for `readers`), and `dimensions_cache_size` on `spanmetrics` (deprecated in collector-contrib v0.125.0 for `aggregation_cardinality_limit`). The collector still parses each at v0.162.0, and a later release drops it.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/otel125.ts

@@ -1,7 +1,7 @@
 /**
  * OTEL125: A pipeline sends to a remote otlp or otlphttp exporter without batching
  *
- * No `batch` processor in the pipeline, and the `otlp` or `otlphttp` exporter (non-loopback endpoint) sets no `sending_queue.batch`. At v0.130.0 neither exporter batches by default, so each small request goes out on its own. Other exporters may batch themselves and are not checked.
+ * No `batch` processor in the pipeline, and the `otlp` or `otlphttp` exporter (non-loopback endpoint) sets no `sending_queue.batch`. At v0.162.0 neither exporter batches by default, so each small request goes out on its own. Other exporters may batch themselves and are not checked.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/otel126.ts

@@ -1,7 +1,7 @@
 /**
  * OTEL126: k8sattributes extracts a metadata field it does not support
  *
- * Each name in a `k8sattributes` processor's `extract.metadata` must be one `Config.Validate` accepts at collector-contrib v0.130.0 (`K8S_ATTRIBUTES_METADATA`); the collector refuses any other.
+ * Each name in a `k8sattributes` processor's `extract.metadata` must be one `Config.Validate` accepts at collector-contrib v0.162.0 (`K8S_ATTRIBUTES_METADATA`); the collector refuses any other.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/otel127.ts

@@ -1,7 +1,7 @@
 /**
  * OTEL127: resourcedetection lists a detector that does not exist
  *
- * Each name in a started `resourcedetection` processor's `detectors` must be one the processor registers at collector-contrib v0.130.0 (`RESOURCE_DETECTORS`); any other fails the processor's build and the collector exits.
+ * Each name in a started `resourcedetection` processor's `detectors` must be one the processor registers at collector-contrib v0.162.0 (`RESOURCE_DETECTORS`); any other fails the processor's build and the collector exits.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/otel128.ts

@@ -0,0 +1,22 @@
+/**
+ * OTEL128: The collector config uses a component the declared Distribution does not build
+ *
+ * When a project declares a `Distribution` (an ocb builder manifest), every component a collector config declares must be one the distribution builds; a collector built from it fails at start with "unknown type" otherwise. A project without a `Distribution` is not checked.
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { distributionIssues, isDistributionEntity } from "../../distribution";
+import { collectorConfigs, toDiagnostic } from "./otel-helpers";
+
+export const otel128: PostSynthCheck = {
+  id: "OTEL128",
+  description: "The collector config uses a component the declared Distribution does not build",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    const dist = [...(ctx.entities?.values() ?? [])].find(isDistributionEntity);
+    if (!dist) return [];
+    return collectorConfigs(ctx).flatMap(({ config, ...found }) =>
+      distributionIssues(config, dist).map((i) => toDiagnostic(i, found)),
+    );
+  },
+};

package/dist/rules/otel129.ts

@@ -0,0 +1,99 @@
+/**
+ * OTEL129: A clickhouse exporter writes a table the sql build in the same root does not declare
+ *
+ * When the build root also declares ClickHouse tables with the sql lexicon, every table a `clickhouse` exporter writes (for the signals whose pipelines use it) must be one of them, in the database the exporter writes to, with every column the exporter's insert statement names. A renamed or dropped table fails here instead of at the exporter's first insert. When `create_schema` is true (the exporter's default) for tables the build declares, it warns: the exporter would run its own `CREATE TABLE IF NOT EXISTS` beside the sql lexicon's plan. A build root with no sql ClickHouse tables is not checked. Sees one build root at a time (#1939); across workspace members the otel lexicon's workspace links check the same tables (#3931).
+ */
+
+import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import type { Declarable } from "@intentius/chant/declarable";
+import { clickhouseExportersOf } from "../../clickhouse-tables";
+import { collectorConfigs } from "./otel-helpers";
+
+/** The sql lexicon's ClickHouse table entity type, matched by name so otel needs no dependency on the sql lexicon. */
+const CLICKHOUSE_TABLE = "ClickHouse::Table";
+
+interface DeclaredTable {
+  columns: Set<string>;
+}
+
+/** Every ClickHouse table the build declares, by `database.name`. */
+export function declaredClickHouseTables(entities: Iterable<Declarable>): Map<string, DeclaredTable> {
+  const out = new Map<string, DeclaredTable>();
+  for (const e of entities) {
+    if (e.entityType !== CLICKHOUSE_TABLE) continue;
+    const props = (e as unknown as { props?: { name?: unknown; database?: unknown; columns?: unknown } }).props;
+    if (typeof props?.name !== "string") continue;
+    const database = typeof props.database === "string" && props.database !== "" ? props.database : "default";
+    const columns = new Set<string>();
+    for (const c of Array.isArray(props.columns) ? props.columns : []) {
+      const name = (c as { name?: unknown })?.name;
+      if (typeof name === "string") columns.add(name);
+    }
+    out.set(`${database}.${props.name}`, { columns });
+  }
+  return out;
+}
+
+/** A column the insert names is declared as itself, or as the flattened fields of a Nested column (`Events.Timestamp`). */
+function hasColumn(declared: Set<string>, column: string): boolean {
+  if (declared.has(column)) return true;
+  for (const c of declared) if (c.startsWith(`${column}.`)) return true;
+  return false;
+}
+
+export const otel129: PostSynthCheck = {
+  id: "OTEL129",
+  description: "A clickhouse exporter writes a table the sql build in the same root does not declare",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    const declared = declaredClickHouseTables(ctx.entities?.values() ?? []);
+    if (declared.size === 0) return [];
+    const known = [...declared.keys()].sort();
+    const diagnostics: PostSynthDiagnostic[] = [];
+    for (const { config } of collectorConfigs(ctx)) {
+      for (const exp of clickhouseExportersOf(config)) {
+        const createsDeclared: string[] = [];
+        for (const t of exp.tables) {
+          const qualified = `${exp.database}.${t.name}`;
+          const table = declared.get(qualified);
+          if (!table) {
+            diagnostics.push({
+              checkId: "OTEL129",
+              severity: "error",
+              message:
+                `exporter ${exp.id} writes ${t.signal} to ${qualified} (${t.key}), which the sql build does not declare. ` +
+                `Declare it (OtelTables from @intentius/chant-lexicon-sql/clickhouse declares the exporter's tables) or point ${t.key} at a declared table. ` +
+                `Declared ClickHouse tables: ${known.join(", ")}`,
+              entity: exp.id,
+              lexicon: "otel",
+            });
+            continue;
+          }
+          const missing = t.columns.filter((c) => !hasColumn(table.columns, c));
+          if (missing.length > 0) {
+            diagnostics.push({
+              checkId: "OTEL129",
+              severity: "error",
+              message: `exporter ${exp.id} inserts ${t.signal} into ${qualified} with column${missing.length === 1 ? "" : "s"} ${missing.join(", ")}, which the declared table does not have; the insert would fail`,
+              entity: exp.id,
+              lexicon: "otel",
+            });
+          }
+          createsDeclared.push(qualified);
+        }
+        if (exp.createSchema && createsDeclared.length > 0) {
+          diagnostics.push({
+            checkId: "OTEL129",
+            severity: "warning",
+            message:
+              `exporter ${exp.id} has create_schema true (the default), so at start it runs CREATE TABLE IF NOT EXISTS for ${createsDeclared.join(", ")}, which the sql build declares. ` +
+              `Set create_schema: false so the sql lexicon alone manages them`,
+            entity: exp.id,
+            lexicon: "otel",
+          });
+        }
+      }
+    }
+    return diagnostics;
+  },
+};

package/dist/serializer.d.ts

@@ -7,6 +7,9 @@
  * the order they are declared in, and each component's config keeps the key
  * order it was written in, since collector docs and diffs read that way.
  *
+ * A project that declares a `Distribution` also gets the ocb builder manifest,
+ * as `builder-config.yaml` beside the config (see `distribution.ts`).
+ *
  * A collector config has no metadata channel, so there is no ownership marker
  * to stamp. A custom component's schema pin is written as a `# chant:` comment
  * line above the config (see `define.ts`).

package/dist/serializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,6BAA6B,CAAC;AAKhF,eAAO,MAAM,cAAc,EAAE,UAU5B,CAAC"}
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,6BAA6B,CAAC;AAMhF,eAAO,MAAM,cAAc,EAAE,UAe5B,CAAC"}

package/dist/serializer.js

@@ -7,20 +7,30 @@
  * the order they are declared in, and each component's config keeps the key
  * order it was written in, since collector docs and diffs read that way.
  *
+ * A project that declares a `Distribution` also gets the ocb builder manifest,
+ * as `builder-config.yaml` beside the config (see `distribution.ts`).
+ *
  * A collector config has no metadata channel, so there is no ownership marker
  * to stamp. A custom component's schema pin is written as a `# chant:` comment
  * line above the config (see `define.ts`).
  */
 import { buildCollectorConfig } from "./collector.js";
 import { emitCollectorYaml } from "./yaml.js";
+import { DISTRIBUTION_MANIFEST_FILE, distributionYaml, isDistributionEntity } from "./distribution.js";
 export const otelSerializer = {
     name: "otel",
     rulePrefix: "OTEL",
     serialize(entities, _outputs) {
         const built = buildCollectorConfig(entities);
         const yaml = emitCollectorYaml(built.config, { header: built.header });
-        if (built.warnings.length === 0)
+        const warnings = [...built.warnings];
+        // A declared Distribution (#3374) adds the ocb builder manifest beside the config.
+        const distributions = [...entities.values()].filter(isDistributionEntity);
+        if (distributions.length > 1)
+            warnings.push("otel: more than one Distribution is declared; the first one is written");
+        const files = distributions.length > 0 ? { [DISTRIBUTION_MANIFEST_FILE]: distributionYaml(distributions[0]) } : undefined;
+        if (warnings.length === 0 && !files)
             return yaml;
-        return { primary: yaml, warnings: built.warnings };
+        return { primary: yaml, ...(files ? { files } : {}), ...(warnings.length > 0 ? { warnings } : {}) };
     },
 };

package/dist/spec/builtins.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The built-in components, as the schema snapshot and the generator see them:
+ * class name, kind and collector type. Kept apart from `../components` so the
+ * snapshot refresh and generation load no component code (the components
+ * import the types generation writes). `builtins.test.ts` holds this list to
+ * the exported classes.
+ */
+import type { ComponentKind } from "../model.js";
+export interface BuiltinSpec {
+    /** The exported class, e.g. `OtlpReceiver`. The generated config type is `<className>SchemaConfig`. */
+    className: string;
+    kind: ComponentKind;
+    /** The type the class writes, which may be the older name of a renamed component. */
+    type: string;
+}
+export declare const BUILTIN_SPECS: readonly BuiltinSpec[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/spec/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/spec/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,uGAAuG;IACvG,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAqC/C,CAAC"}

package/dist/spec/builtins.js

@@ -0,0 +1,45 @@
+/**
+ * The built-in components, as the schema snapshot and the generator see them:
+ * class name, kind and collector type. Kept apart from `../components` so the
+ * snapshot refresh and generation load no component code (the components
+ * import the types generation writes). `builtins.test.ts` holds this list to
+ * the exported classes.
+ */
+export const BUILTIN_SPECS = [
+    { className: "OtlpReceiver", kind: "receiver", type: "otlp" },
+    { className: "PrometheusReceiver", kind: "receiver", type: "prometheus" },
+    { className: "HostMetricsReceiver", kind: "receiver", type: "hostmetrics" },
+    { className: "FileLogReceiver", kind: "receiver", type: "filelog" },
+    { className: "K8sClusterReceiver", kind: "receiver", type: "k8s_cluster" },
+    { className: "KubeletStatsReceiver", kind: "receiver", type: "kubeletstats" },
+    { className: "BatchProcessor", kind: "processor", type: "batch" },
+    { className: "MemoryLimiterProcessor", kind: "processor", type: "memory_limiter" },
+    { className: "ResourceProcessor", kind: "processor", type: "resource" },
+    { className: "AttributesProcessor", kind: "processor", type: "attributes" },
+    { className: "K8sAttributesProcessor", kind: "processor", type: "k8sattributes" },
+    { className: "ResourceDetectionProcessor", kind: "processor", type: "resourcedetection" },
+    { className: "DeltaToCumulativeProcessor", kind: "processor", type: "deltatocumulative" },
+    { className: "FilterProcessor", kind: "processor", type: "filter" },
+    { className: "TransformProcessor", kind: "processor", type: "transform" },
+    { className: "RedactionProcessor", kind: "processor", type: "redaction" },
+    { className: "TailSamplingProcessor", kind: "processor", type: "tail_sampling" },
+    { className: "ProbabilisticSamplerProcessor", kind: "processor", type: "probabilistic_sampler" },
+    { className: "OtlpExporter", kind: "exporter", type: "otlp" },
+    { className: "OtlpHttpExporter", kind: "exporter", type: "otlphttp" },
+    { className: "DebugExporter", kind: "exporter", type: "debug" },
+    { className: "PrometheusExporter", kind: "exporter", type: "prometheus" },
+    { className: "GoogleCloudExporter", kind: "exporter", type: "googlecloud" },
+    { className: "ClickHouseExporter", kind: "exporter", type: "clickhouse" },
+    { className: "LoadBalancingExporter", kind: "exporter", type: "loadbalancing" },
+    { className: "SpanMetricsConnector", kind: "connector", type: "spanmetrics" },
+    { className: "ServiceGraphConnector", kind: "connector", type: "servicegraph" },
+    { className: "RoutingConnector", kind: "connector", type: "routing" },
+    { className: "ForwardConnector", kind: "connector", type: "forward" },
+    { className: "CountConnector", kind: "connector", type: "count" },
+    { className: "SumConnector", kind: "connector", type: "sum" },
+    { className: "SignalToMetricsConnector", kind: "connector", type: "signaltometrics" },
+    { className: "HealthCheckExtension", kind: "extension", type: "health_check" },
+    { className: "PprofExtension", kind: "extension", type: "pprof" },
+    { className: "ZPagesExtension", kind: "extension", type: "zpages" },
+    { className: "K8sLeaderElectorExtension", kind: "extension", type: "k8s_leader_elector" },
+];