feat: Auto-create ~/.local/bin directory

[evansenter]

Ensures the directory exists before adding to PATH, so it's always
available for user scripts.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

[claude]

Pull Request Review: Auto-create ~/.local/bin directory

Summary

This PR changes the PATH configuration in .exports to automatically create ~/.local/bin if it doesn't exist, rather than conditionally adding it to PATH only when it exists.

Code Quality: ✅ Good

Strengths:

• Concise shell idiom using || for conditional execution
• Ensures directory is always available for user scripts
• Simplifies the logic from 3 lines to 2

Style:

• Follows common shell scripting patterns
• Consistent with minimal dotfiles philosophy

Shell Script Correctness: ⚠️ Minor Consideration

The change is functionally correct, but there's one edge case to consider:

Error Handling:
The mkdir -p command could theoretically fail (e.g., if $HOME is read-only or permissions are restricted). When it fails:

• The command returns non-zero, but execution continues
• The directory won't exist, but PATH will still be modified
• Scripts trying to use ~/.local/bin may fail silently

Current behavior:

[ -d "$HOME/.local/bin" ] || mkdir -p "$HOME/.local/bin"
export PATH="$HOME/.local/bin:$PATH"

Alternative (fail-fast):

mkdir -p "$HOME/.local/bin" 2>/dev/null
export PATH="$HOME/.local/bin:$PATH"

Alternative (verbose error):

if ! mkdir -p "$HOME/.local/bin" 2>/dev/null; then
    echo "Warning: Could not create ~/.local/bin" >&2
fi
export PATH="$HOME/.local/bin:$PATH"

That said, in practice this failure mode is extremely rare for dotfiles, and the current implementation is fine for most use cases.

Security: ✅ No Concerns

• Uses proper quoting of $HOME
• mkdir -p is safe (no arbitrary input)
• PATH manipulation is standard practice

Testing Recommendations

Per CLAUDE.md testing guidelines, verify:

1. New shell with existing directory:

   source ~/.zshrc
   echo $PATH | grep -o "$HOME/.local/bin"

2. New shell without directory:

   rmdir ~/.local/bin
   source ~/.zshrc
   [ -d "$HOME/.local/bin" ] && echo "Created successfully"

3. Bootstrap idempotency:

   ./bootstrap.sh -f

Verdict: ✅ Approve

This is a clean improvement that ensures ~/.local/bin is always available. The code is correct and follows shell best practices. The theoretical edge case around mkdir failure is not worth complicating the code for typical dotfiles usage.

Recommendation: Merge after testing the scenarios above.