arc-1 0.3.0 → 0.4.1

package/dist/cache/caching-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caching-layer.d.ts","sourceRoot":"","sources":["../../src/cache/caching-layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGtE,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,OAAO,CAAC,UAAU,CAAS;gBAEf,KAAK,EAAE,KAAK;IAIxB,4DAA4D;IAC5D,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIlC,4CAA4C;IAC5C,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAID;;;OAGG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IAa5C;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAM5E;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IASxD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI;IAgBjH;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBnF;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAOxD;;;;OAIG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI;IAQ5E,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK;CAG3E"}

package/dist/cache/caching-layer.js

@@ -0,0 +1,134 @@
+/**
+ * Caching layer — orchestrates source + dependency caching.
+ *
+ * Sits between the intent handler / compressor and the ADT client.
+ * Provides cache-aware source fetching with hash-based dependency
+ * graph invalidation.
+ *
+ * Design:
+ * - Source code is cached by (type, name) with a SHA-256 hash.
+ * - Dependency graphs (contracts[]) are cached by source hash.
+ *   When the source changes, the hash changes, and deps are re-resolved.
+ *   When the source hasn't changed, ALL downstream dep fetches are skipped.
+ * - Function group mappings are cached permanently (rarely change).
+ * - Writes invalidate the source cache for the written object.
+ *
+ * Three tiers:
+ * - Tier 1 (stdio): MemoryCache, dies with process. Eliminates duplicate
+ *   fetches within a session.
+ * - Tier 2 (http-streamable): SqliteCache, persists. Multiple sessions
+ *   share the warm cache.
+ * - Tier 3 (Docker + warmup): SqliteCache pre-populated via TADIR scan.
+ *   Enables reverse dependency lookup.
+ */
+import { logger } from '../server/logger.js';
+import { hashSource } from './cache.js';
+export class CachingLayer {
+    cache;
+    warmupDone = false;
+    constructor(cache) {
+        this.cache = cache;
+    }
+    /** Mark warmup as complete (enables reverse dep lookups) */
+    setWarmupDone(done) {
+        this.warmupDone = done;
+    }
+    /** Whether the warmup index is available */
+    get isWarmupAvailable() {
+        return this.warmupDone;
+    }
+    // ─── Source Fetching with Cache ────────────────────────────────────
+    /**
+     * Get source code, using cache if available.
+     * Returns the source and whether it was a cache hit.
+     */
+    async getSource(objectType, objectName, fetcher) {
+        const cached = this.cache.getSource(objectType, objectName);
+        if (cached) {
+            logger.debug(`[cache] source HIT ${objectType}:${objectName}`);
+            return { source: cached.source, hit: true };
+        }
+        const source = await fetcher();
+        this.cache.putSource(objectType, objectName, source);
+        logger.debug(`[cache] source MISS ${objectType}:${objectName} (${source.length} chars stored)`);
+        return { source, hit: false };
+    }
+    /**
+     * Get cached source without fetching (for cache-only lookups).
+     */
+    getCachedSource(objectType, objectName) {
+        return this.cache.getSource(objectType, objectName);
+    }
+    // ─── Dependency Graph Cache ───────────────────────────────────────
+    /**
+     * Check if we have a cached dep graph for the given source.
+     * The graph is keyed by the source hash — if source changed, this returns null.
+     */
+    getCachedDepGraph(source) {
+        const hash = hashSource(source);
+        const cached = this.cache.getDepGraph(hash);
+        if (cached) {
+            logger.debug(`[cache] depgraph HIT ${cached.objectType}:${cached.objectName} (hash ${hash.slice(0, 8)})`);
+        }
+        return cached;
+    }
+    /**
+     * Store a resolved dep graph keyed by source hash.
+     */
+    putDepGraph(source, objectName, objectType, contracts) {
+        const hash = hashSource(source);
+        logger.debug(`[cache] depgraph STORE ${objectType}:${objectName} (${contracts.length} contracts, hash ${hash.slice(0, 8)})`);
+        this.cache.putDepGraph({
+            sourceHash: hash,
+            objectName,
+            objectType,
+            contracts,
+            cachedAt: new Date().toISOString(),
+        });
+    }
+    // ─── Function Group Resolution ────────────────────────────────────
+    /**
+     * Resolve a function module's group, with cache.
+     */
+    async resolveFuncGroup(client, funcName) {
+        const cached = this.cache.getFuncGroup(funcName);
+        if (cached)
+            return cached;
+        const results = await client.searchObject(funcName, 5);
+        for (const r of results) {
+            const match = r.uri.match(/groups\/([^/]+)/);
+            if (match) {
+                const group = match[1];
+                this.cache.putFuncGroup(funcName, group);
+                return group;
+            }
+        }
+        return null;
+    }
+    // ─── Write Invalidation ───────────────────────────────────────────
+    /**
+     * Invalidate cache entries for a written object.
+     * Called after SAPWrite to ensure stale source is not served.
+     */
+    invalidate(objectType, objectName) {
+        logger.debug(`[cache] invalidate ${objectType}:${objectName}`);
+        this.cache.invalidateSource(objectType, objectName);
+    }
+    // ─── Reverse Dependencies (Pre-warmer only) ───────────────────────
+    /**
+     * Find all objects that depend on the given object (reverse lookup).
+     * Only available when pre-warmer has populated the edge index.
+     * Returns null if warmup hasn't run (caller should show appropriate message).
+     */
+    getUsages(objectName) {
+        if (!this.warmupDone)
+            return null;
+        const edges = this.cache.getEdgesTo(objectName.toUpperCase());
+        return edges.map((e) => ({ fromId: e.fromId, edgeType: e.edgeType }));
+    }
+    // ─── Stats ────────────────────────────────────────────────────────
+    stats() {
+        return this.cache.stats();
+    }
+}
+//# sourceMappingURL=caching-layer.js.map

package/dist/cache/caching-layer.js.map

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

package/dist/cache/memory.d.ts

@@ -1,23 +1,35 @@
 /**
  * In-memory cache implementation.
  *
- * Default cache backend — fast, ephemeral.
+ * Default cache backend for stdio transport — fast, ephemeral.
  * Data is lost when the process exits.
  * Thread-safe by default in Node.js (single-threaded event loop).
  */
-import type { Cache, CacheApi, CacheEdge, CacheNode, CacheStats } from './cache.js';
+import type { Cache, CacheApi, CachedDepGraph, CachedSource, CacheEdge, CacheNode, CacheStats } from './cache.js';
 export declare class MemoryCache implements Cache {
     private nodes;
     private edges;
+    private reverseEdges;
     private apis;
+    private sources;
+    private depGraphs;
+    private funcGroups;
     putNode(node: CacheNode): void;
     getNode(id: string): CacheNode | null;
     getNodesByPackage(packageName: string): CacheNode[];
     invalidateNode(id: string): void;
     putEdge(edge: CacheEdge): void;
     getEdgesFrom(fromId: string): CacheEdge[];
+    getEdgesTo(toId: string): CacheEdge[];
     putApi(api: CacheApi): void;
     getApi(name: string, type: string): CacheApi | null;
+    putSource(objectType: string, objectName: string, source: string): void;
+    getSource(objectType: string, objectName: string): CachedSource | null;
+    invalidateSource(objectType: string, objectName: string): void;
+    putDepGraph(graph: CachedDepGraph): void;
+    getDepGraph(sourceHash: string): CachedDepGraph | null;
+    putFuncGroup(funcName: string, groupName: string): void;
+    getFuncGroup(funcName: string): string | null;
     clear(): void;
     stats(): CacheStats;
     close(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../ts-src/cache/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpF,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,IAAI,CAA+B;IAE3C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE;IAWnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOhC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAO9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAIzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAI3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAInD,KAAK,IAAI,IAAI;IAMb,KAAK,IAAI,UAAU;IAYnB,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGlH,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,UAAU,CAA6B;IAI/C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE;IAWnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAShC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAwB9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAIzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAMrC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAI3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAMnD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAWvE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAItE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAM9D,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAIxC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAMtD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIvD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,UAAU;IAcnB,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/memory.js

@@ -1,14 +1,20 @@
 /**
  * In-memory cache implementation.
  *
- * Default cache backend — fast, ephemeral.
+ * Default cache backend for stdio transport — fast, ephemeral.
  * Data is lost when the process exits.
  * Thread-safe by default in Node.js (single-threaded event loop).
  */
+import { hashSource, sourceKey } from './cache.js';
 export class MemoryCache {
     nodes = new Map();
     edges = new Map();
+    reverseEdges = new Map();
     apis = new Map();
+    sources = new Map();
+    depGraphs = new Map();
+    funcGroups = new Map();
+    // ─── Node Operations ──────────────────────────────────────────────
     putNode(node) {
         this.nodes.set(node.id, { ...node });
     }
@@ -31,25 +37,84 @@ export class MemoryCache {
             node.valid = false;
         }
     }
+    // ─── Edge Operations ──────────────────────────────────────────────
     putEdge(edge) {
-        const key = edge.fromId;
-        const existing = this.edges.get(key) ?? [];
-        existing.push({ ...edge });
-        this.edges.set(key, existing);
+        const edgeCopy = { ...edge };
+        // Forward index
+        const fwd = this.edges.get(edge.fromId) ?? [];
+        // Replace existing edge with same (from, to, type) or add new
+        const fwdIdx = fwd.findIndex((e) => e.toId === edge.toId && e.edgeType === edge.edgeType);
+        if (fwdIdx >= 0) {
+            fwd[fwdIdx] = edgeCopy;
+        }
+        else {
+            fwd.push(edgeCopy);
+        }
+        this.edges.set(edge.fromId, fwd);
+        // Reverse index
+        const rev = this.reverseEdges.get(edge.toId) ?? [];
+        const revIdx = rev.findIndex((e) => e.fromId === edge.fromId && e.edgeType === edge.edgeType);
+        if (revIdx >= 0) {
+            rev[revIdx] = edgeCopy;
+        }
+        else {
+            rev.push(edgeCopy);
+        }
+        this.reverseEdges.set(edge.toId, rev);
     }
     getEdgesFrom(fromId) {
         return this.edges.get(fromId) ?? [];
     }
+    getEdgesTo(toId) {
+        return this.reverseEdges.get(toId) ?? [];
+    }
+    // ─── API Operations ───────────────────────────────────────────────
     putApi(api) {
         this.apis.set(`${api.type}:${api.name}`, { ...api });
     }
     getApi(name, type) {
         return this.apis.get(`${type}:${name}`) ?? null;
     }
+    // ─── Source Code Cache ────────────────────────────────────────────
+    putSource(objectType, objectName, source) {
+        const key = sourceKey(objectType, objectName);
+        this.sources.set(key, {
+            objectType: objectType.toUpperCase(),
+            objectName: objectName.toUpperCase(),
+            source,
+            hash: hashSource(source),
+            cachedAt: new Date().toISOString(),
+        });
+    }
+    getSource(objectType, objectName) {
+        return this.sources.get(sourceKey(objectType, objectName)) ?? null;
+    }
+    invalidateSource(objectType, objectName) {
+        this.sources.delete(sourceKey(objectType, objectName));
+    }
+    // ─── Dependency Graph Cache ───────────────────────────────────────
+    putDepGraph(graph) {
+        this.depGraphs.set(graph.sourceHash, { ...graph });
+    }
+    getDepGraph(sourceHash) {
+        return this.depGraphs.get(sourceHash) ?? null;
+    }
+    // ─── Function Group Resolution ────────────────────────────────────
+    putFuncGroup(funcName, groupName) {
+        this.funcGroups.set(funcName.toUpperCase(), groupName.toUpperCase());
+    }
+    getFuncGroup(funcName) {
+        return this.funcGroups.get(funcName.toUpperCase()) ?? null;
+    }
+    // ─── Management ───────────────────────────────────────────────────
     clear() {
         this.nodes.clear();
         this.edges.clear();
+        this.reverseEdges.clear();
         this.apis.clear();
+        this.sources.clear();
+        this.depGraphs.clear();
+        this.funcGroups.clear();
     }
     stats() {
         let edgeCount = 0;
@@ -60,6 +125,8 @@ export class MemoryCache {
             nodeCount: this.nodes.size,
             edgeCount,
             apiCount: this.apis.size,
+            sourceCount: this.sources.size,
+            contractCount: this.depGraphs.size,
         };
     }
     close() {

package/dist/cache/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../ts-src/cache/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,WAAW;IACd,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IACrC,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IACvC,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE3C,OAAO,CAAC,IAAe;QACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,iBAAiB,CAAC,WAAmB;QACnC,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAe;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,GAAa;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC;IAClD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,KAAK;QACH,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC1B,SAAS;YACT,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;SACzB,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACF"}
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"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"}

package/dist/cache/sqlite.d.ts

@@ -2,11 +2,12 @@
  * SQLite cache implementation using better-sqlite3.
  *
  * Persistent cache — survives process restarts.
+ * Default backend for http-streamable transport and Docker deployments.
  * Uses WAL mode for concurrent read performance.
  * better-sqlite3 is synchronous, which is actually faster than async
  * alternatives for single-process use (no Promise overhead).
  */
-import type { Cache, CacheApi, CacheEdge, CacheNode, CacheStats } from './cache.js';
+import type { Cache, CacheApi, CachedDepGraph, CachedSource, CacheEdge, CacheNode, CacheStats } from './cache.js';
 export declare class SqliteCache implements Cache {
     private db;
     constructor(dbPath: string);
@@ -17,8 +18,16 @@ export declare class SqliteCache implements Cache {
     invalidateNode(id: string): void;
     putEdge(edge: CacheEdge): void;
     getEdgesFrom(fromId: string): CacheEdge[];
+    getEdgesTo(toId: string): CacheEdge[];
     putApi(api: CacheApi): void;
     getApi(name: string, type: string): CacheApi | null;
+    putSource(objectType: string, objectName: string, source: string): void;
+    getSource(objectType: string, objectName: string): CachedSource | null;
+    invalidateSource(objectType: string, objectName: string): void;
+    putDepGraph(graph: CachedDepGraph): void;
+    getDepGraph(sourceHash: string): CachedDepGraph | null;
+    putFuncGroup(funcName: string, groupName: string): void;
+    getFuncGroup(funcName: string): string | null;
     clear(): void;
     stats(): CacheStats;
     close(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../ts-src/cache/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpF,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAgB9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAMrC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE;IAOnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAO9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAKzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAO3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAcnD,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,UAAU;IAOnB,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/cache/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGlH,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,YAAY;IA+DpB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAgB9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAMrC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE;IAOnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMhC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAO9B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAKzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAOrC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAO3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAgBnD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAevE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAetE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9D,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAOxC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAgBtD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMvD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU7C,KAAK,IAAI,IAAI;IAMb,KAAK,IAAI,UAAU;IASnB,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/sqlite.js

@@ -2,11 +2,13 @@
  * SQLite cache implementation using better-sqlite3.
  *
  * Persistent cache — survives process restarts.
+ * Default backend for http-streamable transport and Docker deployments.
  * Uses WAL mode for concurrent read performance.
  * better-sqlite3 is synchronous, which is actually faster than async
  * alternatives for single-process use (no Promise overhead).
  */
 import Database from 'better-sqlite3';
+import { hashSource, sourceKey } from './cache.js';
 export class SqliteCache {
     db;
     constructor(dbPath) {
@@ -47,10 +49,35 @@ export class SqliteCache {
         PRIMARY KEY (type, name)
       );
 
+      CREATE TABLE IF NOT EXISTS sources (
+        cache_key TEXT PRIMARY KEY,
+        object_type TEXT NOT NULL,
+        object_name TEXT NOT NULL,
+        source TEXT NOT NULL,
+        hash TEXT NOT NULL,
+        cached_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS dep_graphs (
+        source_hash TEXT PRIMARY KEY,
+        object_name TEXT NOT NULL,
+        object_type TEXT NOT NULL,
+        contracts TEXT NOT NULL,
+        cached_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS func_groups (
+        func_name TEXT PRIMARY KEY,
+        group_name TEXT NOT NULL
+      );
+
       CREATE INDEX IF NOT EXISTS idx_nodes_package ON nodes(package_name);
       CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id);
+      CREATE INDEX IF NOT EXISTS idx_edges_to ON edges(to_id);
+      CREATE INDEX IF NOT EXISTS idx_sources_hash ON sources(hash);
     `);
     }
+    // ─── Node Operations ──────────────────────────────────────────────
     putNode(node) {
         const stmt = this.db.prepare('INSERT OR REPLACE INTO nodes (id, object_type, object_name, package_name, source_hash, cached_at, valid, metadata) VALUES (?, ?, ?, ?, ?, ?, ?, ?)');
         stmt.run(node.id, node.objectType, node.objectName, node.packageName, node.sourceHash ?? null, node.cachedAt, node.valid ? 1 : 0, node.metadata ? JSON.stringify(node.metadata) : null);
@@ -68,6 +95,7 @@ export class SqliteCache {
     invalidateNode(id) {
         this.db.prepare('UPDATE nodes SET valid = 0 WHERE id = ?').run(id);
     }
+    // ─── Edge Operations ──────────────────────────────────────────────
     putEdge(edge) {
         const stmt = this.db.prepare('INSERT OR REPLACE INTO edges (from_id, to_id, edge_type, source, discovered_at, valid) VALUES (?, ?, ?, ?, ?, ?)');
         stmt.run(edge.fromId, edge.toId, edge.edgeType, edge.source ?? null, edge.discoveredAt, edge.valid ? 1 : 0);
@@ -76,6 +104,11 @@ export class SqliteCache {
         const rows = this.db.prepare('SELECT * FROM edges WHERE from_id = ?').all(fromId);
         return rows.map(rowToEdge);
     }
+    getEdgesTo(toId) {
+        const rows = this.db.prepare('SELECT * FROM edges WHERE to_id = ?').all(toId);
+        return rows.map(rowToEdge);
+    }
+    // ─── API Operations ───────────────────────────────────────────────
     putApi(api) {
         const stmt = this.db.prepare('INSERT OR REPLACE INTO apis (name, type, release_state, clean_core_level, application_component) VALUES (?, ?, ?, ?, ?)');
         stmt.run(api.name, api.type, api.releaseState, api.cleanCoreLevel ?? null, api.applicationComponent ?? null);
@@ -92,14 +125,69 @@ export class SqliteCache {
             applicationComponent: row.application_component,
         };
     }
+    // ─── Source Code Cache ────────────────────────────────────────────
+    putSource(objectType, objectName, source) {
+        const key = sourceKey(objectType, objectName);
+        const stmt = this.db.prepare('INSERT OR REPLACE INTO sources (cache_key, object_type, object_name, source, hash, cached_at) VALUES (?, ?, ?, ?, ?, ?)');
+        stmt.run(key, objectType.toUpperCase(), objectName.toUpperCase(), source, hashSource(source), new Date().toISOString());
+    }
+    getSource(objectType, objectName) {
+        const key = sourceKey(objectType, objectName);
+        const row = this.db.prepare('SELECT * FROM sources WHERE cache_key = ?').get(key);
+        if (!row)
+            return null;
+        return {
+            objectType: String(row.object_type),
+            objectName: String(row.object_name),
+            source: String(row.source),
+            hash: String(row.hash),
+            cachedAt: String(row.cached_at),
+        };
+    }
+    invalidateSource(objectType, objectName) {
+        const key = sourceKey(objectType, objectName);
+        this.db.prepare('DELETE FROM sources WHERE cache_key = ?').run(key);
+    }
+    // ─── Dependency Graph Cache ───────────────────────────────────────
+    putDepGraph(graph) {
+        const stmt = this.db.prepare('INSERT OR REPLACE INTO dep_graphs (source_hash, object_name, object_type, contracts, cached_at) VALUES (?, ?, ?, ?, ?)');
+        stmt.run(graph.sourceHash, graph.objectName, graph.objectType, JSON.stringify(graph.contracts), graph.cachedAt);
+    }
+    getDepGraph(sourceHash) {
+        const row = this.db.prepare('SELECT * FROM dep_graphs WHERE source_hash = ?').get(sourceHash);
+        if (!row)
+            return null;
+        return {
+            sourceHash: String(row.source_hash),
+            objectName: String(row.object_name),
+            objectType: String(row.object_type),
+            contracts: JSON.parse(String(row.contracts)),
+            cachedAt: String(row.cached_at),
+        };
+    }
+    // ─── Function Group Resolution ────────────────────────────────────
+    putFuncGroup(funcName, groupName) {
+        this.db
+            .prepare('INSERT OR REPLACE INTO func_groups (func_name, group_name) VALUES (?, ?)')
+            .run(funcName.toUpperCase(), groupName.toUpperCase());
+    }
+    getFuncGroup(funcName) {
+        const row = this.db.prepare('SELECT group_name FROM func_groups WHERE func_name = ?').get(funcName.toUpperCase());
+        if (!row)
+            return null;
+        return String(row.group_name);
+    }
+    // ─── Management ───────────────────────────────────────────────────
     clear() {
-        this.db.exec('DELETE FROM nodes; DELETE FROM edges; DELETE FROM apis;');
+        this.db.exec('DELETE FROM nodes; DELETE FROM edges; DELETE FROM apis; DELETE FROM sources; DELETE FROM dep_graphs; DELETE FROM func_groups;');
     }
     stats() {
         const nodeCount = this.db.prepare('SELECT COUNT(*) as cnt FROM nodes').get().cnt;
         const edgeCount = this.db.prepare('SELECT COUNT(*) as cnt FROM edges').get().cnt;
         const apiCount = this.db.prepare('SELECT COUNT(*) as cnt FROM apis').get().cnt;
-        return { nodeCount, edgeCount, apiCount };
+        const sourceCount = this.db.prepare('SELECT COUNT(*) as cnt FROM sources').get().cnt;
+        const contractCount = this.db.prepare('SELECT COUNT(*) as cnt FROM dep_graphs').get().cnt;
+        return { nodeCount, edgeCount, apiCount, sourceCount, contractCount };
     }
     close() {
         this.db.close();

package/dist/cache/sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../ts-src/cache/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,MAAM,OAAO,WAAW;IACd,EAAE,CAAoB;IAE9B,YAAY,MAAc;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCZ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAe;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,oJAAoJ,CACrJ,CAAC;QACF,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,IAAI,IAAI,EACvB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAClB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAwC,CAAC;QAC/G,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,WAAmB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,0DAA0D,CAAC,CAAC,GAAG,CAAC,WAAW,CAEvG,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,IAAe;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,kHAAkH,CACnH,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9G,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAmC,CAAC;QACpH,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAa;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,yHAAyH,CAC1H,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAE/E,CAAC;QACd,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YACtB,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;YACvC,cAAc,EAAE,GAAG,CAAC,gBAAsC;YAC1D,oBAAoB,EAAE,GAAG,CAAC,qBAA2C;SACtE,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK;QACH,MAAM,SAAS,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAAsB,CAAC,GAAG,CAAC;QACtG,MAAM,SAAS,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAAsB,CAAC,GAAG,CAAC;QACtG,MAAM,QAAQ,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,GAAG,EAAsB,CAAC,GAAG,CAAC;QACpG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAA4B;IAC7C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;QACrC,UAAU,EAAE,GAAG,CAAC,WAAiC;QACjD,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QAC/B,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;QACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAA4B;IAC7C,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAA0B;QACxD,MAAM,EAAE,GAAG,CAAC,MAA4B;QACxC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QACvC,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;KACvB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/cache/sqlite.ts"],"names":[],"mappings":"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"}

package/dist/cache/warmup.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Cache warmup — pre-indexes all custom objects from the SAP system.
+ *
+ * Pipeline:
+ * 1. Query TADIR for all custom objects (CLAS, INTF, FUNC) matching package filter
+ * 2. Fetch source code for each object (bounded parallel)
+ * 3. Extract dependencies from each source (local AST, no ADT calls)
+ * 4. Store source + deps + edges in cache
+ * 5. Build reverse dependency index (edges indexed by toId)
+ *
+ * Delta strategy:
+ * - On-premise: query REPOSRC for objects changed since last warmup (UDAT field)
+ * - BTP: full re-scan (no reliable change timestamp available)
+ * - Fallback: compare source hash — if unchanged, skip dep extraction
+ *
+ * Timing estimates (5 concurrent requests):
+ * - 500 objects: ~2-3 minutes
+ * - 2,000 objects: ~8-12 minutes
+ * - 5,000 objects: ~20-30 minutes
+ */
+import type { AdtClient } from '../adt/client.js';
+import type { CachingLayer } from './caching-layer.js';
+/** Result of a warmup run */
+export interface WarmupResult {
+    totalObjects: number;
+    fetched: number;
+    skipped: number;
+    failed: number;
+    edgesCreated: number;
+    durationMs: number;
+}
+/**
+ * Run cache warmup: enumerate + fetch + index all custom objects.
+ *
+ * @param client - ADT client for SAP access
+ * @param cachingLayer - Caching layer to populate
+ * @param packageFilter - Package name filter (supports wildcards, e.g. "Z*,Y*")
+ * @param systemType - System type for choosing delta strategy
+ */
+export declare function runWarmup(client: AdtClient, cachingLayer: CachingLayer, packageFilter?: string, _systemType?: string): Promise<WarmupResult>;
+//# sourceMappingURL=warmup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warmup.d.ts","sourceRoot":"","sources":["../../src/cache/warmup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AASD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,YAAY,EAC1B,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CA4DvB"}