@recapt/mcp 0.0.16-beta → 0.0.18-beta

package/dist/tools/diagnostic.d.ts

@@ -1,5 +1,5 @@
 /**
- * Diagnostic tools for self-healing workflow.
+ * Diagnostic tools for self-improvement workflow.
  *
  * Provides comprehensive site diagnostics, issue investigation, and validation.
  */

package/dist/tools/diagnostic.js

@@ -1,5 +1,5 @@
 /**
- * Diagnostic tools for self-healing workflow.
+ * Diagnostic tools for self-improvement workflow.
  *
  * Provides comprehensive site diagnostics, issue investigation, and validation.
  */

package/dist/tools/improvementRun.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Improvement Run tools for tracking self-improvement workflow executions.
+ *
+ * Provides run registration, phase updates, action recording, and run listing.
+ */
+export declare function registerImprovementRunTools(server: any): void;

package/dist/tools/{healingRun.js → improvementRun.js}

@@ -1,18 +1,18 @@
 /**
- * Healing Run tools for tracking self-healing workflow executions.
+ * Improvement Run tools for tracking self-improvement workflow executions.
  *
  * Provides run registration, phase updates, action recording, and run listing.
  */
 import { z } from "zod";
 import { apiGet, apiPost, apiPatch, isApiConfigured } from "../api/client.js";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerHealingRunTools(server) {
-    server.registerTool("start_healing_run", {
-        description: "Register the start of a self-healing workflow run. Call this at the beginning of a healing session to track the run and its outcomes. Returns a run ID to use for subsequent updates.",
+export function registerImprovementRunTools(server) {
+    server.registerTool("start_improvement_run", {
+        description: "Register the start of a self-improvement workflow run. Call this at the beginning of an improvement session to track the run and its outcomes. Returns a run ID to use for subsequent updates.",
         inputSchema: z.object({
             trigger_type: z
                 .enum(["github_actions", "cron", "manual", "api"])
-                .describe("What triggered this healing run"),
+                .describe("What triggered this improvement run"),
             trigger_metadata: z
                 .record(z.unknown())
                 .optional()
@@ -39,7 +39,7 @@ export function registerHealingRunTools(server) {
                 isError: true,
             };
         }
-        const { data, error } = await apiPost("/healing-runs", {
+        const { data, error } = await apiPost("/improvement-runs", {
             trigger_type,
             trigger_metadata,
             phases,
@@ -52,10 +52,10 @@ export function registerHealingRunTools(server) {
         }
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
     });
-    server.registerTool("update_healing_run", {
-        description: "Update a healing run's status, phases, or summary. Use to track progress through the workflow phases and record final outcomes.",
+    server.registerTool("update_improvement_run", {
+        description: "Update an improvement run's status, phases, or summary. Use to track progress through the workflow phases and record final outcomes.",
         inputSchema: z.object({
-            run_id: z.string().describe("The ID of the healing run to update"),
+            run_id: z.string().describe("The ID of the improvement run to update"),
             status: z
                 .enum(["running", "completed", "failed", "cancelled"])
                 .optional()
@@ -107,7 +107,7 @@ export function registerHealingRunTools(server) {
                 isError: true,
             };
         }
-        const { data, error } = await apiPatch(`/healing-runs/${run_id}`, {
+        const { data, error } = await apiPatch(`/improvement-runs/${run_id}`, {
             status,
             phases,
             summary,
@@ -122,12 +122,12 @@ export function registerHealingRunTools(server) {
         }
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
     });
-    server.registerTool("record_healing_action", {
-        description: "Record an action taken during a healing run. Use to track what was done for each issue: code fixes, deferrals, dismissals, etc. " +
+    server.registerTool("record_improvement_action", {
+        description: "Record an action taken during an improvement run. Use to track what was done for each issue: code fixes, deferrals, dismissals, etc. " +
             "IMPORTANT: When recording code_fix actions, the code_changes.diff field must contain ACTUAL SOURCE CODE in unified diff format, " +
             "not a description of what changed. Include the literal code lines with proper +/- prefixes.",
         inputSchema: z.object({
-            run_id: z.string().describe("The ID of the healing run"),
+            run_id: z.string().describe("The ID of the improvement run"),
             issue_id: z
                 .string()
                 .optional()
@@ -216,7 +216,7 @@ export function registerHealingRunTools(server) {
                 isError: true,
             };
         }
-        const { data, error } = await apiPost(`/healing-runs/${run_id}/actions`, {
+        const { data, error } = await apiPost(`/improvement-runs/${run_id}/actions`, {
             issue_id,
             action_type,
             hypothesis,
@@ -236,10 +236,12 @@ export function registerHealingRunTools(server) {
         }
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
     });
-    server.registerTool("get_healing_run", {
-        description: "Get details of a specific healing run including all actions taken. Use to review what happened during a run.",
+    server.registerTool("get_improvement_run", {
+        description: "Get details of a specific improvement run including all actions taken. Use to review what happened during a run.",
         inputSchema: z.object({
-            run_id: z.string().describe("The ID of the healing run to retrieve"),
+            run_id: z
+                .string()
+                .describe("The ID of the improvement run to retrieve"),
         }),
     }, async ({ run_id }) => {
         if (!isApiConfigured()) {
@@ -253,7 +255,7 @@ export function registerHealingRunTools(server) {
                 isError: true,
             };
         }
-        const { data, error } = await apiGet(`/healing-runs/${run_id}`);
+        const { data, error } = await apiGet(`/improvement-runs/${run_id}`);
         if (error) {
             return {
                 content: [{ type: "text", text: JSON.stringify({ error }) }],
@@ -262,8 +264,8 @@ export function registerHealingRunTools(server) {
         }
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
     });
-    server.registerTool("list_healing_runs", {
-        description: "List recent healing runs with optional filters. Use to review past runs and their outcomes.",
+    server.registerTool("list_improvement_runs", {
+        description: "List recent improvement runs with optional filters. Use to review past runs and their outcomes.",
         inputSchema: z.object({
             status: z
                 .enum(["running", "completed", "failed", "cancelled"])
@@ -296,7 +298,7 @@ export function registerHealingRunTools(server) {
                 isError: true,
             };
         }
-        const { data, error } = await apiGet("/healing-runs", {
+        const { data, error } = await apiGet("/improvement-runs", {
             status,
             trigger_type,
             limit: limit ?? 20,

package/dist/tools/knowledge.d.ts

@@ -1,5 +1,5 @@
 /**
- * Knowledge tools for self-healing workflow.
+ * Knowledge tools for self-improvement workflow.
  *
  * Provides site-specific knowledge management for learning from past fixes.
  */

package/dist/tools/knowledge.js

@@ -1,5 +1,5 @@
 /**
- * Knowledge tools for self-healing workflow.
+ * Knowledge tools for self-improvement workflow.
  *
  * Provides site-specific knowledge management for learning from past fixes.
  */
@@ -24,7 +24,7 @@ const ISSUE_CATEGORIES = [
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function registerKnowledgeTools(server) {
     server.registerTool("get_site_knowledge", {
-        description: "Retrieve site-specific learnings including known false positives, intended behaviors, and successful fix patterns. Use at the start of a self-healing workflow to avoid re-flagging known issues.",
+        description: "Retrieve site-specific learnings including known false positives, intended behaviors, and successful fix patterns. Use at the start of a self-improvement workflow to avoid re-flagging known issues.",
         inputSchema: z.object({
             category: z
                 .enum(KNOWLEDGE_CATEGORIES)

package/dist/tools/remediation.d.ts

@@ -1,5 +1,5 @@
 /**
- * Remediation tools for self-healing workflow.
+ * Remediation tools for self-improvement workflow.
  *
  * Provides fix proposal, deployment confirmation, evaluation, and history tracking.
  */

package/dist/tools/remediation.js

@@ -1,5 +1,5 @@
 /**
- * Remediation tools for self-healing workflow.
+ * Remediation tools for self-improvement workflow.
  *
  * Provides fix proposal, deployment confirmation, evaluation, and history tracking.
  */

package/dist/tools/triage.d.ts

@@ -1,5 +1,5 @@
 /**
- * Triage tools for self-healing workflow.
+ * Triage tools for self-improvement workflow.
  *
  * Provides issue dismissal, marking intended behavior, and issue history.
  */

package/dist/tools/triage.js

@@ -1,5 +1,5 @@
 /**
- * Triage tools for self-healing workflow.
+ * Triage tools for self-improvement workflow.
  *
  * Provides issue dismissal, marking intended behavior, and issue history.
  */

package/package.json

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

package/skills/{self-healing.md → self-improvement.md}

@@ -1,13 +1,13 @@
-# Recapt Self-Healing Workflow
+# Recapt Self-Improvement Workflow
 
-Use this workflow when asked to "heal the site" or improve UX based on behavioral data from recapt.
+Use this workflow when asked to "improve the site" or enhance UX based on behavioral data from recapt.
 
 ## When to Use
 
 This is a **comprehensive site improvement workflow**. Only use it when the user explicitly requests a full-site analysis:
 
-- "Heal my site"
-- "Run the self-healing workflow"
+- "Improve my site"
+- "Run the self-improvement workflow"
 - "Analyze my whole site and improve it"
 - "Do a full UX audit"
 - "Make general improvements across the site"
@@ -19,12 +19,12 @@ This is a **comprehensive site improvement workflow**. Only use it when the user
 
 ## Run Tracking
 
-At the start of each healing session, register the run to track progress and outcomes:
+At the start of each improvement session, register the run to track progress and outcomes:
 
-- Search: "healing run" → `start_healing_run`, `update_healing_run`, `record_healing_action`
+- Search: "improvement run" → `start_improvement_run`, `update_improvement_run`, `record_improvement_action`
 
 ```
-const response = await start_healing_run({
+const response = await start_improvement_run({
   trigger_type: "manual",  // or "github_actions", "cron", "api"
   trigger_metadata: { ... },  // optional: branch, actor, etc.
   phases: [
@@ -39,7 +39,7 @@ const response = await start_healing_run({
 const run_id = response.id;  // e.g., "682d1a2b3c4d5e6f7a8b9c0d"
 ```
 
-This creates a run record visible in the Healing Runs UI. **You must update the run as you progress through each phase.**
+This creates a run record visible in the Improvement Runs UI. **You must update the run as you progress through each phase.**
 
 ### Phase Progress Updates
 
@@ -48,7 +48,7 @@ Update the run status at each phase transition. Always pass the complete phases
 **After starting diagnose:**
 
 ```
-update_healing_run({
+update_improvement_run({
   run_id: "<run_id>",
   phases: [
     { name: "diagnose", status: "running", startedAt: new Date().toISOString() },
@@ -62,7 +62,7 @@ update_healing_run({
 **After completing diagnose (before investigate):**
 
 ```
-update_healing_run({
+update_improvement_run({
   run_id: "<run_id>",
   phases: [
     { name: "diagnose", status: "completed", completedAt: new Date().toISOString(), output: { issuesFound: 5, opportunitiesFound: 3 } },
@@ -77,7 +77,7 @@ update_healing_run({
 **After completing investigate (before fix):**
 
 ```
-update_healing_run({
+update_improvement_run({
   run_id: "<run_id>",
   phases: [
     { name: "diagnose", status: "completed", completedAt: "...", output: { ... } },
@@ -91,7 +91,7 @@ update_healing_run({
 **After completing fix (before track):**
 
 ```
-update_healing_run({
+update_improvement_run({
   run_id: "<run_id>",
   phases: [
     { name: "diagnose", status: "completed", completedAt: "...", output: { ... } },
@@ -106,7 +106,7 @@ update_healing_run({
 **After completing track (run complete):**
 
 ```
-update_healing_run({
+update_improvement_run({
   run_id: "<run_id>",
   status: "completed",
   completed_at: new Date().toISOString(),
@@ -255,22 +255,58 @@ Implement code changes to address issues and opportunities. After making changes
 
 **Note:** `propose_fix` accepts either `issue_id` (for formal issues) or `page_path` + `element_selector` (for element friction fixes without a formal issue).
 
-**Record each action in the healing run:**
+**Record each action in the improvement run.** You MUST call `record_improvement_action` for EVERY issue — whether fixed, deferred, or dismissed. The UI tabs are populated from these action records, not from the summary counters.
+
+**For code fixes:**
 
 ```
-record_healing_action({
+record_improvement_action({
   run_id: "<run_id>",
   issue_id: "<issue_id>",  // optional - omit for element friction fixes
-  action_type: "code_fix",  // or "needs_more_data", "dismissed", "marked_intended"
+  action_type: "code_fix",
   hypothesis: "The checkout button is unresponsive due to a JS error...",
   expected_improvement: "Fixing the error handler should reduce rage clicks by 50%",
-  code_changes: [{ file: "checkout.tsx", diff: "...", linesAdded: 5, linesRemoved: 2 }],
+  code_changes: [{
+    file: "src/components/Checkout.tsx",
+    startLine: 45,  // line number where the change starts
+    linesAdded: 5,
+    linesRemoved: 2,
+    diff: "@@ -45,7 +45,10 @@\n-  const handleClick = () => {\n+  const handleClick = async () => {\n+    try {\n       await processPayment();\n+    } catch (err) {\n+      setError(err.message);\n+    }\n   };"
+  }],
   pr_url: "https://github.com/...",
   pr_number: 123,
   remediation_id: "<remediation_id>"  // from propose_fix response.id
 })
 ```
 
+**CRITICAL: The `diff` field must contain actual unified diff format** (like `git diff` output), NOT a description of what changed. Include the `@@` hunk header, `-` for removed lines, `+` for added lines. The UI renders this as a syntax-highlighted diff viewer.
+
+**For deferred issues (needs more data):**
+
+```
+record_improvement_action({
+  run_id: "<run_id>",
+  issue_id: "<issue_id>",
+  action_type: "needs_more_data",
+  hypothesis: "Users may be rage-clicking the save button, but only 3 sessions show this pattern.",
+  expected_improvement: "With more data, we can confirm if this is a real issue or noise.",
+  deferral_reason: "Only 3 sessions in the last 7 days. Need at least 10 sessions to validate."
+})
+```
+
+**For dismissed issues:**
+
+```
+record_improvement_action({
+  run_id: "<run_id>",
+  issue_id: "<issue_id>",
+  action_type: "dismissed",  // or "marked_intended"
+  hypothesis: "Rage clicks detected on the copy-to-clipboard button.",
+  expected_improvement: "N/A - this is expected behavior.",
+  dismissal_reason: "Users click multiple times to confirm the copy action. This is intentional UX."
+})
+```
+
 For flow optimizations, common fixes include:
 
 - Adding missing information to reduce backtracking
@@ -287,10 +323,10 @@ Mark fixes as deployed so recapt can measure impact:
 
 - Search: "deployment" → `confirm_deployment`, `evaluate_fix`, `list_pending_fixes`
 
-**Complete the healing run when done:**
+**Complete the improvement run when done:**
 
 ```
-update_healing_run({
+update_improvement_run({
   run_id: "<run_id>",
   status: "completed",
   completed_at: new Date().toISOString(),
@@ -333,29 +369,29 @@ If the user agrees:
 
 ## Tool Discovery Reference
 
-| Phase         | Search Query        | Tools                                                                                   |
-| ------------- | ------------------- | --------------------------------------------------------------------------------------- |
-| Run Tracking  | "healing run"       | `start_healing_run`, `update_healing_run`, `record_healing_action`, `list_healing_runs` |
-| Check Pending | "pending fixes"     | `list_pending_fixes`, `evaluate_fix`                                                    |
-| Diagnose      | (always available)  | `run_full_diagnostic`                                                                   |
-| Journey       | "journey patterns"  | `get_journey_patterns`                                                                  |
-| Funnels       | "analyze funnel"    | `analyze_funnel`                                                                        |
-| Flows         | "analyze flow"      | `analyze_flow`, `get_flow_friction`                                                     |
-| Personas      | "personas"          | `discover_personas`                                                                     |
-| Compare       | "compare cohorts"   | `compare_cohorts`                                                                       |
-| Investigate   | "investigate issue" | `investigate_issue`, `validate_issue`                                                   |
-| Triage        | "dismiss issue"     | `dismiss_issue`, `mark_intended_behavior`                                               |
-| Fix           | "propose fix"       | `propose_fix`, `get_similar_fixes`, `get_fix_history`                                   |
-| Track         | "deployment"        | `confirm_deployment`, `evaluate_fix`, `list_pending_fixes`                              |
-| Learn         | "site knowledge"    | `get_site_knowledge`, `add_site_knowledge`                                              |
+| Phase         | Search Query        | Tools                                                                                                   |
+| ------------- | ------------------- | ------------------------------------------------------------------------------------------------------- |
+| Run Tracking  | "improvement run"   | `start_improvement_run`, `update_improvement_run`, `record_improvement_action`, `list_improvement_runs` |
+| Check Pending | "pending fixes"     | `list_pending_fixes`, `evaluate_fix`                                                                    |
+| Diagnose      | (always available)  | `run_full_diagnostic`                                                                                   |
+| Journey       | "journey patterns"  | `get_journey_patterns`                                                                                  |
+| Funnels       | "analyze funnel"    | `analyze_funnel`                                                                                        |
+| Flows         | "analyze flow"      | `analyze_flow`, `get_flow_friction`                                                                     |
+| Personas      | "personas"          | `discover_personas`                                                                                     |
+| Compare       | "compare cohorts"   | `compare_cohorts`                                                                                       |
+| Investigate   | "investigate issue" | `investigate_issue`, `validate_issue`                                                                   |
+| Triage        | "dismiss issue"     | `dismiss_issue`, `mark_intended_behavior`                                                               |
+| Fix           | "propose fix"       | `propose_fix`, `get_similar_fixes`, `get_fix_history`                                                   |
+| Track         | "deployment"        | `confirm_deployment`, `evaluate_fix`, `list_pending_fixes`                                              |
+| Learn         | "site knowledge"    | `get_site_knowledge`, `add_site_knowledge`                                                              |
 
 ## Response Formats
 
-Healing run tools return objects with an `id` field. Extract and store these IDs for subsequent calls.
+Improvement run tools return objects with an `id` field. Extract and store these IDs for subsequent calls.
 
 **Note:** Response formats for `propose_fix` and `add_site_knowledge` are documented in their tool descriptions (discoverable via `search_tools`).
 
-### start_healing_run
+### start_improvement_run
 
 ```json
 {
@@ -385,14 +421,14 @@ Healing run tools return objects with an `id` field. Extract and store these IDs
 }
 ```
 
-**Extract:** `response.id` → use as `run_id` in `update_healing_run` and `record_healing_action`
+**Extract:** `response.id` → use as `run_id` in `update_improvement_run` and `record_improvement_action`
 
-### record_healing_action
+### record_improvement_action
 
 ```json
 {
   "id": "682d1a2b3c4d5e6f7a8b9c11",
-  "healingRunId": "682d1a2b3c4d5e6f7a8b9c0d",
+  "improvementRunId": "682d1a2b3c4d5e6f7a8b9c0d",
   "issueId": "682d1a2b3c4d5e6f7a8b9c0f",
   "actionType": "code_fix",
   "outcome": {

package/templates/{self-healing.md → self-improvement.md}

@@ -24,13 +24,13 @@ mcp-servers:
 
 safe-outputs:
   create-pull-request:
-    title-prefix: "[self-healing] "
+    title-prefix: "[self-improvement] "
     labels: [automated, ux-fix]
     base-branch: main
     draft: true
 ---
 
-## Self-Healing UX Fixes
+## Self-Improvement UX Fixes
 
 You are a UX engineer using recapt behavioral intelligence to automatically detect and fix user friction points.
 
@@ -57,7 +57,7 @@ git log --since="24 hours ago" --oneline
 
 ### Workflow
 
-Follow the self-healing workflow defined in `.agents/recapt/self-healing.md`. The recapt MCP server is connected and provides all necessary tools.
+Follow the self-improvement workflow defined in `.agents/recapt/self-improvement.md`. The recapt MCP server is connected and provides all necessary tools.
 
 The workflow covers:
 

package/dist/cli/commands/setup-self-healing-gh.d.ts

@@ -1,7 +0,0 @@
-/**
- * Setup Self-Healing GitHub Command
- *
- * Interactive wizard to set up the self-healing agentic workflow for GitHub.
- */
-import { Command } from "commander";
-export declare const setupSelfHealingGhCommand: Command;

package/dist/tools/healingRun.d.ts

@@ -1,6 +0,0 @@
-/**
- * Healing Run tools for tracking self-healing workflow executions.
- *
- * Provides run registration, phase updates, action recording, and run listing.
- */
-export declare function registerHealingRunTools(server: any): void;