@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/dependencies.md

@@ -0,0 +1,435 @@
+# Dependency Analysis Summary
+
+**Last Updated:** 2026-01-04
+**Total Test-Pending Technologies:** 86
+**Already Documented (Skipped):** 85
+**Analyzed This Run:** 1
+**Successful:** 86
+**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 |
+| 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 |
+| 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 |
+| 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
+
+---
+
+## 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, 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
+- 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