From bceba3f553b32933ddce1dedb07aa7f463675b26 Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Sat, 17 Oct 2026 08:58:00 +0800 Subject: [PATCH] =?UTF-8?q?test(cms):=20=E4=BF=AE=201426dd1c=20=E7=95=99?= =?UTF-8?q?=E4=B8=8B=E7=9A=84=20tsc=20=E7=BA=A2=EF=BC=88TS2532=EF=BC=89?= =?UTF-8?q?=EF=BC=8C=E5=B9=B6=E6=8A=8A=E3=80=8C=E7=9C=8B=E8=A7=81=E7=BA=A2?= =?UTF-8?q?=E4=BB=8D=E6=8F=90=E4=BA=A4=E3=80=8D=E8=AE=B0=E6=88=90=20=C2=A7?= =?UTF-8?q?5.47?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 上一笔的提交信息写着 tsc EXIT=0,实取 EXIT=2:新契约测试里 gateCaseItems(...).blocked[0].blockers 在 noUncheckedIndexedAccess 下是「可能 undefined」, 而我在同一条命令里已经算出 TSC=2,却照原计划把 commit/push 做完了 —— 信息引用的是「我打算去修的未来状态」,不是这一笔的实测状态(§5.44 的变种)。 - 改法:先取局部变量再显式守卫(if (!blocked) throw 夹具没被闸住), 不用 chain 下标、也不用 ! 断言 —— 前者不可判定、后者是把判据关掉。 - 管理归零:把「测量」与「提交」写进同一条依赖链(A/B 两个退出码都 0 才允许提交), 红不可能穿过;本地 pre-commit 因 hooksPath 指向主检出而不执行,所以这条只能靠编排纪律。 - 复算(以 HEAD 为准,不是以工作树为准):tsc --noEmit EXIT=0、 jest case-field-contract 4 例 EXIT=0。 --- docs/lessons-learned.md | 20 ++++++++++++++++++++ src/lib/cms/case-field-contract.test.ts | 11 +++++++++-- 2 files changed, 29 insertions(+), 2 deletions(-) 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); });