memory-eternal 0.20.0 → 0.21.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memory-eternal",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "记忆核心（Memory Eternal）：对话结束后自动沉淀知识卡到本地记忆库（~/.dsh/memory-vault），支持检索 / 召回 / 审核中心。",
   "author": {
     "name": "EternalNight996",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "记忆核心（Memory Eternal）：对话结束后自动沉淀知识卡到本地记忆库（~/.dsh/memory-vault），支持检索 / 召回 / 审核中心。",
   "author": {
     "name": "EternalNight996",

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "记忆核心（Memory Eternal）：对话结束后自动沉淀知识卡到本地记忆库（~/.dsh/memory-vault），支持检索 / 召回 / 审核中心。",
   "author": {
     "name": "EternalNight996",

package/cursor-extension/package.json

@@ -2,7 +2,7 @@
   "name": "memory-eternal",
   "displayName": "Memory Atlas",
   "description": "Memory-eternal: open the local Memory Atlas library, review queue and knowledge graph in a Cursor/VS Code webview.",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "publisher": "EternalNight996",
   "license": "MIT",
   "repository": {

package/dsh-tui-plugin/dsh-plugin.json

@@ -2,7 +2,7 @@
   "$schema": "urn:dsh-std:community-draft:dsh-plugin:0.15",
   "id": "memory-eternal-tui",
   "name": "memory-eternal-tui",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "manifestVersion": "0.15",
   "description": "Open Memory Atlas from dsh-TUI: native /audit scene plus browser launcher.",
   "facets": {

package/dsh-tui-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal-tui",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Memory Atlas for dsh-TUI: /audit scene with reason/severity, batch confirmation and reject reasons.",
   "type": "module",
   "main": "main.js",

package/lib/api.js

@@ -17,7 +17,7 @@ import fs, { readFileSync } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { spawn } from 'node:child_process'
-import { listCards, countCards, readCard, search, searchAll, graph, graphAll, overview, exportCards, deleteCard, writeCard, parseCard, stats, optimizeCandidates, optimizeApply, addFeedback, dailyCounts, mergeCards, ensureVault, auditQueue, recycleList, purgeExpired, setCardStatus, setCardKind, restoreCard, mainStoreBodies } from './vault.js'
+import { listCards, countCards, readCard, search, searchAll, graph, graphAll, graphLevel, LEVEL_ERR_PATH, LEVEL_ERR_STALE, overview, exportCards, deleteCard, writeCard, parseCard, stats, optimizeCandidates, optimizeApply, addFeedback, dailyCounts, mergeCards, ensureVault, auditQueue, recycleList, purgeExpired, setCardStatus, setCardKind, restoreCard, mainStoreBodies } from './vault.js'
 import { compressExcerpt, guessRawKind, DEFAULT_CAPTURE_MAX_TOKENS } from './capture.js'
 import { buildDiagnostics } from './feedback.js'
 import { getSetupStatus, runSetup, mcpAgentAction } from './setup.js'
@@ -606,6 +606,25 @@ export function createApi(deps = {}) {
         json(res, 200, { ok: true, diagnostics: text, repo: 'EternalNight996/memory-eternal', version: (dshD && dshD.version) || envD.MEMORY_ETERNAL_VERSION || '' })
         return
       }
+      case '/graph/level': {
+        // 星球分层视图：一次只返回「一层」（根层 kind 折叠 / 卡片层 / 语义簇层）。
+        // 10k 规模下客户端绝不再拉全量图 —— 每层图元 ≤1000、payload ≤1MB（见 lib/vault.js 守卫）。
+        await ensureVault(vaultRoot)
+        const pathStr = query.get('path') || ''
+        const allRoots = query.get('all') === '1'
+        try {
+          const out = await graphLevel(vaultRoot, {
+            path: pathStr,
+            roots: allRoots ? vaultRoots() : null,
+          })
+          return json(res, 200, out)
+        } catch (e) {
+          // 分类失败：路径写错/语义簇过期是「客户端可纠正」的 400；其他未知异常一律 500，
+          // 内部细节只进服务端日志（不把 SQL/堆栈原文抛给浏览器）。
+          const { status, body } = levelErrorResponse(e, 'path=' + pathStr)
+          return json(res, status, body)
+        }
+      }
       case '/graph': {
         await ensureVault(vaultRoot)
         const all = query.get('all') === '1'
@@ -1315,6 +1334,29 @@ export function createApi(deps = {}) {
   }
 }
 
+/**
+ * 分层接口的错误 → HTTP 响应（纯函数，便于单测）。
+ *   LEVEL_PATH / LEVEL_STALE：客户端可以自己纠正（路径写错 / 卡片增删让簇 id 过期）→ 400 + 原文案；
+ *   其他未知异常：500 + 通用文案，**内部细节只写服务端日志**，不回给浏览器。
+ * 无论哪种，客户端都会显示「显式报错 + 保留当前层 + 重试」。
+ */
+export function levelErrorResponse(err, context = '') {
+  const code = err && err.code
+  if (code === LEVEL_ERR_PATH || code === LEVEL_ERR_STALE) {
+    return {
+      status: 400,
+      body: { ok: false, code, error: String((err && err.message) || err) },
+    }
+  }
+  try {
+    console.error('[memory-eternal] /graph/level 内部错误' + (context ? '（' + context + '）' : '') + '：', err)
+  } catch { /* console 不可用时彻底静默（日志失败不能反过来影响响应） */ }
+  return {
+    status: 500,
+    body: { ok: false, code: 'LEVEL_FAILED', error: '知识图谱层级暂时不可用，请稍后重试' },
+  }
+}
+
 export function json(res, status, body) {
   const payload = JSON.stringify(body)
   const headers = {