@gaud_erp/paperclip-github-manager 0.3.0

package/README.md

@@ -0,0 +1,69 @@
+# @gaud_erp/paperclip-github-manager
+
+Paperclip connector plugin for GitHub — repository listing, PR/issue sync, and webhook registration.
+
+## Features
+
+- List repositories for the authenticated user
+- Sync open pull requests and issues (manual actions + scheduled job)
+- Register GitHub webhooks pointing at the Paperclip host inbound URL
+- Dashboard health widget and full **GitHub** page in the host UI
+
+## Requirements
+
+- Paperclip instance with plugin runtime
+- GitHub PAT saved in **GitHub → Configurações** (or company secret UUID when secret refs are re-enabled)
+- For webhook registration: token scope `admin:repo_hook` on target repos
+
+## Repository
+
+Source: [gauderp/paperclip-github-manager](https://github.com/gauderp/paperclip-github-manager)
+
+## Local development
+
+```bash
+npm install
+npm run dev
+paperclipai plugin install /absolute/path/to/plugins/github-manager
+```
+
+## Releases e npmjs
+
+Cada **release no GitHub** (tag `v*`, ex. `v0.3.0`) dispara o workflow [publish-npm.yml](.github/workflows/publish-npm.yml) e publica `@gaud_erp/paperclip-github-manager` no [npmjs](https://www.npmjs.com/package/@gaud_erp/paperclip-github-manager).
+
+### Primeira vez / credencial
+
+1. No repo **gauderp/paperclip-github-manager** → Settings → Secrets → Actions: `NPM_TOKEN` (publish no escopo `@gaud_erp`).
+2. Criar release no GitHub: tag `v0.3.0` apontando para `main`.
+3. Confirmar: `npm view @gaud_erp/paperclip-github-manager version`
+
+### Próximas versões
+
+1. Bump `version` em `package.json` + `src/manifest.ts`
+2. Commit, push `main`
+3. GitHub → **Create release** com tag `vX.Y.Z`
+
+## Production install (npm)
+
+```bash
+paperclipai plugin install @gaud_erp/paperclip-github-manager@0.3.0 --api-base http://127.0.0.1:3100
+paperclipai plugin inspect cus.github-manager --api-base http://127.0.0.1:3100
+```
+
+Configure o PAT em **GitHub → Configurações** na sidebar do Paperclip.
+
+## Build
+
+```bash
+npm run typecheck
+npm test
+npm run build
+```
+
+`prepublishOnly` runs build automatically before `npm publish`.
+
+## Manifest
+
+- Plugin id: `cus.github-manager`
+- Webhook endpoint: `github-events`
+- Scheduled job: `sync-github` (every 6 hours)

package/dist/manifest.js

@@ -0,0 +1,118 @@
+// src/constants.ts
+var ROUTES = {
+  repos: "github",
+  settings: "github-settings",
+  pullRequests: "github-pull-requests"
+};
+
+// src/manifest.ts
+var manifest = {
+  id: "cus.github-manager",
+  apiVersion: 1,
+  version: "0.3.0",
+  displayName: "GitHub Manager",
+  description: "Plugin Paperclip para gerenciar repositorios, PRs, issues e webhooks GitHub",
+  author: "CUS",
+  categories: ["connector"],
+  capabilities: [
+    "events.subscribe",
+    "http.outbound",
+    "secrets.read-ref",
+    "plugin.state.read",
+    "plugin.state.write",
+    "jobs.schedule",
+    "webhooks.receive",
+    "ui.sidebar.register",
+    "ui.dashboardWidget.register",
+    "ui.page.register"
+  ],
+  jobs: [
+    {
+      jobKey: "sync-github",
+      displayName: "Sync GitHub PRs and issues",
+      description: "Pulls open PRs and issues for tracked repositories",
+      schedule: "0 */6 * * *"
+    }
+  ],
+  webhooks: [
+    {
+      endpointKey: "github-events",
+      displayName: "GitHub repository events",
+      description: "Receives pull_request and issues events from configured repositories"
+    }
+  ],
+  entrypoints: {
+    worker: "./dist/worker.js",
+    ui: "./dist/ui"
+  },
+  ui: {
+    slots: [
+      {
+        type: "sidebarPanel",
+        id: "github-module",
+        displayName: "GitHub",
+        exportName: "GitHubSidebarModule",
+        order: 45
+      },
+      {
+        type: "routeSidebar",
+        id: "github-route-nav",
+        displayName: "GitHub",
+        routePath: ROUTES.repos,
+        exportName: "GitHubRouteSidebar",
+        order: 45
+      },
+      {
+        type: "routeSidebar",
+        id: "github-settings-route-nav",
+        displayName: "GitHub",
+        routePath: ROUTES.settings,
+        exportName: "GitHubRouteSidebar",
+        order: 45
+      },
+      {
+        type: "routeSidebar",
+        id: "github-prs-route-nav",
+        displayName: "GitHub",
+        routePath: ROUTES.pullRequests,
+        exportName: "GitHubRouteSidebar",
+        order: 45
+      },
+      {
+        type: "dashboardWidget",
+        id: "github-health",
+        displayName: "GitHub Manager Health",
+        exportName: "DashboardWidget"
+      },
+      {
+        type: "page",
+        id: "github-settings-page",
+        displayName: "GitHub \u2014 Configura\xE7\xF5es",
+        routePath: ROUTES.settings,
+        exportName: "GitHubSettingsPage",
+        order: 45
+      },
+      {
+        type: "page",
+        id: "github-repos-page",
+        displayName: "GitHub \u2014 Reposit\xF3rios",
+        routePath: ROUTES.repos,
+        exportName: "GitHubReposPage",
+        order: 45
+      },
+      {
+        type: "page",
+        id: "github-prs-page",
+        displayName: "GitHub \u2014 Pull requests",
+        routePath: ROUTES.pullRequests,
+        exportName: "GitHubPullRequestsPage",
+        order: 45
+      }
+    ]
+  }
+};
+var manifest_default = manifest;
+export {
+  manifest_default as default
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/constants.ts", "../src/manifest.ts"],
+  "sourcesContent": ["/** Plugin page route segments (manifest `routePath` \u2014 single slug, no slashes). */\nexport const ROUTES = {\n  repos: \"github\",\n  settings: \"github-settings\",\n  pullRequests: \"github-pull-requests\"\n} as const;\n\n/** Host navigation paths (use with `linkProps`). */\nexport const PATHS = {\n  repos: \"/github\",\n  settings: \"/github-settings\",\n  pullRequests: \"/github-pull-requests\",\n  companySecrets: \"/company/settings\"\n} as const;\n\nexport const GITHUB_TOKEN_SECRET_KEY = \"github_token\";\n", "import type { PaperclipPluginManifestV1 } from \"@paperclipai/plugin-sdk\";\nimport { ROUTES } from \"./constants.js\";\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: \"cus.github-manager\",\n  apiVersion: 1,\n  version: \"0.3.0\",\n  displayName: \"GitHub Manager\",\n  description: \"Plugin Paperclip para gerenciar repositorios, PRs, issues e webhooks GitHub\",\n  author: \"CUS\",\n  categories: [\"connector\"],\n  capabilities: [\n    \"events.subscribe\",\n    \"http.outbound\",\n    \"secrets.read-ref\",\n    \"plugin.state.read\",\n    \"plugin.state.write\",\n    \"jobs.schedule\",\n    \"webhooks.receive\",\n    \"ui.sidebar.register\",\n    \"ui.dashboardWidget.register\",\n    \"ui.page.register\"\n  ],\n  jobs: [\n    {\n      jobKey: \"sync-github\",\n      displayName: \"Sync GitHub PRs and issues\",\n      description: \"Pulls open PRs and issues for tracked repositories\",\n      schedule: \"0 */6 * * *\"\n    }\n  ],\n  webhooks: [\n    {\n      endpointKey: \"github-events\",\n      displayName: \"GitHub repository events\",\n      description: \"Receives pull_request and issues events from configured repositories\"\n    }\n  ],\n  entrypoints: {\n    worker: \"./dist/worker.js\",\n    ui: \"./dist/ui\"\n  },\n  ui: {\n    slots: [\n      {\n        type: \"sidebarPanel\",\n        id: \"github-module\",\n        displayName: \"GitHub\",\n        exportName: \"GitHubSidebarModule\",\n        order: 45\n      },\n      {\n        type: \"routeSidebar\",\n        id: \"github-route-nav\",\n        displayName: \"GitHub\",\n        routePath: ROUTES.repos,\n        exportName: \"GitHubRouteSidebar\",\n        order: 45\n      },\n      {\n        type: \"routeSidebar\",\n        id: \"github-settings-route-nav\",\n        displayName: \"GitHub\",\n        routePath: ROUTES.settings,\n        exportName: \"GitHubRouteSidebar\",\n        order: 45\n      },\n      {\n        type: \"routeSidebar\",\n        id: \"github-prs-route-nav\",\n        displayName: \"GitHub\",\n        routePath: ROUTES.pullRequests,\n        exportName: \"GitHubRouteSidebar\",\n        order: 45\n      },\n      {\n        type: \"dashboardWidget\",\n        id: \"github-health\",\n        displayName: \"GitHub Manager Health\",\n        exportName: \"DashboardWidget\"\n      },\n      {\n        type: \"page\",\n        id: \"github-settings-page\",\n        displayName: \"GitHub \u2014 Configura\u00E7\u00F5es\",\n        routePath: ROUTES.settings,\n        exportName: \"GitHubSettingsPage\",\n        order: 45\n      },\n      {\n        type: \"page\",\n        id: \"github-repos-page\",\n        displayName: \"GitHub \u2014 Reposit\u00F3rios\",\n        routePath: ROUTES.repos,\n        exportName: \"GitHubReposPage\",\n        order: 45\n      },\n      {\n        type: \"page\",\n        id: \"github-prs-page\",\n        displayName: \"GitHub \u2014 Pull requests\",\n        routePath: ROUTES.pullRequests,\n        exportName: \"GitHubPullRequestsPage\",\n        order: 45\n      }\n    ]\n  }\n};\n\nexport default manifest;\n"],
+  "mappings": ";AACO,IAAM,SAAS;AAAA,EACpB,OAAO;AAAA,EACP,UAAU;AAAA,EACV,cAAc;AAChB;;;ACFA,IAAM,WAAsC;AAAA,EAC1C,IAAI;AAAA,EACJ,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,aAAa;AAAA,EACb,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY,CAAC,WAAW;AAAA,EACxB,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,MAAM;AAAA,IACJ;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR;AAAA,MACE,aAAa;AAAA,MACb,aAAa;AAAA,MACb,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,IAAI;AAAA,EACN;AAAA,EACA,IAAI;AAAA,IACF,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,MACd;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,mBAAQ;",
+  "names": []
+}