pi-herdsman 0.38.1 → 0.40.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/CHANGELOG.md +83 -0
- package/README.md +12 -5
- package/SKILL.md +12 -5
- package/dist/agents/generalist.md +1 -1
- package/dist/agents/implementer.md +1 -1
- package/dist/agents/validator.md +31 -0
- package/dist/index.js +1543 -641
- package/dist/index.js.map +3 -3
- package/dist/peer-bridge.js.map +2 -2
- package/docs/adr/0015-use-reserved-definition-for-managed-project-leads.md +4 -0
- package/docs/adr/0034-separate-definition-namespaces.md +4 -0
- package/docs/adr/0037-prioritize-project-definition-overlays.md +32 -0
- package/docs/adr/0038-private-repository-definition-overlays.md +43 -0
- package/docs/adr/0039-use-coordinator-profile-directories.md +55 -0
- package/docs/concepts/agents.md +8 -4
- package/docs/concepts/coordination.md +6 -2
- package/docs/coordination-api.md +5 -0
- package/docs/development/smoke-testing.md +12 -10
- package/docs/guides/agent-definitions.md +72 -24
- package/docs/guides/customizing-agents.md +53 -23
- package/docs/guides/project-orchestration.md +25 -10
- package/docs/guides/recovery.md +11 -3
- package/docs/reference/agent-definition-schema.md +45 -16
- package/docs/reference/agent.md +26 -13
- package/docs/reference/commands.md +18 -13
- package/docs/reference/staff.md +41 -11
- package/docs/reference/status-widget.md +14 -4
- package/package.json +1 -1
- package/skills/agent-definitions/SKILL.md +50 -15
- /package/dist/{roles → coordinators}/chief.md +0 -0
- /package/dist/{roles → coordinators}/flexible-lead.md +0 -0
- /package/dist/{roles → coordinators}/managed-lead.md +0 -0
- /package/dist/{roles → coordinators}/manager.md +0 -0
- /package/dist/{roles → coordinators}/orchestrator-lead.md +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,13 +2,96 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
### Features
|
|
6
|
+
|
|
7
|
+
* **config:** Edit Agent settings in the most specific existing definition
|
|
8
|
+
source, with explicit scope selection and source-local reset behavior.
|
|
9
|
+
* **config:** Add a private repository definition overlay shared by trusted
|
|
10
|
+
linked worktrees in one clone (`bundled < global < trusted project < private
|
|
11
|
+
repository`).
|
|
12
|
+
|
|
5
13
|
### Breaking changes
|
|
6
14
|
|
|
15
|
+
* **config:** Trusted project Agent and role-profile definitions now override global definitions (`bundled < global < trusted project`). Projects may override global `enabled`, `tools`, `agents`, and `permission` values; review trusted project files accordingly.
|
|
7
16
|
* **config:** Role profiles now use `pi-herdsman/roles/` under the Pi
|
|
8
17
|
agent directory and trusted project `.pi/`, separate from Agent definitions.
|
|
9
18
|
Move existing role overrides from `agents/` to `pi-herdsman/roles/` in the
|
|
10
19
|
same scope. Reserved role names in `agents/` are rejected.
|
|
11
20
|
|
|
21
|
+
## [0.40.0](https://github.com/boadij/pi-herdsman/compare/v0.39.0...v0.40.0) (2026-11-05)
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
### ⚠ BREAKING CHANGES
|
|
25
|
+
|
|
26
|
+
* **config:** standardize coordinator profile directories ([#821](https://github.com/boadij/pi-herdsman/issues/821))
|
|
27
|
+
|
|
28
|
+
### Features
|
|
29
|
+
|
|
30
|
+
* **agents:** bundle validator and enable PowerShell for executors ([#817](https://github.com/boadij/pi-herdsman/issues/817)) ([a04e7a4](https://github.com/boadij/pi-herdsman/commit/a04e7a496906371616910d9a83950a813292bd63))
|
|
31
|
+
* **agent:** support semantic result continuation ([#824](https://github.com/boadij/pi-herdsman/issues/824)) ([eaa13e7](https://github.com/boadij/pi-herdsman/commit/eaa13e7864074fbb4ce4116578f87b4bc9731319))
|
|
32
|
+
* **config:** edit settings in their owning definition scope ([#820](https://github.com/boadij/pi-herdsman/issues/820)) ([32da2ed](https://github.com/boadij/pi-herdsman/commit/32da2ed8c4b66c0b7c433a9192155d18871a7d71))
|
|
33
|
+
* **config:** support private repository definitions across worktrees ([#815](https://github.com/boadij/pi-herdsman/issues/815)) ([9b3fe4e](https://github.com/boadij/pi-herdsman/commit/9b3fe4e799ed8a8e59e7098d95a09198c1618d8d))
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
### Fixes
|
|
37
|
+
|
|
38
|
+
* **ci:** temporarily extend Windows suite deadline ([#827](https://github.com/boadij/pi-herdsman/issues/827)) ([499cda1](https://github.com/boadij/pi-herdsman/commit/499cda13ec82a4aff3927e13eb1e37cb1bdf2044))
|
|
39
|
+
* **lifecycle:** make hierarchical shutdown reliable ([#823](https://github.com/boadij/pi-herdsman/issues/823)) ([3892336](https://github.com/boadij/pi-herdsman/commit/38923363359fe109cf0803d6b852a100484ea097))
|
|
40
|
+
* **manager:** prevent redundant resume instructions ([#828](https://github.com/boadij/pi-herdsman/issues/828)) ([4a82f12](https://github.com/boadij/pi-herdsman/commit/4a82f122c606c86ebd16a2e0219b4bc18330ad90))
|
|
41
|
+
* **manager:** scope resume topology revalidation to verified checkout ([#831](https://github.com/boadij/pi-herdsman/issues/831)) ([03f3c53](https://github.com/boadij/pi-herdsman/commit/03f3c5367c85dc02a579d172eb840a33d6dbdc55)), closes [#830](https://github.com/boadij/pi-herdsman/issues/830)
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
### Refactoring
|
|
45
|
+
|
|
46
|
+
* **config:** standardize coordinator profile directories ([#821](https://github.com/boadij/pi-herdsman/issues/821)) ([08a140c](https://github.com/boadij/pi-herdsman/commit/08a140c1789a075a2bbf8a5a5f90a3423115014d)), closes [#734](https://github.com/boadij/pi-herdsman/issues/734)
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
### Tests
|
|
50
|
+
|
|
51
|
+
* **ci:** add Windows startup timing diagnostics ([#825](https://github.com/boadij/pi-herdsman/issues/825)) ([53c8af4](https://github.com/boadij/pi-herdsman/commit/53c8af415f6ddfd5e1b9548f2061d5f235fc26b0))
|
|
52
|
+
* **supervision:** release deferred Git sample on abort ([#829](https://github.com/boadij/pi-herdsman/issues/829)) ([bcab33e](https://github.com/boadij/pi-herdsman/commit/bcab33e02a9035453287ffbaae2d39f977060062))
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
### Other Changes
|
|
56
|
+
|
|
57
|
+
* **deps:** update ghcr.io/jdx/mise docker tag to v2026.11.1 ([#818](https://github.com/boadij/pi-herdsman/issues/818)) ([8ad2a66](https://github.com/boadij/pi-herdsman/commit/8ad2a662e36e9fad7e69c61768a6933f7a352177))
|
|
58
|
+
* **deps:** update ghcr.io/jdx/mise docker tag to v2026.11.2 ([#826](https://github.com/boadij/pi-herdsman/issues/826)) ([cb0057b](https://github.com/boadij/pi-herdsman/commit/cb0057b9ffe624bab918f680a6ce699d3fa49be6))
|
|
59
|
+
|
|
60
|
+
## [0.39.0](https://github.com/boadij/pi-herdsman/compare/v0.38.1...v0.39.0) (2026-11-04)
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
### ⚠ BREAKING CHANGES
|
|
64
|
+
|
|
65
|
+
* **config:** prioritize trusted project definition overlays ([#813](https://github.com/boadij/pi-herdsman/issues/813))
|
|
66
|
+
* **manager:** require instructions when resuming work ([#804](https://github.com/boadij/pi-herdsman/issues/804))
|
|
67
|
+
|
|
68
|
+
### Features
|
|
69
|
+
|
|
70
|
+
* **manager:** require instructions when resuming work ([#804](https://github.com/boadij/pi-herdsman/issues/804)) ([bda3c3f](https://github.com/boadij/pi-herdsman/commit/bda3c3f1910f68bcad8a828ee4979688c208fd2e))
|
|
71
|
+
* **manager:** support evidence handoffs in resume_work ([#810](https://github.com/boadij/pi-herdsman/issues/810)) ([0ba2d9c](https://github.com/boadij/pi-herdsman/commit/0ba2d9c7d0435ee529c1944f95a72459578888a4))
|
|
72
|
+
* **ui:** place paused Manager work last ([#808](https://github.com/boadij/pi-herdsman/issues/808)) ([9d152ba](https://github.com/boadij/pi-herdsman/commit/9d152ba1aeac063b1f4ebece4ce8a814f13ef3eb))
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
### Fixes
|
|
76
|
+
|
|
77
|
+
* **ci:** use native Herdr startup in peer federation smoke ([#796](https://github.com/boadij/pi-herdsman/issues/796)) ([62628eb](https://github.com/boadij/pi-herdsman/commit/62628eb95d7d0427cdb1c97b734aa102ed1d524f))
|
|
78
|
+
* **ui:** prioritize Manager Git diffs on narrow screens ([#800](https://github.com/boadij/pi-herdsman/issues/800)) ([75be9c5](https://github.com/boadij/pi-herdsman/commit/75be9c5cf6c8e82a7ce0cce31fb4a68735d3fd08))
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
### Refactoring
|
|
82
|
+
|
|
83
|
+
* **config:** prioritize trusted project definition overlays ([#813](https://github.com/boadij/pi-herdsman/issues/813)) ([4c14646](https://github.com/boadij/pi-herdsman/commit/4c1464602551ea709c2f13fb123b81d97a829815))
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
### Documentation
|
|
87
|
+
|
|
88
|
+
* **readme:** clarify federated peer communication status ([#799](https://github.com/boadij/pi-herdsman/issues/799)) ([c57e147](https://github.com/boadij/pi-herdsman/commit/c57e14749a297e666c4ecf34b277200ca95aad88))
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
### Other Changes
|
|
92
|
+
|
|
93
|
+
* **deps:** update ghcr.io/jdx/mise docker tag to v2026.11.0 ([#809](https://github.com/boadij/pi-herdsman/issues/809)) ([fc7ba70](https://github.com/boadij/pi-herdsman/commit/fc7ba7040bdfc229d792d5fe25b11eb23ed21d4c))
|
|
94
|
+
|
|
12
95
|
## [0.38.1](https://github.com/boadij/pi-herdsman/compare/v0.38.0...v0.38.1) (2026-11-03)
|
|
13
96
|
|
|
14
97
|
|
package/README.md
CHANGED
|
@@ -127,11 +127,18 @@ workflow.
|
|
|
127
127
|
Pi Herdsman is actively evolving. Core orchestration workflows are available today,
|
|
128
128
|
while other areas are being refined or expanded.
|
|
129
129
|
|
|
130
|
-
| Area
|
|
131
|
-
|
|
|
132
|
-
| **Lead & Agent orchestration**
|
|
133
|
-
| **Manager orchestration**
|
|
134
|
-
| **Chief coordination**
|
|
130
|
+
| Area | Status | What to expect |
|
|
131
|
+
| -------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
132
|
+
| **Lead & Agent orchestration** | ✅ **Core complete** | Background and nested delegation, result handoffs, and local peer communication. Ongoing reliability fixes. |
|
|
133
|
+
| **Manager orchestration** | ✨ **Polishing** | Branch-based delegation, supervision, and integration are implemented. Refining recovery and usability. |
|
|
134
|
+
| **Chief coordination** | 🚧 **In progress** | Supervision is available. Repository provisioning and Manager lifecycle orchestration are being developed. |
|
|
135
|
+
| **Federated peer communication** | 🚧 **In progress** | Cross-machine Manager/ordinary Lead messaging and durable replies work. Reverse initiation is planned. |
|
|
136
|
+
|
|
137
|
+
**Federation limitations:** Independent discovery and initiation currently require
|
|
138
|
+
an SSH route from the initiating machine. Replies work over an existing
|
|
139
|
+
correspondence without reverse SSH. See [#790](https://github.com/boadij/pi-herdsman/issues/790)
|
|
140
|
+
for bidirectional initiation and [#688](https://github.com/boadij/pi-herdsman/issues/688)
|
|
141
|
+
for cross-build messaging interoperability.
|
|
135
142
|
|
|
136
143
|
**On the roadmap:** [Coordination profiles](https://github.com/boadij/pi-herdsman/issues/734)
|
|
137
144
|
(replacing the current role-definition terminology),
|
package/SKILL.md
CHANGED
|
@@ -42,8 +42,8 @@ Use these high-salience rules for the model-facing agent boundary:
|
|
|
42
42
|
evidence is also supplied to eligible descendants automatically. Use `files` for relevant evidence
|
|
43
43
|
not registered as retained or specific to one recipient. When forwarding
|
|
44
44
|
evidence that must remain available downstream, set `retain: true` on
|
|
45
|
-
`message_staff` (Manager, retaining its message text and
|
|
46
|
-
target project assignment) or `delegate_agent` (retaining its files for
|
|
45
|
+
`message_staff` or `resume_work` (Manager, retaining its message text and
|
|
46
|
+
files for the target project assignment) or `delegate_agent` (retaining its files for
|
|
47
47
|
eligible managed Agents' own descendants).
|
|
48
48
|
Retained evidence is available to eligible descendants; inspect relevant
|
|
49
49
|
references as needed, not every entry.
|
|
@@ -78,7 +78,8 @@ configuration changes. Do not use `list_agents` merely to check progress.
|
|
|
78
78
|
|
|
79
79
|
For a new bounded delegated task, prefer `continue_agent` when a known,
|
|
80
80
|
eligible historical managed-Agent Pi session contains substantial context
|
|
81
|
-
relevant to that task.
|
|
81
|
+
relevant to that task. Use its result ref when shown, otherwise its exact session
|
|
82
|
+
ID or path. Otherwise use `delegate_agent` for a fresh assignment.
|
|
82
83
|
|
|
83
84
|
Each managed agent exists for one assignment only. After its terminal result is
|
|
84
85
|
delivered, Pi Herdsman cleans up that agent automatically. To continue completed
|
|
@@ -481,8 +482,14 @@ Pi Herdsman uses one durable vocabulary:
|
|
|
481
482
|
managed Lead, keyed by repository identity and semantic branch, not by Manager
|
|
482
483
|
session. Its branch is the work handle. A
|
|
483
484
|
Manager uses `delegate_work` with a task and optional branch to start new
|
|
484
|
-
project work, and `resume_work` with its branch
|
|
485
|
-
|
|
485
|
+
project work, and `resume_work` with its branch and required fresh instruction
|
|
486
|
+
to resume an existing assignment. Resume accepts optional `files` for
|
|
487
|
+
explicit evidence handoff and optional `retain` (default `false`) to add the
|
|
488
|
+
instruction and supplied files to the assignment's continuing requirements;
|
|
489
|
+
this does not replace the saved task. The instruction is queued separately
|
|
490
|
+
and queueing does not prove delivery. Confirmed retention is distinct from
|
|
491
|
+
enqueue and recovery outcomes. Already running Leads are not relaunched; use `message_staff` for ordinary
|
|
492
|
+
communication with known running Leads. A successful matching Herdr removal event or verified Git
|
|
486
493
|
worktree inventory showing the checkout absent retires that assignment and
|
|
487
494
|
pending project messages. Unavailable or ambiguous inventory preserves the
|
|
488
495
|
assignment. A retired assignment cannot be resumed, but new work may reuse
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Focused verification agent for running tests, checks, and smoke scenarios against existing changes; use to report observed evidence, not implement fixes or review design
|
|
3
|
+
extensions: []
|
|
4
|
+
inheritGlobalContext: false
|
|
5
|
+
inheritProjectContext: true
|
|
6
|
+
name: validator
|
|
7
|
+
noExtensions: true
|
|
8
|
+
noSkills: true
|
|
9
|
+
skills: []
|
|
10
|
+
systemPromptMode: append
|
|
11
|
+
tools: [read, bash, powershell]
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
You are validator, a verification-only agent for one explicitly assigned
|
|
15
|
+
existing change.
|
|
16
|
+
|
|
17
|
+
Read relevant instructions and validation guidance first. Choose the smallest
|
|
18
|
+
appropriate checks: focused tests for behavior, documented static/build checks,
|
|
19
|
+
and isolated smoke scenarios for integration. Treat test and smoke results as
|
|
20
|
+
distinct evidence; neither substitutes for the other.
|
|
21
|
+
|
|
22
|
+
Run only checks whose expected side effects are within the authorized scope.
|
|
23
|
+
Temporary artifacts and disposable processes are acceptable only when the check
|
|
24
|
+
isolates and cleans them up. Do not edit source, format, install dependencies,
|
|
25
|
+
stage, commit, change configuration, or modify shared systems or services.
|
|
26
|
+
If a check requires unauthorized changes, report it as blocked instead.
|
|
27
|
+
|
|
28
|
+
For each check, report the exact command, whether it completed, its exit status,
|
|
29
|
+
and relevant observed results. Distinguish passed, failed, skipped, and blocked
|
|
30
|
+
checks. Report unexpected working-tree changes or incomplete cleanup. Never
|
|
31
|
+
claim success without observing the result.
|