dsh-git-push 2.14.0 → 2.14.1

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.
@@ -17,22 +17,90 @@ const FUNC_START_SCAN_BACK = 60; // 向上找函数起点的最大行数
17
17
  * @returns {boolean} true=同一函数内已建目录(应豁免)
18
18
  */
19
19
  export function hasMkdirInSameFunction(lines, lineIdx) {
20
- const MKDIR_RE = /mkdir(Sync)?\s*\(|ensureDataDir\s*\(|recursive:\s*true/;
21
- const FUNC_START_RE = /(function|=>)\s*\{|\)\s*(async\s*)?\{/;
22
- // 向上找函数起点(最多 60 行),命中即记下作用域起点
23
- let scopeStart = 0;
24
- for (let i = Math.max(0, lineIdx - FUNC_START_SCAN_BACK); i < lineIdx; i++) {
25
- if (FUNC_START_RE.test(String(lines[i] || ''))) scopeStart = i;
26
- }
27
- // 向后找闭括号粗略平衡点(保守取 20 行),期间出现 mkdir 即豁免
28
- const scopeEnd = Math.min(lines.length, lineIdx + MK_DIR_SCOPE_LOOKAHEAD);
29
- for (let i = scopeStart; i < scopeEnd; i++) {
20
+ // mkdir 语义家族:字面量之外还要认**常见封装命名**。
21
+ // 实测(2026-11-01 外部会话逐行样本):`ensureDir(path.dirname(file))` 就在写语句**上一行**,
22
+ // 但旧正则只认 `mkdir(Sync)?(` / `ensureDataDir(`,于是把「先建目录再写」报成 ENOENT 风险。
23
+ const MKDIR_CALL_RE = new RegExp(
24
+ '\\b(?:mkdir|mkdirSync|mkdirp|mkdtemp|mkdtempSync|ensure[A-Za-z0-9_]*Dir|ensureDir[A-Za-z0-9_]*)' +
25
+ '\\s*\\(|recursive\\s*:\\s*true',
26
+ );
27
+ const { start, end } = functionScope(lines, lineIdx);
28
+ // ① 同一函数体内出现 mkdir 家族调用
29
+ for (let i = start; i <= end && i < lines.length; i++) {
30
30
  if (i === lineIdx) continue;
31
- if (MKDIR_RE.test(String(lines[i] || ''))) return true;
31
+ if (MKDIR_CALL_RE.test(String(lines[i] || ''))) return true;
32
+ }
33
+ // ② 一层间接:本文件里定义的 helper,其函数体含 mkdir ⇒ 调用它等同已建目录
34
+ // (样本:atomic-json.mjs 的 ensureDir 是**同模块导出**,调用点自然没有 mkdir 字面量)
35
+ for (const name of mkdirHelperNames(lines)) {
36
+ const callRe = new RegExp(`\\b${name}\\s*\\(`);
37
+ for (let i = start; i <= end && i < lines.length; i++) {
38
+ if (i === lineIdx) continue;
39
+ if (callRe.test(String(lines[i] || ''))) return true;
40
+ }
32
41
  }
33
42
  return false;
34
43
  }
35
44
 
45
+ /** 向上找最近的函数起点,再按花括号配平取函数体范围(含跨 70+ 行的远距离 mkdir)。 */
46
+ function functionScope(lines, lineIdx) {
47
+ // 函数起点的四种常见形态都要认(漏一种就会把作用域退化成整文件,
48
+ // 进而把「别的函数里的 mkdir」当成本函数的 ⇒ 真问题被洗掉):
49
+ // export function name(...) { / function name(...) {
50
+ // const name = (...) => { / 方法简写 name(...) {
51
+ // 同时排除 if/for/while/switch/catch 这类不是函数的块。
52
+ const NOT_FUNC_KW = '(?!(?:if|for|while|switch|catch|do|else|try)\\b)';
53
+ const FUNC_START_RE = new RegExp(
54
+ `(?:${NOT_FUNC_KW}(?:export\\s+)?(?:async\\s+)?function\\s+[A-Za-z_$][\\w$]*\\s*\\([^)]*\\)\\s*\\{` +
55
+ `|${NOT_FUNC_KW}(?:export\\s+)?(?:async\\s+)?[A-Za-z_$][\\w$]*\\s*\\([^)]*\\)\\s*\\{` +
56
+ '|=>\\s*\\{)',
57
+ );
58
+ let start = 0;
59
+ for (let i = lineIdx; i >= 0 && i >= lineIdx - 400; i--) {
60
+ if (FUNC_START_RE.test(String(lines[i] || ''))) { start = i; break; }
61
+ }
62
+ let depth = 0;
63
+ let started = false;
64
+ let end = Math.min(lines.length - 1, start + 400);
65
+ for (let i = start; i < lines.length; i++) {
66
+ const text = String(lines[i] || '');
67
+ for (const ch of text) {
68
+ if (ch === '{') { depth += 1; started = true; }
69
+ else if (ch === '}') {
70
+ depth -= 1;
71
+ if (started && depth <= 0) { end = i; break; }
72
+ }
73
+ }
74
+ if (started && depth <= 0) { end = i; break; }
75
+ }
76
+ return { start, end: Math.max(start, end) };
77
+ }
78
+
79
+ /** 收集「函数体里含 mkdir 家族调用」的本文件函数名(一层间接判定用)。 */
80
+ function mkdirHelperNames(lines) {
81
+ const names = new Set();
82
+ const DEF_RES = [
83
+ /(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/g,
84
+ /(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*=\s*(?:async\s*)?(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>/g,
85
+ ];
86
+ const MKDIR_DEF_RE = /\b(?:mkdir|mkdirSync|mkdirp|mkdtemp|mkdtempSync)\s*\(/;
87
+ for (let i = 0; i < lines.length; i++) {
88
+ const text = String(lines[i] || '');
89
+ for (const re of DEF_RES) {
90
+ re.lastIndex = 0;
91
+ const m = re.exec(text);
92
+ if (!m) continue;
93
+ const { end } = functionScope(lines, i);
94
+ let has = false;
95
+ for (let k = i; k <= end && k < lines.length; k++) {
96
+ if (MKDIR_DEF_RE.test(String(lines[k] || ''))) { has = true; break; }
97
+ }
98
+ if (has) names.add(m[1]);
99
+ }
100
+ }
101
+ return names;
102
+ }
103
+
36
104
  /**
37
105
  * 写目标是否「来自调用方」——若是,则目录创建责任不在本函数,mkdir-before-write 应豁免。
38
106
  *
@@ -13,7 +13,11 @@ rules:
13
13
  name: "写文件前必须确保目录存在"
14
14
  category: "robustness"
15
15
  severity: "warning"
16
- description: "直接 writeFile 而不 mkdir 父目录,会导致 ENOENT 错误"
16
+ description: "本函数体内未见 mkdir/ensureDir 类建目录调用就往目标路径写文件——若目录由自定义辅助函数或调用方准备,请确认后忽略"
17
+ # 措辞刻意**不断言「代码有 bug」**:判定是静态的,认不出的形态(跨文件 helper、动态目录、
18
+ # 由调用方保证的目录)都会落在这里。写成断言式会让人以为代码真错了(外部会话反馈第 3 点)。
19
+ # 同函数体的 mkdir / ensure*Dir / mkdirp / mkdtemp,以及**本文件内**「函数体含 mkdir」的
20
+ # helper 调用,都会被判为已建目录(见 lib/audit/file-context.js 的 hasMkdirInSameFunction)。
17
21
  # 正则初筛 → token 级精筛(makeCodeLineFilter):剔除注释与字符串里的调用示例。
18
22
  # 本规则是纯 regex,此前会把**说明本规则自身的文档**也命中——实测
19
23
  # lib/checks/common.js 的 JSDoc(「会把注释/字符串里的 `fs.writeFile(...)`
package/lib/self/index.js CHANGED
@@ -9,7 +9,7 @@
9
9
  */
10
10
 
11
11
 
12
- export const VERSION = '2.14.0'; // 2.14.0:.auditignore 支持**细粒度豁免**(路径 : 规则),并可把豁免做成「已确认豁免」可见通道;另有注释内命中治理。历史:2.13.4 镜像候选清单与分批测试。
12
+ export const VERSION = '2.14.1'; // 2.14.1:mkdir-before-write 认得出封装与一层间接。旧判定只认 mkdir(Sync)( / ensureDataDir( 字面量,且扫描窗口仅 ±20/60 行——实测对「写语句上一行就是 ensureDir(...),而 ensureDir 函数体里有 mkdirSync」的写法仍报 ENOENT 风险。现改为:识别 mkdir 家族命名(ensure*Dir / mkdirp / mkdtemp)、识别**本文件内**函数体含 mkdir 的 helper 调用(一层间接,不做跨文件)、作用域按花括号配平取**整个外层函数体**(远距离 70+ 行也覆盖),并补全 export function 形态的函数起点识别。措辞同时软化:不再断言「写前未建目录」,改为提示确认。历史:2.14.0 .auditignore 细粒度豁免。
13
13
  // 实测后果:该目录有 package.json ⇒ npm 去打包整棵 DSH 树、输出 2.1MB > spawnSync 默认 maxBuffer 1MB ⇒ ENOBUFS(npm_publish 的体检与真发全部失败);
14
14
  // 该目录没有 package.json 时报 ENOENT。现 publish 的两个调用点显式传 cwd=目标包目录,并给 runNpm 加 16MB maxBuffer。
15
15
  // 2.8.3:文案修正——「零改动 / 无新提交」明确为**正常成功路径**(注入用法、工具描述、README、skill 同批改),并修 job 输出自相矛盾(cleanSkipCommit 路径补 committed:false,不再显示「已提交,未推送」)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-git-push",
3
- "version": "2.14.0",
3
+ "version": "2.14.1",
4
4
  "description": "DSH git 自动提交推送插件——统一函数入口架构(规则/审计/git/自身/侧边栏/评分/豁免/上下文/HTTP/测试十大总入口)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",