agentic-qe 3.10.1 → 3.10.2

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/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.
      */

package/dist/learning/experience-consolidation.d.ts

@@ -18,6 +18,12 @@ import type { Database as DatabaseType } from 'better-sqlite3';
 export interface ConsolidationResult {
     /** Experiences merged into survivors */
     merged: number;
+    /**
+     * Experiences suppressed from retrieval because they CONTRADICT a
+     * higher-quality near-duplicate (similar context, opposite outcome).
+     * Soft-suppressed (consolidated_into = 'contradicted'), not deleted.
+     */
+    contradicted: number;
     /** Experiences with quality recalculated */
     qualityUpdated: number;
     /** Experiences soft-archived (Phase 3 valueless + Phase 4 safety valve) */
@@ -54,6 +60,16 @@ export interface ConsolidationConfig {
     archiveQualityThreshold: number;
     /** Quality boost per merged experience */
     mergeQualityBoost: number;
+    /**
+     * Contradiction detection (#510 item 7). Two experiences with cosine
+     * similarity >= this threshold but a quality delta >= contradictionQualityDelta
+     * are treated as "same context, opposite outcome" — a conflict, not a
+     * duplicate. The lower-quality loser is suppressed from retrieval instead of
+     * merged, so it can't poison recall.
+     */
+    contradictionSimilarityThreshold: number;
+    /** Min quality gap that turns a near-duplicate into a contradiction (0-1). */
+    contradictionQualityDelta: number;
 }
 export declare class ExperienceConsolidator {
     private readonly config;