@kilnai/core 0.1.0

package/dist/memory/git-sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-sync-manager.d.ts","sourceRoot":"","sources":["../../src/memory/git-sync-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAgBvD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,UAAU,CAAqB;gBAE3B,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;IAQ9D,UAAU,IAAI,YAAY;IA4BpB,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,UAAU,IAAI,UAAU;IA4BxB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/memory/git-sync-manager.js

@@ -0,0 +1,77 @@
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ChunkImporter } from "./chunk-importer.js";
+import { getDeveloperIdentity, generateDeveloperId, } from "./developer-identity.js";
+export class GitSyncManager {
+    projectPath;
+    eventBus;
+    lastSyncAt = null;
+    constructor(opts) {
+        this.projectPath = opts.projectPath;
+        this.eventBus = opts.eventBus;
+        if (!existsSync(this.projectPath)) {
+            mkdirSync(this.projectPath, { recursive: true });
+        }
+    }
+    autoImport() {
+        const importer = new ChunkImporter({ projectPath: this.projectPath });
+        const newChunks = importer.discoverNewChunks();
+        const result = importer.importChunks(newChunks);
+        this.lastSyncAt = new Date();
+        if (this.eventBus && result.imported > 0) {
+            const devSet = new Set();
+            const manifest = this.readManifest();
+            for (const chunk of manifest.chunks) {
+                devSet.add(chunk.developer ?? "unknown");
+            }
+            const event = {
+                type: "memory_sync",
+                timestamp: new Date(),
+                sessionId: "",
+                imported: result.imported,
+                entries: result.entries,
+                developers: devSet.size,
+            };
+            this.eventBus.emit(event);
+        }
+        return result;
+    }
+    async flush(store) {
+        const identity = getDeveloperIdentity();
+        const devId = generateDeveloperId(identity);
+        await store.flush(devId);
+    }
+    syncStatus() {
+        const manifest = this.readManifest();
+        const devMap = new Map();
+        for (const chunk of manifest.chunks) {
+            const devId = chunk.developer ?? "unknown";
+            const existing = devMap.get(devId);
+            if (existing) {
+                existing.chunks++;
+                existing.entries += chunk.entries;
+            }
+            else {
+                devMap.set(devId, { chunks: 1, entries: chunk.entries });
+            }
+        }
+        const developers = [];
+        for (const [developerId, info] of devMap) {
+            developers.push({ developerId, chunks: info.chunks, entries: info.entries });
+        }
+        return {
+            chunks: manifest.chunks.length,
+            entries: manifest.chunks.reduce((sum, c) => sum + c.entries, 0),
+            developers,
+            lastSyncAt: this.lastSyncAt,
+        };
+    }
+    readManifest() {
+        const path = join(this.projectPath, "manifest.json");
+        if (!existsSync(path)) {
+            return { version: 1, chunks: [], deleted: [] };
+        }
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+}
+//# sourceMappingURL=git-sync-manager.js.map

package/dist/memory/git-sync-manager.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,46 @@
+import type { AgentRole } from "../agents/index.js";
+/** Memory layer identifier */
+export type MemoryLayer = "user" | "agent" | "project";
+/** A single memory entry */
+export interface MemoryEntry {
+    readonly id: string;
+    readonly layer: MemoryLayer;
+    readonly content: string;
+    readonly tags: readonly string[];
+    readonly createdAt: Date;
+    readonly lastAccessedAt: Date;
+    readonly accessCount: number;
+    readonly agentRole?: AgentRole;
+    readonly projectId?: string;
+}
+/** Memory search result with relevance score */
+export interface MemorySearchResult {
+    readonly entry: MemoryEntry;
+    readonly score: number;
+    readonly snippet: string;
+}
+/** Memory store interface */
+export interface MemoryStore {
+    save(entry: Omit<MemoryEntry, "id" | "createdAt" | "lastAccessedAt" | "accessCount">): Promise<string>;
+    search(query: string, limit?: number): Promise<readonly MemorySearchResult[]>;
+    recall(query: string, tokenBudget: number): Promise<string>;
+    forget(id: string): Promise<void>;
+    applyDecay?(factor?: number): void;
+    close?(): void;
+}
+export { SqliteMemoryStore } from "./sqlite-store.js";
+export type { SqliteMemoryStoreOptions } from "./sqlite-store.js";
+export { ProjectMemoryStore, stripPrivateTags } from "./project-store.js";
+export { MemoryManager } from "./memory-manager.js";
+export type { MemoryManagerOptions } from "./memory-manager.js";
+export { getDeveloperIdentity, generateDeveloperId } from "./developer-identity.js";
+export type { DeveloperIdentity } from "./developer-identity.js";
+export { ChunkImporter } from "./chunk-importer.js";
+export type { ImportResult } from "./chunk-importer.js";
+export { GitSyncManager } from "./git-sync-manager.js";
+export type { SyncStatus, DeveloperInfo } from "./git-sync-manager.js";
+export { exponentialDecay, linearDecay, stepDecay, applyDecayCurve, shouldPrune, DEFAULT_DECAY_CONFIG } from "./decay-curves.js";
+export type { DecayCurve, DecayConfig } from "./decay-curves.js";
+export { MemoryCompactor, DEFAULT_COMPACTION_CONFIG } from "./compactor.js";
+export type { CompactionConfig, CompactionResult, CompactableStore, CompactableEntry } from "./compactor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvD,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6BAA6B;AAC7B,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IAC9E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACjI,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,11 @@
+export { SqliteMemoryStore } from "./sqlite-store.js";
+export { ProjectMemoryStore, stripPrivateTags } from "./project-store.js";
+export { MemoryManager } from "./memory-manager.js";
+export { getDeveloperIdentity, generateDeveloperId } from "./developer-identity.js";
+export { ChunkImporter } from "./chunk-importer.js";
+export { GitSyncManager } from "./git-sync-manager.js";
+// Decay curves (Phase 2D)
+export { exponentialDecay, linearDecay, stepDecay, applyDecayCurve, shouldPrune, DEFAULT_DECAY_CONFIG } from "./decay-curves.js";
+// Memory compaction (Phase 2D)
+export { MemoryCompactor, DEFAULT_COMPACTION_CONFIG } from "./compactor.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGjI,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,34 @@
+import type { AgentRole } from "../agents/index.js";
+import type { EventBus } from "../events/event-bus.js";
+import type { MemoryEntry, MemoryLayer, MemorySearchResult, MemoryStore } from "./index.js";
+export interface MemoryManagerOptions {
+    readonly userStore: MemoryStore;
+    readonly agentStores: Map<AgentRole, MemoryStore>;
+    readonly projectStore: MemoryStore;
+    readonly eventBus: EventBus;
+}
+/**
+ * Coordinates all three memory layers with unified search and token budgets.
+ * Routes saves to the correct store, merges cross-layer search results,
+ * and implements progressive disclosure via recall().
+ */
+export declare class MemoryManager implements MemoryStore {
+    private readonly userStore;
+    private readonly agentStores;
+    private readonly projectStore;
+    private readonly eventBus;
+    private readonly sessionId;
+    constructor(options: MemoryManagerOptions, sessionId?: string);
+    save(entry: Omit<MemoryEntry, "id" | "createdAt" | "lastAccessedAt" | "accessCount">): Promise<string>;
+    search(query: string, limit?: number): Promise<readonly MemorySearchResult[]>;
+    /** Search with optional layer filter for cross-layer routing */
+    searchByLayer(query: string, layer: MemoryLayer, limit?: number): Promise<readonly MemorySearchResult[]>;
+    private searchAll;
+    recall(query: string, tokenBudget: number): Promise<string>;
+    forget(id: string): Promise<void>;
+    applyDecay(factor?: number): void;
+    close(): void;
+    private resolveStore;
+    private searchLayer;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,oBAAoB,EAAE,SAAS,CAAC,EAAE,MAAM;IAQvD,IAAI,CACR,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC,GAC9E,OAAO,CAAC,MAAM,CAAC;IAiBZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAIzC,gEAAgE;IAC1D,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;YAI3B,SAAS;IAyCjB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiC3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAMjC,KAAK,IAAI,IAAI;IAWb,OAAO,CAAC,YAAY;YAoBN,WAAW;CAqB1B"}

package/dist/memory/memory-manager.js

@@ -0,0 +1,151 @@
+/**
+ * Coordinates all three memory layers with unified search and token budgets.
+ * Routes saves to the correct store, merges cross-layer search results,
+ * and implements progressive disclosure via recall().
+ */
+export class MemoryManager {
+    userStore;
+    agentStores;
+    projectStore;
+    eventBus;
+    sessionId;
+    constructor(options, sessionId) {
+        this.userStore = options.userStore;
+        this.agentStores = options.agentStores;
+        this.projectStore = options.projectStore;
+        this.eventBus = options.eventBus;
+        this.sessionId = sessionId ?? "";
+    }
+    async save(entry) {
+        const store = this.resolveStore(entry.layer, entry.agentRole);
+        const id = await store.save(entry);
+        const savedEvent = {
+            type: "memory_saved",
+            timestamp: new Date(),
+            sessionId: this.sessionId,
+            memoryId: id,
+            layer: entry.layer,
+            tags: entry.tags,
+        };
+        this.eventBus.emit(savedEvent);
+        return id;
+    }
+    async search(query, limit) {
+        return this.searchAll(query, undefined, limit);
+    }
+    /** Search with optional layer filter for cross-layer routing */
+    async searchByLayer(query, layer, limit) {
+        return this.searchAll(query, layer, limit);
+    }
+    async searchAll(query, layer, limit) {
+        const maxResults = limit ?? 10;
+        let results;
+        if (layer !== undefined) {
+            results = [...await this.searchLayer(layer, query, maxResults)];
+        }
+        else {
+            const [userResults, projectResults, ...agentResults] = await Promise.all([
+                this.userStore.search(query, maxResults),
+                this.projectStore.search(query, maxResults),
+                ...Array.from(this.agentStores.values()).map((s) => s.search(query, maxResults)),
+            ]);
+            results = [
+                ...(userResults ?? []),
+                ...(projectResults ?? []),
+                ...agentResults.flat(),
+            ];
+            results.sort((a, b) => b.score - a.score);
+            results = results.slice(0, maxResults);
+        }
+        const recalledEvent = {
+            type: "memory_recalled",
+            timestamp: new Date(),
+            sessionId: this.sessionId,
+            query,
+            resultsCount: results.length,
+        };
+        this.eventBus.emit(recalledEvent);
+        return results;
+    }
+    async recall(query, tokenBudget) {
+        const userBudget = Math.floor(tokenBudget * 0.4);
+        const agentBudget = Math.floor(tokenBudget * 0.3);
+        const projectBudget = Math.floor(tokenBudget * 0.3);
+        const [userText, projectText, ...agentTexts] = await Promise.all([
+            this.userStore.recall(query, userBudget),
+            this.projectStore.recall(query, projectBudget),
+            ...Array.from(this.agentStores.entries()).map(([role, store]) => store.recall(query, agentBudget).then((text) => ({ role, text }))),
+        ]);
+        const parts = [];
+        if (typeof userText === "string" && userText.length > 0) {
+            parts.push(`--- User Memory ---\n${userText}`);
+        }
+        for (const item of agentTexts) {
+            const agentItem = item;
+            if (agentItem.text.length > 0) {
+                parts.push(`--- Agent Memory (${agentItem.role}) ---\n${agentItem.text}`);
+            }
+        }
+        if (typeof projectText === "string" && projectText.length > 0) {
+            parts.push(`--- Project Memory ---\n${projectText}`);
+        }
+        return parts.join("\n\n");
+    }
+    async forget(id) {
+        const stores = [
+            this.userStore,
+            this.projectStore,
+            ...this.agentStores.values(),
+        ];
+        await Promise.all(stores.map((s) => s.forget(id)));
+    }
+    applyDecay(factor) {
+        for (const store of this.agentStores.values()) {
+            store.applyDecay?.(factor);
+        }
+    }
+    close() {
+        const allStores = [
+            this.userStore,
+            this.projectStore,
+            ...this.agentStores.values(),
+        ];
+        for (const store of allStores) {
+            store.close?.();
+        }
+    }
+    resolveStore(layer, agentRole) {
+        switch (layer) {
+            case "user":
+                return this.userStore;
+            case "agent": {
+                const role = agentRole ?? "worker";
+                const store = this.agentStores.get(role);
+                if (!store) {
+                    throw new Error(`No agent store for role: ${role}`);
+                }
+                return store;
+            }
+            case "project":
+                return this.projectStore;
+        }
+    }
+    async searchLayer(layer, query, limit) {
+        switch (layer) {
+            case "user":
+                return this.userStore.search(query, limit);
+            case "agent": {
+                const allResults = [];
+                for (const store of this.agentStores.values()) {
+                    const results = await store.search(query, limit);
+                    allResults.push(...results);
+                }
+                allResults.sort((a, b) => b.score - a.score);
+                return allResults.slice(0, limit);
+            }
+            case "project":
+                return this.projectStore.search(query, limit);
+        }
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

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

package/dist/memory/project-store.d.ts

@@ -0,0 +1,28 @@
+import type { MemoryEntry, MemorySearchResult, MemoryStore } from "./index.js";
+/** Remove `<private>...</private>` blocks from content */
+export declare function stripPrivateTags(content: string): string;
+/**
+ * Git-synced gzipped JSONL memory store.
+ *
+ * Entries are buffered in memory and flushed to content-hashed
+ * `.jsonl.gz` chunk files when the buffer reaches the threshold.
+ * A `manifest.json` tracks all chunks and soft-deleted entry IDs.
+ */
+export declare class ProjectMemoryStore implements MemoryStore {
+    private readonly dir;
+    private buffer;
+    private _manifestCache;
+    constructor(opts: {
+        projectPath: string;
+    });
+    save(entry: Omit<MemoryEntry, "id" | "createdAt" | "lastAccessedAt" | "accessCount">): Promise<string>;
+    search(query: string, limit?: number): Promise<readonly MemorySearchResult[]>;
+    recall(query: string, tokenBudget: number): Promise<string>;
+    forget(id: string): Promise<void>;
+    flush(developerId?: string): Promise<void>;
+    get count(): number;
+    private readManifest;
+    private writeManifest;
+    private readAllEntries;
+}
+//# sourceMappingURL=project-store.d.ts.map

package/dist/memory/project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoB/E,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAAyB;gBAEnC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAOnC,IAAI,CACR,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC,GAC9E,OAAO,CAAC,MAAM,CAAC;IAoBZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAuCnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhD,IAAI,KAAK,IAAI,MAAM,CAIlB;IAID,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;CAoBvB"}

package/dist/memory/project-store.js

@@ -0,0 +1,159 @@
+import { gzipSync, gunzipSync } from "node:zlib";
+import { createHash, randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+const FLUSH_THRESHOLD = 10;
+/** Rough heuristic: ~4 characters per token for English text */
+const CHARS_PER_TOKEN_ESTIMATE = 4;
+/** Remove `<private>...</private>` blocks from content */
+export function stripPrivateTags(content) {
+    return content.replace(/<private>[\s\S]*?<\/private>/g, "").trim();
+}
+/**
+ * Git-synced gzipped JSONL memory store.
+ *
+ * Entries are buffered in memory and flushed to content-hashed
+ * `.jsonl.gz` chunk files when the buffer reaches the threshold.
+ * A `manifest.json` tracks all chunks and soft-deleted entry IDs.
+ */
+export class ProjectMemoryStore {
+    dir;
+    buffer = [];
+    _manifestCache = null;
+    constructor(opts) {
+        this.dir = opts.projectPath;
+        if (!existsSync(this.dir)) {
+            mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    async save(entry) {
+        const id = randomUUID();
+        const now = new Date();
+        const full = {
+            ...entry,
+            id,
+            content: stripPrivateTags(entry.content),
+            createdAt: now,
+            lastAccessedAt: now,
+            accessCount: 0,
+        };
+        this.buffer.push(full);
+        if (this.buffer.length >= FLUSH_THRESHOLD) {
+            await this.flush();
+        }
+        return id;
+    }
+    async search(query, limit = 10) {
+        const allEntries = this.readAllEntries();
+        const manifest = this.readManifest();
+        const deletedSet = new Set(manifest.deleted);
+        const terms = query
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((t) => t.length > 0);
+        const scored = [];
+        for (const entry of allEntries) {
+            if (deletedSet.has(entry.id))
+                continue;
+            const lower = entry.content.toLowerCase();
+            let score = 0;
+            for (const term of terms) {
+                let idx = 0;
+                while (true) {
+                    const found = lower.indexOf(term, idx);
+                    if (found === -1)
+                        break;
+                    score++;
+                    idx = found + term.length;
+                }
+            }
+            if (score > 0) {
+                scored.push({
+                    entry,
+                    score,
+                    snippet: entry.content.slice(0, 200),
+                });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit);
+    }
+    async recall(query, tokenBudget) {
+        const results = await this.search(query, 50);
+        const parts = [];
+        let usedTokens = 0;
+        for (const r of results) {
+            const entryTokens = Math.ceil(r.entry.content.length / CHARS_PER_TOKEN_ESTIMATE);
+            if (usedTokens + entryTokens > tokenBudget)
+                break;
+            parts.push(r.entry.content);
+            usedTokens += entryTokens;
+        }
+        return parts.join("\n\n");
+    }
+    async forget(id) {
+        const manifest = this.readManifest();
+        if (!manifest.deleted.includes(id)) {
+            manifest.deleted.push(id);
+        }
+        this.writeManifest(manifest);
+    }
+    async flush(developerId) {
+        if (this.buffer.length === 0)
+            return;
+        const lines = this.buffer.map((e) => JSON.stringify(e)).join("\n");
+        const compressed = gzipSync(Buffer.from(lines, "utf-8"));
+        const hash = createHash("sha256").update(compressed).digest("hex");
+        const filename = `${hash}.jsonl.gz`;
+        writeFileSync(join(this.dir, filename), compressed);
+        const manifest = this.readManifest();
+        manifest.chunks.push({
+            hash,
+            entries: this.buffer.length,
+            createdAt: new Date().toISOString(),
+            developer: developerId,
+        });
+        this.writeManifest(manifest);
+        this.buffer = [];
+    }
+    get count() {
+        const manifest = this.readManifest();
+        const chunkTotal = manifest.chunks.reduce((sum, c) => sum + c.entries, 0);
+        return chunkTotal + this.buffer.length - manifest.deleted.length;
+    }
+    // -- Private helpers --
+    readManifest() {
+        if (this._manifestCache)
+            return this._manifestCache;
+        const path = join(this.dir, "manifest.json");
+        if (!existsSync(path)) {
+            return { version: 1, chunks: [], deleted: [] };
+        }
+        this._manifestCache = JSON.parse(readFileSync(path, "utf-8"));
+        return this._manifestCache;
+    }
+    writeManifest(manifest) {
+        writeFileSync(join(this.dir, "manifest.json"), JSON.stringify(manifest, null, 2));
+        this._manifestCache = null;
+    }
+    readAllEntries() {
+        const manifest = this.readManifest();
+        const entries = [];
+        for (const chunk of manifest.chunks) {
+            const path = join(this.dir, `${chunk.hash}.jsonl.gz`);
+            if (!existsSync(path))
+                continue;
+            const compressed = readFileSync(path);
+            const decompressed = gunzipSync(compressed).toString("utf-8");
+            for (const line of decompressed.split("\n")) {
+                if (line.trim().length === 0)
+                    continue;
+                entries.push(JSON.parse(line));
+            }
+        }
+        // Include unflushed buffer entries
+        entries.push(...this.buffer);
+        return entries;
+    }
+}
+//# sourceMappingURL=project-store.js.map

package/dist/memory/project-store.js.map

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

package/dist/memory/sqlite-store.d.ts

@@ -0,0 +1,41 @@
+import type { MemoryEntry, MemoryLayer, MemorySearchResult, MemoryStore } from "./index.js";
+import type { DecayConfig } from "./decay-curves.js";
+import type { CompactionConfig, CompactionResult } from "./compactor.js";
+export interface SqliteMemoryStoreOptions {
+    readonly dbPath: string;
+    readonly layer: MemoryLayer;
+    readonly enableDecay?: boolean;
+    readonly decay?: DecayConfig;
+    readonly compaction?: CompactionConfig;
+    /** When set, enforces tenant namespace isolation: saves are tagged, searches/forgets are scoped. */
+    readonly tenantId?: string;
+}
+export declare class SqliteMemoryStore implements MemoryStore {
+    private readonly db;
+    private readonly layer;
+    private readonly enableDecay;
+    private readonly decayConfig;
+    private readonly compactor;
+    private readonly tenantId;
+    constructor(options: SqliteMemoryStoreOptions);
+    private initSchema;
+    save(entry: Omit<MemoryEntry, "id" | "createdAt" | "lastAccessedAt" | "accessCount">): Promise<string>;
+    search(query: string, limit?: number): Promise<readonly MemorySearchResult[]>;
+    recall(query: string, tokenBudget: number): Promise<string>;
+    forget(id: string): Promise<void>;
+    reinforce(id: string): void;
+    applyDecay(factor?: number): void;
+    /** Run compaction if configured and threshold exceeded. Returns null if compaction is not configured. */
+    runCompaction(): CompactionResult | null;
+    private asCompactable;
+    listEntries(options?: {
+        limit?: number;
+        tags?: string;
+    }): readonly MemoryEntry[];
+    hasEntry(id: string): boolean;
+    close(): void;
+    get count(): number;
+    private toSearchResult;
+    private toEntry;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/memory/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/memory/sqlite-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAsC,MAAM,gBAAgB,CAAC;AAM7G,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAmBD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,OAAO,EAAE,wBAAwB;IAiB7C,OAAO,CAAC,UAAU;IAmCZ,IAAI,CACR,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC,GAC9E,OAAO,CAAC,MAAM,CAAC;IAuBZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IA0CnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAS3B,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkCjC,yGAAyG;IACzG,aAAa,IAAI,gBAAgB,GAAG,IAAI;IAMxC,OAAO,CAAC,aAAa;IAkDrB,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,WAAW,EAAE;IA0ChF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK7B,KAAK,IAAI,IAAI;IAIb,IAAI,KAAK,IAAI,MAAM,CAGlB;IAED,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,OAAO;CAahB"}