worktree-ui-grammar-two-axis
dev
本 PR 只含一笔:docs/acceptance/qa-tracker.md 的 §13 —— 记录 #33 以 fast-forward-only 合入 dev (47 笔 sha 逐字不变)、Gitea merge 端点要求 do 字段这条口径,以及「dev→main 不由代理执行」的理由。 代码与证据全部在 #33(已合入 dev)。下面的门禁清单沿用 #33 那一份描述文件,本笔未再改动任何代码, 故其读数为「与 #33 终版一致 + 本笔仅文档」;tsc 与 check-pr-checklist 在本笔 HEAD 上重新复算过。
docs/acceptance/qa-tracker.md
do
tsc
check-pr-checklist
分支 worktree-ui-grammar-two-axis → dev。基线 = da9a5cb6,本 PR 在 §11(0ae765af)之上继续。
da9a5cb6
0ae765af
把 docs/acceptance/qa-tracker.md §11.4/§11.5 登记的待拍项按决策人的裁定(「均采用推荐方案」)逐条落地:
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
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
- 合并方式选 FF 而非 rebase:origin/dev 原 tip 8026d917 是 HEAD 的严格祖先 (merge-base --is-ancestor EXIT=0),FF 后 47 笔 sha 逐字不变、origin/dev = 6d46dbe8。 理由同 §10.9:本仓记过 rebase 造成「同标题异 hash」的拓扑分叉之痛。分支未删。 - 422「[Do]: Required」要按字面读:这套 Gitea 的 merge 端点把表单字段 do 当必填, 补 {"do":"fast-forward-only"} 后 HTTP 200。不是权限、不是缺审批 (reviews=[]、mergeable=true、draft=false)。另 GET /pulls/n/merge 与 /branches/protection 在本实例 404 属端点不存在,不得当成「无保护」的证据。 - dev→main 不由代理执行:Jenkinsfile 的部署阶段带 when { branch 'main' }, 合 main = 授权一次无人值守的线上发布;生产侧字段与 navigation 行同形核对随发布做。 - 终版读数一览:tsc / type-check:e2e / check:package-keys / check:visual / check:dead / check:motion / build / check:axe / lighthouse 均 EXIT=0;jest 146 套件 1799 例 EXIT=0; 视觉逐名清单 125/125;GA4 16 passed。PR 描述门禁 checklist EXIT=0(31 子项)。
8026d917
No dependencies set.
The note is not visible to the blocked user.
仅文档:§13 治理闭环(承接已合并的 #33)
本 PR 只含一笔:
docs/acceptance/qa-tracker.md的 §13 —— 记录 #33 以 fast-forward-only 合入 dev(47 笔 sha 逐字不变)、Gitea merge 端点要求
do字段这条口径,以及「dev→main 不由代理执行」的理由。代码与证据全部在 #33(已合入 dev)。下面的门禁清单沿用 #33 那一份描述文件,本笔未再改动任何代码,
故其读数为「与 #33 终版一致 + 本笔仅文档」;
tsc与check-pr-checklist在本笔 HEAD 上重新复算过。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(Playwright E2E):功能 + 视觉两条链读数见「其他说明」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 语义不变。