@oisin-ee/pi-dogsled 0.18.0 → 0.19.0
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/README.md +16 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,13 +11,13 @@ Install the binary on each Herdr host. Use the same release tag in each command.
|
|
|
11
11
|
Binary:
|
|
12
12
|
|
|
13
13
|
```sh
|
|
14
|
-
mise use github:oisin-ee/dogsled@v0.
|
|
14
|
+
mise use github:oisin-ee/dogsled@v0.19.0
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
Pi (extension, tools, and skill), from npm or as part of `@oisin-ee/oisinpi`:
|
|
18
18
|
|
|
19
19
|
```sh
|
|
20
|
-
pi install npm:@oisin-ee/pi-dogsled@0.
|
|
20
|
+
pi install npm:@oisin-ee/pi-dogsled@0.19.0
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
At session start the extension compares its version with `dogsled --version` and warns when they differ.
|
|
@@ -25,14 +25,14 @@ At session start the extension compares its version with `dogsled --version` and
|
|
|
25
25
|
Claude Code (hooks, tools, and skill):
|
|
26
26
|
|
|
27
27
|
```sh
|
|
28
|
-
claude plugin marketplace add oisin-ee/dogsled#v0.
|
|
28
|
+
claude plugin marketplace add oisin-ee/dogsled#v0.19.0
|
|
29
29
|
claude plugin install dogsled@dogsled
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
Codex (hooks, tools, and skill):
|
|
33
33
|
|
|
34
34
|
```sh
|
|
35
|
-
codex plugin marketplace add oisin-ee/dogsled --ref v0.
|
|
35
|
+
codex plugin marketplace add oisin-ee/dogsled --ref v0.19.0
|
|
36
36
|
codex plugin add dogsled@dogsled
|
|
37
37
|
```
|
|
38
38
|
|
|
@@ -42,7 +42,7 @@ The [Codex CLI reference](https://developers.openai.com/codex/cli/reference#code
|
|
|
42
42
|
Herdr (right-side work board):
|
|
43
43
|
|
|
44
44
|
```sh
|
|
45
|
-
herdr plugin install oisin-ee/dogsled --ref v0.
|
|
45
|
+
herdr plugin install oisin-ee/dogsled --ref v0.19.0 --yes
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
Harness plugins use the binary on `PATH`. They do not install it or start host services.
|
|
@@ -328,7 +328,7 @@ An open agent item holds its checkout in prune and the sweep; `close` ends it an
|
|
|
328
328
|
An idle or done agent that has not called `dogsled done` holds its checkout in prune, the sweep, and an automatic close; only an explicit `dogsled close` takes it. An idle shell, a done agent without an open item, and a workspace alone are not holds. The processes of an idle agent pane are not holds, but a background job that a shell started is. Foreign locks still prevent removal.
|
|
329
329
|
A dirty checkout whose commits are in the default branch gets a `landed_dirty` finding when no hold applies.
|
|
330
330
|
The finding includes the repository, checkout, branch or HEAD, dirty-path count, and up to ten paths. It is never removable.
|
|
331
|
-
A registered worktree whose
|
|
331
|
+
A registered worktree whose path is absent is a stale registration. Prune and the sweep remove the record only.
|
|
332
332
|
Prune and the sweep use one pane rule. Both keep the caller's pane and focused panes.
|
|
333
333
|
An empty shell closes when its job ended, its directory disappeared, its launch is final, or its agent item closed.
|
|
334
334
|
A final launch was refused, never attempted, or has an unknown outcome with no agent in its terminal. Cleanup preserves launch receipts and checks terminal ownership under the launch locks.
|
|
@@ -350,8 +350,8 @@ Each entry is independent. A failed or refused entry does not stop the others; p
|
|
|
350
350
|
|
|
351
351
|
Placement records repositories in `repositories.json`, independently of `worktrees.json`. Repository registrations survive the last worktree removal.
|
|
352
352
|
Doctor also discovers repositories from the caller, live pane directories, Herdr workspaces, and `cleanup.repositories`. It never scans the whole home directory.
|
|
353
|
-
|
|
354
|
-
|
|
353
|
+
An absent remembered repository produces a removable `repositories` entry. Prune and the sweep recheck absence under the registry locks, then remove only stale records.
|
|
354
|
+
Existing worktree records stay. Configured paths, discovered paths, unreadable paths, and dangling symlinks remain report-only. Doctor changes no registrations.
|
|
355
355
|
### The sweep in `serve`
|
|
356
356
|
|
|
357
357
|
The sweep closes finished children (see [Items and closing](#items-and-closing)), and a job closes its own tab. That closed loop ends most work.
|
|
@@ -364,6 +364,7 @@ Each requested pass builds the doctor plan in sweep scope. It applies only entri
|
|
|
364
364
|
|
|
365
365
|
- `panes` and `workspaces`: the shared pane rule above. A workspace closes whole only when every pane qualifies. Final launch panes close separately under their launch locks.
|
|
366
366
|
- `worktrees` and `branches`: the shared loss rule and holds described above, identical to prune.
|
|
367
|
+
- Stale repository and worktree registrations: remove only records whose paths are absent, with the same locked recheck as prune.
|
|
367
368
|
- Orphaned children: a child that called `done`, whose owner is gone, and whose checkout passes the shared loss rule. Close runs teardown and removes its workspace, checkout, and item.
|
|
368
369
|
|
|
369
370
|
The sweep runs the same checks as `close` and `prune`. It never closes the service's own pane or workspace, or a worktree that the service works in. It skips a worktree it cannot check, and a failure on one entry does not stop the others.
|
|
@@ -374,7 +375,7 @@ The report includes start and finish times, removals, failures, repository warni
|
|
|
374
375
|
The service also writes removals, failures, and repository warnings to stderr.
|
|
375
376
|
Child completion and orphan checks remain independent of requested doctor cleanup.
|
|
376
377
|
An orphan that is dirty, unpushed, `working`, `blocked`, or on an unreachable host stays open. Status shows `orphaned:` and the reason on its item line, the brief counts it, and every check-in on the host lists it.
|
|
377
|
-
Prune also handles ended jobs
|
|
378
|
+
Prune also handles ended jobs and `targets`. Disk and process findings are report-only. Repository findings remain report-only except for absent remembered paths.
|
|
378
379
|
|
|
379
380
|
## Placement
|
|
380
381
|
|
|
@@ -467,15 +468,18 @@ Peers need a dogsled version that supports quota storage. No management credenti
|
|
|
467
468
|
The version-1 contract contains `version`, `fetched_ms`, `source`, and `pools`.
|
|
468
469
|
`source` identifies the collector by hostname. Each row contains these fields:
|
|
469
470
|
|
|
470
|
-
- `pool`: `claude`, `codex`, or
|
|
471
|
+
- `pool`: the lowercase CLIProxy provider name, such as `claude`, `codex`, or a plugin provider. Consumers must accept any string.
|
|
471
472
|
- `account` and `window`: the account label and provider window name.
|
|
472
473
|
- `used_pct`: a number from 0 to 100.
|
|
473
474
|
- `resets_ms`: Unix milliseconds, or `null` when unavailable.
|
|
474
475
|
- `error`: a safe error description, or `null`.
|
|
475
476
|
|
|
476
477
|
Claude windows are `five_hour`, `seven_day`, `seven_day_opus`, and `seven_day_sonnet`.
|
|
477
|
-
Codex windows are `primary` and `secondary`.
|
|
478
|
-
|
|
478
|
+
Codex windows are `primary` and `secondary`.
|
|
479
|
+
Dogsled reads Claude and Codex through CLIProxy `api-call`. For every other enabled credential that CLIProxy marks `supports_quota`, it calls `POST /v0/management/quota/fetch` with the credential's `auth_index`. It needs no change for a new provider.
|
|
480
|
+
Each bucket becomes one row. The window is the bucket window. With more than one group, it is `<group>-<window>`, where the group is its lowercase `[a-z0-9_-]` display name.
|
|
481
|
+
`used_pct` is `(1 - remainingFraction) * 100`, limited to 0..100. `resets_ms` comes from `resetTime`.
|
|
482
|
+
Plugin account labels follow the same redaction as Claude and Codex labels. A failed fetch gives one error row with the window `quota`.
|
|
479
483
|
A failed account has error rows with zero usage and no reset time. Consumers must treat these rows as unknown, not available quota.
|
|
480
484
|
A pool is exhausted when every account has a window at 100% with a reset time in the future.
|
|
481
485
|
Human output shows each window, reset time, and snapshot age. No snapshot produces an empty version-1 snapshot with `fetched_ms: 0`.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oisin-ee/pi-dogsled",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.19.0",
|
|
4
4
|
"description": "Pi extension for dogsled: the board, the /dogsled panel, the inbox reader, and the dogsled tools. Needs the dogsled binary of the same version.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|