dsh-prime-memory 0.20.0-beta.3 → 0.20.0-beta.5

package/CHANGELOG.md

@@ -17,7 +17,30 @@
   - **建议状态(`longtask-hint-get`)+ 浮动球(`client/src/longtask-fab.ts`)**:ego-browser 式 vanilla overlay(FAB+面板,拖拽/位置持久化/视口夹紧),**建议不阻断**——仅当「上下文占用达 `contextThresholdPct`」或「todo 漂移达 `driftThreshold`」且长任务未开启时点亮呼吸光晕;面板内:长任务开关(临时,per-session,**不带 mode**——切开关不重置用户档位)、占用/漂移进度条、手动尾部压缩按钮(长任务开启才可用)、任务计数。轮询忙 2s/闲 5s,RPC 失败静默;座位契约不变(settings.section 恰一个,body 单例不占任何座位)。
   - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。
 
-## [0.20.0-beta.3] — 2026-10-01
+## [0.20.0-beta.5] — 2026-10-01
+
+> Room 分类管理第二船(**破坏性面**)。dryRun 默认 true——merge/rename 先预览影响面,确认后才实跑;执行前自动备份到 `rooms-merge-backups/`。
+
+### 新增
+
+- **Room 注册表两级制**:slug 支持 `major` 或 `major/minor` 两级(如 `dsh-plugin`、`dsh-plugin/merge`);**大类上限 200**,小类细分不占大类额度(总量保险 2000)。isTag 词表不放宽(slash 仅注册表层允许)。
+- **merge/rename/retire(工具 `memory_room_admin`,高权限)**:merge 游标重写全部匹配记录的 tags(写前重读-合并-写回,roomCandidates/roomReview/hall/anchors 等键保全;含已退场行,与计数口径一致);rename = merge 1:1 + 注册表改名(aliases 收旧名);retire 仅词表退役(存量不动)。merge/rename 与反刍并发会相互覆盖——请错峰执行(工具提示与 ADR-0020 均已声明)。
+- **重写安全三件套**:dryRun 默认只返 affected+预览零写入;执行前自动备份匹配记录到 `rooms-merge-backups/<ts>-<slug>.json`;完成自动 `invalidateRooms` + 按受影响 (family, scene) 入队场景重算(`source='room-merge'`)。
+- **面板 Room 管理子面板**(高权限开启后出现):注册表单(slug/名称/说明,走新 RPC `room-register`)、孤儿清单导出;合并/退役建议走 agent 工具(dryRun 预览更详细)。
+- 端点面 46 → 47(`room-register`)。
+
+## [0.20.0-beta.4] — 2026-10-01## [0.20.0-beta.4] — 2026-10-01
+
+> Room 分类管理第一船(**零漂移面**):注册表空 = 与 beta.3 行为逐字一致。merge/rename/retire 破坏性面将随 beta.5(dryRun 默认 true 保留一版)。
+
+### 新增
+
+- **Room 注册表(`rooms-registry.json` sidecar)**:预先注册策划好的 Room(slug/label/description);损坏/为空 → 降级回退纯自生长目录,绝不阻塞面板与标注器;上限 200 防刷。`rooms-get` 端点层合并:注册条目 count=0 也进词表并带 `source`/`label`,响应新增 `registry` 全量字段(客户端可选读)。
+- **导出端点 `dsh-memory/rooms-export`**(kind=rooms|orphans,CSV 直出):rooms = 注册表∪自生长词表带计数;orphans = 无 Room 绑定的活跃记录清单(含候选/复查状态列)。
+- **工具 `memory_room_admin`**(action=list|register):list 列注册表+自生长总览;register 预注册 Room(高权限门,幂等补全)——配合 `memory_room_review` 的逐个复查,agent 有了「注册→预标记→逐个确认」的完整分类管理入口。
+- 客户端:Room chip 带「预注册/自生长」来源标示;孤儿 chip 带待复查语义。
+
+## [0.20.0-beta.3] — 2026-10-01## [0.20.0-beta.3] — 2026-10-01
 
 ### 新增
 

package/dist/client.js

@@ -3298,6 +3298,7 @@ var __defProp = Object.defineProperty;
 		  });
 		  const [roomPage, setRoomPage] = (0, import_react15.useState)(0);
 		  const [orphanCount, setOrphanCount] = (0, import_react15.useState)(0);
+		  const [roomRegistry, setRoomRegistry] = (0, import_react15.useState)([]);
 		  const [retiredFilter, setRetiredFilter] = (0, import_react15.useState)("");
 		  const [rooms, setRooms] = (0, import_react15.useState)([]);
 		  const [wingCatalog, setHallCatalog] = (0, import_react15.useState)(null);
@@ -3356,6 +3357,7 @@ var __defProp = Object.defineProperty;
 		      if (r && r.ok) {
 		        setRooms(r.value.rooms ?? []);
 		        setOrphanCount(r.value.orphanCount ?? 0);
+		        setRoomRegistry(r.value.registry ?? []);
 		      }
 		    }).catch(() => {
 		    });
@@ -3562,6 +3564,35 @@ var __defProp = Object.defineProperty;
 		            ]
 		          }
 		        ),
+		        rooms.length > 0 || orphanCount > 0 ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		          "button",
+		          {
+		            type: "button",
+		            title: "导出分类数据 CSV(Room 词表+计数)",
+		            onClick: () => {
+		              rpc("dsh-memory/rooms-export", { kind: "rooms" }).then((r) => {
+		                if (!r || !r.ok || !r.value?.csv) return;
+		                const blob = new Blob([r.value.csv], { type: "text/csv;charset=utf-8" });
+		                const url = URL.createObjectURL(blob);
+		                const a = document.createElement("a");
+		                a.href = url;
+		                a.download = "dsh-memory-rooms.csv";
+		                a.click();
+		                URL.revokeObjectURL(url);
+		              }).catch(() => void 0);
+		            },
+		            style: {
+		              cursor: "pointer",
+		              fontSize: 12,
+		              padding: "2px 8px",
+		              borderRadius: 6,
+		              border: "1px solid var(--dsh-mem-border)",
+		              background: "transparent",
+		              color: "var(--dsh-mem-text-2)"
+		            },
+		            children: "导出 CSV"
+		          }
+		        ) : null,
 		        /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
 		          "button",
 		          {
@@ -3612,7 +3643,7 @@ var __defProp = Object.defineProperty;
 		        /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { display: "flex", flexWrap: "wrap", gap: 6, alignItems: "center", marginBottom: roomsOpen ? 6 : 0 }, children: [
 		          (roomsOpen ? rooms.slice(roomPage * ROOM_PAGE_SIZE, (roomPage + 1) * ROOM_PAGE_SIZE) : rooms.slice(0, 8)).map((r) => {
 		            const on = tagFilter === r.room && !untaggedOnly;
-		            return /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		            return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(
 		              "button",
 		              {
 		                type: "button",
@@ -3634,7 +3665,10 @@ var __defProp = Object.defineProperty;
 		                  background: on ? "var(--dsh-mem-bg-inset)" : "transparent",
 		                  color: on ? "var(--dsh-mem-accent)" : "var(--dsh-mem-text-2)"
 		                },
-		                children: r.room + " · " + r.count
+		                children: [
+		                  r.label ? r.label + " · " + r.count : r.room + " · " + r.count,
+		                  r.source === "pre-registered" ? " ⭐" : ""
+		                ]
 		              },
 		              r.room
 		            );
@@ -3677,7 +3711,54 @@ var __defProp = Object.defineProperty;
 		              children: "▶"
 		            }
 		          )
-		        ] }) : null
+		        ] }) : null,
+		        roomsOpen && /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { marginTop: 8, paddingTop: 8, borderTop: "1px solid var(--dsh-mem-border)" }, children: [
+		          /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 8, marginBottom: 6 }, children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "管理(高权限)" }),
+		            !hiPriv && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "需先开启高权限模式(见上方工具栏)" })
+		          ] }),
+		          hiPriv && /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { display: "flex", flexWrap: "wrap", gap: 6, alignItems: "center" }, children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("input", { "data-adm-slug": true, placeholder: "slug(如 dsh-plugin 或 dsh-plugin/merge)", style: { ...S.input, width: 150, fontSize: 12 } }),
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("input", { "data-adm-label": true, placeholder: "名称(可中文)", style: { ...S.input, width: 110, fontSize: 12 } }),
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("input", { "data-adm-desc": true, placeholder: "归类说明(喂标注器)", style: { ...S.input, width: 170, fontSize: 12 } }),
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		              "button",
+		              {
+		                type: "button",
+		                onClick: async () => {
+		                  const q = (sel2) => document.querySelector(sel2)?.value ?? "";
+		                  const r = await rpc("dsh-memory/room-register", { slug: q("[data-adm-slug]"), label: q("[data-adm-label]"), description: q("[data-adm-desc]") }).catch(() => null);
+		                  void r;
+		                  loadRooms();
+		                },
+		                style: { cursor: "pointer", fontSize: 12, padding: "3px 10px", borderRadius: 6, border: "1px solid var(--dsh-mem-accent)", background: "transparent", color: "var(--dsh-mem-accent)" },
+		                children: "注册"
+		              }
+		            ),
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		              "button",
+		              {
+		                type: "button",
+		                title: "导出无 Room 绑定的孤儿清单(含候选)",
+		                onClick: () => {
+		                  rpc("dsh-memory/rooms-export", { kind: "orphans" }).then((r) => {
+		                    if (!r || !r.ok || !r.value?.csv) return;
+		                    const blob = new Blob([r.value.csv], { type: "text/csv;charset=utf-8" });
+		                    const url = URL.createObjectURL(blob);
+		                    const a = document.createElement("a");
+		                    a.href = url;
+		                    a.download = "dsh-memory-room-orphans.csv";
+		                    a.click();
+		                    URL.revokeObjectURL(url);
+		                  }).catch(() => void 0);
+		                },
+		                style: { cursor: "pointer", fontSize: 12, padding: "3px 10px", borderRadius: 6, border: "1px solid var(--dsh-mem-border)", background: "transparent", color: "var(--dsh-mem-text-2)" },
+		                children: "导出孤儿"
+		              }
+		            ),
+		            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "合并/改名/退役:用 agent 工具 memory_room_admin(merge/rename/retire,dryRun 默认预览)" })
+		          ] })
+		        ] })
 		      ] }) : /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { style: S.muted, children: "Room 分类:暂无(由反刍涌现的标签自动生成,无需手工建立)" })
 		    ] }),
 		    /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { ...S.flexRow, marginBottom: 10 }, children: [

package/dist/contract.d.ts

@@ -557,12 +557,51 @@ export interface WingOverviewResponse {
  * 降级/无 tags 时 `rooms` 为空数组(面板显示"暂无"),不报错。
  */
 export interface RoomsGetResponse {
-    /** Room 列表(按记录数降序,同数按名升序)。 */
+    /** Room 列表(按记录数降序,同数按名升序;注册表条目 count=0 并带 source/label)。
+     *  条目可选字段 source/label 由端点层合并注册表后附带(客户端可选读,零断裂)。 */
     rooms: RoomCount[];
     /** Room 总数(= rooms.length,冗余只为前端少写一次 .length)。 */
     total: number;
     /** 孤儿记忆数:没有任何 Room(tags 为空/缺失)的记录条数(与 rooms 同口径含已退场)。 */
     orphanCount: number;
+    /** 注册表条目(全量含 retired;分类管理面板用;未装配 = undefined)。 */
+    registry?: Array<{
+        slug: string;
+        label?: string;
+        description?: string;
+        source: 'pre-registered' | 'grown';
+        aliases?: string[];
+        status: 'active' | 'retired';
+    }>;
+}
+/** dsh-memory/room-register(预注册 Room;高权限:面板 memoryMutate 开启才生效)。 */
+export interface RoomRegisterRequest {
+    slug: string;
+    label?: string;
+    description?: string;
+}
+export interface RoomRegisterResponse {
+    slug: string;
+    created: boolean;
+    /** 幂等补全时的提示(如「已存在,只补全缺失字段」)。 */
+    notice?: string;
+}
+/** dsh-memory/rooms-export(分类数据导出,CSV 直出)。 */
+export interface RoomsExportRequest {
+    /** rooms = 词表+计数;orphans = 无 Room 绑定的记录清单。 */
+    kind: 'rooms' | 'orphans';
+    /** orphans 上限(1..10000,默认 2000)。 */
+    limit?: number;
+}
+export interface RoomsExportResponse {
+    kind: 'rooms' | 'orphans';
+    /** CSV 文本(首行表头;
+   行尾;RFC 4180 转义)。 */
+    csv: string;
+    /** 数据行数(不含表头)。 */
+    total: number;
+    /** truncated = 达到 limit 上限,结果可能不完整。 */
+    truncated: boolean;
 }
 /** dsh-memory/wing-backfill(一键回填,后台任务;端点立即返回,进度以 wing-overview 轮询)。 */
 export interface WingBackfillResponse {
@@ -1260,6 +1299,8 @@ export interface DshMemoryRequestMap {
     'dsh-memory/longtask-compress-tail': LongTaskCompressTailRequest;
     'dsh-memory/wing-overview': Record<string, never>;
     'dsh-memory/rooms-get': Record<string, never>;
+    'dsh-memory/rooms-export': RoomsExportRequest;
+    'dsh-memory/room-register': RoomRegisterRequest;
     'dsh-memory/wing-backfill': Record<string, never>;
     'dsh-memory/session-stats': SessionStatsRequest;
     'dsh-memory/settings-get': Record<string, never>;
@@ -1307,6 +1348,8 @@ export interface DshMemoryResponseMap {
     'dsh-memory/session-mode-set': SessionModeSetResponse;
     'dsh-memory/wing-overview': WingOverviewResponse;
     'dsh-memory/rooms-get': RoomsGetResponse;
+    'dsh-memory/rooms-export': RoomsExportResponse;
+    'dsh-memory/room-register': RoomRegisterResponse;
     'dsh-memory/wing-backfill': WingBackfillResponse;
     'dsh-memory/session-stats': SessionStatsResponse;
     'dsh-memory/settings-get': SettingsGetResponse;

package/dist/index.js

@@ -39,6 +39,7 @@ import { registerSlotRecall } from './hooks/slot-recall.js';
 import { registerLongTaskMonitor } from './hooks/long-task.js';
 import { ContextUsageStore } from './store/context-usage.js';
 import { TodoRefStore } from './store/todo-ref.js';
+import { RoomRegistryStore } from './store/rooms-registry.js';
 import { registerSlotsProjection } from './projection/slots.js';
 import { errDetail, withFileLog } from './util/filelog.js';
 import { buildRouteChain, resolveModelRoute, invalidateEffortCache } from './llm.js';
@@ -364,6 +365,9 @@ export async function apply(ctx, config) {
     // todo/write 快照参考(仅长任务会话;写 pinned 槽位走 slot-recall 常驻注入)。
     const contextUsage = new ContextUsageStore(logger);
     const todoRef = new TodoRefStore();
+    // Room 注册表(分类管理 beta.4;损坏降级为纯自生长目录)
+    const roomRegistry = new RoomRegistryStore(dataDir, logger);
+    await roomRegistry.init();
     if (storageOk) {
         registerLongTaskMonitor(ctx, {
             cfg: config,
@@ -376,7 +380,7 @@ export async function apply(ctx, config) {
     }
     const recall = registerRecall(ctx, config, stores, logger, live, modes, dataDir);
     runner.setAfterRun(recall.invalidateProfile);
-    registerMemoryTools(ctx, config, stores, logger, modes, live, ruminate);
+    registerMemoryTools(ctx, config, stores, logger, modes, live, ruminate, storageOk ? roomRegistry : undefined);
     // 激活槽位(active slot):工具面 + 常驻注入 + 服务端投影(均走 ctx.effect,可撤销)
     registerSlotTools(ctx, config, stores.slots, logger, modes, live, stores.l1);
     const slotRecall = registerSlotRecall(ctx, config, stores.slots, logger, live);
@@ -395,7 +399,7 @@ export async function apply(ctx, config) {
         runnerView: (sid, mode) => runner.sessionView(sid, mode),
         l0Count: (sid) => stores.l0.countBySession(sid),
         capabilities: () => db.getCapabilities(),
-    }, ruminate, storageOk ? { runner, slots: stores.slots, contextUsage, todoRef } : undefined);
+    }, ruminate, storageOk ? { runner, slots: stores.slots, contextUsage, todoRef } : undefined, storageOk ? roomRegistry : undefined);
     // bench 控制服务(config.benchControl 门控,默认关):仅基准/调试部署注册,
     // 供同进程的 bench-runner lifecycle 赛道触发 rebuild / 设置会话档位
     // (宿主侧 RPC 无 call(),见 bench-control.ts)

package/dist/pipeline/ruminate.js

@@ -4,6 +4,7 @@ import { errDetail } from '../util/filelog.js';
 import { runSceneConsolidation } from './l2.js';
 import { relabelPass } from './relabel.js';
 import { processSceneReclusterJobs } from './recluster.js';
+import { annotateOrphanCandidates } from '../room-review.js';
 import { runPersona } from './l3.js';
 const IDLE_STATUS = {
     running: false,
@@ -233,6 +234,17 @@ export class RuminateController {
             catch (err) {
                 this.logger.warn(`[memory] 场景重聚类调度失败(忽略): ${errDetail(err)}`);
             }
+            // 孤儿候选预标记(长尾治理):无 Room 的活跃孤儿对照现有 Room 词表产出
+            // 候选(roomReview='pending'),由 agent 用 memory_room_review 逐个复查;
+            // 每轮至多 40 条,吞错不拖垮反刍。
+            try {
+                const r = await annotateOrphanCandidates(this.ctx, this.cfg, { l1: this.stores.l1, logger: this.logger }, 40);
+                if (r.written > 0)
+                    this.status.detail = `孤儿候选预标记 ${r.written} 条(待 agent 复查,工具 memory_room_review)`;
+            }
+            catch (err) {
+                this.logger.warn(`[memory] 孤儿候选预标记失败(忽略): ${errDetail(err)}`);
+            }
             this.status.phase = 'done';
             this.finish(null);
         }

package/dist/room-review.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 孤儿记忆的 Room 候选预标记 + agent 逐个复查(长尾治理)。
+ *
+ * 背景:Room 由 metadata.tags 自生长,但 tags 只在反刍 relabel 段随 wing 补打
+ * 顺带产出(每轮 ≤40 条、且只覆盖本轮补 wing 的记录)——「有 wing 无 tags」与
+ * 「预算用尽被 deferred」的记录成为无 Room 绑定的孤儿,且标注器不参考现有
+ * Room 词表,产出碎片化新 slug(81 个 Room 大多 1 条的成因)。
+ *
+ * 两段式:
+ *  1. **预标记(annotateOrphanCandidates)**:抽取活跃孤儿,LLM 对照**现有 Room
+ *     词表**产出候选(优先挂靠现有 Room,≤2 个新 slug 兜底),写
+ *     `metadata.roomCandidates` + `roomReview:'pending'`——不动 tags、不进
+ *     Room、不进召回,只是"待确认的建议"。
+ *  2. **逐个复查(memory_room_review 工具)**:agent 取下一条待复查记录
+ *     (带候选 + 现有 Room 词表),确认后 confirm 写入 tags(进 Room,高权限
+ *     门控),或 skip 跳过。确认/跳过都是显式动作,预标记本身零行为面。
+ *
+ * 存储即 metadata 保留键(与 relabel 写 tags 同款 patchMetadata 合并纪律,
+ * 写前重读):`roomCandidates` / `roomReview:'pending'|'confirmed'|'skipped'`。
+ * 两键不在 rooms 聚合(rooms 只读 $.tags)、不在快照哈希投影关注的治理列——
+ * 与既有 metadata 键同层,无 schema 变更。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { MemoryConfig } from './config.js';
+import type { MemoryLogger, MemoryRecord } from './types.js';
+export declare const ROOM_CANDIDATES_KEY = "roomCandidates";
+export declare const ROOM_REVIEW_KEY = "roomReview";
+export type RoomReviewState = 'pending' | 'confirmed' | 'skipped';
+/** 复查与候选操作对 L1 的最小依赖面(便于测试注入)。 */
+export interface RoomReviewStore {
+    list(opts: {
+        untagged?: boolean;
+        retired?: boolean;
+        limit: number;
+        offset: number;
+    }): {
+        items: MemoryRecord[];
+        total: number;
+    };
+    getByIds(ids: readonly string[]): MemoryRecord[];
+    patchMetadata(id: string, metadata: Record<string, unknown>): boolean;
+    listRooms(): Array<{
+        room: string;
+        count: number;
+    }>;
+    /** 确认写 tags 后失效 Room 计数缓存(30s TTL)。 */
+    invalidateRooms(): void;
+}
+/** merge/rename 的 store 面(RoomReviewStore + 游标重写与备份;L1Store 已实现)。 */
+export interface RoomMergeStore extends RoomReviewStore {
+    listByTagAll(tag: string, cap?: number): MemoryRecord[];
+    backupTagRecords(tag: string): {
+        file: string;
+        count: number;
+    };
+    rewriteTag(from: string, to: string, cap?: number): {
+        rewritten: number;
+        scanned: number;
+        families: string[];
+        scenes: string[];
+        hasMore: boolean;
+    };
+}
+/** Room 注册表最小面(merge 收尾;RoomRegistryStore 已满足)。 */
+export interface RoomRegistryMerge {
+    markMerged(fromSlug: string, toSlug: string): Promise<boolean>;
+    renameSlug(oldSlug: string, newSlug: string): Promise<boolean>;
+}
+export interface RoomCandidate {
+    id: string;
+    rooms: string[];
+}
+/** 解析标注器输出的逐条候选(容错:id 配对失败丢弃;isTag 校验;目录内优先,≤3)。 */
+export declare function parseRoomCandidateItems(parsed: ReadonlyArray<{
+    id: string;
+    rooms: readonly string[];
+}>, ids: ReadonlyArray<string>, roomCatalog: ReadonlyArray<{
+    room: string;
+    count: number;
+}>): RoomCandidate[];
+/** 候选标注系统 prompt:喂现有 Room 词表(带计数),优先挂靠、少量新建兜底。 */
+export declare function roomCandidateSystemPrompt(roomCatalog: ReadonlyArray<{
+    room: string;
+    count: number;
+}>): string;
+/** 候选标注器:一批孤儿记录 → 候选 Room(优先现有词表;失败返回空,调用方零改动)。 */
+export declare function roomCandidateChunk(ctx: Context, cfg: MemoryConfig, logger: MemoryLogger, chunk: MemoryRecord[], roomCatalog: ReadonlyArray<{
+    room: string;
+    count: number;
+}>): Promise<Array<{
+    id: string;
+    rooms: string[];
+}>>;
+export interface OrphanAnnotateIO {
+    l1: RoomReviewStore;
+    logger: MemoryLogger;
+}
+/**
+ * 预标记消费器:活跃孤儿(≤limit 条)批量产候选并写 pending。
+ * 写前重读合并(与 relabel 同纪律);失败单条跳过、原记录零改动。
+ */
+export interface OrphanAnnotateOverrides {
+    /** 测试注入口:替换 LLM 候选标注器(默认走真实 callLLM 路径)。 */
+    chunkAnnotator?: (chunk: MemoryRecord[]) => Promise<Array<{
+        id: string;
+        rooms: string[];
+    }>>;
+}
+export declare function annotateOrphanCandidates(ctx: Context, cfg: MemoryConfig, io: OrphanAnnotateIO, limit?: number, overrides?: OrphanAnnotateOverrides): Promise<{
+    selected: number;
+    candidates: number;
+    written: number;
+}>;
+export interface MergeRoomResult {
+    dryRun: boolean;
+    /** 影响条数(dryRun=预览数;实跑=实际重写数)。 */
+    affected: number;
+    preview: string[];
+    applied: number;
+    hasMore: boolean;
+    backupFile?: string;
+    /** 实跑时回传:受影响的族与场景(调用方入队 recluster 'room-merge')。 */
+    families?: string[];
+    scenes?: string[];
+}
+/**
+ * Room merge/rename 编排(破坏性动作,分类管理 beta.5):
+ *  - dryRun(缺省 true):只统计 affected + 前 6 条预览,**零写入**;
+ *  - 实跑:执行前备份(matching rows → rooms-merge-backups/)→ 游标重写
+ *    (写前重读-合并-写回,其余 metadata 键保全)→ 注册表 markMerged/renameSlug
+ *    → 返回受影响 (family, scene) 供调用方入队 recluster('room-merge');
+ *  - 单飞:并发 merge 直接抛错;与 relabel/ruminate 的时间错开由调用方保证。
+ * 抛错语义:非法参数/注册表冲突直接抛(调用方转 notice)。
+ */
+export declare function mergeRoom(io: {
+    l1: RoomMergeStore;
+    registry: RoomRegistryMerge;
+    logger: MemoryLogger;
+}, from: string, to: string, opts?: {
+    dryRun?: boolean;
+    cap?: number;
+}): Promise<MergeRoomResult>;
+/** rename = merge 1:1 + 注册表改名(冲突时抛错提示走 merge)。 */
+export declare function renameRoom(io: {
+    l1: RoomMergeStore;
+    registry: RoomRegistryMerge;
+    logger: MemoryLogger;
+}, from: string, to: string, opts?: {
+    dryRun?: boolean;
+    cap?: number;
+}): Promise<MergeRoomResult>;
+/** 下一条待复查(供 agent 逐个过):记录摘要 + 候选 + 现有 Room 词表 + 剩余数。 */
+export declare function nextReview(l1: RoomReviewStore): {
+    id: string;
+    content: string;
+    type: string;
+    sceneName: string;
+    candidates: string[];
+    roomCatalog: Array<{
+        room: string;
+        count: number;
+    }>;
+    remaining: number;
+} | null;
+/** 待复查剩余数(面板/工具兜底信息)。 */
+export declare function pendingReviewCount(l1: RoomReviewStore): number;
+/**
+ * 确认复查结果:候选(或 agent 改写的)写入 metadata.tags(**进 Room**),
+ * 清候选、标 confirmed。**高权限门控由调用方执行**(与 memory_delete 同款)。
+ * 返回写入的 tags;id 不存在/状态非法返回 null。
+ */
+export declare function confirmReview(l1: RoomReviewStore, id: string, rooms: readonly string[]): {
+    tags: string[];
+} | null;
+/** 跳过:标 skipped(不再进 pending 队列)。已 confirmed 的记录不受 skip 影响(挂了 Room 的不算长尾)。 */
+export declare function skipReview(l1: RoomReviewStore, id: string): boolean;