@contractspec/lib.contracts 1.62.0 → 1.64.0

package/dist/server/rest-next-pages.js

@@ -1,211 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/jsonschema.ts
-import z from "zod";
-function jsonSchemaForSpec(spec) {
-  return {
-    input: spec.io.input ? z.toJSONSchema(spec.io.input.getZod()) : null,
-    output: spec.io.output ? z.toJSONSchema(spec.io.output.getZod()) : null,
-    meta: {
-      name: spec.meta.key,
-      version: spec.meta.version,
-      kind: spec.meta.kind,
-      description: spec.meta.description,
-      tags: spec.meta.tags ?? [],
-      stability: spec.meta.stability ?? "stable"
-    }
-  };
-}
-function defaultRestPath(name, version) {
-  return `/${name.replace(/\./g, "/")}/v${version}`;
-}
-function sanitizeMcpName(name) {
-  const sanitized = name.replace(/\./g, "_");
-  return sanitized.slice(0, 64);
-}
-function defaultMcpTool(name, version) {
-  const safeName = name.replace(/\./g, "_");
-  const safeVersion = version.replace(/\./g, "_");
-  return `${safeName}-v${safeVersion}`;
-}
-function defaultMcpPrompt(key) {
-  return sanitizeMcpName(key);
-}
-function defaultGqlField(name, version) {
-  return `${name.replace(/\./g, "_")}_v${version}`;
-}
-
-// src/server/rest-generic.ts
-function corsHeaders(opt) {
-  const h = {};
-  const origin = typeof opt === "object" ? opt.origin ?? "*" : "*";
-  h["access-control-allow-origin"] = origin;
-  h["vary"] = "Origin";
-  if (typeof opt === "object") {
-    if (opt.methods)
-      h["access-control-allow-methods"] = opt.methods.join(", ");
-    if (opt.headers)
-      h["access-control-allow-headers"] = opt.headers.join(", ");
-    if (opt.credentials)
-      h["access-control-allow-credentials"] = "true";
-    if (typeof opt.maxAge === "number")
-      h["access-control-max-age"] = String(opt.maxAge);
-  } else {
-    h["access-control-allow-methods"] = "GET,POST,OPTIONS";
-    h["access-control-allow-headers"] = "content-type,x-idempotency-key,x-trace-id";
-  }
-  return h;
-}
-function joinPath(a, b) {
-  const left = (a ?? "").replace(/\/+$/g, "");
-  const right = b.replace(/^\/+/g, "");
-  return `${left}/${right}`.replace(/\/{2,}/g, "/");
-}
-function createFetchHandler(reg, ctxFactory, options) {
-  const opts = {
-    basePath: options?.basePath ?? "",
-    cors: options?.cors ?? false,
-    prettyJson: options?.prettyJson ?? false,
-    onError: options?.onError
-  };
-  const routes = reg.list().map((spec) => ({
-    method: spec.transport?.rest?.method ?? (spec.meta.kind === "query" ? "GET" : "POST"),
-    path: joinPath(opts.basePath, spec.transport?.rest?.path ?? defaultRestPath(spec.meta.key, spec.meta.version)),
-    name: spec.meta.key,
-    version: spec.meta.version
-  }));
-  const routeTable = new Map;
-  for (const r of routes)
-    routeTable.set(`${r.method} ${r.path}`, r);
-  const makeJson = (status, data, extraHeaders) => {
-    const body = opts.prettyJson ? JSON.stringify(data, null, opts.prettyJson) : JSON.stringify(data);
-    const base = {
-      "content-type": "application/json; charset=utf-8"
-    };
-    return new Response(body, {
-      status,
-      headers: extraHeaders ? { ...base, ...extraHeaders } : base
-    });
-  };
-  return async function handle(req) {
-    const url = new URL(req.url);
-    const key = `${req.method.toUpperCase()} ${url.pathname}`;
-    if (opts.cors && req.method.toUpperCase() === "OPTIONS") {
-      const h = corsHeaders(opts.cors === true ? {} : opts.cors);
-      return new Response(null, {
-        status: 204,
-        headers: { ...h, "content-length": "0" }
-      });
-    }
-    const route = routeTable.get(key);
-    if (!route) {
-      const headers = {};
-      if (opts.cors)
-        Object.assign(headers, corsHeaders(opts.cors === true ? {} : opts.cors));
-      return makeJson(404, { error: "NotFound", path: url.pathname }, headers);
-    }
-    try {
-      let input = {};
-      if (route.method === "GET") {
-        if (url.searchParams.has("input")) {
-          const raw = url.searchParams.get("input");
-          input = raw ? JSON.parse(raw) : {};
-        } else {
-          const obj = {};
-          for (const [k, v] of url.searchParams.entries())
-            obj[k] = v;
-          input = obj;
-        }
-      } else {
-        const contentType = req.headers.get("content-type") || "";
-        if (contentType.includes("application/json")) {
-          input = await req.json();
-        } else if (contentType.includes("application/x-www-form-urlencoded")) {
-          const form = await req.formData();
-          input = Object.fromEntries(form.entries());
-        } else if (!contentType) {
-          input = {};
-        } else {
-          return makeJson(415, { error: "UnsupportedMediaType", contentType });
-        }
-      }
-      const ctx = ctxFactory(req);
-      const result = await reg.execute(route.name, route.version, input, ctx);
-      const headers = {};
-      if (opts.cors)
-        Object.assign(headers, corsHeaders(opts.cors === true ? {} : opts.cors));
-      return makeJson(200, result, headers);
-    } catch (err) {
-      if (opts.onError) {
-        const mapped = opts.onError(err);
-        const headers2 = {};
-        if (opts.cors)
-          Object.assign(headers2, corsHeaders(opts.cors === true ? {} : opts.cors));
-        return makeJson(mapped.status, mapped.body, headers2);
-      }
-      const headers = {};
-      if (opts.cors)
-        Object.assign(headers, corsHeaders(opts.cors === true ? {} : opts.cors));
-      if (err?.issues)
-        return makeJson(400, {
-          error: "ValidationError",
-          issues: err.issues
-        }, headers);
-      if (typeof err?.message === "string" && err.message.startsWith("PolicyDenied")) {
-        return makeJson(403, { error: "PolicyDenied" }, headers);
-      }
-      return makeJson(500, { error: "InternalError" }, headers);
-    }
-  };
-}
-
-// src/server/rest-next-pages.ts
-function makeNextPagesHandler(reg, ctxFactory, options) {
-  return async function handler(req, res) {
-    const url = `${req.headers["x-forwarded-proto"] ?? "http"}://${req.headers.host}${req.url}`;
-    const method = req.method?.toUpperCase() || "GET";
-    const request = new Request(url, {
-      method,
-      headers: Object.fromEntries(Object.entries(req.headers).map(([k, v]) => [k, String(v)])),
-      body: method === "POST" ? JSON.stringify(req.body ?? {}) : undefined
-    });
-    const perReqHandler = createFetchHandler(reg, () => ctxFactory(req), options);
-    const response = await perReqHandler(request);
-    res.status(response.status);
-    response.headers.forEach((v, k) => res.setHeader(k, v));
-    const text = await response.text();
-    res.send(text);
-  };
-}
-export {
-  makeNextPagesHandler
-};

package/dist/telemetry/anomaly.d.ts

@@ -1,24 +0,0 @@
-import type { TelemetryDispatch } from './tracker';
-import type { TelemetryAnomalyDetectionConfig } from './spec';
-export interface TelemetryAnomalyEvent {
-    dispatch: TelemetryDispatch;
-    threshold: TelemetryAnomalyDetectionConfig;
-    metric: string;
-    value: number | undefined;
-    type: 'min' | 'max';
-}
-export interface TelemetryAnomalyMonitorOptions {
-    onAnomaly?: (event: TelemetryAnomalyEvent) => void;
-    now?: () => Date;
-}
-export declare class TelemetryAnomalyMonitor {
-    private readonly onAnomaly?;
-    private readonly now;
-    private readonly samples;
-    constructor(options?: TelemetryAnomalyMonitorOptions);
-    observe(dispatch: TelemetryDispatch): void;
-    private extractMetric;
-    private emit;
-    reset(): void;
-}
-//# sourceMappingURL=anomaly.d.ts.map

package/dist/telemetry/anomaly.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../../src/telemetry/anomaly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,QAAQ,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,+BAA+B,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,OAAO,GAAE,8BAAmC;IAKxD,OAAO,CAAC,QAAQ,EAAE,iBAAiB;IA6BnC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,IAAI;IAgBZ,KAAK;CAGN"}

package/dist/telemetry/anomaly.js

@@ -1,91 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/telemetry/anomaly.ts
-class TelemetryAnomalyMonitor {
-  onAnomaly;
-  now;
-  samples = new Map;
-  constructor(options = {}) {
-    this.onAnomaly = options.onAnomaly;
-    this.now = options.now ?? (() => new Date);
-  }
-  observe(dispatch) {
-    const anomalyConfig = dispatch.definition.anomalyDetection;
-    if (!anomalyConfig?.enabled)
-      return;
-    if (!anomalyConfig.thresholds?.length)
-      return;
-    const eventKey = `${dispatch.name}.v${dispatch.version}`;
-    const count = this.samples.get(eventKey) ?? 0;
-    const newCount = count + 1;
-    this.samples.set(eventKey, newCount);
-    if (typeof anomalyConfig.minimumSample === "number" && newCount < anomalyConfig.minimumSample) {
-      return;
-    }
-    for (const threshold of anomalyConfig.thresholds) {
-      const value = this.extractMetric(dispatch, threshold.metric);
-      if (typeof value !== "number")
-        continue;
-      if (typeof threshold.min === "number" && value < threshold.min) {
-        this.emit(dispatch, anomalyConfig, threshold.metric, value, "min");
-      }
-      if (typeof threshold.max === "number" && value > threshold.max) {
-        this.emit(dispatch, anomalyConfig, threshold.metric, value, "max");
-      }
-    }
-  }
-  extractMetric(dispatch, metric) {
-    const value = dispatch.properties[metric];
-    if (typeof value === "number")
-      return value;
-    if (typeof value === "object" && value !== null && "value" in value) {
-      const maybeNumber = value.value;
-      return typeof maybeNumber === "number" ? maybeNumber : undefined;
-    }
-    return;
-  }
-  emit(dispatch, threshold, metric, value, type) {
-    this.onAnomaly?.({
-      dispatch,
-      threshold,
-      metric,
-      value,
-      type
-    });
-  }
-  reset() {
-    this.samples.clear();
-  }
-}
-export {
-  TelemetryAnomalyMonitor
-};

package/dist/telemetry/anomaly.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=anomaly.test.d.ts.map

package/dist/telemetry/anomaly.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"anomaly.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/anomaly.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/docs/telemetry.docblock.d.ts

@@ -1,3 +0,0 @@
-import type { DocBlock } from '@contractspec/lib.contracts/docs';
-export declare const tech_contracts_telemetry_DocBlocks: DocBlock[];
-//# sourceMappingURL=telemetry.docblock.d.ts.map

package/dist/telemetry/docs/telemetry.docblock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.docblock.d.ts","sourceRoot":"","sources":["../../../src/telemetry/docs/telemetry.docblock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,kCAAkC,EAAE,QAAQ,EAYxD,CAAC"}

package/dist/telemetry/docs/telemetry.docblock.js

@@ -1,164 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/docs/presentations.ts
-var DEFAULT_TARGETS = [
-  "markdown",
-  "react"
-];
-function normalizeRoute(route) {
-  if (!route.length)
-    return "/";
-  const withLeading = route.startsWith("/") ? route : `/${route}`;
-  return withLeading === "/" ? "/" : withLeading.replace(/\/+$/, "");
-}
-function deriveRoute(block, routePrefix) {
-  if (block.route)
-    return normalizeRoute(block.route);
-  const prefix = routePrefix ?? "/docs";
-  const slug = block.id.replace(/^docs\.?/, "").replace(/\./g, "/").replace(/\/+/g, "/");
-  const path = slug.startsWith("/") ? slug : `${prefix}/${slug}`;
-  return normalizeRoute(path);
-}
-function buildName(block, namespace) {
-  return namespace ? `${namespace}.${block.id}` : block.id;
-}
-function docBlockToPresentationSpec(block, options) {
-  const targets = options?.defaultTargets ?? DEFAULT_TARGETS;
-  const version = block.version ?? options?.defaultVersion ?? "1.0.0";
-  const stability = block.stability ?? options?.defaultStability ?? "stable";
-  return {
-    meta: {
-      key: buildName(block, options?.namespace),
-      title: block.title,
-      version,
-      description: block.summary ?? block.title,
-      tags: block.tags || [],
-      owners: block.owners || [],
-      domain: block.domain || "",
-      stability,
-      goal: `Documentation of: ${block.summary}`,
-      context: `Auto-generated`
-    },
-    policy: block.visibility && block.visibility !== "public" ? { flags: [block.visibility] } : undefined,
-    source: {
-      type: "blocknotejs",
-      docJson: block.body
-    },
-    targets
-  };
-}
-function docBlocksToPresentationRoutes(blocks, options) {
-  return blocks.map((block) => ({
-    block,
-    route: deriveRoute(block, options?.routePrefix),
-    descriptor: docBlockToPresentationSpec(block, options)
-  }));
-}
-function docBlocksToPresentationSpecs(blocks, options) {
-  return blocks.map((block) => docBlockToPresentationSpec(block, options));
-}
-function mapDocRoutes(routes) {
-  return routes.map(({ route, descriptor }) => [route, descriptor]);
-}
-
-// src/docs/registry.ts
-class DocRegistry {
-  routes = new Map;
-  constructor(blocks = [], options) {
-    blocks.forEach((block) => this.register(block, options));
-  }
-  register(block, options) {
-    const [route] = docBlocksToPresentationRoutes([block], options);
-    if (route) {
-      this.routes.set(block.id, route);
-    }
-    return this;
-  }
-  list() {
-    return [...this.routes.values()];
-  }
-  get(id) {
-    return this.routes.get(id);
-  }
-  toRouteTuples() {
-    return this.list().map(({ route, descriptor }) => [route, descriptor]);
-  }
-  toPresentationSpecs(options) {
-    return this.list().map(({ block }) => docBlockToPresentationSpec(block, options));
-  }
-}
-var requiredFields = [
-  "id",
-  "title",
-  "body",
-  "kind",
-  "visibility",
-  "route"
-];
-var defaultDocRegistry = new DocRegistry;
-function registerDocBlocks(blocks) {
-  for (const block of blocks) {
-    for (const field of requiredFields) {
-      if (!block[field]) {
-        throw new Error(`DocBlock ${block.id ?? "<missing id>"} missing field ${String(field)}`);
-      }
-    }
-    defaultDocRegistry.register(block);
-  }
-}
-function listRegisteredDocBlocks() {
-  return defaultDocRegistry.list().map((r) => r.block);
-}
-function docId(id) {
-  const found = defaultDocRegistry.get(id);
-  if (!found)
-    throw new Error(`DocBlock not registered: ${id}`);
-  return id;
-}
-
-// src/telemetry/docs/telemetry.docblock.ts
-var tech_contracts_telemetry_DocBlocks = [
-  {
-    id: "docs.tech.contracts.telemetry",
-    title: "TelemetrySpec",
-    summary: "Telemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/tech/contracts/telemetry",
-    tags: ["tech", "contracts", "telemetry"],
-    body: "## TelemetrySpec\n\nTelemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.\n\n- **File location**: `packages/libs/contracts/src/telemetry/spec.ts`\n- **Runtime tracker**: `packages/libs/contracts/src/telemetry/tracker.ts`\n- **Anomaly monitor**: `packages/libs/contracts/src/telemetry/anomaly.ts`\n\n### Core concepts\n\n```ts\nexport interface TelemetrySpec {\n  meta: TelemetryMeta;\n  events: TelemetryEventDef[];\n  config?: TelemetryConfig;\n}\n```\n\n- `meta`: ownership + identifiers (`name`, `version`, `domain`)\n- `events`: per-event semantics, property definitions, privacy level, retention, sampling, anomaly rules\n- `config`: defaults and provider configuration\n- `TelemetryRegistry`: registers specs, resolves latest version, finds event definitions by name/version\n\n### An example\n\n```ts\nexport const SigilTelemetry: TelemetrySpec = {\n  meta: {\n    name: 'sigil.telemetry',\n    version: '1.0.0',\n    title: 'Sigil telemetry',\n    description: 'Core Sigil product telemetry',\n    domain: 'sigil',\n    owners: ['@team.analytics'],\n    tags: ['telemetry'],\n    stability: StabilityEnum.Experimental,\n  },\n  config: {\n    defaultRetentionDays: 30,\n    defaultSamplingRate: 1,\n    providers: [\n      { type: 'posthog', config: { projectApiKey: process.env.POSTHOG_KEY } },\n    ],\n  },\n  events: [\n    {\n      name: 'sigil.telemetry.workflow_step',\n      version: '1.0.0',\n      semantics: {\n        what: 'Workflow step executed',\n        who: 'Actor executing the workflow',\n      },\n      privacy: 'internal',\n      properties: {\n        workflow: { type: 'string', required: true },\n        step: { type: 'string', required: true },\n        durationMs: { type: 'number' },\n        userId: { type: 'string', pii: true, redact: true },\n      },\n      anomalyDetection: {\n        enabled: true,\n        minimumSample: 10,\n        thresholds: [\n          { metric: 'durationMs', max: 1500 },\n        ],\n        actions: ['alert', 'trigger_regen'],\n      },\n    },\n  ],\n};\n```\n\n### Tracking events at runtime\n\n`TelemetryTracker` performs sampling, PII redaction, provider dispatch, and anomaly detection.\n\n```ts\nconst tracker = new TelemetryTracker({\n  registry: telemetryRegistry,\n  providers: [\n    {\n      id: 'posthog',\n      async send(dispatch) {\n        posthog.capture({\n          event: dispatch.name,\n          properties: dispatch.properties,\n          distinctId: dispatch.context.userId ?? dispatch.context.sessionId,\n        });\n      },\n    },\n  ],\n  anomalyMonitor: new TelemetryAnomalyMonitor({\n    onAnomaly(event) {\n      console.warn('Telemetry anomaly detected', event);\n    },\n  }),\n});\n\nawait tracker.track('sigil.telemetry.workflow_step', 1, {\n  workflow: 'onboarding',\n  step: 'verify_email',\n  durationMs: 2100,\n  userId: 'user-123',\n});\n```\n\n- Sampling obeys the event-specific rate (fallback to spec defaults)\n- Properties flagged with `pii` or `redact` are masked before dispatch\n- Anomaly monitor evaluates thresholds and triggers actions (e.g., log, alert, regeneration)\n\n### Spec integration\n\n- `ContractSpec.telemetry` allows operations to emit success/failure events automatically\n- `OperationSpecRegistry.execute()` uses the tracker when `ctx.telemetry` is provided\n- `WorkflowRunner` (Phase 4 follow-up) will emit telemetry during step transitions\n- `TelemetrySpec` events should reuse `EventSpec` names/versions to keep analytics/contract parity\n\n### CLI workflow\n\n```\ncontracts-cli create telemetry\n```\n\n- Interactive wizard prompts for meta, providers, events, properties, retention, anomaly rules\n- Output: `*.telemetry.ts` file using `TelemetrySpec`\n\n### Best practices\n\n- Prefer `internal` privacy for non-PII; mark PII properties explicitly with `pii` + `redact`\n- Keep sampling \u22650.05 except for high-volume events\n- Configure anomaly detection on key metrics (duration, error count, conversion)\n- Check telemetry into source control alongside contracts; regenerate via CLI when specs change\n\n### Next steps\n\n- Phase 5: Regenerator monitors telemetry anomalies to propose spec improvements\n- Phase 6: Studio surfaces telemetry controls per tenant via `TenantAppConfig`\n\n"
-  }
-];
-registerDocBlocks(tech_contracts_telemetry_DocBlocks);
-export {
-  tech_contracts_telemetry_DocBlocks
-};

package/dist/telemetry/index.d.ts

@@ -1,4 +0,0 @@
-export * from './spec';
-export * from './tracker';
-export * from './anomaly';
-//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}