Upload explanation.py with huggingface_hub

explanation.py

@@ -25,6 +25,9 @@ def generate_forensic_report(verdict: ForensicVerdict) -> str:
     elif verdict.verdict == "SUSPICIOUS":
         verdict_emoji = "🟡"
         verdict_color = "yellow"
+    elif verdict.verdict == "INCONCLUSIVE":
+        verdict_emoji = "⚪"
+        verdict_color = "gray"
     elif verdict.verdict == "LIKELY AUTHENTIC":
         verdict_emoji = "🟢"
         verdict_color = "lightgreen"
@@ -99,7 +102,57 @@ def generate_forensic_report(verdict: ForensicVerdict) -> str:
 - **Calibration:** Temperature-scaled (τ=1.3) for ECE < 0.02
 - **Independence Correction:** Applied with α=0.3 correlation penalty
 
----
+"""
+    
+    # Fix 5: Add modality disclosure when suppression was active
+    modality_info = verdict.reasoning_tree.get("modality", {})
+    detected_modality = modality_info.get("detected", "UNKNOWN")
+    n_adjustments = modality_info.get("adjustments_applied", 0)
+    
+    if detected_modality != "UNKNOWN" and n_adjustments > 0:
+        modality_labels = {
+            "PORTRAIT_MODE": "smartphone portrait/bokeh mode",
+            "MESSAGING": "messaging app (WhatsApp, Telegram, etc.)",
+            "SOCIAL_MEDIA": "social media platform",
+            "SCREENSHOT": "screen capture",
+            "SMARTPHONE": "standard smartphone camera",
+            "DSLR": "DSLR/mirrorless camera",
+        }
+        label = modality_labels.get(detected_modality, detected_modality)
+        
+        report += f"""---
+
+## 📱 Capture Modality Notice
+
+**Detected modality:** {label} (confidence: {modality_info.get('confidence', 0):.0%})
+
+This image appears to have been captured with **{label}**. {n_adjustments} forensic tests
+have been recalibrated to account for known characteristics of this capture modality that
+would otherwise produce false positive signals.
+
+"""
+        if detected_modality == "PORTRAIT_MODE":
+            report += """**Portrait mode disclosure:** Smartphone portrait/bokeh mode uses computational
+neural depth estimation to synthetically blur the background. This produces artifacts
+(autocorrelation peaks, uniform noise regions, abrupt blur transitions, patch-based
+segmentation boundaries) that mimic AI-generation signatures but are normal features
+of authentic portrait mode photography. The following tests have been suppressed:
+Autocorrelation Peak, Texture Repetition, VAE Patch Boundaries, PRNU Uniformity,
+DoF Consistency, Vignetting, HF Noise Structure, Noise Spatial Frequency, CFA Nyquist,
+and Poisson-Gaussian Model.
+
+"""
+        elif detected_modality == "MESSAGING":
+            report += """**Messaging compression disclosure:** Images transmitted via messaging apps are
+re-encoded with lossy JPEG compression and have all EXIF metadata stripped. This produces
+double-compression artifacts and missing metadata that mimic manipulation signatures but
+are normal for images shared via WhatsApp, Telegram, Signal, etc. The following tests have
+been suppressed: EXIF Completeness, Compression Ghosts, ICC Profile, Maker Note,
+Thumbnail Check, Software Detection, JPEG Quantization, and CFA Nyquist.
+
+"""
+
+    report += f"""---
 
 ## ⚖️ Methodology Statement
 
@@ -184,6 +237,9 @@ def generate_court_brief(verdict: ForensicVerdict) -> str:
     if verdict.verdict in ["FAKE", "LIKELY FAKE"]:
         conclusion = "the analyzed media exhibits multiple physical and statistical anomalies inconsistent with authentic photographic capture"
         recommendation = "This evidence supports the conclusion that the media has been synthetically generated or significantly manipulated."
+    elif verdict.verdict == "INCONCLUSIVE":
+        conclusion = "the forensic evidence is insufficient to determine whether the media is authentic or manipulated. The posterior probability is near the prior (50%), indicating the evidence contributed no net signal in either direction"
+        recommendation = "No determination can be made from this analysis. The evidence neither supports nor contradicts authenticity. Additional forensic examination with access to the original capture device or higher-resolution source material is recommended."
     elif verdict.verdict == "SUSPICIOUS":
         conclusion = "the analyzed media exhibits some anomalies that warrant further investigation"
         recommendation = "Additional forensic examination by a qualified expert is recommended before drawing conclusions."