## 作成 LocalTicketBackend によって作成されました。 --- ## Intake summary Marked ready by `yoi ticket state`. --- ## State changed Marked ready by `yoi ticket state`. --- ## State changed Ticket を `workspace-panel` が queued にしました。 --- ## Decision Routing decision: implementation_ready Reason: - ユーザーから「続けて」と明示 follow-up があり、queued dependency chain の最終 Ticket として再確認した。 - `00001KVXK0WEA` は WIT / PDK / templates / docs を、既に実装済みの Component Model-only runtime、Service lifecycle / ingress queue、Service output commands、host-owned WebSocket driver に合わせる finishing slice である。 - outgoing `depends_on` は `00001KVXK0WE4` だが、`00001KVXK0WE4` は done / merged / reviewed / validated 済み。`TicketShow` derived blockers は空で、implementation acceptance blocker は残っていない。 - bounded context check で `resources/plugin/wit/*`, `crates/plugin-pdk`, `resources/plugin/templates/rust-component-tool`, `crates/yoi/src/plugin_cli.rs`, `docs/development/plugin-development.md` 周辺に authoring-facing surfaces があることを確認した。Ticket は runtime 実装ではなく authoring surface alignment に限定されており、残る不確実性は local implementation / fixture update に閉じる。 Evidence checked: - Ticket body / thread: `item.md`, `thread.md`。未解決 planning question は記録されていない。 - Relations / orchestration plan: outgoing depends_on `00001KVXK0WE4` は done。routing 前 plan は historical blocked_by `00001KVXK0WE4` のみで、prerequisite 完了により解消済み。accepted plan `orch-plan-20260625-070739-2` を記録済み。 - Related Tickets: `00001KVXK0WD3`, `00001KVXK0WDH`, `00001KVXK0WDQ`, `00001KVXK0WDX`, `00001KVXK0WE4` are done. - Code/docs context: `resources/plugin/wit/*.wit`, `crates/plugin-pdk`, `resources/plugin/templates/rust-component-tool`, `crates/yoi/src/plugin_cli.rs`, `docs/development/plugin-development.md`。 - Workspace state: `/home/hare/Projects/yoi/.worktree/orchestration` は clean。inprogress Ticket は 0 件。 IntentPacket: Intent: - Plugin authoring surface (WIT, Rust PDK, embedded templates, docs, `yoi plugin new/check/pack` fixtures) を、Component Model-only runtime と Service ingress event / output command / host-owned WebSocket model に合わせて更新する。 Binding decisions / invariants: - `plugin.toml` template は `wasm-component` runtime のみを生成する。 - Service/WebSocket authoring pattern は polling `recv(timeout)` loop ではなく、ingress event handler + output command (`websocket_send`) を正とする。 - Tool Plugin authoring support must continue to work. - Runtime implementation from previous Tickets is not redesigned here; this Ticket updates WIT/PDK/templates/docs/tests to match it. - No raw core-Wasm compatibility template or legacy runtime alias is introduced. - No protocol-specific Discord/Slack integration, secret store/auth injection, or full reconnect policy is implemented. Requirements / acceptance criteria: - WIT expresses Service ingress event payloads and output command model enough for authoring/tests. - `yoi-plugin-pdk` exposes ergonomic Tool and Service/Ingress helpers aligned with runtime JSON envelopes. - Embedded templates include current Tool template and a service-oriented template or equivalent examples using ingress event / output command pattern. - `yoi plugin new` / `check` / `pack` are consistent with new templates/schema. - Docs no longer recommend long-running `recv(timeout)` loop for Service WebSocket integration. - Tests cover PDK helpers, template generation/check/pack, and docs/manifest fixture consistency. Implementation latitude: - Exact WIT/interface names and Rust PDK helper APIs may follow existing PDK style, as long as runtime envelopes and docs are consistent. - If a full new `plugin new` template name is too large, coder may add minimal service template/example plus CLI support needed to satisfy acceptance, but must keep scope bounded. - Template wasm build/check may use existing test helpers and temporary target dirs. Escalate if: - WIT/PDK update requires changing runtime JSON envelope semantics from previous Tickets. - `yoi plugin new/check/pack` requires broad CLI redesign. - Real WebSocket network/protocol integration or secret handling is needed. - Legacy raw-WASM compatibility has to be restored for templates/tests. Validation: - `cargo test -p yoi-plugin-pdk` - `cargo test -p yoi plugin` or focused plugin CLI/template tests - `cargo check -p yoi` - `git diff --check` - `nix build .#yoi --no-link` - Template cargo-check if applicable, with cleanup of generated template artifacts. Current code/docs map: - Primary: `resources/plugin/wit/*.wit`, `crates/plugin-pdk`, `resources/plugin/templates/rust-component-tool`, possible new template under `resources/plugin/templates/`, `crates/yoi/src/plugin_cli.rs`, `docs/development/plugin-development.md`。 - Secondary: manifest tests/fixtures only as needed. - Avoid: Pod runtime reimplementation, WebSocket driver changes unless minor doc/test alignment, protocol-specific integrations, secret store/auth injection, raw-WASM compatibility。 Critical risks / reviewer focus: - PDK/template API drift from runtime JSON envelopes。 - Tool template regression while adding Service support。 - reintroducing `recv(timeout)` as recommended Service pattern。 - template generation/check/pack writing outside destination or leaving build artifacts。 - accidental legacy raw-WASM runtime compatibility in examples。 Next action: - `queued -> inprogress` を記録してから worktree-workflow で `/home/hare/Projects/yoi/.worktree/00001KVXK0WEA-plugin-pdk-service-events` を作成し、multi-agent-workflow で Coder/Reviewer sibling loop に進める。 --- ## State changed Orchestrator acceptance: queued -> inprogress - 直前確認で `TicketShow` は state `queued`、derived blockers は空。 - outgoing dependency `00001KVXK0WE4` は done / merged / reviewed / validated 済み。 - accepted plan `orch-plan-20260625-070739-2` を確認した。 - routing decision と IntentPacket は Ticket thread に記録済み。 - これ以降に worktree-workflow で `/home/hare/Projects/yoi/.worktree/00001KVXK0WEA-plugin-pdk-service-events` を作成し、multi-agent-workflow に接続する。 --- ## Implementation report Implementation orchestration update: - prerequisite `00001KVXK0WE4` が done になったため、`00001KVXK0WEA` を再 routing して受理した。 - worktree-workflow に従い、implementation worktree `/home/hare/Projects/yoi/.worktree/00001KVXK0WEA-plugin-pdk-service-events` と branch `work/00001KVXK0WEA-plugin-pdk-service-events` を作成した。 - child worktree では tracked `.yoi` project records を見える状態にし、`.yoi/memory`、local/runtime/log/lock/secret-like `.yoi` paths を sparse-checkout で除外する方針にした。 - Coder Pod `yoi-coder-00001KVXK0WEA-pdk-service-events` を sibling として起動した。write scope は child worktree に限定し、runtime workspace root `/home/hare/Projects/yoi` は startup 要件を満たすため non-recursive read のみにした。 - Coder には root/original workspace と orchestration worktree で read/write/validation/git operation を行わないよう明示した。 --- ## Implementation report Implementation report: 対象 Ticket: - `00001KVXK0WEA` — Update Plugin WIT PDK templates for service event runtime 実装概要: - Plugin authoring surface を Component Model-only / Service ingress event / output command model に合わせて更新した。 変更ファイル: - `resources/plugin/wit/yoi-plugin-instance-v1.wit` - Service ingress event JSON と `output_commands` / `websocket_send` の authoring 向け説明を追加。 - `resources/plugin/wit/yoi-plugin-tool-v1.wit` - current runtime 前提の説明に整理。 - `crates/plugin-pdk/src/lib.rs` - `PluginIngressEvent` に `ingress_name`, `created_at`, `attempt`, `correlation_id` を追加。 - `ServiceOutput`, `ServiceOutputCommand`, `ServiceOutputCommandKind` を追加。 - `PluginIngressEvent::websocket_text()`, `websocket_send()`, `ServiceOutput::websocket_send()` を追加。 - `Plugin::handle_ingress` の戻り値を `ServiceOutput` に変更。 - `crates/plugin-pdk/tests/template.rs` - PDK helper / WIT / template consistency tests を追加・更新。 - `resources/plugin/templates/rust-component-instance/*` - Service-oriented template に更新。 - guest-side `recv(timeout)` loop ではなく、`handle_ingress` で ingress event を受け、`ServiceOutput::websocket_send` で output command を返す構成に変更。 - `plugin.toml` は `runtime.kind = "wasm-component"` のみ。 - Tool handler も残し、Tool Plugin authoring support を維持。 - `crates/yoi/src/plugin_cli.rs`, `crates/yoi/src/main.rs` - `yoi plugin new rust-component-service ` を追加。 - service template の `new` / `check` / `pack` consistency を unit test で確認。 - CLI usage を更新。 - `docs/development/plugin-development.md` - Service/Ingress は host-owned ingress event + output command model として記述。 - Service WebSocket integration で long-running guest `recv(timeout)` loop を推奨しない内容に更新。 Validation: - `cargo test -p yoi-plugin-pdk`: success - `cargo test -p yoi plugin`: success - `cargo check -p yoi`: success - `git diff --check`: success - `nix build .#yoi --no-link`: success (`nix-exit:0`) - Template cargo-check: success - `cargo test -p yoi-plugin-pdk` 内で `rust-component-tool` / `rust-component-instance` の `cargo check --target wasm32-unknown-unknown --offline --target-dir ` を実行し、temporary target dir を使用。 Commit: - `7a4fd975268b655dca2f0861b8f2bd767c1e914f feat: update plugin service authoring templates` Residual risks / notes: - Runtime envelope の再設計は行っていない。 - protocol-specific integration / secret injection / reconnect policy / runtime reimplementation は範囲外として未実装。 --- ## Review: request changes Review result: request_changes 実装は概ね Ticket の方向に沿っているが、Service WebSocket template の manifest が runtime の authority boundary と不整合で、生成テンプレートの中心例が実行時に `websocket_send` できない状態に見える。 Blocker: - Service template が `websocket_send` に必要な manifest 権限/target を宣言していない。 - `resources/plugin/templates/rust-component-instance/src/lib.rs` は `ServiceOutput::websocket_send(...)` を返す Service/WebSocket 例になっている。 - `resources/plugin/templates/rust-component-instance/plugin.toml` は `surface/tool/service/ingress` と `tool/service/ingress` permission はあるが、`{ kind = "host_api", api = "websocket" }` がない。 - 同 `plugin.toml` には matching `[[websocket]]` target declaration もない。 - runtime 側の `websocket_send` 処理は manifest permissions の `host_api.websocket`、grants permissions の `host_api.websocket`、manifest の `[[websocket]]` target declaration、enablement 側の usable websocket grant を要求する。 - そのため生成された service template は `yoi plugin check/pack` は通っても、実行時に `requested host_api.websocket permission is missing` / `manifest host_api.websocket target declaration is missing` 系で拒否されるはず。 Required fixes: - `resources/plugin/templates/rust-component-instance/plugin.toml` に少なくとも以下を追加する。 - `permissions` の `{ kind = "host_api", api = "websocket" }` - `[[websocket]]` target declaration（例: `scheme = "wss"`, `host = "example.com"`, `path_prefixes = ["/socket"]`） - template/CLI tests に、service template が `host_api.websocket` permission と matching `[[websocket]]` declaration を含むことの assertion を追加する。 - 必要なら README/docs で、enablement grants も同じ WebSocket target を明示的に許可する必要があることを補足する。 Good points: - WIT は `handle-ingress`、ingress event envelope、`output_commands` / `websocket_send` 例を記述している。 - PDK は `PluginIngressEvent`、`ServiceOutput`、`ServiceOutputCommand`、`websocket_text()` / `websocket_send()` helper を追加し、runtime envelope 形状に概ね合っている。 - Service template は `recv(timeout)` polling loop を推奨しておらず、`handle_ingress` + `ServiceOutput::websocket_send` の形になっている。 - template `runtime.kind` は `wasm-component` で、raw `wasm` template 復活は見当たらない。 - `yoi plugin new rust-component-service` は既存の path-safety 方針上に追加されており、広い CLI redesign や runtime reimplementation は見当たらない。 Validation: - reviewer は read-only 指示のため cargo/nix/git diff validation は再実行していない。 - Ticket item/thread、IntentPacket、`cd200630..HEAD` の変更、WIT / PDK / template / CLI / docs / runtime envelope 関連箇所を静的確認した。 --- ## Implementation report Follow-up implementation report after review request_changes: 対応内容: - Reviewer blocker に対応し、Service template の `websocket_send` output command に必要な runtime authority を追加した。 変更点: - `resources/plugin/templates/rust-component-instance/plugin.toml` - `permissions` に `{ kind = "host_api", api = "websocket" }` を追加。 - matching target として `[[websocket]]` を追加。 - `scheme = "wss"` - `host = "example.com"` - `path_prefixes = ["/socket"]` - `crates/plugin-pdk/tests/template.rs` - service template manifest に `host_api.websocket` permission が含まれることを検証。 - `[[websocket]]` target が `wss://example.com/socket` に対応していることを検証。 - `crates/yoi/src/plugin_cli.rs` - `yoi plugin new rust-component-service ...` で生成される manifest に `host_api.websocket` permission / `[[websocket]]` declaration が含まれることを CLI test に追加。 - `resources/plugin/templates/rust-component-instance/README.md` - manifest 側の `host_api.websocket` / `[[websocket]]` declaration と、enablement grants 側でも同じ WebSocket target を明示許可する必要があることを追記。 - `docs/development/plugin-development.md` - Service ingress / output command の minimal manifest example に `host_api.websocket` permission と `[[websocket]]` target を追加。 - `websocket_send` output command には manifest declaration だけでなく runtime enablement grants も必要であることを明記。 Validation: - `cargo test -p yoi-plugin-pdk`: success - `cargo test -p yoi plugin`: success - `cargo check -p yoi`: success - `git diff --check`: success - `nix build .#yoi --no-link`: success (`nix-exit:0`) Commit: - `6c8998878dc1d59ad70da3280efd503a9a060ebb fix: declare plugin service websocket authority` Residual risks / notes: - なし。runtime envelope の再設計、raw wasm compatibility、protocol-specific integration、secret/reconnect policy、runtime reimplementation は行っていない。 --- ## Review: approve Review result: approve 前回 blocker は解消されている。 確認した証拠: - `resources/plugin/templates/rust-component-instance/plugin.toml` - `permissions` に `{ kind = "host_api", api = "websocket" }` が追加済み。 - `[[websocket]]` target が追加済みで、`wss://example.com/socket` と一致する `scheme = "wss"`, `host = "example.com"`, `path_prefixes = ["/socket"]` を宣言している。 - `runtime.kind = "wasm-component"` のままで、raw `wasm` 互換は導入されていない。 - Service template README: - `websocket_send` には manifest の `host_api.websocket` と matching `[[websocket]]` target が必要で、enablement grants も同じ target を許可する必要がある、と明記済み。 - Development docs: - Service ingress/output command 節で `websocket_send` に必要な `host_api.websocket` permission / `[[websocket]]` target / enablement grant 境界を説明している。 - polling `recv(timeout)` loop ではなく ingress event / output command pattern を推奨する説明を維持している。 - Tests: - PDK template test が service template manifest の websocket permission と matching target を assert するよう更新されている。 - CLI `plugin new rust-component-service` test も生成 manifest に websocket permission / `[[websocket]]` / host / path_prefix が含まれることを assert している。 リスク確認: - 前回懸念した「template は `ServiceOutput::websocket_send` を返すのに manifest authority が足りない」不整合は修正済み。 - 今回差分は template/docs/tests の authority declaration 補正に閉じており、runtime redesign、protocol-specific integration、secret injection、raw-WASM compatibility の追加は見当たらない。 検証: - reviewer は read-only 指定のため `cargo` / `nix` / `git diff --check` は再実行していない。 - `7a4fd975..HEAD` と fix commit `6c899887` の静的レビューのみ実施。 --- ## Implementation report Integration outcome: - Coder `yoi-coder-00001KVXK0WEA-pdk-service-events` が implementation branch `work/00001KVXK0WEA-plugin-pdk-service-events` に実装と review fix を commit した。 - implementation commit: `7a4fd975 feat: update plugin service authoring templates` - fix commit: `6c899887 fix: declare plugin service websocket authority` - Reviewer `yoi-reviewer-00001KVXK0WEA-pdk-service-events` は初回 review で request_changes。Service template が `ServiceOutput::websocket_send` を返す一方で `host_api.websocket` permission と matching `[[websocket]]` target declaration を持たない点を blocker とした。 - Coder は service template manifest / tests / docs を修正し、follow-up review は `approve`。template authority declaration、enablement grants guidance、runtime envelope alignment、raw-WASM compatibility 非復活を確認した。 - Orchestrator worktree `/home/hare/Projects/yoi/.worktree/orchestration` で branch `work/00001KVXK0WEA-plugin-pdk-service-events` を merge 済み。 - merge commit: `8d4fee23 merge: 00001KVXK0WEA plugin pdk service events` Implemented behavior: - WIT docs/descriptionsを Service ingress event JSON と `output_commands` / `websocket_send` authoring に合わせて更新。 - `crates/plugin-pdk` に `PluginIngressEvent` 拡張、`ServiceOutput` / `ServiceOutputCommand` / `ServiceOutputCommandKind`、`websocket_text` / `websocket_send` helpers を追加。 - `Plugin::handle_ingress` returns `ServiceOutput`。 - `resources/plugin/templates/rust-component-instance` を service-oriented template に更新し、`handle_ingress` + `ServiceOutput::websocket_send` pattern を示す。 - service template `plugin.toml` は `runtime.kind = "wasm-component"`、`host_api.websocket` permission、matching `[[websocket]]` target を含む。 - `yoi plugin new rust-component-service ` を追加し、new/check/pack consistency tests を更新。 - docs は long-running guest `recv(timeout)` loop ではなく host-owned ingress event + output command model を推奨し、enablement grants でも matching websocket target が必要と明記。 Validation in Orchestrator worktree: - `cargo test -p yoi-plugin-pdk`: success - `cargo test -p yoi plugin`: success - `cargo check -p yoi`: success - `git diff --check`: success - `nix build .#yoi --no-link`: success - Template cargo-check is covered by `cargo test -p yoi-plugin-pdk` using temporary target dirs. Notes: - This Ticket completes the queued Plugin runtime redesign chain slices that were split from the original broad redesign request. - No runtime envelope redesign, protocol-specific integration, secret injection, reconnect policy, runtime reimplementation, or raw-WASM compatibility was introduced. Next action: - Mark Ticket done after this integration/validation evidence. - Then stop related child Pods and remove only the child implementation worktree/branch. --- ## State changed Implementation is merged into the orchestration branch and validated. Evidence: - merge commit: `8d4fee23 merge: 00001KVXK0WEA plugin pdk service events` - reviewer result: approve after requested changes were fixed - validation in `/home/hare/Projects/yoi/.worktree/orchestration` succeeded: - `cargo test -p yoi-plugin-pdk` - `cargo test -p yoi plugin` - `cargo check -p yoi` - `git diff --check` - `nix build .#yoi --no-link` Closure is not performed here; this state records implementation completion after merge/validation. --- ## State changed Ticket を closed にしました。 --- ## 完了 Implemented, reviewed, marked done, and merged into develop. ---