@claude-flow/cli 3.32.1 → 3.32.3

package/dist/src/benchmarks/pretrain/index.js

@@ -1,404 +0,0 @@
-/**
- * Self-Learning Pre-Training Benchmark Suite
- * Comprehensive benchmarks for SONA, EWC++, MoE, pattern learning
- *
- * Metrics measured:
- * - SONA adaptation latency (<0.05ms target)
- * - Pattern learning throughput
- * - EWC++ consolidation effectiveness
- * - Memory retrieval accuracy
- * - Pre-training convergence speed
- *
- * @module v3/cli/benchmarks/pretrain
- */
-import { performance } from 'node:perf_hooks';
-// ============================================================================
-// Utility Functions
-// ============================================================================
-function percentile(sorted, p) {
-    const idx = Math.ceil((p / 100) * sorted.length) - 1;
-    return sorted[Math.max(0, idx)];
-}
-function mean(arr) {
-    return arr.reduce((a, b) => a + b, 0) / arr.length;
-}
-function stdDev(arr, avg) {
-    const squaredDiffs = arr.map(x => Math.pow(x - avg, 2));
-    return Math.sqrt(mean(squaredDiffs));
-}
-export function formatBenchmarkResult(result) {
-    const status = result.targetMet ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m';
-    const target = result.targetMs ? ` (target: ${result.targetMs}ms)` : '';
-    return [
-        `${status} ${result.name}${target}`,
-        `   Mean: ${result.meanMs.toFixed(4)}ms | Median: ${result.medianMs.toFixed(4)}ms`,
-        `   p95: ${result.p95Ms.toFixed(4)}ms | p99: ${result.p99Ms.toFixed(4)}ms`,
-        `   Min: ${result.minMs.toFixed(4)}ms | Max: ${result.maxMs.toFixed(4)}ms`,
-        `   StdDev: ${result.stdDev.toFixed(4)}ms | Ops/s: ${result.opsPerSecond.toFixed(0)}`,
-    ].join('\n');
-}
-// ============================================================================
-// Core Benchmark Runner
-// ============================================================================
-export async function runBenchmark(name, fn, config) {
-    const { iterations, warmupIterations, targetMs, verbose } = config;
-    const times = [];
-    // Warmup phase
-    if (verbose)
-        console.log(`  Warming up ${name} (${warmupIterations} iterations)...`);
-    for (let i = 0; i < warmupIterations; i++) {
-        await fn();
-    }
-    // Measurement phase
-    if (verbose)
-        console.log(`  Running ${name} (${iterations} iterations)...`);
-    for (let i = 0; i < iterations; i++) {
-        const start = performance.now();
-        await fn();
-        times.push(performance.now() - start);
-    }
-    // Calculate statistics
-    const sorted = [...times].sort((a, b) => a - b);
-    const avg = mean(times);
-    const std = stdDev(times, avg);
-    return {
-        name,
-        iterations,
-        meanMs: avg,
-        medianMs: percentile(sorted, 50),
-        p95Ms: percentile(sorted, 95),
-        p99Ms: percentile(sorted, 99),
-        minMs: sorted[0],
-        maxMs: sorted[sorted.length - 1],
-        stdDev: std,
-        opsPerSecond: 1000 / avg,
-        targetMet: targetMs ? avg <= targetMs : true,
-        targetMs,
-    };
-}
-// ============================================================================
-// SONA Adaptation Benchmarks
-// ============================================================================
-export async function benchmarkSONAAdaptation(config) {
-    // Fallback implementation for SONA adaptation
-    const sonaAdapt = async (_signal) => {
-        // Simulate SONA adaptation with minimal computation
-        const start = performance.now();
-        // Simple computation to simulate adaptation
-        let sum = 0;
-        for (let i = 0; i < 100; i++) {
-            sum += Math.sin(i) * Math.cos(i);
-        }
-        const latency = performance.now() - start;
-        return { adapted: sum > -1000, latencyMs: latency };
-    };
-    const testSignals = [
-        { type: 'observation', content: 'User requested feature implementation' },
-        { type: 'action', content: 'Created new component file' },
-        { type: 'result', content: 'Component successfully rendered' },
-        { type: 'thought', content: 'Should add error handling' },
-    ];
-    let signalIdx = 0;
-    return runBenchmark('SONA Adaptation', async () => {
-        await sonaAdapt(testSignals[signalIdx % testSignals.length]);
-        signalIdx++;
-    }, { ...config, targetMs: config.targetMs || 0.05 });
-}
-// ============================================================================
-// Pattern Learning Benchmarks
-// ============================================================================
-export async function benchmarkPatternLearning(config) {
-    // Simulate pattern learning step recording
-    const recordStep = async (_step) => {
-        // Simulate recording - just a hash computation
-        let hash = 0;
-        const str = _step.content;
-        for (let i = 0; i < str.length; i++) {
-            hash = ((hash << 5) - hash + str.charCodeAt(i)) | 0;
-        }
-        return hash;
-    };
-    const testSteps = [
-        { type: 'observation', content: 'Analyzing codebase structure' },
-        { type: 'thought', content: 'Identified potential optimization' },
-        { type: 'action', content: 'Refactored module imports' },
-        { type: 'result', content: 'Build time reduced by 15%' },
-    ];
-    let stepIdx = 0;
-    return runBenchmark('Pattern Learning (Record Step)', async () => {
-        await recordStep(testSteps[stepIdx % testSteps.length]);
-        stepIdx++;
-    }, { ...config, targetMs: config.targetMs || 0.1 });
-}
-// ============================================================================
-// EWC++ Consolidation Benchmarks
-// ============================================================================
-export async function benchmarkEWCConsolidation(config) {
-    // Simulate EWC++ consolidation
-    const consolidate = async () => {
-        // Simulate consolidation computation
-        const patterns = 100;
-        let consolidated = 0;
-        for (let i = 0; i < patterns; i++) {
-            // Simulate Fisher information computation
-            const importance = Math.random();
-            if (importance > 0.3) {
-                consolidated++;
-            }
-        }
-        return { consolidated, preserved: patterns - consolidated };
-    };
-    return runBenchmark('EWC++ Consolidation', async () => {
-        await consolidate();
-    }, { ...config, targetMs: config.targetMs || 5.0 });
-}
-// ============================================================================
-// Memory Retrieval Benchmarks
-// ============================================================================
-export async function benchmarkMemoryRetrieval(config) {
-    // Simulate memory search
-    const searchEntries = async (_options) => {
-        // Simulate vector search with cosine similarity
-        const numVectors = 1000;
-        const dim = 384;
-        const queryVec = new Float32Array(dim).map(() => Math.random());
-        const results = [];
-        for (let i = 0; i < Math.min(numVectors, 100); i++) {
-            const vec = new Float32Array(dim).map(() => Math.random());
-            let dot = 0, normQ = 0, normV = 0;
-            for (let j = 0; j < dim; j++) {
-                dot += queryVec[j] * vec[j];
-                normQ += queryVec[j] * queryVec[j];
-                normV += vec[j] * vec[j];
-            }
-            results.push({ score: dot / (Math.sqrt(normQ) * Math.sqrt(normV)) });
-        }
-        return { results: results.slice(0, _options.limit || 10), searchTime: 1.0 };
-    };
-    const testQueries = [
-        'authentication patterns',
-        'error handling best practices',
-        'performance optimization techniques',
-        'testing strategies',
-        'security vulnerability fixes',
-    ];
-    let queryIdx = 0;
-    return runBenchmark('Memory Retrieval (HNSW Search)', async () => {
-        await searchEntries({
-            query: testQueries[queryIdx % testQueries.length],
-            namespace: 'patterns',
-            limit: 10,
-        });
-        queryIdx++;
-    }, { ...config, targetMs: config.targetMs || 10.0 });
-}
-// ============================================================================
-// Embedding Generation Benchmarks
-// ============================================================================
-export async function benchmarkEmbeddingGeneration(config) {
-    // Simulate embedding generation
-    const generateEmbedding = async (text) => {
-        const dim = 384;
-        const embedding = new Float32Array(dim);
-        for (let i = 0; i < dim; i++) {
-            let hash = 0;
-            for (let j = 0; j < text.length; j++) {
-                hash = ((hash << 5) - hash + text.charCodeAt(j) * (i + 1)) | 0;
-            }
-            embedding[i] = Math.sin(hash) * 0.5;
-        }
-        // Normalize
-        let norm = 0;
-        for (let i = 0; i < dim; i++) {
-            norm += embedding[i] * embedding[i];
-        }
-        norm = Math.sqrt(norm);
-        for (let i = 0; i < dim; i++) {
-            embedding[i] /= norm;
-        }
-        return embedding;
-    };
-    const testTexts = [
-        'Implement user authentication with JWT tokens',
-        'Fix memory leak in event handler cleanup',
-        'Add unit tests for payment processing module',
-        'Refactor database connection pooling',
-        'Optimize React component rendering performance',
-    ];
-    let textIdx = 0;
-    return runBenchmark('Embedding Generation', async () => {
-        await generateEmbedding(testTexts[textIdx % testTexts.length]);
-        textIdx++;
-    }, { ...config, targetMs: config.targetMs || 5.0 });
-}
-// ============================================================================
-// MoE Routing Benchmarks
-// ============================================================================
-export async function benchmarkMoERouting(config) {
-    // Simulate MoE routing
-    const experts = ['coder', 'tester', 'reviewer', 'architect', 'security'];
-    const route = async (task) => {
-        // Simple keyword-based routing simulation
-        const keywords = {
-            coder: ['implement', 'fix', 'code', 'function'],
-            tester: ['test', 'spec', 'coverage', 'unit'],
-            reviewer: ['review', 'quality', 'check'],
-            architect: ['design', 'architecture', 'pattern'],
-            security: ['security', 'auth', 'vulnerability'],
-        };
-        let bestExpert = 'coder';
-        let bestScore = 0;
-        for (const [expert, words] of Object.entries(keywords)) {
-            let score = 0;
-            for (const word of words) {
-                if (task.toLowerCase().includes(word)) {
-                    score++;
-                }
-            }
-            if (score > bestScore) {
-                bestScore = score;
-                bestExpert = expert;
-            }
-        }
-        return { expert: bestExpert, confidence: 0.7 + Math.random() * 0.25 };
-    };
-    const testTasks = [
-        'Fix authentication bug in login flow',
-        'Add new REST API endpoint for users',
-        'Write integration tests for checkout',
-        'Optimize database query performance',
-        'Review security of payment processing',
-    ];
-    let taskIdx = 0;
-    return runBenchmark('MoE Expert Routing', async () => {
-        await route(testTasks[taskIdx % testTasks.length]);
-        taskIdx++;
-    }, { ...config, targetMs: config.targetMs || 1.0 });
-}
-// ============================================================================
-// Batch Operations Benchmarks
-// ============================================================================
-export async function benchmarkBatchCosine(config) {
-    // Batch cosine similarity
-    const batchCosineSim = (query, vectors) => {
-        const results = new Float32Array(vectors.length);
-        for (let i = 0; i < vectors.length; i++) {
-            let dot = 0, normQ = 0, normV = 0;
-            for (let j = 0; j < query.length; j++) {
-                dot += query[j] * vectors[i][j];
-                normQ += query[j] * query[j];
-                normV += vectors[i][j] * vectors[i][j];
-            }
-            results[i] = dot / (Math.sqrt(normQ) * Math.sqrt(normV));
-        }
-        return results;
-    };
-    // Generate test vectors
-    const dim = 384;
-    const numVectors = 1000;
-    const query = new Float32Array(dim).map(() => Math.random());
-    const vectors = Array.from({ length: numVectors }, () => new Float32Array(dim).map(() => Math.random()));
-    return runBenchmark(`Batch Cosine Similarity (${numVectors} vectors)`, async () => {
-        batchCosineSim(query, vectors);
-    }, { ...config, targetMs: config.targetMs || 2.0 });
-}
-// ============================================================================
-// Full Pre-Training Pipeline Benchmark
-// ============================================================================
-export async function benchmarkPretrainPipeline(config) {
-    // Simulate full pre-training pipeline
-    const pipeline = async () => {
-        // Step 1: Analyze repository structure (simulated)
-        const files = Array.from({ length: 50 }, (_, i) => ({
-            path: `src/module${i}/index.ts`,
-            content: `export function fn${i}() { return ${i}; }`,
-        }));
-        // Step 2: Generate embeddings for each file
-        const embeddings = [];
-        for (const file of files) {
-            const embedding = new Float32Array(384);
-            for (let i = 0; i < 384; i++) {
-                embedding[i] = Math.sin(file.path.charCodeAt(i % file.path.length) * (i + 1));
-            }
-            embeddings.push(embedding);
-        }
-        // Step 3: Build pattern index (simulated HNSW construction)
-        const index = new Map();
-        embeddings.forEach((emb, i) => index.set(i, emb));
-        // Step 4: Extract patterns
-        const patterns = files.slice(0, 10).map((f, i) => ({
-            id: `pattern-${i}`,
-            type: 'code-structure',
-            embedding: embeddings[i],
-            confidence: embeddings[i] ? 1.0 : 0, // real: has embedding = confident
-        }));
-        return { files: files.length, patterns: patterns.length };
-    };
-    return runBenchmark('Pre-Training Pipeline (50 files)', async () => {
-        await pipeline();
-    }, { ...config, targetMs: config.targetMs || 100.0 });
-}
-// ============================================================================
-// Full Benchmark Suite
-// ============================================================================
-export async function runPretrainBenchmarkSuite(config = {}) {
-    const fullConfig = {
-        iterations: config.iterations || 100,
-        warmupIterations: config.warmupIterations || 10,
-        verbose: config.verbose ?? false,
-    };
-    console.log('\n\x1b[1m\x1b[36m═══════════════════════════════════════════════════════════════\x1b[0m');
-    console.log('\x1b[1m\x1b[36m  Self-Learning Pre-Training Benchmark Suite\x1b[0m');
-    console.log('\x1b[1m\x1b[36m═══════════════════════════════════════════════════════════════\x1b[0m\n');
-    const startTime = performance.now();
-    const results = [];
-    // Run all benchmarks
-    const benchmarks = [
-        { name: 'SONA', fn: () => benchmarkSONAAdaptation(fullConfig) },
-        { name: 'Pattern Learning', fn: () => benchmarkPatternLearning(fullConfig) },
-        { name: 'EWC++', fn: () => benchmarkEWCConsolidation({ ...fullConfig, iterations: 20 }) },
-        { name: 'Memory Retrieval', fn: () => benchmarkMemoryRetrieval(fullConfig) },
-        { name: 'Embedding Gen', fn: () => benchmarkEmbeddingGeneration(fullConfig) },
-        { name: 'MoE Routing', fn: () => benchmarkMoERouting(fullConfig) },
-        { name: 'Batch Cosine', fn: () => benchmarkBatchCosine(fullConfig) },
-        { name: 'Pretrain Pipeline', fn: () => benchmarkPretrainPipeline({ ...fullConfig, iterations: 10 }) },
-    ];
-    for (const benchmark of benchmarks) {
-        console.log(`\x1b[33m► Running ${benchmark.name} benchmark...\x1b[0m`);
-        try {
-            const result = await benchmark.fn();
-            results.push(result);
-            console.log(formatBenchmarkResult(result));
-            console.log();
-        }
-        catch (error) {
-            console.error(`\x1b[31m✗ ${benchmark.name} failed: ${error}\x1b[0m\n`);
-        }
-    }
-    const totalDuration = performance.now() - startTime;
-    // Summary
-    console.log('\x1b[1m\x1b[36m═══════════════════════════════════════════════════════════════\x1b[0m');
-    console.log('\x1b[1m  Summary\x1b[0m');
-    console.log('\x1b[36m───────────────────────────────────────────────────────────────\x1b[0m');
-    const passed = results.filter(r => r.targetMet).length;
-    const total = results.length;
-    console.log(`  Total benchmarks: ${total}`);
-    console.log(`  Targets met: \x1b[${passed === total ? '32' : '33'}m${passed}/${total}\x1b[0m`);
-    console.log(`  Total duration: ${(totalDuration / 1000).toFixed(2)}s`);
-    console.log('\x1b[1m\x1b[36m═══════════════════════════════════════════════════════════════\x1b[0m\n');
-    return {
-        name: 'pretrain-benchmark-suite',
-        results,
-        totalDurationMs: totalDuration,
-        timestamp: new Date().toISOString(),
-        environment: {
-            nodeVersion: process.version,
-            platform: process.platform,
-            arch: process.arch,
-            cpuCount: (await import('node:os')).cpus().length,
-        },
-    };
-}
-// Export for CLI usage
-export default runPretrainBenchmarkSuite;
-//# sourceMappingURL=index.js.map

package/dist/src/business-pods/bbs-budget-tracker.d.ts

@@ -1,139 +0,0 @@
-/**
- * BbsRoomBudgetTracker — Atomic reserve / commit / release token-bucket
- * backed by better-sqlite3 (ADR-164.1 §3-§5).
- *
- * Closes the read-then-write race in ADR-164's first-draft tracker by routing
- * every state transition through a single `BEGIN IMMEDIATE` transaction that
- * acquires the SQLite write lock atomically with the gate check. The
- * `_lock_bump` column write is a belt-and-suspenders explicit write inside
- * the transaction so the lock acquisition is visible to code review and
- * query-log analysis (§3.2 peer-review clarification).
- *
- * Architectural constraints (ADR-164.1):
- *   - Default OFF: this module is opt-in behind `CLAUDE_FLOW_BBS_ATOMIC_BUDGET=1`.
- *     The pod-tick.mjs file-based stub remains the default until the flag is
- *     flipped per ADR-164.1 §12.4.
- *   - `committed_post_expiry` state machine implemented per §5.3 — late
- *     commits on expired reservations ARE accepted (the API spend already
- *     happened), transition to `committed_post_expiry`, charge the budget,
- *     and return `warned: 'COMMIT_AFTER_EXPIRY'`. This closes the §8.1
- *     Expired Commit Leak surfaced by peer review on 2026-06-29.
- *   - `expires_at` is clamped to [5_000, 300_000] ms (§3.2).
- *   - WAL + synchronous=NORMAL + busy_timeout=500 for write throughput.
- *
- * The sweeper interval (`sweepExpired()`) is exposed as a manual method;
- * callers are expected to drive it on a setInterval — that integration lives
- * at the call site, not in this file, per ADR-164.1 §7.1.
- *
- * @module @claude-flow/cli/business-pods/bbs-budget-tracker
- */
-export interface SqliteDatabase {
-    pragma(name: string): unknown;
-    prepare(sql: string): SqliteStatement;
-    exec(sql: string): void;
-    close(): void;
-}
-export interface SqliteStatement {
-    run(...params: unknown[]): {
-        changes: number;
-        lastInsertRowid: number | bigint;
-    };
-    get(...params: unknown[]): Record<string, unknown> | undefined;
-    all(...params: unknown[]): Record<string, unknown>[];
-}
-export declare const RESERVATION_EXPIRY_FLOOR_MS = 5000;
-export declare const RESERVATION_EXPIRY_CEILING_MS = 300000;
-export declare const RESERVATION_EXPIRY_DEFAULT_MS = 60000;
-export declare function clampReservationExpiry(raw: number | undefined): number;
-export type ReserveResult = {
-    ok: true;
-    reservationId: string;
-    remainingAfterReserve: number;
-} | {
-    ok: false;
-    error: 'BUDGET_EXCEEDED' | 'ROOM_NOT_FOUND';
-};
-export type CommitResult = {
-    ok: true;
-    committed: true;
-    finalRemaining: number;
-} | {
-    ok: true;
-    warned: 'COMMIT_AFTER_EXPIRY';
-    finalRemaining: number;
-} | {
-    ok: false;
-    error: 'NOT_FOUND' | 'ALREADY_FINALIZED';
-};
-export type ReleaseResult = {
-    ok: true;
-    released: true;
-} | {
-    ok: false;
-    error: 'NOT_FOUND' | 'ALREADY_FINALIZED';
-};
-export declare const SCHEMA_SQL = "\nPRAGMA journal_mode = WAL;\nPRAGMA synchronous = NORMAL;\nPRAGMA busy_timeout = 500;\n\nCREATE TABLE IF NOT EXISTS bbs_budget_rooms (\n  room_id         TEXT NOT NULL PRIMARY KEY,\n  monthly_cap_usd REAL NOT NULL CHECK (monthly_cap_usd >= 0),\n  billing_month   TEXT NOT NULL,\n  _lock_bump      INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE TABLE IF NOT EXISTS bbs_budget_reservations (\n  reservation_id    TEXT NOT NULL PRIMARY KEY,\n  room_id           TEXT NOT NULL REFERENCES bbs_budget_rooms(room_id),\n  caller_node_id    TEXT NOT NULL,\n  estimated_usd     REAL NOT NULL CHECK (estimated_usd >= 0),\n  actual_usd        REAL,\n  state             TEXT NOT NULL\n                    CHECK (state IN ('reserved','committed','released','expired','committed_post_expiry')),\n  reserved_at       INTEGER NOT NULL,\n  expires_at        INTEGER NOT NULL,\n  committed_at      INTEGER,\n  audit_envelope_id TEXT NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_reservations_room_month\n  ON bbs_budget_reservations (room_id, reserved_at);\n\nCREATE INDEX IF NOT EXISTS idx_reservations_expiry\n  ON bbs_budget_reservations (state, expires_at);\n";
-export interface BudgetAuditSink {
-    emit(eventType: 'reservation.committed_post_expiry' | 'reservation.committed' | 'reservation.released' | 'reservation.reserved' | 'reservation.budget_exceeded', payload: Record<string, unknown>): void;
-}
-export interface AtomicBbsRoomBudgetTrackerOptions {
-    /** SQLite database handle (caller-owned, opened in WAL mode). */
-    db: SqliteDatabase;
-    /** Override the default 60s reservation window (clamped to [5s, 300s]). */
-    defaultExpiryMs?: number;
-    /** Audit sink — receives reservation lifecycle events. */
-    audit?: BudgetAuditSink;
-    /** Inject Date.now() for tests. */
-    clock?: () => number;
-}
-export declare class AtomicBbsRoomBudgetTracker {
-    private readonly db;
-    private readonly defaultExpiryMs;
-    private readonly audit;
-    private readonly clock;
-    constructor(opts: AtomicBbsRoomBudgetTrackerOptions);
-    /**
-     * Register (or update) a room and its monthly cap. Idempotent.
-     */
-    registerRoom(roomId: string, monthlyCapUsd: number): void;
-    /**
-     * Atomically check budget and insert a reservation row in a single
-     * BEGIN IMMEDIATE transaction. See ADR-164.1 §5.2.
-     */
-    reserve(roomId: string, callerId: string, estimatedUsd: number, opts?: {
-        auditEnvelopeId?: string;
-        expiryMs?: number;
-    }): ReserveResult;
-    /**
-     * Commit the reservation with the actual cost. Late commits (expired
-     * before commit landed) ARE accepted, transitioned to
-     * 'committed_post_expiry', charged to the budget, and surfaced via
-     * `warned: 'COMMIT_AFTER_EXPIRY'` plus a `reservation.committed_post_expiry`
-     * audit emit. See ADR-164.1 §5.3 + §8.1.
-     */
-    commit(reservationId: string, actualUsd: number): CommitResult;
-    /**
-     * Release a reservation (caller decided not to proceed). State must be
-     * 'reserved'; any other state is ALREADY_FINALIZED.
-     */
-    release(reservationId: string): ReleaseResult;
-    /**
-     * Sweep expired reservations: transition 'reserved' rows whose expiry has
-     * passed to 'expired'. Callers should drive this on a setInterval per
-     * ADR-164.1 §7.1 (default cadence 5s; this method does NOT install the
-     * timer — that's the integration site's responsibility).
-     * Returns the number of rows updated.
-     */
-    sweepExpired(): number;
-    /**
-     * Diagnostic read: list reservations for a room. Not on the hot path.
-     */
-    listReservations(roomId: string): Array<Record<string, unknown>>;
-}
-/**
- * Feature-flagged factory per ADR-164.1 §12.3. Returns an atomic tracker
- * when `CLAUDE_FLOW_BBS_ATOMIC_BUDGET=1`, otherwise returns null so the
- * caller can keep using the file-based stub in pod-tick.mjs.
- */
-export declare function createAtomicTrackerIfEnabled(opts: AtomicBbsRoomBudgetTrackerOptions): AtomicBbsRoomBudgetTracker | null;
-//# sourceMappingURL=bbs-budget-tracker.d.ts.map