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,662 @@
1
+ /**
2
+ * 插件入口层 · 工具调用分发
3
+ *
4
+ * callTool 把宿主的工具调用分发到各能力(审计/推送/扫描/账号…),
5
+ * readTextSafe 是它的读文件兜底(不存在返回空串而非抛错)。
6
+ * 与 HTTP 处理分开:两条入口(工具 / HTTP)的鉴权与返回形态完全不同。
7
+ */
8
+
9
+ import { existsSync, readFileSync } from 'node:fs';
10
+ import { MAX_MSG_PREVIEW } from './constants.js';
11
+ import { access } from 'node:fs/promises';
12
+ /** blocked 消息预览截断长度(工具返回精简——完整 message 走审计明细)。 */
13
+ import { join } from 'node:path';
14
+ import { fileURLToPath } from 'node:url';
15
+ import { spawnSync } from 'node:child_process';
16
+ import './host-doc-checks.js'; // 审计包边界:文档漂移检查器由宿主注入(导入即接线,见 lib/app/host-doc-checks.js)
17
+ import { auditWithScope, auditFull, summarize } from '../audit/index.js';
18
+ import { formatAnalysisCoverageLine } from '../audit/analysis-coverage.js';
19
+ import { scoreQuality } from '../score/index.js';
20
+ import {
21
+ cloneViaApi, previewClone, resolveMaxCloneFileMB, ensureRemoteRepo, setVisibility, maintainRepoIndex, updateRepoIndex, resolveToken, commitAndPush,
22
+ scanReposAsync, scanRepos, checkGithubAccount, formatGithubAccountBlock, generateSshKey, persistSshPub,
23
+ refreshAccountStatus,
24
+ } from '../git/index.js';
25
+ import { runAudit } from '../commit-push.js';
26
+
27
+ /* ───────── 工具调用常量 ───────── */
28
+ import { defaultConfig } from '../client/index.js';
29
+ import { checkLinks, sumLinkPenalty } from '../link-check/index.js';
30
+ import { scanFileIo } from '../../scripts/scan-file-io.mjs';
31
+ import { runModuleSplitter } from '../git/module-splitter.js';
32
+ import { callIdentityRewrite } from './handlers/identity-rewrite.js';
33
+ import { MSG_REPO_REQUIRED } from './constants.js';
34
+ import { buildAuditApiGuide } from './inject-text.js';
35
+ import { exemptStatsOf, GROUP_BY_KEYS } from './audit-api.js';
36
+ import { setLastSlotHitStats } from './slot-stats.js';
37
+ import { getDefaultScanRoot } from './scan-root.js';
38
+
39
+ /**
40
+ * 工具调用分发(薄适配:参数 → 总入口函数)。
41
+ * @param {string} toolName
42
+ * @param {object} args
43
+ * @param {object} env { workspaceRoot, extraRepos }
44
+ * @param {object} cfg 插件配置
45
+ * @param {object} [log]
46
+ * @param {object} [jobs] 宿主 ctx.jobs(dsh-jobs-local 提供);缺省时 commit+push 同步执行
47
+ * @returns {Promise<object>}
48
+ */
49
+ /**
50
+ * git_commit_push 工具实现(从 callTool switch 抽出):
51
+ * 审计同步即时拦截(保住提交门禁)→ 通过后 commit+push+索引重建注册为宿主官方
52
+ * 后台 job(ctx.jobs);宿主无 job 控制器时同步执行保底(幂等安全)。
53
+ */
54
+ /** commitWithAudit 成功后的推送后置步骤:索引重建 + 账号状态刷新(fire-and-forget,失败静默)。
55
+ * 从 callCommitPush 拆分(削减其行数/复杂度)。 */
56
+ async function pushWithPostSteps(args, env, cfg) {
57
+ const r = await commitAndPush({
58
+ repoPath: args.repo,
59
+ message: args.message,
60
+ push: args.push !== false,
61
+ dryRun: args.dryRun === true,
62
+ customIgnorePatterns: args.ignorePatterns || '',
63
+ requirementsConfirmed: args.requirementsConfirmed === true,
64
+ force: args.force === true,
65
+ pushMethod: cfg.pushMethod || 'ssh',
66
+ // 推送门禁——开启时 push 需显式放行(pushConfirmed:true);未放行返回 PUSH_GATE 拦截
67
+ pushGate: cfg.pushGate === true,
68
+ pushConfirmed: args.pushConfirmed === true,
69
+ // 精确 add 路径(逗号分隔,相对 repo);空 = git add -A 全量
70
+ paths: String(args.paths || ''),
71
+ });
72
+ if (r?.ok && r?.pushed) {
73
+ try {
74
+ // 统一走 updateRepoIndex(mode='rebuild' 合并不全量覆盖),
75
+ // 返回 indexUpdated 随工具结果透传(AI/UI 可据此触发列表重读)
76
+ const idx = await updateRepoIndex({
77
+ workspaceRoot: env.workspaceRoot,
78
+ token: resolveToken({ workspaceRoot: env.workspaceRoot }).token,
79
+ owner: r.push?.owner || 'EIGHTfs',
80
+ mode: 'rebuild',
81
+ });
82
+ if (idx?.ok) r.indexUpdated = true;
83
+ } catch { /* 索引重建失败静默,不阻塞任务结果 */ }
84
+ // 推送成功顺便验证账号并刷新 account-status.json(token/ssh 有效性)——
85
+ // 与本地仓库索引同一时机,fire-and-forget,失败静默。
86
+ try {
87
+ await refreshAccountStatus({ workspaceRoot: env.workspaceRoot });
88
+ } catch { /* 账号状态刷新失败静默 */ }
89
+ }
90
+ return r;
91
+ }
92
+
93
+ /**
94
+ * 把 commit+push 结果映射成宿主后台 job 的 `{status, detail}` —— **不得无条件报「完成」**。
95
+ *
96
+ * 为什么要单独成函数(实测 bug):job spec 原先无论结果如何都返回
97
+ * `{ status: 'completed', detail: 'commit+push done' }`,于是推送失败、被推送门禁拦截、
98
+ * 远端 sha 与本地不一致(假成功)、甚至「无变更」全都显示成「commit+push done」——
99
+ * AI 与用户据此以为推成功了,实际远端没动(历史上 GitHub 返回 500 那次就是这样被误导的)。
100
+ * push.js 内部虽有 verified 三态防线(verified===false → ok:false),但 job 状态把它盖住了。
101
+ *
102
+ * 判据(从结果本身推导,不猜):
103
+ * · ok:false(含 blocked 门禁拦截 / push 失败 / 远端核验不一致)→ status:'failed' + 真实原因
104
+ * · pushed:true 且 verified:false → failed(远端未更新)
105
+ * · pushed:true 且 verified:null → completed,但detail 写明「远端核验未完成」
106
+ * · committed:false → completed + 「无变更:工作区无改动,无需提交(正常)」(真没东西可提交,**不是失败**)
107
+ * —— 这条必须在文案里自证,否则 AI 会以为「没有新提交 ⇒ 调用会报错」而绕开插件手敲 git
108
+ * · 其余(已提交但未推送,如远端已是最新)→ completed + 如实写明未推送及原因
109
+ * @param {object} r commitPushDoPush 的返回
110
+ * @returns {{status:'completed'|'failed', detail:string}}
111
+ */
112
+ export function pushJobOutcome(r = {}) {
113
+ const res = r || {};
114
+ const short = (sha) => String(sha || '').slice(0, 8);
115
+ // 结果里**同时给出本地与远端 HEAD**(比一句 done 直观,且一眼看出通道差异):
116
+ // ssh 通道推的就是本地对象 ⇒ 两者相同;api 通道在远端重建提交 ⇒ 两者不同
117
+ // (见 lib/git/transport.js 的通道说明)。
118
+ const heads = (localSha, remoteSha) => `本地 HEAD ${short(localSha) || '未取到'}|远端 HEAD ${short(remoteSha) || '未取到'}`;
119
+ if (res.ok === false) {
120
+ const why = res.error || (res.blocked ? '推送被拦截' : '未完成');
121
+ return { status: 'failed', detail: res.blocked ? `未推送(被拦截):${why}` : `未完成:${why}` };
122
+ }
123
+ const pushInfo = res.push || {};
124
+ if (res.pushed === true) {
125
+ if (pushInfo.verified === false) {
126
+ return { status: 'failed', detail: `远端未更新:${heads(res.commitSha, pushInfo.remoteSha)}(两者不一致)` };
127
+ }
128
+ if (pushInfo.verified === null || pushInfo.verified === undefined) {
129
+ return { status: 'completed', detail: `已提交并推送,但**远端核验未完成(未核验 ≠ 失败)**:${heads(res.commitSha, pushInfo.remoteSha)}${pushInfo.verifyError ? `(${pushInfo.verifyError})` : '(请自行 ls-remote 复核)'}` };
130
+ }
131
+ if (res.committed === false) {
132
+ return { status: 'completed', detail: `已推送(本次无新提交:工作区无改动,推的是此前已提交的领先内容):${heads(res.commitSha, pushInfo.remoteSha || res.commitSha)}` };
133
+ }
134
+ return { status: 'completed', detail: `已提交并推送(已核验一致):${heads(res.commitSha, pushInfo.remoteSha || res.commitSha)}` };
135
+ }
136
+ // 零改动:正常成功路径(不是失败)——默认文案也自证,且保留调用方 message 优先(兼容既有断言)
137
+ if (res.committed === false) return { status: 'completed', detail: res.message || '无变更:工作区无改动,无需提交(正常,不是错误)' };
138
+ return { status: 'completed', detail: `已提交,未推送:${heads(res.commitSha, '')}|原因:${pushInfo.reason || res.message || '未推送'}` };
139
+ }
140
+
141
+ /**
142
+ * 把 clone 结果映射成 job 的 `{status, detail}` —— 与 pushJobOutcome 同一条原则:
143
+ * 失败就必须报失败,不能一律「clone done」。
144
+ * @param {object} r clone 的返回
145
+ * @returns {{status:'completed'|'failed', detail:string}}
146
+ */
147
+ export function cloneJobOutcome(r = {}) {
148
+ const res = r || {};
149
+ if (res.ok === false || res.error) return { status: 'failed', detail: `克隆未完成:${res.error || '未知原因'}` };
150
+ if (res.canceled) return { status: 'failed', detail: '克隆已取消' };
151
+ return { status: 'completed', detail: '克隆完成' };
152
+ }
153
+
154
+ /** 构造宿主后台 job spec(kind=git-push;run 返回取消句柄 + done Promise)。 */
155
+ function buildCommitPushJobSpec(repo, doPush) {
156
+ return {
157
+ kind: 'git-push',
158
+ label: `commit+push ${repo}`,
159
+ run: () => {
160
+ const done = (async () => {
161
+ try {
162
+ const r = await doPush();
163
+ // 如实映射:失败/未推送/核验不一致都不许报「完成」(见 pushJobOutcome)
164
+ return { ...pushJobOutcome(r), output: JSON.stringify(r) };
165
+ } catch (e) {
166
+ return { status: 'failed', detail: String((e && e.message) || e) };
167
+ }
168
+ })();
169
+ return { cancel: () => {}, done };
170
+ },
171
+ };
172
+ }
173
+
174
+ /**
175
+ * 注册宿主后台 job:先带 owner 试,失败再退「无主」试一次。
176
+ *
177
+ * 宿主契约(packages/jobs/jobs-local:start → resolveOwner → servesOwner):
178
+ * · owner 必须是**有活 agent 的会话 id 字符串**,否则 resolveOwner 直接抛
179
+ * 「session "xxx" has no live agent」;
180
+ * · owner 缺省(unowned)在存在**全局**控制器时同样可注册。
181
+ * 所以「带 owner 失败」≠「不能后台化」——退一步用无主注册往往仍能拿到 jobId。
182
+ * 只有两步都失败才降级同步,并把失败原因带回结果(不再静默降级,便于当场定位)。
183
+ * @returns {{jobId?: string, error?: string}}
184
+ */
185
+ function startHostJob(jobs, spec, owner) {
186
+ const reasons = [];
187
+ if (owner) {
188
+ try { return { jobId: jobs.start({ ...spec, owner }) }; } catch (e) { reasons.push(`owner=${owner} 失败:${(e && e.message) || e}`); }
189
+ }
190
+ try { return { jobId: jobs.start(spec) }; } catch (e) { reasons.push(`unowned 失败:${(e && e.message) || e}`); }
191
+ return { error: reasons.join(' | ') };
192
+ }
193
+
194
+ /**
195
+ * git_clone 工具实现(2026-10-02 功能:clone 注册宿主后台 job):
196
+ * 大仓库下载注册为宿主官方后台 job(ctx.jobs)——工具立即返回 jobId(如 git-clone-1),
197
+ * AI 用宿主 job_output/job_list/job_kill 查询/中止;宿主无 job 控制器时同步执行保底。
198
+ * clone 是只读操作无需审计门禁(与 git_commit_push 的差异点)。
199
+ */
200
+ // clone 工具的同步/后台共用执行体。
201
+ // 修复(实测发现):此前 `cloneViaApi({ target, dest, branch })` **完全没传 token**,
202
+ // 于是工具路径的克隆走**匿名 API**——私有库直接失败、公开库吃匿名限流(60 次/小时),
203
+ // 而 HTTP 路径(handlers/clone.js)与预览路径(下方 previewClone)都带了 token ⇒ 两条路径行为不一致。
204
+ // 同时也没传 maxFileMB(体积上限),会落到 previewClone/cloneViaApi 各自的默认值。
205
+ // 修复方式:把 env/cfg 传进来,按仓库解析 token 并统一体积上限(与 HTTP 路径同口径)。
206
+ async function callCloneJob(args, jobs, exec, log, env = {}, cfg = {}) {
207
+ const doClone = () => cloneViaApi({
208
+ target: args.target, dest: args.dest, branch: args.branch,
209
+ // 真实历史模式:**默认开**。只读访问默认走 gh-proxy 镜像,取原始对象已足够快;
210
+ // 带真实历史的克隆可推回远端、可 git log 读演进,是更合理的默认。
211
+ // 显式传 history=false / 0 / 'false' / '0' 可退回整树快照(与远端无祖先、不能推回)。
212
+ history: args.history === undefined ? true
213
+ : !(args.history === false || args.history === 0 || args.history === '0' || args.history === 'false'),
214
+ historyDepth: Number(args.historyDepth) > 0 ? Number(args.historyDepth) : undefined,
215
+ token: resolveToken({ workspaceRoot: env.workspaceRoot }).token,
216
+ maxFileMB: resolveMaxCloneFileMB(cfg),
217
+ });
218
+ if (!jobs || typeof jobs.start !== 'function') {
219
+ const r = await doClone();
220
+ return { ok: true, async: false, result: r };
221
+ }
222
+ let jobId;
223
+ {
224
+ // owner 必须是**会话 id 字符串**:宿主 jobs-local.resolveOwner(session) → agents.get(session);
225
+ // 传 Agent 对象或不对的 id 会抛「session ... has no live agent」。
226
+ // 带 owner 失败时**不再直接同步**,而是退一步用无主注册(见 startHostJob 注释)。
227
+ const spec = buildCloneJobSpec(args.target, args.dest, doClone);
228
+ const started = startHostJob(jobs, spec, exec?.agent?.id);
229
+ if (started.jobId) {
230
+ jobId = started.jobId;
231
+ } else {
232
+ log?.warn?.(`ctx.jobs 不可用,git_clone 降级同步执行:${started.error}`);
233
+ const r = await doClone();
234
+ return { ok: true, async: false, jobFallback: true, jobFallbackReason: started.error, result: r };
235
+ }
236
+ }
237
+ return { ok: true, async: true, jobId, hint: '已注册宿主后台 job(clone 下载中,结果完成会自动返回);如需主动查:job_output ' + jobId };
238
+ }
239
+
240
+ /**
241
+ * npm_publish 工具实现(照 callCloneJob 的写法)。
242
+ * 默认 dryRun=true(只体检 + `npm publish --dry-run`,**不写 registry**);
243
+ * 真发需 `confirm=true` **且** `dryRun=false`(双闸门,发包不可撤销)。
244
+ * 发包注册为宿主官方后台 job(ctx.jobs)⇒ 工具立即返回 jobId;宿主无 job 控制器时降级同步执行。
245
+ */
246
+ async function callNpmPublishJob(args = {}, jobs, exec, log, env = {}, cfg = {}) {
247
+ // dryRun 三种写法都认:显式 dryRun=false / CLI 的 --no-dry-run / 缺省(默认 true = 最安全)
248
+ const dryRun = !(args.dryRun === false || args.dryRun === 'false' || args['no-dry-run'] === true || args.noDryRun === true);
249
+ if (!dryRun && args.confirm !== true) {
250
+ return { ok: false, blocked: 'need-confirm', error: '真实发布会写入 registry 且不可撤销:需同时传 confirm=true 与 dryRun=false(默认只做 dry-run)' };
251
+ }
252
+ // 懒加载:发包路径不常用,避免插件入口为此多走一次模块解析
253
+ // 注意相对层级:本文件在 lib/app/ ⇒ 到 lib/npm/publish.js 是 '../npm/publish.js'
254
+ const { publishPackage } = await import('../npm/publish.js');
255
+ const doPublish = () => publishPackage({
256
+ dir: String(args.dir || env.workspaceRoot || ''),
257
+ registry: cfg?.npmRegistry || '',
258
+ workspaceRoot: env.workspaceRoot || '',
259
+ dryRun,
260
+ tag: args.tag || 'latest',
261
+ otp: args.otp || '',
262
+ confirm: args.confirm === true,
263
+ });
264
+ const outcome = (r) => (r && r.ok
265
+ ? { status: 'done', output: JSON.stringify(r) }
266
+ : { status: 'failed', detail: String((r && (r.error || r.blocked)) || 'npm publish 失败'), output: JSON.stringify(r || {}) });
267
+ if (!jobs || typeof jobs.start !== 'function') {
268
+ const r = await doPublish();
269
+ return { ok: true, async: false, result: r };
270
+ }
271
+ const spec = {
272
+ kind: 'npm-publish',
273
+ label: `npm publish${dryRun ? ' (dry-run)' : ''} ${args.dir || env.workspaceRoot || ''}`,
274
+ run: () => {
275
+ const done = (async () => {
276
+ try { return outcome(await doPublish()); } catch (e) { return { status: 'failed', detail: String((e && e.message) || e) }; }
277
+ })();
278
+ return { cancel: () => {}, done };
279
+ },
280
+ };
281
+ const started = startHostJob(jobs, spec, exec?.agent?.id);
282
+ if (started.jobId) {
283
+ return {
284
+ ok: true, async: true, jobId: started.jobId, dryRun,
285
+ hint: `已注册宿主后台 job(npm ${dryRun ? 'dry-run ' : ''}发布中,结果完成会自动返回);如需主动查:job_output ${started.jobId}`,
286
+ };
287
+ }
288
+ log?.warn?.(`ctx.jobs 不可用,npm_publish 降级同步执行:${started.error}`);
289
+ const r = await doPublish();
290
+ return { ok: true, async: false, jobFallback: true, jobFallbackReason: started.error, result: r };
291
+ }
292
+
293
+ /** 构造 clone 后台 job spec(kind=git-clone;run 返回取消句柄 + done Promise)。 */
294
+ function buildCloneJobSpec(target, dest, doClone) {
295
+ return {
296
+ kind: 'git-clone',
297
+ label: `clone ${target}${dest ? ` → ${dest}` : ''}`,
298
+ run: () => {
299
+ const done = (async () => {
300
+ try {
301
+ const r = await doClone();
302
+ // 与 commit+push 同一条原则:失败必须报失败(见 cloneJobOutcome)
303
+ return { ...cloneJobOutcome(r), output: JSON.stringify(r) };
304
+ } catch (e) {
305
+ return { status: 'failed', detail: String((e && e.message) || e) };
306
+ }
307
+ })();
308
+ return { cancel: () => {}, done };
309
+ },
310
+ };
311
+ }
312
+
313
+ /**
314
+ * git_commit_push 工具实现(从 callTool switch 抽出):
315
+ * 审计同步即时拦截(保住提交门禁)→ 通过后 commit+push+索引重建注册为宿主官方
316
+ * 后台 job(ctx.jobs);宿主无 job 控制器时同步执行保底(幂等安全)。
317
+ */
318
+ async function callCommitPush(args, env, cfg, log, jobs, exec) {
319
+ const repo = args.repo;
320
+ if (!repo) return { ok: false, error: MSG_REPO_REQUIRED };
321
+ // 后台化(官方 job):审计同步即时拦截(保住提交门禁),
322
+ // blocker 命中 → 立即返回拦截、不执行任何 git 操作;审计通过 → commit+push
323
+ // +索引重建注册为宿主官方后台 job(ctx.jobs,dsh-jobs-local),工具立即返回
324
+ // jobId(如 git-push-1),AI 用宿主自带 job_output/job_list/job_kill 查询。
325
+ const auditGate = await runAudit({
326
+ repoPath: repo,
327
+ audit: args.audit,
328
+ // 不再透传 auditLevel——审计固定走完整流程(正则初筛 + AST 语义检查)
329
+ rulesetDir: args.ruleset,
330
+ slots: cfg.auditRuleOrder && cfg.auditRuleOrder.length ? cfg.auditRuleOrder : undefined,
331
+ cfg,
332
+ });
333
+ if (!auditGate.ok) return auditGate; // { ok:false, blocked:true, audit }
334
+ const doPush = () => pushWithPostSteps(args, env, cfg);
335
+ // 宿主未提供 ctx.jobs(如脱离 DSH 的 CLI/测试环境)→ 同步执行保底
336
+ if (!jobs || typeof jobs.start !== 'function') {
337
+ const r = await doPush();
338
+ return { ok: true, async: false, result: r };
339
+ }
340
+ // 修复:job 控制器**存在但不对当前执行主体服务**时,jobs.start() 会抛
341
+ // 「no job controller serves this agent」——此前未捕获 → 工具报错退出、无法降级,
342
+ // 结果只能人工手推(实测:宿主组合里 dsh-tool-jobs 未挂载到执行会话,start 即抛)。
343
+ // 现在捕获该异常回退同步执行(与「无 ctx.jobs」同一保底路径)。
344
+ // 追加:**必须把 owner 传给 jobs.start**——servesOwner 按 owner 的 scope 链
345
+ // 找控制器(tool-jobs 挂在执行会话组合 = scoped 控制器),不传 owner(undefined)时只查
346
+ // 全局层控制器,scoped 控制器不服务 unowned 任务 → 仍抛错。exec.agent 即当前执行主体。
347
+ let jobId;
348
+ {
349
+ // owner 见 startHostJob 注释:带 owner 失败 ⇒ 先退无主再试,仍失败才同步降级(并带回原因)。
350
+ const spec = buildCommitPushJobSpec(repo, doPush);
351
+ const started = startHostJob(jobs, spec, exec?.agent?.id);
352
+ if (started.jobId) {
353
+ jobId = started.jobId;
354
+ } else {
355
+ log?.warn?.(`ctx.jobs 不可用,git_commit_push 降级同步执行:${started.error}`);
356
+ const r = await doPush();
357
+ return { ok: true, async: false, jobFallback: true, jobFallbackReason: started.error, result: r };
358
+ }
359
+ }
360
+ return { ok: true, async: true, jobId, audit: auditGate.audit, hint: '已注册宿主后台 job(结果完成会自动返回,无需特意查询);如需主动查:job_output ' + jobId };
361
+ }
362
+
363
+ /**
364
+ * code_audit 工具实现(从 callTool switch 抽出):
365
+ * 权重 = 显式传参 > cfg.weightOverrides > 默认;history 走宿主后台 job(无控制器同步降级);
366
+ * 结果带 block 可读总结 + slotStats 供侧边栏规则包命中数。
367
+ */
368
+ /**
369
+ * 构造工具侧审计参数(code_audit 共用;从两处重复提取)。
370
+ * scope 由调用方决定(history=full / 默认 diff+full 判断)。
371
+ */
372
+ function buildAuditOpts(args, cfg, scope) {
373
+ return {
374
+ scope,
375
+ rulesetDir: args.ruleset || '',
376
+ maxScanFiles: cfg.maxScanFiles,
377
+ slots: cfg.auditRuleOrder && cfg.auditRuleOrder.length ? cfg.auditRuleOrder : undefined,
378
+ disabledSlots: Array.isArray(cfg.auditDisabledSlots) ? cfg.auditDisabledSlots : [],
379
+ includeIgnored: args.includeIgnored === true,
380
+ // 分析覆盖率信息项(默认开;coverage:false 关闭——大仓库省一次读取+解析)
381
+ coverage: args.coverage !== false,
382
+ };
383
+ }
384
+
385
+ /**
386
+ * history 模式:历史提交审计(逐提交快照全量 + 落盘报告),宿主后台 job 串行;
387
+ * 与 CLI `audit --history` 同一实现 runHistoryAudit;jobs 缺失/不服务时同步降级。
388
+ */
389
+ async function runHistoryAuditTool(args, env, cfg, jobs, exec, weights) {
390
+ const repo = args.repo;
391
+ const { runHistoryAudit } = await import('../audit/history.js');
392
+ const { resolveReportDir } = await import('../audit/history-report.js');
393
+ const auditOpts = buildAuditOpts(args, cfg, 'full');
394
+ const reportDir = resolveReportDir(repo, args.outDir || '');
395
+ const doHistory = async () => {
396
+ const r = await runHistoryAudit(repo, { since: args.since, until: args.until, outDir: reportDir, auditOpts, weights });
397
+ return { status: r.ok ? 'completed' : 'failed', detail: r.ok ? 'history audit done' : String(r.error || 'failed'), output: JSON.stringify(r) };
398
+ };
399
+ if (!jobs || typeof jobs.start !== 'function') {
400
+ const r = await doHistory();
401
+ return { ok: true, async: false, result: r, reportDir };
402
+ }
403
+ const spec = {
404
+ kind: 'git-push',
405
+ label: `history-audit ${repo}`,
406
+ run: () => { const done = doHistory(); return { cancel: () => {}, done }; },
407
+ };
408
+ // owner 见 startHostJob 注释(带 owner 失败 ⇒ 退无主再试 ⇒ 仍失败才同步并带回原因)。
409
+ const started = startHostJob(jobs, spec, exec?.agent?.id);
410
+ if (started.jobId) {
411
+ return { ok: true, async: true, jobId: started.jobId, reportDir, hint: '历史审计后台 job 已注册(结果完成会自动返回,无需特意查询);如需主动查:job_output ' + started.jobId };
412
+ }
413
+ const r = await doHistory();
414
+ return { ok: true, async: false, jobFallback: true, jobFallbackReason: started.error, result: r, reportDir };
415
+ }
416
+
417
+ async function callCodeAudit(args, env, cfg, log, jobs, exec) {
418
+ const repo = args.repo;
419
+ if (!repo) return { ok: false, error: MSG_REPO_REQUIRED };
420
+ // 修复:权重来源 = 工具参数显式传参 > 侧边栏保存的 cfg.weightOverrides(config.json
421
+ // 回读)> 默认权重表。此前只认 args.weights——侧边栏权重设置保存了但审计完全无视(假保存)。
422
+ const weightSrc = args.weights || (typeof cfg.weightOverrides === 'string' ? cfg.weightOverrides : '');
423
+ let weights = {};
424
+ if (weightSrc) {
425
+ try { weights = JSON.parse(weightSrc); } catch { /* 非法 JSON 回退默认权重 */ }
426
+ }
427
+ if (args.history === true) return runHistoryAuditTool(args, env, cfg, jobs, exec, weights);
428
+ return runStandardAuditTool(args, env, cfg, log, weights);
429
+ }
430
+
431
+ /** standard 模式:diff/full 审计 + 评分 + block 总结。 */
432
+ async function runStandardAuditTool(args, env, cfg, log, weights) {
433
+ const repo = args.repo;
434
+ const auditOpts = buildAuditOpts(args, cfg, 'diff');
435
+ // existsSync → fs.promises.access 异步化(消除 io-risk 高风险警告;语义不变)
436
+ let isGitDir = true;
437
+ try { await access(join(repo, '.git')); } catch { isGitDir = false; }
438
+ const fullScope = args.scope === 'full' || !isGitDir;
439
+ const auditResult = fullScope
440
+ ? await auditFull(repo, auditOpts)
441
+ : await auditWithScope(repo, auditOpts);
442
+ const summary = summarize(auditResult.findings);
443
+ // 0 文件(空目录/diff 0 变动)不评分——scoreQuality 返回 emptyResult 防满分
444
+ const quality = scoreQuality(auditResult.findings, weights, { files: auditResult.files });
445
+ // 审计后直接输出豁免类型统计 + 聚合类型 + 拦截列表(blocker 详情不用查 API)
446
+ const exemptStats = exemptStatsOf(auditResult.findings);
447
+ const blocked = auditResult.findings
448
+ .filter((f) => f.severity === 'blocker')
449
+ .map((f) => ({ file: f.file, line: f.line, rule: f.rule, message: String(f.message || '').slice(0, MAX_MSG_PREVIEW) }));
450
+ // 审计输出改为「级别数量 + 评分 + API 查询用法」——审计明细由聚合 API
451
+ // (/api/git-push/audit)查询,不再内联输出 findings/审计内容(有聚合 API 消费审计结果)。
452
+ const apiGuide = buildAuditApiGuide(repo, { scope: auditResult.scope, summary, quality, exemptStats, blocked, groupByTypes: GROUP_BY_KEYS });
453
+ // 分析覆盖率由审计编排层统一计算(CLI 与工具同一口径,见 lib/audit/orchestrate.js),这里只做透传与展示。
454
+ const analysisCoverage = auditResult.analysisCoverage || null;
455
+ // 缓存按规则包命中数供给 HTTP /rule-slots(侧边栏规则包列表显示实际命中数)
456
+ if (auditResult.slotStats) setLastSlotHitStats(auditResult.slotStats, repo);
457
+ log?.info?.(`code_audit ${repo} → ${quality.emptyResult ? '未评分(0 文件)' : quality.score + '/' + quality.level}(blocker ${summary.blocker} / warning ${summary.warning} / notice ${summary.notice})`);
458
+ // 参数 includeFindings=true 时返回全量审计结果(findings+yaml——恢复 1.11.5 前的直接全量输出;
459
+ // 默认 false 保持精简 apiGuide——审计明细走聚合 API)
460
+ const withFindings = args.includeFindings === true;
461
+ const out = { ok: true, scope: auditResult.scope, files: auditResult.files, summary, quality, exemptStats, blocked, groupByTypes: GROUP_BY_KEYS, apiGuide, slotStats: auditResult.slotStats };
462
+ if (analysisCoverage) {
463
+ out.analysisCoverage = analysisCoverage;
464
+ out.apiGuide = `${apiGuide}\n${formatAnalysisCoverageLine(analysisCoverage)}`;
465
+ }
466
+ if (withFindings) {
467
+ out.findings = auditResult.findings;
468
+ if (auditResult.yaml) out.yaml = auditResult.yaml;
469
+ }
470
+ return out;
471
+ }
472
+
473
+ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfig(), log = null, jobs = null, exec = null) {
474
+ switch (toolName) {
475
+ case 'git_scan': {
476
+ const root = args.root || getDefaultScanRoot(env, { defaultScanRoot: String(cfg.defaultScanRoot || '') });
477
+ const pathList = String(args.paths || '').split(',').map((str) => str.trim()).filter(Boolean);
478
+ const extraReposFile = args.extraReposFile || env.extraReposFile || '';
479
+ // 走**并发只读**扫描:27 仓实测 2718ms(每仓 6 次 git 子进程串行)⇒ 并发后大幅下降;
480
+ // 字段与顺序与 scanRepos 完全一致(同一 walk + 同一解析函数,见 lib/git/repos.js)。
481
+ const repos = await scanReposAsync(root, {
482
+ extraRepos: [...(env.extraRepos || []), ...pathList],
483
+ extraReposFile,
484
+ });
485
+ return { ok: true, root, count: repos.length, paths: pathList, extraReposFile, repos };
486
+ }
487
+ case 'git_commit_push':
488
+ return callCommitPush(args, env, cfg, log, jobs, exec);
489
+ case 'code_audit':
490
+ return callCodeAudit(args, env, cfg, log, jobs, exec);
491
+ case 'git_gen_readme': {
492
+ // README 生成已抽为独立脚本 scripts/readme-gen.mjs,插件不再内置此工具。
493
+ return { ok: false, error: 'git_gen_readme 已移除:请用 `node scripts/readme-gen.mjs <repo> [--write <path>]`(见插件 skill 文档组织节)' };
494
+ }
495
+ case 'git_clone': {
496
+ if (!args.target) return { ok: false, error: 'target 必填' };
497
+ // 2026-10-02 功能:clone 注册宿主后台 job(同 git_commit_push)——大仓库下载
498
+ // 不阻塞工具调用,立即返回 jobId;宿主 job 完成自动回传。宿主无 job 控制器时同步执行保底。
499
+ // env/cfg 必须传下去:clone 要按仓库解析 token(否则走匿名 API,私有库失败、公开库吃限流)
500
+ // 与统一体积上限(与 HTTP 路径同口径)。
501
+ return callCloneJob({ target: args.target, dest: args.dest, branch: args.branch }, jobs, exec, log, env, cfg);
502
+ }
503
+ case 'npm_publish':
504
+ return callNpmPublishJob(args, jobs, exec, log, env, cfg);
505
+ case 'git_remote_create':
506
+ if (!args.repo) return { ok: false, error: MSG_REPO_REQUIRED };
507
+ return ensureRemoteRepo({ repoPath: args.repo, visibility: args.visibility || 'private', dryRun: args.dryRun === true });
508
+ case 'git_identity_rewrite':
509
+ // 提交身份历史改写:默认 dryRun 只报告,真改写要先 dryRun:false/write,推送要 push:true
510
+ return callIdentityRewrite(args, env, cfg);
511
+ case 'git_set_visibility':
512
+ if (!args.repo || !args.visibility) return { ok: false, error: 'repo 与 visibility 必填' };
513
+ return setVisibility({ repoPath: args.repo, visibility: args.visibility });
514
+ case 'io_scan': {
515
+ // 复用 scripts/scan-file-io.mjs(AST 四级分级,与审计 robustness/io-risk 同标准)
516
+ // 不在此另写扫描逻辑,避免两套判定漂移。
517
+ const root = args.repo || env.workspaceRoot;
518
+ if (!root) return { ok: false, error: 'repo 必填(或用会话工作区)' };
519
+ const hits = scanFileIo({
520
+ targets: [root],
521
+ writeOnly: args.writeOnly === true,
522
+ });
523
+ const byRisk = { high: 0, medium: 0, low: 0, safe: 0 };
524
+ for (const hit of hits) if (byRisk[hit.risk] != null) byRisk[hit.risk] += 1;
525
+ const sync = hits.filter((hit) => hit.type === 'sync').length;
526
+ return { ok: true, root, total: hits.length, sync, byRisk, items: hits };
527
+ }
528
+ case 'git_clone_preview': {
529
+ if (!args.target) return { ok: false, error: 'target 必填' };
530
+ return previewClone({
531
+ target: args.target,
532
+ branch: args.branch,
533
+ token: resolveToken({ workspaceRoot: env.workspaceRoot }).token,
534
+ maxFileMB: resolveMaxCloneFileMB(cfg),
535
+ });
536
+ }
537
+ case 'link_check': {
538
+ const path = args.path || env.workspaceRoot;
539
+ const links = await checkLinks({ file: path, text: readTextSafe(path) });
540
+ return { ok: true, count: links.length, penalty: sumLinkPenalty(links), findings: links };
541
+ }
542
+ case 'edit_after_read': {
543
+ // 读改合一:自己读当前文件 → 校验(唯一性 / 读后是否被改动)→ 字面替换 → 写回。
544
+ // 动态 import 避免在文件顶部再添一行导入(本 case 已在 async 函数内,await 可用)。
545
+ // 参数名与宿主编辑工具对齐(file_path/old_string/new_string/replace_all),两套名字都认;
546
+ // 注意**不要**把缺失的 new 兜成空串 —— 那会让「参数名写错」变成「内容被删除」(真实事故)。
547
+ const { editAfterRead } = await import('../fs/edit-after-read.js');
548
+ const r = editAfterRead({
549
+ path: args.path ?? args.file_path,
550
+ old: args.old ?? args.old_string,
551
+ new: args.new ?? args.new_string,
552
+ all: (args.all ?? args.replace_all) === true,
553
+ });
554
+ return r.ok
555
+ ? { ok: true, path: r.path, replaced: r.replaced, bytesBefore: r.bytesBefore, bytesAfter: r.bytesAfter }
556
+ : { ok: false, path: r.path, reason: r.reason };
557
+ }
558
+ case 'module_splitter': {
559
+ // 巨型单文件拆分(复用 scripts/module-splitter.py,python3 零依赖)。
560
+ // python3 调用逻辑抽到 lib/git/module-splitter.js(与 cli cmdModuleSplitter 共用),
561
+ // 此处只做参数映射与结果返回。
562
+ const command = String(args.command || '').trim();
563
+ const target = String((command === 'analyze' ? args.file : args.plan) || '').trim();
564
+ if (!target) {
565
+ return { ok: false, error: command === 'analyze' ? 'analyze 需要 file(待拆 .js 路径)' : `${command} 需要 plan(plan.json 文件路径)` };
566
+ }
567
+ if (!existsSync(target)) return { ok: false, error: `目标不存在:${target}` };
568
+ const r = runModuleSplitter({ sub: command, target, dryRun: args.dryRun === true });
569
+ if (!r.ok) return { ok: false, error: r.error };
570
+ return { ok: true, command: r.sub, target: r.target, dryRun: r.dryRun, output: r.output };
571
+ }
572
+ case 'git_account_check': {
573
+ if (args.sshPub) persistSshPub(String(args.sshPub), { workspaceRoot: env.workspaceRoot });
574
+ const accountInfo = await checkGithubAccount({ workspaceRoot: env.workspaceRoot, token: String(args.token || '') });
575
+ return { ok: true, ...accountInfo, block: formatGithubAccountBlock(accountInfo) };
576
+ }
577
+ case 'git_cred_env': {
578
+ // 凭据传递——输出环境变量前缀(SSH 私钥路径 / HTTPS askpass 脚本),
579
+ // AI 执行任意外部 git 命令时粘贴使用,全程不输出 token/私钥明文。
580
+ const { buildCredEnv } = await import('../git/cred-env.js');
581
+ const r = buildCredEnv({ workspaceRoot: env.workspaceRoot });
582
+ return { ok: true, ...r };
583
+ }
584
+ case 'git_gen_ssh_key': {
585
+ const r = generateSshKey(String(args.email || ''), { workspaceRoot: env.workspaceRoot, force: args.force === true });
586
+ if (!r.ok) return { ok: false, error: r.error };
587
+ return { ok: true, email: r.email, privateKey: r.privateKey, pubFile: r.pubFile, pub: r.pub, note: '公钥已写入插件配置目录 *.pub,可复制粘贴到 GitHub → Settings → SSH and GPG keys' };
588
+ }
589
+ case 'git_sluice': {
590
+ // 浅包装 git 透传——AI 直接调用任意 git 命令(凭据自动注入)。
591
+ // args 参数串按 shell 规则拆分(引号包裹的路径含空格不受影响),
592
+ // 与 CLI git-sluice git <参数> 同实现(lib/git/wrapped-git.js runWrappedGitCapture)。
593
+ const { runWrappedGitCapture } = await import('../git/wrapped-git.js');
594
+ const argv = shellSplit(String(args.args || ''));
595
+ if (argv.length === 0) return { ok: false, error: 'args 必填:git 参数串(如 "status --short")' };
596
+ const r = runWrappedGitCapture(argv, { workspaceRoot: env.workspaceRoot });
597
+ return { ok: r.ok, status: r.status, stdout: r.stdout, stderr: r.stderr, command: ['git', ...argv].join(' ') };
598
+ }
599
+ case 'git_api': {
600
+ // 直接调用本插件 HTTP API(28 条)——与浏览器/CLI 走**同一条代码路径**(handleHttp),
601
+ // 不另写一份实现:避免"工具版与 HTTP 版行为分叉"(同一事实两份实现 = 必然分叉)。
602
+ // 不传 path 时列出全部接口(从分发器 case 现读,即路由真相)。
603
+ const { handleHttp } = await import('./http-handlers.js');
604
+ const fs = await import('node:fs');
605
+ const src = fs.readFileSync(new URL('./http-handlers.js', import.meta.url), 'utf8');
606
+ const endpoints = [...new Set(src.match(/case '\/api\/git-push\/[A-Za-z0-9/_-]+'/g) || [])]
607
+ .map((s) => s.replace("case '/api/git-push/", '').replace(/'$/, ''))
608
+ .sort();
609
+ const ep = String(args.path || '').trim().replace(/^\/+/, '').replace(/^api\/git-push\//, '');
610
+ if (!ep) return { ok: true, count: endpoints.length, endpoints, note: '传 path 调用具体接口(如 path=status)' };
611
+ const method = String(args.method || 'GET').toUpperCase();
612
+ let query = {};
613
+ let body;
614
+ try {
615
+ if (args.query) query = JSON.parse(String(args.query));
616
+ if (args.body) body = JSON.parse(String(args.body));
617
+ } catch (e) {
618
+ return { ok: false, error: `query/body 不是合法 JSON: ${e?.message || e}` };
619
+ }
620
+ const qs = new URLSearchParams(query).toString();
621
+ const bodyText = body === undefined ? '' : JSON.stringify(body);
622
+ const out = await handleHttp({
623
+ method,
624
+ url: `/api/git-push/${ep}${qs ? '?' + qs : ''}`,
625
+ origin: 'http://localhost', // 内部调用 = 本机同源(写类接口的 CSRF 门禁据此放行)
626
+ headers: { host: 'localhost', 'content-length': String(bodyText.length) },
627
+ body: bodyText,
628
+ }, env, cfg);
629
+ return { ok: out?.status === 200 && out?.body?.ok !== false, status: out?.status, endpoint: ep, result: out?.body };
630
+ }
631
+ default:
632
+ return { ok: false, error: `未知工具: ${toolName}` };
633
+ }
634
+ }
635
+
636
+ /** 按 shell 规则拆分参数串(支持单双引号包裹含空格的路径)。 */
637
+ function shellSplit(input) {
638
+ const out = [];
639
+ let cur = '';
640
+ let quote = ''; // '' | '"' | "'"
641
+ for (const ch of input) {
642
+ if (quote) {
643
+ if (ch === quote) quote = '';
644
+ else cur += ch;
645
+ } else if (ch === '"' || ch === "'") {
646
+ quote = ch;
647
+ } else if (ch === ' ' || ch === '\t') {
648
+ if (cur) { out.push(cur); cur = ''; }
649
+ } else {
650
+ cur += ch;
651
+ }
652
+ }
653
+ if (cur) out.push(cur);
654
+ return out;
655
+ }
656
+
657
+ /** 读文件(失败返回空串,link_check 用)。 */
658
+ function readTextSafe(path = '') {
659
+ try {
660
+ return readFileSync(path, 'utf8');
661
+ } catch { return ''; }
662
+ }