agentic-qe 3.10.1 → 3.10.3

package/dist/init/phases/07-hooks.js

@@ -172,6 +172,9 @@ export class HooksPhase extends BasePhase {
         this.installBrainCheckpoint(projectRoot, context);
         // Install statusline-v3 helper into .claude/helpers/
         this.installStatusline(projectRoot, context);
+        // Install the resilient hook shim into .claude/hooks/ — the generated
+        // settings.json hooks invoke it (`node .../aqe-hook.cjs <cmd>`).
+        this.installHookShim(projectRoot, context);
         // Install cross-phase memory config
         const crossPhasePath = join(hooksDir, 'cross-phase-memory.yaml');
         if (!existsSync(crossPhasePath)) {
@@ -290,40 +293,73 @@ export class HooksPhase extends BasePhase {
             context.services.log('  Installed statusline-v3.cjs (generated)');
         }
     }
+    /**
+     * Install the resilient hook shim (aqe-hook.cjs) into .claude/hooks/.
+     * The generated settings.json hooks run `node .../aqe-hook.cjs <cmd>` — the
+     * shim resolves a project-local AQE bundle (or falls back to npx), strips
+     * init noise from stdout, swallows stderr, and always exits 0.
+     */
+    installHookShim(projectRoot, context) {
+        const destDir = join(projectRoot, '.claude', 'hooks');
+        if (!existsSync(destDir)) {
+            mkdirSync(destDir, { recursive: true });
+        }
+        const destPath = join(destDir, 'aqe-hook.cjs');
+        // Source candidates: the installed dependency, then this package's own copy
+        // (resolved relative to the compiled init module — works for npx too).
+        const sourcePaths = [
+            join(projectRoot, 'node_modules', 'agentic-qe', '.claude', 'hooks', 'aqe-hook.cjs'),
+            join(__dirname, '..', '..', '..', '.claude', 'hooks', 'aqe-hook.cjs'),
+        ];
+        for (const src of sourcePaths) {
+            if (existsSync(src) && src !== destPath) {
+                const { copyFileSync } = require('fs');
+                copyFileSync(src, destPath);
+                context.services.log('  Installed aqe-hook.cjs (copied)');
+                return;
+            }
+        }
+        if (existsSync(destPath)) {
+            // Already present (e.g. dogfooding this repo) — leave it.
+            return;
+        }
+        // Should not happen for a real install (the file ships in the package).
+        context.services.log('  ⚠ aqe-hook.cjs source not found — hooks will fall back to `npx agentic-qe`');
+    }
     /**
      * Generate a minimal statusline-v3.cjs script as a fallback.
      * Used when the full asset isn't available for copying.
      */
     generateMinimalStatuslineScript() {
-        return `#!/usr/bin/env node
-/**
- * Agentic QE v3 Statusline (minimal fallback, generated by aqe init)
- * For the full statusline, reinstall: npx agentic-qe init --auto
- */
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-
-function q(bin, args, d) { try { return execFileSync(bin, args, { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] }).trim(); } catch { return d || ''; } }
-
-const dir = path.resolve(__dirname, '..', '..');
-const dbPath = path.join(dir, '.agentic-qe', 'memory.db');
-let patterns = 0;
-try {
-  if (fs.existsSync(dbPath)) {
-    const Database = require('better-sqlite3');
-    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
-    db.pragma('busy_timeout = 5000');
-    patterns = db.prepare("SELECT COUNT(*) AS c FROM qe_patterns WHERE usage_count > 0 OR quality_score > 0 OR name NOT LIKE 'bench-%'").get()?.c || 0;
-    db.close();
-  }
-} catch { /* ignore */ }
-
-const branch = q('git', ['branch', '--show-current']);
-const branchStr = branch ? \`  \\x1b[34m⎇ \${branch}\\x1b[0m\` : '';
-const patStr = patterns > 0 ? \`  \\x1b[35m🎓 \${patterns} patterns\\x1b[0m\` : '';
-
-console.log(\`\\x1b[1m\\x1b[35m▊ Agentic QE v3\\x1b[0m\${branchStr}\${patStr}\`);
+        return `#!/usr/bin/env node
+/**
+ * Agentic QE v3 Statusline (minimal fallback, generated by aqe init)
+ * For the full statusline, reinstall: npx agentic-qe init --auto
+ */
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+function q(bin, args, d) { try { return execFileSync(bin, args, { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] }).trim(); } catch { return d || ''; } }
+
+const dir = path.resolve(__dirname, '..', '..');
+const dbPath = path.join(dir, '.agentic-qe', 'memory.db');
+let patterns = 0;
+try {
+  if (fs.existsSync(dbPath)) {
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    db.pragma('busy_timeout = 5000');
+    patterns = db.prepare("SELECT COUNT(*) AS c FROM qe_patterns WHERE usage_count > 0 OR quality_score > 0 OR name NOT LIKE 'bench-%'").get()?.c || 0;
+    db.close();
+  }
+} catch { /* ignore */ }
+
+const branch = q('git', ['branch', '--show-current']);
+const branchStr = branch ? \`  \\x1b[34m⎇ \${branch}\\x1b[0m\` : '';
+const patStr = patterns > 0 ? \`  \\x1b[35m🎓 \${patterns} patterns\\x1b[0m\` : '';
+
+console.log(\`\\x1b[1m\\x1b[35m▊ Agentic QE v3\\x1b[0m\${branchStr}\${patStr}\`);
 `;
     }
     /**
@@ -331,62 +367,62 @@ console.log(\`\\x1b[1m\\x1b[35m▊ Agentic QE v3\\x1b[0m\${branchStr}\${patStr}\
      * Used when the source file isn't available for copying.
      */
     generateBrainCheckpointScript() {
-        return `#!/usr/bin/env node
-/**
- * Brain Checkpoint Helper (generated by aqe init)
- *
- * Usage:
- *   node brain-checkpoint.cjs export   # Export brain to aqe.rvf (session-end)
- *   node brain-checkpoint.cjs verify   # Verify aqe.rvf exists (session-start)
- */
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const PROJECT_ROOT = path.resolve(__dirname, '..', '..');
-const AQE_DIR = path.join(PROJECT_ROOT, '.agentic-qe');
-const RVF_PATH = path.join(AQE_DIR, 'aqe.rvf');
-const DB_PATH = path.join(AQE_DIR, 'memory.db');
-const MAX_AGE_HOURS = 24;
-
-function log(msg) { process.stderr.write('[brain-checkpoint] ' + msg + '\\n'); }
-
-function exportBrain() {
-  if (!fs.existsSync(DB_PATH)) { log('No memory.db, skipping'); return { exported: false }; }
-  try {
-    if (fs.existsSync(RVF_PATH)) fs.unlinkSync(RVF_PATH);
-    const idmap = RVF_PATH + '.idmap.json';
-    if (fs.existsSync(idmap)) fs.unlinkSync(idmap);
-    const result = execFileSync(
-      'npx', ['agentic-qe', 'brain', 'export', '-o', RVF_PATH, '--format', 'rvf'],
-      { timeout: 60000, encoding: 'utf-8' }
-    );
-    const m = result.match(/Patterns:\\s+(\\d+)/);
-    const p = m ? m[1] : '0';
-    log('Exported ' + p + ' patterns to aqe.rvf');
-    return { exported: true, patterns: parseInt(p) };
-  } catch (e) {
-    log('Export failed: ' + e.message);
-    return { exported: false, reason: e.message };
-  }
-}
-
-function verifyBrain() {
-  if (!fs.existsSync(RVF_PATH)) {
-    log('No aqe.rvf found');
-    return { valid: false, reason: 'missing' };
-  }
-  const stat = fs.statSync(RVF_PATH);
-  const ageH = (Date.now() - stat.mtimeMs) / 3600000;
-  if (stat.size < 1024) { log('aqe.rvf too small'); return { valid: false, reason: 'too-small' }; }
-  if (ageH > MAX_AGE_HOURS) { log('aqe.rvf is ' + ageH.toFixed(1) + 'h old'); return { valid: true, stale: true }; }
-  log('aqe.rvf OK (' + (stat.size/1048576).toFixed(1) + ' MB)');
-  return { valid: true, stale: false };
-}
-
-const cmd = process.argv[2] || 'verify';
-const result = cmd === 'export' ? exportBrain() : verifyBrain();
-if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result));
+        return `#!/usr/bin/env node
+/**
+ * Brain Checkpoint Helper (generated by aqe init)
+ *
+ * Usage:
+ *   node brain-checkpoint.cjs export   # Export brain to aqe.rvf (session-end)
+ *   node brain-checkpoint.cjs verify   # Verify aqe.rvf exists (session-start)
+ */
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_ROOT = path.resolve(__dirname, '..', '..');
+const AQE_DIR = path.join(PROJECT_ROOT, '.agentic-qe');
+const RVF_PATH = path.join(AQE_DIR, 'aqe.rvf');
+const DB_PATH = path.join(AQE_DIR, 'memory.db');
+const MAX_AGE_HOURS = 24;
+
+function log(msg) { process.stderr.write('[brain-checkpoint] ' + msg + '\\n'); }
+
+function exportBrain() {
+  if (!fs.existsSync(DB_PATH)) { log('No memory.db, skipping'); return { exported: false }; }
+  try {
+    if (fs.existsSync(RVF_PATH)) fs.unlinkSync(RVF_PATH);
+    const idmap = RVF_PATH + '.idmap.json';
+    if (fs.existsSync(idmap)) fs.unlinkSync(idmap);
+    const result = execFileSync(
+      'npx', ['agentic-qe', 'brain', 'export', '-o', RVF_PATH, '--format', 'rvf'],
+      { timeout: 60000, encoding: 'utf-8' }
+    );
+    const m = result.match(/Patterns:\\s+(\\d+)/);
+    const p = m ? m[1] : '0';
+    log('Exported ' + p + ' patterns to aqe.rvf');
+    return { exported: true, patterns: parseInt(p) };
+  } catch (e) {
+    log('Export failed: ' + e.message);
+    return { exported: false, reason: e.message };
+  }
+}
+
+function verifyBrain() {
+  if (!fs.existsSync(RVF_PATH)) {
+    log('No aqe.rvf found');
+    return { valid: false, reason: 'missing' };
+  }
+  const stat = fs.statSync(RVF_PATH);
+  const ageH = (Date.now() - stat.mtimeMs) / 3600000;
+  if (stat.size < 1024) { log('aqe.rvf too small'); return { valid: false, reason: 'too-small' }; }
+  if (ageH > MAX_AGE_HOURS) { log('aqe.rvf is ' + ageH.toFixed(1) + 'h old'); return { valid: true, stale: true }; }
+  log('aqe.rvf OK (' + (stat.size/1048576).toFixed(1) + ' MB)');
+  return { valid: true, stale: false };
+}
+
+const cmd = process.argv[2] || 'verify';
+const result = cmd === 'export' ? exportBrain() : verifyBrain();
+if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result));
 `;
     }
     /**
@@ -410,7 +446,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks guard --file "$TOOL_INPUT_file_path" --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" guard --file "$TOOL_INPUT_file_path" --json',
                             timeout: 3000,
                             continueOnError: true,
                         },
@@ -422,7 +458,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks pre-edit --file "$TOOL_INPUT_file_path" --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-edit --file "$TOOL_INPUT_file_path" --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -434,7 +470,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks pre-command --command "$TOOL_INPUT_command" --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-command --command "$TOOL_INPUT_command" --json',
                             timeout: 3000,
                             continueOnError: true,
                         },
@@ -446,7 +482,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks pre-task --description "$TOOL_INPUT_prompt" --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-task --description "$TOOL_INPUT_prompt" --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -459,7 +495,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks post-edit --file "$TOOL_INPUT_file_path" --success --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-edit --file "$TOOL_INPUT_file_path" --success --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -470,7 +506,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks post-command --command "$TOOL_INPUT_command" --success --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-command --command "$TOOL_INPUT_command" --success true --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -481,7 +517,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks post-task --task-id "$TOOL_RESULT_agent_id" --success --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-task --task-id "$TOOL_RESULT_agent_id" --agent "$TOOL_INPUT_subagent_type" --success true --description "$TOOL_INPUT_prompt" --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -496,7 +532,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                             // (e.g. {"prompt":"..."}). $PROMPT is NOT exposed as an env
                             // var, so we let the CLI read stdin directly.
                             type: 'command',
-                            command: 'npx agentic-qe hooks route --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" route --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -508,7 +544,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks session-start --session-id "$SESSION_ID" --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" session-start --session-id "$SESSION_ID" --json',
                             timeout: 10000,
                             continueOnError: true,
                         },
@@ -530,7 +566,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                     hooks: [
                         {
                             type: 'command',
-                            command: 'npx agentic-qe hooks session-end --save-state --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" session-end --save-state --json',
                             timeout: 5000,
                             continueOnError: true,
                         },
@@ -544,7 +580,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
                             // — without this, `routing_outcomes` accumulates quality_score=-1
                             // rows forever in direct-work sessions (no Task/Agent spawned).
                             type: 'command',
-                            command: 'npx agentic-qe hooks post-route --success true --json',
+                            command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-route --success true --json',
                             timeout: 5000,
                             continueOnError: true,
                         },

package/dist/init/phases/12-verification.js

@@ -179,7 +179,7 @@ export class VerificationPhase extends BasePhase {
                     continue;
                 }
                 // Second-level key (2-space indent)
-                const subMatch = line.match(/^  (\w+):\s*(.*)$/);
+                const subMatch = line.match(/^ {2}(\w+):\s*(.*)$/);
                 if (subMatch && currentSection) {
                     currentSubSection = subMatch[1];
                     const value = subMatch[2].trim();
@@ -196,7 +196,7 @@ export class VerificationPhase extends BasePhase {
                 }
                 // Third-level key (4-space indent)
                 // Use [\w-]+ to match hyphenated keys like "pattern-consolidator"
-                const thirdMatch = line.match(/^    ([\w-]+):\s*(.*)$/);
+                const thirdMatch = line.match(/^ {4}([\w-]+):\s*(.*)$/);
                 if (thirdMatch && currentSection && currentSubSection) {
                     const key = thirdMatch[1];
                     const value = thirdMatch[2].trim();
@@ -210,7 +210,7 @@ export class VerificationPhase extends BasePhase {
                     continue;
                 }
                 // Array item (4-space indent with dash)
-                const arrayMatch = line.match(/^    - "?([^"]*)"?$/);
+                const arrayMatch = line.match(/^ {4}- "?([^"]*)"?$/);
                 if (arrayMatch && currentSection && currentSubSection) {
                     const section = result[currentSection];
                     if (!Array.isArray(section[currentSubSection])) {

package/dist/integrations/agentic-flow/model-router/router.js

@@ -375,7 +375,7 @@ export class ModelRouter {
         // Step 2: Analyze complexity
         const complexityAnalysis = await this.complexityAnalyzer.analyze(input);
         // Step 3: Get recommended tier from complexity
-        let recommendedTier = complexityAnalysis.recommendedTier;
+        const recommendedTier = complexityAnalysis.recommendedTier;
         // Step 4: Estimate cost for this tier
         const estimatedCostUsd = this.estimateCost(recommendedTier, input.task.length);
         // Step 5: Check budget

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

@@ -208,17 +208,21 @@ export class EmbeddingGenerator {
                 return new Float32Array(vector.map((v) => Math.fround(v)));
             case 'int8':
                 // Quantize to int8 range [-128, 127]
-                const max = Math.max(...vector.map(Math.abs));
-                return new Int8Array(vector.map((v) => Math.round((v / max) * 127)));
+                {
+                    const max = Math.max(...vector.map(Math.abs));
+                    return new Int8Array(vector.map((v) => Math.round((v / max) * 127)));
+                }
             case 'binary':
                 // Binary quantization (sign bit only)
-                const binaryBytes = new Uint8Array(Math.ceil(vector.length / 8));
-                for (let i = 0; i < vector.length; i++) {
-                    if (vector[i] >= 0) {
-                        binaryBytes[Math.floor(i / 8)] |= 1 << (i % 8);
+                {
+                    const binaryBytes = new Uint8Array(Math.ceil(vector.length / 8));
+                    for (let i = 0; i < vector.length; i++) {
+                        if (vector[i] >= 0) {
+                            binaryBytes[Math.floor(i / 8)] |= 1 << (i % 8);
+                        }
                     }
+                    return binaryBytes;
                 }
-                return binaryBytes;
             case 'none':
             default:
                 return vector;

package/dist/integrations/ruvector/hypergraph-engine.js

@@ -657,8 +657,8 @@ export class HypergraphEngine {
         const startTime = Date.now();
         let nodesSynced = 0;
         let edgesSynced = 0;
-        let nodesAdded = 0;
-        let nodesRemoved = 0;
+        const nodesAdded = 0;
+        const nodesRemoved = 0;
         // Get all nodes from hypergraph
         const hgNodes = await this.findNodes({});
         for (const node of hgNodes) {

package/dist/integrations/ruvector/spectral-math.js

@@ -114,7 +114,7 @@ export function approximateFiedlerValue(adjacency, n, maxIter = 100, tol = 1e-6)
     // The trivial eigenvector of L: normalized all-ones
     const trivial = new Float64Array(n).fill(1 / Math.sqrt(n));
     // First, estimate lambda_max using a few power iterations on L
-    let maxVec = new Float64Array(n);
+    const maxVec = new Float64Array(n);
     for (let i = 0; i < n; i++)
         maxVec[i] = Math.random() - 0.5;
     deflateVector(maxVec, trivial);
@@ -134,7 +134,7 @@ export function approximateFiedlerValue(adjacency, n, maxIter = 100, tol = 1e-6)
     // Now use power iteration on (lambdaMax * I - L) to find the
     // eigenvector corresponding to the LARGEST eigenvalue of (lambdaMax*I - L),
     // which corresponds to the SMALLEST non-trivial eigenvalue of L.
-    let v = new Float64Array(n);
+    const v = new Float64Array(n);
     for (let i = 0; i < n; i++)
         v[i] = Math.random() - 0.5;
     deflateVector(v, trivial);

package/dist/integrations/ruvector/spectral-sparsifier.js

@@ -276,7 +276,7 @@ export class SpectralSparsifier {
         // Use a different pattern for each deflation round to avoid
         // starting in the null-space of the deflated matrix
         const round = previousEigenvectors.length;
-        let v = new Array(n);
+        const v = new Array(n);
         for (let i = 0; i < n; i++) {
             v[i] = Math.sin((i + 1) * (round + 1) * 1.618033988749895) + 0.1 * (i - n / 2);
         }

package/dist/kernel/kernel.js

@@ -566,7 +566,7 @@ export class QEKernelImpl {
         const activeCount = this._coordinator.getActiveCount();
         // Get memory stats - handle both backend types
         let memUsed = 0;
-        let memAvailable = Number.MAX_SAFE_INTEGER;
+        const memAvailable = Number.MAX_SAFE_INTEGER;
         if (this._memory instanceof InMemoryBackend) {
             const memStats = this._memory.getStats();
             memUsed = memStats.entries + memStats.vectors;

package/dist/kernel/unified-memory-hnsw.js

@@ -76,6 +76,7 @@ export class BinaryHeap {
     }
     sinkDown(i) {
         const n = this.data.length;
+        // eslint-disable-next-line no-constant-condition -- heap sift-down; loop breaks internally
         while (true) {
             let smallest = i;
             const left = 2 * i + 1;

package/dist/learning/agent-routing.d.ts

@@ -78,6 +78,25 @@ export declare const MAX_Q_WEIGHT = 0.4;
  * decision. Adjust downward if cold-start latency proves problematic.
  */
 export declare const QWEIGHT_RAMP_VISITS = 20;
+/**
+ * De-dilution cap for the domain-match denominator (#510 item 2).
+ *
+ * Domain score is `(domainMatch / denom) * 0.4`. The original `denom` was the
+ * full count of *detected* domains, but AQE's domain detector routinely emits
+ * 7-12 domains per task, so a perfect single-domain specialist scored
+ * `(1/11)*0.4 ≈ 0.04` — relevance washed out by detector breadth, leaving
+ * confidence dominated by the fixed performance term (measured easy task
+ * 37.3%, hard task 20.5%, with hard tasks mis-routing to high-performance
+ * but domain-irrelevant agents).
+ *
+ * Capping the denominator models the fact that a task has only a few *truly
+ * relevant* domains. With cap=3: a precise detector (1-2 domains) is
+ * unchanged, while a broad detector no longer dilutes a real match below
+ * usefulness. Proportionality across agents is preserved (an agent matching 2
+ * relevant domains still beats one matching 1). Tunable; raise toward the old
+ * behavior, lower to weight domain relevance more heavily.
+ */
+export declare const DOMAIN_DENOM_CAP = 3;
 /**
  * Q-value lookup callback supplied by the caller (QEReasoningBank.routeTask).
  * Returns undefined when the (stateKey, agentType) pair has no recorded

package/dist/learning/agent-routing.js

@@ -99,6 +99,25 @@ export const MAX_Q_WEIGHT = 0.4;
  * decision. Adjust downward if cold-start latency proves problematic.
  */
 export const QWEIGHT_RAMP_VISITS = 20;
+/**
+ * De-dilution cap for the domain-match denominator (#510 item 2).
+ *
+ * Domain score is `(domainMatch / denom) * 0.4`. The original `denom` was the
+ * full count of *detected* domains, but AQE's domain detector routinely emits
+ * 7-12 domains per task, so a perfect single-domain specialist scored
+ * `(1/11)*0.4 ≈ 0.04` — relevance washed out by detector breadth, leaving
+ * confidence dominated by the fixed performance term (measured easy task
+ * 37.3%, hard task 20.5%, with hard tasks mis-routing to high-performance
+ * but domain-irrelevant agents).
+ *
+ * Capping the denominator models the fact that a task has only a few *truly
+ * relevant* domains. With cap=3: a precise detector (1-2 domains) is
+ * unchanged, while a broad detector no longer dilutes a real match below
+ * usefulness. Proportionality across agents is preserved (an agent matching 2
+ * relevant domains still beats one matching 1). Tunable; raise toward the old
+ * behavior, lower to weight domain relevance more heavily.
+ */
+export const DOMAIN_DENOM_CAP = 3;
 /**
  * Sigmoid mapping R → (0, 1) for Q-value normalization before blending.
  * A fresh row with q_value = 0 contributes 0.5 (neutral); negative q_values
@@ -265,7 +284,14 @@ qValueLookup) {
         const reasoning = [];
         // Domain match (0-0.4)
         const domainMatch = detectedDomains.filter((d) => profile.domains.includes(d)).length;
-        const domainScore = domainMatch > 0 ? (domainMatch / detectedDomains.length) * 0.4 : 0;
+        // De-dilute by capping the denominator (#510 item 2): dividing by the full
+        // count of *detected* domains (7-12) washed out real matches. Cap models
+        // the few truly-relevant domains a task actually has. Math.min(...,1)
+        // guards the case where domainMatch exceeds the cap.
+        const domainDenom = Math.min(detectedDomains.length, DOMAIN_DENOM_CAP);
+        const domainScore = domainMatch > 0
+            ? Math.min(domainMatch / domainDenom, 1) * 0.4
+            : 0;
         score += domainScore * routingWeights.similarity;
         if (domainScore > 0) {
             reasoning.push(`Domain match: ${(domainScore * 100).toFixed(0)}%`);

package/dist/learning/dream/dream-scheduler.d.ts

@@ -101,42 +101,6 @@ export interface DreamSchedulerDependencies {
     /** Memory backend for persisting scheduler state (optional) */
     memoryBackend?: MemoryBackend;
 }
-/**
- * DreamScheduler manages automatic triggering of dream cycles.
- *
- * It follows the dependency injection pattern - all required dependencies
- * (DreamEngine, EventBus) must be provided via the constructor.
- *
- * @example
- * ```typescript
- * const scheduler = new DreamScheduler({
- *   dreamEngine,
- *   eventBus,
- *   memoryBackend, // optional
- * });
- *
- * await scheduler.initialize();
- * scheduler.start();
- *
- * // Record experiences as they happen
- * scheduler.recordExperience({
- *   id: 'exp-1',
- *   agentType: 'tester',
- *   domain: 'test-execution',
- *   taskType: 'run-tests',
- *   success: true,
- *   duration: 5000,
- *   timestamp: new Date(),
- * });
- *
- * // Manually trigger a dream
- * const result = await scheduler.triggerDream();
- *
- * // Stop and cleanup
- * scheduler.stop();
- * await scheduler.dispose();
- * ```
- */
 export declare class DreamScheduler {
     private readonly config;
     private readonly dreamEngine;
@@ -320,6 +284,17 @@ export declare class DreamScheduler {
      * Publish a dream completed event.
      */
     private publishDreamCompletedEvent;
+    /**
+     * #509: Reconcile the SessionStart-read `dream-scheduler:hook-state` row after
+     * a successful dream cycle. The post-task hook only ever INCREMENTS that row's
+     * experienceCount; this kernel scheduler is the entity that actually dreams
+     * (ADR-094) but historically never wrote it back, so the SessionStart readout
+     * showed lastDreamTime:null and a pendingExperiences counter that only grew.
+     * We stamp { lastDreamTime: now, experienceCount: 0, totalDreamsThisSession++ }
+     * using the SAME key + DEFAULT namespace the hook path uses. Best-effort: a
+     * failure here must never break a dream cycle.
+     */
+    private reconcileHookState;
     /**
      * Save scheduler state to memory backend.
      */

package/dist/learning/dream/dream-scheduler.js

@@ -81,6 +81,17 @@ export const DEFAULT_DREAM_SCHEDULER_CONFIG = {
  * await scheduler.dispose();
  * ```
  */
+/**
+ * kv_store key that the SessionStart hook reads for its dream readout and the
+ * post-task hook increments. Mirrors `DREAM_STATE_KEY` in
+ * cli/commands/hooks-handlers/hooks-dream-learning.ts — kept as a local literal
+ * (not imported) to avoid a learning→cli layering dependency. MUST match that
+ * value and use the DEFAULT namespace (the hook path passes no namespace).
+ * #509: this scheduler is the entity that actually dreams (ADR-094) but never
+ * reset this row, so SessionStart showed lastDreamTime:null + an ever-growing
+ * pendingExperiences. reconcileHookState() below stamps the truth per cycle.
+ */
+const DREAM_HOOK_STATE_KEY = 'dream-scheduler:hook-state';
 export class DreamScheduler {
     config;
     dreamEngine;
@@ -351,6 +362,10 @@ export class DreamScheduler {
             this.totalDreamsCompleted++;
             // Clear experience buffer after successful dream
             this.clearExperienceBuffer();
+            // #509: reconcile the SessionStart-read hook-state row. The post-task hook
+            // only increments its experienceCount and nothing on the active dream path
+            // reset it, so the readout was perpetually stale. Best-effort.
+            await this.reconcileHookState();
             // Auto-apply high-confidence insights if enabled
             if (this.config.autoApplyHighConfidenceInsights) {
                 await this.autoApplyInsights(result);
@@ -698,6 +713,35 @@ export class DreamScheduler {
     // ==========================================================================
     // Private: State Persistence
     // ==========================================================================
+    /**
+     * #509: Reconcile the SessionStart-read `dream-scheduler:hook-state` row after
+     * a successful dream cycle. The post-task hook only ever INCREMENTS that row's
+     * experienceCount; this kernel scheduler is the entity that actually dreams
+     * (ADR-094) but historically never wrote it back, so the SessionStart readout
+     * showed lastDreamTime:null and a pendingExperiences counter that only grew.
+     * We stamp { lastDreamTime: now, experienceCount: 0, totalDreamsThisSession++ }
+     * using the SAME key + DEFAULT namespace the hook path uses. Best-effort: a
+     * failure here must never break a dream cycle.
+     */
+    async reconcileHookState() {
+        if (!this.memoryBackend)
+            return;
+        try {
+            const prev = await this.memoryBackend.get(DREAM_HOOK_STATE_KEY);
+            const next = {
+                lastDreamTime: (this.lastDreamTime ?? new Date()).toISOString(),
+                experienceCount: 0,
+                sessionStartTime: prev?.sessionStartTime,
+                totalDreamsThisSession: (prev?.totalDreamsThisSession ?? 0) + 1,
+            };
+            await this.memoryBackend.set(DREAM_HOOK_STATE_KEY, next);
+        }
+        catch (err) {
+            logger.warn('Dream hook-state reconcile failed (non-critical)', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
     /**
      * Save scheduler state to memory backend.
      */