paperclip-github-plugin 0.7.5 → 0.8.1

package/dist/worker.js

@@ -223,6 +223,21 @@ var GITHUB_AGENT_TOOLS = [
       }
     }
   },
+  {
+    name: "assign_to_current_user",
+    displayName: "Assign To Current User",
+    description: "Assign a GitHub issue to the GitHub user authenticated by the saved token, preserving any existing assignees.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      ...issueTargetSchema,
+      properties: {
+        repository: repositoryProperty,
+        issueNumber: issueNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty
+      }
+    }
+  },
   {
     name: "add_issue_comment",
     displayName: "Add Issue Comment",
@@ -797,6 +812,7 @@ var GITHUB_PULL_REQUEST_CI_CONTEXTS_QUERY = `
       pullRequest(number: $pullRequestNumber) {
         mergeable
         mergeStateStatus
+        reviewDecision
         statusCheckRollup {
           contexts(first: 100, after: $after) {
             pageInfo {
@@ -862,6 +878,7 @@ var GITHUB_REPOSITORY_OPEN_PULL_REQUEST_STATUSES_QUERY = `
           number
           mergeable
           mergeStateStatus
+          reviewDecision
           reviewThreads(first: 100) {
             pageInfo {
               hasNextPage
@@ -902,6 +919,7 @@ var GITHUB_PROJECT_PULL_REQUEST_BASE_FIELDS = `
           state
           mergeable
           mergeStateStatus
+          reviewDecision
           createdAt
           updatedAt
           baseRefName
@@ -988,6 +1006,7 @@ var GITHUB_PROJECT_PULL_REQUEST_METRICS_FIELDS = `
           number
           mergeable
           mergeStateStatus
+          reviewDecision
           baseRefName
           reviews(first: 100) {
             pageInfo {
@@ -2243,6 +2262,40 @@ function doesImportedIssueMatchTarget(issue, target) {
   }
   return target.issueId !== void 0 && issue.paperclipIssueId === target.issueId || target.githubIssueId !== void 0 && issue.githubIssueId === target.githubIssueId || target.githubIssueNumber !== void 0 && issue.githubIssueNumber === target.githubIssueNumber;
 }
+function resolvePaperclipIssueOriginGitHubIssueLink(issue, companyId) {
+  if (issue?.originKind !== GITHUB_ISSUE_ORIGIN_KIND || typeof issue.originId !== "string") {
+    return null;
+  }
+  const reference = parseGitHubIssueHtmlUrl(issue.originId);
+  if (!reference) {
+    return null;
+  }
+  return {
+    source: "issue_origin",
+    companyId,
+    paperclipProjectId: issue.projectId ?? void 0,
+    repositoryUrl: reference.repositoryUrl,
+    githubIssueNumber: reference.issueNumber,
+    githubIssueUrl: reference.issueUrl,
+    linkedPullRequestNumbers: [],
+    linkedPullRequests: []
+  };
+}
+function resolvePaperclipIssueOriginGitHubPullRequestLink(issue) {
+  if (issue?.originKind !== GITHUB_PULL_REQUEST_ORIGIN_KIND || typeof issue.originId !== "string") {
+    return null;
+  }
+  const reference = parseGitHubPullRequestHtmlUrl(issue.originId);
+  if (!reference) {
+    return null;
+  }
+  return {
+    source: "issue_origin",
+    repositoryUrl: reference.repositoryUrl,
+    githubPullRequestNumber: reference.pullRequestNumber,
+    githubPullRequestUrl: reference.pullRequestUrl
+  };
+}
 async function resolvePaperclipIssueGitHubLink(ctx, issueId, companyId, options = {}) {
   const linkRecords = options.linkRecords ?? await listGitHubIssueLinkRecords(ctx, {
     paperclipIssueId: issueId
@@ -2287,6 +2340,10 @@ async function resolvePaperclipIssueGitHubLink(ctx, issueId, companyId, options
     }
   }
   const issue = options.paperclipIssue ?? await ctx.issues.get(issueId, companyId);
+  const issueOriginLink = resolvePaperclipIssueOriginGitHubIssueLink(issue, companyId);
+  if (issueOriginLink) {
+    return await hydrateRecoveredPaperclipIssueGitHubLink(ctx, issueId, issueOriginLink) ?? issueOriginLink;
+  }
   const githubIssueUrl = extractImportedGitHubIssueUrlFromDescription(issue?.description);
   const githubIssueReference = githubIssueUrl ? parseGitHubIssueHtmlUrl(githubIssueUrl) : null;
   if (!githubIssueReference) {
@@ -2794,26 +2851,45 @@ async function buildIssueGitHubDetails(ctx, input) {
     const safeLeftTimestamp = Number.isFinite(leftTimestamp) ? leftTimestamp : 0;
     return safeRightTimestamp - safeLeftTimestamp;
   })[0];
-  if (!pullRequestLink) {
+  if (pullRequestLink) {
+    return {
+      paperclipIssueId: issueId,
+      kind: "pull_request",
+      source: "pull_request_entity",
+      repositoryUrl: pullRequestLink.data.repositoryUrl,
+      githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
+      githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
+      githubPullRequestState: pullRequestLink.data.githubPullRequestState,
+      title: pullRequestLink.data.title,
+      linkedPullRequestNumbers: [pullRequestLink.data.githubPullRequestNumber],
+      linkedPullRequests: [
+        {
+          number: pullRequestLink.data.githubPullRequestNumber,
+          repositoryUrl: pullRequestLink.data.repositoryUrl
+        }
+      ],
+      syncedAt: pullRequestLink.data.syncedAt
+    };
+  }
+  const paperclipIssue = await ctx.issues.get(issueId, companyId);
+  const pullRequestOriginLink = resolvePaperclipIssueOriginGitHubPullRequestLink(paperclipIssue);
+  if (!pullRequestOriginLink) {
     return null;
   }
   return {
     paperclipIssueId: issueId,
     kind: "pull_request",
-    source: "pull_request_entity",
-    repositoryUrl: pullRequestLink.data.repositoryUrl,
-    githubPullRequestNumber: pullRequestLink.data.githubPullRequestNumber,
-    githubPullRequestUrl: pullRequestLink.data.githubPullRequestUrl,
-    githubPullRequestState: pullRequestLink.data.githubPullRequestState,
-    title: pullRequestLink.data.title,
-    linkedPullRequestNumbers: [pullRequestLink.data.githubPullRequestNumber],
+    source: pullRequestOriginLink.source,
+    repositoryUrl: pullRequestOriginLink.repositoryUrl,
+    githubPullRequestNumber: pullRequestOriginLink.githubPullRequestNumber,
+    githubPullRequestUrl: pullRequestOriginLink.githubPullRequestUrl,
+    linkedPullRequestNumbers: [pullRequestOriginLink.githubPullRequestNumber],
     linkedPullRequests: [
       {
-        number: pullRequestLink.data.githubPullRequestNumber,
-        repositoryUrl: pullRequestLink.data.repositoryUrl
+        number: pullRequestOriginLink.githubPullRequestNumber,
+        repositoryUrl: pullRequestOriginLink.repositoryUrl
       }
-    ],
-    syncedAt: pullRequestLink.data.syncedAt
+    ]
   };
 }
 async function resolveIssueByIdentifier(ctx, input) {
@@ -5463,11 +5539,23 @@ function normalizeGitHubPullRequestMergeStateStatus(value) {
       return "unknown";
   }
 }
+function normalizeGitHubPullRequestReviewDecision(value) {
+  switch (typeof value === "string" ? value.trim().toLowerCase() : "") {
+    case "approved":
+      return "approved";
+    case "changes_requested":
+      return "changes_requested";
+    case "review_required":
+      return "review_required";
+    default:
+      return "unknown";
+  }
+}
 function isGitHubPullRequestActionRequiredForSync(pullRequest) {
-  return pullRequest.mergeability === "conflicting" || ACTION_REQUIRED_GITHUB_PULL_REQUEST_MERGE_STATE_STATUSES.has(pullRequest.mergeStateStatus);
+  return pullRequest.reviewDecision === "changes_requested" || pullRequest.mergeability === "conflicting" || ACTION_REQUIRED_GITHUB_PULL_REQUEST_MERGE_STATE_STATUSES.has(pullRequest.mergeStateStatus);
 }
 function isGitHubPullRequestReviewReadyForSync(pullRequest) {
-  if (pullRequest.ciState !== "green" || pullRequest.hasUnresolvedReviewThreads) {
+  if (pullRequest.ciState !== "green" || pullRequest.hasUnresolvedReviewThreads || pullRequest.reviewDecision === "changes_requested") {
     return false;
   }
   return REVIEW_READY_GITHUB_PULL_REQUEST_MERGE_STATE_STATUSES.has(pullRequest.mergeStateStatus);
@@ -5500,6 +5588,9 @@ function listGitHubPullRequestSyncBlockingConditions(pullRequest) {
   if (pullRequest.hasUnresolvedReviewThreads) {
     conditions.push("unresolved review threads");
   }
+  if (pullRequest.reviewDecision === "changes_requested") {
+    conditions.push("requested changes");
+  }
   return conditions;
 }
 function tryBuildGitHubPullRequestStatusSnapshotFromBatchNode(node, repository) {
@@ -5517,7 +5608,8 @@ function tryBuildGitHubPullRequestStatusSnapshotFromBatchNode(node, repository)
     hasUnresolvedReviewThreads: reviewThreadSummary.unresolvedReviewThreads > 0,
     ciState,
     mergeability: normalizeGitHubPullRequestMergeability(node.mergeable),
-    mergeStateStatus: normalizeGitHubPullRequestMergeStateStatus(node.mergeStateStatus)
+    mergeStateStatus: normalizeGitHubPullRequestMergeStateStatus(node.mergeStateStatus),
+    reviewDecision: normalizeGitHubPullRequestReviewDecision(node.reviewDecision)
   };
 }
 function tryBuildGitHubPullRequestCiStateFromBatchNode(node) {
@@ -5574,6 +5666,7 @@ async function getGitHubPullRequestCiSnapshot(octokit, repository, pullRequestNu
   const contexts = [];
   let mergeability = "unknown";
   let mergeStateStatus = "unknown";
+  let reviewDecision = "unknown";
   let after;
   do {
     const response = await octokit.graphql(GITHUB_PULL_REQUEST_CI_CONTEXTS_QUERY, {
@@ -5584,6 +5677,7 @@ async function getGitHubPullRequestCiSnapshot(octokit, repository, pullRequestNu
     });
     mergeability = normalizeGitHubPullRequestMergeability(response.repository?.pullRequest?.mergeable);
     mergeStateStatus = normalizeGitHubPullRequestMergeStateStatus(response.repository?.pullRequest?.mergeStateStatus);
+    reviewDecision = normalizeGitHubPullRequestReviewDecision(response.repository?.pullRequest?.reviewDecision);
     const connection = response.repository?.pullRequest?.statusCheckRollup?.contexts;
     const nodes = connection?.nodes ?? [];
     for (const node of nodes) {
@@ -5610,7 +5704,8 @@ async function getGitHubPullRequestCiSnapshot(octokit, repository, pullRequestNu
   return {
     ciState: classifyGitHubPullRequestCiState(contexts),
     mergeability,
-    mergeStateStatus
+    mergeStateStatus,
+    reviewDecision
   };
 }
 async function getGitHubPullRequestStatusSnapshot(octokit, repository, pullRequestNumber, pullRequestStatusCache, options) {
@@ -5624,14 +5719,15 @@ async function getGitHubPullRequestStatusSnapshot(octokit, repository, pullReque
     setCachedGitHubPullRequestStatusSnapshot(pullRequestStatusCache, cachedSnapshot);
     return cachedSnapshot;
   }
-  if (options?.reviewThreadSummary && options.ciState && options.mergeability !== void 0 && options.mergeStateStatus !== void 0) {
+  if (options?.reviewThreadSummary && options.ciState && options.mergeability !== void 0 && options.mergeStateStatus !== void 0 && options.reviewDecision !== void 0) {
     const snapshot = cacheGitHubPullRequestStatusSnapshot(repository, {
       number: pullRequestNumber,
       repositoryUrl: repository.url,
       hasUnresolvedReviewThreads: options.reviewThreadSummary.unresolvedReviewThreads > 0,
       ciState: options.ciState,
       mergeability: options.mergeability,
-      mergeStateStatus: options.mergeStateStatus
+      mergeStateStatus: options.mergeStateStatus,
+      reviewDecision: options.reviewDecision
     });
     setCachedGitHubPullRequestStatusSnapshot(pullRequestStatusCache, snapshot);
     return snapshot;
@@ -5645,10 +5741,11 @@ async function getGitHubPullRequestStatusSnapshot(octokit, repository, pullReque
   const loadSnapshotPromise = (async () => {
     const [reviewThreadSummary, ciSnapshot] = await Promise.all([
       options?.reviewThreadSummary ?? getOrLoadCachedGitHubPullRequestReviewThreadSummary(octokit, repository, pullRequestNumber),
-      options?.ciState && options.mergeability !== void 0 && options.mergeStateStatus !== void 0 ? {
+      options?.ciState && options.mergeability !== void 0 && options.mergeStateStatus !== void 0 && options.reviewDecision !== void 0 ? {
         ciState: options.ciState,
         mergeability: options.mergeability,
-        mergeStateStatus: options.mergeStateStatus
+        mergeStateStatus: options.mergeStateStatus,
+        reviewDecision: options.reviewDecision
       } : getGitHubPullRequestCiSnapshot(octokit, repository, pullRequestNumber)
     ]);
     return cacheGitHubPullRequestStatusSnapshot(repository, {
@@ -5657,7 +5754,8 @@ async function getGitHubPullRequestStatusSnapshot(octokit, repository, pullReque
       hasUnresolvedReviewThreads: reviewThreadSummary.unresolvedReviewThreads > 0,
       ciState: ciSnapshot.ciState,
       mergeability: ciSnapshot.mergeability,
-      mergeStateStatus: ciSnapshot.mergeStateStatus
+      mergeStateStatus: ciSnapshot.mergeStateStatus,
+      reviewDecision: ciSnapshot.reviewDecision
     });
   })();
   activeGitHubPullRequestStatusSnapshotPromiseCache.set(cacheKey, loadSnapshotPromise);
@@ -10326,6 +10424,7 @@ async function buildProjectPullRequestSummaryRecord(octokit, repository, node, i
   });
   const inlineMergeability = normalizeGitHubPullRequestMergeability(node.mergeable);
   const inlineMergeStateStatus = normalizeGitHubPullRequestMergeStateStatus(node.mergeStateStatus);
+  const inlineReviewDecision = normalizeGitHubPullRequestReviewDecision(node.reviewDecision);
   const [reviewThreadSummary, reviewSummary, statusSnapshot, behindBy] = await Promise.all([
     getOrLoadCachedGitHubPullRequestReviewThreadSummary(
       octokit,
@@ -10343,7 +10442,8 @@ async function buildProjectPullRequestSummaryRecord(octokit, repository, node, i
       reviewThreadSummary: inlineReviewThreadSummary,
       ciState: inlineCiState,
       mergeability: inlineMergeability,
-      mergeStateStatus: inlineMergeStateStatus
+      mergeStateStatus: inlineMergeStateStatus,
+      reviewDecision: inlineReviewDecision
     }),
     getGitHubPullRequestBehindCount(octokit, repository, {
       baseBranch: node.baseRefName,
@@ -10483,6 +10583,7 @@ async function buildProjectPullRequestMetricCounts(octokit, repository, node, pu
   });
   const inlineMergeability = normalizeGitHubPullRequestMergeability(node.mergeable);
   const inlineMergeStateStatus = normalizeGitHubPullRequestMergeStateStatus(node.mergeStateStatus);
+  const inlineReviewDecision = normalizeGitHubPullRequestReviewDecision(node.reviewDecision);
   const [reviewThreadSummary, reviewSummary, statusSnapshot] = await Promise.all([
     getOrLoadCachedGitHubPullRequestReviewThreadSummary(
       octokit,
@@ -10500,7 +10601,8 @@ async function buildProjectPullRequestMetricCounts(octokit, repository, node, pu
       reviewThreadSummary: inlineReviewThreadSummary,
       ciState: inlineCiState,
       mergeability: inlineMergeability,
-      mergeStateStatus: inlineMergeStateStatus
+      mergeStateStatus: inlineMergeStateStatus,
+      reviewDecision: inlineReviewDecision
     })
   ]);
   const checksStatus = statusSnapshot.ciState === "green" ? "passed" : statusSnapshot.ciState === "red" ? "failed" : "pending";
@@ -13106,6 +13208,66 @@ function registerGitHubAgentTools(ctx) {
       );
     })
   );
+  ctx.tools.register(
+    "assign_to_current_user",
+    getGitHubAgentToolDeclaration("assign_to_current_user"),
+    async (params, runCtx) => executeGitHubTool(async () => {
+      const input = getToolInputRecord(params);
+      const target = await resolveGitHubIssueToolTarget(ctx, runCtx, input);
+      const octokit = await createGitHubToolOctokit(ctx, runCtx.companyId);
+      const [currentResponse, authenticatedUserResponse] = await Promise.all([
+        octokit.rest.issues.get({
+          owner: target.repository.owner,
+          repo: target.repository.repo,
+          issue_number: target.issueNumber,
+          headers: {
+            "X-GitHub-Api-Version": GITHUB_API_VERSION
+          }
+        }),
+        octokit.rest.users.getAuthenticated({
+          headers: {
+            "X-GitHub-Api-Version": GITHUB_API_VERSION
+          }
+        })
+      ]);
+      const assignedLogin = normalizeOptionalToolString(authenticatedUserResponse.data.login);
+      if (!assignedLogin) {
+        throw new Error("GitHub did not return the login for the saved token.");
+      }
+      const currentAssignees = (currentResponse.data.assignees ?? []).map((assignee) => assignee?.login ?? "").filter(Boolean);
+      const nextAssignees = mergeNamedValues(currentAssignees, {
+        setValues: [],
+        addValues: [assignedLogin],
+        removeValues: []
+      });
+      const alreadyAssigned = nextAssignees.length === currentAssignees.length && nextAssignees.every((assignee, index) => assignee.toLowerCase() === currentAssignees[index]?.toLowerCase());
+      const updatedResponse = alreadyAssigned ? currentResponse : await octokit.rest.issues.update({
+        owner: target.repository.owner,
+        repo: target.repository.repo,
+        issue_number: target.issueNumber,
+        assignees: nextAssignees,
+        headers: {
+          "X-GitHub-Api-Version": GITHUB_API_VERSION
+        }
+      });
+      const updatedIssue = normalizeGitHubIssueRecord(updatedResponse.data);
+      return buildToolSuccessResult(
+        alreadyAssigned ? `GitHub issue #${updatedIssue.number} in ${formatRepositoryLabel(target.repository)} was already assigned to ${assignedLogin}.` : `Assigned GitHub issue #${updatedIssue.number} in ${formatRepositoryLabel(target.repository)} to ${assignedLogin}.`,
+        {
+          repository: target.repository.url,
+          assignedLogin,
+          issue: {
+            number: updatedIssue.number,
+            title: updatedIssue.title,
+            url: updatedIssue.htmlUrl,
+            state: updatedIssue.state,
+            labels: normalizeGitHubIssueLabels(updatedResponse.data.labels),
+            assignees: (updatedResponse.data.assignees ?? []).map((assignee) => assignee?.login ?? "").filter(Boolean)
+          }
+        }
+      );
+    })
+  );
   ctx.tools.register(
     "add_issue_comment",
     getGitHubAgentToolDeclaration("add_issue_comment"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-github-plugin",
-  "version": "0.7.5",
+  "version": "0.8.1",
   "description": "Paperclip plugin for synchronizing GitHub issues into Paperclip projects.",
   "license": "Apache-2.0",
   "type": "module",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@octokit/rest": "^22.0.1",
-    "@paperclipai/plugin-sdk": "^2026.427.0",
+    "@paperclipai/plugin-sdk": "^2026.428.0",
     "react": "^19.2.5",
     "react-markdown": "^10.1.0",
     "rehype-raw": "^7.0.0",