@element47/ag 4.4.0

package/dist/tools/git.js

@@ -0,0 +1,220 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+const execFileAsync = promisify(execFile);
+async function run(args, cwd) {
+    const { stdout } = await execFileAsync('git', args, { cwd, encoding: 'utf-8', timeout: 30_000 });
+    return stdout.trim();
+}
+async function tryRun(args, cwd) {
+    try {
+        return { ok: true, out: await run(args, cwd) };
+    }
+    catch (e) {
+        const err = e;
+        return { ok: false, out: ((err.stdout ?? '') + (err.stderr ?? '')).trim() };
+    }
+}
+function isRepo(cwd) {
+    return existsSync(join(cwd, '.git'));
+}
+async function defaultBranch(cwd) {
+    const ref = await tryRun(['symbolic-ref', 'refs/remotes/origin/HEAD'], cwd);
+    if (ref.ok)
+        return ref.out.replace('refs/remotes/origin/', '');
+    const branches = await tryRun(['branch', '-r'], cwd);
+    if (branches.ok) {
+        if (branches.out.includes('origin/main'))
+            return 'main';
+        if (branches.out.includes('origin/master'))
+            return 'master';
+    }
+    return 'main';
+}
+async function currentBranch(cwd) {
+    const result = await tryRun(['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
+    if (result.ok)
+        return result.out;
+    const sym = await tryRun(['symbolic-ref', '--short', 'HEAD'], cwd);
+    return sym.ok ? `${sym.out} (no commits yet)` : '(no commits yet)';
+}
+async function remoteUrl(cwd) {
+    const r = await tryRun(['remote', 'get-url', 'origin'], cwd);
+    return r.ok ? r.out : '';
+}
+async function compareUrl(cwd, branch) {
+    const remote = await remoteUrl(cwd);
+    if (!remote)
+        return '';
+    const base = await defaultBranch(cwd);
+    const url = remote
+        .replace(/^git@([^:]+):/, 'https://$1/')
+        .replace(/\.git$/, '');
+    return `${url}/compare/${base}...${branch}`;
+}
+// ── Action handlers ────────────────────────────────────────────────────────
+async function doStatus(cwd) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    const lines = [];
+    lines.push(`Branch: ${await currentBranch(cwd)}`);
+    const remote = await remoteUrl(cwd);
+    if (remote)
+        lines.push(`Remote: ${remote}`);
+    const status = await run(['status', '--porcelain'], cwd);
+    if (status) {
+        const files = status.split('\n');
+        const staged = files.filter(f => /^[MADRC]/.test(f)).length;
+        const unstaged = files.filter(f => /^.[MADRC]/.test(f)).length;
+        const untracked = files.filter(f => f.startsWith('??')).length;
+        lines.push(`Changes: ${staged} staged, ${unstaged} unstaged, ${untracked} untracked`);
+    }
+    else {
+        lines.push('Working tree clean.');
+    }
+    const ahead = await tryRun(['rev-list', '@{u}..HEAD', '--count'], cwd);
+    const behind = await tryRun(['rev-list', 'HEAD..@{u}', '--count'], cwd);
+    if (ahead.ok && behind.ok) {
+        lines.push(`Ahead: ${ahead.out}, Behind: ${behind.out}`);
+    }
+    const log = await tryRun(['log', '--oneline', '-5'], cwd);
+    if (log.ok && log.out)
+        lines.push(`\nRecent commits:\n${log.out}`);
+    return lines.join('\n');
+}
+async function doInit(cwd, remote) {
+    if (isRepo(cwd)) {
+        const branch = await currentBranch(cwd);
+        const existing = await remoteUrl(cwd);
+        let msg = `Already a git repo. Branch: ${branch}`;
+        if (existing)
+            msg += `, Remote: ${existing}`;
+        if (remote && remote !== existing) {
+            await tryRun(['remote', 'remove', 'origin'], cwd);
+            await run(['remote', 'add', 'origin', remote], cwd);
+            msg += `\nRemote updated to: ${remote}`;
+        }
+        return msg;
+    }
+    await run(['init'], cwd);
+    let msg = 'Initialized git repository.';
+    if (remote) {
+        await run(['remote', 'add', 'origin', remote], cwd);
+        msg += ` Remote set to: ${remote}`;
+    }
+    return msg;
+}
+async function doBranch(cwd, name) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    const lines = [];
+    const status = await run(['status', '--porcelain'], cwd);
+    if (status) {
+        return `Error: ${status.split('\n').length} uncommitted change(s) detected. Commit or stash your changes before creating a new branch.\n\nDirty files:\n${status}`;
+    }
+    const fetchResult = await tryRun(['fetch', 'origin'], cwd);
+    if (fetchResult.ok) {
+        lines.push('Fetched latest from origin.');
+    }
+    else {
+        lines.push('Warning: Could not fetch from origin (no remote or offline). Branching from local state.');
+    }
+    const base = await defaultBranch(cwd);
+    if (fetchResult.ok) {
+        await tryRun(['checkout', base], cwd);
+        await tryRun(['merge', '--ff-only', `origin/${base}`], cwd);
+        lines.push(`Updated local ${base} to origin/${base}.`);
+    }
+    const result = await tryRun(['checkout', '-b', name], cwd);
+    if (result.ok) {
+        lines.push(`Created and switched to branch: ${name}`);
+    }
+    else {
+        const sw = await tryRun(['checkout', name], cwd);
+        lines.push(sw.ok
+            ? `Branch ${name} already exists. Switched to it.`
+            : `Error creating branch: ${result.out}`);
+    }
+    return lines.join('\n');
+}
+async function doCommit(cwd, message, files) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    if (files && files.length > 0) {
+        await run(['add', ...files], cwd);
+    }
+    else {
+        await run(['add', '-A'], cwd);
+    }
+    const staged = await tryRun(['diff', '--cached', '--stat'], cwd);
+    if (!staged.out)
+        return 'Nothing to commit. Working tree clean.';
+    const result = await tryRun(['commit', '-m', message], cwd);
+    return result.ok ? `Committed: ${message}\n${result.out}` : `Commit failed: ${result.out}`;
+}
+async function doPush(cwd, force) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    const branch = await currentBranch(cwd);
+    const base = await defaultBranch(cwd);
+    if (branch === base) {
+        return `You're on ${base}. Create a feature branch first with action=branch.`;
+    }
+    const args = ['push', '-u', 'origin', branch];
+    if (force)
+        args.splice(1, 0, '--force-with-lease');
+    const result = await tryRun(args, cwd);
+    const lines = [];
+    if (result.ok || result.out.includes('->')) {
+        lines.push(`Pushed ${branch} to origin.`);
+    }
+    else {
+        return `Push failed: ${result.out}`;
+    }
+    const url = await compareUrl(cwd, branch);
+    if (url)
+        lines.push(`\nCreate PR: ${url}`);
+    return lines.join('\n');
+}
+// ── Exported tool ──────────────────────────────────────────────────────────
+export function gitTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'git',
+            description: 'Git operations. Actions: status (branch, changes, recent commits), init (initialize repo), branch (create from latest main), commit (stage + commit), push (push + PR compare URL).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['status', 'init', 'branch', 'commit', 'push'], description: 'The git operation to perform.' },
+                    name: { type: 'string', description: 'Branch name (for action=branch, e.g. "feature/add-auth").' },
+                    message: { type: 'string', description: 'Commit message (for action=commit).' },
+                    files: { type: 'array', items: { type: 'string' }, description: 'Specific files to stage (for action=commit). Omit to stage all.' },
+                    remote: { type: 'string', description: 'Remote URL (for action=init, e.g. "git@github.com:user/repo.git").' },
+                    force: { type: 'boolean', description: 'Force push with lease (for action=push). Default: false.' }
+                },
+                required: ['action']
+            }
+        },
+        execute: async ({ action, name, message, files, remote, force }) => {
+            switch (action) {
+                case 'status': return doStatus(cwd);
+                case 'init': return doInit(cwd, remote);
+                case 'branch': {
+                    if (!name)
+                        return 'Error: name is required for action=branch.';
+                    return doBranch(cwd, name);
+                }
+                case 'commit': {
+                    if (!message)
+                        return 'Error: message is required for action=commit.';
+                    return doCommit(cwd, message, files);
+                }
+                case 'push': return doPush(cwd, force);
+                default: return `Unknown action "${action}". Use: status, init, branch, commit, push.`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=git.js.map

package/dist/tools/git.js.map

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

package/dist/tools/grep.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Grep tool — code search and file finding
+ * Primary: ripgrep (rg) via execFileSync
+ * Fallback: native Node.js when rg is not installed
+ */
+import { Tool } from '../core/types.js';
+export declare function grepTool(cwd: string): Tool;
+//# sourceMappingURL=grep.d.ts.map

package/dist/tools/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAiNxC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA+B1C"}

package/dist/tools/grep.js

@@ -0,0 +1,265 @@
+/**
+ * Grep tool — code search and file finding
+ * Primary: ripgrep (rg) via execFileSync
+ * Fallback: native Node.js when rg is not installed
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve, relative } from 'node:path';
+import { DEFAULT_IGNORE, isBinary } from '../core/constants.js';
+const execFileAsync = promisify(execFile);
+const MAX_SEARCH_LINES = 250;
+const MAX_FIND_RESULTS = 100;
+const MAX_FILE_SIZE = 1_048_576; // 1 MB
+// ── Ripgrep helpers ──────────────────────────────────────────────────────
+async function tryRg(args, cwd) {
+    try {
+        const { stdout } = await execFileAsync('rg', args, {
+            cwd, encoding: 'utf-8', timeout: 30_000, maxBuffer: 2 * 1024 * 1024,
+        });
+        return { ok: true, out: stdout.trim(), notFound: false };
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === 'ENOENT')
+            return { ok: false, out: '', notFound: true };
+        // rg exits 1 for no matches, 2 for errors
+        const out = ((err.stdout ?? '') + (err.stderr ?? '')).trim();
+        if (err.code === 1 || err.status === 1)
+            return { ok: true, out: '', notFound: false }; // no matches
+        return { ok: false, out, notFound: false };
+    }
+}
+async function rgSearch(cwd, pattern, path, glob, caseInsensitive, context) {
+    const args = [pattern, '--line-number', '--no-heading', '--color', 'never', '--max-count', String(MAX_SEARCH_LINES)];
+    if (glob)
+        args.push('--glob', glob);
+    if (caseInsensitive)
+        args.push('--ignore-case');
+    if (context && context > 0)
+        args.push('--context', String(context));
+    if (path)
+        args.push(path);
+    const result = await tryRg(args, cwd);
+    if (result.notFound)
+        return ''; // signal to use fallback
+    if (!result.ok)
+        return `Error: ${result.out}`;
+    return result.out || 'No matches found.';
+}
+async function rgFind(cwd, pattern, path) {
+    const args = ['--files', '--glob', pattern];
+    if (path)
+        args.push(path);
+    const result = await tryRg(args, cwd);
+    if (result.notFound)
+        return ''; // signal to use fallback
+    if (!result.ok)
+        return `Error: ${result.out}`;
+    if (!result.out)
+        return 'No matches found.';
+    const lines = result.out.split('\n');
+    if (lines.length > MAX_FIND_RESULTS) {
+        return lines.slice(0, MAX_FIND_RESULTS).join('\n')
+            + `\n... (${MAX_FIND_RESULTS} of ${lines.length} files shown. Narrow with path.)`;
+    }
+    return result.out;
+}
+// ── Native fallback helpers ──────────────────────────────────────────────
+function walkDir(root, maxDepth = 20) {
+    const files = [];
+    function walk(dir, depth) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (DEFAULT_IGNORE.has(entry.name))
+                continue;
+            if (entry.name.startsWith('.') && entry.name !== '.')
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isSymbolicLink())
+                continue;
+            if (entry.isDirectory()) {
+                walk(full, depth + 1);
+                continue;
+            }
+            if (entry.isFile())
+                files.push(full);
+        }
+    }
+    walk(root, 0);
+    return files;
+}
+const MAX_GLOB_LENGTH = 200;
+function matchesGlob(filepath, glob) {
+    // Protect against ReDoS from excessively complex patterns
+    if (glob.length > MAX_GLOB_LENGTH)
+        return false;
+    // Convert glob to regex: * -> [^/]*, ** -> .*, ? -> ., {a,b} -> (a|b), escape dots
+    const re = glob
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '{{GLOBSTAR}}')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\{\{GLOBSTAR\}\}/g, '.*')
+        .replace(/\?/g, '.')
+        .replace(/\{([^}]+)\}/g, (_m, group) => `(${group.replace(/,/g, '|')})`);
+    // If pattern has no path separators, match against basename only
+    if (!glob.includes('/')) {
+        const basename = filepath.split('/').pop() || filepath;
+        return new RegExp(`^${re}$`).test(basename);
+    }
+    return new RegExp(`^${re}$`).test(filepath) || new RegExp(`${re}$`).test(filepath);
+}
+function fallbackSearch(cwd, pattern, searchRoot, glob, caseInsensitive, context) {
+    let regex;
+    try {
+        regex = new RegExp(pattern, caseInsensitive ? 'i' : '');
+    }
+    catch (e) {
+        return `Error: invalid regex — ${e instanceof Error ? e.message : String(e)}`;
+    }
+    const ctx = context && context > 0 ? context : 0;
+    const files = walkDir(searchRoot);
+    const output = [];
+    let matchCount = 0;
+    let truncated = false;
+    for (const file of files) {
+        if (matchCount >= MAX_SEARCH_LINES) {
+            truncated = true;
+            break;
+        }
+        try {
+            const stat = statSync(file);
+            if (stat.size > MAX_FILE_SIZE)
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (isBinary(file))
+            continue;
+        if (glob && !matchesGlob(relative(cwd, file), glob))
+            continue;
+        let content;
+        try {
+            content = readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split('\n');
+        const relPath = relative(cwd, file);
+        const fileMatches = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (regex.test(lines[i])) {
+                const start = Math.max(0, i - ctx);
+                const end = Math.min(lines.length - 1, i + ctx);
+                for (let j = start; j <= end; j++) {
+                    fileMatches.push(`${relPath}:${j + 1}:${lines[j]}`);
+                    matchCount++;
+                    if (matchCount >= MAX_SEARCH_LINES) {
+                        truncated = true;
+                        break;
+                    }
+                }
+                if (truncated)
+                    break;
+            }
+        }
+        if (fileMatches.length > 0) {
+            if (output.length > 0)
+                output.push('');
+            output.push(...fileMatches);
+        }
+        if (truncated)
+            break;
+    }
+    if (output.length === 0)
+        return 'No matches found.';
+    let result = output.join('\n');
+    if (truncated)
+        result += `\n... (${MAX_SEARCH_LINES} lines shown. Narrow with path or glob.)`;
+    return result;
+}
+function fallbackFind(cwd, pattern, searchRoot) {
+    const files = walkDir(searchRoot);
+    const matches = [];
+    for (const file of files) {
+        const relPath = relative(cwd, file);
+        if (matchesGlob(relPath, pattern)) {
+            matches.push(relPath);
+            if (matches.length >= MAX_FIND_RESULTS)
+                break;
+        }
+    }
+    if (matches.length === 0)
+        return 'No matches found.';
+    let result = matches.join('\n');
+    if (matches.length >= MAX_FIND_RESULTS) {
+        result += `\n... (${MAX_FIND_RESULTS} files shown. Narrow with path.)`;
+    }
+    return result;
+}
+// ── Action handlers ──────────────────────────────────────────────────────
+async function doSearch(cwd, pattern, path, glob, caseInsensitive, context) {
+    const searchRoot = path ? resolve(cwd, path) : cwd;
+    if (!searchRoot.startsWith(cwd))
+        return 'Error: path must be within the project directory.';
+    // Try ripgrep first
+    const rgResult = await rgSearch(cwd, pattern, path, glob, caseInsensitive, context);
+    if (rgResult !== '')
+        return rgResult; // '' means rg not found
+    // Fallback to native Node.js
+    return fallbackSearch(cwd, pattern, searchRoot, glob, caseInsensitive, context);
+}
+async function doFind(cwd, pattern, path) {
+    const searchRoot = path ? resolve(cwd, path) : cwd;
+    if (!searchRoot.startsWith(cwd))
+        return 'Error: path must be within the project directory.';
+    // Try ripgrep first
+    const rgResult = await rgFind(cwd, pattern, path);
+    if (rgResult !== '')
+        return rgResult; // '' means rg not found
+    // Fallback to native Node.js
+    return fallbackFind(cwd, pattern, searchRoot);
+}
+// ── Exported tool ────────────────────────────────────────────────────────
+export function grepTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'grep',
+            description: 'Search code and find files. Prefer this over bash for ALL search operations. Actions: search (find pattern in file contents using regex — use this instead of bash grep/rg), find (locate files by name/glob pattern — use this instead of bash find/ls).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['search', 'find'], description: 'search = content regex, find = file name glob.' },
+                    pattern: { type: 'string', description: 'Regex for search, glob for find (e.g. "*.ts", "TODO", "function\\s+\\w+").' },
+                    path: { type: 'string', description: 'Subdirectory to scope (relative to project root). Omit to search everywhere.' },
+                    glob: { type: 'string', description: 'File type filter for action=search (e.g. "*.ts", "*.py"). Not needed for find.' },
+                    case_insensitive: { type: 'boolean', description: 'Case-insensitive matching (search only). Default: false.' },
+                    context: { type: 'number', description: 'Lines of context before and after each match (search only). Default: 0.' }
+                },
+                required: ['action', 'pattern']
+            }
+        },
+        execute: async ({ action, pattern, path, glob, case_insensitive, context }) => {
+            if (!pattern)
+                return 'Error: pattern is required.';
+            switch (action) {
+                case 'search': return doSearch(cwd, pattern, path, glob, case_insensitive, context);
+                case 'find': return doFind(cwd, pattern, path);
+                default: return `Unknown action "${action}". Use: search, find.`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=grep.js.map

package/dist/tools/grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,OAAO;AAExC,4EAA4E;AAE5E,KAAK,UAAU,KAAK,CAAC,IAAc,EAAE,GAAW;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE;YACjD,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;SACpE,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAkF,CAAC;QAC/F,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzE,0CAA0C;QAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,aAAa;QACpG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAe,EAAE,IAAa,EAAE,IAAa,EAChF,eAAyB,EAAE,OAAgB;IAC3C,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrH,IAAI,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,eAAe;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,OAAO,IAAI,OAAO,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,IAAI,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC,CAAC,yBAAyB;IACzD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,CAAC;IAC9C,OAAO,MAAM,CAAC,GAAG,IAAI,mBAAmB,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,OAAe,EAAE,IAAa;IAC/D,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC,CAAC,yBAAyB;IACzD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,GAAG;QAAE,OAAO,mBAAmB,CAAC;IAE5C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;cAC9C,UAAU,gBAAgB,OAAO,KAAK,CAAC,MAAM,kCAAkC,CAAC;IACtF,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC;AAED,4EAA4E;AAE5E,SAAS,OAAO,CAAC,IAAY,EAAE,QAAQ,GAAG,EAAE;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS,IAAI,CAAC,GAAW,EAAE,KAAa;QACtC,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO;QAC7B,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YAAC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7C,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG;gBAAE,SAAS;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,cAAc,EAAE;gBAAE,SAAS;YACrC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,SAAS,WAAW,CAAC,QAAgB,EAAE,IAAY;IACjD,0DAA0D;IAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,KAAK,CAAC;IAEhD,mFAAmF;IACnF,MAAM,EAAE,GAAG,IAAI;SACZ,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC;SAChC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SACvB,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC;SAClC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3E,iEAAiE;IACjE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;QACvD,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,EAAE,OAAe,EAAE,UAAkB,EACtE,IAAa,EAAE,eAAyB,EAAE,OAAgB;IAC1D,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,0BAA0B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,UAAU,IAAI,gBAAgB,EAAE,CAAC;YAAC,SAAS,GAAG,IAAI,CAAC;YAAC,MAAM;QAAC,CAAC;QAChE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa;gBAAE,SAAS;QAC1C,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QACrB,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;YAAE,SAAS;QAE9D,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YAAC,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QAElE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;gBACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;gBAChD,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBAClC,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACpD,UAAU,EAAE,CAAC;oBACb,IAAI,UAAU,IAAI,gBAAgB,EAAE,CAAC;wBAAC,SAAS,GAAG,IAAI,CAAC;wBAAC,MAAM;oBAAC,CAAC;gBAClE,CAAC;gBACD,IAAI,SAAS;oBAAE,MAAM;YACvB,CAAC;QACH,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,SAAS;YAAE,MAAM;IACvB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpD,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,SAAS;QAAE,MAAM,IAAI,UAAU,gBAAgB,0CAA0C,CAAC;IAC9F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,OAAe,EAAE,UAAkB;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,OAAO,CAAC,MAAM,IAAI,gBAAgB;gBAAE,MAAM;QAChD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACrD,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,gBAAgB,kCAAkC,CAAC;IACzE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4EAA4E;AAE5E,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAe,EAAE,IAAa,EAAE,IAAa,EAChF,eAAyB,EAAE,OAAgB;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,mDAAmD,CAAC;IAE5F,oBAAoB;IACpB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IACpF,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC,CAAC,wBAAwB;IAE9D,6BAA6B;IAC7B,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,OAAe,EAAE,IAAa;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,mDAAmD,CAAC;IAE5F,oBAAoB;IACpB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC,CAAC,wBAAwB;IAE9D,6BAA6B;IAC7B,OAAO,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,2PAA2P;YACxQ,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE;oBACnH,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4EAA4E,EAAE;oBACtH,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8EAA8E,EAAE;oBACrH,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gFAAgF,EAAE;oBACvH,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0DAA0D,EAAE;oBAC9G,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yEAAyE,EAAE;iBACpH;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;aAChC;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAGvE,EAAmB,EAAE;YACpB,IAAI,CAAC,OAAO;gBAAE,OAAO,6BAA6B,CAAC;YACnD,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,QAAQ,CAAC,CAAC,OAAO,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;gBACpF,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC/C,OAAO,CAAC,CAAC,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;YACnE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '../core/types.js';
+export declare function memoryTool(cwd: string): Tool;
+//# sourceMappingURL=memory.d.ts.map

package/dist/tools/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA8B5C"}

package/dist/tools/memory.js

@@ -0,0 +1,33 @@
+import { appendGlobalMemory, appendProjectMemory } from '../memory/memory.js';
+export function memoryTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'memory',
+            description: 'Memory operations. Actions: save (persist a fact, decision, or pattern for future sessions).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['save'], description: 'The memory operation to perform.' },
+                    tier: { type: 'string', enum: ['global', 'project'], description: '"global" for preferences, coding style, patterns that apply everywhere. "project" for architecture decisions, current ticket, PR templates, gotchas specific to this codebase.' },
+                    content: { type: 'string', description: 'The fact, decision, or pattern to remember.' }
+                },
+                required: ['action', 'tier', 'content']
+            }
+        },
+        execute: ({ action, tier, content }) => {
+            switch (action) {
+                case 'save': {
+                    if (tier === 'global') {
+                        appendGlobalMemory(content, cwd);
+                        return 'Saved to global memory.';
+                    }
+                    appendProjectMemory(content, cwd);
+                    return 'Saved to project memory.';
+                }
+                default: return `Unknown action "${action}". Use: save.`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8FAA8F;YAC3G,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC3F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,gLAAgL,EAAE;oBACpP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;iBACxF;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;aACxC;SACF;QACD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAqD,EAAU,EAAE;YAChG,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACtB,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;wBACjC,OAAO,yBAAyB,CAAC;oBACnC,CAAC;oBACD,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;oBAClC,OAAO,0BAA0B,CAAC;gBACpC,CAAC;gBACD,OAAO,CAAC,CAAC,OAAO,mBAAmB,MAAM,eAAe,CAAC;YAC3D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/plan.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '../core/types.js';
+export declare function planTool(cwd: string): Tool;
+//# sourceMappingURL=plan.d.ts.map

package/dist/tools/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAmD1C"}

package/dist/tools/plan.js

@@ -0,0 +1,60 @@
+import { savePlan, listPlans, loadPlanByName, appendPlan, setActivePlan } from '../memory/memory.js';
+export function planTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'plan',
+            description: 'Manage task plans. Save a new plan, append to the latest plan, switch the active plan, list all plans, or read a specific plan by name. Plans are timestamped and the latest is automatically loaded as context.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['save', 'list', 'read', 'append', 'switch'], description: '"save" to create a new plan, "append" to add content to the latest plan, "switch" to activate a different plan by name, "list" to see all plans, "read" to view a specific plan.' },
+                    content: { type: 'string', description: 'Plan content (required for action=save).' },
+                    name: { type: 'string', description: 'Plan name for save (e.g. "refactor-cli") or read (e.g. "2026-04-13T12-31-22-refactor-cli").' }
+                },
+                required: ['action']
+            }
+        },
+        execute: ({ action, content, name }) => {
+            switch (action) {
+                case 'save': {
+                    if (!content)
+                        return 'Error: content is required for action=save.';
+                    const filePath = savePlan(content, name, cwd);
+                    return `Plan saved: ${filePath}`;
+                }
+                case 'append': {
+                    if (!content)
+                        return 'Error: content is required for action=append.';
+                    const filePath = appendPlan(content, cwd);
+                    return `Appended to plan: ${filePath}`;
+                }
+                case 'switch': {
+                    if (!name)
+                        return 'Error: name is required for action=switch. Use action=list to see available plans.';
+                    const plans = listPlans(cwd);
+                    const match = plans.find(p => p.name.includes(name));
+                    if (!match)
+                        return `No plan matching "${name}". Use action=list to see available plans.`;
+                    setActivePlan(match.name, cwd);
+                    return `Switched to plan: ${match.name}`;
+                }
+                case 'list': {
+                    const plans = listPlans(cwd);
+                    if (plans.length === 0)
+                        return 'No plans saved yet.';
+                    return plans.map(p => `${p.name}  ${p.path}`).join('\n');
+                }
+                case 'read': {
+                    if (!name)
+                        return 'Error: name is required for action=read. Use action=list to see available plans.';
+                    const result = loadPlanByName(name, cwd);
+                    return result || `No plan found with name "${name}".`;
+                }
+                default:
+                    return `Unknown action "${action}". Use "save", "append", "switch", "list", or "read".`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=plan.js.map