lobstah 0.7.3 → 0.7.5
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 +2976 -2407
- package/dist/runner.js +273 -162
- package/docs/configuration.md +10 -0
- package/package.json +1 -1
package/docs/configuration.md
CHANGED
|
@@ -27,6 +27,7 @@ The descriptor's `repo` field resolves here; the key is what dispatchers name.
|
|
|
27
27
|
| `path` | yes | The git clone worktrees are allocated from (`~/` expands). |
|
|
28
28
|
| `trunk` | yes (default `main`) | Branch dispatches start from (`origin/<trunk>`). |
|
|
29
29
|
| `origin` | no | Enables clone-on-first-use when `path` doesn't exist. |
|
|
30
|
+
| `review` | no (`"github"`) | Destination for PR links in the glass and PR pet clicks, independent of `[pet].open`: `github`, `graphite`, `linear` (browser: `https://linear.review/{owner}/{repo}/pull/{number}`), `linear-app` (Linear desktop app: `linear://review/{owner}/{repo}/pull/{number}`), or an HTTPS template containing `{owner}`, `{repo}`, and `{number}`. Example: `"https://review.example/{owner}/{repo}/{number}"`. The configured `origin` (else the checkout's git origin) identifies the repo; canonical GitHub URLs remain the watch identity. Linear reviews require its GitHub integration; `linear-app` also requires the installed app. Custom templates remain HTTPS-only. |
|
|
30
31
|
| `setup` | no | Commands run in each fresh worktree, in order (e.g. `["pnpm install"]`). A follow-up that reuses its origin's worktree does not run them again unless a lockfile at the worktree root (`pnpm-lock.yaml`, `package-lock.json`, `yarn.lock`, `Cargo.lock`, `go.sum`, and others) or the commands changed since they last ran there. |
|
|
31
32
|
| `scratch` | no | Repo-relative paths (e.g. `["tmp", ".cache"]`) whose untracked files do not count as uncommitted changes when a follow-up decides whether to reuse its origin's worktree. Tracked changes anywhere, and untracked files elsewhere, still do. |
|
|
32
33
|
| `env` | no | Environment merged into every dispatch for this repo. |
|
|
@@ -120,6 +121,9 @@ send a continuation.
|
|
|
120
121
|
|---|---|---|
|
|
121
122
|
| `ttlSecs` | `1800` | Heartbeat age past which a helm registration is stale: the next `man helm` claims it without `--take`. The park and `man brief` heartbeat it. |
|
|
122
123
|
| `reportSecs` | `900` | Minimum seconds between park-delivered digests for a helm session. The digest is also change-gated — quiet grounds deliver nothing regardless of cadence. |
|
|
124
|
+
| `queuedNoticeSecs` | `180` | Queued age before a dispatch-progress notice wakes the helm with its queue reason and remedy. `0` disables. Reminders back off at 15, 45, 105… minutes after the threshold; claim clears the condition. |
|
|
125
|
+
| `stalledNoticeSecs` | `1200` | Silence since both a claimed dispatch's last activity and note before dispatch-progress attention. The same reminder backoff applies; activity or a note clears it. Paused, needs-decision and blocked workers use their existing paths. `0` disables. |
|
|
126
|
+
| `idleWorkingNoticeSecs` | `60` | Explicitly idle trap whose last report is working: wake the helm with its full note. A live session-owned background wait exempts it. Tool activity or a new report clears it; reminders use the same backoff. `0` disables. |
|
|
123
127
|
| `armGraceSecs` | `5` | Arm mode: when work is in flight and no live watcher is registered, the Stop hook polls this long for one before blocking — a `man wait` (or `soak --wait`) backgrounded just before the turn ended is usually still starting. A stale registration gets the same window. |
|
|
124
128
|
|
|
125
129
|
## `[glass]` — the spyglass
|
|
@@ -128,6 +132,12 @@ send a continuation.
|
|
|
128
132
|
|---|---|---|
|
|
129
133
|
| `port` | `4949` | Localhost port for the glass. `LOBSTAH_GLASS_PORT` takes precedence. |
|
|
130
134
|
|
|
135
|
+
## `[pet]` — report and decision clicks
|
|
136
|
+
|
|
137
|
+
| Key | Default | Meaning |
|
|
138
|
+
|---|---|---|
|
|
139
|
+
| `open` | `"tab"` | `tab` opens the item in a new browser tab; `helm` focuses the helm through its existing focus ladder (falls back to the item's page). `app` tries an installed Chrome glass at the exact local address, then `glass show`; absent, hidden or unresponsive apps fall back to a tab. Native launch/delivery remains unverified; Safari currently takes the fallback. Applies only to reports and decisions, never PR links. Existing presence expiry windows are unchanged. |
|
|
140
|
+
|
|
131
141
|
## `[watch]` — watch delivery
|
|
132
142
|
|
|
133
143
|
| Key | Default | Meaning |
|