rootiest
859f14a6e9
Audits every function's interaction with the C1-shadowed commands (uses-shadow/bypasses-shadow) and general hazards (destructive, network, blocking-prompt) per the CLASSIFICATION schema. Delegated the initial mechanical sweep to agy, then reviewed every file by hand: fixed a systemic double-blank-comment-line formatting bug from the delegate pass, and corrected several judgment errors found on review -- three false blocking-prompt tags where a fish 'read' was consuming piped input rather than waiting on a terminal (open-url.fish, sbver.fish, play-media.fish, now untagged entirely), a blocking-prompt tag on mkrep.fish despite its documented --yes escape hatch, an untagged read in jobrunner.fish's own baseless blocking-prompt claim (removed, along with a destructive tag on cleanup of its own mktemp output -- the schema explicitly excludes that), the same own-output-cleanup false positive on _zellij_dump_log.fish's destructive tag, an interactive fzf-gated confirmation on logs.fish and replay.fish's piped read misread the same way as the first three, and a uses-shadow(mkdir) on mkcd.fish that actually belongs to the _fish_mkdir_p helper it delegates to, not to mkcd itself.
41 lines
963 B
Fish
41 lines
963 B
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# CATEGORY
|
|
# 07-system-and-monitoring
|
|
#
|
|
# COMPONENT
|
|
# aliases/monitor
|
|
#
|
|
# CLASSIFICATION
|
|
# bypasses-shadow(top)
|
|
#
|
|
# SYNOPSIS
|
|
# top [args...]
|
|
#
|
|
# DESCRIPTION
|
|
# Wraps btop as a modern replacement for top. Falls back to system top
|
|
# if btop is not installed.
|
|
#
|
|
# ARGUMENTS
|
|
# args... Arguments forwarded to btop or system top
|
|
#
|
|
# EXAMPLE
|
|
# top
|
|
function top --wraps='btop' --description 'Use btop as a modern replacement for top'
|
|
# Opinionated guard (C1): fall back to bare command top when disabled.
|
|
if not __fish_config_op_enabled (status current-function)
|
|
command top $argv
|
|
return $status
|
|
end
|
|
|
|
# 1. Check if btop is actually installed
|
|
if type -q btop
|
|
# 2. Launch btop with any arguments passed
|
|
btop $argv
|
|
else
|
|
# 3. Fallback to the original system top if btop is missing
|
|
command top $argv
|
|
end
|
|
end
|