@fasttest-ai/qa-agent 0.4.2 → 1.0.0

package/dist/install.js

@@ -1,370 +1,18 @@
-/**
- * FastTest Agent installer — supports Claude Code, Cursor, Windsurf, VS Code, and Codex.
- * Registers the MCP server, sets up permissions (where supported), and installs Playwright.
- *
- * Usage:
- *   npx @fasttest-ai/qa-agent install                  # Interactive IDE picker
- *   npx @fasttest-ai/qa-agent install --ide cursor      # Skip prompt
- *   npx @fasttest-ai/qa-agent install --ide claude-code --scope project
- *   npx @fasttest-ai/qa-agent uninstall
- */
-import { execFileSync } from "node:child_process";
-import { createInterface } from "node:readline";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir, platform } from "node:os";
-import { join } from "node:path";
-const IS_WINDOWS = platform() === "win32";
-const IS_MAC = platform() === "darwin";
-const MCP_SERVER_NAME = "fasttest";
-const NPX_CMD = IS_WINDOWS ? "npx.cmd" : "npx";
-const MCP_COMMAND = "npx";
-const MCP_ARGS = ["-y", "@fasttest-ai/qa-agent@latest"];
-const IDE_CONFIGS = [
-    {
-        id: "claude-code",
-        label: "Claude Code",
-        globalConfigPath: "", // Uses CLI, not direct file write
-        format: "cli",
-        hasPermissions: true,
-    },
-    {
-        id: "cursor",
-        label: "Cursor",
-        globalConfigPath: join(homedir(), ".cursor", "mcp.json"),
-        format: "json-mcpServers",
-        hasPermissions: false,
-    },
-    {
-        id: "windsurf",
-        label: "Windsurf",
-        globalConfigPath: join(homedir(), ".codeium", "windsurf", "mcp_config.json"),
-        format: "json-mcpServers",
-        hasPermissions: false,
-    },
-    {
-        id: "vscode",
-        label: "VS Code / Copilot",
-        globalConfigPath: IS_MAC
-            ? join(homedir(), "Library", "Application Support", "Code", "User", "mcp.json")
-            : IS_WINDOWS
-                ? join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "Code", "User", "mcp.json")
-                : join(homedir(), ".config", "Code", "User", "mcp.json"),
-        format: "json-servers",
-        hasPermissions: false,
-    },
-    {
-        id: "codex",
-        label: "Codex",
-        globalConfigPath: join(homedir(), ".codex", "config.toml"),
-        format: "toml",
-        hasPermissions: false,
-    },
-];
-function parseArgs() {
-    const action = process.argv[2];
-    const rest = process.argv.slice(3);
-    let ide = null;
-    let scope = "user";
-    let skipPermissions = false;
-    for (let i = 0; i < rest.length; i++) {
-        if (rest[i] === "--ide" && rest[i + 1]) {
-            ide = rest[++i];
-        }
-        else if (rest[i] === "--scope" && rest[i + 1]) {
-            scope = rest[++i];
-        }
-        else if (rest[i] === "--skip-permissions") {
-            skipPermissions = true;
-        }
-    }
-    return { action, ide, scope, skipPermissions };
-}
-// ---------------------------------------------------------------------------
-// Interactive IDE picker
-// ---------------------------------------------------------------------------
-function askQuestion(prompt) {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    return new Promise((resolve) => {
-        rl.question(prompt, (answer) => {
-            rl.close();
-            resolve(answer.trim());
-        });
-    });
-}
-async function pickIde() {
-    console.log("  Which IDE do you use?\n");
-    IDE_CONFIGS.forEach((ide, i) => {
-        console.log(`    ${i + 1}. ${ide.label}`);
-    });
-    console.log();
-    const answer = await askQuestion("  > ");
-    const idx = parseInt(answer, 10) - 1;
-    if (idx >= 0 && idx < IDE_CONFIGS.length) {
-        return IDE_CONFIGS[idx].id;
-    }
-    // Try matching by name
-    const match = IDE_CONFIGS.find((c) => c.id === answer.toLowerCase() || c.label.toLowerCase() === answer.toLowerCase());
-    if (match)
-        return match.id;
-    console.log("  Invalid selection, defaulting to Claude Code.\n");
-    return "claude-code";
-}
-// ---------------------------------------------------------------------------
-// Claude Code — CLI-based registration + permission management
-// ---------------------------------------------------------------------------
-function isClaudeCliAvailable() {
-    try {
-        execFileSync("claude", ["--version"], { stdio: "pipe", shell: IS_WINDOWS });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function registerClaudeCode(scope) {
-    const args = [
-        "mcp", "add", "--scope", scope,
-        MCP_SERVER_NAME, "--",
-        MCP_COMMAND, ...MCP_ARGS,
-    ];
-    try {
-        execFileSync("claude", args, { stdio: "inherit", shell: IS_WINDOWS });
-        return true;
-    }
-    catch {
-        try {
-            execFileSync("claude", ["mcp", "remove", "--scope", scope, MCP_SERVER_NAME], {
-                stdio: "pipe", shell: IS_WINDOWS,
-            });
-            execFileSync("claude", args, { stdio: "inherit", shell: IS_WINDOWS });
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-}
-function removeClaudeCode(scope) {
-    try {
-        execFileSync("claude", ["mcp", "remove", "--scope", scope, MCP_SERVER_NAME], {
-            stdio: "inherit", shell: IS_WINDOWS,
-        });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-const CLAUDE_DIR = join(homedir(), ".claude");
-const CLAUDE_SETTINGS_PATH = join(CLAUDE_DIR, "settings.json");
-const PERMISSION_ENTRY = "mcp__fasttest";
-function addClaudePermissions() {
-    if (!existsSync(CLAUDE_DIR))
-        mkdirSync(CLAUDE_DIR, { recursive: true });
-    let settings = {};
-    if (existsSync(CLAUDE_SETTINGS_PATH)) {
-        try {
-            settings = JSON.parse(readFileSync(CLAUDE_SETTINGS_PATH, "utf-8"));
-        }
-        catch {
-            const backup = CLAUDE_SETTINGS_PATH + ".bak";
-            writeFileSync(backup, readFileSync(CLAUDE_SETTINGS_PATH));
-            console.log(`        Warning: ${CLAUDE_SETTINGS_PATH} was corrupted. Backed up to ${backup}`);
-            settings = {};
-        }
-    }
-    if (!settings.permissions)
-        settings.permissions = {};
-    if (!Array.isArray(settings.permissions.allow))
-        settings.permissions.allow = [];
-    if (settings.permissions.allow.includes(PERMISSION_ENTRY)) {
-        return { added: false, alreadyExists: true };
-    }
-    settings.permissions.allow.push(PERMISSION_ENTRY);
-    writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
-    return { added: true, alreadyExists: false };
-}
-function removeClaudePermissions() {
-    if (!existsSync(CLAUDE_SETTINGS_PATH))
-        return false;
-    try {
-        const settings = JSON.parse(readFileSync(CLAUDE_SETTINGS_PATH, "utf-8"));
-        const allow = settings.permissions?.allow;
-        if (!Array.isArray(allow))
-            return false;
-        const idx = allow.indexOf(PERMISSION_ENTRY);
-        if (idx === -1)
-            return false;
-        allow.splice(idx, 1);
-        writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ---------------------------------------------------------------------------
-// JSON config writers (Cursor, Windsurf, VS Code)
-// ---------------------------------------------------------------------------
-/** Cursor & Windsurf: { "mcpServers": { "fasttest": { "command": ..., "args": ... } } } */
-function writeMcpServersJson(configPath) {
-    const dir = join(configPath, "..");
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    let config = {};
-    if (existsSync(configPath)) {
-        try {
-            config = JSON.parse(readFileSync(configPath, "utf-8"));
-        }
-        catch {
-            const backup = configPath + ".bak";
-            writeFileSync(backup, readFileSync(configPath));
-            console.log(`        Warning: ${configPath} was corrupted. Backed up to ${backup}`);
-            config = {};
-        }
-    }
-    if (!config.mcpServers || typeof config.mcpServers !== "object") {
-        config.mcpServers = {};
-    }
-    config.mcpServers[MCP_SERVER_NAME] = {
-        command: MCP_COMMAND,
-        args: [...MCP_ARGS],
-    };
-    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-    return true;
-}
-/** VS Code: { "servers": { "fasttest": { "type": "stdio", "command": ..., "args": ... } } } */
-function writeVscodeJson(configPath) {
-    const dir = join(configPath, "..");
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    let config = {};
-    if (existsSync(configPath)) {
-        try {
-            config = JSON.parse(readFileSync(configPath, "utf-8"));
-        }
-        catch {
-            const backup = configPath + ".bak";
-            writeFileSync(backup, readFileSync(configPath));
-            console.log(`        Warning: ${configPath} was corrupted. Backed up to ${backup}`);
-            config = {};
-        }
-    }
-    if (!config.servers || typeof config.servers !== "object") {
-        config.servers = {};
-    }
-    config.servers[MCP_SERVER_NAME] = {
-        type: "stdio",
-        command: MCP_COMMAND,
-        args: [...MCP_ARGS],
-    };
-    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-    return true;
-}
-// ---------------------------------------------------------------------------
-// Codex TOML config writer
-// ---------------------------------------------------------------------------
-function writeCodexToml(configPath) {
-    const dir = join(configPath, "..");
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    let content = "";
-    if (existsSync(configPath)) {
-        content = readFileSync(configPath, "utf-8");
-    }
-    const sectionHeader = `[mcp_servers.${MCP_SERVER_NAME}]`;
-    if (content.includes(sectionHeader)) {
-        // Replace existing section — find from header to next section or EOF
-        const regex = new RegExp(`\\[mcp_servers\\.${MCP_SERVER_NAME}\\][\\s\\S]*?(?=\\n\\[|$)`);
-        content = content.replace(regex, buildCodexSection());
-    }
-    else {
-        // Append
-        if (content.length > 0 && !content.endsWith("\n"))
-            content += "\n";
-        content += "\n" + buildCodexSection() + "\n";
-    }
-    writeFileSync(configPath, content);
-    return true;
-}
-function buildCodexSection() {
-    return `[mcp_servers.${MCP_SERVER_NAME}]\ncommand = "${MCP_COMMAND}"\nargs = [${MCP_ARGS.map((a) => `"${a}"`).join(", ")}]`;
-}
-// ---------------------------------------------------------------------------
-// Remove from JSON configs
-// ---------------------------------------------------------------------------
-function removeFromMcpServersJson(configPath) {
-    if (!existsSync(configPath))
-        return false;
-    try {
-        const config = JSON.parse(readFileSync(configPath, "utf-8"));
-        const servers = config.mcpServers;
-        if (!servers || !(MCP_SERVER_NAME in servers))
-            return false;
-        delete servers[MCP_SERVER_NAME];
-        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function removeFromVscodeJson(configPath) {
-    if (!existsSync(configPath))
-        return false;
-    try {
-        const config = JSON.parse(readFileSync(configPath, "utf-8"));
-        const servers = config.servers;
-        if (!servers || !(MCP_SERVER_NAME in servers))
-            return false;
-        delete servers[MCP_SERVER_NAME];
-        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function removeFromCodexToml(configPath) {
-    if (!existsSync(configPath))
-        return false;
-    try {
-        let content = readFileSync(configPath, "utf-8");
-        const sectionHeader = `[mcp_servers.${MCP_SERVER_NAME}]`;
-        if (!content.includes(sectionHeader))
-            return false;
-        const regex = new RegExp(`\\n?\\[mcp_servers\\.${MCP_SERVER_NAME}\\][\\s\\S]*?(?=\\n\\[|$)`);
-        content = content.replace(regex, "");
-        writeFileSync(configPath, content);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ---------------------------------------------------------------------------
-// Playwright browser installation
-// ---------------------------------------------------------------------------
-function installPlaywrightBrowsers() {
-    try {
-        execFileSync(NPX_CMD, ["playwright", "install", "--with-deps", "chromium"], {
-            stdio: "inherit",
-        });
-        console.log("        Chromium installed");
-    }
-    catch {
-        console.log("        Warning: Could not install Playwright browsers automatically.");
-        console.log("        Run manually: npx playwright install --with-deps chromium");
-    }
-}
-// ---------------------------------------------------------------------------
-// Install
-// ---------------------------------------------------------------------------
-function registerMcpServer(ide, scope) {
-    switch (ide.format) {
-        case "cli":
-            if (!isClaudeCliAvailable()) {
-                console.log(`
+import{execFileSync as y}from"node:child_process";import{createInterface as M}from"node:readline";import{existsSync as a,mkdirSync as b,readFileSync as u,writeFileSync as f,unlinkSync as N,copyFileSync as _}from"node:fs";import{homedir as g,platform as j}from"node:os";import{join as i,dirname as O}from"node:path";import{fileURLToPath as T}from"node:url";var C=j()==="win32",D=j()==="darwin",l="fasttest",F=C?"npx.cmd":"npx",$="npx",I=["-y","@fasttest-ai/qa-agent@latest"],v=[{id:"claude-code",label:"Claude Code",globalConfigPath:"",format:"cli",hasPermissions:!0},{id:"cursor",label:"Cursor",globalConfigPath:i(g(),".cursor","mcp.json"),format:"json-mcpServers",hasPermissions:!1},{id:"windsurf",label:"Windsurf",globalConfigPath:i(g(),".codeium","windsurf","mcp_config.json"),format:"json-mcpServers",hasPermissions:!1},{id:"vscode",label:"VS Code / Copilot",globalConfigPath:D?i(g(),"Library","Application Support","Code","User","mcp.json"):C?i(process.env.APPDATA??i(g(),"AppData","Roaming"),"Code","User","mcp.json"):i(g(),".config","Code","User","mcp.json"),format:"json-servers",hasPermissions:!1},{id:"codex",label:"Codex",globalConfigPath:i(g(),".codex","config.toml"),format:"toml",hasPermissions:!1},{id:"antigravity",label:"Antigravity",globalConfigPath:i(g(),".gemini","antigravity","mcp_config.json"),format:"json-mcpServers",hasPermissions:!1}];function J(){let e=process.argv[2],o=process.argv.slice(3),s=null,n="user",r=!1;for(let t=0;t<o.length;t++)o[t]==="--ide"&&o[t+1]?s=o[++t]:o[t]==="--scope"&&o[t+1]?n=o[++t]:o[t]==="--skip-permissions"&&(r=!0);return{action:e,ide:s,scope:n,skipPermissions:r}}function L(e){let o=M({input:process.stdin,output:process.stdout});return new Promise(s=>{o.question(e,n=>{o.close(),s(n.trim())})})}async function R(){console.log(`  Which IDE do you use?
+`),v.forEach((n,r)=>{console.log(`    ${r+1}. ${n.label}`)}),console.log();let e=await L("  > "),o=parseInt(e,10)-1;if(o>=0&&o<v.length)return v[o].id;let s=v.find(n=>n.id===e.toLowerCase()||n.label.toLowerCase()===e.toLowerCase());return s?s.id:(console.log(`  Invalid selection, defaulting to Claude Code.
+`),"claude-code")}function U(){try{return y("claude",["--version"],{stdio:"pipe",shell:C}),!0}catch{return!1}}function W(e){let o=["mcp","add","--scope",e,l,"--",$,...I];try{return y("claude",o,{stdio:"inherit",shell:C}),!0}catch{try{return y("claude",["mcp","remove","--scope",e,l],{stdio:"pipe",shell:C}),y("claude",o,{stdio:"inherit",shell:C}),!0}catch{return!1}}}function G(e){try{return y("claude",["mcp","remove","--scope",e,l],{stdio:"inherit",shell:C}),!0}catch{return!1}}var P=i(g(),".claude"),d=i(P,"settings.json"),h="mcp__fasttest";function q(){a(P)||b(P,{recursive:!0});let e={};if(a(d))try{e=JSON.parse(u(d,"utf-8"))}catch{let o=d+".bak";f(o,u(d)),console.log(`        Warning: ${d} was corrupted. Backed up to ${o}`),e={}}return e.permissions||(e.permissions={}),Array.isArray(e.permissions.allow)||(e.permissions.allow=[]),e.permissions.allow.includes(h)?{added:!1,alreadyExists:!0}:(e.permissions.allow.push(h),f(d,JSON.stringify(e,null,2)+`
+`),{added:!0,alreadyExists:!1})}function H(){if(!a(d))return!1;try{let e=JSON.parse(u(d,"utf-8")),o=e.permissions?.allow;if(!Array.isArray(o))return!1;let s=o.indexOf(h);return s===-1?!1:(o.splice(s,1),f(d,JSON.stringify(e,null,2)+`
+`),!0)}catch{return!1}}var B=O(T(import.meta.url)),w=i(process.cwd(),".claude","commands"),E=["ftest.md","qa.md"];function V(){let e=0,o=0;for(let s of E){let n=i(B,"..","commands",s),r=i(w,s);a(n)&&(a(r)?(_(n,r),o++):(b(w,{recursive:!0}),_(n,r),e++))}return{installed:e,updated:o}}function Y(){let e=0;for(let o of E){let s=i(w,o);if(a(s))try{N(s),e++}catch{}}return e}function K(e){let o=i(e,"..");a(o)||b(o,{recursive:!0});let s={};if(a(e))try{s=JSON.parse(u(e,"utf-8"))}catch{let n=e+".bak";f(n,u(e)),console.log(`        Warning: ${e} was corrupted. Backed up to ${n}`),s={}}return(!s.mcpServers||typeof s.mcpServers!="object")&&(s.mcpServers={}),s.mcpServers[l]={command:$,args:[...I]},f(e,JSON.stringify(s,null,2)+`
+`),!0}function Q(e){let o=i(e,"..");a(o)||b(o,{recursive:!0});let s={};if(a(e))try{s=JSON.parse(u(e,"utf-8"))}catch{let n=e+".bak";f(n,u(e)),console.log(`        Warning: ${e} was corrupted. Backed up to ${n}`),s={}}return(!s.servers||typeof s.servers!="object")&&(s.servers={}),s.servers[l]={type:"stdio",command:$,args:[...I]},f(e,JSON.stringify(s,null,2)+`
+`),!0}function X(e){let o=i(e,"..");a(o)||b(o,{recursive:!0});let s="";a(e)&&(s=u(e,"utf-8"));let n=`[mcp_servers.${l}]`;if(s.includes(n)){let r=new RegExp(`\\[mcp_servers\\.${l}\\][\\s\\S]*?(?=\\n\\[|$)`);s=s.replace(r,k())}else s.length>0&&!s.endsWith(`
+`)&&(s+=`
+`),s+=`
+`+k()+`
+`;return f(e,s),!0}function k(){return`[mcp_servers.${l}]
+command = "${$}"
+args = [${I.map(e=>`"${e}"`).join(", ")}]`}function z(e){if(!a(e))return!1;try{let o=JSON.parse(u(e,"utf-8")),s=o.mcpServers;return!s||!(l in s)?!1:(delete s[l],f(e,JSON.stringify(o,null,2)+`
+`),!0)}catch{return!1}}function Z(e){if(!a(e))return!1;try{let o=JSON.parse(u(e,"utf-8")),s=o.servers;return!s||!(l in s)?!1:(delete s[l],f(e,JSON.stringify(o,null,2)+`
+`),!0)}catch{return!1}}function ee(e){if(!a(e))return!1;try{let o=u(e,"utf-8"),s=`[mcp_servers.${l}]`;if(!o.includes(s))return!1;let n=new RegExp(`\\n?\\[mcp_servers\\.${l}\\][\\s\\S]*?(?=\\n\\[|$)`);return o=o.replace(n,""),f(e,o),!0}catch{return!1}}function se(){if(process.env.FASTTEST_SKIP_PLAYWRIGHT==="1"){console.log("        Skipping Playwright install (FASTTEST_SKIP_PLAYWRIGHT=1)");return}try{y(F,["playwright","install","--with-deps","chromium"],{stdio:"inherit"}),console.log("        Chromium installed")}catch{console.log("        Warning: Could not install Playwright browsers automatically."),console.log("        Run manually: npx playwright install --with-deps chromium")}}function oe(e,o){switch(e.format){case"cli":return U()?W(o):(console.log(`
         Claude Code CLI not found in PATH.
 
         Install Claude Code first:
@@ -379,122 +27,33 @@ function registerMcpServer(ide, scope) {
               }
             }
           }
-`);
-                return false;
-            }
-            return registerClaudeCode(scope);
-        case "json-mcpServers":
-            return writeMcpServersJson(ide.globalConfigPath);
-        case "json-servers":
-            return writeVscodeJson(ide.globalConfigPath);
-        case "toml":
-            return writeCodexToml(ide.globalConfigPath);
-    }
-}
-function removeMcpServer(ide, scope) {
-    switch (ide.format) {
-        case "cli":
-            return removeClaudeCode(scope);
-        case "json-mcpServers":
-            return removeFromMcpServersJson(ide.globalConfigPath);
-        case "json-servers":
-            return removeFromVscodeJson(ide.globalConfigPath);
-        case "toml":
-            return removeFromCodexToml(ide.globalConfigPath);
-    }
-}
-async function install(config) {
-    console.log("\n  FastTest Agent Installer\n");
-    const ideId = config.ide ?? (await pickIde());
-    const ide = IDE_CONFIGS.find((c) => c.id === ideId);
-    if (!ide) {
-        console.log(`  Unknown IDE: ${ideId}`);
-        console.log(`  Supported: ${IDE_CONFIGS.map((c) => c.id).join(", ")}`);
-        process.exit(1);
-    }
-    console.log(`\n  Installing for ${ide.label}...\n`);
-    // Step 1: Register MCP server
-    const totalSteps = ide.hasPermissions && !config.skipPermissions ? 3 : 2;
-    let step = 1;
-    console.log(`  [${step}/${totalSteps}] Registering MCP server...`);
-    const registered = registerMcpServer(ide, config.scope);
-    if (registered) {
-        const location = ide.format === "cli"
-            ? `(scope: ${config.scope})`
-            : ide.globalConfigPath;
-        console.log(`        MCP server "${MCP_SERVER_NAME}" registered ${location}`);
-    }
-    else {
-        if (ide.format === "cli") {
-            process.exit(1);
-        }
-        console.log("        Warning: Could not register MCP server.");
-    }
-    step++;
-    // Step 2: Pre-approve tools (Claude Code only)
-    if (ide.hasPermissions && !config.skipPermissions) {
-        console.log(`  [${step}/${totalSteps}] Pre-approving tools...`);
-        const { added, alreadyExists } = addClaudePermissions();
-        if (added) {
-            console.log(`        Added ${PERMISSION_ENTRY} to ${CLAUDE_SETTINGS_PATH}`);
-        }
-        else if (alreadyExists) {
-            console.log(`        Already configured (${PERMISSION_ENTRY})`);
-        }
-        step++;
-    }
-    // Step 3: Install Playwright browsers
-    console.log(`  [${step}/${totalSteps}] Installing Playwright browsers...`);
-    installPlaywrightBrowsers();
-    console.log(`
-  Done! Open ${ide.label} and try:
+`),!1);case"json-mcpServers":return K(e.globalConfigPath);case"json-servers":return Q(e.globalConfigPath);case"toml":return X(e.globalConfigPath)}}function ne(e,o){switch(e.format){case"cli":return G(o);case"json-mcpServers":return z(e.globalConfigPath);case"json-servers":return Z(e.globalConfigPath);case"toml":return ee(e.globalConfigPath)}}async function te(e){console.log(`
+  FastTest Agent Installer
+`);let o=e.ide??await R(),s=v.find(c=>c.id===o);s||(console.log(`  Unknown IDE: ${o}`),console.log(`  Supported: ${v.map(c=>c.id).join(", ")}`),process.exit(1)),console.log(`
+  Installing for ${s.label}...
+`);let n=s.id==="claude-code",r=s.hasPermissions&&!e.skipPermissions,t=2;r&&t++,n&&t++;let m=1;if(console.log(`  [${m}/${t}] Registering MCP server...`),oe(s,e.scope)){let c=s.format==="cli"?`(scope: ${e.scope})`:s.globalConfigPath;console.log(`        MCP server "${l}" registered ${c}`)}else s.format==="cli"&&process.exit(1),console.log("        Warning: Could not register MCP server.");if(m++,r){console.log(`  [${m}/${t}] Pre-approving tools...`);let{added:c,alreadyExists:S}=q();c?console.log(`        Added ${h} to ${d}`):S&&console.log(`        Already configured (${h})`),m++}if(n){console.log(`  [${m}/${t}] Installing /ftest and /qa commands...`);let{installed:c,updated:S}=V();c>0&&console.log(`        Added ${c} command(s) to ${w}`),S>0&&console.log(`        Updated ${S} command(s)`),c===0&&S===0&&console.log("        Warning: Could not install commands (source files missing)"),m++}console.log(`  [${m}/${t}] Installing Playwright browsers...`),se();let x=`  Optional: Add this to your project's ${{"claude-code":"CLAUDE.md",cursor:".cursor/rules",windsurf:".windsurfrules",vscode:".github/copilot-instructions.md",codex:"AGENTS.md",antigravity:"GEMINI.md"}[s.id]} to auto-test after building features:
+
+    ## Testing
+    After implementing a feature, verify it works by running:
+    \`ftest <app-url> <what to test>\`
+    or use \`vibe shield <app-url>\` to generate a full regression suite.`;console.log(n?`
+  Done! Open ${s.label} and try:
+
+    /ftest http://localhost:3000 login flow
+
+${x}
+`:`
+  Done! Open ${s.label} and try:
+
+    "ftest my app at http://localhost:3000"
+    "ftest explore http://localhost:3000"
+    "ftest chaos http://localhost:3000"
 
-    "test my app at http://localhost:3000"
-`);
-}
-// ---------------------------------------------------------------------------
-// Uninstall
-// ---------------------------------------------------------------------------
-async function uninstall(config) {
-    console.log("\n  FastTest Agent Uninstaller\n");
-    const ideId = config.ide ?? (await pickIde());
-    const ide = IDE_CONFIGS.find((c) => c.id === ideId);
-    if (!ide) {
-        console.log(`  Unknown IDE: ${ideId}`);
-        process.exit(1);
-    }
-    console.log(`\n  Uninstalling from ${ide.label}...\n`);
-    const totalSteps = ide.hasPermissions ? 2 : 1;
-    let step = 1;
-    console.log(`  [${step}/${totalSteps}] Removing MCP server...`);
-    const removed = removeMcpServer(ide, config.scope);
-    if (removed) {
-        console.log(`        MCP server "${MCP_SERVER_NAME}" removed`);
-    }
-    else {
-        console.log("        MCP server was not registered (nothing to remove)");
-    }
-    step++;
-    if (ide.hasPermissions) {
-        console.log(`  [${step}/${totalSteps}] Removing tool permissions...`);
-        const permRemoved = removeClaudePermissions();
-        if (permRemoved) {
-            console.log(`        Removed ${PERMISSION_ENTRY} from ${CLAUDE_SETTINGS_PATH}`);
-        }
-        else {
-            console.log("        Permission was not present (nothing to remove)");
-        }
-    }
-    console.log(`\n  FastTest has been uninstalled from ${ide.label}.\n`);
-}
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-const config = parseArgs();
-if (config.action === "uninstall") {
-    await uninstall(config);
-}
-else {
-    await install(config);
-}
-//# sourceMappingURL=install.js.map
+${x}
+`)}async function re(e){console.log(`
+  FastTest Agent Uninstaller
+`);let o=e.ide??await R(),s=v.find(p=>p.id===o);s||(console.log(`  Unknown IDE: ${o}`),process.exit(1)),console.log(`
+  Uninstalling from ${s.label}...
+`);let n=s.id==="claude-code",r=1;s.hasPermissions&&r++,n&&r++;let t=1;console.log(`  [${t}/${r}] Removing MCP server...`);let m=ne(s,e.scope);if(console.log(m?`        MCP server "${l}" removed`:"        MCP server was not registered (nothing to remove)"),t++,s.hasPermissions){console.log(`  [${t}/${r}] Removing tool permissions...`);let p=H();console.log(p?`        Removed ${h} from ${d}`:"        Permission was not present (nothing to remove)"),t++}if(n){console.log(`  [${t}/${r}] Removing /ftest and /qa commands...`);let p=Y();p>0?console.log(`        Removed ${p} command(s)`):console.log("        Commands were not installed (nothing to remove)")}console.log(`
+  FastTest has been uninstalled from ${s.label}.
+`)}var A=J();A.action==="uninstall"?await re(A):await te(A);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fasttest-ai/qa-agent",
-  "version": "0.4.2",
+  "version": "1.0.0",
   "description": "FastTest Agent — MCP server that turns your coding agent into a QA engineer. Test, explore, and break web apps using Playwright.",
   "type": "module",
   "repository": {
@@ -33,8 +33,10 @@
   },
   "main": "./dist/index.js",
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && node esbuild.config.mjs",
+    "build:dev": "tsc",
     "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
     "start": "node dist/index.js",
     "ci": "node dist/cli.js"
   },
@@ -44,6 +46,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
     "typescript": "^5.7.0"
   },
   "engines": {
@@ -51,7 +54,8 @@
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "commands"
   ],
   "license": "Apache-2.0"
 }

package/dist/actions.d.ts

@@ -1,41 +0,0 @@
-/**
- * Browser action executor — navigate, click, fill, screenshot, etc.
- */
-import type { Page } from "playwright";
-export interface ActionResult {
-    success: boolean;
-    error?: string;
-    data?: Record<string, unknown>;
-}
-export declare function navigate(page: Page, url: string): Promise<ActionResult>;
-export declare function click(page: Page, selector: string): Promise<ActionResult>;
-export declare function fill(page: Page, selector: string, value: string): Promise<ActionResult>;
-export declare function hover(page: Page, selector: string): Promise<ActionResult>;
-export declare function selectOption(page: Page, selector: string, value: string): Promise<ActionResult>;
-export declare function waitFor(page: Page, selector: string, timeoutMs?: number): Promise<ActionResult>;
-export declare function screenshot(page: Page, fullPage?: boolean): Promise<string>;
-export declare function getSnapshot(page: Page): Promise<Record<string, unknown>>;
-export declare function goBack(page: Page): Promise<ActionResult>;
-export declare function goForward(page: Page): Promise<ActionResult>;
-export declare function pressKey(page: Page, key: string): Promise<ActionResult>;
-export declare function uploadFile(page: Page, selector: string, filePaths: string[]): Promise<ActionResult>;
-export declare function evaluate(page: Page, expression: string): Promise<ActionResult>;
-export declare function drag(page: Page, sourceSelector: string, targetSelector: string): Promise<ActionResult>;
-export declare function resize(page: Page, width: number, height: number): Promise<ActionResult>;
-export declare function fillForm(page: Page, fields: Record<string, string>): Promise<ActionResult>;
-export type AssertionType = "element_visible" | "element_hidden" | "text_contains" | "text_equals" | "url_contains" | "url_equals" | "element_count" | "attribute_value";
-export interface AssertionParams {
-    type: AssertionType;
-    selector?: string;
-    text?: string;
-    url?: string;
-    count?: number;
-    attribute?: string;
-    value?: string;
-}
-export interface AssertionResult {
-    pass: boolean;
-    actual?: string | number | boolean;
-    error?: string;
-}
-export declare function assertPage(page: Page, params: AssertionParams): Promise<AssertionResult>;