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

docs/fish-config.1

@@ -218,11 +218,23 @@ PAGER       ov (falls back to less)
 .IP
 .nf
 \f[C]
-SCROLLBACK_HISTORY_DIR        \[ti]/.terminal_history
+__fish_scrollback_history_dir        (unset → \[ti]/.terminal_history)
-SCROLLBACK_HISTORY_MAX_FILES  100
+__fish_scrollback_history_max_files  (unset → 100)
+SCROLLBACK_HISTORY_DIR        \[ti]/.terminal_history    (exported mirror)
+SCROLLBACK_HISTORY_MAX_FILES  100                    (exported mirror)
 \f[R]
 .fi
 .PP
+The __fish_scrollback_history_* universal variables are the fish-style
+source of truth \[em] set them via \f[V]config-settings\f[R] → Paths, or
+\f[V]set -U\f[R] directly.
+config.fish exports the SCROLLBACK_HISTORY_* mirrors from them, because
+the POSIX wrapper scripts (paru/yay/tmux/zellij logging and
+_prune_terminal_logs) read the exported names from the environment.
+When the __fish_ vars are unset, the documented defaults are exported.
+config.fish deliberately does not create a global source var, which
+would shadow the universal and stop live edits from taking effect.
+.PP
 Scrollback logs accumulate in SCROLLBACK_HISTORY_DIR as timestamped
 files.
 When the count exceeds SCROLLBACK_HISTORY_MAX_FILES the oldest are
@@ -1712,21 +1724,33 @@ config-update --force
 \f[C]
 Synopsis:  config-settings [-h]
 
-Opens an interactive TUI for managing fish configuration settings. Handles
+Opens an interactive TUI for managing fish configuration settings across
-the six opinionated component categories (C1\[en]C6), the master disable
+four pages, without having to type or remember variable names. Tab cycles
-variable, and the __fish_user_dots_path path variable \[em] without having to
+forward through the pages; Shift-Tab cycles backward.
-type or remember variable names. Two scope tabs allow independent per-scope
-configuration for category toggles:
 
-  Universal \[em] persists across all sessions (set -U)
+  Universal \[em] opinionated category toggles (C1\[en]C6) + master, persistent (set -U)
-  Session   \[em] current shell only (set -g)
+  Session   \[em] the same toggles, current shell only (set -g)
+  Sponge    \[em] sponge history-scrubbing settings: delay, successful exit
+              codes, purge-only-on-exit, allow-previously-successful, and
+              extra sensitive variable-name tokens
+  Paths     \[em] scrollback log directory, scrollback max files, and the
+              user-dots path
 
-The Dots Path row always operates on the universal scope regardless of the
+Toggle rows use ← → (or h/l) along an OFF ← DEFAULT → ON scale; DEFAULT
-active tab.
+erases the variable so the master switch / built-in default applies. Value
+rows (the path/int/list settings on the Sponge and Paths pages) use Enter to
+edit inline; ← / h clears the value back to its default. List rows (e.g.
+Extra secret, OK codes) accept values separated by commas and/or whitespace
+\[em] \[dq]A, B\[dq], \[dq]A,B\[dq] and \[dq]A B\[dq] all yield the same two entries. Changes apply
+immediately. Always available regardless of the __fish_config_opinionated
+master state.
 
-Changes to category toggles apply immediately on each keypress. Changes to
+The Sponge and Paths pages always write universal variables \[em] these are
-the path variable use an inline edit prompt (Enter). Always available
+persistent, set-and-forget settings with no per-session scope. Editing a
-regardless of the __fish_config_opinionated master state.
+scrollback row updates both the __fish_scrollback_history_* source-of-truth
+variables and the exported SCROLLBACK_HISTORY_* mirrors, so the AUR/tmux/
+zellij log wrappers (which read the exported names) see the change in the
+running session.
 
 The panel adapts to the terminal width automatically, selecting from
 four layout tiers (with a 6-column buffer on each side before stepping
@@ -1740,20 +1764,12 @@ redraws within \[ti]0.3 s of a terminal resize with no keypress required.
 
 Navigation:
   ↑ ↓ / k j     Move cursor
-  ← → / h l   Set value: OFF ← DEFAULT → ON (toggle rows); LEFT clears path
+  ← → / h l     Toggle rows: OFF ← DEFAULT → ON
-  Enter        Edit the Dots Path (path row only)
+  ←  / h        Value rows: clear to default
-  Tab          Switch scope (Universal ↔ Session)
+  Enter         Value rows: edit inline (Sponge / Paths pages)
+  Tab / S-Tab   Next / previous page
   q / Escape    Exit
 
-Left/Right (or vim-style h/l) move the highlighted toggle value one step
-along the OFF\[en]DEFAULT\[en]ON scale and stop at the ends. DEFAULT erases the
-variable so the master switch / built-in default applies. On the Dots Path
-row, LEFT/h clears the universal variable; RIGHT/l is a no-op (use Enter).
-
-Dots Path row [U] tag: the tag confirms this row always writes to the
-universal scope, regardless of which tab is active. Setting it per-session
-would have no effect on startup sourcing.
-
 Flags:
   --help / -h   Show usage.
 
@@ -2569,6 +2585,26 @@ To add your own persistent patterns:
 set -U -a sponge_regex_patterns \[aq]your-regex-here\[aq]
 \f[R]
 .fi
+.PP
+To mark additional variable NAMES as credential-bearing (so Layer 2
+scrubs their values), add name tokens \[em] via
+\f[V]config-settings\f[R] → Sponge, or directly:
+.IP
+.nf
+\f[C]
+set -U -a __fish_sponge_extra_sensitive ACME_API VAULT_PW
+\f[R]
+.fi
+.PP
+Tokens are folded into the Layer 2 name match case-insensitively as
+substrings, so ACME_API also covers ACME_API_KEY.
+(The match uses \f[V]--entire\f[R] to return the full variable name, so
+partial-name tokens dereference the right value.)
+.PP
+The \f[V]config-settings\f[R] Sponge page also surfaces sponge\[cq]s own
+tuning variables \[em] sponge_delay, sponge_successful_exit_codes,
+sponge_purge_only_on_exit, and sponge_allow_previously_successful \[em]
+so they can be changed without typing variable names.
 .SS Bundled Plugin Functionality
 .PP
 The remaining plugin functionality is bundled directly with this config

docs/html/12-8-fisher-plugins.html

@@ -533,6 +533,18 @@ credentials in variables exported after login, such as tokens sourced
 from a project .env file mid-session.</p>
 <p>To add your own persistent patterns:</p>
 <pre><code>set -U -a sponge_regex_patterns &#39;your-regex-here&#39;</code></pre>
+<p>To mark additional variable NAMES as credential-bearing (so Layer 2
+scrubs their values), add name tokens — via <code>config-settings</code>
+→ Sponge, or directly:</p>
+<pre><code>set -U -a __fish_sponge_extra_sensitive ACME_API VAULT_PW</code></pre>
+<p>Tokens are folded into the Layer 2 name match case-insensitively as
+substrings, so ACME_API also covers ACME_API_KEY. (The match uses
+<code>--entire</code> to return the full variable name, so partial-name
+tokens dereference the right value.)</p>
+<p>The <code>config-settings</code> Sponge page also surfaces sponge's
+own tuning variables — sponge_delay, sponge_successful_exit_codes,
+sponge_purge_only_on_exit, and sponge_allow_previously_successful — so
+they can be changed without typing variable names.</p>
 <h2 data-number="12.3" id="bundled-plugin-functionality">Bundled Plugin
 Functionality</h2>
 <p>The remaining plugin functionality is bundled directly with this

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

@@ -517,8 +517,19 @@ VISUAL      unset by default; set a GUI editor via local.fish (the edit
 SUDO_EDITOR same as EDITOR
 PAGER       ov (falls back to less)</code></pre>
 <h2 data-number="5.4" id="scrollback-history">Scrollback History</h2>
-<pre><code>SCROLLBACK_HISTORY_DIR        ~/.terminal_history
+<pre><code>__fish_scrollback_history_dir        (unset → ~/.terminal_history)
-SCROLLBACK_HISTORY_MAX_FILES  100</code></pre>
+__fish_scrollback_history_max_files  (unset → 100)
+SCROLLBACK_HISTORY_DIR        ~/.terminal_history    (exported mirror)
+SCROLLBACK_HISTORY_MAX_FILES  100                    (exported mirror)</code></pre>
+<p>The <em><em>fish_scrollback_history</em>* universal variables are the
+fish-style source of truth — set them via <code>config-settings</code> →
+Paths, or <code>set -U</code> directly. config.fish exports the
+SCROLLBACK_HISTORY</em>* mirrors from them, because the POSIX wrapper
+scripts (paru/yay/tmux/zellij logging and _prune_terminal_logs) read the
+exported names from the environment. When the _<em>fish</em> vars are
+unset, the documented defaults are exported. config.fish deliberately
+does not create a global source var, which would shadow the universal
+and stop live edits from taking effect.</p>
 <p>Scrollback logs accumulate in SCROLLBACK_HISTORY_DIR as timestamped
 files. When the count exceeds SCROLLBACK_HISTORY_MAX_FILES the oldest
 are pruned automatically on exit. Use <code>logs</code> to browse them

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

@@ -1159,21 +1159,33 @@ config-update --force</code></pre>
 <h3 data-number="9.14.3" id="config-settings">config-settings</h3>
 <pre><code>Synopsis:  config-settings [-h]
 
-Opens an interactive TUI for managing fish configuration settings. Handles
+Opens an interactive TUI for managing fish configuration settings across
-the six opinionated component categories (C1–C6), the master disable
+four pages, without having to type or remember variable names. Tab cycles
-variable, and the __fish_user_dots_path path variable — without having to
+forward through the pages; Shift-Tab cycles backward.
-type or remember variable names. Two scope tabs allow independent per-scope
-configuration for category toggles:
 
-  Universal — persists across all sessions (set -U)
+  Universal — opinionated category toggles (C1–C6) + master, persistent (set -U)
-  Session   — current shell only (set -g)
+  Session   — the same toggles, current shell only (set -g)
+  Sponge    — sponge history-scrubbing settings: delay, successful exit
+              codes, purge-only-on-exit, allow-previously-successful, and
+              extra sensitive variable-name tokens
+  Paths     — scrollback log directory, scrollback max files, and the
+              user-dots path
 
-The Dots Path row always operates on the universal scope regardless of the
+Toggle rows use ← → (or h/l) along an OFF ← DEFAULT → ON scale; DEFAULT
-active tab.
+erases the variable so the master switch / built-in default applies. Value
+rows (the path/int/list settings on the Sponge and Paths pages) use Enter to
+edit inline; ← / h clears the value back to its default. List rows (e.g.
+Extra secret, OK codes) accept values separated by commas and/or whitespace
+— &quot;A, B&quot;, &quot;A,B&quot; and &quot;A B&quot; all yield the same two entries. Changes apply
+immediately. Always available regardless of the __fish_config_opinionated
+master state.
 
-Changes to category toggles apply immediately on each keypress. Changes to
+The Sponge and Paths pages always write universal variables — these are
-the path variable use an inline edit prompt (Enter). Always available
+persistent, set-and-forget settings with no per-session scope. Editing a
-regardless of the __fish_config_opinionated master state.
+scrollback row updates both the __fish_scrollback_history_* source-of-truth
+variables and the exported SCROLLBACK_HISTORY_* mirrors, so the AUR/tmux/
+zellij log wrappers (which read the exported names) see the change in the
+running session.
 
 The panel adapts to the terminal width automatically, selecting from
 four layout tiers (with a 6-column buffer on each side before stepping
@@ -1187,20 +1199,12 @@ redraws within ~0.3 s of a terminal resize with no keypress required.
 
 Navigation:
   ↑ ↓ / k j     Move cursor
-  ← → / h l   Set value: OFF ← DEFAULT → ON (toggle rows); LEFT clears path
+  ← → / h l     Toggle rows: OFF ← DEFAULT → ON
-  Enter        Edit the Dots Path (path row only)
+  ←  / h        Value rows: clear to default
-  Tab          Switch scope (Universal ↔ Session)
+  Enter         Value rows: edit inline (Sponge / Paths pages)
+  Tab / S-Tab   Next / previous page
   q / Escape    Exit
 
-Left/Right (or vim-style h/l) move the highlighted toggle value one step
-along the OFF–DEFAULT–ON scale and stop at the ends. DEFAULT erases the
-variable so the master switch / built-in default applies. On the Dots Path
-row, LEFT/h clears the universal variable; RIGHT/l is a no-op (use Enter).
-
-Dots Path row [U] tag: the tag confirms this row always writes to the
-universal scope, regardless of which tab is active. Setting it per-session
-would have no effect on startup sourcing.
-
 Flags:
   --help / -h   Show usage.
 

docs/wiki/1-configuration-variables.md

@@ -36,8 +36,19 @@ Tools that respect XDG are directed to these paths rather than polluting $HOME.
 
 ## Scrollback History
 
-    SCROLLBACK_HISTORY_DIR        ~/.terminal_history
+    __fish_scrollback_history_dir        (unset → ~/.terminal_history)
-    SCROLLBACK_HISTORY_MAX_FILES  100
+    __fish_scrollback_history_max_files  (unset → 100)
+    SCROLLBACK_HISTORY_DIR        ~/.terminal_history    (exported mirror)
+    SCROLLBACK_HISTORY_MAX_FILES  100                    (exported mirror)
+
+The __fish_scrollback_history_* universal variables are the fish-style source
+of truth — set them via `config-settings` → Paths, or `set -U` directly.
+config.fish exports the SCROLLBACK_HISTORY_* mirrors from them, because the
+POSIX wrapper scripts (paru/yay/tmux/zellij logging and _prune_terminal_logs)
+read the exported names from the environment. When the __fish_ vars are unset,
+the documented defaults are exported. config.fish deliberately does not create
+a global source var, which would shadow the universal and stop live edits from
+taking effect.
 
 Scrollback logs accumulate in SCROLLBACK_HISTORY_DIR as timestamped files.
 When the count exceeds SCROLLBACK_HISTORY_MAX_FILES the oldest are pruned

docs/wiki/5-functions-reference.md

@@ -845,21 +845,33 @@
 
     Synopsis:  config-settings [-h]
 
-    Opens an interactive TUI for managing fish configuration settings. Handles
+    Opens an interactive TUI for managing fish configuration settings across
-    the six opinionated component categories (C1–C6), the master disable
+    four pages, without having to type or remember variable names. Tab cycles
-    variable, and the __fish_user_dots_path path variable — without having to
+    forward through the pages; Shift-Tab cycles backward.
-    type or remember variable names. Two scope tabs allow independent per-scope
-    configuration for category toggles:
 
-      Universal — persists across all sessions (set -U)
+      Universal — opinionated category toggles (C1–C6) + master, persistent (set -U)
-      Session   — current shell only (set -g)
+      Session   — the same toggles, current shell only (set -g)
+      Sponge    — sponge history-scrubbing settings: delay, successful exit
+                  codes, purge-only-on-exit, allow-previously-successful, and
+                  extra sensitive variable-name tokens
+      Paths     — scrollback log directory, scrollback max files, and the
+                  user-dots path
 
-    The Dots Path row always operates on the universal scope regardless of the
+    Toggle rows use ← → (or h/l) along an OFF ← DEFAULT → ON scale; DEFAULT
-    active tab.
+    erases the variable so the master switch / built-in default applies. Value
+    rows (the path/int/list settings on the Sponge and Paths pages) use Enter to
+    edit inline; ← / h clears the value back to its default. List rows (e.g.
+    Extra secret, OK codes) accept values separated by commas and/or whitespace
+    — "A, B", "A,B" and "A B" all yield the same two entries. Changes apply
+    immediately. Always available regardless of the __fish_config_opinionated
+    master state.
 
-    Changes to category toggles apply immediately on each keypress. Changes to
+    The Sponge and Paths pages always write universal variables — these are
-    the path variable use an inline edit prompt (Enter). Always available
+    persistent, set-and-forget settings with no per-session scope. Editing a
-    regardless of the __fish_config_opinionated master state.
+    scrollback row updates both the __fish_scrollback_history_* source-of-truth
+    variables and the exported SCROLLBACK_HISTORY_* mirrors, so the AUR/tmux/
+    zellij log wrappers (which read the exported names) see the change in the
+    running session.
 
     The panel adapts to the terminal width automatically, selecting from
     four layout tiers (with a 6-column buffer on each side before stepping
@@ -873,20 +885,12 @@
 
     Navigation:
       ↑ ↓ / k j     Move cursor
-      ← → / h l   Set value: OFF ← DEFAULT → ON (toggle rows); LEFT clears path
+      ← → / h l     Toggle rows: OFF ← DEFAULT → ON
-      Enter        Edit the Dots Path (path row only)
+      ←  / h        Value rows: clear to default
-      Tab          Switch scope (Universal ↔ Session)
+      Enter         Value rows: edit inline (Sponge / Paths pages)
+      Tab / S-Tab   Next / previous page
       q / Escape    Exit
 
-    Left/Right (or vim-style h/l) move the highlighted toggle value one step
-    along the OFF–DEFAULT–ON scale and stop at the ends. DEFAULT erases the
-    variable so the master switch / built-in default applies. On the Dots Path
-    row, LEFT/h clears the universal variable; RIGHT/l is a no-op (use Enter).
-
-    Dots Path row [U] tag: the tag confirms this row always writes to the
-    universal scope, regardless of which tab is active. Setting it per-session
-    would have no effect on startup sourcing.
-
     Flags:
       --help / -h   Show usage.
 

docs/wiki/8-fisher-plugins.md

@@ -58,6 +58,20 @@ To add your own persistent patterns:
 
     set -U -a sponge_regex_patterns 'your-regex-here'
 
+To mark additional variable NAMES as credential-bearing (so Layer 2 scrubs
+their values), add name tokens — via `config-settings` → Sponge, or directly:
+
+    set -U -a __fish_sponge_extra_sensitive ACME_API VAULT_PW
+
+Tokens are folded into the Layer 2 name match case-insensitively as substrings,
+so ACME_API also covers ACME_API_KEY. (The match uses `--entire` to return the
+full variable name, so partial-name tokens dereference the right value.)
+
+The `config-settings` Sponge page also surfaces sponge's own tuning variables —
+sponge_delay, sponge_successful_exit_codes, sponge_purge_only_on_exit, and
+sponge_allow_previously_successful — so they can be changed without typing
+variable names.
+
 ## Bundled Plugin Functionality
 
 The remaining plugin functionality is bundled directly with this config rather