建议：给 subprocess-local 补上 win32 ProcessInspector（附 MIT 参考实现，实测数据齐全）

[sjh9714]

CONTRIBUTING 说暂不接受外部 PR，所以按建议把这个提到 Ideas，附一份可用的参考实现。

缺口。 subprocess-local 的 spawnTerminal 在 node-pty 之前解析平台进程探测器，而 createProcessInspector 只有 linux/darwin 分支，win32 直接抛 terminal inspection is unsupported on platform win32。于是 Windows 上持久 shell（以及依赖它的极简模式）整体不可用。架构笔记里也标了这是待补项（"The minimal preset's missing win32 PTY stack is a preset-metadata follow-up"）。

参考实现。 我们在插件层用官方注入座（terminalInspector 字段）补了一个 win32 ProcessInspector，思路如下。

• 进程树与身份。一次 CIM 快照（Get-CimInstance Win32_Process，pid/ppid/CreationDate FILETIME 作身份），children-first 排序，容 PID 复用成环
• 信号。taskkill（/F 对应 SIGKILL），已退出目标视为成功
• POSIX 独有概念（前台进程组、会话、stdin 等待探测）如实返回"不可得"，上层优雅降级
• 取消命令的 SIGINT 走 ConPTY 惯例，把 \x03 作为 PTY 输入写进去，MSYS/ash 会转发给前台任务

windows-latest CI 上实测。持久 shell 状态跨调用保留、中断 sleep 60 得 exit 130。配合 busybox-w32 ash 时在 WRITE_RESTRICTED 令牌（workspace-write 沙箱）内也能完整往返（MSYS bash 因 cygheap 的 TokenDefaultDacl 0xC0000022 起不来，这个也一并实测记录了）。

代码在 https://github.com/sjh9714/dsh-win32 （MIT，src/inspector.ts + src/terminal-wrap.ts，含单测与 CI）。如果官方愿意收编进 core，随便拿，需要我配合调整也可以。Windows 用户等这个等得比较苦（讨论区 Windows 相关帖子已经 400+ 了）。

[zoahdev]

Independently verified on Windows (Node 24, pnpm 11): cloned sjh9714/dsh-win32, rebuilt native deps (node-pty/koffi/esbuild), ran the test suite directly:

? src/inspector.test.ts (7 tests)
? src/terminal-wrap.test.ts (4 tests)
? src/fs.test.ts (6 tests) ? incl. GBK sniff
Test Files 3 passed (3) ? Tests 17 passed (17) ? vitest exit 0

This is the missing half of the Windows persistent-shell stack. It composes directly with our staged fix/terminal-bash-win32-shell (#1856, shellPath resolution): that patch makes the default /bin/bash resolvable, this inspector makes createProcessInspector work on win32 ? together they cover what the minimal preset needs. Endorse adopting the reference implementation into core (author offered it freely); the WRITE_RESTRICTED-token sandbox round-trip evidence is theirs (we did not re-run that specific scenario).

[sjh9714]

Thank you for the independent verification. Composing with #1856 is exactly right. shellPath resolution gets bash found, the inspector gets the PTY past createProcessInspector, and together the minimal preset is whole on win32.

For the WRITE_RESTRICTED round-trip you did not re-run, it is one command against this repo, SANDBOX_MODE=workspace-write node scripts/sandbox-smoke.mjs (with SMOKE_BASH/SMOKE_SHELL_ARGS pointing at busybox for the ash variant, and the CI job busybox-sandboxed shows the exact invocation). MSYS bash reproduces the TokenDefaultDacl 0xC0000022 failure on the same path.

Standing offer unchanged. The implementation is MIT, take it into core as is or reshaped, and I will adjust tests or split pieces however the core team prefers.

[sjh9714]

Adoption packaging is up, see docs/core-adoption.md. It carries the file list (zero runtime deps beyond node:child_process), the full ProcessInspector contract mapping including the honest degradations, suggested placement (a Win32ProcessInspector branch in createProcessInspector plus a win32 branch in signalForeground delivering control characters), an evidence index, and the one caveat worth carrying over (directly spawned console apps can survive a ConPTY kill, and we ship a taskkill /T /F fallback as of v0.5.0). MIT, reshape freely.