ticket: backend worker workdir registry

.yoi/tickets/00001KX6BPY7M/item.md

@@ -0,0 +1,83 @@
+---
+title: 'Add Backend Worker/Workdir registry and link model'
+state: 'planning'
+created_at: '2026-07-10T15:53:02Z'
+updated_at: '2026-07-10T15:54:24Z'
+assignee: null
+---
+
+## 背景
+
+Objective `00001KWW44EXK` の Worker / Session / workdir retention 方針に基づき、Worker と workdir の保存・retention・link authority を Backend SQLite に置く。
+
+現在は Runtime が Worker catalog と working directory materialization record を主に持ち、Backend は Worker create / workdir create を仲介しているだけである。このため、停止済み Worker、Session / transcript、Runtime-owned workdir、実ファイルが削除済みの workdir、unknown/external workdir の関係を Backend が安定して説明できない。
+
+今後の prune / archive / pinned retention を安全に実装するには、先に Backend 側に canonical registry と relation を持たせる必要がある。
+
+## 決定事項
+
+- Worker を作業記録の保存単位にする。
+- Session / transcript は Worker archive に内包または参照される履歴として扱い、Session 単体を長期保存 authority にしない。
+- Worker archive には retention policy を持たせ、`pinned` Worker を cleanup / prune から守れるようにする。
+- Workdir record は Backend SQLite にも canonical record を持たせる。Runtime は実ファイル、raw materialized path、process/cwd binding、cleanup 実行の authority を持つ。
+- Worker と Workdir の関係は SQLite link table で表す。Worker 側 summary copy は許容するが、relation authority は link table とする。
+- Workdir 実ファイルは durable history ではなく再現可能 cache として扱う。
+- Dirty workdir は活動中状態として扱う。Dirty orphan は自動 prune ではなく recovery Worker の起動または explicit discard の判断対象にする。
+- Browser-facing UI 表示は `workdir` に寄せる。内部 API の `working_directory` 互換名は段階移行中に残ってよい。
+
+## 要件
+
+- Backend SQLite に Worker registry を追加する。
+  - workspace_id
+  - backend worker id / runtime worker id
+  - runtime_id
+  - display name
+  - profile
+  - lifecycle state
+  - retention state（少なくとも pinned を表せること）
+  - session/transcript refs または将来 refs を保存できる shape
+  - summary/diagnostics 用の将来拡張余地
+- Backend SQLite に Workdir registry を追加する。
+  - workspace_id
+  - workdir_id
+  - runtime_id
+  - repository_id
+  - selector
+  - resolved_commit
+  - materialization status（present/removed/missing/unknown 相当）
+  - cleanliness（clean/dirty/unknown 相当）
+  - created_at / updated_at
+- Backend SQLite に Worker-Workdir link table を追加する。
+  - worker_id
+  - workdir_id
+  - role（primary など将来拡張可能）
+  - linked_at / unlinked_at
+- Backend 経由の workdir create は Backend Workdir registry row を作成/更新してから Runtime materialization を要求する。
+- Backend 経由の worker create は Backend Worker registry row と Worker-Workdir link を作成/更新する。
+- Runtime から返る Worker / Workdir status は Backend registry に同期される。
+- Browser-facing Worker / Workdir list は Backend registry を主にし、Runtime status は観測値として merge する。
+- Runtime direct API などで作られた Backend registry に無い workdir は unmanaged/external として扱い、通常の Backend-managed Workdirs 一覧に混ぜない。
+- Raw Runtime path は Backend registry / Browser response に保存・表示しない。
+
+## 受け入れ条件
+
+- Backend SQLite schema に Worker / Workdir / Worker-Workdir link の typed tables が追加されている。
+- 既存 store からの migration / default path があり、既存 Workspace Backend 起動を壊さない。
+- Backend API 経由で workdir を作成すると、Runtime record だけでなく Backend Workdir registry にも record が残る。
+- Backend API 経由で Worker を作成すると、Backend Worker registry と Worker-Workdir link が残る。
+- Stopped Worker と removed Workdir の関係を Backend registry から辿れる。
+- Worker archive / retention metadata に `pinned` を表せる。
+- Workdir 実ファイルが無いことは Runtime observation として扱われ、Backend canonical record が即座に失われない。
+- Backend-managed Workdir と unmanaged/external Runtime Workdir を区別できる。
+- Workers / Workdirs UI は Backend-managed registry を基準に表示できる。
+- `cargo test -p yoi-workspace-server --lib` が通る。
+- `cargo test -p worker-runtime --features ws-server,fs-store` が通る。
+- `cd web/workspace && deno task check && deno task test` が通る。
+- `nix build .#yoi --no-link` が通る。
+
+## 非目標
+
+- 実際の prune/delete 実行はこの Ticket では扱わない。
+- Session/transcript full deletion UI はこの Ticket では扱わない。
+- Dirty orphan recovery Worker の自動起動はこの Ticket では扱わない。
+- Runtime raw path を Backend canonical record に保存することはしない。

.yoi/tickets/00001KX6BPY7M/thread.md

@@ -0,0 +1,23 @@
+<!-- event: create author: "yoi ticket" at: 2026-07-10T15:53:02Z -->
+
+## 作成
+
+LocalTicketBackend によって作成されました。
+
+---
+
+<!-- event: decision author: hare at: 2026-07-10T15:54:24Z -->
+
+## Decision
+
+Worker / Session / workdir retention discussion from Objective 00001KWW44EXK:
+
+- Worker is the archival unit; Session/transcript belongs under Worker archive.
+- Worker retention must support pinned to protect selected history from cleanup/prune.
+- Workdir files are cache when clean and reconstructable from repository + selector/resolved commit.
+- Dirty workdir is an active/recovery state; dirty orphan should require recovery Worker or explicit discard, not automatic prune.
+- Backend should keep canonical Worker/Workdir/link records in SQLite, while Runtime owns materialized files, raw paths, process/cwd binding, and cleanup execution.
+- Runtime direct/unmanaged workdirs must be distinguishable from Backend-managed workdirs.
+
+
+---