dsh-git-push 2.20.18 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/README.md +3 -2
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +36 -2
  4. package/lib/app/apply.js +9 -9
  5. package/lib/app/command-registry.js +44 -20
  6. package/lib/app/handlers/meta.js +7 -142
  7. package/lib/app/handlers/npm.js +18 -1
  8. package/lib/app/handlers/preprocess.js +107 -0
  9. package/lib/app/handlers/repo-actions.js +2 -2
  10. package/lib/app/http-handlers.js +25 -12
  11. package/lib/app/index.js +2 -1
  12. package/lib/app/inject-text.js +3 -2
  13. package/lib/app/preprocess-client.js +136 -0
  14. package/lib/app/repo-ownership.js +1 -1
  15. package/lib/app/schema.js +3 -3
  16. package/lib/app/severity.js +14 -0
  17. package/lib/app/slash-commands.js +5 -164
  18. package/lib/app/tool-call.js +75 -140
  19. package/lib/app/tools.js +13 -6
  20. package/lib/cli/commands-preprocess.mjs +74 -0
  21. package/lib/cli/commands-tool.mjs +3 -2
  22. package/lib/cli/commands-vcs.mjs +4 -4
  23. package/lib/cli/shared.mjs +42 -13
  24. package/lib/client-parts/git/controller.js +2 -2
  25. package/lib/client.js +2 -2
  26. package/lib/commit-push/pre-commit-engine.js +57 -10
  27. package/lib/commit-push.js +125 -36
  28. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  29. package/lib/git/ignore.js +1 -1
  30. package/lib/git/repos.js +2 -2
  31. package/lib/git/sensitive.js +1 -1
  32. package/lib/npm/publish.js +20 -5
  33. package/lib/plugin/auto-push.js +2 -2
  34. package/lib/preprocess/providers.js +191 -0
  35. package/lib/self/index.js +1 -1
  36. package/lib/skip-dirs.js +14 -55
  37. package/package.json +29 -37
  38. package/scripts/build-client.mjs +2 -0
  39. package/scripts/check.mjs +4 -2
  40. package/scripts/local-registry.mjs +2 -1
  41. package/skills/dev/dsh-git-push.md +5 -0
  42. package/cli-audit.mjs +0 -141
  43. package/lib/app/audit-api.js +0 -173
  44. package/lib/app/host-doc-checks.js +0 -25
  45. package/lib/app/scope-check.js +0 -69
  46. package/lib/ast/brace.js +0 -120
  47. package/lib/ast/callgraph.js +0 -135
  48. package/lib/ast/code-lines.js +0 -175
  49. package/lib/ast/consts.js +0 -12
  50. package/lib/ast/control-flow.js +0 -470
  51. package/lib/ast/credential.js +0 -315
  52. package/lib/ast/dataflow.js +0 -391
  53. package/lib/ast/dup-code.js +0 -165
  54. package/lib/ast/fs-hotspots.js +0 -154
  55. package/lib/ast/index.js +0 -38
  56. package/lib/ast/io-risk-const.js +0 -95
  57. package/lib/ast/io-risk-fn.js +0 -208
  58. package/lib/ast/io-risk-loop.js +0 -308
  59. package/lib/ast/io-risk.js +0 -314
  60. package/lib/ast/lang.js +0 -156
  61. package/lib/ast/line-count.js +0 -52
  62. package/lib/ast/magic-number.js +0 -272
  63. package/lib/ast/naming.js +0 -292
  64. package/lib/ast/perf.js +0 -488
  65. package/lib/ast/scope-collisions.js +0 -228
  66. package/lib/ast/scope.js +0 -241
  67. package/lib/ast/shell.js +0 -131
  68. package/lib/ast/size.js +0 -448
  69. package/lib/ast/symbol-index.js +0 -399
  70. package/lib/ast/tokenizer.js +0 -421
  71. package/lib/ast/treesitter.js +0 -413
  72. package/lib/audit/analysis-coverage.js +0 -98
  73. package/lib/audit/audit-file.js +0 -205
  74. package/lib/audit/auditignore-rules.js +0 -148
  75. package/lib/audit/checks.js +0 -17
  76. package/lib/audit/client-entry.js +0 -93
  77. package/lib/audit/collector.js +0 -610
  78. package/lib/audit/ext-runner.js +0 -80
  79. package/lib/audit/file-context.js +0 -391
  80. package/lib/audit/finding.js +0 -101
  81. package/lib/audit/gitignore-match.js +0 -113
  82. package/lib/audit/glob.js +0 -63
  83. package/lib/audit/history-report.js +0 -100
  84. package/lib/audit/history.js +0 -126
  85. package/lib/audit/ignore-blind.js +0 -102
  86. package/lib/audit/index.js +0 -33
  87. package/lib/audit/orchestrate.js +0 -672
  88. package/lib/audit/public.js +0 -24
  89. package/lib/audit/repo-level.js +0 -30
  90. package/lib/audit/report-yaml.js +0 -90
  91. package/lib/audit/scope-policy.js +0 -110
  92. package/lib/audit/slot.js +0 -66
  93. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  94. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  95. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  96. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  97. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  98. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  99. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  100. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  101. package/lib/audit-rules/audit-rules-go.yml +0 -103
  102. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  103. package/lib/audit-rules/audit-rules-java.yml +0 -105
  104. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  105. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  106. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  107. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  108. package/lib/audit-rules/audit-rules-php.yml +0 -101
  109. package/lib/audit-rules/audit-rules-private.yml +0 -24
  110. package/lib/audit-rules/audit-rules-python.yml +0 -106
  111. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  112. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  113. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  114. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  115. package/lib/audit-rules/audit-rules-template.yml +0 -108
  116. package/lib/audit-ui-sdk/contract.js +0 -117
  117. package/lib/audit-ui-sdk/index.js +0 -17
  118. package/lib/checks/button-bind.js +0 -347
  119. package/lib/checks/common.js +0 -170
  120. package/lib/checks/credential-file.js +0 -43
  121. package/lib/checks/dataflow.js +0 -40
  122. package/lib/checks/dispatch.js +0 -117
  123. package/lib/checks/dup-code.js +0 -69
  124. package/lib/checks/dup-const.js +0 -232
  125. package/lib/checks/file-health.js +0 -150
  126. package/lib/checks/filter.js +0 -137
  127. package/lib/checks/folder.js +0 -173
  128. package/lib/checks/fs-scanner.js +0 -57
  129. package/lib/checks/hardcoded-path.js +0 -98
  130. package/lib/checks/index.js +0 -49
  131. package/lib/checks/io.js +0 -66
  132. package/lib/checks/magic-number.js +0 -42
  133. package/lib/checks/npm-json.js +0 -273
  134. package/lib/checks/private.js +0 -64
  135. package/lib/checks/regex.js +0 -298
  136. package/lib/checks/scope-collision.js +0 -68
  137. package/lib/checks/semantic.js +0 -134
  138. package/lib/checks/structural.js +0 -281
  139. package/lib/cli/commands-audit.mjs +0 -142
  140. package/lib/cli/commands-doc.mjs +0 -127
  141. package/lib/client-parts/audit/audit.js +0 -301
  142. package/lib/exempt/tool.js +0 -198
  143. package/lib/git/module-splitter.js +0 -47
  144. package/lib/link-check/index.js +0 -187
  145. package/lib/lint-adapter/detect.js +0 -161
  146. package/lib/lint-adapter/index.js +0 -50
  147. package/lib/lint-adapter/runner.js +0 -133
  148. package/lib/rule/compilers/credential.js +0 -62
  149. package/lib/rule/compilers/dataflow.js +0 -38
  150. package/lib/rule/compilers/file-health.js +0 -75
  151. package/lib/rule/compilers/frontend.js +0 -86
  152. package/lib/rule/compilers/func.js +0 -35
  153. package/lib/rule/compilers/helpers.js +0 -71
  154. package/lib/rule/compilers/index.js +0 -29
  155. package/lib/rule/compilers/link-semantic.js +0 -45
  156. package/lib/rule/compilers/list-kinds.js +0 -12
  157. package/lib/rule/compilers/numeric-kinds.js +0 -73
  158. package/lib/rule/compilers/regex.js +0 -78
  159. package/lib/rule/compilers/structure.js +0 -107
  160. package/lib/rule/compilers.js +0 -17
  161. package/lib/rule/homoglyph.js +0 -45
  162. package/lib/rule/loader.js +0 -274
  163. package/lib/rule/registry.js +0 -122
  164. package/lib/rule/scope.js +0 -67
  165. package/lib/score/docs-score.js +0 -166
  166. package/lib/score/index.js +0 -234
  167. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  168. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  169. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  170. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  171. package/scripts/audit-gate.mjs +0 -235
  172. package/scripts/audit-runner.mjs +0 -35
  173. package/scripts/audit-runtime-check.mjs +0 -129
  174. package/scripts/browser-page-probe.mjs +0 -271
  175. package/scripts/check-js-scope.mjs +0 -87
  176. package/scripts/clean-date-comments.py +0 -102
  177. package/scripts/cpu-sample.mjs +0 -188
  178. package/scripts/doc-drift.mjs +0 -200
  179. package/scripts/hot-path-probe-cjs.cjs +0 -71
  180. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  181. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  182. package/scripts/hot-path-probe.mjs +0 -153
  183. package/scripts/module-splitter.py +0 -800
  184. package/scripts/picker-repro.mjs +0 -115
  185. package/scripts/platform-scan.mjs +0 -168
  186. package/scripts/probe-recheck.mjs +0 -47
  187. package/scripts/rename-locator.mjs +0 -97
  188. package/scripts/rule-switch.mjs +0 -97
  189. package/scripts/rules-solo-audit.mjs +0 -173
  190. package/scripts/scan-file-io.mjs +0 -717
  191. package/scripts/scan-fs-hotspots.mjs +0 -107
  192. package/scripts/symbol-index.mjs +0 -85
  193. package/scripts/verify-prestep.mjs +0 -100
  194. package/skills/dev/audit-rule-authoring.md +0 -58
  195. package/skills/guide/guide-audit.md +0 -270
  196. /package/lib/{audit → app}/ownership.js +0 -0
  197. /package/lib/app/{schema-audit.js → schema-preprocess.js} +0 -0
  198. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
package/lib/self/index.js CHANGED
@@ -9,7 +9,7 @@
9
9
  */
10
10
 
11
11
 
12
- export const VERSION = '2.20.18'; // 2.20.17:修桌面端(dsh-app://)所有写接口 403 NO_ORIGIN + 本地列表超时改预算传播 + 放行判据加固。① 桌面壳 forwardWebRequest 转发 /api/* 时显式剥离 Origin,checkOrigin 对无 Origin 的写请求一律拒,导致设置页所有保存/开关/按钮失效且不留日志 → 无 Origin 时要求「Content-Type=application/json + 本机来源」同时成立才放行;② 本机判定以 TCP 对端地址(socket.remoteAddress,内核给出不可伪造)为准,Host 仅在拿不到 socket 时兜底——只信 Host 会被 `Host: 127.0.0.1` 伪造绕过;isLoopbackHost 补裸 IPv6 与 ::ffff: 映射形态;③ 恢复 403 拒绝日志 http-rejects.log(query 凭据键打码);④ settings-set 凭据类回显改「(已保存)」;⑤ 前端保存先 await 写入结果再提示;⑥ clone-progress 改 GET 轮询;⑦ 本地列表 SSH 探测改为预算传播(每步 timeoutMs = min(单步上限, 剩余预算)),扫描长轮询 60s→20s、前端单请求 25s,轮次耗尽不再误报「扫描完成」。历史:2.20.15:
12
+ export const VERSION = '3.0.0'; // 2.20.17:修桌面端(dsh-app://)所有写接口 403 NO_ORIGIN + 本地列表超时改预算传播 + 放行判据加固。① 桌面壳 forwardWebRequest 转发 /api/* 时显式剥离 Origin,checkOrigin 对无 Origin 的写请求一律拒,导致设置页所有保存/开关/按钮失效且不留日志 → 无 Origin 时要求「Content-Type=application/json + 本机来源」同时成立才放行;② 本机判定以 TCP 对端地址(socket.remoteAddress,内核给出不可伪造)为准,Host 仅在拿不到 socket 时兜底——只信 Host 会被 `Host: 127.0.0.1` 伪造绕过;isLoopbackHost 补裸 IPv6 与 ::ffff: 映射形态;③ 恢复 403 拒绝日志 http-rejects.log(query 凭据键打码);④ settings-set 凭据类回显改「(已保存)」;⑤ 前端保存先 await 写入结果再提示;⑥ clone-progress 改 GET 轮询;⑦ 本地列表 SSH 探测改为预算传播(每步 timeoutMs = min(单步上限, 剩余预算)),扫描长轮询 60s→20s、前端单请求 25s,轮次耗尽不再误报「扫描完成」。历史:2.20.15:
13
13
  // 实测后果:该目录有 package.json ⇒ npm 去打包整棵 DSH 树、输出 2.1MB > spawnSync 默认 maxBuffer 1MB ⇒ ENOBUFS(npm_publish 的体检与真发全部失败);
14
14
  // 该目录没有 package.json 时报 ENOENT。现 publish 的两个调用点显式传 cwd=目标包目录,并给 runNpm 加 16MB maxBuffer。
15
15
  // 2.8.3:文案修正——「零改动 / 无新提交」明确为**正常成功路径**(注入用法、工具描述、README、skill 同批改),并修 job 输出自相矛盾(cleanSkipCommit 路径补 committed:false,不再显示「已提交,未推送」)
package/lib/skip-dirs.js CHANGED
@@ -1,67 +1,26 @@
1
1
  /**
2
- * 统一「无条件跳过目录」名单(收敛)。
2
+ * 统一「无条件跳过目录」名单(宿主侧只剩硬编码基线)。
3
3
  *
4
- * 组成 = 硬编码基线 + yml 黑名单关键词:
5
- * - 硬编码基线:**只允许 node_modules 和 .git 两个**——禁止在本文件追加目录名
6
- * (dist/build/vendor/coverage/.dsh/.trash/.npm/.pnpm-store/.tmp-build 等一律不许写死在代码里)。
7
- * - yml 黑名单关键词:从审计规则 yml 的 `exclude_dirs` 字段加载(各规则的黑名单目录并集,
8
- * 如 folder 规则的 dist/build/vendor/.dsh/.trash 等)。要新增跳过目录 → 改 yml,不改代码。
4
+ * 历史:本模块原设计是「硬编码基线(node_modules/.git)+ 从审计规则 yml 的 exclude_dirs 取黑名单」。
5
+ * 审计实现与规则 yml 已整体迁入独立包(audit-sluice)⇒ 宿主读不到 yml,yml 那半段已删除。
6
+ * 需要按规则排除目录的场景属于审计侧职责,不该再回到宿主。
9
7
  *
10
- * 白名单(gitignore negation)不受影响:collector walk 对「被忽略目录」按前缀跳过,
11
- * 但 gitignore 白名单恢复的目录仍会进入(黑名单初筛 + 白名单补充)。
12
- *
13
- * 消费方:lib/audit/collector.js(审计文件收集)、lib/git/sensitive.js(敏感扫描)。
8
+ * 消费方:lib/git/sensitive.js(敏感文件扫描时剪枝)。
14
9
  */
15
- import { existsSync, readFileSync, readdirSync } from 'node:fs';
16
- import { join, dirname } from 'node:path';
17
- import { fileURLToPath } from 'node:url';
18
- // js-yaml 走 npm 依赖(仓库内不保存副本)。
19
- // 这里**故意用静态 import**:规则加载是启动关键路径,依赖没装上就应当在模块加载期
20
- // 抛 ERR_MODULE_NOT_FOUND(错误里带包名,够响亮),而不是被 try/catch 吞成「0 条规则」
21
- // 继续跑——静默无规则比启动失败更危险(口径见 docs/2026-10-28-弃零依赖引入npm与AST优先规则方案.MD D5)。
22
- import { load as yamlLoad } from 'js-yaml';
23
-
24
- /** 硬编码基线:只许这两个(勿改)。 */
25
- export const SKIP_DIRS = new Set(['node_modules', '.git']);
26
-
27
- /** 规则 yml 目录(audit-rules-*.yml,与本模块同级的 audit-rules/)。 */
28
- export function auditRulesDir() {
29
- return join(dirname(fileURLToPath(import.meta.url)), 'audit-rules');
30
- }
31
-
32
- let ymlBlacklistCache = null;
33
10
 
34
11
  /**
35
- * 从规则 yml 的 exclude_dirs 字段收集黑名单目录关键词(跨 yml 并集)。
36
- * 加载失败返回空集(不因规则文件损坏阻塞扫描)。
12
+ * 跳过目录基线。
13
+ * - `node_modules` / `.git`:任何仓库都该跳
14
+ * - `node_modules.orig` / `node_modules.bak`:安装/降级留下的完整副本,
15
+ * 里面同样是依赖代码,扫它既慢又会产生大量无关敏感命中
16
+ * 其余目录(dist/build/vendor/.dsh/.trash…)不写死——需要时由调用方显式传参。
37
17
  */
38
- export function loadYamlBlacklistDirs() {
39
- if (ymlBlacklistCache) return ymlBlacklistCache;
40
- const out = new Set();
41
- const dir = auditRulesDir();
42
- try {
43
- for (const f of readdirSync(dir)) {
44
- if (!f.endsWith('.yml')) continue;
45
- let doc;
46
- try { doc = yamlLoad(readFileSync(join(dir, f), 'utf8')); } catch { continue; }
47
- const rules = doc && Array.isArray(doc.rules) ? doc.rules : [];
48
- for (const r of rules) {
49
- if (Array.isArray(r && r.exclude_dirs)) {
50
- for (const n of r.exclude_dirs) if (typeof n === 'string' && n.trim()) out.add(n.trim());
51
- }
52
- }
53
- }
54
- } catch { /* 目录缺失/不可读:返回空集 */ }
55
- ymlBlacklistCache = out;
56
- return out;
57
- }
18
+ export const SKIP_DIRS = new Set(['node_modules', 'node_modules.orig', 'node_modules.bak', '.git']);
58
19
 
59
20
  /**
60
- * 最终跳过目录集合 = 硬编码基线 ∪ yml 黑名单关键词。
61
- * 消费方在遍历剪枝时对目录名命中此集合即整棵跳过。
21
+ * 最终跳过目录集合。
22
+ * 保留函数形态(而非直接导出 Set)是为了调用方不必关心「以后会不会再合并别的来源」。
62
23
  */
63
24
  export function getSkipSet() {
64
- const set = new Set(SKIP_DIRS);
65
- for (const n of loadYamlBlacklistDirs()) set.add(n);
66
- return set;
25
+ return new Set(SKIP_DIRS);
67
26
  }
package/package.json CHANGED
@@ -1,22 +1,24 @@
1
1
  {
2
2
  "name": "dsh-git-push",
3
- "version": "2.20.18",
3
+ "version": "3.0.0",
4
4
  "description": "DSH git 自动提交推送插件——统一函数入口架构(规则/审计/git/自身/侧边栏/评分/豁免/上下文/HTTP/测试十大总入口)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
7
7
  "exports": {
8
8
  ".": "./lib/index.js",
9
9
  "./client": "./lib/client.js",
10
- "./audit": "./lib/audit/public.js",
11
10
  "./package.json": "./package.json"
12
11
  },
12
+ "bin": {
13
+ "git-sluice": "./cli.mjs",
14
+ "tool-sluice": "./cli-tool.mjs"
15
+ },
13
16
  "files": [
14
17
  "lib",
15
18
  "skills",
16
19
  "scripts",
17
20
  "assets",
18
21
  "cli.mjs",
19
- "cli-audit.mjs",
20
22
  "cli-tool.mjs",
21
23
  "cordis.patch.yml",
22
24
  "README.md",
@@ -24,11 +26,31 @@
24
26
  ".auditignore",
25
27
  ".gitignore"
26
28
  ],
27
- "bin": {
28
- "git-sluice": "./cli.mjs",
29
- "audit-sluice": "./cli-audit.mjs",
30
- "tool-sluice": "./cli-tool.mjs"
29
+ "optionalDependencies": {
30
+ "audit-sluice": "0.1.0"
31
31
  },
32
+ "engines": {
33
+ "node": ">=18.0.0"
34
+ },
35
+ "scripts": {
36
+ "build:client": "node scripts/build-client.mjs",
37
+ "prepare": "node scripts/build-client.mjs",
38
+ "prepack": "node scripts/build-client.mjs",
39
+ "test": "node test/run-tests.mjs",
40
+ "check": "node scripts/check.mjs"
41
+ },
42
+ "keywords": [
43
+ "dsh",
44
+ "dsh-plugin",
45
+ "deepseek-harness",
46
+ "git",
47
+ "commit",
48
+ "push",
49
+ "audit",
50
+ "cli"
51
+ ],
52
+ "author": "EIGHTfs",
53
+ "license": "MIT",
32
54
  "dsh": {
33
55
  "bundle": {
34
56
  "patch": "./cordis.patch.yml"
@@ -44,7 +66,6 @@
44
66
  "./skills/dsh-repo-index.md",
45
67
  "./skills/dev/dsh-git-push.md",
46
68
  "./skills/dev/git-push-live-fix.md",
47
- "./skills/guide/guide-audit.md",
48
69
  "./skills/guide/guide-cli-scripts.md",
49
70
  "./skills/guide/guide-clone-repos.md",
50
71
  "./skills/guide/guide-commit-push.md",
@@ -61,8 +82,6 @@
61
82
  "./skills/workflow/versioning-rule.md"
62
83
  ]
63
84
  },
64
- "license": "MIT",
65
- "author": "EIGHTfs",
66
85
  "repository": {
67
86
  "type": "git",
68
87
  "url": "git+https://github.com/EIGHTfs/dsh-git-push.git"
@@ -71,37 +90,10 @@
71
90
  "url": "https://github.com/EIGHTfs/dsh-git-push/issues"
72
91
  },
73
92
  "homepage": "https://github.com/EIGHTfs/dsh-git-push#readme",
74
- "keywords": [
75
- "dsh",
76
- "dsh-plugin",
77
- "deepseek-harness",
78
- "git",
79
- "commit",
80
- "push",
81
- "audit",
82
- "cli"
83
- ],
84
- "engines": {
85
- "node": ">=18.0.0"
86
- },
87
93
  "peerDependencies": {
88
94
  "@deepseek-ai/dsh-tools": ">=0.1.6-0 <0.3.0-0",
89
95
  "@deepseek-ai/schemastery": ">=3.0.0 <4.0.0-0"
90
96
  },
91
- "scripts": {
92
- "build:client": "node scripts/build-client.mjs",
93
- "prepare": "node scripts/build-client.mjs",
94
- "prepack": "node scripts/build-client.mjs",
95
- "test": "node test/run-tests.mjs",
96
- "check": "node scripts/check.mjs",
97
- "scan-version": "node scripts/scan-version.mjs",
98
- "check:drift": "node scripts/doc-drift.mjs"
99
- },
100
- "dependencies": {
101
- "js-yaml": "4.1.0",
102
- "tree-sitter-wasms": "0.1.13",
103
- "web-tree-sitter": "0.25.10"
104
- },
105
97
  "dshScopeCheck": {
106
98
  "note": "拼接产物作用域检查:files 里每个文件都查「同作用域重名 / 顶层声明 / 命名前缀」。查法:git-sluice scope-check(无参数即读本块 files);其它项目只要在自己的 package.json 写同名字段即可复用同一套判定",
107
99
  "files": [
@@ -33,6 +33,8 @@ export const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
33
33
  // 也不会因「缺片」报错(缺片检查只针对 PART_ORDER 里列出的片)。
34
34
  export const PARTS_DIR = join(ROOT, 'lib', 'client-parts', 'git');
35
35
  /** 不参与构建的分片目录(只做归档,构建脚本不读、不校验)。 */
36
+ // 审计前端分片已随审计能力迁出宿主(现在在 audit-sluice 包的 lib/ui/audit-tab.js)。
37
+ // 这里保留一个只读路径常量供历史脚本引用;目录不存在时调用方应按「无归档分片」处理。
36
38
  export const ARCHIVE_PARTS_DIR = join(ROOT, 'lib', 'client-parts', 'audit');
37
39
  export const OUT_FILE = join(ROOT, 'lib', 'client.js');
38
40
 
package/scripts/check.mjs CHANGED
@@ -43,7 +43,9 @@ function collectJson(dir, acc = []) {
43
43
 
44
44
  // 三个 CLI 入口都要做语法检查:它们不是 lib/ 下的文件,靠 collectJs 收不到——
45
45
  // 漏检的后果是「新入口语法错,但门禁全绿」(与被拆出来的入口一起构成盲区)。
46
- const CLI_ENTRIES = ['cli.mjs', 'cli-audit.mjs', 'cli-tool.mjs'].map((name) => join(ROOT, name));
46
+ // 只检查现存入口:审计 CLI 已随审计能力独立成包(audit-sluice),宿主不再提供 cli-audit.mjs。
47
+ const CLI_ENTRY_FILES = ['cli.mjs', 'cli-tool.mjs'];
48
+ const CLI_ENTRIES = CLI_ENTRY_FILES.map((name) => join(ROOT, name));
47
49
  const files = [...collectJs(join(ROOT, 'lib')), ...CLI_ENTRIES];
48
50
  // docs/*.json 也必须能解析:版本表与发版说明直接依赖 docs/releases.json,
49
51
  // 而它曾在 2.8.4 因一个尾随逗号变成非法 JSON 却**四项门禁全绿**(缺口)——这类错误必须在门禁里变红 ✗
@@ -96,7 +98,7 @@ try {
96
98
  // ① 同作用域重名(var/function 静默覆盖的触发条件,始终检查);
97
99
  // ② 文件顶层零声明;③ 共享作用域命名前缀。
98
100
  try {
99
- const { analyzeScopeCollisions } = await import('../lib/ast/scope-collisions.js');
101
+ const { analyzeScopeCollisions } = await import('../../audit-sluice/lib/ast/scope-collisions.js');
100
102
  const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'));
101
103
  const cfg = pkg?.dshScopeCheck;
102
104
  const files = Array.isArray(cfg?.files) && cfg.files.length ? cfg.files : [];
@@ -20,7 +20,8 @@ if (args.includes('--selftest')) {
20
20
  const r = await runLocalPreview({
21
21
  dir: repo,
22
22
  tag: 'beta',
23
- entrySpecs: ['dsh-git-push', 'dsh-git-push/audit'],
23
+ // 只验包自己的公开面:审计子路径(dsh-git-push/audit)已随审计能力迁出
24
+ entrySpecs: ['dsh-git-push'],
24
25
  });
25
26
  for (const s of r.steps) console.log(` ${s.ok ? 'OK ' : 'FAIL'} ${s.step}${s.distTags ? ` → dist-tags ${JSON.stringify(s.distTags)}` : ''}`);
26
27
  if (r.failures.length) console.log('失败:\n' + r.failures.map((f) => ` - ${f}`).join('\n'));
@@ -324,6 +324,11 @@ pnpm add github:EIGHTfs/dsh-git-push#<commit>
324
324
  | 函数/复杂度被报为 blocker | 规则 `severity` 是上限,检查器不越级;报 blocker 说明 yml 里写的就是 error/blocker |
325
325
  | 克隆大文件反复失败 | 失败项的分片必须保留(`.dsh-parts`)才能跨轮 Range 续传;同轮清理分片会让大文件永远从 0 重来 |
326
326
  | **桌面端(`dsh-app://`)设置页保存全部失效、GET 正常** | 桌面壳 `forwardWebRequest` 转发 `/api/*` 时**显式剥离 Origin**(`headers.delete('origin')`,只补 cookie),插件写请求鉴权对无 Origin 一律 403。2.20.17 起放行「无 Origin + `Content-Type: application/json` + **本机来源**」,本机判定以 TCP 对端地址(`req.socket.remoteAddress`)为准、`Host` 只做兜底——`Host` 可被客户端伪造(`Host: 127.0.0.1`),且实测某些转发链路会丢 Host;仍不通就看 `<DSH_HOME>/git-push/http-rejects.log`(2.20.17 恢复,记 method/url/origin/host/code);**排查前先完全退出应用重开**——见下一行 |
327
+ | **`npm publish` 回了成功,但 registry 上查不到新版本** | **不是失败**,是 registry 处理延迟(延迟窗口内 404 / 旧版本号 / `409 Cannot publish over previously staged version` 三者都**不是失败证据**)。判读依据与完整处置见通用 skill `npm-publish-checklist`(该坑已在那里记录两次,本行只做指向,避免两处真相)。**误判代价:多发一个版本号**(本插件 2.20.17→2.20.18 就是这么来的) |
328
+ | **批量改测试路径 / 合并测试文件后,用例数变少却全绿** | 四类「静默少注册」形态,全是「删了不报错、只会消失」:① `require2()` 等 `createRequire` 自定义 require 没跟着改深度 → 模块加载**中途抛错**,该行之后所有 `test()` 从未注册 ② `const HERE = dirname(...)` 这类**先取常量再 join** 的间接写法漏改 ③ `if (existsSync(p)) test(...)` 条件不成立 → 静默少一条(`readdirSync` 会抛错,`existsSync` 不会)④ 文件名不合 `test-*.mjs` 直接**不被扫描器收集**。⇒ 判据:**逐文件比 `test(` 静态计数**(不是看总数"差不多"),并让结构门禁拦「顶层存在非 `test-` 前缀的 `.mjs`」 |
329
+ | **用 `describe()` 包整个原文件体来合并测试** | 会改语义(实测 54 失败 / 少 17 条):`describe` 回调是 async 作用域,顶层 `test()` / `const` / `await` 全挪进回调后求值时机变了。⇒ 正确做法:**原样平铺**(`test()` 仍在模块顶层)+ 每个原文件体包一层 `{}` **块级作用域**(只隔同名声明,不改注册时机)。前置检查五项:顶层 `await` / `process.env`·`exitCode` 赋值 / `before`·`after` 钩子 / 顶层 `export`(包里直接 SyntaxError)/ 顶层声明同名 |
330
+ | **同一批测试里某文件单独跑过、夹在批次中间就红** | `run-tests` 每批 40 个文件跑在**同一进程**,某测试改了 `process.env` 又没还原会污染后续。⇒ spawn 子进程前**显式剔除**可疑变量(如 `for (const k of ['X','Y']) delete env[k]`),别靠调顺序或加大间隔 |
331
+ | **清理部署副本时删掉 `tools/` 导致某功能静默失效** | `tools/`(如 `tools/ruff`)是**部署方提供的运行必需二进制**,但不在 `files` 白名单里,所以会出现在 `sync_plugin` 的 `stale` 列表。代码是**自探测**设计(候选路径 → PATH 兜底),删了不报错、只是静默降级成「无该能力」。⇒ 清 stale 前先查该路径是否被代码引用(`grep PLUGIN_ROOT.*tools`),并把 `tools/` 列入保护名单 |
327
332
  | **补丁改了不生效,误判「补丁无效」** | DSH 宿主的 HMR `profileRoots` 只收集**符号链接**形式的插件包;**复制安装(真实目录)** 的插件在插件页开关切换只重启 fiber,**ESM 缓存仍是旧代码**。⇒ 验证服务端补丁必须**完全退出应用重开**,否则会把「缓存没刷新」误判成「改错了」(外部报告实测踩到,2026-11-13 记入) |
328
333
  | 建了远端但推送报「远端查不到分支 master(API 404 / ls-remote 无该分支)」 | `git_remote_create` 旧版把 origin 写成 **REST API 端点**(`https://api.github.com/repos/<o>/<r>` ✗ 那不是 git remote)⇒ `git push/fetch origin` 必然失败。2026-10-09 已修(`lib/git/remote.js`):origin 统一写 `https://github.com/<o>/<r>`,并**自愈**——仓库已存在但 origin 仍是 API 形态时 `set-url` 改回;返回体新增 `originAction`(`add`/`repair`/`keep`)。旧仓库手工修:`git remote set-url origin ssh://git@ssh.github.com:443/<o>/<r>.git` 再 `git push -u origin master`(凭据用插件 `id_rsa` + `-p 443`)。⚠️ `lib/git/clone.js` 仍写 API 形态 origin(设计如此,插件自身推送不受影响,但 `git push origin` 会失败) |
329
334
 
package/cli-audit.mjs DELETED
@@ -1,141 +0,0 @@
1
- #!/usr/bin/env node
2
- // dsh-skip-i18n: CLI 输出硬编码中文为产品行为(无 i18n 需求)
3
- /**
4
- * dsh-git-push 独立 CLI · **审计侧**(bin: audit-sluice)
5
- * 不依赖 DSH 运行时,可独立运行。
6
- *
7
- * 为什么单独一个入口(而不是继续挂在 git-sluice 里):
8
- * 审计引擎上一轮已经解耦成「可配置子进程」,但入口层如果还共用,用户仍得敲
9
- * `git-sluice audit` 才能跑到审计——「审计侧独立」只做了一半。现在审计有自己的 CLI,
10
- * 换引擎(含换语言重写)与换 CLI 组合互不影响。
11
- *
12
- * ⚠️⚠️ 两条**纯副作用 import** 是本入口的生命线(删了不报错、少了不报错,只会让功能静默失效):
13
- * ① ./lib/app/host-doc-checks.js —— 目录树漂移 / 函数列表漂移两类检查器由宿主注入。
14
- * 漏搬后果:同一棵树上这两类 finding **整类消失**(实测少 4 条),审计照常「通过」。
15
- * ② ./lib/rule/compilers.js —— 规则编译函数注册(13 种)。
16
- * 漏搬后果:`ruleset` 命令编译出 0 条规则却报「OK」。
17
- * (`audit` 走 lib/audit/index.js,那条路径自身也会注册编译器;但 `ruleset` 不走审计编排,
18
- * 必须靠本文件的显式 import。两处都留是刻意的冗余——这类静默失效不值得省一行 import。)
19
- *
20
- * 本文件只保留:命令表 + HELP 文本 + 薄壳。解析/打印/分发/跨侧提示都在 lib/cli/shared.mjs。
21
- */
22
- import './lib/app/host-doc-checks.js'; // 副作用①:文档漂移检查器接线(审计专用)
23
- import './lib/rule/compilers.js'; // 副作用②:规则编译函数注册(audit / ruleset 依赖)
24
-
25
- import { VERSION } from './lib/self/index.js';
26
- import { loadRuleFiles } from './lib/rule/loader.js';
27
- import { compileAllRules } from './lib/rule/registry.js';
28
-
29
- import {
30
- cmdAudit, cmdScan, pluginEqualAuditOpts, pluginEqualWeights, cliPluginConfig,
31
- } from './lib/cli/commands-audit.mjs';
32
- import { cmdLinkCheck } from './lib/cli/commands-vcs.mjs';
33
- import { cmdFileIo, cmdTreeDoc, cmdFunctions } from './lib/cli/commands-doc.mjs';
34
- import {
35
- CLI_AUDIT, CLI_ENTRIES, printToolResult, parseArgv, parseVia, runAsEntry, runCli,
36
- } from './lib/cli/shared.mjs';
37
-
38
- export const CLI_NAME = CLI_AUDIT;
39
-
40
- /** parseArgv 认识的选项白名单(本侧 HELP 写着的那批;self-check 机器比对本表与 HELP 文本)。
41
- * 注:**注册表驱动**命令(file-io / link-check / scope-check)的参数由
42
- * lib/app/command-registry.js 的 params 校验,与本表无关;本侧 HELP 写了的 flag 必须在本表出现。 */
43
- export const KNOWN_FLAGS = [
44
- '--allowlist', '--files', '--full', '--history', '--include-ignored', '--json', '--out', '--prefix', '--readme',
45
- '--repo', '--root', '--ruleset', '--since', '--skip-empty', '--top-level-must-be-empty', '--until', '--weights',
46
- '--write', '--write-only',
47
- ];
48
-
49
- const HELP = `audit-sluice v${VERSION} — ${CLI_ENTRIES[CLI_AUDIT].intro}
50
-
51
- 快速开始(第一次用——不用查源码):
52
- audit-sluice audit . ① 审计当前仓库(默认只看本次改动)
53
- audit-sluice audit . --full ② 全量审计(评分 + 问题明细)
54
- audit-sluice ruleset ③ 规则包是否能编译(改规则后先跑它)
55
- audit-sluice help 全部命令与参数
56
-
57
- 其它 CLI(本入口不含,敲错会给出替代命令):
58
- git-sluice 提交/推送/克隆/账号/仓库扫描: scan commit clone remote-create rename set-visibility identity-rewrite account-check cred-env gen-ssh-key git api repos index npm-publish unpublish
59
- tool-sluice 工具链: module-splitter yaml-template readme-template self-check
60
-
61
- 用法(每行写的参数就是该命令真实接受的写法,照抄即可):
62
- audit-sluice version 查看版本
63
- audit-sluice audit <root> [--full] [--ruleset <目录>] [--weights <JSON>] [--include-ignored] [--history [--since <提交>] [--until <提交>] [--out <目录>]] [--json]
64
- 审计目录(默认 diff 范围;--full=全量;--ruleset=自定规则目录;--weights=权重覆盖 JSON;
65
- --include-ignored=连 .gitignore 忽略的文件也扫描;--history=历史提交审计——逐提交快照全量审计并落盘报告,
66
- --since/--until 起始~结束提交(皆缺省=全部历史、含两端),--out 报告保存目录(缺省=git 根 audit-history/))
67
- audit-sluice ruleset [槽位...] 编译规则包并输出统计(默认全部槽位)
68
- audit-sluice file-io [路径] [--write-only]
69
- 文件读写调用扫描(同步 I/O 在异步路径会阻塞;写/删/改名涉及数据安全);--write-only=只看写操作。
70
- 按类型/操作/风险分组的明细走 code_audit 工具的 io_scan 结果
71
- audit-sluice link-check <路径> 检查 md/文本中的链接有效性(只 warning,flaky 域名打折)
72
- audit-sluice scope-check [文件...] [--files <文件,文件>] [--repo <目录>] [--prefix <前缀>] [--allowlist <名,名>] [--top-level-must-be-empty] [--json]
73
- 拼接产物作用域撞名(多段 JS 拼进同一作用域):同一函数帧内重名会让后者静默顶掉前者,运行期毫无线索;
74
- 判定按真实作用域帧(两个不同函数里的同名局部变量不算撞名);顶层声明与命名前缀按被查项目自己的 package.json(dshScopeCheck)判定,
75
- 没声明就只查同帧重名(不拿本项目的命名前缀去要求别人);不给文件时取该项目 dshScopeCheck.files
76
- audit-sluice functions <analyze|apply> [目录] [--skip-empty] [--json]
77
- 函数索引与函数文档:analyze 生成 functions-index.json(含签名/注释槽位);
78
- apply 读 JSON(人工补 comment 后)生成 docs/函数 下的 md(文件删除归档 _archived,注释不丢)
79
- audit-sluice tree-doc <sync|gen|check|apply> [--root <目录>] [--readme <路径>] [--write]
80
- README 目录结构维护:sync 索引同步(新增自动加键/删除自动删键);gen 生成树;
81
- check 检查漂移;apply 覆盖 README/FILE-TREE 标记块(封装 scripts/doc-tree.mjs)
82
- audit-sluice help 显示本帮助
83
- `;
84
-
85
- /** 子命令:ruleset — 编译规则包输出统计(依赖本文件顶部的 compilers 副作用 import)。 */
86
- export function cmdRuleset(slots = []) {
87
- const order = slots.length ? slots : null; // null=动态发现全部槽位
88
- const { ok, merged, errors, files, order: effective } = loadRuleFiles(order);
89
- const ctx = { errors: [] };
90
- const compiled = compileAllRules(merged.rules, ctx);
91
- if (!ok || ctx.errors.length) {
92
- console.error('规则编译失败:');
93
- for (const failure of [...errors, ...ctx.errors]) console.error(' ✗ ' + failure);
94
- process.exitCode = 1;
95
- return;
96
- }
97
- console.log(`规则包编译 OK(${effective.join('+')})`);
98
- console.log(` 文件: ${files.length} 个槽位, 规则条目 ${merged.rules.length}, 编译成功 ${compiled.length}`);
99
- const byKind = {};
100
- for (const rule of compiled) {
101
- const kind = rule.kind || rule.type || 'other';
102
- byKind[kind] = (byKind[kind] || 0) + 1;
103
- }
104
- for (const [kind, count] of Object.entries(byKind)) console.log(` ${kind}: ${count}`);
105
- }
106
-
107
- /** 命令表(本侧独有的 COMMANDS;注册表驱动的 file-io / link-check / scope-check 由 shared 分发)。 */
108
- export const COMMANDS = new Map([
109
- ['ruleset', (rest) => cmdRuleset(rest)],
110
- // audit 不走注册表——CLI 独立审计需完整 findings(不依赖宿主 API);工具 code_audit 输出 API 指引
111
- ['audit', parseVia((flags, positional) => cmdAudit(positional[0] || '.', flags))],
112
- ['functions', parseVia((flags, positional) => cmdFunctions(positional[0] || '', positional[1] || '', flags))],
113
- ['tree-doc', parseVia((flags, positional) => cmdTreeDoc(positional[0] || '', flags))],
114
- // 兼容:scan 属于 git 侧(注册表 git_scan);此处保留导出给老代码直调,不注册进命令表
115
- ]);
116
-
117
- /**
118
- * 入口 main。
119
- * @param {string[]} argv
120
- * @returns {Promise<number|undefined>}
121
- */
122
- export async function main(argv = process.argv.slice(2)) {
123
- return await runCli({
124
- cliName: CLI_AUDIT,
125
- argv,
126
- commands: COMMANDS,
127
- helpText: HELP,
128
- getConfig: cliPluginConfig,
129
- });
130
- }
131
-
132
- runAsEntry(import.meta.url, main);
133
-
134
- // 兼容导出(审计侧实现的老引用路径)
135
- export { cmdAudit, cmdScan, cmdLinkCheck, cmdFileIo, cmdTreeDoc, cmdFunctions };
136
- export { pluginEqualAuditOpts, pluginEqualWeights, cliPluginConfig, parseArgv, printToolResult };
137
-
138
- /** 子命令:version(三入口同一实现,只有名字不同)。 */
139
- export function cmdVersion() {
140
- console.log(`audit-sluice v${VERSION} — dsh-git-push(统一函数入口架构)`);
141
- }
@@ -1,173 +0,0 @@
1
- /**
2
- * 审计结果 API 聚合层
3
- *
4
- * 为 `/api/git-push/audit` 端点提供「请求时自定义聚合」:
5
- * · 维度:rule(警告类型)/ file(文件名)/ severity / slot(规则包)
6
- * · 过滤:severity 白名单(逗号分隔)
7
- * · 条数:top 截断(每组最多列前 N 条,0=全部)
8
- * · 明细:withFindings=true 时附完整 findings
9
- *
10
- * 纯函数设计:findings 进、聚合出,不碰 I/O,便于单测。
11
- * 与 auditFull/auditWithScope 解耦——本层只消费它们的返回。
12
- */
13
- import { buildRuleSlotMap } from '../audit/slot.js';
14
- import { isBlockerFinding } from '../audit/index.js';
15
- import { MAX_MSG_PREVIEW } from './constants.js';
16
- import { probeRepoOwnership } from './repo-ownership.js';
17
-
18
- /** 支持的聚合维度(非法值回落 rule)。 */
19
- export const GROUP_BY_KEYS = ['rule', 'file', 'severity', 'slot'];
20
- // 豁免类型前缀(exemptHint 形态 dsh-skip-<type>(范围)——统计按类型分组)
21
- const EXEMPT_TYPE_RE = /dsh-skip-([a-z-]+)/; // 无 /g:exec 有 lastIndex 状态(多次调用错位)
22
-
23
- /**
24
- * 豁免类型统计(每次审计后输出「本次被豁免的类型与数量」——
25
- * 审计透明性:dsh-skip-quality/residue/sensitive/size 各豁免多少条)。
26
- * @param {Array} findings audit findings(含 exemptHint)
27
- * @returns {{ types: Record<string, number>, total: number }}
28
- */
29
- export function exemptStatsOf(findings = []) {
30
- const types = {};
31
- let total = 0;
32
- // 「已确认豁免」(.auditignore 的「路径 : 规则」):与上面的「可选豁免标记」分开统计——
33
- // 前者是**已经生效**的豁免(不扣分),后者只是「可以写哪个标记」,混在一起会让人误判。
34
- const applied = {};
35
- let appliedTotal = 0;
36
- for (const f of findings) {
37
- if (f?.exempted) {
38
- appliedTotal += 1;
39
- const key = String(f.rule || '(未知规则)');
40
- applied[key] = (applied[key] || 0) + 1;
41
- continue;
42
- }
43
- const hint = String(f?.exemptHint || '');
44
- if (!hint) continue;
45
- total += 1;
46
- const matched = EXEMPT_TYPE_RE.exec(hint);
47
- if (matched) {
48
- const t = matched[1];
49
- types[t] = (types[t] || 0) + 1;
50
- } else {
51
- types.other = (types.other || 0) + 1;
52
- }
53
- }
54
- return { types, total, applied, appliedTotal };
55
- }
56
-
57
- /** finding 对象聚合键提取(slot 维度用 ruleSlotMap 把 rule id 归到规则包)。 */
58
- function groupKeyOf(finding, groupBy, ruleSlotMap) {
59
- if (groupBy === 'file') return String(finding.file || '(未知文件)');
60
- if (groupBy === 'severity') return String(finding.severity || 'notice');
61
- if (groupBy === 'slot') return ruleSlotMap.get(finding.rule) || '未归类';
62
- return String(finding.rule || '(未知规则)');
63
- }
64
-
65
- /**
66
- * 解析 severity 过滤参数:「warning,blocker」→ ['warning','blocker'];
67
- * 空/非法 → null(不过滤)。
68
- */
69
- export function parseSeverityFilter(raw) {
70
- if (!raw) return null;
71
- const list = String(raw).split(',').map((s) => s.trim().toLowerCase()).filter(Boolean);
72
- return list.length ? [...new Set(list)] : null;
73
- }
74
-
75
- /**
76
- * 按指定维度聚合 findings。
77
- * @param {Array} findings audit findings(含 rule/severity/file)
78
- * @param {object} opts { groupBy='rule', severityFilter=null, top=0, ruleSlotMap=Map }
79
- * @returns {{groups: Array<{key, count, sample?: object}>, total: number, filtered: number}}
80
- * groups 按 count 降序;severity 过滤后 filtered=通过过滤的条数。
81
- */
82
- export function aggregateFindings(findings = [], opts = {}) {
83
- const groupBy = GROUP_BY_KEYS.includes(opts.groupBy) ? opts.groupBy : 'rule';
84
- const top = Number(opts.top) > 0 ? Math.floor(Number(opts.top)) : 0;
85
- const severityFilter = parseSeverityFilter(opts.severityFilter);
86
- const ruleSlotMap = opts.ruleSlotMap instanceof Map ? opts.ruleSlotMap : new Map();
87
-
88
- const buckets = new Map();
89
- let filtered = 0;
90
- for (const f of findings) {
91
- if (severityFilter && !severityFilter.includes(String(f.severity || 'notice').toLowerCase())) continue;
92
- filtered++;
93
- const key = groupKeyOf(f, groupBy, ruleSlotMap);
94
- if (!buckets.has(key)) buckets.set(key, { key, count: 0, sample: null });
95
- const b = buckets.get(key);
96
- b.count++;
97
- if (!b.sample) b.sample = { rule: f.rule, severity: f.severity, file: f.file, line: f.line, message: f.message };
98
- }
99
-
100
- let groups = [...buckets.values()].sort((a, b2) => b2.count - a.count || String(a.key).localeCompare(String(b2.key)));
101
- if (top > 0) groups = groups.slice(0, top);
102
- return { groups, total: findings.length, filtered };
103
- }
104
-
105
- /**
106
- * 执行审计并聚合(HTTP 端点用)。
107
- * @param {string} repo 仓库根
108
- * @param {object} params { scope='full', groupBy='rule', severity='', top=0, withFindings=false, rulesetDir='', maxScanFiles=0, slots, disabledSlots, includeIgnored=false, weights={} }
109
- * @param {object} cfg 插件配置(auditRuleOrder / auditDisabledSlots)
110
- */
111
- export async function runAuditApi(repo, params = {}, cfg = {}) {
112
- const { auditFull, auditWithScope } = await import('../audit/index.js');
113
- const { scoreQuality } = await import('../score/index.js');
114
- const scope = params.scope === 'diff' ? 'diff' : 'full';
115
- const auditOpts = {
116
- ownership: probeRepoOwnership(repo), // 隐私规则只对自有仓库生效(审计层只消费该字符串)
117
- scope,
118
- rulesetDir: params.rulesetDir || '',
119
- maxScanFiles: params.maxScanFiles ?? cfg.maxScanFiles ?? 0,
120
- slots: undefined, // auditRuleOrder 是「加载顺序」不是白名单 ✗(详见 lib/commit-push.js 注释;禁用槽位用 auditDisabledSlots ✓)
121
- disabledSlots: Array.isArray(cfg.auditDisabledSlots) ? cfg.auditDisabledSlots : [],
122
- includeIgnored: params.includeIgnored === true,
123
- };
124
- const auditResult = scope === 'diff'
125
- ? await auditWithScope(repo, auditOpts)
126
- : await auditFull(repo, auditOpts);
127
-
128
- const { summarize } = await import('../audit/index.js');
129
- const summary = summarize(auditResult.findings);
130
- const quality = scoreQuality(auditResult.findings, params.weights || {}, { files: auditResult.files, dimFileCounts: auditResult.dimFileCounts, dimRuleCounts: auditResult.dimRuleCounts });
131
- // slot 归属映射(groupBy=slot 用):与 auditFiles 同源加载规则构建映射——
132
- // 审计返回不带 compiled,这里按相同 slots/disabledSlots 重新编译一次。
133
- let ruleSlotMap = new Map();
134
- if (params.groupBy === 'slot') {
135
- try {
136
- const { loadRuleFiles } = await import('../rule/loader.js');
137
- const { compileAllRules } = await import('../rule/registry.js');
138
- const loaded = loadRuleFiles(auditOpts.slots, { dir: auditOpts.rulesetDir, disabledSlots: auditOpts.disabledSlots });
139
- ruleSlotMap = buildRuleSlotMap(compileAllRules(loaded.merged.rules, { errors: [] }));
140
- } catch { /* slot 映射构建失败退化为空 Map(该维度归「未归类」) */ }
141
- }
142
-
143
- const agg = aggregateFindings(auditResult.findings, {
144
- groupBy: params.groupBy,
145
- severityFilter: params.severity,
146
- top: params.top,
147
- ruleSlotMap,
148
- });
149
-
150
- const out = {
151
- ok: true,
152
- repo,
153
- scope: auditResult.scope || scope,
154
- files: auditResult.files,
155
- summary,
156
- quality: quality.emptyResult ? null : { score: quality.score, level: quality.level },
157
- groups: agg.groups,
158
- total: agg.total,
159
- filtered: agg.filtered,
160
- // 豁免类型统计(本次被豁免的类型与数量)+ 可用聚合类型(groupBy 维度)+
161
- // 拦截列表(blocker findings 直接输出——被拦文件/规则,不用再查明细)
162
- exemptStats: exemptStatsOf(auditResult.findings),
163
- groupByTypes: GROUP_BY_KEYS,
164
- blocked: auditResult.findings
165
- // 统一口径:error 也属拦截级(与 summarize 一致)——此前只筛 'blocker',
166
- // 导致「summary.blocker(10) vs 枚举(7)」差额(差的正是 3 条 error 级)✗
167
- .filter(isBlockerFinding)
168
- .map((f) => ({ file: f.file, line: f.line, rule: f.rule, message: String(f.message || '').slice(0, MAX_MSG_PREVIEW) })),
169
- };
170
- if (params.withFindings === true) out.findings = auditResult.findings;
171
- if (params.withYaml === true) out.yaml = auditResult.yaml;
172
- return out;
173
- }
@@ -1,25 +0,0 @@
1
- /**
2
- * 宿主文档漂移检查器的接线模块(审计包边界,2026-10-13)。
3
- *
4
- * 边界规则:`lib/audit/**` 与 `lib/core/**` 不得 import 仓库脚本(`scripts/**`)——
5
- * 「目录树漂移 / 函数列表漂移」这两个检查器属于**宿主侧**能力,由宿主在加载时注入给审计(见
6
- * lib/audit/orchestrate.js 的 setHostDocChecks)。
7
- *
8
- * 用法:宿主入口加一行 `import '<相对路径>/host-doc-checks.js';` 即完成接线(本模块导入即安装,幂等)。
9
- * 当前三处宿主入口:lib/app/tool-call.js(插件工具调用)、lib/commit-push.js(提交门禁)、cli.mjs(独立 CLI)。
10
- * 未接线的环境(例如别人只依赖审计子路径):审计自动跳过这两类漂移 finding,其余检查不受影响。
11
- */
12
- import { checkDrift, findMarkedHostMd } from '../../scripts/doc-tree.mjs';
13
- import { checkFuncDrift } from '../../scripts/doc-func.mjs';
14
- import { setHostDocChecks } from '../audit/orchestrate.js';
15
-
16
- /** 本宿主提供的检查器集合(供测试直接比对)。 */
17
- export const HOST_DOC_CHECKS = { checkDrift, findMarkedHostMd, checkFuncDrift };
18
-
19
- /** 显式接线(默认已由模块导入自动执行;单独调用用于测试或自定义注入)。 */
20
- export function installHostDocChecks(checks = HOST_DOC_CHECKS) {
21
- setHostDocChecks(checks);
22
- return true;
23
- }
24
-
25
- installHostDocChecks();