@cat-factory/kernel 0.272.0 → 0.274.0

package/dist/domain/binary-store-registry.d.ts

@@ -0,0 +1,98 @@
+import type { BinaryBlobBackend } from '../ports/binary-artifacts.js';
+import type { Logger } from '../ports/logging.js';
+/** What the resolver tells a store about the account it is being built for. */
+export interface BinaryStoreContext {
+    /**
+     * The account whose artifacts this store will hold, or null for a legacy unscoped board.
+     *
+     * Supplied so a multi-tenant deployment can shard by account (a bucket or key prefix per
+     * account) without a per-account settings surface. A store that ignores it holds every
+     * account's bytes together, which is the right shape for a single-tenant deployment and is why
+     * this is context rather than a required parameter.
+     */
+    accountId: string | null;
+    /** The composition root's logger, for a store that wants to report its own diagnostics. */
+    logger?: Logger;
+}
+/**
+ * A binary artifact store a DEPLOYMENT defines in code: identity for the account-settings picker,
+ * plus the factory that builds the {@link BinaryBlobBackend} the composed store writes through.
+ */
+export interface BinaryStoreDefinition {
+    /**
+     * Stable id. It is what an account's content-storage config names, and what is stamped onto
+     * each artifact row's `storage` column, so it must be stable across releases: changing it
+     * orphans the rows already pointing at it (the bytes stay where they are, but nothing left
+     * says which store to ask for them).
+     *
+     * Lowercase letters, digits and dashes, and never one of the platform's own kinds — see
+     * {@link BinaryStoreRegistrationError}.
+     */
+    id: string;
+    /** Human-readable name, shown in the account-settings storage picker. */
+    name: string;
+    /** One line of what it is and where the bytes go, shown beside the name. */
+    summary?: string;
+    /**
+     * Build the backend for one account. Called on a cache miss (the resolver memoises the composed
+     * store per account), so a client built here survives across requests.
+     *
+     * Return `null` for "this deployment cannot serve the store right now" (an unset credential, an
+     * un-provisioned bucket): the resolver treats it exactly as it treats an unsupported built-in
+     * backend, so storage reads as unavailable rather than half-working, and says so in the log.
+     * Throwing is for a programming error, and propagates.
+     *
+     * The returned backend's own `kind` is not used: the resolver stamps {@link id} onto the
+     * artifact rows, because one implementation registered twice (a bucket per region, say) would
+     * otherwise file both registrations' rows under one name.
+     */
+    create(context: BinaryStoreContext): BinaryBlobBackend | null;
+}
+/** What the picker and the boot report show about a registered store — never the backend itself. */
+export interface BinaryStoreView {
+    id: string;
+    name: string;
+    summary?: string;
+}
+/**
+ * A registration this platform refuses. Thrown at REGISTRATION rather than collected as a
+ * warning, because a store is composition code: the deployment is holding the registry when it
+ * happens, and the alternative (a store registered under an id the resolver can never select) is
+ * an account settings picker offering an entry that silently resolves to no storage at all.
+ */
+export declare class BinaryStoreRegistrationError extends Error {
+    constructor(message: string);
+}
+/**
+ * App-owned registry of the deployment's own binary artifact stores. The composition root news
+ * ONE instance and a deployment registers its stores on it by reference; the per-account resolver
+ * builds a backend from it whenever an account has selected one.
+ */
+export declare class BinaryStoreRegistry {
+    private readonly definitions;
+    /**
+     * Register a store. A registration whose id matches an earlier one replaces it (the same
+     * last-wins rule every other app-owned registry uses, so a deployment can override a store its
+     * own shared composition module registered).
+     *
+     * Refuses an id the resolver could not honour: a malformed one, or one of the platform's own
+     * backend kinds. The second is the load-bearing check — `s3` and `fs` are selected through
+     * their own config (a bucket, a base path, sealed credentials), so a store registered under
+     * one of those names would be picked in the UI and never built, with the account looking
+     * correctly configured throughout.
+     */
+    register(definition: BinaryStoreDefinition): void;
+    /** Register several stores at once. */
+    registerAll(definitions: Iterable<BinaryStoreDefinition>): void;
+    /** The registered definition for an id, or undefined when this build registers none. */
+    get(id: string): BinaryStoreDefinition | undefined;
+    /** Every registered id, in registration order. */
+    ids(): string[];
+    /** How many stores are registered — the "does this deployment offer any" check. */
+    get size(): number;
+    /** The picker-facing projection: identity only, never the factory. */
+    views(): BinaryStoreView[];
+}
+/** A fresh, EMPTY registry — the platform registers no custom stores of its own. */
+export declare function defaultBinaryStoreRegistry(): BinaryStoreRegistry;
+//# sourceMappingURL=binary-store-registry.d.ts.map

package/dist/domain/binary-store-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-store-registry.d.ts","sourceRoot":"","sources":["../../src/domain/binary-store-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAErE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAyBjD,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CAAA;CAC9D;AAED,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAKD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAEvE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAkBhD;IAED,uCAAuC;IACvC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAE9D;IAED,wFAAwF;IACxF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEjD;IAED,kDAAkD;IAClD,GAAG,IAAI,MAAM,EAAE,CAEd;IAED,mFAAmF;IACnF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sEAAsE;IACtE,KAAK,IAAI,eAAe,EAAE,CAMzB;CACF;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,IAAI,mBAAmB,CAEhE"}

package/dist/domain/binary-store-registry.js

@@ -0,0 +1,79 @@
+import { BUILTIN_BINARY_ARTIFACT_STORAGE_KINDS } from '../ports/binary-artifacts.js';
+/**
+ * A registration this platform refuses. Thrown at REGISTRATION rather than collected as a
+ * warning, because a store is composition code: the deployment is holding the registry when it
+ * happens, and the alternative (a store registered under an id the resolver can never select) is
+ * an account settings picker offering an entry that silently resolves to no storage at all.
+ */
+export class BinaryStoreRegistrationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BinaryStoreRegistrationError';
+    }
+}
+/** Ids are compared and persisted as-is, so the shape is constrained rather than normalised. */
+const ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,62}$/;
+/**
+ * App-owned registry of the deployment's own binary artifact stores. The composition root news
+ * ONE instance and a deployment registers its stores on it by reference; the per-account resolver
+ * builds a backend from it whenever an account has selected one.
+ */
+export class BinaryStoreRegistry {
+    definitions = new Map();
+    /**
+     * Register a store. A registration whose id matches an earlier one replaces it (the same
+     * last-wins rule every other app-owned registry uses, so a deployment can override a store its
+     * own shared composition module registered).
+     *
+     * Refuses an id the resolver could not honour: a malformed one, or one of the platform's own
+     * backend kinds. The second is the load-bearing check — `s3` and `fs` are selected through
+     * their own config (a bucket, a base path, sealed credentials), so a store registered under
+     * one of those names would be picked in the UI and never built, with the account looking
+     * correctly configured throughout.
+     */
+    register(definition) {
+        const id = definition.id;
+        if (!ID_PATTERN.test(id)) {
+            throw new BinaryStoreRegistrationError(`binary store id ${JSON.stringify(id)} is not usable: use lowercase letters, digits and ` +
+                `dashes (max 63 characters). The id is persisted on every artifact row, so it is ` +
+                `constrained rather than normalised.`);
+        }
+        if (BUILTIN_BINARY_ARTIFACT_STORAGE_KINDS.includes(id)) {
+            throw new BinaryStoreRegistrationError(`binary store id ${JSON.stringify(id)} is one of the platform's own backend kinds ` +
+                `(${BUILTIN_BINARY_ARTIFACT_STORAGE_KINDS.join(', ')}). Those are selected through their ` +
+                `own account config, so a store registered under one would be offered in the settings ` +
+                `picker and never built. Pick another id.`);
+        }
+        this.definitions.set(id, definition);
+    }
+    /** Register several stores at once. */
+    registerAll(definitions) {
+        for (const definition of definitions)
+            this.register(definition);
+    }
+    /** The registered definition for an id, or undefined when this build registers none. */
+    get(id) {
+        return this.definitions.get(id);
+    }
+    /** Every registered id, in registration order. */
+    ids() {
+        return [...this.definitions.keys()];
+    }
+    /** How many stores are registered — the "does this deployment offer any" check. */
+    get size() {
+        return this.definitions.size;
+    }
+    /** The picker-facing projection: identity only, never the factory. */
+    views() {
+        return [...this.definitions.values()].map((definition) => ({
+            id: definition.id,
+            name: definition.name,
+            ...(definition.summary ? { summary: definition.summary } : {}),
+        }));
+    }
+}
+/** A fresh, EMPTY registry — the platform registers no custom stores of its own. */
+export function defaultBinaryStoreRegistry() {
+    return new BinaryStoreRegistry();
+}
+//# sourceMappingURL=binary-store-registry.js.map

package/dist/domain/binary-store-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-store-registry.js","sourceRoot":"","sources":["../../src/domain/binary-store-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAA;AAmFpF;;;;;GAKG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;IAC5C,CAAC;CACF;AAED,gGAAgG;AAChG,MAAM,UAAU,GAAG,2BAA2B,CAAA;AAE9C;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACb,WAAW,GAAG,IAAI,GAAG,EAAiC,CAAA;IAEvE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAiC;QACxC,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAA;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,4BAA4B,CACpC,mBAAmB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,oDAAoD;gBACvF,kFAAkF;gBAClF,qCAAqC,CACxC,CAAA;QACH,CAAC;QACD,IAAK,qCAA2D,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,4BAA4B,CACpC,mBAAmB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,8CAA8C;gBACjF,IAAI,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC;gBAC1F,uFAAuF;gBACvF,0CAA0C,CAC7C,CAAA;QACH,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;IACtC,CAAC;IAED,uCAAuC;IACvC,WAAW,CAAC,WAA4C;QACtD,KAAK,MAAM,UAAU,IAAI,WAAW;YAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IACjE,CAAC;IAED,wFAAwF;IACxF,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,kDAAkD;IAClD,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,mFAAmF;IACnF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC9B,CAAC;IAED,sEAAsE;IACtE,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACzD,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC,CAAA;IACL,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,mBAAmB,EAAE,CAAA;AAClC,CAAC"}

package/dist/domain/gate-registry.d.ts

@@ -123,22 +123,6 @@ export interface GateDefinition {
     wired(): boolean;
     /** Step output recorded when the gate passes through (no provider configured). */
     unwiredOutput: string;
-    /**
-     * What to do when the durable driver's poll budget (ciMaxPolls × ciPollInterval) is
-     * spent while the gate is still `pending` — distinct from the attempt budget (helper
-     * dispatches) handled by {@link onExhausted}:
-     *   - `fail` (default) — the precheck never settled, which is a failure for the CI /
-     *     conflicts gates (CI never went green / the PR never became mergeable).
-     *   - `pass` — for a time-windowed watch gate (post-release-health), running out of
-     *     polls just means the watch window outlasted the budget with NO regression seen,
-     *     which is a healthy pass — not a timeout failure.
-     *   - `rearm` — for an unbounded human-wait gate (`human-review`): there is no deadline
-     *     for a human reviewer, so running out of polls is NOT a verdict. Always re-arm
-     *     another poll cycle (never pass, never fail); the waiting is surfaced via the gate's
-     *     notification (which the severity sweep escalates), not by killing the run.
-     * Resolved by {@link ExecutionService.resolveGatePollExhaustion}.
-     */
-    pollExhaustion?: 'pass' | 'fail' | 'rearm';
     /**
      * Run the precheck against the provider and classify it. Receives the live gate
      * state so a time-windowed gate (post-release-health) can read its `watchSince`.
@@ -267,14 +251,17 @@ export declare class GateRegistry {
      * `kind` is passed explicitly because the factory's result isn't built until the engine
      * invokes it.
      *
-     * `options.configFields` declares the gate's own per-step parameters (see
-     * {@link GateRegistration.configFields}). They sit on the REGISTRATION rather than on the
-     * {@link GateDefinition} because the boundary that needs them most — pipeline save — has no
-     * {@link GateContext} to build a definition with, and a declaration reachable only after the
-     * engine has booted could not refuse a bad pipeline at authoring time.
+     * `options.configFields` declares the gate's own per-step parameters and
+     * `options.pollExhaustion` what running out of polls MEANS for this gate (see
+     * {@link GateRegistration}). Both sit on the REGISTRATION rather than on the
+     * {@link GateDefinition} because the boundaries that need them most have no
+     * {@link GateContext} to build a definition with: pipeline save, which must refuse a bad
+     * pipeline at authoring time, and public-API admission, which must decide at HTTP request
+     * time whether a start can park the run on a person.
      */
     register(kind: string, factory: GateFactory, options?: {
         configFields?: readonly DescriptorField[];
+        pollExhaustion?: GatePollExhaustion;
     }): void;
     /** The registered gates (registration order). */
     factories(): {
@@ -283,6 +270,18 @@ export declare class GateRegistry {
     }[];
     /** Whether a gate is registered for this step kind — the "may this step carry gate config" test. */
     has(kind: string): boolean;
+    /**
+     * What running out of polls MEANS for this gate, as it declared at registration, or
+     * `undefined` when the kind is not registered here at all.
+     *
+     * `undefined` is therefore a THIRD answer and never "the default": a registered gate that
+     * declared nothing answers `'fail'`, the disposition the engine applies to it, while an
+     * unregistered kind answers `undefined` because there is nothing to ask. Two readers depend on
+     * the distinction. The engine resolves the disposition of a spent poll budget; the public API
+     * decides at request time whether a start can park the run on a person forever, and reporting
+     * an unregistered kind as a bounded gate would be a guess about a gate this process cannot see.
+     */
+    pollExhaustion(kind: string): GatePollExhaustion | undefined;
     /**
      * The per-step parameters a gate declared, or `undefined` when it declared none. A gate with no
      * declaration accepts NO per-step fields: an undeclared field is indistinguishable from a
@@ -302,9 +301,42 @@ export declare class GateRegistry {
  * machinery as an initiative preset's form.
  */
 export type GateConfigFields = DescriptorFieldValues;
+/**
+ * What running out of the durable driver's gate-poll budget (ciMaxPolls × ciPollInterval) MEANS,
+ * while the gate is still `pending`. Distinct from the attempt budget (helper dispatches), which
+ * {@link GateDefinition.onExhausted} handles:
+ *
+ *   - `fail` (the default when a registration declares none): the precheck never settled, which
+ *     is a failure for the CI / conflicts gates (CI never went green / the PR never became
+ *     mergeable).
+ *   - `pass`: for a time-windowed watch gate (post-release-health), running out of polls just
+ *     means the watch window outlasted the budget with NO regression seen, which is a healthy
+ *     pass rather than a timeout failure.
+ *   - `rearm`: for an unbounded human-wait gate (`human-review`), there is no deadline for a
+ *     human reviewer, so running out of polls is NOT a verdict. Always re-arm another poll cycle
+ *     (never pass, never fail); the waiting is surfaced via the gate's notification (which the
+ *     severity sweep escalates), not by killing the run.
+ *
+ * Resolved by `ExecutionService.resolveGatePollExhaustion`, and read at HTTP request time by
+ * public-API admission, for which `rearm` IS the definition of a gate that parks on a person.
+ */
+export type GatePollExhaustion = 'pass' | 'fail' | 'rearm';
 /** What a {@link GateRegistry} stores per kind: the factory, plus what the gate declares about itself. */
 export interface GateRegistration {
     factory: GateFactory;
+    /**
+     * What a spent poll budget means for this gate ({@link GatePollExhaustion}); absent ⇒ `fail`.
+     *
+     * On the REGISTRATION rather than on the {@link GateDefinition} the factory builds, because the
+     * two readers that most need it hold no {@link GateContext}: standing a fake one up per HTTP
+     * request to interrogate a static declaration would be a shortcut, not a design. That is why
+     * this used to be mirrored by a hand-kept constant in `@cat-factory/contracts` naming the
+     * shipped human-wait gates, with a drift guard to keep the copy honest, and why a gate a
+     * DEPLOYMENT registered was invisible to the rule, so a plain `write` key could start a
+     * pipeline that then parked on it forever. Declared here, every gate answers for itself and
+     * there is no copy to drift.
+     */
+    pollExhaustion?: GatePollExhaustion;
     /**
      * The gate's own per-step parameters, declared as descriptor fields so ONE declaration drives
      * validation at pipeline save, re-validation at run start, and the authoring form the SPA

package/dist/domain/gate-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate-registry.d.ts","sourceRoot":"","sources":["../../src/domain/gate-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAC7E,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAA;AAmB/B,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpE;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAClG;AAED,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GACzB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAE7C;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CACR,aAAa,EACb,UAAU,GAAG,SAAS,GAAG,4BAA4B,GAAG,eAAe,CACxE,EACD,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,GACT,WAAW,CAeb;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACzC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAE7C,kGAAkG;AAClG,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,YAAY,CAAA;IAClB,0EAA0E;IAC1E,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,KAAK,IAAI,OAAO,CAAA;IAChB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C;;;OAGG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACzF;;;;;;;;;OASG;IACH,aAAa,CAAC,CACZ,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,oBAAoB,CAAC,EAChE,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAA;IACT;;;OAGG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IACtF;;;;;OAKG;IACH,wBAAwB,CAAC,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,GACvB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;IACnD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChE;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrF;;;;;;;;OAQG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,KAAK,EAAE,KAAK,CAAA;IACZ,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACrE,uFAAuF;IACvF,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,oFAAoF;IACpF,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,uFAAuF;IACvF,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;IACtD;;;;OAIG;IACH,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC9C;;;OAGG;IACH,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAA;CACrD;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,CAAA;AAE9D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;KAAO,GAC1D,IAAI,CAEN;IAED,iDAAiD;IACjD,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,EAAE,CAEpD;IAED,oGAAoG;IACpG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,GAAG,SAAS,CAEjE;IAED,mGAAmG;IACnG,WAAW,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;KAAE,EAAE,CAIpE;CACF;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,CAAA;AAEpD,0GAA0G;AAC1G,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAA;IACpB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,EACpC,gBAAgB,GAAE,gBAA4C,GAC7D,WAAW,CAcb"}
+{"version":3,"file":"gate-registry.d.ts","sourceRoot":"","sources":["../../src/domain/gate-registry.ts"],"names":[],"mappings":"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"}

package/dist/domain/gate-registry.js

@@ -49,11 +49,13 @@ export class GateRegistry {
      * `kind` is passed explicitly because the factory's result isn't built until the engine
      * invokes it.
      *
-     * `options.configFields` declares the gate's own per-step parameters (see
-     * {@link GateRegistration.configFields}). They sit on the REGISTRATION rather than on the
-     * {@link GateDefinition} because the boundary that needs them most — pipeline save — has no
-     * {@link GateContext} to build a definition with, and a declaration reachable only after the
-     * engine has booted could not refuse a bad pipeline at authoring time.
+     * `options.configFields` declares the gate's own per-step parameters and
+     * `options.pollExhaustion` what running out of polls MEANS for this gate (see
+     * {@link GateRegistration}). Both sit on the REGISTRATION rather than on the
+     * {@link GateDefinition} because the boundaries that need them most have no
+     * {@link GateContext} to build a definition with: pipeline save, which must refuse a bad
+     * pipeline at authoring time, and public-API admission, which must decide at HTTP request
+     * time whether a start can park the run on a person.
      */
     register(kind, factory, options = {}) {
         this.registry.set(kind, { factory, ...options });
@@ -66,6 +68,23 @@ export class GateRegistry {
     has(kind) {
         return this.registry.has(kind);
     }
+    /**
+     * What running out of polls MEANS for this gate, as it declared at registration, or
+     * `undefined` when the kind is not registered here at all.
+     *
+     * `undefined` is therefore a THIRD answer and never "the default": a registered gate that
+     * declared nothing answers `'fail'`, the disposition the engine applies to it, while an
+     * unregistered kind answers `undefined` because there is nothing to ask. Two readers depend on
+     * the distinction. The engine resolves the disposition of a spent poll budget; the public API
+     * decides at request time whether a start can park the run on a person forever, and reporting
+     * an unregistered kind as a bounded gate would be a guess about a gate this process cannot see.
+     */
+    pollExhaustion(kind) {
+        const registration = this.registry.get(kind);
+        if (!registration)
+            return undefined;
+        return registration.pollExhaustion ?? 'fail';
+    }
     /**
      * The per-step parameters a gate declared, or `undefined` when it declared none. A gate with no
      * declaration accepts NO per-step fields: an undeclared field is indistinguishable from a

package/dist/domain/gate-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate-registry.js","sourceRoot":"","sources":["../../src/domain/gate-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gate-registry.js","sourceRoot":"","sources":["../../src/domain/gate-registry.ts"],"names":[],"mappings":"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"}

package/dist/domain/notification-audience.d.ts

@@ -0,0 +1,27 @@
+import type { AccountRole } from './types.js';
+import type { WorkspaceAccessRow } from './workspace-access.js';
+/** One account membership as the audience rules read it. */
+export interface AudienceAccountMember {
+    userId: string;
+    roles: AccountRole[];
+}
+export interface NotificationAudienceInput {
+    /** The board's access row (owning account, legacy owner, access mode). */
+    workspace: WorkspaceAccessRow;
+    /** Every membership in the board's owning account. Empty for a legacy board. */
+    accountMembers: AudienceAccountMember[];
+    /** The user ids holding an explicit `workspace_members` row on this board. */
+    workspaceMemberUserIds: string[];
+}
+/**
+ * The user ids a workspace notification may be delivered to, de-duplicated and in a
+ * stable order (account roster order, then the member rows).
+ *
+ *  - Legacy / unscoped board (`accountId === null`): its owner alone.
+ *  - `accessMode: 'account'`: every account member (a member ROW is an upgrade-only
+ *    overlay there, so it adds nobody).
+ *  - `accessMode: 'restricted'`: the account admins plus the account members who hold a
+ *    member row.
+ */
+export declare function notificationAudienceUserIds(input: NotificationAudienceInput): string[];
+//# sourceMappingURL=notification-audience.d.ts.map

package/dist/domain/notification-audience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-audience.d.ts","sourceRoot":"","sources":["../../src/domain/notification-audience.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,SAAS,EAAE,kBAAkB,CAAA;IAC7B,gFAAgF;IAChF,cAAc,EAAE,qBAAqB,EAAE,CAAA;IACvC,8EAA8E;IAC9E,sBAAsB,EAAE,MAAM,EAAE,CAAA;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,EAAE,CActF"}

package/dist/domain/notification-audience.js

@@ -0,0 +1,40 @@
+// ---------------------------------------------------------------------------
+// Who a workspace-scoped notification is addressed to, when the channel has to name
+// PEOPLE rather than a destination (email today; any future per-person transport).
+//
+// It is the same question `resolveWorkspaceAccess` answers, asked over a roster instead
+// of about one caller, so it is derived from the SAME rules and lives beside them: a
+// second, looser reading of who can see a board would mail a task's contents to someone
+// the board itself hides it from. Account membership is the prerequisite, an account
+// admin always qualifies, and a `workspace_members` row only counts for someone who is
+// still an account member (an orphaned row is inert, exactly as it is for access).
+//
+// Pure, so both facades and the tests agree without a store.
+// ---------------------------------------------------------------------------
+/**
+ * The user ids a workspace notification may be delivered to, de-duplicated and in a
+ * stable order (account roster order, then the member rows).
+ *
+ *  - Legacy / unscoped board (`accountId === null`): its owner alone.
+ *  - `accessMode: 'account'`: every account member (a member ROW is an upgrade-only
+ *    overlay there, so it adds nobody).
+ *  - `accessMode: 'restricted'`: the account admins plus the account members who hold a
+ *    member row.
+ */
+export function notificationAudienceUserIds(input) {
+    const { workspace, accountMembers, workspaceMemberUserIds } = input;
+    if (workspace.accountId === null) {
+        return workspace.ownerUserId ? [workspace.ownerUserId] : [];
+    }
+    if (workspace.accessMode === 'account') {
+        return unique(accountMembers.map((m) => m.userId));
+    }
+    const rostered = new Set(workspaceMemberUserIds);
+    return unique(accountMembers
+        .filter((m) => m.roles.includes('admin') || rostered.has(m.userId))
+        .map((m) => m.userId));
+}
+function unique(ids) {
+    return [...new Set(ids)];
+}
+//# sourceMappingURL=notification-audience.js.map

package/dist/domain/notification-audience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-audience.js","sourceRoot":"","sources":["../../src/domain/notification-audience.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oFAAoF;AACpF,mFAAmF;AACnF,EAAE;AACF,wFAAwF;AACxF,qFAAqF;AACrF,wFAAwF;AACxF,qFAAqF;AACrF,uFAAuF;AACvF,mFAAmF;AACnF,EAAE;AACF,6DAA6D;AAC7D,8EAA8E;AAoB9E;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAgC;IAC1E,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,sBAAsB,EAAE,GAAG,KAAK,CAAA;IACnE,IAAI,SAAS,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IACpD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,sBAAsB,CAAC,CAAA;IAChD,OAAO,MAAM,CACX,cAAc;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CACxB,CAAA;AACH,CAAC;AAED,SAAS,MAAM,CAAC,GAAa;IAC3B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;AAC1B,CAAC"}

package/dist/domain/types.d.ts

@@ -1,6 +1,6 @@
 export type { AgentKind, AgentState, AgentFailure, AgentFailureKind, AgentRunKind, ModelFamily, ModelFamilyPolicy, ModelPolicyMode, AccountRegion, ModelFamilyPolicyPreset, Block, BlockLevel, BlockStatus, BlockType, TaskType, CreateTaskType, TaskTypeFields, CustomTaskType, TaskTypePresentation, TaskTypeFieldDescriptor, TaskTypeFieldType, TaskTypeFieldOption, DescriptorField, DescriptorFieldType, DescriptorFieldOption, DescriptorFieldShowWhen, DescriptorFieldValue, DescriptorFieldValues, DocKind, Decision, EnvConfigRepairJob, EnvConfigRepairStatus, EnvironmentTestRun, EnvironmentTestStage, EnvironmentTestStatus, ExecutionInstance, ExecutionStatus, IntakeOrigin, InputGateIssue, InputGateIssueCode, InputGateMode, InputGateSeverity, InputGateStatus, RunInputGate, ResolveInputGateChoice, ResolveInputGateRequest, Pipeline, PipelineAvailability, PipelineStep, Position, PriorStepOutput, PromptFragment, PullRequestRef, PeerPullRequest, ReferenceRepo, AprioriBranch, SpendStatus, StepApproval, StepReviewComment, StepSubtasks, WebSearchAvailability, WebSearchProvider, Workspace, WorkspaceSnapshot, FragmentOwnerKind, FragmentTier, CreatePromptFragmentInput, CreateDocumentFragmentInput, UpdatePromptFragmentInput, FragmentSource, LinkFragmentSourceInput, FragmentSyncResult, FragmentSourceStatus, ResolvedFragment, ResolvedFragmentCatalog, Account, AccountType, AccountRole, AccountMember, CreateAccountInput, AddMemberInput, WorkspaceRole, WorkspacePermission, WorkspaceAccessMode, WorkspaceMember, Service, WorkspaceMount, MountServiceInput, UpdateMountInput, GitHubBranch, GitHubCheckRun, GitHubCommit, GitHubConnection, GitHubInstallationOption, GitHubAvailableRepo, GitHubIssue, GitHubIssueState, GitHubPullRequest, GitHubPullRequestState, OpenedPullRequest, GitHubRepo, RepoTreeEntry, SetRepoMonorepoInput, CommitFilesInput, LinkReposInput, OpenPullRequestInput, MergePullRequestInput, ProviderConfigFieldType, ProviderConfigField, ProviderDescriptor, ConnectionTestResult, ConnectionWarning, ConnectionWarningCode, UserSecretKind, UserSecretStatus, StoreUserSecretInput, TestUserSecretInput, UserSecretDescriptor, DocumentSourceKind, DocumentOrigin, DocumentLinkRole, DocumentRenderStatus, DocumentSourceDescriptor, CredentialField, DocumentConnection, SourceDocument, DocumentSearchResult, DocumentBoardPlan, PlanFrame, PlanModule, PlanTask, TaskSourceKind, TaskSourceDescriptor, TaskSourceState, TaskSourceDiagnostic, TaskSourceDiagnosticStatus, TaskConnection, TaskComment, TaskDependencyLink, SourceTask, TaskSearchResult, IssueIntakePredicate, TrackerBoard, BugCandidate, BugHuntAnalysis, BugHuntAnalysisStatus, BugHuntCandidate, BugHuntConfidence, BugHuntResult, RunBugHuntInput, EnvironmentSecretRef, EnvironmentAuthScheme, EnvironmentHttpMethod, EnvironmentRequestTemplate, EnvironmentStatus, TeardownConfirmation, EnvironmentAccessScheme, EnvironmentAccessMapping, EnvironmentResponseMapping, EnvironmentManifest, EnvironmentBackendConfig, EnvironmentBackendKind, KubernetesEnvironmentConfig, KubernetesManifestSource, KubernetesUrlSource, KubernetesRenderer, KubernetesImageOverride, KubernetesHelmRelease, KubernetesHelmSet, KubernetesSecretEntry, KubernetesSecretInjection, KubernetesProvisionConfig, CloudflareEnvironmentConfig, ProvisionType, EnvironmentFailureReason, InfraEngine, ManifestId, ServiceProvisioning, StackRecipe, RecipeStep, RecipeStepKind, RecipeHealthGate, RecipeEnvFile, PreflightCheckId, PreflightParams, PreflightRef, PreflightStatus, PreflightResult, FrontendConfig, FrontendBackendBinding, FrontendBackendSource, ResolvedFrontendBinding, LiveEnvHandle, ServiceConnection, KubernetesEngineConfig, InfraHandlerConfig, CustomManifestType, CustomManifestTypeSource, UpsertCustomManifestTypeInput, EnvironmentAccessHandle, EnvironmentHandle, EnvironmentConnection, TestEnvironmentConnectionInput, TestEnvironmentHandlerInput, ValidateEnvironmentRepoInput, BootstrapEnvironmentRepoInput, BootstrapRepoResult, TestSecretRef, TestSecretEntry, ServiceTestSecretsView, UpsertServiceTestSecretsInput, ProvisioningSubsystem, ProvisioningOperation, ProvisioningOutcome, ProvisioningLogEntry, RunnerPoolSecretRef, RunnerPoolAuthScheme, RunnerPoolRequestTemplate, RunnerJobState, RunnerPoolResponseMapping, RunnerPoolManifest, RunnerPoolConnection, TestRunnerPoolConnectionInput, RunnerBackendConfig, RunnerBackendKind, KubernetesRunnerConfig, KubernetesResourceQuantities, ReferenceArchitecture, CreateReferenceArchitectureInput, UpdateReferenceArchitectureInput, BootstrapStatus, BootstrapFailure, BootstrapFailureKind, BootstrapJob, BootstrapRepoInput, BlueprintModule, BlueprintService, BlueprintSource, BoardScanSpawnResult, ReviewItemCategory, ReviewItemSeverity, ReviewItemStatus, RequirementReviewItem, RequirementReviewStatus, RequirementReview, DocInterviewQa, DocInterviewStatus, DocInterviewSession, AnswerDocInterviewInput, KaizenGradingStatus, KaizenGrading, KaizenVerifiedCombo, KaizenOverview, KaizenRunGradings, RecommendationStatus, RequirementRecommendation, ReplyReviewItemInput, UpdateReviewItemStatusInput, IncorporateRequirementsInput, RequestRecommendationItem, RequestRecommendationsInput, ReRequestRecommendationInput, ResolveRequirementsExceededInput, ResolveRequirementsExceededChoice, FollowUpItemKind, FollowUpItemStatus, FollowUpItem, FollowUpsStepState, AnswerFollowUpInput, StreamedFollowUp, ForkOption, ForkChatMessage, ForkDecisionStatus, ForkChoice, ForkDecisionStepState, ForkChatRequestInput, ChooseForkInput, ForkProposal, JudgeFindingSeverity, JudgeFinding, JudgeVerdict, JudgeDisposition, JudgeStatus, JudgeRound, JudgeStepState, JudgeModelPin, JudgeModelPinStatus, ResolveJudgeInput, PrReviewSeverity, PrReviewCategory, PrReviewSlice, PrReviewSliceReview, PrReviewFinding, PrReviewFindingChallenge, PrReviewStatus, PrReviewResolution, PrReviewStepState, PrReviewPostReport, PrReviewPostFailure, PrReviewAgentOutput, PrReviewChallengeOutput, ResolvePrReviewInput, ChallengePrReviewFindingInput, ClarityReviewItem, ClarityReviewStatus, ClarityReview, ReplyClarityItemInput, UpdateClarityItemStatusInput, IncorporateClarityInput, ResolveClarityExceededInput, ResolveClarityExceededChoice, BrainstormStage, BrainstormItem, BrainstormStatus, BrainstormSession, ReplyBrainstormItemInput, UpdateBrainstormItemStatusInput, IncorporateBrainstormInput, ResolveBrainstormExceededInput, ResolveBrainstormExceededChoice, IterationCapChoice, ResolveIterationCapInput, RequirementPriority, RequirementKind, 
 /** Implementation state: agreed-but-not-built vs observed-to-hold. */
-RequirementState, AcceptanceCriterion, RequirementItem, DomainRule, RequirementGroup, SpecModule, SpecDoc, CompanionAssessment, CompanionVerdict, GateStepState, GateFailingCheck, GateAttempt, RalphStepState, RalphVerdict, RalphAttempt, ValidationCheck, ValidationCheckOutcome, ValidationReport, ResolvedValidationChecks, ServiceValidationConfig, UpsertServiceValidationConfigInput, ReproductionProofMode, ResolvedReproduction, ReproductionStatus, ReproductionPhaseOutcome, ReproductionReport, HumanTestStepState, HumanTestEnvironment, HumanTestRound, RequestHumanTestFixInput, VisualConfirmStepState, VisualConfirmPair, VisualConfirmReferenceOrigin, VisualConfirmDesignGap, VisualConfirmDesignGapReason, VisualConfirmDesignReferences, VisualConfirmRound, MergeAssessment, MergeAxis, MergeDecision, MergeDecisionThresholds, MergeClassRule, MergeClassRules, ClassRulesByRole, SubmissionClassesByRole, RunMode, ChangeClass, ReviewEffort, MergeTrackDecision, MergeTrackRecord, MergeClassRollup, ReviewEffortDistribution, TagReviewEffortInput, PrVerificationReport, PrReportScope, PrReportOwnPullRequest, PrReportSectionStatus, PrReportStep, PrReportIssue, PrReportJudge, PrReportRun, PrReportCheck, PrReportCi, PrReportTestOutcome, PrReportTestConcern, PrReportTests, PrReportContext, PrReportContextDocument, PrReportValidation, PrReportValidationCommand, PrReportReproduction, PrReportReproductionPhase, PrReportEnvironment, PrReportEnvironments, PrReportEnvironmentTimeline, PrReportTimelineGap, PrReportEnvironmentEvidence, PrReportEvidenceArtifact, PrReportRequirement, PrReportRequirements, PrReportMerge, PrReportObservability, RiskPolicy, RequirementConcernLevel, CreateRiskPolicyInput, UpdateRiskPolicyInput, ComposeFileRef, ComposeSource, ComposeSourceKind, SharedStack, SharedStackStatus, CreateSharedStackInput, UpdateSharedStackInput, DetectSharedStackInput, SharedStackRecommendation, ConsensusStrategy, ConsensusParticipant, ConsensusGating, StepGating, ConsensusStepConfig, ConsensusGroup, CreateConsensusGroupInput, UpdateConsensusGroupInput, TaskEstimate, ConsensusScore, ConsensusContribution, ConsensusRound, ConsensusSessionStatus, ConsensusSession, AgentConfigOption, AgentConfigDescriptor, AgentConfigCatalog, AgentConfigValues, TestReport, TestOutcome, TestConcern, TestConcernSeverity, RequirementVerdict, RequirementVerdictStatus, TesterQualityConfig, StepOptions, StepGateConfig, GateApproverPolicy, GateApprovalRecord, CloudProvider, InstanceSize, UpdateAccountInput, ModelFlavor, ModelPreset, CreateModelPresetInput, UpdateModelPresetInput, AgentPromptRevision, AgentPromptDetail, AgentPromptSummary, SaveAgentPromptInput, PromoteAgentPromptInput, WorkspaceAgentSettings, UpdateWorkspaceAgentSettingsInput, ServiceFragmentDefaults, SetServiceFragmentDefaultsInput, Notification, NotificationType, NotificationStatus, NotificationSeverity, NotificationPayload, ResolveNotificationAction, WorkspaceSettings, UpdateWorkspaceSettingsInput, TaskLimitMode, TaskLimitPerType, UserSettings, UpdateUserSettingsInput, TutorialProgress, TutorialDecision, UpdateTutorialProgressInput, TutorialEvent, RecordTutorialEventInput, SlackConnection, SlackRoute, SlackNotificationSettings, SlackMemberMappingEntry, SlackMemberRole, SlackMemberMapping, SlackChannel, ConnectSlackByTokenInput, UpdateSlackSettingsInput, UpdateSlackMemberMappingInput, ScheduleTemplate, Recurrence, IssueIntakeConfig, PipelineSchedule, ScheduleRun, CreateScheduleInput, UpdateScheduleInput, TrackerKind, TrackerSettings, PutTrackerSettingsInput, WritebackOverride, LlmCallActivity, SandboxPromptOrigin, SandboxPromptVersion, SandboxFixtureKind, SandboxRepoRef, SandboxFixtureObjective, SandboxFixture, SandboxExperimentStatus, SandboxMatrix, SandboxExperiment, SandboxRunStatus, SandboxTokenUsage, SandboxRun, SandboxGradeDimension, SandboxObjectiveResult, SandboxGrade, Initiative, InitiativeStatus, InitiativeItem, InitiativeItemStatus, InitiativePhase, InitiativeEstimate, InitiativePipelineRule, InitiativeExecutionPolicy, InitiativeDecision, InitiativeDeviation, InitiativeFollowUp, InitiativeQa, InitiativeQaStatus, InitiativeInterviewState, InitiativePlanDraft, InitiativeDraftItem, InitiativeVersion, CreateInitiativeInput, AnswerInitiativeQuestionInput, PromoteInitiativeFollowUpInput, UpdateInitiativeItemInput, UpdateInitiativePolicyInput, AccountSettingsConfig, ContentStorageConfig, FigmaOAuthSecret, LinearOAuthSecret, S3CredentialsSecret, SlackOAuthSecret, WebSearchSecret, } from '@cat-factory/contracts';
+RequirementState, AcceptanceCriterion, RequirementItem, DomainRule, RequirementGroup, SpecModule, SpecDoc, CompanionAssessment, CompanionVerdict, GateStepState, GateFailingCheck, GateAttempt, RalphStepState, RalphVerdict, RalphAttempt, ValidationCheck, ValidationCheckOutcome, ValidationReport, ResolvedValidationChecks, ServiceValidationConfig, UpsertServiceValidationConfigInput, ReproductionProofMode, ResolvedReproduction, ReproductionStatus, ReproductionPhaseOutcome, ReproductionReport, HumanTestStepState, HumanTestEnvironment, HumanTestRound, RequestHumanTestFixInput, VisualConfirmStepState, VisualConfirmPair, VisualConfirmReferenceOrigin, VisualConfirmDesignGap, VisualConfirmDesignGapReason, VisualConfirmDesignReferences, VisualConfirmRound, MergeAssessment, MergeAxis, MergeDecision, MergeDecisionThresholds, MergeClassRule, MergeClassRules, ClassRulesByRole, SubmissionClassesByRole, RunMode, ChangeClass, ReviewEffort, MergeTrackDecision, MergeTrackRecord, MergeClassRollup, ReviewEffortDistribution, TagReviewEffortInput, PrVerificationReport, PrReportScope, PrReportOwnPullRequest, PrReportSectionStatus, PrReportStep, PrReportIssue, PrReportJudge, PrReportRun, PrReportCheck, PrReportCi, PrReportTestOutcome, PrReportTestConcern, PrReportTests, PrReportContext, PrReportContextDocument, PrReportValidation, PrReportValidationCommand, PrReportReproduction, PrReportReproductionPhase, PrReportEnvironment, PrReportEnvironments, PrReportEnvironmentTimeline, PrReportTimelineGap, PrReportEnvironmentEvidence, PrReportEvidenceArtifact, PrReportRequirement, PrReportRequirements, PrReportMerge, PrReportObservability, RiskPolicy, RequirementConcernLevel, CreateRiskPolicyInput, UpdateRiskPolicyInput, ComposeFileRef, ComposeSource, ComposeSourceKind, SharedStack, SharedStackStatus, CreateSharedStackInput, UpdateSharedStackInput, DetectSharedStackInput, SharedStackRecommendation, ConsensusStrategy, ConsensusParticipant, ConsensusGating, StepGating, ConsensusStepConfig, ConsensusGroup, CreateConsensusGroupInput, UpdateConsensusGroupInput, TaskEstimate, ConsensusScore, ConsensusContribution, ConsensusRound, ConsensusSessionStatus, ConsensusSession, AgentConfigOption, AgentConfigDescriptor, AgentConfigCatalog, AgentConfigValues, TestReport, TestOutcome, TestConcern, TestConcernSeverity, RequirementVerdict, RequirementVerdictStatus, TesterQualityConfig, StepOptions, StepGateConfig, GateApproverPolicy, GateApprovalRecord, CloudProvider, InstanceSize, UpdateAccountInput, ModelFlavor, ModelPreset, CreateModelPresetInput, UpdateModelPresetInput, AgentPromptRevision, AgentPromptDetail, AgentPromptSummary, SaveAgentPromptInput, PromoteAgentPromptInput, WorkspaceAgentSettings, UpdateWorkspaceAgentSettingsInput, ServiceFragmentDefaults, SetServiceFragmentDefaultsInput, Notification, NotificationType, NotificationStatus, NotificationSeverity, NotificationPayload, ResolveNotificationAction, NotificationDeliveryChannel, NotificationChannelOverrides, NotificationRoutingMatrix, NotificationSettings, UpdateNotificationSettingsInput, WorkspaceSettings, UpdateWorkspaceSettingsInput, TaskLimitMode, TaskLimitPerType, UserSettings, UpdateUserSettingsInput, TutorialProgress, TutorialDecision, UpdateTutorialProgressInput, TutorialEvent, RecordTutorialEventInput, SlackConnection, SlackRoute, SlackNotificationSettings, SlackMemberMappingEntry, SlackMemberRole, SlackMemberMapping, SlackChannel, ConnectSlackByTokenInput, UpdateSlackSettingsInput, UpdateSlackMemberMappingInput, ScheduleTemplate, Recurrence, IssueIntakeConfig, PipelineSchedule, ScheduleRun, CreateScheduleInput, UpdateScheduleInput, TrackerKind, TrackerSettings, PutTrackerSettingsInput, WritebackOverride, LlmCallActivity, SandboxPromptOrigin, SandboxPromptVersion, SandboxFixtureKind, SandboxRepoRef, SandboxFixtureObjective, SandboxFixture, SandboxExperimentStatus, SandboxMatrix, SandboxExperiment, SandboxRunStatus, SandboxTokenUsage, SandboxRun, SandboxGradeDimension, SandboxObjectiveResult, SandboxGrade, Initiative, InitiativeStatus, InitiativeItem, InitiativeItemStatus, InitiativePhase, InitiativeEstimate, InitiativePipelineRule, InitiativeExecutionPolicy, InitiativeDecision, InitiativeDeviation, InitiativeFollowUp, InitiativeQa, InitiativeQaStatus, InitiativeInterviewState, InitiativePlanDraft, InitiativeDraftItem, InitiativeVersion, CreateInitiativeInput, AnswerInitiativeQuestionInput, PromoteInitiativeFollowUpInput, UpdateInitiativeItemInput, UpdateInitiativePolicyInput, AccountSettingsConfig, ContentStorageConfig, FigmaOAuthSecret, LinearOAuthSecret, S3CredentialsSecret, SlackOAuthSecret, WebSearchSecret, } from '@cat-factory/contracts';
 /**
  * A backend-prepared file to inject into a container agent's `.cat-context/` directory before
  * it runs — the deterministic analogue of the linked-doc context the executor already

package/dist/domain/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/domain/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/domain/types.ts"],"names":[],"mappings":"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"}

package/dist/domain/vcs-errors.d.ts

@@ -1,4 +1,29 @@
 import type { VcsProvider } from './vcs-types.js';
+import { UnavailableError } from './errors.js';
+/**
+ * A provider-routing VCS client was asked for a member the ROUTED provider's client does not
+ * implement, while the other configured provider's does. Thrown by
+ * `providerRoutingGitHubClient` (`@cat-factory/server`) and lives here so a consumer BELOW the
+ * server layer can catch it.
+ *
+ * A distinct class rather than a bare {@link UnavailableError} because the two facts need
+ * different handling and only the caller knows which it can absorb: the generic 503 says "this
+ * deployment has not configured the capability", a build problem an operator fixes by wiring
+ * something, while this is a permanent property of the provider the workspace CONNECTED, which
+ * no amount of wiring changes. A caller that already models "the client cannot answer this"
+ * (`GitHubService.checkDefaultBranchProtection`'s `capability: 'unavailable'`) reports that;
+ * one that does not lets it surface as the 503 it is.
+ *
+ * Surfacing is only honest because the reason is a member of contracts' `UNAVAILABLE_REASONS`
+ * and the SPA keys its own copy off it. Without that entry the 503 renders as the generic
+ * "not configured" wording, so the class would state the distinction in its own message while
+ * the only text a user reads asserts the opposite.
+ */
+export declare class VcsCapabilityUnsupportedError extends UnavailableError {
+    readonly provider: VcsProvider;
+    readonly operation: string;
+    constructor(provider: VcsProvider, operation: string);
+}
 /** In-repo docs the VCS remedies deep-link to. */
 export declare const VCS_DOC_URLS: {
     /** GitHub connect / repo linking. */

package/dist/domain/vcs-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vcs-errors.d.ts","sourceRoot":"","sources":["../../src/domain/vcs-errors.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAOjD,kDAAkD;AAClD,eAAO,MAAM,YAAY;IACvB,qCAAqC;aACrC,iBAAiB;IACjB,oCAAoC;aACpC,gBAAgB;IAChB,oDAAoD;aACpD,YAAY;CACJ,CAAA;AAEV,mFAAmF;AACnF,eAAO,MAAM,oBAAoB;aAC/B,aAAa,EAAE,2CAA2C;CAClD,CAAA;AAEV,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,CAAA;IACrB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6FAA6F;IAC7F,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAmDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAMpE"}
+{"version":3,"file":"vcs-errors.d.ts","sourceRoot":"","sources":["../../src/domain/vcs-errors.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAY9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;IAE/D,QAAQ,CAAC,QAAQ,EAAE,WAAW;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAF5B,YACW,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EAM3B;CACF;AAOD,kDAAkD;AAClD,eAAO,MAAM,YAAY;IACvB,qCAAqC;aACrC,iBAAiB;IACjB,oCAAoC;aACpC,gBAAgB;IAChB,oDAAoD;aACpD,YAAY;CACJ,CAAA;AAEV,mFAAmF;AACnF,eAAO,MAAM,oBAAoB;aAC/B,aAAa,EAAE,2CAA2C;CAClD,CAAA;AAEV,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,CAAA;IACrB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6FAA6F;IAC7F,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAmDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAMpE"}

package/dist/domain/vcs-errors.js

@@ -15,6 +15,47 @@
 // `@cat-factory/gitlab`) but share `@cat-factory/kernel`, so keeping the copy here keeps the two
 // providers' remedies from drifting and lets the mapping be unit-tested in one place.
 // ---------------------------------------------------------------------------
+import { UnavailableError } from './errors.js';
+/**
+ * Typed against the SHARED vocabulary rather than passed as a bare string, because this reason
+ * only does its job if the SPA has copy keyed to it. `UnavailableError.reason` is `string` on
+ * purpose (most reasons are internal and never reach a human), so nothing else would notice if
+ * the entry were dropped from `UNAVAILABLE_REASONS`: the refusal would keep working and quietly
+ * fall back to the generic "not configured" wording this class exists to avoid. Naming the union
+ * here turns that into a build failure.
+ */
+const VCS_CAPABILITY_UNSUPPORTED = 'vcs_capability_unsupported';
+/**
+ * A provider-routing VCS client was asked for a member the ROUTED provider's client does not
+ * implement, while the other configured provider's does. Thrown by
+ * `providerRoutingGitHubClient` (`@cat-factory/server`) and lives here so a consumer BELOW the
+ * server layer can catch it.
+ *
+ * A distinct class rather than a bare {@link UnavailableError} because the two facts need
+ * different handling and only the caller knows which it can absorb: the generic 503 says "this
+ * deployment has not configured the capability", a build problem an operator fixes by wiring
+ * something, while this is a permanent property of the provider the workspace CONNECTED, which
+ * no amount of wiring changes. A caller that already models "the client cannot answer this"
+ * (`GitHubService.checkDefaultBranchProtection`'s `capability: 'unavailable'`) reports that;
+ * one that does not lets it surface as the 503 it is.
+ *
+ * Surfacing is only honest because the reason is a member of contracts' `UNAVAILABLE_REASONS`
+ * and the SPA keys its own copy off it. Without that entry the 503 renders as the generic
+ * "not configured" wording, so the class would state the distinction in its own message while
+ * the only text a user reads asserts the opposite.
+ */
+export class VcsCapabilityUnsupportedError extends UnavailableError {
+    provider;
+    operation;
+    constructor(provider, operation) {
+        super(`The ${provider} client does not support ${operation}`, VCS_CAPABILITY_UNSUPPORTED, {
+            provider,
+            operation,
+        });
+        this.provider = provider;
+        this.operation = operation;
+    }
+}
 // In-repo docs are linked as stable GitHub blob URLs on `main`. Kernel sits BELOW the server
 // layer, so it cannot import `@cat-factory/server`'s `config/docs.ts`; per the doc-URL convention
 // a package outside the server layer keeps its own equivalent — this is that equivalent.