agentic-qe 3.9.32 → 3.9.34

package/dist/cli/chunks/{workflow-RNSDKRZ4.js → workflow-BVMZE2FE.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.9.32");process.exit(0)}
-import"./chunk-7PTW3M67.js";import{b as $}from"./chunk-PPS6VN24.js";import{d as R}from"./chunk-PQAYCK2U.js";import{b as k,c as C,d as b}from"./chunk-NVZHCAEB.js";import{c as W}from"./chunk-OK2TFTXP.js";import"./chunk-EFEJLZDN.js";import"./chunk-5WR42V5O.js";import"./chunk-XHQFVTFD.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.9.34");process.exit(0)}
+import"./chunk-45SJSOSI.js";import{b as $}from"./chunk-4AIJOXQJ.js";import{d as R}from"./chunk-HIZWO4J3.js";import{b as k,c as C,d as b}from"./chunk-GCMCU54O.js";import{c as W}from"./chunk-VR65KHTH.js";import"./chunk-4YDLD5TW.js";import"./chunk-I74WDBHS.js";import"./chunk-6FNPEC2I.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-SGOL3FCJ.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-DAGIWFJE.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-SGOL3FCJ.js"),{writeOutput:u,toJSON:c}=await import("./ci-output-ZPDJ42U3.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-DAGIWFJE.js"),{writeOutput:u,toJSON:c}=await import("./ci-output-TDKJNSD4.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-VGNC5PFE.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.9.34");process.exit(0)}
+import{a,b,c,d}from"./chunk-53Y6ZKPN.js";import"./chunk-AHEHD3AP.js";import"./chunk-PYQ7VCH2.js";import"./chunk-DXKZQYBK.js";import"./chunk-VR65KHTH.js";import"./chunk-DXOFPU3A.js";import"./chunk-PMFV3ZFP.js";import"./chunk-4YDLD5TW.js";import"./chunk-I74WDBHS.js";import"./chunk-5H44TVAY.js";import"./chunk-IPEUGCUK.js";import"./chunk-EPETDHDV.js";import"./chunk-JH5HQ2HW.js";import"./chunk-YIVJD5IY.js";import"./chunk-QX74JLGO.js";import"./chunk-REVCXO2R.js";import"./chunk-RYFQYSVF.js";import"./chunk-IUZNVWCR.js";import"./chunk-QPH72S4A.js";import"./chunk-6FNPEC2I.js";export{b as DEFAULT_WORKFLOW_CONFIG,a as WorkflowEvents,c as WorkflowOrchestrator,d as createWorkflowOrchestrator};

package/dist/cli/chunks/{wrappers-J7RXMIOY.js → wrappers-SEDAPKCG.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.9.32");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-4H4PEZUX.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-OKEHGXIS.js";import"./chunk-THYGFSTA.js";import"./chunk-ONNTJXU7.js";import"./chunk-OK2TFTXP.js";import"./chunk-YVQ4PR4H.js";import"./chunk-OMOGD2NN.js";import"./chunk-5WR42V5O.js";import"./chunk-4VAZSCTZ.js";import"./chunk-H7YKTJMY.js";import"./chunk-PIXUX2NR.js";import"./chunk-MQQANXFS.js";import"./chunk-BBPOTFIY.js";import"./chunk-YJV6TTCW.js";import"./chunk-HGWQC7PR.js";import"./chunk-ZESMMAKZ.js";import"./chunk-33PGBYTC.js";import"./chunk-XHQFVTFD.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};
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.9.34");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-ULXDULD6.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-2C6LRXLU.js";import"./chunk-PYQ7VCH2.js";import"./chunk-DXKZQYBK.js";import"./chunk-VR65KHTH.js";import"./chunk-DXOFPU3A.js";import"./chunk-PMFV3ZFP.js";import"./chunk-I74WDBHS.js";import"./chunk-IPEUGCUK.js";import"./chunk-EPETDHDV.js";import"./chunk-JH5HQ2HW.js";import"./chunk-YIVJD5IY.js";import"./chunk-QX74JLGO.js";import"./chunk-REVCXO2R.js";import"./chunk-RYFQYSVF.js";import"./chunk-IUZNVWCR.js";import"./chunk-QPH72S4A.js";import"./chunk-6FNPEC2I.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/hooks-shared.js

@@ -182,29 +182,20 @@ export async function createHybridBackendWithTimeout(dataDir) {
         enableFallback: true,
         defaultNamespace: 'qe-patterns',
     });
-    // HybridMemoryBackend.initialize() does not accept an AbortSignal yet
-    // (separate refactor). Use Promise.race for the timeout, but if the
-    // timeout wins, dispose the backend once init resolves so we don't leak
-    // SQLite/WAL handles in the background (issue #478 family).
-    let timedOut = false;
-    const initPromise = backend.initialize();
-    const timeoutPromise = new Promise((_, reject) => setTimeout(() => {
-        timedOut = true;
-        reject(new Error('Backend init timeout'));
-    }, timeoutMs));
+    // Issue #495: bound HybridMemoryBackend.initialize() with an AbortSignal —
+    // the previous Promise.race-based timeout could not stop the underlying
+    // work, so a stuck unified-memory init kept running for 14+ min while the
+    // hook subprocess held patterns.rvf open (20 GB / 12 MB/s leak reported in
+    // the field). HybridMemoryBackend.initialize() now checks
+    // `signal.throwIfAborted()` between awaited steps, so an aborted signal
+    // actually stops the work instead of leaking a promise into the void.
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error('Backend init timeout')), timeoutMs);
     try {
-        await Promise.race([initPromise, timeoutPromise]);
+        await backend.initialize({ signal: controller.signal });
     }
-    catch (err) {
-        if (timedOut) {
-            // Tear down the backend after the leaked init completes so its
-            // SQLite connections, WAL handles, and pool entries are released.
-            // .catch() prevents "unhandled rejection" if dispose itself throws.
-            void initPromise
-                .then(() => backend.dispose())
-                .catch(() => undefined);
-        }
-        throw err;
+    finally {
+        clearTimeout(timer);
     }
     return backend;
 }

package/dist/cli/handlers/init-handler.js

@@ -4,6 +4,7 @@
  * Handles the 'aqe init' command for system initialization.
  */
 import chalk from 'chalk';
+import { createRequire } from 'node:module';
 import { ALL_DOMAINS } from '../../shared/types/index.js';
 import { toErrorMessage } from '../../shared/error-utils.js';
 // ============================================================================
@@ -227,6 +228,7 @@ export class InitHandler {
                 console.log(chalk.gray('\n  MCP server configured in .mcp.json'));
                 console.log(chalk.gray('    Use --no-mcp to skip MCP setup if using CLI only\n'));
             }
+            printOptionalPeerHints();
         }
         else {
             console.log(chalk.red('  Initialization failed. Check errors above.\n'));
@@ -282,6 +284,7 @@ export class InitHandler {
                 console.log(chalk.gray('\n  MCP server configured in .mcp.json'));
                 console.log(chalk.gray('    Use --no-mcp to skip MCP setup if using CLI only\n'));
             }
+            printOptionalPeerHints();
         }
         else {
             console.log(chalk.red('  Initialization failed. Check errors above.\n'));
@@ -419,6 +422,50 @@ Examples:
     }
 }
 // ============================================================================
+// Optional peer-dep hints
+// ============================================================================
+// Declared in package.json's peerDependenciesMeta. NOT auto-installed because
+// they each pull @claude-flow/cli@3.6.x, whose internal peer mismatch creates
+// ~480 packages of transitive noise and ERESOLVE warnings during npm install.
+// Users opt into them only when they want the feature.
+const OPTIONAL_PEERS = [
+    {
+        pkg: '@claude-flow/browser',
+        version: '3.0.0-alpha.1',
+        enables: 'browser MCP server — URL safety + PII scanning in browser flows',
+    },
+    {
+        pkg: '@claude-flow/guidance',
+        version: '3.0.0-alpha.1',
+        enables: 'governance — trust accumulator, continue-gate, proof envelope',
+    },
+];
+function isPeerInstalled(pkg) {
+    const require = createRequire(import.meta.url);
+    try {
+        require.resolve(pkg);
+        return true;
+    }
+    catch (err) {
+        // ERR_PACKAGE_PATH_NOT_EXPORTED means the package IS installed but its
+        // `exports` field has no CJS condition for the bare specifier — still
+        // counts as installed for our purposes.
+        const code = err?.code;
+        return code === 'ERR_PACKAGE_PATH_NOT_EXPORTED';
+    }
+}
+function printOptionalPeerHints() {
+    const missing = OPTIONAL_PEERS.filter(({ pkg }) => !isPeerInstalled(pkg));
+    if (missing.length === 0)
+        return;
+    console.log(chalk.bold('\n  Optional add-ons (install only if you want the feature):'));
+    for (const { pkg, version, enables } of missing) {
+        console.log(`    ${chalk.gray(pkg)} ${chalk.dim('— ' + enables)}`);
+        console.log(chalk.cyan(`      npm install -g ${pkg}@${version}`));
+    }
+    console.log('');
+}
+// ============================================================================
 // Factory
 // ============================================================================
 export function createInitHandler(cleanupAndExit) {

package/dist/domains/learning-optimization/coordinator-helpers.js

@@ -6,6 +6,7 @@
  * domain relationships, pattern similarity, checksum
  */
 import { ok, ALL_DOMAINS, } from '../../shared/types/index.js';
+import { rehydrateDates } from '../../shared/utils/kv-date-rehydrate.js';
 /**
  * Get experiences for a specific domain within a time range
  */
@@ -15,7 +16,12 @@ export async function getExperiencesForDomain(memory, domain, timeRange) {
     for (const key of keys) {
         const experienceId = await memory.get(key);
         if (experienceId) {
-            const experience = await memory.get(`learning:experience:${experienceId}`);
+            // #493: rehydrate timestamp at the kv-read seam. Without this,
+            // `timeRange.contains(experience.timestamp)` silently filters every
+            // experience out — `string >= Date` coerces to NaN, all comparisons
+            // false. Same root cause the team patched at
+            // learning-coordinator.ts:898-904 (#491 Bug 3).
+            const experience = rehydrateDates(await memory.get(`learning:experience:${experienceId}`), ['timestamp']);
             if (experience && timeRange.contains(experience.timestamp)) {
                 experiences.push(experience);
             }

package/dist/domains/learning-optimization/coordinator.js

@@ -5,6 +5,7 @@
 import { LoggerFactory } from '../../logging/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { toError } from '../../shared/error-utils.js';
+import { rehydrateDates } from '../../shared/utils/kv-date-rehydrate.js';
 import { ok, err, ALL_DOMAINS, } from '../../shared/types/index.js';
 import { TimeRange } from '../../shared/value-objects/index.js';
 import { LearningOptimizationEvents, createEvent, } from '../../shared/events/domain-events.js';
@@ -1191,7 +1192,10 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
         for (const key of keys) {
             const experienceId = await this.memory.get(key);
             if (experienceId) {
-                const experience = await this.memory.get(`learning:experience:${experienceId}`);
+                // #493: rehydrate timestamp at the kv-read seam — without this,
+                // `timeRange.contains` silently filters every experience out
+                // (string vs Date coerces to NaN). Same root cause as #491 Bug 3.
+                const experience = rehydrateDates(await this.memory.get(`learning:experience:${experienceId}`), ['timestamp']);
                 if (experience && timeRange.contains(experience.timestamp)) {
                     experiences.push(experience);
                 }

package/dist/domains/learning-optimization/services/learning-coordinator.js

@@ -5,6 +5,7 @@
 import { LoggerFactory } from '../../../logging/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
+import { rehydrateDates } from '../../../shared/utils/kv-date-rehydrate.js';
 import { toError } from '../../../shared/error-utils.js';
 import { createQEFlashAttention, } from '../../../integrations/ruvector/wrappers.js';
 const DEFAULT_CONFIG = {
@@ -538,7 +539,11 @@ Provide:
             for (const key of keys) {
                 const experienceId = await this.memory.get(key, LEARNING_NS);
                 if (experienceId) {
-                    const experience = await this.memory.get(`learning:experience:${experienceId}`, LEARNING_NS);
+                    // #493: rehydrate `timestamp` at the kv-read seam — the sort
+                    // below throws once the replay buffer has any kv-stored entries.
+                    // Same hazard the team already noted in mineExperiences at
+                    // learning-coordinator.ts:898-904 (#491 Bug 3).
+                    const experience = rehydrateDates(await this.memory.get(`learning:experience:${experienceId}`, LEARNING_NS), ['timestamp']);
                     if (experience) {
                         experiences.push(experience);
                     }

package/dist/domains/learning-optimization/services/metrics-optimizer.js

@@ -6,6 +6,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
 import { toError } from '../../../shared/error-utils.js';
 import { secureRandom } from '../../../shared/utils/crypto-random.js';
+import { rehydrateDates } from '../../../shared/utils/kv-date-rehydrate.js';
 const DEFAULT_CONFIG = {
     defaultConfidenceLevel: 0.95,
     minSamplesForOptimization: 20,
@@ -252,7 +253,9 @@ export class MetricsOptimizerService {
             const keys = await this.memory.search(`learning:metrics:history:${strategyId}:*`, limit);
             const snapshots = [];
             for (const key of keys) {
-                const snapshot = await this.memory.get(key);
+                // #493: rehydrate `timestamp` at the kv-read seam — without this,
+                // the sort below throws once any snapshot exists in the kv.
+                const snapshot = rehydrateDates(await this.memory.get(key), ['timestamp']);
                 if (snapshot) {
                     snapshots.push(snapshot);
                 }

package/dist/domains/learning-optimization/services/production-intel.js

@@ -6,6 +6,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
 import { TimeRange } from '../../../shared/value-objects/index.js';
 import { toError } from '../../../shared/error-utils.js';
+import { rehydrateDates } from '../../../shared/utils/kv-date-rehydrate.js';
 const DEFAULT_CONFIG = {
     metricsRetentionDays: 90,
     anomalyThreshold: 2.5,
@@ -91,7 +92,11 @@ export class ProductionIntelService {
             for (const key of keys) {
                 const metricId = await this.memory.get(key);
                 if (metricId) {
-                    const metric = await this.memory.get(`production:metric:${metricId}`);
+                    // #493: rehydrate Date fields at the kv-read seam. Without this,
+                    // `metric.timestamp` arrives as an ISO string after JSON.parse —
+                    // `timeRange.contains` silently drops every metric (string vs Date
+                    // coercion yields NaN) and `.getTime()` below throws.
+                    const metric = rehydrateDates(await this.memory.get(`production:metric:${metricId}`), ['timestamp']);
                     if (metric && timeRange.contains(metric.timestamp)) {
                         metrics.push(metric);
                     }
@@ -138,7 +143,9 @@ export class ProductionIntelService {
      */
     async resolveIncident(incidentId, rootCause, resolution) {
         try {
-            const incident = await this.memory.get(`production:incident:${incidentId}`);
+            // #493: rehydrate before spreading — `incident.startedAt` is consumed
+            // downstream by updateExperienceWithResolution → .getTime() math.
+            const incident = rehydrateDates(await this.memory.get(`production:incident:${incidentId}`), ['startedAt', 'resolvedAt']);
             if (!incident) {
                 return err(new Error(`Incident ${incidentId} not found`));
             }
@@ -171,14 +178,15 @@ export class ProductionIntelService {
                 if (key.includes(':index:')) {
                     const incidentId = await this.memory.get(key);
                     if (incidentId) {
-                        const incident = await this.memory.get(`production:incident:${incidentId}`);
+                        // #493: rehydrate startedAt/resolvedAt at the kv-read seam.
+                        const incident = rehydrateDates(await this.memory.get(`production:incident:${incidentId}`), ['startedAt', 'resolvedAt']);
                         if (incident) {
                             incidents.push(incident);
                         }
                     }
                 }
                 else {
-                    const incident = await this.memory.get(key);
+                    const incident = rehydrateDates(await this.memory.get(key), ['startedAt', 'resolvedAt']);
                     if (incident) {
                         incidents.push(incident);
                     }
@@ -426,7 +434,8 @@ export class ProductionIntelService {
             const keys = await this.memory.search('production:milestone:*', limit);
             const milestones = [];
             for (const key of keys) {
-                const milestone = await this.memory.get(key);
+                // #493: rehydrate achievedAt at the kv-read seam.
+                const milestone = rehydrateDates(await this.memory.get(key), ['achievedAt']);
                 if (milestone) {
                     milestones.push(milestone);
                 }

package/dist/domains/learning-optimization/services/transfer-specialist.js

@@ -5,6 +5,7 @@
 import { v4 as uuidv4 } from 'uuid';
 import { ok, err, ALL_DOMAINS } from '../../../shared/types/index.js';
 import { toError } from '../../../shared/error-utils.js';
+import { rehydrateDates } from '../../../shared/utils/kv-date-rehydrate.js';
 const DEFAULT_CONFIG = {
     maxKnowledgeItems: 1000,
     relevanceThreshold: 0.5,
@@ -64,7 +65,11 @@ export class TransferSpecialistService {
                 keys = await this.memory.search('learning:knowledge:shared:*', query.limit || 100);
             }
             for (const key of keys) {
-                const knowledge = await this.memory.get(key);
+                // #493: rehydrate Date fields at the kv-read seam. `createdAt` is
+                // consumed by validateRelevance().getTime() and `expiresAt` is
+                // compared via `new Date() > knowledge.expiresAt` — both broken
+                // when the field is a string after JSON round-trip.
+                const knowledge = rehydrateDates(await this.memory.get(key), ['createdAt', 'expiresAt']);
                 if (knowledge && this.matchesQuery(knowledge, query)) {
                     results.push(knowledge);
                 }
@@ -75,7 +80,8 @@ export class TransferSpecialistService {
             if (query.embedding && query.embedding.length > 0) {
                 const vectorResults = await this.memory.vectorSearch(query.embedding, query.limit || 10);
                 for (const vr of vectorResults) {
-                    const knowledge = await this.memory.get(vr.key);
+                    // #493: rehydrate Date fields at the kv-read seam.
+                    const knowledge = rehydrateDates(await this.memory.get(vr.key), ['createdAt', 'expiresAt']);
                     if (knowledge &&
                         !results.some((r) => r.id === knowledge.id) &&
                         this.matchesQuery(knowledge, query)) {
@@ -246,7 +252,8 @@ export class TransferSpecialistService {
      * Get knowledge by ID
      */
     async getKnowledgeById(id) {
-        const knowledge = await this.memory.get(`learning:knowledge:shared:${id}`);
+        // #493: rehydrate Date fields at the kv-read seam.
+        const knowledge = rehydrateDates(await this.memory.get(`learning:knowledge:shared:${id}`), ['createdAt', 'expiresAt']);
         return knowledge || null;
     }
     /**
@@ -257,7 +264,8 @@ export class TransferSpecialistService {
             const keys = await this.memory.search(`learning:knowledge:project:${sourceProject}:*`, 500);
             const results = [];
             for (const key of keys) {
-                const knowledge = await this.memory.get(key);
+                // #493: rehydrate Date fields at the kv-read seam.
+                const knowledge = rehydrateDates(await this.memory.get(key), ['createdAt', 'expiresAt']);
                 if (!knowledge)
                     continue;
                 // Apply filter

package/dist/integrations/embeddings/base/EmbeddingGenerator.d.ts

@@ -13,7 +13,7 @@
 import type { IEmbedding, IEmbeddingModelConfig, IEmbeddingOptions, IBatchEmbeddingResult, ISimilarityResult, ISearchOptions, IEmbeddingStats, EmbeddingDimension, EmbeddingNamespace, QuantizationType } from './types.js';
 export type { IEmbedding, IEmbeddingModelConfig, IEmbeddingOptions, IBatchEmbeddingResult, ISimilarityResult, ISearchOptions, IEmbeddingStats, EmbeddingDimension, EmbeddingNamespace, QuantizationType, };
 import { EmbeddingCache } from '../cache/EmbeddingCache.js';
-import type { Tensor } from '@xenova/transformers';
+import type { Tensor } from '@huggingface/transformers';
 /**
  * Feature extraction pipeline interface
  *

package/dist/integrations/embeddings/base/EmbeddingGenerator.js

@@ -11,7 +11,7 @@
  * @module integrations/embeddings/base/EmbeddingGenerator
  */
 import { EmbeddingCache } from '../cache/EmbeddingCache.js';
-import { pipeline } from '@xenova/transformers';
+import { pipeline } from '@huggingface/transformers';
 import { cosineSimilarity } from '../../../shared/utils/vector-math.js';
 /**
  * Base embedding generator class
@@ -54,11 +54,20 @@ export class EmbeddingGenerator {
         const startTime = performance.now();
         // Use ONNX runtime if enabled
         if (this.config.onnxEnabled) {
+            // v4 replaced `quantized: bool` with `dtype: DataType`. We map our
+            // QuantizationType to the closest model-load dtype; the 'binary' bucket
+            // is a post-process step, not a model weight format, so we fall back to
+            // q8 for load and keep the binary quantization step downstream.
+            const loadDtype = this.config.quantization === 'none' ? 'fp32' :
+                this.config.quantization === 'fp16' ? 'fp16' :
+                    this.config.quantization === 'int8' ? 'int8' : 'q8';
             this.model = await pipeline('feature-extraction', this.config.model, {
-                quantized: this.config.quantization !== 'none',
-                progress_callback: (progress) => {
-                    if (progress.status === 'downloading') {
-                        console.log(`Downloading model: ${(progress.progress * 100).toFixed(0)}%`);
+                dtype: loadDtype,
+                // v4 narrowed ProgressInfo to a discriminated union — `progress`
+                // only exists on the "progress"/download variants.
+                progress_callback: (info) => {
+                    if (info.status === 'progress' && typeof info.progress === 'number') {
+                        console.log(`Downloading model: ${(info.progress * 100).toFixed(0)}%`);
                     }
                 },
             });

package/dist/integrations/ruvector/rvf-dual-writer.d.ts

@@ -27,6 +27,15 @@ export interface RvfStore {
     delete(ids: string[]): void;
     status(): RvfStatus;
     close(): void;
+    /**
+     * Optional: reclaim dead space. Returns reclaim stats or null when the
+     * underlying store does not support compaction (e.g. mock stores in tests).
+     */
+    compact?(): {
+        segmentsCompacted: number;
+        bytesReclaimed: number;
+        epoch: number;
+    } | null;
 }
 export interface RvfStatus {
     totalVectors: number;
@@ -120,6 +129,19 @@ export declare class RvfDualWriter {
      * Close the RVF store. SQLite is managed externally.
      */
     close(): void;
+    /**
+     * Reclaim dead space in the underlying brain.rvf container. Best-effort —
+     * returns reclaim stats if compaction ran, null if it was skipped or the
+     * store does not implement compact(). Same rationale as patterns.rvf
+     * compaction: brain.rvf receives one write per pattern via writePattern()
+     * and is otherwise append-only, so without periodic compaction it grows
+     * monotonically.
+     */
+    compact(): {
+        segmentsCompacted: number;
+        bytesReclaimed: number;
+        epoch: number;
+    } | null;
     private shouldWriteRvf;
     private writeSqliteEmbedding;
     private deleteSqliteEmbedding;

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

@@ -39,6 +39,9 @@ function wrapNativeAdapter(adapter, dim) {
         close() {
             adapter.close();
         },
+        compact() {
+            return adapter.compact();
+        },
     };
 }
 function tableExists(db, name) {
@@ -280,6 +283,24 @@ export class RvfDualWriter {
             this.rvfAvailable = false;
         }
     }
+    /**
+     * Reclaim dead space in the underlying brain.rvf container. Best-effort —
+     * returns reclaim stats if compaction ran, null if it was skipped or the
+     * store does not implement compact(). Same rationale as patterns.rvf
+     * compaction: brain.rvf receives one write per pattern via writePattern()
+     * and is otherwise append-only, so without periodic compaction it grows
+     * monotonically.
+     */
+    compact() {
+        if (!this.rvfStore || !this.rvfAvailable || !this.rvfStore.compact)
+            return null;
+        try {
+            return this.rvfStore.compact() ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
     // --------------------------------------------------------------------------
     // Private helpers
     // --------------------------------------------------------------------------

package/dist/integrations/ruvector/rvf-native-adapter.d.ts

@@ -43,6 +43,18 @@ export interface RvfStatus {
     epoch: number;
     witnessValid: boolean;
     witnessEntries: number;
+    /**
+     * Fraction of file bytes occupied by tombstoned/superseded segments (0-1).
+     * Optional so existing partial mocks in tests still compile; runtime
+     * adapters always populate this (the wrapper defaults to 0 if the native
+     * binding does not surface it).
+     */
+    deadSpaceRatio?: number;
+}
+export interface RvfCompactionResult {
+    segmentsCompacted: number;
+    bytesReclaimed: number;
+    epoch: number;
 }
 export interface RvfNativeAdapter {
     ingest(entries: RvfIngestEntry[]): {
@@ -55,7 +67,12 @@ export interface RvfNativeAdapter {
     status(): RvfStatus;
     dimension(): number;
     size(): number;
-    compact(): void;
+    /**
+     * Reclaim dead space by merging segments and dropping tombstones.
+     * Returns reclaim stats. Logs and returns `null` if the native call throws
+     * (best-effort — never let compaction failures propagate to callers).
+     */
+    compact(): RvfCompactionResult | null;
     close(): void;
     isOpen(): boolean;
     path(): string;

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

@@ -190,6 +190,7 @@ class RvfNativeAdapterImpl {
             epoch: s.currentEpoch,
             witnessValid: witnessSegs.length > 0,
             witnessEntries: witnessSegs.length,
+            deadSpaceRatio: typeof s.deadSpaceRatio === 'number' ? s.deadSpaceRatio : 0,
         };
     }
     // -- accessors ------------------------------------------------------------
@@ -202,7 +203,20 @@ class RvfNativeAdapterImpl {
     }
     compact() {
         this.ensureOpen();
-        this.db.compact();
+        try {
+            const r = this.db.compact();
+            if (r && typeof r === 'object') {
+                return {
+                    segmentsCompacted: typeof r.segmentsCompacted === 'number' ? r.segmentsCompacted : 0,
+                    bytesReclaimed: typeof r.bytesReclaimed === 'number' ? r.bytesReclaimed : 0,
+                    epoch: typeof r.epoch === 'number' ? r.epoch : 0,
+                };
+            }
+            return { segmentsCompacted: 0, bytesReclaimed: 0, epoch: 0 };
+        }
+        catch {
+            return null;
+        }
     }
     close() {
         if (this._open) {

package/dist/integrations/ruvector/shared-rvf-adapter.d.ts

@@ -10,7 +10,9 @@
  *
  * @module integrations/ruvector/shared-rvf-adapter
  */
-import type { RvfNativeAdapter } from './rvf-native-adapter.js';
+import type { RvfNativeAdapter, RvfCompactionResult, RvfStatus } from './rvf-native-adapter.js';
+/** @internal test-only seam */
+export declare function __setSharedRvfAdapterForTests(adapter: RvfNativeAdapter | null): void;
 /**
  * Get or create the shared RvfNativeAdapter singleton for patterns.rvf.
  *
@@ -19,6 +21,49 @@ import type { RvfNativeAdapter } from './rvf-native-adapter.js';
  * @returns The shared adapter, or null if native bindings are unavailable
  */
 export declare function getSharedRvfAdapter(dataDir?: string, dimensions?: number): RvfNativeAdapter | null;
+export interface CompactDecision {
+    shouldCompact: boolean;
+    trigger: 'force' | 'size-guard' | 'dead-ratio' | 'none';
+}
+/**
+ * Pure decision function: given an adapter status, decide whether compaction
+ * should run and which threshold triggered it. Exported so tests can verify
+ * the decision logic without exercising the singleton or native binding.
+ */
+export declare function decideCompactionFromStatus(status: RvfStatus, opts?: {
+    deadRatioThreshold?: number;
+    sizeGuardBytes?: number;
+    force?: boolean;
+}): CompactDecision;
+/**
+ * Run `compact()` against the shared patterns.rvf adapter when dead-space or
+ * file-size thresholds are exceeded. Best-effort — returns the reclaim stats
+ * if compaction ran, or `null` if it was skipped or failed.
+ *
+ * Safe to call from steady-state code (e.g. after a dream cycle). The native
+ * binding's compact() is documented as exclusive against writers, so callers
+ * should run this in idle windows when possible.
+ *
+ * Thresholds can be overridden via:
+ *   AQE_RVF_SIZE_GUARD_BYTES        (default 256 MB)
+ *   AQE_RVF_DEAD_RATIO_THRESHOLD    (default 0.30)
+ */
+export declare function compactSharedRvfAdapter(opts?: {
+    /** Override the dead-space ratio above which compaction runs. */
+    deadRatioThreshold?: number;
+    /** Override the file size above which compaction runs unconditionally. */
+    sizeGuardBytes?: number;
+    /** When true, run compact() regardless of thresholds. */
+    force?: boolean;
+}): RvfCompactionResult | null;
+/**
+ * One-shot at boot. Runs a best-effort `compact()` against the freshly-opened
+ * adapter when fileSize or deadSpaceRatio exceed configured thresholds. Lives
+ * here (not at module load) so a never-opened adapter doesn't trigger native
+ * binding init. Exported for tests; production callers go via
+ * `getSharedRvfAdapter()` which invokes it internally.
+ */
+export declare function runBootCompactGuard(adapter: RvfNativeAdapter, rvfPath: string): RvfCompactionResult | null;
 /** Close the shared adapter and reset the singleton. */
 export declare function resetSharedRvfAdapter(): void;
 //# sourceMappingURL=shared-rvf-adapter.d.ts.map