diff --git a/.yoi/tickets/00001KX6BPY7M/artifacts/.gitkeep b/.yoi/tickets/00001KX6BPY7M/artifacts/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/.yoi/tickets/00001KX6BPY7M/item.md b/.yoi/tickets/00001KX6BPY7M/item.md new file mode 100644 index 00000000..02c68bb2 --- /dev/null +++ b/.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 に保存することはしない。 diff --git a/.yoi/tickets/00001KX6BPY7M/thread.md b/.yoi/tickets/00001KX6BPY7M/thread.md new file mode 100644 index 00000000..eaf466c7 --- /dev/null +++ b/.yoi/tickets/00001KX6BPY7M/thread.md @@ -0,0 +1,23 @@ + + +## 作成 + +LocalTicketBackend によって作成されました。 + +--- + + + +## 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. + + +---