"""采纳走 flow：记录 reviews.adopt，不直接写正文文件。"""

from __future__ import annotations

from muse.store import add_review


def adopt_candidate(
    run_id: str,
    reviewer: str,
    reason: str,
    *,
    path: str | None = None,
) -> int:
    """本地人审留痕通道的写入口（reviews.adopt，不产生 Canonical）。web 必须调用本函数，不得自行写库。"""

    return add_review(
        run_id=run_id,
        target="candidate",
        action="adopt",
        reviewer=reviewer,
        reason=reason,
        path=path,
    )