@dxos/plugin-github 0.7.4 → 0.14.0

package/src/capabilities/gen/node.ts

@@ -0,0 +1,43 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'node' condition.
+
+import * as ActivationEvents from '@dxos/app-framework/ActivationEvents';
+import * as Capability from '@dxos/app-framework/Capability';
+import * as AppCapability from '@dxos/app-toolkit/AppCapability';
+import * as ConnectorEvents from '@dxos/plugin-connector/ConnectorEvents';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';
+import * as CrxEvents from '@dxos/plugin-crx/CrxEvents';
+
+import { translations } from '#translations';
+
+export const Connector = Capability.lazyModule(
+  'GitHubConnector',
+  { provides: [ConnectorSpec.Connector], activatesOn: ConnectorEvents.Start },
+  () => import('../connector.ts'),
+);
+
+export const PageActionProvider = Capability.lazyModule(
+  'PageActionProvider',
+  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },
+  () => import('../page-action.ts'),
+);
+
+export const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {
+  activatesOn: ActivationEvents.Idle,
+});
+
+export const Schema = AppCapability.schema(() => import('../schema.ts'));
+
+export const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'));
+
+export const Translations = AppCapability.translations(translations);
+
+export const AppGraphBuilder = undefined;
+export const LinkResolver = undefined;
+export const MarkdownExtension = undefined;
+export const PluginAsset = undefined;
+export const ReactSurface = undefined;

package/src/capabilities/gen/tauri.ts

@@ -0,0 +1,82 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'tauri' condition.
+
+import * as ActivationEvents from '@dxos/app-framework/ActivationEvents';
+import * as Capability from '@dxos/app-framework/Capability';
+import * as AppCapability from '@dxos/app-toolkit/AppCapability';
+import * as ConnectorEvents from '@dxos/plugin-connector/ConnectorEvents';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';
+import * as CrxEvents from '@dxos/plugin-crx/CrxEvents';
+import * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';
+import * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';
+import * as PreviewCapabilities from '@dxos/plugin-preview/PreviewCapabilities';
+import * as PreviewEvents from '@dxos/plugin-preview/PreviewEvents';
+
+import { meta } from '#meta';
+import { translations } from '#translations';
+
+import pluginSpec from '../../../PLUGIN.mdl?raw';
+
+export const Connector = Capability.lazyModule(
+  'GitHubConnector',
+  { provides: [ConnectorSpec.Connector], activatesOn: ConnectorEvents.Start },
+  () => import('../connector.ts'),
+);
+
+// Browser-only: the editor it decorates and the popover it answers render nowhere else.
+export const MarkdownExtension = Capability.lazyModule(
+  'MarkdownExtension',
+  {
+    provides: [MarkdownCapabilities.ExtensionProvider],
+    activatesOn: MarkdownEvents.Start,
+    environments: ['browser', 'tauri'],
+  },
+  () => import('../markdown-extension.ts'),
+);
+
+export const LinkResolver = Capability.lazyModule(
+  'LinkResolver',
+  {
+    provides: [PreviewCapabilities.LinkResolver],
+    activatesOn: PreviewEvents.Start,
+    environments: ['browser', 'tauri'],
+  },
+  () => import('../link-resolver.ts'),
+);
+
+// Narrower than the `appGraphBuilder` family default: the action opens a dialog, which means
+// nothing without an app shell.
+export const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {
+  environments: ['browser', 'tauri'],
+});
+
+export const PageActionProvider = Capability.lazyModule(
+  'PageActionProvider',
+  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },
+  () => import('../page-action.ts'),
+);
+
+export const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {
+  activatesOn: ActivationEvents.Idle,
+});
+
+export const Schema = AppCapability.schema(() => import('../schema.ts'));
+
+export const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'));
+
+export const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {
+  roles: ['org.dxos.role.cardContent', 'org.dxos.role.cardMenu', 'org.dxos.role.article', 'org.dxos.role.dialog'],
+});
+
+export const PluginAsset = AppCapability.pluginAsset({
+  pluginId: meta.profile.key,
+  path: 'PLUGIN.mdl',
+  content: pluginSpec,
+  mimeType: 'application/x-mdl',
+});
+
+export const Translations = AppCapability.translations(translations);

package/src/capabilities/gen/workerd.ts

@@ -0,0 +1,43 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'workerd' condition.
+
+import * as ActivationEvents from '@dxos/app-framework/ActivationEvents';
+import * as Capability from '@dxos/app-framework/Capability';
+import * as AppCapability from '@dxos/app-toolkit/AppCapability';
+import * as ConnectorEvents from '@dxos/plugin-connector/ConnectorEvents';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';
+import * as CrxEvents from '@dxos/plugin-crx/CrxEvents';
+
+import { translations } from '#translations';
+
+export const Connector = Capability.lazyModule(
+  'GitHubConnector',
+  { provides: [ConnectorSpec.Connector], activatesOn: ConnectorEvents.Start },
+  () => import('../connector.ts'),
+);
+
+export const PageActionProvider = Capability.lazyModule(
+  'PageActionProvider',
+  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },
+  () => import('../page-action.ts'),
+);
+
+export const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {
+  activatesOn: ActivationEvents.Idle,
+});
+
+export const Schema = AppCapability.schema(() => import('../schema.ts'));
+
+export const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'));
+
+export const Translations = AppCapability.translations(translations);
+
+export const AppGraphBuilder = undefined;
+export const LinkResolver = undefined;
+export const MarkdownExtension = undefined;
+export const PluginAsset = undefined;
+export const ReactSurface = undefined;

package/src/capabilities/index.ts

@@ -0,0 +1,71 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as ActivationEvents from '@dxos/app-framework/ActivationEvents';
+import * as Capability from '@dxos/app-framework/Capability';
+import * as AppCapability from '@dxos/app-toolkit/AppCapability';
+import * as ConnectorEvents from '@dxos/plugin-connector/ConnectorEvents';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';
+import * as CrxEvents from '@dxos/plugin-crx/CrxEvents';
+import * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';
+import * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';
+import * as PreviewCapabilities from '@dxos/plugin-preview/PreviewCapabilities';
+import * as PreviewEvents from '@dxos/plugin-preview/PreviewEvents';
+
+import { meta } from '#meta';
+import { translations } from '#translations';
+
+// eslint-disable-next-line import/no-relative-packages
+import pluginSpec from '../../PLUGIN.mdl?raw';
+
+export const Connector = Capability.lazyModule(
+  'GitHubConnector',
+  { provides: [ConnectorSpec.Connector], activatesOn: ConnectorEvents.Start },
+  () => import('./connector.ts'),
+);
+// Browser-only: the editor it decorates and the popover it answers render nowhere else.
+export const MarkdownExtension = Capability.lazyModule(
+  'MarkdownExtension',
+  {
+    provides: [MarkdownCapabilities.ExtensionProvider],
+    activatesOn: MarkdownEvents.Start,
+    environments: ['browser', 'tauri'],
+  },
+  () => import('./markdown-extension.ts'),
+);
+export const LinkResolver = Capability.lazyModule(
+  'LinkResolver',
+  {
+    provides: [PreviewCapabilities.LinkResolver],
+    activatesOn: PreviewEvents.Start,
+    environments: ['browser', 'tauri'],
+  },
+  () => import('./link-resolver.ts'),
+);
+// Narrower than the `appGraphBuilder` family default: the action opens a dialog, which means
+// nothing without an app shell.
+export const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder.ts'), {
+  environments: ['browser', 'tauri'],
+});
+export const PageActionProvider = Capability.lazyModule(
+  'PageActionProvider',
+  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },
+  () => import('./page-action.ts'),
+);
+export const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler.ts'), {
+  activatesOn: ActivationEvents.Idle,
+});
+export const Schema = AppCapability.schema(() => import('./schema.ts'));
+export const SkillDefinition = AppCapability.skillDefinition(() => import('./skill-definition.ts'));
+export const ReactSurface = AppCapability.surface(() => import('./react-surface.ts'), {
+  roles: ['org.dxos.role.cardContent', 'org.dxos.role.cardMenu', 'org.dxos.role.article', 'org.dxos.role.dialog'],
+});
+export const PluginAsset = AppCapability.pluginAsset({
+  pluginId: meta.profile.key,
+  path: 'PLUGIN.mdl',
+  content: pluginSpec,
+  mimeType: 'application/x-mdl',
+});
+export const Translations = AppCapability.translations(translations);

package/src/capabilities/link-resolver.ts

@@ -0,0 +1,137 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import * as FetchHttpClient from 'effect/http/FetchHttpClient';
+import * as Layer from 'effect/Layer';
+
+import * as Capability from '@dxos/app-framework/Capability';
+import { Database, Filter } from '@dxos/echo';
+import { Connection } from '@dxos/link';
+import { log } from '@dxos/log';
+import * as PreviewCapabilities from '@dxos/plugin-preview/PreviewCapabilities';
+import { Issue, PullRequest, Repo } from '@dxos/types';
+
+import { GitHubCapabilities } from '#types';
+
+import { GITHUB_PROVIDER_ID } from '../constants.ts';
+import { type GitHubLink, githubLinkIcon, parseGitHubLink } from '../extensions/index.ts';
+import { toPullRequestProps } from '../pull-request.ts';
+import { GitHubApi } from '../services/index.ts';
+
+/**
+ * Resolves a GitHub repository, pull-request or issue URL to an in-memory `Repo`, `PullRequest` or
+ * `Issue` for the preview popover. The object comes from the contributed `LinkSource` when a host provides one and
+ * from the GitHub API otherwise; either way it is built, not stored — a preview is not a sync.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+    return Capability.contribute(PreviewCapabilities.LinkResolver, [
+      {
+        match: (url) => parseGitHubLink(url) !== undefined,
+        // How GitHub itself shortens a bare reference: the number, or the repository's full name.
+        label: (url) => {
+          const link = parseGitHubLink(url);
+          return link && (link.number !== undefined ? `#${link.number}` : `${link.owner}/${link.repo}`);
+        },
+        icon: githubLinkIcon,
+        resolve: ({ eid }, context) =>
+          Effect.gen(function* () {
+            const link = parseGitHubLink(eid);
+            if (!link) {
+              return undefined;
+            }
+            const [source = fetchFromGitHub] = capabilities.getAll(GitHubCapabilities.LinkSource);
+            const object = yield* source(link, context);
+            return (
+              object && { label: Repo.instanceOf(object) ? Repo.fullName(object) : Issue.reference(object), object }
+            );
+          }),
+      },
+    ]);
+  }),
+);
+
+/**
+ * The default source: each of the space's GitHub connection tokens in turn — a space can hold
+ * several, and only some may reach a private repository — then anonymous, which reaches a public one.
+ */
+const fetchFromGitHub: GitHubCapabilities.GitHubLinkSource = (link, { db }) =>
+  Effect.gen(function* () {
+    const tokens = db ? yield* connectionTokens(db) : [];
+    for (const token of [...tokens, '']) {
+      const object = yield* fetchLink(link).pipe(
+        Effect.provide(Layer.succeed(GitHubApi.GitHubCredentials, { token })),
+        Effect.tapError((error) => Effect.sync(() => log.warn('github link preview failed', { url: link.url, error }))),
+        Effect.catch(() => Effect.succeed(undefined)),
+      );
+      if (object) {
+        return object;
+      }
+    }
+    return undefined;
+  }).pipe(
+    Effect.provide(FetchHttpClient.layer),
+    Effect.catch(() => Effect.succeed(undefined)),
+  );
+
+/** The tokens of the space's GitHub connections, in query order. */
+const connectionTokens = (db: NonNullable<PreviewCapabilities.PreviewLinkContext['db']>) =>
+  Effect.gen(function* () {
+    const connections = yield* Database.query(Filter.type(Connection.Connection)).run;
+    const tokens: string[] = [];
+    for (const connection of connections) {
+      if (connection.connectorId !== GITHUB_PROVIDER_ID) {
+        continue;
+      }
+      const accessToken = yield* Database.load(connection.accessToken);
+      tokens.push(accessToken.token);
+    }
+    return tokens;
+  }).pipe(Effect.provide(Database.layer(db)));
+
+const fetchLink = (link: GitHubLink) =>
+  Effect.gen(function* () {
+    const { owner, repo, number } = link;
+    if (link.kind === 'repo' || number === undefined) {
+      return toRepo(link, yield* GitHubApi.fetchRepo(owner, repo));
+    }
+    if (link.kind === 'pull') {
+      return toPullRequest(link, yield* GitHubApi.fetchPullRequest(owner, repo, number));
+    }
+    const issue = yield* GitHubApi.fetchIssue(owner, repo, number);
+    // The issue endpoint answers for a pull request's number too; only the pull endpoint has its diff.
+    if (issue.pull_request) {
+      return toPullRequest(link, yield* GitHubApi.fetchPullRequest(owner, repo, number));
+    }
+    return toIssue(link, issue);
+  });
+
+const toRepo = ({ owner, url }: GitHubLink, repo: GitHubApi.GitHubRepo): Repo.Repo =>
+  Repo.make({
+    owner,
+    name: repo.name,
+    url: repo.html_url ?? url,
+    description: repo.description ?? undefined,
+    defaultBranch: repo.default_branch ?? undefined,
+  });
+
+const toIssue = ({ owner, repo, number = 0, url }: GitHubLink, issue: GitHubApi.GitHubIssue): Issue.Issue =>
+  Issue.make({
+    owner,
+    repo,
+    number,
+    title: issue.title,
+    url: issue.html_url ?? url,
+    state: issue.state === 'closed' ? 'closed' : 'open',
+    author: issue.user?.login,
+    description: issue.body ?? undefined,
+    labels: issue.labels?.map((label) => label.name),
+  });
+
+const toPullRequest = (
+  { owner, repo, number = 0, url }: GitHubLink,
+  pull: GitHubApi.GitHubPull,
+): PullRequest.PullRequest => PullRequest.make(toPullRequestProps({ owner, repo, number, url }, pull));

package/src/capabilities/markdown-extension.ts

@@ -0,0 +1,146 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { ViewPlugin } from '@codemirror/view';
+import * as Effect from 'effect/Effect';
+
+import * as Capability from '@dxos/app-framework/Capability';
+import * as Project from '@dxos/compute/Project';
+import { type Database, Filter, Obj, Query } from '@dxos/echo';
+import * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';
+import { Repo, TaskSet } from '@dxos/types';
+
+import { GITHUB_SOURCE } from '../constants.ts';
+import { githubLinks, githubReferences, referenceUrl } from '../extensions/index.ts';
+
+/** `owner/repo` — what `sync` writes as the name of the TaskSet mirroring a repository. */
+const REPO_NAME = /^[\w.-]+\/[\w.-]+$/;
+
+/**
+ * `#123` in a document resolves against the repository the document's project names: this plugin
+ * owns that knowledge, so the decoration is contributed rather than built into the editor. A full
+ * pull-request or issue URL needs no repository and becomes a chip whose popover this plugin's
+ * link resolver answers.
+ *
+ * Ambiguity is answered by declining. A space with several repositories and no project naming one
+ * has no single meaning for a bare number, so the reference is left as text rather than guessed at.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contribute(MarkdownCapabilities.ExtensionProvider, [
+      ({ document: doc, subject, viewMode }) => {
+        // Source view shows the document's own text; a decoration there would hide what it is.
+        if (viewMode === 'source') {
+          return undefined;
+        }
+
+        // A full URL needs no object: a task's description or an outline gets the chip too. A bare
+        // `#123` resolves against the repository of the project owning the edited object, so it
+        // needs one — the document, or whatever else the editor edits.
+        const object = doc ?? subject;
+        const db = object && Obj.getDatabase(object);
+        if (!object || !db) {
+          return [githubLinks()];
+        }
+
+        // Nearest binding first: the project that owns the object names its repository explicitly,
+        // and only a space with exactly one mirrored repository can answer for an object that
+        // belongs to no project.
+        const mirrored = watchMirroredRepos(db);
+        return [
+          githubLinks(),
+          githubReferences({
+            resolve: (number) => {
+              const repo = projectRepo(db, object) ?? mirrored.single();
+              return repo ? referenceUrl(repo, number) : undefined;
+            },
+          }),
+          // Held per mounted view: the provider's result can be mounted in several editors or none,
+          // so each view acquires its own hold rather than all of them releasing one subscription.
+          ViewPlugin.define(() => ({ destroy: mirrored.acquire() })),
+        ];
+      },
+    ]);
+  }),
+);
+
+/** The `repo` of the project owning `object`, else the repository its adopted task set mirrors. */
+const projectRepo = (db: Database.Database, object: Obj.Unknown): string | undefined => {
+  const project = owningProject(object);
+  if (!project) {
+    return undefined;
+  }
+
+  const repo = project.repo?.target;
+  if (repo && Repo.instanceOf(repo)) {
+    return Repo.fullName(repo);
+  }
+
+  // A project mirroring a repository adopts its synced task set, whose name is `owner/repo`.
+  const taskSet = project.taskSet?.target;
+  return taskSet && isMirrored(taskSet) ? repoName(taskSet) : undefined;
+};
+
+/** Walks the ECHO parent edge: a project's outline, instructions and artifacts all cascade from it. */
+const owningProject = (object: Obj.Unknown): Project.Project | undefined => {
+  let current: Obj.Unknown | undefined = object;
+  // Bounded: a malformed parent cycle must not hang the editor's decoration pass.
+  for (let depth = 0; current && depth < 8; depth++) {
+    if (Obj.instanceOf(Project.Project, current)) {
+      return current;
+    }
+    current = Obj.getParent(current);
+  }
+  return undefined;
+};
+
+/**
+ * The repositories this space mirrors, as `owner/name`. Read synchronously from a decoration pass,
+ * where a fresh `runSync()` would answer with whatever the tab has loaded so far; the subscription
+ * brings the set to the complete answer and keeps it there while any editor holds it.
+ */
+const watchMirroredRepos = (db: Database.Database) => {
+  const names = new Set<string>();
+  let holds = 0;
+  let stop: (() => void) | undefined;
+  return {
+    /** The one mirrored repository, or undefined when there is none or more than one. */
+    single: () => (names.size === 1 ? [...names][0] : undefined),
+    /** Starts watching on the first hold; the returned release is safe to call more than once. */
+    acquire: (): (() => void) => {
+      if (holds++ === 0) {
+        stop = db.query(Query.select(Filter.type(TaskSet.TaskSet))).subscribe(
+          (result) => {
+            names.clear();
+            for (const name of result.results.filter(isMirrored).map(repoName)) {
+              if (name) {
+                names.add(name);
+              }
+            }
+          },
+          { fire: true },
+        );
+      }
+
+      let released = false;
+      return () => {
+        if (released) {
+          return;
+        }
+        released = true;
+        if (--holds === 0) {
+          stop?.();
+          stop = undefined;
+          names.clear();
+        }
+      };
+    },
+  };
+};
+
+const isMirrored = (taskSet: TaskSet.TaskSet): boolean =>
+  Obj.getMeta(taskSet).keys.some(({ source }) => source === GITHUB_SOURCE);
+
+const repoName = (taskSet: TaskSet.TaskSet): string | undefined =>
+  taskSet.name && REPO_NAME.test(taskSet.name) ? taskSet.name : undefined;

package/src/capabilities/operation-handler.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import * as Capabilities from '@dxos/app-framework/Capabilities';
+import * as Capability from '@dxos/app-framework/Capability';
+
+import { GitHubOperationHandlerSet } from '#operations';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contribute(Capabilities.OperationHandler, GitHubOperationHandlerSet);
+  }),
+);

package/src/capabilities/page-action.ts

@@ -0,0 +1,32 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import * as Capability from '@dxos/app-framework/Capability';
+import * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';
+import type * as PageAction from '@dxos/plugin-crx/PageAction';
+
+import { meta } from '#meta';
+import { GitHubOperation } from '#types';
+
+export default Capability.makeModule(() =>
+  Effect.sync(() => {
+    // Typed array so the contribution is checked against CrxCapabilities.PageAction's value type.
+    const actions: PageAction.PageAction[] = [
+      {
+        id: `${meta.profile.key}/page-action/open-pull-request`,
+        label: 'Open PR in Composer',
+        icon: 'ph--git-pull-request--regular',
+        // `/pull/123` and anything below it (`/files`, `/commits`), which GitHub serves as the same
+        // pull request.
+        urlPatterns: ['https://github.com/*/*/pull/*'],
+        extractor: { name: 'snapshot' },
+        contexts: ['popup', 'picker'],
+        operation: GitHubOperation.ImportPullRequestFromSnapshot,
+      },
+    ];
+    return Capability.contribute(CrxCapabilities.PageAction, actions);
+  }),
+);

package/src/capabilities/react-surface.ts

@@ -0,0 +1,98 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import * as Capabilities from '@dxos/app-framework/Capabilities';
+import * as Capability from '@dxos/app-framework/Capability';
+import * as Surface from '@dxos/app-framework/Surface';
+import * as AppSurface from '@dxos/app-toolkit/AppSurface';
+import { Type } from '@dxos/echo';
+import { isSpace } from '@dxos/react-client/echo';
+import { Issue, PullRequest, Repo } from '@dxos/types';
+import * as Position from '@dxos/util/Position';
+
+import { IMPORT_PULL_REQUEST_DIALOG } from '#meta';
+import { Walkthrough } from '#types';
+
+import { GitHubCard, PullRequestCard } from '../cards/index.ts';
+import {
+  ImportPullRequestDialog,
+  PullRequestArticle,
+  PullRequestCardMenu,
+  PullRequestsArticle,
+  WalkthroughArticle,
+} from '../containers/index.ts';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contribute(Capabilities.ReactSurface, [
+      Surface.create({
+        id: 'repoCard',
+        position: Position.first,
+        filter: AppSurface.object(AppSurface.CardContent, Repo.Repo),
+        component: GitHubCard,
+        props: ({ role, data: { subject } }) => ({ role, subject }),
+      }),
+      Surface.create({
+        id: 'issueCard',
+        position: Position.first,
+        filter: AppSurface.object(AppSurface.CardContent, Issue.Issue),
+        component: GitHubCard,
+        props: ({ role, data: { subject } }) => ({ role, subject }),
+      }),
+      Surface.create({
+        id: 'pullRequestCard',
+        position: Position.first,
+        filter: AppSurface.object(AppSurface.CardContent, PullRequest.PullRequest),
+        component: PullRequestCard,
+        props: ({ role, data: { subject } }) => ({ role, subject }),
+      }),
+      Surface.create({
+        id: 'pullRequestCardMenu',
+        filter: AppSurface.object(AppSurface.CardMenu, PullRequest.PullRequest),
+        component: PullRequestCardMenu,
+        props: ({ data: { subject, menu } }) => ({ subject, menu }),
+      }),
+      // The pull request is the article's subject, and the walkthrough it may have is something the
+      // article renders — so a pull request with no narration yet still opens, and offers to write one.
+      Surface.create({
+        id: 'pullRequestArticle',
+        filter: AppSurface.object(AppSurface.Article, PullRequest.PullRequest),
+        component: PullRequestArticle,
+        props: ({ role, data }) => ({ role, ...data }),
+      }),
+      // The pull request type's node (the space's Database section) opens as the triage list rather
+      // than the generic type collection, which knows nothing of checks, tasks or relevance.
+      Surface.create({
+        id: 'pullRequestsArticle',
+        position: Position.first,
+        filter: AppSurface.subject(AppSurface.Article, isPullRequestType),
+        component: PullRequestsArticle,
+        props: ({ role, data: { attendableId, properties } }) => ({
+          role,
+          attendableId,
+          db: isSpace(properties?.space) ? properties.space.db : undefined,
+        }),
+      }),
+      // A walkthrough opened by id (an older link, a search result) resolves to the same review.
+      Surface.create({
+        id: 'walkthroughArticle',
+        filter: AppSurface.object(AppSurface.Article, Walkthrough.Walkthrough),
+        component: WalkthroughArticle,
+        props: ({ role, data }) => ({ role, ...data }),
+      }),
+      Surface.create({
+        id: IMPORT_PULL_REQUEST_DIALOG,
+        filter: AppSurface.component(AppSurface.Dialog, IMPORT_PULL_REQUEST_DIALOG),
+        component: ImportPullRequestDialog,
+      }),
+    ]),
+  ),
+);
+
+const PULL_REQUEST_TYPENAME = Type.getTypename(PullRequest.PullRequest);
+
+const isPullRequestType = (subject: unknown): subject is Type.AnyEntity =>
+  Type.isType(subject) && Type.getTypename(subject) === PULL_REQUEST_TYPENAME;