@recapt/mcp 0.0.3-beta → 0.0.5-beta

package/dist/tools/remediation.js

@@ -0,0 +1,223 @@
+/**
+ * Remediation tools for self-healing workflow.
+ *
+ * Provides fix proposal, deployment confirmation, evaluation, and history tracking.
+ */
+import { z } from "zod";
+import { apiGet, apiPost, apiPatch, isApiConfigured } from "../api/client.js";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function registerRemediationTools(server) {
+    server.registerTool("propose_fix", {
+        description: "Propose a fix for an issue. Creates a remediation record with baseline metrics for later evaluation. Include detailed diagnosis and code suggestions when possible.",
+        inputSchema: z.object({
+            issue_id: z.string().describe("The ID of the issue to fix"),
+            diagnosis: z
+                .string()
+                .describe("Detailed analysis of the root cause of the issue"),
+            proposed_fix: z
+                .string()
+                .describe("Description of the proposed fix and how it addresses the root cause"),
+            code_snippet: z
+                .string()
+                .optional()
+                .describe("Suggested code changes (if applicable)"),
+            affected_files: z
+                .array(z.string())
+                .optional()
+                .describe("List of files that need to be modified"),
+            confidence: z
+                .number()
+                .min(0)
+                .max(1)
+                .describe("Confidence level in the fix (0-1). Use <0.7 when uncertain."),
+        }),
+    }, async ({ issue_id, diagnosis, proposed_fix, code_snippet, affected_files, confidence, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPost("/remediations", {
+            issue_id,
+            diagnosis,
+            proposed_fix,
+            code_snippet,
+            affected_files,
+            confidence,
+        });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("list_pending_fixes", {
+        description: "List all proposed fixes awaiting deployment. Use to show the user what fixes are ready to be deployed.",
+        inputSchema: z.object({}),
+    }, async () => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiGet("/remediations/pending");
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("list_remediations", {
+        description: "List remediation records with optional filters. Use to review past and current fix attempts.",
+        inputSchema: z.object({
+            status: z
+                .enum([
+                "proposed",
+                "deployed",
+                "evaluating",
+                "succeeded",
+                "failed",
+                "reverted",
+            ])
+                .optional()
+                .describe("Filter by remediation status"),
+            issue_id: z.string().optional().describe("Filter by issue ID"),
+            page_path: z.string().optional().describe("Filter by page path"),
+            limit: z
+                .number()
+                .optional()
+                .default(20)
+                .describe("Maximum number of results (default: 20)"),
+        }),
+    }, async ({ status, issue_id, page_path, limit, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiGet("/remediations", {
+            status,
+            issue_id,
+            page_path,
+            limit: limit ?? 20,
+        });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("confirm_deployment", {
+        description: "Confirm that a proposed fix has been deployed to production. This starts the evaluation timer. Call this when the user confirms they have deployed the fix.",
+        inputSchema: z.object({
+            remediation_id: z
+                .string()
+                .describe("The ID of the remediation to mark as deployed"),
+        }),
+    }, async ({ remediation_id }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPatch(`/remediations/${remediation_id}/deploy`, {});
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("evaluate_fix", {
+        description: "Evaluate if a deployed fix improved metrics. Compares post-deployment metrics to baseline. Returns success/partial/failed outcome with detailed verdict. Wait at least 24 hours after deployment for reliable results.",
+        inputSchema: z.object({
+            remediation_id: z
+                .string()
+                .describe("The ID of the remediation to evaluate"),
+            min_hours: z
+                .number()
+                .optional()
+                .default(24)
+                .describe("Minimum hours since deployment required (default: 24)"),
+        }),
+    }, async ({ remediation_id, min_hours, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPost(`/remediations/${remediation_id}/evaluate`, { min_hours: min_hours ?? 24 });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("get_fix_history", {
+        description: "Get the full remediation history for an issue. Shows all fix attempts, their outcomes, and current status. Use before proposing a new fix to learn from past attempts.",
+        inputSchema: z.object({
+            issue_id: z
+                .string()
+                .describe("The ID of the issue to get fix history for"),
+        }),
+    }, async ({ issue_id }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiGet(`/remediations/history/${issue_id}`);
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+}

package/dist/tools/triage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Triage tools for self-healing workflow.
+ *
+ * Provides issue dismissal, marking intended behavior, and issue history.
+ */
+export declare function registerTriageTools(server: any): void;

package/dist/tools/triage.js

@@ -0,0 +1,114 @@
+/**
+ * Triage tools for self-healing workflow.
+ *
+ * Provides issue dismissal, marking intended behavior, and issue history.
+ */
+import { z } from "zod";
+import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
+const DISMISS_REASONS = [
+    "stale",
+    "intended",
+    "duplicate",
+    "false_positive",
+];
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function registerTriageTools(server) {
+    server.registerTool("dismiss_issue", {
+        description: "Dismiss an issue as a false positive. Creates site knowledge to prevent re-flagging. Use when an issue is stale, intended behavior, a duplicate, or a false positive. Always confirm with user before dismissing.",
+        inputSchema: z.object({
+            issue_id: z.string().describe("The ID of the issue to dismiss"),
+            reason: z
+                .enum(DISMISS_REASONS)
+                .describe("Reason for dismissal: stale, intended, duplicate, or false_positive"),
+            explanation: z
+                .string()
+                .describe("Detailed explanation of why this issue is being dismissed"),
+            create_knowledge: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Whether to create site knowledge entry (default: true)"),
+        }),
+    }, async ({ issue_id, reason, explanation, create_knowledge, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPost(`/issues/${issue_id}/dismiss`, {
+            reason,
+            explanation,
+            create_knowledge: create_knowledge ?? true,
+        });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("mark_intended_behavior", {
+        description: "Mark an issue as intended behavior. This is a shortcut for dismissing with reason 'intended' and always creates site knowledge. Use when the detected behavior is by design (e.g., disabled button clicks are expected).",
+        inputSchema: z.object({
+            issue_id: z
+                .string()
+                .describe("The ID of the issue to mark as intended"),
+            explanation: z
+                .string()
+                .describe("Explanation of why this behavior is intended"),
+        }),
+    }, async ({ issue_id, explanation, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPost(`/issues/${issue_id}/mark-intended`, { explanation });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("get_issue_history", {
+        description: "Get the full history of an issue including status changes, remediation attempts, and outcomes. Use to understand past fix attempts before proposing new ones.",
+        inputSchema: z.object({
+            issue_id: z.string().describe("The ID of the issue to get history for"),
+        }),
+    }, async ({ issue_id }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiGet(`/issues/${issue_id}/history`);
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recapt/mcp",
-  "version": "0.0.3-beta",
+  "version": "0.0.5-beta",
   "description": "MCP exposing recapt behavioral intelligence to AI coding agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,8 @@
     "dev": "tsx --watch src/index.ts",
     "start": "node dist/index.js",
     "prettify": "prettier --write .",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "generate-catalog": "tsx scripts/generateCatalog.ts"
   },
   "bin": {
     "recapt-mcp": "./dist/index.js"
@@ -26,6 +27,9 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.24.0"
   },
+  "optionalDependencies": {
+    "@xenova/transformers": "^2.17.0"
+  },
   "peerDependencies": {
     "@types/node": "^24.3.1",
     "dotenv": "^17.2.2",