feat(shell): add ~/.local/bin to default zsh PATH (#434)

* feat(shell): add ~/.local/bin to default zsh PATH #433

Refs: #433
Assisted-by: opencode/github-copilot/claude-opus-4.6

* fix(shell): use zsh path array for ~/.local/bin to avoid empty PATH edge case #433

Refs: #433
Assisted-by: opencode/github-copilot/claude-opus-4.6

Author: paolomainardi

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Added `~/.local/bin` to default zsh PATH for user-local binaries (XDG convention), auto-creating the directory if missing
 - Added orphan cleanup to `sparkdock-agents-sync`: detects and removes managed skills/agent profiles no longer in upstream, with `--force` to remove locally modified orphans
 - Added orphan detection to `sparkdock-agents-status`: flags resources removed from upstream as `orphan` type with cleanup hint
 - Added DESCRIPTION column to `sjust sf-agents-status` tables, reading short descriptions from upstream `catalog.json` with tab-delimited rendering to support commas in descriptions

config/shell/init.zsh

@@ -15,6 +15,13 @@ HOMEBREW_PREFIX="/opt/homebrew"
 : "${SPARKDOCK_ENABLE_FZF:=1}"       # Enabled by default
 : "${SPARKDOCK_ENABLE_ATUIN:=0}"     # Disabled by default
 
+# Ensure ~/.local/bin exists and is on PATH (user-local binaries, XDG convention).
+[[ -d ~/.local/bin ]] || mkdir -p ~/.local/bin
+if (( ! ${path[(Ie)${HOME}/.local/bin]} )); then
+  path=("${HOME}/.local/bin" ${path})
+  export PATH
+fi
+
 # Add local zsh functions directory to fpath (skip if already present).
 if [[ -d ~/.local/share/zsh/site-functions ]] && (( ! ${fpath[(Ie)${HOME}/.local/share/zsh/site-functions]} )); then
   fpath+=~/.local/share/zsh/site-functions