paperclip-github-plugin 0.3.1 → 0.3.3

package/README.md

@@ -150,7 +150,7 @@ The plugin is designed to avoid persisting raw credentials in plugin state.
 
 ### Optional worker-local token file
 
-If Paperclip-managed secrets are not available, the worker can read a local fallback file at `~/.paperclip/plugins/github-sync/config.json`:
+If Paperclip-managed secrets are not available, the worker can read a local fallback file at `${PAPERCLIP_HOME:-~/.paperclip}/plugins/github-sync/config.json`:
 
 ```json
 {
@@ -177,7 +177,7 @@ When an agent posts a GitHub comment or review-thread reply through the plugin,
 
 ## Troubleshooting
 
-- If setup is reported as incomplete, confirm that a GitHub token has been saved or that `~/.paperclip/plugins/github-sync/config.json` contains `githubToken`, and make sure at least one mapping has a created Paperclip project.
+- If setup is reported as incomplete, confirm that a GitHub token has been saved or that `${PAPERCLIP_HOME:-~/.paperclip}/plugins/github-sync/config.json` contains `githubToken`, and make sure at least one mapping has a created Paperclip project.
 - If Paperclip says board access is required, open plugin settings inside the affected company and complete the Paperclip board access flow before retrying sync.
 - If the worker reaches an authenticated HTML page instead of the Paperclip API JSON responses it expects, connect Paperclip board access for that company or set `PAPERCLIP_API_URL` to a worker-accessible Paperclip API origin.
 - If a sync run finishes with partial failures, open the saved troubleshooting panel in GitHub Sync to inspect the repository, issue number, raw error, and suggested fix for each recorded failure.

package/dist/manifest.js

@@ -435,7 +435,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.1"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+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 = {
   id: "paperclip-github-plugin",
   apiVersion: 1,

package/dist/worker.js

@@ -551,7 +551,7 @@ var SYNC_PROGRESS_PERSIST_INTERVAL_MS = 250;
 var MAX_SYNC_FAILURE_LOG_ENTRIES = 25;
 var GITHUB_SECONDARY_RATE_LIMIT_FALLBACK_MS = 6e4;
 var MISSING_GITHUB_TOKEN_SYNC_MESSAGE = "Configure a GitHub token before running sync.";
-var MISSING_GITHUB_TOKEN_SYNC_ACTION = 'Open settings and save a GitHub token secret, or create ~/.paperclip/plugins/github-sync/config.json with a "githubToken" value, and then run sync again.';
+var MISSING_GITHUB_TOKEN_SYNC_ACTION = 'Open settings and save a GitHub token secret, or create $PAPERCLIP_HOME/plugins/github-sync/config.json (or ~/.paperclip/plugins/github-sync/config.json when PAPERCLIP_HOME is unset) with a "githubToken" value, and then run sync again.';
 var MISSING_MAPPING_SYNC_MESSAGE = "Save at least one mapping with a created Paperclip project before running sync.";
 var MISSING_MAPPING_SYNC_ACTION = "Open settings, add a repository mapping, let Paperclip create the target project, and then retry sync.";
 var MISSING_BOARD_ACCESS_SYNC_MESSAGE = "Connect Paperclip board access before running sync on this authenticated deployment.";
@@ -559,7 +559,6 @@ var MISSING_BOARD_ACCESS_SYNC_ACTION = "Open plugin settings for each mapped com
 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 EXTERNAL_CONFIG_FILE_PATH_SEGMENTS = [".paperclip", "plugins", "github-sync", "config.json"];
 var AI_AUTHORED_COMMENT_FOOTER_PREFIX = "Created by a Paperclip AI agent using ";
 function normalizeCompanyId(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
@@ -1158,6 +1157,9 @@ function createMappingId(index) {
 function normalizeOptionalString2(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function stripNullBytes(value) {
+  return value.replace(/\u0000/g, "");
+}
 function getErrorStatus(error) {
   if (!error || typeof error !== "object" || !("status" in error)) {
     return void 0;
@@ -1420,7 +1422,11 @@ function normalizeSecretRef(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
 function normalizeGitHubUserLogin(value) {
-  return typeof value === "string" && value.trim() ? value.trim().toLowerCase() : void 0;
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = stripNullBytes(value).trim();
+  return trimmed ? trimmed.toLowerCase() : void 0;
 }
 function normalizeGitHubTokenRef(value) {
   return normalizeSecretRef(value);
@@ -2703,13 +2709,17 @@ function normalizeGitHubToken(value) {
   return trimmed ? trimmed : void 0;
 }
 function getExternalConfigFilePath() {
-  const homeDirectory = getHomeDirectory();
-  return homeDirectory ? join(homeDirectory, ...EXTERNAL_CONFIG_FILE_PATH_SEGMENTS) : void 0;
+  const paperclipHomeDirectory = getPaperclipHomeDirectory();
+  return paperclipHomeDirectory ? join(paperclipHomeDirectory, "plugins", "github-sync", "config.json") : void 0;
 }
-function getHomeDirectory() {
+function getPaperclipHomeDirectory() {
+  const configuredPaperclipHome = process.env.PAPERCLIP_HOME?.trim();
+  if (configuredPaperclipHome) {
+    return resolve(configuredPaperclipHome);
+  }
   try {
     const resolvedHomeDirectory = homedir();
-    return typeof resolvedHomeDirectory === "string" && resolvedHomeDirectory.trim() ? resolvedHomeDirectory : void 0;
+    return typeof resolvedHomeDirectory === "string" && resolvedHomeDirectory.trim() ? join(resolvedHomeDirectory, ".paperclip") : void 0;
   } catch {
     return void 0;
   }
@@ -2836,7 +2846,7 @@ function normalizeGitHubUsername(value) {
   if (typeof value !== "string") {
     return void 0;
   }
-  const trimmed = value.trim().replace(/^@+/, "");
+  const trimmed = stripNullBytes(value).trim().replace(/^@+/, "");
   return trimmed ? trimmed.toLowerCase() : void 0;
 }
 function buildGitHubUsernameAliases(value) {
@@ -3123,7 +3133,7 @@ function normalizeGitHubIssueLabels(value) {
   const seen = /* @__PURE__ */ new Set();
   const labels = [];
   for (const entry of value) {
-    const name = typeof entry === "string" ? entry.trim() : entry && typeof entry === "object" && typeof entry.name === "string" ? entry.name.trim() : "";
+    const name = typeof entry === "string" ? stripNullBytes(entry).trim() : entry && typeof entry === "object" && typeof entry.name === "string" ? stripNullBytes(entry.name).trim() : "";
     if (!name) {
       continue;
     }
@@ -3143,8 +3153,8 @@ function normalizeGitHubIssueRecord(issue) {
   return {
     id: issue.id,
     number: issue.number,
-    title: issue.title,
-    body: issue.body ?? null,
+    title: stripNullBytes(issue.title),
+    body: typeof issue.body === "string" ? stripNullBytes(issue.body) : null,
     htmlUrl: issue.html_url,
     ...normalizeGitHubUsername(issue.user?.login) ? { authorLogin: normalizeGitHubUsername(issue.user?.login) } : {},
     labels: normalizeGitHubIssueLabels(issue.labels),
@@ -3975,7 +3985,7 @@ async function listNewGitHubIssueCommentsSinceCount(octokit, repository, issueNu
     for (const comment of response.data.slice(remainingOffset)) {
       comments.push({
         id: comment.id,
-        body: comment.body ?? "",
+        body: typeof comment.body === "string" ? stripNullBytes(comment.body) : "",
         url: comment.html_url ?? void 0,
         authorLogin: normalizeGitHubUserLogin(comment.user?.login),
         createdAt: comment.created_at ?? void 0,
@@ -4176,7 +4186,7 @@ function normalizeGitHubIssueBodyForPaperclip(body) {
   if (typeof body !== "string") {
     return void 0;
   }
-  const trimmed = body.trim();
+  const trimmed = stripNullBytes(body).trim();
   if (!trimmed) {
     return void 0;
   }
@@ -6402,7 +6412,7 @@ async function listAllGitHubIssueComments(octokit, repository, issueNumber) {
     for (const comment of response.data) {
       comments.push({
         id: comment.id,
-        body: comment.body ?? "",
+        body: typeof comment.body === "string" ? stripNullBytes(comment.body) : "",
         url: comment.html_url ?? void 0,
         authorLogin: normalizeGitHubUserLogin(comment.user?.login),
         authorUrl: comment.user?.html_url ?? void 0,

package/package.json

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