refactor(cli): remove deprecated verbose logging flags

docs/architecture.md

@@ -103,6 +103,7 @@ flowchart TD
   end
 
   subgraph Svc["Services — src/core/services/"]
+    direction LR
     Mpv["MPV Stack<br/>transport · protocol<br/>state · properties"]:::svc
     Overlay["Overlay<br/>manager · window<br/>visibility · bridge"]:::svc
     Mining["Mining & Subtitles<br/>mining · field-grouping<br/>subtitle-ws · tokenizer"]:::svc
@@ -117,6 +118,7 @@ flowchart TD
   end
 
   subgraph Ext["External Systems"]
+    direction LR
     mpv["mpv"]:::ext
     Anki["AnkiConnect"]:::ext
     Jimaku["Jimaku API"]:::ext

docs/development.md

@@ -35,7 +35,8 @@ make build-macos-unsigned # macOS DMG + ZIP (unsigned)
 ## Running Locally
 
 ```bash
-pnpm run dev    # builds + launches with --start --dev flags
+pnpm run dev    # builds + launches with --start --dev
+electron . --start --dev --log-level debug   # equivalent Electron launch with verbose logging
 ```
 
 ## Testing

docs/installation.md

@@ -185,8 +185,13 @@ After installing, confirm SubMiner is working:
 # Start the overlay (connects to mpv IPC)
 subminer video.mkv
 
+# Useful launch modes for troubleshooting
+subminer --log-level debug video.mkv
+SubMiner.AppImage --start --log-level debug
+
 # Or with direct AppImage control
 SubMiner.AppImage --start
+SubMiner.AppImage --start --dev
 SubMiner.AppImage --help    # Show all CLI options
 ```
 

docs/mpv-plugin.md

@@ -155,6 +155,9 @@ The `subminer-start` message accepts overrides:
 script-message subminer-start backend=hyprland socket=/custom/path texthooker=no log-level=debug
 ```
 
+`log-level` here controls only logging verbosity passed to SubMiner.
+`--debug` is a separate app/dev-mode flag in the main CLI and should not be used here for logging.
+
 ## Lifecycle
 
 - **File loaded**: If `auto_start=yes`, the plugin starts the overlay and applies visibility preferences after a short delay.

docs/troubleshooting.md

@@ -14,6 +14,13 @@ SubMiner connects to mpv via a Unix socket (or named pipe on Windows). If the so
 
 SubMiner retries the connection automatically with increasing delays (200 ms, 500 ms, 1 s, 2 s on first connect; 1 s, 2 s, 5 s, 10 s on reconnect). If mpv exits and restarts, the overlay reconnects without needing a restart.
 
+## Logging and App Mode
+
+- Default log output is `info`.
+- Use `--log-level` for more/less output.
+- Use `--dev`/`--debug` only to force app/dev mode (for example to get dev behavior from the overlay/app); they do not change log verbosity.
+- You can combine both, for example `SubMiner.AppImage --start --dev --log-level debug`, when you need maximum diagnostics.
+
 **"Failed to parse MPV message"**
 
 Logged when a malformed JSON line arrives from the mpv socket. Usually harmless — SubMiner skips the bad line and continues. If it happens constantly, check that nothing else is writing to the same socket path.

docs/usage.md

@@ -22,6 +22,8 @@ subminer -r -d ~/Anime            # Recursive search
 subminer video.mkv                # Play specific file
 subminer https://youtu.be/...     # Play a YouTube URL
 subminer ytsearch:"jp news"       # Play first YouTube search result
+subminer --log-level debug video.mkv # Enable verbose logs for launch/debugging
+subminer --log-level warn video.mkv  # Set logging level explicitly
 
 # Options
 subminer -T video.mkv             # Disable texthooker server
@@ -40,10 +42,19 @@ SubMiner.AppImage --show-visible-overlay              # Force show visible overl
 SubMiner.AppImage --hide-visible-overlay              # Force hide visible overlay
 SubMiner.AppImage --show-invisible-overlay            # Force show invisible overlay
 SubMiner.AppImage --hide-invisible-overlay            # Force hide invisible overlay
+SubMiner.AppImage --start --dev                         # Enable app/dev mode only
+SubMiner.AppImage --start --debug                       # Alias for --dev
+SubMiner.AppImage --start --log-level debug             # Force verbose logging without app/dev mode
 SubMiner.AppImage --settings              # Open Yomitan settings
 SubMiner.AppImage --help                  # Show all options
 ```
 
+### Logging and App Mode
+
+- `--log-level` controls logger verbosity.
+- `--dev` and `--debug` are app/dev-mode switches; they are not log-level aliases.
+- Use both when needed, for example `SubMiner.AppImage --start --dev --log-level debug`.
+
 ### MPV Profile Example (mpv.conf)
 
 `subminer` passes the following MPV options directly on launch by default: