@mmnto/totem 2.2.1 → 2.3.0

package/dist/bot-identity.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The ONE definition of the review-bot identities the cohort reads
+ * (mmnto-ai/totem#2800, errata item 1).
+ *
+ * Before this module the same three logins were declared twice — a loose
+ * substring/shape match in `packages/cli/src/parsers/bot-review-parser.ts` and
+ * an exact-login actor map in `packages/core/src/capability/review-catch.ts` —
+ * so a login that drifted (or a fourth bot) had to be found in two places and
+ * a stale copy read as "no bot here", the silent direction. Both consumers now
+ * import this array; `bot-identity-parity.test.ts` fails if either declares a
+ * list of its own.
+ *
+ * TWO SURFACES, TWO PATTERNS — the trap this module exists to hold:
+ * GitHub's REST author is `gemini-code-assist[bot]`, its GraphQL
+ * `author.login` for the SAME actor is `gemini-code-assist` (no `[bot]`
+ * suffix). Observed 2026-09-07 on mmnto-ai/totem#2834 (REST
+ * `repos/mmnto-ai/totem/pulls/2834/reviews` → `coderabbitai[bot]`,
+ * `gemini-code-assist[bot]`, `greptile-apps[bot]`) and on
+ * mmnto-ai/liquid-city#363 (GraphQL `reviewThreads.comments.author.login` →
+ * `gemini-code-assist`). So each identity carries BOTH:
+ *   - `loginPattern` — the loose, substring-style read of a REST-shaped login
+ *     (triage's surface: recognize every finding, `[bot]` suffix required for
+ *     the shape-matched bots so a human `alice-greptile` is never a bot); and
+ *   - `exactLogins` — the CLOSED list of logins actually OBSERVED, each in
+ *     both spellings (with and without `[bot]`). It is a membership test, not a
+ *     pattern: a wildcard variant arm (`greptile-<anything>`) admitted human
+ *     accounts like `greptile-fan`, which would let a human comment gate a
+ *     merge (mmnto-ai/totem#2800 fold F5). A new bot variant is added HERE, by
+ *     observation, the same way the first ones were.
+ * A gate that reads GraphQL (merge-ready) uses `exactLogins`; triage keeps
+ * `loginPattern`.
+ *
+ * The GREPTILE login is fixed BY OBSERVATION, not by either stale copy: the
+ * runs above show `greptile-apps[bot]` on every totem PR greptile reviewed in
+ * the 2026-09 window (#2821, #2827, #2831, #2834). The loose `loginPattern`
+ * keeps its variant arm (a renamed app is still SURFACED to triage, and the
+ * required `[bot]` suffix keeps a human out); the anchored `exactLogins` list
+ * carries only what has been observed, so nothing a human could register
+ * satisfies the gate's read.
+ */
+/** Triage's compact tool id (the `BotTool` members that are bots). */
+export type BotReviewerTool = 'coderabbit' | 'gca' | 'greptile' | 'ghcq';
+export interface BotReviewerIdentity {
+    /** Triage's compact display id for this reviewer. */
+    tool: BotReviewerTool;
+    /**
+     * Loose recognition over a REST-shaped author login (`name[bot]`). Substring
+     * for the two bots whose login is stable; bot-login SHAPE (with the `[bot]`
+     * suffix required) for the two matched by shape.
+     */
+    loginPattern: RegExp;
+    /**
+     * The closed list of logins observed for this reviewer, lowercase, in BOTH
+     * spellings: the REST one (`name[bot]`) and the GraphQL one (no suffix).
+     * Membership, never a pattern — see the module header.
+     */
+    exactLogins: readonly string[];
+    /**
+     * The stable Layer-B actor id for hit-rate attribution
+     * (`capability/review-catch.ts`), when this reviewer has one. `ghcq` has
+     * none: it is not one of the three paid review bots the ledger attributes to,
+     * and minting one here would silently change `resolveActorId`.
+     */
+    actorId?: string;
+    /**
+     * The EXACT lowercase logins that resolve to `actorId`. EXACT, not a prefix:
+     * a future variant like `greptile-enterprise[bot]` must not be silently
+     * collapsed into `greptile` and mixed into its hit-rate.
+     */
+    actorLogins: readonly string[];
+}
+/**
+ * The review bots, in triage's detection order (first match wins, so a login
+ * that could satisfy two patterns resolves the same way it did before this
+ * array existed).
+ */
+export declare const BOT_REVIEWER_IDENTITIES: readonly BotReviewerIdentity[];
+/** Is this REST-shaped author login one of the known review bots? */
+export declare function isBotReviewerLogin(author: string): boolean;
+/** Triage's tool id for a REST-shaped author login, or null when it is not a known bot. */
+export declare function detectBotReviewer(author: string): BotReviewerTool | null;
+/**
+ * Is this a known review bot on a surface that spells the login WHOLE — the
+ * GraphQL `author.login`, where the `[bot]` suffix is absent? A CLOSED-list
+ * membership test: a login not on the observed list is not a bot, so no human
+ * account can satisfy it (mmnto-ai/totem#2800 fold F5).
+ */
+export declare function isBotReviewerLoginExact(author: string): boolean;
+/**
+ * The exact-login → Layer-B actor-id map, built from the identities that carry
+ * an `actorId`. Keys are lowercase EXACT logins (see `actorLogins`).
+ */
+export declare function botReviewerActorIds(): Readonly<Record<string, string>>;
+//# sourceMappingURL=bot-identity.d.ts.map

package/dist/bot-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-identity.d.ts","sourceRoot":"","sources":["../src/bot-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,IAAI,EAAE,eAAe,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAoChE,CAAC;AAEH,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAStE"}

package/dist/bot-identity.js

@@ -0,0 +1,118 @@
+/**
+ * The ONE definition of the review-bot identities the cohort reads
+ * (mmnto-ai/totem#2800, errata item 1).
+ *
+ * Before this module the same three logins were declared twice — a loose
+ * substring/shape match in `packages/cli/src/parsers/bot-review-parser.ts` and
+ * an exact-login actor map in `packages/core/src/capability/review-catch.ts` —
+ * so a login that drifted (or a fourth bot) had to be found in two places and
+ * a stale copy read as "no bot here", the silent direction. Both consumers now
+ * import this array; `bot-identity-parity.test.ts` fails if either declares a
+ * list of its own.
+ *
+ * TWO SURFACES, TWO PATTERNS — the trap this module exists to hold:
+ * GitHub's REST author is `gemini-code-assist[bot]`, its GraphQL
+ * `author.login` for the SAME actor is `gemini-code-assist` (no `[bot]`
+ * suffix). Observed 2026-09-07 on mmnto-ai/totem#2834 (REST
+ * `repos/mmnto-ai/totem/pulls/2834/reviews` → `coderabbitai[bot]`,
+ * `gemini-code-assist[bot]`, `greptile-apps[bot]`) and on
+ * mmnto-ai/liquid-city#363 (GraphQL `reviewThreads.comments.author.login` →
+ * `gemini-code-assist`). So each identity carries BOTH:
+ *   - `loginPattern` — the loose, substring-style read of a REST-shaped login
+ *     (triage's surface: recognize every finding, `[bot]` suffix required for
+ *     the shape-matched bots so a human `alice-greptile` is never a bot); and
+ *   - `exactLogins` — the CLOSED list of logins actually OBSERVED, each in
+ *     both spellings (with and without `[bot]`). It is a membership test, not a
+ *     pattern: a wildcard variant arm (`greptile-<anything>`) admitted human
+ *     accounts like `greptile-fan`, which would let a human comment gate a
+ *     merge (mmnto-ai/totem#2800 fold F5). A new bot variant is added HERE, by
+ *     observation, the same way the first ones were.
+ * A gate that reads GraphQL (merge-ready) uses `exactLogins`; triage keeps
+ * `loginPattern`.
+ *
+ * The GREPTILE login is fixed BY OBSERVATION, not by either stale copy: the
+ * runs above show `greptile-apps[bot]` on every totem PR greptile reviewed in
+ * the 2026-09 window (#2821, #2827, #2831, #2834). The loose `loginPattern`
+ * keeps its variant arm (a renamed app is still SURFACED to triage, and the
+ * required `[bot]` suffix keeps a human out); the anchored `exactLogins` list
+ * carries only what has been observed, so nothing a human could register
+ * satisfies the gate's read.
+ */
+/**
+ * The review bots, in triage's detection order (first match wins, so a login
+ * that could satisfy two patterns resolves the same way it did before this
+ * array existed).
+ */
+export const BOT_REVIEWER_IDENTITIES = Object.freeze([
+    {
+        tool: 'coderabbit',
+        loginPattern: /coderabbit/i,
+        exactLogins: ['coderabbitai', 'coderabbitai[bot]'],
+        actorId: 'coderabbit',
+        actorLogins: ['coderabbitai[bot]'],
+    },
+    {
+        tool: 'gca',
+        loginPattern: /gemini-code-assist/i,
+        exactLogins: ['gemini-code-assist', 'gemini-code-assist[bot]'],
+        // The Layer-B actor id deliberately diverges from triage's compact `gca`:
+        // the ledger keys hit-rate on the full name.
+        actorId: 'gemini-code-assist',
+        actorLogins: ['gemini-code-assist[bot]'],
+    },
+    {
+        tool: 'greptile',
+        // The reviewer's suggested trailing `\b` fails right after the closing `]`
+        // (a non-word char at end-of-string), so it is deliberately absent.
+        loginPattern: /\bgreptile(?:-[^[]+)?\[bot\]/i,
+        exactLogins: ['greptile-apps', 'greptile-apps[bot]'],
+        actorId: 'greptile',
+        // Observed 2026-09-07 on mmnto-ai/totem#2821, #2827, #2831 and #2834.
+        actorLogins: ['greptile-apps[bot]'],
+    },
+    {
+        // GitHub's own `github-code-quality[bot]` (mmnto-ai/totem#2626): an
+        // inline-comment-only surface with no @-listener. Recognized by triage,
+        // deliberately WITHOUT an actorId (see `actorId` above).
+        tool: 'ghcq',
+        loginPattern: /\bgithub-code-quality(?:-[^[]+)?\[bot\]/i,
+        exactLogins: ['github-code-quality', 'github-code-quality[bot]'],
+        actorLogins: [],
+    },
+]);
+/** Is this REST-shaped author login one of the known review bots? */
+export function isBotReviewerLogin(author) {
+    return BOT_REVIEWER_IDENTITIES.some((id) => id.loginPattern.test(author));
+}
+/** Triage's tool id for a REST-shaped author login, or null when it is not a known bot. */
+export function detectBotReviewer(author) {
+    return BOT_REVIEWER_IDENTITIES.find((id) => id.loginPattern.test(author))?.tool ?? null;
+}
+/**
+ * Is this a known review bot on a surface that spells the login WHOLE — the
+ * GraphQL `author.login`, where the `[bot]` suffix is absent? A CLOSED-list
+ * membership test: a login not on the observed list is not a bot, so no human
+ * account can satisfy it (mmnto-ai/totem#2800 fold F5).
+ */
+export function isBotReviewerLoginExact(author) {
+    const trimmed = author.trim().toLowerCase();
+    if (trimmed.length === 0)
+        return false;
+    return BOT_REVIEWER_IDENTITIES.some((id) => id.exactLogins.includes(trimmed));
+}
+/**
+ * The exact-login → Layer-B actor-id map, built from the identities that carry
+ * an `actorId`. Keys are lowercase EXACT logins (see `actorLogins`).
+ */
+export function botReviewerActorIds() {
+    const map = {};
+    for (const id of BOT_REVIEWER_IDENTITIES) {
+        if (id.actorId === undefined)
+            continue;
+        for (const login of id.actorLogins) {
+            map[login.toLowerCase()] = id.actorId;
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=bot-identity.js.map

package/dist/bot-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-identity.js","sourceRoot":"","sources":["../src/bot-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAmCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmC,MAAM,CAAC,MAAM,CAAC;IACnF;QACE,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,aAAa;QAC3B,WAAW,EAAE,CAAC,cAAc,EAAE,mBAAmB,CAAC;QAClD,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,CAAC,mBAAmB,CAAC;KACnC;IACD;QACE,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,qBAAqB;QACnC,WAAW,EAAE,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;QAC9D,0EAA0E;QAC1E,6CAA6C;QAC7C,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,CAAC,yBAAyB,CAAC;KACzC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,2EAA2E;QAC3E,oEAAoE;QACpE,YAAY,EAAE,+BAA+B;QAC7C,WAAW,EAAE,CAAC,eAAe,EAAE,oBAAoB,CAAC;QACpD,OAAO,EAAE,UAAU;QACnB,sEAAsE;QACtE,WAAW,EAAE,CAAC,oBAAoB,CAAC;KACpC;IACD;QACE,oEAAoE;QACpE,wEAAwE;QACxE,yDAAyD;QACzD,IAAI,EAAE,MAAM;QACZ,YAAY,EAAE,0CAA0C;QACxD,WAAW,EAAE,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;QAChE,WAAW,EAAE,EAAE;KAChB;CACF,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,uBAAuB,EAAE,CAAC;QACzC,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS;YAAE,SAAS;QACvC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACnC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/capability/review-catch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-catch.d.ts","sourceRoot":"","sources":["../../src/capability/review-catch.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,4EAA4E;IAC5E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,qBAAqB,CA+C9F"}
+{"version":3,"file":"review-catch.d.ts","sourceRoot":"","sources":["../../src/capability/review-catch.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,4EAA4E;IAC5E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,qBAAqB,CA+C9F"}

package/dist/capability/review-catch.js

@@ -8,14 +8,18 @@
 // `bot-review-parser` disposition read is the CLI-side adapter, a follow-on); core stays
 // network/LLM-free. No LLM-judge — the resolution is a deterministic disposition read
 // (resolutionSource `disposition-thread`), so FM-b holds.
+import { botReviewerActorIds } from '../bot-identity.js';
 import { CapabilityClaimSchema, CapabilityResolutionSchema, deriveClaimId, } from './schema.js';
 const REVIEW_CATCH_CLAIM_KIND = 'review-finding';
-/** The three active paid review bots → their stable actor-id, keyed by EXACT login. */
-const REVIEW_BOT_ACTOR_IDS = {
-    'coderabbitai[bot]': 'coderabbit',
-    'gemini-code-assist[bot]': 'gemini-code-assist',
-    'greptile-apps[bot]': 'greptile',
-};
+/**
+ * The three active paid review bots → their stable actor-id, keyed by EXACT
+ * login. Derived from the ONE bot-identity definition in `../bot-identity.ts`
+ * (mmnto-ai/totem#2800): this module declares no list of its own, so a login
+ * that drifts is fixed in one place. `github-code-quality[bot]` is recognized
+ * there but carries no `actorId`, so it is deliberately absent from this map
+ * and still resolves to its own trimmed login below.
+ */
+const REVIEW_BOT_ACTOR_IDS = botReviewerActorIds();
 /**
  * Resolve a GitHub author login to a stable Layer-B actor-id, COUPLING to existing
  * actors rather than minting a parallel scheme (#697 fold 5, corrected c.4755848293).

package/dist/capability/review-catch.js.map

@@ -1 +1 @@
-{"version":3,"file":"review-catch.js","sourceRoot":"","sources":["../../src/capability/review-catch.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,uFAAuF;AACvF,oFAAoF;AACpF,uFAAuF;AACvF,oFAAoF;AACpF,oFAAoF;AACpF,yFAAyF;AACzF,sFAAsF;AACtF,0DAA0D;AAE1D,OAAO,EAEL,qBAAqB,EAErB,0BAA0B,EAC1B,aAAa,GACd,MAAM,aAAa,CAAC;AA2BrB,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAOjD,uFAAuF;AACvF,MAAM,oBAAoB,GAAqC;IAC7D,mBAAmB,EAAE,YAAY;IACjC,yBAAyB,EAAE,oBAAoB;IAC/C,oBAAoB,EAAE,UAAU;CACjC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,mFAAmF;QACnF,mDAAmD;QACnD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,wFAAwF;IACxF,uFAAuF;IACvF,sFAAsF;IACtF,OAAO,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAuC;IACrE,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,qBAAqB,CAAC,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,uBAAuB;YAClC,aAAa,EAAE,CAAC,CAAC,KAAK;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CACT,qBAAqB,CAAC,KAAK,CAAC;YAC1B,OAAO;YACP,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,uBAAuB;YAClC,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;YACpD,SAAS;YACT,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACjE,WAAW,CAAC,IAAI,CACd,0BAA0B,CAAC,KAAK,CAAC;gBAC/B,YAAY,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE;gBACrC,OAAO;gBACP,OAAO,EAAE,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBAC3D,+EAA+E;gBAC/E,gBAAgB,EAAE,oBAAoB;gBACtC,+EAA+E;gBAC/E,yEAAyE;gBACzE,WAAW,EAAE,CAAC,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,SAAS;gBAC1D,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,UAAU;aACjD,CAAC,CACH,CAAC;QACJ,CAAC;QACD,sFAAsF;IACxF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"review-catch.js","sourceRoot":"","sources":["../../src/capability/review-catch.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,uFAAuF;AACvF,oFAAoF;AACpF,uFAAuF;AACvF,oFAAoF;AACpF,oFAAoF;AACpF,yFAAyF;AACzF,sFAAsF;AACtF,0DAA0D;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEL,qBAAqB,EAErB,0BAA0B,EAC1B,aAAa,GACd,MAAM,aAAa,CAAC;AA2BrB,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAOjD;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAqC,mBAAmB,EAAE,CAAC;AAErF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,mFAAmF;QACnF,mDAAmD;QACnD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,wFAAwF;IACxF,uFAAuF;IACvF,sFAAsF;IACtF,OAAO,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAuC;IACrE,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,qBAAqB,CAAC,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,uBAAuB;YAClC,aAAa,EAAE,CAAC,CAAC,KAAK;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CACT,qBAAqB,CAAC,KAAK,CAAC;YAC1B,OAAO;YACP,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,uBAAuB;YAClC,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;YACpD,SAAS;YACT,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACjE,WAAW,CAAC,IAAI,CACd,0BAA0B,CAAC,KAAK,CAAC;gBAC/B,YAAY,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE;gBACrC,OAAO;gBACP,OAAO,EAAE,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBAC3D,+EAA+E;gBAC/E,gBAAgB,EAAE,oBAAoB;gBACtC,+EAA+E;gBAC/E,yEAAyE;gBACzE,WAAW,EAAE,CAAC,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,SAAS;gBAC1D,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,UAAU;aACjD,CAAC,CACH,CAAC;QACJ,CAAC;QACD,sFAAsF;IACxF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC"}

package/dist/gate-engine.d.ts

@@ -1,4 +1,4 @@
-import type { GateMatcher, GateVerdict } from './gate-types.js';
+import type { GateContext, GateMatcher, GateVerdict } from './gate-types.js';
 export declare const FREEZE_CHECK_EVENT = "freeze-check";
 /** The known gate event types — for error messages and host discovery. */
 export declare function knownGateEvents(): string[];
@@ -16,6 +16,12 @@ export declare function gateMatcher(event: string): GateMatcher;
  * Evaluate a gate. Pure with respect to state: reads deterministic sources,
  * never mutates. Throws (fail-loud) on an unknown event or an unparseable
  * source — it never default-allows.
+ *
+ * `context` (mmnto-ai/totem#2800) carries the per-evaluation seams a gate may
+ * read: the enforcement tier for ITS OWN unevaluable class, the injected `gh`
+ * runner, the environment, and the stderr sink. A gate that reads none of them
+ * — `freeze-check`, `transport-shield` — is unaffected by what it carries, so
+ * a tier can never soften them.
  */
-export declare function evaluateGate(event: string, payload: unknown, totemDir: string): GateVerdict;
+export declare function evaluateGate(event: string, payload: unknown, totemDir: string, context?: GateContext): GateVerdict;
 //# sourceMappingURL=gate-engine.d.ts.map

package/dist/gate-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate-engine.d.ts","sourceRoot":"","sources":["../src/gate-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAiC,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/F,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AA8EjD,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,IAAI,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAEnF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAUtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAU3F"}
+{"version":3,"file":"gate-engine.d.ts","sourceRoot":"","sources":["../src/gate-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EAGX,WAAW,EACX,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAIzB,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AA+EjD,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,IAAI,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAEnF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAUtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,WAAW,CAUb"}

package/dist/gate-engine.js

@@ -1,6 +1,7 @@
 import * as path from 'node:path';
 import { TotemError } from './errors.js';
 import { FREEZE_FILE, readFreezeConfig } from './freeze.js';
+import { MERGE_READY_EVENT, mergeReadyEvaluator } from './merge-ready.js';
 import { TRANSPORT_SHIELD_EVENT, transportShieldEvaluator } from './transport-shield.js';
 export const FREEZE_CHECK_EVENT = 'freeze-check';
 /**
@@ -65,6 +66,7 @@ const freezeCheckEvaluator = (payload, totemDir) => {
 const REGISTRY = new Map([
     [FREEZE_CHECK_EVENT, { evaluator: freezeCheckEvaluator, matcher: 'Write|Edit' }],
     [TRANSPORT_SHIELD_EVENT, { evaluator: transportShieldEvaluator, matcher: 'Bash|PowerShell' }],
+    [MERGE_READY_EVENT, { evaluator: mergeReadyEvaluator, matcher: 'Bash|PowerShell' }],
 ]);
 /** The known gate event types — for error messages and host discovery. */
 export function knownGateEvents() {
@@ -89,12 +91,18 @@ export function gateMatcher(event) {
  * Evaluate a gate. Pure with respect to state: reads deterministic sources,
  * never mutates. Throws (fail-loud) on an unknown event or an unparseable
  * source — it never default-allows.
+ *
+ * `context` (mmnto-ai/totem#2800) carries the per-evaluation seams a gate may
+ * read: the enforcement tier for ITS OWN unevaluable class, the injected `gh`
+ * runner, the environment, and the stderr sink. A gate that reads none of them
+ * — `freeze-check`, `transport-shield` — is unaffected by what it carries, so
+ * a tier can never soften them.
  */
-export function evaluateGate(event, payload, totemDir) {
+export function evaluateGate(event, payload, totemDir, context) {
     const def = REGISTRY.get(event);
     if (!def) {
         throw new TotemError('GATE_INVALID', `Unknown gate event "${event}". Known events: ${knownGateEvents().join(', ')}.`, 'Use one of the known --event values.');
     }
-    return def.evaluator(payload, totemDir);
+    return def.evaluator(payload, totemDir, context);
 }
 //# sourceMappingURL=gate-engine.js.map

package/dist/gate-engine.js.map

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

package/dist/gate-engine.test.js

@@ -3,7 +3,7 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { TotemConfigError } from './errors.js';
-import { evaluateGate, knownGateEvents } from './gate-engine.js';
+import { evaluateGate, gateMatcher, knownGateEvents } from './gate-engine.js';
 let tmpRoot;
 let totemDir;
 function writeFreeze(content) {
@@ -105,4 +105,115 @@ describe('evaluateGate — dispatch', () => {
         expect(knownGateEvents()).toContain('freeze-check');
     });
 });
+// ─── merge-ready through the registry (mmnto-ai/totem#2800) ──────────────
+//
+// The evaluator's own predicate matrix lives in merge-ready.test.ts; what is
+// locked HERE is what the registry owes: the event is dispatchable under its own
+// matcher, the gh seam and the tier ride in on the context, and the ADR-109
+// side-effect fixture extends to this event (a verdict that mutates on-disk
+// state falsifies the ADR).
+/** A runner that answers `gh --version` and then one canned, minimal PR page. */
+function ghRunnerStub(mergeStateStatus) {
+    const pr = {
+        number: 4242,
+        isDraft: false,
+        mergeStateStatus,
+        headRefOid: 'a'.repeat(40),
+        headRefName: 'feat/x',
+        baseRefName: 'main',
+        commits: {
+            nodes: [
+                {
+                    commit: {
+                        oid: 'a'.repeat(40),
+                        statusCheckRollup: {
+                            state: 'SUCCESS',
+                            contexts: {
+                                totalCount: 1,
+                                pageInfo: { hasNextPage: false, endCursor: null },
+                                nodes: [
+                                    {
+                                        __typename: 'CheckRun',
+                                        name: 'CI',
+                                        status: 'COMPLETED',
+                                        conclusion: 'SUCCESS',
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                },
+            ],
+        },
+        reviews: { pageInfo: { hasNextPage: false, endCursor: null }, nodes: [] },
+        reviewThreads: { pageInfo: { hasNextPage: false, endCursor: null }, nodes: [] },
+    };
+    return (args) => args[0] === '--version'
+        ? { stdout: 'gh version 2.99.0 (2026-09-01)', exitCode: 0 }
+        : { stdout: JSON.stringify({ data: { repository: { pullRequest: pr } } }), exitCode: 0 };
+}
+const MERGE_READY_PAYLOAD = { repo: 'mmnto-ai/totem', pr: 4242 };
+describe('evaluateGate — merge-ready', () => {
+    it('is a known gate under the Bash|PowerShell matcher', () => {
+        expect(knownGateEvents()).toContain('merge-ready');
+        expect(gateMatcher('merge-ready')).toBe('Bash|PowerShell');
+    });
+    it('dispatches with the injected gh runner and returns an ADR-109 verdict', () => {
+        const v = evaluateGate('merge-ready', MERGE_READY_PAYLOAD, totemDir, {
+            ghRunner: ghRunnerStub('CLEAN'),
+            env: {},
+            writeStderr: () => { },
+        });
+        expect(v.disposition).toBe('allow');
+        expect(v.reason).toMatch(/merge-ready floor/i);
+        expect(v.provenance.checkedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('reads the tier from the context for its own UNEVALUABLE class only', () => {
+        const strict = evaluateGate('merge-ready', MERGE_READY_PAYLOAD, totemDir, {
+            ghRunner: ghRunnerStub('UNKNOWN'),
+            env: {},
+            writeStderr: () => { },
+        });
+        expect(strict.disposition).toBe('deny');
+        const pilot = evaluateGate('merge-ready', MERGE_READY_PAYLOAD, totemDir, {
+            tier: 'pilot',
+            ghRunner: ghRunnerStub('UNKNOWN'),
+            env: {},
+            writeStderr: () => { },
+        });
+        expect(pilot.disposition).toBe('warn');
+    });
+    it('leaves freeze-check failing closed at EVERY tier (the tier is per gate)', () => {
+        writeFreeze('{ not valid json');
+        expect(() => evaluateGate('freeze-check', { subsystem: 'rule-compilation' }, totemDir, {
+            tier: 'pilot',
+        })).toThrow(TotemConfigError);
+        writeFreeze(FROZEN);
+        const denied = evaluateGate('freeze-check', { subsystem: 'rule-compilation' }, totemDir, {
+            tier: 'pilot',
+        });
+        expect(denied.disposition).toBe('deny'); // never downgraded to `warn`
+    });
+    it('throws on a malformed payload — never default-allow', () => {
+        expect(() => evaluateGate('merge-ready', { repo: '', pr: null }, totemDir, {
+            ghRunner: ghRunnerStub('CLEAN'),
+            env: {},
+            writeStderr: () => { },
+        })).toThrow(/merge-ready payload is invalid/);
+    });
+    it('is side-effect-free — never writes or mutates state (ADR-109 fixture, extended)', () => {
+        writeFreeze(FROZEN);
+        const before = fs.readFileSync(path.join(totemDir, 'freeze.json'), 'utf-8');
+        const entriesBefore = fs.readdirSync(totemDir).sort();
+        const rootBefore = fs.readdirSync(tmpRoot).sort();
+        evaluateGate('merge-ready', MERGE_READY_PAYLOAD, totemDir, {
+            ghRunner: ghRunnerStub('CLEAN'),
+            env: {},
+            writeStderr: () => { },
+        });
+        expect(fs.readFileSync(path.join(totemDir, 'freeze.json'), 'utf-8')).toBe(before);
+        expect(fs.readdirSync(totemDir).sort()).toEqual(entriesBefore);
+        expect(fs.readdirSync(tmpRoot).sort()).toEqual(rootBefore); // no cache, no ledger, no stamp
+    });
+});
 //# sourceMappingURL=gate-engine.test.js.map

package/dist/gate-engine.test.js.map

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

package/dist/gate-types.d.ts

@@ -26,6 +26,14 @@ export interface GateProvenance {
     matched: string | null;
     /** ISO-8601 timestamp of when the check ran. */
     checkedAt: string;
+    /**
+     * Optional gate-specific evidence, emitted with the verdict and never stored
+     * (mmnto-ai/totem#2800): merge-ready carries its head sha, check counts,
+     * thread counts, `changesRequestedBy`, `highInline`, `mergeStateStatus` and
+     * `evaluatedBy` here. Hosts treat it as opaque passthrough — the wrapper
+     * prints it and branches ONLY on `disposition`.
+     */
+    detail?: Readonly<Record<string, unknown>>;
 }
 export interface GateVerdict {
     disposition: GateDisposition;
@@ -34,12 +42,44 @@ export interface GateVerdict {
     /** What deterministic source + value backs this verdict. Every verdict carries provenance. */
     provenance: GateProvenance;
 }
+/**
+ * Enforcement tier for the UNEVALUABLE class, PER GATE (mmnto-ai/totem#2800 R1).
+ * A gate whose predicate INPUT could not be derived returns `warn` under
+ * `pilot` and `deny` under `strict` — and only where its own charter says so:
+ * `freeze-check` fails closed at every tier (a corrupt freeze file is never a
+ * pilot warning). A tier NEVER softens a predicate that actually failed; the
+ * host's tier map owns that.
+ */
+export type GateTier = 'strict' | 'pilot';
+/**
+ * The injected `gh` seam (mmnto-ai/totem#2800 R3): run `gh` with an argv —
+ * never a shell string — and report what it wrote and how it exited.
+ * Production spawns; tests hand back checked-in captures.
+ */
+export type GhRunner = (args: string[]) => {
+    stdout: string;
+    exitCode: number;
+};
+/**
+ * Per-evaluation context. Every field is optional and defaulted, so a gate that
+ * reads none of it keeps the two-argument call shape.
+ */
+export interface GateContext {
+    /** Tier for the UNEVALUABLE class (default `strict`); consulted per gate. */
+    tier?: GateTier;
+    /** The `gh` seam for gates that read GitHub (default: spawn the real `gh`). */
+    ghRunner?: GhRunner;
+    /** Environment a gate reads its documented env keys from (default `process.env`). */
+    env?: NodeJS.ProcessEnv;
+    /** Sink for a gate's agent-facing stderr lines (default `process.stderr.write`). */
+    writeStderr?: (line: string) => void;
+}
 /**
  * A gate evaluator may READ a deterministic source (freeze.json, a hash cache, a
  * GH query) but MUST NOT mutate any state. It returns a verdict, or throws
  * (fail-loud) on an unparseable source — it never default-allows.
  */
-export type GateEvaluator = (payload: unknown, totemDir: string) => GateVerdict;
+export type GateEvaluator = (payload: unknown, totemDir: string, context?: GateContext) => GateVerdict;
 /**
  * The PreToolUse tool matcher a gate installs under (mmnto-ai/totem#2799).
  * Carried by the core registry so the installer never guesses: a gate over

package/dist/gate-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate-types.d.ts","sourceRoot":"","sources":["../src/gate-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,iGAAiG;IACjG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,eAAe,CAAC;IAC7B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAE3D,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"gate-types.d.ts","sourceRoot":"","sources":["../src/gate-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,iGAAiG;IACjG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,eAAe,CAAC;IAC7B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,KAClB,WAAW,CAAC;AAEjB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAE3D,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/index.d.ts

@@ -30,7 +30,11 @@ export { writeFileAtomicSync } from './fs-atomic.js';
 export type { ActiveFreeze, CohortFreezeResult, CohortFreezeStatus, EffectiveFreezeResult, FreezeConfig, FreezeEntry, FreezeScope, LocalFreezeStatus, } from './freeze.js';
 export { FREEZE_FILE, FreezeScopeSchema, readCohortFreezes, readEffectiveFreezes, readFreezeConfig, RULE_COMPILATION_FREEZE_ID, } from './freeze.js';
 export { evaluateGate, FREEZE_CHECK_EVENT, gateMatcher, knownGateEvents, knownGates, } from './gate-engine.js';
-export type { GateDefinition, GateDisposition, GateEvaluator, GateMatcher, GateProvenance, GateVerdict, } from './gate-types.js';
+export type { GateContext, GateDefinition, GateDisposition, GateEvaluator, GateMatcher, GateProvenance, GateTier, GateVerdict, GhRunner, } from './gate-types.js';
+export type { BotReviewerIdentity, BotReviewerTool } from './bot-identity.js';
+export { BOT_REVIEWER_IDENTITIES, botReviewerActorIds, detectBotReviewer, isBotReviewerLogin, isBotReviewerLoginExact, } from './bot-identity.js';
+export type { MergeReadyEvaluation, MergeReadyOptions, MergeReadyPayload, MergeReadyPredicate, MergeReadyProvenanceDetail, } from './merge-ready.js';
+export { evaluateMergeReady, hasHighSeverityMarker, makeGhRunner, MERGE_READY_BRANCH_QUERY, MERGE_READY_EVENT, MERGE_READY_EVIDENCE_MAX, MERGE_READY_NOTICE_PREFIX, MERGE_READY_OVERRIDE_ENV, MERGE_READY_QUERY, MERGE_READY_SOURCE, mergeReadyEvaluator, parseMergeReadyPayload, } from './merge-ready.js';
 export type { TransportPattern, TransportPatternId, TransportShieldPayload, TransportTool, } from './transport-shield.js';
 export { HEREDOC_OVERSIZE_BYTES, MATCHED_FRAGMENT_MAX, parseTransportShieldPayload, TRANSPORT_PATTERNS, TRANSPORT_SHIELD_EVENT, TRANSPORT_SHIELD_SOURCE, transportShieldEvaluator, } from './transport-shield.js';
 export type { ChunkStrategy, ConfigTier, ContentType, DocTarget, DoctorConfig, EclConfig, EmbeddingProvider, GarbageCollectionConfig, IngestTarget, Orchestrator, OrientConfig, TotemConfig, } from './config-schema.js';
@@ -149,7 +153,7 @@ export type { SafeExecOptions } from './sys/exec.js';
 export { describeSafeExecError, safeExec } from './sys/exec.js';
 export { _clearBashResolverCacheForTesting, bashSpawnEnv, resolveBash, } from './sys/bash-resolver.js';
 export type { GitBranchDiffResult } from './sys/git.js';
-export { extractChangedFiles, filterDiffByPatterns, findRepoRootSync, findTotemRepoRootSync, getDefaultBranch, getGitBranch, getGitBranchDiff, getGitBranchDiffResult, getGitDiff, getGitDiffRange, getGitDiffStat, getGitLogSince, getGitStatus, getLatestTag, getTagDate, inferScopeFromFiles, isFileDirty, resolveGitRoot, resolveTotemRepoRootSync, } from './sys/git.js';
+export { envWithoutGitLocation, extractChangedFiles, filterDiffByPatterns, findRepoRootSync, findTotemRepoRootSync, getDefaultBranch, getGitBranch, getGitBranchDiff, getGitBranchDiffResult, getGitDiff, getGitDiffRange, getGitDiffStat, getGitLogSince, getGitStatus, getLatestTag, getOriginRepoName, getTagDate, inferScopeFromFiles, isFileDirty, repoNameFromRemoteUrl, resolveGitRoot, resolveTotemRepoRootSync, } from './sys/git.js';
 export { readJsonSafe } from './sys/fs.js';
 export type { GroundingSourceItem } from './artifacts/grounding.js';
 export { buildGroundingBundle, summarizeProvenance } from './artifacts/grounding.js';