writer-work-flow

kai/writer-work-flow

Fork 0

Commit Graph

Author	SHA1	Message	Date
Yaojia Wang	ed0a679322	fix(backend): 多章链设显式 recursion_limit 防御硬化（CR-C2）	2026-07-08 10:32:37 +02:00
Yaojia Wang	d1ea83b191	fix(chain): 修评审 CRITICAL+HIGH — 链网关按 session 重建/日志脱敏/resume 原子化+所有权/死导入 - CRITICAL #1：链 write/review 节点经 gateway_builder 按节点自建 session 现建网关， usage_ledger sink 绑活 session，随节点 commit 持久化；run_chain_job 不再转发请求网关（其 session 在 BackgroundTask 跑时已关闭，记账行被静默丢弃）。新增 get_chain_gateway_builder 缝（仿 digest builder），get_chain_gateway 退化为纯 503 凭据预检。守不变量 #1。 - HIGH #2：chain_runner 失败日志不再记 str(exc)（可能含 key/连接串/LLM 输出），改记 _classify_job_error 脱敏文案 + exc_type（设计 §5）。 - HIGH #3：resume 端点原子抢占 awaiting→running（JobRepo.claim_awaiting_to_running 条件 UPDATE），抢不到 → 409，防并发 resume 双 Command(resume) 损坏图。 - HIGH #4：resume 校验 job.project_id == project_id（JobView 新增 project_id），不匹配 → 404。 - HIGH #5：resume 返回新 ChainResumeAccepted{job_id,chain_key}，去掉无意义哨兵 start/count=0。 - HIGH #6：删 nodes.py 死导入 extract_conflicts（import + __all__）。 - 测试 #7：e2e 断言链跑后 usage_ledger 有行（#1 回归守卫）+ chapter_reviews 每章一行；新增 claim 原子抢占单测 + resume 跨项目 404 / 并发 409 端点测。	2026-06-23 18:04:10 +02:00
Yaojia Wang	29349dc7ee	feat(api): C2 多章链服务+端点+schema+checkpointer 接线承 C1 链图（build_chain_graph），落地多章工作流链的 apps/api 壳： - 3 端点 routers/chain.py：POST .../chains/{key}/run→202 ChainRunAccepted； POST .../chains/runs/{job_id}/resume→202；GET /jobs/{id} 复用。校验： count 1..50→422、未知 chain_key→404、resume 非 awaiting→409、无凭据→503。 - schemas/chain.py：ChainRunRequest/ChainRunAccepted/ChainResumeRequest （ConflictDecision 复用 schemas/projects）。 - services/chain_runner.py：run_chain_job 仿 run_job 壳自建独立 session 驱动链图（set_running→ainvoke→据 __interrupt__ 置 awaiting_input/done/failed）； build_accept_op 在 apps/api 装配验收事务闭包注入图节点（守 #3/#4）； token 不入 result/日志。 - services/chain_deps.py：get_checkpointer_factory（运行时 AsyncPostgresSaver 上下文 / 测试 MemorySaver）。 - 零迁移（设计 §7）：复用 jobs，新增 status="awaiting_input" + JobRepo.set_awaiting， awaiting 章经 result.awaiting_chapter；新错误码 ErrorCode.CONFLICT(409)。 - project_deps：build_chain_gateway/get_chain_gateway（按请求 tier writer/analyst/light 分派——单档网关恒返该档会错路由 review/digest）+ get_digest_gateway_builder。单测 apps/api/tests/test_chain.py 12 用例（mock 网关 + MemorySaver + fake session/ accept_op，无 DB/无网络/无真 LLM）：run/resume→202、未知 key 404、count 越界 422、 resume 非 awaiting 409、run_chain_job 无冲突→done、冲突→awaiting→resume→done、错误脱敏、accept_op 冲突缺判→CONFLICT_UNRESOLVED。门禁绿：ruff/format 干净 · mypy 193 Success · alembic 无漂移 · pytest 600 passed。守不变量 #1/#3/#4/#5/#9。唯一新增 DDL（langgraph 检查点表）= C3 迁移。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-23 17:12:53 +02:00

Author

SHA1

Message

Date

Yaojia Wang

ed0a679322

fix(backend): 多章链设显式 recursion_limit 防御硬化（CR-C2）

2026-07-08 10:32:37 +02:00

Yaojia Wang

d1ea83b191

fix(chain): 修评审 CRITICAL+HIGH — 链网关按 session 重建/日志脱敏/resume 原子化+所有权/死导入

- CRITICAL #1：链 write/review 节点经 gateway_builder 按节点自建 session 现建网关，
  usage_ledger sink 绑活 session，随节点 commit 持久化；run_chain_job 不再转发请求网关
  （其 session 在 BackgroundTask 跑时已关闭，记账行被静默丢弃）。新增 get_chain_gateway_builder
  缝（仿 digest builder），get_chain_gateway 退化为纯 503 凭据预检。守不变量 #1。
- HIGH #2：chain_runner 失败日志不再记 str(exc)（可能含 key/连接串/LLM 输出），改记
  _classify_job_error 脱敏文案 + exc_type（设计 §5）。
- HIGH #3：resume 端点原子抢占 awaiting→running（JobRepo.claim_awaiting_to_running 条件
  UPDATE），抢不到 → 409，防并发 resume 双 Command(resume) 损坏图。
- HIGH #4：resume 校验 job.project_id == project_id（JobView 新增 project_id），不匹配 → 404。
- HIGH #5：resume 返回新 ChainResumeAccepted{job_id,chain_key}，去掉无意义哨兵 start/count=0。
- HIGH #6：删 nodes.py 死导入 extract_conflicts（import + __all__）。
- 测试 #7：e2e 断言链跑后 usage_ledger 有行（#1 回归守卫）+ chapter_reviews 每章一行；
  新增 claim 原子抢占单测 + resume 跨项目 404 / 并发 409 端点测。

2026-06-23 18:04:10 +02:00

Yaojia Wang

29349dc7ee

feat(api): C2 多章链服务+端点+schema+checkpointer 接线

承 C1 链图（build_chain_graph），落地多章工作流链的 apps/api 壳：
- 3 端点 routers/chain.py：POST .../chains/{key}/run→202 ChainRunAccepted；
  POST .../chains/runs/{job_id}/resume→202；GET /jobs/{id} 复用。校验：
  count 1..50→422、未知 chain_key→404、resume 非 awaiting→409、无凭据→503。
- schemas/chain.py：ChainRunRequest/ChainRunAccepted/ChainResumeRequest
  （ConflictDecision 复用 schemas/projects）。
- services/chain_runner.py：run_chain_job 仿 run_job 壳自建独立 session 驱动链图
  （set_running→ainvoke→据 __interrupt__ 置 awaiting_input/done/failed）；
  build_accept_op 在 apps/api 装配验收事务闭包注入图节点（守 #3/#4）；
  token 不入 result/日志。
- services/chain_deps.py：get_checkpointer_factory（运行时 AsyncPostgresSaver
  上下文 / 测试 MemorySaver）。
- 零迁移（设计 §7）：复用 jobs，新增 status="awaiting_input" + JobRepo.set_awaiting，
  awaiting 章经 result.awaiting_chapter；新错误码 ErrorCode.CONFLICT(409)。
- project_deps：build_chain_gateway/get_chain_gateway（按请求 tier writer/analyst/light
  分派——单档网关恒返该档会错路由 review/digest）+ get_digest_gateway_builder。

单测 apps/api/tests/test_chain.py 12 用例（mock 网关 + MemorySaver + fake session/
accept_op，无 DB/无网络/无真 LLM）：run/resume→202、未知 key 404、count 越界 422、
resume 非 awaiting 409、run_chain_job 无冲突→done、冲突→awaiting→resume→done、
错误脱敏、accept_op 冲突缺判→CONFLICT_UNRESOLVED。

门禁绿：ruff/format 干净 · mypy 193 Success · alembic 无漂移 · pytest 600 passed。
守不变量 #1/#3/#4/#5/#9。唯一新增 DDL（langgraph 检查点表）= C3 迁移。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-23 17:12:53 +02:00

3 Commits