feat(forge): pluggable forge abstraction + GitLab and Gitea/Forgejo/Codeberg (#1913)

* refactor(forge): forge-neutral foundation (GitHub-only)

Decouple git-hosting from GitHub behind a neutral abstraction (issue #1616), GitHub-only for now; existing GitHub behaviour is unchanged.

- Forge manifest, neutral ForgeService contract, forge registry + resolver, and a client forge-module registry.
- GitHub code renamed to the neutral shape; PR/Issue attachment wording preserved.
- forge.search.response enums parse tolerantly (unknown kind/auth state degrade instead of breaking the client).
- createPullRequest reports typed CLI/auth errors instead of a generic message.
- forge-resolver host/remote caches are LRU-bounded.
- Forge host trust is explicit: only a known cloud host or a CLI-authenticated host is ever talked to; an unauthenticated GitHub Enterprise host fails resolution instead of routing to github.com.
- Docs: forge-providers guide, glossary and i18n forge-copy conventions, architecture and rpc-namespacing terminology.
- Vitest React Native mocks (unistyles, svg, linking, lucide) consolidated into shared aliased test-stubs.

* feat(forge): GitLab adapter, forge-aware UI, pipelines and approvals

GitLab adapter over the glab CLI on the neutral contracts: MR status, forge-aware UI, pipeline tree, and N-of-M approvals.

- threadIsResolved is part of the neutral timeline item.
- Pipeline load failures show an error instead of an empty section.
- Manual pipeline jobs render as pending.
- Fork/detached MR head pipelines are fetched by MR iid (glab ci get --merge-request).

* feat(forge): Gitea family adapter (Gitea, Forgejo, Codeberg)

One adapter over the tea CLI serving Gitea, Forgejo, and Codeberg on the neutral contracts.

- CI status aggregates commit statuses and Actions runs together.
- Gitea's terminal "warning" state maps to failure on server and client.
- Gitea Actions check details are reachable from the PR pane by workflowRunId.

* refactor(forge): localize compatibility handling

* test(forge): expect normalized GitLab facts

---------

Co-authored-by: Mohamed Boudra <boudra.moha@gmail.com>

packages/app/src/composer/github/auto-attach.test.tsx

@@ -7,17 +7,17 @@ import React, { type ReactNode } from "react";
 import { useState } from "react";
 import { describe, expect, it, vi } from "vitest";
 import type { UserComposerAttachment } from "@/attachments/types";
-import type { GitHubSearchClient } from "@/git/use-github-search-query";
-import type { GitHubSearchItem, GitHubSearchResponse } from "@getpaseo/protocol/messages";
+import type { ForgeSearchClient } from "@/git/use-forge-search-query";
+import type { ForgeSearchItem, ForgeSearchResponse } from "@getpaseo/protocol/messages";
 import { useComposerGithubAutoAttach } from "./auto-attach";
 
-type GitHubSearchPayload = GitHubSearchResponse["payload"];
+type ForgeSearchPayload = ForgeSearchResponse["payload"];
 
 const remoteUrl = "git@github.com:acme/paseo.git";
 const cwd = "/repo";
 
-const pr101: GitHubSearchItem = {
-  kind: "pr",
+const pr101: ForgeSearchItem = {
+  kind: "change_request",
   number: 101,
   title: "Attach PR",
   url: "https://github.com/acme/paseo/pull/101",
@@ -28,7 +28,7 @@ const pr101: GitHubSearchItem = {
   headRefName: "feature",
 };
 
-const issue202: GitHubSearchItem = {
+const issue202: ForgeSearchItem = {
   kind: "issue",
   number: 202,
   title: "Attach issue",
@@ -52,22 +52,20 @@ interface HarnessInput {
   remote?: string | null;
 }
 
-function githubPayload(items: GitHubSearchItem[], requestId: string): GitHubSearchPayload {
+function githubPayload(items: ForgeSearchItem[], requestId: string): ForgeSearchPayload {
   return {
     items,
-    githubFeaturesEnabled: true,
+    authState: "authenticated",
     error: null,
     requestId,
   };
 }
 
-function createSearchClient(
-  items: GitHubSearchItem[],
-): GitHubSearchClient & { calls: SearchCall[] } {
+function createSearchClient(items: ForgeSearchItem[]): ForgeSearchClient & { calls: SearchCall[] } {
   const calls: SearchCall[] = [];
   return {
     calls,
-    async searchGitHub(options) {
+    async searchForge(options) {
       calls.push(options);
       return githubPayload(items, `search-${options.query}`);
     },
@@ -87,7 +85,7 @@ function createWrapper() {
   };
 }
 
-function useHarness(client: GitHubSearchClient, input: HarnessInput = {}) {
+function useHarness(client: ForgeSearchClient, input: HarnessInput = {}) {
   const [text, setText] = useState(input.initialText ?? "");
   const [attachments, setAttachments] = useState<UserComposerAttachment[]>(
     input.initialAttachments ?? [],
@@ -130,7 +128,7 @@ describe("useComposerGithubAutoAttach", () => {
     });
     await flushDebounce();
 
-    expect(result.current.attachments).toEqual([{ kind: "github_pr", item: pr101 }]);
+    expect(result.current.attachments).toEqual([{ kind: "forge_change_request", item: pr101 }]);
     expect(client.calls).toEqual([{ cwd, query: "101", limit: 20 }]);
     vi.useRealTimers();
   });
@@ -201,8 +199,8 @@ describe("useComposerGithubAutoAttach", () => {
     await flushDebounce();
 
     expect(result.current.attachments).toEqual([
-      { kind: "github_pr", item: pr101 },
-      { kind: "github_issue", item: issue202 },
+      { kind: "forge_change_request", item: pr101 },
+      { kind: "forge_issue", item: issue202 },
     ]);
     expect(client.calls).toEqual([
       { cwd, query: "101", limit: 20 },

packages/app/src/composer/github/auto-attach.ts

@@ -9,12 +9,9 @@ import {
   type SetStateAction,
 } from "react";
 import type { ComposerAttachment, UserComposerAttachment } from "@/attachments/types";
-import {
-  buildGithubSearchQueryOptions,
-  type GitHubSearchClient,
-} from "@/git/use-github-search-query";
+import { buildForgeSearchQueryOptions, type ForgeSearchClient } from "@/git/use-forge-search-query";
 import { extractGithubRefs, type GithubRef } from "@/utils/github-refs";
-import type { GitHubSearchItem } from "@getpaseo/protocol/messages";
+import type { ForgeSearchItem } from "@getpaseo/protocol/messages";
 import { isAttachmentSelectedForGithubItem, toggleGithubAttachment } from "../actions";
 
 const AUTO_ATTACH_DEBOUNCE_MS = 300;
@@ -23,10 +20,11 @@ interface ComposerGithubAutoAttachInput {
   text: string;
   remoteUrl: string | null | undefined;
   attachments: UserComposerAttachment[];
-  client: GitHubSearchClient | null;
+  client: ForgeSearchClient | null;
   isConnected: boolean;
   serverId: string;
   cwd: string;
+  supportsForgeSearch?: boolean;
   setAttachments: Dispatch<SetStateAction<UserComposerAttachment[]>>;
 }
 
@@ -75,6 +73,7 @@ export function useComposerGithubAutoAttach(
     params.isConnected,
     params.serverId,
     params.cwd,
+    params.supportsForgeSearch,
     queryClient,
   ]);
 
@@ -193,11 +192,12 @@ async function fetchGithubRefSearch({
 
   try {
     return await queryClient.fetchQuery(
-      buildGithubSearchQueryOptions({
+      buildForgeSearchQueryOptions({
         client: snapshot.client,
         serverId: snapshot.serverId,
         cwd: snapshot.cwd,
         query: String(ref.number),
+        supportsForgeSearch: snapshot.supportsForgeSearch,
         enabled: true,
       }),
     );
@@ -216,12 +216,12 @@ function hasGithubAttachment(attachments: UserComposerAttachment[], ref: GithubR
   return attachments.some((attachment) => attachmentKey(attachment) === githubRefKey(ref));
 }
 
-function githubItemMatchesRef(item: GitHubSearchItem, ref: GithubRef): boolean {
+function githubItemMatchesRef(item: ForgeSearchItem, ref: GithubRef): boolean {
   return item.kind === githubItemKind(ref) && item.number === ref.number;
 }
 
-function githubItemKind(ref: GithubRef): GitHubSearchItem["kind"] {
-  return ref.kind === "pull" ? "pr" : "issue";
+function githubItemKind(ref: GithubRef): ForgeSearchItem["kind"] {
+  return ref.kind === "pull" ? "change_request" : "issue";
 }
 
 function githubRefKey(ref: GithubRef): string {
@@ -232,7 +232,10 @@ function attachmentKey(attachment: ComposerAttachment | undefined): string | nul
   if (
     !attachment ||
     attachment.kind === "image" ||
-    (attachment.kind !== "github_pr" && attachment.kind !== "github_issue")
+    (attachment.kind !== "forge_change_request" &&
+      attachment.kind !== "forge_issue" &&
+      attachment.kind !== "github_pr" &&
+      attachment.kind !== "github_issue")
   ) {
     return null;
   }