autotel-schema 10.0.0 → 11.0.1

package/dist/cli.cjs

@@ -27,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_snapshot = require('./snapshot-CyWGJaJT.cjs');
+const require_snapshot = require('./snapshot-BJmrOlMK.cjs');
 const require_diff = require('./diff.cjs');
 let node_fs = require("node:fs");
 let node_path = require("node:path");

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as parseSnapshot } from "./snapshot-h8pb_Up_.js";
+import { n as parseSnapshot } from "./snapshot-BFIxChH0.js";
 import { diffSnapshots, formatDiff, hasBreakingChanges } from "./diff.js";
 import { readFileSync } from "node:fs";
 import path from "node:path";

package/dist/{contract-Ymh_Q37N.d.cts → contract-CfOaZcD0.d.cts}

@@ -1,50 +1,51 @@
-//#region src/scenario.d.ts
+//#region src/validate.d.ts
+/** Severity of a contract violation. `error` = a breaking-shaped problem. */
+type ViolationSeverity = 'error' | 'warning';
+type ViolationCode = 'unknown_span' | 'unknown_attribute' | 'type_mismatch' | 'missing_required' | 'deprecated_attribute' | 'enum_violation';
+/** A single discrepancy between an emitted span and the contract. */
+interface SchemaViolation {
+  code: ViolationCode;
+  severity: ViolationSeverity;
+  spanName: string;
+  /** Attribute key involved, when the violation is attribute-scoped. */
+  attribute?: string;
+  message: string;
+  /** Nearest declared key, for likely typos (`unknown_attribute` only). */
+  suggestion?: string;
+}
+/** What an attribute can hold once a span has been emitted. */
+type EmittedAttributeValue = string | number | boolean | null | undefined | Array<string | number | boolean | null | undefined>;
 /**
- * Scenario conformance — a flow-level contract checked against collected spans.
- *
- * Where {@link ./contract} declares the *surface* of your telemetry (span
- * names + attributes), a scenario declares the *behaviour* of one exercised
- * flow: which events must fire, how many times, in what parent/child
- * topology, and — critically — **when the observation is complete**, because
- * for an async flow a missing event and an event that has not fired *yet* are
- * indistinguishable without a completion boundary.
- *
- * Checking a scenario yields one of three outcomes, not two:
- *
- * - `conformant` — the boundary closed and the signature satisfied the contract
- * - `non-conformant` — required behaviour was missing or invalid (definitive)
- * - `incomplete` — the boundary did not close within the observation budget;
- *   infrastructure slowness is *not* reported as behavioural regression
- *
- * Absence is definitive only after closure (closed-world semantics). Excess
- * is definitive immediately: a `max` cardinality violation or an unexpected
- * error span fails the check even while the flow is still open.
- *
- * Undeclared events are **additive**: reported in `result.additions`, never a
- * failure — improving instrumentation must not break CI.
- *
- * The span input shape is structurally compatible with `SerializedSpan` from
- * `autotel/test-span-collector`, so a test can feed a collector's output
- * straight in. Like the rest of this package the module is dependency-free —
- * usable from vitest, a deferred reconciliation job, or a CLI alike.
- *
- * @example
- * ```ts
- * const result = await checkScenario(
- *   contract.scenarios!['transfer.accept'],
- *   () => collector.peekTrace(traceId),
- *   { name: 'transfer.accept' },
- * );
- * if (result.outcome === 'non-conformant') throw new Error(formatScenarioResult(result));
- * ```
+ * A span as this package receives it for validation — just enough of one to
+ * check against a schema, which avoids a hard dependency on the OTel SDK.
+ */
+interface EmittedSpan {
+  name: string;
+  attributes: Record<string, EmittedAttributeValue>;
+}
+interface ValidateOptions {
+  /** Report `unknown_span` for span names not in the contract. Default `false`. */
+  strictSpanNames?: boolean;
+}
+/**
+ * Validate one emitted span against the contract, returning every discrepancy.
+ * Order is deterministic: required-but-missing first, then per-attribute checks
+ * in attribute insertion order.
  */
+declare function validateSpan(span: EmittedSpan, contract: TelemetryContract, options?: ValidateOptions): SchemaViolation[];
+/** `true` when any violation is `error` severity. */
+declare function hasErrors(violations: SchemaViolation[]): boolean;
+/** One-line human/agent-readable rendering of a violation. */
+declare function formatViolation(v: SchemaViolation): string;
+//#endregion
+//#region src/scenario.d.ts
 /** A finished span/event as the scenario checker sees it. */
 interface ScenarioSpan {
   spanId: string;
   parentSpanId?: string;
   name: string;
   status: 'ok' | 'error' | 'unset';
-  attributes?: Record<string, unknown>;
+  attributes?: Record<string, EmittedAttributeValue>;
   /** Epoch ms. Optional — used by {@link proposeScenario} to suggest budgets. */
   startTimeMs?: number;
   durationMs?: number;
@@ -301,4 +302,4 @@ declare function resolveAttributeSpec(contract: TelemetryContract, spanName: str
 /** Whether attributes outside the declared set are tolerated for a span. */
 declare function allowsAdditionalAttributes(contract: TelemetryContract, spanName: string): boolean;
 //#endregion
-export { validateScenarioSpec as A, ScenarioViolationCode as C, isScenarioClosed as D, formatScenarioResult as E, parseCardinality as O, ScenarioViolation as S, evaluateScenario as T, ScenarioOutcome as _, SpanSpec as a, ScenarioSpan as b, allowsAdditionalAttributes as c, Cardinality as d, CheckScenarioOptions as f, ScenarioEventSpec as g, ScenarioAddition as h, STABILITIES as i, proposeScenario as k, defineContract as l, EvaluateScenarioOptions as m, AttributeSpec as n, Stability as o, CompletionBoundary as p, AttributeType as r, TelemetryContract as s, ATTRIBUTE_TYPES as t, resolveAttributeSpec as u, ScenarioProposal as v, checkScenario as w, ScenarioSpec as x, ScenarioResult as y };
+export { validateScenarioSpec as A, ScenarioViolationCode as C, isScenarioClosed as D, formatScenarioResult as E, ViolationCode as F, ViolationSeverity as I, formatViolation as L, EmittedSpan as M, SchemaViolation as N, parseCardinality as O, ValidateOptions as P, hasErrors as R, ScenarioViolation as S, evaluateScenario as T, ScenarioOutcome as _, SpanSpec as a, ScenarioSpan as b, allowsAdditionalAttributes as c, Cardinality as d, CheckScenarioOptions as f, ScenarioEventSpec as g, ScenarioAddition as h, STABILITIES as i, EmittedAttributeValue as j, proposeScenario as k, defineContract as l, EvaluateScenarioOptions as m, AttributeSpec as n, Stability as o, CompletionBoundary as p, AttributeType as r, TelemetryContract as s, ATTRIBUTE_TYPES as t, resolveAttributeSpec as u, ScenarioProposal as v, checkScenario as w, ScenarioSpec as x, ScenarioResult as y, validateSpan as z };

package/dist/{contract-Ymh_Q37N.d.ts → contract-CfOaZcD0.d.ts}

@@ -1,50 +1,51 @@
-//#region src/scenario.d.ts
+//#region src/validate.d.ts
+/** Severity of a contract violation. `error` = a breaking-shaped problem. */
+type ViolationSeverity = 'error' | 'warning';
+type ViolationCode = 'unknown_span' | 'unknown_attribute' | 'type_mismatch' | 'missing_required' | 'deprecated_attribute' | 'enum_violation';
+/** A single discrepancy between an emitted span and the contract. */
+interface SchemaViolation {
+  code: ViolationCode;
+  severity: ViolationSeverity;
+  spanName: string;
+  /** Attribute key involved, when the violation is attribute-scoped. */
+  attribute?: string;
+  message: string;
+  /** Nearest declared key, for likely typos (`unknown_attribute` only). */
+  suggestion?: string;
+}
+/** What an attribute can hold once a span has been emitted. */
+type EmittedAttributeValue = string | number | boolean | null | undefined | Array<string | number | boolean | null | undefined>;
 /**
- * Scenario conformance — a flow-level contract checked against collected spans.
- *
- * Where {@link ./contract} declares the *surface* of your telemetry (span
- * names + attributes), a scenario declares the *behaviour* of one exercised
- * flow: which events must fire, how many times, in what parent/child
- * topology, and — critically — **when the observation is complete**, because
- * for an async flow a missing event and an event that has not fired *yet* are
- * indistinguishable without a completion boundary.
- *
- * Checking a scenario yields one of three outcomes, not two:
- *
- * - `conformant` — the boundary closed and the signature satisfied the contract
- * - `non-conformant` — required behaviour was missing or invalid (definitive)
- * - `incomplete` — the boundary did not close within the observation budget;
- *   infrastructure slowness is *not* reported as behavioural regression
- *
- * Absence is definitive only after closure (closed-world semantics). Excess
- * is definitive immediately: a `max` cardinality violation or an unexpected
- * error span fails the check even while the flow is still open.
- *
- * Undeclared events are **additive**: reported in `result.additions`, never a
- * failure — improving instrumentation must not break CI.
- *
- * The span input shape is structurally compatible with `SerializedSpan` from
- * `autotel/test-span-collector`, so a test can feed a collector's output
- * straight in. Like the rest of this package the module is dependency-free —
- * usable from vitest, a deferred reconciliation job, or a CLI alike.
- *
- * @example
- * ```ts
- * const result = await checkScenario(
- *   contract.scenarios!['transfer.accept'],
- *   () => collector.peekTrace(traceId),
- *   { name: 'transfer.accept' },
- * );
- * if (result.outcome === 'non-conformant') throw new Error(formatScenarioResult(result));
- * ```
+ * A span as this package receives it for validation — just enough of one to
+ * check against a schema, which avoids a hard dependency on the OTel SDK.
+ */
+interface EmittedSpan {
+  name: string;
+  attributes: Record<string, EmittedAttributeValue>;
+}
+interface ValidateOptions {
+  /** Report `unknown_span` for span names not in the contract. Default `false`. */
+  strictSpanNames?: boolean;
+}
+/**
+ * Validate one emitted span against the contract, returning every discrepancy.
+ * Order is deterministic: required-but-missing first, then per-attribute checks
+ * in attribute insertion order.
  */
+declare function validateSpan(span: EmittedSpan, contract: TelemetryContract, options?: ValidateOptions): SchemaViolation[];
+/** `true` when any violation is `error` severity. */
+declare function hasErrors(violations: SchemaViolation[]): boolean;
+/** One-line human/agent-readable rendering of a violation. */
+declare function formatViolation(v: SchemaViolation): string;
+//#endregion
+//#region src/scenario.d.ts
 /** A finished span/event as the scenario checker sees it. */
 interface ScenarioSpan {
   spanId: string;
   parentSpanId?: string;
   name: string;
   status: 'ok' | 'error' | 'unset';
-  attributes?: Record<string, unknown>;
+  attributes?: Record<string, EmittedAttributeValue>;
   /** Epoch ms. Optional — used by {@link proposeScenario} to suggest budgets. */
   startTimeMs?: number;
   durationMs?: number;
@@ -301,4 +302,4 @@ declare function resolveAttributeSpec(contract: TelemetryContract, spanName: str
 /** Whether attributes outside the declared set are tolerated for a span. */
 declare function allowsAdditionalAttributes(contract: TelemetryContract, spanName: string): boolean;
 //#endregion
-export { validateScenarioSpec as A, ScenarioViolationCode as C, isScenarioClosed as D, formatScenarioResult as E, parseCardinality as O, ScenarioViolation as S, evaluateScenario as T, ScenarioOutcome as _, SpanSpec as a, ScenarioSpan as b, allowsAdditionalAttributes as c, Cardinality as d, CheckScenarioOptions as f, ScenarioEventSpec as g, ScenarioAddition as h, STABILITIES as i, proposeScenario as k, defineContract as l, EvaluateScenarioOptions as m, AttributeSpec as n, Stability as o, CompletionBoundary as p, AttributeType as r, TelemetryContract as s, ATTRIBUTE_TYPES as t, resolveAttributeSpec as u, ScenarioProposal as v, checkScenario as w, ScenarioSpec as x, ScenarioResult as y };
+export { validateScenarioSpec as A, ScenarioViolationCode as C, isScenarioClosed as D, formatScenarioResult as E, ViolationCode as F, ViolationSeverity as I, formatViolation as L, EmittedSpan as M, SchemaViolation as N, parseCardinality as O, ValidateOptions as P, hasErrors as R, ScenarioViolation as S, evaluateScenario as T, ScenarioOutcome as _, SpanSpec as a, ScenarioSpan as b, allowsAdditionalAttributes as c, Cardinality as d, CheckScenarioOptions as f, ScenarioEventSpec as g, ScenarioAddition as h, STABILITIES as i, EmittedAttributeValue as j, proposeScenario as k, defineContract as l, EvaluateScenarioOptions as m, AttributeSpec as n, Stability as o, CompletionBoundary as p, AttributeType as r, TelemetryContract as s, ATTRIBUTE_TYPES as t, resolveAttributeSpec as u, ScenarioProposal as v, checkScenario as w, ScenarioSpec as x, ScenarioResult as y, validateSpan as z };

package/dist/{diff-CfvhW7ux.d.cts → diff-B9GL_E28.d.cts}

@@ -1,4 +1,4 @@
-import { o as Stability, r as AttributeType, s as TelemetryContract } from "./contract-Ymh_Q37N.cjs";
+import { o as Stability, r as AttributeType, s as TelemetryContract } from "./contract-CfOaZcD0.cjs";
 //#region src/attrs.d.ts
 /**
  * Wire constants for the schema contract — the keys autotel-schema reads from

package/dist/{diff-CAIC04O4.d.ts → diff-DenUg42T.d.ts}

@@ -1,4 +1,4 @@
-import { o as Stability, r as AttributeType, s as TelemetryContract } from "./contract-Ymh_Q37N.js";
+import { o as Stability, r as AttributeType, s as TelemetryContract } from "./contract-CfOaZcD0.js";
 //#region src/attrs.d.ts
 /**
  * Wire constants for the schema contract — the keys autotel-schema reads from

package/dist/diff.cjs

@@ -6,32 +6,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 * six transitions are explicit and auditable — no silent fall-through. Same-
 * stability transitions are absent (no change to report).
 */
-const STABILITY_TRANSITIONS = {
-	"stable->experimental": {
+const STABILITY_TRANSITIONS = /* @__PURE__ */ new Map([
+	["stable->experimental", {
 		kind: "breaking",
 		type: "stability_downgraded"
-	},
-	"stable->deprecated": {
+	}],
+	["stable->deprecated", {
 		kind: "additive",
 		type: "deprecated"
-	},
-	"experimental->stable": {
+	}],
+	["experimental->stable", {
 		kind: "neutral",
 		type: "stability_advanced"
-	},
-	"experimental->deprecated": {
+	}],
+	["experimental->deprecated", {
 		kind: "additive",
 		type: "deprecated"
-	},
-	"deprecated->stable": {
+	}],
+	["deprecated->stable", {
 		kind: "neutral",
 		type: "stability_advanced"
-	},
-	"deprecated->experimental": {
+	}],
+	["deprecated->experimental", {
 		kind: "breaking",
 		type: "stability_downgraded"
-	}
-};
+	}]
+]);
 function stabilityMessage(type, attribute, prev, next) {
 	if (type === "deprecated") return `attribute "${attribute}" was deprecated${next.replacedBy ? ` (use "${next.replacedBy}")` : ""}`;
 	if (type === "stability_downgraded") return `attribute "${attribute}" stability downgraded ${prev.stability} → ${next.stability}`;
@@ -85,7 +85,7 @@ function diffAttribute(diff, span, attribute, prev, next) {
 		});
 	}
 	if (prev.stability !== next.stability) {
-		const transition = STABILITY_TRANSITIONS[`${prev.stability}->${next.stability}`];
+		const transition = STABILITY_TRANSITIONS.get(`${prev.stability}->${next.stability}`);
 		if (transition) push(diff, {
 			...transition,
 			span,

package/dist/diff.d.cts

@@ -1,2 +1,2 @@
-import { a as diffSnapshots, i as SnapshotDiff, n as ChangeType, o as formatDiff, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind } from "./diff-CfvhW7ux.cjs";
+import { a as diffSnapshots, i as SnapshotDiff, n as ChangeType, o as formatDiff, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind } from "./diff-B9GL_E28.cjs";
 export { ChangeKind, ChangeType, SnapshotChange, SnapshotDiff, diffSnapshots, formatDiff, hasBreakingChanges };

package/dist/diff.d.ts

@@ -1,2 +1,2 @@
-import { a as diffSnapshots, i as SnapshotDiff, n as ChangeType, o as formatDiff, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind } from "./diff-CAIC04O4.js";
+import { a as diffSnapshots, i as SnapshotDiff, n as ChangeType, o as formatDiff, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind } from "./diff-DenUg42T.js";
 export { ChangeKind, ChangeType, SnapshotChange, SnapshotDiff, diffSnapshots, formatDiff, hasBreakingChanges };

package/dist/diff.js

@@ -4,32 +4,32 @@
 * six transitions are explicit and auditable — no silent fall-through. Same-
 * stability transitions are absent (no change to report).
 */
-const STABILITY_TRANSITIONS = {
-	"stable->experimental": {
+const STABILITY_TRANSITIONS = /* @__PURE__ */ new Map([
+	["stable->experimental", {
 		kind: "breaking",
 		type: "stability_downgraded"
-	},
-	"stable->deprecated": {
+	}],
+	["stable->deprecated", {
 		kind: "additive",
 		type: "deprecated"
-	},
-	"experimental->stable": {
+	}],
+	["experimental->stable", {
 		kind: "neutral",
 		type: "stability_advanced"
-	},
-	"experimental->deprecated": {
+	}],
+	["experimental->deprecated", {
 		kind: "additive",
 		type: "deprecated"
-	},
-	"deprecated->stable": {
+	}],
+	["deprecated->stable", {
 		kind: "neutral",
 		type: "stability_advanced"
-	},
-	"deprecated->experimental": {
+	}],
+	["deprecated->experimental", {
 		kind: "breaking",
 		type: "stability_downgraded"
-	}
-};
+	}]
+]);
 function stabilityMessage(type, attribute, prev, next) {
 	if (type === "deprecated") return `attribute "${attribute}" was deprecated${next.replacedBy ? ` (use "${next.replacedBy}")` : ""}`;
 	if (type === "stability_downgraded") return `attribute "${attribute}" stability downgraded ${prev.stability} → ${next.stability}`;
@@ -83,7 +83,7 @@ function diffAttribute(diff, span, attribute, prev, next) {
 		});
 	}
 	if (prev.stability !== next.stability) {
-		const transition = STABILITY_TRANSITIONS[`${prev.stability}->${next.stability}`];
+		const transition = STABILITY_TRANSITIONS.get(`${prev.stability}->${next.stability}`);
 		if (transition) push(diff, {
 			...transition,
 			span,

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_snapshot = require('./snapshot-CyWGJaJT.cjs');
-const require_processor = require('./processor-Gu8Yl_dS.cjs');
+const require_snapshot = require('./snapshot-BJmrOlMK.cjs');
+const require_processor = require('./processor-C9NmN0wQ.cjs');
 const require_diff = require('./diff.cjs');
 
 //#region src/completeness.ts

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { a as diffSnapshots, c as ContractSnapshot, d as contractToSnapshot, f as parseSnapshot, g as SchemaAttributeKey, h as SNAPSHOT_SPEC, i as SnapshotDiff, l as SnapshotAttribute, m as SCHEMA_ATTRS, n as ChangeType, o as formatDiff, p as serializeSnapshot, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind, u as SnapshotSpan } from "./diff-CfvhW7ux.cjs";
-import { A as validateScenarioSpec, C as ScenarioViolationCode, D as isScenarioClosed, E as formatScenarioResult, O as parseCardinality, S as ScenarioViolation, T as evaluateScenario, _ as ScenarioOutcome, a as SpanSpec, b as ScenarioSpan, c as allowsAdditionalAttributes, d as Cardinality, f as CheckScenarioOptions, g as ScenarioEventSpec, h as ScenarioAddition, i as STABILITIES, k as proposeScenario, l as defineContract, m as EvaluateScenarioOptions, n as AttributeSpec, o as Stability, p as CompletionBoundary, r as AttributeType, s as TelemetryContract, t as ATTRIBUTE_TYPES, u as resolveAttributeSpec, v as ScenarioProposal, w as checkScenario, x as ScenarioSpec, y as ScenarioResult } from "./contract-Ymh_Q37N.cjs";
-import { a as SchemaValidationSpanProcessor, c as createSchemaValidationProcessor, d as ValidateOptions, f as ViolationCode, g as validateSpan, h as hasErrors, i as SchemaValidationProcessorOptions, l as SchemaViolation, m as formatViolation, n as ReadableSpanLike, o as SpanLike, p as ViolationSeverity, r as SchemaProcessorMode, s as SpanProcessorLike, t as OtelContext, u as SpanShape } from "./processor-DVcsS6Rz.cjs";
+import { a as diffSnapshots, c as ContractSnapshot, d as contractToSnapshot, f as parseSnapshot, g as SchemaAttributeKey, h as SNAPSHOT_SPEC, i as SnapshotDiff, l as SnapshotAttribute, m as SCHEMA_ATTRS, n as ChangeType, o as formatDiff, p as serializeSnapshot, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind, u as SnapshotSpan } from "./diff-B9GL_E28.cjs";
+import { A as validateScenarioSpec, C as ScenarioViolationCode, D as isScenarioClosed, E as formatScenarioResult, F as ViolationCode, I as ViolationSeverity, L as formatViolation, M as EmittedSpan, N as SchemaViolation, O as parseCardinality, P as ValidateOptions, R as hasErrors, S as ScenarioViolation, T as evaluateScenario, _ as ScenarioOutcome, a as SpanSpec, b as ScenarioSpan, c as allowsAdditionalAttributes, d as Cardinality, f as CheckScenarioOptions, g as ScenarioEventSpec, h as ScenarioAddition, i as STABILITIES, j as EmittedAttributeValue, k as proposeScenario, l as defineContract, m as EvaluateScenarioOptions, n as AttributeSpec, o as Stability, p as CompletionBoundary, r as AttributeType, s as TelemetryContract, t as ATTRIBUTE_TYPES, u as resolveAttributeSpec, v as ScenarioProposal, w as checkScenario, x as ScenarioSpec, y as ScenarioResult, z as validateSpan } from "./contract-CfOaZcD0.cjs";
+import { OtelContext, ReadableSpanLike, SchemaProcessorMode, SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, SpanLike, SpanProcessorLike, createSchemaValidationProcessor } from "./processor.cjs";
 //#region src/completeness.d.ts
 /** The ten fields a GenAI trace is scored on. */
 declare const GENAI_COMPLETENESS_FIELDS: readonly ["llm_input", "llm_output", "model_name", "token_usage", "cost_usd", "latency_per_span", "tool_call_args", "tool_call_results", "span_tree", "span_count"];
@@ -66,4 +66,4 @@ declare function isHighCardinalityKey(contract: TelemetryContract, key: string):
  */
 declare const AGENT_SECURITY_TELEMETRY_CONTRACT: TelemetryContract;
 //#endregion
-export { AGENT_SECURITY_TELEMETRY_CONTRACT, ATTRIBUTE_TYPES, type AttributeSpec, type AttributeType, type Cardinality, type ChangeKind, type ChangeType, type CheckScenarioOptions, type CompletenessResult, type CompletionBoundary, type ContractSnapshot, type EvaluateScenarioOptions, type FieldScore, GENAI_COMPLETENESS_FIELDS, type GenAiCompletenessField, type OtelContext, type ReadableSpanLike, SCHEMA_ATTRS, SNAPSHOT_SPEC, STABILITIES, type ScenarioAddition, type ScenarioEventSpec, type ScenarioOutcome, type ScenarioProposal, type ScenarioResult, type ScenarioSpan, type ScenarioSpec, type ScenarioViolation, type ScenarioViolationCode, type SchemaAttributeKey, type SchemaProcessorMode, type SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, type SchemaViolation, type SnapshotAttribute, type SnapshotChange, type SnapshotDiff, type SnapshotSpan, type SpanLike, type SpanProcessorLike, type SpanShape, type SpanSpec, type Stability, type TelemetryContract, type ValidateOptions, type ViolationCode, type ViolationSeverity, allowsAdditionalAttributes, checkScenario, contractToSnapshot, createSchemaValidationProcessor, defineContract, diffSnapshots, evaluateScenario, formatCompleteness, formatDiff, formatScenarioResult, formatViolation, hasBreakingChanges, hasErrors, highCardinalityKeys, isHighCardinalityKey, isScenarioClosed, parseCardinality, parseSnapshot, proposeScenario, resolveAttributeSpec, scoreGenAiCompleteness, serializeSnapshot, validateScenarioSpec, validateSpan };
+export { AGENT_SECURITY_TELEMETRY_CONTRACT, ATTRIBUTE_TYPES, type AttributeSpec, type AttributeType, type Cardinality, type ChangeKind, type ChangeType, type CheckScenarioOptions, type CompletenessResult, type CompletionBoundary, type ContractSnapshot, type EmittedAttributeValue, type EmittedSpan, type EvaluateScenarioOptions, type FieldScore, GENAI_COMPLETENESS_FIELDS, type GenAiCompletenessField, type OtelContext, type ReadableSpanLike, SCHEMA_ATTRS, SNAPSHOT_SPEC, STABILITIES, type ScenarioAddition, type ScenarioEventSpec, type ScenarioOutcome, type ScenarioProposal, type ScenarioResult, type ScenarioSpan, type ScenarioSpec, type ScenarioViolation, type ScenarioViolationCode, type SchemaAttributeKey, type SchemaProcessorMode, type SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, type SchemaViolation, type SnapshotAttribute, type SnapshotChange, type SnapshotDiff, type SnapshotSpan, type SpanLike, type SpanProcessorLike, type SpanSpec, type Stability, type TelemetryContract, type ValidateOptions, type ViolationCode, type ViolationSeverity, allowsAdditionalAttributes, checkScenario, contractToSnapshot, createSchemaValidationProcessor, defineContract, diffSnapshots, evaluateScenario, formatCompleteness, formatDiff, formatScenarioResult, formatViolation, hasBreakingChanges, hasErrors, highCardinalityKeys, isHighCardinalityKey, isScenarioClosed, parseCardinality, parseSnapshot, proposeScenario, resolveAttributeSpec, scoreGenAiCompleteness, serializeSnapshot, validateScenarioSpec, validateSpan };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { a as diffSnapshots, c as ContractSnapshot, d as contractToSnapshot, f as parseSnapshot, g as SchemaAttributeKey, h as SNAPSHOT_SPEC, i as SnapshotDiff, l as SnapshotAttribute, m as SCHEMA_ATTRS, n as ChangeType, o as formatDiff, p as serializeSnapshot, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind, u as SnapshotSpan } from "./diff-CAIC04O4.js";
-import { A as validateScenarioSpec, C as ScenarioViolationCode, D as isScenarioClosed, E as formatScenarioResult, O as parseCardinality, S as ScenarioViolation, T as evaluateScenario, _ as ScenarioOutcome, a as SpanSpec, b as ScenarioSpan, c as allowsAdditionalAttributes, d as Cardinality, f as CheckScenarioOptions, g as ScenarioEventSpec, h as ScenarioAddition, i as STABILITIES, k as proposeScenario, l as defineContract, m as EvaluateScenarioOptions, n as AttributeSpec, o as Stability, p as CompletionBoundary, r as AttributeType, s as TelemetryContract, t as ATTRIBUTE_TYPES, u as resolveAttributeSpec, v as ScenarioProposal, w as checkScenario, x as ScenarioSpec, y as ScenarioResult } from "./contract-Ymh_Q37N.js";
-import { a as SchemaValidationSpanProcessor, c as createSchemaValidationProcessor, d as ValidateOptions, f as ViolationCode, g as validateSpan, h as hasErrors, i as SchemaValidationProcessorOptions, l as SchemaViolation, m as formatViolation, n as ReadableSpanLike, o as SpanLike, p as ViolationSeverity, r as SchemaProcessorMode, s as SpanProcessorLike, t as OtelContext, u as SpanShape } from "./processor-TpuacLr5.js";
+import { a as diffSnapshots, c as ContractSnapshot, d as contractToSnapshot, f as parseSnapshot, g as SchemaAttributeKey, h as SNAPSHOT_SPEC, i as SnapshotDiff, l as SnapshotAttribute, m as SCHEMA_ATTRS, n as ChangeType, o as formatDiff, p as serializeSnapshot, r as SnapshotChange, s as hasBreakingChanges, t as ChangeKind, u as SnapshotSpan } from "./diff-DenUg42T.js";
+import { A as validateScenarioSpec, C as ScenarioViolationCode, D as isScenarioClosed, E as formatScenarioResult, F as ViolationCode, I as ViolationSeverity, L as formatViolation, M as EmittedSpan, N as SchemaViolation, O as parseCardinality, P as ValidateOptions, R as hasErrors, S as ScenarioViolation, T as evaluateScenario, _ as ScenarioOutcome, a as SpanSpec, b as ScenarioSpan, c as allowsAdditionalAttributes, d as Cardinality, f as CheckScenarioOptions, g as ScenarioEventSpec, h as ScenarioAddition, i as STABILITIES, j as EmittedAttributeValue, k as proposeScenario, l as defineContract, m as EvaluateScenarioOptions, n as AttributeSpec, o as Stability, p as CompletionBoundary, r as AttributeType, s as TelemetryContract, t as ATTRIBUTE_TYPES, u as resolveAttributeSpec, v as ScenarioProposal, w as checkScenario, x as ScenarioSpec, y as ScenarioResult, z as validateSpan } from "./contract-CfOaZcD0.js";
+import { OtelContext, ReadableSpanLike, SchemaProcessorMode, SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, SpanLike, SpanProcessorLike, createSchemaValidationProcessor } from "./processor.js";
 //#region src/completeness.d.ts
 /** The ten fields a GenAI trace is scored on. */
 declare const GENAI_COMPLETENESS_FIELDS: readonly ["llm_input", "llm_output", "model_name", "token_usage", "cost_usd", "latency_per_span", "tool_call_args", "tool_call_results", "span_tree", "span_count"];
@@ -66,4 +66,4 @@ declare function isHighCardinalityKey(contract: TelemetryContract, key: string):
  */
 declare const AGENT_SECURITY_TELEMETRY_CONTRACT: TelemetryContract;
 //#endregion
-export { AGENT_SECURITY_TELEMETRY_CONTRACT, ATTRIBUTE_TYPES, type AttributeSpec, type AttributeType, type Cardinality, type ChangeKind, type ChangeType, type CheckScenarioOptions, type CompletenessResult, type CompletionBoundary, type ContractSnapshot, type EvaluateScenarioOptions, type FieldScore, GENAI_COMPLETENESS_FIELDS, type GenAiCompletenessField, type OtelContext, type ReadableSpanLike, SCHEMA_ATTRS, SNAPSHOT_SPEC, STABILITIES, type ScenarioAddition, type ScenarioEventSpec, type ScenarioOutcome, type ScenarioProposal, type ScenarioResult, type ScenarioSpan, type ScenarioSpec, type ScenarioViolation, type ScenarioViolationCode, type SchemaAttributeKey, type SchemaProcessorMode, type SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, type SchemaViolation, type SnapshotAttribute, type SnapshotChange, type SnapshotDiff, type SnapshotSpan, type SpanLike, type SpanProcessorLike, type SpanShape, type SpanSpec, type Stability, type TelemetryContract, type ValidateOptions, type ViolationCode, type ViolationSeverity, allowsAdditionalAttributes, checkScenario, contractToSnapshot, createSchemaValidationProcessor, defineContract, diffSnapshots, evaluateScenario, formatCompleteness, formatDiff, formatScenarioResult, formatViolation, hasBreakingChanges, hasErrors, highCardinalityKeys, isHighCardinalityKey, isScenarioClosed, parseCardinality, parseSnapshot, proposeScenario, resolveAttributeSpec, scoreGenAiCompleteness, serializeSnapshot, validateScenarioSpec, validateSpan };
+export { AGENT_SECURITY_TELEMETRY_CONTRACT, ATTRIBUTE_TYPES, type AttributeSpec, type AttributeType, type Cardinality, type ChangeKind, type ChangeType, type CheckScenarioOptions, type CompletenessResult, type CompletionBoundary, type ContractSnapshot, type EmittedAttributeValue, type EmittedSpan, type EvaluateScenarioOptions, type FieldScore, GENAI_COMPLETENESS_FIELDS, type GenAiCompletenessField, type OtelContext, type ReadableSpanLike, SCHEMA_ATTRS, SNAPSHOT_SPEC, STABILITIES, type ScenarioAddition, type ScenarioEventSpec, type ScenarioOutcome, type ScenarioProposal, type ScenarioResult, type ScenarioSpan, type ScenarioSpec, type ScenarioViolation, type ScenarioViolationCode, type SchemaAttributeKey, type SchemaProcessorMode, type SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, type SchemaViolation, type SnapshotAttribute, type SnapshotChange, type SnapshotDiff, type SnapshotSpan, type SpanLike, type SpanProcessorLike, type SpanSpec, type Stability, type TelemetryContract, type ValidateOptions, type ViolationCode, type ViolationSeverity, allowsAdditionalAttributes, checkScenario, contractToSnapshot, createSchemaValidationProcessor, defineContract, diffSnapshots, evaluateScenario, formatCompleteness, formatDiff, formatScenarioResult, formatViolation, hasBreakingChanges, hasErrors, highCardinalityKeys, isHighCardinalityKey, isScenarioClosed, parseCardinality, parseSnapshot, proposeScenario, resolveAttributeSpec, scoreGenAiCompleteness, serializeSnapshot, validateScenarioSpec, validateSpan };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a as SNAPSHOT_SPEC, i as SCHEMA_ATTRS, n as parseSnapshot, r as serializeSnapshot, t as contractToSnapshot } from "./snapshot-h8pb_Up_.js";
-import { _ as validateScenarioSpec, a as validateSpan, c as allowsAdditionalAttributes, d as checkScenario, f as evaluateScenario, g as proposeScenario, h as parseCardinality, i as hasErrors, l as defineContract, m as isScenarioClosed, n as createSchemaValidationProcessor, o as ATTRIBUTE_TYPES, p as formatScenarioResult, r as formatViolation, s as STABILITIES, t as SchemaValidationSpanProcessor, u as resolveAttributeSpec } from "./processor-BPp_DewZ.js";
+import { a as SNAPSHOT_SPEC, i as SCHEMA_ATTRS, n as parseSnapshot, r as serializeSnapshot, t as contractToSnapshot } from "./snapshot-BFIxChH0.js";
+import { _ as validateScenarioSpec, a as validateSpan, c as allowsAdditionalAttributes, d as checkScenario, f as evaluateScenario, g as proposeScenario, h as parseCardinality, i as hasErrors, l as defineContract, m as isScenarioClosed, n as createSchemaValidationProcessor, o as ATTRIBUTE_TYPES, p as formatScenarioResult, r as formatViolation, s as STABILITIES, t as SchemaValidationSpanProcessor, u as resolveAttributeSpec } from "./processor-Cn0HNUvw.js";
 import { diffSnapshots, formatDiff, hasBreakingChanges } from "./diff.js";
 
 //#region src/completeness.ts

package/dist/{processor-Gu8Yl_dS.cjs → processor-C9NmN0wQ.cjs}

@@ -48,8 +48,8 @@ const COMPLETION_MODES = [
 */
 function validateScenarioSpec(name, spec) {
 	const scope = `scenario "${name}"`;
-	assert$1(spec.completion && typeof spec.completion === "object", `${scope} must declare a completion boundary`);
-	assert$1(COMPLETION_MODES.includes(spec.completion.mode), `${scope} has invalid completion mode "${spec.completion.mode}"`);
+	assert$1(spec.completion !== void 0 && spec.completion !== null, `${scope} must declare a completion boundary`);
+	assert$1(COMPLETION_MODES.some((mode) => mode === spec.completion.mode), `${scope} has invalid completion mode "${spec.completion.mode}"`);
 	const budget = spec.completion.mode === "externally-reconciled" ? spec.completion.reconciliationDeadlineMs : spec.completion.observationBudgetMs;
 	assert$1(typeof budget === "number" && Number.isFinite(budget) && budget > 0, `${scope} completion budget must be a positive number of milliseconds`);
 	switch (spec.completion.mode) {
@@ -62,7 +62,7 @@ function validateScenarioSpec(name, spec) {
 		if (eventSpec.cardinality !== void 0) try {
 			parseCardinality(eventSpec.cardinality);
 		} catch (error) {
-			throw new Error(`autotel-schema: ${scope} event "${event}": ${error.message}`);
+			throw new Error(`autotel-schema: ${scope} event "${event}": ${error instanceof Error ? error.message : String(error)}`);
 		}
 		if (eventSpec.status !== void 0) assert$1(eventSpec.status === "ok" || eventSpec.status === "error", `${scope} event "${event}" has invalid status "${eventSpec.status}"`);
 	}
@@ -298,10 +298,10 @@ function proposeScenario(runs, options) {
 	const scenario = {
 		description: `Proposed from ${total} recorded run${total === 1 ? "" : "s"} of ${name} — review before committing`,
 		completion,
-		events,
-		...edges.length > 0 ? { edges } : {},
-		...optionalEdges.length > 0 ? { optionalEdges } : {}
+		events
 	};
+	if (edges.length > 0) scenario.edges = edges;
+	if (optionalEdges.length > 0) scenario.optionalEdges = optionalEdges;
 	validateScenarioSpec(name, scenario);
 	return {
 		scenario,

package/dist/{processor-BPp_DewZ.js → processor-Cn0HNUvw.js}

@@ -47,8 +47,8 @@ const COMPLETION_MODES = [
 */
 function validateScenarioSpec(name, spec) {
 	const scope = `scenario "${name}"`;
-	assert$1(spec.completion && typeof spec.completion === "object", `${scope} must declare a completion boundary`);
-	assert$1(COMPLETION_MODES.includes(spec.completion.mode), `${scope} has invalid completion mode "${spec.completion.mode}"`);
+	assert$1(spec.completion !== void 0 && spec.completion !== null, `${scope} must declare a completion boundary`);
+	assert$1(COMPLETION_MODES.some((mode) => mode === spec.completion.mode), `${scope} has invalid completion mode "${spec.completion.mode}"`);
 	const budget = spec.completion.mode === "externally-reconciled" ? spec.completion.reconciliationDeadlineMs : spec.completion.observationBudgetMs;
 	assert$1(typeof budget === "number" && Number.isFinite(budget) && budget > 0, `${scope} completion budget must be a positive number of milliseconds`);
 	switch (spec.completion.mode) {
@@ -61,7 +61,7 @@ function validateScenarioSpec(name, spec) {
 		if (eventSpec.cardinality !== void 0) try {
 			parseCardinality(eventSpec.cardinality);
 		} catch (error) {
-			throw new Error(`autotel-schema: ${scope} event "${event}": ${error.message}`);
+			throw new Error(`autotel-schema: ${scope} event "${event}": ${error instanceof Error ? error.message : String(error)}`);
 		}
 		if (eventSpec.status !== void 0) assert$1(eventSpec.status === "ok" || eventSpec.status === "error", `${scope} event "${event}" has invalid status "${eventSpec.status}"`);
 	}
@@ -297,10 +297,10 @@ function proposeScenario(runs, options) {
 	const scenario = {
 		description: `Proposed from ${total} recorded run${total === 1 ? "" : "s"} of ${name} — review before committing`,
 		completion,
-		events,
-		...edges.length > 0 ? { edges } : {},
-		...optionalEdges.length > 0 ? { optionalEdges } : {}
+		events
 	};
+	if (edges.length > 0) scenario.edges = edges;
+	if (optionalEdges.length > 0) scenario.optionalEdges = optionalEdges;
 	validateScenarioSpec(name, scenario);
 	return {
 		scenario,

package/dist/processor.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_processor = require('./processor-Gu8Yl_dS.cjs');
+const require_processor = require('./processor-C9NmN0wQ.cjs');
 
 exports.SchemaValidationSpanProcessor = require_processor.SchemaValidationSpanProcessor;
 exports.createSchemaValidationProcessor = require_processor.createSchemaValidationProcessor;

package/dist/processor.d.cts

@@ -1,2 +1,71 @@
-import { a as SchemaValidationSpanProcessor, c as createSchemaValidationProcessor, i as SchemaValidationProcessorOptions, n as ReadableSpanLike, o as SpanLike, r as SchemaProcessorMode, s as SpanProcessorLike, t as OtelContext } from "./processor-DVcsS6Rz.cjs";
-export { OtelContext, ReadableSpanLike, SchemaProcessorMode, SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, SpanLike, SpanProcessorLike, createSchemaValidationProcessor };
+import { N as SchemaViolation, P as ValidateOptions, j as EmittedAttributeValue, s as TelemetryContract } from "./contract-CfOaZcD0.cjs";
+//#region src/processor.d.ts
+/** A ReadableSpan as this processor reads one, without a hard SDK dependency. */
+interface ReadableSpanLike {
+  name: string;
+  attributes: Record<string, EmittedAttributeValue>;
+}
+interface SpanLike {
+  spanContext(): {
+    traceId: string;
+    spanId: string;
+  };
+}
+/**
+ * The parent context OTel hands a span processor. This package never reads it,
+ * and naming it here keeps the SpanProcessor signature matchable without taking
+ * a dependency on the SDK.
+ */
+interface OtelContext {
+  getValue?: (key: symbol) => ContextValue;
+}
+/** Whatever OTel stored under a context key. This package never reads one. */
+type ContextValue = object | string | number | boolean | undefined;
+interface SpanProcessorLike {
+  onStart(span: SpanLike, parentContext: OtelContext): void;
+  onEnd(span: ReadableSpanLike): void;
+  shutdown(): Promise<void>;
+  forceFlush(): Promise<void>;
+}
+/** How the processor reacts to a contract violation. */
+type SchemaProcessorMode = 'warn' | 'throw' | 'silent';
+interface SchemaValidationProcessorOptions extends ValidateOptions {
+  contract: TelemetryContract;
+  /**
+   * `warn` (default): log each distinct violation once per interval.
+   * `throw`: throw on the first error-severity violation — for tests/CI only.
+   * `silent`: collect via `onViolation` without logging.
+   */
+  mode?: SchemaProcessorMode;
+  /** Called for every violation, before mode handling. */
+  onViolation?: (violation: SchemaViolation, span: ReadableSpanLike) => void;
+  /** Override the warn sink (defaults to `console.warn`). */
+  onWarn?: (message: string) => void;
+  /** Run even when `NODE_ENV === 'production'`. Default `false`. */
+  enabledInProduction?: boolean;
+  /** Throttle window for repeated identical warnings (ms). Default 60s. */
+  warnIntervalMs?: number;
+}
+/**
+ * Validates each ending span against a {@link TelemetryContract}. Bounded,
+ * deduplicated warnings; fail-open on any internal error.
+ */
+declare class SchemaValidationSpanProcessor implements SpanProcessorLike {
+  private readonly opts;
+  private readonly enabled;
+  private readonly warnIntervalMs;
+  private readonly lastWarnAt;
+  private violationCount;
+  constructor(opts: SchemaValidationProcessorOptions);
+  /** Number of violations seen since startup (across all spans). */
+  get totalViolations(): number;
+  onStart(_span: SpanLike, _parentContext: OtelContext): void;
+  onEnd(span: ReadableSpanLike): void;
+  private handle;
+  private maybeWarn;
+  forceFlush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+declare function createSchemaValidationProcessor(opts: SchemaValidationProcessorOptions): SchemaValidationSpanProcessor;
+//#endregion
+export { ContextValue, OtelContext, ReadableSpanLike, SchemaProcessorMode, SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, SpanLike, SpanProcessorLike, createSchemaValidationProcessor };

package/dist/processor.d.ts

@@ -1,2 +1,71 @@
-import { a as SchemaValidationSpanProcessor, c as createSchemaValidationProcessor, i as SchemaValidationProcessorOptions, n as ReadableSpanLike, o as SpanLike, r as SchemaProcessorMode, s as SpanProcessorLike, t as OtelContext } from "./processor-TpuacLr5.js";
-export { OtelContext, ReadableSpanLike, SchemaProcessorMode, SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, SpanLike, SpanProcessorLike, createSchemaValidationProcessor };
+import { N as SchemaViolation, P as ValidateOptions, j as EmittedAttributeValue, s as TelemetryContract } from "./contract-CfOaZcD0.js";
+//#region src/processor.d.ts
+/** A ReadableSpan as this processor reads one, without a hard SDK dependency. */
+interface ReadableSpanLike {
+  name: string;
+  attributes: Record<string, EmittedAttributeValue>;
+}
+interface SpanLike {
+  spanContext(): {
+    traceId: string;
+    spanId: string;
+  };
+}
+/**
+ * The parent context OTel hands a span processor. This package never reads it,
+ * and naming it here keeps the SpanProcessor signature matchable without taking
+ * a dependency on the SDK.
+ */
+interface OtelContext {
+  getValue?: (key: symbol) => ContextValue;
+}
+/** Whatever OTel stored under a context key. This package never reads one. */
+type ContextValue = object | string | number | boolean | undefined;
+interface SpanProcessorLike {
+  onStart(span: SpanLike, parentContext: OtelContext): void;
+  onEnd(span: ReadableSpanLike): void;
+  shutdown(): Promise<void>;
+  forceFlush(): Promise<void>;
+}
+/** How the processor reacts to a contract violation. */
+type SchemaProcessorMode = 'warn' | 'throw' | 'silent';
+interface SchemaValidationProcessorOptions extends ValidateOptions {
+  contract: TelemetryContract;
+  /**
+   * `warn` (default): log each distinct violation once per interval.
+   * `throw`: throw on the first error-severity violation — for tests/CI only.
+   * `silent`: collect via `onViolation` without logging.
+   */
+  mode?: SchemaProcessorMode;
+  /** Called for every violation, before mode handling. */
+  onViolation?: (violation: SchemaViolation, span: ReadableSpanLike) => void;
+  /** Override the warn sink (defaults to `console.warn`). */
+  onWarn?: (message: string) => void;
+  /** Run even when `NODE_ENV === 'production'`. Default `false`. */
+  enabledInProduction?: boolean;
+  /** Throttle window for repeated identical warnings (ms). Default 60s. */
+  warnIntervalMs?: number;
+}
+/**
+ * Validates each ending span against a {@link TelemetryContract}. Bounded,
+ * deduplicated warnings; fail-open on any internal error.
+ */
+declare class SchemaValidationSpanProcessor implements SpanProcessorLike {
+  private readonly opts;
+  private readonly enabled;
+  private readonly warnIntervalMs;
+  private readonly lastWarnAt;
+  private violationCount;
+  constructor(opts: SchemaValidationProcessorOptions);
+  /** Number of violations seen since startup (across all spans). */
+  get totalViolations(): number;
+  onStart(_span: SpanLike, _parentContext: OtelContext): void;
+  onEnd(span: ReadableSpanLike): void;
+  private handle;
+  private maybeWarn;
+  forceFlush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+declare function createSchemaValidationProcessor(opts: SchemaValidationProcessorOptions): SchemaValidationSpanProcessor;
+//#endregion
+export { ContextValue, OtelContext, ReadableSpanLike, SchemaProcessorMode, SchemaValidationProcessorOptions, SchemaValidationSpanProcessor, SpanLike, SpanProcessorLike, createSchemaValidationProcessor };

package/dist/processor.js

@@ -1,3 +1,3 @@
-import { n as createSchemaValidationProcessor, t as SchemaValidationSpanProcessor } from "./processor-BPp_DewZ.js";
+import { n as createSchemaValidationProcessor, t as SchemaValidationSpanProcessor } from "./processor-Cn0HNUvw.js";
 
 export { SchemaValidationSpanProcessor, createSchemaValidationProcessor };

package/dist/{snapshot-h8pb_Up_.js → snapshot-BFIxChH0.js}

@@ -40,9 +40,7 @@ function normalizeAttribute(spec) {
 	return out;
 }
 function sortRecord(record) {
-	const out = {};
-	for (const key of Object.keys(record).toSorted()) out[key] = record[key];
-	return out;
+	return Object.fromEntries(Object.keys(record).toSorted().map((key) => [key, record[key]]));
 }
 /**
 * Produce a deterministic, JSON-serializable snapshot from a contract. Keys are

package/dist/{snapshot-CyWGJaJT.cjs → snapshot-BJmrOlMK.cjs}

@@ -41,9 +41,7 @@ function normalizeAttribute(spec) {
 	return out;
 }
 function sortRecord(record) {
-	const out = {};
-	for (const key of Object.keys(record).toSorted()) out[key] = record[key];
-	return out;
+	return Object.fromEntries(Object.keys(record).toSorted().map((key) => [key, record[key]]));
 }
 /**
 * Produce a deterministic, JSON-serializable snapshot from a contract. Keys are

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-schema",
-  "version": "10.0.0",
+  "version": "11.0.1",
   "description": "Your telemetry surface as a typed, versioned contract — declare the spans and attributes your service emits, validate live spans against them, and diff the surface across commits to catch breaking trace changes before they ship.",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,7 @@
   "author": "Jag Reehal <jag@jagreehal.com> (https://jagreehal.com)",
   "license": "Apache-2.0",
   "peerDependencies": {
-    "autotel": "6.5.0"
+    "autotel": "7.0.1"
   },
   "peerDependenciesMeta": {
     "autotel": {

package/dist/processor-DVcsS6Rz.d.cts

@@ -1,98 +0,0 @@
-import { s as TelemetryContract } from "./contract-Ymh_Q37N.cjs";
-//#region src/validate.d.ts
-/** Severity of a contract violation. `error` = a breaking-shaped problem. */
-type ViolationSeverity = 'error' | 'warning';
-type ViolationCode = 'unknown_span' | 'unknown_attribute' | 'type_mismatch' | 'missing_required' | 'deprecated_attribute' | 'enum_violation';
-/** A single discrepancy between an emitted span and the contract. */
-interface SchemaViolation {
-  code: ViolationCode;
-  severity: ViolationSeverity;
-  spanName: string;
-  /** Attribute key involved, when the violation is attribute-scoped. */
-  attribute?: string;
-  message: string;
-  /** Nearest declared key, for likely typos (`unknown_attribute` only). */
-  suggestion?: string;
-}
-/** Minimal emitted-span shape — avoids a hard dependency on the OTel SDK. */
-interface SpanShape {
-  name: string;
-  attributes: Record<string, unknown>;
-}
-interface ValidateOptions {
-  /** Report `unknown_span` for span names not in the contract. Default `false`. */
-  strictSpanNames?: boolean;
-}
-/**
- * Validate one emitted span against the contract, returning every discrepancy.
- * Order is deterministic: required-but-missing first, then per-attribute checks
- * in attribute insertion order.
- */
-declare function validateSpan(span: SpanShape, contract: TelemetryContract, options?: ValidateOptions): SchemaViolation[];
-/** `true` when any violation is `error` severity. */
-declare function hasErrors(violations: SchemaViolation[]): boolean;
-/** One-line human/agent-readable rendering of a violation. */
-declare function formatViolation(v: SchemaViolation): string;
-//#endregion
-//#region src/processor.d.ts
-/** Minimal ReadableSpan shape — matches OTel without a hard SDK dependency. */
-interface ReadableSpanLike {
-  name: string;
-  attributes: Record<string, unknown>;
-}
-interface SpanLike {
-  spanContext(): {
-    traceId: string;
-    spanId: string;
-  };
-}
-/** Opaque parent context — matches OTel SpanProcessor without importing it. */
-type OtelContext = unknown;
-interface SpanProcessorLike {
-  onStart(span: SpanLike, parentContext: OtelContext): void;
-  onEnd(span: ReadableSpanLike): void;
-  shutdown(): Promise<void>;
-  forceFlush(): Promise<void>;
-}
-/** How the processor reacts to a contract violation. */
-type SchemaProcessorMode = 'warn' | 'throw' | 'silent';
-interface SchemaValidationProcessorOptions extends ValidateOptions {
-  contract: TelemetryContract;
-  /**
-   * `warn` (default): log each distinct violation once per interval.
-   * `throw`: throw on the first error-severity violation — for tests/CI only.
-   * `silent`: collect via `onViolation` without logging.
-   */
-  mode?: SchemaProcessorMode;
-  /** Called for every violation, before mode handling. */
-  onViolation?: (violation: SchemaViolation, span: ReadableSpanLike) => void;
-  /** Override the warn sink (defaults to `console.warn`). */
-  onWarn?: (message: string) => void;
-  /** Run even when `NODE_ENV === 'production'`. Default `false`. */
-  enabledInProduction?: boolean;
-  /** Throttle window for repeated identical warnings (ms). Default 60s. */
-  warnIntervalMs?: number;
-}
-/**
- * Validates each ending span against a {@link TelemetryContract}. Bounded,
- * deduplicated warnings; fail-open on any internal error.
- */
-declare class SchemaValidationSpanProcessor implements SpanProcessorLike {
-  private readonly opts;
-  private readonly enabled;
-  private readonly warnIntervalMs;
-  private readonly lastWarnAt;
-  private violationCount;
-  constructor(opts: SchemaValidationProcessorOptions);
-  /** Number of violations seen since startup (across all spans). */
-  get totalViolations(): number;
-  onStart(_span: SpanLike, _parentContext: OtelContext): void;
-  onEnd(span: ReadableSpanLike): void;
-  private handle;
-  private maybeWarn;
-  forceFlush(): Promise<void>;
-  shutdown(): Promise<void>;
-}
-declare function createSchemaValidationProcessor(opts: SchemaValidationProcessorOptions): SchemaValidationSpanProcessor;
-//#endregion
-export { SchemaValidationSpanProcessor as a, createSchemaValidationProcessor as c, ValidateOptions as d, ViolationCode as f, validateSpan as g, hasErrors as h, SchemaValidationProcessorOptions as i, SchemaViolation as l, formatViolation as m, ReadableSpanLike as n, SpanLike as o, ViolationSeverity as p, SchemaProcessorMode as r, SpanProcessorLike as s, OtelContext as t, SpanShape as u };

package/dist/processor-TpuacLr5.d.ts

@@ -1,98 +0,0 @@
-import { s as TelemetryContract } from "./contract-Ymh_Q37N.js";
-//#region src/validate.d.ts
-/** Severity of a contract violation. `error` = a breaking-shaped problem. */
-type ViolationSeverity = 'error' | 'warning';
-type ViolationCode = 'unknown_span' | 'unknown_attribute' | 'type_mismatch' | 'missing_required' | 'deprecated_attribute' | 'enum_violation';
-/** A single discrepancy between an emitted span and the contract. */
-interface SchemaViolation {
-  code: ViolationCode;
-  severity: ViolationSeverity;
-  spanName: string;
-  /** Attribute key involved, when the violation is attribute-scoped. */
-  attribute?: string;
-  message: string;
-  /** Nearest declared key, for likely typos (`unknown_attribute` only). */
-  suggestion?: string;
-}
-/** Minimal emitted-span shape — avoids a hard dependency on the OTel SDK. */
-interface SpanShape {
-  name: string;
-  attributes: Record<string, unknown>;
-}
-interface ValidateOptions {
-  /** Report `unknown_span` for span names not in the contract. Default `false`. */
-  strictSpanNames?: boolean;
-}
-/**
- * Validate one emitted span against the contract, returning every discrepancy.
- * Order is deterministic: required-but-missing first, then per-attribute checks
- * in attribute insertion order.
- */
-declare function validateSpan(span: SpanShape, contract: TelemetryContract, options?: ValidateOptions): SchemaViolation[];
-/** `true` when any violation is `error` severity. */
-declare function hasErrors(violations: SchemaViolation[]): boolean;
-/** One-line human/agent-readable rendering of a violation. */
-declare function formatViolation(v: SchemaViolation): string;
-//#endregion
-//#region src/processor.d.ts
-/** Minimal ReadableSpan shape — matches OTel without a hard SDK dependency. */
-interface ReadableSpanLike {
-  name: string;
-  attributes: Record<string, unknown>;
-}
-interface SpanLike {
-  spanContext(): {
-    traceId: string;
-    spanId: string;
-  };
-}
-/** Opaque parent context — matches OTel SpanProcessor without importing it. */
-type OtelContext = unknown;
-interface SpanProcessorLike {
-  onStart(span: SpanLike, parentContext: OtelContext): void;
-  onEnd(span: ReadableSpanLike): void;
-  shutdown(): Promise<void>;
-  forceFlush(): Promise<void>;
-}
-/** How the processor reacts to a contract violation. */
-type SchemaProcessorMode = 'warn' | 'throw' | 'silent';
-interface SchemaValidationProcessorOptions extends ValidateOptions {
-  contract: TelemetryContract;
-  /**
-   * `warn` (default): log each distinct violation once per interval.
-   * `throw`: throw on the first error-severity violation — for tests/CI only.
-   * `silent`: collect via `onViolation` without logging.
-   */
-  mode?: SchemaProcessorMode;
-  /** Called for every violation, before mode handling. */
-  onViolation?: (violation: SchemaViolation, span: ReadableSpanLike) => void;
-  /** Override the warn sink (defaults to `console.warn`). */
-  onWarn?: (message: string) => void;
-  /** Run even when `NODE_ENV === 'production'`. Default `false`. */
-  enabledInProduction?: boolean;
-  /** Throttle window for repeated identical warnings (ms). Default 60s. */
-  warnIntervalMs?: number;
-}
-/**
- * Validates each ending span against a {@link TelemetryContract}. Bounded,
- * deduplicated warnings; fail-open on any internal error.
- */
-declare class SchemaValidationSpanProcessor implements SpanProcessorLike {
-  private readonly opts;
-  private readonly enabled;
-  private readonly warnIntervalMs;
-  private readonly lastWarnAt;
-  private violationCount;
-  constructor(opts: SchemaValidationProcessorOptions);
-  /** Number of violations seen since startup (across all spans). */
-  get totalViolations(): number;
-  onStart(_span: SpanLike, _parentContext: OtelContext): void;
-  onEnd(span: ReadableSpanLike): void;
-  private handle;
-  private maybeWarn;
-  forceFlush(): Promise<void>;
-  shutdown(): Promise<void>;
-}
-declare function createSchemaValidationProcessor(opts: SchemaValidationProcessorOptions): SchemaValidationSpanProcessor;
-//#endregion
-export { SchemaValidationSpanProcessor as a, createSchemaValidationProcessor as c, ValidateOptions as d, ViolationCode as f, validateSpan as g, hasErrors as h, SchemaValidationProcessorOptions as i, SchemaViolation as l, formatViolation as m, ReadableSpanLike as n, SpanLike as o, ViolationSeverity as p, SchemaProcessorMode as r, SpanProcessorLike as s, OtelContext as t, SpanShape as u };