ai-workflow-skill/docs/tests/inbox/fail/fail-persists-failure-body-and-artifact.md

Case: fail-persists-failure-body-and-artifact

用例意义

验证 fail 能持久化失败说明与附件。

前置条件

• worker-b 已成功 claim 线程 THREAD_ID
• TMPDIR/failure.md 已存在

输入

inbox --db TMPDIR/coord.db --json fail --agent worker-b --thread THREAD_ID --summary "Migration failed" --body-file TMPDIR/failure.md --artifact TMPDIR/failure.md --artifact-kind report
inbox --db TMPDIR/coord.db --json show --thread THREAD_ID

预期输出

• fail 成功
• 最终结果消息 body 等于文件内容
• 结果消息包含 1 个 report artifact

断言结论

• 失败终态同样要能完整交付排障材料

补充约束

• --payload-json 需要是合法 JSON；空值会按 {} 处理
• --body 与 --body-file 互斥；不可读的 --body-file 属于 invalid_input
• artifact-kind 和 artifact-metadata-json 不能脱离 --artifact 单独使用，且多值数量必须满足“一次全量应用”或“逐 artifact 对齐”