Files
novalon-website/scripts/check-package-keys.mjs
zhangxiang ffd709ae06 feat(gates): DEC-N1 把 accent 第二条通道钉成判据 B,并抓到一条绕开色值真源的真漂移
裁定:7 个产品线色相**保留**为受控例外(实测 hero 徽章占视口 0.538%、色相仅以 6.3% alpha
底纹存在、1600×846 hero 视口冷色像素普查 = 0),但**不再**让 check:accents 的口径停在「仅类名通道」——
那等于第二条通道无人看守。判据 B 扫三处:真源 hero-themes 的 accentColor/accentBg、
可达营销代码里 style={{…}} 的色彩属性(含 --badge-accent 与内联引用 accent 令牌的更隐蔽形态)、
营销页就地组装 accentColor。豁免按 文件+色值 登记且归一化成 #rrggbb(否则换个 rgba() 写法就绕过);
登记了却命中 0 ⇒ 判红;棘轮 MAX_NON_BRAND_HUES=7,存量恰在上限 ⇒ 第 8 个色相即判红。

战果:落盘即抓到 erp-upgrade-v3/page.tsx 的 deriveTheme() 在营销页里抄了一整份 theme
(含 accentColor '#1e3a5f' 与两段渐变)绕开真源。改走 getHeroTheme(heroThemeId || 'erp') 只覆盖动态字段 badge;
与真源逐字段对拍全等,并用库内实值确认 erp 行 heroThemeId='erp' ⇒ 渲染不变(查过,不是推定)。

自证与改正(原稿从未跑成过):selftest 11 情景 EXIT=0,每情景只喂一维。
修掉两处不自洽 —— 把「另一维的豁免腐化」当串维证据会让自证永远红(腐化只是该维没喂料的必然产物,
违规数才是证据),以及 4 情景棘轮期望与 分母0 情景 stale(写 9、实取 7)按实测改正。

连带新增 scripts/check-package-keys.mjs:按父路径+键名分组查 JSON 重复键,退出码 0/1/2 三档,
--selftest 三条各测一维;活体负对照注入重复 "lint" 键 ⇒ EXIT=1 点名 scripts.lint,还原 ⇒ EXIT=0。
背景见 qa-tracker §12.8:我先前用来去重的那条 node 回读只扫顶层缩进,对目标那一维根本不敏感。

读数:check:accents 0、check:visual 0、tsc 0、jest --testPathPatterns products 48 例 0、selftest 0。
ADR-0008 补决策五并 supersede 决策一的「本批不收」,同时把被证伪的 DEC-N2 默认值 0.15 就地标注更正。
2026-10-17 08:07:10 +08:00

103 lines
4.2 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env node
/**
* package.json 重复键守卫(DEC-N6 连带)。
*
* 为什么要有这个文件:JSON 的重复键**不报错**,`JSON.parse` 让后者静默覆盖前者,
* 于是 "npm run type-check:e2e" 被写了两遍时,脚本数、退出码、CI 读数全都看不出异常。
* 本仓在并行分工下真就这么踩了一次(1c0ce5f4 冻结的就是中间态)。
*
* 我上一版用它做校验时把仪器写废了:正则 `^ "key":` 只匹配**顶层**(两空格缩进),
* 而重复键在 `scripts` 对象里(四空格)⇒ 报 `dups=[]` 却对目标那一维根本不敏感。
* 所以这里按「父路径 + 键名」分组计数,并且**自带负对照**:
* 喂一份明知重复的样本,不判红就宣布上面的 ok 都不作数。
*
* 退出码三档:0 无重复 / 1 有重复 / 2 未能度量(文件读不到或解析失败)。
*/
import { readFileSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
// 注意层级:base 是 scripts/check-package-keys.mjs 本身,'..' 只退一级就到仓库根。
// 写成 '../../package.json' 会退两级落到 .qoder/worktrees/ ⇒ 读不到文件、报 EXIT=2,
// 而 EXIT=2 是「未能度量」不是「无重复」——负对照两次都撞在这个错上(本仓 §5.42 的同族)。
const TARGET = new URL('../package.json', import.meta.url);
function findDuplicateKeys(raw) {
const lines = raw.split('\n');
const stack = []; // 每层的容器名;数组用 '#'
const seen = new Map(); // path -> Set(keys)
for (const line of lines) {
const stripped = line.trim();
if (!stripped) continue;
// 先出栈:本行以 } 或 ] 开头表示上一层结束
while (stack.length && /^[}\]]/.test(stripped)) stack.pop();
const m = stripped.match(/^"([^"]+)"\s*:/);
if (!m) {
// 数组元素等非键行;`,` 结尾的容器关闭由下一轮处理
continue;
}
const key = m[1];
const path = stack.join('.');
if (!seen.has(path)) seen.set(path, new Set());
if (seen.get(path).has(key)) {
return [{ path: path || '<root>', key }];
}
seen.get(path).add(key);
// 若本行的值以 { 或 [ 开头,则该键成为下一层的容器(单行对象不展开)
const after = stripped.slice(m[0].length);
if (/^\{/.test(after.trim()) && !/\}/.test(after)) stack.push(key);
else if (/^\[/.test(after.trim()) && !/\]/.test(after)) stack.push(key + '.#');
}
return [];
}
function selftest() {
// 正对照:同一份真文件若确实无重复,判绿
const dup = findDuplicateKeys('{"a":{"x":1},"b":{"y":2}}\n'.replace(/\n$/, ''));
// 负对照 1:同层重复键必须抓到(这是本仪器存在的意义)
const neg1 = findDuplicateKeys('{\n "scripts": {\n "a": "1",\n "a": "2"\n }\n}');
// 负对照 2:不同父路径下的同名键不得误报(否则守卫会把所有嵌套键全判红)
const neg2 = findDuplicateKeys('{\n "scripts": {\n "a": "1"\n },\n "lint-staged": {\n "a": "2"\n }\n}');
const ok = dup.length === 0 && neg1.length === 1 && neg2.length === 0;
console.log(
`[selftest] 正对照=${dup.length === 0 ? 'ok' : 'FAIL'} ` +
`负对照-重复必抓=${neg1.length === 1 ? 'ok' : 'FAIL'} ` +
`负对照-异父不误报=${neg2.length === 0 ? 'ok' : 'FAIL'}`
);
if (!ok) {
console.error('[selftest] 仪器自证失败 ⇒ 任何 ok 读数都不作数');
process.exit(1);
}
}
const args = process.argv.slice(2);
if (args.includes('--selftest')) {
selftest();
console.log('SELFTEST_EXIT=0');
process.exit(0);
}
let raw;
try {
raw = readFileSync(TARGET, 'utf8');
} catch (e) {
console.error(`未能度量:读不到 ${fileURLToPath(TARGET)} —— ${e.message}`);
process.exit(2);
}
try {
JSON.parse(raw);
} catch (e) {
console.error(`未能度量:package.json 解析失败 —— ${e.message}`);
process.exit(2);
}
const dups = findDuplicateKeys(raw);
if (dups.length === 0) {
console.log('package.json 重复键:0(按父路径分组计数;自证见 --selftest)');
process.exit(0);
}
for (const d of dups) console.error(`重复键判红:${d.path || '<root>'} 里的 "${d.key}"`);
process.exit(1);