@xrn1997/dsh-session-delete 0.3.1 → 0.4.0

package/lib/types/verbs/purge-trash.d.ts

@@ -1,5 +1,6 @@
 import type { TrashEntry } from '../trash/entry.js';
-import type { CoreDeps } from '../deps.js';
+import type { RemovalDeps } from '../deps.js';
+import type { AttachmentCleanupWire } from '../shared/wire.js';
 /**
  * 彻底删除：从回收站里**真的**抹掉一条（或整组、或整站），并连带那些"还留在盘上、没被带走"的后代。
  *
@@ -12,11 +13,14 @@ import type { CoreDeps } from '../deps.js';
  * 再摘账本、最后删目录"的顺序都住 `verbs/permanent-removal.ts`——计划只读，执行器只写，计划就是
  * 执行前的闸（别在这里再长出一段手写步骤）。
  *
- * **这条动词不做回滚**：目录删掉就没有"退回去"这回事（2026-10-19 `f2a7757`：删到一半失败时已删目录不回滚；
+ * **这条动词不做回滚**：目录删掉就没有"退回去"这回事（删到一半失败时已删目录不回滚；
  * 带部分计数的 `details` 回执只属于 `orphan-clean`，purge 的 `removed` / `freedBytes` 仍只在成功回执里给）。
  * 对应地，`kind:'trash'` 的计划失败时执行器只抛那一步的 `io` 与原文、不带 details。
+ *
+ * 回执里的 `attachments` 原样来自执行器：独占图片在会话目录删完之后才清，附件失败只计数、不改
+ * `removed` / `freedBytes`（`skipped` = 有候选或剩余引用源读不出、这一轮部分或整体没清，原因上屏）。
  */
-export declare function purgeTrash(deps: CoreDeps): (
+export declare function purgeTrash(deps: RemovalDeps): (
 /** 这一组（只读）；`undefined` = 清空。批量层由 `batch-carried.ts` 的 `claimOf` 给出，直调者
  *  按 `trash/groups.ts` 的 `groupOf` 自己算；ghost 父的组只有孩子（不含 `requestedId`），照样清
  *  这一组。 */
@@ -27,4 +31,5 @@ rows: readonly TrashEntry[],
 requestedId?: string) => Promise<{
     removed: number;
     freedBytes: number;
+    attachments: AttachmentCleanupWire;
 }>;

package/lib/types/verbs/restore-session.d.ts

@@ -2,21 +2,15 @@ import { type TrashEntry } from '../trash/entry.js';
 import { type HostIdentityPort } from '../ports/host-port.js';
 import type { CoreDeps } from '../deps.js';
 /**
- * 恢复 = 把删除那次**按原路退回**，而且按组走：当年是按组一起搬进来的（父 + 它在盘上的孩子），
- * 只回父就会在回收站里留下一堆点不到的孩子行——清单只列父行，那些行既看不见也清不掉。
+ * 恢复：把删除那次按原路退回，并按组走。
  *
- * 三段与删除对称（成员循环与整组回滚的实现住 `verbs/move-group.ts`）：
- * ① **预检整组**（一个字节都不写）：每个成员的回收站目录与项目目录都得在。缺席的判据与原来一致
- *    （回收站目录不在 = `trash-empty`；原项目目录不在 = `project-missing`，且绝不静默建目录）。
- *    预检在写之前，是为了不让"父已经回到 `sessions/`、孩子因为项目目录没了而回不去"这种半组留在外面。
- *    **工作区账本不在这条硬前提里**：宿主的「删除工作区」只删注册、保留日志，记下的工作区没了就按
- *    「未分组」收（判据在 {@link attachableWorkspaceId}），照旧回盘——恢复是加法，不该因为一个可选的账目而失败。
- * ② **逐个恢复**，顺序与删除相反：文件先回来 → 挂账本 →（旧清单迁移）取消归档 → 摘清册行。
- * ③ 中途失败时 journal 把这个成员自己退回回收站；**已经恢复完的**兄弟由整组 catch 按相反顺序一起退回。
+ * 三段：
+ * 1. 预检整组（不写盘）：每个成员的回收站目录与原项目目录都必须在；工作区账本缺席不算硬失败，
+ *    恢复后归入「未分组」。预检在任何写之前，避免留下半组。
+ * 2. 逐个恢复：文件先回来 → 挂账本 →（旧条目）取消归档 → 摘清册行。
+ * 3. 中途失败由 journal 回滚当前成员；已恢复的兄弟由整组按相反顺序退回。
  *
- * **通告不在这里**：一次批量只该拉一遍宿主会话表、只发一次 `api-session/added`（2026-10-17 那次
- * "恢复很慢"就是逐条发）。通告归 `verbs/batch.ts`（ADR-0002），所以这个动词的 interface 是
- * "一个条目 id + 这一组进、回收站那一行出"，没有批量专用的开关。
+ * 通告不在本文件：批量层在批尾一次 `announceRestored(ids)`（ADR-0002）。
  */
 export declare function restoreSession(deps: CoreDeps): (entryId: string, 
 /** 这一组（只读）：批量层由 `batch-carried.ts` 的 `claimOf` 给出，直调者按 `trash/groups.ts`

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@xrn1997/dsh-session-delete",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "在 DeepSeek Harness 里删除会话：删除=移入回收站（可恢复），另设显式彻底删除",
   "type": "module",
+  "packageManager": "pnpm@11.25.0",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
   "exports": {