chore(gates): DEC-N6 让 e2e 进类型口径,并修 pre-commit 位与证据路径覆盖历史

- 新增 e2e/tsconfig.json + `npm run type-check:e2e`(并入 test:all)。
  本轮实测证据:teardown 补丁里第二个 `const revalidateSecret` 与既有声明重名,
  `npm run type-check` 全程 EXIT=0,只有 `playwright test --list` 才报重复声明 ——
  现在静态期就能抓。读数:type-check:e2e EXIT=0。
- .husky/pre-commit 的索引模式改回 100755(本轮每次提交都在打
  "was ignored because it's not set as executable",即 lint-staged 在任何克隆里都不执行)。
  验证看 `git ls-files -s .husky` 的 mode,不是看文件系统权限。
- axe 证据落盘改为按运行轮次分目录(原写死 docs/acceptance/2026-09-21-axe/axe-evidence.json,
  于是每跑一次就覆盖一次历史:0157b1c9 里那 409 行 diff 就是这么产生的),
  并补 check:axe:selftest;判定逻辑与退出码三档语义未动。
- 顺带修一处仪器级缺陷:package.json 里 `type-check:e2e` 被写了两遍 ——
  JSON 重复键是后者静默覆盖前者,不会报错也不会判红,正是本仓反复吃的"重复声明"类。
  现取键数与值由 node 回读校验。
This commit is contained in:
zhangxiang committed 2026-10-17 07:54:21 +08:00
1 parent 2e0099426f
commit 1c0ce5f458
12 files changed
+199 -27

No files matched your search

+105 -8
View File
@@ -14,17 +14,23 @@
// 用法:
// npm run check:axe:routes # 生成路由清单(默认 /tmp/axe-routes.xml)
// npm run check:axe # 用该清单扫描并判定
// npm run check:axe:selftest # 只验证证据落盘路径的装配逻辑(不起服务、不碰 docs/)
// 环境变量:BASE(默认 http://localhost:3100,须是 `node dist/standalone/server.js` 起的生产服务,
// 非 dev server)、SITEMAP(路由清单 XML)、OUT(证据 JSON 输出目录,默认 docs/acceptance/2026-09-21-axe,
// 历史证据仍留在这里)。
// 非 dev server)、SITEMAP(路由清单 XML)、OUT(证据 JSON 输出目录,默认按**运行日**分轮次目录
// docs/acceptance/<YYYY-MM-DD>-axe;显式给 OUT 时只写该目录,不再刷新 latest 指针)。
//
// 附加旗标(不参与门禁判定,退出码只属于门禁本身):
// --print-paths 打印本轮解析出的证据路径后 exit 0(不启动浏览器、不读清单)
// --selftest 用临时目录验证「路径模板 + 落盘/指针副本」这段装配逻辑,exit 0/1
//
// 退出码:0 通过 / 1 门禁判红(violation 节点 > 0、主题或底色不匹配、规则级通道分母不闭合)/
// 2 输入不可用(路由清单缺失或解析出 0 条)。
import { chromium, firefox } from 'playwright';
import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'fs';
import { mkdirSync, writeFileSync, readFileSync, existsSync, mkdtempSync, rmSync } from 'fs';
import { fileURLToPath } from 'url';
import { dirname, isAbsolute, join, resolve } from 'path';
import { dirname, isAbsolute, join, resolve, relative } from 'path';
import { tmpdir } from 'os';
// 本脚本从证据目录 docs/acceptance/2026-09-21-axe/ 搬到 scripts/accessibility/,cwd 相对路径一律改为
// 仓库根相对,这样无论从哪个目录调用都指向同一份 axe-core 与同一处证据目录(行为等价,只是不再依赖 cwd)。
@@ -32,9 +38,94 @@ const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
const repoPath = (p) => (isAbsolute(p) ? p : resolve(REPO_ROOT, p));
const BASE = process.env.BASE || 'http://localhost:3100';
const OUT = repoPath(process.env.OUT || 'docs/acceptance/2026-09-21-axe');
const SITEMAP = repoPath(process.env.SITEMAP || '/tmp/axe-routes.xml');
const AXE_SCRIPT = repoPath('node_modules/axe-core/axe.min.js');
/**
* 证据落盘路径(本批补的仪器缺陷,见 docs/acceptance/qa-tracker.md §11.6 末尾「证据文件的口径提醒」):
* 旧实现把 OUT 写死成 `docs/acceptance/2026-09-21-axe` ⇒ **每跑一次就把那份 2026-09-21 的历史证据刷成
* 本轮读数**(commit 0157b1c9 里那 409 行 diff 就是它)。现按运行轮次落盘:
* 默认目录 = docs/acceptance/<YYYY-MM-DD>-axe(日期取运行日、**本地时区**,与 docs/acceptance 下
* 其它按日期分目录的证据一致;UTC 会让晚上 8 点后的运行日跳天,故不用 toISOString 的前 10 位)。
* 兼容性:`docs/acceptance/2026-09-21-axe/axe-evidence.json` 这个路径**仍然每轮刷新**,但它从今往后
* 只是「latest 指针副本」(Jenkinsfile:399 的 archiveArtifacts 与 docs 下的既有引用都指它),
* 不再是历史原件;历史原件留在各自轮次目录。显式设置 OUT 时只写 OUT、不刷新指针(与旧版一致)。
* 判定逻辑与退出码不受这段改动影响。
*/
const LATEST_POINTER_DIR = 'docs/acceptance/2026-09-21-axe';
const localRunDate = (d = new Date()) => {
const pad = (n) => String(n).padStart(2, '0');
return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
};
function resolveEvidenceTargets(env) {
const runDate = localRunDate();
const out = repoPath(env.OUT || `docs/acceptance/${runDate}-axe`);
const file = join(out, 'axe-evidence.json');
const latest = env.OUT ? null : repoPath(join(LATEST_POINTER_DIR, 'axe-evidence.json'));
return { runDate, out, file, latest };
}
const TARGETS = resolveEvidenceTargets(process.env);
/** 把一轮证据写进轮次目录,并(默认路径下)刷新 latest 指针副本。返回落盘位置供日志打印。 */
function writeEvidence(artifact, targets) {
const json = JSON.stringify(artifact, null, 2);
mkdirSync(targets.out, { recursive: true });
writeFileSync(targets.file, json);
if (targets.latest) {
mkdirSync(dirname(targets.latest), { recursive: true });
writeFileSync(targets.latest, json);
}
return targets;
}
const FLAGS = new Set(process.argv.slice(2));
if (FLAGS.has('--print-paths')) {
console.log(JSON.stringify(TARGETS, null, 2));
process.exit(0);
}
if (FLAGS.has('--selftest')) {
// 只验证这段「路径模板 + 落盘」的装配逻辑:不启动浏览器、不读路由清单、不碰 docs/。
// 1) 默认模板:docs/acceptance/<运行日>-axe/axe-evidence.json;
// 2) 显式 OUT:只写该目录,latest 指针为 null(旧版语义);
// 3) 真实写一遍:轮次文件与指针副本都要存在且内容一致。
const checks = [];
const pushCheck = (ok, msg) => checks.push({ ok, msg });
const today = `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, '0')}-${String(new Date().getDate()).padStart(2, '0')}`;
const def = resolveEvidenceTargets({});
pushCheck(def.out === repoPath(`docs/acceptance/${today}-axe`), `默认轮次目录模板 = docs/acceptance/${today}-axe(实测 ${def.out})`);
pushCheck(def.file === repoPath(`docs/acceptance/${today}-axe/axe-evidence.json`), '默认轮次文件名 = <轮次目录>/axe-evidence.json');
pushCheck(def.latest === repoPath(`${LATEST_POINTER_DIR}/axe-evidence.json`), '默认刷新 latest 指针副本');
const explicit = resolveEvidenceTargets({ OUT: '/tmp/axe-selftest-out' });
pushCheck(explicit.file === '/tmp/axe-selftest-out/axe-evidence.json', '显式 OUT 时写该目录');
pushCheck(explicit.latest === null, '显式 OUT 时不刷新 latest 指针');
const sandbox = mkdtempSync(join(tmpdir(), 'axe-selftest-'));
try {
const artifact = { selftest: true, note: '非门禁产物,仅验证落盘路径逻辑', passed: true };
const roundLikeDir = join(sandbox, `docs/acceptance/${today}-axe`);
const pointerFile = join(sandbox, `${LATEST_POINTER_DIR}/axe-evidence.json`);
const written = writeEvidence(artifact, { runDate: today, out: roundLikeDir, file: join(roundLikeDir, 'axe-evidence.json'), latest: pointerFile });
pushCheck(existsSync(written.file), `轮次证据文件已写出:${written.file}`);
pushCheck(existsSync(written.latest), `latest 指针副本已写出:${written.latest}`);
pushCheck(
readFileSync(written.file, 'utf8') === readFileSync(written.latest, 'utf8'),
'轮次证据与 latest 指针内容逐字节一致',
);
// 反例:只给 out/file(latest=null)时不得在指针位置凭空造文件
const noPointerDir = join(sandbox, 'no-pointer');
writeEvidence(artifact, { runDate: today, out: noPointerDir, file: join(noPointerDir, 'axe-evidence.json'), latest: null });
pushCheck(!existsSync(join(noPointerDir, LATEST_POINTER_DIR)), 'latest 为 null 时不产生任何指针文件');
} finally {
rmSync(sandbox, { recursive: true, force: true });
}
const failed = checks.filter((c) => !c.ok);
for (const c of checks) console.log(`${c.ok ? '✓' : '✗'} ${c.msg}`);
if (failed.length > 0) {
console.error(`\nFAIL: axe 证据路径 selftest ${failed.length} 项未通过`);
process.exit(1);
}
console.log('SELFTEST PASSED(未触碰 docs/,未启动浏览器)');
process.exit(0);
}
const TAGS = ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'];
// Lighthouse 12.6.1 不包装这三条 axe 规则,且 presentation-role-conflict 属 best-practice tag(不在 TAGS 内)
// ⇒ 只有这里的规则级 runOnly 才真正测到它们;证据链见 docs/acceptance/2026-09-21-gates/final-tree-results.md
@@ -273,6 +364,11 @@ push(totalCanonicalCoverage === expectedCanonicalCoverage,
const artifact = {
generatedAt: new Date().toISOString(),
runDate: TARGETS.runDate,
// 落盘位置写进产物本身:这样即使有人打开的是 latest 指针副本,也能一眼看出它是**哪一轮**跑出来的
// (§11.6 那条「引用前必读」的口径提醒,从此由产物自证而不是靠人记)。仓库相对路径,不落机器绝对路径。
evidenceRunDir: relative(REPO_ROOT, TARGETS.out),
latestPointer: TARGETS.latest ? relative(REPO_ROOT, TARGETS.latest) : null,
base: BASE,
axeCore: JSON.parse(readFileSync(repoPath('node_modules/axe-core/package.json'), 'utf8')).version,
routeSource: `${SITEMAP} → ${urls.length} 条路由(sitemap ∪ 预渲染产物 ∪ 站内链接 BFS)`,
@@ -298,12 +394,13 @@ const artifact = {
summary,
rows,
};
mkdirSync(OUT, { recursive: true });
writeFileSync(`${OUT}/axe-evidence.json`, JSON.stringify(artifact, null, 2));
writeEvidence(artifact, TARGETS);
console.log('\nSUMMARY', JSON.stringify(summary, null, 2));
console.log('PASSED =', artifact.passed);
console.log(`证据已按轮次写入 ${relative(REPO_ROOT, TARGETS.file)}` +
(TARGETS.latest ? `(并刷新 latest 指针 ${relative(REPO_ROOT, TARGETS.latest)})` : '(显式 OUT,未刷新 latest 指针)'));
if (!artifact.passed) {
console.error(`\nFAIL: axe 节点计数门禁 ${failures.length} 条判据未通过(证据已写入 ${OUT}/axe-evidence.json)`);
console.error(`\nFAIL: axe 节点计数门禁 ${failures.length} 条判据未通过(证据已写入 ${relative(REPO_ROOT, TARGETS.file)})`);
for (const f of failures) console.error(` ✗ ${f}`);
process.exit(1);
}