@crewhaus/canary-controller 0.1.8 → 0.2.0

package/dist/index.d.ts

@@ -20,8 +20,30 @@ export type RegressionGate = (input: {
     readonly verdict: "pass" | "fail";
     readonly reason?: string;
 }>;
-/** Stub gate that always passes. Replaced by §29 regression-runner integration. */
+/**
+ * EXPLICIT always-pass stub. NOT the wired production default anymore
+ * (item 29): the CLI builds a real gate via {@link makeRegressionGate} that
+ * evals both versions and runs `regression-runner`'s `gate()`. Kept only for
+ * tests, `--dry-run`, and manual promotions that deliberately skip the eval
+ * gate.
+ */
 export declare const PASSING_GATE: RegressionGate;
+/**
+ * Build a real {@link RegressionGate} from a caller-supplied per-step
+ * evaluator. The evaluator is the seam that keeps canary-controller
+ * dependency-inverted: it evals BOTH versions and returns the comparison
+ * verdict (in the CLI it runs two `eval-runner` passes and feeds the two
+ * `EvalRunSummary` results into `regression-runner.gate()`). Any throw from
+ * the evaluator is surfaced as a `fail` verdict so a broken eval never
+ * silently promotes a candidate — the controller then auto-rolls-back.
+ */
+export declare function makeRegressionGate(evaluate: (input: {
+    readonly fromVersion: string;
+    readonly toVersion: string;
+}) => Promise<{
+    readonly verdict: "pass" | "fail";
+    readonly reason?: string;
+}>): RegressionGate;
 export type CanaryConfig = {
     readonly name: string;
     /** Currently-pinned version (control). */

package/dist/index.js

@@ -6,8 +6,15 @@
  *
  * After `evalIntervalMs` elapses, runs an eval-spec against both versions
  * in parallel and gates promotion on `regression-runner` (Section 29 —
- * but ships pre-§29 with a stub gate that returns "pass" until the real
- * regression-runner lands).
+ * `gate(baseline, candidate)` over two `EvalRunSummary` results).
+ *
+ * The real gate is wired by the caller (item 29 — `crewhaus deploy canary`):
+ * canary-controller stays dependency-inverted (it does NOT import
+ * `regression-runner`/`eval-runner`, keeping this a leaf package). Callers
+ * build a `RegressionGate` with {@link makeRegressionGate}, injecting the
+ * per-step "eval both versions, then compare" closure. {@link PASSING_GATE}
+ * is retained ONLY as an explicit always-pass stub for tests and manual
+ * dry-runs — it is no longer the wired production default.
  *
  * Without an eval gate (manual mode), the controller waits for an
  * explicit `crewhaus deploy promote` call.
@@ -20,8 +27,34 @@ export class CanaryError extends CrewhausError {
         super("config", message, cause);
     }
 }
-/** Stub gate that always passes. Replaced by §29 regression-runner integration. */
+/**
+ * EXPLICIT always-pass stub. NOT the wired production default anymore
+ * (item 29): the CLI builds a real gate via {@link makeRegressionGate} that
+ * evals both versions and runs `regression-runner`'s `gate()`. Kept only for
+ * tests, `--dry-run`, and manual promotions that deliberately skip the eval
+ * gate.
+ */
 export const PASSING_GATE = async () => ({ verdict: "pass" });
+/**
+ * Build a real {@link RegressionGate} from a caller-supplied per-step
+ * evaluator. The evaluator is the seam that keeps canary-controller
+ * dependency-inverted: it evals BOTH versions and returns the comparison
+ * verdict (in the CLI it runs two `eval-runner` passes and feeds the two
+ * `EvalRunSummary` results into `regression-runner.gate()`). Any throw from
+ * the evaluator is surfaced as a `fail` verdict so a broken eval never
+ * silently promotes a candidate — the controller then auto-rolls-back.
+ */
+export function makeRegressionGate(evaluate) {
+    return async (input) => {
+        try {
+            return await evaluate(input);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { verdict: "fail", reason: `eval gate errored: ${message}` };
+        }
+    };
+}
 export function createCanaryController(opts) {
     return {
         route(config, requestId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/canary-controller",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "type": "module",
   "description": "Percent-of-traffic rollout with eval-gated promotion. Hash-routes requests across two pinned versions and auto-rolls-back on regression.",
   "main": "dist/index.js",
@@ -15,10 +15,10 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/audit-log": "0.1.8",
-    "@crewhaus/deployment-controller": "0.1.8",
-    "@crewhaus/errors": "0.1.8",
-    "@crewhaus/spec-registry": "0.1.8"
+    "@crewhaus/audit-log": "0.2.0",
+    "@crewhaus/deployment-controller": "0.2.0",
+    "@crewhaus/errors": "0.2.0",
+    "@crewhaus/spec-registry": "0.2.0"
   },
   "license": "Apache-2.0",
   "author": {