Create ingest/timeline.py

ingest/timeline.py

@@ -1,31 +1,26 @@
-import plotly.graph_objects as go
+from collections import defaultdict
 from datetime import datetime
 
-
-def build_timeline_figure(results):
-    dates = []
-    labels = []
+def release_timeline(results):
+    """
+    Aggregate histogram by year-month.
+    Safe for HF: no user tracking, no persistence.
+    """
+    buckets = defaultdict(int)
 
     for r in results:
+        date_str = r.get("date")
+        if not date_str:
+            continue
+
         try:
-            dates.append(datetime.fromisoformat(r["date"]))
+            dt = datetime.fromisoformat(date_str[:10])
+            key = dt.strftime("%Y-%m")
+            buckets[key] += 1
         except Exception:
             continue
-        labels.append(r["title"])
 
-    fig = go.Figure(
-        data=[
-            go.Scatter(
-                x=dates,
-                y=list(range(len(dates))),
-                mode="markers",
-                text=labels
-            )
-        ],
-        layout=go.Layout(
-            title="Document Release Timeline",
-            xaxis_title="Release Date",
-            yaxis_title="Document Index"
-        )
-    )
-    return fig
+    return [
+        {"Period": k, "Documents": v}
+        for k, v in sorted(buckets.items())
+    ]