circle-ir-ai 2.22.0 → 2.27.0

package/dist/cache/classification-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classification-cache.d.ts","sourceRoot":"","sources":["../../src/cache/classification-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,GAAE,0BAA+B;IAWpD,mEAAmE;IACnE,mBAAmB,IAAI,MAAM;IAI7B,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,OAAO;IAIf,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAmClD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IAwBzD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAIjD,KAAK,IAAI,IAAI;IAeb,KAAK,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CA4BzE;AASD,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,mBAAmB,CAMhG;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
+{"version":3,"file":"classification-cache.d.ts","sourceRoot":"","sources":["../../src/cache/classification-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,WAAW,0BAA0B;IACzC;oEACgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAUD,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,GAAE,0BAA+B;IAQpD,mEAAmE;IACnE,mBAAmB,IAAI,MAAM;IAI7B,6EAA6E;IAC7E,cAAc,IAAI,MAAM;IAIxB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,OAAO;IAIT,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAoC3D,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAclE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,KAAK,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAazG;AASD,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,mBAAmB,CAMhG;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/cache/classification-cache.js

@@ -11,6 +11,11 @@
  * - Cache directory: .cognium/cache/
  * - Hit/miss tracking for observability
  *
+ * Storage is delegated to a `CacheBackend` (cognium-ai#158 Acceptance #4).
+ * Default = `LocalFSBackend` (preserves ≤2.26.0 on-disk shape). Selecting
+ * `LLM_CACHE_BACKEND=r2` swaps to Cloudflare R2 transparently so two
+ * runners on different machines share the same cache.
+ *
  * Model dimension (cognium-ai#151 P0 spike):
  *   When `modelFingerprint` is supplied (typically via
  *   `getPhaseModelFingerprint()` from `../llm/config.ts`) it becomes part
@@ -24,15 +29,16 @@
  *   ≤2.21.0) keep working — the first run after wire-through is a cache
  *   miss only for the call sites that opt into the fingerprint.
  */
-import * as fs from 'fs';
 import * as path from 'path';
 import * as crypto from 'crypto';
+import { makeBackend } from './backends/index.js';
 const DEFAULT_MAX_AGE = 24 * 60 * 60 * 1000; // 24 hours
 export class ClassificationCache {
     cacheDir;
     maxAge;
     enabled;
     modelFingerprint;
+    backend;
     memoryCache = new Map();
     hits = 0;
     misses = 0;
@@ -41,14 +47,16 @@ export class ClassificationCache {
         this.maxAge = options.maxAge ?? DEFAULT_MAX_AGE;
         this.enabled = options.enabled ?? true;
         this.modelFingerprint = options.modelFingerprint ?? '';
-        if (this.enabled) {
-            this.ensureCacheDir();
-        }
+        this.backend = options.backend ?? makeBackend(this.cacheDir);
     }
     /** Per-phase model identity used in cache key (cognium-ai#151). */
     getModelFingerprint() {
         return this.modelFingerprint;
     }
+    /** Backend kind identifier (`local-fs` | `memory` | `r2`). Observability. */
+    getBackendKind() {
+        return this.backend.kind;
+    }
     computeKey(content, classifier) {
         // 3-component key when fingerprint present (cognium-ai#151). When
         // empty falls through to the prior 2-component shape via the trailing
@@ -59,118 +67,83 @@ export class ClassificationCache {
             : content + '\0' + classifier;
         return crypto.createHash('sha256').update(parts).digest('hex');
     }
-    getCachePath(key) {
-        const subdir = key.substring(0, 2);
-        return path.join(this.cacheDir, subdir, `${key}.json`);
-    }
-    ensureCacheDir() {
-        if (!fs.existsSync(this.cacheDir)) {
-            fs.mkdirSync(this.cacheDir, { recursive: true });
-        }
-    }
     isValid(entry) {
         return (Date.now() - entry.timestamp) <= this.maxAge;
     }
-    get(content, classifier) {
+    async get(content, classifier) {
         if (!this.enabled)
             return null;
         const key = this.computeKey(content, classifier);
-        // Memory cache
+        // Memory cache (process-local hot path)
         const memEntry = this.memoryCache.get(key);
         if (memEntry && this.isValid(memEntry)) {
             this.hits++;
             return memEntry.result;
         }
-        // Disk cache
-        const cachePath = this.getCachePath(key);
+        // Backend (disk / R2 / etc.)
         try {
-            if (fs.existsSync(cachePath)) {
-                const data = fs.readFileSync(cachePath, 'utf-8');
-                const entry = JSON.parse(data);
+            const raw = await this.backend.get(key);
+            if (raw !== null) {
+                const entry = JSON.parse(raw);
                 if (this.isValid(entry)) {
                     this.memoryCache.set(key, entry);
                     this.hits++;
                     return entry.result;
                 }
-                else {
-                    fs.unlinkSync(cachePath);
+                // Stale — best-effort drop. We don't await the deletion to
+                // keep the read path fast.
+                if (this.backend.delete) {
+                    void this.backend.delete(key);
                 }
             }
         }
         catch {
-            // Ignore read errors
+            // Decode / I/O error: treat as miss.
         }
         this.misses++;
         return null;
     }
-    set(content, classifier, result) {
+    async set(content, classifier, result) {
         if (!this.enabled)
             return;
         const key = this.computeKey(content, classifier);
         const entry = { key, timestamp: Date.now(), result };
         this.memoryCache.set(key, entry);
-        // #31: atomic write (tmp + rename) so concurrent processes don't
-        // corrupt each other's cache files. Same pattern as file-cache.ts.
-        const cachePath = this.getCachePath(key);
-        const cacheSubdir = path.dirname(cachePath);
-        const tmpPath = `${cachePath}.tmp.${process.pid}.${Math.random().toString(36).slice(2, 8)}`;
         try {
-            if (!fs.existsSync(cacheSubdir)) {
-                fs.mkdirSync(cacheSubdir, { recursive: true });
-            }
-            fs.writeFileSync(tmpPath, JSON.stringify(entry));
-            fs.renameSync(tmpPath, cachePath);
+            await this.backend.set(key, JSON.stringify(entry));
         }
         catch {
-            try {
-                fs.unlinkSync(tmpPath);
-            }
-            catch { /* ignore */ }
+            // Cache write is best-effort; never fail the caller.
         }
     }
-    has(content, classifier) {
-        return this.get(content, classifier) !== null;
+    async has(content, classifier) {
+        return (await this.get(content, classifier)) !== null;
     }
-    clear() {
+    async clear() {
         this.memoryCache.clear();
         this.hits = 0;
         this.misses = 0;
-        if (fs.existsSync(this.cacheDir)) {
+        if (this.backend.clear) {
             try {
-                fs.rmSync(this.cacheDir, { recursive: true, force: true });
-                this.ensureCacheDir();
-            }
-            catch {
-                // Ignore errors
+                await this.backend.clear();
             }
+            catch { /* ignore */ }
         }
     }
-    stats() {
+    async stats() {
         let diskEntries = 0;
-        if (fs.existsSync(this.cacheDir)) {
+        if (this.backend.count) {
             try {
-                const subdirs = fs.readdirSync(this.cacheDir);
-                for (const subdir of subdirs) {
-                    const subdirPath = path.join(this.cacheDir, subdir);
-                    try {
-                        if (fs.statSync(subdirPath).isDirectory()) {
-                            diskEntries += fs.readdirSync(subdirPath).length;
-                        }
-                    }
-                    catch {
-                        // Skip unreadable subdirs
-                    }
-                }
-            }
-            catch {
-                // Ignore
+                diskEntries = await this.backend.count();
             }
+            catch { /* ignore */ }
         }
         const total = this.hits + this.misses;
         return {
             memoryEntries: this.memoryCache.size,
             diskEntries,
             hitRate: total > 0 ? this.hits / total : 0,
+            backend: this.backend.kind,
         };
     }
 }

package/dist/cache/classification-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"classification-cache.js","sourceRoot":"","sources":["../../src/cache/classification-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"classification-cache.js","sourceRoot":"","sources":["../../src/cache/classification-cache.ts"],"names":[],"mappings":"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"}

package/dist/cache/discovery-cache.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Discovery Cache
+ *
+ * Persistent on-disk cache for LLM discovery results per (className,
+ * methodName, methodCode, CWE-set) tuple (cognium-ai#134, P2 of epic
+ * #155). Sits in front of the in-memory `_discoveryDedupCache` from
+ * discovery.ts (#136) so that identical method-level discovery requests
+ * survive across processes, CI runs, and developer iterations — not just
+ * within one process.
+ *
+ * Built on top of `ClassificationCache<DiscoveryResult>` (which already
+ * carries the cognium-ai#151 model-fingerprint key dimension), with
+ * discovery-specific key construction:
+ *
+ *   content    = className + '\\0' + methodName + '\\0' +
+ *                SHA-256(methodCode) + '\\0' + sortedCweSet
+ *   classifier = 'discovery-method'
+ *   fingerprint = getPhaseModelFingerprint(config)  // includes discovery model
+ *
+ * Cache directory: `.cognium/cache/discovery/` (separate from the
+ * verify-phase `.cognium/cache/verify/` so each phase can be cleared
+ * independently — `rm -rf .cognium/cache/discovery/` only nukes
+ * discovery entries).
+ *
+ * Invalidation matrix (#134 acceptance criteria):
+ *   - Edit one method     → only that method's entry invalidates
+ *                           (methodCode SHA-256 is part of the key)
+ *   - Add a new CWE       → existing entries still hit for old CWE-sets;
+ *                           new CWE-set requests miss
+ *   - Change disc model   → entire cache invalidates
+ *                           (fingerprint is part of the singleton key)
+ *
+ * Env toggles:
+ *   LLM_DISCOVERY_CACHE=0  → disable persistent discovery cache
+ *                             (in-memory dedup from #136 still applies)
+ */
+import { ClassificationCache } from './classification-cache.js';
+import { type LLMConfig } from '../llm/config.js';
+import type { DiscoveryResult } from '../llm/discovery.js';
+/**
+ * Get the discovery-phase persistent cache, keyed by per-phase model
+ * fingerprint. When `LLM_DISCOVERY_CACHE=0` returns a disabled cache that
+ * no-ops on get/set (callers don't need to branch).
+ */
+export declare function getDiscoveryCache(config?: LLMConfig): ClassificationCache<DiscoveryResult>;
+/** Reset the module-scoped singleton — test-only. */
+export declare function resetDiscoveryCache(): void;
+/**
+ * Compute the `(content, classifier)` tuple for the underlying
+ * ClassificationCache. The fingerprint dimension is folded in by the
+ * cache itself (see classification-cache.ts:computeKey).
+ *
+ * Components:
+ *   - className — disambiguates same-named methods across classes
+ *   - methodName — per-method granularity (matches the per-method LLM call)
+ *   - methodCode SHA-256 — method edit invalidates only that method's entry
+ *   - sortedCweSet — different CWE-set requests on the same method don't
+ *     reuse each other's prompts (different system prompt, different answer)
+ *   - classifier 'discovery-method' — namespace for future
+ *     'discovery-file' / 'discovery-class' tiers without collision
+ */
+export declare function computeDiscoveryCacheKey(input: {
+    className: string;
+    methodName: string;
+    methodCode: string;
+    targetCWEs: ReadonlyArray<string>;
+}): {
+    content: string;
+    classifier: string;
+};
+//# sourceMappingURL=discovery-cache.d.ts.map

package/dist/cache/discovery-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-cache.d.ts","sourceRoot":"","sources":["../../src/cache/discovery-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAa3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,SAAiC,GACxC,mBAAmB,CAAC,eAAe,CAAC,CActC;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAO1C"}

package/dist/cache/discovery-cache.js

@@ -0,0 +1,95 @@
+/**
+ * Discovery Cache
+ *
+ * Persistent on-disk cache for LLM discovery results per (className,
+ * methodName, methodCode, CWE-set) tuple (cognium-ai#134, P2 of epic
+ * #155). Sits in front of the in-memory `_discoveryDedupCache` from
+ * discovery.ts (#136) so that identical method-level discovery requests
+ * survive across processes, CI runs, and developer iterations — not just
+ * within one process.
+ *
+ * Built on top of `ClassificationCache<DiscoveryResult>` (which already
+ * carries the cognium-ai#151 model-fingerprint key dimension), with
+ * discovery-specific key construction:
+ *
+ *   content    = className + '\\0' + methodName + '\\0' +
+ *                SHA-256(methodCode) + '\\0' + sortedCweSet
+ *   classifier = 'discovery-method'
+ *   fingerprint = getPhaseModelFingerprint(config)  // includes discovery model
+ *
+ * Cache directory: `.cognium/cache/discovery/` (separate from the
+ * verify-phase `.cognium/cache/verify/` so each phase can be cleared
+ * independently — `rm -rf .cognium/cache/discovery/` only nukes
+ * discovery entries).
+ *
+ * Invalidation matrix (#134 acceptance criteria):
+ *   - Edit one method     → only that method's entry invalidates
+ *                           (methodCode SHA-256 is part of the key)
+ *   - Add a new CWE       → existing entries still hit for old CWE-sets;
+ *                           new CWE-set requests miss
+ *   - Change disc model   → entire cache invalidates
+ *                           (fingerprint is part of the singleton key)
+ *
+ * Env toggles:
+ *   LLM_DISCOVERY_CACHE=0  → disable persistent discovery cache
+ *                             (in-memory dedup from #136 still applies)
+ */
+import * as crypto from 'crypto';
+import * as path from 'path';
+import { ClassificationCache } from './classification-cache.js';
+import { getDefaultLLMConfig, getPhaseModelFingerprint } from '../llm/config.js';
+const DISCOVERY_CACHE_SUBDIR = path.join('.cognium', 'cache', 'discovery');
+/**
+ * Module-scoped singleton — distinct from the discovery-phase singleton
+ * in `classification-cache.ts` and the verify-phase singleton in
+ * `verify-cache.ts` so each phase can carry its own model fingerprint
+ * (e.g. cheap discovery + strong verifier) without thrashing.
+ */
+let _instance = null;
+let _instanceFingerprint = '';
+/**
+ * Get the discovery-phase persistent cache, keyed by per-phase model
+ * fingerprint. When `LLM_DISCOVERY_CACHE=0` returns a disabled cache that
+ * no-ops on get/set (callers don't need to branch).
+ */
+export function getDiscoveryCache(config = getDefaultLLMConfig()) {
+    const enabled = process.env.LLM_DISCOVERY_CACHE !== '0';
+    const fingerprint = getPhaseModelFingerprint(config);
+    if (!_instance || _instanceFingerprint !== fingerprint || _instance.getModelFingerprint() !== fingerprint) {
+        _instance = new ClassificationCache({
+            cacheDir: path.join(process.cwd(), DISCOVERY_CACHE_SUBDIR),
+            modelFingerprint: fingerprint,
+            enabled,
+        });
+        _instanceFingerprint = fingerprint;
+    }
+    return _instance;
+}
+/** Reset the module-scoped singleton — test-only. */
+export function resetDiscoveryCache() {
+    _instance = null;
+    _instanceFingerprint = '';
+}
+/**
+ * Compute the `(content, classifier)` tuple for the underlying
+ * ClassificationCache. The fingerprint dimension is folded in by the
+ * cache itself (see classification-cache.ts:computeKey).
+ *
+ * Components:
+ *   - className — disambiguates same-named methods across classes
+ *   - methodName — per-method granularity (matches the per-method LLM call)
+ *   - methodCode SHA-256 — method edit invalidates only that method's entry
+ *   - sortedCweSet — different CWE-set requests on the same method don't
+ *     reuse each other's prompts (different system prompt, different answer)
+ *   - classifier 'discovery-method' — namespace for future
+ *     'discovery-file' / 'discovery-class' tiers without collision
+ */
+export function computeDiscoveryCacheKey(input) {
+    const methodSha = crypto.createHash('sha256').update(input.methodCode).digest('hex');
+    const sortedCweSet = [...input.targetCWEs].sort().join(',');
+    return {
+        content: `${input.className}\0${input.methodName}\0${methodSha}\0${sortedCweSet}`,
+        classifier: 'discovery-method',
+    };
+}
+//# sourceMappingURL=discovery-cache.js.map

package/dist/cache/discovery-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-cache.js","sourceRoot":"","sources":["../../src/cache/discovery-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAkB,MAAM,kBAAkB,CAAC;AAGjG,MAAM,sBAAsB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AAE3E;;;;;GAKG;AACH,IAAI,SAAS,GAAgD,IAAI,CAAC;AAClE,IAAI,oBAAoB,GAAG,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAoB,mBAAmB,EAAE;IAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IACxD,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAErD,IAAI,CAAC,SAAS,IAAI,oBAAoB,KAAK,WAAW,IAAI,SAAS,CAAC,mBAAmB,EAAE,KAAK,WAAW,EAAE,CAAC;QAC1G,SAAS,GAAG,IAAI,mBAAmB,CAAkB;YACnD,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC;YAC1D,gBAAgB,EAAE,WAAW;YAC7B,OAAO;SACR,CAAC,CAAC;QACH,oBAAoB,GAAG,WAAW,CAAC;IACrC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,mBAAmB;IACjC,SAAS,GAAG,IAAI,CAAC;IACjB,oBAAoB,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAKxC;IACC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrF,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,OAAO;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,UAAU,KAAK,SAAS,KAAK,YAAY,EAAE;QACjF,UAAU,EAAE,kBAAkB;KAC/B,CAAC;AACJ,CAAC"}

package/dist/cache/index.d.ts

@@ -3,4 +3,8 @@
  */
 export { FileCache, getAnalysisCache, resetAnalysisCache } from './file-cache.js';
 export type { CacheEntry, FileCacheOptions } from './file-cache.js';
+export { ClassificationCache, getClassificationCache, resetClassificationCache } from './classification-cache.js';
+export type { ClassificationCacheOptions } from './classification-cache.js';
+export type { CacheBackend } from './backend.js';
+export { LocalFSBackend, MemoryBackend, R2Backend, makeBackend, getBackendKind } from './backends/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAClH,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAG5E,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cache/index.js

@@ -2,4 +2,6 @@
  * Cache module exports
  */
 export { FileCache, getAnalysisCache, resetAnalysisCache } from './file-cache.js';
+export { ClassificationCache, getClassificationCache, resetClassificationCache } from './classification-cache.js';
+export { LocalFSBackend, MemoryBackend, R2Backend, makeBackend, getBackendKind } from './backends/index.js';
 //# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAKlH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cache/tree-cache.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Tree Cache
+ *
+ * Persistent on-disk cache for `runPatternMatch` output (cognium-ai#153,
+ * P3 of epic #155). Pattern-match output is a pure function of file
+ * content + engine version, so caching it eliminates the parse +
+ * AST-walk + SAST-rule firing on warm runs.
+ *
+ * Empirically (v2.20.6 gson re-verify, 2026-06-29) the scan stage ate
+ * 179s of 358s end-to-end — ~half the wall-clock is re-discovering
+ * structure circle-ir already knows. Caching the pattern-match seam
+ * is the smallest empirical win in the cache stack (no LLM-token
+ * reduction, only CPU + wall-clock), but it stacks cleanly on the
+ * #145 static pre-filter — a cached tree means the pre-filter has
+ * more to chew on, which reduces enrichment calls downstream.
+ *
+ * **Scope:** caches `PatternMatchResult` only, NOT full `CircleIR`.
+ * The full graph (cross-file CFG, project-level type hierarchy) is
+ * too entangled with project context to cache safely without a full
+ * `CircleIR.serialize()` upstream — that's a separate D3 design
+ * question, file separately if pursued.
+ *
+ * **Key composition:**
+ *   content = SHA-256(sourceCode) + '\0' +
+ *             circleIrVersion + '\0' +
+ *             circleIrAiVersion + '\0' +
+ *             language + '\0' +
+ *             ruleSetFingerprint
+ *   classifier = 'tree-pattern-match'
+ *
+ * Any of: file edit, circle-ir bump, circle-ir-ai bump, language
+ * change, or rule-set change → cache miss.
+ *
+ * **Storage:** `ClassificationCache<PatternMatchResult>` under
+ * `.cognium/cache/tree/`, 7-day TTL (longer than discovery cache
+ * because the input is structural and stable — pattern-match output
+ * doesn't drift between scans the way an LLM call would).
+ *
+ * **Env toggles:**
+ *   LLM_TREE_CACHE=0  → disable persistent tree cache.
+ *
+ * **Versioning note:** unlike discovery-cache / verify-cache, this
+ * cache is NOT keyed on the LLM model fingerprint (pattern-match is
+ * static — circle-ir doesn't call any LLM). It IS keyed on the
+ * circle-ir and circle-ir-ai package versions because either bump
+ * can change the workflow-level transforms applied to the result.
+ */
+import { ClassificationCache } from './classification-cache.js';
+import type { TaintSource, TaintSink, TypeInfo, DFG, SastFinding } from 'circle-ir';
+/**
+ * Shape persisted to disk. Mirrors the return of `runPatternMatch` in
+ * `src/agents/mastra/workflow.ts`. All fields are plain JSON-serializable
+ * (no class instances, no cycles) so the underlying ClassificationCache
+ * round-trip is safe.
+ */
+export interface PatternMatchResult {
+    patternSources: TaintSource[];
+    patternSinks: TaintSink[];
+    types: TypeInfo[];
+    imports: string[];
+    sastFindings: SastFinding[];
+    dfg: DFG;
+}
+/**
+ * Get the tree-cache singleton. When `LLM_TREE_CACHE=0` returns a
+ * disabled cache that no-ops on get/set (callers don't need to branch).
+ */
+export declare function getTreeCache(): ClassificationCache<PatternMatchResult>;
+/** Reset the module-scoped singleton — test-only. */
+export declare function resetTreeCache(): void;
+/**
+ * Compute the `(content, classifier)` tuple for the underlying
+ * ClassificationCache.
+ *
+ * Components:
+ *   - source code SHA-256 — file edit invalidates only that file's entry
+ *   - circleIrVersion — bumping circle-ir invalidates all entries
+ *   - circleIrAiVersion — bumping circle-ir-ai (which may change
+ *     workflow-level transforms applied to pattern-match output)
+ *     invalidates all entries
+ *   - language — same source, different language tag must miss (the
+ *     analyzer's behavior depends on the language argument)
+ *   - ruleSetFingerprint — caller-supplied digest of the active rule
+ *     set (disabledPasses + projectProfile). Empty string is fine for
+ *     the default rule set.
+ */
+export declare function computeTreeCacheKey(input: {
+    sourceCode: string;
+    language: string;
+    ruleSetFingerprint?: string;
+}): {
+    content: string;
+    classifier: string;
+};
+/**
+ * Compute a stable fingerprint over an arbitrary rule-set descriptor
+ * (disabledPasses array + projectProfile object). Result is suitable to
+ * pass as `ruleSetFingerprint` to `computeTreeCacheKey`. Order-stable
+ * for arrays so re-ordering `--disable a,b` vs `--disable b,a` still
+ * hits the cache.
+ */
+export declare function computeRuleSetFingerprint(input: {
+    disabledPasses?: string[];
+    projectProfile?: unknown;
+}): string;
+/** Test-only: expose the captured engine versions for assertions. */
+export declare function getTreeCacheVersions(): {
+    circleIrVersion: string;
+    circleIrAiVersion: string;
+};
+//# sourceMappingURL=tree-cache.d.ts.map

package/dist/cache/tree-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-cache.d.ts","sourceRoot":"","sources":["../../src/cache/tree-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAMH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAKpF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,GAAG,EAAE,GAAG,CAAC;CACV;AAiDD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,mBAAmB,CAAC,kBAAkB,CAAC,CAUtE;AAED,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAO1C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,MAAM,CAWT;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,IAAI;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAKA"}