@usine/github 0.1.0 → 0.1.2

package/dist/polling/detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/polling/detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAGrF,sGAAsG;AACtG,MAAM,OAAO,UAAW,SAAQ,MAAM,CAAC,KAAK,CAAa,0BAA0B,CAAC,CAAC;IACnF,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,qBAAqB,CAAC;CACjE,CAAC;IACA,MAAM,CAAU,KAAK,GAAG,IAAI,UAAU,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;KACzB,CAAC,CAAC;CACJ;AAED,+EAA+E;AAC/E,MAAM,OAAO,YAAa,SAAQ,MAAM,CAAC,WAAW,CAAe,4BAA4B,CAAC,CAC9F,cAAc,EACd;IACE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC,WAAW;CAC9B,CACF;CAAG;AAEJ,qFAAqF;AACrF,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,WAAW,CACxD,kCAAkC,CACnC,CAAC,oBAAoB,EAAE;IACtB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC,WAAW;CAC9B,CAAC;CAAG;AAEL,yFAAyF;AACzF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAG5E,qFAAqF;AACrF,MAAM,OAAO,qBAAsB,SAAQ,MAAM,CAAC,WAAW,CAC3D,qCAAqC,CACtC,CAAC,uBAAuB,EAAE;IACzB,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;IAC7C,+FAA+F;IAC/F,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAClD,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAC7D;CACF,CAAC;CAAG;AAEL,yFAAyF;AACzF,MAAM,OAAO,iBAAkB,SAAQ,MAAM,CAAC,WAAW,CACvD,iCAAiC,CAClC,CAAC,mBAAmB,EAAE;IACrB,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;IAChC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;IAC7C,+FAA+F;IAC/F,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAClD,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAC7D;CACF,CAAC;CAAG;AAEL,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC"}

package/dist/polling/labels.d.ts

@@ -0,0 +1,31 @@
+import { Schema } from "effect";
+/** A repository label name as returned by GitHub, preserved without case conversion. */
+export declare const RepositoryLabelName: Schema.brand<Schema.NonEmptyString, "GitHubRepositoryLabelName">;
+export type RepositoryLabelName = typeof RepositoryLabelName.Type;
+/** GitHub stores label colors as six hex digits without the leading hash. */
+export declare const RepositoryLabelColor: Schema.brand<Schema.String, "GitHubRepositoryLabelColor">;
+export type RepositoryLabelColor = typeof RepositoryLabelColor.Type;
+declare const RepositoryLabel_base: Schema.Class<RepositoryLabel, Schema.Struct<{
+    readonly name: Schema.brand<Schema.NonEmptyString, "GitHubRepositoryLabelName">;
+    readonly color: Schema.brand<Schema.String, "GitHubRepositoryLabelColor">;
+    readonly description: Schema.OptionFromNullOr<Schema.String>;
+}>, {}>;
+/** One repository label as GitHub defines it. The name routes lanes, and color and description are presentation only. */
+export declare class RepositoryLabel extends RepositoryLabel_base {
+}
+declare const RepositoryLabelCatalog_base: Schema.Class<RepositoryLabelCatalog, Schema.Struct<{
+    readonly entityTag: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "GitHubEntityTag">>;
+    readonly labels: Schema.$Array<typeof RepositoryLabel>;
+}>, {}>;
+/** A complete label catalog with the ETag of its canonical REST URL. */
+export declare class RepositoryLabelCatalog extends RepositoryLabelCatalog_base {
+}
+declare const RepositoryLabelsNotModified_base: Schema.Class<RepositoryLabelsNotModified, Schema.TaggedStruct<"RepositoryLabelsNotModified", {}>, {}>;
+/** GitHub confirmed the catalog named by its ETag has not changed. */
+export declare class RepositoryLabelsNotModified extends RepositoryLabelsNotModified_base {
+}
+/** A complete label catalog or confirmation that the cached catalog is unchanged. */
+export declare const RepositoryLabelDetection: Schema.Union<readonly [typeof RepositoryLabelCatalog, typeof RepositoryLabelsNotModified]>;
+export type RepositoryLabelDetection = typeof RepositoryLabelDetection.Type;
+export {};
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/polling/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,kEAE/B,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAElE,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,2DAEiB,CAAC;AACnD,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAC;;;;;;AAEpE,yHAAyH;AACzH,qBAAa,eAAgB,SAAQ,oBAMpC;CAAG;;;;;AAOJ,wEAAwE;AACxE,qBAAa,sBAAuB,SAAQ,2BAK1C;CAAG;;AAEL,sEAAsE;AACtE,qBAAa,2BAA4B,SAAQ,gCAEb;CAAG;AAEvC,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,4FAGnC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC"}

package/dist/polling/labels.js

@@ -0,0 +1,29 @@
+import { Schema } from "effect";
+import { EntityTag } from "./detection.js";
+/** A repository label name as returned by GitHub, preserved without case conversion. */
+export const RepositoryLabelName = Schema.NonEmptyString.pipe(Schema.brand("GitHubRepositoryLabelName"));
+/** GitHub stores label colors as six hex digits without the leading hash. */
+export const RepositoryLabelColor = Schema.String.check(Schema.isPattern(/^[0-9a-fA-F]{6}$/u, { message: "Expected a six-digit hex label color" })).pipe(Schema.brand("GitHubRepositoryLabelColor"));
+/** One repository label as GitHub defines it. The name routes lanes, and color and description are presentation only. */
+export class RepositoryLabel extends Schema.Class("@usine/github/RepositoryLabel")({
+    name: RepositoryLabelName,
+    color: RepositoryLabelColor,
+    description: Schema.OptionFromNullOr(Schema.String),
+}) {
+}
+const uniqueLabelNames = Schema.makeFilter((labels) => new Set(labels.map(({ name }) => name)).size === labels.length, { message: "Expected unique label names" });
+/** A complete label catalog with the ETag of its canonical REST URL. */
+export class RepositoryLabelCatalog extends Schema.Class("@usine/github/RepositoryLabelCatalog")({
+    entityTag: Schema.OptionFromNullOr(EntityTag),
+    labels: Schema.Array(RepositoryLabel).check(uniqueLabelNames),
+}) {
+}
+/** GitHub confirmed the catalog named by its ETag has not changed. */
+export class RepositoryLabelsNotModified extends Schema.TaggedClass("@usine/github/RepositoryLabelsNotModified")("RepositoryLabelsNotModified", {}) {
+}
+/** A complete label catalog or confirmation that the cached catalog is unchanged. */
+export const RepositoryLabelDetection = Schema.Union([
+    RepositoryLabelCatalog,
+    RepositoryLabelsNotModified,
+]);
+//# sourceMappingURL=labels.js.map

package/dist/polling/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/polling/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,wFAAwF;AACxF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAC3D,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAC1C,CAAC;AAGF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CACrD,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;AAGnD,yHAAyH;AACzH,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,KAAK,CAAkB,+BAA+B,CAAC,CACjG;IACE,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC;CACpD,CACF;CAAG;AAEJ,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CACxC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,EAC1E,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAC3C,CAAC;AAEF,wEAAwE;AACxE,MAAM,OAAO,sBAAuB,SAAQ,MAAM,CAAC,KAAK,CACtD,sCAAsC,CACvC,CAAC;IACA,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CAC9D,CAAC;CAAG;AAEL,sEAAsE;AACtE,MAAM,OAAO,2BAA4B,SAAQ,MAAM,CAAC,WAAW,CACjE,2CAA2C,CAC5C,CAAC,6BAA6B,EAAE,EAAE,CAAC;CAAG;AAEvC,qFAAqF;AACrF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,KAAK,CAAC;IACnD,sBAAsB;IACtB,2BAA2B;CAC5B,CAAC,CAAC"}

package/dist/polling/{model.d.ts → payload.d.ts}

@@ -1,68 +1,5 @@
 import { Schema } from "effect";
-/**
- * The payload keys that hold a `Timestamp` above. Bound to the slice schemas:
- * a field added to a slice with a `Timestamp` value MUST be listed here, or it
- * silently joins the content hash and re-fires every item once (ADR 0007 keeps
- * timestamps in the payload but out of the hash).
- */
-export declare const TIMESTAMP_FIELDS: ReadonlySet<string>;
-export declare const EntityTag: Schema.brand<Schema.NonEmptyString, "GitHubEntityTag">;
-export type EntityTag = typeof EntityTag.Type;
-export declare const RepositoryLabelName: Schema.brand<Schema.NonEmptyString, "GitHubRepositoryLabelName">;
-export type RepositoryLabelName = typeof RepositoryLabelName.Type;
-declare const RepositoryLabelCatalog_base: Schema.Class<RepositoryLabelCatalog, Schema.Struct<{
-    readonly entityTag: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "GitHubEntityTag">>;
-    readonly labels: Schema.$Array<Schema.brand<Schema.NonEmptyString, "GitHubRepositoryLabelName">>;
-}>, {}>;
-/** A complete label catalog and the ETag for its canonical REST URL. */
-export declare class RepositoryLabelCatalog extends RepositoryLabelCatalog_base {
-}
-declare const RepositoryLabelsNotModified_base: Schema.Class<RepositoryLabelsNotModified, Schema.TaggedStruct<"RepositoryLabelsNotModified", {}>, {}>;
-/** GitHub confirmed that the catalog named by its ETag has not changed. */
-export declare class RepositoryLabelsNotModified extends RepositoryLabelsNotModified_base {
-}
-export declare const RepositoryLabelDetection: Schema.Union<readonly [typeof RepositoryLabelCatalog, typeof RepositoryLabelsNotModified]>;
-export type RepositoryLabelDetection = typeof RepositoryLabelDetection.Type;
-declare const PollCursor_base: Schema.Class<PollCursor, Schema.Struct<{
-    readonly entityTag: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "GitHubEntityTag">>;
-    readonly watermark: Schema.OptionFromNullOr<Schema.DateTimeUtcFromString>;
-}>, {}>;
-/** Efficiency-only REST cursor. Losing it is safe because Event dedup is permanent. */
-export declare class PollCursor extends PollCursor_base {
-    static readonly empty: PollCursor;
-}
-declare const ChangedIssue_base: Schema.Class<ChangedIssue, Schema.TaggedStruct<"ChangedIssue", {
-    readonly number: Schema.Int;
-    readonly updatedAt: Schema.DateTimeUtc;
-}>, {}>;
-export declare class ChangedIssue extends ChangedIssue_base {
-}
-declare const ChangedPullRequest_base: Schema.Class<ChangedPullRequest, Schema.TaggedStruct<"ChangedPullRequest", {
-    readonly number: Schema.Int;
-    readonly updatedAt: Schema.DateTimeUtc;
-}>, {}>;
-export declare class ChangedPullRequest extends ChangedPullRequest_base {
-}
-export declare const ChangedItem: Schema.Union<readonly [typeof ChangedIssue, typeof ChangedPullRequest]>;
-export type ChangedItem = typeof ChangedItem.Type;
-declare const RepositoryNotModified_base: Schema.Class<RepositoryNotModified, Schema.TaggedStruct<"RepositoryNotModified", {
-    readonly cursor: typeof PollCursor;
-    readonly nextPollAt: Schema.Option<Schema.DateTimeUtc>;
-}>, {}>;
-export declare class RepositoryNotModified extends RepositoryNotModified_base {
-}
-declare const RepositoryChanges_base: Schema.Class<RepositoryChanges, Schema.TaggedStruct<"RepositoryChanges", {
-    readonly cursor: typeof PollCursor;
-    readonly items: Schema.$Array<Schema.Union<readonly [typeof ChangedIssue, typeof ChangedPullRequest]>>;
-    /** True when the page cap ended the walk early; the rest arrives next cycle. */
-    readonly backlog: Schema.Boolean;
-    readonly nextPollAt: Schema.Option<Schema.DateTimeUtc>;
-}>, {}>;
-export declare class RepositoryChanges extends RepositoryChanges_base {
-}
-export declare const ChangeDetection: Schema.Union<readonly [typeof RepositoryNotModified, typeof RepositoryChanges]>;
-export type ChangeDetection = typeof ChangeDetection.Type;
-/** Exact v1 issue payload slice recorded by issue #11. */
+/** The issue payload slice that `if:` expressions and prompt interpolation range over. */
 export declare const IssuePayload: Schema.Struct<{
     readonly number: Schema.Int;
     readonly title: Schema.String;
@@ -154,7 +91,7 @@ export declare const IssuePayload: Schema.Struct<{
     }, never, never>>, never, never>;
 }>;
 export type IssuePayload = typeof IssuePayload.Type;
-/** Exact v1 pull-request payload slice recorded by issue #11. */
+/** The pull-request payload slice that `if:` expressions and prompt interpolation range over. */
 export declare const PullRequestPayload: Schema.Struct<{
     readonly number: Schema.Int;
     readonly title: Schema.String;
@@ -336,6 +273,7 @@ export declare const PullRequestPayload: Schema.Struct<{
     }, never, never>>, never, never>;
 }>;
 export type PullRequestPayload = typeof PullRequestPayload.Type;
+/** Identifies an Item's payload content for Event deduplication; timestamp-only changes keep the same hash. */
 export declare const ContentHash: Schema.brand<Schema.String, "GitHubContentHash">;
 export type ContentHash = typeof ContentHash.Type;
 declare const IssueSnapshot_base: Schema.Class<IssueSnapshot, Schema.TaggedStruct<"IssueSnapshot", {
@@ -431,6 +369,7 @@ declare const IssueSnapshot_base: Schema.Class<IssueSnapshot, Schema.TaggedStruc
     }>;
     readonly contentHash: Schema.brand<Schema.String, "GitHubContentHash">;
 }>, {}>;
+/** An issue's observed payload and the content identity used to decide whether it represents new work. */
 export declare class IssueSnapshot extends IssueSnapshot_base {
 }
 declare const PullRequestSnapshot_base: Schema.Class<PullRequestSnapshot, Schema.TaggedStruct<"PullRequestSnapshot", {
@@ -616,9 +555,11 @@ declare const PullRequestSnapshot_base: Schema.Class<PullRequestSnapshot, Schema
     }>;
     readonly contentHash: Schema.brand<Schema.String, "GitHubContentHash">;
 }>, {}>;
+/** A pull request's observed payload and the content identity used to decide whether it represents new work. */
 export declare class PullRequestSnapshot extends PullRequestSnapshot_base {
 }
+/** The fetched Item state shared by selection, prompt rendering, and Event deduplication. */
 export declare const PayloadSnapshot: Schema.Union<readonly [typeof IssueSnapshot, typeof PullRequestSnapshot]>;
 export type PayloadSnapshot = typeof PayloadSnapshot.Type;
 export {};
-//# sourceMappingURL=model.d.ts.map
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/polling/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,QAAQ,CAAC;AA8C9C,0FAA0F;AAC1F,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC;AAiBpD,iGAAiG;AACjG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsD7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE,+GAA+G;AAC/G,eAAO,MAAM,WAAW,kDAEiB,CAAC;AAC1C,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAElD,0GAA0G;AAC1G,qBAAa,aAAc,SAAQ,kBAMlC;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,gHAAgH;AAChH,qBAAa,mBAAoB,SAAQ,wBAKvC;CAAG;AAEL,6FAA6F;AAC7F,eAAO,MAAM,eAAe,2EAAqD,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC"}

package/dist/polling/{model.js → payload.js}

@@ -1,77 +1,13 @@
-import { Option, Schema, SchemaGetter } from "effect";
+import { Schema, SchemaGetter } from "effect";
 const PositiveInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
 const NonNegativeInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
 const Timestamp = Schema.String.check(Schema.isPattern(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/u, {
     message: "Expected a GitHub UTC timestamp",
 }));
 /**
- * The payload keys that hold a `Timestamp` above. Bound to the slice schemas:
- * a field added to a slice with a `Timestamp` value MUST be listed here, or it
- * silently joins the content hash and re-fires every item once (ADR 0007 keeps
- * timestamps in the payload but out of the hash).
- */
-export const TIMESTAMP_FIELDS = new Set([
-    "closedAt",
-    "createdAt",
-    "mergedAt",
-    "submittedAt",
-    "updatedAt",
-]);
-export const EntityTag = Schema.NonEmptyString.pipe(Schema.brand("GitHubEntityTag"));
-export const RepositoryLabelName = Schema.NonEmptyString.pipe(Schema.brand("GitHubRepositoryLabelName"));
-/** A complete label catalog and the ETag for its canonical REST URL. */
-export class RepositoryLabelCatalog extends Schema.Class("@usine/github/RepositoryLabelCatalog")({
-    entityTag: Schema.OptionFromNullOr(EntityTag),
-    labels: Schema.Array(RepositoryLabelName).check(Schema.isUnique()),
-}) {
-}
-/** GitHub confirmed that the catalog named by its ETag has not changed. */
-export class RepositoryLabelsNotModified extends Schema.TaggedClass("@usine/github/RepositoryLabelsNotModified")("RepositoryLabelsNotModified", {}) {
-}
-export const RepositoryLabelDetection = Schema.Union([
-    RepositoryLabelCatalog,
-    RepositoryLabelsNotModified,
-]);
-/** Efficiency-only REST cursor. Losing it is safe because Event dedup is permanent. */
-export class PollCursor extends Schema.Class("@usine/github/PollCursor")({
-    entityTag: Schema.OptionFromNullOr(EntityTag),
-    watermark: Schema.OptionFromNullOr(Schema.DateTimeUtcFromString),
-}) {
-    static empty = new PollCursor({
-        entityTag: Option.none(),
-        watermark: Option.none(),
-    });
-}
-export class ChangedIssue extends Schema.TaggedClass("@usine/github/ChangedIssue")("ChangedIssue", {
-    number: PositiveInt,
-    updatedAt: Schema.DateTimeUtc,
-}) {
-}
-export class ChangedPullRequest extends Schema.TaggedClass("@usine/github/ChangedPullRequest")("ChangedPullRequest", {
-    number: PositiveInt,
-    updatedAt: Schema.DateTimeUtc,
-}) {
-}
-export const ChangedItem = Schema.Union([ChangedIssue, ChangedPullRequest]);
-export class RepositoryNotModified extends Schema.TaggedClass("@usine/github/RepositoryNotModified")("RepositoryNotModified", {
-    cursor: PollCursor,
-    nextPollAt: Schema.Option(Schema.DateTimeUtc),
-}) {
-}
-export class RepositoryChanges extends Schema.TaggedClass("@usine/github/RepositoryChanges")("RepositoryChanges", {
-    cursor: PollCursor,
-    items: Schema.Array(ChangedItem),
-    /** True when the page cap ended the walk early; the rest arrives next cycle. */
-    backlog: Schema.Boolean,
-    nextPollAt: Schema.Option(Schema.DateTimeUtc),
-}) {
-}
-export const ChangeDetection = Schema.Union([RepositoryNotModified, RepositoryChanges]);
-/**
- * GitHub declares most GraphQL connections nullable. A null connection and an
- * empty one carry the same information, so the boundary normalizes null to
- * empty — the domain type (and the CEL environment typed on it) stays
- * non-null, and both shapes hash identically.
+ * GitHub declares most GraphQL connections nullable, and a null connection means
+ * the same as an empty one. Decoding null to empty keeps the payload type
+ * non-null and hashes both shapes identically.
  */
 const orEmpty = (schema, empty) => Schema.NullOr(schema).pipe(Schema.decodeTo(schema, {
     decode: SchemaGetter.transform((value) => value ?? empty),
@@ -91,7 +27,7 @@ const IssueComments = Schema.Struct({
     totalCount: NonNegativeInt,
     nodes: Schema.Array(IssueComment),
 });
-/** Exact v1 issue payload slice recorded by issue #11. */
+/** The issue payload slice that `if:` expressions and prompt interpolation range over. */
 export const IssuePayload = Schema.Struct({
     number: PositiveInt,
     title: Schema.String,
@@ -118,7 +54,7 @@ export const IssuePayload = Schema.Struct({
         })),
     }), emptyConnection),
 });
-/** Null when the reviewer is a deleted user or a mannequin — real content, kept. */
+/** Null when the reviewer is a deleted user or a mannequin. That null is real content and stays in the payload. */
 const RequestedReviewer = Schema.NullOr(Schema.Struct({ login: Schema.optionalKey(Schema.NonEmptyString) }));
 const Review = Schema.Struct({
     author: NullableActor,
@@ -128,7 +64,7 @@ const Review = Schema.Struct({
     commit: Schema.NullOr(Schema.Struct({ oid: Schema.NonEmptyString })),
 });
 const ReviewThreadComment = Schema.Struct({ author: NullableActor, body: Schema.String });
-/** Exact v1 pull-request payload slice recorded by issue #11. */
+/** The pull-request payload slice that `if:` expressions and prompt interpolation range over. */
 export const PullRequestPayload = Schema.Struct({
     number: PositiveInt,
     title: Schema.String,
@@ -173,16 +109,20 @@ export const PullRequestPayload = Schema.Struct({
         nodes: Schema.Array(Schema.Struct({ number: PositiveInt, state: Schema.String })),
     }), emptyConnection),
 });
+/** Identifies an Item's payload content for Event deduplication; timestamp-only changes keep the same hash. */
 export const ContentHash = Schema.String.check(Schema.isPattern(/^[a-f0-9]{64}$/u, { message: "Expected a SHA-256 content hash" })).pipe(Schema.brand("GitHubContentHash"));
+/** An issue's observed payload and the content identity used to decide whether it represents new work. */
 export class IssueSnapshot extends Schema.TaggedClass("@usine/github/IssueSnapshot")("IssueSnapshot", {
     payload: IssuePayload,
     contentHash: ContentHash,
 }) {
 }
+/** A pull request's observed payload and the content identity used to decide whether it represents new work. */
 export class PullRequestSnapshot extends Schema.TaggedClass("@usine/github/PullRequestSnapshot")("PullRequestSnapshot", {
     payload: PullRequestPayload,
     contentHash: ContentHash,
 }) {
 }
+/** The fetched Item state shared by selection, prompt rendering, and Event deduplication. */
 export const PayloadSnapshot = Schema.Union([IssueSnapshot, PullRequestSnapshot]);
-//# sourceMappingURL=model.js.map
+//# sourceMappingURL=payload.js.map

package/dist/polling/payload.js.map

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

package/dist/polling/polling.d.ts

@@ -1,18 +1,24 @@
-import { Repository } from "@usine/core";
+import { RepositoryName } from "@usine/core/repository";
 import { Context, Crypto, Effect, Layer, Option } from "effect";
 import { HttpClient } from "effect/unstable/http";
 import { GitHubApp } from "../github-app.ts";
-import { type GitHubAppError } from "../model.ts";
-import { EntityTag, PollCursor, RepositoryLabelCatalog, RepositoryLabelsNotModified, type ChangeDetection, type ChangedItem, type PayloadSnapshot } from "./model.ts";
+import { type GitHubAppError } from "../error.ts";
+import { EntityTag, PollCursor, type ChangeDetection, type ChangedItem } from "./detection.ts";
+import { type PayloadSnapshot } from "./payload.ts";
+import { RepositoryLabelCatalog, RepositoryLabelsNotModified } from "./labels.ts";
 declare const GitHubPolling_base: Context.ServiceClass<GitHubPolling, "@usine/github/GitHubPolling", {
-    readonly changes: (repository: Repository.Name, cursor: PollCursor) => Effect.Effect<ChangeDetection, GitHubAppError>;
-    readonly labels: (repository: Repository.Name, entityTag: Option.Option<EntityTag>) => Effect.Effect<RepositoryLabelCatalog | RepositoryLabelsNotModified, GitHubAppError>;
-    readonly snapshot: (repository: Repository.Name, item: ChangedItem) => Effect.Effect<PayloadSnapshot, GitHubAppError>;
+    /** Finds issue and PR updates since the saved cursor; persist the returned cursor after processing the detected Items. */
+    readonly changes: (repository: RepositoryName, cursor: PollCursor) => Effect.Effect<ChangeDetection, GitHubAppError>;
+    /** Reads the repository's label catalog, or confirms the catalog named by `entityTag` is unchanged. */
+    readonly labels: (repository: RepositoryName, entityTag: Option.Option<EntityTag>) => Effect.Effect<RepositoryLabelCatalog | RepositoryLabelsNotModified, GitHubAppError>;
+    /** Fetches an Item's selection and prompt payload together with its timestamp-independent content hash. */
+    readonly snapshot: (repository: RepositoryName, item: ChangedItem) => Effect.Effect<PayloadSnapshot, GitHubAppError>;
 }>;
-/** GitHub change detection and snapshot fetching behind one external seam. */
+/** Finds changed GitHub Items and fetches the snapshots used to select work for Loops. */
 export declare class GitHubPolling extends GitHubPolling_base {
-    /** Live GitHub polling adapter over an installation token and Effect HTTP. */
     static readonly layer: Layer.Layer<GitHubPolling, never, Crypto.Crypto | GitHubApp | HttpClient.HttpClient>;
 }
-export {};
+export { EntityTag, PollCursor, ChangedIssue, ChangedPullRequest, ChangedItem, RepositoryNotModified, RepositoryChanges, ChangeDetection, } from "./detection.ts";
+export { RepositoryLabelName, RepositoryLabelColor, RepositoryLabel, RepositoryLabelCatalog, RepositoryLabelsNotModified, RepositoryLabelDetection, } from "./labels.ts";
+export { ContentHash, IssuePayload, PullRequestPayload, IssueSnapshot, PullRequestSnapshot, PayloadSnapshot, } from "./payload.ts";
 //# 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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAS,OAAO,EAAE,MAAM,EAAY,MAAM,EAAE,KAAK,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACzF,OAAO,EAAE,UAAU,EAAyC,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAY7C,OAAO,EAAwB,KAAK,cAAc,EAAwB,MAAM,aAAa,CAAC;AAC9F,OAAO,EAIL,SAAS,EAGT,UAAU,EAGV,sBAAsB,EACtB,2BAA2B,EAK3B,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;;sBAuJE,CAChB,UAAU,EAAE,UAAU,CAAC,IAAI,EAC3B,MAAM,EAAE,UAAU,KACf,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;qBAClC,CACf,UAAU,EAAE,UAAU,CAAC,IAAI,EAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,sBAAsB,GAAG,2BAA2B,EAAE,cAAc,CAAC;uBACrE,CACjB,UAAU,EAAE,UAAU,CAAC,IAAI,EAC3B,IAAI,EAAE,WAAW,KACd,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;;AAfvD,8EAA8E;AAC9E,qBAAa,aAAc,SAAQ,kBAgBD;IAChC,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAChC,aAAa,EACb,KAAK,EACL,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,UAAU,CAClD,CAmTC;CACH"}
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/polling/polling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAuB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAS,OAAO,EAAE,MAAM,EAAY,MAAM,EAAE,KAAK,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACzF,OAAO,EAAE,UAAU,EAAyC,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAY7C,OAAO,EAAwB,KAAK,cAAc,EAAwB,MAAM,aAAa,CAAC;AAC9F,OAAO,EAGL,SAAS,EACT,UAAU,EAGV,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,sBAAsB,EAEtB,2BAA2B,EAE5B,MAAM,aAAa,CAAC;;IAkJjB,0HAA0H;sBACxG,CAChB,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,UAAU,KACf,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;IACnD,uGAAuG;qBACtF,CACf,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,sBAAsB,GAAG,2BAA2B,EAAE,cAAc,CAAC;IACxF,2GAA2G;uBACxF,CACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,WAAW,KACd,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;;AAlBvD,0FAA0F;AAC1F,qBAAa,aAAc,SAAQ,kBAmBD;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAChC,aAAa,EACb,KAAK,EACL,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,UAAU,CAClD,CAsTC;CACH;AAED,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/polling/polling.js

@@ -1,18 +1,21 @@
-import { Repository } from "@usine/core";
+import { canonicalContent } from "./content.js";
+import { RepositoryName, splitRepositoryName } from "@usine/core/repository";
 import { Clock, Context, Crypto, DateTime, Effect, Layer, Option, Schema } from "effect";
 import { HttpClient, HttpClientRequest, HttpClientResponse } from "effect/unstable/http";
 import { GitHubApp } from "../github-app.js";
 import { API_ROOT, authorized, invalidResponse, pollIntervalMillis, rateLimitResetMillis, rateLimitRetryEpoch, retryAfterMillis, statusError, transportError, } from "../http.js";
-import { GitHubRateLimitError } from "../model.js";
-import { ChangedIssue, ChangedPullRequest, ContentHash, EntityTag, IssuePayload, IssueSnapshot, PollCursor, PullRequestPayload, PullRequestSnapshot, RepositoryLabelCatalog, RepositoryLabelsNotModified, RepositoryLabelName, RepositoryChanges, RepositoryNotModified, TIMESTAMP_FIELDS, } from "./model.js";
+import { GitHubRateLimitError } from "../error.js";
+import { ChangedIssue, ChangedPullRequest, EntityTag, PollCursor, RepositoryChanges, RepositoryNotModified, } from "./detection.js";
+import { ContentHash, IssuePayload, IssueSnapshot, PullRequestPayload, PullRequestSnapshot, } from "./payload.js";
+import { RepositoryLabel, RepositoryLabelCatalog, RepositoryLabelColor, RepositoryLabelsNotModified, RepositoryLabelName, } from "./labels.js";
 import { ISSUE_PAYLOAD_QUERY, PULL_REQUEST_PAYLOAD_QUERY } from "./queries.js";
 const WATERMARK_OVERLAP_MS = 5_000;
 const RATE_LIMIT_PRESSURE_THRESHOLD = 100;
-/** Bounds one cycle's REST walk; the watermark resumes the remainder next cycle. */
+/** Caps one cycle's REST walk. The watermark resumes the remainder next cycle. */
 const MAX_CHANGE_PAGES = 10;
-/** A pathological catalog cannot turn one repository poll into an unbounded walk. */
+/** Caps one repository's label walk so a pathological catalog cannot run unbounded. */
 const MAX_LABEL_PAGES = 100;
-/** GraphQL rate limiting sometimes omits reset headers; wait at least this long. */
+/** GraphQL rate limiting sometimes omits reset headers. Wait at least this long then. */
 const GRAPHQL_RATE_LIMIT_FALLBACK_MS = 60_000;
 const RestChangedItem = Schema.Struct({
     number: Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)),
@@ -20,8 +23,13 @@ const RestChangedItem = Schema.Struct({
     pullRequest: Schema.optionalKey(Schema.Unknown),
 }).pipe(Schema.encodeKeys({ updatedAt: "updated_at", pullRequest: "pull_request" }));
 const RestChangedItems = Schema.Array(RestChangedItem);
-const RestRepositoryLabels = Schema.Array(Schema.Struct({ name: RepositoryLabelName }));
-/** The GraphQL transport envelope; `errors` arrives on HTTP 200 and must be read. */
+const RestRepositoryLabels = Schema.Array(Schema.Struct({
+    name: RepositoryLabelName,
+    color: RepositoryLabelColor,
+    description: Schema.NullOr(Schema.String),
+}));
+const catalogLabel = ({ name, color, description, }) => new RepositoryLabel({ name, color, description: Option.fromNullishOr(description) });
+/** The GraphQL transport envelope. `errors` arrives on HTTP 200 and must be read. */
 const GraphqlEnvelope = Schema.Struct({
     data: Schema.optionalKey(Schema.Unknown),
     errors: Schema.optionalKey(Schema.Array(Schema.Struct({
@@ -35,17 +43,6 @@ const IssueData = Schema.Struct({
 const PullRequestData = Schema.Struct({
     repository: Schema.OptionFromNullOr(Schema.Struct({ pullRequest: Schema.OptionFromNullOr(PullRequestPayload) })),
 });
-const canonicalContent = (value) => {
-    if (Array.isArray(value))
-        return value.map(canonicalContent);
-    if (Schema.is(Schema.JsonObject)(value)) {
-        return Object.fromEntries(Object.entries(value)
-            .filter(([key]) => !TIMESTAMP_FIELDS.has(key))
-            .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
-            .map(([key, child]) => [key, canonicalContent(child)]));
-    }
-    return value;
-};
 const dateTimeAt = (epochMillis) => DateTime.make(epochMillis);
 const toChangedItems = (decoded) => decoded.map((item) => item.pullRequest === undefined
     ? new ChangedIssue({ number: item.number, updatedAt: item.updatedAt })
@@ -56,12 +53,16 @@ const latestDateTime = (candidates) => {
         return Option.none();
     return dateTimeAt(Math.max(...epochs));
 };
+const requestBackoff = (headers, now) => latestDateTime([
+    retryAfterMillis(headers["retry-after"], now),
+    rateLimitResetMillis(headers, RATE_LIMIT_PRESSURE_THRESHOLD),
+]);
 const nextPollAt = (headers, now) => latestDateTime([
     pollIntervalMillis(headers, now),
     retryAfterMillis(headers["retry-after"], now),
     rateLimitResetMillis(headers, RATE_LIMIT_PRESSURE_THRESHOLD),
 ]);
-/** `<https://...>; rel="next"` from a Link header, when GitHub has more pages. */
+/** The `rel="next"` URL from a Link header when GitHub has more pages. */
 const nextPageUrl = (link) => {
     if (link === undefined)
         return Option.none();
@@ -73,7 +74,7 @@ const sinceParameter = (watermark) => {
     return `${new Date(epoch - (epoch % 1_000)).toISOString().slice(0, 19)}Z`;
 };
 const changesUrl = (repository, cursor) => {
-    const { name, owner } = Repository.parts(repository);
+    const { name, owner } = splitRepositoryName(repository);
     const url = new URL(`${API_ROOT}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/issues`);
     url.searchParams.set("state", "all");
     url.searchParams.set("sort", "updated");
@@ -85,13 +86,13 @@ const changesUrl = (repository, cursor) => {
     return url.toString();
 };
 const labelsUrl = (repository) => {
-    const { name, owner } = Repository.parts(repository);
+    const { name, owner } = splitRepositoryName(repository);
     const url = new URL(`${API_ROOT}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/labels`);
     url.searchParams.set("per_page", "100");
     return url.toString();
 };
 const itemLabelsUrl = (repository, item) => {
-    const { name, owner } = Repository.parts(repository);
+    const { name, owner } = splitRepositoryName(repository);
     const url = new URL(`${API_ROOT}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/issues/${item}/labels`);
     url.searchParams.set("per_page", "100");
     return url.toString();
@@ -103,16 +104,8 @@ const newerWatermark = (cursor, items) => {
     }
     return epochs.length === 0 ? Option.none() : dateTimeAt(Math.max(...epochs));
 };
-const makeContentHash = (crypto) => Effect.fn("GitHubPolling.contentHash")(function* (payload) {
-    const encoded = new TextEncoder().encode(JSON.stringify(canonicalContent(payload)));
-    // An in-memory SHA-256 digest cannot fail for expected reasons: a failure
-    // here is a violated platform invariant, not a domain failure.
-    const digest = yield* crypto.digest("SHA-256", encoded).pipe(Effect.orDie);
-    return ContentHash.make(Array.from(digest, (byte) => byte.toString(16).padStart(2, "0")).join(""));
-});
-/** GitHub change detection and snapshot fetching behind one external seam. */
+/** Finds changed GitHub Items and fetches the snapshots used to select work for Loops. */
 export class GitHubPolling extends Context.Service()("@usine/github/GitHubPolling") {
-    /** Live GitHub polling adapter over an installation token and Effect HTTP. */
     static layer = Layer.effect(GitHubPolling, Effect.gen(function* () {
         const app = yield* GitHubApp;
         const crypto = yield* Crypto.Crypto;
@@ -147,11 +140,11 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
             }
             const decoded = yield* HttpClientResponse.schemaBodyJson(RestRepositoryLabels)(response).pipe(Effect.mapError((error) => invalidResponse(operation, error.message)));
             return {
-                labels: decoded.map(({ name }) => name),
+                labels: decoded.map(catalogLabel),
                 next: nextPageUrl(response.headers.link),
             };
         });
-        /** Walks the pages after an already-fetched first one; one cap for every label walk. */
+        /** Walks the label pages after an already-fetched first page, under the label page cap. */
         const remainingLabelPages = Effect.fn("GitHubPolling.remainingLabelPages")(function* (operation, firstPage) {
             const catalog = [...firstPage.labels];
             let next = firstPage.next;
@@ -165,7 +158,7 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
             if (Option.isSome(next)) {
                 return yield* invalidResponse(operation, `GitHub label list exceeded ${MAX_LABEL_PAGES} pages`);
             }
-            return catalog.sort((left, right) => left.localeCompare(right));
+            return catalog.sort((left, right) => left.name.localeCompare(right.name));
         });
         const allLabels = Effect.fn("GitHubPolling.allLabels")(function* (operation, initialUrl) {
             return yield* remainingLabelPages(operation, yield* labelsPage(operation, initialUrl));
@@ -186,7 +179,7 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
             }
             const firstPage = yield* HttpClientResponse.schemaBodyJson(RestRepositoryLabels)(response).pipe(Effect.mapError((error) => invalidResponse("list-repository-labels", error.message)));
             const catalog = yield* remainingLabelPages("list-repository-labels", {
-                labels: firstPage.map(({ name }) => name),
+                labels: firstPage.map(catalogLabel),
                 next: nextPageUrl(response.headers.link),
             });
             const catalogEntityTag = Schema.decodeUnknownOption(EntityTag)(response.headers.etag);
@@ -207,16 +200,19 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
             const now = yield* Clock.currentTimeMillis;
             const recommended = nextPollAt(response.headers, now);
             if (response.status === 304) {
-                return new RepositoryNotModified({ cursor, nextPollAt: recommended });
+                return new RepositoryNotModified({
+                    cursor,
+                    nextPollAt: recommended,
+                    backoffUntil: requestBackoff(response.headers, now),
+                });
             }
             if (response.status !== 200) {
                 return yield* statusError("poll-repository-changes", response, now);
             }
             const decoded = yield* HttpClientResponse.schemaBodyJson(RestChangedItems)(response).pipe(Effect.mapError((error) => invalidResponse("poll-repository-changes", error.message)));
             const items = toChangedItems(decoded);
-            // The ETag is efficiency-only: a page without one costs conditional
-            // requests next cycle, never correctness. Only the first page's tag
-            // matches the canonical URL the next cycle re-requests.
+            // The ETag is efficiency only: a page without one costs conditional requests next cycle, never correctness.
+            // Only the first page's tag matches the canonical URL the next cycle re-requests.
             const entityTag = Schema.decodeUnknownOption(EntityTag)(response.headers.etag);
             if (Option.isNone(entityTag)) {
                 yield* Effect.logWarning("GitHub omitted the changes ETag; next poll is unconditional", {
@@ -245,19 +241,19 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
                 items: allItems,
                 backlog,
                 nextPollAt: recommended,
+                backoffUntil: requestBackoff(response.headers, now),
             });
         });
         const graphql = Effect.fn("GitHubPolling.graphql")(function* (operation, repository, number, query, dataSchema) {
             const token = yield* app.installationToken();
-            const { name, owner } = Repository.parts(repository);
+            const { name, owner } = splitRepositoryName(repository);
             const request = HttpClientRequest.post(`${API_ROOT}/graphql`).pipe(HttpClientRequest.bodyJsonUnsafe({ query, variables: { owner, name, number } }), authorized(token.value));
             const response = yield* execute(operation, request);
             const now = yield* Clock.currentTimeMillis;
             if (response.status !== 200)
                 return yield* statusError(operation, response, now);
             const envelope = yield* HttpClientResponse.schemaBodyJson(GraphqlEnvelope)(response).pipe(Effect.mapError((error) => invalidResponse(operation, error.message)));
-            // GraphQL reports failures on HTTP 200: rate limiting becomes a typed
-            // wait; anything else keeps its messages for diagnosis.
+            // GraphQL reports failures on HTTP 200. Rate limiting becomes a typed wait, and anything else keeps its messages for diagnosis.
             if (envelope.errors !== undefined && envelope.errors.length > 0) {
                 const rateLimited = envelope.errors.some((error) => error.type === "RATE_LIMITED");
                 if (rateLimited) {
@@ -283,7 +279,7 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
                     totalLabels: payload.labels.totalCount,
                 });
                 const names = yield* allLabels("fetch-item-labels", itemLabelsUrl(repository, item.number));
-                return { totalCount: names.length, nodes: names.map((name) => ({ name })) };
+                return { totalCount: names.length, nodes: names.map(({ name }) => ({ name })) };
             });
             if (item._tag === "ChangedIssue") {
                 const data = yield* graphql("fetch-issue-snapshot", repository, item.number, ISSUE_PAYLOAD_QUERY, IssueData);
@@ -317,4 +313,13 @@ export class GitHubPolling extends Context.Service()("@usine/github/GitHubPollin
         return { changes, labels, snapshot };
     }));
 }
+export { EntityTag, PollCursor, ChangedIssue, ChangedPullRequest, ChangedItem, RepositoryNotModified, RepositoryChanges, ChangeDetection, } from "./detection.js";
+export { RepositoryLabelName, RepositoryLabelColor, RepositoryLabel, RepositoryLabelCatalog, RepositoryLabelsNotModified, RepositoryLabelDetection, } from "./labels.js";
+export { ContentHash, IssuePayload, PullRequestPayload, IssueSnapshot, PullRequestSnapshot, PayloadSnapshot, } from "./payload.js";
+const makeContentHash = (crypto) => Effect.fn("GitHubPolling.contentHash")(function* (payload) {
+    const encoded = new TextEncoder().encode(JSON.stringify(canonicalContent(payload)));
+    // An in-memory SHA-256 digest fails only on a broken platform, so a failure here is a defect.
+    const digest = yield* crypto.digest("SHA-256", encoded).pipe(Effect.orDie);
+    return ContentHash.make(Array.from(digest, (byte) => byte.toString(16).padStart(2, "0")).join(""));
+});
 //# sourceMappingURL=polling.js.map