Import vendor/dsh-remote-ssh/tests/sidebar-0282-history.test.mjs

This commit is contained in:
QQ 2026-11-11 22:40:09 +08:00
parent 284abe4bea
commit 3987b97a67
1 changed files with 568 additions and 0 deletions

View File

@ -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 = '<host>'
const USER = '<user>'
const KEY = '<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)