chore(docs): regenerate man page, HTML docs, and wiki

docs/fish-config.1

@@ -1174,7 +1174,7 @@ Dependencies are grouped into three tiers:
   Integrations  wakatime, tailscale
   Recommended   cargo, starship, uv, direnv, paru, yay, eza, lsd, bat,
                 btop, dust, duf, prettyping, ov, ripgrep, lazygit,
-                lazydocker, trash, kitty, wezterm, python3
+                lazydocker, trash, kitty, wezterm, python3, yt-dlp
 
 fish-deps
 fish-deps install
@@ -1627,6 +1627,24 @@ spark 1 1 2 5 14 42
 echo \[dq]3 7 2 9 1\[dq] | spark
 \f[R]
 .fi
+.SS yt-dlp
+.IP
+.nf
+\f[C]
+Synopsis:  yt-dlp [args...] URL [URL...]
+Wraps yt-dlp, prepending sane defaults: --sponsorblock-remove all,
+--embed-subs, --embed-metadata, and --embed-thumbnail. Each default
+is suppressed when you already pass that flag, its alias, or its
+negation (e.g. --no-embed-thumbnail drops the thumbnail default;
+--no-sponsorblock or your own --sponsorblock-remove drops ours). All
+other arguments pass through unchanged, and --help falls through to
+real yt-dlp. Opinionated component (C1 aliases); when disabled it
+passes straight through to the system yt-dlp.
+
+yt-dlp dQw4w9WgXcQ
+yt-dlp --no-embed-thumbnail dQw4w9WgXcQ
+\f[R]
+.fi
 .PP
    *   *   *   *   *
 .SS 5.14 Miscellaneous
@@ -1921,6 +1939,9 @@ python3     Standalone interpreter \[em] used by the paru/yay log cleaner.
             Note: uv does not provide python3 on PATH, and Arch\[aq]s base
             does not include it, so it is listed separately. All
             consumers degrade gracefully without it.
+yt-dlp      Video/media downloader; backs the yt-dlp wrapper function.
+            Optional \[em] the wrapper falls back to the system yt-dlp and
+            the rest of the config works without it.
 \f[R]
 .fi
 .SS Install Methods

docs/html/10-6-dependency-catalog.html

@@ -531,7 +531,10 @@ wezterm     GPU-accelerated terminal (alternative)
 python3     Standalone interpreter — used by the paru/yay log cleaner.
             Note: uv does not provide python3 on PATH, and Arch's base
             does not include it, so it is listed separately. All
-            consumers degrade gracefully without it.</code></pre>
+            consumers degrade gracefully without it.
+yt-dlp      Video/media downloader; backs the yt-dlp wrapper function.
+            Optional — the wrapper falls back to the system yt-dlp and
+            the rest of the config works without it.</code></pre>
 <h2 data-number="10.4" id="install-methods">Install Methods</h2>
 <p>The install priority for each tool:</p>
 <pre><code>cargo     Rust tools (eza, lsd, bat, dust, ov, ripgrep, trashy, zoxide,

docs/html/9-5-functions-reference.html

@@ -819,7 +819,7 @@ Dependencies are grouped into three tiers:
   Integrations  wakatime, tailscale
   Recommended   cargo, starship, uv, direnv, paru, yay, eza, lsd, bat,
                 btop, dust, duf, prettyping, ov, ripgrep, lazygit,
-                lazydocker, trash, kitty, wezterm, python3
+                lazydocker, trash, kitty, wezterm, python3, yt-dlp
 
 fish-deps
 fish-deps install
@@ -1093,6 +1093,19 @@ Reads from stdin if no numbers are given.
 
 spark 1 1 2 5 14 42
 echo &quot;3 7 2 9 1&quot; | spark</code></pre>
+<h3 data-number="9.13.4" id="yt-dlp">yt-dlp</h3>
+<pre><code>Synopsis:  yt-dlp [args...] URL [URL...]
+Wraps yt-dlp, prepending sane defaults: --sponsorblock-remove all,
+--embed-subs, --embed-metadata, and --embed-thumbnail. Each default
+is suppressed when you already pass that flag, its alias, or its
+negation (e.g. --no-embed-thumbnail drops the thumbnail default;
+--no-sponsorblock or your own --sponsorblock-remove drops ours). All
+other arguments pass through unchanged, and --help falls through to
+real yt-dlp. Opinionated component (C1 aliases); when disabled it
+passes straight through to the system yt-dlp.
+
+yt-dlp dQw4w9WgXcQ
+yt-dlp --no-embed-thumbnail dQw4w9WgXcQ</code></pre>
 <hr />
 <h2 data-number="9.14" id="514-miscellaneous">5.14 Miscellaneous</h2>
 <h3 data-number="9.14.1" id="config-help">config-help</h3>

docs/html/index.html

@@ -761,6 +761,8 @@ id="toc-dng2avif">dng2avif</a></li>
 id="toc-steam-dl">steam-dl</a></li>
 <li><a href="9-5-functions-reference.html#spark"
 id="toc-spark">spark</a></li>
+<li><a href="9-5-functions-reference.html#yt-dlp"
+id="toc-yt-dlp">yt-dlp</a></li>
 </ul></li>
 <li><a href="9-5-functions-reference.html#514-miscellaneous"
 id="toc-514-miscellaneous">5.14 Miscellaneous</a>

docs/wiki/5-functions-reference.md

@@ -416,7 +416,7 @@
       Integrations  wakatime, tailscale
       Recommended   cargo, starship, uv, direnv, paru, yay, eza, lsd, bat,
                     btop, dust, duf, prettyping, ov, ripgrep, lazygit,
-                    lazydocker, trash, kitty, wezterm, python3
+                    lazydocker, trash, kitty, wezterm, python3, yt-dlp
 
     fish-deps
     fish-deps install
@@ -770,6 +770,21 @@
     spark 1 1 2 5 14 42
     echo "3 7 2 9 1" | spark
 
+### yt-dlp
+
+    Synopsis:  yt-dlp [args...] URL [URL...]
+    Wraps yt-dlp, prepending sane defaults: --sponsorblock-remove all,
+    --embed-subs, --embed-metadata, and --embed-thumbnail. Each default
+    is suppressed when you already pass that flag, its alias, or its
+    negation (e.g. --no-embed-thumbnail drops the thumbnail default;
+    --no-sponsorblock or your own --sponsorblock-remove drops ours). All
+    other arguments pass through unchanged, and --help falls through to
+    real yt-dlp. Opinionated component (C1 aliases); when disabled it
+    passes straight through to the system yt-dlp.
+
+    yt-dlp dQw4w9WgXcQ
+    yt-dlp --no-embed-thumbnail dQw4w9WgXcQ
+
 ---
 
 ## 5.14 Miscellaneous

docs/wiki/6-dependency-catalog.md

@@ -52,6 +52,9 @@ fish-deps manages these tools. Run `fish-deps` to check status, or
                 Note: uv does not provide python3 on PATH, and Arch's base
                 does not include it, so it is listed separately. All
                 consumers degrade gracefully without it.
+    yt-dlp      Video/media downloader; backs the yt-dlp wrapper function.
+                Optional — the wrapper falls back to the system yt-dlp and
+                the rest of the config works without it.
 
 ## Install Methods