dsh-git-push 2.20.19 → 3.1.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 +76 -47
- package/cli-tool.mjs +2 -4
- package/cli.mjs +11 -4
- package/lib/app/apply.js +15 -13
- package/lib/app/command-registry.js +26 -19
- package/lib/app/handlers/http-constants.js +8 -0
- package/lib/app/handlers/meta.js +2 -2
- package/lib/app/handlers/preprocess.js +104 -0
- package/lib/app/handlers/repo-actions.js +2 -3
- package/lib/app/handlers/repos.js +137 -10
- package/lib/app/handlers/settings.js +34 -15
- package/lib/app/http-handlers.js +13 -42
- package/lib/app/index.js +3 -2
- package/lib/app/inject-text.js +6 -21
- package/lib/app/preprocess-client.js +136 -0
- package/lib/app/repo-ownership.js +1 -1
- package/lib/app/schema.js +20 -10
- package/lib/app/settings-bridge.js +60 -8
- package/lib/app/severity.js +14 -0
- package/lib/app/slash-commands.js +5 -164
- package/lib/app/tool-call.js +96 -163
- package/lib/cli/commands-preprocess.mjs +74 -0
- package/lib/cli/commands-tool.mjs +3 -2
- package/lib/cli/commands-vcs.mjs +39 -5
- package/lib/cli/shared.mjs +36 -10
- package/lib/client/index.js +11 -16
- package/lib/client-parts/git/account.js +21 -12
- package/lib/client-parts/git/actions.js +23 -77
- package/lib/client-parts/git/apply.js +8 -2
- package/lib/client-parts/git/browser.js +1 -1
- package/lib/client-parts/git/const.js +33 -1
- package/lib/client-parts/git/controller.js +175 -176
- package/lib/client-parts/git/icons.js +1 -1
- package/lib/client-parts/git/loader.js +1 -1
- package/lib/client-parts/git/npm.js +56 -37
- package/lib/client-parts/git/page.js +53 -1
- package/lib/client-parts/git/repo.js +8 -1
- package/lib/client-parts/git/settings.js +13 -1
- package/lib/client-parts/git/state.js +237 -0
- package/lib/client-parts/git/utils.js +1 -1
- package/lib/client.js +631 -312
- package/lib/commit-push/pre-commit-engine.js +629 -30
- package/lib/commit-push.js +127 -67
- package/lib/context/index.js +7 -5
- package/lib/core/config.js +1 -27
- package/lib/core/exec.js +2 -11
- package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
- package/lib/git/identity-rewrite.js +1 -1
- package/lib/git/ignore.js +1 -1
- package/lib/git/index.js +1 -1
- package/lib/git/push.js +2 -17
- package/lib/git/repo-index.js +8 -3
- package/lib/git/repos.js +2 -2
- package/lib/git/sensitive.js +1 -1
- package/lib/npm/install.js +1 -1
- package/lib/npm/publish.js +20 -5
- package/lib/npm/registry.js +2 -2
- package/lib/plugin/auto-push.js +5 -8
- package/lib/preprocess/providers.js +195 -0
- package/lib/self/index.js +1 -1
- package/lib/skip-dirs.js +14 -55
- package/package.json +31 -42
- package/skills/dev/dsh-git-push.md +9 -9
- package/skills/guide/guide-commit-push.md +11 -13
- package/skills/workflow/README.md +0 -1
- package/skills/workflow/task-completion-report.md +2 -2
- package/.auditignore +0 -30
- package/.gitignore +0 -43
- package/cli-audit.mjs +0 -141
- package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
- package/lib/app/audit-api.js +0 -173
- package/lib/app/handlers/audit.js +0 -150
- package/lib/app/host-doc-checks.js +0 -25
- package/lib/app/schema-audit.js +0 -42
- 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/preprocess/audit.js +0 -98
- package/lib/preprocess/index.js +0 -78
- 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/lib/user-requirements.json +0 -15
- 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/build-client.mjs +0 -131
- package/scripts/bump-version.mjs +0 -178
- package/scripts/check-js-scope.mjs +0 -87
- package/scripts/check.mjs +0 -203
- package/scripts/clean-date-comments.py +0 -102
- package/scripts/cpu-sample.mjs +0 -188
- package/scripts/doc-drift.mjs +0 -200
- package/scripts/doc-func.mjs +0 -212
- package/scripts/doc-tree.mjs +0 -458
- package/scripts/doc-version.mjs +0 -149
- 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/local-registry.mjs +0 -37
- 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/scan-version.mjs +0 -125
- package/scripts/symbol-index.mjs +0 -85
- package/scripts/verify-prestep.mjs +0 -100
- package/scripts/version-source.mjs +0 -173
- 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/{audit-defaults.js → git/defaults.js} +0 -0
package/lib/audit/audit-file.js
DELETED
|
@@ -1,205 +0,0 @@
|
|
|
1
|
-
import { runChecks } from './checks.js';
|
|
2
|
-
import { exemptForFinding } from '../exempt/index.js';
|
|
3
|
-
import { isBestEffortWrite } from './file-context.js';
|
|
4
|
-
import { hasExternalCallTimeout, hasMkdirInSameFunction, hasForeignWriteTarget } from './file-context.js';
|
|
5
|
-
import { CODE_EXTS } from './finding.js';
|
|
6
|
-
import { privacyRulesEnabled, isPrivacyRule } from './ownership.js';
|
|
7
|
-
|
|
8
|
-
/**
|
|
9
|
-
* 单文件审计:读文件 → 跑检查 → 豁免过滤(注册表驱动,7 标记全消费)。
|
|
10
|
-
* 豁免判定:exemptForFinding 统一处理「文件头整文件 / 行内单点」两种位置语义;
|
|
11
|
-
* 外加两类语义豁免:
|
|
12
|
-
* 1) residue/style 检查只对代码文件生效(md/yml 文档里出现 debugger 字样是写作/定义,非残留)
|
|
13
|
-
* 2) 规则定义文件(audit-rules-*.yml)自动豁免规则驱动命中(pattern 字符串被自家 regex 自举命中)
|
|
14
|
-
*/
|
|
15
|
-
/**
|
|
16
|
-
* 构建/混淆产物判定(抽导出——审计扩展脚本复用,避免复制判定漂移):
|
|
17
|
-
* ①单行混淆(任一行 >5000 字符——压缩产物);②hash 文件名(Vite/webpack assets
|
|
18
|
-
* *-<HASH>.js 连字符形态 与 *.<HASH>.js / *.<HASH>.chunk.js 点分隔形态(webpack/CRA
|
|
19
|
-
* 标准产物如 runtime-main.d37830b0.js / main.83b810ac.chunk.js)——hash 段 ≥6 字符
|
|
20
|
-
* 大小写混合;纯小写连字符词如 env-compat 非产物);③html 产物(引用 hash 命名
|
|
21
|
-
* 静态资源——<script src="*.HASH.js"> / <link href="*.HASH.css">,docusaurus/CRA
|
|
22
|
-
* 生成的 index.html)。
|
|
23
|
-
* 产物不可改,行级规则(复杂度/魔数/命名/重复)必然爆炸误报——调用方跳过/降级。
|
|
24
|
-
*/
|
|
25
|
-
const JS_EXTS = ['js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx'];
|
|
26
|
-
|
|
27
|
-
// DSH 客户端入口推导已迁到**中立模块** lib/audit/client-entry.js(避免
|
|
28
|
-
// dispatch → audit-file → checks → dispatch 的循环依赖);此处**再导出**以保持既有导入路径可用。
|
|
29
|
-
export { resolveDshClientEntries, resolveDshClientFragments } from './client-entry.js';
|
|
30
|
-
|
|
31
|
-
function isMinifiedOneLine(text) {
|
|
32
|
-
let maxLine = 0; let start = 0;
|
|
33
|
-
for (let i = 0; i <= text.length; i++) {
|
|
34
|
-
if (i === text.length || text[i] === '\n') {
|
|
35
|
-
if (i - start > maxLine) maxLine = i - start;
|
|
36
|
-
start = i + 1;
|
|
37
|
-
}
|
|
38
|
-
if (maxLine > 5000) return true;
|
|
39
|
-
}
|
|
40
|
-
return false;
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
/** hash 段判定:≥6 字符且大小写/数字混合([A-Z0-9] 与 [a-z] 都出现——数字算大写侧)。
|
|
44
|
-
* d37830b0 / 83b810ac / CRnoCikG 均通过;纯小写词 env-compat/benchmark 不通过。 */
|
|
45
|
-
function isHashSegment(seg) {
|
|
46
|
-
return Boolean(seg && seg.length >= 6 && /[A-Z0-9]/.test(seg) && /[a-z]/.test(seg));
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export function isBuildArtifactFile(relPathOrFile = '', text = '') {
|
|
50
|
-
const rel = String(relPathOrFile || '');
|
|
51
|
-
const ext = rel.split('.').pop().toLowerCase();
|
|
52
|
-
if (JS_EXTS.includes(ext) && text && isMinifiedOneLine(text)) return true;
|
|
53
|
-
if (rel.endsWith('.js')) {
|
|
54
|
-
// 连字符形态:*-<HASH>.js 点分隔形态:*.<HASH>.js / *.<HASH>.chunk.js
|
|
55
|
-
const match = rel.match(/(^|[\/])[^\/]+(?:-([A-Za-z0-9]{6,})|\.([A-Za-z0-9]{6,})(?:\.[A-Za-z0-9]+)?)\.js$/);
|
|
56
|
-
if (match && isHashSegment(match[2] || match[3])) return true;
|
|
57
|
-
}
|
|
58
|
-
// html 产物:引用 hash 命名静态资源(docusaurus/CRA 的 index.html——生成物非手写页)。
|
|
59
|
-
// hash 段判定复用 isHashSegment:从引用 URL 末尾提取「主文件名段」(main.83b810ac.chunk.js
|
|
60
|
-
// → 取最后一个 ≥6 混排段 83b810ac;runtime-main.d37830b0.js → d37830b0)。
|
|
61
|
-
if (ext === 'html') {
|
|
62
|
-
// ① 声明了生成器:HTML 标准的 <meta name="generator" content="...">——任何代码生成器
|
|
63
|
-
// (archify / docusaurus / hugo / Sphinx…)都会写它。生成物不可手改,行级规则(内联脚本、
|
|
64
|
-
// 按钮无事件、复杂度…)在它上面必然误报(实测:archify 的自包含产物 813K、内联 <script>
|
|
65
|
-
// 是其**产物形态**,却按「管理界面 XSS」报 error 83 条)。
|
|
66
|
-
// 注意容忍 HTML 允许的写法差异:<meta name="generator"> / <meta name = "generator"> / 单引号。
|
|
67
|
-
if (/<meta\s+[^>]*name\s*=\s*["']generator["']/i.test(String(text || ''))) return true;
|
|
68
|
-
// ② 引用 hash 命名静态资源(docusaurus/CRA 的 index.html——生成物非手写页)。
|
|
69
|
-
// hash 段判定复用 isHashSegment:从引用 URL 末尾提取「主文件名段」(main.83b810ac.chunk.js
|
|
70
|
-
// → 取最后一个 ≥6 混排段 83b810ac;runtime-main.d37830b0.js → d37830b0)。
|
|
71
|
-
const refs = String(text || '').match(/(?:src|href)=["']([^"']+\.(?:js|css))["']/gi) || [];
|
|
72
|
-
if (refs.some((r) => {
|
|
73
|
-
const match = r.match(/([A-Za-z0-9]{6,})(?:\.[A-Za-z0-9]+)*\.(?:js|css)["']?$/);
|
|
74
|
-
if (!match) return false;
|
|
75
|
-
return isHashSegment(match[1]);
|
|
76
|
-
})) return true;
|
|
77
|
-
}
|
|
78
|
-
return false;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
export function auditFile({ file, relPath, text, grouped }, opts = {}) {
|
|
82
|
-
if (!text) return [];
|
|
83
|
-
const ext = String(relPath || file || '').split('.').pop().toLowerCase();
|
|
84
|
-
const isCode = CODE_EXTS.has(ext);
|
|
85
|
-
// 混淆构建产物识别——Vite/webpack 压缩的 .js 单行可达 10万+ 字符
|
|
86
|
-
// (heroui-kGyYtjDh.js 单行 308K、index-BjhIkylN.js 单行 107K;正常源码最大 ~250)。
|
|
87
|
-
// 这类文件是第三方构建产物(非本项目手写代码),行级规则(复杂度/函数长/魔数/
|
|
88
|
-
// 重复串/命名)在单行 10万字符上必然爆炸误报且无意义(产物不可改)。
|
|
89
|
-
// 处理:跳过行级规则,保留文件级(长度/健康度)与凭据扫描(产物若含真凭据仍报)。
|
|
90
|
-
let isMinified = false;
|
|
91
|
-
if (isCode && (ext === 'js' || ext === 'mjs' || ext === 'cjs' || ext === 'ts' || ext === 'tsx' || ext === 'jsx')) {
|
|
92
|
-
// 判据:任一单行 > 5000 字符(混淆压缩产物)。不要求总大小——41K 的
|
|
93
|
-
// icon-runtime 与 567B 的 rolldown-runtime 都是单行混淆(行长=文件大小);
|
|
94
|
-
// 正常手写代码单行不可能 5000+(实测源码最大 ~250)。
|
|
95
|
-
isMinified = (() => {
|
|
96
|
-
let maxLine = 0; let start = 0;
|
|
97
|
-
for (let i = 0; i <= text.length; i++) {
|
|
98
|
-
if (i === text.length || text[i] === '\n') {
|
|
99
|
-
if (i - start > maxLine) maxLine = i - start;
|
|
100
|
-
start = i + 1;
|
|
101
|
-
}
|
|
102
|
-
if (maxLine > 5000) return true;
|
|
103
|
-
}
|
|
104
|
-
return false;
|
|
105
|
-
})();
|
|
106
|
-
}
|
|
107
|
-
// 构建产物 hash 文件名豁免(Vite/webpack assets:*-<HASH>.js——
|
|
108
|
-
// hash 段大写开头且 ≥6 字符,如 SensitiveMedia-BV5WWa1r.js / AboutPage-fPxR3xhp.js;
|
|
109
|
-
// 不误伤手写文件——env-compat/benchmark 等小写段不匹配)。与单行混淆同层处理:
|
|
110
|
-
// 构建产物非本项目手写代码,行级规则(复杂度/魔数/重复/命名)必然误报且产物不可改。
|
|
111
|
-
const isBuildArtifact = isBuildArtifactFile(relPath || file, text);
|
|
112
|
-
if (isBuildArtifact) {
|
|
113
|
-
// 混淆/构建产物:只保留文件级检查(file-health)+ 凭据/路径安全(产物若含真凭据仍报)。
|
|
114
|
-
// 屏蔽全部行级规则(正则/AST 在单行 10万+ 字符上必然爆炸误报且产物不可改)。
|
|
115
|
-
const scoped = {};
|
|
116
|
-
for (const [kind, rules] of Object.entries(grouped || {})) {
|
|
117
|
-
if (!Array.isArray(rules)) { scoped[kind] = rules; continue; }
|
|
118
|
-
// 保留:凭据类(secret/credential/security 硬编码)+ file-health + max-lines(文件级)
|
|
119
|
-
// empty-catch 屏蔽:混淆单行里 `catch{}` 模式天然密集(压缩产物),不是真实空 catch
|
|
120
|
-
const keep = rules.filter((r) => /^secret-|^cred|security\/no-hardcoded-credentials|security\/no-path-traversal|max-lines|max-file-length/.test(String(r?.id || ''))
|
|
121
|
-
&& !/no-empty-catch/.test(String(r?.id || '')));
|
|
122
|
-
if (keep.length) scoped[kind] = keep;
|
|
123
|
-
}
|
|
124
|
-
let findings = runChecks({ file, relPath, text, grouped: scoped }, { level: opts?.level, repoHasJsYamlImport: opts?.repoHasJsYamlImport, repoLevelRules: opts?.repoLevelRules, repoPath: opts?.repoPath, treeConfirm: opts?.treeConfirm });
|
|
125
|
-
// 产物超长是属性非问题;内置行级检查(quality/empty-catch 等)与残余行级规则也屏蔽——
|
|
126
|
-
// 混淆单行 10万+ 字符上 catch{} 等模式天然密集,非真实缺陷。
|
|
127
|
-
const keepRule = /^secret-|^cred|security\/no-hardcoded-credentials|security\/no-path-traversal/; // 构建/混淆产物:健康度(行长/大小)是产物属性非问题,只留凭据/路径安全
|
|
128
|
-
findings = findings.filter((f) => keepRule.test(String(f.rule || '')));
|
|
129
|
-
return findings.filter((f) => exemptForFinding(f, text) === false);
|
|
130
|
-
}
|
|
131
|
-
// 文档/配置(md/yml 等)不做重复串检查:反引号代码段、版本号、路径引用重复属正常书写,
|
|
132
|
-
// 按「硬编码文本」报会造成大面积噪音(maintainability 规则只对代码文件生效)
|
|
133
|
-
// 测试目录同理:fixture 会故意构造重复样本与 mock 值,重复是测试语义的一部分
|
|
134
|
-
const isTestFile = /(^|[/\\])(test|tests|__tests__|spec)[/\\]|\.(test|spec)\.(js|mjs|cjs|ts)$/i.test(String(relPath || file));
|
|
135
|
-
const maintainabilityScoped = !isCode || isTestFile;
|
|
136
|
-
const scopedGrouped = maintainabilityScoped ? { ...grouped, 'repeated-string': undefined, 'min-occurrences': undefined } : grouped;
|
|
137
|
-
// 隐私/凭据类规则只对**自有仓库**生效:克隆来的他人仓库里有什么邮箱/密钥与本次提交无关,
|
|
138
|
-
// 报出来是纯噪声(实测:某第三方 Unity 项目 3 条 blocker 全是 LICENSE 里的作者邮箱)。
|
|
139
|
-
// 判不出归属('unknown')时照旧生效——保守方向:宁可多报,不可漏掉自家隐私。
|
|
140
|
-
const privacyOn = privacyRulesEnabled(opts?.ownership);
|
|
141
|
-
const finalGrouped = privacyOn ? scopedGrouped : (() => {
|
|
142
|
-
const stripped = {};
|
|
143
|
-
for (const [kind, rules] of Object.entries(scopedGrouped || {})) {
|
|
144
|
-
if (!Array.isArray(rules)) { stripped[kind] = rules; continue; }
|
|
145
|
-
const keep = rules.filter((r) => !isPrivacyRule(r?.id));
|
|
146
|
-
if (keep.length) stripped[kind] = keep;
|
|
147
|
-
}
|
|
148
|
-
return stripped;
|
|
149
|
-
})();
|
|
150
|
-
let findings = runChecks({ file, relPath, text, grouped: finalGrouped }, { level: opts?.level, repoHasJsYamlImport: opts?.repoHasJsYamlImport, repoLevelRules: opts?.repoLevelRules, repoPath: opts?.repoPath, treeConfirm: opts?.treeConfirm });
|
|
151
|
-
const isRuleDefFile = /(^|[/\\])audit-rules-[a-z0-9-]+\.ya?ml$/i.test(String(relPath || file));
|
|
152
|
-
const fileLines = String(text || '').split('\n');
|
|
153
|
-
// 语义级豁免:纯 regex 规则看不到的上下文在此兜底——
|
|
154
|
-
// 1) timeout-on-external-api:命中调用内已设 AbortSignal.timeout/AbortController/timeout
|
|
155
|
-
// 2) client-module-loader-id:文件已按 window.__ModuleLoader__ 的 load 契约({id, factory} 模块表)注册
|
|
156
|
-
// (pattern 匹配到的是契约调用本身;规则本意是「缺契约才报」,已用契约即通过)
|
|
157
|
-
const hasLoaderContract = /window\.__ModuleLoader__\.load\s*\(\s*\{\s*id\s*:/.test(text);
|
|
158
|
-
// 豁免过滤(dsh-skip-* 注册表统一消费,覆盖 sensitive/size/func-length/syntax/quality/residue/style)
|
|
159
|
-
findings = findings.filter((f) => {
|
|
160
|
-
// 规则定义文件:规则驱动命中(secret/regex/path-regex/func-lines 等 yml 规则)全豁免
|
|
161
|
-
if (isRuleDefFile && f.rule !== 'quality/empty-catch' && f.rule !== 'robustness/io-risk') return false;
|
|
162
|
-
// 技能/规则文档豁免:skills/ 下的 skill 文档与 rules/ 文档里的
|
|
163
|
-
// 文档用语是「触发场景/规则描述」设计文本(如 whenToUse 触发场景描述),非代码残留——comment 规则不拦;
|
|
164
|
-
// version 规则同理:版本规则文档自身描述 0.x 例外(如 versioning-rule §二「内置模块从 0 开始」),
|
|
165
|
-
// 文档里的版本号示例是规则文本而非违规版本标记
|
|
166
|
-
const isSkillDoc = /(^|[/\\])skills([/\\]|$)/.test(String(relPath || file));
|
|
167
|
-
const isRulesDoc = /(^|[/\\])rules([/\\]|$)/.test(String(relPath || file));
|
|
168
|
-
const isCommentRule = f.rule === 'documentation/comment-suspicious-detection' || /^conv-/.test(f.rule || '');
|
|
169
|
-
const isVersionDocRule = /^version\//.test(f.rule || '');
|
|
170
|
-
if ((isSkillDoc || isRulesDoc) && !isCode && (isCommentRule || isVersionDocRule)) return false;
|
|
171
|
-
// residue/style:非代码文件豁免(文档/配置里的 debugger/console/风格字样非残留)
|
|
172
|
-
if (!isCode && (f.kind === 'regex')) {
|
|
173
|
-
const residueLike = /debugger|console|todo/i.test(f.rule);
|
|
174
|
-
if (residueLike) return false;
|
|
175
|
-
}
|
|
176
|
-
// timeout 语义豁免:外部调用已设超时
|
|
177
|
-
if (f.rule === 'robustness/timeout-on-external-api') {
|
|
178
|
-
const idx = Math.max(0, (Number(f.line) || 1) - 1);
|
|
179
|
-
if (hasExternalCallTimeout(fileLines[idx] || '', fileLines, idx)) return false;
|
|
180
|
-
// githubFetch 是唯一网络出口(api.js),内部统一 AbortSignal.timeout(timeout) 默认 60s——
|
|
181
|
-
// 调用处无需重复设置(纯 regex 规则看不到包装内部)
|
|
182
|
-
if (/githubFetch\s*\(/.test(fileLines[idx] || '')) return false;
|
|
183
|
-
}
|
|
184
|
-
// mkdir 语义豁免:① 写文件前同函数已建目录(ensureDataDir 模式)
|
|
185
|
-
// ② 写目标来自调用方(形参 / 形参成员 / 由形参派生的临时路径)⇒ 目录不归本函数管
|
|
186
|
-
if (f.rule === 'robustness/mkdir-before-write') {
|
|
187
|
-
const idx = Math.max(0, (Number(f.line) || 1) - 1);
|
|
188
|
-
if (hasMkdirInSameFunction(fileLines, idx)) return false;
|
|
189
|
-
if (hasForeignWriteTarget(fileLines, idx)) return false;
|
|
190
|
-
// best-effort 写入(写在 try 里、catch 明确兜底):失败只影响附属信息,
|
|
191
|
-
// 不按 warning 报——降级为提示,仍可见但不淹没信号(外部会话样本 3)。
|
|
192
|
-
if (isBestEffortWrite(fileLines, idx)) {
|
|
193
|
-
f.severity = 'notice';
|
|
194
|
-
f.message = `${f.message}(best-effort 写入:失败不影响主流程)`;
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
// loader 契约语义豁免:已按统一 ModuleLoader 契约注册
|
|
198
|
-
if (f.rule === 'dsh/client-module-loader-id' && hasLoaderContract) return false;
|
|
199
|
-
// DSH 插件语义豁免:name 以 dsh- 开头的插件不发布 npm(工作区/市场安装),
|
|
200
|
-
// private:true 是刻意配置(防误发布),npm/private-true-conflict 不报
|
|
201
|
-
if (f.rule === 'npm/private-true-conflict' && /"name"\s*:\s*"dsh-/.test(text)) return false;
|
|
202
|
-
return !exemptForFinding(f, text);
|
|
203
|
-
});
|
|
204
|
-
return findings;
|
|
205
|
-
}
|
|
@@ -1,148 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `.auditignore` 的**细粒度豁免**解析与匹配(文件 : 规则)。
|
|
3
|
-
*
|
|
4
|
-
* 为什么需要这一档:`.auditignore` 原先只有「整文件跳过」一种力度,而实际需求常是
|
|
5
|
-
* 「这个文件的其他规则照审,只免某一类」。典型场景:
|
|
6
|
-
* · 权重/参数表文件(`lib/score/index.js`):数字是「维度名 → 参数」映射值,
|
|
7
|
-
* 键名已表意,拆成常量反而割裂表格 ⇒ 只想免 magic-number,别的照报;
|
|
8
|
-
* · 通用字符串数据表(`plugins/x/lib/common-strings.js`):同理;
|
|
9
|
-
* · 跨文件看门狗:单文件里看不到超时设置(真实设置在宿主侧),静态分析无法识别。
|
|
10
|
-
* 旧做法只能整文件豁免 ⇒ 连带把可读性/健壮性问题一起藏起来,事实消失、不可追溯。
|
|
11
|
-
*
|
|
12
|
-
* 语法(在现有 gitignore 语法之上**追加**一行后缀,旧条目行为完全不变):
|
|
13
|
-
* # 整文件 / 整目录跳过(原有语义)
|
|
14
|
-
* lib/score/index.js
|
|
15
|
-
* .archify/*.html
|
|
16
|
-
*
|
|
17
|
-
* # 细粒度:路径 + " : " + 规则(逗号分隔,支持 slot/* 通配)+ 可选 # 理由
|
|
18
|
-
* lib/score/index.js : readability/magic-number-smart # 权重参数表,键名已表意
|
|
19
|
-
* test/lib/wait-ready.mjs : robustness/*, paths/hardcoded-absolute-path
|
|
20
|
-
*
|
|
21
|
-
* 解析保护(避免与既有写法冲突):冒号后**每一段都必须形如 `slot/rule`**(允许 `*`),
|
|
22
|
-
* 否则整行按文件模式处理。这样 `C:\Users\x`、`https://x/y`、`a:b` 这类既有内容
|
|
23
|
-
* 不会被误判成细粒度规则。
|
|
24
|
-
*
|
|
25
|
-
* 生效方式:细粒度条目不参与「采集阶段跳过」,而是在 finding 产出后**标记**为
|
|
26
|
-
* `exempted: true`(不扣分、不进 warning 计数),并在报告里单列一节列出理由——
|
|
27
|
-
* 既保留可追溯性,也不让「已确认豁免」与「未处理」混在一起。
|
|
28
|
-
*/
|
|
29
|
-
import { existsSync, readFileSync } from 'node:fs';
|
|
30
|
-
import { join, relative } from 'node:path';
|
|
31
|
-
|
|
32
|
-
import { isIgnoredByRules, parseGitignore } from './gitignore-match.js';
|
|
33
|
-
|
|
34
|
-
/** 规则段的合法形态:`slot/rule`,允许 `*` 通配(如 `robustness/*`)。 */
|
|
35
|
-
const RULE_SEGMENT_RE = /^[a-z][a-z0-9-]*\/[a-z0-9*][a-z0-9*/-]*$/;
|
|
36
|
-
/** 细粒度分隔符:冒号**两侧各一个空格**。刻意不用裸 `:` —— Windows 盘符与 URL 都含它。 */
|
|
37
|
-
const SEPARATOR = ' : ';
|
|
38
|
-
|
|
39
|
-
/**
|
|
40
|
-
* 把一行拆成「文件模式 + 规则段 + 理由」。
|
|
41
|
-
* @returns {{filePattern:string, rulePatterns:string[], reason:string}|null} 不是细粒度行时返回 null
|
|
42
|
-
*/
|
|
43
|
-
export function parseScopedLine(line) {
|
|
44
|
-
const raw = String(line || '');
|
|
45
|
-
if (!raw.trim() || raw.trim().startsWith('#')) return null;
|
|
46
|
-
const at = raw.indexOf(SEPARATOR);
|
|
47
|
-
if (at <= 0) return null;
|
|
48
|
-
// 注意:理由分隔(#)在**规则段内**处理——文件模式里出现 # 是合法 gitignore 字符
|
|
49
|
-
const afterSeparator = raw.slice(at + SEPARATOR.length);
|
|
50
|
-
const hashAt = afterSeparator.indexOf('#');
|
|
51
|
-
const rulePart = (hashAt === -1 ? afterSeparator : afterSeparator.slice(0, hashAt)).trim();
|
|
52
|
-
const reason = hashAt === -1 ? '' : afterSeparator.slice(hashAt + 1).trim();
|
|
53
|
-
const filePattern = raw.slice(0, at).trim();
|
|
54
|
-
if (!filePattern || !rulePart) return null;
|
|
55
|
-
const rulePatterns = rulePart.split(',').map((s) => s.trim()).filter(Boolean);
|
|
56
|
-
if (!rulePatterns.length) return null;
|
|
57
|
-
// 任一段不像规则 id ⇒ 不是细粒度行(防止旧写法被误解析)
|
|
58
|
-
if (!rulePatterns.every((p) => RULE_SEGMENT_RE.test(p))) return null;
|
|
59
|
-
return { filePattern, rulePatterns, reason };
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
/**
|
|
63
|
-
* 把一个 `.auditignore` 文本拆成两部分。
|
|
64
|
-
* @param {string} text 文件原文
|
|
65
|
-
* @returns {{wholeText:string, scoped:Array<{filePattern:string, rulePatterns:string[], reason:string, rules:object[]}>}}
|
|
66
|
-
* wholeText = **去掉细粒度行**后的文本(供采集阶段使用:这些文件不能被整文件跳过)
|
|
67
|
-
*/
|
|
68
|
-
export function splitAuditIgnore(text = '') {
|
|
69
|
-
const scoped = [];
|
|
70
|
-
const kept = [];
|
|
71
|
-
for (const line of String(text).split('\n')) {
|
|
72
|
-
const hit = parseScopedLine(line);
|
|
73
|
-
if (!hit) { kept.push(line); continue; }
|
|
74
|
-
let rules = [];
|
|
75
|
-
try { rules = parseGitignore(hit.filePattern); } catch { rules = []; }
|
|
76
|
-
if (!rules.length) { kept.push(line); continue; } // 文件模式解析不出 ⇒ 退回整行(保守)
|
|
77
|
-
scoped.push({ ...hit, rules });
|
|
78
|
-
}
|
|
79
|
-
return { wholeText: kept.join('\n'), scoped };
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
/** 规则模式(可含 `*`)是否命中某条 finding 的规则 id。 */
|
|
83
|
-
export function ruleMatches(pattern, ruleId) {
|
|
84
|
-
const p = String(pattern || '');
|
|
85
|
-
const id = String(ruleId || '');
|
|
86
|
-
if (!p || !id) return false;
|
|
87
|
-
if (!p.includes('*')) return p === id;
|
|
88
|
-
// 只支持 `*`(不引入正则元字符,避免用户写 `[` 造成非法正则)
|
|
89
|
-
const re = new RegExp(`^${p.split('*').map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('.*')}$`);
|
|
90
|
-
return re.test(id);
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
/**
|
|
94
|
-
* 判断某条 finding 是否被细粒度豁免覆盖。
|
|
95
|
-
* @param {Array} scoped splitAuditIgnore 的 scoped 结果
|
|
96
|
-
* @param {string} relPath 相对仓库根的路径(/ 分隔)
|
|
97
|
-
* @param {string} ruleId finding 的 rule
|
|
98
|
-
* @returns {{hit:boolean, reason:string, filePattern:string}}
|
|
99
|
-
*/
|
|
100
|
-
export function matchScopedExemption(scoped, relPath, ruleId) {
|
|
101
|
-
const path = String(relPath || '').replace(/\\/g, '/');
|
|
102
|
-
for (const it of Array.isArray(scoped) ? scoped : []) {
|
|
103
|
-
if (!it.rules?.length) continue;
|
|
104
|
-
if (!isIgnoredByRules(it.rules, path, false)) continue;
|
|
105
|
-
if (!it.rulePatterns.some((p) => ruleMatches(p, ruleId))) continue;
|
|
106
|
-
return { hit: true, reason: it.reason || '', filePattern: it.filePattern };
|
|
107
|
-
}
|
|
108
|
-
return { hit: false, reason: '', filePattern: '' };
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
/** 文本里是否存在细粒度条目(采集阶段据此决定要不要换 excludesFile)。 */
|
|
112
|
-
export function hasScopedEntries(text = '') {
|
|
113
|
-
return splitAuditIgnore(text).scoped.length > 0;
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
/**
|
|
117
|
-
* 把细粒度豁免应用到 findings 上:**标记而非丢弃**。
|
|
118
|
-
*
|
|
119
|
-
* 为什么不丢弃:丢弃会让「已确认豁免」与「未处理」在报告里无法区分(这正是要解决的问题)。
|
|
120
|
-
* 标记后计分/汇总跳过它们,但报告能单列一节列出「豁免了哪条、为什么」。
|
|
121
|
-
* @param {Array} findings 统一问题对象(原地修改)
|
|
122
|
-
* @param {string} root 仓库根
|
|
123
|
-
* @returns {{total:number, byRule:Record<string,number>}}
|
|
124
|
-
*/
|
|
125
|
-
export function applyScopedExemptions(findings = [], root = '') {
|
|
126
|
-
const byRule = {};
|
|
127
|
-
let total = 0;
|
|
128
|
-
let scoped = [];
|
|
129
|
-
try {
|
|
130
|
-
const p = join(root, '.auditignore');
|
|
131
|
-
if (existsSync(p)) scoped = splitAuditIgnore(readFileSync(p, 'utf8')).scoped;
|
|
132
|
-
} catch { scoped = []; }
|
|
133
|
-
if (!scoped.length) return { total, byRule };
|
|
134
|
-
for (const f of findings) {
|
|
135
|
-
if (f.exempted) continue;
|
|
136
|
-
const raw = String(f.file || '');
|
|
137
|
-
const rel = raw ? (raw.startsWith('/') ? relative(root, raw) : raw).replace(/\\/g, '/') : '';
|
|
138
|
-
if (!rel) continue;
|
|
139
|
-
const hit = matchScopedExemption(scoped, rel, f.rule);
|
|
140
|
-
if (!hit.hit) continue;
|
|
141
|
-
f.exempted = true;
|
|
142
|
-
f.exemptBy = 'auditignore';
|
|
143
|
-
f.exemptReason = hit.reason;
|
|
144
|
-
total += 1;
|
|
145
|
-
byRule[f.rule] = (byRule[f.rule] || 0) + 1;
|
|
146
|
-
}
|
|
147
|
-
return { total, byRule };
|
|
148
|
-
}
|
package/lib/audit/checks.js
DELETED
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 审计检查器入口(纯引用文件)
|
|
3
|
-
*
|
|
4
|
-
* ⚠️ 本文件**只写引用**,不含任何实现——保留它只为两点:
|
|
5
|
-
* ① 调用方(lib/audit/index.js 与各测试)继续 `from './checks.js'` 导入,路径稳定;
|
|
6
|
-
* ② 作为「检查层」的显式入口,一眼看出检查器从哪来。
|
|
7
|
-
*
|
|
8
|
-
* 实现已按职责分到两个目录:
|
|
9
|
-
* lib/ast/* 具体实现(token 级解析:注释/字符串/模板串感知)
|
|
10
|
-
* lib/checks/* 调用包装(把 AST 判定转成统一 finding;调度在 checks/dispatch.js)
|
|
11
|
-
*
|
|
12
|
-
* 加/改检查逻辑请去对应目录,不要在本文件实现(此处已无实现可加)。
|
|
13
|
-
* 三层架构:① 规则声明 lib/audit-rules/*.yml → ② 实现 lib/ast/* → ③ 包装 lib/checks/*;
|
|
14
|
-
* 本文件与 lib/audit/index.js 属编排层。
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
export * from '../checks/index.js';
|
|
@@ -1,93 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* DSH 客户端入口推导(**中立模块**:供 lib/checks/dispatch.js 与 lib/audit/audit-file.js 共用)。
|
|
3
|
-
*
|
|
4
|
-
* 为什么单独一个文件:`audit-file.js` 依赖 `runChecks`(定义在 `lib/checks/dispatch.js`),
|
|
5
|
-
* 若 `dispatch.js` 反过来从 `audit-file.js` 导入本函数,会形成
|
|
6
|
-
* dispatch → audit-file → checks → dispatch 的**循环依赖**。
|
|
7
|
-
* 把共用函数下沉到中立模块,两边都从它导入,依赖方向单向。
|
|
8
|
-
*
|
|
9
|
-
* 背景:DSH 要求插件的**运行态客户端**是单文件(`package.json` 的 `dsh.client` + `exports["./client"]`
|
|
10
|
-
* 指向同一文件)——那是**构建产物**,不是源码形态。源码可以按分片维护 + 构建拼接
|
|
11
|
-
* (见下方 `resolveDshClientFragments`;本仓库 `lib/client-parts/**` → `lib/client.js`,
|
|
12
|
-
* 由 scripts/build-client.mjs 拼接)。
|
|
13
|
-
* 调用方据此**降级**(仍报、不扣分),而不是静默排除——静默排除会让这个事实从报告里消失。
|
|
14
|
-
*
|
|
15
|
-
* 判据**推导而非写死文件名**:读仓库 `package.json` 的 `exports["./client"]`,兼容三种形态
|
|
16
|
-
* (字符串 / 条件导出对象 / 数组),并回退看 `dsh.client.entry`。换仓库自动生效。
|
|
17
|
-
*/
|
|
18
|
-
|
|
19
|
-
import { existsSync, readFileSync } from 'node:fs';
|
|
20
|
-
import { join } from 'node:path';
|
|
21
|
-
|
|
22
|
-
/**
|
|
23
|
-
* 推导仓库里的客户端入口文件(仓库相对路径集合)。
|
|
24
|
-
* @param {string} repoRoot 仓库根目录(绝对路径)
|
|
25
|
-
* @returns {Set<string>} 客户端入口的仓库相对路径集合(无 package.json / 无声明 → 空集)
|
|
26
|
-
*/
|
|
27
|
-
export function resolveDshClientEntries(repoRoot) {
|
|
28
|
-
const out = new Set();
|
|
29
|
-
// 空 repoRoot 必须早退:`join('', 'package.json')` = 'package.json' 会命中**当前工作目录**的
|
|
30
|
-
// package.json(调用方忘了传仓库根时,会拿运行目录的声明冒充仓库声明)。
|
|
31
|
-
if (!repoRoot) return out;
|
|
32
|
-
const pkgPath = join(String(repoRoot || ''), 'package.json');
|
|
33
|
-
if (!existsSync(pkgPath)) return out;
|
|
34
|
-
let pkg;
|
|
35
|
-
try {
|
|
36
|
-
pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
|
|
37
|
-
} catch {
|
|
38
|
-
return out; // package.json 损坏 → 按无声明处理(不抛,调用方无需兜底)
|
|
39
|
-
}
|
|
40
|
-
const pick = (v) => {
|
|
41
|
-
if (typeof v === 'string') return v;
|
|
42
|
-
if (Array.isArray(v)) return v.map(pick).find(Boolean) || '';
|
|
43
|
-
if (v && typeof v === 'object') {
|
|
44
|
-
for (const k of ['import', 'default', 'require']) if (v[k]) return pick(v[k]);
|
|
45
|
-
return Object.values(v).map(pick).find(Boolean) || '';
|
|
46
|
-
}
|
|
47
|
-
return '';
|
|
48
|
-
};
|
|
49
|
-
const target = pick(pkg.exports && pkg.exports['./client'])
|
|
50
|
-
|| pick(pkg.dsh && pkg.dsh.client && pkg.dsh.client.entry);
|
|
51
|
-
const rel = String(target || '').replace(/^\.\//, '').replace(/\\/g, '/');
|
|
52
|
-
if (rel) out.add(rel);
|
|
53
|
-
return out;
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
/**
|
|
57
|
-
* 推导仓库里的**客户端分片目录**(C8:分片源码 + 拼接产物 的写法)。
|
|
58
|
-
*
|
|
59
|
-
* 为什么不是「不可拆分」:DSH 要求的是**运行态客户端**是单文件(`dsh.client` + `exports["./client"]`
|
|
60
|
-
* 指向同一文件)——那是**构建产物**;源码完全可以按分片维护、由构建脚本拼接成那个单文件
|
|
61
|
-
* (本仓库:`lib/client-parts/**` → `lib/client.js`,见 scripts/build-client.mjs)。
|
|
62
|
-
* 于是分片目录里的文件是**片段**:单文件语法不成立、行数天然可能超阈值,
|
|
63
|
-
* 需要单独一档作用域(`dsh-client-fragment`)按片段定级,而不是靠「不可拆分」把整类问题挡掉。
|
|
64
|
-
*
|
|
65
|
-
* 判据推导而非写死:① 优先读 `package.json` 的 `dsh.client.fragments`(字符串或数组);
|
|
66
|
-
* ② 未显式声明时按**入口同目录 + `<入口名去扩展>-parts/`** 约定推导(`lib/client.js` → `lib/client-parts/`)。
|
|
67
|
-
* @param {string} repoRoot 仓库根目录(绝对路径)
|
|
68
|
-
* @returns {Set<string>} 分片目录的仓库相对路径前缀集合(目录以 `/` 结尾,供 startsWith 匹配)
|
|
69
|
-
*/
|
|
70
|
-
export function resolveDshClientFragments(repoRoot) {
|
|
71
|
-
const out = new Set();
|
|
72
|
-
if (!repoRoot) return out; // 同 resolveDshClientEntries:空根会让相对 package.json 命中工作目录
|
|
73
|
-
const pkgPath = join(String(repoRoot || ''), 'package.json');
|
|
74
|
-
if (!existsSync(pkgPath)) return out;
|
|
75
|
-
let pkg;
|
|
76
|
-
try {
|
|
77
|
-
pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
|
|
78
|
-
} catch {
|
|
79
|
-
return out;
|
|
80
|
-
}
|
|
81
|
-
const decl = pkg.dsh && pkg.dsh.client && pkg.dsh.client.fragments;
|
|
82
|
-
const list = Array.isArray(decl) ? decl : (typeof decl === 'string' ? [decl] : []);
|
|
83
|
-
for (const d of list) {
|
|
84
|
-
const rel = String(d || '').replace(/^\.\//, '').replace(/\\/g, '/').replace(/\/*$/, '/');
|
|
85
|
-
if (rel && rel !== '/') out.add(rel);
|
|
86
|
-
}
|
|
87
|
-
if (out.size) return out;
|
|
88
|
-
for (const entry of resolveDshClientEntries(repoRoot)) {
|
|
89
|
-
const m = /^(.*\/)?([^/]+)\.js$/.exec(entry);
|
|
90
|
-
if (m) out.add(`${m[1] || ''}${m[2]}-parts/`);
|
|
91
|
-
}
|
|
92
|
-
return out;
|
|
93
|
-
}
|