@deepmaid/maid-memory-local 0.0.0-stage → 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kenyonxu
+
+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/lib/index.js

@@ -0,0 +1,164 @@
+import { createHash, randomUUID } from "node:crypto";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+//#region src/index.ts
+const name = "maid-memory-local";
+const inject = ["maidMemory"];
+/**
+* 策展扫描合成集(M3b 任务 10,铁律 7:只用 Doris/合成内容):global+null / global+已标注 /
+* personal 混排的 canned 假件集,scanUnsorted 只回 global+null 子集(与 mslm 服务端显式筛选
+* 同语义)。导出供契约测试推导期望集;ns 无关(local 是降级假件,无真实 global 层可盘)。
+*/
+const SYNTHETIC_UNSORTED_SCAN = [
+	{
+		id: "synthetic-global-fresh",
+		content: "合成示例:主人吃辣时配冰牛奶。",
+		scope: "global"
+	},
+	{
+		id: "synthetic-global-world",
+		content: "合成示例:深蓝馆一层是大厅。",
+		scope: "global"
+	},
+	{
+		id: "synthetic-global-tagged",
+		content: "合成示例:已标注的世界事实,不该再进扫描集。",
+		scope: "global",
+		provenanceKind: "world"
+	},
+	{
+		id: "synthetic-personal",
+		content: "合成示例:个人记忆,不属共享层。",
+		scope: "personal"
+	}
+];
+const apply = (ctx, config) => {
+	if (!config?.dataFile) throw new Error("maid-memory-local: config.dataFile 必填");
+	ctx.maidMemory.registerProvider(createLocalMemoryProvider(config));
+};
+function tokenize(text) {
+	const lower = text.toLowerCase();
+	return [...lower.match(/[a-z0-9]+/g) ?? [], ...lower.match(/[\u4e00-\u9fff]/g) ?? []];
+}
+function contentHash(record, ns) {
+	return createHash("sha256").update(`${ns}\0${record.title}\0${record.content}`).digest("hex");
+}
+/** local 降级假件:自包含 JSONL + 内存关键词打分(规格 §7.1;有意保持简单,不做向量/BM25)。 */
+function createLocalMemoryProvider(config) {
+	const file = config.dataFile;
+	const synthetic = SYNTHETIC_UNSORTED_SCAN.map((f) => ({ ...f }));
+	const rewriteFile = (kept) => {
+		mkdirSync(dirname(file), { recursive: true });
+		const tmp = `${file}.tmp`;
+		writeFileSync(tmp, kept.map((r) => JSON.stringify(r)).join("\n") + (kept.length > 0 ? "\n" : ""));
+		renameSync(tmp, file);
+	};
+	const load = () => {
+		if (!existsSync(file)) return [];
+		const out = [];
+		for (const line of readFileSync(file, "utf8").split("\n")) {
+			if (line.trim().length === 0) continue;
+			try {
+				out.push(JSON.parse(line));
+			} catch {}
+		}
+		return out;
+	};
+	const append = (records) => {
+		mkdirSync(dirname(file), { recursive: true });
+		appendFileSync(file, records.map((r) => JSON.stringify(r)).join("\n") + "\n");
+	};
+	return {
+		id: "local",
+		capabilities: {
+			forget: true,
+			sharedScopes: false,
+			supportsRecent: true
+		},
+		status: async () => "ready",
+		async recall(ns, query, limit) {
+			const tokens = new Set(tokenize(query));
+			const hits = [];
+			for (const record of load()) {
+				if (record.ns !== ns) continue;
+				let score = 0;
+				for (const token of tokens) {
+					if (record.tags.some((t) => tokenize(t).includes(token))) score += 3;
+					if (tokenize(record.title).includes(token)) score += 2;
+					if (tokenize(record.content).includes(token)) score += 1;
+				}
+				if (score > 0) hits.push({
+					id: record.id,
+					title: record.title,
+					content: record.content,
+					score,
+					createdAt: record.createdAt
+				});
+			}
+			hits.sort((a, b) => b.score - a.score);
+			return hits.slice(0, limit);
+		},
+		async recent(ns, limit) {
+			return load().filter((r) => r.ns === ns).slice(-limit).reverse().map((r) => ({
+				id: r.id,
+				title: r.title,
+				content: r.content,
+				createdAt: r.createdAt
+			}));
+		},
+		async write(ns, records, opts) {
+			const existing = load();
+			const receipts = [];
+			const fresh = [];
+			for (const record of records) {
+				const hash = contentHash(record, ns);
+				const found = existing.find((r) => r.hash === hash) ?? fresh.find((r) => r.hash === hash);
+				if (found !== void 0) {
+					receipts.push({
+						id: found.id,
+						deduped: true,
+						...opts?.scope !== void 0 ? { scope: opts.scope } : {}
+					});
+					continue;
+				}
+				const id = randomUUID();
+				fresh.push({
+					id,
+					ns,
+					title: record.title,
+					content: record.content,
+					tags: [...record.tags],
+					importance: record.importance,
+					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+					hash
+				});
+				receipts.push({
+					id,
+					deduped: false,
+					...opts?.scope !== void 0 ? { scope: opts.scope } : {}
+				});
+			}
+			if (fresh.length > 0) append(fresh);
+			return receipts;
+		},
+		async forget(ns, recordId) {
+			const kept = load().filter((r) => !(r.ns === ns && r.id === recordId));
+			const syntheticIdx = synthetic.findIndex((f) => f.id === recordId);
+			if (syntheticIdx >= 0) synthetic.splice(syntheticIdx, 1);
+			rewriteFile(kept);
+		},
+		async scanUnsorted() {
+			return synthetic.filter((f) => f.scope === "global" && f.provenanceKind === void 0);
+		},
+		async update(_ns, factId, opts) {
+			const target = synthetic.find((f) => f.id === factId);
+			if (target === void 0) throw new Error(`maid-memory-local: update 找不到合成集条目 ${factId}`);
+			if (opts.content !== void 0) target.content = opts.content;
+			if (opts.scope !== void 0) target.scope = opts.scope;
+			if (opts.provenanceKind !== void 0) target.provenanceKind = opts.provenanceKind;
+		},
+		async dispose() {}
+	};
+}
+//#endregion
+export { SYNTHETIC_UNSORTED_SCAN, apply, createLocalMemoryProvider, inject, name };

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "@deepmaid/maid-memory-local",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "files": [
+    "lib"
+  ],
+  "devDependencies": {
+    "tsdown": "0.22.14",
+    "typescript": "6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.