getgloss 0.8.3 → 0.8.4

package/dist/web/setup.md

@@ -178,8 +178,13 @@ gloss open --review <reviewId> --json
 `gloss open --json` intentionally waits until browser submission or timeout.
 Use `--no-watch` when the caller only needs to open the review. The background
 daemon exits automatically after a short idle window with no pending reviews.
-If cleanup looks stale, run `gloss doctor`; use `gloss stop --all` when you
-want to terminate all Gloss daemon processes for the current user.
+You do not need to unlock `~/.gloss/server.json` after finishing a review; it is
+only the background daemon pointer. If cleanup looks stale or reports a
+permission error, run `gloss doctor`; use `gloss stop --all` when you want to
+terminate all Gloss daemon processes for the current user. 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.
 Use `gloss clear --dry-run` to preview old completed review artifacts, and
 `gloss clear` to delete completed artifacts older than 30 days. Pending reviews
 are always preserved.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getgloss",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Local browser-based diff review for coding-agent loops.",
   "type": "module",
   "packageManager": "pnpm@10.33.2",

package/skill/SKILL.md

@@ -78,5 +78,11 @@ pending reviews. Use `gloss doctor` for stale process cleanup diagnostics,
 `gloss clear --dry-run` before deleting completed artifacts older than 30 days
 with `gloss clear`. Pending reviews are always preserved.
 
+Agents should not ask the user to unlock `~/.gloss/server.json` after a review.
+That file is only a daemon pointer. If cleanup reports a permission error, run
+`gloss doctor`; if needed, have the user fix ownership, write permissions, or
+platform-specific immutable/read-only attributes on the state directory, or set
+`GLOSS_STATE_DIR` to a writable sandbox state directory.
+
 For less-common options, run `gloss open --help` or `gloss --help` instead of
 guessing flags.