Convert shell scripts to TypeScript with zx and neverthrow error handling

.gitignore

@@ -1 +1,2 @@
 .DS_Store
+node_modules/

README.md

@@ -14,6 +14,8 @@ sh -c "$(curl -fsLS https://raw.githubusercontent.com/willmruzek/dotfiles/master
 chezmoi init --apply willmruzek
 ```
 
+**Note:** The installation scripts use [google/zx](https://github.com/google/zx) for better shell scripting. Node.js will be installed automatically if not present.
+
 ## What's Included
 
 - **Git configuration** (`.gitconfig`)
@@ -74,13 +76,13 @@ Minimal helpers to move VS Code user settings between your Mac and this repo. Re
 - Export local → repo:
 
   ```bash
-  ./home/.scripts/export-vscode-settings.sh
+  ./home/.scripts/export-vscode-settings.mjs
   ```
 
 - Import repo → local (preview first by default):
 
   ```bash
-  ./home/.scripts/import-vscode-settings.sh
+  ./home/.scripts/import-vscode-settings.mjs
   # flags: -n/--dry-run (preview only), -y/--yes (auto-approve)
   ```
 

home/.chezmoiscripts/run_once_after_99_setup-complete.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env zx
+
+echo`✨ Setup complete!`

home/.chezmoiscripts/run_once_before_01_install-homebrew.sh

@@ -17,8 +17,10 @@ if ! command -v brew &> /dev/null; then
             echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
             eval "$(/opt/homebrew/bin/brew shellenv)"
         fi
+        echo "✅ Homebrew installed"
     else
         echo "⏭️  Skipping Homebrew installation"
+        exit 0
     fi
 else
     echo "✅ Homebrew is already installed"

home/.chezmoiscripts/run_once_before_02_install-brewfile-packages.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+set -e
+
+# Install packages from Brewfile if it exists (only if Homebrew is available)
+if command -v brew &> /dev/null && [ -f "$HOME/.Brewfile" ]; then
+    echo "📋 Installing packages from Brewfile..."
+    export HOMEBREW_BUNDLE_FILE="$HOME/.Brewfile"
+    brew bundle install
+elif ! command -v brew &> /dev/null; then
+    echo "⚠️  Homebrew not available, skipping package installation"
+else
+    echo "⚠️  No Brewfile found, skipping package installation"
+fi

home/.chezmoiscripts/run_once_before_03_install-zx.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+
+set -e
+
+# Verify zx is available after npm install
+# zx is installed as a dependency in package.json
+
+if command -v npx &> /dev/null; then
+    echo "✅ npx is available"
+
+    # Check if zx is available via npx
+    if npx zx --version &> /dev/null; then
+        echo "✅ zx is available via npx"
+    else
+        echo "⚠️  zx not yet available via npx (will be installed by npm install)"
+    fi
+else
+    echo "❌ npx not found. Node.js must be installed first."
+    echo "    Please install Node.js before running this script."
+    exit 1
+fi

home/.chezmoiscripts/run_once_before_04_install-npm-dependencies.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+set -e
+
+# Check if npm is available
+if ! command -v npm &> /dev/null; then
+    echo "⚠️  npm not available, skipping dependency installation"
+    exit 0
+fi
+
+# Find the repository root by looking for package.json
+# Start from the current directory and walk up
+CURRENT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT=""
+
+while [ "$CURRENT_DIR" != "/" ]; do
+    if [ -f "$CURRENT_DIR/package.json" ]; then
+        REPO_ROOT="$CURRENT_DIR"
+        break
+    fi
+    CURRENT_DIR="$(dirname "$CURRENT_DIR")"
+done
+
+# Check if we found the repository root
+if [ -z "$REPO_ROOT" ]; then
+    echo "⚠️  package.json not found in any parent directory, skipping dependency installation"
+    exit 0
+fi
+
+echo "📦 Installing npm dependencies..."
+cd "$REPO_ROOT"
+npm install
+
+echo "✅ npm dependencies installed"

home/.chezmoiscripts/run_once_before_05_configure-touch-id-for-sudo.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env zx
+
+import { ResultAsync, err, ok } from 'neverthrow'
+
+// Configure Touch ID for sudo
+const sudoLocalPath = "/etc/pam.d/sudo_local"
+
+// Helper to check if file exists
+const fileExists = (path: string): ResultAsync<boolean, Error> =>
+  ResultAsync.fromPromise(
+    fs.access(path).then(() => true),
+    () => new Error(`File does not exist: ${path}`)
+  ).orElse(() => ok(false))
+
+// Helper to read file content
+const readFile = (path: string): ResultAsync<string, Error> =>
+  ResultAsync.fromPromise(
+    fs.readFile(path, 'utf8'),
+    (e) => new Error(`Failed to read file: ${e}`)
+  )
+
+// Helper to execute shell command
+const runCommand = (command: ProcessPromise): ResultAsync<void, Error> =>
+  ResultAsync.fromPromise(
+    command.then(() => undefined),
+    (e) => new Error(`Command failed: ${e}`)
+  )
+
+// Main logic
+const configureTouchID = async () => {
+  const exists = await fileExists(sudoLocalPath)
+
+  if (exists.isErr()) {
+    return exists
+  }
+
+  if (exists.value) {
+    // File exists, check if pam_tid.so is already configured
+    const contentResult = await readFile(sudoLocalPath)
+
+    if (contentResult.isErr()) {
+      return contentResult
+    }
+
+    if (!contentResult.value.includes("pam_tid.so")) {
+      echo`🔐 Adding Touch ID authentication to existing sudo_local...`
+      const result = await runCommand($`echo "auth sufficient pam_tid.so" | sudo tee -a ${sudoLocalPath}`)
+      if (result.isErr()) {
+        return result
+      }
+      echo`✅ Touch ID for sudo configured`
+    } else {
+      echo`✅ Touch ID for sudo already configured`
+    }
+  } else {
+    // File doesn't exist
+    echo`🔐 Setting up Touch ID for sudo...`
+    const copyResult = await runCommand($`sudo cp /etc/pam.d/sudo_local.template ${sudoLocalPath}`)
+    if (copyResult.isErr()) {
+      return copyResult
+    }
+
+    const appendResult = await runCommand($`echo "auth sufficient pam_tid.so" | sudo tee -a ${sudoLocalPath}`)
+    if (appendResult.isErr()) {
+      return appendResult
+    }
+
+    echo`✅ Touch ID for sudo configured`
+  }
+
+  return ok(undefined)
+}
+
+// Execute and handle result
+const result = await configureTouchID()
+
+if (result.isErr()) {
+  echo`❌ Error: ${result.error.message}`
+  process.exit(1)
+}

home/.scripts/export-vscode-settings.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env zx
+
+// export-vscode-settings.ts - Export VS Code settings from local VS Code User directory into the repo
+//
+// Usage:
+//   ./export-vscode-settings.ts
+//
+// Exports:
+//   - mcp.json
+//   - keybindings.json
+//   - settings.json
+//   - prompts/ (recursive)
+
+// Ensure git is available
+try {
+  await $`command -v git`
+} catch (error) {
+  echo`Error: git not found. Install git.`
+  process.exit(1)
+}
+
+// Ensure rsync is available
+try {
+  await $`command -v rsync`
+} catch (error) {
+  echo`Error: rsync not found. Install rsync.`
+  process.exit(1)
+}
+
+// Centralized include patterns for rsync
+const includes = [
+  '/mcp.json',
+  '/keybindings.json',
+  '/settings.json',
+  '/prompts/***'
+]
+
+const includeArgs = includes.flatMap(p => ['--include', p])
+
+const scriptDir = __dirname
+const repoRoot = (await $`git -C ${scriptDir} rev-parse --show-toplevel`).stdout
+
+if (!repoRoot) {
+  echo`Error: Could not determine destination path`
+  process.exit(1)
+}
+
+const dest = `${repoRoot}/home/.vscode`
+const src = `${process.env.HOME}/Library/Application Support/Code/User`
+
+// Skip gracefully if source directory does not exist
+try {
+  await fs.access(src)
+} catch (error) {
+  echo`Error: Source VS Code User directory not found: ${src}.`
+  process.exit(1)
+}
+
+await fs.mkdir(dest, { recursive: true })
+
+await $`rsync -a --delete ${includeArgs} --exclude='*' ${src}/ ${dest}/`
+
+echo`VS Code settings exported successfully.`