Similar versions: surface-overlap metric + endpoint + UI panel

Ranks catalogued engine versions by how much of their CMC_* surface they share,
which (unlike a binary fuzzy hash) stays meaningful across compilers — the golden
pair PIKLIB8/MSVC6 vs bloomoodll/MSVC8 scores 85%.

- similarity.py: jaccard, surface_similarity (per-axis + pooled overall),
  fuzzy_similarity (ssdeep via ppdeep, secondary signal)
- service.similar_snapshots + GET /snapshots/{id}/similar?min=N (SimilarHit)
- UI: "Podobne wersje" panel in the snapshot browser (overlap bar + ⇄ diff)
- tests: 6 new (jaccard, identical/disjoint, golden pair 0<x<100, fuzzy,
  endpoint + min filter) -> 28/28

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

ams/api/static/app.js

@@ -273,6 +273,9 @@ async function browse(id) {
   ];
   out.innerHTML = "";
   out.append(el("div", { class: "diff-head" }, "Przegląd: ", el("b", {}, `${snap.binary_name} [${snap.engine}/${snap.compiler}]`)));
+  const simBox = el("div", { class: "similar" });
+  out.append(simBox);
+  loadSimilar(id, simBox);
   const filter = el("input", { class: "owner browse-filter", placeholder: "filtruj…", oninput: () => render() });
   const tabbar = el("div", {});
   const list = el("div", {});
@@ -292,6 +295,27 @@ async function browse(id) {
   render();
 }
 
+async function loadSimilar(targetId, box) {
+  let hits;
+  try { hits = await jget("/snapshots/" + targetId + "/similar"); }
+  catch { return; }  // endpoint absent / single-snapshot catalog — just show nothing
+  if (!hits.length) return;
+  box.append(el("div", { class: "similar-title" }, "Podobne wersje (overlap powierzchni)"));
+  for (const h of hits.slice(0, 6)) {
+    const s = h.snapshot;
+    const bar = el("span", { class: "simbar" },
+      el("span", { class: "simfill", style: "width:" + h.overall + "%" }));
+    box.append(el("div", { class: "simrow" },
+      el("span", { class: "simscore" }, h.overall + "%"),
+      bar,
+      el("span", { class: "simname", title: "przejrzyj", onclick: () => browse(s.id) },
+        `${s.binary_name} [${s.engine || "?"}]`),
+      h.fuzzy != null ? el("span", { class: "simfuzzy", title: "ssdeep binarki" }, "fuzzy " + h.fuzzy) : null,
+      el("span", { class: "simdiff", title: "porównaj tę wersję z aktualną",
+        onclick: () => { state.a = targetId; state.b = s.id; refreshSelection(); compare(); } }, "⇄ diff")));
+  }
+}
+
 // --- boot -------------------------------------------------------------------------------------
 $("compare").addEventListener("click", compare);
 $("owner").addEventListener("keydown", (e) => { if (e.key === "Enter") compare(); });

ams/api/static/style.css

@@ -100,6 +100,19 @@ body { background: var(--bg); color: var(--fg); font: 13px/1.45 var(--mono); }
 .empty { color: var(--dim); font-style: italic; }
 .moved { color: var(--accent); }
 
+.similar { margin: 4px 0 16px; }
+.similar-title { color: var(--dim); text-transform: uppercase; font-size: 11px; letter-spacing: 1px; margin-bottom: 6px; }
+.simrow { display: flex; align-items: center; gap: 10px; padding: 4px 0; }
+.simscore { width: 38px; text-align: right; color: var(--accent); font-weight: 600; }
+.simbar { flex: 0 0 120px; height: 7px; background: #16202c; border: 1px solid var(--border);
+  border-radius: 4px; overflow: hidden; }
+.simfill { display: block; height: 100%; background: linear-gradient(90deg, var(--accent2), var(--add)); }
+.simname { flex: 1; min-width: 0; color: var(--fg); cursor: pointer; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.simname:hover { color: var(--accent); text-decoration: underline; }
+.simfuzzy { color: var(--dim); font-size: 11px; }
+.simdiff { color: var(--accent); cursor: pointer; font-size: 11px; }
+.simdiff:hover { text-decoration: underline; }
+
 .browse-filter { margin-bottom: 10px; }
 .btab { display: inline-block; padding: 4px 10px; margin-right: 6px; border: 1px solid var(--border);
   border-radius: 6px; cursor: pointer; color: var(--dim); }