odd-flow 1.0.0

package/v3/@claude-flow/cli/dist/src/index.js

@@ -0,0 +1,469 @@
+/**
+ * V3 CLI Main Entry Point
+ * Modernized CLI for Odd Flow
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { commandParser } from './parser.js';
+import { output } from './output.js';
+import { commands, commandsByCategory, getCommand, getCommandAsync, getCommandNames, hasCommand } from './commands/index.js';
+import { suggestCommand } from './suggest.js';
+import { runStartupUpdateCheck } from './update/index.js';
+// Read version from package.json at runtime
+function getPackageVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        // Navigate from dist/src to package root
+        const pkgPath = join(__dirname, '..', '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg.version || '3.0.0';
+    }
+    catch {
+        return '3.0.0';
+    }
+}
+export const VERSION = getPackageVersion();
+/**
+ * V3 CLI Application
+ */
+export class CLI {
+    name;
+    description;
+    version;
+    parser;
+    output;
+    interactive;
+    constructor(options = {}) {
+        this.name = options.name || 'odd-flow';
+        this.description = options.description || 'Odd Flow - AI Agent Orchestration Platform';
+        this.version = options.version || VERSION;
+        this.parser = commandParser;
+        this.output = output;
+        this.interactive = options.interactive ?? process.stdin.isTTY ?? false;
+        // Register all commands
+        for (const cmd of commands) {
+            this.parser.registerCommand(cmd);
+        }
+    }
+    /**
+     * Run the CLI with given arguments
+     */
+    async run(args = process.argv.slice(2)) {
+        try {
+            // Parse arguments
+            const parseResult = this.parser.parse(args);
+            const { command: commandPath, flags, positional } = parseResult;
+            // Handle global flags
+            if (flags.version || flags.V) {
+                this.showVersion();
+                return;
+            }
+            if (flags.noColor) {
+                this.output.setColorEnabled(false);
+            }
+            // Set verbosity level based on flags
+            if (flags.quiet) {
+                this.output.setVerbosity('quiet');
+            }
+            else if (flags.verbose) {
+                this.output.setVerbosity(process.env.DEBUG ? 'debug' : 'verbose');
+            }
+            // Verbose mode: show parsed arguments
+            if (this.output.isVerbose()) {
+                this.output.printDebug(`Command: ${commandPath.join(' ') || '(none)'}`);
+                this.output.printDebug(`Positional: [${positional.join(', ')}]`);
+                this.output.printDebug(`Flags: ${JSON.stringify(Object.fromEntries(Object.entries(flags).filter(([k]) => k !== '_')))}`);
+                this.output.printDebug(`CWD: ${process.cwd()}`);
+            }
+            // Run startup update check (non-blocking, silent on skip)
+            if (!flags.noUpdate && commandPath[0] !== 'update') {
+                this.checkForUpdatesOnStartup().catch(() => { });
+            }
+            // Handle lazy-loaded commands that weren't recognized by the parser
+            // If commandPath is empty but positional has a command name, check if it's lazy-loadable
+            if (commandPath.length === 0 && positional.length > 0 && !positional[0].startsWith('-')) {
+                const potentialCommand = positional[0];
+                if (hasCommand(potentialCommand)) {
+                    // This is a lazy-loaded command, treat it as the command
+                    commandPath.push(potentialCommand);
+                    positional.shift();
+                }
+            }
+            // No command - show help or suggest correction
+            if (commandPath.length === 0 || flags.help || flags.h) {
+                if (commandPath.length > 0) {
+                    // Show command-specific help
+                    await this.showCommandHelp(commandPath[0]);
+                }
+                else if (positional.length > 0 && !positional[0].startsWith('-')) {
+                    // First positional looks like an attempted command - suggest correction
+                    const attemptedCommand = positional[0];
+                    this.output.printError(`Unknown command: ${attemptedCommand}`);
+                    const availableCommands = Array.from(new Set([...commands.map(c => c.name), ...getCommandNames()]));
+                    const { message } = suggestCommand(attemptedCommand, availableCommands);
+                    this.output.writeln(this.output.dim(`  ${message}`));
+                    process.exit(1);
+                }
+                else {
+                    this.showHelp();
+                }
+                return;
+            }
+            // Find and execute command
+            const commandName = commandPath[0];
+            // First check the parser's registry (for dynamically registered commands)
+            // Then fall back to the static registry, then try lazy loading
+            let command = this.parser.getCommand(commandName) || getCommand(commandName);
+            // If not found in sync registry, try lazy loading
+            if (!command && hasCommand(commandName)) {
+                command = await getCommandAsync(commandName);
+            }
+            if (!command) {
+                this.output.printError(`Unknown command: ${commandName}`);
+                // Smart suggestions - include lazy-loadable commands in suggestions
+                const availableCommands = Array.from(new Set([...commands.map(c => c.name), ...getCommandNames()]));
+                const { message } = suggestCommand(commandName, availableCommands);
+                this.output.writeln(this.output.dim(`  ${message}`));
+                process.exit(1);
+            }
+            // Handle subcommand (supports nested subcommands)
+            let targetCommand = command;
+            let subcommandArgs = positional;
+            // Process command path (e.g., ['hooks', 'worker', 'list'])
+            // Note: When parser includes subcommand in commandPath, positional already excludes it
+            if (commandPath.length > 1 && command.subcommands) {
+                const subcommandName = commandPath[1];
+                const subcommand = command.subcommands.find(sc => sc.name === subcommandName || sc.aliases?.includes(subcommandName));
+                if (subcommand) {
+                    targetCommand = subcommand;
+                    // Parser already extracted subcommand from positional, so use as-is
+                    subcommandArgs = positional;
+                    // Check for nested subcommand (level 2)
+                    if (commandPath.length > 2 && subcommand.subcommands) {
+                        const nestedName = commandPath[2];
+                        const nestedSubcommand = subcommand.subcommands.find(sc => sc.name === nestedName || sc.aliases?.includes(nestedName));
+                        if (nestedSubcommand) {
+                            targetCommand = nestedSubcommand;
+                            // Parser already extracted nested subcommand too
+                            subcommandArgs = positional;
+                        }
+                    }
+                }
+            }
+            else if (positional.length > 0 && command.subcommands) {
+                // Check if first positional is a subcommand
+                const subcommandName = positional[0];
+                const subcommand = command.subcommands.find(sc => sc.name === subcommandName || sc.aliases?.includes(subcommandName));
+                if (subcommand) {
+                    targetCommand = subcommand;
+                    subcommandArgs = positional.slice(1);
+                    // Check for nested subcommand (level 2 from positional)
+                    if (subcommandArgs.length > 0 && subcommand.subcommands) {
+                        const nestedName = subcommandArgs[0];
+                        const nestedSubcommand = subcommand.subcommands.find(sc => sc.name === nestedName || sc.aliases?.includes(nestedName));
+                        if (nestedSubcommand) {
+                            targetCommand = nestedSubcommand;
+                            subcommandArgs = subcommandArgs.slice(1);
+                        }
+                    }
+                }
+            }
+            // Validate flags
+            const validationErrors = this.parser.validateFlags(flags, targetCommand);
+            if (validationErrors.length > 0) {
+                for (const error of validationErrors) {
+                    this.output.printError(error);
+                }
+                process.exit(1);
+            }
+            // Build context
+            const ctx = {
+                args: subcommandArgs,
+                flags,
+                config: await this.loadConfig(flags.config),
+                cwd: process.cwd(),
+                interactive: this.interactive && !flags.quiet
+            };
+            // Execute command
+            if (targetCommand.action) {
+                if (this.output.isVerbose()) {
+                    this.output.printDebug(`Executing: ${targetCommand.name}`);
+                }
+                const startTime = Date.now();
+                const result = await targetCommand.action(ctx);
+                if (this.output.isVerbose()) {
+                    this.output.printDebug(`Completed in ${Date.now() - startTime}ms`);
+                }
+                if (result && !result.success) {
+                    process.exit(result.exitCode || 1);
+                }
+            }
+            else {
+                // No action - show command help
+                this.showCommandHelp(commandName);
+            }
+        }
+        catch (error) {
+            // Don't re-handle if this is a process.exit error (from mocked tests)
+            const errorMessage = error.message;
+            if (errorMessage && errorMessage.startsWith('process.exit:')) {
+                throw error; // Re-throw so tests can capture the exit code
+            }
+            this.handleError(error);
+        }
+    }
+    /**
+     * Show main help
+     */
+    showHelp() {
+        this.output.writeln();
+        this.output.writeln(this.output.bold(`${this.name} v${this.version}`));
+        this.output.writeln(this.output.dim(this.description));
+        this.output.writeln();
+        this.output.writeln(this.output.bold('USAGE:'));
+        this.output.writeln(`  ${this.name} <command> [subcommand] [options]`);
+        this.output.writeln();
+        // Primary Commands
+        this.output.writeln(this.output.bold('PRIMARY COMMANDS:'));
+        for (const cmd of commandsByCategory.primary) {
+            if (cmd.hidden)
+                continue;
+            const name = cmd.name.padEnd(12);
+            this.output.writeln(`  ${this.output.highlight(name)} ${cmd.description}`);
+        }
+        this.output.writeln();
+        // Advanced Commands
+        this.output.writeln(this.output.bold('ADVANCED COMMANDS:'));
+        for (const cmd of commandsByCategory.advanced) {
+            if (cmd.hidden)
+                continue;
+            const name = cmd.name.padEnd(12);
+            this.output.writeln(`  ${this.output.highlight(name)} ${cmd.description}`);
+        }
+        this.output.writeln();
+        // Utility Commands
+        this.output.writeln(this.output.bold('UTILITY COMMANDS:'));
+        for (const cmd of commandsByCategory.utility) {
+            if (cmd.hidden)
+                continue;
+            const name = cmd.name.padEnd(12);
+            this.output.writeln(`  ${this.output.highlight(name)} ${cmd.description}`);
+        }
+        this.output.writeln();
+        // Analysis Commands
+        this.output.writeln(this.output.bold('ANALYSIS COMMANDS:'));
+        for (const cmd of commandsByCategory.analysis) {
+            if (cmd.hidden)
+                continue;
+            const name = cmd.name.padEnd(12);
+            this.output.writeln(`  ${this.output.highlight(name)} ${cmd.description}`);
+        }
+        this.output.writeln();
+        // Management Commands
+        this.output.writeln(this.output.bold('MANAGEMENT COMMANDS:'));
+        for (const cmd of commandsByCategory.management) {
+            if (cmd.hidden)
+                continue;
+            const name = cmd.name.padEnd(12);
+            this.output.writeln(`  ${this.output.highlight(name)} ${cmd.description}`);
+        }
+        this.output.writeln();
+        this.output.writeln(this.output.bold('GLOBAL OPTIONS:'));
+        for (const opt of this.parser.getGlobalOptions()) {
+            const flags = opt.short ? `-${opt.short}, --${opt.name}` : `    --${opt.name}`;
+            this.output.writeln(`  ${flags.padEnd(25)} ${opt.description}`);
+        }
+        this.output.writeln();
+        this.output.writeln(this.output.bold('V3 FEATURES:'));
+        this.output.printList([
+            '15-agent hierarchical mesh coordination',
+            'AgentDB with HNSW indexing (150x-12,500x faster)',
+            'Flash Attention (2.49x-7.47x speedup)',
+            'Unified SwarmCoordinator engine',
+            'Event-sourced state management',
+            'Domain-Driven Design architecture'
+        ]);
+        this.output.writeln();
+        this.output.writeln(this.output.bold('EXAMPLES:'));
+        this.output.writeln(`  ${this.name} agent spawn -t coder              # Spawn a coder agent`);
+        this.output.writeln(`  ${this.name} swarm init --v3-mode              # Initialize V3 swarm`);
+        this.output.writeln(`  ${this.name} memory search -q "auth patterns"  # Semantic search`);
+        this.output.writeln(`  ${this.name} mcp start                         # Start MCP server`);
+        this.output.writeln();
+        this.output.writeln(this.output.dim(`Run "${this.name} <command> --help" for command help`));
+        this.output.writeln();
+        this.output.writeln();
+    }
+    /**
+     * Show command-specific help
+     */
+    async showCommandHelp(commandName) {
+        // Try sync first, then lazy load
+        let command = getCommand(commandName);
+        if (!command && hasCommand(commandName)) {
+            command = await getCommandAsync(commandName);
+        }
+        if (!command) {
+            this.output.printError(`Unknown command: ${commandName}`);
+            return;
+        }
+        this.output.writeln();
+        this.output.writeln(this.output.bold(`${this.name} ${command.name}`));
+        this.output.writeln(command.description);
+        this.output.writeln();
+        // Subcommands
+        if (command.subcommands && command.subcommands.length > 0) {
+            this.output.writeln(this.output.bold('SUBCOMMANDS:'));
+            for (const sub of command.subcommands) {
+                if (sub.hidden)
+                    continue;
+                const name = sub.name.padEnd(15);
+                const aliases = sub.aliases ? this.output.dim(` (${sub.aliases.join(', ')})`) : '';
+                this.output.writeln(`  ${this.output.highlight(name)} ${sub.description}${aliases}`);
+            }
+            this.output.writeln();
+        }
+        // Options
+        if (command.options && command.options.length > 0) {
+            this.output.writeln(this.output.bold('OPTIONS:'));
+            for (const opt of command.options) {
+                const flags = opt.short ? `-${opt.short}, --${opt.name}` : `    --${opt.name}`;
+                const required = opt.required ? this.output.error(' (required)') : '';
+                const defaultVal = opt.default !== undefined ? this.output.dim(` [default: ${opt.default}]`) : '';
+                this.output.writeln(`  ${flags.padEnd(25)} ${opt.description}${required}${defaultVal}`);
+            }
+            this.output.writeln();
+        }
+        // Examples
+        if (command.examples && command.examples.length > 0) {
+            this.output.writeln(this.output.bold('EXAMPLES:'));
+            for (const example of command.examples) {
+                this.output.writeln(`  ${this.output.dim('$')} ${example.command}`);
+                this.output.writeln(`    ${this.output.dim(example.description)}`);
+            }
+            this.output.writeln();
+        }
+    }
+    /**
+     * Show version
+     */
+    showVersion() {
+        this.output.writeln(`${this.name} v${this.version}`);
+    }
+    /**
+     * Check for updates on startup (non-blocking)
+     * Shows notification if updates are available
+     */
+    async checkForUpdatesOnStartup() {
+        try {
+            const result = await runStartupUpdateCheck({ autoUpdate: true });
+            // Show notifications for available updates that weren't auto-applied
+            if (result.checked && result.updatesAvailable.length > 0) {
+                const nonAutoUpdates = result.updatesAvailable.filter(u => !u.shouldAutoUpdate);
+                if (result.updatesApplied.length > 0) {
+                    this.output.writeln(this.output.dim(`Auto-updated: ${result.updatesApplied.join(', ')}`));
+                }
+                if (nonAutoUpdates.length > 0) {
+                    this.output.writeln(this.output.dim(`Updates available: ${nonAutoUpdates.map(u => `${u.package}@${u.latestVersion}`).join(', ')}`));
+                    this.output.writeln(this.output.dim(`Run '${this.name} update check' for details`));
+                }
+            }
+        }
+        catch {
+            // Silently fail - don't interrupt CLI usage
+        }
+    }
+    /**
+     * Load configuration file
+     */
+    async loadConfig(configPath) {
+        try {
+            // Import config utilities
+            const { loadConfig: loadSystemConfig } = await import('@claude-flow/shared');
+            const { systemConfigToV3Config } = await import('./config-adapter.js');
+            // Load configuration
+            const loaded = await loadSystemConfig({
+                file: configPath,
+                paths: configPath ? undefined : [process.cwd()],
+            });
+            // Convert to V3Config format
+            const v3Config = systemConfigToV3Config(loaded.config);
+            // Log warnings if any
+            if (loaded.warnings && loaded.warnings.length > 0) {
+                for (const warning of loaded.warnings) {
+                    this.output.printWarning(warning);
+                }
+            }
+            return v3Config;
+        }
+        catch (error) {
+            // Config loading is optional - don't fail if it doesn't exist
+            if (process.env.DEBUG) {
+                this.output.writeln(this.output.dim(`Config loading failed: ${error.message}`));
+            }
+            return undefined;
+        }
+    }
+    /**
+     * Handle errors
+     */
+    handleError(error) {
+        if ('code' in error) {
+            // CLIError
+            const cliError = error;
+            this.output.printError(cliError.message);
+            if (cliError.details) {
+                this.output.writeln(this.output.dim(JSON.stringify(cliError.details, null, 2)));
+            }
+            process.exit(cliError.exitCode);
+        }
+        else {
+            // Generic error
+            this.output.printError(error.message);
+            if (process.env.DEBUG) {
+                this.output.writeln();
+                this.output.writeln(this.output.dim(error.stack || ''));
+            }
+            process.exit(1);
+        }
+    }
+}
+// =============================================================================
+// Module Exports
+// =============================================================================
+// Types
+export * from './types.js';
+// Parser
+export { CommandParser, commandParser } from './parser.js';
+// Output
+export { OutputFormatter, output, Progress, Spinner } from './output.js';
+// Prompt
+export * from './prompt.js';
+// Commands (internal use)
+export * from './commands/index.js';
+// MCP Server management
+export { MCPServerManager, createMCPServerManager, getServerManager, startMCPServer, stopMCPServer, getMCPServerStatus, } from './mcp-server.js';
+// Memory & Intelligence (V3 Performance Features)
+export { initializeMemoryDatabase, generateEmbedding, generateBatchEmbeddings, storeEntry, searchEntries, getHNSWIndex, addToHNSWIndex, searchHNSWIndex, getHNSWStatus, clearHNSWIndex, quantizeInt8, dequantizeInt8, quantizedCosineSim, getQuantizationStats, 
+// Flash Attention-style batch operations
+batchCosineSim, softmaxAttention, topKIndices, flashAttentionSearch, } from './memory/memory-initializer.js';
+export { initializeIntelligence, recordStep, recordTrajectory, findSimilarPatterns, getIntelligenceStats, getSonaCoordinator, getReasoningBank, clearIntelligence, benchmarkAdaptation, 
+// RL loop API
+endTrajectoryWithVerdict, distillLearning, 
+// Pattern persistence API
+getAllPatterns, getPatternsByType, flushPatterns, deletePattern, clearAllPatterns, getNeuralDataDir, getPersistenceStatus, } from './memory/intelligence.js';
+// EWC++ Consolidation (Prevents Catastrophic Forgetting)
+export { EWCConsolidator, getEWCConsolidator, resetEWCConsolidator, consolidatePatterns, recordPatternOutcome, getEWCStats, } from './memory/ewc-consolidation.js';
+// SONA Optimizer (Adaptive Routing via Trajectory Learning)
+export { SONAOptimizer, getSONAOptimizer, resetSONAOptimizer, processTrajectory, getSuggestion, getSONAStats, } from './memory/sona-optimizer.js';
+// Production Hardening
+export { ErrorHandler, withErrorHandling, } from './production/error-handler.js';
+export { RateLimiter, createRateLimiter, } from './production/rate-limiter.js';
+export { withRetry, makeRetryable, } from './production/retry.js';
+export { CircuitBreaker, getCircuitBreaker, getAllCircuitStats, resetAllCircuits, } from './production/circuit-breaker.js';
+export { MonitoringHooks, createMonitor, getMonitor, } from './production/monitoring.js';
+// Default export
+export default CLI;
+//# sourceMappingURL=index.js.map

package/v3/@claude-flow/cli/dist/src/infrastructure/in-memory-repositories.d.ts

@@ -0,0 +1,68 @@
+/**
+ * In-Memory Repositories - CLI Infrastructure
+ *
+ * Lightweight in-memory implementations for CLI use.
+ *
+ * @module v3/cli/infrastructure
+ */
+import { Agent, AgentStatus, AgentRole } from '../../../swarm/src/domain/entities/agent.js';
+import { Task, TaskStatus, TaskPriority } from '../../../swarm/src/domain/entities/task.js';
+import { IAgentRepository, AgentQueryOptions, AgentStatistics } from '../../../swarm/src/domain/repositories/agent-repository.interface.js';
+import { ITaskRepository, TaskQueryOptions, TaskStatistics } from '../../../swarm/src/domain/repositories/task-repository.interface.js';
+/**
+ * In-Memory Agent Repository
+ */
+export declare class InMemoryAgentRepository implements IAgentRepository {
+    private agents;
+    private initialized;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    clear(): Promise<void>;
+    save(agent: Agent): Promise<void>;
+    findById(id: string): Promise<Agent | null>;
+    findByName(name: string): Promise<Agent | null>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    saveMany(agents: Agent[]): Promise<void>;
+    findByIds(ids: string[]): Promise<Agent[]>;
+    deleteMany(ids: string[]): Promise<number>;
+    findAll(options?: AgentQueryOptions): Promise<Agent[]>;
+    findByStatus(status: AgentStatus): Promise<Agent[]>;
+    findByRole(role: AgentRole): Promise<Agent[]>;
+    findByDomain(domain: string): Promise<Agent[]>;
+    findByParent(parentId: string): Promise<Agent[]>;
+    findByCapability(capability: string): Promise<Agent[]>;
+    findAvailable(): Promise<Agent[]>;
+    getStatistics(): Promise<AgentStatistics>;
+    count(options?: AgentQueryOptions): Promise<number>;
+}
+/**
+ * In-Memory Task Repository
+ */
+export declare class InMemoryTaskRepository implements ITaskRepository {
+    private tasks;
+    private initialized;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    clear(): Promise<void>;
+    save(task: Task): Promise<void>;
+    findById(id: string): Promise<Task | null>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    saveMany(tasks: Task[]): Promise<void>;
+    findByIds(ids: string[]): Promise<Task[]>;
+    deleteMany(ids: string[]): Promise<number>;
+    findAll(options?: TaskQueryOptions): Promise<Task[]>;
+    findByStatus(status: TaskStatus): Promise<Task[]>;
+    findByPriority(priority: TaskPriority): Promise<Task[]>;
+    findByAgent(agentId: string): Promise<Task[]>;
+    findPending(): Promise<Task[]>;
+    findQueued(): Promise<Task[]>;
+    findRunning(): Promise<Task[]>;
+    findTimedOut(): Promise<Task[]>;
+    getNextTask(agentCapabilities?: string[]): Promise<Task | null>;
+    getTaskQueue(limit?: number): Promise<Task[]>;
+    getStatistics(): Promise<TaskStatistics>;
+    count(options?: TaskQueryOptions): Promise<number>;
+}
+//# sourceMappingURL=in-memory-repositories.d.ts.map