Add review, discover, email; rebuild the design system

Three features and a typographic pass over everything.

REVIEW. Picking a file and trusting it are different questions, so they now
use different numbers. The existing rank decides which candidate to fetch and
is right to weigh peer upload slots and queue length -- but none of that says
anything about whether the file is the correct recording, and a fast peer must
not be able to raise the confidence of a wrong match. So confidence() scores
the filename alone: title 0.75, artist 0.25, album +0.05, and a variant tag
you did not ask for multiplies by 0.8 AND caps below the auto threshold.

Confidence gates the IMPORT, not the download. The transfer completes either
way and the file waits in downloads, so approving is instant and rejecting is
a delete. Holding the transfer instead would mean the peer is usually gone by
the time anyone looks.

The two cases it exists for: "02 Creep.flac" in an unsorted folder scores 0.75
-- title exactly right, artist simply absent, the commonest honest case there
is -- and must be reviewed rather than binned. And "Creep (Live at
Glastonbury)" scores 0.80 with BOTH artist and title perfect; the cap is what
stops a live recording auto-filing over the studio version. Ask for "Creep
(Acoustic)" and it auto-imports at 0.97, because then the variant is the
request.

DISCOVER. Related artists seeded from what you have actually imported, plus a
recap of top artists, genres and decades. Built on muse's own request history,
never on listening data: Navidrome owns play counts and history, and a second
source of truth for those would disagree with the one you listen through.

EMAIL. Optional, off unless MUSE_SMTP_HOST is set. Sends on import and on
review-needed. smtplib is blocking so it runs off the event loop, and every
failure is logged and swallowed -- a notification is never worth failing an
import over. Google accounts need no configuration, since the identity is an
address. Each user owns their own setting under Settings, deliberately not an
admin route: an address you cannot change yourself is someone else's chore.

DESIGN. A real type scale (display/title/headline/body/callout/caption) whose
tracking tightens as size grows, which is the single biggest tell of typography
nobody set. Specular top edges on glass surfaces -- blur alone reads as a grey
rectangle. A two-part elevation scale, contact shadow plus soft light. Semantic
colours are now per-theme: the amber tuned for the dark background failed
contrast outright on white, which was exactly the text a reviewer most needs to
read. The tab underline became a sliding pill so the eye tracks one object, and
Review only appears when something is actually waiting.

Add tests/test_matching.py: 13 assertions on the confidence bands rather than
the exact scores. 90 tests pass across the three suites.

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

web/components/review.tsx

@@ -0,0 +1,215 @@
+"use client";
+
+import * as React from "react";
+import { AnimatePresence, motion } from "framer-motion";
+import { Check, FileAudio, ShieldQuestion, X } from "lucide-react";
+
+import { api, bytes, type ReviewItem } from "@/lib/api";
+import { useToast } from "@/components/toast";
+import { Button } from "@/components/ui/button";
+import { Skeletons } from "@/components/skeletons";
+import { cn } from "@/lib/utils";
+
+/**
+ * Downloads that finished but did not clearly match what was asked for.
+ *
+ * The file is already on disk — confidence gates the *import*, not the
+ * transfer — so approving is instant and rejecting is a delete. Holding the
+ * download instead would mean the peer has usually vanished by the time
+ * anyone looks.
+ */
+export function Review({ onDecided }: { onDecided: () => void }) {
+  const [items, setItems] = React.useState<ReviewItem[] | null>(null);
+  const [err, setErr] = React.useState<string | null>(null);
+
+  const load = React.useCallback(() => {
+    api
+      .review()
+      .then((r) => setItems(r.items))
+      .catch((e) => setErr((e as Error).message));
+  }, []);
+
+  React.useEffect(() => {
+    load();
+    const t = setInterval(load, 8000);
+    return () => clearInterval(t);
+  }, [load]);
+
+  if (err) return <div className="py-12 text-center text-dim">{err}</div>;
+  if (!items) return <Skeletons n={3} />;
+
+  if (items.length === 0)
+    return (
+      <motion.div
+        initial={{ opacity: 0, y: 10 }}
+        animate={{ opacity: 1, y: 0 }}
+        className="px-5 py-16 text-center"
+      >
+        <div
+          className="mx-auto mb-4 grid h-14 w-14 place-items-center rounded-[18px]
+                     border border-edge bg-[var(--glass)] text-dim"
+        >
+          <Check className="h-6 w-6" />
+        </div>
+        <h2 className="text-title">Nothing to review</h2>
+        <p className="mx-auto mt-1.5 max-w-[44ch] text-callout text-dim">
+          Anything muse wasn&rsquo;t confident about lands here before it reaches your
+          library. An empty list means every match was unambiguous.
+        </p>
+      </motion.div>
+    );
+
+  return (
+    <div className="flex flex-col gap-3">
+      <motion.p
+        initial={{ opacity: 0 }}
+        animate={{ opacity: 1 }}
+        className="text-callout text-dim"
+      >
+        {items.length} download{items.length === 1 ? "" : "s"} finished but didn&rsquo;t
+        clearly match the request. Each file is already on disk — approving files it
+        into your library, rejecting deletes it.
+      </motion.p>
+
+      <AnimatePresence initial={false} mode="popLayout">
+        {items.map((it) => (
+          <ReviewCard key={it.id} item={it} refresh={load} onDecided={onDecided} />
+        ))}
+      </AnimatePresence>
+    </div>
+  );
+}
+
+function ReviewCard({
+  item,
+  refresh,
+  onDecided,
+}: {
+  item: ReviewItem;
+  refresh: () => void;
+  onDecided: () => void;
+}) {
+  const toast = useToast();
+  const [busy, setBusy] = React.useState(false);
+
+  const decide = async (action: "approve" | "reject") => {
+    setBusy(true);
+    try {
+      await api.decide(item.id, action);
+      toast(action === "approve" ? `Filed ${item.title}` : `Deleted ${item.file}`);
+      refresh();
+      onDecided();
+    } catch (e) {
+      toast((e as Error).message, true);
+      setBusy(false);
+    }
+  };
+
+  const pct = Math.round((item.confidence ?? 0) * 100);
+  const reasons = (item.why ?? "").split(";").map((s) => s.trim()).filter(Boolean);
+
+  return (
+    <motion.div
+      layout
+      initial={{ opacity: 0, y: 10 }}
+      animate={{ opacity: 1, y: 0 }}
+      exit={{ opacity: 0, scale: 0.97, transition: { duration: 0.18 } }}
+      transition={{ type: "spring", stiffness: 340, damping: 30 }}
+      className="glass rounded-panel p-4 sm:p-5"
+    >
+      <div className="flex gap-4">
+        {item.cover ? (
+          /* eslint-disable-next-line @next/next/no-img-element */
+          <img
+            src={item.cover}
+            alt=""
+            className="h-16 w-16 shrink-0 rounded-glass border border-edge object-cover"
+          />
+        ) : (
+          <div
+            className="grid h-16 w-16 shrink-0 place-items-center rounded-glass
+                       border border-edge bg-faint text-dim"
+          >
+            <FileAudio className="h-6 w-6" />
+          </div>
+        )}
+
+        <div className="min-w-0 flex-1">
+          <div className="text-headline clamp1">{item.title}</div>
+          <div className="text-callout text-dim clamp1">
+            {item.artist}
+            {item.album ? ` · ${item.album}` : ""}
+            {item.year ? ` · ${item.year}` : ""}
+          </div>
+          <ConfidenceBar pct={pct} />
+        </div>
+      </div>
+
+      <div className="mt-3.5 rounded-glass border border-edge bg-[var(--glass)] p-3">
+        <div className="mb-1.5 flex items-center gap-1.5 text-caption uppercase tracking-[0.7px] text-dim">
+          <ShieldQuestion className="h-3 w-3" /> what was found
+        </div>
+        <div className="break-all font-mono text-[12px] text-ink">{item.file}</div>
+        {item.size ? (
+          <div className="mt-1 text-caption text-dim nums">{bytes(item.size)}</div>
+        ) : null}
+
+        {reasons.length > 0 && (
+          <ul className="mt-2.5 flex flex-wrap gap-1.5">
+            {reasons.map((r) => (
+              <li
+                key={r}
+                className={cn(
+                  "rounded-pill border px-2 py-0.5 text-caption",
+                  /not |differs|looks like/.test(r)
+                    ? "border-warn/40 text-warn"
+                    : "border-edge text-dim",
+                )}
+              >
+                {r}
+              </li>
+            ))}
+          </ul>
+        )}
+      </div>
+
+      <div className="mt-3.5 flex flex-wrap items-center gap-2">
+        <Button onClick={() => decide("approve")} disabled={busy}>
+          <Check className="h-3.5 w-3.5" /> Add to library
+        </Button>
+        <Button
+          variant="quiet"
+          className="border-err/45 text-err"
+          onClick={() => decide("reject")}
+          disabled={busy}
+        >
+          <X className="h-3.5 w-3.5" /> Delete
+        </Button>
+        {item.requested_by && (
+          <span className="ml-auto text-caption text-dim">
+            requested by {item.requested_by}
+          </span>
+        )}
+      </div>
+    </motion.div>
+  );
+}
+
+/** Confidence as a bar rather than a bare number: the useful question is
+ *  "how far below certain is this", which a percentage alone doesn't show. */
+function ConfidenceBar({ pct }: { pct: number }) {
+  const tone = pct >= 85 ? "bg-warn" : pct >= 70 ? "bg-warn" : "bg-err";
+  return (
+    <div className="mt-2 flex items-center gap-2.5">
+      <div className="h-1.5 max-w-[220px] flex-1 overflow-hidden rounded-pill bg-faint">
+        <motion.i
+          className={cn("block h-full rounded-pill", tone)}
+          initial={{ width: 0 }}
+          animate={{ width: `${pct}%` }}
+          transition={{ duration: 0.5, ease: "easeOut" }}
+        />
+      </div>
+      <span className="text-caption text-dim nums">{pct}% confident</span>
+    </div>
+  );
+}