pi-better-harness 0.1.2 → 0.1.4

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 (3) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +24 -22
  3. package/package.json +11 -7
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 1aboveio
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,12 +1,14 @@
1
1
  # pi-better-harness
2
2
 
3
- Meta package for the core Pi Better Harness extensions.
3
+ `pi-better-harness` is a Pi meta package that installs the core Pi Better Harness extensions for delegated subagents, durable background tasks, and goal tracking.
4
4
 
5
- Install it once to load the background-work tools used most often in Pi:
5
+ ## Quick Answer
6
6
 
7
- - `pi-better-subagents` for detached subagent runs and completion callbacks
8
- - `pi-better-background-tasks` for durable shell tasks and command watchers
9
- - `pi-better-goal` for current-goal tracking and background-aware continuation
7
+ Use `pi-better-harness` when you want the full background-work bundle for Pi in one install. It loads:
8
+
9
+ - `pi-better-subagents` for detached, sandboxed subagent runs.
10
+ - `pi-better-background-tasks` for durable shell tasks and watchers.
11
+ - `pi-better-goal` for objective tracking that is aware of background work.
10
12
 
11
13
  `pi-better-read-aloud` is intentionally not included yet.
12
14
 
@@ -16,34 +18,32 @@ Install it once to load the background-work tools used most often in Pi:
16
18
  pi install npm:pi-better-harness
17
19
  ```
18
20
 
19
- For a temporary run without saving the package to Pi settings:
21
+ Try it for one run without saving it to Pi settings:
20
22
 
21
23
  ```sh
22
24
  pi -e npm:pi-better-harness
23
25
  ```
24
26
 
25
- ## Included Tools
26
-
27
- After installation, Pi can use these model-callable tools:
28
-
29
- | Extension | Tools |
30
- | --------- | ----- |
31
- | `pi-better-subagents` | `subagent_spawn`, `subagent_spawn_batch`, `subagent_list`, `subagent_output`, `subagent_result`, `subagent_stop` |
32
- | `pi-better-background-tasks` | `bg_task_spawn`, `bg_task_watch`, `bg_task_list`, `bg_task_status`, `bg_task_log`, `bg_task_stop`, `bg_task`, `bg_status` |
33
- | `pi-better-goal` | `get_goal`, `update_goal`, `get_background_activity` |
34
-
35
- The goal extension also provides the `/goal` and `/better-activity` commands.
36
-
37
27
  ## Install Individual Packages
38
28
 
39
- Use these when you want only one part of the harness:
40
-
41
29
  ```sh
42
30
  pi install npm:pi-better-subagents
43
31
  pi install npm:pi-better-background-tasks
44
32
  pi install npm:pi-better-goal
45
33
  ```
46
34
 
35
+ ## When To Use
36
+
37
+ Use this package when you want all three core extensions loaded together. Install an individual package instead when you only need subagents, shell task supervision, or goal tracking.
38
+
39
+ ## Compatibility
40
+
41
+ | Requirement | Support |
42
+ |-------------|---------|
43
+ | Pi | Required |
44
+ | Install method | `pi install npm:pi-better-harness` |
45
+ | Development runtime | Node.js 22+ |
46
+
47
47
  ## Update Or Remove
48
48
 
49
49
  ```sh
@@ -51,6 +51,8 @@ pi update npm:pi-better-harness
51
51
  pi remove npm:pi-better-harness
52
52
  ```
53
53
 
54
- ## Source
54
+ ## More Detail
55
55
 
56
- Repository: https://github.com/1aboveio/pi-better-harness
56
+ - Repository: https://github.com/1aboveio/pi-better-harness
57
+ - Detailed notes: https://github.com/1aboveio/pi-better-harness/blob/main/packages/pi-better-harness/docs/usage.md
58
+ - License: https://github.com/1aboveio/pi-better-harness/blob/main/LICENSE
package/package.json CHANGED
@@ -1,12 +1,16 @@
1
1
  {
2
2
  "name": "pi-better-harness",
3
- "version": "0.1.2",
4
- "description": "Meta package for the core Pi Better Harness extensions.",
3
+ "version": "0.1.4",
4
+ "description": "Pi extension bundle for subagents, durable background tasks, and goal tracking.",
5
+ "license": "MIT",
5
6
  "type": "module",
6
7
  "keywords": [
7
8
  "pi-package",
8
9
  "pi-extension",
9
- "pi-better-harness"
10
+ "pi-better-harness",
11
+ "subagents",
12
+ "background-tasks",
13
+ "goal-tracking"
10
14
  ],
11
15
  "pi": {
12
16
  "extensions": [
@@ -29,8 +33,8 @@
29
33
  "README.md"
30
34
  ],
31
35
  "dependencies": {
32
- "pi-better-background-tasks": "0.1.2",
33
- "pi-better-goal": "0.1.2",
34
- "pi-better-subagents": "0.1.2"
36
+ "pi-better-background-tasks": "0.1.4",
37
+ "pi-better-goal": "0.1.4",
38
+ "pi-better-subagents": "0.1.4"
35
39
  }
36
- }
40
+ }