OpenCode et le PATH incomplet : pourquoi vos outils n'étaient pas dans le shell de l'agent

# Dans votre terminal interactif (tout fonctionne)
echo $PATH | tr ':' '\n' | grep -v '^/usr' | sort

/home/cheroliv/apps
/home/cheroliv/.nvm/versions/node/v22.19.0/bin
/home/cheroliv/.sdkman/candidates/java/current/bin
/home/cheroliv/.sdkman/candidates/gradle/current/bin
/home/cheroliv/.local/share/pnpm
/home/cheroliv/.local/bin

# Shell non-interactif : pas de .zshrc
zsh -c 'echo $PATH' | tr ':' '\n' | grep -v '^/usr' | sort

/home/cheroliv/.local/bin

grep -n 'apps\|SDKMAN\|NVM\|PNPM\|PATH' ~/.zshrc

119: PATH="/usr/bin/python3:$HOME/apps:$PATH"           # ← pas exporté !
171: export NVM_DIR="$HOME/.nvm"
172: [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"   # ← NVM init
176: nvm use --lts --silent                              # ← active une version
179: export PNPM_HOME="/home/cheroliv/.local/share/pnpm"
187: export SDKMAN_DIR="$HOME/.sdkman"
188: [[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"

cat ~/.zshenv 2>/dev/null || echo "FICHIER ABSENT"

export SDKMAN_DIR="$HOME/.sdkman"
export NVM_DIR="$HOME/.nvm"
export PNPM_HOME="$HOME/.local/share/pnpm"
export PATH="$HOME/apps:$HOME/.sdkman/candidates/java/current/bin:$HOME/.sdkman/candidates/gradle/current/bin:$HOME/.nvm/current/bin:$PNPM_HOME:$HOME/.local/bin:$HOME/.local/share/JetBrains/Toolbox/scripts:/usr/bin/python3:$PATH"

# ❌ MAUVAISE IDÉE
[[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"

@startuml
skinparam backgroundColor #FEFEFE

rectangle "Yaklaşım LENTE\n(source sdkman-init.sh)" as slow {
  card ".zshenv source sdkman-init.sh\nShell başına 2-3 saniye\nVağ kontrolleri\nRisque başarısızlık" as s1 #FDEDEC
}

rectangle "Yaklaşım RAPIDE\n(symlinks directs)" as fast {
  card ".zshenv export PATH=...current/bin\n0 ms\nPas ağ\nPas başlatma" as s2 #E8F8E8
}

slow --> fast : Aynı nihai sonuç\nLe PATH current/bin öğesine işaret ediyor\nher iki durumda da

@enduml

~/.sdkman/candidates/java/current -> ~/.sdkman/candidates/java/25.0.2-tem

~/.nvm/versions/node/v22.19.0/bin/node

@startuml
skinparam backgroundColor #FEFEFE

package "SDKMAN ✅" {
  [~/.sdkman/candidates/java/current] as sdk_current
  [~/.sdkman/candidates/java/25.0.2-tem/] as java_25
  [~/.sdkman/candidates/java/21.0.7-tem/] as java_21

  sdk_current --> java_25 : symlink
}

package "NVM ❌ (düzeltmeden önce)" as nvm_before {
  [~/.nvm/versions/node/v22.19.0/] as node_22
  [~/.nvm/versions/node/v20.16.0/] as node_20
  note right of node_22
current symlink yok!
.zshenv sabit olarak işaret etmeli
Sonraki nvm install'da bozulacak
  end note
}

package "NVM ✅ (düzeltmeden sonra)" as nvm_after {
  [~/.nvm/current] as nvm_current
  [~/.nvm/versions/node/v22.19.0/] as node_22b
  [~/.nvm/versions/node/v20.16.0/] as node_20b

  nvm_current --> node_22b : sembolik bağlantı\n(mis à jour auto)
}

@enduml

# Créer le symlink initial
ln -sfn "$HOME/.nvm/versions/node/v22.19.0" "$HOME/.nvm/current"

$HOME/.nvm/current/bin

# ❌ Chemin en dur — cassé au prochain changement de version
$HOME/.nvm/versions/node/v22.19.0/bin

# À la fin de .zshrc, APRÈS le chargement de NVM
nvm use --lts --silent
ln -sfn "$(nvm_version_path "$(nvm current)")" "$NVM_DIR/current"

_nvm() {
  command nvm "$@"
  local rc=$?
  ln -sfn "$(nvm_version_path "$(nvm current)")" "$NVM_DIR/current"
  return $rc
}
alias nvm='_nvm'

@startuml
skinparam backgroundColor #FEFEFE

actor Développeur
participant "nvm sarmalayıcısı\n(_nvm)" as wrapper
participant "gerçek nvm\n(command nvm)" as realnvm
participant "~/.nvm/current\n(symlink)" as symlink

Développeur -> wrapper : nvm use 20
wrapper -> realnvm : komut nvm use 20
realnvm --> wrapper : etkinleştirilmiş sürüm
wrapper -> symlink : ln -sfn .../v20.16.0 ~/.nvm/current
wrapper --> Développeur : dönüş

note right of symlink
Her zaman güncel!
`.zshenv` tarafından kullanılır
→ `OpenCode` ile erişilebilir
end note

@enduml