bobo-ai-cli 1.0.1

package/dist/structured-skills-commands.js

@@ -0,0 +1,126 @@
+import chalk from 'chalk';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import matter from 'gray-matter';
+import { KnowledgeLoader } from './structured/loader.js';
+import { KnowledgeSearch } from './structured/search.js';
+import { SkillRunner } from './structured/skill-runner.js';
+import { createProjectScaffold } from './structured/project-scaffold.js';
+import { getStructuredKnowledgePath } from './structured/paths.js';
+import { renderSearchResult, renderSkill } from './structured/render-markdown.js';
+import { renderTable } from './structured/render-table.js';
+export function registerStructuredSkillsCommand(program) {
+    const skills = program.command('skills').description('Browse and compose structured skills');
+    skills
+        .command('list')
+        .description('List structured skills')
+        .option('-c, --category <cat>', '按分类过滤')
+        .action(async (opts) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const all = await loader.listSkills();
+        const filtered = opts.category ? all.filter((skill) => skill.category === opts.category) : all;
+        if (filtered.length === 0) {
+            console.log(chalk.dim('No skills found.'));
+            return;
+        }
+        renderTable(['ID', 'Title', 'Category', 'Tags'], filtered.map((skill) => [skill.id, skill.title, skill.category, skill.tags.join(', ')]));
+        console.log(chalk.dim(`\n${filtered.length} skills`));
+    });
+    skills
+        .command('show <id>')
+        .description('Show full skill content')
+        .action(async (id) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const skill = await loader.loadSkill(id);
+        if (!skill) {
+            console.log(chalk.red(`Skill not found: ${id}`));
+            process.exit(1);
+        }
+        renderSkill(skill);
+    });
+    skills
+        .command('search <query>')
+        .description('Search structured skills')
+        .action(async (query) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const search = new KnowledgeSearch(loader);
+        const results = await search.searchByType(query, 'skill');
+        if (results.length === 0) {
+            console.log(chalk.dim('No matching skills.'));
+            return;
+        }
+        results.forEach(renderSearchResult);
+    });
+    skills
+        .command('deps <id>')
+        .description('Show skill dependency order')
+        .action(async (id) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const runner = new SkillRunner(loader);
+        const resolved = await runner.resolveDependencies(id);
+        console.log(chalk.bold(`\nDependency order for ${id}`));
+        resolved.forEach((skill, index) => {
+            console.log(`  ${index + 1}. ${skill.id}`);
+        });
+    });
+    skills
+        .command('bundle <id>')
+        .description('构建技能依赖 bundle')
+        .action(async (id) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const runner = new SkillRunner(loader);
+        const bundle = await runner.buildBundle(id);
+        console.log(chalk.bold(`\nRoot: ${bundle.root.id}`));
+        console.log(chalk.dim(`Dependencies: ${bundle.dependencies.map((skill) => skill.id).join(', ') || 'none'}`));
+        console.log(chalk.dim('─'.repeat(60)));
+        console.log(bundle.combinedContent);
+    });
+    skills
+        .command('export <id>')
+        .description('Export structured skill as markdown')
+        .option('-o, --output <file>', '输出文件路径')
+        .action(async (id, opts) => {
+        const loader = new KnowledgeLoader(getStructuredKnowledgePath());
+        const runner = new SkillRunner(loader);
+        const markdown = await runner.exportSkill(id);
+        if (!opts.output) {
+            console.log(markdown);
+            return;
+        }
+        await mkdir(dirname(opts.output), { recursive: true });
+        await writeFile(opts.output, markdown, 'utf-8');
+        console.log(chalk.green(`Exported ${id} to ${opts.output}`));
+    });
+    skills
+        .command('import <file>')
+        .description('Import skill markdown into knowledge base')
+        .action(async (file) => {
+        const raw = await readFile(file, 'utf-8');
+        const parsed = matter(raw);
+        const skillId = parsed.data.id;
+        if (!skillId) {
+            console.log(chalk.red('Imported skill is missing frontmatter id.'));
+            process.exit(1);
+        }
+        const outputPath = join(getStructuredKnowledgePath(), 'skills', `${skillId}.md`);
+        await writeFile(outputPath, raw, 'utf-8');
+        console.log(chalk.green(`Imported skill ${skillId} to ${outputPath}`));
+    });
+    return skills;
+}
+export function registerTemplateProjectSubcommand(template) {
+    template
+        .command('project')
+        .description('生成 .claude 项目脚手架')
+        .requiredOption('-d, --dir <dir>', '目标项目目录')
+        .option('-n, --name <name>', '项目名称', 'My Project')
+        .action(async (opts) => {
+        const created = await createProjectScaffold({
+            targetDir: opts.dir,
+            projectName: opts.name,
+        });
+        console.log(chalk.green(`Generated project scaffold in ${opts.dir}`));
+        created.forEach((file) => console.log(chalk.dim(`  - ${file}`)));
+    });
+}
+//# sourceMappingURL=structured-skills-commands.js.map

package/dist/structured-skills-commands.js.map

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

package/dist/structured-template-commands.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerStructuredTemplateCommand(program: Command): Command;

package/dist/structured-template-commands.js

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+import { registerTemplateProjectSubcommand } from './structured-skills-commands.js';
+export function registerStructuredTemplateCommand(program) {
+    const template = program.command('template').description('Generate structured templates');
+    template
+        .command('skill')
+        .description('Generate skill template')
+        .option('-n, --name <name>', '技能名称')
+        .action((opts) => {
+        const name = opts.name || 'my-new-skill';
+        const title = name.replace(/-/g, ' ').replace(/\b\w/g, (value) => value.toUpperCase());
+        console.log(chalk.green('Skill scaffold:'));
+        console.log(chalk.dim('─'.repeat(40)));
+        console.log(`---\nid: ${name}\ntitle: "${title}"\ncategory: other\ntags: []\ntriggers: []\ndependencies: []\n---\n\n# ${title}\n\nDescribe what this skill does and when to trigger it.\n`);
+        console.log(chalk.dim('─'.repeat(40)));
+        console.log(chalk.dim(`Save to: .claude/skills/${name}/SKILL.md`));
+    });
+    template
+        .command('rule')
+        .description('Generate rule template')
+        .option('-n, --name <name>', '规则名称')
+        .action((opts) => {
+        const name = opts.name || 'my-new-rule';
+        const title = name.replace(/-/g, ' ').replace(/\b\w/g, (value) => value.toUpperCase());
+        console.log(chalk.green('Rule scaffold:'));
+        console.log(chalk.dim('─'.repeat(40)));
+        console.log(`---\nid: ${name}\ntitle: "${title}"\ncategory: domain\ntags: []\n---\n\n# ${title}\n\nDescribe the rule and when it applies.\n`);
+        console.log(chalk.dim('─'.repeat(40)));
+        console.log(chalk.dim(`Save to: .claude/rules/domain/${name}.md`));
+    });
+    registerTemplateProjectSubcommand(template);
+    return template;
+}
+//# sourceMappingURL=structured-template-commands.js.map

package/dist/structured-template-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-template-commands.js","sourceRoot":"","sources":["../src/structured-template-commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAEpF,MAAM,UAAU,iCAAiC,CAAC,OAAgB;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC;IAE1F,QAAQ;SACL,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,yBAAyB,CAAC;SACtC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACnC,MAAM,CAAC,CAAC,IAAuB,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,aAAa,KAAK,0EAA0E,KAAK,6DAA6D,CAAC,CAAC;QAC5L,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2BAA2B,IAAI,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACnC,MAAM,CAAC,CAAC,IAAuB,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,aAAa,KAAK,2CAA2C,KAAK,8CAA8C,CAAC,CAAC;QAC9I,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAiC,IAAI,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEL,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IAE5C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { ChatCompletionTool } from 'openai/resources/index.js';
+export declare const toolDefinitions: ChatCompletionTool[];
+export declare function executeTool(name: string, args: Record<string, unknown>): string;

package/dist/tools/index.js

@@ -0,0 +1,450 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { glob } from 'glob';
+import { saveMemory, searchMemory } from '../memory.js';
+import { plannerToolDefinitions, executePlannerTool, isPlannerTool } from '../planner.js';
+import { webToolDefinitions, executeWebTool, isWebTool } from '../web.js';
+// ─── Core Tool Definitions ───────────────────────────────────
+const coreToolDefinitions = [
+    {
+        type: 'function',
+        function: {
+            name: 'read_file',
+            description: 'Read the contents of a file. Returns the file content as a string.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Path to the file (relative to CWD or absolute)' },
+                    offset: { type: 'number', description: 'Line number to start reading from (1-indexed)' },
+                    limit: { type: 'number', description: 'Max number of lines to read' },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'write_file',
+            description: 'Write content to a file. Creates parent directories if needed. Overwrites existing files.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Path to the file' },
+                    content: { type: 'string', description: 'Content to write' },
+                },
+                required: ['path', 'content'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'edit_file',
+            description: 'Replace exact text in a file. oldText must match exactly.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Path to the file' },
+                    oldText: { type: 'string', description: 'Exact text to find' },
+                    newText: { type: 'string', description: 'Replacement text' },
+                },
+                required: ['path', 'oldText', 'newText'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'search_files',
+            description: 'Search for files matching a glob pattern, optionally grep for content.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: { type: 'string', description: 'Glob pattern (e.g. "src/**/*.ts")' },
+                    grep: { type: 'string', description: 'Optional regex to search in file contents' },
+                    maxResults: { type: 'number', description: 'Max results to return (default 20)' },
+                },
+                required: ['pattern'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'list_directory',
+            description: 'List files and directories in a given path.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Directory path (default: CWD)' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'shell',
+            description: 'Execute a shell command. Returns stdout and stderr.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: { type: 'string', description: 'Shell command to execute' },
+                    cwd: { type: 'string', description: 'Working directory (default: CWD)' },
+                    timeout: { type: 'number', description: 'Timeout in seconds (default: 30)' },
+                },
+                required: ['command'],
+            },
+        },
+    },
+    // ─── Memory Tools ──────────────────────────────────────────
+    {
+        type: 'function',
+        function: {
+            name: 'save_memory',
+            description: 'Save important information to persistent memory. Categories: user (preferences), feedback (corrections), project (active tasks), reference (knowledge), experience (lessons learned).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    category: {
+                        type: 'string',
+                        enum: ['user', 'feedback', 'project', 'reference', 'experience'],
+                        description: 'Memory category',
+                    },
+                    content: { type: 'string', description: 'What to remember' },
+                },
+                required: ['category', 'content'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'search_memory',
+            description: 'Search persistent memory for relevant past information, preferences, or learnings.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search query' },
+                },
+                required: ['query'],
+            },
+        },
+    },
+    // ─── Git Tools ─────────────────────────────────────────────
+    {
+        type: 'function',
+        function: {
+            name: 'git_status',
+            description: 'Get git status of the current repository.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    cwd: { type: 'string', description: 'Repository path (default: CWD)' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_diff',
+            description: 'Show git diff (staged, unstaged, or between refs).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    ref: { type: 'string', description: 'Git ref to diff against (e.g. HEAD~1, main)' },
+                    staged: { type: 'boolean', description: 'Show staged changes only' },
+                    cwd: { type: 'string', description: 'Repository path (default: CWD)' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_log',
+            description: 'Show recent git log entries.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    count: { type: 'number', description: 'Number of entries (default: 10)' },
+                    oneline: { type: 'boolean', description: 'One-line format (default: true)' },
+                    cwd: { type: 'string', description: 'Repository path (default: CWD)' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_commit',
+            description: 'Stage all changes and commit with a message. Use after making file edits.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    message: { type: 'string', description: 'Commit message' },
+                    addAll: { type: 'boolean', description: 'Run git add -A before commit (default: true)' },
+                    cwd: { type: 'string', description: 'Repository path (default: CWD)' },
+                },
+                required: ['message'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_push',
+            description: 'Push commits to remote repository.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    remote: { type: 'string', description: 'Remote name (default: origin)' },
+                    branch: { type: 'string', description: 'Branch name (default: current branch)' },
+                    cwd: { type: 'string', description: 'Repository path (default: CWD)' },
+                },
+                required: [],
+            },
+        },
+    },
+];
+// ─── Combined Tool Definitions ───────────────────────────────
+export const toolDefinitions = [
+    ...coreToolDefinitions,
+    ...plannerToolDefinitions,
+    ...webToolDefinitions,
+];
+// ─── Unified Tool Execution ──────────────────────────────────
+export function executeTool(name, args) {
+    try {
+        // Check delegated tools first
+        if (isPlannerTool(name))
+            return executePlannerTool(name, args);
+        if (isWebTool(name))
+            return executeWebTool(name, args);
+        // Core tools
+        switch (name) {
+            case 'read_file': return readFile(args);
+            case 'write_file': return writeFile(args);
+            case 'edit_file': return editFile(args);
+            case 'search_files': return searchFiles(args);
+            case 'list_directory': return listDirectory(args);
+            case 'shell': return shellExec(args);
+            case 'save_memory': return saveMemoryTool(args);
+            case 'search_memory': return searchMemoryTool(args);
+            case 'git_status': return gitStatus(args);
+            case 'git_diff': return gitDiff(args);
+            case 'git_log': return gitLog(args);
+            case 'git_commit': return gitCommit(args);
+            case 'git_push': return gitPush(args);
+            default: return `Error: Unknown tool "${name}"`;
+        }
+    }
+    catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`;
+    }
+}
+// ─── Core Tool Implementations ───────────────────────────────
+function resolvePath(p) {
+    return resolve(process.cwd(), p);
+}
+function readFile(args) {
+    const filePath = resolvePath(args.path);
+    if (!existsSync(filePath))
+        return `File not found: ${filePath}`;
+    const stat = statSync(filePath);
+    if (stat.isDirectory())
+        return `Path is a directory: ${filePath}`;
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const offset = (args.offset || 1) - 1;
+    const limit = args.limit || lines.length;
+    const slice = lines.slice(offset, offset + limit);
+    return slice.map((line, i) => `${offset + i + 1} | ${line}`).join('\n');
+}
+function writeFile(args) {
+    const filePath = resolvePath(args.path);
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(filePath, args.content);
+    return `Written ${args.content.length} bytes to ${filePath}`;
+}
+function editFile(args) {
+    const filePath = resolvePath(args.path);
+    if (!existsSync(filePath))
+        return `File not found: ${filePath}`;
+    const content = readFileSync(filePath, 'utf-8');
+    const oldText = args.oldText;
+    const newText = args.newText;
+    if (!content.includes(oldText)) {
+        return `oldText not found in file. Make sure it matches exactly (including whitespace).`;
+    }
+    const updated = content.replace(oldText, newText);
+    writeFileSync(filePath, updated);
+    return `Edited ${filePath}`;
+}
+function searchFiles(args) {
+    const pattern = args.pattern;
+    const grepPattern = args.grep;
+    const maxResults = args.maxResults || 20;
+    const files = glob.sync(pattern, { cwd: process.cwd(), nodir: true });
+    if (files.length === 0)
+        return `No files match pattern: ${pattern}`;
+    if (!grepPattern) {
+        return files.slice(0, maxResults).join('\n');
+    }
+    const regex = new RegExp(grepPattern, 'i');
+    const results = [];
+    for (const file of files) {
+        if (results.length >= maxResults)
+            break;
+        try {
+            const content = readFileSync(resolvePath(file), 'utf-8');
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                if (regex.test(lines[i])) {
+                    results.push(`${file}:${i + 1}: ${lines[i].trim()}`);
+                    if (results.length >= maxResults)
+                        break;
+                }
+            }
+        }
+        catch { /* skip unreadable */ }
+    }
+    return results.length > 0 ? results.join('\n') : `No matches for "${grepPattern}" in ${files.length} files`;
+}
+function listDirectory(args) {
+    const dirPath = resolvePath(args.path || '.');
+    if (!existsSync(dirPath))
+        return `Directory not found: ${dirPath}`;
+    try {
+        const result = execSync(`ls -la "${dirPath}"`, { encoding: 'utf-8', timeout: 5000 });
+        return result.trim();
+    }
+    catch (e) {
+        return `Error listing directory: ${e instanceof Error ? e.message : String(e)}`;
+    }
+}
+function shellExec(args) {
+    const command = args.command;
+    const cwd = args.cwd ? resolvePath(args.cwd) : process.cwd();
+    const timeout = (args.timeout || 30) * 1000;
+    try {
+        const result = execSync(command, {
+            cwd,
+            encoding: 'utf-8',
+            timeout,
+            maxBuffer: 1024 * 1024,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim() || '(no output)';
+    }
+    catch (e) {
+        const err = e;
+        const stdout = err.stdout || '';
+        const stderr = err.stderr || '';
+        const code = err.status ?? 1;
+        return `Exit code: ${code}\n${stdout}\n${stderr}`.trim();
+    }
+}
+function saveMemoryTool(args) {
+    const now = new Date();
+    const timestamp = now.toISOString().split('T')[0] + ' ' + now.toTimeString().split(' ')[0];
+    return saveMemory({
+        category: args.category,
+        content: args.content,
+        timestamp,
+    });
+}
+function searchMemoryTool(args) {
+    return searchMemory(args.query);
+}
+// ─── Git Tool Implementations ────────────────────────────────
+function gitStatus(args) {
+    const cwd = args.cwd ? resolvePath(args.cwd) : process.cwd();
+    try {
+        const status = execSync('git status --short', { cwd, encoding: 'utf-8', timeout: 5000 });
+        const branch = execSync('git branch --show-current', { cwd, encoding: 'utf-8', timeout: 5000 }).trim();
+        return `Branch: ${branch}\n${status.trim() || '(clean)'}`;
+    }
+    catch (e) {
+        return `Not a git repo or git error: ${e.message}`;
+    }
+}
+function gitDiff(args) {
+    const cwd = args.cwd ? resolvePath(args.cwd) : process.cwd();
+    const ref = args.ref;
+    const staged = args.staged;
+    let cmd = 'git diff';
+    if (staged)
+        cmd += ' --staged';
+    if (ref)
+        cmd += ` ${ref}`;
+    cmd += ' --stat';
+    try {
+        const stat = execSync(cmd, { cwd, encoding: 'utf-8', timeout: 10000 });
+        return stat.trim() || '(no changes)';
+    }
+    catch (e) {
+        return `Git diff error: ${e.message}`;
+    }
+}
+function gitLog(args) {
+    const cwd = args.cwd ? resolvePath(args.cwd) : process.cwd();
+    const count = args.count || 10;
+    const oneline = args.oneline !== false;
+    const format = oneline ? '--oneline' : '--format=%h %s (%ar) <%an>';
+    try {
+        const log = execSync(`git log ${format} -${count}`, { cwd, encoding: 'utf-8', timeout: 5000 });
+        return log.trim() || '(no commits)';
+    }
+    catch (e) {
+        return `Git log error: ${e.message}`;
+    }
+}
+function gitCommit(args) {
+    const cwd = args.cwd ? resolvePath(args.cwd) : process.cwd();
+    const message = args.message;
+    const addAll = args.addAll !== false;
+    try {
+        if (addAll) {
+            execSync('git add -A', { cwd, encoding: 'utf-8', timeout: 5000 });
+        }
+        const result = execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 10000,
+        });
+        return result.trim();
+    }
+    catch (e) {
+        const err = e;
+        return `Git commit error: ${err.stdout || err.stderr || e.message}`.trim();
+    }
+}
+function gitPush(args) {
+    const cwd = args.cwd ? resolvePath(args.cwd) : process.cwd();
+    const remote = args.remote || 'origin';
+    const branch = args.branch;
+    try {
+        const cmd = branch ? `git push ${remote} ${branch}` : `git push ${remote}`;
+        const result = execSync(cmd, { cwd, encoding: 'utf-8', timeout: 30000, stdio: ['pipe', 'pipe', 'pipe'] });
+        return result.trim() || 'Push successful';
+    }
+    catch (e) {
+        const err = e;
+        // git push outputs to stderr on success
+        const output = (err.stderr || '') + (err.stdout || '');
+        if (output.includes('->'))
+            return output.trim();
+        return `Git push error: ${output || e.message}`.trim();
+    }
+}
+//# sourceMappingURL=index.js.map