dsh-git-push 0.0.0-stage → 2.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (278) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1482 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +262 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +191 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +662 -0
  32. package/lib/app/tools.js +40 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +207 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +131 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +144 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +470 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +167 -0
  190. package/lib/npm/registry.js +147 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +193 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/doc-drift.mjs +200 -0
  231. package/scripts/doc-func.mjs +212 -0
  232. package/scripts/doc-tree.mjs +456 -0
  233. package/scripts/doc-version.mjs +220 -0
  234. package/scripts/frontend-preview-check.mjs +124 -0
  235. package/scripts/hot-path-probe-cjs.cjs +71 -0
  236. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  237. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  238. package/scripts/hot-path-probe.mjs +153 -0
  239. package/scripts/module-splitter.py +800 -0
  240. package/scripts/platform-scan.mjs +168 -0
  241. package/scripts/preview-gen.mjs +489 -0
  242. package/scripts/preview-local-runner.mjs +55 -0
  243. package/scripts/preview-server-direct.mjs +116 -0
  244. package/scripts/preview-server.mjs +305 -0
  245. package/scripts/preview-slot-data.mjs +123 -0
  246. package/scripts/probe-recheck.mjs +47 -0
  247. package/scripts/readme-gen.mjs +268 -0
  248. package/scripts/rename-locator.mjs +97 -0
  249. package/scripts/rule-switch.mjs +97 -0
  250. package/scripts/rules-solo-audit.mjs +173 -0
  251. package/scripts/scan-file-io.mjs +713 -0
  252. package/scripts/scan-hardcoded-paths.mjs +125 -0
  253. package/scripts/scan-repos.mjs +167 -0
  254. package/scripts/scan-version.mjs +122 -0
  255. package/scripts/scrub-user-wording.mjs +420 -0
  256. package/scripts/symbol-index.mjs +85 -0
  257. package/scripts/sync-plugin-install.mjs +223 -0
  258. package/scripts/sync-plugin.mjs +279 -0
  259. package/scripts/verify-prestep.mjs +100 -0
  260. package/skills/dev/audit-rule-authoring.md +58 -0
  261. package/skills/dev/dsh-git-push.md +323 -0
  262. package/skills/dev/git-push-live-fix.md +45 -0
  263. package/skills/dsh-repo-index.md +35 -0
  264. package/skills/guide/guide-audit.md +167 -0
  265. package/skills/guide/guide-cli-scripts.md +104 -0
  266. package/skills/guide/guide-clone-repos.md +173 -0
  267. package/skills/guide/guide-commit-push.md +156 -0
  268. package/skills/guide/guide-inject-ui.md +166 -0
  269. package/skills/guide/guide-slash-completion.md +118 -0
  270. package/skills/workflow/README.md +21 -0
  271. package/skills/workflow/git-commit-discipline.md +68 -0
  272. package/skills/workflow/git-project-startup.md +85 -0
  273. package/skills/workflow/git-rebuild-process.md +57 -0
  274. package/skills/workflow/github-operations.md +91 -0
  275. package/skills/workflow/readme-sync-git-md.md +28 -0
  276. package/skills/workflow/task-completion-report.md +73 -0
  277. package/skills/workflow/tool-json-add-ask.md +35 -0
  278. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,250 @@
1
+ /**
2
+ * dsh-git-push — Host 侧接线层(插件注册到 DSH)
3
+ *
4
+ * ⚠️ 本文件的 API 形状**全部对照运行中的真实插件**抄写,禁止凭印象改:
5
+ *
6
+ * 工具注册:
7
+ * ctx.inject(['tools'], (tctx) => {
8
+ * const tools = tctx.get('tools');
9
+ * if (!tools) return;
10
+ * tools.register(defineTool({ name, description, parameters, output, execute }));
11
+ * });
12
+ * 工具形状 = { name, description, parameters: { k: { type, description } },
13
+ * output: { schema: { type: 'string' }, render }, execute }
14
+ * · execute 返回**字符串**(通常 JSON.stringify)
15
+ * · output.render **必须返回块数组** [{ type: 'text', text }]——tool-result 的
16
+ * block.content 落盘后要求为数组,返回裸字符串会损坏会话日志
17
+ * · parameters 无 required 标注(必填项在 description 里写明 + execute 内校验)
18
+ *
19
+ * 系统提示词注入:
20
+ * ctx.inject(['systemPrompt'], (sctx) => {
21
+ * sctx.get('systemPrompt').section({ name, order, text: () => '同步文本' });
22
+ * });
23
+ * · **callback 的返回值不是注册**——必须在 callback 体内调用 section()
24
+ * · text 必须同步(async 会让模型看到 "[object Promise]")
25
+ *
26
+ * HTTP 注册:
27
+ * ctx.inject(['webServer'], (wctx) => {
28
+ * wctx.get('webServer').register({ kind: 'prefix', path: '/api/git-push', handler });
29
+ * });
30
+ *
31
+ * 斜杠命令(用户输入框 /git-audit):
32
+ * ctx.inject(['commands'], (cctx) => {
33
+ * (cctx.commands || cctx.get('commands')).register({ name, description, input, handler });
34
+ * });
35
+ * · name 小写,无前导斜杠;handler 返回 { kind:'success'|'error', text }
36
+ * · 结果只给 UI,不进模型历史
37
+ *
38
+ * 客户端(设置侧边栏 / 插件配置卡):
39
+ * **不在这里注册**——DSH 依据 package.json 的 dsh.client + exports["./client"]
40
+ * 自动发现浏览器半侧(见 @deepseek-ai/dsh-client-ui-settings 系列)。
41
+ *
42
+ * 本模块只做「接线」:把 listTools() / callTool() / handleHttp() 挂到 DSH 服务上,
43
+ * 不含业务逻辑,便于用 mock ctx 单测「真 API 是否被调用」。
44
+ */
45
+
46
+ /**
47
+ * 统一的工具结果渲染器:返回**块数组**(硬约定,见文件头说明)。
48
+ * @param {object} _args
49
+ * @param {unknown} value
50
+ * @returns {Array<{type:string,text:string}>}
51
+ */
52
+ export function textRender(_args, value) {
53
+ return [{ type: 'text', text: String(value) }];
54
+ }
55
+
56
+ /**
57
+ * 把简写参数 spec(`{ repo: 'string' }`)规范成 DSH 参数形状(`{ repo: { type, description } }`)。
58
+ * 两种写法都接受:简写字符串(末尾 `?` 仅作提示,不产生 required)与完整对象。
59
+ * @param {Record<string, string|object>} [parameters]
60
+ * @returns {Record<string, {type:string, description:string}>}
61
+ */
62
+ export function normalizeParameters(parameters = {}) {
63
+ const out = {};
64
+ for (const [key, spec] of Object.entries(parameters || {})) {
65
+ if (spec && typeof spec === 'object') {
66
+ out[key] = { type: String(spec.type || 'string'), description: String(spec.description || '') };
67
+ } else {
68
+ const raw = String(spec || 'string');
69
+ out[key] = { type: raw.replace(/\?$/, '') || 'string', description: '' };
70
+ }
71
+ }
72
+ return out;
73
+ }
74
+
75
+ /**
76
+ * 把 listTools() 的声明 + callTool 分发器组装成 defineTool 需要的完整规格。
77
+ * @param {Array<{name:string,description:string,parameters?:object}>} tools
78
+ * @param {(name:string,args:object)=>Promise<unknown>} invoke
79
+ * @returns {Array<object>} defineTool 规格数组
80
+ */
81
+ export function buildToolSpecs(tools = [], invoke) {
82
+ return tools.map((tool) => ({
83
+ name: tool.name,
84
+ description: tool.description,
85
+ parameters: normalizeParameters(tool.parameters),
86
+ output: { schema: { type: 'string' }, render: textRender },
87
+ execute: async (args, exec) => {
88
+ // 透传 exec 给 invoke(宿主在 execute(args, exec) 注入 exec.agent 等上下文)——
89
+ // 调用方(callTool)需要 exec.agent 作为 jobs.start 的 owner,控制器才能放行该任务。
90
+ const toolOut = await invoke(tool.name, args || {}, exec);
91
+ return typeof toolOut === 'string' ? toolOut : JSON.stringify(toolOut, null, 2);
92
+ },
93
+ }));
94
+ }
95
+
96
+ /** 防御式日志(ctx.log 可能不完整)。 */
97
+ function warn(log, msg) {
98
+ try { log?.warn?.(msg); } catch { /* 日志失败不影响接线 */ }
99
+ }
100
+
101
+ /**
102
+ * 注册 agent 工具(每工具独立 try/catch:单个失败不影响其余)。
103
+ * @returns {number} 注册成功的工具数
104
+ */
105
+ export function registerTools(ctx, { defineTool, tools, invoke, log } = {}) {
106
+ if (typeof ctx?.inject !== 'function') return 0;
107
+ if (typeof defineTool !== 'function') {
108
+ warn(log, 'dsh-git-push: @deepseek-ai/dsh-tools 不可用,工具未注册');
109
+ return 0;
110
+ }
111
+ let count = 0;
112
+ ctx.inject(['tools'], (tctx) => {
113
+ const registry = tctx?.get?.('tools');
114
+ if (!registry?.register) {
115
+ warn(log, 'dsh-git-push: tools 服务不可用,工具未注册');
116
+ return;
117
+ }
118
+ for (const spec of buildToolSpecs(tools, invoke)) {
119
+ try {
120
+ registry.register(defineTool(spec));
121
+ count += 1;
122
+ } catch (e) {
123
+ warn(log, `dsh-git-push: 工具 ${spec.name} 注册失败: ${e?.message || e}`);
124
+ }
125
+ }
126
+ });
127
+ return count;
128
+ }
129
+
130
+ /**
131
+ * 注册系统提示词段落(text 必须是同步函数)。
132
+ * @param {Array<{name:string, order:number, text:()=>string}>} sections
133
+ * @returns {number} 注册段数
134
+ */
135
+ export function registerContext(ctx, { sections = [], log } = {}) {
136
+ if (typeof ctx?.inject !== 'function') return 0;
137
+ let count = 0;
138
+ ctx.inject(['systemPrompt'], (sctx) => {
139
+ const sp = sctx?.get?.('systemPrompt');
140
+ if (!sp?.section) {
141
+ warn(log, 'dsh-git-push: systemPrompt 服务不可用,注入未生效');
142
+ return;
143
+ }
144
+ for (const section of sections) {
145
+ try {
146
+ sp.section({
147
+ name: section.name,
148
+ order: section.order,
149
+ text: () => String(section.text() ?? ''),
150
+ });
151
+ count += 1;
152
+ } catch (e) {
153
+ warn(log, `dsh-git-push: 注入段 ${section.name} 失败: ${e?.message || e}`);
154
+ }
155
+ }
156
+ });
157
+ return count;
158
+ }
159
+
160
+ /**
161
+ * 注册上下文注入(agent/pre-step):每个 agent 首次 step 注入一次环境信息。
162
+ *
163
+ * 环境注入(工作区目录 + 工具安装路径 + skill 总入口)从 systemPrompt
164
+ * section 迁到这里——工具探测结果不再每步注入系统提示词,改为上下文首条 user 消息
165
+ * 注入(参考 dsh-skill-scoreboard v1.4.0 的相同时机与形态:WeakSet 防重复 +
166
+ * createUserMessage 追加消息 + source 标记 plugin instructions)。
167
+ *
168
+ * 与 A 通道的分工:使用/阅读/要求清单仍走 systemPrompt.section(每步组装都带);
169
+ * 环境信息体积小且只需一次,走 pre-step。总开关 injectSystemPrompt 同时门控两通道。
170
+ *
171
+ * 注入失败 / 无内容 / 被拒 / 已中止时原样放行,不影响主链路。
172
+ * @param {object} ctx DSH 上下文(需 ctx.on)
173
+ * @param {object} o { envInjectText: ()=>string 同步, log }
174
+ * @returns {boolean} 是否已接线
175
+ */
176
+ export function registerPreStepInjection(ctx, { envInjectText, log } = {}) {
177
+ if (typeof ctx?.on !== 'function' || typeof envInjectText !== 'function') return false;
178
+ const injectedAgents = new WeakSet();
179
+ ctx.on('agent/pre-step', async ({ agent, signal }, next) => {
180
+ const decision = await next();
181
+ if (decision?.kind === 'reject' || signal?.aborted) return decision;
182
+ if (!agent || injectedAgents.has(agent)) return decision;
183
+ injectedAgents.add(agent);
184
+ try {
185
+ // 注入 cwd 取**会话工作区**(agent.session.header.cwd,与本机宿主
186
+ // sandbox-policy 的 resolve 同源:`session?.header.cwd ?? this.workspaceRoot`),
187
+ // 而不是宿主全局 workspaceRoot(= DSH 安装根)——否则 AI 拿到的 cwd/项目根/
188
+ // 工作区子目录全是框架根,任务落位全错。无 session(非会话场景)回退默认。
189
+ const sessionCwd = (agent.session && agent.session.header && agent.session.header.cwd) || '';
190
+ const text = String(envInjectText(sessionCwd) ?? '');
191
+ if (!text) return decision;
192
+ const { createUserMessage } = await import('@deepseek-ai/dsh-llm');
193
+ if (typeof createUserMessage !== 'function') {
194
+ warn(log, 'dsh-git-push: @deepseek-ai/dsh-llm 的 createUserMessage 不可用,上下文注入跳过');
195
+ return decision;
196
+ }
197
+ const msg = createUserMessage({
198
+ content: [{ type: 'text', text }],
199
+ source: { kind: 'plugin:dsh-git-push', plugin: 'dsh-git-push', form: 'instructions' },
200
+ });
201
+ return { ...decision, messages: [...(decision.messages || []), msg] };
202
+ } catch (e) {
203
+ warn(log, `dsh-git-push: 上下文注入失败: ${e?.message || e}`);
204
+ return decision;
205
+ }
206
+ });
207
+ return true;
208
+ }
209
+
210
+ /**
211
+ * 注册 HTTP 前缀路由(真实 API:webServer.register({kind:'prefix', path, handler}))。
212
+ * @returns {boolean} 是否已接线
213
+ */
214
+ export function registerHttp(ctx, { path = '/api/git-push', handler, log } = {}) {
215
+ if (typeof ctx?.inject !== 'function') return false;
216
+ let wired = false;
217
+ ctx.inject(['webServer'], (wctx) => {
218
+ const webServer = wctx?.get?.('webServer');
219
+ if (!webServer?.register) {
220
+ warn(log, 'dsh-git-push: webServer 服务不可用,HTTP 端点未注册');
221
+ return;
222
+ }
223
+ try {
224
+ webServer.register({ kind: 'prefix', path, handler });
225
+ wired = true;
226
+ } catch (e) {
227
+ warn(log, `dsh-git-push: HTTP 注册失败: ${e?.message || e}`);
228
+ }
229
+ });
230
+ return wired;
231
+ }
232
+
233
+ /**
234
+ * 动态加载 defineTool(工作区自测环境没有 DSH 依赖,故不静态 import)。
235
+ * 运行时(装在 profile 内)一定解析得到;解析不到时返回 null 并告警,插件其余部分照常。
236
+ * 测试注入点:setDefineToolOverride(fn) 供单测喂 mock(见 test-plugin.mjs)。
237
+ * @returns {Promise<Function|null>}
238
+ */
239
+ let defineToolOverride = null;
240
+ export function setDefineToolOverride(fn) { defineToolOverride = fn; }
241
+ export async function loadDefineTool(log) {
242
+ if (defineToolOverride) return defineToolOverride;
243
+ try {
244
+ const mod = await import('@deepseek-ai/dsh-tools');
245
+ return typeof mod?.defineTool === 'function' ? mod.defineTool : null;
246
+ } catch (e) {
247
+ warn(log, `dsh-git-push: 加载 @deepseek-ai/dsh-tools 失败: ${e?.message || e}`);
248
+ return null;
249
+ }
250
+ }
@@ -0,0 +1,38 @@
1
+ # README 生成模板(yml 化)
2
+ # git_gen_readme 的 README 骨架模板——本体收进 yml 文件,改章节结构不再动代码。
3
+ # 用法:
4
+ # - header:封面区(# 标题 + 引言),{{name}}/{{description}} 占位符原样保留
5
+ # - sections:章节列表,每项 title = ## 章节标题,body = 章节模板文本
6
+ # - 占位符(生成时替换):{{name}} 项目名 / {{description}} 简介 / {{version}} 版本 /
7
+ # {{toc}} 目录(自动从章节生成) / {{versionTable}} 版本记录表(git log 版本组)
8
+ # 优先级:插件 template/README.md(用户自定义整份 md)> 本 yml > 代码内置兜底骨架。
9
+ metadata:
10
+ name: "README 生成模板(yml 化)"
11
+ author: "EIGHTfs"
12
+ version: "1.0.0"
13
+ description: "git_gen_readme 生成的 README 骨架:header + 章节列表;加章/改章/调序只改本文件"
14
+
15
+ # 封面区(# 标题 + 引言;title=一级标题行,intro=引言行,渲染为 markdown 封面)
16
+ # 注:不用块标量(header: |)——L0 yamlCheck 是启发式行检查,块标量内容行(如 "> {{description}}")会被误报
17
+ header:
18
+ title: "# {{name}}"
19
+ intro: "> {{description}}"
20
+
21
+ # 章节列表(按顺序渲染为 ## 标题 + body;{{toc}}/{{versionTable}} 等占位符由生成器替换)
22
+ sections:
23
+ - title: 目录
24
+ body: "{{toc}}"
25
+ - title: 架构设计
26
+ body: "<!-- INSERT: 项目核心架构说明(分层/组件/模块/关键设计决策) -->"
27
+ - title: 文件目录结构及作用
28
+ body: "<!-- INSERT: 关键文件/目录清单 + 每项作用说明 -->"
29
+ - title: 启动脚本
30
+ body: "<!-- INSERT: start.sh 用法:start / stop / restart / status,含端口与环境要求 -->"
31
+ - title: API 总览
32
+ body: "<!-- INSERT: | 方法 | 路径 | 说明 |(每行路径跳转到对应详细说明锚点) -->"
33
+ - title: 版本列表
34
+ body: "{{versionTable}}"
35
+ - title: 注意事项
36
+ body: "<!-- INSERT: 踩过的坑、边界条件、依赖环境要求、已知限制 -->"
37
+ - title: 开发计划 / 疑难杂症
38
+ body: "<!-- INSERT: 待办功能、已知问题、未解决的技术难题 -->"
@@ -0,0 +1,62 @@
1
+ /**
2
+ * 编译层 · 凭据类 kind(三个,对应原文件「凭据三类」分段)
3
+ *
4
+ * credential-ref(代码里引用凭据变量)、credential-file(凭据文件入库)、
5
+ * [FUNC]([FUNC]/secret- 前缀规则的 pattern 批量编译,安全红线类规则用它)。
6
+ * 三者的共同点是「什么算凭据」的判定语汇,拆开会让判定散落多处,故合成一个模块。
7
+ */
8
+
9
+ import { registerCompiler } from '../registry.js';
10
+ import { DIMENSIONS, ruleOut, safeRe, severityLevel, pickDimensions } from './helpers.js';
11
+
12
+ /* ───────────────────────── 注册:凭据三类 ───────────────────────── */
13
+
14
+ registerCompiler(
15
+ 'credential-ref',
16
+ (r) => /^credref-/.test(r?.id || ''),
17
+ (r, ctx) => {
18
+ const list = [r.pattern, ...(Array.isArray(r.patterns) ? r.patterns : [])].filter(Boolean)
19
+ .map((p) => safeRe(p, r?.name || r?.id, ctx.errors)).filter(Boolean);
20
+ return ruleOut({
21
+ id: r.id, name: r.name || r.id, kind: 'credential-ref', severity: r.severity,
22
+ // patterns 必须传编译后 RegExp(checks.js 直接 p.test(line))
23
+ pattern: list[0], patterns: list.length > 1 ? list.slice(1) : undefined,
24
+ message: r.description || r.name || '凭据引用模式',
25
+ dimensions: pickDimensions(r, [DIMENSIONS.安全性], ctx?.errors),
26
+ });
27
+ },
28
+ );
29
+
30
+ registerCompiler(
31
+ 'credential-file',
32
+ (r) => /^credfile-/.test(r?.id || ''),
33
+ (r, ctx) => {
34
+ const re = safeRe(r?.path_pattern || r?.pathPattern || '', r?.name || r?.id, ctx.errors);
35
+ return ruleOut({
36
+ id: r.id, name: r.name || r.id, kind: 'credential-file', severity: r.severity,
37
+ // bugfix:补 level(severityLevel:error→blocker)。原缺省默认 warning,
38
+ // 导致 checkCredentialFiles 的 capSeverity('error', 'blocker') 永远不升 blocker,
39
+ // 与文档契约「yml error → 引擎级 blocker 拦截」不一致,.env 等凭据文件提交不拦截。
40
+ level: severityLevel(r.severity),
41
+ pathPattern: re?.source,
42
+ message: r.description || '凭据文件(路径模式)',
43
+ dimensions: pickDimensions(r, [DIMENSIONS.安全性], ctx?.errors),
44
+ });
45
+ },
46
+ );
47
+
48
+ registerCompiler(
49
+ '[FUNC]',
50
+ (r) => /^(\[FUNC\]|secret)-/.test(r?.id || ''),
51
+ (r, ctx) => {
52
+ const list = [r.pattern, ...(Array.isArray(r.patterns) ? r.patterns : [])].filter(Boolean)
53
+ .map((p) => safeRe(p, r?.name || r?.id, ctx.errors)).filter(Boolean);
54
+ return ruleOut({
55
+ id: r.id, name: r.name || r.id, kind: '[FUNC]', severity: r.severity,
56
+ // patterns 必须传编译后 RegExp(checks.js 直接 p.test(line))
57
+ pattern: list[0], patterns: list.length > 1 ? list.slice(1) : undefined,
58
+ message: r.description || `疑似敏感信息(${r.name || r.id})`,
59
+ dimensions: pickDimensions(r, [DIMENSIONS.安全性], ctx?.errors),
60
+ });
61
+ },
62
+ );
@@ -0,0 +1,38 @@
1
+ /**
2
+ * 编译层 · 数据流类 kind(三层审计 L2 的 yml 侧,)
3
+ *
4
+ * 认领条件:yml 显式声明 kind: "dataflow"。
5
+ * 编译产物:kind=dataflow 的规则对象,携带 filePatterns(L1 文件内容初筛正则,
6
+ * 由 lib/checks/filter.js 的 filterRulesByFileText 消费——未命中 = 非候选文件,
7
+ * 该规则剔除,不进 L2 AST 精查)与 severity/dimensions。
8
+ *
9
+ * 铁律:加字段 = 加函数 + registerCompiler 一行注册;compileRule 主体永不修改。
10
+ * filePatterns 是「规则作用域」的一部分(内容级),与 exts(扩展名级)、
11
+ * exclude_paths(路径级)并列,三者都在 filter 层消费。
12
+ */
13
+
14
+ import { registerCompiler } from '../registry.js';
15
+ import { DIMENSIONS, ruleOut, severityLevel, pickDimensions } from './helpers.js';
16
+
17
+ registerCompiler(
18
+ 'dataflow',
19
+ (r) => r?.kind === 'dataflow',
20
+ (r) => ruleOut({
21
+ id: r.id, name: r.name || r.id, kind: 'dataflow', severity: r.severity || 'warning',
22
+ level: severityLevel(r.severity || 'warning'),
23
+ message: r.description || r.name || '',
24
+ dimensions: pickDimensions(r, [DIMENSIONS.健壮性]),
25
+ extra: {
26
+ // L1 文件内容初筛(filterRulesByFileText 消费):纯正则扫文件文本,
27
+ // 任一命中即候选文件进 L2;未声明 = 不做初筛(全文都算候选)。
28
+ // 字符串条目按子串包含匹配(免转义),RegExp 条目按 test 匹配。
29
+ filePatterns: Array.isArray(r.file_patterns) ? r.file_patterns.map((p) => {
30
+ if (p && typeof p.source === 'string') return new RegExp(p.source); // yml 里 /re/ 字面量形态
31
+ return String(p);
32
+ }) : undefined,
33
+ // L2 判定参数(传给 lib/ast/dataflow.js 的 checkClearAccessAst;缺省用内置默认)
34
+ clearMethods: Array.isArray(r.clear_methods) ? r.clear_methods : undefined,
35
+ accessMethods: Array.isArray(r.access_methods) ? r.access_methods : undefined,
36
+ },
37
+ }),
38
+ );
@@ -0,0 +1,75 @@
1
+ /**
2
+ * 编译层 · 文件健康度 kind
3
+ *
4
+ * file-health:体量/结构/文档三维分级加权算健康分(与单条阈值规则的「超了就报」不同,
5
+ * 它是矩阵评分,故单独成模块)。
6
+ */
7
+
8
+ import { registerCompiler } from '../registry.js';
9
+ import { DIMENSIONS, ruleOut, severityLevel, pickDimensions } from './helpers.js';
10
+
11
+ /* ───────────────────────── 默认参数(规则条目可用 snake_case 字段覆盖) ───────────────────────── */
12
+
13
+ /** 三维权重(合计 1.0):行数 / 大小 / 单行最大长度。 */
14
+ const DEFAULT_WEIGHT_LINES = 0.4;
15
+ const DEFAULT_WEIGHT_SIZE = 0.35;
16
+ const DEFAULT_WEIGHT_LINE_LENGTH = 0.25;
17
+ // 满分基准 / 下限分:与 lib/checks/file-health.js 共用同一来源(lib/audit-defaults.js)——
18
+ // 两处必须永远相等,各写一份会出现「编译器与检查器按不同基准判健康度」的静默不一致
19
+ // (自审 maintainability/duplicate-constant-def 报的真重复)。
20
+ import { HEALTH_BASE_SCORE as BASE_SCORE, HEALTH_MIN_SCORE as MIN_SCORE } from '../../audit-defaults.js';
21
+ /** 行数等级边界(4 个分隔点 → 0~4 级)。 */
22
+ const DEFAULT_LINE_LEVELS = [200, 400, 800, 1500];
23
+ /** 文件大小等级边界(KB)。 */
24
+ const DEFAULT_SIZE_LEVELS = [30, 100, 300, 1000];
25
+ /** 单行最大长度等级边界(字符)。 */
26
+ const DEFAULT_LINE_LENGTH_LEVELS = [120, 200, 300, 500];
27
+ /** 等级扣分表(level 0~4)。 */
28
+ const DEFAULT_PENALTIES = [0, 1.0, 2.5, 4.5, 7.0];
29
+ /** 严重度分界:score < WARN_SCORE 记 warning,< BLOCK_SCORE 记 blocker(与检查层同一来源)。 */
30
+ import { HEALTH_WARN_SCORE as WARN_SCORE, HEALTH_BLOCK_SCORE as BLOCK_SCORE } from '../../audit-defaults.js';
31
+
32
+ /* ───────────────────────── 注册:文件健康度矩阵(file-health,1.0.13) ───────────────────────── */
33
+
34
+ /**
35
+ * 文件健康度矩阵评分(确立算法)。
36
+ * 三维独立分级:行数(≤200/201-400/401-800/801-1500/>1500)、大小 KB(≤30/31-100/101-300/301-1000/>1000)、
37
+ * 单行最大长度(≤120/121-200/201-300/301-500/>500)→ 0~4 级;
38
+ * 加权等级 = 行数×0.40 + 大小×0.35 + 行长×0.25;扣分按等级表线性插值(0→0, 1→1.0, 2→2.5, 3→4.5, 4→7.0);
39
+ * score = max(0.1, 10 - penalty);score≥9 pass / 7≤score<9 warning / 5≤score<7 warning / score<5 blocker。
40
+ * 豁免:*.generated.* 与 *.min.* 与 locales/ 整文件跳过;constants/ 行数等级强制 0;routes/ 行数阈值放宽。
41
+ * 认领条件:kind==='file-health'。规则条目可覆盖参数(weight_lines/weight_size/weight_line_length/base_score)。
42
+ */
43
+ registerCompiler(
44
+ 'file-health',
45
+ (r) => r?.kind === 'file-health',
46
+ (r) => ruleOut({
47
+ id: r.id, name: r.name || r.id, kind: 'file-health', severity: r.severity || 'warning',
48
+ level: severityLevel(r.severity || 'warning'),
49
+ message: r.description || r.name || '',
50
+ dimensions: pickDimensions(r, [DIMENSIONS.可维护性, DIMENSIONS.可读性]),
51
+ extra: {
52
+ // 权重(合计 1.0;规则条目可覆盖)
53
+ weightLines: r.weight_lines !== undefined ? Number(r.weight_lines) : DEFAULT_WEIGHT_LINES,
54
+ weightSize: r.weight_size !== undefined ? Number(r.weight_size) : DEFAULT_WEIGHT_SIZE,
55
+ weightLineLength: r.weight_line_length !== undefined ? Number(r.weight_line_length) : DEFAULT_WEIGHT_LINE_LENGTH,
56
+ baseScore: r.base_score !== undefined ? Number(r.base_score) : BASE_SCORE,
57
+ // 等级边界(可覆盖:lines_levels/size_levels/line_length_levels 各 4 个阈值分隔点)
58
+ lineLevels: Array.isArray(r.lines_levels) ? r.lines_levels.map(Number) : [...DEFAULT_LINE_LEVELS],
59
+ sizeLevels: Array.isArray(r.size_levels) ? r.size_levels.map(Number) : [...DEFAULT_SIZE_LEVELS],
60
+ lengthLevels: Array.isArray(r.line_length_levels) ? r.line_length_levels.map(Number) : [...DEFAULT_LINE_LENGTH_LEVELS],
61
+ // 扣分表(level 0~4)
62
+ penalties: Array.isArray(r.level_penalties) ? r.level_penalties.map(Number) : [...DEFAULT_PENALTIES],
63
+ // 豁免(路径包含命中即按规则处理)
64
+ exemptSkip: ['generated.', '.min.', '/locales/', 'locales/'],
65
+ exemptConstants: ['/constants/', 'constants/'],
66
+ exemptRoutes: ['/routes/', 'routes/'],
67
+ // 只对代码文件评健康度——md/txt/json/yml 文档的「行数/行长」不是
68
+ // 代码健康问题(README 表格行天然超长、文档天然几百行),对文档评会误报。
69
+ exts: Array.isArray(r.exts) ? r.exts.map((x) => String(x).toLowerCase().replace(/^\./, '')) : undefined,
70
+ // 阈值:warning 与 blocker 分界(score<warnScore 报 warning,<blockScore 报 blocker)
71
+ warnScore: r.warn_score !== undefined ? Number(r.warn_score) : WARN_SCORE,
72
+ blockScore: r.block_score !== undefined ? Number(r.block_score) : BLOCK_SCORE,
73
+ },
74
+ }),
75
+ );
@@ -0,0 +1,86 @@
1
+ /**
2
+ * 编译层 · 前端与工程约定类 kind(三个)
3
+ *
4
+ * button-bind(按钮是否绑定动作)、magic-number-smart(硬编码魔数,含版本号豁免)、
5
+ * patch-insert(bundle patch 必须顶层 insert)。
6
+ */
7
+
8
+ import { registerCompiler } from '../registry.js';
9
+ import { DIMENSIONS, ruleOut, severityLevel, pickDimensions } from './helpers.js';
10
+
11
+ /* ───────────────────────── 注册:按钮事件绑定(button-bind,1.0.5 油猴脚本版) ───────────────────────── */
12
+
13
+ /**
14
+ * 按钮事件绑定交叉比对(油猴脚本/浏览器扩展专用)。
15
+ * 认领条件:显式 kind==='button-bind',或 category==='button' 且无 patterns/path_pattern(交叉比对型)。
16
+ * 编译产物:保留 id/severity/message/extra(checkButtonBindings 做同文件交叉比对)。
17
+ * 场景:HTML 以字符串内嵌 JS(innerHTML/insertAdjacentHTML/模板字符串/createElement),
18
+ * 事件在 JS 里 addEventListener/onclick= 绑定——不能只看 inline onclick。
19
+ */
20
+ registerCompiler(
21
+ 'button-bind',
22
+ (r) => r?.kind === 'button-bind' || (r?.category === 'button' && !Array.isArray(r?.patterns) && !r?.pattern && !r?.path_pattern),
23
+ (r) => ruleOut({
24
+ id: r.id, name: r.name || r.id, kind: 'button-bind', severity: r.severity || 'warning',
25
+ level: severityLevel(r.severity || 'warning'),
26
+ message: r.description || r.name || '',
27
+ dimensions: pickDimensions(r, [DIMENSIONS.可维护性]),
28
+ extra: {
29
+ buttonInsertPatterns: Array.isArray(r?.insertion_patterns) ? r.insertion_patterns : [],
30
+ bindPatterns: Array.isArray(r?.binding_patterns) ? r.binding_patterns : [],
31
+ },
32
+ }),
33
+ );
34
+
35
+ /* ───────────────────────── 注册:硬编码魔数检测(magic-number-smart,1.0.7 版本号豁免版) ───────────────────────── */
36
+
37
+ /**
38
+ * 智能硬编码魔数检测(规则来源:审计规则 YAML「硬编码魔数检测规则(版本号豁免版)」——版本号/HTTP 状态码等合法数字豁免)。
39
+ * 认领条件:kind==='magic-number-smart',或 id 含 magic-number-smart。
40
+ * 编译产物:保留 magicHints/legitHints/forceCount 到 extra(checkMagicNumberSmart 消费)。
41
+ * 合并:readability/magic-number(纯 regex 快速版)已并入本规则——smart 按
42
+ * 「数字 + 上下文 + 豁免清单」精确判定,覆盖运算/比较里的全部数字字面量形态,
43
+ * 版本号/日期/HTTP 状态码/常见合法常量/状态枚举/命名常量值不报。
44
+ */
45
+ registerCompiler(
46
+ 'magic-number-smart',
47
+ (r) => r?.kind === 'magic-number-smart' || /magic-number-smart/.test(r?.id || ''),
48
+ (r) => ruleOut({
49
+ id: r.id, name: r.name || r.id, kind: 'magic-number-smart', severity: r.severity || 'warning',
50
+ level: severityLevel(r.severity || 'warning'),
51
+ message: r.description || r.name || '',
52
+ dimensions: pickDimensions(r, [DIMENSIONS.可维护性]),
53
+ extra: {
54
+ magicHints: Array.isArray(r?.magic_number_hints) ? r.magic_number_hints : [],
55
+ legitHints: Array.isArray(r?.legitimate_hints) ? r.legitimate_hints : [],
56
+ forceCount: Number(r?.force_count) || 3,
57
+ // 透传 exts/excludePaths——魔数检测只对代码文件生效
58
+ // (README/CSS/JSON 里的版本号、端口、尺寸是正常书写,不构成硬编码魔数)
59
+ exts: Array.isArray(r.exts) ? r.exts.map((x) => String(x).toLowerCase().replace(/^\./, '')) : undefined,
60
+ excludePaths: Array.isArray(r.exclude_paths) ? r.exclude_paths.map(String) : undefined,
61
+ },
62
+ }),
63
+ );
64
+
65
+ /* ───────────────────────── 注册:patch insert 语义(patch-insert,1.1.1) ───────────────────────── */
66
+
67
+ /**
68
+ * cordis.patch.yml insert 语义检查(修复误报)。
69
+ * 认领条件:kind==='patch-insert'。
70
+ * 编译产物:透传 exts(只对 yml/yaml 生效)与 message,检查器做语义判定:
71
+ * 仅在「insert 块内的 id 与顶层按 id 覆盖行(非 insert 的 - id 行)同 id」时报,
72
+ * 替代旧「命中 insert: 行即提示」——纯 insert(无覆盖行同 id)不再误报。
73
+ */
74
+ registerCompiler(
75
+ 'patch-insert',
76
+ (r) => r?.kind === 'patch-insert',
77
+ (r) => ruleOut({
78
+ id: r.id, name: r.name || r.id, kind: 'patch-insert', severity: r.severity || 'warning',
79
+ level: severityLevel(r.severity || 'warning'),
80
+ message: r.description || r.name || '',
81
+ dimensions: pickDimensions(r, [DIMENSIONS.健壮性, DIMENSIONS.可部署性]),
82
+ extra: {
83
+ exts: Array.isArray(r.exts) ? r.exts.map((x) => String(x).toLowerCase().replace(/^\./, '')) : ['yml', 'yaml'],
84
+ },
85
+ }),
86
+ );
@@ -0,0 +1,35 @@
1
+ /**
2
+ * 编译层 · 函数行数 kind
3
+ *
4
+ * func-lines(单函数行数阈值):yml 里 max_lines 且 name 含函数语义时走这里。
5
+ * 与 numeric-kinds 的 max-lines 区分:max-lines 管整文件行数。
6
+ */
7
+
8
+ import { registerCompiler } from '../registry.js';
9
+ import { DIMENSIONS, ruleOut, severityLevel, pickDimensions } from './helpers.js';
10
+
11
+ /* ───────── 函数行数默认阈值 ───────── */
12
+ // 与 lib/checks/structural.js 共用同一来源(lib/audit-defaults.js)——两处必须永远相等,
13
+ // 各写一份会出现「编译器按 50 收口、检查器按别的值判定」的静默不一致(自审 duplicate-constant 报的真重复)
14
+ import { FUNC_LINES_DEFAULT } from '../../audit-defaults.js';
15
+
16
+ /* ───────────────────────── 注册:函数行数 ───────────────────────── */
17
+
18
+ registerCompiler(
19
+ 'func-lines',
20
+ (r) => r?.id === 'func-lines' || (r?.max_lines !== undefined && /(function|函数|方法)/i.test(r?.name || '')),
21
+ (r) => {
22
+ const threshold = Number(r.max_lines) || FUNC_LINES_DEFAULT;
23
+ return ruleOut({
24
+ id: r.id, name: r.name || r.id, kind: 'func-lines', severity: r.severity,
25
+ level: severityLevel(r.severity), threshold,
26
+ message: r.description || '单函数超长难读,应拆分',
27
+ dimensions: pickDimensions(r, [DIMENSIONS.可读性, DIMENSIONS.可维护性]),
28
+ extra: {
29
+ blockThreshold: threshold * 2 || 100,
30
+ // 透传 exts(函数长度只对代码文件有意义)
31
+ exts: Array.isArray(r.exts) ? r.exts.map((x) => String(x).toLowerCase().replace(/^\./, '')) : undefined,
32
+ },
33
+ });
34
+ },
35
+ );
@@ -0,0 +1,71 @@
1
+ /**
2
+ * 编译层 · 共享助手
3
+ *
4
+ * safeRe(正则编译 + 错误收集)、DIMENSIONS(评分维度表)、
5
+ * ruleOut(编译结果统一出参结构)、severityLevel(严重度 → 评分等级映射)。
6
+ * 各 kind 编译器共用这些助手,故独立成模块避免互相 import。
7
+ */
8
+
9
+ /**
10
+ * 正则安全编译(非法正则不抛异常,收集错误返回 null)。
11
+ *
12
+ * 1.0.0 修复:默认加 `i` 标志——规则本意是匹配「凭据/关键词写法」,
13
+ * 大小写不敏感才正确(原实现漏检 apiKey / API_KEY 等驼峰与大写写法)。
14
+ * 规则可用 `(?i)`(同义)、或 `(?-i)` 显式要求大小写敏感。
15
+ */
16
+ export function safeRe(pattern, label, errors = []) {
17
+ try {
18
+ let src = String(pattern);
19
+ let flags = 'i';
20
+ if (src.startsWith('(?-i)')) { flags = ''; src = src.slice(5); }
21
+ else if (src.startsWith('(?i)')) src = src.slice(4);
22
+ return new RegExp(src, flags);
23
+ } catch (e) {
24
+ errors.push(`规则「${label}」正则非法 ${pattern}: ${e.message}`);
25
+ return null;
26
+ }
27
+ }
28
+
29
+ export const DIMENSIONS = {
30
+ 可读性: '可读性', 可维护性: '可维护性', 健壮性: '健壮性', 安全性: '安全性', 性能: '性能',
31
+ 测试覆盖: '测试覆盖', 可观测性: '可观测性', 可部署性: '可部署性', 文档: '文档', 开发者体验: '开发者体验',
32
+ };
33
+
34
+ /**
35
+ * 维度统一解析(统一维度绑定机制):
36
+ * yml 规则条目显式声明 dimensions 时优先(支持一字段多维度);
37
+ * 未声明则回退编译器内置默认维度。
38
+ * 校验:非数组/空数组/含非 10 维度名的条目 → 报错收集 + 回退默认(防静默错绑)。
39
+ * @param {object} r yml 规则条目
40
+ * @param {string[]} fallback 编译器默认维度
41
+ * @param {string[]} [errors] 编译错误收集(可选)
42
+ */
43
+ export function pickDimensions(r = {}, fallback = [], errors = []) {
44
+ const declared = Array.isArray(r.dimensions) ? r.dimensions : undefined;
45
+ if (!declared || !declared.length) return [...fallback];
46
+ const valid = Object.values(DIMENSIONS);
47
+ const bad = declared.filter((d) => !valid.includes(String(d)));
48
+ if (bad.length) {
49
+ errors.push(`规则「${r?.id || r?.name || '?'}」dimensions 含未知维度(${bad.join('、')}),回退默认 [${fallback.join('、')}]`);
50
+ return [...fallback];
51
+ }
52
+ return [...new Set(declared.map(String))];
53
+ }
54
+
55
+ /** 统一规则对象形状(编译出口)。 */
56
+ export function ruleOut({ id, name, kind, severity = 'warning', level = 'warning', message, pattern, patterns, pathPattern, threshold, dimensions = [], extra = {} }) {
57
+ return {
58
+ ok: true,
59
+ rule: {
60
+ id, name, kind, severity, level, message,
61
+ ...(pattern ? { pattern } : {}),
62
+ ...(patterns?.length ? { patterns } : {}),
63
+ ...(pathPattern ? { pathPattern } : {}),
64
+ ...(threshold !== undefined ? { threshold } : {}),
65
+ dimensions: [...new Set(dimensions)],
66
+ ...extra,
67
+ },
68
+ };
69
+ }
70
+
71
+ export const severityLevel = (s) => ({ error: 'blocker', warning: 'warning', info: 'pass' }[String(s || 'warning')] || 'warning');