@usine/orchestrator 0.2.1 → 0.4.0

package/dist/polling/loop-evaluation.js

@@ -4,25 +4,44 @@ import { AttemptTask } from "@usine/core/attempt";
 import { DedupKey } from "@usine/core/event";
 import { CommitSha, RepositoryRevision, canonicalRepositoryName } from "@usine/core/repository";
 import { RunEngine } from "@usine/engine/engine";
-import { ExpressionEngine } from "@usine/expression/expression-engine";
+import { gitHubItemKey } from "./repository-sync.js";
+import { ExpressionEngine, } from "@usine/expression/expression-engine";
 import { InvalidGitHubResponseError } from "@usine/github/github-app";
-import { DateTime, Effect, Result, Schema } from "effect";
-import { configFileErrorLogFields, DEFAULT_BRANCH_REVISION, submissionLogFields, triggerSubmission, } from "../trigger-submission.js";
-import { RepositoryPollFailure } from "./cycle.js";
+import { DateTime, Effect, Option, Result, Schema } from "effect";
+import { DEFAULT_BRANCH_REVISION, submissionLogFields, triggerSubmission, } from "../trigger-submission.js";
+import { LoopEvaluationFailure } from "./evaluation-failures.js";
 const eventKey = (loop, repository, { projection: item, cycleGeneration }) => DedupKey.make(JSON.stringify([
     loop.name,
     canonicalRepositoryName(repository.name),
     item.number,
     item.contentHash,
-    // Preserve pre-budget identities while making every reset a fresh Event
-    // with the current rendered task, Agent and authored limit.
+    // Keep pre-budget identities, and make every reset a new Event with the current rendered
+    // task, Agent, and limit.
     ...(cycleGeneration === 0 ? [] : [cycleGeneration]),
 ]));
 /**
- * Evaluates an already projected Item against its repository's active Loops,
- * renders matching prompts, and submits or revokes Runs. Prompt-render failures
- * are reported per Loop; expression and Run failures stop the repository before
- * its cursor commits. Schedule Ticks have separate evaluation semantics.
+ * Whether `loop`'s trigger `if:` matches one Item of `repository`, given the Item's payload slice.
+ */
+const evaluateTrigger = (loop, repository, payload) => Effect.gen(function* () {
+    const expressions = yield* ExpressionEngine;
+    return yield* expressions.evaluateBoolean(loop.trigger.if, environmentFor(loop.trigger.on), {
+        repo: repositoryContext(repository),
+        item: payload,
+    });
+});
+/**
+ * Whether `loop`'s trigger `if:` matches each of `payloads`, checking the expression once. Results
+ * follow the order of `payloads`, each with its own evaluation failure; a check failure fails the
+ * whole call.
+ */
+export const evaluateTriggerOnEach = (loop, repository, payloads) => Effect.gen(function* () {
+    const expressions = yield* ExpressionEngine;
+    const repo = repositoryContext(repository);
+    return yield* expressions.evaluateBooleanEach(loop.trigger.if, environmentFor(loop.trigger.on), payloads.map((item) => ({ repo, item })));
+});
+/**
+ * Evaluates a projected Item against its repository's active Loops and submits or revokes Runs.
+ * Returns `if:` and prompt failures per Loop; fails on Run errors.
  */
 export const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function* (repository, resolved, observed) {
     const { projection: item, cycleGeneration } = observed;
@@ -31,7 +50,6 @@ export const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function*
         item: item.number,
     });
     const config = yield* ConfigParser;
-    const expressions = yield* ExpressionEngine;
     const runs = yield* RunEngine;
     const loops = resolved.filter(({ loop }) => loop.trigger.on === item.source);
     const payload = item.payload;
@@ -50,15 +68,26 @@ export const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function*
         ? RepositoryRevision.make(yield* Schema.decodeUnknownEffect(CommitSha)(payload.headRefOid).pipe(Effect.mapError(() => new InvalidGitHubResponseError({
             operation: "fetch-pull-request-snapshot",
             message: "The pull request payload has no valid head commit",
-            detail: `PR ${item.number} requires a full headRefOid`,
+            detail: `pull request #${item.number} has no full headRefOid`,
         }))))
         : DEFAULT_BRANCH_REVISION;
     const failures = [];
     let revokedRuns = 0;
     for (const { agent, loop, parentModel } of loops) {
         yield* Effect.annotateCurrentSpan({ loop: loop.name, agent: agent.name });
-        const matches = yield* expressions.evaluateBoolean(loop.trigger.if, environmentFor(loop.trigger.on), context);
-        if (!matches) {
+        const matches = yield* Effect.result(evaluateTrigger(loop, repository, payload));
+        // A failed `if:` gives no answer about the match, so the Item's queued Runs stay as they are.
+        if (Result.isFailure(matches)) {
+            failures.push(new LoopEvaluationFailure({
+                loop: loop.name,
+                stage: "if",
+                expression: Option.some(matches.failure.source),
+                errorTag: matches.failure._tag,
+                message: matches.failure.message,
+            }));
+            continue;
+        }
+        if (!matches.success) {
             yield* Effect.logDebug("Item did not match its loop expression", {
                 repository: repository.name,
                 loop: loop.name,
@@ -80,22 +109,12 @@ export const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function*
         }
         const dedupKey = eventKey(loop, repository, observed);
         const receivedAt = yield* DateTime.now;
-        // A render failure comes from the loop's authoring, not transport, so
-        // re-polling would fail the same way. It is scoped to this loop so the
-        // sibling loops and the cursor still advance.
         const rendered = yield* Effect.result(config.renderPrompt(loop, context));
         if (Result.isFailure(rendered)) {
-            yield* Effect.logError("Loop prompt rendering failed; sibling loops were unaffected", {
+            failures.push(new LoopEvaluationFailure({
                 loop: loop.name,
-                repository: repository.name,
-                agent: agent.name,
-                item: item.number,
-                errorTag: rendered.failure._tag,
-                message: rendered.failure.message,
-                ...configFileErrorLogFields(rendered.failure),
-            });
-            failures.push(new RepositoryPollFailure({
-                repository: repository.name,
+                stage: "prompt",
+                expression: rendered.failure.expression,
                 errorTag: rendered.failure._tag,
                 message: rendered.failure.message,
             }));
@@ -128,4 +147,28 @@ export const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function*
     }
     return { submissions, revokedRuns, failures };
 });
+/**
+ * Revokes the unstarted Runs of the deleted issue or pull request `number` for each active Loop on
+ * `stream`, and returns how many it revoked. Running Attempts continue.
+ */
+export const revokeMissingItem = Effect.fn("PollingTriggers.revokeMissingItem")(function* (repository, resolved, stream, number) {
+    yield* Effect.annotateCurrentSpan({ repository: repository.name, item: number });
+    const runs = yield* RunEngine;
+    const itemKey = gitHubItemKey(repository.name, number);
+    let revokedRuns = 0;
+    for (const { agent, loop } of resolved.filter(({ loop }) => loop.trigger.on === stream)) {
+        const revoked = yield* runs.revoke(loop.name, itemKey);
+        revokedRuns += revoked.length;
+        if (revoked.length > 0) {
+            yield* Effect.logInfo("Item is gone from GitHub; revoked its unstarted runs", {
+                repository: repository.name,
+                loop: loop.name,
+                agent: agent.name,
+                item: number,
+                runIds: revoked.join(", "),
+            });
+        }
+    }
+    return revokedRuns;
+});
 //# sourceMappingURL=loop-evaluation.js.map

package/dist/polling/loop-evaluation.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-evaluation.js","sourceRoot":"","sources":["../../src/polling/loop-evaluation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EAEvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASnD,MAAM,QAAQ,GAAG,CACf,IAAc,EACd,UAAuB,EACvB,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAgB,EACzC,EAAE,CACZ,QAAQ,CAAC,IAAI,CACX,IAAI,CAAC,SAAS,CAAC;IACb,IAAI,CAAC,IAAI;IACT,uBAAuB,CAAC,UAAU,CAAC,IAAI,CAAC;IACxC,IAAI,CAAC,MAAM;IACX,IAAI,CAAC,WAAW;IAChB,wEAAwE;IACxE,4DAA4D;IAC5D,GAAG,CAAC,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CACpD,CAAC,CACH,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,8BAA8B,CAAC,CAAC,QAAQ,CAAC,EAC7E,UAAuB,EACvB,QAAqC,EACrC,QAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,QAAQ,CAAC;IACvD,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAChC,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,IAAI,EAAE,IAAI,CAAC,MAAM;KAClB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,qDAAqD,EAAE;YAC5E,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAsB,CAAC;IAC/E,CAAC;IACD,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,kFAAkF;IAClF,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,KAAK,IAAI;QAClB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CACrB,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CACnE,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,0BAA0B,CAAC;YAC7B,SAAS,EAAE,6BAA6B;YACxC,OAAO,EAAE,mDAAmD;YAC5D,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,6BAA6B;SACvD,CAAC,CACL,CACF,CACF;QACH,CAAC,CAAC,uBAAuB,CAAC;IAC9B,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACjD,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,eAAe,CAChD,IAAI,CAAC,OAAO,CAAC,EAAE,EACf,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAC/B,OAAO,CACR,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,wCAAwC,EAAE;gBAC/D,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;aAClB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5D,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,mDAAmD,EAAE;oBACzE,UAAU,EAAE,UAAU,CAAC,IAAI;oBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC3B,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvC,sEAAsE;QACtE,uEAAuE;QACvE,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,6DAA6D,EAAE;gBACpF,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;gBACjC,GAAG,wBAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC;aAC9C,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CACX,IAAI,qBAAqB,CAAC;gBACxB,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;aAClC,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAClC,iBAAiB,CAAC;YAChB,QAAQ;YACR,eAAe;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI;YACJ,OAAO;YACP,UAAU;YACV,UAAU;YACV,QAAQ;YACR,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACxC,KAAK;YACL,WAAW;SACZ,CAAC,CACH,CAAC;QACF,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE;YACrD,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ;YACR,MAAM,EAAE,SAAS,CAAC,IAAI;YACtB,GAAG,mBAAmB,CAAC,SAAS,CAAC;SAClC,CAAC,CAAC;QACH,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAsB,CAAC;AACpE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"loop-evaluation.js","sourceRoot":"","sources":["../../src/polling/loop-evaluation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAqB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAEL,gBAAgB,GAGjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClE,OAAO,EACL,uBAAuB,EAEvB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AASjE,MAAM,QAAQ,GAAG,CACf,IAAc,EACd,UAAuB,EACvB,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAgB,EACzC,EAAE,CACZ,QAAQ,CAAC,IAAI,CACX,IAAI,CAAC,SAAS,CAAC;IACb,IAAI,CAAC,IAAI;IACT,uBAAuB,CAAC,UAAU,CAAC,IAAI,CAAC;IACxC,IAAI,CAAC,MAAM;IACX,IAAI,CAAC,WAAW;IAChB,yFAAyF;IACzF,0BAA0B;IAC1B,GAAG,CAAC,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CACpD,CAAC,CACH,CAAC;AAEJ;;GAEG;AACH,MAAM,eAAe,GAAG,CACtB,IAAc,EACd,UAAuB,EACvB,OAA0B,EACiC,EAAE,CAC7D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QAC1F,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC;QACnC,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAc,EACd,UAAuB,EACvB,QAA0C,EAK1C,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAC5C,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAC3C,IAAI,CAAC,OAAO,CAAC,EAAE,EACf,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAC/B,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CACzC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,8BAA8B,CAAC,CAAC,QAAQ,CAAC,EAC7E,UAAuB,EACvB,QAAqC,EACrC,QAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,QAAQ,CAAC;IACvD,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAChC,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,IAAI,EAAE,IAAI,CAAC,MAAM;KAClB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,qDAAqD,EAAE;YAC5E,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAsB,CAAC;IAC/E,CAAC;IACD,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,kFAAkF;IAClF,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,KAAK,IAAI;QAClB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CACrB,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CACnE,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,0BAA0B,CAAC;YAC7B,SAAS,EAAE,6BAA6B;YACxC,OAAO,EAAE,mDAAmD;YAC5D,MAAM,EAAE,iBAAiB,IAAI,CAAC,MAAM,yBAAyB;SAC9D,CAAC,CACL,CACF,CACF;QACH,CAAC,CAAC,uBAAuB,CAAC;IAC9B,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACjD,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACjF,8FAA8F;QAC9F,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CACX,IAAI,qBAAqB,CAAC;gBACxB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC/C,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;aACjC,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,wCAAwC,EAAE;gBAC/D,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;aAClB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5D,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,mDAAmD,EAAE;oBACzE,UAAU,EAAE,UAAU,CAAC,IAAI;oBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC3B,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CACX,IAAI,qBAAqB,CAAC;gBACxB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,QAAQ;gBACf,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU;gBACvC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;aAClC,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAClC,iBAAiB,CAAC;YAChB,QAAQ;YACR,eAAe;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI;YACJ,OAAO;YACP,UAAU;YACV,UAAU;YACV,QAAQ;YACR,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACxC,KAAK;YACL,WAAW;SACZ,CAAC,CACH,CAAC;QACF,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE;YACrD,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ;YACR,MAAM,EAAE,SAAS,CAAC,IAAI;YACtB,GAAG,mBAAmB,CAAC,SAAS,CAAC;SAClC,CAAC,CAAC;QACH,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAsB,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC,QAAQ,CAAC,EACvF,UAAuB,EACvB,QAAqC,EACrC,MAAsB,EACtB,MAAc;IAEd,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC9B,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;QACxF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvD,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,sDAAsD,EAAE;gBAC5E,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC,CAAC"}

package/dist/polling/open-issues.d.ts

@@ -0,0 +1,23 @@
+import type { ManagedRepo } from "@usine/config/factory";
+import { ItemProjectionReader } from "@usine/engine/item-projection";
+import { GitHubPolling } from "@usine/github/polling";
+import { DateTime, Duration, Effect, Option } from "effect";
+import type { ResolvedLoop } from "../trigger-submission.ts";
+import { RepositoryPollFailure } from "./cycle.ts";
+/** The minimum time between open issue checks of a repository. */
+export declare const OPEN_ISSUE_CHECK_INTERVAL: Duration.Duration;
+/** The result of one open issue check in a poll cycle. */
+interface OpenIssueCheck {
+    readonly revokedRuns: number;
+    readonly failures: ReadonlyArray<RepositoryPollFailure>;
+    readonly nextPollAt: Option.Option<DateTime.Utc>;
+}
+export declare const NO_OPEN_ISSUE_CHECK: OpenIssueCheck;
+/**
+ * Marks each issue stored as open in `repository` that GitHub no longer has as gone, and revokes
+ * its unstarted Runs. Reports GitHub request failures without failing the cycle; fails on
+ * persistence errors.
+ */
+export declare const checkOpenIssues: (repository: ManagedRepo, loops: readonly ResolvedLoop[]) => Effect.Effect<OpenIssueCheck, import("@usine/engine/engine").AttemptCancellationError | import("@usine/engine/engine").EnginePersistenceError | import("@usine/engine/engine").RunInterventionRejectedError | import("@usine/engine/engine").RunNotFoundError | import("@usine/engine/engine").RunOperationRejectedError | import("@usine/engine/engine").RunRetryBlockedError, GitHubPolling | ItemProjectionReader | import("@usine/engine/item-projection").ItemProjectionWriter | import("@usine/engine/engine").RunEngine>;
+export {};
+//# sourceMappingURL=open-issues.d.ts.map

package/dist/polling/open-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-issues.d.ts","sourceRoot":"","sources":["../../src/polling/open-issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAA8B,MAAM,YAAY,CAAC;AAI/E,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,mBAAuB,CAAC;AAE9D,0DAA0D;AAC1D,UAAU,cAAc;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,mBAAmB,EAAE,cAIjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,8jBA4D1B,CAAC"}

package/dist/polling/open-issues.js

@@ -0,0 +1,77 @@
+import { ItemProjectionReader } from "@usine/engine/item-projection";
+import { GitHubPolling } from "@usine/github/polling";
+import { DateTime, Duration, Effect, Option, Result } from "effect";
+import { RepositoryPollFailure, repositoryFailureLogFields } from "./cycle.js";
+import { revokeMissingItem } from "./loop-evaluation.js";
+import { markItemGone } from "./repository-sync.js";
+/** The minimum time between open issue checks of a repository. */
+export const OPEN_ISSUE_CHECK_INTERVAL = Duration.minutes(10);
+export const NO_OPEN_ISSUE_CHECK = {
+    revokedRuns: 0,
+    failures: [],
+    nextPollAt: Option.none(),
+};
+/**
+ * Marks each issue stored as open in `repository` that GitHub no longer has as gone, and revokes
+ * its unstarted Runs. Reports GitHub request failures without failing the cycle; fails on
+ * persistence errors.
+ */
+export const checkOpenIssues = Effect.fn("PollingTriggers.checkOpenIssues")(function* (repository, loops) {
+    yield* Effect.annotateCurrentSpan({ repository: repository.name });
+    const items = yield* ItemProjectionReader;
+    const github = yield* GitHubPolling;
+    const open = yield* items.openIssues(repository.name);
+    if (open.length === 0) {
+        yield* Effect.logDebug("No open issues to check against GitHub", {
+            repository: repository.name,
+        });
+        return NO_OPEN_ISSUE_CHECK;
+    }
+    const result = yield* Effect.result(github.missingIssues(repository.name, open));
+    if (Result.isFailure(result)) {
+        const error = result.failure;
+        if (error._tag === "GitHubRateLimitError") {
+            yield* Effect.logWarning("Open-issue check rate-limited; checking again in 10 minutes", {
+                repository: repository.name,
+                openIssues: open.length,
+                operation: error.operation,
+                retryAt: DateTime.formatIso(error.retryAt),
+            });
+            return { ...NO_OPEN_ISSUE_CHECK, nextPollAt: Option.some(error.retryAt) };
+        }
+        yield* Effect.logError("Open-issue check failed; checking again in 10 minutes", {
+            repository: repository.name,
+            openIssues: open.length,
+            ...repositoryFailureLogFields(error),
+        });
+        return {
+            ...NO_OPEN_ISSUE_CHECK,
+            failures: [
+                new RepositoryPollFailure({
+                    repository: repository.name,
+                    errorTag: error._tag,
+                    message: error.message,
+                }),
+            ],
+        };
+    }
+    let revokedRuns = 0;
+    for (const number of result.success) {
+        const revoked = yield* revokeMissingItem(repository, loops, "issue", number);
+        const projectionMarkedGone = yield* markItemGone(repository.name, number);
+        revokedRuns += revoked;
+        yield* Effect.logInfo("GitHub no longer has an open issue; it leaves the open lanes", {
+            repository: repository.name,
+            item: number,
+            revokedRuns: revoked,
+            projectionMarkedGone,
+        });
+    }
+    yield* Effect.logDebug("Checked open issues against GitHub", {
+        repository: repository.name,
+        openIssues: open.length,
+        missingIssues: result.success.length,
+    });
+    return { ...NO_OPEN_ISSUE_CHECK, revokedRuns };
+});
+//# sourceMappingURL=open-issues.js.map

package/dist/polling/open-issues.js.map

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

package/dist/polling/open-pull-requests.d.ts

@@ -0,0 +1,28 @@
+import { type BaseRefHead, type ChangedItem, GitHubPolling, type PayloadSnapshot } from "@usine/github/polling";
+import { Effect, Option, Schema } from "effect";
+declare const OpenPullRequest_base: Schema.Class<OpenPullRequest, Schema.Struct<{
+    readonly number: Schema.Int;
+    readonly updatedAt: Schema.DateTimeUtcFromString;
+    /** `None` in a cursor written before polling recorded base branches. */
+    readonly baseRefName: Schema.OptionFromOptionalKey<Schema.brand<Schema.NonEmptyString, "GitHubBaseRefName">>;
+    readonly mergeable: Schema.withDecodingDefaultKey<Schema.String, never>;
+    /** Older cursors refresh once to learn whether checks have settled. */
+    readonly checksUnsettled: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+}>, {}>;
+/** An open pull request's last observed base branch, mergeability, and check refresh state. */
+export declare class OpenPullRequest extends OpenPullRequest_base {
+}
+/** Returns the cursor entry for a fetched Item, or `None` unless the Item is an open pull request. */
+export declare const openPullRequest: (item: ChangedItem, snapshot: PayloadSnapshot) => Option.Option<OpenPullRequest>;
+/**
+ * Reads the head of each base branch that `openPullRequests` target, with one conditional request
+ * per branch, and returns the pull requests to fetch again: those whose base branch isn't recorded,
+ * moved, or couldn't be read, and those whose mergeability or checks are unsettled. Leaves out the
+ * numbers in `fetched`, which the poll fetches anyway. Fails only if GitHub rate-limits a read.
+ */
+export declare const openPullRequestRefresh: (repository: string & import("effect/Brand").Brand<"RepositoryName">, openPullRequests: readonly OpenPullRequest[], recordedHeads: readonly BaseRefHead[], fetched: ReadonlySet<number>) => Effect.Effect<{
+    refreshed: OpenPullRequest[];
+    baseRefHeads: BaseRefHead[];
+}, import("@usine/github/github-app").GitHubRateLimitError, GitHubPolling>;
+export {};
+//# sourceMappingURL=open-pull-requests.d.ts.map

package/dist/polling/open-pull-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-pull-requests.d.ts","sourceRoot":"","sources":["../../src/polling/open-pull-requests.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,WAAW,EAEhB,aAAa,EACb,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAgB,MAAM,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;IAWpE,wEAAwE;;;IAGxE,uEAAuE;;;AATzE,+FAA+F;AAC/F,qBAAa,eAAgB,SAAQ,oBAUnC;CAAG;AAEL,sGAAsG;AACtG,eAAO,MAAM,eAAe,SACpB,WAAW,YACP,eAAe,KACxB,MAAM,CAAC,MAAM,CAAC,eAAe,CAeb,CAAC;AAmFpB;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;0EAmElC,CAAC"}

package/dist/polling/open-pull-requests.js

@@ -0,0 +1,131 @@
+import { BaseRefName, ChangedPullRequest, GitHubPolling, } from "@usine/github/polling";
+import { Array as Arr, Effect, Option, Result, Schema } from "effect";
+import { repositoryFailureLogFields } from "./cycle.js";
+const BASE_REF_CONCURRENCY = 4;
+/** An open pull request's last observed base branch, mergeability, and check refresh state. */
+export class OpenPullRequest extends Schema.Class("@usine/orchestrator/OpenPullRequest")({
+    number: ChangedPullRequest.fields.number,
+    updatedAt: Schema.DateTimeUtcFromString,
+    /** `None` in a cursor written before polling recorded base branches. */
+    baseRefName: Schema.OptionFromOptionalKey(BaseRefName),
+    mergeable: Schema.String.pipe(Schema.withDecodingDefaultKey(Effect.succeed("UNKNOWN"))),
+    /** Older cursors refresh once to learn whether checks have settled. */
+    checksUnsettled: Schema.Boolean.pipe(Schema.withDecodingDefaultKey(Effect.succeed(true))),
+}) {
+}
+/** Returns the cursor entry for a fetched Item, or `None` unless the Item is an open pull request. */
+export const openPullRequest = (item, snapshot) => snapshot._tag === "PullRequestSnapshot" && snapshot.payload.state === "OPEN"
+    ? Option.some(new OpenPullRequest({
+        number: item.number,
+        updatedAt: item.updatedAt,
+        baseRefName: Option.some(snapshot.payload.baseRefName),
+        mergeable: snapshot.payload.mergeable,
+        checksUnsettled: snapshot.payload.statusCheckRollup?.state === "PENDING" ||
+            snapshot.payload.statusCheckRollup?.state === "EXPECTED" ||
+            (snapshot.payload.statusCheckRollup === null &&
+                snapshot.payload.mergeStateStatus === "BLOCKED"),
+    }))
+    : Option.none();
+const readBaseRef = Effect.fn("PollingTriggers.readBaseRef")(function* (repository, baseRefName, recorded, pullRequests) {
+    yield* Effect.annotateCurrentSpan({ repository, baseRefName });
+    const github = yield* GitHubPolling;
+    const result = yield* Effect.result(github.baseRefHead(repository, baseRefName, recorded));
+    if (Result.isFailure(result)) {
+        const error = result.failure;
+        // A rate limit interrupts the repository cycle, as for every other request, so the poll backs off.
+        if (error._tag === "GitHubRateLimitError")
+            return yield* error;
+        yield* Effect.logWarning("Could not read the base branch head; refreshing its open pull requests in this poll", {
+            repository,
+            baseRefName,
+            pullRequests: pullRequests.join(", "),
+            ...repositoryFailureLogFields(error),
+        });
+        return { _tag: "Unreadable", recorded };
+    }
+    const head = result.success;
+    if (Option.isNone(recorded)) {
+        yield* Effect.logInfo("Base branch head recorded; refreshing its open pull requests once", {
+            repository,
+            baseRefName,
+            head: head.sha,
+            pullRequests: pullRequests.join(", "),
+        });
+        return { _tag: "Moved", head };
+    }
+    if (recorded.value.sha !== head.sha) {
+        yield* Effect.logInfo("Base branch head moved; refreshing its open pull requests", {
+            repository,
+            baseRefName,
+            previousHead: recorded.value.sha,
+            head: head.sha,
+            pullRequests: pullRequests.join(", "),
+        });
+        return { _tag: "Moved", head };
+    }
+    return { _tag: "Unchanged", head };
+});
+const refreshReason = (pullRequest, reads) => {
+    if (Option.isNone(pullRequest.baseRefName))
+        return Option.some("baseUnrecorded");
+    const read = reads.get(pullRequest.baseRefName.value);
+    if (read?._tag === "Moved")
+        return Option.some("baseMoved");
+    if (read?._tag === "Unreadable")
+        return Option.some("baseUnreadable");
+    if (pullRequest.mergeable === "UNKNOWN")
+        return Option.some("mergeableUnknown");
+    if (pullRequest.checksUnsettled)
+        return Option.some("checksUnsettled");
+    return Option.none();
+};
+/**
+ * Reads the head of each base branch that `openPullRequests` target, with one conditional request
+ * per branch, and returns the pull requests to fetch again: those whose base branch isn't recorded,
+ * moved, or couldn't be read, and those whose mergeability or checks are unsettled. Leaves out the
+ * numbers in `fetched`, which the poll fetches anyway. Fails only if GitHub rate-limits a read.
+ */
+export const openPullRequestRefresh = Effect.fn("PollingTriggers.openPullRequestRefresh")(function* (repository, openPullRequests, recordedHeads, fetched) {
+    yield* Effect.annotateCurrentSpan({ repository });
+    if (openPullRequests.length === 0) {
+        return { refreshed: [], baseRefHeads: [] };
+    }
+    const byBaseRef = new Map();
+    for (const { number, baseRefName } of openPullRequests) {
+        if (Option.isNone(baseRefName))
+            continue;
+        const numbers = byBaseRef.get(baseRefName.value) ?? [];
+        numbers.push(number);
+        byBaseRef.set(baseRefName.value, numbers);
+    }
+    const reads = new Map(yield* Effect.forEach(byBaseRef, ([baseRefName, pullRequests]) => readBaseRef(repository, baseRefName, Option.fromNullishOr(recordedHeads.find((head) => head.baseRefName === baseRefName)), pullRequests).pipe(Effect.map((read) => [baseRefName, read])), { concurrency: BASE_REF_CONCURRENCY }));
+    const notFetched = openPullRequests.filter(({ number }) => !fetched.has(number));
+    const refreshed = notFetched.flatMap((pullRequest) => Option.toArray(Option.map(refreshReason(pullRequest, reads), (reason) => ({ pullRequest, reason }))));
+    if (refreshed.length === 0) {
+        yield* Effect.logDebug("No open pull request needs a refresh", {
+            repository,
+            openPullRequests: openPullRequests.length,
+            baseRefReads: reads.size,
+        });
+    }
+    else {
+        const reasons = Arr.groupBy(refreshed, ({ reason }) => reason);
+        yield* Effect.logInfo("Refreshing open pull requests", {
+            repository,
+            baseRefReads: reads.size,
+            refreshed: refreshed.length,
+            skipped: notFetched.length - refreshed.length,
+            ...Object.fromEntries(Object.entries(reasons).map(([reason, entries]) => [
+                reason,
+                entries.map(({ pullRequest }) => pullRequest.number).join(", "),
+            ])),
+        });
+    }
+    return {
+        refreshed: refreshed.map(({ pullRequest }) => pullRequest),
+        baseRefHeads: [...reads.values()]
+            .flatMap((read) => read._tag === "Unreadable" ? Option.toArray(read.recorded) : [read.head])
+            .sort((left, right) => left.baseRefName.localeCompare(right.baseRefName)),
+    };
+});
+//# sourceMappingURL=open-pull-requests.js.map

package/dist/polling/open-pull-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-pull-requests.js","sourceRoot":"","sources":["../../src/polling/open-pull-requests.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAEX,kBAAkB,EAClB,aAAa,GAEd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,IAAI,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,+FAA+F;AAC/F,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,KAAK,CAC/C,qCAAqC,CACtC,CAAC;IACA,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM;IACxC,SAAS,EAAE,MAAM,CAAC,qBAAqB;IACvC,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC,qBAAqB,CAAC,WAAW,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACvF,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAC1F,CAAC;CAAG;AAEL,sGAAsG;AACtG,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAiB,EACjB,QAAyB,EACO,EAAE,CAClC,QAAQ,CAAC,IAAI,KAAK,qBAAqB,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM;IAC1E,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,IAAI,eAAe,CAAC;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;QACtD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS;QACrC,eAAe,EACb,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,KAAK,SAAS;YACvD,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,KAAK,UAAU;YACxD,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,KAAK,IAAI;gBAC1C,QAAQ,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC;KACrD,CAAC,CACH;IACH,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAuBpB,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,QAAQ,CAAC,EACpE,UAA0B,EAC1B,WAAwB,EACxB,QAAoC,EACpC,YAAmC;IAEnC,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3F,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7B,mGAAmG;QACnG,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;YAAE,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC;QAC/D,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CACtB,qFAAqF,EACrF;YACE,UAAU;YACV,WAAW;YACX,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YACrC,GAAG,0BAA0B,CAAC,KAAK,CAAC;SACrC,CACF,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAwB,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,mEAAmE,EAAE;YACzF,UAAU;YACV,WAAW;YACX,IAAI,EAAE,IAAI,CAAC,GAAG;YACd,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;SACtC,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAwB,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,2DAA2D,EAAE;YACjF,UAAU;YACV,WAAW;YACX,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG;YAChC,IAAI,EAAE,IAAI,CAAC,GAAG;YACd,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;SACtC,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAwB,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAwB,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CACpB,WAA4B,EAC5B,KAA4C,EACd,EAAE;IAChC,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,IAAI,EAAE,IAAI,KAAK,YAAY;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACtE,IAAI,WAAW,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChF,IAAI,WAAW,CAAC,eAAe;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,wCAAwC,CAAC,CACvF,QAAQ,CAAC,EACP,UAA0B,EAC1B,gBAAgD,EAChD,aAAyC,EACzC,OAA4B;IAE5B,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAClD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAmC,CAAC;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IACxD,KAAK,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,SAAS;QACzC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,SAAS,EACT,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE,CAC9B,WAAW,CACT,UAAU,EACV,WAAW,EACX,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,EACpF,YAAY,CACb,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,CAAU,CAAC,CAAC,EAC5D,EAAE,WAAW,EAAE,oBAAoB,EAAE,CACtC,CACF,CAAC;IACF,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CACnD,MAAM,CAAC,OAAO,CACZ,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CACrF,CACF,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,sCAAsC,EAAE;YAC7D,UAAU;YACV,gBAAgB,EAAE,gBAAgB,CAAC,MAAM;YACzC,YAAY,EAAE,KAAK,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAC/D,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE;YACrD,UAAU;YACV,YAAY,EAAE,KAAK,CAAC,IAAI;YACxB,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,OAAO,EAAE,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM;YAC7C,GAAG,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM;gBACN,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aAChE,CAAC,CACH;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC;QAC1D,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;aAC9B,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAChB,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACzE;aACA,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;KAC3C,CAAC;AACrC,CAAC,CACF,CAAC"}

package/dist/polling/polling.d.ts

@@ -4,33 +4,42 @@ import { type RepositoryName } from "@usine/core/repository";
 import { CursorStore } from "@usine/engine/cursor";
 import { CycleBudgets } from "@usine/engine/cycle-budget";
 import { RunEngine, type EnginePersistenceError } from "@usine/engine/engine";
-import { ItemProjectionWriter } from "@usine/engine/item-projection";
+import { ItemProjectionReader, ItemProjectionWriter } from "@usine/engine/item-projection";
 import { LoopControl } from "@usine/engine/loop-control";
 import { RepositoryLabelProjectionReader, RepositoryLabelProjectionWriter } from "@usine/engine/repository-label-projection";
 import { ExpressionEngine } from "@usine/expression/expression-engine";
 import { type ChangedItem, GitHubPolling } from "@usine/github/polling";
 import { Context, DateTime, Effect, Layer, Option } from "effect";
 import { LabelReconciler } from "../label-reconciler.ts";
+import { type WatchedInstance } from "../reloads.ts";
 import { PollCycle } from "./cycle.ts";
 declare const PollingTriggers_base: Context.ServiceClass<PollingTriggers, "@usine/orchestrator/PollingTriggers", {
     /**
-     * Polls every managed repository, including those without active Loops.
-     * Label preflight precedes change detection; each changed Item is projected
-     * before its Run decisions. A repository commits its cursor only after all
-     * Items finish. Repository failures are reported while siblings continue;
-     * failure to read Loop runtime state fails the whole cycle.
+     * Polls every managed repository and evaluates its Loops against changed Items. Reports
+     * repository failures without stopping the others; fails only if Loop runtime state can't be
+     * read.
      */
     readonly poll: (instance: LoadedInstance) => Effect.Effect<PollCycle, EnginePersistenceError>;
-    /** Nudges an authoritative Item fetch after a self-write, retaining any request backoff from the writer. Pending duplicates coalesce; polling repairs loss. */
+    /**
+     * Requests an Item fetch after a self-write, keeping the writer's request backoff. Duplicate
+     * hints coalesce, and polling repairs lost ones.
+     */
     readonly hint: (repository: RepositoryName, item: ChangedItem, backoffUntil?: Option.Option<DateTime.Utc>) => Effect.Effect<void>;
-    /** Repeats cycles at the configured interval and processes self-write Hints, respecting GitHub request backoff. */
-    readonly run: (instance: LoadedInstance) => Effect.Effect<never>;
-    /** The last completed cycle, including its isolated failures; absent until the first cycle completes. */
+    /**
+     * Runs cycles at the configured interval and processes self-write hints, respecting GitHub
+     * request backoff. An accepted reload starts the next cycle immediately, unless GitHub asked to
+     * wait longer.
+     */
+    readonly run: (instances: WatchedInstance) => Effect.Effect<never>;
+    /**
+     * The last completed cycle with its isolated failures, or `None` before the first cycle
+     * completes.
+     */
     readonly latest: Effect.Effect<Option.Option<PollCycle>>;
 }>;
 /** Keeps managed repositories' Boards current and evaluates their active Loops against changed Items. */
 export declare class PollingTriggers extends PollingTriggers_base {
-    static readonly layer: Layer.Layer<PollingTriggers, never, ConfigParser | CursorStore | CycleBudgets | ExpressionEngine | GitHubPolling | ItemProjectionWriter | LabelReconciler | LoopControl | RepositoryLabelProjectionReader | RepositoryLabelProjectionWriter | RunEngine>;
+    static readonly layer: Layer.Layer<PollingTriggers, never, ConfigParser | CursorStore | CycleBudgets | ExpressionEngine | GitHubPolling | ItemProjectionReader | ItemProjectionWriter | LabelReconciler | LoopControl | RepositoryLabelProjectionReader | RepositoryLabelProjectionWriter | RunEngine>;
 }
 export {};
 //# sourceMappingURL=polling.d.ts.map

package/dist/polling/polling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/polling/polling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAa,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAChC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,KAAK,WAAW,EAAyB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAEL,OAAO,EACP,QAAQ,EAER,MAAM,EACN,KAAK,EACL,MAAM,EAKP,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,eAAe,EAA8B,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAGL,SAAS,EAIV,MAAM,YAAY,CAAC;;IAmEhB;;;;;;OAMG;mBACY,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC7F,+JAA+J;mBAChJ,CACb,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,WAAW,EACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACxB,mHAAmH;kBACrG,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IAChE,yGAAyG;qBACxF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;;AArB5D,yGAAyG;AACzG,qBAAa,eAAgB,SAAQ,oBAsBK;IACxC,MAAM,CAAC,QAAQ,CAAC,KAAK,2PAyVkB;CACxC"}
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/polling/polling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAa,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAChC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAGL,KAAK,WAAW,EAGhB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,OAAO,EACP,QAAQ,EAER,MAAM,EAEN,KAAK,EACL,MAAM,EAKP,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,eAAe,EAA8B,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAGL,SAAS,EAKV,MAAM,YAAY,CAAC;;IA8FhB;;;;OAIG;mBACY,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC7F;;;OAGG;mBACY,CACb,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,WAAW,EACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACxB;;;;OAIG;kBACW,CAAC,SAAS,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IAClE;;;OAGG;qBACc,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;;AA7B5D,yGAAyG;AACzG,qBAAa,eAAgB,SAAQ,oBA8BK;IACxC,MAAM,CAAC,QAAQ,CAAC,KAAK,kRAokBkB;CACxC"}