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

docs/fish-config.1

@@ -1816,14 +1816,6 @@ idle or sleeping until the command completes.
 wake-lock rsync -avz src/ dest/
 \f[R]
 .fi
-.SS zellij
-.IP
-.nf
-\f[C]
-Synopsis:  zellij [args...]
-Launches zellij with the Catppuccin Mocha theme applied.
-\f[R]
-.fi
 .PP
    *   *   *   *   *
 .SH 6. DEPENDENCY CATALOG
@@ -2203,7 +2195,11 @@ SCROLLBACK_HISTORY_MAX_FILES, matching the paru/yay wrapper behaviour.
 The zellij capture works differently: Zellij has no live
 output-streaming facility like pipe-pane, so the log is taken as a
 one-shot snapshot when the shell exits, via
-\f[V]zellij action dump-screen --full\f[R].
+\f[V]zellij action dump-screen --full --ansi\f[R] (the \[en]ansi flag
+preserves color).
+The dump is captured on the fish process\[cq]s stdout and written to the
+log file by fish itself (not via \f[V]--path\f[R], which would make the
+zellij server write the file).
 A fish_exit handler (registered whenever $ZELLIJ is set) writes the
 pane\[cq]s full scrollback and then prunes old zellij_*.log files the
 same way.
@@ -2211,6 +2207,28 @@ Because the capture happens at exit, toggling __fish_config_op_logging
 takes effect on the next exit with no restart or sentinel coordination
 needed \[em] the C5 guard is re-checked when the handler fires.
 .PP
+LIMITATION \[em] zellij capture only fires on a clean shell exit (typing
+\f[V]exit\f[R], Ctrl-D, or a logout), because that is when the fish_exit
+handler runs.
+It does NOT capture when you close a pane or quit zellij through zellij
+itself:
+.IP \[bu] 2
+Closing a pane signals the shell and tears the pane down concurrently,
+so even if the handler runs, \f[V]dump-screen\f[R] may find the pane
+buffer already gone.
+.IP \[bu] 2
+Quitting zellij kills the zellij server, and \f[V]dump-screen\f[R] needs
+a live server to read from \[em] there is nothing left to snapshot.
+.PP
+This is a structural difference from tmux, NOT a bug.
+tmux streams pane output to disk continuously via pipe-pane, so whatever
+was printed is already saved no matter how the pane dies.
+Zellij can only snapshot, and the only reliable snapshot point from the
+shell is a clean exit.
+To guarantee a zellij pane is logged, end the session with
+\f[V]exit\f[R] or Ctrl-D rather than zellij\[cq]s close-pane or quit
+actions.
+.PP
 The Kitty watcher is managed by the kitty-logging command: it installs a
 version-marked watcher (fish-config-watcher.py) into the Kitty config
 directory and wires it into kitty.conf via a managed block.

docs/html/11-7-customization.html

@@ -721,12 +721,34 @@ behaviour.</p>
 <p>The zellij capture works differently: Zellij has no live
 output-streaming facility like pipe-pane, so the log is taken as a
 one-shot snapshot when the shell exits, via
-<code>zellij action dump-screen --full</code>. A fish_exit handler
+<code>zellij action dump-screen --full --ansi</code> (the --ansi flag
+preserves color). The dump is captured on the fish process's stdout and
+written to the log file by fish itself (not via <code>--path</code>,
+which would make the zellij server write the file). A fish_exit handler
 (registered whenever $ZELLIJ is set) writes the pane's full scrollback
 and then prunes old zellij_*.log files the same way. Because the capture
 happens at exit, toggling __fish_config_op_logging takes effect on the
 next exit with no restart or sentinel coordination needed — the C5 guard
 is re-checked when the handler fires.</p>
+<p>LIMITATION — zellij capture only fires on a clean shell exit (typing
+<code>exit</code>, Ctrl-D, or a logout), because that is when the
+fish_exit handler runs. It does NOT capture when you close a pane or
+quit zellij through zellij itself:</p>
+<ul>
+<li>Closing a pane signals the shell and tears the pane down
+concurrently, so even if the handler runs, <code>dump-screen</code> may
+find the pane buffer already gone.</li>
+<li>Quitting zellij kills the zellij server, and
+<code>dump-screen</code> needs a live server to read from — there is
+nothing left to snapshot.</li>
+</ul>
+<p>This is a structural difference from tmux, NOT a bug. tmux streams
+pane output to disk continuously via pipe-pane, so whatever was printed
+is already saved no matter how the pane dies. Zellij can only snapshot,
+and the only reliable snapshot point from the shell is a clean exit. To
+guarantee a zellij pane is logged, end the session with
+<code>exit</code> or Ctrl-D rather than zellij's close-pane or quit
+actions.</p>
 <p>The Kitty watcher is managed by the kitty-logging command: it
 installs a version-marked watcher (fish-config-watcher.py) into the
 Kitty config directory and wires it into kitty.conf via a managed block.

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

@@ -1205,9 +1205,6 @@ Runs a command under systemd-inhibit, preventing the system from going
 idle or sleeping until the command completes.
 
 wake-lock rsync -avz src/ dest/</code></pre>
-<h3 data-number="9.14.15" id="zellij">zellij</h3>
-<pre><code>Synopsis:  zellij [args...]
-Launches zellij with the Catppuccin Mocha theme applied.</code></pre>
 <hr />
 </body>
 </html>

docs/html/index.html

@@ -797,8 +797,6 @@ id="toc-kitty-logging">kitty-logging</a></li>
 id="toc-tmux-clean">tmux-clean</a></li>
 <li><a href="9-5-functions-reference.html#wake-lock"
 id="toc-wake-lock">wake-lock</a></li>
-<li><a href="9-5-functions-reference.html#zellij"
-id="toc-zellij">zellij</a></li>
 </ul></li>
 </ul></li>
 <li><a href="10-6-dependency-catalog.html"

docs/wiki/5-functions-reference.md

@@ -916,9 +916,4 @@
 
     wake-lock rsync -avz src/ dest/
 
-### zellij
-
-    Synopsis:  zellij [args...]
-    Launches zellij with the Catppuccin Mocha theme applied.
-
 ---

docs/wiki/7-customization.md

@@ -258,12 +258,32 @@ SCROLLBACK_HISTORY_MAX_FILES, matching the paru/yay wrapper behaviour.
 
 The zellij capture works differently: Zellij has no live output-streaming
 facility like pipe-pane, so the log is taken as a one-shot snapshot when the
-shell exits, via `zellij action dump-screen --full`. A fish_exit handler
+shell exits, via `zellij action dump-screen --full --ansi` (the --ansi flag
-(registered whenever $ZELLIJ is set) writes the pane's full scrollback and
+preserves color). The dump is captured on the fish process's stdout and
-then prunes old zellij_*.log files the same way. Because the capture happens
+written to the log file by fish itself (not via `--path`, which would make the
-at exit, toggling __fish_config_op_logging takes effect on the next exit with
+zellij server write the file). A fish_exit handler (registered whenever
-no restart or sentinel coordination needed — the C5 guard is re-checked when
+$ZELLIJ is set) writes the pane's full scrollback and then prunes old
-the handler fires.
+zellij_*.log files the same way. Because the capture happens at exit, toggling
+__fish_config_op_logging takes effect on the next exit with no restart or
+sentinel coordination needed — the C5 guard is re-checked when the handler
+fires.
+
+LIMITATION — zellij capture only fires on a clean shell exit (typing `exit`,
+Ctrl-D, or a logout), because that is when the fish_exit handler runs. It does
+NOT capture when you close a pane or quit zellij through zellij itself:
+
+  - Closing a pane signals the shell and tears the pane down concurrently, so
+    even if the handler runs, `dump-screen` may find the pane buffer already
+    gone.
+  - Quitting zellij kills the zellij server, and `dump-screen` needs a live
+    server to read from — there is nothing left to snapshot.
+
+This is a structural difference from tmux, NOT a bug. tmux streams pane output
+to disk continuously via pipe-pane, so whatever was printed is already saved
+no matter how the pane dies. Zellij can only snapshot, and the only reliable
+snapshot point from the shell is a clean exit. To guarantee a zellij pane is
+logged, end the session with `exit` or Ctrl-D rather than zellij's close-pane
+or quit actions.
 
 The Kitty watcher is managed by the kitty-logging command: it installs a
 version-marked watcher (fish-config-watcher.py) into the Kitty config directory