paperclip-github-plugin 0.3.0 → 0.3.2

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.0"?.trim() || typeof packageJson.version === "string" && packageJson.version.trim() || process.env.npm_package_version?.trim() || "0.0.0-dev";
+var MANIFEST_VERSION = "0.3.2"?.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

@@ -1,11 +1,13 @@
 // src/worker.ts
+import { realpathSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { Octokit } from "@octokit/rest";
 import {
   definePlugin,
-  runWorker
+  startWorkerRpcHost
 } from "@paperclipai/plugin-sdk";
 
 // src/github-agent-tools.ts
@@ -549,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.";
@@ -557,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;
@@ -2625,8 +2626,8 @@ async function waitForSyncResultWithinGracePeriod(promise, timeoutMs) {
   try {
     return await Promise.race([
       promise,
-      new Promise((resolve) => {
-        timer = globalThis.setTimeout(() => resolve(null), timeoutMs);
+      new Promise((resolve2) => {
+        timer = globalThis.setTimeout(() => resolve2(null), timeoutMs);
       })
     ]);
   } finally {
@@ -2701,13 +2702,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;
   }
@@ -9917,6 +9922,17 @@ function registerGitHubAgentTools(ctx) {
     })
   );
 }
+function shouldStartWorkerHost(moduleUrl, entry = process.argv[1]) {
+  if (typeof entry !== "string" || !entry.trim()) {
+    return false;
+  }
+  const modulePath = fileURLToPath(moduleUrl);
+  try {
+    return realpathSync(entry) === realpathSync(modulePath);
+  } catch {
+    return resolve(entry) === resolve(modulePath);
+  }
+}
 var plugin = definePlugin({
   async setup(ctx) {
     ctx.data.register("settings.registration", async (input) => {
@@ -10190,7 +10206,10 @@ var plugin = definePlugin({
   }
 });
 var worker_default = plugin;
-runWorker(plugin, import.meta.url);
+if (shouldStartWorkerHost(import.meta.url)) {
+  startWorkerRpcHost({ plugin });
+}
 export {
-  worker_default as default
+  worker_default as default,
+  shouldStartWorkerHost
 };

package/package.json

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