agentic-qe 3.14.4 → 3.14.5

package/dist/plugins/resolver.js

@@ -1,80 +1,188 @@
-/**
- * Agentic QE v3 - Plugin Dependency Resolver (IMP-09)
- *
- * DFS dependency resolution with cycle detection.
- * Given a set of plugin manifests, produces a topologically-sorted
- * load order where dependencies are loaded before dependents.
- */
-// ============================================================================
-// PluginResolver
-// ============================================================================
+import { AQE_VERSION, validVersion, validRange, compareVersions, newestVersionFirst, satisfiesVersion, } from './version-policy.js';
 export class PluginResolver {
-    /**
-     * Resolve plugin load order via DFS topological sort.
-     *
-     * @param manifests - All available plugin manifests
-     * @returns Ordered list of plugins safe to load sequentially
-     * @throws Error if a dependency cycle is detected
-     */
-    resolve(manifests) {
-        const byName = new Map();
-        for (const m of manifests) {
-            byName.set(m.name, m);
+    aqeVersion;
+    constructor(aqeVersion = AQE_VERSION) {
+        this.aqeVersion = aqeVersion;
+    }
+    resolve(manifests, roots) {
+        const groups = new Map();
+        const rejected = new Map();
+        for (const manifest of manifests) {
+            const candidates = groups.get(manifest.name) ?? [];
+            groups.set(manifest.name, candidates);
+            const error = this.validateVersions(manifest);
+            if (error)
+                rejected.set(manifest.name, [...(rejected.get(manifest.name) ?? []), error]);
+            else
+                candidates.push(manifest);
+        }
+        for (const candidates of groups.values()) {
+            candidates.sort((a, b) => newestVersionFirst(a.version, b.version));
         }
-        const ordered = [];
-        const visited = new Set();
-        const visiting = new Set(); // cycle detection (gray nodes)
         const missing = new Map();
-        const visit = (name, path) => {
-            if (visited.has(name))
-                return;
-            if (visiting.has(name)) {
-                const cycle = [...path.slice(path.indexOf(name)), name];
-                throw new Error(`Dependency cycle detected: ${cycle.join(' -> ')}`);
+        const errors = [];
+        const result = (ordered) => ({
+            ordered: ordered.map((manifest, order) => ({ manifest, order })), missing, errors,
+            selectedVersions: Object.fromEntries(ordered.map(m => [m.name, m.version])),
+            aqeVersion: this.aqeVersion,
+        });
+        const names = [...(roots ?? groups.keys())].sort();
+        const required = new Set(names);
+        const selected = new Map();
+        let attempts = 0;
+        let limited = false;
+        const compatible = () => {
+            for (const manifest of selected.values()) {
+                for (const [dep, range] of Object.entries(manifest.dependencies ?? {})) {
+                    const chosen = selected.get(dep);
+                    const candidates = chosen ? [chosen] : groups.get(dep) ?? [];
+                    if (!candidates.some(candidate => satisfiesVersion(candidate.version, range)))
+                        return false;
+                }
             }
-            const manifest = byName.get(name);
-            if (!manifest) {
-                // Missing dependency — record it but don't fail the entire resolution
-                return;
+            return true;
+        };
+        let cycle;
+        const findCycle = () => {
+            const visited = new Set();
+            const visiting = new Set();
+            const visit = (name, path) => {
+                if (visiting.has(name))
+                    return [...path.slice(path.indexOf(name)), name];
+                if (visited.has(name))
+                    return;
+                visiting.add(name);
+                for (const dependency of Object.keys(selected.get(name)?.dependencies ?? {})) {
+                    const found = visit(dependency, [...path, name]);
+                    if (found)
+                        return found;
+                }
+                visiting.delete(name);
+                visited.add(name);
+                return undefined;
+            };
+            for (const name of selected.keys()) {
+                const found = visit(name, []);
+                if (found)
+                    return found;
             }
-            visiting.add(name);
-            // Visit dependencies first
-            const deps = Object.keys(manifest.dependencies ?? {});
-            const missingDeps = [];
-            for (const dep of deps) {
-                if (!byName.has(dep)) {
-                    missingDeps.push(dep);
+            return undefined;
+        };
+        const choose = () => {
+            const pending = new Set(names);
+            for (const manifest of selected.values()) {
+                for (const name of Object.keys(manifest.dependencies ?? {}))
+                    pending.add(name);
+            }
+            const name = [...pending].sort().find(name => !selected.has(name));
+            if (!name) {
+                const found = findCycle();
+                if (found) {
+                    cycle = found;
+                    return false;
                 }
-                else {
-                    visit(dep, [...path, name]);
+                return true;
+            }
+            required.add(name);
+            for (const candidate of groups.get(name) ?? []) {
+                if (++attempts > 10_000) {
+                    limited = true;
+                    return false;
                 }
+                selected.set(name, candidate);
+                if (compatible() && choose())
+                    return true;
+                selected.delete(name);
+                if (limited)
+                    return false;
+            }
+            return false;
+        };
+        if (!choose()) {
+            if (cycle && !limited)
+                throw new Error(`Dependency cycle detected: ${cycle.join(' -> ')}`);
+            for (const name of required) {
+                if (!groups.get(name)?.length)
+                    errors.push(...(rejected.get(name) ?? []));
             }
-            if (missingDeps.length > 0) {
-                missing.set(name, missingDeps);
+            for (const [name, candidates] of groups) {
+                const absent = [...new Set(candidates.flatMap(m => Object.keys(m.dependencies ?? {})))].filter(dep => !groups.has(dep));
+                if (absent.length)
+                    missing.set(name, absent);
             }
+            errors.push({
+                code: limited ? 'RESOLUTION_LIMIT' : missing.size ? 'MISSING_DEPENDENCY' : 'UNSATISFIED_DEPENDENCY_RANGE',
+                plugin: names.join(', '),
+                message: limited ? 'Plugin dependency search exceeded 10000 candidates' : 'No cached plugin selection satisfies all dependency ranges',
+            });
+            return result([]);
+        }
+        const ordered = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (name, path) => {
+            if (visited.has(name))
+                return;
+            if (visiting.has(name))
+                throw new Error(`Dependency cycle detected: ${[...path.slice(path.indexOf(name)), name].join(' -> ')}`);
+            visiting.add(name);
+            const manifest = selected.get(name);
+            for (const dep of Object.keys(manifest.dependencies ?? {}))
+                visit(dep, [...path, name]);
             visiting.delete(name);
             visited.add(name);
             ordered.push(manifest);
         };
-        // Visit all plugins
-        for (const m of manifests) {
-            visit(m.name, []);
+        for (const name of [...selected.keys()].sort())
+            visit(name, []);
+        return result(ordered);
+    }
+    /** Startup is best-effort: retain admitted roots when another root fails. */
+    resolveAvailable(manifests) {
+        const accepted = [];
+        let result = this.resolve(manifests, []);
+        const errors = [];
+        const missing = new Map();
+        for (const name of [...new Set(manifests.map(m => m.name))].sort()) {
+            try {
+                // Re-solve together so shared dependency versions remain compatible.
+                // A failed candidate cannot invalidate the last successful selection.
+                const candidate = this.resolve(manifests, [...accepted, name]);
+                if (candidate.errors.length) {
+                    errors.push(...candidate.errors.map(error => ({ ...error, plugin: name })));
+                    for (const [plugin, dependencies] of candidate.missing)
+                        missing.set(plugin, dependencies);
+                    continue;
+                }
+                accepted.push(name);
+                result = candidate;
+            }
+            catch (error) {
+                errors.push({ code: 'DEPENDENCY_CYCLE', plugin: name,
+                    message: error instanceof Error ? error.message : String(error) });
+            }
         }
-        return {
-            ordered: ordered.map((manifest, index) => ({ manifest, order: index })),
-            missing,
-        };
+        return { ...result, errors, missing };
     }
-    /**
-     * Check if a specific plugin can be loaded given the currently loaded set.
-     */
+    /** Version-constrained dependencies require versions, not a legacy name-only Set. */
     canLoad(manifest, loaded) {
-        const deps = Object.keys(manifest.dependencies ?? {});
-        const missingDeps = deps.filter(d => !loaded.has(d));
-        return {
-            canLoad: missingDeps.length === 0,
-            missingDeps,
-        };
+        const missingDeps = Object.entries(manifest.dependencies ?? {}).filter(([name, range]) => {
+            const version = loaded instanceof Set ? undefined : loaded.get(name);
+            return !version || !validRange(range) || !satisfiesVersion(version, range);
+        }).map(([name]) => name);
+        return { canLoad: !this.validateVersions(manifest) && missingDeps.length === 0, missingDeps };
+    }
+    validateVersions(manifest) {
+        if (!validVersion(manifest.version))
+            return { code: 'INVALID_PLUGIN_VERSION', plugin: manifest.name, message: 'Invalid plugin version' };
+        for (const range of Object.values(manifest.dependencies ?? {})) {
+            if (!validRange(range))
+                return { code: 'INVALID_DEPENDENCY_RANGE', plugin: manifest.name, message: 'Invalid dependency range' };
+        }
+        if (manifest.minAqeVersion && (!validVersion(manifest.minAqeVersion) || !validVersion(this.aqeVersion) || compareVersions(this.aqeVersion, manifest.minAqeVersion) < 0)) {
+            return { code: 'AQE_VERSION_INCOMPATIBLE', plugin: manifest.name, message: `Requires AQE ${manifest.minAqeVersion}; running ${this.aqeVersion}` };
+        }
+        return undefined;
     }
 }
 //# sourceMappingURL=resolver.js.map

package/dist/plugins/version-policy.d.ts

@@ -0,0 +1,13 @@
+export declare const AQE_VERSION: string;
+export declare const validVersion: (value: unknown) => boolean;
+export declare const validRange: (value: string) => boolean;
+export declare const satisfiesVersion: (version: string, range: string) => boolean;
+export declare const compareVersions: (a: string, b: string) => number;
+/** Equal-precedence build metadata has a stable lexical tie-break, not higher precedence. */
+export declare const newestVersionFirst: (a: string, b: string) => number;
+export interface PluginVersionFailure {
+    code: 'INVALID_PLUGIN_VERSION' | 'INVALID_DEPENDENCY_RANGE' | 'MISSING_DEPENDENCY' | 'DEPENDENCY_CYCLE' | 'UNSATISFIED_DEPENDENCY_RANGE' | 'AQE_VERSION_INCOMPATIBLE' | 'RESOLUTION_LIMIT';
+    plugin: string;
+    message: string;
+}
+//# sourceMappingURL=version-policy.d.ts.map

package/dist/plugins/version-policy.js

@@ -0,0 +1,18 @@
+/** npm SemVer is the single oracle for plugin versions and ranges. */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const semver = require('semver');
+export const AQE_VERSION = typeof __CLI_VERSION__ !== 'undefined' ? __CLI_VERSION__
+    : typeof __MCP_VERSION__ !== 'undefined' ? __MCP_VERSION__
+        : require('../../package.json').version;
+// semver.valid drops build metadata; retain valid metadata but reject normalized
+// prefixes/whitespace so cache directory names remain canonical.
+// Cached manifests are untrusted JSON (older releases admitted a non-string
+// minAqeVersion), so a non-string must be rejected here rather than throw.
+export const validVersion = (value) => typeof value === 'string' && semver.valid(value) === value.split('+')[0];
+export const validRange = (value) => semver.validRange(value) !== null;
+export const satisfiesVersion = (version, range) => semver.satisfies(version, range);
+export const compareVersions = (a, b) => semver.compare(a, b);
+/** Equal-precedence build metadata has a stable lexical tie-break, not higher precedence. */
+export const newestVersionFirst = (a, b) => compareVersions(b, a) || a.localeCompare(b);
+//# sourceMappingURL=version-policy.js.map

package/dist/shared/types/index.d.ts

@@ -11,6 +11,12 @@ export interface AgentId {
 }
 export type DomainName = 'test-generation' | 'test-execution' | 'coverage-analysis' | 'quality-assessment' | 'defect-intelligence' | 'requirements-validation' | 'code-intelligence' | 'security-compliance' | 'contract-testing' | 'visual-accessibility' | 'chaos-resilience' | 'learning-optimization' | 'enterprise-integration' | 'coordination';
 export declare const ALL_DOMAINS: readonly DomainName[];
+/**
+ * Type guard for user-supplied domain names (CLI flags, MCP arguments).
+ * Validate at the boundary so an unknown domain is rejected instead of being
+ * accepted as work no domain will ever run (#734).
+ */
+export declare function isDomainName(value: unknown): value is DomainName;
 export interface DomainEvent<T = unknown> {
     readonly id: string;
     readonly type: string;

package/dist/shared/types/index.js

@@ -18,6 +18,14 @@ export const ALL_DOMAINS = [
     'enterprise-integration',
     'coordination',
 ];
+/**
+ * Type guard for user-supplied domain names (CLI flags, MCP arguments).
+ * Validate at the boundary so an unknown domain is rejected instead of being
+ * accepted as work no domain will ever run (#734).
+ */
+export function isDomainName(value) {
+    return typeof value === 'string' && ALL_DOMAINS.includes(value);
+}
 export function ok(value) {
     return { success: true, value };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-qe",
-  "version": "3.14.4",
+  "version": "3.14.5",
   "description": "Agentic Quality Engineering V3 - Domain-Driven Design Architecture with 13 Bounded Contexts, O(log n) coverage analysis, ReasoningBank learning, 60 specialized QE agents, mathematical Coherence verification, deep Claude Flow integration",
   "type": "module",
   "main": "./dist/index.js",
@@ -193,6 +193,7 @@
     "pg": "^8.17.2",
     "prime-radiant-advanced-wasm": "^0.1.3",
     "secure-json-parse": "^4.1.0",
+    "semver": "^7.8.5",
     "typescript": "^5.9.3",
     "uuid": "^14.0.0",
     "vibium": "^0.1.2",

package/dist/cli/chunks/adapter-TNNNJRDG.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
-import{a,b,c}from"./chunk-XJ7QNVI5.js";import"./chunk-CLTMDCSE.js";import"./chunk-M4WJKGVK.js";import"./chunk-DHJPWQBR.js";import"./chunk-G6T45OIC.js";import"./chunk-TT23RRB7.js";export{a as AgentBoosterAdapter,b as createAgentBoosterAdapter,c as createAgentBoosterAdapterSync};

package/dist/cli/chunks/aqe-learning-engine-5ZRMYJLB.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
-import{a,b,c,d,e,f}from"./chunk-CSU5NYOX.js";import"./chunk-J6GNQS62.js";import"./chunk-CIKSHTEQ.js";import"./chunk-5Z6XZV7K.js";import"./chunk-IFCLB7FJ.js";import"./chunk-4OYFXLBK.js";import"./chunk-ZBAKA4YB.js";import"./chunk-T6BVLVI5.js";import"./chunk-ZJ26AQA5.js";import"./chunk-OBAP2TXZ.js";import"./chunk-IPR4QP3H.js";import"./chunk-DEYLEDJN.js";import"./chunk-TPGED2IF.js";import"./chunk-MNW6QGNJ.js";import"./chunk-MCUJEZT6.js";import"./chunk-NDPFGIMJ.js";import"./chunk-55RWDRJD.js";import"./chunk-R4VL6E65.js";import"./chunk-RJCYCLZV.js";import"./chunk-NA7B2QYB.js";import"./chunk-Y3MW3YBC.js";import"./chunk-PEPFCPES.js";import"./chunk-DHJPWQBR.js";import"./chunk-BOZZYWCR.js";import"./chunk-TDZ53WO2.js";import"./chunk-QGIU2WRL.js";import"./chunk-STM3UDNO.js";import"./chunk-G6T45OIC.js";import"./chunk-SRKETSFF.js";import"./chunk-BGE6FOLM.js";import"./chunk-5YPYDPBJ.js";import"./chunk-HDSAM2RE.js";import"./chunk-KCZR45PA.js";import"./chunk-BFP7KO7P.js";import"./chunk-ODKLFVYC.js";import"./chunk-VD6QRULW.js";import"./chunk-KHFNNVJA.js";import"./chunk-CNG6GQEZ.js";import"./chunk-TT23RRB7.js";export{b as AQELearningEngine,a as DEFAULT_ENGINE_CONFIG,c as DEFAULT_META_LEARNING_CONFIG,d as MetaLearningEngine,e as createAQELearningEngine,f as createDefaultLearningEngine};

package/dist/cli/chunks/base-KWZHOPSH.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
-import{a,b,c,d,e,f,g,h,i,j,k,l}from"./chunk-W7BWUTVV.js";import"./chunk-6TPKK7LD.js";import"./chunk-55RWDRJD.js";import"./chunk-R4VL6E65.js";import"./chunk-RJCYCLZV.js";import"./chunk-NA7B2QYB.js";import"./chunk-Y3MW3YBC.js";import"./chunk-PEPFCPES.js";import"./chunk-DHJPWQBR.js";import"./chunk-G6T45OIC.js";import"./chunk-SRKETSFF.js";import"./chunk-AIHDEEJO.js";import"./chunk-BGE6FOLM.js";import"./chunk-5YPYDPBJ.js";import"./chunk-HDSAM2RE.js";import"./chunk-KCZR45PA.js";import"./chunk-BFP7KO7P.js";import"./chunk-ODKLFVYC.js";import"./chunk-VD6QRULW.js";import"./chunk-KHFNNVJA.js";import"./chunk-CNG6GQEZ.js";import"./chunk-TT23RRB7.js";export{l as MCPToolBase,k as defaultToolLogger,j as getKernel,i as getLLMRouter,e as getMemoryBackend,g as getSharedLLMRouter,c as getSharedMemoryBackend,a as isMemoryOnlyMode,b as registerRvfResetFn,h as resetSharedLLMRouter,d as resetSharedMemoryBackend,f as setSharedLLMRouter};

package/dist/cli/chunks/brain-handler-ET6YAP4B.js

@@ -1,90 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
-import{a as L,b as K,c as z,d as x,e as oe,f as J,g as G,h as N,i as Re,j as ae,k as Q,l as Se,m as U,n as ie,o as xe,p as P,q as X,r as Y,s as Z,t as ee}from"./chunk-UGVHCMUN.js";import{h as ve}from"./chunk-DEYLEDJN.js";import{b as we}from"./chunk-TPGED2IF.js";import"./chunk-55RWDRJD.js";import"./chunk-R4VL6E65.js";import"./chunk-RJCYCLZV.js";import"./chunk-NA7B2QYB.js";import"./chunk-Y3MW3YBC.js";import"./chunk-PEPFCPES.js";import{b as A,d as re}from"./chunk-DHJPWQBR.js";import{a as be,b as he,c as H,d as V,f as Ye}from"./chunk-TDZ53WO2.js";import"./chunk-G6T45OIC.js";import{a as F,b as Xe}from"./chunk-BGE6FOLM.js";import"./chunk-5YPYDPBJ.js";import"./chunk-HDSAM2RE.js";import"./chunk-KCZR45PA.js";import"./chunk-BFP7KO7P.js";import"./chunk-ODKLFVYC.js";import"./chunk-VD6QRULW.js";import"./chunk-KHFNNVJA.js";import"./chunk-CNG6GQEZ.js";import"./chunk-TT23RRB7.js";import D from"path";import o from"chalk";Xe();re();import{existsSync as ne,mkdirSync as Ze,writeFileSync as en,readFileSync as se}from"fs";import{join as k,resolve as le}from"path";var nn={rl_q_values:"includeQValues",dream_insights:"includeDreamInsights",dream_cycles:"includeDreamInsights",witness_chain:"includeWitnessChain",vectors:"includeVectors"};function tn(e,n){let r=nn[e.tableName];return!(r&&n[r]===!1)}var rn=1e4;function on(e,n,r,t){if(!tn(n,r))return ie(k(t,n.fileName),[]),{count:0,rows:[]};let[a,i]=n.domainColumn?U(r.domains,n.domainColumn):[void 0,[]];if(r.domains&&r.domains.length>0&&!n.domainColumn){let s=r.domains.map(()=>"?").join(","),f=`manifest_id IN (SELECT id FROM learning_evidence_manifests WHERE task_family IN (${s}))`;["learning_evidence_segments","learning_segment_edges","learning_evidence_admissions"].includes(n.tableName)?(a=f,i=[...r.domains]):["pattern_manifest_lineage","pattern_segment_lineage"].includes(n.tableName)&&(a=`${f} AND pattern_id IN (SELECT id FROM qe_patterns WHERE qe_domain IN (${s}))`,i=[...r.domains,...r.domains])}if(ae(e,n.tableName,a,i)>=rn){let s=n.blobColumns,f=s&&s.length>0?p=>J(p,s):void 0;return{count:xe(k(t,n.fileName),Se(e,n.tableName,a,i),f)}}let l=Q(e,n.tableName,a,i);return n.blobColumns&&n.blobColumns.length>0&&(l=l.map(s=>J(s,n.blobColumns))),ie(k(t,n.fileName),l),{count:l.length,rows:l}}function Ce(e){let n=[];for(let r of x){let t=k(e,r.fileName);ne(t)?n.push(N(se(t,"utf-8"))):n.push(N(""))}return N(n.join(":"))}function _e(e,n,r="memory.db"){let t=le(n.outputPath);ne(t)||Ze(t,{recursive:!0});let a=0,i={},c=new Set;for(let m of x){let p=on(e,m,n,t);if(i[m.tableName]=p.count,a+=p.count,m.tableName==="qe_patterns"){if(p.rows)for(let g of p.rows)g.qe_domain&&c.add(g.qe_domain);else if(p.count>0){let[g,C]=m.domainColumn?U(n.domains,m.domainColumn):[void 0,[]],v=`SELECT DISTINCT qe_domain FROM qe_patterns ${g?`WHERE ${g} AND qe_domain IS NOT NULL`:"WHERE qe_domain IS NOT NULL"}`;try{let u=e.prepare(v).all(...C||[]);for(let h of u)c.add(h.qe_domain)}catch{}}}}let l=n.includeVectors!==!1?ae(e,"vectors"):0,s=Ce(t),f={version:"3.0",exportedAt:new Date().toISOString(),sourceDb:r,stats:{patternCount:i.qe_patterns||0,vectorCount:l,qValueCount:i.rl_q_values||0,dreamInsightCount:i.dream_insights||0,witnessChainLength:i.witness_chain||0,totalRecords:a},domains:[...c].sort(),checksum:s,tableRecordCounts:i};return en(k(t,"manifest.json"),JSON.stringify(f,null,2),"utf-8"),f}var an=new Set(["qe_patterns","rl_q_values","dream_insights","witness_chain"]);function sn(e){return e==="1.0"?x.filter(n=>an.has(n.tableName)):e==="3.0"?x:(console.warn(`[brain-import] Unknown manifest version '${e}'. Attempting full import \u2014 some files may be missing.`),x)}function Ee(e,n,r){let t=le(n),a=k(t,"manifest.json");if(!ne(a))throw new Error(`Manifest not found at ${a}`);let i=A(se(a,"utf-8")),c=Ce(t);if(c!==i.checksum)throw new Error(`Checksum mismatch: expected ${i.checksum}, got ${c}. The export may have been tampered with or corrupted.`);let l=sn(i.version),s=0,f=0,m=0,p=()=>{let g=new Map,C=new Map;for(let d of l){let v=k(t,d.fileName),u=P(v,A);d.blobColumns&&d.blobColumns.length>0&&(u=u.map(h=>G(h,d.blobColumns)));for(let h of u){let R=X(h,g),E;if(d.dedupColumns&&d.dedupColumns.length>0)E=Z(e,d.tableName,R,d.dedupColumns,d.preserveId);else{let $=L[d.tableName]||"id",B=z[d.tableName],O=K[d.tableName];E=Y(e,d.tableName,R,$,r.mergeStrategy,B,O,g,C,h.pattern_id)}s+=E.imported,f+=E.skipped,m+=E.conflicts}}};return ee(e,r.dryRun??!1,p),{imported:s,skipped:f,conflicts:m}}function Be(e){let n=le(e),r=k(n,"manifest.json");if(!ne(r))throw new Error(`Manifest not found at ${r}`);return A(se(r,"utf-8"))}Ye();import{existsSync as j,readdirSync as ln,renameSync as cn,statSync as dn,unlinkSync as ce,writeFileSync as fn}from"fs";import{basename as mn,dirname as un,join as pn,resolve as te}from"path";var Oe=["",".idmap.json",".manifest.json"],gn=[...Oe,".lock"];function Ie(e){for(let n of gn)try{let r=`${e}${n}`;j(r)&&ce(r)}catch{}}function yn(e){let n=un(e),r=`${mn(e)}.tmp.`,t;try{t=ln(n)}catch{return}for(let a of t){if(!a.startsWith(r))continue;let i=Number.parseInt(a.slice(r.length).split(".")[0],10);if(!(!Number.isInteger(i)||i<=0)&&!(i!==process.pid&&bn(i)))try{ce(pn(n,a))}catch{}}}function bn(e){try{return process.kill(e,0),!0}catch(n){return n.code==="EPERM"}}function Ae(e,n,r="memory.db"){if(!V())throw new Error("@ruvector/rvf-node is not available. Install it or use --format jsonl instead.");let t=te(n.outputPath),a=n.dimension??384,i=`${t}.tmp.${process.pid}`;yn(t),Ie(i);let c=be(i,a),l=!1;try{let s={},f=new Set,m=0;for(let y of x){let[S,w]=y.domainColumn?U(n.domains,y.domainColumn):[void 0,[]],_=Q(e,y.tableName,S,w);if(n.domains&&n.domains.length>0){let b=new Set((s.learning_evidence_manifests??[]).map(I=>I.id)),q=new Set((s.qe_patterns??[]).map(I=>I.id));["learning_evidence_segments","learning_segment_edges","learning_evidence_admissions"].includes(y.tableName)?_=_.filter(I=>b.has(I.manifest_id)):y.tableName==="pattern_manifest_lineage"?_=_.filter(I=>{let T=I;return b.has(T.manifest_id)&&q.has(T.pattern_id)}):y.tableName==="pattern_segment_lineage"&&(_=_.filter(I=>{let T=I;return b.has(T.manifest_id)&&q.has(T.pattern_id)}))}if(y.tableName==="qe_patterns")for(let b of _)b.qe_domain&&f.add(b.qe_domain);let M=oe[y.tableName];M&&M.length>0&&(_=_.map(b=>J(b,M))),s[y.tableName]=_,m+=_.length}let p=0,g=[];if(Re(e,"qe_pattern_embeddings")){let y=e.prepare("PRAGMA table_info('qe_pattern_embeddings')").all().some(w=>w.name==="space_id"),S=e.prepare(`SELECT pattern_id, embedding, dimension, ${y?"space_id":"NULL"} AS space_id
-           FROM qe_pattern_embeddings`).all();for(let w of S)w.embedding&&w.dimension===a&&w.space_id&&g.push({id:`pe:${w.pattern_id}`,vector:new Float32Array(w.embedding.buffer,w.embedding.byteOffset,a),metadata:{tableName:"qe_pattern_embeddings",spaceId:w.space_id}})}g.length>0&&(p=c.ingest(g).accepted);let C={version:"3.0",format:"rvf",exportedAt:new Date().toISOString(),sourceDb:r,domains:[...f].sort(),tables:s},d=JSON.stringify(C),v=N(d),u=Buffer.from(d);c.embedKernel(u);let h=n.sign?c.sign(u)??void 0:void 0,R=h?n.signerKeyId??"default":void 0,E=c.fileId(),$=E?{fileId:E,parentId:c.parentId(),lineageDepth:c.lineageDepth()}:void 0,B=c.status(),O={version:"3.0",format:"rvf",exportedAt:C.exportedAt,sourceDb:r,stats:{patternCount:(s.qe_patterns||[]).length,embeddingCount:p,qValueCount:(s.rl_q_values||[]).length,dreamInsightCount:(s.dream_insights||[]).length,witnessChainLength:(s.witness_chain||[]).length,totalRecords:m,tableCounts:Object.fromEntries(x.map(({tableName:y})=>[y,s[y]?.length??0]))},domains:C.domains,checksum:v,rvfStatus:{totalVectors:B.totalVectors,totalSegments:B.totalSegments,fileSizeBytes:B.fileSizeBytes},...h?{signature:h,signerKeyId:R}:{},...$?{lineage:$}:{}};if(h)try{c.freeze()}catch{}if(fn(`${i}.manifest.json`,JSON.stringify(O,null,2),"utf-8"),c.close(),l=!0,j(t)&&!n.allowOverwriteRicher){let y;try{y=W(t)}catch(S){if(hn(t)||!wn(S)){let w=S instanceof Error?S.message:String(S);throw new Error(`RVF_MIRROR_INSPECTION_AMBIGUOUS: the existing mirror is readable but its richness could not be established (${w}). Preserve/import it before retrying, or repeat with --force-overwrite-richer after preserving a backup.`)}}if(y){let S=y.stats.tableCounts,w=O.stats.tableCounts,_=x.map(({tableName:b})=>b).filter(b=>!S||!Number.isSafeInteger(S[b]));if(_.length>0)throw new Error(`RVF_MIRROR_INSPECTION_AMBIGUOUS: existing mirror lacks trustworthy counts for ${_.join(", ")}. Preserve/import it before retrying, or repeat with --force-overwrite-richer after preserving a backup.`);let M=x.map(({tableName:b})=>({tableName:b,existing:S[b],candidate:w[b]})).filter(({existing:b,candidate:q})=>b>q);if(M.length>0){let b=M.map(({tableName:q,existing:I,candidate:T})=>`${q} ${I} -> ${T}`).join(", ");throw new Error(`RVF_MIRROR_RICHER: refusing to replace richer mirrored tables: ${b}. Restore/import the mirror first, or repeat with --force-overwrite-richer after preserving a backup.`)}}}for(let y of[...Oe].reverse()){let S=`${i}${y}`,w=`${t}${y}`;j(S)?cn(S,w):j(w)&&ce(w)}return O}catch(s){if(!l)try{c.close()}catch{}throw Ie(i),s}}function hn(e){let n;try{return n=H(te(e)),!!n.extractKernel()?.image}catch{return!1}finally{try{n?.close()}catch{}}}function wn(e){let n=e instanceof Error?e.message:String(e);return/ManifestNotFound|InvalidMagic|ChecksumMismatch|CorruptStore/i.test(n)}var vn={patterns:"qe_patterns",qValues:"rl_q_values",dreamInsights:"dream_insights",witnessChain:"witness_chain"};function Ne(e,n,r){if(!V())throw new Error("@ruvector/rvf-node is not available. Install it or use JSONL format.");let t=te(n);if(!j(t))throw new Error(`RVF file not found: ${t}`);let a=r.dryRun?H(t):he(t);try{let i=a.verifyWitness();if(!i.valid&&(i.totalEntries>0||i.errors.length>0)){let d=i.errors.length>0?i.errors.join("; "):"unknown integrity error";throw new Error(`RVF witness verification failed: ${d}`)}let c=a.extractKernel();if(!c||!c.image)throw new Error("No brain data found in RVF file (missing kernel segment)");let l;try{l=JSON.parse(c.image.toString("utf-8"))}catch(d){throw new Error(`Failed to parse brain kernel data as JSON: ${d instanceof Error?d.message:d}`)}let s=0,f=0,m=0,p=0,g={};if(l.tables)Object.assign(g,l.tables);else for(let[d,v]of Object.entries(vn)){let u=l[d];Array.isArray(u)&&(g[v]=u)}let C=()=>{let d=new Map,v=new Map;for(let u of x){let h=g[u.tableName];if(!h||!Array.isArray(h))continue;let R=oe[u.tableName];R&&R.length>0&&(h=h.map(E=>G(E,R)));for(let E of h){let $=X(E,d),B;if(u.dedupColumns&&u.dedupColumns.length>0)B=Z(e,u.tableName,$,u.dedupColumns,u.preserveId);else{let O=L[u.tableName]||"id",y=z[u.tableName],S=K[u.tableName];B=Y(e,u.tableName,$,O,r.mergeStrategy,y,S,d,v,E.pattern_id)}if(B.imported)for(let O of R??[])$[O]instanceof Buffer&&p++;s+=B.imported,f+=B.skipped,m+=B.conflicts}}};if(ee(e,r.dryRun??!1,C),!r.dryRun&&m>0)try{a.compact()}catch{}return{imported:s,skipped:f,conflicts:m,embeddingsRestored:p}}finally{a.close()}}function W(e){if(!V())throw new Error("@ruvector/rvf-node is not available.");let n=te(e);if(!j(n))throw new Error(`RVF file not found: ${n}`);let r=H(n);try{let t=r.extractKernel();if(!t||!t.image)throw new Error("No brain data found in RVF file");let a=t.image.toString("utf-8"),i;try{i=JSON.parse(a)}catch(d){throw new Error(`Failed to parse brain kernel data as JSON: ${d instanceof Error?d.message:d}`)}let c=r.status(),l=dn(n).size,s=i.tables,f=s?s.qe_patterns?.length??0:i.patterns?.length??0,m=s?s.rl_q_values?.length??0:i.qValues?.length??0,p=s?s.dream_insights?.length??0:i.dreamInsights?.length??0,g=s?s.witness_chain?.length??0:i.witnessChain?.length??0,C=s&&typeof s=="object"&&!Array.isArray(s)?Object.fromEntries(Object.entries(s).filter(d=>Array.isArray(d[1])).map(([d,v])=>[d,v.length])):void 0;return{version:"3.0",format:"rvf",exportedAt:i.exportedAt??"unknown",sourceDb:i.sourceDb??"unknown",stats:{patternCount:f,embeddingCount:c.totalVectors,qValueCount:m,dreamInsightCount:p,witnessChainLength:g,...C?{tableCounts:C}:{}},domains:i.domains??[],checksum:N(a),rvfStatus:{totalVectors:c.totalVectors,totalSegments:c.totalSegments,fileSizeBytes:l}}}finally{r.close()}}function de(){return V()}re();import{existsSync as me,readFileSync as Rn,statSync as Sn}from"fs";import{join as fe,resolve as $e}from"path";function Me(e,n,r={}){let t=$e(e),a=$e(n),i=ke(t),c=ke(a),l=De(t,i),s=De(a,c),f=i==="jsonl"&&c==="jsonl",m=_n({pathA:t,pathB:a,manifestA:l,manifestB:s,recordLevel:f,tableFilter:r.tableFilter,maxIdsPerBucket:r.maxIdsPerBucket??500}),p=new Set(l.domains),g=new Set(s.domains),C=l.domains.filter(R=>!g.has(R)),d=s.domains.filter(R=>!p.has(R)),v=l.checksum===s.checksum,u=l.version===s.version,h=v&&u&&m.every(R=>R.delta===0&&(R.added?.length??0)===0&&(R.removed?.length??0)===0&&(R.changed?.length??0)===0);return{pathA:t,pathB:a,formatA:i,formatB:c,manifestA:l,manifestB:s,checksumMatch:v,versionMatch:u,identical:h,recordLevel:f,tableDiffs:m,domainsOnlyInA:C,domainsOnlyInB:d}}function ke(e){if(!me(e))throw new Error(`Path not found: ${e}`);if(e.endsWith(".rvf"))return"rvf";if(Sn(e).isFile())throw new Error(`Unsupported brain export: ${e} (expected a .rvf file or a JSONL directory)`);return"jsonl"}function De(e,n){return n==="rvf"?Cn(e):xn(e)}function xn(e){let n=fe(e,"manifest.json");if(!me(n))throw new Error(`Manifest not found at ${n}`);let r=A(Rn(n,"utf-8"));return qe(r,"jsonl")}function Cn(e){let n=W(e);return qe(n,"rvf")}function qe(e,n){return{format:n,version:e.version??"unknown",exportedAt:e.exportedAt??"unknown",sourceDb:e.sourceDb??"unknown",checksum:e.checksum??"",totalRecords:e.stats?.totalRecords??0,domains:e.domains??[],tableRecordCounts:e.tableRecordCounts??{}}}function _n(e){let n=e.tableFilter?x.filter(t=>t.tableName===e.tableFilter):x;if(e.tableFilter&&n.length===0)throw new Error(`Unknown table: ${e.tableFilter}`);let r=[];for(let t of n){let a=e.manifestA.tableRecordCounts[t.tableName]??0,i=e.manifestB.tableRecordCounts[t.tableName]??0,c=i-a,l,s,f;if(e.recordLevel&&En(t)){let m=Bn(fe(e.pathA,t.fileName),fe(e.pathB,t.fileName),t,e.maxIdsPerBucket);l=m.added,s=m.removed,f=m.changed}r.push({tableName:t.tableName,countA:a,countB:i,delta:c,...l!==void 0?{added:l}:{},...s!==void 0?{removed:s}:{},...f!==void 0?{changed:f}:{}})}return r}function En(e){return!0}function Bn(e,n,r,t){let a=Te(e,r),i=Te(n,r),c=[],l=[],s=[];for(let[f,m]of a){let p=i.get(f);if(p===void 0)l.length<t&&l.push(f);else if(p!==m){if(r.dedupColumns&&r.dedupColumns.length>0)continue;s.length<t&&s.push(f)}}for(let f of i.keys())a.has(f)||c.length<t&&c.push(f);return c.sort(),l.sort(),s.sort(),{added:c,removed:l,changed:s}}function Te(e,n){let r=new Map;if(!me(e))return r;let t=P(e,A);for(let a of t){let i=In(a,n);if(i===void 0)continue;let c=On(a);r.set(i,An(c))}return r}function In(e,n){if(n.dedupColumns&&n.dedupColumns.length>0){let a=[];for(let i of n.dedupColumns){let c=e[i];if(c==null)return;a.push(String(c))}return a.join("
")}let r=L[n.tableName]??"id",t=e[r];if(t!=null)return String(t)}function On(e){let n=Object.keys(e).sort(),r={};for(let t of n)r[t]=e[t];return JSON.stringify(r)}function An(e){return N(e)}re();import{existsSync as ue,statSync as Nn}from"fs";import{join as Fe,resolve as $n}from"path";var kn=20,Dn="qe_patterns";function Le(e,n={}){let r=$n(e);qn(r);let t=n.table??Dn,a=x.find(u=>u.tableName===t);if(!a)throw new Error(`Unknown table: ${t}`);let i=Fe(r,a.fileName);if(!ue(i))throw new Error(`Table file not found: ${a.fileName} (expected in ${r}). Was this export generated with --format jsonl?`);let c=P(i,A),l=a.domainColumn,s=Math.max(1,n.limit??kn),f=n.query?n.query.toLowerCase():void 0,m=n.domains&&n.domains.length>0?new Set(n.domains):void 0,p=n.since,g=n.until,C=n.patternType,d=0,v=[];for(let u of c)Tn(u,{domainColumn:l,domains:m,patternType:C,since:p,until:g,queryLower:f})&&(d++,v.length<s&&v.push(Mn(u,a.tableName,l)));return{table:t,inputPath:r,totalScanned:c.length,totalMatched:d,limit:s,hits:v,truncated:d>s}}function Tn(e,n){if(n.domains){if(!n.domainColumn)return!1;let r=e[n.domainColumn];if(typeof r!="string"||!n.domains.has(r))return!1}if(n.patternType!==void 0&&e.pattern_type!==n.patternType)return!1;if(n.since!==void 0||n.until!==void 0){let r=Pe(e);if(r===void 0||n.since!==void 0&&r<n.since||n.until!==void 0&&r>n.until)return!1}if(n.queryLower!==void 0){let r=typeof e.name=="string"?e.name.toLowerCase():"",t=typeof e.description=="string"?e.description.toLowerCase():"";if(!r.includes(n.queryLower)&&!t.includes(n.queryLower))return!1}return!0}function Pe(e){for(let n of["updated_at","created_at","timestamp"]){let r=e[n];if(typeof r=="string"&&r.length>0)return r}}function Mn(e,n,r){let t=(typeof e.id=="string"||typeof e.id=="number"?String(e.id):void 0)??`${n}:?`,a={name:typeof e.name=="string"?e.name:void 0,description:typeof e.description=="string"?e.description:void 0,domain:r&&typeof e[r]=="string"?e[r]:void 0,patternType:typeof e.pattern_type=="string"?e.pattern_type:void 0,confidence:typeof e.confidence=="number"?e.confidence:void 0,updatedAt:Pe(e)};return{id:t,display:a,row:e}}function qn(e){if(!ue(e))throw new Error(`Path not found: ${e}`);if(Nn(e).isFile())throw e.endsWith(".rvf")?new Error("Brain search does not support RVF exports. Re-export with --format jsonl, or use `aqe brain info` for RVF summaries."):new Error(`Unsupported brain export: ${e} (expected a JSONL directory)`);let r=Fe(e,"manifest.json");if(!ue(r))throw new Error(`Manifest not found at ${r}. Is this a brain export directory?`)}function je(e,n){if(!e.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='qe_patterns'").get())return{created:0,skipped:0};e.exec(`
-    CREATE TEMP TABLE IF NOT EXISTS _covered_patterns (
-      pattern_id TEXT PRIMARY KEY
-    )
-  `),e.exec("DELETE FROM _covered_patterns"),e.exec(`
-    INSERT INTO _covered_patterns (pattern_id)
-    SELECT DISTINCT json_extract(action_data, '$.patternId')
-    FROM witness_chain
-    WHERE action_type = 'PATTERN_CREATE'
-      AND json_extract(action_data, '$.patternId') IS NOT NULL
-  `),e.exec(`
-    INSERT OR IGNORE INTO _covered_patterns (pattern_id)
-    SELECT DISTINCT json_extract(action_data, '$.pattern_id')
-    FROM witness_chain
-    WHERE action_type = 'PATTERN_CREATE'
-      AND json_extract(action_data, '$.pattern_id') IS NOT NULL
-  `);let t=e.prepare(`SELECT p.id, p.pattern_type, p.qe_domain, p.name, p.created_at
-       FROM qe_patterns p
-       LEFT JOIN _covered_patterns c ON p.id = c.pattern_id
-       WHERE c.pattern_id IS NULL
-       ORDER BY p.created_at ASC`).all(),i=e.prepare("SELECT COUNT(*) as count FROM qe_patterns").get().count-t.length,c=0;for(let l of t)n.append("PATTERN_CREATE",{patternId:l.id,patternType:l.pattern_type,qeDomain:l.qe_domain,name:l.name,originalCreatedAt:l.created_at,backfilled:!0},"system:backfill"),c++;return e.exec("DROP TABLE IF EXISTS _covered_patterns"),{created:c,skipped:i}}async function Ve(e,n){if(Fn(n.format)==="rvf"){let a=F(e,{readonly:!0});try{return Ae(a,{outputPath:n.outputPath,domains:n.domains,allowOverwriteRicher:n.allowOverwriteRicher},e)}finally{a.close()}}let t=F(e,{readonly:!0});try{return _e(t,n,e)}finally{t.close()}}async function Je(e,n,r){if(ze(n,r.format)==="rvf"){let i=F(e);try{return Ne(i,n,{mergeStrategy:r.mergeStrategy,dryRun:r.dryRun})}finally{i.close()}}let a=F(e);try{return Ee(a,n,r)}finally{a.close()}}async function Ue(e,n){return ze(e,n)==="rvf"?W(e):Be(e)}async function We(e,n,r={}){return Me(e,n,r)}async function He(e,n={}){return Le(e,n)}async function Ke(e){let n=F(e);try{let r=ve(n,we());return await r.initialize(),je(n,r)}finally{n.close()}}function Fn(e){if(e==="jsonl")return"jsonl";if(e==="rvf"){if(!de())throw new Error("RVF format requested but @ruvector/rvf-node is not available on this platform. Use --format jsonl instead.");return"rvf"}return de()?"rvf":"jsonl"}function ze(e,n){return n==="rvf"?"rvf":n==="jsonl"?"jsonl":e.endsWith(".rvf")?"rvf":"jsonl"}var ye=class{name="brain";description="Export, import, and inspect QE brain state";cleanupAndExit;ensureInitialized;constructor(n,r){this.cleanupAndExit=n,this.ensureInitialized=r}register(n,r){let t=n.command("brain").description(this.description);t.command("export").description("Export brain state to a portable directory").requiredOption("-o, --output <path>","Output directory path").option("--format <format>","Export format: rvf (default) or jsonl","rvf").option("--db <path>","Source database path").option("--force-overwrite-richer","Allow replacing an existing RVF with fewer patterns",!1).action(async a=>{await this.executeExport(a)}),t.command("import").description("Import brain state from an export directory").requiredOption("-i, --input <path>","Path to brain export directory").option("--strategy <strategy>","Merge strategy","skip-conflicts").option("--dry-run","Preview import without writing",!1).option("--db <path>","Target database path").action(async a=>{await this.executeImport(a)}),t.command("info").description("Show manifest info for a brain export").requiredOption("-i, --input <path>","Path to brain export directory").action(async a=>{await this.executeInfo(a)}),t.command("witness-backfill").description("Create witness chain entries for patterns that predate the witness chain").option("--db <path>","Database path").action(async a=>{await this.executeWitnessBackfill(a)}),t.command("diff").description("Compare two brain exports (JSONL directory or .rvf file)").argument("<a>","Path to first brain export").argument("<b>","Path to second brain export").option("--table <name>","Restrict comparison to a single table").option("--verbose","Show the IDs of added/removed/changed records",!1).option("--json","Emit the diff as JSON to stdout",!1).action(async(a,i,c)=>{await this.executeDiff(a,i,c)}),t.command("search").description("Search a JSONL brain export with filters").requiredOption("-i, --input <path>","Path to brain export directory (JSONL)").option("--table <name>","Table to search (default: qe_patterns)").option("--domain <name...>","Restrict to one or more domains").option("--pattern-type <type>","Restrict to a specific pattern_type (qe_patterns only)").option("--since <iso>","Include rows with timestamp \u2265 <iso>").option("--until <iso>","Include rows with timestamp \u2264 <iso>").option("-q, --query <text>","Substring match across name + description (case-insensitive)").option("-l, --limit <n>","Maximum results to return","20").option("--json","Emit results as JSON to stdout",!1).action(async a=>{await this.executeSearch(a)})}async executeExport(n){try{console.log(o.blue(`
-  Exporting brain state (format: ${n.format})...
-`));let r=await pe(n.db),t=await Ve(r,{outputPath:D.resolve(n.output),format:n.format,allowOverwriteRicher:n.forceOverwriteRicher});if(console.log(o.green("  Export complete.")),console.log(`  Format:   ${o.cyan("format"in t?t.format??"jsonl":"jsonl")}`),console.log(`  Patterns: ${o.cyan(t.stats.patternCount)}`),"embeddingCount"in t.stats?console.log(`  Vectors:  ${o.cyan(t.stats.embeddingCount)}`):"vectorCount"in t.stats&&console.log(`  Vectors:  ${o.cyan(t.stats.vectorCount)}`),"rvfStatus"in t){let a=t.rvfStatus;console.log(`  RVF Size: ${o.cyan(Ge(a.fileSizeBytes))}`),console.log(`  Segments: ${o.cyan(a.totalSegments)}`)}console.log(`  Checksum: ${o.gray(t.checksum)}`),console.log(`  Output:   ${o.cyan(D.resolve(n.output))}`),console.log(""),await this.cleanupAndExit(0)}catch(r){console.error(o.red(`
-  Brain export failed:`),r),await this.cleanupAndExit(1)}}async executeImport(n){try{n.dryRun?console.log(o.yellow(`
-  Dry-run mode \u2014 no data will be written.
-`)):console.log(o.blue(`
-  Importing brain state...
-`));let r=await pe(n.db),t=await Je(r,D.resolve(n.input),{mergeStrategy:n.strategy,dryRun:n.dryRun});console.log(o.green("  Import complete.")),console.log(`  Imported:  ${o.cyan(t.imported)}`),console.log(`  Skipped:   ${o.yellow(t.skipped)}`),console.log(`  Conflicts: ${o.red(t.conflicts)}`),"embeddingsRestored"in t&&console.log(`  Embeddings: ${o.cyan(t.embeddingsRestored)}`),console.log(""),await this.cleanupAndExit(0)}catch(r){console.error(o.red(`
-  Brain import failed:`),r),await this.cleanupAndExit(1)}}async executeInfo(n){try{console.log(o.blue(`
-  Brain Export Info
-`));let r=D.resolve(n.input),t=await Ue(r),a="format"in t?t.format??"jsonl":"jsonl";if(console.log(`  Version:       ${o.cyan(t.version)}`),console.log(`  Format:        ${o.cyan(a)}`),console.log(`  Exported:      ${o.cyan(t.exportedAt)}`),console.log(`  Source DB:     ${o.cyan(t.sourceDb)}`),console.log(o.blue(`
-  Learning Data:`)),console.log(`    Patterns:      ${o.cyan(t.stats.patternCount)}`),"qValueCount"in t.stats&&console.log(`    Q-Values:      ${o.cyan(t.stats.qValueCount)}`),"dreamInsightCount"in t.stats){let l=t.stats.dreamInsightCount,f=("tableRecordCounts"in t?t.tableRecordCounts:void 0)?.dream_cycles,m=f!==void 0?` (${f} cycles)`:"";console.log(`    Dream Insights: ${o.cyan(l)}${o.gray(m)}`)}"witnessChainLength"in t.stats&&console.log(`    Witness Chain:  ${o.cyan(t.stats.witnessChainLength)} entries`),"embeddingCount"in t.stats?console.log(`    Embeddings:    ${o.cyan(t.stats.embeddingCount)}`):"vectorCount"in t.stats&&console.log(`    Vectors:       ${o.cyan(t.stats.vectorCount)}`);let i="tableRecordCounts"in t?t.tableRecordCounts:void 0;if(i){let l=Object.entries(i).filter(([s,f])=>f>0&&!["qe_patterns","rl_q_values","dream_insights","dream_cycles","witness_chain","vectors","qe_pattern_embeddings"].includes(s));if(l.length>0)for(let[s,f]of l){let p=`${s.replace(/_/g," ").replace(/\b\w/g,g=>g.toUpperCase())}:`.padEnd(15);console.log(`    ${p}${o.cyan(f)}`)}}let c="totalRecords"in t.stats?t.stats.totalRecords:void 0;if(c!==void 0&&(console.log(o.blue(`
-  Summary:`)),console.log(`    Total Records: ${o.cyan(c)}`)),"domains"in t&&Array.isArray(t.domains)&&t.domains.length>0&&(c||console.log(o.blue(`
-  Summary:`)),console.log(`    Domains:       ${o.cyan(t.domains.join(", "))}`)),"rvfStatus"in t){let l=t.rvfStatus;console.log(o.blue(`
-  RVF Details:`)),console.log(`    File Size:     ${o.cyan(Ge(l.fileSizeBytes))}`),console.log(`    Vectors:       ${o.cyan(l.totalVectors)}`),console.log(`    Segments:      ${o.cyan(l.totalSegments)}`)}if("lineage"in t){let l=t.lineage;l&&(console.log(o.blue(`
-  Lineage:`)),console.log(`    File ID:       ${o.cyan(l.fileId)}`),console.log(`    Parent ID:     ${o.cyan(l.parentId??"none (root)")}`),console.log(`    Depth:         ${o.cyan(l.lineageDepth)}`))}if("signature"in t){let l=t.signature,s=t.signerKeyId;console.log(o.blue(`
-  Signature:`)),l?(console.log(`    Status:        ${o.green("Signed")}`),console.log(`    Key ID:        ${o.cyan(s??"unknown")}`),console.log(`    Signature:     ${o.gray(l.slice(0,32)+"...")}`)):console.log(`    Status:        ${o.yellow("Unsigned")}`)}console.log(`
-  Checksum:      ${o.gray(t.checksum)}`),console.log(""),await this.cleanupAndExit(0)}catch(r){console.error(o.red(`
-  Failed to read brain info:`),r),await this.cleanupAndExit(1)}}async executeDiff(n,r,t){try{let a=await We(D.resolve(n),D.resolve(r),{tableFilter:t.table});if(t.json){process.stdout.write(JSON.stringify(a,null,2)+`
-`),await this.cleanupAndExit(a.identical?0:1);return}jn(a,t.verbose),await this.cleanupAndExit(a.identical?0:1)}catch(a){console.error(o.red(`
-  Brain diff failed:`),a),await this.cleanupAndExit(2)}}async executeSearch(n){try{let r=Ln(n.limit),t=Pn(n.domain),a=await He(D.resolve(n.input),{table:n.table,domains:t,patternType:n.patternType,since:n.since,until:n.until,query:n.query,limit:r});if(n.json){process.stdout.write(JSON.stringify(a,null,2)+`
-`),await this.cleanupAndExit(a.totalMatched>0?0:3);return}Un(a),await this.cleanupAndExit(a.totalMatched>0?0:3)}catch(r){console.error(o.red(`
-  Brain search failed:`),r),await this.cleanupAndExit(2)}}async executeWitnessBackfill(n){try{console.log(o.blue(`
-  Running witness chain backfill...
-`));let r=await pe(n.db),t=await Ke(r);console.log(o.green("  Backfill complete.")),console.log(`  Created: ${o.cyan(t.created)} new witness entries`),console.log(`  Skipped: ${o.cyan(t.skipped)} (already witnessed)`),console.log(""),await this.cleanupAndExit(0)}catch(r){console.error(o.red(`
-  Witness backfill failed:`),r),await this.cleanupAndExit(1)}}getHelp(){return`
-Export, import, and inspect QE brain state.
-
-Formats:
-  rvf   \u2014 Single portable .rvf file (default, requires @ruvector/rvf-node)
-  jsonl \u2014 JSONL directory format (fallback when native not available)
-
-Usage:
-  aqe brain export -o brain.rvf [--format rvf] [--db <path>]
-  aqe brain export -o ./brain-dir --format jsonl [--db <path>]
-  aqe brain import -i brain.rvf [--strategy skip-conflicts] [--dry-run] [--db <path>]
-  aqe brain info -i brain.rvf
-
-Subcommands:
-  export    Export brain state to a portable .rvf file or JSONL directory
-  import    Import a brain export into the local database
-  info      Show manifest metadata for an existing brain export
-  diff      Compare two brain exports (manifest always; record-level for JSONL)
-  search    Filtered search over a JSONL brain export
-
-Examples:
-  aqe brain export -o .agentic-qe/brain.rvf
-  aqe brain export -o .agentic-qe/brain.rvf --format rvf
-  aqe brain export -o ./brain-export --format jsonl
-  aqe brain import -i .agentic-qe/brain.rvf --strategy latest-wins
-  aqe brain import -i .agentic-qe/brain.rvf --dry-run
-  aqe brain info -i .agentic-qe/brain.rvf
-  aqe brain diff ./brain-a ./brain-b --verbose
-  aqe brain search -i ./brain-export --query oauth --domain test-generation
-  aqe brain search -i ./brain-export --since 2026-03-01 --limit 50 --json
-`}};async function pe(e){if(e)return e;let{findProjectRoot:n}=await import("./unified-memory-CXHLHB5I.js");return D.join(n(),".agentic-qe","memory.db")}function Ge(e){return e<1024?`${e} B`:e<1024*1024?`${(e/1024).toFixed(1)} KB`:`${(e/(1024*1024)).toFixed(1)} MB`}function Ln(e){let n=Number.parseInt(e,10);return!Number.isFinite(n)||n<1?20:n}function Pn(e){if(e===void 0)return;let n=Array.isArray(e)?e:[e],r=[];for(let t of n)for(let a of t.split(",")){let i=a.trim();i&&r.push(i)}return r.length>0?r:void 0}function jn(e,n){console.log(o.blue(`
-  Brain Diff
-`)),console.log(`  A:            ${o.cyan(e.pathA)}  (${e.formatA})`),console.log(`  B:            ${o.cyan(e.pathB)}  (${e.formatB})`),console.log(`  Versions:     ${o.cyan(e.manifestA.version)} \u2192 ${o.cyan(e.manifestB.version)}`+(e.versionMatch?o.gray(" (match)"):o.yellow(" (differ)"))),console.log(`  Checksums:    ${o.gray(e.manifestA.checksum.slice(0,12))}\u2026 \u2192 ${o.gray(e.manifestB.checksum.slice(0,12))}\u2026`+(e.checksumMatch?o.gray(" (match)"):o.yellow(" (differ)"))),console.log(`  Exported:     ${o.gray(e.manifestA.exportedAt)} \u2192 ${o.gray(e.manifestB.exportedAt)}`),console.log(`  Records:      ${o.cyan(e.manifestA.totalRecords)} \u2192 ${o.cyan(e.manifestB.totalRecords)} `+Qe(e.manifestB.totalRecords-e.manifestA.totalRecords)),(e.domainsOnlyInA.length>0||e.domainsOnlyInB.length>0)&&(console.log(o.blue(`
-  Domains:`)),e.domainsOnlyInA.length>0&&console.log(`    Only in A: ${o.yellow(e.domainsOnlyInA.join(", "))}`),e.domainsOnlyInB.length>0&&console.log(`    Only in B: ${o.yellow(e.domainsOnlyInB.join(", "))}`)),e.recordLevel||console.log(o.gray(`
-  Note: record-level diff is only available when both sides are JSONL exports.
-        Per-table counts shown below; re-export with --format jsonl for added/removed/changed IDs.`)),console.log(o.blue(`
-  Tables:`));let r=e.tableDiffs.filter(Vn);if(r.length===0)console.log(o.gray("    (no differences)"));else for(let t of r)console.log(`    ${t.tableName.padEnd(28)} ${o.cyan(String(t.countA).padStart(7))} \u2192 ${o.cyan(String(t.countB).padStart(7))} ${Qe(t.delta)}`+Jn(t,n)),n&&(t.added&&t.added.length>0&&ge("added",t.added),t.removed&&t.removed.length>0&&ge("removed",t.removed),t.changed&&t.changed.length>0&&ge("changed",t.changed));console.log(""),e.identical?console.log(o.green(`  Result: identical
-`)):console.log(o.yellow(`  Result: differences found
-`))}function Vn(e){return!!(e.delta!==0||e.added&&e.added.length>0||e.removed&&e.removed.length>0||e.changed&&e.changed.length>0)}function Qe(e){return e===0?o.gray("(\xB10)"):e>0?o.green(`(+${e})`):o.red(`(${e})`)}function Jn(e,n){let r=[];return e.added&&e.added.length>0&&r.push(o.green(`+${e.added.length}`)),e.removed&&e.removed.length>0&&r.push(o.red(`-${e.removed.length}`)),e.changed&&e.changed.length>0&&r.push(o.yellow(`~${e.changed.length}`)),r.length===0?"":n?"  "+r.join(" "):"  "+o.gray("[")+r.join(" ")+o.gray("]")}function ge(e,n){let r=n.slice(0,10).join(", "),t=n.length>10?o.gray(` \u2026(+${n.length-10} more)`):"";console.log(`      ${o.gray(e+":")} ${r}${t}`)}function Un(e){if(console.log(o.blue(`
-  Brain Search
-`)),console.log(`  Input:      ${o.cyan(e.inputPath)}`),console.log(`  Table:      ${o.cyan(e.table)}`),console.log(`  Scanned:    ${o.cyan(e.totalScanned)}    Matched: ${o.cyan(e.totalMatched)}    Shown: ${o.cyan(e.hits.length)}`+(e.truncated?o.yellow(` (truncated to limit ${e.limit})`):"")),e.hits.length===0){console.log(o.yellow(`
-  No matching rows.
-`));return}console.log("");for(let n of e.hits){let r=o.cyan(n.id)+(n.display.patternType?o.gray(`  ${n.display.patternType}`):"")+(n.display.domain?o.gray(`  [${n.display.domain}]`):"")+(n.display.confidence!==void 0?o.gray(`  conf=${n.display.confidence.toFixed(2)}`):"");if(console.log(`  ${r}`),n.display.name&&console.log(`    ${o.bold(n.display.name)}`),n.display.description){let t=n.display.description.length>200?n.display.description.slice(0,200)+"\u2026":n.display.description;console.log(`    ${o.gray(t)}`)}n.display.updatedAt&&console.log(`    ${o.gray(n.display.updatedAt)}`),console.log("")}}function _t(e,n){return new ye(e,n)}export{ye as BrainHandler,_t as createBrainHandler};

package/dist/cli/chunks/browser-workflow-2FZTKDUL.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
-import{a}from"./chunk-HV2J7KKQ.js";import"./chunk-W7BWUTVV.js";import"./chunk-6TPKK7LD.js";import"./chunk-55RWDRJD.js";import"./chunk-R4VL6E65.js";import"./chunk-RJCYCLZV.js";import"./chunk-NA7B2QYB.js";import"./chunk-Y3MW3YBC.js";import"./chunk-PEPFCPES.js";import"./chunk-DHJPWQBR.js";import"./chunk-G6T45OIC.js";import"./chunk-SRKETSFF.js";import"./chunk-AIHDEEJO.js";import"./chunk-BGE6FOLM.js";import"./chunk-5YPYDPBJ.js";import"./chunk-HDSAM2RE.js";import"./chunk-KCZR45PA.js";import"./chunk-BFP7KO7P.js";import"./chunk-ODKLFVYC.js";import"./chunk-VD6QRULW.js";import"./chunk-KHFNNVJA.js";import"./chunk-CNG6GQEZ.js";import"./chunk-TT23RRB7.js";export{a as BrowserWorkflowTool};

package/dist/cli/chunks/chunk-33YYYWBQ.js

@@ -1,4 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
-import*as o from"fs";import*as l from"path";var m=class{cacheDir;keepVersions;constructor(e={}){this.cacheDir=e.cacheDir??l.join(process.cwd(),".agentic-qe","plugins"),this.keepVersions=e.keepVersions??2}has(e,t){let s=this.versionDir(e,t);return o.existsSync(s)&&o.existsSync(l.join(s,"qe-plugin.json"))}get(e,t){if(!this.has(e,t))return;let s=this.versionDir(e,t),i=o.readFileSync(l.join(s,"qe-plugin.json"),"utf-8"),r=JSON.parse(i),c=o.statSync(s);return{manifest:r,path:s,cachedAt:c.birthtime.toISOString()}}store(e,t){let s=this.versionDir(e.name,e.version);return o.existsSync(s)||(o.mkdirSync(s,{recursive:!0}),this.copyDir(t,s),o.writeFileSync(l.join(s,"qe-plugin.json"),JSON.stringify(e,null,2)),this.pruneOldVersions(e.name)),s}remove(e,t){let s=this.versionDir(e,t);return o.existsSync(s)?(o.rmSync(s,{recursive:!0,force:!0}),!0):!1}listVersions(e){let t=l.join(this.cacheDir,e);if(!o.existsSync(t))return[];let s=[],i=o.readdirSync(t);for(let r of i){let c=l.join(t,r),h=l.join(c,"qe-plugin.json");if(o.existsSync(h))try{let a=o.readFileSync(h,"utf-8"),f=JSON.parse(a),u=o.statSync(c);s.push({manifest:f,path:c,cachedAt:u.birthtime.toISOString()})}catch{}}return s}listAll(){if(!o.existsSync(this.cacheDir))return[];let e=[],t=o.readdirSync(this.cacheDir);for(let s of t){let i=this.listVersions(s);i.length>0&&(i.sort((r,c)=>c.manifest.version.localeCompare(r.manifest.version)),e.push(i[0]))}return e}versionDir(e,t){return l.join(this.cacheDir,e,t)}pruneOldVersions(e){let t=this.listVersions(e);if(t.length<=this.keepVersions)return;t.sort((i,r)=>i.cachedAt.localeCompare(r.cachedAt));let s=t.slice(0,t.length-this.keepVersions);for(let i of s)o.rmSync(i.path,{recursive:!0,force:!0})}copyDir(e,t){if(!o.existsSync(e))return;let s=o.readdirSync(e,{withFileTypes:!0});for(let i of s){let r=l.join(e,i.name),c=l.join(t,i.name);if(i.isDirectory()){if(i.name===".git"||i.name==="node_modules")continue;o.mkdirSync(c,{recursive:!0}),this.copyDir(r,c)}else o.copyFileSync(r,c)}}};var R=/^[a-z][a-z0-9-]*$/,S=/^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?$/,j=["aqe-core-","agentic-qe-core-"];function E(n){let e=[],t=[];if(!n||typeof n!="object")return{valid:!1,errors:["Manifest must be a non-null object"],warnings:[]};let s=n;if(!s.name||typeof s.name!="string"?e.push("name is required and must be a string"):D(s.name,e,t),!s.version||typeof s.version!="string"?e.push("version is required and must be a string"):S.test(s.version)||e.push(`version "${s.version}" is not valid semver (expected: major.minor.patch)`),!s.description||typeof s.description!="string"?e.push("description is required and must be a string"):s.description.length>500&&t.push("description exceeds 500 characters"),(!s.author||typeof s.author!="string")&&e.push("author is required and must be a string"),!Array.isArray(s.domains)||s.domains.length===0)e.push("domains is required and must be a non-empty array");else for(let i of s.domains)if(typeof i!="string"){e.push("Each domain must be a string");break}if(!s.entryPoint||typeof s.entryPoint!="string"?e.push("entryPoint is required and must be a string"):V(s.entryPoint,e),s.dependencies!==void 0)if(typeof s.dependencies!="object"||s.dependencies===null||Array.isArray(s.dependencies))e.push("dependencies must be an object mapping plugin names to semver ranges");else for(let[i,r]of Object.entries(s.dependencies))typeof r!="string"&&e.push(`Dependency "${i}" must have a string version range`);if(s.hooks!==void 0)if(typeof s.hooks!="object"||s.hooks===null||Array.isArray(s.hooks))e.push("hooks must be an object mapping event names to handler paths");else for(let[,i]of Object.entries(s.hooks)){if(typeof i!="string"){e.push("Hook handler paths must be strings");break}i.includes("..")&&e.push(`Hook handler path "${i}" must not contain ".." (path traversal)`)}if(s.minAqeVersion!==void 0&&(typeof s.minAqeVersion!="string"||!S.test(s.minAqeVersion))&&t.push("minAqeVersion should be valid semver"),s.permissions!==void 0){if(!Array.isArray(s.permissions))e.push("permissions must be an array of strings");else for(let i of s.permissions)if(typeof i!="string"){e.push("Each permission must be a string");break}}return{valid:e.length===0,errors:e,warnings:t}}function b(n){let e=typeof n=="string"?JSON.parse(n):n,t=E(e);if(!t.valid)throw new Error(`Invalid plugin manifest:
-  - ${t.errors.join(`
-  - `)}`);return e}function D(n,e,t){n.length>64&&e.push("name must be 64 characters or fewer"),R.test(n)||e.push("name must be lowercase alphanumeric with hyphens, starting with a letter"),/[^\x00-\x7F]/.test(n)&&e.push("name must contain only ASCII characters");for(let s of j)n.startsWith(s)&&e.push(`name cannot start with reserved prefix "${s}"`);["plugin","test","tool"].includes(n)&&t.push(`name "${n}" is very generic \u2014 consider a more descriptive name`)}function V(n,e){n.includes("..")&&e.push('entryPoint must not contain ".." (path traversal)'),(n.startsWith("/")||n.startsWith("\\"))&&e.push("entryPoint must be a relative path"),!n.endsWith(".js")&&!n.endsWith(".ts")&&!n.endsWith(".mjs")&&e.push("entryPoint must end in .js, .ts, or .mjs")}var y=class{resolve(e){let t=new Map;for(let a of e)t.set(a.name,a);let s=[],i=new Set,r=new Set,c=new Map,h=(a,f)=>{if(i.has(a))return;if(r.has(a)){let g=[...f.slice(f.indexOf(a)),a];throw new Error(`Dependency cycle detected: ${g.join(" -> ")}`)}let u=t.get(a);if(!u)return;r.add(a);let k=Object.keys(u.dependencies??{}),P=[];for(let g of k)t.has(g)?h(g,[...f,a]):P.push(g);P.length>0&&c.set(a,P),r.delete(a),i.add(a),s.push(u)};for(let a of e)h(a.name,[]);return{ordered:s.map((a,f)=>({manifest:a,order:f})),missing:c}}canLoad(e,t){let i=Object.keys(e.dependencies??{}).filter(r=>!t.has(r));return{canLoad:i.length===0,missingDeps:i}}};var N=["aqe-core-","agentic-qe-core-","agentic-qe-internal-"],M=new Set(["aqe","agentic-qe","ruflo","claude-flow"]),_=["..","~","/etc/","/proc/","/dev/","node_modules/"];function A(n){let e=[];return $(n.name,e),q(n.entryPoint,e),C(n.hooks,e),I(n.permissions,e),{safe:e.length===0,violations:e}}function $(n,e){/[^\x20-\x7E]/.test(n)&&e.push(`Plugin name "${n}" contains non-ASCII characters`),M.has(n.toLowerCase())&&e.push(`Plugin name "${n}" is a reserved name`);for(let s of N)n.toLowerCase().startsWith(s)&&e.push(`Plugin name "${n}" uses reserved prefix "${s}"`);let t=n.toLowerCase().replace(/[0o]/g,"o").replace(/[1il]/g,"l").replace(/[-_]/g,"");M.has(t)&&e.push(`Plugin name "${n}" is visually similar to a reserved name`)}function q(n,e){w(n,"entryPoint",e),(n.startsWith("/")||n.startsWith("\\"))&&e.push("entryPoint must be a relative path, not absolute")}function C(n,e){if(n)for(let[t,s]of Object.entries(n))w(s,`hook[${t}]`,e)}function w(n,e,t){for(let s of _)n.includes(s)&&t.push(`${e} contains dangerous path pattern "${s}"`);n.includes("\0")&&t.push(`${e} contains null byte (path injection attempt)`)}function I(n,e){if(!n)return;let t=["fs:write-root","net:arbitrary","exec:shell"];for(let s of n)t.includes(s)&&e.push(`Plugin requests dangerous permission: ${s}`)}import*as p from"fs";import*as d from"path";var v=class{type="local";async resolve(e){let t=d.resolve(e),s=d.join(t,"qe-plugin.json");if(!p.existsSync(s))throw new Error(`No qe-plugin.json found at ${s}`);let i=p.readFileSync(s,"utf-8");return b(i)}async getPluginPath(e){let t=d.resolve(e);if(!p.existsSync(t))throw new Error(`Plugin directory does not exist: ${t}`);return t}};var x=class{cache;resolver;sources=new Map;constructor(e={}){this.cache=e.cache??new m,this.resolver=new y;let t=new v;if(this.sources.set("local",t),e.sources)for(let s of e.sources)this.sources.set(s.type,s)}async install(e,t="local"){if(process.env.AQE_PLUGINS_DISABLED==="true")return{success:!1,errors:["Plugin loading is disabled (AQE_PLUGINS_DISABLED=true)"],securityViolations:[]};let s=[],i=this.sources.get(t);if(!i)return{success:!1,errors:[`Unknown source type: ${t}. Available: ${[...this.sources.keys()].join(", ")}`],securityViolations:[]};let r;try{r=await i.resolve(e)}catch(u){return{success:!1,errors:[`Failed to resolve plugin: ${u instanceof Error?u.message:String(u)}`],securityViolations:[]}}let c=E(r);if(!c.valid)return{success:!1,manifest:r,errors:c.errors,securityViolations:[]};let h=A(r);if(!h.safe)return{success:!1,manifest:r,errors:["Plugin failed security checks"],securityViolations:h.violations};if(this.cache.has(r.name,r.version)){let u=this.cache.get(r.name,r.version);return{success:!0,manifest:r,cachePath:u.path,errors:[],securityViolations:[]}}let a;try{a=await i.getPluginPath(e)}catch(u){return{success:!1,manifest:r,errors:[`Failed to get plugin path: ${u instanceof Error?u.message:String(u)}`],securityViolations:[]}}let f=this.cache.store(r,a);return{success:!0,manifest:r,cachePath:f,errors:s,securityViolations:[]}}remove(e,t){if(t)return this.cache.remove(e,t);let s=this.cache.listVersions(e),i=!1;for(let r of s)this.cache.remove(e,r.manifest.version)&&(i=!0);return i}list(){return this.cache.listAll().map(t=>({name:t.manifest.name,version:t.manifest.version,description:t.manifest.description,domains:t.manifest.domains,source:"cached",cachePath:t.path}))}resolveLoadOrder(){let e=this.cache.listAll();return this.resolver.resolve(e.map(t=>t.manifest))}registerSource(e){this.sources.set(e.type,e)}};export{b as a,m as b,x as c};