lobstah 0.6.6 → 0.6.7

package/docs/man.md

@@ -486,6 +486,22 @@ only a trap id in a same-origin, token-protected POST. The ⚙ popover's two
 preferences — table or cards, and whether lobsters crawl the page — are
 per-browser, kept in that browser's localStorage and never on disk.
 
+Each open glass page, and each report's page, reports its presence: every
+poll, and every 30 s while its tab is hidden, it sends the server a random
+page id and whether it is visible; the server reads the browser's user
+agent from the request and forgets a page three minutes after it last
+reported, or at once when the page closes. `lobstah glass show '<#hash>'`
+asks the page most likely in front of you (the latest visible one, else the
+latest seen) to show a tab (`#prs`), a decision (`#decision/<key>`), or a
+report (`#report/<key>`). The page applies each show once, on its next poll
+or as soon as its tab is visible again. The command prints whether a page
+was seen and in which app (`claude` for the Claude desktop app's Browser
+pane, `chrome`, `safari`, `firefox`, `edge`, `electron`, or `other`);
+`--json` prints the same as JSON for the desktop pet. `POST /api/show` is
+local only: it needs the secret in `~/.lobstah/state/glass-show.secret`
+(user-only, created by the first `glass show`), the glass's own Host, and no
+`Origin` header, so no web page can send one.
+
 On a card, the title and the badge share one line. The title shrinks first,
 with an ellipsis, but always keeps its PR number or 8-character id. A badge of
 12 characters or fewer always shows whole. A longer badge truncates only
@@ -770,7 +786,9 @@ it under the inbox.
 **Acknowledging, display-only.** Clicking a desktop pet opens its target and
 runs `lobstah attention ack <item-key> --by pet`, so that pet stops walking
 the item until its state changes (a new status entry, head, failed check, or
-thread count). The ack changes only what the pet and the glass lobs display:
+thread count; a ready PR changes only by becoming ready again after it was
+not). The pet also hides the clicked item itself until its state changes, so
+an ack that times out does not leave it walking. The ack changes only what the pet and the glass lobs display:
 `man tend --json` still lists the item (marked `acked`), and `man wait`, the
 park, and reminders ignore acks entirely — a human having seen a question
 must never hide it from the orchestrator that has to answer it. The glass,

package/docs/vocabulary.md

@@ -563,7 +563,7 @@ reminder loop apply the same predicate.
 
 | Word | Meaning |
 | ---- | ------- |
-| ack | `~/.lobstah/acks/<item-key>.json` — `{ key, kind, stateHash, at, by }`, written only by `lobstah attention ack` (removed by `unack`, by the CLI's `man tend` / `attention` when its `stateHash` goes stale, and by `cull` when the item is gone). **Display-only**: it hides the item from the desktop pet and the glass lobs while the item's `stateHash` is unchanged; `man tend --json` keeps the item with `acked: { at, by }`, and `man wait`, the park, reminders, and `notifyCommand` never read acks. Item keys: `<lane>:<uuid>` (question, landed), `decision:<rid>`, `pr:<owner>/<repo>#<n>` (all of a PR's `pr:*` kinds — one ack covers them), `watch:<key>`. `stateHash` covers the status entry (question, landed) or the PR's head sha plus every evidence field a `pr:*` kind stands on (not `observedAt`). |
+| ack | `~/.lobstah/acks/<item-key>.json` — `{ key, kind, stateHash, at, by }`, written only by `lobstah attention ack` (removed by `unack`, by the CLI's `man tend` / `attention` when its `stateHash` goes stale, and by `cull` when the item is gone). **Display-only**: it hides the item from the desktop pet and the glass lobs while the item's `stateHash` is unchanged; `man tend --json` keeps the item with `acked: { at, by }`, and `man wait`, the park, reminders, and `notifyCommand` never read acks. Item keys: `<lane>:<uuid>` (question, landed), `decision:<rid>`, `pr:<owner>/<repo>#<n>` (all of a PR's `pr:*` kinds — one ack covers them), `watch:<key>`. `stateHash` covers the status entry (question, landed) or the PR's head sha plus every evidence field a `pr:*` kind stands on (not `observedAt`); for a ready PR, only when `pr:ready` began standing (its `standingSince`), so repeat observations of the same ready state keep the ack and ready → not ready → ready re-stands it once. |
 | pet state | `~/.lobstah/pet/state.json` — `{ pid, at, ok, command, reason, consecutiveFailures, items, lastOkAt }`. The desktop pet's one write: it rewrites the file after each attention read (about every six seconds). `command` is the command that worked (`attention --json`, or `man tend --json` from an older CLI). `reason` says why the last read failed (timed out, non-zero exit, output that does not decode). Only `lobstah doctor` reads it, for its `pet` row: running means `pid` is alive and `at` is less than two minutes old. |
 | budget stop | A headless runner's `failed` verb with a `budget:` note means its progress-extended active-work window reached the hard ceiling. This is out of time, not a code failure: the runner checkpoints eligible changes, pushes when enabled, names the saved branch/commit/draft PR, and invites `lobstah send <id> "continue"`. Paused `--waiting-on` time is excluded. |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lobstah",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Harness-agnostic, token-efficient supervision framework for coding agents",
   "license": "MIT",
   "author": "aequitas labs LLC",