@michengai/dsh-archive-manager 1.1.12 → 1.1.13

package/lib/workspace.js

@@ -1,3 +1,5 @@
+import { confirmColdCacheWrite } from "./cache-rebuild.js";
+import { cacheIdentity, cacheRebuildInput, cacheRebuildInvocations } from "./cache-rebuild-contract.js";
 import { symbols } from "@deepseek-ai/cordis";
 import { record, errorMessage, errorCode } from "./contracts.js";
 import { discoveryInvocations, searchInputSchema, previewInputSchema, extractConversation, findContentMatch, previewConversation } from "./archive-discovery.js";
@@ -101,6 +103,8 @@ const ARCHIVE_REMOTE_METHODS = [
   "searchSessionContent",
   "previewArchivedSession",
   "diagnoseOrphanSubagents",
+  "diagnoseSessionCaches",
+  "rebuildSessionCaches",
   "cleanOrphanSubagents"
 ];
 function markRemoteMethod(instance, method) {
@@ -209,6 +213,7 @@ const orphanCleanResultSchema = {
   }
 };
 const ARCHIVE_MANAGER_INVOCATIONS = [
+  ...cacheRebuildInvocations(),
   ...favoriteInvocations(),
   ...discoveryInvocations(),
   {
@@ -583,6 +588,68 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
     return { items };
   }
   /** 只读句柄必须关闭，避免激活 Agent 或写入会话日志。 */
+  /** 普通冷会话（登记工作区、未分组及已归档）均支持重建，排除子代理、活跃及活动中会话。 */
+  async cacheRebuildEligible(header) {
+    if (header.origin !== void 0 || header.id.startsWith("im:") || this.ctx.get("sessions")?.get(header.id) !== void 0) return false;
+    const activity = await this.ctx.waterfall("workspace/session-activity", { sessionId: header.id }, () => Promise.resolve([]));
+    return activity.length === 0 && this.ctx.get("sessions")?.get(header.id) === void 0;
+  }
+  /** 检测仅读取头部与官方缓存，不读取会话正文。 */
+  usableSessionListCache(header) {
+    const snapshot = this.ctx.get("sessionProjectionCache")?.cachedSnapshot(header);
+    return snapshot !== void 0 && Object.hasOwn(snapshot.values, "title");
+  }
+  async diagnoseSessionCaches() {
+    const cache = this.ctx.get("sessionProjectionCache");
+    if (!cache) throw new Error("Official session projection cache is unavailable");
+    const items = [];
+    const headers = this.headers?.size ? Array.from(this.headers.values()) : await this.listStoredHeaders();
+    for (const header of headers) {
+      if (await this.cacheRebuildEligible(header) && !this.usableSessionListCache(header)) {
+        items.push({ sessionId: header.id, identity: cacheIdentity(header) });
+      }
+    }
+    return { count: items.length, items };
+  }
+  /** 定向读取持久化头部，优先单会话 stat 避免全量枚举，无 stat 时安全回退。 */
+  async readSessionHeaderDirect(sessionId) {
+    const persistence = this.ctx.sessionPersistence;
+    if (typeof persistence?.stat === "function") {
+      const snapshot = await persistence.stat(sessionId);
+      return snapshot?.header;
+    }
+    return (await this.listStoredHeaders()).find((h) => h.id === sessionId);
+  }
+  /** 与删除共用官方工作区队列；冷写入会同步加入官方域写入链，
+   * 回读超时也不会取消已入队的写入，因此后续删除会排在该写入之后。 */
+  async rebuildSessionCaches(input) {
+    const { items } = cacheRebuildInput.parse(input);
+    const result = { rebuiltSessionIds: [], skippedSessionIds: [], failures: [] };
+    for (const item of [...new Map(items.map((row) => [row.sessionId, row])).values()]) {
+      await this.enqueueOperation(async () => {
+        try {
+          const cache = this.ctx.get("sessionProjectionCache");
+          if (!cache) throw new Error("Official session projection cache is unavailable");
+          const header = await this.readSessionHeaderDirect(item.sessionId);
+          if (!header || cacheIdentity(header) !== item.identity || !await this.cacheRebuildEligible(header) || this.usableSessionListCache(header)) {
+            result.skippedSessionIds.push(item.sessionId);
+            return;
+          }
+          const source = await this.readStoredProjectionSource(this.ctx.sessionPersistence, item.sessionId);
+          const current = await this.readSessionHeaderDirect(item.sessionId);
+          if (!current || cacheIdentity(current) !== item.identity || cacheIdentity(source.meta) !== item.identity || !await this.cacheRebuildEligible(current)) {
+            result.skippedSessionIds.push(item.sessionId);
+            return;
+          }
+          await confirmColdCacheWrite(cache, source);
+          result.rebuiltSessionIds.push(item.sessionId);
+        } catch (error) {
+          result.failures.push({ sessionId: item.sessionId, message: (error instanceof Error ? error.message : String(error)).slice(0, 500) });
+        }
+      });
+    }
+    return result;
+  }
   async readStoredProjectionSource(persistence, sessionId) {
     const handle = await persistence.open(sessionId, "read");
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-archive-manager",
-  "version": "1.1.12",
+  "version": "1.1.13",
   "description": "归档、恢复、收藏和永久删除会话，并诊断损坏的会话日志。 · Archive, restore, favorite, and permanently delete sessions, and diagnose damaged session logs.",
   "type": "module",
   "packageManager": "pnpm@11.22.0",