@@ -3241,8 +3241,10 @@ transactions](#replay-and-effect-transactions).
32413241
32423242#### Managed checkout reuse
32433243
3244- An ordinary Repository or Worktree selects a managed checkout under `~/.xmd/repositories`,
3245- addressed by a digest of its whole identity and described by a closed version 1 sidecar
3244+ An ordinary Repository or Worktree selects a managed checkout under `~/.xmd/repositories`.
3245+ A workspace-marked REPL entry instead selects beneath its existing session workspace,
3246+ as described in [Session workspace placement](#session-workspace-placement). Both use
3247+ the same selector, with slots addressed by a digest of the whole identity and a closed version 1 sidecar
32463248written by exclusive temporary sibling plus atomic rename only after the checkout is
32473249complete and verified. The slot is entered under an exclusive non-blocking advisory lock
32483250held for the whole document execution, so a second process is refused rather than made
@@ -3345,8 +3347,9 @@ worktree. A workflow run has none.
33453347
33463348#### Managed bytes
33473349
3348- A managed checkout is a Repository or Worktree an ordinary `xmd run` created under
3349- the host root `~/.xmd/repositories`, addressed by a digest of its whole identity, described by a
3350+ A managed checkout is a Repository or Worktree created under the host root
3351+ `~/.xmd/repositories`, or under the session workspace for a marked REPL entry,
3352+ addressed by a digest of its whole identity, described by a
33503353closed version 1 sidecar written beside it, and held for one document execution by an
33513354exclusive non-blocking advisory lock. It survives every execution: nothing deletes,
33523355resets, cleans, fetches or repairs one.
@@ -6721,8 +6724,12 @@ Completed entries remain projections. Old bytes are never rewritten, and an
67216724older reader that rejects unknown members refuses a marked history.
67226725
67236726The workspace root is passed directly from the entry owner into the CLI-private
6724- recorder, only for marked entries. The captured project cwd is a separate direct
6725- input for lazy ambient discovery and ordinary commit identity. Native Git still
6727+ recorder, only for marked entries. Fresh selections in those entries use
6728+ `<workspace>/repositories` as their managed root, including linked Worktrees.
6729+ Unmarked entries keep the configured host root. A nested Dir cannot retarget
6730+ that root. Acknowledged placements retain their recorded paths without moving
6731+ checkouts or validating current HEAD on replay. The captured project cwd is a
6732+ separate direct input for lazy ambient discovery and ordinary commit identity. Native Git still
67266733requires an operation to name a valid selected checkout; a workspace cwd supplies
67276734no project fallback. The Sidekick's native provider keeps the captured project
67286735`agentCwd`, or the caller's explicit dependency, and its existing identity and
0 commit comments