PJR-P9ZC 接続のスクリプトが、対象の devcontainer が止まっていると別の container へ入ろうとして失敗する
1. 課題内容
specdojo-tmux.sh.sample の find_container は、ラベルで見つからないと vsc- で始まる最初の container を選ぶ。そのため対象の devcontainer が止まっていると、別の container へ docker exec して「chdir to cwd ... no such file or directory」で止まる。ラベルの一致だけで探し、見つからなければ devcontainer up するように直す
2. 影響範囲
| 観点 | 影響 |
|---|---|
| スコープ | templates/devcontainer/remote-host/specdojo-tmux.sh.sample、その結合テスト（tests/src/devcontainer/scaffold.integration.test.ts）、specdojo:remote-host-development-guide の説明 |
| スケジュール | 期限 2026-10-31 |
| コスト | TODO |
| 品質 | 対象の devcontainer が止まっていて、別の devcontainer が動いているホストでは、tmux から接続できない |
| 関係者 | サンプルから接続のスクリプトを作り、常時稼働ホストへ tmux で入る利用者 |
3. 対応方針
| 項目 | 内容 |
|---|---|
| 原因 | find_container は docker ps（動いている container だけ）でラベル devcontainer.local_folder を探し、見つからないと vsc- で始まるイメージの最初の container を選ぶため、別の container が選ばれる。container が見つかったことになるので devcontainer up も動かない |
| 対応策 | 代わりに選ぶ処理を消し、ラベルの一致だけで探す。見つからなければ devcontainer up で起動する。docker exec の前に作業ディレクトリが container にあるかを確かめ、なければ原因の分かるメッセージで止める |
| 依存事項 | なし |
| 完了条件 | 3.1 のとおり |
3.1. 完了条件
specdojo-tmux.sh.sampleのfind_containerから、vsc-で始まるイメージの container を選ぶ処理を消し、ラベルdevcontainer.local_folderがworkspace_dirと一致する container だけを返す。- 見つからないときは
devcontainer up --workspace-folder "$workspace_dir"を実行し、もう一度ラベルで探す。devcontainer upの出力は標準エラーへ出す。 docker execの前に、container_workspace_dirが container にあるかをtest -dで確かめ、なければ container 名とディレクトリを含むメッセージで止める。- 冒頭のコメントに、ラベルが
workspace_dirと一致しないとdevcontainer upが別の新しい container を作ることと、ラベルの確かめ方（docker inspect <id> --format '{{index .Config.Labels "devcontainer.local_folder"}}'）を書く。 - 結合テストに、ラベルの一致する container が動いておらず、
vsc-で始まる別の container が動いているときに、別の container へdocker execせずdevcontainer upを呼ぶ場合を加える。 - specdojo:remote-host-development-guide の
specdojo-tmux.sh.sampleの説明に、ラベルの一致する container だけへ接続することを書く。 - 生成したサンプルが
bash -nとshellcheckを通る。 - 作業を終える前に、
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.mdの## [Unreleased]節に追記する。版の番号は決めない。公開済みの版（0.5.0 以前）の節は変えない。
4. 対応結果
4.1. 解決内容
templates/devcontainer/remote-host/specdojo-tmux.sh.sampleのfind_containerから、vsc-で始まるイメージの container を選ぶフォールバック処理を削除し、ラベルdevcontainer.local_folderがworkspace_dirと一致する container だけを返すように修正した。- 一致する container が動いていない場合は
devcontainer up --workspace-folder "$workspace_dir" >&2を実行し、標準エラー出力へ進捗を出しながら起動して再検索するようにした。 docker execを実行する直前に、container_workspace_dirが container 内に存在するかをdocker exec "$container_name" test -d "$container_workspace_dir"で検証し、存在しない場合は container 名とディレクトリを含む診断メッセージを出力して終了するようにガードを追加した。- 冒頭コメントに、ラベルが
workspace_dirと一致しないとdevcontainer upが別の新しい container を作成することと、ラベルの確認コマンド（docker inspect <id> --format '{{index .Config.Labels "devcontainer.local_folder"}}'）を記載した。 - 結合テスト
tests/src/devcontainer/scaffold.integration.test.tsに、対象の container が停止しており別のvsc-container が動いている状況でも無関係な container にdocker execせずdevcontainer upを呼び出すケース、およびコンテナ内作業ディレクトリが存在しない場合に停止するケースを追加した。 [[specdojo:remote-host-development-guide]]のspecdojo-tmux.sh.sampleの説明に、ラベルの一致する container だけへ接続する記述を反映した。CHANGELOG.mdの## [Unreleased]節に不具合修正内容を記録した。
4.2. 確認結果
bash -n templates/devcontainer/remote-host/specdojo-tmux.sh.sample: 構文エラーなく正常終了（exit code 0）。shellcheck templates/devcontainer/remote-host/specdojo-tmux.sh.sample: 警告・エラーなく正常終了（exit code 0）。npx vitest run tests/src/devcontainer/scaffold.integration.test.ts: 追加したテストケースを含め 8 件すべて成功。
4.3. 再発防止策
- コンテナの自動検出やフォールバック処理では、利便性のための緩い推測（
vsc-prefix のコンテナを適当に選ぶ等）を避け、作業ディレクトリとの一致を表すラベルなどの厳密な属性のみに限定する。 - コンテナ内の前提条件（作業ディレクトリの存在等）は、操作（
docker exec等）を行う直前にガード処理で検証し、不一致時は早期に原因の分かるエラーメッセージを出力する。