carlos-flow 2.6.0 → 2.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,293 +1,238 @@
1
1
  #!/usr/bin/env node
2
- // check-repo-parity.mjs — 双仓一致性守卫(cindy ↔ opencode)
2
+ // check-repo-parity.mjs — 单包一致性守卫(v2.6.0+)
3
3
  //
4
- // 目的:防止「跨仓同步」时把某一版的文件整份覆盖到另一版,
4
+ // 历史背景:v2.5.x 是「双仓架构」(carlos-flow-cindy + carlos-flow-opencode),
5
+ // 这个脚本负责防止跨仓同步时把某一版的文件整份覆盖到另一版,
5
6
  // 导致两个适配版身份混淆(例如 opencode 仓的 README 变成「Cindy 适配版」)。
6
7
  //
7
- // 判定规则(与 scripts/release.mjs 的双仓发布链路配套):
8
- // 1) 【必须逐字一致】核心逻辑 src/ + test/ + scripts/ + CI —— 任一不同即报错;
9
- // 2) 【必须各自不同】版本专属文件 —— 出现在对方仓里即报错(交叉污染);
10
- // 3) 【必须指向自己】身份标识 —— README 标题 / package.json name / description
11
- // 若指向对方版本,即报错;
12
- // 4) 【允许不同】package.json 的 name/description/keywords/repository/files/scripts。
8
+ // v2.6.0 起合并为**单一包** carlos-flow,双仓比对已无意义 ——
9
+ // 跨版本漂移的根因(两份核心逻辑各自维护)已经消除。
10
+ // 但「身份一致性」这个诉求依然成立,且更重要:单一包对外宣称自己是
11
+ // 一个统一的六平台产品,任何一处版本号/文档/清单不一致都会直接暴露给用户。
12
+ //
13
+ // 所以本脚本从「双仓比对」重构为「单包身份与产物一致性守卫」:
14
+ // 1) 【身份】package.json.name 必须是 carlos-flow(不是旧的 -cindy / -opencode)
15
+ // 2) 【版本】package.json / package-lock.json / ghost.json / TRIGGER_GUIDE.md
16
+ // 四处版本号必须完全一致
17
+ // 3) 【文档】README.md 与 README.zh.md 必须逐字一致(双语不漂移)
18
+ // README.en.md 必须是英文版(不是中文副本)
19
+ // 4) 【产物】npm 包内容必须包含 6 平台初始化所需的全部文件,
20
+ // 且不含敏感/临时文件(.npmrc / secret / .bak / fix_ / debug_)
21
+ // 5) 【模板】templates/ 下 4 套模板 + opencode.json.template + .mcprc.template
22
+ // 必须存在且是合法 JSON
13
23
  //
14
24
  // 用法:
15
- // node scripts/check-repo-parity.mjs # 检查(默认对方仓在 ../carlos-flow-<other>)
25
+ // node scripts/check-repo-parity.mjs # 检查
16
26
  // node scripts/check-repo-parity.mjs --check # 同上(默认即 check)
17
- // node scripts/check-repo-parity.mjs <对方仓路径> --write
18
- //
19
- // 退出码:0 = 一致;1 = 发现不一致(并打印逐条明细)。
20
27
  //
21
- // 说明:比较时忽略行尾符(CRLF/LF)——两仓 .gitattributes / core.autocrlf 不同,
22
- // 同一份内容在不同机器上落盘可能行尾不同,那不是实质差异。
23
- import { readFileSync, existsSync } from "node:fs";
28
+ // 退出码:0 = 一致;1 = 发现不一致(逐条打印明细)。
29
+ import { readFileSync, existsSync, readdirSync, statSync } from "node:fs";
24
30
  import { fileURLToPath } from "node:url";
25
- import { join, resolve, dirname, relative, basename } from "node:path";
31
+ import { join, resolve, dirname } from "node:path";
26
32
 
27
33
  const HERE = dirname(fileURLToPath(import.meta.url));
28
- const SELF_ROOT = resolve(HERE, "..");
29
- const SELF_NAME = basename(SELF_ROOT).replace(/^carlos-flow-/, "");
30
- const PEER_NAME = SELF_NAME === "cindy" ? "opencode" : "cindy";
31
-
32
- // ---- 参数解析 ----
33
- const argv = process.argv.slice(2);
34
- const writeMode = argv.includes("--write");
35
- const peerArg = argv.find((a) => !a.startsWith("--"));
36
- const PEER_ROOT = resolve(peerArg || join(SELF_ROOT, "..", `carlos-flow-${PEER_NAME}`));
37
-
38
- // ---- 单仓降级 ----
39
- // npm 安装后只有**本仓**(对方仓不在同一个父目录),此时无法做双仓比对。
40
- // 这不是错误 —— 直接优雅跳过并 exit 0,否则用户误跑 npm run check:parity 会看到红色报错。
41
- // 需要真正检查时:显式传对方仓路径,或在本地双仓 checkout 的目录下跑。
42
- if (!existsSync(join(PEER_ROOT, "package.json"))) {
43
- console.log("=".repeat(64));
44
- console.log("Carlos Flow 双仓一致性守卫");
45
- console.log(` 本仓: ${SELF_NAME.padEnd(8)} ${SELF_ROOT}`);
46
- console.log(` 对方: ${PEER_NAME.padEnd(8)} ${PEER_ROOT}`);
47
- console.log("=".repeat(64));
48
- console.log(`⏭ 跳过:找不到对方仓(${PEER_ROOT})—— 单仓环境无法做双仓比对。`);
49
- console.log(" 需要检查时:npm run check:parity -- <对方仓路径>");
50
- console.log(" 或在本地双仓 checkout 的父目录下直接运行。");
51
- process.exit(0);
52
- }
53
-
54
- // ---- 必须逐字一致的文件清单(核心逻辑,双仓同源) ----
55
- const MUST_MATCH = [
56
- "src/index.js",
57
- "src/card.js",
58
- "src/state.js",
59
- "src/trigger.js",
60
- "src/dispatch.js",
61
- "src/protocol.js",
62
- "test/e2e-carlos.mjs",
63
- "test/p0-gates.mjs",
64
- "test/trigger-e2e.mjs",
65
- "test/concurrency-e2e.mjs",
66
- "test/smoke.js",
67
- "scripts/mutation-check.mjs",
68
- "scripts/release.mjs",
69
- "scripts/sync-readme.mjs",
70
- "scripts/clean-readme-noise.mjs",
71
- "scripts/verify-activation-e2e.sh",
72
- ".github/workflows/ci.yml",
73
- ".github/workflows/release.yml",
74
- "TRIGGER_GUIDE.md",
75
- "docs/QA_REPORT_v2.5.5.md",
76
- "LICENSE",
77
- "CODE_OF_CONDUCT.md",
78
- // 守卫自身与本轮新增的 P0 回归测试 —— 也要纳入逐字一致范围,
79
- // 否则单仓改这两个文件不会被 parity 守卫发现。
80
- "scripts/check-repo-parity.mjs",
81
- "scripts/check-mutant-anchors.mjs",
82
- "test/e2e-acceptance.mjs",
83
- ];
34
+ const ROOT = resolve(HERE, "..");
84
35
 
85
- // ---- 版本专属文件:只能出现在自己这一侧 ----
86
- // 格式:[文件, 归属版本] —— 归属版本出现在对方仓里 = 交叉污染
87
- const OWNED_BY = [
88
- // Cindy 专属
89
- ["ghost.json", "cindy"],
90
- ["settings.html", "cindy"],
91
- ["settings.js", "cindy"],
92
- ["bridge", "cindy"],
93
- // OpenCode 专属
94
- [".mcprc.template", "opencode"],
95
- ["opencode.json.template", "opencode"],
96
- ["carlos.js", "opencode"],
97
- ];
98
-
99
- // ---- 身份标识:README / package.json 必须指向自己 ----
100
- // 两仓共用同一套正则,靠 SELF_NAME 动态选择「自己」与「对方」。
101
- const labelZh = SELF_NAME === "cindy" ? "Cindy" : "OpenCode";
102
- const labelEn = labelZh;
103
- const peerLabelZh = PEER_NAME === "cindy" ? "Cindy" : "OpenCode";
104
- const peerLabelEn = peerLabelZh;
105
-
106
- const IDENTITY_CHECKS = [
107
- {
108
- file: "README.md",
109
- selfMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${labelZh}\\s*适配版`),
110
- peerMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${peerLabelZh}\\s*适配版`),
111
- label: "README.md 标题",
112
- },
113
- {
114
- file: "README.zh.md",
115
- selfMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${labelZh}\\s*适配版`),
116
- peerMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${peerLabelZh}\\s*适配版`),
117
- label: "README.zh.md 标题",
118
- },
119
- {
120
- file: "README.en.md",
121
- selfMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${labelEn}\\s*Edition`),
122
- peerMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${peerLabelEn}\\s*Edition`),
123
- label: "README.en.md 标题",
124
- },
125
- ];
36
+ let failed = 0;
37
+ const pass = (msg) => console.log(` ✅ ${msg}`);
38
+ const fail = (msg) => { console.log(` ❌ ${msg}`); failed++; };
39
+ const section = (title) => console.log(`\n▶ ${title}`);
126
40
 
127
- // ---- 工具 ----
128
- const readText = (root, rel) => {
129
- const p = join(root, rel);
130
- if (!existsSync(p)) return null;
131
- return readFileSync(p, "utf8");
132
- };
133
- // 归一化:去掉行尾符差异(CRLF → LF),其余原样保留
134
- const norm = (s) => (s === null ? null : s.replace(/\r\n/g, "\n"));
41
+ console.log("=".repeat(64));
42
+ console.log("Carlos Flow 单包一致性守卫(身份 / 版本 / 文档 / 产物)");
43
+ console.log(` 仓库: ${ROOT}`);
44
+ console.log("=".repeat(64));
135
45
 
136
- const problems = [];
137
- const notes = [];
138
- const okCount = { match: 0, owned: 0, identity: 0 };
46
+ const readText = (p) => { try { return readFileSync(p, "utf8"); } catch { return null; } };
47
+ const readJson = (p) => { const t = readText(p); if (t == null) return null; try { return JSON.parse(t); } catch { return null; } };
139
48
 
140
- // ---- 1) 核心逻辑必须逐字一致 ----
141
- for (const rel of MUST_MATCH) {
142
- const a = norm(readText(SELF_ROOT, rel));
143
- const b = norm(readText(PEER_ROOT, rel));
144
- if (a === null && b === null) {
145
- notes.push(`SKIP ${rel}(两仓都不存在)`);
146
- continue;
147
- }
148
- if (a === null || b === null) {
149
- problems.push(`MISSING ${rel}:只存在于 ${a === null ? PEER_NAME : SELF_NAME} 一侧 —— 核心逻辑文件必须两仓同时存在`);
150
- continue;
151
- }
152
- if (a === b) {
153
- okCount.match++;
154
- } else {
155
- problems.push(`DIFF ${rel}:核心逻辑与 ${PEER_NAME} 不一致 —— 必须逐字相同(跨仓同步时只做定向补丁,禁止整份覆盖)`);
156
- }
49
+ // ---- 1. 身份 ----
50
+ section("身份(package.json.name)");
51
+ const pkg = readJson(join(ROOT, "package.json"));
52
+ if (!pkg) {
53
+ fail("package.json 读不到或不是合法 JSON");
54
+ } else if (pkg.name !== "carlos-flow") {
55
+ fail(`package.json.name = "${pkg.name}",期望 "carlos-flow"(v2.5.x 的 carlos-flow-cindy / carlos-flow-opencode 已废弃)`);
56
+ } else {
57
+ pass(`package.json.name = carlos-flow`);
157
58
  }
158
59
 
159
- // ---- 2) 版本专属文件不得交叉 ----
160
- for (const [rel, owner] of OWNED_BY) {
161
- const inSelf = existsSync(join(SELF_ROOT, rel));
162
- const inPeer = existsSync(join(PEER_ROOT, rel));
163
- if (owner === SELF_NAME) {
164
- if (!inSelf) {
165
- notes.push(`NOTE ${rel}:${SELF_NAME} 版应有此文件但缺失`);
166
- } else if (inPeer) {
167
- problems.push(`POLLUTE ${rel}:属于 ${owner} 版,却出现在 ${PEER_NAME} 仓 —— 版本专属文件交叉污染`);
168
- } else {
169
- okCount.owned++;
170
- }
60
+ // ---- 2. 版本一致 ----
61
+ section("版本一致性(package.json / lock / ghost.json / TRIGGER_GUIDE.md)");
62
+ if (pkg) {
63
+ const ver = pkg.version;
64
+ const lock = readJson(join(ROOT, "package-lock.json"));
65
+ const lockVer = lock && (lock.version || (lock.packages && lock.packages[""] && lock.packages[""].version));
66
+ if (lockVer === ver) pass(`package-lock.json = ${lockVer}`);
67
+ else fail(`package-lock.json = ${lockVer || "(读不到)"},期望 ${ver}(release.yml 的 npm ci 会因此失败)`);
68
+
69
+ const ghost = readJson(join(ROOT, "ghost.json"));
70
+ if (ghost) {
71
+ if (ghost.version === ver) pass(`ghost.json = ${ghost.version}`);
72
+ else fail(`ghost.json = ${ghost.version},期望 ${ver}(Cindy 插件市场会显示这个版本号)`);
171
73
  } else {
172
- if (inSelf) {
173
- problems.push(`POLLUTE ${rel}:属于 ${owner} 版,却出现在 ${SELF_NAME} 仓 —— 版本专属文件交叉污染`);
174
- } else if (!inPeer) {
175
- notes.push(`NOTE ${rel}:${owner} 版应有此文件但缺失`);
176
- } else {
177
- okCount.owned++;
178
- }
74
+ fail("ghost.json 读不到或不是合法 JSON");
179
75
  }
76
+
77
+ const guide = readText(join(ROOT, "TRIGGER_GUIDE.md")) || "";
78
+ const m = guide.match(/\*\*版本\*\*\s*:\s*v?(\d+\.\d+\.\d+)/);
79
+ if (m && m[1] === ver) pass(`TRIGGER_GUIDE.md = ${m[1]}`);
80
+ else fail(`TRIGGER_GUIDE.md 版本 = ${m ? m[1] : "(提取不到)"},期望 ${ver}`);
81
+
82
+ const changelog = readText(join(ROOT, "CHANGELOG.md")) || "";
83
+ const topVer = (changelog.match(/^## \[(\d+\.\d+\.\d+)\]/m) || [])[1];
84
+ if (topVer === ver) pass(`CHANGELOG.md 顶部 = ${topVer}`);
85
+ else fail(`CHANGELOG.md 顶部 = ${topVer || "(提取不到)"},期望 ${ver}`);
180
86
  }
181
87
 
182
- // ---- 3) 身份标识必须指向自己 ----
183
- const pkg = JSON.parse(readText(SELF_ROOT, "package.json") || "{}");
184
- const peerPkg = JSON.parse(readText(PEER_ROOT, "package.json") || "{}");
88
+ // ---- 3. 文档一致性 ----
89
+ section("文档一致性(中英双语零漂移)");
90
+ const readme = readText(join(ROOT, "README.md"));
91
+ const readmeZh = readText(join(ROOT, "README.zh.md"));
92
+ const readmeEn = readText(join(ROOT, "README.en.md"));
185
93
 
186
- if (pkg.name && !pkg.name.endsWith(`-${SELF_NAME}`)) {
187
- problems.push(`IDENT package.json name="${pkg.name}" 与本仓身份(-${SELF_NAME})不符`);
94
+ if (readme && readmeZh) {
95
+ if (readme === readmeZh) pass("README.md == README.zh.md");
96
+ else fail("README.md 与 README.zh.md 不一致(跑 npm run sync:readme)");
188
97
  } else {
189
- okCount.identity++;
98
+ fail("README.md 或 README.zh.md 缺失");
190
99
  }
191
- if (peerPkg.name && peerPkg.name.endsWith(`-${SELF_NAME}`)) {
192
- problems.push(`IDENT 对方 package.json name="${peerPkg.name}" 与 ${PEER_NAME} 身份不符`);
100
+
101
+ if (readme && readmeEn) {
102
+ const navOk = readme.includes("(README.en.md)") && readme.includes("(README.zh.md)");
103
+ if (navOk) pass("README.md 含语言切换导航栏");
104
+ else fail("README.md 缺语言切换导航栏");
105
+ const enLooksZh = /^#\s+.*(中文)/m.test(readmeEn.split("\n").slice(0, 12).join("\n"));
106
+ if (enLooksZh) fail("README.en.md 看起来是中文版(复制错了)");
107
+ else pass("README.en.md 是英文版");
108
+ } else {
109
+ fail("README.en.md 缺失");
193
110
  }
194
111
 
195
- for (const chk of IDENTITY_CHECKS) {
196
- const txt = readText(SELF_ROOT, chk.file);
197
- if (txt === null) {
198
- problems.push(`MISSING ${chk.file}:本仓缺少该文件`);
199
- continue;
200
- }
201
- if (chk.peerMust.test(txt)) {
202
- problems.push(`IDENT ${chk.label} 写成了对方版本(${PEER_NAME})—— 本仓必须声明自己是 ${SELF_NAME} 版`);
203
- continue;
204
- }
205
- if (!chk.selfMust.test(txt)) {
206
- problems.push(`IDENT ${chk.label} 未声明本仓身份(${SELF_NAME})—— 期望匹配 ${chk.selfMust}`);
207
- continue;
112
+ if (readme) {
113
+ for (const link of ["./MIGRATION.md", "./TRIGGER_GUIDE.md", "./CHANGELOG.md"]) {
114
+ if (readme.includes(link)) pass(`README.md 链接到 ${link}`);
115
+ else fail(`README.md 未链接到 ${link}`);
208
116
  }
209
- okCount.identity++;
210
117
  }
211
118
 
212
- // ---- 3b) 对方仓的身份也要检查(双向)----
213
- // 只查本仓是不够的:事故往往是「某一版被污染」,而从另一个方向跑守卫时
214
- // 同样必须能发现。否则 cindy 仓的 CI 看不到 opencode 仓被覆盖成 Cindy 版。
215
- const PEER_IDENTITY_CHECKS = [
216
- {
217
- file: "README.md",
218
- peerSelfMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${peerLabelZh}\\s*适配版`),
219
- peerPeerMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${labelZh}\\s*适配版`),
220
- label: "README.md 标题",
221
- },
222
- {
223
- file: "README.zh.md",
224
- peerSelfMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${peerLabelZh}\\s*适配版`),
225
- peerPeerMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${labelZh}\\s*适配版`),
226
- label: "README.zh.md 标题",
227
- },
228
- {
229
- file: "README.en.md",
230
- peerSelfMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${peerLabelEn}\\s*Edition`),
231
- peerPeerMust: new RegExp(`#\\s*Carlos Flow\\s*—\\s*${labelEn}\\s*Edition`),
232
- label: "README.en.md 标题",
233
- },
119
+ // ---- 4. 产物内容 ----
120
+ section("产物内容(npm 包必须包含的文件)");
121
+ const REQUIRED_FILES = [
122
+ "client/carlos.js",
123
+ "src/index.js",
124
+ "src/trigger.js",
125
+ "src/state.js",
126
+ "bridge/mcp-bridge.js",
127
+ "plugins/carlos-flow-trigger.js",
128
+ "ghost.json",
129
+ "opencode.json",
130
+ "opencode.json.template",
131
+ ".mcprc.template",
132
+ "trigger-config.usable.json",
133
+ "templates/cursor/mcp.json",
134
+ "templates/cline/mcp.json",
135
+ "templates/vscode/mcp.json",
136
+ "templates/claude/claude_desktop_config.json",
137
+ "README.md",
138
+ "README.zh.md",
139
+ "README.en.md",
140
+ "TRIGGER_GUIDE.md",
141
+ "MIGRATION.md",
142
+ "CHANGELOG.md",
143
+ "LICENSE",
234
144
  ];
235
-
236
- for (const chk of PEER_IDENTITY_CHECKS) {
237
- const peerTxt = readText(PEER_ROOT, chk.file);
238
- if (peerTxt === null) {
239
- problems.push(`MISSING 对方仓 ${chk.file}:${PEER_NAME} 仓缺少该文件`);
240
- continue;
241
- }
242
- if (chk.peerPeerMust.test(peerTxt)) {
243
- problems.push(`IDENT 对方仓 ${chk.label} 写成了本仓版本(${SELF_NAME})—— ${PEER_NAME} 仓的身份被污染了`);
244
- continue;
245
- }
246
- if (!chk.peerSelfMust.test(peerTxt)) {
247
- problems.push(`IDENT 对方仓 ${chk.label} 未声明自己是 ${PEER_NAME} 版 —— ${PEER_NAME} 仓的身份被污染了`);
248
- continue;
249
- }
250
- okCount.identity++;
145
+ for (const f of REQUIRED_FILES) {
146
+ if (existsSync(join(ROOT, f))) pass(f);
147
+ else fail(`缺少 ${f}`);
251
148
  }
252
149
 
253
- // ---- 4) package.json 描述不得指向对方 ----
254
- if (typeof pkg.description === "string") {
255
- const otherLabel = SELF_NAME === "cindy" ? "OpenCode" : "Cindy";
256
- const selfLabel = SELF_NAME === "cindy" ? "Cindy" : "OpenCode";
257
- if (pkg.description.includes(otherLabel + " 适配版")) {
258
- problems.push(`IDENT package.json description 指向了 ${otherLabel} 版:「${pkg.description}」`);
259
- } else if (!pkg.description.includes(selfLabel + " 适配版")) {
260
- problems.push(`IDENT package.json description 未声明 ${selfLabel} 版:「${pkg.description}」`);
150
+ // ---- 4b. bin 入口必须有 shebang ----
151
+ section("bin 入口(必须有 shebang,否则全局命令不可用)");
152
+ // npm 的 cmd-shim 会读目标文件的首行 shebang来决定怎么生成 shim。
153
+ // **没有 shebang** 时它会把目标当成 shell 脚本直接 exec —— 于是在 Git Bash /
154
+ // Linux 上 `carlos-flow init --target cindy` 会报
155
+ // 「client/carlos.js: line 1: //: Is a directory」
156
+ // (Windows 的 .cmd shim 反而正常,所以问题只在类 Unix 环境下暴露,容易漏测)。
157
+ const binEntries = (pkg && pkg.bin) || {};
158
+ for (const [name, rel] of Object.entries(binEntries)) {
159
+ const text = readText(join(ROOT, rel));
160
+ if (text == null) {
161
+ fail(`bin ${name} → ${rel} 不存在`);
162
+ } else if (text.startsWith("#!")) {
163
+ const line = text.split("\n")[0];
164
+ if (/node/.test(line)) pass(`bin ${name} → ${rel} 的 shebang 正确(${line})`);
165
+ else fail(`bin ${name} → ${rel} 的 shebang 不是 node:${line}`);
166
+ } else {
167
+ fail(`bin ${name} → ${rel} 缺少 shebang(全局命令会不可用)`);
261
168
  }
262
169
  }
263
170
 
264
- // ---- 输出 ----
265
- console.log("=".repeat(64));
266
- console.log("Carlos Flow 双仓一致性守卫");
267
- console.log(` 本仓: ${SELF_NAME.padEnd(8)} ${SELF_ROOT}`);
268
- console.log(` 对方: ${PEER_NAME.padEnd(8)} ${PEER_ROOT}`);
269
- console.log("=".repeat(64));
270
- console.log(`核心逻辑一致: ${okCount.match}/${MUST_MATCH.length}`);
271
- console.log(`专属文件归属: ${okCount.owned}/${OWNED_BY.length}`);
272
- console.log(`身份标识: ${okCount.identity}`);
273
- console.log("");
171
+ // ---- 5. 模板必须是合法 JSON ----
172
+ section("模板合法性(必须是合法 JSON,不能带注释)");
173
+ const JSON_FILES = [
174
+ "ghost.json",
175
+ "opencode.json",
176
+ "templates/cursor/mcp.json",
177
+ "templates/cline/mcp.json",
178
+ "templates/vscode/mcp.json",
179
+ "templates/claude/claude_desktop_config.json",
180
+ "trigger-config.usable.json",
181
+ ];
182
+ for (const f of JSON_FILES) {
183
+ const j = readJson(join(ROOT, f));
184
+ if (j) pass(`${f} 是合法 JSON`);
185
+ else fail(`${f} 不是合法 JSON(含注释或语法错误)`);
186
+ }
274
187
 
275
- if (notes.length) {
276
- console.log("提示:");
277
- for (const n of notes) console.log(" " + n);
278
- console.log("");
188
+ // ---- 6. 敏感文件不得进包 ----
189
+ section("敏感 / 临时文件(不得随包分发)");
190
+ // 判定对象是「**实际会被发布的那批文件**」,而不是工作区里的所有文件 ——
191
+ // 工作区可以有 .npmrc.local 这类本机凭据文件(已被 .gitignore 排除),
192
+ // 但它们绝不能出现在 npm 包里。按 package.json 的 files 白名单推导发布集合。
193
+ const publishedSet = (() => {
194
+ const out = [];
195
+ const filesList = Array.isArray(pkg && pkg.files) ? pkg.files : [];
196
+ const add = (rel) => {
197
+ const full = join(ROOT, rel);
198
+ if (!existsSync(full)) return;
199
+ let st;
200
+ try { st = statSync(full); } catch { return; }
201
+ if (st.isDirectory()) {
202
+ for (const e of readdirSync(full)) add(rel.replace(/\/$/, "") + "/" + e);
203
+ } else {
204
+ out.push(rel.replace(/\\/g, "/"));
205
+ }
206
+ };
207
+ for (const f of filesList) add(f);
208
+ return out;
209
+ })();
210
+
211
+ const FORBIDDEN = [/^\.npmrc$/, /^\.npmrc\.local$/, /secret\.json$/, /\.b64$/, /\.bak$/, /^fix_/, /^debug_/, /^\.mutation-report\.md$/, /\.pid$/];
212
+ let bad = 0;
213
+ for (const rel of publishedSet) {
214
+ if (FORBIDDEN.some((re) => re.test(rel))) {
215
+ fail(`发布集合里含敏感/临时文件:${rel}`);
216
+ bad++;
217
+ }
279
218
  }
219
+ if (!bad) pass(`发布集合无敏感/临时文件(共 ${publishedSet.length} 个文件)`);
280
220
 
281
- if (problems.length === 0) {
282
- console.log("✅ 两仓一致:核心逻辑逐字相同、版本专属文件无交叉、身份标识各自正确。");
283
- process.exit(0);
221
+ // .npmrc 模板本身允许入库,但必须确认里面**没有真 token**
222
+ const npmrcText = readText(join(ROOT, ".npmrc")) || "";
223
+ if (/^\s*\/\/registry\.npmjs\.org\/:_authToken=\s*\$\{[^}]+\}/m.test(npmrcText) ||
224
+ (/^\s*#/m.test(npmrcText) && !/_authToken\s*=\s*npm_/m.test(npmrcText))) {
225
+ pass(".npmrc 是模板(无真实凭据)");
226
+ } else {
227
+ fail(".npmrc 里出现了真实 token —— 不得入库");
284
228
  }
285
229
 
286
- console.log(`❌ 发现 ${problems.length} 处不一致:`);
287
- for (const p of problems) console.log(" " + p);
288
- console.log("");
289
- console.log("修复原则:");
290
- console.log(" · 核心逻辑(src/ test/ scripts/ CI)—— 以一版为准,逐字同步到另一版;");
291
- console.log(" · 身份与文档(README / SECURITY / CONTRIBUTING)—— 各自保留本版表述,禁止整份覆盖;");
292
- console.log(" · 版本专属文件—— 只留在属于自己的那一仓。");
293
- process.exit(1);
230
+ console.log("\n" + "=".repeat(64));
231
+ if (failed) {
232
+ console.log(`❌ 单包一致性检查失败:${failed} 项不通过`);
233
+ console.log("=".repeat(64));
234
+ process.exit(1);
235
+ }
236
+ console.log("✅ 单包一致性检查全部通过");
237
+ console.log("=".repeat(64));
238
+ process.exit(0);