dsh-git-push 0.0.0-stage → 2.8.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.auditignore +30 -0
- package/.gitignore +39 -0
- package/LICENSE +21 -0
- package/README.md +1482 -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 +262 -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 +191 -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 +662 -0
- package/lib/app/tools.js +40 -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 +207 -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 +131 -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 +144 -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 +470 -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 +167 -0
- package/lib/npm/registry.js +147 -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 +193 -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/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,273 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 检查层 · package.json 检查
|
|
3
|
+
*
|
|
4
|
+
* 职责:npm 包规范检查(结构化读取 JSON,不靠正则猜)、依赖版本范围、私有包豁免。
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { join } from 'node:path';
|
|
8
|
+
|
|
9
|
+
import { existsSync } from 'node:fs';
|
|
10
|
+
|
|
11
|
+
import { makeFinding } from '../audit/index.js';
|
|
12
|
+
import { HINT_SENSITIVE } from './common.js';
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* 找出依赖声明里用 "*" 或 ^0.x(版本不可控)的条目。
|
|
16
|
+
* 只查 dependencies / peerDependencies / optionalDependencies(devDependencies 不随包发布,不在管辖内)。
|
|
17
|
+
*
|
|
18
|
+
* @param {object} pkg 解析后的 package.json
|
|
19
|
+
* @returns {Array<string>} 有问题的依赖名列表(形如 `@scope/name@*`)
|
|
20
|
+
*/
|
|
21
|
+
function starRangeDeps(pkg) {
|
|
22
|
+
const out = [];
|
|
23
|
+
for (const field of ['dependencies', 'peerDependencies', 'optionalDependencies']) {
|
|
24
|
+
const deps = pkg[field];
|
|
25
|
+
if (!deps || typeof deps !== 'object') continue;
|
|
26
|
+
for (const [depName, range] of Object.entries(deps)) {
|
|
27
|
+
if (typeof range !== 'string') continue;
|
|
28
|
+
const spec = range.trim();
|
|
29
|
+
if (spec === '*' || spec === 'x' || spec === 'latest' || /^\^0\./.test(spec)) out.push(`${depName}@${spec}`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
return out;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* npm 结构化检查(npm-json kind,1.0.3)。
|
|
37
|
+
* 对 package.json 做真实解析判定(替代「命中即提示」弱 pattern):
|
|
38
|
+
* - npm/files-missing-lib:main/exports 指向 lib/ 下入口时,files 数组须包含 lib(或对应入口文件)
|
|
39
|
+
* - npm/undeclared-js-yaml:lib 代码 import 'js-yaml' 时,dependencies 须已声明(文件级仅能验 dependencies 存在性;
|
|
40
|
+
* import 证据属全仓语义,证据法见规则描述,文件级 fallback 只验「dependencies 含 js-yaml」)
|
|
41
|
+
* 仅对扩展名为 json 且文件名为 package.json 的目标执行。
|
|
42
|
+
*/
|
|
43
|
+
/**
|
|
44
|
+
* 在 package.json 文本里定位某个键(或含某个值的行)的行号,供 finding 定位。
|
|
45
|
+
* 找不到时回退第 1 行。
|
|
46
|
+
* @param {string} text package.json 全文
|
|
47
|
+
* @param {string} key 键名(如 'files')
|
|
48
|
+
* @param {string} [valueHint] 值片段(用于定位具体条目行)
|
|
49
|
+
* @returns {number} 1-based 行号
|
|
50
|
+
*/
|
|
51
|
+
function findJsonKeyLine(text, key, valueHint) {
|
|
52
|
+
const lines = String(text || '').split('\n');
|
|
53
|
+
if (valueHint) {
|
|
54
|
+
const i = lines.findIndex((l) => l.includes(valueHint));
|
|
55
|
+
if (i >= 0) return i + 1;
|
|
56
|
+
}
|
|
57
|
+
const j = lines.findIndex((l) => new RegExp(`"${key}"\\s*:`).test(l));
|
|
58
|
+
return j >= 0 ? j + 1 : 1;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export function checkNpmJson({ file, text, rules, repoHasJsYamlImport, repoPath }) {
|
|
62
|
+
const findings = [];
|
|
63
|
+
const base = String(file || '').split(/[/\\]/).pop();
|
|
64
|
+
if (base !== 'package.json') return findings;
|
|
65
|
+
let pkg = null;
|
|
66
|
+
try { pkg = JSON.parse(text); } catch { return findings; } // JSON 语法错误有 syntax 检查器兜底
|
|
67
|
+
for (const rule of rules || []) {
|
|
68
|
+
const sev = rule.severity === 'error' ? 'blocker' : rule.severity || 'warning';
|
|
69
|
+
if (rule.id === 'npm/files-missing-lib') {
|
|
70
|
+
const mainTarget = typeof pkg.main === 'string' ? pkg.main : null;
|
|
71
|
+
const exportsTargets = pkg.exports && typeof pkg.exports === 'object'
|
|
72
|
+
? Object.values(pkg.exports).filter((v) => typeof v === 'string') : [];
|
|
73
|
+
const targets = [mainTarget, ...exportsTargets].filter(Boolean);
|
|
74
|
+
const entryInLib = targets.some((t) => /^lib\//.test(t));
|
|
75
|
+
const files = Array.isArray(pkg.files) ? pkg.files : null;
|
|
76
|
+
const libCovered = files ? files.some((f) => f === 'lib' || f === 'lib/' || targets.some((t) => f === t)) : true; // files 缺省=npm 默认全含
|
|
77
|
+
if (entryInLib && files && !libCovered) {
|
|
78
|
+
findings.push(makeFinding({
|
|
79
|
+
file, line: 1, rule: rule.id, kind: 'npm-json',
|
|
80
|
+
severity: sev,
|
|
81
|
+
message: `${rule.message || rule.name}(main=${mainTarget || 'n/a'},files 未见 lib)`,
|
|
82
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
83
|
+
exemptHint: HINT_SENSITIVE,
|
|
84
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
85
|
+
}));
|
|
86
|
+
}
|
|
87
|
+
} else if (rule.id === 'npm/undeclared-js-yaml') {
|
|
88
|
+
const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
|
|
89
|
+
// 规则语义 =「import 了 js-yaml 但未声明依赖」。全仓没有任何
|
|
90
|
+
// js-yaml import/require 时(零依赖项目),文件级 fallback 不应报——
|
|
91
|
+
// 否则每个零依赖插件的 package.json 都被误报 blocker(纯净安装根本不会
|
|
92
|
+
// 出现 Cannot find module 'js-yaml',因为没有代码引用它)。
|
|
93
|
+
if (repoHasJsYamlImport && !deps['js-yaml']) {
|
|
94
|
+
findings.push(makeFinding({
|
|
95
|
+
file, line: 1, rule: rule.id, kind: 'npm-json',
|
|
96
|
+
severity: sev,
|
|
97
|
+
message: `${rule.message || rule.name}(dependencies/devDependencies 均未声明 js-yaml)`,
|
|
98
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
99
|
+
exemptHint: HINT_SENSITIVE,
|
|
100
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
101
|
+
}));
|
|
102
|
+
}
|
|
103
|
+
} else if (rule.id === 'npm/license-field-check') {
|
|
104
|
+
// 真实判定——license 字段缺失才报。
|
|
105
|
+
// 旧实现是 pattern「命中 "version" 行即提示核对」,任何 package.json 都命中
|
|
106
|
+
// → 对已声明 license 的包恒定误报(规则名/描述与实际判定不符)。
|
|
107
|
+
const lic = pkg.license;
|
|
108
|
+
const hasLicense = (typeof lic === 'string' && lic.trim() !== '')
|
|
109
|
+
|| (Array.isArray(lic) && lic.length > 0);
|
|
110
|
+
if (!hasLicense) {
|
|
111
|
+
findings.push(makeFinding({
|
|
112
|
+
file, line: 1, rule: rule.id, kind: 'npm-json',
|
|
113
|
+
severity: sev,
|
|
114
|
+
message: `${rule.message || rule.name}(package.json 缺 license 字段)`,
|
|
115
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
116
|
+
exemptHint: HINT_SENSITIVE,
|
|
117
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
118
|
+
}));
|
|
119
|
+
}
|
|
120
|
+
} else if (rule.id === 'npm/repository-field-check') {
|
|
121
|
+
// 真实判定——repository 字段缺失才报(旧实现命中 "homepage" 即报)。
|
|
122
|
+
const repo = pkg.repository;
|
|
123
|
+
const hasRepo = (typeof repo === 'string' && repo.trim() !== '')
|
|
124
|
+
|| (repo && typeof repo === 'object' && typeof repo.url === 'string' && repo.url.trim() !== '');
|
|
125
|
+
if (!hasRepo) {
|
|
126
|
+
findings.push(makeFinding({
|
|
127
|
+
file, line: 1, rule: rule.id, kind: 'npm-json',
|
|
128
|
+
severity: sev,
|
|
129
|
+
message: `${rule.message || rule.name}(package.json 缺 repository 字段)`,
|
|
130
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
131
|
+
exemptHint: HINT_SENSITIVE,
|
|
132
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
133
|
+
}));
|
|
134
|
+
}
|
|
135
|
+
} else if (rule.id === 'npm/dependency-star-range') {
|
|
136
|
+
// 真实判定——只对**会发布**的包报「peer 用 *」。
|
|
137
|
+
// 本地私有插件(private: true,如 workspace 下自研插件)的 peerDependencies 是
|
|
138
|
+
// 「声明由宿主提供、不随包安装」的约定写法,写 "*" 不影响任何安装解析结果
|
|
139
|
+
// (包不发布、不装依赖),报出来是误报。公开包(无 private 或 false)仍严格报。
|
|
140
|
+
// ^0.x 的判定同样只在可发布包上执行(^0.x 会让 0.x 次要版本漂移)。
|
|
141
|
+
if (pkg.private === true) {
|
|
142
|
+
// 私有包:跳过 * 与 ^0.x 判定(非发布物,版本范围无实际影响)
|
|
143
|
+
} else {
|
|
144
|
+
const starDeps = starRangeDeps(pkg);
|
|
145
|
+
if (starDeps.length) {
|
|
146
|
+
const line = findJsonKeyLine(text, 'peerDependencies') || findJsonKeyLine(text, 'dependencies');
|
|
147
|
+
findings.push(makeFinding({
|
|
148
|
+
file, line, rule: rule.id, kind: 'npm-json',
|
|
149
|
+
severity: sev,
|
|
150
|
+
message: `${rule.message || rule.name}(${starDeps.join(', ')})`,
|
|
151
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
152
|
+
exemptHint: HINT_SENSITIVE,
|
|
153
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
154
|
+
}));
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
} else if (rule.id === 'npm/files-suspicious-entry') {
|
|
158
|
+
// 真实判定——files 数组里逐条核对路径是否存在。
|
|
159
|
+
// 旧实现是 pattern「命中 "files": [ 或 "audit-rules" 即报」,任何有 files
|
|
160
|
+
// 白名单的包都报(规则本意是查「条目路径写错导致漏打包」)。
|
|
161
|
+
const files = Array.isArray(pkg.files) ? pkg.files : null;
|
|
162
|
+
if (files && files.length) {
|
|
163
|
+
const repoRoot = repoPath;
|
|
164
|
+
for (const entry of files) {
|
|
165
|
+
if (typeof entry !== 'string' || !entry.trim()) continue;
|
|
166
|
+
if (!repoRoot) break; // 无仓库根时不做判定(避免臆测路径)
|
|
167
|
+
const clean = entry.replace(/^\.\//, '').replace(/\/$/, '');
|
|
168
|
+
const abs = join(repoRoot, clean);
|
|
169
|
+
if (!existsSync(abs)) { // dsh-skip-residue(package.json files 条目数少,逐条判定)
|
|
170
|
+
const line = findJsonKeyLine(text, 'files', entry);
|
|
171
|
+
findings.push(makeFinding({
|
|
172
|
+
file, line, rule: rule.id, kind: 'npm-json',
|
|
173
|
+
severity: sev,
|
|
174
|
+
message: `${rule.message || rule.name}(files 条目「${entry}」在仓库中不存在)`,
|
|
175
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
176
|
+
exemptHint: HINT_SENSITIVE,
|
|
177
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
178
|
+
}));
|
|
179
|
+
break; // 同一 package.json 只报一次(避免逐条刷屏)
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
} else if (rule.id === 'npm/license-unlicensed') {
|
|
184
|
+
// 真实判定——license 值**显式声明为 UNLICENSED / PROPRIETARY** 才报。
|
|
185
|
+
// 与 npm/license-field-check(缺字段)互补:这个更严重——公开包标 UNLICENSED 会让
|
|
186
|
+
// 使用者无法合法使用/再分发,npm 页面也会标红(依据 npm-publish-checklist 清单第 2 项)。
|
|
187
|
+
const licRaw = typeof pkg.license === 'string' ? pkg.license.trim().toUpperCase() : '';
|
|
188
|
+
if (licRaw === 'UNLICENSED' || licRaw === 'PROPRIETARY') {
|
|
189
|
+
findings.push(makeFinding({
|
|
190
|
+
file, line: findJsonKeyLine(text, 'license'), rule: rule.id, kind: 'npm-json',
|
|
191
|
+
severity: sev,
|
|
192
|
+
message: `${rule.message || rule.name}(license = ${pkg.license})`,
|
|
193
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
194
|
+
exemptHint: HINT_SENSITIVE,
|
|
195
|
+
scoreImpact: sev === 'blocker' ? 2 : 1,
|
|
196
|
+
}));
|
|
197
|
+
}
|
|
198
|
+
} else if (rule.id === 'npm/files-risky-entry') {
|
|
199
|
+
// 真实判定——files 白名单里逐条查「会被打进 tarball 的不该有的东西」:
|
|
200
|
+
// 敏感类(.env / secret / credential / token / *.key / *.pem / node_modules)⇒ 升级为 blocker
|
|
201
|
+
// (凭据随包发布是不可逆的泄露);体积类(*.tgz / music|audio / *.mp3|*.wav / 字体)⇒ 按规则严重度。
|
|
202
|
+
const files = Array.isArray(pkg.files) ? pkg.files : null;
|
|
203
|
+
const SENSITIVE_ENTRY = [/node_modules/, /(^|\/)\.env/, /secret/i, /credential/i, /token/i, /\.key$/i, /\.pem$/i];
|
|
204
|
+
const BULKY_ENTRY = [/\.tgz$/i, /music/i, /audio/i, /\.mp3$/i, /\.wav$/i, /\.(woff2?|ttf|otf|eot)$/i];
|
|
205
|
+
for (const entry of files || []) {
|
|
206
|
+
if (typeof entry !== 'string' || !entry.trim()) continue;
|
|
207
|
+
const clean = entry.replace(/^\.\//, '').replace(/\/$/, '');
|
|
208
|
+
const sensitive = SENSITIVE_ENTRY.some((re) => re.test(clean));
|
|
209
|
+
const bulky = BULKY_ENTRY.some((re) => re.test(clean));
|
|
210
|
+
if (!sensitive && !bulky) continue;
|
|
211
|
+
const effective = sensitive ? 'blocker' : sev;
|
|
212
|
+
findings.push(makeFinding({
|
|
213
|
+
file, line: findJsonKeyLine(text, 'files', entry), rule: rule.id, kind: 'npm-json',
|
|
214
|
+
severity: effective,
|
|
215
|
+
message: `${rule.message || rule.name}(files 条目「${entry}」${sensitive ? '属敏感内容' : '属体积产物'})`,
|
|
216
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
217
|
+
exemptHint: HINT_SENSITIVE,
|
|
218
|
+
scoreImpact: effective === 'blocker' ? 2 : 1,
|
|
219
|
+
}));
|
|
220
|
+
}
|
|
221
|
+
} else if (rule.id === 'npm/meta-incomplete') {
|
|
222
|
+
// 真实判定——逐个列出缺失的包元信息(npm 页面/搜索/溯源依赖它们)。
|
|
223
|
+
const missingMeta = [];
|
|
224
|
+
const authorOk = (typeof pkg.author === 'string' && pkg.author.trim() !== '')
|
|
225
|
+
|| (pkg.author && typeof pkg.author === 'object');
|
|
226
|
+
if (!authorOk) missingMeta.push('author');
|
|
227
|
+
if (!Array.isArray(pkg.keywords) || pkg.keywords.length === 0) missingMeta.push('keywords');
|
|
228
|
+
if (!pkg.bugs) missingMeta.push('bugs');
|
|
229
|
+
if (typeof pkg.homepage !== 'string' || !pkg.homepage.trim()) missingMeta.push('homepage');
|
|
230
|
+
if (missingMeta.length) {
|
|
231
|
+
findings.push(makeFinding({
|
|
232
|
+
file, line: 1, rule: rule.id, kind: 'npm-json',
|
|
233
|
+
severity: sev,
|
|
234
|
+
message: `${rule.message || rule.name}(缺 ${missingMeta.join(' / ')})`,
|
|
235
|
+
dimensions: rule.dimensions || ['可维护性'],
|
|
236
|
+
scoreImpact: sev === 'info' ? 0 : (sev === 'blocker' ? 2 : 1),
|
|
237
|
+
}));
|
|
238
|
+
}
|
|
239
|
+
} else if (rule.id === 'npm/prepack-script-present') {
|
|
240
|
+
// 真实判定——存在发布时会自动执行的脚本就提示(脚本跑不通 ⇒ 发布会直接失败)。
|
|
241
|
+
const scripts = pkg.scripts && typeof pkg.scripts === 'object' ? pkg.scripts : {};
|
|
242
|
+
const hooks = ['prepack', 'prepare', 'publishOnly', 'prepublishOnly'].filter((k) => typeof scripts[k] === 'string' && scripts[k].trim());
|
|
243
|
+
if (hooks.length) {
|
|
244
|
+
findings.push(makeFinding({
|
|
245
|
+
file, line: findJsonKeyLine(text, 'scripts'), rule: rule.id, kind: 'npm-json',
|
|
246
|
+
severity: sev,
|
|
247
|
+
message: `${rule.message || rule.name}(${hooks.join(' / ')})`,
|
|
248
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
249
|
+
scoreImpact: sev === 'info' ? 0 : (sev === 'blocker' ? 2 : 1),
|
|
250
|
+
}));
|
|
251
|
+
}
|
|
252
|
+
} else if (rule.id === 'npm/peer-range-unbounded') {
|
|
253
|
+
// 真实判定——peerDependencies 值没写显式上界(不含 '<')才提示。
|
|
254
|
+
// '*' 交由 npm/dependency-star-range 管辖(此处不重复报);私有包(不发布)整体跳过。
|
|
255
|
+
if (pkg.private !== true) {
|
|
256
|
+
const peers = pkg.peerDependencies && typeof pkg.peerDependencies === 'object' ? pkg.peerDependencies : {};
|
|
257
|
+
const unbounded = Object.entries(peers)
|
|
258
|
+
.filter(([, range]) => typeof range === 'string' && !range.includes('<') && range.trim() !== '*')
|
|
259
|
+
.map(([n, range]) => `${n}@${range}`);
|
|
260
|
+
if (unbounded.length) {
|
|
261
|
+
findings.push(makeFinding({
|
|
262
|
+
file, line: findJsonKeyLine(text, 'peerDependencies') || findJsonKeyLine(text, 'dependencies'), rule: rule.id, kind: 'npm-json',
|
|
263
|
+
severity: sev,
|
|
264
|
+
message: `${rule.message || rule.name}(${unbounded.join(', ')})`,
|
|
265
|
+
dimensions: rule.dimensions || ['可部署性'],
|
|
266
|
+
scoreImpact: sev === 'info' ? 0 : (sev === 'blocker' ? 2 : 1),
|
|
267
|
+
}));
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
return findings;
|
|
273
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 检查层 · 私密文件检查
|
|
3
|
+
*
|
|
4
|
+
* 职责:私有仓库可见性与私密文件清单核对。
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { globToRegex } from '../audit/glob.js';
|
|
8
|
+
|
|
9
|
+
import { execFileSync } from 'node:child_process';
|
|
10
|
+
|
|
11
|
+
import { makeFinding } from '../audit/index.js';
|
|
12
|
+
|
|
13
|
+
/* ───────── 私密检查常量 ───────── */
|
|
14
|
+
const LS_FILES_TIMEOUT_MS = 10000; // git ls-files 超时
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* 私密文件拦截检查(private 槽位,1.0.4,T1-T33 考古验收)。
|
|
18
|
+
* git ls-files 列全部跟踪文件 × private_files glob 匹配,按远端可见性分级:
|
|
19
|
+
* visibility=public → blocker(私钥/凭据已可被任何人获取,禁止推送)
|
|
20
|
+
* visibility=private|unknown → warning(私有边界内仅提醒,转公开前须先移除)
|
|
21
|
+
* @param {object} p { root, visibility, privateFiles[] } visibility: 'public'|'private'|'unknown'
|
|
22
|
+
* @returns {Array} findings
|
|
23
|
+
*/
|
|
24
|
+
export function checkPrivateFiles({ root, visibility = 'unknown', privateFiles = [] }) {
|
|
25
|
+
const findings = [];
|
|
26
|
+
if (!root || !Array.isArray(privateFiles) || privateFiles.length === 0) return findings;
|
|
27
|
+
let tracked;
|
|
28
|
+
try {
|
|
29
|
+
// 显式捕获 stderr——execFileSync 未设 stdio 时异常会把子进程 stderr 直通父进程
|
|
30
|
+
// (非 git 目录跑 git ls-files 会打印「致命错误:不是 git 仓库」污染 audit --json 输出)
|
|
31
|
+
const out = execFileSync('git', ['ls-files'], { cwd: root, encoding: 'utf8', timeout: LS_FILES_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'pipe'] });
|
|
32
|
+
tracked = out.split('\n').filter(Boolean);
|
|
33
|
+
} catch (e) { /* 非 git 仓库 / git 不可用 → 跳过 */
|
|
34
|
+
if (String(e?.stderr || '').trim()) { /* stderr 已捕获,静默 */ }
|
|
35
|
+
return findings;
|
|
36
|
+
}
|
|
37
|
+
if (!tracked.length) return findings;
|
|
38
|
+
const compiled = privateFiles
|
|
39
|
+
.map((g) => ({ glob: g, re: globToRegex(g) }))
|
|
40
|
+
.filter((x) => x.re);
|
|
41
|
+
const hits = [];
|
|
42
|
+
for (const p of tracked) {
|
|
43
|
+
for (const pf of compiled) {
|
|
44
|
+
if (pf.re.test(p)) { hits.push(p); break; }
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
if (!hits.length) return findings;
|
|
48
|
+
const publicGate = visibility === 'public';
|
|
49
|
+
for (const p of hits) {
|
|
50
|
+
findings.push(makeFinding({
|
|
51
|
+
file: p, line: 1, rule: publicGate ? 'private-file-public' : 'private-file-in-repo',
|
|
52
|
+
kind: 'private-files',
|
|
53
|
+
severity: publicGate ? 'blocker' : 'warning',
|
|
54
|
+
message: publicGate
|
|
55
|
+
? `仓库跟踪私密文件 ${p} 且远端公开(public)——私钥/凭据已可被任何人获取,禁止推送;请移除该文件或转为私有仓库`
|
|
56
|
+
: `仓库跟踪私密文件 ${p}(远端 ${visibility === 'private' ? '私有' : '未确认'});私有边界内仅提醒,若未来转公开请先移除`,
|
|
57
|
+
dimensions: ['安全性', '可部署性'],
|
|
58
|
+
exemptHint: 'dsh-skip-sensitive(文件头=整文件)',
|
|
59
|
+
scoreImpact: publicGate ? 1 : 0,
|
|
60
|
+
}));
|
|
61
|
+
}
|
|
62
|
+
return findings;
|
|
63
|
+
}
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 检查层 · 正则类规则
|
|
3
|
+
*
|
|
4
|
+
* 职责:跑 compiled regex/path-regex/blacklist 规则,把命中转成 finding。
|
|
5
|
+
* 正则只做初筛;需要语义确认的规则在此消费 astConfirm 精筛集合(见 common.js),
|
|
6
|
+
* 避免「正则命中即报」造成误报。
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import { makeCodeLineFilter, checkMagicNumberSmartAst } from '../ast/index.js';
|
|
10
|
+
import { RISK_BADGE, RISK_LABEL } from '../ast/io-risk.js';
|
|
11
|
+
// 硬编码绝对路径精筛(paths 槽位 / astConfirmKind: "hardcoded-abs-path")——引擎侧唯一实现:
|
|
12
|
+
// fs 可访问性判断 + 相对路径换算(正则做不到的两件事)。脚本调用本实现,不自带第二份 PATTERNS。
|
|
13
|
+
import { hardcodedAbsPathLines, hardcodedAbsPathDetail, describeHardcodedAbsPath } from './hardcoded-path.js';
|
|
14
|
+
|
|
15
|
+
/* ───────── 正则检查常量 ───────── */
|
|
16
|
+
const DEFAULT_REGEX_THRESHOLD = 40; // 规则未配 threshold 时的默认阈值
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* 按规则名前缀挑豁免关键词(与 lib/exempt/index.js 的 EXEMPT_MARKERS 分类一致)。
|
|
20
|
+
*
|
|
21
|
+
* 修 bug:此前只区分 `[FUNC]` / `credential-ref` 两种 kind,其余正则规则一律提示
|
|
22
|
+
* `dsh-skip-residue` ⇒ 安全类(security/credential/secret/password/hardcoded)与风格类
|
|
23
|
+
* (min-length/max-lines 等)按提示写了 residue 标记**并不会豁免**(residue 只覆盖
|
|
24
|
+
* debugger/todo/console/io-risk/client-node-builtin-require),提示与行为不符(用户实测报告)。
|
|
25
|
+
*
|
|
26
|
+
* @returns {string} 展示给用户的豁免提示(含「写哪里生效」的说明)
|
|
27
|
+
*/
|
|
28
|
+
export function pickExemptHint(rule) {
|
|
29
|
+
const id = String(rule?.id || '');
|
|
30
|
+
const kind = String(rule?.kind || '');
|
|
31
|
+
const hit = (words) => (Array.isArray(words) ? words : []).some((w) => id.includes(w));
|
|
32
|
+
const sensitive = EXEMPT_MARKERS['dsh-skip-sensitive'] || {};
|
|
33
|
+
const residue = EXEMPT_MARKERS['dsh-skip-residue'] || {};
|
|
34
|
+
const style = EXEMPT_MARKERS['dsh-skip-style'] || {};
|
|
35
|
+
// 凭据/密钥类:kind 直接判定,或规则名命中敏感词
|
|
36
|
+
if (['[FUNC]', 'credential-ref', 'credential-file', 'path-regex'].includes(kind) || hit(sensitive.sensitiveRules)) {
|
|
37
|
+
return 'dsh-skip-sensitive(行尾=本行 / 文件头=整文件)';
|
|
38
|
+
}
|
|
39
|
+
if (hit(residue.residueRules)) return 'dsh-skip-residue(行尾=本行)';
|
|
40
|
+
if (hit(style.styleRules)) return 'dsh-skip-style(文件头=整文件)';
|
|
41
|
+
// 三套清单都没命中 = 该规则当前没有可用豁免标记,保守沿用原提示(不新增误导)
|
|
42
|
+
return 'dsh-skip-residue(行尾=本行)';
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
import { makeFinding } from '../audit/index.js';
|
|
46
|
+
import { safeRe } from '../rule/compilers.js';
|
|
47
|
+
import { capSeverity } from './common.js';
|
|
48
|
+
// 豁免提示按规则名前缀选关键词——分类清单复用豁免注册表(单一来源,避免两处各写一份清单)
|
|
49
|
+
import { EXEMPT_MARKERS } from '../exempt/index.js';
|
|
50
|
+
import { credentialValueLines, placeholderCredentialLines, shortFuncNameLines, smallFileReadLines, consoleLogJsonLines, loopFullCollectionLines, repeatIdenticalCallLines, loopNoFallbackReturnLines, loopFullRewriteCallLines, nestedLinearScanLines, longSyncLoopLines, smartHitLines, shellCdDynamicLines, writeIntoGitignoredLines, ioRiskLines, ioRiskDetail } from './common.js';
|
|
51
|
+
|
|
52
|
+
/** 检查文本是否符合 regex 型规则(regex / secret / credential-ref)。
|
|
53
|
+
* @param {object} args { file, text, rules, source? , repoPath? } repoPath:仓库根(写目标命中 .gitignore 的精筛需要) */
|
|
54
|
+
export function checkRegexRules({ file, text, rules, source = '新增行', repoPath = '' }) {
|
|
55
|
+
const findings = [];
|
|
56
|
+
const lines = text.split('\n');
|
|
57
|
+
for (const rule of rules || []) {
|
|
58
|
+
// 子模式(subPatterns: [{regex, message}])优先;退回兼容旧结构(pattern/patterns RegExp)
|
|
59
|
+
const subs = Array.isArray(rule.subPatterns) && rule.subPatterns.length ? rule.subPatterns : null;
|
|
60
|
+
const patterns = subs
|
|
61
|
+
? subs.map((x) => x.regex)
|
|
62
|
+
: [rule.pattern, ...(Array.isArray(rule.patterns) ? rule.patterns : [])].filter(Boolean);
|
|
63
|
+
if (!patterns.length) continue;
|
|
64
|
+
// 白名单行豁免——命中 whitelist_patterns 的行不报(修凭据类误报:
|
|
65
|
+
// GM_cookie API 名 / o.cookie 属性 / "Cookie=" 字符串字面量 / gbCookie 字段名
|
|
66
|
+
// 都不是硬编码凭据值,正则只看文本无法区分「引用」与「赋值」)
|
|
67
|
+
const whitelist = (rule.whitelistPatterns || []).map((w) => new RegExp(w));
|
|
68
|
+
// 正则初筛 → token 级精筛(规则声明 astConfirm: true 时启用)。
|
|
69
|
+
// 正则只负责快速筛出候选行,无法区分「代码」与「注释/字符串」;对候选行再做
|
|
70
|
+
// token 判定(lib/ast/code-lines.js 的 makeCodeLineFilter)确认是否真在代码里,
|
|
71
|
+
// 消除「注释里的版本号/日期」「CSS 字号/字符串里的数字」这类误报。
|
|
72
|
+
const candidates = [];
|
|
73
|
+
if (rule.astConfirm) {
|
|
74
|
+
for (let i = 0; i < lines.length; i++) {
|
|
75
|
+
const line = lines[i];
|
|
76
|
+
if (!line) continue;
|
|
77
|
+
if (whitelist.length && whitelist.some((w) => w.test(line))) continue;
|
|
78
|
+
if (patterns.some((p) => { p.lastIndex = 0; return p.test(line); })) candidates.push(i + 1);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
const codeFilter = rule.astConfirm ? makeCodeLineFilter(text, candidates, { file }) : null;
|
|
82
|
+
// readability/magic-number(唯一声明 astConfirm: magic-number 的规则)已合并进
|
|
83
|
+
// magic-number-smart;本分支保留机制(自定义规则包可复用),当前无内置规则消费。
|
|
84
|
+
const magicSmartLines = rule.astConfirm === 'magic-number' ? smartHitLines(text) : null;
|
|
85
|
+
// 具名精筛 astConfirmKind —— 规则声明「命中后还要 AST 确认什么」。
|
|
86
|
+
// 两种语义:deny = 集合内的行豁免(如 small-file-read 的受控小文件);
|
|
87
|
+
// allow = 只有集合内的行才报(如 short-func-name 的 token 级短名判定)。
|
|
88
|
+
let kindFilter = null;
|
|
89
|
+
if (rule.astConfirmKind === 'small-file-read') kindFilter = { mode: 'deny', lines: smallFileReadLines(text) };
|
|
90
|
+
// CLI console.log(JSON.stringify(大对象)) 一次性输出行豁免(memory-bomb json-stringify-large)
|
|
91
|
+
else if (rule.astConfirmKind === 'console-log-json') kindFilter = { mode: 'deny', lines: consoleLogJsonLines(text) };
|
|
92
|
+
else if (rule.astConfirmKind === 'short-func-name') kindFilter = { mode: 'allow', lines: shortFuncNameLines(text) };
|
|
93
|
+
else if (rule.astConfirmKind === 'credential-value') kindFilter = { mode: 'allow', lines: credentialValueLines(text) };
|
|
94
|
+
// 前缀型密钥串(ghp_/sk-/AKIA)的占位符精筛:命中行是「演示值/占位文案」时豁免
|
|
95
|
+
else if (rule.astConfirmKind === 'placeholder-credential') kindFilter = { mode: 'deny', lines: placeholderCredentialLines(text, file) };
|
|
96
|
+
// shell 健壮性精筛(folder/cd-to-maybe-missing:cd 到动态路径且无兜底)
|
|
97
|
+
else if (rule.astConfirmKind === 'shell-cd-dynamic') kindFilter = { mode: 'allow', lines: shellCdDynamicLines(text) };
|
|
98
|
+
// 目录健壮性精筛(folder/write-into-gitignored-dir:写目标命中 .gitignore,需 repoPath 上下文)
|
|
99
|
+
else if (rule.astConfirmKind === 'write-into-gitignored') kindFilter = { mode: 'allow', lines: writeIntoGitignoredLines(text, repoPath) };
|
|
100
|
+
// 硬编码绝对路径精筛(paths/hardcoded-absolute-path):正则初筛形状,精筛判「本机是否可访问」
|
|
101
|
+
// 并换算相对路径(基准 = 文件所在目录)。可访问 ⇒ message 附相对路径;不可访问 ⇒ 仅警告。
|
|
102
|
+
else if (rule.astConfirmKind === 'hardcoded-abs-path') kindFilter = { mode: 'allow', lines: hardcodedAbsPathLines(text, file, repoPath), detail: hardcodedAbsPathDetail(text, file, repoPath) };
|
|
103
|
+
// I/O 风险——正则只做初筛(注释/字符串里的 fs 示例会被命中),
|
|
104
|
+
// 由 AST 确认真实调用行,未确认的行不报
|
|
105
|
+
else if (rule.astConfirmKind === 'io-risk') kindFilter = { mode: 'allow', lines: ioRiskLines(text), detail: ioRiskDetail(text) };
|
|
106
|
+
// 性能反模式:循环体内做全量集合物化(`Array.from(x.values())` 在 for/while/forEach 里)——
|
|
107
|
+
// allow 语义:只有落在循环体内的命中才报(循环外做一次完全正常,不得误报)
|
|
108
|
+
else if (rule.astConfirmKind === 'loop-full-collection') kindFilter = { mode: 'allow', lines: loopFullCollectionLines(text) };
|
|
109
|
+
// 性能反模式:同一循环体内重复调用同一函数(实参完全相同)→ 若为纯函数可记忆化/提前计算
|
|
110
|
+
else if (rule.astConfirmKind === 'repeat-identical-call') kindFilter = { mode: 'allow', lines: repeatIdenticalCallLines(text) };
|
|
111
|
+
// 性能反模式(2026-10-12 实战沉淀,每条都验证过「修复前命中、修复后不报」):
|
|
112
|
+
// ① 函数顶层循环里有值 return、循环之后既无 return 也无 throw ⇒ 可能返回 undefined
|
|
113
|
+
// (实战:fetchJsonHeaders 返回 undefined ⇒ 调用方解构崩溃)
|
|
114
|
+
else if (rule.astConfirmKind === 'loop-no-fallback-return') kindFilter = { mode: 'allow', lines: loopNoFallbackReturnLines(text) };
|
|
115
|
+
// ② 循环体内调用「整份重写文件」的函数 ⇒ 每轮重写整份(实战:逐目录写 15–26MB 游戏索引 = 几十 GB)
|
|
116
|
+
// 循环规模静态不可知,故规则本身只作 warning
|
|
117
|
+
else if (rule.astConfirmKind === 'loop-full-rewrite-call') kindFilter = { mode: 'allow', lines: loopFullRewriteCallLines(text) };
|
|
118
|
+
// ③ 成员判定回调(filter/find/some/every)里套 for + === ⇒ O(n×m)(实战:1.03 亿次比较 = 12,784ms)
|
|
119
|
+
else if (rule.astConfirmKind === 'nested-linear-scan') kindFilter = { mode: 'allow', lines: nestedLinearScanLines(text) };
|
|
120
|
+
// ④ async 函数内长同步循环(≥2 个 Sync 调用、无 await 让出点)⇒ 占满事件循环(实战:/api/* 堵死 74 秒)
|
|
121
|
+
else if (rule.astConfirmKind === 'long-sync-loop') kindFilter = { mode: 'allow', lines: longSyncLoopLines(text) };
|
|
122
|
+
for (let i = 0; i < lines.length; i++) {
|
|
123
|
+
const line = lines[i];
|
|
124
|
+
if (!line) continue;
|
|
125
|
+
if (whitelist.length && whitelist.some((w) => w.test(line))) continue; // 白名单整行豁免
|
|
126
|
+
// 精筛优先级:具名 kindFilter(astConfirmKind)比通用 codeFilter 更精确,二者并存时
|
|
127
|
+
// 以 kindFilter 为准 —— 否则会出现「kindFilter 判定这行不是凭据赋值(应拦),
|
|
128
|
+
// 却被 codeFilter 的粗判放行」。实测 README 说明「token 被误报」的文档段落:
|
|
129
|
+
// 行内含 markdown 行内代码,codeFilter 判为「代码行」而放行,而真正做 token 级
|
|
130
|
+
// 判定、明确认定其非凭据赋值的 credential-value 精筛被这层 AND 条件压制。
|
|
131
|
+
const hasKindAllow = kindFilter?.mode === 'allow';
|
|
132
|
+
if (!hasKindAllow) {
|
|
133
|
+
if (codeFilter && !codeFilter.isCode(i + 1)) continue; // 精筛:注释/字符串行不报
|
|
134
|
+
if (magicSmartLines && !magicSmartLines.has(i + 1)) continue; // 值级精筛:非魔数不报
|
|
135
|
+
}
|
|
136
|
+
if (kindFilter?.mode === 'deny' && kindFilter.lines.has(i + 1)) continue; // 命中即豁免(受控小文件等)
|
|
137
|
+
if (hasKindAllow && !kindFilter.lines.has(i + 1)) continue; // 仅白名单行可报(token 级精筛)
|
|
138
|
+
for (let j = 0; j < patterns.length; j++) {
|
|
139
|
+
const p = patterns[j];
|
|
140
|
+
if (line && p.test(line)) {
|
|
141
|
+
// I/O 风险:message 用 AST 的分级详情(四级徽标 + 上下文 + 理由),
|
|
142
|
+
// 否则只剩 yml 的 description,看不出这条是高还是低(正则路径特性)
|
|
143
|
+
const ioHit = rule.astConfirmKind === 'io-risk' ? kindFilter?.detail?.get(i + 1) : null;
|
|
144
|
+
const ioMsg = ioHit
|
|
145
|
+
? `${RISK_BADGE[ioHit.risk]} ${RISK_LABEL[ioHit.risk]}风险:${ioHit.call}(${ioHit.type}/${ioHit.kind})——${ioHit.reason}`
|
|
146
|
+
: null;
|
|
147
|
+
// 硬编码绝对路径:message 用精筛详情(可访问 ⇒ 附相对路径;不可访问 ⇒ 仅警告),
|
|
148
|
+
// 否则只剩 yml 的通用 description,看不到"改成什么"。
|
|
149
|
+
const hcHit = rule.astConfirmKind === 'hardcoded-abs-path' ? kindFilter?.detail?.get(i + 1) : null;
|
|
150
|
+
const hcMsg = hcHit ? describeHardcodedAbsPath(hcHit) : null;
|
|
151
|
+
// I/O 分级:低风险(启动路径上的一次性同步 I/O)性质上是**提示**,
|
|
152
|
+
// 不是「代码质量缺陷」—— 它不影响并发、不随数据量放大。此前 severity
|
|
153
|
+
// 一律取规则级 warning,导致 173 条 io-risk 里 161 条纯提示全按 warning
|
|
154
|
+
// 展示,把真实高危淹没在噪声里(scoreImpact 已先行降为 0,此处补齐 severity,
|
|
155
|
+
// 使「展示口径」与「计分口径」一致:info 即不计分)。
|
|
156
|
+
const ioSev = rule.astConfirmKind === 'io-risk' && ioHit
|
|
157
|
+
&& (ioHit.risk === 'low' || ioHit.risk === 'safe') ? 'info' : null;
|
|
158
|
+
findings.push(makeFinding({
|
|
159
|
+
file, line: i + 1, rule: rule.id, kind: rule.kind,
|
|
160
|
+
severity: ioSev || (rule.level === 'blocker' ? 'blocker' : rule.severity),
|
|
161
|
+
// I/O 分级 > 子模式专属 > 规则级
|
|
162
|
+
message: ioMsg || hcMsg || subs?.[j]?.message || rule.message || rule.name,
|
|
163
|
+
dimensions: rule.dimensions,
|
|
164
|
+
exemptHint: pickExemptHint(rule),
|
|
165
|
+
// I/O 分级:按风险等级定计分影响——低风险(启动路径一次性读取)
|
|
166
|
+
// 规则自身已注明「可豁免」,再按满分扣分属口径自相矛盾,
|
|
167
|
+
// 故降为 0(保留 finding 作提醒,不计入评分维度)
|
|
168
|
+
scoreImpact: rule.astConfirmKind === 'io-risk'
|
|
169
|
+
? (ioHit?.risk === 'low' || ioHit?.risk === 'safe' ? 0
|
|
170
|
+
: (ioHit?.risk === 'high' ? 2 : 1))
|
|
171
|
+
: (rule.level === 'blocker' ? 2 : (rule.severity === 'info' ? 0 : 1)), // info 级=建议/核对提示(版本表每行核对等),不扣分(countByDimension 跳过 scoreImpact 0)
|
|
172
|
+
}));
|
|
173
|
+
break; // 同规则一行只报一次
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
return findings;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/** 检查 path-regex 型规则(对文件路径校验)。 */
|
|
182
|
+
export function checkPathRegexRules({ file, relPath, rules }) {
|
|
183
|
+
const findings = [];
|
|
184
|
+
for (const rule of rules || []) {
|
|
185
|
+
const re = rule.pathPattern ? new RegExp(rule.pathPattern) : null;
|
|
186
|
+
if (re && re.test(relPath)) {
|
|
187
|
+
findings.push(makeFinding({
|
|
188
|
+
file, line: 1, rule: rule.id, kind: 'path-regex',
|
|
189
|
+
severity: rule.level === 'blocker' ? 'blocker' : rule.severity,
|
|
190
|
+
message: `${rule.message || rule.name}(命中路径 ${relPath})`,
|
|
191
|
+
dimensions: rule.dimensions,
|
|
192
|
+
exemptHint: 'dsh-skip-sensitive(文件头=整文件)',
|
|
193
|
+
scoreImpact: rule.level === 'blocker' ? 2 : 1,
|
|
194
|
+
}));
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
return findings;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* 注释措辞黑名单检查(comment-wording)。
|
|
202
|
+
* 两种模式(约定:关键词取消分数制):
|
|
203
|
+
* - blocker 模式(规则 severity=blocker):白名单命中 → 该行豁免不拦截;黑名单任一命中 → 直接 blocker。
|
|
204
|
+
* 不再计分/不再累计阈值——白名单放行、黑名单拦截,二值判定。
|
|
205
|
+
* - 普通模式(其余规则):保留历史分数制(blacklist 加分 + whitelist 减分 + additional_features 加分,
|
|
206
|
+
* 单行超阈值报 warning/notice)。
|
|
207
|
+
*/
|
|
208
|
+
export function checkBlacklist({ file, text, rules }) {
|
|
209
|
+
const findings = [];
|
|
210
|
+
const lines = text.split('\n');
|
|
211
|
+
for (const rule of rules || []) {
|
|
212
|
+
const black = (rule.blacklist || []).map((b) => ({ re: safeRe(b.pattern, rule.name || rule.id), weight: Number(b.weight) || 0, pattern: b.pattern }))
|
|
213
|
+
.filter((b) => b.re);
|
|
214
|
+
const white = (rule.whitelist || []).map((w) => ({ re: safeRe(w.pattern, rule.name || rule.id), penalty: Number(w.penalty) || 0 }))
|
|
215
|
+
.filter((w) => w.re);
|
|
216
|
+
const feats = (rule.additionalFeatures || []).map((a) => ({ re: safeRe(a.pattern, rule.name || rule.id), weight: Number(a.weight) || 0 }))
|
|
217
|
+
.filter((a) => a.re);
|
|
218
|
+
const threshold = Number(rule.threshold) || DEFAULT_REGEX_THRESHOLD;
|
|
219
|
+
|
|
220
|
+
// —— blocker 模式:白名单豁免 + 黑名单直拦(取消分数制)——
|
|
221
|
+
if (rule.severity === 'blocker') {
|
|
222
|
+
lines.forEach((line, idx) => {
|
|
223
|
+
if (white.some((w) => w.re.test(line))) return; // 白名单命中 → 整行豁免
|
|
224
|
+
const hit = black.find((b) => b.re.test(line));
|
|
225
|
+
if (!hit) return;
|
|
226
|
+
findings.push(makeFinding({
|
|
227
|
+
file, line: idx + 1, rule: rule.id, kind: 'blacklist',
|
|
228
|
+
severity: 'blocker',
|
|
229
|
+
message: `${rule.name || rule.id}(命中黑名单词「${hit.pattern}」)`,
|
|
230
|
+
dimensions: rule.dimensions || ['文档'],
|
|
231
|
+
exemptHint: 'dsh-skip-quality(文件头=整文件)',
|
|
232
|
+
scoreImpact: 2,
|
|
233
|
+
}));
|
|
234
|
+
});
|
|
235
|
+
continue;
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
// —— 普通模式:历史分数制 ——
|
|
239
|
+
lines.forEach((line, idx) => {
|
|
240
|
+
let score = 0;
|
|
241
|
+
for (const b of black) if (b.re.test(line)) score += b.weight;
|
|
242
|
+
for (const wEntry of white) if (wEntry.re.test(line)) score -= wEntry.penalty;
|
|
243
|
+
for (const f of feats) if (f.re.test(line)) score += f.weight;
|
|
244
|
+
if (score < threshold) return;
|
|
245
|
+
findings.push(makeFinding({
|
|
246
|
+
file, line: idx + 1, rule: rule.id, kind: 'blacklist',
|
|
247
|
+
severity: capSeverity(rule.severity || 'warning', 'warning'),
|
|
248
|
+
message: `${rule.name || rule.id}(措辞分 ${score} ≥ ${threshold})`,
|
|
249
|
+
dimensions: rule.dimensions || ['文档'],
|
|
250
|
+
exemptHint: 'dsh-skip-quality(文件头=整文件)',
|
|
251
|
+
scoreImpact: 1,
|
|
252
|
+
}));
|
|
253
|
+
});
|
|
254
|
+
}
|
|
255
|
+
return findings;
|
|
256
|
+
}
|