@shivaedev/effect-github 0.2.0 → 0.3.0

package/README.md

@@ -102,6 +102,39 @@ const receiveWorkflowRun = (
 
 This decodes a signed `workflow_run` delivery with the fields the application needs. Keep the body bytes as received: parsing and reserializing JSON changes what was signed.
 
+### Sticky comments and check runs
+
+Use the service's `upsertStickyComment` to keep a report in one pull-request comment. Pass a marker name; the method prefixes the body with `<!-- name -->`, searches comment pages, and edits the first match. It creates a comment when no match exists. An optional `author` login restricts matching to that author's comments, leaving another author's report alone. A forbidden comment write fails with a typed `RemoteHttpError` and creates no comment.
+
+```ts
+const report = Effect.gen(function* () {
+  const github = yield* GitHub;
+  return yield* github.upsertStickyComment({
+    owner: "acme", repo: "widgets", number: 1,
+    marker: "coverage", author: "coverage[bot]",
+    body: "Coverage: 90%",
+  });
+});
+```
+
+`createCheckRun(owner, repo, input)` creates a check for `headSha` with a name and status. `updateCheckRun(owner, repo, id, input)` moves it to `in_progress` or `completed`; completion requires a conclusion. Output contains `title`, `summary` and optional `text`. Request and response Schemas are exported from `checkRuns.ts`.
+
+```ts
+const check = (headSha: string) => Effect.gen(function* () {
+  const github = yield* GitHub;
+  const created = yield* github.createCheckRun("acme", "widgets", {
+    headSha, name: "Coverage", status: "queued",
+  });
+  yield* github.updateCheckRun("acme", "widgets", created.id, {
+    status: "in_progress", output: { title: "Coverage", summary: "Measuring" },
+  });
+  return yield* github.updateCheckRun("acme", "widgets", created.id, {
+    status: "completed", conclusion: "success",
+    output: { title: "Coverage", summary: "90% covered", text: "All targets measured" },
+  });
+});
+```
+
 ### Rate limits and failures
 
 `github.observations()` returns the latest `resource`, `limit`, `remaining`, `used` and UTC `reset` from response headers, including conditional and failed responses. Core and search budgets remain separate. A primary or secondary rate limit fails with `GitHubRateLimited` from `@shivaedev/effect-github/errors.ts`; its `retryAt` is a UTC `DateTime` usable directly by a job scheduler. Requests to a blocked resource fail locally until that instant. Each rate-limited failure records a log and span event with the request path and budget, excluding credentials and query strings.

package/dist/GitHub.d.ts

@@ -1,25 +1,87 @@
 import { Effect, Schema, Stream } from "effect";
 import { HttpClient } from "effect/http";
-import type { ServiceUnavailable } from "@shivaedev/platform/errors/taxonomy.ts";
-import { GitHubToken } from "./GitHubToken.ts";
+import { GitHubToken } from "#GitHubToken.ts";
 export declare const GitHub: import("effect/Context").Service<"@shivaedev/effect-github/GitHub", Readonly<{
-    readonly bytes: (path: string, accept: string, limit: number) => Effect.Effect<Uint8Array<ArrayBufferLike>, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
-    readonly list: (path: string, beforeRequest?: ((resource: string) => Effect.Effect<void, ServiceUnavailable>) | undefined) => Effect.Effect<Stream.Stream<{
+    readonly list: (path: string, beforeRequest?: ((resource: string) => Effect.Effect<void, import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable>) | undefined) => Effect.Effect<Stream.Stream<{
         decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
-    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>, never, never>;
-    readonly observations: () => Effect.Effect<import("./rateLimits.ts").RateLimitObservation[], never, never>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>, never, never>;
     readonly read: (path: string) => Effect.Effect<{
         decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
     }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
-    readonly resource: (path: string) => Effect.Effect<string, never, never>;
-    readonly text: (path: string, accept: string, limit: number) => Effect.Effect<string, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
     readonly write: (method: "PATCH" | "POST", path: string, body: unknown) => Effect.Effect<{
         decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
     }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly createCheckRun: (owner: string, repo: string, input: {
+        readonly conclusion?: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out" | undefined;
+        readonly headSha: string;
+        readonly name: string;
+        readonly output?: {
+            readonly summary: string;
+            readonly text?: string | undefined;
+            readonly title: string;
+        } | undefined;
+        readonly status: "completed" | "in_progress" | "queued";
+    }) => Effect.Effect<{
+        readonly conclusion: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out" | null;
+        readonly headSha: string;
+        readonly id: number;
+        readonly name: string;
+        readonly output: {
+            readonly summary: string | null;
+            readonly text: string | null;
+            readonly title: string | null;
+        };
+        readonly status: "completed" | "in_progress" | "queued";
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly updateCheckRun: (owner: string, repo: string, id: number, input: {
+        readonly output?: {
+            readonly summary: string;
+            readonly text?: string | undefined;
+            readonly title: string;
+        } | undefined;
+        readonly status: "in_progress" | "queued";
+    } | {
+        readonly conclusion: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out";
+        readonly output?: {
+            readonly summary: string;
+            readonly text?: string | undefined;
+            readonly title: string;
+        } | undefined;
+        readonly status: "completed";
+    }) => Effect.Effect<{
+        readonly conclusion: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out" | null;
+        readonly headSha: string;
+        readonly id: number;
+        readonly name: string;
+        readonly output: {
+            readonly summary: string | null;
+            readonly text: string | null;
+            readonly title: string | null;
+        };
+        readonly status: "completed" | "in_progress" | "queued";
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly upsertStickyComment: (input: {
+        readonly author?: string | undefined;
+        readonly body: string;
+        readonly marker: string;
+        readonly number: number;
+        readonly owner: string;
+        readonly repo: string;
+    }) => Effect.Effect<{
+        readonly body: string;
+        readonly id: number;
+        readonly user: {
+            readonly login: string;
+        } | null;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly bytes: (path: string, accept: string, limit: number) => Effect.Effect<Uint8Array<ArrayBufferLike>, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly observations: () => Effect.Effect<import("#rateLimits.ts").RateLimitObservation[], never, never>;
+    readonly resource: (path: string) => Effect.Effect<string, never, never>;
+    readonly text: (path: string, accept: string, limit: number) => Effect.Effect<string, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
 }>> & {
     readonly layer: import("effect/Layer").Layer<"@shivaedev/effect-github/GitHub", never, GitHubToken | HttpClient.HttpClient>;
 };
 export declare function read<TSchema extends Schema.Constraint>(path: string, schema: TSchema): Effect.Effect<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
-export declare function list<TSchema extends Schema.Constraint>(path: string, schema: TSchema): Stream.Stream<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
+export declare function list<TSchema extends Schema.Constraint>(path: string, schema: TSchema): Stream.Stream<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
 export declare function write<TSchema extends Schema.Constraint>(method: "POST" | "PATCH", path: string, body: unknown, schema: TSchema): Effect.Effect<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
 //# sourceMappingURL=GitHub.d.ts.map

package/dist/GitHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GitHub.d.ts","sourceRoot":"","sources":["../src/GitHub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAA8C,MAAM,aAAa,CAAC;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAIjF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,eAAO,MAAM,MAAM;;8DAkBqD,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC;;;;;;;;;;;;;;CAyCxH,CAAC;AAEH,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,wYAEpF;AAED,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,mhBAKpF;AAED,wBAAgB,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,ubAE9H"}
+{"version":3,"file":"GitHub.d.ts","sourceRoot":"","sources":["../src/GitHub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM9C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBjB,CAAC;AAEH,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,wYAEpF;AAED,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,okBAKpF;AAED,wBAAgB,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,ubAE9H"}

package/dist/GitHub.js

@@ -1,12 +1,13 @@
 import { Effect, Schema, Stream } from "effect";
-import { HttpClient, HttpClientRequest } from "effect/http";
+import { HttpClient } from "effect/http";
 import { defineService } from "@shivaedev/effect-service/defineService.ts";
-import { paginate } from "@shivaedev/platform/http-client/paginate.ts";
-import { GitHubConfig } from "./GitHubConfig.js";
-import { GitHubToken } from "./GitHubToken.js";
-import { jsonResponse } from "./json.js";
-import { rateLimits } from "./rateLimits.js";
-import { requests } from "./requests.js";
+import { checkRuns } from "#checkRuns.ts";
+import { GitHubConfig } from "#GitHubConfig.ts";
+import { GitHubToken } from "#GitHubToken.ts";
+import { rateLimits } from "#rateLimits.ts";
+import { representations } from "#representations.ts";
+import { requests } from "#requests.ts";
+import { stickyComments } from "#stickyComments.ts";
 export const GitHub = defineService({
     id: "@shivaedev/effect-github/GitHub",
     initialize: Effect.gen(function* () {
@@ -19,34 +20,15 @@ export const GitHub = defineService({
         };
     }),
     methods: ({ apiUrl, rates, request }) => {
-        function get(path, accept = "application/vnd.github+json") {
-            return HttpClientRequest.get(new URL(path, apiUrl).href, { headers: { Accept: accept } });
-        }
-        function readRepresentation(path) {
-            return Effect.map(request(get(path), 1024 * 1024), jsonResponse);
-        }
-        function listRepresentations(path, beforeRequest) {
-            const entries = new WeakMap();
-            function fetchPage(input) {
-                return (beforeRequest?.(rates.resource(new URL(input.url).pathname)) ?? Effect.void).pipe(Effect.andThen(request(input, 1024 * 1024)), Effect.map((entry) => {
-                    entries.set(entry.response, entry);
-                    return entry.response;
-                }));
-            }
-            const client = HttpClient.makeWith((effect) => Effect.flatMap(effect, fetchPage), Effect.succeed);
-            return Effect.succeed(paginate(client, get(path)).pipe(Stream.mapEffect((response) => Effect.fromNullishOr(entries.get(response))), Stream.map(jsonResponse)));
-        }
-        function writeRepresentation(method, path, body) {
-            return HttpClientRequest.make(method)(new URL(path, apiUrl).href, { headers: { Accept: "application/vnd.github+json" } }).pipe(HttpClientRequest.bodyJson(body), Effect.flatMap((input) => request(input, 1024 * 1024)), Effect.map(jsonResponse));
-        }
+        const { get, ...client } = representations(apiUrl, request, rates.resource);
         return {
             bytes: (path, accept, limit) => Effect.map(request(get(path, accept), limit), (entry) => entry.bytes),
-            list: listRepresentations,
+            ...client,
+            ...stickyComments(client),
+            ...checkRuns(client),
             observations: () => Effect.sync(() => [...rates.observations.values()]),
-            read: readRepresentation,
             resource: (path) => Effect.sync(() => rates.resource(new URL(path, apiUrl).pathname)),
             text: (path, accept, limit) => Effect.map(request(get(path, accept), limit), (entry) => new TextDecoder().decode(entry.bytes)),
-            write: writeRepresentation,
         };
     },
     requires: [HttpClient.HttpClient, GitHubToken],

package/dist/GitHub.js.map

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

package/dist/checkRuns.d.ts

@@ -0,0 +1,104 @@
+import { Effect, Schema } from "effect";
+import type { Representations } from "./representations.ts";
+export declare const CheckRunOutput: Schema.Struct<{
+    readonly summary: Schema.String;
+    readonly text: Schema.optional<Schema.String>;
+    readonly title: Schema.String;
+}>;
+export declare const CheckRunConclusion: Schema.Literals<readonly ["action_required", "cancelled", "failure", "neutral", "success", "skipped", "stale", "timed_out"]>;
+export declare const CheckRunStatus: Schema.Literals<readonly ["queued", "in_progress", "completed"]>;
+export declare const CreateCheckRun: Schema.encodeKeys<Schema.Struct<{
+    readonly conclusion: Schema.optional<Schema.Literals<readonly ["action_required", "cancelled", "failure", "neutral", "success", "skipped", "stale", "timed_out"]>>;
+    readonly headSha: Schema.String;
+    readonly name: Schema.String;
+    readonly output: Schema.optional<Schema.Struct<{
+        readonly summary: Schema.String;
+        readonly text: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>>;
+    readonly status: Schema.Literals<readonly ["queued", "in_progress", "completed"]>;
+}>, {
+    readonly headSha: "head_sha";
+}>;
+export declare const UpdateCheckRun: Schema.Union<readonly [Schema.Struct<{
+    readonly output: Schema.optional<Schema.Struct<{
+        readonly summary: Schema.String;
+        readonly text: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>>;
+    readonly status: Schema.Literals<readonly ["queued", "in_progress"]>;
+}>, Schema.Struct<{
+    readonly conclusion: Schema.Literals<readonly ["action_required", "cancelled", "failure", "neutral", "success", "skipped", "stale", "timed_out"]>;
+    readonly output: Schema.optional<Schema.Struct<{
+        readonly summary: Schema.String;
+        readonly text: Schema.optional<Schema.String>;
+        readonly title: Schema.String;
+    }>>;
+    readonly status: Schema.Literal<"completed">;
+}>]>;
+export declare const CheckRun: Schema.encodeKeys<Schema.Struct<{
+    readonly conclusion: Schema.NullOr<Schema.Literals<readonly ["action_required", "cancelled", "failure", "neutral", "success", "skipped", "stale", "timed_out"]>>;
+    readonly headSha: Schema.String;
+    readonly id: Schema.Number;
+    readonly name: Schema.String;
+    readonly output: Schema.Struct<{
+        readonly summary: Schema.NullOr<Schema.String>;
+        readonly text: Schema.NullOr<Schema.String>;
+        readonly title: Schema.NullOr<Schema.String>;
+    }>;
+    readonly status: Schema.Literals<readonly ["queued", "in_progress", "completed"]>;
+}>, {
+    readonly headSha: "head_sha";
+}>;
+export declare function checkRuns(client: Representations): {
+    createCheckRun: (owner: string, repo: string, input: {
+        readonly conclusion?: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out" | undefined;
+        readonly headSha: string;
+        readonly name: string;
+        readonly output?: {
+            readonly summary: string;
+            readonly text?: string | undefined;
+            readonly title: string;
+        } | undefined;
+        readonly status: "completed" | "in_progress" | "queued";
+    }) => Effect.Effect<{
+        readonly conclusion: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out" | null;
+        readonly headSha: string;
+        readonly id: number;
+        readonly name: string;
+        readonly output: {
+            readonly summary: string | null;
+            readonly text: string | null;
+            readonly title: string | null;
+        };
+        readonly status: "completed" | "in_progress" | "queued";
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    updateCheckRun: (owner: string, repo: string, id: number, input: {
+        readonly output?: {
+            readonly summary: string;
+            readonly text?: string | undefined;
+            readonly title: string;
+        } | undefined;
+        readonly status: "in_progress" | "queued";
+    } | {
+        readonly conclusion: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out";
+        readonly output?: {
+            readonly summary: string;
+            readonly text?: string | undefined;
+            readonly title: string;
+        } | undefined;
+        readonly status: "completed";
+    }) => Effect.Effect<{
+        readonly conclusion: "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "stale" | "success" | "timed_out" | null;
+        readonly headSha: string;
+        readonly id: number;
+        readonly name: string;
+        readonly output: {
+            readonly summary: string | null;
+            readonly text: string | null;
+            readonly title: string | null;
+        };
+        readonly status: "completed" | "in_progress" | "queued";
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+};
+//# sourceMappingURL=checkRuns.d.ts.map

package/dist/checkRuns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkRuns.d.ts","sourceRoot":"","sources":["../src/checkRuns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;EAIzB,CAAC;AAEH,eAAO,MAAM,kBAAkB,8HAAsH,CAAC;AACtJ,eAAO,MAAM,cAAc,kEAA0D,CAAC;AAEtF,eAAO,MAAM,cAAc;;;;;;;;;;;;EAMwB,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;IAGzB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;EAO8B,CAAC;AAEpD,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe;IAE/C,cAAc;;;;;;;;;;;;;;;;;;;;;;IAKd,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMf"}

package/dist/checkRuns.js

@@ -0,0 +1,42 @@
+import { Effect, Schema } from "effect";
+export const CheckRunOutput = Schema.Struct({
+    summary: Schema.String,
+    text: Schema.optional(Schema.String),
+    title: Schema.String,
+});
+export const CheckRunConclusion = Schema.Literals(["action_required", "cancelled", "failure", "neutral", "success", "skipped", "stale", "timed_out"]);
+export const CheckRunStatus = Schema.Literals(["queued", "in_progress", "completed"]);
+export const CreateCheckRun = Schema.Struct({
+    conclusion: Schema.optional(CheckRunConclusion),
+    headSha: Schema.String,
+    name: Schema.String,
+    output: Schema.optional(CheckRunOutput),
+    status: CheckRunStatus,
+}).pipe(Schema.encodeKeys({ headSha: "head_sha" }));
+export const UpdateCheckRun = Schema.Union([
+    Schema.Struct({ output: Schema.optional(CheckRunOutput), status: Schema.Literals(["queued", "in_progress"]) }),
+    Schema.Struct({ conclusion: CheckRunConclusion, output: Schema.optional(CheckRunOutput), status: Schema.Literal("completed") }),
+]);
+export const CheckRun = Schema.Struct({
+    conclusion: Schema.NullOr(CheckRunConclusion),
+    headSha: Schema.String,
+    id: Schema.Number,
+    name: Schema.String,
+    output: Schema.Struct({ summary: Schema.NullOr(Schema.String), text: Schema.NullOr(Schema.String), title: Schema.NullOr(Schema.String) }),
+    status: CheckRunStatus,
+}).pipe(Schema.encodeKeys({ headSha: "head_sha" }));
+export function checkRuns(client) {
+    return {
+        createCheckRun: Effect.fn("GitHub.createCheckRun")(function* (owner, repo, input) {
+            const body = yield* Schema.encodeEffect(CreateCheckRun)(input);
+            const response = yield* client.write("POST", `/repos/${owner}/${repo}/check-runs`, body);
+            return yield* response.decode(CheckRun);
+        }),
+        updateCheckRun: Effect.fn("GitHub.updateCheckRun")(function* (owner, repo, id, input) {
+            const body = yield* Schema.encodeEffect(UpdateCheckRun)(input);
+            const response = yield* client.write("PATCH", `/repos/${owner}/${repo}/check-runs/${id}`, body);
+            return yield* response.decode(CheckRun);
+        }),
+    };
+}
+//# sourceMappingURL=checkRuns.js.map

package/dist/checkRuns.js.map

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

package/dist/representations.d.ts

@@ -0,0 +1,18 @@
+import { Effect, Stream } from "effect";
+import { HttpClientRequest } from "effect/http";
+import type { ServiceUnavailable } from "@shivaedev/platform/errors/taxonomy.ts";
+import type { requests } from "#requests.ts";
+export declare function representations(apiUrl: string, request: ReturnType<typeof requests>, resource: (path: string) => string): {
+    get: (path: string, accept?: string) => HttpClientRequest.HttpClientRequest;
+    list: (path: string, beforeRequest?: (resource: string) => Effect.Effect<void, ServiceUnavailable>) => Effect.Effect<Stream.Stream<{
+        decode: <TSchema extends import("effect/Schema").Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], import("effect/Schema").SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>, never, never>;
+    read: (path: string) => Effect.Effect<{
+        decode: <TSchema extends import("effect/Schema").Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], import("effect/Schema").SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    write: (method: "POST" | "PATCH", path: string, body: unknown) => Effect.Effect<{
+        decode: <TSchema extends import("effect/Schema").Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], import("effect/Schema").SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+};
+export type Representations = Omit<ReturnType<typeof representations>, "get">;
+//# sourceMappingURL=representations.d.ts.map

package/dist/representations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"representations.d.ts","sourceRoot":"","sources":["../src/representations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAc,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAIjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;gBACpG,MAAM;iBAMU,MAAM,kBAAkB,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC;;;iBAHtF,MAAM;;;oBAyBH,MAAM,GAAG,OAAO,QAAQ,MAAM,QAAQ,OAAO;;;EAQlF;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/dist/representations.js

@@ -0,0 +1,28 @@
+import { Effect, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/http";
+import { paginate } from "@shivaedev/platform/http-client/paginate.ts";
+import { jsonResponse } from "#json.ts";
+export function representations(apiUrl, request, resource) {
+    function get(path, accept = "application/vnd.github+json") {
+        return HttpClientRequest.get(new URL(path, apiUrl).href, { headers: { Accept: accept } });
+    }
+    function readRepresentation(path) {
+        return Effect.map(request(get(path), 1024 * 1024), jsonResponse);
+    }
+    function listRepresentations(path, beforeRequest) {
+        const entries = new WeakMap();
+        function fetchPage(input) {
+            return (beforeRequest?.(resource(new URL(input.url).pathname)) ?? Effect.void).pipe(Effect.andThen(request(input, 1024 * 1024)), Effect.map((entry) => {
+                entries.set(entry.response, entry);
+                return entry.response;
+            }));
+        }
+        const client = HttpClient.makeWith((effect) => Effect.flatMap(effect, fetchPage), Effect.succeed);
+        return Effect.succeed(paginate(client, get(path)).pipe(Stream.mapEffect((response) => Effect.fromNullishOr(entries.get(response))), Stream.map(jsonResponse)));
+    }
+    function writeRepresentation(method, path, body) {
+        return HttpClientRequest.make(method)(new URL(path, apiUrl).href, { headers: { Accept: "application/vnd.github+json" } }).pipe(HttpClientRequest.bodyJson(body), Effect.flatMap((input) => request(input, 1024 * 1024)), Effect.map(jsonResponse));
+    }
+    return { get, list: listRepresentations, read: readRepresentation, write: writeRepresentation };
+}
+//# sourceMappingURL=representations.js.map

package/dist/representations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"representations.js","sourceRoot":"","sources":["../src/representations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAAoC,EAAE,QAAkC;IACvH,SAAS,GAAG,CAAC,IAAY,EAAE,MAAM,GAAG,6BAA6B;QAChE,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,SAAS,kBAAkB,CAAC,IAAY;QACvC,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IACD,SAAS,mBAAmB,CAAC,IAAY,EAAE,aAA6E;QACvH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyD,CAAC;QACrF,SAAS,SAAS,CAAC,KAA0C;YAC5D,OAAO,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAClF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,EAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACnC,OAAO,KAAK,CAAC,QAAQ,CAAC;YACvB,CAAC,CAAC,CACF,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CACjC,CAAC,MAA0D,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EACjG,MAAM,CAAC,OAAO,CACd,CAAC;QACF,OAAO,MAAM,CAAC,OAAO,CACpB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAC/B,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC3E,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CACxB,CACD,CAAC;IACH,CAAC;IACD,SAAS,mBAAmB,CAAC,MAAwB,EAAE,IAAY,EAAE,IAAa;QACjF,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,EAAE,CAAC,CAAC,IAAI,CAC7H,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,EACtD,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CACxB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;AACjG,CAAC"}

package/dist/stickyComments.d.ts

@@ -0,0 +1,34 @@
+import { Effect, Schema } from "effect";
+import type { Representations } from "./representations.ts";
+export declare const PullRequestComment: Schema.Struct<{
+    readonly body: Schema.String;
+    readonly id: Schema.Number;
+    readonly user: Schema.NullOr<Schema.Struct<{
+        readonly login: Schema.String;
+    }>>;
+}>;
+export declare const StickyComment: Schema.Struct<{
+    readonly author: Schema.optional<Schema.String>;
+    readonly body: Schema.String;
+    readonly marker: Schema.String;
+    readonly number: Schema.Number;
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>;
+export declare function stickyComments(client: Representations): {
+    upsertStickyComment: (input: {
+        readonly author?: string | undefined;
+        readonly body: string;
+        readonly marker: string;
+        readonly number: number;
+        readonly owner: string;
+        readonly repo: string;
+    }) => Effect.Effect<{
+        readonly body: string;
+        readonly id: number;
+        readonly user: {
+            readonly login: string;
+        } | null;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+};
+//# sourceMappingURL=stickyComments.d.ts.map

package/dist/stickyComments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickyComments.d.ts","sourceRoot":"","sources":["../src/stickyComments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAU,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;EAI7B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;EAOxB,CAAC;AAIH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe;IAEpD,mBAAmB;;;;;;;;;;;;;;EAkBpB"}

package/dist/stickyComments.js

@@ -0,0 +1,32 @@
+import { Effect, Option, Schema, Stream } from "effect";
+export const PullRequestComment = Schema.Struct({
+    body: Schema.String,
+    id: Schema.Number,
+    user: Schema.NullOr(Schema.Struct({ login: Schema.String })),
+});
+export const StickyComment = Schema.Struct({
+    author: Schema.optional(Schema.String),
+    body: Schema.String,
+    marker: Schema.String,
+    number: Schema.Number,
+    owner: Schema.String,
+    repo: Schema.String,
+});
+const CommentBody = Schema.Struct({ body: Schema.String });
+export function stickyComments(client) {
+    return {
+        upsertStickyComment: Effect.fn("GitHub.upsertStickyComment")(function* (input) {
+            const { owner, repo, number, marker, body, author } = yield* Schema.decodeUnknownEffect(StickyComment)(input);
+            const hiddenMarker = `<!-- ${marker} -->`;
+            const root = `/repos/${owner}/${repo}/issues`;
+            const pages = yield* client.list(`${root}/${number}/comments`);
+            const existing = yield* pages.pipe(Stream.mapEffect((page) => page.decode(Schema.Array(PullRequestComment))), Stream.flatMap(Stream.fromIterable), Stream.filter((comment) => comment.body.includes(hiddenMarker) && (author === undefined || comment.user?.login === author)), Stream.runHead);
+            const payload = yield* Schema.encodeEffect(CommentBody)({ body: `${hiddenMarker}\n${body}` });
+            const response = yield* Option.isSome(existing)
+                ? client.write("PATCH", `${root}/comments/${existing.value.id}`, payload)
+                : client.write("POST", `${root}/${number}/comments`, payload);
+            return yield* response.decode(PullRequestComment);
+        }),
+    };
+}
+//# sourceMappingURL=stickyComments.js.map

package/dist/stickyComments.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/effect-github",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Typed GitHub REST requests, conditional reads and resource budgets for Effect applications",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/effect-github#readme",
   "bugs": {
@@ -40,14 +40,14 @@
   ],
   "dependencies": {
     "@shivaedev/effect-service": "0.4.1",
-    "@shivaedev/platform": "0.28.0"
+    "@shivaedev/platform": "0.28.1"
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.5",
     "@effect/platform-node-shared": "4.0.5",
     "@effect/vitest": "4.0.5",
     "@shivaedev/effect-test": "0.8.1",
-    "@shivaedev/quality": "0.38.0",
+    "@shivaedev/quality": "0.39.0",
     "@shivaedev/test-story": "0.19.0",
     "@types/node": "24.19.2",
     "effect": "4.0.5",

package/src/GitHub.ts

@@ -1,14 +1,13 @@
 import { Effect, Schema, Stream } from "effect";
-import { HttpClient, HttpClientRequest, type HttpClientResponse } from "effect/http";
+import { HttpClient } from "effect/http";
 import { defineService } from "@shivaedev/effect-service/defineService.ts";
-import type { ServiceUnavailable } from "@shivaedev/platform/errors/taxonomy.ts";
-import { paginate } from "@shivaedev/platform/http-client/paginate.ts";
-import type { CachedResponse } from "./cache.ts";
-import { GitHubConfig } from "./GitHubConfig.ts";
-import { GitHubToken } from "./GitHubToken.ts";
-import { jsonResponse } from "./json.ts";
-import { rateLimits } from "./rateLimits.ts";
-import { requests } from "./requests.ts";
+import { checkRuns } from "#checkRuns.ts";
+import { GitHubConfig } from "#GitHubConfig.ts";
+import { GitHubToken } from "#GitHubToken.ts";
+import { rateLimits } from "#rateLimits.ts";
+import { representations } from "#representations.ts";
+import { requests } from "#requests.ts";
+import { stickyComments } from "#stickyComments.ts";
 
 export const GitHub = defineService({
 	id: "@shivaedev/effect-github/GitHub",
@@ -22,50 +21,16 @@ export const GitHub = defineService({
 		};
 	}),
 	methods: ({ apiUrl, rates, request }) => {
-		function get(path: string, accept = "application/vnd.github+json") {
-			return HttpClientRequest.get(new URL(path, apiUrl).href, { headers: { Accept: accept } });
-		}
-		function readRepresentation(path: string) {
-			return Effect.map(request(get(path), 1024 * 1024), jsonResponse);
-		}
-		function listRepresentations(path: string, beforeRequest?: (resource: string) => Effect.Effect<void, ServiceUnavailable>) {
-			const entries = new WeakMap<HttpClientResponse.HttpClientResponse, CachedResponse>();
-			function fetchPage(input: HttpClientRequest.HttpClientRequest) {
-				return (beforeRequest?.(rates.resource(new URL(input.url).pathname)) ?? Effect.void).pipe(
-					Effect.andThen(request(input, 1024 * 1024)),
-					Effect.map((entry) => {
-						entries.set(entry.response, entry);
-						return entry.response;
-					}),
-				);
-			}
-			const client = HttpClient.makeWith(
-				(effect: Effect.Effect<HttpClientRequest.HttpClientRequest>) => Effect.flatMap(effect, fetchPage),
-				Effect.succeed,
-			);
-			return Effect.succeed(
-				paginate(client, get(path)).pipe(
-					Stream.mapEffect((response) => Effect.fromNullishOr(entries.get(response))),
-					Stream.map(jsonResponse),
-				),
-			);
-		}
-		function writeRepresentation(method: "POST" | "PATCH", path: string, body: unknown) {
-			return HttpClientRequest.make(method)(new URL(path, apiUrl).href, { headers: { Accept: "application/vnd.github+json" } }).pipe(
-				HttpClientRequest.bodyJson(body),
-				Effect.flatMap((input) => request(input, 1024 * 1024)),
-				Effect.map(jsonResponse),
-			);
-		}
+		const { get, ...client } = representations(apiUrl, request, rates.resource);
 		return {
 			bytes: (path: string, accept: string, limit: number) => Effect.map(request(get(path, accept), limit), (entry) => entry.bytes),
-			list: listRepresentations,
+			...client,
+			...stickyComments(client),
+			...checkRuns(client),
 			observations: () => Effect.sync(() => [...rates.observations.values()]),
-			read: readRepresentation,
 			resource: (path: string) => Effect.sync(() => rates.resource(new URL(path, apiUrl).pathname)),
 			text: (path: string, accept: string, limit: number) =>
 				Effect.map(request(get(path, accept), limit), (entry) => new TextDecoder().decode(entry.bytes)),
-			write: writeRepresentation,
 		};
 	},
 	requires: [HttpClient.HttpClient, GitHubToken],

package/src/checkRuns.ts

@@ -0,0 +1,48 @@
+import { Effect, Schema } from "effect";
+import type { Representations } from "./representations.ts";
+
+export const CheckRunOutput = Schema.Struct({
+	summary: Schema.String,
+	text: Schema.optional(Schema.String),
+	title: Schema.String,
+});
+
+export const CheckRunConclusion = Schema.Literals(["action_required", "cancelled", "failure", "neutral", "success", "skipped", "stale", "timed_out"]);
+export const CheckRunStatus = Schema.Literals(["queued", "in_progress", "completed"]);
+
+export const CreateCheckRun = Schema.Struct({
+	conclusion: Schema.optional(CheckRunConclusion),
+	headSha: Schema.String,
+	name: Schema.String,
+	output: Schema.optional(CheckRunOutput),
+	status: CheckRunStatus,
+}).pipe(Schema.encodeKeys({ headSha: "head_sha" }));
+
+export const UpdateCheckRun = Schema.Union([
+	Schema.Struct({ output: Schema.optional(CheckRunOutput), status: Schema.Literals(["queued", "in_progress"]) }),
+	Schema.Struct({ conclusion: CheckRunConclusion, output: Schema.optional(CheckRunOutput), status: Schema.Literal("completed") }),
+]);
+
+export const CheckRun = Schema.Struct({
+	conclusion: Schema.NullOr(CheckRunConclusion),
+	headSha: Schema.String,
+	id: Schema.Number,
+	name: Schema.String,
+	output: Schema.Struct({ summary: Schema.NullOr(Schema.String), text: Schema.NullOr(Schema.String), title: Schema.NullOr(Schema.String) }),
+	status: CheckRunStatus,
+}).pipe(Schema.encodeKeys({ headSha: "head_sha" }));
+
+export function checkRuns(client: Representations) {
+	return {
+		createCheckRun: Effect.fn("GitHub.createCheckRun")(function* (owner: string, repo: string, input: typeof CreateCheckRun.Type) {
+			const body = yield* Schema.encodeEffect(CreateCheckRun)(input);
+			const response = yield* client.write("POST", `/repos/${owner}/${repo}/check-runs`, body);
+			return yield* response.decode(CheckRun);
+		}),
+		updateCheckRun: Effect.fn("GitHub.updateCheckRun")(function* (owner: string, repo: string, id: number, input: typeof UpdateCheckRun.Type) {
+			const body = yield* Schema.encodeEffect(UpdateCheckRun)(input);
+			const response = yield* client.write("PATCH", `/repos/${owner}/${repo}/check-runs/${id}`, body);
+			return yield* response.decode(CheckRun);
+		}),
+	};
+}

package/src/representations.ts

@@ -0,0 +1,48 @@
+import { Effect, Stream } from "effect";
+import { HttpClient, HttpClientRequest, type HttpClientResponse } from "effect/http";
+import type { ServiceUnavailable } from "@shivaedev/platform/errors/taxonomy.ts";
+import { paginate } from "@shivaedev/platform/http-client/paginate.ts";
+import type { CachedResponse } from "#cache.ts";
+import { jsonResponse } from "#json.ts";
+import type { requests } from "#requests.ts";
+
+export function representations(apiUrl: string, request: ReturnType<typeof requests>, resource: (path: string) => string) {
+	function get(path: string, accept = "application/vnd.github+json") {
+		return HttpClientRequest.get(new URL(path, apiUrl).href, { headers: { Accept: accept } });
+	}
+	function readRepresentation(path: string) {
+		return Effect.map(request(get(path), 1024 * 1024), jsonResponse);
+	}
+	function listRepresentations(path: string, beforeRequest?: (resource: string) => Effect.Effect<void, ServiceUnavailable>) {
+		const entries = new WeakMap<HttpClientResponse.HttpClientResponse, CachedResponse>();
+		function fetchPage(input: HttpClientRequest.HttpClientRequest) {
+			return (beforeRequest?.(resource(new URL(input.url).pathname)) ?? Effect.void).pipe(
+				Effect.andThen(request(input, 1024 * 1024)),
+				Effect.map((entry) => {
+					entries.set(entry.response, entry);
+					return entry.response;
+				}),
+			);
+		}
+		const client = HttpClient.makeWith(
+			(effect: Effect.Effect<HttpClientRequest.HttpClientRequest>) => Effect.flatMap(effect, fetchPage),
+			Effect.succeed,
+		);
+		return Effect.succeed(
+			paginate(client, get(path)).pipe(
+				Stream.mapEffect((response) => Effect.fromNullishOr(entries.get(response))),
+				Stream.map(jsonResponse),
+			),
+		);
+	}
+	function writeRepresentation(method: "POST" | "PATCH", path: string, body: unknown) {
+		return HttpClientRequest.make(method)(new URL(path, apiUrl).href, { headers: { Accept: "application/vnd.github+json" } }).pipe(
+			HttpClientRequest.bodyJson(body),
+			Effect.flatMap((input) => request(input, 1024 * 1024)),
+			Effect.map(jsonResponse),
+		);
+	}
+	return { get, list: listRepresentations, read: readRepresentation, write: writeRepresentation };
+}
+
+export type Representations = Omit<ReturnType<typeof representations>, "get">;

package/src/stickyComments.ts

@@ -0,0 +1,41 @@
+import { Effect, Option, Schema, Stream } from "effect";
+import type { Representations } from "./representations.ts";
+
+export const PullRequestComment = Schema.Struct({
+	body: Schema.String,
+	id: Schema.Number,
+	user: Schema.NullOr(Schema.Struct({ login: Schema.String })),
+});
+
+export const StickyComment = Schema.Struct({
+	author: Schema.optional(Schema.String),
+	body: Schema.String,
+	marker: Schema.String,
+	number: Schema.Number,
+	owner: Schema.String,
+	repo: Schema.String,
+});
+
+const CommentBody = Schema.Struct({ body: Schema.String });
+
+export function stickyComments(client: Representations) {
+	return {
+		upsertStickyComment: Effect.fn("GitHub.upsertStickyComment")(function* (input: typeof StickyComment.Type) {
+			const { owner, repo, number, marker, body, author } = yield* Schema.decodeUnknownEffect(StickyComment)(input);
+			const hiddenMarker = `<!-- ${marker} -->`;
+			const root = `/repos/${owner}/${repo}/issues`;
+			const pages = yield* client.list(`${root}/${number}/comments`);
+			const existing = yield* pages.pipe(
+				Stream.mapEffect((page) => page.decode(Schema.Array(PullRequestComment))),
+				Stream.flatMap(Stream.fromIterable),
+				Stream.filter((comment) => comment.body.includes(hiddenMarker) && (author === undefined || comment.user?.login === author)),
+				Stream.runHead,
+			);
+			const payload = yield* Schema.encodeEffect(CommentBody)({ body: `${hiddenMarker}\n${body}` });
+			const response = yield* Option.isSome(existing)
+				? client.write("PATCH", `${root}/comments/${existing.value.id}`, payload)
+				: client.write("POST", `${root}/${number}/comments`, payload);
+			return yield* response.decode(PullRequestComment);
+		}),
+	};
+}