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/workspace/open-target-planner.test.ts

@@ -135,7 +135,8 @@ describe("planWorkspaceOpenTargets", () => {
 
     expect(blobTargets).toEqual([
       {
-        source: "github",
+        source: "forge",
+        forge: "github",
         id: "github",
         label: "GitHub",
         url: "https://github.com/getpaseo/paseo/blob/main/src/app.ts#L3-L5",
@@ -143,7 +144,8 @@ describe("planWorkspaceOpenTargets", () => {
     ]);
     expect(treeTargets).toEqual([
       {
-        source: "github",
+        source: "forge",
+        forge: "github",
         id: "github",
         label: "GitHub",
         url: "https://github.com/getpaseo/paseo/tree/main",
@@ -151,6 +153,32 @@ describe("planWorkspaceOpenTargets", () => {
     ]);
   });
 
+  it("infers the forge from the remote URL when the forge input is null", () => {
+    const targets = planWorkspaceOpenTargets({
+      workspaceDirectory: "/repo",
+      activeFile: { path: "src/app.ts", lineStart: 3, lineEnd: 5 },
+      desktopTargets: [],
+      canUseDesktopBridge: false,
+      isLocalExecution: false,
+      checkoutStatus: {
+        isGit: true,
+        remoteUrl: "git@gitlab.com:group/project.git",
+        currentBranch: "main",
+      },
+      forge: null,
+    });
+
+    expect(targets).toEqual([
+      {
+        source: "forge",
+        forge: "gitlab",
+        id: "gitlab",
+        label: "GitLab",
+        url: "https://gitlab.com/group/project/-/blob/main/src/app.ts#L3-5",
+      },
+    ]);
+  });
+
   it("suppresses desktop targets when Electron bridge is unavailable", () => {
     const targets = planWorkspaceOpenTargets({
       workspaceDirectory: "/repo",

packages/app/src/workspace/open-target-planner.ts

@@ -1,4 +1,4 @@
-import { buildGitHubBlobUrl, buildGitHubBranchTreeUrl } from "@/git/github-url";
+import { type Forge, forgeFromRemoteUrl, getForgePresentation } from "@/git/forge";
 import type { DesktopOpenTarget, OpenDesktopTargetInput } from "@/workspace/desktop-open-targets";
 import {
   type ResolvedWorkspaceFilePaths,
@@ -21,14 +21,15 @@ export interface PlannedDesktopOpenTarget {
   openInput: OpenDesktopTargetInput;
 }
 
-export interface PlannedGitHubOpenTarget {
-  source: "github";
-  id: "github";
-  label: "GitHub";
+export interface PlannedForgeOpenTarget {
+  source: "forge";
+  forge: Forge;
+  id: Forge;
+  label: string;
   url: string;
 }
 
-export type PlannedWorkspaceOpenTarget = PlannedDesktopOpenTarget | PlannedGitHubOpenTarget;
+export type PlannedWorkspaceOpenTarget = PlannedDesktopOpenTarget | PlannedForgeOpenTarget;
 
 export interface PlanWorkspaceOpenTargetsInput {
   workspaceDirectory: string;
@@ -38,6 +39,7 @@ export interface PlanWorkspaceOpenTargetsInput {
   canUseDesktopBridge: boolean;
   isLocalExecution: boolean;
   checkoutStatus?: CheckoutStatusForOpenTarget | null;
+  forge?: Forge | null;
 }
 
 function resolveActiveFileForOpenTargets(
@@ -96,34 +98,64 @@ function planDesktopOpenTargets(input: {
   });
 }
 
-function planGitHubOpenTarget(input: {
+function buildForgeWebUrl(
+  forge: Forge,
+  input: {
+    remoteUrl: string | null | undefined;
+    branch: string | null | undefined;
+    path: string | null;
+    lineStart?: number;
+    lineEnd?: number;
+  },
+): string | null {
+  const presentation = getForgePresentation(forge);
+  if (input.path) {
+    return (
+      presentation.buildBlobUrl?.({
+        remoteUrl: input.remoteUrl,
+        branch: input.branch,
+        path: input.path,
+        lineStart: input.lineStart,
+        lineEnd: input.lineEnd,
+      }) ?? null
+    );
+  }
+  return (
+    presentation.buildBranchTreeUrl?.({
+      remoteUrl: input.remoteUrl,
+      branch: input.branch,
+    }) ?? null
+  );
+}
+
+function planForgeOpenTarget(input: {
   activeFile?: WorkspaceFileLocation | null;
   resolvedFile: ResolvedWorkspaceFilePaths | null;
   checkoutStatus?: CheckoutStatusForOpenTarget | null;
-}): PlannedGitHubOpenTarget | null {
+  forge?: Forge | null;
+}): PlannedForgeOpenTarget | null {
   if (!input.checkoutStatus?.isGit) {
     return null;
   }
-  const url = input.resolvedFile?.relativePath
-    ? buildGitHubBlobUrl({
-        remoteUrl: input.checkoutStatus.remoteUrl,
-        branch: input.checkoutStatus.currentBranch,
-        path: input.resolvedFile.relativePath,
-        lineStart: input.activeFile?.lineStart,
-        lineEnd: input.activeFile?.lineEnd,
-      })
-    : buildGitHubBranchTreeUrl({
-        remoteUrl: input.checkoutStatus.remoteUrl,
-        branch: input.checkoutStatus.currentBranch,
-      });
-
+  const forge = input.forge ?? forgeFromRemoteUrl(input.checkoutStatus.remoteUrl) ?? null;
+  if (!forge) {
+    return null;
+  }
+  const url = buildForgeWebUrl(forge, {
+    remoteUrl: input.checkoutStatus.remoteUrl,
+    branch: input.checkoutStatus.currentBranch,
+    path: input.resolvedFile?.relativePath ?? null,
+    lineStart: input.activeFile?.lineStart,
+    lineEnd: input.activeFile?.lineEnd,
+  });
   if (!url) {
     return null;
   }
   return {
-    source: "github",
-    id: "github",
-    label: "GitHub",
+    source: "forge",
+    forge,
+    id: forge,
+    label: getForgePresentation(forge).brandLabel,
     url,
   };
 }
@@ -133,6 +165,6 @@ export function planWorkspaceOpenTargets(
 ): PlannedWorkspaceOpenTarget[] {
   const resolvedFile = resolveActiveFileForOpenTargets(input);
   const desktopTargets = planDesktopOpenTargets({ ...input, resolvedFile });
-  const githubTarget = planGitHubOpenTarget({ ...input, resolvedFile });
-  return githubTarget ? [...desktopTargets, githubTarget] : desktopTargets;
+  const forgeTarget = planForgeOpenTarget({ ...input, resolvedFile });
+  return forgeTarget ? [...desktopTargets, forgeTarget] : desktopTargets;
 }