refactor(launcher): complete split into modular launcher/ directory

- Split 4,028-line monolithic subminer script into 10 focused modules
- launcher/types.ts: shared types and constants
- launcher/log.ts: logging infrastructure
- launcher/util.ts: pure utilities and child process runner
- launcher/config.ts: config loading and arg parsing
- launcher/jimaku.ts: Jimaku API client and media parsing
- launcher/picker.ts: rofi/fzf menu UI
- launcher/mpv.ts: mpv process management and IPC
- launcher/youtube.ts: YouTube subtitle generation pipeline
- launcher/jellyfin.ts: Jellyfin API and browsing
- launcher/main.ts: orchestration entrypoint
- Add build-launcher Makefile target using bun build
- subminer is now a build artifact produced by make build-launcher
- install-linux and install-macos depend on build-launcher

.gitignore

@@ -6,6 +6,9 @@ out/
 dist/
 release/
 
+# Launcher build artifact (produced by make build-launcher)
+subminer
+
 # Logs
 *.log
 npm-debug.log*

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help deps build install build-linux build-macos build-macos-unsigned clean install-linux install-macos install-plugin uninstall uninstall-linux uninstall-macos print-dirs pretty ensure-pnpm generate-config generate-example-config docs-dev docs docs-preview dev-start dev-start-macos dev-toggle dev-stop
+.PHONY: help deps build build-launcher install build-linux build-macos build-macos-unsigned clean install-linux install-macos install-plugin uninstall uninstall-linux uninstall-macos print-dirs pretty ensure-pnpm generate-config generate-example-config docs-dev docs docs-preview dev-start dev-start-macos dev-toggle dev-stop
 
 APP_NAME := subminer
 THEME_FILE := subminer.rasi
@@ -131,6 +131,12 @@ build-macos-unsigned: deps
 	@pnpm -C vendor/texthooker-ui build
 	@pnpm run build:mac:unsigned
 
+build-launcher:
+	@printf '%s\n' "[INFO] Bundling launcher script"
+	@bun build ./launcher/main.ts --target=bun --packages=bundle --outfile=subminer
+	@sed -i '1s|^// @bun|#!/usr/bin/env bun\n// @bun|' subminer
+	@chmod +x subminer
+
 clean:
 	@printf '%s\n' "[INFO] Removing build artifacts"
 	@rm -f release/SubMiner-*.AppImage
@@ -170,7 +176,7 @@ dev-stop: ensure-pnpm
 	@pnpm exec electron . --stop
 
 
-install-linux:
+install-linux: build-launcher
 	@printf '%s\n' "[INFO] Installing Linux wrapper/theme artifacts"
 	@install -d "$(BINDIR)"
 	@install -m 0755 "./$(APP_NAME)" "$(BINDIR)/$(APP_NAME)"
@@ -184,7 +190,7 @@ install-linux:
 	fi
 	@printf '%s\n' "Installed to:" "  $(BINDIR)/subminer" "  $(LINUX_DATA_DIR)/themes/$(THEME_FILE)"
 
-install-macos:
+install-macos: build-launcher
 	@printf '%s\n' "[INFO] Installing macOS wrapper/theme/app artifacts"
 	@install -d "$(BINDIR)"
 	@install -m 0755 "./$(APP_NAME)" "$(BINDIR)/$(APP_NAME)"

launcher/main.ts

@@ -0,0 +1,307 @@
+import fs from "node:fs";
+import path from "node:path";
+import type { Args } from "./types.js";
+import { log, fail } from "./log.js";
+import {
+  commandExists, isYoutubeTarget, resolvePathMaybe, realpathMaybe,
+} from "./util.js";
+import {
+  parseArgs, loadLauncherYoutubeSubgenConfig, loadLauncherJellyfinConfig,
+  readPluginRuntimeConfig,
+} from "./config.js";
+import { showRofiMenu, showFzfMenu, collectVideos } from "./picker.js";
+import {
+  state, startMpv, startOverlay, stopOverlay, launchTexthookerOnly,
+  findAppBinary, waitForSocket, loadSubtitleIntoMpv, runAppCommandWithInherit,
+} from "./mpv.js";
+import { generateYoutubeSubtitles } from "./youtube.js";
+import { runJellyfinPlayMenu } from "./jellyfin.js";
+
+function checkDependencies(args: Args): void {
+  const missing: string[] = [];
+
+  if (!commandExists("mpv")) missing.push("mpv");
+
+  if (
+    args.targetKind === "url" &&
+    isYoutubeTarget(args.target) &&
+    !commandExists("yt-dlp")
+  ) {
+    missing.push("yt-dlp");
+  }
+
+  if (
+    args.targetKind === "url" &&
+    isYoutubeTarget(args.target) &&
+    args.youtubeSubgenMode !== "off" &&
+    !commandExists("ffmpeg")
+  ) {
+    missing.push("ffmpeg");
+  }
+
+  if (missing.length > 0) fail(`Missing dependencies: ${missing.join(" ")}`);
+}
+
+function checkPickerDependencies(args: Args): void {
+  if (args.useRofi) {
+    if (!commandExists("rofi")) fail("Missing dependency: rofi");
+    return;
+  }
+
+  if (!commandExists("fzf")) fail("Missing dependency: fzf");
+}
+
+async function chooseTarget(
+  args: Args,
+  scriptPath: string,
+): Promise<{ target: string; kind: "file" | "url" } | null> {
+  if (args.target) {
+    return { target: args.target, kind: args.targetKind as "file" | "url" };
+  }
+
+  const searchDir = realpathMaybe(resolvePathMaybe(args.directory));
+  if (!fs.existsSync(searchDir) || !fs.statSync(searchDir).isDirectory()) {
+    fail(`Directory not found: ${searchDir}`);
+  }
+
+  const videos = collectVideos(searchDir, args.recursive);
+  if (videos.length === 0) {
+    fail(`No video files found in: ${searchDir}`);
+  }
+
+  log(
+    "info",
+    args.logLevel,
+    `Browsing: ${searchDir} (${videos.length} videos found)`,
+  );
+
+  const selected = args.useRofi
+    ? showRofiMenu(videos, searchDir, args.recursive, scriptPath, args.logLevel)
+    : showFzfMenu(videos);
+
+  if (!selected) return null;
+  return { target: selected, kind: "file" };
+}
+
+function registerCleanup(args: Args): void {
+  process.on("SIGINT", () => {
+    stopOverlay(args);
+    process.exit(130);
+  });
+  process.on("SIGTERM", () => {
+    stopOverlay(args);
+    process.exit(143);
+  });
+}
+
+async function main(): Promise<void> {
+  const scriptPath = process.argv[1] || "subminer";
+  const scriptName = path.basename(scriptPath);
+  const launcherConfig = loadLauncherYoutubeSubgenConfig();
+  const launcherJellyfinConfig = loadLauncherJellyfinConfig();
+  const args = parseArgs(process.argv.slice(2), scriptName, launcherConfig);
+  const pluginRuntimeConfig = readPluginRuntimeConfig(args.logLevel);
+  const mpvSocketPath = pluginRuntimeConfig.socketPath;
+
+  log("debug", args.logLevel, `Wrapper log level set to: ${args.logLevel}`);
+
+  const appPath = findAppBinary(process.argv[1] || "subminer");
+  if (!appPath) {
+    if (process.platform === "darwin") {
+      fail(
+        "SubMiner app binary not found. Install SubMiner.app to /Applications or ~/Applications, or set SUBMINER_APPIMAGE_PATH.",
+      );
+    }
+    fail(
+      "SubMiner AppImage not found. Install to ~/.local/bin/ or set SUBMINER_APPIMAGE_PATH.",
+    );
+  }
+  state.appPath = appPath;
+
+  if (args.texthookerOnly) {
+    launchTexthookerOnly(appPath, args);
+  }
+
+  if (args.jellyfin) {
+    const forwarded = ["--jellyfin"];
+    if (args.logLevel !== "info") forwarded.push("--log-level", args.logLevel);
+    runAppCommandWithInherit(appPath, forwarded);
+  }
+
+  if (args.jellyfinLogin) {
+    const serverUrl = args.jellyfinServer || launcherJellyfinConfig.serverUrl || "";
+    const username = args.jellyfinUsername || launcherJellyfinConfig.username || "";
+    const password = args.jellyfinPassword || "";
+    if (!serverUrl || !username || !password) {
+      fail(
+        "--jellyfin-login requires server, username, and password. Pass flags or run `subminer --jellyfin`.",
+      );
+    }
+    const forwarded = [
+      "--jellyfin-login",
+      "--jellyfin-server",
+      serverUrl,
+      "--jellyfin-username",
+      username,
+      "--jellyfin-password",
+      password,
+    ];
+    if (args.logLevel !== "info") forwarded.push("--log-level", args.logLevel);
+    runAppCommandWithInherit(appPath, forwarded);
+  }
+
+  if (args.jellyfinLogout) {
+    const forwarded = ["--jellyfin-logout"];
+    if (args.logLevel !== "info") forwarded.push("--log-level", args.logLevel);
+    runAppCommandWithInherit(appPath, forwarded);
+  }
+
+  if (args.jellyfinPlay) {
+    if (!args.useRofi && !commandExists("fzf")) {
+      fail("fzf not found. Install fzf or use -R for rofi.");
+    }
+    if (args.useRofi && !commandExists("rofi")) {
+      fail("rofi not found. Install rofi or omit -R for fzf.");
+    }
+    await runJellyfinPlayMenu(appPath, args, scriptPath, mpvSocketPath);
+  }
+
+  if (!args.target) {
+    checkPickerDependencies(args);
+  }
+
+  const targetChoice = await chooseTarget(args, process.argv[1] || "subminer");
+  if (!targetChoice) {
+    log("info", args.logLevel, "No video selected, exiting");
+    process.exit(0);
+  }
+
+  checkDependencies({
+    ...args,
+    target: targetChoice ? targetChoice.target : args.target,
+    targetKind: targetChoice ? targetChoice.kind : "url",
+  });
+
+  registerCleanup(args);
+
+  let selectedTarget = targetChoice
+    ? {
+        target: targetChoice.target,
+        kind: targetChoice.kind as "file" | "url",
+      }
+    : { target: args.target, kind: "url" as const };
+
+  const isYoutubeUrl =
+    selectedTarget.kind === "url" && isYoutubeTarget(selectedTarget.target);
+  let preloadedSubtitles:
+    | { primaryPath?: string; secondaryPath?: string }
+    | undefined;
+
+  if (isYoutubeUrl && args.youtubeSubgenMode === "preprocess") {
+    log("info", args.logLevel, "YouTube subtitle mode: preprocess");
+    const generated = await generateYoutubeSubtitles(
+      selectedTarget.target,
+      args,
+    );
+    preloadedSubtitles = {
+      primaryPath: generated.primaryPath,
+      secondaryPath: generated.secondaryPath,
+    };
+    log(
+      "info",
+      args.logLevel,
+      `YouTube preprocess result: primary=${generated.primaryPath ? "ready" : "missing"}, secondary=${generated.secondaryPath ? "ready" : "missing"}`,
+    );
+  } else if (isYoutubeUrl && args.youtubeSubgenMode === "automatic") {
+    log("info", args.logLevel, "YouTube subtitle mode: automatic (background)");
+  } else if (isYoutubeUrl) {
+    log("info", args.logLevel, "YouTube subtitle mode: off");
+  }
+
+  startMpv(
+    selectedTarget.target,
+    selectedTarget.kind,
+    args,
+    mpvSocketPath,
+    appPath,
+    preloadedSubtitles,
+  );
+
+  if (isYoutubeUrl && args.youtubeSubgenMode === "automatic") {
+    void generateYoutubeSubtitles(
+      selectedTarget.target,
+      args,
+      async (lang, subtitlePath) => {
+      try {
+        await loadSubtitleIntoMpv(
+          mpvSocketPath,
+          subtitlePath,
+          lang === "primary",
+          args.logLevel,
+        );
+      } catch (error) {
+        log(
+          "warn",
+          args.logLevel,
+          `Generated subtitle ready but failed to load in mpv: ${(error as Error).message}`,
+        );
+      }
+    }).catch((error) => {
+      log(
+        "warn",
+        args.logLevel,
+        `Background subtitle generation failed: ${(error as Error).message}`,
+      );
+    });
+  }
+
+  const ready = await waitForSocket(mpvSocketPath);
+  const shouldStartOverlay =
+    args.startOverlay || args.autoStartOverlay || pluginRuntimeConfig.autoStartOverlay;
+  if (shouldStartOverlay) {
+    if (ready) {
+      log(
+        "info",
+        args.logLevel,
+        "MPV IPC socket ready, starting SubMiner overlay",
+      );
+    } else {
+      log(
+        "info",
+        args.logLevel,
+        "MPV IPC socket not ready after timeout, starting SubMiner overlay anyway",
+      );
+    }
+    await startOverlay(appPath, args, mpvSocketPath);
+  } else if (ready) {
+    log(
+      "info",
+      args.logLevel,
+      "MPV IPC socket ready, overlay auto-start disabled (use y-s to start)",
+    );
+  } else {
+    log(
+      "info",
+      args.logLevel,
+      "MPV IPC socket not ready yet, overlay auto-start disabled (use y-s to start)",
+    );
+  }
+
+  await new Promise<void>((resolve) => {
+    if (!state.mpvProc) {
+      stopOverlay(args);
+      resolve();
+      return;
+    }
+    state.mpvProc.on("exit", (code) => {
+      stopOverlay(args);
+      process.exitCode = code ?? 0;
+      resolve();
+    });
+  });
+}
+
+main().catch((error: unknown) => {
+  const message = error instanceof Error ? error.message : String(error);
+  fail(message);
+});