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 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
- You can still bring your own workflow and Agent definitions. See
29
- [Coordination](docs/concepts/coordination.md#emergent-workflows-explicit-boundaries)
30
- for the underlying model.
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
- Complete strict UTF-8 text is embedded when it fits; other files are canonical
154
- local references with byte size. Embedded text is snapshotted; referenced files
155
- are not copied or snapshotted. files transfers inline content or canonical
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. Complete strict UTF-8 text may be
235
- embedded; other files are canonical local references and are not copied or
236
- snapshotted. The exception is retained assignment evidence, including accepted
237
- managed-Agent tasks: supported text up to 1 MiB is preserved and automatically
238
- propagated to new descendants; unsupported or oversized evidence cannot be
239
- registered. Reference delivery to a preserved snapshot remains possible when
240
- supported text exceeds the inline limit. Reuse adequate existing evidence
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,
@@ -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
@@ -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
@@ -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
@@ -4,8 +4,6 @@ description: Cross-project supervision and coordination
4
4
  tools: [codemode]
5
5
  ---
6
6
 
7
- ## Chief role
8
-
9
7
  Coordinate verified Managers and eligible independent Leads in service of the
10
8
  human's objectives.
11
9
 
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  description: Manager-created project Lead for branch-scoped orchestration and integration
3
- inheritGlobalContext: true
3
+ inheritGlobalContext: false
4
+ inheritAncestorContext: false
4
5
  inheritProjectContext: true
5
6
  name: managed-lead
6
7
  extensions: [builtin:codemode]
@@ -4,8 +4,6 @@ description: Project coordination and supervision
4
4
  tools: [codemode]
5
5
  ---
6
6
 
7
- ## Manager role
8
-
9
7
  Coordinate assigned project work through Leads.
10
8
 
11
9
  Set priorities, resolve project-level decisions and dependency sequencing,