worktree-ui-grammar-two-axis
dev
承接 #33/#34/#35/#36/#37。本 PR 含两笔:1e80167b(产品与测试侧修复)、7d947fbc(键盘可达性测试的脆性修复 + §14.2/§14.3 台账)。
1e80167b
7d947fbc
§14.1 的纯净对照把 36 条红分成"既有红"与"本批引入",本 PR 把后者逐条修掉:
detail-trust-section
publishableCases
map caseStudies
min-h-6
role="region"
aria-label
@admin
route.test.ts
mobile.spec:45
website-acceptance:139
navigation.ts
consult-button
p4 焦点管理
pollBoundingBox
probe-logo.mjs
nav-keyboard:56
残差(不洗成通过):两次干净全量跑分别是 1067/1 与 1065/3,红项集合互不重合,全是 18–25s 超时类且隔离各自绿 ⇒ 定性为 --workers=4 下的并行墙钟抖动;CI 侧 retries=2 + workers=1 覆盖。本地要稳定复现绿用 --workers=1。PR-DESCRIPTION.md 里 npm run test 一项继续保持未勾选。
--workers=4
retries=2 + workers=1
--workers=1
PR-DESCRIPTION.md
npm run test
N/A:本 PR 是 §14 待办的执行,来源是我自己的合并后补跑与纯净对照。
bash scripts/check-pr-checklist.sh
npm run type-check
npm run type-check:e2e
npm run lint
<a>
check:motion
console.log
TODO
.only()
console.error
[revalidation-failed]
check:dead
detail-trust-gate.test.tsx
jest detail-trust-gate + detail.test
test:e2e:fast
website-acceptance
nav-keyboard
test:functional
npm run test:unit
test:coverage
npm run check:a11y
check:contrast
check:headings
check:brand-token
npm run lighthouse
npm run test:security:headers
qa-tracker.md
lessons-learned.md
test.skip
origin/*
复算读数(本笔 HEAD 7d947fbc):tsc 0、type-check:e2e 0、check:package-keys 0、check:visual 0、check:dead 0、check:motion 0、jest 1804 例 0、test:e2e:fast 59 passed、website-acceptance ×4 56 passed ×2、nav-keyboard 12 passed(变异 1 例红)。
tsc
type-check:e2e
check:package-keys
check:visual
jest
website-acceptance ×4
未验证/未通过项(不沉默)
ContentModel.fields
navigation
Jenkinsfile
when { branch 'main' }
第 97 行算了 gateCaseItems、第 105/160 行用 publishableCases.length 决定出现与否, 但第 175 行渲染的仍是 caseStudies.map ⇒ 只要组里有一条过闸,未授权或口径为 target 的案例照样出现在页面上。DEC-N4 声称的逐条 fail-closed 在这里没生效。 - 改为 publishableCases.map。 - 新增 src/components/detail/detail-trust-gate.test.tsx 3 例:过闸的出、 没过闸的一条都不出(含「有授权但 basis=target」这一维)、全被闸时整块不出现 且 console.error 逐条喊原因、被闸条目不得占用网格位置。 - 变异验证:把渲染回退成 caseStudies.map ⇒ MUTANT=1(2 条精确转红、1 条仍绿), 恢复 ⇒ 35 例 EXIT=0。另一处 detail-case-studies-section 复核为已正确使用 publishable.map,无同类漏洞。 来源:§14 补跑全量功能 E2E 时暴露(本批引入,非基线既有)。
产品侧(真缺陷): - detail-trust-section 渲染绕过门槛(publishableCases 算了却仍 map caseStudies)⇒ 只要一条过闸,未授权/无 verified 的案例照样上线。改回 publishableCases.map, 新增 detail-trust-gate.test.tsx 3 例;变异验证:回退成 caseStudies.map ⇒ 2 条精确转红。 - 4 个文字链接触摸目标 23px < WCAG 2.5.8 的 24px(home 全部洞察/了解这一能力、 成果槽两条 CTA)⇒ 走间距刻度 min-h-6 补齐,不塞任意值。判据本身复跑通过。 - 首页能力面板 role=region 缺可访问名(landmark 无名;axe 的 landmark-name 属 best-practice 标签,我们的闸只跑 A/AA 所以没报)⇒ 补 aria-label。 - 登录限流额度改为可按环境覆盖(默认仍 10 次/15 分钟/IP,生产姿态不变); 真因:进程内内存桶 + dev server 跨整轮存活 ⇒ @admin 旅程第 11 次登录起必得 429, 即 §14 里「单跑绿、全量红」的机理。route.test.ts 加双向用例(未设=10;设 3 ⇒ 第 4 次限流)。 测试侧(锚点/引擎): - mobile.spec:45、website-acceptance:139 的重锚:锚点取自真源 navigation.ts (一级只剩 行业/能力/洞察/关于我们,联系入口是 consult-button 而非导航项)。 - p4:403 焦点管理:webkit/chromium-mobile 上 Tab 不落到链接(Safari 系需系统级 「Press Tab to highlight each item」,Playwright 起的 webkit 不带), 我先试 bringToFront + 点空白**没有用**,故改为同契约按引擎取证(chromium 走真实键盘 Tab,其余显式 focus 跳转链接),断言一条不减;复跑 webkit+mobile 2 passed。 - playwright.config.ts:我把 env 插成了重复键(TS1117),由本批新加的 type-check:e2e 当场抓到 ——这条闸的价值的又一次现场证明。已合并进既有 env 对象。 待办:全量功能 E2E 终跑(4 project)正在后台,读数与 PR 勾选项的复位随下一笔。
- 探针 docs/acceptance/2026-10-17-final/probe-logo.mjs 实测加载期无双字标可见窗口 (390x844 与 1280x800 各 60 次采样,双可见 0;唯一零可见是 t≈43ms header 尚未进 DOM) ⇒ 产品不闪,红来自辅助函数:expect.poll 等到非空后再单独读一次 boundingBox, hydration 亚 60ms 的重挂让第二次读取返回 null,被误报成「元素在断言瞬间消失」。 - 改为在同一次读取里既判非空又产出值;超时才 throw,且 throw 文案带轮询次数。 判据不降:仍要求非空 box + 原几何断言,没有 catch、没有静默通过。 - website-acceptance × 4 project 连跑两次各 56 passed。 - §14.2 表逐条登记:fail-open 修复 / 触摸目标与 region 命名 / 限流真因与双向用例 / 锚点重锚 / 引擎差异取证法(我上一个假设被自己的读数否掉)/ 本条竞态。
- 实取:final5 干净跑 1067 passed / 1 failed(本条),final6 干净跑 1065 / 3 failed 且红项集合与 final5 不重合 —— 全是 18~25s 超时类、隔离复跑各自绿。 - nav-keyboard:56 原先连按 3 次 Tab 后断言焦点在触发器上,押死了站点计数; 改成有界键盘行走(≤8 次 Tab 走不到即失败),断言强度不降: 仍要求仅用键盘可达、且 Enter 真能展开面板。 - 复算:隔离 12 passed;与 p2/website-acceptance 合跑 68 passed; 变异(把上界改成 1)⇒ 立刻判红,证明这条断言不是摆设。 - §14.3 把口径写死:不以「隔离能绿」关掉断言,也不把残差写成「全量通过」; PR 描述里 npm run test 一项保持未勾选,本地要稳定复现绿用 --workers=1。
No dependencies set.
The note is not visible to the blocked user.
PR:§14.2–§14.3 —— 把全量功能 E2E 从 36 红做到残差抖动,并修掉其中一条真 fail-open
承接 #33/#34/#35/#36/#37。本 PR 含两笔:
1e80167b(产品与测试侧修复)、7d947fbc(键盘可达性测试的脆性修复 + §14.2/§14.3 台账)。变更摘要
§14.1 的纯净对照把 36 条红分成"既有红"与"本批引入",本 PR 把后者逐条修掉:
detail-trust-section渲染绕过门槛(算了publishableCases却仍map caseStudies)⇒ 只要一条过闸,未授权/无 verified 的案例照样上线min-h-6间距刻度);能力面板role="region"缺可访问名(补aria-label)@admin旅程第 11 次登录起必得 429(即"单跑绿、全量红")。额度改为可按环境覆盖,默认仍 10,只在 e2e harness 抬到 500route.test.ts双向用例:未设⇒10;设 3⇒第 4 次判限流。9 例 EXIT=0mobile.spec:45、website-acceptance:139按真源navigation.ts重锚(一级只剩 行业/能力/洞察/关于我们;联系入口是consult-button)p4 焦点管理:webkit/chromium-mobile 上 Tab 不落到链接(Safari 系需系统级设置)。我先前"窗口焦点"假设被自己的读数否掉,改为同契约按引擎取证,断言不减pollBoundingBox先 poll 到非空再单独读一次,hydration 亚 60ms 重挂即误报"元素消失"⇒ 改在同一次读取里既判非空又取值probe-logo.mjs实测;两 spec × 4 project 各 56 passednav-keyboard:56押死"连按 3 次 Tab"⇒ 冷启动/前序用例改变焦点起点就碎。改为有界键盘行走(≤8 次到不了即失败)残差(不洗成通过):两次干净全量跑分别是 1067/1 与 1065/3,红项集合互不重合,全是 18–25s 超时类且隔离各自绿 ⇒ 定性为
--workers=4下的并行墙钟抖动;CI 侧retries=2 + workers=1覆盖。本地要稳定复现绿用--workers=1。PR-DESCRIPTION.md里npm run test一项继续保持未勾选。关联 Issue
N/A:本 PR 是 §14 待办的执行,来源是我自己的合并后补跑与纯净对照。
提交前检查
bash scripts/check-pr-checklist.sh对本描述文件 EXIT=0(读数见「其他说明」)全链路检查
npm run type-checkEXIT=0(复算于本笔 HEAD)npm run type-check:e2eEXIT=0 —— 它在本批内两次抓到真问题(我自己的重复键 env、以及 e2e 既有缺陷)npm run lint:N/A 复跑于本笔 ⇒ 沿用 #33 的 0 error 读数;本批未新增 error 级问题(新代码只加min-h-6/aria-label/测试文件)<a>的最小高min-h-6使首页相关区块增高 1px ⇒ 基线随之重采并只读复跑 125/125)aria-label与min-h-6不涉及色值)check:motion在 #33 已归零且判据按用途在消费点)console.log/TODO/.only():新增console.error只有门槛封条与[revalidation-failed]两类有意信号;check:deadEXIT=0测试分层检查(L0–L3)
route.test.ts新增限流双向用例;detail-trust-gate.test.tsx3 例(含 fail-closed 与逐条隐藏)jest detail-trust-gate + detail.test35 例 EXIT=0;变异验证证明断言有牙test:e2e:fast59 passed;website-acceptance× 4 project 两次各 56 passed;nav-keyboard隔离 12 passed、合跑 68 passedmin-h-6增高后重采并只读复跑 125 passed / 0 failed(逐名清单机制同批上线)test:functional:未 100% 通过(1065–1067 passed / 1~3 残差超时抖动,隔离各自绿)⇒ 已在 §14.3 与 #36 的未勾项上登记,不写成本 PR 已闭质量门禁
npm run test:unit/test:coverage:1804 例 EXIT=0,All files 89.48/88.01/88.14/89.48 ≥ 阈值,阈值未下调npm run test(全量 Playwright):N/A 于"本 PR 是否声明它通过"——本 PR 明确不声明,残差已登记(见上一节末项)npm run check:a11y:EXIT=0(check:contrast/check:headings/check:brand-token);本 PR 的两处 a11y 修复让两条触摸目标 spec 由红转绿npm run lighthouse:EXIT=0(#33 重建装配上取得;本 PR 未改渲染路径之外的样式,除 1px 增高)npm run test:security:headers:EXIT=0;本 PR 未碰响应头/CSP,但动了限流默认值的读取方式(默认值不变,有单测钉)qa-tracker.md§14.2/§14.3、lessons-learned.md(§5.44–§5.47 已在 #33/#36 落)假绿灯纪律
test.skip或提高 timeout 来掩盖origin/*与实测为准:dev 与分支同 sha 已核其他说明
复算读数(本笔 HEAD
7d947fbc):tsc0、type-check:e2e0、check:package-keys0、check:visual0、check:dead0、check:motion0、jest1804 例 0、test:e2e:fast59 passed、website-acceptance ×456 passed ×2、nav-keyboard12 passed(变异 1 例红)。未验证/未通过项(不沉默)
test:functional在--workers=4下仍有 1~3 条超时类残差(跨轮集合不重合、隔离绿);CI 以retries=2 + workers=1覆盖,本地稳定复现请用--workers=1。ContentModel.fields(DEC-N4 新字段声明)与navigation行的同形核对属部署期动作。Jenkinsfile的部署阶段挂在when { branch 'main' },合 main = 无人值守线上发布。