feat: import with verification, and a Wanted view of its own (M502 #5522)

A finished download is checked against MusicBrainz before anything is
filed: the files are paired with an edition's tracks by position or path,
and AcoustID, tag ids, lengths and titles say whether it is the album.
What is the album is copied into the library as
Artist/Album (Year)/Artist - Album - NN - Title, tagged with Picard's
MusicBrainz ids, and scanned; the download keeps seeding. What is not is
refused: set aside, removed from the client, and the album searched for
again. A download the check cannot settle waits for a person, who imports
it anyway or refuses it. Tracks the library already holds are skipped.

The wanted list leaves Admin for a top-level Wanted view, admin-only and
web-only, with tabs for Wanted, Activity (downloads and their imports,
the ones needing a person first), Missing files, Held, Following (with the
release-type profiles, moved off Integrations) and Blocked. The search
settings gain "File new music into" when the library has several folders.

The search pass logs why each failed search failed.

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

web/src/routes/wanted/+layout.svelte

@@ -0,0 +1,48 @@
+<script lang="ts">
+  import { createWantsQuery } from '#lib/api/wanted.js';
+  import WantedTabs from '#lib/components/WantedTabs.svelte';
+
+  let { children } = $props<{ children: import('svelte').Snippet }>();
+
+  // The Wanted view (M502): what Minstrel is getting for the library, its
+  // downloads, and what it has set aside. Web-only and admin-only. The
+  // wanted query's first page carries every tab's count; the Wanted tab
+  // shares it, so this costs no extra request there.
+  const wantsStore = createWantsQuery('wanted');
+  const counts = $derived($wantsStore.data?.pages?.[0]?.counts);
+
+  // The one line that answers "does anything need me?"
+  const verdict = $derived.by(() => {
+    if (!counts) return '';
+    if (counts.attention) {
+      return counts.attention === 1 ? '1 download needs you.' : `${counts.attention} downloads need you.`;
+    }
+    const parts = [counts.wanted === 1 ? '1 album wanted' : `${counts.wanted} albums wanted`];
+    if (counts.activity) parts.push(`${counts.activity} downloading`);
+    return parts.join(', ') + '. Nothing needs you.';
+  });
+</script>
+
+<div class="space-y-4">
+  <header class="space-y-1">
+    <h1 class="font-display text-2xl font-medium text-text-primary">Wanted</h1>
+    <p class="text-sm text-text-secondary">
+      Albums Minstrel is getting: ones users requested, new releases from the artists it follows,
+      and albums whose files went missing. It searches your indexers on a schedule, checks each
+      download against MusicBrainz, and files what's right into the library. Searching and quality
+      are set under <a href="/admin/integrations" class="text-accent-fg hover:underline">Integrations</a>.
+    </p>
+    {#if verdict}
+      <p class="text-sm {counts?.attention ? 'text-text-primary' : 'text-text-secondary'}" data-testid="wanted-verdict">
+        {verdict}
+        {#if counts?.attention}
+          <a href="/wanted/activity" class="ml-1 text-accent-fg hover:underline">See Activity</a>
+        {/if}
+      </p>
+    {/if}
+  </header>
+
+  <WantedTabs {counts} />
+
+  {@render children?.()}
+</div>

web/src/routes/wanted/+layout.ts

@@ -0,0 +1,13 @@
+import { redirect } from '@sveltejs/kit';
+import { user } from '#lib/auth/store.svelte.js';
+import type { LayoutLoad } from './$types';
+
+// Hard route gate: the Wanted view is an admin's (M502). Runs before the
+// layout renders; auth is bootstrapped by the root +layout.ts, so user.value is
+// either a settled User object or null.
+export const load: LayoutLoad = () => {
+  if (!user.value || !user.value.is_admin) {
+    throw redirect(302, '/');
+  }
+  return {};
+};

web/src/routes/wanted/+page.svelte

@@ -0,0 +1,8 @@
+<script lang="ts">
+  import { pageTitle } from '#lib/branding.js';
+  import WantList from '#lib/components/wanted/WantList.svelte';
+</script>
+
+<svelte:head><title>{pageTitle('Wanted')}</title></svelte:head>
+
+<WantList state="wanted" />

web/src/routes/wanted/activity/+page.svelte

@@ -0,0 +1,8 @@
+<script lang="ts">
+  import { pageTitle } from '#lib/branding.js';
+  import DownloadList from '#lib/components/wanted/DownloadList.svelte';
+</script>
+
+<svelte:head><title>{pageTitle('Wanted · Activity')}</title></svelte:head>
+
+<DownloadList />

web/src/routes/wanted/blocked/+page.svelte

@@ -0,0 +1,8 @@
+<script lang="ts">
+  import { pageTitle } from '#lib/branding.js';
+  import BlockList from '#lib/components/wanted/BlockList.svelte';
+</script>
+
+<svelte:head><title>{pageTitle('Wanted · Blocked')}</title></svelte:head>
+
+<BlockList />

web/src/routes/wanted/following/+page.svelte

@@ -0,0 +1,12 @@
+<script lang="ts">
+  import { pageTitle } from '#lib/branding.js';
+  import FollowList from '#lib/components/wanted/FollowList.svelte';
+  import ReleaseProfilesCard from '#lib/components/ReleaseProfilesCard.svelte';
+</script>
+
+<svelte:head><title>{pageTitle('Wanted · Following')}</title></svelte:head>
+
+<div class="space-y-6">
+  <FollowList />
+  <ReleaseProfilesCard />
+</div>

web/src/routes/wanted/held/+page.svelte

@@ -0,0 +1,8 @@
+<script lang="ts">
+  import { pageTitle } from '#lib/branding.js';
+  import WantList from '#lib/components/wanted/WantList.svelte';
+</script>
+
+<svelte:head><title>{pageTitle('Wanted · Held')}</title></svelte:head>
+
+<WantList state="held" />

web/src/routes/wanted/missing/+page.svelte

@@ -0,0 +1,8 @@
+<script lang="ts">
+  import { pageTitle } from '#lib/branding.js';
+  import WantList from '#lib/components/wanted/WantList.svelte';
+</script>
+
+<svelte:head><title>{pageTitle('Wanted · Missing files')}</title></svelte:head>
+
+<WantList state="missing" />

web/src/routes/wanted/wanted.test.ts

@@ -0,0 +1,61 @@
+import { afterEach, describe, expect, test, vi } from 'vitest';
+import { render, screen } from '@testing-library/svelte';
+import { createRawSnippet } from 'svelte';
+import { mockInfiniteQuery } from '../../test-utils/query';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
+import type { WantCounts, WantsPage } from '#lib/api/types.js';
+
+const state = vi.hoisted(() => ({ pageUrl: new URL('http://localhost/wanted') }));
+vi.mock('$app/state', () => pageUrlModule(state));
+vi.mock('#lib/api/wanted.js', () => ({ createWantsQuery: vi.fn() }));
+
+import WantedLayout from './+layout.svelte';
+import { createWantsQuery } from '#lib/api/wanted.js';
+
+const counts: WantCounts = { wanted: 5, missing: 1, held: 9, following: 2, activity: 3, attention: 0, blocked: 4 };
+const children = createRawSnippet(() => ({ render: () => `<p data-testid="tab-body">body</p>` }));
+
+afterEach(() => vi.clearAllMocks());
+
+function setup(c: WantCounts = counts, path = '/wanted') {
+  state.pageUrl = new URL(`http://localhost${path}`);
+  const page: WantsPage = { items: [], total: 0, limit: 50, offset: 0, counts: c };
+  vi.mocked(createWantsQuery).mockReturnValue(
+    mockInfiniteQuery({ pages: [page] }) as unknown as ReturnType<typeof createWantsQuery>
+  );
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  return render(WantedLayout, { children } as any);
+}
+
+describe('/wanted layout', () => {
+  test('tabs are links carrying their counts, the current one marked', () => {
+    setup(counts, '/wanted/activity');
+    const nav = screen.getByRole('navigation', { name: /wanted sections/i });
+    const links = Array.from(nav.querySelectorAll('a')).map((a) => [a.getAttribute('href'), a.textContent?.replace(/\s+/g, ' ').trim()]);
+    expect(links).toEqual([
+      ['/wanted', 'Wanted 5'],
+      ['/wanted/activity', 'Activity 3'],
+      ['/wanted/missing', 'Missing files 1'],
+      ['/wanted/held', 'Held 9'],
+      ['/wanted/following', 'Following 2'],
+      ['/wanted/blocked', 'Blocked 4']
+    ]);
+    expect(screen.getByRole('link', { name: /activity/i })).toHaveAttribute('aria-current', 'page');
+    expect(screen.getByRole('link', { name: /^wanted/i })).not.toHaveAttribute('aria-current');
+    expect(screen.getByTestId('tab-body')).toBeTruthy();
+  });
+
+  test('when nothing needs a person the verdict says so', () => {
+    setup();
+    expect(screen.getByTestId('wanted-verdict').textContent).toMatch(/5 albums wanted, 3 downloading\. Nothing needs you\./);
+    expect(screen.queryByTestId('tab-attention')).toBeNull();
+  });
+
+  test('downloads waiting on a person lead the page and mark Activity', () => {
+    setup({ ...counts, attention: 2 });
+    const verdict = screen.getByTestId('wanted-verdict');
+    expect(verdict.textContent).toMatch(/2 downloads need you/);
+    expect(screen.getByRole('link', { name: /see activity/i }).getAttribute('href')).toBe('/wanted/activity');
+    expect(screen.getByTestId('tab-attention').textContent).toBe('2');
+  });
+});