pi-herdsman 0.42.1 → 0.43.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 +35 -12
- package/README.md +3 -0
- package/SKILL.md +4 -5
- package/dist/agents/generalist.md +2 -2
- package/dist/agents/implementer.md +2 -2
- package/dist/agents/researcher.md +1 -0
- package/dist/agents/reviewer.md +2 -2
- package/dist/agents/scout.md +2 -2
- package/dist/agents/validator.md +2 -2
- package/dist/coordinators/chief.md +1 -1
- package/dist/coordinators/managed-lead.md +2 -1
- package/dist/coordinators/manager.md +5 -5
- package/dist/coordinators/orchestrator-lead.md +1 -1
- package/dist/index.js +1418 -372
- package/dist/index.js.map +3 -3
- package/dist/peer-bridge.js +16 -1
- package/dist/peer-bridge.js.map +2 -2
- package/docs/concepts/coordination.md +3 -2
- package/docs/concepts/lifecycle.md +4 -3
- package/docs/coordination-api.md +41 -0
- package/docs/development/smoke-testing.md +13 -11
- package/docs/guides/agent-definitions.md +12 -4
- package/docs/guides/project-orchestration.md +17 -6
- package/docs/reference/agent-definition-schema.md +29 -11
- package/docs/reference/agent-states.md +13 -8
- package/docs/reference/agent.md +2 -0
- package/docs/reference/configuration.md +10 -8
- package/docs/reference/staff.md +7 -6
- package/docs/reference/status-widget.md +53 -4
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,22 +1,45 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## [0.43.0](https://github.com/boadij/pi-herdsman/compare/v0.42.1...v0.43.0) (2026-11-09)
|
|
4
|
+
|
|
4
5
|
|
|
5
6
|
### Features
|
|
6
7
|
|
|
7
|
-
* **
|
|
8
|
-
|
|
9
|
-
* **
|
|
10
|
-
|
|
11
|
-
|
|
8
|
+
* **coordination:** expose sender checkout and manager Git context ([#901](https://github.com/boadij/pi-herdsman/issues/901)) ([2835bec](https://github.com/boadij/pi-herdsman/commit/2835becb93de0733901f3e829e099d5016da156f))
|
|
9
|
+
* **manager:** integrate conflict-free divergent Lead branches ([#900](https://github.com/boadij/pi-herdsman/issues/900)) ([e22667e](https://github.com/boadij/pi-herdsman/commit/e22667ece54c11b9fcda75c451f62288155479cf))
|
|
10
|
+
* **tools:** enable native Code Mode in bundled roles ([#888](https://github.com/boadij/pi-herdsman/issues/888)) ([7988a63](https://github.com/boadij/pi-herdsman/commit/7988a631e5a768abe6f41caad5dceb926d9b40ed))
|
|
11
|
+
* **tools:** support native Code Mode Agent delegation ([#889](https://github.com/boadij/pi-herdsman/issues/889)) ([807e386](https://github.com/boadij/pi-herdsman/commit/807e386a8afb2cffa14bb169e379170d5489324a))
|
|
12
|
+
* **ui:** show checkout Git state in Lead and Manager headers ([#896](https://github.com/boadij/pi-herdsman/issues/896)) ([750555e](https://github.com/boadij/pi-herdsman/commit/750555e1d81ebec75917d6dae2cb313bf1eab8bb))
|
|
13
|
+
* **ui:** show Git diff stats in managed Lead status widget ([#894](https://github.com/boadij/pi-herdsman/issues/894)) ([e20c619](https://github.com/boadij/pi-herdsman/commit/e20c61959afef00f01368105f2b81b0aa9803fa6))
|
|
14
|
+
* **ui:** show live session activity in status headers ([#902](https://github.com/boadij/pi-herdsman/issues/902)) ([581e6b1](https://github.com/boadij/pi-herdsman/commit/581e6b1b511fef3f862e694985587d01f1ef2ccc))
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Fixes
|
|
18
|
+
|
|
19
|
+
* **agent:** allow steering while waiting for child work ([#887](https://github.com/boadij/pi-herdsman/issues/887)) ([fbd27ea](https://github.com/boadij/pi-herdsman/commit/fbd27ea44035c9e9439a9c787577e4705be05318))
|
|
20
|
+
* **agents:** enable extension discovery for pinned models ([#883](https://github.com/boadij/pi-herdsman/issues/883)) ([df4a1e4](https://github.com/boadij/pi-herdsman/commit/df4a1e4bce3adb5326d35ea6770404232afce10e))
|
|
21
|
+
* **config:** isolate misplaced definitions ([#884](https://github.com/boadij/pi-herdsman/issues/884)) ([a4dcb99](https://github.com/boadij/pi-herdsman/commit/a4dcb99de47d74612a706fb4b21e1b0783aafc67))
|
|
22
|
+
* **lead:** enforce managed tool policy across reload and dispatch ([#893](https://github.com/boadij/pi-herdsman/issues/893)) ([bc45018](https://github.com/boadij/pi-herdsman/commit/bc450187f9f0bd131bb937bbced80c46e30e3e5a)), closes [#309](https://github.com/boadij/pi-herdsman/issues/309)
|
|
23
|
+
* **smoke:** retain verified root process identity during core acceptance ([#899](https://github.com/boadij/pi-herdsman/issues/899)) ([a32aacb](https://github.com/boadij/pi-herdsman/commit/a32aacbecf5ade73e161b0dcfa3b71edea9d8cc9)), closes [#897](https://github.com/boadij/pi-herdsman/issues/897)
|
|
24
|
+
* **tools:** support native code-mode coordination ([#885](https://github.com/boadij/pi-herdsman/issues/885)) ([44d6826](https://github.com/boadij/pi-herdsman/commit/44d682677c7d8b587397669bc78001a65143ecdf))
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
### Documentation
|
|
12
28
|
|
|
13
|
-
|
|
29
|
+
* keep AGENTS.md code map synchronized ([#891](https://github.com/boadij/pi-herdsman/issues/891)) ([54eb5c0](https://github.com/boadij/pi-herdsman/commit/54eb5c06089473fa3a05b0bac6858089c613f9d4))
|
|
30
|
+
* recognize community contributors ([#878](https://github.com/boadij/pi-herdsman/issues/878)) ([d19f045](https://github.com/boadij/pi-herdsman/commit/d19f04534ecc79a91637c3a725d64a5ce8c48d7e))
|
|
31
|
+
* replace obsolete backlog instructions with issue-reporting guidance ([#892](https://github.com/boadij/pi-herdsman/issues/892)) ([2f5d96b](https://github.com/boadij/pi-herdsman/commit/2f5d96bc030ab0bf6333eb793458c3f0d9433881))
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
### Tests
|
|
35
|
+
|
|
36
|
+
* tighten TypeScript fixture contracts ([#898](https://github.com/boadij/pi-herdsman/issues/898)) ([be407ed](https://github.com/boadij/pi-herdsman/commit/be407ed92a516658eeabd205eee33d4963a77146))
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
### Other Changes
|
|
14
40
|
|
|
15
|
-
* **
|
|
16
|
-
* **
|
|
17
|
-
agent directory and trusted project `.pi/`, separate from Agent definitions.
|
|
18
|
-
Move existing role overrides from `agents/` to `pi-herdsman/roles/` in the
|
|
19
|
-
same scope. Reserved role names in `agents/` are rejected.
|
|
41
|
+
* **deps:** update ghcr.io/jdx/mise docker tag to v2026.11.5 ([#890](https://github.com/boadij/pi-herdsman/issues/890)) ([89943fe](https://github.com/boadij/pi-herdsman/commit/89943fe9ad9ad0f675e64d1f8a6f92140299246f))
|
|
42
|
+
* **ui:** subtly emphasize status header roles ([#903](https://github.com/boadij/pi-herdsman/issues/903)) ([df5883c](https://github.com/boadij/pi-herdsman/commit/df5883cfdbec2dc31645d540dc0d621be9d11299))
|
|
20
43
|
|
|
21
44
|
## [0.42.1](https://github.com/boadij/pi-herdsman/compare/v0.42.0...v0.42.1) (2026-11-08)
|
|
22
45
|
|
package/README.md
CHANGED
|
@@ -187,6 +187,9 @@ Questions, workflows, examples, and ideas are welcome in
|
|
|
187
187
|
For reproducible bugs and concrete actionable work, use
|
|
188
188
|
[GitHub Issues](https://github.com/boadij/pi-herdsman/issues).
|
|
189
189
|
|
|
190
|
+
Thanks to everyone who improves Pi Herdsman through code, reports, and
|
|
191
|
+
investigations. See [Community contributors](CONTRIBUTORS.md) for acknowledgments.
|
|
192
|
+
|
|
190
193
|
## License
|
|
191
194
|
|
|
192
195
|
[Apache License 2.0](LICENSE)
|
package/SKILL.md
CHANGED
|
@@ -500,11 +500,10 @@ Pi Herdsman uses one durable vocabulary:
|
|
|
500
500
|
its remaining Git branch;
|
|
501
501
|
- the Manager owns project-level integration decisions. When separately
|
|
502
502
|
authorized by the Manager local-merge policy, it can accept the exact
|
|
503
|
-
validated source revision and use `integrate_branch` to
|
|
504
|
-
assigned branch into the verified primary branch.
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
not itself prove a content conflict. Leads retain technical integration and
|
|
503
|
+
validated source revision and use `integrate_branch` to integrate that
|
|
504
|
+
assigned branch into the verified primary branch. Divergent merge commits
|
|
505
|
+
require explicit permission and clean Git preflight; Git success is not
|
|
506
|
+
proof of semantic validation. Leads retain technical integration and
|
|
508
507
|
validation ownership. When cleanup is incomplete, `cleanup_pending` reports
|
|
509
508
|
integration separately from checkout removal and assignment retirement; an
|
|
510
509
|
authorized retry with the same accepted SHA can retry guarded cleanup,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
agents: [scout, researcher]
|
|
3
3
|
description: General-purpose execution for bounded investigation, editing, and validation; use when work spans capabilities; prefer focused specialists for narrow tasks
|
|
4
|
-
extensions: []
|
|
4
|
+
extensions: [builtin:codemode]
|
|
5
5
|
inheritGlobalContext: false
|
|
6
6
|
inheritProjectContext: true
|
|
7
7
|
name: generalist
|
|
@@ -9,7 +9,7 @@ noExtensions: true
|
|
|
9
9
|
noSkills: true
|
|
10
10
|
skills: []
|
|
11
11
|
systemPromptMode: append
|
|
12
|
-
tools: [read, bash, powershell, edit, write]
|
|
12
|
+
tools: [read, bash, powershell, edit, write, codemode]
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
You are generalist, a general-purpose execution agent for one explicitly assigned
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
agents: [scout]
|
|
3
3
|
description: Focused implementation agent for a resolved change; use when the required behavior is already decided and the task is to edit, test, and report
|
|
4
|
-
extensions: []
|
|
4
|
+
extensions: [builtin:codemode]
|
|
5
5
|
inheritGlobalContext: false
|
|
6
6
|
inheritProjectContext: true
|
|
7
7
|
name: implementer
|
|
@@ -9,7 +9,7 @@ noExtensions: true
|
|
|
9
9
|
noSkills: true
|
|
10
10
|
skills: []
|
|
11
11
|
systemPromptMode: append
|
|
12
|
-
tools: [read, bash, powershell, edit, write]
|
|
12
|
+
tools: [read, bash, powershell, edit, write, codemode]
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
You are implementer, a focused execution agent for one explicitly approved
|
package/dist/agents/reviewer.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
agents: [scout, researcher]
|
|
3
3
|
description: Independent read-only internal team reviewer for plans, diffs, implementations, and codebase health; use for verification, missing cases, and regressions, not user or supervisor approval
|
|
4
|
-
extensions: []
|
|
4
|
+
extensions: [builtin:codemode]
|
|
5
5
|
inheritGlobalContext: false
|
|
6
6
|
inheritProjectContext: true
|
|
7
7
|
name: reviewer
|
|
@@ -9,7 +9,7 @@ noExtensions: true
|
|
|
9
9
|
noSkills: true
|
|
10
10
|
skills: []
|
|
11
11
|
systemPromptMode: append
|
|
12
|
-
tools: [read, ls, find, grep]
|
|
12
|
+
tools: [read, ls, find, grep, codemode]
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
You are reviewer, a disciplined, strictly read-only review agent. Preserve
|
package/dist/agents/scout.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Read-only codebase reconnaissance for unfamiliar areas; use to find entry points, trace flows, dependencies, constraints, and risks before deciding or editing
|
|
3
|
-
extensions: []
|
|
3
|
+
extensions: [builtin:codemode]
|
|
4
4
|
inheritGlobalContext: false
|
|
5
5
|
inheritProjectContext: true
|
|
6
6
|
name: scout
|
|
@@ -8,7 +8,7 @@ noExtensions: true
|
|
|
8
8
|
noSkills: true
|
|
9
9
|
skills: []
|
|
10
10
|
systemPromptMode: append
|
|
11
|
-
tools: [read, ls, find, grep]
|
|
11
|
+
tools: [read, ls, find, grep, codemode]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
14
|
You are scout, a focused read-only codebase reconnaissance agent. Return only
|
package/dist/agents/validator.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
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: []
|
|
3
|
+
extensions: [builtin:codemode]
|
|
4
4
|
inheritGlobalContext: false
|
|
5
5
|
inheritProjectContext: true
|
|
6
6
|
name: validator
|
|
@@ -8,7 +8,7 @@ noExtensions: true
|
|
|
8
8
|
noSkills: true
|
|
9
9
|
skills: []
|
|
10
10
|
systemPromptMode: append
|
|
11
|
-
tools: [read, bash, powershell]
|
|
11
|
+
tools: [read, bash, powershell, codemode]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
14
|
You are validator, a verification-only agent for one explicitly assigned
|
|
@@ -3,10 +3,11 @@ description: Manager-created project Lead for branch-scoped orchestration and in
|
|
|
3
3
|
inheritGlobalContext: true
|
|
4
4
|
inheritProjectContext: true
|
|
5
5
|
name: managed-lead
|
|
6
|
+
extensions: [builtin:codemode]
|
|
6
7
|
noExtensions: true
|
|
7
8
|
noSkills: true
|
|
8
9
|
systemPromptMode: append
|
|
9
|
-
tools: []
|
|
10
|
+
tools: [codemode]
|
|
10
11
|
---
|
|
11
12
|
|
|
12
13
|
Delegate bounded project execution to Agents whenever an Agent can reasonably own it.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: manager
|
|
3
3
|
description: Project coordination and supervision
|
|
4
|
-
tools: []
|
|
4
|
+
tools: [codemode]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
## Manager role
|
|
@@ -21,10 +21,10 @@ the work yourself.
|
|
|
21
21
|
|
|
22
22
|
When local Manager merge permission is enabled, you may use `integrate_branch`
|
|
23
23
|
only for an exact assigned branch after accepting its validated full source
|
|
24
|
-
SHA.
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
24
|
+
SHA. Permission may be fast-forward-only or explicitly allow conflict-free
|
|
25
|
+
divergent merge commits. A conflict is preflighted before stopping the Lead;
|
|
26
|
+
preflight success is not validation evidence. If combined validation is
|
|
27
|
+
required, obtain it through the responsible Lead before accepting the result.
|
|
28
28
|
Successful integration can automatically remove that exact source worktree
|
|
29
29
|
and retire its assignment. You retain project-level acceptance authority;
|
|
30
30
|
the Lead retains technical resolution and validation ownership.
|