@cleocode/core 2026.4.37 → 2026.4.38

package/src/memory/index.ts

@@ -1506,3 +1506,5 @@ export * from './extraction-gate.js';
 export * from './learnings.js';
 // === JSONL Memory modules (legacy, still active) ===
 export * from './patterns.js';
+// === BRAIN Quality Feedback Loop (T555) ===
+export * from './quality-feedback.js';

package/src/memory/learnings.ts

@@ -14,6 +14,7 @@ import { randomBytes } from 'node:crypto';
 import { getBrainAccessor } from '../store/brain-accessor.js';
 import { upsertGraphNode } from './graph-auto-populate.js';
 import { computeLearningQuality } from './quality-scoring.js';
+import { detectSupersession, supersedeMemory } from './temporal-supersession.js';
 
 /** Parameters for storing a new learning. */
 export interface StoreLearningParams {
@@ -161,6 +162,29 @@ export async function storeLearning(projectRoot: string, params: StoreLearningPa
     /* best-effort */
   });
 
+  // Detect supersession: check if this new learning supersedes any existing ones.
+  // Fire-and-forget — never block the primary return.
+  detectSupersession(projectRoot, {
+    id: saved.id,
+    text: saved.insight,
+    createdAt: saved.createdAt ?? new Date().toISOString().replace('T', ' ').slice(0, 19),
+  })
+    .then((candidates) => {
+      for (const candidate of candidates) {
+        supersedeMemory(
+          projectRoot,
+          candidate.existingId,
+          saved.id,
+          'auto:learning-supersedes — high overlap detected at store time',
+        ).catch(() => {
+          /* best-effort */
+        });
+      }
+    })
+    .catch(() => {
+      /* best-effort */
+    });
+
   return {
     ...saved,
     applicableTypes: JSON.parse(saved.applicableTypesJson || '[]'),

package/src/memory/patterns.ts

@@ -14,6 +14,7 @@ import { randomBytes } from 'node:crypto';
 import { getBrainAccessor } from '../store/brain-accessor.js';
 import { upsertGraphNode } from './graph-auto-populate.js';
 import { computePatternQuality } from './quality-scoring.js';
+import { detectSupersession, supersedeMemory } from './temporal-supersession.js';
 
 /** Pattern types from ADR-009. */
 export type PatternType = 'workflow' | 'blocker' | 'success' | 'failure' | 'optimization';
@@ -179,6 +180,29 @@ export async function storePattern(projectRoot: string, params: StorePatternPara
     /* best-effort */
   });
 
+  // Detect supersession: check if this new pattern supersedes any existing ones.
+  // Fire-and-forget — never block the primary return.
+  detectSupersession(projectRoot, {
+    id: saved.id,
+    text: saved.pattern + ' ' + saved.context,
+    createdAt: saved.extractedAt ?? new Date().toISOString().replace('T', ' ').slice(0, 19),
+  })
+    .then((candidates) => {
+      for (const candidate of candidates) {
+        supersedeMemory(
+          projectRoot,
+          candidate.existingId,
+          saved.id,
+          'auto:pattern-supersedes — high overlap detected at store time',
+        ).catch(() => {
+          /* best-effort */
+        });
+      }
+    })
+    .catch(() => {
+      /* best-effort */
+    });
+
   return {
     ...saved,
     examples: JSON.parse(saved.examplesJson || '[]'),