paperclip-github-plugin 0.4.2 → 0.4.4

package/README.md

@@ -144,6 +144,7 @@ When the local Paperclip API is available, the plugin also syncs labels by name,
 Additional behavior:
 
 - Open issues with no linked pull request that are created by a verified repository maintainer/admin bypass the default imported status and start in `todo`.
+- Newly imported issues that finish sync in `todo` and are assigned to an agent enqueue an assignee wakeup so the agent can pick them up promptly.
 - Open imported issues that are already in `backlog` stay in `backlog` until someone changes them in Paperclip.
 - If an imported issue is `done` or `cancelled` and GitHub shows it open again with no linked pull request, sync moves it to `todo` so agents can pick it up again.
 - Trusted new GitHub comments from the original issue author or a verified maintainer/admin can move an open imported issue back to `todo`.

package/dist/manifest.js

@@ -503,7 +503,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.2"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+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 = {
   id: "paperclip-github-plugin",
   apiVersion: 1,

package/dist/worker.js

@@ -618,12 +618,14 @@ var CANCELLING_SYNC_MESSAGE = "Cancellation requested. GitHub sync will stop aft
 var SYNC_PROGRESS_PERSIST_INTERVAL_MS = 250;
 var MAX_SYNC_FAILURE_LOG_ENTRIES = 25;
 var GITHUB_SECONDARY_RATE_LIMIT_FALLBACK_MS = 6e4;
+var IMPORTED_ISSUE_WAKEUP_CONCURRENCY = 4;
 var MISSING_GITHUB_TOKEN_SYNC_MESSAGE = "Configure a GitHub token before running sync.";
 var MISSING_GITHUB_TOKEN_SYNC_ACTION = 'Open settings and save a GitHub token secret, or create $PAPERCLIP_HOME/plugins/github-sync/config.json (or ~/.paperclip/plugins/github-sync/config.json when PAPERCLIP_HOME is unset) with a "githubToken" value, and then run sync again.';
 var MISSING_MAPPING_SYNC_MESSAGE = "Save at least one mapping with a created Paperclip project before running sync.";
 var MISSING_MAPPING_SYNC_ACTION = "Open settings, add a repository mapping, let Paperclip create the target project, and then retry sync.";
 var MISSING_BOARD_ACCESS_SYNC_MESSAGE = "Connect Paperclip board access before running sync on this authenticated deployment.";
 var MISSING_BOARD_ACCESS_SYNC_ACTION = "Open plugin settings for each mapped company that sync will touch, connect Paperclip board access, approve the flow, and then run sync again.";
+var IMPORTED_ISSUE_WAKE_REASON = "GitHub Sync imported an assigned issue that is ready for work.";
 var ISSUE_LINK_ENTITY_TYPE = "paperclip-github-plugin.issue-link";
 var PULL_REQUEST_LINK_ENTITY_TYPE = "paperclip-github-plugin.pull-request-link";
 var COMMENT_ANNOTATION_ENTITY_TYPE = "paperclip-github-plugin.comment-annotation";
@@ -4121,7 +4123,7 @@ function resolvePaperclipIssueStatus(params) {
   if (snapshot.state === "closed") {
     return snapshot.stateReason === "duplicate" || snapshot.stateReason === "not_planned" ? "cancelled" : "done";
   }
-  if (currentStatus === "backlog") {
+  if (currentStatus === "backlog" && !wasImportedThisRun) {
     return "backlog";
   }
   const baselineCommentCount = previousCommentCount ?? snapshot.commentCount;
@@ -5225,6 +5227,9 @@ function getPaperclipIssueEndpoint(baseUrl, issueId) {
 function getPaperclipHealthEndpoint(baseUrl) {
   return new URL("/api/health", baseUrl).toString();
 }
+function getPaperclipAgentWakeupEndpoint(baseUrl, agentId) {
+  return new URL(`/api/agents/${agentId}/wakeup`, baseUrl).toString();
+}
 function getActivePaperclipApiAuthToken(companyId) {
   if (!companyId) {
     return void 0;
@@ -5269,6 +5274,46 @@ async function detectPaperclipBoardAccessRequirement(paperclipApiBaseUrl) {
     return false;
   }
 }
+async function wakePaperclipAssigneeForImportedIssue(ctx, params) {
+  if (!params.assigneeAgentId || !params.paperclipApiBaseUrl) {
+    return;
+  }
+  try {
+    const response = await fetchPaperclipApi(
+      getPaperclipAgentWakeupEndpoint(params.paperclipApiBaseUrl, params.assigneeAgentId),
+      {
+        method: "POST",
+        headers: {
+          accept: "application/json",
+          "content-type": "application/json"
+        },
+        body: JSON.stringify({
+          source: "assignment",
+          triggerDetail: "system",
+          reason: IMPORTED_ISSUE_WAKE_REASON,
+          payload: {
+            issueId: params.paperclipIssueId,
+            mutation: "import"
+          }
+        })
+      },
+      {
+        companyId: params.companyId
+      }
+    );
+    if (!response.ok) {
+      throw new Error(`Wakeup request failed with status ${response.status}.`);
+    }
+  } catch (error) {
+    ctx.logger.warn("GitHub sync could not wake the assignee for an imported Paperclip issue.", {
+      issueId: params.paperclipIssueId,
+      agentId: params.assigneeAgentId,
+      companyId: params.companyId,
+      paperclipApiBaseUrl: params.paperclipApiBaseUrl,
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
 function parsePaperclipIssueDescription(value) {
   if (!value || typeof value !== "object") {
     return void 0;
@@ -6226,6 +6271,7 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
   let updatedDescriptionsCount = 0;
   let completedIssueCount = 0;
   const totalIssueCount = importedIssues.length;
+  const queuedImportedIssueWakeups = [];
   for (const importedIssue of importedIssues) {
     if (assertNotCancelled) {
       await assertNotCancelled();
@@ -6357,9 +6403,16 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         defaultImportedStatus: advancedSettings.defaultStatus,
         maintainerAuthoredImportedIssue
       });
+      const shouldWakeImportedAssignee = wasImportedThisRun && nextStatus === "todo" && Boolean(paperclipIssue.assigneeAgentId);
       importedIssue.githubIssueNumber = githubIssue.number;
       importedIssue.lastSeenCommentCount = snapshot.commentCount;
       if (paperclipIssue.status === nextStatus) {
+        if (shouldWakeImportedAssignee) {
+          queuedImportedIssueWakeups.push({
+            assigneeAgentId: paperclipIssue.assigneeAgentId,
+            paperclipIssueId: importedIssue.paperclipIssueId
+          });
+        }
         continue;
       }
       const transitionComment = buildPaperclipIssueStatusTransitionComment({
@@ -6385,6 +6438,12 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         paperclipApiBaseUrl
       });
       updatedStatusesCount += 1;
+      if (shouldWakeImportedAssignee) {
+        queuedImportedIssueWakeups.push({
+          assigneeAgentId: paperclipIssue.assigneeAgentId,
+          paperclipIssueId: importedIssue.paperclipIssueId
+        });
+      }
     } catch (error) {
       if (isGitHubRateLimitError(error)) {
         throw error;
@@ -6403,6 +6462,16 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
       }
     }
   }
+  await mapWithConcurrency(
+    queuedImportedIssueWakeups,
+    IMPORTED_ISSUE_WAKEUP_CONCURRENCY,
+    async (queuedWakeup) => wakePaperclipAssigneeForImportedIssue(ctx, {
+      assigneeAgentId: queuedWakeup.assigneeAgentId,
+      paperclipIssueId: queuedWakeup.paperclipIssueId,
+      companyId: mapping.companyId,
+      paperclipApiBaseUrl
+    })
+  );
   return {
     updatedStatusesCount,
     updatedLabelsCount,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-github-plugin",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Paperclip plugin for synchronizing GitHub issues into Paperclip projects.",
   "license": "Apache-2.0",
   "type": "module",
@@ -54,6 +54,6 @@
     "esbuild": "0.28.0",
     "playwright": "1.59.1",
     "tsx": "4.21.0",
-    "typescript": "6.0.2"
+    "typescript": "6.0.3"
   }
 }