@ikunin/sprintpilot 2.2.10 → 2.2.11

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.
@@ -1,6 +1,6 @@
1
1
  addon:
2
2
  name: sprintpilot
3
- version: 2.2.10
3
+ version: 2.2.11
4
4
  description: Sprintpilot — autopilot and multi-agent addon for BMad Method (git workflow, parallel agents, autonomous story execution)
5
5
  bmad_compatibility: ">=6.2.0"
6
6
  modules:
@@ -23,6 +23,13 @@ Follow **`./workflow.orchestrator.md`** verbatim. Flow control lives in
23
23
  - Do not search for `workflow.md` or reconstruct it from memory; do not
24
24
  read cached BMad legacy patterns and apply them ahead of the
25
25
  orchestrator's state machine.
26
+ - **Never pause on your own initiative.** `user_input { kind: 'pause' }`
27
+ is a HUMAN command. The autopilot's purpose is to drive without
28
+ stopping until `session_story_limit`, a TRUE BLOCKER, retry-budget
29
+ exhaustion, or `sprint_is_complete`. Heuristics like "PR opened,
30
+ time for review" / "natural breakpoint" / "let CI catch up" are NOT
31
+ valid reasons to pause — see `workflow.orchestrator.md` § "Pause is
32
+ human-only."
26
33
 
27
34
  `workflow.orchestrator.md` is the **sole authority** for the rest of the
28
35
  session.
@@ -83,9 +83,33 @@ Wrap everything in `{ "status": "...", ... }` and pass to
83
83
  | `failure` | `reason`, `diagnosis` (first-class — fed back into next retry), `recoverable: boolean` |
84
84
  | `blocked` | `blocker_kind` (one of the 5 TRUE BLOCKERS or recoverable kinds), `details`, `user_input_needed`, `consecutive_count?` |
85
85
  | `propose_alternative` | `reason`, `alternative` (full Action object), `urgency_hint?` (raises impact only). Low impact → auto-accepted; medium / high → orchestrator stores the alternative in `state.pending_alternative` and emits `user_prompt`. The user accepts via `user_input` `{ kind: 'accept_alternative' }` or rejects via `force_continue` (both clear `pending_alternative`). |
86
- | `user_input` | `commands: UserCommand[]` (validated server-side; see user-commands.js). Kinds: `skip_story`, `abort_sprint`, `force_continue`, `override_decision`, `change_profile`, `pause` (cleanly halts THIS session; next `/sprint-autopilot-on` resumes), `accept_alternative` (dispatches the stored `pending_alternative`). |
86
+ | `user_input` | `commands: UserCommand[]` (validated server-side; see user-commands.js). Kinds: `skip_story`, `abort_sprint`, `force_continue`, `override_decision`, `change_profile`, `pause` (cleanly halts THIS session; next `/sprint-autopilot-on` resumes), `accept_alternative` (dispatches the stored `pending_alternative`). **NEVER send `pause` on your own initiative** — see "Pause is human-only" below. |
87
87
  | `verify_override` | `evidence: { decision_log_ref?, explanation, expected_paths? }` — used when verify.js is wrong |
88
88
 
89
+ ## Pause is human-only
90
+
91
+ The autopilot's purpose is to **drive without stopping** until one of:
92
+ - `session_story_limit` is reached (profile-defined; default 3, nano 5)
93
+ - A TRUE BLOCKER (5 kinds, listed below) fires
94
+ - The retry budget exhausts on a single phase
95
+ - `sprint_is_complete` (last story done → halt with `handoff: sprint_finalize_pending`)
96
+ - The **human user** explicitly asks to pause (e.g. types `/pause`, `pause autopilot`, or a similar direct instruction in chat)
97
+
98
+ **DO NOT issue `user_input` `{ kind: 'pause' }` on your own.** Specifically, the following are NOT valid reasons to pause:
99
+
100
+ - "Natural pause point" / "PR opened, time for human review"
101
+ - "CI is still running for the previous story"
102
+ - "Diff is large, let's get a checkpoint"
103
+ - "Merge cadence" / "want to wait for review before next story"
104
+ - Any heuristic about session length, story count, or work-in-progress
105
+
106
+ Pause is a HUMAN command. If you think the user might want to pause, **don't pause — finish the story and proceed to the next per the queue / `resolveNextStoryKey`**. The user can pause at any time by typing the command themselves; the next `/sprint-autopilot-on` cleanly resumes. Your judgment about "natural breakpoints" defeats the autopilot's purpose.
107
+
108
+ The only cases where you signal a halt yourself are:
109
+ - `blocked` with one of the 5 TRUE BLOCKERS (creative-input-required, new external dep, etc.)
110
+ - `failure` with `recoverable: false` (catastrophic, can't proceed even with retries)
111
+ - `propose_alternative` at medium/high impact (the orchestrator escalates to a `user_prompt` itself)
112
+
89
113
  ## TRUE BLOCKER kinds (per AGENTS.md)
90
114
 
91
115
  `creative_user_input_required`, `new_external_dependency`,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ikunin/sprintpilot",
3
- "version": "2.2.10",
3
+ "version": "2.2.11",
4
4
  "description": "Sprintpilot — autopilot and multi-agent addon for BMad Method v6: git workflow, parallel agents, autonomous story execution",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {