@dxos/plugin-github 0.7.4 → 0.14.0

package/dist/lib/chunk-pull-request2.mjs

@@ -0,0 +1,110 @@
+import "./chunk-constants.mjs";
+import { t as GitHubCredentials } from "./chunk-github-api.mjs";
+import { r as GitHubPullRequestUnstoredError } from "./chunk-errors.mjs";
+import * as Effect from "effect/Effect";
+import { Database, Filter, Obj } from "@dxos/echo";
+import * as Layer from "effect/Layer";
+import { Connection } from "@dxos/link";
+//#region src/operations/pull-request.ts
+/**
+* The GitHub connection whose token requests are sent with: the first one holding a token. Shared by
+* the handlers and by the UI that sends the user to reconnect, so both name the same connection.
+*/
+var githubConnection = () => Effect.gen(function* () {
+	const connections = yield* Database.query(Filter.type(Connection.Connection)).run;
+	for (const connection of connections) {
+		if (connection.connectorId !== "github") continue;
+		const accessToken = yield* Database.load(connection.accessToken);
+		if (accessToken.token) return {
+			connection,
+			token: accessToken.token
+		};
+	}
+});
+/**
+* The token of {@link githubConnection}, or empty for anonymous — which reaches any public pull
+* request, and is the only option in a space that has not connected GitHub.
+*/
+var githubToken = () => githubConnection().pipe(Effect.map((selected) => selected?.token ?? ""));
+/**
+* The stored pull request behind an operation's input and credentials for its space.
+*
+* The invoker carries no database resolver, so handlers derive one from the pull request itself; a
+* preview card's in-memory pull request has none and cannot be acted on.
+*/
+var resolvePullRequest = (ref) => Effect.gen(function* () {
+	const pullRequest = ref.target;
+	const db = pullRequest ? Obj.getDatabase(pullRequest) : void 0;
+	if (!pullRequest || !db) return yield* Effect.die(new GitHubPullRequestUnstoredError());
+	const token = yield* githubToken().pipe(Effect.provide(Database.layer(db)));
+	return {
+		pullRequest,
+		db,
+		credentials: Layer.succeed(GitHubCredentials, { token })
+	};
+});
+var FAILED_CONCLUSIONS = /* @__PURE__ */ new Set([
+	"failure",
+	"cancelled",
+	"timed_out",
+	"action_required",
+	"startup_failure",
+	"stale"
+]);
+/** One check run as the article lists it: its outcome folded the way {@link summarizeCheckRuns} counts it. */
+var toCheckRun = (run) => {
+	const outcome = run.status !== "completed" ? "pending" : run.conclusion && FAILED_CONCLUSIONS.has(run.conclusion) ? "failure" : run.conclusion === "skipped" ? "skipped" : run.conclusion === "neutral" ? "neutral" : "success";
+	const url = run.details_url ?? run.html_url;
+	return {
+		name: run.name,
+		outcome,
+		...run.conclusion ? { conclusion: run.conclusion } : {},
+		...url ? { url } : {},
+		...run.started_at ? { startedAt: run.started_at } : {},
+		...run.completed_at ? { completedAt: run.completed_at } : {}
+	};
+};
+/** Folds a commit's check runs into one outcome: any failure fails, then any unfinished run is pending. */
+var summarizeCheckRuns = (runs) => {
+	const checks = {
+		total: runs.length,
+		passed: 0,
+		failed: 0,
+		pending: 0
+	};
+	for (const run of runs) if (run.status !== "completed") checks.pending++;
+	else if (run.conclusion && FAILED_CONCLUSIONS.has(run.conclusion)) checks.failed++;
+	else checks.passed++;
+	return {
+		ci: checks.total === 0 ? "none" : checks.failed > 0 ? "failure" : checks.pending > 0 ? "pending" : "success",
+		checks
+	};
+};
+/** Review states that set a reviewer's standing verdict; a comment leaves the previous one in place. */
+var VERDICT_STATES = /* @__PURE__ */ new Set([
+	"APPROVED",
+	"CHANGES_REQUESTED",
+	"DISMISSED"
+]);
+/**
+* Folds a pull request's reviews into where they stand, from each reviewer's latest verdict — the
+* way GitHub reads them: a later approval clears that reviewer's request for changes, and a dismissal
+* withdraws whichever verdict it replaced.
+*/
+var summarizeReviews = (reviews) => {
+	const verdicts = /* @__PURE__ */ new Map();
+	for (const review of reviews) {
+		const login = review.user?.login;
+		if (login && VERDICT_STATES.has(review.state)) verdicts.set(login, review.state);
+	}
+	const states = [...verdicts.values()];
+	const approvals = states.filter((state) => state === "APPROVED").length;
+	return {
+		review: states.includes("CHANGES_REQUESTED") ? "changes_requested" : approvals > 0 ? "approved" : "none",
+		approvals
+	};
+};
+//#endregion
+export { summarizeReviews as a, summarizeCheckRuns as i, githubToken as n, toCheckRun as o, resolvePullRequest as r, githubConnection as t };
+
+//# sourceMappingURL=chunk-pull-request2.mjs.map

package/dist/lib/chunk-pull-request2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-pull-request2.mjs","names":[],"sources":["../../src/operations/pull-request.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { Database, Filter, Obj, type Ref } from '@dxos/echo';\nimport { Connection } from '@dxos/link';\nimport { type PullRequest } from '@dxos/types';\n\nimport { type GitHubOperation } from '#types';\n\nimport { GITHUB_PROVIDER_ID } from '../constants.ts';\nimport { GitHubPullRequestUnstoredError } from '../errors.ts';\nimport { GitHubApi } from '../services/index.ts';\n\n/**\n * The GitHub connection whose token requests are sent with: the first one holding a token. Shared by\n * the handlers and by the UI that sends the user to reconnect, so both name the same connection.\n */\nexport const githubConnection = () =>\n  Effect.gen(function* () {\n    const connections = yield* Database.query(Filter.type(Connection.Connection)).run;\n    for (const connection of connections) {\n      if (connection.connectorId !== GITHUB_PROVIDER_ID) {\n        continue;\n      }\n      const accessToken = yield* Database.load(connection.accessToken);\n      if (accessToken.token) {\n        return { connection, token: accessToken.token };\n      }\n    }\n\n    return undefined;\n  });\n\n/**\n * The token of {@link githubConnection}, or empty for anonymous — which reaches any public pull\n * request, and is the only option in a space that has not connected GitHub.\n */\nexport const githubToken = () => githubConnection().pipe(Effect.map((selected) => selected?.token ?? ''));\n\n/**\n * The stored pull request behind an operation's input and credentials for its space.\n *\n * The invoker carries no database resolver, so handlers derive one from the pull request itself; a\n * preview card's in-memory pull request has none and cannot be acted on.\n */\nexport const resolvePullRequest = (ref: Ref.Ref<PullRequest.PullRequest>) =>\n  Effect.gen(function* () {\n    const pullRequest = ref.target;\n    const db = pullRequest ? Obj.getDatabase(pullRequest) : undefined;\n    if (!pullRequest || !db) {\n      return yield* Effect.die(new GitHubPullRequestUnstoredError());\n    }\n    const token = yield* githubToken().pipe(Effect.provide(Database.layer(db)));\n    return { pullRequest, db, credentials: Layer.succeed(GitHubApi.GitHubCredentials, { token }) };\n  });\n\n// `stale` is a completed run GitHub never re-ran, which branch protection does not count as passing.\nconst FAILED_CONCLUSIONS = new Set([\n  'failure',\n  'cancelled',\n  'timed_out',\n  'action_required',\n  'startup_failure',\n  'stale',\n]);\n\n/** One check run as the article lists it: its outcome folded the way {@link summarizeCheckRuns} counts it. */\nexport const toCheckRun = (run: GitHubApi.GitHubCheckRun): GitHubOperation.CheckRun => {\n  const outcome: GitHubOperation.CheckOutcome =\n    run.status !== 'completed'\n      ? 'pending'\n      : run.conclusion && FAILED_CONCLUSIONS.has(run.conclusion)\n        ? 'failure'\n        : run.conclusion === 'skipped'\n          ? 'skipped'\n          : run.conclusion === 'neutral'\n            ? 'neutral'\n            : 'success';\n  const url = run.details_url ?? run.html_url;\n  return {\n    name: run.name,\n    outcome,\n    ...(run.conclusion ? { conclusion: run.conclusion } : {}),\n    ...(url ? { url } : {}),\n    ...(run.started_at ? { startedAt: run.started_at } : {}),\n    ...(run.completed_at ? { completedAt: run.completed_at } : {}),\n  };\n};\n\n/** Folds a commit's check runs into one outcome: any failure fails, then any unfinished run is pending. */\nexport const summarizeCheckRuns = (\n  runs: readonly GitHubApi.GitHubCheckRun[],\n): { ci: GitHubOperation.CiState; checks: GitHubOperation.CheckCounts } => {\n  const checks = { total: runs.length, passed: 0, failed: 0, pending: 0 };\n  for (const run of runs) {\n    if (run.status !== 'completed') {\n      checks.pending++;\n    } else if (run.conclusion && FAILED_CONCLUSIONS.has(run.conclusion)) {\n      checks.failed++;\n    } else {\n      checks.passed++;\n    }\n  }\n\n  const ci: GitHubOperation.CiState =\n    checks.total === 0 ? 'none' : checks.failed > 0 ? 'failure' : checks.pending > 0 ? 'pending' : 'success';\n  return { ci, checks };\n};\n\n/** Review states that set a reviewer's standing verdict; a comment leaves the previous one in place. */\nconst VERDICT_STATES = new Set(['APPROVED', 'CHANGES_REQUESTED', 'DISMISSED']);\n\n/**\n * Folds a pull request's reviews into where they stand, from each reviewer's latest verdict — the\n * way GitHub reads them: a later approval clears that reviewer's request for changes, and a dismissal\n * withdraws whichever verdict it replaced.\n */\nexport const summarizeReviews = (\n  reviews: readonly GitHubApi.GitHubSubmittedReview[],\n): { review: GitHubOperation.ReviewState; approvals: number } => {\n  const verdicts = new Map<string, string>();\n  for (const review of reviews) {\n    const login = review.user?.login;\n    if (login && VERDICT_STATES.has(review.state)) {\n      verdicts.set(login, review.state);\n    }\n  }\n\n  const states = [...verdicts.values()];\n  const approvals = states.filter((state) => state === 'APPROVED').length;\n  const review: GitHubOperation.ReviewState = states.includes('CHANGES_REQUESTED')\n    ? 'changes_requested'\n    : approvals > 0\n      ? 'approved'\n      : 'none';\n  return { review, approvals };\n};\n"],"mappings":";;;;;;;;;;;;AAqBA,IAAa,yBACX,OAAO,IAAI,aAAa;CACtB,MAAM,cAAc,OAAO,SAAS,MAAM,OAAO,KAAK,WAAW,UAAU,CAAC,CAAC,CAAC;CAC9E,KAAK,MAAM,cAAc,aAAa;EACpC,IAAI,WAAW,gBAAA,UACb;EAEF,MAAM,cAAc,OAAO,SAAS,KAAK,WAAW,WAAW;EAC/D,IAAI,YAAY,OACd,OAAO;GAAE;GAAY,OAAO,YAAY;EAAM;CAElD;AAGF,CAAC;;;;;AAMH,IAAa,oBAAoB,iBAAiB,CAAC,CAAC,KAAK,OAAO,KAAK,aAAa,UAAU,SAAS,EAAE,CAAC;;;;;;;AAQxG,IAAa,sBAAsB,QACjC,OAAO,IAAI,aAAa;CACtB,MAAM,cAAc,IAAI;CACxB,MAAM,KAAK,cAAc,IAAI,YAAY,WAAW,IAAI,KAAA;CACxD,IAAI,CAAC,eAAe,CAAC,IACnB,OAAO,OAAO,OAAO,IAAI,IAAI,+BAA+B,CAAC;CAE/D,MAAM,QAAQ,OAAO,YAAY,CAAC,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC;CAC1E,OAAO;EAAE;EAAa;EAAI,aAAa,MAAM,QAAQ,mBAA6B,EAAE,MAAM,CAAC;CAAE;AAC/F,CAAC;AAGH,IAAM,qCAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,IAAa,cAAc,QAA4D;CACrF,MAAM,UACJ,IAAI,WAAW,cACX,YACA,IAAI,cAAc,mBAAmB,IAAI,IAAI,UAAU,IACrD,YACA,IAAI,eAAe,YACjB,YACA,IAAI,eAAe,YACjB,YACA;CACZ,MAAM,MAAM,IAAI,eAAe,IAAI;CACnC,OAAO;EACL,MAAM,IAAI;EACV;EACA,GAAI,IAAI,aAAa,EAAE,YAAY,IAAI,WAAW,IAAI,CAAC;EACvD,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;EACrB,GAAI,IAAI,aAAa,EAAE,WAAW,IAAI,WAAW,IAAI,CAAC;EACtD,GAAI,IAAI,eAAe,EAAE,aAAa,IAAI,aAAa,IAAI,CAAC;CAC9D;AACF;;AAGA,IAAa,sBACX,SACyE;CACzE,MAAM,SAAS;EAAE,OAAO,KAAK;EAAQ,QAAQ;EAAG,QAAQ;EAAG,SAAS;CAAE;CACtE,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,WAAW,aACjB,OAAO;MACF,IAAI,IAAI,cAAc,mBAAmB,IAAI,IAAI,UAAU,GAChE,OAAO;MAEP,OAAO;CAMX,OAAO;EAAE,IADP,OAAO,UAAU,IAAI,SAAS,OAAO,SAAS,IAAI,YAAY,OAAO,UAAU,IAAI,YAAY;EACpF;CAAO;AACtB;;AAGA,IAAM,iCAAiB,IAAI,IAAI;CAAC;CAAY;CAAqB;AAAW,CAAC;;;;;;AAO7E,IAAa,oBACX,YAC+D;CAC/D,MAAM,2BAAW,IAAI,IAAoB;CACzC,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,QAAQ,OAAO,MAAM;EAC3B,IAAI,SAAS,eAAe,IAAI,OAAO,KAAK,GAC1C,SAAS,IAAI,OAAO,OAAO,KAAK;CAEpC;CAEA,MAAM,SAAS,CAAC,GAAG,SAAS,OAAO,CAAC;CACpC,MAAM,YAAY,OAAO,QAAQ,UAAU,UAAU,UAAU,CAAC,CAAC;CAMjE,OAAO;EAAE,QALmC,OAAO,SAAS,mBAAmB,IAC3E,sBACA,YAAY,IACV,aACA;EACW;CAAU;AAC7B"}

package/dist/lib/chunk-react-surface.mjs

@@ -0,0 +1,233 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Capability from "@dxos/app-framework/Capability";
+import { IMPORT_PULL_REQUEST_DIALOG, meta } from "#meta";
+import { lazy, useEffect } from "react";
+import { GitHubOperation, Walkthrough } from "#types";
+import * as Effect from "effect/Effect";
+import { Issue, PullRequest, Repo } from "@dxos/types";
+import { Obj, Ref, Type } from "@dxos/echo";
+import { log } from "@dxos/log";
+import * as Capabilities from "@dxos/app-framework/Capabilities";
+import * as Surface from "@dxos/app-framework/Surface";
+import * as AppSurface from "@dxos/app-toolkit/AppSurface";
+import { isSpace } from "@dxos/react-client/echo";
+import * as Position from "@dxos/util/Position";
+import * as Card from "@dxos/react-ui/Card";
+import * as Hooks$1 from "@dxos/react-ui/Hooks";
+import * as Layout from "@dxos/react-ui/Layout";
+import * as Tag$1 from "@dxos/react-ui/Tag";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useObject } from "@dxos/echo-react";
+import * as Hooks from "@dxos/app-framework/Hooks";
+//#region src/cards/GitHubCard.tsx
+var stateHue = {
+	open: "green",
+	closed: "red",
+	merged: "purple",
+	draft: "neutral"
+};
+/**
+* Card content for a repository, pull request or issue: reference, state or branch, author, diff size, description and
+* the link out. Each row leads with an icon in the card's start rail, so the text lines up with the title.
+*/
+var GitHubCard = ({ subject }) => {
+	const { t } = Hooks$1.useTranslation(meta.profile.key);
+	const { owner, number, state, author, additions, deletions, defaultBranch, description, url } = subject;
+	const name = "name" in subject ? subject.name : subject.repo;
+	return /* @__PURE__ */ jsxs(Card.Body, { children: [
+		/* @__PURE__ */ jsx(Card.Row, {
+			icon: "ph--github-logo--regular",
+			trailing: state ? /* @__PURE__ */ jsx(Tag$1.Tag, {
+				hue: stateHue[state],
+				children: state
+			}) : defaultBranch ? /* @__PURE__ */ jsx(Tag$1.Tag, {
+				hue: "neutral",
+				children: defaultBranch
+			}) : void 0,
+			children: /* @__PURE__ */ jsx(Card.Text, {
+				variant: "muted",
+				children: [`${owner}/${name}`, number].filter(Boolean).join("#")
+			})
+		}),
+		author && /* @__PURE__ */ jsx(Card.Row, {
+			icon: "ph--user--regular",
+			children: /* @__PURE__ */ jsx(Card.Text, {
+				variant: "muted",
+				children: author
+			})
+		}),
+		(additions !== void 0 || deletions !== void 0) && /* @__PURE__ */ jsx(Card.Row, {
+			icon: "ph--plus-minus--regular",
+			children: /* @__PURE__ */ jsxs(Layout.Flex, {
+				gap: "sm",
+				align: "center",
+				children: [additions !== void 0 && /* @__PURE__ */ jsxs("span", {
+					className: "text-green-500",
+					children: ["+", additions]
+				}), deletions !== void 0 && /* @__PURE__ */ jsxs("span", {
+					className: "text-red-500",
+					children: ["−", deletions]
+				})]
+			})
+		}),
+		description && /* @__PURE__ */ jsx(Card.Row, {
+			icon: "ph--text-align-left--regular",
+			children: /* @__PURE__ */ jsx(Card.Text, {
+				lines: 3,
+				variant: "muted",
+				children: description
+			})
+		}),
+		url && /* @__PURE__ */ jsx(Card.Row, {
+			icon: "ph--arrow-square-out--regular",
+			children: /* @__PURE__ */ jsx("a", {
+				className: "dx-link-accent",
+				href: url,
+				target: "_blank",
+				rel: "noopener noreferrer",
+				children: t("open-on-github.label")
+			})
+		})
+	] });
+};
+//#endregion
+//#region src/hooks/useSyncPullRequest.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-github/src/hooks/useSyncPullRequest.ts";
+/** How long a re-sync stands before the pull request is read from GitHub again. */
+var SYNC_INTERVAL = 3e5;
+var lastSynced = /* @__PURE__ */ new Map();
+var markSynced = (id, now) => {
+	for (const [key, syncedAt] of lastSynced) if (now - syncedAt >= SYNC_INTERVAL) lastSynced.delete(key);
+	lastSynced.set(id, now);
+};
+/**
+* Refreshes a stored pull request from GitHub when it is shown, since whatever shows it is the moment
+* its fields are worth trusting: a repository sync may be days old, and an import is never re-synced.
+*
+* A pull request held by no database (a link preview) is skipped, as there is nothing to write back to,
+* and one synced within {@link SYNC_INTERVAL} is skipped too.
+*/
+var useSyncPullRequest = (pullRequest) => {
+	const { invokePromise } = Hooks.useOperationInvoker();
+	const spaceId = Obj.getDatabase(pullRequest)?.spaceId;
+	useEffect(() => {
+		const now = Date.now();
+		if (!spaceId || now - (lastSynced.get(pullRequest.id) ?? 0) < SYNC_INTERVAL) return;
+		markSynced(pullRequest.id, now);
+		invokePromise(GitHubOperation.SyncPullRequest, { pullRequest: Ref.make(pullRequest) }, { spaceId }).then(({ error }) => error && log.warn("pull request sync failed", { error }, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 48,
+			S: void 0
+		}));
+	}, [
+		invokePromise,
+		pullRequest,
+		spaceId
+	]);
+};
+//#endregion
+//#region src/cards/PullRequestCard.tsx
+/**
+* A pull request's card, re-synced from GitHub whenever it is shown: the card is often where a stale
+* pull request is first read, e.g. in a task list's popover.
+*/
+var PullRequestCard = ({ role, subject }) => {
+	useObject(subject);
+	useSyncPullRequest(subject);
+	return /* @__PURE__ */ jsx(GitHubCard, {
+		role,
+		subject
+	});
+};
+//#endregion
+//#region src/containers/index.ts
+var ImportPullRequestDialog = lazy(() => import("./chunk-ImportPullRequestDialog.mjs"));
+var PullRequestCardMenu = lazy(() => import("./chunk-PullRequestCardMenu.mjs"));
+var PullRequestArticle = lazy(() => import("./chunk-PullRequestArticle2.mjs"));
+var PullRequestsArticle = lazy(() => import("./chunk-PullRequestsArticle.mjs"));
+var WalkthroughArticle = lazy(() => import("./chunk-WalkthroughArticle.mjs"));
+//#endregion
+//#region src/capabilities/react-surface.ts
+var react_surface_exports = /* @__PURE__ */ __exportAll({ default: () => react_surface_default });
+var react_surface_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
+		})
+	}),
+	Surface.create({
+		id: "pullRequestArticle",
+		filter: AppSurface.object(AppSurface.Article, PullRequest.PullRequest),
+		component: PullRequestArticle,
+		props: ({ role, data }) => ({
+			role,
+			...data
+		})
+	}),
+	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 : void 0
+		})
+	}),
+	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
+	})
+])));
+var PULL_REQUEST_TYPENAME = Type.getTypename(PullRequest.PullRequest);
+var isPullRequestType = (subject) => Type.isType(subject) && Type.getTypename(subject) === PULL_REQUEST_TYPENAME;
+//#endregion
+export { react_surface_default as default, useSyncPullRequest as n, react_surface_exports as t };
+
+//# sourceMappingURL=chunk-react-surface.mjs.map

package/dist/lib/chunk-react-surface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/cards/GitHubCard.tsx","../../src/hooks/useSyncPullRequest.ts","../../src/cards/PullRequestCard.tsx","../../src/containers/index.ts","../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport type * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport * as Card from '@dxos/react-ui/Card';\nimport * as Hooks from '@dxos/react-ui/Hooks';\nimport * as Layout from '@dxos/react-ui/Layout';\nimport * as Tag from '@dxos/react-ui/Tag';\nimport { type Issue, type PullRequest, type Repo } from '@dxos/types';\n\nimport { meta } from '#meta';\n\ntype Subject = Repo.Repo | Issue.Issue | PullRequest.PullRequest;\n\n/**\n * What the card reads off any of the three types: each field is present on some of them and\n * optional here, so one render path shows whatever the subject carries.\n */\ntype Fields = {\n  owner: string;\n  number?: number;\n  state?: PullRequest.State;\n  author?: string;\n  additions?: number;\n  deletions?: number;\n  defaultBranch?: string;\n  description?: string;\n  url?: string;\n};\n\nconst stateHue: Record<PullRequest.State, Tag.TagHue> = {\n  open: 'green',\n  closed: 'red',\n  merged: 'purple',\n  draft: 'neutral',\n};\n\n/**\n * Card content for a repository, pull request or issue: reference, state or branch, author, diff size, description and\n * the link out. Each row leads with an icon in the card's start rail, so the text lines up with the title.\n */\nexport const GitHubCard = ({ subject }: AppSurface.ObjectCardProps<Subject>) => {\n  const { t } = Hooks.useTranslation(meta.profile.key);\n  const { owner, number, state, author, additions, deletions, defaultBranch, description, url }: Fields = subject;\n  const name = 'name' in subject ? subject.name : subject.repo;\n\n  return (\n    <Card.Body>\n      <Card.Row\n        icon='ph--github-logo--regular'\n        trailing={\n          state ? (\n            <Tag.Tag hue={stateHue[state]}>{state}</Tag.Tag>\n          ) : defaultBranch ? (\n            <Tag.Tag hue='neutral'>{defaultBranch}</Tag.Tag>\n          ) : undefined\n        }\n      >\n        <Card.Text variant='muted'>{[`${owner}/${name}`, number].filter(Boolean).join('#')}</Card.Text>\n      </Card.Row>\n      {author && (\n        <Card.Row icon='ph--user--regular'>\n          <Card.Text variant='muted'>{author}</Card.Text>\n        </Card.Row>\n      )}\n      {(additions !== undefined || deletions !== undefined) && (\n        <Card.Row icon='ph--plus-minus--regular'>\n          <Layout.Flex gap='sm' align='center'>\n            {additions !== undefined && <span className='text-green-500'>+{additions}</span>}\n            {deletions !== undefined && <span className='text-red-500'>−{deletions}</span>}\n          </Layout.Flex>\n        </Card.Row>\n      )}\n      {description && (\n        <Card.Row icon='ph--text-align-left--regular'>\n          <Card.Text lines={3} variant='muted'>\n            {description}\n          </Card.Text>\n        </Card.Row>\n      )}\n      {url && (\n        <Card.Row icon='ph--arrow-square-out--regular'>\n          <a className='dx-link-accent' href={url} target='_blank' rel='noopener noreferrer'>\n            {t('open-on-github.label')}\n          </a>\n        </Card.Row>\n      )}\n    </Card.Body>\n  );\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { useEffect } from 'react';\n\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport { Obj, Ref } from '@dxos/echo';\nimport { log } from '@dxos/log';\nimport { type PullRequest } from '@dxos/types';\n\nimport { GitHubOperation } from '#types';\n\n/** How long a re-sync stands before the pull request is read from GitHub again. */\nconst SYNC_INTERVAL = 5 * 60_000;\n\n// Keyed by object id: a board of pull request cards would otherwise spend one GitHub request per\n// card each time it mounts, and an anonymous caller has only 60 an hour. Entries past the interval\n// are pruned on every write, so the map holds only pull requests synced within it.\nconst lastSynced = new Map<string, number>();\n\nconst markSynced = (id: string, now: number) => {\n  for (const [key, syncedAt] of lastSynced) {\n    if (now - syncedAt >= SYNC_INTERVAL) {\n      lastSynced.delete(key);\n    }\n  }\n  lastSynced.set(id, now);\n};\n\n/**\n * Refreshes a stored pull request from GitHub when it is shown, since whatever shows it is the moment\n * its fields are worth trusting: a repository sync may be days old, and an import is never re-synced.\n *\n * A pull request held by no database (a link preview) is skipped, as there is nothing to write back to,\n * and one synced within {@link SYNC_INTERVAL} is skipped too.\n */\nexport const useSyncPullRequest = (pullRequest: PullRequest.PullRequest): void => {\n  const { invokePromise } = Hooks.useOperationInvoker();\n  const spaceId = Obj.getDatabase(pullRequest)?.spaceId;\n  useEffect(() => {\n    const now = Date.now();\n    if (!spaceId || now - (lastSynced.get(pullRequest.id) ?? 0) < SYNC_INTERVAL) {\n      return;\n    }\n    markSynced(pullRequest.id, now);\n    void invokePromise(GitHubOperation.SyncPullRequest, { pullRequest: Ref.make(pullRequest) }, { spaceId }).then(\n      ({ error }) => error && log.warn('pull request sync failed', { error }),\n    );\n  }, [invokePromise, pullRequest, spaceId]);\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport type * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport { useObject } from '@dxos/echo-react';\nimport { type PullRequest } from '@dxos/types';\n\nimport { useSyncPullRequest } from '../hooks/index.ts';\nimport { GitHubCard } from './GitHubCard.tsx';\n\n/**\n * A pull request's card, re-synced from GitHub whenever it is shown: the card is often where a stale\n * pull request is first read, e.g. in a task list's popover.\n */\nexport const PullRequestCard = ({ role, subject }: AppSurface.ObjectCardProps<PullRequest.PullRequest>) => {\n  // Subscribed so the fields the sync writes back re-render the card.\n  useObject(subject);\n  useSyncPullRequest(subject);\n  return <GitHubCard role={role} subject={subject} />;\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const ImportPullRequestDialog: ComponentType<any> = lazy(() => import('./ImportPullRequestDialog/index.ts'));\nexport const PullRequestCardMenu: ComponentType<any> = lazy(() => import('./PullRequestCardMenu/index.ts'));\nexport const PullRequestArticle: ComponentType<any> = lazy(() => import('./PullRequestArticle/index.ts'));\nexport const PullRequestsArticle: ComponentType<any> = lazy(() => import('./PullRequestsArticle/index.ts'));\nexport const WalkthroughArticle: ComponentType<any> = lazy(() => import('./WalkthroughArticle/index.ts'));\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Surface from '@dxos/app-framework/Surface';\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport { Type } from '@dxos/echo';\nimport { isSpace } from '@dxos/react-client/echo';\nimport { Issue, PullRequest, Repo } from '@dxos/types';\nimport * as Position from '@dxos/util/Position';\n\nimport { IMPORT_PULL_REQUEST_DIALOG } from '#meta';\nimport { Walkthrough } from '#types';\n\nimport { GitHubCard, PullRequestCard } from '../cards/index.ts';\nimport {\n  ImportPullRequestDialog,\n  PullRequestArticle,\n  PullRequestCardMenu,\n  PullRequestsArticle,\n  WalkthroughArticle,\n} from '../containers/index.ts';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contribute(Capabilities.ReactSurface, [\n      Surface.create({\n        id: 'repoCard',\n        position: Position.first,\n        filter: AppSurface.object(AppSurface.CardContent, Repo.Repo),\n        component: GitHubCard,\n        props: ({ role, data: { subject } }) => ({ role, subject }),\n      }),\n      Surface.create({\n        id: 'issueCard',\n        position: Position.first,\n        filter: AppSurface.object(AppSurface.CardContent, Issue.Issue),\n        component: GitHubCard,\n        props: ({ role, data: { subject } }) => ({ role, subject }),\n      }),\n      Surface.create({\n        id: 'pullRequestCard',\n        position: Position.first,\n        filter: AppSurface.object(AppSurface.CardContent, PullRequest.PullRequest),\n        component: PullRequestCard,\n        props: ({ role, data: { subject } }) => ({ role, subject }),\n      }),\n      Surface.create({\n        id: 'pullRequestCardMenu',\n        filter: AppSurface.object(AppSurface.CardMenu, PullRequest.PullRequest),\n        component: PullRequestCardMenu,\n        props: ({ data: { subject, menu } }) => ({ subject, menu }),\n      }),\n      // The pull request is the article's subject, and the walkthrough it may have is something the\n      // article renders — so a pull request with no narration yet still opens, and offers to write one.\n      Surface.create({\n        id: 'pullRequestArticle',\n        filter: AppSurface.object(AppSurface.Article, PullRequest.PullRequest),\n        component: PullRequestArticle,\n        props: ({ role, data }) => ({ role, ...data }),\n      }),\n      // The pull request type's node (the space's Database section) opens as the triage list rather\n      // than the generic type collection, which knows nothing of checks, tasks or relevance.\n      Surface.create({\n        id: 'pullRequestsArticle',\n        position: Position.first,\n        filter: AppSurface.subject(AppSurface.Article, isPullRequestType),\n        component: PullRequestsArticle,\n        props: ({ role, data: { attendableId, properties } }) => ({\n          role,\n          attendableId,\n          db: isSpace(properties?.space) ? properties.space.db : undefined,\n        }),\n      }),\n      // A walkthrough opened by id (an older link, a search result) resolves to the same review.\n      Surface.create({\n        id: 'walkthroughArticle',\n        filter: AppSurface.object(AppSurface.Article, Walkthrough.Walkthrough),\n        component: WalkthroughArticle,\n        props: ({ role, data }) => ({ role, ...data }),\n      }),\n      Surface.create({\n        id: IMPORT_PULL_REQUEST_DIALOG,\n        filter: AppSurface.component(AppSurface.Dialog, IMPORT_PULL_REQUEST_DIALOG),\n        component: ImportPullRequestDialog,\n      }),\n    ]),\n  ),\n);\n\nconst PULL_REQUEST_TYPENAME = Type.getTypename(PullRequest.PullRequest);\n\nconst isPullRequestType = (subject: unknown): subject is Type.AnyEntity =>\n  Type.isType(subject) && Type.getTypename(subject) === PULL_REQUEST_TYPENAME;\n"],"mappings":"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"}

package/dist/lib/chunk-refresh-pull-requests.mjs

@@ -0,0 +1,49 @@
+import { n as githubToken } from "./chunk-pull-request2.mjs";
+import { a as selectRefreshBatch, i as refreshPullRequest, n as ensureRefreshTrigger, r as queryInFlightPullRequests } from "./chunk-import-pull-request.mjs";
+import { GitHubOperation } from "#types";
+import * as Operation from "@dxos/compute/Operation";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import { log } from "@dxos/log";
+import * as Clock from "effect/Clock";
+//#region src/operations/refresh-pull-requests.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-github/src/operations/refresh-pull-requests.ts";
+/** Bounded so a space with many open pull requests does not burst GitHub's secondary rate limit. */
+var REFRESH_CONCURRENCY = 2;
+/** The hourly `REFRESH_CRON` period, so each scheduled run lands in its own batch window. */
+var REFRESH_INTERVAL_MS = 36e5;
+var handler = GitHubOperation.RefreshPullRequests.pipe(Operation.withHandler(Effect.fn(function* () {
+	yield* ensureRefreshTrigger();
+	const inFlight = yield* queryInFlightPullRequests();
+	if (inFlight.length === 0) return {
+		checked: 0,
+		updated: 0,
+		failed: 0
+	};
+	const window = Math.floor((yield* Clock.currentTimeMillis) / REFRESH_INTERVAL_MS);
+	const pullRequests = selectRefreshBatch(inFlight, window);
+	const token = yield* githubToken();
+	const results = yield* Effect.forEach(pullRequests, (pullRequest) => refreshPullRequest(pullRequest, token).pipe(Effect.map((updated) => updated.length > 0 ? "updated" : "unchanged"), Effect.catchDefect((cause) => Effect.sync(() => {
+		log.warn("pull request refresh failed", {
+			owner: pullRequest.owner,
+			repo: pullRequest.repo,
+			number: pullRequest.number,
+			cause
+		}, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 47,
+			S: this
+		});
+		return "failed";
+	}))), { concurrency: REFRESH_CONCURRENCY });
+	return {
+		checked: pullRequests.length,
+		updated: results.filter((result) => result === "updated").length,
+		failed: results.filter((result) => result === "failed").length
+	};
+}, Effect.provide(FetchHttpClient.layer))));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-refresh-pull-requests.mjs.map

package/dist/lib/chunk-refresh-pull-requests.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-refresh-pull-requests.mjs","names":[],"sources":["../../src/operations/refresh-pull-requests.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Clock from 'effect/Clock';\nimport * as Effect from 'effect/Effect';\nimport * as FetchHttpClient from 'effect/http/FetchHttpClient';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { log } from '@dxos/log';\n\nimport { GitHubOperation } from '#types';\n\nimport { githubToken } from './pull-request.ts';\nimport { ensureRefreshTrigger, queryInFlightPullRequests, refreshPullRequest, selectRefreshBatch } from './refresh.ts';\n\n/** Bounded so a space with many open pull requests does not burst GitHub's secondary rate limit. */\nconst REFRESH_CONCURRENCY = 2;\n\n/** The hourly `REFRESH_CRON` period, so each scheduled run lands in its own batch window. */\nconst REFRESH_INTERVAL_MS = 60 * 60 * 1000;\n\nconst handler: Operation.WithHandler<typeof GitHubOperation.RefreshPullRequests> =\n  GitHubOperation.RefreshPullRequests.pipe(\n    Operation.withHandler(\n      Effect.fn(function* () {\n        // Collapses any duplicate a racing peer created, so the space keeps one schedule.\n        yield* ensureRefreshTrigger();\n        const inFlight = yield* queryInFlightPullRequests();\n        if (inFlight.length === 0) {\n          return { checked: 0, updated: 0, failed: 0 };\n        }\n\n        const window = Math.floor((yield* Clock.currentTimeMillis) / REFRESH_INTERVAL_MS);\n        const pullRequests = selectRefreshBatch(inFlight, window);\n\n        const token = yield* githubToken();\n        const results = yield* Effect.forEach(\n          pullRequests,\n          (pullRequest) =>\n            // One deleted or unreachable pull request must not fail the run: EDGE disables a trigger\n            // after repeated failures, which would stop refreshing every other one.\n            refreshPullRequest(pullRequest, token).pipe(\n              Effect.map((updated) => (updated.length > 0 ? 'updated' : 'unchanged')),\n              Effect.catchDefect((cause) =>\n                Effect.sync(() => {\n                  log.warn('pull request refresh failed', {\n                    owner: pullRequest.owner,\n                    repo: pullRequest.repo,\n                    number: pullRequest.number,\n                    cause,\n                  });\n                  return 'failed' as const;\n                }),\n              ),\n            ),\n          { concurrency: REFRESH_CONCURRENCY },\n        );\n\n        return {\n          checked: pullRequests.length,\n          updated: results.filter((result) => result === 'updated').length,\n          failed: results.filter((result) => result === 'failed').length,\n        };\n      }, Effect.provide(FetchHttpClient.layer)),\n    ),\n  );\n\nexport default handler;\n"],"mappings":";;;;;;;;;;;AAiBA,IAAM,sBAAsB;;AAG5B,IAAM,sBAAsB;AAE5B,IAAM,UACJ,gBAAgB,oBAAoB,KAClC,UAAU,YACR,OAAO,GAAG,aAAa;CAErB,OAAO,qBAAqB;CAC5B,MAAM,WAAW,OAAO,0BAA0B;CAClD,IAAI,SAAS,WAAW,GACtB,OAAO;EAAE,SAAS;EAAG,SAAS;EAAG,QAAQ;CAAE;CAG7C,MAAM,SAAS,KAAK,OAAO,OAAO,MAAM,qBAAqB,mBAAmB;CAChF,MAAM,eAAe,mBAAmB,UAAU,MAAM;CAExD,MAAM,QAAQ,OAAO,YAAY;CACjC,MAAM,UAAU,OAAO,OAAO,QAC5B,eACC,gBAGC,mBAAmB,aAAa,KAAK,CAAC,CAAC,KACrC,OAAO,KAAK,YAAa,QAAQ,SAAS,IAAI,YAAY,WAAY,GACtE,OAAO,aAAa,UAClB,OAAO,WAAW;EAChB,IAAI,KAAK,+BAA+B;GACtC,OAAO,YAAY;GACnB,MAAM,YAAY;GAClB,QAAQ,YAAY;GACpB;EACF,GAAA;GAAA,YAAA;GAAA,GAAA;GAAA,GAAA;GAAA,GAAA;EAAA,CAAC;EACD,OAAO;CACT,CAAC,CACH,CACF,GACF,EAAE,aAAa,oBAAoB,CACrC;CAEA,OAAO;EACL,SAAS,aAAa;EACtB,SAAS,QAAQ,QAAQ,WAAW,WAAW,SAAS,CAAC,CAAC;EAC1D,QAAQ,QAAQ,QAAQ,WAAW,WAAW,QAAQ,CAAC,CAAC;CAC1D;AACF,GAAG,OAAO,QAAQ,gBAAgB,KAAK,CAAC,CAC1C,CACF"}

package/dist/lib/chunk-rolldown-runtime.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/lib/chunk-schema.mjs

@@ -0,0 +1,15 @@
+import { Walkthrough } from "#types";
+import { PullRequest } from "@dxos/types";
+//#region src/capabilities/schema.ts
+/**
+* Schemas this plugin registers, in a module of their own so they are loaded on demand rather than
+* from the plugin body's graph.
+*
+* `PullRequest` comes with `Walkthrough` because a walkthrough holds a ref to one, and a space that
+* can read the walkthrough has to be able to resolve what it points at.
+*/
+var schema_default = [Walkthrough.Walkthrough, PullRequest.PullRequest];
+//#endregion
+export { schema_default as default };
+
+//# sourceMappingURL=chunk-schema.mjs.map

package/dist/lib/chunk-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-schema.mjs","names":[],"sources":["../../src/capabilities/schema.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { PullRequest } from '@dxos/types';\n\nimport { Walkthrough } from '#types';\n\n/**\n * Schemas this plugin registers, in a module of their own so they are loaded on demand rather than\n * from the plugin body's graph.\n *\n * `PullRequest` comes with `Walkthrough` because a walkthrough holds a ref to one, and a space that\n * can read the walkthrough has to be able to resolve what it points at.\n */\nexport default [Walkthrough.Walkthrough, PullRequest.PullRequest];\n"],"mappings":";;;;;;;;;;AAeA,IAAA,iBAAe,CAAC,YAAY,aAAa,YAAY,WAAW"}

package/dist/lib/chunk-skill-definition.mjs

@@ -0,0 +1,10 @@
+import * as Capability from "@dxos/app-framework/Capability";
+import * as Effect from "effect/Effect";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
+import { GitHubSkill } from "#skills";
+//#region src/capabilities/skill-definition.ts
+var skillDefinition = () => Effect.succeed([Capability.contribute(AppCapabilities.SkillDefinition, GitHubSkill)]);
+//#endregion
+export { skillDefinition as default };
+
+//# sourceMappingURL=chunk-skill-definition.mjs.map

package/dist/lib/chunk-skill-definition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-skill-definition.mjs","names":[],"sources":["../../src/capabilities/skill-definition.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\n\nimport { GitHubSkill } from '#skills';\n\nconst skillDefinition = () => Effect.succeed([Capability.contribute(AppCapabilities.SkillDefinition, GitHubSkill)]);\n\nexport default skillDefinition;\n"],"mappings":";;;;;AAWA,IAAM,wBAAwB,OAAO,QAAQ,CAAC,WAAW,WAAW,gBAAgB,iBAAiB,WAAW,CAAC,CAAC"}

package/dist/lib/chunk-submit-pull-request-approval.mjs

@@ -0,0 +1,56 @@
+import { n as approvePullRequest, r as createIssueComment, y as responseStatus } from "./chunk-github-api.mjs";
+import { r as resolvePullRequest } from "./chunk-pull-request2.mjs";
+import { GitHubOperation } from "#types";
+import * as Operation from "@dxos/compute/Operation";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as Option from "effect/Option";
+//#region src/approval.ts
+/**
+* Machine-readable marker carried by an approval posted as a comment.
+*
+* An HTML comment renders as nothing on GitHub, so the marker is invisible to a human reader while
+* remaining an exact string for an agent polling the conversation — which is the point: a comment
+* fallback has to be as detectable as the review state it stands in for.
+*/
+var APPROVAL_MARKER = "<!-- dxos:approval state=approved -->";
+/** Prose shown above the marker; states why the approval is a comment rather than a review. */
+var APPROVAL_TEXT = "Approved — good to land.\n\n_GitHub declined an approving review from this connection (a pull request cannot be approved by its own author, and some tokens carry no review permission), so the approval is recorded here._";
+/** Body of the fallback comment: the reviewer's own summary, the standing text, and the marker. */
+var approvalCommentBody = (body) => [
+	body?.trim(),
+	APPROVAL_TEXT,
+	APPROVAL_MARKER
+].filter(Boolean).join("\n\n");
+/**
+* Whether an approving review failed for a reason a comment can stand in for.
+*
+* `422` is GitHub's answer to approving one's own pull request, `403` to a token without review
+* permission on the repository. Anything else (a rejected credential, a deleted pull request, a
+* network fault) is a real failure and must surface rather than turn into a comment.
+*/
+var isApprovalRefused = (error) => {
+	const status = responseStatus(error);
+	return status === 403 || status === 422;
+};
+//#endregion
+//#region src/operations/submit-pull-request-approval.ts
+var handler = GitHubOperation.SubmitPullRequestApproval.pipe(Operation.withHandler(Effect.fn(function* ({ pullRequest: ref, body }) {
+	const { pullRequest, credentials } = yield* resolvePullRequest(ref);
+	const { owner, repo, number } = pullRequest;
+	const review = yield* approvePullRequest(owner, repo, number, body).pipe(Effect.provide(credentials), Effect.asSome, Effect.catchIf(isApprovalRefused, () => Effect.succeedNone));
+	if (Option.isSome(review)) return {
+		reviewId: review.value.id,
+		commented: false
+	};
+	const comment = yield* createIssueComment(owner, repo, number, approvalCommentBody(body)).pipe(Effect.provide(credentials));
+	return {
+		commentId: comment.id,
+		url: comment.html_url ?? void 0,
+		commented: true
+	};
+}, Effect.provide(FetchHttpClient.layer))));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-submit-pull-request-approval.mjs.map

package/dist/lib/chunk-submit-pull-request-approval.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-submit-pull-request-approval.mjs","names":[],"sources":["../../src/approval.ts","../../src/operations/submit-pull-request-approval.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { GitHubApi } from './services/index.ts';\n\n/**\n * Machine-readable marker carried by an approval posted as a comment.\n *\n * An HTML comment renders as nothing on GitHub, so the marker is invisible to a human reader while\n * remaining an exact string for an agent polling the conversation — which is the point: a comment\n * fallback has to be as detectable as the review state it stands in for.\n */\nexport const APPROVAL_MARKER = '<!-- dxos:approval state=approved -->';\n\n/** Prose shown above the marker; states why the approval is a comment rather than a review. */\nconst APPROVAL_TEXT =\n  'Approved — good to land.\\n\\n' +\n  '_GitHub declined an approving review from this connection (a pull request cannot be approved by ' +\n  'its own author, and some tokens carry no review permission), so the approval is recorded here._';\n\n/** Body of the fallback comment: the reviewer's own summary, the standing text, and the marker. */\nexport const approvalCommentBody = (body?: string): string =>\n  [body?.trim(), APPROVAL_TEXT, APPROVAL_MARKER].filter(Boolean).join('\\n\\n');\n\n/** Whether a comment body records an approval — the detector an agent runs over a PR's comments. */\nexport const isApprovalComment = (body: string): boolean => body.includes(APPROVAL_MARKER);\n\n/**\n * Whether an approving review failed for a reason a comment can stand in for.\n *\n * `422` is GitHub's answer to approving one's own pull request, `403` to a token without review\n * permission on the repository. Anything else (a rejected credential, a deleted pull request, a\n * network fault) is a real failure and must surface rather than turn into a comment.\n */\nexport const isApprovalRefused = (error: unknown): boolean => {\n  const status = GitHubApi.responseStatus(error);\n  return status === 403 || status === 422;\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as FetchHttpClient from 'effect/http/FetchHttpClient';\nimport * as Option from 'effect/Option';\n\nimport * as Operation from '@dxos/compute/Operation';\n\nimport { GitHubOperation } from '#types';\n\nimport { approvalCommentBody, isApprovalRefused } from '../approval.ts';\nimport { GitHubApi } from '../services/index.ts';\nimport { resolvePullRequest } from './pull-request.ts';\n\nconst handler: Operation.WithHandler<typeof GitHubOperation.SubmitPullRequestApproval> =\n  GitHubOperation.SubmitPullRequestApproval.pipe(\n    Operation.withHandler(\n      Effect.fn(function* ({ pullRequest: ref, body }) {\n        const { pullRequest, credentials } = yield* resolvePullRequest(ref);\n        const { owner, repo, number } = pullRequest;\n        const review = yield* GitHubApi.approvePullRequest(owner, repo, number, body).pipe(\n          Effect.provide(credentials),\n          Effect.asSome,\n          // Only a refusal to review becomes a comment; every other failure stays a failure.\n          Effect.catchIf(isApprovalRefused, () => Effect.succeedNone),\n        );\n        if (Option.isSome(review)) {\n          return { reviewId: review.value.id, commented: false };\n        }\n\n        const comment = yield* GitHubApi.createIssueComment(owner, repo, number, approvalCommentBody(body)).pipe(\n          Effect.provide(credentials),\n        );\n        return { commentId: comment.id, url: comment.html_url ?? undefined, commented: true };\n      }, Effect.provide(FetchHttpClient.layer)),\n    ),\n  );\n\nexport default handler;\n"],"mappings":";;;;;;;;;;;;;;;AAaA,IAAa,kBAAkB;;AAG/B,IAAM,gBACJ;;AAKF,IAAa,uBAAuB,SAClC;CAAC,MAAM,KAAK;CAAG;CAAe;AAAe,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,MAAM;;;;;;;;AAY5E,IAAa,qBAAqB,UAA4B;CAC5D,MAAM,SAAS,eAAyB,KAAK;CAC7C,OAAO,WAAW,OAAO,WAAW;AACtC;;;ACtBA,IAAM,UACJ,gBAAgB,0BAA0B,KACxC,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,aAAa,KAAK,QAAQ;CAC/C,MAAM,EAAE,aAAa,gBAAgB,OAAO,mBAAmB,GAAG;CAClE,MAAM,EAAE,OAAO,MAAM,WAAW;CAChC,MAAM,SAAS,OAAO,mBAA6B,OAAO,MAAM,QAAQ,IAAI,CAAC,CAAC,KAC5E,OAAO,QAAQ,WAAW,GAC1B,OAAO,QAEP,OAAO,QAAQ,yBAAyB,OAAO,WAAW,CAC5D;CACA,IAAI,OAAO,OAAO,MAAM,GACtB,OAAO;EAAE,UAAU,OAAO,MAAM;EAAI,WAAW;CAAM;CAGvD,MAAM,UAAU,OAAO,mBAA6B,OAAO,MAAM,QAAQ,oBAAoB,IAAI,CAAC,CAAC,CAAC,KAClG,OAAO,QAAQ,WAAW,CAC5B;CACA,OAAO;EAAE,WAAW,QAAQ;EAAI,KAAK,QAAQ,YAAY,KAAA;EAAW,WAAW;CAAK;AACtF,GAAG,OAAO,QAAQ,gBAAgB,KAAK,CAAC,CAC1C,CACF"}

package/dist/lib/chunk-sync-pull-request.mjs

@@ -0,0 +1,26 @@
+import { n as githubToken, r as resolvePullRequest } from "./chunk-pull-request2.mjs";
+import { i as refreshPullRequest, n as ensureRefreshTrigger } from "./chunk-import-pull-request.mjs";
+import { GitHubOperation } from "#types";
+import * as Operation from "@dxos/compute/Operation";
+import * as Effect from "effect/Effect";
+import { Database } from "@dxos/echo";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import { log } from "@dxos/log";
+//#region src/operations/sync-pull-request.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-github/src/operations/sync-pull-request.ts";
+var handler = GitHubOperation.SyncPullRequest.pipe(Operation.withHandler(Effect.fn(function* ({ pullRequest: ref }) {
+	const { pullRequest, db } = yield* resolvePullRequest(ref);
+	const token = yield* githubToken().pipe(Effect.provide(Database.layer(db)));
+	const updated = yield* refreshPullRequest(pullRequest, token);
+	yield* ensureRefreshTrigger().pipe(Effect.provide(Database.layer(db)), Effect.catchDefect((defect) => Effect.sync(() => log.warn("refresh trigger setup failed", { defect }, {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 27,
+		S: this
+	}))));
+	return { updated };
+}, Effect.provide(FetchHttpClient.layer))));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-sync-pull-request.mjs.map

package/dist/lib/chunk-sync-pull-request.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-sync-pull-request.mjs","names":[],"sources":["../../src/operations/sync-pull-request.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as FetchHttpClient from 'effect/http/FetchHttpClient';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database } from '@dxos/echo';\nimport { log } from '@dxos/log';\n\nimport { GitHubOperation } from '#types';\n\nimport { githubToken, resolvePullRequest } from './pull-request.ts';\nimport { ensureRefreshTrigger, refreshPullRequest } from './refresh.ts';\n\nconst handler: Operation.WithHandler<typeof GitHubOperation.SyncPullRequest> = GitHubOperation.SyncPullRequest.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ pullRequest: ref }) {\n      const { pullRequest, db } = yield* resolvePullRequest(ref);\n      const token = yield* githubToken().pipe(Effect.provide(Database.layer(db)));\n      const updated = yield* refreshPullRequest(pullRequest, token);\n      // Spaces that imported pull requests before the scheduled refresh existed get it on next open.\n      yield* ensureRefreshTrigger().pipe(\n        Effect.provide(Database.layer(db)),\n        // The refresh already succeeded; the schedule is retried on the next open.\n        Effect.catchDefect((defect) => Effect.sync(() => log.warn('refresh trigger setup failed', { defect }))),\n      );\n      return { updated };\n    }, Effect.provide(FetchHttpClient.layer)),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;;;;;;AAgBA,IAAM,UAAyE,gBAAgB,gBAAgB,KAC7G,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,aAAa,OAAO;CACzC,MAAM,EAAE,aAAa,OAAO,OAAO,mBAAmB,GAAG;CACzD,MAAM,QAAQ,OAAO,YAAY,CAAC,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC;CAC1E,MAAM,UAAU,OAAO,mBAAmB,aAAa,KAAK;CAE5D,OAAO,qBAAqB,CAAC,CAAC,KAC5B,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,GAEjC,OAAO,aAAa,WAAW,OAAO,WAAW,IAAI,KAAK,gCAAgC,EAAE,OAAO,GAAA;EAAA,YAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA;CAAA,CAAC,CAAC,CAAC,CACxG;CACA,OAAO,EAAE,QAAQ;AACnB,GAAG,OAAO,QAAQ,gBAAgB,KAAK,CAAC,CAC1C,CACF"}