107 lines
4.5 KiB
JavaScript
107 lines
4.5 KiB
JavaScript
import { test } from 'node:test';
|
||
import assert from 'node:assert/strict';
|
||
import { readFileSync, readdirSync } from 'node:fs';
|
||
|
||
// system-fingerprints.md 的维护约定是「新增系统分支须同步加行」——本测试把它变成检查：
|
||
// 任何一个分支文件必须出现在 MAPPED（映射到指纹表里的某个名字）或 EXEMPT（非系统文件，须写明理由）。
|
||
// 新增分支却两处都没登记 → 红线；这样"约定"就不会随时间失效。
|
||
const FP = '.claude/skills/re-analyze/references/system-fingerprints.md';
|
||
const ROOT = '.claude/skills/';
|
||
const DIRS = ['re-kernel', 're-rtos', 're-hypervisor', 're-automotive', 're-uefi'];
|
||
|
||
// 分支文件 → 指纹表里应出现的关键字（可用多个，任选其一命中即可）
|
||
const MAPPED = {
|
||
're-kernel/windows-kernel': ['Windows'],
|
||
're-kernel/linux-kernel': ['Linux'],
|
||
're-kernel/macos-kernel': ['macOS'],
|
||
're-kernel/android-kernel': ['Android'],
|
||
're-kernel/sel4-kernel': ['seL4'],
|
||
're-kernel/zircon-kernel': ['Fuchsia'],
|
||
're-kernel/freebsd-kernel': ['FreeBSD'],
|
||
're-kernel/netbsd-kernel': ['NetBSD'],
|
||
're-kernel/openbsd-kernel': ['OpenBSD'],
|
||
're-kernel/illumos-kernel': ['illumos'],
|
||
're-kernel/genode': ['Genode'],
|
||
're-kernel/minix3': ['MINIX 3'],
|
||
're-kernel/plan9': ['Plan 9'],
|
||
're-kernel/helenos': ['HelenOS'],
|
||
're-kernel/redox': ['Redox'],
|
||
're-kernel/haiku': ['Haiku'],
|
||
're-kernel/hic': ['HIC'],
|
||
're-kernel/zos': ['z/OS'],
|
||
're-kernel/ibmi': ['IBM i'],
|
||
're-kernel/openvms': ['OpenVMS'],
|
||
're-kernel/unikraft-mirageos': ['Unikraft', 'MirageOS'],
|
||
're-rtos/qnx': ['QNX Neutrino'],
|
||
're-rtos/vxworks': ['VxWorks'],
|
||
're-rtos/zephyr': ['Zephyr'],
|
||
're-rtos/rtems': ['RTEMS'],
|
||
're-rtos/nuttx': ['NuttX'],
|
||
're-rtos/ecos': ['eCos'],
|
||
're-rtos/freertos-context': ['FreeRTOS'],
|
||
're-rtos/threadx-modules': ['ThreadX Modules', 'ThreadX'],
|
||
're-rtos/safertos-rtx5': ['SAFERTOS'],
|
||
're-rtos/tkernel-toppers': ['T-Kernel', 'TOPPERS'],
|
||
're-rtos/ose-oseck': ['OSE / OSEck', 'OSE'],
|
||
're-rtos/nucleus': ['Nucleus'],
|
||
're-rtos/ucos-sysbios': ['µC/OS', 'SYS/BIOS'],
|
||
're-rtos/partitioned-rtos': ['INTEGRITY', 'PikeOS', 'ARINC 653', 'Deos'],
|
||
're-hypervisor/xen': ['Xen'],
|
||
're-hypervisor/qnx-hypervisor': ['QNX Hypervisor'],
|
||
're-hypervisor/jailhouse': ['Jailhouse'],
|
||
're-hypervisor/acrn': ['ACRN'],
|
||
're-hypervisor/bao': ['Bao'],
|
||
're-hypervisor/hyperv-vmbus': ['Hyper-V'],
|
||
're-hypervisor/xtratum': ['XtratuM'],
|
||
're-hypervisor/lynxsecure': ['LynxSecure'],
|
||
're-hypervisor/questv': ['Quest-V'],
|
||
're-automotive/autosar-classic': ['AUTOSAR Classic'],
|
||
're-automotive/autosar-adaptive': ['AUTOSAR Adaptive'],
|
||
're-uefi/pi-stages': ['UEFI'],
|
||
};
|
||
|
||
// 非系统分支（平台专属补充资料，不属于"某个系统"）
|
||
const EXEMPT = {
|
||
're-kernel/windows-gotchas': 'Windows 版本差异组，随 windows-kernel 分支',
|
||
're-kernel/windows-decision-tree': 'Windows 场景决策树，随 windows-kernel 分支',
|
||
};
|
||
|
||
function branchFiles() {
|
||
const out = [];
|
||
for (const d of DIRS) {
|
||
let names;
|
||
try { names = readdirSync(`${ROOT}${d}/references`); } catch { continue; }
|
||
for (const n of names) {
|
||
if (n.endsWith('.md')) out.push(`${d}/${n.replace(/\.md$/, '')}`);
|
||
}
|
||
}
|
||
return out.sort();
|
||
}
|
||
|
||
test('每个系统分支都在指纹表里有对应条目', () => {
|
||
const fp = readFileSync(FP, 'utf8');
|
||
const bad = [];
|
||
for (const [file, keys] of Object.entries(MAPPED)) {
|
||
if (!keys.some((k) => fp.includes(k))) bad.push(`${file}：指纹表里找不到 ${keys.join(' / ')}`);
|
||
}
|
||
assert.deepEqual(bad, [], `指纹表缺条目：\n${bad.join('\n')}`);
|
||
});
|
||
|
||
test('新增分支必须登记到映射或豁免表（防约定失效）', () => {
|
||
const known = new Set([...Object.keys(MAPPED), ...Object.keys(EXEMPT)]);
|
||
const unregistered = branchFiles().filter((f) => !known.has(f));
|
||
assert.deepEqual(unregistered, [],
|
||
`以下分支既未映射到指纹表、也未列入豁免——请补 MAPPED（并在指纹表加行）或写明豁免理由：\n${unregistered.join('\n')}`);
|
||
});
|
||
|
||
test('映射表引用的分支文件都还存在（防改名后残留）', () => {
|
||
const files = new Set(branchFiles());
|
||
const stale = [...Object.keys(MAPPED), ...Object.keys(EXEMPT)].filter((f) => !files.has(f));
|
||
assert.deepEqual(stale, [], `映射表里有已不存在的分支：${stale.join(' ')}`);
|
||
});
|
||
|
||
test('豁免项必须写明理由', () => {
|
||
const empty = Object.entries(EXEMPT).filter(([, why]) => !why || why.length < 4).map(([f]) => f);
|
||
assert.deepEqual(empty, [], `豁免项缺理由：${empty.join(' ')}`);
|
||
});
|