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.
Files changed (34) hide show
  1. package/CHANGELOG.md +83 -0
  2. package/README.md +12 -5
  3. package/SKILL.md +12 -5
  4. package/dist/agents/generalist.md +1 -1
  5. package/dist/agents/implementer.md +1 -1
  6. package/dist/agents/validator.md +31 -0
  7. package/dist/index.js +1543 -641
  8. package/dist/index.js.map +3 -3
  9. package/dist/peer-bridge.js.map +2 -2
  10. package/docs/adr/0015-use-reserved-definition-for-managed-project-leads.md +4 -0
  11. package/docs/adr/0034-separate-definition-namespaces.md +4 -0
  12. package/docs/adr/0037-prioritize-project-definition-overlays.md +32 -0
  13. package/docs/adr/0038-private-repository-definition-overlays.md +43 -0
  14. package/docs/adr/0039-use-coordinator-profile-directories.md +55 -0
  15. package/docs/concepts/agents.md +8 -4
  16. package/docs/concepts/coordination.md +6 -2
  17. package/docs/coordination-api.md +5 -0
  18. package/docs/development/smoke-testing.md +12 -10
  19. package/docs/guides/agent-definitions.md +72 -24
  20. package/docs/guides/customizing-agents.md +53 -23
  21. package/docs/guides/project-orchestration.md +25 -10
  22. package/docs/guides/recovery.md +11 -3
  23. package/docs/reference/agent-definition-schema.md +45 -16
  24. package/docs/reference/agent.md +26 -13
  25. package/docs/reference/commands.md +18 -13
  26. package/docs/reference/staff.md +41 -11
  27. package/docs/reference/status-widget.md +14 -4
  28. package/package.json +1 -1
  29. package/skills/agent-definitions/SKILL.md +50 -15
  30. /package/dist/{roles → coordinators}/chief.md +0 -0
  31. /package/dist/{roles → coordinators}/flexible-lead.md +0 -0
  32. /package/dist/{roles → coordinators}/managed-lead.md +0 -0
  33. /package/dist/{roles → coordinators}/manager.md +0 -0
  34. /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 | Status | What to expect |
131
- | ------------------------------ | -------------------- | ---------------------------------------------------------------------------------------------------------- |
132
- | **Lead & Agent orchestration** | ✅ **Core complete** | Background and nested delegation, result handoffs, and 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. |
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 files for the
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. Otherwise use `delegate_agent` for a fresh assignment.
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 to resume an existing
485
- assignment. A successful matching Herdr removal event or verified Git
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
@@ -9,7 +9,7 @@ noExtensions: true
9
9
  noSkills: true
10
10
  skills: []
11
11
  systemPromptMode: append
12
- tools: [read, bash, edit, write]
12
+ tools: [read, bash, powershell, edit, write]
13
13
  ---
14
14
 
15
15
  You are generalist, a general-purpose execution agent for one explicitly assigned
@@ -9,7 +9,7 @@ noExtensions: true
9
9
  noSkills: true
10
10
  skills: []
11
11
  systemPromptMode: append
12
- tools: [read, bash, edit, write]
12
+ tools: [read, bash, powershell, edit, write]
13
13
  ---
14
14
 
15
15
  You are implementer, a focused execution agent for one explicitly approved
@@ -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.