From 2751812fb8f7d18438ec9b64ad30fffc8a3b529b Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 22:40:00 +0800 Subject: [PATCH] Import vendor/dsh-remote-ssh/tests/sidebar-0280-git-graph.test.mjs --- .../tests/sidebar-0280-git-graph.test.mjs | 508 ++++++++++++++++++ 1 file changed, 508 insertions(+) create mode 100644 vendor/dsh-remote-ssh/tests/sidebar-0280-git-graph.test.mjs diff --git a/vendor/dsh-remote-ssh/tests/sidebar-0280-git-graph.test.mjs b/vendor/dsh-remote-ssh/tests/sidebar-0280-git-graph.test.mjs new file mode 100644 index 0000000..e681407 --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/sidebar-0280-git-graph.test.mjs @@ -0,0 +1,508 @@ +/** + * better-sidebar 0.28.0 新增端点 `git.graph`(提交图分页)的接管 —— 本插件 2.4.32。 + * + * 为什么必须有这个文件:0.28.0 给 Git 面板加了 `git.graph`,本插件此前只接管到 0.25.0 + * 那一批端点,于是**远程工作区**里客户端会拿本地镜像里的仓库画提交图(与 2.4.18 / 2.4.28 + * 同源的 bug 类:没被拦截的端点静默作用在镜像上)。 + * + * 覆盖: + * A. 上游契约(校验、分页、游标、过期、上限、错误码 → HTTP 码) + * B. 本地分支(假 git,逐条断言实参与返回形状) + * C. 远端分支(必须只发远端、每次分页 2 次 SSH 往返、根路径映射回镜像) + * D. 真实临时 git 仓库端到端(真 git 输出,防"只对着假夹具自证") + */ +import { readFileSync, mkdtempSync, rmSync, writeFileSync, realpathSync } from 'node:fs' +import { spawnSync } from 'node:child_process' +import { createHash } from 'node:crypto' +import { tmpdir } from 'node:os' +import { join } from 'node:path' +import { fileURLToPath } from 'node:url' + +const root = fileURLToPath(new URL('..', import.meta.url)) +const src = readFileSync(root + '/lib/index.js', 'utf8') + +let pass = 0, fail = 0 +const check = (cond, label) => { if (cond) { pass++; console.log(' ✓ ' + label) } else { fail++; console.log(' ✗ FAIL: ' + label) } } + +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) +} + +// 2.4.30(issue #26)的路径判定 helper:sessionCwdFrom 需要它们 +const PATH_HELPERS = [ + grab(src, 'function isAbsoluteLocalPath'), + grab(src, 'function classifyRequestPathSyntax'), + grab(src, 'function looksLikeRemoteAbsolutePath'), + grab(src, 'function resolveSessionPath'), + grab(src, 'function unresolvedPathMessage') +].join('\n') + +// git.graph 整段(含纯函数、本地 io、远端 io、镜像根映射) +const GRAPH_BLOCK = (() => { + const a = src.indexOf('// ---- better-sidebar 0.28.0 新增 git.graph') + const b = src.indexOf(' async function interceptGitHandler') + if (a < 0 || b < 0 || b <= a) throw new Error('lib/index.js 里找不到 git.graph 实现段(标记被改动?)') + return src.slice(a, b) +})() + +// 模块级共享件(0.28.0 这一批接管共用):只读环境常量与原样取出,避免测试里复制一份走样。 +const GIT_READ_ENV = (() => { + const m = /const GIT_READ_ENV = "([^"]+)"/.exec(src) + if (!m) throw new Error('lib/index.js 里找不到 GIT_READ_ENV') + return m[1] +})() + +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() { + return { status: 0, body: undefined, raw: undefined, writeHead(s) { this.status = s; return this }, end() { return this }, setHeader() { return this } } +} +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 HOST = '' +const USER = '' +const KEY = '' +const REMOTE_ROOT = '/remote/root' +const M = '@@DSH_GG@@' +const OID1 = '1'.repeat(40) +const OID2 = '2'.repeat(40) +const OID3 = '3'.repeat(40) + +/** + * 沙箱:只装 git.graph 相关源码 + interceptGitHandler,git 执行与远端执行全部由外部提供。 + * localRun(dir,args) / pooled(profile,cmd) 分别模拟本机 git 与远端一次 SSH 往返。 + */ +function graphSandbox(opts) { + const rec = { local: [], remote: [] } + const remote = !!opts.remote + const localResponses = opts.localResponses || {} + const localRun = opts.localRun || (async (dir, args) => { + rec.local.push(args.join(' ')) + const key = args.filter((a) => a !== '--no-replace-objects').join(' ') + if (localResponses[key] === undefined) return '' + const v = localResponses[key] + if (v instanceof Error) throw v + return v + }) + const remoteScripts = opts.remoteScripts || [] + const pooled = async (profile, cmd) => { + rec.remote.push(cmd) + const i = rec.remote.length - 1 + if (remoteScripts[i] === undefined) return { ok: true, stdout: '', stderr: '' } + const v = remoteScripts[i] + if (v instanceof Error) throw v + if (v && v.ok === false) return { ok: false, stdout: '', stderr: '', error: v.error || 'boom', exitCode: 128 } + return { ok: true, stdout: v, stderr: '' } + } + const handler = new Function( + 'join', 'createHash', 'ctx', 'requestTrust', 'denyRequest', 'writeJson', 'writeOk', 'readJsonBody', + 'runGitLocal', 'runPooled', 'GIT_READ_ENV', + 'matchRemoteWorkspace', 'readRemoteInfoSync', 'getProfile', 'localToRemote', + PATH_HELPERS + '\n' + + grab(src, 'function gitReplyFail') + '\n' + + grab(src, 'function shellQuote') + '\n' + + grab(src, 'function shellQuotePath') + '\n' + + grab(src, 'function sessionCwdFrom') + '\n' + + grab(src, 'function gitContextOf') + '\n' + + GRAPH_BLOCK + '\n' + + grab(src, 'async function interceptGitHandler') + '\n' + + 'return interceptGitHandler;' + )( + join, createHash, makeCtx(opts.sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, + localRun, pooled, GIT_READ_ENV, + remote ? () => ({ mirrorPath: opts.sessionDir }) : () => null, + remote ? (p) => (typeof p === 'string' && p.indexOf(opts.sessionDir) === 0 + ? { profileId: 'p1', host: HOST, user: USER, keyPath: KEY, remotePath: REMOTE_ROOT, mirrorPath: opts.sessionDir } : null) : () => null, + () => ({ id: 'p1', host: HOST, user: USER, keyPath: KEY }), + (local, mirror, remoteRoot) => String(remoteRoot) + String(local).replace(/\\/g, '/').slice(String(mirror).replace(/\\/g, '/').length) + ) + return { handler: handler, rec: rec } +} + +const call = async (handler, payload) => { + const res = makeRes() + await handler({ method: 'POST', headers: {}, __body: payload }, res, 'graph') + return res +} + +// --------------------------------------------------------------------------- +// 夹具 +// --------------------------------------------------------------------------- +const REFS = ['refs/heads/main\u0000' + OID1, 'refs/heads/feature\u0000' + OID2, 'refs/remotes/origin/main\u0000' + OID1].join('\n') + '\n' +const REFS_OTHER = ['refs/heads/main\u0000' + OID3, 'refs/remotes/origin/main\u0000' + OID3].join('\n') + '\n' +/** git log --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 的输出形状 */ +const logOut = (rows) => rows.map((r) => [r.h, r.p, r.an, r.ai, r.s, r.b].join('\u0000') + '\u0000').join('\n') + '\n' +const TWO_COMMITS = logOut([ + { h: OID1, p: OID2, an: 'Alice', ai: '2026-10-17 10:00:00 +0800', s: 'second commit', b: 'second commit\n\nbody two\n' }, + { h: OID2, p: '', an: 'Bob', ai: '2026-10-16 09:00:00 +0800', s: 'first commit', b: 'first commit\n' } +]) +/** 远端第一次往返:toplevel + 前后快照 */ +const remoteBegin = (repoRoot, refs, head, sym) => [M + ' ROOT ' + repoRoot, M + ' REFS', refs.trimEnd(), M + ' HEAD', head, '', M + ' SYM', sym, '', M + ' END'].join('\n') + '\n' +/** 远端第二次往返:log + 快照 */ +const remoteLog = (log, refs, head, sym) => [M + ' LOG', String(log).trimEnd(), '', M + ' REFS', refs.trimEnd(), M + ' HEAD', head, '', M + ' SYM', sym, '', M + ' END'].join('\n') + '\n' + +const ROOT_LOCAL = process.platform === 'win32' ? 'C:/work/repo' : '/work/repo' + +// --------------------------------------------------------------------------- +console.log('\nA. 本地分支(假 git):契约与校验') +// --------------------------------------------------------------------------- +const keepDir = mkdtempSync(join(tmpdir(), 'dsh-graph-a-')) +try { + const okLocal = { + 'rev-parse --show-toplevel': ROOT_LOCAL, + 'for-each-ref --sort=refname --format=%(refname)%00%(objectname) refs/heads/ refs/remotes/': REFS, + 'rev-parse --verify --quiet HEAD': OID1 + '\n', + 'symbolic-ref --quiet HEAD': 'refs/heads/main\n' + } + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { + ['log --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=51 --skip=0 --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 ' + OID1 + ' ' + OID2 + ' --']: TWO_COMMITS + }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.ok === true, 'A1 正常分页 → 200') + const v = r.body.value + check(v.isRepo === true && v.root === ROOT_LOCAL, 'A2 isRepo + root = git rev-parse --show-toplevel') + check(Array.isArray(v.entries) && v.entries.length === 2, 'A3 解析出 2 条提交') + check(v.entries[0].hash === OID1.slice(0, 7) && v.entries[0].hashFull === OID1, 'A4 hash 取 7 位、hashFull 完整') + check(v.entries[0].parents.length === 1 && v.entries[0].parents[0] === OID2, 'A5 parents 解析正确') + check(v.entries[0].author === 'Alice' && v.entries[0].subject === 'second commit' && v.entries[0].date === '2026-10-17 10:00:00 +0800', + 'A6 author/subject/date 逐字段对齐 %an/%s/%ai') + check(v.entries[0].message.indexOf('body two') > 0, 'A7 message 保留完整 %B') + check(v.entries[0].refs.indexOf('HEAD') >= 0 && v.entries[0].refs.indexOf('main') >= 0 && v.entries[0].refs.indexOf('origin/main') >= 0, + 'A8 refs 装饰含 HEAD + 本地分支 + 远端跟踪分支') + check(v.entries[1].parents.length === 0 && v.entries[1].refs.length === 1 && v.entries[1].refs[0] === 'feature', + 'A9 根提交无 parents;它的装饰只有 feature(OID2 正是 feature 的 tip)') + check(v.branches.length === 3 && v.branches[2].ref === 'refs/remotes/origin/main' && v.branches[2].name === 'origin/main', + 'A10 branches 保序(--sort=refname)且 name 去掉 refs/ 前缀') + check(/^[a-f0-9]{64}$/.test(v.snapshot), 'A11 snapshot 是 sha256 十六进制(游标校验要求 64 位)') + check(v.hasMore === false && v.nextCursor === undefined, 'A12 一页装得下 → hasMore=false 且无 nextCursor') + check(rec.local.length === 8, 'A13 本机路径共 8 次 git 调用(toplevel + 前后各一次 refs/HEAD/symbolic-ref + log)') + check(rec.local.every((c) => c.indexOf('--no-replace-objects') >= 0 || c === 'rev-parse --show-toplevel'), 'A14 只读命令都带 --no-replace-objects') + } + + // 分页 + 游标:上游取 limit+1 条来判断 hasMore,所以 count=1 时夹具要回 2 条 + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { + ['log --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=2 --skip=0 --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 ' + OID1 + ' ' + OID2 + ' --']: TWO_COMMITS + }) }) + const r = await call(handler, { sessionId: 'sess-1', count: 1 }) + const v = r.body.value + check(r.status === 200 && v.entries.length === 1 && v.hasMore === true, 'A15 count=1 + limit+1 条 → 截到 1 条且 hasMore=true') + check(typeof v.nextCursor === 'string' && /^[A-Za-z0-9_-]+$/.test(v.nextCursor), 'A16 nextCursor 是 base64url') + const cur = JSON.parse(Buffer.from(v.nextCursor, 'base64url').toString('utf8')) + check(cur.version === 1 && cur.offset === 1 && cur.fingerprint === v.snapshot, 'A17 游标内容 = {version:1, fingerprint=snapshot, offset=limit}') + check(rec.local.filter((c) => c.indexOf('--skip=') >= 0)[0].indexOf('--skip=0') > 0, 'A18 首页 --skip=0') + } + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { + ['log --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=2 --skip=1 --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 ' + OID1 + ' ' + OID2 + ' --']: logOut([ + { h: OID2, p: '', an: 'Bob', ai: '2026-10-16 09:00:00 +0800', s: 'first commit', b: 'first commit\n' } + ]) + }) }) + const cur = Buffer.from(JSON.stringify({ version: 1, fingerprint: createHash('sha256').update(JSON.stringify({ + root: ROOT_LOCAL, + branch: undefined, + branches: [ + { ref: 'refs/heads/main', name: 'main', hashFull: OID1 }, + { ref: 'refs/heads/feature', name: 'feature', hashFull: OID2 }, + { ref: 'refs/remotes/origin/main', name: 'origin/main', hashFull: OID1 } + ], + head: OID1, + symbolicHead: 'refs/heads/main' + })).digest('hex'), offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', count: 1, cursor: cur }) + check(r.status === 200 && r.body.value.entries[0].hash === OID2.slice(0, 7), 'A19 指纹匹配的游标 → 第二页拿更老的提交') + check(rec.local.some((c) => c.indexOf('--skip=1') > 0), 'A20 第二页 --skip=游标 offset') + } + + // 过期游标:指纹不匹配 → 409,且**不跑 log** + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: okLocal }) + const cur = Buffer.from(JSON.stringify({ version: 1, fingerprint: 'f'.repeat(64), offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', cursor: cur }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'A21 指纹不匹配 → 409 graph-stale(上游口径)') + check(!rec.local.some((c) => c.indexOf('log --topo') >= 0), 'A22 过期游标不会跑 git log(先比指纹)') + } + + // 分支过滤 + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { + ['log --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=51 --skip=0 --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 ' + OID2 + ' --']: logOut([ + { h: OID2, p: '', an: 'Bob', ai: '2026-10-16 09:00:00 +0800', s: 'first commit', b: 'first commit\n' } + ]) + }) }) + const r = await call(handler, { sessionId: 'sess-1', branch: 'refs/heads/feature' }) + check(r.status === 200 && r.body.value.branches.length === 3, 'A23 指定分支仍返回全部分支列表(上游行为)') + check(rec.local.some((c) => c.indexOf('log --topo') >= 0 && c.indexOf(OID1) < 0), 'A24 指定分支时 log 只喂该分支 tip(不含 main 的 tip)') + } + + // 校验失败 + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: okLocal }) + const cases = [ + [{ sessionId: 'sess-1', branch: 'main' }, 'A25 branch 必须是 refs/heads|remotes 全名 → 400'], + [{ sessionId: 'sess-1', count: 0 }, 'A26 count=0 → 400'], + [{ sessionId: 'sess-1', count: 1.5 }, 'A27 count 非整数 → 400'], + [{ sessionId: 'sess-1', count: '10' }, 'A28 count 非数字 → 400'], + [{ sessionId: 'sess-1', cursor: '!!!' }, 'A29 游标字符集非法 → 400'], + [{ sessionId: 'sess-1', cursor: Buffer.from(JSON.stringify({ version: 2, fingerprint: 'a'.repeat(64), offset: 1 })).toString('base64url') }, 'A30 游标 version≠1 → 400'], + [{ sessionId: 'sess-1', cursor: Buffer.from(JSON.stringify({ version: 1, fingerprint: 'a'.repeat(64), offset: 0 })).toString('base64url') }, 'A31 游标 offset<1 → 400'], + [{ sessionId: 'sess-1', cursor: Buffer.from('not json').toString('base64url') }, 'A32 游标不是 JSON → 400'] + ] + for (const [payload, label] of cases) { + const r = await call(handler, payload) + check(r.status === 400 && r.body.error.code === 'bad-request' && /graph cursor|Invalid graph|full local or remote-tracking ref|Invalid graph count/.test(r.body.error.message), label) + } + check(rec.local.length === 0, 'A33 参数校验失败时不跑任何 git(校验在取快照之前)') + } + + // 未知分支 / 上限 / 非法 OID / HEAD 解析失败 + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: okLocal }) + const r = await call(handler, { sessionId: 'sess-1', branch: 'refs/heads/nope' }) + check(r.status === 400 && /Unknown graph branch/.test(r.body.error.message), 'A34 分支不存在 → 400 Unknown graph branch') + check(!rec.local.some((c) => c.indexOf('log --topo') >= 0), 'A35 分支不存在时不跑 log') + } + { + const many = Array.from({ length: 1001 }, (_, i) => 'refs/heads/b' + i + '\u0000' + OID1).join('\n') + '\n' + const { handler } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { 'for-each-ref --sort=refname --format=%(refname)%00%(objectname) refs/heads/ refs/remotes/': many }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 400 && r.body.error.code === 'graph-limit' && /Too many branches/.test(r.body.error.message), 'A36 分支 >1000 → 400 graph-limit') + } + { + const badRefs = 'refs/heads/main\u0000not-a-hash\n' + const { handler } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { 'for-each-ref --sort=refname --format=%(refname)%00%(objectname) refs/heads/ refs/remotes/': badRefs }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 500 && r.body.error.code === 'git-error', 'A37 refs 输出里不是 OID → 500 git-error(上游 fail 语义)') + } + { + const { handler } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { 'rev-parse --verify --quiet HEAD': '', 'symbolic-ref --quiet HEAD': '' }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 500 && r.body.error.code === 'git-error' && /Cannot resolve HEAD/.test(r.body.error.message), + 'A38 解不出 HEAD → 500 git-error(上游这个 fail 传的是 git-error,不是 bad-request)') + } + + // 空仓库:isRepo=true、空页、不跑 log + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir, localResponses: { + 'rev-parse --show-toplevel': ROOT_LOCAL, + 'for-each-ref --sort=refname --format=%(refname)%00%(objectname) refs/heads/ refs/remotes/': '', + 'rev-parse --verify --quiet HEAD': '', + 'symbolic-ref --quiet HEAD': 'refs/heads/main\n' + } }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.value.isRepo === true && r.body.value.entries.length === 0 && r.body.value.branches.length === 0 && r.body.value.hasMore === false, + 'A39 空仓库(无提交)→ isRepo=true + 空页') + check(!rec.local.some((c) => c.indexOf('log --topo') >= 0), 'A40 空仓库不跑 git log(上游 tips 为空即跳过)') + } + + // 不是仓库 + { + const { handler } = graphSandbox({ sessionDir: keepDir, localResponses: { + 'rev-parse --show-toplevel': new Error('fatal: not a git repository (or any of the parent directories): .git') + } }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.value.isRepo === false && r.body.value.entries.length === 0 && r.body.value.snapshot === '', + 'A41 非仓库 → {isRepo:false, entries:[], branches:[], hasMore:false, snapshot:""}') + const cur = Buffer.from(JSON.stringify({ version: 1, fingerprint: 'a'.repeat(64), offset: 1 })).toString('base64url') + const r2 = await call(handler, { sessionId: 'sess-1', cursor: cur }) + check(r2.status === 409 && r2.body.error.code === 'graph-stale', 'A42 带游标却不是仓库 → 409(上游 graph-stale)') + } + + // 翻页越过 10000 上限:offset=10000 + limit=1 → 10001 > 10000 + { + const rows = Array.from({ length: 2 }, () => ({ h: OID1, p: '', an: 'A', ai: 'x', s: 's', b: 'b' })) + const { handler } = graphSandbox({ sessionDir: keepDir, localResponses: Object.assign({}, okLocal, { + ['log --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=2 --skip=10000 --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 ' + OID1 + ' ' + OID2 + ' --']: logOut(rows) + }) }) + const first = await call(handler, { sessionId: 'sess-1' }) + const realCur = Buffer.from(JSON.stringify({ version: 1, fingerprint: first.body.value.snapshot, offset: 10000 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', count: 1, cursor: realCur }) + check(r.status === 400 && r.body.error.code === 'graph-limit' && /history limit reached/.test(r.body.error.message), + 'A43 offset+limit 越过 10000 → 400 graph-limit') + } +} finally { + rmSync(keepDir, { recursive: true, force: true }) +} + +// --------------------------------------------------------------------------- +console.log('\nB. 远端分支(假 SSH):命令只发远端 + 两次往返 + 根路径回映射') +// --------------------------------------------------------------------------- +const keepDir2 = mkdtempSync(join(tmpdir(), 'dsh-graph-b-')) +try { + { + const { handler, rec } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT, REFS, OID1, 'refs/heads/main'), + remoteLog(TWO_COMMITS, REFS, OID1, 'refs/heads/main') + ] }) + const r = await call(handler, { sessionId: 'sess-1' }) + const v = r.body.value + check(r.status === 200 && v.isRepo === true && v.entries.length === 2, 'B1 远端分页 → 200 + 2 条提交') + check(rec.remote.length === 2, 'B2 一次分页只花 2 次 SSH 往返(toplevel+快照、log+快照)') + check(v.root === keepDir2, 'B3 root 回映射成本地镜像路径(客户端把它当 repoRoot 比较用)') + check(rec.remote[0].indexOf("cd '" + REMOTE_ROOT + "'") > 0, 'B4 第一条命令先 cd 到远端会话目录(带引号防注入)') + check(rec.remote[0].indexOf('--no-replace-objects') > 0 && rec.remote[0].indexOf('rev-parse --show-toplevel') > 0, 'B5 远端 toplevel 用只读口径') + // 远端目录不在 → 脚本自己报 NOREPO(真环境下是 isRepo=false,不是 500) + check(/cd '[^']*' 2>\/dev\/null \|\| \{ printf '[^']* NOREPO/.test(rec.remote[0]), + 'B5b 远端目录 cd 失败 → 脚本内直接给 NOREPO(真环境验证见 verify-remote-sh.mjs D4)') + check(rec.remote[0].indexOf('export LC_ALL=C GIT_OPTIONAL_LOCKS=0 GIT_TERMINAL_PROMPT=0 GIT_NO_LAZY_FETCH=1') >= 0, + 'B6 远端命令带上游同款只读环境(禁惰性抓取/终端提示)') + check(rec.remote[0].indexOf('for-each-ref --sort=refname') > 0 && rec.remote[1].indexOf('for-each-ref --sort=refname') > 0, + 'B7 前后各取一次 refs 快照(指纹用于过期检测)') + check(rec.remote[1].indexOf('--max-count=51') > 0 && rec.remote[1].indexOf('--skip=0') > 0, 'B8 log 参数默认 count=50(max-count=limit+1)') + check(rec.remote[1].indexOf('--format=') > 0 && rec.remote[1].indexOf('%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00') > 0, 'B9 log 用上游同款 --format') + check(rec.remote[1].indexOf(OID1) > 0 && rec.remote[1].indexOf(OID2) > 0 && rec.remote[1].indexOf("'--'") > 0, + 'B10 log 只喂快照算出的 tips,并以 -- 收尾') + check(rec.remote.every((c) => c.indexOf('/sidebar/') < 0 && c.indexOf('git -C') > 0), 'B11 所有命令都是远端 git(没有本机 git 调用)') + check(v.entries[0].refs.indexOf('HEAD') >= 0, 'B12 远端装饰同样来自远端 refs') + } + + // 远端仓库根在工作区之下(子目录) + { + const { handler } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT + '/sub', REFS, OID1, 'refs/heads/main'), + remoteLog(TWO_COMMITS, REFS, OID1, 'refs/heads/main') + ] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.body.value.root === join(keepDir2, 'sub'), 'B13 远端仓库根在子目录 → 映射成镜像子目录') + } + + // 远端仓库根在工作区之上(工作区是仓库子目录) + { + const { handler } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin('/remote', REFS, OID1, 'refs/heads/main'), + remoteLog(TWO_COMMITS, REFS, OID1, 'refs/heads/main') + ] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.body.value.root === keepDir2, 'B14 远端仓库根在工作区之上 → 退化成镜像根(保证仍是本机路径且跨页稳定)') + } + + // 远端不是仓库 / 远端失败 / 远端过期 + { + const { handler } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [M + ' NOREPO\n'] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.value.isRepo === false, 'B15 远端不是仓库(NOREPO 标记)→ isRepo=false') + } + { + const { handler } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [M + ' NOREPO\n'] }) + const cur = Buffer.from(JSON.stringify({ version: 1, fingerprint: 'b'.repeat(64), offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', cursor: cur }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'B16 远端不是仓库 + 游标 → 409') + } + { + const { handler } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [{ ok: false, error: 'ssh: connect failed' }] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 500 && r.body.error.code === 'git-error' && /connect failed/.test(r.body.error.message), 'B17 远端命令失败 → 500 git-error(带远端错误文本)') + } + { + const { handler } = graphSandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT, REFS, OID1, 'refs/heads/main'), + remoteLog(TWO_COMMITS, REFS_OTHER, OID3, 'refs/heads/main') + ] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'B18 远端前后快照不一致(分页期间仓库变了)→ 409') + } +} finally { + rmSync(keepDir2, { recursive: true, force: true }) +} + +// --------------------------------------------------------------------------- +console.log('\nC. 真实临时 git 仓库端到端(真 git 输出)') +// --------------------------------------------------------------------------- +const realRepo = mkdtempSync(join(tmpdir(), 'dsh-graph-real-')) +const realEmpty = mkdtempSync(join(tmpdir(), 'dsh-graph-empty-')) +const git = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 }) +/** Windows 下 os.tmpdir() 可能是 8.3 短路径(ADMINI~1),git 返回长路径 —— 比对前先归一。 */ +const canonPath = (p) => { + try { return realpathSync.native(String(p)).replace(/\\/g, '/').toLowerCase() } catch (e) { return String(p).replace(/\\/g, '/').toLowerCase() } +} +const realLocalRun = async (dir, args) => { + const r = git(dir, args) + if (r.status !== 0) throw { code: 'git-error', message: String(r.stderr || r.stdout || '').trim() || ('git exited ' + r.status) } + return r.stdout +} +try { + const haveGit = git(realRepo, ['--version']).status === 0 + if (!haveGit) { + console.log(' · SKIP:本机没有 git,跳过真实仓库端到端(不算失败)') + } else { + git(realRepo, ['init', '-q']) + git(realRepo, ['symbolic-ref', 'HEAD', 'refs/heads/main']) + const commit = (file, content, msg) => { + writeFileSync(join(realRepo, file), content) + git(realRepo, ['-c', 'user.name=T', '-c', 'user.email=t@example.com', 'add', '-A']) + git(realRepo, ['-c', 'user.name=T', '-c', 'user.email=t@example.com', 'commit', '-q', '-m', msg]) + } + commit('a.txt', 'one\n', 'first commit') + commit('a.txt', 'one\ntwo\n', 'second commit') + + const { handler } = graphSandbox({ sessionDir: realRepo, remote: false, localRun: realLocalRun }) + const r = await call(handler, { sessionId: 'sess-1', count: 10 }) + const v = r.body.value + check(r.status === 200 && v.isRepo === true, 'C1 真仓库 → 200 且 isRepo=true') + check(v.entries.length === 2, 'C2 真 git log 解析出 2 条(验证 %x00 分隔与字段顺序)') + check(v.entries[0].subject === 'second commit' && v.entries[0].author === 'T', 'C3 首条 subject/author 正确') + check(/^[0-9a-f]{40}$/.test(v.entries[0].hashFull) && v.entries[0].hash === v.entries[0].hashFull.slice(0, 7), 'C4 hash/hashFull 关系正确') + check(v.entries[0].parents.length === 1 && v.entries[0].parents[0] === v.entries[1].hashFull, 'C5 第二条的 hashFull 是首条的 parent(拓扑正确)') + check(v.entries[0].refs.indexOf('HEAD') >= 0 && v.entries[0].refs.indexOf('main') >= 0, 'C6 HEAD 与分支装饰来自真实 for-each-ref') + check(v.entries[1].parents.length === 0, 'C7 根提交无 parent') + check(v.entries[0].message.indexOf('second commit') >= 0, 'C8 %B 完整消息') + check(/^[a-f0-9]{64}$/.test(v.snapshot) && v.hasMore === false, 'C9 真指纹 + 一页装得下') + check(v.branches.some((b) => b.ref === 'refs/heads/main' && b.name === 'main'), 'C10 真实分支列表') + check(canonPath(v.root) === canonPath(realRepo), 'C11 root = 真实仓库根(Windows 短路径 ADMINI~1 也归一)') + + const p1 = await call(handler, { sessionId: 'sess-1', count: 1 }) + check(p1.body.value.entries.length === 1 && p1.body.value.hasMore === true && typeof p1.body.value.nextCursor === 'string', + 'C12 count=1 → hasMore + nextCursor(真分页)') + const p2 = await call(handler, { sessionId: 'sess-1', count: 1, cursor: p1.body.value.nextCursor }) + check(p2.status === 200 && p2.body.value.entries[0].subject === 'first commit', 'C13 第二页用游标拿到更老的提交(真实分页闭环)') + check(p2.body.value.snapshot === p1.body.value.snapshot, 'C14 未变更时两页指纹一致') + + // 真·过期:游标之后仓库多了一个提交 + commit('b.txt', 'x\n', 'third commit') + const stale = await call(handler, { sessionId: 'sess-1', count: 1, cursor: p1.body.value.nextCursor }) + check(stale.status === 409 && stale.body.error.code === 'graph-stale', 'C15 游标之后仓库变了 → 409(真实过期检测)') + + // 指定分支(refs/heads/main 全名) + const byBranch = await call(handler, { sessionId: 'sess-1', branch: 'refs/heads/main', count: 5 }) + check(byBranch.status === 200 && byBranch.body.value.entries.length === 3, 'C16 指定 refs/heads/main → 3 条提交') + + // 空仓库(init 但无提交) + git(realEmpty, ['init', '-q']) + const { handler: h2 } = graphSandbox({ sessionDir: realEmpty, remote: false, localRun: realLocalRun }) + const e = await call(h2, { sessionId: 'sess-1' }) + check(e.status === 200 && e.body.value.isRepo === true && e.body.value.entries.length === 0 && e.body.value.branches.length === 0, + 'C17 真空仓库 → isRepo=true + 空页(不报错)') + + // 非仓库目录 + const notRepo = mkdtempSync(join(tmpdir(), 'dsh-graph-norepo-')) + try { + const { handler: h3 } = graphSandbox({ sessionDir: notRepo, remote: false, localRun: realLocalRun }) + const n = await call(h3, { sessionId: 'sess-1' }) + check(n.status === 200 && n.body.value.isRepo === false, 'C18 真·非仓库目录 → isRepo=false(识别 git 的 fatal 文案)') + } finally { + rmSync(notRepo, { recursive: true, force: true }) + } + } +} finally { + rmSync(realRepo, { recursive: true, force: true }) + rmSync(realEmpty, { recursive: true, force: true }) +} + +console.log('\n结果: ' + pass + ' 通过, ' + fail + ' 失败') +process.exit(fail === 0 ? 0 : 1)