@claude-flow/cli 3.32.1 → 3.32.3

package/dist/src/runtime/headless.js

@@ -1,284 +0,0 @@
-#!/usr/bin/env node
-/**
- * Headless Runtime for Background Workers
- * Runs without TTY for daemon processes and scheduled tasks
- *
- * Usage:
- *   npx @claude-flow/cli headless --worker <type>
- *   npx @claude-flow/cli headless --daemon
- *   npx @claude-flow/cli headless --benchmark
- *
- * Environment:
- *   CLAUDE_FLOW_HEADLESS=true
- *   CLAUDE_CODE_HEADLESS=true
- *
- * @module v3/cli/runtime/headless
- */
-import { HeadlessWorkerExecutor, HEADLESS_WORKER_TYPES } from '../services/headless-worker-executor.js';
-import { getDaemon, startDaemon, stopDaemon } from '../services/worker-daemon.js';
-import { initializeIntelligence, benchmarkAdaptation, getIntelligenceStats } from '../memory/intelligence.js';
-import { getHNSWStatus, batchCosineSim, flashAttentionSearch } from '../memory/memory-initializer.js';
-// ============================================================================
-// Main Runtime
-// ============================================================================
-/**
- * Parse command line arguments
- */
-function parseArgs() {
-    const args = process.argv.slice(2);
-    const config = {
-        mode: 'status',
-        verbose: false
-    };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === '--worker' || arg === '-w') {
-            config.mode = 'worker';
-            config.workerType = args[++i];
-        }
-        else if (arg === '--daemon' || arg === '-d') {
-            config.mode = 'daemon';
-        }
-        else if (arg === '--benchmark' || arg === '-b') {
-            config.mode = 'benchmark';
-        }
-        else if (arg === '--status' || arg === '-s') {
-            config.mode = 'status';
-        }
-        else if (arg === '--timeout' || arg === '-t') {
-            config.timeout = parseInt(args[++i], 10) || 60000;
-        }
-        else if (arg === '--verbose' || arg === '-v') {
-            config.verbose = true;
-        }
-        else if (arg === '--help' || arg === '-h') {
-            showHelp();
-            process.exit(0);
-        }
-    }
-    return config;
-}
-/**
- * Show help message
- */
-function showHelp() {
-    console.log(`
-Headless Runtime for RuFlo V3
-
-Usage:
-  headless --worker <type>    Run a specific worker
-  headless --daemon           Start background daemon
-  headless --benchmark        Run performance benchmarks
-  headless --status           Show system status
-
-Workers: ${HEADLESS_WORKER_TYPES.join(', ')}
-
-Options:
-  -w, --worker <type>   Worker type to run
-  -d, --daemon          Run as daemon
-  -b, --benchmark       Run benchmarks
-  -s, --status          Show status
-  -t, --timeout <ms>    Execution timeout (default: 60000)
-  -v, --verbose         Verbose output
-  -h, --help            Show help
-
-Environment:
-  CLAUDE_FLOW_HEADLESS=true   Enable headless mode
-  CLAUDE_CODE_HEADLESS=true   Enable Claude Code headless
-
-Examples:
-  headless --worker audit --timeout 120000
-  headless --daemon
-  headless --benchmark
-`);
-}
-/**
- * Run a specific worker
- */
-async function runWorker(workerType, timeout) {
-    console.log(`[Headless] Starting worker: ${workerType}`);
-    const executor = new HeadlessWorkerExecutor(process.cwd(), {
-        maxConcurrent: 1,
-        defaultTimeoutMs: timeout
-    });
-    try {
-        const result = await executor.execute(workerType, {
-            timeoutMs: timeout,
-            model: 'sonnet',
-            sandbox: 'permissive'
-        });
-        if (result.success) {
-            console.log(`[Headless] Worker ${workerType} completed successfully`);
-            console.log(`[Headless] Duration: ${result.durationMs}ms`);
-            if (result.output) {
-                console.log(`[Headless] Output: ${JSON.stringify(result.output).slice(0, 500)}...`);
-            }
-        }
-        else {
-            console.error(`[Headless] Worker ${workerType} failed: ${result.error}`);
-            process.exit(1);
-        }
-    }
-    finally {
-        // executor doesn't have shutdown, just let it be garbage collected
-    }
-}
-/**
- * Run daemon mode
- */
-async function runDaemon() {
-    console.log('[Headless] Starting daemon mode...');
-    // Start the daemon
-    const daemon = await startDaemon(process.cwd());
-    console.log('[Headless] Daemon started');
-    console.log('[Headless] Press Ctrl+C to stop');
-    // Handle shutdown
-    process.on('SIGINT', async () => {
-        console.log('\n[Headless] Shutting down daemon...');
-        await stopDaemon();
-        process.exit(0);
-    });
-    process.on('SIGTERM', async () => {
-        console.log('\n[Headless] Received SIGTERM, shutting down...');
-        await stopDaemon();
-        process.exit(0);
-    });
-    // Keep process running
-    await new Promise(() => { });
-}
-/**
- * Run benchmarks
- */
-async function runBenchmarks() {
-    console.log('=== RuFlo V3 Performance Benchmarks ===\n');
-    // Initialize intelligence
-    await initializeIntelligence();
-    // SONA Benchmark
-    console.log('1. SONA Adaptation Benchmark (10,000 iterations)...');
-    const sonaResult = benchmarkAdaptation(10000);
-    console.log(`   Average: ${sonaResult.avgMs.toFixed(4)}ms`);
-    console.log(`   Target (<0.05ms): ${sonaResult.targetMet ? '✅ ACHIEVED' : '❌ NOT MET'}`);
-    // Flash Attention Benchmark
-    console.log('\n2. Flash Attention Search Benchmark...');
-    const dim = 384;
-    const count = 10000;
-    const query = new Float32Array(dim).map(() => Math.random() - 0.5);
-    const vectors = Array.from({ length: count }, () => new Float32Array(dim).map(() => Math.random() - 0.5));
-    // Warmup
-    flashAttentionSearch(query, vectors, { k: 10 });
-    const flashStart = performance.now();
-    for (let i = 0; i < 10; i++) {
-        flashAttentionSearch(query, vectors, { k: 10 });
-    }
-    const flashTime = (performance.now() - flashStart) / 10;
-    const throughput = count / flashTime;
-    // Brute force comparison
-    const bruteStart = performance.now();
-    for (let i = 0; i < 10; i++) {
-        const scores = batchCosineSim(query, vectors);
-        Array.from({ length: count }, (_, i) => i)
-            .sort((a, b) => scores[b] - scores[a])
-            .slice(0, 10);
-    }
-    const bruteTime = (performance.now() - bruteStart) / 10;
-    const speedup = bruteTime / flashTime;
-    console.log(`   Throughput: ${throughput.toFixed(0)} vectors/ms`);
-    console.log(`   Time for 10k vectors: ${flashTime.toFixed(2)}ms`);
-    console.log(`   Speedup vs brute force: ${speedup.toFixed(2)}x`);
-    // HNSW Status
-    console.log('\n3. HNSW Index Status...');
-    const hnswStatus = getHNSWStatus();
-    console.log(`   Entries indexed: ${hnswStatus.entryCount}`);
-    console.log(`   Initialized: ${hnswStatus.initialized}`);
-    // Intelligence Stats
-    console.log('\n4. Intelligence System Stats...');
-    const stats = getIntelligenceStats();
-    console.log(`   SONA enabled: ${stats.sonaEnabled}`);
-    console.log(`   Patterns learned: ${stats.patternsLearned}`);
-    console.log(`   Avg adaptation time: ${stats.avgAdaptationTime.toFixed(4)}ms`);
-    console.log('\n=== Benchmark Complete ===');
-    return {
-        sona: {
-            avgMs: sonaResult.avgMs,
-            targetMet: sonaResult.targetMet
-        },
-        flashAttention: {
-            throughputPerMs: throughput,
-            speedup
-        },
-        hnsw: {
-            entriesIndexed: hnswStatus.entryCount,
-            searchTime: flashTime
-        }
-    };
-}
-/**
- * Show system status
- */
-async function showStatus() {
-    console.log('=== RuFlo V3 System Status ===\n');
-    // Check daemon
-    const daemon = getDaemon();
-    console.log('Daemon:');
-    if (daemon) {
-        const status = daemon.getStatus();
-        console.log(`  Running: ${status.running}`);
-        console.log(`  PID: ${status.pid}`);
-        console.log(`  Workers: ${status.workers.size}`);
-    }
-    else {
-        console.log('  Not initialized');
-    }
-    // Intelligence
-    const stats = getIntelligenceStats();
-    console.log('\nIntelligence:');
-    console.log(`  SONA enabled: ${stats.sonaEnabled}`);
-    console.log(`  ReasoningBank size: ${stats.reasoningBankSize}`);
-    console.log(`  Patterns learned: ${stats.patternsLearned}`);
-    // HNSW
-    const hnsw = getHNSWStatus();
-    console.log('\nHNSW Index:');
-    console.log(`  Initialized: ${hnsw.initialized}`);
-    console.log(`  Entries: ${hnsw.entryCount}`);
-    console.log('\nEnvironment:');
-    console.log(`  CLAUDE_FLOW_HEADLESS: ${process.env.CLAUDE_FLOW_HEADLESS || 'not set'}`);
-    console.log(`  CLAUDE_CODE_HEADLESS: ${process.env.CLAUDE_CODE_HEADLESS || 'not set'}`);
-    console.log(`  NODE_ENV: ${process.env.NODE_ENV || 'development'}`);
-}
-/**
- * Main entry point
- */
-async function main() {
-    // Set headless environment
-    process.env.CLAUDE_FLOW_HEADLESS = 'true';
-    const config = parseArgs();
-    try {
-        switch (config.mode) {
-            case 'worker':
-                if (!config.workerType || !HEADLESS_WORKER_TYPES.includes(config.workerType)) {
-                    console.error(`Invalid worker type. Available: ${HEADLESS_WORKER_TYPES.join(', ')}`);
-                    process.exit(1);
-                }
-                await runWorker(config.workerType, config.timeout || 60000);
-                break;
-            case 'daemon':
-                await runDaemon();
-                break;
-            case 'benchmark':
-                await runBenchmarks();
-                break;
-            case 'status':
-            default:
-                await showStatus();
-                break;
-        }
-    }
-    catch (error) {
-        console.error('[Headless] Error:', error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-}
-// Run if executed directly
-main().catch(console.error);
-export { main, runWorker, runDaemon, runBenchmarks, showStatus };
-//# sourceMappingURL=headless.js.map

package/dist/src/runtime/parent-death-watchdog.d.ts

@@ -1,42 +0,0 @@
-/**
- * Parent-death watchdog (#2234).
- *
- * `ruflo mcp start` runs as a double-forked grandchild of Claude Code (`npx -y
- * ruflo … mcp start` → `npm exec …` → `node … mcp start`). When Claude Code
- * exits, only the `npm exec` shim is terminated; the `node` server reparents to
- * `launchd`/`init` (`ppid === 1`) and silently lingers — leaving ~50 MB and an
- * open database handle per restart. Over a week this accumulates to ~20
- * orphaned servers (~1 GB), and an arbitrary stale one can win the next stdio
- * handshake, transparently serving superseded code.
- *
- * Cheap, robust fix: poll `process.ppid`. When it becomes 1 (and didn't start
- * there), our original parent has exited — we're orphaned. Run the cleanup
- * hook and exit cleanly.
- *
- * @module runtime/parent-death-watchdog
- */
-export interface ParentDeathWatchdogOptions {
-    /** Poll interval in ms. Default 2000. */
-    intervalMs?: number;
-    /**
-     * Cleanup hook fired when orphaning is detected. May be async. After it
-     * resolves (or throws), the process exits with code 0 (success) / 1 (error).
-     * Defaults to `process.exit(0)` directly.
-     */
-    onOrphaned?: () => void | Promise<void>;
-    /** Override `process.ppid` getter (tests). */
-    ppidGetter?: () => number;
-    /** Override `process.exit` (tests). */
-    exit?: (code: number) => void;
-}
-export interface ParentDeathWatchdog {
-    stop(): void;
-    /** Manually trigger the orphan check (used by tests). */
-    checkOnce(): Promise<void>;
-}
-/**
- * Install a parent-death watchdog. Safe to call once per process; calling
- * twice replaces the previous interval.
- */
-export declare function installParentDeathWatchdog(opts?: ParentDeathWatchdogOptions): ParentDeathWatchdog;
-//# sourceMappingURL=parent-death-watchdog.d.ts.map

package/dist/src/runtime/parent-death-watchdog.js

@@ -1,70 +0,0 @@
-/**
- * Parent-death watchdog (#2234).
- *
- * `ruflo mcp start` runs as a double-forked grandchild of Claude Code (`npx -y
- * ruflo … mcp start` → `npm exec …` → `node … mcp start`). When Claude Code
- * exits, only the `npm exec` shim is terminated; the `node` server reparents to
- * `launchd`/`init` (`ppid === 1`) and silently lingers — leaving ~50 MB and an
- * open database handle per restart. Over a week this accumulates to ~20
- * orphaned servers (~1 GB), and an arbitrary stale one can win the next stdio
- * handshake, transparently serving superseded code.
- *
- * Cheap, robust fix: poll `process.ppid`. When it becomes 1 (and didn't start
- * there), our original parent has exited — we're orphaned. Run the cleanup
- * hook and exit cleanly.
- *
- * @module runtime/parent-death-watchdog
- */
-/**
- * Install a parent-death watchdog. Safe to call once per process; calling
- * twice replaces the previous interval.
- */
-export function installParentDeathWatchdog(opts = {}) {
-    const intervalMs = opts.intervalMs ?? 2000;
-    const get = opts.ppidGetter ?? (() => process.ppid);
-    const exit = opts.exit ?? ((code) => process.exit(code));
-    const onOrphaned = opts.onOrphaned;
-    const initialPpid = get();
-    let triggered = false;
-    let timer;
-    const triggerOrphaned = async () => {
-        if (triggered)
-            return;
-        triggered = true;
-        if (timer) {
-            clearInterval(timer);
-            timer = undefined;
-        }
-        try {
-            if (onOrphaned)
-                await onOrphaned();
-            exit(0);
-        }
-        catch {
-            exit(1);
-        }
-    };
-    const checkOnce = async () => {
-        // Only trigger when we *transition* to ppid=1; if we already started there
-        // (process launched directly under launchd/init) it isn't an orphan event.
-        const ppid = get();
-        if (ppid === 1 && initialPpid !== 1)
-            await triggerOrphaned();
-    };
-    timer = setInterval(() => {
-        void checkOnce();
-    }, intervalMs);
-    // Don't keep the event loop alive on the watchdog alone.
-    if (typeof timer.unref === 'function')
-        timer.unref();
-    return {
-        stop() {
-            if (timer) {
-                clearInterval(timer);
-                timer = undefined;
-            }
-        },
-        checkOnce,
-    };
-}
-//# sourceMappingURL=parent-death-watchdog.js.map

package/dist/src/ruvector/agent-wasm.d.ts

@@ -1,228 +0,0 @@
-/**
- * RuVector Agent WASM Integration
- *
- * Wraps @ruvector/rvagent-wasm for sandboxed AI agent execution.
- * Provides WasmAgent lifecycle, gallery templates, RVF container building,
- * and MCP server bridge — all running in WASM without OS access.
- *
- * Published API (v0.1.0): WasmAgent, WasmGallery, WasmMcpServer,
- * WasmRvfBuilder, JsModelProvider, initSync.
- *
- * @module @claude-flow/cli/ruvector/agent-wasm
- */
-export interface WasmAgentConfig {
-    model?: string;
-    instructions?: string;
-    maxTurns?: number;
-}
-export interface WasmAgentInfo {
-    id: string;
-    state: 'idle' | 'running' | 'error';
-    config: WasmAgentConfig;
-    model: string;
-    turnCount: number;
-    fileCount: number;
-    isStopped: boolean;
-    createdAt: string;
-}
-export interface GalleryTemplate {
-    id: string;
-    name: string;
-    description: string;
-    category: string;
-    tags: string[];
-    version: string;
-    author: string;
-    builtin: boolean;
-}
-export interface GalleryTemplateDetail extends GalleryTemplate {
-    tools: Array<{
-        name: string;
-        description: string;
-        parameters: unknown[];
-        returns: string;
-    }>;
-    prompts: Array<{
-        name: string;
-        system_prompt: string;
-        version: string;
-    }>;
-    skills: Array<{
-        name: string;
-        description: string;
-        trigger: string;
-        content: string;
-    }>;
-    mcp_tools: Array<{
-        name: string;
-        description: string;
-        input_schema: unknown;
-        group: string;
-    }>;
-    capabilities: Array<{
-        name: string;
-        rights: string[];
-        scope: string;
-        delegation_depth: number;
-    }>;
-}
-export interface ToolResult {
-    success: boolean;
-    output: string;
-}
-/**
- * Check if @ruvector/rvagent-wasm is installed and loadable.
- */
-export declare function isAgentWasmAvailable(): Promise<boolean>;
-/**
- * Initialize the WASM module for Node.js. Safe to call multiple times.
- * Uses initSync with file-loaded WASM bytes (browser fetch doesn't work in Node).
- */
-export declare function initAgentWasm(): Promise<void>;
-/**
- * Create a new sandboxed WASM agent.
- */
-export declare function createWasmAgent(config?: WasmAgentConfig): Promise<WasmAgentInfo>;
-/**
- * Send a prompt to a WASM agent.
- *
- * ADR-129 P1: JsModelProvider is now wired at creation time so the WASM
- * agent's internal conversation loop (multi-turn state, turn_count,
- * stop conditions) runs against a real LLM.  The echo-stub detection
- * block is kept as a fallback for keyless environments (CI, sandboxed
- * test runners) — behaviour is identical to the pre-P1 path when no
- * provider key is set.
- *
- * Billing note: every wasm_agent_prompt call with a provider key
- * configured makes a billable LLM call.  Use a keyless environment to
- * get the echo stub for cost-free sandboxing.
- */
-export declare function promptWasmAgent(agentId: string, input: string): Promise<string>;
-export declare function executeWasmTool(agentId: string, toolCall: Record<string, unknown>): Promise<ToolResult>;
-/**
- * Get agent info.
- */
-export declare function getWasmAgent(agentId: string): WasmAgentInfo | null;
-/**
- * List all active WASM agents.
- */
-export declare function listWasmAgents(): WasmAgentInfo[];
-/**
- * Terminate a WASM agent and free resources.
- */
-export declare function terminateWasmAgent(agentId: string): boolean;
-/**
- * Get agent state (messages, turn count, etc.)
- */
-export declare function getWasmAgentState(agentId: string): unknown;
-/**
- * Get agent tools list.
- */
-export declare function getWasmAgentTools(agentId: string): string[];
-/**
- * Get agent todos.
- */
-export declare function getWasmAgentTodos(agentId: string): unknown[];
-/**
- * Export the full agent state as JSON (for persistence).
- */
-export declare function exportWasmState(agentId: string): string;
-/**
- * Create a WASM-based MCP server for an agent.
- * Returns a handler function for JSON-RPC requests.
- *
- * Note: WasmMcpServer may have stability issues in v0.1.0 for
- * certain agent configurations. Use with a fully configured agent.
- */
-export declare function createWasmMcpServer(agentId: string): Promise<(jsonRpc: string) => Promise<string>>;
-/**
- * List all available gallery templates.
- * Returns objects directly (Gallery.list() returns parsed objects in v0.1.0).
- */
-export declare function listGalleryTemplates(): Promise<GalleryTemplate[]>;
-/**
- * Get gallery template count.
- */
-export declare function getGalleryCount(): Promise<number>;
-/**
- * Get gallery categories with counts.
- */
-export declare function getGalleryCategories(): Promise<Record<string, number>>;
-/**
- * Search gallery templates by query. Returns results with relevance scores.
- */
-export declare function searchGalleryTemplates(query: string): Promise<Array<GalleryTemplate & {
-    relevance: number;
-}>>;
-/**
- * Get a gallery template by id.
- * Wraps in try/catch because WasmGallery.get() panics on unknown IDs in v0.1.0.
- */
-export declare function getGalleryTemplate(id: string): Promise<GalleryTemplateDetail | null>;
-/**
- * Create an agent from a gallery template.
- */
-export declare function createAgentFromTemplate(templateId: string): Promise<WasmAgentInfo>;
-export interface McpToolDescriptor {
-    name: string;
-    description: string;
-    input_schema: unknown;
-    group?: string;
-}
-/**
- * Build an RVF container with prompts, tools, skills, and MCP tool descriptors.
- * Uses the high-level RVF builder API (addPrompt, addTool, addSkill, addMcpTools).
- *
- * ADR-129 P2: mcpTools parameter wires builder.addMcpTools() so that
- * composed agents can declare which of ruflo's 314 MCP tools they need.
- */
-export declare function buildRvfContainer(opts: {
-    prompts?: Array<{
-        name: string;
-        system_prompt: string;
-        version: string;
-    }>;
-    tools?: Array<{
-        name: string;
-        description: string;
-        parameters: unknown[];
-        returns: string;
-    }>;
-    skills?: Array<{
-        name: string;
-        description: string;
-        trigger: string;
-        content: string;
-    }>;
-    mcpTools?: McpToolDescriptor[];
-}): Promise<Uint8Array>;
-/** Load a template as raw RVF bytes. */
-export declare function galleryLoadRvf(id: string): Promise<Uint8Array>;
-/** Apply configuration overrides to the active template. */
-export declare function galleryConfigure(configJson: string): Promise<void>;
-/** List templates filtered by category. */
-export declare function galleryListByCategory(category: string): Promise<GalleryTemplate[]>;
-/** Add a custom template to the gallery. */
-export declare function galleryAddCustom(templateJson: string): Promise<void>;
-/** Remove a custom template by ID. */
-export declare function galleryRemoveCustom(id: string): Promise<void>;
-/** Import custom templates from JSON. Returns the count imported. */
-export declare function galleryImportCustom(templatesJson: string): Promise<number>;
-/** Export all custom templates as JSON. */
-export declare function galleryExportCustom(): Promise<unknown>;
-/** Get the currently active template ID. */
-export declare function galleryGetActive(): Promise<string | undefined>;
-/** Get configuration overrides for the active template. */
-export declare function galleryGetConfig(): Promise<unknown>;
-/** Reset a WASM agent — clears messages and turn count. */
-export declare function resetWasmAgent(agentId: string): boolean;
-/**
- * Build an RVF container from a gallery template.
- *
- * ADR-129 P2: template.mcp_tools is now passed to buildRvfContainer so it
- * is included via builder.addMcpTools().  Previously these descriptors were
- * silently dropped, leaving gallery-template agents unable to declare their
- * intended MCP tool access.
- */
-export declare function buildRvfFromTemplate(templateId: string): Promise<Uint8Array>;
-//# sourceMappingURL=agent-wasm.d.ts.map