6 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	2bf3b536dd	fix(flow): 时间轴两处诚实性缺陷（X1） ... ① round 号跨重启被复用 ⇒ 时间轴把多个真实轮次并成一块（真机实测 web 的 r:1 挤了 4 路、 startedAt 跨 13:52→21:05）。修法：发号前从落盘播种（MaxRound，json_extract + json_valid 挡坏行）， 每会话每进程只播一次、失败只 WARN 且不重试、并发首轮共享一次读；接口形状零变化 ② truncated 一个字段兼两个意思 ⇒ 一页没拉完时前端会说「更早的轮次已过保留期」（假话）。 新增 retentionBoundaryReached（= 保留期启用 且 已翻到底 且 现存最早一轮 round>1 ⇒ 确有轮次被清扫）， truncated 语义一字未改；盲区如实登记（整段被清扫会说少、最早一轮落盘失败可能多说） 3 个变异自检（不落账/floor>0/去掉 hasMore 守卫）	2026-10-06 21:16:21 +08:00
AskaEth	1efe3a6a79	feat(flow): 链路图时间轴出口（W1）—— 所有轮次按时间正序 ... - 新增 GET /api/v1/admin/flow/timeline?sessionId=&limit=&before=：时间正序多轮， 每轮 {turnId,round,startedAt,endedAt,lanes[]}；limit 缺省 50/上限 200 + before 游标 - 数据源=落盘 flow_graphs + 内存最近一轮（同图 id 去重）；保留期 168h 外的轮次不返回， 但响应给 retentionHours/retentionEnabled/truncated ⇒ 前端如实标注，不悄悄少一块 - 老出口 GET /admin/flow/graph 零 diff；角色门 writeAuth（owner|admin） - 4 个变异自检（游标 <= 重复、分组降级、去重缺失、truncated 静默）	2026-10-06 15:59:09 +08:00
AskaEth	4a937bd269	feat(flow): toolCalls 覆盖率追到全部编排回合（L3）—— 图带权威回合标识 ... - 新增 StartRoundWithTurnID(ctx, owner, text)：从 ctx 取权威回合标识（与 chat_messages.turn_id 同值）；Run 的唯一生产建图入口切到它；原 StartRound 语义逐字不变（1 行包装） - 归属桶（并行按路分图）保持不变；落盘查询键 lane_turn_id 对单路也有值 ⇒ 消息面按等值查得到图 - 无权威标识时**保持缺席**（不拿桶里的路标识顶上：不许臆造） - 不需要迁移 0024（0023 的列+索引已在位；老单路行标识根本没存过，回填=编造） 形状变化（已登记契约）：graph.id 对单路也追加 #{回合标识}（web-7 → web-7#turn-…）， 顺带修掉「重启后单路轮次 upsert 掉旧行」的隐患。3 个变异自检（退回老入口/无视 ctx/臆造回退）。	2026-10-06 14:12:25 +08:00
AskaEth	c907a34510	feat(gateway): 面 1 补齐 —— 消息读取面 toolCalls[]（工具回看） ... 前提由 FV2 提供（图自 v0.77 起带每路 turnId、每路各落一行）。本片： - 迁移 0023：flow_graphs 加「按路查询键」（写入时回填图的 TurnID），老行按缺席处理 - GET /api/v1/sessions/{id}/messages 加**可选** toolCalls[]，形状严格照 Docs/api-client.md v0.76 ① 已登记的：{name, status(ok|error|unknown), durationMs, argsSummary, resultSummary} - 🔴 图取不到 ⇒ **字段整体缺席**（绝不回空数组冒充「没调过工具」） - 一条批量 SQL（按页内 turnId 集合），禁 N+1；单条 ≤20 个工具、resultSummary ≤500 字符（常量+依据） - 只放图里已有的、已脱敏内容，不放宽脱敏通道	2026-10-06 09:03:55 +08:00
AskaEth	89434eadef	fix(flow): graph_update 按路分桶——修真并行两路的图互相覆盖（FV2） ... 【取证（症状成立，且比登记描述更糟）】两路真并行时两路最终落盘**同一个 turn_id**， 其中一路的图彻底消失，且 A 路的工具被画在 B 路的图上。逐层定位：发布器 graphs 只按 sessionID 建键（后起的路整张顶掉前者）· 帧载荷基线的键集被既有测试精确断言为 {id,nodes,edges,sessionId,startedAt,endedAt}（无任何区分路的键）· 前端每会话单桶 · 落盘 (session_id,turn_id) 唯一键两路相撞 · 冷启动 LastGraph 只有一张。 该 bug 早已公开登记（design/15 §2.5.10-1「本轮未解决」、契约 §6-19「仍**未修**」）。 【修法】 - 归属桶 {会话}[#{路}]（loop.FlowOwnerKey，与 checkpoint 键同字符口径）；路只来自 ParallelLegFrom(ctx) ⇒ 单路逐字不变（桶 = 会话 id），既有调用点语义零改动 - 图 id 的第二分量改用**建图序号**（每次 +1、永不复用）：同一轮里可以有并行路 + 队首续跑的串行路，用轮次号会让两条串行路撞同一个 web-1 - 轮次号只在上一轮的路全部收尾后推进，并丢掉更早轮次的桶（否则内存随路数无界增长） - 新增只读出口 LatestLanes ⇒ GET /admin/flow/graph 的 lanes[]（最近一轮每一路）， graph 仍是「最新一路」= 向后兼容 - 同源洞一并修：子代理归属原取 AgentSpec.ParentSession（会话、不含路）⇒ 并行路里派的 子代理 span 被静默丢弃；新增 AgentSpec.FlowOwner 承载「会话#路」，ParentSession 继续 只承载会话（总线载荷 subagent_result.sessionId 不受影响） - 前端：store 增 flowLanes（按 turnId 分格、按轮淘汰、硬上限 4）+ LaneTracks 泳道卡； 单路/未给 lanes 时渲染路径与改前逐字相同 【无迁移】turn_id 是自由文本、每路 id 唯一 ⇒ 0022 的唯一索引天然分两行（0023 仍空着） 【我的验收】① 隔离 worktree（30 文件）build/vet/linux/darwin 全过、69 包全绿 0 FAIL； ② 我亲手打红变异：让 FlowOwnerKey 忽略路 ⇒ TestFlowPublisher_ParallelLegsDoNotOverwriteEachOther FAIL；③ 前端独立复跑 npx tsc --noEmit + npm run build 通过（4.12s） ⚠️ 契约 v0.77 的登记在紧随其后的 docs(contract) 提交里（同一个工作时段内）。	2026-10-06 08:16:03 +08:00
AskaEth	a6cb44b8a8	feat(flow): 链路图本地落盘 + 多轮历史回放（design/19 §P3，契约 v0.73） ... 主人要求「链路流程应该有本地数据，不然每次重载之后页面就没数据了」： - 落盘：迁移 0022_flow_graphs（session_id/turn_id/graph_json/时间戳 + 唯一键 upsert）+ internal/runtime/flowgraph（RecordRound/Graph/Latest/Turns/Turn + 保留期 GC） - 写入：loop.EndRound **每轮一条**（锁外深拷贝后写；失败 WARN 且不打印图内容）；只落发布会话白名单（复用 flowSessionAllowed） - 读回：端点加 turnId + source(live/persisted/none) + turns[]（最新在前，空为 []）；**内存优先、miss 才落盘**（最新一轮永远最新） - 前端：flowGraphs 纳入 persistOptions.partialize（**刷新即刻有图**，version 3→4 + migrate）+ 历史轮选择器 + 诚实文案；顺带收 L1 转交的 flow/NodeDetail.tsx 节点日志倒序 - 新 env 键：FLOW_GRAPH_RETENTION=168h / FLOW_GRAPH_GC_INTERVAL=1h - 变异实测：每 span 一行 / 保留期守卫失效 / partialize 去掉 flowGraphs / 去掉内存优先 / 白名单失效 ⇒ 全部打红 - 3 个禁动面文件的纯追加改动（Flow.tsx 挂选择器、FlowSnapshotHint 纠已成假话的文案、其渲染断言随之更新）由主会话裁定认可 - 登记存疑：图桶持久化无体积上限；useFlowTurns 的 effect 无自动化证据（项目无 jsdom）	2026-10-05 16:19:32 +08:00