codingbuddy 5.1.3 → 5.3.0

package/dist/src/cli/cli.js

@@ -28,6 +28,58 @@ function parseArgs(args) {
         const restart = args.includes('--restart');
         return { command: 'tui', options: { ...options, restart } };
     }
+    if (command === 'install') {
+        const installSource = args[1];
+        const installForce = args.includes('--force') || args.includes('-f');
+        return {
+            command: 'install',
+            options: { ...options, installSource, installForce },
+        };
+    }
+    if (command === 'plugins') {
+        return { command: 'plugins', options };
+    }
+    if (command === 'search') {
+        const searchQuery = args.slice(1).join(' ');
+        return {
+            command: 'search',
+            options: { ...options, searchQuery },
+        };
+    }
+    if (command === 'uninstall') {
+        const uninstallName = args[1];
+        const uninstallYes = args.includes('--yes') || args.includes('-y');
+        return {
+            command: 'uninstall',
+            options: { ...options, uninstallName, uninstallYes },
+        };
+    }
+    if (command === 'update') {
+        const updatePluginName = args[1];
+        return {
+            command: 'update',
+            options: { ...options, updatePluginName },
+        };
+    }
+    if (command === 'create-plugin') {
+        const createPluginName = args[1];
+        let createPluginTemplate;
+        const templateIdx = args.indexOf('--template');
+        if (templateIdx !== -1) {
+            createPluginTemplate = args[templateIdx + 1];
+        }
+        return {
+            command: 'create-plugin',
+            options: { ...options, createPluginName, createPluginTemplate },
+        };
+    }
+    if (command === 'completion') {
+        const shell = args[1];
+        return {
+            command: 'completion',
+            options: { ...options, shell },
+        };
+    }
     if (command !== 'init') {
         return { command: 'help', options };
     }
@@ -54,14 +106,21 @@ CodingBuddy CLI - AI-powered project configuration generator
 
 Usage:
   codingbuddy init [path] [options]    Initialize configuration
+  codingbuddy install <git-url>        Install a plugin from git repository
+  codingbuddy search <query>           Search plugins in the registry
+  codingbuddy plugins                  List installed plugins
+  codingbuddy update [name]            Check and update outdated plugins
+  codingbuddy uninstall <name>         Uninstall a plugin
   codingbuddy mcp                      Start MCP server (stdio mode)
   codingbuddy tui                      Monitor agent execution in real-time
   codingbuddy tui --restart            Restart TUI client (fixes blank screen)
+  codingbuddy create-plugin <name>     Scaffold a new plugin project
+  codingbuddy completion <shell>       Generate shell completions (bash, zsh, fish)
   codingbuddy --help                   Show this help
   codingbuddy --version                Show version
 
 Options:
-  --force, -f           Overwrite existing config
+  --force, -f           Overwrite existing config / force install
   --yes, -y             Accept detected defaults (quick setup)
   --api-key <key>       Anthropic API key (or set ANTHROPIC_API_KEY env)
 
@@ -69,6 +128,15 @@ Examples:
   codingbuddy init                     Initialize in current directory
   codingbuddy init ./my-project        Initialize in specific directory
   codingbuddy init --force             Overwrite existing config
+  codingbuddy install github:user/repo Install a community plugin
+  codingbuddy search nextjs            Search for Next.js plugins
+  codingbuddy plugins                  List all installed plugins
+  codingbuddy update                    Check all plugins for updates
+  codingbuddy update my-plugin         Update a specific plugin
+  codingbuddy uninstall my-plugin      Remove a plugin
+  codingbuddy uninstall my-plugin -y   Remove without confirmation
+  codingbuddy create-plugin my-plugin   Scaffold minimal plugin
+  codingbuddy create-plugin my-plugin --template full  Scaffold with examples
   codingbuddy mcp                      Start MCP server for AI assistants
 
 Note:
@@ -116,6 +184,109 @@ async function main(args = process.argv.slice(2)) {
             await runTui({ restart: options.restart ?? false });
             break;
         }
+        case 'search': {
+            const { runSearch } = await Promise.resolve().then(() => require('./plugin/search.command'));
+            if (!options.searchQuery) {
+                process.stderr.write('Error: Missing query. Usage: codingbuddy search <query>\n');
+                process.exitCode = 1;
+                break;
+            }
+            const searchResult = await runSearch({ query: options.searchQuery });
+            if (!searchResult.success) {
+                process.exitCode = 1;
+            }
+            break;
+        }
+        case 'install': {
+            const { runInstall } = await Promise.resolve().then(() => require('./plugin/install.command'));
+            if (!options.installSource) {
+                process.stderr.write('Error: Missing git URL. Usage: codingbuddy install <git-url>\n');
+                process.exitCode = 1;
+                break;
+            }
+            const installResult = await runInstall({
+                source: options.installSource,
+                projectRoot: options.projectRoot ?? process.cwd(),
+                force: options.installForce ?? false,
+            });
+            if (!installResult.success) {
+                process.exitCode = 1;
+            }
+            break;
+        }
+        case 'plugins': {
+            const { runPlugins } = await Promise.resolve().then(() => require('./plugin/plugins.command'));
+            const pluginsResult = runPlugins({
+                projectRoot: options.projectRoot ?? process.cwd(),
+            });
+            if (!pluginsResult.success) {
+                process.exitCode = 1;
+            }
+            break;
+        }
+        case 'uninstall': {
+            const { runUninstall } = await Promise.resolve().then(() => require('./plugin/uninstall.command'));
+            if (!options.uninstallName) {
+                process.stderr.write('Error: Missing plugin name. Usage: codingbuddy uninstall <name>\n');
+                process.exitCode = 1;
+                break;
+            }
+            const uninstallResult = runUninstall({
+                pluginName: options.uninstallName,
+                projectRoot: options.projectRoot ?? process.cwd(),
+                yes: options.uninstallYes ?? false,
+            });
+            if (!uninstallResult.success && !uninstallResult.confirmationRequired) {
+                process.exitCode = 1;
+            }
+            if (uninstallResult.confirmationRequired) {
+                process.stderr.write('Confirmation required. Use --yes or -y to skip.\n');
+                process.exitCode = 1;
+            }
+            break;
+        }
+        case 'update': {
+            const { runUpdate } = await Promise.resolve().then(() => require('./plugin/update.command'));
+            const updateResult = await runUpdate({
+                projectRoot: options.projectRoot ?? process.cwd(),
+                pluginName: options.updatePluginName,
+            });
+            if (!updateResult.success) {
+                process.exitCode = 1;
+            }
+            break;
+        }
+        case 'create-plugin': {
+            const { runCreatePlugin } = await Promise.resolve().then(() => require('./plugin/create-plugin.command'));
+            if (!options.createPluginName) {
+                process.stderr.write('Error: Missing plugin name. Usage: codingbuddy create-plugin <name> [--template minimal|full]\n');
+                process.exitCode = 1;
+                break;
+            }
+            const template = options.createPluginTemplate === 'full' ? 'full' : 'minimal';
+            const createResult = await runCreatePlugin({
+                name: options.createPluginName,
+                outputDir: process.cwd(),
+                template,
+            });
+            if (!createResult.success) {
+                process.exitCode = 1;
+            }
+            break;
+        }
+        case 'completion': {
+            const { runCompletion } = await Promise.resolve().then(() => require('./completion'));
+            if (!options.shell) {
+                process.stderr.write('Error: Missing shell type. Usage: codingbuddy completion <bash|zsh|fish>\n');
+                process.exitCode = 1;
+                break;
+            }
+            const completionResult = runCompletion({ shell: options.shell });
+            if (!completionResult.success) {
+                process.exitCode = 1;
+            }
+            break;
+        }
         case 'init': {
             const result = await (0, init_1.runInit)(options);
             if (!result.success) {

package/dist/src/cli/cli.types.d.ts

@@ -15,4 +15,22 @@ export interface InitResult {
 export interface TuiOptions {
     restart: boolean;
 }
+export interface InstallOptions {
+    installSource?: string;
+    installForce?: boolean;
+}
+export interface UninstallOptions {
+    uninstallName?: string;
+    uninstallYes?: boolean;
+}
+export interface SearchOptions {
+    searchQuery?: string;
+}
+export interface UpdateOptions {
+    updatePluginName?: string;
+}
+export interface CreatePluginOptions {
+    createPluginName?: string;
+    createPluginTemplate?: string;
+}
 export type LogLevel = 'info' | 'success' | 'warn' | 'error';

package/dist/src/cli/completion/completion.d.ts

@@ -0,0 +1,16 @@
+export declare const COMMANDS: readonly ["init", "install", "search", "plugins", "update", "uninstall", "mcp", "tui", "completion"];
+export declare const GLOBAL_FLAGS: readonly ["--help", "--version"];
+export declare const COMMAND_FLAGS: Record<string, readonly string[]>;
+export declare function getPluginNames(projectRoot: string): string[];
+export declare function generateBashCompletion(): string;
+export declare function generateZshCompletion(): string;
+export declare function generateFishCompletion(): string;
+export declare function generateCompletion(shell: string): string | null;
+export interface CompletionOptions {
+    shell: string;
+}
+export interface CompletionResult {
+    success: boolean;
+    error?: string;
+}
+export declare function runCompletion(options: CompletionOptions): CompletionResult;

package/dist/src/cli/completion/completion.js

@@ -0,0 +1,276 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_FLAGS = exports.GLOBAL_FLAGS = exports.COMMANDS = void 0;
+exports.getPluginNames = getPluginNames;
+exports.generateBashCompletion = generateBashCompletion;
+exports.generateZshCompletion = generateZshCompletion;
+exports.generateFishCompletion = generateFishCompletion;
+exports.generateCompletion = generateCompletion;
+exports.runCompletion = runCompletion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.COMMANDS = [
+    'init',
+    'install',
+    'search',
+    'plugins',
+    'update',
+    'uninstall',
+    'mcp',
+    'tui',
+    'completion',
+];
+exports.GLOBAL_FLAGS = ['--help', '--version'];
+exports.COMMAND_FLAGS = {
+    init: ['--force', '--yes', '--api-key'],
+    install: ['--force'],
+    uninstall: ['--yes'],
+    tui: ['--restart'],
+    completion: ['bash', 'zsh', 'fish'],
+};
+const COMMAND_DESCRIPTIONS = {
+    init: 'Initialize configuration',
+    install: 'Install a plugin from git repository',
+    search: 'Search plugins in the registry',
+    plugins: 'List installed plugins',
+    update: 'Check and update outdated plugins',
+    uninstall: 'Uninstall a plugin',
+    mcp: 'Start MCP server (stdio mode)',
+    tui: 'Monitor agent execution in real-time',
+    completion: 'Generate shell completion script',
+};
+function getPluginNames(projectRoot) {
+    const pluginsPath = (0, path_1.join)(projectRoot, '.codingbuddy', 'plugins.json');
+    if (!(0, fs_1.existsSync)(pluginsPath)) {
+        return [];
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(pluginsPath, 'utf-8');
+        const data = JSON.parse(raw);
+        return (data.plugins ?? []).map(p => p.name);
+    }
+    catch {
+        return [];
+    }
+}
+function generateBashCompletion() {
+    const cmds = exports.COMMANDS.join(' ');
+    const globalFlags = exports.GLOBAL_FLAGS.join(' ');
+    const initFlags = (exports.COMMAND_FLAGS.init ?? []).join(' ');
+    const installFlags = (exports.COMMAND_FLAGS.install ?? []).join(' ');
+    const uninstallFlags = (exports.COMMAND_FLAGS.uninstall ?? []).join(' ');
+    const tuiFlags = (exports.COMMAND_FLAGS.tui ?? []).join(' ');
+    return `#!/bin/bash
+# codingbuddy bash completion
+# Install: codingbuddy completion bash >> ~/.bashrc
+#   or:    codingbuddy completion bash > /etc/bash_completion.d/codingbuddy
+
+_codingbuddy_get_plugin_names() {
+  local plugins_file=".codingbuddy/plugins.json"
+  if [[ -f "$plugins_file" ]]; then
+    grep -o '"name"[[:space:]]*:[[:space:]]*"[^"]*"' "$plugins_file" | sed 's/"name"[[:space:]]*:[[:space:]]*"\\([^"]*\\)"/\\1/'
+  fi
+}
+
+_codingbuddy_completions() {
+  local cur prev commands
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  commands="${cmds}"
+
+  # Complete commands at position 1
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "$commands ${globalFlags}" -- "$cur") )
+    return
+  fi
+
+  # Complete based on command
+  case "\${COMP_WORDS[1]}" in
+    init)
+      COMPREPLY=( $(compgen -W "${initFlags}" -- "$cur") )
+      ;;
+    install)
+      COMPREPLY=( $(compgen -W "${installFlags}" -- "$cur") )
+      ;;
+    uninstall)
+      if [[ \${COMP_CWORD} -eq 2 ]]; then
+        local plugins=$(_codingbuddy_get_plugin_names)
+        COMPREPLY=( $(compgen -W "$plugins ${uninstallFlags}" -- "$cur") )
+      else
+        COMPREPLY=( $(compgen -W "${uninstallFlags}" -- "$cur") )
+      fi
+      ;;
+    update)
+      if [[ \${COMP_CWORD} -eq 2 ]]; then
+        local plugins=$(_codingbuddy_get_plugin_names)
+        COMPREPLY=( $(compgen -W "$plugins" -- "$cur") )
+      fi
+      ;;
+    tui)
+      COMPREPLY=( $(compgen -W "${tuiFlags}" -- "$cur") )
+      ;;
+    completion)
+      COMPREPLY=( $(compgen -W "bash zsh fish" -- "$cur") )
+      ;;
+  esac
+}
+
+complete -F _codingbuddy_completions codingbuddy
+`;
+}
+function generateZshCompletion() {
+    const cmdEntries = exports.COMMANDS.map(cmd => `      '${cmd}:${COMMAND_DESCRIPTIONS[cmd] ?? cmd}'`).join('\n');
+    const initFlags = (exports.COMMAND_FLAGS.init ?? [])
+        .map(f => `        '${f}[${f === '--force' ? 'Overwrite existing config' : f === '--yes' ? 'Accept defaults' : 'Anthropic API key'}]'`)
+        .join('\n');
+    const installFlags = (exports.COMMAND_FLAGS.install ?? [])
+        .map(f => `        '${f}[Force install]'`)
+        .join('\n');
+    const uninstallFlags = (exports.COMMAND_FLAGS.uninstall ?? [])
+        .map(f => `        '${f}[Skip confirmation]'`)
+        .join('\n');
+    return `#compdef codingbuddy
+# codingbuddy zsh completion
+# Install: codingbuddy completion zsh > ~/.zsh/completions/_codingbuddy
+#   then add to ~/.zshrc: fpath=(~/.zsh/completions $fpath)
+
+_codingbuddy_get_plugin_names() {
+  local plugins_file=".codingbuddy/plugins.json"
+  if [[ -f "$plugins_file" ]]; then
+    grep -o '"name"[[:space:]]*:[[:space:]]*"[^"]*"' "$plugins_file" | sed 's/"name"[[:space:]]*:[[:space:]]*"\\([^"]*\\)"/\\1/'
+  fi
+}
+
+_codingbuddy() {
+  local -a commands
+  commands=(
+${cmdEntries}
+  )
+
+  _arguments -C \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case "$state" in
+    command)
+      _describe 'command' commands
+      compadd -- --help --version
+      ;;
+    args)
+      case "\${words[1]}" in
+        init)
+          _arguments \\
+${initFlags}
+          ;;
+        install)
+          _arguments \\
+${installFlags}
+          ;;
+        uninstall)
+          if (( CURRENT == 2 )); then
+            local -a plugins
+            plugins=(\${(f)"$(_codingbuddy_get_plugin_names)"})
+            compadd -a plugins
+          fi
+          _arguments \\
+${uninstallFlags}
+          ;;
+        update)
+          if (( CURRENT == 2 )); then
+            local -a plugins
+            plugins=(\${(f)"$(_codingbuddy_get_plugin_names)"})
+            compadd -a plugins
+          fi
+          ;;
+        tui)
+          _arguments \\
+            '--restart[Restart TUI client]'
+          ;;
+        completion)
+          compadd bash zsh fish
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_codingbuddy "$@"
+`;
+}
+function generateFishCompletion() {
+    const noSubcommandCond = '__fish_seen_subcommand_from init install search plugins update uninstall mcp tui completion';
+    const lines = [
+        '# codingbuddy fish completion',
+        '# Install: codingbuddy completion fish > ~/.config/fish/completions/codingbuddy.fish',
+        '',
+        '# Helper: get plugin names from plugins.json',
+        'function __codingbuddy_plugin_names',
+        '  set -l plugins_file ".codingbuddy/plugins.json"',
+        '  if test -f $plugins_file',
+        '    string match -rg \'"name"\\s*:\\s*"([^"]*)"\'  < $plugins_file',
+        '  end',
+        'end',
+        '',
+        '# Disable file completions by default',
+        'complete -c codingbuddy -f',
+        '',
+        '# Commands (only when no subcommand given)',
+    ];
+    for (const cmd of exports.COMMANDS) {
+        const desc = COMMAND_DESCRIPTIONS[cmd] ?? cmd;
+        lines.push(`complete -c codingbuddy -n "not ${noSubcommandCond}" -a "${cmd}" -d "${desc}"`);
+    }
+    lines.push('');
+    lines.push('# Global flags');
+    lines.push(`complete -c codingbuddy -n "not ${noSubcommandCond}" -l help -d "Show help"`);
+    lines.push(`complete -c codingbuddy -n "not ${noSubcommandCond}" -l version -d "Show version"`);
+    lines.push('');
+    lines.push('# init flags');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from init" -l force -s f -d "Overwrite existing config"');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from init" -l yes -s y -d "Accept defaults"');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from init" -l api-key -d "Anthropic API key"');
+    lines.push('');
+    lines.push('# install flags');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from install" -l force -s f -d "Force install"');
+    lines.push('');
+    lines.push('# uninstall - dynamic plugin names + flags');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from uninstall" -a "(__codingbuddy_plugin_names)" -d "Plugin name"');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from uninstall" -l yes -s y -d "Skip confirmation"');
+    lines.push('');
+    lines.push('# update - dynamic plugin names');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from update" -a "(__codingbuddy_plugin_names)" -d "Plugin name"');
+    lines.push('');
+    lines.push('# tui flags');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from tui" -l restart -d "Restart TUI client"');
+    lines.push('');
+    lines.push('# completion subcommands');
+    lines.push('complete -c codingbuddy -n "__fish_seen_subcommand_from completion" -a "bash zsh fish" -d "Shell type"');
+    lines.push('');
+    return lines.join('\n');
+}
+function generateCompletion(shell) {
+    switch (shell) {
+        case 'bash':
+            return generateBashCompletion();
+        case 'zsh':
+            return generateZshCompletion();
+        case 'fish':
+            return generateFishCompletion();
+        default:
+            return null;
+    }
+}
+function runCompletion(options) {
+    if (!options.shell) {
+        process.stderr.write('Error: Missing shell type. Usage: codingbuddy completion <bash|zsh|fish>\n');
+        return { success: false, error: 'Missing shell type' };
+    }
+    const script = generateCompletion(options.shell);
+    if (!script) {
+        process.stderr.write(`Error: Unsupported shell "${options.shell}". Supported: bash, zsh, fish\n`);
+        return { success: false, error: `Unsupported shell: ${options.shell}` };
+    }
+    process.stdout.write(script);
+    return { success: true };
+}
+//# sourceMappingURL=completion.js.map

package/dist/src/cli/completion/index.d.ts

@@ -0,0 +1,2 @@
+export { runCompletion, generateCompletion } from './completion';
+export type { CompletionOptions, CompletionResult } from './completion';

package/dist/src/cli/completion/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCompletion = exports.runCompletion = void 0;
+var completion_1 = require("./completion");
+Object.defineProperty(exports, "runCompletion", { enumerable: true, get: function () { return completion_1.runCompletion; } });
+Object.defineProperty(exports, "generateCompletion", { enumerable: true, get: function () { return completion_1.generateCompletion; } });
+//# sourceMappingURL=index.js.map

package/dist/src/cli/init/init.constants.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CODINGBUDDY_GITIGNORE_ENTRIES = exports.CLAUDE_SETTINGS_ENV_ENTRIES = void 0;
 exports.CLAUDE_SETTINGS_ENV_ENTRIES = {
     ENABLE_TOOL_SEARCH: 'false',
-    CODINGBUDDY_AUTO_TUI: '1',
 };
 exports.CODINGBUDDY_GITIGNORE_ENTRIES = [
     {

package/dist/src/cli/plugin/create-plugin.command.d.ts

@@ -0,0 +1,21 @@
+export interface CreatePluginOptions {
+    name: string;
+    outputDir: string;
+    template: 'minimal' | 'full';
+    description?: string;
+    author?: string;
+}
+export interface CreatePluginResult {
+    success: boolean;
+    pluginDir?: string;
+    error?: string;
+}
+export interface TemplateContext {
+    name: string;
+    description: string;
+    author: string;
+}
+export declare function validatePluginName(name: string): boolean;
+export declare function generateMinimalTemplate(ctx: TemplateContext): Record<string, string>;
+export declare function generateFullTemplate(ctx: TemplateContext): Record<string, string>;
+export declare function runCreatePlugin(options: CreatePluginOptions): Promise<CreatePluginResult>;