@commandable/integration-data 0.0.5 → 0.0.7

package/integrations/github/handlers/edit_file.js

@@ -0,0 +1,52 @@
+async (input) => {
+  const { owner, repo, branch, path, edits, message } = input
+
+  const params = new URLSearchParams()
+  params.set('ref', branch)
+  const fileRes = await integration.fetch(`/repos/${owner}/${repo}/contents/${path}?${params.toString()}`)
+  const fileData = await fileRes.json()
+
+  if (!fileData || !fileData.content || !fileData.sha) {
+    throw new Error(`File not found: ${path}. Use get_repo_tree to discover file paths.`)
+  }
+
+  const b64 = fileData.content.replace(/\n/g, '')
+  let content = decodeURIComponent(
+    atob(b64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')
+  )
+
+  for (let i = 0; i < edits.length; i++) {
+    const { old_text, new_text } = edits[i]
+    const idx = content.indexOf(old_text)
+    if (idx === -1) {
+      throw new Error(
+        `Edit ${i + 1}/${edits.length} failed: old_text not found in ${path}. `
+        + 'Ensure the search text matches the file exactly, including whitespace and indentation. '
+        + 'Use get_file_contents to verify the current content.'
+      )
+    }
+    content = content.substring(0, idx) + new_text + content.substring(idx + old_text.length)
+  }
+
+  const contentBase64 = btoa(unescape(encodeURIComponent(content)))
+
+  const res = await integration.fetch(`/repos/${owner}/${repo}/contents/${path}`, {
+    method: 'PUT',
+    body: {
+      message: message,
+      content: contentBase64,
+      sha: fileData.sha,
+      branch: branch,
+    },
+  })
+  const result = await res.json()
+
+  return {
+    commit: {
+      sha: result.commit?.sha,
+      message: result.commit?.message,
+      url: result.commit?.html_url,
+    },
+    file: { path: path },
+  }
+}

package/integrations/github/handlers/edit_files.js

@@ -0,0 +1,107 @@
+async (input) => {
+  const { owner, repo, branch, message, files } = input
+
+  // Helper: decode base64 GitHub content to UTF-8
+  function decodeContent(b64Raw) {
+    const b64 = b64Raw.replace(/\n/g, '')
+    return decodeURIComponent(
+      atob(b64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')
+    )
+  }
+
+  // Helper: apply search/replace edits to text
+  function applyEdits(text, edits, filePath) {
+    let result = text
+    for (let i = 0; i < edits.length; i++) {
+      const { old_text, new_text } = edits[i]
+      const idx = result.indexOf(old_text)
+      if (idx === -1) {
+        throw new Error(
+          `Edit ${i + 1}/${edits.length} failed on ${filePath}: old_text not found. `
+          + 'Ensure the search text matches exactly, including whitespace and indentation. '
+          + 'Use get_file_contents to verify the current content.'
+        )
+      }
+      result = result.substring(0, idx) + new_text + result.substring(idx + old_text.length)
+    }
+    return result
+  }
+
+  // 1. Get the current commit SHA for the branch
+  const refRes = await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`)
+  const refData = await refRes.json()
+  const currentCommitSha = refData.object.sha
+
+  // 2. Get the current commit to find its tree
+  const commitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits/${currentCommitSha}`)
+  const commitData = await commitRes.json()
+  const currentTreeSha = commitData.tree.sha
+
+  // 3. Resolve final content for each file
+  const tree = []
+  for (const file of files) {
+    if (file.action === 'delete') {
+      tree.push({ path: file.path, mode: '100644', type: 'blob', sha: null })
+      continue
+    }
+
+    let finalContent
+    if (file.action === 'edit') {
+      if (!file.edits || file.edits.length === 0) {
+        throw new Error(`File ${file.path} has action 'edit' but no edits provided.`)
+      }
+      const params = new URLSearchParams()
+      params.set('ref', branch)
+      const fileRes = await integration.fetch(`/repos/${owner}/${repo}/contents/${file.path}?${params.toString()}`)
+      const fileData = await fileRes.json()
+      if (!fileData || !fileData.content) {
+        throw new Error(`File not found: ${file.path}. Use get_repo_tree to discover file paths.`)
+      }
+      const currentContent = decodeContent(fileData.content)
+      finalContent = applyEdits(currentContent, file.edits, file.path)
+    } else {
+      // action === 'create'
+      if (file.content === undefined || file.content === null) {
+        throw new Error(`File ${file.path} has action 'create' but no content provided.`)
+      }
+      finalContent = file.content
+    }
+
+    // Create blob
+    const blobRes = await integration.fetch(`/repos/${owner}/${repo}/git/blobs`, {
+      method: 'POST',
+      body: { content: finalContent, encoding: 'utf-8' },
+    })
+    const blobData = await blobRes.json()
+    tree.push({ path: file.path, mode: '100644', type: 'blob', sha: blobData.sha })
+  }
+
+  // 4. Create a new tree
+  const treeRes = await integration.fetch(`/repos/${owner}/${repo}/git/trees`, {
+    method: 'POST',
+    body: { base_tree: currentTreeSha, tree: tree },
+  })
+  const treeData = await treeRes.json()
+
+  // 5. Create the commit
+  const newCommitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits`, {
+    method: 'POST',
+    body: { message: message, tree: treeData.sha, parents: [currentCommitSha] },
+  })
+  const newCommitData = await newCommitRes.json()
+
+  // 6. Update the branch reference
+  await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`, {
+    method: 'PATCH',
+    body: { sha: newCommitData.sha },
+  })
+
+  return {
+    commit: {
+      sha: newCommitData.sha,
+      message: newCommitData.message,
+      url: newCommitData.html_url,
+    },
+    files: files.map(f => ({ path: f.path, action: f.action })),
+  }
+}

package/integrations/github/handlers/fork_repo.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const body = {}
+  if (input.organization) body.organization = input.organization
+  if (input.name) body.name = input.name
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/forks`,
+    { method: 'POST', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/get_commit.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/commits/${input.sha}${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/get_file_contents.js

@@ -0,0 +1,21 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.ref) params.set('ref', input.ref)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/contents/${input.path}${query}`)
+  const data = await res.json()
+  if (data && data.content && data.encoding === 'base64') {
+    try {
+      const b64 = data.content.replace(/\n/g, '')
+      // Decode base64 → binary string → percent-encode each byte → UTF-8 decode
+      data.content = decodeURIComponent(
+        atob(b64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')
+      )
+      data.encoding = 'utf-8'
+    }
+    catch (e) {
+      // Binary file — leave content as base64
+    }
+  }
+  return data
+}

package/integrations/github/handlers/get_job_logs.js

@@ -0,0 +1,6 @@
+async (input) => {
+  // GitHub returns a redirect to the actual log blob URL; fetch follows it automatically
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/actions/jobs/${input.job_id}/logs`)
+  const logs = await res.text()
+  return { logs }
+}

package/integrations/github/handlers/get_latest_release.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/releases/latest`)
+  return await res.json()
+}

package/integrations/github/handlers/get_me.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch('/user')
+  return await res.json()
+}

package/integrations/github/handlers/get_pull_request.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}`)
+  return await res.json()
+}

package/integrations/github/handlers/get_pull_request_diff.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}`,
+    { headers: { 'Accept': 'application/vnd.github.diff' } }
+  )
+  const diff = await res.text()
+  return { diff }
+}

package/integrations/github/handlers/get_repo_tree.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const ref = input.ref || 'HEAD'
+  const params = new URLSearchParams()
+  if (input.recursive !== false) params.set('recursive', '1')
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/trees/${ref}${query}`)
+  const data = await res.json()
+  if (input.path_filter && Array.isArray(data.tree)) {
+    data.tree = data.tree.filter((item) => item.path && item.path.startsWith(input.path_filter))
+  }
+  return data
+}

package/integrations/github/handlers/get_workflow_run.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/actions/runs/${input.run_id}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_branches.js

@@ -1,4 +1,9 @@
 async (input) => {
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/branches`)
+  const params = new URLSearchParams()
+  if (input.protected !== undefined) params.set('protected', String(input.protected))
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/branches${query}`)
   return await res.json()
 }

package/integrations/github/handlers/list_commits.js

@@ -1,11 +1,10 @@
 async (input) => {
   const params = new URLSearchParams()
-  if (input.sha)
-    params.set('sha', input.sha)
-  if (typeof input.path === 'string' && input.path.length > 0)
-    params.set('path', input.path)
-  if (input.author)
-    params.set('author', input.author)
+  if (input.sha) params.set('sha', input.sha)
+  if (typeof input.path === 'string' && input.path.length > 0) params.set('path', input.path)
+  if (input.author) params.set('author', input.author)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
   const query = params.toString() ? `?${params.toString()}` : ''
   const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/commits${query}`)
   return await res.json()

package/integrations/github/handlers/list_issue_comments.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}/comments${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_issues.js

@@ -1,11 +1,10 @@
 async (input) => {
   const params = new URLSearchParams()
-  if (input.state)
-    params.set('state', input.state)
-  if (input.labels)
-    params.set('labels', input.labels)
-  if (input.assignee)
-    params.set('assignee', input.assignee)
+  if (input.state) params.set('state', input.state)
+  if (input.labels) params.set('labels', input.labels)
+  if (input.assignee) params.set('assignee', input.assignee)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
   const query = params.toString() ? `?${params.toString()}` : ''
   const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues${query}`)
   return await res.json()

package/integrations/github/handlers/list_labels.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/labels${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_request_comments.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/comments${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_request_files.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/files${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_requests.js

@@ -1,7 +1,12 @@
 async (input) => {
   const params = new URLSearchParams()
-  if (input.state)
-    params.set('state', input.state)
+  if (input.state) params.set('state', input.state)
+  if (input.head) params.set('head', input.head)
+  if (input.base) params.set('base', input.base)
+  if (input.sort) params.set('sort', input.sort)
+  if (input.direction) params.set('direction', input.direction)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
   const query = params.toString() ? `?${params.toString()}` : ''
   const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls${query}`)
   return await res.json()

package/integrations/github/handlers/list_releases.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/releases${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_tags.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/tags${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_workflow_runs.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.branch) params.set('branch', input.branch)
+  if (input.status) params.set('status', input.status)
+  if (input.event) params.set('event', input.event)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/actions/runs${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/request_pull_request_reviewers.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const body = {}
+  if (input.reviewers) body.reviewers = input.reviewers
+  if (input.team_reviewers) body.team_reviewers = input.team_reviewers
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/requested_reviewers`,
+    { method: 'POST', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/search_code.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/code?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/search_issues.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/issues?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/search_pull_requests.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/issues?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/search_repos.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.sort) params.set('sort', input.sort)
+  if (input.order) params.set('order', input.order)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/repositories?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/update_pull_request.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const body = {}
+  if (input.title !== undefined) body.title = input.title
+  if (input.body !== undefined) body.body = input.body
+  if (input.state !== undefined) body.state = input.state
+  if (input.base !== undefined) body.base = input.base
+  if (input.draft !== undefined) body.draft = input.draft
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}`,
+    { method: 'PATCH', body }
+  )
+  return await res.json()
+}

package/integrations/github/manifest.json

@@ -1,26 +1,91 @@
 {
   "name": "github",
-  "version": "0.1.0",
+  "version": "0.3.0",
+  "toolsets": {
+    "code": {
+      "label": "Code & Files",
+      "description": "Read, search, and manage repository code and branches"
+    },
+    "issues": {
+      "label": "Issues",
+      "description": "Create, search, and manage GitHub issues"
+    },
+    "pull_requests": {
+      "label": "Pull Requests",
+      "description": "Create, review, and merge pull requests"
+    },
+    "ci": {
+      "label": "CI / Actions",
+      "description": "Monitor GitHub Actions workflows and debug failures"
+    },
+    "releases": {
+      "label": "Releases & Tags",
+      "description": "Manage releases and view tags"
+    },
+    "repo_admin": {
+      "label": "Repository Management",
+      "description": "Create, delete, fork, and discover repositories"
+    }
+  },
   "tools": [
-    { "name": "list_repos", "description": "List repositories for the authenticated user.", "inputSchema": "schemas/empty.json", "handler": "handlers/list_repos_user.js", "scope": "read" },
-    { "name": "get_repo", "description": "Get a repository by owner and name.", "inputSchema": "schemas/get_repo.json", "handler": "handlers/get_repo.js", "scope": "read" },
-    { "name": "list_issues", "description": "List issues for a repository.", "inputSchema": "schemas/list_issues.json", "handler": "handlers/list_issues.js", "scope": "read" },
-    { "name": "get_issue", "description": "Get a specific issue by number.", "inputSchema": "schemas/get_issue.json", "handler": "handlers/get_issue.js", "scope": "read" },
-    { "name": "list_pull_requests", "description": "List pull requests for a repository.", "inputSchema": "schemas/list_pull_requests.json", "handler": "handlers/list_pull_requests.js", "scope": "read" },
-    { "name": "list_branches", "description": "List branches for a repository.", "inputSchema": "schemas/owner_repo.json", "handler": "handlers/list_branches.js", "scope": "read" },
-    { "name": "list_commits", "description": "List commits for a repository.", "inputSchema": "schemas/list_commits.json", "handler": "handlers/list_commits.js", "scope": "read" },
-
-    { "name": "create_repo", "description": "Create a new repository.", "inputSchema": "schemas/create_repo.json", "handler": "handlers/create_repo.js", "scope": "write", "credentialVariants": ["classic_pat"] },
-    { "name": "delete_repo", "description": "Delete a repository (requires delete_repo scope).", "inputSchema": "schemas/delete_repo.json", "handler": "handlers/delete_repo.js", "scope": "write", "credentialVariants": ["classic_pat"] },
-    { "name": "create_branch", "description": "Create a new branch in a repository.", "inputSchema": "schemas/create_branch.json", "handler": "handlers/create_branch.js", "scope": "write" },
-    { "name": "create_or_update_file", "description": "Create or update a single file (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_or_update_file.json", "handler": "handlers/create_or_update_file.js", "scope": "write" },
-    { "name": "create_commit", "description": "Create a commit with multiple files (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_commit.json", "handler": "handlers/create_commit.js", "scope": "write" },
-    { "name": "create_pull_request", "description": "Create a pull request.", "inputSchema": "schemas/create_pull_request.json", "handler": "handlers/create_pull_request.js", "scope": "write" },
-    { "name": "merge_pull_request", "description": "Merge a pull request.", "inputSchema": "schemas/merge_pull_request.json", "handler": "handlers/merge_pull_request.js", "scope": "write" },
-    { "name": "create_issue", "description": "Create an issue in a repository.", "inputSchema": "schemas/create_issue.json", "handler": "handlers/create_issue.js", "scope": "write" },
-    { "name": "update_issue", "description": "Update fields on an issue.", "inputSchema": "schemas/update_issue.json", "handler": "handlers/update_issue.js", "scope": "write" },
-    { "name": "comment_on_issue", "description": "Add a comment to an issue.", "inputSchema": "schemas/comment_on_issue.json", "handler": "handlers/comment_on_issue.js", "scope": "write" },
-    { "name": "add_labels_to_issue", "description": "Add labels to an issue or pull request.", "inputSchema": "schemas/add_labels_to_issue.json", "handler": "handlers/add_labels_to_issue.js", "scope": "write" },
-    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write" }
+    { "name": "get_me", "description": "Get the authenticated user's profile. Use this to find out who you are authenticated as before performing operations.", "inputSchema": "schemas/empty.json", "handler": "handlers/get_me.js", "scope": "read", "toolset": "repo_admin" },
+    { "name": "list_repos", "description": "List repositories for the authenticated user.", "inputSchema": "schemas/empty.json", "handler": "handlers/list_repos_user.js", "scope": "read", "toolset": "repo_admin" },
+    { "name": "get_repo", "description": "Get details for a repository (description, default branch, visibility, topics, stats).", "inputSchema": "schemas/get_repo.json", "handler": "handlers/get_repo.js", "scope": "read", "toolset": "code" },
+    { "name": "search_repos", "description": "Search GitHub repositories. Supports stars, forks, language, topic, and user filters (e.g. 'topic:react stars:>1000 language:javascript'). Use this to discover repos.", "inputSchema": "schemas/search_repos.json", "handler": "handlers/search_repos.js", "scope": "read", "toolset": "repo_admin" },
+
+    { "name": "get_file_contents", "description": "Get the content of a file from a repository. Returns decoded UTF-8 text. Use ref to read from a specific branch, tag, or commit. Call get_repo_tree first to discover file paths.", "inputSchema": "schemas/get_file_contents.json", "handler": "handlers/get_file_contents.js", "scope": "read", "toolset": "code" },
+    { "name": "get_repo_tree", "description": "Get the full file/directory tree of a repository. Returns all paths and types. Use path_filter to scope to a subdirectory (e.g. 'src/'). Use this before get_file_contents to discover what files exist.", "inputSchema": "schemas/get_repo_tree.json", "handler": "handlers/get_repo_tree.js", "scope": "read", "toolset": "code" },
+    { "name": "search_code", "description": "Search for code across GitHub repositories using GitHub's code search syntax. Examples: 'useState language:typescript repo:facebook/react', 'console.error path:src/'. Returns file paths and matched fragments.", "inputSchema": "schemas/search_code.json", "handler": "handlers/search_code.js", "scope": "read", "toolset": "code" },
+
+    { "name": "list_branches", "description": "List branches in a repository. Supports pagination and filtering by protection status.", "inputSchema": "schemas/list_branches.json", "handler": "handlers/list_branches.js", "scope": "read", "toolset": "code" },
+    { "name": "list_commits", "description": "List commits for a repository. Filter by branch/tag (sha), file path, or author. Paginate with page/per_page.", "inputSchema": "schemas/list_commits.json", "handler": "handlers/list_commits.js", "scope": "read", "toolset": "code" },
+    { "name": "get_commit", "description": "Get the full details of a specific commit including its message, author, file changes, and diff stats.", "inputSchema": "schemas/get_commit.json", "handler": "handlers/get_commit.js", "scope": "read", "toolset": "code" },
+    { "name": "list_tags", "description": "List tags for a repository. Use this to see available versions before creating a release.", "inputSchema": "schemas/list_tags.json", "handler": "handlers/list_tags.js", "scope": "read", "toolset": "code" },
+
+    { "name": "list_issues", "description": "List issues for a repository. Filter by state (open/closed/all), labels (comma-separated), and assignee. Paginate with page/per_page. Note: this also returns pull requests; use search_issues to exclude them.", "inputSchema": "schemas/list_issues.json", "handler": "handlers/list_issues.js", "scope": "read", "toolset": "issues" },
+    { "name": "get_issue", "description": "Get full details of a specific issue including its body, labels, assignees, and milestone.", "inputSchema": "schemas/get_issue.json", "handler": "handlers/get_issue.js", "scope": "read", "toolset": "issues" },
+    { "name": "list_issue_comments", "description": "List all comments on an issue. Use this to read the full discussion thread before replying.", "inputSchema": "schemas/list_issue_comments.json", "handler": "handlers/list_issue_comments.js", "scope": "read", "toolset": "issues" },
+    { "name": "search_issues", "description": "Search issues using GitHub search syntax (e.g. 'is:open is:issue label:bug repo:owner/repo', 'is:issue no:assignee milestone:v2.0'). More powerful than list_issues for finding specific issues.", "inputSchema": "schemas/search_issues.json", "handler": "handlers/search_issues.js", "scope": "read", "toolset": "issues" },
+    { "name": "list_labels", "description": "List all labels available in a repository. Call this before add_labels_to_issue to see which labels exist.", "inputSchema": "schemas/list_labels.json", "handler": "handlers/list_labels.js", "scope": "read", "toolset": "issues" },
+
+    { "name": "list_pull_requests", "description": "List pull requests for a repository. Filter by state, head branch, base branch. Sort and paginate results.", "inputSchema": "schemas/list_pull_requests.json", "handler": "handlers/list_pull_requests.js", "scope": "read", "toolset": "pull_requests" },
+    { "name": "get_pull_request", "description": "Get full details of a specific pull request including title, body, state, merge status, head/base refs, reviewers, and labels.", "inputSchema": "schemas/get_pull_request.json", "handler": "handlers/get_pull_request.js", "scope": "read", "toolset": "pull_requests" },
+    { "name": "get_pull_request_diff", "description": "Get the raw unified diff for a pull request. Returns the complete diff of all changes. For per-file details, use list_pull_request_files instead.", "inputSchema": "schemas/get_pull_request_diff.json", "handler": "handlers/get_pull_request_diff.js", "scope": "read", "toolset": "pull_requests" },
+    { "name": "list_pull_request_files", "description": "List the files changed in a pull request with their status (added/modified/deleted) and patch diff per file. Essential for code review.", "inputSchema": "schemas/list_pull_request_files.json", "handler": "handlers/list_pull_request_files.js", "scope": "read", "toolset": "pull_requests" },
+    { "name": "list_pull_request_comments", "description": "List inline review comments on a pull request (comments attached to specific lines of code).", "inputSchema": "schemas/list_pull_request_comments.json", "handler": "handlers/list_pull_request_comments.js", "scope": "read", "toolset": "pull_requests" },
+    { "name": "search_pull_requests", "description": "Search pull requests using GitHub search syntax. Use 'is:pr' to scope to PRs (e.g. 'is:pr is:open author:octocat', 'is:pr review:required label:bug'). Returns matching PRs across repos.", "inputSchema": "schemas/search_pull_requests.json", "handler": "handlers/search_pull_requests.js", "scope": "read", "toolset": "pull_requests" },
+
+    { "name": "list_releases", "description": "List all releases for a repository, newest first.", "inputSchema": "schemas/list_releases.json", "handler": "handlers/list_releases.js", "scope": "read", "toolset": "releases" },
+    { "name": "get_latest_release", "description": "Get the latest published release for a repository. Use this to quickly check the current version.", "inputSchema": "schemas/owner_repo.json", "handler": "handlers/get_latest_release.js", "scope": "read", "toolset": "releases" },
+
+    { "name": "list_workflow_runs", "description": "List GitHub Actions workflow runs for a repository. Filter by branch, status (e.g. 'failure', 'success'), or triggering event. Use this to check CI status.", "inputSchema": "schemas/list_workflow_runs.json", "handler": "handlers/list_workflow_runs.js", "scope": "read", "toolset": "ci" },
+    { "name": "get_workflow_run", "description": "Get details of a specific GitHub Actions workflow run including its status, conclusion, timing, and associated commit.", "inputSchema": "schemas/get_workflow_run.json", "handler": "handlers/get_workflow_run.js", "scope": "read", "toolset": "ci" },
+    { "name": "get_job_logs", "description": "Get the log output for a specific GitHub Actions workflow job. Use this to diagnose CI failures. Get job_id from the GitHub Actions UI or the jobs list of a workflow run.", "inputSchema": "schemas/get_job_logs.json", "handler": "handlers/get_job_logs.js", "scope": "read", "toolset": "ci" },
+
+    { "name": "create_repo", "description": "Create a new GitHub repository under the authenticated user's account.", "inputSchema": "schemas/create_repo.json", "handler": "handlers/create_repo.js", "scope": "write", "credentialVariants": ["classic_pat"], "toolset": "repo_admin" },
+    { "name": "delete_repo", "description": "Permanently delete a repository. This is irreversible. Requires the delete_repo scope on classic PATs.", "inputSchema": "schemas/delete_repo.json", "handler": "handlers/delete_repo.js", "scope": "write", "credentialVariants": ["classic_pat"], "toolset": "repo_admin" },
+    { "name": "fork_repo", "description": "Fork a repository into your account or an organization. The fork is created asynchronously; the response returns immediately with the new repo details.", "inputSchema": "schemas/fork_repo.json", "handler": "handlers/fork_repo.js", "scope": "write", "toolset": "repo_admin" },
+
+    { "name": "create_branch", "description": "Create a new branch in a repository, branching from the repo's default branch by default.", "inputSchema": "schemas/create_branch.json", "handler": "handlers/create_branch.js", "scope": "write", "toolset": "code" },
+    { "name": "delete_branch", "description": "Delete a branch. Typically used after a pull request is merged. Use list_branches to find the branch name first.", "inputSchema": "schemas/delete_branch.json", "handler": "handlers/delete_branch.js", "scope": "write", "toolset": "code" },
+
+    { "name": "edit_file", "description": "Edit a file using search/replace. Fetches the file, applies edits, and commits the result. Each old_text must match the file content exactly, including whitespace and indentation. Use get_file_contents to verify content before editing. For multi-file atomic changes, use edit_files instead.", "inputSchema": "schemas/edit_file.json", "handler": "handlers/edit_file.js", "scope": "write", "toolset": "code" },
+    { "name": "edit_files", "description": "Create, edit, and delete multiple files in a single atomic commit. Use action 'create' with content for new files, 'edit' with old_text/new_text search/replace pairs for existing files, 'delete' to remove files. All changes are committed together. For single-file edits, use edit_file instead.", "inputSchema": "schemas/edit_files.json", "handler": "handlers/edit_files.js", "scope": "write", "toolset": "code" },
+    { "name": "create_file", "description": "Create a new file or overwrite an existing file's content in a single commit. Handles SHA resolution internally -- no need to fetch the file first. For partial edits to existing files, use edit_file instead.", "inputSchema": "schemas/create_file.json", "handler": "handlers/create_file.js", "scope": "write", "toolset": "code" },
+    { "name": "delete_file", "description": "Delete a file from a repository. The file's SHA is fetched automatically. Creates a commit with the deletion.", "inputSchema": "schemas/delete_file.json", "handler": "handlers/delete_file.js", "scope": "write", "toolset": "code" },
+
+    { "name": "create_pull_request", "description": "Open a new pull request from a head branch into a base branch.", "inputSchema": "schemas/create_pull_request.json", "handler": "handlers/create_pull_request.js", "scope": "write", "toolset": "pull_requests" },
+    { "name": "update_pull_request", "description": "Edit a pull request's title, body, state (open/closed), base branch, or draft status.", "inputSchema": "schemas/update_pull_request.json", "handler": "handlers/update_pull_request.js", "scope": "write", "toolset": "pull_requests" },
+    { "name": "merge_pull_request", "description": "Merge a pull request. Supports merge, squash, and rebase merge methods.", "inputSchema": "schemas/merge_pull_request.json", "handler": "handlers/merge_pull_request.js", "scope": "write", "toolset": "pull_requests" },
+    { "name": "request_pull_request_reviewers", "description": "Request specific users or teams to review a pull request.", "inputSchema": "schemas/request_pull_request_reviewers.json", "handler": "handlers/request_pull_request_reviewers.js", "scope": "write", "toolset": "pull_requests" },
+    { "name": "create_pull_request_review", "description": "Submit a pull request review. Use event=APPROVE to approve, REQUEST_CHANGES to request changes, or COMMENT to leave a comment-only review.", "inputSchema": "schemas/create_pull_request_review.json", "handler": "handlers/create_pull_request_review.js", "scope": "write", "toolset": "pull_requests" },
+
+    { "name": "create_issue", "description": "Create a new issue in a repository. Optionally assign users and add labels.", "inputSchema": "schemas/create_issue.json", "handler": "handlers/create_issue.js", "scope": "write", "toolset": "issues" },
+    { "name": "update_issue", "description": "Update fields on an existing issue (title, body, state, assignees, labels, milestone).", "inputSchema": "schemas/update_issue.json", "handler": "handlers/update_issue.js", "scope": "write", "toolset": "issues" },
+    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write", "toolset": "issues" },
+    { "name": "comment_on_issue", "description": "Add a comment to an issue or pull request (GitHub PRs share the issue comment thread). Use list_issue_comments to read existing comments first.", "inputSchema": "schemas/comment_on_issue.json", "handler": "handlers/comment_on_issue.js", "scope": "write", "toolset": "issues" },
+    { "name": "add_labels_to_issue", "description": "Add labels to an issue or pull request. Use list_labels to discover available labels before calling this.", "inputSchema": "schemas/add_labels_to_issue.json", "handler": "handlers/add_labels_to_issue.js", "scope": "write", "toolset": "issues" },
+
+    { "name": "create_release", "description": "Create a new release from a tag. Can auto-generate release notes from commits. Set draft=true to save without publishing, prerelease=true for alpha/beta/rc versions.", "inputSchema": "schemas/create_release.json", "handler": "handlers/create_release.js", "scope": "write", "toolset": "releases" }
   ]
 }