sud-cli 0.1.1__py3-none-any.whl

sud_cli/court_alerts.py

@@ -0,0 +1,156 @@
+"""W6a §4 (S-60): локальные алерты case-search → bus-free a2a-строки.
+
+Эталон паттерна — reminders.py (the wave): sud-cli НИКОГДА не вызывает шину a2a
+сам и вообще не запускает внешние процессы. Модуль читает artifacts
+case_search (alert-файлы и dedup-store), фильтрует окно по created_at и
+печатает готовые shlex-экранированные строки `a2a mail send ...`. Исполняет
+строку оператор или агент-планировщик, вне sud.
+
+Числа в теле письма есть => строка несёт --verify "<детерминированная
+команда>" --verify-run (политика a2a, как в the wave).
+
+Пустой список — пустой вывод ([]), а не ошибка: отсутствие новостей по суду
+не повод падать.
+"""
+from __future__ import annotations
+
+import json
+from datetime import date, timedelta
+from pathlib import Path
+from typing import List
+
+BUS_FREE_NOTE = (
+    "bus-free: sud-cli не вызывает a2a; ниже готовые экранированные строки "
+    "команд — исполнение остаётся за оператором"
+)
+
+VERIFY_CMD_TEMPLATE = "/usr/bin/sud-cli case-search alerts --days {days} --json"
+
+#: dedup-store лежит в каталоге алертов и не является alert-файлом.
+SEEN_STORE_NAME = "seen_fingerprints.json"
+
+
+def alerts_search_dirs(state_dir) -> List[Path]:
+    """Кандидатские каталоги алертов: sud-state и стандартный cwd-root cw."""
+    dirs = [Path(state_dir) / "case-search-alerts"]
+    cw_root = Path.cwd() / ".case-search" / "alerts"
+    if cw_root not in dirs:
+        dirs.append(cw_root)
+    return dirs
+
+
+def _alert_files(alerts_dir: Path) -> List[Path]:
+    if not alerts_dir.is_dir():
+        return []
+    return sorted(p for p in alerts_dir.glob("*.json") if p.name != SEEN_STORE_NAME)
+
+
+def load_alert_files(alerts_dir) -> List[dict]:
+    """Прочитать alert-файлы; битые/чужие JSON молча пропускаются (не угадываем)."""
+    out: List[dict] = []
+    for path in _alert_files(Path(alerts_dir)):
+        try:
+            data = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, ValueError, UnicodeDecodeError):
+            continue
+        if not isinstance(data, dict) or "case_number" not in data or "created_at" not in data:
+            continue
+        out.append(data)
+    return out
+
+
+def recent_alerts(alerts: List[dict], today: date, days: int) -> List[dict]:
+    """Алерты, созданные в окне [today-days, today]; детерминированный порядок."""
+    floor_day = today - timedelta(days=days)
+    kept = []
+    for a in alerts:
+        raw = str(a.get("created_at") or "")
+        try:
+            created = date.fromisoformat(raw[:10])
+        except ValueError:
+            continue
+        if floor_day <= created <= today:
+            kept.append(a)
+    kept.sort(key=lambda a: (str(a.get("created_at") or ""), str(a.get("case_number")),
+                             str(a.get("status"))))
+    return kept
+
+
+def a2a_command(alert: dict, days: int) -> str:
+    """Одна готовая строка a2a mail send; все значения экранированы shlex."""
+    import shlex
+    case_number = alert.get("case_number")
+    status = alert.get("status")
+    reason = alert.get("reason")
+    changes = alert.get("changes") or []
+    paths = "; ".join(str(c.get("path")) for c in changes[:5] if isinstance(c, dict))
+    subject = f"case-search: {case_number} — {status}"
+    body = (
+        f"Локальный алерт case-search: дело {case_number}, статус {status}, "
+        f"причина: {reason}; изменений: {len(changes)}. "
+        + (f"Пути: {paths}. " if paths else "")
+        + f"Окно выборки: {days} дн. Повторная сверка: {VERIFY_CMD_TEMPLATE.format(days=days)} "
+          "Алерт может устареть к моменту отправки — проверь артефакты до исполнения строки."
+    )
+    verify = VERIFY_CMD_TEMPLATE.format(days=days)
+    parts = [
+        "a2a", "mail", "send",
+        "--to", "colleague-legal",
+        "--priority", "today",
+        "--subject", subject,
+        "--body", body,
+        "--verify", verify,
+        "--verify-run",
+    ]
+    return " ".join(shlex.quote(p) for p in parts)
+
+
+def generate_mail_commands(alerts: List[dict], days: int) -> List[str]:
+    return [a2a_command(a, days) for a in alerts]
+
+
+def alerts_payload(alerts_dir, today: date, days: int) -> dict:
+    """Собрать готовый payload команды (используется CLI и MCP одним кодом)."""
+    raw = load_alert_files(alerts_dir)
+    recent = recent_alerts(raw, today, days)
+    return {
+        "days": days,
+        "today": today.isoformat(),
+        "source_dir": str(alerts_dir),
+        "total_files": len(raw),
+        "alerts": recent,
+        "commands": generate_mail_commands(recent, days),
+        "bus_free": BUS_FREE_NOTE,
+    }
+
+
+def count_pending_alerts(state_dir) -> int:
+    """Сколько алертов ещё не переданы в шину (fingerprint нет в dedup-store).
+
+    Только чтение локальных файлов; шина не трогается. Для doctor-счётчика.
+    """
+    from .case_search.alerts import Alert
+    from .case_search.alerts_dedup import (
+        alert_fingerprint,
+        default_seen_path,
+        load_seen_fingerprints,
+    )
+
+    seen = set(load_seen_fingerprints(default_seen_path()))
+    pending = 0
+    for alerts_dir in alerts_search_dirs(state_dir):
+        store = alerts_dir / SEEN_STORE_NAME
+        if store != default_seen_path():
+            seen |= set(load_seen_fingerprints(store))
+        for raw in load_alert_files(alerts_dir):
+            alert = Alert(
+                case_number=str(raw.get("case_number")),
+                status=str(raw.get("status") or ""),
+                reason=str(raw.get("reason") or ""),
+                changes=list(raw.get("changes") or []),
+                destination=str(raw.get("destination") or "local-file"),
+                created_at=str(raw.get("created_at") or ""),
+            )
+            if alert_fingerprint(alert.case_number, alert) not in seen:
+                pending += 1
+    return pending

sud_cli/court_source.py

@@ -0,0 +1,108 @@
+"""Transport-agnostic court-source adapter contract.
+
+Phase 3 defines the contract and provides one offline synthetic adapter only.
+No live court source is implemented.
+"""
+
+import datetime
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Protocol
+
+STATUS_OK = "ok"
+STATUS_NO_RESULTS = "no_results"
+STATUS_UNAVAILABLE = "unavailable"
+STATUS_BLOCKED = "blocked"
+STATUS_ERROR = "error"
+
+
+@dataclass(frozen=True)
+class CourtProviderResult:
+    """Normalized result from any court-source adapter."""
+
+    status: str
+    items: List[Dict[str, Any]]
+    source: str
+    source_url: Optional[str] = None
+    fetched_at: Optional[str] = None
+    pagination: Dict[str, Any] = field(
+        default_factory=lambda: {
+            "page": 1,
+            "page_size": 10,
+            "total": 0,
+            "pages_total": 0,
+            "limit": 10,
+        }
+    )
+    error_message: Optional[str] = None
+
+
+class CourtSource(Protocol):
+    """Transport-agnostic adapter protocol for live and offline court sources."""
+
+    def fetch_case(self, case_id: str, **kwargs: Any) -> CourtProviderResult:
+        ...
+
+    def search_cases(
+        self, query: str, page: int = 1, page_size: int = 10, **kwargs: Any
+    ) -> CourtProviderResult:
+        ...
+
+
+class LocalJsonCourtSource:
+    """Offline synthetic fixture source.
+
+    Reads local JSON files in the native ``cases``/``events`` schema and
+    returns a typed ``CourtProviderResult``. No network access is performed.
+    """
+
+    def __init__(self, source_label: str = "local-synthetic-json"):
+        self.source_label = source_label
+
+    def import_file(self, path: Path) -> CourtProviderResult:
+        from sud_cli.importing import CourtImportError, load_court_case_fixture
+
+        try:
+            cases = load_court_case_fixture(Path(path))
+        except CourtImportError as exc:
+            return CourtProviderResult(
+                status=STATUS_ERROR,
+                items=[],
+                source=self.source_label,
+                error_message=str(exc),
+            )
+        except Exception as exc:
+            return CourtProviderResult(
+                status=STATUS_ERROR,
+                items=[],
+                source=self.source_label,
+                error_message=f"unexpected import error: {exc}",
+            )
+
+        if not cases:
+            return CourtProviderResult(
+                status=STATUS_NO_RESULTS,
+                items=[],
+                source=self.source_label,
+                error_message="no cases in fixture",
+            )
+
+        return CourtProviderResult(
+            status=STATUS_OK,
+            items=cases,
+            source=self.source_label,
+            fetched_at=_utc_now(),
+            pagination={
+                "page": 1,
+                "page_size": len(cases),
+                "total": len(cases),
+                "pages_total": 1,
+                "limit": len(cases),
+            },
+        )
+
+
+def _utc_now() -> str:
+    return (
+        datetime.datetime.now(tz=datetime.timezone.utc).replace(microsecond=0).isoformat()
+    )

sud_cli/data/completeness_rules.json

@@ -0,0 +1,18 @@
+{
+  "meta": {
+    "format": "format-checklist",
+    "generated_note": "the wave §3 (S-71): структурный чек-лист комплектности документов дела.",
+    "disclaimer": "Это формальная проверка структуры шаблона против списка маркеров. Это НЕ юридическая проверка достаточности документов, не юридическая консультация и не норма: ни один маркер ничего не утверждает о требованиях закона. Решение о комплектности остаётся за человеком."
+  },
+  "marker_hints": {
+    "шапка": "в шапке ожидаются блоки [суд], [истец], [ответчик]",
+    "Обжалуется": "для апелляционных форм: блок с обжалуемым судебным актом",
+    "Основания": "для апелляционных форм: блок с доводами (без нормативных ссылок)"
+  },
+  "kinds": {
+    "isk_apk": ["шапка", "Просьба", "Приложения", "Подпись", "Дата"],
+    "claim_apk": ["шапка", "Просьба", "Приложения", "Подпись", "Дата"],
+    "appeal_apk": ["шапка", "Обжалуется", "Основания", "Просьба", "Приложения", "Подпись", "Дата"],
+    "hodat": ["шапка", "Просьба", "Подпись", "Дата"]
+  }
+}

sud_cli/data/key_rates.json

@@ -0,0 +1,59 @@
+{
+  "provenance": "Ставки ЦБ РФ, периоды пересмотра; источник — та же доктрина, что legal_rules.json (JSON единственный источник). Сгенерировано 2026-10-22 из embedded-константы v2.3.1; обновлять по постановлениям ЦБ.",
+  "coverage_first": "2023-07-24",
+  "coverage_latest_change": "2026-06-15",
+  "periods": [
+    [
+      "2026-06-15",
+      "18"
+    ],
+    [
+      "2026-02-16",
+      "15"
+    ],
+    [
+      "2025-12-22",
+      "16"
+    ],
+    [
+      "2025-09-15",
+      "17"
+    ],
+    [
+      "2025-06-09",
+      "20"
+    ],
+    [
+      "2024-12-16",
+      "21"
+    ],
+    [
+      "2024-10-28",
+      "21"
+    ],
+    [
+      "2024-09-16",
+      "19"
+    ],
+    [
+      "2024-07-29",
+      "18"
+    ],
+    [
+      "2024-06-10",
+      "16"
+    ],
+    [
+      "2024-04-29",
+      "16"
+    ],
+    [
+      "2023-09-18",
+      "13"
+    ],
+    [
+      "2023-07-24",
+      "8.5"
+    ]
+  ]
+}

sud_cli/data/npa_historical_editions.json

@@ -0,0 +1,19 @@
+{
+  "gk_rf": {
+    "196": [{"effective_date": "1995-01-01", "federal_law": "ГК РФ (часть первая)", "text": "Общий срок исковой давности устанавливается в три года.", "notes": "Редакция на дату запроса определяется по последнему изменению."}],
+    "200": [{"effective_date": "1995-01-01", "federal_law": "ГК РФ (часть первая)", "text": "Течение срока исковой давности начинается со дня, когда лицо узнало или должно было узнать о нарушении своего права.", "notes": "Общее правило о начале течения срока."}],
+    "395": [
+      {"effective_date": "1995-01-01", "federal_law": "ГК РФ (часть первая)", "text": "За пользование чужими денежными средствами вследствие их неправомерного удержания подлежат уплате проценты.", "notes": "Базовая редакция."},
+      {"effective_date": "2016-08-01", "federal_law": "Федеральный закон от 03.07.2016 № 315-ФЗ", "text": "За пользование чужими денежными средствами вследствие их неправомерного удержания, уклонения от их возврата, иной просрочки в их уплате либо неосновательного получения или сбережения за счет другого лица подлежат уплате проценты.", "notes": "Редакция после реформы обязательственного права."}
+    ]
+  },
+  "uk_rf": {
+    "159": [
+      {"effective_date": "1996-06-13", "federal_law": "Федеральный закон от 13.06.1996 № 63-ФЗ", "text": "Мошенничество, то есть хищение чужого имущества или приобретение права на чужое имущество путем обмана или злоупотребления доверием.", "notes": "Базовая редакция УК РФ."},
+      {"effective_date": "2003-12-16", "federal_law": "Федеральный закон от 08.12.2003 № 162-ФЗ", "text": "Мошенничество, то есть хищение чужого имущества или приобретение права на чужое имущество путем обмана или злоупотребления доверием.", "notes": "Редакция после изменений Общей и Особенной частей УК РФ."}
+    ]
+  },
+  "nk_rf": {
+    "333.19": [{"effective_date": "2000-08-05", "federal_law": "Федеральный закон от 05.08.2000 № 117-ФЗ", "text": "Размеры государственной пошлины по делам, рассматриваемым судами общей юрисдикции.", "notes": "Тарифы могли изменяться последующими федеральными законами."}]
+  }
+}