miii-cli 1.1.3 → 1.2.0

package/README.md

@@ -164,6 +164,7 @@ No API keys. No account. No sign-up form. First run walks you through setup inte
 | `/plan <topic>` | Structured planning mode before you write a line |
 | `/model <name>` | Hot-swap your LLM mid-conversation |
 | `/session <name>` | Switch between named project sessions |
+| `/watch <path>` | Monitor files for changes and trigger agent reactions |
 | `@filename` | Inject any file directly into context |
 
 ---

package/dist/init.js

@@ -15,7 +15,7 @@ import { loadMCPTools } from './mcp/client.js';
 import { needsSetup, runSetup } from './setup.js';
 const require = createRequire(import.meta.url);
 const UPDATE_CACHE = join(homedir(), '.config', 'miii', 'update-check.json');
-const CHECK_INTERVAL_MS = 6 * 60 * 60 * 1000; // 6h
+const CHECK_INTERVAL_MS = 60 * 60 * 1000; // 1h
 function semverGt(a, b) {
     const pa = a.split('.').map(Number);
     const pb = b.split('.').map(Number);

package/dist/mcp/client.js

@@ -68,9 +68,13 @@ export class MCPClient {
     send(method, params) {
         return new Promise((resolve, reject) => {
             const id = this.nextId++;
-            this.pending.set(id, { resolve, reject });
+            let timer;
+            this.pending.set(id, {
+                resolve: (v) => { clearTimeout(timer); resolve(v); },
+                reject: (e) => { clearTimeout(timer); reject(e); },
+            });
             this.proc.stdin.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
-            setTimeout(() => {
+            timer = setTimeout(() => {
                 if (this.pending.has(id)) {
                     this.pending.delete(id);
                     reject(new Error(`MCP timeout: ${method}`));

package/dist/sessions.js

@@ -52,9 +52,10 @@ export function loadSession(projectDir, name) {
     }
 }
 export function saveSession(projectDir, name, messages) {
+    const safeName = sanitizeName(name);
     ensureProjectDir(projectDir);
     try {
-        writeFileSync(join(sessionsDir(projectDir), `${sanitizeName(name)}.json`), JSON.stringify(messages), { mode: 0o600 });
+        writeFileSync(join(sessionsDir(projectDir), `${safeName}.json`), JSON.stringify(messages), { mode: 0o600 });
     }
     catch { }
 }

package/dist/tools/index.js

@@ -68,8 +68,10 @@ export const tools = [
         execute: async ({ path, old: oldStr, new: newStr }) => {
             const safe = guardPath(path);
             const current = readFile(safe);
-            if (!current)
-                throw new Error(`file not found or empty: ${path}`);
+            if (current === null)
+                throw new Error(`file not found: ${path}`);
+            if (current === '')
+                throw new Error(`file empty: ${path}`);
             const old = oldStr;
             const count = current.split(old).length - 1;
             if (count === 0) {
@@ -79,7 +81,7 @@ export const tools = [
             if (count > 1) {
                 throw new Error(`ambiguous: ${count} matches found in ${path} — extend <old> block with more surrounding lines to make it unique`);
             }
-            const updated = current.replace(old, newStr);
+            const updated = current.replace(old, String(newStr));
             writeFile(safe, updated);
             // Compute affected line range for the snippet
             const startLine = current.slice(0, current.indexOf(old)).split('\n').length;

package/dist/tui/InputBar.js

@@ -16,6 +16,7 @@ import { useRunLoop } from './hooks/useRunLoop.js';
 import { useRefactor } from './hooks/useRefactor.js';
 import { useGit } from './hooks/useGit.js';
 import { useSubmit } from './hooks/useSubmit.js';
+import { useWatch } from './hooks/useWatch.js';
 import { runDeepThink } from './deepThink.js';
 import { setInkInstance } from './printer.js';
 import { createSearchCodebaseTool } from '../index/tool.js';
@@ -30,16 +31,60 @@ function formatElapsed(ms) {
     const rem = s % 60;
     return rem === 0 ? `${m}m` : `${m}m ${rem}s`;
 }
-const MAX_DIFF_LINES = 5;
+const MAX_DIFF_LINES = 40;
+const DIFF_CTX = 2;
+function lineDiff(oldText, newText) {
+    const a = oldText.split('\n');
+    const b = newText.split('\n');
+    const m = a.length, n = b.length;
+    if (m * n > 10000) {
+        return [...a.map(line => ({ type: 'del', line })), ...b.map(line => ({ type: 'add', line }))];
+    }
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = m - 1; i >= 0; i--)
+        for (let j = n - 1; j >= 0; j--)
+            dp[i][j] = a[i] === b[j] ? 1 + dp[i + 1][j + 1] : Math.max(dp[i + 1][j], dp[i][j + 1]);
+    const result = [];
+    let i = 0, j = 0;
+    while (i < m || j < n) {
+        if (i < m && j < n && a[i] === b[j]) {
+            result.push({ type: 'eq', line: a[i++] });
+            j++;
+        }
+        else if (j < n && (i >= m || dp[i + 1][j] <= dp[i][j + 1])) {
+            result.push({ type: 'add', line: b[j++] });
+        }
+        else {
+            result.push({ type: 'del', line: a[i++] });
+        }
+    }
+    return result;
+}
+function diffHunks(diff) {
+    const changedIdxs = diff.reduce((acc, d, i) => { if (d.type !== 'eq')
+        acc.push(i); return acc; }, []);
+    if (!changedIdxs.length)
+        return [];
+    const inHunk = new Set();
+    for (const ci of changedIdxs)
+        for (let k = Math.max(0, ci - DIFF_CTX); k <= Math.min(diff.length - 1, ci + DIFF_CTX); k++)
+            inHunk.add(k);
+    return diff.filter((_, i) => inHunk.has(i));
+}
 function DiffPreview({ toolName, args }) {
-    if (toolName === 'patch_file' && (args.old || args.new)) {
-        const oldLines = String(args.old ?? '').split('\n');
-        const newLines = String(args.new ?? '').split('\n');
-        return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [oldLines.slice(0, MAX_DIFF_LINES).map((line, i) => (_jsxs(Text, { color: "red", dimColor: true, children: ["- ", line.slice(0, 72)] }, `o${i}`))), oldLines.length > MAX_DIFF_LINES && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2026", oldLines.length - MAX_DIFF_LINES, " more"] })), newLines.slice(0, MAX_DIFF_LINES).map((line, i) => (_jsxs(Text, { color: "green", dimColor: true, children: ["+ ", line.slice(0, 72)] }, `n${i}`))), newLines.length > MAX_DIFF_LINES && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2026", newLines.length - MAX_DIFF_LINES, " more"] }))] }));
+    if (toolName === 'patch_file' && (args.old != null || args.new != null)) {
+        const path = String(args.path ?? '');
+        const diff = diffHunks(lineDiff(String(args.old ?? ''), String(args.new ?? '')));
+        const visible = diff.slice(0, MAX_DIFF_LINES);
+        const hidden = diff.length - visible.length;
+        return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Text, { color: "gray", dimColor: true, children: ["  ", path] }), visible.map((d, i) => (_jsxs(Text, { color: d.type === 'del' ? 'red' : d.type === 'add' ? 'green' : 'gray', dimColor: d.type === 'eq', children: [d.type === 'del' ? '- ' : d.type === 'add' ? '+ ' : '  ', d.line.slice(0, 76)] }, i))), hidden > 0 && _jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2026", hidden, " more line", hidden === 1 ? '' : 's'] })] }));
     }
     if ((toolName === 'edit_file' || toolName === 'create_file') && args.content) {
-        const n = String(args.content).split('\n').length;
-        return (_jsx(Box, { paddingLeft: 2, children: _jsxs(Text, { color: "gray", dimColor: true, children: [n, " line", n === 1 ? '' : 's'] }) }));
+        const path = String(args.path ?? '');
+        const lines = String(args.content).split('\n');
+        const visible = lines.slice(0, MAX_DIFF_LINES);
+        const hidden = lines.length - visible.length;
+        return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Text, { color: "gray", dimColor: true, children: ["  ", path] }), visible.map((line, i) => (_jsxs(Text, { color: "green", children: ["+ ", line.slice(0, 76)] }, i))), hidden > 0 && _jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2026", hidden, " more line", hidden === 1 ? '' : 's'] })] }));
     }
     return null;
 }
@@ -79,6 +124,7 @@ export function InputBar({ config: initialConfig, skills, cwd, session, version,
         setStatus, setTaskLabel, setCurrentTool, pushHistory,
     });
     const { handleGit } = useGit({ pushHistory, buildContext, runLoop });
+    const { watchActive, startWatch, stopWatch } = useWatch(cwd, { runLoop, buildContext, pushHistory });
     const { handleSubmit } = useSubmit({
         config, skills, cwd, projectDir, version, currentModelRef, setCurrentModel,
         historyRef, sessionNameRef, saveTimerRef, systemPromptRef, abortRef,
@@ -87,6 +133,7 @@ export function InputBar({ config: initialConfig, skills, cwd, session, version,
         setStatus, setTaskLabel, setCurrentTool,
         runRefactor, handleGit, lastGitStatusRef, mcpTools, setConfig,
         setConfigOpen, updateMemory,
+        startWatch, stopWatch, watchActive,
     });
     const skillList = skills.list();
     return (_jsxs(Box, { flexDirection: "column", children: [configOpen ? (_jsxs(_Fragment, { children: [_jsx(ConfigPicker, { config: config, currentModel: currentModel, tavilyKey: tavilyKey, onUpdate: ({ model, ...configPatch }) => {
@@ -98,5 +145,5 @@ export function InputBar({ config: initialConfig, skills, cwd, session, version,
                             }
                         }, onTavilyKey: (key) => { saveTavilyKey(key); setTavilyKey(key); }, onClose: () => { setConfigOpen(false); } }), _jsx(Divider, { cols: cols })] })) : pickerOpen ? (_jsxs(_Fragment, { children: [_jsx(ModelPicker, { models: pickerModels, current: currentModel, loading: pickerLoading, error: pickerError, pull: pullState, onSelect: handleModelSelect, onPull: handleModelPull, onClose: () => { setPickerOpen(false); } }), _jsx(Divider, { cols: cols })] })) : compactRequest ? (_jsxs(Box, { paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "yellow", children: "\u26A0" }), _jsx(Text, { color: "white", bold: true, children: "context is large" }), _jsxs(Text, { color: "gray", children: ["(~", compactRequest.messageCount, "k chars)"] })] }), _jsx(Text, { color: "gray", dimColor: true, children: "compact to keep responses fast, or keep full history" })] })) : permissionRequest ? (_jsxs(Box, { paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "yellow", children: "\u26A0" }), _jsx(Text, { color: "white", bold: true, children: permissionRequest.toolName }), _jsx(Text, { color: "gray", children: toolArgSummary(permissionRequest.args) })] }), _jsx(DiffPreview, { toolName: permissionRequest.toolName, args: permissionRequest.args })] })) : (status === 'thinking' || status === 'tool') ? (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { children: status === 'thinking'
                             ? _jsxs(_Fragment, { children: [_jsxs(Text, { color: "yellow", children: [SPARKLE[tick % SPARKLE.length], " "] }), _jsx(Text, { color: "gray", dimColor: true, italic: true, children: THINKING_PHRASES[phraseSeq[Math.floor(tick / 62) % phraseSeq.length]] })] })
-                            : _jsxs(Text, { color: "yellow", dimColor: true, children: ["\u2699 running ", currentTool ?? 'tool', "\u2026"] }) }), _jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "gray", dimColor: true, children: formatElapsed(Date.now() - thinkingStartRef.current) }), taskLabel && _jsx(Text, { color: "cyan", dimColor: true, children: taskLabel })] })] })) : null, _jsx(InputArea, { status: status, skills: skillList, cwd: cwd, planningMode: planningMode, permissionRequest: permissionRequest, onPermissionResponse: resolvePermission, compactRequest: compactRequest, onCompactResponse: resolveCompact, onSubmit: handleSubmit, onAbort: handleAbort, history: historyRef.current.filter(m => m.role === 'user').map(m => m.content) })] }));
+                            : _jsxs(Text, { color: "yellow", dimColor: true, children: ["\u2699 running ", currentTool ?? 'tool', "\u2026"] }) }), _jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "gray", dimColor: true, children: formatElapsed(Date.now() - thinkingStartRef.current) }), taskLabel && _jsx(Text, { color: "cyan", dimColor: true, children: taskLabel })] })] })) : null, _jsx(InputArea, { status: status, skills: skillList, cwd: cwd, planningMode: planningMode, permissionRequest: permissionRequest, onPermissionResponse: resolvePermission, compactRequest: compactRequest, onCompactResponse: resolveCompact, onSubmit: handleSubmit, onAbort: handleAbort, history: historyRef.current.filter(m => m.role === 'user').map(m => m.content), watchActive: watchActive })] }));
 }

package/dist/tui/components/InputArea.js

@@ -23,6 +23,7 @@ const BUILTIN_COMMANDS = [
     { ns: 'builtin', name: 'plan', description: 'enter planning mode — AI helps think through a goal step-by-step' },
     { ns: 'builtin', name: 'refactor', description: 'multi-file AI refactor — plans, reads, then edits — /refactor <goal>' },
     { ns: 'builtin', name: 'think', description: 'deep research before answering — reads files + optional web — /think <query>' },
+    { ns: 'builtin', name: 'watch', description: 'watch for file changes, run tests, auto-fix failures — /watch stop to cancel' },
     // ── Git ───────────────────────────────────────────────────────────────────
     { ns: 'git', name: 'status', description: 'show git working tree status (modified, staged, untracked)' },
     { ns: 'git', name: 'diff', description: 'show unstaged changes as a diff' },
@@ -55,7 +56,7 @@ function wordEndAfter(line, col) {
         i++;
     return i;
 }
-export function InputArea({ status, skills, cwd, planningMode, permissionRequest, onPermissionResponse, compactRequest, onCompactResponse, onSubmit, onAbort, history = [] }) {
+export function InputArea({ status, skills, cwd, planningMode, permissionRequest, onPermissionResponse, compactRequest, onCompactResponse, onSubmit, onAbort, history = [], watchActive = false }) {
     const [lines, setLines] = useState(['']);
     const [cursor, setCursor] = useState({ row: 0, col: 0 });
     const [overlay, setOverlay] = useState('none');
@@ -468,11 +469,15 @@ export function InputArea({ status, skills, cwd, planningMode, permissionRequest
                             ? `history ${historyIdx + 1}/${history.length}   ↑↓  navigate   esc  clear`
                             : planningMode
                                 ? 'planning mode   /plan:done  exit'
-                                : '?  for shortcuts';
+                                : watchActive
+                                    ? 'watch active   /watch stop to cancel'
+                                    : '?  for shortcuts';
     const pastePreview = pasteRef.current
         ? pasteRef.current.split('\n')[0].slice(0, cols - 6)
         : '';
-    return (_jsxs(Box, { flexDirection: "column", children: [overlay === 'command' && (_jsx(CommandPalette, { skills: allCommands, query: commandQuery, idx: overlayIdx })), overlay === 'at' && (_jsx(AtPicker, { files: filteredFiles, query: atQuery, idx: overlayIdx })), _jsx(Text, { color: "gray", dimColor: true, children: '─'.repeat(Math.max(cols, 10)) }), _jsxs(Box, { paddingX: 1, children: [_jsx(Text, { color: promptColor, bold: true, children: '> ' }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: permissionRequest ? (_jsxs(Box, { gap: 3, children: [_jsx(Text, { color: "green", bold: true, children: "y  once" }), _jsx(Text, { color: "cyan", bold: true, children: "a  session" }), _jsx(Text, { color: "red", bold: true, children: "n  deny" })] })) : compactRequest ? (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "green", bold: true, children: "y  yes" }), _jsx(Text, { color: "red", bold: true, children: "n  no" })] })) : pasteLines > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", children: "\u2398" }), _jsxs(Text, { color: "cyan", children: ["pasted ", pasteLines, " line", pasteLines !== 1 ? 's' : ''] }), (lines.length > 1 || lines[0]) && (_jsx(Text, { color: "gray", dimColor: true, children: "+ typed text" }))] }), pastePreview && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  ", pastePreview, pasteRef.current.split('\n')[0].length > cols - 6 ? '…' : ''] }))] })) : lines.length === 1 && !lines[0] ? (_jsx(Text, { children: isActive ? '█' : ' ' })) : (lines.map((line, i) => (_jsx(Text, { children: i === cursor.row
+    return (_jsxs(Box, { flexDirection: "column", children: [overlay === 'command' && (_jsx(CommandPalette, { skills: allCommands, query: commandQuery, idx: overlayIdx })), overlay === 'at' && (_jsx(AtPicker, { files: filteredFiles, query: atQuery, idx: overlayIdx })), _jsx(Text, { color: "gray", dimColor: true, children: '─'.repeat(Math.max(cols, 10)) }), _jsxs(Box, { paddingX: 1, children: [_jsx(Text, { color: promptColor, bold: true, children: '> ' }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: permissionRequest ? (_jsxs(Box, { gap: 3, children: [_jsx(Text, { color: "green", bold: true, children: "y  once" }), _jsx(Text, { color: "cyan", bold: true, children: "a  session" }), _jsx(Text, { color: "red", bold: true, children: "n  deny" })] })) : compactRequest ? (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "green", bold: true, children: "y  yes" }), _jsx(Text, { color: "red", bold: true, children: "n  no" })] })) : pasteLines > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", children: "\u2398" }), _jsxs(Text, { color: "cyan", children: ["pasted ", pasteLines, " line", pasteLines !== 1 ? 's' : ''] }), (lines.length > 1 || lines[0]) && (_jsx(Text, { color: "gray", dimColor: true, children: "+ typed text" }))] }), pastePreview && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  ", pastePreview, pasteRef.current.split('\n')[0].length > cols - 6 ? '…' : ''] }))] })) : lines.length === 1 && !lines[0] ? (watchActive && isActive
+                            ? _jsxs(Text, { children: [_jsx(Text, { color: "cyan", dimColor: true, children: "watching\u2026 " }), _jsx(Text, { children: "\u2588" })] })
+                            : _jsx(Text, { children: isActive ? '█' : ' ' })) : (lines.map((line, i) => (_jsx(Text, { children: i === cursor.row
                                 ? viewportLine(line, cursor.col, availWidth, isActive)
                                 : line.length > availWidth ? '…' + line.slice(line.length - availWidth + 1) : line }, i)))) })] }), _jsx(Text, { color: "gray", dimColor: true, children: '─'.repeat(Math.max(cols, 10)) }), _jsxs(Text, { color: "gray", dimColor: true, children: ["  ", hint] })] }));
 }

package/dist/tui/hooks/useSubmit.js

@@ -37,7 +37,7 @@ export function useSubmit(deps) {
     const depsRef = useRef(deps);
     depsRef.current = deps;
     const handleSubmit = useCallback(async (text) => {
-        const { config, skills, cwd, projectDir, version, currentModelRef, setCurrentModel, historyRef, sessionNameRef, saveTimerRef, systemPromptRef, abortRef, setPlanningMode, runLoop, buildContext, pushHistory, setSessionName, renameFromMessage, setStatus, setTaskLabel, setCurrentTool, runRefactor, handleGit, lastGitStatusRef, mcpTools, setConfig, setConfigOpen, updateMemory, } = depsRef.current;
+        const { config, skills, cwd, projectDir, version, currentModelRef, setCurrentModel, historyRef, sessionNameRef, saveTimerRef, systemPromptRef, abortRef, setPlanningMode, runLoop, buildContext, pushHistory, setSessionName, renameFromMessage, setStatus, setTaskLabel, setCurrentTool, runRefactor, handleGit, lastGitStatusRef, mcpTools, setConfig, setConfigOpen, updateMemory, startWatch, stopWatch, } = depsRef.current;
         const cmd = text.trim();
         if (cmd === '?') {
             printer.systemMsg('shortcuts:\n' +
@@ -431,6 +431,15 @@ export function useSubmit(deps) {
             printer.systemMsg('usage: /index build | /index status | /index search <query> | /index clear');
             return;
         }
+        if (cmd === '/watch' || cmd.startsWith('/watch ')) {
+            const sub = cmd.slice(6).trim();
+            if (sub === 'stop') {
+                stopWatch();
+                return;
+            }
+            startWatch();
+            return;
+        }
         if (text.startsWith('/')) {
             const [slashCmd, ...rest] = text.slice(1).split(' ');
             const skill = skills.get(slashCmd);

package/dist/tui/hooks/useWatch.js

@@ -0,0 +1,119 @@
+import { useRef, useState, useCallback, useEffect } from 'react';
+import { watch } from 'fs';
+import { tools as staticTools } from '../../tools/index.js';
+import * as printer from '../printer.js';
+const WATCH_DEBOUNCE_MS = 600;
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', '.next', 'build', 'coverage',
+    '__pycache__', '.turbo', '.cache', '.parcel-cache', 'out',
+]);
+const WATCH_EXT = /\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|rb|java|kt|swift|c|cpp|h|hpp|css|scss)$/;
+function testsFailed(output) {
+    // Explicit pass with no failures → passing
+    if (/\b0 fail/i.test(output))
+        return false;
+    if (/\d+ pass/i.test(output) && !/\d+ fail/i.test(output))
+        return false;
+    return /\d+ fail|FAIL\b|✕|✗|\bfailing\b|AssertionError/i.test(output);
+}
+export function useWatch(cwd, deps) {
+    const [watchActive, setWatchActive] = useState(false);
+    const watcherRef = useRef(null);
+    const debounceRef = useRef(null);
+    const changedRef = useRef(new Set());
+    const fixRunningRef = useRef(false);
+    // Always-fresh deps via ref — watcher callback is set up once
+    const depsRef = useRef(deps);
+    useEffect(() => { depsRef.current = deps; });
+    const stopWatch = useCallback(() => {
+        if (debounceRef.current) {
+            clearTimeout(debounceRef.current);
+            debounceRef.current = null;
+        }
+        watcherRef.current?.close();
+        watcherRef.current = null;
+        changedRef.current.clear();
+        fixRunningRef.current = false;
+        setWatchActive(false);
+        printer.systemMsg('watch: stopped');
+    }, []);
+    const startWatch = useCallback(() => {
+        if (watcherRef.current) {
+            printer.systemMsg('watch: already active — /watch stop to cancel');
+            return;
+        }
+        let watcher;
+        try {
+            watcher = watch(cwd, { recursive: true }, (_event, filename) => {
+                if (!filename)
+                    return;
+                const parts = filename.split('/');
+                if (parts.some(p => IGNORE_DIRS.has(p) || p.startsWith('.')))
+                    return;
+                if (!WATCH_EXT.test(filename))
+                    return;
+                changedRef.current.add(filename);
+                if (debounceRef.current)
+                    clearTimeout(debounceRef.current);
+                debounceRef.current = setTimeout(async () => {
+                    debounceRef.current = null;
+                    const changed = [...changedRef.current];
+                    changedRef.current.clear();
+                    const testTool = staticTools.find(t => t.name === 'run_tests');
+                    if (!testTool)
+                        return;
+                    const label = changed.length > 3
+                        ? `${changed.slice(0, 3).join(', ')} +${changed.length - 3} more`
+                        : changed.join(', ');
+                    printer.systemMsg(`watch: ${label} — running tests`);
+                    if (fixRunningRef.current) {
+                        printer.systemMsg('watch: fix in progress — skipping this cycle');
+                        return;
+                    }
+                    fixRunningRef.current = true;
+                    try {
+                        const result = await testTool.execute({});
+                        if (!result || result.startsWith('(no '))
+                            return;
+                        if (testsFailed(result)) {
+                            printer.systemMsg('watch: tests failing — triggering fix');
+                            const { pushHistory, buildContext, runLoop } = depsRef.current;
+                            const fixMsg = `Tests are failing after changes to: ${changed.join(', ')}\n\n` +
+                                `Test output:\n${result}\n\n` +
+                                `Read the failing files and fix the issues.`;
+                            pushHistory({ role: 'user', content: fixMsg });
+                            await runLoop(buildContext(), 0, 'fix failing tests');
+                        }
+                        else {
+                            printer.systemMsg('watch: tests passing');
+                        }
+                    }
+                    catch (e) {
+                        printer.errorMsg(`watch: ${e}`);
+                    }
+                    finally {
+                        fixRunningRef.current = false;
+                    }
+                }, WATCH_DEBOUNCE_MS);
+            });
+        }
+        catch (e) {
+            printer.errorMsg(`watch: failed to start: ${e}`);
+            return;
+        }
+        watcher.on('error', (err) => {
+            printer.errorMsg(`watch: ${err.message}`);
+            stopWatch();
+        });
+        watcherRef.current = watcher;
+        setWatchActive(true);
+        printer.systemMsg(`watch: active — monitoring ${cwd.replace(process.env.HOME ?? '', '~')}`);
+    }, [cwd, stopWatch]);
+    // Cleanup on unmount
+    useEffect(() => () => {
+        watcherRef.current?.close();
+        if (debounceRef.current)
+            clearTimeout(debounceRef.current);
+    }, []);
+    return { watchActive, startWatch, stopWatch };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miii-cli",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "type": "module",
   "description": "The high-performance local AI coding agent for your terminal. Automate complex workflows with local LLMs.",
   "license": "MIT",