diff --git a/vendor/dsh-remote-ssh/tests/sidebar-0282-history.test.mjs b/vendor/dsh-remote-ssh/tests/sidebar-0282-history.test.mjs new file mode 100644 index 0000000..3929ba0 --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/sidebar-0282-history.test.mjs @@ -0,0 +1,568 @@ +/** + * better-sidebar 0.28.2 新增端点 `git.history`(提交图超分支上限时的分页历史兜底)的接管 —— 本插件 2.4.42。 + * + * 为什么必须有这个文件:upstream-drift 流水线(每周一对拍上游 @latest)在 2026-11-02 报红 —— + * 上游 0.28.2 多了 `git.history`,本插件只接管到 0.28.0 的 `git.graph`,于是**远程工作区**里客户端 + * 在提交图分支数超上限、回落到 history 翻页时,会拿本地镜像里的仓库列历史(与 2.4.32 的 git.graph、 + * 2.4.28 的 0.25.0 一批端点同源的静默失效)。 + * + * 上游口径(0.28.2 lib/index.js 的 gitHistory): + * · 入参 { count = 50, cursor? };count 安全整数 ≥1,内部上限 200;cursor = base64url(JSON{version:1,fingerprint,offset})。 + * · 返回 { isRepo, root, entries[{hash,hashFull,parents,author,date,subject,message,refs:[]}], hasMore, snapshot, nextCursor? }。 + * · 前后各取一次「全量 refs + HEAD + shallow 边界」快照算 sha256;期间变了 → graph-stale(409); + * refs > 100000 / shallow > 1 MiB / 翻页越过 10000 → graph-limit(400)。 + * + * 覆盖: + * A. 本地分支(假 git):契约、参数形状、快照指纹、分页游标、全部错误码 + * B. 远端分支(假 SSH):每页 2 次往返、脚本标记、根路径回映射、NOREPO / 过期 / 超限 / 失败 + * C. 真实临时 git 仓库端到端(真 git 输出,防"只对着假夹具自证") + * D. 接线与上游对拍(GIT_METHODS 含 history、分发走 gitHistoryPage、与已装上游 handler 键集合对拍) + */ +import { readFileSync, mkdtempSync, rmSync, writeFileSync, realpathSync, mkdirSync } from 'node:fs' +import { stat as statAsync, readFile as readFileAsync } from 'node:fs/promises' +import { spawnSync } from 'node:child_process' +import { createHash } from 'node:crypto' +import { tmpdir, homedir } from 'node:os' +import { join, resolve as resolvePath } from 'node:path' +import { existsSync, readdirSync } from 'node:fs' +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 + git.history 两段(history 段插在 graph 段之后、interceptGitHandler 之前, +// 且复用 graph 段的 OID/分页常量与日志解析器,所以整段一起装进沙箱) +const GIT_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/git.history 实现段(标记被改动?)') + return src.slice(a, b) +})() +if (GIT_BLOCK.indexOf('// ---- better-sidebar 0.28.2 新增 git.history') < 0) { + throw new Error('git.history 实现段不在 graph 段与 interceptGitHandler 之间(测试切片假设被破坏)') +} + +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, 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_GH@@' +const OID1 = '1'.repeat(40) +const OID2 = '2'.repeat(40) +const OID3 = '3'.repeat(40) + +/** + * 沙箱:装 graph/history 两段源码 + interceptGitHandler,git 与远端执行全部外部提供。 + * localRun(dir,args) / pooled(profile,cmd) 分别模拟本机 git 与远端一次 SSH 往返。 + */ +function historySandbox(opts) { + const rec = { local: [], localRaw: [], remote: [] } + const remote = !!opts.remote + const table = opts.localResponses || {} + const localRun = opts.localRun || (async (dir, args) => { + const key = args.filter((a) => a !== '--no-replace-objects').join(' ') + rec.local.push(key) + rec.localRaw.push(args.join(' ')) + if (table[key] === undefined) return '' + const v = typeof table[key] === 'function' ? table[key]() : table[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', + 'stat', 'readFile', 'resolvePath', + 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' + + GIT_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), + statAsync, readFileAsync, resolvePath + ) + return { handler, rec } +} + +const call = async (handler, payload) => { + const res = makeRes() + await handler({ method: 'POST', headers: {}, __body: payload }, res, 'history') + return res +} + +// --------------------------------------------------------------------------- +// 夹具 +// --------------------------------------------------------------------------- +const REFS_ALL = ['refs/heads/main\u0000' + OID1, 'refs/heads/feature\u0000' + OID2, + 'refs/remotes/origin/main\u0000' + OID1, 'refs/tags/v1\u0000' + OID2].join('\n') + '\n' +const REFS_ALL_OTHER = REFS_ALL + 'refs/heads/new\u0000' + OID3 + '\n' +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' } +]) +const LOG_ARGS = (maxCount, skip) => 'log --branches --remotes HEAD --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=' + maxCount + ' --skip=' + skip + ' --format=%H%x00%P%x00%an%x00%ai%x00%s%x00%B%x00 --' +const SNAP_CMDS = ['for-each-ref --sort=refname --format=%(refname)%00%(objectname)', 'rev-parse --verify --quiet HEAD', 'rev-parse --git-path shallow'] +const ROOT_LOCAL = process.platform === 'win32' ? 'C:/work/repo' : '/work/repo' + +/** 本地一次完整请求的 8 次 git 调用(toplevel + 快照 + log + 快照) */ +const localFixture = (extra) => Object.assign({ + 'rev-parse --show-toplevel': ROOT_LOCAL, + [SNAP_CMDS[0]]: REFS_ALL, + [SNAP_CMDS[1]]: OID1 + '\n', + [SNAP_CMDS[2]]: '.git/shallow' +}, extra || {}) + +// --------------------------------------------------------------------------- +console.log('\nA. 本地分支(假 git):契约、参数、指纹、分页、错误码') +// --------------------------------------------------------------------------- +const keepDir = mkdtempSync(join(tmpdir(), 'dsh-history-a-')) +try { + { + const { handler, rec } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(51, 0)]: TWO_COMMITS }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + const v = r.body.value + check(r.status === 200 && r.body.ok === true, 'A1 正常首页 → 200') + check(v.isRepo === true && v.root === ROOT_LOCAL, 'A2 isRepo + root = rev-parse --show-toplevel') + check(v.entries.length === 2, 'A3 解析出 2 条提交') + check(v.entries[0].hash === OID1.slice(0, 7) && v.entries[0].hashFull === OID1 && v.entries[0].parents[0] === OID2, + 'A4 hash/hashFull/parents 与 graph 同形') + check(v.entries[0].author === 'Alice' && v.entries[0].subject === 'second commit' && v.entries[0].message.indexOf('body two') > 0, + 'A5 author/subject/message 逐字段对齐 %an/%s/%B') + check(Array.isArray(v.entries[0].refs) && v.entries[0].refs.length === 0, 'A6 history 不带引用装饰(refs 恒为 [],与上游一致)') + check(/^[a-f0-9]{64}$/.test(v.snapshot), 'A7 snapshot 是 sha256 十六进制') + check(v.hasMore === false && v.nextCursor === undefined, 'A8 一页装得下 → hasMore=false 且无 nextCursor') + check(rec.local.length === 8, 'A9 一次请求共 8 次本机 git 调用(toplevel + 前后快照各 3 + log)') + check(rec.local.filter((c) => c === LOG_ARGS(51, 0)).length === 1, 'A10 log 参数逐字符对齐上游(--branches --remotes HEAD … --)') + check(rec.localRaw.filter((c) => c.indexOf('--no-replace-objects') < 0 && c !== '--no-replace-objects rev-parse --show-toplevel' + && c !== 'rev-parse --show-toplevel').length === 0, + 'A11 除 toplevel 外的只读命令都带 --no-replace-objects') + check(rec.local.filter((c) => c === SNAP_CMDS[0]).length === 2 && rec.local.filter((c) => c === SNAP_CMDS[2]).length === 2, + 'A12 前后各取一次全量 refs 与 shallow 路径(过期检测)') + } + + { + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(2, 0)]: 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, 'A13 count=1 + limit+1 条 → 截到 1 条且 hasMore=true') + check(typeof v.nextCursor === 'string' && /^[A-Za-z0-9_-]+$/.test(v.nextCursor), 'A14 nextCursor 是 base64url') + const cur = JSON.parse(Buffer.from(v.nextCursor, 'base64url').toString('utf8')) + check(cur.version === 1 && cur.offset === 1 && cur.fingerprint === v.snapshot, 'A15 游标 = {version:1, fingerprint=snapshot, offset=limit}') + } + + { + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ + [LOG_ARGS(2, 1)]: logOut([{ h: OID2, p: '', an: 'Bob', ai: '2026-10-16 09:00:00 +0800', s: 'first commit', b: 'first commit\n' }]) + }) }) + const fp = createHash('sha256').update(JSON.stringify({ + root: ROOT_LOCAL, refs: REFS_ALL.trimEnd().split('\n'), head: OID1, shallow: null + })).digest('hex') + const cursor = Buffer.from(JSON.stringify({ version: 1, fingerprint: fp, offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', count: 1, cursor: cursor }) + check(r.status === 200 && r.body.value.entries[0].subject === 'first commit', 'A16 第二页用游标 → 拿到更老的提交(--skip=1)') + check(r.body.value.snapshot === fp, 'A17 指纹可被外部按同口径复算(refs+HEAD+shallow 的字符串 join 后 sha256)') + } + + { + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(51, 0)]: TWO_COMMITS }) }) + const bad = Buffer.from(JSON.stringify({ version: 1, fingerprint: 'b'.repeat(64), offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', cursor: bad }) + check(r.status === 409 && r.body.error.code === 'graph-stale' && /History changed/.test(r.body.error.message), + 'A18 游标指纹不匹配 → 409 graph-stale「History changed; refresh」') + } + for (const [label, payload] of [ + ['A19 count=0 → 400', { sessionId: 'sess-1', count: 0 }], + ['A20 count=-1 → 400', { sessionId: 'sess-1', count: -1 }], + ['A21 count=1.5 → 400', { sessionId: 'sess-1', count: 1.5 }], + ['A22 count="50" → 400', { sessionId: 'sess-1', count: '50' }] + ]) { + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(51, 0)]: TWO_COMMITS }) }) + const r = await call(handler, payload) + check(r.status === 400 && r.body.error.code === 'bad-request' && /Invalid history count/.test(r.body.error.message), label + '(Invalid history count)') + } + for (const [label, cursor] of [ + ['A23 非 base64url 字符 → 400', '###'], + ['A24 坏 JSON → 400', Buffer.from('not json').toString('base64url')], + ['A25 version≠1 → 400', Buffer.from(JSON.stringify({ version: 2, fingerprint: 'a'.repeat(64), offset: 1 })).toString('base64url')], + ['A26 fingerprint 非 64 hex → 400', Buffer.from(JSON.stringify({ version: 1, fingerprint: 'xyz', offset: 1 })).toString('base64url')], + ['A27 offset=0 → 400', Buffer.from(JSON.stringify({ version: 1, fingerprint: 'a'.repeat(64), offset: 0 })).toString('base64url')], + ['A28 offset=10001 → 400', Buffer.from(JSON.stringify({ version: 1, fingerprint: 'a'.repeat(64), offset: 10001 })).toString('base64url')] + ]) { + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(51, 0)]: TWO_COMMITS }) }) + const r = await call(handler, { sessionId: 'sess-1', cursor: cursor }) + check(r.status === 400 && r.body.error.code === 'bad-request' && /Invalid history cursor/.test(r.body.error.message), label) + } + + { + // count 超过内部上限 → 按 200 取数(max-count=201) + const { handler, rec } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(201, 0)]: TWO_COMMITS }) }) + const r = await call(handler, { sessionId: 'sess-1', count: 500 }) + check(r.status === 200 && rec.local.indexOf(LOG_ARGS(201, 0)) >= 0, 'A29 count=500 → 内部上限 200(max-count=201)') + } + { + // 非仓库 + const notRepo = Object.assign({}, localFixture(), { 'rev-parse --show-toplevel': new Error('fatal: not a git repository (or any of the parent directories): .git') }) + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: notRepo }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 200 && r.body.value.isRepo === false && r.body.value.entries.length === 0, 'A30 非仓库(git fatal 文案)→ 200 isRepo=false 空页') + } + { + const notRepo = Object.assign({}, localFixture(), { 'rev-parse --show-toplevel': new Error('fatal: not a git repository (or any of the parent directories): .git') }) + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: notRepo }) + const cursor = Buffer.from(JSON.stringify({ version: 1, fingerprint: 'a'.repeat(64), offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', cursor: cursor }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'A31 非仓库 + 游标 → 409(不能静默返回首页)') + } + { + // refs 超过 10 万 → graph-limit + const many = [] + for (let i = 0; i < 100001; i++) many.push('refs/heads/b' + i + '\u0000' + OID1) + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [SNAP_CMDS[0]]: many.join('\n') + '\n' }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 400 && r.body.error.code === 'graph-limit' && /Too many references/.test(r.body.error.message), + 'A32 refs > 100000 → 400 graph-limit(Too many references)') + } + { + // shallow 边界文件超过 1 MiB → graph-limit + const bigDir = mkdtempSync(join(tmpdir(), 'dsh-history-shallow-')) + try { + mkdirSync(join(bigDir, '.git'), { recursive: true }) + writeFileSync(join(bigDir, '.git', 'shallow'), Buffer.alloc(1048577, 0x61)) + const { handler } = historySandbox({ sessionDir: bigDir, localResponses: Object.assign({}, localFixture(), { 'rev-parse --show-toplevel': bigDir }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 400 && r.body.error.code === 'graph-limit' && /Shallow boundary metadata exceeds 1 MiB/.test(r.body.error.message), + 'A33 shallow 文件 > 1 MiB → 400 graph-limit') + } finally { + rmSync(bigDir, { recursive: true, force: true }) + } + } + { + // shallow 内容参与指纹:同一仓库、只有 shallow 变了 → 指纹必须变 + const shDir = mkdtempSync(join(tmpdir(), 'dsh-history-shallow2-')) + try { + mkdirSync(join(shDir, '.git'), { recursive: true }) + writeFileSync(join(shDir, '.git', 'shallow'), 'aaa\n') + const mk = async () => { + const { handler } = historySandbox({ sessionDir: shDir, localResponses: Object.assign({}, localFixture(), { 'rev-parse --show-toplevel': shDir }) }) + return (await call(handler, { sessionId: 'sess-1' })).body.value.snapshot + } + const fp1 = await mk() + writeFileSync(join(shDir, '.git', 'shallow'), 'bbb\n') + const fp2 = await mk() + check(fp1 !== fp2 && /^[a-f0-9]{64}$/.test(fp1), 'A34 shallow 内容进入指纹(改了 shallow → 指纹变,浅克隆可真过期)') + } finally { + rmSync(shDir, { recursive: true, force: true }) + } + } + { + // 前后快照不一致(分页期间仓库变了)→ 409 + let n = 0 + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: Object.assign({}, localFixture({ [LOG_ARGS(51, 0)]: TWO_COMMITS }), { + [SNAP_CMDS[0]]: () => (n++ === 0 ? REFS_ALL : REFS_ALL_OTHER) + }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'A35 前后快照不一致(分页期间新分支)→ 409 graph-stale') + } + { + // 翻页越过 10000 → graph-limit + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(2, 10000)]: TWO_COMMITS }) }) + const { handler: first } = historySandbox({ sessionDir: keepDir, localResponses: localFixture({ [LOG_ARGS(51, 0)]: TWO_COMMITS }) }) + const fp = (await call(first, { sessionId: 'sess-1' })).body.value.snapshot + const cursor = Buffer.from(JSON.stringify({ version: 1, fingerprint: fp, offset: 10000 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', count: 1, cursor: cursor }) + check(r.status === 400 && r.body.error.code === 'graph-limit' && /History limit reached \(10000\)/.test(r.body.error.message), + 'A36 offset+limit 越过 10000 → 400 graph-limit') + } + { + // 本机 git 失败(非 not-a-repo)→ 500 + const { handler } = historySandbox({ sessionDir: keepDir, localResponses: Object.assign({}, localFixture(), { + 'rev-parse --show-toplevel': new Error('fatal: detected dubious ownership in repository') + }) }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 500 && r.body.error.code === 'git-error' && /dubious ownership/.test(r.body.error.message), + 'A37 非「不是仓库」的 git 失败 → 500 git-error(带原文)') + } +} finally { + rmSync(keepDir, { recursive: true, force: true }) +} + +// --------------------------------------------------------------------------- +console.log('\nB. 远端分支(假 SSH):脚本标记、一次往返取快照、根路径回映射') +// --------------------------------------------------------------------------- +const keepDir2 = mkdtempSync(join(tmpdir(), 'dsh-history-b-')) +const snapSections = (suffix, refs, head, shallow) => [ + M + ' REFS' + suffix, String(refs).trimEnd(), M + ' HEAD' + suffix, head, '', M + ' SHALLOW' + suffix, shallow, '', M + ' SHALLOW_END' +].join('\n') +const remoteBegin = (repoRoot, refs, head, shallow) => [M + ' ROOT ' + repoRoot].concat(snapSections('1', refs, head, shallow)).join('\n') + '\n' +const remoteLog = (log, refs, head, shallow) => [M + ' LOG', String(log).trimEnd(), ''].concat(snapSections('2', refs, head, shallow)).join('\n') + '\n' +try { + { + const { handler, rec } = historySandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT, REFS_ALL, OID1, ''), + remoteLog(TWO_COMMITS, REFS_ALL, OID1, '') + ] }) + 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 回映射成本地镜像路径') + check(rec.remote[0].indexOf("cd '" + REMOTE_ROOT + "'") > 0, 'B4 第一条命令先 cd 到远端会话目录(带引号防注入)') + check(/cd '[^']*' 2>\/dev\/null \|\| \{ printf '[^']* NOREPO/.test(rec.remote[0]), 'B5 远端目录不在 → 脚本内 NOREPO(不是 500)') + 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[0].indexOf('rev-parse --git-path shallow') > 0, + 'B7 远端快照含全量 refs 与 shallow 边界(不是 heads/remotes 子集)') + check(rec.remote[0].indexOf('refs/heads/ refs/remotes/') < 0, 'B8 远端 for-each-ref 不带 heads/remotes 限定(history 要看全部 refs)') + check(rec.remote[1].indexOf("'--branches' '--remotes' 'HEAD'") > 0 && rec.remote[1].indexOf('--max-count=51') > 0 && rec.remote[1].indexOf('--skip=0') > 0, + 'B9 远端 log 参数与本地一致(--branches --remotes HEAD,max-count=limit+1,逐个 shellQuote)') + check(rec.remote.every((c) => c.indexOf('git -C') > 0), 'B10 全部是远端 git(没有本机 git 调用)') + check(v.entries[0].refs.length === 0, 'B11 远端 entries 同样不带装饰') + } + { + const { handler } = historySandbox({ 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, 'B12 远端不是仓库 → isRepo=false') + } + { + const { handler } = historySandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [M + ' NOREPO\n'] }) + const cursor = Buffer.from(JSON.stringify({ version: 1, fingerprint: 'a'.repeat(64), offset: 1 })).toString('base64url') + const r = await call(handler, { sessionId: 'sess-1', cursor: cursor }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'B13 远端不是仓库 + 游标 → 409') + } + { + const { handler } = historySandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT, REFS_ALL, OID1, ''), + remoteLog(TWO_COMMITS, REFS_ALL_OTHER, OID1, '') + ] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 409 && r.body.error.code === 'graph-stale', 'B14 远端前后快照不一致 → 409') + } + { + const { handler } = historySandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + [M + ' ROOT ' + REMOTE_ROOT, M + ' SHALLOW_TOO_BIG'].join('\n') + '\n' + ] }) + const r = await call(handler, { sessionId: 'sess-1' }) + check(r.status === 400 && r.body.error.code === 'graph-limit' && /Shallow boundary metadata exceeds 1 MiB/.test(r.body.error.message), + 'B15 远端 shallow 元数据超限 → 400 graph-limit') + } + { + const { handler } = historySandbox({ 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), + 'B16 远端命令失败 → 500 git-error(保留远端错误文本)') + } + { + // shallow 内容在远端也进指纹 + const { handler: h1 } = historySandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT, REFS_ALL, OID1, 'YWFh'), remoteLog(TWO_COMMITS, REFS_ALL, OID1, 'YWFh') + ] }) + const { handler: h2 } = historySandbox({ sessionDir: keepDir2, remote: true, remoteScripts: [ + remoteBegin(REMOTE_ROOT, REFS_ALL, OID1, 'YmJi'), remoteLog(TWO_COMMITS, REFS_ALL, OID1, 'YmJi') + ] }) + const fp1 = (await call(h1, { sessionId: 'sess-1' })).body.value.snapshot + const fp2 = (await call(h2, { sessionId: 'sess-1' })).body.value.snapshot + check(fp1 !== fp2, 'B17 远端 shallow 内容参与指纹(aaa 与 bbb 的 base64 应得到不同快照)') + } +} finally { + rmSync(keepDir2, { recursive: true, force: true }) +} + +// --------------------------------------------------------------------------- +console.log('\nC. 真实临时 git 仓库端到端(真 git 输出)') +// --------------------------------------------------------------------------- +const realRepo = mkdtempSync(join(tmpdir(), 'dsh-history-real-')) +const git = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 }) +const canonPath = (p) => { + try { return realpathSync.native(String(p)).replace(/\\/g, '/').toLowerCase() } catch (e) { return String(p).replace(/\\/g, '/').toLowerCase() } +} +const realLocalRunFactory = (rec) => async (dir, args) => { + rec.push(args.filter((a) => a !== '--no-replace-objects').join(' ')) + 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 { + if (git(realRepo, ['--version']).status !== 0) { + 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') + commit('a.txt', 'one\ntwo\nthree\n', 'third commit') + + const rec = [] + const { handler } = historySandbox({ sessionDir: realRepo, remote: false, localRun: realLocalRunFactory(rec) }) + 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 === 3, 'C2 真 git log 解析出 3 条(验证 %x00 分隔与字段顺序)') + check(v.entries[0].subject === 'third 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 拓扑正确(首条的 parent 是第二条)') + check(v.entries.every((e) => e.refs.length === 0), 'C6 history 全部条目无装饰(与上游 refs: [] 一致)') + check(/^[a-f0-9]{64}$/.test(v.snapshot) && v.hasMore === false, 'C7 真指纹 + 一页装得下') + check(canonPath(v.root) === canonPath(realRepo), 'C8 root = 真实仓库根(Windows 短路径也归一)') + + const p1 = await call(handler, { sessionId: 'sess-1', count: 2 }) + check(p1.body.value.entries.length === 2 && p1.body.value.hasMore === true && typeof p1.body.value.nextCursor === 'string', + 'C9 count=2 → hasMore + nextCursor(真分页)') + const p2 = await call(handler, { sessionId: 'sess-1', count: 2, cursor: p1.body.value.nextCursor }) + check(p2.status === 200 && p2.body.value.entries.length === 1 && p2.body.value.entries[0].subject === 'first commit' && p2.body.value.hasMore === false, + 'C10 第二页拿到最后一条且 hasMore=false(真实分页闭环)') + check(p2.body.value.snapshot === p1.body.value.snapshot, 'C11 未变更时两页指纹一致') + + // 真·过期:游标之后仓库多了一个提交 + commit('b.txt', 'x\n', 'fourth commit') + const stale = await call(handler, { sessionId: 'sess-1', count: 2, cursor: p1.body.value.nextCursor }) + check(stale.status === 409 && stale.body.error.code === 'graph-stale', 'C12 游标之后仓库变了 → 409(真实过期检测)') + + // 多分支:history 的 log 用 --branches --remotes HEAD,分叉提交也应出现 + git(realRepo, ['-c', 'user.name=T', '-c', 'user.email=t@example.com', 'checkout', '-q', '-b', 'side']) + commit('c.txt', 'side\n', 'side commit') + git(realRepo, ['checkout', '-q', 'main']) + const all = await call(handler, { sessionId: 'sess-1', count: 20 }) + const subjects = all.body.value.entries.map((e) => e.subject) + check(subjects.indexOf('side commit') >= 0, 'C13 别的分支上的提交也出现在 history(--branches)') + } +} finally { + rmSync(realRepo, { recursive: true, force: true }) +} + +// --------------------------------------------------------------------------- +console.log('\nD. 接线与上游对拍') +// --------------------------------------------------------------------------- +{ + const m = /const GIT_METHODS = \[([^\]]+)\]/.exec(src) + const methods = m ? [...m[1].matchAll(/"([^"]+)"/g)].map((x) => x[1]) : [] + check(methods.indexOf('history') >= 0, 'D1 GIT_METHODS 注册了 history') + check(methods.indexOf('graph') >= 0 && methods.indexOf('history') > methods.indexOf('graph'), 'D2 history 紧跟 graph(同一批分页端点)') + check(/case "history":/.test(src) && /gitHistoryPage\(payload, historyRemoteIo\(remote\)\)/.test(src) && /gitHistoryPage\(payload, historyLocalIo\(cwd\)\)/.test(src), + 'D3 分发走 gitHistoryPage:远端 → historyRemoteIo,本地 → historyLocalIo') + check(GIT_METHODS_REGISTERED(), 'D4 路由注册循环用 GIT_METHODS 逐个 register(新端点自动获得 /sidebar/api/git.history 路由)') +} +function GIT_METHODS_REGISTERED() { + return /GIT_METHODS\.forEach\(function \(m\) \{[\s\S]{0,200}?path: "\/sidebar\/api\/git\." \+ m/.test(src) +} + +// 与**实际安装的** better-sidebar 对拍(MAINTENANCE 硬规则的自动化)。 +// 关键口径:判据是「上游有而本插件没接管」,**不是**「本插件必须接管 history」—— +// tests.yml 钉的版本可能比 upstream-drift 的 @latest 旧(2026-11-02 首跑就是这么红的: +// 钉 0.26.1 没有 git.history,硬断言「上游确实有 history」就把流水线判死)。 +const MODEL_ONLY = ['git.models', 'git.commit-model', 'git.suggest-message'] +function upstreamParity(upSrcText) { + const upKeys = [...new Set([...String(upSrcText).matchAll(/"(fs|git)\.[a-zA-Z-]+"/g)].map((x) => x[0].slice(1, -1)))] + const m = /const GIT_METHODS = \[([^\]]+)\]/.exec(src) + const methods = m ? [...m[1].matchAll(/"([^"]+)"/g)].map((x) => x[1]) : [] + const upGit = upKeys.filter((k) => k.startsWith('git.')) + const needTakeover = upGit.filter((k) => MODEL_ONLY.indexOf(k) < 0) + return { upKeys, upGit, missing: needTakeover.filter((k) => methods.indexOf(k.slice(4)) < 0) } +} + +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 D5-D6:本机没有安装 dsh-better-sidebar,跳过上游对拍(不算失败)') +} else { + const p = upstreamParity(installed.src) + if (p.upKeys.indexOf('git.history') >= 0) { + check(p.missing.length === 0, 'D5 better-sidebar@' + installed.version + ' 有 git.history → 已接管(缺: ' + (p.missing.join(', ') || '无') + ')') + } else { + console.log(' · SKIP D5:钉住的 better-sidebar@' + installed.version + ' 还没有 git.history(上游漂移由 upstream-drift 的 @latest 负责盯)') + } + check(p.missing.length === 0, 'D6 上游全部与仓库相关的 git.* 端点都已接管(缺: ' + (p.missing.join(', ') || '无') + ')') + console.log(' · 对拍快照:上游 git.* ' + p.upGit.length + ' 个,其中模型类 3 个不接管') +} + +// 对拍逻辑自身的两向对照(不依赖本机装的是哪一版): +// D7 旧上游(只有 graph、没有 history)→ 不要求接管 history(否则钉旧版的 CI 会误红) +// D8 上游多出一个未知端点 → 必须报缺(证明 D5/D6 不是"永远绿") +{ + const oldUpstream = 'const a = "fs.tree"; const b = "git.status"; const c = "git.graph"; const d = "git.pull";' + check(upstreamParity(oldUpstream).missing.length === 0, 'D7 旧上游(无 git.history)→ 不要求接管 history(CI 钉旧版不会误红)') + const futureUpstream = 'const a = "git.graph"; const b = "git.history"; const c = "git.reflog";' + check(JSON.stringify(upstreamParity(futureUpstream).missing) === JSON.stringify(['git.reflog']), + 'D8 上游多出未知端点 git.reflog → 精确报缺(对拍有牙)') +} + +console.log('\n结果: ' + pass + ' 通过, ' + fail + ' 失败') +process.exit(fail === 0 ? 0 : 1)