@contractspec/lib.progressive-delivery 0.0.0-canary-20260113162409

package/README.md

@@ -0,0 +1,32 @@
+# @contractspec/lib.progressive-delivery
+
+Progressive delivery primitives for ContractSpec apps. Manage canary and blue-green deployments with guardrails, integration hooks, and automatic rollback.
+
+## Features
+
+- Declarative deployment strategies (canary, blue-green, hybrid)
+- Stage-based traffic shifting with configurable durations
+- Metric-driven guardrails (error rate, latency percentiles, throughput)
+- Automatic rollback with structured events
+- Event hooks for logging, auditing, and UI updates
+- Works with `@contractspec/lib.observability` and feature flag pipelines
+
+## Quick Start
+
+```ts
+import {
+  DeploymentCoordinator,
+  createDefaultCanaryController,
+} from '@contractspec/lib.progressive-delivery';
+
+const coordinator = new DeploymentCoordinator({
+  strategy,
+  controller: createDefaultCanaryController(strategy),
+  metricsProvider: fetchMetricsFromOtEL,
+  rollbackManager,
+});
+
+await coordinator.run();
+```
+
+See the docs in `docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.md` for full workflows.

package/dist/canary-analyzer.d.ts

@@ -0,0 +1,16 @@
+import { CanaryStage, DeploymentMetrics, DeploymentThresholds } from "./types.js";
+
+//#region src/canary-analyzer.d.ts
+interface AnalysisResult {
+  status: 'pass' | 'fail';
+  reasons: string[];
+  metrics: DeploymentMetrics;
+}
+declare class CanaryAnalyzer {
+  private readonly defaults;
+  constructor(defaults: DeploymentThresholds);
+  evaluate(stage: CanaryStage, metrics: DeploymentMetrics): AnalysisResult;
+}
+//#endregion
+export { AnalysisResult, CanaryAnalyzer };
+//# sourceMappingURL=canary-analyzer.d.ts.map

package/dist/canary-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary-analyzer.d.ts","names":[],"sources":["../src/canary-analyzer.ts"],"sourcesContent":[],"mappings":";;;UAMiB,cAAA;;EAAA,OAAA,EAAA,MAAA,EAAc;EAMlB,OAAA,EAHF,iBAGgB;;AAGT,cAHL,cAAA,CAGK;EAAsB,iBAAA,QAAA;EAAoB,WAAA,CAAA,QAAA,EAFnB,oBAEmB;EAAc,QAAA,CAAA,KAAA,EAAxD,WAAwD,EAAA,OAAA,EAAlC,iBAAkC,CAAA,EAAd,cAAc"}

package/dist/canary-analyzer.js

@@ -0,0 +1,28 @@
+//#region src/canary-analyzer.ts
+var CanaryAnalyzer = class {
+	constructor(defaults) {
+		this.defaults = defaults;
+	}
+	evaluate(stage, metrics) {
+		const thresholds = {
+			...this.defaults,
+			...stage.thresholds
+		};
+		const reasons = [];
+		if (metrics.errorRate > thresholds.errorRate) reasons.push(`errorRate ${metrics.errorRate.toFixed(4)} > ${thresholds.errorRate}`);
+		if (typeof thresholds.latencyP50 === "number" && metrics.latencyP50 > thresholds.latencyP50) reasons.push(`latencyP50 ${metrics.latencyP50}ms > ${thresholds.latencyP50}ms`);
+		if (typeof thresholds.latencyP95 === "number" && metrics.latencyP95 > thresholds.latencyP95) reasons.push(`latencyP95 ${metrics.latencyP95}ms > ${thresholds.latencyP95}ms`);
+		if (typeof thresholds.latencyP99 === "number" && metrics.latencyP99 > thresholds.latencyP99) reasons.push(`latencyP99 ${metrics.latencyP99}ms > ${thresholds.latencyP99}ms`);
+		if (typeof thresholds.throughputDrop === "number" && metrics.throughput < thresholds.throughputDrop) reasons.push(`throughput ${metrics.throughput} < ${thresholds.throughputDrop}`);
+		if (thresholds.customEvaluator && !thresholds.customEvaluator(metrics)) reasons.push("custom evaluator reported failure");
+		return {
+			status: reasons.length === 0 ? "pass" : "fail",
+			reasons,
+			metrics
+		};
+	}
+};
+
+//#endregion
+export { CanaryAnalyzer };
+//# sourceMappingURL=canary-analyzer.js.map

package/dist/canary-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary-analyzer.js","names":[],"sources":["../src/canary-analyzer.ts"],"sourcesContent":["import type {\n  CanaryStage,\n  DeploymentMetrics,\n  DeploymentThresholds,\n} from './types';\n\nexport interface AnalysisResult {\n  status: 'pass' | 'fail';\n  reasons: string[];\n  metrics: DeploymentMetrics;\n}\n\nexport class CanaryAnalyzer {\n  constructor(private readonly defaults: DeploymentThresholds) {}\n\n  evaluate(stage: CanaryStage, metrics: DeploymentMetrics): AnalysisResult {\n    const thresholds = { ...this.defaults, ...stage.thresholds };\n    const reasons: string[] = [];\n\n    if (metrics.errorRate > thresholds.errorRate) {\n      reasons.push(\n        `errorRate ${metrics.errorRate.toFixed(4)} > ${thresholds.errorRate}`\n      );\n    }\n\n    if (\n      typeof thresholds.latencyP50 === 'number' &&\n      metrics.latencyP50 > thresholds.latencyP50\n    ) {\n      reasons.push(\n        `latencyP50 ${metrics.latencyP50}ms > ${thresholds.latencyP50}ms`\n      );\n    }\n\n    if (\n      typeof thresholds.latencyP95 === 'number' &&\n      metrics.latencyP95 > thresholds.latencyP95\n    ) {\n      reasons.push(\n        `latencyP95 ${metrics.latencyP95}ms > ${thresholds.latencyP95}ms`\n      );\n    }\n\n    if (\n      typeof thresholds.latencyP99 === 'number' &&\n      metrics.latencyP99 > thresholds.latencyP99\n    ) {\n      reasons.push(\n        `latencyP99 ${metrics.latencyP99}ms > ${thresholds.latencyP99}ms`\n      );\n    }\n\n    if (\n      typeof thresholds.throughputDrop === 'number' &&\n      metrics.throughput < thresholds.throughputDrop\n    ) {\n      reasons.push(\n        `throughput ${metrics.throughput} < ${thresholds.throughputDrop}`\n      );\n    }\n\n    if (thresholds.customEvaluator && !thresholds.customEvaluator(metrics)) {\n      reasons.push('custom evaluator reported failure');\n    }\n\n    return {\n      status: reasons.length === 0 ? 'pass' : 'fail',\n      reasons,\n      metrics,\n    };\n  }\n}\n"],"mappings":";AAYA,IAAa,iBAAb,MAA4B;CAC1B,YAAY,AAAiB,UAAgC;EAAhC;;CAE7B,SAAS,OAAoB,SAA4C;EACvE,MAAM,aAAa;GAAE,GAAG,KAAK;GAAU,GAAG,MAAM;GAAY;EAC5D,MAAM,UAAoB,EAAE;AAE5B,MAAI,QAAQ,YAAY,WAAW,UACjC,SAAQ,KACN,aAAa,QAAQ,UAAU,QAAQ,EAAE,CAAC,KAAK,WAAW,YAC3D;AAGH,MACE,OAAO,WAAW,eAAe,YACjC,QAAQ,aAAa,WAAW,WAEhC,SAAQ,KACN,cAAc,QAAQ,WAAW,OAAO,WAAW,WAAW,IAC/D;AAGH,MACE,OAAO,WAAW,eAAe,YACjC,QAAQ,aAAa,WAAW,WAEhC,SAAQ,KACN,cAAc,QAAQ,WAAW,OAAO,WAAW,WAAW,IAC/D;AAGH,MACE,OAAO,WAAW,eAAe,YACjC,QAAQ,aAAa,WAAW,WAEhC,SAAQ,KACN,cAAc,QAAQ,WAAW,OAAO,WAAW,WAAW,IAC/D;AAGH,MACE,OAAO,WAAW,mBAAmB,YACrC,QAAQ,aAAa,WAAW,eAEhC,SAAQ,KACN,cAAc,QAAQ,WAAW,KAAK,WAAW,iBAClD;AAGH,MAAI,WAAW,mBAAmB,CAAC,WAAW,gBAAgB,QAAQ,CACpE,SAAQ,KAAK,oCAAoC;AAGnD,SAAO;GACL,QAAQ,QAAQ,WAAW,IAAI,SAAS;GACxC;GACA;GACD"}

package/dist/canary-controller.d.ts

@@ -0,0 +1,22 @@
+import { CanaryStage, DeploymentStrategy, MetricsProvider } from "./types.js";
+import { DeploymentEventBus } from "./events.js";
+import { AnalysisResult, CanaryAnalyzer } from "./canary-analyzer.js";
+
+//#region src/canary-controller.d.ts
+interface CanaryControllerOptions {
+  strategy: DeploymentStrategy;
+  analyzer: CanaryAnalyzer;
+  metricsProvider: MetricsProvider;
+  eventBus?: DeploymentEventBus;
+}
+declare class CanaryController {
+  private readonly options;
+  private readonly stages;
+  constructor(options: CanaryControllerOptions);
+  getStageList(): CanaryStage[];
+  runStage(stage: CanaryStage): Promise<AnalysisResult>;
+}
+declare function createDefaultCanaryController(strategy: DeploymentStrategy, metricsProvider: MetricsProvider, eventBus?: DeploymentEventBus): CanaryController;
+//#endregion
+export { CanaryController, CanaryControllerOptions, createDefaultCanaryController };
+//# sourceMappingURL=canary-controller.d.ts.map

package/dist/canary-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary-controller.d.ts","names":[],"sources":["../src/canary-controller.ts"],"sourcesContent":[],"mappings":";;;;;UAWiB,uBAAA;YACL;EADK,QAAA,EAEL,cAFK;EACL,eAAA,EAEO,eAFP;EACA,QAAA,CAAA,EAEC,kBAFD;;AAEC,cAGA,gBAAA,CAHA;EAAkB,iBAAA,OAAA;EAGlB,iBAAA,MAAgB;EAGW,WAAA,CAAA,OAAA,EAAA,uBAAA;EAO1B,YAAA,CAAA,CAAA,EAAA,WAAA,EAAA;EAIU,QAAA,CAAA,KAAA,EAAA,WAAA,CAAA,EAAc,OAAd,CAAsB,cAAtB,CAAA;;AAAc,iBAuBtB,6BAAA,CAvBsB,QAAA,EAwB1B,kBAxB0B,EAAA,eAAA,EAyBnB,eAzBmB,EAAA,QAAA,CAAA,EA0BzB,kBA1ByB,CAAA,EA0BP,gBA1BO"}

package/dist/canary-controller.js

@@ -0,0 +1,66 @@
+import { CanaryAnalyzer } from "./canary-analyzer.js";
+
+//#region src/canary-controller.ts
+const DEFAULT_STAGES = [
+	{
+		percentage: 1,
+		minDurationMs: 300 * 1e3,
+		label: "1%"
+	},
+	{
+		percentage: 10,
+		minDurationMs: 300 * 1e3,
+		label: "10%"
+	},
+	{
+		percentage: 50,
+		minDurationMs: 600 * 1e3,
+		label: "50%"
+	},
+	{
+		percentage: 100,
+		minDurationMs: 900 * 1e3,
+		label: "100%"
+	}
+];
+var CanaryController = class {
+	stages;
+	constructor(options) {
+		this.options = options;
+		this.stages = options.strategy.stages && options.strategy.stages.length > 0 ? options.strategy.stages : DEFAULT_STAGES;
+	}
+	getStageList() {
+		return [...this.stages];
+	}
+	async runStage(stage) {
+		this.options.eventBus?.emit({
+			type: "stage_started",
+			timestamp: /* @__PURE__ */ new Date(),
+			payload: { stage }
+		});
+		const metrics = await this.options.metricsProvider(stage, stage.minDurationMs);
+		const analysis = this.options.analyzer.evaluate(stage, metrics);
+		this.options.eventBus?.emit({
+			type: analysis.status === "pass" ? "stage_passed" : "stage_failed",
+			timestamp: /* @__PURE__ */ new Date(),
+			payload: {
+				stage,
+				metrics,
+				analysis
+			}
+		});
+		return analysis;
+	}
+};
+function createDefaultCanaryController(strategy, metricsProvider, eventBus) {
+	return new CanaryController({
+		strategy,
+		analyzer: new CanaryAnalyzer(strategy.thresholds),
+		metricsProvider,
+		eventBus
+	});
+}
+
+//#endregion
+export { CanaryController, createDefaultCanaryController };
+//# sourceMappingURL=canary-controller.js.map

package/dist/canary-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary-controller.js","names":[],"sources":["../src/canary-controller.ts"],"sourcesContent":["import { CanaryAnalyzer, type AnalysisResult } from './canary-analyzer';\nimport { DeploymentEventBus } from './events';\nimport type { CanaryStage, DeploymentStrategy, MetricsProvider } from './types';\n\nconst DEFAULT_STAGES: CanaryStage[] = [\n  { percentage: 1, minDurationMs: 5 * 60 * 1000, label: '1%' },\n  { percentage: 10, minDurationMs: 5 * 60 * 1000, label: '10%' },\n  { percentage: 50, minDurationMs: 10 * 60 * 1000, label: '50%' },\n  { percentage: 100, minDurationMs: 15 * 60 * 1000, label: '100%' },\n];\n\nexport interface CanaryControllerOptions {\n  strategy: DeploymentStrategy;\n  analyzer: CanaryAnalyzer;\n  metricsProvider: MetricsProvider;\n  eventBus?: DeploymentEventBus;\n}\n\nexport class CanaryController {\n  private readonly stages: CanaryStage[];\n\n  constructor(private readonly options: CanaryControllerOptions) {\n    this.stages =\n      options.strategy.stages && options.strategy.stages.length > 0\n        ? options.strategy.stages\n        : DEFAULT_STAGES;\n  }\n\n  getStageList() {\n    return [...this.stages];\n  }\n\n  async runStage(stage: CanaryStage): Promise<AnalysisResult> {\n    this.options.eventBus?.emit({\n      type: 'stage_started',\n      timestamp: new Date(),\n      payload: { stage },\n    });\n\n    const metrics = await this.options.metricsProvider(\n      stage,\n      stage.minDurationMs\n    );\n    const analysis = this.options.analyzer.evaluate(stage, metrics);\n\n    this.options.eventBus?.emit({\n      type: analysis.status === 'pass' ? 'stage_passed' : 'stage_failed',\n      timestamp: new Date(),\n      payload: { stage, metrics, analysis },\n    });\n\n    return analysis;\n  }\n}\n\nexport function createDefaultCanaryController(\n  strategy: DeploymentStrategy,\n  metricsProvider: MetricsProvider,\n  eventBus?: DeploymentEventBus\n) {\n  const analyzer = new CanaryAnalyzer(strategy.thresholds);\n  return new CanaryController({\n    strategy,\n    analyzer,\n    metricsProvider,\n    eventBus,\n  });\n}\n"],"mappings":";;;AAIA,MAAM,iBAAgC;CACpC;EAAE,YAAY;EAAG,eAAe,MAAS;EAAM,OAAO;EAAM;CAC5D;EAAE,YAAY;EAAI,eAAe,MAAS;EAAM,OAAO;EAAO;CAC9D;EAAE,YAAY;EAAI,eAAe,MAAU;EAAM,OAAO;EAAO;CAC/D;EAAE,YAAY;EAAK,eAAe,MAAU;EAAM,OAAO;EAAQ;CAClE;AASD,IAAa,mBAAb,MAA8B;CAC5B,AAAiB;CAEjB,YAAY,AAAiB,SAAkC;EAAlC;AAC3B,OAAK,SACH,QAAQ,SAAS,UAAU,QAAQ,SAAS,OAAO,SAAS,IACxD,QAAQ,SAAS,SACjB;;CAGR,eAAe;AACb,SAAO,CAAC,GAAG,KAAK,OAAO;;CAGzB,MAAM,SAAS,OAA6C;AAC1D,OAAK,QAAQ,UAAU,KAAK;GAC1B,MAAM;GACN,2BAAW,IAAI,MAAM;GACrB,SAAS,EAAE,OAAO;GACnB,CAAC;EAEF,MAAM,UAAU,MAAM,KAAK,QAAQ,gBACjC,OACA,MAAM,cACP;EACD,MAAM,WAAW,KAAK,QAAQ,SAAS,SAAS,OAAO,QAAQ;AAE/D,OAAK,QAAQ,UAAU,KAAK;GAC1B,MAAM,SAAS,WAAW,SAAS,iBAAiB;GACpD,2BAAW,IAAI,MAAM;GACrB,SAAS;IAAE;IAAO;IAAS;IAAU;GACtC,CAAC;AAEF,SAAO;;;AAIX,SAAgB,8BACd,UACA,iBACA,UACA;AAEA,QAAO,IAAI,iBAAiB;EAC1B;EACA,UAHe,IAAI,eAAe,SAAS,WAAW;EAItD;EACA;EACD,CAAC"}

package/dist/deployment-coordinator.d.ts

@@ -0,0 +1,28 @@
+import { CanaryStage, DeploymentStrategy, TrafficSplit } from "./types.js";
+import { DeploymentEventBus } from "./events.js";
+import { TrafficShifter } from "./traffic-shifter.js";
+import { CanaryController } from "./canary-controller.js";
+import { RollbackManager } from "./rollback-manager.js";
+
+//#region src/deployment-coordinator.d.ts
+interface DeploymentCoordinatorOptions {
+  strategy: DeploymentStrategy;
+  controller: CanaryController;
+  trafficShifter: TrafficShifter;
+  rollbackManager: RollbackManager;
+  applyTrafficSplit: (stage: CanaryStage, split: TrafficSplit) => void | Promise<void>;
+  eventBus?: DeploymentEventBus;
+}
+interface DeploymentRunResult {
+  status: 'completed' | 'rolled_back';
+  failedStage?: CanaryStage;
+  reasons?: string[];
+}
+declare class DeploymentCoordinator {
+  private readonly options;
+  constructor(options: DeploymentCoordinatorOptions);
+  run(): Promise<DeploymentRunResult>;
+}
+//#endregion
+export { DeploymentCoordinator, DeploymentCoordinatorOptions, DeploymentRunResult };
+//# sourceMappingURL=deployment-coordinator.d.ts.map

package/dist/deployment-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-coordinator.d.ts","names":[],"sources":["../src/deployment-coordinator.ts"],"sourcesContent":[],"mappings":";;;;;;;UAMiB,4BAAA;YACL;EADK,UAAA,EAEH,gBAFG;EACL,cAAA,EAEM,cAFN;EACE,eAAA,EAEK,eAFL;EACI,iBAAA,EAAA,CAAA,KAAA,EAGP,WAHO,EAAA,KAAA,EAIP,YAJO,EAAA,GAAA,IAAA,GAKJ,OALI,CAAA,IAAA,CAAA;EACC,QAAA,CAAA,EAKN,kBALM;;AAGR,UAKM,mBAAA,CALN;EACG,MAAA,EAAA,WAAA,GAAA,aAAA;EACD,WAAA,CAAA,EAKG,WALH;EAAkB,OAAA,CAAA,EAAA,MAAA,EAAA;AAG/B;AAMa,cAAA,qBAAA,CAAqB;EACM,iBAAA,OAAA;EAEjB,WAAA,CAAA,OAAA,EAFiB,4BAEjB;EAAR,GAAA,CAAA,CAAA,EAAA,OAAA,CAAQ,mBAAR,CAAA"}

package/dist/deployment-coordinator.js

@@ -0,0 +1,47 @@
+import "./canary-controller.js";
+
+//#region src/deployment-coordinator.ts
+var DeploymentCoordinator = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async run() {
+		const stages = this.options.controller.getStageList();
+		for (const stage of stages) {
+			const split = this.options.trafficShifter.computeSplit(stage);
+			await this.options.applyTrafficSplit(stage, split);
+			const analysis = await this.options.controller.runStage(stage);
+			if (analysis.status === "fail") {
+				const action = await this.options.rollbackManager.execute(stage, analysis.reasons.join(", "));
+				this.options.eventBus?.emit({
+					type: "rolled_back",
+					timestamp: action.triggeredAt,
+					payload: {
+						stage,
+						reasons: analysis.reasons
+					}
+				});
+				return {
+					status: "rolled_back",
+					failedStage: stage,
+					reasons: analysis.reasons
+				};
+			}
+		}
+		if (this.options.strategy.mode === "blue-green") this.options.eventBus?.emit({
+			type: "blue_green_swapped",
+			timestamp: /* @__PURE__ */ new Date(),
+			payload: { strategy: this.options.strategy }
+		});
+		this.options.eventBus?.emit({
+			type: "completed",
+			timestamp: /* @__PURE__ */ new Date(),
+			payload: { strategy: this.options.strategy }
+		});
+		return { status: "completed" };
+	}
+};
+
+//#endregion
+export { DeploymentCoordinator };
+//# sourceMappingURL=deployment-coordinator.js.map

package/dist/deployment-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-coordinator.js","names":[],"sources":["../src/deployment-coordinator.ts"],"sourcesContent":["import { CanaryController } from './canary-controller';\nimport { DeploymentEventBus } from './events';\nimport { RollbackManager } from './rollback-manager';\nimport { TrafficShifter } from './traffic-shifter';\nimport type { CanaryStage, DeploymentStrategy, TrafficSplit } from './types';\n\nexport interface DeploymentCoordinatorOptions {\n  strategy: DeploymentStrategy;\n  controller: CanaryController;\n  trafficShifter: TrafficShifter;\n  rollbackManager: RollbackManager;\n  applyTrafficSplit: (\n    stage: CanaryStage,\n    split: TrafficSplit\n  ) => void | Promise<void>;\n  eventBus?: DeploymentEventBus;\n}\n\nexport interface DeploymentRunResult {\n  status: 'completed' | 'rolled_back';\n  failedStage?: CanaryStage;\n  reasons?: string[];\n}\n\nexport class DeploymentCoordinator {\n  constructor(private readonly options: DeploymentCoordinatorOptions) {}\n\n  async run(): Promise<DeploymentRunResult> {\n    const stages = this.options.controller.getStageList();\n\n    for (const stage of stages) {\n      const split = this.options.trafficShifter.computeSplit(stage);\n      await this.options.applyTrafficSplit(stage, split);\n\n      const analysis = await this.options.controller.runStage(stage);\n      if (analysis.status === 'fail') {\n        const action = await this.options.rollbackManager.execute(\n          stage,\n          analysis.reasons.join(', ')\n        );\n\n        this.options.eventBus?.emit({\n          type: 'rolled_back',\n          timestamp: action.triggeredAt,\n          payload: { stage, reasons: analysis.reasons },\n        });\n\n        return {\n          status: 'rolled_back',\n          failedStage: stage,\n          reasons: analysis.reasons,\n        };\n      }\n    }\n\n    if (this.options.strategy.mode === 'blue-green') {\n      this.options.eventBus?.emit({\n        type: 'blue_green_swapped',\n        timestamp: new Date(),\n        payload: { strategy: this.options.strategy },\n      });\n    }\n\n    this.options.eventBus?.emit({\n      type: 'completed',\n      timestamp: new Date(),\n      payload: { strategy: this.options.strategy },\n    });\n\n    return { status: 'completed' };\n  }\n}\n"],"mappings":";;;AAwBA,IAAa,wBAAb,MAAmC;CACjC,YAAY,AAAiB,SAAuC;EAAvC;;CAE7B,MAAM,MAAoC;EACxC,MAAM,SAAS,KAAK,QAAQ,WAAW,cAAc;AAErD,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,QAAQ,KAAK,QAAQ,eAAe,aAAa,MAAM;AAC7D,SAAM,KAAK,QAAQ,kBAAkB,OAAO,MAAM;GAElD,MAAM,WAAW,MAAM,KAAK,QAAQ,WAAW,SAAS,MAAM;AAC9D,OAAI,SAAS,WAAW,QAAQ;IAC9B,MAAM,SAAS,MAAM,KAAK,QAAQ,gBAAgB,QAChD,OACA,SAAS,QAAQ,KAAK,KAAK,CAC5B;AAED,SAAK,QAAQ,UAAU,KAAK;KAC1B,MAAM;KACN,WAAW,OAAO;KAClB,SAAS;MAAE;MAAO,SAAS,SAAS;MAAS;KAC9C,CAAC;AAEF,WAAO;KACL,QAAQ;KACR,aAAa;KACb,SAAS,SAAS;KACnB;;;AAIL,MAAI,KAAK,QAAQ,SAAS,SAAS,aACjC,MAAK,QAAQ,UAAU,KAAK;GAC1B,MAAM;GACN,2BAAW,IAAI,MAAM;GACrB,SAAS,EAAE,UAAU,KAAK,QAAQ,UAAU;GAC7C,CAAC;AAGJ,OAAK,QAAQ,UAAU,KAAK;GAC1B,MAAM;GACN,2BAAW,IAAI,MAAM;GACrB,SAAS,EAAE,UAAU,KAAK,QAAQ,UAAU;GAC7C,CAAC;AAEF,SAAO,EAAE,QAAQ,aAAa"}

package/dist/events.d.ts

@@ -0,0 +1,11 @@
+import { DeploymentEvent, DeploymentEventListener } from "./types.js";
+
+//#region src/events.d.ts
+declare class DeploymentEventBus {
+  private listeners;
+  on(listener: DeploymentEventListener): () => boolean;
+  emit(event: DeploymentEvent): void;
+}
+//#endregion
+export { DeploymentEventBus };
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;cAEa,kBAAA;;EAAA,EAAA,CAAA,QAAA,EAGE,uBAAA,CAAA,EAAA,GAAA,GAAA,OAAA;cAKD"}

package/dist/events.js

@@ -0,0 +1,19 @@
+//#region src/events.ts
+var DeploymentEventBus = class {
+	listeners = /* @__PURE__ */ new Set();
+	on(listener) {
+		this.listeners.add(listener);
+		return () => this.listeners.delete(listener);
+	}
+	emit(event) {
+		for (const listener of this.listeners) try {
+			listener(event);
+		} catch (error) {
+			console.error("[progressive-delivery] listener error", error);
+		}
+	}
+};
+
+//#endregion
+export { DeploymentEventBus };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import type { DeploymentEvent, DeploymentEventListener } from './types';\n\nexport class DeploymentEventBus {\n  private listeners = new Set<DeploymentEventListener>();\n\n  on(listener: DeploymentEventListener) {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  emit(event: DeploymentEvent) {\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch (error) {\n        console.error('[progressive-delivery] listener error', error);\n      }\n    }\n  }\n}\n"],"mappings":";AAEA,IAAa,qBAAb,MAAgC;CAC9B,AAAQ,4BAAY,IAAI,KAA8B;CAEtD,GAAG,UAAmC;AACpC,OAAK,UAAU,IAAI,SAAS;AAC5B,eAAa,KAAK,UAAU,OAAO,SAAS;;CAG9C,KAAK,OAAwB;AAC3B,OAAK,MAAM,YAAY,KAAK,UAC1B,KAAI;AACF,YAAS,MAAM;WACR,OAAO;AACd,WAAQ,MAAM,yCAAyC,MAAM"}

package/dist/feature-flags.d.ts

@@ -0,0 +1,19 @@
+//#region src/feature-flags.d.ts
+declare const ContractSpecFeatureFlags: {
+  readonly LIFECYCLE_DETECTION_ALPHA: "lifecycle_detection_alpha";
+  readonly LIFECYCLE_ADVISOR_ALPHA: "lifecycle_advisor_alpha";
+  readonly LIFECYCLE_MANAGED_SERVICE: "lifecycle_managed_service";
+  readonly STUDIO_VISUAL_BUILDER: "studio_visual_builder";
+  readonly STUDIO_AUTO_EVOLUTION: "studio_auto_evolution";
+  readonly STUDIO_BYOK: "studio_byok";
+  readonly STUDIO_DEDICATED_DEPLOYMENT: "studio_dedicated_deployment";
+  readonly STUDIO_INTEGRATION_HUB: "studio_integration_hub";
+  readonly STUDIO_KNOWLEDGE_HUB: "studio_knowledge_hub";
+  readonly STUDIO_TEMPLATES: "studio_templates";
+};
+type ContractSpecFeatureFlag = keyof typeof ContractSpecFeatureFlags;
+declare const lifecycleFlags: ("lifecycle_detection_alpha" | "lifecycle_advisor_alpha" | "lifecycle_managed_service")[];
+declare const studioFlags: ("studio_visual_builder" | "studio_auto_evolution" | "studio_byok" | "studio_dedicated_deployment" | "studio_integration_hub" | "studio_knowledge_hub" | "studio_templates")[];
+//#endregion
+export { ContractSpecFeatureFlag, ContractSpecFeatureFlags, lifecycleFlags, studioFlags };
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","names":[],"sources":["../src/feature-flags.ts"],"sourcesContent":[],"mappings":";cAAa;EAAA,SAAA,yBAWH,EAAA,2BAAA;EAEE,SAAA,uBAAuB,EAAA,yBAAgB;EAEtC,SAAA,yBAIZ,EAAA,2BAAA;EAEY,SAAA,qBAQZ,EAAA,uBAAA;;;;;;;;KAhBW,uBAAA,gBAAuC;cAEtC;cAMA"}

package/dist/feature-flags.js

@@ -0,0 +1,31 @@
+//#region src/feature-flags.ts
+const ContractSpecFeatureFlags = {
+	LIFECYCLE_DETECTION_ALPHA: "lifecycle_detection_alpha",
+	LIFECYCLE_ADVISOR_ALPHA: "lifecycle_advisor_alpha",
+	LIFECYCLE_MANAGED_SERVICE: "lifecycle_managed_service",
+	STUDIO_VISUAL_BUILDER: "studio_visual_builder",
+	STUDIO_AUTO_EVOLUTION: "studio_auto_evolution",
+	STUDIO_BYOK: "studio_byok",
+	STUDIO_DEDICATED_DEPLOYMENT: "studio_dedicated_deployment",
+	STUDIO_INTEGRATION_HUB: "studio_integration_hub",
+	STUDIO_KNOWLEDGE_HUB: "studio_knowledge_hub",
+	STUDIO_TEMPLATES: "studio_templates"
+};
+const lifecycleFlags = [
+	ContractSpecFeatureFlags.LIFECYCLE_DETECTION_ALPHA,
+	ContractSpecFeatureFlags.LIFECYCLE_ADVISOR_ALPHA,
+	ContractSpecFeatureFlags.LIFECYCLE_MANAGED_SERVICE
+];
+const studioFlags = [
+	ContractSpecFeatureFlags.STUDIO_VISUAL_BUILDER,
+	ContractSpecFeatureFlags.STUDIO_AUTO_EVOLUTION,
+	ContractSpecFeatureFlags.STUDIO_BYOK,
+	ContractSpecFeatureFlags.STUDIO_DEDICATED_DEPLOYMENT,
+	ContractSpecFeatureFlags.STUDIO_INTEGRATION_HUB,
+	ContractSpecFeatureFlags.STUDIO_KNOWLEDGE_HUB,
+	ContractSpecFeatureFlags.STUDIO_TEMPLATES
+];
+
+//#endregion
+export { ContractSpecFeatureFlags, lifecycleFlags, studioFlags };
+//# sourceMappingURL=feature-flags.js.map

package/dist/feature-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.js","names":[],"sources":["../src/feature-flags.ts"],"sourcesContent":["export const ContractSpecFeatureFlags = {\n  LIFECYCLE_DETECTION_ALPHA: 'lifecycle_detection_alpha',\n  LIFECYCLE_ADVISOR_ALPHA: 'lifecycle_advisor_alpha',\n  LIFECYCLE_MANAGED_SERVICE: 'lifecycle_managed_service',\n  STUDIO_VISUAL_BUILDER: 'studio_visual_builder',\n  STUDIO_AUTO_EVOLUTION: 'studio_auto_evolution',\n  STUDIO_BYOK: 'studio_byok',\n  STUDIO_DEDICATED_DEPLOYMENT: 'studio_dedicated_deployment',\n  STUDIO_INTEGRATION_HUB: 'studio_integration_hub',\n  STUDIO_KNOWLEDGE_HUB: 'studio_knowledge_hub',\n  STUDIO_TEMPLATES: 'studio_templates',\n} as const;\n\nexport type ContractSpecFeatureFlag = keyof typeof ContractSpecFeatureFlags;\n\nexport const lifecycleFlags = [\n  ContractSpecFeatureFlags.LIFECYCLE_DETECTION_ALPHA,\n  ContractSpecFeatureFlags.LIFECYCLE_ADVISOR_ALPHA,\n  ContractSpecFeatureFlags.LIFECYCLE_MANAGED_SERVICE,\n];\n\nexport const studioFlags = [\n  ContractSpecFeatureFlags.STUDIO_VISUAL_BUILDER,\n  ContractSpecFeatureFlags.STUDIO_AUTO_EVOLUTION,\n  ContractSpecFeatureFlags.STUDIO_BYOK,\n  ContractSpecFeatureFlags.STUDIO_DEDICATED_DEPLOYMENT,\n  ContractSpecFeatureFlags.STUDIO_INTEGRATION_HUB,\n  ContractSpecFeatureFlags.STUDIO_KNOWLEDGE_HUB,\n  ContractSpecFeatureFlags.STUDIO_TEMPLATES,\n];\n"],"mappings":";AAAA,MAAa,2BAA2B;CACtC,2BAA2B;CAC3B,yBAAyB;CACzB,2BAA2B;CAC3B,uBAAuB;CACvB,uBAAuB;CACvB,aAAa;CACb,6BAA6B;CAC7B,wBAAwB;CACxB,sBAAsB;CACtB,kBAAkB;CACnB;AAID,MAAa,iBAAiB;CAC5B,yBAAyB;CACzB,yBAAyB;CACzB,yBAAyB;CAC1B;AAED,MAAa,cAAc;CACzB,yBAAyB;CACzB,yBAAyB;CACzB,yBAAyB;CACzB,yBAAyB;CACzB,yBAAyB;CACzB,yBAAyB;CACzB,yBAAyB;CAC1B"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { CanaryStage, DeploymentEvent, DeploymentEventListener, DeploymentMetrics, DeploymentMode, DeploymentStrategy, DeploymentThresholds, MetricsProvider, OperationTarget, RollbackAction, TrafficSplit } from "./types.js";
+import { DeploymentEventBus } from "./events.js";
+import { TrafficShifter } from "./traffic-shifter.js";
+import { AnalysisResult, CanaryAnalyzer } from "./canary-analyzer.js";
+import { CanaryController, CanaryControllerOptions, createDefaultCanaryController } from "./canary-controller.js";
+import { RollbackManager, RollbackManagerOptions } from "./rollback-manager.js";
+import { DeploymentCoordinator, DeploymentCoordinatorOptions, DeploymentRunResult } from "./deployment-coordinator.js";
+import { ContractSpecFeatureFlag, ContractSpecFeatureFlags, lifecycleFlags, studioFlags } from "./feature-flags.js";
+export { AnalysisResult, CanaryAnalyzer, CanaryController, CanaryControllerOptions, CanaryStage, ContractSpecFeatureFlag, ContractSpecFeatureFlags, DeploymentCoordinator, DeploymentCoordinatorOptions, DeploymentEvent, DeploymentEventBus, DeploymentEventListener, DeploymentMetrics, DeploymentMode, DeploymentRunResult, DeploymentStrategy, DeploymentThresholds, MetricsProvider, OperationTarget, RollbackAction, RollbackManager, RollbackManagerOptions, TrafficShifter, TrafficSplit, createDefaultCanaryController, lifecycleFlags, studioFlags };

package/dist/index.js

@@ -0,0 +1,9 @@
+import { DeploymentEventBus } from "./events.js";
+import { TrafficShifter } from "./traffic-shifter.js";
+import { CanaryAnalyzer } from "./canary-analyzer.js";
+import { CanaryController, createDefaultCanaryController } from "./canary-controller.js";
+import { RollbackManager } from "./rollback-manager.js";
+import { DeploymentCoordinator } from "./deployment-coordinator.js";
+import { ContractSpecFeatureFlags, lifecycleFlags, studioFlags } from "./feature-flags.js";
+
+export { CanaryAnalyzer, CanaryController, ContractSpecFeatureFlags, DeploymentCoordinator, DeploymentEventBus, RollbackManager, TrafficShifter, createDefaultCanaryController, lifecycleFlags, studioFlags };

package/dist/rollback-manager.d.ts

@@ -0,0 +1,15 @@
+import { CanaryStage, RollbackAction } from "./types.js";
+
+//#region src/rollback-manager.d.ts
+interface RollbackManagerOptions {
+  rollback(stage: CanaryStage, reason: string): Promise<void> | void;
+  onRollback?: (action: RollbackAction) => void;
+}
+declare class RollbackManager {
+  private readonly options;
+  constructor(options: RollbackManagerOptions);
+  execute(stage: CanaryStage, reason: string): Promise<RollbackAction>;
+}
+//#endregion
+export { RollbackManager, RollbackManagerOptions };
+//# sourceMappingURL=rollback-manager.d.ts.map

package/dist/rollback-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-manager.d.ts","names":[],"sources":["../src/rollback-manager.ts"],"sourcesContent":[],"mappings":";;;UAEiB,sBAAA;kBACC,8BAA8B;EAD/B,UAAA,CAAA,EAAA,CAAA,MAAA,EAEO,cAFe,EAAA,GAAA,IAAA;;AACS,cAInC,eAAA,CAJmC;EACxB,iBAAA,OAAA;EAAc,WAAA,CAAA,OAAA,EAIE,sBAJF;EAGzB,OAAA,CAAA,KAAA,EAGU,WAHK,EAAA,MAAA,EAAA,MAAA,CAAA,EAGsB,OAHtB,CAGsB,cAHtB,CAAA"}

package/dist/rollback-manager.js

@@ -0,0 +1,20 @@
+//#region src/rollback-manager.ts
+var RollbackManager = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async execute(stage, reason) {
+		await this.options.rollback(stage, reason);
+		const action = {
+			reason,
+			stage,
+			triggeredAt: /* @__PURE__ */ new Date()
+		};
+		this.options.onRollback?.(action);
+		return action;
+	}
+};
+
+//#endregion
+export { RollbackManager };
+//# sourceMappingURL=rollback-manager.js.map

package/dist/rollback-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-manager.js","names":[],"sources":["../src/rollback-manager.ts"],"sourcesContent":["import type { CanaryStage, RollbackAction } from './types';\n\nexport interface RollbackManagerOptions {\n  rollback(stage: CanaryStage, reason: string): Promise<void> | void;\n  onRollback?: (action: RollbackAction) => void;\n}\n\nexport class RollbackManager {\n  constructor(private readonly options: RollbackManagerOptions) {}\n\n  async execute(stage: CanaryStage, reason: string) {\n    await this.options.rollback(stage, reason);\n    const action: RollbackAction = {\n      reason,\n      stage,\n      triggeredAt: new Date(),\n    };\n    this.options.onRollback?.(action);\n    return action;\n  }\n}\n"],"mappings":";AAOA,IAAa,kBAAb,MAA6B;CAC3B,YAAY,AAAiB,SAAiC;EAAjC;;CAE7B,MAAM,QAAQ,OAAoB,QAAgB;AAChD,QAAM,KAAK,QAAQ,SAAS,OAAO,OAAO;EAC1C,MAAM,SAAyB;GAC7B;GACA;GACA,6BAAa,IAAI,MAAM;GACxB;AACD,OAAK,QAAQ,aAAa,OAAO;AACjC,SAAO"}

package/dist/traffic-shifter.d.ts

@@ -0,0 +1,11 @@
+import { CanaryStage, DeploymentMode, TrafficSplit } from "./types.js";
+
+//#region src/traffic-shifter.d.ts
+declare class TrafficShifter {
+  private readonly mode;
+  constructor(mode: DeploymentMode);
+  computeSplit(stage: CanaryStage): TrafficSplit;
+}
+//#endregion
+export { TrafficShifter };
+//# sourceMappingURL=traffic-shifter.d.ts.map

package/dist/traffic-shifter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic-shifter.d.ts","names":[],"sources":["../src/traffic-shifter.ts"],"sourcesContent":[],"mappings":";;;cAEa,cAAA;;EAAA,WAAA,CAAA,IAAA,EACwB,cADV;EACU,YAAA,CAAA,KAAA,EAEf,WAFe,CAAA,EAED,YAFC"}

package/dist/traffic-shifter.js

@@ -0,0 +1,24 @@
+//#region src/traffic-shifter.ts
+var TrafficShifter = class {
+	constructor(mode) {
+		this.mode = mode;
+	}
+	computeSplit(stage) {
+		if (this.mode === "blue-green") return stage.percentage >= 100 ? {
+			stable: 0,
+			candidate: 1
+		} : {
+			stable: 1,
+			candidate: 0
+		};
+		const candidate = Math.min(Math.max(stage.percentage / 100, 0), 1);
+		return {
+			candidate,
+			stable: 1 - candidate
+		};
+	}
+};
+
+//#endregion
+export { TrafficShifter };
+//# sourceMappingURL=traffic-shifter.js.map

package/dist/traffic-shifter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic-shifter.js","names":[],"sources":["../src/traffic-shifter.ts"],"sourcesContent":["import type { CanaryStage, DeploymentMode, TrafficSplit } from './types';\n\nexport class TrafficShifter {\n  constructor(private readonly mode: DeploymentMode) {}\n\n  computeSplit(stage: CanaryStage): TrafficSplit {\n    if (this.mode === 'blue-green') {\n      return stage.percentage >= 100\n        ? { stable: 0, candidate: 1 }\n        : { stable: 1, candidate: 0 };\n    }\n\n    const candidate = Math.min(Math.max(stage.percentage / 100, 0), 1);\n    return {\n      candidate,\n      stable: 1 - candidate,\n    };\n  }\n}\n"],"mappings":";AAEA,IAAa,iBAAb,MAA4B;CAC1B,YAAY,AAAiB,MAAsB;EAAtB;;CAE7B,aAAa,OAAkC;AAC7C,MAAI,KAAK,SAAS,aAChB,QAAO,MAAM,cAAc,MACvB;GAAE,QAAQ;GAAG,WAAW;GAAG,GAC3B;GAAE,QAAQ;GAAG,WAAW;GAAG;EAGjC,MAAM,YAAY,KAAK,IAAI,KAAK,IAAI,MAAM,aAAa,KAAK,EAAE,EAAE,EAAE;AAClE,SAAO;GACL;GACA,QAAQ,IAAI;GACb"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+//#region src/types.d.ts
+type DeploymentMode = 'canary' | 'blue-green';
+interface OperationTarget {
+  name: string;
+  version: number;
+  namespace?: string;
+  description?: string;
+}
+interface DeploymentThresholds {
+  /** e.g. 0.01 = 1% */
+  errorRate: number;
+  latencyP50?: number;
+  latencyP95?: number;
+  latencyP99?: number;
+  throughputDrop?: number;
+  customEvaluator?: (metrics: DeploymentMetrics) => boolean;
+}
+interface CanaryStage {
+  percentage: number;
+  minDurationMs: number;
+  holdAfterMs?: number;
+  /** optional override thresholds */
+  thresholds?: Partial<DeploymentThresholds>;
+  label?: string;
+}
+interface DeploymentStrategy {
+  target: OperationTarget;
+  mode: DeploymentMode;
+  stages?: CanaryStage[];
+  thresholds: DeploymentThresholds;
+  metadata?: Record<string, unknown>;
+}
+interface DeploymentMetrics {
+  errorRate: number;
+  latencyP50: number;
+  latencyP95: number;
+  latencyP99: number;
+  throughput: number;
+  sampleSize?: number;
+  timestamp?: Date;
+}
+type MetricsProvider = (stage: CanaryStage, windowMs: number) => Promise<DeploymentMetrics>;
+interface TrafficSplit {
+  stable: number;
+  candidate: number;
+}
+interface RollbackAction {
+  reason: string;
+  stage: CanaryStage;
+  triggeredAt: Date;
+}
+interface DeploymentEvent<TPayload = Record<string, unknown>> {
+  type: 'stage_started' | 'stage_passed' | 'stage_failed' | 'rolled_back' | 'completed' | 'blue_green_swapped';
+  payload?: TPayload;
+  timestamp: Date;
+}
+type DeploymentEventListener = (event: DeploymentEvent) => void;
+//#endregion
+export { CanaryStage, DeploymentEvent, DeploymentEventListener, DeploymentMetrics, DeploymentMode, DeploymentStrategy, DeploymentThresholds, MetricsProvider, OperationTarget, RollbackAction, TrafficSplit };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,cAAA;AAAA,UAEK,eAAA,CAFS;EAET,IAAA,EAAA,MAAA;EAOA,OAAA,EAAA,MAAA;EAUA,SAAA,CAAA,EAAA,MAAW;EASX,WAAA,CAAA,EAAA,MAAA;;AAET,UArBS,oBAAA,CAqBT;EACG;EACG,SAAA,EAAA,MAAA;EACD,UAAA,CAAA,EAAA,MAAA;EAAM,UAAA,CAAA,EAAA,MAAA;EAGF,UAAA,CAAA,EAAA,MAAA;EAUL,cAAA,CAAA,EAAA,MAAe;EAClB,eAAA,CAAA,EAAA,CAAA,OAAA,EA/BqB,iBA+BrB,EAAA,GAAA,OAAA;;AAEJ,UA9BY,WAAA,CA8BZ;EAAO,UAAA,EAAA,MAAA;EAEK,aAAA,EAAY,MAAA;EAKZ,WAAA,CAAA,EAAA,MAAc;EAMd;EAA2B,UAAA,CAAA,EAtC7B,OAsC6B,CAtCrB,oBAsCqB,CAAA;EAQhC,KAAA,CAAA,EAAA,MAAA;;AACK,UA3CA,kBAAA,CA2CA;EAGL,MAAA,EA7CF,eA6CE;QA5CJ;WACG;cACG;aACD;;UAGI,iBAAA;;;;;;;cAOH;;KAGF,eAAA,WACH,kCAEJ,QAAQ;UAEI,YAAA;;;;UAKA,cAAA;;SAER;eACM;;UAGE,2BAA2B;;YAQhC;aACC;;KAGD,uBAAA,WAAkC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@contractspec/lib.progressive-delivery",
+  "version": "0.0.0-canary-20260113162409",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src"
+  },
+  "peerDependencies": {
+    "@contractspec/lib.observability": "0.0.0-canary-20260113162409"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    }
+  }
+}