# Spec: 会話を依頼の根に結び付ける — 処理中に会話を切り替えても、答えは依頼した会話へ **ID**: 75 **Date**: 2026-11-12 **Status**: **Done**(2026-11-12。P4 = 実機 9 件をすべてログで観測。P4 の後に、会話の削除で承認待ちの印が残る穴を直した — 末尾の「P4 実機記録」)。以下は経緯 — rev3・未決 0 → **P0〜P3 完了**(2026-11-12 起票 → 同日、査読 2 系統 19 点(重なりを除いて 16 項目)を反映して rev2 → 利用者が未決 2 つを推しのとおりに裁定して rev3 → P0 = `data_contract.yaml` の `session_binding_contract` を凍結 14 本で凍結 → P1 = コア(結合 8 本・変異 6 回・全 1,518 本緑)→ P2 = 画面(vitest 1,100 本緑・変異 7 回・vue-tsc 0・build 緑。**実機は未確認**)→ P3 = 台帳(DETAIL 3 言語・README 3 言語)。記録は末尾の「P0 契約記録」「P1 実装記録」「P2 実装記録」「P3 台帳記録」。表は Notes 4。**次は P4(実機)**) **Branch**: main 直(Phase ごとにコミット) --- ## Goal サーヴァントが処理している間に「新規チャット」を押すと、その処理の答えは**新しい会話**に書き込まれる。 依頼は元の会話に、答えは新しい会話に分かれる。利用者の観察(2026-11-12)—「Fuseforks のセッションは、 一般の AI チャットアプリとは違う概念になっている」。 一般のチャットアプリでは、スレッドが仕事の単位で、依頼と答えは同じスレッドに属する。別のスレッドを開いても、 答えは依頼したスレッドへ書かれる。Fuseforks の会話(セッション)は「いま開いている会話」が村に 1 つあるだけで、 すべての書き込みは**書き込んだ瞬間に開いている会話**へ行く。 本 Spec は、会話を**依頼の根(因果)の属性**にする。根を作った時点の会話を封筒に載せて運び、その因果の 書き込みはその会話へ行く。画面とメモリ上の状態(広場ログ・履歴・要約)は、いま開いている会話の写しのままにする。 結果として次の 3 つが成り立つ: 1. 処理中に新規チャットを押しても、答え・1 往復の記録・ターンの統計は元の会話に残る 2. 新しい会話は、その前から走っていた処理の答えも、それを知る個体も持たずに始まる 3. 処理中でも既存の会話を開ける・分岐できる(拒否する理由が消える) **変えないもの**: 個体はプロセスのまま(受信箱は 1 本で、ターンは個体ごとに直列)。前の会話の処理で 忙しい個体は、新しい会話での返事が遅れる。これは一般のチャットアプリとの差として残る(範囲の外)。 --- ## 接地(起票前の実測。2026-11-12・コードの読み。rev2 で査読を受けて訂正) ### 書き込み先は書き込んだ瞬間の会話 - `Shared::persist`(`orchestrator/mod.rs:951`)は、保存の瞬間に `current_session()` を読む。 ターンを始めたときの会話はどこにも持っていない - `persist` を通る記録は 5 種類 — 発話 `message`(`Shared::record` = `mod.rs:649`)/ 1 往復 `exchange` (`push_exchange` = `mod.rs:975`)/ ターン `turn`(`settle_turn` = `turn.rs:350`)/ 要約 `summary` (`summarize_agents` = `mod.rs:811`)/ 下書き補助 `assist`(`assist.rs:345`) - `Shared::record` の呼び出しは **18 か所**(rev1 の「17」は数え間違い。ツール呼び出しの詳細の `record` 2 件は別物)。 - **因果の中の書き込み**(12): 利用者の発話 `runtime.rs:471` / 依頼の発話 `delegation.rs:191` / 束ねの配送と、 配送できなかった束ねの破棄 `delegation.rs:1165, 1188` / 止まったターンの System 行 `turn.rs:477, 618, 742` / 返信 `turn.rs:3331, 3432` / 予定の配送と検収の再依頼 `schedules.rs:381, 788` / 承認後の続行 `settings.rs:638` - **対象を持つ人の操作**(2): 計画の破棄 `mod.rs:1382`(波に属する)/ 要約の知らせ `mod.rs:878`(人が押した要約と、 予定の完了後要約 `schedules.rs:629, 817` の両方がここを通る) - **村全体の知らせ**(4): 入退室 `mod.rs:1073` / 役職 `lifecycle.rs:224` / 判断役の無効化 `judging.rs:580` (サーヴァントを消したときの `note_judges_losing`。rev1 は判断役の配送と取り違えて因果の側に入れていた)/ 停止中で飛ばした予定 `schedules.rs:214` - `TurnRecorded` の `session_id` も書いた時点の `current_session()`(`turn.rs:353`) - 失敗したターンの記録 `record_failed_turn`(`turn.rs:44`)は、`agent_loop`(`mod.rs:1616`)が封筒から `incoming` だけを写して呼ぶ ### メモリ上の状態は、いま開いている会話の写し - 会話を開く `open_session`(`mod.rs:902`)は、広場ログの輪・全員の履歴・要約・ツール呼び出しの詳細・ **承認待ちの印**(Spec 72)を消し、開いた会話の分を保存先から読み直す - プロンプトはこの写しから組む — 履歴 `turn.rs:3030` / 要約 `turn.rs:3060` / 広場ログと入退室 `context.rs:34, 222, 310`。`room_log` の pull(`read_room_log`、ターン中にツールの呼び出しごと)も `Shared.log` を読む - `Shared` の `world` / `log` / `summaries` は tokio の `RwLock`、開いている会話の ID は `std::sync::RwLock` (`mod.rs:416`)。`Shared::record` は `log` の write lock を外してから `persist` する ### 新規チャットは処理中でも通り、他の切り替えは拒む - 新規チャット(`create_session`、`sessions.rs:71`)は飛行中のターンがあっても通る。Spec 03 の案 A (飛行中ターンの完了書き込みは許容)を Spec 12 でも残した。理由は「着地先は新しい空の会話なので、 既存の記録を汚さない」(`data_contract.yaml` の `session_store` / `reset_rule`) - 既存の会話を開く・分岐・最新を開く・**開いている**会話を消すは、`ensure_idle_for_switch`(`sessions.rs:302`)が `Shared.turns` の件数で拒む(`SESSION_SWITCH_BLOCKED`、文面は「飛行中のターンがあるため会話を切り替えられません」)。 **開いていない会話の削除は処理中でも通る** - テスト `resuming_is_refused_mid_turn_but_a_new_chat_is_not`(`tests/session_persistence.rs:510`)が両方を固定している ### その結果、処理中に新規チャットを押すと 1. 依頼は元の会話に、答えは新しい会話に残る。新しい会話の最初に問いの無い答えが並ぶ 2. 新規チャットは全員の履歴を消し、その後で飛行中のターンが「依頼と答え」の 1 往復を積む。 その個体だけが新しい会話でも前の依頼を覚えていて、他の個体は白紙から始まる 3. 元の会話を開き直しても、その答えと 1 往復は無い(新しい会話へ移っている) 4. 委譲の続き(`ask` の答え・束ね・ツール行)と、ターンの統計も新しい会話に入る 5. 切り替えの後に届いた委譲(依頼元が古い会話の因果)は、新しい会話の空の履歴でプロンプトを組む 6. 承認待ちで止まった個体の印(Spec 72)は切り替えで消え、元の会話へ戻っても「続けさせる」が出ない **Spec 03 の「既存の記録を汚さない」は古い会話の側から見た理屈で、新しい会話の側から見ると 1・2 が混ざり、 古い会話の側も 3・6 を失っている。** ### 読みで見つけた潜在的な穴(未実測) - **要約の途中で会話を切り替えると、要約が別の会話へ書かれる。** `summarize_agents` は覆う範囲 `coversUpToSeq` を始めた会話で取る(`mod.rs:671`)が、保存とメモリ上の要約・履歴の畳み(`mod.rs:811` 以降)は 書いた時点の会話へ行く。要約は `Shared.turns` に入らないので、LLM を呼んでいる間は既存の会話を開く操作も 拒まれない。予定の完了後要約(Spec 28)も同じ関数を通り、しかも材料を「いま開いている会話」の履歴から読む - **予定の `sessionMode: fresh` は村全体の会話を切り替える**(`schedules.rs:433` の `start_fresh_session`)。 同じ tick に `fresh` と `continue` が混ざると、`continue` のぶんも新しい会話へ積む(`deliver_batch` の doc) - **予定の後判定と完了後要約は、個体の `AgentTyping { active: false }` で発火する**(`schedules.rs:44`)。 鍵は `AgentId` だけで、どの会話のターンが終わったかを見ない - 消した会話への書き込みは `SessionStore::append` が `SessionNotFound` を返し、`persist` が WARN を 1 行出して捨てる ### 根ごとの値を運ぶ形は既にある 封筒(`Envelope`、`mod.rs:200`)は根ごとの値を 4 つ運んでいる — 予算 `budget`(Spec 11)/ 参加者 `participants` (Spec 28)/ 待ちの連鎖 `waiting`(Spec 44)/ 計画の確認を開かない印 `auto_approve_plans`(Spec 53)。 新しい根で決め、`ask` / `plan` / 転送は受け取った封筒の値を写す。**会話はこの 5 つ目になる。** --- ## 決定(D) ### D1: 会話は依頼の根の属性。封筒に `SessionRef` を足す - `Envelope` に `session: SessionRef` を足す。`SessionRef` は**会話 ID と、その会話に結び付いた処理の生存数を 数える参照**(`Arc` の複製で数える)。誰かがこれを持っている間、その会話には処理が残っている(D11 で使う) - **新しい根が取る会話の規則は 1 つ: 「操作の対象が会話を持っていれば、その会話。持っていなければ、 そのとき開いている会話」** | 新しい根 | 対象 | 取る会話 | |---|---|---| | 利用者の発話(`runtime.rs:471`) | なし | 送った時点で開いている会話 | | 外部依頼(MCP の扉・`fuseforks-cli ask`。`ask_external_outcome`) | なし | 受けた時点で開いている会話 | | 予定の発火(`deliver_scheduled`) | なし | `fresh` はその予定のために作った新しい会話・`continue` は発火の時点で開いている会話(D14) | | 検収の再依頼(Spec 46。`redeliver_for_acceptance`) | 発火 | 元の発火の会話 | | 承認後の続行(Spec 56・72。`settings.rs:638`) | 承認待ちの印 | 印の会話(D5) | | 計画の確認の承認で配る波(Spec 43。`run_dispatched_wave`) | 計画の波 | 計画を提示した会話(D6) | | 束ねを進行役へ戻す配送(Spec 43 凍結 5。`delegation.rs:1165`) | 計画の波 | 計画を提示した会話(D6) | - **写す経路**: `ask` / `plan`(`execute_wave` の配送)/ 転送 / 判断役の配送(`run_judge` → `deliver_and_wait`)は、 受け取った封筒の `SessionRef` を写す。上書きしない - `deliver_and_wait` は新しい根(`ask_external_outcome`)と写す経路の両方から呼ばれるので、**会話を引数で受け取る** (自分では決めない) - 封筒に載らない処理(下書き補助・要約)も、始めた時点で `SessionRef` を取り、終わるまで持つ(D2 の表・D7) ### D2: 書き込みは運んできた会話へ。いま開いている会話のときだけメモリと画面にも - `persist(record)` を `persist(record, &SessionRef)` にする。**呼び出しはすべて会話を明示する**(暗黙の `current_session()` を読む `persist` は残さない) | 記録 | 会話の出どころ | |---|---| | `message`(因果の中・対象を持つ操作) | 封筒の `SessionRef`、または対象の `SessionRef`(D1 の表・D6) | | `message`(村全体の知らせ) | 書いた時点で開いている会話(D9) | | `exchange` | ターンの封筒。失敗したターン(`record_failed_turn`)にも封筒の `SessionRef` を渡す | | `turn` | ターンの封筒。`TurnRecorded.sessionId` も同じ | | `summary` | 要約を始めたときに取った `SessionRef`(D7) | | `assist` | 下書き補助を始めたときに開いていた会話の `SessionRef` | - `Shared::record(message, &SessionRef)` - その会話がいま開いていれば、今と同じ — 広場ログの輪へ積み、保存し、`MessageSent` を出す - 開いていなければ、**保存だけ**する。輪へは積まず `MessageSent` も出さない。代わりに `SessionUpdated { sessionId }` を出す(D10) - `push_exchange` も同じ規則 — 開いていればメモリ上の履歴へ積んで保存、開いていなければ保存だけ ### D3: 「いま開いているか」の判定と会話の切り替えを、1 本の lock で直列にする - 開いている会話の ID(今は `std::sync::RwLock`)を **tokio の `RwLock`** にし、これを 「開いている会話の lock」とする - **書き手**(`record` / `push_exchange` / `settle_turn` / 要約の保存と畳み)は、この lock の **read** を取ってから 「開いているか」を判定し、メモリへの積み込みと `persist` を済ませてから外す - **切り替え**(`open_session`)は、この lock の **write** を取り、保存先の読み直し → メモリ上の状態の差し替え → `set_session` を済ませてから外す。**保存先の読み直しの間、`world` の lock は持たない**(差し替えるときだけ短く取る) - **lock の順序は「開いている会話の lock → `world` → `log` → `summaries`」で固定する。** `world` を握ったまま 開いている会話の lock を取る経路を作らない。今の `push_exchange` は呼び出し側が `world` の write guard を握って 呼ぶ形(5 か所)なので、呼び出し側が先に開いている会話の lock を取る形へ並べ替える - 帰結: 書き込みが切り替えより先なら、保存済みの記録として読み直しに含まれる。後なら、開いた会話のメモリへ積まれる。 どちらでも 1 回だけ載る。切り替えが書き手を待たせるのは、保存先の読み直しの間(Spec 12 の実測で 20,000 件の 全走査 11 ms)だけ ### D4: 読み取りも運んできた会話から 開いていない会話に結び付いたターン(切り替えの後に届いた委譲・受信箱で待っていた発話)は、プロンプトを **その会話の保存先から**組む。開いている会話のターンは今と同じ(メモリ上の写しを読む)。 - 保存先から読むもの: 履歴(`restore_histories` を 1 体ぶん)/ 要約 / 広場ログの抜粋と入退室の節(`tail_messages`)。 ターンの開始で 2 回の読み - `room_log` の pull(`read_room_log`)に会話の引数を足す。開いていない会話のターンは、呼び出しのたびに その会話の保存先を読む(rev1 の「読み 1 回」は誤り。pull のぶんが呼び出しごとに足される) - 要約の材料も同じ規則で読む(D7) ### D5: 承認待ちの印は(個体, 会話)で持つ Spec 72 の印(`Shared.approval_stopped`)は今は個体の集合で、`open_session` が全部消す。切り替えを許すと、 別の会話へ移った後に止まった個体の帯と「続けさせる」が無関係な会話に出て、押すとその会話へ「続けてください」が届く (Spec 72 が防いだ不具合の再発)。逆に、止まった後に別の会話を見て戻ると印が消えている。 - 印を `HashSet<(AgentId, SessionId)>` にする。**`open_session` は印を消さない** - 印を立てるのは止まったターンの封筒の会話。外すのは同じ会話の出来事だけ — その個体のその会話での次のターンの入口 (`turn.rs:1123`。今は会話を問わず外している = 別の会話のターンで A の印が消える)/ その印の「続けさせる」 (`settings.rs:635`)。**個体の停止と削除は会話を問わず全部外す**(停止 `runtime.rs:228`・削除 `lifecycle.rs:233` の 今の規則のまま) - 「続けさせる」の新しい根は印の会話(D1 の表) - 画面: 入力欄の上の帯(Spec 72 の腕)と承認画面の「続けさせる」は、**開いている会話の印だけ**を出す。 承認画面は、他の会話の印を「別の会話(タイトル)で止まっています。その会話を開くと続けさせられます」の 1 行で出す。 **コマンドの判断待ち(`run.json` の `pending`)は個体の単位のままで、会話を問わず承認できる** - 予定の後判定の見送り(`schedules.rs:58`)は、根の会話の印を見る(D8) - 印はメモリだけで、再起動で消える(Spec 72 の利用者が負う条件のまま) - **追補(P4 の後): 会話を削除すると、その会話の印を個体を問わず外す。** 印は処理ではない(ターンは閉じている)ので 削除は断らない。rev3 はこの経路を数えておらず、印が残ると承認画面に消えた会話の「開く」が出て、続行が消えた会話へ 書かれる(P4 の前にコードの読みで見つけた。実機では踏んでいない)。外すのは削除と同じ参照の表の lock の下で、 続行は印の会話への参照を取ってから印を確かめ直す(印を読んだ後・参照を取る前に消された場合は開いている会話へ) ### D6: 計画の波は提示した会話を持つ - 承認待ちの波(`Shared.plan_waves` の提示)に、提示したターンの封筒の `SessionRef` を持たせる - 承認で配る波・束ねの配送・配送できなかった束ねの破棄の System 行(`delegation.rs:1188`)・計画の破棄の System 行 (`mod.rs:1382`)は、すべてその会話へ書く(rev1 は計画の破棄を「村全体の知らせ」に分類していた) - 作業状況タブは今と同じく**すべての波を出す**(村の作業の一覧)。波に会話 ID を持たせ、開いている会話以外の波には 「別の会話」と出す。確認待ちの件数のバッジも全部を数える(人の手番であることは会話を問わない)。 承認すると、配る先は計画を提示した会話(開いている会話ではない) - 承認待ちの波は `SessionRef` を持つので、その会話を消す操作を拒む(D11) ### D7: 要約は始めたときの会話に結び付ける `summarize_agents(session: SessionRef, only)` にする。 - 会話の出どころ: 人が押した要約は押した時点で開いている会話 / 予定の完了後要約(Spec 28・46)は**根の会話** (`pending_summaries` / `pending_acceptances` に根の `SessionRef` を持たせる。D8) - 材料(履歴・前の要約)はその会話から読む(D4 の規則 — 開いていればメモリ、開いていなければ保存先)。 覆う範囲 `coversUpToSeq` もその会話で取る - 保存とその System 行(「N 体の記憶を要約しました」、`mod.rs:878`)はその会話へ。メモリ上の要約の差し替えと 履歴の畳みは、**その会話がいま開いているときだけ**(D2・D3 の規則) - 要約を走らせている間は `SessionRef` を持つので、その会話は消せない(D11) ### D8: 予定の後判定と完了後要約は、根の会話のターンの終わりで発火する - `ScheduleRuntime` の `pending_acceptances` / `pending_summaries` に根の `SessionRef` を持たせる - `AgentTyping` に `sessionId` を足し、**個体と会話の両方が一致した `active: false`** でだけ取り出す。 同じ個体の別の会話のターンが終わっても発火しない - 承認待ちの見送り(`schedules.rs:58`)は(個体, 根の会話)の印を見る(D5) - `in_flight`(同じ予定の重なりを止める集合)は個体の単位のまま — 個体が忙しいことは会話を問わない - 残る近似: 同じ個体・同じ会話で、利用者の発話のターンが予定のターンより先に終わると、今と同じく早く発火しうる (本 Spec では変えない。会話を足したことで、別の会話のターンによる誤発火だけが消える) ### D9: 村全体の知らせは、書いた時点で開いている会話にだけ残す - 対象: 入退室 / 役職の変更 / 判断役の無効化 / 停止中で飛ばした予定 - これらは村の状態の**変化の記録**で、どの依頼の因果にも属さない。書いた時点で開いている会話に記録し、 **その会話のプロンプトにだけ入る**(入退室の節は広場ログから組むため) - 開いていない会話のターンは、その間に起きた村の変化を節としては見ない。**それで困らない理由**: 顔ぶれの節は 会話の記録からではなく毎ターン `World` から組み、入退室の節の末尾に「現在の状態は「今の顔ぶれ」が正です」と書いてある (Spec 06・`context.rs:72`)。誰が稼働しているかは、どの会話のターンも今の状態で持つ - 開いている会話のプロンプトに、いま起きた村の変化が入るのは今と同じで、汚染ではない ### D10: 画面 - 会話ペインは開いている会話の発話だけを出す(D2 で `MessageSent` が出ないので、コアの側で決まる) - `ToolInvoked` と `AgentTyping` に `sessionId` を足す - **`state.typing` は個体の単位のまま**(会話を問わず「その個体が忙しい」)。黒板の持ち主の状態と `interruptAll()` はこれを読むので、会話で絞ると壊れる - 入力中のバブルと周回数(`toolRound`)は、`typing` の会話が開いている会話のときだけ出す (個体ごとに `typingSession` を持つ) - ツール行(`toolRuns`)は開いている会話の `ToolInvoked` だけ積む。カードの `lastTool` は個体の単位のまま - **一覧のカードに「処理中」の表示は今も無い**(rev1 の「カードは会話に関係なく処理中を出す」は前提の誤り)。 足さない - 会話を開き直しても、処理中だったターンのツール行と周回数は戻らない。ツール行はメモリだけの投影で、開き直しで 消えるのは今と同じ(Spec 57 の利用者が負う条件)。入力中のバブルは `typingSession` から戻る - `SessionUpdated { sessionId, from }`(`from` は P0 で足した。トーストに送り手の名前を出すため)の受け手は 2 つ — 会話一覧(`state.sessions` を引き直して並びと更新時刻を変える)と、 開いていない会話に答えが書かれたことの知らせ。System 行にはしない(今の会話のログとプロンプトへ 入る = `failures.md` #89 の経路) - **知らせはトーストと「開く」ボタン**(2026-11-12 裁定)。文言は「別の会話({タイトル})に {名前} の答えが届きました」。 「開く」はその会話を開く(D11 で処理中でも開ける)。出すのは**開いていない会話にサーヴァントの発話が書かれたとき** だけで、利用者の発話・System 行・1 往復やターンの記録では出さない。同じ会話への知らせが続くときは 1 枚にまとめ、 最後の送り手の名前と件数を出す(予定の波で 5 体が答えるとトーストが 5 枚並ぶため) ### D11: 切り替えは拒まない。消すのは処理の残っていない会話だけ - **既存の会話を開く・分岐・最新を開くは、処理中でも通す。** 拒否の理由(前に保存された会話へ無関係な答えが混ざる)は D2 で消える。`ensure_idle_for_switch` を撤去する - **会話を消す操作は、その会話の `SessionRef` を誰かが持っている間は拒む。開いているかどうかを問わない** (rev1 の「開いている会話だけ」は、新規チャットで移ってから処理中の会話を消せる非対称を残していた) - `SessionRef` を持つもの: 封筒(受信箱で待っているものも、飛行中のものも)/ 承認待ちの波(D6)/ 予定の 後判定と完了後要約の登録(D8)/ 走っている要約(D7)/ 走っている下書き補助 - エラーは新しい `SESSION_BUSY`(「この会話にはまだ処理が残っています。終わってから消してください」)。 `SESSION_SWITCH_BLOCKED` は作る経路が無くなるので撤去する(文面が実態と逆になるため流用しない) - 判定と `SessionRef` の発行は同じ lock の下で行う(消した直後にその会話の参照が新しく作られない)。 `SessionNotFound` の WARN は網として残す ### D12: 計器 - `turn:` 行の末尾に `session=<会話 ID>` を足す - 開いていない会話へ書いた発話は `session write: kind=message session=… open=…` を 1 行出す。 開いている会話への書き込みでは出さない - 消す操作を拒んだときは `session busy: session=… refs=N` を 1 行 ### D13: 保存先の無い村 会話の単位が無いので今と同じ。`SessionRef` は持たず(`None`)、**「開いているか」の分岐をしない**(常に開いている扱いで、 書き込みはメモリだけ、新規チャットはメモリを白紙にする)。空の会話 ID を「全会話に共通」と読む経路を作らない。 ### D14: 予定の `fresh` は画面を切り替えず、新しい会話へ書く(2026-11-12 裁定) - `start_fresh_session`(`schedules.rs:433`)は `open_session` を呼ばない。`SessionStore::create_session` で会話を作り、 その会話の `SessionRef` を発火の根にする。**開いている会話も画面も動かない** - `fresh` の予定は**1 件ごとに新しい会話を 1 つ作る**。同じ tick の `continue` の予定は、発火の時点で開いている会話を 根にする(`deliver_batch` の「`fresh` が 1 件でもあれば全部を新しい会話へ積む」をやめる。あれは会話が村に 1 つ だった頃の、画面を 2 回切り替えないための規則) - 新しい会話のターンは、開いていない会話のターンとして D4 で読む(空の履歴・要約なし・空の広場ログ)。答え・ 1 往復・ターン・検収の再依頼・完了後要約はすべてその会話へ(D1・D2・D7・D8) - 作った会話は作った時点から会話一覧に並ぶふつうの会話。答えが書かれると D10 の知らせが出る - 保存先の無い村では会話を作れないので、今と同じく開いている会話(メモリ)へ配送する(D13) - 代償(利用者が負う条件): 予定の結果を見るには、知らせの「開く」か会話一覧から開く必要がある --- ## 覆す判断 - **Spec 03 の案 A**(飛行中ターンの完了書き込みは新しい会話に載る)。理由は「着地先は新しい空の会話なので 既存の記録を汚さない」だったが、新しい会話の側を汚し、古い会話の側から答えと承認待ちの印を失わせていた - **Spec 12 の不変条件 11**(処理中は既存の会話を開けない)。理由は D2 で消える。消す操作の条件だけ残し、狭め直す(D11) - **Spec 72 D5 (d)**(会話の切り替えで承認待ちの印を全部外す)。印を(個体, 会話)で持つので、外す必要が無くなる(D5) - **Spec 28 の `sessionMode: fresh`**(新しい会話を開いて村全体を切り替える / 同じ tick の `continue` も新しい会話へ積む)。 画面を切り替えずに新しい会話へ書く(D14) - `data_contract.yaml` の `session_store` と `reset_rule` の該当行、`approval_stops_the_turn` の印の節、 エラーコードの一覧(`SESSION_SWITCH_BLOCKED` → `SESSION_BUSY`) --- ## 範囲の外 - **個体ごとの並行**。個体の受信箱は 1 本のまま。前の会話の処理で忙しい個体は、新しい会話での返事が遅れる - **2 つの会話を同時に画面に開く**(分割表示) - 外部依頼(MCP の扉)に会話を選ばせる口。外部依頼は「受けた時点で開いている会話」を根の会話にする - 予定の後判定の「同じ会話の別のターンで早く発火しうる」近似(D8 の残り) --- ## 未決 **0**(2026-11-12 利用者裁定「推しのとおりに」)。 - rev2 の未決 1(予定の `fresh`)→ **画面を切り替えず、予定ごとに新しい会話を作ってそこへ書く**(D14)。 退けた案 = 今と同じく村全体を切り替える - rev2 の未決 2(開いていない会話に答えが書かれたときの知らせ)→ **トーストと「開く」ボタン**(D10)。 退けた案 = トーストだけ / 知らせない - rev1 の未決 2(計画の確認の承認で配る根の会話)は rev2 で D1 の規則 1 つに畳んで閉じた — 対象を持つ操作は対象の会話 --- ## Phases ### P0: 契約 - `data_contract.yaml` — `session_store` と `reset_rule` を本 Spec の形へ(覆したことを書く)/ 封筒の 5 つ目 (`SessionRef`)と D1 の表 / D2 の表 / D3 の lock の順序 / `approval_stops_the_turn` の印(D5)/ イベント `SessionUpdated` と `ToolInvoked.sessionId`・`AgentTyping.sessionId` / `SESSION_BUSY`(`SESSION_SWITCH_BLOCKED` の撤去)/ `turn:` 行の `session=` と `session write:` / `session busy:` 行 / 予定の `sessionMode: fresh` の意味(D14) - Spec 03・12・28・72 の該当行に「→ Spec 75 で覆した」 ### P1: コア - `SessionRef` と、`Envelope.session`・D1 の表の新しい根 7 つ・写す経路 4 つ・`deliver_and_wait` の引数 - `persist` / `record` / `push_exchange` / `settle_turn` / `record_failed_turn` の書き込み先(D2)と lock(D3) - 開いていない会話の読み取り(D4。`read_room_log` の引数を含む) - 承認待ちの印(D5)・計画の波(D6)・要約(D7)・予定の後処理(D8)・予定の `fresh`(D14) - 切り替えの拒否の撤去と消す操作の拒否(D11)・計器(D12) - テスト(結合): 1. 処理中に新規チャット → 答え・1 往復・ターンは元の会話にあり、新しい会話には無い 2. 新しい会話のメモリ上の履歴に古い 1 往復が入らない。元の会話を開くと戻る 3. 切り替えの後に届いた委譲が、元の会話の履歴でプロンプトを組む(プロンプトを写すスタブで確かめる) 4. 処理中に既存の会話を開ける。その会話に結び付いた答えはメモリと画面にも載る(書き込みが切り替えの先と後の 2 通り) 5. 要約の途中で切り替え → 要約は始めた会話へ書かれ、開いた会話の履歴は畳まれない 6. 村全体の知らせは書いた時点で開いている会話へ 7. 開いていない会話への発話で `MessageSent` が出ず、`SessionUpdated` が出る 8. 会話 A で承認待ちで止まった後に B を開く → B に A の印は出ず、A を開き直すと「続けさせる」が出る。押すと A へ届く 9. B を開いている間に A のターンが承認待ちで止まる → 印は A に付く。B の帯に出ない 10. 計画を A で提示 → B を開いて承認 → 波と束ねは A へ。B で破棄しても破棄の行は A へ 11. 予定の後判定: 根が A のとき、同じ個体の B のターンの終わりでは発火しない 12. 消す操作: 飛行中・受信箱で待っている発話・承認待ちの波・走っている要約のどれかがある会話は、開いていても いなくても `SESSION_BUSY`。無くなれば消せる 13. 失敗したターンの 1 往復が、ターンの会話へ書かれる 14. `fresh` の予定の発火で開いている会話が変わらず、`SessionSwitched` が出ない。答え・1 往復・ターンは新しい会話へ書かれ、 ターンのプロンプトは空の履歴で組まれる 15. 同じ tick の `fresh` 2 件と `continue` 1 件 → 新しい会話が 2 つでき、`continue` は開いている会話へ - `resuming_is_refused_mid_turn_but_a_new_chat_is_not` を新しい規則へ書き換える(覆したので期待が逆になる) ### P2: 画面 - `ToolInvoked` / `AgentTyping` の `sessionId` で会話ペインのバブル・周回数・ツール行を絞る(D10) - 承認画面と帯の印を開いている会話で絞り、他の会話の印は 1 行で出す(D5) - 作業状況タブの波に「別の会話」(D6) - `SessionUpdated` の受け手(会話一覧の引き直し・トーストと「開く」。同じ会話への知らせは 1 枚にまとめる) - 会話一覧・分岐の「処理中は開けません」の案内を外し、削除の `SESSION_BUSY` の文言を辞書 3 言語へ ### P3: 台帳 - DETAIL 3 言語の会話の節(新規チャットの説明・処理中の切り替え・消せない条件)と、予定の節(`fresh` は画面を 切り替えず新しい会話へ書く) - README は会話の行に触れていれば 1 句 - CLAUDE.md の Spec の状態 ### P4: 実機 1. ザリに時間のかかる調査を頼み、答えが出る前に新規チャット → 新しい会話に答えが出ない・知らせが出る 2. 元の会話を開く → 依頼と答えが並んでいる 3. 2 の答えの後、同じ会話で「さっきの答えを要約して」→ ザリが覚えている 4. 新しい会話でザリに別のことを頼む → 前の依頼を覚えていない 5. 委譲の途中(進行役が `ask` で待っている間)に新規チャット → 束ねが元の会話に戻る 6. 処理中に会話一覧から別の会話を開ける。処理中の会話は消せない 7. 承認待ちで止まった個体のいる会話から別の会話へ移って戻る → 「続けさせる」が出る 8. `turn:` 行の `session=` が、依頼した会話の ID になっている 9. `fresh` の予定を 1 分後に置いて別の会話を見ている → 画面は切り替わらず、知らせの「開く」で予定の会話が開き、 依頼と答えが並んでいる --- ## Notes 1. **起点**: 利用者(2026-11-12)—「エージェントの処理中に新規チャットで遷移したとする。その場合は新しいチャット セッションに処理の結果が出力される。今は Fuseforks はセッションという概念が一般の AI チャットアプリとは 違う概念になってると思う」。同日の調査で接地の 1〜5 を確かめ、利用者が起票を指示 2. **新規チャットを処理中に止める・拒む案は採らない。** 「線は人が引く」の判断(自動で `interrupt_all` してから 切り替えない)とぶつかり、拒むと急ぎの新しい依頼が出せなくなる 3. **この Spec の後も会話は「村の記録」の面を持つ。** 会話は「依頼の因果の記録」と「開いていた間の村の出来事の記録」の 2 つを持ち、前者だけが根に結び付く(D9) 4. **査読(2026-11-12・2 系統 19 点、重なりを除いて 16 項目)**。判定は 採用 13 / 前提を訂正して採用 1 / 一部採用 1 / 形を変えて採用 1。反証は 0 | # | 指摘 | 判定 | 行き先 | |---|---|---|---| | A1・B① | 切り替えを許すと承認待ちの印(Spec 72)が壊れる — 切り替えで消える / 別の会話へ移った後に止まると無関係な会話に帯と「続けさせる」が出る | 採用 | D5 | | A2 | 村全体の知らせを書いた時点の会話に書くと、D4 で読むときに中途半端 | 前提を訂正して採用 — 開いている会話に今の村の変化が入るのは今と同じで正しい。欠けていたのは規則の明記(D9)と、計画の破棄の分類(D6) | D6・D9 | | A3・B⑤ | 受信箱で待っている発話は `Shared.turns` に入らず、消す操作が通る / 開いている会話だけ拒む非対称 / 波・後判定・要約を処理中として数えられない / `SESSION_SWITCH_BLOCKED` の文面が逆になる | 形を変えて採用 — 件数の登録簿を増やす代わりに、会話への参照(`SessionRef`)を持つもの全部を数える | D1・D11 | | A4 | 封筒を持たない下書き補助・人が押した要約の会話の決め方が D2 の「5 種類すべて運んできた会話へ」と食い違う | 採用 | D2 の表・D7 | | A5・B③ | 承認後の続行・計画の確認の承認・検収の再依頼で、D1 と未決 2 が逆を読める / 計画の破棄は計画の会話に属する | 採用 — 規則を 1 つにして未決 2 を閉じた | D1・D6 | | A6・B⑧ | lock の順序が未定義。`world` を握って保存先を読むと全個体が止まる / `record` は `log` を外してから保存している | 採用 | D3 | | A7 | 未決 1 (b) と Goal 2・D1 の文言 | 一部採用 — D1 の予定の行を未決に依存する形へ。(b) で作った会話は作った時点から一覧に並ぶふつうの会話で、Goal 2(利用者の新規チャット)とは別の話。rev3 で (b) に決まった | D1・D14 | | A 細 1 | 保存先の無い村の空の会話 ID | 採用 | D13 | | A 細 2 | 消す操作のテストに受信箱の発話が無い | 採用 | P1 テスト 12 | | A 細 3 | `SessionUpdated` の受け手が決まっていない | 採用 | D10 | | B② | 予定の完了後要約は根の会話でなく開いている会話を読み、そこへ書く | 採用 | D7・D8 | | B④ | 予定の後処理は個体だけを鍵に `AgentTyping` で発火する / `fresh` と `continue` の相乗り | 採用 | D8・D14 | | B⑥ | `record` は 18 か所。`judging.rs:580` は削除時の知らせ、`mod.rs:878` は予定の要約も通る | 採用 | 接地 | | B⑦ | カードに「処理中」の表示は無い / `state.typing` は黒板と `interruptAll()` が使う / 開き直しでツール行と周回数が戻らない | 採用(前提の誤り) | D10 | | B⑨ | `record_failed_turn` に会話が渡らない / 根と写す経路の内訳 | 採用 | D1 の表・D2 の表・P1 テスト 13 | 5. **rev1 の私の誤り**(同じ形が 3 つ): `record` の呼び出しをファイルと関数の名前で分類し、中身を読まなかった (`judging.rs` を「判断役の配送」と読んだが、削除時の知らせだった)/ 画面の前提(カードの「処理中」)を UI を 読まずに書いた / 保存先の読みを「1 回」と書き、ターン中の pull を数えなかった。**名前から中身を語らない** (2026-08-17 の `aion-compact` と同じ形) --- ## P0 契約記録(2026-11-12) **`data_contract.yaml` に `session_binding_contract` を新設し、凍結 14 本(D1〜D14 の要点)を置いた** (`session_store` の直後)。覆した側の節にはその場で覆したことを書いた。 | 節 | 書いたこと | |---|---| | `session_store` | 「セッションの切り替えは飛行中ターンが無いときだけ」に覆しを前置 / `assist` の書き込み先を「始めた時点で開いていた会話」へ | | `reset_rule` | 案 A の不変条件に覆しを追記 / Spec 12 改訂節の「飛行中ターンの扱いだけは新規チャットが特別」を取り消し線にし、処理の順は開いている会話の lock の下で・承認待ちの印は消さない、を足した | | イベント | `agentTyping` / `toolInvoked` / `approvalStopped` に `sessionId`(加算)/ `sessionUpdated { sessionId, from }` を新設 / `turnRecorded.sessionId` の意味を「ターンの根の会話」へ | | エラーコード | `SESSION_SWITCH_BLOCKED` を一覧から外し(撤去は P1・P2)、`SESSION_BUSY` を足した | | `observability_rule` | `turn:` 行の末尾に `session=`(`repeat_max=` の後)/ `session write:` / `session busy:` の行 | | 承認待ちの止まり方(Spec 72 の節) | 印の型と (d) の撤回を前置 | | 予定の前判定の配送(`ScheduleProbe.delivery`) | `fresh` の意味と同じ tick の規則に覆しを前置 | | 予定の後判定(`Acceptance`) | 再依頼の会話は「元の発火の会話」/ 見送りと取り出しは(個体, 根の会話) | | 計画の確認(`plan_edit_window` 凍結 2) | 提案が会話を持ち、承認・束ね・破棄はその会話へ | | 下書き補助(`assist_contract` 10) | 書き込み先を「始めた時点で開いていた会話」へ | **Spec の本文から 1 つ足したもの**: `sessionUpdated` に `from`(送り手)を持たせた。D10 のトーストは送り手の名前を出すが、 rev3 の `SessionUpdated { sessionId }` だけでは画面が名前を知る経路が無かった(本文は運ばない — 開くと `sessionSwitched` → `list_messages` で読む)。 **覆した側の Spec に追記**: Spec 03(案 A)/ Spec 12(P2 の (b))/ Spec 28(D6)/ Spec 72(D5 (d) と現況の 1 行)に 「→ Spec 75 で覆した」を書いた。 **検証**: `data_contract.yaml` は既知の箇所(`llm_wire` の中、本文の `**…**:` が YAML の mapping と読まれる行)で strict パーサが元から落ちる。落ちる行の本文は前後で同じ(行番号だけ 148 行ずれた)。`llm_wire:` より前を切り出して HEAD と作業コピーの両方を読み、差分は意図した 10 節の本文と、足した 6 キー(イベントの `sessionId` 3 つ・ `sessionUpdated` の 2 欄・`session_binding_contract`)だけだった。 **P1 で決めること(P0 では決めない)**: `SessionRef` の型の置き場と、会話 ID の弱参照の表の持ち方 / 開いている会話の lock を `Shared.session_id` の型変更で作るか別の lock で作るか / `push_exchange` の呼び出し 5 か所の並べ替えの形 --- ## P1 実装記録(2026-11-12) **コアの配線を入れた。** 全 1,518 本緑(GUI の crate を除くワークスペース。84 バイナリ・無視 7 は従来どおり)・ clippy 0。画面(P2)はまだで、フロントは新しい欄を読んでいない。 ### 入れたもの(D ごと) | D | 実装 | |---|---| | D1 | `orchestrator/session_ref.rs` を新設 — `SessionRef`(`Option>`。`None` は保存先の無い村)と `SessionRefs`(会話 ID → `Weak` の表。`issue` / `when_unreferenced`)。`Envelope.session` / `deliver(…, session)` / `deliver_and_wait(…, session)`(自分では決めない)/ `TurnContext.session` / `CallRunner.session` / `dispatch_outcome(…, session)`。根は 7 つ: 利用者の発話と外部依頼 = `open_ref()` / 予定の発火 = `fire_session` / 検収の再依頼 = 発火の会話 / 続行 = 印の会話 / 承認で配る波と束ね = `plan_sessions` の控え | | D2 | `persist(record, &SessionRef)`(暗黙の `current_session()` を読む形を撤去)/ `record(message, &SessionRef)` と `record_open`(村全体の知らせ)/ 開いていない会話へは保存だけ + `SessionUpdated { sessionId, from }` + `session write:` 行 / `push_exchange(&OpenGate, …, &SessionRef, …)` | | D3 | `Shared.switch_gate: tokio::sync::RwLock<()>`。`open_session` は write を取り、保存先を**先に**読んでから `world` → `log` → `summaries` を差し替え、最後に `set_session` | | D4 | `build_prompt` が gate の read を持ったまま、開いていなければ `stored_view`(履歴・要約・会話ログ)で組む。`compose_room_log` / `compose_presence_notices` に `stored_log` / `read_room_log` に会話 | | D5 | 印を `HashSet<(AgentId, String)>` に。`open_session` で外さない(保存先の無い村の新規チャットだけ全部外す)/ 停止・削除は会話を問わず外す / `CommandPolicyView.stoppedElsewhere` を足し、`stoppedForApproval` は開いている会話の印だけ | | D6 | `Shared.plan_sessions`(plan_id → `SessionRef`)。承認・束ね・破棄の行はその会話へ / `PlanWaveRecord.sessionId` / `PlanWaveStarted`・`PlanWaveProposed` に `sessionId` | | D7 | `summarize_agents(session, only)`。開いていなければ材料を保存先から、保存は始めた会話へ、メモリの差し替えと畳みは開いているときだけ。System 行もその会話へ | | D8 | `pending_summaries` に `(Participants, SessionRef)` / `AcceptancePending.session` / 完了の合図は `AgentTyping.sessionId` が根の会話と一致したときだけ取り出す | | D9 | 入退室・役職・判断役の無効化・停止中で飛ばした予定は `record_open` | | D11 | `ensure_idle_for_switch` を撤去。`delete_session` は開いている会話なら先に `latest_session_except` へ移り、`when_unreferenced` の中で消す。`CoreError::SessionBusy`(`SESSION_BUSY`)を新設し `SessionSwitchBlocked` を撤去 | | D12 | `turn:` 行の末尾に `session=` / `session write:` / `session busy:` | | D14 | `fire_session` が `fresh` の予定ごとに `create_session` して参照を返す(`open_session` は呼ばない)/ 配送を見送ったら作った空の会話を消す(`discard_empty_session` — 見送りのたびに空の会話が 1 つずつ増えないように) | ### P0 の文面から実装で決めた形(契約に追記済み) - **開いている会話の lock は別の lock にした**(P0 凍結 3 は「会話 ID を tokio の RwLock に」と書いていた)。`switch_gate` は中身を 持たず順序だけを守り、会話 ID は `std::sync::RwLock` のまま — `current_session()` を同期のまま呼べる。`push_exchange` は gate の read guard(`OpenGate`)を引数に取り、取り忘れを型で止める - **`CommandPolicyView.stoppedElsewhere`**(凍結 5 の「別の会話で止まっています」の材料)。「続けさせる」の IPC は個体 ID だけを受け、 会話は印から決める(開いている会話に印があればそれ、無ければ最初の印、印が無ければ開いている会話) - **波の会話は `PlanWaveStore` の外**(`plan_sessions`)に控える — 純粋な記録に参照(`SessionRef`)を持たせない。画面のための ID だけ `PlanWaveRecord.sessionId` に写す - 予定の `fresh` で配送を見送ったときの空の会話の削除(D14 には無かった) ### テスト - **結合 `tests/session_binding.rs` 8 本** — 答えは依頼した会話に残り `MessageSent` を出さず `SessionUpdated` を出す / 新しい会話は前の 依頼を知らず、処理中でも元の会話を開けて開くと戻る / 切り替えの後に届いた委譲は依頼した会話の履歴で考える / 要約の途中で切り替えても 始めた会話へ書く / 村全体の知らせは開いている会話へ / 飛行中・受信箱の発話が残る会話は開いていても消せない / 失敗したターンの記録は ターンの会話へ / `fresh` の予定は画面を切り替えず予定ごとの会話へ・同じ tick の `continue` は開いている会話へ - **単体 `session_ref.rs` 3 本** - **覆した凍結を留めていた既存の 3 本を書き換えた** — `approval_stops_turn.rs` (14)(切り替えで印が外れる → 元の会話に残る・開くと戻る)/ `session_persistence.rs`(処理中の開き直しは拒否 → 通る)/ `orchestrator.rs`(飛行中の答えが新しい会話に載る → 載らない) - **ワイヤ形の凍結** — `approvalStopped.sessionId` / `toolInvoked.sessionId` / `sessionUpdated` を新設 / `CommandPolicyView.stoppedElsewhere` / `PlanWaveRecord.sessionId` ### 変異(予測を先に書いた) | 変異 | 予測 | 結果 | |---|---|---| | M1 `persist` が開いている会話へ書く | 5 本 | **6 本** — 予測を 1 本外した。`the_new_conversation_forgets_and_reopening_remembers` も赤(1 往復が新しい会話へ行くので、元の会話を開いても戻らない)。説明のつく外れ | | M2 `is_open` が常に真 | 5 本 | 1 回目は **4 本** — `fresh` のテストが緑だった(保存先だけを見ていて、開いている会話のメモリへ漏れた `fresh` の発話を見ていなかった)。`message_log` と `MessageSent` の検査を足して再走し **5 本** | | M3 プロンプトが保存先を読まない | 1 本 | 1 本 | | M4 処理中の会話を消せる | 3 本(結合 1・単体 2) | 3 本 | | M5 `fresh` が開いている会話を使う | 1 本 | 1 本 | | M6 切り替えで印を全部外す | 1 本 | 1 本 | **復元の確かめで 1 度読み違えた。** 変異の実行中に行数を数えて「`mod.rs` が 1 行減った」と疑ったが、数えたのは M1(1 行足す)が 当たっている最中だった。復元後の SHA が一致しなかったのは改行コードだけ(Write / Edit で書いたファイルは LF、復元は CRLF。Git は どちらも LF に正規化する)。**変異の実行中にファイルを数えない**。 ### 覆っていない項目(P4 か後続で見る) - **Spec の P1 テスト 9〜11 は結合テストにしていない** — 開いていない会話のターンが承認待ちで止まって印がその会話に付く(9)/ A で提示した計画を B で承認・破棄して A へ書く(10)/ 予定の後判定が別の会話のターンの終わりで発火しない(11)。配線はコードの読みと M6 で見たが、経路ごとの結合テストは無い - 下書き補助の使用量が始めた会話へ書かれること(読みだけ) - `cargo test` は GUI の crate(`fuseforks`)を除いて回した(clippy は通した) **踏んだ罠**: Bash のヒアドキュメントの中の `\\` がまた `\` に潰れた(Rust の文字列の行継続。2 回)。CLAUDE.md の処方どおり、 スクリプトは Write でファイルに書いてから実行した。 --- ## P2 実装記録(2026-11-12) **画面が会話 ID を読むようにした。** vitest 129 ファイル・1,100 本緑・vue-tsc 0・build 緑。コアは 1 行も変えていない。 **実機は未確認**(P4)。 ### 入れたもの(D ごと) | D | 実装 | |---|---| | D10 会話ペイン | `state.typingSession`(個体 → 根の会話)を `agentTyping` で立てて消す。入力中のバブル(`typingAgents`)は `isOpenSession(typingSession, currentSessionId)` で絞る。`state.typing` は個体の単位のまま(黒板と「全ターン停止」が読む)。ツール行(`toolRuns`)は開いている会話の `toolInvoked` だけ積み、カードの `lastTool` と周回数(`toolRound`)は個体の単位のまま | | D10 全ターン停止 | 押せるかを `typingAgents` から `busyAgents`(村全体の `state.typing`)へ変えた — バブルを会話で絞った数で決めると、別の会話のターンを止める手段が消える。副作用として、サーヴァントで絞り込んでいる間も他の個体が処理中なら押せる(押すと全員が止まるのは前から同じ) | | D10 知らせ | `sessionUpdated` の受け手 2 つ — 会話一覧の引き直しと、送り手がサーヴァントのときのトースト。トーストは `Toast.openSessionId` を持ち、通知の欄に「開く」が付く(`openNoticedSession`)。同じ会話への知らせは 1 枚にまとめ、2 件目からは件数と最後の送り手を出す(`lib/sessionScope.ts` の `answerNotice`)。届いた時点でその会話が開いていれば出さない。その会話が開かれたら(`sessionSwitched`)閉じる | | D5 承認画面 | `CommandPolicyView.stoppedElsewhere` を 1 行ずつ「別の会話({表題})で承認待ちで止まっています。その会話を開くと続けさせられます。」と「開く」で出す。**その行に「続けさせる」は置かない**。節と空状態の条件に `stoppedElsewhere` を対で足した。表題のために、印があるときだけ会話一覧を引く。`sessionSwitched` で承認画面の投影を取り直す(印は開いている会話で決まるため) | | D5 帯 | 変えていない — コアの `stoppedForApproval` が既に開いている会話の印だけなので、帯は他の会話の印を出さない | | D6 作業状況 | `PlanWaveRecord.sessionId`(`"-"` は `null`)を `planWaveStarted` / `planWaveProposed` から写す。全部の波を出したまま、開いている会話以外の波の見出しに「別の会話」、ツールチップに表題、確認待ちの編集パネルに「別の会話({表題})で提示された計画です。承認すると、その会話で配って束ねます。」。確認待ちのバッジは全部を数える(変えていない) | | D11 | 会話一覧の案内を「処理中でも開けます。答えは依頼した会話へ書かれます。消せるのは処理の残っていない会話だけです。」へ、「開く」の title から「拒否されます」を外した。辞書 3 言語の `errors.SESSION_SWITCH_BLOCKED` を外し `errors.SESSION_BUSY` を足した | 規則は `lib/sessionScope.ts` の純関数 3 本 — `isOpenSession`(`null` / 欠落 / `"-"` は開いている扱い = D13)/ `sessionOfLabel`(イベントの `"-"` を記録の `null` へ)/ `answerNotice`。 ### Spec の文面から実装で決めた形 - **知らせは自動で消さない**(情報通知の 4 秒の自動消去を使わない)。席を外している間に届いた答えを知らせる唯一の経路で、 消えると予定の結果がどの会話に書かれたかを人が探すことになる。会話ごとに 1 枚にまとめるので積み上がらない - **承認画面の別の会話の行に「開く」を足した**(D5 は 1 行の文だけ)。開くと印が開いている会話のものになり、同じ画面に 「続けさせる」が出る - 知らせの文言は D10 の「別の会話({タイトル})に {名前} の答えが届きました」に、まとめたときの 「別の会話({title})に答えが {count} 件届きました(最後は {name})」を足した ### テスト - **単体 `lib/sessionScope.test.ts` 4 本** - **投影 `composables/useOrchestrator.sessionScope.test.ts` 8 本** — `typing` は個体の単位で `typingSession` が立って消える / ツール行は開いている会話の分だけ・`lastTool` と `toolRound` は個体の単位 / 知らせは会話ごとに 1 枚で 2 件目は件数と 最後の送り手 / 利用者と System の書き込みでは知らせない / 届いた時点で開いていれば知らせない / 開かれたら閉じて承認画面を 取り直す / 「開く」は `resumeSession` を呼んで閉じる / 波は会話を持ち `"-"` は `null`・承認で会話が消えない - **走査 `lib/sessionScopeWiring.test.ts` 9 本** — コアの 6 イベントの `session_id` と `types.ts` の `sessionId` の突き合わせ / 部品が `isOpenSession` を読む / 全ターン停止が `busyAgents` / 知らせの呼び出しが送り手の判定の内側 / 承認画面の別の会話の 行に `resume(` が無い / 作業状況タブは波を会話で絞らない / 実行時に組む辞書の鍵が 3 言語に在り、撤去した鍵が無い - **既存の 4 ファイルを直した** — イベントの型に `sessionId` が要るようになり、`interrupt` / `commands` / `waves` のテストの イベントへ足した。`commands` の callId のテストは別の会話の ID で撃っていてツール行が積まれなくなった(正しい赤)ので、 開いている会話で撃つ形へ。`resumeGateWiring` は承認画面の条件の字面を 1 行で見ていたので、空白を畳んでから `stoppedElsewhere` を含む形で見る ### 変異(予測を先に書いた) | 変異 | 予測 | 結果 | |---|---|---| | F1 ツール行を会話で絞らない | 2 | 2 | | F2 入力中のバブルを会話で絞らない | 1 | 1 | | F3 誰の書き込みでも知らせる | 2 | **1** — 走査テストが緑だった。字面 `event.from.kind === "agent"` と `noticeAnswerElsewhere(` を**別々に**探しており、変異が両方の字面を残していた。判定の内側にあることを 1 つの字面で見る形へ強めて再走し **2** | | F4 知らせをまとめない | 1 | 1 | | F5 切り替えで承認画面を取り直さない | 2 | 2 | | F6 別の会話の行で続けさせる | 1 | 1 | | F7 保存先の無い村の印を別の会話と読む | 1 | 1 | 復元は SHA-1 で 7 回とも一致。承認画面は NUL を 3 つ含むので、置き換えも変異もバイト単位で行った。 ### 覆っていない項目(P4 で見る) - 実機の見た目(知らせの「開く」の位置・作業状況の「別の会話」が 104px の列に収まるか・承認画面の行) - 会話を開き直したとき、処理中のターンの入力中のバブルが戻ること(`typingSession` が残るので戻る見込み。単体では 開き直しの前後を通していない) **踏んだ罠**: Python の正規表現の置換文字列に `\"` を書き、テストのソースへバックスラッシュが入った(vue-tsc が 「Unterminated string literal」で捕まえた)。raw 文字列の置換では `\"` は 2 字のまま残る。 --- ## P3 台帳記録(2026-11-12) **直したのは DETAIL 3 言語と README 3 言語。** コードは変えていない。PRIVACY は改訂しない — 外へ送るものは 1 つも増えていない (会話の書き先が変わっただけで、送り先・送る中身・保存の場所は同じ)。 ### DETAIL(日本語。英語と中文も同じ箇所) | 箇所 | 前 | 後 | |---|---|---| | 新規チャット | 「処理中だった応答が直後に 1 件だけ載ることがあるのは仕様」 | **答えは依頼した会話へ書かれる**。別の会話に届いたら知らせと「開く」(自動では消えない・会話ごとに 1 枚)。バブルとツール行は開いている会話の分だけ。「全ターン停止」は村全体 | | 会話一覧 | 「開き直しと分岐は、飛行中のターンがあるとできない」 | 処理中でもできる。**消せないのは処理の残っている会話だけ**(開いているかを問わない。何が残っていると断られるかを列挙)。要約は押した時点の会話へ | | 計画の確認 | — | 配る先は計画を提示した会話。編集パネルに「別の会話(表題)で提示された計画です」 | | 作業状況タブ | — | 全部の波を出し、別の会話の波に「別の会話」 | | ツール行の中身 | — | 別の会話のターンのツール行は出ず、開き直しても戻らない | | 承認待ちの印 | 「アプリの再起動・会話の切り替え・停止で消える」 | 再起動と停止で消える。**印は止まった会話に付く**(保存先の無い村の新規チャットだけは消える)。別の会話の印は承認画面に 1 行と「開く」 | | 承認待ちの帯 | — | 止まった個体の帯は開いている会話の分だけ | | 予定の「新しい会話」 | 「村全体が新しい会話へ切り替わる」 | 予定ごとに新しい会話を作り、**画面は切り替わらない**。結果は知らせか会話一覧から。2 つの向きの段落の「新しい会話は履歴を捨てる(切り替える)」も「持ち込まない(前の会話はそのまま)」へ | | 未実装の表(会話の永続化の行) | — | 処理中でも切り替えられ、答えは依頼した会話へ書かれる | | ディレクトリ木 | — | コアの `orchestrator/session_ref.rs`、画面の `lib/sessionScope.ts` | **中文は抄訳なので箇所が少ない** — 新規チャットと会話一覧の段落が無いので、画面の構成表(右ペイン・会話一覧のモーダル・ 中央下段・命令批准のモーダル)と、Spec 72 の段落、未実装の表、ディレクトリ木に足した。 ### README(3 言語) 「会話の保存」の行に 1 文(処理中でも持ち替えられ、答えは依頼した会話へ書かれる・別の会話に届いたら「開く」つきの知らせ)。 **行は足していない**(170 / 170 / 168 行のまま)。 ### 追従の grep `SESSION_SWITCH_BLOCKED` / `ensure_idle_for_switch` / 「会話の切り替えで消え」/ `switching conversations, or` / 「切换会话・停止」を 台帳とコードで引いた。残っているのはすべて覆しの注記の下の当時の記録(`data_contract.yaml` の Spec 12・28 の節)と、撤去を述べる doc コメント・テストだけ。**ランディングページ**(別リポジトリの `docs/fuseforks.html`。grep 網の外)は会話について「いつでも開き直し・分岐できる」とだけ書いており、処理中の制限には触れていない(引いて確かめた)。**Qiita の記事は確かめていない**。 --- ## P4 実機記録(2026-11-12) 開発ビルド(`version: app=0.1.0 profile=debug`、13:42 起動)。**9 件すべてを `fuseforks.log` の行で観測した。** 操作は利用者、 判定はログ。会話の切り替えはログに行を出さないので、「開いていない会話へ書いた」ことは `session write:` の行の有無で読んだ (この行は書いた会話が開いていないときだけ出る)。 | 検収 | 決め手 | |---|---| | 1 | 15:57:56.176 `session write: kind=message session=…13b791da open=…f649efa0 from=agent`(答えの 4 ms 後)。**1 回目(13:44〜13:45)は答えの時点で元の会話を開いていて行が無く、知らせの経路を通っていなかったのでやり直した** | | 2 | 利用者の確認(元の会話を開くと依頼と答えが並ぶ) | | 3 | 16:04:36 元の会話のターンが `history_msgs=2/16`(前の 1 往復を持つ) | | 4 | 16:05:05 新規チャットのターンが `history_msgs=0/16` | | 5 | 16:18:16.725 `session write: … session=…30518a16 open=…cd00ebeb from=agent_3`(ジェミーの答えが元の会話へ)。ザリのまとめ(16:18:26)は `session=…30518a16` で `session write:` が無い = ジェミーの答えで出た知らせから元の会話を開いた後に届いた。**1 回目(16:06〜16:08)も答えの時点で元の会話を開いていたのでやり直した** | | 6 | 16:07:22 `session busy: session=…3f5fab3a refs=6`(ジェミーの処理中)。処理中に古い会話を開けたことは利用者の確認 | | 7 | 16:09:23 `stop=approval_pending session=…63634800` → 16:10:25 `resume after approval: agent=agent pending_left=0` → 続行のターンも `…63634800` で `history_msgs=2/16`。承認画面の「別の会話で止まっています」と「開く」、戻ると「続けさせる」が出たことは利用者の確認 | | 8 | この間の `turn:` 行 11 本(ザリ 9・ジェミー 2)がすべて依頼した会話の ID | | 9 | 16:13:11 予定の依頼が `session write: … session=…ed329c70 open=…63634800 from=system`、答えも同じ形で `from=agent`。画面は切り替わらず、知らせの「開く」で依頼と答えの並んだ会話が開いた(利用者の確認)。予定は 1 回発火した後に止めた(`enabled: false`) | ### 見えたこと - **知らせはまとめを待たずに、委譲先の答えで出る。** ジェミー → ザリの発話もサーヴァントの発話なので、その時点で 知らせが出る。開くとザリはまだ処理中で、まとめは 10 秒後にその会話へ届いた。D10 の規則どおりで、変えない - **やり直しが 2 回要った。** 検収 1 と 5 はどちらも、答えが届いたとき元の会話へ戻っていた — 画面では「答えが元の会話に ある」ので成功に見えるが、前の版でも同じ画面になる。**「別の会話にいる間に起きる」ことを見る検収は、知らせが出るまで その会話から動かない、を手順に書く**(`failures.md` #85 の家族 — 合格条件が前の版でも満たされる形) - **承認した直後の続行は `cached=0` で 68,492 トークンを書き直した。** `run` の説明文は許可したコマンドを並べるので、 承認で 1 行増えると道具の定義が変わり、キャッシュの先頭から外れる。Spec 75 の外(承認のたびにその個体のキャッシュが 1 回外れる) ### P4 の後に直したもの **会話を削除しても、その会話で止まった承認待ちの印が残っていた**(D5 の追補。P4 の前にコードの読みで見つけ、利用者裁定で P4 の後に直した)。印は処理ではないので削除は断られず、残った印は承認画面に消えた会話の「開く」を出し、続行を消えた会話へ 書かせる。 - コア: `delete_session` が参照の表の lock の下で削除に成功したら、その会話の印を個体を問わず外す (`Shared::clear_approval_stopped_in`。外した個体ごとに `ApprovalStopped { stopped: false }`)。続行は印の会話への参照を 取ってから印を確かめ直し、外れていれば開いている会話へ届ける(印を読んだ後・参照を取る前に消された場合) - 画面: 会話を消したら、その会話を指す知らせを閉じる(残すと「開く」が消えた会話を開きに行く) - 同時に `sessions.rs` の doc 2 か所を回収 — `reset_conversation` の「白紙化の直後に飛行中だった発話 1 件が載るのは仕様」と `create_session` の「既存の会話を開く resume / fork は拒む」が、P1 から嘘のまま残っていた(P3 の追従の grep は台帳と識別子を 引いたが、doc の文面は引いていなかった) - テスト: 結合 `deleting_the_stopped_conversation_clears_its_mark`(削除が通る / 外れるのはその会話の印だけ / 承認画面の `stoppedElsewhere` が空 / 続行は開いている会話に記録される)+ 走査 1 本(`deleteSession` の成功の枝で知らせを閉じる) - 変異: 印を外す 1 行を消す → 結合の新しい 1 本だけ赤 / 知らせを閉じる行を消す → 走査の新しい 1 本だけ赤。 **走査のほうは 1 回目、行をコメントにする変異で緑のまま残った** — コメントにも同じ字面が残るため。照合の前に行コメントを 落とす形へ直し、コメントにする変異でも赤になることを確かめた - コア(`fuseforks-core`)76 バイナリ・1,402 本緑・clippy 0 / vitest 1,101 本緑・vue-tsc 0。GUI の crate は回していない - 実機では踏んでいない(止まった会話を消す操作は P4 の 9 件に無い) ### タグの後に見つけた取り残し **予定の「発火のたびに新しい会話を始める」の説明文(`schedule.freshHint`)が、3 言語とも「村全体が新しい会話へ切り替わります」の ままだった。** D14 で覆した挙動を画面が説明していた。P2 は予定の画面を触っておらず、P3 の追従の grep は台帳(DETAIL / README)と 識別子を引いたが、辞書の文面を引いていなかった。v0.7.0 のリリースノートを書くために辞書から文言を拾っていて気づき、 公開前だったのでタグを直したコミットへ付け直した(v0.3.2 と同じ扱い)。**覆した挙動の名前(ここでは「新しい会話」)で、 台帳だけでなく辞書 3 言語も引く。**