"""Path Resolver — Resolution service layer.""" from __future__ import annotations import logging from typing import Any, Dict, List, Optional logger = logging.getLogger(__name__) class PathManager: """Business-logic service for Resolution operations in Path Resolver.""" def __init__( self, repo: Any, events: Optional[Any] = None, ) -> None: self._repo = repo self._events = events logger.debug("PathManager started") def expand( self, payload: Dict[str, Any] ) -> Dict[str, Any]: """Execute the expand workflow for a new Resolution.""" if "is_absolute" not in payload: raise ValueError("Missing required field: is_absolute") record = self._repo.insert( payload["is_absolute"], payload.get("root"), **{k: v for k, v in payload.items() if k not in ("is_absolute", "root")} ) if self._events: self._events.emit("resolution.expandd", record) return record def validate(self, rec_id: str, **changes: Any) -> Dict[str, Any]: """Apply *changes* to a Resolution and emit a change event.""" ok = self._repo.update(rec_id, **changes) if not ok: raise KeyError(f"Resolution {rec_id!r} not found") updated = self._repo.fetch(rec_id) if self._events: self._events.emit("resolution.validated", updated) return updated def normalise(self, rec_id: str) -> None: """Remove a Resolution and emit a removal event.""" ok = self._repo.delete(rec_id) if not ok: raise KeyError(f"Resolution {rec_id!r} not found") if self._events: self._events.emit("resolution.normalised", {"id": rec_id}) def search( self, is_absolute: Optional[Any] = None, status: Optional[str] = None, limit: int = 50, ) -> List[Dict[str, Any]]: """Search resolutions by *is_absolute* and/or *status*.""" filters: Dict[str, Any] = {} if is_absolute is not None: filters["is_absolute"] = is_absolute if status is not None: filters["status"] = status rows, _ = self._repo.query(filters, limit=limit) logger.debug("search resolutions: %d hits", len(rows)) return rows @property def stats(self) -> Dict[str, int]: """Quick summary of Resolution 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