paperclip-github-plugin 0.4.4 → 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
 
@@ -71,7 +71,7 @@ Paperclip issue linkage on the queue prefers the GitHub issue that the pull requ
 
 ### Agent workflows built in
 
-Paperclip agents can search GitHub for duplicates, read and update issues, post comments, create pull requests, inspect changed files and CI, reply to review threads, resolve or unresolve threads, request reviewers, list org-level GitHub Projects, and associate pull requests with those projects without leaving the Paperclip plugin surface.
+Paperclip agents can search GitHub for duplicates, read and update issues, post comments, create pull requests, inspect changed files and CI, reply to review threads, resolve or unresolve threads, request reviewers, search org-level GitHub Projects, and associate pull requests with those projects without leaving the Paperclip plugin surface.
 
 ## Requirements
 
@@ -185,9 +185,9 @@ The plugin exposes GitHub workflow tools to Paperclip agents, including:
 - issue reads, comment reads, comment writes, and metadata updates
 - pull request creation, reads, updates, changed-file inspection, and CI-check inspection
 - review-thread reads, replies, resolve and unresolve actions, and reviewer requests
-- organization-level GitHub Project listing and pull-request-to-project association
+- organization-level GitHub Project search/listing and pull-request-to-project association
 
-When an agent posts a GitHub comment or review-thread reply through the plugin, the message includes a footer disclosing that it was created by a Paperclip AI agent and which model was used.
+When an agent sends GitHub body content through the plugin, including issue bodies, pull request descriptions, comments, and review-thread replies, the plugin adds a GitHub-flavored Markdown footer with a horizontal rule and compact heading that discloses AI authorship. If the tool caller supplies `llmModel`, the footer also includes the model name, for example `###### ✨ This comment was AI-generated using gpt-5.4`.
 
 Current host caveat: on authenticated Paperclip deployments, the Paperclip host currently guards `GET /api/plugins/tools` and `POST /api/plugins/tools/execute` with board authentication before dispatching to any plugin worker. If an agent run does not have board access for the target company, GitHub Sync tool discovery and execution fail with `403 {"error":"Board access required"}` before this plugin's worker code runs.
 
@@ -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

@@ -35,7 +35,7 @@ var projectNumberProperty = {
 };
 var llmModelProperty = {
   type: "string",
-  description: "Exact LLM name used to draft the comment. Required so the plugin can append the mandatory AI-authorship footer."
+  description: "Exact LLM name used to draft the GitHub content. When provided, the plugin includes it in the mandatory AI-authorship footer."
 };
 var issueTargetSchema = {
   anyOf: [
@@ -149,7 +149,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "update_issue",
     displayName: "Update Issue",
-    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone.",
+    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -162,8 +162,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing issue description body. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         state: {
           type: "string",
           enum: ["open", "closed"]
@@ -215,11 +217,11 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "add_issue_comment",
     displayName: "Add Issue Comment",
-    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; include llmModel so the plugin can append the required AI-authorship footer.",
+    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; it must remain non-empty after trimming and removing any existing AI footer. The plugin appends the required AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
-      required: ["body", "llmModel"],
+      required: ["body"],
       ...issueTargetSchema,
       properties: {
         repository: repositoryProperty,
@@ -227,7 +229,8 @@ var GITHUB_AGENT_TOOLS = [
         paperclipIssueId: paperclipIssueIdProperty,
         body: {
           type: "string",
-          description: "Human-facing comment body without the AI footer."
+          minLength: 1,
+          description: "Human-facing comment body without the AI footer. It must remain non-empty after trimming and removing any existing AI footer."
         },
         llmModel: llmModelProperty
       }
@@ -236,7 +239,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "create_pull_request",
     displayName: "Create Pull Request",
-    description: "Open a GitHub pull request once the implementation branch is pushed.",
+    description: "Open a GitHub pull request once the implementation branch is pushed. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -255,8 +258,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing pull request description. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         draft: {
           type: "boolean"
         }
@@ -281,7 +286,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "update_pull_request",
     displayName: "Update Pull Request",
-    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review.",
+    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -294,8 +299,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing pull request description. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         base: {
           type: "string"
         },
@@ -358,11 +365,11 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "reply_to_review_thread",
     displayName: "Reply To Review Thread",
-    description: "Reply to an existing pull request review thread. Provide only the human-facing body; include llmModel so the plugin can append the required AI-authorship footer.",
+    description: "Reply to an existing pull request review thread. Provide only the human-facing body; the plugin appends the required AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
-      required: ["threadId", "body", "llmModel"],
+      required: ["threadId", "body"],
       properties: {
         threadId: {
           type: "string",
@@ -370,7 +377,8 @@ var GITHUB_AGENT_TOOLS = [
         },
         body: {
           type: "string",
-          description: "Human-facing reply body without the AI footer."
+          minLength: 1,
+          description: "Human-facing reply body without the AI footer. It must remain non-empty after trimming and removing any existing AI footer."
         },
         llmModel: llmModelProperty
       }
@@ -454,7 +462,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "list_organization_projects",
     displayName: "List Organization Projects",
-    description: "List GitHub organization-level Projects so an agent can choose where to associate pull requests.",
+    description: "Search or list GitHub organization-level Projects so an agent can choose where to associate pull requests.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -503,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.4"?.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