pi-herdsman 0.46.0 → 0.47.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/CHANGELOG.md +39 -0
- package/README.md +6 -3
- package/SKILL.md +17 -10
- package/dist/agents/generalist.md +1 -0
- package/dist/agents/implementer.md +1 -0
- package/dist/agents/researcher.md +2 -0
- package/dist/agents/reviewer.md +1 -0
- package/dist/agents/scout.md +1 -0
- package/dist/agents/validator.md +1 -0
- package/dist/coordinators/chief.md +0 -2
- package/dist/coordinators/managed-lead.md +2 -1
- package/dist/coordinators/manager.md +0 -2
- package/dist/index.js +405 -96
- package/dist/index.js.map +3 -3
- package/docs/concepts/lifecycle.md +11 -6
- package/docs/development/instruction-interface-design.md +8 -0
- package/docs/development/product-philosophy.md +18 -0
- package/docs/development/smoke-testing.md +32 -15
- package/docs/getting-started.md +13 -3
- package/docs/guides/agent-definitions.md +83 -13
- package/docs/guides/container-deployment.md +25 -0
- package/docs/guides/customizing-agents.md +29 -1
- package/docs/guides/handoffs.md +25 -19
- package/docs/guides/recovery.md +23 -8
- package/docs/reference/agent-definition-schema.md +55 -25
- package/docs/reference/agent-states.md +16 -11
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,44 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.47.1](https://github.com/boadij/pi-herdsman/compare/v0.47.0...v0.47.1) (2026-11-14)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Refactoring
|
|
7
|
+
|
|
8
|
+
* **instructions:** deduplicate coordinator role headings ([#979](https://github.com/boadij/pi-herdsman/issues/979)) ([b3ef842](https://github.com/boadij/pi-herdsman/commit/b3ef842932d1a24cd8b0fb117f9983ba04d4f141))
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Documentation
|
|
12
|
+
|
|
13
|
+
* **agents:** explain specialization and harness composition ([#982](https://github.com/boadij/pi-herdsman/issues/982)) ([45d267b](https://github.com/boadij/pi-herdsman/commit/45d267ba24faef50ce5337fe37dd64b9dc4e75eb))
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
### Tests
|
|
17
|
+
|
|
18
|
+
* **ci:** initialize only required federation roles ([#980](https://github.com/boadij/pi-herdsman/issues/980)) ([28de378](https://github.com/boadij/pi-herdsman/commit/28de378bb856d27257711c8d7d87bad0a18eb48f))
|
|
19
|
+
|
|
20
|
+
## [0.47.0](https://github.com/boadij/pi-herdsman/compare/v0.46.0...v0.47.0) (2026-11-14)
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
### Features
|
|
24
|
+
|
|
25
|
+
* **context:** scope bundled agents and managed leads to worktrees ([#973](https://github.com/boadij/pi-herdsman/issues/973)) ([f273fb7](https://github.com/boadij/pi-herdsman/commit/f273fb752277e4099bcaea1e007237e82ace2aed))
|
|
26
|
+
* **onboarding:** integrate optional web access ([#965](https://github.com/boadij/pi-herdsman/issues/965)) ([4c4e0c8](https://github.com/boadij/pi-herdsman/commit/4c4e0c8df03d5e353af9664abae07d8d3e71e523))
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
### Fixes
|
|
30
|
+
|
|
31
|
+
* **agent:** preserve provider causes in execution-error results ([#966](https://github.com/boadij/pi-herdsman/issues/966)) ([c7c610b](https://github.com/boadij/pi-herdsman/commit/c7c610b0bf3b9add9c47ad77160d2a1a986a09fa))
|
|
32
|
+
* **agent:** surface Pi errors on Herdr startup timeout ([#972](https://github.com/boadij/pi-herdsman/issues/972)) ([f90310a](https://github.com/boadij/pi-herdsman/commit/f90310a45ec28d610f92cdf8865b9bb9d6515d91))
|
|
33
|
+
* **evidence:** expose retained refs in initial Lead assignments ([#968](https://github.com/boadij/pi-herdsman/issues/968)) ([31b2e2c](https://github.com/boadij/pi-herdsman/commit/31b2e2ca5649a950693d2eecea4d76dfb2654890))
|
|
34
|
+
* **instructions:** clarify internal message provenance ([#976](https://github.com/boadij/pi-herdsman/issues/976)) ([a8456a2](https://github.com/boadij/pi-herdsman/commit/a8456a20f28d6fc9cbfc52cd8cb0524abeed6639))
|
|
35
|
+
* **recovery:** recover verified orphaned agent panes ([#974](https://github.com/boadij/pi-herdsman/issues/974)) ([93bb4ec](https://github.com/boadij/pi-herdsman/commit/93bb4ec6cabb01f62c69c4778aaf1cd2a55f3543))
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
### Documentation
|
|
39
|
+
|
|
40
|
+
* credit [@aholbreich](https://github.com/aholbreich) for PR [#966](https://github.com/boadij/pi-herdsman/issues/966) ([#977](https://github.com/boadij/pi-herdsman/issues/977)) ([80b40a4](https://github.com/boadij/pi-herdsman/commit/80b40a4b50a98a60bfc90b73063ec2467b808f77))
|
|
41
|
+
|
|
3
42
|
## [0.46.0](https://github.com/boadij/pi-herdsman/compare/v0.45.0...v0.46.0) (2026-11-13)
|
|
4
43
|
|
|
5
44
|
|
package/README.md
CHANGED
|
@@ -25,9 +25,12 @@ parallelize tasks as results arrive. The execution path emerges at runtime,
|
|
|
25
25
|
while Herdsman enforces delegation permissions, ownership, project assignments,
|
|
26
26
|
and supervision.
|
|
27
27
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
28
|
+
Specialize Agents by responsibility and compose their execution capabilities
|
|
29
|
+
through models, instructions, tools, and Pi extensions. Reuse shared expertise
|
|
30
|
+
as preloaded instructions or on-demand skills. Herdsman coordinates bounded
|
|
31
|
+
work without owning domain-specific behavior. Bring your own definitions or
|
|
32
|
+
workflows; see [Agent definitions](docs/guides/agent-definitions.md) and
|
|
33
|
+
[Coordination](docs/concepts/coordination.md#emergent-workflows-explicit-boundaries).
|
|
31
34
|
|
|
32
35
|
## Demo
|
|
33
36
|
|
package/SKILL.md
CHANGED
|
@@ -150,9 +150,16 @@ Skills are separate. Attach a required SKILL.md only when the task needs it and
|
|
|
150
150
|
the selected definition does not already provide that skill. Ordinary relevant
|
|
151
151
|
source, documentation, configuration, and evidence files remain attachable.
|
|
152
152
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
153
|
+
Attachment handling depends on the operation. Explicit Agent attachments and
|
|
154
|
+
ordinary coordination attachments deliver only complete supported strict UTF-8
|
|
155
|
+
text within the applicable per-file and complete-message limits; unsupported or
|
|
156
|
+
non-fitting content rejects the operation rather than falling back to a local
|
|
157
|
+
path. Initial `delegate_work` text attachments are retained as snapshots. When
|
|
158
|
+
such a snapshot does not fit inline, it is represented by its semantic
|
|
159
|
+
`evidence:` reference. Previously accepted required evidence can be forwarded
|
|
160
|
+
by its authorized semantic reference; a reference alone does not grant access.
|
|
161
|
+
Authorized recipients retrieve bounded content with `read_evidence`. Embedded
|
|
162
|
+
content is a submission-time snapshot. `files` transfers content or evidence
|
|
156
163
|
references, not tools or runtime capabilities.
|
|
157
164
|
|
|
158
165
|
Pass relevant files and completed agent results through `files`. Agent
|
|
@@ -231,13 +238,13 @@ work still blocks escalation.
|
|
|
231
238
|
Work only on the assigned objective and preserve its stated scope, constraints,
|
|
232
239
|
authority, and acceptance criteria.
|
|
233
240
|
|
|
234
|
-
Treat supplied files as message evidence.
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
+
Treat supplied files as message evidence. Explicit Agent attachments must
|
|
242
|
+
contain complete supported UTF-8 text within configured limits, or the handoff
|
|
243
|
+
is rejected. Retained assignment evidence, including accepted managed-Agent
|
|
244
|
+
tasks, is preserved and can be presented by an authorized semantic reference
|
|
245
|
+
retrieved with `read_evidence`; supported text up to 1 MiB is retained and
|
|
246
|
+
automatically propagated to new descendants, while unsupported or oversized
|
|
247
|
+
evidence cannot be registered. Reuse adequate existing evidence
|
|
241
248
|
instead of repeating completed work.
|
|
242
249
|
Do not overlap writers in a worktree or file-ownership boundary. For dependent
|
|
243
250
|
work, pass reusable direct-agent result refs through `files`. Preserve canonical
|
|
@@ -3,6 +3,7 @@ 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
4
|
extensions: [builtin:codemode]
|
|
5
5
|
inheritGlobalContext: false
|
|
6
|
+
inheritAncestorContext: false
|
|
6
7
|
inheritProjectContext: true
|
|
7
8
|
name: generalist
|
|
8
9
|
noExtensions: true
|
|
@@ -3,6 +3,7 @@ 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
4
|
extensions: [builtin:codemode]
|
|
5
5
|
inheritGlobalContext: false
|
|
6
|
+
inheritAncestorContext: false
|
|
6
7
|
inheritProjectContext: true
|
|
7
8
|
name: implementer
|
|
8
9
|
noExtensions: true
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: External research specialist for questions that require web, documentation, standards, vendor, or other authoritative evidence beyond the repository; use for current facts, API behavior, comparisons, and source-backed recommendations
|
|
3
3
|
inheritGlobalContext: false
|
|
4
|
+
inheritAncestorContext: false
|
|
4
5
|
inheritProjectContext: true
|
|
5
6
|
name: researcher
|
|
6
7
|
noSkills: true
|
|
@@ -12,6 +13,7 @@ tools:
|
|
|
12
13
|
ls,
|
|
13
14
|
find,
|
|
14
15
|
grep,
|
|
16
|
+
web_enable,
|
|
15
17
|
web_search,
|
|
16
18
|
fetch_content,
|
|
17
19
|
get_search_content,
|
package/dist/agents/reviewer.md
CHANGED
|
@@ -3,6 +3,7 @@ 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
4
|
extensions: [builtin:codemode]
|
|
5
5
|
inheritGlobalContext: false
|
|
6
|
+
inheritAncestorContext: false
|
|
6
7
|
inheritProjectContext: true
|
|
7
8
|
name: reviewer
|
|
8
9
|
noExtensions: true
|
package/dist/agents/scout.md
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
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
3
|
extensions: [builtin:codemode]
|
|
4
4
|
inheritGlobalContext: false
|
|
5
|
+
inheritAncestorContext: false
|
|
5
6
|
inheritProjectContext: true
|
|
6
7
|
name: scout
|
|
7
8
|
noExtensions: true
|
package/dist/agents/validator.md
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
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
3
|
extensions: [builtin:codemode]
|
|
4
4
|
inheritGlobalContext: false
|
|
5
|
+
inheritAncestorContext: false
|
|
5
6
|
inheritProjectContext: true
|
|
6
7
|
name: validator
|
|
7
8
|
noExtensions: true
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Manager-created project Lead for branch-scoped orchestration and integration
|
|
3
|
-
inheritGlobalContext:
|
|
3
|
+
inheritGlobalContext: false
|
|
4
|
+
inheritAncestorContext: false
|
|
4
5
|
inheritProjectContext: true
|
|
5
6
|
name: managed-lead
|
|
6
7
|
extensions: [builtin:codemode]
|