@pome-sh/cli 0.10.0 → 0.11.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.10.0",
-  "git_sha": "14613c1a69d37441adc719248f0a506d7db76da9",
-  "build_time": "2026-07-28T23:09:18.070Z"
+  "version": "0.11.0",
+  "git_sha": "422d2a0705f7a51143bea6a537a0dc858053d635",
+  "build_time": "2026-07-29T10:15:35.517Z"
 }

package/node_modules/@pome-sh/sdk/dist/checks.d.ts

@@ -1,4 +1,7 @@
 export type CheckPolarity = "positive" | "negative";
+export declare const VACUITY_SENTINEL = "pome-vacuity-never";
+export declare const VACUITY_SENTINEL_SNAKE = "pome_vacuity_never";
+export declare const VACUITY_SENTINEL_NUMBER = 987654321;
 export type CheckSubstrateKind = "final" | "seed+final" | "tape";
 export interface CheckParamType {
     readonly name: string;
@@ -8,6 +11,7 @@ export interface CheckParamType {
     parse(raw: string): string;
 }
 export declare const repoRef: CheckParamType;
+export declare function oneOf(name: string, values: readonly string[], example?: string): CheckParamType;
 export interface CheckOutcome {
     passed: boolean;
     reason: string;

package/node_modules/@pome-sh/sdk/dist/checks.js

@@ -15,6 +15,20 @@
 // reconcile — the drift gate's job is catching a pin that fell behind, not
 // reconciling two hand-maintained vocabularies.
 import { createHash } from "node:crypto";
+// The values a `vacuityMutant` substitutes to falsify a check's scanned
+// literal. They live here, not in the consumer that probes with them, because
+// the declaration WRITES them and the probe RECOGNISES them — two copies of one
+// fact is the defect this vocabulary exists to remove, and the failure mode of a
+// skew is silent: the probe stops recognising its own mutants and every check
+// reads as un-probed.
+//
+// Three forms because a slot's type has to accept the substitution or the mutant
+// cannot re-bind, and a check that stops matching its own pattern evaluates to
+// `unmatched`, which reads as "the verdict moved" and blesses the very criterion
+// the probe exists to catch.
+export const VACUITY_SENTINEL = "pome-vacuity-never";
+export const VACUITY_SENTINEL_SNAKE = "pome_vacuity_never";
+export const VACUITY_SENTINEL_NUMBER = 987654321;
 // `owner/name`. Deliberately narrow, and it must NOT accept a bare repo name:
 // a sentence with a malformed repo has to be reported as the corrupted
 // template instance it is, rather than quietly parsing into a lookup that then
@@ -26,6 +40,40 @@ export const repoRef = {
     render: (value) => value,
     parse: (raw) => raw,
 };
+// A slot whose value comes from a CLOSED set — an issue's `open`/`closed`, a
+// review's `APPROVED`/`CHANGES_REQUESTED`, a commit status's four states.
+//
+// F-1075. The legacy regexes spelled these inline as `(open|closed)`, which
+// worked but put the closed set somewhere no authoring surface could read. As a
+// param type the set travels with the declaration: `pome checks` prints it, the
+// picker offers it, and a value outside it is a corrupted instance rather than
+// a lookup that quietly finds nothing.
+//
+// Non-capturing on purpose — see `defineCheck`'s group assertion. The values are
+// escaped because a set member is a LITERAL, never a sub-pattern; `not merged`
+// carrying a space is fine, and a member carrying `.` must not become `any`.
+export function oneOf(name, values, example) {
+    if (values.length === 0)
+        throw new Error(`param type ${name}: oneOf needs at least one value`);
+    return {
+        name,
+        pattern: `(?:${values.map(escapeLiteral).join("|")})`,
+        example: example ?? values[0],
+        render: (value) => value,
+        parse: (raw) => raw,
+    };
+}
+// How many capture groups a param type's pattern opens on its own. Must be
+// zero: `checkPattern` wraps exactly one group per slot and every consumer reads
+// group i+1 as slot i, so a type that smuggles in its own group shifts every
+// later slot by one and silently hands each predicate its neighbour's argument.
+//
+// The `|` trick: appending an empty alternative makes the pattern match "" no
+// matter what it is, so the result array is always non-null and its length is
+// 1 + the group count.
+function captureGroupCount(source) {
+    return new RegExp(`${source}|`).exec("").length - 1;
+}
 const SLOT_RE = /\{([a-z][a-z0-9_]*)\}/g;
 // Splits "a {x} b" into { literals: ["a ", " b"], params: ["x"] }.
 // `literals.length` is always `params.length + 1`, which is what lets the
@@ -73,6 +121,18 @@ export function defineCheck(def) {
             throw new Error(`check ${def.id}: param \`${name}\` example ${JSON.stringify(paramType.example)} ` +
                 `does not match its own pattern /${paramType.pattern}/`);
         }
+        // F-1075 — the failure this prevents is silent and total. Every consumer
+        // reads capture group i+1 as template slot i (`parseCheck` here,
+        // `argsFromMatch` in the cloud's adapter); one extra group inside a param's
+        // pattern shifts all of them, so each predicate is handed its neighbour's
+        // argument and grades a sentence nobody wrote. Cheap to assert, invisible
+        // to debug — `oneOf` is non-capturing for exactly this reason.
+        const groups = captureGroupCount(paramType.pattern);
+        if (groups > 0) {
+            throw new Error(`check ${def.id}: param \`${name}\` pattern /${paramType.pattern}/ opens ${groups} ` +
+                `capture group(s). Slot patterns must be group-free — use (?:…) — or every ` +
+                `slot after this one binds the wrong value.`);
+        }
     }
     return def;
 }

package/node_modules/@pome-sh/sdk/dist/checks.js.map

@@ -1 +1 @@
-{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,2DAA2D;AAC3D,EAAE;AACF,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAC1E,yEAAyE;AACzE,wDAAwD;AACxD,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,gDAAgD;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2BzC,8EAA8E;AAC9E,uEAAuE;AACvE,+EAA+E;AAC/E,yCAAyC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAmB;IACrC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,iCAAiC;IAC1C,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;CACpB,CAAC;AAoEF,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC,mEAAmE;AACnE,0EAA0E;AAC1E,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACvB,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAWD,2EAA2E;AAC3E,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,UAAU,WAAW,CACzB,GAAyF;IAEzF,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,8BAA8B,KAAK,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAsB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,oBAAoB,KAAK,8BAA8B,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,sBAAsB,QAAQ,gCAAgC,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IACD,6EAA6E;IAC7E,+DAA+D;IAC/D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,IAAsB,CAAC;QACzC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CACb,SAAS,GAAG,CAAC,EAAE,aAAa,IAAI,cAAc,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG;gBAChF,mCAAmC,SAAS,CAAC,OAAO,GAAG,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAqD,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAmC,EACnC,IAAW;IAEX,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAoB,CAAE,CAAC;QAC/C,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAoB,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,UAAqC;IAC3E,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,qEAAqE;IACrE,6EAA6E;IAC7E,8EAA8E;IAC9E,OAAO,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAaD,MAAM,UAAU,YAAY,CAAC,GAAsB;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAE,CAAE,CAAC,OAAO,CAAC,CAAC;AACpF,CAAC;AAED,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,yEAAyE;AACzE,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,IAAkC;IAC7D,MAAM,IAAI,GAAG,IAAI;SACd,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,uEAAuE;QACvE,+DAA+D;QAC/D,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM;KAClC,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAmC,EACnC,IAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAoB,CAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,OAAO,IAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"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"}

package/node_modules/@pome-sh/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pome-sh/sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Twin engine for Pome digital twins — defineTwin() + serve(): HTTP mounting, bearer auth, trace recorder, MCP dispatch, SQLite-backed state.",
   "private": false,
   "type": "module",

package/node_modules/@pome-sh/twin-github/dist/src/check-issues.d.ts

@@ -0,0 +1,30 @@
+import type { Check } from "./check-kind.js";
+export declare const issueExists: Check<{
+    issue: string;
+    repo: string;
+}>;
+export declare const issueStateCheck: Check<{
+    issue: string;
+    repo: string;
+    state: string;
+}>;
+export declare const issueHasLabel: Check<{
+    issue: string;
+    repo: string;
+    label: string;
+}>;
+export declare const issueExactlyOneLabel: Check<{
+    issue: string;
+    repo: string;
+    label: string;
+}>;
+export declare const issueAssignee: Check<{
+    issue: string;
+    repo: string;
+    login: string;
+}>;
+export declare const issueCommentContains: Check<{
+    needle: string;
+    issue: string;
+    repo: string;
+}>;

package/node_modules/@pome-sh/twin-github/dist/src/check-issues.js

@@ -0,0 +1,203 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// What GitHub's declared checks can assert about an ISSUE (F-1075).
+//
+// Declarations only. The grammar rules they all obey are in `checks.ts`, which
+// assembles them; how the exported tree is read is in `check-state.ts`.
+import { defineCheck, VACUITY_SENTINEL, VACUITY_SENTINEL_NUMBER } from "@pome-sh/sdk/checks";
+import { repoRef } from "@pome-sh/sdk/checks";
+import { commentNeedle, issueNumber, issueState, labelName, login, } from "./check-params.js";
+import { appliedLabelNames, resolveIssue, sameLabel } from "./check-state.js";
+export const issueExists = defineCheck({
+    id: "github.issue-exists",
+    description: "Asserts an issue with this number is present in the repository's final state. It says " +
+        "NOTHING about the issue's content, state, labels or assignee — pair it with those " +
+        "checks when they matter. Its natural use is a task whose examinee must CREATE the " +
+        "issue; asserting the existence of a seeded issue is trivially true and grades nothing.",
+    template: "Issue #{issue} exists in `{repo}`",
+    params: { issue: issueNumber, repo: repoRef },
+    substrate: "final",
+    polarity: () => "positive",
+    // A number, not a string hunted for inside free text — no redactor can
+    // delete it out from under the lookup.
+    subject: () => null,
+    // The ONE check where the issue number is the SCANNED literal rather than a
+    // selector. Everywhere else `resolveIssue` early-returns "not found" before
+    // the real comparison runs, so falsifying the number would move the verdict
+    // for a reason that never reaches the assertion. Here the lookup IS the
+    // assertion, so falsifying it is exactly right.
+    vacuityMutant: (args) => ({ ...args, issue: String(VACUITY_SENTINEL_NUMBER) }),
+    evaluate({ issue, repo }, { final }) {
+        const found = resolveIssue(final, repo, issue);
+        if ("missing" in found)
+            return { passed: false, reason: found.missing };
+        return { passed: true, reason: `issue #${issue} exists in ${repo}` };
+    },
+});
+export const issueStateCheck = defineCheck({
+    id: "github.issue-state",
+    description: "Compares the issue row's `state` column against the named state. A missing issue FAILS; " +
+        "an issue whose export carries no state at all is SKIPPED rather than judged, because " +
+        "absent is not the same as open. The `open` form is a prohibition — it asks the examinee " +
+        "NOT to close the issue — which is why polarity is read from the state word.",
+    // "is in state X", not "is X", for two reasons. It borrows the idiom the
+    // Linear tasks already use (`Issue "…" is in state In Progress`), so one
+    // reading habit spans twins. And it keeps this template's literal tail from
+    // swallowing `… is assigned to \`{login}\``: near-miss patterns open every
+    // slot to `.+?`, so `Issue #{issue} in \`{repo}\` is {state}` would resemble
+    // the assignee sentence, and a corrupted assignee would be reported as a
+    // corrupted STATE check — pointing an author at a check they never picked.
+    // The contract test asserts this directly; it is the reason this wording is
+    // not "is {state}".
+    //
+    // `github.pr-state` keeps the shorter "is {state}" deliberately: half its set
+    // (`merged`/`not merged`) is a different column from `state`, so "is in
+    // state merged" would name the wrong field.
+    template: "Issue #{issue} in `{repo}` is in state {state}",
+    params: { issue: issueNumber, repo: repoRef, state: issueState },
+    substrate: "final",
+    // Per-arg. "is closed" asks the examinee to close it; "is open" is F-915's
+    // "the agent did not close issue #1" — a prohibition wearing a state word.
+    polarity: ({ state }) => (state === "open" ? "negative" : "positive"),
+    subject: () => null,
+    // No falsifiable trigger. The state word comes from a CLOSED SET, so there is
+    // no value guaranteed to be false — every member might legitimately be true
+    // of the state. The issue number only resolves: mutating it early-returns
+    // "not found", which moves the verdict on every seed for a reason unrelated
+    // to the trigger clause. A mutant guaranteed to move is a check that measures
+    // nothing, so this admits the blind spot as `no_trigger` instead of buying a
+    // false clean bill.
+    vacuityMutant: () => null,
+    evaluate({ issue, repo, state }, { final }) {
+        const found = resolveIssue(final, repo, issue);
+        if ("missing" in found)
+            return { passed: false, reason: found.missing };
+        // The issue row must carry a state to attest it; a snapshot that omitted it
+        // cannot be judged either way → safe-skip rather than false-fail.
+        if (found.found.state == null) {
+            return {
+                passed: false,
+                status: "skipped",
+                reason: `issue #${issue} has no state in state_final (state_incomplete)`,
+            };
+        }
+        const actual = found.found.state.toLowerCase();
+        return {
+            passed: actual === state,
+            reason: `issue #${issue} state is "${found.found.state}" (wanted "${state}")`,
+        };
+    },
+});
+export const issueHasLabel = defineCheck({
+    id: "github.issue-has-label",
+    description: "Asserts the label is among those APPLIED to the issue — it does not assert the issue " +
+        "carries only that one. An agent that applies the right label alongside three wrong ones " +
+        "passes this check; `github.issue-exactly-one-label` is the assertion that catches that. " +
+        "The comparison is case-insensitive, because GitHub creates label names case-insensitively " +
+        "while preserving the caller's display casing.",
+    template: "Issue #{issue} in `{repo}` has the `{label}` label applied",
+    params: { issue: issueNumber, repo: repoRef, label: labelName },
+    substrate: "final",
+    polarity: () => "positive",
+    // The label is a caller-supplied literal compared against the state tree, so
+    // a redactor that destroys it makes this check unable to fire (F-1028).
+    subject: ({ label }) => label,
+    // The label is what the scan ranges over; the issue number only resolves.
+    vacuityMutant: (args) => ({ ...args, label: VACUITY_SENTINEL }),
+    evaluate({ issue, repo, label }, { final }) {
+        const found = resolveIssue(final, repo, issue);
+        if ("missing" in found)
+            return { passed: false, reason: found.missing };
+        const applied = appliedLabelNames(found.found);
+        const passed = applied.some((name) => sameLabel(name, label));
+        return {
+            passed,
+            reason: passed
+                ? `issue #${issue} has label "${label}"`
+                : `issue #${issue} labels are [${applied.join(", ")}], missing "${label}"`,
+        };
+    },
+});
+export const issueExactlyOneLabel = defineCheck({
+    id: "github.issue-exactly-one-label",
+    description: "Asserts the issue carries EXACTLY ONE applied label and that it is this one. Strictly " +
+        "stronger than `github.issue-has-label`: it fails an agent that piles a correct label on " +
+        "top of an incorrect one, which is the defect a triage task usually exists to catch. It " +
+        "counts every applied label, not only ones a human would call a classification.",
+    template: "Issue #{issue} in `{repo}` has exactly one classification label, and it is `{label}`",
+    params: { issue: issueNumber, repo: repoRef, label: labelName },
+    substrate: "final",
+    polarity: () => "positive",
+    subject: ({ label }) => label,
+    vacuityMutant: (args) => ({ ...args, label: VACUITY_SENTINEL }),
+    evaluate({ issue, repo, label }, { final }) {
+        const found = resolveIssue(final, repo, issue);
+        if ("missing" in found)
+            return { passed: false, reason: found.missing };
+        const applied = appliedLabelNames(found.found);
+        const passed = applied.length === 1 && sameLabel(applied[0], label);
+        return {
+            passed,
+            reason: passed
+                ? `issue #${issue} has exactly one label ("${label}")`
+                : `issue #${issue} has labels [${applied.join(", ")}], expected exactly one label "${label}"`,
+        };
+    },
+});
+export const issueAssignee = defineCheck({
+    id: "github.issue-assignee",
+    description: "Asserts this login is among the issue's assignees. GitHub issues can carry several, so " +
+        "this does not assert sole ownership. It compares LOGINS exactly and case-sensitively, " +
+        "not display names — `alice` matches the collaborator `alice`, and `Alice Smith` matches " +
+        "nothing.",
+    template: "Issue #{issue} in `{repo}` is assigned to `{login}`",
+    params: { issue: issueNumber, repo: repoRef, login },
+    substrate: "final",
+    polarity: () => "positive",
+    subject: (args) => args.login,
+    vacuityMutant: (args) => ({ ...args, login: VACUITY_SENTINEL }),
+    evaluate(args, { final }) {
+        const found = resolveIssue(final, args.repo, args.issue);
+        if ("missing" in found)
+            return { passed: false, reason: found.missing };
+        const assignees = found.found.assignees ?? [];
+        const passed = assignees.includes(args.login);
+        return {
+            passed,
+            reason: passed
+                ? `issue #${args.issue} is assigned to "${args.login}"`
+                : `issue #${args.issue} assignees are [${assignees.join(", ")}], missing "${args.login}"`,
+        };
+    },
+});
+export const issueCommentContains = defineCheck({
+    id: "github.issue-comment-contains",
+    description: "Scans the bodies of every comment on the issue for this text as a SUBSTRING, " +
+        "case-sensitively. It does not assert who commented, how many did, or where in the body " +
+        "the text sits. Because the text is hunted inside free prose rather than compared to a " +
+        "field, a redaction rule that destroys it makes this check unable to fire — the engine " +
+        "skips it as `subject_redacted` rather than passing it vacuously.",
+    template: 'A comment containing "{needle}" exists on issue #{issue} in `{repo}`',
+    params: { needle: commentNeedle, issue: issueNumber, repo: repoRef },
+    substrate: "final",
+    polarity: () => "positive",
+    subject: ({ needle }) => needle,
+    // The issue RESOLVES, the needle is SCANNED within it. Falsifying the issue
+    // number instead would early-return "not found" and move the verdict for
+    // every seed, for a reason that never reaches the comment scan.
+    vacuityMutant: (args) => ({ ...args, needle: VACUITY_SENTINEL }),
+    evaluate({ needle, issue, repo }, { final }) {
+        const found = resolveIssue(final, repo, issue);
+        if ("missing" in found)
+            return { passed: false, reason: found.missing };
+        const comments = found.found.comments ?? [];
+        const passed = comments.some((comment) => (comment.body ?? "").includes(needle));
+        return {
+            passed,
+            reason: passed
+                ? `issue #${issue} has a comment containing "${needle}"`
+                : `issue #${issue} has no comment containing "${needle}" (${comments.length} comment(s) scanned)`,
+        };
+    },
+});
+//# sourceMappingURL=check-issues.js.map

package/node_modules/@pome-sh/twin-github/dist/src/check-issues.js.map

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

package/node_modules/@pome-sh/twin-github/dist/src/check-kind.d.ts

@@ -0,0 +1,3 @@
+import type { CheckDefinition } from "@pome-sh/sdk/checks";
+import type { GitHubCheckState } from "./check-state.js";
+export type Check<TArgs extends Record<string, string>> = CheckDefinition<GitHubCheckState, TArgs>;

package/node_modules/@pome-sh/twin-github/dist/src/check-kind.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// The one type every GitHub check declaration is written against (F-1075).
+//
+// It exists so `check-issues.ts`, `check-pulls.ts` and `check-repos.ts` can be
+// separate files without each re-deriving the binding between a declaration and
+// the state tree it reads — and so a declaration that forgets to name
+// `GitHubCheckState` cannot compile.
+export {};
+//# sourceMappingURL=check-kind.js.map

package/node_modules/@pome-sh/twin-github/dist/src/check-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-kind.js","sourceRoot":"","sources":["../../src/check-kind.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,2EAA2E;AAC3E,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,sEAAsE;AACtE,qCAAqC"}

package/node_modules/@pome-sh/twin-github/dist/src/check-params.d.ts

@@ -0,0 +1,12 @@
+import { type CheckParamType } from "@pome-sh/sdk/checks";
+export declare const issueNumber: CheckParamType;
+export declare const prNumber: CheckParamType;
+export declare const labelName: CheckParamType;
+export declare const login: CheckParamType;
+export declare const filePath: CheckParamType;
+export declare const commentNeedle: CheckParamType;
+export declare const statusContext: CheckParamType;
+export declare const issueState: CheckParamType;
+export declare const pullRequestState: CheckParamType;
+export declare const reviewState: CheckParamType;
+export declare const commitStatusState: CheckParamType;

package/node_modules/@pome-sh/twin-github/dist/src/check-params.js

@@ -0,0 +1,99 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// The typed slots GitHub's declared checks fill (F-1075).
+//
+// These live in the twin, not the sdk, for the same reason the declarations do:
+// the twin owns what a GitHub label name or a GitHub login may look like. The
+// sdk owns only the grammar — `oneOf`, `repoRef`, and the generator.
+//
+// Every pattern here is NARROW on purpose. A slot type is what turns "the
+// author typed something wrong" into a corrupted instance reported by name,
+// instead of a lookup that quietly finds nothing and fails for an unrelated
+// reason. Widening one to make a sentence bind is almost always the wrong
+// repair — the sentence should be re-rendered from the check instead.
+import { oneOf } from "@pome-sh/sdk/checks";
+// Issue and pull-request numbers. `[1-9][0-9]*` rather than `\d+`: GitHub
+// numbers entities from 1, so `#0` names nothing and `#01` is a different
+// string from the `#1` this check would re-render. Both are corrupted instances
+// worth reporting rather than lookups that silently miss.
+const entityNumber = (name) => ({
+    name,
+    pattern: "[1-9][0-9]*",
+    example: "1",
+    render: (value) => value,
+    parse: (raw) => raw,
+});
+export const issueNumber = entityNumber("issue");
+export const prNumber = entityNumber("pr");
+// Backtick-delimited in every template that uses one, so the only hard
+// exclusion is the backtick itself — a label may legitimately carry spaces,
+// slashes, colons and emoji (`good first issue`, `area/api`, `P0: urgent`).
+// Newline is excluded because a criterion is one line by construction; letting
+// it through would make a malformed multi-line sentence bind.
+export const labelName = {
+    name: "label",
+    pattern: "[^`\\n]+",
+    example: "bug",
+    render: (value) => value,
+    parse: (raw) => raw,
+};
+// A GitHub login: alphanumerics and single hyphens, never leading or trailing.
+// Narrower than `labelName` on purpose — an assignee that fails to parse is
+// almost always a display name where a login was meant, and saying so beats
+// reporting "issue #1 has no such assignee".
+export const login = {
+    name: "login",
+    pattern: "[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?",
+    example: "alice",
+    render: (value) => value,
+    parse: (raw) => raw,
+};
+export const filePath = {
+    name: "path",
+    pattern: "[^`\\n]+",
+    example: "src/index.ts",
+    render: (value) => value,
+    parse: (raw) => raw,
+};
+// Double-quote delimited in its template, so the quote is the exclusion. This
+// is the one slot whose value is SCANNED inside free text rather than compared
+// to a field, which is why its checks declare it as their `subject`.
+export const commentNeedle = {
+    name: "needle",
+    pattern: '[^"\\n]+',
+    example: "Deploy blocked",
+    render: (value) => value,
+    parse: (raw) => raw,
+};
+// A commit status's `context` — GitHub's name for the reporting check
+// ("ci/build", "codecov/patch").
+export const statusContext = {
+    name: "context",
+    pattern: '[^"\\n]+',
+    example: "ci/build",
+    render: (value) => value,
+    parse: (raw) => raw,
+};
+// ── Closed sets ──────────────────────────────────────────────────────────────
+//
+// Each of these was an inline alternation inside a legacy regex, where no
+// authoring surface could read it. As declared param types the set travels with
+// the check: `pome checks github` prints it, the picker offers it, and a value
+// outside it is reported as a corrupted instance.
+//
+// They also cost something, and it is named here rather than discovered later:
+// a closed set has NO value guaranteed to be false, so a check whose only
+// scanned slot is an enum cannot declare a vacuity mutant. See
+// `HONEST_NULL_MUTANTS` in the contract test.
+export const issueState = oneOf("state", ["open", "closed"]);
+// "not merged" first so the set reads in the order an author thinks about it;
+// the generated pattern is anchored, so ordering cannot change what binds.
+export const pullRequestState = oneOf("state", ["merged", "not merged", "open", "closed"]);
+// The API's own review states, and only those. The legacy regex also accepted
+// `REQUEST_CHANGES` (the review *event* verb) and folded it onto
+// `CHANGES_REQUESTED`, because an author typing English could reasonably reach
+// for either. Under a picked check there is nothing to fold: the author selects
+// from this set and the system writes the sentence.
+export const reviewState = oneOf("review", ["APPROVED", "CHANGES_REQUESTED", "COMMENTED"], "APPROVED");
+export const commitStatusState = oneOf("state", ["success", "failure", "pending", "error"], "success");
+//# sourceMappingURL=check-params.js.map

package/node_modules/@pome-sh/twin-github/dist/src/check-params.js.map

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

package/node_modules/@pome-sh/twin-github/dist/src/check-pulls.d.ts

@@ -0,0 +1,11 @@
+import type { Check } from "./check-kind.js";
+export declare const pullRequestStateCheck: Check<{
+    pr: string;
+    repo: string;
+    state: string;
+}>;
+export declare const pullRequestReviewExists: Check<{
+    review: string;
+    pr: string;
+    repo: string;
+}>;