refactor: rename execution workspace to working directory
This commit is contained in:
@@ -20,14 +20,14 @@ Yoi を、単一のローカル開発ディレクトリで動くエージェン
|
||||
|
||||
- Workspace: チームまたはプロジェクトの管理単位。Ticket、Objective、Memory、Knowledge、Artifact、Policy、Actor、Repository、Runtime state を持つ。Git Repository root ではない。
|
||||
- Control plane: Workspace の正本を持ち、Web UI / API / CLI から操作される管理システム。
|
||||
- Runtime: Worker 群を束ねる実行基盤。Worker lifecycle、sandbox、mount、cache、checkout/worktree/container filesystem などの Execution Workspace materialization、event/control plane を管理する。将来的には 1 つの Runtime が複数 Workspace / Repository の Worker を抱えられる。
|
||||
- Worker: Runtime が管理する 1 つの agent/session/process。Runtime が用意した Execution Workspace と authority の中で動く。
|
||||
- Runtime: Worker 群を束ねる実行基盤。Worker lifecycle、sandbox、mount、cache、checkout/worktree/container filesystem などの working directory materialization、event/control plane を管理する。将来的には 1 つの Runtime が複数 Workspace / Repository の Worker を抱えられる。
|
||||
- Worker: Runtime が管理する 1 つの agent/session/process。Runtime が用意した working directory と authority の中で動く。
|
||||
- Repository: Workspace に接続される source/storage。コード、ドキュメント、local directory、object storage、artifact store、dataset などを含む。Git Repository も Repository の一種であり、基本的には filesystem path ではなく URI / URL で識別する。
|
||||
- RepositoryId: Workspace 内でどの Repository を対象にするかを指す安定 identifier。Git hash、branch、path ではない。
|
||||
- Repository provider: Repository の種類ごとの実装。Git、local filesystem、object store、artifact store、将来の non-Git VCS など。
|
||||
- RepositorySelector: Repository provider に渡す未解決の地点指定。branch/tag/PR/revspec/bookmark/revset/path@revision/object version/latest など provider-specific な symbolic / mutable / query-like locator であり、それ自体は再現性の authority ではない。
|
||||
- RepositoryPoint: RepositorySelector をある時点で解決した具体地点。Git commit/tree、Mercurial changeset、SVN revision、object store version/manifest digest、file snapshot など provider ごとの immutable / reproducible point を表し、Artifact/evidence に残す。
|
||||
- Execution Workspace: Runtime が Worker のために作る作業環境。1 つ以上の RepositoryPoint から materialize される作業用ディレクトリ、container filesystem、sandbox mount の集合であり、Git worktree、clone、sparse checkout などはこれを作る手段である。
|
||||
- working directory: Runtime が Worker のために作る作業環境。1 つ以上の RepositoryPoint から materialize される作業用ディレクトリ、container filesystem、sandbox mount の集合であり、Git worktree、clone、sparse checkout などはこれを作る手段である。
|
||||
- Ticket: チームで扱う作業単位。目的、要件、判断、議論、完了条件、関係、証跡を持つ。
|
||||
- Objective: 複数の Ticket を束ねる長期目標や設計方針。
|
||||
- Artifact: Ticket や Worker 実行に紐づく成果物や証跡。diff、log、validation result、review result、report など。
|
||||
@@ -46,7 +46,7 @@ Yoi を、単一のローカル開発ディレクトリで動くエージェン
|
||||
- 管理システムと Runtime を分ける。
|
||||
- まず Web から Ticket、Objective、Memory、Knowledge、Artifact、Runtime / Worker state を見られるようにする。
|
||||
- 最初はローカル Runtime を使い、後でリモート Runtime、クラウド Runtime、runtime pool、resource allocation、quota、billing、sandboxing に拡張する。
|
||||
- Git ホスティング機能を取り込むのではなく、Git Repository / worktree / clone は Repository provider と Execution Workspace materialization の手段として扱う。
|
||||
- Git ホスティング機能を取り込むのではなく、Git Repository / worktree / clone は Repository provider と working directory materialization の手段として扱う。
|
||||
|
||||
OSS として Control plane、Runtime、Web frontend、protocol を公開しつつ、managed service では hosted control plane、runtime fleet、リソース柔軟性、team auth、backup、audit、availability、multi-tenant operations で価値を出す。
|
||||
|
||||
@@ -68,7 +68,7 @@ Ticket と Objective は Repository 配下に置かず、Workspace 配下に平
|
||||
|
||||
RepositorySelector は Git branch/tag の抽象化ではない。Selector は provider-specific な未解決 locator であり、Git provider なら branch/tag/ref/revspec/PR/commit、Mercurial provider なら bookmark/revset/changeset、SVN provider なら path/revision、object store provider なら prefix/version/latest などを解釈する。実行時には Control plane または Repository provider が Selector を RepositoryPoint に解決し、Runtime はその RepositoryPoint を materialize する。
|
||||
|
||||
Worker launch request は Ticket の target selector を concrete RepositoryPoint に解決し、その RepositoryPoint から Runtime が Execution Workspace を materialize する。Git worktree 相当の機能は、この Execution Workspace を作るための実装戦略として扱う。
|
||||
Worker launch request は Ticket の target selector を concrete RepositoryPoint に解決し、その RepositoryPoint から Runtime が working directory を materialize する。Git worktree 相当の機能は、この working directory を作るための実装戦略として扱う。
|
||||
|
||||
Backend は cwd や `--workspace` を暗黙の Repository として扱わない。`--workspace` は当面 workspace config root / local descriptor root を指すだけであり、Repository registry は明示設定された Workspace config から構築する。短期的には `.yoi/workspace-backend.local.toml` の `[[repositories]]` を local descriptor として使い、`uri = "."` のような local repository も明示 entry として登録する。`./` を暗黙 Repository として自動採用しない。
|
||||
|
||||
@@ -86,7 +86,7 @@ Ticket target は intent/selector であり、実行再現性のための immuta
|
||||
Ticket
|
||||
-> target selectors: Repository + ref selector + path + intent
|
||||
-> resolved RepositoryPoint
|
||||
-> Execution Workspace
|
||||
-> working directory
|
||||
-> WorkerRef / Artifact / Evidence
|
||||
-> Review / Decision
|
||||
-> Audit / Notification
|
||||
@@ -119,7 +119,7 @@ Ticket には次の概念が必要になる。
|
||||
- Actor identity: human / agent / system / service account.
|
||||
- Assignment / owner / reviewer / watcher.
|
||||
- Typed thread events: comment, decision, plan, review, implementation report, state transition.
|
||||
- Linked Objective / Artifact / WorkerRef / Repository / RepositoryPoint / Execution Workspace.
|
||||
- Linked Objective / Artifact / WorkerRef / Repository / RepositoryPoint / working directory.
|
||||
- Permission / visibility.
|
||||
- Audit trail.
|
||||
- Notification / mention.
|
||||
@@ -170,17 +170,17 @@ Ticket / user intent
|
||||
-> RepositoryId + RepositorySelector + path scope + required authority
|
||||
-> resolved RepositoryPoint
|
||||
-> WorkerLaunchRequest / ConfigBundle / AuthorityBundle
|
||||
-> Runtime ExecutionWorkspaceMaterializer
|
||||
-> Execution Workspace allocation
|
||||
-> Runtime WorkingDirectoryMaterializer
|
||||
-> working directory allocation
|
||||
-> Worker process
|
||||
-> WorkerRef + Artifact/evidence
|
||||
```
|
||||
|
||||
Control plane は Workspace authority、Ticket target、Repository registry、Actor permission、設定 bundle の正本を持つ。Control plane または Repository provider は RepositorySelector を RepositoryPoint に解決し、どの地点を対象にしたかを evidence に残す。Runtime は RepositoryPoint、materialization policy、sandbox policy、mount/cache/secret policy、Worker config を受け取り、Runtime-local な Execution Workspace を確保して Worker を起動する。
|
||||
Control plane は Workspace authority、Ticket target、Repository registry、Actor permission、設定 bundle の正本を持つ。Control plane または Repository provider は RepositorySelector を RepositoryPoint に解決し、どの地点を対象にしたかを evidence に残す。Runtime は RepositoryPoint、materialization policy、sandbox policy、mount/cache/secret policy、Worker config を受け取り、Runtime-local な working directory を確保して Worker を起動する。
|
||||
|
||||
この境界では、Worker は host filesystem path や Repository credential を自分で発見しない。Worker は Runtime が materialize した workspace root、mount、環境変数、tool authority、config bundle だけを見る。Runtime は Execution Workspace の lifecycle、cleanup、cache reuse、namespace、quota、sandbox boundary、event collection を管理する。Control plane / Browser-facing API は raw host path、secret、socket、internal runtime path を authority-bearing internals として扱い、必要な evidence だけを Artifact として公開する。
|
||||
この境界では、Worker は host filesystem path や Repository credential を自分で発見しない。Worker は Runtime が materialize した workspace root、mount、環境変数、tool authority、config bundle だけを見る。Runtime は working directory の lifecycle、cleanup、cache reuse、namespace、quota、sandbox boundary、event collection を管理する。Control plane / Browser-facing API は raw host path、secret、socket、internal runtime path を authority-bearing internals として扱い、必要な evidence だけを Artifact として公開する。
|
||||
|
||||
v0 materializer は existing local root を明示的な Execution Workspace として返してよい。ただし型と呼び出し順序は、後で Git worktree、clone、sparse checkout、container filesystem、remote object snapshot、multi-repository mount に置き換えられる形にする。Runtime process 起動時の `--workspace` はこの v0 materializer の legacy bootstrap input であり、Runtime identity や long-term workspace binding ではない。
|
||||
v0 materializer は existing local root を明示的な working directory として返してよい。ただし型と呼び出し順序は、後で Git worktree、clone、sparse checkout、container filesystem、remote object snapshot、multi-repository mount に置き換えられる形にする。Runtime process 起動時の `--workspace` はこの v0 materializer の legacy bootstrap input であり、Runtime identity や long-term workspace binding ではない。
|
||||
|
||||
その後で、remote Runtime、self-hosted Runtime、hosted cloud runtime fleet、runtime pool、resource allocation、quota、billing、sandbox、network policy、secret distribution を追加する。
|
||||
|
||||
@@ -204,7 +204,7 @@ Web UI は Ticket、Objective、Memory、Knowledge、Runtime、Worker、Artifact
|
||||
|
||||
### 7. 多重起動コストと runtime placement を見直す
|
||||
|
||||
Cloud/remote execution を成立させるには、多数のエージェント実行を安く管理できる必要がある。logical Worker session と Runtime process/resource placement を分ける。Runtime は Git Repository root や Workspace path に固定されず、request ごとに必要な Execution Workspace を materialize できる実行基盤として扱う。
|
||||
Cloud/remote execution を成立させるには、多数のエージェント実行を安く管理できる必要がある。logical Worker session と Runtime process/resource placement を分ける。Runtime は Git Repository root や Workspace path に固定されず、request ごとに必要な working directory を materialize できる実行基盤として扱う。
|
||||
|
||||
初期 Workspace DB では、Worker を canonical table として永続化しない。Runtime / Worker 一覧は backend-local runtime inspection や将来の Runtime protocol から逐次取得する live view とし、Ticket に関わった Worker は Ticket thread events と WorkerRef snapshot / TicketWorkerLink として記録する。
|
||||
|
||||
@@ -214,7 +214,7 @@ Worker の一元管理、データ永続化、アーカイブは将来的には
|
||||
|
||||
- Worker identity と Runtime process/resource placement の分離。
|
||||
- 1 Runtime が複数 Workspace / Repository の Worker を抱える場合の namespace、quota、cleanup、audit boundary。
|
||||
- Runtime-side Execution Workspace materialization、sandbox、mount、checkout/worktree/container filesystem の責務。
|
||||
- Runtime-side working directory materialization、sandbox、mount、checkout/worktree/container filesystem の責務。
|
||||
- Provider client、tool registry、resource cache の共有可能性。
|
||||
- Prompt/resource/profile/config bundle resolution cache。
|
||||
- Model call multiplexing and scheduling。
|
||||
@@ -226,7 +226,7 @@ Worker の一元管理、データ永続化、アーカイブは将来的には
|
||||
## Initial phases / candidate tickets
|
||||
|
||||
1. **Vocabulary / architecture record**
|
||||
- Workspace / RepositoryId / RepositorySelector / RepositoryPoint / Execution Workspace / Runtime / Worker / Control Plane / Ticket / Memory / Knowledge の用語と境界を固める。
|
||||
- Workspace / RepositoryId / RepositorySelector / RepositoryPoint / working directory / Runtime / Worker / Control Plane / Ticket / Memory / Knowledge の用語と境界を固める。
|
||||
2. **Team-space canonical data model**
|
||||
- Ticket / Objective / Target / Artifact / Actor / Permission / Audit / Memory / Knowledge の entity/event model を設計する。
|
||||
3. **Ticket evidence model**
|
||||
@@ -238,8 +238,8 @@ Worker の一元管理、データ永続化、アーカイブは将来的には
|
||||
6. **Web control plane MVP design**
|
||||
- read-only Ticket / Objective / Memory / Knowledge / Runtime / Worker state UI/API の範囲を決める。
|
||||
7. **Local Runtime protocol design**
|
||||
- Web/control plane から local Runtime に安全な操作を送り、Runtime が Worker lifecycle と Execution Workspace materialization を担う protocol と authority boundary を設計する。
|
||||
8. **Repository and Execution Workspace materialization model**
|
||||
- Web/control plane から local Runtime に安全な操作を送り、Runtime が Worker lifecycle と working directory materialization を担う protocol と authority boundary を設計する。
|
||||
8. **Repository and working directory materialization model**
|
||||
- Repository URI、Repository provider capability、RepositorySelector resolution、RepositoryPoint evidence、Git worktree / clone / sparse checkout / future source backend を Runtime-side materialization strategy として抽象化する。
|
||||
9. **Remote/hosted runtime foundation**
|
||||
- runtime registration, heartbeat, capability advertisement, job assignment, logs/events, secrets, sandbox/resource policy を設計する。
|
||||
@@ -258,7 +258,7 @@ Worker の一元管理、データ永続化、アーカイブは将来的には
|
||||
|
||||
## Success criteria / exit conditions
|
||||
|
||||
- Workspace / RepositoryId / RepositorySelector / RepositoryPoint / Execution Workspace / Runtime / Worker / Control Plane / Ticket / Memory / Knowledge の境界が文書化されている。
|
||||
- Workspace / RepositoryId / RepositorySelector / RepositoryPoint / working directory / Runtime / Worker / Control Plane / Ticket / Memory / Knowledge の境界が文書化されている。
|
||||
- Ticket が team coordination record として、target selector / Artifact / Actor / Permission / Audit と分離された model を持つ。
|
||||
- `.yoi` local backend は compatibility/local backend として整理され、server-side canonical backend の設計を阻害しない。
|
||||
- Web UI/API が Ticket / Objective / Runtime / Worker state を中心とした read-only view を提供できる設計または MVP を持つ。Memory / Knowledge は既存 record の表示または将来 placeholder に留め、本格再設計をこの段階の必須条件にしない。
|
||||
@@ -266,7 +266,7 @@ Worker の一元管理、データ永続化、アーカイブは将来的には
|
||||
- Runtime は single Workspace / Git repository root 専用 process ではなく、sandbox/authority が成立すれば複数 Workspace / Repository の Worker を抱えられる execution substrate として設計されている。
|
||||
- Git Repository root に依存しない Workspace model があり、Git Repository は Repository provider の一種として扱われている。
|
||||
- Ticket と Objective は Workspace 配下に平たく存在し、Repository への所属ではなく RepositoryId / RepositorySelector / path scope / intent で対象を表現する。
|
||||
- Git worktree 相当は Execution Workspace materialization strategy として扱われ、Artifact/evidence が concrete RepositoryPoint を記録する。
|
||||
- Git worktree 相当は working directory materialization strategy として扱われ、Artifact/evidence が concrete RepositoryPoint を記録する。
|
||||
- Memory / Knowledge は Ticket / Artifact の authority を置き換えない record として platform contract だけを持つ。本格的な意味論・抽出・承認・検索・staleness 処理は、Memory の保存先を Workspace backend / control plane record に移すタイミングで回収する。
|
||||
- Hosted Runtime / resource allocation / SaaS offering に進むための後続 Ticket が切れる状態になっている。
|
||||
- 既存 local dogfooding runtime を壊さず、local use と remote-capable architecture が両立している。
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: "Runtime execution workspace materialization and sandboxed agent environments"
|
||||
title: "Runtime working directory materialization and sandboxed agent environments"
|
||||
state: "active"
|
||||
created_at: "2026-07-06T16:28:12Z"
|
||||
updated_at: "2026-07-06T16:28:12Z"
|
||||
@@ -8,11 +8,11 @@ linked_tickets: ["00001KWPC13WQ", "00001KWMBAA6V"]
|
||||
|
||||
## Goal
|
||||
|
||||
Runtime が Worker ごとに安全で安価な作業環境を用意できるようにする。Yoi の Runtime は、単に既存ディレクトリで Worker process を起動する launcher ではなく、RepositoryPoint から Execution Workspace を materialize し、sandbox / mount / cache / cleanup / evidence を管理する実行基盤になる。
|
||||
Runtime が Worker ごとに安全で安価な作業環境を用意できるようにする。Yoi の Runtime は、単に既存ディレクトリで Worker process を起動する launcher ではなく、RepositoryPoint から working directory を materialize し、sandbox / mount / cache / cleanup / evidence を管理する実行基盤になる。
|
||||
|
||||
この Objective の中心は、Worktree ライクな作業ディレクトリ管理、Repository cache、Execution Workspace allocation、sandboxed agent environment の境界を設計し、将来的に 1 つの Runtime が複数 Workspace / Repository の Worker を抱えられるようにすることである。
|
||||
この Objective の中心は、Worktree ライクな作業ディレクトリ管理、Repository cache、working directory allocation、sandboxed agent environment の境界を設計し、将来的に 1 つの Runtime が複数 Workspace / Repository の Worker を抱えられるようにすることである。
|
||||
|
||||
初期実装では Git/local repository を主対象にしてよい。ただし設計は Git worktree 固定にしない。Git worktree、bare object cache、sparse checkout、copy-on-write snapshot、reflink copy、APFS clonefile、btrfs snapshot、overlay filesystem、container filesystem、remote object snapshot は、すべて Execution Workspace materialization strategy の候補として扱う。
|
||||
初期実装では Git/local repository を主対象にしてよい。ただし設計は Git worktree 固定にしない。Git worktree、bare object cache、sparse checkout、copy-on-write snapshot、reflink copy、APFS clonefile、btrfs snapshot、overlay filesystem、container filesystem、remote object snapshot は、すべて working directory materialization strategy の候補として扱う。
|
||||
|
||||
## Motivation / background
|
||||
|
||||
@@ -24,7 +24,7 @@ Runtime が Worker ごとに安全で安価な作業環境を用意できるよ
|
||||
- Worker ごとに full clone すると容量と時間のコストが大きすぎる。
|
||||
- `.yoi` / Backend fs-store / Workspace descriptor と、Worker 実行用 checkout / scratch / build output の lifecycle が混ざりやすい。
|
||||
|
||||
Yoi は Workspace / Repository / Runtime を分ける方針になっている。Backend は Repository registry、RepositorySelector、RepositoryPoint、Ticket/Artifact evidence の authority を持つ。一方 Runtime は RepositoryPoint を受け取り、Worker が使う Execution Workspace を用意する責務を持つべきである。
|
||||
Yoi は Workspace / Repository / Runtime を分ける方針になっている。Backend は Repository registry、RepositorySelector、RepositoryPoint、Ticket/Artifact evidence の authority を持つ。一方 Runtime は RepositoryPoint を受け取り、Worker が使う working directory を用意する責務を持つべきである。
|
||||
|
||||
したがって、Repository を持ってくる実体ディレクトリは Backend / Workspace store ではなく Runtime 管理領域に置く。`./.yoi` は local descriptor / compatibility / project record surface であり、Worker ごとの checkout、worktree、snapshot、sandbox root、build cache、dependency cache を置く場所ではない。
|
||||
|
||||
@@ -32,11 +32,11 @@ Yoi は Workspace / Repository / Runtime を分ける方針になっている。
|
||||
|
||||
## Glossary
|
||||
|
||||
- Runtime root: Runtime が自身の store、cache、Worker metadata、Execution Workspace allocation を管理する root。長期的には `~/.yoi/runtimes/<runtime-id>/` 配下など、Workspace backend store とは別に置く。
|
||||
- Runtime root: Runtime が自身の store、cache、Worker metadata、working directory allocation を管理する root。長期的には `~/.yoi/runtimes/<runtime-id>/` 配下など、Workspace backend store とは別に置く。
|
||||
- Repository cache: Runtime-local の共有 source/cache。Git なら bare mirror / object cache / packfile cache など。重く、長寿命で、複数 Worker allocation から共有される。
|
||||
- Execution Workspace: Worker ごとの作業環境。短寿命で、Worker が読み書きする root / mounts / scratch / overlay を含む。
|
||||
- Materialization strategy: RepositoryPoint から Execution Workspace を作る実装戦略。Git detached worktree、sparse checkout、CoW snapshot、reflink copy、overlay、container filesystem など。
|
||||
- ExecutionWorkspaceAllocation: Runtime が払い出した作業環境の record。allocation id、worker id、workspace id、repository point、materializer kind、root、mounts、cleanup policy、status を持つ。
|
||||
- working directory: Worker ごとの作業環境。短寿命で、Worker が読み書きする root / mounts / scratch / overlay を含む。
|
||||
- Materialization strategy: RepositoryPoint から working directory を作る実装戦略。Git detached worktree、sparse checkout、CoW snapshot、reflink copy、overlay、container filesystem など。
|
||||
- WorkingDirectoryAllocation: Runtime が払い出した作業環境の record。allocation id、worker id、workspace id、repository point、materializer kind、root、mounts、cleanup policy、status を持つ。
|
||||
- Sandbox policy: Worker が見られる filesystem、network、process、secret、tool authority の境界を表す policy。
|
||||
- Dirty state policy: local uncommitted changes を Worker environment に含めるかどうかの方針。clean point only、patch artifact apply、snapshot current worktree など。
|
||||
|
||||
@@ -64,7 +64,7 @@ Runtime root
|
||||
- config bundles
|
||||
- worker metadata / transcript references
|
||||
- repository-cache
|
||||
- execution-workspaces
|
||||
- working-directories
|
||||
- sandbox state
|
||||
- build/dependency cache
|
||||
- cleanup ledger
|
||||
@@ -94,7 +94,7 @@ Runtime root
|
||||
git/
|
||||
<repository-cache-key>/
|
||||
bare.git
|
||||
execution-workspaces/
|
||||
working-directories/
|
||||
<allocation-id>/
|
||||
root/
|
||||
mounts/
|
||||
@@ -106,14 +106,14 @@ Runtime root
|
||||
|
||||
### 2. clone ではなく materialize と呼ぶ
|
||||
|
||||
Runtime は Repository を毎回 clone するのではない。Runtime は RepositoryPoint を Worker 用の Execution Workspace として materialize する。
|
||||
Runtime は Repository を毎回 clone するのではない。Runtime は RepositoryPoint を Worker 用の working directory として materialize する。
|
||||
|
||||
```text
|
||||
RepositoryId + RepositorySelector
|
||||
-> resolved RepositoryPoint
|
||||
-> Runtime repository-cache
|
||||
-> ExecutionWorkspaceMaterializer
|
||||
-> ExecutionWorkspaceAllocation
|
||||
-> WorkingDirectoryMaterializer
|
||||
-> WorkingDirectoryAllocation
|
||||
-> Worker process
|
||||
```
|
||||
|
||||
@@ -130,13 +130,13 @@ Git の場合でも materialization strategy は複数あり得る。
|
||||
|
||||
### 3. Repository cache と Worker workspace を分離する
|
||||
|
||||
full clone を Worker ごとに作らない。重い source/object data は Runtime-local repository cache に集約し、Worker ごとの Execution Workspace は cheap allocation にする。
|
||||
full clone を Worker ごとに作らない。重い source/object data は Runtime-local repository cache に集約し、Worker ごとの working directory は cheap allocation にする。
|
||||
|
||||
Git v0 の方向:
|
||||
|
||||
```text
|
||||
repository-cache/git/<repo-key>/bare.git
|
||||
execution-workspaces/<allocation-id>/root/<repository-id>/
|
||||
working-directories/<allocation-id>/root/<repository-id>/
|
||||
```
|
||||
|
||||
初回:
|
||||
@@ -174,7 +174,7 @@ Dirty state を含める場合、Artifact/evidence には source RepositoryPoint
|
||||
|
||||
### 5. Sandbox を materialization と同じ境界で扱う
|
||||
|
||||
Execution Workspace は単なる directory path ではなく、Worker が見てよい filesystem view である。Runtime は Execution Workspace allocation と同時に sandbox/mount/authority を構築する。
|
||||
working directory は単なる directory path ではなく、Worker が見てよい filesystem view である。Runtime は working directory allocation と同時に sandbox/mount/authority を構築する。
|
||||
|
||||
Worker に渡すもの:
|
||||
|
||||
@@ -197,14 +197,14 @@ Worker が自分で発見してはいけないもの:
|
||||
|
||||
Sandbox v0 は strong isolation でなくてもよい。ただし型と lifecycle は、後で container sandbox、namespace, mount filtering, network policy, secret boundary に拡張できる形にする。
|
||||
|
||||
### 6. Execution Workspace registry を持つ
|
||||
### 6. working directory registry を持つ
|
||||
|
||||
Runtime は materialized workspace を filesystem だけでなく registry でも管理する。
|
||||
|
||||
必要な record:
|
||||
|
||||
```text
|
||||
ExecutionWorkspaceAllocation
|
||||
WorkingDirectoryAllocation
|
||||
id
|
||||
runtime_id
|
||||
worker_id
|
||||
@@ -245,26 +245,26 @@ Rift の filtered CoW creation のように、重い artifacts を除外しな
|
||||
|
||||
### Phase 1: Materialization boundary and legacy allocation record
|
||||
|
||||
- `CreateWorkerRequest` に Execution Workspace request / target placeholder を追加する。
|
||||
- `ExecutionWorkspaceMaterializer` trait を `worker-runtime` に追加する。
|
||||
- `CreateWorkerRequest` に working directory request / target placeholder を追加する。
|
||||
- `WorkingDirectoryMaterializer` trait を `worker-runtime` に追加する。
|
||||
- `WorkerRuntimeExecutionBackend` が Worker spawn 前に materializer を呼ぶ順序にする。
|
||||
- v0 materializer は existing local root を explicit allocation として返してよいが、`direct_legacy_mount` として明示し、通常設計の final form と混同しない。
|
||||
- Allocation record / cleanup policy / diagnostics の型を先に作る。
|
||||
- Worker が source repository root を直接 scope として要求する経路を deprecated/legacy に閉じ込める。
|
||||
|
||||
### Phase 2: Runtime root and execution workspace storage
|
||||
### Phase 2: Runtime root and working directory storage
|
||||
|
||||
- `--runtime-root` を導入し、Runtime state / repository-cache / execution-workspaces / worker metadata / worker runtime dirs を Runtime root 配下へ寄せる。
|
||||
- `--runtime-root` を導入し、Runtime state / repository-cache / working-directories / worker metadata / worker runtime dirs を Runtime root 配下へ寄せる。
|
||||
- `--workspace` は legacy bootstrap input としてだけ扱い、Runtime identity / long-term workspace binding から外す。
|
||||
- Runtime root default は user data 配下にする。
|
||||
- Execution Workspace allocation registry を Runtime root に保存する。
|
||||
- working directory allocation registry を Runtime root に保存する。
|
||||
|
||||
### Phase 3: Git cached detached worktree materializer
|
||||
|
||||
- Git repository cache を Runtime root に作る。
|
||||
- RepositorySelector を RepositoryPoint に解決する呼び出し境界を作る。
|
||||
- resolved commit/tree を evidence として残す。
|
||||
- Worker ごとに detached worktree を `execution-workspaces/<allocation-id>/root/<repository-id>` に作る。
|
||||
- Worker ごとに detached worktree を `working-directories/<allocation-id>/root/<repository-id>` に作る。
|
||||
- Worker stop / cleanup 時に `git worktree remove` と registry cleanup を行う。
|
||||
- dirty state は v0 では `clean_point_only` を default にし、dirty local workspace は明示 diagnostic で拒否する。
|
||||
|
||||
@@ -284,13 +284,13 @@ Rift の filtered CoW creation のように、重い artifacts を除外しな
|
||||
|
||||
- container filesystem / mount namespace / network policy / secret handle / tool authority を Runtime allocation と統合する。
|
||||
- Runtime が複数 Workspace / Repository の Worker を同時に抱える場合の namespace、quota、cleanup、audit boundary を固める。
|
||||
- remote/self-hosted/hosted Runtime fleet で repository cache と execution workspace storage をどう扱うかを設計する。
|
||||
- remote/self-hosted/hosted Runtime fleet で repository cache と working directory storage をどう扱うかを設計する。
|
||||
|
||||
## Non-goals
|
||||
|
||||
- v0 で完全な container sandbox を実装すること。
|
||||
- Worker ごとに full clone すること。
|
||||
- `.yoi` や Backend workspace store に Worker execution workspace を置くこと。
|
||||
- `.yoi` や Backend workspace store に Worker working directory を置くこと。
|
||||
- Git worktree を唯一の materialization strategy として固定すること。
|
||||
- Dirty local changes を暗黙に Worker に渡すこと。
|
||||
- Browser-facing API に raw host path、secret、Runtime internal store path を公開すること。
|
||||
@@ -298,10 +298,10 @@ Rift の filtered CoW creation のように、重い artifacts を除外しな
|
||||
|
||||
## Success criteria / exit conditions
|
||||
|
||||
- Runtime root、Repository cache、Execution Workspace、Backend/Workspace store の境界が文書化されている。
|
||||
- Runtime が Worker spawn 前に Execution Workspace materializer を呼ぶ型と順序を持つ。
|
||||
- Worker は source repository root ではなく materialized Execution Workspace を scope として起動する。
|
||||
- Execution Workspace allocation が Runtime registry に記録され、cleanup policy を持つ。
|
||||
- Runtime root、Repository cache、working directory、Backend/Workspace store の境界が文書化されている。
|
||||
- Runtime が Worker spawn 前に working directory materializer を呼ぶ型と順序を持つ。
|
||||
- Worker は source repository root ではなく materialized working directory を scope として起動する。
|
||||
- working directory allocation が Runtime registry に記録され、cleanup policy を持つ。
|
||||
- Git/local repository の v0 materializer が full clone 連発ではなく shared cache / detached worktree / cheap allocation の方向に進んでいる。
|
||||
- dirty state policy が明示され、clean point、patch artifact、snapshot のどれを使ったか evidence に残せる。
|
||||
- Runtime process 起動時の `--workspace` は legacy bootstrap input として隔離され、Runtime identity や single workspace binding とみなされない。
|
||||
@@ -315,10 +315,10 @@ Rift の filtered CoW creation のように、重い artifacts を除外しな
|
||||
## Decision context
|
||||
|
||||
- Runtime は Worker 群を束ねる実行基盤であり、Worker 用の作業環境を用意する責務を持つ。
|
||||
- Repository は clone されるものではなく、RepositoryPoint から Worker 用 Execution Workspace として materialize される。
|
||||
- Runtime execution storage は Backend/Workspace store と分離する。`.yoi` は Worker execution workspace 置き場ではない。
|
||||
- Repository は clone されるものではなく、RepositoryPoint から Worker 用 working directory として materialize される。
|
||||
- Runtime execution storage は Backend/Workspace store と分離する。`.yoi` は Worker working directory 置き場ではない。
|
||||
- full clone を Worker ごとに作らない。Runtime-local repository cache と Worker-local cheap workspace allocation を分ける。
|
||||
- Git detached worktree は v0 materialization strategy として有力だが、Git worktree 固定の設計にはしない。
|
||||
- CoW snapshot / reflink / btrfs snapshot / APFS clonefile / Rift-like workspace creation は、将来の materializer backend として検討する。
|
||||
- Dirty local state は暗黙に渡さず、policy と evidence を持って扱う。
|
||||
- Sandbox は後付けの別機能ではなく、Execution Workspace allocation と同じ境界で扱う。
|
||||
- Sandbox は後付けの別機能ではなく、working directory allocation と同じ境界で扱う。
|
||||
|
||||
@@ -43,7 +43,7 @@ queued_at: '2026-07-04T19:34:04Z'
|
||||
|
||||
## 非目標
|
||||
|
||||
- Runtime materialization / Execution Workspace 作成をこのチケットで実装すること。
|
||||
- Runtime materialization / working directory 作成をこのチケットで実装すること。
|
||||
- multi-workspace Backend store を `~/.yoi/` に完全移行すること。
|
||||
- Repository credential / clone / fetch / write operation を実装すること。
|
||||
- Ticket target から RepositoryPoint を解決して Worker launch に渡すこと。
|
||||
|
||||
@@ -85,7 +85,7 @@ Implementation latitude:
|
||||
- focused tests の構成は backend helper/route-level と web model/component-levelの現実的な範囲で選んでよい。
|
||||
|
||||
Escalate if:
|
||||
- credential/clone/fetch/write operation、Runtime materialization、Execution Workspace 作成、multi-workspace store 移行、Ticket target からの RepositoryPoint 解決が必要になる場合。
|
||||
- credential/clone/fetch/write operation、Runtime materialization、working directory 作成、multi-workspace store 移行、Ticket target からの RepositoryPoint 解決が必要になる場合。
|
||||
- Browser-facing API に secret/auth ref/internal absolute paths を出さないと実装できない場合。
|
||||
- `RepositorySelector` / `RepositoryPoint` の概念境界を設計変更する必要が出た場合。
|
||||
|
||||
|
||||
@@ -1 +1 @@
|
||||
{"id":"orch-plan-20260706-182951-1","ticket_id":"00001KWW9DYH4","kind":"accepted_plan","accepted_plan":{"summary":"Ticket 00001KWW9DYH4 は独立 queued Ticket で blocker なし。Repository registry の次段として、local Git configured repository から Runtime root 配下に Worker ごとの detached Execution Workspace を materialize する v0 を実装する。human authorized routing 済みのため queued->inprogress acceptance 後に worktree + coder/reviewer loop へ進める。","branch":"work/00001KWW9DYH4-execution-workspace-materializer","worktree":"/home/hare/Projects/yoi/.worktree/00001KWW9DYH4-execution-workspace-materializer","role_plan":"単一 sibling Coder Pod に implementation worktree を委譲し、worker-runtime の Execution Workspace materialization boundary / local Git detached worktree allocation / cleanup evidence / tests を実装する。完了後、別 sibling Reviewer Pod で Ticket IntentPacket / Objective boundary / acceptance criteria に照らして read-only review する。"},"author":"orchestrator","at":"2026-07-06T18:29:51Z"}
|
||||
{"id":"orch-plan-20260706-182951-1","ticket_id":"00001KWW9DYH4","kind":"accepted_plan","accepted_plan":{"summary":"Ticket 00001KWW9DYH4 は独立 queued Ticket で blocker なし。Repository registry の次段として、local Git configured repository から Runtime root 配下に Worker ごとの detached working directory を materialize する v0 を実装する。human authorized routing 済みのため queued->inprogress acceptance 後に worktree + coder/reviewer loop へ進める。","branch":"work/00001KWW9DYH4-execution-workspace-materializer","worktree":"/home/hare/Projects/yoi/.worktree/00001KWW9DYH4-execution-workspace-materializer","role_plan":"単一 sibling Coder Pod に implementation worktree を委譲し、worker-runtime の working directory materialization boundary / local Git detached worktree allocation / cleanup evidence / tests を実装する。完了後、別 sibling Reviewer Pod で Ticket IntentPacket / Objective boundary / acceptance criteria に照らして read-only review する。"},"author":"orchestrator","at":"2026-07-06T18:29:51Z"}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: 'Add local Git worktree Execution Workspace materializer'
|
||||
title: 'Add local Git worktree working directory materializer'
|
||||
state: 'closed'
|
||||
created_at: '2026-07-06T18:00:46Z'
|
||||
updated_at: '2026-07-06T19:24:25Z'
|
||||
@@ -10,29 +10,29 @@ queued_at: '2026-07-06T18:28:26Z'
|
||||
|
||||
## 背景
|
||||
|
||||
現在の Runtime は `--workspace` で与えられた単一 root を Worker の workspace scope として使っている。そのため、同じ repository root を使う Worker を複数 spawn すると worker allocation conflict が起きる。また、Runtime が source repository root を直接 Worker に渡しており、Execution Workspace materialization / cleanup / evidence / sandbox の境界がまだない。
|
||||
現在の Runtime は `--workspace` で与えられた単一 root を Worker の workspace scope として使っている。そのため、同じ repository root を使う Worker を複数 spawn すると worker allocation conflict が起きる。また、Runtime が source repository root を直接 Worker に渡しており、working directory materialization / cleanup / evidence / sandbox の境界がまだない。
|
||||
|
||||
Objective `00001KWW44EXK` では、Runtime が RepositoryPoint から Worker ごとの Execution Workspace を materialize し、Worker は source repository root ではなく materialized workspace を scope として起動する方針を定めた。この Ticket ではその v0 として、remote/cache-backed Git clone は扱わず、Repository `uri` が local Git repository を指し、そこから `git worktree add --detach` できる前提で最小の materializer を実装する。
|
||||
Objective `00001KWW44EXK` では、Runtime が RepositoryPoint から Worker ごとの working directory を materialize し、Worker は source repository root ではなく materialized workspace を scope として起動する方針を定めた。この Ticket ではその v0 として、remote/cache-backed Git clone は扱わず、Repository `uri` が local Git repository を指し、そこから `git worktree add --detach` できる前提で最小の materializer を実装する。
|
||||
|
||||
ローカル origin の Git clone / Runtime repository-cache / bare mirror cache はこの Ticket では非目標とする。v0 は local source repository 自体を source cache 相当として扱い、Runtime root 配下に Worker ごとの detached worktree を作る。
|
||||
|
||||
## 要件
|
||||
|
||||
- Runtime は Worker spawn 前に Execution Workspace materializer を呼ぶ境界を持つ。
|
||||
- Runtime は Worker spawn 前に working directory materializer を呼ぶ境界を持つ。
|
||||
- v0 materializer は configured local Git repository から detached worktree を Runtime root 配下に作る。
|
||||
- Worker は source repository root ではなく、materialized worktree path を workspace scope / cwd として起動する。
|
||||
- `RepositoryId` / `RepositorySelector` / resolved `RepositoryPoint` の将来境界を壊さない型にする。
|
||||
- この Ticket では local URI の Git repository のみ対応する。remote URI、bare mirror cache、clone/fetch、credential resolution は扱わない。
|
||||
- worktree は branch 名ではなく resolved commit に対する detached worktree として作る。v0 では branch を作らず、Worker の変更は detached worktree 上の diff / patch artifact として回収する。branch 作成は後続の merge/export policy として扱う。
|
||||
- dirty local changes は暗黙に含めない。v0 は `clean_point_only` とし、必要なら dirty state diagnostic を返す。
|
||||
- Execution Workspace は `.yoi` や Backend workspace store ではなく Runtime root 配下に作る。
|
||||
- working directory は `.yoi` や Backend workspace store ではなく Runtime root 配下に作る。
|
||||
- Worker stop / cleanup 時に worktree cleanup できる方針または最低限の cleanup record を持つ。
|
||||
- Browser-facing/API-facing diagnostics は raw host path を不必要に漏らさない。
|
||||
|
||||
## 受け入れ条件
|
||||
|
||||
- `CreateWorkerRequest` または Runtime-side spawn path に Execution Workspace materialization request / allocation 境界が追加されている。
|
||||
- local Git repository `uri = "."` 相当から resolved commit を取得し、Runtime root 配下の `execution-workspaces/<allocation-id>/root/<repository-id>` に `git worktree add --detach` できる。
|
||||
- `CreateWorkerRequest` または Runtime-side spawn path に working directory materialization request / allocation 境界が追加されている。
|
||||
- local Git repository `uri = "."` 相当から resolved commit を取得し、Runtime root 配下の `working-directories/<allocation-id>/root/<repository-id>` に `git worktree add --detach` できる。
|
||||
- Worker 用の Git branch は v0 materialization では作成されず、変更回収は detached worktree の diff / patch artifact として扱われる。
|
||||
- Worker spawn 時、Worker scope/cwd は source repository root ではなく materialized worktree を指す。
|
||||
- 同じ local Git repository を対象に複数 Worker を spawn しても、source root scope の allocation conflict で失敗しない。
|
||||
|
||||
@@ -1,19 +1,19 @@
|
||||
完了。
|
||||
|
||||
実装内容:
|
||||
- Runtime-side Execution Workspace materialization boundary を追加した。
|
||||
- v0 local Git materializer として、configured repository から resolved commit / tree evidence を取り、Runtime root 配下 `execution-workspaces/<allocation-id>/root/<repository-id>` に detached Git worktree を作成するようにした。
|
||||
- Runtime-side working directory materialization boundary を追加した。
|
||||
- v0 local Git materializer として、configured repository から resolved commit / tree evidence を取り、Runtime root 配下 `working-directories/<allocation-id>/root/<repository-id>` に detached Git worktree を作成するようにした。
|
||||
- Worker spawn 時の workspace root / cwd / scope は source repository root ではなく materialized worktree path を使うようにした。
|
||||
- 同一 source repository に対する複数 Worker が distinct materialized paths を使えるようにした。
|
||||
- dirty source state は `clean_point_only` policy で拒否し、remote URI / non-Git provider / unsupported policy は typed diagnostics で fail closed するようにした。
|
||||
- allocation evidence / cleanup target / cleanup policy / status を記録し、Worker stop cleanup hook で worktree cleanup と record update を行うようにした。
|
||||
- Browser/API-facing spawn boundary は raw `ExecutionWorkspaceRequest` / `local_path` を受け取らないようにし、safe `repository_id` / optional `selector` から host/server 内部で materialization request を構築するようにした。
|
||||
- Browser/API-facing spawn boundary は raw `WorkingDirectoryRequest` / `local_path` を受け取らないようにし、safe `repository_id` / optional `selector` から host/server 内部で materialization request を構築するようにした。
|
||||
- Focused worker-runtime / workspace-server tests を追加した。
|
||||
|
||||
主な commit / merge:
|
||||
- implementation: `8b7a5da0 feat: materialize execution workspaces`
|
||||
- review fix: `c90ebf24 fix: keep execution workspace paths internal`
|
||||
- merge into orchestration: `c4cdf1c3 merge: execution workspace materializer`
|
||||
- implementation: `8b7a5da0 feat: materialize working directories`
|
||||
- review fix: `c90ebf24 fix: keep working directory paths internal`
|
||||
- merge into orchestration: `c4cdf1c3 merge: working directory materializer`
|
||||
|
||||
Review:
|
||||
- 初回 external review は request_changes。
|
||||
|
||||
@@ -39,15 +39,15 @@ Ticket を `workspace-panel` が queued にしました。
|
||||
Routing decision: implementation_ready
|
||||
|
||||
Reason:
|
||||
- Ticket は local Git worktree Execution Workspace materializer の v0 範囲、非目標、acceptance criteria が具体化されている。
|
||||
- Objective `00001KWW44EXK` の境界（Runtime root / Execution Workspace / RepositoryPoint / materialization strategy / cleanup registry / dirty state policy）と整合している。
|
||||
- Ticket は local Git worktree working directory materializer の v0 範囲、非目標、acceptance criteria が具体化されている。
|
||||
- Objective `00001KWW44EXK` の境界（Runtime root / working directory / RepositoryPoint / materialization strategy / cleanup registry / dirty state policy）と整合している。
|
||||
- `remote URI`, clone/fetch/cache, credential resolution, CoW/sandbox 強化、dirty snapshot/apply は非目標として明確。
|
||||
- typed relation blocker は 0 件、OrchestrationPlan record は 0 件。
|
||||
- queued notification は human authorized routing であり、今回の routing acceptance 後にのみ implementation side effect へ進める。
|
||||
|
||||
Evidence checked:
|
||||
- Ticket body / thread / artifacts。
|
||||
- Objective `00001KWW44EXK` body（Runtime execution workspace materialization direction, Runtime root separation, detached worktree strategy, clean point policy, cleanup registry）。
|
||||
- Objective `00001KWW44EXK` body（Runtime working directory materialization direction, Runtime root separation, detached worktree strategy, clean point policy, cleanup registry）。
|
||||
- `TicketRelationQuery(00001KWW9DYH4)`: 0 件。
|
||||
- `TicketOrchestrationPlanQuery(00001KWW9DYH4)`: 0 件。
|
||||
- Orchestrator worktree git status: clean on `orchestration`。
|
||||
@@ -59,11 +59,11 @@ Evidence checked:
|
||||
IntentPacket:
|
||||
|
||||
Intent:
|
||||
- Runtime Worker spawn の直前に Execution Workspace materialization boundary を追加し、configured local Git repository から Worker ごとの detached worktree を Runtime root 配下に作る v0 materializer を実装する。
|
||||
- Runtime Worker spawn の直前に working directory materialization boundary を追加し、configured local Git repository から Worker ごとの detached worktree を Runtime root 配下に作る v0 materializer を実装する。
|
||||
- Worker の workspace scope / cwd を source repository root ではなく materialized worktree path にすることで、同じ local Git repository を対象に複数 Worker を spawn しても source root scope allocation conflict で失敗しないようにする。
|
||||
|
||||
Binding decisions / invariants:
|
||||
- Execution Workspace は `.yoi` / Backend workspace store ではなく Runtime root 配下に作る。
|
||||
- working directory は `.yoi` / Backend workspace store ではなく Runtime root 配下に作る。
|
||||
- v0 は local Git repository URI のみ対応する。remote URI / non-Git provider / clone/fetch/cache / credentials は typed diagnostic で拒否または非対応扱い。
|
||||
- worktree は branch 名ではなく resolved commit に対する detached worktree として作る。v0 materialization では Worker 用 branch を作らない。
|
||||
- dirty local changes は暗黙に含めない。v0 は `clean_point_only` とし、dirty state は typed diagnostic / test evidence で明示する。
|
||||
@@ -73,8 +73,8 @@ Binding decisions / invariants:
|
||||
- `RepositoryId` / `RepositorySelector` / `RepositoryPoint` の将来境界を壊さず、Git branch/tag/hash 固定の抽象にしない。
|
||||
|
||||
Requirements / acceptance criteria:
|
||||
- `CreateWorkerRequest` または Runtime-side spawn path に Execution Workspace materialization request / allocation 境界が追加されている。
|
||||
- local Git repository `uri = "."` 相当から resolved commit を取得し、Runtime root 配下の `execution-workspaces/<allocation-id>/root/<repository-id>` に `git worktree add --detach` できる。
|
||||
- `CreateWorkerRequest` または Runtime-side spawn path に working directory materialization request / allocation 境界が追加されている。
|
||||
- local Git repository `uri = "."` 相当から resolved commit を取得し、Runtime root 配下の `working-directories/<allocation-id>/root/<repository-id>` に `git worktree add --detach` できる。
|
||||
- Worker spawn 時の scope/cwd は source repository root ではなく materialized worktree を指す。
|
||||
- 同じ local Git repository を対象に複数 Worker を spawn しても source root scope conflict で失敗しない。
|
||||
- unsupported non-local URI / non-Git provider は typed diagnostic。
|
||||
@@ -124,7 +124,7 @@ Queued acceptance recorded after Workspace Dashboard Queue notification authoriz
|
||||
|
||||
Checked context:
|
||||
- Ticket body / thread / artifacts。
|
||||
- Objective `00001KWW44EXK` の Execution Workspace materialization strategy / dirty policy / Runtime root separation / cleanup registry context。
|
||||
- Objective `00001KWW44EXK` の working directory materialization strategy / dirty policy / Runtime root separation / cleanup registry context。
|
||||
- `TicketRelationQuery(00001KWW9DYH4)`: blocking relation 0 件。
|
||||
- `TicketOrchestrationPlanQuery(00001KWW9DYH4)`: prior record 0 件。今回 accepted_plan を記録済み。
|
||||
- Orchestrator worktree git status: clean on `orchestration`。
|
||||
@@ -161,22 +161,22 @@ Implementation routing update:
|
||||
|
||||
Implementation progress report:
|
||||
|
||||
- Coder Pod completed implementation and committed `8b7a5da0 feat: materialize execution workspaces` on branch `work/00001KWW9DYH4-execution-workspace-materializer`.
|
||||
- Coder Pod completed implementation and committed `8b7a5da0 feat: materialize working directories` on branch `work/00001KWW9DYH4-execution-workspace-materializer`.
|
||||
- Worktree status was clean after commit.
|
||||
- Changed files include:
|
||||
- `crates/worker-runtime/src/execution_workspace.rs` (new)
|
||||
- `crates/worker-runtime/src/working_directory.rs` (new)
|
||||
- `crates/worker-runtime/src/{catalog.rs,execution.rs,http_server.rs,lib.rs,main.rs,runtime.rs,worker_backend.rs}`
|
||||
- `crates/workspace-server/src/{companion.rs,hosts.rs,server.rs}`
|
||||
- Implementation summary:
|
||||
- Runtime-side Execution Workspace request/status types and local Git worktree materializer。
|
||||
- detached Git worktree creation under Runtime root: `execution-workspaces/<allocation-id>/root/<repository-id>`。
|
||||
- Runtime-side working directory request/status types and local Git worktree materializer。
|
||||
- detached Git worktree creation under Runtime root: `working-directories/<allocation-id>/root/<repository-id>`。
|
||||
- clean HEAD/selector commit and tree evidence resolution。
|
||||
- dirty source rejection under `clean_point_only`。
|
||||
- typed diagnostics for remote URI / non-Git provider / unsupported policy。
|
||||
- materialization/cleanup evidence persistence and best-effort worktree cleanup on Worker stop。
|
||||
- Worker spawn cwd/scope uses materialized worktree path, not source repository root。
|
||||
- workspace-server embedded runtime startup and Worker spawn pass configured repositories into materialization request。
|
||||
- API-facing execution workspace status summaries remain sanitized/path-free。
|
||||
- API-facing working directory status summaries remain sanitized/path-free。
|
||||
- Orchestrator reran validation in the implementation worktree:
|
||||
- `git diff --check`: pass
|
||||
- `cargo test -p worker-runtime --features ws-server,fs-store`: pass（34 lib tests + 5 main tests + doc tests）
|
||||
@@ -197,16 +197,16 @@ Implementation progress report:
|
||||
External review result: request_changes
|
||||
|
||||
Blocker:
|
||||
- 実装が Browser/API-facing spawn boundary を広げ、API caller から full `ExecutionWorkspaceRequest`（`ExecutionWorkspaceRepository.local_path: Option<PathBuf>` を含む）を受け取れる形になっている。
|
||||
- `crates/workspace-server/src/hosts.rs:263-283` は `WorkerSpawnRequest` を browser-safe として raw workspace roots/storage paths を受け取らない契約にしているが、現在は `execution_workspace: Option<ExecutionWorkspaceRequest>` を含む。
|
||||
- 実装が Browser/API-facing spawn boundary を広げ、API caller から full `WorkingDirectoryRequest`（`WorkingDirectoryRepository.local_path: Option<PathBuf>` を含む）を受け取れる形になっている。
|
||||
- `crates/workspace-server/src/hosts.rs:263-283` は `WorkerSpawnRequest` を browser-safe として raw workspace roots/storage paths を受け取らない契約にしているが、現在は `working_directory: Option<WorkingDirectoryRequest>` を含む。
|
||||
- `crates/worker-runtime/src/catalog.rs:58-66` の request は raw `local_path` を運べる。
|
||||
- `/api/runtimes/{runtime_id}/workers` はこの request shape を受け取り、embedded/remote host spawn path が `CreateWorkerRequest` に pass-through している。
|
||||
- これは Ticket / routing invariant の「raw source/internal paths を含む public launch boundary 拡張を避ける。必要なら escalate」に反し、既存コード上の browser-safe contract とも衝突している。
|
||||
- safer `/api/workers` path は server-side repository config から `repository_id` により解決しているため、generic API も caller-supplied raw `local_path` authority を受け取らない形にするか、Execution Workspace materialization request の組み立てを host/runtime 内部境界に閉じる必要がある。
|
||||
- safer `/api/workers` path は server-side repository config から `repository_id` により解決しているため、generic API も caller-supplied raw `local_path` authority を受け取らない形にするか、working directory materialization request の組み立てを host/runtime 内部境界に閉じる必要がある。
|
||||
|
||||
Evidence supporting the rest of the implementation:
|
||||
- Runtime/backend materialization boundary は存在する。`Runtime::create_worker` が request を backend に渡し、`WorkerRuntimeExecutionBackend::spawn_worker` が spawn 前に materializer を呼ぶ。
|
||||
- local materializer は `execution-workspaces/<allocation-id>/root/<repository-id>` 配下に resolved commit の detached worktree を作成し、branch checkout はしない。
|
||||
- local materializer は `working-directories/<allocation-id>/root/<repository-id>` 配下に resolved commit の detached worktree を作成し、branch checkout はしない。
|
||||
- Worker `workspace_root` / `cwd` は `Worker::from_manifest_with_context` 前に materialized binding に差し替えられている。
|
||||
- dirty source は `clean_point_only` で拒否され、remote/non-Git は typed diagnostic code を返す。
|
||||
- allocation evidence/status/cleanup target/policy は記録・永続化され、worker stop cleanup は worktree removal / cleanup-pending 更新を行う。
|
||||
@@ -228,15 +228,15 @@ Non-blocking follow-ups:
|
||||
|
||||
Review-fix implementation report:
|
||||
|
||||
- Coder Pod completed requested changes and committed follow-up `c90ebf24 fix: keep execution workspace paths internal` on branch `work/00001KWW9DYH4-execution-workspace-materializer`.
|
||||
- Coder Pod completed requested changes and committed follow-up `c90ebf24 fix: keep working directory paths internal` on branch `work/00001KWW9DYH4-execution-workspace-materializer`.
|
||||
- Worktree status was clean after commit.
|
||||
- Fix summary:
|
||||
- Browser/API-facing `WorkerSpawnRequest` no longer deserializes full `ExecutionWorkspaceRequest` or caller-supplied raw `local_path`.
|
||||
- Added browser-safe execution workspace request shape with `repository_id` and optional `selector` only。
|
||||
- Added `deny_unknown_fields` so raw fields such as `execution_workspace.local_path` and unexpected fields are rejected at the API boundary。
|
||||
- Server-side host code resolves configured repository registry into internal `ExecutionWorkspaceRequest`; raw `local_path` construction stays behind trusted host/server boundary。
|
||||
- Browser/API-facing `WorkerSpawnRequest` no longer deserializes full `WorkingDirectoryRequest` or caller-supplied raw `local_path`.
|
||||
- Added browser-safe working directory request shape with `repository_id` and optional `selector` only。
|
||||
- Added `deny_unknown_fields` so raw fields such as `working_directory.local_path` and unexpected fields are rejected at the API boundary。
|
||||
- Server-side host code resolves configured repository registry into internal `WorkingDirectoryRequest`; raw `local_path` construction stays behind trusted host/server boundary。
|
||||
- Existing `/api/workers` repository-id safe behavior remains preserved。
|
||||
- Added focused API tests for rejecting raw `execution_workspace.local_path` and accepting safe repository-id/selector materialization without exposing raw workspace path。
|
||||
- Added focused API tests for rejecting raw `working_directory.local_path` and accepting safe repository-id/selector materialization without exposing raw workspace path。
|
||||
- Orchestrator reran validation in the implementation worktree:
|
||||
- `git diff --check`: pass
|
||||
- `cargo test -p worker-runtime --features ws-server,fs-store`: pass（34 lib tests + 5 main tests + doc tests）
|
||||
@@ -263,15 +263,15 @@ Evidence reviewed:
|
||||
- Fix commit `c90ebf24` and combined implementation after `8b7a5da0`。
|
||||
|
||||
Findings:
|
||||
- Prior blocker is resolved. Browser/API `WorkerSpawnRequest` now exposes only `execution_workspace: { repository_id, selector? }` via `WorkerSpawnExecutionWorkspaceRequest` with `deny_unknown_fields`; internal `resolved_execution_workspace` is `#[serde(skip, default)]`。
|
||||
- `/api/runtimes/{runtime_id}/workers` resolves safe repository id/selector server-side from configured repositories into an internal `ExecutionWorkspaceRequest`。
|
||||
- Prior blocker is resolved. Browser/API `WorkerSpawnRequest` now exposes only `working_directory: { repository_id, selector? }` via `WorkerSpawnWorkingDirectoryRequest` with `deny_unknown_fields`; internal `resolved_working_directory` is `#[serde(skip, default)]`。
|
||||
- `/api/runtimes/{runtime_id}/workers` resolves safe repository id/selector server-side from configured repositories into an internal `WorkingDirectoryRequest`。
|
||||
- `/api/workers` remains safe: `BrowserCreateWorkerRequest` only accepts optional `repository_id`; server-side code builds the internal request。
|
||||
- Fix tests explicitly reject caller-supplied `local_path` and accept safe `repository_id`/`selector`, with response path redaction asserted。
|
||||
- Response/status projections remain browser-safe: execution workspace summaries carry ids/commit/tree/cleanup metadata, not raw workspace/source paths。
|
||||
- Response/status projections remain browser-safe: working directory summaries carry ids/commit/tree/cleanup metadata, not raw workspace/source paths。
|
||||
- Original materializer acceptance remains satisfied:
|
||||
- local Git only, remote/non-Git/dirty source rejected with typed diagnostics。
|
||||
- selector resolves to commit/tree。
|
||||
- detached `git worktree add --detach` is created under Runtime root `execution-workspaces/<allocation-id>/root/<repository-id>`。
|
||||
- detached `git worktree add --detach` is created under Runtime root `working-directories/<allocation-id>/root/<repository-id>`。
|
||||
- worker factory uses materialized workspace root/cwd instead of source root。
|
||||
- allocation evidence and cleanup target are recorded。
|
||||
- cleanup hook removes worktree and updates record。
|
||||
@@ -296,7 +296,7 @@ No merge-blocking issues found.
|
||||
Merge/validation acceptance:
|
||||
|
||||
- Follow-up external review approved the implementation after blocker fix。
|
||||
- Implementation branch `work/00001KWW9DYH4-execution-workspace-materializer` was merged into the orchestration branch with merge commit `c4cdf1c3 merge: execution workspace materializer`。
|
||||
- Implementation branch `work/00001KWW9DYH4-execution-workspace-materializer` was merged into the orchestration branch with merge commit `c4cdf1c3 merge: working directory materializer`。
|
||||
- Final validation in Orchestrator worktree passed:
|
||||
- `git diff --check`: pass
|
||||
- `cargo test -p worker-runtime --features ws-server,fs-store`: pass（34 lib tests + 5 main tests + doc tests）
|
||||
@@ -308,8 +308,8 @@ Merge/validation acceptance:
|
||||
- `nix build .#yoi --no-link` は Cargo.lock / dependency / resource packaging / Nix 変更ではないため未実行。
|
||||
|
||||
Implementation commits:
|
||||
- `8b7a5da0 feat: materialize execution workspaces`
|
||||
- `c90ebf24 fix: keep execution workspace paths internal`
|
||||
- `8b7a5da0 feat: materialize working directories`
|
||||
- `c90ebf24 fix: keep working directory paths internal`
|
||||
|
||||
No merge-blocking issues remain.
|
||||
|
||||
@@ -331,19 +331,19 @@ Ticket を closed にしました。
|
||||
完了。
|
||||
|
||||
実装内容:
|
||||
- Runtime-side Execution Workspace materialization boundary を追加した。
|
||||
- v0 local Git materializer として、configured repository から resolved commit / tree evidence を取り、Runtime root 配下 `execution-workspaces/<allocation-id>/root/<repository-id>` に detached Git worktree を作成するようにした。
|
||||
- Runtime-side working directory materialization boundary を追加した。
|
||||
- v0 local Git materializer として、configured repository から resolved commit / tree evidence を取り、Runtime root 配下 `working-directories/<allocation-id>/root/<repository-id>` に detached Git worktree を作成するようにした。
|
||||
- Worker spawn 時の workspace root / cwd / scope は source repository root ではなく materialized worktree path を使うようにした。
|
||||
- 同一 source repository に対する複数 Worker が distinct materialized paths を使えるようにした。
|
||||
- dirty source state は `clean_point_only` policy で拒否し、remote URI / non-Git provider / unsupported policy は typed diagnostics で fail closed するようにした。
|
||||
- allocation evidence / cleanup target / cleanup policy / status を記録し、Worker stop cleanup hook で worktree cleanup と record update を行うようにした。
|
||||
- Browser/API-facing spawn boundary は raw `ExecutionWorkspaceRequest` / `local_path` を受け取らないようにし、safe `repository_id` / optional `selector` から host/server 内部で materialization request を構築するようにした。
|
||||
- Browser/API-facing spawn boundary は raw `WorkingDirectoryRequest` / `local_path` を受け取らないようにし、safe `repository_id` / optional `selector` から host/server 内部で materialization request を構築するようにした。
|
||||
- Focused worker-runtime / workspace-server tests を追加した。
|
||||
|
||||
主な commit / merge:
|
||||
- implementation: `8b7a5da0 feat: materialize execution workspaces`
|
||||
- review fix: `c90ebf24 fix: keep execution workspace paths internal`
|
||||
- merge into orchestration: `c4cdf1c3 merge: execution workspace materializer`
|
||||
- implementation: `8b7a5da0 feat: materialize working directories`
|
||||
- review fix: `c90ebf24 fix: keep working directory paths internal`
|
||||
- merge into orchestration: `c4cdf1c3 merge: working directory materializer`
|
||||
|
||||
Review:
|
||||
- 初回 external review は request_changes。
|
||||
|
||||
@@ -51,7 +51,7 @@ Evidence checked:
|
||||
- `TicketOrchestrationPlanQuery(00001KWWE8E04)`: 0 件。
|
||||
- Orchestrator worktree git status: clean on `orchestration`。
|
||||
- queued Ticket 一覧: この Ticket 1件のみ。inprogress は 0 件。
|
||||
- visible Pods: previous execution-workspace child Pods が idle で残っているが、`StopPod` 不使用方針のため停止せず、新規 unique Pod を使う。capacity blocker ではない。
|
||||
- visible Pods: previous working-directory child Pods が idle で残っているが、`StopPod` 不使用方針のため停止せず、新規 unique Pod を使う。capacity blocker ではない。
|
||||
- `TicketDoctor`: 0 errors / 既存 diagnostics のみ。
|
||||
- Bounded code map: `crates/workspace-server/src/{identity.rs,server.rs,hosts.rs,config.rs,records.rs,repositories.rs}`, `web/workspace/src/routes/**`, `web/workspace/src/lib/workspace-sidebar/**`, workspace settings/sidebar/console helpers。
|
||||
|
||||
|
||||
@@ -1 +1 @@
|
||||
{"id":"orch-plan-20260707-134133-1","ticket_id":"00001KWY8EHEJ","kind":"accepted_plan","accepted_plan":{"summary":"Ticket 00001KWY8EHEJ は独立 queued Ticket で blocker なし。先行 Runtime materializer と workspace-id scoped API を前提に、Browser-managed pre-allocated Execution Workspace を Worker spawn に接続する。human authorized routing 済みのため queued->inprogress acceptance 後に worktree + coder/reviewer loop へ進める。","branch":"work/00001KWY8EHEJ-browser-execution-workspaces","worktree":"/home/hare/Projects/yoi/.worktree/00001KWY8EHEJ-browser-execution-workspaces","role_plan":"単一 sibling Coder Pod に implementation worktree を委譲し、workspace-scoped Browser-managed Execution Workspace API / Worker launch UI integration / allocation-id spawn connection / relative_cwd validation / cleanup/status tests を実装する。完了後、別 sibling Reviewer Pod で Ticket IntentPacket / authority boundary / acceptance criteria に照らして read-only review する。"},"author":"orchestrator","at":"2026-07-07T13:41:33Z"}
|
||||
{"id":"orch-plan-20260707-134133-1","ticket_id":"00001KWY8EHEJ","kind":"accepted_plan","accepted_plan":{"summary":"Ticket 00001KWY8EHEJ は独立 queued Ticket で blocker なし。先行 Runtime materializer と workspace-id scoped API を前提に、Browser-managed pre-allocated working directory を Worker spawn に接続する。human authorized routing 済みのため queued->inprogress acceptance 後に worktree + coder/reviewer loop へ進める。","branch":"work/00001KWY8EHEJ-browser-working-directories","worktree":"/home/hare/Projects/yoi/.worktree/00001KWY8EHEJ-browser-working-directories","role_plan":"単一 sibling Coder Pod に implementation worktree を委譲し、workspace-scoped Browser-managed working directory API / Worker launch UI integration / allocation-id spawn connection / relative_cwd validation / cleanup/status tests を実装する。完了後、別 sibling Reviewer Pod で Ticket IntentPacket / authority boundary / acceptance criteria に照らして read-only review する。"},"author":"orchestrator","at":"2026-07-07T13:41:33Z"}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: 'Enable Browser-managed execution workspaces for Worker spawn'
|
||||
title: 'Enable Browser-managed working directories for Worker spawn'
|
||||
state: 'closed'
|
||||
created_at: '2026-07-07T12:22:06Z'
|
||||
updated_at: '2026-07-07T14:58:35Z'
|
||||
@@ -10,31 +10,31 @@ queued_at: '2026-07-07T13:40:23Z'
|
||||
|
||||
## 背景
|
||||
|
||||
Runtime 側には `CreateWorkerRequest.execution_workspace` と local Git worktree materializer があり、Worker 作成時に RepositoryPoint 相当の入力から detached worktree を materialize して Worker の workspace/cwd/scope にする境界が既にある。一方、Browser UI からは作業環境を事前に用意・確認し、それを Worker spawn 操作で選択する経路がまだ無い。
|
||||
Runtime 側には `CreateWorkerRequest.working_directory` と local Git worktree materializer があり、Worker 作成時に RepositoryPoint 相当の入力から detached worktree を materialize して Worker の workspace/cwd/scope にする境界が既にある。一方、Browser UI からは作業環境を事前に用意・確認し、それを Worker spawn 操作で選択する経路がまだ無い。
|
||||
|
||||
Browser から raw host path や内部 materialization request を直接指定させるのではなく、Workspace Backend が repository / selector / policy を検証して Execution Workspace を作成し、Browser には allocation id と安全な summary だけを返す形にする。
|
||||
Browser から raw host path や内部 materialization request を直接指定させるのではなく、Workspace Backend が repository / selector / policy を検証して working directory を作成し、Browser には allocation id と安全な summary だけを返す形にする。
|
||||
|
||||
## 要件
|
||||
|
||||
- Browser-facing API で Execution Workspace を作成・一覧・詳細確認できる。
|
||||
- Browser-facing API で working directory を作成・一覧・詳細確認できる。
|
||||
- v0 の materializer は既存方針どおり local Git repository からの detached worktree とし、remote clone/cache や dirty source inclusion は扱わない。
|
||||
- Browser-facing payload に backend-private absolute path、raw materialization request、内部 runtime path を露出しない。
|
||||
- Worker spawn form/API から、作成済み Execution Workspace を選択して Worker 作成に利用できる。
|
||||
- Worker spawn form/API から、作成済み working directory を選択して Worker 作成に利用できる。
|
||||
- Worker が利用する cwd 指定は host absolute path ではなく、materialized workspace root からの安全な `relative_cwd` として扱う。
|
||||
- `relative_cwd` は absolute path、`..` escape、symlink escape、存在しない/不正な working directory を拒否する。
|
||||
- Worker detail / list には execution workspace の safe summary を表示する。
|
||||
- Worker detail / list には working directory の safe summary を表示する。
|
||||
- cleanup policy と手動 cleanup 操作の v0 方針を明示する。
|
||||
|
||||
## 受け入れ条件
|
||||
|
||||
- `POST /api/w/<workspace-id>/execution-workspaces` 相当の API で configured repository と selector から Execution Workspace を作成できる。
|
||||
- `GET /api/w/<workspace-id>/execution-workspaces` 相当の API で作成済み Execution Workspace の safe summary を一覧できる。
|
||||
- Worker launch UI で Execution Workspace を選択でき、spawn request が raw path ではなく safe id/selector 情報を送る。
|
||||
- Worker spawn 時に選択した Execution Workspace が Runtime の `CreateWorkerRequest.execution_workspace` または同等の backend-resolved request に接続される。
|
||||
- `POST /api/w/<workspace-id>/working-directories` 相当の API で configured repository と selector から working directory を作成できる。
|
||||
- `GET /api/w/<workspace-id>/working-directories` 相当の API で作成済み working directory の safe summary を一覧できる。
|
||||
- Worker launch UI で working directory を選択でき、spawn request が raw path ではなく safe id/selector 情報を送る。
|
||||
- Worker spawn 時に選択した working directory が Runtime の `CreateWorkerRequest.working_directory` または同等の backend-resolved request に接続される。
|
||||
- 作成された Worker の workspace/cwd/scope が materialized worktree 配下になり、Browser/API には内部 path が漏れない。
|
||||
- 不正な repository、dirty unsupported source、remote unsupported source、invalid `relative_cwd` は typed diagnostic として拒否される。
|
||||
- frontend check/test、workspace-server tests、`yoi ticket doctor`、`nix build .#yoi` が通る。
|
||||
|
||||
## 設計メモ
|
||||
|
||||
初期実装は pre-allocate 方式を優先する。つまり Browser で Execution Workspace を明示的に作成し、Worker spawn では `allocation_id` と任意の `relative_cwd` を選択する。単発 spawn request だけで暗黙 materialize する経路は、UI/cleanup/diagnostics が固まるまで後回しにする。
|
||||
初期実装は pre-allocate 方式を優先する。つまり Browser で working directory を明示的に作成し、Worker spawn では `allocation_id` と任意の `relative_cwd` を選択する。単発 spawn request だけで暗黙 materialize する経路は、UI/cleanup/diagnostics が固まるまで後回しにする。
|
||||
|
||||
@@ -1,24 +1,24 @@
|
||||
完了。
|
||||
|
||||
実装内容:
|
||||
- Browser-managed Execution Workspace API を scoped Workspace API に追加した。
|
||||
- `POST /api/w/<workspace-id>/execution-workspaces`
|
||||
- `GET /api/w/<workspace-id>/execution-workspaces`
|
||||
- Browser-managed working directory API を scoped Workspace API に追加した。
|
||||
- `POST /api/w/<workspace-id>/working-directories`
|
||||
- `GET /api/w/<workspace-id>/working-directories`
|
||||
- detail / cleanup endpoint
|
||||
- Browser create payload は configured `repository_id` / selector / policy を使い、raw host path / raw internal `ExecutionWorkspaceRequest` / internal runtime path を受け取らないようにした。
|
||||
- Browser create payload は configured `repository_id` / selector / policy を使い、raw host path / raw internal `WorkingDirectoryRequest` / internal runtime path を受け取らないようにした。
|
||||
- Browser response は allocation id、repository id、selector/commit evidence、status、cleanup policy など safe summary のみを返すようにした。
|
||||
- Worker launch UI で Execution Workspace を create/select できるようにした。
|
||||
- Worker launch UI で working directory を create/select できるようにした。
|
||||
- Worker spawn は selected allocation id + optional `relative_cwd` を使い、Runtime materialized workspace に接続するようにした。
|
||||
- `relative_cwd` は materialized root 相対として検証し、absolute path、`..` escape、symlink escape、nonexistent / non-directory を拒否するようにした。
|
||||
- invalid `relative_cwd` は Browser-facing API で typed `execution_workspace_relative_cwd_*` diagnostic として返るようにした。
|
||||
- Worker list/detail に execution workspace safe summary を含めた。
|
||||
- invalid `relative_cwd` は Browser-facing API で typed `working_directory_relative_cwd_*` diagnostic として返るようにした。
|
||||
- Worker list/detail に working directory safe summary を含めた。
|
||||
- cleanup は allocation root に bounded され、typed/sanitized diagnostic を返すようにした。
|
||||
- Focused backend/runtime/web tests を追加した。
|
||||
|
||||
主な commit / merge:
|
||||
- implementation: `684b19e8 feat: add browser execution workspaces`
|
||||
- review fix: `9adb0fae fix: preserve execution workspace cwd diagnostics`
|
||||
- merge into orchestration: `b52986e5 merge: browser execution workspaces`
|
||||
- implementation: `684b19e8 feat: add browser working directories`
|
||||
- review fix: `9adb0fae fix: preserve working directory cwd diagnostics`
|
||||
- merge into orchestration: `b52986e5 merge: browser working directories`
|
||||
|
||||
Review:
|
||||
- 初回 external review は request_changes。
|
||||
|
||||
@@ -39,7 +39,7 @@ Ticket を `workspace-panel` が queued にしました。
|
||||
Routing decision: implementation_ready
|
||||
|
||||
Reason:
|
||||
- Ticket は Browser-managed Execution Workspace の pre-allocate 方式、API/UI/spawn 接続、`relative_cwd` validation、path leak invariant、cleanup policy の v0 方針を具体化している。
|
||||
- Ticket は Browser-managed working directory の pre-allocate 方式、API/UI/spawn 接続、`relative_cwd` validation、path leak invariant、cleanup policy の v0 方針を具体化している。
|
||||
- 先行 Runtime-side materializer / Repository registry / workspace-id scoped API が orchestration branch に統合済みで、Browser-facing API を `/api/w/<workspace-id>/...` に追加する実装基盤がある。
|
||||
- raw host path / internal materialization request を Browser payload に露出しない binding invariant が明確で、Worker spawn は allocation id + safe `relative_cwd` で接続する要求になっている。
|
||||
- typed relation blocker は 0 件、OrchestrationPlan record は 0 件。
|
||||
@@ -53,17 +53,17 @@ Evidence checked:
|
||||
- queued Ticket 一覧: この Ticket 1件のみ。inprogress は 0 件。
|
||||
- visible Pods: previous child Pods が idle で残っているが、`StopPod` 不使用方針のため停止せず、新規 unique Pod を使う。capacity blocker ではない。
|
||||
- `TicketDoctor`: 0 errors / 既存 diagnostics のみ。
|
||||
- Bounded code map: `crates/worker-runtime/src/{catalog.rs,execution_workspace.rs,runtime.rs,worker_backend.rs,http_server.rs}`, `crates/workspace-server/src/{server.rs,hosts.rs,repositories.rs,config.rs}`, `web/workspace/src/lib/workspace-sidebar/**`, scoped routes/API under `web/workspace/src/routes/w/[workspaceId]/**`。
|
||||
- Bounded code map: `crates/worker-runtime/src/{catalog.rs,working_directory.rs,runtime.rs,worker_backend.rs,http_server.rs}`, `crates/workspace-server/src/{server.rs,hosts.rs,repositories.rs,config.rs}`, `web/workspace/src/lib/workspace-sidebar/**`, scoped routes/API under `web/workspace/src/routes/w/[workspaceId]/**`。
|
||||
|
||||
IntentPacket:
|
||||
|
||||
Intent:
|
||||
- Browser-facing API から configured repository + selector + policy により Execution Workspace を事前作成し、Browser には allocation id と safe summary だけを返す。
|
||||
- Worker launch UI/API で作成済み Execution Workspace を選択し、Worker spawn 時に allocation id と safe `relative_cwd` を Runtime materializer / Worker spawn boundary に接続する。
|
||||
- Worker detail/list に execution workspace の safe summary を表示し、cleanup policy と手動 cleanup 操作の v0 方針を実装/明示する。
|
||||
- Browser-facing API から configured repository + selector + policy により working directory を事前作成し、Browser には allocation id と safe summary だけを返す。
|
||||
- Worker launch UI/API で作成済み working directory を選択し、Worker spawn 時に allocation id と safe `relative_cwd` を Runtime materializer / Worker spawn boundary に接続する。
|
||||
- Worker detail/list に working directory の safe summary を表示し、cleanup policy と手動 cleanup 操作の v0 方針を実装/明示する。
|
||||
|
||||
Binding decisions / invariants:
|
||||
- Browser から raw host path、backend-private absolute path、raw `ExecutionWorkspaceRequest`、internal runtime path を送らせない/返さない。
|
||||
- Browser から raw host path、backend-private absolute path、raw `WorkingDirectoryRequest`、internal runtime path を送らせない/返さない。
|
||||
- pre-allocate 方式を優先する。単発 spawn request だけで暗黙 materialize する経路は後回し。
|
||||
- v0 materializer は existing local Git detached worktree 方針を使う。remote clone/cache、dirty source inclusion は扱わない。
|
||||
- Worker spawn は作成済み allocation id と任意の `relative_cwd` を選ぶ。
|
||||
@@ -73,19 +73,19 @@ Binding decisions / invariants:
|
||||
- Workspace-scoped Browser API は `/api/w/<workspace-id>/...` を使い、Runtime `/v1/...` API を Browser contract として広げない。
|
||||
|
||||
Requirements / acceptance criteria:
|
||||
- `POST /api/w/<workspace-id>/execution-workspaces` 相当で configured repository + selector から Execution Workspace を作成できる。
|
||||
- `GET /api/w/<workspace-id>/execution-workspaces` 相当で safe summary list を取得できる。
|
||||
- `POST /api/w/<workspace-id>/working-directories` 相当で configured repository + selector から working directory を作成できる。
|
||||
- `GET /api/w/<workspace-id>/working-directories` 相当で safe summary list を取得できる。
|
||||
- 必要なら detail / cleanup endpoint を scoped API に追加し、safe summary / typed diagnostic を返す。
|
||||
- Worker launch UI で Execution Workspace を選択でき、raw path ではなく safe id/selector 情報を送る。
|
||||
- Worker launch UI で working directory を選択でき、raw path ではなく safe id/selector 情報を送る。
|
||||
- Worker spawn 時に選択 allocation が Runtime の materialized workspace に接続され、Worker cwd/scope は materialized worktree 配下になる。
|
||||
- invalid repository / dirty unsupported / remote unsupported / invalid `relative_cwd` は typed diagnostic。
|
||||
- Worker detail/list に execution workspace safe summary を表示する。
|
||||
- Worker detail/list に working directory safe summary を表示する。
|
||||
- frontend check/test、workspace-server tests、`yoi ticket doctor`、`nix build .#yoi` を通す。
|
||||
|
||||
Implementation latitude:
|
||||
- Allocation store の所在/形式、API endpoint 名、UI placement、cleanup status 名、test helper は既存 workspace-server / worker-runtime / web style に合わせてよい。
|
||||
- v0 では Runtime materializer の既存 allocation evidence を再利用し、Browser-managed allocation registry は必要最小限でよい。
|
||||
- Worker launch UI は既存 New Worker form に Execution Workspace select / create link / refresh を追加する形でよい。
|
||||
- Worker launch UI は既存 New Worker form に working directory select / create link / refresh を追加する形でよい。
|
||||
- `relative_cwd` は empty/`.` を workspace root と扱ってよい。
|
||||
|
||||
Escalate if:
|
||||
@@ -103,7 +103,7 @@ Validation:
|
||||
- `nix build .#yoi --no-link`（Ticket acceptance に含まれるため実行する。実行不能なら理由を implementation report に明記する）
|
||||
|
||||
Current code map:
|
||||
- Runtime Execution Workspace: `crates/worker-runtime/src/catalog.rs`, `execution_workspace.rs`, `runtime.rs`, `worker_backend.rs`, `http_server.rs`。
|
||||
- Runtime working directory: `crates/worker-runtime/src/catalog.rs`, `working_directory.rs`, `runtime.rs`, `worker_backend.rs`, `http_server.rs`。
|
||||
- Workspace Backend host/API: `crates/workspace-server/src/server.rs`, `hosts.rs`, `repositories.rs`, `config.rs`。
|
||||
- Worker launch UI and API helpers: `web/workspace/src/lib/workspace-sidebar/WorkersNavSection.svelte`, worker launch model/tests, workspace API helper, scoped route layout。
|
||||
- Worker detail/console: scoped worker console route and runtime worker detail/list projections。
|
||||
@@ -134,7 +134,7 @@ Checked context:
|
||||
|
||||
Acceptance basis:
|
||||
- concrete missing decision / information は残っていない。
|
||||
- Ticket の scope は Browser-managed pre-allocated Execution Workspace と Worker spawn 接続に閉じており、remote clone/cache, dirty source inclusion, raw path Browser contract, implicit one-shot materialization は非目標/後回しとして明確。
|
||||
- Ticket の scope は Browser-managed pre-allocated working directory と Worker spawn 接続に閉じており、remote clone/cache, dirty source inclusion, raw path Browser contract, implicit one-shot materialization は非目標/後回しとして明確。
|
||||
- side effect はこの `queued -> inprogress` acceptance 後に、worktree-workflow に沿って implementation worktree を作成してから開始する。
|
||||
|
||||
---
|
||||
@@ -146,8 +146,8 @@ Acceptance basis:
|
||||
Implementation routing update:
|
||||
|
||||
- Worktree-workflow に従い implementation worktree を作成した。
|
||||
- Worktree: `/home/hare/Projects/yoi/.worktree/00001KWY8EHEJ-browser-execution-workspaces`
|
||||
- Branch: `work/00001KWY8EHEJ-browser-execution-workspaces`
|
||||
- Worktree: `/home/hare/Projects/yoi/.worktree/00001KWY8EHEJ-browser-working-directories`
|
||||
- Branch: `work/00001KWY8EHEJ-browser-working-directories`
|
||||
- Worktree には tracked `.yoi` project records が見えている。
|
||||
- `.yoi/memory` / `.yoi/runtime` / `.yoi/log` / `.yoi/logs` / `.yoi/local` / `.yoi/*.lock` / `.yoi/*secret*` は作成直後に存在しないことを確認した。
|
||||
- Sibling Coder Pod `yoi-coder-00001KWY8EHEJ-browser-execws` を起動した。
|
||||
@@ -162,20 +162,20 @@ Implementation routing update:
|
||||
|
||||
Implementation progress report:
|
||||
|
||||
- Coder Pod completed implementation and committed `684b19e8 feat: add browser execution workspaces` on branch `work/00001KWY8EHEJ-browser-execution-workspaces`.
|
||||
- Coder Pod completed implementation and committed `684b19e8 feat: add browser working directories` on branch `work/00001KWY8EHEJ-browser-working-directories`.
|
||||
- Worktree status was clean after commit.
|
||||
- Changed files include:
|
||||
- `crates/worker-runtime/src/{catalog.rs,execution_workspace.rs,http_server.rs,runtime.rs,worker_backend.rs}`
|
||||
- `crates/worker-runtime/src/{catalog.rs,working_directory.rs,http_server.rs,runtime.rs,worker_backend.rs}`
|
||||
- `crates/workspace-server/src/{companion.rs,hosts.rs,server.rs}`
|
||||
- `web/workspace/src/lib/workspace-sidebar/{WorkersNavSection.svelte,types.ts,worker-launch.ts,worker-launch.test.ts}`
|
||||
- Implementation summary:
|
||||
- Runtime-side preallocated Execution Workspace create/list/detail/cleanup and allocation binding at Worker spawn。
|
||||
- Runtime-side preallocated working directory create/list/detail/cleanup and allocation binding at Worker spawn。
|
||||
- `relative_cwd` validation rejects absolute paths, `..`, missing paths, files, and symlink escapes。
|
||||
- scoped Browser API: `POST/GET /api/w/<workspace-id>/execution-workspaces`, detail, and cleanup。
|
||||
- Browser API uses configured `repository_id` + selector + policy, not raw paths/internal `ExecutionWorkspaceRequest`。
|
||||
- scoped Browser API: `POST/GET /api/w/<workspace-id>/working-directories`, detail, and cleanup。
|
||||
- Browser API uses configured `repository_id` + selector + policy, not raw paths/internal `WorkingDirectoryRequest`。
|
||||
- Browser responses expose safe summaries only。
|
||||
- Worker spawn uses selected allocation id plus optional safe `relative_cwd`。
|
||||
- Worker list/detail projections include execution workspace safe summary。
|
||||
- Worker list/detail projections include working directory safe summary。
|
||||
- Workspace UI Worker launch flow can select existing allocations or create a new allocation before launch。
|
||||
- Orchestrator reran validation in the implementation worktree:
|
||||
- `git diff --check`: pass
|
||||
@@ -198,23 +198,23 @@ External review result: request_changes
|
||||
|
||||
Blocker:
|
||||
|
||||
1. Invalid `relative_cwd` is rejected internally, but the Browser-facing Worker spawn API does not return the required typed Execution Workspace diagnostic。
|
||||
1. Invalid `relative_cwd` is rejected internally, but the Browser-facing Worker spawn API does not return the required typed working directory diagnostic。
|
||||
- Ticket acceptance requires invalid `relative_cwd` to be rejected as a typed diagnostic。
|
||||
- Materializer has specific typed codes:
|
||||
- `execution_workspace_relative_cwd_invalid`
|
||||
- `execution_workspace_relative_cwd_unavailable`
|
||||
- `execution_workspace_relative_cwd_escape_rejected`
|
||||
- `crates/worker-runtime/src/worker_backend.rs` converts `ExecutionWorkspaceDiagnostic` to a plain string in `WorkerExecutionResult::rejected(...)`。
|
||||
- `working_directory_relative_cwd_invalid`
|
||||
- `working_directory_relative_cwd_unavailable`
|
||||
- `working_directory_relative_cwd_escape_rejected`
|
||||
- `crates/worker-runtime/src/worker_backend.rs` converts `WorkingDirectoryDiagnostic` to a plain string in `WorkerExecutionResult::rejected(...)`。
|
||||
- Workspace host/API then maps this to generic diagnostics/error codes, including generic embedded execution rejection and generic `workspace_worker_create_failed`。
|
||||
- Result: Browser caller submitting invalid `relative_cwd` gets a generic worker-create/runtime rejection rather than a typed `execution_workspace_relative_cwd_*` diagnostic。
|
||||
- Result: Browser caller submitting invalid `relative_cwd` gets a generic worker-create/runtime rejection rather than a typed `working_directory_relative_cwd_*` diagnostic。
|
||||
- Browser/scoped API-level tests cover materializer bind validation but not the API rejection shape。
|
||||
|
||||
Required fix:
|
||||
- Preserve/propagate `ExecutionWorkspaceDiagnostic.code` through Worker spawn, or prevalidate allocation + `relative_cwd` in the Workspace API and return that typed diagnostic directly。
|
||||
- Add a scoped Browser API test for at least one invalid `relative_cwd` that asserts the typed `execution_workspace_relative_cwd_*` diagnostic is returned。
|
||||
- Preserve/propagate `WorkingDirectoryDiagnostic.code` through Worker spawn, or prevalidate allocation + `relative_cwd` in the Workspace API and return that typed diagnostic directly。
|
||||
- Add a scoped Browser API test for at least one invalid `relative_cwd` that asserts the typed `working_directory_relative_cwd_*` diagnostic is returned。
|
||||
|
||||
Non-blocking follow-ups:
|
||||
- The implementation otherwise appears aligned with the pre-allocation design: scoped `/api/w/<workspace-id>/execution-workspaces` routes exist, Browser create payload uses configured `repository_id`/selector/policy rather than raw `ExecutionWorkspaceRequest`, summaries avoid raw paths, UI explicitly creates/selects allocations, and cleanup is bounded to the allocation root。
|
||||
- The implementation otherwise appears aligned with the pre-allocation design: scoped `/api/w/<workspace-id>/working-directories` routes exist, Browser create payload uses configured `repository_id`/selector/policy rather than raw `WorkingDirectoryRequest`, summaries avoid raw paths, UI explicitly creates/selects allocations, and cleanup is bounded to the allocation root。
|
||||
|
||||
Validation reviewed:
|
||||
- Reviewer read Ticket item/thread, inspected `git show --stat --check 684b19e8` / `git show --name-only 684b19e8`, and reviewed Runtime, Workspace API/host, and frontend launch files。
|
||||
@@ -228,13 +228,13 @@ Validation reviewed:
|
||||
|
||||
Review-fix implementation report:
|
||||
|
||||
- Coder Pod completed requested changes and committed follow-up `9adb0fae fix: preserve execution workspace cwd diagnostics` on branch `work/00001KWY8EHEJ-browser-execution-workspaces`.
|
||||
- Coder Pod completed requested changes and committed follow-up `9adb0fae fix: preserve working directory cwd diagnostics` on branch `work/00001KWY8EHEJ-browser-working-directories`.
|
||||
- Worktree status was clean after commit.
|
||||
- Fix summary:
|
||||
- Browser Worker spawn now prevalidates selected execution workspace allocation + `relative_cwd` through the materializer before spawn。
|
||||
- `ExecutionWorkspaceDiagnostic` is mapped directly into Browser API error diagnostics, preserving typed codes such as `execution_workspace_relative_cwd_invalid`, `execution_workspace_relative_cwd_unavailable`, and `execution_workspace_relative_cwd_escape_rejected`。
|
||||
- Added a scoped Browser API regression test asserting invalid `relative_cwd: "../escape"` returns typed `execution_workspace_relative_cwd_invalid` diagnostic。
|
||||
- Existing scoped execution workspace routes, safe summaries, explicit UI allocation flow, and bounded cleanup behavior remain unchanged。
|
||||
- Browser Worker spawn now prevalidates selected working directory allocation + `relative_cwd` through the materializer before spawn。
|
||||
- `WorkingDirectoryDiagnostic` is mapped directly into Browser API error diagnostics, preserving typed codes such as `working_directory_relative_cwd_invalid`, `working_directory_relative_cwd_unavailable`, and `working_directory_relative_cwd_escape_rejected`。
|
||||
- Added a scoped Browser API regression test asserting invalid `relative_cwd: "../escape"` returns typed `working_directory_relative_cwd_invalid` diagnostic。
|
||||
- Existing scoped working directory routes, safe summaries, explicit UI allocation flow, and bounded cleanup behavior remain unchanged。
|
||||
- Orchestrator reran validation in the implementation worktree:
|
||||
- `git diff --check`: pass
|
||||
- `cd web/workspace && deno task check`: pass（0 errors / 0 warnings）
|
||||
@@ -259,13 +259,13 @@ Blockers: none.
|
||||
Evidence reviewed in implementation worktree only:
|
||||
- Ticket records: `.yoi/tickets/00001KWY8EHEJ/item.md`, `thread.md`, and orchestration artifact。
|
||||
- Fix diff: `9adb0fae` stat/check and `684b19e8..9adb0fae` focused diff for `crates/workspace-server/src/server.rs`。
|
||||
- Relevant files: `workspace-server/src/server.rs`, `worker-runtime/src/execution_workspace.rs`, `worker_backend.rs`, scoped host/runtime API pieces, and worker launch UI/model/tests。
|
||||
- Relevant files: `workspace-server/src/server.rs`, `worker-runtime/src/working_directory.rs`, `worker_backend.rs`, scoped host/runtime API pieces, and worker launch UI/model/tests。
|
||||
|
||||
Findings:
|
||||
- Prior blocker is resolved. Browser Worker spawn now pre-validates `execution_workspace.relative_cwd` through the execution workspace materializer before calling the runtime spawn path, and maps `ExecutionWorkspaceError` into API diagnostics via `execution_workspace_api_error`。
|
||||
- Invalid Browser spawn `relative_cwd` now returns typed diagnostics with the expected codes, covered by the added test asserting `execution_workspace_relative_cwd_invalid` appears both in diagnostics and message。
|
||||
- Browser-facing spawn payload remains allocation-based (`allocation_id` + optional `relative_cwd`) rather than exposing raw `ExecutionWorkspaceRequest` or host paths. UI request construction sends allocation id and relative cwd only。
|
||||
- Scoped create/list/detail/cleanup routes remain under `/api/w/:workspace_id/execution-workspaces`; worker creation uses the scoped workspace API path from the Browser UI。
|
||||
- Prior blocker is resolved. Browser Worker spawn now pre-validates `working_directory.relative_cwd` through the working directory materializer before calling the runtime spawn path, and maps `WorkingDirectoryError` into API diagnostics via `working_directory_api_error`。
|
||||
- Invalid Browser spawn `relative_cwd` now returns typed diagnostics with the expected codes, covered by the added test asserting `working_directory_relative_cwd_invalid` appears both in diagnostics and message。
|
||||
- Browser-facing spawn payload remains allocation-based (`allocation_id` + optional `relative_cwd`) rather than exposing raw `WorkingDirectoryRequest` or host paths. UI request construction sends allocation id and relative cwd only。
|
||||
- Scoped create/list/detail/cleanup routes remain under `/api/w/:workspace_id/working-directories`; worker creation uses the scoped workspace API path from the Browser UI。
|
||||
- Cleanup remains bounded to the allocation root: cleanup re-derives allocation root from the allocation id/root, canonicalizes workspace root, rejects escape, and removes only the recorded workspace root。
|
||||
- Runtime/internal trusted path still performs canonical materialization/bind at Worker launch, while Browser gets a safer scoped allocation API。
|
||||
- Reported validation was comprehensive and green; reviewer did not rerun tests as this was a read-only follow-up review。
|
||||
@@ -283,7 +283,7 @@ No merge-blocking issues found.
|
||||
Merge/validation acceptance:
|
||||
|
||||
- Follow-up external review approved the implementation after blocker fix。
|
||||
- Implementation branch `work/00001KWY8EHEJ-browser-execution-workspaces` was merged into the orchestration branch with merge commit `b52986e5 merge: browser execution workspaces`。
|
||||
- Implementation branch `work/00001KWY8EHEJ-browser-working-directories` was merged into the orchestration branch with merge commit `b52986e5 merge: browser working directories`。
|
||||
- Final validation in Orchestrator worktree passed:
|
||||
- `git diff --check`: pass
|
||||
- `cd web/workspace && deno task check`: pass（0 errors / 0 warnings）
|
||||
@@ -295,8 +295,8 @@ Merge/validation acceptance:
|
||||
- `nix build .#yoi --no-link`: pass
|
||||
|
||||
Implementation commits:
|
||||
- `684b19e8 feat: add browser execution workspaces`
|
||||
- `9adb0fae fix: preserve execution workspace cwd diagnostics`
|
||||
- `684b19e8 feat: add browser working directories`
|
||||
- `9adb0fae fix: preserve working directory cwd diagnostics`
|
||||
|
||||
No merge-blocking issues remain.
|
||||
|
||||
@@ -318,24 +318,24 @@ Ticket を closed にしました。
|
||||
完了。
|
||||
|
||||
実装内容:
|
||||
- Browser-managed Execution Workspace API を scoped Workspace API に追加した。
|
||||
- `POST /api/w/<workspace-id>/execution-workspaces`
|
||||
- `GET /api/w/<workspace-id>/execution-workspaces`
|
||||
- Browser-managed working directory API を scoped Workspace API に追加した。
|
||||
- `POST /api/w/<workspace-id>/working-directories`
|
||||
- `GET /api/w/<workspace-id>/working-directories`
|
||||
- detail / cleanup endpoint
|
||||
- Browser create payload は configured `repository_id` / selector / policy を使い、raw host path / raw internal `ExecutionWorkspaceRequest` / internal runtime path を受け取らないようにした。
|
||||
- Browser create payload は configured `repository_id` / selector / policy を使い、raw host path / raw internal `WorkingDirectoryRequest` / internal runtime path を受け取らないようにした。
|
||||
- Browser response は allocation id、repository id、selector/commit evidence、status、cleanup policy など safe summary のみを返すようにした。
|
||||
- Worker launch UI で Execution Workspace を create/select できるようにした。
|
||||
- Worker launch UI で working directory を create/select できるようにした。
|
||||
- Worker spawn は selected allocation id + optional `relative_cwd` を使い、Runtime materialized workspace に接続するようにした。
|
||||
- `relative_cwd` は materialized root 相対として検証し、absolute path、`..` escape、symlink escape、nonexistent / non-directory を拒否するようにした。
|
||||
- invalid `relative_cwd` は Browser-facing API で typed `execution_workspace_relative_cwd_*` diagnostic として返るようにした。
|
||||
- Worker list/detail に execution workspace safe summary を含めた。
|
||||
- invalid `relative_cwd` は Browser-facing API で typed `working_directory_relative_cwd_*` diagnostic として返るようにした。
|
||||
- Worker list/detail に working directory safe summary を含めた。
|
||||
- cleanup は allocation root に bounded され、typed/sanitized diagnostic を返すようにした。
|
||||
- Focused backend/runtime/web tests を追加した。
|
||||
|
||||
主な commit / merge:
|
||||
- implementation: `684b19e8 feat: add browser execution workspaces`
|
||||
- review fix: `9adb0fae fix: preserve execution workspace cwd diagnostics`
|
||||
- merge into orchestration: `b52986e5 merge: browser execution workspaces`
|
||||
- implementation: `684b19e8 feat: add browser working directories`
|
||||
- review fix: `9adb0fae fix: preserve working directory cwd diagnostics`
|
||||
- merge into orchestration: `b52986e5 merge: browser working directories`
|
||||
|
||||
Review:
|
||||
- 初回 external review は request_changes。
|
||||
|
||||
Reference in New Issue
Block a user