Skip to content

エディタの自動オープン: tmux でソケットを拾い直したときも手元の VS Code に窓を開く(#523) - #524

Merged
takemi-ohama merged 7 commits into
mainfrom
design/issue-523
Nov 16, 2026
Merged

takemi-ohama merged 7 commits into
mainfrom
design/issue-523

Conversation

@takemi-ohama

Copy link
Copy Markdown
Contributor

#523 の要求・受け入れ条件・設計・詳細設計を、設計文書として追加しました。あわせて、設計文書で使う用語を用語集へ登録しました。コードの変更はありません。

利用者向けの変化

  • 無し

移行の手順

  • 無し

変更の要点

変更は 5 ファイル、追加 741 行で、削除はありません。

テスト

監視スクリプト(supervise.py の run)の各ステップの結果は次のとおりです。

ステップ 終了コード 結果
用語集の照合(glossary) 0 文書での用語の宣言と用語集が揃っている
要求の検査(requirements-check) 2 停止。issues/issue-523-requirements.md を読めなかった([Errno 2] No such file or directory)
設計レビューの検査(design-review-check) 1 失敗。出力の最後の行は空

残リスク:

  • 要求の検査は、要求の文書を読めずに停止しています。この PR には要求の文書が含まれているため、検査が別の場所を参照している可能性があります。原因は未確認です
  • 設計レビューの検査は終了コード 1 で終わっていますが、出力が無いため、失敗の内容は未確認です
  • この 2 つの検査では、要求と設計の内容がまだ確認されていません

設計単体のレビュー

# 箇所 指摘 扱い
1 人へ残す判断 「無し」と書いているが、要求の「未決」に、前提 2(VSCODE_GIT_ASKPASS_NODE が無いときにサーバーのディレクトリを探さない)を「利用者が設計承認ゲートで決める」とする行がある。要求の「起票者の推定」S1〜S6 も、設計承認ゲートで確かめるまで利用者の決定として扱わない。決定 1・決定 4 はこの未決を設計者の判断で確定させているため、少なくとも前提 2 の採否(と S1〜S6 の確認)を人へ残す判断として載せる必要がある 直した
2 処理の流れ(「拾い直した」の定義)/テスト設計(受け入れ条件 6) 定義では、ペインのソケットが接続できても以前のクライアントのものとして使わない場合(ipc_from_previous_client)を「拾い直した」に含め、PATH を変える側に入れている。一方で受け入れ条件 6 とテスト設計の受け入れ条件 6 の行は「ペインのソケットが接続できる」を「拾い直しが起きない=変更前と同じ」に入れており、同じ場面の扱いが設計の中で食い違う。受け入れ条件 6 の「接続できる」が「接続できて、かつ使うと判定した」を指すのかを決め、定義・I2・テスト設計の行をそろえる必要がある 直した
3 テスト設計(受け入れ条件 6)/非機能の実現方式(性能・拡張性) 拾い直す場面の既存のテストでは、tmux への問い合わせが 1 回増える(VSCODE_GIT_ASKPASS_NODE の読み)。既存のテストの tmux の差し替えがこの問い合わせに何を返すか(未知の変数で例外・空・呼び出しの回数や並びの検証)によっては、受け入れ条件 6 の「tests/editor/ の既存のテストが変更なしで通る」を満たさない。既存の拾い直しのテストが追加の問い合わせを受けても変わらず通ることを確かめる行(または、変えてよいテストの範囲)が設計に無い 直した
4 不変条件(I1)/決定 1 「拾い直したソケットと同じセッション環境から読む」「ソケットとサーバーの版がずれない」としているが、処理の流れではソケットの読み(判定)と VSCODE_GIT_ASKPASS_NODE の読み(探索)が別の tmux の呼び出しである。2 つの読みの間に別のクライアントが attach すると、ソケットと node のパスが別のクライアントのものになり得る。同じ状態を 2 つの経路が別の時点で読む形のため、この間の attach を許容する(起きても起動の失敗に留まると書く)か、I1・決定 1 の表現を「同じ attach の値であることは保証しない」に弱めるかを決める必要がある 直した
5 ドメインモデル(用語)/設計の結果 用語の表で「合う remote-cli」を追加、「デスクトップ版の code」を意味の変更としているが、設計の結果の「触るファイル」に用語集のファイルが入っていない。用語の追加・意味の変更が同じ変更の用語集に反映される経路が無いため、触るファイルに用語集を足す(または反映先を明記する)必要がある 直した

モード: standard / 通した工程: 設計 → 要求と受け入れ条件 → 詳細設計 → ドキュメント再構成 → ドキュメントレビュー

🤖 Generated with Claude Code

決めたこと

issues/issue-523-design.md

  • 決定 1: 拾い直したソケットと同じサーバーを使うため、セッション環境の VSCODE_GIT_ASKPASS_NODE から合う remote-cli を求める
  • 決定 2: VS Code の統合ターミナルと同じ状態にするため、合う remote-cli を PATH の先頭に足し、ペインの要素は並びを変えずに残す
  • 決定 3: セッション環境の値で任意の場所を PATH に入れないため、絶対パス・remote-cli の名前・実行できるエディタの 3 つを満たすときだけ足す
  • 決定 4: 版のずれたサーバーへ委ねないため、合う remote-cli を求められないときはほかを探さず、PATH を変えずに警告する
  • 決定 5: 起動の形を変えないため、起動するコマンドの先頭の語はエディタの名前のまま残し、起動に渡す環境の PATH で解決させる

takemi-ohama and others added 5 commits November 16, 2026 22:25
tmux でソケットを拾い直したときに、合う remote-cli を PATH の先頭に入れる
要求と受け入れ条件を課題の本文に書き、その写しを issues/ に置く。
用語集へ セッション環境・IPC ソケットの拾い直し・remote-cli・デスクトップ版の code を足す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tmux で IPC ソケットを拾い直したときに、セッション環境の VSCODE_GIT_ASKPASS_NODE から
合う remote-cli を求めて PATH の先頭に入れる設計を書く。求められないときは PATH を変えずに
警告する。用語集へ「合う remote-cli」を足し、「デスクトップ版の code」の意味を
VS Code のラッパーの振る舞い(PATH の remote-cli へ委ねる)に合わせて直す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 人へ残す判断に、要求の前提 2 の採否と起票者の推定 S1〜S6 の確認を載せる
- 「拾い直した」と受け入れ条件 6 の「ペインのソケットが接続できる」の区分をそろえる
- 拾い直す場面の既存のテストが追加の tmux の問い合わせを受けても通ることをテスト設計に足す
- ソケットと node のパスの 2 つの読みが同じ attach の値であることは保証しない、と I1・決定 1 を弱める
- 触るファイルに用語集を足す

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
設計文書の構成要素を opener.py の関数の粒度へ下ろした。新設する関数 4 つ
(エディタの名前・実行できるファイルの確かめ・合う remote-cli の探索・PATH の先頭への追加)と、
変える _prepare_ipc_env の仕様・異常系・ログ・再利用の確認・単体テストの観点を置いた。

設計文書の「設計の結果」の触るファイルのセルは、検査が区切りとして読めるよう
用語集の 2 ファイルを読点で並べた。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
内容は足さず、100 字を超える文を分け、決定 1 の段落を要点から並べた。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | claude | APPROVE

ドメインモデルの節(コンテキスト・集約・不変条件・ドメインイベント・用語)と用語集の差分を見た。critical / major に当たる指摘は無し。

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | kiro | REQUEST_CHANGES

ドメインモデルの節で、ドメインイベント E4・E5 の発生元が、構成要素と集約の持ち主の記述と食い違う。

Comment thread issues/issue-523-design.md Resolved
tmux から node のパスを読んで合う remote-cli を求めるのは探索、
PATH の先頭へ足すのは IPC の差し替えである。E4 の発生元を探索、
E5 の発生元を IPC の差し替えにし、探索が PATH を書き換えないことを
E5 の行に書いた。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | round 1 | commit 330862f

対応件数: critical=0 / major=1 / minor=0(合計 1 件)
決着: 1 件 / 見送り: 0 件 / 却下: 0 件
CI: SUCCESS

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | claude | APPROVE

round 1 の指摘への対応(E4 の発生元を探索・受け手を IPC の差し替え、E5 の発生元を IPC の差し替えにし、探索が PATH を書き換えないことを明示)を確認した。構成要素の表(130〜131 行)・依存の図・処理の流れのシーケンス図と食い違いは無い。critical / major に当たる指摘は無し。

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | kiro | APPROVE

前ラウンドの指摘(E4・E5 の発生元と受け手)は構成要素の表と整合した。新たな指摘なし。

@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | commit (なし)

対応件数: critical=0 / major=0 / minor=0(合計 0 件)
決着: 0 件 / 見送り: 0 件 / 却下: 0 件
CI: NONE

レッドラインに当たらない 2 件の判断を「人へ残す判断」から外し、
決定 1・決定 4 に設計の判断として理由とともに書いた。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@takemi-ohama
takemi-ohama marked this pull request as ready for review November 16, 2026 13:47
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

MVV 判定(設計承認ゲート・助言)

  • 判定: 従う(follow。助言であり、承認は利用者が行う)
  • 根拠: Mission / Vision / Value 1 / Value 2 / Value 3 / C1 / C6 / C7 / P1 / P2 / P3(MVV 版 1)
  • 時刻: 2026-11-16T13:47:57+00:00
  • ログ: /Users/takemi_ohama/.claude/ndf/state/mvv-gate.jsonl の 2026-11-16T13:47:57+00:00 の行

理由

  • Mission と Vision に沿う。tmux でソケットを拾い直したときも、手元の VS Code に dev コンテナへ接続した窓が開くようにする変更である。どの端末から入っても、整った開発環境で作業を始められる状態に近づく
  • Value 1 に沿う。拾い直しが起きないときの起動・環境・tmux への問い合わせは変えない(I2)。合う remote-cli を求められないときも PATH を変えずに起動を続け、警告で直し方を示す(決定 4・I4)。依存も base の道具も増えない
  • Value 3 と C1 に反しない。セッション環境から読むのは VSCODE_GIT_ASKPASS_NODE だけで、VSCODE_NONCE などの認証に関わる値はログに出さない。PATH に足すのは、絶対パスで、名前が remote-cli で、中に実行できるエディタがあるディレクトリだけに限る(決定 3・I3)
  • Value 2 と C6 に反しない。利用者の ~/.tmux.conf は書き換えず、update-environment の設定を案内するだけである。前提 2 と起票者の推定 S1〜S6 の採否は、設計者が決定 1・決定 4 に結論と理由を書いて確定させている
  • C・P の番号に当たる操作は無い。変更は設計文書と用語集の追加だけである。base イメージの道具(P1)、タグ・Release(P2)、実環境での devbase up(P3)、.ndf/ や指示書(C7)には触れない。要求の検査と設計レビューの検査が失敗しており、原因は未確認の残リスクである。ただし設計の内容は材料から読める

@takemi-ohama takemi-ohama added the design-approved ドキュメントレビューを人間が承認した label Nov 16, 2026
@takemi-ohama
takemi-ohama merged commit a0b67e5 into main Nov 16, 2026
10 checks passed
@takemi-ohama takemi-ohama mentioned this pull request Nov 16, 2026
@takemi-ohama
takemi-ohama deleted the design/issue-523 branch November 16, 2026 22:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

design-approved ドキュメントレビューを人間が承認した

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant