@cleocode/core 2026.4.31 → 2026.4.35

package/migrations/drizzle-brain/20260411000001_t528-graph-schema-expansion/migration.sql

@@ -0,0 +1,47 @@
+-- T528: Graph-native memory model — expand brain_page_nodes and brain_page_edges schemas.
+-- Adds quality scoring, content hashing, last-activity tracking, provenance, and new
+-- indexes to support traversable knowledge graph operations.
+--
+-- Additive only: all new columns have defaults so existing rows are unaffected.
+-- brain_page_nodes has 0 rows and brain_page_edges has 0 rows (confirmed by R1 audit),
+-- so no data migration is required.
+
+ALTER TABLE `brain_page_nodes` ADD COLUMN `quality_score` real NOT NULL DEFAULT 0.5;
+--> statement-breakpoint
+ALTER TABLE `brain_page_nodes` ADD COLUMN `content_hash` text;
+--> statement-breakpoint
+ALTER TABLE `brain_page_nodes` ADD COLUMN `last_activity_at` text NOT NULL DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_page_nodes` ADD COLUMN `updated_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `provenance` text;
+--> statement-breakpoint
+
+-- brain_page_edges.weight was nullable (DEFAULT 1) in the initial schema;
+-- changing NOT NULL constraint requires recreating the table in SQLite.
+-- Since brain_page_edges has 0 rows, we drop and recreate.
+DROP TABLE IF EXISTS `brain_page_edges`;
+--> statement-breakpoint
+CREATE TABLE `brain_page_edges` (
+	`from_id` text NOT NULL,
+	`to_id` text NOT NULL,
+	`edge_type` text NOT NULL,
+	`weight` real NOT NULL DEFAULT 1,
+	`provenance` text,
+	`created_at` text NOT NULL DEFAULT (datetime('now')),
+	CONSTRAINT `brain_page_edges_pk` PRIMARY KEY(`from_id`, `to_id`, `edge_type`)
+);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_nodes_quality` ON `brain_page_nodes` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_nodes_content_hash` ON `brain_page_nodes` (`content_hash`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_nodes_last_activity` ON `brain_page_nodes` (`last_activity_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_type` ON `brain_page_edges` (`edge_type`);
+--> statement-breakpoint
+-- Re-create existing edge indexes (dropped with table)
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_from` ON `brain_page_edges` (`from_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_to` ON `brain_page_edges` (`to_id`);

package/migrations/drizzle-brain/20260412000001_t531-quality-score-typed-tables/migration.sql

@@ -0,0 +1,23 @@
+-- T531: Wire quality scoring into brain memory store functions.
+-- Adds quality_score column to the four typed brain tables.
+-- NULL is used for legacy rows (not yet scored); new rows get a computed score.
+-- Search filtering uses "IS NULL OR quality_score >= 0.3" so legacy entries are retained.
+--
+-- Additive only: all columns are nullable so existing rows are unaffected.
+
+ALTER TABLE `brain_decisions` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_quality` ON `brain_decisions` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_quality` ON `brain_patterns` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_quality` ON `brain_learnings` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_quality` ON `brain_observations` (`quality_score`);

package/migrations/drizzle-brain/20260413000001_t549-tiered-typed-memory/migration.sql

@@ -0,0 +1,195 @@
+-- T549: Tiered + Typed Memory Architecture v2
+-- Adds: memory_tier, memory_type (cognitive), verified, valid_at, invalid_at,
+--       source_confidence, citation_count to all four typed brain tables.
+--
+-- Strategy: all columns are nullable or have defaults; no existing rows are broken.
+-- NULL-handling contracts: legacy rows are backfilled at the end of this migration.
+-- memory_tier NULL → treated as 'medium' at query time (survived T523 purge).
+-- memory_type NULL → treated as table default at query time.
+-- CONFLICT-03 resolution: citation_count added per cross-validation report (T549-XV).
+-- CONFLICT-01 resolution: cognitive type enum is BRAIN_COGNITIVE_TYPES (semantic/episodic/procedural).
+-- T553 fix: valid_at columns use nullable DEFAULT (datetime('now')) instead of NOT NULL DEFAULT
+--   because SQLite forbids ALTER TABLE ADD COLUMN with a non-constant default on non-empty tables.
+--   The backfill UPDATEs at the end of this migration set valid_at = created_at for all existing
+--   rows, so no row ever has a NULL valid_at after migration completes.
+
+-- ============================================================
+-- brain_decisions
+-- ============================================================
+
+ALTER TABLE `brain_decisions` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `memory_type` text DEFAULT 'semantic';
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_patterns
+-- ============================================================
+
+ALTER TABLE `brain_patterns` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `memory_type` text DEFAULT 'procedural';
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_learnings
+-- ============================================================
+
+ALTER TABLE `brain_learnings` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `memory_type` text DEFAULT 'semantic';
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_observations
+-- ============================================================
+
+ALTER TABLE `brain_observations` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `memory_type` text DEFAULT 'episodic';
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- Indexes for new columns (query hot paths)
+-- ============================================================
+
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_tier` ON `brain_decisions` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_type` ON `brain_decisions` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_verified` ON `brain_decisions` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_valid_at` ON `brain_decisions` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_source_conf` ON `brain_decisions` (`source_confidence`);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_tier` ON `brain_patterns` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_type` ON `brain_patterns` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_verified` ON `brain_patterns` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_valid_at` ON `brain_patterns` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_source_conf` ON `brain_patterns` (`source_confidence`);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_tier` ON `brain_learnings` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_type` ON `brain_learnings` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_verified` ON `brain_learnings` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_valid_at` ON `brain_learnings` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_invalid` ON `brain_learnings` (`invalid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_source_conf` ON `brain_learnings` (`source_confidence`);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_tier` ON `brain_observations` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_type` ON `brain_observations` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_verified` ON `brain_observations` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_valid_at` ON `brain_observations` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_invalid` ON `brain_observations` (`invalid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_source_conf` ON `brain_observations` (`source_confidence`);
+--> statement-breakpoint
+
+-- ============================================================
+-- Backfill: legacy rows (survivors of the T523 purge)
+-- Treat existing rows as medium-to-long-term based on quality signals.
+-- valid_at defaults to created_at so bitemporal queries work correctly.
+-- ============================================================
+
+UPDATE `brain_decisions` SET
+  memory_tier = CASE
+    WHEN confidence = 'high' THEN 'long'
+    WHEN confidence = 'medium' THEN 'medium'
+    ELSE 'medium'
+  END,
+  memory_type = 'semantic',
+  valid_at = created_at,
+  source_confidence = 'agent'
+WHERE memory_tier IS NULL;
+--> statement-breakpoint
+
+UPDATE `brain_patterns` SET
+  memory_tier = CASE
+    WHEN frequency >= 5 THEN 'long'
+    WHEN frequency >= 2 THEN 'medium'
+    ELSE 'medium'
+  END,
+  memory_type = 'procedural',
+  valid_at = extracted_at,
+  source_confidence = 'agent'
+WHERE memory_tier IS NULL;
+--> statement-breakpoint
+
+UPDATE `brain_learnings` SET
+  memory_tier = CASE
+    WHEN confidence >= 0.80 THEN 'long'
+    WHEN confidence >= 0.60 THEN 'medium'
+    ELSE 'medium'
+  END,
+  memory_type = 'semantic',
+  valid_at = created_at,
+  source_confidence = 'agent'
+WHERE memory_tier IS NULL;
+--> statement-breakpoint
+
+UPDATE `brain_observations` SET
+  memory_tier = 'medium',
+  memory_type = 'episodic',
+  valid_at = created_at,
+  source_confidence = CASE
+    WHEN source_type = 'manual' THEN 'owner'
+    WHEN source_type = 'session-debrief' THEN 'task-outcome'
+    ELSE 'agent'
+  END
+WHERE memory_tier IS NULL;

package/migrations/drizzle-nexus/20260412000001_t529-nexus-graph-tables/migration.sql

@@ -0,0 +1,49 @@
+CREATE TABLE IF NOT EXISTS `nexus_nodes` (
+	`id` text PRIMARY KEY,
+	`project_id` text NOT NULL,
+	`kind` text NOT NULL,
+	`label` text NOT NULL,
+	`name` text,
+	`file_path` text,
+	`start_line` integer,
+	`end_line` integer,
+	`language` text,
+	`is_exported` integer DEFAULT false NOT NULL,
+	`parent_id` text,
+	`parameters_json` text,
+	`return_type` text,
+	`doc_summary` text,
+	`community_id` text,
+	`meta_json` text,
+	`indexed_at` text DEFAULT (datetime('now')) NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `nexus_relations` (
+	`id` text PRIMARY KEY,
+	`project_id` text NOT NULL,
+	`source_id` text NOT NULL,
+	`target_id` text NOT NULL,
+	`type` text NOT NULL,
+	`confidence` real NOT NULL,
+	`reason` text,
+	`step` integer,
+	`indexed_at` text DEFAULT (datetime('now')) NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_project` ON `nexus_nodes` (`project_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_kind` ON `nexus_nodes` (`kind`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_file` ON `nexus_nodes` (`file_path`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_name` ON `nexus_nodes` (`name`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_project_kind` ON `nexus_nodes` (`project_id`,`kind`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_project_file` ON `nexus_nodes` (`project_id`,`file_path`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_community` ON `nexus_nodes` (`community_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_parent` ON `nexus_nodes` (`parent_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_nodes_exported` ON `nexus_nodes` (`is_exported`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_project` ON `nexus_relations` (`project_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_source` ON `nexus_relations` (`source_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_target` ON `nexus_relations` (`target_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_type` ON `nexus_relations` (`type`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_project_type` ON `nexus_relations` (`project_id`,`type`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_source_type` ON `nexus_relations` (`source_id`,`type`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_target_type` ON `nexus_relations` (`target_id`,`type`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_nexus_relations_confidence` ON `nexus_relations` (`confidence`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.4.31",
+  "version": "2026.4.35",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,13 +47,13 @@
     "write-file-atomic": "^7.0.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@cleocode/adapters": "2026.4.31",
-    "@cleocode/agents": "2026.4.31",
-    "@cleocode/caamp": "2026.4.31",
-    "@cleocode/contracts": "2026.4.31",
-    "@cleocode/lafs": "2026.4.31",
-    "@cleocode/nexus": "0.1.0",
-    "@cleocode/skills": "2026.4.31"
+    "@cleocode/adapters": "2026.4.35",
+    "@cleocode/agents": "2026.4.35",
+    "@cleocode/caamp": "2026.4.35",
+    "@cleocode/contracts": "2026.4.35",
+    "@cleocode/lafs": "2026.4.35",
+    "@cleocode/nexus": "2026.4.35",
+    "@cleocode/skills": "2026.4.35"
   },
   "engines": {
     "node": ">=24.0.0"

package/src/hooks/handlers/index.ts

@@ -17,13 +17,19 @@ import './notification-hooks.js';
 import './work-capture-hooks.js';
 import './agent-hooks.js';
 import './context-hooks.js';
+import './watchdog-hooks.js';
+// T549 Wave 5-D/E: Intelligence hooks (best-effort risk detection on task start)
+import './intelligence-hooks.js';
 
 export { handleSubagentStart, handleSubagentStop } from './agent-hooks.js';
 export { handlePostCompact, handlePreCompact } from './context-hooks.js';
 export { handleError } from './error-hooks.js';
 export { handleFileChange } from './file-hooks.js';
+// T549 Wave 5-D/E: Intelligence hook exports
+export { handleTaskStartIntelligence } from './intelligence-hooks.js';
 export { handleSystemNotification } from './notification-hooks.js';
 // Re-export handler functions for explicit use
 export { handleSessionEnd, handleSessionStart } from './session-hooks.js';
 export { handleToolComplete, handleToolStart } from './task-hooks.js';
+export { handleWatchdogStart, handleWatchdogStop } from './watchdog-hooks.js';
 export { handleWorkPromptSubmit, handleWorkResponseComplete } from './work-capture-hooks.js';

package/src/hooks/handlers/intelligence-hooks.ts

@@ -0,0 +1,80 @@
+/**
+ * Intelligence Hook Handlers — Wave 5-D/E of T549
+ *
+ * Best-effort intelligence side-effects wired into task lifecycle events.
+ *
+ * On task start → calculate risk; if riskScore exceeds the HIGH threshold
+ * (≥ 0.8), store a warning observation so future agents see it.
+ *
+ * All handlers are fire-and-forget: failures MUST NOT propagate or block the
+ * operation that triggered them.
+ *
+ * @task T549
+ * @epic T549
+ */
+
+import { hooks } from '../registry.js';
+import type { PreToolUsePayload } from '../types.js';
+
+// Risk thresholds — mirror RISK_THRESHOLDS in intelligence/prediction.ts
+const RISK_HIGH = 0.8;
+
+// ============================================================================
+// Task Start — Risk Detection
+// ============================================================================
+
+/**
+ * Handle task start: calculate risk and store a warning observation if the
+ * riskScore is at or above the HIGH threshold (≥ 0.8).
+ *
+ * Uses deferred imports so this module can be imported in environments where
+ * not all transitive dependencies (brain.db, tasks.db) are present.
+ *
+ * Best-effort: any error is silently swallowed.
+ */
+export async function handleTaskStartIntelligence(
+  projectRoot: string,
+  payload: PreToolUsePayload,
+): Promise<void> {
+  try {
+    // Deferred relative imports — avoids circular dependency issues and keeps
+    // this module loadable in environments where brain.db is not initialised.
+    const { getAccessor } = await import('../../store/data-accessor.js');
+    const { getBrainAccessor } = await import('../../store/brain-accessor.js');
+    const { calculateTaskRisk } = await import('../../intelligence/prediction.js');
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+
+    const [accessor, brain] = await Promise.all([
+      getAccessor(projectRoot),
+      getBrainAccessor(projectRoot),
+    ]);
+
+    const risk = await calculateTaskRisk(payload.taskId, accessor, brain);
+
+    if (risk.riskScore >= RISK_HIGH) {
+      const level = risk.riskScore >= 0.95 ? 'critical' : 'high';
+      const factorNames = risk.factors.map((f) => f.name).join(', ');
+      await observeBrain(projectRoot, {
+        text: `Risk alert for ${payload.taskId} (score ${risk.riskScore.toFixed(2)}): ${factorNames}. ${risk.recommendation}`,
+        title: `Task risk: ${level} — ${payload.taskId}`,
+        type: 'discovery',
+        sourceType: 'agent',
+      });
+    }
+  } catch {
+    // Best-effort — never block task start
+  }
+}
+
+// ============================================================================
+// Registration
+// ============================================================================
+
+hooks.register({
+  id: 'intelligence-task-start',
+  event: 'PreToolUse',
+  handler: handleTaskStartIntelligence,
+  // Priority 50: runs after brain-tool-start (100) so the task observation is
+  // already persisted before we assess risk.
+  priority: 50,
+});

package/src/hooks/handlers/session-hooks.ts

@@ -13,6 +13,8 @@
  * T527: Removed duplicate session observeBrain writes — session data already
  *       lives in the sessions table; writing it again to brain_observations
  *       was pure noise.
+ * T549 Wave 3-E: Fire-and-forget sleep-time consolidation on session end.
+ *       Runs after backup (priority 5) so brain.db snapshot is captured first.
  */
 
 import { hooks } from '../registry.js';
@@ -109,6 +111,36 @@ export async function handleSessionEndBackup(
   }
 }
 
+/**
+ * Handle SessionEnd — fire-and-forget sleep-time memory consolidation.
+ *
+ * T549 Wave 3-E: Runs the full consolidation pipeline (dedup, quality recompute,
+ * tier promotion, contradiction detection, soft eviction, graph strengthening,
+ * summary generation) in the background after the session backup has completed.
+ *
+ * Uses setImmediate to yield control so the session end flow completes before
+ * consolidation begins. Consolidation errors are caught and logged to console.warn
+ * — they MUST NOT block session end or throw to callers.
+ *
+ * Priority 5 ensures this runs last (after backup at priority 10).
+ */
+export async function handleSessionEndConsolidation(
+  projectRoot: string,
+  _payload: SessionEndPayload,
+): Promise<void> {
+  // Schedule consolidation to run after the current event loop turn.
+  // This ensures the session end response reaches the caller before
+  // consolidation begins, matching the "sleep-time compute" pattern.
+  setImmediate(async () => {
+    try {
+      const { runConsolidation } = await import('../../memory/brain-lifecycle.js');
+      await runConsolidation(projectRoot);
+    } catch (err) {
+      console.warn('[consolidation] Session-end consolidation failed:', err);
+    }
+  });
+}
+
 // Register handlers on module load
 hooks.register({
   id: 'brain-session-start',
@@ -133,3 +165,12 @@ hooks.register({
   handler: handleSessionEndBackup,
   priority: 10,
 });
+
+// Priority 5 runs AFTER backup (priority 10) — consolidation is purely
+// additive and should not delay the backup point-in-time snapshot.
+hooks.register({
+  id: 'consolidation-session-end',
+  event: 'SessionEnd',
+  handler: handleSessionEndConsolidation,
+  priority: 5,
+});