@gaud_erp/paperclip-github-manager 1.4.0 → 1.6.0

package/dist/manifest.js

@@ -1,7 +1,7 @@
 // src/manifest.ts
 var manifest = {
   id: "cus.github-manager",
-  version: "1.4.0",
+  version: "1.6.0",
   apiVersion: 1,
   displayName: "GitHub Manager",
   description: "Manage GitHub repos, PRs, issues, agent code reviews, and knowledge graphs \u2014 all from Paperclip",
@@ -29,7 +29,8 @@ var manifest = {
     "ui.sidebar.register",
     "ui.detailTab.register",
     "ui.action.register",
-    "instance.settings.register"
+    "instance.settings.register",
+    "skills.managed"
   ],
   instanceConfigSchema: {
     type: "object",
@@ -158,6 +159,19 @@ var manifest = {
         },
         required: ["query"]
       }
+    },
+    {
+      name: "github_get_repo_structure",
+      displayName: "Get Repo Structure",
+      description: "Get the cached directory/file structure of a repository. Use this FIRST before reading files to understand the codebase layout and save tokens. Set refresh=true to regenerate from GitHub.",
+      parametersSchema: {
+        type: "object",
+        properties: {
+          repo_full_name: { type: "string", description: "owner/repo format" },
+          refresh: { type: "boolean", description: "Set true to regenerate the structure from GitHub (use when cache is stale)" }
+        },
+        required: ["repo_full_name"]
+      }
     }
   ],
   agents: [
@@ -168,6 +182,61 @@ var manifest = {
       title: "Senior Code Reviewer"
     }
   ],
+  skills: [
+    {
+      skillKey: "github-codebase-access",
+      displayName: "GitHub Codebase Access",
+      description: "Provides agents with tools to read repository structure and files from GitHub without needing local filesystem access",
+      markdown: `# GitHub Codebase Access
+
+You have access to GitHub repositories through the GitHub Manager plugin tools. NEVER say you don't have access to the codebase.
+
+## Available Tools
+
+### 1. github_get_repo_structure
+Get the directory and file structure of a repository. **Always call this FIRST** before reading any files.
+
+Parameters:
+- \`repo_full_name\` (required): Repository in "owner/repo" format
+- \`refresh\` (optional): Set to true to regenerate from GitHub if cache is stale
+
+### 2. github_read_file_content
+Read the content of a specific file from a GitHub repository.
+
+Parameters:
+- \`owner\` (required): Repository owner (e.g. "gauderp")
+- \`repo\` (required): Repository name (e.g. "gaud-erp-api")
+- \`path\` (required): File path (e.g. "src/main/java/com/gaud/App.java")
+- \`ref\` (optional): Branch or commit SHA (defaults to main branch)
+
+### 3. github_get_pull_request_diff
+Get the unified diff of a pull request for code review.
+
+Parameters:
+- \`owner\`, \`repo\`, \`pull_number\`
+
+### 4. github_search_issues
+Search GitHub issues and PRs using GitHub search syntax.
+
+Parameters:
+- \`query\`: GitHub search query (e.g. "is:open label:bug")
+
+### 5. github_list_repositories
+List all tracked GitHub repositories (no parameters needed).
+
+## Mandatory Workflow
+
+1. **ALWAYS** start with \`github_get_repo_structure\` to understand the codebase layout
+2. Read only the files you actually need with \`github_read_file_content\`
+3. If the structure seems outdated, call \`github_get_repo_structure\` with \`refresh=true\`
+4. Never try to access the local filesystem for source code \u2014 always use these tools
+
+## Token Efficiency
+The structure cache returns directories and key files in a single call (~5-50KB).
+This replaces hundreds of file-listing API calls, saving 60-90% of tokens.
+`
+    }
+  ],
   ui: {
     slots: [
       {

package/dist/manifest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/manifest.ts"],
-  "sourcesContent": ["import type { PaperclipPluginManifestV1 } from \"@paperclipai/plugin-sdk\";\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: \"cus.github-manager\",\n  version: \"1.4.0\",\n  apiVersion: 1,\n  displayName: \"GitHub Manager\",\n  description: \"Manage GitHub repos, PRs, issues, agent code reviews, and knowledge graphs \u2014 all from Paperclip\",\n  author: \"Gaud ERP\",\n  categories: [\"connector\", \"automation\"],\n\n  capabilities: [\n    \"events.subscribe\",\n    \"events.emit\",\n    \"http.outbound\",\n    \"plugin.state.read\",\n    \"plugin.state.write\",\n    \"database.namespace.read\",\n    \"database.namespace.write\",\n    \"database.namespace.migrate\",\n    \"jobs.schedule\",\n    \"webhooks.receive\",\n    \"agent.tools.register\",\n    \"agents.managed\",\n    \"agents.invoke\",\n    \"agents.read\",\n    \"issues.read\",\n    \"companies.read\",\n    \"ui.page.register\",\n    \"ui.dashboardWidget.register\",\n    \"ui.sidebar.register\",\n    \"ui.detailTab.register\",\n    \"ui.action.register\",\n    \"instance.settings.register\",\n  ],\n\n  instanceConfigSchema: {\n    type: \"object\",\n    required: [\"githubToken\"],\n    properties: {\n      githubToken: {\n        type: \"string\",\n        title: \"GitHub Personal Access Token\",\n        description: \"Cole aqui o PAT do GitHub com permiss\u00F5es 'repo' e 'read:org'\",\n      },\n      defaultOrg: {\n        type: \"string\",\n        title: \"Default Organization\",\n        description: \"GitHub organization to sync repositories from (optional)\",\n      },\n      syncIntervalMinutes: {\n        type: \"number\",\n        title: \"Sync Interval (minutes)\",\n        description: \"How often to sync PRs and issues (default: 5)\",\n        default: 5,\n        minimum: 1,\n        maximum: 1440,\n      },\n    },\n  },\n\n  entrypoints: {\n    worker: \"./dist/worker.js\",\n    ui: \"./dist/ui\",\n  },\n\n  database: {\n    migrationsDir: \"src/db/migrations\",\n  },\n\n  jobs: [\n    {\n      jobKey: \"sync-github\",\n      displayName: \"Sync GitHub PRs and Issues\",\n      schedule: \"*/5 * * * *\",\n      description: \"Incremental sync of open PRs and issues for tracked repositories\",\n    },\n  ],\n\n  webhooks: [\n    {\n      endpointKey: \"github-events\",\n      displayName: \"GitHub Events\",\n      description: \"Receives GitHub webhook events (pull_request, issues)\",\n    },\n  ],\n\n  tools: [\n    {\n      name: \"github_get_pull_request_diff\",\n      displayName: \"Get PR Diff\",\n      description: \"Retrieve the unified diff of a GitHub pull request\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          pull_number: { type: \"number\" },\n        },\n        required: [\"owner\", \"repo\", \"pull_number\"],\n      },\n    },\n    {\n      name: \"github_read_file_content\",\n      displayName: \"Read File\",\n      description: \"Read a file from a GitHub repository\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          path: { type: \"string\" },\n          ref: { type: \"string\" },\n        },\n        required: [\"owner\", \"repo\", \"path\"],\n      },\n    },\n    {\n      name: \"github_create_review_comment\",\n      displayName: \"Add Review Comment\",\n      description: \"Post an inline review comment on a pull request\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          pull_number: { type: \"number\" },\n          commit_id: { type: \"string\" },\n          path: { type: \"string\" },\n          line: { type: \"number\" },\n          body: { type: \"string\" },\n        },\n        required: [\"owner\", \"repo\", \"pull_number\", \"commit_id\", \"path\", \"line\", \"body\"],\n      },\n    },\n    {\n      name: \"github_submit_pr_review\",\n      displayName: \"Submit PR Review\",\n      description: \"Submit a review verdict (approve, request changes, comment)\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          pull_number: { type: \"number\" },\n          event: { type: \"string\", enum: [\"APPROVE\", \"REQUEST_CHANGES\", \"COMMENT\"] },\n          body: { type: \"string\" },\n        },\n        required: [\"owner\", \"repo\", \"pull_number\", \"event\", \"body\"],\n      },\n    },\n    {\n      name: \"github_list_repositories\",\n      displayName: \"List Repositories\",\n      description: \"List all tracked GitHub repositories\",\n      parametersSchema: { type: \"object\", properties: {} },\n    },\n    {\n      name: \"github_search_issues\",\n      displayName: \"Search Issues\",\n      description: \"Search GitHub issues and PRs using search syntax\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          query: { type: \"string\" },\n        },\n        required: [\"query\"],\n      },\n    },\n  ],\n\n  agents: [\n    {\n      agentKey: \"github-reviewer\",\n      displayName: \"GitHub Code Reviewer\",\n      role: \"code-review\",\n      title: \"Senior Code Reviewer\",\n    },\n  ],\n\n  ui: {\n    slots: [\n      {\n        type: \"sidebar\",\n        id: \"github-sidebar\",\n        exportName: \"GitHubSidebarLink\",\n        displayName: \"GitHub\",\n      },\n      {\n        type: \"page\",\n        id: \"github-settings\",\n        exportName: \"GitHubSettingsPage\",\n        displayName: \"Configura\u00E7\u00F5es GitHub\",\n        routePath: \"github-settings\",\n      },\n      {\n        type: \"page\",\n        id: \"github-repos\",\n        exportName: \"GitHubReposPage\",\n        displayName: \"Reposit\u00F3rios\",\n        routePath: \"github-repos\",\n      },\n      {\n        type: \"page\",\n        id: \"github-prs\",\n        exportName: \"GitHubPullRequestsPage\",\n        displayName: \"Pull Requests\",\n        routePath: \"github-prs\",\n      },\n      {\n        type: \"page\",\n        id: \"github-graphs\",\n        exportName: \"GitHubGraphsPage\",\n        displayName: \"Knowledge Graphs\",\n        routePath: \"github-graphs\",\n      },\n      {\n        type: \"dashboardWidget\",\n        id: \"github-dashboard\",\n        exportName: \"GitHubDashboardWidget\",\n        displayName: \"GitHub Status\",\n      },\n      {\n        type: \"detailTab\",\n        id: \"github-detail\",\n        exportName: \"GitHubDetailTab\",\n        displayName: \"GitHub\",\n        entityTypes: [\"issue\"],\n      },\n      {\n        type: \"contextMenuItem\",\n        id: \"github-context-menu\",\n        exportName: \"GitHubContextMenu\",\n        displayName: \"GitHub Actions\",\n        entityTypes: [\"issue\"],\n      },\n    ],\n  },\n};\n\nexport default manifest;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { PaperclipPluginManifestV1 } from \"@paperclipai/plugin-sdk\";\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: \"cus.github-manager\",\n  version: \"1.6.0\",\n  apiVersion: 1,\n  displayName: \"GitHub Manager\",\n  description: \"Manage GitHub repos, PRs, issues, agent code reviews, and knowledge graphs \u2014 all from Paperclip\",\n  author: \"Gaud ERP\",\n  categories: [\"connector\", \"automation\"],\n\n  capabilities: [\n    \"events.subscribe\",\n    \"events.emit\",\n    \"http.outbound\",\n    \"plugin.state.read\",\n    \"plugin.state.write\",\n    \"database.namespace.read\",\n    \"database.namespace.write\",\n    \"database.namespace.migrate\",\n    \"jobs.schedule\",\n    \"webhooks.receive\",\n    \"agent.tools.register\",\n    \"agents.managed\",\n    \"agents.invoke\",\n    \"agents.read\",\n    \"issues.read\",\n    \"companies.read\",\n    \"ui.page.register\",\n    \"ui.dashboardWidget.register\",\n    \"ui.sidebar.register\",\n    \"ui.detailTab.register\",\n    \"ui.action.register\",\n    \"instance.settings.register\",\n    \"skills.managed\",\n  ],\n\n  instanceConfigSchema: {\n    type: \"object\",\n    required: [\"githubToken\"],\n    properties: {\n      githubToken: {\n        type: \"string\",\n        title: \"GitHub Personal Access Token\",\n        description: \"Cole aqui o PAT do GitHub com permiss\u00F5es 'repo' e 'read:org'\",\n      },\n      defaultOrg: {\n        type: \"string\",\n        title: \"Default Organization\",\n        description: \"GitHub organization to sync repositories from (optional)\",\n      },\n      syncIntervalMinutes: {\n        type: \"number\",\n        title: \"Sync Interval (minutes)\",\n        description: \"How often to sync PRs and issues (default: 5)\",\n        default: 5,\n        minimum: 1,\n        maximum: 1440,\n      },\n    },\n  },\n\n  entrypoints: {\n    worker: \"./dist/worker.js\",\n    ui: \"./dist/ui\",\n  },\n\n  database: {\n    migrationsDir: \"src/db/migrations\",\n  },\n\n  jobs: [\n    {\n      jobKey: \"sync-github\",\n      displayName: \"Sync GitHub PRs and Issues\",\n      schedule: \"*/5 * * * *\",\n      description: \"Incremental sync of open PRs and issues for tracked repositories\",\n    },\n  ],\n\n  webhooks: [\n    {\n      endpointKey: \"github-events\",\n      displayName: \"GitHub Events\",\n      description: \"Receives GitHub webhook events (pull_request, issues)\",\n    },\n  ],\n\n  tools: [\n    {\n      name: \"github_get_pull_request_diff\",\n      displayName: \"Get PR Diff\",\n      description: \"Retrieve the unified diff of a GitHub pull request\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          pull_number: { type: \"number\" },\n        },\n        required: [\"owner\", \"repo\", \"pull_number\"],\n      },\n    },\n    {\n      name: \"github_read_file_content\",\n      displayName: \"Read File\",\n      description: \"Read a file from a GitHub repository\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          path: { type: \"string\" },\n          ref: { type: \"string\" },\n        },\n        required: [\"owner\", \"repo\", \"path\"],\n      },\n    },\n    {\n      name: \"github_create_review_comment\",\n      displayName: \"Add Review Comment\",\n      description: \"Post an inline review comment on a pull request\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          pull_number: { type: \"number\" },\n          commit_id: { type: \"string\" },\n          path: { type: \"string\" },\n          line: { type: \"number\" },\n          body: { type: \"string\" },\n        },\n        required: [\"owner\", \"repo\", \"pull_number\", \"commit_id\", \"path\", \"line\", \"body\"],\n      },\n    },\n    {\n      name: \"github_submit_pr_review\",\n      displayName: \"Submit PR Review\",\n      description: \"Submit a review verdict (approve, request changes, comment)\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          owner: { type: \"string\" },\n          repo: { type: \"string\" },\n          pull_number: { type: \"number\" },\n          event: { type: \"string\", enum: [\"APPROVE\", \"REQUEST_CHANGES\", \"COMMENT\"] },\n          body: { type: \"string\" },\n        },\n        required: [\"owner\", \"repo\", \"pull_number\", \"event\", \"body\"],\n      },\n    },\n    {\n      name: \"github_list_repositories\",\n      displayName: \"List Repositories\",\n      description: \"List all tracked GitHub repositories\",\n      parametersSchema: { type: \"object\", properties: {} },\n    },\n    {\n      name: \"github_search_issues\",\n      displayName: \"Search Issues\",\n      description: \"Search GitHub issues and PRs using search syntax\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          query: { type: \"string\" },\n        },\n        required: [\"query\"],\n      },\n    },\n    {\n      name: \"github_get_repo_structure\",\n      displayName: \"Get Repo Structure\",\n      description: \"Get the cached directory/file structure of a repository. Use this FIRST before reading files to understand the codebase layout and save tokens. Set refresh=true to regenerate from GitHub.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          repo_full_name: { type: \"string\", description: \"owner/repo format\" },\n          refresh: { type: \"boolean\", description: \"Set true to regenerate the structure from GitHub (use when cache is stale)\" },\n        },\n        required: [\"repo_full_name\"],\n      },\n    },\n  ],\n\n  agents: [\n    {\n      agentKey: \"github-reviewer\",\n      displayName: \"GitHub Code Reviewer\",\n      role: \"code-review\",\n      title: \"Senior Code Reviewer\",\n    },\n  ],\n\n  skills: [\n    {\n      skillKey: \"github-codebase-access\",\n      displayName: \"GitHub Codebase Access\",\n      description: \"Provides agents with tools to read repository structure and files from GitHub without needing local filesystem access\",\n      markdown: `# GitHub Codebase Access\n\nYou have access to GitHub repositories through the GitHub Manager plugin tools. NEVER say you don't have access to the codebase.\n\n## Available Tools\n\n### 1. github_get_repo_structure\nGet the directory and file structure of a repository. **Always call this FIRST** before reading any files.\n\nParameters:\n- \\`repo_full_name\\` (required): Repository in \"owner/repo\" format\n- \\`refresh\\` (optional): Set to true to regenerate from GitHub if cache is stale\n\n### 2. github_read_file_content\nRead the content of a specific file from a GitHub repository.\n\nParameters:\n- \\`owner\\` (required): Repository owner (e.g. \"gauderp\")\n- \\`repo\\` (required): Repository name (e.g. \"gaud-erp-api\")\n- \\`path\\` (required): File path (e.g. \"src/main/java/com/gaud/App.java\")\n- \\`ref\\` (optional): Branch or commit SHA (defaults to main branch)\n\n### 3. github_get_pull_request_diff\nGet the unified diff of a pull request for code review.\n\nParameters:\n- \\`owner\\`, \\`repo\\`, \\`pull_number\\`\n\n### 4. github_search_issues\nSearch GitHub issues and PRs using GitHub search syntax.\n\nParameters:\n- \\`query\\`: GitHub search query (e.g. \"is:open label:bug\")\n\n### 5. github_list_repositories\nList all tracked GitHub repositories (no parameters needed).\n\n## Mandatory Workflow\n\n1. **ALWAYS** start with \\`github_get_repo_structure\\` to understand the codebase layout\n2. Read only the files you actually need with \\`github_read_file_content\\`\n3. If the structure seems outdated, call \\`github_get_repo_structure\\` with \\`refresh=true\\`\n4. Never try to access the local filesystem for source code \u2014 always use these tools\n\n## Token Efficiency\nThe structure cache returns directories and key files in a single call (~5-50KB).\nThis replaces hundreds of file-listing API calls, saving 60-90% of tokens.\n`,\n    },\n  ],\n\n  ui: {\n    slots: [\n      {\n        type: \"sidebar\",\n        id: \"github-sidebar\",\n        exportName: \"GitHubSidebarLink\",\n        displayName: \"GitHub\",\n      },\n      {\n        type: \"page\",\n        id: \"github-settings\",\n        exportName: \"GitHubSettingsPage\",\n        displayName: \"Configura\u00E7\u00F5es GitHub\",\n        routePath: \"github-settings\",\n      },\n      {\n        type: \"page\",\n        id: \"github-repos\",\n        exportName: \"GitHubReposPage\",\n        displayName: \"Reposit\u00F3rios\",\n        routePath: \"github-repos\",\n      },\n      {\n        type: \"page\",\n        id: \"github-prs\",\n        exportName: \"GitHubPullRequestsPage\",\n        displayName: \"Pull Requests\",\n        routePath: \"github-prs\",\n      },\n      {\n        type: \"page\",\n        id: \"github-graphs\",\n        exportName: \"GitHubGraphsPage\",\n        displayName: \"Knowledge Graphs\",\n        routePath: \"github-graphs\",\n      },\n      {\n        type: \"dashboardWidget\",\n        id: \"github-dashboard\",\n        exportName: \"GitHubDashboardWidget\",\n        displayName: \"GitHub Status\",\n      },\n      {\n        type: \"detailTab\",\n        id: \"github-detail\",\n        exportName: \"GitHubDetailTab\",\n        displayName: \"GitHub\",\n        entityTypes: [\"issue\"],\n      },\n      {\n        type: \"contextMenuItem\",\n        id: \"github-context-menu\",\n        exportName: \"GitHubContextMenu\",\n        displayName: \"GitHub Actions\",\n        entityTypes: [\"issue\"],\n      },\n    ],\n  },\n};\n\nexport default manifest;\n"],
+  "mappings": ";AAEA,IAAM,WAAsC;AAAA,EAC1C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY,CAAC,aAAa,YAAY;AAAA,EAEtC,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,sBAAsB;AAAA,IACpB,MAAM;AAAA,IACN,UAAU,CAAC,aAAa;AAAA,IACxB,YAAY;AAAA,MACV,aAAa;AAAA,QACX,MAAM;AAAA,QACN,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,YAAY;AAAA,QACV,MAAM;AAAA,QACN,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,qBAAqB;AAAA,QACnB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,aAAa;AAAA,QACb,SAAS;AAAA,QACT,SAAS;AAAA,QACT,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAAA,EAEA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,IAAI;AAAA,EACN;AAAA,EAEA,UAAU;AAAA,IACR,eAAe;AAAA,EACjB;AAAA,EAEA,MAAM;AAAA,IACJ;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,UAAU;AAAA,MACV,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EAEA,UAAU;AAAA,IACR;AAAA,MACE,aAAa;AAAA,MACb,aAAa;AAAA,MACb,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO,EAAE,MAAM,SAAS;AAAA,UACxB,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,aAAa,EAAE,MAAM,SAAS;AAAA,QAChC;AAAA,QACA,UAAU,CAAC,SAAS,QAAQ,aAAa;AAAA,MAC3C;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO,EAAE,MAAM,SAAS;AAAA,UACxB,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,KAAK,EAAE,MAAM,SAAS;AAAA,QACxB;AAAA,QACA,UAAU,CAAC,SAAS,QAAQ,MAAM;AAAA,MACpC;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO,EAAE,MAAM,SAAS;AAAA,UACxB,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,aAAa,EAAE,MAAM,SAAS;AAAA,UAC9B,WAAW,EAAE,MAAM,SAAS;AAAA,UAC5B,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,MAAM,EAAE,MAAM,SAAS;AAAA,QACzB;AAAA,QACA,UAAU,CAAC,SAAS,QAAQ,eAAe,aAAa,QAAQ,QAAQ,MAAM;AAAA,MAChF;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO,EAAE,MAAM,SAAS;AAAA,UACxB,MAAM,EAAE,MAAM,SAAS;AAAA,UACvB,aAAa,EAAE,MAAM,SAAS;AAAA,UAC9B,OAAO,EAAE,MAAM,UAAU,MAAM,CAAC,WAAW,mBAAmB,SAAS,EAAE;AAAA,UACzE,MAAM,EAAE,MAAM,SAAS;AAAA,QACzB;AAAA,QACA,UAAU,CAAC,SAAS,QAAQ,eAAe,SAAS,MAAM;AAAA,MAC5D;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB,EAAE,MAAM,UAAU,YAAY,CAAC,EAAE;AAAA,IACrD;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO,EAAE,MAAM,SAAS;AAAA,QAC1B;AAAA,QACA,UAAU,CAAC,OAAO;AAAA,MACpB;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,gBAAgB,EAAE,MAAM,UAAU,aAAa,oBAAoB;AAAA,UACnE,SAAS,EAAE,MAAM,WAAW,aAAa,6EAA6E;AAAA,QACxH;AAAA,QACA,UAAU,CAAC,gBAAgB;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,QAAQ;AAAA,IACN;AAAA,MACE,UAAU;AAAA,MACV,aAAa;AAAA,MACb,MAAM;AAAA,MACN,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,QAAQ;AAAA,IACN;AAAA,MACE,UAAU;AAAA,MACV,aAAa;AAAA,MACb,aAAa;AAAA,MACb,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAgDZ;AAAA,EACF;AAAA,EAEA,IAAI;AAAA,IACF,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,QACb,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,QACb,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,QACb,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,QACb,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,QACb,aAAa,CAAC,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,YAAY;AAAA,QACZ,aAAa;AAAA,QACb,aAAa,CAAC,OAAO;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,mBAAQ;",
   "names": []
 }

package/dist/worker.js

@@ -18,9 +18,11 @@ __export(queries_exports, {
   getLinksForPR: () => getLinksForPR,
   getPRByRepoAndNumber: () => getPRByRepoAndNumber,
   getRepoByFullName: () => getRepoByFullName,
+  getRepoGraph: () => getRepoGraph,
   linkPRToCard: () => linkPRToCard,
   listPRs: () => listPRs,
   listRepos: () => listRepos,
+  saveRepoGraph: () => saveRepoGraph,
   upsertIssue: () => upsertIssue,
   upsertPR: () => upsertPR,
   upsertRepo: () => upsertRepo
@@ -251,6 +253,23 @@ async function getLastSyncTime(db) {
   );
   return rows.length > 0 ? rows[0].finished_at : null;
 }
+async function saveRepoGraph(db, repoId, graphJson) {
+  await db.execute(
+    `UPDATE ${S}.gh_repositories SET graph_json=$1, graph_generated_at=$2 WHERE id=$3`,
+    [graphJson, (/* @__PURE__ */ new Date()).toISOString(), repoId]
+  );
+}
+async function getRepoGraph(db, fullName) {
+  const rows = await db.query(
+    `SELECT graph_json, graph_generated_at FROM ${S}.gh_repositories WHERE full_name = $1 AND graph_json IS NOT NULL`,
+    [fullName]
+  );
+  if (rows.length === 0) return null;
+  return {
+    graphJson: rows[0].graph_json,
+    generatedAt: rows[0].graph_generated_at
+  };
+}
 var S;
 var init_queries = __esm({
   "src/db/queries.ts"() {
@@ -9244,6 +9263,7 @@ function isRateLimitSafe(rateLimit, threshold = 100) {
 }
 
 // src/review/review-tools.ts
+init_queries();
 var MAX_DIFF_CHARS = 12e4;
 var MAX_FILE_CHARS = 128e3;
 function registerReviewTools(ctx) {
@@ -9442,6 +9462,62 @@ ${diff}`,
       return { content: items.map((i) => `#${i.number} ${i.title} [${i.state}]`).join("\n"), data: { items } };
     }
   );
+  ctx.tools.register(
+    "github_get_repo_structure",
+    {
+      displayName: "Get Repo Structure",
+      description: "Get the cached directory and file structure of a repository. Call this FIRST before reading files to understand codebase layout.",
+      parametersSchema: {
+        type: "object",
+        properties: {
+          repo_full_name: { type: "string", description: "Repository in owner/repo format" }
+        },
+        required: ["repo_full_name"]
+      }
+    },
+    async (params, runCtx) => {
+      const { repo_full_name, refresh } = params;
+      const companyId = runCtx.companyId;
+      if (refresh && companyId) {
+        const repo = await getRepoByFullName(ctx.db, repo_full_name);
+        if (repo) {
+          const { data: treeData } = await githubFetch(
+            ctx,
+            companyId,
+            `/repos/${repo_full_name}/git/trees/${repo.defaultBranch}?recursive=1`
+          );
+          const tree = treeData.tree;
+          const dirs = [];
+          const files = [];
+          for (const entry of tree) {
+            const p = entry.path;
+            if (entry.type === "tree" && p.split("/").length <= 3) dirs.push(p);
+            else if (entry.type === "blob" && (p.split("/").length <= 2 || /\.(ts|js|py|go|rs|java|json|ya?ml|toml|md)$/.test(p))) files.push(p);
+          }
+          const graph2 = { dirs, files, defaultBranch: repo.defaultBranch, language: repo.language };
+          await saveRepoGraph(ctx.db, repo.id, JSON.stringify(graph2));
+        }
+      }
+      const cached = await getRepoGraph(ctx.db, repo_full_name);
+      if (!cached) {
+        return { content: `No cached structure for ${repo_full_name}. Run a full sync first or call with refresh=true.` };
+      }
+      const graph = JSON.parse(cached.graphJson);
+      const summary = [
+        `Repository: ${repo_full_name}`,
+        `Language: ${graph.language ?? "unknown"}`,
+        `Default branch: ${graph.defaultBranch}`,
+        `Generated: ${cached.generatedAt}`,
+        ``,
+        `Directories (${graph.dirs.length}):`,
+        ...graph.dirs.map((d) => `  ${d}/`),
+        ``,
+        `Key files (${graph.files.length}):`,
+        ...graph.files.map((f) => `  ${f}`)
+      ].join("\n");
+      return { content: summary, data: graph };
+    }
+  );
 }
 
 // src/sync/webhook-handler.ts
@@ -9782,6 +9858,25 @@ async function runFullSync(ctx, companyId) {
         await upsertIssue(ctx.db, issue);
         issuesSynced++;
       }
+      try {
+        const { data: treeData } = await githubFetch(
+          ctx,
+          companyId,
+          `/repos/${repo.fullName}/git/trees/${repo.defaultBranch}?recursive=1`
+        );
+        const tree = treeData.tree;
+        const dirs = [];
+        const files = [];
+        for (const entry of tree) {
+          const p = entry.path;
+          if (entry.type === "tree" && p.split("/").length <= 3) dirs.push(p);
+          else if (entry.type === "blob" && (p.split("/").length <= 2 || /\.(ts|js|py|go|rs|java|json|ya?ml|toml|md)$/.test(p))) files.push(p);
+        }
+        const graph = { dirs, files, defaultBranch: repo.defaultBranch, language: repo.language };
+        await saveRepoGraph(ctx.db, repo.id, JSON.stringify(graph));
+      } catch (graphErr) {
+        ctx.logger.warn(`Graph generation failed for ${repo.fullName}: ${graphErr}`);
+      }
       reposSynced++;
     } catch (err) {
       errors.push(`${repo.fullName}: ${err instanceof Error ? err.message : String(err)}`);