vemora 0.1.0-alpha.15

package/dist/storage/cache.d.ts

@@ -0,0 +1,30 @@
+import type { EmbeddingCache } from "../core/types";
+/**
+ * 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.
+ */
+export declare class EmbeddingCacheStorage {
+    private cacheDir;
+    private cachePath;
+    private binPath;
+    private hnswPath;
+    constructor(projectId: string);
+    load(): EmbeddingCache | null;
+    save(cache: EmbeddingCache): void;
+    private writeAtomic;
+    update(newEmbeddings: Record<string, number[]>, cache: EmbeddingCache): EmbeddingCache;
+    prune(validChunkIds: Set<string>, cache: EmbeddingCache): EmbeddingCache;
+    /**
+     * Helper to always get a Map, regardless of storage format
+     */
+    private getEmbeddingsMap;
+    getCacheDir(): string;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/storage/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,EAAE,MAAM;IAO7B,IAAI,IAAI,cAAc,GAAG,IAAI;IAoD7B,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA0CjC,OAAO,CAAC,WAAW;IAMnB,MAAM,CACJ,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,KAAK,EAAE,cAAc,GACpB,cAAc;IAYjB,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,cAAc;IAwBxE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB,WAAW,IAAI,MAAM;CAGtB"}

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,23 @@
+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;
+    invalidate(id: string): boolean;
+    hasKnowledge(): boolean;
+    getKnowledgeDir(): string;
+}
+/**
+ * Returns only entries that are valid at the given point in time.
+ * Entries without validFrom/validUntil are treated as always-valid.
+ */
+export declare function filterValidAt(entries: KnowledgeEntry[], asOf?: Date): KnowledgeEntry[];
+//# 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,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,YAAY,IAAI,OAAO;IAIvB,eAAe,IAAI,MAAM;CAG1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EAAE,EACzB,IAAI,GAAE,IAAiB,GACtB,cAAc,EAAE,CAMlB"}

package/dist/storage/knowledge.js

@@ -0,0 +1,81 @@
+"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;
+exports.filterValidAt = filterValidAt;
+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;
+    }
+    invalidate(id) {
+        const entries = this.load();
+        const match = entries.find((e) => e.id === id);
+        if (!match)
+            return false;
+        match.validUntil = new Date().toISOString();
+        this.save(entries);
+        return true;
+    }
+    hasKnowledge() {
+        return fs_1.default.existsSync(this.entriesPath);
+    }
+    getKnowledgeDir() {
+        return this.knowledgeDir;
+    }
+}
+exports.KnowledgeStorage = KnowledgeStorage;
+/**
+ * Returns only entries that are valid at the given point in time.
+ * Entries without validFrom/validUntil are treated as always-valid.
+ */
+function filterValidAt(entries, asOf = new Date()) {
+    return entries.filter((e) => {
+        if (e.validFrom && new Date(e.validFrom) > asOf)
+            return false;
+        if (e.validUntil && new Date(e.validUntil) <= asOf)
+            return false;
+        return true;
+    });
+}
+//# 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":"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"}

package/dist/storage/planSession.d.ts

@@ -0,0 +1,39 @@
+export interface PlanSession {
+    sessionId: string;
+    /** Short 8-char prefix for display */
+    shortId: string;
+    task: string;
+    rootDir: string;
+    createdAt: string;
+    updatedAt: string;
+    status: "running" | "completed" | "failed";
+    plan: {
+        goal: string;
+        steps: unknown[];
+    };
+    /** stepId (string key) → executor answer */
+    stepResults: Record<string, string>;
+    /** IDs of all steps that completed successfully */
+    completedStepIds: number[];
+    /** Next available step ID for adaptive re-planning */
+    nextId: number;
+}
+/**
+ * Persists plan execution state to the local developer cache.
+ * Stored in ~/.vemora-cache/<projectId>/sessions/<sessionId>.json
+ * Never committed to git — local to the developer.
+ */
+export declare class PlanSessionStorage {
+    private sessionsDir;
+    constructor(projectId: string);
+    save(session: PlanSession): void;
+    /**
+     * Load a session by full UUID or by 8-char prefix.
+     * Returns null if not found.
+     */
+    load(sessionIdOrPrefix: string): PlanSession | null;
+    /** List all sessions, newest first. */
+    list(): PlanSession[];
+    delete(sessionId: string): boolean;
+}
+//# sourceMappingURL=planSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planSession.d.ts","sourceRoot":"","sources":["../../src/storage/planSession.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,EAAE,CAAC;KAClB,CAAC;IACF,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,SAAS,EAAE,MAAM;IAO7B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAUhC;;;OAGG;IACH,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAoBnD,uCAAuC;IACvC,IAAI,IAAI,WAAW,EAAE;IAqBrB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAMnC"}

package/dist/storage/planSession.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanSessionStorage = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+// ─── Constants ────────────────────────────────────────────────────────────────
+const SESSIONS_SUBDIR = "sessions";
+// ─── Storage ──────────────────────────────────────────────────────────────────
+/**
+ * Persists plan execution state to the local developer cache.
+ * Stored in ~/.vemora-cache/<projectId>/sessions/<sessionId>.json
+ * Never committed to git — local to the developer.
+ */
+class PlanSessionStorage {
+    sessionsDir;
+    constructor(projectId) {
+        this.sessionsDir = path_1.default.join((0, config_1.getLocalCacheDir)(projectId), SESSIONS_SUBDIR);
+    }
+    save(session) {
+        if (!fs_1.default.existsSync(this.sessionsDir)) {
+            fs_1.default.mkdirSync(this.sessionsDir, { recursive: true });
+        }
+        const filePath = path_1.default.join(this.sessionsDir, `${session.sessionId}.json`);
+        const tmp = `${filePath}.tmp`;
+        fs_1.default.writeFileSync(tmp, JSON.stringify(session, null, 2), "utf-8");
+        fs_1.default.renameSync(tmp, filePath);
+    }
+    /**
+     * Load a session by full UUID or by 8-char prefix.
+     * Returns null if not found.
+     */
+    load(sessionIdOrPrefix) {
+        if (!fs_1.default.existsSync(this.sessionsDir))
+            return null;
+        const files = fs_1.default.readdirSync(this.sessionsDir).filter((f) => f.endsWith(".json"));
+        const match = files.find((f) => f === `${sessionIdOrPrefix}.json` ||
+            f.startsWith(sessionIdOrPrefix));
+        if (!match)
+            return null;
+        try {
+            return JSON.parse(fs_1.default.readFileSync(path_1.default.join(this.sessionsDir, match), "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List all sessions, newest first. */
+    list() {
+        if (!fs_1.default.existsSync(this.sessionsDir))
+            return [];
+        return fs_1.default
+            .readdirSync(this.sessionsDir)
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => {
+            try {
+                return JSON.parse(fs_1.default.readFileSync(path_1.default.join(this.sessionsDir, f), "utf-8"));
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter(Boolean)
+            .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    }
+    delete(sessionId) {
+        const filePath = path_1.default.join(this.sessionsDir, `${sessionId}.json`);
+        if (!fs_1.default.existsSync(filePath))
+            return false;
+        fs_1.default.unlinkSync(filePath);
+        return true;
+    }
+}
+exports.PlanSessionStorage = PlanSessionStorage;
+//# sourceMappingURL=planSession.js.map

package/dist/storage/planSession.js.map

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

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"}