@contractspec/lib.progressive-delivery 34.0.5 → 34.0.7

package/README.md

@@ -1,32 +1,61 @@
 # @contractspec/lib.progressive-delivery
 
-Progressive delivery primitives for ContractSpec apps. Manage canary and blue-green deployments with guardrails, integration hooks, and automatic rollback.
+**Progressive delivery and canary release primitives. Provides strategy definitions and rollout logic for safe, incremental deployments.**
 
-## Features
+## What It Provides
 
-- 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
+- **Layer**: lib.
+- **Consumers**: bundles.
+- Related ContractSpec packages include `@contractspec/lib.observability`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/lib.observability`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
-## Quick Start
+## Installation
 
-```ts
-import {
-  DeploymentCoordinator,
-  createDefaultCanaryController,
-} from '@contractspec/lib.progressive-delivery';
+`npm install @contractspec/lib.progressive-delivery`
 
-const coordinator = new DeploymentCoordinator({
-  strategy,
-  controller: createDefaultCanaryController(strategy),
-  metricsProvider: fetchMetricsFromOtEL,
-  rollbackManager,
-});
+or
 
-await coordinator.run();
-```
+`bun add @contractspec/lib.progressive-delivery`
 
-See the docs in `docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.md` for full workflows.
+## Usage
+
+Import the root entrypoint from `@contractspec/lib.progressive-delivery`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/canary-analyzer.ts` is part of the package's public or composition surface.
+- `src/canary-controller.ts` is part of the package's public or composition surface.
+- `src/deployment-coordinator.ts` is part of the package's public or composition surface.
+- `src/events.ts` is package-level event definitions.
+- `src/feature-flags.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/rollback-manager.ts` is part of the package's public or composition surface.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+
+## Notes
+
+- Delivery strategies must be deterministic — same input must produce same rollout decision.
+- Peer dependency on observability; ensure OTel integration stays aligned.
+- Strategy interface changes affect all deployment pipelines consuming this lib.

package/dist/browser/index.js

@@ -1,37 +1,3 @@
-// src/events.ts
-class DeploymentEventBus {
-  listeners = 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);
-      }
-    }
-  }
-}
-// src/traffic-shifter.ts
-class TrafficShifter {
-  mode;
-  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
-    };
-  }
-}
 // src/canary-analyzer.ts
 class CanaryAnalyzer {
   defaults;
@@ -109,23 +75,6 @@ function createDefaultCanaryController(strategy, metricsProvider, eventBus) {
     eventBus
   });
 }
-// src/rollback-manager.ts
-class RollbackManager {
-  options;
-  constructor(options) {
-    this.options = options;
-  }
-  async execute(stage, reason) {
-    await this.options.rollback(stage, reason);
-    const action = {
-      reason,
-      stage,
-      triggeredAt: new Date
-    };
-    this.options.onRollback?.(action);
-    return action;
-  }
-}
 // src/deployment-coordinator.ts
 class DeploymentCoordinator {
   options;
@@ -167,6 +116,23 @@ class DeploymentCoordinator {
     return { status: "completed" };
   }
 }
+// src/events.ts
+class DeploymentEventBus {
+  listeners = 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);
+      }
+    }
+  }
+}
 // src/feature-flags.ts
 var ContractSpecFeatureFlags = {
   LIFECYCLE_DETECTION_ALPHA: "lifecycle_detection_alpha",
@@ -194,6 +160,40 @@ var studioFlags = [
   ContractSpecFeatureFlags.STUDIO_KNOWLEDGE_HUB,
   ContractSpecFeatureFlags.STUDIO_TEMPLATES
 ];
+// src/rollback-manager.ts
+class RollbackManager {
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  async execute(stage, reason) {
+    await this.options.rollback(stage, reason);
+    const action = {
+      reason,
+      stage,
+      triggeredAt: new Date
+    };
+    this.options.onRollback?.(action);
+    return action;
+  }
+}
+// src/traffic-shifter.ts
+class TrafficShifter {
+  mode;
+  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
+    };
+  }
+}
 export {
   studioFlags,
   lifecycleFlags,

package/dist/canary-controller.d.ts

@@ -1,4 +1,4 @@
-import { CanaryAnalyzer, type AnalysisResult } from './canary-analyzer';
+import { type AnalysisResult, CanaryAnalyzer } from './canary-analyzer';
 import { DeploymentEventBus } from './events';
 import type { CanaryStage, DeploymentStrategy, MetricsProvider } from './types';
 export interface CanaryControllerOptions {

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export * from './types';
-export * from './events';
-export * from './traffic-shifter';
 export * from './canary-analyzer';
 export * from './canary-controller';
-export * from './rollback-manager';
 export * from './deployment-coordinator';
+export * from './events';
 export * from './feature-flags';
+export * from './rollback-manager';
+export * from './traffic-shifter';
+export * from './types';

package/dist/index.js

@@ -1,38 +1,4 @@
 // @bun
-// src/events.ts
-class DeploymentEventBus {
-  listeners = 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);
-      }
-    }
-  }
-}
-// src/traffic-shifter.ts
-class TrafficShifter {
-  mode;
-  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
-    };
-  }
-}
 // src/canary-analyzer.ts
 class CanaryAnalyzer {
   defaults;
@@ -110,23 +76,6 @@ function createDefaultCanaryController(strategy, metricsProvider, eventBus) {
     eventBus
   });
 }
-// src/rollback-manager.ts
-class RollbackManager {
-  options;
-  constructor(options) {
-    this.options = options;
-  }
-  async execute(stage, reason) {
-    await this.options.rollback(stage, reason);
-    const action = {
-      reason,
-      stage,
-      triggeredAt: new Date
-    };
-    this.options.onRollback?.(action);
-    return action;
-  }
-}
 // src/deployment-coordinator.ts
 class DeploymentCoordinator {
   options;
@@ -168,6 +117,23 @@ class DeploymentCoordinator {
     return { status: "completed" };
   }
 }
+// src/events.ts
+class DeploymentEventBus {
+  listeners = 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);
+      }
+    }
+  }
+}
 // src/feature-flags.ts
 var ContractSpecFeatureFlags = {
   LIFECYCLE_DETECTION_ALPHA: "lifecycle_detection_alpha",
@@ -195,6 +161,40 @@ var studioFlags = [
   ContractSpecFeatureFlags.STUDIO_KNOWLEDGE_HUB,
   ContractSpecFeatureFlags.STUDIO_TEMPLATES
 ];
+// src/rollback-manager.ts
+class RollbackManager {
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  async execute(stage, reason) {
+    await this.options.rollback(stage, reason);
+    const action = {
+      reason,
+      stage,
+      triggeredAt: new Date
+    };
+    this.options.onRollback?.(action);
+    return action;
+  }
+}
+// src/traffic-shifter.ts
+class TrafficShifter {
+  mode;
+  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
+    };
+  }
+}
 export {
   studioFlags,
   lifecycleFlags,

package/dist/node/index.js

@@ -1,37 +1,3 @@
-// src/events.ts
-class DeploymentEventBus {
-  listeners = 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);
-      }
-    }
-  }
-}
-// src/traffic-shifter.ts
-class TrafficShifter {
-  mode;
-  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
-    };
-  }
-}
 // src/canary-analyzer.ts
 class CanaryAnalyzer {
   defaults;
@@ -109,23 +75,6 @@ function createDefaultCanaryController(strategy, metricsProvider, eventBus) {
     eventBus
   });
 }
-// src/rollback-manager.ts
-class RollbackManager {
-  options;
-  constructor(options) {
-    this.options = options;
-  }
-  async execute(stage, reason) {
-    await this.options.rollback(stage, reason);
-    const action = {
-      reason,
-      stage,
-      triggeredAt: new Date
-    };
-    this.options.onRollback?.(action);
-    return action;
-  }
-}
 // src/deployment-coordinator.ts
 class DeploymentCoordinator {
   options;
@@ -167,6 +116,23 @@ class DeploymentCoordinator {
     return { status: "completed" };
   }
 }
+// src/events.ts
+class DeploymentEventBus {
+  listeners = 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);
+      }
+    }
+  }
+}
 // src/feature-flags.ts
 var ContractSpecFeatureFlags = {
   LIFECYCLE_DETECTION_ALPHA: "lifecycle_detection_alpha",
@@ -194,6 +160,40 @@ var studioFlags = [
   ContractSpecFeatureFlags.STUDIO_KNOWLEDGE_HUB,
   ContractSpecFeatureFlags.STUDIO_TEMPLATES
 ];
+// src/rollback-manager.ts
+class RollbackManager {
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  async execute(stage, reason) {
+    await this.options.rollback(stage, reason);
+    const action = {
+      reason,
+      stage,
+      triggeredAt: new Date
+    };
+    this.options.onRollback?.(action);
+    return action;
+  }
+}
+// src/traffic-shifter.ts
+class TrafficShifter {
+  mode;
+  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
+    };
+  }
+}
 export {
   studioFlags,
   lifecycleFlags,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.progressive-delivery",
-  "version": "34.0.5",
+  "version": "34.0.7",
   "type": "module",
   "types": "./dist/index.d.ts",
   "files": [
@@ -16,8 +16,8 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
@@ -27,12 +27,12 @@
     "directory": "packages/libs/progressive-delivery"
   },
   "peerDependencies": {
-    "@contractspec/lib.observability": "3.7.5"
+    "@contractspec/lib.observability": "3.7.7"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "exports": {
     ".": {