ticket: simplify worker delete lifecycle
This commit is contained in:
parent
c88283dbe5
commit
c949e1b4f2
|
|
@ -1,44 +1,46 @@
|
|||
---
|
||||
title: 'Add manual prune plan and cleanup operations for Workers and workdirs'
|
||||
title: 'Add manual delete and cleanup operations for Workers and workdirs'
|
||||
state: 'planning'
|
||||
created_at: '2026-07-10T16:11:33Z'
|
||||
updated_at: '2026-07-10T16:31:05Z'
|
||||
updated_at: '2026-07-10T16:43:34Z'
|
||||
assignee: null
|
||||
---
|
||||
|
||||
## 背景
|
||||
|
||||
Ticket `00001KX6BPY7M` で Backend SQLite に Worker / Workdir registry と Worker-Workdir link を追加する。その後続として、停止済み Worker、Session / transcript、Workdir 実ファイル、removed / missing Workdir record を安全に整理する manual cleanup / prune の仕組みが必要になる。
|
||||
Ticket `00001KX6BPY7M` で Backend SQLite に Worker / Workdir registry と Worker-Workdir link を追加する。その後続として、停止済み Worker、Session / transcript、Workdir 実ファイル、removed / missing Workdir record を安全に整理する manual delete / cleanup の仕組みが必要になる。
|
||||
|
||||
削除方針は基本手動とする。Yoi が勝手に Worker history や workdir changes を削除しない。Runtime / Backend は削除候補と理由を plan として提示し、ユーザーまたは明示的な orchestration authority が実行した場合だけ削除する。
|
||||
削除方針は基本手動とする。Yoi が勝手に Worker history や workdir changes を削除しない。Backend は削除候補と理由を plan として提示し、ユーザーまたは明示的な orchestration authority が実行した場合だけ削除する。
|
||||
|
||||
## 方針
|
||||
|
||||
- 削除は plan-first にする。
|
||||
- 自動削除はこの Ticket の範囲外。期限切れや容量制限による automatic prune は後続判断とする。
|
||||
- Worker は保存単位であり、Worker を archive/prune することは内包する Session / transcript retention と連動する。
|
||||
- `pinned` Worker は削除候補にしてはならない。この Ticket で pinned flag の永続化と pin/unpin mutation API も明示的に実装する。
|
||||
- Workdir 実ファイルは clean かつ stopped/archived Worker だけに紐づく場合、manual cleanup 候補にできる。
|
||||
- Dirty Workdir は活動中/要判断状態として扱い、manual cleanup でも explicit discard confirmation が必要。
|
||||
- Dirty orphan は recovery Worker 起動または explicit discard の判断対象であり、通常 prune とは区別する。
|
||||
- Removed / missing Workdir record は、linked Worker archive が必要な summary を保持している場合だけ manual record prune 候補にできる。
|
||||
- Worker lifecycle はシンプルに `running -> stopped -> delete` とする。`archived` を lifecycle state として導入しない。
|
||||
- Worker は保存単位であり、Session / transcript は Worker に内包または参照される履歴として扱う。
|
||||
- Worker delete は Worker record と内包する Session / transcript history の削除を意味する。Workdir は自動削除しない。
|
||||
- `pinned` Worker は delete 候補にしてはならない。この Ticket で pinned flag の永続化と pin/unpin mutation API も明示的に実装する。
|
||||
- Session / transcript の圧縮保存や高度な archive storage policy はこの Ticket では扱わない。必要なら後続で `history_storage: full | summarized | deleted` のような別概念として扱う。
|
||||
- Workdir 実ファイルは durable history ではなく再現可能 cache として扱い、基本的に手動で削除可能にする。
|
||||
- Clean Workdir は、running Worker に紐づいていなければ manual cleanup 候補にできる。
|
||||
- Dirty Workdir は削除可能だが、changes ごと消す explicit confirmation を要求する。
|
||||
- Dirty orphan は recovery Worker 起動または explicit discard の判断対象であり、通常の clean cleanup とは区別する。
|
||||
- Removed / missing Workdir record は、linked Worker が最後の repository/selector/resolved commit summary を保持している場合、manual record delete 候補にできる。
|
||||
- Raw Runtime path は Browser-facing plan に出さない。
|
||||
|
||||
## 要件
|
||||
|
||||
- Backend registry の Worker record に pinned flag または equivalent retention field を追加し、永続化する。
|
||||
- Backend API に Worker pin / unpin mutation を追加する。mutation は Backend Worker registry を更新し、Runtime process には不要な副作用を起こさない。
|
||||
- Backend registry を基準に Worker / Workdir / link の prune plan を生成する。
|
||||
- Backend registry を基準に Worker / Workdir / link の manual cleanup plan を生成する。
|
||||
- Runtime observation を merge して、workdir files の状態を `present` / `removed` / `missing` / `unknown` 相当で表示する。
|
||||
- Plan は対象ごとに、削除可能性、blocking reason、削除種別、推定 reclaim bytes を返す。
|
||||
- Manual operation として少なくとも以下を表せる。
|
||||
- Worker archive
|
||||
- Worker history/session deletion または summary-only retention
|
||||
- Worker delete（Worker record +内包 Session / transcript history）
|
||||
- Workdir files cleanup
|
||||
- Removed/missing Workdir record prune
|
||||
- Dirty Workdir discard with explicit confirmation
|
||||
- Removed/missing Workdir record delete
|
||||
- cleanup_pending retry
|
||||
- 実行 API は対象 ID と expected plan revision / digest を受け取り、古い plan に基づく削除を拒否する。
|
||||
- `pinned` Worker とそれに紐づく Session / Workdir record は削除実行時にも保護される。
|
||||
- `pinned` Worker とそれに紐づく Session history は削除実行時にも保護される。
|
||||
- Running Worker に紐づく Workdir files cleanup は拒否される。
|
||||
- Dirty Workdir の discard は通常 cleanup とは別 action として明示される。
|
||||
- Browser UI は plan preview を表示し、ユーザーが明示的に選択した対象だけ実行できる。
|
||||
|
|
@ -48,16 +50,16 @@ Ticket `00001KX6BPY7M` で Backend SQLite に Worker / Workdir registry と Work
|
|||
- `00001KX6BPY7M` の Backend Worker/Workdir registry と link model を前提として実装されている。
|
||||
- Backend API で Worker を pin / unpin でき、状態が SQLite に永続化される。
|
||||
- Worker list/detail は pinned state を返す。
|
||||
- Backend API で Runtime ごとの manual prune plan を取得できる。
|
||||
- Plan に Worker candidates と Workdir candidates が分かれて表示される。
|
||||
- Candidate には削除種別、理由、blocking reason、linked Worker/Workdir ids、retention state、pinned state が含まれる。
|
||||
- `pinned` Worker は prunable にならない。
|
||||
- Backend API で Runtime ごとの manual cleanup plan を取得できる。
|
||||
- Plan に Worker delete candidates と Workdir cleanup/delete candidates が分かれて表示される。
|
||||
- Candidate には削除種別、理由、blocking reason、linked Worker/Workdir ids、pinned state が含まれる。
|
||||
- `pinned` Worker は delete/prune candidate にならない。
|
||||
- Running Worker に linked された Workdir files は cleanup candidate にならない。
|
||||
- Clean + stopped/archived Worker only の Workdir files は cleanup candidate になる。
|
||||
- Removed + no retained link の Workdir record は record prune candidate になる。
|
||||
- Dirty orphan は normal prune candidate ではなく recovery/discard-required として表示される。
|
||||
- Manual cleanup 実行 API は stale plan revision を拒否する。
|
||||
- Manual cleanup 実行後、Backend registry と Runtime observation の状態が更新される。
|
||||
- Clean + no running linked Worker の Workdir files は cleanup candidate になる。
|
||||
- Dirty Workdir は discard confirmation required として表示され、通常 cleanup と区別される。
|
||||
- Removed + no retained link の Workdir record は record delete candidate になる。
|
||||
- Manual cleanup/delete 実行 API は stale plan revision を拒否する。
|
||||
- Manual cleanup/delete 実行後、Backend registry と Runtime observation の状態が更新される。
|
||||
- UI は Runtime > Workdirs / Workers 周辺から plan preview と manual execution に到達できる。
|
||||
- Raw Runtime path が Browser-facing response / UI に出ない。
|
||||
- `cargo test -p yoi-workspace-server --lib` が通る。
|
||||
|
|
@ -68,6 +70,7 @@ Ticket `00001KX6BPY7M` で Backend SQLite に Worker / Workdir registry と Work
|
|||
## 非目標
|
||||
|
||||
- 容量や期限による自動 prune policy は扱わない。
|
||||
- `archived` Worker lifecycle state は導入しない。
|
||||
- Session / transcript の圧縮 archive storage は扱わない。
|
||||
- Dirty Workdir を自動的に commit/push する recovery Worker 実装は扱わない。
|
||||
- Session / transcript の高度な要約・圧縮は扱わない。削除または summary-only retention の hook までに留める。
|
||||
- Runtime raw path を Backend canonical record に保存することはしない。
|
||||
|
|
|
|||
|
|
@ -35,4 +35,21 @@ Scope added here:
|
|||
- Ensure manual cleanup execution rejects pinned Worker history and protected linked records.
|
||||
|
||||
|
||||
---
|
||||
|
||||
<!-- event: decision author: hare at: 2026-07-10T16:43:34Z -->
|
||||
|
||||
## Decision
|
||||
|
||||
Lifecycle clarification:
|
||||
|
||||
- Worker lifecycle should stay simple: running -> stopped -> delete.
|
||||
- Do not introduce archived as a Worker lifecycle state in this ticket.
|
||||
- Worker is the storage unit for Session/transcript history; deleting a Worker deletes or removes access to that history.
|
||||
- Pinned remains necessary and blocks Worker deletion.
|
||||
- Workdir files are cache and should be manually deletable.
|
||||
- Dirty workdir deletion is allowed only with explicit confirmation that changes will be discarded.
|
||||
- Compression/archive storage for Session history is out of scope and should be a separate storage policy if needed later.
|
||||
|
||||
|
||||
---
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user