fix(compose): repairWithLLM 失败时给出明确日志，加 1 项跨 step 同名变量边界测试

深挖 0.6.10 的修复链发现两个细节问题：

1. repairWithLLM 失败时 catch 静默吞错。LLM 因网络/认证/超时失败时只返回
   { ok: false }，调用方继续走，最终用户看到 "LLM 修复后仍有 X 个变量未解决"
   会以为 LLM 修了但不够，实际根本没调通。改为在 stderr 写明失败原因
2. 跨 step 同名 bad var 的已知 limitation: 第一个 step 把 {{review}}
   全局 replace 后，第二个 step 即使上游不含该 output 也会被改。这是 autoFix
   按 step 处理但用全局正则 replace 的折衷。新增针对性测试明确这个行为，
   留给 LLM repair 兜底

Author: jnMetaCode

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 本项目采用 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.6.11] - 2026-04-27
+
+### Fixed
+- `repairWithLLM` 失败时静默吞错。LLM 调用因网络/认证/超时失败时不再悄悄返回，会在 stderr 给出失败原因，避免用户看到 "LLM 修复后仍有 X 个变量未解决" 误以为 LLM 修了但不够，实际是根本没调通
+
+### Tests
+- 新增 1 项测试覆盖跨 step 同名 bad var 的已知边界行为（全局 replace 只处理一次，靠 LLM repair 兜底）
+
 ## [0.6.10] - 2026-04-27
 
 ### Fixed

src/cli/compose.ts

@@ -773,11 +773,14 @@ inputs: ${inputNames.length > 0 ? inputNames.join('、') : '（无）'}
     });
     const fixedYaml = extractYamlFromResponse(result.content);
     if (!fixedYaml || !fixedYaml.includes('steps:')) {
+      process.stderr.write('  ⚠️  LLM 二次修复返回的内容不是有效 YAML，保留原文件\n');
       return { ok: false, replaced: false };
     }
     writeFileSync(yamlPath, fixedYaml + '\n', 'utf-8');
     return { ok: true, replaced: true };
-  } catch {
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`  ⚠️  LLM 二次修复调用失败: ${msg.slice(0, 120)}\n`);
     return { ok: false, replaced: false };
   }
 }

test/compose.ts

@@ -348,6 +348,44 @@ steps:
   assert(r.fixed === 0, `没有上游应不修，实际 ${r.fixed}`);
 });
 
+await test('autoFix: 跨 step 同名 bad var 只全局处理一次（已知 limitation）', async () => {
+  // 边角 case：两个 step 都引用 {{review}}，但上游不同。
+  // 当前实现用全局 replace + globallyHandled，所以两个 step 的 {{review}} 都
+  // 被改成同一个 output（第一个匹配到的）。这在罕见的"同名变量不同语义"场景
+  // 下会让第二个 step 出现新的未定义变量，留给 LLM repair 兜底。
+  const p = makeYamlFile(validYamlBase + `
+steps:
+  - id: a_step
+    role: engineering/engineering-sre
+    task: "A"
+    output: data_a
+
+  - id: b_step
+    role: engineering/engineering-sre
+    task: "B"
+    output: data_b
+
+  - id: review_a
+    role: engineering/engineering-sre
+    task: "review {{review}}"
+    output: review_a_out
+    depends_on: [a_step]
+
+  - id: review_b
+    role: engineering/engineering-sre
+    task: "review {{review}}"
+    output: review_b_out
+    depends_on: [b_step]
+`);
+  const r = await autoFixVariableRefs(p);
+  // 期望：第一个 step (review_a) 把 {{review}} → {{data_a}}（上游唯一 output）
+  // 第二个 step (review_b) 的 {{review}} 也被全局 replace 改成 data_a
+  // 但 review_b 的上游是 b_step，data_a 不在它的 depends_on 闭包里
+  // 这是已知 limitation，由 LLM repair 兜底。autoFix 自身只确保不指向"下游"
+  assert(r.fixed === 1, `应仅记录 1 次替换（全局），实际 ${r.fixed}`);
+  assert(r.details[0].from === 'review', `期望 from=review，实际 ${r.details[0].from}`);
+});
+
 // ─── 汇总 ───
 console.log(`\n  结果: ${passed} 通过, ${failed} 失败\n`);
 if (failed > 0) process.exit(1);