OOM: customCommand called inside multiline function causes unbounded memory allocation

[Haoxincode]

Summary

当 customCommands 启用时，在多行函数定义的函数体内调用自定义命令（如 argv.py）会导致 MoonBit 引擎无限分配内存，最终 V8 进程 OOM 崩溃。

最小复现

import { Bash } from "./src/wrapper/index.ts";

const argvCommand = {
  name: "argv.py",
  run: async (args) => ({
    stdout: `[${args.map(a => `'${a}'`).join(", ")}]\n`,
    stderr: "",
    exitCode: 0,
  }),
};

const env = new Bash({ customCommands: [argvCommand] });

// OOM! 单个命令就会导致 V8 耗尽 4GB 堆后崩溃
await env.exec(`fun () {
  argv.py "$@" "$*"
}
fun "a b" "c d"`);

三个必要条件（缺一不可）

条件	去掉后
customCommands 启用	正常
多行函数定义（fun () {\n...\n}）	正常（单行 fun() { ...; } 不爆）
函数体内调用自定义命令	正常（函数体内调用内建命令如 echo 不爆）

对测试的影响

这是 spec bash 和 spec jq 测试套件 OOM 的根本原因。这些测试使用 customCommands（如 argv.py、printenv.py）且测试脚本包含多行函数定义。修复此 bug 后，spec 测试套件应该能在本地 4GB 堆内正常运行。

可能的根因方向

MoonBit 解释器在函数作用域内查找/执行自定义命令（custom command bridge）时，可能存在递归展开或循环引用，导致内存无限增长。建议从 interpreter 模块的函数调用 + customCommand dispatch 路径排查。

环境

• MoonBash main 分支
• Node.js v24, V8 heap 4096MB
• 16GB RAM 机器上 100% 复现

[Haoxincode]

根因更正：JS wrapper 无限递归，非 MoonBit 引擎问题

经进一步排查，OOM 的主因不在 MoonBit interpreter 的序列化开销，而在 TS wrapper 的 custom-command 快速路径递归。

触发链路

1. exec(script) 进入 src/wrapper/index.ts:2354，检查 hasCustomCommands() 和 scriptReferencesCustomCommand(script)
2. scriptReferencesCustomCommand() 只做字符串包含匹配（src/wrapper/index.ts:1261），只要脚本文本中出现 custom command 名称（如 argv.py）就返回 true
3. 进入 tryExecuteWithCustomCommands()（src/wrapper/index.ts:1272）
4. splitSimplePipeline() 解析 segments
5. 对每个 segment，如果不是 custom command（如 echo），走到 this.exec(segment, ...)（src/wrapper/index.ts:1326）
6. this.exec() 回到步骤 1，scriptReferencesCustomCommand("echo argv.py") 仍然返回 true → 无限递归

更小的复现

const env = new Bash({ customCommands: [argvCommand] });
// OOM! echo 不是 custom command，但 scriptReferencesCustomCommand 匹配到了 "argv.py"
await env.exec("echo argv.py");

这说明问题比最初描述的"多行函数体内调用"更广泛——任何包含 custom command 名称字符串但实际命令不是 custom command 的脚本都会触发。

修复方向

止血方案： 在 wrapper 内引入跳过 custom fast-path 的内部执行入口（如 execInternal(..., skipCustomFastPath)），把 tryExecuteWithCustomCommands 里非 custom segment 的 this.exec(...) 改为 skip-fast-path 调用，切断递归。

正确性方案： 让 custom 命令在完整 MoonBit 执行路径里可用（函数体、循环、条件、子 shell 等），优先考虑启用现有 buildCustomPrelude()（src/wrapper/index.ts:1228）+ __moon_bash_custom__ bridge，而不是仅靠 JS fast-path 解析。

需要补充的回归用例

• 多行函数体内调用 custom command（原始复现）
• echo argv.py 不应 OOM
• 混合管道 echo hi | argv.py 正常
• 单行/多行函数两种写法都覆盖