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,93 @@
1
+ /**
2
+ * DSH 客户端入口推导(**中立模块**:供 lib/checks/dispatch.js 与 lib/audit/audit-file.js 共用)。
3
+ *
4
+ * 为什么单独一个文件:`audit-file.js` 依赖 `runChecks`(定义在 `lib/checks/dispatch.js`),
5
+ * 若 `dispatch.js` 反过来从 `audit-file.js` 导入本函数,会形成
6
+ * dispatch → audit-file → checks → dispatch 的**循环依赖**。
7
+ * 把共用函数下沉到中立模块,两边都从它导入,依赖方向单向。
8
+ *
9
+ * 背景:DSH 要求插件的**运行态客户端**是单文件(`package.json` 的 `dsh.client` + `exports["./client"]`
10
+ * 指向同一文件)——那是**构建产物**,不是源码形态。源码可以按分片维护 + 构建拼接
11
+ * (见下方 `resolveDshClientFragments`;本仓库 `lib/client-parts/**` → `lib/client.js`,
12
+ * 由 scripts/build-client.mjs 拼接)。
13
+ * 调用方据此**降级**(仍报、不扣分),而不是静默排除——静默排除会让这个事实从报告里消失。
14
+ *
15
+ * 判据**推导而非写死文件名**:读仓库 `package.json` 的 `exports["./client"]`,兼容三种形态
16
+ * (字符串 / 条件导出对象 / 数组),并回退看 `dsh.client.entry`。换仓库自动生效。
17
+ */
18
+
19
+ import { existsSync, readFileSync } from 'node:fs';
20
+ import { join } from 'node:path';
21
+
22
+ /**
23
+ * 推导仓库里的客户端入口文件(仓库相对路径集合)。
24
+ * @param {string} repoRoot 仓库根目录(绝对路径)
25
+ * @returns {Set<string>} 客户端入口的仓库相对路径集合(无 package.json / 无声明 → 空集)
26
+ */
27
+ export function resolveDshClientEntries(repoRoot) {
28
+ const out = new Set();
29
+ // 空 repoRoot 必须早退:`join('', 'package.json')` = 'package.json' 会命中**当前工作目录**的
30
+ // package.json(调用方忘了传仓库根时,会拿运行目录的声明冒充仓库声明)。
31
+ if (!repoRoot) return out;
32
+ const pkgPath = join(String(repoRoot || ''), 'package.json');
33
+ if (!existsSync(pkgPath)) return out;
34
+ let pkg;
35
+ try {
36
+ pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
37
+ } catch {
38
+ return out; // package.json 损坏 → 按无声明处理(不抛,调用方无需兜底)
39
+ }
40
+ const pick = (v) => {
41
+ if (typeof v === 'string') return v;
42
+ if (Array.isArray(v)) return v.map(pick).find(Boolean) || '';
43
+ if (v && typeof v === 'object') {
44
+ for (const k of ['import', 'default', 'require']) if (v[k]) return pick(v[k]);
45
+ return Object.values(v).map(pick).find(Boolean) || '';
46
+ }
47
+ return '';
48
+ };
49
+ const target = pick(pkg.exports && pkg.exports['./client'])
50
+ || pick(pkg.dsh && pkg.dsh.client && pkg.dsh.client.entry);
51
+ const rel = String(target || '').replace(/^\.\//, '').replace(/\\/g, '/');
52
+ if (rel) out.add(rel);
53
+ return out;
54
+ }
55
+
56
+ /**
57
+ * 推导仓库里的**客户端分片目录**(C8:分片源码 + 拼接产物 的写法)。
58
+ *
59
+ * 为什么不是「不可拆分」:DSH 要求的是**运行态客户端**是单文件(`dsh.client` + `exports["./client"]`
60
+ * 指向同一文件)——那是**构建产物**;源码完全可以按分片维护、由构建脚本拼接成那个单文件
61
+ * (本仓库:`lib/client-parts/**` → `lib/client.js`,见 scripts/build-client.mjs)。
62
+ * 于是分片目录里的文件是**片段**:单文件语法不成立、行数天然可能超阈值,
63
+ * 需要单独一档作用域(`dsh-client-fragment`)按片段定级,而不是靠「不可拆分」把整类问题挡掉。
64
+ *
65
+ * 判据推导而非写死:① 优先读 `package.json` 的 `dsh.client.fragments`(字符串或数组);
66
+ * ② 未显式声明时按**入口同目录 + `<入口名去扩展>-parts/`** 约定推导(`lib/client.js` → `lib/client-parts/`)。
67
+ * @param {string} repoRoot 仓库根目录(绝对路径)
68
+ * @returns {Set<string>} 分片目录的仓库相对路径前缀集合(目录以 `/` 结尾,供 startsWith 匹配)
69
+ */
70
+ export function resolveDshClientFragments(repoRoot) {
71
+ const out = new Set();
72
+ if (!repoRoot) return out; // 同 resolveDshClientEntries:空根会让相对 package.json 命中工作目录
73
+ const pkgPath = join(String(repoRoot || ''), 'package.json');
74
+ if (!existsSync(pkgPath)) return out;
75
+ let pkg;
76
+ try {
77
+ pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
78
+ } catch {
79
+ return out;
80
+ }
81
+ const decl = pkg.dsh && pkg.dsh.client && pkg.dsh.client.fragments;
82
+ const list = Array.isArray(decl) ? decl : (typeof decl === 'string' ? [decl] : []);
83
+ for (const d of list) {
84
+ const rel = String(d || '').replace(/^\.\//, '').replace(/\\/g, '/').replace(/\/*$/, '/');
85
+ if (rel && rel !== '/') out.add(rel);
86
+ }
87
+ if (out.size) return out;
88
+ for (const entry of resolveDshClientEntries(repoRoot)) {
89
+ const m = /^(.*\/)?([^/]+)\.js$/.exec(entry);
90
+ if (m) out.add(`${m[1] || ''}${m[2]}-parts/`);
91
+ }
92
+ return out;
93
+ }
@@ -0,0 +1,477 @@
1
+ /**
2
+ * dsh-git-push 审计总入口:文件收集(gitignore 感知)
3
+ *
4
+ * 修 P0 教训:git 忽略文件默认排除(listTextFiles 支持 git check-ignore)。
5
+ * - gitIgnoreRoot 为 git 仓库:git check-ignore --stdin 批量判定(Map 缓存)
6
+ * - 非 git 目录:全量收集不报错
7
+ */
8
+ import { readdirSync, statSync, existsSync, readFileSync } from 'node:fs';
9
+ import { readdir, stat } from 'node:fs/promises';
10
+ import { join, relative, extname, sep } from 'node:path';
11
+ import { execFileSync, spawnSync } from 'node:child_process';
12
+ import { isTestExemptDir } from '../exempt/index.js';
13
+ import { SKIP_DIRS as HARDCODED_SKIP, getSkipSet } from '../skip-dirs.js';
14
+ import { parseGitignore, isIgnoredByRules } from './gitignore-match.js';
15
+
16
+ /** 跳过目录集合 = 硬编码基线(node_modules/.git) ∪ yml 黑名单关键词(加载一次缓存)。 */
17
+ const SKIP_DIRS = getSkipSet();
18
+
19
+ const TEXT_EXT = new Set([
20
+ 'js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx', 'json', 'yml', 'yaml', 'md', 'txt', 'html', 'css',
21
+ 'sh', 'py', 'rb', 'go', 'rs', 'java', 'c', 'cpp', 'h', 'hpp', 'xml', 'toml', 'ini', 'cfg',
22
+ 'conf', 'env', 'gitignore', 'npmrc', 'properties', 'sql', 'vue', 'svelte',
23
+ ]);
24
+ /** git 探活 / 忽略清单批量判定 / 单目录判定 的超时(毫秒)。 */
25
+ const GIT_PROBE_TIMEOUT_MS = 10_000;
26
+ const IGNORE_BATCH_TIMEOUT_MS = 60_000;
27
+ const IGNORE_SINGLE_TIMEOUT_MS = 5_000;
28
+ /** git 命令统一前缀:禁路径转义(中文/空格文件名按原样匹配),5 处共用防抄写不一致。 */
29
+ const GIT_QUOTEPATH_ARGS = ['-c', 'core.quotepath=false'];
30
+ /** 单文件大小上限:超过 1MB 的文件跳过(防止读入大文件拖死扫描进程)。 */
31
+ const MAX_FILE_SIZE = 1024 * 1024;
32
+
33
+ /** git 忽略文件集合缓存(按 repo 根缓存:git 目录存忽略集,非 git 目录存 null)。 */
34
+ const ignoreCache = new Map();
35
+
36
+ /**
37
+ * 非 git 目录忽略文件的**读取缓存**:键 = 忽略文件绝对路径。
38
+ *
39
+ * 为什么需要:插件请求路径上每次收集都会读 `.gitignore` / `.auditignore`,
40
+ * 原先每处都是 `existsSync + readFileSync` 两次同步系统调用(审计 robustness/io-risk
41
+ * 命中「请求处理路径上的 I/O」)。进程内一次审计里忽略文件不会变,缓存即可;
42
+ * CLI / 工具每次审计都是新进程,因此不存在跨次陈旧问题。
43
+ * @param {string} p 忽略文件绝对路径
44
+ * @returns {string|null} 文件内容;不存在或读失败返回 null
45
+ */
46
+ const ignoreFileTextCache = new Map();
47
+ function readIgnoreFileCached(p) {
48
+ if (ignoreFileTextCache.has(p)) return ignoreFileTextCache.get(p);
49
+ let out = null;
50
+ try { if (existsSync(p)) out = readFileSync(p, 'utf8'); } catch { out = null; }
51
+ ignoreFileTextCache.set(p, out);
52
+ return out;
53
+ }
54
+ /** git 工作树探活缓存(与 ignoreCache 分开:后者存忽略集,可为 null)。 */
55
+ const gitProbeCache = new Map();
56
+
57
+ /**
58
+ * 该目录是否 git 工作树(带缓存,避免与 tryLoadGitIgnoreSet 重复 spawn)。
59
+ *
60
+ * 为什么要单独探活:`collectTextFiles` 的文件级豁免需要区分「git 仓库」与「非 git 兜底」,
61
+ * 而 `gitIgnoreRoot` 在两者下都非空(非 git 但有 .auditignore 时也传 root)。
62
+ * 探活结果按目录缓存;失败(git 不可用)按非 git 处理,即走兜底——兜底总是可用的。
63
+ * @param {string} dir
64
+ * @returns {boolean}
65
+ */
66
+ function isGitWorkTree(dir) {
67
+ if (gitProbeCache.has(dir)) return gitProbeCache.get(dir);
68
+ let ok = false;
69
+ try {
70
+ const r = spawnSync('git', [...GIT_QUOTEPATH_ARGS, '-C', dir, 'rev-parse', '--is-inside-work-tree'], {
71
+ encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: GIT_PROBE_TIMEOUT_MS,
72
+ });
73
+ ok = r.status === 0 && String(r.stdout || '').trim() === 'true';
74
+ } catch { ok = false; }
75
+ gitProbeCache.set(dir, ok);
76
+ return ok;
77
+ }
78
+
79
+ /**
80
+ * 非 git 目录下用纯 JS 匹配 `.auditignore`,产出与 git 路径同构的「被忽略目录集」。
81
+ *
82
+ * 为什么要预计算目录集而非逐文件判定:`collectTextFiles` 的 walk 阶段用该集合做
83
+ * **目录级剪枝**(命中即整棵跳过),与 git 路径保持同一调用契约;逐文件判定会退化成
84
+ * 全量遍历后再过滤,在大目录上明显更慢。
85
+ *
86
+ * 返回的 Set 同时含「被忽略的目录」与其下**任意层级的后代目录**吗?不含——下游
87
+ * walk 是逐目录判定的,父目录命中即整棵跳过,因此只需把命中的目录本身放进集合。
88
+ * 但 `collectTextFiles` 的文件级兜底会再逐文件判定一次(见该函数),两处互补。
89
+ *
90
+ * @param {string} root 扫描根目录(非 git)
91
+ * @returns {Set<string>|null} 被忽略的目录相对路径集合;无 .auditignore 时返回 null
92
+ */
93
+ function tryLoadAuditIgnoreFallback(root, respectAuditIgnore = true) {
94
+ // 非 git 目录的忽略信息来自**目录里的文件本身**:
95
+ // `.gitignore` **永远生效**——它是仓库自带的忽略声明,与是否 `git init` 无关
96
+ // (解压的源码包 / 临时导出目录 / 未 init 的工程同样带它)。
97
+ // 实测 bug:非 git 目录下 `.gitignore` 被完全无视 ⇒ 被忽略的 `ignored/secret.js`
98
+ // 照样进审计并报 3 条(默认与 `--include-ignored` 结果一模一样)。
99
+ // `.auditignore` 只在 respectAuditIgnore 时叠加(审计豁免语义,见下方 git 分支注释)。
100
+ const gitIgnorePath = join(root, '.gitignore');
101
+ const auditIgnorePath = join(root, '.auditignore');
102
+ const parts = [];
103
+ const gitSrc = readIgnoreFileCached(gitIgnorePath);
104
+ if (gitSrc !== null) parts.push(gitSrc);
105
+ if (respectAuditIgnore) {
106
+ const auditSrc = readIgnoreFileCached(auditIgnorePath);
107
+ if (auditSrc !== null) parts.push(auditSrc);
108
+ }
109
+ if (!parts.length) return null;
110
+ let rules;
111
+ try {
112
+ rules = parseGitignore(parts.join('\n'));
113
+ } catch {
114
+ return null;
115
+ }
116
+ if (!rules.length) return null;
117
+ const ignored = new Set();
118
+ /**
119
+ * 处理一个目录项(抽出以降低 walkDirs 的嵌套深度;读起来是「目录→剪枝/递归、文件→判规则」两件事)。
120
+ * 注意 walkDirs 在下方定义:两者同作用域,调用发生在定义之后,闭包取值安全。
121
+ */
122
+ const handleEntry = (dir, en) => {
123
+ // 与 git 路径一致:枚举阶段只用硬编码基线跳过(yml 黑名单在此跳过会让白名单恢复失效)
124
+ if (HARDCODED_SKIP.has(en.name)) return;
125
+ const rel = dir ? `${dir}/${en.name}` : en.name;
126
+ if (en.isDirectory()) {
127
+ if (isIgnoredByRules(rules, rel, true)) { ignored.add(rel); return; } // 命中即整棵剪枝
128
+ walkDirs(rel);
129
+ return;
130
+ }
131
+ // **文件级规则**也要收(*.sh / lib/client.js 这类):原来这里 `if (!en.isDirectory()) continue;`
132
+ // 直接跳过文件 ⇒ 文件级 .auditignore 规则在非 git 目录下永远不生效
133
+ // (实测 test-gitignore-match 的端到端用例失败:非 git 下 *.sh 未被豁免)。
134
+ if (isIgnoredByRules(rules, rel, false)) ignored.add(rel);
135
+ };
136
+ const walkDirs = (dir) => {
137
+ let entries;
138
+ try { entries = readdirSync(join(root, dir), { withFileTypes: true }); } catch { return; }
139
+ for (const en of entries) handleEntry(dir, en);
140
+ };
141
+ walkDirs('');
142
+ return ignored;
143
+ }
144
+
145
+ /**
146
+ * 收集 git 忽略文件相对路径集合(git check-ignore --stdin 批量判定)。
147
+ * 修复 1.0.4 缺陷:原实现以空 stdin 调用 check-ignore,从未传入文件路径 → 忽略集恒空 → gitignore 感知失效
148
+ * (被忽略文件全被扫入,大仓库性能爆炸 + 私密文件误入)。按 full-scan 语义正确实现:
149
+ * 1) git rev-parse 探活(非 git 目录返回 null = 不启用忽略判定)
150
+ * 2) 递归收集全部文件相对路径,一次性喂给 check-ignore --stdin(尊重 .gitignore 全部语法含 negation)
151
+ * 3) 输出 = 被忽略的路径集合;按 repo 根缓存,避免递归重复 spawn
152
+ * @param {string} root git 仓库根目录
153
+ * @returns {Set<string>|null} 被忽略路径集合;非 git 目录/失败返回 null
154
+ */
155
+ function tryLoadGitIgnoreSet(root, respectAuditIgnore = true) {
156
+ // 缓存键要带上开关:否则「尊重 .auditignore」与「不尊重」两次调用会互相污染
157
+ const cacheKey = `${root}|${respectAuditIgnore}`;
158
+ if (ignoreCache.has(cacheKey)) return ignoreCache.get(cacheKey);
159
+ let ignoreSet = null;
160
+ try {
161
+ const probe = spawnSync('git', [...GIT_QUOTEPATH_ARGS, '-C', root, 'rev-parse', '--is-inside-work-tree'], {
162
+ encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: GIT_PROBE_TIMEOUT_MS,
163
+ });
164
+ if (probe.status !== 0 || String(probe.stdout || '').trim() !== 'true') {
165
+ // 非 git 目录的 `.auditignore` 兜底。原先此处直接返回 null,
166
+ // 导致 `.auditignore` 仅在 git 仓库生效——同一个 `*.sh` 规则在 git init 前后行为相反,
167
+ // 解压的源码包/临时导出目录/未 init 的工程里该文件形同不存在(实测确认)。
168
+ // 改为用纯 JS 匹配器(lib/audit/gitignore-match.js)解析 `.auditignore`,
169
+ // 按**目录**预计算忽略集,与 git 路径返回同构的 Set,下游无感知。
170
+ // 非 git 目录只有 `.auditignore` 可用:调用方要求「不尊重审计豁免」时直接返回空集
171
+ // (架构事实提取走这条——它要的是「仓库里有什么代码」,不是「审计扫哪些」)
172
+ if (!respectAuditIgnore) { ignoreCache.set(cacheKey, null); return null; }
173
+ const fallback = tryLoadAuditIgnoreFallback(root, respectAuditIgnore);
174
+ ignoreCache.set(cacheKey, fallback);
175
+ return fallback;
176
+ }
177
+ // `.auditignore` 审计豁免文件(复用 .gitignore 解析方式)——根目录存在该文件时,
178
+ // 把它作为 git core.excludesFile 追加进 check-ignore 判定(与 .gitignore 叠加生效;
179
+ // 实测 .gitignore 的 node_modules/ 与 .auditignore 的 generated/ 同时被忽略)。
180
+ // 语法 = gitignore 语法(目录规则 generated/ 整棵豁免、`*.lock` 文件豁免、`!` 白名单恢复)。
181
+ const auditIgnorePath = join(root, '.auditignore');
182
+ // 开关:`respectAuditIgnore=false` 时**不叠加** `.auditignore`(架构事实提取用)——
183
+ // 审计豁免的语义是「别对它报误报」,不是「它不是代码」;实测把它当排除项会让
184
+ // adapters/KToolBox-webui.js 这类被豁免的文件整片从架构图里消失。
185
+ const hasAuditIgnore = respectAuditIgnore && existsSync(auditIgnorePath);
186
+ const ignoreExtraArgs = hasAuditIgnore ? ['-c', `core.excludesFile=${auditIgnorePath}`] : [];
187
+ // 修复(大仓库忽略失效):原实现枚举**全部文件**路径喂 check-ignore——大仓
188
+ // (如 DeepSeekHarness-NAS 9.9 万个文件)输入过大导致 spawnSync 超时被 SIGTERM,status=null
189
+ // 时仍用**残缺的 stdout** 构造忽略集合 → 忽略集不完整 → 被 .gitignore 忽略的 src/ 等
190
+ // 整棵子树漏进审计(用户看到「全量扫描有 /src」)。
191
+ // 改为:① 只枚举**目录**(数量少一个量级)② 逐个目录用 check-ignore -q 判定
192
+ // ③ 命中即整棵跳过;文件级再兜一次判定,保证「子文件夹也忽略」。
193
+ const ignoredDirs = new Set();
194
+ const allDirs = [];
195
+ const allFiles = [];
196
+ const walkDirs = (dir) => {
197
+ let es;
198
+ try { es = readdirSync(join(root, dir), { withFileTypes: true }); } catch { return; }
199
+ for (const en of es) {
200
+ // 枚举忽略集时只用**硬编码基线**(node_modules/.git):yml 黑名单(build 等)不能在此跳过——
201
+ // 否则 build/keep(白名单恢复)与 build/drop(真黑名单)都不会被枚举,gitignore 判定全错。
202
+ if (HARDCODED_SKIP.has(en.name)) continue;
203
+ const rel = join(dir, en.name).split(sep).join('/');
204
+ if (en.isDirectory()) {
205
+ allDirs.push(rel);
206
+ walkDirs(join(dir, en.name));
207
+ } else {
208
+ allFiles.push(rel);
209
+ }
210
+ }
211
+ };
212
+ walkDirs('');
213
+ // 批量判定:一次 check-ignore --stdin 喂**目录 + 文件**。
214
+ // 原来只喂目录 ⇒ 集合里只有「被忽略的目录」⇒ **文件级规则**(lib/client.js、*.log 这类)永远命中不了,
215
+ // 于是下游又加了一层「事后过滤」去补,而两层参数还不一致(一个有 --no-index 一个没有)
216
+ // ⇒ 行为互相掩盖。这是本文件「四层忽略补丁」的结构性根源,故在此一次喂全、只做一次判定。
217
+ // 直接拼成 stdin 文本,避免 [...allDirs, ...allFiles] 把两个大数组各复制一遍
218
+ // (性能规则 performance/memory-bomb 命中「展开多个大数组会一次性创建新数组」;
219
+ // 拼接结果与 spread + join('\n') 逐字节等价,大仓库下少一次整表复制)
220
+ const totalPaths = allDirs.length + allFiles.length;
221
+ const stdinPaths = totalPaths
222
+ ? (allDirs.length && allFiles.length
223
+ ? `${allDirs.join('\n')}\n${allFiles.join('\n')}`
224
+ : (allDirs.length ? allDirs.join('\n') : allFiles.join('\n')))
225
+ : '';
226
+ if (totalPaths) {
227
+ const r = spawnSync('git', [...GIT_QUOTEPATH_ARGS, '-C', root, ...ignoreExtraArgs, 'check-ignore', '--stdin', '--no-index'], {
228
+ input: stdinPaths, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: IGNORE_BATCH_TIMEOUT_MS,
229
+ });
230
+ // status 为 null(超时/被杀)时**不采信残缺输出**:保守视为无忽略信息,避免「漏忽略」
231
+ if (r.status === 0 || r.status === 1) {
232
+ for (const line of String(r.stdout || '').split('\n')) {
233
+ const t = line.trim().replace(/\/+$/, '');
234
+ if (t) ignoredDirs.add(t);
235
+ }
236
+ } else {
237
+ // 兜底:批量失败则逐个目录判定(只在异常路径触发,保证正确性优先)
238
+ for (const dirRel of allDirs) {
239
+ const probeResult = spawnSync('git', [...GIT_QUOTEPATH_ARGS, '-C', root, ...ignoreExtraArgs, 'check-ignore', '-q', '--', dirRel], {
240
+ encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: IGNORE_SINGLE_TIMEOUT_MS,
241
+ });
242
+ if (probeResult.status === 0) ignoredDirs.add(dirRel);
243
+ }
244
+ }
245
+ }
246
+ ignoreSet = ignoredDirs;
247
+ } catch {
248
+ ignoreSet = null;
249
+ }
250
+ ignoreCache.set(cacheKey, ignoreSet);
251
+ return ignoreSet;
252
+ }
253
+
254
+ /**
255
+ * 递归收集文本文件。
256
+ * @param {string} dir 扫描目录
257
+ * @param {object} opts { depth, gitIgnoreRoot, includeIgnored }
258
+ * @returns {Array<{path, ext, full}>}
259
+ */
260
+ /** 目录是否硬编码基线跳过(node_modules/.git——机器依赖/内部元数据,恒不进审计)。 */
261
+ function isHardSkipped(name) {
262
+ return HARDCODED_SKIP.has(name);
263
+ }
264
+
265
+ /** gitignore 判定:目录/文件是否在忽略集内(includeIgnored 或非 git 根时 false)。 */
266
+ function computeGitIgnored(full, gitIgnoreRoot, includeIgnored, respectAuditIgnore = true) {
267
+ if (includeIgnored || !gitIgnoreRoot) return false;
268
+ const relDir = relative(gitIgnoreRoot, full).replace(/\\/g, '/');
269
+ const igSet = tryLoadGitIgnoreSet(gitIgnoreRoot, respectAuditIgnore);
270
+ return !!(igSet && igSet.has(relDir));
271
+ }
272
+
273
+ /** yml 黑名单目录是否跳过:命中且 git 未忽略(白名单恢复)→ 保留(false);否则跳过(true)。 */
274
+ function shouldSkipDirByYml(name, ignoredByGit, gitIgnoreRoot) {
275
+ if (!SKIP_DIRS.has(name)) return false;
276
+ // 黑名单命中:git 仓库里未被 gitignore 忽略(白名单恢复)→ 保留;否则跳过
277
+ return !(gitIgnoreRoot && !ignoredByGit);
278
+ }
279
+
280
+ /** 文件级 gitignore 兜底:父目录在忽略集内 → 跳过(防「直接以被忽略目录为扫描根」边界)。 */
281
+ function isFileGitIgnored(full, gitIgnoreRoot, includeIgnored, respectAuditIgnore = true) {
282
+ if (includeIgnored || !gitIgnoreRoot) return false;
283
+ const rel = relative(gitIgnoreRoot, full).replace(/\\/g, '/');
284
+ const set = tryLoadGitIgnoreSet(gitIgnoreRoot, respectAuditIgnore);
285
+ if (!set) return false;
286
+ if (set.has(rel)) return true;
287
+ const seg = rel.split('/');
288
+ for (let i = seg.length - 1; i > 0; i -= 1) {
289
+ if (set.has(seg.slice(0, i).join('/'))) return true;
290
+ }
291
+ return false;
292
+ }
293
+
294
+ export async function collectTextFiles(dir, { depth = 10, gitIgnoreRoot = null, includeIgnored = false, testExemptRoot = null, respectAuditIgnore = true } = {}) {
295
+ const out = [];
296
+ await walk(dir, 0);
297
+ // `.auditignore` **文件级**豁免(目录级已在 walk 剪枝)——收集完成后把
298
+ // 已收集的文件路径批量喂 check-ignore(带 core.excludesFile 追加 .auditignore),
299
+ // 命中 `src/vendor.js` / `*.lock` 等文件级规则即剔除(收集到的文本文件数少,一次 spawn 可接受)。
300
+ // 目录规则(generated/)已由 tryLoadGitIgnoreSet 的目录集整棵跳过,此处只补文件级。
301
+ // 修复(theme 全量审计漏忽略):文件级判定门控从「存在 .auditignore」放宽为
302
+ // 「git 仓库」——.gitignore 的**文件级规则**(lib/client.js / *.log / 任务.md)目录级剪枝
303
+ // 覆盖不到,此前仅在 .auditignore 存在时补判,普通 .gitignore 的文件规则全部漏进审计
304
+ // (实测 theme 的 lib/client.js 构建产物与任务.md 被扫入)。git 路径下无条件批量
305
+ // check-ignore(有 .auditignore 则追加为 core.excludesFile,与 .gitignore 叠加);
306
+ // 非 git 且无 .auditignore 时无忽略信息(tryLoadGitIgnoreSet=null)保持跳过。
307
+ // 「事后过滤」层已删除(重新设计第 2 步)。
308
+ // 它的职责(补**文件级** .gitignore/.auditignore 规则)已并入**建集阶段**:建集现在同时喂
309
+ // 目录与文件、并统一带 `--no-index`,一次判定即覆盖目录与文件两级规则。
310
+ // 留着它会出现「两层参数不同、行为互相掩盖」——实测 adapters/KToolBox-webui.js 长期被莫名剔除,
311
+ // 排查了 6 轮才定位到是这两层在打架。忽略策略今后由 `ignorePolicy` 参数**显式表达**,
312
+ // 不再散落在 includeIgnored / respectAuditIgnore 等多处 flag 上。
313
+ return out;
314
+
315
+ // 递归遍历改异步:大仓库上逐目录 readdirSync + 逐项 statSync 会阻塞事件循环
316
+ async function walk(cur, level) {
317
+ if (level > depth) return;
318
+ // .test 空文件豁免(1.0.5):整目录扫描跳过(含子目录),专为测试 fixture 目录设计
319
+ if (testExemptRoot && cur !== testExemptRoot && isTestExemptDir(testExemptRoot, relative(testExemptRoot, cur))) return;
320
+ let entries;
321
+ try { entries = await readdir(cur); } catch { return; }
322
+ for (const name of entries) {
323
+ const full = join(cur, name);
324
+ let st;
325
+ try { st = await stat(full); } catch { continue; }
326
+ if (st.isDirectory()) {
327
+ // 「黑名单初筛 + 白名单补充」:
328
+ // 1) 硬编码基线(node_modules/.git)**绝对跳过**——机器依赖/内部元数据目录,
329
+ // 不受 gitignore 白名单影响(npm 包树里 node_modules 恒不该进审计)。
330
+ // 2) yml 黑名单关键词(build/dist 等)候选跳过;若 gitignore 判定该目录**未忽略**
331
+ // (被 ! 白名单恢复,如 server/project/* + !blueprint/、/build/* + !/build/keep/),
332
+ // 则保留进入——黑名单不能压过 gitignore 白名单。
333
+ if (isHardSkipped(name)) continue;
334
+ let ignoredByGit = computeGitIgnored(full, gitIgnoreRoot, includeIgnored, respectAuditIgnore);
335
+ if (shouldSkipDirByYml(name, ignoredByGit, gitIgnoreRoot)) continue;
336
+ // 非黑名单目录:被 gitignore 忽略 → 整棵跳过(原逻辑)
337
+ if (ignoredByGit) continue;
338
+ await walk(full, level + 1);
339
+ continue;
340
+ }
341
+ if (!st.isFile()) continue;
342
+ // 1MB 上限:超大文件(会话归档/大 JSON/二进制伪装文本)跳过,防读入拖死进程
343
+ if (st.size > MAX_FILE_SIZE) continue;
344
+ const ext = extname(full).replace(/^\./, '');
345
+ const isText = name.endsWith('.gitignore') || name.endsWith('.npmrc') || TEXT_EXT.has(ext);
346
+ if (!isText) continue;
347
+ // gitignore 感知(文件级兜底):父目录若在忽略集内也应跳过(目录遍历已整棵跳过,
348
+ // 此处兜住「直接以被忽略目录为扫描根」等边界)
349
+ if (isFileGitIgnored(full, gitIgnoreRoot, includeIgnored, respectAuditIgnore)) continue;
350
+ out.push({ path: relative(dir, full).replace(/\\/g, '/'), ext, full });
351
+ }
352
+ }
353
+ }
354
+
355
+ /** 判断目录是否为 git 仓库(有 .git)。 */
356
+ export function isGitRepo(dir) {
357
+ return existsSync(join(dir, '.git')) || existsSync(join(dir, '.git', 'HEAD'));
358
+ }
359
+
360
+ /**
361
+ * 收集 git 仓库工作区变动文件(git status --porcelain)。
362
+ * @param {string} repoPath git 仓库目录
363
+ * @returns {Array<{rel, full, status}>|null} 非 git 仓库或 git 失败返回 null(调用方退化为 full)
364
+ * status:A=新增 M=修改 D=删除 R=重命名 ??=未跟踪
365
+ */
366
+ export function collectChangedFiles(repoPath) {
367
+ if (!isGitRepo(repoPath)) return null;
368
+ try {
369
+ // 显式捕获 stderr(execFileSync 未设 stdio 时异常会把 git stderr 直通父进程)
370
+ const out = execFileSync('git', ['-C', repoPath, 'status', '--porcelain'], {
371
+ encoding: 'utf8', timeout: GIT_PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'pipe'],
372
+ });
373
+ const files = [];
374
+ for (const line of out.split('\n')) {
375
+ if (!line.trim()) continue;
376
+ const status = line.slice(0, 2).trim() || 'M';
377
+ let rel = line.slice(3);
378
+ // 引号包裹(含空格/非 ASCII):取引号内内容(不处理 \ooo 转义,中文文件名原样)
379
+ const quoted = rel.match(/^"((?:[^"\\]|\\.)*)"/);
380
+ if (quoted) rel = quoted[1].replace(/\\([\\"])/g, '$1');
381
+ else if (rel.includes(' -> ')) rel = rel.split(' -> ').pop(); // 重命名取新路径
382
+ if (!rel) continue;
383
+ // 未跟踪目录(?? dir/):git status --porcelain 只显示目录本身,需展开为目录内文件,
384
+ // 否则审计漏掉整目录(对齐 getDiff 用 git ls-files --others 展开的行为)。
385
+ if (status === '??' && rel.endsWith('/')) {
386
+ const inside = execFileSync('git', ['-C', repoPath, 'ls-files', '--others', '--exclude-standard', '--', rel], {
387
+ encoding: 'utf8', timeout: GIT_PROBE_TIMEOUT_MS,
388
+ });
389
+ for (const p of inside.split('\n').filter(Boolean)) {
390
+ files.push({ rel: p, full: join(repoPath, p), status });
391
+ }
392
+ continue;
393
+ }
394
+ files.push({ rel, full: join(repoPath, rel), status });
395
+ }
396
+ // .test 空文件目录豁免对 changed 审计同样生效——与全仓收集
397
+ // (collectTextFiles testExemptRoot)对齐:test fixture 目录(故意构造的坏样本)
398
+ // 在 diff 审计里也应完全跳过,否则「改过 test 文件 → 整个文件进 changed 范围 →
399
+ // 黑名单词样本/超长函数样本被扫出」误拦提交。
400
+ const kept = files.filter((f) => !isTestExemptDir(repoPath, f.rel));
401
+ // `.auditignore` 同样要作用于**变动模式**:此前它只在全仓收集(collectTextFiles)里生效,
402
+ // 于是「要入库但不该被自家规则审」的文件(生成的 HTML、内置 vendor 代码、手写 DOM 的 client.js)
403
+ // 一旦被改动就进 changed 范围并被自家规则拦下提交——实测 test-audit-bad-file 因此转红。
404
+ // 做法与全仓收集完全一致:把已收集路径批量喂 check-ignore(有 .auditignore 则追加为 excludesFile)。
405
+ const auditIgnorePath = join(repoPath, '.auditignore');
406
+ if (!existsSync(auditIgnorePath) || !kept.length) return kept;
407
+ try {
408
+ const r = spawnSync(
409
+ 'git',
410
+ [...GIT_QUOTEPATH_ARGS, '-C', repoPath, '-c', `core.excludesFile=${auditIgnorePath}`,
411
+ 'check-ignore', '--stdin', '--no-index'],
412
+ { input: kept.map((f) => f.rel).join('\n'), encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: IGNORE_BATCH_TIMEOUT_MS },
413
+ );
414
+ if (r.status === 0 || r.status === 1) {
415
+ const ignored = new Set(String(r.stdout || '').split('\n').filter(Boolean));
416
+ return kept.filter((f) => !ignored.has(f.rel));
417
+ }
418
+ } catch { /* 判定失败保留原结果 */ }
419
+ return kept;
420
+ } catch {
421
+ return null; // git 不可用 → 调用方退化为 full
422
+ }
423
+ }
424
+
425
+ /** 判定是否为文本文件(TEXT_EXT 白名单 + 1MB 上限;png/jpg 等二进制扩展名 → false)。 */
426
+ export function isTextFile(full) {
427
+ try {
428
+ const st = statSync(full);
429
+ if (st.size > MAX_FILE_SIZE) return false;
430
+ } catch { return false; }
431
+ const ext = extname(full).replace(/^\./, '');
432
+ const base = full.split('/').pop() || '';
433
+ // bugfix:点文件(.env/.env.local 等)extname 对它们取的是最后一段
434
+ // (.env.local → '.local'),触发 ext 白名单匹配错误;同时 .tmp-x.js 这类
435
+ // 「点开头但带真实扩展名」的文件不能误伤(extname 已能取到 .js)。
436
+ // 判定顺序:①extname 有合法扩展名且命中白名单 → true(.tmp-x.js / .foo.yaml)
437
+ // ②extname 为空或未命中 → 点文件取「去首点后第一段」(.env → env;.env.local → env)
438
+ // ③仍不中 → false。
439
+ const extHit = TEXT_EXT.has(ext);
440
+ const effExt = extHit
441
+ ? ext
442
+ : (base.startsWith('.') ? base.slice(1).split('.')[0] : '');
443
+ return base.endsWith('.gitignore') || base.endsWith('.npmrc') || TEXT_EXT.has(effExt);
444
+ }
445
+
446
+ /* ───────── 审计期间的文本读取缓存(性能优化,2026-10-09) ─────────
447
+ * 为什么:全量审计的 fs 画像实测 `readFileSync` **1659 次 / 252 文件 ≈ 6.6×** ✗ ——
448
+ * 同一个文件会在收集、逐文件审计、覆盖率统计等多处被反复读,而 `readText` 是审计路径的统一读入口。
449
+ * 正确性设计:缓存条目带 **size + mtimeMs 指纹**,每次命中前 statSync 复核 ⇒ 文件被改动自动失效,
450
+ * 既不需要调用方维护"何时清缓存"(易漏),也不可能读到旧内容(比"每轮开头 clear"的写法安全)。
451
+ * 代价是每次读多一次 statSync(微秒级),换来少一次整文件读取(NAS/CIFS 上差距很大)。
452
+ * 内存:按累计字符数设预算(env DSH_GIT_PUSH_READ_CACHE_BYTES,默认 16MiB),超限整体清空(退化为不缓存)。
453
+ */
454
+ const READ_CACHE = new Map();
455
+ let READ_CACHE_BYTES = 0;
456
+
457
+ /** 清空读取缓存(测试用;正常运行无需调用——指纹复核已保证正确性)。 */
458
+ export function clearReadCache() {
459
+ READ_CACHE.clear();
460
+ READ_CACHE_BYTES = 0;
461
+ }
462
+
463
+ /** 读文件(UTF-8,失败返回 null)。同一文件在指纹未变时不重复落盘读。 */
464
+ export function readText(full) {
465
+ let st;
466
+ try { st = statSync(full); } catch { return null; } // 与原来"读不到返回 null"一致(stat 失败必然也读不到)
467
+ const key = String(full);
468
+ const hit = READ_CACHE.get(key);
469
+ if (hit && hit.size === st.size && hit.mtimeMs === st.mtimeMs) return hit.text;
470
+ let text = null;
471
+ try { text = readFileSync(key, 'utf8'); } catch { return null; }
472
+ const max = Number(process.env.DSH_GIT_PUSH_READ_CACHE_BYTES || 16 * 1024 * 1024) || 16 * 1024 * 1024;
473
+ if (READ_CACHE_BYTES + text.length > max) { READ_CACHE.clear(); READ_CACHE_BYTES = 0; } // 超预算整体清空(只影响性能)
474
+ READ_CACHE.set(key, { size: st.size, mtimeMs: st.mtimeMs, text });
475
+ READ_CACHE_BYTES += text.length;
476
+ return text;
477
+ }
@@ -0,0 +1,80 @@
1
+ /**
2
+ * 审计扩展运行器(独立审计脚本自动接入——统一入口动态加载)
3
+ *
4
+ * 契约:`scripts/audit-ext/` 下的每个 .mjs 脚本导出:
5
+ * export const auditExt = {
6
+ * name: '扩展名', // findings 里 source 标记 `ext:<name>`
7
+ * match: (repo) => true, // 是否适用该仓库(false 跳过)
8
+ * run: async (repo, opts) => [], // 返回 findings 数组 [{file, line, rule, severity, message, dimensions}]
9
+ * };
10
+ *
11
+ * 自动接入:新增审计脚本只需放进 `scripts/audit-ext/` 即被统一入口动态加载——
12
+ * auditFull/auditWithScope 后自动并入 findings;也可 `node scripts/audit-runner.mjs <repo>` 独立跑。
13
+ * 单脚本失败(语法/运行错)try/catch 降级跳过,不中断整体审计。
14
+ */
15
+
16
+ import { readdir } from 'node:fs/promises';
17
+ // resolve / fileURLToPath 随 PLUGIN_ROOT 收口一并移除(原处自行算插件根,现改为从 lib/git/config.js 导入)
18
+ import { join } from 'node:path';
19
+ import { pathToFileURL } from 'node:url';
20
+
21
+ // 插件根:lib/git/config.js 已导出同一值(都指向插件根目录),此处不再自行 resolve
22
+ // (自审 duplicate-constant 报的真重复;两处各算一次,换了目录层级就会不一致)
23
+ import { PLUGIN_ROOT } from '../core/config.js';
24
+ /** 默认扩展目录:插件根 scripts/audit-ext/。 */
25
+ export const DEFAULT_EXT_DIR = join(PLUGIN_ROOT, 'scripts', 'audit-ext');
26
+
27
+ /** 按约定动态加载扩展目录下全部审计扩展脚本。 */
28
+ export async function loadAuditExt(dir = DEFAULT_EXT_DIR) {
29
+ const exts = [];
30
+ let files = [];
31
+ try {
32
+ // 异步版 readdir:本函数已是 async,用同步版会在插件请求路径上阻塞事件循环
33
+ // (审计 robustness/io-risk 高风险「异步路径中的同步 I/O」命中)
34
+ files = (await readdir(dir)).filter((f) => f.endsWith('.mjs') && !f.startsWith('_'));
35
+ } catch {
36
+ return exts; // 目录不存在 → 无扩展
37
+ }
38
+ for (const f of files) {
39
+ try {
40
+ const mod = await import(pathToFileURL(join(dir, f)).href + `?t=${Date.now()}`);
41
+ const ext = mod && (mod.auditExt || mod.default);
42
+ if (ext && typeof ext === 'object' && typeof ext.run === 'function') {
43
+ exts.push({ file: f, name: String(ext.name || f.replace(/\.mjs$/, '')), match: typeof ext.match === 'function' ? ext.match : () => true, run: ext.run });
44
+ }
45
+ } catch (e) {
46
+ // 单脚本加载失败降级跳过(记录,不中断其他扩展)
47
+ console.error(`[audit-ext] 加载失败跳过 ${f}: ${(e && e.message) || e}`);
48
+ }
49
+ }
50
+ return exts;
51
+ }
52
+
53
+ /**
54
+ * 对仓库执行全部适用扩展,聚合 findings。
55
+ * @param {string} repo 仓库路径
56
+ * @param {object} [opts] { dir?: string, log? }
57
+ * @returns {Array} findings(每条带 source: `ext:<name>` 标记)
58
+ */
59
+ export async function runAuditExt(repo, opts = {}) {
60
+ const exts = await loadAuditExt(opts.dir);
61
+ const out = [];
62
+ for (const ext of exts) {
63
+ let applicable = true;
64
+ try {
65
+ applicable = ext.match(repo) !== false;
66
+ } catch { applicable = true; }
67
+ if (!applicable) continue;
68
+ try {
69
+ const res = await ext.run(repo, opts);
70
+ if (Array.isArray(res)) {
71
+ for (const f of res) {
72
+ out.push({ ...f, source: `ext:${ext.name}` });
73
+ }
74
+ }
75
+ } catch (e) {
76
+ opts.log?.warn?.(`审计扩展 ${ext.name} 执行失败跳过:${(e && e.message) || e}`);
77
+ }
78
+ }
79
+ return out;
80
+ }