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.
- package/.auditignore +30 -0
- package/.gitignore +39 -0
- package/LICENSE +21 -0
- package/README.md +1486 -2
- package/cli.mjs +360 -0
- package/cordis.patch.yml +14 -0
- package/lib/ARCHITECTURE.md +34 -0
- package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
- package/lib/app/apply.js +275 -0
- package/lib/app/audit-api.js +158 -0
- package/lib/app/command-registry.js +266 -0
- package/lib/app/constants.js +16 -0
- package/lib/app/handlers/account.js +166 -0
- package/lib/app/handlers/clone.js +168 -0
- package/lib/app/handlers/http-constants.js +9 -0
- package/lib/app/handlers/identity-rewrite.js +94 -0
- package/lib/app/handlers/meta.js +175 -0
- package/lib/app/handlers/npm.js +169 -0
- package/lib/app/handlers/repo-actions.js +143 -0
- package/lib/app/handlers/repos.js +231 -0
- package/lib/app/handlers/settings.js +62 -0
- package/lib/app/host-doc-checks.js +25 -0
- package/lib/app/http-handlers.js +131 -0
- package/lib/app/index.js +30 -0
- package/lib/app/inject-text.js +192 -0
- package/lib/app/scan-root.js +23 -0
- package/lib/app/schema.js +150 -0
- package/lib/app/settings-bridge.js +167 -0
- package/lib/app/slash-commands.js +395 -0
- package/lib/app/slot-stats.js +35 -0
- package/lib/app/tool-call.js +672 -0
- package/lib/app/tools.js +34 -0
- package/lib/ast/brace.js +105 -0
- package/lib/ast/callgraph.js +135 -0
- package/lib/ast/code-lines.js +114 -0
- package/lib/ast/consts.js +12 -0
- package/lib/ast/control-flow.js +461 -0
- package/lib/ast/credential.js +199 -0
- package/lib/ast/dataflow.js +274 -0
- package/lib/ast/dup-code.js +165 -0
- package/lib/ast/index.js +36 -0
- package/lib/ast/io-risk-const.js +95 -0
- package/lib/ast/io-risk-fn.js +208 -0
- package/lib/ast/io-risk-loop.js +308 -0
- package/lib/ast/io-risk.js +314 -0
- package/lib/ast/lang.js +156 -0
- package/lib/ast/line-count.js +52 -0
- package/lib/ast/magic-number.js +272 -0
- package/lib/ast/naming.js +284 -0
- package/lib/ast/perf.js +472 -0
- package/lib/ast/scope.js +241 -0
- package/lib/ast/shell.js +131 -0
- package/lib/ast/size.js +378 -0
- package/lib/ast/symbol-index.js +399 -0
- package/lib/ast/tokenizer.js +341 -0
- package/lib/audit/analysis-coverage.js +98 -0
- package/lib/audit/audit-file.js +182 -0
- package/lib/audit/checks.js +17 -0
- package/lib/audit/client-entry.js +93 -0
- package/lib/audit/collector.js +477 -0
- package/lib/audit/ext-runner.js +80 -0
- package/lib/audit/file-context.js +138 -0
- package/lib/audit/finding.js +50 -0
- package/lib/audit/gitignore-match.js +113 -0
- package/lib/audit/glob.js +63 -0
- package/lib/audit/history-report.js +100 -0
- package/lib/audit/history.js +126 -0
- package/lib/audit/ignore-blind.js +101 -0
- package/lib/audit/index.js +33 -0
- package/lib/audit/orchestrate.js +476 -0
- package/lib/audit/public.js +24 -0
- package/lib/audit/repo-level.js +30 -0
- package/lib/audit/report-yaml.js +86 -0
- package/lib/audit/slot.js +65 -0
- package/lib/audit-defaults.js +18 -0
- package/lib/audit-rules/audit-rules-comment.yml +247 -0
- package/lib/audit-rules/audit-rules-cpp.yml +22 -0
- package/lib/audit-rules/audit-rules-docs.yml +32 -0
- package/lib/audit-rules/audit-rules-dsh.yml +162 -0
- package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
- package/lib/audit-rules/audit-rules-folder.yml +99 -0
- package/lib/audit-rules/audit-rules-frontend.yml +335 -0
- package/lib/audit-rules/audit-rules-go.yml +22 -0
- package/lib/audit-rules/audit-rules-i18n.yml +45 -0
- package/lib/audit-rules/audit-rules-java.yml +105 -0
- package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
- package/lib/audit-rules/audit-rules-npm.yml +187 -0
- package/lib/audit-rules/audit-rules-paths.yml +92 -0
- package/lib/audit-rules/audit-rules-performance.yml +215 -0
- package/lib/audit-rules/audit-rules-php.yml +22 -0
- package/lib/audit-rules/audit-rules-private.yml +24 -0
- package/lib/audit-rules/audit-rules-python.yml +106 -0
- package/lib/audit-rules/audit-rules-robustness.yml +27 -0
- package/lib/audit-rules/audit-rules-rust.yml +22 -0
- package/lib/audit-rules/audit-rules-structure.yml +159 -0
- package/lib/audit-rules/audit-rules-swift.yml +22 -0
- package/lib/audit-rules/audit-rules-template.yml +108 -0
- package/lib/checks/button-bind.js +276 -0
- package/lib/checks/common.js +170 -0
- package/lib/checks/credential-file.js +43 -0
- package/lib/checks/dataflow.js +40 -0
- package/lib/checks/dispatch.js +112 -0
- package/lib/checks/dup-code.js +69 -0
- package/lib/checks/dup-const.js +232 -0
- package/lib/checks/file-health.js +150 -0
- package/lib/checks/filter.js +137 -0
- package/lib/checks/folder.js +173 -0
- package/lib/checks/hardcoded-path.js +98 -0
- package/lib/checks/index.js +46 -0
- package/lib/checks/io.js +66 -0
- package/lib/checks/magic-number.js +42 -0
- package/lib/checks/npm-json.js +273 -0
- package/lib/checks/private.js +63 -0
- package/lib/checks/regex.js +256 -0
- package/lib/checks/semantic.js +134 -0
- package/lib/checks/structural.js +274 -0
- package/lib/cli/commands-account.mjs +107 -0
- package/lib/cli/commands-audit.mjs +144 -0
- package/lib/cli/commands-doc.mjs +127 -0
- package/lib/cli/commands-vcs.mjs +175 -0
- package/lib/client/index.js +162 -0
- package/lib/client-parts/00-loader.js +33 -0
- package/lib/client-parts/01-const.js +207 -0
- package/lib/client-parts/02-utils.js +62 -0
- package/lib/client-parts/03-icons.js +12 -0
- package/lib/client-parts/10-account.js +83 -0
- package/lib/client-parts/11-browser.js +95 -0
- package/lib/client-parts/20-repo.js +374 -0
- package/lib/client-parts/21-audit.js +301 -0
- package/lib/client-parts/22-settings.js +146 -0
- package/lib/client-parts/23-npm.js +383 -0
- package/lib/client-parts/30-page.js +56 -0
- package/lib/client-parts/40-controller.js +1092 -0
- package/lib/client-parts/41-actions.js +279 -0
- package/lib/client-parts/99-apply.js +72 -0
- package/lib/client.js +3195 -0
- package/lib/commit-push.js +148 -0
- package/lib/context/index.js +363 -0
- package/lib/core/atomic-json.js +98 -0
- package/lib/core/config.js +40 -0
- package/lib/core/credentials.js +274 -0
- package/lib/core/endpoints.js +109 -0
- package/lib/core/exec.js +162 -0
- package/lib/exempt/index.js +292 -0
- package/lib/fs/edit-after-read.js +103 -0
- package/lib/fsx.js +87 -0
- package/lib/git/account-status.js +140 -0
- package/lib/git/account.js +233 -0
- package/lib/git/api.js +136 -0
- package/lib/git/atomic-json.js +6 -0
- package/lib/git/browse.js +38 -0
- package/lib/git/clone-download.js +397 -0
- package/lib/git/clone-history-mode.js +143 -0
- package/lib/git/clone-history.js +175 -0
- package/lib/git/clone-jobs.js +250 -0
- package/lib/git/clone-replay-io.js +172 -0
- package/lib/git/clone-replay.js +275 -0
- package/lib/git/clone.js +445 -0
- package/lib/git/cloud.js +46 -0
- package/lib/git/commit-message.js +141 -0
- package/lib/git/config.js +6 -0
- package/lib/git/cred-env.js +88 -0
- package/lib/git/credentials.js +6 -0
- package/lib/git/endpoints.js +6 -0
- package/lib/git/exec.js +6 -0
- package/lib/git/identity-rewrite.js +297 -0
- package/lib/git/identity.js +150 -0
- package/lib/git/ignore.js +69 -0
- package/lib/git/index.js +41 -0
- package/lib/git/module-splitter.js +47 -0
- package/lib/git/post-push.js +101 -0
- package/lib/git/push-diagnose.js +142 -0
- package/lib/git/push.js +476 -0
- package/lib/git/remote-resolve.js +146 -0
- package/lib/git/remote.js +128 -0
- package/lib/git/repo-index.js +512 -0
- package/lib/git/repos.js +235 -0
- package/lib/git/scan-runner.js +159 -0
- package/lib/git/sensitive.js +134 -0
- package/lib/git/transport.js +430 -0
- package/lib/git/visibility.js +35 -0
- package/lib/git/wrapped-git.js +68 -0
- package/lib/http/index.js +170 -0
- package/lib/index.js +24 -0
- package/lib/link-check/index.js +187 -0
- package/lib/npm/account.js +64 -0
- package/lib/npm/install.js +211 -0
- package/lib/npm/npmrc.js +56 -0
- package/lib/npm/publish.js +171 -0
- package/lib/npm/registry.js +168 -0
- package/lib/plugin/auto-detect.js +92 -0
- package/lib/plugin/auto-push.js +154 -0
- package/lib/plugin/index.js +250 -0
- package/lib/readme-templates/readme.yml +38 -0
- package/lib/rule/compilers/credential.js +62 -0
- package/lib/rule/compilers/dataflow.js +38 -0
- package/lib/rule/compilers/file-health.js +75 -0
- package/lib/rule/compilers/frontend.js +86 -0
- package/lib/rule/compilers/func.js +35 -0
- package/lib/rule/compilers/helpers.js +71 -0
- package/lib/rule/compilers/index.js +29 -0
- package/lib/rule/compilers/link-semantic.js +45 -0
- package/lib/rule/compilers/list-kinds.js +12 -0
- package/lib/rule/compilers/numeric-kinds.js +66 -0
- package/lib/rule/compilers/regex.js +78 -0
- package/lib/rule/compilers/structure.js +80 -0
- package/lib/rule/compilers.js +17 -0
- package/lib/rule/homoglyph.js +45 -0
- package/lib/rule/loader.js +270 -0
- package/lib/rule/registry.js +115 -0
- package/lib/rule/scope.js +67 -0
- package/lib/score/docs-score.js +166 -0
- package/lib/score/index.js +140 -0
- package/lib/self/index.js +196 -0
- package/lib/skip-dirs.js +64 -0
- package/lib/tool-probes.json +50 -0
- package/lib/user-requirements.json +14 -0
- package/lib/vendor/js-yaml/LICENSE +21 -0
- package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
- package/package.json +95 -4
- package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
- package/scripts/audit-ext/_example-readme-present.mjs +34 -0
- package/scripts/audit-ext/variable-min-length.mjs +102 -0
- package/scripts/audit-runner.mjs +35 -0
- package/scripts/audit-runtime-check.mjs +129 -0
- package/scripts/browser-page-probe.mjs +271 -0
- package/scripts/build-client.mjs +119 -0
- package/scripts/check.mjs +88 -0
- package/scripts/clean-date-comments.py +102 -0
- package/scripts/cpu-sample.mjs +188 -0
- package/scripts/doc-drift.mjs +200 -0
- package/scripts/doc-func.mjs +212 -0
- package/scripts/doc-tree.mjs +456 -0
- package/scripts/doc-version.mjs +220 -0
- package/scripts/frontend-preview-check.mjs +124 -0
- package/scripts/hot-path-probe-cjs.cjs +71 -0
- package/scripts/hot-path-probe-fs-shim.mjs +28 -0
- package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
- package/scripts/hot-path-probe.mjs +153 -0
- package/scripts/module-splitter.py +800 -0
- package/scripts/platform-scan.mjs +168 -0
- package/scripts/preview-gen.mjs +489 -0
- package/scripts/preview-local-runner.mjs +55 -0
- package/scripts/preview-server-direct.mjs +116 -0
- package/scripts/preview-server.mjs +305 -0
- package/scripts/preview-slot-data.mjs +123 -0
- package/scripts/probe-recheck.mjs +47 -0
- package/scripts/readme-gen.mjs +268 -0
- package/scripts/rename-locator.mjs +97 -0
- package/scripts/rule-switch.mjs +97 -0
- package/scripts/rules-solo-audit.mjs +173 -0
- package/scripts/scan-file-io.mjs +713 -0
- package/scripts/scan-hardcoded-paths.mjs +125 -0
- package/scripts/scan-repos.mjs +167 -0
- package/scripts/scan-version.mjs +122 -0
- package/scripts/scrub-user-wording.mjs +420 -0
- package/scripts/symbol-index.mjs +85 -0
- package/scripts/sync-plugin-install.mjs +223 -0
- package/scripts/sync-plugin.mjs +279 -0
- package/scripts/verify-prestep.mjs +100 -0
- package/skills/dev/audit-rule-authoring.md +58 -0
- package/skills/dev/dsh-git-push.md +323 -0
- package/skills/dev/git-push-live-fix.md +45 -0
- package/skills/dsh-repo-index.md +35 -0
- package/skills/guide/guide-audit.md +167 -0
- package/skills/guide/guide-cli-scripts.md +104 -0
- package/skills/guide/guide-clone-repos.md +173 -0
- package/skills/guide/guide-commit-push.md +156 -0
- package/skills/guide/guide-inject-ui.md +166 -0
- package/skills/guide/guide-slash-completion.md +118 -0
- package/skills/workflow/README.md +21 -0
- package/skills/workflow/git-commit-discipline.md +68 -0
- package/skills/workflow/git-project-startup.md +85 -0
- package/skills/workflow/git-rebuild-process.md +57 -0
- package/skills/workflow/github-operations.md +91 -0
- package/skills/workflow/readme-sync-git-md.md +28 -0
- package/skills/workflow/task-completion-report.md +73 -0
- package/skills/workflow/tool-json-add-ask.md +35 -0
- package/skills/workflow/versioning-rule.md +211 -0
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 审计结果 API 聚合层
|
|
3
|
+
*
|
|
4
|
+
* 为 `/api/git-push/audit` 端点提供「请求时自定义聚合」:
|
|
5
|
+
* · 维度:rule(警告类型)/ file(文件名)/ severity / slot(规则包)
|
|
6
|
+
* · 过滤:severity 白名单(逗号分隔)
|
|
7
|
+
* · 条数:top 截断(每组最多列前 N 条,0=全部)
|
|
8
|
+
* · 明细:withFindings=true 时附完整 findings
|
|
9
|
+
*
|
|
10
|
+
* 纯函数设计:findings 进、聚合出,不碰 I/O,便于单测。
|
|
11
|
+
* 与 auditFull/auditWithScope 解耦——本层只消费它们的返回。
|
|
12
|
+
*/
|
|
13
|
+
import { buildRuleSlotMap } from '../audit/slot.js';
|
|
14
|
+
import { MAX_MSG_PREVIEW } from './constants.js';
|
|
15
|
+
|
|
16
|
+
/** 支持的聚合维度(非法值回落 rule)。 */
|
|
17
|
+
export const GROUP_BY_KEYS = ['rule', 'file', 'severity', 'slot'];
|
|
18
|
+
// 豁免类型前缀(exemptHint 形态 dsh-skip-<type>(范围)——统计按类型分组)
|
|
19
|
+
const EXEMPT_TYPE_RE = /dsh-skip-([a-z-]+)/; // 无 /g:exec 有 lastIndex 状态(多次调用错位)
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* 豁免类型统计(每次审计后输出「本次被豁免的类型与数量」——
|
|
23
|
+
* 审计透明性:dsh-skip-quality/residue/sensitive/size 各豁免多少条)。
|
|
24
|
+
* @param {Array} findings audit findings(含 exemptHint)
|
|
25
|
+
* @returns {{ types: Record<string, number>, total: number }}
|
|
26
|
+
*/
|
|
27
|
+
export function exemptStatsOf(findings = []) {
|
|
28
|
+
const types = {};
|
|
29
|
+
let total = 0;
|
|
30
|
+
for (const f of findings) {
|
|
31
|
+
const hint = String(f?.exemptHint || '');
|
|
32
|
+
if (!hint) continue;
|
|
33
|
+
total += 1;
|
|
34
|
+
const matched = EXEMPT_TYPE_RE.exec(hint);
|
|
35
|
+
if (matched) {
|
|
36
|
+
const t = matched[1];
|
|
37
|
+
types[t] = (types[t] || 0) + 1;
|
|
38
|
+
} else {
|
|
39
|
+
types.other = (types.other || 0) + 1;
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
return { types, total };
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** finding 对象聚合键提取(slot 维度用 ruleSlotMap 把 rule id 归到规则包)。 */
|
|
46
|
+
function groupKeyOf(finding, groupBy, ruleSlotMap) {
|
|
47
|
+
if (groupBy === 'file') return String(finding.file || '(未知文件)');
|
|
48
|
+
if (groupBy === 'severity') return String(finding.severity || 'notice');
|
|
49
|
+
if (groupBy === 'slot') return ruleSlotMap.get(finding.rule) || '未归类';
|
|
50
|
+
return String(finding.rule || '(未知规则)');
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* 解析 severity 过滤参数:「warning,blocker」→ ['warning','blocker'];
|
|
55
|
+
* 空/非法 → null(不过滤)。
|
|
56
|
+
*/
|
|
57
|
+
export function parseSeverityFilter(raw) {
|
|
58
|
+
if (!raw) return null;
|
|
59
|
+
const list = String(raw).split(',').map((s) => s.trim().toLowerCase()).filter(Boolean);
|
|
60
|
+
return list.length ? [...new Set(list)] : null;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* 按指定维度聚合 findings。
|
|
65
|
+
* @param {Array} findings audit findings(含 rule/severity/file)
|
|
66
|
+
* @param {object} opts { groupBy='rule', severityFilter=null, top=0, ruleSlotMap=Map }
|
|
67
|
+
* @returns {{groups: Array<{key, count, sample?: object}>, total: number, filtered: number}}
|
|
68
|
+
* groups 按 count 降序;severity 过滤后 filtered=通过过滤的条数。
|
|
69
|
+
*/
|
|
70
|
+
export function aggregateFindings(findings = [], opts = {}) {
|
|
71
|
+
const groupBy = GROUP_BY_KEYS.includes(opts.groupBy) ? opts.groupBy : 'rule';
|
|
72
|
+
const top = Number(opts.top) > 0 ? Math.floor(Number(opts.top)) : 0;
|
|
73
|
+
const severityFilter = parseSeverityFilter(opts.severityFilter);
|
|
74
|
+
const ruleSlotMap = opts.ruleSlotMap instanceof Map ? opts.ruleSlotMap : new Map();
|
|
75
|
+
|
|
76
|
+
const buckets = new Map();
|
|
77
|
+
let filtered = 0;
|
|
78
|
+
for (const f of findings) {
|
|
79
|
+
if (severityFilter && !severityFilter.includes(String(f.severity || 'notice').toLowerCase())) continue;
|
|
80
|
+
filtered++;
|
|
81
|
+
const key = groupKeyOf(f, groupBy, ruleSlotMap);
|
|
82
|
+
if (!buckets.has(key)) buckets.set(key, { key, count: 0, sample: null });
|
|
83
|
+
const b = buckets.get(key);
|
|
84
|
+
b.count++;
|
|
85
|
+
if (!b.sample) b.sample = { rule: f.rule, severity: f.severity, file: f.file, line: f.line, message: f.message };
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
let groups = [...buckets.values()].sort((a, b2) => b2.count - a.count || String(a.key).localeCompare(String(b2.key)));
|
|
89
|
+
if (top > 0) groups = groups.slice(0, top);
|
|
90
|
+
return { groups, total: findings.length, filtered };
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* 执行审计并聚合(HTTP 端点用)。
|
|
95
|
+
* @param {string} repo 仓库根
|
|
96
|
+
* @param {object} params { scope='full', groupBy='rule', severity='', top=0, withFindings=false, rulesetDir='', maxScanFiles=0, slots, disabledSlots, includeIgnored=false, weights={} }
|
|
97
|
+
* @param {object} cfg 插件配置(auditRuleOrder / auditDisabledSlots)
|
|
98
|
+
*/
|
|
99
|
+
export async function runAuditApi(repo, params = {}, cfg = {}) {
|
|
100
|
+
const { auditFull, auditWithScope } = await import('../audit/index.js');
|
|
101
|
+
const { scoreQuality } = await import('../score/index.js');
|
|
102
|
+
const scope = params.scope === 'diff' ? 'diff' : 'full';
|
|
103
|
+
const auditOpts = {
|
|
104
|
+
scope,
|
|
105
|
+
rulesetDir: params.rulesetDir || '',
|
|
106
|
+
maxScanFiles: params.maxScanFiles ?? cfg.maxScanFiles ?? 0,
|
|
107
|
+
slots: undefined, // auditRuleOrder 是「加载顺序」不是白名单 ✗(详见 lib/commit-push.js 注释;禁用槽位用 auditDisabledSlots ✓)
|
|
108
|
+
disabledSlots: Array.isArray(cfg.auditDisabledSlots) ? cfg.auditDisabledSlots : [],
|
|
109
|
+
includeIgnored: params.includeIgnored === true,
|
|
110
|
+
};
|
|
111
|
+
const auditResult = scope === 'diff'
|
|
112
|
+
? await auditWithScope(repo, auditOpts)
|
|
113
|
+
: await auditFull(repo, auditOpts);
|
|
114
|
+
|
|
115
|
+
const { summarize } = await import('../audit/index.js');
|
|
116
|
+
const summary = summarize(auditResult.findings);
|
|
117
|
+
const quality = scoreQuality(auditResult.findings, params.weights || {}, { files: auditResult.files });
|
|
118
|
+
// slot 归属映射(groupBy=slot 用):与 auditFiles 同源加载规则构建映射——
|
|
119
|
+
// 审计返回不带 compiled,这里按相同 slots/disabledSlots 重新编译一次。
|
|
120
|
+
let ruleSlotMap = new Map();
|
|
121
|
+
if (params.groupBy === 'slot') {
|
|
122
|
+
try {
|
|
123
|
+
const { loadRuleFiles } = await import('../rule/loader.js');
|
|
124
|
+
const { compileAllRules } = await import('../rule/registry.js');
|
|
125
|
+
const loaded = loadRuleFiles(auditOpts.slots, { dir: auditOpts.rulesetDir, disabledSlots: auditOpts.disabledSlots });
|
|
126
|
+
ruleSlotMap = buildRuleSlotMap(compileAllRules(loaded.merged.rules, { errors: [] }));
|
|
127
|
+
} catch { /* slot 映射构建失败退化为空 Map(该维度归「未归类」) */ }
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
const agg = aggregateFindings(auditResult.findings, {
|
|
131
|
+
groupBy: params.groupBy,
|
|
132
|
+
severityFilter: params.severity,
|
|
133
|
+
top: params.top,
|
|
134
|
+
ruleSlotMap,
|
|
135
|
+
});
|
|
136
|
+
|
|
137
|
+
const out = {
|
|
138
|
+
ok: true,
|
|
139
|
+
repo,
|
|
140
|
+
scope: auditResult.scope || scope,
|
|
141
|
+
files: auditResult.files,
|
|
142
|
+
summary,
|
|
143
|
+
quality: quality.emptyResult ? null : { score: quality.score, level: quality.level },
|
|
144
|
+
groups: agg.groups,
|
|
145
|
+
total: agg.total,
|
|
146
|
+
filtered: agg.filtered,
|
|
147
|
+
// 豁免类型统计(本次被豁免的类型与数量)+ 可用聚合类型(groupBy 维度)+
|
|
148
|
+
// 拦截列表(blocker findings 直接输出——被拦文件/规则,不用再查明细)
|
|
149
|
+
exemptStats: exemptStatsOf(auditResult.findings),
|
|
150
|
+
groupByTypes: GROUP_BY_KEYS,
|
|
151
|
+
blocked: auditResult.findings
|
|
152
|
+
.filter((f) => f.severity === 'blocker')
|
|
153
|
+
.map((f) => ({ file: f.file, line: f.line, rule: f.rule, message: String(f.message || '').slice(0, MAX_MSG_PREVIEW) })),
|
|
154
|
+
};
|
|
155
|
+
if (params.withFindings === true) out.findings = auditResult.findings;
|
|
156
|
+
if (params.withYaml === true) out.yaml = auditResult.yaml;
|
|
157
|
+
return out;
|
|
158
|
+
}
|
|
@@ -0,0 +1,266 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具命令注册表(方案 B——命令注册表元数据驱动,免维护 CLI)
|
|
3
|
+
*
|
|
4
|
+
* 单一规则源:CLI 命令、宿主工具 schema、帮助文档三处同源生成——
|
|
5
|
+
* 新增/改工具只改本注册表一处,CLI 自动对齐(CLI 独立于 DSH 运行:本地 lib 直调 callTool)。
|
|
6
|
+
*
|
|
7
|
+
* 条目字段:
|
|
8
|
+
* name 插件工具名(宿主注册用)
|
|
9
|
+
* cli CLI 命令名(缺省 = name 去下划线)
|
|
10
|
+
* description 工具说明(帮助/注入文本)
|
|
11
|
+
* params 参数 schema:{ flag, type: string|boolean, positional?: 位置索引,
|
|
12
|
+
* required?, default?, enum?, desc }
|
|
13
|
+
* 无 cli 的命令 = 仅工具(宿主用),CLI 不生成命令。
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
export const TOOL_REGISTRY = [
|
|
17
|
+
{
|
|
18
|
+
name: 'git_scan', cli: 'scan', description: '扫描 git 仓库(分支/remote/未提交/未推送/最近活动)。root=扫描根目录、paths=额外仓库(逗号分隔)、extraReposFile=仓库清单文件——查「哪些仓库有改动/未推送」用它',
|
|
19
|
+
params: [
|
|
20
|
+
{ flag: 'root', type: 'string', positional: 0, desc: '扫描根目录(默认取配置 defaultScanRoot)' },
|
|
21
|
+
{ flag: 'paths', type: 'string', desc: '额外仓库绝对路径(逗号分隔)' },
|
|
22
|
+
{ flag: 'extraReposFile', type: 'string', desc: 'extraRepos 配置文件路径(每行一个仓库)' },
|
|
23
|
+
],
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
name: 'git_commit_push', cli: 'commit', description: '一键提交并推送:一次调用 = 审计(blocker 拦截,可关)→ 有改动才 commit → 有可推内容才 push。零改动是**正常成功路径**:返回 ok:true + committed:false(job 状态 completed,不是失败);远端已最新则 ok:true + pushed:false;本地领先远端的已提交内容照样会推。message 必填(零改动时用不到);requirementsConfirmed=true(开发者要求全部核对达标)——**存在要求清单时任何调用都要带**(与有无改动、是否推送无关);push=false 只提交;dryRun 只模拟',
|
|
27
|
+
params: [
|
|
28
|
+
{ flag: 'repo', type: 'string', positional: 0, required: true, desc: '仓库绝对路径' },
|
|
29
|
+
{ flag: 'message', type: 'string', required: true, desc: 'commit message(字符串,必填):可写整条提交信息;要传结构化多条目请用 messageItems(它会作为要点与正文)' },
|
|
30
|
+
// ⚠️ 数组/对象形态**必须走独立参数**:宿主在进插件之前先按工具 JSON schema 校验参数,
|
|
31
|
+
// 而它对 message 这类标量参数只认 type:'string'(实测 anyOf 与「类型数组」两种写法
|
|
32
|
+
// 都被读成 string ✗,报 invalid arguments: "message" must be a string ⇒ 非字符串根本到不了插件 ✓)
|
|
33
|
+
{ flag: 'messageItems', type: 'array', desc: '结构化条目数组:元素为字符串,或 {what,type?,scope?,why?,verify?,refs?};仅 what 必填,type/scope/why/verify/refs 可空' },
|
|
34
|
+
{ flag: 'push', type: 'boolean', default: true, desc: '是否推送(默认 true)' },
|
|
35
|
+
{ flag: 'audit', type: 'boolean', desc: '提交前审计(默认取配置)' },
|
|
36
|
+
{ flag: 'dryRun', type: 'boolean', desc: 'dry-run 只模拟不写入' },
|
|
37
|
+
{ flag: 'force', type: 'boolean', desc: 'force 强推(谨慎)' },
|
|
38
|
+
{ flag: 'ignorePatterns', type: 'string', desc: '自定义忽略 pattern(追加 .gitignore)' },
|
|
39
|
+
{ flag: 'requirementsConfirmed', type: 'boolean', desc: '已核对开发者要求' },
|
|
40
|
+
{ flag: 'pushConfirmed', type: 'boolean', desc: '推送门禁放行' },
|
|
41
|
+
{ flag: 'paths', type: 'string', desc: '精确 add 路径(逗号分隔)' },
|
|
42
|
+
],
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
// code_audit 不给 CLI 命令(cli 缺省)——CLI audit 用 lib/cli(完整 findings,独立于 DSH);
|
|
46
|
+
// 工具 code_audit 输出 API 指引(宿主场景有聚合 API)。CLI 独立审计不能依赖宿主 API。
|
|
47
|
+
name: 'code_audit', description: '审计仓库:L0 静态检查+10 维度评分(0-100)。默认精简输出(评分/问题数/豁免统计/API 指引);includeFindings=true 返回全量 findings;scope=full|diff;history=历史提交审计',
|
|
48
|
+
params: [
|
|
49
|
+
{ flag: 'repo', type: 'string', positional: 0, required: true, desc: '仓库绝对路径' },
|
|
50
|
+
{ flag: 'scope', type: 'string', enum: ['full', 'diff'], default: 'full', desc: '审计范围' },
|
|
51
|
+
{ flag: 'rulesetDir', type: 'string', desc: '自定规则目录' },
|
|
52
|
+
{ flag: 'llm', type: 'boolean', desc: '追加 LLM 深度审查' },
|
|
53
|
+
{ flag: 'includeIgnored', type: 'boolean', desc: '含 .gitignore 忽略文件' },
|
|
54
|
+
{ flag: 'history', type: 'boolean', desc: '历史提交审计' },
|
|
55
|
+
{ flag: 'since', type: 'string', desc: 'history 起始提交' },
|
|
56
|
+
{ flag: 'until', type: 'string', desc: 'history 结束提交' },
|
|
57
|
+
{ flag: 'outDir', type: 'string', desc: 'history 报告目录' },
|
|
58
|
+
{ flag: 'json', type: 'boolean', desc: 'JSON 输出(完整返回)' },
|
|
59
|
+
{ flag: 'includeFindings', type: 'boolean', desc: 'true 时返回全量审计结果(findings+yaml)' },
|
|
60
|
+
],
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
name: 'git_clone', cli: 'clone', description: '从 GitHub clone 仓库(Git Data API,不直连 github.com)。target=owner/repo 或完整 URL、dest=目标目录(缺省 workspaceRoot,已存在非空拒绝防覆盖)、branch=分支、history=重建真实提交历史(可推回远端;默认关,走整树快照)',
|
|
64
|
+
params: [
|
|
65
|
+
{ flag: 'target', type: 'string', positional: 0, required: true, desc: 'owner/repo 或完整 URL' },
|
|
66
|
+
{ flag: 'dest', type: 'string', desc: '目标目录(缺省 workspaceRoot)' },
|
|
67
|
+
{ flag: 'branch', type: 'string', desc: '分支名' },
|
|
68
|
+
// 真实历史模式(**默认开**):用 git fetch 取回原始对象,克隆结果与远端逐字节一致;
|
|
69
|
+
// 传 history=false 可退回整树快照(与远端无祖先、不能推回)。
|
|
70
|
+
{ flag: 'history', type: 'boolean', default: true, desc: '重建真实提交历史(默认开;传 false 退回整树快照)' },
|
|
71
|
+
{ flag: 'historyDepth', type: 'number', desc: 'history 模式拉链深度上限(不传=全量历史)' },
|
|
72
|
+
],
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
name: 'git_remote_create', cli: 'remote-create', description: '按项目文件夹创建 GitHub 远端仓库(缺省 private;dryRun 只探测预演不创建)',
|
|
76
|
+
params: [
|
|
77
|
+
{ flag: 'repo', type: 'string', positional: 0, required: true, desc: '本地 git 仓库绝对路径' },
|
|
78
|
+
{ flag: 'visibility', type: 'string', enum: ['public', 'private'], default: 'private', desc: '可见性' },
|
|
79
|
+
{ flag: 'dryRun', type: 'boolean', desc: '只探测预演' },
|
|
80
|
+
],
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
name: 'git_set_visibility', cli: 'set-visibility', description: '切换 GitHub 仓库 public/private(改 public 有敏感信息暴露风险——先确认无凭据/隐私)',
|
|
84
|
+
params: [
|
|
85
|
+
{ flag: 'repo', type: 'string', positional: 0, required: true, desc: '本地 git 仓库绝对路径' },
|
|
86
|
+
{ flag: 'visibility', type: 'string', enum: ['public', 'private'], required: true, desc: 'public | private' },
|
|
87
|
+
],
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
name: 'io_scan', cli: 'file-io', description: 'I/O 风险扫描(AST 四级分级 high/medium/low/safe——与审计 io-risk 同标准)。repo=目标(默认工作区)、writeOnly=只看写操作',
|
|
91
|
+
params: [
|
|
92
|
+
{ flag: 'repo', type: 'string', positional: 0, desc: '扫描目标(默认工作区)' },
|
|
93
|
+
{ flag: 'writeOnly', type: 'boolean', desc: '只看写操作' },
|
|
94
|
+
],
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
name: 'npm_publish', cli: 'npm-publish',
|
|
98
|
+
description: 'npm 发包(后台 job + dryRun):默认 dryRun=true 只做体检与 npm publish --dry-run(不写 registry);真发必须同时 confirm=true 且 dryRun=false。dir=目标包目录(缺省工作区)、tag=发布 tag(默认 latest)、otp=2FA 一次性口令(可选)。前置体检:private:true 拦截、同名版本占用检测、npm pack 文件清单',
|
|
99
|
+
params: [
|
|
100
|
+
{ flag: 'dir', type: 'string', positional: 0, desc: '目标包目录(缺省工作区)' },
|
|
101
|
+
{ flag: 'dryRun', type: 'boolean', desc: '只预演(默认 true,不写 registry)' },
|
|
102
|
+
{ flag: 'tag', type: 'string', desc: '发布 tag(latest/beta/next/rc/…,默认 latest)' },
|
|
103
|
+
{ flag: 'otp', type: 'string', desc: '2FA 一次性口令(可选)' },
|
|
104
|
+
{ flag: 'confirm', type: 'boolean', desc: '真发确认(dryRun=false 时必填)' },
|
|
105
|
+
{ flag: 'no-dry-run', type: 'boolean', desc: '关闭 dry-run(= dryRun:false;真发还需 --confirm)' },
|
|
106
|
+
{ flag: 'json', type: 'boolean', desc: 'JSON 输出(CLI 用;与其它工具同口径)' },
|
|
107
|
+
],
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
name: 'git_clone_preview', cli: 'clone-preview', description: 'clone 预演(不落盘——报告将拉取什么)。target=owner/repo、branch=分支——clone 前先看要拉什么',
|
|
111
|
+
params: [
|
|
112
|
+
{ flag: 'target', type: 'string', positional: 0, required: true, desc: 'owner/repo' },
|
|
113
|
+
{ flag: 'branch', type: 'string', desc: '分支名' },
|
|
114
|
+
],
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
name: 'link_check', cli: 'link-check', description: '检查文档链接有效性(md/txt 内 URL——只报 warning 不拦截提交)。path=文件或目录(默认工作区)',
|
|
118
|
+
params: [
|
|
119
|
+
{ flag: 'path', type: 'string', positional: 0, desc: '文件或目录(默认工作区)' },
|
|
120
|
+
],
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
name: 'edit_after_read', cli: 'edit-after-read',
|
|
124
|
+
description: '读改合一编辑:自己读当前文件 → 校验 → 字面替换 → 写回(比宿主守卫更严:读后文件被改动则拒绝、old 默认必须唯一匹配、按字面匹配不做正则解释)。参数名与宿主编辑工具对齐:path/file_path、old/old_string、new/new_string、all/replace_all 两套都认;new 必传(删除请显式传空串)',
|
|
125
|
+
params: [
|
|
126
|
+
{ flag: 'path', type: 'string', positional: 0, desc: '目标文件绝对路径(别名 file_path)' },
|
|
127
|
+
{ flag: 'old', type: 'string', desc: '要被替换的字面文本(含空白,必须精确匹配;别名 old_string)' },
|
|
128
|
+
{ flag: 'new', type: 'string', desc: "替换后的文本(别名 new_string);**必传**,要删除请显式传空串 ''" },
|
|
129
|
+
{ flag: 'all', type: 'boolean', desc: '替换全部匹配(默认 false:要求唯一匹配;别名 replace_all)' },
|
|
130
|
+
],
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
name: 'git_identity_rewrite', cli: 'identity-rewrite', description: '提交身份历史改写:把仓库里非规范身份(工具/AI 产生的 agent@dsh.local、eightfs@local、v2-clone@local,以及账号 noreply 的旧变体)的作者/committer 统一成登录账号的规范身份。默认 dryRun 只报告;真改写会先建备份引用、自检(提交数/工作树/身份全规范)通过才用 force-with-lease 强推;只处理 origin 属于登录账号的仓库。paths=仓库路径,root=扫描根',
|
|
134
|
+
params: [
|
|
135
|
+
{ flag: 'paths', type: 'string', positional: 0, desc: '目标仓库路径(逗号分隔;缺省按 root 扫描工作区)' },
|
|
136
|
+
{ flag: 'root', type: 'string', desc: '扫描根目录(缺省取配置 defaultScanRoot)' },
|
|
137
|
+
{ flag: 'dryRun', type: 'boolean', desc: '只预演不写入(默认 true;真改写传 false 或用 --write)' },
|
|
138
|
+
{ flag: 'write', type: 'boolean', desc: '真正改写(等价 dryRun:false)' },
|
|
139
|
+
{ flag: 'push', type: 'boolean', desc: '自检通过后 force-with-lease 强推远端' },
|
|
140
|
+
{ flag: 'extraEmails', type: 'string', desc: '额外要统一的邮箱(逗号分隔,如历史里出现过的真实邮箱)' },
|
|
141
|
+
{ flag: 'json', type: 'boolean', desc: 'JSON 输出(CLI:git-sluice identity-rewrite --json)' },
|
|
142
|
+
],
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
name: 'module_splitter', cli: 'module-splitter', description: '巨型单文件按顶层块拆分:analyze(先分析依赖)→ split(切分)→ verify(校验导出一致)。command=子命令、file/plan=目标 .js/plan.json、dryRun 预演',
|
|
146
|
+
params: [
|
|
147
|
+
{ flag: 'command', type: 'string', enum: ['analyze', 'split', 'verify'], positional: 0, required: true, desc: '子命令' },
|
|
148
|
+
{ flag: 'file', type: 'string', desc: 'analyze 的待拆 .js 路径' },
|
|
149
|
+
{ flag: 'plan', type: 'string', desc: 'split/verify 的 plan.json 路径' },
|
|
150
|
+
{ flag: 'dryRun', type: 'boolean', desc: '只预演不落盘' },
|
|
151
|
+
],
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
name: 'git_account_check', cli: 'account-check', description: '校验 GitHub 账号与凭据:token 在线校验 + SSH 公钥指纹——返回登录态/用户名/公钥数/套餐。token 不传自动解析;sshPub 非空顺带持久化',
|
|
155
|
+
params: [
|
|
156
|
+
{ flag: 'sshPub', type: 'string', desc: 'SSH 公钥内容(顺带持久化)' },
|
|
157
|
+
{ flag: 'token', type: 'string', desc: 'GitHub token(不传自动解析)' },
|
|
158
|
+
],
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
name: 'git_cred_env', cli: 'cred-env', description: '输出插件凭据的环境变量前缀(SSH GIT_SSH_COMMAND / HTTPS GIT_ASKPASS)——任意外部 git 命令前粘贴用,不含明文',
|
|
162
|
+
params: [],
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
name: 'git_gen_ssh_key', cli: 'gen-ssh-key', description: '生成 SSH 密钥对(写入插件配置目录;私钥不出本机——公钥整行回传)。email 必填;force 覆盖(先备份可恢复)',
|
|
166
|
+
params: [
|
|
167
|
+
{ flag: 'email', type: 'string', positional: 0, required: true, desc: '邮箱(x@y.z)' },
|
|
168
|
+
{ flag: 'force', type: 'boolean', desc: '已存在时强制覆盖(先备份)' },
|
|
169
|
+
],
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
name: 'git_sluice', cli: 'git', description: '浅包装 git 透传:AI 直接调用任意 git 命令(log/diff/branch/tag 等),凭据自动注入(SSH 私钥 / HTTPS token askpass)。args 传与 git 完全一致的参数串(空格分隔;路径含空格用引号包裹,例 status --short 或 log --oneline -5),返回退出码 status + stdout/stderr 原文。高频写操作(提交/推送/clone)仍优先 git_commit_push/git_clone 专用工具(自带审计门禁)。',
|
|
173
|
+
params: [
|
|
174
|
+
{ flag: 'args', type: 'string', positional: 0, desc: 'git 参数串(与 git 完全一致,空格分隔)' },
|
|
175
|
+
],
|
|
176
|
+
},
|
|
177
|
+
{
|
|
178
|
+
name: 'git_api', cli: 'api', description: '直接调用本插件的 HTTP API(34 条接口,与浏览器/CLI 同源实现:内部走 handleHttp 同一条代码路径)。path=接口名(去掉 /api/git-push/ 前缀,如 status / rule-slots / audit / settings-get);method 默认 GET;query=查询参数 JSON(如 {"mode":"full"});body=POST 请求体 JSON;不传 path 则列出全部可用接口。写类接口(settings-set / repo-push 等)内部调用按本机同源放行。',
|
|
179
|
+
params: [
|
|
180
|
+
{ flag: 'path', type: 'string', positional: 0, desc: '接口名(缺省 = 列出全部接口)' },
|
|
181
|
+
{ flag: 'method', type: 'string', desc: 'HTTP 方法(默认 GET;写操作传 POST)' },
|
|
182
|
+
{ flag: 'query', type: 'string', desc: '查询参数 JSON 字符串,如 {"mode":"full"}' },
|
|
183
|
+
{ flag: 'body', type: 'string', desc: 'POST 请求体 JSON 字符串' },
|
|
184
|
+
],
|
|
185
|
+
},
|
|
186
|
+
];
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* 注册表驱动参数解析(CLI 与工具同源——schema 通用解析):
|
|
190
|
+
* positional 按索引、--flag value/--flag=value、boolean --flag、
|
|
191
|
+
* default 填充、required/enum 校验。
|
|
192
|
+
* @param {string[]} rest CLI 参数串
|
|
193
|
+
* @param {Array} params 注册表 params
|
|
194
|
+
* @returns {{args?: object, error?: string}}
|
|
195
|
+
*/
|
|
196
|
+
/**
|
|
197
|
+
* 解析一个 `--flag` token(兼容 `--k=v` 与 `--k v` 两种形态),就地写入 args。
|
|
198
|
+
*
|
|
199
|
+
* 为什么单独成函数:原 parseRegistryArgs 把「flag 取值 / 布尔开关 / 缺值判定 / 越界看下一个 token」
|
|
200
|
+
* 全挤在循环里,圈复杂度 21(阈值 10,自审 max-cyclomatic-complexity 高风险)。
|
|
201
|
+
*
|
|
202
|
+
* @returns {{error?: string, consumedNext?: boolean}} consumedNext=true 表示值来自下一个 token(调用方需 i++)
|
|
203
|
+
*/
|
|
204
|
+
function applyFlagToken(args, tok, rest, i, byFlag) {
|
|
205
|
+
const eq = tok.indexOf('=');
|
|
206
|
+
const optName = eq >= 0 ? tok.slice(2, eq) : tok.slice(2);
|
|
207
|
+
// CLI 用 kebab(--max-file-mb / --extra-emails),注册表参数名用 camelCase(maxFileMb / extraEmails)——
|
|
208
|
+
// 两种写法都认,否则声明了参数却从 CLI 传不进来(实测:--extra-emails 报「未知参数」)。
|
|
209
|
+
const camel = optName.replace(/-([a-z])/g, (m, c) => c.toUpperCase());
|
|
210
|
+
const p = byFlag.get(optName) || byFlag.get(camel);
|
|
211
|
+
if (!p) return { error: `未知参数 --${optName}` };
|
|
212
|
+
if (p.type === 'boolean') {
|
|
213
|
+
args[p.flag] = eq >= 0 ? !['false', '0'].includes(tok.slice(eq + 1)) : true;
|
|
214
|
+
return {};
|
|
215
|
+
}
|
|
216
|
+
const optValue = eq >= 0 ? tok.slice(eq + 1) : rest[i + 1];
|
|
217
|
+
if (optValue === undefined || String(optValue).startsWith('--')) return { error: `--${optName} 需要值` };
|
|
218
|
+
args[p.flag] = optValue;
|
|
219
|
+
return { consumedNext: eq < 0 };
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/** 必填与枚举约束校验;返回错误文案(空串=通过)。 */
|
|
223
|
+
function validateParamConstraints(args, params) {
|
|
224
|
+
for (const p of params) {
|
|
225
|
+
if (p.required && args[p.flag] === undefined) return `缺少必填参数 ${p.flag}`;
|
|
226
|
+
if (p.enum && args[p.flag] !== undefined && !p.enum.includes(args[p.flag])) return `${p.flag} 取值必须为 ${p.enum.join('|')}`;
|
|
227
|
+
}
|
|
228
|
+
return '';
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
export function parseRegistryArgs(rest = [], params = []) {
|
|
232
|
+
const args = {};
|
|
233
|
+
const byFlag = new Map(params.map((p) => [p.flag, p]));
|
|
234
|
+
const positional = params.filter((p) => p.positional !== undefined).sort((a, b) => a.positional - b.positional);
|
|
235
|
+
let pi = 0;
|
|
236
|
+
for (let i = 0; i < rest.length; i++) {
|
|
237
|
+
const tok = rest[i];
|
|
238
|
+
if (tok.startsWith('--')) {
|
|
239
|
+
const r = applyFlagToken(args, tok, rest, i, byFlag);
|
|
240
|
+
if (r.error) return { error: r.error };
|
|
241
|
+
if (r.consumedNext) i++;
|
|
242
|
+
} else {
|
|
243
|
+
const p = positional[pi++];
|
|
244
|
+
if (!p) return { error: `多余的位置参数:${tok}` };
|
|
245
|
+
args[p.flag] = tok;
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
for (const p of params) if (args[p.flag] === undefined && p.default !== undefined) args[p.flag] = p.default;
|
|
249
|
+
const err = validateParamConstraints(args, params);
|
|
250
|
+
return err ? { error: err } : { args };
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
/** 工具名 → 注册表项(快速查找)。 */
|
|
254
|
+
export function registryByName(name) {
|
|
255
|
+
return TOOL_REGISTRY.find((t) => t.name === name);
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/** CLI 命令名 → 注册表项。 */
|
|
259
|
+
export function registryByCli(cli) {
|
|
260
|
+
return TOOL_REGISTRY.find((t) => t.cli === cli || (t.cli === undefined && t.name.replace(/_/g, '-') === cli));
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
/** 工具清单注入文本(宿主工具注册 + 帮助——同源生成)。 */
|
|
264
|
+
export function buildToolsListText() {
|
|
265
|
+
return TOOL_REGISTRY.map((t) => `${t.name}(${t.description})`).join(' / ');
|
|
266
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件入口层 · 常量
|
|
3
|
+
*
|
|
4
|
+
* name(插件名,宿主用它标识 loader 行)、GIT_PUSH_SETTINGS_NS(设置命名空间,
|
|
5
|
+
* 落 settings.yaml 的键前缀)、MSG_REPO_REQUIRED(未指定仓库时的统一提示)。
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
/** git 工具共用参数错误文案(单处定义,多处复用)。 */
|
|
9
|
+
export const MSG_REPO_REQUIRED = 'repo 必填';
|
|
10
|
+
|
|
11
|
+
export const name = 'dsh-git-push';
|
|
12
|
+
|
|
13
|
+
export const GIT_PUSH_SETTINGS_NS = 'git-push';
|
|
14
|
+
|
|
15
|
+
/** blocked 消息预览截断长度(审计输出精简——完整 message 走 /audit 明细)。多入口共用,单处定义。 */
|
|
16
|
+
export const MAX_MSG_PREVIEW = 80;
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* HTTP 处理层 · 账号端点(account-status / account-check / gen-ssh-key)
|
|
3
|
+
*
|
|
4
|
+
* 从 http-handlers.js 的 handleHttp 拆分而来。
|
|
5
|
+
* 统一签名:handleXxx(ctx) → { status, body };ctx = { req, query, body, env, cfg, path, method }。
|
|
6
|
+
*/
|
|
7
|
+
import {
|
|
8
|
+
readAccountStatus, writeAccountStatusFromResult, checkGithubAccount,
|
|
9
|
+
formatGithubAccountBlock, generateSshKey, persistSshPub, resolveToken, readSshPub, fetchApiQuota,
|
|
10
|
+
updateAccountStatusQuota,
|
|
11
|
+
} from '../../git/index.js';
|
|
12
|
+
|
|
13
|
+
/** 把 account-status.json 的 ISO 时间格式化为本地可读时间。 */
|
|
14
|
+
function formatLastLoginAt(iso) {
|
|
15
|
+
const t = Date.parse(String(iso || ''));
|
|
16
|
+
if (!Number.isFinite(t)) return '';
|
|
17
|
+
const date = new Date(t);
|
|
18
|
+
const p = (n) => String(n).padStart(2, '0');
|
|
19
|
+
return `${date.getFullYear()}-${p(date.getMonth() + 1)}-${p(date.getDate())} ${p(date.getHours())}:${p(date.getMinutes())}`;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** 凭据文件真源判断(区分「未配置」与「未校验」):读 token 文件与 SSH 公钥配置,读失败按未配置。 */
|
|
23
|
+
function readCredentialFlags(env) {
|
|
24
|
+
let fileHasToken = false;
|
|
25
|
+
let fileHasSsh = false;
|
|
26
|
+
try { fileHasToken = !!(resolveToken({ workspaceRoot: env.workspaceRoot }).token || '').trim(); } catch { /* 读失败按未配置 */ }
|
|
27
|
+
try { fileHasSsh = !!readSshPub({ workspaceRoot: env.workspaceRoot })?.configured; } catch { /* 读失败按未配置 */ }
|
|
28
|
+
return { fileHasToken, fileHasSsh };
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** 把快照里的 token/ssh 子对象映射成响应字段(valid/checked/timeout 归一为布尔与字符串)。 */
|
|
32
|
+
function toCredStatus(st = {}) {
|
|
33
|
+
return {
|
|
34
|
+
valid: !!st.valid,
|
|
35
|
+
login: st.login || '',
|
|
36
|
+
checked: !!st.checkedAt,
|
|
37
|
+
checkedAt: st.checkedAt || '',
|
|
38
|
+
timeout: st.timeout === true,
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* 渲染凭据块(Token / SSH 明细行 + 结论行)。
|
|
44
|
+
*
|
|
45
|
+
* 为什么单独成函数:这段原本是 handleAccountStatus 里的内联 IIFE(含 line() 闭包与
|
|
46
|
+
* 配额后缀判定),把该 handler 的圈复杂度推到 28(阈值 10,自审 max-cyclomatic-complexity
|
|
47
|
+
* 高风险)。提出来后:① handler 只做「读快照 + 组装响应」② 渲染规则可单独阅读与复用
|
|
48
|
+
* (设置侧边栏 / 命令输出若要用同一形态,直接调本函数)。
|
|
49
|
+
*
|
|
50
|
+
* 形态约定:Token/SSH 明细行**原样保留**(登录名与校验时间各列一遍,不重复展示);
|
|
51
|
+
* Token 行尾追加实时配额后缀「(配额剩余 N/h)」——N 取 core 通道剩余额度(按小时限额),
|
|
52
|
+
* 无配额数据时不加后缀(既不打网络、也没有历史记录时保持简洁)。
|
|
53
|
+
*
|
|
54
|
+
* @param {object} snap account-status.json 快照(含 token/ssh/apiQuota)
|
|
55
|
+
* @param {{fileHasToken:boolean, fileHasSsh:boolean}} flags 凭据文件真源判断(区分「未配置」与「未校验」)
|
|
56
|
+
* @returns {string} 多行凭据块文本
|
|
57
|
+
*/
|
|
58
|
+
function renderCredentialBlock(snap, { fileHasToken, fileHasSsh }) {
|
|
59
|
+
const ts = snap?.token || {};
|
|
60
|
+
const ss = snap?.ssh || {};
|
|
61
|
+
const quotaSuffix = (() => {
|
|
62
|
+
const core = snap?.apiQuota?.core;
|
|
63
|
+
const remaining = core && Number(core.remaining);
|
|
64
|
+
return Number.isFinite(remaining) && remaining >= 0 ? `(配额剩余${remaining}/h)` : '';
|
|
65
|
+
})();
|
|
66
|
+
const line = (label, configured, st, suffix = '') => {
|
|
67
|
+
if (!configured) return `⏳ ${label}:未配置`;
|
|
68
|
+
const who = st.login || '已配置';
|
|
69
|
+
if (st.valid) {
|
|
70
|
+
const when = formatLastLoginAt(st.checkedAt);
|
|
71
|
+
return `✅ ${label}:${who}${when ? '|校验于 ' + when : ''}${suffix ? ' ' + suffix : ''}`;
|
|
72
|
+
}
|
|
73
|
+
if (st.timeout) return `⏳ ${label}:${who}|未测成(网络超时,可重试)`;
|
|
74
|
+
if (st.checkedAt) {
|
|
75
|
+
const when = formatLastLoginAt(st.checkedAt);
|
|
76
|
+
return `❌ ${label}:${who}${when ? '|失效于 ' + when : ''}`;
|
|
77
|
+
}
|
|
78
|
+
return `⏳ ${label}:${who}|未校验`;
|
|
79
|
+
};
|
|
80
|
+
const hasAny = !!(ts.valid || ss.valid);
|
|
81
|
+
const lines = [line('Token', fileHasToken, ts, quotaSuffix), line('SSH 公钥', fileHasSsh, ss)];
|
|
82
|
+
if (fileHasToken && !ts.valid && ss.valid) lines.push('(推送走 SSH,Token 失效不影响推送)');
|
|
83
|
+
const head = hasAny ? '✅ 凭据可用' : '⚠️ 凭据不可用:点「重新检测」在线校验';
|
|
84
|
+
return `${head}\n${lines.join('\n')}`;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** GET /api/git-push/account-status —— 离线读账号状态快照 + 凭据文件真源判断。 */
|
|
88
|
+
export function handleAccountStatus(ctx) {
|
|
89
|
+
const { env } = ctx;
|
|
90
|
+
const status = readAccountStatus({ workspaceRoot: env.workspaceRoot });
|
|
91
|
+
const { fileHasToken, fileHasSsh } = readCredentialFlags(env);
|
|
92
|
+
const snap = status;
|
|
93
|
+
const ts = snap?.token || {};
|
|
94
|
+
const ss = snap?.ssh || {};
|
|
95
|
+
const statusObj = {
|
|
96
|
+
ok: true,
|
|
97
|
+
offline: true,
|
|
98
|
+
loggedIn: !!(ts.valid || ss.valid),
|
|
99
|
+
username: snap?.username || '',
|
|
100
|
+
tokenConfigured: fileHasToken,
|
|
101
|
+
sshConfigured: fileHasSsh,
|
|
102
|
+
tokenStatus: toCredStatus(ts),
|
|
103
|
+
sshStatus: toCredStatus(ss),
|
|
104
|
+
checkedAt: snap?.checkedAt || '',
|
|
105
|
+
apiQuota: snap?.apiQuota || null,
|
|
106
|
+
block: snap ? renderCredentialBlock(snap, { fileHasToken, fileHasSsh }) : '(暂无登录记录,点击「重新检测」在线校验)',
|
|
107
|
+
};
|
|
108
|
+
return { status: 200, body: statusObj };
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** 配额查询缓存:{ at, data }——60 秒内复用,避免前端刷新反复打 GitHub。 */
|
|
112
|
+
let apiQuotaCache = null;
|
|
113
|
+
const API_QUOTA_TTL_MS = 60_000;
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* GET /api/git-push/api-quota —— 实时查 token 的 GitHub API 配额(core/search/graphql/code_search)。
|
|
117
|
+
* /rate_limit 端点**不消耗配额**;60 秒进程内缓存;?refresh=1 强制刷新。
|
|
118
|
+
*/
|
|
119
|
+
export async function handleApiQuota(ctx) {
|
|
120
|
+
const { env, query } = ctx;
|
|
121
|
+
const force = String(query?.refresh || '') === '1';
|
|
122
|
+
if (!force && apiQuotaCache && Date.now() - apiQuotaCache.at < API_QUOTA_TTL_MS) {
|
|
123
|
+
// 命中缓存:本轮没有新的落盘动作,statusUpdated 恒 false(快照早在首次查询时已写)
|
|
124
|
+
return { status: 200, body: { ...apiQuotaCache.data, cached: true, statusUpdated: false } };
|
|
125
|
+
}
|
|
126
|
+
const data = await fetchApiQuota({ workspaceRoot: env.workspaceRoot });
|
|
127
|
+
apiQuotaCache = { at: Date.now(), data };
|
|
128
|
+
if (!data.ok) return { status: 200, body: { ...data, cached: false, statusUpdated: false } };
|
|
129
|
+
// 写回快照(统一收口 updateAccountStatusQuota,局部覆盖 apiQuota 一项)——account-status 是
|
|
130
|
+
// 「离线读」:Token 行的配额后缀要在不打网络时也能显示,就必须把本次查到的配额落到
|
|
131
|
+
// account-status.json;状态文件不存在时由收口函数按空底稿创建(此前这里静默丢写)。
|
|
132
|
+
// 收口结果**透传**给 UI:statusUpdated 驱动重读,写失败带 statusError 如实回报(不吞)。
|
|
133
|
+
const wr = updateAccountStatusQuota({
|
|
134
|
+
core: data.core, search: data.search, graphql: data.graphql, codeSearch: data.codeSearch,
|
|
135
|
+
checkedAt: data.fetchedAt,
|
|
136
|
+
}, { workspaceRoot: env.workspaceRoot });
|
|
137
|
+
return {
|
|
138
|
+
status: 200,
|
|
139
|
+
body: {
|
|
140
|
+
...data, cached: false,
|
|
141
|
+
statusUpdated: wr.statusUpdated === true,
|
|
142
|
+
statusCreated: wr.created === true,
|
|
143
|
+
...(wr.ok ? {} : { statusError: String(wr.error || '写入 account-status 失败') }),
|
|
144
|
+
},
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/** POST /api/git-push/account-check —— 在线校验账号(token/ssh),写 account-status.json。 */
|
|
149
|
+
export async function handleAccountCheck(ctx) {
|
|
150
|
+
const { body, env, cfg } = ctx;
|
|
151
|
+
const pub = String(body.sshPub || cfg.sshPub || '');
|
|
152
|
+
if (pub) persistSshPub(pub, { workspaceRoot: env.workspaceRoot });
|
|
153
|
+
const tok = String(body.githubToken || cfg.githubToken || '');
|
|
154
|
+
const accountInfo = await checkGithubAccount({ workspaceRoot: env.workspaceRoot, token: tok, checkSsh: body.checkSsh !== false });
|
|
155
|
+
accountInfo.block = formatGithubAccountBlock(accountInfo);
|
|
156
|
+
const wr = writeAccountStatusFromResult(accountInfo, { workspaceRoot: env.workspaceRoot });
|
|
157
|
+
return { status: 200, body: { ...accountInfo, statusUpdated: wr.statusUpdated === true, status: readAccountStatus({ workspaceRoot: env.workspaceRoot }) } };
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
/** POST /api/git-push/gen-ssh-key —— 生成 SSH 密钥对(公钥整行回传,私钥永不离开本机)。 */
|
|
161
|
+
export function handleGenSshKey(ctx) {
|
|
162
|
+
const { body, env } = ctx;
|
|
163
|
+
const r = generateSshKey(String(body.email || ''), { workspaceRoot: env.workspaceRoot, force: body.force === true });
|
|
164
|
+
if (!r.ok) return { status: 400, body: { ok: false, code: 'SSH_KEY', error: r.error } };
|
|
165
|
+
return { status: 200, body: { ok: true, email: r.email, privateKey: r.privateKey, pubFile: r.pubFile, pub: r.pub, note: '公钥已写入插件配置目录 *.pub,可复制粘贴到 GitHub → Settings → SSH and GPG keys' } };
|
|
166
|
+
}
|