ai need to continue ...

2026-08-05 05:47:45 -04:00
parent 494eae2bdf
commit e62626b55c
19 changed files with 254 additions and 51 deletions
@@ -34,21 +34,22 @@ Linux_post_install/
 │
 ├── bin/                    # CLI tools — installed to /usr/local/bin/
 │   ├── pos                 # Main dispatcher — smart arg matching to pos-* scripts
-│   ├── pos-network-ip      # Show interfaces, routes, public IP + location
-│   ├── pos-network-checkport  # TCP port checker
-│   ├── pos-network-scan    # Parallel ping sweep of CIDR subnet
-│   ├── pos-docker-ps       # Enhanced docker ps (health, IPs, ports, uptime)
-│   ├── pos-docker-health   # Quick one-glance health dashboard
-│   ├── pos-docker-compose  # Docker Compose service manager (largest script, 363 lines)
-│   ├── pos-media-mp3       # Audio downloader (yt-dlp → MP3)
-│   ├── pos-media-mp4       # Video downloader (yt-dlp → MP4, interactive format select)
-│   ├── pos-system-firewall # Interactive UFW manager (menu-driven, 284 lines)
-│   ├── pos-system-backup   # Encrypted folder snapshots (tar + gpg AES-256, --service) (115 lines)
-│   ├── pos-ssh-load-keys   # Load SSH keys into ssh-agent
-│   ├── pos-usb-server      # USB Redirector server control (usbsrv)
-│   ├── pos-communication-telegram  # Send Telegram messages via Bot API
-│   ├── pos-docker-vbox     # Disposable Docker-based "VMs" (pos docker vbox)
-│   ├── pos-network-hotspot # Wi-Fi hotspot (create_ap + wihotspot-gui)
+<!-- GEN:START tree -->
+│   ├── pos-docker-compose         # Docker Compose service manager (ls/up/down/restart/logs/update/config)
+│   ├── pos-docker-health          # One-glance container health dashboard (exits 1 if unhealthy)
+│   ├── pos-docker-ps              # Enhanced container overview (health, IPs, ports, uptime)
+│   ├── pos-docker-vbox            # Disposable Docker-based VMs (create/enter/start/stop/rm/ls)
+│   ├── pos-media-mp3              # Download audio as MP3 (yt-dlp)
+│   ├── pos-media-mp4              # Download video as MP4 (interactive format select)
+│   ├── pos-network-checkport      # Check TCP port connectivity
+│   ├── pos-network-hotspot        # Wi-Fi hotspot via create_ap + wihotspot-gui
+│   ├── pos-network-ip             # Show interfaces, routes, public IP + location
+│   ├── pos-network-scan           # Parallel ping sweep of CIDR
+│   ├── pos-ssh-load-keys          # Load all SSH keys into the agent
+│   ├── pos-system-backup          # Encrypted (AES-256) folder snapshots (tar + gpg)
+│   ├── pos-system-firewall        # Interactive UFW management
+│   ├── pos-usb-server             # USB Redirector server control (--ls, --share; prompts when args omitted)
+<!-- GEN:END tree -->
 │   ├── flag-reader         # Inspect feature flags (list/status/--raw)
 │   ├── flag-set            # Set a feature flag (optionally with a value)
 │   ├── flag-clear          # Unset a feature flag
@@ -197,20 +198,22 @@ All non-interactive `pos` commands log output to `~/.local/share/linux_post_inst

 | Category | Command | Script | Description |
 |----------|---------|--------|-------------|
-| network | ip | `pos-network-ip` | Show interfaces, routes, public IP + location |
+<!-- GEN:START dispatch -->
+| docker | compose | `pos-docker-compose` | Docker Compose service manager (ls/up/down/restart/logs/update/config) |
+| docker | health | `pos-docker-health` | One-glance container health dashboard (exits 1 if unhealthy) |
+| docker | ps | `pos-docker-ps` | Enhanced container overview (health, IPs, ports, uptime) |
+| docker | vbox | `pos-docker-vbox` | Disposable Docker-based VMs (create/enter/start/stop/rm/ls) |
+| media | mp3 | `pos-media-mp3` | Download audio as MP3 (yt-dlp) |
+| media | mp4 | `pos-media-mp4` | Download video as MP4 (interactive format select) |
 | network | checkport | `pos-network-checkport` | Check TCP port connectivity |
+| network | hotspot | `pos-network-hotspot` | Wi-Fi hotspot via create_ap + wihotspot-gui |
+| network | ip | `pos-network-ip` | Show interfaces, routes, public IP + location |
 | network | scan | `pos-network-scan` | Parallel ping sweep of CIDR |
-| docker | ps | `pos-docker-ps` | Enhanced container overview |
-| docker | health | `pos-docker-health` | Quick health dashboard (exits 1 if unhealthy) |
-| docker | compose | `pos-docker-compose` | Service manager (ls/up/down/restart/logs/update/config) |
-| media | mp3 | `pos-media-mp3` | Download audio as MP3 |
-| media | mp4 | `pos-media-mp4` | Download video with format select |
+| ssh | load-keys | `pos-ssh-load-keys` | Load all SSH keys into the agent |
+| system | backup | `pos-system-backup` | Encrypted (AES-256) folder snapshots (tar + gpg) |
 | system | firewall | `pos-system-firewall` | Interactive UFW management |
-| system | backup | `pos-system-backup` | Encrypted folder snapshots (`tar` + gpg AES-256; `--service` picks from `/srv` and `~/srv`) |
-| ssh | load-keys | `pos-ssh-load-keys` | Load SSH keys into agent |
-| usb | server | `pos-usb-server` | USB Redirector server control: `--ls`, `--share`, `--unshare`, `--auto-share`, `--callback`, `--disconnect`, `--nickname`, `--timeout`, `--port`, `--info`, `--version` (flag-style, prompts when args omitted) |
-| communication | telegram | `pos-communication-telegram` | Send Telegram messages via Bot API (`--send`, `test`, `config set`); config in `~/.config/linux_post_install/telegram.env` |
-| docker | vbox | `pos-docker-vbox` | Disposable Docker "VMs" (`create/enter/start/stop/rm/ls`; label-filtered, auto-enter prompt) |
+| usb | server | `pos-usb-server` | USB Redirector server control (--ls, --share; prompts when args omitted) |
+<!-- GEN:END dispatch -->

 ### Legacy Wrappers

@@ -252,7 +255,10 @@ Sourced by most scripts. Provides:
 source "$(dirname "$0")/../lib/common.sh"
 ```

-**Scripts that do NOT source common.sh** (self-contained): `bin/pos`, `pos-network-ip`, `pos-network-checkport`, `pos-network-scan`, `pos-network-hotspot`, `pos-media-mp3`, `pos-media-mp4`, `pos-ssh-load-keys`, `pos-system-firewall`, `pos-communication-telegram`.
+**Scripts that do NOT source common.sh** (self-contained):
+<!-- GEN:START selfcontained -->
+`bin/pos`, `pos-network-ip`, `pos-network-checkport`, `pos-network-scan`, `pos-network-hotspot`, `pos-media-mp3`, `pos-media-mp4`, `pos-ssh-load-keys`, `pos-system-firewall`, `pos-communication-telegram`.
+<!-- GEN:END selfcontained -->

 ---

@@ -460,17 +466,22 @@ Use conventional prefixes: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`
 | `bin/flag-set` | 21 | Set a flag (optionally with a value) |
 | `bin/flag-clear` | 21 | Unset a flag |
 | `features/autostart.sh` | 14 | Boot-time feature (moved from `bin/`, flag-gated service) |
-| `bin/pos` | 195 | CLI dispatcher with smart arg matching + logging + category help |
-| `bin/pos-docker-compose` | 363 | Largest script — full compose management |
-| `bin/pos-system-firewall` | 284 | Interactive UFW manager |
-| `bin/pos-system-backup` | 115 | Encrypted folder snapshots: path mode + `--service` (`/srv`, `~/srv` picker), tar + gpg AES-256 |
-| `bin/pos-docker-ps` | 127 | Enhanced container overview |
-| `bin/pos-docker-health` | 109 | Quick health dashboard |
-| `bin/pos-docker-vbox` | 156 | Docker-based disposable VMs (`pos docker vbox`; label-filtered, auto-enter prompt) |
-| `bin/pos-network-hotspot` | 91 | Wi-Fi hotspot: `create_ap` (start with background prompt/`--foreground`, stop, status) + `wihotspot-gui` |
-| `bin/pos-communication-telegram` | 138 | Telegram sender via Bot API: `--send`, `test`, `config set`; token masked; config `~/.config/linux_post_install/telegram.env` |
-| `bin/pos-usb-server` | 216 | USB Redirector server control (`usbsrv`): `--ls`, `--share` (interactive picker), `--unshare`, `--auto-share`, `--callback`, `--close-callback`, `--auto-connect`, `--disconnect`, `--nickname`, `--timeout`, `--port`, `--info`, `--version` |
-| `completions/pos.bash` | 129 | Dynamic bash completion |
+| `bin/pos-communication-telegram` | 140 | Send Telegram messages via Bot API (--send, test, config set) |
+| `bin/pos-docker-compose` | 364 | Docker Compose service manager (ls/up/down/restart/logs/update/config) |
+| `bin/pos-docker-health` | 110 | One-glance container health dashboard (exits 1 if unhealthy) |
+| `bin/pos-docker-ps` | 128 | Enhanced container overview (health, IPs, ports, uptime) |
+| `bin/pos-docker-vbox` | 157 | Disposable Docker-based VMs (create/enter/start/stop/rm/ls) |
+| `bin/pos-media-mp3` | 31 | Download audio as MP3 (yt-dlp) |
+| `bin/pos-media-mp4` | 34 | Download video as MP4 (interactive format select) |
+| `bin/pos-network-checkport` | 45 | Check TCP port connectivity |
+| `bin/pos-network-hotspot` | 93 | Wi-Fi hotspot via create_ap + wihotspot-gui |
+| `bin/pos-network-ip` | 69 | Show interfaces, routes, public IP + location |
+| `bin/pos-network-scan` | 271 | Parallel ping sweep of CIDR |
+| `bin/pos-ssh-load-keys` | 31 | Load all SSH keys into the agent |
+| `bin/pos-system-backup` | 117 | Encrypted (AES-256) folder snapshots (tar + gpg) |
+| `bin/pos-system-firewall` | 285 | Interactive UFW management |
+| `bin/pos-usb-server` | 218 | USB Redirector server control (--ls, --share; prompts when args omitted) |
+| `completions/pos.bash` | 146 | Dynamic bash completion |
 | `apps/install.sh` | 171 | App install/uninstall picker/orchestrator |

 ---