远程 Shell 执行 ch1bug/dsh-shell-remote

dsh-shell-remote

基于系统 OpenSSH 的一次性远程 shell 执行：ssh <host> -- bash -c <cmd>，从 dsh-shell-host 的类型词汇表 fork 而来。设计见 ADR-0004。

状态

- R1（已完成）：仓库脚手架 + descriptor/executor 类型骨架。
- R2（本次）：ssh 传输已跑通。execute() 会拉起系统 ssh 客户端，透传退出码，在内存上限内流式接收两个输出流（溢出时保留字节精确的 TAIL，绝不落盘），并把截止时间和调用方的 abort 合并成对 ssh 客户端的一次首因 SIGKILL（杀掉客户端，远程命令会随会话一起被拆掉）。远程载荷是 cd -- '<workdir>' && eval '<command>'，按 POSIX 规则加引号，外面再套一层单引号——ssh 用裸空格拼接自己的 argv，REMOTE shell 会重新切分，所以整个载荷必须以单个远程 shell 词的形式传输。workdir 是 REMOTE 路径，在远端生效；命令经过各层引号原样重新进入。ssh 正常退出——包括传输层自己的 255，并在 stderr 上带一条说明（远程准备失败，比如主机不可达）——都按结果 resolve；只有从未产生进程的 spawn 才 reject。请求里的 stdoutMaxBytes（默认 1 MiB）同时给 stdout 和 stderr 定额；溢出时截断并保留字节精确的 TAIL——绝不写 spill 文件。D8 契约一致性测试（运行时逐字段对比 dsh-shell-host 检出里的 seam 类型）和 spill 的 loud-reject 都在这里。

契约（D8，ADR-0004 决策 4）

- ShellResult 与 @deepseek-ai/dsh-bash-local 的 ShellRunResult 字段完全一致，只有一处已记录的偏差：sandbox 类型为 never（保留，永不填充——远程执行从不做隔离；仓库不依赖 dsh-sandbox）。R2 的一致性测试锁死这一点。
- 所有路径语义都是 REMOTE 路径；executor 从不做路径映射。
- spill 类宿主能力 loud-reject（R2）；其类型表面仅作保留。

验证

pnpm install
pnpm typecheck && pnpm test