agentic-qe 3.10.3 → 3.10.4

package/dist/cli/chunks/visual-security-RAWV6YLN.js

@@ -0,0 +1,2 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{a}from"./chunk-F6QPAVWS.js";import"./chunk-F77X5DAF.js";import"./chunk-TBJ566KV.js";import"./chunk-NZGLDOU4.js";import"./chunk-K72J52JO.js";import"./chunk-U27GVYXA.js";import"./chunk-IYFMDIYZ.js";import"./chunk-HPYGMKZF.js";import"./chunk-VRE2EBFI.js";import"./chunk-2B6ETC7C.js";import"./chunk-PISW5HUX.js";import"./chunk-RJKYPWFD.js";import"./chunk-2G2PVVQG.js";import"./chunk-UWAUYDW4.js";import"./chunk-N3MM4Z33.js";import"./chunk-6OLHPWSN.js";import"./chunk-WI5WXYIS.js";import"./chunk-EMZ3DXMG.js";import"./chunk-MFWWPRBV.js";import"./chunk-D7IWGQTW.js";import"./chunk-SVILIQQQ.js";export{a as VisualSecurityTool};

package/dist/cli/chunks/{web-tree-sitter-2YPGYLWK.js → web-tree-sitter-LECH5T6H.js}

@@ -1,2 +1,2 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.3");process.exit(0)}
-import"./chunk-CAMEFWRK.js";import{createRequire as t}from"module";var o=t(import.meta.url),e=o("web-tree-sitter"),i=e,{RuvectorLayer:n,TensorCompress:a,differentiableSearch:c,hierarchicalForward:s,getCompressionLevel:l,init:p,FlashAttention:m,DotProductAttention:u,MultiHeadAttention:d,HyperbolicAttention:A,LinearAttention:f,MoEAttention:h,SonaEngine:_,pipeline:b}=e||{};export{u as DotProductAttention,m as FlashAttention,A as HyperbolicAttention,f as LinearAttention,h as MoEAttention,d as MultiHeadAttention,n as RuvectorLayer,_ as SonaEngine,a as TensorCompress,i as default,c as differentiableSearch,l as getCompressionLevel,s as hierarchicalForward,p as init,b as pipeline};
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import"./chunk-SVILIQQQ.js";import{createRequire as t}from"module";var o=t(import.meta.url),e=o("web-tree-sitter"),i=e,{RuvectorLayer:n,TensorCompress:a,differentiableSearch:c,hierarchicalForward:s,getCompressionLevel:l,init:p,FlashAttention:m,DotProductAttention:u,MultiHeadAttention:d,HyperbolicAttention:A,LinearAttention:f,MoEAttention:h,SonaEngine:_,pipeline:b}=e||{};export{u as DotProductAttention,m as FlashAttention,A as HyperbolicAttention,f as LinearAttention,h as MoEAttention,d as MultiHeadAttention,n as RuvectorLayer,_ as SonaEngine,a as TensorCompress,i as default,c as differentiableSearch,l as getCompressionLevel,s as hierarchicalForward,p as init,b as pipeline};

package/dist/cli/chunks/{windsurf-installer-GOJWUWC5.js → windsurf-installer-2NPLC2YW.js}

@@ -1,5 +1,5 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.3");process.exit(0)}
-import{b as u}from"./chunk-YDDZJCKY.js";import{a as f,c as h}from"./chunk-3LRK7PYN.js";import"./chunk-CAMEFWRK.js";h();import{existsSync as i,mkdirSync as d,readFileSync as g,writeFileSync as a}from"fs";import{join as p,dirname as v}from"path";var c=class{projectRoot;overwrite;generator;constructor(e){this.projectRoot=e.projectRoot,this.overwrite=e.overwrite??!1,this.generator=u()}async install(){let e={success:!0,mcpConfigured:!1,rulesInstalled:!1,errors:[],configPath:"",rulesPath:""};try{let t=this.generator.generateMcpConfig("windsurf"),r=p(this.projectRoot,t.path);if(e.configPath=r,!i(r)||this.overwrite){let o=v(r);if(i(o)||d(o,{recursive:!0}),i(r)&&this.overwrite){let m=this.mergeExistingConfig(r,t.content);a(r,m)}else a(r,t.content);e.mcpConfigured=!0}let n=this.generator.generateBehavioralRules("windsurf"),s=p(this.projectRoot,n.path);if(e.rulesPath=s,!i(s)||this.overwrite){if(i(s)&&this.overwrite){let o=this.mergeExistingRules(s,n.content);a(s,o)}else a(s,n.content);e.rulesInstalled=!0}}catch(t){e.success=!1,e.errors.push(`Windsurf installation failed: ${f(t)}`)}return e}mergeExistingConfig(e,t){try{let r=JSON.parse(g(e,"utf-8")),n=JSON.parse(t);return r.mcpServers||(r.mcpServers={}),Object.assign(r.mcpServers,n.mcpServers),JSON.stringify(r,null,2)+`
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{b as u}from"./chunk-LOFA3U4X.js";import{a as f,c as h}from"./chunk-2B6ETC7C.js";import"./chunk-SVILIQQQ.js";h();import{existsSync as i,mkdirSync as d,readFileSync as g,writeFileSync as a}from"fs";import{join as p,dirname as v}from"path";var c=class{projectRoot;overwrite;generator;constructor(e){this.projectRoot=e.projectRoot,this.overwrite=e.overwrite??!1,this.generator=u()}async install(){let e={success:!0,mcpConfigured:!1,rulesInstalled:!1,errors:[],configPath:"",rulesPath:""};try{let t=this.generator.generateMcpConfig("windsurf"),r=p(this.projectRoot,t.path);if(e.configPath=r,!i(r)||this.overwrite){let o=v(r);if(i(o)||d(o,{recursive:!0}),i(r)&&this.overwrite){let m=this.mergeExistingConfig(r,t.content);a(r,m)}else a(r,t.content);e.mcpConfigured=!0}let n=this.generator.generateBehavioralRules("windsurf"),s=p(this.projectRoot,n.path);if(e.rulesPath=s,!i(s)||this.overwrite){if(i(s)&&this.overwrite){let o=this.mergeExistingRules(s,n.content);a(s,o)}else a(s,n.content);e.rulesInstalled=!0}}catch(t){e.success=!1,e.errors.push(`Windsurf installation failed: ${f(t)}`)}return e}mergeExistingConfig(e,t){try{let r=JSON.parse(g(e,"utf-8")),n=JSON.parse(t);return r.mcpServers||(r.mcpServers={}),Object.assign(r.mcpServers,n.mcpServers),JSON.stringify(r,null,2)+`
 `}catch{return t}}mergeExistingRules(e,t){try{let r=g(e,"utf-8");return r.includes("Agentic QE")||r.includes("fleet_init")?r:r.trimEnd()+`
 
 ---

package/dist/cli/chunks/{witness-chain-3MGSS3Q4.js → witness-chain-X347C36A.js}

@@ -1,2 +1,2 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.3");process.exit(0)}
-import{a,b,c,d,e,f,g}from"./chunk-HQJMCTWN.js";import"./chunk-3VF3HCG4.js";import"./chunk-2L73WXA4.js";import"./chunk-YIYV2JB6.js";import"./chunk-CAMEFWRK.js";export{c as PersistentWitnessChain,a as SPRTAccumulator,b as WitnessChain,f as createPersistentWitnessChain,e as createWitnessChain,d as createWitnessChainSQLitePersistence,g as isWitnessChainFeatureEnabled};
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{a,b,c,d,e,f,g}from"./chunk-UW3ZSFFB.js";import"./chunk-HPYGMKZF.js";import"./chunk-VRE2EBFI.js";import"./chunk-D7IWGQTW.js";import"./chunk-SVILIQQQ.js";export{c as PersistentWitnessChain,a as SPRTAccumulator,b as WitnessChain,f as createPersistentWitnessChain,e as createWitnessChain,d as createWitnessChainSQLitePersistence,g as isWitnessChainFeatureEnabled};

package/dist/cli/chunks/witness-chain-ZO7FIM35.js

@@ -0,0 +1,2 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{a,b,c,d,e,f,g,h,i}from"./chunk-YSLE6NNG.js";import"./chunk-NZGLDOU4.js";import"./chunk-K72J52JO.js";import"./chunk-U27GVYXA.js";import"./chunk-IYFMDIYZ.js";import"./chunk-HPYGMKZF.js";import"./chunk-VRE2EBFI.js";import"./chunk-2B6ETC7C.js";import"./chunk-RJKYPWFD.js";import"./chunk-2G2PVVQG.js";import"./chunk-UWAUYDW4.js";import"./chunk-N3MM4Z33.js";import"./chunk-6OLHPWSN.js";import"./chunk-WI5WXYIS.js";import"./chunk-EMZ3DXMG.js";import"./chunk-MFWWPRBV.js";import"./chunk-D7IWGQTW.js";import"./chunk-SVILIQQQ.js";export{a as GENESIS_PREV_HASH,f as WitnessChain,i as _resetWitnessChainForTests,h as createWitnessChain,g as getWitnessChain,d as hashWith,e as serializeEntry,b as sha256,c as shake256};

package/dist/cli/chunks/{workflow-B5Q77BI4.js → workflow-V4ALYZ73.js}

@@ -1,5 +1,5 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.3");process.exit(0)}
-import{b as $}from"./chunk-CTDO2UB2.js";import"./chunk-XTP2GHI7.js";import{d as R}from"./chunk-6FL3GN4T.js";import{b as k,c as C,d as b}from"./chunk-YYAPO3CU.js";import{c as W}from"./chunk-KTRB3L53.js";import"./chunk-JD2PG4KS.js";import"./chunk-3LRK7PYN.js";import"./chunk-CAMEFWRK.js";import{Command as O}from"commander";import o from"chalk";function P(d,a){let m=d.indexOf("=");return m>0&&(a[d.substring(0,m)]=d.substring(m+1)),a}function x(d,a,m){let y=new O("workflow").description("Manage QE workflows and pipelines (ADR-041)");return y.command("run <file>").description("Execute a QE pipeline from YAML file").option("-w, --watch","Watch execution progress").option("-v, --verbose","Show detailed output").option("--params <json>","Additional parameters as JSON","{}").action(async(t,l)=>{if(!await m())return;let e=await import("fs"),c=(await import("path")).resolve(t);try{console.log(o.blue(`
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{b as $}from"./chunk-KJ56OXH4.js";import"./chunk-WIYWDON4.js";import{d as R}from"./chunk-GILL32E2.js";import{b as k,c as C,d as b}from"./chunk-DPKECIKN.js";import{c as W}from"./chunk-IYFMDIYZ.js";import"./chunk-UFKVKNAA.js";import"./chunk-2B6ETC7C.js";import"./chunk-SVILIQQQ.js";import{Command as O}from"commander";import o from"chalk";function P(d,a){let m=d.indexOf("=");return m>0&&(a[d.substring(0,m)]=d.substring(m+1)),a}function x(d,a,m){let y=new O("workflow").description("Manage QE workflows and pipelines (ADR-041)");return y.command("run <file>").description("Execute a QE pipeline from YAML file").option("-w, --watch","Watch execution progress").option("-v, --verbose","Show detailed output").option("--params <json>","Additional parameters as JSON","{}").action(async(t,l)=>{if(!await m())return;let e=await import("fs"),c=(await import("path")).resolve(t);try{console.log(o.blue(`
  Running workflow from: ${t}
 `));let s=k(c);if(!s.success||!s.workflow){console.log(o.red("Failed to parse pipeline:"));for(let w of s.errors)console.log(o.red(`   ${w}`));await a(1)}let r={...W(l.params,"params")};if(s.pipeline){for(let w of s.pipeline.stages)if(w.params)for(let[S,h]of Object.entries(w.params))r[S]=h}if(!d.workflowOrchestrator.getWorkflow(s.workflow.id)){let w=d.workflowOrchestrator.registerWorkflow(s.workflow);w.success||(console.log(o.red(`Failed to register workflow: ${w.error.message}`)),await a(1))}let n=await d.workflowOrchestrator.executeWorkflow(s.workflow.id,r);if(!n.success){console.log(o.red(`Failed to start workflow: ${n.error.message}`)),await a(1);return}let p=n.value;if(console.log(o.cyan(`  Execution ID: ${p}`)),console.log(o.gray(`  Workflow: ${s.workflow.name}`)),console.log(o.gray(`  Stages: ${s.workflow.steps.length}`)),console.log(""),l.watch){console.log(o.blue(`Workflow Progress:
 `));let w,S=Date.now();for(;;){let g=d.workflowOrchestrator.getWorkflowStatus(p);if(!g)break;if(!w||w.progress!==g.progress||w.status!==g.status||JSON.stringify(w.currentSteps)!==JSON.stringify(g.currentSteps)){process.stdout.write("\r\x1B[K");let v="\u2588".repeat(Math.floor(g.progress/5))+"\u2591".repeat(20-Math.floor(g.progress/5)),D=g.status==="completed"?o.green:g.status==="failed"?o.red:g.status==="running"?o.yellow:o.gray;console.log(`  [${v}] ${g.progress}% - ${D(g.status)}`),g.currentSteps.length>0&&l.verbose&&console.log(o.gray(`    Running: ${g.currentSteps.join(", ")}`)),w=g}if(g.status==="completed"||g.status==="failed"||g.status==="cancelled")break;await new Promise(v=>setTimeout(v,500))}let h=d.workflowOrchestrator.getWorkflowStatus(p);if(h){console.log("");let g=h.duration||Date.now()-S;h.status==="completed"?(console.log(o.green("Workflow completed successfully")),console.log(o.gray(`   Duration: ${$(g)}`)),console.log(o.gray(`   Completed: ${h.completedSteps.length} stages`)),h.skippedSteps.length>0&&console.log(o.yellow(`   Skipped: ${h.skippedSteps.length} stages`))):h.status==="failed"?(console.log(o.red("Workflow failed")),console.log(o.red(`   Error: ${h.error}`)),console.log(o.gray(`   Failed stages: ${h.failedSteps.join(", ")}`))):console.log(o.yellow(`Workflow ${h.status}`))}}else console.log(o.green("Workflow execution started")),console.log(o.gray(`   Use 'aqe workflow status ${p}' to check progress`));console.log(""),await a(0)}catch(s){console.error(o.red(`
@@ -35,10 +35,10 @@ Workflow cancelled: ${t}
 `)):console.log(o.red(`
 Failed to cancel workflow: ${l.error.message}
 `)),await a(l.success?0:1)}catch(l){console.error(o.red(`
-Failed to cancel workflow:`),l),await a(1)}}),y.command("browser-list").description("List available browser workflow templates").action(async()=>{try{let{BrowserWorkflowTool:t}=await import("./browser-workflow-LNNXXAJG.js"),e=await new t().invoke({});if(e.success&&e.data){console.log(o.blue(`
+Failed to cancel workflow:`),l),await a(1)}}),y.command("browser-list").description("List available browser workflow templates").action(async()=>{try{let{BrowserWorkflowTool:t}=await import("./browser-workflow-XHYAJUB6.js"),e=await new t().invoke({});if(e.success&&e.data){console.log(o.blue(`
  Browser Workflow Templates:
 `));for(let u of e.data.availableTemplates)console.log(`  ${o.cyan(u)}`);console.log("")}else console.log(o.red(`Failed: ${e.error||"Unknown error"}`));await a(0)}catch(t){console.error(o.red(`
-Failed:`),t),await a(1)}}),y.command("browser-load [template]").description("Load and validate a browser workflow template or inline YAML").option("--yaml <yaml>","Inline YAML workflow definition").option("-v, --var <key=value>","Variable override (repeatable)",P,{}).option("-F, --format <format>","Output format (text|json)","text").option("-o, --output <path>","Write output to file").action(async(t,l)=>{try{let{BrowserWorkflowTool:e}=await import("./browser-workflow-LNNXXAJG.js"),{writeOutput:u,toJSON:c}=await import("./ci-output-JLCYTIMT.js"),s=new e,f={variables:l.var||{}};if(l.yaml)f.workflowYaml=l.yaml;else if(t)if(t.endsWith(".yaml")||t.endsWith(".yml")){let i=await import("fs"),p=(await import("path")).resolve(t);i.existsSync(p)||(console.log(o.red(`
+Failed:`),t),await a(1)}}),y.command("browser-load [template]").description("Load and validate a browser workflow template or inline YAML").option("--yaml <yaml>","Inline YAML workflow definition").option("-v, --var <key=value>","Variable override (repeatable)",P,{}).option("-F, --format <format>","Output format (text|json)","text").option("-o, --output <path>","Write output to file").action(async(t,l)=>{try{let{BrowserWorkflowTool:e}=await import("./browser-workflow-XHYAJUB6.js"),{writeOutput:u,toJSON:c}=await import("./ci-output-XK4PPSN7.js"),s=new e,f={variables:l.var||{}};if(l.yaml)f.workflowYaml=l.yaml;else if(t)if(t.endsWith(".yaml")||t.endsWith(".yml")){let i=await import("fs"),p=(await import("path")).resolve(t);i.existsSync(p)||(console.log(o.red(`
 File not found: ${p}
 `)),await a(1)),f.workflowYaml=i.readFileSync(p,"utf-8")}else f.templateName=t;else console.log(o.red(`
 Provide a template name or --yaml. Use "workflow browser-list" to see templates.

package/dist/cli/chunks/workflow-orchestrator-7SKITNIJ.js

@@ -0,0 +1,2 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{a,b,c,d}from"./chunk-4BX72XG4.js";import"./chunk-GDMH7NPV.js";import"./chunk-NZGLDOU4.js";import"./chunk-K72J52JO.js";import"./chunk-U27GVYXA.js";import"./chunk-IYFMDIYZ.js";import"./chunk-HPYGMKZF.js";import"./chunk-VRE2EBFI.js";import"./chunk-UFKVKNAA.js";import"./chunk-2B6ETC7C.js";import"./chunk-PISW5HUX.js";import"./chunk-RJKYPWFD.js";import"./chunk-2G2PVVQG.js";import"./chunk-UWAUYDW4.js";import"./chunk-N3MM4Z33.js";import"./chunk-6OLHPWSN.js";import"./chunk-WI5WXYIS.js";import"./chunk-EMZ3DXMG.js";import"./chunk-MFWWPRBV.js";import"./chunk-D7IWGQTW.js";import"./chunk-SVILIQQQ.js";export{b as DEFAULT_WORKFLOW_CONFIG,a as WorkflowEvents,c as WorkflowOrchestrator,d as createWorkflowOrchestrator};

package/dist/cli/chunks/wrappers-QXOPRPR4.js

@@ -0,0 +1,2 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.10.4");process.exit(0)}
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v as L,w as M,x as N}from"./chunk-N4CXUGXE.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F,l as G,m as H,n as I,o as J,p as K}from"./chunk-C2446H7G.js";import"./chunk-NZGLDOU4.js";import"./chunk-K72J52JO.js";import"./chunk-U27GVYXA.js";import"./chunk-IYFMDIYZ.js";import"./chunk-HPYGMKZF.js";import"./chunk-VRE2EBFI.js";import"./chunk-2B6ETC7C.js";import"./chunk-RJKYPWFD.js";import"./chunk-2G2PVVQG.js";import"./chunk-UWAUYDW4.js";import"./chunk-N3MM4Z33.js";import"./chunk-6OLHPWSN.js";import"./chunk-WI5WXYIS.js";import"./chunk-EMZ3DXMG.js";import"./chunk-MFWWPRBV.js";import"./chunk-D7IWGQTW.js";import"./chunk-SVILIQQQ.js";export{z as GNNLayerFactory,i as QEFlashAttention,x as QEGNNEmbeddingIndex,y as QEGNNIndexFactory,a as QESONA,e as QE_FLASH_ATTENTION_CONFIG,g as QE_PERFORMANCE_TARGETS,f as QE_SONA_CONFIG,A as TensorCompressionFactory,u as batchComputeAttention,K as batchDifferentiableSearch,M as checkRuvectorPackagesAvailable,c as createDomainQESONA,j as createQEFlashAttention,b as createQESONA,D as getDifferentiableSearch,F as getGetCompressionLevel,E as getHierarchicalForward,G as getInit,h as getOptimalBlockConfig,k as getQEFlashAttentionConfig,n as getRuvectorDotProductAttention,m as getRuvectorFlashAttention,p as getRuvectorHyperbolicAttention,B as getRuvectorLayer,q as getRuvectorLinearAttention,r as getRuvectorMoEAttention,o as getRuvectorMultiHeadAttention,L as getRuvectorPackageVersions,C as getTensorCompress,l as getWorkloadTypes,N as initAllRuvectorPackages,w as initGNN,d as isAttentionAvailable,v as isGNNAvailable,s as toFloat32Array,H as toFloat32ArrayGNN,J as toIEmbedding,t as toNumberArrayAttn,I as toNumberArrayGNN};

package/dist/cli/commands/hooks-handlers/task-hooks.js

@@ -9,6 +9,7 @@ import chalk from 'chalk';
 import path from 'node:path';
 import { QE_HOOK_EVENTS } from '../../../learning/qe-hooks.js';
 import { findProjectRoot, getUnifiedMemory } from '../../../kernel/unified-memory.js';
+import { getNagualClient } from '../../../learning/nagual-client.js';
 import { applyHookBusyTimeout, getHooksSystem, createHybridBackendWithTimeout, incrementDreamExperience, persistTaskOutcome, updateHookRouterQValue, updateRoutingOutcomeQuality, printJson, printSuccess, } from './hooks-shared.js';
 import { ensureRoutingOutcomesAdr095Columns } from '../../../routing/routing-outcomes-migration.js';
 import { deriveTaskType } from '../../../learning/agent-routing.js';
@@ -32,6 +33,36 @@ const LOW_CONFIDENCE_THRESHOLD = 0.5;
 function hashDescription(description) {
     return createHash('sha256').update(description).digest('hex').slice(0, 16);
 }
+/**
+ * QE domains where nagual patterns add meaningful context.
+ * Skipped for trivial/short tasks to avoid latency with no benefit.
+ */
+const NAGUAL_SEARCH_DOMAINS = new Set([
+    'test-generation',
+    'coverage-analysis',
+    'defect-intelligence',
+    'security-compliance',
+    'quality-assessment',
+    'requirements-validation',
+]);
+const NAGUAL_SEARCH_MIN_DESCRIPTION_LENGTH = 80;
+/**
+ * Search nagual for relevant patterns when the task is complex enough to benefit.
+ * Returns empty array silently on any failure — always best-effort.
+ */
+async function fetchNagualContext(description, domain) {
+    if (!process.env['NAGUAL_URL'] && !process.env['NAGUAL_CLOUD_URL'] && !process.env['NAGUAL_CLOUD_KEY']) {
+        return [];
+    }
+    if (description.length < NAGUAL_SEARCH_MIN_DESCRIPTION_LENGTH) {
+        return [];
+    }
+    if (domain && !NAGUAL_SEARCH_DOMAINS.has(domain)) {
+        return [];
+    }
+    const client = getNagualClient();
+    return client.search(description.slice(0, 300), domain, 3);
+}
 /**
  * Register pre-task and post-task subcommands on the hooks command.
  */
@@ -63,6 +94,11 @@ export function registerTaskHooks(hooks) {
                 .slice(0, 5)
                 .map((p) => p?.id)
                 .filter((id) => typeof id === 'string');
+            // Nagual context: search cross-project knowledge hub for complex tasks
+            const nagualDomain = routing?.domains?.[0];
+            const nagualPatterns = options.description
+                ? await fetchNagualContext(String(options.description), nagualDomain)
+                : [];
             // Patches 090/100/160/300/320: signals derived from memory.db.
             // All best-effort: failures fall through to empty/default values.
             let historicalBest = null;
@@ -228,6 +264,14 @@ export function registerTaskHooks(hooks) {
                     lowConfidence,
                     // Bridge identifier so post-task can correlate (debug aid)
                     bridgeKey,
+                    // Nagual cross-project context
+                    nagualPatterns: nagualPatterns.map((p) => ({
+                        id: p.id,
+                        problem: p.problem,
+                        solution: p.solution.slice(0, 400),
+                        domain: p.domain,
+                        reward: p.reward,
+                    })),
                 });
             }
             else {
@@ -240,6 +284,12 @@ export function registerTaskHooks(hooks) {
                         console.log(chalk.yellow('  ⚠  Low confidence — consider providing more context'));
                     }
                 }
+                if (nagualPatterns.length > 0) {
+                    console.log(chalk.bold('\n📚 Nagual context (cross-project):'));
+                    for (const p of nagualPatterns) {
+                        console.log(chalk.dim(`  [${p.domain}] ${p.problem.slice(0, 80)} (reward: ${p.reward.toFixed(2)})`));
+                    }
+                }
             }
             return;
         }

package/dist/integrations/ruvector/shared-rvf-adapter.js

@@ -10,6 +10,9 @@
  *
  * @module integrations/ruvector/shared-rvf-adapter
  */
+// Issue #516: lightweight, sqlite-free project-root resolver (static import so it
+// resolves under the test runner; avoids pulling unified-memory's sqlite graph).
+import { findProjectRoot } from '../../kernel/project-root.js';
 let sharedAdapter = null;
 let initAttempted = false;
 // ---------------------------------------------------------------------------
@@ -62,7 +65,15 @@ export function getSharedRvfAdapter(dataDir = '.agentic-qe', dimensions = 384) {
         }
         // eslint-disable-next-line @typescript-eslint/no-require-imports
         const path = require('path');
-        const rvfPath = path.join(dataDir, 'patterns.rvf');
+        // Issue #516: resolve a relative dataDir against the project root so the
+        // store lands in the project's own .agentic-qe/, not a cwd-relative one.
+        // A subfolder cwd (vendored builds, background workers, `aqe code index
+        // docs/`) otherwise scatters stray patterns.rvf-only stores. Explicit
+        // absolute dataDir args are honored as-is.
+        const baseDir = path.isAbsolute(dataDir)
+            ? dataDir
+            : path.join(process.env.AQE_PROJECT_ROOT ?? findProjectRoot(), dataDir);
+        const rvfPath = path.join(baseDir, 'patterns.rvf');
         // Open-or-create with a try-ladder rather than `existsSync` gate.
         // Reasons:
         //  1. RVF native's `RvfDatabase.create()` throws `0x0303 FsyncFailed`

package/dist/integrations/ruvector/shared-rvf-dual-writer.js

@@ -56,16 +56,20 @@ export async function getSharedRvfDualWriter() {
                 return null;
             }
             // Get DB handle from unified memory
-            const { getUnifiedMemory } = await import('../../kernel/unified-memory.js');
+            const { getUnifiedMemory, findProjectRoot } = await import('../../kernel/unified-memory.js');
             const unifiedMemory = getUnifiedMemory();
             const db = unifiedMemory.getDatabase();
             if (!db) {
                 return null;
             }
+            // Issue #516: anchor brain.rvf to the project root rather than a
+            // cwd-relative path, so a subfolder cwd doesn't scatter a stray store.
+            const { join: joinPath } = await import('node:path');
+            const rvfPath = joinPath(process.env.AQE_PROJECT_ROOT ?? findProjectRoot(), '.agentic-qe', 'brain.rvf');
             // Create dual-writer (dynamic import to avoid bundling .node files)
             const { RvfDualWriter: DualWriterClass } = await import('./rvf-dual-writer.js');
             const writer = new DualWriterClass(db, {
-                rvfPath: '.agentic-qe/brain.rvf',
+                rvfPath,
                 mode: 'dual-write',
                 dimensions: 384,
             });

package/dist/kernel/project-root.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Project Root Detection
+ *
+ * Lightweight, dependency-free resolution of the AQE project root. Kept in its
+ * own module (no SQLite / kernel imports) so hot paths — e.g. the RVF pattern
+ * store factory — can import it statically without dragging in the sqlite-heavy
+ * unified-memory graph, and so it resolves cleanly under the test runner.
+ *
+ * `unified-memory` re-exports `findProjectRoot` / `clearProjectRootCache` for
+ * backward compatibility, so existing import sites keep working.
+ *
+ * @module kernel/project-root
+ */
+/**
+ * Clear the cached project root. Useful for testing or when the
+ * environment changes at runtime.
+ */
+export declare function clearProjectRootCache(): void;
+/**
+ * Find the project root by walking up the directory tree.
+ *
+ * Priority order:
+ * 1. AQE_PROJECT_ROOT environment variable (set by MCP config or init)
+ * 2. Walk up looking for the NEAREST .agentic-qe directory (existing AQE project)
+ * 3. Walk up looking for .git directory (git repo root)
+ * 4. Walk up looking for package.json WITHOUT node_modules sibling (monorepo root)
+ * 5. Fallback to current working directory
+ *
+ * Optimized: single upward walk checks all markers in one pass,
+ * and the result is cached at module level for subsequent calls.
+ */
+export declare function findProjectRoot(startDir?: string): string;
+//# sourceMappingURL=project-root.d.ts.map

package/dist/kernel/project-root.js

@@ -0,0 +1,86 @@
+/**
+ * Project Root Detection
+ *
+ * Lightweight, dependency-free resolution of the AQE project root. Kept in its
+ * own module (no SQLite / kernel imports) so hot paths — e.g. the RVF pattern
+ * store factory — can import it statically without dragging in the sqlite-heavy
+ * unified-memory graph, and so it resolves cleanly under the test runner.
+ *
+ * `unified-memory` re-exports `findProjectRoot` / `clearProjectRootCache` for
+ * backward compatibility, so existing import sites keep working.
+ *
+ * @module kernel/project-root
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/** Module-level cache for findProjectRoot result. */
+let _cachedProjectRoot = null;
+/**
+ * Clear the cached project root. Useful for testing or when the
+ * environment changes at runtime.
+ */
+export function clearProjectRootCache() {
+    _cachedProjectRoot = null;
+}
+/**
+ * Find the project root by walking up the directory tree.
+ *
+ * Priority order:
+ * 1. AQE_PROJECT_ROOT environment variable (set by MCP config or init)
+ * 2. Walk up looking for the NEAREST .agentic-qe directory (existing AQE project)
+ * 3. Walk up looking for .git directory (git repo root)
+ * 4. Walk up looking for package.json WITHOUT node_modules sibling (monorepo root)
+ * 5. Fallback to current working directory
+ *
+ * Optimized: single upward walk checks all markers in one pass,
+ * and the result is cached at module level for subsequent calls.
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    if (_cachedProjectRoot) {
+        return _cachedProjectRoot;
+    }
+    if (process.env.AQE_PROJECT_ROOT) {
+        _cachedProjectRoot = process.env.AQE_PROJECT_ROOT;
+        return _cachedProjectRoot;
+    }
+    const dir = startDir;
+    const root = path.parse(dir).root;
+    let checkDir = dir;
+    let nearestAqeDir = null;
+    let lowestGitDir = null;
+    let topmostPackageJson = null;
+    while (checkDir !== root) {
+        // Issue #516: prefer the NEAREST (lowest) .agentic-qe, mirroring the
+        // .git logic below. Keeping the topmost match let an ancestor store
+        // (e.g. ~/.agentic-qe, created by any `aqe` run from $HOME) hijack
+        // every descendant project and fragment its learning into $HOME.
+        if (fs.existsSync(path.join(checkDir, '.agentic-qe'))) {
+            if (nearestAqeDir === null) {
+                nearestAqeDir = checkDir;
+            }
+        }
+        if (fs.existsSync(path.join(checkDir, '.git'))) {
+            if (lowestGitDir === null) {
+                lowestGitDir = checkDir;
+            }
+        }
+        if (fs.existsSync(path.join(checkDir, 'package.json'))) {
+            topmostPackageJson = checkDir;
+        }
+        checkDir = path.dirname(checkDir);
+    }
+    if (nearestAqeDir) {
+        _cachedProjectRoot = nearestAqeDir;
+    }
+    else if (lowestGitDir) {
+        _cachedProjectRoot = lowestGitDir;
+    }
+    else if (topmostPackageJson) {
+        _cachedProjectRoot = topmostPackageJson;
+    }
+    else {
+        _cachedProjectRoot = process.cwd();
+    }
+    return _cachedProjectRoot;
+}
+//# sourceMappingURL=project-root.js.map

package/dist/kernel/unified-memory.d.ts

@@ -25,25 +25,8 @@ import { type Database as DatabaseType, type Statement } from 'better-sqlite3';
 export { validateTableName, ALLOWED_TABLE_NAMES } from '../shared/sql-safety.js';
 export { BinaryHeap, UnifiedHnswIndex, createHnswIndex } from './unified-memory-hnsw.js';
 import { type CRDTStore, type CRDTStoreState, type CRDTStoreDelta } from '../memory/crdt/index.js';
-/**
- * Clear the cached project root. Useful for testing or when the
- * environment changes at runtime.
- */
-export declare function clearProjectRootCache(): void;
-/**
- * Find the project root by walking up the directory tree.
- *
- * Priority order:
- * 1. AQE_PROJECT_ROOT environment variable (set by MCP config or init)
- * 2. Walk up looking for .agentic-qe directory (existing AQE project)
- * 3. Walk up looking for .git directory (git repo root)
- * 4. Walk up looking for package.json WITHOUT node_modules sibling (monorepo root)
- * 5. Fallback to current working directory
- *
- * Optimized: single upward walk checks all markers in one pass,
- * and the result is cached at module level for subsequent calls.
- */
-export declare function findProjectRoot(startDir?: string): string;
+import { findProjectRoot, clearProjectRootCache } from './project-root.js';
+export { findProjectRoot, clearProjectRootCache };
 /**
  * Get the default database path using project root detection.
  * Always resolves to {project_root}/.agentic-qe/memory.db

package/dist/kernel/unified-memory.js

@@ -46,70 +46,14 @@ import { createCRDTStore, } from '../memory/crdt/index.js';
 // ============================================================================
 // Project Root Detection
 // ============================================================================
-/** Module-level cache for findProjectRoot result. */
-let _cachedProjectRoot = null;
-/**
- * Clear the cached project root. Useful for testing or when the
- * environment changes at runtime.
- */
-export function clearProjectRootCache() {
-    _cachedProjectRoot = null;
-}
-/**
- * Find the project root by walking up the directory tree.
- *
- * Priority order:
- * 1. AQE_PROJECT_ROOT environment variable (set by MCP config or init)
- * 2. Walk up looking for .agentic-qe directory (existing AQE project)
- * 3. Walk up looking for .git directory (git repo root)
- * 4. Walk up looking for package.json WITHOUT node_modules sibling (monorepo root)
- * 5. Fallback to current working directory
- *
- * Optimized: single upward walk checks all markers in one pass,
- * and the result is cached at module level for subsequent calls.
- */
-export function findProjectRoot(startDir = process.cwd()) {
-    if (_cachedProjectRoot) {
-        return _cachedProjectRoot;
-    }
-    if (process.env.AQE_PROJECT_ROOT) {
-        _cachedProjectRoot = process.env.AQE_PROJECT_ROOT;
-        return _cachedProjectRoot;
-    }
-    const dir = startDir;
-    const root = path.parse(dir).root;
-    let checkDir = dir;
-    let topmostAqeDir = null;
-    let lowestGitDir = null;
-    let topmostPackageJson = null;
-    while (checkDir !== root) {
-        if (fs.existsSync(path.join(checkDir, '.agentic-qe'))) {
-            topmostAqeDir = checkDir;
-        }
-        if (fs.existsSync(path.join(checkDir, '.git'))) {
-            if (lowestGitDir === null) {
-                lowestGitDir = checkDir;
-            }
-        }
-        if (fs.existsSync(path.join(checkDir, 'package.json'))) {
-            topmostPackageJson = checkDir;
-        }
-        checkDir = path.dirname(checkDir);
-    }
-    if (topmostAqeDir) {
-        _cachedProjectRoot = topmostAqeDir;
-    }
-    else if (lowestGitDir) {
-        _cachedProjectRoot = lowestGitDir;
-    }
-    else if (topmostPackageJson) {
-        _cachedProjectRoot = topmostPackageJson;
-    }
-    else {
-        _cachedProjectRoot = process.cwd();
-    }
-    return _cachedProjectRoot;
-}
+// Issue #516: findProjectRoot / clearProjectRootCache live in a lightweight,
+// sqlite-free module so RVF hot paths can import them statically without
+// pulling in this sqlite-heavy module. Re-exported here for backward compat —
+// existing `import { findProjectRoot } from '.../unified-memory.js'` sites keep
+// working unchanged. Imported (not bare re-exported) so internal callers below
+// have a usable local binding.
+import { findProjectRoot, clearProjectRootCache } from './project-root.js';
+export { findProjectRoot, clearProjectRootCache };
 /**
  * Get the default database path using project root detection.
  * Always resolves to {project_root}/.agentic-qe/memory.db

package/dist/learning/local-judge-client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Agentic QE v3 - Local LLM Judge Client
+ *
+ * Scores QE patterns for coherence, specificity, and reusability using a
+ * locally running Ollama-compatible LLM (OpenAI chat completions API).
+ *
+ * Reward blending: final_reward = 0.7 * outcome_reward + 0.3 * judge_score
+ * Escalation: score in [0.4, 0.6] → logged for human review (ambiguous zone)
+ *
+ * Env vars (all optional — client is disabled if none set):
+ *   NAGUAL_JUDGE_URL    — base URL of Ollama server (default: http://localhost:11434)
+ *   NAGUAL_JUDGE_MODEL  — model to use (default: qwen3:8b)
+ *
+ * Supported models (in preference order for M-series Macs):
+ *   gemma4:12b-mlx  — 10GB, MLX-optimised, best quality on Apple Silicon
+ *   qwen3:8b        — 5.2GB, strong reasoning, already installed
+ *   qwen3:30b-a3b   — 18GB, highest quality, use only if RAM permits
+ */
+/** Output of a judge evaluation. */
+export interface JudgeResult {
+    /** Quality score in [0, 1]. */
+    score: number;
+    /** One-sentence reasoning from the model. */
+    reason: string;
+    /** Model that produced the score. */
+    model: string;
+    /** True if score falls in the ambiguous zone [0.4, 0.6]. */
+    needsReview: boolean;
+}
+/**
+ * Blend an outcome reward with a judge score.
+ * final = 0.7 * outcomeReward + 0.3 * judgeScore
+ * Falls back to outcomeReward if judgeResult is null (judge unavailable).
+ */
+export declare function blendReward(outcomeReward: number, judgeResult: JudgeResult | null): number;
+/**
+ * Local LLM judge using OpenAI-compatible chat completions.
+ * Disabled automatically when NAGUAL_JUDGE_URL and NAGUAL_JUDGE_MODEL are both unset.
+ */
+export declare class LocalJudgeClient {
+    readonly baseUrl: string;
+    readonly model: string;
+    readonly enabled: boolean;
+    constructor(opts?: {
+        url?: string;
+        model?: string;
+    });
+    /**
+     * Score a piece of text (pattern problem+solution) for QE quality.
+     * Returns null if judge is disabled or unavailable — callers use outcomeReward as-is.
+     */
+    score(text: string): Promise<JudgeResult | null>;
+}
+export declare function getLocalJudgeClient(): LocalJudgeClient;
+//# sourceMappingURL=local-judge-client.d.ts.map

package/dist/learning/local-judge-client.js

@@ -0,0 +1,127 @@
+/**
+ * Agentic QE v3 - Local LLM Judge Client
+ *
+ * Scores QE patterns for coherence, specificity, and reusability using a
+ * locally running Ollama-compatible LLM (OpenAI chat completions API).
+ *
+ * Reward blending: final_reward = 0.7 * outcome_reward + 0.3 * judge_score
+ * Escalation: score in [0.4, 0.6] → logged for human review (ambiguous zone)
+ *
+ * Env vars (all optional — client is disabled if none set):
+ *   NAGUAL_JUDGE_URL    — base URL of Ollama server (default: http://localhost:11434)
+ *   NAGUAL_JUDGE_MODEL  — model to use (default: qwen3:8b)
+ *
+ * Supported models (in preference order for M-series Macs):
+ *   gemma4:12b-mlx  — 10GB, MLX-optimised, best quality on Apple Silicon
+ *   qwen3:8b        — 5.2GB, strong reasoning, already installed
+ *   qwen3:30b-a3b   — 18GB, highest quality, use only if RAM permits
+ */
+import { LoggerFactory } from '../logging/index.js';
+const logger = LoggerFactory.create('local-judge');
+const DEFAULT_URL = 'http://localhost:11434';
+const DEFAULT_MODEL = 'qwen3:8b';
+const JUDGE_TIMEOUT_MS = 30_000;
+const MAX_TEXT_LENGTH = 600;
+// Thinking models (gemma4, qwen3) need extra tokens to finish reasoning before output
+const MAX_TOKENS = 600;
+/** Score in this range is ambiguous — flagged for human review. */
+const AMBIGUOUS_LOW = 0.4;
+const AMBIGUOUS_HIGH = 0.6;
+/**
+ * Blend an outcome reward with a judge score.
+ * final = 0.7 * outcomeReward + 0.3 * judgeScore
+ * Falls back to outcomeReward if judgeResult is null (judge unavailable).
+ */
+export function blendReward(outcomeReward, judgeResult) {
+    if (judgeResult === null)
+        return outcomeReward;
+    return 0.7 * outcomeReward + 0.3 * judgeResult.score;
+}
+/**
+ * Local LLM judge using OpenAI-compatible chat completions.
+ * Disabled automatically when NAGUAL_JUDGE_URL and NAGUAL_JUDGE_MODEL are both unset.
+ */
+export class LocalJudgeClient {
+    baseUrl;
+    model;
+    enabled;
+    constructor(opts) {
+        this.baseUrl = opts?.url ?? process.env['NAGUAL_JUDGE_URL'] ?? DEFAULT_URL;
+        this.model = opts?.model ?? process.env['NAGUAL_JUDGE_MODEL'] ?? DEFAULT_MODEL;
+        // Only active when explicitly configured via env or constructor options
+        this.enabled = Boolean(opts?.url ?? opts?.model ??
+            process.env['NAGUAL_JUDGE_URL'] ??
+            process.env['NAGUAL_JUDGE_MODEL']);
+    }
+    /**
+     * Score a piece of text (pattern problem+solution) for QE quality.
+     * Returns null if judge is disabled or unavailable — callers use outcomeReward as-is.
+     */
+    async score(text) {
+        if (!this.enabled)
+            return null;
+        const truncated = text.slice(0, MAX_TEXT_LENGTH);
+        const prompt = [
+            'You are a QE pattern quality judge.',
+            'Rate the following pattern for: coherence, specificity, and reusability in a software quality engineering context.',
+            'Reply with valid JSON only, no other text: {"score": <float 0.0-1.0>, "reason": "<one sentence>"}',
+            '',
+            `Pattern:\n${truncated}`,
+        ].join('\n');
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.model,
+                    messages: [{ role: 'user', content: prompt }],
+                    temperature: 0.1,
+                    max_tokens: MAX_TOKENS,
+                }),
+                signal: AbortSignal.timeout(JUDGE_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                logger.debug('judge request failed', { status: response.status, model: this.model });
+                return null;
+            }
+            const data = await response.json();
+            const msg = data.choices?.[0]?.message;
+            // Thinking models (gemma4, qwen3) emit final answer in content; reasoning
+            // holds the internal chain-of-thought. Fall back to reasoning if content empty.
+            const rawText = (msg?.content ?? '') || (msg?.reasoning ?? '');
+            // Strip markdown code fences before parsing
+            const cleaned = rawText.replace(/```[\w]*\n?/g, '').replace(/```/g, '');
+            // Extract first JSON object — handles multiline values via [\s\S] inside quotes
+            const jsonMatch = cleaned.match(/\{[\s\S]*?"score"[\s\S]*?\}/);
+            if (!jsonMatch) {
+                logger.debug('judge response had no JSON', { rawText: rawText.slice(0, 150) });
+                return null;
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (typeof parsed.score !== 'number')
+                return null;
+            const score = Math.max(0, Math.min(1, parsed.score));
+            const reason = typeof parsed.reason === 'string' ? parsed.reason : '';
+            const needsReview = score >= AMBIGUOUS_LOW && score <= AMBIGUOUS_HIGH;
+            if (needsReview) {
+                logger.info('[SurpriseReview] ambiguous judge score — flag for human review', {
+                    score,
+                    reason,
+                    model: this.model,
+                });
+            }
+            return { score, reason, model: this.model, needsReview };
+        }
+        catch (err) {
+            logger.debug('judge unavailable (non-fatal)', { err, model: this.model });
+            return null;
+        }
+    }
+}
+let _instance;
+export function getLocalJudgeClient() {
+    if (!_instance)
+        _instance = new LocalJudgeClient();
+    return _instance;
+}
+//# sourceMappingURL=local-judge-client.js.map