paperclip-github-plugin 0.3.4 → 0.3.6

package/dist/worker.js

@@ -15,6 +15,10 @@ var repositoryProperty = {
   type: "string",
   description: "GitHub repository as owner/repo or https://github.com/owner/repo. Omit when the current Paperclip project has exactly one mapped repository."
 };
+var organizationProperty = {
+  type: "string",
+  description: "GitHub organization login that owns the Projects."
+};
 var paperclipIssueIdProperty = {
   type: "string",
   description: "Paperclip issue id used to infer the linked GitHub issue and repository when available."
@@ -29,6 +33,15 @@ var pullRequestNumberProperty = {
   minimum: 1,
   description: "GitHub pull request number."
 };
+var projectIdProperty = {
+  type: "string",
+  description: "GitHub ProjectV2 node id. You can use the id returned by list_organization_projects."
+};
+var projectNumberProperty = {
+  type: "integer",
+  minimum: 1,
+  description: "GitHub organization project number. Requires organization when projectId is not provided."
+};
 var llmModelProperty = {
   type: "string",
   description: "Exact LLM name used to draft the comment. Required so the plugin can append the mandatory AI-authorship footer."
@@ -53,6 +66,16 @@ var pullRequestTargetSchema = {
     }
   ]
 };
+var organizationProjectTargetSchema = {
+  anyOf: [
+    {
+      required: ["projectId"]
+    },
+    {
+      required: ["organization", "projectNumber"]
+    }
+  ]
+};
 var GITHUB_AGENT_TOOLS = [
   {
     name: "search_repository_items",
@@ -436,6 +459,51 @@ 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.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["organization"],
+      properties: {
+        organization: organizationProperty,
+        includeClosed: {
+          type: "boolean",
+          description: "Include closed Projects in the results. Defaults to false."
+        },
+        query: {
+          type: "string",
+          description: "Optional free-text filter matched against project titles and descriptions after loading the organization projects."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 100,
+          description: "Maximum number of projects to return."
+        }
+      }
+    }
+  },
+  {
+    name: "add_pull_request_to_project",
+    displayName: "Add Pull Request To Project",
+    description: "Associate a GitHub pull request with an organization-level GitHub Project.",
+    parametersSchema: {
+      type: "object",
+      additionalProperties: false,
+      allOf: [pullRequestTargetSchema, organizationProjectTargetSchema],
+      properties: {
+        repository: repositoryProperty,
+        pullRequestNumber: pullRequestNumberProperty,
+        paperclipIssueId: paperclipIssueIdProperty,
+        projectId: projectIdProperty,
+        organization: organizationProperty,
+        projectNumber: projectNumberProperty
+      }
+    }
   }
 ];
 function getGitHubAgentToolDeclaration(name) {
@@ -640,6 +708,7 @@ var FAILED_CHECK_RUN_CONCLUSIONS = /* @__PURE__ */ new Set([
 var SUCCESSFUL_STATUS_CONTEXT_STATES = /* @__PURE__ */ new Set(["SUCCESS"]);
 var FAILED_STATUS_CONTEXT_STATES = /* @__PURE__ */ new Set(["ERROR", "FAILURE"]);
 var PENDING_STATUS_CONTEXT_STATES = /* @__PURE__ */ new Set(["EXPECTED", "PENDING"]);
+var GITHUB_REPOSITORY_MAINTAINER_WARMUP_CONCURRENCY = 4;
 var GITHUB_REPOSITORY_MAINTAINER_ROLE_NAMES = /* @__PURE__ */ new Set(["admin", "maintain"]);
 var GITHUB_ISSUE_STATUS_SNAPSHOT_QUERY = `
   query GitHubIssueStatusSnapshot($owner: String!, $repo: String!, $issueNumber: Int!, $after: String) {
@@ -1039,6 +1108,114 @@ var GITHUB_PULL_REQUEST_REVIEW_THREADS_DETAILED_QUERY = `
     }
   }
 `;
+var GITHUB_ORGANIZATION_PROJECTS_QUERY = `
+  query GitHubOrganizationProjects($organization: String!, $after: String, $first: Int!) {
+    organization(login: $organization) {
+      projectsV2(first: $first, after: $after, orderBy: { field: UPDATED_AT, direction: DESC }) {
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+        nodes {
+          id
+          number
+          title
+          shortDescription
+          url
+          closed
+          updatedAt
+        }
+      }
+    }
+  }
+`;
+var GITHUB_ORGANIZATION_PROJECT_BY_NUMBER_QUERY = `
+  query GitHubOrganizationProjectByNumber($organization: String!, $projectNumber: Int!) {
+    organization(login: $organization) {
+      projectV2(number: $projectNumber) {
+        id
+        number
+        title
+        url
+        closed
+        owner {
+          __typename
+          ... on Organization {
+            login
+          }
+          ... on User {
+            login
+          }
+        }
+      }
+    }
+  }
+`;
+var GITHUB_PULL_REQUEST_PROJECT_ITEMS_QUERY = `
+  query GitHubPullRequestProjectItems($owner: String!, $repo: String!, $pullRequestNumber: Int!, $after: String) {
+    repository(owner: $owner, name: $repo) {
+      pullRequest(number: $pullRequestNumber) {
+        id
+        number
+        title
+        url
+        projectItems(first: 100, after: $after) {
+          pageInfo {
+            hasNextPage
+            endCursor
+          }
+          nodes {
+            id
+            project {
+              id
+              number
+              title
+              url
+              closed
+              owner {
+                __typename
+                ... on Organization {
+                  login
+                }
+                ... on User {
+                  login
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+var GITHUB_ADD_PULL_REQUEST_TO_PROJECT_MUTATION = `
+  mutation GitHubAddPullRequestToProject($projectId: ID!, $contentId: ID!) {
+    addProjectV2ItemById(input: {
+      projectId: $projectId
+      contentId: $contentId
+    }) {
+      item {
+        id
+        project {
+          id
+          number
+          title
+          url
+          closed
+          owner {
+            __typename
+            ... on Organization {
+              login
+            }
+            ... on User {
+              login
+            }
+          }
+        }
+      }
+    }
+  }
+`;
 var GITHUB_ADD_PULL_REQUEST_REVIEW_THREAD_REPLY_MUTATION = `
   mutation GitHubAddPullRequestReviewThreadReply($pullRequestReviewThreadId: ID!, $body: String!) {
     addPullRequestReviewThreadReply(input: {
@@ -3615,7 +3792,7 @@ function normalizePaperclipIssueStatus(value) {
   return PAPERCLIP_ISSUE_STATUSES.includes(value) ? value : void 0;
 }
 function describeGitHubStatusTransitionReason(params) {
-  const { snapshot, previousCommentCount, hasTrustedNewComment } = params;
+  const { snapshot, previousCommentCount, hasTrustedNewComment, maintainerAuthoredImportedIssue } = params;
   if (snapshot.state === "closed") {
     switch (snapshot.stateReason) {
       case "duplicate":
@@ -3631,6 +3808,9 @@ function describeGitHubStatusTransitionReason(params) {
     return "a new GitHub comment from the issue author or a repository maintainer was added";
   }
   if (snapshot.linkedPullRequests.length === 0) {
+    if (maintainerAuthoredImportedIssue) {
+      return "the GitHub issue is open with no linked pull requests and was created by a repository maintainer";
+    }
     return "the GitHub issue is open with no linked pull requests";
   }
   const linkedPullRequestSubject = snapshot.linkedPullRequests.length === 1 ? "the linked pull request" : "linked pull requests";
@@ -3669,11 +3849,20 @@ function buildStatusTransitionCommentAnnotation(params) {
   };
 }
 function buildPaperclipIssueStatusTransitionComment(params) {
-  const { previousStatus, nextStatus, repository, snapshot, previousCommentCount, hasTrustedNewComment } = params;
+  const {
+    previousStatus,
+    nextStatus,
+    repository,
+    snapshot,
+    previousCommentCount,
+    hasTrustedNewComment,
+    maintainerAuthoredImportedIssue
+  } = params;
   const reason = describeGitHubStatusTransitionReason({
     snapshot,
     previousCommentCount,
-    hasTrustedNewComment
+    hasTrustedNewComment,
+    maintainerAuthoredImportedIssue
   });
   return {
     body: `GitHub Sync updated the status from \`${formatPaperclipIssueStatus(previousStatus)}\` to \`${formatPaperclipIssueStatus(nextStatus)}\` because ${reason}.`,
@@ -3693,7 +3882,8 @@ function resolvePaperclipIssueStatus(params) {
     previousCommentCount,
     hasTrustedNewComment,
     wasImportedThisRun,
-    defaultImportedStatus
+    defaultImportedStatus,
+    maintainerAuthoredImportedIssue
   } = params;
   if (snapshot.state === "closed") {
     return snapshot.stateReason === "duplicate" || snapshot.stateReason === "not_planned" ? "cancelled" : "done";
@@ -3709,7 +3899,7 @@ function resolvePaperclipIssueStatus(params) {
     return resolvePaperclipStatusFromLinkedPullRequests(snapshot.linkedPullRequests);
   }
   if (wasImportedThisRun) {
-    return defaultImportedStatus;
+    return maintainerAuthoredImportedIssue ? "todo" : defaultImportedStatus;
   }
   if (currentStatus === "done" || currentStatus === "cancelled") {
     return "todo";
@@ -4116,6 +4306,40 @@ async function hasTrustedNewGitHubIssueComment(params) {
   }
   return false;
 }
+async function isMaintainerAuthoredGitHubIssue(params) {
+  const authorLogin = normalizeGitHubUserLogin(params.githubIssue.authorLogin);
+  if (!authorLogin) {
+    return false;
+  }
+  return isGitHubUserRepositoryMaintainer(
+    params.octokit,
+    params.repository,
+    authorLogin,
+    params.maintainerCache
+  );
+}
+async function warmGitHubRepositoryMaintainerCache(params) {
+  const uniqueAuthorLogins = [...new Set(
+    params.githubIssues.map((issue) => normalizeGitHubUserLogin(issue.authorLogin)).filter((authorLogin) => Boolean(authorLogin))
+  )].filter((authorLogin) => !params.maintainerCache.has(buildGitHubRepositoryActorCacheKey(params.repository, authorLogin)));
+  if (uniqueAuthorLogins.length === 0) {
+    return;
+  }
+  await mapWithConcurrency(uniqueAuthorLogins, GITHUB_REPOSITORY_MAINTAINER_WARMUP_CONCURRENCY, async (authorLogin) => {
+    try {
+      await isGitHubUserRepositoryMaintainer(
+        params.octokit,
+        params.repository,
+        authorLogin,
+        params.maintainerCache
+      );
+    } catch (error) {
+      if (isGitHubRateLimitError(error)) {
+        throw error;
+      }
+    }
+  });
+}
 function parseGitHubIssueHtmlUrl(value) {
   try {
     const url = new URL(value.trim());
@@ -4709,9 +4933,6 @@ function selectPaperclipLabelForGitHubLabel(githubLabel, directory) {
 function getPaperclipLabelsEndpoint(baseUrl, companyId) {
   return new URL(`/api/companies/${companyId}/labels`, baseUrl).toString();
 }
-function getPaperclipIssuesEndpoint(baseUrl, companyId) {
-  return new URL(`/api/companies/${companyId}/issues`, baseUrl).toString();
-}
 function getPaperclipIssueEndpoint(baseUrl, issueId) {
   return new URL(`/api/issues/${issueId}`, baseUrl).toString();
 }
@@ -4762,17 +4983,6 @@ async function detectPaperclipBoardAccessRequirement(paperclipApiBaseUrl) {
     return false;
   }
 }
-function parsePaperclipIssueId(value) {
-  if (!value || typeof value !== "object") {
-    return null;
-  }
-  const id = value.id;
-  if (typeof id !== "string") {
-    return null;
-  }
-  const trimmedId = id.trim();
-  return trimmedId || null;
-}
 function parsePaperclipIssueDescription(value) {
   if (!value || typeof value !== "object") {
     return void 0;
@@ -5577,87 +5787,22 @@ function shouldIgnoreGitHubIssue(issue, advancedSettings) {
     (ignoredUsername) => buildGitHubUsernameAliases(ignoredUsername).some((alias) => issueAuthorAliases.has(alias))
   );
 }
-async function applyDefaultAssigneeToPaperclipIssue(ctx, params) {
-  const { companyId, issueId, defaultAssigneeAgentId } = params;
-  if (!defaultAssigneeAgentId) {
-    return;
-  }
-  try {
-    await ctx.issues.update(issueId, { assigneeAgentId: defaultAssigneeAgentId }, companyId);
-  } catch (error) {
-    ctx.logger.warn("Unable to apply the default assignee to an imported GitHub issue.", {
-      companyId,
-      issueId,
-      assigneeAgentId: defaultAssigneeAgentId,
-      error: getErrorMessage(error)
-    });
-  }
-}
 async function createPaperclipIssue(ctx, mapping, advancedSettings, issue, availableLabels, paperclipApiBaseUrl, syncFailureContext) {
   if (!mapping.companyId || !mapping.paperclipProjectId) {
     throw new Error(`Mapping ${mapping.id} is missing resolved Paperclip project identifiers.`);
   }
   const title = issue.title;
   const description = buildPaperclipIssueDescription(issue);
-  let createdIssueId = null;
-  let createdIssueDescription;
-  let createPath = "sdk";
-  if (paperclipApiBaseUrl) {
-    try {
-      const response = await fetchPaperclipApi(
-        getPaperclipIssuesEndpoint(paperclipApiBaseUrl, mapping.companyId),
-        {
-          method: "POST",
-          headers: {
-            accept: "application/json",
-            "content-type": "application/json"
-          },
-          body: JSON.stringify({
-            projectId: mapping.paperclipProjectId,
-            title,
-            ...description ? { description } : {}
-          })
-        },
-        {
-          companyId: mapping.companyId
-        }
-      );
-      const payloadResult = await readPaperclipApiJsonResponse(response, {
-        operationLabel: "issue create"
-      });
-      if (!payloadResult.failure) {
-        const createdIssue = payloadResult.data;
-        createdIssueId = parsePaperclipIssueId(createdIssue);
-        createdIssueDescription = parsePaperclipIssueDescription(createdIssue);
-        createPath = "local_api";
-      }
-    } catch {
-    }
-  }
-  if (!createdIssueId) {
-    const createdIssue = await ctx.issues.create({
-      companyId: mapping.companyId,
-      projectId: mapping.paperclipProjectId,
-      title,
-      ...description ? { description } : {},
-      ...advancedSettings.defaultAssigneeAgentId ? { assigneeAgentId: advancedSettings.defaultAssigneeAgentId } : {}
-    });
-    createdIssueId = createdIssue.id;
-    createdIssueDescription = createdIssue.description;
-    createPath = "sdk";
-  }
-  const ensuredCreatedIssueId = createdIssueId;
-  if (!ensuredCreatedIssueId) {
-    throw new Error("GitHub sync could not resolve the created Paperclip issue id.");
-  }
-  const normalizedCreatedIssueDescription = createdIssueDescription ?? void 0;
-  if (createPath !== "sdk") {
-    await applyDefaultAssigneeToPaperclipIssue(ctx, {
-      companyId: mapping.companyId,
-      issueId: ensuredCreatedIssueId,
-      defaultAssigneeAgentId: advancedSettings.defaultAssigneeAgentId
-    });
-  }
+  const createdIssue = await ctx.issues.create({
+    companyId: mapping.companyId,
+    projectId: mapping.paperclipProjectId,
+    title,
+    ...description ? { description } : {},
+    ...advancedSettings.defaultAssigneeAgentId ? { assigneeAgentId: advancedSettings.defaultAssigneeAgentId } : {}
+  });
+  const ensuredCreatedIssueId = createdIssue.id;
+  const normalizedCreatedIssueDescription = createdIssue.description ?? void 0;
+  const createPath = "sdk";
   if (normalizeIssueDescriptionValue(normalizedCreatedIssueDescription) !== description) {
     logIssueDescriptionDiagnostic(
       ctx,
@@ -5910,13 +6055,21 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         currentCommentCount: snapshot.commentCount,
         maintainerCache: repositoryMaintainerCache
       });
+      const wasImportedThisRun = createdIssueIds.has(importedIssue.githubIssueId);
+      const maintainerAuthoredImportedIssue = wasImportedThisRun && advancedSettings.defaultStatus !== "todo" && snapshot.state === "open" && snapshot.linkedPullRequests.length === 0 ? await isMaintainerAuthoredGitHubIssue({
+        octokit,
+        repository,
+        githubIssue,
+        maintainerCache: repositoryMaintainerCache
+      }) : false;
       const nextStatus = resolvePaperclipIssueStatus({
         currentStatus: paperclipIssue.status,
         snapshot,
         previousCommentCount,
         hasTrustedNewComment,
-        wasImportedThisRun: createdIssueIds.has(importedIssue.githubIssueId),
-        defaultImportedStatus: advancedSettings.defaultStatus
+        wasImportedThisRun,
+        defaultImportedStatus: advancedSettings.defaultStatus,
+        maintainerAuthoredImportedIssue
       });
       importedIssue.githubIssueNumber = githubIssue.number;
       importedIssue.lastSeenCommentCount = snapshot.commentCount;
@@ -5929,7 +6082,8 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         repository,
         snapshot,
         previousCommentCount,
-        hasTrustedNewComment
+        hasTrustedNewComment,
+        maintainerAuthoredImportedIssue
       });
       updateSyncFailureContext(syncFailureContext, {
         phase: "updating_paperclip_status",
@@ -6496,6 +6650,170 @@ async function resolveGitHubPullRequestToolTarget(ctx, runCtx, input) {
     pullRequestNumber
   };
 }
+function normalizeGitHubProjectRecord(project, fallbackOwnerLogin) {
+  const id = normalizeOptionalString2(project?.id);
+  const title = normalizeOptionalString2(project?.title);
+  const url = normalizeOptionalString2(project?.url);
+  const number = typeof project?.number === "number" && Number.isInteger(project.number) && project.number > 0 ? Math.floor(project.number) : null;
+  if (!id || !title || !url || number === null) {
+    return null;
+  }
+  const shortDescription = normalizeOptionalString2(project?.shortDescription);
+  const updatedAt = normalizeOptionalString2(project?.updatedAt);
+  const ownerLogin = normalizeOptionalString2(project?.owner?.login) ?? fallbackOwnerLogin;
+  return {
+    id,
+    number,
+    title,
+    url,
+    closed: project?.closed === true,
+    ...shortDescription ? { shortDescription } : {},
+    ...updatedAt ? { updatedAt } : {},
+    ...ownerLogin ? { ownerLogin } : {}
+  };
+}
+function buildGitHubProjectToolData(project, options) {
+  return {
+    id: project.id,
+    number: project.number,
+    title: project.title,
+    ...project.shortDescription ? { shortDescription: project.shortDescription } : {},
+    url: project.url,
+    closed: project.closed,
+    ...project.updatedAt ? { updatedAt: project.updatedAt } : {},
+    ...options?.includeOwnerLogin && project.ownerLogin ? { ownerLogin: project.ownerLogin } : {}
+  };
+}
+function matchesGitHubProjectFilter(project, query) {
+  const normalizedQuery = normalizeOptionalString2(query)?.toLowerCase();
+  if (!normalizedQuery) {
+    return true;
+  }
+  return [project.title, project.shortDescription].filter((value) => Boolean(value)).some((value) => value.toLowerCase().includes(normalizedQuery));
+}
+async function listGitHubOrganizationProjects(octokit, organization, options) {
+  const normalizedOrganization = normalizeOptionalString2(organization);
+  if (!normalizedOrganization) {
+    throw new Error("organization is required.");
+  }
+  const includeClosed = options?.includeClosed === true;
+  const limit = Math.min(normalizeToolPositiveInteger(options?.limit) ?? 20, 100);
+  const projects = [];
+  let after;
+  do {
+    const response = await octokit.graphql(
+      GITHUB_ORGANIZATION_PROJECTS_QUERY,
+      {
+        organization: normalizedOrganization,
+        first: Math.min(50, Math.max(1, limit)),
+        after
+      }
+    );
+    if (!response.organization) {
+      throw new Error(`GitHub organization ${normalizedOrganization} was not found or is not visible to the configured token.`);
+    }
+    const connection = response.organization.projectsV2;
+    for (const node of connection?.nodes ?? []) {
+      const project = normalizeGitHubProjectRecord(node, normalizedOrganization);
+      if (!project) {
+        continue;
+      }
+      if (!includeClosed && project.closed) {
+        continue;
+      }
+      if (!matchesGitHubProjectFilter(project, options?.query)) {
+        continue;
+      }
+      projects.push(project);
+      if (projects.length >= limit) {
+        return projects;
+      }
+    }
+    after = getPageCursor(connection?.pageInfo);
+  } while (after);
+  return projects;
+}
+async function resolveGitHubProjectToolTarget(octokit, input) {
+  const explicitProjectId = normalizeOptionalString2(input.projectId);
+  if (explicitProjectId) {
+    return {
+      projectId: explicitProjectId
+    };
+  }
+  const organization = normalizeOptionalToolString(input.organization);
+  const projectNumber = normalizeToolPositiveInteger(input.projectNumber);
+  if (!organization || projectNumber === void 0) {
+    throw new Error("Provide either projectId or both organization and projectNumber.");
+  }
+  const response = await octokit.graphql(
+    GITHUB_ORGANIZATION_PROJECT_BY_NUMBER_QUERY,
+    {
+      organization,
+      projectNumber
+    }
+  );
+  const project = normalizeGitHubProjectRecord(response.organization?.projectV2, organization);
+  if (!project) {
+    throw new Error(`GitHub organization project #${projectNumber} was not found in ${organization}.`);
+  }
+  return {
+    projectId: project.id,
+    project
+  };
+}
+async function getGitHubPullRequestProjectItems(octokit, repository, pullRequestNumber) {
+  const projectItems = [];
+  let after;
+  let pullRequestId;
+  let pullRequestTitle;
+  let pullRequestUrl;
+  do {
+    const response = await octokit.graphql(
+      GITHUB_PULL_REQUEST_PROJECT_ITEMS_QUERY,
+      {
+        owner: repository.owner,
+        repo: repository.repo,
+        pullRequestNumber,
+        after
+      }
+    );
+    const pullRequest = response.repository?.pullRequest;
+    const currentPullRequestId = normalizeOptionalString2(pullRequest?.id);
+    const currentPullRequestTitle = normalizeOptionalString2(pullRequest?.title);
+    const currentPullRequestUrl = normalizeOptionalString2(pullRequest?.url);
+    if (!currentPullRequestId || !currentPullRequestTitle || !currentPullRequestUrl) {
+      throw new Error(`GitHub pull request #${pullRequestNumber} was not found in ${formatRepositoryLabel(repository)}.`);
+    }
+    pullRequestId ??= currentPullRequestId;
+    pullRequestTitle ??= currentPullRequestTitle;
+    pullRequestUrl ??= currentPullRequestUrl;
+    const connection = response.repository?.pullRequest?.projectItems;
+    for (const node of connection?.nodes ?? []) {
+      const itemId = normalizeOptionalString2(node?.id);
+      const project = normalizeGitHubProjectRecord(node?.project);
+      if (!itemId || !project) {
+        continue;
+      }
+      projectItems.push({
+        id: itemId,
+        project
+      });
+    }
+    after = getPageCursor(connection?.pageInfo);
+  } while (after);
+  if (!pullRequestId || !pullRequestTitle || !pullRequestUrl) {
+    throw new Error(`GitHub pull request #${pullRequestNumber} was not found in ${formatRepositoryLabel(repository)}.`);
+  }
+  return {
+    pullRequestId,
+    pullRequest: {
+      number: pullRequestNumber,
+      title: pullRequestTitle,
+      url: pullRequestUrl
+    },
+    projectItems
+  };
+}
 function formatAiAuthorshipFooter(llmModel) {
   return `
 
@@ -9144,6 +9462,22 @@ async function performSync(ctx, trigger, options = {}) {
         const importedIssuesForSynchronization = [...importRegistryByIssueId.values()].filter(
           (importedIssue) => allIssuesById.has(importedIssue.githubIssueId) && doesImportedIssueMatchTarget(importedIssue, options.target)
         );
+        const newlyImportedIssuesForMaintainerWarmup = advancedSettings.defaultStatus === "todo" ? [] : importedIssuesForSynchronization.filter((importedIssue) => createdIssueIds.has(importedIssue.githubIssueId)).map((importedIssue) => allIssuesById.get(importedIssue.githubIssueId)).filter(
+          (githubIssue) => githubIssue !== void 0 && githubIssue.state === "open"
+        ).filter(
+          (githubIssue) => !(linkedPullRequestsByIssueNumber.get(githubIssue.number) ?? []).some(
+            (pullRequest) => pullRequest.state === "OPEN"
+          )
+        );
+        if (newlyImportedIssuesForMaintainerWarmup.length > 0) {
+          await warmGitHubRepositoryMaintainerCache({
+            octokit,
+            repository,
+            githubIssues: newlyImportedIssuesForMaintainerWarmup,
+            maintainerCache: repositoryMaintainerCache
+          });
+          await throwIfSyncCancelled();
+        }
         currentProgress = {
           phase: "syncing",
           totalRepositoryCount: mappings.length,
@@ -10043,6 +10377,91 @@ function registerGitHubAgentTools(ctx) {
       );
     })
   );
+  ctx.tools.register(
+    "list_organization_projects",
+    getGitHubAgentToolDeclaration("list_organization_projects"),
+    async (params) => executeGitHubTool(async () => {
+      const input = getToolInputRecord(params);
+      const organization = normalizeOptionalToolString(input.organization);
+      if (!organization) {
+        throw new Error("organization is required.");
+      }
+      const octokit = await createGitHubToolOctokit(ctx);
+      const projects = await listGitHubOrganizationProjects(octokit, organization, {
+        includeClosed: input.includeClosed === true,
+        query: normalizeOptionalToolString(input.query),
+        limit: normalizeToolPositiveInteger(input.limit)
+      });
+      return buildToolSuccessResult(
+        `Loaded ${projects.length} GitHub organization ${projects.length === 1 ? "project" : "projects"} from ${organization}.`,
+        {
+          organization,
+          projects: projects.map((project) => buildGitHubProjectToolData(project))
+        }
+      );
+    })
+  );
+  ctx.tools.register(
+    "add_pull_request_to_project",
+    getGitHubAgentToolDeclaration("add_pull_request_to_project"),
+    async (params, runCtx) => executeGitHubTool(async () => {
+      const input = getToolInputRecord(params);
+      const target = await resolveGitHubPullRequestToolTarget(ctx, runCtx, input);
+      const octokit = await createGitHubToolOctokit(ctx);
+      const projectTarget = await resolveGitHubProjectToolTarget(octokit, input);
+      const pullRequest = await getGitHubPullRequestProjectItems(
+        octokit,
+        target.repository,
+        target.pullRequestNumber
+      );
+      const existingProjectItem = pullRequest.projectItems.find((item) => item.project.id === projectTarget.projectId);
+      if (existingProjectItem) {
+        return buildToolSuccessResult(
+          `Pull request #${target.pullRequestNumber} is already associated with GitHub project #${existingProjectItem.project.number}.`,
+          {
+            repository: target.repository.url,
+            pullRequest: pullRequest.pullRequest,
+            project: buildGitHubProjectToolData(existingProjectItem.project, {
+              includeOwnerLogin: true
+            }),
+            projectItem: {
+              id: existingProjectItem.id
+            },
+            alreadyAssociated: true
+          }
+        );
+      }
+      const response = await octokit.graphql(
+        GITHUB_ADD_PULL_REQUEST_TO_PROJECT_MUTATION,
+        {
+          projectId: projectTarget.projectId,
+          contentId: pullRequest.pullRequestId
+        }
+      );
+      const projectItemId = normalizeOptionalString2(response.addProjectV2ItemById?.item?.id);
+      const project = normalizeGitHubProjectRecord(
+        response.addProjectV2ItemById?.item?.project,
+        projectTarget.project?.ownerLogin
+      ) ?? projectTarget.project;
+      if (!projectItemId || !project) {
+        throw new Error("GitHub did not return the created project item.");
+      }
+      return buildToolSuccessResult(
+        `Added pull request #${target.pullRequestNumber} to GitHub project #${project.number}.`,
+        {
+          repository: target.repository.url,
+          pullRequest: pullRequest.pullRequest,
+          project: buildGitHubProjectToolData(project, {
+            includeOwnerLogin: true
+          }),
+          projectItem: {
+            id: projectItemId
+          },
+          alreadyAssociated: false
+        }
+      );
+    })
+  );
 }
 function shouldStartWorkerHost(moduleUrl, entry = process.argv[1]) {
   if (typeof entry !== "string" || !entry.trim()) {