dsh-over-ssh 0.2.0 → 0.2.1

package/lib/types/src/host/domain/session/session-admin.d.ts

@@ -158,6 +158,11 @@ export interface DeleteDecision {
  *     默认不可被单独删除);
  *  5. selecting a parent **always** takes its whole descendant subtree along, ordered **children first**.
  *
+ * Rule 4 has one exception: an **orphan** sub-session — its parent is not in the inventory, or the parent is
+ * itself unreadable — can never be deleted "with its parent", because the parent does not exist to delete. Left
+ * refused, such a row is visible in the panel and permanently undeletable (审计 2026-11-05 session P2). It is
+ * therefore treated as a root: deletable on its own, and its own subtree still comes along by rule 5.
+ *
  * Rule 5 is unconditional on purpose. It used to be an opt-in `includeSubsessions` switch, and that was the
  * wrong shape: leaving a parent's children behind orphans their logs — the parent is gone, so nothing
  * navigates to them, and the platform's listing hides them by `parentId` nesting, so the bytes stay on disk

package/lib/types/src/wiring/helpers.d.ts

@@ -60,7 +60,16 @@ export declare function resolveAuth(ctx: Context, profile: ConnectionProfile): P
 export declare function resolvePasswordSecret(credentials: CredentialsLike, key: string): Promise<string | undefined>;
 /** Whether the optional `ssh2` dependency can be loaded in this installation. */
 export declare function isSsh2Available(): boolean;
-/** Expand a leading `~` to the user's home directory. */
+/**
+ * Expand a leading `~` to the user's home directory.
+ *
+ * **One implementation.** 这里原来自己写了一份，和 `host/domain/roots/ssh-config.ts` 的那份并存；两份对
+ * `~\\seg` 的处理并不同（`join` 折叠分隔符，字符串拼接不会），同一个配置在"连接凭据路径"与"ssh-config
+ * 导入"两条路上可能落到不同路径。domain 的那份是纯函数（`home` 由调用方传入），全仓只保留它。
+ *
+ * @param path - the configured path, possibly starting with `~`.
+ * @returns the absolute path, or the input unchanged when it has no leading `~`.
+ */
 export declare function expandHome(path: string): string;
 /** One configured connection. */
 export interface ConnectionEntry {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-over-ssh",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "SSH remote development for DeepSeek Harness: connections (key/password/ProxyJump/ssh config), remote files without sync, remote terminal, remote workspaces, remote @-completion, upload/download.",
   "type": "module",
   "main": "lib/index.js",