#!/usr/bin/env python3
"""Validate an optional ACK .pouch/ack/agents.yaml routing override."""

from __future__ import annotations

import argparse
import sys
from pathlib import Path

from validate_tasks import load_document, validate_with_schema
from worker_profiles import validate_orchestration


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description="校验 ACK agents.yaml 结构")
    parser.add_argument("agents", nargs="?", default="agents.yaml", help="agents.yaml 路径")
    parser.add_argument("--schema", help="agents.schema.json 路径（默认自动探测）")
    args = parser.parse_args(argv)

    agents_path = Path(args.agents)
    if not agents_path.is_file() or agents_path.is_symlink():
        sys.stderr.write(f"agents.yaml 必须是普通文件且不能是 symlink: {agents_path}\n")
        return 2

    data = load_document(agents_path)
    schema_path = Path(args.schema) if args.schema else (
        Path(__file__).resolve().parent.parent / "templates" / "agents.schema.json"
    )
    errors = validate_orchestration(data, where="agents.yaml")
    mode = "内置语义规则"
    try:
        import jsonschema  # type: ignore  # noqa: F401

        if schema_path.is_file():
            errors = validate_with_schema(data, schema_path) + errors
            mode = f"schema ({schema_path.name}) + 内置语义规则"
    except ImportError:
        pass

    if errors:
        sys.stderr.write(f"agents.yaml 校验失败（{mode}），共 {len(errors)} 项：\n")
        for error in dict.fromkeys(errors):
            sys.stderr.write(f"  - {error}\n")
        return 1

    sys.stdout.write(f"agents.yaml 校验通过（{mode}）：{agents_path}\n")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())