@oisin-ee/pi-dogsled 0.17.0 → 0.18.1
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 +37 -23
- package/package.json +1 -1
- package/pi/board.ts +14 -0
- package/pi/inbox.ts +6 -2
- package/pi/index.ts +51 -7
- package/pi/work-todo.ts +67 -0
- package/plugins/dogsled/skills/dogsled/SKILL.md +3 -4
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.18.1
|
|
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.18.1
|
|
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.
|
|
28
|
+
claude plugin marketplace add oisin-ee/dogsled#v0.18.1
|
|
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.18.1
|
|
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 (
|
|
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.18.1 --yes
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
Harness plugins use the binary on `PATH`. They do not install it or start host services.
|
|
@@ -140,17 +140,17 @@ An item records its host, pane, owner pane, creation time, closure time, and for
|
|
|
140
140
|
`items --json` returns `{items,queue}`. `--owner` filters both collections.
|
|
141
141
|
The service closes a job item after job completion, and any item after pane removal.
|
|
142
142
|
|
|
143
|
-
|
|
143
|
+
`done` hands the task back to the owner. The child host captures the final reply, closes the pane and agent worktree, and keeps the branch. The owner receives the reply and lands the branch without a live child. The sweep remains a backstop.
|
|
144
144
|
|
|
145
|
-
|
|
146
|
-
2. puts the reply in the owner's inbox (see [Inbox](#inbox));
|
|
147
|
-
3. if the child called `done` during that turn, closes it when it is a reader whose worktree is clean with no commits outside the default branch, or when its branch has landed.
|
|
145
|
+
Call `done` during the final working turn, after committing changes. It refuses open children, queued tickets, dirty agent worktrees, and removal that loses content under the shared loss rule. Retaining the local branch protects unlanded commits.
|
|
148
146
|
|
|
149
|
-
|
|
150
|
-
A child that ends a turn without `done` stays open, and its reply tells the owner it waits for input.
|
|
147
|
+
Marks in `done.json` use the launch/item id, pane, and `agent_session.value`, not the terminal id. Legacy marks migrate without deletion. The first `idle` or `done` observation ends the marked turn, including after restore without a completion counter. Working, blocked, and unknown states never authorize closure.
|
|
151
148
|
|
|
152
|
-
|
|
153
|
-
|
|
149
|
+
New inbox work accepted during that same working turn cancels its mark. After that turn ends, the mark is terminal. Senders receive `<name> finished; start a new child for more work`.
|
|
150
|
+
|
|
151
|
+
A child without its own `done` stays open, including a child that asks a question or orchestrates other children. Automatic closure never closes the caller or a busy pane. Shared worktrees remain, and only the finished child pane closes. A last primary pane stays while closing it would close linked workspaces.
|
|
152
|
+
|
|
153
|
+
Closed children retain TO LAND rows: `<child>: branch <b> +N to land`. These rows come from durable items and branch observations, not live panes. Integration or branch deletion removes the row.
|
|
154
154
|
|
|
155
155
|
`dogsled board` groups an owner's children, jobs, and queued tickets by what the owner must do: TO LAND, ATTENTION, RUNNING, and WAITING. Each agent row names the harness and model; each job row names its command. `--json` is what the Pi widget draws.
|
|
156
156
|
`dogsled read TARGET [--host H]` shows a child's or job's newest output and the captured final reply.
|
|
@@ -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
|
|
|
@@ -572,8 +573,8 @@ The caller is the harness's `HERDR_PANE_ID`. Pi registers the server from its ex
|
|
|
572
573
|
|
|
573
574
|
The extension adds host status before each prompt, registers the tools, and draws:
|
|
574
575
|
|
|
575
|
-
- **The board
|
|
576
|
-
- **Alt+W or `/work`** expands or collapses
|
|
576
|
+
- **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.
|
|
577
|
+
- **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.
|
|
577
578
|
- **`/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.
|
|
578
579
|
- **The inbox reader** and a renderer that shows each record's kind, sender, and text, folded past twelve lines.
|
|
579
580
|
|
|
@@ -583,13 +584,26 @@ Todos follow the active Pi session branch. Agents and jobs follow the calling He
|
|
|
583
584
|
|
|
584
585
|
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.
|
|
585
586
|
|
|
586
|
-
The Herdr plugin
|
|
587
|
+
The Herdr plugin opens the right-side work board:
|
|
587
588
|
|
|
588
589
|
```sh
|
|
589
|
-
|
|
590
|
+
dogsled board --open # open or reuse the caller’s tab split
|
|
591
|
+
dogsled board --side --owner "$HERDR_PANE_ID" # print once
|
|
592
|
+
herdr plugin pane open --plugin dogsled --entrypoint board --direction right --no-focus
|
|
590
593
|
```
|
|
591
594
|
|
|
592
|
-
The
|
|
595
|
+
The split runs `dogsled board --side --watch` and refreshes every ten seconds. `--owner` defaults to the opening pane from Herdr’s plugin context.
|
|
596
|
+
Quotas come only from `quota.json`; the board never calls a provider or reads credentials. The heading shows cache age and `STALE` after fifteen minutes.
|
|
597
|
+
|
|
598
|
+
Pi renders each new todo revision through pi-todo’s `display.createView(host).render(width)`. Dogsled never reads or copies task state.
|
|
599
|
+
The board publishes its width in the ledger; before that, Pi uses 48 columns. Resizing republishes the same provider view at the new width.
|
|
600
|
+
Pi atomically writes `{session, branch, revision, current, pane, width, lines}` to `todo-lines/<pane-hash>.json` in Dogsled’s state directory.
|
|
601
|
+
The service reads files for live agent panes into `todos.json`. Peers expose this presentation through `dogsled host todos --json`.
|
|
602
|
+
The board shows each agent’s current line and prints the owner’s full provider-rendered lines unchanged, including ANSI styles. Missing presentations show as unavailable.
|
|
603
|
+
Session shutdown and provider release remove the pane’s publication. `/dogsled` remains the interactive control panel in both display modes.
|
|
604
|
+
|
|
605
|
+
Herdr 0.9.5 creates a new pane on every plugin open. Dogsled keeps a small `boards/<tab-hash>.json` registry keyed by Herdr tab ID.
|
|
606
|
+
It stores the board pane and terminal IDs, verifies them against live panes before reuse, and removes a stale entry before opening another split.
|
|
593
607
|
All three harness packages share `plugins/dogsled/skills/dogsled/SKILL.md`. It describes delegation, jobs, messages, and the queue.
|
|
594
608
|
|
|
595
609
|
## Build and development
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oisin-ee/pi-dogsled",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.18.1",
|
|
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",
|
package/pi/board.ts
CHANGED
|
@@ -2,6 +2,20 @@
|
|
|
2
2
|
// from `dogsled board --json`; this file only lays it out for a terminal width.
|
|
3
3
|
import type { ThemeColor } from "@earendil-works/pi-coding-agent";
|
|
4
4
|
import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
|
|
5
|
+
import { createConnection } from "node:net";
|
|
6
|
+
|
|
7
|
+
/** A stale socket path is not a running Herdr session. Never probe outside Herdr. */
|
|
8
|
+
export async function herdrAvailable(env: NodeJS.ProcessEnv = process.env): Promise<boolean> {
|
|
9
|
+
const path = env["HERDR_SOCKET_PATH"];
|
|
10
|
+
if (env["HERDR_ENV"] !== "1" || !path) return false;
|
|
11
|
+
return new Promise(resolve => {
|
|
12
|
+
const socket = createConnection(path);
|
|
13
|
+
const finish = (available: boolean) => { socket.destroy(); resolve(available); };
|
|
14
|
+
socket.once("connect", () => finish(true));
|
|
15
|
+
socket.once("error", () => finish(false));
|
|
16
|
+
socket.setTimeout(1_000, () => finish(false));
|
|
17
|
+
});
|
|
18
|
+
}
|
|
5
19
|
|
|
6
20
|
export type Group = "to_land" | "attention" | "running" | "waiting";
|
|
7
21
|
|
package/pi/inbox.ts
CHANGED
|
@@ -26,6 +26,8 @@ interface Claimed extends Delivered {
|
|
|
26
26
|
}
|
|
27
27
|
|
|
28
28
|
type Exec = (args: string[]) => Promise<string>;
|
|
29
|
+
export type WatchDirectory = (dir: string, listener: (event: string, name: string | null) => void) => FSWatcher;
|
|
30
|
+
const watchDirectory: WatchDirectory = (dir, listener) => watch(dir, { persistent: false }, listener);
|
|
29
31
|
|
|
30
32
|
function parseClaimed(stdout: string): Claimed[] {
|
|
31
33
|
const value: unknown = JSON.parse(stdout);
|
|
@@ -58,10 +60,12 @@ export class InboxReader {
|
|
|
58
60
|
|
|
59
61
|
private readonly pi: Pick<ExtensionAPI, "sendMessage">;
|
|
60
62
|
private readonly exec: Exec;
|
|
63
|
+
private readonly watchDirectory: WatchDirectory;
|
|
61
64
|
|
|
62
|
-
constructor(pi: Pick<ExtensionAPI, "sendMessage">, exec: Exec) {
|
|
65
|
+
constructor(pi: Pick<ExtensionAPI, "sendMessage">, exec: Exec, watchInbox: WatchDirectory = watchDirectory) {
|
|
63
66
|
this.pi = pi;
|
|
64
67
|
this.exec = exec;
|
|
68
|
+
this.watchDirectory = watchInbox;
|
|
65
69
|
}
|
|
66
70
|
|
|
67
71
|
/** Register as this pane's reader, deliver what is waiting, and watch for more. */
|
|
@@ -74,7 +78,7 @@ export class InboxReader {
|
|
|
74
78
|
if (typeof where.dir !== "string" || typeof where.file !== "string") throw new Error("dogsled inbox path returned no dir or file");
|
|
75
79
|
const file = where.file;
|
|
76
80
|
// Each write replaces the file, so the directory is watched, not the file.
|
|
77
|
-
this.watcher =
|
|
81
|
+
this.watcher = this.watchDirectory(where.dir, (_event, name) => {
|
|
78
82
|
if (name === file) void this.drain(ctx);
|
|
79
83
|
});
|
|
80
84
|
this.watcher.on("error", () => { this.watcher?.close(); this.watcher = undefined; });
|
package/pi/index.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { readFileSync } from "node:fs";
|
|
2
2
|
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
3
3
|
import { Box, Text, Key } from "@earendil-works/pi-tui";
|
|
4
|
-
import { type Board, clean, parseBoard } from "./board.ts";
|
|
5
|
-
import { WorkTodo } from "./work-todo.ts";
|
|
4
|
+
import { type Board, clean, parseBoard, herdrAvailable } from "./board.ts";
|
|
5
|
+
import { WorkTodo, TodoPublisher } from "./work-todo.ts";
|
|
6
6
|
import { UnitBridge } from "./unit-bridge.ts";
|
|
7
7
|
import { workBoard, workText, type WorkState } from "./work.ts";
|
|
8
8
|
import { type Details, InboxReader, MESSAGE_TYPE } from "./inbox.ts";
|
|
@@ -74,10 +74,30 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
74
74
|
let workAbort: AbortController | undefined;
|
|
75
75
|
let context: ExtensionContext | undefined;
|
|
76
76
|
let requestWorkRender: (() => void) | undefined;
|
|
77
|
-
|
|
77
|
+
let sideDisplay = false;
|
|
78
|
+
let publicationFailure: string | undefined;
|
|
79
|
+
const publisher = new TodoPublisher(owner ?? "", error => context?.ui.notify(`Todo publication failed: ${String(error)}`, "error"));
|
|
80
|
+
const todos = new WorkTodo(pi.events, () => {
|
|
81
|
+
if (context) { publishTodos(context); draw(context); }
|
|
82
|
+
}, () => {
|
|
78
83
|
if (context) void openWork(context, "todos").catch(error => context?.ui.notify(String(error), "error"));
|
|
79
84
|
});
|
|
80
85
|
|
|
86
|
+
function publishTodos(ctx: ExtensionContext): void {
|
|
87
|
+
if (!owner) return;
|
|
88
|
+
try { publisher.publish(todos.current, ctx.ui.theme); }
|
|
89
|
+
catch (error) { ctx.ui.notify(`Todo publication failed: ${String(error)}`, "error"); }
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
async function publication(ctx: ExtensionContext): Promise<void> {
|
|
93
|
+
if (!owner) return;
|
|
94
|
+
const current = generation;
|
|
95
|
+
const location: unknown = JSON.parse(await exec(["board", "--todo-path", "--owner", owner, "--json"]));
|
|
96
|
+
if (current !== generation) return;
|
|
97
|
+
publisher.configure(location);
|
|
98
|
+
publishTodos(ctx);
|
|
99
|
+
}
|
|
100
|
+
|
|
81
101
|
function state(): WorkState {
|
|
82
102
|
return { board, todo: todos.current, error: failure ?? todos.error };
|
|
83
103
|
}
|
|
@@ -97,6 +117,7 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
97
117
|
}
|
|
98
118
|
|
|
99
119
|
async function openWork(ctx: ExtensionContext, tab: WorkTab): Promise<void> {
|
|
120
|
+
if (sideDisplay && owner) { await exec(["board", "--open", "--owner", owner, "--json"]); return; }
|
|
100
121
|
if (ctx.mode !== "tui") { ctx.ui.notify(workText(state()), "info"); return; }
|
|
101
122
|
if (panelOpen) return;
|
|
102
123
|
workOpen = true;
|
|
@@ -136,7 +157,7 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
136
157
|
}
|
|
137
158
|
|
|
138
159
|
function draw(ctx: ExtensionContext) {
|
|
139
|
-
if (ctx.mode !== "tui") return;
|
|
160
|
+
if (ctx.mode !== "tui" || sideDisplay) return;
|
|
140
161
|
workPanel?.update(workData());
|
|
141
162
|
const data = state();
|
|
142
163
|
if (panelOpen || (!workOpen && !data.board.rows.length && (!data.todo || data.todo.display.empty) && !data.error)) {
|
|
@@ -174,6 +195,13 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
174
195
|
await inbox.drain(ctx);
|
|
175
196
|
try { await units.ready(ctx); await units.drain(ctx); } catch (error) { ctx.ui.notify(`Dogsled settlement delivery pending: ${String(error)}`, "warning"); }
|
|
176
197
|
if (ctx.mode !== "tui") return;
|
|
198
|
+
try { await publication(ctx); publicationFailure = undefined; }
|
|
199
|
+
catch (error) {
|
|
200
|
+
const text = `Todo publication unavailable: ${String(error)}`;
|
|
201
|
+
if (text !== publicationFailure) ctx.ui.notify(text, "warning");
|
|
202
|
+
publicationFailure = text;
|
|
203
|
+
}
|
|
204
|
+
if (current !== generation || sideDisplay) return;
|
|
177
205
|
try {
|
|
178
206
|
const next = parseBoard(JSON.parse(await exec(["board", "--json"])));
|
|
179
207
|
if (current !== generation) return;
|
|
@@ -197,9 +225,24 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
197
225
|
return refresh;
|
|
198
226
|
}
|
|
199
227
|
|
|
228
|
+
/** Dogsled answers `skipped` for a pane it launched: a child keeps the widget path. */
|
|
229
|
+
async function openSide(ctx: ExtensionContext): Promise<boolean> {
|
|
230
|
+
if (!owner) return false;
|
|
231
|
+
try {
|
|
232
|
+
const opened: unknown = JSON.parse(await exec(["board", "--open", "--owner", owner, "--json"]));
|
|
233
|
+
return typeof opened === "object" && opened !== null && typeof (opened as Record<string, unknown>)["pane_id"] === "string";
|
|
234
|
+
} catch (error) {
|
|
235
|
+
ctx.ui.notify(`Dogsled side board unavailable: ${String(error)}`, "error");
|
|
236
|
+
return false;
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
|
|
200
240
|
pi.on("session_start", async (event, ctx) => {
|
|
201
241
|
units.start(event.reason);
|
|
202
|
-
|
|
242
|
+
const wasSide = sideDisplay;
|
|
243
|
+
sideDisplay = Boolean(owner) && ctx.mode === "tui" && await herdrAvailable() && await openSide(ctx);
|
|
244
|
+
if (ctx.mode === "tui" && (!sideDisplay || (!wasSide && requestWorkRender))) ctx.ui.setWidget("dogsled", undefined);
|
|
245
|
+
await publisher.clear();
|
|
203
246
|
requestWorkRender = undefined;
|
|
204
247
|
workPanel?.dispose();
|
|
205
248
|
if (timer) clearInterval(timer);
|
|
@@ -227,7 +270,7 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
227
270
|
}
|
|
228
271
|
await update(ctx);
|
|
229
272
|
});
|
|
230
|
-
pi.on("session_shutdown", (_event, ctx) => {
|
|
273
|
+
pi.on("session_shutdown", async (_event, ctx) => {
|
|
231
274
|
units.stop();
|
|
232
275
|
workPanel?.dispose();
|
|
233
276
|
generation++;
|
|
@@ -241,8 +284,9 @@ export default function dogsled(pi: ExtensionAPI) {
|
|
|
241
284
|
timer = undefined;
|
|
242
285
|
inbox.stop();
|
|
243
286
|
todos.stop();
|
|
287
|
+
await publisher.clear();
|
|
244
288
|
context = undefined;
|
|
245
|
-
if (ctx.mode === "tui") ctx.ui.setWidget("dogsled", undefined);
|
|
289
|
+
if (ctx.mode === "tui" && !sideDisplay) ctx.ui.setWidget("dogsled", undefined);
|
|
246
290
|
});
|
|
247
291
|
// A delivered message is in the transcript once Pi ends it: only then is it acknowledged.
|
|
248
292
|
pi.on("message_end", async event => { await inbox.ended(event.message); });
|
package/pi/work-todo.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
|
|
2
2
|
import { randomUUID } from "node:crypto";
|
|
3
|
+
import { rename, rm, writeFile } from "node:fs/promises";
|
|
3
4
|
|
|
4
5
|
/** The provider owns rendering and state interpretation; this is an in-process capability. */
|
|
5
6
|
export interface TodoViewHost {
|
|
@@ -33,6 +34,72 @@ export interface TodoSnapshot {
|
|
|
33
34
|
display: TodoDisplay;
|
|
34
35
|
}
|
|
35
36
|
|
|
37
|
+
export interface TodoLines {
|
|
38
|
+
session: string;
|
|
39
|
+
branch: string | null;
|
|
40
|
+
revision: number;
|
|
41
|
+
current: string;
|
|
42
|
+
pane: string;
|
|
43
|
+
width: number;
|
|
44
|
+
lines: string[];
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Serialize only the provider's presentation. Never inspect its opaque state. */
|
|
48
|
+
export function renderTodoLines(next: TodoSnapshot, pane: string, host: TodoViewHost, width = 48): TodoLines {
|
|
49
|
+
const view = next.display.createView(host);
|
|
50
|
+
try {
|
|
51
|
+
const lines = view.render(width);
|
|
52
|
+
if (!Array.isArray(lines) || !lines.every(line => typeof line === "string")) throw new Error("Invalid todo render output");
|
|
53
|
+
return { session: next.session, branch: next.branch, revision: next.revision, current: next.display.current, pane, width, lines };
|
|
54
|
+
} finally { view.dispose(); }
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** Atomic per-pane publication into Dogsled's ledger. One ordered writer per Pi session. */
|
|
58
|
+
export class TodoPublisher {
|
|
59
|
+
private path: string | undefined;
|
|
60
|
+
private width = 48;
|
|
61
|
+
private height = 10_000;
|
|
62
|
+
private published: TodoSnapshot | undefined;
|
|
63
|
+
private queue = Promise.resolve();
|
|
64
|
+
private readonly pane: string;
|
|
65
|
+
private readonly failed: (error: unknown) => void;
|
|
66
|
+
constructor(pane: string, failed: (error: unknown) => void) { this.pane = pane; this.failed = failed; }
|
|
67
|
+
|
|
68
|
+
configure(value: unknown): void {
|
|
69
|
+
if (!record(value) || typeof value["path"] !== "string"
|
|
70
|
+
|| !Number.isInteger(value["width"]) || Number(value["width"]) < 1 || Number(value["width"]) > 65535
|
|
71
|
+
|| !Number.isInteger(value["height"]) || Number(value["height"]) < 1 || Number(value["height"]) > 10_000) throw new Error("Invalid todo publication path");
|
|
72
|
+
if (this.path !== value["path"] || this.width !== value["width"] || this.height !== value["height"]) this.published = undefined;
|
|
73
|
+
this.path = value["path"];
|
|
74
|
+
this.width = Number(value["width"]);
|
|
75
|
+
this.height = Number(value["height"]);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
publish(next: TodoSnapshot | undefined, theme: TodoViewHost["theme"]): void {
|
|
79
|
+
const path = this.path;
|
|
80
|
+
if (!path || (next && next === this.published)) return;
|
|
81
|
+
// Render now, while this revision still owns the provider capability.
|
|
82
|
+
const payload = next ? renderTodoLines(next, this.pane, { theme, height: () => this.height, requestRender() {} }, this.width) : undefined;
|
|
83
|
+
this.published = next;
|
|
84
|
+
this.queue = this.queue.then(async () => {
|
|
85
|
+
if (!payload) { await rm(path, { force: true }); return; }
|
|
86
|
+
const temporary = `${path}.${randomUUID()}.tmp`;
|
|
87
|
+
try {
|
|
88
|
+
await writeFile(temporary, JSON.stringify(payload), { flag: "wx", mode: 0o600 });
|
|
89
|
+
await rename(temporary, path);
|
|
90
|
+
} finally { await rm(temporary, { force: true }); }
|
|
91
|
+
}).catch(error => { this.published = undefined; this.failed(error); });
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
async clear(): Promise<void> {
|
|
95
|
+
const path = this.path;
|
|
96
|
+
this.published = undefined;
|
|
97
|
+
this.queue = this.queue.then(async () => { if (path) await rm(path, { force: true }); }).catch(this.failed);
|
|
98
|
+
await this.queue;
|
|
99
|
+
}
|
|
100
|
+
async flushed(): Promise<void> { await this.queue; }
|
|
101
|
+
}
|
|
102
|
+
|
|
36
103
|
type Bus = ExtensionAPI["events"];
|
|
37
104
|
function record(value: unknown): value is Record<string, unknown> { return typeof value === "object" && value !== null; }
|
|
38
105
|
function isDisplay(value: unknown): boolean {
|
|
@@ -52,12 +52,11 @@ dogsled inbox list
|
|
|
52
52
|
|
|
53
53
|
## Closing
|
|
54
54
|
|
|
55
|
-
|
|
55
|
+
`done` means your work is finished: hand it back, release your resources, and end your agent. Call it during the final working turn, after committing changes. The child host captures your reply and closes your pane and agent worktree when the turn ends. Your branch stays for the owner to land. Closed children remain under TO LAND until integration or branch deletion.
|
|
56
56
|
|
|
57
|
-
|
|
58
|
-
- a writer closes once its branch has landed. Until then it shows under TO LAND: merge or drop the branch.
|
|
57
|
+
`done` refuses open children, queued tickets, dirty agent worktrees, and removal that loses content with the branch kept. New inbox work during the same working turn cancels the mark. After the turn ends, messages fail with `<name> finished; start a new child for more work`.
|
|
59
58
|
|
|
60
|
-
|
|
59
|
+
Without its own `done`, a child stays open. Questions and orchestration do not authorize closure. Busy panes and the caller never close automatically. Shared worktrees stay. A primary pane stays if its closure would close linked workspaces.
|
|
61
60
|
|
|
62
61
|
When you are a child, call `done` once, in the turn that completes your whole task, then end the turn with your final reply. Do not call it when you ask a question or wait for your own children; `done` is refused while you own open children or queued work. To end a child now:
|
|
63
62
|
|