Legal-tech OSINT for government accountability without speculation.

from dataclasses import dataclass, field
from enum import Enum
from typing import Literal

Confidence = Literal["high", "medium", "low"]

class EvidenceType(str, Enum):
    PRIMARY_RECORD = "primary_record"
    COURT_FILING = "court_filing"
    CORPORATE_REGISTRY = "corporate_registry"
    REPUTABLE_REPORTING = "reputable_reporting"
    PUBLIC_STATEMENT = "public_statement"
    UNVERIFIED_TIP = "unverified_tip"

@dataclass(frozen=True)
class EvidenceItem:
    source_id: str
    title: str
    evidence_type: EvidenceType
    url: str
    captured_at: str
    confidence: Confidence
    notes: str = ""

@dataclass
class AllegationMatrixRow:
    allegation: str
    supporting_evidence: list[EvidenceItem] = field(default_factory=list)
    contradicting_evidence: list[EvidenceItem] = field(default_factory=list)
    open_questions: list[str] = field(default_factory=list)

    def rating(self) -> Confidence:
        primary = [e for e in self.supporting_evidence if e.evidence_type in {
            EvidenceType.PRIMARY_RECORD,
            EvidenceType.COURT_FILING,
            EvidenceType.CORPORATE_REGISTRY,
        }]
        if len(primary) >= 2 and not self.contradicting_evidence:
            return "high"
        if self.supporting_evidence:
            return "medium"
        return "low"


def publish_guardrail(row: AllegationMatrixRow) -> dict:
    rating = row.rating()
    if rating == "low":
        return {
            "decision": "hold",
            "reason": "Insufficient verified evidence. Treat as an investigative lead only.",
            "allowed_language": "A reported allegation requires additional documentation.",
        }
    return {
        "decision": "publish_with_caveats",
        "confidence": rating,
        "required_caveats": ["not legal advice", "public-record analysis", "no finding of wrongdoing"],
    }