dsh-sessions-manager 3.3.0 → 3.4.1

package/lib/index.js

@@ -1,8 +1,8 @@
 // src/index.js
-import { mkdir as mkdir2, realpath, rename as rename2, stat, unlink, writeFile as writeFile2 } from "node:fs/promises";
-import { basename, dirname, isAbsolute, join as join2 } from "node:path";
-import { readFileSync as readFileSync3 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
+import { mkdir as mkdir3, realpath, rename as rename3, stat, unlink, writeFile as writeFile3 } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join as join3 } from "node:path";
+import { readFileSync as readFileSync4 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
 
 // src/zstd-frame.js
 import zlib from "node:zlib";
@@ -250,17 +250,268 @@ function createStarIndex(options = {}) {
   return { read, write, mutate, setStarred, removeIds, indexPath, dir };
 }
 
+// src/storage-stats.js
+var UNGROUPED_KEY = "__ungrouped__";
+function isFiniteSize(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function aggregateStorage(items, options = {}) {
+  const topN = Number.isInteger(options.topN) && options.topN > 0 ? options.topN : 10;
+  const list = Array.isArray(items) ? items : [];
+  const buckets = /* @__PURE__ */ new Map();
+  const sized = [];
+  let totalBytes = 0;
+  let unknownSessions = 0;
+  let counted = 0;
+  for (const item of list) {
+    if (!item || item.sessionId == null) continue;
+    counted++;
+    const id = String(item.sessionId);
+    const path = item.workspacePath ? String(item.workspacePath) : null;
+    const key = path || UNGROUPED_KEY;
+    let bucket = buckets.get(key);
+    if (!bucket) {
+      bucket = { key, path, title: item.workspaceTitle ? String(item.workspaceTitle) : null, bytes: 0, sessions: 0 };
+      buckets.set(key, bucket);
+    }
+    bucket.sessions++;
+    if (isFiniteSize(item.sizeBytes)) {
+      bucket.bytes += item.sizeBytes;
+      totalBytes += item.sizeBytes;
+      sized.push({
+        sessionId: id,
+        title: item.title || null,
+        workspacePath: path,
+        workspaceTitle: bucket.title,
+        sizeBytes: item.sizeBytes
+      });
+    } else {
+      unknownSessions++;
+    }
+  }
+  const workspaces = [...buckets.values()].sort((a, b) => b.bytes - a.bytes || b.sessions - a.sessions || a.key.localeCompare(b.key)).map((bucket) => ({ ...bucket, share: totalBytes > 0 ? bucket.bytes / totalBytes : 0 }));
+  const top = sized.sort((a, b) => b.sizeBytes - a.sizeBytes || a.sessionId.localeCompare(b.sessionId)).slice(0, topN);
+  return {
+    totalBytes,
+    sessionCount: counted,
+    sizedSessions: sized.length,
+    unknownSessions,
+    workspaces,
+    top
+  };
+}
+
+// src/auto-archive.js
+import { mkdir as mkdir2, rename as rename2, writeFile as writeFile2 } from "node:fs/promises";
+import { readFileSync as readFileSync3 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join2 } from "node:path";
+var AUTO_ARCHIVE_SCHEMA_VERSION = 4;
+var INACTIVE_DAY_OPTIONS = Object.freeze([0, 30, 60, 90]);
+var DAY_MS = 864e5;
+var RUN_INTERVAL_MS = DAY_MS;
+var DEFAULT_DIR = join2(homedir2(), ".dsh", "sessions-manager");
+function normalizeAutoArchiveStore(raw) {
+  const source = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+  const settings = source.settings && typeof source.settings === "object" ? source.settings : {};
+  const inactiveDays = INACTIVE_DAY_OPTIONS.includes(settings.inactiveDays) ? settings.inactiveDays : 0;
+  return {
+    schemaVersion: AUTO_ARCHIVE_SCHEMA_VERSION,
+    settings: {
+      inactiveDays,
+      // Starred sessions are an explicit "keep" mark, so they are skipped
+      // unless the user opts out.
+      skipStarred: settings.skipStarred !== false
+    },
+    lastRunAt: Number.isFinite(source.lastRunAt) ? source.lastRunAt : null,
+    lastArchivedCount: Number.isInteger(source.lastArchivedCount) && source.lastArchivedCount >= 0 ? source.lastArchivedCount : 0
+  };
+}
+function pickInactiveCandidates(items, options = {}) {
+  const days = options.inactiveDays;
+  if (!INACTIVE_DAY_OPTIONS.includes(days) || days === 0) return [];
+  const now = Number.isFinite(options.now) ? options.now : Date.now();
+  const cutoff = now - days * DAY_MS;
+  const skipStarred = options.skipStarred !== false;
+  const activeId = options.activeSessionId != null ? String(options.activeSessionId) : null;
+  const list = Array.isArray(items) ? items : [];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of list) {
+    if (!item || item.sessionId == null) continue;
+    const id = String(item.sessionId);
+    if (seen.has(id)) continue;
+    if (item.archived) continue;
+    if (skipStarred && item.starred) continue;
+    if (activeId !== null && id === activeId) continue;
+    const updatedAt = Number(item.updatedAt);
+    if (!Number.isFinite(updatedAt) || updatedAt <= 0) continue;
+    if (updatedAt < cutoff) {
+      seen.add(id);
+      out.push(id);
+    }
+  }
+  return out;
+}
+function createAutoArchiveStore(options = {}) {
+  const dir = options.dir || process.env.DSH_SESSIONS_MANAGER_AUTO_ARCHIVE_DIR || DEFAULT_DIR;
+  const indexPath = options.indexPath || join2(dir, "auto-archive.json");
+  let mutation = Promise.resolve();
+  async function read() {
+    try {
+      return normalizeAutoArchiveStore(JSON.parse(readFileSync3(indexPath, "utf8")));
+    } catch {
+      return normalizeAutoArchiveStore(null);
+    }
+  }
+  async function write(store) {
+    await mkdir2(dir, { recursive: true });
+    const tmp = join2(dir, `.auto-archive-${process.pid}-${Date.now()}.tmp`);
+    await writeFile2(tmp, JSON.stringify(normalizeAutoArchiveStore(store), null, 2), { encoding: "utf8", mode: 384 });
+    await rename2(tmp, indexPath);
+  }
+  function mutate(mutator) {
+    const operation = mutation.then(async () => {
+      const store = await read();
+      const result = await mutator(store);
+      await write(store);
+      return result;
+    });
+    mutation = operation.catch(() => {
+    });
+    return operation;
+  }
+  function update(patch = {}) {
+    return mutate((store) => {
+      if (Object.prototype.hasOwnProperty.call(patch, "inactiveDays")) {
+        const days = Number(patch.inactiveDays);
+        if (!INACTIVE_DAY_OPTIONS.includes(days)) {
+          const error = new Error(`inactiveDays \u4EC5\u652F\u6301 ${INACTIVE_DAY_OPTIONS.join("\u3001")}`);
+          error.status = 400;
+          throw error;
+        }
+        store.settings.inactiveDays = days;
+      }
+      if (Object.prototype.hasOwnProperty.call(patch, "skipStarred")) {
+        store.settings.skipStarred = !!patch.skipStarred;
+      }
+      return store.settings;
+    });
+  }
+  function recordRun(count, at = Date.now()) {
+    return mutate((store) => {
+      store.lastRunAt = at;
+      store.lastArchivedCount = Number.isInteger(count) && count >= 0 ? count : 0;
+      return store;
+    });
+  }
+  function isFresh2(store, now = Date.now()) {
+    return Number.isFinite(store && store.lastRunAt) && now - store.lastRunAt < RUN_INTERVAL_MS;
+  }
+  return { read, write, mutate, update, recordRun, isFresh: isFresh2, indexPath, dir };
+}
+
+// src/session-meta-cache.js
+var DEFAULT_TTL_MS = 5 * 60 * 1e3;
+var DEFAULT_MAX = 4e3;
+function fingerprintOf(stat2) {
+  if (!stat2 || typeof stat2 !== "object") return null;
+  const mtimeMs = stat2.mtimeMs;
+  const size = stat2.size;
+  if (typeof mtimeMs !== "number" || !Number.isFinite(mtimeMs) || mtimeMs <= 0) return null;
+  if (typeof size !== "number" || !Number.isFinite(size) || size < 0) return null;
+  return `${Math.floor(mtimeMs)}:${size}`;
+}
+function isFresh(entry, stat2, now, ttlMs = DEFAULT_TTL_MS) {
+  if (!entry) return false;
+  const fp = fingerprintOf(stat2);
+  if (!fp) return false;
+  if (entry.fingerprint !== fp) return false;
+  if (typeof entry.at !== "number") return false;
+  return now - entry.at <= ttlMs;
+}
+function partitionByCache(ids, statsById, cache, now = Date.now(), ttlMs = DEFAULT_TTL_MS) {
+  const cached = /* @__PURE__ */ new Map();
+  const missing = [];
+  for (const id of ids) {
+    const entry = cache && cache.get(String(id));
+    const stat2 = statsById && statsById.get(String(id));
+    if (isFresh(entry, stat2, now, ttlMs) && entry && entry.meta) {
+      cached.set(String(id), entry.meta);
+    } else {
+      missing.push(String(id));
+    }
+  }
+  return { cached, missing };
+}
+function createSessionMetaCache(opts = {}) {
+  const ttlMs = Number.isFinite(opts.ttlMs) ? opts.ttlMs : DEFAULT_TTL_MS;
+  const max = Number.isInteger(opts.max) && opts.max > 0 ? opts.max : DEFAULT_MAX;
+  const map = /* @__PURE__ */ new Map();
+  let hits = 0;
+  let misses = 0;
+  return {
+    // 命中返回 meta，未命中/无法校验返回 null。
+    get(id, stat2) {
+      const key = String(id);
+      const entry = map.get(key);
+      if (isFresh(entry, stat2, Date.now(), ttlMs)) {
+        hits++;
+        map.delete(key);
+        map.set(key, entry);
+        return entry.meta;
+      }
+      misses++;
+      return null;
+    },
+    set(id, stat2, meta) {
+      if (!meta) return null;
+      const fp = fingerprintOf(stat2);
+      if (!fp) return null;
+      const key = String(id);
+      map.delete(key);
+      map.set(key, { fingerprint: fp, at: Date.now(), meta });
+      if (map.size > max) {
+        const oldest = map.keys().next().value;
+        if (oldest !== void 0) map.delete(oldest);
+      }
+      return meta;
+    },
+    // 批量判定：一次算出「命中缓存」与「需要解码」两组，供列表构建做批量投影。
+    partition(ids, statsById) {
+      return partitionByCache(ids, statsById, map, Date.now(), ttlMs);
+    },
+    invalidate(id) {
+      if (id == null) return false;
+      const key = String(id);
+      const had = map.has(key);
+      map.delete(key);
+      return had;
+    },
+    clear() {
+      map.clear();
+    },
+    get size() {
+      return map.size;
+    },
+    stats() {
+      return { size: map.size, hits, misses, ttlMs };
+    }
+  };
+}
+
 // src/index.js
 var name = "dsh-sessions-manager";
 var inject = ["webServer", "workspaceRegistry", "sessionPersistence", "sessionQuery", "storageDomain"];
 var MAX_TITLE = 80;
-var TRASH_DIR = process.env.DSH_SESSIONS_MANAGER_TRASH_DIR || join2(homedir2(), ".dsh", "sessions-manager-trash");
-var TRASH_INDEX = join2(TRASH_DIR, "index.json");
+var TRASH_DIR = process.env.DSH_SESSIONS_MANAGER_TRASH_DIR || join3(homedir3(), ".dsh", "sessions-manager-trash");
+var TRASH_INDEX = join3(TRASH_DIR, "index.json");
 var TRASH_SCHEMA_VERSION = 2;
 var DEFAULT_TRASH_SETTINGS = Object.freeze({ retentionDays: 0 });
 var FETCH_TOOL_RE = /search|fetch|download|browse/i;
 var MAX_FETCHES = 12;
 var MAX_FILES = 20;
+var MAX_STORAGE_TOP = 50;
 function json(res, value, status = 200) {
   res.writeHead(status, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
   res.end(JSON.stringify(value));
@@ -338,7 +589,24 @@ function apply(ctx) {
   const sq = ctx.sessionQuery;
   const dom = () => ctx.storageDomain.get("workspace");
   const authorityTitleCache = /* @__PURE__ */ new Map();
-  let authorityTitlesLoaded = false;
+  const metaCache = createSessionMetaCache();
+  function metaFromSnapshot(o) {
+    let title = null, createdAt = null, cwd = null;
+    if (o) {
+      if (o.title && o.title.title) title = String(o.title.title);
+      if (o.session) {
+        cwd = o.session.cwd || null;
+        createdAt = o.session.createdAt || null;
+      }
+    }
+    return { title, cwd, createdAt };
+  }
+  function unwrapSnapshot(result) {
+    if (!result) return null;
+    if (result.status === "fulfilled") return result.value || null;
+    if (result.status === "rejected") return null;
+    return result;
+  }
   async function archivedState() {
     const d = dom();
     if (!d) throw new Error("workspace domain is not open");
@@ -372,42 +640,84 @@ function apply(ctx) {
     return operation;
   }
   let wsByPath = {};
-  async function resolveOne(id) {
-    let title = null, createdAt = null, cwd = null;
-    try {
-      const o = await sq.readTitleSnapshot(id);
-      if (o) {
-        if (o.title && o.title.title) title = String(o.title.title);
-        if (o.session) {
-          cwd = o.session.cwd || null;
-          createdAt = o.session.createdAt || null;
-        }
+  function buildItem(key, meta, usage, exposeUsage) {
+    const cwd = meta.cwd || null;
+    const ws = cwd ? wsByPath[cwd] : void 0;
+    const title = meta.title || null;
+    const display = title ? String(title).length > MAX_TITLE ? String(title).slice(0, MAX_TITLE) + "\u2026" : String(title) : null;
+    const base = {
+      sessionId: key,
+      title: display,
+      createdAt: meta.createdAt || null,
+      workspacePath: cwd,
+      workspaceTitle: ws && ws.title ? ws.title : null,
+      workspaceGone: !!(cwd && !ws),
+      hasWorkspace: !!cwd
+    };
+    if (exposeUsage && usage) {
+      if (usage.sizeById && usage.sizeById.has(key)) base.sizeBytes = usage.sizeById.get(key);
+      if (usage.mtimeById && usage.mtimeById.has(key)) base.updatedAt = usage.mtimeById.get(key);
+    }
+    return base;
+  }
+  async function resolveOne(id, usage, opts = {}) {
+    const key = String(id);
+    const statInfo = usage ? { mtimeMs: usage.mtimeById.get(key), size: 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.preloaded !== void 0) {
+      meta = metaFromSnapshot(unwrapSnapshot(opts.preloaded));
+    } else if (typeof sq.readTitleSnapshot === "function") {
+      try {
+        meta = metaFromSnapshot(await sq.readTitleSnapshot(id));
+      } catch (e) {
       }
-    } catch (e) {
     }
-    if (!title || !cwd) {
+    if (!meta.title || !meta.cwd) {
       try {
         const r = await sp.readFrom(id, 0);
         if (r.meta) {
-          if (!cwd) cwd = r.meta.cwd || null;
-          if (!createdAt) createdAt = r.meta.createdAt || null;
+          if (!meta.cwd) meta.cwd = r.meta.cwd || null;
+          if (!meta.createdAt) meta.createdAt = r.meta.createdAt || null;
         }
-        if (!title && Array.isArray(r.events)) title = foldTitle(r.events);
+        if (!meta.title && Array.isArray(r.events)) meta.title = foldTitle(r.events);
       } catch (e2) {
       }
     }
-    const ws = cwd ? wsByPath[cwd] : void 0;
-    const workspaceGone = !!(cwd && !ws);
-    const display = title ? String(title).length > MAX_TITLE ? String(title).slice(0, MAX_TITLE) + "\u2026" : String(title) : null;
-    return {
-      sessionId: id,
-      title: display,
-      createdAt: createdAt || null,
-      workspacePath: cwd || null,
-      workspaceTitle: ws && ws.title ? ws.title : null,
-      workspaceGone: workspaceGone ? true : false,
-      hasWorkspace: !!cwd
-    };
+    metaCache.set(key, statInfo, meta);
+    return buildItem(key, meta, usage, opts.exposeUsage);
+  }
+  async function collectUsage(preloadedHeaders) {
+    const sizeById = /* @__PURE__ */ new Map();
+    const mtimeById = /* @__PURE__ */ new Map();
+    let headers = null;
+    if (Array.isArray(preloadedHeaders)) headers = preloadedHeaders;
+    else {
+      try {
+        headers = await sp.list();
+      } catch (e) {
+        headers = [];
+      }
+    }
+    if (!Array.isArray(headers)) headers = [];
+    const CHUNK = 8;
+    for (let i = 0; i < headers.length; i += CHUNK) {
+      await Promise.all(headers.slice(i, i + CHUNK).map(async (header) => {
+        const id = header && header.id != null ? String(header.id) : null;
+        if (!id) return;
+        try {
+          const loc = sp.locate(header);
+          if (!loc || typeof loc.path !== "string" || !loc.path) return;
+          const st = await stat(loc.path);
+          if (!st) return;
+          if (typeof st.size === "number") sizeById.set(id, st.size);
+          if (typeof st.mtimeMs === "number" && st.mtimeMs > 0) mtimeById.set(id, Math.floor(st.mtimeMs));
+        } catch (e) {
+        }
+      }));
+    }
+    return { sizeById, mtimeById };
   }
   async function restoreOne(sid) {
     requireSessionId(sid);
@@ -427,7 +737,7 @@ function apply(ctx) {
   }
   async function readTrashStore() {
     try {
-      return normalizeTrashStore(JSON.parse(readFileSync3(TRASH_INDEX, "utf8")));
+      return normalizeTrashStore(JSON.parse(readFileSync4(TRASH_INDEX, "utf8")));
     } catch (e) {
       return normalizeTrashStore(null);
     }
@@ -436,10 +746,10 @@ function apply(ctx) {
     return (await readTrashStore()).items;
   }
   async function writeTrashStore(store) {
-    await mkdir2(TRASH_DIR, { recursive: true });
-    const tmp = join2(TRASH_DIR, `.index-${process.pid}-${Date.now()}.tmp`);
-    await writeFile2(tmp, JSON.stringify(normalizeTrashStore(store), null, 2), { encoding: "utf8", mode: 384 });
-    await rename2(tmp, TRASH_INDEX);
+    await mkdir3(TRASH_DIR, { recursive: true });
+    const tmp = join3(TRASH_DIR, `.index-${process.pid}-${Date.now()}.tmp`);
+    await writeFile3(tmp, JSON.stringify(normalizeTrashStore(store), null, 2), { encoding: "utf8", mode: 384 });
+    await rename3(tmp, TRASH_INDEX);
   }
   function mutateTrash(mutator) {
     const operation = trashMutation.then(async () => {
@@ -453,6 +763,7 @@ function apply(ctx) {
     return operation;
   }
   const stars = createStarIndex();
+  const autoArchive = createAutoArchiveStore();
   async function gcStars(validIds) {
     try {
       const store = await stars.read();
@@ -637,8 +948,8 @@ function apply(ctx) {
   async function moveTargetWorkspace(rawPath) {
     if (typeof rawPath !== "string" || !rawPath.trim()) throw new Error("\u7F3A\u5C11\u76EE\u6807\u5DE5\u4F5C\u533A\u8DEF\u5F84");
     let p = String(rawPath).trim();
-    if (p.startsWith("~/")) p = join2(homedir2(), p.slice(2));
-    if (!isAbsolute(p)) p = join2(homedir2(), p);
+    if (p.startsWith("~/")) p = join3(homedir3(), p.slice(2));
+    if (!isAbsolute(p)) p = join3(homedir3(), p);
     let canonical = null;
     try {
       canonical = await realpath(p);
@@ -646,7 +957,7 @@ function apply(ctx) {
       canonical = null;
     }
     if (canonical === null) {
-      await mkdir2(p, { recursive: true });
+      await mkdir3(p, { recursive: true });
       canonical = await realpath(p);
     }
     return { canonical, entity: await w.create(canonical, basename(canonical) || "workspace") };
@@ -684,13 +995,13 @@ function apply(ctx) {
       if (!oldPath || !newPath || oldPath === newPath) return false;
       const backupPath = `${oldPath}.move-backup-${Date.now()}`;
       try {
-        await mkdir2(dirname(newPath), { recursive: true });
-        await rename2(oldPath, backupPath);
+        await mkdir3(dirname(newPath), { recursive: true });
+        await rename3(oldPath, backupPath);
         await rewriteFrame0Cwd(backupPath, canonical);
-        await rename2(backupPath, newPath);
+        await rename3(backupPath, newPath);
       } catch (e) {
         try {
-          await rename2(backupPath, oldPath);
+          await rename3(backupPath, oldPath);
         } catch (_) {
         }
         if (e && e.code !== "ENOENT") throw e;
@@ -736,7 +1047,7 @@ function apply(ctx) {
         const backupPath = oldPath ? `${oldPath}.move-backup-${Date.now()}` : null;
         if (backupPath) {
           try {
-            await rename2(oldPath, backupPath);
+            await rename3(oldPath, backupPath);
           } catch (e) {
             if (e && e.code !== "ENOENT") throw new Error("\u79FB\u52A8\u5931\u8D25\uFF1A\u65E0\u6CD5\u5907\u4EFD\u65E7\u7684\u4F1A\u8BDD\u65E5\u5FD7");
           }
@@ -744,7 +1055,7 @@ function apply(ctx) {
         const restore = async () => {
           if (backupPath) {
             try {
-              await rename2(backupPath, oldPath);
+              await rename3(backupPath, oldPath);
             } catch (_) {
             }
           }
@@ -838,25 +1149,38 @@ function apply(ctx) {
       return { next: null, value: { ok: true, archived: true } };
     });
   }
-  async function allSessionItems() {
-    let materialized = /* @__PURE__ */ new Set();
-    let live = ctx.get("sessions");
-    let headersOk = false;
+  async function projectTitles(ids) {
+    const out = /* @__PURE__ */ new Map();
+    if (!ids || !ids.length) return out;
+    if (typeof sq.readTitleSnapshots !== "function") return out;
     try {
-      const headers = await sp.list();
-      materialized = new Set(headers.map((h) => String(h.id)));
-      headersOk = true;
+      const results = await sq.readTitleSnapshots(ids);
+      if (!Array.isArray(results)) return out;
+      results.forEach((result, index) => {
+        const id = String(ids[index]);
+        out.set(id, unwrapSnapshot(result));
+      });
     } catch (e) {
     }
-    const ids = [];
+    return out;
+  }
+  async function allSessionItems(opts = {}) {
+    let headers = [];
+    let headersOk = false;
     try {
-      for (const header of await sp.list()) ids.push(String(header.id));
+      headers = await sp.list();
+      headersOk = Array.isArray(headers);
+      if (!headersOk) headers = [];
     } catch (e) {
+      headers = [];
     }
+    let live = ctx.get("sessions");
+    const ids = headers.map((h) => String(h.id));
     if (live) {
       try {
         live.list().forEach((s) => {
-          if (!ids.includes(String(s.id))) ids.push(String(s.id));
+          const sid = String(s.id);
+          if (!ids.includes(sid)) ids.push(sid);
         });
       } catch (e) {
       }
@@ -876,9 +1200,16 @@ function apply(ctx) {
     }
     const currentArchived = new Set((await archivedState().catch(() => ({ archivedSessionIds: [] }))).archivedSessionIds || []);
     const items = [];
+    const usage = await collectUsage(headers);
+    const statsById = new Map(visibleIds.map((id) => [id, { mtimeMs: usage.mtimeById.get(id), size: usage.sizeById.get(id) }]));
+    const { cached, missing } = metaCache.partition(visibleIds, statsById);
+    const snapshotById = await projectTitles(missing);
     const CHUNK = 6;
     for (let i = 0; i < visibleIds.length; i += CHUNK) {
-      const res2 = await Promise.all(visibleIds.slice(i, i + CHUNK).map(resolveOne));
+      const res2 = await Promise.all(visibleIds.slice(i, i + CHUNK).map((id) => resolveOne(id, usage, {
+        exposeUsage: !!(opts && opts.usage),
+        preloaded: snapshotById.has(id) ? snapshotById.get(id) : void 0
+      })));
       for (const it of res2) items.push({ ...it, archived: currentArchived.has(it.sessionId) });
     }
     let starredSet = /* @__PURE__ */ new Set();
@@ -890,37 +1221,74 @@ function apply(ctx) {
     if (headersOk) await gcStars(ids);
     return items;
   }
+  async function buildStorage(opts = {}) {
+    const items = await allSessionItems({ usage: true });
+    const raw = Number(opts && opts.topN);
+    const topN = Number.isInteger(raw) && raw > 0 ? Math.min(raw, MAX_STORAGE_TOP) : 10;
+    return aggregateStorage(items, { topN });
+  }
+  async function autoArchiveSweep(opts = {}) {
+    const store = await autoArchive.read();
+    const days = store.settings.inactiveDays;
+    if (!days) return { ok: true, skipped: "disabled", archived: 0 };
+    const now = Date.now();
+    if (!(opts && opts.force) && autoArchive.isFresh(store, now)) {
+      return { ok: true, skipped: "throttled", archived: 0, lastRunAt: store.lastRunAt, lastArchivedCount: store.lastArchivedCount };
+    }
+    const items = await allSessionItems({ usage: true });
+    const candidates = pickInactiveCandidates(items, {
+      inactiveDays: days,
+      skipStarred: store.settings.skipStarred,
+      activeSessionId: getActiveSessionId(ctx),
+      now
+    });
+    let archived = 0;
+    const failed = [];
+    for (const sid of candidates) {
+      try {
+        const result = await archiveOne(sid);
+        if (result && result.archived) archived++;
+      } catch (e) {
+        failed.push({ sessionId: sid, error: String(e && e.message || e) });
+      }
+    }
+    await autoArchive.recordRun(archived, now);
+    return { ok: true, archived, candidates: candidates.length, failed, lastRunAt: now };
+  }
   async function sidebarAuthority() {
     const ids = [];
+    let headers = [];
     try {
-      for (const header of await sp.list()) ids.push(String(header.id));
+      headers = await sp.list();
     } catch (e) {
+      headers = [];
     }
+    if (!Array.isArray(headers)) headers = [];
+    for (const header of headers) ids.push(String(header.id));
     const sessions = ctx.get("sessions");
     try {
       if (sessions) sessions.list().forEach((session) => {
-        if (!ids.includes(String(session.id))) ids.push(String(session.id));
+        const sid = String(session.id);
+        if (!ids.includes(sid)) ids.push(sid);
       });
     } catch (e) {
     }
     const store = await readTrashStore();
-    if (!authorityTitlesLoaded && ids.length && typeof sq.readTitleSnapshots === "function") {
-      const results = await sq.readTitleSnapshots(ids);
-      results.forEach((result, index) => {
-        if (result && result.status === "fulfilled" && result.value && result.value.title && typeof result.value.title.title === "string") {
-          authorityTitleCache.set(ids[index], result.value.title.title);
-        }
-      });
-      authorityTitlesLoaded = true;
-    } else if (!authorityTitlesLoaded) {
-      for (const sid of ids) {
-        try {
-          const snapshot = await sq.readTitleSnapshot(sid);
-          if (snapshot && snapshot.title && typeof snapshot.title.title === "string") authorityTitleCache.set(sid, snapshot.title.title);
-        } catch (e) {
+    if (ids.length) {
+      const usage = await collectUsage(headers);
+      const statsById = new Map(ids.map((id) => [id, { mtimeMs: usage.mtimeById.get(id), size: usage.sizeById.get(id) }]));
+      const { cached, missing } = metaCache.partition(ids, statsById);
+      const snapshotById = await projectTitles(missing);
+      for (const id of ids) {
+        let meta = cached.get(id) || null;
+        if (!meta) {
+          const snapshot = snapshotById.has(id) ? snapshotById.get(id) : typeof sq.readTitleSnapshot === "function" ? await sq.readTitleSnapshot(id).catch(() => null) : null;
+          const next = metaFromSnapshot(snapshot);
+          metaCache.set(id, statsById.get(id), next);
+          meta = next;
         }
+        if (meta && meta.title) authorityTitleCache.set(id, String(meta.title));
       }
-      authorityTitlesLoaded = true;
     }
     return {
       titles: Object.fromEntries(authorityTitleCache),
@@ -1096,7 +1464,7 @@ function apply(ctx) {
           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(resolveOne));
+            const res2 = await Promise.all(idStrs.slice(i, i + CHUNK).map((id) => resolveOne(id)));
             items.push.apply(items, res2);
           }
           json(res, { items });
@@ -1149,7 +1517,9 @@ function apply(ctx) {
           const body = await readJsonBody(req);
           const sid = body && typeof body.sessionId === "string" ? body.sessionId : null;
           if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
-          json(res, await deleteOne(sid));
+          const out = await deleteOne(sid);
+          metaCache.invalidate(sid);
+          json(res, out);
         } catch (e) {
           json(res, { ok: false, error: String(e && e.message || e) }, errorStatus(e));
         }
@@ -1167,6 +1537,7 @@ function apply(ctx) {
           for (const sid of ids) {
             try {
               results.push({ sessionId: sid, ok: true, ...await deleteOne(sid) });
+              metaCache.invalidate(sid);
             } catch (e) {
               results.push({ sessionId: sid, ok: false, error: String(e && e.message || e) });
             }
@@ -1230,7 +1601,9 @@ function apply(ctx) {
           const body = await readJsonBody(req);
           const sid = body && typeof body.sessionId === "string" ? body.sessionId : null;
           if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
-          json(res, await restoreFromTrash(sid));
+          const out = await restoreFromTrash(sid);
+          metaCache.invalidate(sid);
+          json(res, out);
         } catch (e) {
           json(res, { ok: false, error: String(e && e.message || e) }, 500);
         }
@@ -1244,7 +1617,9 @@ function apply(ctx) {
           const body = await readJsonBody(req);
           const sid = body && typeof body.sessionId === "string" ? body.sessionId : null;
           if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
-          json(res, await purgeFromTrash(sid));
+          const out = await purgeFromTrash(sid);
+          metaCache.invalidate(sid);
+          json(res, out);
         } catch (e) {
           json(res, { ok: false, error: String(e && e.message || e) }, 500);
         }
@@ -1262,6 +1637,7 @@ function apply(ctx) {
           for (const sid of ids) {
             try {
               results.push({ sessionId: sid, ok: true, ...await purgeFromTrash(sid) });
+              metaCache.invalidate(sid);
             } catch (e) {
               results.push({ sessionId: sid, ok: false, error: String(e && e.message || e) });
             }
@@ -1361,6 +1737,7 @@ function apply(ctx) {
           if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
           if (!target) return json(res, { ok: false, error: "missing targetPath" }, 400);
           const moved = await moveOne(sid, target);
+          metaCache.invalidate(sid);
           try {
             await reindexRegistry();
           } catch (e) {
@@ -1421,6 +1798,55 @@ function apply(ctx) {
         }
       }
     }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/storage",
+      handler: async (req, res) => {
+        try {
+          const body = await readJsonBody(req);
+          json(res, await buildStorage({ topN: body && body.topN }));
+        } catch (e) {
+          json(res, { error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/auto-archive/settings",
+      handler: async (req, res) => {
+        try {
+          const body = await readJsonBody(req);
+          const patch = {};
+          if (body && Object.prototype.hasOwnProperty.call(body, "inactiveDays")) patch.inactiveDays = body.inactiveDays;
+          if (body && Object.prototype.hasOwnProperty.call(body, "skipStarred")) patch.skipStarred = body.skipStarred;
+          const settings = Object.keys(patch).length ? await autoArchive.update(patch) : (await autoArchive.read()).settings;
+          const sweep = await autoArchiveSweep();
+          const store = await autoArchive.read();
+          json(res, {
+            ok: true,
+            settings,
+            lastRunAt: store.lastRunAt,
+            lastArchivedCount: store.lastArchivedCount,
+            sweep
+          });
+        } catch (e) {
+          json(res, { ok: false, error: String(e && e.message || e) }, errorStatus(e));
+        }
+      }
+    }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/auto-archive/run",
+      handler: async (req, res) => {
+        try {
+          const sweep = await autoArchiveSweep({ force: true });
+          const store = await autoArchive.read();
+          json(res, { ok: true, ...sweep, settings: store.settings, lastRunAt: store.lastRunAt, lastArchivedCount: store.lastArchivedCount });
+        } catch (e) {
+          json(res, { ok: false, error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
     return () => {
       for (const d of disposers) d();
     };