paperclip-github-plugin 0.9.7 → 0.9.8

package/README.md

@@ -186,6 +186,7 @@ Additional behavior:
 - Sync-driven handoffs to agent assignees best-effort enqueue an explicit wakeup so the next reviewer, approver, or executor can pick the issue up even when their agent is not running heartbeats.
 - 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.
+- When an issue has an active Paperclip issue monitor, GitHub Sync lets that monitor own the wait. It still refreshes GitHub metadata, but it does not change the issue's Paperclip status, assignee, execution state, transition comments, or wakeups until the monitor is no longer active.
 - Trusted new GitHub comments from the original issue author or a verified maintainer/admin can move an open imported issue back into active work, whether the new comment lands on the source issue, in a linked pull request's top-level comment stream, or in a linked pull request review thread; GitHub Sync uses `in_progress` when it can route the issue to an executor and otherwise `todo`.
 - When the sync changes a Paperclip issue status, it adds a Paperclip comment explaining what changed and why.
 

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

@@ -5418,7 +5418,8 @@ function normalizePaperclipIssueExecutionState(value) {
   const lastDecisionId = normalizeOptionalString2(record.lastDecisionId) ?? null;
   const lastDecisionOutcome = normalizeOptionalString2(record.lastDecisionOutcome) ?? null;
   const completedStageIds = Array.isArray(record.completedStageIds) ? record.completedStageIds.map((stageId) => normalizeOptionalString2(stageId)).filter((stageId) => Boolean(stageId)) : [];
-  if (!status && currentStageId === null && currentStageIndex === null && currentStageType === null && currentParticipant === null && returnAssignee === null && completedStageIds.length === 0 && lastDecisionId === null && lastDecisionOutcome === null) {
+  const monitor = normalizePaperclipIssueMonitorState(record.monitor);
+  if (!status && currentStageId === null && currentStageIndex === null && currentStageType === null && currentParticipant === null && returnAssignee === null && completedStageIds.length === 0 && lastDecisionId === null && lastDecisionOutcome === null && monitor === null) {
     return null;
   }
   return {
@@ -5430,7 +5431,25 @@ function normalizePaperclipIssueExecutionState(value) {
     returnAssignee,
     completedStageIds,
     ...lastDecisionId !== null ? { lastDecisionId } : {},
-    ...lastDecisionOutcome !== null ? { lastDecisionOutcome } : {}
+    ...lastDecisionOutcome !== null ? { lastDecisionOutcome } : {},
+    ...monitor !== null ? { monitor } : {}
+  };
+}
+function normalizePaperclipIssueMonitorState(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const record = value;
+  const status = normalizeOptionalString2(record.status);
+  const clearedAt = normalizeOptionalString2(record.clearedAt) ?? null;
+  const clearReason = normalizeOptionalString2(record.clearReason) ?? null;
+  if (!status && clearedAt === null && clearReason === null && Object.keys(record).length === 0) {
+    return null;
+  }
+  return {
+    ...status ? { status } : {},
+    clearedAt,
+    clearReason
   };
 }
 function getPaperclipIssueAssigneePrincipal(issue) {
@@ -5456,6 +5475,17 @@ function getPaperclipIssueSyncContext(issue) {
     executionState: normalizePaperclipIssueExecutionState(record.executionState)
   };
 }
+function hasActivePaperclipIssueMonitor(syncContext) {
+  const monitor = syncContext.executionState?.monitor;
+  if (!monitor) {
+    return false;
+  }
+  if (monitor.clearedAt || monitor.clearReason) {
+    return false;
+  }
+  const normalizedStatus = monitor.status?.trim().toLowerCase();
+  return normalizedStatus !== "cleared" && normalizedStatus !== "completed" && normalizedStatus !== "cancelled" && normalizedStatus !== "canceled";
+}
 function hasUnresolvedPaperclipIssueBlockerSummary(blockers) {
   if (!Array.isArray(blockers)) {
     return false;
@@ -5675,6 +5705,13 @@ function isClearableMaintainerWaitExecutionState(executionState) {
   if (executionState === null) {
     return true;
   }
+  if (hasActivePaperclipIssueMonitor({
+    assignee: null,
+    executionPolicy: null,
+    executionState
+  })) {
+    return false;
+  }
   if (executionState.currentParticipant !== null || executionState.returnAssignee !== null || executionState.currentStageId !== null || executionState.currentStageIndex !== null || executionState.currentStageType !== null || executionState.completedStageIds.length > 0 || executionState.lastDecisionId || executionState.lastDecisionOutcome) {
     return false;
   }
@@ -9518,6 +9555,19 @@ async function cancelUnmappedTransferredGitHubIssue(ctx, params) {
       updatedStatusesCount: 0
     };
   }
+  const paperclipIssueSyncContext = getPaperclipIssueSyncContext(paperclipIssue);
+  if (hasActivePaperclipIssueMonitor(paperclipIssueSyncContext)) {
+    ctx.logger.info("GitHub sync skipped transferred issue cancellation because an issue monitor is active.", {
+      companyId,
+      issueId: params.importedIssue.paperclipIssueId,
+      transferredRepositoryUrl: params.transferredRepository.url,
+      currentStatus: paperclipIssue.status,
+      resolvedStatus: "cancelled"
+    });
+    return {
+      updatedStatusesCount: 0
+    };
+  }
   await unlinkPaperclipIssueFromGitHub(ctx, {
     companyId,
     issueId: params.importedIssue.paperclipIssueId
@@ -9527,7 +9577,7 @@ async function cancelUnmappedTransferredGitHubIssue(ctx, params) {
     companyId,
     issueId: params.importedIssue.paperclipIssueId,
     currentStatus: paperclipIssue.status,
-    syncContext: getPaperclipIssueSyncContext(paperclipIssue),
+    syncContext: paperclipIssueSyncContext,
     nextStatus,
     transitionComment: buildUnmappedTransferredIssueCancellationComment({
       previousStatus: paperclipIssue.status,
@@ -9846,6 +9896,17 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
       importedIssue.lastSeenCommentCount = snapshot.commentCount;
       importedIssue.lastSeenGitHubState = snapshot.state;
       importedIssue.linkedPullRequestCommentCounts = currentLinkedPullRequestCommentCounts;
+      if (hasActivePaperclipIssueMonitor(paperclipIssueSyncContext)) {
+        ctx.logger.info("GitHub sync skipped Paperclip issue state changes because an issue monitor is active.", {
+          companyId: mapping.companyId,
+          issueId: importedIssue.paperclipIssueId,
+          repositoryUrl: repository.url,
+          githubIssueNumber: githubIssue.number,
+          currentStatus: paperclipIssue.status,
+          resolvedStatus: nextStatus
+        });
+        continue;
+      }
       if (paperclipIssue.status === nextStatus) {
         if (shouldClearTransitionAssignee || shouldClearCompletedExecutionPolicy) {
           updateSyncFailureContext(syncFailureContext, {
@@ -10102,6 +10163,16 @@ async function synchronizePaperclipPullRequestIssueStatuses(ctx, octokit, mappin
       const shouldClearTransitionAssignee = nextStatus === "in_review" && (nextTransitionAssignee === null || shouldPreserveMaintainerWaitRouting) && paperclipIssueSyncContext.assignee !== null;
       const nextAssigneeChanged = nextTransitionAssignee ? !doesPaperclipIssueAssigneeMatch(paperclipIssueSyncContext.assignee, nextTransitionAssignee.principal) : false;
       const shouldWakeTransitionAssignee = paperclipIssue.status !== nextStatus && nextTransitionAssignee?.principal.kind === "agent" && isActionablePaperclipIssueStatus(nextStatus) && (nextAssigneeChanged || paperclipIssue.status !== nextStatus);
+      if (hasActivePaperclipIssueMonitor(paperclipIssueSyncContext)) {
+        ctx.logger.info("GitHub sync skipped Paperclip pull request issue state changes because an issue monitor is active.", {
+          companyId: mapping.companyId,
+          issueId: paperclipIssueId,
+          repositoryUrl: primaryRepository?.url,
+          currentStatus: paperclipIssue.status,
+          resolvedStatus: nextStatus
+        });
+        continue;
+      }
       if (paperclipIssue.status === nextStatus) {
         if (shouldClearTransitionAssignee || shouldClearCompletedExecutionPolicy) {
           updateSyncFailureContext(syncFailureContext, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-github-plugin",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "description": "Paperclip plugin for synchronizing GitHub issues into Paperclip projects.",
   "license": "Apache-2.0",
   "type": "module",
@@ -49,11 +49,11 @@
     "remark-gfm": "^4.0.1"
   },
   "devDependencies": {
-    "@types/node": "24.12.3",
+    "@types/node": "24.12.4",
     "@types/react": "19.2.14",
     "esbuild": "0.28.0",
-    "playwright": "1.59.1",
-    "tsx": "4.21.0",
+    "playwright": "1.60.0",
+    "tsx": "4.22.0",
     "typescript": "6.0.3"
   }
 }