agent-cache-optimizer 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-cache-optimizer",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Content-agnostic KV cache optimizer for LLM CLI agents — boosts prompt cache hit rate by 40-88% through automatic stability tracking and block reordering",
   "keywords": [
     "kv-cache",

package/src/core.ts

@@ -24,6 +24,7 @@ export function emptyDB(): StabilityDB {
     scores: {},
     contentIndex: {},
     contentScores: {},
+    contentObservations: 0,
     observations: 0,
     updated: 0,
   }
@@ -71,9 +72,11 @@ export function updateContentDB(db: StabilityDB, blocks: string[]): StabilityDB
     }
   }
 
-  // Recompute content scores
+  // Recompute content scores using contentObservations (not observations)
+  db.contentObservations++
+  const obs = Math.max(1, db.contentObservations)
   for (const fp of Object.values(db.contentIndex)) {
-    db.contentScores[fp.hash] = Math.min(1.0, fp.count / Math.max(1, db.observations))
+    db.contentScores[fp.hash] = Math.min(1.0, fp.count / obs)
   }
 
   return db

package/src/heuristics.ts

@@ -78,7 +78,7 @@ export function classify(
 
     // Priority 2: content-addressed score (primary)
     const contentScore = lookupContentScore(db, hash)
-    if (contentScore !== null && db.observations >= 2) {
+    if (contentScore !== null && db.contentObservations >= 2) {
       if (contentScore >= 0.7) { result.stable.push(item); continue }
       if (contentScore <= 0.2) { result.dynamic.push(item); continue }
     }

package/src/index.ts

@@ -37,7 +37,32 @@ function warmCachePath(): string {
 
 function loadDB(agent: string): StabilityDB {
   try {
-    return JSON.parse(readFileSync(dbPath(agent), "utf-8")) as StabilityDB
+    const raw = readFileSync(dbPath(agent), "utf-8")
+    const db = JSON.parse(raw) as StabilityDB
+    // Migrate from pre-0.5.0: rebuild contentIndex from position data
+    if (
+      db.positions &&
+      Object.keys(db.positions).length > 0 &&
+      ((!db.contentIndex || Object.keys(db.contentIndex).length === 0) ||
+        db.contentObservations === undefined)
+    ) {
+      db.contentIndex = {}
+      for (const fps of Object.values(db.positions)) {
+        for (const fp of fps) {
+          const existing = db.contentIndex[fp.hash]
+          if (existing) {
+            existing.count = Math.max(existing.count, fp.count)
+            if (fp.lastSeen > existing.lastSeen) existing.lastSeen = fp.lastSeen
+          } else {
+            db.contentIndex[fp.hash] = { ...fp }
+          }
+        }
+      }
+      db.contentScores = {}
+      db.contentObservations = 0 // warm from scratch for accurate scores
+      saveDB(agent, db)
+    }
+    return db
   } catch {
     return emptyDB()
   }
@@ -190,8 +215,8 @@ export const CacheOptimizerPlugin: Plugin = async () => {
         const warmCount = warmHashes?.size ?? 0
         diag(
           agent,
-          `plugin-loaded agent=${agent} model=${input.model?.id ?? "?"} ` +
-            `warm-hashes=${warmCount}`,
+          `v0.5.2 loaded agent=${agent} model=${input.model?.id ?? "?"} ` +
+            `warm=${warmCount}`,
         )
       }
     },

package/src/types.ts

@@ -24,6 +24,8 @@ export interface StabilityDB {
   contentIndex: Record<string, ContentFingerprint>
   /** Content-addressed scores */
   contentScores: Record<string, number>
+  /** Number of calls that contributed to contentIndex */
+  contentObservations: number
   /** Total observations */
   observations: number
   /** Last write timestamp */