@cat-factory/gates 0.5.57 → 0.6.0

package/dist/index.d.ts

@@ -1,10 +1,22 @@
+import { type GateRegistry } from '@cat-factory/kernel';
 export { CI_STATUS_PROVIDER, MERGEABILITY_PROVIDER, RELEASE_HEALTH_PROVIDER, INCIDENT_ENRICHMENT_PROVIDER, PULL_REQUEST_REVIEW_PROVIDER, DOC_QUALITY_PROVIDER, wireCiStatusProvider, wireMergeabilityProvider, wireReleaseHealthProvider, wireIncidentEnrichment, wirePullRequestReviewProvider, wireDocQualityProvider, clearGateProviders, applyGateProviders, warnUnwiredGates, type GateProviderOverrides, type GateWiringLogger, } from './providers.js';
 export { ciGate, conflictsGate, postReleaseHealthGate, humanReviewGate, docQualityGate, } from './gates.js';
 export { classifyHumanReview, isApproved, outstandingThreads, outstandingComments, renderReviewFeedbackForFixer, requiredApprovals, type HumanReviewVerdict, } from './review.logic.js';
 /**
- * Register the built-in gate suite. Idempotent (the registry replaces by kind), so importing
- * the package and calling this explicitly are safe to combine. Called automatically as an
- * import side effect below.
+ * Install the built-in gate suite into an app-owned {@link GateRegistry}. The composition
+ * root calls this once with the instance it threads through `CoreDependencies.gateRegistry`.
+ * Idempotent (the registry replaces by kind), so a deployment can call it then override a
+ * built-in by re-registering the same kind.
  */
-export declare function registerBuiltinGates(): void;
+export declare function registerBuiltinGates(registry: GateRegistry): void;
+/**
+ * A fresh app-owned {@link GateRegistry} pre-loaded with the built-in gate suite — the single
+ * named factory a composition root reaches for when it is NOT handed an injected registry.
+ * Prefer this over the `defaultGateRegistry()` + `registerBuiltinGates()` two-step at every
+ * construction site: kernel's `defaultGateRegistry()` is empty by design (it cannot depend on
+ * this package), so a site that forgets the second step silently drops the platform's own
+ * CI / conflicts / merge gates. Collapsing the pair into one call makes that hazard
+ * unrepresentable — the obvious "I need the built-in gates" helper installs them.
+ */
+export declare function gateRegistryWithBuiltins(): GateRegistry;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAIlB,MAAM,qBAAqB,CAAA;AAiC5B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAE1B;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAMjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,CAIvD"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { CI_AGENT_KIND, CONFLICTS_AGENT_KIND, DOC_QUALITY_AGENT_KIND, HUMAN_REVIEW_AGENT_KIND, POST_RELEASE_HEALTH_AGENT_KIND, registerGate, } from '@cat-factory/kernel';
+import { CI_AGENT_KIND, CONFLICTS_AGENT_KIND, DOC_QUALITY_AGENT_KIND, HUMAN_REVIEW_AGENT_KIND, POST_RELEASE_HEALTH_AGENT_KIND, defaultGateRegistry, } from '@cat-factory/kernel';
 import { ciGate, conflictsGate, docQualityGate, humanReviewGate, postReleaseHealthGate, } from './gates.js';
 // ---------------------------------------------------------------------------
 // The built-in polling-gate suite, authored ENTIRELY through the public gate-registry
@@ -8,32 +8,49 @@ import { ciGate, conflictsGate, docQualityGate, humanReviewGate, postReleaseHeal
 // deployment's. The engine no longer hard-codes them; it merges whatever gates are
 // registered when its ExecutionService first builds its gate registry.
 //
-// A deployment opts in by importing this package once for its side effect, then wiring each
-// gate's provider at startup:
+// A deployment opts in by installing the built-in gates into its app-owned gate registry,
+// then wiring each gate's provider at startup:
 //
-//   import '@cat-factory/gates'
+//   const gates = defaultGateRegistry()
+//   registerBuiltinGates(gates)                  // installs ci / conflicts / … into the instance
 //   wireCiStatusProvider(new GitHubCiStatusProvider(...))
 //   wireMergeabilityProvider(new GitHubMergeabilityProvider(...))
 //   wireReleaseHealthProvider(new RegistryReleaseHealthProvider(...))
 //   wireIncidentEnrichment(new CompositeIncidentEnrichmentProvider(...))
+//   // …then thread `gates` through `CoreDependencies.gateRegistry`.
 //
-// Until a gate's provider is wired it is a harmless pass-through, so a bare import is safe.
+// Until a gate's provider is wired it is a harmless pass-through. The registry is an
+// app-owned INSTANCE (`GateRegistry`), not a module global — so registering the built-ins is
+// an explicit call the composition root makes, not an import side effect.
 // ---------------------------------------------------------------------------
 export { CI_STATUS_PROVIDER, MERGEABILITY_PROVIDER, RELEASE_HEALTH_PROVIDER, INCIDENT_ENRICHMENT_PROVIDER, PULL_REQUEST_REVIEW_PROVIDER, DOC_QUALITY_PROVIDER, wireCiStatusProvider, wireMergeabilityProvider, wireReleaseHealthProvider, wireIncidentEnrichment, wirePullRequestReviewProvider, wireDocQualityProvider, clearGateProviders, applyGateProviders, warnUnwiredGates, } from './providers.js';
 export { ciGate, conflictsGate, postReleaseHealthGate, humanReviewGate, docQualityGate, } from './gates.js';
 export { classifyHumanReview, isApproved, outstandingThreads, outstandingComments, renderReviewFeedbackForFixer, requiredApprovals, } from './review.logic.js';
 /**
- * Register the built-in gate suite. Idempotent (the registry replaces by kind), so importing
- * the package and calling this explicitly are safe to combine. Called automatically as an
- * import side effect below.
+ * Install the built-in gate suite into an app-owned {@link GateRegistry}. The composition
+ * root calls this once with the instance it threads through `CoreDependencies.gateRegistry`.
+ * Idempotent (the registry replaces by kind), so a deployment can call it then override a
+ * built-in by re-registering the same kind.
  */
-export function registerBuiltinGates() {
-    registerGate(CI_AGENT_KIND, ciGate);
-    registerGate(CONFLICTS_AGENT_KIND, conflictsGate);
-    registerGate(POST_RELEASE_HEALTH_AGENT_KIND, postReleaseHealthGate);
-    registerGate(HUMAN_REVIEW_AGENT_KIND, humanReviewGate);
-    registerGate(DOC_QUALITY_AGENT_KIND, docQualityGate);
+export function registerBuiltinGates(registry) {
+    registry.register(CI_AGENT_KIND, ciGate);
+    registry.register(CONFLICTS_AGENT_KIND, conflictsGate);
+    registry.register(POST_RELEASE_HEALTH_AGENT_KIND, postReleaseHealthGate);
+    registry.register(HUMAN_REVIEW_AGENT_KIND, humanReviewGate);
+    registry.register(DOC_QUALITY_AGENT_KIND, docQualityGate);
+}
+/**
+ * A fresh app-owned {@link GateRegistry} pre-loaded with the built-in gate suite — the single
+ * named factory a composition root reaches for when it is NOT handed an injected registry.
+ * Prefer this over the `defaultGateRegistry()` + `registerBuiltinGates()` two-step at every
+ * construction site: kernel's `defaultGateRegistry()` is empty by design (it cannot depend on
+ * this package), so a site that forgets the second step silently drops the platform's own
+ * CI / conflicts / merge gates. Collapsing the pair into one call makes that hazard
+ * unrepresentable — the obvious "I need the built-in gates" helper installs them.
+ */
+export function gateRegistryWithBuiltins() {
+    const registry = defaultGateRegistry();
+    registerBuiltinGates(registry);
+    return registry;
 }
-// Side-effect registration: `import '@cat-factory/gates'` is enough.
-registerBuiltinGates();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,8BAA8B,EAC9B,YAAY,GACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,MAAM,EACN,aAAa,EACb,cAAc,EACd,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAEnB,8EAA8E;AAC9E,sFAAsF;AACtF,0FAA0F;AAC1F,kFAAkF;AAClF,gFAAgF;AAChF,mFAAmF;AACnF,uEAAuE;AACvE,EAAE;AACF,4FAA4F;AAC5F,8BAA8B;AAC9B,EAAE;AACF,gCAAgC;AAChC,0DAA0D;AAC1D,kEAAkE;AAClE,sEAAsE;AACtE,yEAAyE;AACzE,EAAE;AACF,4FAA4F;AAC5F,8EAA8E;AAE9E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,GAElB,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IACnC,YAAY,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAA;IACjD,YAAY,CAAC,8BAA8B,EAAE,qBAAqB,CAAC,CAAA;IACnE,YAAY,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAA;IACtD,YAAY,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAA;AACtD,CAAC;AAED,qEAAqE;AACrE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EAEtB,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,MAAM,EACN,aAAa,EACb,cAAc,EACd,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAEnB,8EAA8E;AAC9E,sFAAsF;AACtF,0FAA0F;AAC1F,kFAAkF;AAClF,gFAAgF;AAChF,mFAAmF;AACnF,uEAAuE;AACvE,EAAE;AACF,0FAA0F;AAC1F,+CAA+C;AAC/C,EAAE;AACF,wCAAwC;AACxC,kGAAkG;AAClG,0DAA0D;AAC1D,kEAAkE;AAClE,sEAAsE;AACtE,yEAAyE;AACzE,qEAAqE;AACrE,EAAE;AACF,qFAAqF;AACrF,6FAA6F;AAC7F,0EAA0E;AAC1E,8EAA8E;AAE9E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,GAElB,MAAM,mBAAmB,CAAA;AAE1B;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAA;IACtD,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,EAAE,qBAAqB,CAAC,CAAA;IACxE,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAA;IAC3D,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAA;IACtC,oBAAoB,CAAC,QAAQ,CAAC,CAAA;IAC9B,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/gates",
-  "version": "0.5.57",
+  "version": "0.6.0",
   "description": "The built-in polling-gate suite (CI, merge-conflicts, post-release health + the on-call escalation) for the Agent Architecture Board, authored entirely through the public gate-registry seam — depends only on @cat-factory/kernel + @cat-factory/contracts, never the engine. A deployment imports it for side effect and wires each gate's provider via the exported wireX handles.",
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@cat-factory/contracts": "0.148.1",
-    "@cat-factory/kernel": "0.140.0"
+    "@cat-factory/kernel": "0.141.0"
   },
   "devDependencies": {
     "typescript": "7.0.2",