diff --git a/docs/fish-config.1 b/docs/fish-config.1 index 05bdc9e..e137916 100644 --- a/docs/fish-config.1 +++ b/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 -output to: +The paru and yay wrappers (auto-generated in \[ti]/.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: .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] diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html index 82611e4..20d703d 100644 --- a/docs/html/11-7-customization.html +++ b/docs/html/11-7-customization.html @@ -695,9 +695,9 @@ 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

Logging coordination via sentinel file

diff --git a/docs/html/3-description.html b/docs/html/3-description.html index 3d72e9d..f800305 100644 --- a/docs/html/3-description.html +++ b/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) diff --git a/docs/html/5-1-configuration-variables.html b/docs/html/5-1-configuration-variables.html index eda4d72..a098c5f 100644 --- a/docs/html/5-1-configuration-variables.html +++ b/docs/html/5-1-configuration-variables.html @@ -570,8 +570,14 @@ History timestamped 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

Before pruning, _scrollback_prune_junk silently removes empty files, diff --git a/docs/wiki/1-configuration-variables.md b/docs/wiki/1-configuration-variables.md index 42ff7ed..9377c63 100644 --- a/docs/wiki/1-configuration-variables.md +++ b/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 diff --git a/docs/wiki/7-customization.md b/docs/wiki/7-customization.md index 453b0d8..c6bdfb6 100644 --- a/docs/wiki/7-customization.md +++ b/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 diff --git a/docs/wiki/index.md b/docs/wiki/index.md index 2de4f0e..4b6735b 100644 --- a/docs/wiki/index.md +++ b/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)