autotel-pact 0.2.0

package/dist/provider.js

@@ -0,0 +1,213 @@
+import path from 'path';
+import { span, getActiveSpan } from 'autotel';
+import { readFileSync, mkdirSync, appendFileSync } from 'fs';
+import 'fs/promises';
+
+// src/wrapper-provider.ts
+
+// src/types.ts
+var LEDGER_ENTRY_SPEC = "autotel-pact-ledger-entry/v0.2.0";
+
+// src/ledger.ts
+var DEFAULT_DIR = ".autotel-pact";
+function resolveLedgerDir(opts = {}) {
+  return path.resolve(process.cwd(), opts.dir ?? process.env.AUTOTEL_PACT_LEDGER_DIR ?? DEFAULT_DIR);
+}
+function resolveRunId(opts = {}) {
+  const explicit = opts.runId ?? process.env.AUTOTEL_PACT_RUN_ID;
+  if (explicit) return explicit;
+  return `local-${(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g, "-")}`;
+}
+function ledgerPath(opts = {}) {
+  const dir = resolveLedgerDir(opts);
+  return path.join(dir, `ledger-${resolveRunId(opts)}.jsonl`);
+}
+function writeLine(filePath, entry) {
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  appendFileSync(filePath, JSON.stringify(entry) + "\n", "utf8");
+}
+function appendLedgerEntry(entry, opts = {}) {
+  const filePath = ledgerPath(opts);
+  const normalized = entry.type === "provider_verification_run" ? entry : { ...entry, spec: LEDGER_ENTRY_SPEC, type: "interaction" };
+  writeLine(filePath, normalized);
+}
+function appendProviderVerificationFailure(entry, opts = {}) {
+  appendLedgerEntry(
+    {
+      type: "provider_verification_run",
+      spec: LEDGER_ENTRY_SPEC,
+      outcome: "failed",
+      role: "provider",
+      source: entry.source ?? "test",
+      consumer: entry.consumer,
+      provider: entry.provider,
+      observed_at: entry.observed_at,
+      error: entry.error,
+      run_id: entry.run_id,
+      git_sha: entry.git_sha,
+      trace_id: entry.trace_id,
+      span_id: entry.span_id
+    },
+    opts
+  );
+}
+Promise.resolve();
+function extractInteractionId(metadata) {
+  if (!metadata) return void 0;
+  const id = metadata.interactionId ?? metadata.interaction_id;
+  return typeof id === "string" && id.length > 0 ? id : void 0;
+}
+function interactionsFromPactFile(pact) {
+  const consumer = pact.consumer?.name;
+  const provider = pact.provider?.name;
+  if (!consumer || !provider) return [];
+  const keys = [];
+  for (const m of pact.messages ?? []) {
+    keys.push({
+      consumer,
+      provider,
+      interaction: m.description,
+      kind: "message",
+      interactionId: extractInteractionId(m.metadata)
+    });
+  }
+  for (const i of pact.interactions ?? []) {
+    keys.push({
+      consumer,
+      provider,
+      interaction: i.description,
+      kind: "http",
+      interactionId: extractInteractionId(i.metadata)
+    });
+  }
+  return keys;
+}
+function parsePactFile(filePath) {
+  try {
+    return JSON.parse(readFileSync(filePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+// src/attrs.ts
+var PACT_ATTRS = {
+  CONSUMER: "pact.consumer",
+  PROVIDER: "pact.provider",
+  KIND: "pact.kind",
+  INTERACTION_DESCRIPTION: "pact.interaction.description",
+  INTERACTION_ID: "pact.interaction.id",
+  INTERACTION_STATES: "pact.interaction.states",
+  CONTRACT_FILE: "pact.contract.file",
+  OUTCOME: "pact.outcome"
+};
+
+// src/wrapper-provider.ts
+function resolvePactPaths(opts) {
+  const urls = opts.pactUrls ?? [];
+  return urls.map((u) => path.resolve(process.cwd(), u));
+}
+function inferConsumerFromPacts(pactPaths, fallback) {
+  for (const filePath of pactPaths) {
+    const pact = parsePactFile(filePath);
+    if (pact?.consumer?.name) return pact.consumer.name;
+  }
+  if (fallback) return fallback;
+  throw new Error(
+    "autotel-pact: could not infer consumer from pact files. Pass `consumer` in options."
+  );
+}
+function kindForPactFile(filePath) {
+  const pact = parsePactFile(filePath);
+  if (!pact) return "message";
+  if ((pact.interactions?.length ?? 0) > 0) return "http";
+  return "message";
+}
+async function loadVerifier(VerifierClass) {
+  if (VerifierClass) return VerifierClass;
+  const mod = await import('@pact-foundation/pact');
+  const Verifier = mod.Verifier;
+  if (!Verifier) {
+    throw new Error(
+      "autotel-pact: @pact-foundation/pact Verifier not found. Install the peer dependency."
+    );
+  }
+  return Verifier;
+}
+async function withProviderVerification(verifierOpts, wrapOpts = {}) {
+  const pactPaths = resolvePactPaths(verifierOpts);
+  const provider = verifierOpts.provider;
+  const consumer = inferConsumerFromPacts(pactPaths, wrapOpts.consumer);
+  const spanName = wrapOpts.spanName ?? "pact.verification";
+  const start = process.hrtime.bigint();
+  const Verifier = wrapOpts.skipVerifier ? void 0 : await loadVerifier(wrapOpts.Verifier);
+  return span(spanName, async () => {
+    const span = getActiveSpan();
+    span?.setAttributes({
+      [PACT_ATTRS.CONSUMER]: consumer,
+      [PACT_ATTRS.PROVIDER]: provider,
+      [PACT_ATTRS.KIND]: pactPaths.length === 1 ? kindForPactFile(pactPaths[0]) : "message",
+      "pact.role": "provider"
+    });
+    try {
+      if (Verifier) {
+        await new Verifier(verifierOpts).verifyProvider();
+      }
+      span?.setAttributes({ [PACT_ATTRS.OUTCOME]: "passed" });
+      const ctx = span?.spanContext();
+      const base = {
+        source: "test",
+        role: "provider",
+        outcome: "passed",
+        observed_at: (/* @__PURE__ */ new Date()).toISOString(),
+        trace_id: ctx?.traceId,
+        span_id: ctx?.spanId,
+        run_id: process.env.AUTOTEL_PACT_RUN_ID,
+        git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA
+      };
+      for (const filePath of pactPaths) {
+        const pact = parsePactFile(filePath);
+        if (!pact) continue;
+        const interactions = interactionsFromPactFile(pact);
+        for (const i of interactions) {
+          const entry = {
+            type: "interaction",
+            spec: LEDGER_ENTRY_SPEC,
+            consumer: i.consumer,
+            provider: i.provider,
+            interaction: i.interaction,
+            interaction_id: i.interactionId,
+            states: [],
+            kind: i.kind,
+            duration_ms: Number(process.hrtime.bigint() - start) / 1e6,
+            ...base
+          };
+          appendLedgerEntry(entry, wrapOpts);
+        }
+      }
+    } catch (error) {
+      span?.setAttributes({ [PACT_ATTRS.OUTCOME]: "failed" });
+      const message = error instanceof Error ? error.message : String(error);
+      const ctx = span?.spanContext();
+      appendProviderVerificationFailure(
+        {
+          consumer,
+          provider,
+          source: "test",
+          observed_at: (/* @__PURE__ */ new Date()).toISOString(),
+          error: message,
+          trace_id: ctx?.traceId,
+          span_id: ctx?.spanId,
+          run_id: process.env.AUTOTEL_PACT_RUN_ID,
+          git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA
+        },
+        wrapOpts
+      );
+      throw error;
+    }
+  });
+}
+
+export { withProviderVerification };
+//# sourceMappingURL=provider.js.map
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/ledger.ts","../src/pact-file.ts","../src/attrs.ts","../src/wrapper-provider.ts"],"names":["readFileSync","path","autotelSpan"],"mappings":"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","file":"provider.js","sourcesContent":["/**\n * Kind of contract interaction observed.\n */\nexport type PactKind = 'message' | 'http';\n\nexport type PactOutcome = 'passed' | 'failed';\n\nexport type LedgerSource = 'test' | 'production';\nexport type LedgerRole = 'consumer' | 'provider';\n\nexport const LEDGER_ENTRY_SPEC = 'autotel-pact-ledger-entry/v0.2.0';\nexport const AUDIT_MATRIX_SPEC = 'autotel-pact-audit-matrix/v0.2.0';\n\n/**\n * Metadata about a single Pact interaction, derived from the reified message\n * plus the consumer/provider config. Stamped onto the span and the ledger entry.\n */\nexport interface PactInteractionMeta {\n  consumer: string;\n  provider: string;\n  description: string;\n  states: string[];\n  kind: PactKind;\n  interactionId?: string;\n}\n\n/**\n * Per-interaction ledger evidence (consumer exercise, provider verify, or production tag).\n */\nexport interface InteractionLedgerEntry {\n  type?: 'interaction';\n  spec: typeof LEDGER_ENTRY_SPEC;\n  consumer: string;\n  provider: string;\n  interaction: string;\n  interaction_id?: string;\n  states: string[];\n  kind: PactKind;\n  outcome: PactOutcome;\n  source: LedgerSource;\n  role: LedgerRole;\n  duration_ms: number;\n  observed_at: string;\n  trace_id?: string;\n  span_id?: string;\n  run_id?: string;\n  git_sha?: string;\n  error?: string;\n}\n\n/**\n * Run-level provider verification failure — does not imply per-interaction outcomes.\n */\nexport interface ProviderVerificationRunEntry {\n  type: 'provider_verification_run';\n  spec: typeof LEDGER_ENTRY_SPEC;\n  consumer: string;\n  provider: string;\n  outcome: 'failed';\n  source: LedgerSource;\n  role: 'provider';\n  observed_at: string;\n  error: string;\n  run_id?: string;\n  git_sha?: string;\n  trace_id?: string;\n  span_id?: string;\n}\n\nexport type LedgerRecord = InteractionLedgerEntry | ProviderVerificationRunEntry;\n\nexport function isInteractionLedgerEntry(\n  entry: LedgerRecord,\n): entry is InteractionLedgerEntry {\n  return entry.type !== 'provider_verification_run';\n}\n\nexport function isProviderVerificationRun(\n  entry: LedgerRecord,\n): entry is ProviderVerificationRunEntry {\n  return entry.type === 'provider_verification_run';\n}\n\n/**\n * Shape of a Pact contract file on disk (subset we read).\n */\nexport interface PactFile {\n  consumer: { name: string };\n  provider: { name: string };\n  messages?: Array<{\n    description: string;\n    providerStates?: Array<{ name: string }>;\n    metadata?: Record<string, unknown>;\n  }>;\n  interactions?: Array<{\n    description: string;\n    providerStates?: Array<{ name: string }>;\n    metadata?: Record<string, unknown>;\n  }>;\n}\n\nexport interface BrokerVerification {\n  consumer: string;\n  provider: string;\n  success: boolean;\n  verifiedAt?: string;\n  /**\n   * Populated when the broker could not be reached or returned a non-2xx\n   * response. Distinguishes \"broker said the pact is not verified\" (no error)\n   * from \"we could not determine verification status\" (error set).\n   */\n  error?: string;\n}\n\n/**\n * One row in the audit matrix.\n */\nexport interface AuditRow {\n  consumer: string;\n  provider: string;\n  interaction: string;\n  interaction_id?: string;\n  kind: PactKind;\n  contracted: boolean;\n  /** Any interaction-level ledger hit in the window (test or production). */\n  observed: boolean;\n  test_seen: boolean;\n  prod_seen: boolean;\n  provider_verified: boolean;\n  broker_verified: boolean;\n  broker_verified_at?: string;\n  /** Set when the broker check failed (network error, non-2xx, parse error). */\n  broker_error?: string;\n  last_observed_at?: string;\n  last_outcome?: PactOutcome;\n}\n\nexport interface AuditMatrix {\n  spec: typeof AUDIT_MATRIX_SPEC;\n  rows: AuditRow[];\n  counts: {\n    total: number;\n    /** Any contracted row. */\n    contracted: number;\n    /** Any row with test_seen OR prod_seen. */\n    observed: number;\n    /** Contracted AND seen in a consumer test. */\n    contracted_and_test_seen: number;\n    /** Contracted but not seen in a consumer test (stale confidence). */\n    contracted_not_test_seen: number;\n    /** Seen (test or production) without a matching contract (ungoverned flow). */\n    test_or_prod_seen_not_contracted: number;\n    test_seen: number;\n    prod_seen: number;\n    provider_verified: number;\n    broker_verified: number;\n  };\n  window_days: number;\n  generated_at: string;\n  verification_failures?: ProviderVerificationRunEntry[];\n}\n\nexport interface PactInteractionKey {\n  consumer: string;\n  provider: string;\n  interaction: string;\n  kind: PactKind;\n  interactionId?: string;\n}\n","import {\n  appendFileSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  existsSync,\n} from 'node:fs';\nimport { appendFile, mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport { normalizeLedgerRecord } from './ledger-normalize.js';\nimport { LEDGER_ENTRY_SPEC, type LedgerRecord } from './types.js';\n\nexport interface LedgerOptions {\n  dir?: string;\n  runId?: string;\n}\n\nconst DEFAULT_DIR = '.autotel-pact';\n\nfunction resolveLedgerDir(opts: LedgerOptions = {}): string {\n  return path.resolve(process.cwd(), opts.dir ?? process.env.AUTOTEL_PACT_LEDGER_DIR ?? DEFAULT_DIR);\n}\n\nfunction resolveRunId(opts: LedgerOptions = {}): string {\n  const explicit = opts.runId ?? process.env.AUTOTEL_PACT_RUN_ID;\n  if (explicit) return explicit;\n  return `local-${new Date().toISOString().replaceAll(/[:.]/g, '-')}`;\n}\n\nexport function ledgerPath(opts: LedgerOptions = {}): string {\n  const dir = resolveLedgerDir(opts);\n  return path.join(dir, `ledger-${resolveRunId(opts)}.jsonl`);\n}\n\nfunction writeLine(filePath: string, entry: LedgerRecord): void {\n  mkdirSync(path.dirname(filePath), { recursive: true });\n  appendFileSync(filePath, JSON.stringify(entry) + '\\n', 'utf8');\n}\n\n/**\n * Append a ledger record synchronously (tests and consumer wrappers).\n */\nexport function appendLedgerEntry(\n  entry: LedgerRecord,\n  opts: LedgerOptions = {},\n): void {\n  const filePath = ledgerPath(opts);\n  const normalized: LedgerRecord =\n    entry.type === 'provider_verification_run'\n      ? entry\n      : { ...entry, spec: LEDGER_ENTRY_SPEC, type: 'interaction' as const };\n  writeLine(filePath, normalized);\n}\n\nexport function appendProviderVerificationFailure(\n  entry: Omit<\n    import('./types.js').ProviderVerificationRunEntry,\n    'type' | 'spec' | 'outcome' | 'role'\n  > & { error: string },\n  opts: LedgerOptions = {},\n): void {\n  appendLedgerEntry(\n    {\n      type: 'provider_verification_run',\n      spec: LEDGER_ENTRY_SPEC,\n      outcome: 'failed',\n      role: 'provider',\n      source: entry.source ?? 'test',\n      consumer: entry.consumer,\n      provider: entry.provider,\n      observed_at: entry.observed_at,\n      error: entry.error,\n      run_id: entry.run_id,\n      git_sha: entry.git_sha,\n      trace_id: entry.trace_id,\n      span_id: entry.span_id,\n    },\n    opts,\n  );\n}\n\n/**\n * Read all ledger files and return normalized records.\n */\nexport function readLedger(opts: LedgerOptions = {}): LedgerRecord[] {\n  const dir = resolveLedgerDir(opts);\n  if (!existsSync(dir)) return [];\n  const files = readdirSync(dir).filter((f) => f.endsWith('.jsonl'));\n  const entries: LedgerRecord[] = [];\n  for (const file of files) {\n    const text = readFileSync(path.join(dir, file), 'utf8');\n    for (const line of text.split('\\n')) {\n      if (!line.trim()) continue;\n      try {\n        const normalized = normalizeLedgerRecord(JSON.parse(line));\n        if (normalized) entries.push(normalized);\n      } catch {\n        // skip malformed lines\n      }\n    }\n  }\n  return entries;\n}\n\n/**\n * Serialized async writes for production span processor.\n * Bounded by a producer-side backpressure threshold: once `pendingWrites`\n * reaches `MAX_PENDING_WRITES`, new callers await drainage before queueing,\n * so memory cannot grow unbounded under sustained pressure.\n */\nconst MAX_PENDING_WRITES = 4096;\nlet asyncWriteChain: Promise<void> = Promise.resolve();\nlet pendingWrites = 0;\n\nexport async function appendLedgerEntryAsync(\n  entry: LedgerRecord,\n  opts: LedgerOptions = {},\n): Promise<void> {\n  if (pendingWrites >= MAX_PENDING_WRITES) {\n    await asyncWriteChain;\n  }\n\n  const filePath = ledgerPath(opts);\n  const normalized: LedgerRecord =\n    entry.type === 'provider_verification_run'\n      ? entry\n      : { ...entry, spec: LEDGER_ENTRY_SPEC, type: 'interaction' as const };\n  const line = JSON.stringify(normalized);\n\n  pendingWrites++;\n  const run = asyncWriteChain.then(async () => {\n    try {\n      await mkdir(path.dirname(filePath), { recursive: true });\n      await appendFile(filePath, line + '\\n', 'utf8');\n    } finally {\n      pendingWrites--;\n    }\n  });\n  asyncWriteChain = run.catch(() => {});\n  return run;\n}\n\nexport async function flushLedgerWrites(): Promise<void> {\n  await asyncWriteChain;\n}\n\n/** @internal Reset async chain between tests. */\nexport function resetLedgerWriteChainForTests(): void {\n  asyncWriteChain = Promise.resolve();\n  pendingWrites = 0;\n}\n\n/** @internal Expose pending write count for tests. */\nexport function pendingLedgerWriteCount(): number {\n  return pendingWrites;\n}\n","import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport path from 'node:path';\nimport type { PactFile, PactInteractionKey } from './types.js';\n\n/**\n * Walk a directory and return absolute paths of all *.json pact files.\n */\nexport function listPactFiles(dir: string): string[] {\n  if (!existsSync(dir) || !statSync(dir).isDirectory()) return [];\n  const out: string[] = [];\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      out.push(...listPactFiles(full));\n    } else if (entry.isFile() && entry.name.endsWith('.json')) {\n      out.push(full);\n    }\n  }\n  return out;\n}\n\nexport function extractInteractionId(\n  metadata: Record<string, unknown> | undefined,\n): string | undefined {\n  if (!metadata) return undefined;\n  const id = metadata.interactionId ?? metadata.interaction_id;\n  return typeof id === 'string' && id.length > 0 ? id : undefined;\n}\n\n/**\n * Extract interaction tuples declared in a pact file.\n */\nexport function interactionsFromPactFile(pact: PactFile): PactInteractionKey[] {\n  const consumer = pact.consumer?.name;\n  const provider = pact.provider?.name;\n  if (!consumer || !provider) return [];\n  const keys: PactInteractionKey[] = [];\n  for (const m of pact.messages ?? []) {\n    keys.push({\n      consumer,\n      provider,\n      interaction: m.description,\n      kind: 'message',\n      interactionId: extractInteractionId(m.metadata),\n    });\n  }\n  for (const i of pact.interactions ?? []) {\n    keys.push({\n      consumer,\n      provider,\n      interaction: i.description,\n      kind: 'http',\n      interactionId: extractInteractionId(i.metadata),\n    });\n  }\n  return keys;\n}\n\nexport function parsePactFile(filePath: string): PactFile | null {\n  try {\n    return JSON.parse(readFileSync(filePath, 'utf8')) as PactFile;\n  } catch {\n    return null;\n  }\n}\n","import type { PactInteractionMeta, PactOutcome } from './types.js';\n\n/**\n * Attribute keys for Pact interactions. Centralised so the namespace is\n * a single source of truth and is forward-compatible with eventual OTel\n * semantic conventions.\n */\nexport const PACT_ATTRS = {\n  CONSUMER: 'pact.consumer',\n  PROVIDER: 'pact.provider',\n  KIND: 'pact.kind',\n  INTERACTION_DESCRIPTION: 'pact.interaction.description',\n  INTERACTION_ID: 'pact.interaction.id',\n  INTERACTION_STATES: 'pact.interaction.states',\n  CONTRACT_FILE: 'pact.contract.file',\n  OUTCOME: 'pact.outcome',\n} as const;\n\nexport type PactAttributeKey = (typeof PACT_ATTRS)[keyof typeof PACT_ATTRS];\n\n/**\n * Build the set of attributes to stamp on a span when an interaction is\n * about to be exercised. `outcome` is added later by the wrapper.\n */\nexport function buildPactAttributes(\n  meta: PactInteractionMeta,\n  opts: { contractFile?: string } = {},\n): Record<string, string | string[]> {\n  const attrs: Record<string, string | string[]> = {\n    [PACT_ATTRS.CONSUMER]: meta.consumer,\n    [PACT_ATTRS.PROVIDER]: meta.provider,\n    [PACT_ATTRS.KIND]: meta.kind,\n    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,\n    [PACT_ATTRS.INTERACTION_STATES]: meta.states,\n  };\n  if (opts.contractFile) {\n    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;\n  }\n  if (meta.interactionId) {\n    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;\n  }\n  return attrs;\n}\n\n/**\n * Helper that returns just the outcome attribute — stamped after the\n * handler resolves or rejects.\n */\nexport function outcomeAttribute(\n  outcome: PactOutcome,\n): Record<string, string> {\n  return { [PACT_ATTRS.OUTCOME]: outcome };\n}\n","import path from 'node:path';\nimport { span as autotelSpan, getActiveSpan } from 'autotel';\nimport { appendLedgerEntry, appendProviderVerificationFailure, type LedgerOptions } from './ledger.js';\nimport { interactionsFromPactFile, parsePactFile } from './pact-file.js';\nimport { LEDGER_ENTRY_SPEC, type InteractionLedgerEntry, type PactKind } from './types.js';\nimport { PACT_ATTRS } from './attrs.js';\n\n/**\n * Minimal Verifier options — structural match for @pact-foundation/pact Verifier.\n */\nexport interface VerifierOptionsLike {\n  provider: string;\n  providerBaseUrl: string;\n  pactUrls?: string[];\n  logLevel?: string;\n  [key: string]: unknown;\n}\n\nexport interface VerifierLike {\n  verifyProvider: () => Promise<unknown>;\n}\n\nexport interface VerifierConstructor {\n  new (options: VerifierOptionsLike): VerifierLike;\n}\n\nexport interface WithProviderVerificationOptions extends LedgerOptions {\n  /** Consumer name when not inferrable from pact files. */\n  consumer?: string;\n  spanName?: string;\n  /** Custom Verifier class (defaults to dynamic import from @pact-foundation/pact). */\n  Verifier?: VerifierConstructor;\n  /**\n   * Skip loading and calling the Verifier entirely. Emits the same\n   * per-interaction ledger rows as a successful verification, parsed from the\n   * supplied pact files. Use for demos, smoke tests, and audit-pipeline\n   * exercises where running a real provider is impractical. Do not use in\n   * production CI: it will mark every interaction in the pact file as\n   * provider-verified without any actual verification.\n   */\n  skipVerifier?: boolean;\n}\n\nfunction resolvePactPaths(opts: VerifierOptionsLike): string[] {\n  const urls = opts.pactUrls ?? [];\n  return urls.map((u) => path.resolve(process.cwd(), u));\n}\n\nfunction inferConsumerFromPacts(pactPaths: string[], fallback?: string): string {\n  for (const filePath of pactPaths) {\n    const pact = parsePactFile(filePath);\n    if (pact?.consumer?.name) return pact.consumer.name;\n  }\n  if (fallback) return fallback;\n  throw new Error(\n    'autotel-pact: could not infer consumer from pact files. Pass `consumer` in options.',\n  );\n}\n\nfunction kindForPactFile(filePath: string): PactKind {\n  const pact = parsePactFile(filePath);\n  if (!pact) return 'message';\n  if ((pact.interactions?.length ?? 0) > 0) return 'http';\n  return 'message';\n}\n\nasync function loadVerifier(\n  VerifierClass?: VerifierConstructor,\n): Promise<VerifierConstructor> {\n  if (VerifierClass) return VerifierClass;\n  const mod = await import('@pact-foundation/pact');\n  const Verifier = (mod as { Verifier?: VerifierConstructor }).Verifier;\n  if (!Verifier) {\n    throw new Error(\n      'autotel-pact: @pact-foundation/pact Verifier not found. Install the peer dependency.',\n    );\n  }\n  return Verifier;\n}\n\n/**\n * Wrap provider verification — records per-interaction evidence only on success.\n */\nexport async function withProviderVerification(\n  verifierOpts: VerifierOptionsLike,\n  wrapOpts: WithProviderVerificationOptions = {},\n): Promise<void> {\n  const pactPaths = resolvePactPaths(verifierOpts);\n  const provider = verifierOpts.provider;\n  const consumer = inferConsumerFromPacts(pactPaths, wrapOpts.consumer);\n  const spanName = wrapOpts.spanName ?? 'pact.verification';\n  const start = process.hrtime.bigint();\n  const Verifier = wrapOpts.skipVerifier ? undefined : await loadVerifier(wrapOpts.Verifier);\n\n  return autotelSpan(spanName, async () => {\n    const span = getActiveSpan();\n    span?.setAttributes({\n      [PACT_ATTRS.CONSUMER]: consumer,\n      [PACT_ATTRS.PROVIDER]: provider,\n      [PACT_ATTRS.KIND]: pactPaths.length === 1 ? kindForPactFile(pactPaths[0]!) : 'message',\n      'pact.role': 'provider',\n    });\n\n    try {\n      if (Verifier) {\n        await new Verifier(verifierOpts).verifyProvider();\n      }\n      span?.setAttributes({ [PACT_ATTRS.OUTCOME]: 'passed' });\n\n      const ctx = span?.spanContext();\n      const base = {\n        source: 'test' as const,\n        role: 'provider' as const,\n        outcome: 'passed' as const,\n        observed_at: new Date().toISOString(),\n        trace_id: ctx?.traceId,\n        span_id: ctx?.spanId,\n        run_id: process.env.AUTOTEL_PACT_RUN_ID,\n        git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA,\n      };\n\n      for (const filePath of pactPaths) {\n        const pact = parsePactFile(filePath);\n        if (!pact) continue;\n        const interactions = interactionsFromPactFile(pact);\n        for (const i of interactions) {\n          const entry: InteractionLedgerEntry = {\n            type: 'interaction',\n            spec: LEDGER_ENTRY_SPEC,\n            consumer: i.consumer,\n            provider: i.provider,\n            interaction: i.interaction,\n            interaction_id: i.interactionId,\n            states: [],\n            kind: i.kind,\n            duration_ms: Number(process.hrtime.bigint() - start) / 1e6,\n            ...base,\n          };\n          appendLedgerEntry(entry, wrapOpts);\n        }\n      }\n    } catch (error) {\n      span?.setAttributes({ [PACT_ATTRS.OUTCOME]: 'failed' });\n      const message = error instanceof Error ? error.message : String(error);\n      const ctx = span?.spanContext();\n      appendProviderVerificationFailure(\n        {\n          consumer,\n          provider,\n          source: 'test',\n          observed_at: new Date().toISOString(),\n          error: message,\n          trace_id: ctx?.traceId,\n          span_id: ctx?.spanId,\n          run_id: process.env.AUTOTEL_PACT_RUN_ID,\n          git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA,\n        },\n        wrapOpts,\n      );\n      throw error;\n    }\n  });\n}\n"]}

package/dist/tag.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+var autotel = require('autotel');
+
+// src/tag.ts
+
+// src/attrs.ts
+var PACT_ATTRS = {
+  CONSUMER: "pact.consumer",
+  PROVIDER: "pact.provider",
+  KIND: "pact.kind",
+  INTERACTION_DESCRIPTION: "pact.interaction.description",
+  INTERACTION_ID: "pact.interaction.id",
+  INTERACTION_STATES: "pact.interaction.states",
+  CONTRACT_FILE: "pact.contract.file"};
+function buildPactAttributes(meta, opts = {}) {
+  const attrs = {
+    [PACT_ATTRS.CONSUMER]: meta.consumer,
+    [PACT_ATTRS.PROVIDER]: meta.provider,
+    [PACT_ATTRS.KIND]: meta.kind,
+    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,
+    [PACT_ATTRS.INTERACTION_STATES]: meta.states
+  };
+  if (opts.contractFile) {
+    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;
+  }
+  if (meta.interactionId) {
+    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;
+  }
+  return attrs;
+}
+
+// src/tag.ts
+function tagPactInteraction(meta) {
+  const span = autotel.getActiveSpan();
+  if (!span) {
+    throw new Error(
+      "autotel-pact: tagPactInteraction requires an active span. Wrap the handler with trace() first."
+    );
+  }
+  const attrs = buildPactAttributes(meta);
+  span.setAttributes(attrs);
+  if (meta.interactionId) {
+    span.setAttribute(PACT_ATTRS.INTERACTION_ID, meta.interactionId);
+  }
+}
+
+exports.tagPactInteraction = tagPactInteraction;
+//# sourceMappingURL=tag.cjs.map
+//# sourceMappingURL=tag.cjs.map

package/dist/tag.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/attrs.ts","../src/tag.ts"],"names":["getActiveSpan"],"mappings":";;;;;;;AAOO,IAAM,UAAA,GAAa;AAAA,EACxB,QAAA,EAAU,eAAA;AAAA,EACV,QAAA,EAAU,eAAA;AAAA,EACV,IAAA,EAAM,WAAA;AAAA,EACN,uBAAA,EAAyB,8BAAA;AAAA,EACzB,cAAA,EAAgB,qBAAA;AAAA,EAChB,kBAAA,EAAoB,yBAAA;AAAA,EACpB,aAAA,EAAe,oBAEjB,CAAA;AAQO,SAAS,mBAAA,CACd,IAAA,EACA,IAAA,GAAkC,EAAC,EACA;AACnC,EAAA,MAAM,KAAA,GAA2C;AAAA,IAC/C,CAAC,UAAA,CAAW,QAAQ,GAAG,IAAA,CAAK,QAAA;AAAA,IAC5B,CAAC,UAAA,CAAW,QAAQ,GAAG,IAAA,CAAK,QAAA;AAAA,IAC5B,CAAC,UAAA,CAAW,IAAI,GAAG,IAAA,CAAK,IAAA;AAAA,IACxB,CAAC,UAAA,CAAW,uBAAuB,GAAG,IAAA,CAAK,WAAA;AAAA,IAC3C,CAAC,UAAA,CAAW,kBAAkB,GAAG,IAAA,CAAK;AAAA,GACxC;AACA,EAAA,IAAI,KAAK,YAAA,EAAc;AACrB,IAAA,KAAA,CAAM,UAAA,CAAW,aAAa,CAAA,GAAI,IAAA,CAAK,YAAA;AAAA,EACzC;AACA,EAAA,IAAI,KAAK,aAAA,EAAe;AACtB,IAAA,KAAA,CAAM,UAAA,CAAW,cAAc,CAAA,GAAI,IAAA,CAAK,aAAA;AAAA,EAC1C;AACA,EAAA,OAAO,KAAA;AACT;;;AClCO,SAAS,mBAAmB,IAAA,EAAiC;AAClE,EAAA,MAAM,OAAOA,qBAAA,EAAc;AAC3B,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,MAAM,KAAA,GAAQ,oBAAoB,IAAI,CAAA;AACtC,EAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AACxB,EAAA,IAAI,KAAK,aAAA,EAAe;AACtB,IAAA,IAAA,CAAK,YAAA,CAAa,UAAA,CAAW,cAAA,EAAgB,IAAA,CAAK,aAAa,CAAA;AAAA,EACjE;AACF","file":"tag.cjs","sourcesContent":["import type { PactInteractionMeta, PactOutcome } from './types.js';\n\n/**\n * Attribute keys for Pact interactions. Centralised so the namespace is\n * a single source of truth and is forward-compatible with eventual OTel\n * semantic conventions.\n */\nexport const PACT_ATTRS = {\n  CONSUMER: 'pact.consumer',\n  PROVIDER: 'pact.provider',\n  KIND: 'pact.kind',\n  INTERACTION_DESCRIPTION: 'pact.interaction.description',\n  INTERACTION_ID: 'pact.interaction.id',\n  INTERACTION_STATES: 'pact.interaction.states',\n  CONTRACT_FILE: 'pact.contract.file',\n  OUTCOME: 'pact.outcome',\n} as const;\n\nexport type PactAttributeKey = (typeof PACT_ATTRS)[keyof typeof PACT_ATTRS];\n\n/**\n * Build the set of attributes to stamp on a span when an interaction is\n * about to be exercised. `outcome` is added later by the wrapper.\n */\nexport function buildPactAttributes(\n  meta: PactInteractionMeta,\n  opts: { contractFile?: string } = {},\n): Record<string, string | string[]> {\n  const attrs: Record<string, string | string[]> = {\n    [PACT_ATTRS.CONSUMER]: meta.consumer,\n    [PACT_ATTRS.PROVIDER]: meta.provider,\n    [PACT_ATTRS.KIND]: meta.kind,\n    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,\n    [PACT_ATTRS.INTERACTION_STATES]: meta.states,\n  };\n  if (opts.contractFile) {\n    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;\n  }\n  if (meta.interactionId) {\n    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;\n  }\n  return attrs;\n}\n\n/**\n * Helper that returns just the outcome attribute — stamped after the\n * handler resolves or rejects.\n */\nexport function outcomeAttribute(\n  outcome: PactOutcome,\n): Record<string, string> {\n  return { [PACT_ATTRS.OUTCOME]: outcome };\n}\n","import { getActiveSpan } from 'autotel';\nimport { buildPactAttributes, PACT_ATTRS } from './attrs.js';\nimport type { PactInteractionMeta } from './types.js';\n\n/**\n * Stamp `pact.*` attributes on the active span for production observation.\n * Requires an active span (wrap handlers with `trace()` first).\n */\nexport function tagPactInteraction(meta: PactInteractionMeta): void {\n  const span = getActiveSpan();\n  if (!span) {\n    throw new Error(\n      'autotel-pact: tagPactInteraction requires an active span. Wrap the handler with trace() first.',\n    );\n  }\n  const attrs = buildPactAttributes(meta);\n  span.setAttributes(attrs);\n  if (meta.interactionId) {\n    span.setAttribute(PACT_ATTRS.INTERACTION_ID, meta.interactionId);\n  }\n}\n"]}

package/dist/tag.d.cts

@@ -0,0 +1,9 @@
+import { P as PactInteractionMeta } from './types-BHGiwqcp.cjs';
+
+/**
+ * Stamp `pact.*` attributes on the active span for production observation.
+ * Requires an active span (wrap handlers with `trace()` first).
+ */
+declare function tagPactInteraction(meta: PactInteractionMeta): void;
+
+export { tagPactInteraction };

package/dist/tag.d.ts

@@ -0,0 +1,9 @@
+import { P as PactInteractionMeta } from './types-BHGiwqcp.js';
+
+/**
+ * Stamp `pact.*` attributes on the active span for production observation.
+ * Requires an active span (wrap handlers with `trace()` first).
+ */
+declare function tagPactInteraction(meta: PactInteractionMeta): void;
+
+export { tagPactInteraction };

package/dist/tag.js

@@ -0,0 +1,48 @@
+import { getActiveSpan } from 'autotel';
+
+// src/tag.ts
+
+// src/attrs.ts
+var PACT_ATTRS = {
+  CONSUMER: "pact.consumer",
+  PROVIDER: "pact.provider",
+  KIND: "pact.kind",
+  INTERACTION_DESCRIPTION: "pact.interaction.description",
+  INTERACTION_ID: "pact.interaction.id",
+  INTERACTION_STATES: "pact.interaction.states",
+  CONTRACT_FILE: "pact.contract.file"};
+function buildPactAttributes(meta, opts = {}) {
+  const attrs = {
+    [PACT_ATTRS.CONSUMER]: meta.consumer,
+    [PACT_ATTRS.PROVIDER]: meta.provider,
+    [PACT_ATTRS.KIND]: meta.kind,
+    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,
+    [PACT_ATTRS.INTERACTION_STATES]: meta.states
+  };
+  if (opts.contractFile) {
+    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;
+  }
+  if (meta.interactionId) {
+    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;
+  }
+  return attrs;
+}
+
+// src/tag.ts
+function tagPactInteraction(meta) {
+  const span = getActiveSpan();
+  if (!span) {
+    throw new Error(
+      "autotel-pact: tagPactInteraction requires an active span. Wrap the handler with trace() first."
+    );
+  }
+  const attrs = buildPactAttributes(meta);
+  span.setAttributes(attrs);
+  if (meta.interactionId) {
+    span.setAttribute(PACT_ATTRS.INTERACTION_ID, meta.interactionId);
+  }
+}
+
+export { tagPactInteraction };
+//# sourceMappingURL=tag.js.map
+//# sourceMappingURL=tag.js.map

package/dist/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/attrs.ts","../src/tag.ts"],"names":[],"mappings":";;;;;AAOO,IAAM,UAAA,GAAa;AAAA,EACxB,QAAA,EAAU,eAAA;AAAA,EACV,QAAA,EAAU,eAAA;AAAA,EACV,IAAA,EAAM,WAAA;AAAA,EACN,uBAAA,EAAyB,8BAAA;AAAA,EACzB,cAAA,EAAgB,qBAAA;AAAA,EAChB,kBAAA,EAAoB,yBAAA;AAAA,EACpB,aAAA,EAAe,oBAEjB,CAAA;AAQO,SAAS,mBAAA,CACd,IAAA,EACA,IAAA,GAAkC,EAAC,EACA;AACnC,EAAA,MAAM,KAAA,GAA2C;AAAA,IAC/C,CAAC,UAAA,CAAW,QAAQ,GAAG,IAAA,CAAK,QAAA;AAAA,IAC5B,CAAC,UAAA,CAAW,QAAQ,GAAG,IAAA,CAAK,QAAA;AAAA,IAC5B,CAAC,UAAA,CAAW,IAAI,GAAG,IAAA,CAAK,IAAA;AAAA,IACxB,CAAC,UAAA,CAAW,uBAAuB,GAAG,IAAA,CAAK,WAAA;AAAA,IAC3C,CAAC,UAAA,CAAW,kBAAkB,GAAG,IAAA,CAAK;AAAA,GACxC;AACA,EAAA,IAAI,KAAK,YAAA,EAAc;AACrB,IAAA,KAAA,CAAM,UAAA,CAAW,aAAa,CAAA,GAAI,IAAA,CAAK,YAAA;AAAA,EACzC;AACA,EAAA,IAAI,KAAK,aAAA,EAAe;AACtB,IAAA,KAAA,CAAM,UAAA,CAAW,cAAc,CAAA,GAAI,IAAA,CAAK,aAAA;AAAA,EAC1C;AACA,EAAA,OAAO,KAAA;AACT;;;AClCO,SAAS,mBAAmB,IAAA,EAAiC;AAClE,EAAA,MAAM,OAAO,aAAA,EAAc;AAC3B,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,MAAM,KAAA,GAAQ,oBAAoB,IAAI,CAAA;AACtC,EAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AACxB,EAAA,IAAI,KAAK,aAAA,EAAe;AACtB,IAAA,IAAA,CAAK,YAAA,CAAa,UAAA,CAAW,cAAA,EAAgB,IAAA,CAAK,aAAa,CAAA;AAAA,EACjE;AACF","file":"tag.js","sourcesContent":["import type { PactInteractionMeta, PactOutcome } from './types.js';\n\n/**\n * Attribute keys for Pact interactions. Centralised so the namespace is\n * a single source of truth and is forward-compatible with eventual OTel\n * semantic conventions.\n */\nexport const PACT_ATTRS = {\n  CONSUMER: 'pact.consumer',\n  PROVIDER: 'pact.provider',\n  KIND: 'pact.kind',\n  INTERACTION_DESCRIPTION: 'pact.interaction.description',\n  INTERACTION_ID: 'pact.interaction.id',\n  INTERACTION_STATES: 'pact.interaction.states',\n  CONTRACT_FILE: 'pact.contract.file',\n  OUTCOME: 'pact.outcome',\n} as const;\n\nexport type PactAttributeKey = (typeof PACT_ATTRS)[keyof typeof PACT_ATTRS];\n\n/**\n * Build the set of attributes to stamp on a span when an interaction is\n * about to be exercised. `outcome` is added later by the wrapper.\n */\nexport function buildPactAttributes(\n  meta: PactInteractionMeta,\n  opts: { contractFile?: string } = {},\n): Record<string, string | string[]> {\n  const attrs: Record<string, string | string[]> = {\n    [PACT_ATTRS.CONSUMER]: meta.consumer,\n    [PACT_ATTRS.PROVIDER]: meta.provider,\n    [PACT_ATTRS.KIND]: meta.kind,\n    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,\n    [PACT_ATTRS.INTERACTION_STATES]: meta.states,\n  };\n  if (opts.contractFile) {\n    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;\n  }\n  if (meta.interactionId) {\n    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;\n  }\n  return attrs;\n}\n\n/**\n * Helper that returns just the outcome attribute — stamped after the\n * handler resolves or rejects.\n */\nexport function outcomeAttribute(\n  outcome: PactOutcome,\n): Record<string, string> {\n  return { [PACT_ATTRS.OUTCOME]: outcome };\n}\n","import { getActiveSpan } from 'autotel';\nimport { buildPactAttributes, PACT_ATTRS } from './attrs.js';\nimport type { PactInteractionMeta } from './types.js';\n\n/**\n * Stamp `pact.*` attributes on the active span for production observation.\n * Requires an active span (wrap handlers with `trace()` first).\n */\nexport function tagPactInteraction(meta: PactInteractionMeta): void {\n  const span = getActiveSpan();\n  if (!span) {\n    throw new Error(\n      'autotel-pact: tagPactInteraction requires an active span. Wrap the handler with trace() first.',\n    );\n  }\n  const attrs = buildPactAttributes(meta);\n  span.setAttributes(attrs);\n  if (meta.interactionId) {\n    span.setAttribute(PACT_ATTRS.INTERACTION_ID, meta.interactionId);\n  }\n}\n"]}

package/dist/types-BHGiwqcp.d.cts

@@ -0,0 +1,157 @@
+/**
+ * Kind of contract interaction observed.
+ */
+type PactKind = 'message' | 'http';
+type PactOutcome = 'passed' | 'failed';
+type LedgerSource = 'test' | 'production';
+type LedgerRole = 'consumer' | 'provider';
+declare const LEDGER_ENTRY_SPEC = "autotel-pact-ledger-entry/v0.2.0";
+declare const AUDIT_MATRIX_SPEC = "autotel-pact-audit-matrix/v0.2.0";
+/**
+ * Metadata about a single Pact interaction, derived from the reified message
+ * plus the consumer/provider config. Stamped onto the span and the ledger entry.
+ */
+interface PactInteractionMeta {
+    consumer: string;
+    provider: string;
+    description: string;
+    states: string[];
+    kind: PactKind;
+    interactionId?: string;
+}
+/**
+ * Per-interaction ledger evidence (consumer exercise, provider verify, or production tag).
+ */
+interface InteractionLedgerEntry {
+    type?: 'interaction';
+    spec: typeof LEDGER_ENTRY_SPEC;
+    consumer: string;
+    provider: string;
+    interaction: string;
+    interaction_id?: string;
+    states: string[];
+    kind: PactKind;
+    outcome: PactOutcome;
+    source: LedgerSource;
+    role: LedgerRole;
+    duration_ms: number;
+    observed_at: string;
+    trace_id?: string;
+    span_id?: string;
+    run_id?: string;
+    git_sha?: string;
+    error?: string;
+}
+/**
+ * Run-level provider verification failure — does not imply per-interaction outcomes.
+ */
+interface ProviderVerificationRunEntry {
+    type: 'provider_verification_run';
+    spec: typeof LEDGER_ENTRY_SPEC;
+    consumer: string;
+    provider: string;
+    outcome: 'failed';
+    source: LedgerSource;
+    role: 'provider';
+    observed_at: string;
+    error: string;
+    run_id?: string;
+    git_sha?: string;
+    trace_id?: string;
+    span_id?: string;
+}
+type LedgerRecord = InteractionLedgerEntry | ProviderVerificationRunEntry;
+declare function isInteractionLedgerEntry(entry: LedgerRecord): entry is InteractionLedgerEntry;
+declare function isProviderVerificationRun(entry: LedgerRecord): entry is ProviderVerificationRunEntry;
+/**
+ * Shape of a Pact contract file on disk (subset we read).
+ */
+interface PactFile {
+    consumer: {
+        name: string;
+    };
+    provider: {
+        name: string;
+    };
+    messages?: Array<{
+        description: string;
+        providerStates?: Array<{
+            name: string;
+        }>;
+        metadata?: Record<string, unknown>;
+    }>;
+    interactions?: Array<{
+        description: string;
+        providerStates?: Array<{
+            name: string;
+        }>;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+interface BrokerVerification {
+    consumer: string;
+    provider: string;
+    success: boolean;
+    verifiedAt?: string;
+    /**
+     * Populated when the broker could not be reached or returned a non-2xx
+     * response. Distinguishes "broker said the pact is not verified" (no error)
+     * from "we could not determine verification status" (error set).
+     */
+    error?: string;
+}
+/**
+ * One row in the audit matrix.
+ */
+interface AuditRow {
+    consumer: string;
+    provider: string;
+    interaction: string;
+    interaction_id?: string;
+    kind: PactKind;
+    contracted: boolean;
+    /** Any interaction-level ledger hit in the window (test or production). */
+    observed: boolean;
+    test_seen: boolean;
+    prod_seen: boolean;
+    provider_verified: boolean;
+    broker_verified: boolean;
+    broker_verified_at?: string;
+    /** Set when the broker check failed (network error, non-2xx, parse error). */
+    broker_error?: string;
+    last_observed_at?: string;
+    last_outcome?: PactOutcome;
+}
+interface AuditMatrix {
+    spec: typeof AUDIT_MATRIX_SPEC;
+    rows: AuditRow[];
+    counts: {
+        total: number;
+        /** Any contracted row. */
+        contracted: number;
+        /** Any row with test_seen OR prod_seen. */
+        observed: number;
+        /** Contracted AND seen in a consumer test. */
+        contracted_and_test_seen: number;
+        /** Contracted but not seen in a consumer test (stale confidence). */
+        contracted_not_test_seen: number;
+        /** Seen (test or production) without a matching contract (ungoverned flow). */
+        test_or_prod_seen_not_contracted: number;
+        test_seen: number;
+        prod_seen: number;
+        provider_verified: number;
+        broker_verified: number;
+    };
+    window_days: number;
+    generated_at: string;
+    verification_failures?: ProviderVerificationRunEntry[];
+}
+interface PactInteractionKey {
+    consumer: string;
+    provider: string;
+    interaction: string;
+    kind: PactKind;
+    interactionId?: string;
+}
+
+export { AUDIT_MATRIX_SPEC as A, type BrokerVerification as B, type InteractionLedgerEntry as I, LEDGER_ENTRY_SPEC as L, type PactInteractionMeta as P, type PactOutcome as a, type PactFile as b, type PactInteractionKey as c, type AuditMatrix as d, type AuditRow as e, type LedgerRecord as f, type LedgerRole as g, type LedgerSource as h, type PactKind as i, type ProviderVerificationRunEntry as j, isInteractionLedgerEntry as k, isProviderVerificationRun as l };