feat(consultation): let the jyotish agent drive skills and tools

docs/BUG_HISTORY.md

@@ -2744,3 +2744,20 @@
 - 相关记录：BUG-159、ERR-020、ERR-021、ERR-022、ERR-024、ERR-025、ERR-026、ERR-104
 - 复发自：无
 - 修复版本：本地 staging 候选（未 push / deploy）
+
+## BUG-162 | 咨询工作流由路由预执行，Agent 无法真实编排 Skill 与服务器排盘工具
+
+- 状态：resolved（staging candidate）
+- 首次发现：2026-08-11
+- 最近更新：2026-08-11
+- 影响面：`POST /api/consult` 的个人/一般咨询、Mastra Agent、浏览器流式活动状态、咨询消息执行回执与计费结算；production 默认路径不变。
+- 用户现象：回答可以生成，但服务端在 Agent stream 前已经完成咨询工作流，Agent 只是复述结果；Web 只能按“有无正文”猜测状态，无法证明 Agent 实际加载 Jyotish Skill 或调用排盘工具。
+- 触发条件：咨询进入旧 runtime；route 直接执行 `runConsultationWorkflow()`，再把大段结果塞入 prompt，且仅返回 `text/plain`。
+- 根因：编排权在 Next.js route，不在 Agent；个人 Agent 未绑定服务器排盘工具，Skill/tool 执行合同和公开事件协议均不存在。若直接透传 `fullStream`，还会泄露 reasoning、工具参数/结果、出生资料或 Skill 内容。
+- 修复：增加 `legacy|canary|enabled` runtime 开关；新路径由带 Jyotish Skill 的 Mastra Agent 调用请求级 `run-jyotish-consultation`，工具参数只允许 question/theme，出生资料始终由服务器上下文绑定，并以请求内 Promise 保证重复调用只计算一次。服务端把 `fullStream` 清洗为 NDJSON，仅公开安全的 run/Skill/tool/activity/answer 事件；Skill 和主工具合同未完成时最多重试一次，仍失败则释放预留点数且不保存成功消息。Web 按 content-type 保留 legacy `text/plain` 回滚路径，新路径只累积 `answer.delta`，收到 `run.completed` 后保存 workflow/execution receipt，并用服务器 activity 驱动状态 UI。浏览器断线后服务端继续完成互斥结算。
+- 验证：聚焦回归覆盖动态 Skill 工具、General Agent 无个人排盘工具、服务器绑定参数、并发幂等、unverified precise timing blocked、私有 chunk 过滤、任意 NDJSON 边界、合同完成前正文阻塞、失败不保存、真实 activity UI、execution receipt 持久化、legacy 流与断线结算合同；最终命令和结果记录在本次 staging 发布回报。
+- 防复发：个人咨询不得在 Agent stream 前直接执行主 workflow；不得把出生资料放入模型工具参数；公开流不得包含 reasoning、provider metadata、工具输入/结果或 Skill 正文；只有 `run.completed` 可进入成功消息持久化，步骤最多 32 个，计算与结算都必须请求内幂等。
+- 回滚：仅将 staging 的 `CONSULTATION_AGENTIC_RUNTIME` 设为 `legacy`；无需回滚数据库或修改 production。
+- 相关记录：BUG-161
+- 复发自：历史咨询 runtime
+- 修复版本：本次 staging 候选提交