@skyramp/mcp 0.0.62 → 0.0.63-rc.2

package/build/tools/initTestbotTool.js

@@ -1,187 +0,0 @@
-import { z } from "zod";
-import { simpleGit } from "simple-git";
-import * as fs from "fs/promises";
-import * as path from "path";
-import { logger } from "../utils/logger.js";
-import { AnalyticsService } from "../services/AnalyticsService.js";
-const TOOL_NAME = "skyramp_init_testbot";
-const WORKFLOW_FILENAME = "skyramp-test-bot.yml";
-function generateWorkflow(targetBranches, agentType) {
-    const apiKeyLine = agentType === "copilot"
-        ? "          copilot_api_key: ${{ secrets.COPILOT_API_KEY }}"
-        : "          cursor_api_key: ${{ secrets.CURSOR_API_KEY }}";
-    const branchesBlock = targetBranches && targetBranches.length > 0
-        ? `\n    branches:\n${targetBranches.map((b) => `      - '${b}'`).join("\n")}`
-        : "";
-    return `name: Skyramp Test Automation
-on:
-  pull_request:${branchesBlock}
-
-jobs:
-  test-maintenance:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Run Skyramp Test Bot
-        uses: skyramp/test-bot@v1
-        with:
-          skyramp_license_file: \${{ secrets.SKYRAMP_LICENSE }}
-${apiKeyLine}
-`;
-}
-export function registerInitTestbotTool(server) {
-    server.registerTool(TOOL_NAME, {
-        description: `Initialize Skyramp Test Bot for a GitHub repository
-
-Sets up a GitHub Actions workflow that automatically generates and maintains tests on pull requests using Skyramp Test Bot. This tool validates the repository, creates the workflow file, and provides setup instructions for required secrets.`,
-        inputSchema: {
-            repository_path: z
-                .string()
-                .describe("Absolute path to the user's GitHub repository"),
-            agent_type: z
-                .enum(["cursor", "copilot"])
-                .default("cursor")
-                .describe("Which AI agent the user uses (cursor or copilot). Defaults to cursor."),
-            target_branches: z
-                .array(z.string())
-                .optional()
-                .describe("Branches to trigger the test bot on pull requests. If not specified, the workflow triggers on all pull requests."),
-        },
-        _meta: {
-            keywords: [
-                "init",
-                "testbot",
-                "test-bot",
-                "github actions",
-                "workflow",
-                "setup",
-                "ci",
-            ],
-        },
-    }, async (params) => {
-        let errorResult;
-        const repoPath = params.repository_path;
-        const agentType = params.agent_type;
-        const targetBranches = params.target_branches;
-        logger.info("Initializing Skyramp Test Bot", {
-            repository_path: repoPath,
-            agent_type: agentType,
-            target_branches: targetBranches,
-        });
-        try {
-            // Validate it's a git repo
-            const git = simpleGit(repoPath);
-            const isRepo = await git.checkIsRepo();
-            if (!isRepo) {
-                errorResult = {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error: "${repoPath}" is not a Git repository. Please run this tool from a valid Git repository.`,
-                        },
-                    ],
-                    isError: true,
-                };
-                return errorResult;
-            }
-            // Validate it has a GitHub remote
-            const remotes = await git.getRemotes(true);
-            const hasGitHubRemote = remotes.some((remote) => remote.refs.fetch?.includes("github.com") ||
-                remote.refs.push?.includes("github.com"));
-            if (!hasGitHubRemote) {
-                errorResult = {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error: No GitHub remote found in "${repoPath}". Skyramp Test Bot requires a GitHub repository. Please add a GitHub remote and try again.`,
-                        },
-                    ],
-                    isError: true,
-                };
-                return errorResult;
-            }
-            // Create the workflow directory if needed and write the workflow file atomically
-            const workflowDir = path.join(repoPath, ".github", "workflows");
-            await fs.mkdir(workflowDir, { recursive: true });
-            const workflowPath = path.join(workflowDir, WORKFLOW_FILENAME);
-            const workflowContent = generateWorkflow(targetBranches, agentType);
-            try {
-                await fs.writeFile(workflowPath, workflowContent, {
-                    encoding: "utf-8",
-                    flag: "wx",
-                });
-            }
-            catch (err) {
-                if (err.code === "EEXIST") {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: `Skyramp Test Bot workflow already exists at ".github/workflows/${WORKFLOW_FILENAME}". No changes were made. If you want to reconfigure it, delete the existing file and run this tool again.`,
-                            },
-                        ],
-                    };
-                }
-                throw err;
-            }
-            // Build success message with setup instructions
-            const secretName = agentType === "copilot" ? "COPILOT_API_KEY" : "CURSOR_API_KEY";
-            const agentLabel = agentType === "copilot" ? "Copilot" : "Cursor";
-            const successMessage = `Skyramp Test Bot workflow created successfully at ".github/workflows/${WORKFLOW_FILENAME}".
-
-To complete the setup, configure the following GitHub Secrets in your repository (Settings > Secrets and variables > Actions):
-
-1. **SKYRAMP_LICENSE** - The contents of your Skyramp license file (paste the full license file text)
-2. **${secretName}** - Your ${agentLabel} API key
-
-The workflow is configured to run on ${targetBranches && targetBranches.length > 0 ? `pull requests targeting: ${targetBranches.join(", ")}` : "all pull requests"}
-
-Required repository permissions (already configured in the workflow):
-- \`contents: write\` - To commit generated tests
-- \`pull-requests: write\` - To post comments on PRs
-
-Next steps:
-1. Add the required secrets to your GitHub repository
-2. Commit and push the new workflow file
-3. Open a pull request to see Skyramp Test Bot in action`;
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: successMessage,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const errorMessage = `Failed to initialize Skyramp Test Bot: ${error.message}`;
-            logger.error(errorMessage, { error });
-            errorResult = {
-                content: [
-                    {
-                        type: "text",
-                        text: errorMessage,
-                    },
-                ],
-                isError: true,
-            };
-            return errorResult;
-        }
-        finally {
-            const recordParams = {
-                repository_path: repoPath,
-                agent_type: agentType,
-                target_branches: targetBranches ? targetBranches.join(",") : "",
-            };
-            AnalyticsService.pushMCPToolEvent(TOOL_NAME, errorResult, recordParams);
-        }
-    });
-}

package/build/tools/initTestbotTool.test.js

@@ -1,194 +0,0 @@
-// @ts-ignore
-import { registerInitTestbotTool } from "./initTestbotTool.js";
-import { simpleGit } from "simple-git";
-import * as fs from "fs/promises";
-import * as fsSync from "fs";
-import * as path from "path";
-import * as os from "os";
-// Mock logger and AnalyticsService to avoid side effects
-jest.mock("../utils/logger.js", () => ({
-    logger: { info: jest.fn(), error: jest.fn() },
-}));
-jest.mock("../services/AnalyticsService.js", () => ({
-    AnalyticsService: { pushMCPToolEvent: jest.fn() },
-}));
-/**
- * Captures the tool handler callback from registerInitTestbotTool
- * by providing a fake McpServer with a mock registerTool method.
- */
-function captureToolHandler() {
-    let handler;
-    const fakeServer = {
-        registerTool: (_name, _opts, fn) => {
-            handler = fn;
-        },
-    };
-    registerInitTestbotTool(fakeServer);
-    return handler;
-}
-/**
- * Creates a temp directory, initializes a git repo, and optionally
- * adds a GitHub remote.
- */
-async function createTempRepo(options) {
-    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "init-testbot-test-"));
-    const git = simpleGit(tmpDir);
-    await git.init();
-    if (options?.addGithubRemote !== false) {
-        await git.addRemote("origin", "https://github.com/test-org/test-repo.git");
-    }
-    return tmpDir;
-}
-describe("registerInitTestbotTool", () => {
-    let handler;
-    let tmpDirs = [];
-    beforeAll(() => {
-        handler = captureToolHandler();
-    });
-    afterEach(async () => {
-        for (const dir of tmpDirs) {
-            await fs.rm(dir, { recursive: true, force: true });
-        }
-        tmpDirs = [];
-    });
-    it("should register the tool on the server", () => {
-        const registerToolMock = jest.fn();
-        const fakeServer = { registerTool: registerToolMock };
-        registerInitTestbotTool(fakeServer);
-        expect(registerToolMock).toHaveBeenCalledWith("skyramp_init_testbot", expect.objectContaining({
-            description: expect.any(String),
-            inputSchema: expect.any(Object),
-        }), expect.any(Function));
-    });
-    it("should return error for non-git directory", async () => {
-        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "init-testbot-test-"));
-        tmpDirs.push(tmpDir);
-        const result = await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        expect(result.isError).toBe(true);
-        expect(result.content[0].text).toContain("is not a Git repository");
-    });
-    it("should return error for git repo without GitHub remote", async () => {
-        const tmpDir = await createTempRepo({ addGithubRemote: false });
-        tmpDirs.push(tmpDir);
-        const result = await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        expect(result.isError).toBe(true);
-        expect(result.content[0].text).toContain("No GitHub remote found");
-    });
-    it("should create workflow file on success", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        const result = await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        expect(result.isError).toBeUndefined();
-        expect(result.content[0].text).toContain("workflow created successfully");
-        const workflowPath = path.join(tmpDir, ".github", "workflows", "skyramp-test-bot.yml");
-        expect(fsSync.existsSync(workflowPath)).toBe(true);
-    });
-    it("should return already-exists message when workflow file exists", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        // Create the workflow file first
-        const workflowDir = path.join(tmpDir, ".github", "workflows");
-        await fs.mkdir(workflowDir, { recursive: true });
-        await fs.writeFile(path.join(workflowDir, "skyramp-test-bot.yml"), "existing");
-        const result = await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        expect(result.isError).toBeUndefined();
-        expect(result.content[0].text).toContain("already exists");
-        // Verify original file was not overwritten
-        const content = await fs.readFile(path.join(workflowDir, "skyramp-test-bot.yml"), "utf-8");
-        expect(content).toBe("existing");
-    });
-    it("should generate workflow with cursor API key by default", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        const workflowContent = await fs.readFile(path.join(tmpDir, ".github", "workflows", "skyramp-test-bot.yml"), "utf-8");
-        expect(workflowContent).toContain("cursor_api_key");
-        expect(workflowContent).not.toContain("copilot_api_key");
-    });
-    it("should generate workflow with copilot API key when agent_type is copilot", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        await handler({
-            repository_path: tmpDir,
-            agent_type: "copilot",
-        });
-        const workflowContent = await fs.readFile(path.join(tmpDir, ".github", "workflows", "skyramp-test-bot.yml"), "utf-8");
-        expect(workflowContent).toContain("copilot_api_key");
-        expect(workflowContent).not.toContain("cursor_api_key");
-    });
-    it("should generate workflow without branches key when target_branches is not provided", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        const workflowContent = await fs.readFile(path.join(tmpDir, ".github", "workflows", "skyramp-test-bot.yml"), "utf-8");
-        expect(workflowContent).toContain("pull_request:");
-        expect(workflowContent).not.toContain("branches:");
-    });
-    it("should generate workflow with branches key when target_branches is provided", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-            target_branches: ["main", "develop"],
-        });
-        const workflowContent = await fs.readFile(path.join(tmpDir, ".github", "workflows", "skyramp-test-bot.yml"), "utf-8");
-        expect(workflowContent).toContain("branches:");
-        expect(workflowContent).toContain("- 'main'");
-        expect(workflowContent).toContain("- 'develop'");
-    });
-    it("should include setup instructions with correct secret names for cursor", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        const result = await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        expect(result.content[0].text).toContain("CURSOR_API_KEY");
-        expect(result.content[0].text).toContain("SKYRAMP_LICENSE");
-        expect(result.content[0].text).toContain("all pull requests");
-    });
-    it("should include setup instructions with correct secret names for copilot", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        const result = await handler({
-            repository_path: tmpDir,
-            agent_type: "copilot",
-            target_branches: ["main"],
-        });
-        expect(result.content[0].text).toContain("COPILOT_API_KEY");
-        expect(result.content[0].text).toContain("pull requests targeting: main");
-    });
-    it("should generate valid YAML workflow structure", async () => {
-        const tmpDir = await createTempRepo();
-        tmpDirs.push(tmpDir);
-        await handler({
-            repository_path: tmpDir,
-            agent_type: "cursor",
-        });
-        const workflowContent = await fs.readFile(path.join(tmpDir, ".github", "workflows", "skyramp-test-bot.yml"), "utf-8");
-        expect(workflowContent).toContain("name: Skyramp Test Automation");
-        expect(workflowContent).toContain("runs-on: ubuntu-latest");
-        expect(workflowContent).toContain("uses: actions/checkout@v4");
-        expect(workflowContent).toContain("uses: skyramp/test-bot@v1");
-        expect(workflowContent).toContain("skyramp_license_file:");
-    });
-});