paperclip-github-plugin 0.3.3 → 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
 
@@ -118,6 +118,8 @@ When a token is saved, the settings page audits the mapped repositories for the
 
 Imported issues keep the original GitHub title and use the normalized GitHub body as the Paperclip description. The worker also normalizes GitHub HTML that Paperclip descriptions do not render cleanly, including elements such as `<br>`, `<hr>`, `<details>`, `<summary>`, and inline images.
 
+To keep imported issues recognizable without cluttering the visible description, the plugin appends a hidden HTML comment footer with the source GitHub issue URL. Agents and repair flows use that marker when the plugin-owned link entity or import registry is missing.
+
 Repeated syncs keep existing imports current instead of creating duplicates again. If the plugin's import registry is stale, the worker can repair deduplication by reusing existing Paperclip issues when durable GitHub link metadata is already present.
 
 When the local Paperclip API is available, the plugin also syncs labels by name, prefers exact color matches when multiple Paperclip labels share the same name, and creates missing Paperclip labels when needed.
@@ -126,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` |
@@ -135,7 +138,9 @@ 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`.
 - When the sync changes a Paperclip issue status, it adds a Paperclip comment explaining what changed and why.
 
@@ -172,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.3"?.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