@usine/orchestrator 0.0.1 → 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

@@ -0,0 +1,4 @@
+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

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

@@ -0,0 +1,4 @@
+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

package/dist/polling-triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-triggers.js","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/schedule-triggers.d.ts

@@ -0,0 +1,67 @@
+import type { LoadedInstance } from "@usine/config/instance";
+import { ConfigParser } from "@usine/config/parser";
+import { RunEngine, type EnginePersistenceError } from "@usine/engine/engine";
+import { LoopControl } from "@usine/engine/loop-control";
+import { ExpressionEngine } from "@usine/expression/expression-engine";
+import { Context, Effect, Layer, Option, Schema } from "effect";
+declare const ScheduleAgentFailure_base: Schema.Class<ScheduleAgentFailure, Schema.TaggedStruct<"ScheduleAgentFailure", {
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+    readonly message: Schema.String;
+}>, {}>;
+/** A schedule loop whose agent is no longer in the loaded roster. */
+export declare class ScheduleAgentFailure extends ScheduleAgentFailure_base {
+}
+declare const ScheduleTickFailure_base: Schema.Class<ScheduleTickFailure, Schema.TaggedStruct<"ScheduleTickFailure", {
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly scheduledAt: Schema.DateTimeUtc;
+    readonly errorTag: Schema.NonEmptyString;
+    readonly message: Schema.String;
+}>, {}>;
+/** A selected repository whose Tick could not be evaluated or submitted. */
+export declare class ScheduleTickFailure extends ScheduleTickFailure_base {
+}
+declare const ScheduleCronFailure_base: Schema.Class<ScheduleCronFailure, Schema.TaggedStruct<"ScheduleCronFailure", {
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly cron: Schema.String;
+    readonly tz: Schema.String;
+    readonly message: Schema.String;
+}>, {}>;
+/**
+ * A schedule whose cron boundaries could not be computed at this instant.
+ * Cron.prev and Cron.next fail inside a DST spring-forward gap even for a cron
+ * that parsed; the schedule retries next cycle and its siblings run.
+ */
+export declare class ScheduleCronFailure extends ScheduleCronFailure_base {
+}
+export declare const ScheduleFailure: Schema.Union<readonly [typeof ScheduleAgentFailure, typeof ScheduleCronFailure, typeof ScheduleTickFailure]>;
+export type ScheduleFailure = typeof ScheduleFailure.Type;
+declare const ScheduleCycle_base: Schema.Class<ScheduleCycle, Schema.Struct<{
+    readonly loops: Schema.Int;
+    readonly fanout: 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]>>;
+    readonly skipped: Schema.Int;
+    readonly alreadyFired: Schema.Int;
+    readonly failures: Schema.$Array<Schema.Union<readonly [typeof ScheduleAgentFailure, typeof ScheduleCronFailure, typeof ScheduleTickFailure]>>;
+    readonly nextTickAt: Schema.Option<Schema.DateTimeUtc>;
+}>, {}>;
+/** The result of evaluating every schedule loop at one instant. */
+export declare class ScheduleCycle extends ScheduleCycle_base {
+}
+declare const ScheduleTriggers_base: Context.ServiceClass<ScheduleTriggers, "@usine/orchestrator/ScheduleTriggers", {
+    /**
+     * Evaluates the latest due Tick of every schedule. A repository's failure is
+     * logged and reported without stopping its siblings; a cron failure in a
+     * DST gap fails only its own schedule.
+     */
+    readonly tick: (instance: LoadedInstance) => Effect.Effect<ScheduleCycle, EnginePersistenceError>;
+    readonly run: (instance: LoadedInstance) => Effect.Effect<never>;
+    readonly latest: Effect.Effect<Option.Option<ScheduleCycle>>;
+}>;
+/** Turns due schedule ticks into one Event per selected repository. */
+export declare class ScheduleTriggers extends ScheduleTriggers_base {
+    static readonly layer: Layer.Layer<ScheduleTriggers, never, ConfigParser | ExpressionEngine | LoopControl | RunEngine>;
+}
+export {};
+//# sourceMappingURL=schedule-triggers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-triggers.d.ts","sourceRoot":"","sources":["../src/schedule-triggers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AASpD,OAAO,EACL,SAAS,EACT,KAAK,sBAAsB,EAG5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAEL,OAAO,EAIP,MAAM,EACN,KAAK,EACL,MAAM,EAGN,MAAM,EACP,MAAM,QAAQ,CAAC;;;;;;AAgDhB,qEAAqE;AACrE,qBAAa,oBAAqB,SAAQ,yBAMxC;CAAG;;;;;;;;AAEL,4EAA4E;AAC5E,qBAAa,mBAAoB,SAAQ,wBAQvC;CAAG;;;;;;;AAEL;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,wBAOvC;CAAG;AAEL,eAAO,MAAM,eAAe,8GAI1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;;;;;;;;;;AAE1D,mEAAmE;AACnE,qBAAa,aAAc,SAAQ,kBAUlC;CAAG;;IAsEA;;;;OAIG;mBACY,CACb,QAAQ,EAAE,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC;kBAC3C,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;;AAbhE,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,qBAcK;IACzC,MAAM,CAAC,QAAQ,CAAC,KAAK,kGAqTnB;CACH"}