worktree-ui-grammar-two-axis
dev
分支 worktree-ui-grammar-two-axis → dev。基线 = da9a5cb6,本 PR 在 §11(0ae765af)之上继续。
da9a5cb6
0ae765af
把 docs/acceptance/qa-tracker.md §11.4/§11.5 登记的待拍项按决策人的裁定(「均采用推荐方案」)逐条落地:
docs/acceptance/qa-tracker.md
src/lib/cms/revalidation.ts
modelCode → paths
s-maxage=3600
check:accents
style
#rrggbb
MAX_NON_BRAND_HUES=7
erp-upgrade-v3/page.tsx
check:motion
--transition-gentle
src/
src/lib/constants/case-publish-gate.ts
CaseStudiesSection
detail-trust-section
e2e/tsconfig.json
type-check:e2e
test:all
.husky/pre-commit
scripts/check-package-keys.mjs
staggerDelay
0.05
git log -S
--radius-cta: 12px
caseStudies
authorized(boolean)
basis
metricBasisField
src/lib/cms/case-field-contract.test.ts
npm run db:seed
ContentModel.fields
ContentItem
cp
mainNav
length(data) = 2778
nav-dropdown
p6-missing-paths
qa-tracker.md
lessons-learned.md
README.md
CONTEXT.md
CLAUDE.md
docs/development/quality-gates.md
N/A:本批是 §11 收尾时决策人留给自己的编号待拍清单(DEC-N1…N6 / AUTH-VISUAL / AUTH-NAV),无独立 Issue 单; 来源与逐条处置见 docs/acceptance/qa-tracker.md §12。
bash scripts/check-pr-checklist.sh
npm run type-check
npm run lint
getHeroTheme(heroThemeId ‖ 'erp')
erp
heroThemeId='erp'
content-types.ts
authorized/basis
prisma/seed.ts:364
ContentItem.data
navigation
var(--ease-ink)
var(--transition-slower)
ease-ink
[0.22,1,0.36,1]
#C41E3A
check:contrast
check:brand-token
basis==='verified'
metrics-basis.ts
console.log
TODO
.todo()
console.error
[revalidation-failed]
check:dead
lint
src/lib/cms/revalidation.test.ts
CONTENT_TYPE_CONFIGS
src/lib/constants/case-publish-gate.test.ts
cache-invalidation.test.ts
--testPathPatterns products
test:e2e:fast
@critical
.env.production
G-LGTLCR15KM
--update-snapshots=none
check:accents:selftest
check:package-keys --selftest
package.json
.only()
skip
npm run test:unit
npm run test:coverage
config/test/jest.config.js
coverageThreshold
npm run test
test:visual:all
test:functional
36 failed → 2 → 1 → **0**
role="region"
npm run check:contrast
npm run check:headings
check:a11y
npm run lighthouse
lhci
npm run test:security:headers
docs/adr/0008-*.md
docs/lessons-learned.md
sed
TSC=2
EXIT=0
sqlite3
no such column: code
2>/dev/null
1426dd1c
bceba3f5
&&
todo
erp-upgrade-v3
use.reducedMotion
@ts-expect-error
contextOptions
origin/*
origin/dev
navigation/default
e2e/**/*.ts
读数表由 docs/acceptance/2026-10-17-final/ 的两条车道产出(visual-negative-control.sh、run-final-lane.sh), 两条车道均已跑到 DONE;车道汇总原文(/tmp/12-vis-final.txt、/tmp/12-final.txt)与逐条日志一起随本轮证据目录留存。
docs/acceptance/2026-10-17-final/
visual-negative-control.sh
run-final-lane.sh
/tmp/12-vis-final.txt
/tmp/12-final.txt
check:motion:test
--selftest
check:package-keys
"lint"
scripts.lint
type-check
const
check:visual
npm run test:all
test:coverage
test:integration:real
test:security:headers
p6-missing-paths.spec.ts
db:seed
product
--project=firefox
playwright.config.ts:12-15
fullyParallel:true
retries: CI?2:0
workers: CI?1:undefined
check:axe:routes
check:axe
/_not-found
visual-manifest-post-schema.json
--radius-cta=12px
input-default/focused
button-*
header-navigation
founder-quote-section-*
toHaveCount(0)
run-post-schema-lane.sh
评审者请特别关注:revalidateContent 是尽力而为(数据与审计已落库后执行,逐条 try + [revalidation-failed] 日志 + failed 回报), 因为刷缓存失败不该把一次成功的写入连带变成 500;HTTP 入口 /api/cms/revalidate 仍用严格的 applyRevalidation,500 语义不变。
revalidateContent
failed
/api/cms/revalidate
applyRevalidation
事故:把 worktree A 的 .env 拷进 worktree B 做基线对照,而 DATABASE_URL 是绝对路径 (file:/…/A/prisma/dev.db)⇒ B 上跑的旧代码 seed 顺着它把 A 的库整库覆盖成旧 IA 数据。 之后 A 上的门禁与 e2e 全在这份脏数据上出数,而「每棵树各有自己的 dev.db」看起来完全正常。 本轮 §14.3 的残差读数与一次 AUTH-NAV 重开的误判都源于此。 - 新增 src/lib/seed-target.ts:纯函数 checkSeedTarget(url, repoRoot, allowExternal)。 目标库不在本树内 ⇒ 写之前就抛错中止;非 file: 协议同样要求显式放行。 生产容器 seed(file:/app/data/prod.db 在仓库根之外)按显式 SEED_ALLOW_EXTERNAL_DB=1 走。 - prisma/seed.ts 在 main() 最先处调用,并打印实际目标库与判定理由。 - 8 例判据:本树内 / 相对路径 / 带查询串 / 仓库根之外 / 兄弟目录前缀陷阱 / 显式放行 / URL 缺失 / 非 file: 协议。 - 活体负对照:DATABASE_URL=file:/tmp/outside-sandbox.db 跑 seed ⇒ EXIT=1, 且 /tmp/outside-sandbox.db 未被创建(拦住发生在写之前);本树 seed 正常并打印目标路径。 - 顺带修正:守卫的测试最初放在 prisma/ 下,jest roots=['src'] 根本不收集它 (读数:Pattern: prisma/seed-target - 0 matches)⇒ 一个不被跑的守卫比没有守卫更危险, 已把模块与测试一起搬进 src/lib。 - 数据已修复:重新 seed 后 navigation 行为 行业/能力/洞察/关于我们 + 面板 industries/capabilities/insights;服务端每请求「退回代码真源」的日志由每次变 0 次。
全量功能 E2E 在「修好数据」后的干净读数:1066 passed / 2 failed,两条都是 website-acceptance 的「导航菜单功能正常」在 firefox/webkit 上 15s 超时。 按「能复现就修根因」处理,不记成墙钟抖动: 1) 登录/联系表单限流同族:contact 也是进程内内存桶 5 次/小时/IP,而 e2e server 跨整轮用例存活 ⇒ 多次提交必然 429。抽出 src/lib/rate-limit-config.ts 的 readRateLimitMax(未设⇒默认、非法值⇒默认且打 [rate-limit-config] warn、 合法值⇒取整),login 与 contact 都改用它;默认值都不动(10/5), 仅在 e2e harness 抬到 500/200。3 例判据覆盖上述三条路径。 2) uj-08:helper hover 的是顶栏里第一个 a[href=/services](实测命中工具行那条), 且面板正在播 280ms 入场动画 ⇒ Playwright 判 not stable 重试到 15s。 改为语义锚点「查看全部能力」+ 等 320ms(> token 的 280ms), 并断言其 href 就是导航项自己声明的 /services。firefox+chromium 复跑 2 passed。 3) website-acceptance「导航菜单功能正常」:日志显示点击后 navigated to / ⇒ 点在了 logo 上。①补 expectHydrated(nav)(相邻用例早有,这条漏了); ②选择器排除 href=/ ⇒ 测的真是菜单项。firefox+webkit 连跑 **5/5 绿**(4.7s, 此前 15s 超时)。 复算:tsc 0、type-check:e2e 0、rate-limit-config + login + seed-target 测试全绿。
- p2:136「Logo点击返回首页」在全量里 webkit 偶发 17.7s 超时,与 website-acceptance 「导航菜单功能正常」同根因:元素可见 ≠ 可交互,hydration 窗口内派发的 click 被丢弃。 补 expectHydrated(本仓既有约定,探 __reactProps$)后再点。 复算:4 project × 3 轮 = 12/12 passed;此前同轮 4/4 failed 是漏了 import,已修。 - §14.4 记录:跨 worktree 的绝对 DATABASE_URL 让旧代码 seed 覆盖本树整库 (§14.3 残差读数作废、AUTH-NAV 误判的源头),防线是 checkSeedTarget 的写前中止 + 活体负对照(外部库未被创建);以及 contact 5 次/小时限流的结构性 429 与 uj-08 面板动画 not stable 两处真根因。
- §14.4:跨 worktree 的绝对 DATABASE_URL 让旧代码 seed 覆盖本树整库(§14.3 残差读数作废、 AUTH-NAV 误判的源头);防线 checkSeedTarget 写前中止 + 活体负对照(外部库未被创建)。 以及 contact 5 次/小时的进程内桶(结构性 429)与 uj-08 面板 280ms 动画 not stable。 - §14.5:曾记为「并行墙钟残差」的 1~3 条逐条查出真因(hydration 前点击、logo 混入菜单选择器、 contact/login 限流、hover 撞动画),修完即 0。 最终读数:test:functional(4 project、默认 workers)1068 passed / 0 failed / 44 skipped,EXIT=0。 - 口径修正:隔离能绿 + 集合每轮不同,不足以判为墙钟抖动;先读完整报错、再找同文件已修同类的 前置约定(如 expectHydrated)。 - PR 描述里 npm run test 一项由「合并后补记的未勾选更正」改为闭合陈述(记录了最初勾错这件事)。 - 终版复算:test:all EXIT=0(149 套件 / 1815 例、真库 23 例、e2e:fast 59 passed)、 check-pr-checklist EXIT=0(0 个未勾项)、tsc EXIT=0。
No dependencies set.
The note is not visible to the blocked user.
PR:§12 轮 —— 对标语法批待拍项的落地(DEC-N1/N3/N4/N5/N6 + AUTH-VISUAL + GA4 取证)
分支
worktree-ui-grammar-two-axis→dev。基线 =da9a5cb6,本 PR 在 §11(0ae765af)之上继续。变更摘要
把
docs/acceptance/qa-tracker.md§11.4/§11.5 登记的待拍项按决策人的裁定(「均采用推荐方案」)逐条落地:src/lib/cms/revalidation.ts把modelCode → paths的失效推导从路由体里提成纯函数 + 可导入出口,接到后台四条变更链(items 的 POST/PUT/DELETE、workflow 的四个动作、zones 的写与删)。
此前那 8 个页面注释里的「CMS 发布/更新时主动刷新」没有任何生产调用方,
s-maxage=3600下最长 1 小时前台仍端出已删/旧内容。check:accents新增判据 B(内联style色彩通道 + 色值真源),产品线 7 个色相作为受控例外保留(按 文件+色值 登记、色值归一化为
#rrggbb、豁免命中归零亦判红、棘轮MAX_NON_BRAND_HUES=7)。落盘即抓到erp-upgrade-v3/page.tsx抄主题的真漂移。check:motion的 8 处基线红归零;时长判据从「令牌声明」移到「消费点」(实测--transition-gentle在src/零消费)。src/lib/constants/case-publish-gate.ts,成果槽 /CaseStudiesSection/detail-trust-section三处共用一道闸。e2e/tsconfig.json+type-check:e2e并入test:all;.husky/pre-commit索引位 100644→100755;axe 证据改为按运行轮次落盘(旧路径保留 latest 指针);新增
scripts/check-package-keys.mjs(JSON 重复键守卫,按父路径分组)。staggerDelay默认一直是0.05(50ms,本就在 ADR-0004 的 30–60ms 内),git log -S查「0.15」在该文件历史里无任何提交 ⇒ 台账那个数是上一轮叙述的抄本。已在 ADR-0008 就地标注更正。--radius-cta: 12px负对照证明基线对该维敏感。caseStudies(product / service / standalone-product)补authorized(boolean)与basis(复用metricBasisField的选项表 ⇒ 口径真源仍只有一份),并新增契约守卫src/lib/cms/case-field-contract.test.ts:站点计数写死三处(新增带案例的内容类型忘带门槛字段即判红)、形状契约、两维各缺一条都被闸住、字段全缺 fail-closed、以及「摘掉字段时守卫必须报问题」的仪器自证。
本地
npm run db:seed已把声明带进ContentModel.fields(ContentItem38 → 38 未变,跑前先cp备份 ⇒ 不是盲跑重建)。mainNav已是 行业 / 能力 / 洞察 / 关于我们(无「产品」一级),且 seed 前后
length(data) = 2778逐字节不变;nav-dropdown+p6-missing-paths× 2 project 26 passed / EXIT=0是在「该行被采纳」的前提下跑绿的 ⇒ 不写库,判定关闭。生产侧同名行同形属部署期核对项。
qa-tracker.md§12.1–§12.12、lessons-learned.md§5.44–§5.46、ADR-0008 决策五、README.md/CONTEXT.md/CLAUDE.md/docs/development/quality-gates.md。关联 Issue
N/A:本批是 §11 收尾时决策人留给自己的编号待拍清单(DEC-N1…N6 / AUTH-VISUAL / AUTH-NAV),无独立 Issue 单;
来源与逐条处置见
docs/acceptance/qa-tracker.md§12。提交前检查
bash scripts/check-pr-checklist.sh通过(见「其他说明」里的执行读数)全链路检查
npm run type-check通过(0 error)npm run lint:0 error,warning 数与改动前基线逐行比对无新增(读数见「其他说明」;test:all内跑)erp-upgrade-v3/page.tsx改的是主题解析(getHeroTheme(heroThemeId ‖ 'erp')),库内实值确认
erp行heroThemeId='erp'⇒ 目的地与渲染均不变content-types.ts三处caseStudies补authorized/basis,prisma/seed.ts:364由它生成ContentModel.fields,npm run db:seed已在本地 dev.db 执行并验证(三行都含新键、
ContentItem38→38 未变)。生产库未动:ContentItem.data是 JSON 列 ⇒ 无表迁移、不产生migration 文件,生产侧字段声明与
navigation行同形核对随部署一起做var(--ease-ink)/var(--transition-slower),未引入裸色值)ease-ink[0.22,1,0.36,1]、stagger 实测默认 0.05(50ms ≤ 60ms);写死贝塞尔 6 处全部收进令牌层,超上限档位禁止接入非循环声明
#C41E3A:触达点与面积判据由check:contrast/check:brand-token/check:accents三闸断言,本批读数全绿basis==='verified'门槛从成果槽扩到两处既有区块;禁词真源仍是metrics-basis.ts,无第二套console.log/TODO/.todo():新增代码里的console.error只有两类且都是有意的运维信号(
[revalidation-failed]与门槛封条原因),check:deadEXIT=0、lint0 error测试分层检查(L0–L3)
src/lib/cms/revalidation.test.ts(18 例,纯映射对账真实CONTENT_TYPE_CONFIGS)与
src/lib/constants/case-publish-gate.test.tscache-invalidation.test.ts(7 例,断言「调用点存在」本身)+ 两处区块的负例;--testPathPatterns products4 套件 48 例 EXIT=0test:e2e:fast在test:all内跑,读数见「其他说明」;另在终版产物上单独取 GA4
@critical16 passed / 0 skipped(历史上这批在 dev 目标下是 skipped,本轮把
.env.production供进 worktree 后首次真断言,并核对G-LGTLCR15KM确已烘进客户端 chunk)--update-snapshots=none只读复跑,并做
--radius-cta: 12px负对照(若该改动不引起任何 diff,则基线什么都没拍、只读绿灯作废)check:accents:selftest11 情景各测一维;check:package-keys --selftest三条(同层重复必抓 / 异父同名不误报 / 真文件正对照)+ 真
package.json活体注入;check:motion真树三处注入.only()/ 跳过态残留(唯一skip语义是 GA4 在无 GA id 的树上主动跳过,本轮已消除)质量门禁
npm run test:unit全部通过(145 套件 / 1795 例,较 §11 增 4 套件 48 例)npm run test:coverage通过config/test/jest.config.js的coverageThreshold,未下调任何阈值(DEC-N5 新增的是纯函数与调用点断言,覆盖率只增不减;读数见「其他说明」)
「
npm run test:功能 + 视觉两条链读数见其他说明」,但本批实际只跑过test:e2e:fast、test:visual:all、prod 目标 GA4 与受影响旅程 —— 全量test:functional从未跑过,勾得不对。补跑后走完一整轮定性 → 修根因:
36 failed → 2 → 1 → **0**,最终读数 1068 passed / 0 failed / 44 skipped,EXIT=0(4 project、默认 workers)。
期间修掉的真因包括:一条 fail-open(门槛算而不施)、4 个触摸目标 23px、
role="region"缺名、登录与联系表单两处进程内限流的结构性 429、三处 hydration 前的点击(logo/导航/焦点)、面板 280ms 动画下的 hover、以及
跨 worktree 绝对 DATABASE_URL 造成的整库覆盖(含写前中止的守卫)。
全量过程与逐条读数见
docs/acceptance/qa-tracker.md§14.1–§14.5。npm run check:contrast与npm run check:headings通过(在check:a11y内,test:all跑)npm run lighthouse满足lhci断言(在终版重建产物上重跑,非 00:04 前的旧装配)npm run test:security:headers通过(本批不改响应头/CSP/部署配置,仍随test:all跑一遍确认无外溢)README.md/CONTEXT.md/CLAUDE.md/docs/development/quality-gates.md/docs/adr/0008-*.md/docs/lessons-learned.md/docs/acceptance/qa-tracker.md;代码注释给出决策佐证来源(每条都带 §编号或文件行号)(失效链 / 动效 / 门槛 / 闸与卫生 / 文档各成一笔)
force push 不需要(分支从未推过);合并与推远端按仓库规矩单独取得授权后方执行
假绿灯纪律
编号四条(
docs/lessons-learned.md§5.44–§5.47 —— 冻结别人的中间态并按子串取行号sed删掉了整条test:all、校验仪器对目标维度不敏感、车道编排端口错、算出
TSC=2仍把 commit/push 做完并在信息里写EXIT=0),另有四次当场纠正未编号:Edit 吃掉
metricBasisField的声明行、误停一条正在正常写基线的车道、逐名对账拿中文用例名去匹配 slug 文件名、以及
sqlite3的no such column: code被2>/dev/null吞掉后把空输出读成「dev.db 里没有 navigation 行」(
qa-tracker.md§12.12c)。其中
1426dd1c⇒bceba3f5的纠正链是这条纪律的直接后果:把两个退出码写进同一条&&依赖链才允许提交。skip/todo、下调阈值让门禁变绿。唯一被改写的判据是
check:motion的判定位置(令牌声明 → 消费点),其依据是实测「该档位零消费」,并配了真树注入的负对照证明移动后仍能判红;
coverageThreshold一行未动erp-upgrade-v3那条是判据 B 抓到的真漂移(已核数据等价性),不是假阳;use.reducedMotion那 5 条是运行时确实被忽略的类型误用,用@ts-expect-error就地登记为残留而非「修掉」,理由与正确写法的代价写在注释里(改
contextOptions会真的改截图 ⇒ 与本轮基线重采相撞)origin/*与实测为准:基线取origin/dev顶端,未用本地陈旧 ref 推断历史①
check:dead/check:motion仍不在test:all(CI 口径未变);②
CMS本批已闭合(声明 + 契约守卫 + 本地 seed 验证);caseStudiesschema 缺authorized/basis字段改写为「生产侧
ContentModel.fields与navigation行的同形核对」,属部署期动作;③ AUTH-NAV(CMS
navigation/default行改写)未执行,现行代码 fail-closed 供数;④ 视觉基线的逐张人工读图追认只做抽样,全量 104+ 张需决策人分批追认;
⑤
e2e/**/*.ts的 6 条既有类型误用按残留登记(@ts-expect-error),未顺手改写运行时行为其他说明
check:motioncheck:motion:test21/21check:accents--selftest11 情景 EXIT=0check:package-keys"lint"⇒ EXIT=1 点名scripts.lint,还原 ⇒ 0type-check/type-check:e2econst⇒ EXIT=2(TS2451×2)check:visual/check:deadnpm run test:all(十段伞形)type-check+check:package-keys+type-check:e2e+lint+test:coverage+test:integration:real(23 例)+check:a11y+check:visual+test:e2e:fast+test:security:headers,coverage 阈值一行未动。那一次 EXIT=1 有归因读数:两条红全在p6-missing-paths.spec.ts的 firefox 单 project ⇒ ①数据面排除:db:seed前后逐模型行数与product的 slug 集合逐一对账未变;②代码面排除:单跑该 spec--project=firefox⇒ 9 passed;③机理:playwright.config.ts:12-15是fullyParallel:true+retries: CI?2:0+workers: CI?1:undefined⇒ 本地全速并行零重试下 firefox 大页墙钟抖动,CI 有 retries=2+workers=1 兜住。未用放宽断言或加 retry「修」;全文见qa-tracker.md§12.13@critical(终版产物)G-LGTLCR15KM两处 chunk 命中check:axe:routesEXIT=0、check:axeEXIT=0(34 路由 × chromium/firefox × light/dark,bgMismatch=0、contrastNodes=0、violationNodes=0、unexpectedStatus=0、non2xxResponses=1 = 期望内的/_not-found)visual-manifest-post-schema.jsontotal=125 / failed=0);负对照--radius-cta=12px⇒ 15 failed / EXIT=1,还原 ⇒ 25 passedinput-default/focused× 4 桌面类 project、mobile 的button-*3 张与header-navigation),并删掉 5 张孤儿参照founder-quote-section-*(该区块已退役、断言早改成toHaveCount(0)反向守卫);删后每 project 恰好 25 张 = 用例数npm run lighthouseEXIT=0(11 URL × 3 跑)run-post-schema-lane.sh)评审者请特别关注:
revalidateContent是尽力而为(数据与审计已落库后执行,逐条 try +[revalidation-failed]日志 +failed回报),因为刷缓存失败不该把一次成功的写入连带变成 500;HTTP 入口
/api/cms/revalidate仍用严格的applyRevalidation,500 语义不变。