lobstah 0.8.5 → 0.8.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -323,6 +323,7 @@ harness's blocking Stop-hook timeout too.
323
323
  | Key | Default | Meaning |
324
324
  |---|---|---|
325
325
  | `port` | `4949` | Localhost port for the glass. `LOBSTAH_GLASS_PORT` takes precedence. |
326
+ | `mirror` | unset | A wharf in `[wharves]` that shows this machine's glass on its hosted glass. The fleet stays on its local grounds. The daemon puts the glass snapshot there (never the page token): within seconds of a change while a hosted glass is open, and every five minutes otherwise. It carries out on this glass, over loopback, the reads and writes a person makes there, except ↗ Open. Enroll with `lobstah wharf login --wharf <name> --mirror` (mirror and read access only), then `lobstah daemon restart`; `lobstah wharf whoami --wharf <name>` and `lobstah doctor` show how fresh the mirror is. Unset, nothing is sent. |
326
327
 
327
328
  ## `[pet]` — report and decision clicks
328
329
 
package/docs/design.md CHANGED
@@ -683,22 +683,35 @@ overrides the global, which overrides the adapter default.
683
683
  ## Glass source
684
684
 
685
685
  The spyglass (`lobstah glass`) is served as one self-contained HTML document,
686
- but it is written as ordinary source files under `apps/cli/glass/`, rendered
687
- with [Preact](https://preactjs.com) and [htm](https://github.com/developit/htm)
688
- (tagged-template markup, no JSX build):
686
+ written as ordinary source files and rendered with [Preact](https://preactjs.com)
687
+ and [htm](https://github.com/developit/htm) (tagged-template markup, no JSX
688
+ build). The UI lives in `packages/glass-ui`, which the hosted glass bundles too;
689
+ `apps/cli/glass/` holds only the local page's shell and its two-line entry;
690
+ the hosted glass (`services/wharf/glass/src/main.ts`) mounts the same UI on the
691
+ wharf backend with its sign-in around it, so the two never drift apart.
692
+ `apps/cli/test/glass-parity.test.ts` holds that: the same snapshot, rendered by
693
+ the local page's entry on the wharf's capabilities and by the hosted glass, must
694
+ give identical HTML for every shared tab and modal; `services/wharf/glass/src` may
695
+ hold only the host's files, and its stylesheet only the sign-in screen's rules.
696
+ A new view goes in `packages/glass-ui/ui/components`, where both glasses get it.
689
697
 
690
698
  | File | Holds |
691
699
  |---|---|
692
- | `index.html` | the document shell: head, the stylesheet slot, the script slot |
693
- | `glass.css` | every style; the design tokens (palette including the `.pr-*` badge states, spacing scale, card, badge, and modal metrics) are custom properties at the top |
694
- | `src/store.ts` | the one store: the latest snapshot, the route, the prefs, the open modal, the stale flag, the lob state |
695
- | `src/actions.ts` | every change the page can make (open or close a modal, set a preference, hide a lob, receive a snapshot) |
696
- | `src/main.ts` | the entry: builds the store from localStorage and the URL, renders `App` into the body on every change, starts polling |
697
- | `src/poll.ts` | `/data` polling: every 2s, one request at a time, paused while the tab is hidden; a 304 applies only the beats (server time and heartbeats) |
698
- | `src/route.ts` | the hash tabs (`#deck`, `#dispatches`, `#traps`, `#prs`, `#notices`) |
699
- | `src/prefs.ts` | the per-browser preferences and lob hides, in localStorage |
700
- | `src/components/*.ts` | `App`, `Header`, `Deck`, `Dispatches`, `Traps`, `PRs`, `Notices`, `Modal` (dispatch, trap, helm, PR, settings), `Lobs` |
701
- | `src/html.ts` | htm bound to Preact's `h` |
700
+ | `apps/cli/glass/index.html` | the document shell: head, the stylesheet slot, the script slot |
701
+ | `apps/cli/glass/src/main.ts` | the local entry: `startGlassPage(localBackend)` |
702
+ | `ui/glass.css` | every style; the design tokens (palette including the `.pr-*` badge states, spacing scale, card, badge, and modal metrics) are custom properties at the top |
703
+ | `ui/backend.ts` | `GlassBackend`, the one seam between the UI and its host: every read and write the page makes, and its capabilities (the tabs it fills, the actions it takes; the UI hides the rest) |
704
+ | `ui/backends/local.ts` | the local backend: `/data*`, `/report/*`, `/api/*` and `POST /requests` on the daemon that serves the page |
705
+ | `ui/backends/wharf.ts` | the wharf backend: the hosted glass's cookie-only `/api/glass*`, projected onto the same snapshot by `ui/wharf-snapshot.ts` (types in `ui/wharf-model.ts`); it fills deck, dispatches, traps, reviews and reports, and nothing it does not record |
706
+ | `ui/host.ts` | what a host adds around the glass: the hosted glass's sign-out and helm chip, Boats, human requests, notices and boat approval (the local glass adds nothing) |
707
+ | `ui/start.ts` | `startGlassPage(backend)`: builds the store from localStorage and the URL, renders `App` into the body on every change, starts polling (or renders one report on `/report/<key>`) |
708
+ | `ui/store.ts` | the one store: the latest snapshot, the route, the prefs, the open modal, the stale flag, the lob state |
709
+ | `ui/actions.ts` | every change the page can make (open or close a modal, set a preference, hide a lob, receive a snapshot) |
710
+ | `ui/poll.ts` | snapshot polling: every 2s, one request at a time, paused while the tab is hidden; an unchanged answer applies only the beats (server time and heartbeats) |
711
+ | `ui/route.ts` | the hash tabs (`#deck`, `#dispatches`, `#traps`, `#prs`, `#notices`) |
712
+ | `ui/prefs.ts` | the per-browser preferences and lob hides, in localStorage |
713
+ | `ui/components/*.ts` | `App`, `Header`, `Deck`, `Dispatches`, `Traps`, `PRs`, `Notices`, `Modal` (dispatch, trap, helm, PR, settings), `Lobs`, and the Markdown, link and harness-icon pieces |
714
+ | `ui/html.ts` | htm bound to Preact's `h` |
702
715
 
703
716
  Components are pure functions of the store. A new snapshot re-renders the
704
717
  page and Preact's reconciliation changes only the DOM whose data changed:
@@ -707,9 +720,10 @@ modal keeps its nodes across ticks, and scroll positions stay where the
707
720
  reader left them — no per-section hashing or manual node preservation. Only
708
721
  the active tab's section renders.
709
722
 
710
- The pure helpers stay beside the server in `apps/cli/src` and are imported by
711
- both sides: `glass-diff.ts` (the per-section selectors, tab route, filters,
712
- PR modal data) and `glass-lobs.ts` (which lobs walk). The `/data` payload
723
+ The pure helpers live in `packages/glass-ui/src` and are imported by both
724
+ sides (the CLI as `@lobstah/glass-ui`, the page from source): `glass-diff.ts`
725
+ (the per-section selectors, tab route, filters, PR modal data), `glass-lobs.ts`
726
+ (which lobs walk), and the Markdown and link parsers. The `/data` payload
713
727
  type, `GlassSnapshot`, lives in `@lobstah/core`: `glass-poll.ts` builds it
714
728
  from `buildGlassSnapshot()` and every component reads it, so a renamed field
715
729
  fails typecheck on both sides. `/data` carries dispatch summaries and the
package/docs/man.md CHANGED
@@ -705,8 +705,14 @@ the same rule.
705
705
  for a question such as "cut 0.6.0?"), who asked (`helm`), and when. It is
706
706
  stored in `~/.lobstah/decisions/<rid>/`: `decision.json`, `detail.md`, and
707
707
  `attachments/`. The claimed helm alone may ask.
708
+ - **Checklists.** Task items (`- [ ] step` or `- [x] step`), including nested
709
+ items, are tickable in decision details and filed reports. Ticks are saved
710
+ with the document and shared between desktop and phone; ticking never
711
+ answers a card. `lobstah man ask --show <card-or-report-key>` prints the
712
+ checked count and every item's state. Answered and withdrawn cards retain
713
+ read-only checklists at their existing glass links.
708
714
  - **Standing.** A decision stands until it is answered or the helm withdraws
709
- it with `lobstah man ask --withdraw <key>`, which removes its directory. A
715
+ it with `lobstah man ask --withdraw <key>`, which retains a read-only archive. A
710
716
  newer `man ask` on the same dispatch keeps the older decisions: each shows
711
717
  as its own card. `lobstah man ask ... --replace <key>` replaces that one
712
718
  standing decision; a key that is not standing is refused.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lobstah",
3
- "version": "0.8.5",
3
+ "version": "0.8.7",
4
4
  "description": "Harness-agnostic, token-efficient supervision framework for coding agents",
5
5
  "license": "MIT",
6
6
  "author": "aequitas labs LLC",
@@ -11,6 +11,7 @@
11
11
  "files": [
12
12
  "dist",
13
13
  "docs",
14
+ "pet",
14
15
  "README.md",
15
16
  "LICENSE"
16
17
  ],
@@ -0,0 +1,26 @@
1
+ // swift-tools-version:5.9
2
+ import PackageDescription
3
+
4
+ let package = Package(
5
+ name: "LobstahPet",
6
+ platforms: [.macOS(.v13)],
7
+ targets: [
8
+ // Everything that runs without a window: child processes, the
9
+ // attention read, the state file, the log. Tested on its own.
10
+ .target(
11
+ name: "LobstahPetCore",
12
+ path: "Sources/LobstahPetCore"
13
+ ),
14
+ .executableTarget(
15
+ name: "LobstahPet",
16
+ dependencies: ["LobstahPetCore"],
17
+ path: "Sources/LobstahPet",
18
+ resources: [.process("Resources")]
19
+ ),
20
+ .testTarget(
21
+ name: "LobstahPetCoreTests",
22
+ dependencies: ["LobstahPetCore"],
23
+ path: "Tests/LobstahPetCoreTests"
24
+ ),
25
+ ]
26
+ )