@recapt/mcp 0.0.18-beta → 0.0.20-beta

package/templates/self-improvement-full.md

@@ -0,0 +1,91 @@
+---
+on:
+  schedule: daily
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: "Branch to analyze"
+        default: "main"
+      max_fixes:
+        description: "Maximum issues to fix"
+        default: "5"
+
+engine: { { ENGINE } }
+
+permissions:
+  contents: read
+  issues: read
+  pull-requests: read
+  actions: read
+
+mcp-servers:
+  recapt:
+    command: npx
+    args: ["@recapt/mcp@latest"]
+    env:
+      RECAPT_SECRET_KEY: "${{ secrets.RECAPT_SECRET_KEY }}"
+    allowed: ["*"]
+
+safe-outputs:
+  dispatch-workflow:
+    workflows:
+      - evaluate-worker
+      - fix-worker
+    max: 10
+---
+
+## Self-Improvement Orchestrator (Full)
+
+You are the orchestrator for the self-improvement workflow with parallel workers. Your job is to:
+
+1. Check and update PR statuses for pending fixes
+2. Dispatch evaluate-workers for deployed fixes ready for evaluation
+3. Run diagnostics to find new issues
+4. Triage and select issues to fix
+5. Dispatch fix-workers for each selected issue
+6. Wait for all workers to complete
+7. Generate a summary and complete the improvement run
+
+### Important: Autonomous Mode
+
+You are running in a GitHub Actions sandbox with NO human interaction possible. You must:
+
+- **Never wait for user input** - Make all decisions autonomously
+- **Never ask questions** - Proceed with reasonable defaults
+- **Complete all work in one run** - There is no "check back later"
+- **Dispatch workers for parallel execution** - Don't fix issues yourself
+
+{{DOMAIN_CONFIG}}
+
+### Context
+
+Get recent changes to understand what might have introduced issues:
+
+```bash
+git log --since="24 hours ago" --oneline
+```
+
+### Workflow
+
+Follow the self-improvement orchestrator workflow. The recapt MCP server is connected and provides all necessary tools.
+
+The workflow covers:
+
+1. Starting an improvement run to track progress
+2. Checking PR statuses for waiting fixes
+3. Dispatching evaluate-workers for deployed fixes
+4. Running diagnostics to find current UX issues
+5. Triaging and selecting high-priority issues
+6. Dispatching fix-workers (one per issue, parallel execution)
+7. Waiting for all workers to complete
+8. Generating summary and completing the run
+
+### Output
+
+Summarize the run:
+
+1. **PR Status Updates**: How many PRs were checked, merged, dismissed
+2. **Evaluations**: How many fixes were evaluated, results
+3. **Diagnostics**: Site health score, key findings
+4. **Fixes Dispatched**: Which issues are being fixed by workers
+5. **Deferred/Dismissed**: Which issues were skipped and why

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

@@ -6,6 +6,9 @@ on:
       branch:
         description: "Branch to analyze"
         default: "main"
+      max_fixes:
+        description: "Maximum issues to fix"
+        default: "3"
 
 engine: { { ENGINE } }
 
@@ -28,11 +31,12 @@ safe-outputs:
     labels: [automated, ux-fix]
     base-branch: main
     draft: true
+    max: 1
 ---
 
-## Self-Improvement UX Fixes
+## Self-Improvement (Lite)
 
-You are a UX engineer using recapt behavioral intelligence to automatically detect and fix user friction points.
+You are a UX engineer using recapt behavioral intelligence to automatically detect and fix user friction points. This is the **lite** variant - you fix issues directly (no worker dispatch) and create a single PR with all changes.
 
 ### Important: Autonomous Mode
 
@@ -41,9 +45,8 @@ You are running in a GitHub Actions sandbox with NO human interaction possible.
 - **Never wait for user input** - Make all decisions autonomously
 - **Never ask questions** - Proceed with reasonable defaults
 - **Complete all work in one run** - There is no "check back later"
-- **Always track fixes** - Call `confirm_deployment` for every fix without asking
-- **Triage autonomously** - Fix high-confidence issues, skip ambiguous ones (document skipped issues in the PR)
-- **If data is insufficient** - Note it in the PR and proceed with available information
+- **Fix issues directly** - Do NOT dispatch workers, implement fixes yourself
+- **Create one PR** - All fixes go into a single pull request
 
 {{DOMAIN_CONFIG}}
 
@@ -57,19 +60,20 @@ git log --since="24 hours ago" --oneline
 
 ### Workflow
 
-Follow the self-improvement workflow defined in `.agents/recapt/self-improvement.md`. The recapt MCP server is connected and provides all necessary tools.
+Follow the self-improvement workflow. The recapt MCP server is connected and provides all necessary tools.
 
 The workflow covers:
 
 1. Checking and evaluating any pending fixes from previous runs
 2. Running diagnostics to find current UX issues
 3. Investigating and triaging high-priority issues
-4. Implementing code fixes for actionable issues
-5. Tracking fixes for future evaluation
+4. Implementing code fixes for actionable issues (sequentially)
+5. Creating a single PR with all fixes
+6. Tracking fixes for future evaluation
 
 ### Output
 
-Create a pull request containing:
+Create a single pull request containing:
 
 - Evaluation results for any previously deployed fixes (improved/regressed/no change)
 - New issues discovered and fixes implemented

package/dist/api/client.d.ts

@@ -1,14 +0,0 @@
-/**
- * HTTP client for calling external-api query endpoints.
- */
-export declare function isApiConfigured(): boolean;
-export declare function getApiUrl(): string;
-interface ApiResponse<T> {
-    data?: T;
-    error?: string;
-}
-export declare function apiGet<T>(path: string, params?: Record<string, string | number | undefined>): Promise<ApiResponse<T>>;
-export declare function apiPost<T>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
-export declare function apiPatch<T>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
-export declare function apiDelete<T>(path: string): Promise<ApiResponse<T>>;
-export {};

package/dist/api/client.js

@@ -1,67 +0,0 @@
-/**
- * HTTP client for calling external-api query endpoints.
- */
-const API_URL = process.env.RECAPT_API_URL ||
-    process.env.EXTERNAL_API_URL ||
-    "https://api.recapt.app";
-const SECRET_KEY = process.env.RECAPT_SECRET_KEY;
-const REQUEST_TIMEOUT_MS = 120_000;
-export function isApiConfigured() {
-    return !!SECRET_KEY;
-}
-export function getApiUrl() {
-    return API_URL;
-}
-async function request(options) {
-    const { method, path, params, body } = options;
-    if (!SECRET_KEY) {
-        return { error: "RECAPT_SECRET_KEY not configured" };
-    }
-    const url = new URL(`${API_URL}/v1beta/query${path}`);
-    if (params) {
-        for (const [key, value] of Object.entries(params)) {
-            if (value !== undefined) {
-                url.searchParams.set(key, String(value));
-            }
-        }
-    }
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-    try {
-        const res = await fetch(url.toString(), {
-            method,
-            headers: {
-                "x-private-key": SECRET_KEY,
-                "Content-Type": "application/json",
-            },
-            body: body ? JSON.stringify(body) : undefined,
-            signal: controller.signal,
-        });
-        clearTimeout(timeout);
-        if (!res.ok) {
-            const errorBody = (await res.json().catch(() => ({})));
-            return { error: errorBody.error || `HTTP ${res.status}` };
-        }
-        const data = (await res.json());
-        return { data };
-    }
-    catch (err) {
-        clearTimeout(timeout);
-        if (err instanceof Error && err.name === "AbortError") {
-            return { error: `Request timed out after ${REQUEST_TIMEOUT_MS / 1000}s` };
-        }
-        return { error: err instanceof Error ? err.message : String(err) };
-    }
-}
-export function apiGet(path, params) {
-    return request({ method: "GET", path, params });
-}
-export function apiPost(path, body = {}) {
-    return request({ method: "POST", path, body });
-}
-export function apiPatch(path, body = {}) {
-    return request({ method: "PATCH", path, body });
-}
-export function apiDelete(path) {
-    return request({ method: "DELETE", path });
-}

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

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

package/dist/cli/commands/setup-self-improvement-gh.js

@@ -1,310 +0,0 @@
-/**
- * Setup Self-Improvement GitHub Command
- *
- * Interactive wizard to set up the self-improvement agentic workflow for GitHub.
- */
-import { Command } from "commander";
-import { exec, execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { installSkill } from "./skill.js";
-import { confirm, select, multiSelect, input, header, print, success, error, info, warn, newline, } from "../utils/prompts.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const TEMPLATES_DIR = path.resolve(__dirname, "../../../templates");
-const WORKFLOW_TEMPLATE = "self-improvement.md";
-const WORKFLOW_DEST = ".github/workflows/self-improvement.md";
-const ENGINES = [
-    { id: "claude", name: "Claude (Anthropic)", secretName: "ANTHROPIC_API_KEY" },
-    { id: "copilot", name: "GitHub Copilot", secretName: "COPILOT_GITHUB_TOKEN" },
-    { id: "codex", name: "Codex (OpenAI)", secretName: "OPENAI_API_KEY" },
-];
-const API_URL = process.env.RECAPT_API_URL ||
-    process.env.EXTERNAL_API_URL ||
-    "https://api.recapt.app";
-async function fetchDomains(secretKey) {
-    try {
-        const res = await fetch(`${API_URL}/v1beta/query/domains`, {
-            headers: {
-                "x-private-key": secretKey,
-                "Content-Type": "application/json",
-            },
-        });
-        if (!res.ok) {
-            return null;
-        }
-        const data = (await res.json());
-        return data;
-    }
-    catch {
-        return null;
-    }
-}
-function commandExists(cmd) {
-    try {
-        execSync(`which ${cmd}`, { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function ghExtensionInstalled(extension) {
-    try {
-        const output = execSync("gh extension list", { encoding: "utf-8" });
-        return output.includes(extension);
-    }
-    catch {
-        return false;
-    }
-}
-function isGitRepo() {
-    try {
-        execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function getRepoUrl() {
-    try {
-        const url = execSync("gh repo view --json url -q .url", {
-            encoding: "utf-8",
-        }).trim();
-        return url || null;
-    }
-    catch {
-        return null;
-    }
-}
-function openBrowser(url) {
-    const platform = process.platform;
-    let command;
-    switch (platform) {
-        case "darwin":
-            command = `open "${url}"`;
-            break;
-        case "win32":
-            command = `start "" "${url}"`;
-            break;
-        default:
-            command = `xdg-open "${url}"`;
-    }
-    exec(command, (err) => {
-        if (err) {
-            info(`Could not open browser automatically. Please visit: ${url}`);
-        }
-    });
-}
-async function runSetupSelfImprovementGh() {
-    header("Recapt Self-Improvement GitHub Setup");
-    const cwd = process.cwd();
-    print("Checking prerequisites...");
-    newline();
-    const hasGh = commandExists("gh");
-    print(`  ${hasGh ? "[x]" : "[ ]"} gh CLI installed`);
-    if (!hasGh) {
-        newline();
-        error("GitHub CLI (gh) is required but not installed.");
-        info("Install it from: https://cli.github.com/");
-        process.exit(1);
-    }
-    const hasGhAw = ghExtensionInstalled("github/gh-aw");
-    print(`  ${hasGhAw ? "[x]" : "[ ]"} gh-aw extension installed`);
-    if (!hasGhAw) {
-        newline();
-        const shouldInstall = await confirm("gh-aw extension is required. Install it now?", true);
-        if (shouldInstall) {
-            print("Installing gh-aw extension...");
-            try {
-                execSync("gh extension install github/gh-aw", { stdio: "inherit" });
-                success("gh-aw extension installed");
-            }
-            catch {
-                error("Failed to install gh-aw extension");
-                info("Try manually: gh extension install github/gh-aw");
-                process.exit(1);
-            }
-        }
-        else {
-            error("gh-aw extension is required to continue.");
-            process.exit(1);
-        }
-    }
-    const inGitRepo = isGitRepo();
-    print(`  ${inGitRepo ? "[x]" : "[ ]"} Git repository detected`);
-    if (!inGitRepo) {
-        newline();
-        error("This command must be run from within a git repository.");
-        process.exit(1);
-    }
-    newline();
-    const engineOptions = ENGINES.map((engine) => ({
-        label: `${engine.name} (requires ${engine.secretName} secret)`,
-        value: engine,
-    }));
-    const selectedEngine = await select("Which AI engine do you want to use?", engineOptions);
-    if (!selectedEngine) {
-        error("No engine selected.");
-        process.exit(1);
-    }
-    newline();
-    // Domain selection
-    print("Configuring domain filter...");
-    info("You can optionally limit the workflow to specific domains.");
-    newline();
-    let selectedDomains = [];
-    const recaptKey = await input("Enter your RECAPT_SECRET_KEY to fetch domains (or press Enter to skip)");
-    if (recaptKey) {
-        const domains = await fetchDomains(recaptKey);
-        if (domains && domains.length > 0) {
-            const domainOptions = [
-                { label: "All domains", value: "__all__", selected: true },
-                ...domains.map((d) => ({
-                    label: d.domainName,
-                    value: d.domainName,
-                    selected: false,
-                })),
-            ];
-            const selected = await multiSelect("Which domains should this workflow analyze?", domainOptions);
-            if (!selected.includes("__all__") && selected.length > 0) {
-                selectedDomains = selected;
-                success(`Selected domains: ${selectedDomains.join(", ")}`);
-            }
-            else {
-                info("Will analyze all domains");
-            }
-        }
-        else {
-            warn("Could not fetch domains. Will analyze all domains.");
-        }
-    }
-    else {
-        const manualDomain = await input("Enter a specific domain to filter (or press Enter for all domains)");
-        if (manualDomain) {
-            selectedDomains = [manualDomain];
-            success(`Selected domain: ${manualDomain}`);
-        }
-        else {
-            info("Will analyze all domains");
-        }
-    }
-    newline();
-    print("Installing self-improvement skill...");
-    const skillInstalled = installSkill(cwd, "self-improvement", true);
-    if (!skillInstalled) {
-        error("Failed to install self-improvement skill");
-        process.exit(1);
-    }
-    newline();
-    print("Creating workflow...");
-    const templatePath = path.join(TEMPLATES_DIR, WORKFLOW_TEMPLATE);
-    const destPath = path.join(cwd, WORKFLOW_DEST);
-    const destDir = path.dirname(destPath);
-    if (!fs.existsSync(templatePath)) {
-        error(`Workflow template not found: ${templatePath}`);
-        process.exit(1);
-    }
-    if (!fs.existsSync(destDir)) {
-        fs.mkdirSync(destDir, { recursive: true });
-    }
-    const templateContent = fs.readFileSync(templatePath, "utf-8");
-    // Build domain config section
-    let domainConfig = "";
-    if (selectedDomains.length > 0) {
-        const domainList = selectedDomains.join(", ");
-        domainConfig = `### Domain Restriction
-
-**Target domains:** ${domainList}
-
-Before doing any work:
-1. Call \`get_domains\` to verify the target domain(s) exist
-2. If any target domain is NOT in the list, stop immediately and report: "Domain not found: [domain]. Available domains: [list]"
-3. If domains are valid, pass the \`domain\` parameter to all tools that support filtering (e.g., \`run_full_diagnostic\`, \`get_page_metrics\`, etc.)
-
-Do NOT analyze or fix issues for domains not in the target list.
-
-`;
-    }
-    else {
-        domainConfig = `### Domain Scope
-
-**Target:** All domains
-
-Analyze and fix issues across all domains configured in recapt. Call \`get_domains\` first to see available domains.
-
-`;
-    }
-    // Replace placeholders (support both {{VAR}} and { { VAR } } formats)
-    const workflowContent = templateContent
-        .replace(/\{\s*\{\s*ENGINE\s*\}\s*\}/g, selectedEngine.id)
-        .replace(/\{\s*\{\s*DOMAIN_CONFIG\s*\}\s*\}/g, domainConfig);
-    if (fs.existsSync(destPath)) {
-        const overwrite = await confirm("Workflow file already exists. Overwrite?", false);
-        if (!overwrite) {
-            info("Skipping workflow creation");
-        }
-        else {
-            fs.writeFileSync(destPath, workflowContent);
-            success(`Created: ${WORKFLOW_DEST}`);
-        }
-    }
-    else {
-        fs.writeFileSync(destPath, workflowContent);
-        success(`Created: ${WORKFLOW_DEST}`);
-    }
-    newline();
-    print("Compiling workflow...");
-    try {
-        execSync("gh aw compile", { cwd, stdio: "inherit" });
-        success("Created: .github/workflows/self-improvement.lock.yml");
-    }
-    catch {
-        warn("Failed to compile workflow. You can run 'gh aw compile' manually.");
-    }
-    newline();
-    print("GitHub Secrets Required:");
-    info(`1. ${selectedEngine.secretName} - For ${selectedEngine.name} to run the agent`);
-    info("2. RECAPT_SECRET_KEY - For recapt behavioral intelligence");
-    newline();
-    const repoUrl = getRepoUrl();
-    if (repoUrl) {
-        const secretsUrl = `${repoUrl}/settings/secrets/actions`;
-        const openSecrets = await confirm("Open GitHub secrets page?", true);
-        if (openSecrets) {
-            openBrowser(secretsUrl);
-            await new Promise((resolve) => setTimeout(resolve, 1000));
-        }
-    }
-    else {
-        info("Go to your repository Settings → Secrets and variables → Actions");
-        info(`Add ${selectedEngine.secretName} and RECAPT_SECRET_KEY as secrets.`);
-    }
-    newline();
-    success("Setup complete!");
-    newline();
-    print("Next steps:");
-    print('  1. git add . && git commit -m "Add recapt self-improvement workflow"');
-    print("  2. git push");
-    print("  3. Run manually: gh aw run self-improvement");
-    newline();
-    warn("Important: Enable PR creation permissions");
-    info("The workflow needs permission to create pull requests.");
-    info("Go to Settings → Actions → General → Workflow permissions");
-    info('Enable "Allow GitHub Actions to create and approve pull requests"');
-    info("(This may need to be set at the organization level)");
-    newline();
-}
-export const setupSelfImprovementGhCommand = new Command("setup-self-improvement-gh")
-    .description("Set up automated self-improvement workflow for GitHub Actions")
-    .action(async () => {
-    try {
-        await runSetupSelfImprovementGh();
-    }
-    catch (err) {
-        error(`Setup failed: ${err}`);
-        process.exit(1);
-    }
-});

package/dist/cli/commands/setup.d.ts

@@ -1,7 +0,0 @@
-/**
- * Setup Command
- *
- * Interactive wizard to configure recapt MCP server across AI IDEs.
- */
-import { Command } from "commander";
-export declare const setupCommand: Command;