dsh-git-push 2.14.1 → 2.14.2

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.
@@ -1,5 +1,6 @@
1
1
  import { runChecks } from './checks.js';
2
2
  import { exemptForFinding } from '../exempt/index.js';
3
+ import { isBestEffortWrite } from './file-context.js';
3
4
  import { hasExternalCallTimeout, hasMkdirInSameFunction, hasForeignWriteTarget } from './file-context.js';
4
5
  import { CODE_EXTS } from './finding.js';
5
6
  import { privacyRulesEnabled, isPrivacyRule } from './ownership.js';
@@ -186,6 +187,12 @@ export function auditFile({ file, relPath, text, grouped }, opts = {}) {
186
187
  const idx = Math.max(0, (Number(f.line) || 1) - 1);
187
188
  if (hasMkdirInSameFunction(fileLines, idx)) return false;
188
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
+ }
189
196
  }
190
197
  // loader 契约语义豁免:已按统一 ModuleLoader 契约注册
191
198
  if (f.rule === 'dsh/client-module-loader-id' && hasLoaderContract) return false;
@@ -24,19 +24,96 @@ export function hasMkdirInSameFunction(lines, lineIdx) {
24
24
  '\\b(?:mkdir|mkdirSync|mkdirp|mkdtemp|mkdtempSync|ensure[A-Za-z0-9_]*Dir|ensureDir[A-Za-z0-9_]*)' +
25
25
  '\\s*\\(|recursive\\s*:\\s*true',
26
26
  );
27
- const { start, end } = functionScope(lines, lineIdx);
28
- // ① 同一函数体内出现 mkdir 家族调用
29
- for (let i = start; i <= end && i < lines.length; i++) {
30
- if (i === lineIdx) continue;
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*\\(`);
27
+ // 逐层向外找(最多 3 层):写语句常在**嵌套回调/循环体**里,而目录由外层函数建好——
28
+ // 嵌套体在定义时就处于外层函数体内,外层先执行 mkdir、再调用写在里面的回调,
29
+ // 目录此时必然已存在(实测:diag-upload 的 mkdir 在 128 行、写在 199 行的回调里;
30
+ // export-bundle 的 mkdir 在 186/207 行、写在 237 行)。
31
+ const helpers = mkdirHelperNames(lines);
32
+ for (const { start, end } of enclosingScopes(lines, lineIdx)) {
37
33
  for (let i = start; i <= end && i < lines.length; i++) {
38
34
  if (i === lineIdx) continue;
39
- if (callRe.test(String(lines[i] || ''))) return true;
35
+ if (MKDIR_CALL_RE.test(String(lines[i] || ''))) return true;
36
+ }
37
+ // 一层间接:本文件里定义的 helper,其函数体含 mkdir ⇒ 调用它等同已建目录
38
+ // (样本:write-result.mjs 的 ensureDir 是**同文件私有函数**,调用点没有 mkdir 字面量)
39
+ for (const name of helpers) {
40
+ const callRe = new RegExp(`\\b${name}\\s*\\(`);
41
+ for (let i = start; i <= end && i < lines.length; i++) {
42
+ if (i === lineIdx) continue;
43
+ if (callRe.test(String(lines[i] || ''))) return true;
44
+ }
45
+ }
46
+ }
47
+ return false;
48
+ }
49
+
50
+ /**
51
+ * 由内向外列出命中所处的作用域(最多 3 层)。
52
+ * 为什么要多层:写语句常落在 `files.forEach(() => { … })`、`for { … }` 这类嵌套体里,
53
+ * 而 mkdir 在外层函数里——只看最内层会把「外层早已建好目录」误判成没建。
54
+ */
55
+ function enclosingScopes(lines, lineIdx) {
56
+ const out = [functionScope(lines, lineIdx)];
57
+ // 再并上「包含写语句的**顶层函数**」:写语句经常落在嵌套回调/循环体里,
58
+ // 而 mkdir 由外层函数建好——两层一起看才覆盖得住(逐层推断父块容易跳到兄弟块,
59
+ // 实测会把 diag-upload 的链走歪到无关块)。顶层函数超过 400 行时只取前 400 行。
60
+ const top = topLevelFunctionScope(lines, lineIdx);
61
+ if (top && top.start !== out[0].start) out.push(top);
62
+ return out;
63
+ }
64
+
65
+ /**
66
+ * 包含该行的顶层函数范围(列 0 起笔的 `function` / `const f = (...) =>`)。
67
+ * Node 服务的模块基本都这么写;取不到时返回 null(退化为只看内层作用域)。
68
+ */
69
+ function topLevelFunctionScope(lines, lineIdx) {
70
+ const TOP_RE = /^(?:export\s+)?(?:async\s+)?(?:function\s+[A-Za-z_$][\w$]*\s*\(|const\s+[A-Za-z_$][\w$]*\s*=\s*(?:async\s*)?\()/;
71
+ let start = -1;
72
+ for (let i = lineIdx; i >= 0 && i >= lineIdx - 600; i--) {
73
+ if (TOP_RE.test(String(lines[i] || ''))) { start = i; break; }
74
+ }
75
+ if (start < 0) return null;
76
+ let depth = 0;
77
+ let started = false;
78
+ let end = Math.min(lines.length - 1, start + 400);
79
+ for (let i = start; i < lines.length; i++) {
80
+ let text = stripBracesNoise(String(lines[i] || ''));
81
+ if (i === start) {
82
+ const lastOpen = text.lastIndexOf('{');
83
+ if (lastOpen >= 0) text = text.slice(lastOpen);
84
+ }
85
+ for (const ch of text) {
86
+ if (ch === '{') { depth += 1; started = true; }
87
+ else if (ch === '}') { depth -= 1; if (started && depth <= 0) { end = i; break; } }
88
+ }
89
+ if (started && depth <= 0) { end = i; break; }
90
+ }
91
+ return { start, end: Math.max(start, end) };
92
+ }
93
+
94
+ /**
95
+ * 写语句是否在「try { … } catch { /* 非关键 *\/ }」里 —— 即 best-effort 写入。
96
+ * 这类写入失败通常只影响附属信息(如 LRU 时间戳),按 warning 报会淹没有效信号;
97
+ * 调用方据此把它降级为提示(仍可见、仍可追踪,只是不当作缺陷)。
98
+ */
99
+ export function isBestEffortWrite(lines, lineIdx) {
100
+ // 精确判定:反向扫描找到**包裹本行的最近一层块**,看它的开括号是不是 `try {`。
101
+ // 早先写法(往回 40 行找 try、再往后 40 行找 catch)太松:同一函数里别处的 try/catch
102
+ // 也会命中,把正常写入误判成 best-effort(实测 config/spine 的被误判)。
103
+ let depth = 0;
104
+ for (let i = lineIdx; i >= 0 && i >= lineIdx - 200; i--) {
105
+ const text = stripBracesNoise(String(lines[i] || ''));
106
+ for (let k = text.length - 1; k >= 0; k--) {
107
+ const ch = text[k];
108
+ if (ch === '}') depth += 1;
109
+ else if (ch === '{') {
110
+ depth -= 1;
111
+ if (depth < 0) {
112
+ const head = text.slice(0, k).trim();
113
+ if (/\btry$/.test(head)) return true; // 最近的块就是 try 块
114
+ return false; // 最近的块不是 try(if/for/函数体…)
115
+ }
116
+ }
40
117
  }
41
118
  }
42
119
  return false;
@@ -44,15 +121,15 @@ export function hasMkdirInSameFunction(lines, lineIdx) {
44
121
 
45
122
  /** 向上找最近的函数起点,再按花括号配平取函数体范围(含跨 70+ 行的远距离 mkdir)。 */
46
123
  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)';
124
+ // 函数起点识别:**必须带词边界**,否则 `if (!x) {` 会从第二个字符 `f (!x) {` 被当成函数起点、
125
+ // `} catch (e) {` 会从 `atch (e) {` 被匹配 —— 作用域一步错,后面全盘错(实测:
126
+ // ModelStage config.mjs 的作用域被算成 82..89,而写语句在 93 行,mkdir 就在上一行也看不见)。
127
+ // 同理数括号前要先剔除字符串/注释里的花括号,否则 `'{'`、`// }` 会把配平带偏。
128
+ const NOT_FUNC_KW = '(?!(?:if|for|while|switch|catch|do|else|try|return|typeof|new)\\b)';
129
+ const BOUNDARY = '(?:^|[^\\w$])';
53
130
  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*\\{` +
131
+ `(?:${BOUNDARY}(?:export\\s+)?(?:async\\s+)?function\\s*\\*?\\s*[A-Za-z_$][\\w$]*\\s*\\([^)]*\\)\\s*\\{` +
132
+ `|${BOUNDARY}${NOT_FUNC_KW}[A-Za-z_$][\\w$]*\\s*\\([^)]*\\)\\s*\\{` +
56
133
  '|=>\\s*\\{)',
57
134
  );
58
135
  let start = 0;
@@ -63,7 +140,14 @@ function functionScope(lines, lineIdx) {
63
140
  let started = false;
64
141
  let end = Math.min(lines.length - 1, start + 400);
65
142
  for (let i = start; i < lines.length; i++) {
66
- const text = String(lines[i] || '');
143
+ let text = stripBracesNoise(String(lines[i] || ''));
144
+ // 起点行只从**函数体开括号**(该行最后一个 `{`)开始算深度:
145
+ // 否则解构参数 `function f({ a, b }) {` 里的那对花括号会把深度配平到 0,
146
+ // 作用域当场就"结束"在本行(实测:writeResult 的作用域被算成 31..31,整段函数体全在范围外)。
147
+ if (i === start) {
148
+ const lastOpen = text.lastIndexOf('{');
149
+ if (lastOpen >= 0) text = text.slice(lastOpen);
150
+ }
67
151
  for (const ch of text) {
68
152
  if (ch === '{') { depth += 1; started = true; }
69
153
  else if (ch === '}') {
@@ -76,6 +160,18 @@ function functionScope(lines, lineIdx) {
76
160
  return { start, end: Math.max(start, end) };
77
161
  }
78
162
 
163
+ /**
164
+ * 数花括号前剔除「字符串/注释里的花括号」——否则 `const a = '{'`、`// }` 会把配平带偏,
165
+ * 作用域提前结束(实测:写语句落在作用域之外 ⇒ mkdir 就在上一行也判不出)。
166
+ */
167
+ function stripBracesNoise(line) {
168
+ return String(line)
169
+ .replace(/\/\/.*$/, '')
170
+ .replace(/'(?:\\.|[^'\\])*'/g, "''")
171
+ .replace(/"(?:\\.|[^"\\])*"/g, '""')
172
+ .replace(/`(?:\\.|[^`\\])*`/g, '``');
173
+ }
174
+
79
175
  /** 收集「函数体里含 mkdir 家族调用」的本文件函数名(一层间接判定用)。 */
80
176
  function mkdirHelperNames(lines) {
81
177
  const names = new Set();
package/lib/self/index.js CHANGED
@@ -9,7 +9,7 @@
9
9
  */
10
10
 
11
11
 
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 细粒度豁免。
12
+ export const VERSION = '2.14.2'; // 2.14.2:mkdir-before-write 的作用域判定修正(外部复测 16→21 的净增根因)。三处硬伤:①「非函数关键字」负向前瞻没加词边界,`if (!x) {` 会从第二个字符 `f (!x) {` 被当成函数起点、`} catch (e) {` 会从 `atch (e) {` 被匹配 ⇒ 作用域一步错全盘错;②数花括号前没剔除字符串/注释里的括号,配平被带偏;③解构参数 `function f({ a, b }) {` 的花括号把深度配平到 0 ⇒ 作用域结束在本行。另加:作用域并入「包含写语句的顶层函数」(写语句常在嵌套回调里),以及 best-effort 写入(try 内 + catch 兜底)降级为提示。实测 ModelStage:21 条 → 1 条(剩余那条 mkdir 在另一个顶层函数里,跨函数静态证明不了)。历史:2.14.1 认封装与一层间接。
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.1",
3
+ "version": "2.14.2",
4
4
  "description": "DSH git 自动提交推送插件——统一函数入口架构(规则/审计/git/自身/侧边栏/评分/豁免/上下文/HTTP/测试十大总入口)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",