@usine/orchestrator 0.1.0 → 0.2.1

package/dist/orchestrator.d.ts

@@ -1,11 +1,12 @@
-import type { LoadedInstance } from "@usine/config";
+import type { LoadedInstance } from "@usine/config/instance";
 import { Context, Effect, Layer } from "effect";
 import { PollingTriggers } from "./polling-triggers.ts";
 import { ScheduleTriggers } from "./schedule-triggers.ts";
 declare const Orchestrator_base: Context.ServiceClass<Orchestrator, "@usine/orchestrator/Orchestrator", {
+    /** Evaluates the supplied instance's triggers until interrupted, using that snapshot of its Loops and roster. */
     readonly run: (instance: LoadedInstance) => Effect.Effect<never>;
 }>;
-/** The embeddable full runtime: polling, schedules, engine-facing operator acts. */
+/** Coordinates polling and schedule triggers for one loaded factory instance. */
 export declare class Orchestrator extends Orchestrator_base {
     static readonly layer: Layer.Layer<Orchestrator, never, PollingTriggers | ScheduleTriggers>;
 }

package/dist/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;;kBAgBxC,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;;AAJpE,oFAAoF;AACpF,qBAAa,YAAa,SAAQ,iBAKK;IACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,uEAAgD;CACtE"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;;IAgBtD,iHAAiH;kBACnG,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;;AALpE,iFAAiF;AACjF,qBAAa,YAAa,SAAQ,iBAMK;IACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,uEAAgD;CACtE"}

package/dist/orchestrator.js

@@ -7,7 +7,7 @@ const makeOrchestrator = Effect.gen(function* () {
     const run = (instance) => Effect.raceFirst(polling.run(instance), schedules.run(instance));
     return { run };
 });
-/** The embeddable full runtime: polling, schedules, engine-facing operator acts. */
+/** Coordinates polling and schedule triggers for one loaded factory instance. */
 export class Orchestrator extends Context.Service()("@usine/orchestrator/Orchestrator") {
     static layer = Layer.effect(Orchestrator, makeOrchestrator);
 }

package/dist/orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAE1C,MAAM,GAAG,GAAG,CAAC,QAAwB,EAAwB,EAAE,CAC7D,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE,OAAO,EAAE,GAAG,EAAW,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,OAAO,YAAa,SAAQ,OAAO,CAAC,OAAO,EAK9C,CAAC,kCAAkC,CAAC;IACrC,MAAM,CAAU,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;CACtE"}
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAE1C,MAAM,GAAG,GAAG,CAAC,QAAwB,EAAwB,EAAE,CAC7D,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE,OAAO,EAAE,GAAG,EAAW,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH,iFAAiF;AACjF,MAAM,OAAO,YAAa,SAAQ,OAAO,CAAC,OAAO,EAM9C,CAAC,kCAAkC,CAAC;IACrC,MAAM,CAAU,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;CACtE"}

package/dist/polling/cycle.d.ts

@@ -0,0 +1,51 @@
+import type { ConfigFileError } from "@usine/config/file";
+import { type RunEngineError } from "@usine/engine/engine";
+import type { ExpressionError } from "@usine/expression/expression-engine";
+import type { GitHubAppError } from "@usine/github/github-app";
+import { DateTime, Option, Schema } from "effect";
+import { LabelPreflightFinding } from "../label-reconciler.ts";
+declare const RepositoryPollFailure_base: Schema.Class<RepositoryPollFailure, Schema.Struct<{
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly errorTag: Schema.NonEmptyString;
+    readonly message: Schema.String;
+}>, {}>;
+/** One repository whose cycle failed; its siblings finished normally. */
+export declare class RepositoryPollFailure extends RepositoryPollFailure_base {
+}
+declare const PollCycle_base: Schema.Class<PollCycle, Schema.Struct<{
+    readonly repositories: Schema.Int;
+    readonly changedItems: Schema.Int;
+    readonly submissions: Schema.$Array<Schema.Union<readonly [typeof import("@usine/engine/engine").Claimed, typeof import("@usine/engine/engine").Queued, typeof import("@usine/engine/engine").Ignored, typeof import("@usine/engine/engine").CycleBlocked]>>;
+    /** How many Runs this cycle revoked because their item stopped matching. */
+    readonly revokedRuns: Schema.Int;
+    readonly failures: Schema.$Array<typeof RepositoryPollFailure>;
+    readonly preflightFindings: Schema.$Array<typeof LabelPreflightFinding>;
+    readonly nextPollAt: Schema.Option<Schema.DateTimeUtc>;
+}>, {}>;
+/** Outcomes of one poll over all managed repositories, including isolated failures and backoff. */
+export declare class PollCycle extends PollCycle_base {
+}
+/** Recoverable failures that leave a repository eligible for another poll. */
+export type RepositoryPollError = ConfigFileError | ExpressionError | GitHubAppError | RunEngineError;
+/** Safe diagnostic fields for a failed repository operation. */
+export declare const repositoryFailureLogFields: (error: RepositoryPollError) => {
+    errorTag: "AppPermissionError" | "AttemptCancellationError" | "ConfigFileError" | "EnginePersistenceError" | "ExpressionCheckError" | "ExpressionEvaluationError" | "GitHubApiError" | "GitHubRateLimitError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError";
+    message: string;
+} | {
+    errorTag: "AppPermissionError" | "AttemptCancellationError" | "ConfigFileError" | "EnginePersistenceError" | "ExpressionCheckError" | "ExpressionEvaluationError" | "GitHubApiError" | "GitHubRateLimitError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError";
+    message: string;
+    expression: string & import("effect/Brand").Brand<"ExpressionSource">;
+};
+/** A cycle whose preflight finished but whose repository poll failed. */
+export interface InterruptedRepositoryCycle {
+    readonly _tag: "InterruptedRepositoryCycle";
+    readonly error: RepositoryPollError;
+    /** Preflight failures such as a failed catalog request, kept through the interruption. */
+    readonly failures: ReadonlyArray<RepositoryPollFailure>;
+    readonly preflightFindings: ReadonlyArray<LabelPreflightFinding>;
+    readonly nextPollAt: Option.Option<DateTime.Utc>;
+}
+/** The latest requested backoff; no recommendation leaves the configured interval in charge. */
+export declare const latestPollAt: (values: ReadonlyArray<Option.Option<DateTime.Utc>>) => Option.Option<DateTime.Utc>;
+export {};
+//# sourceMappingURL=cycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.d.ts","sourceRoot":"","sources":["../../src/polling/cycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,KAAK,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;;;;;;AAG/D,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,0BAMzC;CAAG;;;;;IAOH,4EAA4E;;;;;;AAL9E,mGAAmG;AACnG,qBAAa,SAAU,SAAQ,cAS7B;CAAG;AAEL,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,eAAe,GACf,cAAc,GACd,cAAc,CAAC;AAEnB,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,UAAW,mBAAmB;;;;;;;CASpE,CAAC;AAEF,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,gGAAgG;AAChG,eAAO,MAAM,YAAY,WACf,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KACjD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAQ5B,CAAC"}

package/dist/polling/cycle.js

@@ -0,0 +1,44 @@
+import { RepositoryName } from "@usine/core/repository";
+import { SubmissionResult } from "@usine/engine/engine";
+import { DateTime, Option, Schema } from "effect";
+import { LabelPreflightFinding } from "../label-reconciler.js";
+import { configFileErrorLogFields } from "../trigger-submission.js";
+/** One repository whose cycle failed; its siblings finished normally. */
+export class RepositoryPollFailure extends Schema.Class("@usine/orchestrator/RepositoryPollFailure")({
+    repository: RepositoryName,
+    errorTag: Schema.NonEmptyString,
+    message: Schema.String,
+}) {
+}
+/** Outcomes of one poll over all managed repositories, including isolated failures and backoff. */
+export class PollCycle extends Schema.Class("@usine/orchestrator/PollCycle")({
+    repositories: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+    changedItems: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+    submissions: Schema.Array(SubmissionResult),
+    /** How many Runs this cycle revoked because their item stopped matching. */
+    revokedRuns: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+    failures: Schema.Array(RepositoryPollFailure),
+    preflightFindings: Schema.Array(LabelPreflightFinding),
+    nextPollAt: Schema.Option(Schema.DateTimeUtc),
+}) {
+}
+/** Safe diagnostic fields for a failed repository operation. */
+export const repositoryFailureLogFields = (error) => {
+    const common = { errorTag: error._tag, message: error.message };
+    if (error._tag === "ConfigFileError") {
+        return { ...common, ...configFileErrorLogFields(error) };
+    }
+    if (error._tag === "ExpressionCheckError" || error._tag === "ExpressionEvaluationError") {
+        return { ...common, expression: error.source };
+    }
+    return common;
+};
+/** The latest requested backoff; no recommendation leaves the configured interval in charge. */
+export const latestPollAt = (values) => {
+    const epochs = values.flatMap((value) => Option.match(value, {
+        onNone: () => [],
+        onSome: (dateTime) => [DateTime.toEpochMillis(dateTime)],
+    }));
+    return epochs.length === 0 ? Option.none() : DateTime.make(Math.max(...epochs));
+};
+//# sourceMappingURL=cycle.js.map

package/dist/polling/cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.js","sourceRoot":"","sources":["../../src/polling/cycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,yEAAyE;AACzE,MAAM,OAAO,qBAAsB,SAAQ,MAAM,CAAC,KAAK,CACrD,2CAA2C,CAC5C,CAAC;IACA,UAAU,EAAE,cAAc;IAC1B,QAAQ,EAAE,MAAM,CAAC,cAAc;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AAEL,mGAAmG;AACnG,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,KAAK,CAAY,+BAA+B,CAAC,CAAC;IACtF,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAChE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAChE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC3C,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAC7C,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;CAC9C,CAAC;CAAG;AASL,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAA0B,EAAE,EAAE;IACvE,MAAM,MAAM,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAChE,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACrC,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,IAAI,KAAK,CAAC,IAAI,KAAK,2BAA2B,EAAE,CAAC;QACxF,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAYF,gGAAgG;AAChG,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAkD,EACrB,EAAE;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACtC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;QAClB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;QAChB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;KACzD,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC"}

package/dist/polling/hints.d.ts

@@ -0,0 +1,20 @@
+import { type RepositoryName } from "@usine/core/repository";
+import type { ChangedItem } from "@usine/github/polling";
+import { Context, DateTime, Effect, Layer, Option } from "effect";
+/** A self-write identifies an Item to fetch; its payload still comes from GitHub. */
+export interface ItemHint {
+    readonly repository: RepositoryName;
+    readonly item: ChangedItem;
+}
+declare const ItemHints_base: Context.ServiceClass<ItemHints, "@usine/orchestrator/ItemHints", {
+    offer: (repository: string & import("effect/Brand").Brand<"RepositoryName">, item: import("@usine/github/polling").ChangedIssue | import("@usine/github/polling").ChangedPullRequest, requestBackoff?: Option.Option<DateTime.Utc> | undefined) => Effect.Effect<void, never, never>;
+    take: Effect.Effect<ItemHint, never, never>;
+    defer: (until: Option.Option<DateTime.Utc>) => Effect.Effect<void, never, never>;
+    awaitBackoff: Effect.Effect<void, never, never>;
+}>;
+/** Private pending Hint and request-backoff state owned by a polling runtime. */
+export declare class ItemHints extends ItemHints_base {
+    static readonly layer: Layer.Layer<ItemHints, never, never>;
+}
+export {};
+//# sourceMappingURL=hints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/polling/hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAS,OAAO,EAAE,QAAQ,EAAY,MAAM,EAAE,KAAK,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAE/F,qFAAqF;AACrF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;;;;mBAUuB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;;;AAwDnD,iFAAiF;AACjF,qBAAa,SAAU,SAAQ,cAE9B;IACC,MAAM,CAAC,QAAQ,CAAC,KAAK,uCAAiC;CACvD"}

package/dist/polling/hints.js

@@ -0,0 +1,54 @@
+import { canonicalRepositoryName } from "@usine/core/repository";
+import { Clock, Context, DateTime, Duration, Effect, Layer, Option, Queue, Ref } from "effect";
+/** Pending Hints are bounded and coalesced; the normal poll repairs dropped nudges. */
+const make = Effect.gen(function* () {
+    const pending = new Set();
+    const queue = yield* Queue.make({ capacity: 128, strategy: "dropping" });
+    const backoffUntil = yield* Ref.make(0);
+    const key = ({ repository, item }) => `${canonicalRepositoryName(repository)}:${item.number}`;
+    const defer = (until) => Option.match(until, {
+        onNone: () => Effect.void,
+        onSome: (value) => Ref.update(backoffUntil, (current) => Math.max(current, DateTime.toEpochMillis(value))),
+    });
+    const offer = Effect.fn("PollingTriggers.hint")(function* (repository, item, requestBackoff = Option.none()) {
+        yield* Effect.annotateCurrentSpan({ repository, item: item.number });
+        yield* defer(requestBackoff);
+        const hint = { repository, item };
+        const id = key(hint);
+        if (pending.has(id)) {
+            yield* Effect.logDebug("Self-write Hint coalesced with a pending Item fetch", {
+                repository,
+                item: item.number,
+            });
+            return;
+        }
+        pending.add(id);
+        if (yield* Queue.offer(queue, hint)) {
+            yield* Effect.logDebug("Self-write Hint queued", { repository, item: item.number });
+        }
+        else {
+            pending.delete(id);
+            yield* Effect.logWarning("Self-write Hint queue full; the normal poll will refresh the Item", { repository, item: item.number });
+        }
+    }, Effect.uninterruptible);
+    const take = Effect.uninterruptibleMask((restore) => restore(Queue.take(queue)).pipe(Effect.tap((hint) => Effect.sync(() => pending.delete(key(hint))))));
+    const awaitBackoff = Effect.gen(function* () {
+        while (true) {
+            const until = yield* Ref.get(backoffUntil);
+            const now = yield* Clock.currentTimeMillis;
+            if (until <= now)
+                return;
+            yield* Effect.logInfo("GitHub request backoff delays polling and self-write Hints", {
+                sleepMs: until - now,
+            });
+            yield* Effect.sleep(Duration.millis(until - now));
+            // An operator write can extend the deadline while this consumer waits.
+        }
+    });
+    return { offer, take, defer, awaitBackoff };
+});
+/** Private pending Hint and request-backoff state owned by a polling runtime. */
+export class ItemHints extends Context.Service()("@usine/orchestrator/ItemHints") {
+    static layer = Layer.effect(ItemHints, make);
+}
+//# sourceMappingURL=hints.js.map

package/dist/polling/hints.js.map

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

package/dist/polling/loop-evaluation.d.ts

@@ -0,0 +1,21 @@
+import type { ManagedRepo } from "@usine/config/factory";
+import { ConfigParser } from "@usine/config/parser";
+import { RunEngine } from "@usine/engine/engine";
+import type { ObservedItem } from "./repository-sync.ts";
+import { ExpressionEngine } from "@usine/expression/expression-engine";
+import { InvalidGitHubResponseError } from "@usine/github/github-app";
+import { Effect } from "effect";
+import { type ResolvedLoop } from "../trigger-submission.ts";
+import { RepositoryPollFailure } from "./cycle.ts";
+/**
+ * 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.
+ */
+export declare const evaluateItem: (repository: ManagedRepo, resolved: readonly ResolvedLoop[], observed: ObservedItem) => Effect.Effect<{
+    submissions: (import("@usine/engine/engine").Claimed | import("@usine/engine/engine").CycleBlocked | import("@usine/engine/engine").Ignored | import("@usine/engine/engine").Queued)[];
+    revokedRuns: number;
+    failures: RepositoryPollFailure[];
+}, import("@usine/engine/engine").AttemptCancellationError | import("@usine/engine/engine").EnginePersistenceError | import("@usine/expression/expression-engine").ExpressionCheckError | import("@usine/expression/expression-engine").ExpressionEvaluationError | InvalidGitHubResponseError | import("@usine/engine/engine").RunInterventionRejectedError | import("@usine/engine/engine").RunNotFoundError | import("@usine/engine/engine").RunOperationRejectedError, ConfigParser | ExpressionEngine | RunEngine>;
+//# sourceMappingURL=loop-evaluation.d.ts.map

package/dist/polling/loop-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-evaluation.d.ts","sourceRoot":"","sources":["../../src/polling/loop-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAY,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAGL,KAAK,YAAY,EAGlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA0BnD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;ufA4HvB,CAAC"}

package/dist/polling/loop-evaluation.js

@@ -0,0 +1,131 @@
+import { ConfigParser } from "@usine/config/parser";
+import { environmentFor, repositoryContext } from "@usine/config/payload-slices";
+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 { 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";
+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.
+    ...(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.
+ */
+export const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function* (repository, resolved, observed) {
+    const { projection: item, cycleGeneration } = observed;
+    yield* Effect.annotateCurrentSpan({
+        repository: repository.name,
+        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;
+    const context = { repo: repositoryContext(repository), item: payload };
+    if (loops.length === 0) {
+        yield* Effect.logDebug("Item projected without any matching repository Loop", {
+            repository: repository.name,
+            item: item.number,
+            stream: item.source,
+        });
+        return { submissions: [], revokedRuns: 0, failures: [] };
+    }
+    const submissions = [];
+    // Projections store generic JSON; decode the GitHub PR revision at this boundary.
+    const revision = item.source === "pr"
+        ? 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`,
+        }))))
+        : 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) {
+            yield* Effect.logDebug("Item did not match its loop expression", {
+                repository: repository.name,
+                loop: loop.name,
+                agent: agent.name,
+                item: item.number,
+            });
+            const revoked = yield* runs.revoke(loop.name, item.itemKey);
+            revokedRuns += revoked.length;
+            if (revoked.length > 0) {
+                yield* Effect.logInfo("Item stopped matching; revoked its unstarted runs", {
+                    repository: repository.name,
+                    loop: loop.name,
+                    agent: agent.name,
+                    item: item.number,
+                    runIds: revoked.join(", "),
+                });
+            }
+            continue;
+        }
+        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", {
+                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,
+                errorTag: rendered.failure._tag,
+                message: rendered.failure.message,
+            }));
+            continue;
+        }
+        const submitted = yield* runs.submit(triggerSubmission({
+            dedupKey,
+            cycleGeneration,
+            itemKey: item.itemKey,
+            loop,
+            payload,
+            receivedAt,
+            repository,
+            revision,
+            task: AttemptTask.make(rendered.success),
+            agent,
+            parentModel,
+        }));
+        yield* Effect.logInfo("Submitted matching item state", {
+            repository: repository.name,
+            loop: loop.name,
+            agent: agent.name,
+            item: item.number,
+            contentHash: item.contentHash,
+            revision,
+            result: submitted._tag,
+            ...submissionLogFields(submitted),
+        });
+        submissions.push(submitted);
+    }
+    return { submissions, revokedRuns, failures };
+});
+//# sourceMappingURL=loop-evaluation.js.map

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

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

package/dist/polling/polling.d.ts

@@ -0,0 +1,36 @@
+import type { LoadedInstance } from "@usine/config/instance";
+import { ConfigParser } from "@usine/config/parser";
+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 { 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 { 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.
+     */
+    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. */
+    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. */
+    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>;
+}
+export {};
+//# sourceMappingURL=polling.d.ts.map

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

@@ -0,0 +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"}