dsh-git-push 0.0.0-stage → 2.8.6

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 (279) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1486 -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 +266 -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 +192 -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 +672 -0
  32. package/lib/app/tools.js +34 -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 +215 -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 +137 -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 +148 -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 +476 -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 +171 -0
  190. package/lib/npm/registry.js +168 -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 +196 -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/cpu-sample.mjs +188 -0
  231. package/scripts/doc-drift.mjs +200 -0
  232. package/scripts/doc-func.mjs +212 -0
  233. package/scripts/doc-tree.mjs +456 -0
  234. package/scripts/doc-version.mjs +220 -0
  235. package/scripts/frontend-preview-check.mjs +124 -0
  236. package/scripts/hot-path-probe-cjs.cjs +71 -0
  237. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  238. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  239. package/scripts/hot-path-probe.mjs +153 -0
  240. package/scripts/module-splitter.py +800 -0
  241. package/scripts/platform-scan.mjs +168 -0
  242. package/scripts/preview-gen.mjs +489 -0
  243. package/scripts/preview-local-runner.mjs +55 -0
  244. package/scripts/preview-server-direct.mjs +116 -0
  245. package/scripts/preview-server.mjs +305 -0
  246. package/scripts/preview-slot-data.mjs +123 -0
  247. package/scripts/probe-recheck.mjs +47 -0
  248. package/scripts/readme-gen.mjs +268 -0
  249. package/scripts/rename-locator.mjs +97 -0
  250. package/scripts/rule-switch.mjs +97 -0
  251. package/scripts/rules-solo-audit.mjs +173 -0
  252. package/scripts/scan-file-io.mjs +713 -0
  253. package/scripts/scan-hardcoded-paths.mjs +125 -0
  254. package/scripts/scan-repos.mjs +167 -0
  255. package/scripts/scan-version.mjs +122 -0
  256. package/scripts/scrub-user-wording.mjs +420 -0
  257. package/scripts/symbol-index.mjs +85 -0
  258. package/scripts/sync-plugin-install.mjs +223 -0
  259. package/scripts/sync-plugin.mjs +279 -0
  260. package/scripts/verify-prestep.mjs +100 -0
  261. package/skills/dev/audit-rule-authoring.md +58 -0
  262. package/skills/dev/dsh-git-push.md +323 -0
  263. package/skills/dev/git-push-live-fix.md +45 -0
  264. package/skills/dsh-repo-index.md +35 -0
  265. package/skills/guide/guide-audit.md +167 -0
  266. package/skills/guide/guide-cli-scripts.md +104 -0
  267. package/skills/guide/guide-clone-repos.md +173 -0
  268. package/skills/guide/guide-commit-push.md +156 -0
  269. package/skills/guide/guide-inject-ui.md +166 -0
  270. package/skills/guide/guide-slash-completion.md +118 -0
  271. package/skills/workflow/README.md +21 -0
  272. package/skills/workflow/git-commit-discipline.md +68 -0
  273. package/skills/workflow/git-project-startup.md +85 -0
  274. package/skills/workflow/git-rebuild-process.md +57 -0
  275. package/skills/workflow/github-operations.md +91 -0
  276. package/skills/workflow/readme-sync-git-md.md +28 -0
  277. package/skills/workflow/task-completion-report.md +73 -0
  278. package/skills/workflow/tool-json-add-ask.md +35 -0
  279. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,472 @@
1
+ /**
2
+ * 性能反模式 AST 精筛:循环体内的「全量集合物化」。
3
+ *
4
+ * 【为什么单独成模块】正则只能看出「写了 Array.from(x.values())」,看不出它**在不在循环体里** ——
5
+ * 而这两者代价天差地别:循环外做一次是 O(集合大小),循环里做就是 O(循环次数 × 集合大小),
6
+ * 随数据量二次增长。
7
+ *
8
+ * 【真实样本(本规则的验证依据)】dsh-codegraph 的 `packages/core/src/indexer/symbol-table.ts`
9
+ * 第 213 / 342 行在「按文件 / 按未解析继承」的循环体内写了
10
+ * `Array.from(this.nodes.values()).filter(...)`。实测(49 文件子集):
11
+ * 全量扫描 5047ms 中 `resolveCrossFileReferences` 独占 4621ms(**91.6%**),
12
+ * 且每文件成本随规模从 54ms 涨到 102ms(10 → 50 文件)→ 292 文件时高达 1416ms/文件。
13
+ * 根因就是这两处:每次物化整个节点表再过滤。
14
+ *
15
+ * 【局限】按大括号配对判定块体:单行无括号循环体(`for (...) doThing();`)不覆盖 ——
16
+ * 宁可漏报,不误报。
17
+ */
18
+
19
+ import { tokenize } from './tokenizer.js';
20
+
21
+ /** 求 `{`(openIdx 处)配对的 `}` 下标;找不到返回 -1。 */
22
+ function matchingBrace(text, openIdx) {
23
+ let depth = 0;
24
+ for (let i = openIdx; i < text.length; i++) {
25
+ const ch = text[i];
26
+ if (ch === '{') depth += 1;
27
+ else if (ch === '}') {
28
+ depth -= 1;
29
+ if (depth === 0) return i;
30
+ }
31
+ }
32
+ return -1;
33
+ }
34
+
35
+ /** 求 `(`(openIdx 处)配对的 `)` 下标;找不到返回 -1。 */
36
+ function matchingParen(text, openIdx) {
37
+ let depth = 0;
38
+ for (let i = openIdx; i < text.length; i++) {
39
+ const ch = text[i];
40
+ if (ch === '(') depth += 1;
41
+ else if (ch === ')') {
42
+ depth -= 1;
43
+ if (depth === 0) return i;
44
+ }
45
+ }
46
+ return -1;
47
+ }
48
+
49
+ /** 字符下标 → 1 基行号。 */
50
+ function lineOf(text, idx) {
51
+ let n = 1;
52
+ for (let i = 0; i < idx && i < text.length; i++) if (text[i] === '\n') n += 1;
53
+ return n;
54
+ }
55
+
56
+ /**
57
+ * 命中是否只是注释/字符串里的示例(token 级判定)。
58
+ * @param {Array<{type:string,value:string,line:number}>} tokens tokenize 结果
59
+ * @param {number} line 命中行号
60
+ * @param {string} matchText 命中的原文
61
+ * @returns {boolean} true = 该命中位于注释/字符串文本内,不算真实代码
62
+ */
63
+ function inCommentOrString(tokens, line, matchText) {
64
+ return tokens.some(
65
+ (t) => t.line === line
66
+ && (t.type === 'comment' || t.type === 'str' || t.type === 'tmpl')
67
+ && String(t.value).includes(matchText)
68
+ );
69
+ }
70
+
71
+ /** 从 startIdx 起找下一个块体 `{...}` 的范围(跳过 `for (...)` 圆括号内的对象字面量)。 */
72
+ function nextBlockRange(text, startIdx) {
73
+ const paren = text.indexOf('(', startIdx);
74
+ let from = startIdx;
75
+ if (paren >= 0) {
76
+ const closeParen = matchingParen(text, paren);
77
+ if (closeParen > paren) from = closeParen;
78
+ }
79
+ const open = text.indexOf('{', from);
80
+ if (open < 0) return null;
81
+ const close = matchingBrace(text, open);
82
+ return close > open ? [open, close] : null;
83
+ }
84
+
85
+ /** 收集所有循环块体(for/while/do 块 + 迭代回调块)的字符区间。 */
86
+ function collectLoopRanges(text) {
87
+ const ranges = [];
88
+ const loopRe = /\b(for|while|do)\b/g;
89
+ let m;
90
+ while ((m = loopRe.exec(text)) !== null) {
91
+ const r = nextBlockRange(text, m.index);
92
+ if (r) ranges.push(r);
93
+ }
94
+ // 迭代回调:`xs.forEach((x) => { ... })` 之类,同样构成「循环体内」
95
+ const cbRe = /\.(forEach|map|filter|reduce|some|every|flatMap)\s*\(/g;
96
+ while ((m = cbRe.exec(text)) !== null) {
97
+ const openParen = text.indexOf('(', m.index);
98
+ const r = nextBlockRange(text, openParen + 1);
99
+ if (r) ranges.push(r);
100
+ }
101
+ return ranges;
102
+ }
103
+
104
+ /**
105
+ * 循环体覆盖的行号集合(含循环头那一行到块体结束行)。
106
+ * @param {string} text 文件全文
107
+ * @returns {Set<number>} 行号集合
108
+ */
109
+ export function loopBodyLines(text = '') {
110
+ const s = String(text || '');
111
+ const out = new Set();
112
+ for (const [a, b] of collectLoopRanges(s)) {
113
+ const first = lineOf(s, a);
114
+ const last = lineOf(s, b);
115
+ for (let l = first; l <= last; l += 1) out.add(l);
116
+ }
117
+ return out;
118
+ }
119
+
120
+ /**
121
+ * 查询/解析类函数名(本规则只看这类)——这类通常纯函数且可能开销不小,重复调用值得记忆化。
122
+ * 实测不加这层收窄时,本仓库 184 个文件里误报 218 处(log/push/emit/readFile 等重复调用
123
+ * 多是有意为之)。
124
+ */
125
+ const LOOKUP_LIKE_RE = /(?:^|\.)?(?:resolve|lookup|canonical|toPath|find[A-Z]|get[A-Z]|parse[A-Z]|normalize[A-Z]|compute[A-Z]|build[A-Z]|read[A-Z])/;
126
+
127
+ /**
128
+ * 只保留**最内层**循环区间(不含其它循环区间的那些)。
129
+ *
130
+ * 为什么:外层区间会把「不同内层循环里文本相同的调用」误判成重复。
131
+ * 实测误报:两个相邻的内层循环里写了同一个调用(`for (…of io.reads) { resolveIoPath(…) }`
132
+ * 与 `for (…of io.writes) { …同一个调用… }`),它们是独立内层循环,却被外层区间当成重复。
133
+ * 只比最内层后,这类误报消失;而真实案例(同一内层循环内重复调用同一函数)仍会被抓到。
134
+ * @param {string} text 文件全文
135
+ * @returns {Array<[number, number]>} 最内层区间列表
136
+ */
137
+ function innermostLoopRanges(text) {
138
+ const all = collectLoopRanges(text);
139
+ return all.filter((r) => !all.some((o) => o !== r && o[0] > r[0] && o[1] < r[1]));
140
+ }
141
+
142
+ /**
143
+ * astConfirmKind: "repeat-identical-call" 的 **allow** 集合 ——
144
+ * 同一个循环体内 ≥2 次**实参完全相同**的函数调用所在行。
145
+ *
146
+ * 背景(真实案例):外部项目里 `resolveModuleToFilePath` 在解析循环中被调用 8762 次(约 180 次/文件),
147
+ * 累计 4581ms 占全量扫描 89%;而 fs 探测只有 191 次/11ms —— 瓶颈是**重复纯计算**,
148
+ * 加一层记忆化后该函数 4581ms → 344ms、整体 5143ms → 763ms。
149
+ *
150
+ * 判据与边界(宁可漏报不误报):
151
+ * · 只看循环体内(复用 loopBodyLines);
152
+ * · 比较「函数名 + 实参文本(去空白)」完全相同 —— 实参不同的重复调用(如同名函数不同入参)
153
+ * 不报,因为无法静态判断哪个更贵;
154
+ * · 只匹配**无嵌套括号**的调用(保守,嵌套实参的调用一律不判);
155
+ * · 排除注释/字符串里的示例。
156
+ * 注意:本规则是**代理特征**——它抓「完全重复的调用」,而案例里更常见的是「入参部分重叠」,
157
+ * 那类只能靠运行时探针(分阶段计时 + 调用计数)定位。
158
+ * 收窄:只判**查询/解析类**函数名(resolve/lookup/findX/getX/parseX/normalizeX/computeX/buildX)——
159
+ * 这类通常纯函数且可能开销不小;而 log/push/emit/readFile 之类重复调用多是有意为之
160
+ * (实测不加这层收窄时,本仓库 184 个文件里误报 218 处)。
161
+ * @param {string} text 文件全文
162
+ * @returns {Set<number>} 命中行号集合
163
+ */
164
+ export function repeatIdenticalCallLines(text = '') {
165
+ const s = String(text || '');
166
+ const out = new Set();
167
+ const tokens = tokenize(s);
168
+ // 只比最内层循环区间:外层区间会把不同内层循环里文本相同的调用误判成重复(实测误报已修)
169
+ for (const [a, b] of innermostLoopRanges(s)) {
170
+ const body = s.slice(a, b + 1);
171
+ const seen = new Map();
172
+ const re = /([A-Za-z_$][\w.$]*)\s*\(([^()]*)\)/g;
173
+ let m;
174
+ while ((m = re.exec(body)) !== null) {
175
+ if (!LOOKUP_LIKE_RE.test(m[1])) continue;
176
+ const line = lineOf(s, a + m.index);
177
+ if (inCommentOrString(tokens, line, m[0])) continue;
178
+ const key = `${m[1]}(${m[2].replace(/\s+/g, '')})`;
179
+ if (seen.has(key)) {
180
+ if (seen.get(key) !== line) out.add(line); // 同一行内的重复(如 a() && a())不算
181
+ } else {
182
+ seen.set(key, line);
183
+ }
184
+ }
185
+ }
186
+ return out;
187
+ }
188
+
189
+ /**
190
+ * astConfirmKind: "loop-full-collection" 的 **allow** 集合 —— 循环体内做全量集合物化的行号。
191
+ *
192
+ * 判据:`Array.from(x.values() | x.keys() | x.entries())` 且该行落在循环体内。
193
+ *
194
+ * 为什么还要排注释/字符串:本规则用 allow 语义(引擎会跳过通用 codeFilter),
195
+ * 注释里写的示例(如「循环内 Array.from(x.values()) 是反模式」)也含该字面量,
196
+ * 会自报假阳性(实测:本仓库 lib/checks/regex.js 的规则说明注释被自己命中)。
197
+ * 这里按 token 级判定:同一行存在 comment/str/tmpl 且其文本包含该命中串 → 不算命中。
198
+ * @param {string} text 文件全文
199
+ * @returns {Set<number>} 命中行号集合
200
+ */
201
+ export function loopFullCollectionLines(text = '') {
202
+ const s = String(text || '');
203
+ const loops = loopBodyLines(s);
204
+ const out = new Set();
205
+ if (loops.size === 0) return out;
206
+ const tokens = tokenize(s);
207
+ const re = /Array\.from\s*\(\s*[A-Za-z_$][\w.$]*\.(values|keys|entries)\s*\(\s*\)\s*\)/g;
208
+ let m;
209
+ while ((m = re.exec(s)) !== null) {
210
+ const line = lineOf(s, m.index);
211
+ if (!loops.has(line)) continue;
212
+ if (inCommentOrString(tokens, line, m[0])) continue;
213
+ out.add(line);
214
+ }
215
+ return out;
216
+ }
217
+
218
+ // ============================================================
219
+ // 2026-10-12 新增 4 条实战精筛
220
+ // 来源:gamebanana-mods-downloader 的真实修复提交(每条都验证过「修复前命中、修复后不报」)
221
+ // 共性:正则只能看出「写了某个调用/循环」,看不出**它在不在循环里、循环规模多大、函数会不会返回 undefined**
222
+ // —— 这些必须按结构判定,故一律走 AST 精筛(allow 语义:只有这里返回的行才报)。
223
+ // ============================================================
224
+
225
+ /** 收集函数块体区间:function 声明 + 箭头函数块体。返回 [{name, a, b}](a/b 为块体内部区间)。 */
226
+ function collectFuncRanges(text) {
227
+ const out = [];
228
+ const re = /(?:async\s+)?function\s*([\w$]*)\s*\([^)]*\)\s*\{/g;
229
+ let m;
230
+ while ((m = re.exec(text)) !== null) {
231
+ const open = m.index + m[0].length - 1;
232
+ const close = matchingBrace(text, open);
233
+ if (close > open) out.push({ name: m[1] || '(anonymous)', a: open + 1, b: close });
234
+ }
235
+ const re2 = /(?:const|let|var)\s+([\w$]+)\s*=\s*(?:async\s*)?(?:\([^)]*\)|[\w$]+)\s*=>\s*\{/g;
236
+ while ((m = re2.exec(text)) !== null) {
237
+ const open = m.index + m[0].length - 1;
238
+ const close = matchingBrace(text, open);
239
+ if (close > open) out.push({ name: m[1], a: open + 1, b: close });
240
+ }
241
+ return out;
242
+ }
243
+
244
+ /** 直接整份写文件的函数名(同文件内 `writeFileSync` + `JSON.stringify` 同时出现)。 */
245
+ function directFullWriters(text) {
246
+ const names = new Set();
247
+ for (const f of collectFuncRanges(text)) {
248
+ const body = text.slice(f.a, f.b);
249
+ if (/writeFileSync\s*\(/.test(body) && /JSON\.stringify\s*\(/.test(body)) names.add(f.name);
250
+ }
251
+ return names;
252
+ }
253
+
254
+ /**
255
+ * 把注释、字符串、模板串、正则字面量的**内容**替换为空格(保留换行,便于行号对齐)。
256
+ *
257
+ * 为什么需要:本规则与同族规则的判定正则直接跑在**原文**上,会把注释/字符串里的 "return"
258
+ * 当成代码。实测误报(2026-10-13):注释行以「…只认有值 return」结尾 + 换行 + 下一行代码,
259
+ * 被 `/\breturn\s+[^\s;]/` 匹配成"循环体内有值 return"。
260
+ * @param {string} text 文本
261
+ * @returns {string} 同长度、仅注释与字面量内容被空格替换的文本
262
+ */
263
+ function blankCommentsAndLiterals(text) {
264
+ const src = String(text || '');
265
+ let out = '';
266
+ let i = 0;
267
+ /** 正则字面量判定:向前找最近的非空白字符,非标识符/右括号/右方括号 ⇒ 视为正则开始。 */
268
+ const isRegexStart = (idx) => {
269
+ for (let k = idx - 1; k >= 0; k -= 1) {
270
+ const c = src[k];
271
+ if (/\s/.test(c)) continue;
272
+ return !/[\w$)\]]/.test(c);
273
+ }
274
+ return true;
275
+ };
276
+ while (i < src.length) {
277
+ const c = src[i];
278
+ const c2 = src[i + 1];
279
+ if (c === '/' && c2 === '/') {
280
+ const end = src.indexOf('\n', i);
281
+ const stop = end === -1 ? src.length : end;
282
+ out += ' '.repeat(stop - i);
283
+ i = stop;
284
+ continue;
285
+ }
286
+ if (c === '/' && c2 === '*') {
287
+ const end = src.indexOf('*/', i + 2);
288
+ const stop = end === -1 ? src.length : end + 2;
289
+ out += src.slice(i, stop).replace(/[^\n]/g, ' ');
290
+ i = stop;
291
+ continue;
292
+ }
293
+ if (c === '"' || c === "'" || c === '\u0060') { // \u0060 = 反引号:写转义而非字面反引号,避免本文件的区间解析被模板串状态带偏
294
+ let j = i + 1;
295
+ while (j < src.length) {
296
+ if (src[j] === '\\') { j += 2; continue; }
297
+ if (src[j] === c) { j += 1; break; }
298
+ if (c !== '`' && src[j] === '\n') break;
299
+ j += 1;
300
+ }
301
+ out += src.slice(i, j).replace(/[^\n]/g, ' ');
302
+ i = j;
303
+ continue;
304
+ }
305
+ if (c === '/' && isRegexStart(i)) {
306
+ let j = i + 1;
307
+ let inClass = false;
308
+ while (j < src.length) {
309
+ const d = src[j];
310
+ if (d === '\\') { j += 2; continue; }
311
+ if (d === '[') inClass = true;
312
+ else if (d === ']') inClass = false;
313
+ else if (d === '/' && !inClass) { j += 1; break; }
314
+ else if (d === '\n') break;
315
+ j += 1;
316
+ }
317
+ out += src.slice(i, j).replace(/[^\n]/g, ' ');
318
+ i = j;
319
+ continue;
320
+ }
321
+ out += c;
322
+ i += 1;
323
+ }
324
+ return out;
325
+ }
326
+
327
+ /**
328
+ * astConfirmKind: "loop-no-fallback-return" 的 **allow** 集合 ——
329
+ * 函数顶层循环里有「有值 return」,而循环之后既无 return 也无 throw ⇒ 可能返回 undefined。
330
+ *
331
+ * 实战:`fetchJsonHeaders` 的 for 重试循环里 return,而网络错误时 maxAttempts(6) 大于循环上界
332
+ * retries(1) ⇒ 循环走完却不抛错 ⇒ **返回 undefined** ⇒ 调用方 `const { json } = await …` 解构崩溃,
333
+ * 面板只显示 "Cannot destructure property 'json' of '(intermediate value)' as it is undefined"。
334
+ * 边界:裸 `return;` 不算(排空/提前退出助手,返回值无人使用,如 native-host 的 pump())。
335
+ *
336
+ * 2026-10-13 修误报(三处收窄,均为实测证伪的假阳性,错误逻辑已直接删除不留注释):
337
+ * ① 剔除**嵌套函数体**:IIFE/内部箭头函数里的 return 不属于本循环
338
+ * (误报:`orchestrate.js` 循环体内 `(() => { try { return hasMarkBlock(…) } catch { return false } })()`)
339
+ * ② 剔除**注释与字符串/正则字面量**里的 return(误报:注释以「…return」结尾 + 换行 + 下一行代码)
340
+ * ③ 跳过 `for (;;)` / `while (true)` 且体内**无 break** 的循环:它只能经 return/throw 退出,走不到循环之后
341
+ * (误报:`lib/exempt/index.js` 的两个逐级向上查找循环)
342
+ * @param {string} text 文件全文
343
+ * @returns {Set<number>} 命中行号集合
344
+ */
345
+ export function loopNoFallbackReturnLines(text = '') {
346
+ const s = String(text || '');
347
+ const out = new Set();
348
+ for (const f of collectFuncRanges(s)) {
349
+ const body = s.slice(f.a, f.b);
350
+ const all = collectLoopRanges(body);
351
+ // 只看函数顶层循环(不含被别的循环包住的)
352
+ const top = all.filter((r) => !all.some((o) => o !== r && o[0] < r[0] && o[1] > r[1]));
353
+ for (const [a, b] of top) {
354
+ const inner = body.slice(a, b + 1);
355
+ // 收窄①:把嵌套函数体的字符区间挖空(保持长度,行号不受影响)
356
+ let own = inner;
357
+ for (const nf of collectFuncRanges(inner)) {
358
+ own = own.slice(0, nf.a) + ' '.repeat(Math.max(0, nf.b - nf.a + 1)) + own.slice(nf.b + 1);
359
+ }
360
+ // 收窄②:注释与字面量内容挖空
361
+ own = blankCommentsAndLiterals(own);
362
+ if (!/\breturn\s+[^\s;]/.test(own)) continue; // 只认有值 return
363
+ // 收窄③:无限循环且无 break ⇒ 不需要兜底 return
364
+ // 注意:区间起点是**花括号块**本身(nextBlockRange 返回 [open, close],不含循环头),
365
+ // 所以无限循环判定必须从块**之前**的文本回看,不能从块内取头。
366
+ const before = body.slice(Math.max(0, a - 80), a);
367
+ const infinite = /for\s*\(\s*;\s*;\s*\)\s*$/.test(before) || /while\s*\(\s*(?:true|1)\s*\)\s*$/.test(before);
368
+ if (infinite && !/\bbreak\b/.test(own)) continue;
369
+ const tail = body.slice(b + 1).replace(/\s|}/g, '');
370
+ if (tail) continue; // 循环之后还有语句
371
+ out.add(lineOf(s, f.a + a));
372
+ }
373
+ }
374
+ return out;
375
+ }
376
+
377
+ /**
378
+ * astConfirmKind: "loop-full-rewrite-call" 的 **allow** 集合 ——
379
+ * 循环体内调用「整份重写文件」的函数(同文件一层解析:被调函数自己含 writeFileSync + JSON.stringify,
380
+ * 或它调用了这样的函数)。
381
+ *
382
+ * 实战:`finalizeHtmls` 逐目录调 `ingestModDir` → `saveGameFile` 把整份游戏索引(15–26MB)重写一遍
383
+ * ⇒ 数千目录 = 几十 GB 写盘、收尾 634 秒、期间 /api/* 连续 74 秒全部超时。
384
+ * **局限(必须说清)**:循环规模静态不可知 —— 「13 个游戏各写一次」与「4,598 个目录各写一次」代码同形
385
+ * ⇒ 本规则只作 warning,判真伪需运行期计数。
386
+ * @param {string} text 文件全文
387
+ * @returns {Set<number>} 命中行号集合
388
+ */
389
+ export function loopFullRewriteCallLines(text = '') {
390
+ const s = String(text || '');
391
+ const out = new Set();
392
+ const direct = directFullWriters(s);
393
+ if (direct.size === 0) return out;
394
+ const tokens = tokenize(s);
395
+ for (const [a, b] of collectLoopRanges(s)) {
396
+ const body = s.slice(a, b + 1);
397
+ const re = /([A-Za-z_$][\w$]*)\s*\(/g;
398
+ let m;
399
+ while ((m = re.exec(body)) !== null) {
400
+ const name = m[1];
401
+ if (!direct.has(name)) continue;
402
+ const line = lineOf(s, a + m.index);
403
+ if (inCommentOrString(tokens, line, m[0])) continue;
404
+ // 已批量化/已加守卫的不报(修好之后不该再被报):
405
+ // · 实参里带 deferSave/批量标记 ⇒ 调用方已改为循环外统一落盘
406
+ // · 调用前面 ~200 字符内有 `if (changed…` ⇒ 只有内容真变了才写
407
+ const args = body.slice(m.index, m.index + 160);
408
+ if (/deferSave|batch|批量/i.test(args)) continue;
409
+ const before = body.slice(Math.max(0, m.index - 200), m.index);
410
+ if (/if\s*\([^)]*changed/.test(before)) continue;
411
+ out.add(line);
412
+ }
413
+ }
414
+ return out;
415
+ }
416
+
417
+ /**
418
+ * astConfirmKind: "nested-linear-scan" 的 **allow** 集合 ——
419
+ * 成员判定回调(filter/find/some/every)里再套 for 循环并做 `===` 比较 ⇒ O(n×m)。
420
+ *
421
+ * 实战:`planForAppend` 的「已在列表则跳过」用 `list.filter(u => { for (…of pendingMods) if (id === …) …;
422
+ * for (…of items) … })`:现场 2,544 × (3,655 + 36,739) ≈ **1.03 亿次**比较,纯 CPU 阻塞 12,784ms。
423
+ * 改成先把两侧收进 Set 再判定 ⇒ O(n+m),实测 14ms(913×)。
424
+ * 边界:只看**块体**回调(表达式回调无循环体);只看真的套了 for 且做了 === 的。
425
+ * @param {string} text 文件全文
426
+ * @returns {Set<number>} 命中行号集合
427
+ */
428
+ export function nestedLinearScanLines(text = '') {
429
+ const s = String(text || '');
430
+ const out = new Set();
431
+ const tokens = tokenize(s);
432
+ const re = /\.(filter|find|some|every)\s*\(/g;
433
+ let m;
434
+ while ((m = re.exec(s)) !== null) {
435
+ const paren = s.indexOf('(', m.index);
436
+ const close = matchingParen(s, paren);
437
+ if (close < 0) continue;
438
+ const cb = s.slice(paren, close);
439
+ if (!/\bfor\s*(?:await\s*)?\(/.test(cb)) continue;
440
+ if (!cb.includes('===')) continue;
441
+ const line = lineOf(s, m.index);
442
+ if (inCommentOrString(tokens, line, m[0])) continue;
443
+ out.add(line);
444
+ }
445
+ return out;
446
+ }
447
+
448
+ /**
449
+ * astConfirmKind: "long-sync-loop" 的 **allow** 集合 ——
450
+ * async 函数内的长同步循环:循环体 ≥2 个同步调用且整段无 `await` 让出点 ⇒ 占满事件循环。
451
+ *
452
+ * 实战:`finalizeHtmls` 逐目录做 existsSync/statSync/readFileSync + 写 HTML,全程同步 ⇒ 事件循环被
453
+ * 占满 **74 秒**,期间 /api/* 全部 8 秒超时。修法:每 5 个目录 `await setImmediate` 让出一次
454
+ * (总耗时不变,服务保持可响应)。
455
+ * @param {string} text 文件全文
456
+ * @returns {Set<number>} 命中行号集合
457
+ */
458
+ export function longSyncLoopLines(text = '') {
459
+ const s = String(text || '');
460
+ const out = new Set();
461
+ for (const f of collectFuncRanges(s)) {
462
+ if (!/async/.test(s.slice(Math.max(0, f.a - 60), f.a))) continue; // 只在 async 函数内(才有让出的可能)
463
+ const body = s.slice(f.a, f.b);
464
+ for (const [a, b] of collectLoopRanges(body)) {
465
+ const inner = body.slice(a, b + 1);
466
+ if ((inner.match(/Sync\s*\(/g) || []).length < 2) continue;
467
+ if (/\bawait\b/.test(inner)) continue; // 已有让出点
468
+ out.add(lineOf(s, f.a + a));
469
+ }
470
+ }
471
+ return out;
472
+ }