agentic-qe 3.6.19 → 3.7.0

package/v3/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to Agentic QE will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.7.0] - 2026-02-23
+
+### Added
+
+- **RVF Cognitive Container integration** — 12 of 16 planned integration tasks completed across 4 workstreams: MinCut routing, dream cycle branching, witness chain attestation, and HNSW unification
+- **MinCut-based task routing** — Lambda (vertex connectivity) analysis models task complexity as a graph problem for the 3-tier model router; shadow mode collects comparison data against the production heuristic router
+- **RVCOW dream cycle branching** — Copy-on-write branching for dream cycle experimentation using SQLite savepoints and in-memory overlays; speculative insights are isolated until merged
+- **Cryptographic witness chain** — SHA-256 hash-chained append-only audit trail for quality gate decisions, pattern promotions, test suite completions, and routing decisions; tamper-evident with chain verification
+- **HNSW unification** — Consolidated 3 fragmented HNSW implementations behind a unified progressive adapter with 2-state search (fast flat scan vs full HNSW) based on collection size
+- **Brain export/import CLI** — `aqe brain export`, `aqe brain import --dry-run`, and `aqe brain info` commands for portable QE intelligence containers (.aqe-brain format with JSONL + binary vectors)
+- **MinCut test suite optimizer** — Models test suites as coverage graphs, computes minimum cut to identify critical tests, skippable tests, and optimal execution order; wired into test-execution domain
+- **RVF dual-writer** — Best-effort dual-write from QEReasoningBank to both SQLite and RVF containers, preparing for future RVF promotion as primary storage
+- **RVF native adapter** — Direct N-API bindings to @ruvector/rvf-node bypassing SDK wrapper bugs; graceful fallback when native binaries unavailable
+- **Stoer-Wagner structural health monitor** — Computes exact mincut of swarm and codebase dependency graphs as a normalized connectivity health score
+- **MinCut wrapper** — Unified interface over TypeScript MinCutCalculator with native @ruvector/mincut-node fallback detection
+- **246 new tests** across all RVF integration modules (unit + integration)
+
+### Fixed
+
+- **Dead module wiring** — MinCut test optimizer, brain CLI handler, and RVF dual-writer were implemented but not reachable from production code paths; all three now wired into their respective domains
+- **Benchmark baseline integrity** — Original pre-RVF baseline (Feb 22) restored after being accidentally overwritten by post-integration rerun; Feb 23 rerun preserved separately
+- **Dual-writer test honesty** — 21 mock-only tests that verified call counts without checking behavior replaced with assertions that verify argument content and response shape
+- **HNSW unification test stability** — Fixed non-deterministic vector ordering caused by cosine similarity scale-invariance (`v * 0.9` has identical cosine similarity to `v`); replaced with directionally different vector
+
+### Changed
+
+- **Benchmark report transparency** — All "Live" status claims corrected to "Wired" or "Internal"; added honest "Modules Not Yet Wired" section; recommendations expanded from 5 to 9
+- **QEReasoningBank extensibility** — Added optional `setRvfDualWriter()` injection point for best-effort dual-write during `storePattern()` and `promotePattern()`
+- **Test execution coordinator** — Added `optimizeTestSuite()` method delegating to MinCut test optimizer
+
 ## [3.6.19] - 2026-02-22
 
 ### Fixed

package/v3/dist/audit/witness-chain.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Witness Chain - Cryptographic Audit Trail for QE Decisions
+ * ADR-070: Witness Chain Audit Compliance
+ *
+ * Implements a SHA-256 hash-chained append-only log for audit compliance.
+ * Every quality gate decision, pattern mutation, and dream cycle action
+ * is recorded with cryptographic integrity guarantees.
+ *
+ * The chain is tamper-evident: modifying any entry breaks the hash chain,
+ * detectable by verify().
+ */
+import { type Database as DatabaseType } from 'better-sqlite3';
+/**
+ * Actions that can be recorded in the witness chain
+ */
+export type WitnessActionType = 'PATTERN_CREATE' | 'PATTERN_UPDATE' | 'PATTERN_PROMOTE' | 'PATTERN_QUARANTINE' | 'DREAM_MERGE' | 'DREAM_DISCARD' | 'QUALITY_GATE_PASS' | 'QUALITY_GATE_FAIL' | 'ROUTING_DECISION';
+/**
+ * A single entry in the witness chain
+ */
+export interface WitnessEntry {
+    /** Auto-incrementing ID */
+    id: number;
+    /** SHA-256 hash of the previous entry (64 hex chars, all zeros for genesis) */
+    prev_hash: string;
+    /** SHA-256 hash of the action data */
+    action_hash: string;
+    /** Type of action recorded */
+    action_type: WitnessActionType;
+    /** JSON-serialized action data */
+    action_data: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Actor identifier (agent ID, system, dream engine, etc.) */
+    actor: string;
+}
+/**
+ * Filter options for querying witness entries
+ */
+export interface WitnessFilter {
+    /** Filter by action type */
+    action_type?: WitnessActionType;
+    /** Filter entries after this timestamp (inclusive) */
+    since?: string;
+    /** Filter entries before this timestamp (inclusive) */
+    until?: string;
+    /** Filter by actor */
+    actor?: string;
+    /** Maximum number of entries to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Result of chain integrity verification
+ */
+export interface VerifyResult {
+    /** Whether the entire chain is valid */
+    valid: boolean;
+    /** The entry ID where the chain broke (undefined if valid) */
+    brokenAt?: number;
+    /** Total entries checked */
+    entriesChecked: number;
+}
+/** Genesis previous hash: 64 zero characters */
+declare const GENESIS_PREV_HASH: string;
+/**
+ * SHA-256 hash-chained append-only audit log.
+ *
+ * Each entry's prev_hash is the SHA-256 of the serialized previous entry,
+ * creating an immutable chain. Any modification to a past entry will cause
+ * verify() to detect the break.
+ */
+export declare class WitnessChain {
+    private readonly externalDb?;
+    private db;
+    private initialized;
+    /**
+     * Create a WitnessChain instance.
+     *
+     * @param externalDb - Optional external database connection (for testing
+     *   with in-memory SQLite). When omitted, uses UnifiedMemoryManager.
+     */
+    constructor(externalDb?: DatabaseType | undefined);
+    /**
+     * Initialize the witness chain.
+     * Creates the witness_chain table if it does not exist.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create the witness_chain table (additive, does not touch other tables).
+     */
+    private ensureTable;
+    /**
+     * Append a new entry to the witness chain.
+     *
+     * @param actionType - The type of action being recorded
+     * @param actionData - Arbitrary data describing the action
+     * @param actor - Who performed the action
+     * @returns The newly created WitnessEntry
+     */
+    append(actionType: WitnessActionType, actionData: Record<string, unknown>, actor: string): WitnessEntry;
+    /**
+     * Verify the integrity of the entire witness chain.
+     *
+     * Walks through every entry in order and checks that each entry's
+     * prev_hash matches the SHA-256 of the previous entry's serialized form.
+     *
+     * @returns Verification result with validity status and break point
+     */
+    verify(): VerifyResult;
+    /**
+     * Query witness chain entries with optional filters.
+     *
+     * @param filter - Optional filter criteria
+     * @returns Array of matching WitnessEntry records
+     */
+    getEntries(filter?: WitnessFilter): WitnessEntry[];
+    /**
+     * Cross-verify our SQLite witness chain against an RVF native witness.
+     *
+     * Calls rvfAdapter.status() to get witnessValid and witnessEntries,
+     * then compares with our own verify() result.
+     *
+     * @param rvfAdapter - An RvfNativeAdapter instance with a status() method
+     * @returns Cross-verification result from both chains
+     */
+    crossVerifyWithRvf(rvfAdapter: any): {
+        sqliteValid: boolean;
+        rvfValid: boolean;
+        rvfEntries: number;
+        bothValid: boolean;
+    };
+    /**
+     * Get the total number of entries in the chain.
+     */
+    getChainLength(): number;
+}
+/**
+ * Get or create the singleton WitnessChain instance.
+ * Uses UnifiedMemoryManager for storage.
+ */
+export declare function getWitnessChain(): Promise<WitnessChain>;
+/**
+ * Create a WitnessChain with an external database (for testing).
+ */
+export declare function createWitnessChain(db: DatabaseType): WitnessChain;
+export { GENESIS_PREV_HASH };
+//# sourceMappingURL=witness-chain.d.ts.map

package/v3/dist/audit/witness-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-chain.d.ts","sourceRoot":"","sources":["../../src/audit/witness-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ/D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,aAAa,GACb,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,gDAAgD;AAChD,QAAA,MAAM,iBAAiB,QAAiB,CAAC;AAMzC;;;;;;GAMG;AACH,qBAAa,YAAY;IAUX,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IATxC,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;OAKG;gBAC0B,UAAU,CAAC,EAAE,YAAY,YAAA;IAEtD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;;;;;OAOG;IACH,MAAM,CACJ,UAAU,EAAE,iBAAiB,EAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,MAAM,GACZ,YAAY;IAkCf;;;;;;;OAOG;IACH,MAAM,IAAI,YAAY;IAyCtB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IA+BlD;;;;;;;;OAQG;IAEH,kBAAkB,CAAC,UAAU,EAAE,GAAG,GAAG;QACnC,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB;IAcD;;OAEG;IACH,cAAc,IAAI,MAAM;CAQzB;AAmCD;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAM7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,YAAY,CAEjE;AAGD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/v3/dist/audit/witness-chain.js

@@ -0,0 +1,269 @@
+/**
+ * Witness Chain - Cryptographic Audit Trail for QE Decisions
+ * ADR-070: Witness Chain Audit Compliance
+ *
+ * Implements a SHA-256 hash-chained append-only log for audit compliance.
+ * Every quality gate decision, pattern mutation, and dream cycle action
+ * is recorded with cryptographic integrity guarantees.
+ *
+ * The chain is tamper-evident: modifying any entry breaks the hash chain,
+ * detectable by verify().
+ */
+import { createHash } from 'crypto';
+import { getUnifiedMemory } from '../kernel/unified-memory.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Genesis previous hash: 64 zero characters */
+const GENESIS_PREV_HASH = '0'.repeat(64);
+// ============================================================================
+// WitnessChain Implementation
+// ============================================================================
+/**
+ * SHA-256 hash-chained append-only audit log.
+ *
+ * Each entry's prev_hash is the SHA-256 of the serialized previous entry,
+ * creating an immutable chain. Any modification to a past entry will cause
+ * verify() to detect the break.
+ */
+export class WitnessChain {
+    externalDb;
+    db = null;
+    initialized = false;
+    /**
+     * Create a WitnessChain instance.
+     *
+     * @param externalDb - Optional external database connection (for testing
+     *   with in-memory SQLite). When omitted, uses UnifiedMemoryManager.
+     */
+    constructor(externalDb) {
+        this.externalDb = externalDb;
+    }
+    /**
+     * Initialize the witness chain.
+     * Creates the witness_chain table if it does not exist.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.externalDb) {
+            this.db = this.externalDb;
+        }
+        else {
+            const unified = getUnifiedMemory();
+            await unified.initialize();
+            this.db = unified.getDatabase();
+        }
+        this.ensureTable();
+        this.initialized = true;
+    }
+    /**
+     * Create the witness_chain table (additive, does not touch other tables).
+     */
+    ensureTable() {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS witness_chain (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        prev_hash TEXT NOT NULL,
+        action_hash TEXT NOT NULL,
+        action_type TEXT NOT NULL,
+        action_data TEXT,
+        timestamp TEXT NOT NULL,
+        actor TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_witness_action_type ON witness_chain(action_type);
+      CREATE INDEX IF NOT EXISTS idx_witness_timestamp ON witness_chain(timestamp);
+    `);
+    }
+    /**
+     * Append a new entry to the witness chain.
+     *
+     * @param actionType - The type of action being recorded
+     * @param actionData - Arbitrary data describing the action
+     * @param actor - Who performed the action
+     * @returns The newly created WitnessEntry
+     */
+    append(actionType, actionData, actor) {
+        if (!this.db)
+            throw new Error('WitnessChain not initialized');
+        const timestamp = new Date().toISOString();
+        const actionDataStr = JSON.stringify(actionData);
+        const actionHash = sha256(actionDataStr);
+        // Get the previous entry's hash
+        const lastEntry = this.db
+            .prepare('SELECT * FROM witness_chain ORDER BY id DESC LIMIT 1')
+            .get();
+        const prevHash = lastEntry ? sha256(serializeEntry(lastEntry)) : GENESIS_PREV_HASH;
+        const result = this.db
+            .prepare(`INSERT INTO witness_chain (prev_hash, action_hash, action_type, action_data, timestamp, actor)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(prevHash, actionHash, actionType, actionDataStr, timestamp, actor);
+        const entry = {
+            id: result.lastInsertRowid,
+            prev_hash: prevHash,
+            action_hash: actionHash,
+            action_type: actionType,
+            action_data: actionDataStr,
+            timestamp,
+            actor,
+        };
+        return entry;
+    }
+    /**
+     * Verify the integrity of the entire witness chain.
+     *
+     * Walks through every entry in order and checks that each entry's
+     * prev_hash matches the SHA-256 of the previous entry's serialized form.
+     *
+     * @returns Verification result with validity status and break point
+     */
+    verify() {
+        if (!this.db)
+            throw new Error('WitnessChain not initialized');
+        const entries = this.db
+            .prepare('SELECT * FROM witness_chain ORDER BY id ASC')
+            .all();
+        if (entries.length === 0) {
+            return { valid: true, entriesChecked: 0 };
+        }
+        // Check genesis entry
+        if (entries[0].prev_hash !== GENESIS_PREV_HASH) {
+            return { valid: false, brokenAt: entries[0].id, entriesChecked: 1 };
+        }
+        // Check action_hash for first entry
+        if (entries[0].action_hash !== sha256(entries[0].action_data)) {
+            return { valid: false, brokenAt: entries[0].id, entriesChecked: 1 };
+        }
+        // Walk the chain
+        for (let i = 1; i < entries.length; i++) {
+            const current = entries[i];
+            const previous = entries[i - 1];
+            // Verify action_hash
+            if (current.action_hash !== sha256(current.action_data)) {
+                return { valid: false, brokenAt: current.id, entriesChecked: i + 1 };
+            }
+            // Verify prev_hash links to previous entry
+            const expectedPrevHash = sha256(serializeEntry(previous));
+            if (current.prev_hash !== expectedPrevHash) {
+                return { valid: false, brokenAt: current.id, entriesChecked: i + 1 };
+            }
+        }
+        return { valid: true, entriesChecked: entries.length };
+    }
+    /**
+     * Query witness chain entries with optional filters.
+     *
+     * @param filter - Optional filter criteria
+     * @returns Array of matching WitnessEntry records
+     */
+    getEntries(filter) {
+        if (!this.db)
+            throw new Error('WitnessChain not initialized');
+        const conditions = [];
+        const params = [];
+        if (filter?.action_type) {
+            conditions.push('action_type = ?');
+            params.push(filter.action_type);
+        }
+        if (filter?.since) {
+            conditions.push('timestamp >= ?');
+            params.push(filter.since);
+        }
+        if (filter?.until) {
+            conditions.push('timestamp <= ?');
+            params.push(filter.until);
+        }
+        if (filter?.actor) {
+            conditions.push('actor = ?');
+            params.push(filter.actor);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = filter?.limit ? `LIMIT ${filter.limit}` : '';
+        const offset = filter?.offset ? `OFFSET ${filter.offset}` : '';
+        const sql = `SELECT * FROM witness_chain ${where} ORDER BY id ASC ${limit} ${offset}`;
+        return this.db.prepare(sql).all(...params);
+    }
+    /**
+     * Cross-verify our SQLite witness chain against an RVF native witness.
+     *
+     * Calls rvfAdapter.status() to get witnessValid and witnessEntries,
+     * then compares with our own verify() result.
+     *
+     * @param rvfAdapter - An RvfNativeAdapter instance with a status() method
+     * @returns Cross-verification result from both chains
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    crossVerifyWithRvf(rvfAdapter) {
+        const sqliteResult = this.verify();
+        const rvfStatus = rvfAdapter.status();
+        const rvfValid = rvfStatus.witnessValid === true;
+        const rvfEntries = typeof rvfStatus.witnessEntries === 'number' ? rvfStatus.witnessEntries : 0;
+        return {
+            sqliteValid: sqliteResult.valid,
+            rvfValid,
+            rvfEntries,
+            bothValid: sqliteResult.valid && rvfValid,
+        };
+    }
+    /**
+     * Get the total number of entries in the chain.
+     */
+    getChainLength() {
+        if (!this.db)
+            throw new Error('WitnessChain not initialized');
+        const row = this.db
+            .prepare('SELECT COUNT(*) as count FROM witness_chain')
+            .get();
+        return row.count;
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Compute SHA-256 hex digest of a string.
+ */
+function sha256(data) {
+    return createHash('sha256').update(data, 'utf-8').digest('hex');
+}
+/**
+ * Serialize a WitnessEntry to a deterministic string for hashing.
+ * Uses a fixed field order to ensure consistency.
+ */
+function serializeEntry(entry) {
+    return JSON.stringify({
+        id: entry.id,
+        prev_hash: entry.prev_hash,
+        action_hash: entry.action_hash,
+        action_type: entry.action_type,
+        action_data: entry.action_data,
+        timestamp: entry.timestamp,
+        actor: entry.actor,
+    });
+}
+// ============================================================================
+// Singleton / Factory
+// ============================================================================
+let _instance = null;
+/**
+ * Get or create the singleton WitnessChain instance.
+ * Uses UnifiedMemoryManager for storage.
+ */
+export async function getWitnessChain() {
+    if (!_instance) {
+        _instance = new WitnessChain();
+        await _instance.initialize();
+    }
+    return _instance;
+}
+/**
+ * Create a WitnessChain with an external database (for testing).
+ */
+export function createWitnessChain(db) {
+    return new WitnessChain(db);
+}
+// Re-export for convenience
+export { GENESIS_PREV_HASH };
+//# sourceMappingURL=witness-chain.js.map

package/v3/dist/audit/witness-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-chain.js","sourceRoot":"","sources":["../../src/audit/witness-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAuE/D,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,gDAAgD;AAChD,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEzC,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAUM;IATrB,EAAE,GAAwB,IAAI,CAAC;IAC/B,WAAW,GAAG,KAAK,CAAC;IAE5B;;;;;OAKG;IACH,YAA6B,UAAyB;QAAzB,eAAU,GAAV,UAAU,CAAe;IAAG,CAAC;IAE1D;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACnC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,WAAW;QACjB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAE1D,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;KAYZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,UAA6B,EAC7B,UAAmC,EACnC,KAAa;QAEb,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAEzC,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CAAC,sDAAsD,CAAC;aAC/D,GAAG,EAA8B,CAAC;QAErC,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEnF,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,OAAO,CACN;mCAC2B,CAC5B;aACA,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1E,MAAM,KAAK,GAAiB;YAC1B,EAAE,EAAE,MAAM,CAAC,eAAyB;YACpC,SAAS,EAAE,QAAQ;YACnB,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,aAAa;YAC1B,SAAS;YACT,KAAK;SACN,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE;aACpB,OAAO,CAAC,6CAA6C,CAAC;aACtD,GAAG,EAAoB,CAAC;QAE3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC5C,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,iBAAiB,EAAE,CAAC;YAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QACtE,CAAC;QAED,oCAAoC;QACpC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QACtE,CAAC;QAED,iBAAiB;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhC,qBAAqB;YACrB,IAAI,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YACvE,CAAC;YAED,2CAA2C;YAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC1D,IAAI,OAAO,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;gBAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAsB;QAC/B,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,IAAI,MAAM,EAAE,WAAW,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/D,MAAM,GAAG,GAAG,+BAA+B,KAAK,oBAAoB,KAAK,IAAI,MAAM,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAmB,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACH,8DAA8D;IAC9D,kBAAkB,CAAC,UAAe;QAMhC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,KAAK,IAAI,CAAC;QACjD,MAAM,UAAU,GAAG,OAAO,SAAS,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/F,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,KAAK;YAC/B,QAAQ;YACR,UAAU;YACV,SAAS,EAAE,YAAY,CAAC,KAAK,IAAI,QAAQ;SAC1C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAE9D,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,6CAA6C,CAAC;aACtD,GAAG,EAAuB,CAAC;QAC9B,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAmB;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,IAAI,SAAS,GAAwB,IAAI,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAgB;IACjD,OAAO,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/v3/dist/cli/brain-commands.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Brain CLI Commands
+ *
+ * Exported functions for brain export/import that can be wired into
+ * the CLI command registry. These are thin wrappers around the core
+ * brain-exporter module, handling database connection lifecycle.
+ */
+import { type BrainExportManifest, type BrainExportOptions, type BrainImportOptions, type BrainImportResult } from '../integrations/ruvector/brain-exporter.js';
+/**
+ * Export the QE brain state from a database to a portable directory.
+ *
+ * Opens the database in read-only WAL mode to avoid write locks,
+ * then delegates to the core export function.
+ *
+ * @param dbPath - Path to the source SQLite database
+ * @param options - Export options including output path and filters
+ * @returns The export manifest with stats and checksum
+ */
+export declare function exportBrain(dbPath: string, options: BrainExportOptions): Promise<BrainExportManifest>;
+/**
+ * Import a brain export directory into a target database.
+ *
+ * Opens the database in read-write mode, validates the manifest
+ * checksum, then merges data using the specified strategy.
+ *
+ * @param dbPath - Path to the target SQLite database
+ * @param containerPath - Path to the brain export directory
+ * @param options - Import options including merge strategy
+ * @returns Import result with counts of imported, skipped, and conflicting records
+ */
+export declare function importBrain(dbPath: string, containerPath: string, options: BrainImportOptions): Promise<BrainImportResult>;
+/**
+ * Read the manifest from a brain export directory.
+ *
+ * @param containerPath - Path to the brain export directory
+ * @returns The export manifest
+ */
+export declare function brainInfo(containerPath: string): Promise<BrainExportManifest>;
+//# sourceMappingURL=brain-commands.d.ts.map

package/v3/dist/cli/brain-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-commands.d.ts","sourceRoot":"","sources":["../../src/cli/brain-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,4CAA4C,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/v3/dist/cli/brain-commands.js

@@ -0,0 +1,60 @@
+/**
+ * Brain CLI Commands
+ *
+ * Exported functions for brain export/import that can be wired into
+ * the CLI command registry. These are thin wrappers around the core
+ * brain-exporter module, handling database connection lifecycle.
+ */
+import Database from 'better-sqlite3';
+import { exportBrain as coreExportBrain, importBrain as coreImportBrain, brainInfo as coreBrainInfo, } from '../integrations/ruvector/brain-exporter.js';
+/**
+ * Export the QE brain state from a database to a portable directory.
+ *
+ * Opens the database in read-only WAL mode to avoid write locks,
+ * then delegates to the core export function.
+ *
+ * @param dbPath - Path to the source SQLite database
+ * @param options - Export options including output path and filters
+ * @returns The export manifest with stats and checksum
+ */
+export async function exportBrain(dbPath, options) {
+    const db = new Database(dbPath, { readonly: true });
+    db.pragma('journal_mode = WAL');
+    try {
+        return coreExportBrain(db, options, dbPath);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Import a brain export directory into a target database.
+ *
+ * Opens the database in read-write mode, validates the manifest
+ * checksum, then merges data using the specified strategy.
+ *
+ * @param dbPath - Path to the target SQLite database
+ * @param containerPath - Path to the brain export directory
+ * @param options - Import options including merge strategy
+ * @returns Import result with counts of imported, skipped, and conflicting records
+ */
+export async function importBrain(dbPath, containerPath, options) {
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    try {
+        return coreImportBrain(db, containerPath, options);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Read the manifest from a brain export directory.
+ *
+ * @param containerPath - Path to the brain export directory
+ * @returns The export manifest
+ */
+export async function brainInfo(containerPath) {
+    return coreBrainInfo(containerPath);
+}
+//# sourceMappingURL=brain-commands.js.map

package/v3/dist/cli/brain-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-commands.js","sourceRoot":"","sources":["../../src/cli/brain-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EACL,WAAW,IAAI,eAAe,EAC9B,WAAW,IAAI,eAAe,EAC9B,SAAS,IAAI,aAAa,GAK3B,MAAM,4CAA4C,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,OAA2B;IAE3B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,aAAqB,EACrB,OAA2B;IAE3B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,aAAqB;IAErB,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC"}