#!/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 || '', 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 || ''} 里的 "${d.key}"`); process.exit(1);