@recapt/mcp 0.0.24 → 0.0.27

package/dist/cli/index.js

@@ -762,8 +762,13 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 var __filename3 = fileURLToPath2(import.meta.url);
 var __dirname3 = path3.dirname(__filename3);
 var TEMPLATES_DIR = path3.resolve(__dirname3, "../../../templates");
-var WORKFLOW_TEMPLATE = "self-improvement.md";
-var WORKFLOW_DEST = ".github/workflows/self-improvement.md";
+var WORKFLOW_TEMPLATES = {
+  lite: "self-improvement-lite.md",
+  full: "self-improvement-full.md"
+};
+function getWorkflowDest(variant) {
+  return `.github/workflows/self-improvement-${variant}.md`;
+}
 var ENGINES = [
   { id: "claude", name: "Claude (Anthropic)", secretName: "ANTHROPIC_API_KEY" },
   { id: "copilot", name: "GitHub Copilot", secretName: "COPILOT_GITHUB_TOKEN" },
@@ -840,7 +845,7 @@ function openBrowser2(url) {
     }
   });
 }
-async function runSetupSelfImprovementGh() {
+async function runSetupSelfImprovementGh(variantFromFlag) {
   header("Recapt Self-Improvement GitHub Setup");
   const cwd = process.cwd();
   print("Checking prerequisites...");
@@ -897,6 +902,29 @@ async function runSetupSelfImprovementGh() {
     process.exit(1);
   }
   newline();
+  let selectedVariant;
+  if (variantFromFlag === "lite" || variantFromFlag === "full") {
+    selectedVariant = variantFromFlag;
+    info(`Using variant: ${selectedVariant}`);
+  } else {
+    const variantOptions = [
+      {
+        label: "Lite (Sequential) - Single agent, one combined PR, ~5x cheaper",
+        value: "lite"
+      },
+      {
+        label: "Full (Parallel) - Orchestrator + workers, 1 PR per issue, faster for many issues",
+        value: "full"
+      }
+    ];
+    const variant = await select("Which workflow variant?", variantOptions);
+    if (!variant) {
+      error("No variant selected.");
+      process.exit(1);
+    }
+    selectedVariant = variant;
+  }
+  newline();
   print("Configuring domain filter...");
   info("You can optionally limit the workflow to specific domains.");
   newline();
@@ -948,8 +976,10 @@ async function runSetupSelfImprovementGh() {
   }
   newline();
   print("Creating workflow...");
-  const templatePath = path3.join(TEMPLATES_DIR, WORKFLOW_TEMPLATE);
-  const destPath = path3.join(cwd, WORKFLOW_DEST);
+  const templateFile = WORKFLOW_TEMPLATES[selectedVariant];
+  const templatePath = path3.join(TEMPLATES_DIR, templateFile);
+  const workflowDest = getWorkflowDest(selectedVariant);
+  const destPath = path3.join(cwd, workflowDest);
   const destDir = path3.dirname(destPath);
   if (!fs3.existsSync(templatePath)) {
     error(`Workflow template not found: ${templatePath}`);
@@ -993,17 +1023,19 @@ Analyze and fix issues across all domains configured in recapt. Call \`get_domai
       info("Skipping workflow creation");
     } else {
       fs3.writeFileSync(destPath, workflowContent);
-      success(`Created: ${WORKFLOW_DEST}`);
+      success(`Created: ${workflowDest}`);
     }
   } else {
     fs3.writeFileSync(destPath, workflowContent);
-    success(`Created: ${WORKFLOW_DEST}`);
+    success(`Created: ${workflowDest}`);
   }
   newline();
   print("Compiling workflow...");
   try {
     execSync("gh aw compile", { cwd, stdio: "inherit" });
-    success("Created: .github/workflows/self-improvement.lock.yml");
+    success(
+      `Created: .github/workflows/self-improvement-${selectedVariant}.lock.yml`
+    );
   } catch {
     warn("Failed to compile workflow. You can run 'gh aw compile' manually.");
   }
@@ -1034,7 +1066,7 @@ Analyze and fix issues across all domains configured in recapt. Call \`get_domai
     '  1. git add . && git commit -m "Add recapt self-improvement workflow"'
   );
   print("  2. git push");
-  print("  3. Run manually: gh aw run self-improvement");
+  print(`  3. Run manually: gh aw run self-improvement-${selectedVariant}`);
   newline();
   warn("Important: Enable PR creation permissions");
   info("The workflow needs permission to create pull requests.");
@@ -1045,9 +1077,12 @@ Analyze and fix issues across all domains configured in recapt. Call \`get_domai
 }
 var setupSelfImprovementGhCommand = new Command3(
   "setup-self-improvement-gh"
-).description("Set up automated self-improvement workflow for GitHub Actions").action(async () => {
+).description("Set up automated self-improvement workflow for GitHub Actions").option(
+  "-v, --variant <variant>",
+  "Workflow variant: lite (single agent, one PR) or full (parallel workers, multiple PRs)"
+).action(async (options) => {
   try {
-    await runSetupSelfImprovementGh();
+    await runSetupSelfImprovementGh(options.variant);
   } catch (err) {
     error(`Setup failed: ${err}`);
     process.exit(1);

package/dist/index.js

@@ -1181,7 +1181,7 @@ var updateImprovementRunTool = {
   inputSchema: z27.object({
     run_id: z27.string().describe("The ID of the improvement run to update"),
     status: z27.enum(["running", "completed", "failed", "cancelled"]).optional().describe("New status for the run"),
-    title: z27.string().optional().describe("A concise title summarizing what was fixed in this run (e.g., 'Fixed checkout button, improved mobile nav'). Set when completing the run."),
+    title: z27.string().optional().describe("A user-friendly title summarizing what was improved (e.g., 'Fixed checkout responsiveness, improved mobile navigation'). Avoid technical jargon - write for non-developers."),
     phases: z27.array(z27.object({
       name: z27.string(),
       status: z27.enum([
@@ -1576,10 +1576,11 @@ var proposeFixTool = {
     proposed_fix: z32.string().describe("Description of the proposed fix and how it addresses the root cause"),
     code_snippet: z32.string().optional().describe("Suggested code changes (if applicable)"),
     affected_files: z32.array(z32.string()).optional().describe("List of files that need to be modified"),
-    confidence: z32.number().min(0).max(1).describe("Confidence level in the fix (0-1). Use <0.7 when uncertain.")
+    confidence: z32.number().min(0).max(1).describe("Confidence level in the fix (0-1). Use <0.7 when uncertain."),
+    title: z32.string().optional().describe("User-friendly title describing the issue from the user's perspective. Example: 'Checkout button unresponsive during payment' instead of 'Dead clicks on .checkout-btn'")
   }),
   handler: async (args) => {
-    const { issue_id, diagnosis, proposed_fix, code_snippet, affected_files, confidence } = args;
+    const { issue_id, diagnosis, proposed_fix, code_snippet, affected_files, confidence, title } = args;
     if (!isApiConfigured()) {
       return apiNotConfiguredResult();
     }
@@ -1589,7 +1590,8 @@ var proposeFixTool = {
       proposed_fix,
       code_snippet,
       affected_files,
-      confidence
+      confidence,
+      title
     });
     if (error) {
       return errorResult(error);
@@ -1624,7 +1626,8 @@ var listRemediationsTool = {
       "evaluating",
       "succeeded",
       "failed",
-      "reverted"
+      "reverted",
+      "deferred"
     ]).optional().describe("Filter by remediation status"),
     issue_id: z32.string().optional().describe("Filter by issue ID"),
     page_path: z32.string().optional().describe("Filter by page path"),
@@ -1743,7 +1746,8 @@ var listRemediationsByStatusTool = {
       "evaluating",
       "succeeded",
       "failed",
-      "reverted"
+      "reverted",
+      "deferred"
     ])).describe("List of statuses to filter by")
   }),
   handler: async (args) => {
@@ -1778,6 +1782,34 @@ var getRemediationByPrTool = {
     return successResult(data);
   }
 };
+var deferIssueTool = {
+  name: "defer_issue",
+  description: "Defer an issue that needs more data before a fix can be proposed. Creates a remediation record with 'deferred' status to track the issue for future revisiting. Use when you understand the problem but lack sufficient data or confidence to propose a fix.",
+  inputSchema: z32.object({
+    issue_id: z32.string().describe("The ID of the issue to defer"),
+    diagnosis: z32.string().describe("Analysis of what you think the problem might be"),
+    deferral_reason: z32.string().describe("Explanation of why the issue cannot be fixed yet"),
+    confidence: z32.number().min(0).max(1).describe("Confidence level in the diagnosis (0-1). Typically low for deferred issues."),
+    affected_files: z32.array(z32.string()).optional().describe("List of files that might need to be modified")
+  }),
+  handler: async (args) => {
+    const { issue_id, diagnosis, deferral_reason, confidence, affected_files } = args;
+    if (!isApiConfigured()) {
+      return apiNotConfiguredResult();
+    }
+    const { data, error } = await apiPost("/remediations/defer", {
+      issue_id,
+      diagnosis,
+      deferral_reason,
+      confidence,
+      affected_files
+    });
+    if (error) {
+      return errorResult(error);
+    }
+    return successResult(data);
+  }
+};
 
 // ../../libraries/mcp-tools/dist/tools/scanSite.js
 import { z as z33 } from "zod";
@@ -2082,7 +2114,7 @@ var createProposalTool = {
   inputSchema: z37.object({
     issue_id: z37.string().optional().describe("The ID of the related issue (if any)"),
     improvement_run_id: z37.string().optional().describe("The ID of the improvement run creating this proposal"),
-    title: z37.string().describe("Short title describing the proposed fix"),
+    title: z37.string().describe("Short user-friendly title describing the issue from the user's perspective (not technical). Example: 'Checkout button appears unresponsive' instead of 'Dead clicks on .checkout-btn'"),
     diagnosis: z37.string().describe("Detailed analysis of the root cause of the issue"),
     proposed_fix: z37.string().describe("Description of the proposed fix and how it addresses the root cause"),
     affected_files: z37.array(z37.string()).optional().describe("List of files that likely need to be modified"),
@@ -2859,6 +2891,7 @@ var allTools = [
   updateRemediationStatusTool,
   listRemediationsByStatusTool,
   getRemediationByPrTool,
+  deferIssueTool,
   // Scan
   scanSiteTool,
   // Search

package/dist/tools/catalog/anthropicToolCatalog.json

@@ -882,6 +882,44 @@
       ]
     }
   },
+  {
+    "name": "defer_issue",
+    "description": "Defer an issue that needs more data before a fix can be proposed. Creates a remediation record with 'deferred' status to track the issue for future revisiting.",
+    "input_schema": {
+      "type": "object",
+      "properties": {
+        "issue_id": {
+          "description": "The ID of the issue to defer",
+          "type": "string"
+        },
+        "diagnosis": {
+          "description": "Analysis of what you think the problem might be",
+          "type": "string"
+        },
+        "deferral_reason": {
+          "description": "Explanation of why the issue cannot be fixed yet",
+          "type": "string"
+        },
+        "confidence": {
+          "description": "Confidence level in the diagnosis (0-1). Typically low for deferred issues.",
+          "type": "number"
+        },
+        "affected_files": {
+          "description": "List of files that might need to be modified",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "issue_id",
+        "diagnosis",
+        "deferral_reason",
+        "confidence"
+      ]
+    }
+  },
   {
     "name": "get_site_knowledge",
     "description": "Retrieve site-specific learnings including known false positives, intended behaviors, and successful fix patterns.",

package/dist/tools/catalog/toolCatalog.json

@@ -16258,6 +16258,424 @@
       0.101201
     ]
   },
+  {
+    "name": "defer_issue",
+    "description": "Defer an issue that needs more data before a fix can be proposed. Creates a remediation record with 'deferred' status to track the issue for future revisiting.",
+    "category": "remediation",
+    "parameters": {
+      "issue_id": {
+        "type": "string",
+        "required": true,
+        "description": "The ID of the issue to defer"
+      },
+      "diagnosis": {
+        "type": "string",
+        "required": true,
+        "description": "Analysis of what you think the problem might be"
+      },
+      "deferral_reason": {
+        "type": "string",
+        "required": true,
+        "description": "Explanation of why the issue cannot be fixed yet"
+      },
+      "confidence": {
+        "type": "number",
+        "required": true,
+        "description": "Confidence level in the diagnosis (0-1). Typically low for deferred issues."
+      },
+      "affected_files": {
+        "type": "array",
+        "required": false,
+        "description": "List of files that might need to be modified"
+      }
+    },
+    "embedding": [
+      -0.090785,
+      -0.023115,
+      0.009841,
+      0.049837,
+      0.008316,
+      -0.086351,
+      -0.01537,
+      0.023,
+      -0.059376,
+      0.023646,
+      0.064137,
+      0.04991,
+      -0.003003,
+      0.021082,
+      -0.026971,
+      0.01983,
+      -0.058043,
+      0.019794,
+      -0.056083,
+      0.02026,
+      -0.01553,
+      0.023225,
+      -0.044639,
+      0.158276,
+      -0.074527,
+      -0.046598,
+      0.011464,
+      0.037193,
+      -0.019584,
+      -0.04813,
+      0.091623,
+      0.085831,
+      -0.059418,
+      -0.035318,
+      0.027386,
+      0.112868,
+      0.005689,
+      0.024158,
+      0.02302,
+      -0.024084,
+      0.03388,
+      -0.008117,
+      -0.068015,
+      -0.043626,
+      0.022225,
+      -0.006494,
+      0.040092,
+      0.051141,
+      -0.032231,
+      0.054163,
+      0.037727,
+      0.025769,
+      -0.060389,
+      0.005794,
+      0.032628,
+      -0.020736,
+      0.020634,
+      -0.010775,
+      -0.097405,
+      0.042323,
+      -0.004046,
+      0.015772,
+      0.014604,
+      0.024744,
+      -0.060738,
+      0.051743,
+      0.021855,
+      -0.024638,
+      0.032331,
+      0.09518,
+      0.033874,
+      0.030549,
+      -0.102399,
+      -0.036067,
+      -0.001554,
+      -0.001339,
+      -0.051443,
+      0.047809,
+      -0.05188,
+      -0.013229,
+      0.031516,
+      -0.000698,
+      0.012284,
+      -0.027578,
+      0.060057,
+      -0.089717,
+      0.037346,
+      -0.015459,
+      0.060399,
+      -0.015615,
+      0.00811,
+      -0.003897,
+      0.10858,
+      0.001448,
+      -0.063558,
+      0.08281,
+      0.014478,
+      -0.060485,
+      -0.021236,
+      0.023142,
+      -0.034353,
+      -0.031767,
+      -0.007174,
+      -0.000677,
+      -0.018306,
+      -0.042427,
+      0.031594,
+      0.003227,
+      -0.118269,
+      -0.037791,
+      0.028954,
+      0.045947,
+      0.075594,
+      -0.041852,
+      0.03153,
+      0.044024,
+      -0.020942,
+      0.022191,
+      0.028249,
+      -0.093442,
+      0.097532,
+      0.017034,
+      0.02941,
+      -0.023292,
+      0.023614,
+      -0.03163,
+      0.009029,
+      0,
+      -0.014102,
+      -0.02132,
+      -0.072968,
+      -0.019911,
+      0.069266,
+      0.004934,
+      0.029124,
+      0.043008,
+      -0.027498,
+      -0.01154,
+      0.077611,
+      0.011107,
+      0.017181,
+      -0.104329,
+      -0.026596,
+      -0.014924,
+      -0.028782,
+      0.141499,
+      -0.035485,
+      0.039381,
+      0.050197,
+      -0.110647,
+      -0.036821,
+      0.004293,
+      0.110957,
+      0.065074,
+      -0.004211,
+      0.002122,
+      -0.004567,
+      -0.053976,
+      0.041616,
+      0.035282,
+      0.064579,
+      -0.013226,
+      0.001186,
+      0.002562,
+      0.015347,
+      -0.040773,
+      -0.053733,
+      -0.016394,
+      -0.010568,
+      0.086682,
+      -0.102699,
+      0.07812,
+      0.095577,
+      -0.0718,
+      -0.046016,
+      0.005025,
+      -0.00464,
+      -0.010156,
+      0.062645,
+      0.043581,
+      0.000652,
+      -0.043613,
+      -0.09959,
+      -0.098026,
+      -0.001777,
+      -0.092725,
+      -0.017737,
+      -0.038826,
+      0.099101,
+      -0.053311,
+      -0.017221,
+      -0.048884,
+      0.031643,
+      -0.043493,
+      0.022648,
+      0.023167,
+      0.028654,
+      -0.039465,
+      -0.03605,
+      0.024075,
+      0.025167,
+      -0.009573,
+      0.021965,
+      -0.058224,
+      -0.014322,
+      -0.016385,
+      -0.030558,
+      -0.023165,
+      0.039085,
+      -0.104571,
+      -0.053916,
+      0.022484,
+      -0.041342,
+      -0.026547,
+      0.062516,
+      0.080766,
+      -0.031251,
+      -0.077949,
+      -0.039812,
+      0.020354,
+      -0.039404,
+      -0.02788,
+      0.095071,
+      0,
+      -0.019177,
+      -0.054055,
+      -0.04106,
+      0.121048,
+      0.018098,
+      -0.012103,
+      0.050167,
+      0.062529,
+      0.06516,
+      -0.067854,
+      -0.142932,
+      -0.065479,
+      0.03401,
+      0.018291,
+      0.00662,
+      0.017263,
+      -0.084967,
+      -0.084931,
+      -0.040871,
+      0.068499,
+      -0.006081,
+      0.028518,
+      0.01272,
+      0.040765,
+      -0.061218,
+      0.051864,
+      -0.053586,
+      0.012734,
+      0.050476,
+      -0.033555,
+      -0.012876,
+      -0.03266,
+      -0.036027,
+      -0.034343,
+      0.031232,
+      -0.045832,
+      -0.026046,
+      -0.045106,
+      -0.022189,
+      0.052303,
+      0.148105,
+      0.053327,
+      -0.096602,
+      0.082976,
+      0.051028,
+      -0.050745,
+      0.017046,
+      -0.052313,
+      0.026341,
+      -0.008634,
+      -0.026843,
+      -0.020066,
+      -0.000993,
+      0.039317,
+      0.038732,
+      -0.013711,
+      0.006932,
+      -0.05116,
+      -0.066961,
+      0.088423,
+      -0.022701,
+      0.037957,
+      0.091998,
+      -0.041963,
+      0.030588,
+      -0.013047,
+      0.014716,
+      -0.00989,
+      0.051775,
+      0.026816,
+      0.063491,
+      0.03454,
+      -0.064376,
+      0.020358,
+      0.085518,
+      0.02095,
+      -0.082453,
+      -0.063615,
+      -0.040563,
+      0.160185,
+      -0.003095,
+      -0.01277,
+      0.053957,
+      0.03222,
+      -0.01868,
+      -0.008404,
+      0.022125,
+      0.021827,
+      0.021795,
+      -0.035258,
+      0.008889,
+      -0.068012,
+      -0.015108,
+      0.025715,
+      -0.067644,
+      0,
+      -0.083674,
+      0.012183,
+      -0.020341,
+      0.034335,
+      0.089605,
+      -0.040813,
+      0.001039,
+      0.010921,
+      -0.049503,
+      -0.096625,
+      0.008112,
+      -0.048865,
+      0.023739,
+      0.043438,
+      0.062339,
+      -0.024015,
+      0.023132,
+      0.076787,
+      -0.062808,
+      -0.019599,
+      -0.027932,
+      0.046884,
+      -0.029853,
+      -0.069235,
+      0.013224,
+      0.009649,
+      0.063522,
+      0.114024,
+      0.001293,
+      -0.055516,
+      0.031937,
+      -0.031723,
+      0.137857,
+      0.054988,
+      0.006594,
+      -0.009234,
+      0.018876,
+      0.099226,
+      -0.025169,
+      -0.048515,
+      -0.038164,
+      0.079838,
+      -0.036058,
+      0.045096,
+      -0.01881,
+      -0.082686,
+      -0.100798,
+      -0.079543,
+      0.043087,
+      -0.038456,
+      -0.027638,
+      -0.014194,
+      0.023554,
+      0.090424,
+      -0.005536,
+      -0.032461,
+      -0.011123,
+      -0.008024,
+      -0.007556,
+      -0.035074,
+      0.017366,
+      -0.043167,
+      -0.001603,
+      0.050989
+    ]
+  },
   {
     "name": "get_site_knowledge",
     "description": "Retrieve site-specific learnings including known false positives, intended behaviors, and successful fix patterns.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recapt/mcp",
-  "version": "0.0.24",
+  "version": "0.0.27",
   "description": "MCP exposing recapt behavioral intelligence to AI coding agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",