esflow

esflow 是轻量 Python DAG workflow 框架。用目录约定声明节点，@flow + edge() 组织 DAG，Runner.run() 输出事件流，支持并行副本、暂停协作、定点续跑、扇出和兜底链。

完整用法见 [reference.md](reference.md)。本文件只保留使用时必须先想清楚的要点。

需求建模

不要直接写 Node。先把用户需求压成一张最小 DAG 设计：

1. 输入：用户必须提供什么，哪些可以给默认值，哪些需要 pass_check
2. 产物：最终输出文件是什么，stdout envelope 要暴露哪些路径或字段
3. 节点：每个节点只做一件事，命名用业务动作，不用 step1 / process
4. 边：只表达真实数据依赖；没有依赖的任务让 DAG 同轮并行
5. 暂停点：人工确认用 TO_HUMAN，Agent 写产物用 TO_AGENT
6. 复用点：需要定点重跑时，明确哪些上游 artifact 应该被 --from / --resume 复用
7. 兜底链：多个候选方案用同层 serial，不要在一个 Node 里堆 if

动手前先给出：输入 -> DAG -> 产物。这个设计不清楚时，先问用户，不要猜。