fix(cypher): interpolateString single-ref array/object pass-through (P0 #11)

mira_feed_watcher 第一輪 cron tick 跑 264ms 完成但 0 raw 處理 — 挖到 root cause： interpolateString 看到模板就 string.replace，非 string 值（如 kbdb_get 回的 blocks 陣列）一律 JSON.stringify。所以 `items: "{{list_raws.blocks}}"` 把陣列轉成字串給 filter 零件，filter 收到字串 != array → items 被忽略 → FOREACH 跑 0 次 → watcher 看似成功實則空跑。修：interpolateString 加 single-ref pass-through —— 若整個值是純單一 `{{x}}` 引用，回 raw value（保留 array / object 型別）。多 ref / 混合文字仍 stringify。對應 SDD: arcrun.md 三-A P0 #11。下一輪 cron tick 應該真正處理 raws，加 wiki-processed tag。
2026-05-14 14:54:26 +08:00
parent 711af5dbf2
commit 8ab6f8a66b
2 changed files with 23 additions and 1 deletions
@@ -233,6 +233,18 @@ acr push 就會自動建立 cron-idx 並開始定時觸發。

 ---

+#### P0 #11（2026-05-14 已解決）：interpolateString stringify array 撐爆下游
+
+**現象**：mira_feed_watcher 用 `items: "{{list_raws.blocks}}"` 把 kbdb_get 拿到的 blocks 陣列傳給 filter 零件。watcher 跑 264ms 完成、0 raw 處理。
+
+**根因**：`interpolateString` 看到模板就用 `String.replace`，非 string 值（陣列）一律 `JSON.stringify`。filter 零件收到字串 `"[{...},{...}]"` 不是 array，items 被忽略 → 0 matches → FOREACH 跑 0 次。
+
+**修法**：`interpolateString` 加 single-ref pass-through 規則：若整個值是純單一 `{{x}}` 引用，回 raw value（保留 array / object 型別）。多 ref / 混合文字仍 stringify 拼接字串。
+
+**測試**：mira_feed_watcher 推到 prod 後下一個 cron tick 觀察 wiki-processed tag 是否在 raws 上出現。
+
+---
+
 ### 三-B、新零件加入紀錄

 | 日期 | 零件 | 動機 | 對應 SDD |