@kernel.chat/kbot 3.33.1 → 3.34.1

package/dist/openclaw-connect.js

@@ -0,0 +1,196 @@
+// kbot OpenClaw Connect — One-command OpenClaw Gateway setup
+//
+// Checks gateway availability, creates a SOUL.md agent definition,
+// and verifies connectivity with a test message.
+//
+// Usage: kbot openclaw connect
+import { join } from 'node:path';
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import chalk from 'chalk';
+import { KBOT_DIR } from './auth.js';
+// ── Constants ──
+const DEFAULT_GATEWAY_URL = 'http://127.0.0.1:18789';
+const GATEWAY_URL = process.env.OPENCLAW_GATEWAY_URL || DEFAULT_GATEWAY_URL;
+const SOUL_PATH = join(KBOT_DIR, 'openclaw-soul.md');
+// ── Helpers ──
+/** Check if the OpenClaw Gateway is reachable */
+async function checkGateway() {
+    try {
+        const res = await fetch(`${GATEWAY_URL}/health`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/** Fetch full gateway status (models, platforms, etc.) */
+async function fetchGatewayStatus() {
+    try {
+        const res = await fetch(`${GATEWAY_URL}/status`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return {};
+        return await res.json();
+    }
+    catch {
+        return {};
+    }
+}
+/** Send a test message to verify connectivity */
+async function sendTestMessage() {
+    try {
+        const res = await fetch(`${GATEWAY_URL}/v1/chat/completions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: 'auto',
+                messages: [
+                    { role: 'system', content: 'You are kbot, confirming OpenClaw connectivity. Respond with exactly: connected' },
+                    { role: 'user', content: 'ping' },
+                ],
+                max_tokens: 16,
+            }),
+            signal: AbortSignal.timeout(10000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+// ── SOUL.md Generation ──
+const SPECIALIST_IDS = [
+    'kernel', 'researcher', 'coder', 'writer', 'analyst',
+    'aesthete', 'guardian', 'curator', 'strategist',
+    'infrastructure', 'quant', 'investigator', 'oracle',
+    'chronist', 'sage', 'communicator', 'adapter', 'immune',
+];
+function generateSoulMd() {
+    const specialistList = SPECIALIST_IDS
+        .map(id => `- **${id}** — specialist agent`)
+        .join('\n');
+    return `# SOUL.md — kbot OpenClaw Agent Definition
+
+## Identity
+
+- **Name**: kbot
+- **Type**: Terminal AI agent
+- **Version**: OpenClaw-connected
+- **Source**: https://github.com/isaacsight/kernel
+- **License**: MIT
+
+## Purpose
+
+kbot is an open-source terminal AI agent that connects to the OpenClaw Gateway
+to access local and remote AI models. It brings ${SPECIALIST_IDS.length} specialist agents,
+290+ tools, and 20 AI providers into a single CLI interface.
+
+## Specialists
+
+${specialistList}
+
+## Capabilities
+
+- Multi-provider AI (Anthropic, OpenAI, Google, + 17 more)
+- 290+ built-in tools (file ops, git, GitHub, web search, browser, sandbox)
+- Autonomous planning and execution
+- Learning engine (patterns, solutions, user profile)
+- Session persistence and memory synthesis
+- MCP server/client support
+- Local model support (Ollama, LM Studio, embedded llama.cpp)
+
+## OpenClaw Integration
+
+- **Gateway URL**: ${GATEWAY_URL}
+- **Protocol**: OpenAI-compatible chat completions (v1/chat/completions)
+- **Agent routing**: kbot routes to specialists based on intent classification
+- **Tool execution**: Local-first, then API calls as needed
+- **Memory**: Persistent across sessions at ~/.kbot/
+
+## Interaction Style
+
+- Act, don't advise — execute tasks directly
+- Local-first — use local tools before making API calls
+- Failures trigger fallbacks, not stops
+- Route work to the right specialist
+- Compound improvements — each session leaves things better
+`;
+}
+// ── Main ──
+export async function runOpenClawConnect() {
+    const DIM = chalk.dim;
+    const ACCENT = chalk.hex('#A78BFA');
+    const GREEN = chalk.hex('#4ADE80');
+    const RED = chalk.hex('#F87171');
+    const CYAN = chalk.hex('#67E8F9');
+    console.log();
+    console.log(`  ${ACCENT('◉')} ${chalk.bold('kbot OpenClaw Connect')}`);
+    console.log(`  ${DIM('─'.repeat(40))}`);
+    console.log();
+    // Step 1: Check if gateway is running
+    console.log(`  ${DIM('Checking OpenClaw Gateway at')} ${CYAN(GATEWAY_URL)}${DIM('...')}`);
+    const health = await checkGateway();
+    if (!health) {
+        console.log();
+        console.log(`  ${RED('✗')} OpenClaw Gateway is not running.`);
+        console.log();
+        console.log(`  ${chalk.bold('To install and start OpenClaw:')}`);
+        console.log();
+        console.log(`  ${CYAN('1.')} Install the gateway:`);
+        console.log(`     ${chalk.white('pip install openclaw')}`);
+        console.log(`     ${DIM('or: brew install openclaw/tap/openclaw')}`);
+        console.log();
+        console.log(`  ${CYAN('2.')} Start the gateway:`);
+        console.log(`     ${chalk.white('openclaw serve')}`);
+        console.log(`     ${DIM('Default: http://127.0.0.1:18789')}`);
+        console.log();
+        console.log(`  ${CYAN('3.')} Set a custom URL (optional):`);
+        console.log(`     ${chalk.white('export OPENCLAW_GATEWAY_URL=http://your-host:port')}`);
+        console.log();
+        console.log(`  ${DIM('Then run')} ${chalk.white('kbot openclaw connect')} ${DIM('again.')}`);
+        console.log();
+        return;
+    }
+    console.log(`  ${GREEN('✓')} Gateway is running${health.version ? ` (v${health.version})` : ''}`);
+    // Step 2: Fetch full status
+    const status = await fetchGatewayStatus();
+    const platforms = status.platforms || ['local'];
+    const models = status.models || [];
+    if (models.length > 0) {
+        console.log(`  ${GREEN('✓')} Models available: ${models.slice(0, 5).join(', ')}${models.length > 5 ? ` +${models.length - 5} more` : ''}`);
+    }
+    // Step 3: Create SOUL.md
+    if (!existsSync(KBOT_DIR)) {
+        mkdirSync(KBOT_DIR, { recursive: true });
+    }
+    const soulContent = generateSoulMd();
+    writeFileSync(SOUL_PATH, soulContent, 'utf-8');
+    console.log(`  ${GREEN('✓')} Agent definition saved to ${DIM(SOUL_PATH)}`);
+    // Step 4: Send test message
+    console.log(`  ${DIM('Sending test message...')}`);
+    const testOk = await sendTestMessage();
+    if (testOk) {
+        console.log(`  ${GREEN('✓')} Connectivity verified`);
+    }
+    else {
+        console.log(`  ${chalk.hex('#FBBF24')('⚠')} Test message failed — gateway is up but may not have a model loaded.`);
+        console.log(`    ${DIM('Try: ollama pull llama3.1:8b')}`);
+    }
+    // Step 5: Print success summary
+    console.log();
+    console.log(`  ${GREEN('kbot is now connected to OpenClaw.')}`);
+    console.log(`  ${DIM('Your agents are available on:')} ${platforms.map(p => chalk.white(p)).join(', ')}`);
+    console.log();
+    console.log(`  ${DIM('Usage:')}`);
+    console.log(`    ${chalk.white('kbot')}                  ${DIM('— start interactive session via OpenClaw')}`);
+    console.log(`    ${chalk.white('kbot --agent coder')}    ${DIM('— use a specific specialist')}`);
+    console.log(`    ${chalk.white('kbot openclaw status')}  ${DIM('— check gateway status')}`);
+    console.log();
+}
+//# sourceMappingURL=openclaw-connect.js.map

package/dist/openclaw-connect.js.map

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

package/dist/pair.d.ts

@@ -47,7 +47,17 @@ declare let sessionStats: {
     suggestionsShown: number;
     fixesApplied: number;
     errorsFound: number;
+    testsRun: number;
+    testsFailed: number;
 };
+/**
+ * Get files that frequently change together with the given file.
+ * Returns top co-changing files sorted by frequency.
+ */
+export declare function getCoChangePatterns(targetFile?: string): Array<{
+    pair: [string, string];
+    count: number;
+}>;
 export declare function startPairMode(options?: PairOptions): Promise<void>;
 export declare function stopPairMode(): void;
 /**
@@ -69,6 +79,18 @@ export declare function analyzeWithAgent(filePath: string, agentOptions?: {
     model?: string;
     tier?: string;
 }): Promise<string>;
+/**
+ * runPair() — Start AI pair programming watch mode.
+ *
+ * 1. Watches cwd (or specified path) for file changes using fs.watch
+ * 2. When .ts/.js/.py/.rs/.go files change:
+ *    - Runs the relevant test if one exists (detects vitest/jest/pytest/cargo/go)
+ *    - If test fails, shows the failure with fix suggestions
+ *    - Tracks which files change together (co-change pattern extraction)
+ * 3. Simple terminal output: file changed, action taken, result
+ * 4. Runs until Ctrl+C
+ */
+export declare function runPair(path?: string, options?: Omit<PairOptions, 'path'>): Promise<void>;
 /**
  * Register the `kbot pair` command with the CLI program.
  *

package/dist/pair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pair.d.ts","sourceRoot":"","sources":["../src/pair.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMxC,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,+CAA+C;IAC/C,YAAY,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjE;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAA;IAC1C,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAA;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf;AA4GD,QAAA,IAAI,YAAY;;;;;CAA6E,CAAA;AAkuB7F,wBAAsB,aAAa,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4G5E;AAED,wBAAgB,YAAY,IAAI,IAAI,CAsBnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,YAAY,CAElD;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmE1D"}
+{"version":3,"file":"pair.d.ts","sourceRoot":"","sources":["../src/pair.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMxC,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,+CAA+C;IAC/C,YAAY,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjE;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAA;IAC1C,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAA;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf;AA4GD,QAAA,IAAI,YAAY;;;;;;;CAA0G,CAAA;AAmB1H;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBzG;AAw8BD,wBAAsB,aAAa,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+G5E;AAED,wBAAgB,YAAY,IAAI,IAAI,CAmCnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,YAAY,CAElD;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/F;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmE1D"}

package/dist/pair.js

@@ -103,7 +103,243 @@ const SECURITY_PATTERNS = [
 let activeWatcher = null;
 let debounceTimer = null;
 const pendingChanges = new Set();
-let sessionStats = { filesAnalyzed: 0, suggestionsShown: 0, fixesApplied: 0, errorsFound: 0 };
+let sessionStats = { filesAnalyzed: 0, suggestionsShown: 0, fixesApplied: 0, errorsFound: 0, testsRun: 0, testsFailed: 0 };
+// ---------------------------------------------------------------------------
+// Co-change pattern tracking
+// ---------------------------------------------------------------------------
+/** Tracks which files change together within a short time window. */
+const coChangeHistory = [];
+const CO_CHANGE_WINDOW_MS = 5000; // files changing within 5s are "together"
+const MAX_CO_CHANGE_HISTORY = 200;
+function recordCoChange(files) {
+    if (files.length < 2)
+        return;
+    coChangeHistory.push({ files: files.sort(), timestamp: Date.now() });
+    if (coChangeHistory.length > MAX_CO_CHANGE_HISTORY) {
+        coChangeHistory.splice(0, coChangeHistory.length - MAX_CO_CHANGE_HISTORY);
+    }
+}
+/**
+ * Get files that frequently change together with the given file.
+ * Returns top co-changing files sorted by frequency.
+ */
+export function getCoChangePatterns(targetFile) {
+    const pairCounts = new Map();
+    for (const entry of coChangeHistory) {
+        for (let i = 0; i < entry.files.length; i++) {
+            for (let j = i + 1; j < entry.files.length; j++) {
+                if (targetFile && entry.files[i] !== targetFile && entry.files[j] !== targetFile)
+                    continue;
+                const key = `${entry.files[i]}||${entry.files[j]}`;
+                pairCounts.set(key, (pairCounts.get(key) || 0) + 1);
+            }
+        }
+    }
+    return Array.from(pairCounts.entries())
+        .map(([key, count]) => {
+        const [a, b] = key.split('||');
+        return { pair: [a, b], count };
+    })
+        .filter(e => e.count >= 2)
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+}
+function detectTestRunner(projectRoot) {
+    const pkgPath = join(projectRoot, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            const scripts = pkg.scripts || {};
+            // Vitest
+            if (deps.vitest || (scripts.test && scripts.test.includes('vitest'))) {
+                return {
+                    name: 'vitest',
+                    command: 'npx vitest run',
+                    singleFileCommand: (f) => `npx vitest run "${f}" --reporter=verbose`,
+                };
+            }
+            // Jest
+            if (deps.jest || deps['@jest/core'] || (scripts.test && scripts.test.includes('jest'))) {
+                return {
+                    name: 'jest',
+                    command: 'npx jest',
+                    singleFileCommand: (f) => `npx jest "${f}" --verbose`,
+                };
+            }
+            // Mocha
+            if (deps.mocha) {
+                return {
+                    name: 'mocha',
+                    command: 'npx mocha',
+                    singleFileCommand: (f) => `npx mocha "${f}"`,
+                };
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Python: pytest
+    if (existsSync(join(projectRoot, 'pytest.ini')) ||
+        existsSync(join(projectRoot, 'pyproject.toml')) ||
+        existsSync(join(projectRoot, 'setup.cfg'))) {
+        try {
+            const content = existsSync(join(projectRoot, 'pyproject.toml'))
+                ? readFileSync(join(projectRoot, 'pyproject.toml'), 'utf-8')
+                : '';
+            if (content.includes('pytest') || existsSync(join(projectRoot, 'pytest.ini'))) {
+                return {
+                    name: 'pytest',
+                    command: 'python -m pytest',
+                    singleFileCommand: (f) => `python -m pytest "${f}" -v`,
+                };
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Rust: cargo test
+    if (existsSync(join(projectRoot, 'Cargo.toml'))) {
+        return {
+            name: 'cargo test',
+            command: 'cargo test',
+            singleFileCommand: (_f) => 'cargo test',
+        };
+    }
+    // Go: go test
+    if (existsSync(join(projectRoot, 'go.mod'))) {
+        return {
+            name: 'go test',
+            command: 'go test ./...',
+            singleFileCommand: (f) => `go test -v -run . "${dirname(f)}"`,
+        };
+    }
+    return null;
+}
+/**
+ * Find the test file corresponding to a source file, if it exists.
+ */
+function findTestFile(sourcePath) {
+    const ext = extname(sourcePath);
+    const dir = dirname(sourcePath);
+    const nameWithoutExt = basename(sourcePath, ext);
+    // Skip test/spec files themselves
+    if (nameWithoutExt.endsWith('.test') || nameWithoutExt.endsWith('.spec'))
+        return null;
+    if (nameWithoutExt.endsWith('_test'))
+        return null;
+    // JS/TS patterns
+    const jsTsPatterns = [
+        join(dir, `${nameWithoutExt}.test${ext}`),
+        join(dir, `${nameWithoutExt}.spec${ext}`),
+        join(dir, `${nameWithoutExt}.test.ts`),
+        join(dir, `${nameWithoutExt}.spec.ts`),
+        join(dir, '__tests__', `${nameWithoutExt}.test${ext}`),
+        join(dir, '__tests__', `${nameWithoutExt}.spec${ext}`),
+    ];
+    // Python patterns
+    const pyPatterns = [
+        join(dir, `test_${nameWithoutExt}.py`),
+        join(dir, `${nameWithoutExt}_test.py`),
+        join(dir, 'tests', `test_${nameWithoutExt}.py`),
+    ];
+    // Go patterns
+    const goPatterns = [
+        join(dir, `${nameWithoutExt}_test.go`),
+    ];
+    // Rust tests are inline (in the same file), so just return the source
+    if (ext === '.rs') {
+        try {
+            const content = readFileSync(sourcePath, 'utf-8');
+            if (content.includes('#[cfg(test)]') || content.includes('#[test]')) {
+                return sourcePath;
+            }
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+    const allPatterns = [...jsTsPatterns, ...pyPatterns, ...goPatterns];
+    for (const p of allPatterns) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Run the test file for a changed source file.
+ * Returns suggestions about the test result.
+ */
+function runTestForFile(change) {
+    const projectRoot = findProjectRoot(change.fullPath);
+    if (!projectRoot)
+        return [];
+    const testRunner = detectTestRunner(projectRoot);
+    if (!testRunner)
+        return [];
+    const testFile = findTestFile(change.fullPath);
+    if (!testFile)
+        return [];
+    const suggestions = [];
+    const relativeTestFile = testFile.replace(projectRoot + '/', '');
+    try {
+        execSync(testRunner.singleFileCommand(relativeTestFile), {
+            encoding: 'utf-8',
+            timeout: 30000,
+            cwd: projectRoot,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        sessionStats.testsRun++;
+        suggestions.push({
+            type: 'info',
+            category: 'test',
+            file: change.file,
+            message: `Tests passed (${testRunner.name}: ${relativeTestFile})`,
+        });
+    }
+    catch (err) {
+        sessionStats.testsRun++;
+        sessionStats.testsFailed++;
+        const stdout = err instanceof Error && 'stdout' in err
+            ? String(err.stdout)
+            : '';
+        const stderr = err instanceof Error && 'stderr' in err
+            ? String(err.stderr)
+            : '';
+        const output = (stdout + '\n' + stderr).trim();
+        // Extract the most relevant failure line
+        const failureLines = output.split('\n')
+            .filter(l => /fail|error|assert|expect/i.test(l) && !l.includes('node_modules'))
+            .slice(0, 3);
+        suggestions.push({
+            type: 'error',
+            category: 'test',
+            file: change.file,
+            message: `Test failed (${testRunner.name}: ${relativeTestFile})`,
+        });
+        for (const line of failureLines) {
+            const trimmed = line.trim().slice(0, 120);
+            if (trimmed) {
+                suggestions.push({
+                    type: 'error',
+                    category: 'test',
+                    file: change.file,
+                    message: `  ${trimmed}`,
+                });
+            }
+        }
+        if (failureLines.length === 0 && output.length > 0) {
+            // Show last few lines as fallback
+            const lastLines = output.split('\n').filter(l => l.trim()).slice(-3);
+            for (const line of lastLines) {
+                suggestions.push({
+                    type: 'error',
+                    category: 'test',
+                    file: change.file,
+                    message: `  ${line.trim().slice(0, 120)}`,
+                });
+            }
+        }
+    }
+    return suggestions;
+}
 // ---------------------------------------------------------------------------
 // Config management
 // ---------------------------------------------------------------------------
@@ -703,6 +939,10 @@ async function analyzeChanges(changes, config, options) {
         if (isSource && config.checks.style) {
             suggestions.push(...checkStyle(change));
         }
+        // Run tests for changed source files
+        if (isSource && config.checks.missingTests) {
+            suggestions.push(...runTestForFile(change));
+        }
         // Apply auto-fixes if enabled
         let autoFixed = [];
         if (config.autoFix || options.autoFix) {
@@ -779,7 +1019,7 @@ export async function startPairMode(options = {}) {
         return;
     }
     // Reset session stats
-    sessionStats = { filesAnalyzed: 0, suggestionsShown: 0, fixesApplied: 0, errorsFound: 0 };
+    sessionStats = { filesAnalyzed: 0, suggestionsShown: 0, fixesApplied: 0, errorsFound: 0, testsRun: 0, testsFailed: 0 };
     // Print banner
     process.stderr.write('\n');
     process.stderr.write(`  ${ACCENT('kbot')} ${chalk.bold('pair')} ${DIM('— watching for changes')}\n`);
@@ -825,6 +1065,8 @@ export async function startPairMode(options = {}) {
                     const full = join(watchPath, file);
                     return classifyChange(full, file);
                 });
+                // Track co-change patterns
+                recordCoChange(batch);
                 // Run analysis pipeline
                 await analyzeChanges(changes, config, options);
             }, DEBOUNCE_MS);
@@ -862,9 +1104,20 @@ export function stopPairMode() {
         process.stderr.write(`    ${DIM('Files analyzed:')}  ${sessionStats.filesAnalyzed}\n`);
         process.stderr.write(`    ${DIM('Suggestions:')}     ${sessionStats.suggestionsShown}\n`);
         process.stderr.write(`    ${DIM('Errors found:')}    ${sessionStats.errorsFound}\n`);
+        if (sessionStats.testsRun > 0) {
+            process.stderr.write(`    ${DIM('Tests run:')}       ${sessionStats.testsRun}${sessionStats.testsFailed > 0 ? ` (${RED(String(sessionStats.testsFailed) + ' failed')})` : ` (${GREEN('all passed')})`}\n`);
+        }
         if (sessionStats.fixesApplied > 0) {
             process.stderr.write(`    ${DIM('Auto-fixed:')}      ${GREEN(String(sessionStats.fixesApplied))}\n`);
         }
+        // Print co-change patterns if any were detected
+        const patterns = getCoChangePatterns();
+        if (patterns.length > 0) {
+            process.stderr.write(`\n    ${DIM('Co-change patterns detected:')}\n`);
+            for (const p of patterns.slice(0, 5)) {
+                process.stderr.write(`      ${CYAN(p.pair[0])} ${DIM('<->')} ${CYAN(p.pair[1])} ${DIM(`(${p.count}x)`)}\n`);
+            }
+        }
         process.stderr.write('\n');
     }
 }
@@ -927,6 +1180,26 @@ export async function analyzeWithAgent(filePath, agentOptions) {
     }
 }
 // ---------------------------------------------------------------------------
+// runPair() — convenience entry point
+// ---------------------------------------------------------------------------
+/**
+ * runPair() — Start AI pair programming watch mode.
+ *
+ * 1. Watches cwd (or specified path) for file changes using fs.watch
+ * 2. When .ts/.js/.py/.rs/.go files change:
+ *    - Runs the relevant test if one exists (detects vitest/jest/pytest/cargo/go)
+ *    - If test fails, shows the failure with fix suggestions
+ *    - Tracks which files change together (co-change pattern extraction)
+ * 3. Simple terminal output: file changed, action taken, result
+ * 4. Runs until Ctrl+C
+ */
+export async function runPair(path, options) {
+    return startPairMode({
+        path: path || process.cwd(),
+        ...options,
+    });
+}
+// ---------------------------------------------------------------------------
 // CLI registration
 // ---------------------------------------------------------------------------
 /**