From 19adf9feed4b9d07c0060f0dadd950cdfd32aa1d Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 22:39:55 +0800 Subject: [PATCH] Import vendor/dsh-remote-ssh/tests/sidebar-0250-endpoints.test.mjs --- .../tests/sidebar-0250-endpoints.test.mjs | 613 ++++++++++++++++++ 1 file changed, 613 insertions(+) create mode 100644 vendor/dsh-remote-ssh/tests/sidebar-0250-endpoints.test.mjs diff --git a/vendor/dsh-remote-ssh/tests/sidebar-0250-endpoints.test.mjs b/vendor/dsh-remote-ssh/tests/sidebar-0250-endpoints.test.mjs new file mode 100644 index 0000000..a07fb7d --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/sidebar-0250-endpoints.test.mjs @@ -0,0 +1,613 @@ +// better-sidebar 0.25.0 新端点的接管 —— fs.createFile + git.blame / diff-head / worktrees / pull / push +// +// 背景:0.25.0 新增了 9 个端点,其中 6 个与「仓库 / 路径」相关。本插件用 kind:"exact" 接管 +// `/sidebar/api/fs.*` 与 `/sidebar/api/git.*`,所以**没被注册的端点会回落到上游实现**, +// 而远程工作区里上游的 cwd 是本地镜像目录(镜像没有 .git、也不是文件系统的事实来源): +// · fs.createFile → 空文件只建在本地镜像里,远端永远没有(与 0.24 的 fs.trees 同一类) +// · git.blame / diff-head / worktrees → 按镜像里的 git 状态返回(通常是空/报错) +// · git.pull / push → 在镜像上跑 git,动的是一个与远端无关的仓库 +// 维护笔记里的硬规则(MAINTENANCE「升级 better-sidebar 后必做对拍」)就是这条:升级后必须 +// 把上游宿主 handler 键集合与本插件注册集合逐项比对。本文件的 C 段把这条规则**自动化**。 +// +// 三层: +// A. 纯函数真值表:creatableFileNameProblem / isoWithOffset / parseBlamePorcelain / +// parseWorktreeList / countStatusEntries / 路径同一性 —— 规则逐条对齐上游。 +// B. **真实处理器的行为**(源码切片 + 假 ctx/req/res + 假远端): +// 本地 fs.createFile 落盘与 409、远程 fs.createFile 走 SSH(命令形状)、 +// git.blame / diff-head / worktrees / pull / push 的实参与返回形状(pull 还要失效缓存)。 +// C. 接线与上游覆盖率:注册数组包含 6 个端点;若本机装了 better-sidebar, +// 直接与它的宿主 handler 键集合对拍(没装则 SKIP,不算失败)。 +import { readFileSync, existsSync, mkdtempSync, rmSync, mkdirSync, writeFileSync, readdirSync } from 'node:fs' +import { stat, open, readFile, writeFile, rename, rm, mkdir, opendir, lstat } from 'node:fs/promises' +import { tmpdir, homedir } from 'node:os' +import { join, dirname, basename } from 'node:path' +import { fileURLToPath } from 'node:url' + +const root = fileURLToPath(new URL('..', import.meta.url)) +const src = readFileSync(root + '/lib/index.js', 'utf8') +const changelog = readFileSync(root + '/CHANGELOG.md', 'utf8') +const pkg = JSON.parse(readFileSync(root + '/package.json', 'utf8')) + +function grab(text, name) { + const start = text.indexOf(name) + if (start < 0) throw new Error(name + ' not found') + const declStart = text.lastIndexOf('\n', start) + let i = text.indexOf('{', start) + let depth = 0 + for (; i < text.length; i++) { + if (text[i] === '{') depth++ + else if (text[i] === '}') { depth--; if (depth === 0) break } + } + return text.slice(declStart + 1, i + 1) +} + +let pass = 0, fail = 0 +const check = (cond, label) => { if (cond) { pass++; console.log(' ✓ ' + label) } else { fail++; console.log(' ✗ FAIL: ' + label) } } + +// 0.25.0 新端点的纯函数是**连续一段**,整段切出来即可(它是模块作用域、无外部依赖)。 +const HELPER_BLOCK_START = '// ---- better-sidebar 0.25.0 新端点的纯函数' +const HELPER_BLOCK_END = '/**\n * 解析 better-sidebar 0.24 的 `open.external` URL' +const NEW_HELPERS = (() => { + const a = src.indexOf(HELPER_BLOCK_START) + const b = src.indexOf(HELPER_BLOCK_END) + if (a < 0 || b < 0 || b <= a) throw new Error('0.25.0 helper block not found') + return src.slice(a, b) +})() + +// issue #25 (2.4.27) 引入的路径归一helper,处理器沙箱还要用 +const PATH_HELPERS = [ + grab(src, 'function isAbsoluteLocalPath'), + // 2.4.30(issue #26):fs 处理器改为按请求路径**语法 + 归属**分派,沙箱必须带上这两个纯函数, + // 否则沙箱里跑真实处理器会 "classifyRequestPathSyntax is not defined"(那是沙箱缺件,不是被测行为)。 + grab(src, 'function classifyRequestPathSyntax'), + grab(src, 'function looksLikeRemoteAbsolutePath'), + grab(src, 'function resolveSessionPath'), + grab(src, 'function unresolvedPathMessage') +].join('\n') + +const helpersModule = new Function(NEW_HELPERS + '\nreturn { creatableFileNameProblem, isoWithOffset, parseBlamePorcelain, parseWorktreeList, countStatusEntries, posixPathIdentity, localPathIdentity, firstIllegalNameChar, RESERVED_FILE_NAMES };')() +const { + creatableFileNameProblem, isoWithOffset, parseBlamePorcelain, parseWorktreeList, + countStatusEntries, posixPathIdentity, localPathIdentity, firstIllegalNameChar, RESERVED_FILE_NAMES +} = helpersModule + +// --------------------------------------------------------------------------- +// A. 纯函数 +// --------------------------------------------------------------------------- +console.log('\nA. 纯函数(规则对齐上游)') +check(creatableFileNameProblem('readme.md') === '', 'A1 普通文件名可用') +check(creatableFileNameProblem('📁数据.txt') === '', 'A2 emoji/中文名可用(按码点迭代,不误判成非法半字符)') +check(creatableFileNameProblem('') === 'name must be a single path segment', 'A3 空名 → 单段名错误') +check(creatableFileNameProblem('.') === 'name must be a single path segment', 'A4 "." 拒绝') +check(creatableFileNameProblem('..') === 'name must be a single path segment', 'A5 ".." 拒绝') +check(creatableFileNameProblem('a/b') === 'name must be a single path segment', 'A6 含 "/" 拒绝') +check(String.raw`a\b`.length === 3 && creatableFileNameProblem(String.raw`a\b`) === 'name must be a single path segment', 'A7 含 "\\" 拒绝') +for (const bad of ['ab', 'a:b', 'a"b', 'a|b', 'a?b', 'a*b']) { + check(creatableFileNameProblem(bad).indexOf('not allowed in a file name') > 0, 'A8 非法字符拒绝: ' + bad) +} +check(creatableFileNameProblem('a\u0001b').indexOf('not allowed in a file name') > 0, 'A9 控制字符拒绝(码点 < 32)') +for (const res of ['NUL', 'nul.txt', 'COM1', 'lpt9.tar.gz', 'con']) { + check(creatableFileNameProblem(res).indexOf('reserved device name') > 0, 'A10 Windows 保留名拒绝: ' + res) +} +check(creatableFileNameProblem('nulx').indexOf('reserved device name') < 0, 'A11 前缀相同的普通名(nulx)不被误拒') +check(firstIllegalNameChar('ok') === undefined && firstIllegalNameChar('a WT.split('/remote/root').join(String(rootPath)) +const wtRows = parseWorktreeList(wtFixture('/remote/root')) +check(wtRows.length === 3, 'A22 worktree 解析出 3 条') +check(wtRows[0].path === '/remote/root' && wtRows[0].branch === 'main' && wtRows[0].locked === false && wtRows[0].prunable === false, 'A23 第一条 path/branch 正确') +check(wtRows[1].branch === 'feature' && wtRows[1].locked === true, 'A24 locked 被识别') +check(wtRows[2].prunable === true, 'A25 prunable 被识别') +check(parseWorktreeList('worktree /a\nHEAD x\nbranch refs/heads/b').length === 1, 'A26 末尾没有空行也能收尾(上游 framed 语义)') +check(parseWorktreeList('worktree /a\0HEAD x\0branch refs/heads/b\0\0').length === 1, 'A27 NUL 分隔(-z)同样能解析') +check(parseWorktreeList('').length === 0, 'A28 空输出 → []') + +check(countStatusEntries('') === 0, 'A29 空 status → 0 条') +check(countStatusEntries(' M a.txt\0?? b.txt\0') === 2, 'A30 普通修改 + 未跟踪 → 2 条') +check(countStatusEntries('R new.txt\0old.txt\0') === 1, 'A31 改名占两条 NUL 记录,只算 1 条(口径同上游 entries.length)') +check(countStatusEntries('R n1\0o1\0R n2\0o2\0') === 2, 'A32 连续两个改名 → 2 条') +check(countStatusEntries('?? sub/\0 M x\0A y\0') === 3, 'A33 混合状态 → 3 条') + +check(posixPathIdentity('/a/b/') === '/a/b' && posixPathIdentity('/A/B') === '/A/B', 'A34 远端同一性:去尾斜杠、区分大小写') +const lp = localPathIdentity('C:\\Dir\\Sub\\') +check(lp === (process.platform === 'win32' ? 'c:\\dir\\sub' : 'C:\\Dir\\Sub'), 'A35 本机同一性:Windows 下大小写无关') + +// --------------------------------------------------------------------------- +// B. 真实处理器行为 +// --------------------------------------------------------------------------- +const writeJson = (res, status, obj) => { res.status = status; res.body = obj } +const writeOk = (res, value) => { res.status = 200; res.body = { ok: true, value: value } } +const readJsonBody = async (req) => req.__body +const requestTrust = () => 'ok' +const denyRequest = (res, why) => { res.status = 403; res.body = { ok: false, error: { code: 'denied', message: why } } } +function makeRes() { + const res = { status: 0, body: undefined, raw: undefined, writeHead(s) { res.status = s; return res }, end(b) { if (b !== undefined && res.raw === undefined) res.raw = b; return res }, setHeader() { return res } } + return res +} +function makeCtx(sessionDir) { + const sessions = { get: (id) => (id === 'sess-1' ? { header: { cwd: sessionDir } } : null) } + return { get: (n) => (n === 'sessions' ? sessions : null), logger: { debug() {}, warn() {}, error() {} } } +} + +const originalCwd = process.cwd() +const hostDir = mkdtempSync(join(tmpdir(), 'dsh-0250-host-')) +const sessionDir = mkdtempSync(join(tmpdir(), 'dsh-0250-sess-')) +mkdirSync(join(sessionDir, 'tools'), { recursive: true }) +writeFileSync(join(sessionDir, 'tools', 'x.py'), 'SESSION-CONTENT') +writeFileSync(join(hostDir, 'tools-canary.txt'), 'HOST-CANARY') +const REMOTE_ROOT = '/remote/root' +const HOST = '' +const USER = '' +const KEY = '' + +/** 远程工作区沙箱:readRemoteInfoSync 认得 sessionDir,runPooled 记录远端命令。 */ +function fsSandbox(opts) { + const rec = { cmds: [], invalidations: [] } + const remote = !!opts.remote + const fn = new Function( + 'join', 'dirname', 'basename', 'stat', 'open', 'readFile', 'writeFile', 'rename', 'rm', 'mkdir', + 'opendir', 'lstat', 'existsSync', 'homedir', 'READ_LIMIT', 'LIST_LIMIT', + 'ctx', 'requestTrust', 'denyRequest', 'writeJson', 'writeOk', 'readJsonBody', + 'readRemoteInfoSync', 'localSearchFiles', 'getProfile', 'localToRemote', 'shellQuotePath', + 'runPooled', 'invalidateRemoteCaches', 'settingsFace', + PATH_HELPERS + '\n' + NEW_HELPERS + '\n' + + // 2.4.29 起 fs 判定按"工作区根前缀"匹配:这几个真源码必须一起进沙箱(不 stub 判定逻辑)。 + grab(src, 'function mirrorBaseDir') + '\n' + + grab(src, 'function isUnderMirrorBase') + '\n' + + grab(src, 'function matchRemoteWorkspace') + '\n' + + grab(src, 'function remoteWorkspaceForPath') + '\n' + + grab(src, 'function readPathsField') + '\n' + + grab(src, 'function sidebarEntriesFrom') + '\n' + + grab(src, 'function toPosixRelative') + '\n' + + grab(src, 'function fsSearchResult') + '\n' + + grab(src, 'function sessionCwdFrom') + '\n' + + grab(src, 'async function localReadText') + '\n' + + grab(src, 'async function localWriteFile') + '\n' + + grab(src, 'async function localListDir') + '\n' + + grab(src, 'async function localRenameEntry') + '\n' + + grab(src, 'async function localRemoveEntry') + '\n' + + grab(src, 'async function localMakeDir') + '\n' + + grab(src, 'async function localCreateFile') + '\n' + + grab(src, 'async function interceptFsHandler') + '\n' + + 'return interceptFsHandler;' + )( + join, dirname, basename, stat, open, readFile, writeFile, rename, rm, mkdir, + opendir, lstat, existsSync, homedir, 524288, 1000, + makeCtx(sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, + remote + ? (p) => (typeof p === 'string' && p.indexOf(sessionDir) === 0 + ? { profileId: 'p1', host: HOST, user: USER, keyPath: KEY, remotePath: REMOTE_ROOT, mirrorPath: sessionDir } : null) + : () => null, + async () => ({ entries: [], truncated: false }), + () => ({ id: 'p1', host: HOST, user: USER, keyPath: KEY }), + (local, mirror, remoteRoot) => String(remoteRoot) + String(local).replace(/\\/g, '/').slice(String(mirror).replace(/\\/g, '/').length), + (p) => "'" + String(p).replace(/'/g, "'\\''") + "'", + async (profile, cmd) => { + rec.cmds.push(cmd) + // 只把 taken.txt 当作"远端已存在",其余不存在 —— 用于验证 409 分支。 + if (/^test -e /.test(cmd)) return { ok: /taken\.txt/.test(cmd), stdout: '', stderr: '' } + if (/set -C/.test(cmd)) return { ok: true, stdout: '', stderr: '' } + return { ok: true, stdout: '', stderr: '' } + }, + (p, path, o) => { rec.invalidations.push([path, o]) }, + // 已注册工作区:remote 模式下把会话镜像根注册进去(真实客户端里 sessionId → 会话 cwd = 镜像根) + { read: () => ({ workspaces: remote ? [{ mirrorPath: sessionDir }] : [] }) } + ) + return { handler: fn, rec } +} + +const fsCall = async (api, payload, method) => { + const res = makeRes() + await api({ method: 'POST', headers: {}, __body: payload }, res, method) + return res +} + +console.log('\nB1. fs.createFile(本地分支:真落盘、真 409)') +try { + process.chdir(hostDir) + const { handler } = fsSandbox({ remote: false }) + let r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'new.txt' }, 'fs.createFile') + check(r.status === 200 && r.body.ok === true && r.body.value.path === join(sessionDir, 'tools', 'new.txt'), + 'B1 createFile 相对 path → 建在**会话 cwd** 下并返回绝对路径(旧代码会建到插件宿主目录)') + check(existsSync(join(sessionDir, 'tools', 'new.txt')) && readFileSync(join(sessionDir, 'tools', 'new.txt'), 'utf8') === '', + 'B2 文件真的存在于会话目录,且是空文件') + check(!existsSync(join(hostDir, 'tools', 'new.txt')), 'B3 宿主目录里没有多出这个文件') + + r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'new.txt' }, 'fs.createFile') + check(r.status === 409 && /"new.txt" already exists/.test(r.body.error.message), 'B4 同名已存在 → 409(上游契约,不是 400)') + + r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'a/b' }, 'fs.createFile') + check(r.status === 400 && r.body.error.code === 'bad-request' && /single path segment/.test(r.body.error.message), + 'B5 非法名 → 400 bad-request(带上游文案,客户端能直接显示)') + r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'nul' }, 'fs.createFile') + check(r.status === 400 && /reserved device name/.test(r.body.error.message), 'B6 Windows 保留名 → 400') + + r = await fsCall(handler, { sessionId: 'sess-UNKNOWN', path: 'tools', name: 'host-side.txt' }, 'fs.createFile') + check(r.status === 400 && !existsSync(join(hostDir, 'tools', 'host-side.txt')), + 'B7 取不到会话 cwd → 400,绝不在宿主目录里建文件') + + // fs.mkdir 的"已存在"对齐成 409(此前本地分支误给 400) + r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'new.txt' }, 'fs.mkdir') + check(r.status === 409, 'B8 本地 fs.mkdir 同名已存在 → 409(与上游/本插件远程分支一致)') +} finally { process.chdir(originalCwd) } + +console.log('\nB2. fs.createFile(远程分支:必须落到远端)') +try { + process.chdir(hostDir) + const { handler, rec } = fsSandbox({ remote: true }) + const r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'far.txt' }, 'fs.createFile') + check(r.status === 200 && r.body.value.path === join(sessionDir, 'tools', 'far.txt'), + 'B9 远程 createFile → 200 且返回镜像路径(客户端认镜像路径)') + const create = rec.cmds.filter((c) => /set -C/.test(c)) + check(create.length === 1 && create[0].indexOf(REMOTE_ROOT + '/tools/far.txt') > 0, + 'B10 空文件是在**远端**创建的(命令含远端绝对路径):' + (create[0] || '(无命令)')) + check(rec.cmds.some((c) => /^test -e /.test(c) && c.indexOf(REMOTE_ROOT + '/tools/far.txt') > 0), + 'B11 创建前先探测远端是否已存在') + check(rec.invalidations.length === 1 && rec.invalidations[0][0] === REMOTE_ROOT + '/tools', + 'B12 父目录列举缓存被失效(面板能立刻看到新文件)') + const r2 = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'taken.txt' }, 'fs.createFile') + check(r2.status === 409, 'B13 远端已存在(探测命中)→ 409 且不执行创建') + const r3 = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'bad/name' }, 'fs.createFile') + check(r3.status === 400 && !rec.cmds.some((c) => c.indexOf('bad/name') > 0), 'B14 非法名在本地就被挡下(不产生任何 SSH 命令)') + check(rec.cmds.every((c) => typeof c === 'string' && c.length > 0), 'B15 所有远端命令都是字符串(无 undefined 拼接)') +} finally { process.chdir(originalCwd) } + +console.log('\nB3. git.* 新端点(真实处理器 + 假 git)') +function gitSandbox(opts) { + const rec = { calls: [], invalidations: [], freshness: [] } + const remote = !!opts.remote + const responses = opts.responses || {} + const key = (dir, args) => dir + ' :: ' + args.join(' ') + const handler = new Function( + 'join', 'existsSync', 'readFileSync', 'ctx', 'requestTrust', 'denyRequest', 'writeJson', 'writeOk', 'readJsonBody', + 'matchRemoteWorkspace', 'readRemoteInfoSync', 'getProfile', 'localToRemote', 'runGitLocal', 'runGitRemote', + 'invalidateRemoteCaches', 'freshnessForgetProfile', 'wrapperDir', + PATH_HELPERS + '\n' + NEW_HELPERS + '\n' + + grab(src, 'function sessionCwdFrom') + '\n' + + grab(src, 'function parsePorcelainZ') + '\n' + + grab(src, 'function parseLogLines') + '\n' + + grab(src, 'async function gitStatusImpl') + '\n' + + grab(src, 'async function gitWorktreesImpl') + '\n' + + grab(src, 'function gitContextOf') + '\n' + + grab(src, 'async function interceptGitHandler') + '\n' + + 'return interceptGitHandler;' + )( + join, existsSync, readFileSync, makeCtx(sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, + remote ? (a, b) => ({ mirrorPath: sessionDir }) : () => null, + remote ? (p) => (typeof p === 'string' && p.indexOf(sessionDir) === 0 + ? { profileId: 'p1', host: HOST, user: USER, keyPath: KEY, remotePath: REMOTE_ROOT, mirrorPath: sessionDir } : null) : () => null, + () => ({ id: 'p1' }), + (local, mirror, remoteRoot) => String(remoteRoot) + String(local).replace(/\\/g, '/').slice(String(mirror).replace(/\\/g, '/').length), + async (dir, args) => { + rec.calls.push(['local', dir, args.join(' ')]) + if (responses[key(dir, args)] !== undefined) { + const v = responses[key(dir, args)] + if (v instanceof Error) throw v + return v + } + if (args[0] === 'status') return '' + if (args[0] === 'worktree') return '' + return '' + }, + async (profile, dir, args) => { + rec.calls.push(['remote', dir, args.join(' ')]) + if (responses[key(dir, args)] !== undefined) { + const v = responses[key(dir, args)] + if (v instanceof Error) throw v + return v + } + if (args[0] === 'status') return '' + return '' + }, + (p, path, o) => { rec.invalidations.push([path, o]) }, + (stateDir, profileId) => { rec.freshness.push([stateDir, profileId]) }, + '' + ) + return { handler, rec } +} +const gitCall = async (api, method, payload) => { + const res = makeRes() + await api({ method: 'POST', headers: {}, __body: payload }, res, method) + return res +} + +try { + process.chdir(hostDir) + + // ---- blame ---- + { + const { handler, rec } = gitSandbox({ remote: false, responses: { [sessionDir + ' :: blame --porcelain -L 3,7 -- src/a.ts']: BLAME } }) + const r = await gitCall(handler, 'blame', { sessionId: 'sess-1', path: 'src/a.ts', startLine: 3, endLine: 7 }) + check(r.status === 200 && r.body.value.lines.length === 3 && r.body.value.lines[0].author === 'Alice', + 'B16 git.blame → {lines:[…]}(真实处理器解析 porcelain)') + check(rec.calls.length === 1 && rec.calls[0][1] === sessionDir && rec.calls[0][2] === 'blame --porcelain -L 3,7 -- src/a.ts', + 'B17 blame 用会话 cwd 跑,实参与上游一致(-L start,end -- path)') + + const bad1 = await gitCall(handler, 'blame', { sessionId: 'sess-1', path: 'src/a.ts', startLine: 0, endLine: 7 }) + check(bad1.status === 400 && rec.calls.length === 1, 'B18 startLine 非正整数 → 400,且**不跑** git') + const bad2 = await gitCall(handler, 'blame', { sessionId: 'sess-1', path: 'src/a.ts', startLine: 7, endLine: 3 }) + check(bad2.status === 400 && /must not precede/.test(bad2.body.error.message), 'B19 endLine < startLine → 400(上游文案)') + const bad3 = await gitCall(handler, 'blame', { sessionId: 'sess-1', startLine: 1, endLine: 2 }) + check(bad3.status === 400 && /path is required/.test(bad3.body.error.message), 'B20 缺 path → 400') + + const failing = gitSandbox({ remote: false, responses: { [sessionDir + ' :: blame --porcelain -L 1,1 -- untracked.txt']: new Error('fatal: no such path') } }) + const r2 = await gitCall(failing.handler, 'blame', { sessionId: 'sess-1', path: 'untracked.txt', startLine: 1, endLine: 1 }) + check(r2.status === 200 && r2.body.value.lines.length === 0, 'B21 blame 失败 → 静默降级成空数组(上游同)') + } + + // ---- diff-head ---- + { + const { handler, rec } = gitSandbox({ remote: false, responses: { [sessionDir + ' :: diff --no-ext-diff --no-color -U3 HEAD -- src/a.ts']: 'DIFF-HEAD-TEXT' } }) + const r = await gitCall(handler, 'diff-head', { sessionId: 'sess-1', path: 'src/a.ts' }) + check(r.status === 200 && r.body.value.diff === 'DIFF-HEAD-TEXT', 'B22 git.diff-head → {diff}') + check(rec.calls[0][2] === 'diff --no-ext-diff --no-color -U3 HEAD -- src/a.ts', 'B23 diff-head 实参与上游一致(--no-ext-diff --no-color -U3 HEAD)') + const noHead = gitSandbox({ remote: false, responses: { [sessionDir + ' :: diff --no-ext-diff --no-color -U3 HEAD -- src/a.ts']: new Error('fatal: ambiguous argument HEAD') } }) + const r2 = await gitCall(noHead.handler, 'diff-head', { sessionId: 'sess-1', path: 'src/a.ts' }) + check(r2.status === 200 && noHead.rec.calls.some((c) => c[2] === 'diff --no-ext-diff --no-color -U3 --cached -- src/a.ts'), + 'B24 没有 HEAD 时回退 --cached(上游的回退分支)') + const r3 = await gitCall(handler, 'diff-head', { sessionId: 'sess-1' }) + check(r3.status === 400, 'B25 diff-head 缺 path → 400') + } + + // ---- worktrees(本地)---- + { + const { handler, rec } = gitSandbox({ + remote: false, + responses: { + [sessionDir + ' :: rev-parse --is-inside-work-tree']: 'true\n', + [sessionDir + ' :: rev-parse --show-toplevel']: sessionDir + '\n', + [sessionDir + ' :: worktree list --porcelain']: wtFixture(sessionDir), + [sessionDir + ' :: status --porcelain=v1 -z --untracked-files=all']: ' M a.txt\0?? b.txt\0' + } + }) + const r = await gitCall(handler, 'worktrees', { sessionId: 'sess-1' }) + const rows = r.body.value + check(r.status === 200 && Array.isArray(rows) && rows.length === 2, 'B26 git.worktrees → 数组(prunable 被过滤)') + check(rows[0].path === sessionDir && rows[0].current === true && rows[0].branch === 'main' && rows[0].changes === 2, + 'B27 current 条目排最前,changes 为 status 条目数') + check(rows[1].path === '/remote/wt2' && rows[1].current === false && rows[1].branch === 'feature' && rows[1].changes === 0, + 'B28 其他 worktree 保留远端路径形状,changes 缺省 0') + check(rec.calls.some((c) => c[1] === '/remote/wt2' && c[2].indexOf('status --porcelain=v1 -z --untracked-files=all') === 0), + 'B29 每个 worktree 的 status 用**它自己的目录**跑(不是会话 cwd)') + const notRepo = gitSandbox({ remote: false, responses: { [sessionDir + ' :: rev-parse --is-inside-work-tree']: 'false\n' } }) + const r2 = await gitCall(notRepo.handler, 'worktrees', { sessionId: 'sess-1' }) + check(r2.status === 200 && r2.body.value.length === 0, 'B30 不是仓库 → [](上游同)') + } + + // ---- worktrees(远程:runIn 必须走 SSH + 用远端路径)---- + { + const { handler, rec } = gitSandbox({ + remote: true, + responses: { + [REMOTE_ROOT + ' :: rev-parse --is-inside-work-tree']: 'true\n', + [REMOTE_ROOT + ' :: rev-parse --show-toplevel']: REMOTE_ROOT + '\n', + [REMOTE_ROOT + ' :: worktree list --porcelain']: wtFixture(REMOTE_ROOT), + [REMOTE_ROOT + ' :: status --porcelain=v1 -z --untracked-files=all']: ' M a.txt\0' + } + }) + const r = await gitCall(handler, 'worktrees', { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.value[0].current === true, 'B31 远程 worktrees:current 用远端路径判定') + check(rec.calls.every((c) => c[0] === 'remote'), 'B32 远程分支只走 runGitRemote(不在本机跑 git)') + check(rec.calls.some((c) => c[1] === '/remote/wt2'), 'B33 每个 worktree 用**远端**路径跑(/remote/wt2)') + check(rec.calls.every((c) => !String(c[1]).startsWith(sessionDir)), 'B34 没有任何调用落到本地镜像目录') + } + + // ---- pull / push ---- + { + const { handler, rec } = gitSandbox({ remote: true, responses: { [REMOTE_ROOT + ' :: pull --ff-only']: 'Already up to date.\n' } }) + const r = await gitCall(handler, 'pull', { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.value.ok === true, 'B35 git.pull → {ok:true}') + check(rec.calls.length === 1 && rec.calls[0][1] === REMOTE_ROOT && rec.calls[0][2] === 'pull --ff-only', + 'B36 pull 在**远端仓库**上跑(--ff-only,与上游一致)') + check(rec.invalidations.length === 1 && rec.invalidations[0][0] === REMOTE_ROOT && rec.invalidations[0][1].subtree === true, + 'B37 pull 之后整棵远端列举缓存失效(工作树可能变了)') + check(rec.freshness.length === 1 && rec.freshness[0][1] === 'p1', 'B38 pull 之后清掉写回桥的远端指纹(否则下次写回被误判"远端已改动")') + + const pushed = gitSandbox({ remote: true, responses: { [REMOTE_ROOT + ' :: push']: 'ok\n' } }) + const r2 = await gitCall(pushed.handler, 'push', { sessionId: 'sess-1' }) + check(r2.status === 200 && r2.body.value.ok === true && pushed.rec.calls[0][2] === 'push', 'B39 git.push → {ok:true} 且实参为 push') + check(pushed.rec.invalidations.length === 0 && pushed.rec.freshness.length === 0, 'B40 push 不改工作树 → 不做缓存失效(避免无谓刷新)') + + const local = gitSandbox({ remote: false, responses: { [sessionDir + ' :: pull --ff-only']: '' } }) + const r3 = await gitCall(local.handler, 'pull', { sessionId: 'sess-1' }) + check(r3.status === 200 && local.rec.calls[0][1] === sessionDir, 'B41 本地 pull 用会话 cwd,且不触碰远端缓存/指纹') + check(local.rec.invalidations.length === 0 && local.rec.freshness.length === 0, 'B42 本地 pull 不做远端失效') + } + + // ---- 未注册的模型类端点不应被本插件接管(回归:别把它们塞进 GIT_METHODS)---- + { + const { handler } = gitSandbox({ remote: false }) + const r = await gitCall(handler, 'models', { sessionId: 'sess-1' }) + check(r.status === 404, 'B43 git.models 不由本插件处理(纯模型端点,交给上游)') + } +} finally { process.chdir(originalCwd) } + +// --------------------------------------------------------------------------- +// C. 接线与上游对拍 +// --------------------------------------------------------------------------- +console.log('\nC. 接线、文档与上游覆盖率') +const fsRouteArray = (() => { + const m = src.match(/\["fs\.tree",[^\]]*\]\.forEach/) + if (!m) throw new Error('fs route array not found') + return [...m[0].matchAll(/"(fs\.[a-zA-Z]+)"/g)].map((x) => x[1]) +})() +const gitMethods = (() => { + const m = src.match(/const GIT_METHODS = \[([^\]]+)\]/) + if (!m) throw new Error('GIT_METHODS not found') + return [...m[1].matchAll(/"([^"]+)"/g)].map((x) => x[1]) +})() +const NEED_FS = ['fs.createFile'] +const NEED_GIT = ['blame', 'diff-head', 'worktrees', 'pull', 'push'] +// 0.28.2 新增的 git.history(提交图超分支上限时的分页历史兜底)—— upstream-drift 2026-11-02 报红的那一项。 +// 远程工作区不接管它,客户端翻页时会拿本地镜像里的仓库列历史(与本文件 C 段防的是同一类静默失效)。 +const NEED_GIT_0282 = ['history'] +for (const m of NEED_FS) check(fsRouteArray.includes(m), 'C1 fs 路由注册了 0.25.0 新端点 ' + m) +for (const m of NEED_GIT) check(gitMethods.includes(m), 'C2 GIT_METHODS 注册了 0.25.0 新端点 git.' + m) +for (const m of NEED_GIT_0282) check(gitMethods.includes(m), 'C2b GIT_METHODS 注册了 0.28.2 新端点 git.' + m) +check(!gitMethods.includes('models') && !gitMethods.includes('suggest-message') && !gitMethods.includes('commit-model'), + 'C3 模型类端点(models / suggest-message / commit-model)**不**注册(它们不碰仓库路径,交给上游才对)') +check(!/function createWorkspaceFile\(/.test(src) && !/function assertCreatableFileName\(/.test(src) && + !/function parseBlamePorcelain\(output\) \{\s*const rows = \[\];\s*const seen = \/\* @__PURE__ \*\//.test(src), + 'C4 没有把上游实现整段抄进来(只按契约重写;上游函数名最多出现在注释里)') +check(/set -C; : > /.test(src), 'C5 远端建空文件用 noclobber 重定向(探测与创建之间的竞态不会清空别人的文件)') +check(src.indexOf('creatableFileNameProblem(fileName)') > 0, 'C6 远程分支同样做文件名校验(不把非法名发到远端)') +check(/result\.exists === true \? 409 : 400/.test(src), 'C7 "已存在"统一映射成 409(本地/远端、mkdir/createFile 一致)') + +// 与**实际安装的** better-sidebar 对拍(MAINTENANCE 硬规则的自动化) +const installed = (() => { + const base = join(homedir(), '.dsh', 'profiles') + if (!existsSync(base)) return null + for (const dir of readdirSync(base)) { + const p = join(base, dir, 'node_modules', 'dsh-better-sidebar') + if (existsSync(join(p, 'lib', 'index.js'))) { + return { version: JSON.parse(readFileSync(join(p, 'package.json'), 'utf8')).version, src: readFileSync(join(p, 'lib', 'index.js'), 'utf8') } + } + } + return null +})() +if (!installed) { + console.log(' · SKIP C8:本机没有安装 dsh-better-sidebar,跳过上游对拍(不算失败)') +} else { + const keys = [...new Set([...installed.src.matchAll(/"(fs|git)\.[a-zA-Z-]+"/g)].map((m) => m[0].slice(1, -1)))] + const fsKeys = keys.filter((k) => k.startsWith('fs.')) + const gitKeys = keys.filter((k) => k.startsWith('git.')) + const MODEL_ONLY = ['git.models', 'git.commit-model', 'git.suggest-message'] + const missingFs = fsKeys.filter((k) => !fsRouteArray.includes(k)) + const missingGit = gitKeys.filter((k) => !gitMethods.includes(k.slice(4)) && !MODEL_ONLY.includes(k)) + check(missingFs.length === 0, 'C8 对拍 better-sidebar@' + installed.version + ':所有 fs.* 端点都已接管(缺: ' + (missingFs.join(', ') || '无') + ')') + check(missingGit.length === 0, 'C9 对拍 better-sidebar@' + installed.version + ':所有与仓库相关的 git.* 端点都已接管(缺: ' + (missingGit.join(', ') || '无') + ')') + console.log(' · 对拍快照:fs ' + fsKeys.length + ' 个 / git ' + gitKeys.length + ' 个,其中模型类 3 个不接管') +} +check(new RegExp('## \\[' + pkg.version.replace(/\./g, '\\.') + '\\]').test(changelog), 'C10 CHANGELOG 有当前版本的条目(' + pkg.version + ')') +check(/0\.25\.0/.test(changelog), 'C11 CHANGELOG 记了这次升级到 0.25.0 的端点变化') + +// --------------------------------------------------------------------------- +// D. 语义差分对拍(把上游真实纯函数抽出来,同一批输入逐条比较) +// --------------------------------------------------------------------------- +// C8/C9 只保证「端点都注册了」,D 段保证「语义没走样」:文件名校验的接受/拒绝与拒绝文案、 +// isoWithOffset 的格式、blame porcelain 与 worktree 列表的解析、status 条目计数(对齐上游 +// parsePorcelainZ().length)。上游内部实现随版本变化,抽不到就 SKIP、不算失败。 +console.log('\nD. 语义差分对拍(vs 实际安装的 better-sidebar)') +function grabConst(text, marker, endMarker) { + const i = text.indexOf(marker) + if (i < 0) throw new Error('missing ' + marker) + const start = text.lastIndexOf('\n', i) + 1 + const j = text.indexOf(endMarker, i) + if (j < 0) throw new Error('missing end ' + endMarker) + return text.slice(start, j + endMarker.length) +} +function grabFnText(text, marker) { + const i = text.indexOf(marker) + if (i < 0) throw new Error('missing ' + marker) + const start = text.lastIndexOf('\n', i) + 1 + let depth = 0, k = text.indexOf('{', i) + for (; k < text.length; k++) { if (text[k] === '{') depth++; else if (text[k] === '}') { depth--; if (!depth) break } } + return text.slice(start, text.indexOf('\n', k)) +} +if (!installed) { + console.log(' · SKIP:本机没有安装 dsh-better-sidebar,跳过语义对拍(不算失败)') +} else { + let up = null + try { + up = new Function([ + 'class SidebarError extends Error { constructor(code, message, status = 400) { super(message); this.code = code; this.status = status } }', + grabConst(installed.src, 'const ILLEGAL_FILE_NAME_CHARS =', ';'), + grabFnText(installed.src, 'function firstIllegalNameChar('), + grabConst(installed.src, 'const RESERVED_FILE_NAMES =', ']);'), + // 0.26.1 起 assertCreatableFileName 把"单段名"检查拆给了 assertSingleSegmentName, + // 不一起抽进沙箱的话它对**每个**输入都抛 ReferenceError(看起来像"上游全部拒绝")。 + grabFnText(installed.src, 'function assertSingleSegmentName('), + grabFnText(installed.src, 'function assertCreatableFileName('), + grabFnText(installed.src, 'function isoWithOffset('), + grabFnText(installed.src, 'function parseBlamePorcelain('), + grabFnText(installed.src, 'function parseWorktreeList('), + 'return { assertCreatableFileName, isoWithOffset, parseBlamePorcelain, parseWorktreeList };' + ].join('\n'))() + } catch (e) { + console.log(' · SKIP:上游纯函数抽取失败(' + e.message + ')——升级后实现变了,人工看一眼') + } + if (up) { + let same = 0, diff = 0 + const cmp = (label, u, m) => { + if (JSON.stringify(u) === JSON.stringify(m)) { same++; return } + diff++ + console.log(' ✗ 与上游不一致 [' + label + '] 上游=' + JSON.stringify(u).slice(0, 90) + ' 本插件=' + JSON.stringify(m).slice(0, 90)) + } + const NAMES = ['readme.md', 'a', 'A.TXT', '.gitignore', '..hidden', '📁数据.txt', '中文 名.csv', + '', '.', '..', 'a/b', String.raw`a\b`, 'a= 60, 'D2 对拍覆盖足够多的输入(' + same + ' 项 ≥ 60)') + } +} + +try { rmSync(hostDir, { recursive: true, force: true }) } catch (e) {} +try { rmSync(sessionDir, { recursive: true, force: true }) } catch (e) {} + +console.log('\n结果: ' + pass + ' 通过, ' + fail + ' 失败') +process.exit(fail ? 1 : 0)