paperclip-github-plugin 0.4.5 → 0.4.6

package/README.md

@@ -34,7 +34,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 toolbar surfaces
-- a GitHub detail tab on synced Paperclip issues
+- a GitHub detail tab on synced Paperclip issues that stays hidden for Paperclip issues with no linked GitHub issue
 - GitHub link annotations on sync-generated status transition comments when the host supports comment annotations
 
 ## How it works
@@ -47,7 +47,7 @@ During sync, the plugin imports one top-level Paperclip issue per GitHub issue,
 
 When the host exposes plugin issue creation, imported GitHub issues are created through the Paperclip plugin SDK path so they are not attributed to the connected board user. The worker still uses direct local Paperclip REST calls for label sync and for description or status repair paths when those routes are available.
 
-Long-running syncs continue in the background, so quick actions do not have to wait for the whole import to finish. Once a sync has started, the settings page, dashboard widget, and toolbar actions can request cancellation; the worker stops cooperatively after the current repository or issue step finishes.
+Long-running syncs continue in the background, so quick actions do not have to wait for the whole import to finish. Once a sync has started, the settings page, dashboard widget, and toolbar actions can request cancellation; the worker stops cooperatively after the current repository or issue step finishes. If the worker restarts mid-run, GitHub Sync now recovers that orphaned `running` state on the next read or control action instead of leaving the UI stuck in `running` or silently restarting the old run.
 
 ## Highlights
 
@@ -203,6 +203,7 @@ Current host caveat: on authenticated Paperclip deployments, the Paperclip host
 - If a GitHub-linked project does not show the **Pull requests** sidebar entry, reopen the plugin settings and re-save the mapping. The project pull request surfaces also recover older mappings when saved ids are missing, and they can fall back to the active project's bound GitHub repository when the project already has a GitHub workspace configured.
 - If GitHub rate limiting is hit, the plugin pauses sync until the reported reset time instead of retrying pointlessly.
 - If a manual sync takes longer than the host action window, it continues in the background and updates the UI when it finishes or when a cancellation request stops it.
+- If a sync shows `running` after the worker has restarted, the next settings read, toolbar read, cancel action, or scheduler tick will reconcile that stale run into an interrupted error or a cancelled result so you can retry cleanly.
 
 ## Development
 

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.5"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var MANIFEST_VERSION = "0.4.6"?.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

@@ -23091,6 +23091,21 @@ function getActiveRateLimitPause(syncState, referenceTimeMs = Date.now()) {
 function isSyncCancellationRequested(syncState) {
   return syncState.status === "running" && Boolean(syncState.cancelRequestedAt?.trim());
 }
+function resolveToolbarButtonState(params) {
+  const syncPersistedRunning = params.syncState.status === "running";
+  const syncStartPending = params.runningSync && !syncPersistedRunning;
+  const cancellationRequested = syncPersistedRunning && (params.cancellingSync || isSyncCancellationRequested(params.syncState));
+  const loadingVisible = params.loading && !syncPersistedRunning;
+  return {
+    busy: loadingVisible || syncStartPending || cancellationRequested || !params.allowToolbarCancellation && syncPersistedRunning,
+    disabled: loadingVisible || syncStartPending || (syncPersistedRunning ? params.allowToolbarCancellation ? cancellationRequested : true : !params.effectiveCanRun),
+    label: syncPersistedRunning && params.allowToolbarCancellation ? "Cancel sync" : params.effectiveLabel,
+    busyLabel: syncPersistedRunning ? cancellationRequested ? "Cancelling\u2026" : "Syncing\u2026" : loadingVisible ? "Loading\u2026" : "Syncing\u2026",
+    cancellationRequested,
+    syncPersistedRunning,
+    syncStartPending
+  };
+}
 function getSyncToastTitle(syncState) {
   if (getActiveRateLimitPause(syncState)) {
     return "GitHub sync is paused";
@@ -33162,13 +33177,25 @@ function GitHubSyncToolbarButtonSurface(props) {
   const effectiveCanRun = state.canRun && !boardAccessSetupIssue;
   const effectiveMessage = boardAccessSetupIssue ? getSyncSetupMessage(boardAccessSetupIssue, hasCompanyContext) : state.message;
   const effectiveLabel = boardAccessSetupIssue ? "Board access required" : state.label;
-  const syncPersistedRunning = effectiveSyncState.status === "running";
-  const syncStartPending = runningSync && !syncPersistedRunning;
   const allowToolbarCancellation = Boolean(props.entityType);
-  const cancellationRequested = syncPersistedRunning && (cancellingSync || isSyncCancellationRequested(effectiveSyncState));
-  const toolbarButtonBusy = toolbarState.loading || syncStartPending || cancellationRequested || !allowToolbarCancellation && syncPersistedRunning;
-  const toolbarButtonLabel = syncPersistedRunning && allowToolbarCancellation ? "Cancel sync" : effectiveLabel;
-  const toolbarButtonBusyLabel = toolbarState.loading ? "Loading\u2026" : syncPersistedRunning ? cancellationRequested ? "Cancelling\u2026" : "Syncing\u2026" : "Syncing\u2026";
+  const toolbarButtonState = resolveToolbarButtonState({
+    loading: toolbarState.loading,
+    runningSync,
+    cancellingSync,
+    syncState: effectiveSyncState,
+    allowToolbarCancellation,
+    effectiveCanRun,
+    effectiveLabel
+  });
+  const {
+    busy: toolbarButtonBusy,
+    disabled: toolbarButtonDisabled,
+    label: toolbarButtonLabel,
+    busyLabel: toolbarButtonBusyLabel,
+    syncPersistedRunning,
+    syncStartPending,
+    cancellationRequested
+  } = toolbarButtonState;
   const armSyncCompletionToast = useSyncCompletionToast(effectiveSyncState, toast);
   useEffect2(() => {
     if (effectiveSyncState.status !== "running") {
@@ -33343,7 +33370,7 @@ function GitHubSyncToolbarButtonSurface(props) {
             "data-variant": "outline",
             "data-size": "sm",
             className: props.entityType ? HOST_ENTITY_BUTTON_CLASSNAME : HOST_GLOBAL_BUTTON_CLASSNAME,
-            disabled: toolbarState.loading || syncStartPending || (syncPersistedRunning ? allowToolbarCancellation ? cancellationRequested : true : !effectiveCanRun),
+            disabled: toolbarButtonDisabled,
             onClick: syncPersistedRunning && allowToolbarCancellation ? handleCancelSync : handleRunSync,
             children: /* @__PURE__ */ jsx2(
               LoadingButtonContent,
@@ -33385,6 +33412,12 @@ function GitHubSyncIssueDetailTabContent(props) {
     ...props.issueId ? { issueId: props.issueId } : {}
   });
   const issueDetails = details.data?.paperclipIssueId === props.issueId ? details.data : null;
+  const detailTabState = resolveGitHubIssueDetailTabState({
+    loadingIssueId: props.loadingIssueId,
+    detailsLoading: details.loading,
+    detailsError: Boolean(details.error),
+    issueDetails
+  });
   useEffect2(() => {
     if (!props.companyId || !props.issueId) {
       return;
@@ -33395,12 +33428,14 @@ function GitHubSyncIssueDetailTabContent(props) {
       return;
     }
   }, [details.refresh, props.companyId, props.issueId]);
+  if (detailTabState === "hidden") {
+    return null;
+  }
   return /* @__PURE__ */ jsxs2("section", { className: "ghsync-issue-detail", style: props.themeVars, children: [
     /* @__PURE__ */ jsx2("style", { children: EXTENSION_SURFACE_STYLES }),
-    props.loadingIssueId || details.loading && !issueDetails ? /* @__PURE__ */ jsx2("p", { className: "ghsync-extension-empty", children: "Loading GitHub sync details\u2026" }) : null,
-    details.error ? /* @__PURE__ */ jsx2("p", { className: "ghsync-extension-empty", children: details.error.message }) : null,
-    !props.loadingIssueId && !details.loading && !details.error && !issueDetails ? /* @__PURE__ */ jsx2("p", { className: "ghsync-extension-empty", children: "GitHub Sync has not linked this Paperclip issue to a GitHub issue yet." }) : null,
-    issueDetails ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
+    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 === "ready" && issueDetails ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
       /* @__PURE__ */ jsxs2("div", { className: "ghsync-extension-heading", children: [
         /* @__PURE__ */ jsxs2("div", { children: [
           /* @__PURE__ */ jsxs2("h4", { children: [
@@ -33479,6 +33514,18 @@ function GitHubSyncIssueDetailTabContent(props) {
     ] }) : null
   ] });
 }
+function resolveGitHubIssueDetailTabState(params) {
+  if (params.loadingIssueId || params.detailsLoading && !params.issueDetails) {
+    return "loading";
+  }
+  if (params.issueDetails) {
+    return "ready";
+  }
+  if (params.detailsError) {
+    return "error";
+  }
+  return "hidden";
+}
 function GitHubSyncIssueTaskDetailView() {
   const context = useHostContext();
   const themeMode = useResolvedThemeMode();
@@ -33553,8 +33600,10 @@ export {
   GitHubSyncProjectPullRequestsSidebarItem,
   GitHubSyncSettingsPage,
   index_default as default,
+  resolveGitHubIssueDetailTabState,
   resolveOrCreateProject,
   resolveSavedTokenUiState,
+  resolveToolbarButtonState,
   syncGitHubTokenPropagationForAgents
 };
 //# sourceMappingURL=index.js.map