@fredlackey/devutils 0.0.17 → 0.0.19

package/src/installs/dependencies.md

@@ -1,453 +0,0 @@
-# Dependency Analysis Summary
-
-**Last Updated:** 2026-01-17
-**Total Test-Pending Technologies:** 8
-**Already Documented (Skipped):** 8
-**Analyzed This Run:** 0
-**Successful:** 0
-**Failed:** 0
-
-## Results
-
-| Technology | Installer | Documentation | Status |
-|------------|-----------|---------------|--------|
-| Adobe Creative Cloud | src/installs/adobe-creative-cloud.js | src/installs/adobe-creative-cloud.md | Complete - has dependencies |
-| Cloudflare WARP | src/installs/cloudflare-warp.js | src/installs/cloudflare-warp.md | Skipped - already documented |
-| Comet Browser | src/installs/comet-browser.js | src/installs/comet-browser.md | Skipped - already documented |
-| DBeaver | src/installs/dbeaver.js | src/installs/dbeaver.md | Skipped - already documented |
-| Google Antigravity | src/installs/google-antigravity.js | src/installs/google-antigravity.md | Skipped - already documented |
-| Kiro | src/installs/kiro.js | src/installs/kiro.md | Skipped - already documented |
-| Moom | src/installs/moom.js | src/installs/moom.md | Skipped - already documented |
-| NordVPN | src/installs/nordvpn.js | src/installs/nordvpn.md | Skipped - already documented |
-| Parallels Desktop | src/installs/parallels-desktop.js | src/installs/parallels-desktop.md | Skipped - already documented |
-| AppCleaner | src/installs/appcleaner.js | src/installs/appcleaner.md | Complete - has dependencies |
-| apt-transport-https | src/installs/apt-transport-https.js | src/installs/apt-transport-https.md | Skipped - already documented |
-| AtomicParsley | src/installs/atomicparsley.js | src/installs/atomicparsley.md | Complete - has dependencies |
-| AWS CLI | src/installs/aws-cli.js | src/installs/aws-cli.md | Complete - has dependencies |
-| Balena Etcher | src/installs/balena-etcher.js | src/installs/balena-etcher.md | Complete - has dependencies |
-| Bambu Studio | src/installs/bambu-studio.js | src/installs/bambu-studio.md | Complete - has dependencies |
-| Bash Completion 2 | src/installs/bash-completion.js | src/installs/bash-completion.md | Complete - has dependencies |
-| Bash | src/installs/bash.js | src/installs/bash.md | Complete - has dependencies |
-| Beyond Compare | src/installs/beyond-compare.js | src/installs/beyond-compare.md | Complete - has dependencies |
-| Brave Browser | src/installs/brave-browser.js | src/installs/brave-browser.md | Skipped - already documented |
-| build-essential | src/installs/build-essential.js | src/installs/build-essential.md | Skipped - already documented |
-| ca-certificates | src/installs/ca-certificates.js | src/installs/ca-certificates.md | Skipped - already documented |
-| Caffeine | src/installs/caffeine.js | src/installs/caffeine.md | Complete - has dependencies |
-| Camtasia | src/installs/camtasia.js | src/installs/camtasia.md | Complete - has dependencies |
-| ChatGPT | src/installs/chatgpt.js | src/installs/chatgpt.md | Complete - has dependencies |
-| Chocolatey | src/installs/chocolatey.js | src/installs/chocolatey.md | Skipped - already documented |
-| Google Chrome Canary | src/installs/chrome-canary.js | src/installs/chrome-canary.md | Complete - has dependencies |
-| Chromium | src/installs/chromium.js | src/installs/chromium.md | Complete - has dependencies |
-| Claude Code | src/installs/claude-code.js | src/installs/claude-code.md | Complete - has dependencies |
-| cURL | src/installs/curl.js | src/installs/curl.md | Complete - has dependencies |
-| Cursor | src/installs/cursor.js | src/installs/cursor.md | Complete - has dependencies |
-| DbSchema | src/installs/dbschema.js | src/installs/dbschema.md | Complete - has dependencies |
-| Development Tools | src/installs/development-tools.js | src/installs/development-tools.md | Skipped - already documented |
-| Docker | src/installs/docker.js | src/installs/docker.md | Complete - has dependencies |
-| Draw.IO | src/installs/drawio.js | src/installs/drawio.md | Complete - has dependencies |
-| Elmedia Player | src/installs/elmedia-player.js | src/installs/elmedia-player.md | Complete - has dependencies |
-| FFmpeg | src/installs/ffmpeg.js | src/installs/ffmpeg.md | Complete - has dependencies |
-| file | src/installs/file.js | src/installs/file.md | Skipped - already documented |
-| Gemini CLI | src/installs/gemini-cli.js | src/installs/gemini-cli.md | Complete - has dependencies |
-| Git | src/installs/git.js | src/installs/git.md | Complete - has dependencies |
-| gitego | src/installs/gitego.js | src/installs/gitego.md | Complete - has dependencies |
-| Go | src/installs/go.js | src/installs/go.md | Complete - has dependencies |
-| Google Chrome | src/installs/google-chrome.js | src/installs/google-chrome.md | Complete - has dependencies |
-| GPG | src/installs/gpg.js | src/installs/gpg.md | Complete - has dependencies |
-| Homebrew | src/installs/homebrew.js | src/installs/homebrew.md | Complete - has dependencies |
-| ImageOptim | src/installs/imageoptim.js | src/installs/imageoptim.md | Complete - has dependencies |
-| jq | src/installs/jq.js | src/installs/jq.md | Complete - has dependencies |
-| Keyboard Maestro | src/installs/keyboard-maestro.js | src/installs/keyboard-maestro.md | Complete - has dependencies |
-| LaTeX | src/installs/latex.js | src/installs/latex.md | Complete - has dependencies |
-| LFTP | src/installs/lftp.js | src/installs/lftp.md | Complete - has dependencies |
-| lsb-release | src/installs/lsb-release.js | src/installs/lsb-release.md | Skipped - already documented |
-| Messenger | src/installs/messenger.js | src/installs/messenger.md | Complete - has dependencies |
-| Microsoft Office 365 | src/installs/microsoft-office.js | src/installs/microsoft-office.md | Complete - has dependencies |
-| Microsoft Teams | src/installs/microsoft-teams.js | src/installs/microsoft-teams.md | Complete - has dependencies |
-| Node.js | src/installs/node.js | src/installs/node.md | Complete - has dependencies |
-| Nord Pass | src/installs/nordpass.js | src/installs/nordpass.md | Complete - has dependencies |
-| nvm | src/installs/nvm.js | src/installs/nvm.md | Complete - has dependencies |
-| OpenSSH | src/installs/openssh.js | src/installs/openssh.md | Complete - has dependencies |
-| Pandoc | src/installs/pandoc.js | src/installs/pandoc.md | Complete - has dependencies |
-| pinentry | src/installs/pinentry.js | src/installs/pinentry.md | Complete - has dependencies |
-| Pngyu | src/installs/pngyu.js | src/installs/pngyu.md | Complete - has dependencies |
-| Postman | src/installs/postman.js | src/installs/postman.md | Complete - has dependencies |
-| procps | src/installs/procps.js | src/installs/procps.md | Skipped - already documented |
-| Safari Technology Preview | src/installs/safari-tech-preview.js | src/installs/safari-tech-preview.md | Complete - has dependencies |
-| sfnt2woff | src/installs/sfnt2woff.js | src/installs/sfnt2woff.md | Complete - has dependencies |
-| ShellCheck | src/installs/shellcheck.js | src/installs/shellcheck.md | Complete - has dependencies |
-| Slack | src/installs/slack.js | src/installs/slack.md | Complete - has dependencies |
-| Snagit | src/installs/snagit.js | src/installs/snagit.md | Complete - has dependencies |
-| software-properties-common | src/installs/software-properties-common.js | src/installs/software-properties-common.md | Skipped - already documented |
-| Spotify | src/installs/spotify.js | src/installs/spotify.md | Complete - has dependencies |
-| Studio 3T | src/installs/studio-3t.js | src/installs/studio-3t.md | Complete - has dependencies |
-| Sublime Text | src/installs/sublime-text.js | src/installs/sublime-text.md | Complete - has dependencies |
-| Superwhisper | src/installs/superwhisper.js | src/installs/superwhisper.md | Complete - has dependencies |
-| Tailscale | src/installs/tailscale.js | src/installs/tailscale.md | Complete - has dependencies |
-| tar | src/installs/tar.js | src/installs/tar.md | Skipped - already documented |
-| Termius | src/installs/termius.js | src/installs/termius.md | Complete - has dependencies |
-| Terraform | src/installs/terraform.js | src/installs/terraform.md | Complete - has dependencies |
-| Tidal | src/installs/tidal.js | src/installs/tidal.md | Complete - has dependencies |
-| tmux | src/installs/tmux.js | src/installs/tmux.md | Complete - has dependencies |
-| Tree | src/installs/tree.js | src/installs/tree.md | Complete - has dependencies |
-| unzip | src/installs/unzip.js | src/installs/unzip.md | Skipped - already documented |
-| Vim | src/installs/vim.js | src/installs/vim.md | Complete - has dependencies |
-| VLC | src/installs/vlc.js | src/installs/vlc.md | Complete - has dependencies |
-| Visual Studio Code | src/installs/vscode.js | src/installs/vscode.md | Complete - has dependencies |
-| wget | src/installs/wget.js | src/installs/wget.md | Skipped - already documented |
-| WhatsApp | src/installs/whatsapp.js | src/installs/whatsapp.md | Complete - has dependencies |
-| winpty | src/installs/winpty.js | src/installs/winpty.md | Skipped - already documented |
-| woff2 | src/installs/woff2.js | src/installs/woff2.md | Complete - has dependencies |
-| WSL 2 | src/installs/wsl.js | src/installs/wsl.md | Skipped - already documented |
-| Xcode CLT | src/installs/xcode-clt.js | src/installs/xcode-clt.md | Complete - none required |
-| Xcode | src/installs/xcode.js | src/installs/xcode.md | Skipped - already documented |
-| Yarn | src/installs/yarn.js | src/installs/yarn.md | Complete - has dependencies |
-| yq | src/installs/yq.js | src/installs/yq.md | Complete - has dependencies |
-| yt-dlp | src/installs/yt-dlp.js | src/installs/yt-dlp.md | Complete - has dependencies |
-| yum-utils | src/installs/yum-utils.js | src/installs/yum-utils.md | Skipped - already documented |
-| Zsh | src/installs/zsh.js | src/installs/zsh.md | Skipped - already documented |
-| Oh My Zsh | src/installs/ohmyzsh.js | src/installs/ohmyzsh.md | Skipped - already documented |
-| Zoom | src/installs/zoom.js | src/installs/zoom.md | Complete - has dependencies |
-
-## Status Key
-
-- **Complete - has dependencies**: Analysis complete, technology requires one or more dependencies
-- **Complete - none required**: Analysis complete, technology has no external dependencies
-- **Skipped - already documented**: Technology already had a ## Dependencies section, no analysis needed
-- **Failed - analysis error**: Agent encountered an error during analysis
-
-## Failures
-
-*No failures recorded.*
-
-## Next Steps
-
-- Review the Dependencies sections in each markdown file for accuracy
-- Ensure all acquisition commands are correct for each platform
-- Proceed with installation testing using the install-tester agent
-
----
-
-## Known Dependencies
-
-This section catalogs the dependencies used across all installer scripts. Each subsection lists a dependency and the installers that require it. An installer may appear under multiple dependencies.
-
-**Note:** This list is built incrementally as installer markdown files are reviewed. Dependencies marked with "(optional)" are recommended but not strictly required.
-
-### Homebrew
-
-Package manager for macOS. Many installers rely on Homebrew for macOS installations.
-
-**Used by:**
-- curl
-- docker
-- ffmpeg
-- git
-- gpg
-- node
-- nvm
-- terraform
-- vscode
-- yarn
-
-### Chocolatey
-
-Package manager for Windows. Many installers rely on Chocolatey for Windows installations.
-
-**Used by:**
-- curl
-- docker
-- ffmpeg
-- git
-- gpg
-- node
-- nvm
-- terraform
-- vscode
-- yarn
-
-### curl
-
-Command-line tool for transferring data. Used to download installation scripts and packages.
-
-**Used by:**
-- docker
-- ffmpeg
-- homebrew
-- node
-- nvm
-- terraform
-- yarn
-
-### ca-certificates
-
-Certificate authority certificates for SSL/TLS verification.
-
-**Used by:**
-- docker
-- node
-- terraform
-- yarn
-
-### gnupg (GPG)
-
-GNU Privacy Guard for verifying package signatures.
-
-**Used by:**
-- node
-- terraform
-- vscode
-- yarn
-
-### wget
-
-Network downloader utility. Alternative to curl for downloading files.
-
-**Used by:**
-- ffmpeg
-- terraform
-- vscode
-
-### build-essential
-
-Essential compilation tools for Linux (gcc, make, etc.).
-
-**Used by:**
-- homebrew
-- node (optional)
-
-### git
-
-Version control system. Required for cloning repositories and some installation methods.
-
-**Used by:**
-- homebrew
-- nvm
-
-### software-properties-common
-
-Ubuntu package providing `add-apt-repository` command.
-
-**Used by:**
-- git (optional)
-- terraform
-
-### unzip
-
-Archive extraction utility.
-
-**Used by:**
-- ffmpeg (Git Bash)
-- terraform (Raspberry Pi OS)
-
-### yum-utils
-
-YUM package manager utilities for Amazon Linux/RHEL.
-
-**Used by:**
-- terraform
-
-### winpty
-
-Windows PTY interface for Git Bash terminal compatibility.
-
-**Used by (optional for Git Bash):**
-- docker
-- nvm
-- vscode
-- yarn
-
-### Xcode Command Line Tools
-
-Apple's developer tools for macOS compilation.
-
-**Used by:**
-- ffmpeg
-- homebrew
-
-### apt-transport-https
-
-APT transport for downloading via HTTPS (Ubuntu/Debian).
-
-**Used by:**
-- vscode
-
-### lsb-release
-
-Linux Standard Base release info utility.
-
-**Used by:**
-- terraform
-
-### procps
-
-Process utilities for Linux (provides `ps`, etc.).
-
-**Used by:**
-- homebrew
-
-### file
-
-File type identification utility.
-
-**Used by:**
-- homebrew
-
-### tar
-
-Archive utility for extracting tarballs.
-
-**Used by:**
-- ffmpeg
-
-### WSL 2
-
-Windows Subsystem for Linux version 2.
-
-**Used by:**
-- docker (Windows, for Docker Desktop)
-
-### pinentry-mac
-
-PIN entry dialog for GPG on macOS.
-
-**Used by:**
-- gpg
-
-### Development Tools
-
-Group package for RHEL/Amazon Linux providing compilation tools.
-
-**Used by:**
-- homebrew
-
-### Zsh
-
-Z Shell, a powerful Unix shell that extends Bash capabilities.
-
-**Used by:**
-- ohmyzsh
-
----
-
-## Dependency Handling Behavior
-
-This section documents how each installer handles its dependencies at runtime. Understanding this behavior helps users know what to expect when running `dev install <tool>`.
-
-### Behavior Categories
-
-| Category | Description | User Action Required |
-|----------|-------------|---------------------|
-| **Exits with Message** | Installation stops and displays instructions | User must install dependency first |
-| **Auto-Installs Inline** | Prerequisites installed automatically | None - fully automatic |
-| **Pre-installed/Bundled** | Dependency already present on system | None |
-
-### Platform-Specific Patterns
-
-#### macOS (Homebrew Required)
-
-Most macOS installers require Homebrew. If Homebrew is not installed:
-- Installation **exits gracefully** with a message
-- User is instructed to run `dev install homebrew` first
-- Installation does **NOT** proceed automatically
-
-**Installers that exit if Homebrew is missing:**
-- adobe-creative-cloud, appcleaner, atomicparsley, aws-cli, balena-etcher, bambu-studio
-- bash, bash-completion, beyond-compare, brave-browser, caffeine, camtasia, chatgpt
-- chrome-canary, chromium, cursor, dbschema, docker, drawio
-- elmedia-player, ffmpeg, git, go, google-chrome, gpg, imageoptim
-- jq, keyboard-maestro, latex, lftp, messenger, microsoft-office
-- microsoft-teams, node, nordpass, nvm, openssh, pandoc, pinentry
-- pngyu, postman, safari-tech-preview, sfnt2woff, shellcheck, slack
-- snagit, spotify, studio-3t, sublime-text, superwhisper, tailscale
-- termius, terraform, tidal, tmux, tree, vim, vlc, vscode, wget
-- whatsapp, woff2, xcode, yarn, yq, yt-dlp, zoom
-
-**Exception - Docker throws an error instead of returning:**
-- docker.js throws an `Error` if Homebrew is missing (install fails with error)
-
-#### Windows (Chocolatey Required)
-
-Most Windows installers require Chocolatey. If Chocolatey is not installed:
-- Installation **exits gracefully** with a message
-- User is instructed to install Chocolatey (PowerShell command provided)
-- Installation does **NOT** proceed automatically
-
-**Installers that exit if Chocolatey is missing:**
-- atomicparsley, aws-cli, balena-etcher, bambu-studio, beyond-compare, brave-browser
-- camtasia, chrome-canary, chromium, curl, cursor, dbschema, docker
-- drawio, ffmpeg, git, go, google-chrome, gpg, jq, latex, lftp
-- messenger, microsoft-office, microsoft-teams, node, nordpass, nvm
-- openssh, pandoc, pinentry, postman, shellcheck, slack, snagit
-- spotify, studio-3t, sublime-text, tailscale, termius, terraform
-- tidal, tmux, tree, vim, vlc, vscode, wget, whatsapp, yarn, yq
-- yt-dlp, zoom
-
-**Exception - Docker throws an error instead of returning:**
-- docker.js throws an `Error` if Chocolatey is missing (install fails with error)
-
-#### Git Bash (Mixed Behavior)
-
-Git Bash installers have varying behavior:
-
-**Pre-installed/Bundled (no action needed):**
-- curl - bundled with Git for Windows
-- git - bundled with Git for Windows (Git Bash IS Git)
-
-**Uses Chocolatey via PowerShell:**
-- docker, node, nvm, terraform, vscode, yarn - call `powershell.exe` to run Chocolatey
-- If Chocolatey is not installed, installation exits with instructions
-
-**Not Supported:**
-- homebrew - not available for Git Bash (advises WSL)
-
-#### Ubuntu/Debian/Raspbian (Auto-Install Prerequisites)
-
-Linux installers using APT typically **auto-install prerequisites inline**. The user does not need to install dependencies first.
-
-**Examples of auto-installed prerequisites:**
-- docker.js: Installs `ca-certificates`, `curl` automatically
-- node.js: Installs `curl`, `ca-certificates`, `gnupg` automatically
-- vscode.js: Installs `wget`, `gpg`, `apt-transport-https` automatically
-- terraform.js: Installs `gnupg`, `software-properties-common`, `wget` automatically
-- homebrew.js: Installs `build-essential`, `procps`, `curl`, `file`, `git` automatically
-
-**Simple APT installers (no special prerequisites):**
-- curl, git, vim, tree, tmux, jq, wget, gpg, openssh, pandoc, shellcheck
-
-#### Amazon Linux (Auto-Install Prerequisites)
-
-Amazon Linux installers using DNF/YUM typically **auto-install prerequisites inline**.
-
-**Examples of auto-installed prerequisites:**
-- terraform.js: Installs `yum-utils` automatically
-- homebrew.js: Installs `Development Tools` group, `procps-ng`, `curl`, `file`, `git` automatically
-
-**Simple DNF/YUM installers (no special prerequisites):**
-- curl, git, vim, tree, tmux, jq, wget, gpg
-
-#### WSL (Ubuntu Behavior)
-
-WSL installers follow the same behavior as Ubuntu:
-- Prerequisites are **auto-installed inline**
-- No manual dependency installation required
-
-### Summary Table by Installer
-
-| Installer | macOS | Windows | Git Bash | Ubuntu/Debian | Amazon Linux |
-|-----------|-------|---------|----------|---------------|--------------|
-| curl | Exits (Homebrew) | Exits (Choco) | Bundled | Auto-install | Auto-install |
-| docker | **Throws** (Homebrew) | **Throws** (Choco) | PowerShell | Auto-install | Auto-install |
-| git | Exits (Homebrew) | Exits (Choco) | Bundled | Auto-install | Auto-install |
-| homebrew | N/A (is the dep) | Not supported | Not supported | Auto-install | Auto-install |
-| node | Exits (Homebrew) | Exits (Choco) | PowerShell | Auto-install | Auto-install |
-| terraform | Exits (Homebrew) | Exits (Choco) | PowerShell | Auto-install | Auto-install |
-| vscode | Exits (Homebrew) | Exits (Choco) | PowerShell | Auto-install | Auto-install |
-
-### Key Takeaways
-
-1. **macOS/Windows users**: Must install package manager (Homebrew/Chocolatey) first
-2. **Linux users**: Dependencies are handled automatically - just run `dev install <tool>`
-3. **Git Bash users**: Some tools bundled, others require Chocolatey on Windows host
-4. **Most installers exit gracefully** with helpful messages rather than throwing errors
-5. **docker.js is an exception** - it throws an error if package manager is missing