dsh-ws-recency 0.7.3 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 # dsh-ws-recency
 
-DSH 侧栏的三件事：**工作区分组按最近活跃排序**、**过期历史自动折叠**、**运行中/未读/需跟进三色标记**。单独装上就有效，不依赖其它插件。
+DSH 侧栏的五件事：**工作区分组按最近活跃排序**、**过期历史自动折叠**、**运行中/未读/需跟进三色标记**、**所有置顶会话汇总到顶部一个区**、**删除会话到可恢复的回收站**。单独装上就有效，不依赖其它插件。
 
 ## 一、分组排序
 
@@ -35,12 +35,40 @@ DSH 已经把**组内**会话按 `updatedAt` 倒序排好了（排序方式 =
 - **标记只有你手动取消才会消失**：运行中/完成未读期间它只是被更强的状态盖住显示，跑完、读完（没有新未读）之后琥珀自己回来；
 - 不受打开时长、会话是否继续对话影响——继续对话恰恰常常是还欠一次跟进的原因。
 
+## 四、全局置顶区
+
+DSH 原生的置顶只把会话顶到**它所属工作区分组的第一行**，分组本身仍在原位；一旦分组排在列表下面，置顶了也看不见。
+
+本插件在**所有工作区分组之上**加一个「置顶」区，把宿主自己的置顶会话（`workspaces.pinnedSessionIds`）集中列出来：
+
+- 用的是**宿主原生置顶集合**，不是第二套置顶：会话「…」菜单里的置顶/取消置顶照旧；
+- 置顶区每行显示标题 + 所属工作区名，点行直接打开；hover 出现「取消置顶」；
+- 置顶期间它在原工作区分组里的那一行**隐藏**（不重复出现），取消置顶后原行回到原位；
+- 工作区分组、组内顺序、折叠、颜色全部照旧；
+- 只在按工作区分组时出现；搜索、扁平视图、侧栏收起时自动隐藏。
+
+## 五、归档与删除
+
+**归档**用宿主原生的：「…」菜单 →「归档会话」；看归档的内容用侧栏「视图选项」→ 显示已归档 / 仅显示已归档。本插件不改这套。
+
+**删除**是宿主没有的，本插件补上（「…」菜单 →「删除会话（移入回收站）」）：
+
+1. 先停掉它正在跑的工作；
+2. 摘掉归档标记与置顶；
+3. 从每个工作区的 `sessionIds` 记账里 detach；
+4. 删掉投影缓存记录；
+5. 把日志目录移动到 `~/.hypers-work/.trash/ws-recency/<sessionId>-<时间戳>/`；
+6. 广播 `api-session/removed`，浏览器立即移除该行。
+
+**不是物理删除**：目录只是被改名搬走，恢复就是把 `.trash/ws-recency/<id>-<时间>/` 移回 `sessions/<project>/<id>/`。这条删除走的是宿主侧路由（`POST /ws-recency/session-trash`，仅接受回环来源），因为浏览器侧碰不到文件系统。
+
 ## 设置
 
 **设置 → 通用**：
 
 - **历史折叠天数**：`−` / 数字输入 / `+`（1–90，默认 3），以及“选中 / 运行中 / 等待处理的会话不折叠”；
-- **颜色与跟进标记**：颜色标记总开关。
+- **颜色与跟进标记**：颜色标记总开关；
+- **全局置顶区**：显示开关。
 
 偏好持久化在 Client store 的 `dsh.ws-recency.prefs.v1`。
 
@@ -69,7 +97,7 @@ dsh plugin --profile <profile> add github:chyxhtc/dsh-ws-recency
 或固定版本的预构建包：
 
 ```powershell
-dsh plugin --profile <profile> add https://github.com/chyxhtc/dsh-ws-recency/releases/download/v0.7.3/dsh-ws-recency-0.7.3.tgz
+dsh plugin --profile <profile> add https://github.com/chyxhtc/dsh-ws-recency/releases/download/v0.9.0/dsh-ws-recency-0.9.0.tgz
 ```
 
 装完把 `dsh-ws-recency` 加进 `~/.hypers-work/profiles/<profile>/package.json` 的 `dsh.profile.bundles`，重启应用。

package/client.js

@@ -59,6 +59,8 @@
         var FOLD_ATTR = "data-wsr-fold";
         var STATE_ATTR = "data-wsr-state";
         var DOT_TOKEN = "wsr-dot";
+        var PIN_ATTR = "data-wsr-pin";
+        var PIN_HIDDEN_ATTR = "data-wsr-pin-hidden";
         var BUSY_RANK_ATTR = "data-busy-rank";
         var CSS_ID = "dsh-ws-recency/css";
         var MENU_ORDER = 460;
@@ -69,7 +71,7 @@
         var DEFAULT_DAYS = 3;
         var TICK_MS = 5 * 60 * 1000;
 
-        var data = { sessions: null, workspaces: null, settings: null, statuses: null, actions: null, t: null };
+        var data = { sessions: null, workspaces: null, settings: null, statuses: null, actions: null, service: null, t: null };
         var timer = null;
         var ticker = null;
         var observer = null;
@@ -79,6 +81,8 @@
         var labelled = new Set();
         var toggles = new Set();
         var dots = new Set();
+        var pinHidden = new Set();
+        var pinHost = null;
         var expandedSections = new Set();
         var clickMarked = new WeakSet();
         var headerMarked = new WeakSet();
@@ -88,6 +92,16 @@
           "[" + ROOT_ATTR + '="true"]{display:flex;flex-direction:column}',
           "[" + ROOT_ATTR + '="true"]>*{flex:0 0 auto}',
           "[" + HIDDEN_ATTR + '="true"]{display:none !important}',
+          "[" + PIN_HIDDEN_ATTR + '="true"]{display:none !important}',
+          ".wsr-pin{display:flex;flex-direction:column;flex:0 0 auto;padding:2px 0 6px;margin-bottom:4px;border-bottom:.5px solid var(--dsw-alias-border-l2)}",
+          ".wsr-pin-head{font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary);padding:4px 12px 2px}",
+          ".wsr-pin-row{display:flex;align-items:center;gap:8px;height:30px;padding:0 12px;border-radius:6px;cursor:pointer}",
+          ".wsr-pin-row:hover{background:var(--dsw-alias-bg-layer-2)}",
+          ".wsr-pin-title{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px;color:var(--dsw-alias-label-primary)}",
+          ".wsr-pin-ws{flex:none;max-width:40%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:11px;color:var(--dsw-alias-label-tertiary)}",
+          ".wsr-pin-unpin{flex:none;border:none;background:transparent;color:var(--dsw-alias-label-tertiary);cursor:pointer;font-size:11px;padding:2px 4px;border-radius:4px;visibility:hidden}",
+          ".wsr-pin-row:hover .wsr-pin-unpin{visibility:visible}",
+          ".wsr-pin-unpin:hover{color:var(--dsw-alias-label-primary)}",
           ".wsr-toggle{width:100%;height:28px;padding:0 12px 0 calc(28px + var(--dsh-workspace-indent,0px));cursor:pointer;text-align:left;color:var(--dsw-alias-label-tertiary);background:0 0;border:none;font-size:12px}",
           ".wsr-toggle:hover{color:var(--dsw-alias-label-secondary)}",
           '[' + STATE_ATTR + '="running"] [class*="_title"]{color:#4f8ef7}',
@@ -114,8 +128,16 @@
           "color.title": "\u989c\u8272\u4e0e\u8ddf\u8fdb\u6807\u8bb0",
           "color.description": "\u8fd0\u884c\u4e2d=\u84dd\uff0c\u5b8c\u6210\u672a\u8bfb=\u7eff\uff0c\u624b\u52a8\u6807\u8bb0\u9700\u8981\u8ddf\u8fdb=\u7425\u73c0\u3002\u5728\u4f1a\u8bdd\u300c\u2026\u300d\u83dc\u5355\u91cc\u6807\u8bb0 / \u53d6\u6d88\u3002",
           "color.enabled": "\u542f\u7528\u989c\u8272\u6807\u8bb0",
+          "pin.title": "\u5168\u5c40\u7f6e\u9876\u533a",
+          "pin.description": "\u5728\u6240\u6709\u5de5\u4f5c\u533a\u4e4b\u4e0a\u5355\u72ec\u5217\u51fa\u7f6e\u9876\u4f1a\u8bdd\uff1b\u53d6\u6d88\u7f6e\u9876\u540e\u56de\u5230\u5b83\u539f\u6765\u7684\u5de5\u4f5c\u533a\u4f4d\u7f6e\u3002",
+          "pin.enabled": "\u663e\u793a\u7f6e\u9876\u533a",
+          "pin.head": "\u7f6e\u9876",
+          "pin.unpin": "\u53d6\u6d88\u7f6e\u9876",
           "menu.flag": "\u6807\u8bb0\u9700\u8981\u8ddf\u8fdb",
           "menu.unflag": "\u53d6\u6d88\u8ddf\u8fdb\u6807\u8bb0",
+          "menu.trash": "\u5220\u9664\u4f1a\u8bdd\uff08\u79fb\u5165\u56de\u6536\u7ad9\uff09",
+          "trash.confirm": "\u5220\u9664\u8fd9\u4e2a\u4f1a\u8bdd\uff1f\n\n\u4f1a\u5148\u505c\u6b62\u5b83\u6b63\u5728\u8fdb\u884c\u7684\u5de5\u4f5c\uff0c\u518d\u628a\u65e5\u5fd7\u76ee\u5f55\u79fb\u5165\u56de\u6536\u7ad9\uff08\u4e0d\u662f\u7269\u7406\u5220\u9664\uff0c\u53ef\u4ee5\u624b\u52a8\u6062\u590d\uff09\u3002",
+          "trash.failed": "\u5220\u9664\u5931\u8d25\uff1a",
         };
         var EN = {
           "settings.title": "Fold history after (days)",
@@ -126,8 +148,16 @@
           "color.title": "Colors and follow-up marks",
           "color.description": "Running = blue, finished-unopened = green, a session you marked as needing follow-up = amber. Mark it from the session's \"...\" menu.",
           "color.enabled": "Enable color marks",
+          "pin.title": "Global pinned section",
+          "pin.description": "Lists pinned sessions in one section above every workspace; unpinning sends a session back to its own group.",
+          "pin.enabled": "Show the pinned section",
+          "pin.head": "Pinned",
+          "pin.unpin": "Unpin",
           "menu.flag": "Mark as needs follow-up",
           "menu.unflag": "Clear follow-up mark",
+          "menu.trash": "Delete session (move to trash)",
+          "trash.confirm": "Delete this session?\n\nIt stops whatever the session is running, then moves the log directory into the trash folder (a move, not an erase: you can restore it by hand).",
+          "trash.failed": "Delete failed: ",
         };
 
         var FALLBACK = { "fold.show": "Show history ({n})", "fold.hide": "Hide history" };
@@ -168,6 +198,7 @@
             foldDays: Math.min(MAX_DAYS, Math.max(MIN_DAYS, Math.round(days))),
             keepActive: settings.keepActive !== false,
             colors: settings.colors !== false,
+            pinnedSection: settings.pinnedSection !== false,
             followUps: settings.followUps !== null && typeof settings.followUps === "object" ? settings.followUps : {},
           };
         }
@@ -489,6 +520,157 @@
           }
         }
 
+        function baseName(path) {
+          if (typeof path !== "string" || path === "") return "";
+          var parts = path.replace(/[\\/]+$/, "").split(/[\\/]/);
+          return parts.length === 0 ? path : parts[parts.length - 1];
+        }
+
+        /** sessionId -> owning workspace label, for the trailing tag in the pinned rows. */
+        function workspaceLabels(workspaces) {
+          var map = {};
+          var items = (workspaces !== null && workspaces !== undefined && workspaces.items) || [];
+          for (var i = 0; i < items.length; i += 1) {
+            var item = items[i];
+            var label = (item.title && String(item.title)) || baseName(item.path);
+            var ids = item.sessionIds || [];
+            for (var j = 0; j < ids.length; j += 1) if (map[ids[j]] === undefined) map[ids[j]] = label;
+          }
+          return map;
+        }
+
+        /**
+         * The sessions the host itself has pinned, newest first.
+         *
+         * The pins are the host's own set (`workspaces.pinnedSessionIds`), so this is
+         * not a second pinning system: pin / unpin from the normal "..." menu and the
+         * section follows.
+         */
+        function pinnedItemsOf(sessions, workspaces, settings) {
+          if (!settings.pinnedSection) return [];
+          var ids = (workspaces !== null && workspaces !== undefined && workspaces.pinnedSessionIds) || [];
+          if (ids.length === 0) return [];
+          var byId = sessions.byId || {};
+          var archived = new Set((workspaces && workspaces.archivedSessionIds) || []);
+          var labels = workspaceLabels(workspaces);
+          var out = [];
+          for (var i = 0; i < ids.length; i += 1) {
+            var session = byId[ids[i]];
+            if (session === undefined || session === null) continue;
+            if (session.origin === "subagent" || session.blank === true) continue;
+            if (archived.has(ids[i])) continue;
+            var title = (session.title || "").trim();
+            out.push({
+              id: ids[i],
+              title: title === "" ? ids[i].slice(0, 8) : title,
+              where: labels[ids[i]] || "",
+              updatedAt: typeof session.updatedAt === "number" ? session.updatedAt : 0,
+            });
+          }
+          out.sort(function (a, b) { return b.updatedAt - a.updatedAt; });
+          return out;
+        }
+
+        function pinnedRowElement(item) {
+          var row = document.createElement("div");
+          row.className = "wsr-pin-row";
+          row.setAttribute("data-row-key", "pin:" + item.id);
+          var title = document.createElement("span");
+          title.className = "wsr-pin-title";
+          title.textContent = item.title;
+          title.setAttribute("title", item.title);
+          row.appendChild(title);
+          if (item.where !== "") {
+            var where = document.createElement("span");
+            where.className = "wsr-pin-ws";
+            where.textContent = item.where;
+            row.appendChild(where);
+          }
+          var unpin = document.createElement("button");
+          unpin.type = "button";
+          unpin.className = "wsr-pin-unpin";
+          unpin.textContent = t("pin.unpin");
+          unpin.addEventListener("click", function (event) {
+            if (event !== undefined && typeof event.stopPropagation === "function") event.stopPropagation();
+            if (data.service !== null && typeof data.service.unpinSession === "function") data.service.unpinSession(item.id);
+            schedule();
+          });
+          row.appendChild(unpin);
+          row.addEventListener("click", function () {
+            if (data.service !== null && typeof data.service.openSession === "function") data.service.openSession(item.id);
+          });
+          return row;
+        }
+
+        /** Hide the copies inside their own groups so nothing is listed twice. */
+        function hideOriginalRows(entries, pinnedIds) {
+          for (var i = 0; i < entries.length; i += 1) {
+            var rows = rowElements(entries[i].section);
+            for (var j = 0; j < rows.length; j += 1) {
+              var id = sessionIdOf(rows[j]);
+              if (id !== null && pinnedIds.has(id)) {
+                if (rows[j].getAttribute(PIN_HIDDEN_ATTR) !== "true") rows[j].setAttribute(PIN_HIDDEN_ATTR, "true");
+                pinHidden.add(rows[j]);
+              } else if (rows[j].getAttribute(PIN_HIDDEN_ATTR) !== null) {
+                rows[j].removeAttribute(PIN_HIDDEN_ATTR);
+                pinHidden.delete(rows[j]);
+              }
+            }
+          }
+        }
+
+        /**
+         * Render the "pinned" section above every workspace group.
+         *
+         * It is a plain element inserted as the first child of the list container
+         * (flex order -1), rebuilt only when the pinned set or its labels change. The
+         * host keeps owning the list; the workspace grouping below is untouched.
+         */
+        function renderPinned(entries, sessions, workspaces, settings) {
+          if (typeof document === "undefined") return;
+          var items = pinnedItemsOf(sessions, workspaces, settings);
+
+          if (items.length === 0) {
+            if (pinHost !== null) {
+              pinHost.remove();
+              pinHost = null;
+            }
+            hideOriginalRows(entries, new Set());
+            return;
+          }
+          if (entries.length === 0) return;
+          var container = entries[0].section.parentElement;
+          if (container === null) return;
+
+          if (pinHost === null || pinHost.parentElement !== container) {
+            var existing = container.querySelector("[" + PIN_ATTR + '="true"]');
+            if (existing !== null) existing.remove();
+            pinHost = document.createElement("div");
+            pinHost.className = "wsr-pin";
+            pinHost.setAttribute(PIN_ATTR, "true");
+            pinHost.style.order = "-1";
+            if (typeof container.insertBefore === "function" && container.firstChild !== undefined && container.firstChild !== null) {
+              container.insertBefore(pinHost, container.firstChild);
+            } else {
+              container.appendChild(pinHost);
+            }
+          }
+          pinHost.style.order = "-1";
+
+          var signature = items.map(function (item) { return item.id + "\u0000" + item.title + "\u0000" + item.where; }).join("\u0001");
+          if (pinHost.dataset.wsrSignature !== signature) {
+            pinHost.dataset.wsrSignature = signature;
+            while (pinHost.firstChild !== undefined && pinHost.firstChild !== null) pinHost.removeChild(pinHost.firstChild);
+            var head = document.createElement("div");
+            head.className = "wsr-pin-head";
+            head.textContent = t("pin.head");
+            pinHost.appendChild(head);
+            for (var i = 0; i < items.length; i += 1) pinHost.appendChild(pinnedRowElement(items[i]));
+          }
+          var pinnedIds = new Set(items.map(function (item) { return item.id; }));
+          hideOriginalRows(entries, pinnedIds);
+        }
+
         function statusOf(statuses, id) {
           if (statuses === null || statuses === undefined) return null;
           if (typeof statuses.get === "function") return statuses.get(id) || null;
@@ -560,6 +742,7 @@
 
           orderGroups(entries, latestByWorkspace(sessions, workspaces));
           foldRows(entries, settings, sessions, Date.now());
+          renderPinned(entries, sessions, workspaces, settings);
           if (settings.colors) decorateRows(entries, sessions, data.statuses, settings);
         }
 
@@ -633,6 +816,42 @@
           });
         }
 
+        /**
+         * Session "..." menu row: move the session into the trash folder.
+         *
+         * DSH itself only archives; the host half of this plugin stops the work,
+         * detaches the bookkeeping and renames the log directory into
+         * `<home>/.trash/ws-recency/`. The browser half only asks for confirmation
+         * and posts the id.
+         */
+        function TrashMenuItem(props) {
+          var Item = ui.MenuItemButton;
+          if (typeof Item !== "function") return null;
+          var Icon = ui.IconTrashOutlineRegular;
+          return h(Item, {
+            icon: typeof Icon === "function" ? h(Icon, {}) : undefined,
+            onSelect: function () {
+              var question = t("trash.confirm");
+              var confirmed = typeof window.confirm === "function" ? window.confirm(question) : false;
+              if (!confirmed) return;
+              fetch("/ws-recency/session-trash", {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ sessionId: props.sessionId }),
+              })
+                .then(function (response) { return response.json(); })
+                .then(function (result) {
+                  if (result !== null && result.ok !== true && typeof window.alert === "function") {
+                    window.alert(t("trash.failed") + (result.error || "unknown"));
+                  }
+                })
+                .catch(function (error) {
+                  if (typeof window.alert === "function") window.alert(t("trash.failed") + (error && error.message ? error.message : error));
+                });
+            },
+          }, props.t("menu.trash"));
+        }
+
         /** Settings -> General row: how old a session must be before it is folded. */
         function SettingsRow(props) {
           var settings = props.useStore(function (state) { return state; });
@@ -700,6 +919,28 @@
           );
         }
 
+        /** Settings -> General row: the global pinned section on/off. */
+        function PinSectionRow(props) {
+          var settings = props.useStore(function (state) { return state; });
+          var enabled = settings.pinnedSection !== false;
+          var text = props.t("pin.title");
+          return h("div", { className: "wsr-setRow" },
+            h("div", { className: "wsr-setText" },
+              h("div", { className: "wsr-setTitle" }, text),
+              h("div", { className: "wsr-setDesc" }, props.t("pin.description")),
+            ),
+            h("div", { className: "wsr-controls" },
+              h("label", { className: "wsr-exempt" },
+                h("input", {
+                  type: "checkbox",
+                  checked: enabled,
+                  onChange: function (event) { props.actions.setPinnedSection(event.target.checked); },
+                }),
+                props.t("pin.enabled")),
+            ),
+          );
+        }
+
         function shutdown() {
           disposed = true;
           if (timer !== null) window.clearTimeout(timer);
@@ -723,6 +964,12 @@
           toggles.clear();
           dots.forEach(function (dot) { dot.remove(); });
           dots.clear();
+          pinHidden.forEach(function (element) {
+            if (element.removeAttribute !== undefined) element.removeAttribute(PIN_HIDDEN_ATTR);
+          });
+          pinHidden.clear();
+          if (pinHost !== null && pinHost.parentElement !== null) pinHost.remove();
+          pinHost = null;
           roots.forEach(function (root) { root.removeAttribute(ROOT_ATTR); });
           roots.clear();
           var marked = document.querySelectorAll("[" + STATE_ATTR + "]");
@@ -736,15 +983,17 @@
 
         function apply_(ctx) {
           installCss();
+          try { data.service = ctx.get("uiWorkspace") || null; } catch (error) { data.service = null; }
           var prefs = clientStore.defineStore({
             init: function () {
-              return { enabled: true, foldDays: DEFAULT_DAYS, keepActive: true, colors: true, followUps: {} };
+              return { enabled: true, foldDays: DEFAULT_DAYS, keepActive: true, colors: true, pinnedSection: true, followUps: {} };
             },
             persist: "dsh.ws-recency.prefs.v1",
             actions: {
               setEnabled: function (draft, value) { draft.enabled = value === true; },
               setKeepActive: function (draft, value) { draft.keepActive = value === true; },
               setColors: function (draft, value) { draft.colors = value === true; },
+              setPinnedSection: function (draft, value) { draft.pinnedSection = value === true; },
               setFoldDays: function (draft, value) {
                 var next = Number(value);
                 if (!Number.isFinite(next)) return;
@@ -807,6 +1056,16 @@
             }, ColorsRow);
           });
 
+          ctx.slots.inject("settings.general.item", function () {
+            return ctx.slots.register({
+              name: "settings.general.item",
+              id: "ws-recency-pins",
+              order: 47,
+              store: prefs,
+              locale: NS,
+            }, PinSectionRow);
+          });
+
           ctx.slots.inject("sidebar.workspaces.session.menu.item", function () {
             return ctx.slots.register({
               name: "sidebar.workspaces.session.menu.item",
@@ -827,6 +1086,16 @@
             }, FollowUpDot);
           });
 
+          ctx.slots.inject("sidebar.workspaces.session.menu.item", function () {
+            return ctx.slots.register({
+              name: "sidebar.workspaces.session.menu.item",
+              id: "ws-recency-trash",
+              order: 700,
+              store: prefs,
+              locale: NS,
+            }, TrashMenuItem);
+          });
+
           ctx.effect(function () {
             return function () { shutdown(); };
           }, "dsh-ws-recency: list observer");

package/index.js

@@ -1,14 +1,226 @@
 /**
- * Host half of dsh-ws-recency.
+ * Host half of dsh-ws-recency: the one part that needs the file system.
  *
- * The whole feature is client-side: it reads Session and Workspace state through
- * the Client's root-standard hooks and writes a flex `order` onto the sidebar's
- * workspace groups. This row only carries the package into the plugin graph so
- * the Client registry can serve ./client.js beside it.
+ * Deleting a conversation is the only sidebar operation the Client cannot do on
+ * its own: DSH only offers "archive" (a flag in `archivedSessionIds`), while the
+ * log directory and the projection cache stay on disk forever. This module moves
+ * a session into a trash folder instead of erasing it:
+ *
+ *   1. stop whatever the session is running (`workspace/session-stop`)
+ *   2. drop the archive flag and the pin
+ *   3. detach it from every workspace that lists it
+ *   4. delete its projection-cache row
+ *   5. move `<home>/sessions/<project>/<sessionId>` to
+ *      `<home>/.trash/ws-recency/<sessionId>-<timestamp>`
+ *   6. broadcast `api-session/removed` so the browser drops the row
+ *
+ * Nothing is erased irreversibly: the log directory is renamed, so restoring is
+ * a move back. The route only answers loopback origins and only accepts POST.
+ *
+ * @module dsh-ws-recency
  */
+import { mkdir, readdir, rename } from "node:fs/promises";
+import { dirname, join } from "node:path";
+
+/** Cordis plugin name shown by the loader. */
+export const name = "ws-recency";
+
+/** Host services this module asks for; `webServer` is injected separately. */
+export const inject = ["sessionPersistence", "workspaceRegistry", "sessions"];
+
+/** Exact route the client half calls. */
+export const TRASH_SESSION_PATH = "/ws-recency/session-trash";
+
+const STOP_SETTLE_MS = 500;
+const MAX_BODY_BYTES = 16 * 1024;
+const RENAME_RETRY = 4;
+const RENAME_GAP_MS = 150;
+
+function loopbackOrigin(req) {
+  const origin = req.headers.origin;
+  if (origin === undefined) return true;
+  try {
+    const { hostname } = new URL(origin);
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]" || hostname === "::1";
+  } catch {
+    return false;
+  }
+}
+
+async function readJsonBody(req) {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of req) {
+    size += chunk.length;
+    if (size > MAX_BODY_BYTES) throw new Error("request body too large");
+    chunks.push(chunk);
+  }
+  if (chunks.length === 0) return {};
+  return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+}
+
+function sendJson(res, status, value) {
+  const body = JSON.stringify(value);
+  res.writeHead(status, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+  res.end(body);
+}
+
+async function dshHome() {
+  try {
+    const module = await import("@deepseek-ai/dsh-home-paths");
+    if (typeof module.resolveDshHome === "function") return module.resolveDshHome();
+  } catch {
+    /* fall through to the environment */
+  }
+  const fromEnv = process.env.DSH_HOME;
+  if (typeof fromEnv === "string" && fromEnv !== "") return fromEnv;
+  return join(process.env.USERPROFILE ?? process.env.HOME ?? ".", ".dsh");
+}
+
+/** Absolute path of a session's log file, or undefined when it cannot be located. */
+function locateLog(ctx, meta) {
+  const persistence = ctx.sessionPersistence;
+  if (persistence !== undefined && typeof persistence.locate === "function") {
+    try {
+      const located = persistence.locate(meta);
+      if (located !== undefined && located !== null && typeof located.path === "string" && located.path !== "") return located.path;
+    } catch {
+      /* fall back to the scan below */
+    }
+  }
+  return undefined;
+}
+
+/** Rename with a short retry: Windows can hold a handle for a moment. */
+async function moveWithRetry(source, target) {
+  for (let attempt = 0; attempt < RENAME_RETRY; attempt += 1) {
+    try {
+      await rename(source, target);
+      return true;
+    } catch (error) {
+      if (attempt === RENAME_RETRY - 1) throw error;
+      await new Promise((resolve) => setTimeout(resolve, RENAME_GAP_MS));
+    }
+  }
+  return false;
+}
+
+/** Move the session log directory into the trash; returns the new path. */
+async function trashSessionLog(ctx, meta, trashRoot) {
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const target = join(trashRoot, `${meta.id}-${stamp}`);
+  await mkdir(trashRoot, { recursive: true });
+
+  const located = locateLog(ctx, meta);
+  if (located !== undefined) {
+    if (await moveWithRetry(dirname(located), target)) return target;
+  }
+
+  /* No `locate()` (older host): scan `<home>/sessions/<project>/<sessionId>`. */
+  const home = await dshHome();
+  const root = join(home, "sessions");
+  let projects;
+  try {
+    projects = await readdir(root, { withFileTypes: true });
+  } catch {
+    return undefined;
+  }
+  for (const project of projects) {
+    if (!project.isDirectory()) continue;
+    try {
+      if (await moveWithRetry(join(root, project.name, meta.id), target)) return target;
+    } catch {
+      /* not in this project directory */
+    }
+  }
+  return undefined;
+}
+
+/** Stop the session, drop its bookkeeping, trash its logs, tell the browser. */
+export async function trashSession(ctx, sessionId) {
+  const live = typeof ctx.sessions?.get === "function" ? ctx.sessions.get(sessionId) : undefined;
+  let meta;
+  if (live !== undefined) {
+    meta = live.header;
+  } else {
+    const stat = await ctx.sessionPersistence.stat(sessionId);
+    if (stat === undefined) return { ok: false, error: "session not found" };
+    meta = stat.header;
+  }
+
+  try {
+    await ctx.parallel("workspace/session-stop", { sessionId });
+  } catch {
+    /* stopping is best effort, exactly like "stop and archive" */
+  }
+  await new Promise((resolve) => setTimeout(resolve, STOP_SETTLE_MS));
+
+  try { await ctx.workspaceRegistry.unarchiveSession(sessionId); } catch { /* not archived */ }
+  try { await ctx.workspaceRegistry.unpinSession(sessionId); } catch { /* not pinned */ }
+
+  for (const workspace of ctx.workspaceRegistry.list()) {
+    if (!Array.isArray(workspace.sessionIds) || !workspace.sessionIds.includes(sessionId)) continue;
+    try { await workspace.detachSession(sessionId); } catch { /* keep going */ }
+  }
+
+  try {
+    const domain = ctx.get("storageDomain");
+    const projcache = typeof domain?.get === "function" ? domain.get("session_projcache") : undefined;
+    if (projcache !== undefined) await projcache.table("sessions").delete(sessionId);
+  } catch {
+    /* the cache is derived data: a miss only costs a cold read */
+  }
+
+  const home = await dshHome();
+  const trashRoot = join(home, ".trash", "ws-recency");
+  let moved;
+  try {
+    moved = await trashSessionLog(ctx, meta, trashRoot);
+  } catch (error) {
+    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+  }
+
+  ctx.emit("api-session/removed", sessionId);
+  return { ok: true, trash: moved };
+}
 
-/** Plugin name shown by the loader. */
-export const name = 'ws-recency'
+/** POST { sessionId } -> move that session into the trash folder. */
+export async function handleTrashRequest(ctx, req, res) {
+  if ((req.method ?? "POST").toUpperCase() !== "POST") {
+    sendJson(res, 405, { ok: false, error: "method not allowed" });
+    return;
+  }
+  if (!loopbackOrigin(req)) {
+    sendJson(res, 403, { ok: false, error: "origin not trusted" });
+    return;
+  }
+  try {
+    const body = await readJsonBody(req);
+    const sessionId = body !== null && typeof body.sessionId === "string" ? body.sessionId.trim() : "";
+    if (sessionId === "") {
+      sendJson(res, 400, { ok: false, error: "sessionId required" });
+      return;
+    }
+    const result = await trashSession(ctx, sessionId);
+    sendJson(res, result.ok ? 200 : 500, result);
+  } catch (error) {
+    sendJson(res, 500, { ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+}
 
-/** Host-plane entry point; this plugin owns no Host behavior. */
-export function apply() {}
+/** Cordis entry point: mount the route when the host has a web server. */
+export function apply(ctx) {
+  try {
+    if (typeof ctx.inject === "function") {
+      ctx.inject(["webServer"], (webCtx) => {
+        webCtx.effect(() => webCtx.webServer.register({
+          kind: "exact",
+          path: TRASH_SESSION_PATH,
+          handler: (req, res) => handleTrashRequest(ctx, req, res),
+        }), "ws-recency: trash route");
+      });
+    }
+  } catch {
+    /* a headless profile simply gets no route */
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ws-recency",
-  "version": "0.7.3",
-  "description": "Sidebar session management for DeepSeek Harness: workspace groups sorted by latest activity, stale history folded, manual follow-up marks.",
+  "version": "0.9.0",
+  "description": "Sidebar session management for DeepSeek Harness: workspace groups sorted by latest activity, stale history folded, a global pinned section, follow-up marks, and session delete into a recoverable trash.",
   "license": "MIT",
   "author": "chyxhtc",
   "repository": {