@xpufx/paseo-forges 0.1.0 → 0.1.2

package/client/active-forge.ts

@@ -8,7 +8,7 @@ import {
   resolveForgeTarget,
   type ForgeRepoIdentity,
 } from "../shared/issues.js";
-import { usePluginSettings, useRpcQuery } from "paseo-plugin-helper/client";
+import { usePluginSettings, useRpcQuery } from "./vendor/paseo-plugin-helper/index";
 
 /** Workspace directory backing an agent, or undefined while it cannot resolve. */
 export function useAgentDirectory(agentId: string): string | undefined {

package/client/board-alert.tsx

@@ -8,7 +8,7 @@ import type {
 import {
   Badge,
   ForgeIcon,
-} from "paseo-plugin-helper/client";
+} from "./vendor/paseo-plugin-helper/index";
 import {
   boardAlertTimelineSchema,
   classifyForgeUrl,

package/client/foreign-link.tsx

@@ -1,6 +1,6 @@
 import React from "react";
 import { Text } from "react-native";
-import { Badge } from "paseo-plugin-helper/client";
+import { Badge } from "./vendor/paseo-plugin-helper/index";
 
 /** Shared label for the cross-repo marker, so every surface reads the same. */
 export const FOREIGN_LINK_LABEL = "foreign";

package/client/hook-queue-panel.tsx

@@ -18,7 +18,7 @@ import {
   useRpcMutation,
   usePluginTheme,
   copyToClipboard,
-} from "paseo-plugin-helper/client";
+} from "./vendor/paseo-plugin-helper/index";
 import {
   hookStatusContract,
   hookQueuesContract,

package/client/issues-pill.tsx

@@ -31,8 +31,8 @@ import {
   getClientHost,
   type RenderModalProps,
   type RenderPillProps,
-} from "paseo-plugin-helper/client";
-import { hasFuzzyHighlight, normalizeSearchQuery } from "paseo-plugin-helper/shared";
+} from "./vendor/paseo-plugin-helper/index";
+import { hasFuzzyHighlight, normalizeSearchQuery } from "../shared/vendor/paseo-plugin-helper/index";
 import { HookQueueView } from "./hook-queue-panel.js";
 import {
   ATTENTION_LABELS,

package/client/label-chip.tsx

@@ -1,6 +1,6 @@
 import React from "react";
 import { View, type StyleProp, type ViewStyle } from "react-native";
-import { Badge, usePluginTheme } from "paseo-plugin-helper/client";
+import { Badge, usePluginTheme } from "./vendor/paseo-plugin-helper/index";
 import { planLabelChip, type ForgeLabel, type LabelChipHalf } from "../shared/issues.js";
 
 /** Inner corners join the halves; the scope's right border becomes the divider. */

package/client/linkifier.tsx

@@ -8,7 +8,7 @@ import type {
 } from "@getpaseo/plugin/client";
 import type { PluginTheme } from "@getpaseo/plugin";
 import { Icon } from "@getpaseo/plugin/client/react-native";
-import { ForgeIcon, copyToClipboard } from "paseo-plugin-helper/client";
+import { ForgeIcon, copyToClipboard } from "./vendor/paseo-plugin-helper/index";
 import {
   classifyForgeLink,
   classifyForgeUrl,

package/client/notification-card.tsx

@@ -0,0 +1,71 @@
+import React from "react";
+import { StyleSheet, Text, View } from "react-native";
+import type {
+  PluginTimelineItemProps,
+  PluginTimelineRendererContribution,
+  PluginTimelineTransformerContribution,
+} from "@getpaseo/plugin/client";
+import { Icon } from "@getpaseo/plugin/client/react-native";
+import { Badge } from "./vendor/paseo-plugin-helper/index";
+import {
+  forgejoNotificationCardSchema,
+  forgejoNotificationItem,
+  type ForgejoNotificationCardData,
+} from "../shared/notification.js";
+
+/**
+ * Forgejo digest notifications are emitted as host `notification` rows rather
+ * than chat messages. Turn them into a typed card without claiming unrelated
+ * notifications (including provider errors and other plugins' notices).
+ */
+export const forgejoNotificationTransformer: PluginTimelineTransformerContribution<"notification"> = {
+  id: "forgejo-notification",
+  query: { itemType: "notification" },
+  transform({ item }) {
+    return forgejoNotificationItem(item);
+  },
+};
+
+function levelColor(
+  theme: PluginTimelineItemProps<ForgejoNotificationCardData>["theme"],
+  level: ForgejoNotificationCardData["level"],
+) {
+  if (level === "error") return theme.colors.statusDanger;
+  if (level === "warning") return theme.colors.statusWarning;
+  return theme.colors.accent;
+}
+
+export function ForgejoNotificationCard({
+  item,
+  theme,
+}: PluginTimelineItemProps<ForgejoNotificationCardData>) {
+  const color = levelColor(theme, item.data.level);
+  return (
+    <View style={[styles.card, { backgroundColor: theme.colors.surface1, borderColor: theme.colors.border }]}>
+      <View style={styles.header}>
+        <Icon name="Bell" size={14} color={color} />
+        <Text style={[styles.title, { color: theme.colors.foreground }]}>Forgejo digest</Text>
+        <Badge variant={item.data.level === "error" ? "danger" : item.data.level === "warning" ? "warning" : "info"} label={item.data.level} />
+      </View>
+      <Text style={[styles.message, { color: theme.colors.foreground }]}>{item.data.message}</Text>
+      <Text style={[styles.footer, { color: theme.colors.foregroundMuted }]}>via forges</Text>
+    </View>
+  );
+}
+
+export const forgejoNotificationRenderer: PluginTimelineRendererContribution<
+  typeof forgejoNotificationCardSchema
+> = {
+  kind: "forgejo-notification",
+  version: 1,
+  schema: forgejoNotificationCardSchema,
+  Component: ForgejoNotificationCard,
+};
+
+const styles = StyleSheet.create({
+  card: { borderRadius: 8, borderWidth: 1, padding: 8, marginVertical: 2, gap: 6 },
+  header: { flexDirection: "row", alignItems: "center", gap: 6 },
+  title: { fontSize: 12, fontWeight: "600", flex: 1 },
+  message: { fontSize: 13 },
+  footer: { fontSize: 10, fontStyle: "italic" },
+});

package/client/vendor/paseo-plugin-helper/utils/clipboard.ts

@@ -24,16 +24,23 @@ export interface ClipboardEnvironment {
  * `react-native-web` `Clipboard.setString` reports success even when its
  * `document.execCommand("copy")` fails, which leaves the previous clipboard
  * item in place while the UI claims success (xpufx-org/paseo#278); it is only
- * usable off-DOM (native), where it is the real platform clipboard. In a DOM
- * the checked `execCommand` fallback is preferred to that unverifiable path.
+ * usable off-DOM (native), where it is the real platform clipboard. The same
+ * applies to any `setStringAsync` whose DOM fallback is that unverified
+ * `execCommand`. In a DOM the checked `execCommand` fallback is preferred to
+ * those unverifiable paths.
  */
 export function clipboardTierOrder(env: ClipboardEnvironment): ClipboardTier[] {
   const tiers: ClipboardTier[] = [];
   if (env.hasNavigatorClipboard) tiers.push("navigator");
   if (env.hasHostCopyText) tiers.push("host");
-  if (env.hasRnSetStringAsync) {
+  // On a DOM both RN-web paths are unverifiable: `setString` reports success
+  // even when its `execCommand` no-ops, and a `setStringAsync` that falls back
+  // to it does the same. Off-DOM they are the real native clipboard, so they
+  // lead there; on a DOM only the checked `execCommand` fallback is honest.
+  const rnDomOk = !env.isDom;
+  if (env.hasRnSetStringAsync && rnDomOk) {
     tiers.push("rnAsync");
-  } else if (env.hasRnClipboard && !env.isDom) {
+  } else if (env.hasRnClipboard && rnDomOk) {
     tiers.push("rnSync");
   }
   tiers.push("execCommand");

package/client/webhook-card.tsx

@@ -6,7 +6,7 @@ import type {
   PluginTimelineTransformerContribution,
 } from "@getpaseo/plugin/client";
 import type { PluginTheme } from "@getpaseo/plugin";
-import { Badge, ForgeIcon, Icon } from "paseo-plugin-helper/client";
+import { Badge, ForgeIcon, Icon } from "./vendor/paseo-plugin-helper/index";
 import {
   forgejoWebhookCardSchema,
   forgejoWebhookItem,

package/index.client.tsx

@@ -0,0 +1,127 @@
+import type { PluginClientContext } from "@getpaseo/plugin/client";
+import { useRpc } from "@getpaseo/plugin/client";
+import { Icon, Modal, useToast, ScrollView, FlatList, TextInput as HostTextInput, copyText } from "@getpaseo/plugin/client/react-native";
+import {
+  initClientHelpers,
+  registerComposerPill,
+  registerSidebarSurface,
+} from "./client/vendor/paseo-plugin-helper/index";
+import {
+  ISSUES_PILL_ID,
+  ForgePill,
+  ForgeIssuesModal,
+  ForgeIssuesPanel,
+} from "./client/issues-pill.js";
+import { createForgeLabelResolver } from "./client/pill-label.js";
+import {
+  forgeLinkUserTransformer,
+  forgeLinkAssistantTransformer,
+  forgeLinkRenderer,
+} from "./client/linkifier.js";
+import {
+  forgeBoardAlertUserTransformer,
+  forgeBoardAlertAssistantTransformer,
+  forgeBoardAlertRenderer,
+} from "./client/board-alert.js";
+import {
+  forgejoWebhookUserTransformer,
+  forgejoWebhookRenderer,
+} from "./client/webhook-card.js";
+import {
+  forgejoNotificationTransformer,
+  forgejoNotificationRenderer,
+} from "./client/notification-card.js";
+import {
+  ForgeHookQueuePanel,
+  ForgeHookQueueSurface,
+} from "./client/hook-queue-panel.js";
+
+initClientHelpers({ Icon, Modal, useRpc, useToast, copyText, ScrollView, FlatList, TextInput: HostTextInput });
+
+export default function contribute(client: PluginClientContext) {
+  // Hook cards are registered before the linkifier: first-match-wins, and hook
+  // messages carry a bare issue URL the linkifier would otherwise claim.
+  const removeWebhookUser = client.addTimelineTransformer(forgejoWebhookUserTransformer);
+  const removeWebhookRenderer = client.addTimelineRenderer(forgejoWebhookRenderer);
+  const removeNotification = client.addTimelineTransformer(forgejoNotificationTransformer);
+  const removeNotificationRenderer = client.addTimelineRenderer(forgejoNotificationRenderer);
+  const removeUserLink = client.addTimelineTransformer(forgeLinkUserTransformer);
+  const removeAssistantLink = client.addTimelineTransformer(forgeLinkAssistantTransformer);
+  const removeLinkRenderer = client.addTimelineRenderer(forgeLinkRenderer);
+  const removeBoardAlertUser = client.addTimelineTransformer(forgeBoardAlertUserTransformer);
+  const removeBoardAlertAssistant = client.addTimelineTransformer(forgeBoardAlertAssistantTransformer);
+  const removeBoardAlertRenderer = client.addTimelineRenderer(forgeBoardAlertRenderer);
+
+  // RPC is host-provided and absent on some older hosts; the resolver degrades
+  // to the workspace-name / ellipsis fallback instead of failing registration.
+  const rawRpc = typeof client.rpc === "function" ? client.rpc.bind(client) : null;
+  const forgeLabel = createForgeLabelResolver({
+    rpc: (contract, input) =>
+      rawRpc
+        ? (rawRpc(contract as never, input as never) as Promise<unknown>)
+        : Promise.reject(new Error("client.rpc unavailable")),
+    resolveWorkspace: async (workspaceId) => {
+      const workspace = await client.paseo.workspaces.ref(workspaceId).refresh();
+      return workspace
+        ? {
+            directory: workspace.workspaceDirectory ?? undefined,
+            projectRootPath: workspace.projectRootPath,
+          }
+        : null;
+    },
+  });
+
+  const removePill = registerComposerPill(client, {
+    id: ISSUES_PILL_ID,
+    title: "issues",
+    modalTitle: "Forge Issues",
+    modalIcon: "GitPullRequest",
+    icon: "GitPullRequest",
+    resolveLabel: (ctx) => forgeLabel.resolve(ctx),
+    refreshIntervalMs: 5000,
+    renderPill: (props) => <ForgePill {...props} />,
+    renderModal: (props) => <ForgeIssuesModal {...props} />,
+  });
+
+  const removePanel = client.addWorkspacePanel({
+    id: "forges-issues",
+    title: "Forge Issues",
+    icon: "GitPullRequest",
+    context: "workspace",
+    locations: ["workspace", "explorer"],
+    Component: ForgeIssuesPanel,
+  });
+
+  const removeQueuePanel = client.addWorkspacePanel({
+    id: "forges-queues",
+    title: "Forge Queues",
+    icon: "Layers",
+    context: "workspace",
+    locations: ["workspace", "explorer"],
+    Component: ForgeHookQueuePanel,
+  });
+
+  const removeQueueSurface = registerSidebarSurface(client, {
+    id: "queues",
+    title: "Forge Queues",
+    icon: "Layers",
+    Component: ForgeHookQueueSurface,
+  });
+
+  return () => {
+    removeQueueSurface?.();
+    removeQueuePanel?.();
+    removePanel();
+    removePill();
+    removeWebhookUser();
+    removeWebhookRenderer();
+    removeNotification();
+    removeNotificationRenderer();
+    removeUserLink();
+    removeAssistantLink();
+    removeLinkRenderer();
+    removeBoardAlertUser();
+    removeBoardAlertAssistant();
+    removeBoardAlertRenderer();
+  };
+}

package/index.server.ts

@@ -0,0 +1,63 @@
+import type { PluginServerContext } from "@getpaseo/plugin/server";
+import { createPluginLogger } from "./server/vendor/paseo-plugin-helper/index";
+import {
+  addCommentContract,
+  createIssueContract,
+  forgeContextContract,
+  forgeSettingsContract,
+  issueDetailContract,
+  openIssuesContract,
+  searchIssuesContract,
+  setLabelContract,
+} from "./shared/issues.js";
+import {
+  handleAddComment,
+  handleCreateIssue,
+  handleForgeContext,
+  handleIssueDetail,
+  handleOpenIssues,
+  handleSearchIssues,
+  handleSetLabel,
+} from "./server/issues.js";
+import { settingsHandlers } from "./server/settings.js";
+import {
+  hookStatusContract,
+  hookQueuesContract,
+  hookPauseContract,
+  hookResumeContract,
+  hookDrainContract,
+} from "./shared/hook-queue.js";
+import {
+  handleHookStatus,
+  handleHookQueues,
+  handleHookPause,
+  handleHookResume,
+  handleHookDrain,
+} from "./server/hook-queue.js";
+
+const log = createPluginLogger("forges");
+
+export default function contribute(server: PluginServerContext) {
+  server.handle(openIssuesContract, handleOpenIssues);
+  server.handle(searchIssuesContract, handleSearchIssues);
+  server.handle(forgeContextContract, handleForgeContext);
+  server.handle(issueDetailContract, handleIssueDetail);
+  server.handle(setLabelContract, handleSetLabel);
+  server.handle(addCommentContract, handleAddComment);
+  server.handle(createIssueContract, handleCreateIssue);
+
+  server.handle(hookStatusContract, handleHookStatus);
+  server.handle(hookQueuesContract, handleHookQueues);
+  server.handle(hookPauseContract, handleHookPause);
+  server.handle(hookResumeContract, handleHookResume);
+  server.handle(hookDrainContract, handleHookDrain);
+
+  // forge.install-labels is operator-only: the optional label-set install is
+  // hidden from the release surface (issue #163). handleInstallLabels stays in
+  // server/issues.ts for our own board; the RPC is deliberately not registered.
+  server.handle(forgeSettingsContract.get, settingsHandlers.get);
+  server.handle(forgeSettingsContract.update, settingsHandlers.update);
+  server.handle(forgeSettingsContract.reset, settingsHandlers.reset);
+  log.info("forges server handlers registered");
+  return () => {};
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpufx/paseo-forges",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Work with Forge/Gitea-family issues from inside Paseo via the embedded fetch API client.",
   "type": "module",
   "private": false,
@@ -8,7 +8,7 @@
   "scripts": {
     "stamp": "node -e \"import('./server/vendor/paseo-plugin-helper/version.ts').then(m => m.stampVersion({ targetFile: 'shared/version.ts' }))\"",
     "typecheck": "tsc --noEmit",
-    "test": "esbuild shared/issues.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-issues.test.mjs --log-level=error && esbuild shared/webhook.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-webhook.test.mjs --log-level=error && esbuild shared/hook-queue.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-hook-queue.test.mjs --log-level=error && esbuild server/git-origin.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-git-origin.test.mjs --log-level=error && esbuild server/registry.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-registry.test.mjs --log-level=error && esbuild server/forge-guard.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-forge-guard.test.mjs --log-level=error && esbuild server/forge-client.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-forge-client.test.mjs --log-level=error && esbuild server/hook-queue.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-server-hook-queue.test.mjs --log-level=error && node --test ${TMPDIR:-/tmp}/paseo-forges-issues.test.mjs ${TMPDIR:-/tmp}/paseo-forges-webhook.test.mjs ${TMPDIR:-/tmp}/paseo-forges-hook-queue.test.mjs ${TMPDIR:-/tmp}/paseo-forges-git-origin.test.mjs ${TMPDIR:-/tmp}/paseo-forges-registry.test.mjs ${TMPDIR:-/tmp}/paseo-forges-forge-guard.test.mjs ${TMPDIR:-/tmp}/paseo-forges-forge-client.test.mjs ${TMPDIR:-/tmp}/paseo-forges-server-hook-queue.test.mjs"
+    "test": "esbuild shared/issues.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-issues.test.mjs --log-level=error && esbuild shared/webhook.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-webhook.test.mjs --log-level=error && esbuild shared/notification.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-notification.test.mjs --log-level=error && esbuild shared/hook-queue.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-hook-queue.test.mjs --log-level=error && esbuild server/git-origin.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-git-origin.test.mjs --log-level=error && esbuild server/registry.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-registry.test.mjs --log-level=error && esbuild server/forge-guard.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-forge-guard.test.mjs --log-level=error && esbuild server/forge-client.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-forge-client.test.mjs --log-level=error && esbuild server/hook-queue.test.ts --bundle --platform=node --format=esm --outfile=${TMPDIR:-/tmp}/paseo-forges-server-hook-queue.test.mjs --log-level=error && node --test ${TMPDIR:-/tmp}/paseo-forges-issues.test.mjs ${TMPDIR:-/tmp}/paseo-forges-webhook.test.mjs ${TMPDIR:-/tmp}/paseo-forges-notification.test.mjs ${TMPDIR:-/tmp}/paseo-forges-hook-queue.test.mjs ${TMPDIR:-/tmp}/paseo-forges-git-origin.test.mjs ${TMPDIR:-/tmp}/paseo-forges-registry.test.mjs ${TMPDIR:-/tmp}/paseo-forges-forge-guard.test.mjs ${TMPDIR:-/tmp}/paseo-forges-forge-client.test.mjs ${TMPDIR:-/tmp}/paseo-forges-server-hook-queue.test.mjs"
   },
   "devDependencies": {
     "@getpaseo/plugin": "0.9.0-beta.2",
@@ -21,6 +21,8 @@
     "paseo-plugin.json",
     "README.md",
     "LICENSE",
+    "index.client.tsx",
+    "index.server.ts",
     "client",
     "server",
     "shared",

package/server/issues.ts

@@ -1,4 +1,4 @@
-import { createPluginLogger } from "paseo-plugin-helper/server";
+import { createPluginLogger } from "./vendor/paseo-plugin-helper/index";
 import {
   INSTALL_LABEL_MODES,
   IssueDetailSchema,
@@ -31,7 +31,7 @@ import {
   type SetLabelOutput,
   validateCreateIssueInput,
 } from "../shared/issues.js";
-import type { RpcOutput } from "paseo-plugin-helper/shared";
+import type { RpcOutput } from "../shared/vendor/paseo-plugin-helper/index";
 import { ForgeClient, type ForgejoIssueDetail } from "./forge-client.js";
 import { ForgeGuard, type GuardLogLevel } from "./forge-guard.js";
 import { gitOriginForDirectory } from "./git-origin.js";

package/server/settings.ts

@@ -2,7 +2,7 @@ import {
   PluginStorage,
   createPluginLogger,
   createSettingsHandlers,
-} from "paseo-plugin-helper/server";
+} from "./vendor/paseo-plugin-helper/index";
 import {
   FORGES_PLUGIN_ID,
   activeForgeForDirectory,

package/shared/hook-queue.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineContract } from "paseo-plugin-helper/shared";
+import { defineContract } from "./vendor/paseo-plugin-helper/index";
 
 export const HookQueueMessageSchema = z.object({
   id: z.string(),

package/shared/issues.ts

@@ -5,7 +5,7 @@ import {
   normalizeForgeHost,
   normalizeSearchQuery,
   truncate,
-} from "paseo-plugin-helper/shared";
+} from "./vendor/paseo-plugin-helper/index";
 
 export const FORGES_PLUGIN_ID = "forges";
 

package/shared/notification.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+
+/** The notification emitted by the Forgejo digest worker. */
+export const FORGEJO_DIGEST_PREFIX = "🔔 Forgejo digest";
+
+export const forgejoNotificationCardSchema = z.object({
+  level: z.enum(["info", "warning", "error"]),
+  message: z.string(),
+});
+
+export type ForgejoNotificationCardData = z.infer<typeof forgejoNotificationCardSchema>;
+
+/**
+ * Creates a presentation-only card for Forgejo digest notifications. Other
+ * host notifications deliberately pass through to the host renderer: this
+ * plugin owns the digest format, not the notification timeline type itself.
+ */
+export function forgejoNotificationItem(item: {
+  level: ForgejoNotificationCardData["level"];
+  message: string;
+}) {
+  if (!item.message.trimStart().startsWith(FORGEJO_DIGEST_PREFIX)) return undefined;
+  return {
+    items: [
+      {
+        type: "plugin" as const,
+        kind: "forgejo-notification",
+        version: 1,
+        data: { level: item.level, message: item.message },
+      },
+    ],
+  };
+}