dsh-git-push 2.20.19 → 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 (196) hide show
  1. package/README.md +3 -2
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +7 -1
  4. package/lib/app/apply.js +4 -4
  5. package/lib/app/command-registry.js +22 -17
  6. package/lib/app/handlers/meta.js +2 -2
  7. package/lib/app/handlers/preprocess.js +107 -0
  8. package/lib/app/handlers/repo-actions.js +2 -2
  9. package/lib/app/http-handlers.js +13 -42
  10. package/lib/app/index.js +2 -1
  11. package/lib/app/inject-text.js +3 -3
  12. package/lib/app/preprocess-client.js +136 -0
  13. package/lib/app/repo-ownership.js +1 -1
  14. package/lib/app/schema.js +3 -3
  15. package/lib/app/severity.js +14 -0
  16. package/lib/app/slash-commands.js +5 -164
  17. package/lib/app/tool-call.js +73 -144
  18. package/lib/cli/commands-preprocess.mjs +74 -0
  19. package/lib/cli/commands-tool.mjs +3 -2
  20. package/lib/cli/commands-vcs.mjs +4 -4
  21. package/lib/cli/shared.mjs +35 -9
  22. package/lib/commit-push/pre-commit-engine.js +57 -10
  23. package/lib/commit-push.js +71 -27
  24. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  25. package/lib/git/ignore.js +1 -1
  26. package/lib/git/repos.js +2 -2
  27. package/lib/git/sensitive.js +1 -1
  28. package/lib/npm/publish.js +20 -5
  29. package/lib/plugin/auto-push.js +2 -2
  30. package/lib/preprocess/providers.js +191 -0
  31. package/lib/self/index.js +1 -1
  32. package/lib/skip-dirs.js +14 -55
  33. package/package.json +29 -37
  34. package/scripts/build-client.mjs +2 -0
  35. package/scripts/check.mjs +4 -2
  36. package/scripts/local-registry.mjs +2 -1
  37. package/cli-audit.mjs +0 -141
  38. package/lib/app/audit-api.js +0 -173
  39. package/lib/app/handlers/audit.js +0 -150
  40. package/lib/app/host-doc-checks.js +0 -25
  41. package/lib/app/scope-check.js +0 -69
  42. package/lib/ast/brace.js +0 -120
  43. package/lib/ast/callgraph.js +0 -135
  44. package/lib/ast/code-lines.js +0 -175
  45. package/lib/ast/consts.js +0 -12
  46. package/lib/ast/control-flow.js +0 -470
  47. package/lib/ast/credential.js +0 -315
  48. package/lib/ast/dataflow.js +0 -391
  49. package/lib/ast/dup-code.js +0 -165
  50. package/lib/ast/fs-hotspots.js +0 -154
  51. package/lib/ast/index.js +0 -38
  52. package/lib/ast/io-risk-const.js +0 -95
  53. package/lib/ast/io-risk-fn.js +0 -208
  54. package/lib/ast/io-risk-loop.js +0 -308
  55. package/lib/ast/io-risk.js +0 -314
  56. package/lib/ast/lang.js +0 -156
  57. package/lib/ast/line-count.js +0 -52
  58. package/lib/ast/magic-number.js +0 -272
  59. package/lib/ast/naming.js +0 -292
  60. package/lib/ast/perf.js +0 -488
  61. package/lib/ast/scope-collisions.js +0 -228
  62. package/lib/ast/scope.js +0 -241
  63. package/lib/ast/shell.js +0 -131
  64. package/lib/ast/size.js +0 -448
  65. package/lib/ast/symbol-index.js +0 -399
  66. package/lib/ast/tokenizer.js +0 -421
  67. package/lib/ast/treesitter.js +0 -413
  68. package/lib/audit/analysis-coverage.js +0 -98
  69. package/lib/audit/audit-file.js +0 -205
  70. package/lib/audit/auditignore-rules.js +0 -148
  71. package/lib/audit/checks.js +0 -17
  72. package/lib/audit/client-entry.js +0 -93
  73. package/lib/audit/collector.js +0 -610
  74. package/lib/audit/ext-runner.js +0 -80
  75. package/lib/audit/file-context.js +0 -391
  76. package/lib/audit/finding.js +0 -101
  77. package/lib/audit/gitignore-match.js +0 -113
  78. package/lib/audit/glob.js +0 -63
  79. package/lib/audit/history-report.js +0 -100
  80. package/lib/audit/history.js +0 -126
  81. package/lib/audit/ignore-blind.js +0 -102
  82. package/lib/audit/index.js +0 -33
  83. package/lib/audit/orchestrate.js +0 -672
  84. package/lib/audit/public.js +0 -24
  85. package/lib/audit/repo-level.js +0 -30
  86. package/lib/audit/report-yaml.js +0 -90
  87. package/lib/audit/scope-policy.js +0 -110
  88. package/lib/audit/slot.js +0 -66
  89. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  90. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  91. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  92. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  93. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  94. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  95. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  96. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  97. package/lib/audit-rules/audit-rules-go.yml +0 -103
  98. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  99. package/lib/audit-rules/audit-rules-java.yml +0 -105
  100. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  101. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  102. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  103. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  104. package/lib/audit-rules/audit-rules-php.yml +0 -101
  105. package/lib/audit-rules/audit-rules-private.yml +0 -24
  106. package/lib/audit-rules/audit-rules-python.yml +0 -106
  107. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  108. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  109. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  110. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  111. package/lib/audit-rules/audit-rules-template.yml +0 -108
  112. package/lib/audit-ui-sdk/contract.js +0 -117
  113. package/lib/audit-ui-sdk/index.js +0 -17
  114. package/lib/checks/button-bind.js +0 -347
  115. package/lib/checks/common.js +0 -170
  116. package/lib/checks/credential-file.js +0 -43
  117. package/lib/checks/dataflow.js +0 -40
  118. package/lib/checks/dispatch.js +0 -117
  119. package/lib/checks/dup-code.js +0 -69
  120. package/lib/checks/dup-const.js +0 -232
  121. package/lib/checks/file-health.js +0 -150
  122. package/lib/checks/filter.js +0 -137
  123. package/lib/checks/folder.js +0 -173
  124. package/lib/checks/fs-scanner.js +0 -57
  125. package/lib/checks/hardcoded-path.js +0 -98
  126. package/lib/checks/index.js +0 -49
  127. package/lib/checks/io.js +0 -66
  128. package/lib/checks/magic-number.js +0 -42
  129. package/lib/checks/npm-json.js +0 -273
  130. package/lib/checks/private.js +0 -64
  131. package/lib/checks/regex.js +0 -298
  132. package/lib/checks/scope-collision.js +0 -68
  133. package/lib/checks/semantic.js +0 -134
  134. package/lib/checks/structural.js +0 -281
  135. package/lib/cli/commands-audit.mjs +0 -142
  136. package/lib/cli/commands-doc.mjs +0 -127
  137. package/lib/client-parts/audit/audit.js +0 -301
  138. package/lib/exempt/tool.js +0 -198
  139. package/lib/git/module-splitter.js +0 -47
  140. package/lib/link-check/index.js +0 -187
  141. package/lib/lint-adapter/detect.js +0 -161
  142. package/lib/lint-adapter/index.js +0 -50
  143. package/lib/lint-adapter/runner.js +0 -133
  144. package/lib/preprocess/audit.js +0 -98
  145. package/lib/preprocess/index.js +0 -78
  146. package/lib/rule/compilers/credential.js +0 -62
  147. package/lib/rule/compilers/dataflow.js +0 -38
  148. package/lib/rule/compilers/file-health.js +0 -75
  149. package/lib/rule/compilers/frontend.js +0 -86
  150. package/lib/rule/compilers/func.js +0 -35
  151. package/lib/rule/compilers/helpers.js +0 -71
  152. package/lib/rule/compilers/index.js +0 -29
  153. package/lib/rule/compilers/link-semantic.js +0 -45
  154. package/lib/rule/compilers/list-kinds.js +0 -12
  155. package/lib/rule/compilers/numeric-kinds.js +0 -73
  156. package/lib/rule/compilers/regex.js +0 -78
  157. package/lib/rule/compilers/structure.js +0 -107
  158. package/lib/rule/compilers.js +0 -17
  159. package/lib/rule/homoglyph.js +0 -45
  160. package/lib/rule/loader.js +0 -274
  161. package/lib/rule/registry.js +0 -122
  162. package/lib/rule/scope.js +0 -67
  163. package/lib/score/docs-score.js +0 -166
  164. package/lib/score/index.js +0 -234
  165. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  166. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  167. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  168. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  169. package/scripts/audit-gate.mjs +0 -235
  170. package/scripts/audit-runner.mjs +0 -35
  171. package/scripts/audit-runtime-check.mjs +0 -129
  172. package/scripts/browser-page-probe.mjs +0 -271
  173. package/scripts/check-js-scope.mjs +0 -87
  174. package/scripts/clean-date-comments.py +0 -102
  175. package/scripts/cpu-sample.mjs +0 -188
  176. package/scripts/doc-drift.mjs +0 -200
  177. package/scripts/hot-path-probe-cjs.cjs +0 -71
  178. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  179. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  180. package/scripts/hot-path-probe.mjs +0 -153
  181. package/scripts/module-splitter.py +0 -800
  182. package/scripts/picker-repro.mjs +0 -115
  183. package/scripts/platform-scan.mjs +0 -168
  184. package/scripts/probe-recheck.mjs +0 -47
  185. package/scripts/rename-locator.mjs +0 -97
  186. package/scripts/rule-switch.mjs +0 -97
  187. package/scripts/rules-solo-audit.mjs +0 -173
  188. package/scripts/scan-file-io.mjs +0 -717
  189. package/scripts/scan-fs-hotspots.mjs +0 -107
  190. package/scripts/symbol-index.mjs +0 -85
  191. package/scripts/verify-prestep.mjs +0 -100
  192. package/skills/dev/audit-rule-authoring.md +0 -58
  193. package/skills/guide/guide-audit.md +0 -270
  194. /package/lib/{audit → app}/ownership.js +0 -0
  195. /package/lib/app/{schema-audit.js → schema-preprocess.js} +0 -0
  196. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
@@ -1,209 +0,0 @@
1
- /**
2
- * DSH 插件审计扩展:inject 声明与导出面。
3
- *
4
- * 与 dsh-useful-tools 的 verify_plugin(lib/core/verify-plugin/dsh-rules.mjs)**同源规则、独立实现**:
5
- * 两个插件不互相 import,各自维护判定逻辑;规则增删改要两边同步(见 useful-tools 的 CONTRACT C-114)。
6
- *
7
- * 为什么用扩展脚本而不是 YAML 正则:这两条都需要**跨行读 inject 声明**(`export const inject = [...]`),
8
- * 纯逐行正则做不到 —— 只能看「有没有 ctx.xxx」,无法判断 xxx 是否已经声明。
9
- *
10
- * 两条规则:
11
- * dsh/ctx-service-not-injected (blocker)访问 ctx.<服务> 但 inject 没声明该服务
12
- * dsh/plugin-default-export-hides-inject(blocker)入口同时有 default 与命名 inject/apply
13
- */
14
- import { readdirSync, readFileSync, statSync } from 'node:fs';
15
- import { extname, join, relative } from 'node:path';
16
-
17
- /** 参与扫描的扩展名。 */
18
- const JS_EXTS = new Set(['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts']);
19
- /** 不扫描的目录(第三方依赖、产物、测试夹具、回收站)。 */
20
- const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.trash', 'test', 'tests', 'audit-history']);
21
- /** 扫描上限:单仓库最多看这么多文件,避免大仓拖慢审计。 */
22
- const MAX_FILES = 400;
23
- /** 单文件大小上限。 */
24
- const MAX_FILE_BYTES = 512 * 1024;
25
-
26
- /**
27
- * cordis Context 自身的内建成员(不是"服务"):访问它们不需要 inject 声明。
28
- * 只收确定不会误伤的:事件 API、effect、logger、依赖注入原语、fiber/scope 等。
29
- */
30
- const CORDIS_BUILTIN_MEMBERS = new Set([
31
- 'on', 'once', 'off', 'emit', 'effect', 'logger', 'inject', 'plugin', 'get', 'set', 'provide',
32
- 'accessor', 'root', 'scope', 'fiber', 'reflect', 'registry', 'runtime', 'dispose', 'extend',
33
- 'isolate', 'waterfall', 'bail', 'parallel', 'serial', 'ctx', 'setTimeout', 'clearTimeout',
34
- 'setInterval', 'clearInterval', 'name', 'config', 'options', 'state',
35
- ]);
36
-
37
- /** 已知的「错误字段名」:不是 cordis 服务,由 YAML 规则 dsh/ctx-undeclared-property-read 负责。 */
38
- const KNOWN_BAD_CTX_FIELDS = new Set([
39
- 'sessionId', 'sessionID', 'conversationId', 'agentId', 'workspaceRoot', 'dshHome', 'DSH_HOME',
40
- ]);
41
-
42
- /**
43
- * 真实存在、通过 ctx 暴露的 cordis 服务(保守清单)。
44
- * 为什么需要:`ctx` 是极常见的参数名——HTTP 请求、工具执行上下文、遍历累加器都可能叫 ctx,
45
- * 只靠 `ctx.xxx` 的写法无法区分语义(实测:真实插件被误报 20 条 / 仓库)。只报清单里的服务名。
46
- */
47
- const KNOWN_CORDIS_SERVICES = new Set([
48
- 'tools', 'fs', 'sessions', 'llm', 'credentials', 'webServer', 'slots', 'locale',
49
- 'storageDomain', 'workspaceRegistry', 'commands', 'sandbox', 'models', 'settings',
50
- 'jobs', 'subagents', 'skills', 'schedule', 'terminals', 'systemPrompt', 'spillStore',
51
- 'pluginManager', 'pluginInventory', 'approval', 'sessionQuery', 'agentLoop',
52
- ]);
53
-
54
- /** 该文件是不是插件入口:只有入口手里那个 ctx 才确定是 cordis Context。 */
55
- function isPluginEntry(text) {
56
- return /export\s+(async\s+)?function\s+apply\b/.test(text)
57
- || /export\s+const\s+inject\b/.test(text);
58
- }
59
-
60
- /** 递归列待扫描的 JS 文件(相对仓库根的路径)。 */
61
- function collectFiles(repo) {
62
- const out = [];
63
- const walk = (dir) => {
64
- if (out.length >= MAX_FILES) return;
65
- let entries;
66
- try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
67
- for (const entry of entries) {
68
- if (out.length >= MAX_FILES) return;
69
- if (SKIP_DIRS.has(entry.name)) continue;
70
- const full = join(dir, entry.name);
71
- if (entry.isDirectory()) { walk(full); continue; }
72
- if (!JS_EXTS.has(extname(entry.name))) continue;
73
- try { if (statSync(full).size > MAX_FILE_BYTES) continue; } catch { continue; }
74
- out.push({ abs: full, rel: relative(repo, full).replace(/\\/g, '/') });
75
- }
76
- };
77
- walk(repo);
78
- return out;
79
- }
80
-
81
- /**
82
- * 取 `export const inject = [...]` 声明的服务名。
83
- * 用括号配对而非单行正则:兼容多行数组与 `[{ required: [...], optional: [...] }]` 形态。
84
- */
85
- function declaredInjectNames(text) {
86
- const names = new Set();
87
- const anchor = /export\s+const\s+inject\s*=\s*/.exec(text);
88
- if (!anchor) return names;
89
- const start = anchor.index + anchor[0].length;
90
- let depth = 0;
91
- let end = -1;
92
- for (let i = start; i < text.length; i += 1) {
93
- const ch = text[i];
94
- if (ch === '[' || ch === '{') depth += 1;
95
- else if (ch === ']' || ch === '}') {
96
- depth -= 1;
97
- if (depth === 0) { end = i; break; }
98
- } else if (ch === ';' && depth === 0) { end = i; break; }
99
- }
100
- const block = text.slice(start, end === -1 ? Math.min(start + 600, text.length) : end + 1);
101
- for (const quoted of block.matchAll(/['"`]([^'"`]+)['"`]/g)) names.add(quoted[1]);
102
- return names;
103
- }
104
-
105
- /** 去掉行内注释,保留字符串内容(字符串里的 `//` 不能当注释起点)。 */
106
- function stripTrailingComment(line) {
107
- let out = '';
108
- let quote = '';
109
- for (let i = 0; i < line.length; i += 1) {
110
- const ch = line[i];
111
- if (quote) {
112
- out += ch;
113
- if (ch === '\\') { out += line[i + 1] || ''; i += 1; continue; }
114
- if (ch === quote) quote = '';
115
- continue;
116
- }
117
- if (ch === "'" || ch === '"' || ch === '`') { quote = ch; out += ch; continue; }
118
- if (ch === '/' && line[i + 1] === '/') break;
119
- if (ch === '/' && line[i + 1] === '*') {
120
- const close = line.indexOf('*/', i + 2);
121
- if (close < 0) break;
122
- i = close + 1;
123
- out += ' ';
124
- continue;
125
- }
126
- out += ch;
127
- }
128
- return out;
129
- }
130
-
131
- /** 规则 A:访问 ctx.<服务> 但没在 inject 里声明。返回命中行号数组。 */
132
- function ctxServiceNotInjectedHits(text) {
133
- // 只在插件入口检查:非入口文件里的 ctx 多半是别的语义(HTTP 请求 / 工具上下文 / 累加器),
134
- // 逐一判断不了,宁可漏报也不误报。
135
- if (!isPluginEntry(text)) return [];
136
- const declared = declaredInjectNames(text);
137
- const hits = [];
138
- const lines = text.split('\n');
139
- for (let i = 0; i < lines.length; i += 1) {
140
- const raw = lines[i];
141
- if (/^\s*(\/\/|\*|\/\*)/.test(raw)) continue;
142
- const code = stripTrailingComment(raw);
143
- if (!code.includes('ctx')) continue;
144
- for (const match of code.matchAll(/\bctx\s*\??\.\s*([A-Za-z_$][\w$]*)/g)) {
145
- const member = match[1];
146
- if (CORDIS_BUILTIN_MEMBERS.has(member)) continue;
147
- if (KNOWN_BAD_CTX_FIELDS.has(member)) continue;
148
- if (!KNOWN_CORDIS_SERVICES.has(member)) continue;
149
- if (declared.has(member)) continue;
150
- hits.push({ line: i + 1, text: raw.trim().slice(0, 200) });
151
- break;
152
- }
153
- }
154
- return hits;
155
- }
156
-
157
- /** 规则 B:同时有 export default 与命名 inject/apply(DSH 取 default 后命名导出失效)。 */
158
- function defaultExportConflictLine(text) {
159
- const hasDefault = /(^|\n)\s*export\s+default\b/.test(text);
160
- const hasNamedInject = /(^|\n)\s*export\s+(const|let|var)\s+inject\b/.test(text);
161
- const hasNamedApply = /(^|\n)\s*export\s+(async\s+)?function\s+apply\b/.test(text);
162
- if (!hasDefault || !(hasNamedInject || hasNamedApply)) return 0;
163
- const lines = text.split('\n');
164
- for (let i = 0; i < lines.length; i += 1) {
165
- if (/^\s*(\/\/|\*|\/\*)/.test(lines[i])) continue;
166
- if (/(^|\n)\s*export\s+default\b/.test(lines[i])) return i + 1;
167
- }
168
- return 1;
169
- }
170
-
171
- export const auditExt = {
172
- name: 'dsh-inject-declarations',
173
- match: (repo) => Boolean(repo && repo !== '.'),
174
- run: async (repo) => {
175
- const findings = [];
176
- for (const file of collectFiles(repo)) {
177
- let text = '';
178
- try { text = readFileSync(file.abs, 'utf8'); } catch { continue; }
179
-
180
- for (const hit of ctxServiceNotInjectedHits(text)) {
181
- findings.push({
182
- file: file.rel,
183
- line: hit.line,
184
- rule: 'dsh/ctx-service-not-injected',
185
- severity: 'blocker',
186
- scoreImpact: 0,
187
- message: '访问 ctx 上未 inject 的服务:cordis 会直接抛 cannot get property … without inject,插件整条不激活;'
188
- + '需模块级 export const inject = [\'服务名\'],或改用 ctx.get(\'服务名\')',
189
- dimensions: ['健壮性'],
190
- });
191
- }
192
-
193
- const conflictLine = defaultExportConflictLine(text);
194
- if (conflictLine) {
195
- findings.push({
196
- file: file.rel,
197
- line: conflictLine,
198
- rule: 'dsh/plugin-default-export-hides-inject',
199
- severity: 'blocker',
200
- scoreImpact: 0,
201
- message: '入口同时存在 export default 与命名 inject/apply:DSH 装载取 module.default || module,'
202
- + '有 default 时命名 inject/name 全部失效 ⇒ 访问服务直接抛错、插件不激活;入口只保留命名导出',
203
- dimensions: ['健壮性'],
204
- });
205
- }
206
- }
207
- return findings;
208
- },
209
- };
@@ -1,102 +0,0 @@
1
- /**
2
- * 审计扩展:variable-min-length(试点——内置审计规则抽出为独立脚本,统一动态入口)
3
- *
4
- * 试点:audit-rules-nodejs.yml 的 readability/variable-min-length 标 external: true
5
- * ——内置执行链停跑(groupByKind 过滤),本脚本经 runAuditExt 统一加载(auditFull 自动并入)。
6
- * 复用 lib/ast 检查器函数(checkNameLengthAst)——实现不重复,仅换执行载体。
7
- * findings 格式与内置 checkMinLength 对齐(file 相对路径 / severity warning / scoreImpact 0)。
8
- */
9
-
10
- export const auditExt = {
11
- name: 'variable-min-length',
12
- match: (repo) => Boolean(repo && repo !== '.'),
13
- run: async (repo) => {
14
- const { checkNameLengthAst } = await import('../../lib/ast/naming.js');
15
- // external 规则此前是「写了字段也不生效」:run(repo, opts) 只收到仓库路径,收不到规则对象,
16
- // 于是 min 硬编码 2、yml 里声明的 exceptions 形同虚设(自审实测:i/j/k/n/e/cb 若真出现也会报)。
17
- // 编排层调用契约改动面大,改为**脚本自己按 external 名查自己的规则**(自包含、不影响其它 ext),
18
- // 让 yml 声明的 min_length / exceptions / exclude_paths 真正生效。
19
- let rule = null;
20
- try {
21
- const { discoverRuleSlots, loadRuleFiles } = await import('../../lib/rule/loader.js');
22
- const slots = discoverRuleSlots().map((s) => s.name || s);
23
- const merged = loadRuleFiles(slots).merged || {};
24
- rule = (merged.rules || []).find((r) => String(r.external || r.external === true ? (r.external === true ? '' : r.external) : '') === 'variable-min-length') || null;
25
- } catch { rule = null; }
26
- const minLength = Number.isFinite(Number(rule?.min_length)) ? Number(rule.min_length) : 2;
27
- const allow = Array.isArray(rule?.exceptions) ? rule.exceptions.map(String) : [];
28
- const excludePaths = Array.isArray(rule?.exclude_paths) ? rule.exclude_paths.map(String) : [];
29
- const isExcludedPath = (rel) => {
30
- if (!excludePaths.length) return false;
31
- const norm = String(rel || '').replace(/\\/g, '/').replace(/^\.?\//, '');
32
- return excludePaths.some((e) => {
33
- const ee = String(e || '').replace(/\\/g, '/').replace(/^\.?\//, '').replace(/\/+$/, '');
34
- return ee && (norm === ee || norm.startsWith(ee + '/'));
35
- });
36
- };
37
- // 修复:external 通道必须带内置的构建/混淆产物豁免(isBuildArtifactFile——
38
- // hash 文件名/单行混淆)——否则单行混淆产物短名密爆(Pawchive hash 产物 5896 条误报)
39
- const { isBuildArtifactFile } = await import('../../lib/audit/audit-file.js');
40
- // 修复:external 通道必须尊重 .gitignore/.auditignore——ext 自 walk 文件
41
- // 不走 collector,此前把被 gitignore 忽略的上游克隆(Pawchive docs/.probe-ktoolbox
42
- // KToolBox 源码 68607 文件)扫入审计(14 条短名泄漏)。复用内置匹配器判目录忽略。
43
- const { parseGitignore, isIgnoredByRules } = await import('../../lib/audit/gitignore-match.js');
44
- const { readFileSync, readdirSync, statSync, existsSync } = await import('node:fs');
45
- const { join, extname, relative } = await import('node:path');
46
- const CODE_EXTS = new Set(['.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx']);
47
- // 排除目录(构建产物/依赖/测试/一次性工具——与内置 collector 忽略语义近似;精确忽略留给核心审计)
48
- const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'output', 'test', 'tests', '__tests__', 'spec', 'tools', 'scripts', '.trash']);
49
- // gitignore 规则(.gitignore + .auditignore 叠加)——目录级跳过;缺省空 = 不忽略
50
- let gitignoreRules = null;
51
- try {
52
- const giText = [];
53
- for (const giFile of ['.gitignore', '.auditignore']) {
54
- const p = join(repo, giFile);
55
- if (existsSync(p)) giText.push(readFileSync(p, 'utf8'));
56
- }
57
- if (giText.length) gitignoreRules = parseGitignore(giText.join('\n'));
58
- } catch { /* 读忽略文件失败 = 不忽略,保守放行 */ }
59
- const findings = [];
60
- const walk = (dir) => {
61
- for (const f of readdirSync(dir)) {
62
- const p = join(dir, f);
63
- let st;
64
- try { st = statSync(p); } catch { continue; }
65
- if (st.isDirectory()) {
66
- if (SKIP_DIRS.has(f)) continue;
67
- // gitignore 忽略目录(上游克隆/内部数据)跳过——与 collector 目录剪枝同语义
68
- if (gitignoreRules && isIgnoredByRules(gitignoreRules, relative(repo, p).replace(/\\/g, '/'), true)) continue;
69
- walk(p);
70
- } else if (CODE_EXTS.has(extname(f))) {
71
- try {
72
- const text = readFileSync(p, 'utf8');
73
- const rel = relative(repo, p) || p;
74
- if (isExcludedPath(rel)) continue; // 规则声明的路径白名单外(如 token 级判定层的惯用短名)
75
- if (isBuildArtifactFile(rel, text)) continue; // 构建/混淆产物跳过(行级规则必然误报)
76
- for (const hit of checkNameLengthAst(text, { min: minLength, allow })) {
77
- // 降级(按需求):窄作用域(声明所在块行跨度 ≤ SCOPE_LINES)里的短别名
78
- // 仍列出来(聚合结果里能查到位置、便于人工核对),但不按 warning 告警——
79
- // 含义由紧邻上下文决定(c=chunk / h=header / m=method / d=data / q=query),
80
- // 报成 warning 只会制造噪声;宽作用域仍按 warning 报。
81
- const narrow = hit.narrowScope === true;
82
- const what = hit.type === 'function' ? '函数' : '变量';
83
- findings.push({
84
- file: rel, line: hit.line,
85
- rule: 'readability/variable-min-length', kind: 'min-length',
86
- severity: narrow ? 'notice' : 'warning',
87
- message: narrow
88
- ? `${what}名「${hit.name}」过短(< ${minLength})——窄作用域惯用短别名(已降级为提示,位置可查)`
89
- : `${what}名「${hit.name}」过短(< ${minLength})——应可读命名`,
90
- dimensions: ['可读性'],
91
- exemptHint: 'dsh-skip-quality(文件头=整文件)',
92
- scoreImpact: 0,
93
- });
94
- }
95
- } catch { /* 单文件读取失败跳过 */ }
96
- }
97
- }
98
- };
99
- try { walk(repo); } catch { /* 仓库不可遍历返回空 */ }
100
- return findings;
101
- },
102
- };
@@ -1,235 +0,0 @@
1
- #!/usr/bin/env node
2
- // 提交前审计引擎 · 轻量门禁入口(不是给人看的 CLI,只服务 commit 门禁)
3
- //
4
- // 为什么单独开一个入口、不复用 cli.mjs(实测数字决定,别改成"复用更省事"):
5
- // 同一仓库、同一 scope、同一台 CIFS 机器上——
6
- // 进程内直接调审计内核 1.0s
7
- // 本轻量入口(子进程 + JSON) 1.3s
8
- // cli.mjs audit --json 6.4s
9
- // 多出来的 5.4s 全是 cli.mjs 全家桶的 ESM 模块解析(account/vcs/doc/npm/git 命令族被
10
- // 一路链式 import 进来),与本次审计无关。门禁每次提交都要跑,不能为此付 5 秒。
11
- // 所以本文件**只** import 审计内核与评分两层,加任何新的 import 前先量耗时。
12
- //
13
- // 契约(与实现语言无关,替代引擎照此实现即可):
14
- // stdout : 一行 JSON { ok, scope, summary, quality, findings, files }
15
- // 退出码 : 0 = 无 blocker(放行)/ 1 = 有 blocker(拦截)/ 2 = 执行失败(参数错、内部异常)
16
- // stderr : 仅诊断信息,不参与判定
17
- // --blockers-only : findings 只留 blocker 级(大仓 4900 条约 3.8MB,门禁未必需要全量)
18
- //
19
- // stdout 纯净性:审计过程里任何 console.* / 直接 stdout 写入都被临时改道到 stderr,
20
- // 最后只由本文件写那一行 JSON。否则调用方 JSON.parse 会被进度噪音打死(历史故障)。
21
- //
22
- // 参数缺省语义(必须与插件默认配置等价,测试钉住):
23
- // --max-scan-files 缺省 = DEFAULT_MAX_SCAN_FILES(3000),**不是 0**
24
- // —— capScanFiles 里 0 的含义是「不限」,把缺省当 0 会把大仓全量扫,语义正好相反。
25
- // --disabled-slots 缺省 = 不禁用任何槽位。
26
- // --slots 缺省 = 不限定规则包(加载层默认偏好顺序);只在调用方显式给白名单时传。
27
-
28
- import { fileURLToPath } from 'node:url';
29
- import { resolve } from 'node:path';
30
-
31
- // 宿主文档漂移检查器接线(导入即安装,幂等):`lib/audit/**` 不许 import scripts/**,
32
- // 这两个检查器由宿主入口注入。漏掉这一行会让「目录树漂移 / 函数列表漂移」两类 finding
33
- // 整类消失(实测同一棵树上少 4 条 finding)——**行为一致性要求本入口必须显式接线**,
34
- // 与 lib/commit-push.js / cli.mjs 两处宿主入口同款。依赖只有 node 内置模块,几乎零加载代价。
35
- import '../lib/app/host-doc-checks.js';
36
- import { auditWithScope } from '../lib/audit/index.js';
37
- import { scoreQuality } from '../lib/score/index.js';
38
-
39
- /** 退出码语义(任何语言都能实现 exit 0/1/2,比让调用方解析 JSON 猜语义可靠)。 */
40
- export const EXIT_OK = 0;
41
- export const EXIT_BLOCKED = 1;
42
- export const EXIT_FAILED = 2;
43
-
44
- /**
45
- * 引擎侧「全量扫描文件数上限」默认值。
46
- * 单一来源是 lib/app/schema-audit.js 的 DEFAULT_MAX_SCAN_FILES(3000,由 lib/client/index.js
47
- * 的 MAX_SCAN_FILES_DEFAULT 与之对齐)。本文件不复用那个常量是因为轻量入口不能 import
48
- * lib/app/ 与 lib/client/(那会把加载代价拉回去)。代价是两处数字必须相等 ——
49
- * test/test-pre-commit-engine.mjs 用 defaultConfig().maxScanFiles 钉住这条,改一处漏另一处会变红。
50
- */
51
- export const DEFAULT_MAX_SCAN_FILES = 3000;
52
-
53
- /** 参数错误统一用这个错误类型,main 据此输出「用法」而不是「内部异常」。 */
54
- export class GateUsageError extends Error {
55
- constructor(message) {
56
- super(message);
57
- this.name = 'GateUsageError';
58
- }
59
- }
60
-
61
- /**
62
- * 解析命令行参数(纯函数,测试可直接调用,不必起子进程)。
63
- * @param {string[]} argv 不含 node 与脚本路径的参数表
64
- * @returns {{repo: string, scope: 'diff'|'full', rulesetDir: string, weights: object,
65
- * maxScanFiles: number, disabledSlots: string[], blockersOnly: boolean, json: boolean}}
66
- */
67
- /** 取值的参数解析器(各自单职责,主循环只做分派——避免一个巨型 if 链)。 */
68
- function parseScopeValue(rawValue) {
69
- if (rawValue !== 'diff' && rawValue !== 'full') throw new GateUsageError(`--scope 只接受 diff|full,收到:${rawValue}`);
70
- return rawValue;
71
- }
72
-
73
- function parseWeightsValue(rawValue) {
74
- let parsedWeights;
75
- try {
76
- parsedWeights = JSON.parse(rawValue);
77
- } catch (e) {
78
- throw new GateUsageError(`--weights 不是合法 JSON:${e.message}`);
79
- }
80
- return parsedWeights && typeof parsedWeights === 'object' ? parsedWeights : {};
81
- }
82
-
83
- function parseMaxScanFilesValue(rawValue) {
84
- const asNumber = Number(rawValue);
85
- // 只接受非负有限数:0 有明确含义(不限),所以不能用 falsy 判断把它当成「没传」
86
- if (!Number.isFinite(asNumber) || asNumber < 0) throw new GateUsageError(`--max-scan-files 需要非负数字,收到:${rawValue}`);
87
- return asNumber;
88
- }
89
-
90
- function parseSlotListValue(rawValue) {
91
- return String(rawValue).split(',').map((slotName) => slotName.trim()).filter(Boolean);
92
- }
93
-
94
- /**
95
- * 参数分派表:键是参数名,值是「要不要取值 + 怎么落到解析结果上」。
96
- * 未知参数一律报错(不做静默忽略)——拼错的参数被忽略,等于门禁悄悄少传一项设置。
97
- */
98
- const GATE_FLAG_SPECS = {
99
- '--repo': { needsValue: true, apply: (target, rawValue) => { target.repo = rawValue; } },
100
- '--scope': { needsValue: true, apply: (target, rawValue) => { target.scope = parseScopeValue(rawValue); } },
101
- '--ruleset': { needsValue: true, apply: (target, rawValue) => { target.rulesetDir = rawValue; } },
102
- '--weights': { needsValue: true, apply: (target, rawValue) => { target.weights = parseWeightsValue(rawValue); } },
103
- '--max-scan-files': { needsValue: true, apply: (target, rawValue) => { target.maxScanFiles = parseMaxScanFilesValue(rawValue); } },
104
- '--disabled-slots': { needsValue: true, apply: (target, rawValue) => { target.disabledSlots = parseSlotListValue(rawValue); } },
105
- '--slots': { needsValue: true, apply: (target, rawValue) => { target.slots = parseSlotListValue(rawValue); } },
106
- '--blockers-only': { needsValue: false, apply: (target) => { target.blockersOnly = true; } },
107
- '--json': { needsValue: false, apply: (target) => { target.json = true; } },
108
- };
109
-
110
- /**
111
- * 解析命令行参数(纯函数,测试可直接调用,不必起子进程)。
112
- * @param {string[]} argv 不含 node 与脚本路径的参数表
113
- * @returns {{repo: string, scope: 'diff'|'full', rulesetDir: string, weights: object,
114
- * maxScanFiles: number, disabledSlots: string[], slots: string[], blockersOnly: boolean, json: boolean}}
115
- */
116
- export function parseGateArgs(argv = []) {
117
- const target = {
118
- repo: '',
119
- scope: 'diff',
120
- rulesetDir: '',
121
- weights: {},
122
- maxScanFiles: DEFAULT_MAX_SCAN_FILES,
123
- disabledSlots: [],
124
- slots: [],
125
- blockersOnly: false,
126
- json: false,
127
- };
128
- for (let cursor = 0; cursor < argv.length; cursor += 1) {
129
- const flagName = argv[cursor];
130
- const spec = GATE_FLAG_SPECS[flagName];
131
- if (!spec) throw new GateUsageError(`不认识的参数:${flagName}`);
132
- if (!spec.needsValue) { spec.apply(target); continue; }
133
- const flagValue = argv[cursor + 1];
134
- if (flagValue === undefined) throw new GateUsageError(`参数 ${flagName} 缺少取值`);
135
- cursor += 1;
136
- spec.apply(target, flagValue);
137
- }
138
- if (!target.repo) throw new GateUsageError('缺少必填参数 --repo <仓库绝对路径>');
139
- return target;
140
- }
141
-
142
- /**
143
- * 跑一次审计并组装契约 JSON(纯逻辑,测试可直接调用)。
144
- * 与旧「进程内提交门禁」逐项对齐的点:
145
- * · scope / maxScanFiles / rulesetDir / disabledSlots 的取值路径完全相同;
146
- * · 评分上下文只给 files / dimFileCounts / dimRuleCounts(**不给 docsScore**)——
147
- * 旧 runAudit 就是这么调的,多给一项会让分数变化;
148
- * · summary 直接透传内核结果,不在这里重新计数。
149
- * @param {object} opts parseGateArgs 的返回值
150
- * @returns {Promise<{ok: boolean, scope: string, summary: object, quality: object, findings: object[], files: number}>}
151
- */
152
- export async function runGateAudit(opts) {
153
- const auditResult = await auditWithScope(opts.repo, {
154
- scope: opts.scope,
155
- maxScanFiles: opts.maxScanFiles,
156
- rulesetDir: opts.rulesetDir,
157
- // 空数组与 undefined 在加载层同义(都用默认偏好顺序),显式给 undefined 更贴合旧行为
158
- slots: Array.isArray(opts.slots) && opts.slots.length ? opts.slots : undefined,
159
- disabledSlots: Array.isArray(opts.disabledSlots) ? opts.disabledSlots : [],
160
- });
161
- const quality = scoreQuality(auditResult.findings, opts.weights, {
162
- files: auditResult.files,
163
- dimFileCounts: auditResult.dimFileCounts,
164
- dimRuleCounts: auditResult.dimRuleCounts,
165
- });
166
- const findings = opts.blockersOnly
167
- ? (auditResult.findings || []).filter((finding) => finding.severity === 'blocker')
168
- : (auditResult.findings || []);
169
- return {
170
- ok: (auditResult.summary?.blocker ?? 0) === 0,
171
- scope: auditResult.scope,
172
- summary: auditResult.summary,
173
- quality,
174
- findings,
175
- files: auditResult.files,
176
- };
177
- }
178
-
179
- /**
180
- * 把审计期间的一切 stdout 写入改道到 stderr,返回还原函数。
181
- * 为什么不用「审计结束后从 stdout 里找 JSON 行」:findings 可达数 MB 且内容里可能含
182
- * 花括号,正则挑行不可靠;从源头保证 stdout 只有一行才是可验证的。
183
- */
184
- export function muteStdout() {
185
- const originalWrite = process.stdout.write;
186
- process.stdout.write = process.stderr.write.bind(process.stderr);
187
- return () => { process.stdout.write = originalWrite; };
188
- }
189
-
190
- /** 写契约 JSON 并在冲刷完成后退出(flush 后再 exit,避免大 payload 被截断)。 */
191
- function emitAndExit(result, exitCode) {
192
- const payload = `${JSON.stringify(result)}\n`;
193
- process.stdout.write(payload, () => { process.exit(exitCode); });
194
- }
195
-
196
- /** 入口:解析 → 审计 → 输出 → 定退出码。 */
197
- async function main(argv) {
198
- let opts;
199
- try {
200
- opts = parseGateArgs(argv);
201
- } catch (e) {
202
- process.stderr.write(`${e.name === 'GateUsageError' ? '参数错误' : '内部错误'}:${e.message}\n`);
203
- return EXIT_FAILED;
204
- }
205
- const restoreStdout = muteStdout();
206
- let gateAuditResult;
207
- try {
208
- gateAuditResult = await runGateAudit(opts);
209
- } catch (e) {
210
- process.stderr.write(`审计执行失败(repo=${opts.repo} scope=${opts.scope}):${e?.stack || e}\n`);
211
- return EXIT_FAILED;
212
- } finally {
213
- restoreStdout();
214
- }
215
- emitAndExit(gateAuditResult, gateAuditResult.ok ? EXIT_OK : EXIT_BLOCKED);
216
- // emitAndExit 内部已注册退出,这里返回一个占位码保持函数语义完整
217
- return gateAuditResult.ok ? EXIT_OK : EXIT_BLOCKED;
218
- }
219
-
220
- /** 直接执行时才真正开跑:被测试 import 时不得产生副作用。 */
221
- function invokedDirectly() {
222
- const entry = process.argv[1];
223
- if (!entry) return false;
224
- try { return resolve(entry) === resolve(fileURLToPath(import.meta.url)); } catch { return false; }
225
- }
226
-
227
- if (invokedDirectly()) {
228
- main(process.argv.slice(2)).then((code) => {
229
- // 正常路径里 emitAndExit 已经退出;走到这里说明审计抛错或没输出结果
230
- if (typeof code === 'number') process.exitCode = code;
231
- }).catch((e) => {
232
- process.stderr.write(`未捕获异常:${e?.stack || e}\n`);
233
- process.exit(EXIT_FAILED);
234
- });
235
- }
@@ -1,35 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * 审计扩展统一入口(CLI)——独立跑 scripts/audit-ext/ 下全部审计扩展脚本。
4
- *
5
- * 用法:
6
- * node scripts/audit-runner.mjs <repo> [--dir scripts/audit-ext] [--json]
7
- *
8
- * 与插件审计的关系:auditFull/auditWithScope 已自动并入 audit-ext 扩展 findings
9
- * (source 标记 ext:<name>);本脚本用于独立调试/单独跑扩展(不带核心审计)。
10
- */
11
-
12
- import { runAuditExt } from '../lib/audit/ext-runner.js';
13
-
14
- /** findings 预览打印条数(调试输出——完整清单走 --json)。 */
15
- const PREVIEW_MAX = 20;
16
-
17
- async function main() {
18
- const argv = process.argv.slice(2);
19
- const repo = argv.find((a) => !a.startsWith('--')) || process.cwd();
20
- const dirIdx = argv.indexOf('--dir');
21
- const dir = dirIdx >= 0 ? argv[dirIdx + 1] : undefined;
22
- const json = argv.includes('--json');
23
-
24
- const findings = await runAuditExt(repo, { dir, log: console });
25
- if (json) {
26
- console.log(JSON.stringify({ repo, extFindings: findings.length, findings }, null, 2));
27
- return;
28
- }
29
- console.log(`审计扩展 ${repo} → ${findings.length} 条 findings(source: ext:*)`);
30
- for (const f of findings.slice(0, PREVIEW_MAX)) {
31
- console.log(` ${f.source} ${f.file || ''}:${f.line || ''} [${f.severity || 'warning'}] ${(f.message || '').slice(0, 60)}`);
32
- }
33
- }
34
-
35
- main().catch((e) => { console.error('audit-runner 失败:', e); process.exitCode = 1; });