dsh-remote-agent 0.4.3 → 0.6.0

package/lib/protocol.js

@@ -25,6 +25,12 @@ export const HUB_TO_NODE = Object.freeze({
    * ed25519 身份签出（绑定双方公钥 + 连接 nonce）。中继只转发，无法伪造。
    */
   E2E_ACK: 'hub/e2e',
+  /**
+   * 远程文件请求（提案 #25）：hub → node 的只读文件操作（ls/read/grep/tree）。
+   * 载荷 { op, ...params }；reqId 用信封 id 本身，node 回 fs/res 时 replyTo 对上。
+   * 必须加密（E2E_REQUIRED_TYPES）：目录结构 / 文件内容都是敏感信息。
+   */
+  FS_REQ: 'fs/req',
   TASK_START: 'task/start',
   TASK_CANCEL: 'task/cancel',
   TASK_QUERY: 'task/query',
@@ -60,6 +66,11 @@ export const NODE_TO_HUB = Object.freeze({
    * 旧 hub 按未知帧忽略 → 协商不成就继续明文（混跑安全）。
    */
   E2E_OFFER: 'node/e2e',
+  /**
+   * 远程文件响应（提案 #25）：node → hub 的 fs/req 结果。载荷
+   * { replyTo, ok, result?, code?, message? }。加密发送（node→hub 默认封密）。
+   */
+  FS_RES: 'fs/res',
   PONG: 'pong',
   ERROR: 'error',
 })
@@ -137,6 +148,8 @@ export const ERROR_CODE = Object.freeze({
   ARTIFACT_MISSING: 'artifact-missing',
   ARTIFACT_TOO_LARGE: 'artifact-too-large',
   HASH_MISMATCH: 'hash-mismatch',
+  /** 远程文件请求超时（提案 #25）：node 未在时限内回 fs/res。 */
+  FS_TIMEOUT: 'fs-timeout',
   /** hub 身份验证失败：指纹不匹配 / 签名无效 / nonce 对不上 / 时间戳超窗。 */
   HUB_IDENTITY_MISMATCH: 'hub-identity-mismatch',
   /** relay 模式下 hub 身份帧尚未到达（宽限窗口内），任务暂不执行。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-agent",
-  "version": "0.4.3",
+  "version": "0.6.0",
   "type": "module",
   "description": "把另一台电脑变成你 DSH 的远程 Agent 同事：副机本地持久跑任务、独立 Agent 循环，只回传 handoff 摘要与产物清单，成品按需拉取。",
   "license": "MIT",

package/scripts/check-doc-drift.mjs

@@ -417,9 +417,24 @@ for (const [i, [file, why]] of MAINT_FILES.entries()) {
     /五分钟上手/.test(rootReadme) && /--doctor/.test(rootReadme) && /dsh-remote-setup/.test(rootReadme),
     'README.md 五分钟上手一节')
   check('37', 'package.json 声明了 dsh-remote-setup 的 bin 入口且文件存在',
-    pkg.bin?.['dsh-remote-setup'] === './bin/dsh-remote-setup.js'
-      && fs.existsSync(path.join(ROOT, 'bin', 'dsh-remote-setup.js')),
-    'package.json bin + bin/dsh-remote-setup.js')
+    // ⚠ 路径写法：**规范形态是不带 `./` 前缀**。
+    //
+    // npm 对 `bin` 里的 `./bin/x.js` 会给出警告并在发布时**自动移除前缀**：
+    //   npm warn publish "bin[dsh-remote-setup]" script name bin/dsh-remote-setup.js
+    //                      was invalid and removed
+    // 那条 warn 的措辞容易误读成"这条 bin 被删了"，实际是"前缀被修正了" ——
+    // 但它说明**写 `./` 是非规范形态**，应当避免。
+    //
+    // 这条断言原本写死 `'./bin/dsh-remote-setup.js'`，等于在保护一个
+    // npm 会改写掉的写法。现在接受规范形态（无前缀），并容忍带前缀的历史
+    // 配置 —— `npm pkg fix` 会把带前缀的改成规范形态。
+    (() => {
+      const v = pkg.bin?.['dsh-remote-setup']
+      if (typeof v !== 'string') return false
+      return v.replace(/^\.\//, '') === 'bin/dsh-remote-setup.js'
+        && fs.existsSync(path.join(ROOT, 'bin', 'dsh-remote-setup.js'))
+    })(),
+    'package.json bin（规范形态：不带 ./ 前缀）+ bin/dsh-remote-setup.js')
   check('38', '生成器替用户填好 inject: []（worker 片段必须自带）',
     /inject:\s*\[\]/.test(setupLib),
     'lib/setup.js buildWorkerYaml')

package/scripts/diag-inject.mjs

@@ -185,14 +185,14 @@ try {
 }
 
 if (applyHub) {
-  // 4a. inject 齐全 → 不抛，且 8 个工具都在
+  // 4a. inject 齐全 → 不抛，且 12 个工具都在（8 任务 + 4 文件，提案 #25）
   try {
     const ctx = fakeCtx(declared)
     applyHub(ctx, { role: 'hub', nodeToken: 'nt_diag' })
     check('inject 齐全时 applyHub 不抛', true)
     check(
-      'inject 齐全时注册 8 个 remote_* 工具',
-      ctx.registered.tools.length === 8,
+      'inject 齐全时注册 12 个 remote_* 工具',
+      ctx.registered.tools.length === 12,
       `实际 ${ctx.registered.tools.length} 个：${ctx.registered.tools.join(', ') || '(无)'}`,
     )
     check('inject 齐全时注册了路由', ctx.registered.routes.length > 0, `${ctx.registered.routes.length} 条`)