yo-bug 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vibe-feedback contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,160 @@
+# yo-bug 🐛
+
+**"Yo, bug!"** — Point at bugs, AI fixes them.
+
+MCP Server that gives AI coding assistants QA superpowers. One install, then your AI handles the entire test-feedback-fix loop.
+
+In vibe coding, the bottleneck is testing: humans find bugs but struggle to describe them. yo-bug solves this by letting users point, click, and annotate — while the AI automatically receives element locations, console errors, network failures, action recordings, and annotated screenshots.
+
+## What it does
+
+| For the Human | For the AI |
+|---|---|
+| Click a broken element → done | Gets: CSS selector + computed styles + React/Vue component name |
+| Draw a circle on a screenshot → done | Gets: annotated screenshot as image content |
+| Just use the app normally | Gets: last 100 user actions (clicks, inputs, navigation) |
+| Check off a test list | Gets: which tests passed/failed with linked feedback |
+
+The AI drives the entire workflow through MCP tools. Humans never need to learn commands, configure proxies, or modify their code.
+
+## Install
+
+```bash
+npx yo-bug install
+
+# That's it. Your AI now has QA superpowers.
+```
+
+This auto-detects your AI tool (Claude Code / Cursor / Windsurf) and writes the MCP config. One time, done forever.
+
+## How it works
+
+```
+AI writes code
+    → AI calls start_test_session()
+    → Browser opens with test overlay injected (zero code changes)
+    → AI pushes a test checklist (8 QA dimensions, 40+ sub-scenarios)
+    → Human tests, clicks problems, checks off items
+    → AI calls list_feedbacks() → sees everything
+    → AI fixes → calls resolve_feedback() → browser asks human to verify
+    → Loop until done
+```
+
+## MCP Tools (9 total)
+
+### Session Control
+| Tool | Description |
+|---|---|
+| `start_test_session(port?, open?)` | Start test mode: auto-detect dev server, launch reverse proxy with SDK injection, open browser |
+| `stop_test_session()` | Stop test mode, return session summary (feedback stats, checklist results, weak dimensions) |
+
+### Feedback
+| Tool | Description |
+|---|---|
+| `list_feedbacks(status?, type?, limit?)` | List submitted feedback (filter by status: open/verify/resolved) |
+| `get_feedback(id)` | Full details: element info, console errors, network errors, action steps, annotated screenshot |
+| `resolve_feedback(id)` | Mark as fixed → pushes verification request to browser → human confirms |
+
+### Test Checklist
+| Tool | Description |
+|---|---|
+| `create_checklist(title, items)` | Push structured test checklist to browser. Items have step, expected result, priority, and dimension |
+| `get_checklist_status()` | See which items passed/failed and any user feedback |
+
+### Test History
+| Tool | Description |
+|---|---|
+| `save_test_record(module, ...)` | Save test results per module. Accumulates history for future reference |
+| `get_test_history(module)` | Get historical test records. Shows frequently failing scenarios |
+
+## 8 QA Test Dimensions
+
+The `create_checklist` tool embeds professional QA methodology. AI is guided to systematically cover:
+
+1. **Happy path** — Core functionality works end-to-end
+2. **Empty/boundary** — Empty inputs, special chars, max length, zero/negative values
+3. **Error states** — Offline, server errors, timeouts, recovery
+4. **Duplicate ops** — Double-click, re-submit, concurrent requests
+5. **State recovery** — Refresh, back/forward, deep links, tab close/reopen
+6. **Loading/async** — Loading states, failed loads, stale data
+7. **Responsive** — 375px mobile width, touch targets, overflow
+8. **Interaction detail** — Tab order, Enter/Escape, disabled states, focus
+
+Each dimension has detailed sub-scenario templates that the AI selects from based on actual code changes.
+
+## Three Feedback Modes
+
+Users choose how to report issues:
+
+| Mode | Shortcut | How it works |
+|---|---|---|
+| **Quick** | `Alt+Q` | Click an element → instantly flagged with full context. One click, done. |
+| **Describe** | `Alt+D` | Click an element → fill a form with problem type and description |
+| **Screenshot** | `Alt+S` | Drag to select screen region → annotate with arrows/shapes/text → submit |
+
+Other shortcuts: `Alt+X` toggle test mode, `Esc` exit.
+
+## Auto-Captured Context
+
+Every feedback submission automatically includes:
+
+- **Console errors** — last 50 `console.error`/`console.warn` entries with stack traces
+- **Network failures** — failed `fetch`/`XHR` requests with status, URL, duration
+- **Unhandled exceptions** — `window.onerror` + `unhandledrejection`
+- **Action recording** — last 100 user actions (clicks, inputs, keypresses, navigation) with timestamps
+- **Element info** — CSS selector, tag, text content, bounding rect, computed styles, React/Vue component name
+
+## Verify-Fix Flow
+
+When AI calls `resolve_feedback()`, instead of silently marking it done:
+
+1. Browser shows a "Verify Fix" card to the user
+2. User clicks "Fixed" or "Still broken"
+3. Status updates accordingly — AI knows if the fix actually worked
+
+## i18n
+
+SDK auto-detects `<html lang="...">`:
+- `zh-*` → Chinese interface
+- Everything else → English interface
+
+MCP tool descriptions are in English (AI translates to user's language naturally).
+
+## Architecture
+
+```
+Browser → Reverse Proxy (localhost:3695) → Dev Server (localhost:5173)
+              │
+              ├─ Auto-injects SDK into HTML responses
+              ├─ WebSocket passthrough (HMR works normally)
+              ├─ Feedback API (POST/GET)
+              ├─ Checklist API (push/poll/update)
+              └─ Verify API (push/confirm)
+
+MCP Server (stdio) → AI Tool (Claude Code / Cursor / Windsurf)
+              │
+              ├─ start/stop_test_session → controls proxy lifecycle
+              ├─ feedback tools → reads user submissions
+              ├─ checklist tools → pushes test plans, reads results
+              └─ history tools → persists test records per module
+```
+
+The proxy auto-detects dev server framework (Vite, Next.js, CRA, Webpack, Nuxt, Angular, Svelte, Astro) and port. If the dev server is already running, it connects. If not, it starts one.
+
+## Security
+
+- All data stays local (`~/.yo-bug/`)
+- Feedback IDs validated against path traversal
+- Input fields whitelist-filtered and length-limited
+- Network interceptor uses exact pathname matching (no substring false positives)
+- No data sent to any external service
+
+## Requirements
+
+- Node.js >= 18
+- Any MCP-compatible AI tool
+- Any web application running in a browser
+
+## License
+
+MIT

package/bin/cli.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const command = process.argv[2];
+
+if (command === 'mcp') {
+  // Start MCP server (stdio mode)
+  import('../src/mcp/index.js');
+} else if (command === 'install') {
+  // Install MCP config to AI tools
+  import('./install.js');
+} else {
+  console.log('yo-bug — AI Agent 的测试之眼\n');
+  console.log('用法:');
+  console.log('  npx yo-bug install   安装 MCP 到你的 AI 工具');
+  console.log('  npx yo-bug mcp       启动 MCP Server（由 AI 工具自动调用）');
+  console.log('\n安装后，AI 会自动获得测试模式能力，你不需要其他操作。');
+}

package/bin/install.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { detectAITools } from '../src/install/detect-ai-tool.js';
+import { writeMcpConfig } from '../src/install/write-mcp-config.js';
+
+async function main() {
+  console.log('yo-bug — 安装 MCP Server\n');
+
+  const tools = await detectAITools();
+  const detected = tools.filter((t) => t.detected);
+
+  if (detected.length === 0) {
+    console.log('未检测到任何 AI 工具（Claude Code / Cursor / Windsurf）。');
+    console.log('请先安装至少一个 AI 编程工具后再运行此命令。\n');
+    console.log('手动配置方法:');
+    console.log('  在 AI 工具的 MCP 配置中添加:');
+    console.log('  {');
+    console.log('    "command": "npx",');
+    console.log('    "args": ["yo-bug", "mcp"]');
+    console.log('  }');
+    process.exit(1);
+  }
+
+  console.log(`检测到 ${detected.length} 个 AI 工具:\n`);
+
+  for (const tool of detected) {
+    const result = await writeMcpConfig(tool);
+    console.log(`  ${result.success ? '✓' : '✗'} ${result.message}`);
+  }
+
+  console.log('\n安装完成！重启你的 AI 工具后即可使用 yo-bug。');
+  console.log('AI 会自动获得 start_test_session 等工具，无需其他操作。');
+}
+
+main().catch(console.error);

package/bin/mcp.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/mcp/index.js';

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+declare const command: string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AAEA,QAAA,MAAM,OAAO,QAAkB,CAAC"}

package/dist/bin/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+const command = process.argv[2];
+if (command === 'mcp') {
+    // Start MCP server (stdio mode)
+    import('../src/mcp/index.js');
+}
+else if (command === 'install') {
+    // Install MCP config to AI tools
+    import('./install.js');
+}
+else {
+    console.log('yo-bug — AI Agent 的测试之眼\n');
+    console.log('用法:');
+    console.log('  npx yo-bug install   安装 MCP 到你的 AI 工具');
+    console.log('  npx yo-bug mcp       启动 MCP Server（由 AI 工具自动调用）');
+    console.log('\n安装后，AI 会自动获得测试模式能力，你不需要其他操作。');
+}
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";;AAEA,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;IACtB,gCAAgC;IAChC,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAChC,CAAC;KAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IACjC,iCAAiC;IACjC,MAAM,CAAC,cAAc,CAAC,CAAC;AACzB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC"}

package/dist/bin/install.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/bin/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../bin/install.ts"],"names":[],"mappings":""}

package/dist/bin/install.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { detectAITools } from '../src/install/detect-ai-tool.js';
+import { writeMcpConfig } from '../src/install/write-mcp-config.js';
+async function main() {
+    console.log('yo-bug — 安装 MCP Server\n');
+    const tools = await detectAITools();
+    const detected = tools.filter((t) => t.detected);
+    if (detected.length === 0) {
+        console.log('未检测到任何 AI 工具（Claude Code / Cursor / Windsurf）。');
+        console.log('请先安装至少一个 AI 编程工具后再运行此命令。\n');
+        console.log('手动配置方法:');
+        console.log('  在 AI 工具的 MCP 配置中添加:');
+        console.log('  {');
+        console.log('    "command": "npx",');
+        console.log('    "args": ["yo-bug", "mcp"]');
+        console.log('  }');
+        process.exit(1);
+    }
+    console.log(`检测到 ${detected.length} 个 AI 工具:\n`);
+    for (const tool of detected) {
+        const result = await writeMcpConfig(tool);
+        console.log(`  ${result.success ? '✓' : '✗'} ${result.message}`);
+    }
+    console.log('\n安装完成！重启你的 AI 工具后即可使用 yo-bug。');
+    console.log('AI 会自动获得 start_test_session 等工具，无需其他操作。');
+}
+main().catch(console.error);
+//# sourceMappingURL=install.js.map

package/dist/bin/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../bin/install.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,MAAM,aAAa,CAAC,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/bin/mcp.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import '../src/mcp/index.js';
+//# sourceMappingURL=mcp.d.ts.map

package/dist/bin/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../bin/mcp.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC"}

package/dist/bin/mcp.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import '../src/mcp/index.js';
+//# sourceMappingURL=mcp.js.map

package/dist/bin/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../bin/mcp.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC"}

package/dist/src/detect/dev-server.d.ts

@@ -0,0 +1,11 @@
+interface DevServerInfo {
+    framework: string;
+    port: number;
+    command: string;
+    isRunning: boolean;
+}
+export declare function detectDevServer(cwd: string, manualPort?: number): Promise<DevServerInfo>;
+export declare function isPortInUse(port: number): Promise<boolean>;
+export declare function waitForPort(port: number, timeout?: number): Promise<boolean>;
+export {};
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/src/detect/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../../src/detect/dev-server.ts"],"names":[],"mappings":"AAIA,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAaD,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CAqDxB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB1D;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,GACd,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/src/detect/dev-server.js

@@ -0,0 +1,92 @@
+import fs from 'fs/promises';
+import net from 'net';
+import path from 'path';
+const FRAMEWORK_PORTS = {
+    vite: { port: 5173, keywords: ['vite'] },
+    next: { port: 3000, keywords: ['next'] },
+    'create-react-app': { port: 3000, keywords: ['react-scripts'] },
+    webpack: { port: 8080, keywords: ['webpack serve', 'webpack-dev-server'] },
+    nuxt: { port: 3000, keywords: ['nuxt'] },
+    angular: { port: 4200, keywords: ['ng serve'] },
+    svelte: { port: 5173, keywords: ['svelte-kit', 'vite'] },
+    astro: { port: 4321, keywords: ['astro'] },
+};
+export async function detectDevServer(cwd, manualPort) {
+    // Read package.json
+    let devCommand = '';
+    let framework = 'unknown';
+    let port = manualPort || 0;
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf-8'));
+        const scripts = pkg.scripts || {};
+        // Check "dev" or "start" scripts
+        devCommand = scripts.dev || scripts.start || '';
+        // Match framework
+        for (const [name, info] of Object.entries(FRAMEWORK_PORTS)) {
+            if (info.keywords.some((kw) => devCommand.includes(kw))) {
+                framework = name;
+                if (!manualPort)
+                    port = info.port;
+                break;
+            }
+        }
+        // Also check dependencies for framework detection
+        if (framework === 'unknown') {
+            const allDeps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+            };
+            for (const [name, info] of Object.entries(FRAMEWORK_PORTS)) {
+                if (info.keywords.some((kw) => kw in allDeps)) {
+                    framework = name;
+                    if (!manualPort)
+                        port = info.port;
+                    break;
+                }
+            }
+        }
+    }
+    catch {
+        // No package.json found
+    }
+    // Default port
+    if (!port)
+        port = 3000;
+    // Check if port is already in use
+    const isRunning = await isPortInUse(port);
+    return {
+        framework,
+        port,
+        command: devCommand,
+        isRunning,
+    };
+}
+export function isPortInUse(port) {
+    return new Promise((resolve) => {
+        const socket = new net.Socket();
+        socket.setTimeout(1000);
+        socket.on('connect', () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.on('timeout', () => {
+            socket.destroy();
+            resolve(false);
+        });
+        socket.on('error', () => {
+            resolve(false);
+        });
+        socket.connect(port, '127.0.0.1');
+    });
+}
+export async function waitForPort(port, timeout = 30000) {
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        if (await isPortInUse(port))
+            return true;
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    return false;
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/src/detect/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../../src/detect/dev-server.ts"],"names":[],"mappings":"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"}

package/dist/src/detect/spawn-dev.d.ts

@@ -0,0 +1,4 @@
+export declare function spawnDevServer(cwd: string, command: string, port: number): Promise<boolean>;
+export declare function killDevServer(): void;
+export declare function isDevServerSpawned(): boolean;
+//# sourceMappingURL=spawn-dev.d.ts.map

package/dist/src/detect/spawn-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-dev.d.ts","sourceRoot":"","sources":["../../../src/detect/spawn-dev.ts"],"names":[],"mappings":"AAKA,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/dist/src/detect/spawn-dev.js

@@ -0,0 +1,37 @@
+import { spawn } from 'child_process';
+import { waitForPort } from './dev-server.js';
+let devProcess = null;
+export async function spawnDevServer(cwd, command, port) {
+    const isWindows = process.platform === 'win32';
+    const npmCmd = isWindows ? 'npm.cmd' : 'npm';
+    // Use the detected script name (e.g., "dev" or "start")
+    const scriptName = command.includes('start') ? 'start' : 'dev';
+    devProcess = spawn(npmCmd, ['run', scriptName], {
+        cwd,
+        shell: isWindows,
+        stdio: 'pipe', // Don't inherit — we're an MCP server using stdio
+        env: { ...process.env },
+    });
+    devProcess.stdout?.on('data', () => {
+        // Silently consume output — MCP server uses stdio
+    });
+    devProcess.stderr?.on('data', () => {
+        // Silently consume stderr
+    });
+    devProcess.on('error', () => {
+        // Silently handle — MCP server uses stdio, can't write to stderr
+    });
+    // Wait for the port to become available
+    const ready = await waitForPort(port, 30000);
+    return ready;
+}
+export function killDevServer() {
+    if (devProcess) {
+        devProcess.kill();
+        devProcess = null;
+    }
+}
+export function isDevServerSpawned() {
+    return devProcess !== null && !devProcess.killed;
+}
+//# sourceMappingURL=spawn-dev.js.map

package/dist/src/detect/spawn-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-dev.js","sourceRoot":"","sources":["../../../src/detect/spawn-dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgB,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,IAAI,UAAU,GAAwB,IAAI,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,OAAe,EACf,IAAY;IAEZ,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAE7C,wDAAwD;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAE/D,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE;QAC9C,GAAG;QACH,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,MAAM,EAAE,kDAAkD;QACjE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACjC,kDAAkD;IACpD,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACjC,0BAA0B;IAC5B,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAC1B,iEAAiE;IACnE,CAAC,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,EAAE,CAAC;QAClB,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;AACnD,CAAC"}

package/dist/src/install/detect-ai-tool.d.ts

@@ -0,0 +1,7 @@
+export interface AITool {
+    name: string;
+    configPath: string;
+    detected: boolean;
+}
+export declare function detectAITools(): Promise<AITool[]>;
+//# sourceMappingURL=detect-ai-tool.d.ts.map

package/dist/src/install/detect-ai-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ai-tool.d.ts","sourceRoot":"","sources":["../../../src/install/detect-ai-tool.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BvD"}

package/dist/src/install/detect-ai-tool.js

@@ -0,0 +1,38 @@
+import fs from 'fs/promises';
+import path from 'path';
+const HOME = process.env.HOME || process.env.USERPROFILE || '';
+export async function detectAITools() {
+    const tools = [];
+    // Claude Code
+    const claudeDir = path.join(HOME, '.claude');
+    tools.push({
+        name: 'Claude Code',
+        configPath: path.join(claudeDir, 'settings.json'),
+        detected: await dirExists(claudeDir),
+    });
+    // Cursor
+    const cursorDir = path.join(HOME, '.cursor');
+    tools.push({
+        name: 'Cursor',
+        configPath: path.join(cursorDir, 'mcp.json'),
+        detected: await dirExists(cursorDir),
+    });
+    // Windsurf
+    const windsurfDir = path.join(HOME, '.windsurf');
+    tools.push({
+        name: 'Windsurf',
+        configPath: path.join(windsurfDir, 'mcp.json'),
+        detected: await dirExists(windsurfDir),
+    });
+    return tools;
+}
+async function dirExists(dir) {
+    try {
+        const stat = await fs.stat(dir);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detect-ai-tool.js.map

package/dist/src/install/detect-ai-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ai-tool.js","sourceRoot":"","sources":["../../../src/install/detect-ai-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,cAAc;IACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC;QACjD,QAAQ,EAAE,MAAM,SAAS,CAAC,SAAS,CAAC;KACrC,CAAC,CAAC;IAEH,SAAS;IACT,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;QAC5C,QAAQ,EAAE,MAAM,SAAS,CAAC,SAAS,CAAC;KACrC,CAAC,CAAC;IAEH,WAAW;IACX,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QAC9C,QAAQ,EAAE,MAAM,SAAS,CAAC,WAAW,CAAC;KACvC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/install/write-mcp-config.d.ts

@@ -0,0 +1,6 @@
+import type { AITool } from './detect-ai-tool.js';
+export declare function writeMcpConfig(tool: AITool): Promise<{
+    success: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=write-mcp-config.d.ts.map

package/dist/src/install/write-mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-mcp-config.d.ts","sourceRoot":"","sources":["../../../src/install/write-mcp-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAOlD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCjG"}

package/dist/src/install/write-mcp-config.js

@@ -0,0 +1,47 @@
+import fs from 'fs/promises';
+import path from 'path';
+const MCP_SERVER_CONFIG = {
+    command: 'npx',
+    args: ['yo-bug', 'mcp'],
+};
+export async function writeMcpConfig(tool) {
+    try {
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(tool.configPath), { recursive: true });
+        // Read existing config
+        let config = {};
+        try {
+            const content = await fs.readFile(tool.configPath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch {
+            // File doesn't exist or invalid JSON — start fresh
+        }
+        // Check if already configured
+        if (tool.name === 'Claude Code') {
+            config.mcpServers = config.mcpServers || {};
+            if (config.mcpServers['yo-bug']) {
+                return { success: true, message: `${tool.name}: 已配置，跳过。` };
+            }
+            config.mcpServers['yo-bug'] = {
+                type: 'stdio',
+                ...MCP_SERVER_CONFIG,
+            };
+        }
+        else {
+            // Cursor / Windsurf format
+            config.mcpServers = config.mcpServers || {};
+            if (config.mcpServers['yo-bug']) {
+                return { success: true, message: `${tool.name}: 已配置，跳过。` };
+            }
+            config.mcpServers['yo-bug'] = MCP_SERVER_CONFIG;
+        }
+        // Write config
+        await fs.writeFile(tool.configPath, JSON.stringify(config, null, 2), 'utf-8');
+        return { success: true, message: `${tool.name}: MCP 配置已写入 ${tool.configPath}` };
+    }
+    catch (err) {
+        return { success: false, message: `${tool.name}: 写入失败 — ${err.message}` };
+    }
+}
+//# sourceMappingURL=write-mcp-config.js.map

package/dist/src/install/write-mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-mcp-config.js","sourceRoot":"","sources":["../../../src/install/write-mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,iBAAiB,GAAG;IACxB,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;CACxB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,uBAAuB;QACvB,IAAI,MAAM,GAAQ,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YAC7D,CAAC;YACD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG;gBAC5B,IAAI,EAAE,OAAO;gBACb,GAAG,iBAAiB;aACrB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YAC7D,CAAC;YACD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAAC;QAClD,CAAC;QAED,eAAe;QACf,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;IAClF,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,YAAY,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/src/mcp/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":""}