@anyforge/control 0.9.2 → 0.10.0

package/README.md

@@ -342,6 +342,8 @@ use these commands; service accounts cannot own interactive Studio sessions.
 anyforge studio list --json
 anyforge studio usage SESSION --json
 anyforge studio create --repo acme/app --branch feature/fix --context "Fix the form" --json
+anyforge studio create --uncommitted --context "Finish the form"   # this branch and its uncommitted changes
+anyforge studio pickup SESSION                                     # check the session's pushed branch out here
 anyforge studio continue SESSION --file src/form.ts --context "Review this local reference"
 anyforge studio open SESSION
 anyforge studio run SESSION --context "Implement and test the fix" --input '{"maxTotalTokens":40000}'
@@ -355,7 +357,14 @@ anyforge studio push SESSION --input '{"expectedHeadSha":"SHA"}'
 
 `create` and `continue` prepare context without running code. `--file` sends only
 that file (20 KB maximum), labels its local branch/commit and uncommitted state,
-and does not copy local edits into the remote checkout. `--initiative ID` assigns
+and does not copy local edits into the remote checkout. `create --uncommitted`
+(0.10.0 or later, keys with `studio:write` and `studio:execute`) opens the session
+on this checkout's pushed branch and applies its uncommitted changes, including
+untracked files Git does not ignore, before the first run. It refuses unpushed
+commits, changes over 100 KB, binary files, symbolic links, submodules and
+credential-shaped values before anything is sent. `pickup SESSION` fetches the
+session's pushed branch, checks it out with a fast-forward only and lists the
+session's commits; it refuses over uncommitted local changes. `--initiative ID` assigns
 a new session to an existing initiative; omission starts direct work. Keep the
 returned session/run IDs and event cursor to reconnect. Reuse an explicit
 `idempotencyKey` in `--input` when retrying a create or run request.