pi-baton 0.7.5 → 0.8.5
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 +202 -163
- package/README.md +184 -179
- package/docs/workflows.md +154 -0
- package/extensions/index.ts +14 -1
- package/lib/run-store.ts +113 -1
- package/lib/status.ts +43 -0
- package/lib/workflow-discovery.ts +66 -26
- package/package.json +67 -67
package/CHANGELOG.md
CHANGED
|
@@ -1,163 +1,202 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
##
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
###
|
|
55
|
-
|
|
56
|
-
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
- `/baton:
|
|
90
|
-
-
|
|
91
|
-
- Run
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
### Changed
|
|
145
|
-
|
|
146
|
-
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
-
|
|
163
|
-
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.8.5 - 2026-09-27
|
|
4
|
+
|
|
5
|
+
- chore: periodic patch bump after 7+ days without npm publish
|
|
6
|
+
|
|
7
|
+
## 0.8.4 - 2026-09-27
|
|
8
|
+
|
|
9
|
+
- chore: periodic patch bump after 7+ days without npm publish
|
|
10
|
+
|
|
11
|
+
## 0.8.3 - 2026-09-27
|
|
12
|
+
|
|
13
|
+
- chore: periodic patch bump after 7+ days without npm publish
|
|
14
|
+
|
|
15
|
+
## 0.8.2 - 2026-09-27
|
|
16
|
+
|
|
17
|
+
- chore: periodic patch bump after 7+ days without npm publish
|
|
18
|
+
|
|
19
|
+
## 0.8.1 - 2026-09-27
|
|
20
|
+
|
|
21
|
+
- chore: periodic patch bump after 7+ days without npm publish
|
|
22
|
+
|
|
23
|
+
All notable changes to this project will be documented in this file.
|
|
24
|
+
|
|
25
|
+
This project follows semantic versioning.
|
|
26
|
+
|
|
27
|
+
## [Unreleased]
|
|
28
|
+
|
|
29
|
+
### Added
|
|
30
|
+
|
|
31
|
+
- Regression tests for exhausted `iteration_cap` pre-check behavior in `runContinuous`, malformed unreadable active-run manifests in `loadActiveRun`/`loadMostRecentTerminalRun`, recovery via `createIdleRun`, and `/baton:status` terminal-fallback messaging for iteration-cap failures.
|
|
32
|
+
|
|
33
|
+
## [0.8.0] - 2026-09-14
|
|
34
|
+
|
|
35
|
+
### Added
|
|
36
|
+
|
|
37
|
+
- `/baton:history` lists recent completed or failed Baton runs from persisted `.pi/baton/runs/` manifests, with bounded scan/output limits, skip diagnostics for unreadable manifests, and tests for empty, single, multi-run, exclusion, scan-cap ordering, and command registration cases.
|
|
38
|
+
- `/baton:status` and `formatStatusSummary` now include the stored `failure` reason for terminal failed runs, with status tests covering iteration-cap exhaustion and other failure paths.
|
|
39
|
+
|
|
40
|
+
### Changed
|
|
41
|
+
|
|
42
|
+
- README quick start and `docs/workflows.md` now document when to use `/baton:history` versus `/baton:status`, including the terminal-run fallback behavior for status.
|
|
43
|
+
- README quick start and `docs/workflows.md` now document that `/baton:status` falls back to the most recent finished run when no active run exists.
|
|
44
|
+
- Refreshed ROADMAP.md: marked S-109 done, updated release direction for 0.8.0/0.9.0, and added maintenance seed candidates S-110 through S-113 for the weekly seed planner.
|
|
45
|
+
- Updated ROADMAP.md to mark S-108 done and refresh the security status table after the two-stage review gauntlet shipped in 0.7.5.
|
|
46
|
+
- Aligned ROADMAP S-109 status with the shipped `docs/workflows.md` authoring guide.
|
|
47
|
+
|
|
48
|
+
## [0.7.5] - 2026-08-22
|
|
49
|
+
|
|
50
|
+
### Changed
|
|
51
|
+
|
|
52
|
+
- Merge the 2026-08-22 managed OSS dependency and maintenance PR batch.
|
|
53
|
+
|
|
54
|
+
### Added
|
|
55
|
+
|
|
56
|
+
- Added the builtin `Two-Stage Review Gauntlet` workflow to demonstrate a non-default two-stage review graph.
|
|
57
|
+
|
|
58
|
+
### Changed
|
|
59
|
+
|
|
60
|
+
- Bump package version to `0.7.3` for the next patch release.
|
|
61
|
+
- Bumped Pi dev toolchain packages to clear the transitive `protobufjs` audit advisory; the remaining `brace-expansion` finding is documented as upstream-blocked by `@earendil-works/pi-coding-agent`'s published shrinkwrap.
|
|
62
|
+
- Removed unused `clearActiveRunPointer` export from `lib/run-store.ts` (dead code with no callers; `loadActiveRun` / `loadMostRecentTerminalRun` already treat a missing `runId` as no active pointer).
|
|
63
|
+
|
|
64
|
+
## [0.7.2] - 2026-07-04
|
|
65
|
+
|
|
66
|
+
### Added
|
|
67
|
+
|
|
68
|
+
- `/baton:status` now shows the most recent finished run summary (state, last step, iteration, run directory) after a run reaches `completed` or `failed`, with clear finished-run framing instead of the no-active-run message.
|
|
69
|
+
|
|
70
|
+
- Buy Me a Coffee sponsor button in README and native GitHub funding link via `.github/FUNDING.yml`.
|
|
71
|
+
|
|
72
|
+
### Changed
|
|
73
|
+
|
|
74
|
+
- Merged Dependabot PR #14: bump `@earendil-works/pi-ai` devDependency from 0.78.1 to 0.80.2 (type-check clean, 57/57 tests passing).
|
|
75
|
+
- Removed leftover template scaffolding (`prompts/`, `themes/`, `skills/`).
|
|
76
|
+
- Deleted stale template bootstrap docs (`docs/examples.md`, `docs/github-template.md`, `docs/repository-settings.md`, `docs/typescript.md`, `docs/template-checklist.md`) that shipped to npm consumers describing non-existent commands.
|
|
77
|
+
- Updated ROADMAP.md to reflect current version (0.7.2), test count (57), and seed completion status for S-101, S-102, S-103, S-105.
|
|
78
|
+
|
|
79
|
+
## [0.7.1] - 2026-06-27
|
|
80
|
+
|
|
81
|
+
### Changed
|
|
82
|
+
|
|
83
|
+
- README aligned to the current Pi extension template: added `Features`, `Release`, `Security`, and `Links` sections; expanded install flows (`npm`, GitHub, project-local, and `pi -e`); and updated `Package contents` to match the published tarball.
|
|
84
|
+
|
|
85
|
+
## [0.7.0] - 2026-06-25
|
|
86
|
+
|
|
87
|
+
### Added
|
|
88
|
+
|
|
89
|
+
- Command handler tests for `/baton:new`, `/baton:start`, `/baton:run`, and `/baton:status` covering scaffold creation, inline validation, active-run guard, and no-active-run messaging.
|
|
90
|
+
- Handoff payload shape tests for implement, linear, and fix transitions.
|
|
91
|
+
- Run-store tests for active-run visibility across idle, running, and terminal states.
|
|
92
|
+
|
|
93
|
+
### Changed
|
|
94
|
+
|
|
95
|
+
- Finalizes the shipped builtin `default-review-loop` workflow (`worker` / `reviewer` / `worker`) with full v1 command-surface test coverage.
|
|
96
|
+
|
|
97
|
+
## [0.6.0] - 2026-06-25
|
|
98
|
+
|
|
99
|
+
### Added
|
|
100
|
+
|
|
101
|
+
- Structured step envelopes for every run step (`summary`, `rawOutputPath`, and review fields when applicable).
|
|
102
|
+
- Step handoff payload carries `taskBrief`, prior `stepOutputSummary`, `rawOutputPath`, and run metadata between isolated steps.
|
|
103
|
+
- Review contract enforcement: `reject` requires non-empty `findings`; `accept` requires `acceptanceNote`.
|
|
104
|
+
- Builtin `default-review-loop` routes `fix` back to `review`; iteration cap stops infinite reject loops.
|
|
105
|
+
- Step-level `model` override with placeholder and session-model fallback via `resolveStepModel`.
|
|
106
|
+
|
|
107
|
+
### Changed
|
|
108
|
+
|
|
109
|
+
- Expanded `run-engine` and `review-contract` tests for fix→review routing, model routing, envelope persistence, and contract violations.
|
|
110
|
+
|
|
111
|
+
## [0.5.0] - 2026-06-23
|
|
112
|
+
|
|
113
|
+
### Added
|
|
114
|
+
|
|
115
|
+
- `/baton:run` continuous run engine executes the active idle run through isolated subagent steps to a terminal state.
|
|
116
|
+
- Step records persist under `.pi/baton/runs/<run>/steps/` and raw outputs under `outputs/`.
|
|
117
|
+
- Terminal run summaries report the failing step as `last step` when step execution fails.
|
|
118
|
+
|
|
119
|
+
### Changed
|
|
120
|
+
|
|
121
|
+
- Expanded `run-engine` tests for step/output persistence, state transitions, and failure `last step` reporting.
|
|
122
|
+
|
|
123
|
+
## [0.4.0] - 2026-06-22
|
|
124
|
+
|
|
125
|
+
### Added
|
|
126
|
+
|
|
127
|
+
- `/baton:start` creates an idle run from workflow selection and a task brief without starting execution.
|
|
128
|
+
- `/baton:status` reports workflow name, task brief, last/current step, run state, iteration count, and run directory.
|
|
129
|
+
- Single active run guard blocks a second `/baton:start` and points users to `/baton:status` or `/baton:run`.
|
|
130
|
+
- Run manifests persist under `.pi/baton/runs/` with an active-run pointer.
|
|
131
|
+
- Expanded workflow schema validation tests covering required fields, linear `next` transitions, review `on_accept` / `on_reject` branches, and invalid YAML handling at discovery time.
|
|
132
|
+
|
|
133
|
+
### Changed
|
|
134
|
+
|
|
135
|
+
- Workflow selection display names continue to come from YAML `name`; invalid or incomplete workflow documents now fail with explicit validation errors during `/baton:start` and `/baton:run` discovery.
|
|
136
|
+
|
|
137
|
+
## [0.3.0] - 2026-06-18
|
|
138
|
+
|
|
139
|
+
### Added
|
|
140
|
+
|
|
141
|
+
- `/baton:new` re-prompts for a workflow name when the derived filename collides with an existing scaffold.
|
|
142
|
+
- Tests for lazy `.pi/baton/workflows/` creation and kebab-case filename derivation.
|
|
143
|
+
|
|
144
|
+
### Changed
|
|
145
|
+
|
|
146
|
+
- Workflow discovery keeps user-defined `.pi/baton/workflows/*.yaml` entries ahead of builtin package workflows in selection order.
|
|
147
|
+
|
|
148
|
+
## [0.2.3] - 2026-06-13
|
|
149
|
+
|
|
150
|
+
### Added
|
|
151
|
+
|
|
152
|
+
- README header icon and packaged `assets/pi-baton-icon-512.png` branding asset.
|
|
153
|
+
|
|
154
|
+
### Changed
|
|
155
|
+
|
|
156
|
+
- `assets/` is now included in the published package.
|
|
157
|
+
|
|
158
|
+
## [0.2.2] - 2026-06-13
|
|
159
|
+
|
|
160
|
+
### Added
|
|
161
|
+
|
|
162
|
+
- Live Baton run widget above the editor during `/baton:run`, showing workflow, brief, active step, agent, judgment, and step checklist.
|
|
163
|
+
- Footer status line (`baton: implement`, `baton: review`, etc.) while a run is in progress.
|
|
164
|
+
|
|
165
|
+
## [0.2.1] - 2026-06-13
|
|
166
|
+
|
|
167
|
+
### Fixed
|
|
168
|
+
|
|
169
|
+
- Ship builtin `worker` and `reviewer` subagent definitions so `default-review-loop` runs without pre-created `.pi/agents/` files.
|
|
170
|
+
- Validate required workflow agents during `/baton:start` and `/baton:run` with clearer missing-agent errors.
|
|
171
|
+
|
|
172
|
+
## [0.2.0] - 2026-06-13
|
|
173
|
+
|
|
174
|
+
### Added
|
|
175
|
+
|
|
176
|
+
- `/baton:new`, `/baton:start`, `/baton:run`, and `/baton:status` command surface.
|
|
177
|
+
- Builtin `default-review-loop` workflow with `worker` / `reviewer` / `worker` agent mapping.
|
|
178
|
+
- YAML workflow discovery, inline validation, scaffold generation, and run persistence under `.pi/baton/`.
|
|
179
|
+
- Isolated subagent step execution with structured handoff, review contract enforcement, and per-step model routing.
|
|
180
|
+
|
|
181
|
+
## [0.1.2] - 2026-06-04
|
|
182
|
+
|
|
183
|
+
### Changed
|
|
184
|
+
|
|
185
|
+
- README and `docs/template-checklist.md` now follow the Pi OSS minimal-docs policy: `docs/` is optional, with explicit post-generation cleanup for template bootstrap docs.
|
|
186
|
+
- Template bootstrap docs (`github-template.md`, `repository-settings.md`, `typescript.md`) are labeled for delete-or-merge after setup.
|
|
187
|
+
|
|
188
|
+
## [0.1.1] - 2026-06-01
|
|
189
|
+
|
|
190
|
+
### Changed
|
|
191
|
+
|
|
192
|
+
- Publish workflow now supports npm publishing on merged package version bumps in addition to tags, releases, and manual dispatch.
|
|
193
|
+
- Publish workflow now installs a current npm CLI so npm Trusted Publishing OIDC is supported.
|
|
194
|
+
- CI and publish workflow commands no longer include literal trailing `\\n` text.
|
|
195
|
+
|
|
196
|
+
## [0.1.0] - YYYY-MM-DD
|
|
197
|
+
|
|
198
|
+
### Added
|
|
199
|
+
|
|
200
|
+
- Initial Pi package template.
|
|
201
|
+
- Example extension, Agent Skill, prompt, and theme.
|
|
202
|
+
- CI and npm Trusted Publishing workflow.
|