service logic for facts, chunks, candidates, and current-approved-vs-target comparison

src/repo_registry/core/models.py

@@ -54,6 +54,34 @@ class ReviewDecision:
     created_at: str
 
 
+@dataclass(frozen=True)
+class AnalysisRunDiffItem:
+    change_type: str
+    item_type: str
+    key: str
+    base: dict[str, Any] | None = None
+    target: dict[str, Any] | None = None
+
+
+@dataclass(frozen=True)
+class AnalysisRunDiffSection:
+    added: list[AnalysisRunDiffItem] = field(default_factory=list)
+    removed: list[AnalysisRunDiffItem] = field(default_factory=list)
+    changed: list[AnalysisRunDiffItem] = field(default_factory=list)
+    weakened: list[AnalysisRunDiffItem] = field(default_factory=list)
+
+
+@dataclass(frozen=True)
+class AnalysisRunDiff:
+    repository: Repository
+    base_run: AnalysisRun
+    target_run: AnalysisRun
+    facts: AnalysisRunDiffSection
+    chunks: AnalysisRunDiffSection
+    candidates: AnalysisRunDiffSection
+    approved_entries: AnalysisRunDiffSection
+
+
 @dataclass(frozen=True)
 class ObservedFact:
     id: int