@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/github-mcp.js

@@ -0,0 +1,235 @@
+/**
+ * GitHub MCP Integration Tools
+ *
+ * Phase 1, Task 1.1: Connect GitHub MCP Server to Dobby.
+ * Provides tools for code management, PR automation, and CI/CD monitoring
+ * through the official GitHub MCP Server (ghcr.io/github/github-mcp-server).
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const githubMcpTools = {
+    github_search_code: {
+        name: 'github_search_code',
+        annotations: {
+            title: 'GitHub Search Code',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Search for code across GitHub repositories using the GitHub MCP Server. Returns matching files and code snippets.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (e.g., "authentication middleware", "BigQuery parameterized query")',
+                },
+                repo: {
+                    type: 'string',
+                    description: 'Optional: Limit search to a specific repo (e.g., "gil-dobby/repo-dobby")',
+                },
+                language: {
+                    type: 'string',
+                    description: 'Optional: Filter by language (e.g., "typescript", "python")',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    github_get_file: {
+        name: 'github_get_file',
+        annotations: {
+            title: 'GitHub Get File',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Read a file from a GitHub repository. Returns file content.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo" (e.g., "gil-dobby/repo-dobby")',
+                },
+                path: {
+                    type: 'string',
+                    description: 'File path within the repo (e.g., "web/shared/lib/gateway/auth.ts")',
+                },
+                branch: {
+                    type: 'string',
+                    description: 'Optional: Branch name (default: main)',
+                },
+            },
+            required: ['repo', 'path'],
+        },
+    },
+    github_create_pr: {
+        name: 'github_create_pr',
+        annotations: {
+            title: 'GitHub Create PR',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Create a Pull Request on GitHub. Requires an existing branch with commits.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                title: {
+                    type: 'string',
+                    description: 'PR title',
+                },
+                body: {
+                    type: 'string',
+                    description: 'PR description in markdown',
+                },
+                head: {
+                    type: 'string',
+                    description: 'Source branch name',
+                },
+                base: {
+                    type: 'string',
+                    description: 'Target branch (default: main)',
+                },
+            },
+            required: ['repo', 'title', 'head'],
+        },
+    },
+    github_list_prs: {
+        name: 'github_list_prs',
+        annotations: {
+            title: 'GitHub List PRs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List Pull Requests for a repository with optional filters.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                state: {
+                    type: 'string',
+                    enum: ['open', 'closed', 'all'],
+                    description: 'Filter by PR state (default: open)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of PRs to return (default: 10)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+    github_list_issues: {
+        name: 'github_list_issues',
+        annotations: {
+            title: 'GitHub List Issues',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List issues for a repository with optional filters.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                state: {
+                    type: 'string',
+                    enum: ['open', 'closed', 'all'],
+                    description: 'Filter by issue state (default: open)',
+                },
+                labels: {
+                    type: 'string',
+                    description: 'Comma-separated label names to filter by',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of issues to return (default: 10)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+    github_create_issue: {
+        name: 'github_create_issue',
+        annotations: {
+            title: 'GitHub Create Issue',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Create a new issue on a GitHub repository.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Issue title',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Issue body in markdown',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Labels to add',
+                },
+            },
+            required: ['repo', 'title'],
+        },
+    },
+    github_get_workflow_runs: {
+        name: 'github_get_workflow_runs',
+        annotations: {
+            title: 'GitHub Workflow Runs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List recent GitHub Actions workflow runs for CI/CD monitoring.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['completed', 'in_progress', 'queued', 'failure', 'success'],
+                    description: 'Filter by run status',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of runs to return (default: 5)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+};
+// ============================================
+// GitHub API Helper
+// ============================================
+// ============================================
+// Tool Handlers
+// ============================================
+//# sourceMappingURL=github-mcp.js.map

package/dist/tools/github-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-mcp.js","sourceRoot":"","sources":["../../src/tools/github-mcp.ts"],"names":[],"mappings":"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"}

package/dist/tools/governance.d.ts

@@ -0,0 +1,273 @@
+/**
+ * Governance MCP Tools
+ *
+ * Policy-as-Code operations via MCP for Claude Desktop/Cursor/VS Code users.
+ * 6 tools:
+ *   1. export_policies       — Export org governance policies as YAML/JSON
+ *   2. import_policies       — Import policies from YAML/JSON
+ *   3. validate_policies     — Dry-run validate a policy document
+ *   4. apply_guardrail       — Apply a guardrail template to an org
+ *   5. create_policy         — Create a rule-based/keyword policy at Org/Tenant/Process layer
+ *   6. list_policies         — List policies visible to a tenant
+ *
+ * create_policy/list_policies definitions are kept byte-identical to
+ * @dobbyai/capability-core's governanceCapabilities entries of the same id
+ * (description/inputSchema/annotations) — see
+ * packages/capability-core/src/capabilities/governance.ts. Do not edit one
+ * without the other.
+ */
+export declare const governanceTools: {
+    export_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                format: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    import_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    validate_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    apply_guardrail: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                template: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    create_policy: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+                layer: {
+                    type: string;
+                    enum: number[];
+                    description: string;
+                };
+                scope_id: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                severity: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                is_active: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    list_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    update_policy: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+                policy_id: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                severity: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                is_active: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    delete_policy: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+                policy_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    test_policy: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+                sample_text: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+//# sourceMappingURL=governance.d.ts.map

package/dist/tools/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/tools/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2R3B,CAAC"}