sage-mem 2.5.1 → 2.7.0

package/lib/index.js

@@ -430,14 +430,16 @@ export class MemoryGateway extends TypertRemoteService {
     const norm = (list) => JSON.stringify([...list].map((s) => String(s).toLowerCase()).sort())
     const restartRequired =
       JSON.stringify(limits) !== JSON.stringify(pending.limits) || norm(activeExtra) !== norm(reservedExtra)
+    // 2.7.0：entry 是 canonical；sidebarEntry 只为 2.6.0 的客户端保留（派生值，不落盘）。
+    const ui = pendingUi(fileRead.data)
     return {
       limits,
       pendingLimits: pending.limits,
       restartRequired,
       // Q04 的诊断出口：面板据此说明「你保存的值没生效，原因是 X」；宿主侧先如实给出，别让问题只能靠猜。
       limitDiagnostics,
-      // 1.8.0：客户端行为（侧栏入口开关）。**不参与** restartRequired —— 改完立刻生效。
-      ui: pendingUi(fileRead.data),
+      // 1.8.0 / 2.7.0：客户端行为（界面入口三选一）。**不参与** restartRequired —— 改完立刻生效。
+      ui: { ...ui, sidebarEntry: ui.entry !== 'settings' },
       // 生效的保护名单（含两个内置名）+ 用户声明的那部分原文（面板编辑的是后者）
       reserved: [...new Set([INDEX_FILE_KEY, SESSION_LOG_KEY, ...reservedExtra.map((s) => s.toLowerCase())])],
       reservedExtra,
@@ -498,7 +500,8 @@ export class MemoryGateway extends TypertRemoteService {
       }
       const current = currentRead.data
       const mergedLimits = { ...(current?.limits ?? {}), ...nextLimits }
-      // ui 只覆盖这次给出的键；没给就沿用文件里的有效值（坏值 / 缺失一律按默认「开」）
+      // ui 只覆盖这次给出的键；没给就沿用文件里的有效值（坏值 / 缺失一律按默认「两个都显示」）。
+      // 2.7.0：落盘只写 canonical 的 entry，旧 sidebarEntry 由 pendingUi 迁移进来、不再写出。
       const mergedUi = { ...pendingUi(current), ...(uiPatch ?? {}) }
       await writeFileAtomic(SETTINGS_FILE, JSON.stringify({ limits: mergedLimits, ui: mergedUi, updatedAt: Date.now() }, null, 2))
     }

package/lib/settings.js

@@ -21,22 +21,34 @@ export const RESERVED_FILE = join(STATE_ROOT, 'reserved.json')
 export const clampInt = (v, spec) => (Number.isFinite(v) ? Math.max(spec.lo, Math.min(spec.hi, Math.round(v))) : spec.dflt)
 
 /**
- * 面板 UI 设置（1.8.0）。
+ * 面板 UI 设置（1.8.0；2.7.0 改成三选一）。
  *
  * ⚠️ 与 `limits` **不是一类**：上限在模块加载时就固化进常量，改完必须重启；
- * `ui.sidebarEntry` 是**客户端行为** —— 界面读到值就决定注不注册侧栏槽位，
+ * `ui.entry` 是**客户端行为** —— 界面读到值就决定注不注册侧栏 / 设置页槽位，
  * 改完立刻生效。所以它不进 `restartRequired` 的计算。
+ *
+ * 2.7.0：`entry` 取代 1.8.0 的布尔 `sidebarEntry`。三个值从类型上就保证
+ * 「至少保留一个入口」，不需要额外的互斥校验；旧字段只读不写。
  */
-export const DEFAULT_UI = Object.freeze({ sidebarEntry: true })
+export const ENTRY_MODES = Object.freeze(['both', 'sidebar', 'settings'])
+export const DEFAULT_UI = Object.freeze({ entry: 'both' })
 
-/** 读出 `ui` 的**有效值**：文件里没有 / 坏对象 / 不是布尔 → 一律回落默认（开）。 */
+/**
+ * 读出 `ui` 的**有效值**：新字段优先，旧 `sidebarEntry` 按
+ * `true → both` / `false → settings` 迁移；缺失或坏值回落默认（两个都显示）。
+ */
 export function pendingUi(fileObj) {
   const saved = fileObj?.ui && typeof fileObj.ui === 'object' && !Array.isArray(fileObj.ui) ? fileObj.ui : {}
-  return { sidebarEntry: typeof saved.sidebarEntry === 'boolean' ? saved.sidebarEntry : DEFAULT_UI.sidebarEntry }
+  if (ENTRY_MODES.includes(saved.entry)) return { entry: saved.entry }
+  if (typeof saved.sidebarEntry === 'boolean') return { entry: saved.sidebarEntry ? 'both' : 'settings' }
+  return { entry: DEFAULT_UI.entry }
 }
 
 /**
- * 校验 `setSettings({ ui })` 的那一段：**只认 `sidebarEntry` 一个键**，值必须是布尔。
+ * 校验 `setSettings({ ui })` 的那一段：认 `entry`（2.7.0）与旧 `sidebarEntry`（1.8.0）。
+ *
+ * 两个键同时给时要求语义一致（`sidebarEntry === (entry !== 'settings')`），否则报冲突 ——
+ * 旧客户端写 true 的语义是「侧栏显示、设置页也保留」，和 `entry:'sidebar'` 不是一回事。
  *
  * 返回 `{ ok:true, patch }`（patch 为 null = 调用方没给 ui，或给的是空对象）；`{ ok:false, error }`。
  * 与 limits 同一套严格语义：绝不静默丢掉不认识的键。
@@ -45,10 +57,30 @@ export function parseUiPatch(ui) {
   if (ui === undefined) return { ok: true, patch: null }
   if (!ui || typeof ui !== 'object' || Array.isArray(ui)) return { ok: false, error: 'sage-mem: ui must be an object' }
   const patch = {}
+  let hasLegacy = false
+  let legacy = null
   for (const [key, value] of Object.entries(ui)) {
-    if (key !== 'sidebarEntry') return { ok: false, error: `sage-mem: unknown ui setting: ${key}` }
-    if (typeof value !== 'boolean') return { ok: false, error: `sage-mem: ui.sidebarEntry must be a boolean, got ${typeof value}` }
-    patch.sidebarEntry = value
+    if (key === 'entry') {
+      if (typeof value !== 'string' || !ENTRY_MODES.includes(value)) {
+        return { ok: false, error: `sage-mem: ui.entry must be one of ${ENTRY_MODES.join(' | ')}, got ${JSON.stringify(value)}` }
+      }
+      patch.entry = value
+      continue
+    }
+    if (key === 'sidebarEntry') {
+      if (typeof value !== 'boolean') return { ok: false, error: `sage-mem: ui.sidebarEntry must be a boolean, got ${typeof value}` }
+      hasLegacy = true
+      legacy = value
+      continue
+    }
+    return { ok: false, error: `sage-mem: unknown ui setting: ${key}` }
+  }
+  if (hasLegacy) {
+    const derived = legacy ? 'both' : 'settings'
+    if (patch.entry !== undefined && patch.entry !== derived) {
+      return { ok: false, error: `sage-mem: ui.entry=${patch.entry} conflicts with ui.sidebarEntry=${legacy}` }
+    }
+    patch.entry = derived
   }
   return { ok: true, patch: Object.keys(patch).length ? patch : null }
 }

package/lib/typert.host.js

@@ -239,10 +239,9 @@ const settingsLimitsSchema = z.object({
 	'maxSessionBytes': z.number().readonly(),
 	'staleDays': z.number().readonly(),
 }).readonly()
-// 1.8.0：面板 UI 设置。`sidebarEntry` 是**客户端行为**（改完立刻生效），不进 restartRequired。
-const settingsUiSchema = z.object({
-	'sidebarEntry': z.boolean().readonly(),
-}).readonly()
+// 1.8.0 / 2.7.0：面板 UI 设置。`entry` 是**客户端行为**（改完立刻生效），不进 restartRequired。
+// `sidebarEntry` 是给 2.6.0 客户端的派生值（= entry !== 'settings'），永远随 `entry` 一起返回。
+const settingsUiSchema = z.object({ 'entry': z.enum(['both', 'sidebar', 'settings']).readonly(), 'sidebarEntry': z.boolean().readonly() }).readonly()
 const settingsSchema = z.object({
 	'limits': settingsLimitsSchema,
 	'pendingLimits': settingsLimitsSchema,
@@ -260,6 +259,7 @@ const settingsPatchSchema = z.object({
 		'staleDays': z.number().optional(),
 	}).readonly().optional(),
 	'ui': z.object({
+		'entry': z.enum(['both', 'sidebar', 'settings']).optional(),
 		'sidebarEntry': z.boolean().optional(),
 	}).readonly().optional(),
 	'reserved': z.array(z.string()).optional(),

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": "2.5.1",
+  "version": "2.7.0",
   "type": "module",
   "main": "lib/index.js",
   "icon": "./icon.png",