Merge branch 'worktree-test+suite-overhaul-and-real-fixtures' into chore/consolidate-v2.0.0

# Conflicts:
#	tests/integration/generated/settings-matrix.test.ts
#	tests/integration/platform/api.test.ts
#	tests/integration/platform/concurrent.test.ts
#	tests/integration/platform/factory-multi-input.test.ts
#	tests/integration/security/adversarial-comprehensive.test.ts
#	tests/integration/security/adversarial-coverage-gaps.test.ts
#	tests/integration/security/adversarial-extended.test.ts
#	tests/integration/security/adversarial-final-gaps.test.ts
#	tests/integration/security/adversarial-matrix.test.ts
#	tests/integration/security/adversarial-security.test.ts
#	tests/integration/security/adversarial.test.ts
#	tests/integration/tools/image/color-adjustments.test.ts

tests/integration/tools/audio/convert-audio.test.ts

@@ -0,0 +1,83 @@
+import { ffmpegAvailable } from "@snapotter/media-engine";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { fixtures, readFixture } from "../../../fixtures/index.js";
+import {
+  buildTestApp,
+  createMultipartPayload,
+  loginAsAdmin,
+  type TestApp,
+} from "../../test-server.js";
+
+const WAV = readFixture(fixtures.audio.tiny("wav"));
+const MP3 = readFixture(fixtures.audio.tiny("mp3"));
+
+let testApp: TestApp;
+let adminToken: string;
+
+beforeAll(async () => {
+  testApp = await buildTestApp();
+  adminToken = await loginAsAdmin(testApp.app);
+}, 30_000);
+
+afterAll(async () => {
+  await testApp.cleanup();
+}, 10_000);
+
+async function runTool(settings: Record<string, unknown>, file = WAV, filename = "tiny.wav") {
+  const { body, contentType } = createMultipartPayload([
+    { name: "file", filename, contentType: "audio/wav", content: file },
+    { name: "settings", content: JSON.stringify(settings) },
+  ]);
+  return testApp.app.inject({
+    method: "POST",
+    url: "/api/v1/tools/audio/convert-audio",
+    headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType },
+    body,
+  });
+}
+
+describe.skipIf(!ffmpegAvailable())("convert-audio (requires ffmpeg)", () => {
+  it("converts wav to mp3 and returns 200", async () => {
+    const res = await runTool({ format: "mp3" });
+    expect(res.statusCode).toBe(200);
+    const envelope = JSON.parse(res.body);
+    expect(envelope.downloadUrl).toBeDefined();
+    const dl = await testApp.app.inject({
+      method: "GET",
+      url: envelope.downloadUrl,
+    });
+    expect(dl.statusCode).toBe(200);
+    expect(dl.rawPayload.length).toBeGreaterThan(100);
+    const outName = envelope.downloadUrl.split("/").pop() as string;
+    expect(outName.endsWith(".mp3")).toBe(true);
+  }, 60_000);
+
+  it("converts mp3 to ogg and returns 200", async () => {
+    // mp3 fixture (44100 Hz); the 8 kHz wav -> ogg case is the regression test below.
+    const res = await runTool({ format: "ogg" }, MP3, "tiny.mp3");
+    expect(res.statusCode).toBe(200);
+    const envelope = JSON.parse(res.body);
+    expect(envelope.downloadUrl).toBeDefined();
+    const dl = await testApp.app.inject({
+      method: "GET",
+      url: envelope.downloadUrl,
+    });
+    expect(dl.statusCode).toBe(200);
+    expect(dl.rawPayload.length).toBeGreaterThan(100);
+    const outName = envelope.downloadUrl.split("/").pop() as string;
+    expect(outName.endsWith(".ogg")).toBe(true);
+  }, 60_000);
+
+  it("converts 8 kHz wav to ogg (regression: libvorbis low samplerate)", async () => {
+    // tiny.wav is 8 kHz; a fixed bitrate (-b:a) made libvorbis "encoder setup failed".
+    // The ogg path now uses -q:a (quality VBR), which adapts to the sample rate.
+    const res = await runTool({ format: "ogg" }, WAV, "tiny.wav");
+    expect(res.statusCode).toBe(200);
+    const envelope = JSON.parse(res.body);
+    expect(envelope.downloadUrl).toBeDefined();
+    const dl = await testApp.app.inject({ method: "GET", url: envelope.downloadUrl });
+    expect(dl.statusCode).toBe(200);
+    expect(dl.rawPayload.length).toBeGreaterThan(100);
+    expect((envelope.downloadUrl.split("/").pop() as string).endsWith(".ogg")).toBe(true);
+  }, 60_000);
+});