dsh-git-push 2.20.19 → 3.1.0

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 (239) hide show
  1. package/README.md +76 -47
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +11 -4
  4. package/lib/app/apply.js +15 -13
  5. package/lib/app/command-registry.js +26 -19
  6. package/lib/app/handlers/http-constants.js +8 -0
  7. package/lib/app/handlers/meta.js +2 -2
  8. package/lib/app/handlers/preprocess.js +104 -0
  9. package/lib/app/handlers/repo-actions.js +2 -3
  10. package/lib/app/handlers/repos.js +137 -10
  11. package/lib/app/handlers/settings.js +34 -15
  12. package/lib/app/http-handlers.js +13 -42
  13. package/lib/app/index.js +3 -2
  14. package/lib/app/inject-text.js +6 -21
  15. package/lib/app/preprocess-client.js +136 -0
  16. package/lib/app/repo-ownership.js +1 -1
  17. package/lib/app/schema.js +20 -10
  18. package/lib/app/settings-bridge.js +60 -8
  19. package/lib/app/severity.js +14 -0
  20. package/lib/app/slash-commands.js +5 -164
  21. package/lib/app/tool-call.js +96 -163
  22. package/lib/cli/commands-preprocess.mjs +74 -0
  23. package/lib/cli/commands-tool.mjs +3 -2
  24. package/lib/cli/commands-vcs.mjs +39 -5
  25. package/lib/cli/shared.mjs +36 -10
  26. package/lib/client/index.js +11 -16
  27. package/lib/client-parts/git/account.js +21 -12
  28. package/lib/client-parts/git/actions.js +23 -77
  29. package/lib/client-parts/git/apply.js +8 -2
  30. package/lib/client-parts/git/browser.js +1 -1
  31. package/lib/client-parts/git/const.js +33 -1
  32. package/lib/client-parts/git/controller.js +175 -176
  33. package/lib/client-parts/git/icons.js +1 -1
  34. package/lib/client-parts/git/loader.js +1 -1
  35. package/lib/client-parts/git/npm.js +56 -37
  36. package/lib/client-parts/git/page.js +53 -1
  37. package/lib/client-parts/git/repo.js +8 -1
  38. package/lib/client-parts/git/settings.js +13 -1
  39. package/lib/client-parts/git/state.js +237 -0
  40. package/lib/client-parts/git/utils.js +1 -1
  41. package/lib/client.js +631 -312
  42. package/lib/commit-push/pre-commit-engine.js +629 -30
  43. package/lib/commit-push.js +127 -67
  44. package/lib/context/index.js +7 -5
  45. package/lib/core/config.js +1 -27
  46. package/lib/core/exec.js +2 -11
  47. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  48. package/lib/git/identity-rewrite.js +1 -1
  49. package/lib/git/ignore.js +1 -1
  50. package/lib/git/index.js +1 -1
  51. package/lib/git/push.js +2 -17
  52. package/lib/git/repo-index.js +8 -3
  53. package/lib/git/repos.js +2 -2
  54. package/lib/git/sensitive.js +1 -1
  55. package/lib/npm/install.js +1 -1
  56. package/lib/npm/publish.js +20 -5
  57. package/lib/npm/registry.js +2 -2
  58. package/lib/plugin/auto-push.js +5 -8
  59. package/lib/preprocess/providers.js +195 -0
  60. package/lib/self/index.js +1 -1
  61. package/lib/skip-dirs.js +14 -55
  62. package/package.json +31 -42
  63. package/skills/dev/dsh-git-push.md +9 -9
  64. package/skills/guide/guide-commit-push.md +11 -13
  65. package/skills/workflow/README.md +0 -1
  66. package/skills/workflow/task-completion-report.md +2 -2
  67. package/.auditignore +0 -30
  68. package/.gitignore +0 -43
  69. package/cli-audit.mjs +0 -141
  70. package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
  71. package/lib/app/audit-api.js +0 -173
  72. package/lib/app/handlers/audit.js +0 -150
  73. package/lib/app/host-doc-checks.js +0 -25
  74. package/lib/app/schema-audit.js +0 -42
  75. package/lib/app/scope-check.js +0 -69
  76. package/lib/ast/brace.js +0 -120
  77. package/lib/ast/callgraph.js +0 -135
  78. package/lib/ast/code-lines.js +0 -175
  79. package/lib/ast/consts.js +0 -12
  80. package/lib/ast/control-flow.js +0 -470
  81. package/lib/ast/credential.js +0 -315
  82. package/lib/ast/dataflow.js +0 -391
  83. package/lib/ast/dup-code.js +0 -165
  84. package/lib/ast/fs-hotspots.js +0 -154
  85. package/lib/ast/index.js +0 -38
  86. package/lib/ast/io-risk-const.js +0 -95
  87. package/lib/ast/io-risk-fn.js +0 -208
  88. package/lib/ast/io-risk-loop.js +0 -308
  89. package/lib/ast/io-risk.js +0 -314
  90. package/lib/ast/lang.js +0 -156
  91. package/lib/ast/line-count.js +0 -52
  92. package/lib/ast/magic-number.js +0 -272
  93. package/lib/ast/naming.js +0 -292
  94. package/lib/ast/perf.js +0 -488
  95. package/lib/ast/scope-collisions.js +0 -228
  96. package/lib/ast/scope.js +0 -241
  97. package/lib/ast/shell.js +0 -131
  98. package/lib/ast/size.js +0 -448
  99. package/lib/ast/symbol-index.js +0 -399
  100. package/lib/ast/tokenizer.js +0 -421
  101. package/lib/ast/treesitter.js +0 -413
  102. package/lib/audit/analysis-coverage.js +0 -98
  103. package/lib/audit/audit-file.js +0 -205
  104. package/lib/audit/auditignore-rules.js +0 -148
  105. package/lib/audit/checks.js +0 -17
  106. package/lib/audit/client-entry.js +0 -93
  107. package/lib/audit/collector.js +0 -610
  108. package/lib/audit/ext-runner.js +0 -80
  109. package/lib/audit/file-context.js +0 -391
  110. package/lib/audit/finding.js +0 -101
  111. package/lib/audit/gitignore-match.js +0 -113
  112. package/lib/audit/glob.js +0 -63
  113. package/lib/audit/history-report.js +0 -100
  114. package/lib/audit/history.js +0 -126
  115. package/lib/audit/ignore-blind.js +0 -102
  116. package/lib/audit/index.js +0 -33
  117. package/lib/audit/orchestrate.js +0 -672
  118. package/lib/audit/public.js +0 -24
  119. package/lib/audit/repo-level.js +0 -30
  120. package/lib/audit/report-yaml.js +0 -90
  121. package/lib/audit/scope-policy.js +0 -110
  122. package/lib/audit/slot.js +0 -66
  123. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  124. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  125. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  126. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  127. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  128. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  129. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  130. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  131. package/lib/audit-rules/audit-rules-go.yml +0 -103
  132. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  133. package/lib/audit-rules/audit-rules-java.yml +0 -105
  134. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  135. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  136. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  137. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  138. package/lib/audit-rules/audit-rules-php.yml +0 -101
  139. package/lib/audit-rules/audit-rules-private.yml +0 -24
  140. package/lib/audit-rules/audit-rules-python.yml +0 -106
  141. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  142. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  143. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  144. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  145. package/lib/audit-rules/audit-rules-template.yml +0 -108
  146. package/lib/audit-ui-sdk/contract.js +0 -117
  147. package/lib/audit-ui-sdk/index.js +0 -17
  148. package/lib/checks/button-bind.js +0 -347
  149. package/lib/checks/common.js +0 -170
  150. package/lib/checks/credential-file.js +0 -43
  151. package/lib/checks/dataflow.js +0 -40
  152. package/lib/checks/dispatch.js +0 -117
  153. package/lib/checks/dup-code.js +0 -69
  154. package/lib/checks/dup-const.js +0 -232
  155. package/lib/checks/file-health.js +0 -150
  156. package/lib/checks/filter.js +0 -137
  157. package/lib/checks/folder.js +0 -173
  158. package/lib/checks/fs-scanner.js +0 -57
  159. package/lib/checks/hardcoded-path.js +0 -98
  160. package/lib/checks/index.js +0 -49
  161. package/lib/checks/io.js +0 -66
  162. package/lib/checks/magic-number.js +0 -42
  163. package/lib/checks/npm-json.js +0 -273
  164. package/lib/checks/private.js +0 -64
  165. package/lib/checks/regex.js +0 -298
  166. package/lib/checks/scope-collision.js +0 -68
  167. package/lib/checks/semantic.js +0 -134
  168. package/lib/checks/structural.js +0 -281
  169. package/lib/cli/commands-audit.mjs +0 -142
  170. package/lib/cli/commands-doc.mjs +0 -127
  171. package/lib/client-parts/audit/audit.js +0 -301
  172. package/lib/exempt/tool.js +0 -198
  173. package/lib/git/module-splitter.js +0 -47
  174. package/lib/link-check/index.js +0 -187
  175. package/lib/lint-adapter/detect.js +0 -161
  176. package/lib/lint-adapter/index.js +0 -50
  177. package/lib/lint-adapter/runner.js +0 -133
  178. package/lib/preprocess/audit.js +0 -98
  179. package/lib/preprocess/index.js +0 -78
  180. package/lib/rule/compilers/credential.js +0 -62
  181. package/lib/rule/compilers/dataflow.js +0 -38
  182. package/lib/rule/compilers/file-health.js +0 -75
  183. package/lib/rule/compilers/frontend.js +0 -86
  184. package/lib/rule/compilers/func.js +0 -35
  185. package/lib/rule/compilers/helpers.js +0 -71
  186. package/lib/rule/compilers/index.js +0 -29
  187. package/lib/rule/compilers/link-semantic.js +0 -45
  188. package/lib/rule/compilers/list-kinds.js +0 -12
  189. package/lib/rule/compilers/numeric-kinds.js +0 -73
  190. package/lib/rule/compilers/regex.js +0 -78
  191. package/lib/rule/compilers/structure.js +0 -107
  192. package/lib/rule/compilers.js +0 -17
  193. package/lib/rule/homoglyph.js +0 -45
  194. package/lib/rule/loader.js +0 -274
  195. package/lib/rule/registry.js +0 -122
  196. package/lib/rule/scope.js +0 -67
  197. package/lib/score/docs-score.js +0 -166
  198. package/lib/score/index.js +0 -234
  199. package/lib/user-requirements.json +0 -15
  200. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  201. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  202. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  203. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  204. package/scripts/audit-gate.mjs +0 -235
  205. package/scripts/audit-runner.mjs +0 -35
  206. package/scripts/audit-runtime-check.mjs +0 -129
  207. package/scripts/browser-page-probe.mjs +0 -271
  208. package/scripts/build-client.mjs +0 -131
  209. package/scripts/bump-version.mjs +0 -178
  210. package/scripts/check-js-scope.mjs +0 -87
  211. package/scripts/check.mjs +0 -203
  212. package/scripts/clean-date-comments.py +0 -102
  213. package/scripts/cpu-sample.mjs +0 -188
  214. package/scripts/doc-drift.mjs +0 -200
  215. package/scripts/doc-func.mjs +0 -212
  216. package/scripts/doc-tree.mjs +0 -458
  217. package/scripts/doc-version.mjs +0 -149
  218. package/scripts/hot-path-probe-cjs.cjs +0 -71
  219. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  220. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  221. package/scripts/hot-path-probe.mjs +0 -153
  222. package/scripts/local-registry.mjs +0 -37
  223. package/scripts/module-splitter.py +0 -800
  224. package/scripts/picker-repro.mjs +0 -115
  225. package/scripts/platform-scan.mjs +0 -168
  226. package/scripts/probe-recheck.mjs +0 -47
  227. package/scripts/rename-locator.mjs +0 -97
  228. package/scripts/rule-switch.mjs +0 -97
  229. package/scripts/rules-solo-audit.mjs +0 -173
  230. package/scripts/scan-file-io.mjs +0 -717
  231. package/scripts/scan-fs-hotspots.mjs +0 -107
  232. package/scripts/scan-version.mjs +0 -125
  233. package/scripts/symbol-index.mjs +0 -85
  234. package/scripts/verify-prestep.mjs +0 -100
  235. package/scripts/version-source.mjs +0 -173
  236. package/skills/dev/audit-rule-authoring.md +0 -58
  237. package/skills/guide/guide-audit.md +0 -270
  238. /package/lib/{audit → app}/ownership.js +0 -0
  239. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
@@ -1,154 +0,0 @@
1
- /**
2
- * AST 层 · FS 热点抽取(**单一实现**,供两处消费)
3
- *
4
- * ① 审计规则 `performance/multi-file-scanners`(仓库级:扫描实现 > 阈值 ⇒ notice)
5
- * ② 独立 CLI `scripts/scan-fs-hotspots.mjs`(①stat 热点排序 + ④遍历入口 + ②③⑤ 明细)
6
- *
7
- * 【为什么要单独一个模块】同一份判据若在「审计规则」和「CLI」各写一套 ⇒ 必然漂移 ✗
8
- * (本项目反复踩的坑)。这里只写一份,两边只做「取数 + 呈现」。
9
- *
10
- * 【口径来源】移植自 bench-template 的 scripts/scan-fs-hotspots.mjs(2026-10-16 交接),
11
- * 但**函数边界用插件自己的 collectFuncRanges**(真括号配对)⇒ 比原脚本的正则更准 ✓
12
- *
13
- * ⚠️ 计数纪律:每个调用**只计一次**(先整文件扫一遍,再按字符位置归属到所属函数)。
14
- * 反面教材(本文件第一版):先整文件收一遍、再每个函数各收一遍 ⇒ 同一调用被计两次 ✗
15
- * ⇒ CLI 打出来 stat 48 而基线是 25 ✗(实测发现的真 bug)。
16
- *
17
- * 判据(六类,与交接文档一致):
18
- * ① stat 调用点 —— 每个 stat 调用的 文件:行 + 所属函数 + 原始表达式(每条只出现一次)
19
- * ② 重复 stat —— 同一函数内**同一表达式** stat ≥2 次(可合并成一次)
20
- * ③ 重复 readdir —— 同一函数内同一表达式 readdir ≥2 次
21
- * ④ 遍历入口 —— 函数体内有 readdir,且「自递归」或调用已知 walker 名
22
- * ⑤ 逐文件扫描实现 —— 函数体内同时出现 readdir 与 stat ⇒ 一个「扫描器」实现
23
- * ⑥ 汇总 —— 给调用方直接用的 totals
24
- */
25
- import { collectFuncRanges } from './perf.js';
26
-
27
- /** 统计类调用(① 热点排序 / ⑤ 扫描器判定)。 */
28
- const STAT_RE = /(?:^|[^\w$.])(?:fs\s*\.\s*)?(statSync|stat|lstatSync|lstat)\s*\(([^()]*)\)/g;
29
- /** 目录列举类调用(③⑤④)。 */
30
- const READDIR_RE = /(?:^|[^\w$.])(?:fs\s*\.\s*)?(readdirSync|readdir)\s*\(([^()]*)\)/g;
31
- /** 已知遍历入口名(交接文档 §四.3 明说:这是名字白名单,新命名需补进来)。 */
32
- export const FS_WALKERS = ['recursiveScanAll', 'walkWithIndex', 'scanDirShallow', 'recursiveScan', 'walkDir'];
33
-
34
- /** 同函数内「同一表达式」的键:`statSync(dir)` —— 实参去空白。 */
35
- const callKey = (name, args) => `${name}(${String(args).replace(/\s+/g, '')})`;
36
-
37
- /** 字符偏移 → 行号(1-based)。 */
38
- function lineAt(text, idx) {
39
- let line = 1;
40
- for (let i = 0; i < idx && i < text.length; i += 1) if (text[i] === '\n') line += 1;
41
- return line;
42
- }
43
-
44
- /**
45
- * 扫描单个文件的 FS 热点(每个调用只计一次)。
46
- * @param {string} text 文件全文
47
- * @param {string} [relPath] 相对路径(回填进结果,便于上层聚合与展示)
48
- * @returns {{file:string, stats:Array, readdirs:Array, dupStats:Array, dupReaddirs:Array, walkers:Array, scanners:Array}}
49
- */
50
- export function scanFsHotspotsText(text = '', relPath = '') {
51
- const s = String(text || '');
52
- const out = {
53
- file: relPath, stats: [], readdirs: [], dupStats: [], dupReaddirs: [], walkers: [], scanners: [],
54
- };
55
- const fns = collectFuncRanges(s);
56
-
57
- /** 整文件扫一遍(**只此一次**):返回 {name,args,line,at,expr}。 */
58
- const collect = (re) => {
59
- const res = [];
60
- re.lastIndex = 0;
61
- let m;
62
- while ((m = re.exec(s)) !== null) {
63
- const at = m.index + (m[0].length - m[0].trimStart().length);
64
- res.push({ name: m[1], args: m[2] || '', line: lineAt(s, at), at, expr: callKey(m[1], m[2] || '') });
65
- }
66
- return res;
67
- };
68
- /** 归属函数名(不在任何函数内 ⇒ '' = 顶层)。 */
69
- const fnNameAt = (at) => {
70
- const hit = fns.find((f) => at >= f.a && at <= f.b);
71
- return hit ? hit.name : '';
72
- };
73
-
74
- for (const c of collect(STAT_RE)) out.stats.push({ ...c, fn: fnNameAt(c.at) });
75
- for (const c of collect(READDIR_RE)) out.readdirs.push({ ...c, fn: fnNameAt(c.at) });
76
-
77
- /** 同一组内「同一表达式出现 ≥2 次(且不同行)」⇒ 可合并。 */
78
- const dups = (calls) => {
79
- const seen = new Map();
80
- const res = [];
81
- for (const c of calls) {
82
- if (seen.has(c.expr)) {
83
- if (seen.get(c.expr) !== c.line) res.push(c);
84
- } else seen.set(c.expr, c.line);
85
- }
86
- return res;
87
- };
88
-
89
- // 按「所属函数」分组(顶层同名归一组 ''),一次算出 ②③④⑤
90
- const groups = new Map();
91
- const groupOf = (fn, at) => {
92
- const k = fn || '';
93
- if (!groups.has(k)) groups.set(k, { fn: k, stats: [], readdirs: [], start: at });
94
- return groups.get(k);
95
- };
96
- for (const c of out.stats) groupOf(c.fn, c.at).stats.push(c);
97
- for (const c of out.readdirs) groupOf(c.fn, c.at).readdirs.push(c);
98
-
99
- for (const g of groups.values()) {
100
- out.dupStats.push(...dups(g.stats).map((c) => ({ ...c, fn: g.fn })));
101
- out.dupReaddirs.push(...dups(g.readdirs).map((c) => ({ ...c, fn: g.fn })));
102
- if (g.fn && g.readdirs.length && g.stats.length) {
103
- out.scanners.push({ fn: g.fn, line: g.readdirs[0].line, readdir: g.readdirs[0].line, stat: g.stats[0].line });
104
- }
105
- // ④ 遍历入口:有 readdir,且(自递归 或 调用了已知 walker)
106
- if (g.fn && g.readdirs.length) {
107
- const r = fns.find((f) => f.name === g.fn);
108
- if (r) {
109
- const body = s.slice(r.a, r.b + 1);
110
- const selfRe = new RegExp(`(?:^|[^\\w$.])${String(g.fn).replace(/\$/g, '\\$')}\\s*\\(`);
111
- const walker = FS_WALKERS.find((w) => new RegExp(`(?:^|[^\\w$.])${w}\\s*\\(`).test(body));
112
- if (selfRe.test(body) || walker) {
113
- out.walkers.push({ fn: g.fn, line: lineAt(s, r.a), calls: walker || '(self)' });
114
- }
115
- }
116
- }
117
- }
118
- return out;
119
- }
120
-
121
- /**
122
- * 仓库级聚合:把每个文件的结果合并成「仓库视角」的汇总。
123
- * @param {Array<{path:string, text:string}>} fileTexts
124
- * @returns {{totals:object, files:Array, scanners:Array, dupStats:Array, dupReaddirs:Array, walkers:Array, hot:Array}}
125
- */
126
- export function scanFsHotspots(fileTexts = []) {
127
- const files = [];
128
- const scanners = [];
129
- const dupStats = [];
130
- const dupReaddirs = [];
131
- const walkers = [];
132
- const totals = { files: 0, stats: 0, readdirs: 0, dupStats: 0, dupReaddirs: 0, walkerCalls: 0, scanners: 0 };
133
- for (const { path, text } of fileTexts) {
134
- const r = scanFsHotspotsText(text, path);
135
- files.push(r);
136
- totals.files += 1;
137
- totals.stats += r.stats.length;
138
- totals.readdirs += r.readdirs.length;
139
- totals.walkerCalls += r.walkers.length;
140
- for (const x of r.scanners) scanners.push({ file: path, ...x });
141
- for (const x of r.dupStats) dupStats.push({ file: path, ...x });
142
- for (const x of r.dupReaddirs) dupReaddirs.push({ file: path, ...x });
143
- for (const x of r.walkers) walkers.push({ file: path, ...x });
144
- }
145
- totals.scanners = scanners.length;
146
- totals.dupStats = dupStats.length;
147
- totals.dupReaddirs = dupReaddirs.length;
148
- // ① stat 热点排序:按 stat 调用点数降序(CLI 用;审计规则不用)
149
- const hot = files
150
- .map((f) => ({ file: f.file, stats: f.stats.length, readdirs: f.readdirs.length }))
151
- .filter((x) => x.stats > 0 || x.readdirs > 0)
152
- .sort((a, b) => (b.stats - a.stats) || (b.readdirs - a.readdirs));
153
- return { totals, files, scanners, dupStats, dupReaddirs, walkers, hot };
154
- }
package/lib/ast/index.js DELETED
@@ -1,38 +0,0 @@
1
- /**
2
- * AST 实现层 · 统一出口
3
- *
4
- * 分层位置(三层审计架构第二层):
5
- * ① 规则声明 → lib/audit-rules/*.yml(阈值、豁免清单、上下文关键字)
6
- * ② 具体实现 → lib/ast/*(本目录,token 级解析:字符串/模板串/注释感知)
7
- * ③ 调用包装 → lib/checks/*(把 AST 判定转成 finding,不重复造逻辑)
8
- * ④ 编排调度 → lib/audit/*(收集文件、跑检查、汇总)
9
- *
10
- * 命名说明:本目录叫 ast/ 但实现是 **token 级**而非真正的语法树——
11
- * Node 无内置 JS AST,零依赖约束下 token 级已足够覆盖「注释/字符串里的内容不算代码」
12
- * 这类判定。命名取「比正则更精确的语法级判定」之意,与逐行正则形成对照。
13
- *
14
- * 本文件只做再导出、不含实现:
15
- * 调用方既可 `import { tokenize } from '../ast/index.js'`(出口稳定),
16
- * 也可直接引具体模块(如 '../ast/tokenizer.js')以获得更窄的依赖面。
17
- */
18
-
19
- export { tokenize, clearTokenCache } from './tokenizer.js';
20
- export { matchBrace, isBlockParen, matchingOpen, collectInnerFnRanges } from './brace.js';
21
- export { checkSyncFs, checkEmptyCatchAst, checkComplexityAst, checkNestingDepthAst } from './control-flow.js';
22
- export { checkFuncLinesAst, checkFuncDensityAst, funcRangesAst, maxFunctionLength, checkFileLines, countCommentLines, checkRepeatedStringsAst, checkCommentDensityAst } from './size.js';
23
- export { checkNameLengthAst, checkShortFunctionNameAst, checkSmallFileReadAst, checkConsoleLogJsonAst } from './naming.js';
24
- export { javaKtFuncRanges, detectLang } from './lang.js';
25
- export { makeCodeLineFilter, makeCodeSpanFilter, codeStringLiterals } from './code-lines.js';
26
- export { shellCdDynamicLines, writeIntoGitignoredLines } from './shell.js';
27
- export { checkMagicNumberSmartAst } from './magic-number.js';
28
- export {
29
- isMeaningfulCredentialValue,
30
- checkPlaceholderCredentialAst,
31
- checkCredentialRefAst,
32
- } from './credential.js';
33
- // 三层审计 L2——数据流检查(同函数清空后访问)
34
- export { checkClearAccessAst } from './dataflow.js';
35
- // 拼接产物作用域撞名(分片拼成同一作用域时 var/function 静默覆盖)
36
- export { analyzeScopeCollisions } from './scope-collisions.js';
37
- // I/O 风险分级(四级;scanIoRiskAst 供 checks 层精筛与 scan-file-io 复用)
38
- export { scanIoRiskAst, summarizeIoRisk, rankIoFixList, RISK_BADGE, RISK_LABEL } from './io-risk.js';
@@ -1,95 +0,0 @@
1
- /**
2
- * dsh-git-push — I/O 风险分级:常量与档位工具
3
- *
4
- * 职责:定义「哪些调用算 I/O」「算什么操作类别」「风险如何升档」三类纯数据,
5
- * 以及依赖它们的档位工具函数(raise)。不含任何 token 分析逻辑。
6
- *
7
- * 分层:lib/ast/io-risk.js 的从属模块(由该文件再导出),调用方不应直接 import。
8
- */
9
- /** 同步 fs 调用名(带 Sync 后缀)→ 统一视为阻塞调用。 */
10
- export const SYNC_FS_FNS = new Set([
11
- 'readFileSync', 'writeFileSync', 'appendFileSync', 'existsSync', 'statSync', 'lstatSync',
12
- 'readdirSync', 'mkdirSync', 'rmdirSync', 'rmSync', 'unlinkSync', 'renameSync',
13
- 'copyFileSync', 'chmodSync', 'chownSync', 'openSync', 'closeSync', 'readSync',
14
- 'writeSync', 'truncateSync', 'realpathSync', 'symlinkSync', 'linkSync', 'accessSync',
15
- ]);
16
-
17
- /** 异步 fs 调用名(无 Sync 后缀的常见形态)。 */
18
- export const ASYNC_FS_FNS = new Set([
19
- 'readFile', 'writeFile', 'appendFile', 'stat', 'lstat', 'readdir', 'mkdir', 'rmdir',
20
- 'rm', 'unlink', 'rename', 'copyFile', 'chmod', 'chown', 'open', 'close', 'read',
21
- 'write', 'truncate', 'realpath', 'symlink', 'link', 'access', 'createReadStream',
22
- 'createWriteStream', 'watch', 'opendir',
23
- ]);
24
-
25
- /** 操作类别:写 / 删 / 改名 涉及数据安全,风险加权。 */
26
- export const KIND_BY_FN = {
27
- writeFileSync: 'write', writeFile: 'write', appendFileSync: 'write', appendFile: 'write',
28
- createWriteStream: 'write', writeSync: 'write', write: 'write', truncateSync: 'write',
29
- truncate: 'write',
30
- unlinkSync: 'delete', unlink: 'delete', rmSync: 'delete', rm: 'delete',
31
- rmdirSync: 'delete', rmdir: 'delete',
32
- renameSync: 'rename', rename: 'rename', copyFileSync: 'rename', copyFile: 'rename',
33
- };
34
-
35
- /**
36
- * 元数据/查询/幂等目录操作(io-risk 优化——对照诊断「97% 误报」):
37
- * 单文件 stat/exists/readdir/access 微秒级、mkdir(recursive)/rmdir 幂等——不搬运数据内容,
38
- * 请求路径上不构成阻塞风险 → 降为 low(不再按「请求路径 I/O」一律 medium)。
39
- * 循环内的仍走循环分级(循环内逐次 stat 累积由循环规则判定,不受本档豁免)。
40
- */
41
- export const META_FS_FNS = new Set([
42
- 'existsSync', 'statSync', 'lstatSync', 'readdirSync', 'accessSync', 'realpathSync',
43
- 'exists', 'stat', 'lstat', 'readdir', 'access', 'realpath',
44
- 'mkdirSync', 'rmdirSync', 'mkdir', 'rmdir',
45
- ]);
46
-
47
- /** 循环体识别:for/while/do 关键字与数组迭代方法。 */
48
- export const LOOP_KEYWORDS = new Set(['for', 'while', 'do']);
49
- export const LOOP_METHODS = new Set([
50
- 'forEach', 'map', 'filter', 'reduce', 'reduceRight', 'flatMap', 'some', 'every',
51
- 'find', 'findIndex', 'findLast', 'findLastIndex',
52
- ]);
53
-
54
- /** 请求处理路径特征(在函数体内出现任一即认定)。 */
55
- export const REQUEST_PATTERNS = [
56
- /\b(?:req|request)\.(?:headers|method|url|body|on)\b/,
57
- /\bres\.(?:writeHead|write|end|setHeader|statusCode)\b/,
58
- /\b(?:handle|route|onRequest)[A-Za-z_$]*\s*\(/,
59
- /\bcreateServer\s*\(\s*(?:async\s*)?\(?\s*(?:req|request)\s*,/,
60
- /\(\s*(?:req|request)\s*,\s*(?:res|response)\s*\)/,
61
- ];
62
-
63
- /** 风险档位(数值越大越高)。 */
64
- export const LEVELS = ['safe', 'low', 'medium', 'high'];
65
-
66
- /** 徽标。 */
67
- export const RISK_BADGE = { high: '🔴', medium: '🟠', low: '🟡', safe: '🟢' };
68
-
69
- /** 风险中文名。 */
70
- export const RISK_LABEL = { high: '高', medium: '中', low: '低', safe: '安全' };
71
-
72
- /**
73
- * 是否循环头:for/while/do 关键字,或 `.forEach(` / `.map(` 等方法调用。
74
- *
75
- * 方法形态**必须**校验前导 `.`:`LOOP_METHODS` 里的名字(map/find/filter/some/…)
76
- * 同样是极其常见的普通变量名/参数名。早先只做 `LOOP_METHODS.has(value)`
77
- * 而不看前一个 token,导致 `JSON.stringify(map, null, 2)` 里的参数 `map`、
78
- * `const map = new Map()` 里的 `map` 都被当成循环头 —— 实测全仓 1109 个「循环头」
79
- * 里有 44 个是这种裸标识符(4.0%),既凭空造出循环范围(把无关行的 I/O
80
- * 误标成「循环内」),也让真正的循环范围互相干扰。
81
- *
82
- * @param {object} t 当前 token
83
- * @param {object} [prev] 前一个 token;方法调用形态须满足 `prev.value === '.'`
84
- * @returns {boolean}
85
- */
86
- export function isLoopHead(t, prev) {
87
- if (LOOP_KEYWORDS.has(t.value)) return true;
88
- return LOOP_METHODS.has(t.value) && prev?.value === '.';
89
- }
90
-
91
- /** 档位提升 n 级(用于写/删加权)。 */
92
- export function raise(level, n = 1) {
93
- const i = LEVELS.indexOf(level);
94
- return LEVELS[Math.min(LEVELS.length - 1, i + n)];
95
- }
@@ -1,208 +0,0 @@
1
- /**
2
- * dsh-git-push — I/O 风险分级:函数边界识别与 token 配对
3
- *
4
- * 职责:从 token 流里认出函数边界(普通函数 / 箭头函数 / 对象方法简写 / 类方法),
5
- * 以及圆括号、花括号、方括号的前后向配对 —— 上下文判定的公共基础设施。
6
- * 不含「风险等级」概念,只回答「这段代码属于哪个函数体」。
7
- *
8
- * 分层:lib/ast/io-risk.js 的从属模块(由该文件再导出),调用方不应直接 import。
9
- */
10
- import { matchBrace } from './brace.js';
11
-
12
- /**
13
- * 取包含该行的最内层循环范围(含 smallFixed 标记)。
14
- * 嵌套循环时取最内层:内层规模才是单次 I/O 的实际重复次数。
15
- * @returns {Array|null} [起行, 止行, smallFixed]
16
- */
17
- export function enclosingLoop(loops, line) {
18
- let best = null;
19
- for (const entry of loops) {
20
- if (line < entry[0] || line > entry[1]) continue;
21
- if (!best || entry[0] >= best[0]) best = entry;
22
- }
23
- return best;
24
- }
25
-
26
- /** 函数体 '{' 的搜索窗口(token 数):够覆盖 `async function name(a, b, c) {` 这类长签名。 */
27
- export const BODY_SEARCH_TOKENS = 40;
28
- /** 循环体 '{' 的搜索窗口(token 数):够覆盖 `for (const x of someLongExpression) {`。 */
29
- export const LOOP_BODY_SEARCH_TOKENS = 30;
30
- /** 不能作为函数名的关键字:这些后面跟 `(...) {` 时是语句块,不是方法简写。 */
31
- export const FUNCTION_HEAD_EXCLUDE = new Set([
32
- 'for', 'while', 'if', 'else', 'switch', 'do', 'try', 'catch', 'finally',
33
- 'return', 'typeof', 'new', 'delete', 'void', 'in', 'of', 'await', 'yield',
34
- ]);
35
- /** 箭头函数 `=>` 的搜索窗口(token 数):够覆盖 `const f = (a, b) => {`。 */
36
- export const ARROW_SEARCH_TOKENS = 60;
37
- /** 「固定小循环」的元素数上限:字面量数组不超过此值时,循环内同步 I/O 不算高风险。 */
38
- export const SMALL_FIXED_LOOP_MAX = 5;
39
-
40
- /**
41
- * 找函数/循环体的 '{'。
42
- * @returns {number} '{' 的 token 下标;遇 ';' 或超窗口返回 -1
43
- */
44
- export function findBody(tokens, from, window = BODY_SEARCH_TOKENS) {
45
- for (let j = from; j < Math.min(tokens.length, from + window); j++) {
46
- if (tokens[j].type === 'punct' && tokens[j].value === '{') return j;
47
- if (tokens[j].type === 'punct' && tokens[j].value === ';') return -1;
48
- }
49
- return -1;
50
- }
51
-
52
- /**
53
- * 识别 `async` 开头的函数/箭头函数,返回其函数体 '{' 下标。
54
- * 覆盖三种形态:`async function f() {` / `async (...) => {` / `async x => {`
55
- * @returns {number} '{' 下标;无法识别返回 -1
56
- */
57
- export function findAsyncBody(tokens, i) {
58
- const nx = tokens[i + 1];
59
- if (nx && nx.type === 'ident' && nx.value === 'function') return findBody(tokens, i + 2);
60
- for (let j = i + 1; j < Math.min(tokens.length, i + BODY_SEARCH_TOKENS); j++) {
61
- if (tokens[j].type === 'punct' && tokens[j].value === '=>') return findBody(tokens, j + 1);
62
- if (tokens[j].type === 'punct' && tokens[j].value === ';') break;
63
- }
64
- return -1;
65
- }
66
-
67
- /**
68
- * 识别循环体范围。
69
- * 两种收尾形态:① `for (...) {` 花括号配对;② 单语句体 `for (...) x++;`
70
- * @returns {[number, number]|null} [起行, 止行]
71
- */
72
- export function findLoopRange(tokens, i) {
73
- const found = seekLoopBody(tokens, i);
74
- if (!found) return null;
75
- // 单语句循环体:结束行由扫描时确定
76
- const endLine = found.singleStmt ? found.endLine : endLineOf(tokens, matchBrace(tokens, found.brace));
77
- if (endLine === null) return null;
78
- // 起始行取**循环体**而非循环头:
79
- // `for (const line of readFileSync(f).split('\n')) {` 里 readFileSync 只执行一次,
80
- // 若把循环头那一行也算进范围,就会被误报成「循环内 I/O」(实测 repos.js:81)。
81
- // 有花括号体时用 '{' 所在行;单语句体时用语句自身所在行。
82
- const bodyStart = found.singleStmt
83
- ? (tokens[i + 1]?.line ?? tokens[i].line)
84
- : tokens[found.brace].line;
85
- return [Math.max(tokens[i].line, bodyStart), endLine];
86
- }
87
-
88
- /** 花括号配对结果的结束行;配对失败返回 null。 */
89
- export function endLineOf(tokens, range) {
90
- return range ? tokens[range[1]].line : null;
91
- }
92
-
93
- /**
94
- * 从循环关键字找循环体。
95
- * 拆自 findLoopRange(原函数圈复杂度 14,超阈值 10)。
96
- * @returns {{brace:number}|{singleStmt:true,endLine:number}|null}
97
- */
98
- export function seekLoopBody(tokens, i) {
99
- for (let j = i + 1; j < Math.min(tokens.length, i + LOOP_BODY_SEARCH_TOKENS); j++) {
100
- const tj = tokens[j];
101
- if (tj.type === 'punct' && tj.value === '{') return { brace: j };
102
- if (tj.type === 'punct' && tj.value === ';') return null;
103
- if (isSingleStmtLoopClose(tokens, j)) return { singleStmt: true, endLine: tj.line };
104
- }
105
- return null;
106
- }
107
-
108
- /** 单语句循环体(`for (...) x++;`):括号配对完成却没 '{' → 认到该语句结束。 */
109
- export function isSingleStmtLoopClose(tokens, j) {
110
- const tj = tokens[j];
111
- if (tj.type !== 'punct' || tj.value !== ')') return false;
112
- const nextT = tokens[j + 1];
113
- if (!nextT) return false;
114
- return !(nextT.type === 'punct' && nextT.value === '{');
115
- }
116
-
117
- /**
118
- * 识别**同步**函数体:`function f(){}` / `const f = () => {}` / `{ f(){} }` 方法简写。
119
- * async 形态由 classifyFnHead 处理(此处跳过,避免与它重复收录)。
120
- * @returns {[number, number]|null} [起行, 止行]
121
- */
122
- export function classifySyncFnHead(tokens, i, t) {
123
- // `function name(` —— 前面不是 async(async 已在上一分支处理)
124
- if (t.value === 'function') {
125
- const open = findBody(tokens, i + 1);
126
- return rangeOf(tokens, open);
127
- }
128
- // 关键字一律不是函数名:`for (...) {` / `if (...) {` / `while (...) {` 等
129
- // 与「方法简写 name(...) {」在 token 形态上完全同形,不排除会把循环/分支
130
- // 体误收成函数体,进而让其中的 I/O 丢掉 inLoop/inAsync 上下文
131
- // (实测:for 循环被当成方法后 inLoop 恒 false,三条循环用例全挂)。
132
- if (FUNCTION_HEAD_EXCLUDE.has(t.value)) return null;
133
- const next = tokens[i + 1];
134
- if (!next || next.type !== 'punct') return null;
135
- // 方法简写**先判**:`name(...) {` —— '(' 配对后紧跟 '{' 即是方法体。
136
- // 不能先找 `=>`:那样会把 `h(req,res){ ... }` 的方法体一路扫成箭头候选
137
- // (深度归零后继续前进,越过分号,最终撞到外层 '}' 才以 -1 退出),
138
- // 导致对象方法简写的函数体从未被收录(实测 inRequest 漏判)。
139
- if (next.value === '(') {
140
- const brace = findBodyAfterParen(tokens, i + 1);
141
- if (brace !== -1) return rangeOf(tokens, brace);
142
- }
143
- // 箭头函数:`name = (...) => {` / `name: (...) => {`
144
- if (next.value === '=' || next.value === ':') {
145
- const arrow = findArrowBody(tokens, i);
146
- if (arrow !== -1) return rangeOf(tokens, arrow);
147
- }
148
- return null;
149
- }
150
-
151
- /** 花括号配对 → 行范围;open 非法返回 null。 */
152
- export function rangeOf(tokens, open) {
153
- if (open === -1) return null;
154
- const range = matchBrace(tokens, open);
155
- return range ? [tokens[open].line, tokens[range[1]].line] : null;
156
- }
157
-
158
- /** 从标识符起找同一层的 '=>',返回其后函数体 '{' 下标(无则 -1)。 */
159
- export function findArrowBody(tokens, i) {
160
- let depth = 0;
161
- for (let j = i + 1; j < Math.min(tokens.length, i + ARROW_SEARCH_TOKENS); j++) {
162
- const tj = tokens[j];
163
- if (tj.type !== 'punct') continue;
164
- if (tj.value === '(' || tj.value === '[' || tj.value === '{') { depth++; continue; }
165
- if (tj.value === ')' || tj.value === ']' || tj.value === '}') { depth--; if (depth < 0) return -1; continue; }
166
- if (tj.value === ';' && depth === 0) return -1;
167
- if (tj.value === '=>' && depth === 0) return findBody(tokens, j + 1);
168
- }
169
- return -1;
170
- }
171
-
172
- /**
173
- * '(' 配对完成后的 '{'(方法简写);无则 -1。
174
- * 注意 matchBrace 只配对**花括号**,不能拿它配圆括号——否则会从 '(' 位置
175
- * 一路扫到方法体的 '{...}' 并返回方法体本身,`after` 落到体后的 '}' 上,
176
- * 方法简写永远识别不出来(实测对象方法漏判的根因)。
177
- */
178
- export function findBodyAfterParen(tokens, parenIdx) {
179
- const close = matchParen(tokens, parenIdx);
180
- if (close === -1) return -1;
181
- const after = tokens[close + 1];
182
- return after && after.type === 'punct' && after.value === '{' ? close + 1 : -1;
183
- }
184
-
185
- /** 圆括号配对:返回右括号下标;不匹配返回 -1。 */
186
- export function matchParen(tokens, parenIdx) {
187
- let depth = 0;
188
- for (let i = parenIdx; i < tokens.length; i++) {
189
- const t = tokens[i];
190
- if (t.type !== 'punct') continue;
191
- if (t.value === '(') depth++;
192
- else if (t.value === ')') { depth--; if (depth === 0) return i; }
193
- }
194
- return -1;
195
- }
196
-
197
- /**
198
- * 判断 token 是否为 async 函数头,并返回函数体范围。
199
- * 只收 async 函数:同步函数体不参与 inAsync 判定(用它反而是误报来源)。
200
- * @returns {[number, number]|null} [起行, 止行]
201
- */
202
- export function classifyFnHead(tokens, i, t) {
203
- if (t.value !== 'async') return null;
204
- const open = findAsyncBody(tokens, i);
205
- if (open === -1) return null;
206
- const range = matchBrace(tokens, open);
207
- return range ? [tokens[open].line, tokens[range[1]].line] : null;
208
- }