getgloss 0.8.3 → 0.8.5

package/README.md

@@ -100,8 +100,19 @@ compares only against the requested ref and does not switch to a branch diff.
 Use `gloss open --review <reviewId> --json` after applying feedback to capture
 the next diff as another turn in the same browser review.
 The background server exits automatically after a short idle window with no
-pending reviews. `gloss doctor` reports unmanaged daemon processes, and
-`gloss stop --all` cleans them up.
+live review clients. Pending review artifacts stay on disk and can be resumed,
+but they do not keep the daemon alive by themselves. `gloss doctor` reports
+unmanaged daemon processes, and normal startup/status commands also clean up
+clearly stale daemons. `gloss stop --all` cleans up every Gloss daemon for the
+current user.
+
+You do not need to unlock `~/.gloss/server.json` after finishing a review.
+That file is only the background daemon pointer, not a review lock. If a
+command reports a permission error while cleaning it up, run `gloss doctor`,
+then try `gloss stop --all` from a normal terminal. If macOS flags made the
+file immutable, inspect with `ls -lOe ~/.gloss ~/.gloss/server.json` and clear
+the flag with `chflags nouchg ~/.gloss/server.json`. For sandboxed agents, set
+`GLOSS_STATE_DIR` to a writable directory.
 
 `gloss clear` deletes completed review artifacts older than 30 days from
 `~/.gloss/reviews` while always preserving pending reviews. Use