feat(pull-requests): discover native Gitea fork capabilities

apps/server/src/pullRequest/GiteaConversation.test.ts

@@ -12,7 +12,7 @@ describe("GiteaConversation", () => {
   it("addresses ordinary and inline review remarks through the same issue-comment record", () => {
     expect(editableCommentId("issue:12")).toBe("12");
     expect(editableCommentId("review-comment:34")).toBe("34");
-    expect(reactionTarget("review:56")).toBeNull();
+    expect(reactionTarget("review:56")).toEqual({ kind: "review", id: "56" });
   });
 
   it("distinguishes a pull request description from a comment and rejects malformed ids", () => {

apps/server/src/pullRequest/GiteaConversation.ts

@@ -13,7 +13,8 @@ export const RawGiteaReaction = Schema.Struct({
 
 export type GiteaConversationReactionTarget =
   | { readonly kind: "pull-request" }
-  | { readonly kind: "comment"; readonly id: string };
+  | { readonly kind: "comment"; readonly id: string }
+  | { readonly kind: "review"; readonly id: string };
 
 const reactionContent = new Map<string, PullRequestReactionContent>([
   ["+1", "thumbs-up"],
@@ -38,14 +39,17 @@ function commentId(subjectId: string): string | null {
 
 /**
  * Gitea stores inline review remarks as issue comments. Review summaries use a separate Review
- * record, for which v1.27.3 intentionally exposes neither an edit nor a reaction endpoint.
+ * record, which the companion server extension exposes through a separate route.
  */
 export function reactionTarget(
   subjectId: string | undefined,
 ): GiteaConversationReactionTarget | null {
   if (subjectId === undefined) return { kind: "pull-request" };
-  const id = commentId(subjectId);
-  return id === null ? null : { kind: "comment", id };
+  const [kind, reviewId] = subjectId.split(":", 2);
+  if (kind === "review" && reviewId && /^\d+$/.test(reviewId))
+    return { kind: "review", id: reviewId };
+  const comment = commentId(subjectId);
+  return comment === null ? null : { kind: "comment", id: comment };
 }
 
 /** Returns the native issue-comment ID for both ordinary and inline-review remarks. */

apps/server/src/pullRequest/GiteaForkCapabilities.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "@effect/vitest";
+import type { PullRequestCapabilities } from "@t3tools/contracts";
+
+import { giteaForkCapabilities } from "./GiteaForkCapabilities.ts";
+
+const base: PullRequestCapabilities = {
+  diff: true,
+  comment: true,
+  actions: [],
+  mergeMethods: [],
+  search: false,
+  reactions: false,
+  reactionSubjects: {
+    changeRequest: true,
+    issueComment: true,
+    reviewComment: true,
+    review: false,
+  },
+  review: { inlineComment: true, reply: true, resolve: true, verdicts: [] },
+  reviewers: { request: true, listCandidates: true },
+};
+
+describe("GiteaForkCapabilities", () => {
+  it("enables review-summary reactions only for an advertising server", () => {
+    expect(giteaForkCapabilities(base, []).reactionSubjects?.review).toBe(false);
+    expect(giteaForkCapabilities(base, ["pull-review-reactions"]).reactionSubjects?.review).toBe(
+      true,
+    );
+    expect(base.reactionSubjects?.review).toBe(false);
+  });
+});

apps/server/src/pullRequest/GiteaForkCapabilities.ts

@@ -0,0 +1,15 @@
+import type { PullRequestCapabilities } from "@t3tools/contracts";
+
+/** Capabilities added by the companion Gitea API extension, discovered lazily per server. */
+export function giteaForkCapabilities(
+  base: PullRequestCapabilities,
+  features: ReadonlyArray<string>,
+): PullRequestCapabilities {
+  return features.includes("pull-review-reactions")
+    ? { ...base, reactionSubjects: { ...base.reactionSubjects!, review: true } }
+    : base;
+}
+
+export function giteaHasFeature(features: ReadonlyArray<string>, feature: string): boolean {
+  return features.includes(feature);
+}