@arii/boomtick-mcp 0.4.2 → 0.5.0

package/.mcp/schemas/agent_search_ddgs.json

@@ -1,31 +0,0 @@
-{
-  "name": "agent_search_ddgs",
-  "description": "Search the web using DuckDuckGo (via ddgs python library).",
-  "parameters": {
-    "properties": {
-      "query": {
-        "description": "The search query.",
-        "title": "Query",
-        "type": "string"
-      },
-      "maxResults": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Maximum number of results to return.",
-        "title": "Maxresults"
-      }
-    },
-    "required": [
-      "query"
-    ],
-    "title": "SearchDdgsInput",
-    "type": "object"
-  }
-}

package/.mcp/schemas/repo.get_route_map.json

@@ -1,23 +0,0 @@
-{
-  "name": "repo.get_route_map",
-  "description": "Get the mapping of routes to content files.",
-  "parameters": {
-    "properties": {
-      "includeStatic": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Whether to include static assets in the route map.",
-        "title": "Includestatic"
-      }
-    },
-    "title": "GetRouteMapInput",
-    "type": "object"
-  }
-}

package/.mcp/schemas/repo.run_lighthouse.json

@@ -1,29 +0,0 @@
-{
-  "name": "repo.run_lighthouse",
-  "description": "Run Lighthouse CI audits.",
-  "parameters": {
-    "properties": {
-      "route": {
-        "default": "/",
-        "description": "The route to audit (default: '/').",
-        "title": "Route",
-        "type": "string"
-      },
-      "worktreePath": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional path to the worktree to run the audit in.",
-        "title": "Worktreepath"
-      }
-    },
-    "title": "RunLighthouseInput",
-    "type": "object"
-  }
-}

package/.mcp/schemas/repo.run_playwright.json

@@ -1,36 +0,0 @@
-{
-  "name": "repo.run_playwright",
-  "description": "Run Playwright E2E tests.",
-  "parameters": {
-    "properties": {
-      "grep": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional pattern to filter tests by name.",
-        "title": "Grep"
-      },
-      "worktreePath": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional path to the worktree to run tests in.",
-        "title": "Worktreepath"
-      }
-    },
-    "title": "RunPlaywrightInput",
-    "type": "object"
-  }
-}

package/.mcp/schemas/repo_get_route_map.json

@@ -1,23 +0,0 @@
-{
-  "name": "repo_get_route_map",
-  "description": "Get the mapping of routes to content files.",
-  "parameters": {
-    "properties": {
-      "includeStatic": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Whether to include static assets in the route map.",
-        "title": "Includestatic"
-      }
-    },
-    "title": "GetRouteMapInput",
-    "type": "object"
-  }
-}

package/.mcp/schemas/repo_run_lighthouse.json

@@ -1,29 +0,0 @@
-{
-  "name": "repo_run_lighthouse",
-  "description": "Run Lighthouse CI audits.",
-  "parameters": {
-    "properties": {
-      "route": {
-        "default": "/",
-        "description": "The route to audit (default: '/').",
-        "title": "Route",
-        "type": "string"
-      },
-      "worktreePath": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional path to the worktree to run the audit in.",
-        "title": "Worktreepath"
-      }
-    },
-    "title": "RunLighthouseInput",
-    "type": "object"
-  }
-}

package/.mcp/schemas/repo_run_playwright.json

@@ -1,36 +0,0 @@
-{
-  "name": "repo_run_playwright",
-  "description": "Run Playwright E2E tests.",
-  "parameters": {
-    "properties": {
-      "grep": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional pattern to filter tests by name.",
-        "title": "Grep"
-      },
-      "worktreePath": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional path to the worktree to run tests in.",
-        "title": "Worktreepath"
-      }
-    },
-    "title": "RunPlaywrightInput",
-    "type": "object"
-  }
-}

package/dist/lib/td-cli.js

@@ -1,54 +0,0 @@
-import { runCommand } from "../lib/shell.js";
-import { execSync } from "child_process";
-import * as fs from "fs";
-import * as path from "path";
-export const loadStandaloneAgentContext = (repoRoot = process.cwd()) => {
-    const configPath = path.join(repoRoot, "project_config.json");
-    let config = {};
-    if (fs.existsSync(configPath)) {
-        try {
-            config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-        }
-        catch (e) {
-            console.warn(`[MCP Warning] Failed to parse ${configPath}:`, e);
-        }
-    }
-    let gitCommit = "unknown";
-    try {
-        gitCommit = execSync("git rev-parse HEAD", { cwd: repoRoot, encoding: "utf-8" }).trim();
-    }
-    catch {
-        // Fallback if git is unavailable (e.g. Docker container without git)
-    }
-    return {
-        packageName: config.packageName ?? "boomtick",
-        gitCommit,
-        config,
-    };
-};
-function tryParseJson(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}
-export async function runTDCli(args) {
-    const result = await runCommand("td-cli", args);
-    const stdout = result.stdout.trim();
-    const output = stdout.startsWith("{") ? tryParseJson(stdout) : null;
-    // Handle structured errors (status: "error") regardless of exit code
-    if (output?.status === "error") {
-        throw new Error(`td-cli returned error: ${output.message ?? "Unknown error"}`);
-    }
-    // Handle non-zero exit codes (shell failure)
-    if (result.exitCode !== 0) {
-        throw new Error(`td-cli command failed (${args.join(" ")}): ${result.stderr || stdout}`);
-    }
-    // Ensure we have a valid JSON response for successful exit
-    if (!output) {
-        throw new Error(`td-cli returned non-JSON output with exit code 0: ${stdout}`);
-    }
-    return output;
-}

package/dist/tools/ddgs.search.js

@@ -1,50 +0,0 @@
-import { z } from "zod";
-import { runCommand } from "../lib/shell.js";
-export const DdgsSearchInputSchema = z.object({
-    query: z.string(),
-    maxResults: z.number().optional().default(5),
-});
-import path from "path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-export async function ddgsSearchHandler(args) {
-    const scriptPath = path.join(__dirname, "ddgs_search.py");
-    // Sanitize query by removing control characters, newlines, and null bytes
-    // eslint-disable-next-line no-control-regex
-    const safeQuery = args.query.replace(/[\x00-\x1F\x7F-\x9F]/g, " ").trim();
-    if (!safeQuery) {
-        throw new Error("Query cannot be empty after sanitization.");
-    }
-    const result = await runCommand("python3", [scriptPath, safeQuery, (args.maxResults ?? 5).toString()]);
-    // duckduckgo_search logs annoying deprecation warnings to stderr we want to ignore
-    // if it really failed, exitCode will be non-zero and we'll have stdout/stderr
-    if (result.exitCode !== 0) {
-        let parsedError = result.stderr || result.stdout;
-        const lines = parsedError.split("\n");
-        for (const line of lines) {
-            try {
-                const json = JSON.parse(line);
-                if (json.error) {
-                    parsedError = json.error;
-                    break;
-                }
-            }
-            catch {
-                // continue
-            }
-        }
-        throw new Error(`Failed to search ddgs: ${parsedError}`);
-    }
-    try {
-        const data = JSON.parse(result.stdout);
-        if (!Array.isArray(data)) {
-            throw new Error("Expected an array of search results");
-        }
-        return { results: data };
-    }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        throw new Error(`Failed to parse ddgs search results. Error: ${message}. Output was: ${result.stdout}`);
-    }
-}

package/dist/tools/ddgs.search.test.js

@@ -1,67 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { ddgsSearchHandler } from "./ddgs.search.js";
-import { runCommand } from "../lib/shell.js";
-vi.mock("../lib/shell.js");
-describe("ddgsSearchHandler", () => {
-    beforeEach(() => {
-        vi.resetAllMocks();
-    });
-    it("should parse arguments, sanitize query, and return search results", async () => {
-        const mockOutput = JSON.stringify([
-            { title: "Result 1", href: "https://example.com/1", body: "Description 1" },
-            { title: "Result 2", href: "https://example.com/2", body: "Description 2" },
-        ]);
-        vi.mocked(runCommand).mockResolvedValue({
-            stdout: mockOutput,
-            stderr: "",
-            exitCode: 0,
-            durationMs: 100,
-            command: "mock python3",
-        });
-        const result = await ddgsSearchHandler({ query: "test\nquery\x00", maxResults: 2 });
-        expect(runCommand).toHaveBeenCalledTimes(1);
-        expect(runCommand).toHaveBeenCalledWith("python3", [expect.stringContaining("ddgs_search.py"), "test query", "2"]);
-        expect(result.results).toHaveLength(2);
-        expect(result.results[0].title).toBe("Result 1");
-    });
-    it("should handle raw error when python script exits with non-zero code and non-JSON output", async () => {
-        vi.mocked(runCommand).mockResolvedValue({
-            stdout: "",
-            stderr: "Python script failed",
-            exitCode: 1,
-            durationMs: 100,
-            command: "mock python3",
-        });
-        await expect(ddgsSearchHandler({ query: "test query", maxResults: 2 })).rejects.toThrow("Failed to search ddgs: Python script failed");
-    });
-    it("should handle parsed JSON error when python script exits with non-zero code", async () => {
-        vi.mocked(runCommand).mockResolvedValue({
-            stdout: "",
-            stderr: JSON.stringify({ error: "Structured JSON error" }),
-            exitCode: 1,
-            durationMs: 100,
-            command: "mock python3",
-        });
-        await expect(ddgsSearchHandler({ query: "test query", maxResults: 2 })).rejects.toThrow("Failed to search ddgs: Structured JSON error");
-    });
-    it("should handle error when python output is not an array", async () => {
-        vi.mocked(runCommand).mockResolvedValue({
-            stdout: JSON.stringify({ error: "Something went wrong" }),
-            stderr: "",
-            exitCode: 0,
-            durationMs: 100,
-            command: "mock python3",
-        });
-        await expect(ddgsSearchHandler({ query: "test query", maxResults: 2 })).rejects.toThrow("Expected an array of search results");
-    });
-    it("should handle error when python output cannot be parsed", async () => {
-        vi.mocked(runCommand).mockResolvedValue({
-            stdout: "invalid json",
-            stderr: "",
-            exitCode: 0,
-            durationMs: 100,
-            command: "mock python3",
-        });
-        await expect(ddgsSearchHandler({ query: "test query", maxResults: 2 })).rejects.toThrow("Failed to parse ddgs search results");
-    });
-});

package/dist/tools/ddgs_search.py

@@ -1,23 +0,0 @@
-# pylint: disable=line-too-long
-"""DuckDuckGo Search tool."""
-import json
-import sys
-
-try:
-    from duckduckgo_search import DDGS
-except ImportError:
-    print(json.dumps({"error": "duckduckgo_search package not found. Please install it using 'pip install duckduckgo-search' (preferably in a virtual environment)."}), file=sys.stderr)
-    sys.exit(1)
-
-if len(sys.argv) != 3:
-    print(json.dumps({"error": f"Invalid argument count. Expected 2 (query, max_results), got {len(sys.argv) - 1}."}), file=sys.stderr)
-    sys.exit(1)
-
-try:
-    query = sys.argv[1]
-    max_results = int(sys.argv[2])
-    results = DDGS().text(query, max_results=max_results)
-    print(json.dumps(list(results)))
-except Exception as e:
-    print(json.dumps({"error": str(e)}), file=sys.stderr)
-    sys.exit(1)

package/dist/tools/repo.get_route_map.js

@@ -1,37 +0,0 @@
-import { z } from "zod";
-import { runCommand } from "../lib/shell.js";
-import { config } from "../config.js";
-import path from "path";
-export const GetRouteMapInputSchema = z.object({
-    includeStatic: z.boolean().optional(),
-});
-export async function getRouteMapHandler(args) {
-    GetRouteMapInputSchema.parse(args);
-    // Logic based on tech-dancer repo structure: src/config/routes.ts and content/
-    const routesPath = path.join(config.repoPath, "src/config/routes.ts");
-    // For simplicity in MVP, we'll try to find routes by listing content files
-    // and reading the main routes file if it exists.
-    let routeMap = {};
-    try {
-        const gitFiles = await runCommand("git", ["ls-files", "content/"]);
-        const contentFiles = gitFiles.stdout.trim().split("\n");
-        for (const file of contentFiles) {
-            if (file.endsWith(".md")) {
-                const slug = path.basename(file, ".md");
-                if (file.includes("/posts/")) {
-                    routeMap[`/blog/${slug}`] = file;
-                }
-                else if (file.includes("/resources/")) {
-                    routeMap[`/resources/${slug}`] = file;
-                }
-            }
-        }
-    }
-    catch (error) {
-        // If no content files, that's fine
-    }
-    if (args.includeStatic) {
-        routeMap["/favicon.ico"] = "public/favicon.ico";
-    }
-    return { routeMap };
-}

package/dist/tools/repo.run_lighthouse.js

@@ -1,37 +0,0 @@
-import { z } from "zod";
-import { runCommand } from "../lib/shell.js";
-export const RunLighthouseInputSchema = z.object({
-    route: z.string().optional().default("/"),
-    worktreePath: z.string().optional(),
-});
-export async function runLighthouseHandler(args) {
-    const results = await runCommand("pnpm", ["lhci", "autorun", "--json"], { cwd: args.worktreePath });
-    let summary = {};
-    const failures = [];
-    try {
-        // Attempt to parse summary from LHCI output if available
-        // For MVP, we'll provide a structured placeholder if actual JSON isn't present
-        if (results.stdout.includes("{")) {
-            const possibleJson = results.stdout.substring(results.stdout.indexOf("{"));
-            summary = JSON.parse(possibleJson);
-        }
-        else {
-            summary = {
-                performance: 0,
-                accessibility: 0,
-                bestPractices: 0,
-                seo: 0
-            };
-        }
-    }
-    catch (e) {
-        failures.push("Failed to parse Lighthouse report");
-    }
-    return {
-        success: results.exitCode === 0,
-        route: args.route,
-        summary,
-        failures,
-        command: results.command
-    };
-}

package/dist/tools/repo.run_playwright.js

@@ -1,34 +0,0 @@
-import { z } from "zod";
-import { runCommand } from "../lib/shell.js";
-export const RunPlaywrightInputSchema = z.object({
-    grep: z.string().optional(),
-    worktreePath: z.string().optional(),
-    timeoutSeconds: z.number().optional().default(180),
-});
-export async function runPlaywrightHandler(args) {
-    const parsed = RunPlaywrightInputSchema.parse(args || {});
-    const tdArgs = ["repo", "run-playwright"];
-    if (parsed.grep) {
-        tdArgs.push("--grep", parsed.grep);
-    }
-    if (parsed.worktreePath) {
-        tdArgs.push("--worktree", parsed.worktreePath);
-    }
-    const result = await runCommand("td-cli", tdArgs, {
-        cwd: parsed.worktreePath,
-        timeout: parsed.timeoutSeconds * 1000,
-    });
-    if (result.exitCode !== 0) {
-        // Playwright might exit with non-zero if tests fail, but our td-cli should ideally handle it
-        // and return a JSON with success: false.
-    }
-    const output = JSON.parse(result.stdout);
-    if (output.status === "error") {
-        throw new Error(`Failed to run Playwright: ${output.message}`);
-    }
-    return {
-        success: output.success,
-        command: output.command,
-        failedTests: output.failedTests
-    };
-}

package/scripts/export-mcp-schema.ts

@@ -1,7 +0,0 @@
-import { MCP_TOOLS, MCP_PROMPTS, MCP_RESOURCES } from "../src/mcp/definitions.js";
-
-console.log(JSON.stringify({
-  tools: MCP_TOOLS,
-  prompts: MCP_PROMPTS,
-  resources: MCP_RESOURCES
-}, null, 2));

package/src/lib/td-cli.ts

@@ -1,73 +0,0 @@
-import { runCommand } from "../lib/shell.js";
-import { execSync } from "child_process";
-import * as fs from "fs";
-import * as path from "path";
-
-export interface TDCliResponse {
-  status: string;
-  message?: string;
-  [key: string]: any;
-}
-
-export interface AgentContext {
-  packageName: string;
-  gitCommit: string;
-  config: Record<string, unknown>;
-}
-
-export const loadStandaloneAgentContext = (repoRoot: string = process.cwd()): AgentContext => {
-  const configPath = path.join(repoRoot, "project_config.json");
-  let config: Record<string, unknown> = {};
-
-  if (fs.existsSync(configPath)) {
-    try {
-      config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-    } catch (e) {
-      console.warn(`[MCP Warning] Failed to parse ${configPath}:`, e);
-    }
-  }
-
-  let gitCommit = "unknown";
-  try {
-    gitCommit = execSync("git rev-parse HEAD", { cwd: repoRoot, encoding: "utf-8" }).trim();
-  } catch {
-    // Fallback if git is unavailable (e.g. Docker container without git)
-  }
-
-  return {
-    packageName: (config.packageName as string) ?? "boomtick",
-    gitCommit,
-    config,
-  };
-};
-
-function tryParseJson(text: string): TDCliResponse | null {
-  try {
-    return JSON.parse(text) as TDCliResponse;
-  } catch {
-    return null;
-  }
-}
-
-export async function runTDCli(args: string[]): Promise<TDCliResponse> {
-  const result = await runCommand("td-cli", args);
-  const stdout = result.stdout.trim();
-  const output = stdout.startsWith("{") ? tryParseJson(stdout) : null;
-
-  // Handle structured errors (status: "error") regardless of exit code
-  if (output?.status === "error") {
-    throw new Error(`td-cli returned error: ${output.message ?? "Unknown error"}`);
-  }
-
-  // Handle non-zero exit codes (shell failure)
-  if (result.exitCode !== 0) {
-    throw new Error(`td-cli command failed (${args.join(" ")}): ${result.stderr || stdout}`);
-  }
-
-  // Ensure we have a valid JSON response for successful exit
-  if (!output) {
-    throw new Error(`td-cli returned non-JSON output with exit code 0: ${stdout}`);
-  }
-
-  return output;
-}