evaluators/manager.py

"""Linting Orchestrator — Rule service layer."""
from __future__ import annotations

import logging
from typing import Any, Dict, List, Optional

logger = logging.getLogger(__name__)


class LintingManager:
    """Business-logic service for Rule operations in Linting Orchestrator."""

    def __init__(
        self,
        repo: Any,
        events: Optional[Any] = None,
    ) -> None:
        self._repo   = repo
        self._events = events
        logger.debug("LintingManager started")

    def annotate(
        self, payload: Dict[str, Any]
    ) -> Dict[str, Any]:
        """Execute the annotate workflow for a new Rule."""
        if "message" not in payload:
            raise ValueError("Missing required field: message")
        record = self._repo.insert(
            payload["message"], payload.get("severity"),
            **{k: v for k, v in payload.items()
              if k not in ("message", "severity")}
        )
        if self._events:
            self._events.emit("rule.annotated", record)
        return record

    def merge(self, rec_id: str, **changes: Any) -> Dict[str, Any]:
        """Apply *changes* to a Rule and emit a change event."""
        ok = self._repo.update(rec_id, **changes)
        if not ok:
            raise KeyError(f"Rule {rec_id!r} not found")
        updated = self._repo.fetch(rec_id)
        if self._events:
            self._events.emit("rule.merged", updated)
        return updated

    def fix(self, rec_id: str) -> None:
        """Remove a Rule and emit a removal event."""
        ok = self._repo.delete(rec_id)
        if not ok:
            raise KeyError(f"Rule {rec_id!r} not found")
        if self._events:
            self._events.emit("rule.fixd", {"id": rec_id})

    def search(
        self,
        message: Optional[Any] = None,
        status: Optional[str] = None,
        limit:  int = 50,
    ) -> List[Dict[str, Any]]:
        """Search rules by *message* and/or *status*."""
        filters: Dict[str, Any] = {}
        if message is not None:
            filters["message"] = message
        if status is not None:
            filters["status"] = status
        rows, _ = self._repo.query(filters, limit=limit)
        logger.debug("search rules: %d hits", len(rows))
        return rows

    @property
    def stats(self) -> Dict[str, int]:
        """Quick summary of Rule counts by status."""
        result: Dict[str, int] = {}
        for status in ("active", "pending", "closed"):
            _, count = self._repo.query({"status": status}, limit=0)
            result[status] = count
        return result