UX Phase 1 follow-ups: state v2 + reset, window defaults + support, palette support; analysis JSON generation; tests for LIMIT/metadata; README updates

tests/test_reports.py

@@ -323,3 +323,93 @@ def test_multi_bucket_table(tmp_path, monkeypatch):
     entry = next(r for r in reports if r["name"] == "multi")
     assert entry["buckets"] == ["domain", "agent"]
     assert entry["bucket_label"] == ["Domain", "Agent"]
+
+
+def test_top_n_limit_applied(tmp_path, monkeypatch):
+    # Prepare DB with many distinct agents
+    db_path = tmp_path / "database" / "ngxstat.db"
+    setup_db(db_path)
+    conn = sqlite3.connect(db_path)
+    cur = conn.cursor()
+    for i in range(10):
+        cur.execute(
+            "INSERT INTO logs (ip, host, time, request, status, bytes_sent, referer, user_agent, cache_status) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
+            (
+                "127.0.0.1",
+                "example.com",
+                f"2024-01-01 11:{i:02d}:00",
+                "GET /x HTTP/1.1",
+                200,
+                100,
+                "-",
+                f"ua-{i}",
+                "MISS",
+            ),
+        )
+    conn.commit()
+    conn.close()
+
+    cfg = tmp_path / "reports.yml"
+    cfg.write_text(
+        """
+- name: agents
+  chart: table
+  global: true
+  top_n: 3
+  query: |
+    SELECT user_agent AS agent, COUNT(*) AS value
+    FROM logs
+    GROUP BY user_agent
+    ORDER BY value DESC
+"""
+    )
+
+    monkeypatch.setattr(gr, "DB_PATH", db_path)
+    monkeypatch.setattr(gr, "OUTPUT_DIR", tmp_path / "output")
+    monkeypatch.setattr(gr, "REPORT_CONFIG", cfg)
+    monkeypatch.setattr(
+        gr, "TEMPLATE_DIR", Path(__file__).resolve().parents[1] / "templates"
+    )
+
+    gr._generate_global()
+
+    data = json.loads((tmp_path / "output" / "global" / "agents.json").read_text())
+    # Should be limited to 3 rows
+    assert len(data) <= 3
+
+
+def test_metadata_passthrough(tmp_path, monkeypatch):
+    db_path = tmp_path / "database" / "ngxstat.db"
+    setup_db(db_path)
+
+    cfg = tmp_path / "reports.yml"
+    cfg.write_text(
+        """
+- name: custom_ts
+  label: Custom TS
+  chart: line
+  window_default: 24h
+  windows_supported: [1h, 24h, 7d]
+  palette: ["#111111", "#222222"]
+  query: |
+    SELECT {bucket} AS time_bucket, COUNT(*) AS value
+    FROM logs
+    GROUP BY time_bucket
+    ORDER BY time_bucket
+"""
+    )
+
+    monkeypatch.setattr(gr, "DB_PATH", db_path)
+    monkeypatch.setattr(gr, "OUTPUT_DIR", tmp_path / "output")
+    monkeypatch.setattr(gr, "REPORT_CONFIG", cfg)
+    monkeypatch.setattr(
+        gr, "TEMPLATE_DIR", Path(__file__).resolve().parents[1] / "templates"
+    )
+
+    gr._generate_interval("hourly")
+
+    reports = json.loads((tmp_path / "output" / "hourly" / "reports.json").read_text())
+    entry = next(r for r in reports if r["name"] == "custom_ts")
+    assert entry["window_default"] == "24h"
+    assert entry["windows_supported"] == ["1h", "24h", "7d"]
+    assert entry["palette"] == ["#111111", "#222222"]