test(ensemble): extract compose CSV + academic verdict parsers to bin/ + bats

[kiki830621]

摘要

把最後兩處「住在 SKILL.md markdown 裡」的解析 snippet —— compose 的 --lens-file CSV 解析、academic --auto-iterate 的 Codex verdict tag 解析 —— 抽成 shipped script + bats 覆蓋。延續前幾個 PR 的「inline → 單一真相源 + 自動化測試」架構。抽取過程 dogfood 各抓到 1 個真 bug。

新增

檔案	內容
bin/pai-parse-lens-csv（python）	compose CSV 解析（csv 模組、不 naive split、BOM-safe）→ JSON array。
bin/pai-parse-verdict（bash）	academic verdict tag 解析（grep，取 last-match）。
test/pai-parse-lens-csv.bats（14）	含逗號/引號/換行的 focus、needsSrt 變體、空欄跳過、BOM、CRLF、缺檔/缺欄。
test/pai-parse-verdict.bats（11）	last-match、{N} placeholder、嚴格大寫、查無 tag、stdin/file。

compose / academic SKILL.md 改成呼叫 script；CI + test/run.sh 加 py_compile（python lint）、shellcheck 擴及 pai-parse-verdict。bats 總數 25 → 50。

抽取過程 dogfood 抓到的 2 個真 bug

1. compose CSV 的 BOM 靜默丟列（fail-silent）：原 inline snippet 用 encoding='utf-8'。Excel/Windows 存的 CSV 帶 UTF-8 BOM 時，首欄 header 變 key → 每列 r.get('key') 回 None → if not k: continue → 整批 lens 被靜默丟棄，使用者的 CSV 形同被忽略（harness 接著回「no active lenses」，至少 fail-closed 不假 pass，但使用者完全不知道自己的 CSV 沒生效）。改 utf-8-sig。

負控：舊 utf-8 對 BOM CSV → []；新 utf-8-sig → 正確解出。

2. academic verdict 的 first-match 假收斂（fail-open）：原 regex 取 first-match。但 Codex 輸出開頭可能 echo「輸出格式說明」裡的範例標籤 —— <verdict>CONVERGED</verdict> / <verdict>PERMANENT_CONVERGENCE</verdict> 字面寫在 instruction 中。first-match 會誤抓那些範例 → 假收斂、提前 halt 自治迴圈。契約明寫 verdict「at the very end」→ 改 last-match。

（<verdict>NEEDS_ITER_{N}</verdict> 因含 {N} 不在 [A-Z_0-9] 而天然不被匹配，但 CONVERGED / PERMANENT_CONVERGENCE 範例會匹配，故 last-match 是必要的。）

兩個 bug 都已固化成 bats regression（CSV 的「BOM 不丟列」、verdict 的「echoed 範例在前、真 verdict 在後 → 取最後一個」）。

驗證

$ ./test/run.sh
shellcheck(2) ✓ | py_compile ✓ | bats 50/50 ✓ | node harness 8/8 ✓

版本

2.14.1 → 2.15.0（plugin.json + marketplace.json 同步）。CHANGELOG 已補 [2.15.0]。

覆蓋現況（本 PR 後）

Surface	測試
diff 建構（pai-build-diff）	bats 25
共用 harness（ensemble-workflow.js）	node 8
compose CSV 解析（pai-parse-lens-csv）	bats 14
academic verdict 解析（pai-parse-verdict）	bats 11

四個最 bug-prone 的非 LLM 邏輯 surface 都有自動化 regression。剩下的（多輪 apply-fix、focus-rotation、git-commit-per-round）是 LLM 驅動的編排，不適合單元測試。