@hyzyn/dsh-tty 0.21.0 → 0.22.0-rc.2

package/scripts/windows-smoke.mjs

@@ -87,6 +87,12 @@ function openSession(port) {
 /** ConPTY 里按 Enter 是 \r（顺带补 \n 兼容两种翻译），cmd 才会执行。 */
 const ENTER = '\r\n'
 
+/**
+ * 注册进来的 agent 工具定义（W6 要**直接调 `tty_send` 的工具路径**——D74 修的就是它）。
+ * 原先 stub 的 `register` 只吞掉返回值，等于这里没有 agent 工具入口。
+ */
+const TOOLS = new Map()
+
 async function run() {
   const app = new Context()
   const wsFiber = app.plugin(WebServerRuntime, { host: '127.0.0.1', port: 0 })
@@ -97,7 +103,7 @@ async function run() {
       // DSH ≥0.1.7 的 settings 服务（SettingsForms）：describe / update / configure。
       // 本用例不测配置持久化，空 describe 即可（插件的 settings effect 拿到空值）。
       ctx.provide('settings', { describe: () => [], update: async () => {}, configure: () => () => {} })
-      ctx.provide('tools', { register: () => () => {} })
+      ctx.provide('tools', { register: (definition) => { TOOLS.set(definition.name, definition); return () => {} } })
     },
   })
   await stubFiber.await()
@@ -171,6 +177,99 @@ async function run() {
     fail('W5 kill 后可重新 spawn', error.message)
   }
   try { s2.client.close() } catch { /* 已关闭 */ }
+
+  // W6：agent 侧 `tty_send` 发**裸 LF** 也能提交命令（D74，2026-09-27 真机报告）
+  //
+  // 为什么必须在真机上钉这条：报告的第 1 条是 conhost 的**真实行为**（Enter 是 CR，
+  // 裸 LF 只把光标下移、不提交命令行）。本地单测只能在 macOS/Linux 上 mock
+  // `process.platform` 验「插件有没有归一化」，验不了「归一化之后 conhost 真的执行了」。
+  // 这里用 `%OS%` 展开做判据，理由同 W3：回显里只有 `%OS%` 字面量。
+  console.log('\n[W6] tty_send 的 \\n 归一化（真实 conhost：裸 LF 不提交命令）')
+  let agentSid = null
+  try {
+    const open = TOOLS.get('tty_open')
+    const send = TOOLS.get('tty_send')
+    const capture = TOOLS.get('tty_capture')
+    if (open === undefined || send === undefined || capture === undefined) {
+      throw new Error('agent 工具没注册进 stub（注册到的：' + [...TOOLS.keys()].join(', ') + '）')
+    }
+    const opened = await open.execute({ cwd: process.cwd(), cols: 100, rows: 30 })
+    agentSid = opened.sid
+    await send.execute({ sid: agentSid, data: 'echo IT_LF_%OS%\n' })
+    const deadline = Date.now() + 15000
+    let tail = ''
+    for (;;) {
+      tail = String((await capture.execute({ sid: agentSid, lines: 60 })).tail ?? '')
+      if (/IT_LF_Windows_NT/.test(tail)) break
+      if (Date.now() > deadline) throw new Error('15s 内没等到 %OS% 展开；尾部：' + tail.slice(-300))
+      await sleep(200)
+    }
+    pass('W6 tty_send 的裸 LF 在 ConPTY 上提交并执行了命令（D74：win32 归一化成 CRLF）')
+  } catch (error) {
+    fail('W6 tty_send 的裸 LF 提交命令（D74）', error.message)
+  }
+  if (agentSid !== null) {
+    try {
+      await TOOLS.get('tty_close').execute({ sid: agentSid })
+    } catch {
+      /* 已关闭 */
+    }
+  }
+
+  // W7：进程退出后转「只读保留」——输出还能读回来（D77，issue #4 的正题）
+  //
+  // 为什么必须在真机上钉：条目链路在真实 ConPTY 上才完整——`command` 型会话跑完，
+  // ConPTY 侧进程退出、句柄收尾、宿主把会话**留在表里**而不是摘掉；本地单测用的是
+  // 假 PTY，验不到「真机上退出之后 tty_capture 还读得到输出」。
+  console.log('\n[W7] 退出后的只读保留（D77）')
+  let retainedSid = null
+  try {
+    const open = TOOLS.get('tty_open')
+    const list = TOOLS.get('tty_list')
+    const capture = TOOLS.get('tty_capture')
+    const send = TOOLS.get('tty_send')
+    if (open === undefined || list === undefined || capture === undefined || send === undefined) {
+      throw new Error('agent 工具没注册进 stub（注册到的：' + [...TOOLS.keys()].join(', ') + '）')
+    }
+    // `command` 直接跑一条会结束的命令（正是上报现场那种用法）
+    const opened = await open.execute({ cwd: process.cwd(), command: 'echo IT_RETAIN_%OS%' })
+    retainedSid = opened.sid
+    const deadline = Date.now() + 20000
+    let entry = null
+    for (;;) {
+      entry = (await list.execute({})).sessions.find((x) => x.sid === retainedSid) ?? null
+      if (entry !== null && entry.exited === true) break
+      if (Date.now() > deadline) throw new Error('20s 内没等到 exited:true；最近一条：' + JSON.stringify(entry))
+      await sleep(200)
+    }
+    pass('W7a 命令退出后会话仍是只读保留态（exited:true）')
+    const read = await capture.execute({ sid: retainedSid, lines: 60 })
+    if (read.exited === true && /IT_RETAIN_Windows_NT/.test(String(read.tail ?? ''))) {
+      pass('W7b 退出之后 tty_capture 仍读得到退出前的输出')
+    } else {
+      fail('W7b 退出之后 tty_capture 仍读得到输出（D77）', JSON.stringify(read).slice(0, 200))
+    }
+    let refused = false
+    try {
+      await send.execute({ sid: retainedSid, data: 'echo nope\n' })
+    } catch {
+      refused = true
+    }
+    if (refused) pass('W7c 对只读保留态 tty_send 明确拒写')
+    else fail('W7c 对只读保留态 tty_send 明确拒写', '居然写进去了')
+  } catch (error) {
+    fail('W7 退出后的只读保留（D77）', error.message)
+  }
+  if (retainedSid !== null) {
+    try {
+      await TOOLS.get('tty_close').execute({ sid: retainedSid })
+      const gone = !(await TOOLS.get('tty_list').execute({})).sessions.some((x) => x.sid === retainedSid)
+      if (gone) pass('W7d tty_close 释放保留态（关掉后从清单消失）')
+      else fail('W7d tty_close 释放保留态', '仍在清单里')
+    } catch (error) {
+      fail('W7d tty_close 释放保留态', error.message)
+    }
+  }
 }
 
 await run()
@@ -178,4 +277,27 @@ const failed = RESULTS.filter((row) => row[0] === 'FAIL')
 console.log('\n==== Windows 冒烟：' + String(RESULTS.length - failed.length) + '/' + String(RESULTS.length) + ' PASS ====')
 for (const row of failed) console.error('  ✘ ' + row[1] + (row[2] ? ' — ' + row[2] : ''))
 clearTimeout(watchdog)
+/**
+ * 先把两条流排空再退（D62）。
+ *
+ * `process.exit()` 会**丢掉管道里还没 flush 的写**（Node 文档原话：尽快退出，不等
+ * 未完成的异步操作）。CI 上 stdout 正是管道，缓冲 64 KB：实测「写 300 KB 后直接
+ * exit」只活下来 65 536 字节。所以 2026-09-25 那次 CI 只留下
+ * `##[error]Process completed with exit code 1.` —— 五条断言全是 PASS、没有 ✘ 行、
+ * 也没有末尾的汇总行，失败原因整段被吞掉，只能靠拆发布记录反推"大概是哪一步"。
+ *
+ * 空串写入的回调在**前面那些写都落盘之后**才触发，等于一个 flush 屏障；拿到它再退，
+ * 输出就一定完整。仍然用 exit 而不是 `process.exitCode`（D121：主体结束后可能有
+ * 周期句柄漏着，不显式退就会挂死，而看门狗已经 clear 了）。
+ */
+await new Promise((resolve) => {
+  process.stdout.write('', () => {
+    resolve()
+  })
+})
+await new Promise((resolve) => {
+  process.stderr.write('', () => {
+    resolve()
+  })
+})
 process.exit(failed.length === 0 ? 0 : 1)