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

docs/fish-config.1

@@ -89,6 +89,9 @@ functions/                Custom functions, one per file, autoloaded
 completions/              Tab completion scripts
 integrations/
   fzf.fish                FZF Catppuccin theme and key binding config
+scripts/
+  clean_progress_log.py   Renders script(1) typescripts (paru/yay progress
+                          animations) to clean static logs, preserving color
 docs/                     Offline documentation and compiled man page
   fish-config.md          Primary source manual (terminal-readable)
   fish-config.1           Compiled man page (auto-generated by CI)
@@ -280,8 +283,16 @@ scrollback_YYYY-MM-DD_HH-MM-SS.log
 \f[R]
 .fi
 .PP
-The paru and yay wrappers (auto-generated in \[ti]/.local/bin/) tee all
+The paru and yay wrappers (auto-generated in \[ti]/.local/bin/) run the
-output to:
+command inside a PTY via script(1) so download progress bars are
+preserved on screen, then render the captured terminal animation down to
+a clean static log via scripts/clean_progress_log.py (a small
+terminal-screen emulator that replays cursor movements, collapses
+repainted progress frames to their final state, and preserves ANSI
+color).
+If python3 is unavailable the wrapper falls back to dropping only the
+script(1) header/footer.
+Output is saved to:
 .IP
 .nf
 \f[C]
@@ -2048,9 +2059,9 @@ Component               What it captures
 ───────────────────────────────────────────────────────────────────────────
 Scrollback capture      Terminal session output saved to:
                         \[ti]/.terminal_history/scrollback_YYYY-MM-DD_HH-MM-SS.log
-paru wrapper            All paru/AUR output teed to:
+paru wrapper            All paru/AUR output captured to:
                         \[ti]/.terminal_history/paru_YYYY-MM-DD_HH-MM-SS.log
-yay wrapper             All yay/AUR output teed to:
+yay wrapper             All yay/AUR output captured to:
                         \[ti]/.terminal_history/yay_YYYY-MM-DD_HH-MM-SS.log
 Kitty watcher           watcher.py captures scrollback when Kitty closes
 \f[R]

docs/html/11-7-customization.html

@@ -695,9 +695,9 @@ wrappers.</p>
 ───────────────────────────────────────────────────────────────────────────
 Scrollback capture      Terminal session output saved to:
                         ~/.terminal_history/scrollback_YYYY-MM-DD_HH-MM-SS.log
-paru wrapper            All paru/AUR output teed to:
+paru wrapper            All paru/AUR output captured to:
                         ~/.terminal_history/paru_YYYY-MM-DD_HH-MM-SS.log
-yay wrapper             All yay/AUR output teed to:
+yay wrapper             All yay/AUR output captured to:
                         ~/.terminal_history/yay_YYYY-MM-DD_HH-MM-SS.log
 Kitty watcher           watcher.py captures scrollback when Kitty closes</code></pre>
 <p>Logging coordination via sentinel file</p>

docs/html/3-description.html

@@ -524,6 +524,9 @@ functions/                Custom functions, one per file, autoloaded
 completions/              Tab completion scripts
 integrations/
   fzf.fish                FZF Catppuccin theme and key binding config
+scripts/
+  clean_progress_log.py   Renders script(1) typescripts (paru/yay progress
+                          animations) to clean static logs, preserving color
 docs/                     Offline documentation and compiled man page
   fish-config.md          Primary source manual (terminal-readable)
   fish-config.1           Compiled man page (auto-generated by CI)

docs/html/5-1-configuration-variables.html

@@ -570,8 +570,14 @@ History</h3>
 timestamped scrollback snapshot to SCROLLBACK_HISTORY_DIR. Files are
 named:</p>
 <pre><code>scrollback_YYYY-MM-DD_HH-MM-SS.log</code></pre>
-<p>The paru and yay wrappers (auto-generated in ~/.local/bin/) tee all
+<p>The paru and yay wrappers (auto-generated in ~/.local/bin/) run the
-output to:</p>
+command inside a PTY via script(1) so download progress bars are
+preserved on screen, then render the captured terminal animation down to
+a clean static log via scripts/clean_progress_log.py (a small
+terminal-screen emulator that replays cursor movements, collapses
+repainted progress frames to their final state, and preserves ANSI
+color). If python3 is unavailable the wrapper falls back to dropping
+only the script(1) header/footer. Output is saved to:</p>
 <pre><code>paru_YYYY-MM-DD_HH-MM-SS.log
 yay_YYYY-MM-DD_HH-MM-SS.log</code></pre>
 <p>Before pruning, _scrollback_prune_junk silently removes empty files,

docs/wiki/1-configuration-variables.md

@@ -108,7 +108,13 @@ scrollback snapshot to SCROLLBACK_HISTORY_DIR. Files are named:
 
     scrollback_YYYY-MM-DD_HH-MM-SS.log
 
-The paru and yay wrappers (auto-generated in ~/.local/bin/) tee all output to:
+The paru and yay wrappers (auto-generated in ~/.local/bin/) run the command
+inside a PTY via script(1) so download progress bars are preserved on screen,
+then render the captured terminal animation down to a clean static log via
+scripts/clean_progress_log.py (a small terminal-screen emulator that replays
+cursor movements, collapses repainted progress frames to their final state,
+and preserves ANSI color). If python3 is unavailable the wrapper falls back to
+dropping only the script(1) header/footer. Output is saved to:
 
     paru_YYYY-MM-DD_HH-MM-SS.log
     yay_YYYY-MM-DD_HH-MM-SS.log

docs/wiki/7-customization.md

@@ -232,9 +232,9 @@ __fish_config_op_logging skips all capture and removes the logging wrappers.
     ───────────────────────────────────────────────────────────────────────────
     Scrollback capture      Terminal session output saved to:
                             ~/.terminal_history/scrollback_YYYY-MM-DD_HH-MM-SS.log
-    paru wrapper            All paru/AUR output teed to:
+    paru wrapper            All paru/AUR output captured to:
                             ~/.terminal_history/paru_YYYY-MM-DD_HH-MM-SS.log
-    yay wrapper             All yay/AUR output teed to:
+    yay wrapper             All yay/AUR output captured to:
                             ~/.terminal_history/yay_YYYY-MM-DD_HH-MM-SS.log
     Kitty watcher           watcher.py captures scrollback when Kitty closes
 

docs/wiki/index.md

@@ -33,6 +33,9 @@ The configuration is split across:
     completions/              Tab completion scripts
     integrations/
       fzf.fish                FZF Catppuccin theme and key binding config
+    scripts/
+      clean_progress_log.py   Renders script(1) typescripts (paru/yay progress
+                              animations) to clean static logs, preserving color
     docs/                     Offline documentation and compiled man page
       fish-config.md          Primary source manual (terminal-readable)
       fish-config.1           Compiled man page (auto-generated by CI)