PJR-5JRJ devcontainer で後から開く端末に ~/.local/bin が PATH に入らない
1. 課題内容
GHBP で post-create.sh の中では ~/.local/bin を PATH に足したが、devcontainer.json に remoteEnv がないため、container の作成の後に開く端末や VS Code の terminal では ~/.local/bin が PATH に入らず、そこに入った Claude Code などの CLI が見つからない（2026-10-20、v0.4.0 の環境の直し方を確かめる中で見つかった）
2. 影響範囲
| 観点 | 影響 |
|---|---|
| スコープ | templates/devcontainer/devcontainer.json・src/devcontainer/scaffold.ts、tools/e2e/devcontainer-host-e2e.ts |
| スケジュール | 高い。devcontainer を作った後に開く端末で、~/.local/bin に入った Claude Code などの CLI が見つからない |
| コスト | 利用者が ~/.bashrc などに PATH を足す手間 |
| 品質 | GHBP の修正だけでは CLI が使えない |
| 関係者 | init --devcontainer と devcontainer scaffold の利用者 |
3. 対応方針
| 項目 | 内容 |
|---|---|
| 原因 | GHBP は post-create.sh の中でだけ ~/.local/bin を PATH に足しており、devcontainer.json に remoteEnv がない |
| 対応策 | devcontainer.json の remoteEnv で ~/.local/bin を PATH に足す |
| 依存事項 | なし |
| 完了条件 | 下記の完了条件を満たす |
3.1. 完了条件
- 生成する
devcontainer.jsonのremoteEnvで、/home/<remoteUser>/.local/binを PATH の先頭に足す（例:"PATH": "/home/node/.local/bin:${containerEnv:PATH}"）。既にremoteEnvがある構成でも、ほかの値を消さない。 - 単体テストで、生成した
devcontainer.jsonにremoteEnvの PATH があることを確かめる。 tools/e2e/devcontainer-host-e2e.tsに、devcontainer execで新しく開いたシェル（ログインシェル）からcommand -v claudeが~/.local/bin/claudeを返すことの確認を足す。- specdojo:remote-host-development-guide など、v0.4.0 で作った環境の直し方を書いている箇所があれば、
remoteEnvの足し方を加える。 - 作業を終える前に、
npm run typecheck・npm run lint:ts・npm run test:unitを実行して通す。 - 親の検証（lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema）が通る。
- CHANGELOG の
## [0.4.1] - 未定の節に書く。公開済みの版の節は変えない。
4. 対応結果
4.1. 解決内容
templates/devcontainer/devcontainer.jsonに"remoteEnv": { "PATH": "/home/node/.local/bin:${containerEnv:PATH}" }を追加した。src/devcontainer/scaffold.tsにおいて、devcontainer.json生成時にremoteUserに基づくパス（/home/<remoteUser>/.local/bin）をremoteEnv.PATHの先頭へ追加するようにした。すでにremoteEnvが存在する場合でも他の環境変数を保持し、PATHが設定されている場合も先頭に重複なく追加するようにした。tools/e2e/devcontainer-host-e2e.tsに、ログインシェルからcommand -v claudeが$HOME/.local/bin/claudeを返すことの検査を追加した。- specdojo:remote-host-development-guide の 2.1 節および 6.3 節に、
devcontainer.jsonのremoteEnv設定内容および v0.4.0 以前の環境に対するremoteEnv追加・リビルド手順を追記した。 CHANGELOG.mdの## [0.4.1] - 未定不具合修正節に変更内容を追記した。
4.2. 確認結果
- 単体テスト
tests/src/devcontainer/scaffold.test.tsにremoteEnvの生成・既存設定の保持・remoteUser別パス生成・重複防止のテストケースを追加した。 - 親 runner による検証（lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema）に委譲する。
4.3. 再発防止策
- コンテナ環境の scaffold において環境変数やパスの反映が必要な場合は、起動時スクリプト（
post-create.sh）だけでなく、後から開くシェルやエディタターミナルに反映されるdevcontainer.jsonのremoteEnv設定も合わせて定義・検証する。