@mzzsfy/dsh-shell-select 0.1.0

package/test/guard-state.test.mjs

@@ -0,0 +1,111 @@
+// guard 哨兵(桩 loader):BDD 场景见 docs/progress/shell-select-plan.md「guard」。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { detectDeadState, rowState, effectiveDisabled, MAIN_ROW_ID, OFFICIAL_ROW_IDS } from '../src/guard-state.mjs'
+import { officialRowConfig } from '../src/guard-config.mjs'
+
+// --- 桩 loader / 行 ---
+
+function row({ id, disabled = false, running = false }) {
+  return {
+    options: { id },
+    get disabled() {
+      if (disabled === 'throw') throw new Error('expr eval failed')
+      return disabled
+    },
+    fiber: running ? { uid: 'f1' } : undefined,
+  }
+}
+
+function loader(rows) {
+  const map = new Map(rows.map((entry) => [entry.options.id, entry]))
+  return {
+    resolve(id) {
+      if (map.has(id)) return map.get(id)
+      throw new Error('not found')
+    },
+  }
+}
+
+const MAIN = MAIN_ROW_ID
+const [OFF_TOOL, OFF_EXEC] = OFFICIAL_ROW_IDS
+
+test('rowState:缺席/在场禁用/在场启用/运行中 四态', () => {
+  assert.deepEqual(rowState(loader([]), MAIN), { present: false, disabled: false, running: false })
+  assert.deepEqual(rowState(loader([row({ id: MAIN, disabled: true })]), MAIN), { present: true, disabled: true, running: false })
+  assert.deepEqual(rowState(loader([row({ id: MAIN })]), MAIN), { present: true, disabled: false, running: false })
+  assert.deepEqual(rowState(loader([row({ id: MAIN, running: true })]), MAIN), { present: true, disabled: false, running: true })
+})
+
+test('effectiveDisabled:disabled getter 抛错按未禁处理(让位安全向)', () => {
+  assert.equal(effectiveDisabled(row({ id: 'x', disabled: 'throw' })), false)
+})
+
+test('死态:主行禁用停稳(或旗标 inactive)且官方两行禁用停稳', () => {
+  const dead = loader([
+    row({ id: MAIN, disabled: true }),
+    row({ id: OFF_TOOL, disabled: true }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(dead, { applyState: () => 'active' }), true)
+})
+
+test('非死态:主行活着 / 主行禁但官方任一未禁 / 行运行中', () => {
+  const alive = loader([
+    row({ id: MAIN }),
+    row({ id: OFF_TOOL, disabled: true }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(alive, { applyState: () => 'active' }), false)
+
+  const officialAlive = loader([
+    row({ id: MAIN, disabled: true }),
+    row({ id: OFF_TOOL, disabled: false }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(officialAlive, { applyState: () => 'active' }), false)
+
+  const running = loader([
+    row({ id: MAIN, disabled: true, running: true }),
+    row({ id: OFF_TOOL, disabled: true }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(running, { applyState: () => 'active' }), false)
+})
+
+test('apply 旗标 inactive 等价主行功能性停摆(行未禁也判死)', () => {
+  const zombie = loader([
+    row({ id: MAIN }),
+    row({ id: OFF_TOOL, disabled: true }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(zombie, { applyState: () => 'inactive' }), true)
+})
+
+test('apply 旗标 pending(崩溃中)且行运行中:保守不判死', () => {
+  const rows = loader([
+    row({ id: MAIN, running: true }),
+    row({ id: OFF_TOOL, disabled: true }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(rows, { applyState: () => 'pending' }), false)
+})
+
+test('主行禁用停稳时旗标不阻断判定(行确已停,残留旗标无意义)', () => {
+  const rows = loader([
+    row({ id: MAIN, disabled: true }),
+    row({ id: OFF_TOOL, disabled: true }),
+    row({ id: OFF_EXEC, disabled: true }),
+  ])
+  assert.equal(detectDeadState(rows, { applyState: () => 'pending' }), true)
+})
+
+test('officialRowConfig:读 settings.yaml shell 节,缺失返回空对象', async () => {
+  const section = await officialRowConfig(async () => ({ shell: { pwshPath: 'C:\\x\\pwsh.exe' } }))
+  assert.deepEqual(section, { pwshPath: 'C:\\x\\pwsh.exe' })
+  assert.deepEqual(await officialRowConfig(async () => ({})), {})
+  assert.deepEqual(await officialRowConfig(async () => {
+    throw new Error('no file')
+  }), {})
+})

package/test/render.test.mjs

@@ -0,0 +1,73 @@
+// render 工具渲染镜像:BDD 场景见 docs/progress/shell-select-plan.md「模块 render」。
+// 期望文本与官方 dsh-tool-pwsh 渲染逐字对齐,terminal 卡解析(parseExitStatus)才能复原退出 pill。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { renderResult, renderProcessRead } from '../src/render.mjs'
+
+const NO_ESCALATION = []
+
+test('干净退出:仅 stdout,无标记', () => {
+  const text = renderResult({
+    stdout: { text: 'hello\n', truncated: false },
+    stderr: { text: '', truncated: false },
+    exitCode: 0, signal: null, timedOut: false, sandbox: undefined,
+  }, NO_ESCALATION)
+  assert.equal(text, 'hello\n')
+})
+
+test('stderr 段 + 非零退出标记次序', () => {
+  const text = renderResult({
+    stdout: { text: 'out\n', truncated: false },
+    stderr: { text: 'err\n', truncated: false },
+    exitCode: 2, signal: null, timedOut: false, sandbox: undefined,
+  }, NO_ESCALATION)
+  assert.equal(text, 'out\n[stderr]\nerr\n[exit code: 2]')
+})
+
+test('超时与信号标记', () => {
+  const text = renderResult({
+    stdout: { text: '', truncated: false },
+    stderr: { text: '', truncated: false },
+    exitCode: null, signal: 'SIGTERM', timedOut: true, timeoutMs: 1000, sandbox: undefined,
+  }, NO_ESCALATION)
+  assert.equal(text, '(no output)\n[timed out after 1000ms]\n[killed by signal: SIGTERM]')
+})
+
+test('截断输出追加 spill 提示', () => {
+  const text = renderResult({
+    stdout: { text: 'partial', truncated: true, spillPath: 'C:\\spill.txt' },
+    stderr: { text: '', truncated: false },
+    exitCode: 0, signal: null, timedOut: false, sandbox: undefined,
+  }, NO_ESCALATION)
+  assert.equal(text, 'partial\n[output truncated; full output: C:\\spill.txt]')
+})
+
+test('沙箱拒绝:拒绝标记 + 升权提示', () => {
+  const text = renderResult({
+    stdout: { text: '', truncated: false },
+    stderr: { text: '', truncated: false },
+    exitCode: 1, signal: null, timedOut: false,
+    sandbox: { mode: 'workspace-write', denied: true },
+  }, ['read-only', 'workspace-write'])
+  assert.match(text, /\[sandbox: file access denied under workspace-write mode\]/)
+  assert.match(text, /sandbox_permissions/)
+})
+
+test('后台 read:lossy 丢弃提示带 spill 路径', () => {
+  const text = renderProcessRead({
+    delta: 'chunk',
+    lossy: true,
+    stdoutSpillPath: 'C:\\out.txt',
+    stderrSpillPath: 'C:\\err.txt',
+  }, undefined, NO_ESCALATION)
+  assert.match(text, /some output was dropped from memory; full output: C:\\out\.txt, C:\\err\.txt/)
+})
+
+test('后台 read:runnerFailed 提示优先于 denial', () => {
+  const text = renderProcessRead({ delta: '', lossy: false }, {
+    mode: 'read-only', runnerFailed: true, denied: false,
+  }, ['read-only'])
+  assert.match(text, /sandbox runner itself failed/)
+  assert.doesNotMatch(text, /file access denied/)
+})

package/test/resolve.test.mjs

@@ -0,0 +1,131 @@
+// resolve 候选探测:BDD 场景见 docs/progress/shell-select-plan.md「模块 resolve」。
+// 平台差异经注入 env/platform 消除,测试不依赖真机安装布局。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { candidatePaths, resolveEntryPath, detectCandidates } from '../src/resolve.mjs'
+
+// 桩 lstat:按路径集合判定存在,文件形态命中
+function stubExists(existing) {
+  const set = new Set(existing)
+  return (candidate) => set.has(candidate)
+}
+
+const ENV = {
+  ProgramFiles: 'C:\\PF',
+  'ProgramFiles(x86)': 'C:\\PF86',
+  LocalAppData: 'C:\\LAD',
+  SystemRoot: 'C:\\WINDOWS',
+  PATH: 'C:\\one;C:\\two ;"C:\\three"',
+}
+
+const ENV_WITH_SYSTEM32_PATH = {
+  ...ENV,
+  PATH: 'C:\\WINDOWS\\System32;C:\\one',
+}
+
+test('pwsh 候选顺序:PowerShell 7 → PATH 各项 → System32 5.1', () => {
+  const candidates = candidatePaths('pwsh', ENV)
+  assert.deepEqual(candidates, [
+    'C:\\PF\\PowerShell\\7\\pwsh.exe',
+    'C:\\one\\pwsh.exe',
+    'C:\\two\\pwsh.exe',
+    'C:\\three\\pwsh.exe',
+    'C:\\WINDOWS\\System32\\WindowsPowerShell\\v1.0\\powershell.exe',
+  ])
+})
+
+test('bash 候选顺序:Git 三常见位置 → msys2 真实 bash → PATH', () => {
+  const candidates = candidatePaths('bash', ENV)
+  assert.deepEqual(candidates, [
+    'C:\\PF\\Git\\bin\\bash.exe',
+    'C:\\PF86\\Git\\bin\\bash.exe',
+    'C:\\LAD\\Programs\\Git\\bin\\bash.exe',
+    'C:\\msys64\\usr\\bin\\bash.exe',
+    'C:\\msys64\\bin\\bash.exe',
+    'C:\\one\\bash.exe',
+    'C:\\two\\bash.exe',
+    'C:\\three\\bash.exe',
+  ])
+})
+
+test('bash 候选排除 SystemRoot 下的 PATH 条目(WSL forwarder)', () => {
+  const candidates = candidatePaths('bash', ENV_WITH_SYSTEM32_PATH)
+  assert.deepEqual(candidates, [
+    'C:\\PF\\Git\\bin\\bash.exe',
+    'C:\\PF86\\Git\\bin\\bash.exe',
+    'C:\\LAD\\Programs\\Git\\bin\\bash.exe',
+    'C:\\msys64\\usr\\bin\\bash.exe',
+    'C:\\msys64\\bin\\bash.exe',
+    'C:\\one\\bash.exe',
+  ])
+})
+
+test('bash 候选排除 SystemRoot 下的正斜杠 PATH 条目', () => {
+  const env = { ...ENV, PATH: 'C:/WINDOWS/System32;C:\\one' }
+  const candidates = candidatePaths('bash', env)
+  assert.ok(!candidates.some((candidate) => candidate.toLowerCase().startsWith('c:\\windows')))
+  assert.ok(candidates.includes('C:\\one\\bash.exe'))
+})
+
+test('SystemRoot 带尾分隔符时排除规则仍命中', () => {
+  const env = { ...ENV, SystemRoot: 'C:\\WINDOWS\\', PATH: 'C:\\WINDOWS\\System32;C:\\one' }
+  const candidates = candidatePaths('bash', env)
+  assert.ok(!candidates.some((candidate) => candidate.toLowerCase().startsWith('c:\\windows')), '尾分隔符 SystemRoot 不得让 forwarder 入候选')
+  assert.ok(candidates.includes('C:\\one\\bash.exe'))
+})
+
+test('LocalAppData 缺省:LAD 锚位跳过,其余候选不受影响', () => {
+  const env = { ProgramFiles: 'C:\\PF', 'ProgramFiles(x86)': 'C:\\PF86', LocalAppData: '', PATH: '' }
+  const candidates = candidatePaths('bash', env)
+  assert.ok(!candidates.some((candidate) => candidate.startsWith('\\\\')), 'LocalAppData 为空不得产出空根拼接候选')
+  assert.ok(!candidates.some((candidate) => candidate.startsWith('undefined')))
+  assert.ok(candidates.includes('C:\\PF\\Git\\bin\\bash.exe'))
+  assert.ok(candidates.includes('C:\\msys64\\usr\\bin\\bash.exe'))
+})
+
+test('bash 候选永不含 msys2.exe 启动器(管道下静默失败)', () => {
+  for (const candidate of candidatePaths('bash', ENV)) {
+    assert.ok(!candidate.toLowerCase().includes('msys2.exe'), candidate)
+  }
+})
+
+test('cmd/wsl 候选:仅 System32 单点', () => {
+  assert.deepEqual(candidatePaths('cmd', ENV), ['C:\\WINDOWS\\System32\\cmd.exe'])
+  assert.deepEqual(candidatePaths('wsl', ENV), ['C:\\WINDOWS\\System32\\wsl.exe'])
+})
+
+test('显式路径原样使用,不探测', () => {
+  const resolved = resolveEntryPath({ kind: 'bash', path: 'D:\\tools\\my-bash.exe' }, stubExists([]))
+  assert.equal(resolved, 'D:\\tools\\my-bash.exe')
+})
+
+test('自动解析命中首个存在候选', () => {
+  const resolved = resolveEntryPath({ kind: 'bash', path: '' }, stubExists([
+    'C:\\one\\bash.exe',
+    'C:\\PF\\Git\\bin\\bash.exe',
+  ]), ENV)
+  assert.equal(resolved, 'C:\\PF\\Git\\bin\\bash.exe')
+})
+
+test('无候选存在返回 undefined', () => {
+  assert.equal(resolveEntryPath({ kind: 'pwsh', path: '' }, stubExists([]), ENV), undefined)
+})
+
+test('detect 返回全部命中并去重', () => {
+  const found = detectCandidates(['bash', 'cmd'], ENV, stubExists([
+    'C:\\PF\\Git\\bin\\bash.exe',
+    'C:\\three\\bash.exe',
+    'C:\\WINDOWS\\System32\\cmd.exe',
+  ]))
+  assert.deepEqual(found, [
+    { kind: 'bash', path: 'C:\\PF\\Git\\bin\\bash.exe' },
+    { kind: 'bash', path: 'C:\\three\\bash.exe' },
+    { kind: 'cmd', path: 'C:\\WINDOWS\\System32\\cmd.exe' },
+  ])
+})
+
+test('detect 同路径跨 kind 不重复收录', () => {
+  const found = detectCandidates(['pwsh', 'bash'], ENV, stubExists(['C:\\one\\bash.exe', 'C:\\one\\pwsh.exe']))
+  assert.equal(found.length, 2)
+})

package/test/sandbox-classify.test.mjs

@@ -0,0 +1,67 @@
+// sandbox-classify 官方镜像:BDD 场景见 docs/progress/shell-select-plan.md「模块 sandbox-classify」。
+// 逐项对照 dsh-pwsh-sandbox lib/index.js helpers,签名词表对齐官方 dsh-sandbox-local。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { classifyDenial, classifyRunnerFailure, isRunnerSpawnFailure, isUsableWorkdir } from '../src/sandbox-classify.mjs'
+
+const SIG = ['file access denied', 'EPERM: operation not permitted']
+
+test('denial:非零退出 + stderr 命中签名(大小写不敏感)', () => {
+  assert.equal(classifyDenial({ exitCode: 1, stderr: { text: 'bash: /x: File Access Denied\r\n' } }, SIG), true)
+})
+
+test('denial:零退出或信号死亡不判拒绝', () => {
+  assert.equal(classifyDenial({ exitCode: 0, stderr: { text: 'file access denied' } }, SIG), false)
+  assert.equal(classifyDenial({ exitCode: null, stderr: { text: 'file access denied' } }, SIG), false)
+})
+
+const RULES = [
+  {
+    allowedExitCodes: [126],
+    informationalLines: ['info: harmless'],
+    fatalSignatures: ['cannot run runner'],
+  },
+  { fatalSignatures: ['runner died'] },
+]
+
+test('runnerFailure:允许码外 + 致命行命中;信息行豁免;非允许码跳过', () => {
+  assert.deepEqual(
+    classifyRunnerFailure(126, 'info: harmless\ncannot run runner: boom\n', RULES),
+    { detail: 'cannot run runner: boom' },
+  )
+  assert.equal(classifyRunnerFailure(999, 'nothing fatal here\n', RULES), undefined)
+  assert.deepEqual(
+    classifyRunnerFailure(2, 'some prefix runner died\n', RULES),
+    { detail: 'some prefix runner died' },
+  )
+})
+
+test('runnerFailure:零退出与信号死亡不判失败', () => {
+  assert.equal(classifyRunnerFailure(0, 'runner died\n', RULES), undefined)
+  assert.equal(classifyRunnerFailure(null, 'runner died\n', RULES), undefined)
+})
+
+test('runnerSpawnFailure:ENOENT/EACCES + spawn 系统调用 + argv0 溯源', () => {
+  const workdir = process.cwd()
+  assert.equal(isRunnerSpawnFailure(
+    { code: 'ENOENT', syscall: 'spawn C:\\runner\\wrap.exe', path: 'C:\\runner\\wrap.exe' },
+    'C:\\runner\\wrap.exe', workdir,
+  ), true)
+  assert.equal(isRunnerSpawnFailure(
+    { code: 'EACCES', syscall: 'spawn C:\\runner\\wrap.exe' },
+    'C:\\runner\\wrap.exe', workdir,
+  ), true)
+})
+
+test('runnerSpawnFailure:其他码/其他路径/坏 cwd 不判 runner 失败', () => {
+  const workdir = process.cwd()
+  assert.equal(isRunnerSpawnFailure({ code: 'EACCES', syscall: 'spawn' }, undefined, workdir), false)
+  assert.equal(isRunnerSpawnFailure({ code: 'ENOENT', syscall: 'spawn', path: 'C:\\other.exe' }, 'C:\\runner\\wrap.exe', workdir), false)
+  assert.equal(isRunnerSpawnFailure({ code: 'EACCES', syscall: 'spawn x' }, 'C:\\runner\\wrap.exe', 'Z:\\definitely\\missing'), false)
+})
+
+test('isUsableWorkdir:存在目录 true,缺失 false', () => {
+  assert.equal(isUsableWorkdir(process.cwd()), true)
+  assert.equal(isUsableWorkdir('Z:\\definitely\\missing'), false)
+})

package/test/switch-guard.test.mjs

@@ -0,0 +1,37 @@
+// 开关样式守卫 BDD:裸 checkbox 直接呈现违反仓库 client 规约(DEVELOPMENT/plugin-client-conventions.md),
+// 静态断言锁死 sls-switch 结构(参照 mce-switch/tn-switch/cb-switch 同款守卫)。
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+
+test('switch 隐藏规则以 input[type="checkbox"] 精确匹配', () => {
+  assert.match(source, /\.sls-switch input\[type="checkbox"\] \{ position:absolute/)
+})
+
+test('switch 状态选择器禁止裸 input 锚定(防误伤同 label 的文本输入)', () => {
+  const bare = source.match(/\.sls-switch input:(?!\[type)[a-z-]+/g)
+  assert.equal(bare, null, `裸 input 状态选择器: ${bare}`)
+})
+
+test('checkbox 仅允许出现在 switchToggle 工厂内,禁止裸 checkbox 直出', () => {
+  const occurrences = [...source.matchAll(/type: 'checkbox'/g)].map((match) => match.index)
+  assert.equal(occurrences.length, 1, `checkbox 字面量出现 ${occurrences.length} 次`)
+  const factoryStart = source.indexOf('function switchToggle')
+  const factoryEnd = source.indexOf('}', source.indexOf('__thumb', factoryStart))
+  assert.ok(occurrences[0] > factoryStart && occurrences[0] < factoryEnd, 'checkbox 字面量不在 switchToggle 工厂内')
+})
+
+test('switchToggle 产出顺序为 input 在前 track 在后', () => {
+  const factory = source.slice(source.indexOf('function switchToggle'))
+  assert.ok(factory.indexOf("h('input'") < factory.indexOf('sls-switch__track'), '工厂内 input 必须先于 track')
+})
+
+test('checked/focus-visible 两态均以 checkbox 锚定', () => {
+  assert.match(source, /\.sls-switch input\[type="checkbox"\]:checked \+/)
+  assert.match(source, /\.sls-switch input\[type="checkbox"\]:focus-visible \+/)
+})