@cleocode/core 2026.4.45 → 2026.4.47

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/dist/store/db-helpers.d.ts

@@ -22,10 +22,15 @@ export interface ArchiveFields {
  * Upsert a single task row into the tasks table.
  * Handles both active task upsert and archived task upsert via optional archiveFields.
  *
- * Defensively nulls out parentId if it references a non-existent task,
- * preventing orphaned FK violations from blocking bulk operations (T5034).
+ * When `allowOrphanParent` is true (bulk/migration mode, T5034): silently nulls out
+ * parentId if the referenced parent does not exist, preventing FK violations.
+ * When false (normal single-task writes, default): logs a warning but still proceeds
+ * so that FK enforcement at the DB level provides the final safety net.
+ *
+ * Callers that perform bulk imports or archive restoration should pass
+ * `allowOrphanParent: true` to enable the lenient behavior.
  */
-export declare function upsertTask(db: DrizzleDb, row: NewTaskRow, archiveFields?: ArchiveFields): Promise<void>;
+export declare function upsertTask(db: DrizzleDb, row: NewTaskRow, archiveFields?: ArchiveFields, allowOrphanParent?: boolean): Promise<void>;
 /**
  * Upsert a single session row into the sessions table.
  */

package/dist/store/db-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-helpers.d.ts","sourceRoot":"","sources":["../../src/store/db-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,sCAAsC;AACtC,KAAK,SAAS,GAAG,kBAAkB,CAAC,OAAO,MAAM,CAAC,CAAC;AAEnD,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwDf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkClF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAChD,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,IAAI,EAAE,EACb,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BvF"}
+{"version":3,"file":"db-helpers.d.ts","sourceRoot":"","sources":["../../src/store/db-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAI5C,sCAAsC;AACtC,KAAK,SAAS,GAAG,kBAAkB,CAAC,OAAO,MAAM,CAAC,CAAC;AAEnD,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,aAAa,EAC7B,iBAAiB,UAAQ,GACxB,OAAO,CAAC,IAAI,CAAC,CAoEf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkClF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAChD,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,IAAI,EAAE,EACb,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BvF"}

package/dist/store/sqlite-data-accessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-data-accessor.d.ts","sourceRoot":"","sources":["../../src/store/sqlite-data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAEV,YAAY,EAKb,MAAM,oBAAoB,CAAC;AA0C5B,yDAAyD;AACzD,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAWf;AAID;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAw1BlF"}
+{"version":3,"file":"sqlite-data-accessor.d.ts","sourceRoot":"","sources":["../../src/store/sqlite-data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAEV,YAAY,EAKb,MAAM,oBAAoB,CAAC;AA0C5B,yDAAyD;AACzD,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAWf;AAID;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAy1BlF"}

package/dist/tasks/complete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/tasks/complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAoB,MAAM,qBAAqB,CAAC;AAM3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;CACvD;AAiED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAmQ7B"}
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/tasks/complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAoB,MAAM,qBAAqB,CAAC;AAM3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;CACvD;AAiED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAsQ7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.4.45",
+  "version": "2026.4.47",
   "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.45",
-    "@cleocode/agents": "2026.4.45",
-    "@cleocode/caamp": "2026.4.45",
-    "@cleocode/lafs": "2026.4.45",
-    "@cleocode/contracts": "2026.4.45",
-    "@cleocode/nexus": "2026.4.45",
-    "@cleocode/skills": "2026.4.45"
+    "@cleocode/adapters": "2026.4.47",
+    "@cleocode/agents": "2026.4.47",
+    "@cleocode/caamp": "2026.4.47",
+    "@cleocode/lafs": "2026.4.47",
+    "@cleocode/contracts": "2026.4.47",
+    "@cleocode/nexus": "2026.4.47",
+    "@cleocode/skills": "2026.4.47"
   },
   "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 }),
+      };
+    }),
+  };
+}