@cleocode/core 2026.4.44 → 2026.4.45

package/dist/store/migration-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-manager.d.ts","sourceRoot":"","sources":["../../src/store/migration-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;CACb;AAOD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASvD;AAiCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,IAAI,CAkIN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAE9B,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC3B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAkCN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,cAAc,EAAE,EACjC,YAAY,EAAE,MAAM,GACnB,IAAI,CAmBN"}
+{"version":3,"file":"migration-manager.d.ts","sourceRoot":"","sources":["../../src/store/migration-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;CACb;AAOD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASvD;AAiCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,IAAI,CAkKN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAE9B,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC3B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAkCN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,cAAc,EAAE,EACjC,YAAY,EAAE,MAAM,GACnB,IAAI,CAmBN"}

package/package.json

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

package/src/store/migration-manager.ts

@@ -144,23 +144,55 @@ export function reconcileJournal(
   }
 
   // Scenario 2: Journal has orphaned entries from a previous CLEO version
+  //
+  // Two distinct sub-cases require different handling:
+  //
+  // A) DB is AHEAD of this install (forward-compatibility): all local hashes
+  //    are present in the DB, but the DB also has additional entries for
+  //    migrations this install does not know about. This happens when a user
+  //    runs a globally-installed (older) cleo binary against a DB that was
+  //    last written by a newer cleo version. Deleting those entries would
+  //    cause an infinite reconciliation cycle: Drizzle re-runs the "missing"
+  //    migrations, hits duplicate-column errors (Scenario 3 recovers), writes
+  //    them back — only for this install to delete them again on the next run.
+  //    ACTION: skip reconciliation, log at debug only.
+  //
+  // B) DB has stale hashes from a genuinely old CLEO version whose checksum
+  //    algorithm produced different hashes for the same migration files (i.e.,
+  //    at least one local hash is MISSING from the DB while other DB entries
+  //    are unrecognised). ACTION: delete and re-seed as before, log at warn.
   if (tableExists(nativeDb, '__drizzle_migrations') && tableExists(nativeDb, existenceTable)) {
     const localMigrations = readMigrationFiles({ migrationsFolder });
     const localHashes = new Set(localMigrations.map((m) => m.hash));
     const dbEntries = nativeDb.prepare('SELECT hash FROM "__drizzle_migrations"').all() as Array<{
       hash: string;
     }>;
-    const hasOrphanedEntries = dbEntries.some((e) => !localHashes.has(e.hash));
+    const orphanedEntries = dbEntries.filter((e) => !localHashes.has(e.hash));
+    const hasOrphanedEntries = orphanedEntries.length > 0;
 
     if (hasOrphanedEntries) {
-      const log = getLogger(logSubsystem);
-      log.warn(
-        { orphaned: dbEntries.filter((e) => !localHashes.has(e.hash)).length },
-        `Detected stale migration journal entries from a previous CLEO version. Reconciling.`,
-      );
-      nativeDb.exec('DELETE FROM "__drizzle_migrations"');
-      for (const m of localMigrations) {
-        insertJournalEntry(nativeDb, m.hash, m.folderMillis, m.name ?? '');
+      const dbHashes = new Set(dbEntries.map((e) => e.hash));
+      const allLocalHashesPresentInDb = localMigrations.every((m) => dbHashes.has(m.hash));
+
+      if (allLocalHashesPresentInDb) {
+        // Sub-case A: DB is ahead — this install is older than the DB.
+        // Do NOT modify the journal; log at debug so we can trace if needed.
+        const log = getLogger(logSubsystem);
+        log.debug(
+          { extra: orphanedEntries.length },
+          `Migration journal has ${orphanedEntries.length} entries for migrations not known to this install (DB is ahead). Skipping reconciliation.`,
+        );
+      } else {
+        // Sub-case B: Genuine stale hashes from an older CLEO version.
+        const log = getLogger(logSubsystem);
+        log.warn(
+          { orphaned: orphanedEntries.length },
+          `Detected stale migration journal entries from a previous CLEO version. Reconciling.`,
+        );
+        nativeDb.exec('DELETE FROM "__drizzle_migrations"');
+        for (const m of localMigrations) {
+          insertJournalEntry(nativeDb, m.hash, m.folderMillis, m.name ?? '');
+        }
       }
     }
   }