Scratch workspaces for chats without a project¶
Decision¶
A chat that has not chosen a project folder gets a Ru-owned scratch workspace
under the Ru data root: <data root>/workspaces/<session id>. The Host creates
it when POST /agent/v1/runs arrives with an empty workspace_path, writes a
.ru-scratch.json marker naming the session, and returns the canonical path and
workspace_kind: "scratch" in the run response.
A scratch workspace is an ordinary workspace for trust, policy, tools and skills. Its only differences are origin, display and lifecycle:
- The desktop client approves its trust request silently. Ru created the folder; asking the user to trust Ru's own scratch space is noise. The decision still goes through the normal explicit trust endpoint.
- The sidebar shows a chat without a chosen project in Recents. Scratch directories are internal execution storage and do not create workspace groups. Explicit manual placement remains a separate presentation choice.
- It is deleted with its session: the session-deletion coordinator removes the folder after the session record, and a startup sweeper reclaims folders whose session no longer exists.
- Deleting a workspace group deletes its sessions through the same single-session path and removes the workspace pin after confirming no chats remain. The single action also removes an empty pinned workspace. Failed deletes or pin writes retain the workspace for retry. User-selected project folders on disk are never deleted; scratch folders follow their sessions' cleanup rules.
Deletion is marker-gated. A folder without a marker is not Ru's: it is left in place, and a marker naming another session is refused, so a user folder whose name happens to match a session id is safe.
Ownership and deletion clarification (2026-11-01 review)¶
Allocation never claims an existing unmarked or foreign directory and rejects reparse points. Run responses and session listings classify a workspace as scratch only when its canonical path resolves to the same session's marked, non-reparse scratch directory. A lexical child path is insufficient, including for silent GUI trust approval. Failed primary session deletion preserves the scratch directory; only successful deletion or confirmed absence permits cleanup. Workspace deletion resolves all session pages before confirmation, within bounded listing limits, and refuses incomplete plans rather than deleting a visible subset.
Sidebar amendment: no chosen project means Recents¶
At the user's request, Recents replaces the original aggregate Scratch group.
Receiving workspace_kind: "scratch" after the first run must not move a chat
out of Recents. Project groups represent chosen folders or explicit sidebar
placement. This changes presentation only; per-session scratch allocation,
ownership checks, workspace trust and cleanup keep their existing contracts.
Context¶
The desktop app previously derived a new chat's workspace from the application
directory's parent. With the product checked out at D:\LLM, that made every
new chat run in D:\ — the file tools' authority boundary — so the whole drive
was treated as the workspace and read/write access inside it needed no approval.
The drive root also has no project identity: skills, project memory, AGENTS.md
discovery and coding subagents all assume a project root, and glob/grep
truncate on a drive.
Other agents avoid this by tying the workspace to the process working directory. A GUI launched from the Start menu has no project directory, so it needs an explicit no-project state instead of a guessed one.
Consequences¶
workspace_pathmay be empty. The Host owns the scratch layout; clients never construct the path themselves.workspace_pathandworkspace_kindare additive response fields, andworkspace_kindis additive on the session listing.- Scratch folders live in the Ru data root, so a read-only install works and the product's own repository is never polluted.
- Scratch deletion is best-effort: a locked file reports
ArtifactsPending, which the client surfaces as a retry, and the sweeper finishes later. The marker is removed last so an interrupted delete can be retried. - A scratch folder is ordinary policy territory: no extra grants are implied by its origin.