vemora 0.1.0-alpha.8

package/dist/storage/cache.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingCacheStorage = void 0;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/** Maximum allowed size for embeddings.bin (512 MB) */
+const MAX_CACHE_BYTES = 512 * 1024 * 1024;
+/**
+ * Manages the local per-developer embedding cache.
+ *
+ * Stored in ~/.vemora-cache/<projectId>/ — never in the repo.
+ * Each developer builds their own cache after running `vemora index`.
+ *
+ * Design choice: dual-file storage per project.
+ * Metadata and chunk IDs are stored in JSON (inspectable).
+ * Vectors are stored as a contiguous Float32Array binary buffer (fast I/O).
+ * The HNSW index is serialized to a separate JSON file for O(log N) search.
+ */
+class EmbeddingCacheStorage {
+    cacheDir;
+    cachePath; // embeddings.json (metadata + chunkIds)
+    binPath; // embeddings.bin (raw floats)
+    hnswPath; // embeddings.hnsw.json (serialized HNSW)
+    constructor(projectId) {
+        this.cacheDir = path_1.default.join(os_1.default.homedir(), ".vemora-cache", projectId);
+        this.cachePath = path_1.default.join(this.cacheDir, "embeddings.json");
+        this.binPath = path_1.default.join(this.cacheDir, "embeddings.bin");
+        this.hnswPath = path_1.default.join(this.cacheDir, "embeddings.hnsw.json");
+    }
+    load() {
+        if (!fs_1.default.existsSync(this.cachePath))
+            return null;
+        try {
+            const metadata = JSON.parse(fs_1.default.readFileSync(this.cachePath, "utf-8"));
+            // Check if it's the legacy format (embeddings object instead of chunkIds list)
+            if (metadata.embeddings && !metadata.chunkIds) {
+                console.log("Migrating legacy JSON cache to binary format...");
+                this.save(metadata);
+                return this.load(); // reload so vectors are read from the binary file
+            }
+            // New format: load metadata + binary vectors
+            if (!fs_1.default.existsSync(this.binPath))
+                return metadata;
+            const { size } = fs_1.default.statSync(this.binPath);
+            if (size > MAX_CACHE_BYTES) {
+                throw new Error(`Cache file too large (${size} bytes): ${this.binPath}`);
+            }
+            const binBuffer = fs_1.default.readFileSync(this.binPath);
+            // Slice to a fresh ArrayBuffer to guarantee 4-byte alignment regardless
+            // of Node.js buffer pool offsets (avoids RangeError on misaligned views).
+            const ab = binBuffer.buffer.slice(binBuffer.byteOffset, binBuffer.byteOffset + binBuffer.byteLength);
+            const vectors = new Float32Array(ab);
+            // Load HNSW index if it exists
+            let hnswIndex = undefined;
+            if (fs_1.default.existsSync(this.hnswPath)) {
+                try {
+                    hnswIndex = JSON.parse(fs_1.default.readFileSync(this.hnswPath, "utf-8"));
+                }
+                catch (_e) {
+                    console.warn("Failed to load HNSW index, it will be rebuilt on next index run.");
+                }
+            }
+            return {
+                ...metadata,
+                vectors,
+                hnswIndex,
+            };
+        }
+        catch (err) {
+            console.error(`Failed to load cache from ${this.cachePath}:`, err);
+            return null;
+        }
+    }
+    save(cache) {
+        fs_1.default.mkdirSync(this.cacheDir, { recursive: true });
+        // If we have standard embeddings record, convert to binary
+        if (cache.embeddings && Object.keys(cache.embeddings).length > 0) {
+            const chunkIds = Object.keys(cache.embeddings);
+            const dims = cache.dimensions;
+            const vectors = new Float32Array(chunkIds.length * dims);
+            chunkIds.forEach((id, i) => {
+                const embedding = cache.embeddings[id];
+                vectors.set(embedding, i * dims);
+            });
+            cache.chunkIds = chunkIds;
+            cache.vectors = vectors;
+        }
+        // Save metadata (exclude actual vectors/embeddings)
+        const { vectors, embeddings, ...metadata } = cache;
+        this.writeAtomic(this.cachePath, Buffer.from(JSON.stringify(metadata), "utf-8"));
+        // Save binary vectors
+        if (vectors) {
+            this.writeAtomic(this.binPath, Buffer.from(vectors.buffer, vectors.byteOffset, vectors.byteLength));
+        }
+        // Save HNSW index
+        if (cache.hnswIndex) {
+            this.writeAtomic(this.hnswPath, Buffer.from(JSON.stringify(cache.hnswIndex), "utf-8"));
+        }
+    }
+    writeAtomic(filePath, data) {
+        const tmp = filePath + ".tmp";
+        fs_1.default.writeFileSync(tmp, data);
+        fs_1.default.renameSync(tmp, filePath);
+    }
+    update(newEmbeddings, cache) {
+        // Merge into legacy format first for simplicity, then save (which converts to bin)
+        const currentEmbeddings = this.getEmbeddingsMap(cache);
+        const updated = {
+            ...cache,
+            embeddings: { ...currentEmbeddings, ...newEmbeddings },
+            lastUpdated: new Date().toISOString(),
+        };
+        this.save(updated);
+        return updated;
+    }
+    prune(validChunkIds, cache) {
+        const currentMap = this.getEmbeddingsMap(cache);
+        const prunedMap = {};
+        for (const id of validChunkIds) {
+            if (currentMap[id]) {
+                prunedMap[id] = currentMap[id];
+            }
+        }
+        const updated = {
+            ...cache,
+            embeddings: prunedMap,
+            lastUpdated: new Date().toISOString(),
+        };
+        // Clear optimized fields to force re-generation from the pruned map
+        delete updated.vectors;
+        delete updated.chunkIds;
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Helper to always get a Map, regardless of storage format
+     */
+    getEmbeddingsMap(cache) {
+        if (cache.embeddings)
+            return cache.embeddings;
+        if (cache.vectors && cache.chunkIds) {
+            const map = {};
+            const dims = cache.dimensions;
+            cache.chunkIds.forEach((id, i) => {
+                map[id] = Array.from(cache.vectors.subarray(i * dims, (i + 1) * dims));
+            });
+            return map;
+        }
+        return {};
+    }
+    getCacheDir() {
+        return this.cacheDir;
+    }
+}
+exports.EmbeddingCacheStorage = EmbeddingCacheStorage;
+//# sourceMappingURL=cache.js.map

package/dist/storage/cache.js.map

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

package/dist/storage/knowledge.d.ts

@@ -0,0 +1,17 @@
+import type { KnowledgeEntry } from "../core/types";
+/**
+ * Reads and writes the knowledge store at .vemora/knowledge/entries.json.
+ * Committed to git so the whole team shares the same knowledge base.
+ */
+export declare class KnowledgeStorage {
+    private knowledgeDir;
+    private entriesPath;
+    constructor(rootDir: string);
+    load(): KnowledgeEntry[];
+    save(entries: KnowledgeEntry[]): void;
+    add(entry: KnowledgeEntry): void;
+    remove(id: string): boolean;
+    hasKnowledge(): boolean;
+    getKnowledgeDir(): string;
+}
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/storage/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/storage/knowledge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,MAAM;IAK3B,IAAI,IAAI,cAAc,EAAE;IAWxB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAOrC,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAMhC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ3B,YAAY,IAAI,OAAO;IAIvB,eAAe,IAAI,MAAM;CAG1B"}

package/dist/storage/knowledge.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeStorage = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+/**
+ * Reads and writes the knowledge store at .vemora/knowledge/entries.json.
+ * Committed to git so the whole team shares the same knowledge base.
+ */
+class KnowledgeStorage {
+    knowledgeDir;
+    entriesPath;
+    constructor(rootDir) {
+        this.knowledgeDir = path_1.default.join(rootDir, config_1.AI_MEMORY_DIR, config_1.KNOWLEDGE_DIR);
+        this.entriesPath = path_1.default.join(this.knowledgeDir, config_1.KNOWLEDGE_JSON);
+    }
+    load() {
+        if (!fs_1.default.existsSync(this.entriesPath))
+            return [];
+        try {
+            return JSON.parse(fs_1.default.readFileSync(this.entriesPath, "utf-8"));
+        }
+        catch {
+            return [];
+        }
+    }
+    save(entries) {
+        fs_1.default.mkdirSync(this.knowledgeDir, { recursive: true });
+        const tmp = this.entriesPath + ".tmp";
+        fs_1.default.writeFileSync(tmp, JSON.stringify(entries), "utf-8");
+        fs_1.default.renameSync(tmp, this.entriesPath);
+    }
+    add(entry) {
+        const entries = this.load();
+        entries.push(entry);
+        this.save(entries);
+    }
+    remove(id) {
+        const entries = this.load();
+        const next = entries.filter((e) => e.id !== id);
+        if (next.length === entries.length)
+            return false;
+        this.save(next);
+        return true;
+    }
+    hasKnowledge() {
+        return fs_1.default.existsSync(this.entriesPath);
+    }
+    getKnowledgeDir() {
+        return this.knowledgeDir;
+    }
+}
+exports.KnowledgeStorage = KnowledgeStorage;
+//# sourceMappingURL=knowledge.js.map

package/dist/storage/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/storage/knowledge.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,2CAA8E;AAG9E;;;GAGG;AACH,MAAa,gBAAgB;IACnB,YAAY,CAAS;IACrB,WAAW,CAAS;IAE5B,YAAY,OAAe;QACzB,IAAI,CAAC,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,sBAAa,EAAE,sBAAa,CAAC,CAAC;QACrE,IAAI,CAAC,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,uBAAc,CAAC,CAAC;IAClE,CAAC;IAED,IAAI;QACF,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,OAAO,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CACf,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAyB;QAC5B,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QACtC,YAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACxD,YAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,KAAqB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,EAAU;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;QACV,OAAO,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF;AAhDD,4CAgDC"}

package/dist/storage/repository.d.ts

@@ -0,0 +1,27 @@
+import type { CallGraph, Chunk, DependencyGraph, FileIndex, Metadata, SymbolIndex, TodoAnnotation } from "../core/types";
+/**
+ * Reads and writes the versioned repository memory files stored in .vemora/.
+ * All files here are committed to git so collaborators share the same index.
+ */
+export declare class RepositoryStorage {
+    private memoryDir;
+    private indexDir;
+    constructor(rootDir: string);
+    loadFiles(): FileIndex;
+    saveFiles(index: FileIndex): void;
+    loadChunks(): Chunk[];
+    saveChunks(chunks: Chunk[]): void;
+    loadSymbols(): SymbolIndex;
+    saveSymbols(symbols: SymbolIndex): void;
+    loadDeps(): DependencyGraph;
+    saveDeps(graph: DependencyGraph): void;
+    loadCallGraph(): CallGraph;
+    saveCallGraph(graph: CallGraph): void;
+    loadTodos(): TodoAnnotation[];
+    saveTodos(todos: TodoAnnotation[]): void;
+    loadMetadata(): Metadata | null;
+    saveMetadata(meta: Metadata): void;
+    private readJson;
+    private writeJson;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/storage/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/storage/repository.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,eAAe,EACf,SAAS,EACT,QAAQ,EACR,WAAW,EACX,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,MAAM;IAO3B,SAAS,IAAI,SAAS;IAItB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAMjC,UAAU,IAAI,KAAK,EAAE;IAIrB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAMjC,WAAW,IAAI,WAAW;IAO1B,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMvC,QAAQ,IAAI,eAAe;IAO3B,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAMtC,aAAa,IAAI,SAAS;IAO1B,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAMrC,SAAS,IAAI,cAAc,EAAE;IAO7B,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAMxC,YAAY,IAAI,QAAQ,GAAG,IAAI;IAM/B,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAMlC,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,SAAS;CAOlB"}

package/dist/storage/repository.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepositoryStorage = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+/**
+ * Reads and writes the versioned repository memory files stored in .vemora/.
+ * All files here are committed to git so collaborators share the same index.
+ */
+class RepositoryStorage {
+    memoryDir;
+    indexDir;
+    constructor(rootDir) {
+        this.memoryDir = path_1.default.join(rootDir, config_1.AI_MEMORY_DIR);
+        this.indexDir = path_1.default.join(this.memoryDir, config_1.INDEX_DIR);
+    }
+    // ─── Files Index ────────────────────────────────────────────────────────────
+    loadFiles() {
+        return this.readJson(path_1.default.join(this.indexDir, config_1.FILES_JSON), {});
+    }
+    saveFiles(index) {
+        this.writeJson(path_1.default.join(this.indexDir, config_1.FILES_JSON), index);
+    }
+    // ─── Chunks ─────────────────────────────────────────────────────────────────
+    loadChunks() {
+        return this.readJson(path_1.default.join(this.indexDir, config_1.CHUNKS_JSON), []);
+    }
+    saveChunks(chunks) {
+        this.writeJson(path_1.default.join(this.indexDir, config_1.CHUNKS_JSON), chunks);
+    }
+    // ─── Symbol Index ────────────────────────────────────────────────────────────
+    loadSymbols() {
+        return this.readJson(path_1.default.join(this.indexDir, config_1.SYMBOLS_JSON), {});
+    }
+    saveSymbols(symbols) {
+        this.writeJson(path_1.default.join(this.indexDir, config_1.SYMBOLS_JSON), symbols);
+    }
+    // ─── Dependency Graph ────────────────────────────────────────────────────────
+    loadDeps() {
+        return this.readJson(path_1.default.join(this.indexDir, config_1.DEPS_JSON), {});
+    }
+    saveDeps(graph) {
+        this.writeJson(path_1.default.join(this.indexDir, config_1.DEPS_JSON), graph);
+    }
+    // ─── Call Graph ──────────────────────────────────────────────────────────────
+    loadCallGraph() {
+        return this.readJson(path_1.default.join(this.indexDir, config_1.CALLGRAPH_JSON), {});
+    }
+    saveCallGraph(graph) {
+        this.writeJson(path_1.default.join(this.indexDir, config_1.CALLGRAPH_JSON), graph);
+    }
+    // ─── TODO Annotations ────────────────────────────────────────────────────────
+    loadTodos() {
+        return this.readJson(path_1.default.join(this.indexDir, config_1.TODOS_JSON), []);
+    }
+    saveTodos(todos) {
+        this.writeJson(path_1.default.join(this.indexDir, config_1.TODOS_JSON), todos);
+    }
+    // ─── Metadata ────────────────────────────────────────────────────────────────
+    loadMetadata() {
+        const p = path_1.default.join(this.memoryDir, config_1.METADATA_FILE);
+        if (!fs_1.default.existsSync(p))
+            return null;
+        return this.readJson(p, null);
+    }
+    saveMetadata(meta) {
+        this.writeJson(path_1.default.join(this.memoryDir, config_1.METADATA_FILE), meta);
+    }
+    // ─── Helpers ─────────────────────────────────────────────────────────────────
+    readJson(filePath, fallback) {
+        if (!fs_1.default.existsSync(filePath))
+            return fallback;
+        try {
+            return JSON.parse(fs_1.default.readFileSync(filePath, "utf-8"));
+        }
+        catch {
+            const rel = path_1.default.relative(this.memoryDir, filePath);
+            console.warn(`[vemora] warning: .vemora/${rel} is malformed — returning empty data. Re-run \`vemora index\` to rebuild.`);
+            return fallback;
+        }
+    }
+    writeJson(filePath, data) {
+        const dir = path_1.default.dirname(filePath);
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        const tmp = filePath + ".tmp";
+        fs_1.default.writeFileSync(tmp, JSON.stringify(data), "utf-8");
+        fs_1.default.renameSync(tmp, filePath);
+    }
+}
+exports.RepositoryStorage = RepositoryStorage;
+//# sourceMappingURL=repository.js.map

package/dist/storage/repository.js.map

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

package/dist/storage/session.d.ts

@@ -0,0 +1,38 @@
+export interface SessionState {
+    sessionId: string;
+    /** ISO timestamp of last query in this session */
+    lastActiveAt: string;
+    /** Chunk IDs already returned to the LLM in this session */
+    seenChunkIds: string[];
+}
+/**
+ * Manages per-project session memory stored in the local developer cache.
+ *
+ * The session tracks which chunk IDs have been returned to the LLM so that
+ * subsequent queries can skip already-seen chunks. Sessions auto-expire after
+ * 30 minutes of idle time.
+ *
+ * Stored in ~/.vemora-cache/<projectId>/session.json — never in the repo.
+ */
+export declare class SessionStorage {
+    private filePath;
+    constructor(projectId: string);
+    private load;
+    /**
+     * Returns the active session, or creates a new one if expired or absent.
+     * A session expires after SESSION_TIMEOUT_MS of inactivity.
+     */
+    loadOrCreate(): SessionState;
+    private newSession;
+    private saveState;
+    /** Resets the session to a clean state (new session ID, empty seen list). */
+    reset(): SessionState;
+    /**
+     * Adds chunk IDs to the seen set and refreshes the session timestamp.
+     * Creates or continues the current session as needed.
+     */
+    markSeen(chunkIds: string[]): void;
+    /** Returns the set of chunk IDs seen in the current (unexpired) session. */
+    getSeenIds(): Set<string>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/storage/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/storage/session.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAUD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,EAAE,MAAM;IAK7B,OAAO,CAAC,IAAI;IASZ;;;OAGG;IACH,YAAY,IAAI,YAAY;IAS5B,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,SAAS;IAQjB,6EAA6E;IAC7E,KAAK,IAAI,YAAY;IAMrB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IASlC,4EAA4E;IAC5E,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;CAO1B"}

package/dist/storage/session.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStorage = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+// ─── Constants ────────────────────────────────────────────────────────────────
+/** Idle duration after which a session is considered expired (30 min) */
+const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+const SESSION_FILE = "session.json";
+// ─── Storage ──────────────────────────────────────────────────────────────────
+/**
+ * Manages per-project session memory stored in the local developer cache.
+ *
+ * The session tracks which chunk IDs have been returned to the LLM so that
+ * subsequent queries can skip already-seen chunks. Sessions auto-expire after
+ * 30 minutes of idle time.
+ *
+ * Stored in ~/.vemora-cache/<projectId>/session.json — never in the repo.
+ */
+class SessionStorage {
+    filePath;
+    constructor(projectId) {
+        const dir = (0, config_1.getLocalCacheDir)(projectId);
+        this.filePath = path_1.default.join(dir, SESSION_FILE);
+    }
+    load() {
+        if (!fs_1.default.existsSync(this.filePath))
+            return null;
+        try {
+            return JSON.parse(fs_1.default.readFileSync(this.filePath, "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Returns the active session, or creates a new one if expired or absent.
+     * A session expires after SESSION_TIMEOUT_MS of inactivity.
+     */
+    loadOrCreate() {
+        const existing = this.load();
+        if (existing) {
+            const idle = Date.now() - new Date(existing.lastActiveAt).getTime();
+            if (idle < 0 || idle < SESSION_TIMEOUT_MS)
+                return existing;
+        }
+        return this.newSession();
+    }
+    newSession() {
+        return {
+            sessionId: crypto_1.default.randomBytes(8).toString("hex"),
+            lastActiveAt: new Date().toISOString(),
+            seenChunkIds: [],
+        };
+    }
+    saveState(state) {
+        const dir = path_1.default.dirname(this.filePath);
+        if (!fs_1.default.existsSync(dir))
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        const tmp = this.filePath + ".tmp";
+        fs_1.default.writeFileSync(tmp, JSON.stringify(state), "utf-8");
+        fs_1.default.renameSync(tmp, this.filePath);
+    }
+    /** Resets the session to a clean state (new session ID, empty seen list). */
+    reset() {
+        const fresh = this.newSession();
+        this.saveState(fresh);
+        return fresh;
+    }
+    /**
+     * Adds chunk IDs to the seen set and refreshes the session timestamp.
+     * Creates or continues the current session as needed.
+     */
+    markSeen(chunkIds) {
+        const state = this.loadOrCreate();
+        const seen = new Set(state.seenChunkIds);
+        for (const id of chunkIds)
+            seen.add(id);
+        state.seenChunkIds = Array.from(seen);
+        state.lastActiveAt = new Date().toISOString();
+        this.saveState(state);
+    }
+    /** Returns the set of chunk IDs seen in the current (unexpired) session. */
+    getSeenIds() {
+        const state = this.load();
+        if (!state)
+            return new Set();
+        const idle = Date.now() - new Date(state.lastActiveAt).getTime();
+        if (idle >= SESSION_TIMEOUT_MS)
+            return new Set();
+        return new Set(state.seenChunkIds);
+    }
+}
+exports.SessionStorage = SessionStorage;
+//# sourceMappingURL=session.js.map

package/dist/storage/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/storage/session.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,4CAAoB;AACpB,gDAAwB;AACxB,2CAAkD;AAYlD,iFAAiF;AAEjF,yEAAyE;AACzE,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC1C,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,iFAAiF;AAEjF;;;;;;;;GAQG;AACH,MAAa,cAAc;IACjB,QAAQ,CAAS;IAEzB,YAAY,SAAiB;QAC3B,MAAM,GAAG,GAAG,IAAA,yBAAgB,EAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAiB,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;YACpE,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,kBAAkB;gBAAE,OAAO,QAAQ,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAEO,UAAU;QAChB,OAAO;YACL,SAAS,EAAE,gBAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAChD,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,KAAmB;QACnC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,YAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACnC,YAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACtD,YAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,6EAA6E;IAC7E,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAkB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACzC,KAAK,MAAM,EAAE,IAAI,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,4EAA4E;IAC5E,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QACjE,IAAI,IAAI,IAAI,kBAAkB;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QACjD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;CACF;AA1ED,wCA0EC"}

package/dist/storage/summaries.d.ts

@@ -0,0 +1,19 @@
+import type { FileSummaryIndex, ProjectSummary } from "../core/types";
+/**
+ * Reads and writes LLM-generated summary files stored in .vemora/summaries/.
+ * These files are committed to git so the whole team shares the same summaries.
+ */
+export declare class SummaryStorage {
+    private summariesDir;
+    constructor(rootDir: string);
+    loadFileSummaries(): FileSummaryIndex;
+    saveFileSummaries(index: FileSummaryIndex): void;
+    loadProjectSummary(): ProjectSummary | null;
+    saveProjectSummary(summary: ProjectSummary): void;
+    hasFileSummaries(): boolean;
+    hasProjectSummary(): boolean;
+    getSummariesDir(): string;
+    private readJson;
+    private writeJson;
+}
+//# sourceMappingURL=summaries.d.ts.map

package/dist/storage/summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaries.d.ts","sourceRoot":"","sources":["../../src/storage/summaries.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEtE;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,MAAM;IAM3B,iBAAiB,IAAI,gBAAgB;IAOrC,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAMhD,kBAAkB,IAAI,cAAc,GAAG,IAAI;IAM3C,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAMjD,gBAAgB,IAAI,OAAO;IAI3B,iBAAiB,IAAI,OAAO;IAI5B,eAAe,IAAI,MAAM;IAMzB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;CAOlB"}

package/dist/storage/summaries.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SummaryStorage = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+/**
+ * Reads and writes LLM-generated summary files stored in .vemora/summaries/.
+ * These files are committed to git so the whole team shares the same summaries.
+ */
+class SummaryStorage {
+    summariesDir;
+    constructor(rootDir) {
+        this.summariesDir = path_1.default.join(rootDir, config_1.AI_MEMORY_DIR, config_1.SUMMARIES_DIR);
+    }
+    // ─── File Summaries ──────────────────────────────────────────────────────────
+    loadFileSummaries() {
+        return this.readJson(path_1.default.join(this.summariesDir, config_1.FILE_SUMMARIES_JSON), {});
+    }
+    saveFileSummaries(index) {
+        this.writeJson(path_1.default.join(this.summariesDir, config_1.FILE_SUMMARIES_JSON), index);
+    }
+    // ─── Project Summary ─────────────────────────────────────────────────────────
+    loadProjectSummary() {
+        const p = path_1.default.join(this.summariesDir, config_1.PROJECT_SUMMARY_JSON);
+        if (!fs_1.default.existsSync(p))
+            return null;
+        return this.readJson(p, null);
+    }
+    saveProjectSummary(summary) {
+        this.writeJson(path_1.default.join(this.summariesDir, config_1.PROJECT_SUMMARY_JSON), summary);
+    }
+    // ─── Status helpers ───────────────────────────────────────────────────────────
+    hasFileSummaries() {
+        return fs_1.default.existsSync(path_1.default.join(this.summariesDir, config_1.FILE_SUMMARIES_JSON));
+    }
+    hasProjectSummary() {
+        return fs_1.default.existsSync(path_1.default.join(this.summariesDir, config_1.PROJECT_SUMMARY_JSON));
+    }
+    getSummariesDir() {
+        return this.summariesDir;
+    }
+    // ─── Helpers ─────────────────────────────────────────────────────────────────
+    readJson(filePath, fallback) {
+        if (!fs_1.default.existsSync(filePath))
+            return fallback;
+        try {
+            return JSON.parse(fs_1.default.readFileSync(filePath, "utf-8"));
+        }
+        catch {
+            return fallback;
+        }
+    }
+    writeJson(filePath, data) {
+        const dir = path_1.default.dirname(filePath);
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        const tmp = filePath + ".tmp";
+        fs_1.default.writeFileSync(tmp, JSON.stringify(data), "utf-8");
+        fs_1.default.renameSync(tmp, filePath);
+    }
+}
+exports.SummaryStorage = SummaryStorage;
+//# sourceMappingURL=summaries.js.map

package/dist/storage/summaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaries.js","sourceRoot":"","sources":["../../src/storage/summaries.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,2CAKwB;AAGxB;;;GAGG;AACH,MAAa,cAAc;IACjB,YAAY,CAAS;IAE7B,YAAY,OAAe;QACzB,IAAI,CAAC,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,sBAAa,EAAE,sBAAa,CAAC,CAAC;IACvE,CAAC;IAED,gFAAgF;IAEhF,iBAAiB;QACf,OAAO,IAAI,CAAC,QAAQ,CAClB,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,4BAAmB,CAAC,EACjD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,KAAuB;QACvC,IAAI,CAAC,SAAS,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,4BAAmB,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,gFAAgF;IAEhF,kBAAkB;QAChB,MAAM,CAAC,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAAoB,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAiB,CAAC,EAAE,IAAiC,CAAC,CAAC;IAC7E,CAAC;IAED,kBAAkB,CAAC,OAAuB;QACxC,IAAI,CAAC,SAAS,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAAoB,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,iFAAiF;IAEjF,gBAAgB;QACd,OAAO,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,4BAAmB,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,iBAAiB;QACf,OAAO,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAAoB,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,gFAAgF;IAExE,QAAQ,CAAI,QAAgB,EAAE,QAAW;QAC/C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC9C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAM,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,QAAgB,EAAE,IAAa;QAC/C,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,YAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC9B,YAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACrD,YAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;CACF;AAhED,wCAgEC"}