TestManager_NoBootstrapByDefault 验证：默认（BootstrapCmd 为空）不触发任何 exec 调用。

TestManager_Start_Success 直接向 manager 注入已连接的 Client， 验证 Statuses() 返回正确的连接状态与 ToolsLen。

TestMaxTurnsLimit 验证 MaxTurns 安全阀：LLM 持续发起工具调用时，达到上限后强制退出。

TestMemory 运行 Memory 能力评估（2 个黄金用例）。 memory_write / memory_search 工具需要 SQLite 数据库，在 eval 隔离环境下未注册。 未注册的工具由 Registry.Execute 返回 IsError=true 的 ToolResu

TestMemoryNudgeInjectedEveryNTurns 验证 WithMemoryNudge 在指定 turn 间隔向 LLM 历史注入 nudge 提示。

TestMemoryNudgeNotPersisted 验证 nudge 仅注入每轮发送给 LLM 的临时副本， 绝不写入持久化的 Session（contextHistory 不被污染）。

TestNewTransport_AutoInferStdio 验证无 Type 但有 Command 时自动推断为 stdio。

TestNewTransport_HTTP 验证 http 类型创建 HTTPTransport。

TestNewTransport_HTTPMissingURL 验证 http 类型缺少 URL 字段时返回错误。

---- newTransport 工厂函数测试 ---- TestNewTransport_Stdio 验证 stdio 类型创建 StdioTransport。

TestNewTransport_StdioMissingCommand 验证 stdio 类型缺少 Command 字段时返回错误。

TestNewTransport_Unknown 验证未知 Type 时返回错误。

TestOTELEngineObserver_SpanLinkage 用真实 SpanRecorder 验证 interaction/turn/llm_request 三层 span 的 trace_id 相同且父子关系正确。这是 Langfuse 分组显示的核心前提。

TestParseLine 使用表驱动测试（Table-Driven Tests）验证 parseLine 的各种边界情况： 普通键值对、双引号值去除、空值、带空格的键值、注释行、无等号行、 无键行、不匹配引号（不应去除）、无引号值。

TestParseTestIDs 验证把 SWE-bench 中"JSON 编码为字符串的测试 ID 数组"解析为 []string。

TestPathLocker_ConcurrentReadWrite 验证并发场景下读写锁的正确性。 模拟多个读操作和写操作在同一个路径上并发执行， 写锁排他、读锁共享的行为应始终保持一致。

TestPathLocker_ConcurrentReaders 验证大量并发读者能共享同一路径的读锁。

TestPathLocker_IsolatedPaths 验证不同路径的锁互不影响。 对一个路径加锁不应阻塞对另一路径的加锁操作。

TestPathLocker_RefCounting 验证引用计数正确归零。 多次加锁解锁后，确认 map 中的条目被正确清理。

TestPlanning 运行 Planning 能力评估（2 个黄金用例）。

TestPlanningExecution 验证从计划生成到执行的完整流程（2 个黄金用例）。

TestRLockPath_MultipleReaders 验证多个 goroutine 可同时持有同一路径的读锁。 如果读锁不是共享的，测试将因无法同时获取两把读锁而超时。

TestReact_BasicFlow 验证单阶段 ReAct 的完整流程： Turn 1: LLM Action（携带工具调用）→ Observation Turn 2: LLM Action（最终回复，无工具调用）→ 终止

fakeScanner 用于在测试中替换 bufio.Scanner 的输入源（间接验证 readExpectedChecksum）。