Changelog

0.3.0 - 2026-05-31

新增 CMDCRAGArcana.Eval.ArcanaAdapter,把 Arcana Evaluation test case / run / metrics 转为 CMDCEval.Case 与 Run.metadata 友好结构。
新增 Arcana Evaluation retriever presets,支持评估 Arcana.search、Arcana.ask 与 pipeline preset。
新增 CMDCRAGArcana.Eval.TelemetryBridge,监听 Arcana evaluation telemetry 并广播 :rag_eval_progress CMDC plugin event。
新增 CMDCRAGArcana.Eval.Gate,提供 RAG Eval + Tool Calling Eval + Safety Eval 发布门禁 recipe 和阈值检查。
依赖 cmdc_eval ~> 0.2,复用其 assert/3 context 与通用 RAG assertions。

新增 CMDCRAGArcana.Ingestion.ParsedDocument / ParsedPage / ParsedTable,定义 Python OCR、版面解析、表格抽取 sidecar 可输出的 ingestion artifact。
新增 CMDCRAGArcana.CitationSpan,citation 可携带 page / section / paragraph / table_id / bbox / char offset provenance。
CMDCRAGArcana.Ingestion.run/2 支持 preprocessor 返回 rich parsed artifact,并归一化为 Arcana ingest text + metadata。
新增 CMDCRAGArcana.ProgressEvent,统一 ingestion / reembed / graph 后台任务 progress payload 与 EventBus 事件形状。
文档补充 parser/OCR sidecar 边界、citation span 输出和 progress event contract。

新增 Knowledge Control Plane 契约 struct:Collection / Document / DocumentVersion / IngestionRun / IndexStatus / SourceMapping。
新增 CMDCRAGArcana.Tool.IngestStatus 只读工具,通过 StatusBackend 查询 collection/document/version/graph 索引状态。
新增 CMDCRAGArcana.Ingestion adapter contract,供 Oban worker 调用 Arcana ingest,支持 preprocessor hook 与 version metadata。
新增 CMDCRAGArcana.Maintenance.reembed/2 wrapper,统一 telemetry 与 EventBus 进度事件。
新增 guides/knowledge_control_plane.md,给出 Ecto schema 草案、Oban worker skeleton、Arcana dashboard 生产边界与 maintenance 用法。

安全加固:配置归一化不再为未知 string key 创建动态 atom。
安全加固:rag_search / rag_answer 默认 fail closed,未显式配置 collection allowlist / policy 时拒绝访问。
文档补充:README 标明开发环境如需放行可显式设置 default_allow?: true。