Recover blocked searches, fall through to the next peer, rebuild the UI

Measured against a live instance: 47 failed jobs against 33 imported. Three
independent causes, all of which ended the request.

The Soulseek server filters some artist names. "Michael Jackson Billie Jean"
and bare "Michael Jackson" both return zero responses; "Billie Jean" returns
1083 files. The Weeknd, Kanye West and Frank Ocean behave the same way. Since
pick_and_enqueue sent exactly one query of `artist title`, every request for a
filtered artist failed reporting "searched 0 files" -- 28 of 29 occurrences.
search_queries() now walks a ladder, loosest last, ending at the bare title,
and escalates only when a search underdelivers so the common case still costs
one search. Dropping the artist from the query does not mean ignoring it:
match_ratio() looks for it in the folder path, where an organised share puts it.

A rejected transfer ended the request. pick_and_enqueue kept a running maximum
and discarded every runner-up, so "Transfer rejected: File not shared." -- a
per-file condition where candidate two almost always works -- was terminal, as
were timeouts and slskd's 500 on an unreachable peer. The ranked list is now
persisted on the job row, ordered to put a different peer next, and
try_next_candidate() advances through it. A job fails only once the list is
exhausted, and then reports every peer it tried and what each one said.

norm() destroyed every non-ASCII character, so "Beyonce" never matched
Beyonce, nor Bjork Bjork, nor Dont Don't. It now folds accents and drops
apostrophes while leaving & as a separator.

Also: availability outranks format in score(), because a FLAC behind 5000
queued users used to beat an immediately available MP3; transfers that stall or
that slskd forgets are abandoned instead of sitting in `downloading` forever;
searches are deleted only once finished, since deleting one mid-flight makes
slskd throw an optimistic-concurrency error and lose the record; a failed
search POST is retried rather than failing the job on one blip.

The UI moves to a sidebar shell -- rail at tablet, bottom bar on phones -- with
neutral chrome and the sampled artwork colour confined to hero areas rather
than repainting the whole interface. Adds URL routing, a primitive set under
components/ui, and a request sheet showing the attempt ladder. Fixes
hover:bg-glass-hi, which was never a valid class, so track rows and the search
field had no hover or focus state at all; a reduced-motion path that could
strand elements at opacity 0; the login page's hardcoded palette; and the
missing 404 and error boundaries.

tests/test_acquisition.py covers this path against a faked slskd. It had none.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Aryan SinghandClaude Opus 5 committed 2026-09-02 11:29:59 -05:00
1 parent 0dca779f59
commit 171e117f7c
47 files changed
+2939 -805

No files matched your search

+74
View File
@@ -0,0 +1,74 @@
"use client";
import * as React from "react";
import { AnimatePresence, motion } from "framer-motion";
import { AlertTriangle, WifiOff } from "lucide-react";
import { api, type Health } from "@/lib/api";
import { useMotionOK } from "@/lib/motion";
/**
* System health, for everyone.
*
* This check already existed but lived inside the admin panel, so a regular
* user whose every request was failing saw nothing but a growing pile of red
* pills. "Reachable but not logged in" is the important case: the container is
* up and healthy, so no other signal reports a problem, yet every search
* returns nothing.
*/
export function StatusBanner() {
const [h, setH] = React.useState<Health | null>(null);
const ok = useMotionOK();
React.useEffect(() => {
let live = true;
const poll = async () => {
try {
const r = await api.health();
if (live) setH(r);
} catch {
/* a 401 here just means the poll outlived the session */
}
};
void poll();
const t = setInterval(poll, 20000);
return () => {
live = false;
clearInterval(t);
};
}, []);
const problem = !h
? null
: h.slskd !== 200
? {
icon: WifiOff,
text: "Can't reach slskd — nothing will download until it's back.",
}
: h.logged_in === false
? {
icon: AlertTriangle,
text: "slskd is running but not signed in to Soulseek — searches will return nothing.",
}
: h.library_writable === false
? { icon: AlertTriangle, text: "The music library isn't writable — imports will fail." }
: null;
return (
<AnimatePresence>
{problem && (
<motion.div
role="status"
initial={ok ? { height: 0, opacity: 0 } : false}
animate={{ height: "auto", opacity: 1 }}
exit={ok ? { height: 0, opacity: 0 } : { opacity: 0 }}
className="overflow-hidden"
>
<div className="flex items-center gap-2 border-b border-warn/30 bg-warn/10 px-4 py-2 text-callout text-warn">
<problem.icon className="h-4 w-4 shrink-0" />
<span className="clamp1">{problem.text}</span>
</div>
</motion.div>
)}
</AnimatePresence>
);
}