viben 0.1.1 → 1.0.0

package/README.md

@@ -3,7 +3,17 @@
 [![npm version](https://img.shields.io/npm/v/viben.svg)](https://www.npmjs.com/package/viben)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Command-line interface for Viben - orchestrate AI agent clusters in your local workspace.
+**Agent Swarm × Code Evolution** - Command-line interface for Viben.
+
+## Overview
+
+Viben CLI enables autonomous code evolution through multi-agent orchestration:
+
+- **FileEvo** - File-based self-evolution for code iteration and optimization
+- **Multi-Agent Swarm** - Coordinate multiple AI agents working in parallel
+- **MCP Protocol** - Model Context Protocol for seamless tool integration
+- **XState Task System** - State machine-driven task workflow management
+- **Idea Generation** - Transform ideas into executable development tasks
 
 ## Installation
 

package/bin/viben.js

@@ -5,37 +5,25 @@
  *
  * This script serves as the main entry point for the Viben CLI.
  * It routes to either:
- * - The TypeScript CLI (Commander.js) for workspace management commands
+ * - The @viben/core CLI for all commands
  * - The Python browse-mcp wrapper for MCP server functionality
  *
  * Usage:
- *   viben init                # Initialize workspace (TypeScript CLI)
- *   viben config list         # List config (TypeScript CLI)
- *   viben agent list          # List agents (TypeScript CLI)
- *   viben serve               # Start MCP server (Python wrapper)
- *   viben mcp                  # Start MCP server (Python wrapper, alias)
+ *   viben init                # Initialize workspace
+ *   viben config list         # List config
+ *   viben agent list          # List agents
+ *   viben mcp serve           # Start MCP server (Python wrapper)
  */
 
-import { createRequire } from 'module';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
 import { spawnSync, execSync } from 'child_process';
 import { platform } from 'os';
 
-const require = createRequire(import.meta.url);
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
 // Configuration for Python wrapper
 const PYTHON_PACKAGE = 'browse-mcp';
 const MIN_PYTHON_VERSION = '3.10';
-const BRAND_NAME = 'Viben';
-
-// Commands that should be handled by the TypeScript CLI
-const TS_CLI_COMMANDS = ['init', 'config', 'agent'];
 
-// Commands that should be handled by the Python wrapper
-const PYTHON_COMMANDS = ['serve', 'mcp'];
+// Subcommands of 'mcp' that should be handled by the Python wrapper
+const MCP_PYTHON_SUBCOMMANDS = ['serve'];
 
 // ANSI colors
 const colors = {
@@ -44,8 +32,6 @@ const colors = {
   green: '\x1b[32m',
   yellow: '\x1b[33m',
   blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  bold: '\x1b[1m',
 };
 
 function info(message) {
@@ -204,25 +190,8 @@ function runBrowseMcp(args, pythonCmd) {
   process.exit(1);
 }
 
-async function runTypeScriptCli(args) {
-  try {
-    const { run } = await import('../dist/index.js');
-    await run(['node', 'viben', ...args]);
-  } catch (err) {
-    // If dist doesn't exist, try running from source (development mode)
-    try {
-      const { run } = await import('../src/index.ts');
-      await run(['node', 'viben', ...args]);
-    } catch {
-      error('CLI not built. Run "npm run build" in packages/cli first.');
-      console.error(err);
-      process.exit(1);
-    }
-  }
-}
-
 function handlePythonCommand(args) {
-  // Remove 'serve' or 'mcp' from args if present
+  // Remove 'mcp' and 'serve' from args if present
   const filteredArgs = args.filter((a) => a !== 'serve' && a !== 'mcp');
 
   const python = findPython();
@@ -262,51 +231,15 @@ function handlePythonCommand(args) {
   runBrowseMcp(filteredArgs, python.cmd);
 }
 
-function printHelp() {
-  const pkg = require('../package.json');
-  console.log(`
-${colors.cyan}${colors.bold}${BRAND_NAME} CLI${colors.reset} v${pkg.version}
-
-Orchestrate AI agent clusters in your local workspace.
-
-${colors.bold}Usage:${colors.reset}
-  viben <command> [options]
-
-${colors.bold}Workspace Commands:${colors.reset}
-  init                  Initialize a Viben workspace
-  config <subcommand>   Manage configuration (get, set, list, edit, unset)
-  agent <subcommand>    Manage agents (list, create, show)
-
-${colors.bold}Server Commands:${colors.reset}
-  serve                 Start the MCP server (browse-mcp)
-  mcp                   Alias for serve
-
-${colors.bold}Global Options:${colors.reset}
-  --json                Output in JSON format
-  -g, --global          Use global scope
-  -w, --workspace       Use workspace scope
-  --verbose             Enable verbose output
-  -q, --quiet           Suppress non-essential output
-  -v, --version         Show version
-  -h, --help            Show help
-
-${colors.bold}Examples:${colors.reset}
-  viben init                    # Initialize workspace
-  viben config list             # List all config
-  viben config set settings.editor vim
-  viben agent list              # List all agents
-  viben agent create -n my-agent
-  viben serve                   # Start MCP server
-  viben serve -t sse --port 8080
-
-${colors.bold}Environment Variables:${colors.reset}
-  VIBEN_STATE_DIR       State directory (default: ~/.viben)
-  VIBEN_AGENT           Current agent ID
-  VIBEN_SCOPE           Default scope (global/workspace)
-
-${colors.bold}More information:${colors.reset}
-  https://github.com/LinXueyuanStdio/viben
-`);
+async function runCoreCli(args) {
+  try {
+    const { run } = await import('@viben/core/cli');
+    await run(['node', 'viben', ...args]);
+  } catch (err) {
+    error('Failed to load @viben/core CLI');
+    console.error(err);
+    process.exit(1);
+  }
 }
 
 /**
@@ -321,63 +254,38 @@ function findCommand(args) {
   return null;
 }
 
-async function main() {
-  const args = process.argv.slice(2);
-  const firstArg = args[0];
-
-  // Handle --install (Python package installation)
-  if (args.includes('--install')) {
-    const python = findPython();
-    if (!python) {
-      error(`Python ${MIN_PYTHON_VERSION}+ is required`);
-      process.exit(1);
-    }
-    if (installBrowseMcp(python.cmd)) {
-      success('Installation complete');
-      process.exit(0);
-    } else {
-      error('Installation failed');
-      process.exit(1);
+/**
+ * Find the subcommand (second non-flag argument)
+ */
+function findSubcommand(args) {
+  let count = 0;
+  for (const arg of args) {
+    if (!arg.startsWith('-')) {
+      count++;
+      if (count === 2) {
+        return arg;
+      }
     }
   }
+  return null;
+}
 
-  // Handle version (only if it's the only argument)
-  if (args.length === 1 && (firstArg === '-v' || firstArg === '--version')) {
-    const pkg = require('../package.json');
-    console.log(`${BRAND_NAME} CLI v${pkg.version}`);
-    process.exit(0);
-  }
-
-  // Handle help (only if no command is present)
-  if (args.length === 0) {
-    printHelp();
-    process.exit(0);
-  }
-
-  // Find the first command argument (skip flags)
+async function main() {
+  const args = process.argv.slice(2);
   const command = findCommand(args);
 
-  // If only help flag and no command
-  if (!command && (args.includes('-h') || args.includes('--help'))) {
-    printHelp();
-    process.exit(0);
+  // Handle Python-specific mcp subcommands
+  if (command === 'mcp') {
+    const subcommand = findSubcommand(args);
+    if (subcommand && MCP_PYTHON_SUBCOMMANDS.includes(subcommand)) {
+      // mcp serve -> Python wrapper
+      handlePythonCommand(args);
+      return;
+    }
   }
 
-  // Route to appropriate handler based on command
-  if (command && TS_CLI_COMMANDS.includes(command)) {
-    // TypeScript CLI commands (pass all args including global flags)
-    await runTypeScriptCli(args);
-  } else if (command && PYTHON_COMMANDS.includes(command)) {
-    // Python wrapper commands
-    handlePythonCommand(args);
-  } else if (command) {
-    // Unknown command - try TypeScript CLI (it will show proper error)
-    await runTypeScriptCli(args);
-  } else {
-    // No command found - show help
-    printHelp();
-    process.exit(0);
-  }
+  // All other commands go to @viben/core CLI
+  await runCoreCli(args);
 }
 
 main().catch((err) => {