ticket: split plugin runtime redesign

2026-06-25 04:56:03 +09:00
parent 79df31ccf6
commit 577bf75051
27 changed files with 543 additions and 17 deletions
@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "relations": [
+    {
+      "ticket_id": "00001KVXK0WDQ",
+      "kind": "depends_on",
+      "target": "00001KVXK0WDH",
+      "note": "Service runtime should build on Component Model-only plugin runtime authority.",
+      "author": "yoi ticket",
+      "at": "2026-06-24T19:55:30Z"
+    }
+  ]
+}
@@ -0,0 +1,44 @@
+---
+title: 'Define Plugin Service lifecycle and ingress queue runtime'
+state: 'ready'
+created_at: '2026-06-24T19:51:56Z'
+updated_at: '2026-06-24T19:55:30Z'
+assignee: null
+---
+
+## 背景
+
+Current Plugin instance support exposes `start` / `handle-ingress` / `status` / `stop`, but the execution model is still effectively synchronous function invocation. Service Plugins need a host-managed lifecycle and event queue so `start()` can return promptly, while external events are later delivered to `handle-ingress` without requiring a Plugin-owned polling loop.
+
+This Ticket implements the first service runtime slice: lifecycle state, ingress queue, serial dispatch, backpressure, timeout, and failure semantics. WebSocket-specific event sources and output commands are handled by later Tickets.
+
+## 要件
+
+- Service Plugin lifecycle を host-managed state として扱う。
+  - ready / starting / running / stopping / stopped / failed 相当。
+- `start()` は initialization only とし、long-running loop / polling loop / recv loop を担わない。
+- Service Plugin ごとに bounded ingress queue を持つ。
+- Ingress event は source / ingress name / payload / created_at / attempt / correlation id を持つ。
+- v0 dispatch は per-plugin serial dispatch とする。
+- dispatch timeout、Plugin failure、queue full、invalid event、stop 中 event の扱いを typed にする。
+- queue / lifecycle / failure state は status diagnostics として取得できる。
+- Existing Tool Plugin execution は service queue に巻き込まず、request-response operation として維持する。
+
+## Non-goals
+
+- WebSocket connection driver の実装。
+- Plugin output command model の本実装。
+- Discord / Slack など特定 integration。
+- Concurrent per-plugin event execution。
+- Durable cross-process event queue。
+
+## 受け入れ条件
+
+- Service Plugin instance が host-managed lifecycle state を持つ。
+- `start()` が返った後でも ingress event を queue 経由で配送できる。
+- Queue は bounded で、full / timeout / failed service が typed error / diagnostic として扱われる。
+- 同一 Plugin instance への ingress dispatch は serial に処理される。
+- `status()` または host diagnostics から lifecycle state / queue depth / last error / dispatch counters を確認できる。
+- Service lifecycle / ingress queue の unit tests が追加されている。
+- Tool Plugin execution tests が regress しない。
+- `cargo test -p pod`、`cargo check -p yoi`、`git diff --check`、`nix build .#yoi --no-link` が通る。
@@ -0,0 +1,24 @@
+<!-- event: create author: "yoi ticket" at: 2026-06-24T19:51:56Z -->
+
+## 作成
+
+LocalTicketBackend によって作成されました。
+
+---
+
+<!-- event: intake_summary author: hare at: 2026-06-24T19:55:29Z -->
+
+## Intake summary
+
+Marked ready by `yoi ticket state`.
+
+---
+
+<!-- event: state_changed author: "yoi ticket" at: 2026-06-24T19:55:29Z from: planning to: ready reason: cli_state field: state -->
+
+## State changed
+
+Marked ready by `yoi ticket state`.
+
+
+---