"""Purge orphaned video temp directories (tj_video_* / tj_vid_audio_*) older than retention.

Does NOT touch .data/interview_sessions, face audits, or ID stores.
"""

from __future__ import annotations

import logging
import shutil
import tempfile
import time
from pathlib import Path

from app.config import get_settings

logger = logging.getLogger(__name__)

_PREFIXES = ("tj_video_", "tj_vid_audio_", "tj_audio_")


def cleanup_orphaned_video_temps(
    *,
    retention_hours: float | None = None,
    tmp_root: Path | None = None,
    dry_run: bool = False,
) -> dict[str, int]:
    settings = get_settings()
    hours = float(
        retention_hours
        if retention_hours is not None
        else settings.video_temp_retention_hours
    )
    root = tmp_root or Path(tempfile.gettempdir())
    cutoff = time.time() - max(0.0, hours) * 3600.0
    scanned = 0
    removed = 0
    skipped = 0

    if not root.is_dir():
        return {"scanned": 0, "removed": 0, "skipped": 0}

    for path in root.iterdir():
        name = path.name
        if not any(name.startswith(p) for p in _PREFIXES):
            continue
        if not path.is_dir():
            continue
        scanned += 1
        try:
            mtime = path.stat().st_mtime
        except OSError:
            skipped += 1
            continue
        if mtime > cutoff:
            skipped += 1
            continue
        if dry_run:
            removed += 1
            continue
        try:
            shutil.rmtree(path, ignore_errors=False)
            removed += 1
        except OSError as exc:
            logger.warning("temp cleanup failed path=%s err=%s", name, type(exc).__name__)
            skipped += 1

    logger.info(
        "video temp cleanup scanned=%s removed=%s skipped=%s retention_h=%s",
        scanned,
        removed,
        skipped,
        hours,
    )
    return {"scanned": scanned, "removed": removed, "skipped": skipped}
