Hare/yoi
1
1
Fork 0
Code Actions Packages Releases Activity
439f967cb8
yoi/.yoi/tickets/00001KVWPVHFJ/thread.md

9.4 KiB
Raw Blame History

作成

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

State changed

Ticket を workspace-panel が queued にしました。

Decision

Routing decision: implementation_ready

Reason:

  • Dashboard Queue により人間が Orchestrator routing を許可した queued Ticket として確認した。
  • Ticket body は yoi pod delete, yoi pod prune, yoi session prune --unreferenced の command spelling、dry-run/force semantics、live Pod refusal、session history preservation、explicit age threshold、validation を具体的に列挙している。
  • TicketRelationQuery は blocking relation 0 件、TicketOrchestrationPlanQuery は既存 plan 0 件だった。
  • risk flags は pod-lifecycle / persistence / destructive-operation / cli-ux / session-history / authority-boundary だが、destructive operations の safety rails と escalation conditions が明記されている。risk は reviewer focus として扱えばよく、planning return 理由にはならない。
  • 同時 queued Ticket 00001KVWPW3KX は TUI Console rendering で code surface が別。conflict risk は低く、別 worktree/branch で並列開始可能。

Evidence checked:

  • Ticket body / thread: item.md, thread.md。thread は create と ready->queued のみで未解決 blocker は記録されていない。
  • Relations / orchestration plan: relation 0 件、routing 前 plan 0 件。accepted plan orch-plan-20260624-120242-1 を記録済み。
  • Code map: Grep で crates/yoi/src/main.rs, crates/yoi/src/session_cli.rs, crates/pod-store/src/lib.rs, crates/session-store, crates/pod/src/entrypoint.rs, crates/pod/src/discovery.rs 周辺を確認。
  • Workspace state: /home/hare/Projects/yoi/.worktree/orchestration は clean。active inprogress Ticket は 0 件。

IntentPacket:

Intent:

  • Pod/session storage を手動削除せずに安全に整理できる公式 CLI を追加し、Pod metadata delete / Pod prune / unreferenced session prune を dry-run-first、force-required、live-safe に実装する。

Binding decisions / invariants:

  • No silent restore bypass。same-name fresh start は、ユーザーが明示的に stopped/restorable Pod metadata を削除した結果としてのみ発生する。
  • pod delete は session logs/history を削除しない。
  • live/reachable Pod metadata は削除しない。live 判定が不確実なら安全側に拒否する。
  • old cleanup に暗黙 threshold を持たせない。--older-than など明示 criteria が必要。
  • destructive deletion は --force 必須。--dry-run / default report を重視する。
  • Pod metadata authority は pod-store、session log authority は session-store のまま。
  • legacy top-level resume flags / bare Pod-name inference は再導入しない。
  • Panel/TUI の broad Pod manager 化は non-goal。

Requirements / acceptance criteria:

  • yoi pod delete <NAME> [--force] [--dry-run] で stopped/restorable Pod metadata を削除できる。
  • live/reachable Pod delete/prune は拒否され理由を出す。
  • yoi pod prune --older-than <DURATION> [--force] [--dry-run] は explicit threshold なしに old 判定削除しない。
  • yoi session prune --unreferenced [--older-than <DURATION>] [--force] [--dry-run] は Pod metadata active pointer から参照されない session/segment を report/prune できる。
  • delete/prune output は deleted/would delete/kept/refused reason を bounded に示す。
  • focused tests が stopped Pod delete, live refusal, session preservation, unreferenced prune dry-run/force, threshold requirement, CLI parsing/help を cover する。

Implementation latitude:

  • product CLI 側で management subcommands を捕捉するか、runtime entrypoint 側に安全に追加するかは coder が code map を見て判断してよい。
  • 必要なら shared cleanup module や session-store delete API を追加してよい。path safety tests を伴うこと。
  • Orphan detection は初期実装では active PodMetadata.active.session_id references を authority としてよい。lineage-aware retention は referenced sessions を削除しない限り follow-up に分けてよい。
  • Output は human-readable でよい。JSON は自然なら追加してよいが必須ではない。

Escalate if:

  • live Pod detection を安全に拒否できるほど reliable にできない。
  • orphan detection が session lineage semantics の変更を必要とする。
  • Pod delete の副作用として sessions を削除する必要が出る。
  • storage migration / compatibility fallback が必要になる。
  • command design が existing yoi pod runtime entrypoint usage と衝突する。
  • cleanup が Panel role-session/Ticket claims, worktrees, branches, Ticket state を mutate しようとする。

Validation:

  • cargo fmt --check
  • focused cargo test for yoi, pod-store, session-store, affected Pod/discovery code
  • cargo check -p yoi -p pod -p pod-store -p session-store
  • target/debug/yoi ticket doctor または yoi ticket doctor
  • git diff --check

Current code map:

  • Primary: crates/yoi/src/main.rs, crates/yoi/src/session_cli.rs, crates/pod-store/src/lib.rs, crates/session-store/src/fs_store.rs, crates/session-store/src/lib.rs, crates/pod/src/entrypoint.rs, crates/pod/src/discovery.rs。
  • Avoid: Panel/TUI manager UI, scheduler/stop semantics changes, Ticket/worktree/branch cleanup operations。

Critical risks / reviewer focus:

  • accidental deletion of session history from pod delete。
  • live/reachable Pod metadata deletion。
  • unsafe path deletion or broad directory removal。
  • force/dry-run semantics bypass。
  • ambiguous age parsing/default threshold。
  • breaking yoi pod runtime entrypoint spawn/restore behavior。

Next action:

  • queued -> inprogress を記録してから worktree-workflow で dedicated worktree を作成し、Coder/Reviewer sibling loop に進める。

State changed

Orchestrator acceptance: queued -> inprogress

  • 直前確認で TicketShow は state queued、blocking relation は 0 件、accepted plan orch-plan-20260624-120242-1 を確認した。
  • 同時 queued Ticket 00001KVWPW3KX は disjoint code surface のため別 worktree/branch で並列開始可能と判断した。
  • routing decision と IntentPacket は Ticket thread に記録済み。
  • これ以降に worktree-workflow で /home/hare/Projects/yoi/.worktree/00001KVWPVHFJ-storage-cleanup-cli を作成し、multi-agent-workflow に接続する。

Implementation report

実装報告（Ticket 00001KVWPVHFJ）

実装コミット: 80d6861a (feat: add pod and session cleanup CLI)

変更ファイル:

  • crates/yoi/src/main.rs: yoi pod delete/prune と yoi session prune の CLI ルーティング・help・終了ステータス処理を追加。
  • crates/yoi/src/pod_cleanup_cli.rs: Pod メタデータ cleanup CLI を追加。delete は Pod メタデータのみ削除し、session logs/history は保持。prune は明示された --older-than のみで候補化。live/reachable または liveness 不確実時は拒否。--force がない場合および --dry-run は report-only。
  • crates/yoi/src/session_cli.rs: session prune --unreferenced [--older-than <DURATION>] [--force] [--dry-run] を追加。Pod metadata の active session 参照を保護し、unreferenced Session のみ Session store API 経由で削除。
  • crates/session-store/src/fs_store.rs: Session store authority 内に root_dir / session_modified_at / delete_session を追加し、Session 単位削除と age 判定を store 側 API に寄せた。
  • crates/yoi/Cargo.toml, Cargo.lock: yoi から pod-store を直接利用する依存を追加。

検証結果:

  • cargo fmt --check: 成功。
  • cargo test -p yoi: 成功（95 tests）。
  • cargo test -p session-store --lib: 成功（33 tests）。
  • cargo test -p pod-store --lib: 成功（6 tests）。
  • cargo test -p pod discovery:: --lib: 成功（8 tests）。
  • cargo check -p yoi -p pod -p pod-store -p session-store: 成功。
  • cargo run -p yoi -- ticket doctor: 成功（doctor: ok）。
  • git diff --check: 成功。

補足:

  • 途中で cargo test -p yoi -p pod-store -p session-store -p pod --lib も実行したが、今回触れていない Pod prompt guidance の文言 assertion 2 件（worktree status, diff, and test results）で失敗したため、要求どおり pod discovery:: に絞って再検証した。

残リスク:

  • Pod liveness 判定は runtime socket への Unix socket connect に基づく。接続成功は live/reachable として拒否し、権限エラー等の不確実な結果も fail-safe で拒否する。socket が存在しない/接続拒否の stale socket は停止扱い。
  • session prune --unreferenced は現行 Pod metadata の active.session_id を authority として保護する。過去の非 active 参照は cleanup 対象になり得るため、設計どおり dry-run/report-first と --force 必須で運用する前提。