ticket: split worker runtime implementation

2026-06-26 00:12:00 +09:00
parent d93dbc0533
commit befbabe13a
19 changed files with 420 additions and 119 deletions
@@ -0,0 +1,53 @@
+---
+title: 'worker-runtimeにFS永続化featureを追加する'
+state: 'planning'
+created_at: '2026-06-25T14:44:02Z'
+updated_at: '2026-06-25T14:47:43Z'
+assignee: null
+---
+
+## 背景
+
+`worker-runtime` core は embedded use のため memory store を持つが、独立 Runtime process では process restart に耐える local persistence が必要になる。Backend は SQLite control plane / projection を持つが、remote Runtime process が Backend SQLite を直接 authority とする設計にはしない。Runtime execution store は Runtime 側の local filesystem に置くのが v0 では最も単純で、既存 `pod-store` / session jsonl / runtime dir の知見も活用できる。
+
+この Ticket では `worker-runtime` の `fs-store` feature と filesystem persistence backend を実装する。HTTP server / event stream server は別 Ticket とする。
+
+## 要件
+
+- `worker-runtime` に `fs-store` feature を追加する。
+- Feature disabled 時、core library は FS store dependency を強制しない。
+- `FsRuntimeStore` 相当を追加し、Runtime の store backend として選択できる。
+- Filesystem layout は Runtime scoped / Worker scoped にする。
+  - runtime record / config snapshot。
+  - worker record。
+  - worker state。
+  - event log JSONL。
+  - transcript projection JSONL。
+  - overview / usage projection。
+- Store は `runtime_id + worker_id` を authority とし、`pod_name` / socket path / legacy session path を authority にしない。
+- Atomic write / directory creation / corrupt record diagnostics / bounded read を扱う。
+- 旧 `pod-store` の metadata JSON / active segment pointer / atomic write pattern は参考にするが、standalone `worker-store` crate は作らない。
+- Memory store tests と FS store tests の両方が通る。
+
+## Non-goals
+
+- REST command server。
+- SSE / WebSocket event stream server。
+- Backend RuntimeRegistry integration。
+- Full legacy Pod session migration。
+- SQLite Runtime store。
+- Standalone `worker-store` crate。
+
+## 受け入れ条件
+
+- `worker-runtime` に optional `fs-store` feature がある。
+- `fs-store` disabled でも `worker-runtime` core が compile できる。
+- `FsRuntimeStore` が Runtime の persistence backend として使える。
+- Worker create / state update / event append / transcript append / bounded read が FS store で動く。
+- FS layout が Runtime/Worker scoped であり、legacy Pod path を public authority にしていない。
+- Corrupt/missing files are surfaced as typed diagnostics/errors.
+- `cargo test -p worker-runtime --no-default-features` が通る。
+- `cargo test -p worker-runtime --features fs-store` が通る。
+- `cargo check -p yoi` が通る。
+- `git diff --check` が通る。
+- `nix build .#yoi --no-link` が通る。