dsh-git-push 0.0.0-stage → 2.8.4

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.
Files changed (278) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1482 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +262 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +191 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +662 -0
  32. package/lib/app/tools.js +40 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +207 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +131 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +144 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +470 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +167 -0
  190. package/lib/npm/registry.js +147 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +193 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/doc-drift.mjs +200 -0
  231. package/scripts/doc-func.mjs +212 -0
  232. package/scripts/doc-tree.mjs +456 -0
  233. package/scripts/doc-version.mjs +220 -0
  234. package/scripts/frontend-preview-check.mjs +124 -0
  235. package/scripts/hot-path-probe-cjs.cjs +71 -0
  236. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  237. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  238. package/scripts/hot-path-probe.mjs +153 -0
  239. package/scripts/module-splitter.py +800 -0
  240. package/scripts/platform-scan.mjs +168 -0
  241. package/scripts/preview-gen.mjs +489 -0
  242. package/scripts/preview-local-runner.mjs +55 -0
  243. package/scripts/preview-server-direct.mjs +116 -0
  244. package/scripts/preview-server.mjs +305 -0
  245. package/scripts/preview-slot-data.mjs +123 -0
  246. package/scripts/probe-recheck.mjs +47 -0
  247. package/scripts/readme-gen.mjs +268 -0
  248. package/scripts/rename-locator.mjs +97 -0
  249. package/scripts/rule-switch.mjs +97 -0
  250. package/scripts/rules-solo-audit.mjs +173 -0
  251. package/scripts/scan-file-io.mjs +713 -0
  252. package/scripts/scan-hardcoded-paths.mjs +125 -0
  253. package/scripts/scan-repos.mjs +167 -0
  254. package/scripts/scan-version.mjs +122 -0
  255. package/scripts/scrub-user-wording.mjs +420 -0
  256. package/scripts/symbol-index.mjs +85 -0
  257. package/scripts/sync-plugin-install.mjs +223 -0
  258. package/scripts/sync-plugin.mjs +279 -0
  259. package/scripts/verify-prestep.mjs +100 -0
  260. package/skills/dev/audit-rule-authoring.md +58 -0
  261. package/skills/dev/dsh-git-push.md +323 -0
  262. package/skills/dev/git-push-live-fix.md +45 -0
  263. package/skills/dsh-repo-index.md +35 -0
  264. package/skills/guide/guide-audit.md +167 -0
  265. package/skills/guide/guide-cli-scripts.md +104 -0
  266. package/skills/guide/guide-clone-repos.md +173 -0
  267. package/skills/guide/guide-commit-push.md +156 -0
  268. package/skills/guide/guide-inject-ui.md +166 -0
  269. package/skills/guide/guide-slash-completion.md +118 -0
  270. package/skills/workflow/README.md +21 -0
  271. package/skills/workflow/git-commit-discipline.md +68 -0
  272. package/skills/workflow/git-project-startup.md +85 -0
  273. package/skills/workflow/git-rebuild-process.md +57 -0
  274. package/skills/workflow/github-operations.md +91 -0
  275. package/skills/workflow/readme-sync-git-md.md +28 -0
  276. package/skills/workflow/task-completion-report.md +73 -0
  277. package/skills/workflow/tool-json-add-ask.md +35 -0
  278. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,232 @@
1
+ /**
2
+ * 检查层 · 同名常量跨文件重复定义(DRY)
3
+ *
4
+ * 为什么是「跨文件」检查:runChecks 逐文件调用只能发现文件内重复,
5
+ * 而「同一阈值/长度/窗口常量散落多个模块」正是改一处漏多处的维护坑——
6
+ * 因此与 dup-code 一样在 auditFiles 层(拿到全部文件文本后)统一执行一次。
7
+ *
8
+ * 判定(用户建议「加规则」——MAX_MSG_PREVIEW=80 三处重复实测驱动):
9
+ * · 提取每个代码文件的 `const NAME = <num|str>` 定义(token 级,剥离字符串/注释)
10
+ * · 跨文件按 (name, value) 聚合:**同名校同值 ≥2 个文件** → 报「应统一单一来源」
11
+ * · 排除:test/fixtures(测试夹具各自常量合理)、0/1/-1/2/3 等基础值(循环/布尔语境常见)
12
+ * · severity 恒 warning(只提示不拦截)
13
+ */
14
+ import { tokenize } from '../ast/tokenizer.js';
15
+ import { detectLang } from '../ast/lang.js';
16
+ import { makeFinding } from '../audit/index.js';
17
+ import { HINT_QUALITY } from './common.js';
18
+
19
+ /** 基础值跳过(循环计数/布尔/简单算术——不是「应配置化」的阈值常量)。 */
20
+ const SKIP_VALUES = new Set(['0', '1', '-1', '2', '3']);
21
+ // 「脚本自解析自己的根」惯用名:这些名字出现在多个脚本里是设计预期(各脚本独立解析自己的根),
22
+ // 不算重复定义。注意:本检查器只取 `=` 后的**第一个 token** 作为 value(如 `resolve(...)` 记成
23
+ // `resolve`),所以下面的值判定只能按首 token 匹配,不能写 `resolve\(` 这类带括号的写法。
24
+ const ROOT_IDIOM_NAMES = new Set(['HERE', 'ROOT', 'SCRIPT_DIR', 'SELF', 'DIR', 'BASE', 'BASE_DIR',
25
+ // ESM 下每个脚本各写一份 `const __dirname = dirname(fileURLToPath(import.meta.url))`
26
+ // 是标准写法(Node 的 CJS 变量在 ESM 里没有),同样是「各脚本自解析自己的根」,
27
+ // 合并会破坏脚本独立运行 ⇒ 归入惯用法豁免(此前名字表漏了它,实测被报 5 处)。
28
+ '__dirname']);
29
+ const ROOT_IDIOM_VALUE = /^(dirname|fileURLToPath|__dirname|resolve|join|process|argv)$/;
30
+ // 对象/数组字面量常量无法用本检查器判定:它只取 `=` 后第一个 token(对象记成 `{`、数组 `[`),
31
+ // 同名同 `{` 不代表内容相同(如各扩展脚本各自导出的 `auditExt = { ... }`,行为完全不同)。
32
+ // `new` 同理:`WRITE_METHODS = new Set([...])` 在 lib/ast(数组方法)与 lib/http(HTTP 方法)
33
+ // 是两个完全不同的域,仅名字撞车就被报(实测确认两处内容毫无交集);
34
+ // `SKIP_DIRS = new Set([...])` 在 lib/score(含 vendor/test/dist/coverage)与 lib/skip-dirs
35
+ // (仅 node_modules/.git)内容也不同。⇒ 首 token 判不了内容的,一律不报。
36
+ // 注:`new` 同名同概念但**清单已漂移**的情况(如 SYNC_FS_FNS)本规则也报不了——
37
+ // 那需要结构化比对,属另一类工具职责;发现后按 DRY 手工合并。
38
+ const UNJUDGEABLE_VALUES = new Set(['{', '[', 'new']);
39
+ // 这两个是「每脚本一份」的命令行/环境对象,无条件豁免(与是不是路径无关)
40
+ const PER_SCRIPT_NAMES = new Set(['args', 'env', 'argv', 'flags', 'opts']);
41
+
42
+ /**
43
+ * 提取 `const NAME = 值` / `const NAME: T = 值`(Rust 类型标注)/ Kotlin `const val NAME = 值`
44
+ * 中的常量定义。仅模块级(atTopLevel 校验由调用方传闭包);返回 true=已消费该 const token。
45
+ */
46
+ function extractFromConst(tokens, i, atTopLevel, push) {
47
+ if (!atTopLevel(tokens[i].line)) return true; // 函数内 const 是局部变量,跳过
48
+ let k = i + 1;
49
+ const end = Math.min(tokens.length, i + 7);
50
+ while (k < end) {
51
+ const nm = tokens[k];
52
+ if (!nm || nm.type !== 'ident') { k++; continue; }
53
+ const eq = tokens[k + 1];
54
+ if (eq?.type === 'punct' && eq.value === '=') { push(nm.value, tokens[k + 2], nm.line); return true; }
55
+ if (eq?.type === 'punct' && eq.value === ':') {
56
+ // Rust `NAME: T = 值`——NAME 后 `:` 再向后找 `=`
57
+ for (let m = k + 2; m < Math.min(tokens.length, k + 5); m++) {
58
+ if (tokens[m]?.type === 'punct' && tokens[m].value === '=') { push(nm.value, tokens[m + 1], nm.line); return true; }
59
+ }
60
+ return true;
61
+ }
62
+ // 非 `NAME =` 的 ident(Kotlin const 后的 val)→ 继续找下一个
63
+ k++;
64
+ }
65
+ return true;
66
+ }
67
+
68
+ /**
69
+ * 提取 Java `static final TYPE NAME = 值` 类常量字段(final 前须有 static——方法内局部 final 不算常量)。
70
+ * 返回 true=已消费该 final token。
71
+ */
72
+ function extractFromJavaFinal(tokens, i, push) {
73
+ const prev = tokens[i - 1];
74
+ if (!(prev?.type === 'ident' && prev.value === 'static')) return true; // 仅 static final 类常量
75
+ for (let k = i + 1; k < Math.min(tokens.length, i + 5); k++) {
76
+ const nm = tokens[k], eq = tokens[k + 1], val = tokens[k + 2];
77
+ if (nm?.type === 'ident' && eq?.type === 'punct' && eq.value === '=') { push(nm.value, val, nm.line); return true; }
78
+ }
79
+ return true;
80
+ }
81
+
82
+ /**
83
+ * 提取文件内「命名常量定义」(token 级,剥离字符串/注释),按语言分派:
84
+ * js/ts/tsx/jsx:`const NAME = <num|str>`
85
+ * kotlin:`const 声明 + NAME = <值>` / 顶层 `val NAME = <值>`
86
+ * java:`[static] final [类型] NAME = <值>;`(final 后 3 token 内的 NAME =)
87
+ * go/rust:`const NAME = <值>`(const 后)
88
+ * python:**行首无缩进** `NAME = <num|str>`(模块级常量惯例)
89
+ * 统一返回 {name, value, line};value 归一(num 原样、str 去引号)。
90
+ * @param {string} text 文件全文
91
+ * @returns {Array<{name:string, value:string, line:number}>}
92
+ */
93
+ /**
94
+ * 造一个「常量入表」闭包:值归一 + 各类豁免判定。
95
+ *
96
+ * 为什么单独成函数:原 findConstDefs 把「token 循环 + 五种语言形态分支 + 值过滤 + 去重」
97
+ * 混在一个函数里,圈复杂度 32(阈值 10,自审 max-cyclomatic-complexity 高风险)。
98
+ * 过滤规则(值豁免 / 惯用法豁免)抽出来后,循环只负责「哪种形态交给谁判」。
99
+ */
100
+ function createConstPusher(out) {
101
+ return (name, val, line) => {
102
+ if (!name || !val) return;
103
+ const raw = val.type === 'num' ? val.value : String(val.value).replace(/^(['"])([\s\S]*)\1$/, '$2');
104
+ if (SKIP_VALUES.has(raw)) return;
105
+ // 对象/数组字面量:本检查器只取首 token(`{` / `[`),判不了内容是否真相同 ⇒ 不报(见常量注释)
106
+ if (UNJUDGEABLE_VALUES.has(raw)) return;
107
+ // 「脚本自解析自己的根」是**独立运行**的设计前提(脚本随插件发布、在安装副本目录里同样要能跑,
108
+ // 见 scripts/ 各脚本的零依赖约定)——每个脚本各写一份 HERE / ROOT / SCRIPT_DIR / args / env
109
+ // 不是「重复定义」,合并成公共常量反而让脚本依赖 lib 而失去独立性。
110
+ // 此前这类惯用法被当 DRY 问题报出来:自审 22 条里大半是它(误报,实测)。
111
+ // 判定要同时满足「通用名 + 路径/argv 惯用值」两个条件,避免误伤 PLUGIN_ROOT 这类真重复。
112
+ if (PER_SCRIPT_NAMES.has(name)) return; // 每脚本一份的命令行/环境对象,不是共享常量
113
+ if (ROOT_IDIOM_NAMES.has(name) && ROOT_IDIOM_VALUE.test(raw)) return;
114
+ out.push({ name, value: raw, line });
115
+ };
116
+ }
117
+
118
+ /**
119
+ * 按语言形态判定「当前 token 是否是模块级命名常量声明」,是则入表并返回 true(已消费)。
120
+ *
121
+ * 为什么单独成函数:五种形态(JS const / Kotlin const / Kotlin val / Java static final /
122
+ * Python 全大写)此前全挤在 findConstDefs 的循环里,是该函数圈复杂度居高(32)的主因。
123
+ */
124
+ function extractConstAtToken(tokens, i, { lang, atTopLevel, push }) {
125
+ const t = tokens[i];
126
+ if (t.type !== 'ident') return false;
127
+ // const NAME = 值 / Kotlin const 声明 + NAME = 值 / Rust const NAME: T = 值(类型标注)
128
+ // ——仅**模块级**(行首无缩进)才算命名常量;函数内 const 是局部变量(r/args/out 等
129
+ // 常见名跨文件同名纯属巧合,不是 DRY 信号——实测误爆 338 条修正)
130
+ if (t.value === 'const' && lang !== 'java') return extractFromConst(tokens, i, atTopLevel, push);
131
+ // Kotlin:val NAME = val(顶层,无 const 前缀)
132
+ if (t.value === 'val' && lang === 'kotlin' && atTopLevel(t.line)) {
133
+ const nm = tokens[i + 1], eq = tokens[i + 2], val = tokens[i + 3];
134
+ if (nm?.type === 'ident' && eq?.type === 'punct' && eq.value === '=') push(nm.value, val, nm.line);
135
+ return true;
136
+ }
137
+ // Java:`static final TYPE NAME = val`(类常量字段;final 前须有 static——方法内局部 final 不算常量)
138
+ if (t.value === 'final' && lang === 'java') return extractFromJavaFinal(tokens, i, push);
139
+ // Python:行首无缩进且**全大写** `NAME = val`(Python 模块级常量惯例 PEP8;
140
+ // 不依赖 detectLang——单行常量样本无 def/class 时 detectLang 落 js,直接用形态判定)
141
+ if (atTopLevel(t.line) && /^[A-Z][A-Z0-9_]*$/.test(t.value)) {
142
+ const eq = tokens[i + 1], val = tokens[i + 2];
143
+ if (eq?.type === 'punct' && eq.value === '=' && val && (val.type === 'num' || val.type === 'str')) {
144
+ push(t.value, val, t.line);
145
+ }
146
+ }
147
+ return false;
148
+ }
149
+
150
+ export function findConstDefs(text = '') {
151
+ const tokens = tokenize(String(text));
152
+ const lang = detectLang(String(text));
153
+ const out = [];
154
+ // 行首是否无缩进(模块级顶层)——函数内 const/let/var/val 是局部变量,不是「命名常量」。
155
+ // ⚠️ 性能(2026-10-09 实测,这曾是全插件最大的热点):原实现**每次调用**都 `String(text).split('\n')`,
156
+ // 而本函数会被**每个 token** 调用 ⇒ O(tokens × 文件长度) 的二次复杂度:
157
+ // 外部仓全量审计 23.9s 里有 21.5s(CPU profile 89.8%)耗在这一行 ✗。
158
+ // 改为只 split 一次(lines[line-1] 为 O(1) 取行,`/^\S/` 锚定在行首亦为 O(1))⇒ 复杂度降回线性。
159
+ const lines = String(text).split('\n');
160
+ const atTopLevel = (line) => /^\S/.test(lines[line - 1] || '');
161
+ const push = createConstPusher(out);
162
+ const ctx = { lang, atTopLevel, push };
163
+ for (let i = 0; i < tokens.length; i++) {
164
+ if (extractConstAtToken(tokens, i, ctx)) continue;
165
+ }
166
+ // 多分支可能对同一常量重复提取(JS const 分支 + 全大写分支 / Java final 分支 + 全大写分支
167
+ // 都可能命中同一 `NAME = 值`)——按行名去重,保证同一条只留一份
168
+ const seen = new Set();
169
+ return out.filter((d) => {
170
+ const k = `${d.line}:${d.name}:${d.value}`;
171
+ if (seen.has(k)) return false;
172
+ seen.add(k);
173
+ return true;
174
+ });
175
+ }
176
+
177
+ /**
178
+ * 跨文件同名常量重复定义检测。
179
+ * @param {Array<{path:string, text:string}>} fileTexts 全部代码文件
180
+ * @param {Array} [rules] 规则定义(取 id/dimensions)
181
+ * @returns {Array} findings(severity 恒 warning)
182
+ */
183
+ export function checkDuplicateConst(fileTexts = [], rules = null) {
184
+ const findings = [];
185
+ if (!Array.isArray(fileTexts) || fileTexts.length < 2) return findings;
186
+ const rule = Array.isArray(rules) && rules.length ? rules[0] : null;
187
+
188
+ // 逐文件提取(跳过 test/fixtures——测试夹具常量各自定义是正常形态)
189
+ const perFile = [];
190
+ for (const { path, text } of fileTexts) {
191
+ if (!text) continue;
192
+ if (/(^|[\\/])(test|tests|__tests__|fixtures?|mocks?)([\\/]|$)/.test(path)) continue;
193
+ if (!/\.(js|mjs|cjs|ts|tsx|jsx)$/.test(path)) continue;
194
+ try {
195
+ perFile.push({ path, defs: findConstDefs(text) });
196
+ } catch { /* 单文件解析异常不影响整体 */ }
197
+ }
198
+
199
+ // 聚合:key = name|value → {name, value, files: [{path, line}]}
200
+ const groups = new Map();
201
+ for (const { path, defs } of perFile) {
202
+ for (const d of defs) {
203
+ const key = `${d.name}|${d.value}`;
204
+ if (!groups.has(key)) groups.set(key, { name: d.name, value: d.value, files: [] });
205
+ groups.get(key).files.push({ path, line: d.line });
206
+ }
207
+ }
208
+
209
+ for (const g of groups.values()) {
210
+ if (g.files.length < 2) continue;
211
+ // 独立脚本与 lib 的同名常量不算重复:scripts/ 下每个脚本都要能**单独运行**
212
+ // (随插件发布、在安装副本目录里同样可执行),各自解析自己的根 / 维护自己的注释标记
213
+ // 是设计前提;强行合并会让脚本依赖 lib 而失去独立性。
214
+ // 自审剩余 3 条全属此类:SKIP_DIRS(脚本与 collector 各自 getSkipSet())、
215
+ // PLUGIN_ROOT(脚本自己 join(__dirname,'..'))、MARK_START/MARK_END(两个脚本各自维护)。
216
+ if (g.files.some((f) => /(^|[\\/])scripts[\\/]/.test(f.path))) continue;
217
+ const [first, ...rest] = g.files;
218
+ const others = rest.map((f) => `${f.path}:${f.line}`).join(',');
219
+ findings.push(makeFinding({
220
+ file: first.path,
221
+ line: first.line,
222
+ rule: rule?.id || 'maintainability/duplicate-constant-def',
223
+ kind: 'duplicate-const',
224
+ severity: 'warning',
225
+ message: `常量「${g.name} = ${g.value}」在 ${g.files.length} 个文件重复定义(${first.path}:${first.line}、${others})——阈值/长度/窗口应统一到公共常量模块或配置文件单处定义(DRY,改一处即可全局生效)`,
226
+ dimensions: rule?.dimensions || ['可维护性'],
227
+ exemptHint: HINT_QUALITY,
228
+ scoreImpact: 1,
229
+ }));
230
+ }
231
+ return findings;
232
+ }
@@ -0,0 +1,150 @@
1
+ /**
2
+ * 检查层 · 文件健康度
3
+ *
4
+ * 职责:按行数/字节数/最长行三维给文件打分,识别超大文件与超长行。
5
+ */
6
+
7
+ import { makeFinding, CODE_EXTS } from '../audit/index.js';
8
+ import { checkFileLines, maxFunctionLength } from '../ast/index.js';
9
+ import { capSeverity } from './common.js';
10
+ import { tokenize } from '../ast/tokenizer.js';
11
+ import { codeLineCount as countCodeLines } from '../ast/line-count.js';
12
+
13
+ /* ───────────────────────── 默认参数(与 lib/rule/compilers/file-health.js 的默认值一致; ─────────────────────────
14
+ * 规则条目可用 snake_case 字段覆盖,未覆盖时用这里的兜底值。两处需同步修改。) */
15
+
16
+ /** 三维权重(合计 1.0):行数 / 大小 / 单行最大长度。 */
17
+ const WEIGHT_LINES = 0.4;
18
+ const WEIGHT_SIZE = 0.35;
19
+ const WEIGHT_LINE_LENGTH = 0.25;
20
+ /** 等级边界(各 4 个分隔点 → 0~4 级)。 */
21
+ const LINE_LEVELS = [200, 400, 800, 1500];
22
+ const SIZE_LEVELS = [30, 100, 300, 1000];
23
+ const LENGTH_LEVELS = [120, 200, 300, 500];
24
+ /** 等级扣分表(level 0~4)。 */
25
+ const LEVEL_PENALTIES = [0, 1.0, 2.5, 4.5, 7.0];
26
+ /** 满分基准、下限分与严重度分界:与 lib/rule/compilers/file-health.js 共用同一来源
27
+ * (lib/audit-defaults.js)——两处必须永远相等,各写一份会出现编译器与检查器
28
+ * 按不同基准判健康度的静默不一致(自审 duplicate-constant 报的真重复)。 */
29
+ import {
30
+ HEALTH_BASE_SCORE as BASE_SCORE, HEALTH_MIN_SCORE as MIN_SCORE,
31
+ HEALTH_WARN_SCORE as WARN_SCORE, HEALTH_BLOCK_SCORE as BLOCK_SCORE,
32
+ } from '../audit-defaults.js';
33
+
34
+ /** 文件健康度矩阵评分(1.0.13):行数×40% + 大小×35% + 行长×25% → 加权等级 → 插值扣分 → score/10。
35
+ * 豁免:generated./.min./locales/ 跳过;constants/ 行数等级强制 0;routes/ 行数阈值放宽(等级-1,最小0)。
36
+ * 输出:score<blockScore → blocker;score<warnScore → warning;否则 pass(不产出 finding)。
37
+ * 诊断 message 含三维等级/得分/verdict/优先处理维度,可直接展示。 */
38
+ export function checkFileHealth({ file, relPath, text, rules }) {
39
+ const findings = [];
40
+ const rule = rules?.[0];
41
+ if (!rule) return findings;
42
+ const x = rule; // ruleOut 把 extra 展开进 rule 顶层(无 rule.extra 属性)
43
+ const rel = relPath || file || '';
44
+ // 豁免判定:相对路径可能是 'constants/table.js' 或 '/constants/table.js',模式统一匹配两种形态
45
+ const relNorm = rel.startsWith('/') ? rel : '/' + rel;
46
+ // 跳过类(generated/min/locales)——先试精确(如 .generated. 可命中文件名),再试带斜杠(目录形态)
47
+ if ((x.exemptSkip || []).some((p) => p.includes('/') ? relNorm.includes(p) : rel.includes(p))) return findings;
48
+ // 行数豁免类(constants):行数等级强制 0
49
+ const constMode = (x.exemptConstants || []).some((p) => p.includes('/') ? relNorm.includes(p) : rel.includes(p));
50
+ // 行数阈值放宽类(routes):行数等级减 1
51
+ const routesMode = (x.exemptRoutes || []).some((p) => p.includes('/') ? relNorm.includes(p) : rel.includes(p));
52
+
53
+ const lines = text.split('\n');
54
+ // 三维(行数/大小/行长)一律按**代码部分**统计(修复):文档注释里内嵌的
55
+ // API 响应示例 JSON(pix-ezviewer response 类)把行数/大小/行长全撑成 L3-L4 假警报——
56
+ // 注释是设计说明不是代码规模。用 tokenizer 标记注释行/注释字节,三个维度都扣掉注释。
57
+ // ①整行注释(该行 token 全是 comment,含跨行块注释覆盖的行)不计行数与行长;
58
+ // ②注释字节(全部 comment token 的文本长度)从文件大小中扣除——代码大小才是规模。
59
+ const commentOnlyLines = new Set();
60
+ let maxLen = 0;
61
+ let codeBytes = 0;
62
+ (function computeLineMetrics() {
63
+ const tokens = tokenize(text);
64
+ let commentBytes = 0;
65
+ for (const t of tokens) {
66
+ if (t.type !== 'comment') continue;
67
+ commentBytes += Buffer.byteLength(String(t.value || ''), 'utf8');
68
+ const start = Number(t.line) || 1;
69
+ const newlines = String(t.value || '').match(/\n/g)?.length || 0;
70
+ for (let lineIdx = start; lineIdx <= start + newlines; lineIdx++) commentOnlyLines.add(lineIdx);
71
+ }
72
+ // 整行代码行长(该行非注释 token 存在 → 代码行;否则纯注释行不计)
73
+ for (let i = 0; i < lines.length; i++) {
74
+ const ln = lines[i];
75
+ if (commentOnlyLines.has(i + 1)) continue; // 整行注释(含示例数据串)不计行长
76
+ if (ln.length > maxLen) maxLen = ln.length;
77
+ }
78
+ codeBytes = Math.max(0, Buffer.byteLength(text, 'utf8') - commentBytes);
79
+ })();
80
+ // 代码行口径走**单一来源**(lib/ast/line-count.js:总行 − 纯注释行 − 空行)——
81
+ // 此前这里只减注释行、**漏减空行**,同一文件与本插件其它规则报出的行数对不上。
82
+ const codeLineCount = countCodeLines(text);
83
+ const codeLineCountSafe = Math.max(1, codeLineCount);
84
+ const sizeKb = codeBytes / 1024;
85
+ const maxCodeLen = maxLen;
86
+
87
+ const levelOf = (val, levels) => {
88
+ for (let i = 0; i < levels.length; i++) if (val <= levels[i]) return i;
89
+ return levels.length;
90
+ };
91
+ let linesLevel = levelOf(codeLineCountSafe, x.lineLevels || LINE_LEVELS);
92
+ const sizeLevel0 = levelOf(sizeKb, x.sizeLevels || SIZE_LEVELS);
93
+ const lenLevel = levelOf(maxCodeLen, x.lengthLevels || LENGTH_LEVELS);
94
+ if (constMode) linesLevel = 0; // constants:行数豁免
95
+ if (routesMode) linesLevel = Math.max(0, linesLevel - 1); // routes:行数阈值放宽
96
+ // 聚合型 vs 臃肿型(用户设计):先罚函数,再考虑文件——函数是执行单元、
97
+ // 文件是组织单元。最大函数 > 50 行(臃肿型:文件大是因为藏着大函数)→ 行数/大小
98
+ // 维度正常计分;全部函数 ≤ 50 行(聚合型:文件大只是函数多/数据多,或纯数据文件
99
+ // 无函数)→ 行数/大小维度豁免(不按文件规模扣分,文件边界只是导航成本)。
100
+ const maxFuncLen = maxFunctionLength(text);
101
+ const FUNC_COMPLIANT_LIMIT = 50; // 与 func-lines 默认 warn 阈值一致
102
+ // 聚合型判定加「有函数」前提:只有文件**含函数且函数都合规**才算聚合型
103
+ // (文件大=函数多/数据多);无函数的纯脚本/数据文件(顶层 1200 行语句)没有「函数
104
+ // 多」作证据,不豁免,仍按行数/大小计分(避免脚本型大文件漏报)。
105
+ const isAggregated = maxFuncLen > 0 && maxFuncLen <= FUNC_COMPLIANT_LIMIT;
106
+ let sizeLevel = sizeLevel0;
107
+ if (isAggregated) { linesLevel = 0; sizeLevel = 0; }
108
+
109
+ const weights = {
110
+ lines: x.weightLines !== undefined ? x.weightLines : WEIGHT_LINES,
111
+ size: x.weightSize !== undefined ? x.weightSize : WEIGHT_SIZE,
112
+ len: x.weightLineLength !== undefined ? x.weightLineLength : WEIGHT_LINE_LENGTH,
113
+ };
114
+ const weighted = linesLevel * weights.lines + sizeLevel * weights.size + lenLevel * weights.len;
115
+ // 扣分插值:penalties[i] 对应等级 i;小数等级按相邻线性插值
116
+ const penalties = x.penalties || LEVEL_PENALTIES;
117
+ const lo = Math.floor(weighted);
118
+ const hi = Math.min(lo + 1, penalties.length - 1);
119
+ const frac = weighted - lo;
120
+ const penalty = penalties[lo] + (penalties[hi] - penalties[lo]) * frac;
121
+ const base = x.baseScore !== undefined ? x.baseScore : BASE_SCORE;
122
+ const score = Math.max(MIN_SCORE, base - penalty);
123
+
124
+ const warnScore = x.warnScore !== undefined ? x.warnScore : WARN_SCORE;
125
+ const blockScore = x.blockScore !== undefined ? x.blockScore : BLOCK_SCORE;
126
+ if (score >= warnScore) return findings; // 健康:不产出
127
+
128
+ // 优先处理维度 = 等级最高的维度(并列取首个)
129
+ const dims = [['行数', linesLevel], ['大小', sizeLevel], ['行长', lenLevel]].sort((a, b) => b[1] - a[1]);
130
+ const top = dims[0];
131
+ const sev = score < blockScore ? 'blocker' : 'warning';
132
+ const label = ['优秀', '良好', '警戒', '危险', '严重'];
133
+ // 修 bug:总分标签曾硬编码「🟠 危险」,导致 8.4/10(刚低于 warn_score 9 的
134
+ // 提示阈值)也被写成「危险」,与规则文档「score≥9 健康,<9 提示拆分,<5 blocker」不符。
135
+ // 现按分数区间给档:<block_score 严重 / <(block+warn)/2 危险 / 其余 提示(轻度)。
136
+ const mid = (blockScore + warnScore) / 2;
137
+ const scoreTag = score < blockScore ? '🔴 严重' : (score < mid ? '🟠 危险' : '🟡 提示');
138
+ findings.push(makeFinding({
139
+ file, line: 1, rule: rule.id || 'maintainability/file-health', kind: 'file-health',
140
+ severity: sev,
141
+ message: `文件健康度 ${score.toFixed(1)}/10(${scoreTag}):`
142
+ + `行数 ${codeLineCountSafe}→L${linesLevel}(${label[linesLevel]})、大小 ${sizeKb.toFixed(1)}KB→L${sizeLevel}(${label[sizeLevel]})、`
143
+ + `最大代码行长 ${maxCodeLen}→L${lenLevel}(${label[lenLevel]})、最大函数 ${maxFuncLen} 行;优先处理:${top[0]}(L${top[1]})`
144
+ + `${isAggregated ? '(聚合型:文件大但最大函数 ≤50 行——函数多而非函数长,按组织单元不按规模扣分)' : ''}`
145
+ + `${lenLevel > 0 ? '(行长按非注释代码行计;注释/文档内嵌示例数据串不计)' : ''}`,
146
+ dimensions: rule.dimensions || ['可维护性', '可读性'],
147
+ exemptHint: 'dsh-skip-quality(文件头=整文件)', scoreImpact: sev === 'blocker' ? 2 : 1,
148
+ }));
149
+ return findings;
150
+ }
@@ -0,0 +1,131 @@
1
+ /**
2
+ * 检查层 · 规则作用域过滤
3
+ *
4
+ * 职责:按文件路径裁剪规则——exts(扩展名)、exclude_paths(目录前缀),
5
+ * 以及新增的 file_patterns(文件内容级初筛,三层审计 L1)。
6
+ * 这是「规则作用域」的唯一落地点:规则声明了作用域就必须在此生效,
7
+ * 否则出现「yml 写了 exts 却被静默忽略」的缺陷。
8
+ *
9
+ * 三层审计管线:
10
+ * L1 正则初筛(本文件 filterRulesByFileText)——每文件一次正则扫描,成本极低,
11
+ * 命中 file_patterns 的文件才进 L2;不命中直接剔除该规则(空数组短路)。
12
+ * L2 AST+YAML 精查(lib/ast/dataflow.js + lib/checks/dataflow.js)——只对 L1
13
+ * 候选文件做同函数内数据流判定(如「清空后访问」)。
14
+ * L3 运行时检测(scripts/audit-runtime-check.mjs)——兜住跨文件/闭包/异步盲区。
15
+ */
16
+
17
+ /** 全量检查器调度:对单文件跑所有已编译规则 + 内置检查(质量类走 AST 级)。
18
+ * @param {object} opts { level: 'quick'|'standard'|'deep'(缺省 standard 全量) }
19
+ * quick 档跳过 AST/语义重检查(分析成本高):func-lines/complexity/depth/
20
+ * max-lines/repeated-string/semantic/credential-file/min-length,保留正则/
21
+ * 黑名单/路径/内置轻检——适合大仓冒烟、快速门禁。
22
+ * deep 档当前引擎与 standard 等效(全量),为未来追加深度检查预留。 */
23
+ /**
24
+ * 规则 exts 过滤:规则声明 `exts` 时仅对匹配扩展名的文件生效。
25
+ * 编译产物里 exts 存在 `rule.extra.exts`(regex 编译器已透传),此处消费——
26
+ * 修复 dsh/patch-insert-unique-id 等在 README/md 等非目标文件上的误报
27
+ * (例:patch 语义规则只查 yml/yaml,README 里的 insert 示例代码块不再命中)。
28
+ * @param {object} grouped 按 kind 分组的编译规则
29
+ * @param {string} relPath 相对路径(用于取扩展名)
30
+ * @returns {object} 过滤后的 grouped(规则数组已按 exts 裁剪)
31
+ */
32
+ export function filterRulesByExt(grouped, relPath) {
33
+ const ext = String(relPath || '').split('.').pop().toLowerCase();
34
+ const out = {};
35
+ for (const [kind, rules] of Object.entries(grouped || {})) {
36
+ if (!Array.isArray(rules)) { out[kind] = rules; continue; }
37
+ out[kind] = rules.filter((r) => {
38
+ const exts = r?.exts ?? r?.extra?.exts; // ruleOut 展开后 exts 在顶层;兼容 extra 形式
39
+ if (!Array.isArray(exts) || exts.length === 0) return true; // 未声明 exts = 不限文件
40
+ return exts.includes(ext);
41
+ });
42
+ }
43
+ return out;
44
+ }
45
+
46
+ /**
47
+ * 路径级规则过滤——规则声明 exclude_paths 时,按 relPath 前缀排除。
48
+ * 与 filterRulesByExt 分离:exts 只按扩展名,区分不了「同是 .js 的 server/client」;
49
+ * 需要排除整目录(如 client-node-builtin-require 只查浏览器侧,排除 server/ test/ lib/)。
50
+ * 路径匹配:relPath 以任一 exclude 前缀开头即跳过该规则(前缀兼容有无尾斜杠)。
51
+ */
52
+ /** 路径归一化(去反斜杠、去前导 ./、去尾斜杠)。原先在 filter 回调里逐规则重建闭包,既费分配也难读。 */
53
+ function normRelPath(s) {
54
+ return String(s || '').replace(/\\/g, '/').replace(/^\.?\//, '').replace(/\/+$/, '');
55
+ }
56
+
57
+ /**
58
+ * includePaths 命中判定:含 '/' 的模式按路径相等或后缀匹配;不含 '/' 的按**文件名**匹配(任意层级)。
59
+ * 抽成函数后 filter 回调里只剩一行 some(...),嵌套深度降一层。
60
+ */
61
+ function includeHit(rel, inc) {
62
+ const pat = normRelPath(inc);
63
+ if (!pat) return false;
64
+ return pat.includes('/')
65
+ ? (rel === pat || rel.startsWith(pat + '/') || rel.endsWith('/' + pat))
66
+ : rel.split('/').pop() === pat;
67
+ }
68
+
69
+ /** excludePaths 命中判定(前缀匹配,兼容有无尾斜杠两种写法)。 */
70
+ function excludeHit(rel, ex) {
71
+ const ee = normRelPath(ex);
72
+ return Boolean(ee) && (rel === ee || rel.startsWith(ee + '/') || rel.startsWith(ee));
73
+ }
74
+
75
+ export function filterRulesByPath(grouped, relPath) {
76
+ const p = String(relPath || '');
77
+ const out = {};
78
+ for (const [kind, rules] of Object.entries(grouped || {})) {
79
+ if (!Array.isArray(rules)) { out[kind] = rules; continue; }
80
+ out[kind] = rules.filter((r) => {
81
+ const rel = normRelPath(p);
82
+ // 白名单:声明 includePaths 时只有命中其一才跑该规则(与 excludePaths 互补)。
83
+ // 为什么需要:有些规则只该作用于特定文件(如「package.json 的 version 必须 SemVer」),
84
+ // 而 exts:["json"] 会把它套到所有 json 上——第三方仓库里成千上万个带 version 字段的 json
85
+ // 被逐条误报(实测 1435 条)。匹配语义见 includeHit。
86
+ const includes = r?.includePaths ?? r?.extra?.includePaths;
87
+ if (Array.isArray(includes) && includes.length && !includes.some((inc) => includeHit(rel, inc))) return false;
88
+ const excludes = r?.excludePaths ?? r?.extra?.excludePaths;
89
+ if (!Array.isArray(excludes) || excludes.length === 0) return true; // 未声明 = 不限路径
90
+ return !excludes.some((e) => excludeHit(rel, e));
91
+ });
92
+ }
93
+ return out;
94
+ }
95
+
96
+ /**
97
+ * 三层审计 L1——文件内容级初筛(file_patterns)。
98
+ *
99
+ * 动机:AST/数据流类规则(第二层)成本中,若对每个文件都跑 token 解析浪费。
100
+ * 声明 `file_patterns` 的规则先做一次**纯正则**快速筛选:文件文本命中任一
101
+ * pattern 才算「候选文件」,才进 L2 精查;未命中 → 该规则剔除(数组为空,
102
+ * 检查器空规则短路,顺带防 rule.severity 崩溃)。
103
+ *
104
+ * 与 exts/exclude_paths 的区别:那是**路径/扩展名**级裁剪,这是**文件内容**级
105
+ * 初筛——解决「正则模式本身命中面太宽、但 AST 精判成本高」的三层分层问题
106
+ * (如 clear-then-access 只在同函数含「清空动作」的文件上才值得做数据流分析)。
107
+ *
108
+ * @param {object} grouped 按 kind 分组的编译规则
109
+ * @param {string} text 文件全文(读一次,多规则共享)
110
+ * @returns {object} 过滤后的 grouped
111
+ */
112
+ export function filterRulesByFileText(grouped, text) {
113
+ const out = {};
114
+ for (const [kind, rules] of Object.entries(grouped || {})) {
115
+ if (!Array.isArray(rules)) { out[kind] = rules; continue; }
116
+ out[kind] = rules.filter((r) => {
117
+ const fps = r?.filePatterns ?? r?.extra?.filePatterns; // ruleOut 展开后顶层;兼容 extra
118
+ if (!Array.isArray(fps) || fps.length === 0) return true; // 未声明 = 全文都算候选(不做 L1 初筛)
119
+ // 纯文本单次扫描:任一 pattern 命中即候选(L1 只追求召回,不追求精度)
120
+ const body = String(text || '');
121
+ return fps.some((p) => {
122
+ if (p instanceof RegExp) { p.lastIndex = 0; return p.test(body); }
123
+ // 字符串形态 = 正则源串(compiler 从 yml file_patterns 透传,含 \b 等转义),
124
+ // 按 RegExp 编译执行;编译失败(非法正则)退回子串包含(保守:宁放行不漏筛)。
125
+ try { return new RegExp(String(p)).test(body); }
126
+ catch { return body.includes(String(p)); }
127
+ });
128
+ });
129
+ }
130
+ return out;
131
+ }