@sparkleideas/cli 3.1.0-alpha.19 → 3.1.0-alpha.21

package/dist/src/appliance/ruvllm-bridge.js

@@ -0,0 +1,292 @@
+/**
+ * ruvLLM Bridge -- Local Language Model Inference from RuVector
+ *
+ * Extends @ruvector/core with on-device GGUF model inference.
+ * Provides 3-tier routing:
+ *   Tier 1: Agent Booster (WASM, <1ms) -- simple transforms
+ *   Tier 2: Local model via ruvLLM (~200ms) -- routing, classification
+ *   Tier 3: Cloud API (2-5s) -- complex reasoning
+ *
+ * All @ruvector/* packages are optional peer dependencies.
+ * The bridge degrades gracefully when they are absent.
+ *
+ * @module @sparkleideas/cli/appliance/ruvllm-bridge
+ */
+import { readdir, stat } from 'node:fs/promises';
+import { join, extname, basename } from 'node:path';
+const DEFAULT_CONFIG = {
+    modelsDir: './models', defaultModel: '', maxTokens: 512,
+    temperature: 0.7, contextSize: 4096, kvCachePath: '', verbose: false,
+};
+// ── Quantization / parameter heuristics ─────────────────────
+const QUANT_PATTERNS = [
+    [/q4_k_m/i, 'q4_k_m'], [/q4_k_s/i, 'q4_k_s'], [/q4_0/i, 'q4_0'],
+    [/q5_k_m/i, 'q5_k_m'], [/q5_0/i, 'q5_0'], [/q8_0/i, 'q8_0'],
+    [/f16/i, 'f16'], [/f32/i, 'f32'],
+];
+function inferQuantization(filename) {
+    for (const [re, label] of QUANT_PATTERNS)
+        if (re.test(filename))
+            return label;
+    return 'unknown';
+}
+function inferParameters(filename) {
+    const m = filename.match(/(\d+)[._-]?b/i);
+    return m ? m[0].toUpperCase().replace(/[._-]/g, '') : 'unknown';
+}
+// ── Complexity heuristic ────────────────────────────────────
+const HIGH = new Set([
+    'architect', 'design', 'refactor', 'security', 'audit', 'complex',
+    'analyze', 'distributed', 'concurrent', 'algorithm', 'investigate',
+    'optimize', 'debug', 'system', 'integration',
+]);
+const LOW = new Set([
+    'rename', 'typo', 'format', 'comment', 'version', 'bump',
+    'move', 'copy', 'delete', 'simple', 'config',
+]);
+function estimateComplexity(desc) {
+    const words = desc.toLowerCase().split(/\s+/);
+    let score = 0.3;
+    for (const w of words) {
+        if (HIGH.has(w))
+            score += 0.15;
+        if (LOW.has(w))
+            score -= 0.1;
+    }
+    return Math.max(0, Math.min(1, score + Math.min(0.2, words.length / 200)));
+}
+// ── Bridge ──────────────────────────────────────────────────
+export class RuvllmBridge {
+    config;
+    models = new Map();
+    activeModel = null;
+    kvCacheEntries = 0;
+    ruvectorCore = null;
+    ruvectorRouter = null;
+    ruvectorSona = null;
+    ggufEngine = null;
+    constructor(config) {
+        if (!config.modelsDir)
+            throw new Error('RuvllmConfig.modelsDir is required');
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /** Probe optional @ruvector packages, initialize GGUF engine, and scan modelsDir. */
+    async initialize() {
+        this.ruvectorCore = await this.tryImport('@ruvector/core');
+        this.ruvectorRouter = await this.tryImport('@ruvector/router');
+        this.ruvectorSona = await this.tryImport('@ruvector/sona');
+        // Initialize GGUF engine for local model inference
+        try {
+            const { GgufEngine } = await import('./gguf-engine.js');
+            this.ggufEngine = new GgufEngine({
+                contextSize: this.config.contextSize,
+                maxTokens: this.config.maxTokens,
+                temperature: this.config.temperature,
+                kvCachePath: this.config.kvCachePath,
+                verbose: this.config.verbose,
+            });
+            await this.ggufEngine.initialize();
+        }
+        catch {
+            // GGUF engine is optional
+        }
+        await this.scanModelsDir();
+        if (this.config.verbose) {
+            const pkgs = [
+                this.ruvectorCore && '@ruvector/core',
+                this.ruvectorRouter && '@ruvector/router',
+                this.ruvectorSona && '@ruvector/sona',
+                this.ggufEngine && 'gguf-engine',
+            ].filter(Boolean);
+            if (pkgs.length)
+                console.log(`[ruvLLM] Loaded: ${pkgs.join(', ')}`);
+            console.log(`[ruvLLM] ${this.models.size} model(s) in ${this.config.modelsDir}`);
+        }
+    }
+    /** Return all discovered GGUF models. */
+    async listModels() {
+        return Array.from(this.models.values());
+    }
+    /** Load a model into memory (delegates to GGUF engine or @ruvector/core). */
+    async loadModel(name) {
+        const info = this.models.get(name);
+        if (!info)
+            throw new Error(`Model "${name}" not found. Available: ${[...this.models.keys()].join(', ')}`);
+        // Prefer GGUF engine (parses header, loads via node-llama-cpp if available)
+        if (this.ggufEngine) {
+            const meta = await this.ggufEngine.loadModel(info.path);
+            if (meta.architecture)
+                info.parameters = meta.architecture;
+            if (meta.quantization)
+                info.quantization = meta.quantization;
+        }
+        else if (this.ruvectorCore?.loadModel) {
+            await this.ruvectorCore.loadModel(info.path, { contextSize: this.config.contextSize });
+        }
+        info.loaded = true;
+        this.activeModel = name;
+    }
+    /**
+     * Generate text from a prompt. Routes through tiers:
+     * 1. Agent Booster (trivial transforms, no LLM).
+     * 2. Local GGUF model via @ruvector/core.
+     * 3. Cloud fallback (empty response -- caller handles upstream).
+     */
+    async generate(request) {
+        const start = performance.now();
+        const modelName = request.model ?? this.config.defaultModel ?? this.activeModel ?? '';
+        // Tier 1: Agent Booster
+        const booster = this.tryAgentBooster(request.prompt);
+        if (booster !== null) {
+            return { text: booster, model: 'agent-booster', tokensUsed: 0, latencyMs: performance.now() - start, tier: 1, cached: false };
+        }
+        // Tier 2: Local model (GGUF engine preferred, then @ruvector/core)
+        const info = this.models.get(modelName);
+        if (info?.loaded) {
+            try {
+                if (this.ggufEngine) {
+                    const r = await this.ggufEngine.generate({
+                        prompt: request.prompt,
+                        maxTokens: request.maxTokens ?? this.config.maxTokens,
+                        temperature: request.temperature ?? this.config.temperature,
+                        stopSequences: request.stopSequences,
+                    });
+                    return { text: r.text, model: modelName, tokensUsed: r.tokensUsed, latencyMs: performance.now() - start, tier: 2, cached: false };
+                }
+                else if (this.ruvectorCore?.generate) {
+                    const r = await this.ruvectorCore.generate({
+                        model: info.path, prompt: request.prompt,
+                        maxTokens: request.maxTokens ?? this.config.maxTokens,
+                        temperature: request.temperature ?? this.config.temperature,
+                        stopSequences: request.stopSequences,
+                    });
+                    return { text: r.text ?? '', model: modelName, tokensUsed: r.tokensUsed ?? 0, latencyMs: performance.now() - start, tier: 2, cached: false };
+                }
+            }
+            catch (err) {
+                if (this.config.verbose)
+                    console.warn('[ruvLLM] Local generation failed, tier 3 fallback:', err);
+            }
+        }
+        // Tier 3: Cloud fallback
+        return { text: '', model: 'cloud-fallback', tokensUsed: 0, latencyMs: performance.now() - start, tier: 3, cached: false };
+    }
+    /** Route a task description to the optimal tier. Uses @ruvector/router when available. */
+    async routeTask(description) {
+        if (this.ruvectorRouter?.route) {
+            try {
+                const r = await this.ruvectorRouter.route(description);
+                return { tier: r.tier ?? 3, model: r.model ?? 'cloud', confidence: r.confidence ?? 0.5 };
+            }
+            catch { /* fall through */ }
+        }
+        const complexity = estimateComplexity(description);
+        const words = description.split(/\s+/).length;
+        if (words < 15 && complexity < 0.25)
+            return { tier: 1, model: 'agent-booster', confidence: 0.9 };
+        if (complexity < 0.55 && this.activeModel)
+            return { tier: 2, model: this.activeModel, confidence: 0.7 };
+        return { tier: 3, model: 'cloud', confidence: 0.6 };
+    }
+    /** Return current bridge status. */
+    async getStatus() {
+        return {
+            available: this.models.size > 0 || this.ruvectorCore !== null,
+            ruvectorCore: this.ruvectorCore !== null,
+            ruvectorRouter: this.ruvectorRouter !== null,
+            ruvectorSona: this.ruvectorSona !== null,
+            modelsLoaded: [...this.models.values()].filter((m) => m.loaded).map((m) => m.name),
+            kvCacheSize: this.kvCacheEntries,
+        };
+    }
+    /** Persist KV-cache, unload models, and clean up. */
+    async shutdown() {
+        if (this.ggufEngine) {
+            await this.ggufEngine.shutdown();
+            this.ggufEngine = null;
+        }
+        if (this.config.kvCachePath && this.ruvectorCore?.persistKvCache) {
+            try {
+                await this.ruvectorCore.persistKvCache(this.config.kvCachePath);
+            }
+            catch (e) {
+                if (this.config.verbose)
+                    console.warn('[ruvLLM] KV-cache persist failed:', e);
+            }
+        }
+        if (this.ruvectorCore?.unloadAll)
+            await this.ruvectorCore.unloadAll();
+        for (const info of this.models.values())
+            info.loaded = false;
+        this.activeModel = null;
+        this.kvCacheEntries = 0;
+    }
+    // ── Private ───────────────────────────────────────────────
+    async scanModelsDir() {
+        try {
+            const entries = await readdir(this.config.modelsDir);
+            for (const entry of entries) {
+                if (extname(entry).toLowerCase() !== '.gguf')
+                    continue;
+                const fullPath = join(this.config.modelsDir, entry);
+                const s = await stat(fullPath);
+                if (!s.isFile())
+                    continue;
+                const name = basename(entry, '.gguf');
+                this.models.set(name, {
+                    name, path: fullPath, format: 'gguf',
+                    quantization: inferQuantization(entry), size: s.size,
+                    parameters: inferParameters(entry), loaded: false,
+                });
+            }
+        }
+        catch {
+            // modelsDir may not exist -- tier 1 and tier 3 still work
+        }
+    }
+    async tryImport(pkg) {
+        try {
+            return await import(pkg);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Tier-1 Agent Booster: handle trivial transforms without any LLM. */
+    tryAgentBooster(prompt) {
+        const t = prompt.trim();
+        if (t.length > 200)
+            return null;
+        if (/^(convert|change)\s+(var|let)\s+to\s+const$/i.test(t)) {
+            return 'Use the Edit tool to replace `var`/`let` declarations with `const`.';
+        }
+        if (/^remove\s+console\.(log|warn|error|debug|info)$/i.test(t)) {
+            const m = t.toLowerCase().match(/console\.(\w+)/)?.[1] ?? 'log';
+            return `Use the Edit tool to remove all \`console.${m}\` calls.`;
+        }
+        return null;
+    }
+}
+// ── Singleton accessor ──────────────────────────────────────
+let instance = null;
+/** Get or create the singleton RuvllmBridge. Config required on first call. */
+export function getRuvllmBridge(config) {
+    if (!instance && config)
+        instance = new RuvllmBridge(config);
+    if (!instance)
+        throw new Error('ruvLLM bridge not initialized. Call with config first.');
+    return instance;
+}
+/** Reset the singleton (useful for tests). */
+export function resetRuvllmBridge() { instance = null; }
+/** Check whether @ruvector/core is importable without loading the bridge. */
+export async function isRuvllmAvailable() {
+    try {
+        await import('@ruvector/core');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ruvllm-bridge.js.map

package/dist/src/appliance/ruvllm-bridge.js.map

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

package/dist/src/appliance/rvfa-builder.d.ts

@@ -0,0 +1,44 @@
+/**
+ * RVFA Appliance Builder -- Constructs self-contained .rvf appliance files.
+ *
+ * Creates a single binary containing kernel, runtime, Ruflo CLI, models/keys,
+ * AgentDB data, and the verification suite. See ADR-058.
+ */
+export interface BuildOptions {
+    profile: 'cloud' | 'hybrid' | 'offline';
+    arch: string;
+    output: string;
+    rufloVersion?: string;
+    models?: string[];
+    apiKeys?: string;
+    verbose?: boolean;
+}
+export interface BuildResult {
+    outputPath: string;
+    size: number;
+    sections: {
+        id: string;
+        size: number;
+        originalSize: number;
+    }[];
+    duration: number;
+    profile: string;
+}
+/** Encrypt API keys from a .env file. Output: salt(32)+iv(16)+tag(16)+ciphertext */
+export declare function encryptApiKeys(envPath: string, passphrase: string): Buffer;
+/** Decrypt API keys previously encrypted with encryptApiKeys. */
+export declare function decryptApiKeys(buf: Buffer, passphrase: string): Record<string, string>;
+export declare class RvfaBuilder {
+    private opts;
+    constructor(options: BuildOptions);
+    build(): Promise<BuildResult>;
+    private buildKernelSection;
+    private buildRuntimeSection;
+    private buildRufloSection;
+    private buildModelsSection;
+    private buildDataSection;
+    private buildVerifySection;
+    private buildHeaderPartial;
+    private log;
+}
+//# sourceMappingURL=rvfa-builder.d.ts.map

package/dist/src/appliance/rvfa-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rvfa-builder.d.ts","sourceRoot":"","sources":["../../../src/appliance/rvfa-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AA4BD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAW1E;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBtF;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAyB;gBAEzB,OAAO,EAAE,YAAY;IAY3B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAwDnC,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,GAAG;CAGZ"}