#!/usr/bin/env python3
"""Run or dry-run PixelRAG marketplace candidate knowledge replay."""

from __future__ import annotations

import argparse
import json
import sys
from pathlib import Path


ROOT = Path(__file__).resolve().parents[2]
if str(ROOT) not in sys.path:
    sys.path.insert(0, str(ROOT))

from services.pixelrag_marketplace_candidate_knowledge_replay_service import (  # noqa: E402
    run_pixelrag_marketplace_candidate_knowledge_replay,
)


def main() -> int:
    parser = argparse.ArgumentParser(
        description="執行或 dry-run PixelRAG marketplace candidate knowledge replay。"
    )
    parser.add_argument(
        "--embedding-signature-guard-receipt-root",
        help="Marketplace embedding signature guard receipt root；預設使用 production/container 設定。",
    )
    parser.add_argument(
        "--output-root",
        help="Marketplace candidate knowledge replay artifact receipt output root。",
    )
    parser.add_argument(
        "--platform",
        action="append",
        dest="platforms",
        help="限制平台，可重複指定，例如 --platform shopee_tw --platform coupang_tw。",
    )
    parser.add_argument(
        "--max-age-hours",
        type=int,
        default=168,
        help="receipt 最大新鮮度小時數。",
    )
    parser.add_argument(
        "--limit",
        type=int,
        default=25,
        help="最多處理 embedding signature guard receipt 數。",
    )
    parser.add_argument(
        "--execute",
        action="store_true",
        help="執行 candidate knowledge replay；未指定時只做 no-write dry-run readiness。",
    )
    parser.add_argument(
        "--write-receipt",
        action="store_true",
        help="execute 後寫入 candidate knowledge replay artifact receipt；不寫 DB。",
    )
    args = parser.parse_args()

    payload = run_pixelrag_marketplace_candidate_knowledge_replay(
        embedding_signature_guard_receipt_root=(
            args.embedding_signature_guard_receipt_root
        ),
        output_root=args.output_root,
        platform=tuple(args.platforms or ()),
        max_age_hours=args.max_age_hours,
        limit=args.limit,
        execute=args.execute,
        write_receipt=bool(args.write_receipt and args.execute),
    )
    print(json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True))
    return 0 if payload.get("success") else 1


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