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.
- package/dist/main.js +3338 -2103
- package/dist/runner.js +367 -330
- package/docs/configuration.md +1 -0
- package/docs/design.md +30 -16
- package/docs/man.md +7 -1
- package/package.json +2 -1
- package/pet/Package.swift +26 -0
- package/pet/Sources/LobstahPet/Resources/lob-sprite.png +0 -0
- package/pet/Sources/LobstahPet/Resources/star.png +0 -0
- package/pet/Sources/LobstahPet/main.swift +584 -0
- package/pet/Sources/LobstahPetCore/Attention.swift +321 -0
- package/pet/Sources/LobstahPetCore/Command.swift +105 -0
- package/pet/Sources/LobstahPetCore/GlassShow.swift +156 -0
- package/pet/Sources/LobstahPetCore/Helm.swift +104 -0
- package/pet/Sources/LobstahPetCore/ReadMonitor.swift +94 -0
- package/pet/Tests/LobstahPetCoreTests/ClickRoutingTests.swift +157 -0
- package/pet/Tests/LobstahPetCoreTests/ClickedItemsTests.swift +46 -0
- package/pet/Tests/LobstahPetCoreTests/DecisionItemTests.swift +35 -0
- package/pet/Tests/LobstahPetCoreTests/GlassAddressTests.swift +76 -0
- package/pet/Tests/LobstahPetCoreTests/GlassShowTests.swift +158 -0
- package/pet/Tests/LobstahPetCoreTests/HelmRoutingTests.swift +84 -0
- package/pet/Tests/LobstahPetCoreTests/ReportItemTests.swift +91 -0
- package/pet/Tests/LobstahPetCoreTests/ReviewItemTests.swift +26 -0
- package/pet/Tests/LobstahPetCoreTests/RunCommandTests.swift +151 -0
package/docs/configuration.md
CHANGED
|
@@ -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
|
-
|
|
687
|
-
|
|
688
|
-
|
|
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.
|
|
694
|
-
| `
|
|
695
|
-
| `
|
|
696
|
-
| `
|
|
697
|
-
| `
|
|
698
|
-
| `
|
|
699
|
-
| `
|
|
700
|
-
| `
|
|
701
|
-
| `
|
|
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
|
|
711
|
-
|
|
712
|
-
PR modal data)
|
|
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
|
|
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.
|
|
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
|
+
)
|
|
Binary file
|
|
Binary file
|