@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.
Files changed (2) hide show
  1. package/README.md +16 -12
  2. 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.18.0
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.18.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.18.0
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.18.0
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.18.0 --yes
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 directory is gone is a stale registration. Prune drops the record only.
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
- A missing or unreadable repository produces a report-only `repositories` warning. The warning names its registration or configuration, and the survey continues.
354
- Repository registrations stay unchanged.
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, stale registrations, and `targets`. Disk, process, and repository findings are report-only.
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 `minimax`.
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`. MiniMax windows are `interval` and `weekly`.
478
- MiniMax account labels use `minimax-N`, where N is the position in the configured API-key list.
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.18.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",