paperclip-github-plugin 0.9.10 → 0.9.11

package/README.md

@@ -35,7 +35,7 @@ The plugin adds a full in-host workflow instead of a one-off import script:
 - 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 surfaces
-- a GitHub detail tab on synced Paperclip issues that includes GitHub-marked action buttons plus the GitHub issue creator with avatar, and lets operators manually link or unlink a Paperclip issue from a GitHub issue or pull request
+- a GitHub detail tab on synced Paperclip issues that includes GitHub-marked action buttons plus the GitHub issue creator with avatar, lets operators manually link or unlink a Paperclip issue from a GitHub issue or pull request, and shows compact troubleshooting details if the host cannot provide a resolvable issue context
 - GitHub link annotations on sync-generated status transition comments when the host supports comment annotations
 
 ## How it works

package/dist/manifest.js

@@ -642,7 +642,7 @@ var PULL_REQUEST_ASSET_API_ROUTE_URL_PATH = `/api/plugins/${GITHUB_SYNC_PLUGIN_I
 var require2 = createRequire(import.meta.url);
 var packageJson = require2("../package.json");
 var SCHEDULE_TICK_CRON = "* * * * *";
-var MANIFEST_VERSION = "0.9.10"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var MANIFEST_VERSION = "0.9.11"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
 var manifest = {
   id: GITHUB_SYNC_PLUGIN_ID,
   apiVersion: 1,

package/dist/ui/index.js

@@ -11996,7 +11996,7 @@ var urlAttributes = {
   ]
 };
 
-// node_modules/.pnpm/react-markdown@10.1.0_@types+react@19.2.14_react@19.2.6/node_modules/react-markdown/lib/index.js
+// node_modules/.pnpm/react-markdown@10.1.0_@types+react@19.2.15_react@19.2.6/node_modules/react-markdown/lib/index.js
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 
@@ -19152,7 +19152,7 @@ function isUint8Array2(value) {
   );
 }
 
-// node_modules/.pnpm/react-markdown@10.1.0_@types+react@19.2.14_react@19.2.6/node_modules/react-markdown/lib/index.js
+// node_modules/.pnpm/react-markdown@10.1.0_@types+react@19.2.15_react@19.2.6/node_modules/react-markdown/lib/index.js
 var changelog = "https://github.com/remarkjs/react-markdown/blob/main/changelog.md";
 var emptyPlugins = [];
 var emptyRemarkRehypeOptions = { allowDangerousHtml: true };
@@ -26785,6 +26785,15 @@ var EXTENSION_SURFACE_STYLES = `
     line-height: 1.5;
   }
 
+  .ghsync-extension-note p,
+  .ghsync-extension-diagnostics {
+    margin: 8px 0 0;
+  }
+
+  .ghsync-extension-diagnostics {
+    padding-left: 18px;
+  }
+
   .ghsync-issue-detail {
     display: grid;
     gap: 16px;
@@ -28878,7 +28887,7 @@ function getIssueIdentifierFromLocation(pathname) {
 }
 function useResolvedIssueId(params) {
   const pathname = typeof window === "undefined" ? "" : window.location.pathname;
-  const issueIdentifier = params.entityType === "issue" ? getIssueIdentifierFromLocation(pathname) : null;
+  const issueIdentifier = getIssueIdentifierFromLocation(pathname);
   const resolution = usePluginData("issue.resolveByIdentifier", {
     ...params.companyId && issueIdentifier ? { companyId: params.companyId } : {},
     ...params.projectId && issueIdentifier ? { projectId: params.projectId } : {},
@@ -28895,16 +28904,19 @@ function useResolvedIssueId(params) {
     }
   }, [issueIdentifier, params.companyId, params.projectId, resolution.refresh]);
   if (issueIdentifier) {
+    const contextIssueId = params.entityId && params.entityId !== issueIdentifier ? params.entityId : null;
     return {
-      issueId: resolution.data?.issueId ?? null,
+      issueId: resolution.data?.issueId ?? contextIssueId,
       issueIdentifier,
-      loading: resolution.loading && !resolution.data
+      loading: resolution.loading && !resolution.data && !contextIssueId,
+      errorMessage: resolution.error?.message ?? null
     };
   }
   return {
-    issueId: params.entityId ?? null,
+    issueId: params.entityType === "issue" || !params.entityType ? params.entityId ?? null : null,
     issueIdentifier: null,
-    loading: false
+    loading: false,
+    errorMessage: null
   };
 }
 function formatSyncProgressRepository(repositoryUrl) {
@@ -34898,8 +34910,7 @@ function GitHubSyncEntityToolbarButton() {
 }
 function GitHubSyncIssueDetailTabContent(props) {
   const details = usePluginData("issue.githubDetails", {
-    ...props.companyId ? { companyId: props.companyId } : {},
-    ...props.issueId ? { issueId: props.issueId } : {}
+    ...props.companyId && props.issueId ? { companyId: props.companyId, issueId: props.issueId } : {}
   });
   const issueDetails = details.data?.paperclipIssueId === props.issueId ? details.data : null;
   const detailTabState = resolveGitHubIssueDetailTabState({
@@ -34907,7 +34918,10 @@ function GitHubSyncIssueDetailTabContent(props) {
     detailsLoading: details.loading,
     detailsError: Boolean(details.error),
     issueDetails,
-    canLinkManually: Boolean(props.companyId && props.issueId)
+    canLinkManually: Boolean(props.companyId && props.issueId),
+    issueIdentifier: props.issueIdentifier,
+    issueResolutionError: Boolean(props.issueResolutionErrorMessage),
+    expectedIssueContext: Boolean(props.expectedIssueContext)
   });
   const issueSyncButton = useGitHubSyncButtonController({
     companyId: props.companyId,
@@ -35014,7 +35028,34 @@ function GitHubSyncIssueDetailTabContent(props) {
   return /* @__PURE__ */ jsxs2("section", { className: "ghsync-issue-detail", style: props.themeVars, children: [
     /* @__PURE__ */ jsx2("style", { children: EXTENSION_SURFACE_STYLES }),
     detailTabState === "loading" ? /* @__PURE__ */ jsx2("p", { className: "ghsync-extension-empty", children: "Loading GitHub sync details\u2026" }) : null,
-    detailTabState === "error" && details.error ? /* @__PURE__ */ jsx2("p", { className: "ghsync-extension-empty", children: details.error.message }) : null,
+    detailTabState === "error" ? /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__intro", children: [
+      /* @__PURE__ */ jsx2("div", { className: "ghsync-extension-heading", children: /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__headline", children: [
+        /* @__PURE__ */ jsx2("h4", { children: "GitHub sync details unavailable" }),
+        /* @__PURE__ */ jsx2("p", { children: details.error?.message ?? props.issueResolutionErrorMessage ?? "GitHub Sync could not load this issue detail view." })
+      ] }) }),
+      /* @__PURE__ */ jsx2(
+        GitHubIssueDetailTroubleshooting,
+        {
+          companyId: props.companyId,
+          issueId: props.issueId,
+          issueIdentifier: props.issueIdentifier
+        }
+      )
+    ] }) : null,
+    detailTabState === "unresolved" ? /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__intro", children: [
+      /* @__PURE__ */ jsx2("div", { className: "ghsync-extension-heading", children: /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__headline", children: [
+        /* @__PURE__ */ jsx2("h4", { children: "GitHub sync details unavailable" }),
+        /* @__PURE__ */ jsx2("p", { children: "GitHub Sync could not resolve the current Paperclip issue context." })
+      ] }) }),
+      /* @__PURE__ */ jsx2(
+        GitHubIssueDetailTroubleshooting,
+        {
+          companyId: props.companyId,
+          issueId: props.issueId,
+          issueIdentifier: props.issueIdentifier
+        }
+      )
+    ] }) : null,
     detailTabState === "unlinked" ? /* @__PURE__ */ jsx2("div", { className: "ghsync-issue-detail__intro", children: /* @__PURE__ */ jsxs2("div", { className: "ghsync-extension-heading", children: [
       /* @__PURE__ */ jsxs2("div", { className: "ghsync-issue-detail__headline", children: [
         /* @__PURE__ */ jsx2("h4", { children: "GitHub link" }),
@@ -35254,16 +35295,59 @@ function resolveGitHubIssueDetailTabState(params) {
   if (params.issueDetails) {
     return "ready";
   }
-  if (params.detailsError) {
+  if (params.detailsError || params.issueResolutionError) {
     return "error";
   }
   if (params.canLinkManually) {
     return "unlinked";
   }
+  if (params.issueIdentifier || params.expectedIssueContext) {
+    return "unresolved";
+  }
   return "hidden";
 }
-function GitHubSyncIssueTaskDetailView() {
-  const context = useHostContext();
+function getContextStringValue(context, key) {
+  const value = context?.[key];
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function resolveGitHubIssueTaskDetailContext(params) {
+  const companyId = getContextStringValue(params.slotContext, "companyId") ?? getContextStringValue(params.hostContext, "companyId");
+  const projectId = getContextStringValue(params.slotContext, "projectId") ?? getContextStringValue(params.hostContext, "projectId");
+  const entityId = getContextStringValue(params.slotContext, "entityId") ?? getContextStringValue(params.hostContext, "entityId");
+  const entityType = getContextStringValue(params.slotContext, "entityType") ?? getContextStringValue(params.hostContext, "entityType");
+  return {
+    ...companyId ? { companyId } : {},
+    ...projectId ? { projectId } : {},
+    ...entityId ? { entityId } : {},
+    ...entityType ? { entityType } : {}
+  };
+}
+function shouldExpectGitHubIssueTaskDetailContext(params) {
+  if (params.issueIdentifier) {
+    return true;
+  }
+  if (params.entityType === "issue") {
+    return true;
+  }
+  return !params.entityType && Boolean(params.entityId);
+}
+function GitHubIssueDetailTroubleshooting(props) {
+  return /* @__PURE__ */ jsxs2("div", { className: "ghsync-extension-note", children: [
+    /* @__PURE__ */ jsx2("strong", { children: "Troubleshooting" }),
+    /* @__PURE__ */ jsxs2("ul", { className: "ghsync-extension-diagnostics", children: [
+      /* @__PURE__ */ jsx2("li", { children: props.companyId ? `Company context: ${props.companyId}` : "Missing company context from the host slot." }),
+      /* @__PURE__ */ jsx2("li", { children: props.issueId ? `Issue id: ${props.issueId}` : "Missing canonical Paperclip issue id." }),
+      props.issueIdentifier ? /* @__PURE__ */ jsx2("li", { children: `Route issue identifier: ${props.issueIdentifier}` }) : null
+    ] }),
+    /* @__PURE__ */ jsx2("p", { children: "Refresh the issue page, then reopen this detail view. If this remains unresolved, include these values when reporting the GitHub Sync plugin issue." })
+  ] });
+}
+function GitHubSyncIssueTaskDetailView(props) {
+  const hostContext = useHostContext();
+  const context = resolveGitHubIssueTaskDetailContext({
+    slotContext: props?.context ?? null,
+    hostContext
+  });
   const themeMode = useResolvedThemeMode();
   const theme = themeMode === "light" ? LIGHT_PALETTE : DARK_PALETTE;
   const themeVars = buildThemeVars(theme, themeMode);
@@ -35273,13 +35357,21 @@ function GitHubSyncIssueTaskDetailView() {
     entityId: context.entityId,
     entityType: context.entityType
   });
+  const expectedIssueContext = shouldExpectGitHubIssueTaskDetailContext({
+    entityId: context.entityId,
+    entityType: context.entityType,
+    issueIdentifier: resolvedIssue.issueIdentifier
+  });
   const detailKey = `${context.companyId ?? "company-none"}:${resolvedIssue.issueIdentifier ?? context.entityId ?? "issue-none"}`;
   return /* @__PURE__ */ jsx2(
     GitHubSyncIssueDetailTabContent,
     {
       companyId: context.companyId,
       issueId: resolvedIssue.issueId,
+      issueIdentifier: resolvedIssue.issueIdentifier,
+      expectedIssueContext,
       loadingIssueId: resolvedIssue.loading,
+      issueResolutionErrorMessage: resolvedIssue.errorMessage,
       themeVars
     },
     detailKey
@@ -35340,11 +35432,13 @@ export {
   index_default as default,
   patchPluginConfig,
   resolveGitHubIssueDetailTabState,
+  resolveGitHubIssueTaskDetailContext,
   resolveGitHubTokenSecretRefForPropagation,
   resolveOrCreateProject,
   resolvePreviewPersonLabels,
   resolveSavedTokenUiState,
   resolveToolbarButtonState,
+  shouldExpectGitHubIssueTaskDetailContext,
   syncGitHubTokenPropagationForAgents
 };
 //# sourceMappingURL=index.js.map