s03 中 todo 工具契约与 TodoManager 校验不一致

[lixiang-coder]

Summary

在 StageConfig.s03() 中，todo 工具的 schema 定义过于宽松，而 TodoManager.update() 又执行了更严格的隐式校验，导致模型返回看起来合理的结果时，运行时却直接失败。

Repro Cases

情况 1：当用户要求“先规划再执行”时，模型可能返回只包含 reason 的 items，随后报错：

IllegalArgumentException: Todo text/content required

情况 2：当用户要求一次创建多个文件时，模型可能把多个 item 都标记为 in_progress，随后报错：

IllegalArgumentException: Only one task can be in_progress at a time

Root Cause

当前 todo schema 没有清楚定义：

• item 允许或要求哪些字段
• 是否接受 reason
• 是否只允许一个 item 处于 in_progress

因此模型是按照工具的自然语义在输出，但运行时又额外施加了 schema 中未声明的约束，最终造成契约不一致。

Expected

todo 工具定义与 TodoManager.update() 的校验逻辑应保持一致，避免模型正常调用工具时在运行时失败。

Suggested Fix

• 收紧 todo item 的 schema 定义
• 在 schema 或 prompt 中明确“最多只能有一个 in_progress”
• 对 reason 这类常见 checklist 风格字段做兼容，或在 schema 层直接拒绝
• 为上述两种失败场景补充回归测试

[lixiang-coder]

情况 1：帮我在 src 目录下创建 3 个 Java 文件：Hello.java、World.java、App.java，请你再执行任务前先规划后再做执行。
模型返回如下：

{
  "id" : "req_XXX",
  "type" : "message",
  "role" : "assistant",
  "model" : "claude-opus-4-6-thinking",
  "content" : [ {
    "type" : "text",
    "text" : "\n\n我来先规划这个任务，然后逐步执行。"
  }, {
    "type" : "tool_use",
    "id" : "tool_1",
    "name" : "todo",
    "input" : {
      "items" : [ {
        "reason" : "规划任务：在 src 目录下创建 3 个 Java 文件 - Hello.java、World.java、App.java"
      }, {
        "reason" : "第1步：确认 src 目录是否存在，不存在则创建"
      }, {
        "reason" : "第2步：创建 Hello.java 文件"
      }, {
        "reason" : "第3步：创建 World.java 文件"
      }, {
        "reason" : "第4步：创建 App.java 文件"
      }, {
        "reason" : "第5步：验证所有文件是否创建成功"
      } ]
    }
  } ],
  "stop_reason" : "tool_use",
  "stop_sequence" : null,
  "usage" : {
    "input_tokens" : 965,
    "output_tokens" : 228
  }
}

情况2：帮我在 src 目录下创建 3 个 Java 文件：Hello.java、World.java、App.java，每个都写一个简单的类。
模型返回：

{
  "id" : "req_XXX",
  "type" : "message",
  "role" : "assistant",
  "model" : "claude-opus-4-6-thinking",
  "content" : [ {
    "type" : "text",
    "text" : "\n\n我来帮你创建这 3 个 Java 文件。"
  }, {
    "type" : "tool_use",
    "id" : "tool_1",
    "name" : "todo",
    "input" : {
      "items" : [ {
        "_" : true,
        "id" : "1",
        "status" : "in_progress",
        "text" : "创建 Hello.java"
      }, {
        "_" : true,
        "id" : "2",
        "status" : "in_progress",
        "text" : "创建 World.java"
      }, {
        "_" : true,
        "id" : "3",
        "status" : "in_progress",
        "text" : "创建 App.java"
      } ]
    }
  } ],
  "stop_reason" : "tool_use",
  "stop_sequence" : null,
  "usage" : {
    "input_tokens" : 1046,
    "output_tokens" : 169
  }
}