ticket: split backend runtime registry integration

2026-06-26 01:30:43 +09:00
parent 30363e5ed9
commit d6c240af35
12 changed files with 347 additions and 58 deletions
@@ -0,0 +1,45 @@
+{
+  "version": 1,
+  "relations": [
+    {
+      "ticket_id": "00001KVZSGT14",
+      "kind": "depends_on",
+      "target": "00001KVZKSV6C",
+      "note": "Remote Runtime connection builds on the Backend RuntimeRegistry foundation.",
+      "author": "yoi ticket",
+      "at": "2026-06-25T16:30:00Z"
+    },
+    {
+      "ticket_id": "00001KVZSGT14",
+      "kind": "depends_on",
+      "target": "00001KVZKST83",
+      "note": "Standalone remote Runtime should have FS persistence available before Backend integration.",
+      "author": "yoi ticket",
+      "at": "2026-06-25T16:30:00Z"
+    },
+    {
+      "ticket_id": "00001KVZSGT14",
+      "kind": "depends_on",
+      "target": "00001KVZKSTE2",
+      "note": "Remote Runtime routing needs the REST command API.",
+      "author": "yoi ticket",
+      "at": "2026-06-25T16:30:00Z"
+    },
+    {
+      "ticket_id": "00001KVZSGT14",
+      "kind": "depends_on",
+      "target": "00001KVZKSTJT",
+      "note": "Remote Runtime observation needs the Runtime event stream API.",
+      "author": "yoi ticket",
+      "at": "2026-06-25T16:30:00Z"
+    },
+    {
+      "ticket_id": "00001KVZSGT14",
+      "kind": "related",
+      "target": "00001KVZQHPNY",
+      "note": "Remote Runtime integration will eventually coordinate Profile/config bundle sync, but v0 can use builtin/default fallback where applicable.",
+      "author": "yoi ticket",
+      "at": "2026-06-25T16:30:00Z"
+    }
+  ]
+}
@@ -0,0 +1,71 @@
+---
+title: 'Backend RuntimeRegistryにremote worker-runtime processを接続する'
+state: 'ready'
+created_at: '2026-06-25T16:23:58Z'
+updated_at: '2026-06-25T16:30:32Z'
+assignee: null
+---
+
+## 背景
+
+Standalone `worker-runtime` process が FS store、REST command server、event stream server を持った後、Workspace Backend は remote Runtime process に client として接続できる必要がある。Browser は remote Runtime に直接接続せず、Backend が RuntimeRegistry / policy / visibility / audit / typed error mapping を挟んで proxy / projection する。
+
+この Ticket では Backend RuntimeRegistry に remote Runtime client handle を追加する。Embedded Runtime 接続とは別実装粒度とする。
+
+## 要件
+
+### Remote Runtime client
+
+- Backend は config-like data から remote Runtime client handle を作成できる。
+  - runtime id / display name。
+  - base URL。
+  - token / secret ref placeholder。
+  - capability cache / last seen status。
+- Remote command は `worker-runtime` REST command API に対する Backend-owned client で実行する。
+- Remote observation は Runtime event stream API に対する Backend-owned client で購読または proxy できる。
+- Backend は Runtime endpoint / credential を Browser に渡さない。
+
+### Registry routing
+
+- Backend RuntimeRegistry は remote Runtime handle へ以下を route できる。
+  - runtime summary / status / capabilities。
+  - worker list / detail。
+  - create worker。
+  - send input。
+  - stop / cancel。
+  - bounded transcript projection。
+  - event stream/proxy。
+- Embedded Runtime handle と remote Runtime handle は Browser-facing API から同じ `runtime_id + worker_id` authority で扱える。
+- Network failure / auth failure / timeout / remote unsupported / remote worker not found を typed error に map する。
+
+### Config / policy boundary
+
+- Backend がどの remote Runtime に接続してよいかを config / registry data で管理する。
+- Dynamic registration は不要。
+- Config bundle sync は関連するが、この Ticket では remote Runtime connection / routing を主目的とする。
+- Browser は remote Runtime base URL / token / direct endpoint authority を知らない。
+
+## Non-goals
+
+- `worker-runtime` core crate implementation。
+- FS store implementation。
+- REST command server implementation。
+- Event stream server implementation。
+- Embedded Runtime integration。
+- Dynamic Runtime registration。
+- Full auth / permission model。
+- Backend internal Companion Web Console completion。
+
+## 受け入れ条件
+
+- Workspace Backend が remote Runtime client handle を config-like data から登録できる。
+- Backend RuntimeRegistry が remote Runtime の list/detail/create/input/transcript/event operations を route できる。
+- Remote network/auth/timeout errors が typed Backend errors に map される。
+- Browser-facing API に remote Runtime base URL / credential / direct endpoint が露出しない。
+- Embedded Runtime handle と remote Runtime handle が同じ `runtime_id + worker_id` authority model で扱われる。
+- Event stream client/proxy path が Backend-owned connection として実装されている。
+- Focused workspace-server tests cover mocked remote Runtime routing and error mapping.
+- `cargo test -p yoi-workspace-server` が通る。
+- `cargo check -p yoi` が通る。
+- `git diff --check` が通る。
+- `nix build .#yoi --no-link` が通る。
@@ -0,0 +1,24 @@
+<!-- event: create author: "yoi ticket" at: 2026-06-25T16:23:58Z -->
+
+## 作成
+
+LocalTicketBackend によって作成されました。
+
+---
+
+<!-- event: intake_summary author: hare at: 2026-06-25T16:30:32Z -->
+
+## Intake summary
+
+Marked ready by `yoi ticket state`.
+
+---
+
+<!-- event: state_changed author: "yoi ticket" at: 2026-06-25T16:30:32Z from: planning to: ready reason: cli_state field: state -->
+
+## State changed
+
+Marked ready by `yoi ticket state`.
+
+
+---