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,13 @@
+{
+  "version": 1,
+  "relations": [
+    {
+      "ticket_id": "00001KVZSGT0Q",
+      "kind": "depends_on",
+      "target": "00001KVZKSV6C",
+      "note": "Embedded Runtime connection builds on the Backend RuntimeRegistry foundation.",
+      "author": "yoi ticket",
+      "at": "2026-06-25T16:30:00Z"
+    }
+  ]
+}
@@ -0,0 +1,65 @@
+---
+title: 'Backend RuntimeRegistryにembedded worker-runtimeを接続する'
+state: 'ready'
+created_at: '2026-06-25T16:23:58Z'
+updated_at: '2026-06-25T16:30:31Z'
+assignee: null
+---
+
+## 背景
+
+`worker-runtime` core crate と Backend `RuntimeRegistry` 基盤ができたら、Workspace Backend process 内に embedded `worker_runtime::Runtime` を組み込み、`backend-internal` Runtime として Registry から扱えるようにしたい。これは Backend internal Companion Web Console の前提であり、remote Runtime process / HTTP client / FS store / event stream server を待たずに進められる。
+
+この Ticket では embedded Runtime handle を Backend Registry に接続する。Runtime は memory store / builtin/default Profile fallback / toolsなし Worker でよい。
+
+## 要件
+
+### Embedded Runtime registration
+
+- Workspace Backend が `worker_runtime::Runtime` を process 内に生成・保持できる。
+- Embedded Runtime を `backend-internal` 相当の runtime id / display name / capabilities で RuntimeRegistry に登録できる。
+- Registry から embedded Runtime の runtime summary / status / capabilities を取得できる。
+- Embedded Runtime は HTTP endpoint / token / socket path を持たない。
+
+### Worker operations
+
+- Backend Registry は embedded Runtime に対して direct lib call で以下を route できる。
+  - worker list / detail。
+  - create worker。
+  - send input。
+  - stop / cancel。
+  - bounded transcript projection。
+  - event cursor / subscription placeholder。
+- v0 は toolsなし Worker / builtin/default Profile fallback / memory store でよい。
+- Busy / unknown worker / runtime unavailable / unsupported operation を typed error に map する。
+
+### Backend API exposure
+
+- Browser-facing API は embedded Runtime を remote Runtime と同じ `runtime_id + worker_id` authority で扱う。
+- Browser は embedded Runtime internals / store path / provider credentials を知らない。
+- Existing `/api/workers` / runtime list に embedded Runtime Worker を含めるか、新 runtime-scoped endpoint に出すかを実装時に決め、方針を記録する。
+- Local compatibility source と embedded Runtime source を diagnostics / implementation kind で区別できる。
+
+## Non-goals
+
+- Remote Runtime process client。
+- FS store。
+- REST command server。
+- Event stream server。
+- Full Companion Web Console UI。
+- Profile/config bundle sync。
+- Local compatibility path の削除。
+
+## 受け入れ条件
+
+- Workspace Backend が embedded `worker_runtime::Runtime` を生成し、RuntimeRegistry に登録できる。
+- Backend API から `backend-internal` Runtime の summary/status/capabilities を確認できる。
+- Backend Registry が embedded Runtime の worker list/detail/create/send input/transcript projection を direct lib call で扱える。
+- v0 toolsなし Worker が create でき、input acceptance まで確認できる。
+- Browser-facing API に socket path / session path / runtime internal store path / provider credential が露出しない。
+- Local compatibility source と embedded Runtime source が混同されない。
+- Focused workspace-server tests cover embedded runtime registration and routing.
+- `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:31Z -->
+
+## Intake summary
+
+Marked ready by `yoi ticket state`.
+
+---
+
+<!-- event: state_changed author: "yoi ticket" at: 2026-06-25T16:30:31Z from: planning to: ready reason: cli_state field: state -->
+
+## State changed
+
+Marked ready by `yoi ticket state`.
+
+
+---