dsh-git-push 0.0.0-stage → 2.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (278) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1482 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +262 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +191 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +662 -0
  32. package/lib/app/tools.js +40 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +207 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +131 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +144 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +470 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +167 -0
  190. package/lib/npm/registry.js +147 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +193 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/doc-drift.mjs +200 -0
  231. package/scripts/doc-func.mjs +212 -0
  232. package/scripts/doc-tree.mjs +456 -0
  233. package/scripts/doc-version.mjs +220 -0
  234. package/scripts/frontend-preview-check.mjs +124 -0
  235. package/scripts/hot-path-probe-cjs.cjs +71 -0
  236. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  237. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  238. package/scripts/hot-path-probe.mjs +153 -0
  239. package/scripts/module-splitter.py +800 -0
  240. package/scripts/platform-scan.mjs +168 -0
  241. package/scripts/preview-gen.mjs +489 -0
  242. package/scripts/preview-local-runner.mjs +55 -0
  243. package/scripts/preview-server-direct.mjs +116 -0
  244. package/scripts/preview-server.mjs +305 -0
  245. package/scripts/preview-slot-data.mjs +123 -0
  246. package/scripts/probe-recheck.mjs +47 -0
  247. package/scripts/readme-gen.mjs +268 -0
  248. package/scripts/rename-locator.mjs +97 -0
  249. package/scripts/rule-switch.mjs +97 -0
  250. package/scripts/rules-solo-audit.mjs +173 -0
  251. package/scripts/scan-file-io.mjs +713 -0
  252. package/scripts/scan-hardcoded-paths.mjs +125 -0
  253. package/scripts/scan-repos.mjs +167 -0
  254. package/scripts/scan-version.mjs +122 -0
  255. package/scripts/scrub-user-wording.mjs +420 -0
  256. package/scripts/symbol-index.mjs +85 -0
  257. package/scripts/sync-plugin-install.mjs +223 -0
  258. package/scripts/sync-plugin.mjs +279 -0
  259. package/scripts/verify-prestep.mjs +100 -0
  260. package/skills/dev/audit-rule-authoring.md +58 -0
  261. package/skills/dev/dsh-git-push.md +323 -0
  262. package/skills/dev/git-push-live-fix.md +45 -0
  263. package/skills/dsh-repo-index.md +35 -0
  264. package/skills/guide/guide-audit.md +167 -0
  265. package/skills/guide/guide-cli-scripts.md +104 -0
  266. package/skills/guide/guide-clone-repos.md +173 -0
  267. package/skills/guide/guide-commit-push.md +156 -0
  268. package/skills/guide/guide-inject-ui.md +166 -0
  269. package/skills/guide/guide-slash-completion.md +118 -0
  270. package/skills/workflow/README.md +21 -0
  271. package/skills/workflow/git-commit-discipline.md +68 -0
  272. package/skills/workflow/git-project-startup.md +85 -0
  273. package/skills/workflow/git-rebuild-process.md +57 -0
  274. package/skills/workflow/github-operations.md +91 -0
  275. package/skills/workflow/readme-sync-git-md.md +28 -0
  276. package/skills/workflow/task-completion-report.md +73 -0
  277. package/skills/workflow/tool-json-add-ask.md +35 -0
  278. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,29 @@
1
+ /**
2
+ * 规则编译器注册表 · 统一出口
3
+ *
4
+ * 本目录是「规则包 → 可执行检查」的编译层:每个模块负责一类 kind 的编译,
5
+ * 模块加载时调 registerCompiler 完成注册(副作用注册)。
6
+ * index.js 的 import 顺序 = 原文件里的注册顺序,保证 listRegisteredKinds() 次序不变。
7
+ *
8
+ * 分层位置(四层审计架构中「规则」→「实现」之间):
9
+ * lib/audit-rules/*.yml 规则内容(阈值/严重度/豁免清单,改规则只动 yml)
10
+ * lib/rule/* 规则加载、编译、注册(本目录:把 yml 的 kind 编译成检查函数)
11
+ * lib/ast/* · lib/checks/* token 级实现与检查包装
12
+ * lib/audit/* 采集与编排
13
+ *
14
+ * 本文件只做再导出与副作用 import:调用方继续 `from './rule/compilers.js'` 导入,路径稳定。
15
+ * 新增一个 kind 的编译器 → 往对应域模块加一段 registerCompiler 即可,不必动本文件。
16
+ */
17
+
18
+ import './credential.js';
19
+ import './func.js';
20
+ import './numeric-kinds.js';
21
+ import './regex.js';
22
+ import './link-semantic.js';
23
+ import './structure.js';
24
+ import './frontend.js';
25
+ import './file-health.js';
26
+ import './dataflow.js'; // 三层审计 L2——数据流 kind(clear-then-access)
27
+
28
+ export { safeRe, DIMENSIONS } from './helpers.js';
29
+ export { listRegisteredKinds } from './list-kinds.js';
@@ -0,0 +1,45 @@
1
+ /**
2
+ * 编译层 · 链接与语义类 kind
3
+ *
4
+ * link-check(文档链接有效性,只报不拦)、semantic(语义占位符检查,最后兜底)。
5
+ * 为何合在一起:两者都是「跨文件/跨上下文才能判定」的检查,与正文正则不是一类。
6
+ */
7
+
8
+ import { registerCompiler } from '../registry.js';
9
+ import { DIMENSIONS, ruleOut, severityLevel, pickDimensions } from './helpers.js';
10
+
11
+ /* ───────────────────────── 注册:链接判断(link-check,0.2.0) ───────────────────────── */
12
+
13
+ registerCompiler(
14
+ 'link-check',
15
+ (r) => r?.kind === 'link-check' || Boolean(r?.flaky_hosts && r?.status_dead),
16
+ (r) => ruleOut({
17
+ id: r.id, name: r.name || r.id, kind: 'link-check', severity: r.severity || 'warning',
18
+ level: severityLevel(r.severity || 'warning'),
19
+ message: r.description || r.name || '',
20
+ dimensions: pickDimensions(r, [DIMENSIONS.文档, DIMENSIONS.可维护性]),
21
+ extra: {
22
+ statusDead: r.status_dead || [],
23
+ statusTransient: r.status_transient || [],
24
+ flakyHosts: r.flaky_hosts || [],
25
+ flakyFactor: r.flaky_factor,
26
+ scoreDead: r.score_dead, scoreDns: r.score_dns, scoreTransient: r.score_transient,
27
+ timeoutMs: r.timeouts_ms, concurrency: r.concurrency, maxLinks: r.max_links,
28
+ },
29
+ }),
30
+ );
31
+
32
+ /* ───────────────────────── 注册:语义规则(最后兜底) ───────────────────────── */
33
+
34
+ registerCompiler(
35
+ 'semantic',
36
+ (r) => Boolean(r?.detection_method || r?.category === 'security' || r?.category === 'accessibility'
37
+ || /\b(路径穿越|path-traversal|test-file|测试|known-vulnerability|漏洞依赖|label|可访问名称)\b/i.test(r?.name || '')
38
+ || /testing\//i.test(r?.id || '') || /dependency\//i.test(r?.id || '')),
39
+ (r) => ruleOut({
40
+ id: r.id, name: r.name || r.id, kind: 'semantic', severity: r.severity,
41
+ level: severityLevel(r.severity), message: r.description || r.name || '',
42
+ dimensions: pickDimensions(r, [DIMENSIONS.健壮性]),
43
+ extra: { detectionMethod: r.detection_method || null },
44
+ }),
45
+ );
@@ -0,0 +1,12 @@
1
+ /**
2
+ * 编译层 · 注册表查询
3
+ *
4
+ * listRegisteredKinds 输出已注册 kind 清单(供自检/文档/UI 展示)。
5
+ * 与注册动作分离成独立模块,避免查询方 import 整个注册表造成副作用。
6
+ */
7
+
8
+ /** 注册表最终导出(供 ruleset 统计用)。 */
9
+ export function listRegisteredKinds() {
10
+ // 延迟 import 避免循环(registry.js 不反向依赖 compilers)
11
+ return import('../registry.js').then((m) => m.RULE_COMPILERS.map((e) => e.kind));
12
+ }
@@ -0,0 +1,66 @@
1
+ /**
2
+ * 编译层 · 数值阈值类 kind(数据表驱动,六个)
3
+ *
4
+ * numericKinds 是一张 kind 定义表(判定式 + 字段提取 + 维度),下方循环按表批量注册。
5
+ * 新增数值类阈值规则只需往表里加一行,不必写编译器——这是本目录里唯一表驱动的模块。
6
+ * min-occurrences 与 repeated-string 共享 min_occurrences 字段,靠 ignore_patterns/
7
+ * ignore_values 是否存在区分,故表里的判定式带这个判断。
8
+ */
9
+
10
+ import { registerCompiler } from '../registry.js';
11
+ import { DIMENSIONS, ruleOut, safeRe, severityLevel, pickDimensions } from './helpers.js';
12
+
13
+ /** 注释密度默认阈值(0~1,规则未配 threshold 时由检查器兜底同值)。 */
14
+ const COMMENT_DENSITY_THRESHOLD_DEFAULT = 0.4;
15
+
16
+ /* ───────────────────────── 注册:数值六类(原 compileNumericRule 拆分) ───────────────────────── */
17
+
18
+ /** 数值字段 → kind 映射(一函数一类型,detect 各查各字段)。 */
19
+ const numericKinds = [
20
+ ['min-length', (r) => r?.min_length !== undefined, (r) => ({ threshold: Number(r.min_length) }), [DIMENSIONS.可读性]],
21
+ ['max-lines', (r) => r?.max_lines !== undefined && !/(function|函数|方法)/i.test(r?.name || ''), (r) => ({ threshold: Number(r.max_lines) }), [DIMENSIONS.可读性, DIMENSIONS.可维护性]],
22
+ ['max-complexity', (r) => r?.max_complexity !== undefined, (r) => ({ threshold: Number(r.max_complexity), ...(r.block_complexity != null ? { block: Number(r.block_complexity) } : {}) }), [DIMENSIONS.可维护性]],
23
+ ['max-depth', (r) => r?.max_depth !== undefined, (r) => ({ threshold: Number(r.max_depth) }), [DIMENSIONS.可维护性]],
24
+ // 重复代码(该抽公共函数)——kind=duplicate-code,由 lib/checks/dup-code.js 消费
25
+ ['duplicate-code', (r) => r?.kind === 'duplicate-code', (r) => ({
26
+ minLines: Number(r.min_lines) || 5,
27
+ minOccurrences: Number(r.min_occurrences) || 3,
28
+ }), [DIMENSIONS.可维护性]],
29
+ // 同名常量跨文件重复定义(DRY)——kind=duplicate-const,由 lib/checks/dup-const.js 消费
30
+ ['duplicate-const', (r) => r?.kind === 'duplicate-const', (r) => ({}), [DIMENSIONS.可维护性]],
31
+ // 注释冗余密度(用户规则反馈①)——显式 kind 或 id 含 comment-density,
32
+ // threshold 字段承载密度阈值(0~1,默认 0.4 由检查器兜底)
33
+ ['comment-density', (r) => r?.kind === 'comment-density' || /comment-density/i.test(String(r?.id || '')), (r) => ({
34
+ threshold: r?.threshold != null ? Number(r.threshold) : COMMENT_DENSITY_THRESHOLD_DEFAULT,
35
+ }), [DIMENSIONS.可读性]],
36
+ // min-occurrences 与 repeated-string 共享 min_occurrences/ignore 字段;带 ignore_patterns/ignore_values 走 repeated-string
37
+ ['min-occurrences', (r) => r?.min_occurrences !== undefined && !(Array.isArray(r.ignore_patterns) || Array.isArray(r.ignore_values)), (r) => ({ threshold: Number(r.min_occurrences), min_occurrences: Number(r.min_occurrences), ...(r.min_lines !== undefined ? { minLines: Number(r.min_lines) } : {}) }), [DIMENSIONS.可维护性]],
38
+ ['repeated-string', (r) => r?.min_occurrences !== undefined && (Array.isArray(r.ignore_patterns) || Array.isArray(r.ignore_values)), (r, ctx) => ({
39
+ threshold: Number(r.min_occurrences), min_occurrences: Number(r.min_occurrences),
40
+ ...(r.min_lines !== undefined ? { minLines: Number(r.min_lines) } : {}),
41
+ ignorePatterns: (r.ignore_patterns || []).map((p) => safeRe(p, r?.name || r?.id, ctx.errors)).filter(Boolean),
42
+ ignoreValues: (r.ignore_values || []).map(String),
43
+ }), [DIMENSIONS.可维护性, DIMENSIONS.可读性]],
44
+ ];
45
+
46
+ for (const [kind, detect, field, dimensions] of numericKinds) {
47
+ registerCompiler(
48
+ kind,
49
+ detect,
50
+ (r, ctx) => {
51
+ const f = field(r, ctx);
52
+ return ruleOut({
53
+ id: r.id, name: r.name || r.id, kind, severity: r.severity,
54
+ level: severityLevel(r.severity), message: r.description || r.name || '',
55
+ dimensions: pickDimensions(r, dimensions, ctx?.errors),
56
+ extra: {
57
+ ...f,
58
+ exceptions: Array.isArray(r.exceptions) ? r.exceptions : [],
59
+ // 透传 exts——代码结构类数值规则(嵌套深度/函数长度/命名长度)
60
+ // 只应作用于代码文件,否则 md/json/yml 里的示例代码块与文档结构会被误报。
61
+ exts: Array.isArray(r.exts) ? r.exts.map((x) => String(x).toLowerCase().replace(/^\./, '')) : undefined,
62
+ },
63
+ });
64
+ },
65
+ );
66
+ }
@@ -0,0 +1,78 @@
1
+ /**
2
+ * 编译层 · 正则类 kind(两个)
3
+ *
4
+ * regex(正文正则,按 ext 作用域跑)、path-regex(路径正则)。
5
+ * 两者都是「模式串命中即报」,差别只在匹配对象是文件内容还是文件路径。
6
+ */
7
+
8
+ import { registerCompiler } from '../registry.js';
9
+ import { DIMENSIONS, ruleOut, safeRe, severityLevel, pickDimensions } from './helpers.js';
10
+
11
+ /* ───────────────────────── 注册:正则两类 ───────────────────────── */
12
+
13
+ registerCompiler(
14
+ 'regex',
15
+ (r) => Array.isArray(r?.patterns) || typeof r?.pattern === 'string',
16
+ (r, ctx) => {
17
+ // 子模式支持(文档 §13 承诺「可直接落地」):patterns 条目可为字符串或对象 {id,pattern,message}
18
+ const list = [r.pattern, ...(Array.isArray(r.patterns) ? r.patterns : [])]
19
+ .map((p) => {
20
+ if (typeof p === 'string') return { regex: safeRe(p, r?.name || r?.id, ctx.errors), message: null };
21
+ if (p && typeof p === 'object' && typeof p.pattern === 'string') {
22
+ return { regex: safeRe(p.pattern, r?.name || r?.id, ctx.errors), message: p.message || null };
23
+ }
24
+ return null;
25
+ })
26
+ .filter((x) => x && x.regex);
27
+ if (!list.length) return null; // 无有效 pattern → 编译失败交调用方
28
+ return ruleOut({
29
+ id: r.id, name: r.name || r.id, kind: 'regex', severity: r.severity,
30
+ level: severityLevel(r.severity),
31
+ // 每个条目带 regex + 可选专属 message(checks.js 对 RegExp 条目的向后兼容)
32
+ pattern: list[0].regex, patterns: list.map((x, i) => (i === 0 ? x.regex : x.regex)), // 保持 RegExp 主键兼容
33
+ message: r.description || r.name || '',
34
+ dimensions: pickDimensions(r, [DIMENSIONS.可读性], ctx?.errors),
35
+ // subPatterns 走 extra 展开(ruleOut 只白名单 id/name/kind/... 顶层字段 + extra)
36
+ extra: {
37
+ subPatterns: list,
38
+ exts: Array.isArray(r.exts) ? r.exts.map((x) => String(x).toLowerCase().replace(/^\./, '')) : undefined,
39
+ // 路径级排除——按 relPath 前缀过滤(如 client-node-builtin-require
40
+ // 只查浏览器侧,排除 server/ test/ lib/ 等 Node 目录,修纯正则误伤)
41
+ excludePaths: Array.isArray(r.exclude_paths) ? r.exclude_paths.map(String) : undefined,
42
+ // 路径级白名单——只对指定文件跑该规则(如「package.json 的 version 必须 SemVer」:
43
+ // 仅 exts:["json"] 会把规则套到所有 json 上,第三方仓库成千上万个 json 被误报,实测 1435 条)。
44
+ // 语义见 lib/checks/filter.js filterRulesByPath:不含 '/' 按文件名匹配,含 '/' 按路径后缀匹配。
45
+ includePaths: Array.isArray(r.include_paths) ? r.include_paths.map(String) : undefined,
46
+ // 白名单行豁免——命中 whitelist_patterns 的行不报(修凭据类误报:
47
+ // 字段引用/API 名/字符串字面量 ≠ 硬编码凭据值)
48
+ whitelistPatterns: Array.isArray(r.whitelist_patterns) ? r.whitelist_patterns.map(String) : undefined,
49
+ // 正则初筛 → AST 精筛开关——声明后正则只筛候选行,再由 token 级
50
+ // 判定确认命中行确实是代码行,注释/字符串里的内容不再误报。
51
+ // astConfirm: true → 用 makeCodeLineFilter(行级:是否代码行);
52
+ // astConfirm: "magic-number" → 用 checkMagicNumberSmartAst(值级:该数字
53
+ // 是否真魔数——版本号/日期/HTTP 状态码/命名常量值/参数默认值/索引运算
54
+ // i+1 等自动豁免,修纯 regex 把索引运算当魔数的大面积误报)。
55
+ astConfirm: r.astConfirm === true || r.astConfirm === 'magic-number' ? r.astConfirm : undefined,
56
+ // 具名精筛(供子模式规则声明「命中后还要 AST 确认什么」)——
57
+ // 如 performance/memory-bomb 的 small-file-read:确认读的是否受控小文件。
58
+ astConfirmKind: typeof r.ast_confirm_kind === 'string' ? r.ast_confirm_kind
59
+ : (typeof r.astConfirmKind === 'string' ? r.astConfirmKind : undefined),
60
+ examples: r.examples || undefined, // G6 认领:bad/good 示例展示字段
61
+ },
62
+ });
63
+ },
64
+ );
65
+
66
+ registerCompiler(
67
+ 'path-regex',
68
+ (r) => r?.kind === 'path-regex' || (r?.path_pattern && !/^credfile-/.test(r?.id || '')),
69
+ (r, ctx) => {
70
+ const re = safeRe(r.path_pattern, r?.name || r?.id, ctx.errors);
71
+ return ruleOut({
72
+ id: r.id, name: r.name || r.id, kind: 'path-regex', severity: r.severity,
73
+ level: severityLevel(r.severity), pathPattern: re?.source,
74
+ message: r.description || r.name || '',
75
+ dimensions: pickDimensions(r, [DIMENSIONS.可读性, DIMENSIONS.可维护性], ctx?.errors),
76
+ });
77
+ },
78
+ );
@@ -0,0 +1,80 @@
1
+ /**
2
+ * 编译层 · 结构类 kind(三个)
3
+ *
4
+ * 注释黑名单(comment 槽位)、目录级审计(folder 槽位:目录数/单目录文件数)、
5
+ * npm 结构化(npm-json:license/repository/files 字段判定)。
6
+ */
7
+
8
+ import { registerCompiler } from '../registry.js';
9
+ import { DIMENSIONS, ruleOut, severityLevel, pickDimensions } from './helpers.js';
10
+
11
+ /* ───────────────────────── 注册:注释黑名单(comment 槽位,1.0.3) ───────────────────────── */
12
+
13
+ /**
14
+ * 注释措辞黑名单(comment-wording 分数制)。
15
+ * 认领条件:黑名单数组 pattern+weight 形态(comment 槽位总纲规则)。
16
+ * 编译产物:blacklist[]({pattern, weight} 直接下传检查器,检查器做行级加分扣分判定)。
17
+ */
18
+ registerCompiler(
19
+ 'blacklist',
20
+ (r) => Array.isArray(r?.blacklist) && r.blacklist.length > 0,
21
+ (r) => ruleOut({
22
+ id: r.id, name: r.name || r.id, kind: 'blacklist', severity: r.severity || 'warning',
23
+ level: severityLevel(r.severity || 'warning'),
24
+ message: r.description || r.name || '注释措辞审查',
25
+ dimensions: pickDimensions(r, [DIMENSIONS.文档]),
26
+ extra: {
27
+ blacklist: Array.isArray(r.blacklist) ? r.blacklist.map((b) => ({ pattern: b.pattern, ...(b.weight !== undefined ? { weight: Number(b.weight) || 0 } : {}) })) : [],
28
+ whitelist: Array.isArray(r.whitelist) ? r.whitelist.map((w) => ({ pattern: w.pattern, ...(w.penalty !== undefined ? { penalty: Number(w.penalty) || 0 } : {}) })) : [],
29
+ additionalFeatures: Array.isArray(r.additional_features) ? r.additional_features.map((a) => ({ pattern: a.pattern, weight: Number(a.weight) || 0 })) : [],
30
+ // G6 认领:scoring.threshold_suspicious(comment.yml 60)→ threshold,action/suggestions 展示字段透传
31
+ threshold: Number(r.threshold ?? r.scoring?.threshold_suspicious) || undefined,
32
+ scoring: r.scoring || undefined,
33
+ action: r.action || undefined,
34
+ suggestions: Array.isArray(r.suggestions) ? r.suggestions : undefined,
35
+ },
36
+ }),
37
+ );
38
+
39
+ /* ───────────────────────── 注册:目录级审计(folder 槽位,1.0.3) ───────────────────────── */
40
+
41
+ /**
42
+ * 目录级审计规则(文件夹数量审计:目录总数/单目录文件数/解包特征/.gitignore 覆盖)。
43
+ * 认领条件:category === 'folder' 或带 threshold+exclude_dirs/signatures 组合字段。
44
+ * 编译产物:目录级规则对象(threshold/excludeDirs/signatures/requiredPatterns 下传 checkFolderRules)。
45
+ */
46
+ registerCompiler(
47
+ 'folder',
48
+ (r) => r?.category === 'folder' || (r?.threshold !== undefined && (Array.isArray(r?.exclude_dirs) || Array.isArray(r?.signatures) || Array.isArray(r?.required_patterns))),
49
+ (r) => ruleOut({
50
+ id: r.id, name: r.name || r.id, kind: 'folder', severity: r.severity,
51
+ level: severityLevel(r.severity),
52
+ message: r.message || r.description || r.name || '',
53
+ dimensions: pickDimensions(r, [DIMENSIONS.可维护性, DIMENSIONS.可部署性]),
54
+ extra: {
55
+ threshold: r.threshold !== undefined ? Number(r.threshold) : undefined,
56
+ excludeDirs: Array.isArray(r.exclude_dirs) ? r.exclude_dirs : [],
57
+ signatures: Array.isArray(r.signatures) ? r.signatures : [],
58
+ requiredPatterns: Array.isArray(r.required_patterns) ? r.required_patterns : [],
59
+ },
60
+ }),
61
+ );
62
+
63
+ /* ───────────────────────── 注册:npm 结构化(npm-json,1.0.3) ───────────────────────── */
64
+
65
+ /**
66
+ * npm 结构化规则(package.json 真实解析判定)。
67
+ * 认领条件:显式 kind==='npm-json'(这两条原为「命中即提示」弱 pattern,
68
+ * 引擎未实现真实判定 = 死规则;v2 忠实执行导致对任意 package.json 误报)。
69
+ * 编译产物:保留 id/severity/message,检查器 checkNpmJson 做 JSON 解析判定。
70
+ */
71
+ registerCompiler(
72
+ 'npm-json',
73
+ (r) => r?.kind === 'npm-json',
74
+ (r) => ruleOut({
75
+ id: r.id, name: r.name || r.id, kind: 'npm-json', severity: r.severity,
76
+ level: severityLevel(r.severity),
77
+ message: r.description || r.name || '',
78
+ dimensions: pickDimensions(r, [DIMENSIONS.可部署性]),
79
+ }),
80
+ );
@@ -0,0 +1,17 @@
1
+ /**
2
+ * 规则编译器注册表 · 纯引用文件(1.1.4 起)
3
+ *
4
+ * 本文件历史上是一个 459 行的单文件注册表(16 段 registerCompiler 声明 + 5 个助手
5
+ * 全挤在一起,新增一个 kind 要在几百行文件里找位置)。
6
+ * 1.1.4 按「域」拆到同目录 compilers/ 下各模块,本文件退化为纯再导出:
7
+ * 实现全在 lib/rule/compilers/*.js,本文件不含任何实现。
8
+ *
9
+ * 保留本文件只为让 `from './rule/compilers.js'` 这类既有 import 路径继续有效。
10
+ * 新增一个 kind 的编译器 → 写进 lib/rule/compilers/ 对应域模块。
11
+ *
12
+ * 注意注册是**副作用**(模块加载时调 registerCompiler):compilers/index.js 里
13
+ * 的 import 顺序 = 原文件注册顺序,改动顺序会影响 listRegisteredKinds() 输出次序。
14
+ */
15
+ import './compilers/index.js';
16
+
17
+ export { safeRe, DIMENSIONS, listRegisteredKinds } from './compilers/index.js';
@@ -0,0 +1,45 @@
1
+ /**
2
+ * dsh-git-push 同形字符检测(G3 防再犯,1.0.4)
3
+ *
4
+ * 背景:规则 yml 的 kind/id 是引擎匹配键(registerCompiler 的 kind 用 ASCII 注册)。
5
+ * 若 yml 里 kind/id 夹带西里尔/希腊同形字符(如 с→c、е→e、а→a),视觉上几乎相同,
6
+ * 但 `RULE_COMPILERS.find(e => e.kind === rule.kind)` 匹配不上 → 规则静默失效(编译报
7
+ * 「未知规则类型」或字段探测落空),且无任何提示。本模块在 compileRule 入口检测,
8
+ * 把「静默失效」变为「显式报错」。
9
+ *
10
+ * 用法:findHomoglyphs('credential-ref') → [{ ch:'с', ascii:'c', index:1 }](空数组=纯 ASCII)
11
+ */
12
+ export const HOMOGLYPH_MAP = {
13
+ // 西里尔(Cyrillic,U+0400–U+04FF)→ 视觉同形 ASCII
14
+ 'а': 'a', 'б': 'b', 'д': 'd', 'е': 'e', 'о': 'o', 'р': 'p', 'с': 'c',
15
+ 'у': 'y', 'х': 'x', 'в': 'B', 'г': 'r', 'з': '3', 'н': 'H', 'к': 'K',
16
+ 'м': 'M', 'т': 'T', 'і': 'i', 'ѕ': 's', 'ј': 'j', 'ɡ': 'g',
17
+ // 希腊(Greek,U+0370–U+03FF)→ 视觉同形 ASCII
18
+ 'α': 'a', 'ο': 'o', 'ρ': 'p', 'σ': 'o', 'τ': 't', 'ν': 'v', 'χ': 'x',
19
+ 'ε': 'e', 'κ': 'k', 'μ': 'm', 'ι': 'i', 'β': 'B', 'δ': 'D', 'γ': 'y',
20
+ // 常用混淆(易误录)
21
+ 'İ': 'I', 'ı': 'i', 'ł': 'l', 'ø': 'o', 'Ø': 'O', 'æ': 'ae',
22
+ };
23
+
24
+ /** 组合正则:匹配任一非 ASCII 同形字符。 */
25
+ export const HOMOGLYPH_RE = new RegExp(`[${Object.keys(HOMOGLYPH_MAP).join('')}]`, 'g');
26
+
27
+ /**
28
+ * 检测字符串中的同形字符。
29
+ * @param {string} text 待检文本(如规则 id / kind)
30
+ * @returns {Array<{ch:string, ascii:string, index:number}>} 命中列表(空=纯 ASCII)
31
+ */
32
+ export function findHomoglyphs(text) {
33
+ if (typeof text !== 'string' || !text) return [];
34
+ const hits = [];
35
+ for (let i = 0; i < text.length; i++) {
36
+ const ch = text[i];
37
+ if (HOMOGLYPH_MAP[ch]) hits.push({ ch, ascii: HOMOGLYPH_MAP[ch], index: i });
38
+ }
39
+ return hits;
40
+ }
41
+
42
+ /** 检测文本是否含非 ASCII 同形字符(布尔,供文件级扫描用)。 */
43
+ export function hasHomoglyphs(text) {
44
+ return typeof text === 'string' && HOMOGLYPH_RE.test(text);
45
+ }
@@ -0,0 +1,270 @@
1
+ // dsh-skip-sensitive: FORCE_LOAD_FALLBACK 含私密文件清单声明(凭据路径数据定义,非文档引用旧位置)
2
+ /**
3
+ * dsh-git-push 规则总入口:yml 装载与解析
4
+ *
5
+ * 统一装载所有 yml 规则槽位(nodejs/npm/html/frontend/comment/dsh/private/structure/version/template 等),
6
+ * 支持 yml 衍生新字段(编译函数按字段指派,见 ./registry.js)。
7
+ */
8
+ import { readFileSync, readdirSync, existsSync, writeFileSync } from 'node:fs';
9
+ import { normalizeScopeRules } from './scope.js';
10
+ import { join, dirname } from 'node:path';
11
+ import { fileURLToPath } from 'node:url';
12
+ import { load as yamlLoad } from '../vendor/js-yaml/js-yaml.mjs';
13
+
14
+ const __dirname = dirname(fileURLToPath(import.meta.url));
15
+ export const RULE_YAML_DIR = join(__dirname, '..', 'audit-rules');
16
+
17
+ /**
18
+ * 核心槽位优先级提示(**不是全量清单,禁止补成全部槽位**)。
19
+ *
20
+ * 槽位集合全动态:放一个 audit-rules-<名>.yml 进目录就自动成为槽位,
21
+ * 无需改代码——见 discoverRuleSlots()。本常量只用于把高频核心槽位排到前面,
22
+ * **只维护核心子集即可**;新增/未列出的槽位由 resolveSlotOrder 按文件名字典序
23
+ * 自动追加到末尾,加槽位零改动(放 yml 即生效)。
24
+ */
25
+ export const SLOT_ORDER_HINT = ['nodejs', 'frontend', 'npm', 'comment', 'dsh', 'structure', 'private', 'template'];
26
+
27
+ /**
28
+ * 强制加载槽位(1.1.0,disabled 无法关闭的安全红线):
29
+ * - nodejs:含凭据/硬编码/路径穿越等安全规则(secret-*、cred*、security/*),不可被 yml 关闭
30
+ * - private:私密文件拦截(独立通道,天然强制)
31
+ * 即使槽位 yml 顶层标 `disabled: true` 也强制加载(环境变量显式列出同样生效)。
32
+ */
33
+ export const FORCE_LOAD_SLOTS = new Set(['nodejs', 'private']);
34
+
35
+ /**
36
+ * 强制加载规则前缀(1.1.0):规则条目即使标 `disabled: true` 也保留——
37
+ * 凭据/硬编码/私密引用类安全红线不允许被 yml 关闭。
38
+ * 覆盖:secret-*(github-pat/openai-key/keyvalue/email/aws-access-key/generic-token)、
39
+ * credfile-* 与 credref-*(凭据文件/引用)、security/*(路径穿越/硬编码凭据/求值)、
40
+ * npm/npmrc-authtoken(.npmrc 凭据)、dsh/schema-secret-*(schema 凭据字段)。
41
+ * @param {string} ruleId 规则 id
42
+ * @returns {boolean} true=强制加载(无视 disabled)
43
+ */
44
+ export function isForceLoadRule(ruleId) {
45
+ return /^(secret-|cred(file|ref)?-|security\/|npm\/npmrc-authtoken|dsh\/schema-secret)/.test(String(ruleId || ''));
46
+ }
47
+
48
+ /**
49
+ * 强制加载槽位内置兜底规则(1.1.0):文件丢失/被删时安全审计不断档——
50
+ * 凭据/硬编码/路径穿越类最小安全集 + 私密文件清单(与 audit-rules-nodejs.yml /
51
+ * audit-rules-private.yml 语义一致的精简版)。加载时若发现强制槽位文件缺失,
52
+ * 用本兜底合并进规则集并记入 errors(CLI/工具可感知「规则包不完整」)。
53
+ */
54
+ export const FORCE_LOAD_FALLBACK = {
55
+ nodejs: [
56
+ {
57
+ id: 'secret-generic-token', name: '疑似凭据 token 硬编码', category: 'security',
58
+ severity: 'error', description: '疑似 token/secret 硬编码(内置兜底,规则文件缺失)',
59
+ pattern: '\\b(?:ghp_|gho_|ghu_|ghs_|ghr_|github_pat_|sk-)[A-Za-z0-9_-]{15,}\\b', fixable: false,
60
+ },
61
+ {
62
+ id: 'security/no-hardcoded-credentials', name: '禁止硬编码凭据', category: 'security',
63
+ severity: 'error', description: '凭据不应硬编码在源代码中(内置兜底,规则文件缺失)',
64
+ patterns: [
65
+ 'password\\s*[=:]+\\s*[\'"][^\'"]+[\'"]',
66
+ 'secret\\s*[=:]+\\s*[\'"][^\'"]+[\'"]',
67
+ 'api[_-]?key\\s*[=:]+\\s*[\'"][^\'"]+[\'"]',
68
+ 'token\\s*[=:]+\\s*[\'"][^\'"]+[\'"]',
69
+ ],
70
+ fixable: false,
71
+ },
72
+ {
73
+ id: 'security/no-path-traversal', name: '路径穿越防护', category: 'security',
74
+ severity: 'error', description: '直接使用用户输入作为文件路径存在目录遍历风险(内置兜底,规则文件缺失)',
75
+ fixable: false,
76
+ },
77
+ ],
78
+ private_files: [
79
+ '**/id_ed25519', '**/id_rsa', '**/*.pem', '**/*.key', '**/github-token',
80
+ '**/.git-push-token', '**/.env', '**/.env.*', '**/data/sensitive/**',
81
+ '**/.ssh/**', '**/.dsh/git-push/**', '**/.npmrc',
82
+ ],
83
+ };
84
+
85
+ /**
86
+ * @deprecated 兼容旧调用:等于槽位排序偏好。槽位集合请用 discoverRuleSlots()。
87
+ */
88
+ export const RULE_SLOTS = SLOT_ORDER_HINT;
89
+
90
+ /**
91
+ * 读取单个槽位 yml(纯数据,不做合并)。
92
+ * @returns {{ok:true, data:object, file:string} | {ok:false, error:string}}
93
+ */
94
+ export function loadYamlRuleFile(slot, dir = RULE_YAML_DIR) {
95
+ const file = join(dir, `audit-rules-${slot}.yml`);
96
+ try {
97
+ if (!existsSync(file)) return { ok: false, error: `规则文件缺失: ${file}` };
98
+ const parsed = yamlLoad(readFileSync(file, 'utf8'));
99
+ return { ok: true, data: parsed || { rules: [] }, file };
100
+ } catch (e) {
101
+ return { ok: false, error: `规则文件解析失败 ${slot}: ${e.message}` };
102
+ }
103
+ }
104
+
105
+ /**
106
+ * 发现目录下的全部规则槽位文件(含新增 yml 自动生效)。
107
+ */
108
+ export function discoverRuleSlots(dir = RULE_YAML_DIR) {
109
+ try {
110
+ return readdirSync(dir)
111
+ .filter((f) => f.startsWith('audit-rules-') && f.endsWith('.yml'))
112
+ .map((f) => f.replace(/^audit-rules-/, '').replace(/\.yml$/, ''));
113
+ } catch {
114
+ return [];
115
+ }
116
+ }
117
+
118
+ /**
119
+ * 解析生效槽位顺序(**全动态**:槽位集合由目录内的规则文件决定)。
120
+ *
121
+ * 规则:
122
+ * 1) 槽位集合 = 目录里实际存在的 `audit-rules-<名>.yml`(放文件即生效,无需改代码)
123
+ * 2) 顺序 = 配置若给了顺序则按配置;否则按 SLOT_ORDER_HINT 偏好排序,未列出的按字典序追加
124
+ * 3) 配置声明的槽位若文件不存在 → 静默跳过(不报缺失,方便先写配置后放文件)
125
+ * 4) template 槽位默认不加载(模板保持为空,不进默认装载)
126
+ *
127
+ * @param {string[]|string} [order] 配置指定的槽位顺序(数组或逗号分隔字符串)
128
+ * @param {object} [opts] { dir, includeTemplate=false }
129
+ * @returns {string[]} 最终槽位顺序
130
+ */
131
+ export function resolveSlotOrder(order = null, { dir = RULE_YAML_DIR, includeTemplate = false } = {}) {
132
+ const discovered = discoverRuleSlots(dir);
133
+ const allowed = new Set(discovered);
134
+ let configured = order;
135
+ if (!configured && process.env.DSH_GIT_PUSH_RULE_SLOTS) {
136
+ configured = String(process.env.DSH_GIT_PUSH_RULE_SLOTS);
137
+ }
138
+ if (typeof configured === 'string') {
139
+ configured = configured.split(',').map((s) => s.trim()).filter(Boolean);
140
+ }
141
+ const hasConfig = Array.isArray(configured) && configured.length > 0;
142
+ const seen = new Set();
143
+ const out = [];
144
+ const push = (slot) => {
145
+ if (!slot || seen.has(slot)) return;
146
+ // 强制加载槽位(nodejs/private):即使目录里文件缺失也进入装载列表(loadRuleFiles 兜底),
147
+ // 保证安全红线不因规则包被删/目录指向错误而静默消失
148
+ if (!allowed.has(slot) && !FORCE_LOAD_SLOTS.has(slot)) return;
149
+ if (slot === 'template' && !includeTemplate) return;
150
+ seen.add(slot);
151
+ out.push(slot);
152
+ };
153
+ if (hasConfig) {
154
+ // 配置顺序优先(配置里没有但目录存在的,随后按偏好补上)
155
+ for (const slot of configured) push(slot);
156
+ }
157
+ // 动态发现:按排序偏好排,未列在偏好里的按字典序追加
158
+ const hintRest = SLOT_ORDER_HINT.filter((s) => !seen.has(s));
159
+ for (const slot of hintRest) push(slot);
160
+ for (const slot of [...discovered].sort()) push(slot);
161
+ return out;
162
+ }
163
+
164
+ /**
165
+ * 按顺序装载并合并多个槽位(后覆盖前)。
166
+ * @param {string[]|string} [order] 槽位顺序(缺省走 resolveSlotOrder 配置驱动解析)
167
+ *
168
+ * disabled 机制(1.1.0):
169
+ * 1) 文件级:yml 顶层 `disabled: true` → 整槽位默认不加载(如 audit-rules-i18n.yml 默认关)。
170
+ * 例外:环境变量 DSH_GIT_PUSH_RULE_SLOTS 显式列出该槽位 → 强制加载(显式指定即开)。
171
+ * 2) 规则级:单条规则 `disabled: true` → 该条规则不编译(合并时直接过滤,无需删/改文件)。
172
+ */
173
+ export function loadRuleFiles(order = null, opts = {}) {
174
+ const dir = opts.dir || RULE_YAML_DIR;
175
+ const slots = Array.isArray(order) ? order : resolveSlotOrder(order, { dir });
176
+ // UI 禁用槽位:设置页单击禁用 → 装载最前过滤;
177
+ // nodejs/private 属 FORCE_LOAD_SLOTS 安全红线,UI 禁用不生效(后端强制加载)。
178
+ const uiDisabled = new Set(Array.isArray(opts.disabledSlots) ? opts.disabledSlots.filter(Boolean) : []);
179
+ // 修复 explicit 误伤:显式强制名单**只认环境变量 DSH_GIT_PUSH_RULE_SLOTS**
180
+ // (用户点名要强制开启的槽位),不再把调用方传的 order/settings.auditRuleOrder 当强制名单——
181
+ // 否则 auditRuleOrder 全量 14 个会被当 explicit,yml 顶层 disabled:true 全部失效(i18n 默认关闭被误加载)。
182
+ const explicit = new Set(
183
+ String(process.env.DSH_GIT_PUSH_RULE_SLOTS || '')
184
+ .split(',').map((s) => s.trim()).filter(Boolean),
185
+ );
186
+ const errors = [];
187
+ const files = [];
188
+ const merged = { metadata: {}, rules: [], severity_map: {}, thresholds: {}, ignore: [], private_files: [] };
189
+ for (const slot of slots) {
190
+ // UI 单击禁用优先:该槽位任何规则都不加载(安全红线槽位除外)
191
+ if (uiDisabled.has(slot) && !FORCE_LOAD_SLOTS.has(slot)) continue;
192
+ const r = loadYamlRuleFile(slot, dir);
193
+ if (!r.ok) {
194
+ // 强制加载槽位(nodejs/private)文件缺失 → 内置兜底,安全审计不断档 + 显式记录
195
+ if (FORCE_LOAD_SLOTS.has(slot)) {
196
+ if (slot === 'nodejs') merged.rules.push(...FORCE_LOAD_FALLBACK.nodejs);
197
+ else merged.private_files.push(...FORCE_LOAD_FALLBACK.private_files);
198
+ errors.push(`强制加载槽位 ${slot} 规则文件缺失(${r.error})——已用内置兜底规则集,建议恢复 audit-rules-${slot}.yml`);
199
+ continue;
200
+ }
201
+ errors.push(r.error); continue;
202
+ }
203
+ // 文件级 disabled:yml 顶层 disabled:true 且未被显式列出且非强制加载槽位 → 跳过整槽位
204
+ if (r.data?.disabled === true && !explicit.has(slot) && !FORCE_LOAD_SLOTS.has(slot)) continue;
205
+ files.push(r.file);
206
+ const ruleData = r.data;
207
+ if (ruleData?.metadata && !merged.metadata.name) merged.metadata = ruleData.metadata;
208
+ // 规则级 disabled:合并前过滤 disabled:true 条目(安全红线规则 isForceLoadRule 强制保留)
209
+ // 逐条打 __slot 归属标记——按规则包聚合审计命中数(侧边栏规则包行的
210
+ // 「拦截/警告/通过」显示该规则包的实际命中数)。__slot 用下划线前缀避免与 yml 字段冲突。
211
+ merged.rules.push(...(Array.isArray(ruleData?.rules)
212
+ ? ruleData.rules.filter((x) => x?.disabled !== true || isForceLoadRule(x.id))
213
+ .map((x) => (x && typeof x === 'object' ? { ...x, __slot: slot, scopeRules: normalizeScopeRules(x) } : x))
214
+ : []));
215
+ Object.assign(merged.severity_map, ruleData?.severity_map || {});
216
+ Object.assign(merged.thresholds, ruleData?.thresholds || {});
217
+ merged.ignore.push(...(Array.isArray(ruleData?.ignore) ? ruleData.ignore : []));
218
+ // 私密拦截清单跨文件追加(强制槽位 private.yml 永远最后加载 → 天然追加)
219
+ if (Array.isArray(ruleData?.private_files)) merged.private_files.push(...ruleData.private_files);
220
+ }
221
+ return { ok: errors.length === 0, merged, order: slots, files, errors };
222
+ }
223
+
224
+ /**
225
+ * 设置/取消槽位的 yml 顶层 `disabled`(约定:启用/禁用以 yml 解析,不单独存变量)。
226
+ *
227
+ * 文本级操作(保留文件内注释与其它内容,不用 js-yaml dump 避免丢注释):
228
+ * - 启用:删除顶层 `disabled:` 行
229
+ * - 禁用:已存在 → 值改为 true;不存在 → 在 metadata 前插入 `disabled: true`
230
+ * nodejs/private 强制加载槽位禁止禁用(安全红线,由调用方拒绝,此处同样防御)。
231
+ * @param {string} slot 槽位名
232
+ * @param {boolean} disabled 目标状态
233
+ * @param {object} [opts] { dir }
234
+ * @returns {{ok: boolean, disabled: boolean, error?: string}}
235
+ */
236
+ export function setSlotDisabled(slot, disabled, opts = {}) {
237
+ const dir = opts.dir || RULE_YAML_DIR;
238
+ if (FORCE_LOAD_SLOTS.has(slot)) {
239
+ return { ok: false, error: `${slot} 属安全红线强制槽位,不可通过 UI 禁用` };
240
+ }
241
+ const file = join(dir, `audit-rules-${slot}.yml`);
242
+ if (!existsSync(file)) return { ok: false, error: `规则文件缺失: ${file}` };
243
+ const text = readFileSync(file, 'utf8');
244
+ // 顶层 disabled(无缩进)行:^disabled: [true|false],多行匹配
245
+ const re = /^disabled:\s*(true|false)\s*$/m;
246
+ let out;
247
+ if (disabled) {
248
+ if (re.test(text)) out = text.replace(re, 'disabled: true');
249
+ else {
250
+ // 在第一个非注释、非空行(通常是 metadata:)之前插入
251
+ const lines = text.split('\n');
252
+ let idx = lines.findIndex((l) => l.trim() && !l.trim().startsWith('#'));
253
+ if (idx < 0) idx = lines.length;
254
+ lines.splice(idx, 0, 'disabled: true');
255
+ out = lines.join('\n');
256
+ }
257
+ } else {
258
+ // 修复污染:删除整行(含行尾换行),不能只删 `disabled: true` 内容——
259
+ // 否则残留的 \n 会留下一个空行(folder.yml/i18n.yml 曾被误加空行)。
260
+ out = re.test(text) ? text.replace(/^disabled:\s*(true|false)\s*$\n?/m, '') : text;
261
+ // 清理可能留下的多空行粘连(保留单个空行语义)
262
+ out = out.replace(/\n\s*\n\s*\n/g, '\n\n');
263
+ }
264
+ try {
265
+ writeFileSync(file, out, 'utf8');
266
+ } catch (e) {
267
+ return { ok: false, error: `写入失败: ${e.message}` };
268
+ }
269
+ return { ok: true, disabled };
270
+ }