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