paperclip-github-plugin 0.4.4 → 0.4.5

package/README.md

@@ -71,7 +71,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, request reviewers, list org-level GitHub Projects, and associate pull requests with those projects 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, search org-level GitHub Projects, and associate pull requests with those projects without leaving the Paperclip plugin surface.
 
 ## Requirements
 
@@ -185,9 +185,9 @@ 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
+- organization-level GitHub Project search/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.
+When an agent sends GitHub body content through the plugin, including issue bodies, pull request descriptions, comments, and review-thread replies, the plugin adds a GitHub-flavored Markdown footer with a horizontal rule and compact heading that discloses AI authorship. If the tool caller supplies `llmModel`, the footer also includes the model name, for example `###### ✨ This comment was AI-generated using gpt-5.4`.
 
 Current host caveat: on authenticated Paperclip deployments, the Paperclip host currently guards `GET /api/plugins/tools` and `POST /api/plugins/tools/execute` with board authentication before dispatching to any plugin worker. If an agent run does not have board access for the target company, GitHub Sync tool discovery and execution fail with `403 {"error":"Board access required"}` before this plugin's worker code runs.
 

package/dist/manifest.js

@@ -35,7 +35,7 @@ var projectNumberProperty = {
 };
 var llmModelProperty = {
   type: "string",
-  description: "Exact LLM name used to draft the comment. Required so the plugin can append the mandatory AI-authorship footer."
+  description: "Exact LLM name used to draft the GitHub content. When provided, the plugin includes it in the mandatory AI-authorship footer."
 };
 var issueTargetSchema = {
   anyOf: [
@@ -149,7 +149,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "update_issue",
     displayName: "Update Issue",
-    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone.",
+    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -162,8 +162,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing issue description body. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         state: {
           type: "string",
           enum: ["open", "closed"]
@@ -215,11 +217,11 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "add_issue_comment",
     displayName: "Add Issue Comment",
-    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; include llmModel so the plugin can append the required AI-authorship footer.",
+    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; it must remain non-empty after trimming and removing any existing AI footer. The plugin appends the required AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
-      required: ["body", "llmModel"],
+      required: ["body"],
       ...issueTargetSchema,
       properties: {
         repository: repositoryProperty,
@@ -227,7 +229,8 @@ var GITHUB_AGENT_TOOLS = [
         paperclipIssueId: paperclipIssueIdProperty,
         body: {
           type: "string",
-          description: "Human-facing comment body without the AI footer."
+          minLength: 1,
+          description: "Human-facing comment body without the AI footer. It must remain non-empty after trimming and removing any existing AI footer."
         },
         llmModel: llmModelProperty
       }
@@ -236,7 +239,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "create_pull_request",
     displayName: "Create Pull Request",
-    description: "Open a GitHub pull request once the implementation branch is pushed.",
+    description: "Open a GitHub pull request once the implementation branch is pushed. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -255,8 +258,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing pull request description. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         draft: {
           type: "boolean"
         }
@@ -281,7 +286,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "update_pull_request",
     displayName: "Update Pull Request",
-    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review.",
+    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -294,8 +299,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing pull request description. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         base: {
           type: "string"
         },
@@ -358,11 +365,11 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "reply_to_review_thread",
     displayName: "Reply To Review Thread",
-    description: "Reply to an existing pull request review thread. Provide only the human-facing body; include llmModel so the plugin can append the required AI-authorship footer.",
+    description: "Reply to an existing pull request review thread. Provide only the human-facing body; the plugin appends the required AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
-      required: ["threadId", "body", "llmModel"],
+      required: ["threadId", "body"],
       properties: {
         threadId: {
           type: "string",
@@ -370,7 +377,8 @@ var GITHUB_AGENT_TOOLS = [
         },
         body: {
           type: "string",
-          description: "Human-facing reply body without the AI footer."
+          minLength: 1,
+          description: "Human-facing reply body without the AI footer. It must remain non-empty after trimming and removing any existing AI footer."
         },
         llmModel: llmModelProperty
       }
@@ -454,7 +462,7 @@ 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.",
+    description: "Search or list GitHub organization-level Projects so an agent can choose where to associate pull requests.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -503,7 +511,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.4.4"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var MANIFEST_VERSION = "0.4.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/worker.js

@@ -44,7 +44,7 @@ var projectNumberProperty = {
 };
 var llmModelProperty = {
   type: "string",
-  description: "Exact LLM name used to draft the comment. Required so the plugin can append the mandatory AI-authorship footer."
+  description: "Exact LLM name used to draft the GitHub content. When provided, the plugin includes it in the mandatory AI-authorship footer."
 };
 var issueTargetSchema = {
   anyOf: [
@@ -158,7 +158,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "update_issue",
     displayName: "Update Issue",
-    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone.",
+    description: "Update GitHub issue fields such as title, body, state, labels, assignees, or milestone. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -171,8 +171,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing issue description body. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         state: {
           type: "string",
           enum: ["open", "closed"]
@@ -224,11 +226,11 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "add_issue_comment",
     displayName: "Add Issue Comment",
-    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; include llmModel so the plugin can append the required AI-authorship footer.",
+    description: "Post a comment on a GitHub issue or pull request. Provide only the human-facing message body; it must remain non-empty after trimming and removing any existing AI footer. The plugin appends the required AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
-      required: ["body", "llmModel"],
+      required: ["body"],
       ...issueTargetSchema,
       properties: {
         repository: repositoryProperty,
@@ -236,7 +238,8 @@ var GITHUB_AGENT_TOOLS = [
         paperclipIssueId: paperclipIssueIdProperty,
         body: {
           type: "string",
-          description: "Human-facing comment body without the AI footer."
+          minLength: 1,
+          description: "Human-facing comment body without the AI footer. It must remain non-empty after trimming and removing any existing AI footer."
         },
         llmModel: llmModelProperty
       }
@@ -245,7 +248,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "create_pull_request",
     displayName: "Create Pull Request",
-    description: "Open a GitHub pull request once the implementation branch is pushed.",
+    description: "Open a GitHub pull request once the implementation branch is pushed. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -264,8 +267,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing pull request description. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         draft: {
           type: "boolean"
         }
@@ -290,7 +295,7 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "update_pull_request",
     displayName: "Update Pull Request",
-    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review.",
+    description: "Edit pull request title, body, base branch, open or close it, or convert between draft and ready for review. When a non-empty body is provided, the plugin appends an AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -303,8 +308,10 @@ var GITHUB_AGENT_TOOLS = [
           type: "string"
         },
         body: {
-          type: "string"
+          type: "string",
+          description: "Optional human-facing pull request description. If provided, it must remain non-empty after trimming and removing any existing AI footer."
         },
+        llmModel: llmModelProperty,
         base: {
           type: "string"
         },
@@ -367,11 +374,11 @@ var GITHUB_AGENT_TOOLS = [
   {
     name: "reply_to_review_thread",
     displayName: "Reply To Review Thread",
-    description: "Reply to an existing pull request review thread. Provide only the human-facing body; include llmModel so the plugin can append the required AI-authorship footer.",
+    description: "Reply to an existing pull request review thread. Provide only the human-facing body; the plugin appends the required AI-authorship footer and includes llmModel when supplied.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
-      required: ["threadId", "body", "llmModel"],
+      required: ["threadId", "body"],
       properties: {
         threadId: {
           type: "string",
@@ -379,7 +386,8 @@ var GITHUB_AGENT_TOOLS = [
         },
         body: {
           type: "string",
-          description: "Human-facing reply body without the AI footer."
+          minLength: 1,
+          description: "Human-facing reply body without the AI footer. It must remain non-empty after trimming and removing any existing AI footer."
         },
         llmModel: llmModelProperty
       }
@@ -463,7 +471,7 @@ 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.",
+    description: "Search or list GitHub organization-level Projects so an agent can choose where to associate pull requests.",
     parametersSchema: {
       type: "object",
       additionalProperties: false,
@@ -629,7 +637,9 @@ var IMPORTED_ISSUE_WAKE_REASON = "GitHub Sync imported an assigned issue that is
 var ISSUE_LINK_ENTITY_TYPE = "paperclip-github-plugin.issue-link";
 var PULL_REQUEST_LINK_ENTITY_TYPE = "paperclip-github-plugin.pull-request-link";
 var COMMENT_ANNOTATION_ENTITY_TYPE = "paperclip-github-plugin.comment-annotation";
-var AI_AUTHORED_COMMENT_FOOTER_PREFIX = "Created by a Paperclip AI agent using ";
+var AI_AUTHORED_FOOTER_MARKDOWN_PREFIX = "###### \u2728 This ";
+var AI_AUTHORED_LEGACY_FOOTER_PATTERN = /\n\n---\nCreated by a Paperclip AI agent(?: using [^\n]+)?\.\s*$/;
+var AI_AUTHORED_MARKDOWN_FOOTER_PATTERN = /\n\n---\n###### ✨ This (?:comment|issue description|pull request description) was AI-generated(?: using [^\n]+)?\s*$/;
 var HIDDEN_GITHUB_IMPORT_MARKER_PREFIX = "<!-- paperclip-github-plugin-imported-from: ";
 var HIDDEN_GITHUB_IMPORT_MARKER_SUFFIX = " -->";
 var EMPTY_GITHUB_ISSUE_DESCRIPTION_PLACEHOLDER = "_No description provided on GitHub._";
@@ -7183,22 +7193,36 @@ async function getGitHubPullRequestProjectItems(octokit, repository, pullRequest
     projectItems
   };
 }
-function formatAiAuthorshipFooter(llmModel) {
+function stripAiAuthorshipFooter(body) {
+  let strippedBody = body;
+  while (true) {
+    const nextBody = strippedBody.replace(AI_AUTHORED_LEGACY_FOOTER_PATTERN, "").replace(AI_AUTHORED_MARKDOWN_FOOTER_PATTERN, "");
+    if (nextBody === strippedBody) {
+      return strippedBody;
+    }
+    strippedBody = nextBody;
+  }
+}
+function formatAiAuthorshipFooter(subject, llmModel) {
+  const trimmedModel = llmModel?.trim();
   return `
 
 ---
-${AI_AUTHORED_COMMENT_FOOTER_PREFIX}${llmModel.trim()}.`;
+${AI_AUTHORED_FOOTER_MARKDOWN_PREFIX}${subject} was AI-generated${trimmedModel ? ` using ${trimmedModel}` : ""}`;
 }
-function appendAiAuthorshipFooter(body, llmModel) {
-  const trimmedBody = body.trim();
+function appendAiAuthorshipFooter(body, subject, llmModel) {
+  const trimmedBody = stripAiAuthorshipFooter(body).trim();
   if (!trimmedBody) {
     throw new Error("Comment body cannot be empty.");
   }
-  const trimmedModel = llmModel.trim();
-  if (!trimmedModel) {
-    throw new Error("llmModel is required when posting a GitHub comment.");
+  return `${trimmedBody}${formatAiAuthorshipFooter(subject, llmModel)}`;
+}
+function appendOptionalAiAuthorshipFooter(body, subject, llmModel) {
+  const trimmedBody = stripAiAuthorshipFooter(body).trim();
+  if (!trimmedBody) {
+    return void 0;
   }
-  return `${trimmedBody}${formatAiAuthorshipFooter(trimmedModel)}`;
+  return `${trimmedBody}${formatAiAuthorshipFooter(subject, llmModel)}`;
 }
 async function listAllGitHubIssueComments(octokit, repository, issueNumber) {
   const comments = [];
@@ -10262,7 +10286,8 @@ function registerGitHubAgentTools(ctx) {
         removeValues: normalizeToolStringArray(input.removeAssignees)
       });
       const title = Object.prototype.hasOwnProperty.call(input, "title") && typeof input.title === "string" ? input.title : void 0;
-      const body = Object.prototype.hasOwnProperty.call(input, "body") && typeof input.body === "string" ? input.body : void 0;
+      const llmModel = normalizeOptionalToolString(input.llmModel);
+      const body = Object.prototype.hasOwnProperty.call(input, "body") && typeof input.body === "string" ? appendOptionalAiAuthorshipFooter(input.body, "issue description", llmModel) : void 0;
       const state = input.state === "open" || input.state === "closed" ? input.state : void 0;
       const milestoneNumber = Object.prototype.hasOwnProperty.call(input, "milestoneNumber") ? input.milestoneNumber === null ? null : normalizeToolPositiveInteger(input.milestoneNumber) : void 0;
       const hasChanges = title !== void 0 || body !== void 0 || state !== void 0 || Object.prototype.hasOwnProperty.call(input, "milestoneNumber") || normalizeToolStringArray(input.setLabels).length > 0 || normalizeToolStringArray(input.addLabels).length > 0 || normalizeToolStringArray(input.removeLabels).length > 0 || normalizeToolStringArray(input.setAssignees).length > 0 || normalizeToolStringArray(input.addAssignees).length > 0 || normalizeToolStringArray(input.removeAssignees).length > 0;
@@ -10312,7 +10337,7 @@ function registerGitHubAgentTools(ctx) {
       const input = getToolInputRecord(params);
       const target = await resolveGitHubIssueToolTarget(ctx, runCtx, input);
       const octokit = await createGitHubToolOctokit(ctx, runCtx.companyId);
-      const body = appendAiAuthorshipFooter(String(input.body ?? ""), normalizeOptionalToolString(input.llmModel) ?? "");
+      const body = appendAiAuthorshipFooter(String(input.body ?? ""), "comment", normalizeOptionalToolString(input.llmModel));
       const response = await octokit.rest.issues.createComment({
         owner: target.repository.owner,
         repo: target.repository.repo,
@@ -10350,6 +10375,11 @@ function registerGitHubAgentTools(ctx) {
       if (!head || !base || !title) {
         throw new Error("head, base, and title are required.");
       }
+      const body = typeof input.body === "string" ? appendOptionalAiAuthorshipFooter(
+        input.body,
+        "pull request description",
+        normalizeOptionalToolString(input.llmModel)
+      ) : void 0;
       const octokit = await createGitHubToolOctokit(ctx, runCtx.companyId);
       const response = await octokit.rest.pulls.create({
         owner: repository.owner,
@@ -10357,7 +10387,7 @@ function registerGitHubAgentTools(ctx) {
         head,
         base,
         title,
-        ...typeof input.body === "string" ? { body: input.body } : {},
+        ...body !== void 0 ? { body } : {},
         ...typeof input.draft === "boolean" ? { draft: input.draft } : {},
         headers: {
           "X-GitHub-Api-Version": GITHUB_API_VERSION
@@ -10445,7 +10475,8 @@ function registerGitHubAgentTools(ctx) {
         }
       });
       const title = Object.prototype.hasOwnProperty.call(input, "title") && typeof input.title === "string" ? input.title : void 0;
-      const body = Object.prototype.hasOwnProperty.call(input, "body") && typeof input.body === "string" ? input.body : void 0;
+      const llmModel = normalizeOptionalToolString(input.llmModel);
+      const body = Object.prototype.hasOwnProperty.call(input, "body") && typeof input.body === "string" ? appendOptionalAiAuthorshipFooter(input.body, "pull request description", llmModel) : void 0;
       const base = normalizeOptionalToolString(input.base);
       const state = input.state === "open" || input.state === "closed" ? input.state : void 0;
       const isDraft = typeof input.isDraft === "boolean" ? input.isDraft : void 0;
@@ -10637,7 +10668,7 @@ function registerGitHubAgentTools(ctx) {
       if (!threadId) {
         throw new Error("threadId is required.");
       }
-      const body = appendAiAuthorshipFooter(String(input.body ?? ""), normalizeOptionalToolString(input.llmModel) ?? "");
+      const body = appendAiAuthorshipFooter(String(input.body ?? ""), "comment", normalizeOptionalToolString(input.llmModel));
       const octokit = await createGitHubToolOctokit(ctx, runCtx.companyId);
       const response = await octokit.graphql(
         GITHUB_ADD_PULL_REQUEST_REVIEW_THREAD_REPLY_MUTATION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-github-plugin",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Paperclip plugin for synchronizing GitHub issues into Paperclip projects.",
   "license": "Apache-2.0",
   "type": "module",