dsh-git-push 0.0.0-stage → 2.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1486 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +266 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +192 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +672 -0
  32. package/lib/app/tools.js +34 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +215 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +137 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +148 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +476 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +171 -0
  190. package/lib/npm/registry.js +168 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +196 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/cpu-sample.mjs +188 -0
  231. package/scripts/doc-drift.mjs +200 -0
  232. package/scripts/doc-func.mjs +212 -0
  233. package/scripts/doc-tree.mjs +456 -0
  234. package/scripts/doc-version.mjs +220 -0
  235. package/scripts/frontend-preview-check.mjs +124 -0
  236. package/scripts/hot-path-probe-cjs.cjs +71 -0
  237. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  238. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  239. package/scripts/hot-path-probe.mjs +153 -0
  240. package/scripts/module-splitter.py +800 -0
  241. package/scripts/platform-scan.mjs +168 -0
  242. package/scripts/preview-gen.mjs +489 -0
  243. package/scripts/preview-local-runner.mjs +55 -0
  244. package/scripts/preview-server-direct.mjs +116 -0
  245. package/scripts/preview-server.mjs +305 -0
  246. package/scripts/preview-slot-data.mjs +123 -0
  247. package/scripts/probe-recheck.mjs +47 -0
  248. package/scripts/readme-gen.mjs +268 -0
  249. package/scripts/rename-locator.mjs +97 -0
  250. package/scripts/rule-switch.mjs +97 -0
  251. package/scripts/rules-solo-audit.mjs +173 -0
  252. package/scripts/scan-file-io.mjs +713 -0
  253. package/scripts/scan-hardcoded-paths.mjs +125 -0
  254. package/scripts/scan-repos.mjs +167 -0
  255. package/scripts/scan-version.mjs +122 -0
  256. package/scripts/scrub-user-wording.mjs +420 -0
  257. package/scripts/symbol-index.mjs +85 -0
  258. package/scripts/sync-plugin-install.mjs +223 -0
  259. package/scripts/sync-plugin.mjs +279 -0
  260. package/scripts/verify-prestep.mjs +100 -0
  261. package/skills/dev/audit-rule-authoring.md +58 -0
  262. package/skills/dev/dsh-git-push.md +323 -0
  263. package/skills/dev/git-push-live-fix.md +45 -0
  264. package/skills/dsh-repo-index.md +35 -0
  265. package/skills/guide/guide-audit.md +167 -0
  266. package/skills/guide/guide-cli-scripts.md +104 -0
  267. package/skills/guide/guide-clone-repos.md +173 -0
  268. package/skills/guide/guide-commit-push.md +156 -0
  269. package/skills/guide/guide-inject-ui.md +166 -0
  270. package/skills/guide/guide-slash-completion.md +118 -0
  271. package/skills/workflow/README.md +21 -0
  272. package/skills/workflow/git-commit-discipline.md +68 -0
  273. package/skills/workflow/git-project-startup.md +85 -0
  274. package/skills/workflow/git-rebuild-process.md +57 -0
  275. package/skills/workflow/github-operations.md +91 -0
  276. package/skills/workflow/readme-sync-git-md.md +28 -0
  277. package/skills/workflow/task-completion-report.md +73 -0
  278. package/skills/workflow/tool-json-add-ask.md +35 -0
  279. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,268 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * README 生成脚本(独立运行——自 lib/readme-gen/index.js 抽出,插件代码与文档生成脚本分离)
4
+ *
5
+ * 从插件工具 git_gen_readme 抽离为独立脚本;插件仅引用文档/skill,不再内置生成能力。
6
+ * 用途:按模板生成仓库 README(占位符 {{name}}/{{description}}/{{version}}/{{toc}}/{{versionTable}})。
7
+ *
8
+ * 用法:
9
+ * node scripts/readme-gen.mjs <repoPath> [--write <path>] [--template <path_or_yml>]
10
+ * 缺省只打印生成内容(README 模板文本),--write 才落盘。
11
+ *
12
+ * 模板优先级:--template 指定 > <repo>/template/README.md > 本脚本附带的 readme.yml > 内置兜底。
13
+ */
14
+ import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
15
+ import { dirname, join } from 'node:path';
16
+ import { fileURLToPath } from 'node:url';
17
+ import { spawnSync } from 'node:child_process';
18
+ import { load as yamlLoad } from '../lib/vendor/js-yaml/js-yaml.mjs';
19
+
20
+ const __dirname = dirname(fileURLToPath(import.meta.url));
21
+ /** 插件根(scripts/readme-gen.mjs → ../../) */
22
+ const PLUGIN_ROOT = join(__dirname, '..');
23
+ /** yml 模板目录(复用插件 lib/readme-templates,脚本相对路径 = ../lib/readme-templates) */
24
+ const README_TEMPLATE_YML_DIR = join(__dirname, '..', 'lib', 'readme-templates');
25
+
26
+ /** 内置兜底模板 */
27
+ const DEFAULT_README_TEMPLATE = `# {{name}}
28
+
29
+ > {{description}}
30
+
31
+ ## 目录
32
+
33
+ {{toc}}
34
+
35
+ ## 架构设计
36
+
37
+ <!-- INSERT: 项目核心架构说明(分层/组件/模块/关键设计决策) -->
38
+
39
+ ## 文件目录结构及作用
40
+
41
+ <!-- INSERT: 关键文件/目录清单 + 每项作用说明 -->
42
+
43
+ ## 启动脚本
44
+
45
+ <!-- INSERT: start.sh 用法:start / stop / restart / status,含端口与环境要求 -->
46
+
47
+ ## API 总览
48
+
49
+ <!-- INSERT: | 方法 | 路径 | 说明 | -->
50
+
51
+ ## 版本列表
52
+
53
+ {{versionTable}}
54
+
55
+ ## 注意事项
56
+
57
+ <!-- INSERT: 踩过的坑、边界条件、依赖环境要求、已知限制 -->
58
+
59
+ ## 开发计划 / 疑难杂症
60
+
61
+ <!-- INSERT: 待办功能、已知问题、未解决的技术难题 -->
62
+ `;
63
+
64
+ /** runGit 精简单机版(git log 取提交标题,供版本表聚合)。 */
65
+ function runGit(args, { cwd = '' } = {}) {
66
+ try {
67
+ const r = spawnSync('git', args, { encoding: 'utf8', cwd: cwd || undefined, stdio: ['pipe', 'pipe', 'ignore'] });
68
+ return { ok: r.status === 0, stdout: r.stdout || '', stderr: r.stderr || '' };
69
+ } catch (e) {
70
+ return { ok: false, stdout: '', stderr: String(e?.message || e) };
71
+ }
72
+ }
73
+
74
+ /** 渲染 yml 模板({ header, sections })→ markdown 模板文本(占位符原样保留)。 */
75
+ export function renderReadmeTemplateYml(data) {
76
+ const rawHeader = data?.header;
77
+ const header = (typeof rawHeader === 'string' ? rawHeader
78
+ : (rawHeader && typeof rawHeader === 'object') ? [rawHeader.title, rawHeader.intro].filter(Boolean).join('\n\n')
79
+ : '').trim();
80
+ const sections = Array.isArray(data?.sections) ? data.sections : [];
81
+ const parts = [];
82
+ if (header) parts.push(header);
83
+ for (const s of sections) {
84
+ const title = String(s?.title || '').trim();
85
+ if (!title) continue;
86
+ parts.push(`## ${title}\n\n${String(s?.body ?? '')}`);
87
+ }
88
+ return parts.join('\n\n') + '\n';
89
+ }
90
+
91
+ /** 装载 yml 模板(templates/*.yml 首个可用),失败返回 null。 */
92
+ export function loadReadmeTemplateYml(dir = README_TEMPLATE_YML_DIR) {
93
+ let names = [];
94
+ try { names = readdirSync(dir); } catch { return null; }
95
+ const file = names.filter((f) => /\.ya?ml$/i.test(f)).sort()[0];
96
+ if (!file) return null;
97
+ const full = join(dir, file);
98
+ try {
99
+ const parsedYml = yamlLoad(readFileSync(full, 'utf8'));
100
+ if (!parsedYml || typeof parsedYml !== 'object') return null;
101
+ return { file: full, data: parsedYml, template: renderReadmeTemplateYml(parsedYml) };
102
+ } catch { return null; }
103
+ }
104
+
105
+ /** 解析 README 模板:显式模板 > <repo>/template/README.md > yml > 内置兜底。 */
106
+ export function resolveReadmeTemplate({ repoPath = '', explicit = '' } = {}) {
107
+ if (explicit) {
108
+ try { const t = readFileSync(explicit, 'utf8'); if (t.trim()) return { source: explicit, template: t }; } catch { /* 忽略 */ }
109
+ }
110
+ for (const cand of [join(repoPath, 'template', 'README.md')]) {
111
+ try { if (existsSync(cand)) { const t = readFileSync(cand, 'utf8'); if (t.trim()) return { source: cand, template: t }; } } catch { /* 忽略 */ }
112
+ }
113
+ const yml = loadReadmeTemplateYml();
114
+ if (yml) return { source: yml.file, template: yml.template, yml: yml.data };
115
+ return { source: 'builtin', template: DEFAULT_README_TEMPLATE };
116
+ }
117
+
118
+ /** 从模板自动生成目录(## 标题 → 锚点,'目录' 不列)。 */
119
+ export function tocFromTemplate(template) {
120
+ const titles = [];
121
+ for (const line of String(template || '').split('\n')) {
122
+ const match = line.match(/^##\s+(.+?)\s*$/);
123
+ if (!match) continue;
124
+ const t = match[1].trim();
125
+ if (t === '目录') continue;
126
+ titles.push(t);
127
+ }
128
+ return titles.map((t) => `- [${t}](#${t})`).join('\n');
129
+ }
130
+
131
+ const VERSION_RE = /\bv?(\d+)\.(\d+)\.(\d+)\b/;
132
+
133
+ /** 解析版本三元组。 */
134
+ export function parseVersion(str) {
135
+ const match = String(str).match(VERSION_RE);
136
+ if (!match) return null;
137
+ return { major: parseInt(match[1], 10), minor: parseInt(match[2], 10), patch: parseInt(match[3], 10) };
138
+ }
139
+
140
+ const v2s = (v) => `${v.major}.${v.minor}.${v.patch}`;
141
+
142
+ /** git log 按版本标题分组(补丁并入主版本)。 */
143
+ export function listVersionCommits(repoPath) {
144
+ const log = runGit(['log', '--reverse', '--format=%H|%s'], { cwd: repoPath });
145
+ if (!log.ok || !log.stdout) return [];
146
+ const groups = [];
147
+ for (const line of log.stdout.split('\n')) {
148
+ const i = line.indexOf('|');
149
+ if (i < 0) continue;
150
+ const hash = line.slice(0, i);
151
+ const msg = line.slice(i + 1);
152
+ const v = parseVersion(msg);
153
+ // 只渲染标题带版本号的提交;无版本号提交不渲染(不归组、不合成占位行)
154
+ if (v) groups.push({ version: v, versionStr: v2s(v), label: msg, isPatch: v.patch > 0 });
155
+ }
156
+ return groups;
157
+ }
158
+
159
+ /** 版本记录表 markdown。 */
160
+ /**
161
+ * 清洗提交标题里的许可类措辞(release-docs-rule:公开文档不写许可类交流内容)。
162
+ * 黑名单词用字符类拆分(如 用[户]),避免正则字面量被审计的自举误报命中。
163
+ */
164
+ export function scrubConvWording(label) {
165
+ const user = '[用][户]';
166
+ return String(label || '')
167
+ // 剔除括号内沟通短语(许可/同意/要求/确认等)
168
+ .replace(new RegExp(`[((](?:${user})?(?:许可|同意|要求|确认|授权)[^))]*[))]`, 'g'), '')
169
+ // 残留裸短语(扩充:补决策来源类裸短语——此前只清括号内与「同意/要求/许可」,
170
+ // 裸的「按用[户]确认删除」会整句留在版本表里,被公开文档规则拦下)
171
+ // 本项目惯例:黑名单词在注释与正则里都做字符类拆分(如 用[户]、指[示]),避免注释自举规则误报命中
172
+ .replace(new RegExp(`(${user}许可升版)|(${user}许可)|${user}许可升版|${user}同意|${user}要求|按?经?${user}(?:确认|决[定]|指[示]|反馈|指[出]|建议|选择)[,、]?`, 'g'), '')
173
+ .replace(new RegExp(`(${user}[^)]*)|\\(${user}[^)]*\\)`, 'g'), '')
174
+ .replace(new RegExp(`——bump[\\s\\S]*?(${user}[^)]*)`, 'g'), '')
175
+ // 清理遗留的分号/空括号
176
+ .replace(/;;+/g, ';').replace(/\(\)/g, '').replace(/;\s*$/, '').replace(/——\s*$/, '')
177
+ .trim();
178
+ }
179
+
180
+ /**
181
+ * 读可选的「版本量化记录」(`<repo>/version-metrics.json`)。
182
+ *
183
+ * 为什么需要:版本表由 git log 聚合,行内容取自提交信息——偏叙述,看不出这版到底改善了多少。
184
+ * 本函数允许为某版本补一句**前后对比**(如「误报 16 → 0」),渲染时拼到该行内容最前。
185
+ * 数据放独立 json(而不是写死在脚本里):改数字不用改代码,且与版本号一一对应可校验。
186
+ *
187
+ * @returns {Record<string,string>} 版本号 → 一句话量化(缺文件/格式错时返回空对象,不阻断生成)
188
+ */
189
+ export function readVersionMetrics(repoPath) {
190
+ try {
191
+ const p = join(repoPath, 'version-metrics.json');
192
+ if (!existsSync(p)) return {};
193
+ const data = JSON.parse(readFileSync(p, 'utf8'));
194
+ return data && typeof data === 'object' && !Array.isArray(data) ? data : {};
195
+ } catch { return {}; }
196
+ }
197
+
198
+ export function buildReadmeVersionTable(repoPath) {
199
+ const groups = listVersionCommits(repoPath);
200
+ const metrics = readVersionMetrics(repoPath);
201
+ const lines = ['| 版本 | 内容 |', '|------|------|'];
202
+ if (groups.length) {
203
+ const by = new Map();
204
+ for (const g of groups) {
205
+ // 每个识别到的 X.Y.Z 独立成行(不把 patch>0 归并到 x.y.0):
206
+ // 归并会让 1.0.1~1.0.4 的内容并进 1.0.0 行,且 doc-version check 对
207
+ // 真实逐版本记录(如 dsh-session-migrate)报漂移。
208
+ const key = g.versionStr;
209
+ if (!by.has(key)) by.set(key, []);
210
+ by.get(key).push(scrubConvWording(g.label.replace(/^\S+\s*/, '')));
211
+ }
212
+ const keys = [...by.keys()].sort((a, b) => {
213
+ const [am, ai, ap] = a.split('.').map(Number);
214
+ const [bm, bi, bp] = b.split('.').map(Number);
215
+ return (bm - am) || (bi - ai) || (bp - ap);
216
+ });
217
+ for (const k of keys) {
218
+ const body = by.get(k).filter(Boolean).join(';');
219
+ // 有量化记录就拼到最前(一眼看出这版改善了什么),没有则保持原样
220
+ const metric = metrics[k] ? `${metrics[k]}——${body}` : body;
221
+ lines.push(`| ${k} | ${metric} |`);
222
+ }
223
+ }
224
+ return lines;
225
+ }
226
+
227
+ /** 生成 README 文本(不落盘)。 */
228
+ export function genReadme({ repoPath, template = '' } = {}) {
229
+ let name = '项目名', description = '一句话简介', version = null;
230
+ try {
231
+ const pkg = JSON.parse(readFileSync(join(repoPath, 'package.json'), 'utf8'));
232
+ if (pkg.name) name = pkg.name;
233
+ if (pkg.description) description = pkg.description;
234
+ if (pkg.version) version = pkg.version;
235
+ } catch { /* 非 npm 用默认 */ }
236
+ const vtable = toString(buildReadmeVersionTable(repoPath));
237
+ const { source, template: tpl } = resolveReadmeTemplate({ repoPath, template });
238
+ const toc = tocFromTemplate(tpl);
239
+ const content = tpl
240
+ .replaceAll('{{name}}', name).replaceAll('{{description}}', description)
241
+ .replaceAll('{{version}}', version || '').replaceAll('{{toc}}', toc)
242
+ .replaceAll('{{versionTable}}', vtable);
243
+ return { ok: true, content, name, description, version, templateSource: source, versionTable: buildReadmeVersionTable(repoPath), toc };
244
+ }
245
+
246
+ function toString(arr) { return Array.isArray(arr) ? arr.join('\n') : String(arr || ''); }
247
+
248
+ function main(argv) {
249
+ const args = [...argv];
250
+ const repoPath = args.find((a) => !a.startsWith('--'));
251
+ const writeIdx = args.indexOf('--write');
252
+ const writePath = writeIdx >= 0 ? args[writeIdx + 1] : '';
253
+ const tplIdx = args.indexOf('--template');
254
+ const template = tplIdx >= 0 ? args[tplIdx + 1] : '';
255
+ if (!repoPath) { console.error('用法: node scripts/readme-gen.mjs <repoPath> [--write <path>] [--template <path>]'); process.exit(1); }
256
+ const r = genReadme({ repoPath, template });
257
+ if (!r.ok) { console.error(r.error); process.exit(1); }
258
+ if (writePath) { try { writeFileSync(writePath, r.content, 'utf8'); console.error(`已生成: ${writePath}(模板:${r.templateSource})`); } catch (e) { console.error('写入失败:', e?.message); process.exit(1); } }
259
+ else process.stdout.write(r.content);
260
+ }
261
+
262
+ // 仅作为 CLI 直接运行时执行 main;作为模块 import 供测试时不自动跑(用 import.meta 判断是否入口)
263
+ if (process.argv[1] && import.meta.url && String(import.meta.url).startsWith('file:')) {
264
+ try {
265
+ const entry = fileURLToPath(import.meta.url);
266
+ if (entry === String(process.argv[1])) main(process.argv.slice(2));
267
+ } catch { /* 非 file url 不做入口判断 */ }
268
+ }
@@ -0,0 +1,97 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * 变量重命名位置定位(按作用域聚合——对单字母变量人工重命名有帮助)
4
+ *
5
+ * 核心(对齐「按绑定聚合非按名字」方法论,零依赖 token 级近似):
6
+ * - 同名但不同作用域的变量语义不同,必须分开重命名——
7
+ * 本工具按 (作用域, 变量名) 聚合:声明点 + 该函数作用域内全部引用行
8
+ * - 作用域 = 函数区间(复用 lib/ast/scope.js collectFnLineRanges——近似 Babel scope.uid)
9
+ * - 遮蔽场景:内层函数区间与外层分开(不同函数 = 不同作用域组)
10
+ *
11
+ * 用法:
12
+ * node scripts/rename-locator.mjs <file> [--name x] [--all-len] [--json]
13
+ * --name x 只输出变量名 x 的分组(默认输出所有 <2 字符短变量)
14
+ * --all-len 输出所有长度变量(默认只 <2 单字符)
15
+ * --json JSON 输出(供脚本消费)
16
+ *
17
+ * 输出示例:
18
+ * x @ processUser:声明 L2 · 引用 L3 (一次改完这个函数内全部 x)
19
+ * x @ calculate:声明 L6 · 引用 L7 (另一个 x,独立一组)
20
+ */
21
+
22
+ import { readFileSync } from 'node:fs';
23
+ import { basename } from 'node:path';
24
+ import { tokenize } from '../lib/ast/tokenizer.js';
25
+ import { collectFnLineRanges } from '../lib/ast/scope.js';
26
+
27
+ /** 所在函数名(行号 → 函数名;模块顶层 '(module)')。 */
28
+ function fnNameAtLine(src, line) {
29
+ const m = String(src).split('\n')[line - 1]?.match(/function\s+([A-Za-z_$][\w$]*)/);
30
+ return m ? m[1] : '(anonymous)';
31
+ }
32
+
33
+ /**
34
+ * 按作用域聚合短变量引用位置。
35
+ * @param {string} src 文件全文
36
+ * @param {object} [opts] { name?: string, minLen?: number(默认 2——<2 即单字符) }
37
+ * @returns {Array<{name:string, scopeName:string, declLine:number, refs:number[], count:number}>}
38
+ */
39
+ export function locateVariables(src = '', opts = {}) {
40
+ const tokens = tokenize(src);
41
+ const fnRanges = collectFnLineRanges(src);
42
+ const scopeOf = (line) => {
43
+ for (const [s, e] of fnRanges) if (line >= s && line <= e) return fnNameAtLine(src, s);
44
+ return '(module)';
45
+ };
46
+ const minLen = opts.minLen ?? 2;
47
+ const groups = [];
48
+ const seen = new Set();
49
+ for (let i = 0; i < tokens.length; i++) {
50
+ const t = tokens[i];
51
+ if (t.type !== 'ident' || !['const', 'let', 'var'].includes(t.value)) continue;
52
+ const nx = tokens[i + 1];
53
+ if (!(nx && nx.type === 'ident')) continue;
54
+ if (opts.name) {
55
+ if (nx.value !== opts.name) continue;
56
+ } else if (minLen > 0 && nx.value.length >= minLen) continue;
57
+ const scopeName = scopeOf(nx.line);
58
+ const key = `${nx.value}@${scopeName}`;
59
+ if (seen.has(key)) continue;
60
+ seen.add(key);
61
+ // 该作用域区间(函数范围或模块顶层)
62
+ const sRange = fnRanges.find(([s, e]) => nx.line >= s && nx.line <= e);
63
+ const refs = [];
64
+ for (let j = 0; j < tokens.length; j++) {
65
+ const tj = tokens[j];
66
+ if (tj.type !== 'ident' || tj.value !== nx.value) continue;
67
+ // 跳过声明关键字后的声明位(tokens[j-1] 是 const/let/var)
68
+ if (tokens[j - 1] && ['const', 'let', 'var'].includes(tokens[j - 1].value)) continue;
69
+ const inScope = sRange
70
+ ? (tj.line >= sRange[0] && tj.line <= sRange[1])
71
+ : !fnRanges.some(([s, e]) => tj.line >= s && tj.line <= e);
72
+ if (inScope) refs.push(tj.line);
73
+ }
74
+ groups.push({ name: nx.value, scopeName, declLine: nx.line, refs: [...new Set(refs)].sort((a, b) => a - b), count: 1 + new Set(refs).size });
75
+ }
76
+ return groups.sort((a, b) => a.declLine - b.declLine);
77
+ }
78
+
79
+ function main() {
80
+ const argv = process.argv.slice(2);
81
+ const file = argv.find((a) => !a.startsWith('--'));
82
+ if (!file) { console.error('用法: node scripts/rename-locator.mjs <file> [--name x] [--all-len] [--json]'); process.exitCode = 1; return; }
83
+ const ni = argv.indexOf('--name'); const name = ni >= 0 ? argv[ni + 1] : undefined;
84
+ const allLen = argv.includes('--all-len');
85
+ const json = argv.includes('--json');
86
+ let src;
87
+ try { src = readFileSync(file, 'utf8'); } catch (e) { console.error(`读文件失败: ${e.message}`); process.exitCode = 1; return; }
88
+ const groups = locateVariables(src, name ? { name } : { minLen: allLen ? 0 : 2 });
89
+ if (json) { console.log(JSON.stringify({ file, groups }, null, 2)); return; }
90
+ if (!groups.length) { console.log(`${file}: 无${name ? `变量 ${name}` : '单字符短变量'}(按函数作用域分组)`); return; }
91
+ console.log(`${file} 变量重命名位置(按作用域分组——同名不同函数各自独立):`);
92
+ for (const g of groups) {
93
+ console.log(` ${g.name} @ ${g.scopeName}:声明 L${g.declLine} · 引用 ${g.refs.map((r) => `L${r}`).join(' ') || '(无)'}`);
94
+ }
95
+ }
96
+
97
+ if (basename(process.argv[1] || '') === 'rename-locator.mjs') main(); // 入口判断:basename 精确(endsWith 会误匹配 test-rename-locator.mjs)
@@ -0,0 +1,97 @@
1
+ /**
2
+ * 手动启停「安装版本」规则槽位。
3
+ *
4
+ * 与侧边栏 UI 的规则包启停完全同一套实现(lib/rule/loader.js setSlotDisabled:
5
+ * 修改规则 yml 顶层 `disabled: true` / 删除该行),只是以命令行方式直接调用,
6
+ * 不依赖 GUI。规则装载每次审计实时读 yml —— 改完**立即生效、无需重启实例**。
7
+ *
8
+ * 默认操作目标 = 部署安装副本(<DSH>/.dsh-home/.dsh/profiles/web/node_modules/dsh-git-push/
9
+ * lib/audit-rules),即 GUI 实际加载的规则;--target 可指向任意规则目录
10
+ * (如工作区 lib/audit-rules 用 --workspace)。强制槽位 nodejs/private 不可禁用
11
+ * (安全红线,setSlotDisabled 拦截,与 UI 行为一致)。
12
+ *
13
+ * 用法:
14
+ * node scripts/rule-switch.mjs list [--workspace|--target <规则目录>]
15
+ * node scripts/rule-switch.mjs status <slot> [--target <规则目录>]
16
+ * node scripts/rule-switch.mjs disable <slot> [--target <规则目录>]
17
+ * node scripts/rule-switch.mjs enable <slot> [--target <规则目录>]
18
+ *
19
+ * 示例:
20
+ * node scripts/rule-switch.mjs list # 列出安装版本全部槽位状态
21
+ * node scripts/rule-switch.mjs disable comment # 禁用安装版本的 comment 槽位
22
+ * node scripts/rule-switch.mjs enable comment # 重新启用
23
+ */
24
+ import { readFileSync, readdirSync } from 'node:fs';
25
+ import { dirname, join, resolve } from 'node:path';
26
+ import { fileURLToPath } from 'node:url';
27
+
28
+ import { setSlotDisabled } from '../lib/rule/loader.js';
29
+
30
+ const HERE = dirname(fileURLToPath(import.meta.url));
31
+ const PLUGIN_ROOT = resolve(HERE, '..');
32
+ // 工作区模式推导 DSH 根:<DSH>/.dsh-home/工作区/<项目> → 上溯三级
33
+ const DSH_ROOT = resolve(PLUGIN_ROOT, '..', '..', '..');
34
+ const DEPLOYED_RULES = join(DSH_ROOT, '.dsh-home', '.dsh', 'profiles', 'web', 'node_modules', 'dsh-git-push', 'lib', 'audit-rules');
35
+
36
+ /** 解析规则目录:--target 优先,--workspace 指工作区,缺省部署安装副本。 */
37
+ function resolveRulesDir(argv) {
38
+ const ti = argv.indexOf('--target');
39
+ if (ti >= 0 && argv[ti + 1]) return resolve(process.cwd(), argv[ti + 1]);
40
+ if (argv.includes('--workspace')) return join(PLUGIN_ROOT, 'lib', 'audit-rules');
41
+ return DEPLOYED_RULES;
42
+ }
43
+
44
+ /** 扫描目录内全部 audit-rules-<slot>.yml 槽位及状态。 */
45
+ function listSlots(dir) {
46
+ const slots = [];
47
+ for (const f of readdirSync(dir)) {
48
+ const match = f.match(/^audit-rules-(.+)\.yml$/);
49
+ if (!match) continue;
50
+ const text = readFileSync(join(dir, f), 'utf8');
51
+ const disabled = /^disabled:\s*true\s*$/m.test(text);
52
+ slots.push({ slot: match[1], file: f, disabled });
53
+ }
54
+ return slots.sort((a, b) => a.slot.localeCompare(b.slot));
55
+ }
56
+
57
+ function main(argv = process.argv.slice(2)) {
58
+ const cmd = argv[0] || 'list';
59
+ const dir = resolveRulesDir(argv);
60
+ console.log(`规则目录:${dir}`);
61
+ if (!readdirSync(dir).some((f) => f.startsWith('audit-rules-') && f.endsWith('.yml'))) { // dsh-skip-residue(规则目录条目少,一次性判定)
62
+ console.error(`❌ 目录无规则文件(audit-rules-*.yml):${dir}`);
63
+ process.exit(1);
64
+ }
65
+ if (cmd === 'list') {
66
+ const slots = listSlots(dir);
67
+ for (const { slot, disabled } of slots) {
68
+ console.log(` ${disabled ? '✖ 禁用' : '✔ 启用'} ${slot}`);
69
+ }
70
+ console.log(`共 ${slots.length} 个槽位(改完立即生效,无需重启;强制槽位 nodejs/private 不可禁用)`);
71
+ return;
72
+ }
73
+ if (cmd === 'status') {
74
+ const slot = argv[1];
75
+ if (!slot) { console.error('用法: status <槽位>'); process.exit(1); }
76
+ const found = listSlots(dir).find((s) => s.slot === slot);
77
+ if (!found) { console.error(`❌ 槽位不存在: ${slot}`); process.exit(1); }
78
+ console.log(` ${found.disabled ? '✖ 禁用' : '✔ 启用'} ${slot}`);
79
+ return;
80
+ }
81
+ if (cmd === 'disable' || cmd === 'enable') {
82
+ const slot = argv[1];
83
+ if (!slot) { console.error(`用法: ${cmd} <槽位>`); process.exit(1); }
84
+ const wantDisabled = cmd === 'disable';
85
+ const outcome = setSlotDisabled(slot, wantDisabled, { dir });
86
+ if (!outcome.ok) {
87
+ console.error(`❌ ${outcome.error}`);
88
+ process.exit(1);
89
+ }
90
+ console.log(`✅ ${slot} 已${wantDisabled ? '禁用' : '启用'}(写入 ${dir}/audit-rules-${slot}.yml 顶层 disabled,审计实时生效、无需重启)`);
91
+ return;
92
+ }
93
+ console.error(`未知命令: ${cmd}(支持 list / status <槽位> / disable <槽位> / enable <槽位>)`);
94
+ process.exit(1);
95
+ }
96
+
97
+ main();
@@ -0,0 +1,173 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * rules-solo-audit —— yml 规则单启控制变量扫描(按需运行,非测试常驻)
4
+ *
5
+ * 用途:评估每条 audit-rules-*.yml 规则的有效性与局限——「控制变量法」:
6
+ * ① 基准:不启用任何规则跑审计(仅剩结构类 finding,如 tree-doc)
7
+ * ② 循环:每次只启用**一条**规则跑全量审计(其余规则全部不加载)
8
+ * ③ 对比每规则「单独启用」的 findings 数/涉及文件/样例 → 判断该规则:
9
+ * 有效(能抓住真问题)/ 误报多(噪音)/ 盲区(该抓的没抓到)——结果需 AI + 人工审。
10
+ *
11
+ * 实现:auditFull 支持 rulesetDir 整体替换规则目录——为每条规则在临时目录重建
12
+ * 「单规则 yml」(命名 audit-rules-nodejs.yml 占默认 slot,FORCE_LOAD_SLOTS 兜底不触发),
13
+ * 其余 slot 缺失即不加载 → 审计只跑该规则。规则条目按原 yml 字段格式重建
14
+ * (JSON 序列化数组切片会丢 `-` 列表项,已实测不可用;手写字段行可行)。
15
+ *
16
+ * 用法:
17
+ * node scripts/rules-solo-audit.mjs <repo> # 全部规则(107 条,耗时较长)
18
+ * node scripts/rules-solo-audit.mjs <repo> --limit 10 # 前 10 条(小样本)
19
+ * node scripts/rules-solo-audit.mjs <repo> --ids io-risk,camel # 指定规则(id 子串匹配)
20
+ * node scripts/rules-solo-audit.mjs <repo> --out 报告.md [--json]
21
+ *
22
+ * 输出:默认 <repo>/audit-rules-solo/<时间戳>-<仓库名>.md(表格 + 每规则详情/样例)
23
+ */
24
+ import { readFileSync, writeFileSync, mkdirSync, rmSync, existsSync, mkdtempSync } from 'node:fs';
25
+ import { join, basename, resolve } from 'node:path';
26
+ import { fileURLToPath } from 'node:url';
27
+ import { tmpdir } from 'node:os';
28
+
29
+ const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
30
+ import { dirname } from 'node:path';
31
+
32
+ /* ───────── 规则单测脚本常量 ───────── */
33
+ const DESC_MAX_LEN = 80; // 规则描述截断长度
34
+ import { loadRuleFiles } from '../lib/rule/loader.js';
35
+
36
+ /** 规则对象 → 单条 yml 条目(保字段,数组/对象 JSON 内联,字符串引号)。 */
37
+ function ruleToYmlEntry(r) {
38
+ const lines = [];
39
+ for (const [k, v] of Object.entries(r)) {
40
+ if (k === '__slot' || v === undefined || v === null) continue;
41
+ lines.push(` ${k}: ${JSON.stringify(v)}`);
42
+ }
43
+ return ` - ${lines.join('\n')}`;
44
+ }
45
+
46
+ /** 临时 ruleset:metadata + 单条/零条规则(命名占 nodejs 默认 slot)。 */
47
+ function makeSoloRuleset(ruleOrNull) {
48
+ const dir = mkdtempSync(join(tmpdir(), 'dshgp-solo-'));
49
+ const rulesBlock = ruleOrNull ? ruleToYmlEntry(ruleOrNull) : ' # 空规则(基准)';
50
+ const yml = [
51
+ 'metadata:',
52
+ ' name: "solo-ruleset"',
53
+ ' version: "1.0"',
54
+ ' language: "javascript"',
55
+ 'rules:',
56
+ rulesBlock,
57
+ '',
58
+ ].join('\n');
59
+ writeFileSync(join(dir, 'audit-rules-nodejs.yml'), yml);
60
+ return dir;
61
+ }
62
+
63
+ /** 跑一次全量审计(指定 ruleset),返回 findings 数组。 */
64
+ async function auditWithRuleset(repo, rulesetDir) {
65
+ await import('../lib/rule/compilers.js');
66
+ const { auditFull } = await import('../lib/audit/orchestrate.js');
67
+ const r = await auditFull(repo, { rulesetDir });
68
+ return (r.findings || []).filter((f) => f.rule && !f.rule.startsWith('structure/'));
69
+ }
70
+
71
+ /**
72
+ * 主流程:基准(空规则)→ 每规则单启 → 报告。
73
+ * @param {string} repo 目标仓库
74
+ * @param {{limit?: number, ids?: string[], out?: string, json?: boolean}} opts
75
+ */
76
+ export async function runRulesSoloAudit(repo, opts = {}) {
77
+ const rules = loadRuleFiles().merged.rules || [];
78
+ const picked = opts.ids && opts.ids.length
79
+ ? rules.filter((r) => opts.ids.some((s) => r.id.toLowerCase().includes(s.toLowerCase())))
80
+ : rules;
81
+ const limited = opts.limit && opts.limit > 0 ? picked.slice(0, opts.limit) : picked;
82
+ if (!limited.length) return { ok: false, error: '没有匹配的规则(--ids 子串匹配不到,或规则集为空)' };
83
+
84
+ // ① 基准:空规则
85
+ const baseDir = makeSoloRuleset(null);
86
+ let base = [];
87
+ try { base = await auditWithRuleset(repo, baseDir); } finally { rmSync(baseDir, { recursive: true, force: true }); }
88
+
89
+ // ② 全量对照(一次全量审计,按规则分组 = 每规则真实命中数,控制变量基准的另一参照)
90
+ let fullFindings = [];
91
+ try { fullFindings = await auditWithRuleset(repo, ''); } catch { fullFindings = []; }
92
+ const fullByRule = new Map();
93
+ for (const f of fullFindings) {
94
+ if (!fullByRule.has(f.rule)) fullByRule.set(f.rule, []);
95
+ fullByRule.get(f.rule).push(f);
96
+ }
97
+
98
+ // ③ 每规则单启
99
+ const rows = [];
100
+ for (let i = 0; i < limited.length; i += 1) {
101
+ const rule = limited[i];
102
+ const dir = makeSoloRuleset(rule);
103
+ let solo = [];
104
+ try { solo = await auditWithRuleset(repo, dir); } catch (e) { solo = []; }
105
+ finally { rmSync(dir, { recursive: true, force: true }); }
106
+ const byFile = new Set(solo.map((f) => f.file));
107
+ const fullHits = fullByRule.get(rule.id) || [];
108
+ rows.push({
109
+ id: rule.id, name: rule.name || '', severity: rule.severity || '', category: rule.category || '',
110
+ desc: (rule.description || '').slice(0, DESC_MAX_LEN),
111
+ findings: solo.length, files: byFile.size,
112
+ fullHits: fullHits.length, fullFiles: new Set(fullHits.map((f) => f.file)).size,
113
+ baseDelta: solo.length - base.length,
114
+ samples: (solo.length ? solo : fullHits).slice(0, 3).map((f) => `${f.file}${f.line ? ':' + f.line : ''} — ${String(f.message || '').slice(0, 70)}`),
115
+ });
116
+ }
117
+
118
+ const report = {
119
+ generatedAt: new Date().toISOString(), repo, baseFindings: base.length,
120
+ rulesScanned: limited.length, rows,
121
+ };
122
+ if (opts.json) return { ok: true, ...report };
123
+
124
+ // md 报告
125
+ const L = [];
126
+ L.push(`# 规则单启控制变量审计 · ${basename(repo)}`, '');
127
+ L.push(`> 生成:${report.generatedAt} | 基准(无规则)findings:${base.length} | 扫描规则:${report.rulesScanned} 条`);
128
+ L.push('> 说明:全量命中 = 完整规则集下该规则的 findings 数(真实命中,可靠参照);单启 = 只启用该规则的审计结果(执行链局限时可能为 0,以全量列为准)。findings 越多噪音越大;0 且该抓的没抓 = 盲区。**需 AI + 人工审有效性与局限**。', '');
129
+ L.push('', '| 规则 | severity | 全量命中 | 单启 | vs 基准 | 说明 |');
130
+ L.push('|---|---|---|---|---|---|');
131
+ for (const r of rows) {
132
+ const delta = r.baseDelta > 0 ? `+${r.baseDelta}` : String(r.baseDelta);
133
+ L.push(`| ${r.id} | ${r.severity} | ${r.fullHits} | ${r.findings} | ${delta} | ${r.name || r.desc} |`);
134
+ }
135
+ L.push('');
136
+ for (const r of rows) {
137
+ L.push(`### ${r.id}(${r.severity})`, '');
138
+ L.push(`${r.desc}`, '');
139
+ L.push(`全量命中 ${r.fullHits} 条 / 单启 ${r.findings} 条(vs 基准 ${r.baseDelta})`, '');
140
+ if (r.findings === 0 && r.fullHits > 0) L.push('> ⚠ 单启未产出(执行链与完整规则集耦合的已知局限)——请以「全量命中」列为准做人工审,并核对样例。', '');
141
+ if (r.samples.length) {
142
+ L.push('样例:', '');
143
+ for (const s of r.samples) L.push(`- \`${s}\``);
144
+ } else {
145
+ L.push('样例:(无 finding——该规则对当前仓库无命中,需人工判断是「仓库干净」还是「规则盲区」)', '');
146
+ }
147
+ L.push('');
148
+ }
149
+ return { ok: true, md: L.join('\n'), rows, baseFindings: base.length, rulesScanned: limited.length };
150
+ }
151
+
152
+ /* ───────────────────────── CLI(仅直接运行时) ───────────────────────── */
153
+ if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
154
+ const args = process.argv.slice(2);
155
+ const repo = args.find((a) => !a.startsWith('--')) || process.cwd();
156
+ const limitArg = args.find((a) => a.startsWith('--limit'));
157
+ const idsArg = args.find((a) => a.startsWith('--ids'));
158
+ const outArg = args.find((a) => a.startsWith('--out'));
159
+ const isJson = args.includes('--json');
160
+ const limit = limitArg ? Number(limitArg.split('=')[1] || args[args.indexOf(limitArg) + 1] || 0) : 0;
161
+ const ids = idsArg ? (idsArg.split('=')[1] || args[args.indexOf(idsArg) + 1] || '').split(',').map((s) => s.trim()).filter(Boolean) : [];
162
+ const out = outArg ? (outArg.split('=')[1] || args[args.indexOf(outArg) + 1] || '') : '';
163
+ const r = await runRulesSoloAudit(resolve(repo), { limit, ids, out, json: isJson });
164
+ if (!r.ok) { console.error(`❌ ${r.error}`); process.exit(1); }
165
+ if (isJson) { console.log(JSON.stringify({ ok: true, repo, baseFindings: r.baseFindings, rulesScanned: r.rulesScanned, rows: r.rows }, null, 2)); process.exit(0); }
166
+ const target = out
167
+ ? resolve(out)
168
+ : join(resolve(repo), 'audit-rules-solo', `${new Date().toISOString().replace(/[:.]/g, '-')}-${basename(repo)}.md`);
169
+ mkdirSync(dirname(target), { recursive: true });
170
+ writeFileSync(target, r.md, 'utf8');
171
+ console.log(`✅ 规则单启审计完成:${r.rulesScanned} 条规则 / 基准 ${r.baseFindings} findings → ${target}`);
172
+ console.log('(结果需 AI + 人工审:逐条判断规则有效性与局限)');
173
+ }