paperclip-github-plugin 0.3.4 → 0.3.5

package/README.md

@@ -21,7 +21,7 @@ With this plugin, you can:
 - configure mappings and import defaults per Paperclip company
 - run sync manually or on a schedule
 - triage open pull requests from mapped Paperclip projects in a hosted queue
-- give Paperclip agents native GitHub tools for issues, pull requests, CI, and review threads
+- give Paperclip agents native GitHub tools for issues, pull requests, CI, review threads, and org-level projects
 
 ## What you get in Paperclip
 
@@ -53,7 +53,7 @@ GitHub tokens and sync cadence are shared at the plugin instance level, while re
 
 ### Project binding that respects existing work
 
-If a company already has a Paperclip project bound to a GitHub repository workspace, the settings UI can reuse that project instead of creating a duplicate. New mappings can also create and bind a Paperclip project automatically.
+If a company already has a Paperclip project bound to a GitHub repository workspace, the settings UI can reuse that project instead of creating a duplicate. New mappings can also create and bind a Paperclip project automatically, and those newly created projects opt into isolated issue checkouts.
 
 ### Status sync with delivery context
 
@@ -67,7 +67,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, and request reviewers 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, list org-level GitHub Projects, and associate pull requests with those projects without leaving the Paperclip plugin surface.
 
 ## Requirements
 
@@ -128,6 +128,7 @@ When the local Paperclip API is available, the plugin also syncs labels by name,
 
 | GitHub condition | Paperclip status |
 | --- | --- |
+| Open issue with no linked pull request, created by a repository maintainer | `todo` on first import |
 | Open issue with no linked pull request | Configured default status, which defaults to `backlog` |
 | Open issue with a linked pull request and unfinished CI | `in_progress` |
 | Open issue with failing CI or unresolved review threads | `todo` |
@@ -137,6 +138,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`.
 - 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`.
@@ -175,6 +177,7 @@ 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
 
 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.
 

package/dist/manifest.js

@@ -6,6 +6,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."
@@ -20,6 +24,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."
@@ -44,6 +57,16 @@ var pullRequestTargetSchema = {
     }
   ]
 };
+var organizationProjectTargetSchema = {
+  anyOf: [
+    {
+      required: ["projectId"]
+    },
+    {
+      required: ["organization", "projectNumber"]
+    }
+  ]
+};
 var GITHUB_AGENT_TOOLS = [
   {
     name: "search_repository_items",
@@ -427,6 +450,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
+      }
+    }
   }
 ];
 
@@ -435,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.3.4"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var MANIFEST_VERSION = "0.3.5"?.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

@@ -27558,7 +27558,10 @@ async function resolveOrCreateProject(companyId, projectName) {
     method: "POST",
     body: JSON.stringify({
       name: projectName.trim(),
-      status: "planned"
+      status: "planned",
+      executionWorkspacePolicy: {
+        enabled: true
+      }
     })
   });
 }
@@ -33119,6 +33122,7 @@ export {
   GitHubSyncProjectPullRequestsPage,
   GitHubSyncProjectPullRequestsSidebarItem,
   GitHubSyncSettingsPage,
-  index_default as default
+  index_default as default,
+  resolveOrCreateProject
 };
 //# sourceMappingURL=index.js.map