From 062a501a6c8f1cfc0105fda5c60360d4daaaf8c8 Mon Sep 17 00:00:00 2001
From: Aleff <alessandro.greco.1@protonmail.com>
Date: Mon, 21 Sep 2026 16:38:06 +0200
Subject: [PATCH 1/6] Accept topology views in the web server

---
 src/wayparam/gui/server.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/wayparam/gui/server.py b/src/wayparam/gui/server.py
index e6e79ea..7b1890b 100644
--- a/src/wayparam/gui/server.py
+++ b/src/wayparam/gui/server.py
@@ -84,7 +84,8 @@ def config_from_request(data: dict) -> RunConfig:
     analysis = cast(
         Optional[AnalysisMode],
         raw_analysis
-        if raw_analysis in ("history", "params", "summary", "timeline", "changes")
+        if raw_analysis
+        in ("history", "params", "summary", "timeline", "changes", "topology", "cooccurrence")
         else None,
     )
     if analysis and sources != ("wayback",):

From 36fc39c4a362ee262b6503b013ca00e6777d03b3 Mon Sep 17 00:00:00 2001
From: Aleff <alessandro.greco.1@protonmail.com>
Date: Mon, 21 Sep 2026 16:38:09 +0200
Subject: [PATCH 2/6] Add topology views to the web UI

---
 src/wayparam/gui/index.html | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/wayparam/gui/index.html b/src/wayparam/gui/index.html
index 0cc6c8b..f4352be 100644
--- a/src/wayparam/gui/index.html
+++ b/src/wayparam/gui/index.html
@@ -116,6 +116,8 @@
           <option value="summary">Domain summary</option>
           <option value="timeline">Temporal timeline</option>
           <option value="changes">Temporal changes</option>
+          <option value="topology">Surface topology</option>
+          <option value="cooccurrence">Parameter co-occurrence</option>
         </select></label>
       <div class="row" id="changes_periods">
         <label><span>Baseline period</span>
@@ -277,7 +279,7 @@
 
     const view = $("analysis");
     for (const option of view.options) {
-      if (["history", "params", "summary", "timeline", "changes"].includes(option.value)) {
+      if (["history", "params", "summary", "timeline", "changes", "topology", "cooccurrence"].includes(option.value)) {
         option.disabled = source !== "wayback";
       } else if (option.value === "source_summary") {
         option.disabled = !multiSource;
@@ -289,7 +291,7 @@
 
   function syncModeControls() {
     const mode = val("analysis");
-    const historical = ["history", "params", "summary", "timeline", "changes"].includes(mode);
+    const historical = ["history", "params", "summary", "timeline", "changes", "topology", "cooccurrence"].includes(mode);
     const sourceSummary = mode === "source_summary";
     const timeline = mode === "timeline";
     const changes = mode === "changes";

From d232107d891047a1818758adbd47f14823450940 Mon Sep 17 00:00:00 2001
From: Aleff <alessandro.greco.1@protonmail.com>
Date: Mon, 21 Sep 2026 16:38:11 +0200
Subject: [PATCH 3/6] Test topology views in the web UI

---
 tests/test_gui.py | 71 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/tests/test_gui.py b/tests/test_gui.py
index 0372489..714825d 100644
--- a/tests/test_gui.py
+++ b/tests/test_gui.py
@@ -110,6 +110,14 @@ def test_analysis_mode_is_sanitized():
     )
     assert changes.analysis == "changes"
     assert changes.compare_periods == ("2020", "2024")
+    assert (
+        config_from_request({"domains": "example.com", "analysis": "topology"}).analysis
+        == "topology"
+    )
+    assert (
+        config_from_request({"domains": "example.com", "analysis": "cooccurrence"}).analysis
+        == "cooccurrence"
+    )
     assert config_from_request({"domains": "example.com", "analysis": "other"}).analysis is None
 
 
@@ -531,6 +539,69 @@ async def fake_history(cfg, *, on_progress=None):
     )
 
 
+@pytest.mark.parametrize(
+    ("mode", "expected_type"),
+    [
+        ("topology", "topology"),
+        ("cooccurrence", "cooccurrence"),
+    ],
+)
+def test_surface_intelligence_views_are_streamed_from_gui(
+    server, monkeypatch, mode, expected_type
+):
+    port, token = server
+
+    async def fake_history(cfg, *, on_progress=None):
+        history = DomainHistory(domain=cfg.domains[0], fetched=2)
+        history.add(
+            "https://example.com/item?id=FUZZ&lang=FUZZ",
+            CaptureRecord(
+                original="https://example.com/item?id=1&lang=en",
+                timestamp="20200102030405",
+                status_code="200",
+                mime_type="text/html",
+            ),
+        )
+        history.add(
+            "https://example.com/item?id=FUZZ&q=FUZZ",
+            CaptureRecord(
+                original="https://example.com/item?id=2&q=test",
+                timestamp="20240102030405",
+                status_code="200",
+                mime_type="text/html",
+            ),
+        )
+        return HistoryRunResult(
+            stats=[DomainStats(cfg.domains[0], fetched=2, kept=2)],
+            analyses={cfg.domains[0]: history},
+        )
+
+    monkeypatch.setattr("wayparam.gui.server.run_history", fake_history)
+    events = _stream(
+        port,
+        token,
+        {
+            "domains": "example.com",
+            "analysis": mode,
+            "format": "jsonl",
+        },
+    )
+
+    analyses = [event for event in events if event["type"] == "analysis"]
+    assert events[0]["analysis"] == mode
+    assert analyses
+    assert all(event["mode"] == mode for event in analyses)
+    assert analyses[0]["record"]["type"] == expected_type
+
+    if mode == "topology":
+        assert analyses[0]["record"]["host"] == "example.com"
+        assert analyses[0]["record"]["path"] == "/item"
+        assert analyses[0]["record"]["parameters"] == ["id", "lang", "q"]
+    else:
+        pairs = {tuple(event["record"]["parameters"]) for event in analyses}
+        assert pairs == {("id", "lang"), ("id", "q")}
+
+
 def test_gui_provenance_reaches_config():
     cfg = config_from_request(
         {

From a95ef01b1f819e6c8c1e379539f88151da34bd8d Mon Sep 17 00:00:00 2001
From: Aleff <alessandro.greco.1@protonmail.com>
Date: Mon, 21 Sep 2026 16:38:15 +0200
Subject: [PATCH 4/6] Document topology views in the web UI

---
 docs/historical-analysis.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/historical-analysis.md b/docs/historical-analysis.md
index 87717da..3d76175 100644
--- a/docs/historical-analysis.md
+++ b/docs/historical-analysis.md
@@ -237,6 +237,8 @@ The local web interface exposes the same historical views from the **View** sele
 - Domain summary
 - Temporal timeline
 - Temporal changes
+- Surface topology
+- Parameter co-occurrence
 
 When **Temporal changes** is selected, enter a baseline and comparison period using
 the same `YYYY` or `YYYYMM` rules as `--changes`.

From e72646f7a0791c036223a15c381dda9603d4c1b3 Mon Sep 17 00:00:00 2001
From: Aleff <alessandro.greco.1@protonmail.com>
Date: Mon, 21 Sep 2026 16:38:18 +0200
Subject: [PATCH 5/6] Document topology views in the web UI

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 65e0a0e..7ce0f81 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@
 ## Unreleased
 - Added `--topology` historical surface topology analysis, grouping archive evidence by host/path with observed schemes, normalized URL variants, parameter unions and deterministic parameter-set variants
 - Added `--cooccurrence` to report unordered parameter pairs observed together, with normalized URL, route, capture and first/last-seen evidence
+- Exposed surface topology and parameter co-occurrence in the local web UI using the shared historical-analysis core
 
 ## 0.8.0
 - Added `--timeline` historical analysis with deterministic year/month buckets for accepted captures, observed/new normalized URLs, and observed/new parameter names

From 483f92fda915961f5e46dcf958116d2fc4339347 Mon Sep 17 00:00:00 2001
From: Aleff <alessandro.greco.1@protonmail.com>
Date: Mon, 21 Sep 2026 16:39:22 +0200
Subject: [PATCH 6/6] Apply ruff formatting to GUI topology tests

---
 tests/test_gui.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/tests/test_gui.py b/tests/test_gui.py
index 714825d..24fb5ca 100644
--- a/tests/test_gui.py
+++ b/tests/test_gui.py
@@ -546,9 +546,7 @@ async def fake_history(cfg, *, on_progress=None):
         ("cooccurrence", "cooccurrence"),
     ],
 )
-def test_surface_intelligence_views_are_streamed_from_gui(
-    server, monkeypatch, mode, expected_type
-):
+def test_surface_intelligence_views_are_streamed_from_gui(server, monkeypatch, mode, expected_type):
     port, token = server
 
     async def fake_history(cfg, *, on_progress=None):