5 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	ec292081b2	refactor(trace): 拆 graph.go 471 行 → graph.go / graph_build.go / graph_props.go（纯搬移） ... 执行方案 DevDocs/audit/_plan.md 阶段 0 · G0-B：该文件距 500 行红线仅 29 行，而后续 11.4.2（memory/guardrail/orchestration 三类 span 生产者）等改动必然推进它 ⇒ 先拆。 - graph.go(159)：对外类型与快照 API（FlowStatus* / FlowNode / FlowEdge / FlowGraph / NodeSpec / RunGraph；NewRunGraph / Start / SeedInput / SeedOutput / Snapshot） - graph_build.go(245)：构图与折叠（Upsert / rememberParent / laneOf / merge / addEdge / AddSpan / AddSpanStart / kindForSpan / labelForSpan / statusForFinished） - graph_props.go(77)：prop 白名单与脱敏（safeSpanProps / safePropKeys / summarize / truncate） 纯搬移机械证明：拆前与拆后（取非空、非 package、非 import 块行）排序后 **md5 相同、 diff 为空**；声明集合 28 条守恒；唯一新增文本 = 两个新文件的 package 行与 import 块。 `safePropKeys`（含 4bf1f7c 刚加入的 "persona"）原样落在 graph_props.go，逐字节未动。 验证：go build/vet 绿；internal/runtime/trace + internal/services/gateway 测试绿（含 graph_persona_test 与 flow_update_ws_test 的 graph_update 线上帧成对契约回归）； linux/amd64 + darwin/arm64 交叉编译绿；三文件 159/245/77 行均 ≤500；gofmt -l 无输出。	2026-10-04 10:46:13 +08:00
AskaEth	4bf1f7cac6	fix(trace): 让 graph_update 的分支根节点 props.persona 真的前送（白名单漏登记） ... 审计（DevDocs/audit/11-trace-observability.md 发现 #1）：scheduler 用 span.SetProp("persona", sub.PersonaID) 设了这个 prop，api-client v0.47 也已把它写进 对外承诺，但 trace/graph.go 的 safePropKeys 白名单不含 "persona"，而 safeSpanProps 只遍历白名单 ⇒ 该键在到达客户端前被静默丢弃（实测：整个 props 键都消失）。 修法：把 "persona" 加进 safePropKeys，并在同处写清它为什么可以前送 —— ① 它必然是注册表校验过的角色 id（scheduler.checkPersona 未知 id 一律 ErrUnknownPersona 拒绝整批派发）；② 它本来就随 GET /personas 与 message_persisted.personaId 对外可见； ③ 值仍过 redactValue → RedactText（凭据形状清洗 + 80 rune 截断）。 测试：新增 trace/graph_persona_test.go（真 Tracer → 真 SetProp → 真 Snapshot，两条断言： 有 persona / 不指定角色时键不出现 = 钉住 v0.47 的"纯增量"）+ 网关 flow_update_ws_test.go 追加 TestFlowGraphUpdateRelaysPersonaProp（真 bus Publish → 真 WS 帧 → 断言帧内节点 props.persona=="yuki"）。 验证：go build/vet 绿；trace + gateway 包测试绿；全树 go test ./... = 58 包 ok / 0 FAIL； linux/amd64 + darwin/arm64 交叉编译绿；gofmt -l 干净；三文件 471/57/370 行、最长函数 64 行。 变异验证：把 persona 从白名单摘掉 → 两条断言分别 FAIL（trace 层 props 为空； WS 帧里 span-sub 节点的 props 键整个消失），还原后复绿。 遗留（登记）：前端尚未消费该键（flow 节点未显示"以谁的身份替班"）。	2026-10-04 10:37:22 +08:00
AskaEth	de1fa83b79	feat(orchestration,loop,flow): 接线子代理编排 — 派发入口 + 分支归父会话 + 节点日志（含脱敏） ... 修的是「文档说 ✅、生产不可达」：此前 Scheduler.Spawn 只有测试调用方、无 bus 入口、无派发工具；Span.Record 无生产调用方 → 泳道画不出、节点日志恒空。 - 入口：subagent_spawn 工具（internal/runtime/orchestration/spawntool.go，同包便于用真 Scheduler/loop/Tracer/Flow 做集成测试；注册在 cmd/cyrene/subagent_tool.go 照 terminal_tool 范式）。默认 owner-only，不设 AllowInGroup/AllowInStranger；安全仍由 restrictSchemas + applyToolSecurityGate 双层保证，未绕代审 - 父会话归属：AgentSpec.ParentSession（请求语义）→ Scheduler 转运行期 ctx 标记 loop.WithFlowBranch → 分支 span 以父 session 发布；**allow 谓词一行未改**；单图语义靠「分支 Run 不调 StartRound/EndRound」+ FlowPublisher 不新建图；未归属 spawn 一张图都不发（有测试锁） - 前台最多等 2s（对齐 task.autoBackgroundThreshold）→ 合并结果作工具结果；转后台则广播 bus subagent.result（design/05 §9 回填 hook）；新增 Scheduler.Wait(ids) 按批等待（Join 会串并发批次，故不重用） - 子代理跑在 WithoutCancel(ctx)：保留 span 归属、不被工具超时/回合结束顺手杀掉；生命周期由 PerAgentTimeout + CancelAll 约束；内部 WithMutedBroadcast 静音（不进前台 stream） - 节点日志：loop/spanlog.go 新增 llm.done / tool.done / subagent.done；工具参数**只记键名不记值**；仅步骤真正结束才追加（跳过/被拒路径不发，不伪造） - 脱敏（红线）：新增 trace/redact.go（形状规则 sk-/Bearer/JWT/key:value + 键名规则 api_key/token/authorization/password…，递归嵌套、不改调用方事件），graph.go 发布前必经；**顺带修掉一个既有泄漏**：result_summary prop 原先未脱敏（工具结果里的密钥会进图），由图级变异测试抓出 - 测试：新增 22 个（工具级 / 图级 / 日志级），含 4 次变异验证（去掉 WithFlowBranch、去掉 record*、还原未脱敏、去掉静音 各自 FAIL）；-race 过 orchestration+trace+loop - 已知限制：真实模型端到端未验（无凭据/不起服务）；工具白名单是 design gap 未做；subagent.result 暂无消费者（design/15 未实现）；后台子代理跨轮次边界迟到 span 会丢泳道根；PerAgentTimeout=10min 待确认	2026-10-03 19:39:38 +08:00
AskaEth	2c100fe3d9	feat(flow,web): 全链路可视化 P2 — 泳道/并行分支 + 节点活动状态 + 节点实时日志 ... - 后端 trace/graph.go（395→470）：泳道感知游标 —— parents 记住被跳过容器(state_transition)的父链、laneLast 按泳道分别的末节点游标；泳道首节点挂 subagent 根、后续步骤在本泳道内串链；**子代理根不再推进主干游标**（否则 spawn 之后的主干节点会被算成最后一条分支的步骤）；node kind 抽具名常量。+ graph_lane_test.go（并行双泳道断言精确边集/嵌套泳道/主干游标不回归/laneOf 环保护） - 前端新增 flow/{tone,lanes,layout,NodeDetail,LaneSummary}：分组=沿入边反向 BFS 取最近 kind=subagent 祖先（纯 edges，故无需新增 wire 字段）；布局=主干沿用 P1 最长路径分层 + 每泳道一条独立横带（带内最长路径深度、逐带下推 y 不重叠、横向滚动）；Flow.tsx/FlowGraph.tsx 加泳道框/虚线泳道边/运行闪烁(既有 mu-blink)/选中高亮/图例 - 实时日志：选中态按 node id 保存，随每帧 graph_update 重新 find → 自动显示追加后的 log[]；空时区分「运行中(事件随 span 结束回填)」与「未记录事件」，不合成事件 - 未新增 wire 字段 → 无契约变化（因此未动 lib/types.ts / wsParse.ts）；<FlowGraphView> 旧签名兼容，Agents/Backthink 页不受影响 - 验收：go build/vet/test 全绿 + linux/darwin 交叉编译 + npm run build(177 模块) + 逻辑测试 lanes 40 / channelStatus 45 / enums 47 / messageSync 54 - ⚠️ 已核实、未伪造的缺口：生产路径当前产不出子代理数据 —— Scheduler.Spawn 全仓仅测试调用方(0 生产)、编排包无 bus 订阅入口、无「派子代理」工具/capability → 泳道要真的亮需先接线；Span.Record 同样无生产调用方 → log[] 恒空（UI 已诚实显示空态）	2026-10-03 19:21:10 +08:00
Aska	44e7a5c2c5	feat(flow): 实时全链路流程可视化 P1——trace→graph_update→前端全链路流程页(design/19) ... 后端: trace/graph.go(RunGraph 图构建器,kind/status 映射,父子优先连线,脱敏白名单+截断); loop/flow.go(FlowPublisher 按会话增量发布 ws.graph_update,仅主人web会话); loop span start/finish 折入图; run.go StartRound/EndRound; wire.go 组装+注入. 前端: Flow.tsx(全链路流程页:FlowGraphView+会话/节点/开始/耗时卡片+状态计数+节点点开日志); FlowGraph 组件加 onNodeClick; types/wsParse 扩展; router/sections/AdminApp 注册 flow; api-client.md §3.5 graph_update 契约. 验证: 后端 build/vet/test 全绿+flow_test.go 集成(span→graph→ws.graph_update主干); 前端 build 绿. 红线: 单二进制零新依赖; 工具参数/结果脱敏; 仅主人web会话; 身份靠actor元数据; 只读不虚构. P2(并行子代理分支/泳道/节点实时日志)后置.	2026-09-07 19:10:57 +08:00