dsh-sessions-manager 3.6.0 → 3.6.1

package/README.en.md

@@ -154,7 +154,7 @@ lib/index.js       pre-built host (ESM)
 lib/client.js      pre-built client (ModuleLoader CJS handshake)
 ```
 
-`lib/` is pre-built, so cloning and using it needs no esbuild. To modify the source, run `npm i -D esbuild && npm run build` to regenerate `lib/`.
+`lib/` is pre-built, so cloning and using it needs no esbuild. To modify the source, run `npm i -D esbuild && npm run build` to regenerate `lib/`; before committing, `npm run check:dist` rebuilds and diffs `lib/` against the committed bundles (CI runs the same check), so **always rebuild after a version bump** — the build stamp is reproducible as `vX.Y.Z+source-hash`, which is what makes that comparison exact.
 
 ## Host routes
 

package/README.md

@@ -154,7 +154,7 @@ lib/index.js       预构建 host（ESM）
 lib/client.js      预构建 client（ModuleLoader CJS handshake）
 ```
 
-`lib/` 已预构建，clone 下来即可直接用、无需 esbuild。若要改源码，运行 `npm i -D esbuild && npm run build` 重新生成 `lib/`。
+`lib/` 已预构建，clone 下来即可直接用、无需 esbuild。若要改源码，运行 `npm i -D esbuild && npm run build` 重新生成 `lib/`；提交前用 `npm run check:dist` 重建并与仓库产物比对（CI 跑同一道检查），**改版本号后务必一并重建**——构建指纹可复现为 `vX.Y.Z+源码哈希`，正是为了让这道比对精确可靠。
 
 ## Host 路由
 

package/lib/index.js

@@ -614,6 +614,12 @@ function fingerprintOf(stat5) {
 function isPersistableFingerprint(fingerprint) {
   return typeof fingerprint === "string" && fingerprint !== "" && !fingerprint.startsWith(REVISION_PREFIX);
 }
+function persistFingerprintOf(stat5) {
+  const fp = fingerprintOf(stat5);
+  if (fp && isPersistableFingerprint(fp)) return fp;
+  if (stat5 && Number.isFinite(stat5.sizeBytes) && stat5.sizeBytes >= 0) return `sz:${stat5.sizeBytes}`;
+  return null;
+}
 function isFresh(entry, stat5, now, ttlMs = DEFAULT_TTL_MS) {
   if (!entry) return false;
   const fp = fingerprintOf(stat5);
@@ -1408,7 +1414,7 @@ function classifyLineage(header, sizeBytes) {
 }
 
 // src/index.js
-var BUILD_STAMP = true ? "3.6.0 built 2026-09-10T09:47:49.428Z" : "dev";
+var BUILD_STAMP = true ? "3.6.1+f0814a9e" : "dev";
 var name = "dsh-sessions-manager";
 var inject = ["webServer", "workspaceRegistry", "sessionPersistence", "sessionQuery", "storageDomain"];
 var MAX_TITLE = 80;
@@ -1530,8 +1536,8 @@ function apply(ctx) {
       const stat5 = statsById.get(id);
       const entry = store && store[id];
       if (!stat5 || !entry) continue;
-      const fp = fingerprintOf(stat5);
-      if (!isPersistableFingerprint(fp)) continue;
+      const fp = persistFingerprintOf(stat5);
+      if (!fp) continue;
       if (fp && entry.fingerprint === fp) {
         hits.set(id, { title: entry.title, cwd: entry.cwd, createdAt: entry.createdAt });
       }
@@ -1543,8 +1549,8 @@ function apply(ctx) {
     const batch = {};
     const now = Date.now();
     for (const [id, meta] of decoded) {
-      const fp = fingerprintOf(statsById.get(id));
-      if (!isPersistableFingerprint(fp)) continue;
+      const fp = persistFingerprintOf(statsById.get(id));
+      if (!fp) continue;
       batch[id] = { title: meta.title, cwd: meta.cwd, createdAt: meta.createdAt, fingerprint: fp, updatedAt: now };
     }
     if (!Object.keys(batch).length) return;
@@ -1623,50 +1629,63 @@ function apply(ctx) {
     }
     return base;
   }
-  async function resolveOne(id, usage, opts = {}) {
-    const key = String(id);
-    const statInfo = usage ? (usage.statsById ? usage.statsById.get(key) : null) || { mtimeMs: usage.mtimeById && usage.mtimeById.get(key), size: usage.sizeById && usage.sizeById.get(key) } : null;
-    const cached = metaCache.get(key, statInfo);
-    if (cached) return buildItem(key, cached, usage, opts.exposeUsage);
-    let meta = { title: null, cwd: null, createdAt: null };
-    if (opts.listHeader) {
-      if (typeof opts.listHeader.cwd === "string") meta.cwd = opts.listHeader.cwd;
-      if (opts.listHeader.createdAt != null) meta.createdAt = opts.listHeader.createdAt;
-    }
-    if (opts.preloaded !== void 0) {
-      const projected = metaFromSnapshot(unwrapSnapshot(opts.preloaded));
-      if (projected.title) meta.title = projected.title;
-      if (!meta.cwd && projected.cwd) meta.cwd = projected.cwd;
-      if (!meta.createdAt && projected.createdAt) meta.createdAt = projected.createdAt;
-    } else if (typeof sq.readTitleSnapshot === "function") {
-      try {
-        const projected = metaFromSnapshot(await sq.readTitleSnapshot(id));
-        if (projected.title) meta.title = projected.title;
-        if (!meta.cwd && projected.cwd) meta.cwd = projected.cwd;
-        if (!meta.createdAt && projected.createdAt) meta.createdAt = projected.createdAt;
-      } catch (e) {
-      }
+  const EMPTY_META = { title: null, cwd: null, createdAt: null };
+  const WARM_CHUNK = 4;
+  const warmQueue = /* @__PURE__ */ new Map();
+  let warmRunning = false;
+  let warmKickTimer = null;
+  function scheduleWarm() {
+    if (warmKickTimer || warmRunning) return;
+    warmKickTimer = setTimeout(() => {
+      warmKickTimer = null;
+      runWarm();
+    }, 25);
+    if (typeof warmKickTimer.unref === "function") warmKickTimer.unref();
+  }
+  function enqueueWarm(ids, statsById, entryById) {
+    if (!ids || !ids.length) return;
+    for (const id of ids) {
+      const key = String(id);
+      const entry = entryById ? entryById.get(key) : null;
+      warmQueue.set(key, {
+        stat: statsById ? statsById.get(key) || null : null,
+        header: entry && entry.header || null
+      });
     }
-    const projectionAvailable = typeof sq.readTitleSnapshot === "function" || typeof sq.readTitleSnapshots === "function";
-    if (!meta.cwd || !meta.title && !projectionAvailable) {
-      try {
-        let foldedTitle = null;
-        const summary = await persistence.inspectSession(key, {
-          onEvents: (events) => {
-            if (!foldedTitle) foldedTitle = foldTitle(events);
+    scheduleWarm();
+  }
+  async function runWarm() {
+    if (warmRunning) return;
+    warmRunning = true;
+    try {
+      while (warmQueue.size) {
+        const batch = [...warmQueue.entries()].slice(0, WARM_CHUNK);
+        for (const [id] of batch) warmQueue.delete(id);
+        try {
+          const ids = batch.map(([id]) => id);
+          const snapshotById = await projectTitles(ids);
+          const decoded = /* @__PURE__ */ new Map();
+          const statsById = /* @__PURE__ */ new Map();
+          for (const [id, desc] of batch) {
+            const snapshot = snapshotById.has(id) ? snapshotById.get(id) : null;
+            const meta = metaFromSnapshot(snapshot);
+            if (desc.header) {
+              if (typeof desc.header.cwd === "string") meta.cwd = desc.header.cwd;
+              if (desc.header.createdAt != null) meta.createdAt = desc.header.createdAt;
+            }
+            metaCache.set(id, desc.stat, meta);
+            statsById.set(id, desc.stat);
+            if (desc.stat) decoded.set(id, meta);
           }
-        });
-        if (summary && summary.meta) {
-          if (!meta.cwd) meta.cwd = summary.meta.cwd || null;
-          if (!meta.createdAt) meta.createdAt = summary.meta.createdAt || null;
+          await persistDecoded(decoded, statsById);
+        } catch (e) {
         }
-        if (!meta.title && foldedTitle) meta.title = foldedTitle;
-      } catch (e2) {
+        await new Promise((resolve) => setImmediate(resolve));
       }
+    } finally {
+      warmRunning = false;
+      if (warmQueue.size) scheduleWarm();
     }
-    metaCache.set(key, statInfo, meta);
-    if (opts.collectDecoded && statInfo) opts.collectDecoded(key, meta);
-    return buildItem(key, meta, usage, opts.exposeUsage);
   }
   async function collectUsage(preloadedEntries) {
     const sizeById = /* @__PURE__ */ new Map();
@@ -1690,7 +1709,7 @@ function apply(ctx) {
         if (!id) return;
         if (entry && typeof entry.revision === "string" && entry.revision) {
           if (Number.isFinite(entry.sizeBytes)) sizeById.set(id, Number(entry.sizeBytes));
-          statsById.set(id, { revision: entry.revision });
+          statsById.set(id, Number.isFinite(entry.sizeBytes) ? { revision: entry.revision, sizeBytes: Number(entry.sizeBytes) } : { revision: entry.revision });
           return;
         }
         if (entry && Number.isFinite(entry.sizeBytes)) sizeById.set(id, Number(entry.sizeBytes));
@@ -2491,35 +2510,48 @@ function apply(ctx) {
       wsByPath = {};
     }
     const currentArchived = new Set((await archivedState().catch(() => ({ archivedSessionIds: [] }))).archivedSessionIds || []);
-    const items = [];
     const usage = await collectUsage(entries);
     const statsById = new Map(visibleIds.map((id) => [
       id,
       usage.statsById && usage.statsById.get(id) || { mtimeMs: usage.mtimeById.get(id), size: usage.sizeById.get(id) }
     ]));
-    const { missing } = metaCache.partition(visibleIds, statsById);
+    const { cached, missing } = metaCache.partition(visibleIds, statsById);
     const persisted = await hydrateFromPersist(missing, statsById);
-    for (const [id, meta] of persisted) metaCache.set(id, statsById.get(id), meta);
+    for (const [id, meta] of persisted) {
+      const entry = entryById.get(id);
+      const header = entry && entry.header ? entry.header : null;
+      metaCache.set(id, statsById.get(id), {
+        title: meta.title,
+        cwd: header && typeof header.cwd === "string" && header.cwd ? header.cwd : meta.cwd,
+        createdAt: header && header.createdAt != null ? header.createdAt : meta.createdAt
+      });
+    }
     const stillMissing = missing.filter((id) => !persisted.has(id));
-    const snapshotById = await projectTitles(stillMissing);
-    const decoded = /* @__PURE__ */ new Map();
-    const collectDecoded = (id, meta) => {
-      decoded.set(id, meta);
-    };
-    const CHUNK = 6;
-    for (let i = 0; i < visibleIds.length; i += CHUNK) {
-      const res2 = await Promise.all(visibleIds.slice(i, i + CHUNK).map((id) => {
+    if (stillMissing.length) enqueueWarm(stillMissing, statsById, entryById);
+    const items = [];
+    for (const id of visibleIds) {
+      let meta = metaCache.get(id, statsById.get(id)) || persisted.get(id) || null;
+      if (!meta) {
+        meta = { title: null, cwd: null, createdAt: null };
         const entry = entryById.get(id);
-        return resolveOne(id, usage, {
-          exposeUsage: !!(opts && opts.usage),
-          listHeader: entry ? entry.header : null,
-          preloaded: snapshotById.has(id) ? snapshotById.get(id) : void 0,
-          collectDecoded
-        });
-      }));
-      for (const it of res2) items.push({ ...it, archived: currentArchived.has(it.sessionId) });
+        const header = entry && entry.header ? entry.header : null;
+        if (header) {
+          if (typeof header.cwd === "string") meta.cwd = header.cwd;
+          if (header.createdAt != null) meta.createdAt = header.createdAt;
+        }
+      }
+      const it = buildItem(id, meta, usage, !!(opts && opts.usage));
+      items.push({ ...it, archived: currentArchived.has(it.sessionId) });
+    }
+    if (opts && opts.onlyArchived) {
+      const archivedItems = [];
+      for (const it of items) {
+        if (!it.archived) continue;
+        const { archived: _drop, ...rest } = it;
+        archivedItems.push(rest);
+      }
+      return { items: archivedItems, usage };
     }
-    await persistDecoded(decoded, statsById);
     let starredSet = /* @__PURE__ */ new Set();
     try {
       starredSet = new Set((await stars.read()).starredSessionIds);
@@ -2597,36 +2629,28 @@ function apply(ctx) {
     const activeTombstones = store.purgedSessionIds.map(String).filter((id) => !present.has(id));
     if (ids.length) {
       const usage = await collectUsage(entries);
+      const entryById = new Map(entries.map((entry) => [entry.id, entry]));
       const statsById = new Map(ids.map((id) => [
         id,
         usage.statsById && usage.statsById.get(id) || { mtimeMs: usage.mtimeById.get(id), size: usage.sizeById.get(id) }
       ]));
       const { cached, missing } = metaCache.partition(ids, statsById);
       const persisted = await hydrateFromPersist(missing, statsById);
-      for (const [id, meta] of persisted) metaCache.set(id, statsById.get(id), meta);
+      for (const [id, meta] of persisted) {
+        const entry = entryById.get(id);
+        const header = entry && entry.header ? entry.header : null;
+        metaCache.set(id, statsById.get(id), {
+          title: meta.title,
+          cwd: header && typeof header.cwd === "string" && header.cwd ? header.cwd : meta.cwd,
+          createdAt: header && header.createdAt != null ? header.createdAt : meta.createdAt
+        });
+      }
       const rest = missing.filter((id) => !persisted.has(id));
-      const snapshotById = await projectTitles(rest);
-      const decoded = /* @__PURE__ */ new Map();
-      const collectDecoded = (id, meta) => {
-        decoded.set(id, meta);
-      };
+      if (rest.length) enqueueWarm(rest, statsById, entryById);
       for (const id of ids) {
-        let meta = cached.get(id) || persisted.get(id) || null;
-        if (!meta) {
-          const entry = entries.find((e) => e.id === id);
-          const snapshot = snapshotById.has(id) ? snapshotById.get(id) : typeof sq.readTitleSnapshot === "function" ? await sq.readTitleSnapshot(id).catch(() => null) : null;
-          const next = metaFromSnapshot(snapshot);
-          if (entry && entry.header) {
-            if (!next.cwd && typeof entry.header.cwd === "string") next.cwd = entry.header.cwd;
-            if (!next.createdAt && entry.header.createdAt != null) next.createdAt = entry.header.createdAt;
-          }
-          metaCache.set(id, statsById.get(id), next);
-          if (statsById.get(id)) collectDecoded(id, next);
-          meta = next;
-        }
+        const meta = metaCache.get(id, statsById.get(id)) || persisted.get(id) || null;
         if (meta && meta.title) authorityTitleCache.set(id, String(meta.title));
       }
-      await persistDecoded(decoded, statsById);
     }
     const lineage = {};
     for (const entry of entries) {
@@ -2866,12 +2890,10 @@ function apply(ctx) {
           } catch (e) {
             wsByPath = {};
           }
-          const items = [];
-          const CHUNK = 6;
-          for (let i = 0; i < idStrs.length; i += CHUNK) {
-            const res2 = await Promise.all(idStrs.slice(i, i + CHUNK).map((id) => resolveOne(id)));
-            items.push.apply(items, res2);
-          }
+          const wanted = new Set(idStrs);
+          const detailed = await allSessionItemsDetailed();
+          const items = detailed.items.filter((it) => wanted.has(String(it.sessionId)) && it.archived);
+          for (const it of items) delete it.archived;
           json(res, { items });
         } catch (e) {
           json(res, { error: String(e && e.message || e) }, 500);