sage-mem 1.3.0 → 1.4.0

package/README.md

@@ -499,6 +499,7 @@ Module boundaries (since 1.2.0):
 - `lib/assembly/` — the four mounts: autodream / retrieval tools / observation / write gate
 - `lib/memory/` — pure memory-layer functions and file operations; `lib/autodream/` — the autodream engine
 - `lib/shared/` — zero-dependency cross-layer rules: file-name rule / local timestamps / the two size limits (**exactly one copy each**; `test/duplication-test.mjs` turns red otherwise)
+- UI side: `client/*.js` is split per screen (`05-shared.js` holds the cross-screen primitives and type tables); `npm run build:client` concatenates them into `lib/client.js`
 - Dependency direction: `memory` never imports `autodream`, `recall` depends only on `memory`, `assembly` never imports the composition root (`test/structure-test.mjs` turns red if that changes)
 
 ## Contributing

package/README.zh.md

@@ -503,6 +503,7 @@ memory/ 目录（markdown 文件，4 类）
 - `lib/assembly/` —— 四块挂载：autodream / 检索工具 / 观测 / 写入门
 - `lib/memory/` —— 记忆层的纯函数与文件操作；`lib/autodream/` —— 自动做梦引擎
 - `lib/shared/` —— 跨层零依赖的小判据：文件名规则 / 本地时间戳 / 两个体积上限（**只许一份**，`test/duplication-test.mjs` 会红）
+- 界面侧：`client/*.js` 按屏分片（`05-shared.js` 放跨屏小基元与类型词表），`npm run build:client` 拼成 `lib/client.js`
 - 依赖方向：`memory` 不认识 `autodream`，`recall` 只依赖 `memory`，`assembly` 不反向依赖组合根（`test/structure-test.mjs` 会红）
 
 ## 参与开发

package/lib/client.js

@@ -22,13 +22,68 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		const h = react.createElement;
 
+		// ── 共享基元（1.4.0）：跨屏复用的小东西只有这一份 ─────────────
+		// 这些名字原本在 10 / 20 / 50 三个分片各写一遍（isStr/isNum/strSchema/parseSchema/
+		// unwrap/fmtSize/hexA，以及类型词表 3 份）。分片共享同一个 factory 作用域，
+		// 所以收敛到本片之后，后面的分片直接用、不再各写一份。
+		const isStr = (v) => { if (typeof v !== "string") throw new Error("expected string"); };
+		const isBool = (v) => { if (typeof v !== "boolean") throw new Error("expected boolean"); };
+		const isNum = (v) => { if (typeof v !== "number") throw new Error("expected number"); };
+		function parseSchema(shape) {
+			return {
+				parse(value) {
+					if (value === null || typeof value !== "object") throw new Error("sage-mem: invalid payload");
+					for (const [key, check] of Object.entries(shape)) {
+						if (!(key in value)) throw new Error("sage-mem: missing field " + key);
+						check(value[key]);
+					}
+					return value;
+				},
+			};
+		}
+		const strSchema = { parse(v) { isStr(v); return v; } };
+
+		/** 拆 typert remote 的 {ok, value} 信封。 */
+		function unwrap(result) {
+			return result && result.ok ? result.value : result;
+		}
+
+		/** 字节数 → 人话。三个档位对记忆文件足够（单条上限 512 KB）。 */
+		function fmtSize(n) {
+			if (n < 1024) return n + " B";
+			if (n < 1024 * 1024) return (n / 1024).toFixed(1) + " KB";
+			return (n / 1024 / 1024).toFixed(1) + " MB";
+		}
+
+		/** #rrggbb + alpha → rgba()。星图的辉光/底盘用。 */
+		function hexA(hex, a) {
+			const n = parseInt(hex.slice(1), 16);
+			return "rgba(" + ((n >> 16) & 255) + "," + ((n >> 8) & 255) + "," + (n & 255) + "," + a.toFixed(3) + ")";
+		}
+
+		// ── 类型词表（唯一定义） ──
+		// 文件列表的排序 / 筛选 / 徽章、星图的 kind 标签与配色，全部从这里取。
+		const TYPE_ORDER = ["user", "feedback", "project", "reference"];
+		const TYPE_SORT = ["user", "feedback", "project", "reference", "special"];
+		const TYPE_LABEL = { user: "用户", feedback: "反馈", project: "项目", reference: "参考", special: "特殊" };
+		const TYPE_META = {
+			user: ["👤", TYPE_LABEL.user],
+			feedback: ["📌", TYPE_LABEL.feedback],
+			project: ["📁", TYPE_LABEL.project],
+			reference: ["🔗", TYPE_LABEL.reference],
+		};
+		// 星图配色：深色档（夜空）与浅色档（暖纸 + 矿物颜料）各一套，色相错开才分得清类型。
+		const TYPE_COLOR_DARK = {
+			user: "#e0c07a", feedback: "#7ec8da", project: "#ac9edc", reference: "#92ceaa", special: "#bcc3d0",
+		};
+		const TYPE_COLOR_LIGHT = {
+			user: "#a4652c", feedback: "#3a6f8f", project: "#6a5b8f", reference: "#4a7c63", special: "#5b5750",
+		};
 const StarmapRuntime = (function (require, _react) {
 	let react = _react;
 	const h = react.createElement;
 // ── 手写 strict codec（浏览器无 zod，typert 只要求 parse 方法）──
-		const isStr = (v) => { if (typeof v !== "string") throw new Error("expected string"); };
-		const isNum = (v) => { if (typeof v !== "number") throw new Error("expected number"); };
-		const strSchema = { parse(v) { isStr(v); return v; } };
+		// isStr / isNum / strSchema 来自 05-shared.js（这个 IIFE 在 factory 作用域内，看得到）。
 		const starSchema = {
 			parse(v) {
 				if (v === null || typeof v !== "object") throw new Error("invalid star");
@@ -81,11 +136,6 @@ const StarmapRuntime = (function (require, _react) {
 			],
 		};
 
-		/** 拆 typert remote 的 {ok, value} 信封。 */
-		function unwrap(result) {
-			return result && result.ok ? result.value : result;
-		}
-
 		/** 错误详情尽量展开，避免 "[object Object]" 式黑洞。 */
 		function detail(e) {
 			if (!e) return "未知错误";
@@ -114,15 +164,10 @@ const StarmapRuntime = (function (require, _react) {
 		// 深空画布上够辨认，又不抢眼。
 		//
 		// 两档取值：`color` = 深色档（夜空画布），`light` = 浅色档（纸本设色）。
-		// 浅色档不用「深色档降亮度」那种做法 —— 高饱和冷色压在暖纸上会发脏；
-		// 换成明度接近的矿物颜料色（赭石/石青/紫墨/石绿/墨），色相错开才分得清类型。
-		const KIND_META = {
-			user: { label: "用户", color: "#e0c07a", light: "#a4652c" },
-			feedback: { label: "反馈", color: "#7ec8da", light: "#3a6f8f" },
-			project: { label: "项目", color: "#ac9edc", light: "#6a5b8f" },
-			reference: { label: "参考", color: "#92ceaa", light: "#4a7c63" },
-			special: { label: "特殊", color: "#bcc3d0", light: "#5b5750" },
-		};
+		// 类型标签与配色来自 05-shared.js 的唯一定义；这里只是把它们组装成星图用的 meta。
+		const KIND_META = {};
+		for (const k of TYPE_SORT) KIND_META[k] = { label: TYPE_LABEL[k], color: TYPE_COLOR_DARK[k], light: TYPE_COLOR_LIGHT[k] };
+
 		/**
 		 * 宿主主题挂钩 —— 与 ui-theme 同一处：body[data-ds-dark-theme] 存在即深色档。
 		 */
@@ -180,16 +225,6 @@ const StarmapRuntime = (function (require, _react) {
 			return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
 		}
 
-		function hexA(hex, a) {
-			const n = parseInt(hex.slice(1), 16);
-			return "rgba(" + ((n >> 16) & 255) + "," + ((n >> 8) & 255) + "," + (n & 255) + "," + a.toFixed(3) + ")";
-		}
-
-		function fmtBytes(n) {
-			if (n >= 1024) return (n / 1024).toFixed(1) + " KB";
-			return n + " B";
-		}
-
 		function fmtDate(ms) {
 			if (!ms) return "";
 			const d = new Date(ms);
@@ -391,39 +426,12 @@ const StarmapRuntime = (function (require, _react) {
 			return blocks;
 		}
 
-		// ── overlay 开合的模块级 store（footer 按钮与 overlay 共享）──
-		const uiStore = { open: false, subs: new Set() };
 		/** client context 由 apply 存入；Slot 组件经 props 或此兜底获取。 */
 		let appCtx = null;
-		function setOpen(v) {
-			uiStore.open = !!v;
-			uiStore.subs.forEach((fn) => fn(uiStore.open));
-		}
-		function useOpen() {
-			const s = react.useState(uiStore.open);
-			react.useEffect(() => {
-				const fn = (v) => s[1](v);
-				uiStore.subs.add(fn);
-				return () => { uiStore.subs.delete(fn); };
-			}, []);
-			return s[0];
-		}
-
 		// ── 样式（data-plugin-css 约定，幂等注入）──
 		const CSS = [
-			".smap-footer-btn{display:inline-flex;align-items:center;gap:6px;border:1px solid var(--dsw-alias-border-l1,transparent);background:transparent;color:var(--dsw-alias-label-secondary,inherit);border-radius:8px;padding:4px 10px;font-size:12px;cursor:pointer;font-family:inherit;white-space:nowrap;}",
-			".smap-fab{position:fixed;right:0;top:15%;transform:translateY(-50%);z-index:900;width:36px;height:64px;border-radius:12px 0 0 12px;border:1px solid var(--dsw-alias-border-l1);border-right:none;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-brand-primary);font-size:17px;cursor:pointer;display:flex;align-items:center;justify-content:center;opacity:.5;pointer-events:auto;transition:opacity .15s,background .15s,width .15s;box-shadow:-4px 0 18px rgba(0,0,0,.35);font-family:inherit;}",
-			".smap-fab:hover{opacity:1;width:46px;background:var(--dsw-alias-bg-layer-1);}",
-			".smap-footer-btn:hover{color:var(--dsw-alias-label-primary,inherit);border-color:var(--dsw-alias-border-l2,#8886);}",
-			".smap-footer-icon{font-size:13px;line-height:1;}",
-			".smap-veil{position:fixed;inset:0;z-index:1000;background:var(--dsw-alias-bg-mask-1,rgba(0,0,0,.45));backdrop-filter:blur(3px);display:flex;align-items:center;justify-content:center;pointer-events:auto;animation:smap-fade-in .18s ease-out;}",
-			".smap-modal{width:min(980px,94vw);height:min(680px,92vh);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:16px;box-shadow:0 24px 80px rgba(0,0,0,.55);padding:16px 18px;display:flex;flex-direction:column;overflow:hidden;pointer-events:auto;animation:smap-pop-in .22s cubic-bezier(.2,.9,.3,1.15);}",
-			"@keyframes smap-fade-in{from{opacity:0}to{opacity:1}}",
-			"@keyframes smap-pop-in{from{opacity:0;transform:scale(.96) translateY(10px)}to{opacity:1;transform:none}}",
 			".smap-card{background:var(--dsw-alias-bg-layer-1);border-radius:10px;padding:12px 14px;color:var(--dsw-alias-label-primary);display:flex;flex-direction:column;flex:1;min-height:0;}",
 			".smap-head{display:flex;align-items:center;gap:10px;margin-bottom:10px;flex-wrap:wrap;}",
-			".smap-title{font-size:15px;font-weight:600;letter-spacing:.06em;}",
-			".smap-sub{font-size:11px;color:var(--dsw-alias-label-secondary);}",
 			".smap-spacer{flex:1;}",
 			".smap-search{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;color:var(--dsw-alias-label-primary);font-size:12px;padding:4px 9px;outline:none;width:160px;font-family:inherit;}",
 			".smap-search:focus{border-color:var(--dsw-alias-border-l2);}",
@@ -1358,7 +1366,7 @@ const StarmapRuntime = (function (require, _react) {
 					if (s.mtimeMs > newest) newest = s.mtimeMs;
 				}
 				legendKids.push(h("span", { key: "count", className: "smap-count" },
-					viewStars.length + " 条 · " + fmtBytes(totalBytes) + (newest ? " · 最近更新 " + fmtDate(newest) : "") +
+					viewStars.length + " 条 · " + fmtSize(totalBytes) + (newest ? " · 最近更新 " + fmtDate(newest) : "") +
 					(showArchive && archivedN ? " · 档案馆 " + archivedN + " 颗暗星" : "") +
 					" · 单击看" + (showArchive && archivedN ? "详情" : "全文")));
 
@@ -1367,7 +1375,7 @@ const StarmapRuntime = (function (require, _react) {
 					const kids = [
 						h("div", { key: "t", className: "smap-tip-title" }, hover.star.title),
 						h("div", { key: "k", className: "smap-tip-kind" },
-							meta.label + " · " + hover.star.file + " · " + fmtBytes(hover.star.bytes)),
+							meta.label + " · " + hover.star.file + " · " + fmtSize(hover.star.bytes)),
 					];
 					if (hover.star.archived === true) {
 						// 悬浮也要说清它是档案馆里的：暗星外表已经不同，别让人猜。
@@ -1391,7 +1399,7 @@ const StarmapRuntime = (function (require, _react) {
 							h("button", { className: "smap-btn", onClick: () => setSelected(null), title: "关闭" }, "×")),
 						h("div", { key: "meta", className: "smap-panel-meta" },
 							h("span", { className: "smap-meta-dot", style: { background: kindColor(meta) } }),
-							meta.label + " · " + selected.star.file + " · " + fmtBytes(selected.star.bytes) +
+							meta.label + " · " + selected.star.file + " · " + fmtSize(selected.star.bytes) +
 							// 归档星的 mtime 是「当年写下」的时间，跟「什么时候收起来的」不是一回事 ——
 							// 这里只留「已归档」，具体时间在下面的归档块里给。
 							(selected.star.archived === true
@@ -1494,42 +1502,11 @@ const StarmapRuntime = (function (require, _react) {
 				body);
 		}
 
-		// ── 全屏 overlay ─────────────────────────────────────────────
-		function StarmapOverlay() {
-			const open = useOpen();
-			react.useEffect(() => {
-				if (!open) return undefined;
-				const onKey = (e) => { if (e.key === "Escape") setOpen(false); };
-				document.addEventListener("keydown", onKey);
-				return () => document.removeEventListener("keydown", onKey);
-			}, [open]);
-			if (!open) return null;
-			return h("div", {
-				className: "smap-veil",
-				onMouseDown: (e) => { if (e.target === e.currentTarget) setOpen(false); },
-			},
-			h("div", { className: "smap-modal" },
-				h(StarMap, { ctx: appCtx, onClose: () => setOpen(false) })));
-		}
-
-		// ── 窗口右缘浮标（唯一入口，不绑实例/会话/Run 卡片）────────────
-		function StarmapEdgeTab() {
-			const open = useOpen();
-			if (open) return null;
-			return h("button", {
-				type: "button",
-				className: "smap-fab",
-				onClick: () => setOpen(true),
-				title: "记忆星图 — 把 sage-mem 的记忆画成一片星空",
-				"aria-label": "记忆星图",
-			}, "✦");
-		}
-
 		const inject = ["slots", "remote"];
 
 		/**
 		 * Client 插件：$mount strict remote contribution（第三方 remote 不在
-		 * 宿主的固定 remote 清单里，必须自己挂），再注册 footer 按钮与 overlay。
+		 * 宿主的固定 remote 清单里，必须自己挂），再注册星图子槽（B 方案起不再有右缘浮标与全屏 overlay）。
 		 */
 		async function apply(ctx) {
 			appCtx = ctx;
@@ -1559,22 +1536,7 @@ const StarmapRuntime = (function (require, _react) {
 
 
 		// ── 手写 strict codec（浏览器无 zod，typert 只要求 parse 方法）──
-		function parseSchema(shape) {
-			return {
-				parse(value) {
-					if (value === null || typeof value !== "object") throw new Error("sage-mem: invalid payload");
-					for (const [key, check] of Object.entries(shape)) {
-						if (!(key in value)) throw new Error("sage-mem: missing field " + key);
-						check(value[key]);
-					}
-					return value;
-				},
-			};
-		}
-		const isStr = (v) => { if (typeof v !== "string") throw new Error("expected string"); };
-		const isBool = (v) => { if (typeof v !== "boolean") throw new Error("expected boolean"); };
-		const isNum = (v) => { if (typeof v !== "number") throw new Error("expected number"); };
-		const strSchema = { parse(v) { isStr(v); return v; } };
+		// 基元（parseSchema / isStr / isBool / isNum / strSchema）在 05-shared.js。
 		const fileSchema = parseSchema({ "file": isStr, "type": isStr, "description": isStr, "size": isNum });
 		const listSchema = { parse(v) { if (!Array.isArray(v)) throw new Error("expected array"); v.forEach((f) => fileSchema.parse(f)); return v; } };
 		const readSchema = parseSchema({ "name": isStr, "content": isStr });
@@ -2072,10 +2034,6 @@ const StarmapRuntime = (function (require, _react) {
 			// ── 工具行 + 工具面板（体检 / 归档候选 / 保留名原样编辑）──
 			// 三个新入口收在一行**轻量**文字按钮里：不跟主工具栏抢重量级，也不各占一块版面。
 			// 面板一次只开一个（Section 里一个 tool 状态），否则文件列表会被顶到屏幕外。
-			".smem-tools{display:flex;align-items:center;gap:4px;flex-wrap:wrap;}",
-			".smem-tool-btn{border:0;background:transparent;color:var(--dsw-alias-label-secondary);font-size:12px;font-family:inherit;cursor:pointer;padding:2px 8px;border-radius:6px;}",
-			".smem-tool-btn:hover{color:var(--dsw-alias-label-primary);}",
-			'.smem-tool-btn[data-on="1"]{color:var(--dsw-alias-brand-primary,#4d76e6);background:var(--dsw-alias-bg-layer-2);}',
 			// 工具抽屉：关着时**零占位**（工具栏里只有一个「工具 ▾」），点开才占版面。
 			// ⚠️ 可发现性不靠抽屉本身，靠头部带常显的「体检 N 个问题」徽标 —— 那是整个
 			// 抽屉方案能成立的前提（否则三个能力就退回「藏起来」了）。
@@ -2207,18 +2165,6 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-star-link{color:var(--dsw-alias-brand-primary,#4d76e6);text-decoration:underline;}",
 		].join("\n");
 
-		const TYPE_META = {
-			user: ["👤", "用户"],
-			feedback: ["📌", "反馈"],
-			project: ["📁", "项目"],
-			reference: ["🔗", "参考"],
-		};
-		const TYPE_ORDER = ["user", "feedback", "project", "reference"];
-		// 筛选条上的显示名：emoji 在筛选条里太吵，只用文字；special 是星图的兜底类，
-		// 文件列表里出现它说明 frontmatter 写了 type: special。
-		const TYPE_LABEL = { user: "用户", feedback: "反馈", project: "项目", reference: "参考", special: "特殊" };
-		const TYPE_SORT = ["user", "feedback", "project", "reference", "special"];
-
 		/**
 		 * 把输入框里的一串标签切成数组。
 		 *
@@ -2467,17 +2413,6 @@ const StarmapRuntime = (function (require, _react) {
 				tagLine + "\nmetadata:\n  node_type: memory\n  type: " + type + "\n---\n\n";
 		}
 
-		function fmtSize(n) {
-			if (n < 1024) return n + " B";
-			if (n < 1024 * 1024) return (n / 1024).toFixed(1) + " KB";
-			return (n / 1024 / 1024).toFixed(1) + " MB";
-		}
-
-		/** 拆 typert remote 的 {ok, value} 信封。 */
-		function unwrap(result) {
-			return result && result.ok ? result.value : result;
-		}
-
 		function Chip(props) {
 			return h("button", {
 				type: "button",
@@ -2766,7 +2701,7 @@ const StarmapRuntime = (function (require, _react) {
 					standalone ? null : toolClose(props),
 				]),
 				r.problems
-					? h("div", { className: "smem-audit-secs", key: "secs" }, [
+					? h("div", { key: "secs" }, [
 							section("索引悬空（索引里有、文件没了）", r.dangling, (x) => x.file),
 							section("漏索引（文件在、索引里没有）", r.unlisted, (x) => x.file),
 							section("type 与前缀对不上", r.typeMismatch, (x) => x.file + " · type=" + x.type + "，文件名前缀=" + x.prefix),
@@ -3252,7 +3187,7 @@ const StarmapRuntime = (function (require, _react) {
 					subtab("settings", "设置"),
 					subtab("records", "记录", String(snaps.length + runs.length + reports.length)),
 				]),
-				segOf === "run" ? h("div", { className: "smem-seg", key: "seg-run" }, [
+				segOf === "run" ? h("div", { key: "seg-run" }, [
 				h("div", { className: "smem-autodream-sec", key: "top" }, [
 					h("div", { className: "smem-autodream-row", key: "r" }, [
 						h("button", {
@@ -3376,7 +3311,7 @@ const StarmapRuntime = (function (require, _react) {
 						: null,
 				]),
 				]) : null,
-				segOf === "settings" ? h("div", { className: "smem-seg", key: "seg-set" }, [
+				segOf === "settings" ? h("div", { key: "seg-set" }, [
 				// 自动归档那一段（三档策略 + 三个阈值）**已挪到「自动归档」页签**（v0.9.9）：
 				// 归档是确定性规则、不调模型，和这一页的「让模型整理」不是一件事；
 				// 同一件事只在一处设定，这里不再重复摆一份。
@@ -3477,7 +3412,7 @@ const StarmapRuntime = (function (require, _react) {
 				]) : null,
 				// ── 回滚点（新）──────────────────────────────────────────────
 				// 只改这一个文件、只用既有 h() 写法；数据全走 remote.autodream。
-				segOf === "records" ? h("div", { className: "smem-seg", key: "seg-rec" }, [
+				segOf === "records" ? h("div", { key: "seg-rec" }, [
 				h("div", { className: "smem-autodream-sec", key: "snap" }, [
 					h("div", { className: "smem-autodream-row", key: "h" }, [
 						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "回滚点"),
@@ -3706,7 +3641,7 @@ const StarmapRuntime = (function (require, _react) {
 				});
 			}
 
-			return h("div", { className: "smem-seg" }, [
+			return h("div", { }, [
 				// ── ① 它做什么（这一屏存在的理由写在最前面）──
 				h("div", { className: "smem-autodream-sec", key: "what" }, [
 					h("div", { className: "smem-autodream-row", key: "h" }, [
@@ -3898,7 +3833,8 @@ const StarmapRuntime = (function (require, _react) {
 			const rawBusy = sRawBusy[0], setRawBusy = sRawBusy[1];
 			const sRawLoading = react.useState(false);
 			const rawLoading = sRawLoading[0], setRawLoading = sRawLoading[1];
-			const renderSlot = props.renderSlot;
+			// renderSlot：shell 会经 props 传进来（见 80-apply 的 children 声明），
+			// 但本插件改用并列 tab 渲染星图，不再调用它 —— 声明保留给 shell，这里不取。
 
 			function load() {
 				setLoading(true);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sage-mem",
   "description": "Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {