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,173 @@
1
+ /**
2
+ * 检查层 · 目录级检查
3
+ *
4
+ * 职责:文件夹数量/单目录文件数/解包特征/.gitignore 覆盖等目录级审计。
5
+ * 与文件级检查不同,本模块以目录为输入单位。
6
+ */
7
+
8
+ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
9
+ import { execFileSync } from 'node:child_process';
10
+ import { join, relative } from 'node:path';
11
+ import { globToRegex } from '../audit/glob.js';
12
+ import { parseGitignore, isIgnoredByRules } from '../audit/gitignore-match.js';
13
+ import { makeFinding } from '../audit/index.js';
14
+ import { capSeverity, HINT_SIZE } from './common.js';
15
+
16
+ /**
17
+ * 目录级审计(folder 槽位,1.0.3)。
18
+ * 统计:源码目录总数(排除 excludeDirs)/ 单目录文件数 / 解包特征目录 / .gitignore 覆盖。
19
+ * 由 auditFull 在文件行级检查之外追加调用(目录层规则无法按文件行跑)。
20
+ * @param {object} opts { root, rules, gitignoreText, excludeDirsBase }
21
+ * @returns {Array} findings(每条 file=根目录,line=1)
22
+ */
23
+ export function checkFolderRules({ root, rules, gitignoreText = '' }) {
24
+ const findings = [];
25
+ if (!root) return findings;
26
+
27
+ const isDir = (p) => { try { return statSync(p).isDirectory(); } catch { return false; } };
28
+
29
+ // 排除目录(各规则 exclude_dirs 的并集)——**在遍历时剪枝**,不是收集后按名过滤。
30
+ //
31
+ // 修复的缺陷:原实现先递归收集全部目录、再 `dirs.filter(d => !exclude.has(d.name))`
32
+ // 只按目录**名**过滤,不阻止递归 → 被排除目录的**子目录全被计入源码目录**
33
+ // (实测:树内只有 src、lib 两个真源码目录,却因 node_modules/pkg-a、
34
+ // node_modules/pkg-b/node_modules/nested、dist/sub、coverage/x 等子目录被计入而报 9 个)。
35
+ // 后果:任何带 node_modules 的仓库恒定超阈值 30 → folder/total-count 恒误报。
36
+ // 同理 folder/file-count-per-dir 会把 node_modules 里的大目录当"单目录文件过多"报出。
37
+ const excludedNames = new Set(['.git']);
38
+ for (const r of rules || []) for (const n of r.excludeDirs || []) excludedNames.add(n);
39
+
40
+ // .gitignore 感知(上游克隆/忽略目录误报修复):folder 独立遍历此前
41
+ // 不看 .gitignore——被忽略的目录(如 docs/.probe-ktoolbox 上游 KToolBox 完整克隆,
42
+ // .gitignore 的 docs/* 忽略)被计入 total-count 造成误报(Pawchive 76 目录大头即此)。
43
+ // 现用同 collector 的纯 JS 匹配器(lib/audit/gitignore-match.js):被 gitignore 忽略
44
+ // 的目录不入 dirs、不递归(gitignoreText 缺省空 → 规则不变)。
45
+ const gitignoreRules = gitignoreText ? parseGitignore(gitignoreText) : null;
46
+
47
+ // ── 全量目录/文件统计(一次遍历供多规则复用)──
48
+ const dirCounts = { total: 0, byDir: new Map() }; // 单目录文件数
49
+ const signatureHits = [];
50
+ const dirs = [];
51
+ (function walk(dir) {
52
+ let entries;
53
+ try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
54
+ let fileCount = 0;
55
+ for (const e of entries) {
56
+ // 排除目录:不入 dirs、不递归、文件也不计数(其内容不属于项目源码)
57
+ if (excludedNames.has(e.name)) continue;
58
+ const full = `${dir}/${e.name}`;
59
+ if (e.isDirectory()) {
60
+ // gitignore 忽略目录:跳过(上游克隆/依赖/内部数据目录不是项目源码)
61
+ if (gitignoreRules) {
62
+ const relDir = relative(root, full).replace(/\\/g, '/');
63
+ if (isIgnoredByRules(gitignoreRules, relDir, true)) continue;
64
+ }
65
+ dirs.push({ dir, name: e.name, full }); walk(full);
66
+ } else fileCount++;
67
+ }
68
+ if (fileCount > 0 || dir !== root) dirCounts.byDir.set(dir, fileCount);
69
+ dirCounts.total++;
70
+ })(root);
71
+
72
+ for (const rule of rules || []) {
73
+ const exclude = new Set(rule.excludeDirs || []);
74
+ // 规则 1:源码目录总数 ≤ threshold(排除 excludeDirs)
75
+ if (rule.threshold !== undefined && dirs.length) {
76
+ const sig = rule.id.includes('total-count');
77
+ if (sig) {
78
+ // 包结构目录排除(Java/Kotlin 误报修复):Maven/Gradle 标准源码根
79
+ // src/main/java、src/main/kotlin、src/test/java 之下的目录是**包层级**(每个
80
+ // 包一个目录,如 com/perol/asdpl/pixivez/**),不是「项目源码目录」——Android/
81
+ // Maven 项目天然几十个包目录,total-count 阈值 30 恒误报(防解包产物混入的
82
+ // 本意对包结构不适用)。判定按路径子串:含 /src/(main|test|androidTest)/(java|kotlin)/
83
+ // 前缀的目录全部不计(含其子目录——包目录逐层都在其下)。
84
+ // 工程/资源目录按**名称**过滤:gradle/docs/res/assets 等是构建系统/
85
+ // 文档/资源/CI 配置目录,不是「项目源码目录」。⚠️ 不能进 exclude_dirs——那会被
86
+ // collector 的 SKIP_DIRS 消费导致全局跳过审计(实测回归);只在计数时过滤。
87
+ // res/ 资源**子目录**(res/layout、res/values-xx、res/drawable-xxhdpi 等)按路径
88
+ // 过滤(/res/ 之下是资源不是源码——Android 多语言 values 目录天然十几个)。
89
+ const isPackageDir = (d) => /\/src\/(?:main|test|androidTest)\/(?:java|kotlin)\//.test(d.full)
90
+ || /\/res\//.test(d.full);
91
+ const ENGINE_DIRS = new Set(['gradle', 'wrapper', '.github', 'docs', 'res', 'assets', 'resources', 'help', 'preview', 'donation', '.idea', '.gradle']);
92
+ const srcDirs = dirs.filter((d) => !exclude.has(d.name) && !isPackageDir(d) && !ENGINE_DIRS.has(d.name)).length;
93
+ if (srcDirs > rule.threshold) {
94
+ findings.push(makeFinding({
95
+ file: root, line: 1, rule: rule.id, kind: 'folder',
96
+ severity: capSeverity(rule.severity || 'warning', 'warning'),
97
+ message: (rule.message || rule.name || '').replace('{count}', srcDirs).replace('{threshold}', rule.threshold),
98
+ dimensions: rule.dimensions || ['可维护性'],
99
+ exemptHint: HINT_SIZE,
100
+ scoreImpact: 1,
101
+ }));
102
+ }
103
+ }
104
+ }
105
+ // 规则 2:单目录文件数 > threshold
106
+ if (rule.id.includes('file-count-per-dir') && rule.threshold !== undefined) {
107
+ for (const [dir, cnt] of dirCounts.byDir) {
108
+ if (cnt <= rule.threshold) continue;
109
+ findings.push(makeFinding({
110
+ file: `${root}/…`, line: 1, rule: rule.id, kind: 'folder',
111
+ severity: capSeverity(rule.severity || 'warning', 'warning'),
112
+ message: (rule.message || '').replace('{path}', dir.replace(root, '')).replace('{count}', cnt).replace('{threshold}', rule.threshold),
113
+ dimensions: rule.dimensions || ['可维护性'],
114
+ exemptHint: HINT_SIZE,
115
+ scoreImpact: 1,
116
+ }));
117
+ }
118
+ }
119
+ // 规则 3:解包特征目录
120
+ if (Array.isArray(rule.signatures)) {
121
+ for (const sig of rule.signatures) {
122
+ const pat = String(sig.pattern || '').replace(/\*\*/g, '**').replace(/^\*\*\/?/, '');
123
+ const hit = dirs.find((d) => {
124
+ const rel = d.full.replace(root, '').replace(/^\//, '');
125
+ if (pat.includes('package/package.json')) return rel === 'package' && existsSync(`${d.full}/package.json`); // dsh-skip-residue(签名规则条数极少且 find 短路)
126
+ const base = pat.split('/')[0];
127
+ return rel === base || rel.startsWith(`${base}/`);
128
+ });
129
+ if (hit) {
130
+ findings.push(makeFinding({
131
+ file: `${root}/…`, line: 1, rule: rule.id, kind: 'folder',
132
+ severity: capSeverity(rule.severity || 'warning', 'warning'),
133
+ message: sig.message || `${rule.name}: ${sig.pattern}`,
134
+ dimensions: rule.dimensions || ['可维护性'],
135
+ exemptHint: HINT_SIZE,
136
+ scoreImpact: 1,
137
+ }));
138
+ }
139
+ }
140
+ }
141
+ // 规则 4:.gitignore 覆盖检查
142
+ // 修误报:旧实现要求 .gitignore **含全部** required_patterns
143
+ // (node_modules/dist/build/coverage/*.log/.env)——纯 JS 零依赖插件没有构建
144
+ // 产物,dist/build/coverage/.env 根本不存在,报「缺少忽略项」属误报。
145
+ // 正确语义:只报「仓库里**实际存在**的产物目录/文件」还没被忽略的项。
146
+ if (Array.isArray(rule.requiredPatterns) && gitignoreText) {
147
+ const lines = gitignoreText.split('\n').map((l) => l.trim());
148
+ const isIgnored = (p) => lines.some((l) => l === p || l === p.replace(/^\*/, '') || l.replace(/\/$/, '') === p);
149
+ const missing = rule.requiredPatterns.filter((p) => {
150
+ if (isIgnored(p)) return false; // 已忽略 → 无需报
151
+ // 未忽略:仅当该项在仓库里实际存在时才报(不存在则本项目本就不需要忽略它)
152
+ const probe = p.replace(/^\*/, '').replace(/^\//, '');
153
+ const hitDir = dirs.some((d) => {
154
+ const rel = d.full.replace(root, '').replace(/^\//, '');
155
+ return rel === probe || rel.startsWith(`${probe}/`);
156
+ });
157
+ const hitFile = existsSync(join(root, probe)); // dsh-skip-residue(required_patterns 条数少,每 pattern 一次判定)
158
+ return hitDir || hitFile;
159
+ });
160
+ if (missing.length) {
161
+ findings.push(makeFinding({
162
+ file: `${root}/.gitignore`, line: 1, rule: rule.id, kind: 'folder',
163
+ severity: capSeverity(rule.severity || 'warning', 'warning'),
164
+ message: (rule.message || rule.name || '').replace('{missing}', missing.join(', ')),
165
+ dimensions: rule.dimensions || ['可维护性'],
166
+ exemptHint: HINT_SIZE,
167
+ scoreImpact: 1,
168
+ }));
169
+ }
170
+ }
171
+ }
172
+ return findings;
173
+ }
@@ -0,0 +1,98 @@
1
+ // dsh-skip-i18n: 本文件为规则实现,输出文案硬编码中文为产品行为(无 i18n 需求)
2
+ /**
3
+ * 检查层 · 硬编码绝对路径精筛(paths 槽位 / astConfirmKind: "hardcoded-abs-path")
4
+ *
5
+ * 为什么需要精筛(正则做不到的两件事):
6
+ * ① **可访问性判断**——同一个绝对路径在本机可能存在(说明是"这台机器的真实路径",换机必失效)
7
+ * 也可能不存在(别人机器/历史遗留写法),两者的处置不同,只有 fs 才能判断;
8
+ * ② **相对路径换算**——把绝对路径换算成相对该文件所在目录的路径(修复时的替换基准),
9
+ * 供修复时直接替换;这需要文件路径上下文。
10
+ *
11
+ * 与正则的分工(引擎既有形态):规则的 patterns 只做**初筛**(跨系统字面量形状),
12
+ * 本模块给出**允许报出的行号集合**(allow 语义)+ 行号→详情(供 finding message 用)。
13
+ *
14
+ * 唯一实现声明:本模块是"硬编码绝对路径"检测的**唯一实现**——脚本(scripts/scan-hardcoded-paths.mjs)
15
+ * 必须调用它,不得自带第二份 PATTERNS(同一事实两份实现 ⇒ 必然分叉)。
16
+ */
17
+ import { existsSync } from 'node:fs';
18
+ import { relative, dirname, isAbsolute, join } from 'node:path';
19
+
20
+ /** 跨系统硬编码绝对路径的识别(只取"像绝对路径"的形状,避免把相对路径/URL 误判)。 */
21
+ const PATH_RES = [
22
+ // Linux / macOS:/volume1 /home /Users /var /usr /opt /tmp /mnt /srv /etc /root /Applications /Volumes
23
+ /(?:^|["'`(\s=:])(\/(?:volume\d+|home|Users|var|usr|opt|tmp|mnt|srv|etc|root|Applications|Volumes)\/[^\s"'`)\]},;]*)/g,
24
+ // Windows:C:\ 或 C:/
25
+ /(?:^|["'`(\s=:])([A-Za-z]:[\\/][^\s"'`)\]},;]*)/g,
26
+ // UNC:\\server\share\...
27
+ /(?:^|["'`(\s=:])(\\\\[A-Za-z0-9_.-]+\\[^\s"'`)\]},;]*)/g,
28
+ // file:///...
29
+ /(file:\/\/\/[^\s"'`)\]},;]*)/g,
30
+ ];
31
+
32
+ /**
33
+ * 命中里混入中文 / 全角标点 ⇒ 这是**散文**(说明文字、规则描述、注释里的举例),不是路径。
34
+ * 实测两类误报都由它兜掉:
35
+ * ① 规则自己的描述文本被夹具引用:`/volume1/...,换机即失效)`(后面跟了中文逗号与全角括号);
36
+ * ② 截图输出路径后紧跟全角括号:`/tmp/iwara-login-shots)`。
37
+ * 真实路径不会含 CJK 或全角标点 ⇒ 直接丢弃该命中(不是"只警告",是根本不报)。
38
+ */
39
+ const PROSE_MIXED = /[\u3000-\u303f\u4e00-\u9fff\uff00-\uffef]/;
40
+
41
+ /**
42
+ * 扫描文本里的硬编码绝对路径(引擎侧唯一实现)。
43
+ * @param {string} text 文件全文
44
+ * @param {string} filePath 文件路径(用于换算相对路径;缺省时不做换算)
45
+ * @returns {Array<{line:number, raw:string, accessible:boolean, relative:string, os:string}>}
46
+ */
47
+ export function hardcodedAbsPathHits(text, filePath = '', baseDir = '') {
48
+ const hits = [];
49
+ // 审计传进来的 file 可能是**相对审计根**的路径(如 src/sample.mjs)⇒ 必须用 repoPath 补成绝对路径,
50
+ // 否则 relative('src', '/tmp/x') 会算出一串 ../../(实测踩到:message 里出现 ../../../../../../tmp/…)。
51
+ const absFile = filePath ? (isAbsolute(filePath) ? filePath : join(String(baseDir || ''), filePath)) : '';
52
+ const lines = String(text || '').split('\n');
53
+ lines.forEach((line, i) => {
54
+ PATH_RES.forEach((re, idx) => {
55
+ re.lastIndex = 0;
56
+ let m;
57
+ while ((m = re.exec(line))) {
58
+ const raw = m[1];
59
+ if (!raw) continue;
60
+ if (PROSE_MIXED.test(raw)) continue; // 混入中文/全角标点 = 散文举例,不是路径(见 PROSE_MIXED 注释)
61
+ const accessible = existsSync(raw);
62
+ hits.push({
63
+ line: i + 1,
64
+ raw,
65
+ accessible,
66
+ // 可访问才换算:不可访问的路径(别人机器/已删除)无从确定基准,只提示不改写
67
+ relative: accessible && absFile ? relative(dirname(absFile), raw).split('\\').join('/') : '',
68
+ os: ['posix', 'windows', 'unc', 'file-url'][idx] || 'unknown',
69
+ });
70
+ }
71
+ });
72
+ });
73
+ return hits;
74
+ }
75
+
76
+ /** astConfirmKind: "hardcoded-abs-path" 的集合取值——报出的行号(allow 语义:全部命中都报)。 */
77
+ export function hardcodedAbsPathLines(text, filePath = '', baseDir = '') {
78
+ return new Set(hardcodedAbsPathHits(text, filePath, baseDir).map((h) => h.line));
79
+ }
80
+
81
+ /** astConfirmKind: "hardcoded-abs-path" 的行号→详情(供 finding message:可访问者附相对路径)。 */
82
+ export function hardcodedAbsPathDetail(text, filePath = '', baseDir = '') {
83
+ const out = new Map();
84
+ for (const h of hardcodedAbsPathHits(text, filePath, baseDir)) {
85
+ const prev = out.get(h.line);
86
+ // 同一行多个路径时优先展示"可访问"的那条(可操作:能直接换成相对路径)
87
+ if (!prev || (!prev.accessible && h.accessible)) out.set(h.line, h);
88
+ }
89
+ return out;
90
+ }
91
+
92
+ /** 人类可读的一句话说明(可访问 ⇒ 附相对路径;不可访问 ⇒ 仅警告)。 */
93
+ export function describeHardcodedAbsPath(hit) {
94
+ if (!hit) return '硬编码绝对路径';
95
+ return hit.accessible && hit.relative
96
+ ? `硬编码绝对路径 ${hit.raw}(本机可访问)⇒ 建议改为相对路径 ${hit.relative}`
97
+ : `硬编码绝对路径 ${hit.raw}(本机不可访问)⇒ 仅警告,无法换算相对路径`;
98
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * 检查层 · 统一出口
3
+ *
4
+ * 分层位置(三层审计架构第三层):
5
+ * ① 规则声明 → lib/audit-rules/*.yml
6
+ * ② 具体实现 → lib/ast/*(token 级判定)
7
+ * ③ 调用包装 → lib/checks/*(本目录,把判定转成 finding)
8
+ * ④ 编排调度 → lib/audit/*(收集文件、按 kind 调度、汇总)
9
+ *
10
+ * 本文件只做再导出。模块划分按「检查对象/机制」:
11
+ * common.js 公共设施(豁免提示、severity 封顶、精筛集合取值)
12
+ * dispatch.js 调度(runChecks,只写引用、不含逻辑)
13
+ * filter.js 规则作用域过滤(exts / exclude_paths)
14
+ * regex.js 正则类规则(含 astConfirm 精筛消费)
15
+ * structural.js 结构类(函数长度/复杂度/嵌套/文件行数/同步 fs/空 catch)
16
+ * semantic.js 语义类(yml 声明的语义检查、patch insert)
17
+ * npm-json.js package.json 规范
18
+ * folder.js 目录级检查
19
+ * credential-file.js 凭据文件
20
+ * private.js 私密文件
21
+ * button-bind.js 按钮事件绑定交叉比对
22
+ * magic-number.js 魔数(薄包装 ast/magic-number.js)
23
+ * file-health.js 文件健康度
24
+ */
25
+
26
+ export { HINT_QUALITY, capSeverity, groupByKind } from './common.js';
27
+ export { runChecks } from './dispatch.js';
28
+ export { filterRulesByExt, filterRulesByPath, filterRulesByFileText } from './filter.js';
29
+ export { checkRegexRules, checkPathRegexRules, checkBlacklist } from './regex.js';
30
+ export {
31
+ checkFuncLines, checkEmptyCatch, checkMinLength,
32
+ checkComplexity, checkDepth, checkMaxLines, checkRepeated,
33
+ } from './structural.js';
34
+ // I/O 风险分级检查器(取代 checkSyncFsInFile)
35
+ export { checkIoRisk } from './io.js';
36
+ export { checkSemantic, isRepoLevelSemanticRule, checkPatchInsert } from './semantic.js';
37
+ export { checkCredentialFiles } from './credential-file.js';
38
+ export { checkNpmJson } from './npm-json.js';
39
+ export { checkFolderRules } from './folder.js';
40
+ export { checkPrivateFiles } from './private.js';
41
+ export { checkButtonBindings } from './button-bind.js';
42
+ export { checkMagicNumberSmart } from './magic-number.js';
43
+ export { checkFileHealth } from './file-health.js';
44
+ export { checkDataflow } from './dataflow.js';
45
+ export { checkDuplicateCode } from './dup-code.js';
46
+ export { checkDuplicateConst, findConstDefs } from './dup-const.js';
@@ -0,0 +1,66 @@
1
+ /**
2
+ * dsh-git-push — I/O 风险分级检查器(checks 层,)
3
+ *
4
+ * 分层:本文件是**薄层**——只负责「调 lib/ast/io-risk.js 的判定 → 转 finding」,
5
+ * 不做任何自己的边界识别/上下文判定(那属于 lib/ast 实现层,见 README「正则初筛 → AST 精筛」)。
6
+ *
7
+ * 取代原 `quality/sync-fs`(checkSyncFsInFile):旧检查只判 `inAsync`,
8
+ * 本检查是它的**超集**——同样覆盖「异步路径中的同步 I/O」,另加循环内、
9
+ * 请求路径、启动路径三种上下文,以及读/写/删/改名四类操作。
10
+ * 两者并存会对同一处 I/O 重复报,故旧规则一并移除。
11
+ *
12
+ * 分级 → 严重度:一律 warning(只提示不拦提交),风险高低体现在 message 徽标与描述中。
13
+ */
14
+ import { scanIoRiskAst, RISK_BADGE, RISK_LABEL } from '../ast/io-risk.js';
15
+ import { makeFinding } from '../audit/index.js';
16
+
17
+ /** 豁免说明:复用 quality 标记(同为「性能/质量」类豁免)。 */
18
+ const HINT_IO = 'dsh-skip-quality(文件头=整文件;启动阶段一次性读取可豁免)';
19
+
20
+ /**
21
+ * 扫描单个文件的 I/O 调用并按四级风险转 findings。
22
+ *
23
+ * @param {{file:string, text:string}} ctx 文件路径与全文
24
+ * @returns {Array} findings(按行号升序)
25
+ */
26
+ export function checkIoRisk({ file, text }) {
27
+ const findings = [];
28
+ let hits = [];
29
+ try {
30
+ hits = scanIoRiskAst(text);
31
+ } catch {
32
+ return findings; // 单文件解析异常不影响整体审计
33
+ }
34
+
35
+ for (const hit of hits) {
36
+ const badge = RISK_BADGE[hit.risk] || '·';
37
+ const label = RISK_LABEL[hit.risk] || hit.risk;
38
+ // 上下文串:只列出成立的项,便于一眼看懂为什么是这个级别
39
+ const ctxs = [];
40
+ if (hit.inAsync) ctxs.push('异步路径');
41
+ if (hit.inLoop) ctxs.push('循环内');
42
+ if (hit.inRequest) ctxs.push('请求路径');
43
+ if (hit.inStartup) ctxs.push('启动路径');
44
+ const ctxText = ctxs.length ? ctxs.join('+') : '未知上下文';
45
+
46
+ // 低风险(启动路径上的一次性同步 I/O,如模块顶层/apply() 里读一次配置)
47
+ // 性质上是**提示**而非缺陷:它不影响并发、不随数据量放大,改动收益通常不抵成本。
48
+ // 此前一律按 warning 计 1 分,导致 173 条 io-risk 里 161 条纯提示持续拉低
49
+ // 「健壮性/性能」两维得分,真实高危(high/medium)被淹没在噪声里。
50
+ // 现降为 info + scoreImpact 0:照常展示(含上下文与原因),但不计入评分维度
51
+ // ——与 score/index.js 既有约定一致(scoreImpact===0 的纯提醒不拉低质量分)。
52
+ const isActionable = hit.risk === 'high' || hit.risk === 'medium';
53
+ findings.push(makeFinding({
54
+ file,
55
+ line: hit.line,
56
+ rule: 'robustness/io-risk',
57
+ kind: 'io-risk',
58
+ severity: isActionable ? 'warning' : 'info',
59
+ message: `${badge} ${label}风险:${hit.call}(${hit.type}/${hit.kind},${ctxText})——${hit.reason}`,
60
+ dimensions: ['性能', '健壮性'],
61
+ exemptHint: HINT_IO,
62
+ scoreImpact: isActionable ? (hit.risk === 'high' ? 2 : 1) : 0,
63
+ }));
64
+ }
65
+ return findings;
66
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * 检查层 · 硬编码魔数
3
+ *
4
+ * 职责:薄包装 lib/ast/magic-number.js 的 token 级判定,转成 finding。
5
+ */
6
+
7
+ import { makeFinding } from '../audit/index.js';
8
+ import { checkMagicNumberSmartAst } from '../ast/index.js';
9
+ import { isModuleConstAssignment } from '../ast/scope.js';
10
+ import { HINT_QUALITY } from './common.js';
11
+
12
+ /* ───────────────────────── 硬编码魔数检测(kind=magic-number-smart,实现见 lib/ast/magic-number.js) ───────────────────────── */
13
+
14
+ /**
15
+ * 硬编码魔数检测(薄包装):具体实现在 lib/ast/magic-number.js 的 checkMagicNumberSmartAst(token 级),
16
+ * 本函数只把命中结果转成统一 finding 对象。
17
+ *
18
+ * 规则声明在 lib/audit-rules/audit-rules-nodejs.yml(readability/magic-number-smart)。
19
+ * token 级实现从根上区分「代码里的数字字面量」与「注释/字符串里的数字」——
20
+ * 注释版本号(// v1.8.0)、CSS 字号、i18n 字典值不再误报,无需任何「跳过行」补丁。
21
+ */
22
+ export function checkMagicNumberSmart({ file, text, rules }) {
23
+ const findings = [];
24
+ const rule = (rules || [])[0];
25
+ if (!rule) return findings;
26
+ const opts = {
27
+ magicHints: rule.magicHints,
28
+ legitHints: rule.legitHints,
29
+ forceCount: rule.forceCount,
30
+ };
31
+ for (const hit of checkMagicNumberSmartAst(text, opts)) {
32
+ // 作用域豁免(方案最小实验):模块顶层 `const MAX_RETRY = 3` 类命名常量不报魔数
33
+ if (isModuleConstAssignment(text, hit.line)) continue;
34
+ findings.push(makeFinding({
35
+ file, line: hit.line, rule: rule.id || 'readability/magic-number-smart', kind: 'magic-number-smart',
36
+ severity: rule.severity || 'warning',
37
+ message: `硬编码魔数「${hit.raw}」(${hit.count >= (rule.forceCount || 3) ? `文件内出现 ${hit.count} 次,疑似魔数` : '出现在 timeout/limit/size 等数值上下文'})——建议提取为命名常量并注释含义;版本号/日期/HTTP 状态码/常见合法常量/注释与字符串内数字自动豁免`,
38
+ dimensions: rule.dimensions || ['可维护性'], exemptHint: 'dsh-skip-quality(文件头=整文件)', scoreImpact: 0, // 魔数为「建议提取常量」提示(info 级语义),不扣分——避免配置值(timeout/limit/size)全项目性误扣
39
+ }));
40
+ }
41
+ return findings;
42
+ }