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/stores/draft-store/migration.test.ts

@@ -42,7 +42,7 @@ function githubPrAttachment(
   return {
     kind: "github_pr",
     item: {
-      kind: "pr",
+      kind: "change_request",
       number,
       title: `Review item ${number}`,
       url: `https://example.com/pulls/${number}`,

packages/app/src/stores/draft-store/state.test.ts

@@ -76,7 +76,7 @@ describe("draft-store normalization", () => {
       kind: "github_pr" as const,
       owner: "new-workspace-picker" as const,
       item: {
-        kind: "pr" as const,
+        kind: "change_request" as const,
         number: 202,
         title: "Persist picker ownership",
         url: "https://example.com/pull/202",

packages/app/src/stores/draft-store/state.ts

@@ -3,7 +3,7 @@ import {
   type AttachmentMetadata,
   type UserComposerAttachment,
 } from "@/attachments/types";
-import { GitHubSearchItemSchema } from "@getpaseo/protocol/messages";
+import { ForgeSearchItemSchema, GitHubSearchItemSchema } from "@getpaseo/protocol/messages";
 
 export const DRAFT_STORE_VERSION = 5;
 export const FINALIZED_DRAFT_TTL_MS = 5 * 60 * 1000;
@@ -83,7 +83,12 @@ export function isUserComposerAttachment(value: unknown): value is UserComposerA
     const metadata = record.metadata;
     return isAttachmentMetadata(metadata);
   }
-  if (record.kind !== "github_issue" && record.kind !== "github_pr") {
+  if (
+    record.kind !== "forge_issue" &&
+    record.kind !== "forge_change_request" &&
+    record.kind !== "github_issue" &&
+    record.kind !== "github_pr"
+  ) {
     return false;
   }
   if (
@@ -93,7 +98,10 @@ export function isUserComposerAttachment(value: unknown): value is UserComposerA
   ) {
     return false;
   }
-  return GitHubSearchItemSchema.safeParse(record.item).success;
+  return (
+    ForgeSearchItemSchema.safeParse(record.item).success ||
+    GitHubSearchItemSchema.safeParse(record.item).success
+  );
 }
 
 export function normalizeComposerAttachment(
@@ -106,9 +114,13 @@ export function normalizeComposerAttachment(
     };
   }
   if (attachment.kind === "github_pr") {
+    const item =
+      (attachment.item as { kind: string }).kind === "pr"
+        ? { ...attachment.item, kind: "change_request" as const }
+        : attachment.item;
     return {
       kind: "github_pr",
-      item: attachment.item,
+      item,
       ...(attachment.owner === NEW_WORKSPACE_PICKER_ATTACHMENT_OWNER
         ? { owner: attachment.owner }
         : {}),

packages/app/src/stores/session-store.ts

@@ -142,6 +142,7 @@ export interface WorkspaceDescriptor {
   scripts: WorkspaceDescriptorPayload["scripts"];
   gitRuntime?: WorkspaceDescriptorPayload["gitRuntime"];
   githubRuntime?: WorkspaceDescriptorPayload["githubRuntime"];
+  forge?: WorkspaceDescriptorPayload["forge"];
   project?: ProjectPlacementPayload;
 }
 
@@ -175,6 +176,7 @@ export function normalizeWorkspaceDescriptor(
     scripts: (payload.scripts ?? []).map((s) => Object.assign({}, s)),
     gitRuntime: payload.gitRuntime,
     githubRuntime: payload.githubRuntime,
+    forge: payload.forge,
     project: payload.project,
   };
 }