@fredlackey/devutils 0.0.1

package/src/installs/tree.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install Tree.
+ * @module installs/tree
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install Tree across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/vim.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install Vim.
+ * @module installs/vim
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install Vim across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/vlc.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install VLC.
+ * @module installs/vlc
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install VLC across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/vscode.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install Visual Studio Code.
+ * @module installs/vscode
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install Visual Studio Code across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/whatsapp.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install WhatsApp.
+ * @module installs/whatsapp
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install WhatsApp across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/woff2.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install WOFF2.
+ * @module installs/woff2
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install WOFF2 across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/xcode.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install Xcode Command Line Tools.
+ * @module installs/xcode
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install Xcode Command Line Tools across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/yarn.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install Yarn.
+ * @module installs/yarn
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install Yarn across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/yq.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install yq.
+ * @module installs/yq
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install yq across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/yt-dlp.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install yt-dlp.
+ * @module installs/yt-dlp
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install yt-dlp across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/installs/zoom.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install Zoom.
+ * @module installs/zoom
+ */
+
+const os = require('../utils/common/os');
+
+/**
+ * Install Zoom across supported platforms.
+ *
+ * @returns {Promise<void>}
+ */
+async function install() {
+  const platform = os.detect();
+
+  switch (platform.type) {
+    case 'macos':
+      // TODO: Implement macOS installation
+      break;
+    case 'debian':
+      // TODO: Implement Debian/Ubuntu installation
+      break;
+    case 'rhel':
+      // TODO: Implement RHEL/Amazon Linux installation
+      break;
+    case 'windows-wsl':
+      // TODO: Implement WSL installation
+      break;
+    case 'windows':
+      // TODO: Implement Windows installation
+      break;
+    default:
+      console.error(`Unsupported platform: ${platform.type}`);
+      process.exit(1);
+  }
+}
+
+module.exports = { install };
+
+if (require.main === module) {
+  install();
+}

package/src/scripts/README.md

@@ -0,0 +1,95 @@
+# Scripts
+
+This folder contains **Scripts** — standalone global utilities that replace shell aliases and functions from dotfiles.
+
+## Purpose
+
+Scripts are single-command utilities that can be invoked directly from the command line after installing the package globally. They provide cross-platform implementations of common shell aliases and functions.
+
+## Examples
+
+```bash
+afk                    # Lock screen / sleep
+clone <url>            # Clone repo and install dependencies
+ll                     # Long directory listing
+git-push               # Add, commit, and push in one command
+docker-clean           # Remove all containers, images, volumes
+```
+
+## File Structure
+
+Each script follows this pattern:
+
+```javascript
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Brief description of the script.
+ * @module scripts/script-name
+ */
+
+/**
+ * Detailed description of what the script does.
+ *
+ * @param {string[]} args - Command line arguments
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // Implementation
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}
+```
+
+## Categories
+
+### Git
+`clone`, `git-clone`, `git-pup`, `git-push`, `git-backup`, `vpush`, `fetch-github-repos`
+
+### Docker
+`dp`, `docker-clean`
+
+### Node/npm
+`npmi`, `clean-dev`, `ncu-update-all`, `get-dependencies`, `install-dependencies-from`
+
+### File Management
+`mkd`, `ll`, `delete-files`, `refresh-files`, `get-folder`, `org-by-date`, `rm-safe`
+
+### macOS
+`afk`, `o`, `u`, `brewd`, `brewi`, `brewr`, `brews`, `brewu`, `empty-trash`
+
+### Search
+`h`, `s`
+
+### Network
+`ips`, `ccurl`, `local-ip`, `ports`
+
+### Media
+`get-tunes`, `get-video`, `get-channel`, `get-course`, `datauri`, `resize-image`
+
+## Registration
+
+Scripts are registered as global commands in `package.json`:
+
+```json
+{
+  "bin": {
+    "afk": "./src/scripts/afk.js",
+    "clone": "./src/scripts/clone.js",
+    "ll": "./src/scripts/ll.js"
+  }
+}
+```
+
+## Related
+
+- **Commands** (`../commands/`) — Multi-word CLI operations (`dev configure`, etc.)
+- **Utils** (`../utils/`) — Internal shared utilities
+
+## Documentation
+
+See [ai-docs/LOCAL_EXAMPLE_ENVIRONMENT.md](../../ai-docs/LOCAL_EXAMPLE_ENVIRONMENT.md) for the complete script reference.

package/src/scripts/afk.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Lock screen / put system to sleep.
+ * @module scripts/afk
+ */
+
+/**
+ * Locks the screen or puts the system to sleep.
+ * Uses platform-specific commands (macOS: osascript, Linux: various).
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement screen lock / sleep
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/backup-all.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Backup multiple user directories using rsync.
+ * @module scripts/backup-all
+ */
+
+/**
+ * Creates a timestamped backup of multiple user directories
+ * (Downloads, Desktop, Documents, Source, etc.) using rsync.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Destination backup directory path
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement full user backup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/backup-source.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Backup ~/Source directory using rsync.
+ * @module scripts/backup-source
+ */
+
+/**
+ * Creates a timestamped backup of the ~/Source directory using rsync,
+ * excluding common development artifacts and cache directories.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Destination backup directory path
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Source directory backup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/brewd.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Run Homebrew doctor.
+ * @module scripts/brewd
+ */
+
+/**
+ * Executes `brew doctor` to check for potential problems
+ * with the Homebrew installation.
+ *
+ * @param {string[]} args - Command line arguments to pass to brew doctor
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement brew doctor
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}