diff --git a/docs/lessons-learned.md b/docs/lessons-learned.md index 6f2ecb1..b294086 100644 --- a/docs/lessons-learned.md +++ b/docs/lessons-learned.md @@ -845,3 +845,23 @@ cd e2e && npx playwright test <改动的 spec> --list # Total: N tests in M fi 值得记的是**这次失败没有骗人**:分母为 0 走 EXIT=2 而不是 0,闸崩溃走 FATAL 而不是静默通过 —— 退出码分档(0 通过 / 1 判红 / 2 未能度量 / FATAL)在这里第二次兑现价值。 纪律:编排脚本前先 `grep -n 'process.env\|BASE\|PORT' <脚本>` 读它自己的默认值。 + +### 5.47 看见了红仍然提交:读数的时序 ≠ 门禁的时序(2026-10-17) + +我在同一条命令里先算出 `TSC=2`(新测试里一处 `blocked[0]` 在 `noUncheckedIndexedAccess` 下可能 undefined), +接着却照原计划把 commit 与 push 做完,而提交信息里写着「tsc EXIT=0」—— +那是**我打算去修的那个未来状态**,不是这一笔的实测状态。 +这是 §5.44(提交信息声称做了没做进去)的变种:**信息引用了尚未成立的读数**。 + +修法是机械的,不是意志力的:把「测量」和「提交」写进同一条依赖链,红就不可能穿过—— + +```bash +npx tsc --noEmit > /tmp/tc.log 2>&1; A=$? +npx jest <改动面> > /tmp/jt.log 2>&1; B=$? +if [ "$A" -eq 0 ] && [ "$B" -eq 0 ]; then git add … && git commit … && git push; else echo NOT_COMMITTING; fi +``` + +⇒ 纪律:**任何「我看见了但打算随后修」的红灯,都不允许进入这一笔的提交信息**; +要么先修完再测再提交,要么在信息里显式写成已知红并说明去向。 +本地 `pre-commit`(lint-staged)因 `core.hooksPath` 指向主检出而未执行, +所以这道依赖链只能由我来编排 —— 这本身就是 §12.8 记的那条口径的现实后果。 diff --git a/src/lib/cms/case-field-contract.test.ts b/src/lib/cms/case-field-contract.test.ts index 5842b0e..888b136 100644 --- a/src/lib/cms/case-field-contract.test.ts +++ b/src/lib/cms/case-field-contract.test.ts @@ -68,9 +68,16 @@ describe('DEC-N4 · caseStudies 的 schema 契约', () => { expect(gateCaseItems([ok]).publishable).toHaveLength(1); expect(gateCaseItems([ok]).blocked).toHaveLength(0); // 反例:有授权但口径是目标 ⇒ 仍闸住(闸要真的两维都看) - expect(gateCaseItems([{ ...ok, basis: 'target' }]).blocked[0].blockers.join()).toContain('verified'); + const targetOnly = gateCaseItems([{ ...ok, basis: 'target' }]); + const targetBlocked = targetOnly.blocked[0]; + // 显式取局部变量而不是 chain 到 blocked[0].x:noUncheckedIndexedAccess 下 + // 「按下标取再点属性」必须是可判定的(tsc 就是这么抓到上一版的 TS2532 的) + if (!targetBlocked) throw new Error('夹具没被闸住:口径维判据失效,本用例失去意义'); + expect(targetBlocked.blockers.join()).toContain('verified'); // 反例:口径 verified 但没授权 ⇒ 闸住 - expect(gateCaseItems([{ ...ok, authorized: false }]).blocked.length).toBe(1); + const noAuth = gateCaseItems([{ ...ok, authorized: false }]); + expect(noAuth.publishable).toHaveLength(0); + expect(noAuth.blocked).toHaveLength(1); // 反例:字段全缺(既有 seeds/CMS 的真实形状)⇒ fail-closed,一条都不出 expect(gateCaseItems([{ client: 'x', result: 'y' }]).publishable).toHaveLength(0); });