#!/usr/bin/env python3
"""将 doc_id 解析为 verify playbook 绝对路径（唯一真源：ansible/playbooks/verify/<doc_id>.yml）。

历史上曾解析 labs/matrix-doc-playbooks.yml（“验证矩阵”）；该概念已废弃。
"""
from __future__ import annotations

import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parent.parent


def main() -> None:
    if len(sys.argv) != 2:
        print("用法: resolve_verify_playbook.py <doc_id>", file=sys.stderr)
        sys.exit(2)
    doc_id = sys.argv[1].strip()
    if not doc_id:
        sys.exit(2)
    p = ROOT / "ansible" / "playbooks" / "verify" / f"{doc_id}.yml"
    if not p.is_file():
        print(f"ERR: playbook 不存在：{p}", file=sys.stderr)
        sys.exit(2)
    print(p.resolve())


if __name__ == "__main__":
    main()