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.
Files changed (198) hide show
  1. package/README.md +3 -2
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +36 -2
  4. package/lib/app/apply.js +9 -9
  5. package/lib/app/command-registry.js +44 -20
  6. package/lib/app/handlers/meta.js +7 -142
  7. package/lib/app/handlers/npm.js +18 -1
  8. package/lib/app/handlers/preprocess.js +107 -0
  9. package/lib/app/handlers/repo-actions.js +2 -2
  10. package/lib/app/http-handlers.js +25 -12
  11. package/lib/app/index.js +2 -1
  12. package/lib/app/inject-text.js +3 -2
  13. package/lib/app/preprocess-client.js +136 -0
  14. package/lib/app/repo-ownership.js +1 -1
  15. package/lib/app/schema.js +3 -3
  16. package/lib/app/severity.js +14 -0
  17. package/lib/app/slash-commands.js +5 -164
  18. package/lib/app/tool-call.js +75 -140
  19. package/lib/app/tools.js +13 -6
  20. package/lib/cli/commands-preprocess.mjs +74 -0
  21. package/lib/cli/commands-tool.mjs +3 -2
  22. package/lib/cli/commands-vcs.mjs +4 -4
  23. package/lib/cli/shared.mjs +42 -13
  24. package/lib/client-parts/git/controller.js +2 -2
  25. package/lib/client.js +2 -2
  26. package/lib/commit-push/pre-commit-engine.js +57 -10
  27. package/lib/commit-push.js +125 -36
  28. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  29. package/lib/git/ignore.js +1 -1
  30. package/lib/git/repos.js +2 -2
  31. package/lib/git/sensitive.js +1 -1
  32. package/lib/npm/publish.js +20 -5
  33. package/lib/plugin/auto-push.js +2 -2
  34. package/lib/preprocess/providers.js +191 -0
  35. package/lib/self/index.js +1 -1
  36. package/lib/skip-dirs.js +14 -55
  37. package/package.json +29 -37
  38. package/scripts/build-client.mjs +2 -0
  39. package/scripts/check.mjs +4 -2
  40. package/scripts/local-registry.mjs +2 -1
  41. package/skills/dev/dsh-git-push.md +5 -0
  42. package/cli-audit.mjs +0 -141
  43. package/lib/app/audit-api.js +0 -173
  44. package/lib/app/host-doc-checks.js +0 -25
  45. package/lib/app/scope-check.js +0 -69
  46. package/lib/ast/brace.js +0 -120
  47. package/lib/ast/callgraph.js +0 -135
  48. package/lib/ast/code-lines.js +0 -175
  49. package/lib/ast/consts.js +0 -12
  50. package/lib/ast/control-flow.js +0 -470
  51. package/lib/ast/credential.js +0 -315
  52. package/lib/ast/dataflow.js +0 -391
  53. package/lib/ast/dup-code.js +0 -165
  54. package/lib/ast/fs-hotspots.js +0 -154
  55. package/lib/ast/index.js +0 -38
  56. package/lib/ast/io-risk-const.js +0 -95
  57. package/lib/ast/io-risk-fn.js +0 -208
  58. package/lib/ast/io-risk-loop.js +0 -308
  59. package/lib/ast/io-risk.js +0 -314
  60. package/lib/ast/lang.js +0 -156
  61. package/lib/ast/line-count.js +0 -52
  62. package/lib/ast/magic-number.js +0 -272
  63. package/lib/ast/naming.js +0 -292
  64. package/lib/ast/perf.js +0 -488
  65. package/lib/ast/scope-collisions.js +0 -228
  66. package/lib/ast/scope.js +0 -241
  67. package/lib/ast/shell.js +0 -131
  68. package/lib/ast/size.js +0 -448
  69. package/lib/ast/symbol-index.js +0 -399
  70. package/lib/ast/tokenizer.js +0 -421
  71. package/lib/ast/treesitter.js +0 -413
  72. package/lib/audit/analysis-coverage.js +0 -98
  73. package/lib/audit/audit-file.js +0 -205
  74. package/lib/audit/auditignore-rules.js +0 -148
  75. package/lib/audit/checks.js +0 -17
  76. package/lib/audit/client-entry.js +0 -93
  77. package/lib/audit/collector.js +0 -610
  78. package/lib/audit/ext-runner.js +0 -80
  79. package/lib/audit/file-context.js +0 -391
  80. package/lib/audit/finding.js +0 -101
  81. package/lib/audit/gitignore-match.js +0 -113
  82. package/lib/audit/glob.js +0 -63
  83. package/lib/audit/history-report.js +0 -100
  84. package/lib/audit/history.js +0 -126
  85. package/lib/audit/ignore-blind.js +0 -102
  86. package/lib/audit/index.js +0 -33
  87. package/lib/audit/orchestrate.js +0 -672
  88. package/lib/audit/public.js +0 -24
  89. package/lib/audit/repo-level.js +0 -30
  90. package/lib/audit/report-yaml.js +0 -90
  91. package/lib/audit/scope-policy.js +0 -110
  92. package/lib/audit/slot.js +0 -66
  93. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  94. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  95. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  96. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  97. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  98. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  99. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  100. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  101. package/lib/audit-rules/audit-rules-go.yml +0 -103
  102. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  103. package/lib/audit-rules/audit-rules-java.yml +0 -105
  104. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  105. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  106. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  107. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  108. package/lib/audit-rules/audit-rules-php.yml +0 -101
  109. package/lib/audit-rules/audit-rules-private.yml +0 -24
  110. package/lib/audit-rules/audit-rules-python.yml +0 -106
  111. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  112. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  113. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  114. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  115. package/lib/audit-rules/audit-rules-template.yml +0 -108
  116. package/lib/audit-ui-sdk/contract.js +0 -117
  117. package/lib/audit-ui-sdk/index.js +0 -17
  118. package/lib/checks/button-bind.js +0 -347
  119. package/lib/checks/common.js +0 -170
  120. package/lib/checks/credential-file.js +0 -43
  121. package/lib/checks/dataflow.js +0 -40
  122. package/lib/checks/dispatch.js +0 -117
  123. package/lib/checks/dup-code.js +0 -69
  124. package/lib/checks/dup-const.js +0 -232
  125. package/lib/checks/file-health.js +0 -150
  126. package/lib/checks/filter.js +0 -137
  127. package/lib/checks/folder.js +0 -173
  128. package/lib/checks/fs-scanner.js +0 -57
  129. package/lib/checks/hardcoded-path.js +0 -98
  130. package/lib/checks/index.js +0 -49
  131. package/lib/checks/io.js +0 -66
  132. package/lib/checks/magic-number.js +0 -42
  133. package/lib/checks/npm-json.js +0 -273
  134. package/lib/checks/private.js +0 -64
  135. package/lib/checks/regex.js +0 -298
  136. package/lib/checks/scope-collision.js +0 -68
  137. package/lib/checks/semantic.js +0 -134
  138. package/lib/checks/structural.js +0 -281
  139. package/lib/cli/commands-audit.mjs +0 -142
  140. package/lib/cli/commands-doc.mjs +0 -127
  141. package/lib/client-parts/audit/audit.js +0 -301
  142. package/lib/exempt/tool.js +0 -198
  143. package/lib/git/module-splitter.js +0 -47
  144. package/lib/link-check/index.js +0 -187
  145. package/lib/lint-adapter/detect.js +0 -161
  146. package/lib/lint-adapter/index.js +0 -50
  147. package/lib/lint-adapter/runner.js +0 -133
  148. package/lib/rule/compilers/credential.js +0 -62
  149. package/lib/rule/compilers/dataflow.js +0 -38
  150. package/lib/rule/compilers/file-health.js +0 -75
  151. package/lib/rule/compilers/frontend.js +0 -86
  152. package/lib/rule/compilers/func.js +0 -35
  153. package/lib/rule/compilers/helpers.js +0 -71
  154. package/lib/rule/compilers/index.js +0 -29
  155. package/lib/rule/compilers/link-semantic.js +0 -45
  156. package/lib/rule/compilers/list-kinds.js +0 -12
  157. package/lib/rule/compilers/numeric-kinds.js +0 -73
  158. package/lib/rule/compilers/regex.js +0 -78
  159. package/lib/rule/compilers/structure.js +0 -107
  160. package/lib/rule/compilers.js +0 -17
  161. package/lib/rule/homoglyph.js +0 -45
  162. package/lib/rule/loader.js +0 -274
  163. package/lib/rule/registry.js +0 -122
  164. package/lib/rule/scope.js +0 -67
  165. package/lib/score/docs-score.js +0 -166
  166. package/lib/score/index.js +0 -234
  167. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  168. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  169. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  170. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  171. package/scripts/audit-gate.mjs +0 -235
  172. package/scripts/audit-runner.mjs +0 -35
  173. package/scripts/audit-runtime-check.mjs +0 -129
  174. package/scripts/browser-page-probe.mjs +0 -271
  175. package/scripts/check-js-scope.mjs +0 -87
  176. package/scripts/clean-date-comments.py +0 -102
  177. package/scripts/cpu-sample.mjs +0 -188
  178. package/scripts/doc-drift.mjs +0 -200
  179. package/scripts/hot-path-probe-cjs.cjs +0 -71
  180. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  181. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  182. package/scripts/hot-path-probe.mjs +0 -153
  183. package/scripts/module-splitter.py +0 -800
  184. package/scripts/picker-repro.mjs +0 -115
  185. package/scripts/platform-scan.mjs +0 -168
  186. package/scripts/probe-recheck.mjs +0 -47
  187. package/scripts/rename-locator.mjs +0 -97
  188. package/scripts/rule-switch.mjs +0 -97
  189. package/scripts/rules-solo-audit.mjs +0 -173
  190. package/scripts/scan-file-io.mjs +0 -717
  191. package/scripts/scan-fs-hotspots.mjs +0 -107
  192. package/scripts/symbol-index.mjs +0 -85
  193. package/scripts/verify-prestep.mjs +0 -100
  194. package/skills/dev/audit-rule-authoring.md +0 -58
  195. package/skills/guide/guide-audit.md +0 -270
  196. /package/lib/{audit → app}/ownership.js +0 -0
  197. /package/lib/app/{schema-audit.js → schema-preprocess.js} +0 -0
  198. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
@@ -1,49 +0,0 @@
1
- /**
2
- * 检查层 · 统一出口
3
- *
4
- * 分层位置(三层审计架构第三层):
5
- * ① 规则声明 → lib/audit-rules/*.yml
6
- * ② 具体实现 → lib/ast/*(token 级判定)
7
- * ③ 调用包装 → lib/checks/*(本目录,把判定转成 finding)
8
- * ④ 编排调度 → lib/audit/*(收集文件、按 kind 调度、汇总)
9
- *
10
- * 本文件只做再导出。模块划分按「检查对象/机制」:
11
- * common.js 公共设施(豁免提示、severity 封顶、精筛集合取值)
12
- * dispatch.js 调度(runChecks,只写引用、不含逻辑)
13
- * filter.js 规则作用域过滤(exts / exclude_paths)
14
- * regex.js 正则类规则(含 astConfirm 精筛消费)
15
- * structural.js 结构类(函数长度/复杂度/嵌套/文件行数/同步 fs/空 catch)
16
- * semantic.js 语义类(yml 声明的语义检查、patch insert)
17
- * scope-collision.js 拼接产物作用域撞名(多段 JS 共用同一作用域)
18
- * npm-json.js package.json 规范
19
- * folder.js 目录级检查
20
- * credential-file.js 凭据文件
21
- * private.js 私密文件
22
- * button-bind.js 按钮事件绑定交叉比对
23
- * magic-number.js 魔数(薄包装 ast/magic-number.js)
24
- * file-health.js 文件健康度
25
- */
26
-
27
- export { HINT_QUALITY, capSeverity, groupByKind } from './common.js';
28
- export { runChecks } from './dispatch.js';
29
- export { filterRulesByExt, filterRulesByPath, filterRulesByFileText } from './filter.js';
30
- export { checkRegexRules, checkPathRegexRules, checkBlacklist } from './regex.js';
31
- export {
32
- checkFuncLines, checkEmptyCatch, checkMinLength,
33
- checkComplexity, checkDepth, checkMaxLines, checkRepeated,
34
- } from './structural.js';
35
- // I/O 风险分级检查器(取代 checkSyncFsInFile)
36
- export { checkIoRisk } from './io.js';
37
- export { checkSemantic, isRepoLevelSemanticRule, checkPatchInsert } from './semantic.js';
38
- export { checkCredentialFiles } from './credential-file.js';
39
- export { checkNpmJson } from './npm-json.js';
40
- export { checkFolderRules } from './folder.js';
41
- export { checkPrivateFiles } from './private.js';
42
- export { checkButtonBindings } from './button-bind.js';
43
- export { checkMagicNumberSmart } from './magic-number.js';
44
- export { checkFileHealth } from './file-health.js';
45
- export { checkDataflow } from './dataflow.js';
46
- export { checkScopeCollision } from './scope-collision.js';
47
- export { checkDuplicateCode } from './dup-code.js';
48
- export { checkMultiFileScanners } from './fs-scanner.js';
49
- export { checkDuplicateConst, findConstDefs } from './dup-const.js';
package/lib/checks/io.js DELETED
@@ -1,66 +0,0 @@
1
- /**
2
- * dsh-git-push — I/O 风险分级检查器(checks 层,)
3
- *
4
- * 分层:本文件是**薄层**——只负责「调 lib/ast/io-risk.js 的判定 → 转 finding」,
5
- * 不做任何自己的边界识别/上下文判定(那属于 lib/ast 实现层,见 README「正则初筛 → AST 精筛」)。
6
- *
7
- * 取代原 `quality/sync-fs`(checkSyncFsInFile):旧检查只判 `inAsync`,
8
- * 本检查是它的**超集**——同样覆盖「异步路径中的同步 I/O」,另加循环内、
9
- * 请求路径、启动路径三种上下文,以及读/写/删/改名四类操作。
10
- * 两者并存会对同一处 I/O 重复报,故旧规则一并移除。
11
- *
12
- * 分级 → 严重度:一律 warning(只提示不拦提交),风险高低体现在 message 徽标与描述中。
13
- */
14
- import { scanIoRiskAst, RISK_BADGE, RISK_LABEL } from '../ast/io-risk.js';
15
- import { makeFinding } from '../audit/index.js';
16
-
17
- /** 豁免说明:复用 quality 标记(同为「性能/质量」类豁免)。 */
18
- const HINT_IO = 'dsh-skip-quality(文件头=整文件;启动阶段一次性读取可豁免)';
19
-
20
- /**
21
- * 扫描单个文件的 I/O 调用并按四级风险转 findings。
22
- *
23
- * @param {{file:string, text:string}} ctx 文件路径与全文
24
- * @returns {Array} findings(按行号升序)
25
- */
26
- export function checkIoRisk({ file, text }) {
27
- const findings = [];
28
- let hits = [];
29
- try {
30
- hits = scanIoRiskAst(text);
31
- } catch {
32
- return findings; // 单文件解析异常不影响整体审计
33
- }
34
-
35
- for (const hit of hits) {
36
- const badge = RISK_BADGE[hit.risk] || '·';
37
- const label = RISK_LABEL[hit.risk] || hit.risk;
38
- // 上下文串:只列出成立的项,便于一眼看懂为什么是这个级别
39
- const ctxs = [];
40
- if (hit.inAsync) ctxs.push('异步路径');
41
- if (hit.inLoop) ctxs.push('循环内');
42
- if (hit.inRequest) ctxs.push('请求路径');
43
- if (hit.inStartup) ctxs.push('启动路径');
44
- const ctxText = ctxs.length ? ctxs.join('+') : '未知上下文';
45
-
46
- // 低风险(启动路径上的一次性同步 I/O,如模块顶层/apply() 里读一次配置)
47
- // 性质上是**提示**而非缺陷:它不影响并发、不随数据量放大,改动收益通常不抵成本。
48
- // 此前一律按 warning 计 1 分,导致 173 条 io-risk 里 161 条纯提示持续拉低
49
- // 「健壮性/性能」两维得分,真实高危(high/medium)被淹没在噪声里。
50
- // 现降为 info + scoreImpact 0:照常展示(含上下文与原因),但不计入评分维度
51
- // ——与 score/index.js 既有约定一致(scoreImpact===0 的纯提醒不拉低质量分)。
52
- const isActionable = hit.risk === 'high' || hit.risk === 'medium';
53
- findings.push(makeFinding({
54
- file,
55
- line: hit.line,
56
- rule: 'robustness/io-risk',
57
- kind: 'io-risk',
58
- severity: isActionable ? 'warning' : 'info',
59
- message: `${badge} ${label}风险:${hit.call}(${hit.type}/${hit.kind},${ctxText})——${hit.reason}`,
60
- dimensions: ['性能', '健壮性'],
61
- exemptHint: HINT_IO,
62
- scoreImpact: isActionable ? (hit.risk === 'high' ? 2 : 1) : 0,
63
- }));
64
- }
65
- return findings;
66
- }
@@ -1,42 +0,0 @@
1
- /**
2
- * 检查层 · 硬编码魔数
3
- *
4
- * 职责:薄包装 lib/ast/magic-number.js 的 token 级判定,转成 finding。
5
- */
6
-
7
- import { makeFinding } from '../audit/index.js';
8
- import { checkMagicNumberSmartAst } from '../ast/index.js';
9
- import { isModuleConstAssignment } from '../ast/scope.js';
10
- import { HINT_QUALITY } from './common.js';
11
-
12
- /* ───────────────────────── 硬编码魔数检测(kind=magic-number-smart,实现见 lib/ast/magic-number.js) ───────────────────────── */
13
-
14
- /**
15
- * 硬编码魔数检测(薄包装):具体实现在 lib/ast/magic-number.js 的 checkMagicNumberSmartAst(token 级),
16
- * 本函数只把命中结果转成统一 finding 对象。
17
- *
18
- * 规则声明在 lib/audit-rules/audit-rules-nodejs.yml(readability/magic-number-smart)。
19
- * token 级实现从根上区分「代码里的数字字面量」与「注释/字符串里的数字」——
20
- * 注释版本号(// v1.8.0)、CSS 字号、i18n 字典值不再误报,无需任何「跳过行」补丁。
21
- */
22
- export function checkMagicNumberSmart({ file, text, rules }) {
23
- const findings = [];
24
- const rule = (rules || [])[0];
25
- if (!rule) return findings;
26
- const opts = {
27
- magicHints: rule.magicHints,
28
- legitHints: rule.legitHints,
29
- forceCount: rule.forceCount,
30
- };
31
- for (const hit of checkMagicNumberSmartAst(text, opts)) {
32
- // 作用域豁免(方案最小实验):模块顶层 `const MAX_RETRY = 3` 类命名常量不报魔数
33
- if (isModuleConstAssignment(text, hit.line)) continue;
34
- findings.push(makeFinding({
35
- file, line: hit.line, rule: rule.id || 'readability/magic-number-smart', kind: 'magic-number-smart',
36
- severity: rule.severity || 'warning',
37
- message: `硬编码魔数「${hit.raw}」(${hit.count >= (rule.forceCount || 3) ? `文件内出现 ${hit.count} 次,疑似魔数` : '出现在 timeout/limit/size 等数值上下文'})——建议提取为命名常量并注释含义;版本号/日期/HTTP 状态码/常见合法常量/注释与字符串内数字自动豁免`,
38
- dimensions: rule.dimensions || ['可维护性'], exemptHint: 'dsh-skip-quality(文件头=整文件)', scoreImpact: 0, // 魔数为「建议提取常量」提示(info 级语义),不扣分——避免配置值(timeout/limit/size)全项目性误扣
39
- }));
40
- }
41
- return findings;
42
- }
@@ -1,273 +0,0 @@
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
- }
@@ -1,64 +0,0 @@
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
- import { GIT_GLOBAL_ARGS } from '../core/exec.js';
13
-
14
- /* ───────── 私密检查常量 ───────── */
15
- const LS_FILES_TIMEOUT_MS = 10000; // git ls-files 超时
16
-
17
- /**
18
- * 私密文件拦截检查(private 槽位,1.0.4,T1-T33 考古验收)。
19
- * git ls-files 列全部跟踪文件 × private_files glob 匹配,按远端可见性分级:
20
- * visibility=public → blocker(私钥/凭据已可被任何人获取,禁止推送)
21
- * visibility=private|unknown → warning(私有边界内仅提醒,转公开前须先移除)
22
- * @param {object} p { root, visibility, privateFiles[] } visibility: 'public'|'private'|'unknown'
23
- * @returns {Array} findings
24
- */
25
- export function checkPrivateFiles({ root, visibility = 'unknown', privateFiles = [] }) {
26
- const findings = [];
27
- if (!root || !Array.isArray(privateFiles) || privateFiles.length === 0) return findings;
28
- let tracked;
29
- try {
30
- // 显式捕获 stderr——execFileSync 未设 stdio 时异常会把子进程 stderr 直通父进程
31
- // (非 git 目录跑 git ls-files 会打印「致命错误:不是 git 仓库」污染 audit --json 输出)
32
- const out = execFileSync('git', [...GIT_GLOBAL_ARGS, 'ls-files'], { cwd: root, encoding: 'utf8', timeout: LS_FILES_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'pipe'] });
33
- tracked = out.split('\n').filter(Boolean);
34
- } catch (e) { /* 非 git 仓库 / git 不可用 → 跳过 */
35
- if (String(e?.stderr || '').trim()) { /* stderr 已捕获,静默 */ }
36
- return findings;
37
- }
38
- if (!tracked.length) return findings;
39
- const compiled = privateFiles
40
- .map((g) => ({ glob: g, re: globToRegex(g) }))
41
- .filter((x) => x.re);
42
- const hits = [];
43
- for (const p of tracked) {
44
- for (const pf of compiled) {
45
- if (pf.re.test(p)) { hits.push(p); break; }
46
- }
47
- }
48
- if (!hits.length) return findings;
49
- const publicGate = visibility === 'public';
50
- for (const p of hits) {
51
- findings.push(makeFinding({
52
- file: p, line: 1, rule: publicGate ? 'private-file-public' : 'private-file-in-repo',
53
- kind: 'private-files',
54
- severity: publicGate ? 'blocker' : 'warning',
55
- message: publicGate
56
- ? `仓库跟踪私密文件 ${p} 且远端公开(public)——私钥/凭据已可被任何人获取,禁止推送;请移除该文件或转为私有仓库`
57
- : `仓库跟踪私密文件 ${p}(远端 ${visibility === 'private' ? '私有' : '未确认'});私有边界内仅提醒,若未来转公开请先移除`,
58
- dimensions: ['安全性', '可部署性'],
59
- exemptHint: 'dsh-skip-sensitive(文件头=整文件)',
60
- scoreImpact: publicGate ? 1 : 0,
61
- }));
62
- }
63
- return findings;
64
- }