@cleocode/core 2026.4.46 → 2026.4.48

package/dist/memory/brain-lifecycle.d.ts

@@ -83,14 +83,21 @@ export interface PromotionResult {
 /**
  * Run tier promotion for all memory tables.
  *
- * Promotion rules (per spec §1.1–§1.3):
- * - short → medium: citationCount >= 3 AND age > 24h AND verified = true
- *   OR qualityScore >= 0.7 AND verified = true (fast-track)
- * - medium → long:  citationCount >= 5 AND age > 7 days AND verified = true
+ * Promotion rules (per spec §1.1–§1.3, relaxed in T614):
+ * - short → medium:
+ *     A. (citationCount >= 3 AND age > 24h) — citation-based track
+ *     B. (qualityScore >= 0.7 AND age > 24h) — quality fast-track
+ *     C. (verified = true AND age > 24h) — owner-verified track
+ *   Note: `verified` is no longer a hard gate for routes A and B.
+ *   Requiring verified=true on all paths caused all 235 short-tier observations
+ *   to be permanently stuck (T614 bug).
+ * - medium → long:
+ *     (citationCount >= 5 AND age > 7 days) OR (verified = true AND age > 7 days)
+ *   Verified entries accelerate to long-tier without citation threshold.
  *
  * Eviction rules:
- * - short-term entries older than shortTermEvictionDays (default 7) with no
- *   promotion eligibility are soft-evicted (invalidAt = now).
+ * - short-term entries older than 7 days with no promotion eligibility are
+ *   soft-evicted (invalidAt = now).
  * - long-term entries are NEVER auto-evicted.
  *
  * @param projectRoot - Project root directory for brain.db resolution

package/dist/memory/brain-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain-lifecycle.d.ts","sourceRoot":"","sources":["../../src/memory/brain-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,WAAW,CAAC,CAqCtB;AAMD,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmID;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,mBAAmB,CAAC,CA+G9B;AAMD,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmKpF;AAMD,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,cAAc,EAAE,eAAe,CAAC;IAChC,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkF3F"}
+{"version":3,"file":"brain-lifecycle.d.ts","sourceRoot":"","sources":["../../src/memory/brain-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,WAAW,CAAC,CAqCtB;AAMD,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmID;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,mBAAmB,CAAC,CA+G9B;AAMD,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAuKpF;AAMD,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,cAAc,EAAE,eAAe,CAAC;IAChC,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkF3F"}

package/dist/memory/brain-maintenance.d.ts

@@ -48,6 +48,13 @@ export interface BrainMaintenanceEmbeddingsResult {
     /** Observations that failed embedding. */
     errors: number;
 }
+/** Tier promotion step result. */
+export interface BrainMaintenanceTierPromotionResult {
+    /** Number of entries promoted (short→medium or medium→long). */
+    promoted: number;
+    /** Number of stale short-tier entries soft-evicted. */
+    evicted: number;
+}
 /**
  * Aggregated result from a full brain maintenance run.
  *
@@ -61,6 +68,8 @@ export interface BrainMaintenanceResult {
     consolidation: BrainMaintenanceConsolidationResult;
     /** Results from the cross-DB orphaned reference reconciliation step. */
     reconciliation: BrainMaintenanceReconciliationResult;
+    /** Results from the tier promotion step. */
+    tierPromotion: BrainMaintenanceTierPromotionResult;
     /** Results from the embedding backfill step. */
     embeddings: BrainMaintenanceEmbeddingsResult;
     /** Total wall-clock duration of the maintenance run in milliseconds. */
@@ -79,6 +88,8 @@ export interface BrainMaintenanceOptions {
     skipConsolidation?: boolean;
     /** Skip the cross-DB orphaned reference reconciliation step. Default: false. */
     skipReconciliation?: boolean;
+    /** Skip the tier promotion step (short→medium, medium→long). Default: false. */
+    skipTierPromotion?: boolean;
     /** Skip the embedding backfill step. Default: false. */
     skipEmbeddings?: boolean;
     /**

package/dist/memory/brain-maintenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain-maintenance.d.ts","sourceRoot":"","sources":["../../src/memory/brain-maintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,oEAAoE;AACpE,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mCAAmC;IAClD,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,oCAAoC;IACnD,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,WAAW,gCAAgC;IAC/C,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,KAAK,EAAE,2BAA2B,CAAC;IACnC,kDAAkD;IAClD,aAAa,EAAE,mCAAmC,CAAC;IACnD,wEAAwE;IACxE,cAAc,EAAE,oCAAoC,CAAC;IACrD,gDAAgD;IAChD,UAAU,EAAE,gCAAgC,CAAC;IAC7C,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAuEjC"}
+{"version":3,"file":"brain-maintenance.d.ts","sourceRoot":"","sources":["../../src/memory/brain-maintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,oEAAoE;AACpE,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mCAAmC;IAClD,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,oCAAoC;IACnD,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,WAAW,gCAAgC;IAC/C,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,mCAAmC;IAClD,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,KAAK,EAAE,2BAA2B,CAAC;IACnC,kDAAkD;IAClD,aAAa,EAAE,mCAAmC,CAAC;IACnD,wEAAwE;IACxE,cAAc,EAAE,oCAAoC,CAAC;IACrD,4CAA4C;IAC5C,aAAa,EAAE,mCAAmC,CAAC;IACnD,gDAAgD;IAChD,UAAU,EAAE,gCAAgC,CAAC;IAC7C,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAoFjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.4.46",
+  "version": "2026.4.48",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,16 @@
       "import": "./dist/conduit/index.js",
       "require": "./dist/conduit/index.js"
     },
+    "./store/*": {
+      "types": "./dist/store/*.d.ts",
+      "import": "./dist/store/*.js",
+      "require": "./dist/store/*.js"
+    },
+    "./conduit/*": {
+      "types": "./dist/conduit/*.d.ts",
+      "import": "./dist/conduit/*.js",
+      "require": "./dist/conduit/*.js"
+    },
     "./*": {
       "types": "./dist/*.d.ts",
       "import": "./dist/*.js",
@@ -53,13 +63,13 @@
     "write-file-atomic": "^7.0.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@cleocode/adapters": "2026.4.46",
-    "@cleocode/caamp": "2026.4.46",
-    "@cleocode/agents": "2026.4.46",
-    "@cleocode/lafs": "2026.4.46",
-    "@cleocode/contracts": "2026.4.46",
-    "@cleocode/nexus": "2026.4.46",
-    "@cleocode/skills": "2026.4.46"
+    "@cleocode/adapters": "2026.4.48",
+    "@cleocode/agents": "2026.4.48",
+    "@cleocode/caamp": "2026.4.48",
+    "@cleocode/contracts": "2026.4.48",
+    "@cleocode/lafs": "2026.4.48",
+    "@cleocode/nexus": "2026.4.48",
+    "@cleocode/skills": "2026.4.48"
   },
   "engines": {
     "node": ">=24.0.0"

package/src/internal.ts

@@ -170,9 +170,21 @@ export { STAGE_DEFINITIONS } from './lifecycle/stages.js';
 export { instantiateTessera, showTessera } from './lifecycle/tessera-engine.js';
 export type { BrainBackfillResult } from './memory/brain-backfill.js';
 export { backfillBrainGraph } from './memory/brain-backfill.js';
-// Memory — brain lifecycle (temporal decay + consolidation)
-export type { ConsolidationResult, DecayResult } from './memory/brain-lifecycle.js';
-export { applyTemporalDecay, consolidateMemories } from './memory/brain-lifecycle.js';
+// Memory — brain lifecycle (temporal decay + consolidation + tier promotion)
+export type {
+  ConsolidationResult,
+  DecayResult,
+  EvictionRecord,
+  PromotionRecord,
+  PromotionResult,
+  RunConsolidationResult,
+} from './memory/brain-lifecycle.js';
+export {
+  applyTemporalDecay,
+  consolidateMemories,
+  runConsolidation,
+  runTierPromotion,
+} from './memory/brain-lifecycle.js';
 // Memory — brain maintenance
 export type {
   BrainMaintenanceConsolidationResult,
@@ -181,6 +193,7 @@ export type {
   BrainMaintenanceOptions,
   BrainMaintenanceReconciliationResult,
   BrainMaintenanceResult,
+  BrainMaintenanceTierPromotionResult,
 } from './memory/brain-maintenance.js';
 export { runBrainMaintenance } from './memory/brain-maintenance.js';
 export type { PurgeResult } from './memory/brain-purge.js';

package/src/memory/__tests__/brain-automation.test.ts

@@ -46,6 +46,7 @@ vi.mock('../brain-retrieval.js', () => ({
 vi.mock('../brain-lifecycle.js', () => ({
   applyTemporalDecay: vi.fn().mockResolvedValue({ updated: 3 }),
   consolidateMemories: vi.fn().mockResolvedValue({ merged: 2, archived: 4 }),
+  runTierPromotion: vi.fn().mockResolvedValue({ promoted: [], evicted: [] }),
 }));
 
 // Mock auto-extract dependencies

package/src/memory/__tests__/brain-lifecycle-tier-promotion.test.ts

@@ -0,0 +1,367 @@
+/**
+ * Tests for runTierPromotion in brain-lifecycle.ts (T614 fix).
+ *
+ * Verifies that tier promotion correctly promotes entries from short → medium
+ * and medium → long based on quality score, citation count, verification status,
+ * and age thresholds — WITHOUT requiring `verified = true` as a hard gate for
+ * the quality/citation tracks (T614 bug fix).
+ *
+ * @task T614
+ * @epic T569
+ */
+
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+// ============================================================================
+// Hoisted mock factories
+// ============================================================================
+
+const { mockGetBrainDb, mockGetBrainNativeDb } = vi.hoisted(() => ({
+  mockGetBrainDb: vi.fn().mockResolvedValue({}),
+  mockGetBrainNativeDb: vi.fn(),
+}));
+
+vi.mock('../../store/brain-sqlite.js', () => ({
+  getBrainDb: mockGetBrainDb,
+  getBrainNativeDb: mockGetBrainNativeDb,
+}));
+
+// ============================================================================
+// Import module under test (after all mocks)
+// ============================================================================
+
+import { runTierPromotion } from '../brain-lifecycle.js';
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+const PROJECT_ROOT = '/fake/project';
+
+/** ISO datetime string for `daysAgo` days before now. */
+function daysAgo(days: number): string {
+  return new Date(Date.now() - days * 24 * 60 * 60 * 1000)
+    .toISOString()
+    .replace('T', ' ')
+    .slice(0, 19);
+}
+
+type PreparedStmt = {
+  run: ReturnType<typeof vi.fn>;
+  get: ReturnType<typeof vi.fn>;
+};
+
+/** Build a minimal SQLite-like prepared statement stub. */
+function makeStmt(rows: unknown[] = []): PreparedStmt {
+  return {
+    run: vi.fn().mockReturnValue({ changes: rows.length }),
+    get: vi.fn().mockReturnValue(rows[0] ?? undefined),
+  };
+}
+
+// ============================================================================
+// Tests
+// ============================================================================
+
+describe('runTierPromotion', () => {
+  let capturedUpdates: Array<{ table: string; id: string; tier: string }> = [];
+
+  beforeEach(() => {
+    capturedUpdates = [];
+  });
+
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('returns empty result when nativeDb is unavailable', async () => {
+    mockGetBrainNativeDb.mockReturnValue(null);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(0);
+    expect(result.evicted).toHaveLength(0);
+  });
+
+  it('promotes unverified observation with quality_score >= 0.7 (T614 fix: no verified gate)', async () => {
+    // This is the core T614 regression test: an unverified (verified=0) observation
+    // with quality_score=0.8 older than 24h MUST promote to medium.
+    const shortObs = [
+      {
+        id: 'O-test-001',
+        citation_count: 0,
+        quality_score: 0.8,
+        verified: 0, // NOT verified — was blocked before T614 fix
+      },
+    ];
+
+    const nativeDb = buildMockDb({
+      brain_observations: {
+        shortToMedium: shortObs,
+        mediumToLong: [],
+        toEvict: [],
+      },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(1);
+    expect(result.promoted[0]).toMatchObject({
+      id: 'O-test-001',
+      table: 'brain_observations',
+      fromTier: 'short',
+      toTier: 'medium',
+    });
+    expect(result.promoted[0]!.reason).toContain('qualityScore=0.80');
+  });
+
+  it('promotes unverified observation with citation_count >= 3 (T614 fix)', async () => {
+    const shortObs = [
+      {
+        id: 'O-test-002',
+        citation_count: 5,
+        quality_score: 0.4, // low quality but high citations
+        verified: 0,
+      },
+    ];
+
+    const nativeDb = buildMockDb({
+      brain_observations: {
+        shortToMedium: shortObs,
+        mediumToLong: [],
+        toEvict: [],
+      },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(1);
+    expect(result.promoted[0]).toMatchObject({
+      id: 'O-test-002',
+      fromTier: 'short',
+      toTier: 'medium',
+    });
+    expect(result.promoted[0]!.reason).toContain('citationCount=5');
+  });
+
+  it('promotes verified observation with any quality (verified track)', async () => {
+    const shortObs = [
+      {
+        id: 'O-test-003',
+        citation_count: 0,
+        quality_score: 0.3, // low quality, low citations, but verified
+        verified: 1,
+      },
+    ];
+
+    const nativeDb = buildMockDb({
+      brain_observations: {
+        shortToMedium: shortObs,
+        mediumToLong: [],
+        toEvict: [],
+      },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(1);
+    expect(result.promoted[0]).toMatchObject({
+      id: 'O-test-003',
+      fromTier: 'short',
+      toTier: 'medium',
+    });
+    expect(result.promoted[0]!.reason).toContain('verified=true');
+  });
+
+  it('promotes medium entry to long with citation_count >= 5 (no verified requirement)', async () => {
+    const mediumObs = [
+      {
+        id: 'O-test-004',
+        citation_count: 7,
+        quality_score: 0.9,
+        verified: 0, // not verified but high citations
+      },
+    ];
+
+    const nativeDb = buildMockDb({
+      brain_observations: {
+        shortToMedium: [],
+        mediumToLong: mediumObs,
+        toEvict: [],
+      },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(1);
+    expect(result.promoted[0]).toMatchObject({
+      id: 'O-test-004',
+      fromTier: 'medium',
+      toTier: 'long',
+    });
+    expect(result.promoted[0]!.reason).toContain('citationCount=7');
+  });
+
+  it('promotes verified medium entry to long (accelerated track)', async () => {
+    const mediumObs = [
+      {
+        id: 'O-test-005',
+        citation_count: 1, // only 1 citation but verified
+        quality_score: 0.6,
+        verified: 1,
+      },
+    ];
+
+    const nativeDb = buildMockDb({
+      brain_observations: {
+        shortToMedium: [],
+        mediumToLong: mediumObs,
+        toEvict: [],
+      },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(1);
+    expect(result.promoted[0]).toMatchObject({
+      id: 'O-test-005',
+      fromTier: 'medium',
+      toTier: 'long',
+    });
+    expect(result.promoted[0]!.reason).toContain('verified=true');
+  });
+
+  it('soft-evicts stale short entries with low quality and no promotion', async () => {
+    const staleObs = [
+      {
+        id: 'O-test-006',
+        quality_score: 0.1,
+      },
+    ];
+
+    const nativeDb = buildMockDb({
+      brain_observations: {
+        shortToMedium: [],
+        mediumToLong: [],
+        toEvict: staleObs,
+      },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.evicted).toHaveLength(1);
+    expect(result.evicted[0]).toMatchObject({
+      id: 'O-test-006',
+      table: 'brain_observations',
+      tier: 'short',
+    });
+    expect(result.promoted).toHaveLength(0);
+  });
+
+  it('processes all four memory tables', async () => {
+    // Each table should get one promotion
+    const obsRow = [{ id: 'O-obs', citation_count: 5, quality_score: 0.8, verified: 0 }];
+    const learningRow = [{ id: 'L-learn', citation_count: 0, quality_score: 0.75, verified: 0 }];
+    const patternRow = [{ id: 'P-pat', citation_count: 3, quality_score: 0.5, verified: 0 }];
+    const decisionRow = [{ id: 'D-dec', citation_count: 0, quality_score: 0.0, verified: 1 }];
+
+    const nativeDb = buildMockDb({
+      brain_observations: { shortToMedium: obsRow, mediumToLong: [], toEvict: [] },
+      brain_learnings: { shortToMedium: learningRow, mediumToLong: [], toEvict: [] },
+      brain_patterns: { shortToMedium: patternRow, mediumToLong: [], toEvict: [] },
+      brain_decisions: { shortToMedium: decisionRow, mediumToLong: [], toEvict: [] },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(4);
+    const promotedTables = result.promoted.map((p) => p.table);
+    expect(promotedTables).toContain('brain_observations');
+    expect(promotedTables).toContain('brain_learnings');
+    expect(promotedTables).toContain('brain_patterns');
+    expect(promotedTables).toContain('brain_decisions');
+  });
+
+  it('returns empty result when no entries qualify', async () => {
+    const nativeDb = buildMockDb({
+      brain_observations: { shortToMedium: [], mediumToLong: [], toEvict: [] },
+      brain_learnings: { shortToMedium: [], mediumToLong: [], toEvict: [] },
+      brain_patterns: { shortToMedium: [], mediumToLong: [], toEvict: [] },
+      brain_decisions: { shortToMedium: [], mediumToLong: [], toEvict: [] },
+    });
+    mockGetBrainNativeDb.mockReturnValue(nativeDb);
+
+    const result = await runTierPromotion(PROJECT_ROOT);
+
+    expect(result.promoted).toHaveLength(0);
+    expect(result.evicted).toHaveLength(0);
+  });
+});
+
+// ============================================================================
+// Helper: build a mock nativeDb that routes prepare() calls based on SQL content
+// ============================================================================
+
+type TableFixtures = {
+  shortToMedium: unknown[];
+  mediumToLong: unknown[];
+  toEvict: unknown[];
+};
+
+function buildMockDb(tables: Partial<Record<string, TableFixtures>>): {
+  prepare: ReturnType<typeof vi.fn>;
+} {
+  const allTables = ['brain_observations', 'brain_learnings', 'brain_patterns', 'brain_decisions'];
+
+  // Normalise: every table gets a default empty fixture
+  const fixtures: Record<string, TableFixtures> = {};
+  for (const t of allTables) {
+    fixtures[t] = tables[t] ?? { shortToMedium: [], mediumToLong: [], toEvict: [] };
+  }
+
+  return {
+    prepare: vi.fn().mockImplementation((sql: string) => {
+      // Determine which table this statement targets
+      const targetTable = allTables.find((t) => sql.includes(t)) ?? 'brain_observations';
+      const fix = fixtures[targetTable]!;
+
+      // SELECT for eviction — identified by "(verified = 0 OR verified IS NULL)"
+      // Must be checked BEFORE the short-promotion check since both use memory_tier='short'
+      if (sql.includes('verified = 0') || sql.includes('verified IS NULL')) {
+        return {
+          all: vi.fn().mockReturnValue(fix.toEvict),
+        };
+      }
+      // SELECT for short→medium promotion — uses "(citation_count >= 3 OR quality_score >= 0.7 OR verified = 1)"
+      if (sql.includes("memory_tier = 'short'") && sql.includes('SELECT')) {
+        return {
+          all: vi.fn().mockReturnValue(fix.shortToMedium),
+        };
+      }
+      // SELECT for medium→long promotion
+      if (sql.includes("memory_tier = 'medium'") && sql.includes('SELECT')) {
+        return {
+          all: vi.fn().mockReturnValue(fix.mediumToLong),
+        };
+      }
+      // UPDATE statements (tier change, eviction)
+      if (sql.includes('UPDATE')) {
+        return {
+          run: vi.fn().mockReturnValue({ changes: 1 }),
+        };
+      }
+      // Fallback: SELECT returning empty
+      return {
+        all: vi.fn().mockReturnValue([]),
+        run: vi.fn().mockReturnValue({ changes: 0 }),
+      };
+    }),
+  };
+}

package/src/memory/brain-lifecycle.ts

@@ -381,14 +381,21 @@ export interface PromotionResult {
 /**
  * Run tier promotion for all memory tables.
  *
- * Promotion rules (per spec §1.1–§1.3):
- * - short → medium: citationCount >= 3 AND age > 24h AND verified = true
- *   OR qualityScore >= 0.7 AND verified = true (fast-track)
- * - medium → long:  citationCount >= 5 AND age > 7 days AND verified = true
+ * Promotion rules (per spec §1.1–§1.3, relaxed in T614):
+ * - short → medium:
+ *     A. (citationCount >= 3 AND age > 24h) — citation-based track
+ *     B. (qualityScore >= 0.7 AND age > 24h) — quality fast-track
+ *     C. (verified = true AND age > 24h) — owner-verified track
+ *   Note: `verified` is no longer a hard gate for routes A and B.
+ *   Requiring verified=true on all paths caused all 235 short-tier observations
+ *   to be permanently stuck (T614 bug).
+ * - medium → long:
+ *     (citationCount >= 5 AND age > 7 days) OR (verified = true AND age > 7 days)
+ *   Verified entries accelerate to long-tier without citation threshold.
  *
  * Eviction rules:
- * - short-term entries older than shortTermEvictionDays (default 7) with no
- *   promotion eligibility are soft-evicted (invalidAt = now).
+ * - short-term entries older than 7 days with no promotion eligibility are
+ *   soft-evicted (invalidAt = now).
  * - long-term entries are NEVER auto-evicted.
  *
  * @param projectRoot - Project root directory for brain.db resolution
@@ -431,25 +438,30 @@ export async function runTierPromotion(projectRoot: string): Promise<PromotionRe
 
   for (const { table, dateCol } of tables) {
     // --- short → medium promotion ---
-    // Two criteria (union):
-    //   A. citationCount >= 3 AND age > 24h AND verified = 1
-    //   B. quality_score >= 0.7 AND verified = 1 AND age > 24h (fast-track)
+    // Three criteria (union — verified is no longer a hard gate for A/B paths):
+    //   A. citationCount >= 3 AND age > 24h  (citation track — no verified requirement)
+    //   B. quality_score >= 0.7 AND age > 24h (quality fast-track — no verified requirement)
+    //   C. verified = 1 AND age > 24h         (owner-verified track)
     interface TierRow {
       id: string;
       citation_count: number;
       quality_score: number | null;
+      verified: number;
     }
     let shortToMedium: TierRow[] = [];
     try {
       shortToMedium = typedAll<TierRow>(
         nativeDb.prepare(`
-          SELECT id, citation_count, quality_score
+          SELECT id, citation_count, quality_score, verified
           FROM ${table}
           WHERE memory_tier = 'short'
             AND invalid_at IS NULL
             AND ${dateCol} < ?
-            AND verified = 1
-            AND (citation_count >= 3 OR quality_score >= 0.7)
+            AND (
+              citation_count >= 3
+              OR quality_score >= 0.7
+              OR verified = 1
+            )
         `),
         age24h,
       );
@@ -463,33 +475,34 @@ export async function runTierPromotion(projectRoot: string): Promise<PromotionRe
         nativeDb
           .prepare(`UPDATE ${table} SET memory_tier = 'medium', updated_at = ? WHERE id = ?`)
           .run(now, row.id);
-        promoted.push({
-          id: row.id,
-          table,
-          fromTier: 'short',
-          toTier: 'medium',
-          reason:
-            row.citation_count >= 3
-              ? `citationCount=${row.citation_count} >= 3, verified, age > 24h`
-              : `qualityScore=${row.quality_score?.toFixed(2)} >= 0.70, verified, age > 24h`,
-        });
+        let reason: string;
+        if (row.citation_count >= 3) {
+          reason = `citationCount=${row.citation_count} >= 3, age > 24h`;
+        } else if ((row.quality_score ?? 0) >= 0.7) {
+          reason = `qualityScore=${row.quality_score?.toFixed(2)} >= 0.70, age > 24h`;
+        } else {
+          reason = `verified=true, age > 24h`;
+        }
+        promoted.push({ id: row.id, table, fromTier: 'short', toTier: 'medium', reason });
       } catch {
         /* best-effort */
       }
     }
 
     // --- medium → long promotion ---
+    // Two criteria (union — verified accelerates to long without citation threshold):
+    //   A. citationCount >= 5 AND age > 7d
+    //   B. verified = 1 AND age > 7d (owner-verified accelerated track)
     let mediumToLong: TierRow[] = [];
     try {
       mediumToLong = typedAll<TierRow>(
         nativeDb.prepare(`
-          SELECT id, citation_count, quality_score
+          SELECT id, citation_count, quality_score, verified
           FROM ${table}
           WHERE memory_tier = 'medium'
             AND invalid_at IS NULL
             AND ${dateCol} < ?
-            AND verified = 1
-            AND citation_count >= 5
+            AND (citation_count >= 5 OR verified = 1)
         `),
         age7d,
       );
@@ -502,13 +515,11 @@ export async function runTierPromotion(projectRoot: string): Promise<PromotionRe
         nativeDb
           .prepare(`UPDATE ${table} SET memory_tier = 'long', updated_at = ? WHERE id = ?`)
           .run(now, row.id);
-        promoted.push({
-          id: row.id,
-          table,
-          fromTier: 'medium',
-          toTier: 'long',
-          reason: `citationCount=${row.citation_count} >= 5, verified, age > 7d`,
-        });
+        const reason =
+          row.citation_count >= 5
+            ? `citationCount=${row.citation_count} >= 5, age > 7d`
+            : `verified=true, age > 7d`;
+        promoted.push({ id: row.id, table, fromTier: 'medium', toTier: 'long', reason });
       } catch {
         /* best-effort */
       }