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

docs/fish-config.1

@@ -207,6 +207,11 @@ CLAUDE_CODE_NO_FLICKER  1    \[em] suppress terminal flicker in Claude Code
 CDPATH               . \[ti]/projects \[ti]
 \f[R]
 .fi
+.PP
+Opinionated defaults (CDPATH, PAGER/MANPAGER, Vi mode, command shadows,
+terminal integrations) can be switched off per category with universal
+variables \[em] see Section 7, \[lq]Opinionated Components (Minimal
+Mode)\[rq].
 .SS Pager Hierarchy
 .PP
 $PAGER is set to ov when available, falling back to less.
@@ -1770,6 +1775,73 @@ Some settings (fzf colors, theme) are stored in fish_variables via
 \f[V]set -U\f[R].
 These are machine-local and git-ignored.
 Do not commit fish_variables.
+.SS Opinionated Components (Minimal Mode)
+.PP
+Every opinionated piece of this config is active by default but can be
+switched off through four category opt-out variables, each evaluated via
+__fish_variable_check.
+Set a variable to any falsy value (0, false, no, off, n) to disable its
+category; erase it or set a truthy value (1, true, yes, on, y) to
+re-enable.
+Unset means enabled.
+.IP
+.nf
+\f[C]
+Variable                        Disables
+------------------------------  ------------------------------------
+__fish_config_op_aliases        Command shadows and flag injection:
+                                ls->eza, cat->bat, cd->zoxide,
+                                rm->trash, less->ov, top->btop,
+                                ping->prettyping, ssh->kitten,
+                                du->duf/dust, mkdir/bash wrappers,
+                                history timestamps, grep/cp/mv/wget
+                                flag injection, help intercept
+__fish_config_op_autoexec       Startup side-effects: Fisher
+                                bootstrap, theme apply, paru/yay
+                                wrapper generation, auto venv
+                                activation, WakaTime hook
+__fish_config_op_overrides      Key and env overrides: Vi mode,
+                                exit->smart_exit, PAGER/MANPAGER,
+                                CDPATH, bang-bang system, autopair,
+                                puffer, starship prompt, theme
+                                colors, FZF_DEFAULT_OPTS, right
+                                prompt
+__fish_config_op_integrations   Terminal/tool coupling: Kitty/
+                                WezTerm window abbreviations, done
+                                notifications, spwin/tab/split,
+                                hist, logs, upgrade, WakaTime
+\f[R]
+.fi
+.PP
+Examples:
+.IP
+.nf
+\f[C]
+# Disable command shadows only (rm becomes plain rm again):
+set -U __fish_config_op_aliases off
+
+# Full minimal mode \[em] disable all four categories at once:
+set -U __fish_config_opinionated 0
+
+# Re-enable everything:
+set -Ue __fish_config_opinionated
+\f[R]
+.fi
+.PP
+Notes:
+.IP \[bu] 2
+Command shadows (rm, cat, ls, \&...)
+react immediately; conf.d-level components (bindings, prompt,
+abbreviations, hooks) take effect in new shells.
+.IP \[bu] 2
+With aliases disabled, rm falls back to bare \f[V]command rm\f[R] \[em]
+files are deleted permanently, not trashed.
+.IP \[bu] 2
+Disabled integration commands (spwin, tab, split, hist, logs, upgrade)
+print an error naming the variable that disabled them.
+.IP \[bu] 2
+On CachyOS, the distro fish config\[cq]s own aliases, history override,
+and bang-bang bindings are stripped per category as well.
 .SS Prompt and Theme
 .SS Starship
 .PP

docs/html/11-7-customization.html

@@ -515,8 +515,60 @@ Variables</h2>
 <p>Some settings (fzf colors, theme) are stored in fish_variables via
 <code>set -U</code>. These are machine-local and git-ignored. Do not
 commit fish_variables.</p>
-<h2 data-number="11.5" id="prompt-and-theme">Prompt and Theme</h2>
+<h2 data-number="11.5"
-<h3 data-number="11.5.1" id="starship">Starship</h3>
+id="opinionated-components-minimal-mode">Opinionated Components (Minimal
+Mode)</h2>
+<p>Every opinionated piece of this config is active by default but can
+be switched off through four category opt-out variables, each evaluated
+via __fish_variable_check. Set a variable to any falsy value (0, false,
+no, off, n) to disable its category; erase it or set a truthy value (1,
+true, yes, on, y) to re-enable. Unset means enabled.</p>
+<pre><code>Variable                        Disables
+------------------------------  ------------------------------------
+__fish_config_op_aliases        Command shadows and flag injection:
+                                ls-&gt;eza, cat-&gt;bat, cd-&gt;zoxide,
+                                rm-&gt;trash, less-&gt;ov, top-&gt;btop,
+                                ping-&gt;prettyping, ssh-&gt;kitten,
+                                du-&gt;duf/dust, mkdir/bash wrappers,
+                                history timestamps, grep/cp/mv/wget
+                                flag injection, help intercept
+__fish_config_op_autoexec       Startup side-effects: Fisher
+                                bootstrap, theme apply, paru/yay
+                                wrapper generation, auto venv
+                                activation, WakaTime hook
+__fish_config_op_overrides      Key and env overrides: Vi mode,
+                                exit-&gt;smart_exit, PAGER/MANPAGER,
+                                CDPATH, bang-bang system, autopair,
+                                puffer, starship prompt, theme
+                                colors, FZF_DEFAULT_OPTS, right
+                                prompt
+__fish_config_op_integrations   Terminal/tool coupling: Kitty/
+                                WezTerm window abbreviations, done
+                                notifications, spwin/tab/split,
+                                hist, logs, upgrade, WakaTime</code></pre>
+<p>Examples:</p>
+<pre><code># Disable command shadows only (rm becomes plain rm again):
+set -U __fish_config_op_aliases off
+
+# Full minimal mode — disable all four categories at once:
+set -U __fish_config_opinionated 0
+
+# Re-enable everything:
+set -Ue __fish_config_opinionated</code></pre>
+<p>Notes:</p>
+<ul>
+<li>Command shadows (rm, cat, ls, ...) react immediately; conf.d-level
+components (bindings, prompt, abbreviations, hooks) take effect in new
+shells.</li>
+<li>With aliases disabled, rm falls back to bare <code>command rm</code>
+— files are deleted permanently, not trashed.</li>
+<li>Disabled integration commands (spwin, tab, split, hist, logs,
+upgrade) print an error naming the variable that disabled them.</li>
+<li>On CachyOS, the distro fish config's own aliases, history override,
+and bang-bang bindings are stripped per category as well.</li>
+</ul>
+<h2 data-number="11.6" id="prompt-and-theme">Prompt and Theme</h2>
+<h3 data-number="11.6.1" id="starship">Starship</h3>
 <p>The primary prompt is Starship, initialized by conf.d/starship.fish.
 Configure it via ~/.config/starship.toml.</p>
 <p>conf.d/starship.fish defines a fish_prompt wrapper that only
@@ -526,14 +578,14 @@ immediately after, placing both markers on the prompt line itself. This
 allows ov to use them as sticky section headers when browsing scrollback
 logs. Without Starship, fish's built-in prompt handles these markers
 automatically.</p>
-<h3 data-number="11.5.2" id="fzf">FZF</h3>
+<h3 data-number="11.6.2" id="fzf">FZF</h3>
 <p>FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in
 integrations/fzf.fish. The colors applied:</p>
 <pre><code>Background:   #1E1E2E (base)    #313244 (surface0)
 Foreground:   #CDD6F4 (text)
 Highlights:   #F38BA8 (red)     #CBA6F7 (mauve)    #B4BEFE (lavender)</code></pre>
 <p>To customize, override FZF_DEFAULT_OPTS in local.fish.</p>
-<h3 data-number="11.5.3"
+<h3 data-number="11.6.3"
 id="catppuccin-mocha-syntax-highlighting">Catppuccin Mocha Syntax
 Highlighting</h3>
 <p>The Catppuccin Mocha theme ships with this config in themes/ and is

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

@@ -525,6 +525,10 @@ interactively.</p>
 <pre><code>GPG_TTY              $(tty)  — ensures GPG passphrase prompts work
 CLAUDE_CODE_NO_FLICKER  1    — suppress terminal flicker in Claude Code
 CDPATH               . ~/projects ~</code></pre>
+<p>Opinionated defaults (CDPATH, PAGER/MANPAGER, Vi mode, command
+shadows, terminal integrations) can be switched off per category with
+universal variables — see Section 7, "Opinionated Components (Minimal
+Mode)".</p>
 <h2 data-number="5.6" id="pager-hierarchy">Pager Hierarchy</h2>
 <p>$PAGER is set to ov when available, falling back to less. The less
 wrapper function extends this into a full chain so anything that calls

docs/html/index.html

@@ -818,6 +818,10 @@ id="toc-overriding-configuration-variables">Overriding Configuration
 Variables</a></li>
 <li><a href="11-7-customization.html#fish-universal-variables"
 id="toc-fish-universal-variables">Fish Universal Variables</a></li>
+<li><a
+href="11-7-customization.html#opinionated-components-minimal-mode"
+id="toc-opinionated-components-minimal-mode">Opinionated Components
+(Minimal Mode)</a></li>
 <li><a href="11-7-customization.html#prompt-and-theme"
 id="toc-prompt-and-theme">Prompt and Theme</a>
 <ul>

docs/wiki/1-configuration-variables.md

@@ -48,6 +48,10 @@ automatically on exit. Use `logs` to browse them interactively.
     CLAUDE_CODE_NO_FLICKER  1    — suppress terminal flicker in Claude Code
     CDPATH               . ~/projects ~
 
+Opinionated defaults (CDPATH, PAGER/MANPAGER, Vi mode, command shadows,
+terminal integrations) can be switched off per category with universal
+variables — see Section 7, "Opinionated Components (Minimal Mode)".
+
 ## Pager Hierarchy
 
 $PAGER is set to ov when available, falling back to less. The less wrapper

docs/wiki/7-customization.md

@@ -37,6 +37,61 @@ Some settings (fzf colors, theme) are stored in fish_variables via
 `set -U`. These are machine-local and git-ignored. Do not commit
 fish_variables.
 
+## Opinionated Components (Minimal Mode)
+
+Every opinionated piece of this config is active by default but can be
+switched off through four category opt-out variables, each evaluated via
+__fish_variable_check. Set a variable to any falsy value (0, false, no,
+off, n) to disable its category; erase it or set a truthy value (1, true,
+yes, on, y) to re-enable. Unset means enabled.
+
+    Variable                        Disables
+    ------------------------------  ------------------------------------
+    __fish_config_op_aliases        Command shadows and flag injection:
+                                    ls->eza, cat->bat, cd->zoxide,
+                                    rm->trash, less->ov, top->btop,
+                                    ping->prettyping, ssh->kitten,
+                                    du->duf/dust, mkdir/bash wrappers,
+                                    history timestamps, grep/cp/mv/wget
+                                    flag injection, help intercept
+    __fish_config_op_autoexec       Startup side-effects: Fisher
+                                    bootstrap, theme apply, paru/yay
+                                    wrapper generation, auto venv
+                                    activation, WakaTime hook
+    __fish_config_op_overrides      Key and env overrides: Vi mode,
+                                    exit->smart_exit, PAGER/MANPAGER,
+                                    CDPATH, bang-bang system, autopair,
+                                    puffer, starship prompt, theme
+                                    colors, FZF_DEFAULT_OPTS, right
+                                    prompt
+    __fish_config_op_integrations   Terminal/tool coupling: Kitty/
+                                    WezTerm window abbreviations, done
+                                    notifications, spwin/tab/split,
+                                    hist, logs, upgrade, WakaTime
+
+Examples:
+
+    # Disable command shadows only (rm becomes plain rm again):
+    set -U __fish_config_op_aliases off
+
+    # Full minimal mode — disable all four categories at once:
+    set -U __fish_config_opinionated 0
+
+    # Re-enable everything:
+    set -Ue __fish_config_opinionated
+
+Notes:
+
+  - Command shadows (rm, cat, ls, ...) react immediately; conf.d-level
+    components (bindings, prompt, abbreviations, hooks) take effect in
+    new shells.
+  - With aliases disabled, rm falls back to bare `command rm` — files
+    are deleted permanently, not trashed.
+  - Disabled integration commands (spwin, tab, split, hist, logs,
+    upgrade) print an error naming the variable that disabled them.
+  - On CachyOS, the distro fish config's own aliases, history override,
+    and bang-bang bindings are stripped per category as well.
+
 ## Prompt and Theme
 
 ### Starship