docs: phase B 开工前决策建议 —— 异步化回归风险可结构性消除
回应四条裁定与一个交叉点。不含实现。
核心结论：草案 A1「recallBlocks 改 async」是我图省事的设计偷懒，
把「要拿向量」和「要打分」混在一个函数里。切分后风险归零：
recallBlocks(store, query, opts) 保持同步，签名行为不变
新增可选 opts.vectorScores = Map<blockId, number>
recallBlocksHybrid(store, embedder, q, opts) 新的 async 包装
实测调用面：生产代码 3 行（lib/index.js:124/140/277），
测试代码 0 行（test/store.test.js 5 处 + scripts/checkpoints.js 4 处
全部继续调同步版）。已实测确认 test/plugin.test.js:119 那个
`contextForStep = () => ''` 的同步桩在 async 化后仍兼容（await 非
Promise 值即其本身），所以那条变异测试继续有效。
建议把 guard 组 A1 改成「recallBlocks 保持同步且实现不变」，
并新增 A3：hybrid 在 embedder 为 null 时返回值与同步版逐字段相同
（含 why 字符串）——切分后最大的新风险是两个入口漂移，A3 钉死它。
四条裁定核对
- §2.1 endpoint 规范化：建议固定四条（去尾斜杠 / host 小写 /
省略默认端口 / 去空白），不做 query 重排与路径归一。
- §2.2 四态：可执行，我草案的三态漏了「向量化失败」，裁定并进来更准。
新增 D7：stats 默认不解析向量 JSON（用 length(vector)），维度从
graph_centroid 取。修正一处我原稿的说漏——HA 为算 Dimensions 必须
逐行 decodeVector（block_recall.go:303/313），所以「维度统计」与
「不解析」互斥，只能靠中心表绕开。
- §2.3 centroid 补 stats 列：已列为第一件事。
- §2.4 失败降级：同意，并建议 mode 三值而非 bool
（no_embedder / embed_error / all_mismatched 对用户意义不同）。
§3 建议把 embedder 焊成单方法窄接口（embedText / info / close），
加 G5 源码 grep 守卫：除 lib/embed/http.js 外不得出现 http/endpoint/
fetch/Bearer 等 provider 专属标识——机器可查，比约定强。
§4 交叉点：建议投完整 phase B，按 §1 切分后 5.5-6.5 人天。
但建议你先确认一件事：是否有真实使用中的 dsh 会话在产生块？
若无，可先投 2.5 人天的中间态（向量写入 + 四态可见，不改召回主路径）。
§6 记录本轮两处自我修正。
参考仓未改动。
jianf
eac9f0fca6