paperclip-github-plugin 0.4.7 → 0.4.9

package/README.md

@@ -33,8 +33,8 @@ The plugin adds a full in-host workflow instead of a one-off import script:
 - a dashboard widget that shows readiness, sync status, and last-run results
 - saved sync diagnostics that let operators inspect the latest per-issue failures, raw errors, and suggested next steps
 - a project sidebar item that opens a live project-scoped Pull Requests page for the mapped repository and can show the open PR count through a lightweight badge read
-- manual sync actions from global, project, and issue toolbar surfaces
-- a GitHub detail tab on synced Paperclip issues that stays hidden for Paperclip issues with no linked GitHub issue
+- manual sync actions from global, project, and issue surfaces
+- a GitHub detail tab on synced Paperclip issues that stays hidden for Paperclip issues with no linked GitHub issue and includes GitHub-marked action buttons plus the GitHub issue creator with avatar
 - GitHub link annotations on sync-generated status transition comments when the host supports comment annotations
 
 ## How it works

package/dist/manifest.js

@@ -511,7 +511,7 @@ var require2 = createRequire(import.meta.url);
 var packageJson = require2("../package.json");
 var DASHBOARD_WIDGET_CAPABILITY = "ui.dashboardWidget.register";
 var SCHEDULE_TICK_CRON = "* * * * *";
-var MANIFEST_VERSION = "0.4.7"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var MANIFEST_VERSION = "0.4.9"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
 var manifest = {
   id: "paperclip-github-plugin",
   apiVersion: 1,

package/dist/ui/index.js

@@ -22868,6 +22868,12 @@ function LoadingIconButtonContent(props) {
 function LoadingSkeleton(props) {
   return /* @__PURE__ */ jsx2("span", { "aria-hidden": "true", className: ["ghsync__skeleton", props.className].filter(Boolean).join(" "), style: props.style });
 }
+function GitHubButtonLabel(props) {
+  return /* @__PURE__ */ jsxs2("span", { className: "ghsync__button-content", children: [
+    /* @__PURE__ */ jsx2(GitHubMarkIcon, { className: "ghsync-prs-icon" }),
+    /* @__PURE__ */ jsx2("span", { children: props.label })
+  ] });
+}
 var PROJECT_PULL_REQUESTS_PAGE_ROUTE_PATH = "github-pull-requests";
 var LIGHT_PALETTE = {
   text: "#18181b",
@@ -26422,6 +26428,36 @@ var EXTENSION_SURFACE_STYLES = `
     align-items: start;
   }
 
+  .ghsync-issue-detail__actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 8px;
+    align-items: center;
+    justify-content: flex-end;
+  }
+
+  .ghsync-issue-detail__headline {
+    display: grid;
+    gap: 8px;
+    min-width: 0;
+  }
+
+  .ghsync-issue-detail__creator-row {
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: 8px;
+  }
+
+  .ghsync-issue-detail__creator-label {
+    color: var(--ghsync-muted);
+    font-size: 11px;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    line-height: 1;
+    text-transform: uppercase;
+  }
+
   .ghsync-extension-heading h3,
   .ghsync-extension-heading h4 {
     margin: 0;
@@ -27226,6 +27262,22 @@ function formatShortDateTime(value, fallback = "Unknown time") {
 function pluralize(count, singular, plural = `${singular}s`) {
   return `${count} ${count === 1 ? singular : plural}`;
 }
+function resolvePreviewPersonLabels(person) {
+  const displayHandle = person.handle.trim();
+  const displayName = person.name.trim() || displayHandle || "Unknown user";
+  const normalizedName = displayName.replace(/^@/, "").trim().toLowerCase();
+  const normalizedHandle = displayHandle.replace(/^@/, "").trim().toLowerCase();
+  if (displayHandle && normalizedName && normalizedHandle && normalizedName === normalizedHandle) {
+    return {
+      primary: displayHandle,
+      secondary: null
+    };
+  }
+  return {
+    primary: displayName,
+    secondary: displayHandle && displayHandle !== displayName ? displayHandle : null
+  };
+}
 function hashString(value) {
   let hash = 0;
   for (const character of value) {
@@ -28730,17 +28782,38 @@ function SyncDiagnosticsPanel(props) {
 function PreviewAvatar(props) {
   const backgroundColor = getPreviewAvatarColor(props.person.handle);
   const className = props.stacked ? "ghsync-prs-avatar-stack__item" : "ghsync-prs-avatar";
+  const avatarSizePx = props.size === "sm" ? 20 : 28;
+  const fontSizePx = props.size === "sm" ? 10 : 11;
+  const labels = resolvePreviewPersonLabels(props.person);
+  const initialsSource = props.person.name.trim() || props.person.handle.replace(/^@/, "").trim();
+  const title = labels.secondary ? `${labels.primary} (${labels.secondary})` : labels.primary;
   return /* @__PURE__ */ jsx2(
     "span",
     {
       className,
-      style: { backgroundColor },
-      title: `${props.person.name} (${props.person.handle})`,
+      style: {
+        backgroundColor,
+        width: avatarSizePx,
+        height: avatarSizePx,
+        fontSize: fontSizePx
+      },
+      title,
       "aria-hidden": "true",
-      children: props.person.avatarUrl ? /* @__PURE__ */ jsx2("img", { src: props.person.avatarUrl, alt: "", loading: "lazy" }) : getInitials(props.person.name)
+      children: props.person.avatarUrl ? /* @__PURE__ */ jsx2("img", { src: props.person.avatarUrl, alt: "", loading: "lazy" }) : getInitials(initialsSource)
     }
   );
 }
+function PreviewPersonCopy(props) {
+  const labels = resolvePreviewPersonLabels(props.person);
+  return /* @__PURE__ */ jsxs2("span", { className: "ghsync-prs-table__person-copy", children: [
+    /* @__PURE__ */ jsx2("span", { className: "ghsync-prs-table__person-name", children: labels.primary }),
+    labels.secondary ? /* @__PURE__ */ jsx2("span", { className: "ghsync-prs-table__person-handle", children: labels.secondary }) : null
+  ] });
+}
+function PreviewPersonInlineLabel(props) {
+  const labels = resolvePreviewPersonLabels(props.person);
+  return /* @__PURE__ */ jsx2("span", { children: labels.secondary ? `${labels.primary} (${labels.secondary})` : labels.primary });
+}
 function PreviewMarkdown(props) {
   return /* @__PURE__ */ jsx2("div", { className: "ghsync-prs-markdown paperclip-markdown prose prose-sm max-w-none break-words overflow-hidden", children: /* @__PURE__ */ jsx2(
     Markdown,
@@ -29922,10 +29995,7 @@ function GitHubSyncProjectPullRequestsPage() {
                         rel: "noreferrer",
                         children: [
                           /* @__PURE__ */ jsx2(PreviewAvatar, { person: pullRequest.author }),
-                          /* @__PURE__ */ jsxs2("span", { className: "ghsync-prs-table__person-copy", children: [
-                            /* @__PURE__ */ jsx2("span", { className: "ghsync-prs-table__person-name", children: pullRequest.author.name }),
-                            /* @__PURE__ */ jsx2("span", { className: "ghsync-prs-table__person-handle", children: pullRequest.author.handle })
-                          ] })
+                          /* @__PURE__ */ jsx2(PreviewPersonCopy, { person: pullRequest.author })
                         ]
                       }
                     ) }),
@@ -30411,12 +30481,7 @@ function GitHubSyncProjectPullRequestsPage() {
                   /* @__PURE__ */ jsx2("span", { className: "ghsync-prs-meta__label", children: "Author" }),
                   /* @__PURE__ */ jsxs2("div", { className: "ghsync-prs-meta__value ghsync-prs-meta__value--stack", children: [
                     /* @__PURE__ */ jsx2(PreviewAvatar, { person: selectedPullRequest.author }),
-                    /* @__PURE__ */ jsxs2("span", { children: [
-                      selectedPullRequest.author.name,
-                      " (",
-                      selectedPullRequest.author.handle,
-                      ")"
-                    ] })
+                    /* @__PURE__ */ jsx2(PreviewPersonInlineLabel, { person: selectedPullRequest.author })
                   ] })
                 ] }),
                 /* @__PURE__ */ jsxs2("div", { className: "ghsync-prs-meta__row", children: [
@@ -33133,10 +33198,9 @@ function PullRequestCopilotActionMenu(props) {
   );
 }
 function GitHubSyncToolbarButtonSurface(props) {
-  const toast = usePluginToast();
-  const runSyncNow = usePluginAction("sync.runNow");
-  const cancelSync = usePluginAction("sync.cancel");
-  const pluginIdFromLocation = getPluginIdFromLocation();
+  const themeMode = useResolvedThemeMode();
+  const theme = themeMode === "light" ? LIGHT_PALETTE : DARK_PALETTE;
+  const themeVars = buildThemeVars(theme, themeMode);
   const surfaceRef = useRef(null);
   const resolvedIssue = useResolvedIssueId({
     companyId: props.companyId,
@@ -33144,7 +33208,70 @@ function GitHubSyncToolbarButtonSurface(props) {
     entityId: props.entityId,
     entityType: props.entityType
   });
-  const effectiveEntityId = props.entityType === "issue" ? resolvedIssue.issueId ?? "__ghsync_unresolved_issue__" : props.entityId;
+  const buttonController = useGitHubSyncButtonController({
+    ...props,
+    resolvedIssueId: resolvedIssue.issueId
+  });
+  useEffect2(() => {
+    if (!props.entityType) {
+      return;
+    }
+    const hostWrapper = surfaceRef.current?.parentElement;
+    if (!hostWrapper) {
+      return;
+    }
+    const previousMarginLeft = hostWrapper.style.marginLeft;
+    const previousMarginInlineStart = hostWrapper.style.marginInlineStart;
+    hostWrapper.style.marginLeft = "auto";
+    hostWrapper.style.marginInlineStart = "auto";
+    return () => {
+      hostWrapper.style.marginLeft = previousMarginLeft;
+      hostWrapper.style.marginInlineStart = previousMarginInlineStart;
+    };
+  }, [props.entityType]);
+  if (!buttonController.visible) {
+    return null;
+  }
+  return /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      ref: surfaceRef,
+      className: `ghsync-toolbar-button${props.entityType ? " ghsync-toolbar-button--entity" : ""}`,
+      style: themeVars,
+      title: buttonController.title,
+      children: [
+        /* @__PURE__ */ jsx2("style", { children: EXTENSION_SURFACE_STYLES }),
+        /* @__PURE__ */ jsx2(
+          "button",
+          {
+            type: "button",
+            "data-slot": "button",
+            "data-variant": "outline",
+            "data-size": "sm",
+            className: props.entityType ? HOST_ENTITY_BUTTON_CLASSNAME : HOST_GLOBAL_BUTTON_CLASSNAME,
+            disabled: buttonController.disabled,
+            onClick: buttonController.onClick,
+            children: /* @__PURE__ */ jsx2(
+              LoadingButtonContent,
+              {
+                busy: buttonController.busy,
+                label: buttonController.label,
+                busyLabel: buttonController.busyLabel,
+                icon: /* @__PURE__ */ jsx2(GitHubMarkIcon, { className: "h-3.5 w-3.5" })
+              }
+            )
+          }
+        )
+      ]
+    }
+  );
+}
+function useGitHubSyncButtonController(props) {
+  const toast = usePluginToast();
+  const runSyncNow = usePluginAction("sync.runNow");
+  const cancelSync = usePluginAction("sync.cancel");
+  const pluginIdFromLocation = getPluginIdFromLocation();
+  const effectiveEntityId = props.entityType === "issue" ? props.resolvedIssueId ?? "__ghsync_unresolved_issue__" : props.entityId;
   const toolbarState = usePluginData("sync.toolbarState", {
     ...props.companyId ? { companyId: props.companyId } : {},
     ...effectiveEntityId ? { entityId: effectiveEntityId } : {},
@@ -33157,10 +33284,7 @@ function GitHubSyncToolbarButtonSurface(props) {
   const [runningSync, setRunningSync] = useState2(false);
   const [cancellingSync, setCancellingSync] = useState2(false);
   const [syncStateOverride, setSyncStateOverride] = useState2(null);
-  const themeMode = useResolvedThemeMode();
   const boardAccessRequirement = usePaperclipBoardAccessRequirement();
-  const theme = themeMode === "light" ? LIGHT_PALETTE : DARK_PALETTE;
-  const themeVars = buildThemeVars(theme, themeMode);
   const state = toolbarState.data ?? {
     kind: props.entityType ?? "global",
     visible: !props.entityType,
@@ -33192,9 +33316,7 @@ function GitHubSyncToolbarButtonSurface(props) {
     disabled: toolbarButtonDisabled,
     label: toolbarButtonLabel,
     busyLabel: toolbarButtonBusyLabel,
-    syncPersistedRunning,
-    syncStartPending,
-    cancellationRequested
+    syncPersistedRunning
   } = toolbarButtonState;
   const armSyncCompletionToast = useSyncCompletionToast(effectiveSyncState, toast);
   useEffect2(() => {
@@ -33256,26 +33378,6 @@ function GitHubSyncToolbarButtonSurface(props) {
       document.removeEventListener("visibilitychange", handleVisibilityChange);
     };
   }, [toolbarState.refresh, settingsRegistration.refresh, props.companyId, effectiveEntityId, props.entityType]);
-  useEffect2(() => {
-    if (!props.entityType) {
-      return;
-    }
-    const hostWrapper = surfaceRef.current?.parentElement;
-    if (!hostWrapper) {
-      return;
-    }
-    const previousMarginLeft = hostWrapper.style.marginLeft;
-    const previousMarginInlineStart = hostWrapper.style.marginInlineStart;
-    hostWrapper.style.marginLeft = "auto";
-    hostWrapper.style.marginInlineStart = "auto";
-    return () => {
-      hostWrapper.style.marginLeft = previousMarginLeft;
-      hostWrapper.style.marginInlineStart = previousMarginInlineStart;
-    };
-  });
-  if (!state.visible) {
-    return null;
-  }
   async function handleRunSync() {
     try {
       if (!effectiveCanRun) {
@@ -33287,7 +33389,7 @@ function GitHubSyncToolbarButtonSurface(props) {
         waitForCompletion: false,
         ...props.companyId ? { companyId: props.companyId } : {},
         ...props.entityType === "project" && props.entityId ? { projectId: props.entityId } : {},
-        ...props.entityType === "issue" && resolvedIssue.issueId ? { issueId: resolvedIssue.issueId } : {},
+        ...props.entityType === "issue" && props.resolvedIssueId ? { issueId: props.resolvedIssueId } : {},
         ...trustedPaperclipApiBaseUrl ? { paperclipApiBaseUrl: trustedPaperclipApiBaseUrl } : {}
       });
       const nextSyncState = result.syncState ?? EMPTY_SETTINGS.syncState;
@@ -33353,39 +33455,15 @@ function GitHubSyncToolbarButtonSurface(props) {
       setCancellingSync(false);
     }
   }
-  return /* @__PURE__ */ jsxs2(
-    "div",
-    {
-      ref: surfaceRef,
-      className: `ghsync-toolbar-button${props.entityType ? " ghsync-toolbar-button--entity" : ""}`,
-      style: themeVars,
-      title: toolbarState.error?.message ?? effectiveMessage,
-      children: [
-        /* @__PURE__ */ jsx2("style", { children: EXTENSION_SURFACE_STYLES }),
-        /* @__PURE__ */ jsx2(
-          "button",
-          {
-            type: "button",
-            "data-slot": "button",
-            "data-variant": "outline",
-            "data-size": "sm",
-            className: props.entityType ? HOST_ENTITY_BUTTON_CLASSNAME : HOST_GLOBAL_BUTTON_CLASSNAME,
-            disabled: toolbarButtonDisabled,
-            onClick: syncPersistedRunning && allowToolbarCancellation ? handleCancelSync : handleRunSync,
-            children: /* @__PURE__ */ jsx2(
-              LoadingButtonContent,
-              {
-                busy: toolbarButtonBusy,
-                label: toolbarButtonLabel,
-                busyLabel: toolbarButtonBusyLabel,
-                icon: /* @__PURE__ */ jsx2(GitHubMarkIcon, { className: "h-3.5 w-3.5" })
-              }
-            )
-          }
-        )
-      ]
-    }
-  );
+  return {
+    visible: props.forceVisible ? true : state.visible,
+    title: toolbarState.error?.message ?? effectiveMessage ?? "GitHub sync",
+    busy: toolbarButtonBusy,
+    disabled: toolbarButtonDisabled,
+    label: toolbarButtonLabel,
+    busyLabel: toolbarButtonBusyLabel,
+    onClick: syncPersistedRunning && allowToolbarCancellation ? handleCancelSync : handleRunSync
+  };
 }
 function GitHubSyncGlobalToolbarButton() {
   const context = useHostContext();
@@ -33418,6 +33496,13 @@ function GitHubSyncIssueDetailTabContent(props) {
     detailsError: Boolean(details.error),
     issueDetails
   });
+  const issueSyncButton = useGitHubSyncButtonController({
+    companyId: props.companyId,
+    entityId: props.issueId,
+    entityType: "issue",
+    resolvedIssueId: props.issueId,
+    forceVisible: true
+  });
   useEffect2(() => {
     if (!props.companyId || !props.issueId) {
       return;
@@ -33437,27 +33522,68 @@ function GitHubSyncIssueDetailTabContent(props) {
     detailTabState === "error" && details.error ? /* @__PURE__ */ jsx2("p", { className: "ghsync-extension-empty", children: details.error.message }) : null,
     detailTabState === "ready" && issueDetails ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
       /* @__PURE__ */ jsxs2("div", { className: "ghsync-extension-heading", children: [
-        /* @__PURE__ */ jsxs2("div", { children: [
+        /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__headline", children: [
           /* @__PURE__ */ jsxs2("h4", { children: [
             "Issue #",
             issueDetails.githubIssueNumber
           ] }),
-          /* @__PURE__ */ jsx2("p", { children: formatGitHubRepositoryLabel(issueDetails.repositoryUrl) })
+          /* @__PURE__ */ jsx2("p", { children: formatGitHubRepositoryLabel(issueDetails.repositoryUrl) }),
+          issueDetails.creator ? /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__creator-row", children: [
+            /* @__PURE__ */ jsx2("span", { className: "ghsync-issue-detail__creator-label", children: "Creator" }),
+            /* @__PURE__ */ jsxs2(
+              "a",
+              {
+                href: issueDetails.creator.profileUrl,
+                target: "_blank",
+                rel: "noreferrer",
+                className: "ghsync-prs-table__person ghsync-issue-detail__creator",
+                children: [
+                  /* @__PURE__ */ jsx2(PreviewAvatar, { person: issueDetails.creator, size: "sm" }),
+                  /* @__PURE__ */ jsx2(PreviewPersonCopy, { person: issueDetails.creator })
+                ]
+              }
+            )
+          ] }) : null
         ] }),
-        /* @__PURE__ */ jsx2(
-          "a",
-          {
-            href: issueDetails.githubIssueUrl,
-            target: "_blank",
-            rel: "noreferrer",
-            className: getPluginActionClassName({
-              variant: "secondary",
-              size: "sm",
-              extraClassName: "ghsync-extension-link"
-            }),
-            children: "Open on GitHub"
-          }
-        )
+        /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__actions", children: [
+          issueSyncButton.visible ? /* @__PURE__ */ jsx2(
+            "button",
+            {
+              type: "button",
+              className: getPluginActionClassName({
+                variant: "secondary",
+                size: "sm",
+                extraClassName: "ghsync-extension-link"
+              }),
+              disabled: issueSyncButton.disabled,
+              onClick: issueSyncButton.onClick,
+              title: issueSyncButton.title,
+              children: /* @__PURE__ */ jsx2(
+                LoadingButtonContent,
+                {
+                  busy: issueSyncButton.busy,
+                  label: issueSyncButton.label,
+                  busyLabel: issueSyncButton.busyLabel,
+                  icon: /* @__PURE__ */ jsx2(GitHubMarkIcon, { className: "ghsync-prs-icon" })
+                }
+              )
+            }
+          ) : null,
+          /* @__PURE__ */ jsx2(
+            "a",
+            {
+              href: issueDetails.githubIssueUrl,
+              target: "_blank",
+              rel: "noreferrer",
+              className: getPluginActionClassName({
+                variant: "secondary",
+                size: "sm",
+                extraClassName: "ghsync-extension-link"
+              }),
+              children: /* @__PURE__ */ jsx2(GitHubButtonLabel, { label: "Open on GitHub" })
+            }
+          )
+        ] })
       ] }),
       /* @__PURE__ */ jsxs2("div", { className: "ghsync-extension-grid", children: [
         /* @__PURE__ */ jsxs2("div", { className: "ghsync-extension-metric", children: [
@@ -33479,7 +33605,7 @@ function GitHubSyncIssueDetailTabContent(props) {
       ] }),
       issueDetails.linkedPullRequestNumbers.length > 0 ? /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__section", children: [
         /* @__PURE__ */ jsx2("div", { className: "ghsync-issue-detail__section-heading", children: "Linked pull requests" }),
-        /* @__PURE__ */ jsx2("div", { className: "ghsync-extension-links", children: issueDetails.linkedPullRequestNumbers.map((pullRequestNumber) => /* @__PURE__ */ jsxs2(
+        /* @__PURE__ */ jsx2("div", { className: "ghsync-extension-links", children: issueDetails.linkedPullRequestNumbers.map((pullRequestNumber) => /* @__PURE__ */ jsx2(
           "a",
           {
             href: `${issueDetails.repositoryUrl}/pull/${pullRequestNumber}`,
@@ -33490,10 +33616,7 @@ function GitHubSyncIssueDetailTabContent(props) {
               size: "sm",
               extraClassName: "ghsync-extension-link"
             }),
-            children: [
-              "PR #",
-              pullRequestNumber
-            ]
+            children: /* @__PURE__ */ jsx2(GitHubButtonLabel, { label: `PR #${pullRequestNumber}` })
           },
           pullRequestNumber
         )) })
@@ -33510,7 +33633,7 @@ function GitHubSyncIssueDetailTabContent(props) {
           `${label.name}:${label.color ?? "none"}`
         )) })
       ] }) : null,
-      issueDetails.source !== "entity" ? /* @__PURE__ */ jsx2("div", { className: "ghsync-extension-note", children: "GitHub Sync recovered this link from older sync metadata. Run sync once to refresh GitHub state, labels, and linked PRs in this panel." }) : null
+      issueDetails.source !== "entity" ? /* @__PURE__ */ jsx2("div", { className: "ghsync-extension-note", children: "GitHub Sync recovered this link from older sync metadata. Run sync once to refresh the creator, GitHub state, labels, and linked PRs in this panel." }) : null
     ] }) : null
   ] });
 }
@@ -33581,7 +33704,7 @@ function GitHubSyncCommentAnnotation() {
             size: "sm",
             extraClassName: "ghsync-extension-link"
           }),
-          children: link3.label
+          children: /* @__PURE__ */ jsx2(GitHubButtonLabel, { label: link3.label })
         },
         `${link3.type}:${link3.href}`
       ))
@@ -33602,6 +33725,7 @@ export {
   index_default as default,
   resolveGitHubIssueDetailTabState,
   resolveOrCreateProject,
+  resolvePreviewPersonLabels,
   resolveSavedTokenUiState,
   resolveToolbarButtonState,
   syncGitHubTokenPropagationForAgents