pi-herdsman 0.3.0 → 0.3.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.
|
@@ -26,7 +26,10 @@ The supported repository contract requires:
|
|
|
26
26
|
- herdr `>=0.8.0`
|
|
27
27
|
- herdr Pi integration version `2` or newer
|
|
28
28
|
|
|
29
|
-
Run
|
|
29
|
+
Run focused tests and other intermediate checks before this smoke suite. Do
|
|
30
|
+
not format during smoke testing; complete smoke testing and review before the
|
|
31
|
+
final formatting and read-only verification sequence in
|
|
32
|
+
[Development validation](validation.md).
|
|
30
33
|
|
|
31
34
|
## Current mailbox contract
|
|
32
35
|
|
|
@@ -5,16 +5,24 @@
|
|
|
5
5
|
Repository handoff is not complete until the current validation gates have been
|
|
6
6
|
run or a concrete environment blocker is recorded.
|
|
7
7
|
|
|
8
|
-
##
|
|
8
|
+
## Validation order
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
Focused tests, smoke testing, review, and all intermediate checks happen first.
|
|
11
|
+
Do not format during those phases. Once implementation and review are
|
|
12
|
+
complete, run the following as the final pre-commit sequence:
|
|
11
13
|
|
|
12
14
|
```sh
|
|
15
|
+
# Final pre-commit mutation; run once only.
|
|
13
16
|
prettier . --write
|
|
17
|
+
|
|
18
|
+
# Read-only verification before staging or committing.
|
|
14
19
|
npm run check
|
|
15
20
|
git diff --check
|
|
16
21
|
```
|
|
17
22
|
|
|
23
|
+
Do not run formatting again between these verification commands and staging or
|
|
24
|
+
committing.
|
|
25
|
+
|
|
18
26
|
When reviewing staged work, also run as appropriate:
|
|
19
27
|
|
|
20
28
|
```sh
|
|
@@ -82,13 +90,15 @@ tracked separately in [Smoke testing](smoke-testing.md).
|
|
|
82
90
|
File selection is the primary focusing mechanism. A name pattern narrows the
|
|
83
91
|
tests within the selected file; it does not select which files Node loads.
|
|
84
92
|
|
|
85
|
-
|
|
93
|
+
After focused tests, smoke testing, review, and intermediate checks are
|
|
94
|
+
complete, run the final pre-commit sequence above. The full repository check is
|
|
95
|
+
the read-only verification step:
|
|
86
96
|
|
|
87
97
|
```sh
|
|
88
98
|
npm run check
|
|
89
99
|
```
|
|
90
100
|
|
|
91
|
-
`npm run check` remains the bounded full
|
|
101
|
+
`npm run check` remains the bounded full check, including process-group cleanup
|
|
92
102
|
when the test runner times out or leaks descendants.
|
|
93
103
|
|
|
94
104
|
## Dependency availability
|
|
@@ -19,8 +19,21 @@ tools: ["read", "bash"]
|
|
|
19
19
|
Prompt body.
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
22
|
+
Agent definitions use YAML frontmatter. Array fields accept normal YAML flow or
|
|
23
|
+
block sequences.
|
|
24
|
+
|
|
25
|
+
For example, block sequences are valid for array fields:
|
|
26
|
+
|
|
27
|
+
```yaml
|
|
28
|
+
---
|
|
29
|
+
name: reviewer
|
|
30
|
+
tools:
|
|
31
|
+
- read
|
|
32
|
+
- grep
|
|
33
|
+
skills:
|
|
34
|
+
- "/absolute/path/to/code-review/SKILL.md"
|
|
35
|
+
---
|
|
36
|
+
```
|
|
24
37
|
|
|
25
38
|
Unknown frontmatter fields fail validation.
|
|
26
39
|
|
|
@@ -69,14 +82,14 @@ available actions; disabling a definition does not mutate that assignment.
|
|
|
69
82
|
| `bodyMode` | `append` or `replace` | `replace` for non-empty matching overlay body | Valid only when overlaying an existing lower-precedence definition; consumed during body composition. |
|
|
70
83
|
| `noTools` | boolean | Pi normal tool policy | `true` emits `--no-tools`; managed `ask_owner` remains infrastructure. |
|
|
71
84
|
| `noBuiltinTools` | boolean | Pi normal built-in tool policy | `true` emits `--no-builtin-tools`. |
|
|
72
|
-
| `tools` |
|
|
73
|
-
| `excludeTools` |
|
|
85
|
+
| `tools` | array of non-empty strings | no explicit allowlist | Passed to Pi as a source-agnostic tool-name allowlist; matching overlay replaces whole array. |
|
|
86
|
+
| `excludeTools` | array of non-empty strings | no explicit exclusions | Passed to Pi as source-agnostic tool-name exclusions; matching override replaces whole array. |
|
|
74
87
|
| `noSkills` | boolean | skills disabled unless `inheritSkills: true` | Controls Pi native skill discovery; explicit `skills` values are still passed separately. |
|
|
75
88
|
| `inheritSkills` | boolean | does not enable by itself unless `true` | `true` changes omitted `noSkills` default so native skills remain available. Explicit `noSkills` wins. |
|
|
76
|
-
| `skills` |
|
|
89
|
+
| `skills` | array of non-empty strings | no explicit skill arguments | Each value is passed unchanged as a Pi skill path/resource. |
|
|
77
90
|
| `noExtensions` | boolean | Pi normal extension policy | `true` emits `--no-extensions`. Required herdr agent infrastructure remains injected by the launcher. |
|
|
78
|
-
| `extensions` |
|
|
79
|
-
| `agents` |
|
|
91
|
+
| `extensions` | array of non-empty strings | no extra extension arguments | Each value is passed unchanged to Pi. |
|
|
92
|
+
| `agents` | array of unique non-empty definition names | no direct agents | Names direct definitions this agent may delegate to; every name must exist. |
|
|
80
93
|
| `inheritProjectContext` | boolean | `true` only for definition name `delegate`; otherwise `false` | Controls project context-file inheritance. |
|
|
81
94
|
| `inheritGlobalContext` | boolean | follows effective `inheritProjectContext` | Controls global context-file inheritance. |
|
|
82
95
|
|
package/package.json
CHANGED