@usine/orchestrator 0.1.0 → 0.2.0

package/dist/polling/repository-sync.js

@@ -0,0 +1,169 @@
+import { CycleGeneration } from "@usine/core/cycle-budget";
+import { CycleBudgets } from "@usine/engine/cycle-budget";
+import { ItemKey, ItemNumber } from "@usine/core/item";
+import { RepositoryName, canonicalRepositoryName } from "@usine/core/repository";
+import { ItemContentHash, ItemProjection, ItemProjectionSource, ItemProjectionWriter, } from "@usine/engine/item-projection";
+import { RepositoryLabel, RepositoryLabelProjection, RepositoryLabelProjectionReader, RepositoryLabelProjectionWriter, } from "@usine/engine/repository-label-projection";
+import { EntityTag, GitHubPolling, RepositoryLabelCatalog, } from "@usine/github/polling";
+import { DateTime, Effect, Option, Result, Schema } from "effect";
+import { LabelReconciler } from "../label-reconciler.js";
+import { latestPollAt, RepositoryPollFailure, repositoryFailureLogFields, } from "./cycle.js";
+/**
+ * Identifies one GitHub issue or pull request across its changing snapshots.
+ * Encoding uses the canonical repository name and Item number; decoding lets
+ * Board consumers locate the Item associated with a Run. Schedule Runs identify
+ * the repository alone and do not decode as an Item.
+ */
+export const GitHubItemKey = Schema.toType(ItemKey).pipe(Schema.decodeTo(Schema.fromJsonString(Schema.Tuple([Schema.Literal("github"), RepositoryName, ItemNumber]))));
+// `toType` preserves the ItemKey brand on the encoded side, so the encoder
+// produces the identity accepted by both the Board projection and Run engine.
+const encodeGitHubItemKey = Schema.encodeSync(GitHubItemKey);
+/** The reconciliation result when the cycle had no confirmed catalog to compare against. */
+const DEFERRED_RECONCILIATION = {
+    labels: [],
+    findings: [],
+    catalogChanged: false,
+    nextPollAt: Option.none(),
+};
+/**
+ * Refreshes the stored label catalog that the Board and the label
+ * preflight read. A failed request keeps the stored catalog and ETag and
+ * defers provisioning; trigger evaluation runs from the change poll alone.
+ */
+const applyLabelCatalog = Effect.fn("PollingTriggers.applyLabelCatalog")(function* (repository, labelEntityTag, result) {
+    yield* Effect.annotateCurrentSpan({ repository });
+    const repositoryLabelReader = yield* RepositoryLabelProjectionReader;
+    const repositoryLabelWriter = yield* RepositoryLabelProjectionWriter;
+    const unchanged = {
+        labelEntityTag,
+        entityTagChanged: false,
+        confirmedLabels: Option.none(),
+        failures: [],
+        nextPollAt: Option.none(),
+    };
+    if (Result.isFailure(result)) {
+        const error = result.failure;
+        if (error._tag === "GitHubRateLimitError") {
+            yield* Effect.logWarning("Label catalog rate-limited; kept the stored catalog and deferred label provisioning", {
+                repository,
+                operation: error.operation,
+                retryAt: DateTime.formatIso(error.retryAt),
+            });
+            return { ...unchanged, nextPollAt: Option.some(error.retryAt) };
+        }
+        yield* Effect.logError("Label catalog request failed; kept the stored catalog, deferred label provisioning, and evaluated items anyway", {
+            repository,
+            ...repositoryFailureLogFields(error),
+        });
+        return {
+            ...unchanged,
+            failures: [
+                new RepositoryPollFailure({
+                    repository,
+                    errorTag: error._tag,
+                    message: error.message,
+                }),
+            ],
+        };
+    }
+    const detection = result.success;
+    if (!(detection instanceof RepositoryLabelCatalog)) {
+        const projection = yield* repositoryLabelReader.get(repository);
+        if (Option.isNone(projection)) {
+            // The ETag vouches for a projection that is no longer stored, so drop
+            // it and fetch the catalog in full next cycle.
+            yield* Effect.logWarning("Repository label catalog unchanged (304) but its projection is missing; refetching next cycle and deferring label provisioning", { repository });
+            return { ...unchanged, labelEntityTag: Option.none(), entityTagChanged: true };
+        }
+        yield* Effect.logDebug("Repository label catalog unchanged (304)", {
+            repository,
+        });
+        return { ...unchanged, confirmedLabels: Option.some(projection.value.labels) };
+    }
+    const labels = detection.labels.map(({ name, color, description }) => new RepositoryLabel({ name, color: Option.some(color), description }));
+    yield* repositoryLabelWriter.replace(new RepositoryLabelProjection({ repository, labels }));
+    return {
+        ...unchanged,
+        labelEntityTag: detection.entityTag,
+        entityTagChanged: true,
+        confirmedLabels: Option.some(labels),
+    };
+});
+/**
+ * Refreshes and reconciles one repository's Board label catalog before change
+ * detection. Pass the catalog ETag from its stored poll cursor; the result gives
+ * the ETag to persist after Item processing, plus preflight findings and backoff.
+ * Failed catalog requests retain the stored projection and defer provisioning;
+ * persistence failures stop the repository for retry.
+ */
+export const synchronizeLabels = Effect.fn("PollingTriggers.synchronizeLabels")(function* (repository, declared, entityTag) {
+    yield* Effect.annotateCurrentSpan({ repository });
+    const github = yield* GitHubPolling;
+    const labelReconciler = yield* LabelReconciler;
+    const repositoryLabelWriter = yield* RepositoryLabelProjectionWriter;
+    const result = yield* Effect.result(github.labels(repository, entityTag));
+    const catalog = yield* applyLabelCatalog(repository, entityTag, result);
+    const reconciliation = yield* Option.match(catalog.confirmedLabels, {
+        onNone: () => Effect.succeed(DEFERRED_RECONCILIATION),
+        onSome: (confirmed) => labelReconciler.reconcile(repository, declared, confirmed),
+    });
+    const preflight = {
+        labelEntityTag: reconciliation.catalogChanged
+            ? Option.none()
+            : catalog.labelEntityTag,
+        entityTagChanged: catalog.entityTagChanged || reconciliation.catalogChanged,
+        failures: catalog.failures,
+        preflightFindings: reconciliation.findings,
+        nextPollAt: latestPollAt([catalog.nextPollAt, reconciliation.nextPollAt]),
+    };
+    if (reconciliation.catalogChanged) {
+        yield* repositoryLabelWriter
+            .replace(new RepositoryLabelProjection({ repository, labels: reconciliation.labels }))
+            .pipe(
+        // Provisioning may have reported failures before projection storage
+        // fails. Preserve those findings just as for a later Item failure.
+        Effect.mapError((error) => ({
+            _tag: "InterruptedRepositoryCycle",
+            error,
+            failures: preflight.failures,
+            preflightFindings: preflight.preflightFindings,
+            nextPollAt: preflight.nextPollAt,
+        })));
+    }
+    return preflight;
+});
+/**
+ * Fetches a detected Item and durably updates its Board projection regardless of
+ * whether any Loop applies. Evaluation uses the returned projection's snapshot,
+ * identity and content hash, so Board observation and Run decisions agree.
+ */
+export const observeItem = Effect.fn("PollingTriggers.observeItem")(function* (repository, changed) {
+    yield* Effect.annotateCurrentSpan({ repository, item: changed.number });
+    const github = yield* GitHubPolling;
+    const items = yield* ItemProjectionWriter;
+    const budgets = yield* CycleBudgets;
+    const itemKey = encodeGitHubItemKey([
+        "github",
+        RepositoryName.make(canonicalRepositoryName(repository)),
+        ItemNumber.make(changed.number),
+    ]);
+    const cycleGeneration = yield* budgets.generation(itemKey);
+    const snapshot = yield* github.snapshot(repository, changed);
+    const projection = new ItemProjection({
+        itemKey,
+        repository,
+        source: ItemProjectionSource.make(changed._tag === "ChangedIssue" ? "issue" : "pr"),
+        number: ItemNumber.make(changed.number),
+        contentHash: ItemContentHash.make(snapshot.contentHash),
+        payload: snapshot.payload,
+    });
+    yield* items.upsert(projection);
+    yield* Effect.logDebug("Fetched changed-item snapshot", {
+        repository,
+        item: projection.number,
+        stream: projection.source,
+        contentHash: projection.contentHash,
+    });
+    return { projection, cycleGeneration };
+});
+//# sourceMappingURL=repository-sync.js.map

package/dist/polling/repository-sync.js.map

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

package/dist/polling-triggers.d.ts

@@ -1,40 +1,4 @@
-import { ConfigParser, type LoadedInstance } from "@usine/config";
-import { CursorStore, type EnginePersistenceError, ItemProjectionWriter, LoopControl, RepositoryLabelProjectionWriter, RunEngine } from "@usine/engine";
-import { ExpressionEngine } from "@usine/expression";
-import { GitHubPolling } from "@usine/github";
-import { Context, Effect, Layer, Option, Schema } from "effect";
-declare const RepositoryPollFailure_base: Schema.Class<RepositoryPollFailure, Schema.Struct<{
-    readonly repository: Schema.brand<Schema.String, "RepoName">;
-    readonly errorTag: Schema.NonEmptyString;
-    readonly message: Schema.String;
-}>, {}>;
-/** One repository whose cycle ended in a typed error; siblings were unaffected. */
-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").Claimed, typeof import("@usine/engine").Queued, typeof import("@usine/engine").Ignored]>>;
-    /** Run ids actually revoked because their item stopped matching. */
-    readonly revokedRuns: Schema.Int;
-    readonly failures: Schema.$Array<typeof RepositoryPollFailure>;
-    readonly nextPollAt: Schema.Option<Schema.DateTimeUtc>;
-}>, {}>;
-export declare class PollCycle extends PollCycle_base {
-}
-declare const PollingTriggers_base: Context.ServiceClass<PollingTriggers, "@usine/orchestrator/PollingTriggers", {
-    /**
-     * One cycle over every watched repository. Per-repository failures are
-     * isolated, logged, and reported on the cycle — one bad repository never
-     * stops its siblings, and only a defect stops the loop.
-     */
-    readonly poll: (instance: LoadedInstance) => Effect.Effect<PollCycle, EnginePersistenceError>;
-    readonly run: (instance: LoadedInstance) => Effect.Effect<never>;
-    readonly latest: Effect.Effect<Option.Option<PollCycle>>;
-}>;
-/** Full selector-pruned GitHub change → snapshot → CEL → Event composition. */
-export declare class PollingTriggers extends PollingTriggers_base {
-    static readonly layer: Layer.Layer<PollingTriggers, never, ConfigParser | CursorStore | ExpressionEngine | GitHubPolling | ItemProjectionWriter | LoopControl | RepositoryLabelProjectionWriter | RunEngine>;
-}
-export {};
+export { PollingTriggers } from "./polling/polling.ts";
+export { PollCycle, RepositoryPollFailure } from "./polling/cycle.ts";
+export { GitHubItemKey } from "./polling/repository-sync.ts";
 //# sourceMappingURL=polling-triggers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"polling-triggers.d.ts","sourceRoot":"","sources":["../src/polling-triggers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGZ,KAAK,cAAc,EAKpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,WAAW,EACX,KAAK,sBAAsB,EAK3B,oBAAoB,EACpB,WAAW,EAEX,+BAA+B,EAC/B,SAAS,EAGV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,aAAa,EAQd,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,OAAO,EAGP,MAAM,EACN,KAAK,EACL,MAAM,EAGN,MAAM,EACP,MAAM,QAAQ,CAAC;;;;;;AA0BhB,mFAAmF;AACnF,qBAAa,qBAAsB,SAAQ,0BAMzC;CAAG;;;;;IAMH,oEAAoE;;;;;AAJtE,qBAAa,SAAU,SAAQ,cAQ7B;CAAG;;IAsGD;;;;OAIG;mBACY,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;kBAC/E,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;;AAX5D,+EAA+E;AAC/E,qBAAa,eAAgB,SAAQ,oBAYK;IACxC,MAAM,CAAC,QAAQ,CAAC,KAAK,wLAmYnB;CACH"}
+{"version":3,"file":"polling-triggers.d.ts","sourceRoot":"","sources":["../src/polling-triggers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/polling-triggers.js

@@ -1,394 +1,4 @@
-import { ConfigParser, environmentFor, matchesSelector, repositoryContext, } from "@usine/config";
-import { AttemptChannel, Event, Item, Repository } from "@usine/core";
-import { CursorKey, CursorStore, ItemContentHash, ItemNumber, ItemProjection, ItemProjectionSource, ItemProjectionWriter, LoopControl, RepositoryLabelProjection, RepositoryLabelProjectionWriter, RunEngine, SubmissionResult, } from "@usine/engine";
-import { ExpressionEngine } from "@usine/expression";
-import { GitHubPolling, EntityTag, PollCursor, RepositoryLabelCatalog, } from "@usine/github";
-import { Clock, Context, DateTime, Duration, Effect, Layer, Option, Ref, Result, Schema, } from "effect";
-import { configFileErrorLogFields, resolveTriggerLoops, submissionLogFields, triggerSubmission, } from "./trigger-submission.js";
-/** GitHub REST + GraphQL tolerate a handful of parallel calls per token. */
-const REPOSITORY_CONCURRENCY = 4;
-const ITEM_CONCURRENCY = 4;
-const WatchKey = Schema.NonEmptyString.pipe(Schema.brand("GitHubPollWatchKey"));
-class StoredPollCursor extends Schema.Class("@usine/orchestrator/StoredPollCursor")({
-    boardVersion: Schema.Literal(2),
-    cursor: PollCursor,
-    labelEntityTag: Schema.OptionFromNullOr(EntityTag),
-    watches: Schema.Array(WatchKey).check(Schema.isUnique()),
-}) {
-}
-/** One repository whose cycle ended in a typed error; siblings were unaffected. */
-export class RepositoryPollFailure extends Schema.Class("@usine/orchestrator/RepositoryPollFailure")({
-    repository: Repository.Name,
-    errorTag: Schema.NonEmptyString,
-    message: Schema.String,
-}) {
-}
-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),
-    /** Run ids actually revoked because their item stopped matching. */
-    revokedRuns: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
-    failures: Schema.Array(RepositoryPollFailure),
-    nextPollAt: Schema.Option(Schema.DateTimeUtc),
-}) {
-}
-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;
-};
-const cursorKey = (repository) => CursorKey.make(`github-poll:${Repository.canonical(repository.name)}`);
-const watchKey = ({ loop }) => WatchKey.make(JSON.stringify([loop.name, loop.trigger.on, loop.trigger.if]));
-const watchedRepositories = (instance, resolved) => instance.config.repos.map((repository) => {
-    const loops = resolved.filter(({ loop }) => loop.trigger.on !== "schedule" && matchesSelector(loop.selector, repository));
-    return { repository, loops, watches: loops.map(watchKey).sort() };
-});
-const sameWatches = (left, right) => left.length === right.length && left.every((value, index) => value === right[index]);
-const itemStream = (item) => item._tag === "ChangedIssue" ? "issue" : "pr";
-const itemKey = (repository, item) => Item.ItemKey.make(JSON.stringify(["github", Repository.canonical(repository.name), item.number]));
-const eventKey = (loop, repository, item, snapshot) => Event.DedupKey.make(JSON.stringify([
-    loop.name,
-    Repository.canonical(repository.name),
-    item.number,
-    snapshot.contentHash,
-]));
-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));
-};
-/** Full selector-pruned GitHub change → snapshot → CEL → Event composition. */
-export class PollingTriggers extends Context.Service()("@usine/orchestrator/PollingTriggers") {
-    static layer = Layer.effect(PollingTriggers, Effect.gen(function* () {
-        const cursors = yield* CursorStore;
-        const config = yield* ConfigParser;
-        const expressions = yield* ExpressionEngine;
-        const github = yield* GitHubPolling;
-        const items = yield* ItemProjectionWriter;
-        const repositoryLabels = yield* RepositoryLabelProjectionWriter;
-        const runs = yield* RunEngine;
-        const loops = yield* LoopControl;
-        const latest = yield* Ref.make(Option.none());
-        const emptyCursor = (watches) => new StoredPollCursor({
-            boardVersion: 2,
-            cursor: PollCursor.empty,
-            labelEntityTag: Option.none(),
-            watches,
-        });
-        const readCursor = Effect.fn("PollingTriggers.readCursor")(function* (watched) {
-            const stored = yield* cursors.read(cursorKey(watched.repository), StoredPollCursor);
-            if (Option.isNone(stored))
-                return emptyCursor(watched.watches);
-            if (!sameWatches(stored.value.watches, watched.watches)) {
-                yield* Effect.logInfo("Watched loops changed; re-polling the repository from scratch", {
-                    repository: watched.repository.name,
-                    previousWatches: stored.value.watches.length,
-                    currentWatches: watched.watches.length,
-                });
-                return emptyCursor(watched.watches);
-            }
-            return stored.value;
-        });
-        const writeCursor = Effect.fn("PollingTriggers.writeCursor")((watched, cursor) => cursors.write(cursorKey(watched.repository), StoredPollCursor, cursor));
-        const evaluateItem = Effect.fn("PollingTriggers.evaluateItem")(function* (watched, item) {
-            yield* Effect.annotateCurrentSpan({
-                repository: watched.repository.name,
-                item: item.number,
-            });
-            const loops = watched.loops.filter(({ loop }) => loop.trigger.on === itemStream(item));
-            const snapshot = yield* github.snapshot(watched.repository.name, item);
-            // Both snapshot variants carry their payload; the union needs no recheck.
-            const payload = snapshot.payload;
-            const context = { repo: repositoryContext(watched.repository), item: payload };
-            const stableItemKey = itemKey(watched.repository, item);
-            yield* items.upsert(new ItemProjection({
-                itemKey: stableItemKey,
-                repository: watched.repository.name,
-                source: ItemProjectionSource.make(itemStream(item)),
-                number: ItemNumber.make(item.number),
-                contentHash: ItemContentHash.make(snapshot.contentHash),
-                payload,
-            }));
-            yield* Effect.logDebug("Fetched changed-item snapshot", {
-                repository: watched.repository.name,
-                item: item.number,
-                stream: itemStream(item),
-                contentHash: snapshot.contentHash,
-            });
-            if (loops.length === 0) {
-                yield* Effect.logDebug("Item projected without any matching repository Loop", {
-                    repository: watched.repository.name,
-                    item: item.number,
-                    stream: itemStream(item),
-                });
-                return { submissions: [], revokedRuns: 0, failures: [] };
-            }
-            const submissions = [];
-            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: watched.repository.name,
-                        loop: loop.name,
-                        agent: agent.name,
-                        item: item.number,
-                    });
-                    const revoked = yield* runs.revoke(loop.name, stableItemKey);
-                    revokedRuns += revoked.length;
-                    if (revoked.length > 0) {
-                        yield* Effect.logInfo("Item stopped matching; revoked its unstarted runs", {
-                            repository: watched.repository.name,
-                            loop: loop.name,
-                            agent: agent.name,
-                            item: item.number,
-                            runIds: revoked.join(", "),
-                        });
-                    }
-                    continue;
-                }
-                const dedupKey = eventKey(loop, watched.repository, item, snapshot);
-                const receivedAt = yield* DateTime.now;
-                // A render failure is deterministic loop authoring, not transport:
-                // re-polling the same snapshot re-fails identically. Isolate it to
-                // this loop so 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: watched.repository.name,
-                        agent: agent.name,
-                        item: item.number,
-                        errorTag: rendered.failure._tag,
-                        message: rendered.failure.message,
-                        ...configFileErrorLogFields(rendered.failure),
-                    });
-                    failures.push(new RepositoryPollFailure({
-                        repository: watched.repository.name,
-                        errorTag: rendered.failure._tag,
-                        message: rendered.failure.message,
-                    }));
-                    continue;
-                }
-                const submitted = yield* runs.submit(triggerSubmission({
-                    dedupKey,
-                    itemKey: stableItemKey,
-                    loop,
-                    payload,
-                    receivedAt,
-                    repository: watched.repository,
-                    task: AttemptChannel.Task.make(rendered.success),
-                    agent,
-                    parentModel,
-                }));
-                yield* Effect.logInfo("Submitted matching item state", {
-                    repository: watched.repository.name,
-                    loop: loop.name,
-                    agent: agent.name,
-                    item: item.number,
-                    contentHash: snapshot.contentHash,
-                    result: submitted._tag,
-                    ...submissionLogFields(submitted),
-                });
-                submissions.push(submitted);
-            }
-            return { submissions, revokedRuns, failures };
-        });
-        /**
-         * The label catalog feeds the Board projection only. A failed catalog
-         * request keeps the stored catalog and ETag and never blocks trigger
-         * evaluation: label-triggered Loops fire from the change poll alone.
-         */
-        const applyLabelCatalog = Effect.fn("PollingTriggers.applyLabelCatalog")(function* (watched, stored, result) {
-            const unchanged = {
-                labelEntityTag: stored.labelEntityTag,
-                stored: false,
-                failures: [],
-                nextPollAt: Option.none(),
-            };
-            if (Result.isFailure(result)) {
-                const error = result.failure;
-                if (error._tag === "GitHubRateLimitError") {
-                    yield* Effect.logWarning("Label catalog rate-limited; keeping the stored catalog", {
-                        repository: watched.repository.name,
-                        operation: error.operation,
-                        retryAt: DateTime.formatIso(error.retryAt),
-                    });
-                    return { ...unchanged, nextPollAt: Option.some(error.retryAt) };
-                }
-                yield* Effect.logError("Label catalog request failed; kept the stored catalog and evaluated items anyway", {
-                    repository: watched.repository.name,
-                    ...repositoryFailureLogFields(error),
-                });
-                return {
-                    ...unchanged,
-                    failures: [
-                        new RepositoryPollFailure({
-                            repository: watched.repository.name,
-                            errorTag: error._tag,
-                            message: error.message,
-                        }),
-                    ],
-                };
-            }
-            const detection = result.success;
-            if (!(detection instanceof RepositoryLabelCatalog)) {
-                yield* Effect.logDebug("Repository label catalog unchanged (304)", {
-                    repository: watched.repository.name,
-                });
-                return unchanged;
-            }
-            yield* repositoryLabels.replace(new RepositoryLabelProjection({
-                repository: watched.repository.name,
-                labels: detection.labels.map(String),
-            }));
-            return { ...unchanged, labelEntityTag: detection.entityTag, stored: true };
-        });
-        const pollRepository = Effect.fn("PollingTriggers.pollRepository")(function* (watched) {
-            yield* Effect.annotateCurrentSpan({ repository: watched.repository.name });
-            const stored = yield* readCursor(watched);
-            const [detected, labelResult] = yield* Effect.all([
-                github.changes(watched.repository.name, stored.cursor),
-                Effect.result(github.labels(watched.repository.name, stored.labelEntityTag)),
-            ], { concurrency: "unbounded" });
-            const catalog = yield* applyLabelCatalog(watched, stored, labelResult);
-            const nextCursor = new StoredPollCursor({
-                boardVersion: 2,
-                cursor: detected.cursor,
-                labelEntityTag: catalog.labelEntityTag,
-                watches: watched.watches,
-            });
-            const nextPollAt = latestPollAt([detected.nextPollAt, catalog.nextPollAt]);
-            if (detected._tag === "RepositoryNotModified") {
-                if (catalog.stored) {
-                    yield* writeCursor(watched, nextCursor);
-                }
-                yield* Effect.logDebug("Repository unchanged (304)", {
-                    repository: watched.repository.name,
-                });
-                return {
-                    changedItems: 0,
-                    submissions: [],
-                    revokedRuns: 0,
-                    failures: catalog.failures,
-                    nextPollAt,
-                };
-            }
-            yield* Effect.logInfo("Repository changed", {
-                repository: watched.repository.name,
-                changedItems: detected.items.length,
-                backlog: detected.backlog,
-            });
-            const itemCycles = yield* Effect.forEach(detected.items, (item) => evaluateItem(watched, item), { concurrency: ITEM_CONCURRENCY });
-            // Advancing is the commit point: every changed item was fetched,
-            // evaluated, and submitted/revoked successfully. A prior failure
-            // leaves the old cursor so the next cycle safely re-polls.
-            yield* writeCursor(watched, nextCursor);
-            return {
-                changedItems: detected.items.length,
-                submissions: itemCycles.flatMap(({ submissions }) => submissions),
-                revokedRuns: itemCycles.reduce((sum, cycle) => sum + cycle.revokedRuns, 0),
-                failures: [...catalog.failures, ...itemCycles.flatMap(({ failures }) => failures)],
-                nextPollAt,
-            };
-        });
-        const poll = Effect.fn("PollingTriggers.poll")(function* (instance) {
-            const paused = new Set((yield* loops.states).filter((state) => state.paused).map((state) => state.loop));
-            for (const loop of instance.loops) {
-                if (loop.trigger.on !== "schedule" && paused.has(loop.name)) {
-                    yield* Effect.logDebug("Paused Loop skipped during repository polling", {
-                        loop: loop.name,
-                    });
-                }
-            }
-            const resolved = (yield* resolveTriggerLoops(instance)).filter(({ loop }) => !paused.has(loop.name));
-            const watched = watchedRepositories(instance, resolved);
-            const settled = yield* Effect.forEach(watched, (repository) => Effect.result(pollRepository(repository)).pipe(Effect.map((result) => ({ repository, result }))), { concurrency: REPOSITORY_CONCURRENCY });
-            const cycles = [];
-            const failures = [];
-            const backoffs = [];
-            for (const { repository, result } of settled) {
-                if (Result.isSuccess(result)) {
-                    cycles.push(result.success);
-                    continue;
-                }
-                const error = result.failure;
-                if (error._tag === "GitHubRateLimitError") {
-                    // A rate-limit pause is scheduling input, not a repository failure.
-                    yield* Effect.logWarning("GitHub rate limit reached; delaying the next cycle", {
-                        repository: repository.repository.name,
-                        operation: error.operation,
-                        retryAt: DateTime.formatIso(error.retryAt),
-                    });
-                    backoffs.push(Option.some(error.retryAt));
-                    continue;
-                }
-                yield* Effect.logError("Repository poll cycle failed; siblings were unaffected", {
-                    repository: repository.repository.name,
-                    ...repositoryFailureLogFields(error),
-                });
-                failures.push(new RepositoryPollFailure({
-                    repository: repository.repository.name,
-                    errorTag: error._tag,
-                    message: error.message,
-                }));
-            }
-            const cycle = new PollCycle({
-                repositories: watched.length,
-                changedItems: cycles.reduce((sum, cycle) => sum + cycle.changedItems, 0),
-                submissions: cycles.flatMap(({ submissions }) => submissions),
-                revokedRuns: cycles.reduce((sum, cycle) => sum + cycle.revokedRuns, 0),
-                failures: [...cycles.flatMap(({ failures: isolated }) => isolated), ...failures],
-                nextPollAt: latestPollAt([...cycles.map(({ nextPollAt }) => nextPollAt), ...backoffs]),
-            });
-            yield* Ref.set(latest, Option.some(cycle));
-            return cycle;
-        });
-        // No Effect.fn here: `run` never returns, so a named wrapper would open
-        // a span that never closes. Each cycle's span lives on `poll`.
-        const run = (instance) => Effect.gen(function* () {
-            const startedAt = yield* Clock.currentTimeMillis;
-            const result = yield* Effect.result(poll(instance));
-            if (Result.isFailure(result)) {
-                const sleepMs = instance.config.settings.pollInterval * 1_000;
-                yield* Effect.logError("Poll cycle could not read Loop runtime state; retrying", {
-                    errorTag: result.failure._tag,
-                    message: result.failure.message,
-                    operation: result.failure.operation,
-                    sleepMs,
-                });
-                yield* Effect.sleep(Duration.millis(sleepMs));
-                return;
-            }
-            const cycle = result.success;
-            const intervalAt = startedAt + instance.config.settings.pollInterval * 1_000;
-            const target = Option.match(cycle.nextPollAt, {
-                onNone: () => intervalAt,
-                onSome: (value) => Math.max(intervalAt, DateTime.toEpochMillis(value)),
-            });
-            const now = yield* Clock.currentTimeMillis;
-            const sleepMs = Math.max(0, target - now);
-            yield* Effect.logInfo("Poll cycle complete", {
-                repositories: cycle.repositories,
-                changedItems: cycle.changedItems,
-                submissions: cycle.submissions.length,
-                revokedRuns: cycle.revokedRuns,
-                failures: cycle.failures.length,
-                sleepMs,
-            });
-            yield* Effect.sleep(Duration.millis(sleepMs));
-        }).pipe(Effect.forever);
-        return { latest: Ref.get(latest), poll, run };
-    }));
-}
+export { PollingTriggers } from "./polling/polling.js";
+export { PollCycle, RepositoryPollFailure } from "./polling/cycle.js";
+export { GitHubItemKey } from "./polling/repository-sync.js";
 //# sourceMappingURL=polling-triggers.js.map