@sourcepress/cache 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @sourcepress/cache@0.1.0 build /Users/fabianvontiedemann/Developer/org/sourcepress/packages/cache
+> tsc
+

package/.turbo/turbo-test.log

@@ -0,0 +1,14 @@
+
+> @sourcepress/cache@0.1.0 test /Users/fabianvontiedemann/Developer/org/sourcepress/packages/cache
+> vitest run
+
+
+ RUN  v3.2.4 /Users/fabianvontiedemann/Developer/org/sourcepress/packages/cache
+
+ ✓ src/__tests__/memory.test.ts (7 tests) 2ms
+
+ Test Files  1 passed (1)
+      Tests  7 passed (7)
+   Start at  00:19:47
+   Duration  1.51s (transform 28ms, setup 0ms, collect 84ms, tests 2ms, environment 0ms, prepare 206ms)
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SourcePress Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/memory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory.test.d.ts.map

package/dist/__tests__/memory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/memory.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/memory.test.js

@@ -0,0 +1,72 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { MemoryCache } from "../memory.js";
+describe("MemoryCache", () => {
+    let cache;
+    beforeEach(() => {
+        cache = new MemoryCache();
+    });
+    describe("content files", () => {
+        const content = {
+            path: "content/posts/hello.mdx",
+            sha: "abc123",
+            frontmatter: { title: "Hello" },
+            body: "World",
+            last_synced_at: "2026-04-04",
+        };
+        it("stores and retrieves content", async () => {
+            await cache.setContentFile(content.path, content);
+            const result = await cache.getContentFile(content.path);
+            expect(result).toEqual(content);
+        });
+        it("returns null for missing content", async () => {
+            const result = await cache.getContentFile("nope");
+            expect(result).toBeNull();
+        });
+        it("lists content with prefix filter", async () => {
+            await cache.setContentFile("content/posts/a.mdx", {
+                ...content,
+                path: "content/posts/a.mdx",
+            });
+            await cache.setContentFile("content/cases/b.mdx", {
+                ...content,
+                path: "content/cases/b.mdx",
+            });
+            const posts = await cache.listContentFiles("content/posts/");
+            expect(posts).toHaveLength(1);
+            expect(posts[0].path).toBe("content/posts/a.mdx");
+        });
+        it("deletes content", async () => {
+            await cache.setContentFile(content.path, content);
+            await cache.deleteContentFile(content.path);
+            const result = await cache.getContentFile(content.path);
+            expect(result).toBeNull();
+        });
+    });
+    describe("sync state", () => {
+        it("stores and retrieves sync state", async () => {
+            await cache.setSyncState({ last_commit_sha: "abc", last_synced_at: "2026-04-04" });
+            const state = await cache.getSyncState();
+            expect(state?.last_commit_sha).toBe("abc");
+        });
+        it("returns null when no sync state", async () => {
+            const state = await cache.getSyncState();
+            expect(state).toBeNull();
+        });
+    });
+    describe("clear", () => {
+        it("removes all data", async () => {
+            await cache.setContentFile("a", {
+                path: "a",
+                sha: "1",
+                frontmatter: {},
+                body: "",
+                last_synced_at: "",
+            });
+            await cache.setSyncState({ last_commit_sha: "x", last_synced_at: "" });
+            await cache.clear();
+            expect(await cache.getContentFile("a")).toBeNull();
+            expect(await cache.getSyncState()).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=memory.test.js.map

package/dist/__tests__/memory.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { CacheProvider, CachedContent, CachedKnowledge, CachedEdge, SyncState, CachedEvalResult, } from "./interface.js";
+export { MemoryCache } from "./memory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,SAAS,EACT,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { MemoryCache } from "./memory.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/interface.d.ts

@@ -0,0 +1,53 @@
+export interface CacheProvider {
+    getContentFile(path: string): Promise<CachedContent | null>;
+    setContentFile(path: string, data: CachedContent): Promise<void>;
+    listContentFiles(prefix?: string): Promise<CachedContent[]>;
+    deleteContentFile(path: string): Promise<void>;
+    getKnowledgeFile(path: string): Promise<CachedKnowledge | null>;
+    setKnowledgeFile(path: string, data: CachedKnowledge): Promise<void>;
+    listKnowledgeFiles(prefix?: string): Promise<CachedKnowledge[]>;
+    deleteKnowledgeFile(path: string): Promise<void>;
+    getGraphEdges(): Promise<CachedEdge[]>;
+    setGraphEdges(edges: CachedEdge[]): Promise<void>;
+    getSyncState(): Promise<SyncState | null>;
+    setSyncState(state: SyncState): Promise<void>;
+    getEvalResults(): Promise<CachedEvalResult[]>;
+    addEvalResult(result: CachedEvalResult): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface CachedContent {
+    path: string;
+    sha: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+    last_synced_at: string;
+}
+export interface CachedKnowledge {
+    path: string;
+    sha: string;
+    entities: Array<{
+        type: string;
+        name: string;
+    }>;
+    quality: string;
+    quality_score: number;
+    last_synced_at: string;
+}
+export interface CachedEdge {
+    source: string;
+    target: string;
+    relation_type: string;
+}
+export interface SyncState {
+    last_commit_sha: string;
+    last_synced_at: string;
+}
+export interface CachedEvalResult {
+    content_type: string;
+    prompt_version: string;
+    score: number;
+    status: "keep" | "discard";
+    date: string;
+    reasoning?: string;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC5D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAChE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAChE,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,aAAa,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC1C,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,cAAc,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":""}

package/dist/memory.d.ts

@@ -0,0 +1,24 @@
+import type { CacheProvider, CachedContent, CachedEdge, CachedEvalResult, CachedKnowledge, SyncState } from "./interface.js";
+export declare class MemoryCache implements CacheProvider {
+    private content;
+    private knowledge;
+    private edges;
+    private syncState;
+    private evalResults;
+    getContentFile(path: string): Promise<CachedContent | null>;
+    setContentFile(path: string, data: CachedContent): Promise<void>;
+    listContentFiles(prefix?: string): Promise<CachedContent[]>;
+    deleteContentFile(path: string): Promise<void>;
+    getKnowledgeFile(path: string): Promise<CachedKnowledge | null>;
+    setKnowledgeFile(path: string, data: CachedKnowledge): Promise<void>;
+    listKnowledgeFiles(prefix?: string): Promise<CachedKnowledge[]>;
+    deleteKnowledgeFile(path: string): Promise<void>;
+    getGraphEdges(): Promise<CachedEdge[]>;
+    setGraphEdges(edges: CachedEdge[]): Promise<void>;
+    getSyncState(): Promise<SyncState | null>;
+    setSyncState(state: SyncState): Promise<void>;
+    getEvalResults(): Promise<CachedEvalResult[]>;
+    addEvalResult(result: CachedEvalResult): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,MAAM,gBAAgB,CAAC;AAExB,qBAAa,WAAY,YAAW,aAAa;IAChD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,WAAW,CAA0B;IAEvC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAG3D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAGhE,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAG/D,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpE,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK/D,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,aAAa,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAGtC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAGzC,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,cAAc,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAG7C,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/memory.js

@@ -0,0 +1,63 @@
+export class MemoryCache {
+    content = new Map();
+    knowledge = new Map();
+    edges = [];
+    syncState = null;
+    evalResults = [];
+    async getContentFile(path) {
+        return this.content.get(path) ?? null;
+    }
+    async setContentFile(path, data) {
+        this.content.set(path, data);
+    }
+    async listContentFiles(prefix) {
+        const all = Array.from(this.content.values());
+        if (!prefix)
+            return all;
+        return all.filter((c) => c.path.startsWith(prefix));
+    }
+    async deleteContentFile(path) {
+        this.content.delete(path);
+    }
+    async getKnowledgeFile(path) {
+        return this.knowledge.get(path) ?? null;
+    }
+    async setKnowledgeFile(path, data) {
+        this.knowledge.set(path, data);
+    }
+    async listKnowledgeFiles(prefix) {
+        const all = Array.from(this.knowledge.values());
+        if (!prefix)
+            return all;
+        return all.filter((k) => k.path.startsWith(prefix));
+    }
+    async deleteKnowledgeFile(path) {
+        this.knowledge.delete(path);
+    }
+    async getGraphEdges() {
+        return [...this.edges];
+    }
+    async setGraphEdges(edges) {
+        this.edges = [...edges];
+    }
+    async getSyncState() {
+        return this.syncState;
+    }
+    async setSyncState(state) {
+        this.syncState = { ...state };
+    }
+    async getEvalResults() {
+        return [...this.evalResults];
+    }
+    async addEvalResult(result) {
+        this.evalResults.push({ ...result });
+    }
+    async clear() {
+        this.content.clear();
+        this.knowledge.clear();
+        this.edges = [];
+        this.syncState = null;
+        this.evalResults = [];
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@sourcepress/cache",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@sourcepress/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/memory.test.ts

@@ -0,0 +1,82 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import type { CachedContent } from "../interface.js";
+import { MemoryCache } from "../memory.js";
+
+describe("MemoryCache", () => {
+	let cache: MemoryCache;
+
+	beforeEach(() => {
+		cache = new MemoryCache();
+	});
+
+	describe("content files", () => {
+		const content: CachedContent = {
+			path: "content/posts/hello.mdx",
+			sha: "abc123",
+			frontmatter: { title: "Hello" },
+			body: "World",
+			last_synced_at: "2026-04-04",
+		};
+
+		it("stores and retrieves content", async () => {
+			await cache.setContentFile(content.path, content);
+			const result = await cache.getContentFile(content.path);
+			expect(result).toEqual(content);
+		});
+
+		it("returns null for missing content", async () => {
+			const result = await cache.getContentFile("nope");
+			expect(result).toBeNull();
+		});
+
+		it("lists content with prefix filter", async () => {
+			await cache.setContentFile("content/posts/a.mdx", {
+				...content,
+				path: "content/posts/a.mdx",
+			});
+			await cache.setContentFile("content/cases/b.mdx", {
+				...content,
+				path: "content/cases/b.mdx",
+			});
+			const posts = await cache.listContentFiles("content/posts/");
+			expect(posts).toHaveLength(1);
+			expect(posts[0].path).toBe("content/posts/a.mdx");
+		});
+
+		it("deletes content", async () => {
+			await cache.setContentFile(content.path, content);
+			await cache.deleteContentFile(content.path);
+			const result = await cache.getContentFile(content.path);
+			expect(result).toBeNull();
+		});
+	});
+
+	describe("sync state", () => {
+		it("stores and retrieves sync state", async () => {
+			await cache.setSyncState({ last_commit_sha: "abc", last_synced_at: "2026-04-04" });
+			const state = await cache.getSyncState();
+			expect(state?.last_commit_sha).toBe("abc");
+		});
+
+		it("returns null when no sync state", async () => {
+			const state = await cache.getSyncState();
+			expect(state).toBeNull();
+		});
+	});
+
+	describe("clear", () => {
+		it("removes all data", async () => {
+			await cache.setContentFile("a", {
+				path: "a",
+				sha: "1",
+				frontmatter: {},
+				body: "",
+				last_synced_at: "",
+			});
+			await cache.setSyncState({ last_commit_sha: "x", last_synced_at: "" });
+			await cache.clear();
+			expect(await cache.getContentFile("a")).toBeNull();
+			expect(await cache.getSyncState()).toBeNull();
+		});
+	});
+});

package/src/index.ts

@@ -0,0 +1,9 @@
+export type {
+	CacheProvider,
+	CachedContent,
+	CachedKnowledge,
+	CachedEdge,
+	SyncState,
+	CachedEvalResult,
+} from "./interface.js";
+export { MemoryCache } from "./memory.js";

package/src/interface.ts

@@ -0,0 +1,59 @@
+export interface CacheProvider {
+	getContentFile(path: string): Promise<CachedContent | null>;
+	setContentFile(path: string, data: CachedContent): Promise<void>;
+	listContentFiles(prefix?: string): Promise<CachedContent[]>;
+	deleteContentFile(path: string): Promise<void>;
+
+	getKnowledgeFile(path: string): Promise<CachedKnowledge | null>;
+	setKnowledgeFile(path: string, data: CachedKnowledge): Promise<void>;
+	listKnowledgeFiles(prefix?: string): Promise<CachedKnowledge[]>;
+	deleteKnowledgeFile(path: string): Promise<void>;
+
+	getGraphEdges(): Promise<CachedEdge[]>;
+	setGraphEdges(edges: CachedEdge[]): Promise<void>;
+
+	getSyncState(): Promise<SyncState | null>;
+	setSyncState(state: SyncState): Promise<void>;
+
+	getEvalResults(): Promise<CachedEvalResult[]>;
+	addEvalResult(result: CachedEvalResult): Promise<void>;
+
+	clear(): Promise<void>;
+}
+
+export interface CachedContent {
+	path: string;
+	sha: string;
+	frontmatter: Record<string, unknown>;
+	body: string;
+	last_synced_at: string;
+}
+
+export interface CachedKnowledge {
+	path: string;
+	sha: string;
+	entities: Array<{ type: string; name: string }>;
+	quality: string;
+	quality_score: number;
+	last_synced_at: string;
+}
+
+export interface CachedEdge {
+	source: string;
+	target: string;
+	relation_type: string;
+}
+
+export interface SyncState {
+	last_commit_sha: string;
+	last_synced_at: string;
+}
+
+export interface CachedEvalResult {
+	content_type: string;
+	prompt_version: string;
+	score: number;
+	status: "keep" | "discard";
+	date: string;
+	reasoning?: string;
+}

package/src/memory.ts

@@ -0,0 +1,75 @@
+import type {
+	CacheProvider,
+	CachedContent,
+	CachedEdge,
+	CachedEvalResult,
+	CachedKnowledge,
+	SyncState,
+} from "./interface.js";
+
+export class MemoryCache implements CacheProvider {
+	private content = new Map<string, CachedContent>();
+	private knowledge = new Map<string, CachedKnowledge>();
+	private edges: CachedEdge[] = [];
+	private syncState: SyncState | null = null;
+	private evalResults: CachedEvalResult[] = [];
+
+	async getContentFile(path: string): Promise<CachedContent | null> {
+		return this.content.get(path) ?? null;
+	}
+	async setContentFile(path: string, data: CachedContent): Promise<void> {
+		this.content.set(path, data);
+	}
+	async listContentFiles(prefix?: string): Promise<CachedContent[]> {
+		const all = Array.from(this.content.values());
+		if (!prefix) return all;
+		return all.filter((c) => c.path.startsWith(prefix));
+	}
+	async deleteContentFile(path: string): Promise<void> {
+		this.content.delete(path);
+	}
+
+	async getKnowledgeFile(path: string): Promise<CachedKnowledge | null> {
+		return this.knowledge.get(path) ?? null;
+	}
+	async setKnowledgeFile(path: string, data: CachedKnowledge): Promise<void> {
+		this.knowledge.set(path, data);
+	}
+	async listKnowledgeFiles(prefix?: string): Promise<CachedKnowledge[]> {
+		const all = Array.from(this.knowledge.values());
+		if (!prefix) return all;
+		return all.filter((k) => k.path.startsWith(prefix));
+	}
+	async deleteKnowledgeFile(path: string): Promise<void> {
+		this.knowledge.delete(path);
+	}
+
+	async getGraphEdges(): Promise<CachedEdge[]> {
+		return [...this.edges];
+	}
+	async setGraphEdges(edges: CachedEdge[]): Promise<void> {
+		this.edges = [...edges];
+	}
+
+	async getSyncState(): Promise<SyncState | null> {
+		return this.syncState;
+	}
+	async setSyncState(state: SyncState): Promise<void> {
+		this.syncState = { ...state };
+	}
+
+	async getEvalResults(): Promise<CachedEvalResult[]> {
+		return [...this.evalResults];
+	}
+	async addEvalResult(result: CachedEvalResult): Promise<void> {
+		this.evalResults.push({ ...result });
+	}
+
+	async clear(): Promise<void> {
+		this.content.clear();
+		this.knowledge.clear();
+		this.edges = [];
+		this.syncState = null;
+		this.evalResults = [];
+	}
+}

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"compilerOptions": { "outDir": "dist", "rootDir": "src" },
+	"include": ["src"]
+}

package/vitest.config.ts

@@ -0,0 +1,2 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({ test: { include: ["src/__tests__/**/*.test.ts"] } });