Hare/yoi
1
1
Fork 0
Code Actions Packages Releases Activity
c7c838b4e5
yoi/.yoi/tickets/00001KWHHRTM9/thread.md

22 KiB
Raw Blame History

作成

LocalTicketBackend によって作成されました。

Plan

Workspace Backend Runtime connection management と永続 config の Ticket として詳細化した。

方針:

  • Runtime が Backend に接続するのではなく、Backend が Runtime source を RuntimeRegistry に登録する現行構造を前提にする。
  • embedded Runtime は built-in connection として表示し、config 管理対象や削除対象にしない。
  • remote Runtime connection は .yoi/workspace-backend.local.toml の [[runtimes.remote]] に保存する。
  • 管理 API は list/add/delete/test を提供する。
  • v0 は config persistence を優先し、config 更新後は restart_required = true とする。live register/unregister は対象外。
  • raw token 値、socket/session/store path、Runtime event cursor、live handle は UI/API/config に出さない。

Decision

Runtime connection management Ticket は Settings shell 先行 Ticket に依存する形へ整理した。

Decision:

  • 00001KWHJ0XH6 が Workspace-local Settings の entry point / route / shell / section navigation を用意する。
  • 00001KWHHRTM9 はその Settings shell 上に Runtime Connections section と Backend API / config persistence を追加する。
  • Runtime connection 管理 Ticket 内で Settings shell 設計を同時に進めない。

Decision

Runtime connection management に negotiation / compatibility check を含める方針へ更新した。

Decision:

  • 現状は明示的な negotiation / handshake は無く、GET /v1/runtime が事実上の疎通確認になっているだけ。
  • Runtime connection test は単なる ping ではなく lightweight negotiation / compatibility check として扱う。
  • v0 check は GET /v1/runtime の parse、observed runtime id/display/status/capabilities、worker list/detail、event websocket construction、spawn/input/config-bundle support などを確認する。
  • 現行 API に protocol version が無い場合は fake version を作らず、v1 runtime endpoint responded のような compatibility basis として表現する。
  • negotiation result / observed capabilities / health result / checked_at / diagnostics は persisted config に保存しない。必要になった場合は Backend DB の observation/cache として扱う。
  • persisted config、RuntimeRegistry live state、negotiation result を混同しない。

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:

  • Ticket は Runtime connection settings API / .yoi/workspace-backend.local.toml 永続化 / Settings UI / sanitized diagnostics / restart_required の v0 境界を具体化しており、observable な acceptance criteria と validation がある。
  • 先行 Settings shell Ticket 00001KWHJ0XH6 は closed を確認済み。
  • typed relation blocker は 0 件、OrchestrationPlan は human gate の waiting note のみで、ユーザーから「2つとも消化して」と明示 follow-up があったため human gate は解除された。
  • Manual Coding Worker Ticket 00001KWHEM8YJ と UI/API surface が近く、並列別 worktree では衝突リスクが高いので、同一 implementation worktree/branch で Runtime connection 管理を先に実装し、続けて manual Worker 作成導線を実装する。

Evidence checked:

  • Ticket body / thread / artifacts。
  • TicketRelationQuery(00001KWHHRTM9) は 0 件。
  • TicketOrchestrationPlanQuery(00001KWHHRTM9) は prior human-gate waiting note のみ。
  • TicketShow(00001KWHJ0XH6) は closed。
  • queued Ticket 一覧では 00001KWHEM8YJ も queued、ready/inprogress は 0 件。
  • workspace/orchestration git state と worktree 一覧、visible Pods、TicketDoctor（0 errors / 既存 warning のみ）。
  • Bounded code map: crates/workspace-server の workspace backend / runtime registry / config file 周辺、web/workspace/src/lib/workspace-settings/SettingsPage.svelte、web/workspace/src/routes/settings/+page.svelte、既存 /api/workers / /api/runtimes/{runtime_id}/workers projection、WorkersNavSection.svelte。

IntentPacket:

Intent:

  • Workspace Browser の Settings / Runtime Connections で embedded Runtime 表示、remote Runtime connection の list/add/delete/test negotiation、.yoi/workspace-backend.local.toml 永続化、restart_required diagnostic を提供する。
  • 00001KWHEM8YJ が使う Runtime candidate projection の基盤を作る。

Binding decisions / invariants:

  • Runtime が Backend に接続するのではなく、Backend が configured Runtime source を RuntimeRegistry に登録する現行構造を前提にする。
  • embedded Runtime は built-in として表示し、config 管理対象や削除対象にしない。
  • remote Runtime connection は既存 [[runtimes.remote]] schema に保存する。
  • v0 は config persistence 優先で、config 更新後は restart_required = true。live register/unregister は対象外。
  • raw token 値、secret、socket/session/store path、Runtime event cursor、live handle、config file path は UI/API response に出さない。
  • negotiation/test result、observed capabilities、health result、checked_at は local config に保存しない。
  • protocol version が無ければ fake version を作らず、compatibility basis として表現する。

Requirements / acceptance criteria:

  • Runtime Connections 管理画面が Settings shell 内にある。
  • embedded Runtime は built-in / delete不可として表示される。
  • remote connection を add/delete でき、config の [[runtimes.remote]] が read-modify-write される。
  • test negotiation は GET /v1/runtime parse と Browser 必要操作に対する compatibility/sanitized diagnostics を返す。
  • duplicate id / invalid endpoint / incompatible runtime / embedded delete attempt は typed diagnostic。
  • request/response/config に raw token 値や internal paths を含めない。
  • focused backend/UI tests を追加し、指定 validation を可能な範囲で実行する。

Implementation latitude:

  • TOML comments/format preservation は v0 で typed serialize により失われてもよい。ただし implementation report/docs/test で明記する。
  • POST 保存前に test を必須にするか、保存は許して test diagnostic を別扱いにするかは、Ticket の v0 境界内で選んでよい。
  • API response shape / Svelte component分割 / test helper構成は既存 style に合わせて選んでよい。

Escalate if:

  • secret store / raw token input / live RuntimeRegistry unregister / remote workspace provisioning / protocol version追加を必須にしないと満たせない場合。
  • existing config schema を壊す必要がある場合。
  • Browser-facing API に raw path/secret/runtime internal location を出す誘惑が出た場合。

Validation:

  • cd web/workspace && deno task test
  • cd web/workspace && deno task check
  • cargo test -p yoi-workspace-server
  • cargo check -p yoi
  • git diff --check
  • nix build .#yoi --no-link は時間/依存変更の重さを見て実行、未実行なら理由を report。

Current code map:

  • Settings UI: web/workspace/src/lib/workspace-settings/SettingsPage.svelte, web/workspace/src/routes/settings/+page.svelte。
  • Worker/sidebar UI: web/workspace/src/lib/workspace-sidebar/WorkersNavSection.svelte, console route under web/workspace/src/routes/runtimes/[runtimeId]/workers/[workerId]/console/。
  • Backend/runtime/config areas: crates/workspace-server, existing /api/workers, /api/runtimes/{runtime_id}/workers, WorkspaceBackendConfigFile, ServerConfig.remote_runtime_sources, RuntimeRegistry, EmbeddedWorkerRuntime。

Critical risks / reviewer focus:

  • persisted config、live registry state、test/negotiation observation を混同していないか。
  • Browser-facing API に secrets/internal paths/runtime store/socket/session/config file path が漏れていないか。
  • embedded delete が fail closed か。
  • restart_required semantics が UI/API で明確か。
  • 00001KWHEM8YJ と同一 worktreeで実装し、runtime candidates の shared contract が破綻していないか。

State changed

Queued acceptance recorded after explicit user follow-up 「2つとも消化して」。

Checked context:

  • Ticket body / thread / artifacts。
  • TicketRelationQuery(00001KWHHRTM9): blocking relation 0 件。
  • TicketOrchestrationPlanQuery(00001KWHHRTM9): prior human-gate waiting note を確認し、今回 accepted_plan / before ordering を記録済み。
  • 00001KWHJ0XH6 は closed。
  • workspace/worktree/visible Pod/TicketDoctor/code-map の bounded check。

Acceptance basis:

  • concrete missing decision / information は残っていない。
  • 00001KWHEM8YJ と surface が重なるため、同一 implementation worktree でこの Ticket を先に実装する。
  • side effect はこの queued -> inprogress acceptance 後に開始する。

Implementation report

Implementation side-effect recovery note:

  • queued -> inprogress acceptance 後、implementation worktree /home/hare/Projects/yoi/.worktree/00001KWHHRTM9-00001KWHEM8YJ / branch work/00001KWHHRTM9-00001KWHEM8YJ は作成済み。
  • 最初の Coder Pod spawn は、child workspace root /home/hare/Projects/yoi を readable scope に含めていなかったため workspace root is not readable under the configured scope で失敗した。
  • Ticket は inprogress のまま、read scope に workspace root、write scope に implementation worktree だけを含める形で即時 retry する。raw runtime/socket/session details は implementation contract には含めない。

Implementation report

Implementation routing update:

  • Recovery retry succeeded: sibling Coder Pod yoi-coder-00001KWHHRTM9-00001KWHEM8YJ was spawned for the combined branch/worktree.
  • Scope policy: workspace root is readable for runtime workspace metadata; write authority is restricted to implementation worktree /home/hare/Projects/yoi/.worktree/00001KWHHRTM9-00001KWHEM8YJ.
  • Work order remains: this Ticket first, then 00001KWHEM8YJ; external review will be requested after coder completion evidence is available.

Implementation report

Implementation progress report:

  • Coder Pod completed the combined implementation and committed f2fead7e feat: add workspace runtime and worker controls on branch work/00001KWHHRTM9-00001KWHEM8YJ.
  • Worktree status was clean after commit.
  • Changed areas include crates/workspace-server/src/config.rs, crates/workspace-server/src/hosts.rs, crates/workspace-server/src/server.rs, Settings UI/model/tests, Worker sidebar UI/types, and workspace TS config/CSS.
  • Orchestrator reran validation:
    • git diff --check: pass
    • cargo test -p yoi-workspace-server: pass（51 lib tests + 2 main tests）
    • cargo check -p yoi: pass
    • cd web/workspace && deno task test: pass（11 tests）
    • cd web/workspace && deno task check: pass（0 errors / 0 warnings）
  • nix build .#yoi --no-link は dependency/resource packaging 変更ではないため未実行。
  • External review requested via sibling Reviewer Pod yoi-reviewer-00001KWHHRTM9-00001KWHEM8YJ.

Review: request changes

External review result: request_changes

Checked evidence:

  • 両 Ticket record と最新 IntentPacket / orchestration-plan を確認。
  • f2fead7e の diff/stat/check evidence を確認（10 files changed、git diff --check f2fead7e^ f2fead7e clean）。
  • config.rs, hosts.rs, server.rs, settings UI/model/tests, sidebar worker form/types, CSS/tsconfig を focused static review。
  • Reviewer は read-only で、validation 再実行はせず Orchestrator reported validation pass を参照。

Blockers:

  1. Runtime connection test が recorded lightweight negotiation / compatibility contract を満たしていない。

    • Ticket は observed runtime capabilities の parse と Browser 必要 operation（list workers, observe detail, event websocket construction, spawn, input dispatch, config-bundle availability/sync）に対する compatibility check を要求している。
    • 現状 test_remote_runtime_config は /v1/runtime を呼び、狭い RuntimeHttpSummaryResponse を parse した後、operation compatibility check なしで常に state: "compatible", capabilities: Vec::new() を返す。
    • acceptance criterion の sanitized compatibility/capabilities/diagnostics response を満たしていない。

  2. Browser-facing diagnostic sanitization が endpoint/path leak invariant に対して不十分。

    • remote test failure path が sanitize_backend_error(&error.to_string()) を Browser response に入れている。
    • sanitizer は /home/, /Users/, \\, :\\ を含む message だけ置換するため、reqwest error の requested URL や non-home config/temp path が漏れる可能性がある。
    • Ticket は Runtime endpoint/config path/internal location を Browser-facing response に漏らさないことを要求しているため、raw backend error string ではなく fixed typed diagnostics にする必要がある。

  3. Manual Worker launch が rejected Runtime operation の typed unsupported diagnostics を落としている。

    • create_workspace_worker が non-Accepted WorkerOperationResult を generic workspace_worker_create_failed に変換し、result.diagnostics を破棄している。
    • unsupported remote/runtime cases は typed sanitized diagnostics を返す必要がある。

  4. key contracts の focused acceptance tests が不足。

    • backend は helper-level validation/sanitizer tests に寄っており、runtime connection list/add/delete/test negotiation、config persistence、restart_required、/api/workers POST success/unsupported diagnostics の route-level tests が足りない。
    • Web は settings model helper tests のみで、New Worker form rendering/submit-path test がない。

Non-blocking follow-ups:

  • manual Worker launch の display_name は optional と記録されているが backend/UI は non-empty を要求している。空なら default label derivation を検討。
  • Browser-facing request structs に deny_unknown_fields を付けると “only these fields” boundary が fail closed になる。
  • nix build .#yoi --no-link は dependency/resource packaging 変更ではないため未実行だが、acceptance evidence としては未検証。

Implementation report

Review-fix implementation report:

  • Coder Pod completed requested changes and committed follow-up 47ed0ff8 fix: harden runtime and worker launch controls on branch work/00001KWHHRTM9-00001KWHEM8YJ.
  • Worktree status was clean after commit.
  • Fix changed crates/workspace-server/src/server.rs, web/workspace/deno.json, WorkersNavSection.svelte, and added worker-launch.ts / worker-launch.test.ts.
  • Reported fixes include lightweight runtime compatibility probes, fixed sanitized remote-test diagnostics without endpoint/path leakage, preservation of typed unsupported worker-create diagnostics, deny_unknown_fields on Browser-facing request structs, empty display-name default derivation, backend route/acceptance tests, and web worker-launch model tests.
  • Orchestrator reran validation:
    • git diff --check: pass
    • cargo test -p yoi-workspace-server: pass（55 lib tests + 2 main tests）
    • cargo check -p yoi: pass
    • cd web/workspace && deno task test: pass（13 tests）
    • cd web/workspace && deno task check: pass（0 errors / 0 warnings）
  • nix build .#yoi --no-link は dependency/resource packaging 変更ではないため未実行。
  • Requesting follow-up external review against f2fead7e..47ed0ff8 and full combined implementation.

Review: approve

External follow-up review result: approve

Read-only follow-up review completed for both Tickets and fix commit 47ed0ff8 on top of f2fead7e.

Evidence reviewed:

  • Ticket records for 00001KWHHRTM9 and 00001KWHEM8YJ.
  • Fix diff f2fead7e..47ed0ff8.
  • Relevant backend/web files including crates/workspace-server/src/server.rs, config.rs, hosts.rs, worker-launch.ts, WorkersNavSection.svelte, related tests/settings model files.
  • Orchestrator-reported validation pass for git diff --check, cargo test -p yoi-workspace-server, cargo check -p yoi, cd web/workspace && deno task test, and cd web/workspace && deno task check.

Reviewer findings:

  • Previous blocker 1 resolved: runtime connection test now performs lightweight negotiation/probing for Browser-relevant operations and represents unsupported/not-observed operations with typed diagnostics and unknown/unsupported capability entries instead of blanket compatibility.
  • Previous blocker 2 resolved: Browser-facing remote-test diagnostics omit raw endpoints/config paths/socket/session/store paths and use typed/sanitized diagnostics; tests assert projected responses do not contain the endpoint/runtime address.
  • Previous blocker 3 resolved: /api/workers keeps product-level request shape and preserves runtime rejection diagnostics while adding typed workspace_worker_create_not_accepted diagnostic.
  • Previous blocker 4 resolved: focused backend tests cover runtime connection test sanitization/compatibility, worker creation payload rejection, diagnostic preservation; web tests cover launch payload shaping/error handling.
  • Persisted config, live registry summaries, and test observations remain separated.
  • Browser-facing settings responses expose safe summaries rather than raw authority-bearing backend fields.
  • New Worker UI consumes /api/workers/options candidates and submits only product-level /api/workers payload.

Non-blocking follow-up:

  • UI could later render backend diagnostic codes/details more richly on Worker launch failure, but current behavior is sanitized and merge-ready.

No merge-blocking issues found.

State changed

Merge/validation acceptance:

  • Implementation branch work/00001KWHHRTM9-00001KWHEM8YJ was merged to develop with merge commit 4edaa73d merge: runtime worker controls.
  • Ticket record branch was merged to develop with merge commit 540e55d4 merge: runtime worker ticket records before final closure.
  • Final validation on develop passed:
    • git diff --check: pass
    • cargo test -p yoi-workspace-server: pass（55 lib tests + 2 main tests）
    • cargo check -p yoi: pass
    • cd web/workspace && deno task test: pass（13 tests）
    • cd web/workspace && deno task check: pass（0 errors / 0 warnings）
    • yoi ticket doctor: ok
  • nix build .#yoi --no-link は Cargo.lock / dependency / resource packaging / Nix 変更ではないため未実行。

External follow-up review approved the fix commit 47ed0ff8 and found no merge-blocking issues.

State changed

Ticket を closed にしました。

完了

完了。

実装内容:

  • Workspace Settings に Runtime Connections v0 を追加し、embedded Runtime を built-in / delete不可として表示するようにした。
  • remote Runtime connection の list/add/delete/test を Browser-facing API と Settings UI から扱えるようにした。
  • remote runtime config は .yoi/workspace-backend.local.toml の既存 [[runtimes.remote]] schema を typed read-modify-write で更新し、変更後は restart_required = true を返すようにした。
  • Runtime connection test は /v1/runtime の lightweight negotiation と Browser-relevant operation の compatibility/capability projection を行い、unsupported/unknown を typed sanitized diagnostics として返すようにした。
  • Browser-facing response から raw token/secret、Runtime endpoint、config path、workspace/internal paths、socket/session/store path、live handle 等が漏れないようにした。
  • Focused backend/web tests を追加した。

主な commit / merge:

  • implementation: f2fead7e feat: add workspace runtime and worker controls
  • review fix: 47ed0ff8 fix: harden runtime and worker launch controls
  • merge to develop: 4edaa73d merge: runtime worker controls
  • ticket-record merge before closure: 540e55d4 merge: runtime worker ticket records

Review:

  • 初回 external review は request_changes。
  • follow-up external review は approve。merge-blocking issue なし。

Final validation on develop:

  • git diff --check: pass
  • cargo test -p yoi-workspace-server: pass（55 lib tests + 2 main tests）
  • cargo check -p yoi: pass
  • cd web/workspace && deno task test: pass（13 tests）
  • cd web/workspace && deno task check: pass（0 errors / 0 warnings）
  • yoi ticket doctor: ok

未実行:

  • nix build .#yoi --no-link は Cargo.lock / dependency / resource packaging / Nix 変更ではないため未実行。