@oisin-ee/pi-dogsled 0.20.0 → 0.21.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 +19 -21
  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.20.0
14
+ mise use github:oisin-ee/dogsled@v0.21.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.0
20
+ pi install npm:@oisin-ee/pi-dogsled@0.21.0
21
21
  ```
22
22
 
23
23
  At session start the extension compares its version with `dogsled --version` and warns when they differ.
@@ -25,24 +25,24 @@ 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.20.0
28
+ claude plugin marketplace add oisin-ee/dogsled#v0.21.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.20.0
35
+ codex plugin marketplace add oisin-ee/dogsled --ref v0.21.0
36
36
  codex plugin add dogsled@dogsled
37
37
  ```
38
38
 
39
39
  Codex requires review and trust before it runs plugin hooks. See the [Codex hooks documentation](https://developers.openai.com/codex/hooks#plugin-hooks).
40
40
  The [Codex CLI reference](https://developers.openai.com/codex/cli/reference#codex-plugin) describes plugin installation.
41
41
 
42
- Herdr (right-side work board):
42
+ Herdr (left-docked work board):
43
43
 
44
44
  ```sh
45
- herdr plugin install oisin-ee/dogsled --ref v0.20.0 --yes
45
+ herdr plugin install oisin-ee/dogsled --ref v0.21.0 --yes
46
46
  ```
47
47
 
48
48
  The Claude and Codex plugins use the binary on `PATH`. The Herdr plugin's build step (`plugin/fetch.sh`) installs its own binary at `bin/dogsled`: the release archive for the manifest version, checked against its published SHA-256. When that release has no archive for the platform, it runs `cargo build --release --locked` instead, which needs Rust at the crate's `rust-version` or newer. A checksum mismatch stops the install. `DOGSLED_RELEASES` replaces the download base, such as a mirror. `herdr plugin link` skips build steps, so run `sh plugin/fetch.sh` in a linked checkout. No plugin starts host services.
@@ -117,7 +117,7 @@ A wait deadline does not cancel its job or ticket. `cancel` only cancels pending
117
117
  ### Agents and profiles
118
118
 
119
119
  `dogsled agent` starts a child with `herdr agent start <name> --kind pi|claude|codex --pane <pane> -- <args>`. The task is a launch argument, so nothing is typed into the new pane.
120
- A task with a newline, a leading `-` or `@`, or more than 4000 characters goes to `launches/<id>.task.md`. Pi reads it as `@<file>`; Claude and Codex get a one-line pointer to it.
120
+ Herdr types the launch as one terminal line of at most 1024 bytes, so no task text goes on it. The task is always `launches/<id>.task.md` on the host that runs the child; Pi reads it as `@<file>`, and Claude and Codex get a one-line pointer to it. Pi and Claude read the child contract from `launches/<id>.contract.md` (Codex has no file form, so its fixed contract stays inline). The host that runs the child refuses a name, profile or state path that makes the line over 960 bytes, before it creates a pane.
121
121
  `--message-file PATH` (or `-` for stdin) reads the task from a file.
122
122
  A failed `herdr agent start` is retried with backoff, three tries in all. After the last, the ticket fails and the owner's inbox says so. A refusal or a deadline fails at once.
123
123
  Herdr refuses a start before it types into the pane, for example `agent_pane_busy` or `agent_name_taken`. That refusal is final: dogsled records it as the launch result, closes the empty pane it created, and does not retry. Any other failure leaves the outcome unknown, so dogsled keeps the pane and reconciles it on the next try.
@@ -243,7 +243,7 @@ Peer reads run in parallel through SSH and the configured `remote_command`.
243
243
  A shared, locked cache permits at most one read per peer per ten seconds, including concurrent callers.
244
244
  Status never probes peers itself.
245
245
 
246
- `service: up` means a process holds the host's service lock. A free lock or unreachable peer means `service: down`.
246
+ `service: up` means a process holds the host's service lock. A free lock on a host that answers means `service: down`. A peer that SSH cannot read shows `unreachable: <category>` (for example `timeout` or `connection refused`, never the raw SSH text) instead, with the age of its last snapshot when one exists.
247
247
  Status shows snapshot age separately, including when the service runs. Peers without the liveness field retain the 30-second age fallback during upgrades.
248
248
  Admission still requires a snapshot no older than 30 seconds. Finished-child cleanup can use an older snapshot from a running service.
249
249
  Close rechecks the live pane, the child's `done` mark, and the loss guard before it acts.
@@ -350,11 +350,11 @@ Processes above 100% CPU outside Herdr pane ancestry are report-only. Prune neve
350
350
 
351
351
  Prune displays a plan and asks before removal. `--yes` skips that question, not safety checks.
352
352
  Each removal rechecks current state. Working or blocked panes, held worktrees, dirty worktrees, and local-only commits remain untouched.
353
- Removal rechecks Git path, branch, HEAD, and repository against the approved plan. Any identity change stops removal.
353
+ Removal rechecks Git path, branch, HEAD, and repository against the approved plan. Any change stops removal. A changed repository, path, or branch is an identity change and a failure. A HEAD that moved because of a new commit is live work and a skip.
354
354
  Worktree removal is the same as `close`: `teardown`, the panes and workspace, unlock, `git worktree remove`, the branch when its commits are held, and the idle anchor. Dogsled checks that the worktree is gone afterwards.
355
355
  Each entry is independent. A failed or refused entry does not stop the others.
356
- A recheck can refuse an entry because its state changed after the plan: the worktree is now dirty, held, or not landed, or the pane is now busy. Prune keeps that entry and reports it as `skipped:` with the reason. A skip is not a failure.
357
- An identity change, a missing entry, a command error, or unreadable evidence is a failure. Prune reports each failure, then exits with status 2.
356
+ A recheck can refuse an entry because its state changed after the plan: the worktree is now dirty, held, or not landed, the pane is now busy, or a new commit moved HEAD after the plan. Prune keeps that entry and reports it as `skipped:` with the reason. A skip is not a failure.
357
+ An identity change (repository, path, or branch), a missing entry, a command error, or unreadable evidence is a failure. Prune reports each failure, then exits with status 2.
358
358
  `--json` returns `{results,skipped,failures}`. A result names the removed path and the closed panes. A failed `teardown` command's error includes its last lines of output.
359
359
 
360
360
  Placement records repositories in `repositories.json`, independently of `worktrees.json`. Repository registrations survive the last worktree removal.
@@ -557,13 +557,11 @@ Claude Code and Codex include the reminder in their existing `Stop` inbox respon
557
557
  The reminder requests a review, a commit from dirty children, integration, or an explicit blocker or deferral.
558
558
  It never commits, merges, closes, or discards work itself. Clean readers and working children do not trigger it.
559
559
 
560
- The gate reports failures, repository warnings, `unlinked` holds, and landed-dirty findings from the latest completed pass, without waiting for the requested pass.
561
- A worktree failure or `unlinked` hold goes to its open item’s owner when that owner exists. Otherwise it goes only to an operator pane.
562
- Host-level repository warnings also go only to operators: panes Dogsled did not launch. Unrelated children receive neither notice.
563
- Landed-dirty findings keep their repository-root filter.
564
- Successful removals remain in status and the journal; they do not continue an agent turn.
565
- Repository warnings name the repository and state entries, and request delegation to a dogsled agent instead of manual state edits.
566
- Landed-dirty findings reach only panes in the same main repository, including linked worktrees and symlink paths.
560
+ The gate reports failures, `unlinked` holds, and landed-dirty findings from the latest completed pass, without waiting for the requested pass.
561
+ A finding reaches only the agent that created its work. That agent owns an open item whose pane holds the worktree or pane, or its launch record started a child in the worktree.
562
+ An agent that created nothing there hears nothing, whether Dogsled launched it or not. A research agent in the same repository gets no cleanup message.
563
+ Host-level failures and repository warnings have no creator. They stay in `dogsled status` and `status --brief` and reach no agent.
564
+ Prompt context shows the same owner-scoped counts. Successful removals remain in status and the journal; they do not continue an agent turn.
567
565
  The message asks the owner to read and preserve wanted changes, or obtain user approval before discarding abandoned work.
568
566
  It forbids forced worktree removal, `git clean`, and `rm -rf` on the checkout.
569
567
  Cleanup reminders use separate, once-per-set histories in `gate.json`, so an unchanged warning cannot cause a continuation loop.
@@ -592,7 +590,7 @@ The caller is the harness's `HERDR_PANE_ID`. Pi registers the server from its ex
592
590
 
593
591
  The extension adds host status before each prompt, registers the tools, and draws:
594
592
 
595
- - **The right-side board** shows cached quotas, agents, jobs, and todos when `HERDR_ENV=1` and `HERDR_SOCKET_PATH` accepts a connection. Pi opens or reuses the tab’s split and sets no above-editor widget. Without Herdr, the existing widget shows host meters, the current task, and work groups. Agent/job data refreshes every ten seconds. Compatible pi-todo snapshots update immediately in the widget.
593
+ - **The right-side board** shows cached quotas, agents, jobs, and todos when `HERDR_ENV=1` and `HERDR_SOCKET_PATH` accepts a connection. Pi opens or reuses the tab’s board, docked at the left edge beside Herdr’s own sidebar at 38 cells, and sets no above-editor widget. Without Herdr, the existing widget shows host meters, the current task, and work groups. Agent/job data refreshes every ten seconds. Compatible pi-todo snapshots update immediately in the widget.
596
594
  - **Alt+W or `/work`** opens or reuses the Herdr split. Without Herdr, it expands or collapses the widget in place, without a popup or editor replacement. Alt+J/K moves selection, Alt+] changes views, and Alt+I shows inline details. Typing stays in the editor. Alt+S stops jobs, Alt+C cancels queued work, and Alt+M sends agent messages. Stop and cancel require confirmation. Completed job history starts collapsed.
597
595
  - **`/dogsled`**, the control panel, with four tabs: Status (hosts with their retry state, then your rows; Enter on a host reads it again now), Hosts (reconnect, rename, enable, disable, add), Profiles (Enter edits `prompt.md`), and Inbox. The widget steps aside while the panel is open.
598
596
  - **The inbox reader** and a renderer that shows each record's kind, sender, and text, folded past twelve lines.
@@ -603,10 +601,10 @@ Todos follow the active Pi session branch. Agents and jobs follow the calling He
603
601
 
604
602
  The Jobs view joins retained records to the current owner's ledger by host and job ID. It does not show unrelated fleet jobs. Job inspection uses `dogsled read` for a bounded log tail and shows the `dogsled logs` command for full output. Expired records and unavailable hosts produce explicit errors. The panel never starts a new process manager, edits todos, or writes into an agent terminal.
605
603
 
606
- The Herdr plugin opens the right-side work board:
604
+ The Herdr plugin docks the work board at the left edge of the tab, 38 cells wide. Its `toggle` action closes or reopens it:
607
605
 
608
606
  ```sh
609
- dogsled board --open # open or reuse the caller’s tab split
607
+ dogsled board --open # open or reuse the caller’s docked board (`--toggle` closes it)
610
608
  dogsled board --side --owner "$HERDR_PANE_ID" # print once
611
609
  herdr plugin pane open --plugin dogsled --entrypoint board --direction right --no-focus
612
610
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oisin-ee/pi-dogsled",
3
- "version": "0.20.0",
3
+ "version": "0.21.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",