@ikunin/sprintpilot 2.2.12 → 2.2.13

package/_Sprintpilot/bin/autopilot.js

@@ -695,6 +695,13 @@ function composeRuntimeState(persisted, profile, projectRoot) {
     // across halts so the next session re-emits the prompt rather than
     // silently dropping the LLM's proposal.
     pending_alternative: persisted.pending_alternative || null,
+    // session_story_limit counter: per-session count of stories completed.
+    // adapt.advanceState increments on STORY_DONE → EPIC_BOUNDARY_CHECK;
+    // state-machine.nextAction emits a halt when this hits profile.session_story_limit.
+    // cmdStart resets to 0 on each new session boot (the limit is per-session,
+    // not lifetime). Persisted across in-session resumes so a `pause` mid-flow
+    // doesn't reset progress against the limit.
+    session_stories_completed: persisted.session_stories_completed || 0,
     // halt_requested is intentionally NOT carried forward here: cmdStart
     // clears it on each new session (a `pause` cleanly halts THIS session
     // and the next /sprint-autopilot-on resumes normally).
@@ -723,6 +730,7 @@ function persistRuntimeState(runtime, profile, projectRoot) {
     story_queue: Array.isArray(runtime.story_queue) ? runtime.story_queue : [],
     land_pending: runtime.land_pending,
     pending_alternative: runtime.pending_alternative || null,
+    session_stories_completed: runtime.session_stories_completed || 0,
   };
   return persistState(updates, profile, projectRoot, runtime.story_key || 'sprint');
 }
@@ -1133,6 +1141,12 @@ function cmdStart(opts) {
   // profile-aware initial phase when persisted state is empty.
   const runtime = composeRuntimeState(persisted, profile, projectRoot);
 
+  // session_story_limit is per-session — a fresh `autopilot start`
+  // resets the counter so the next batch of N stories can run before
+  // the next halt. (state-machine.nextAction enforces the cap; adapt.js
+  // increments on STORY_DONE → EPIC_BOUNDARY_CHECK.)
+  runtime.session_stories_completed = 0;
+
   const lockResult = lockUserBranchIfNeeded(runtime, profile, projectRoot);
   if (lockResult && lockResult.halt) {
     ledger.append(

package/_Sprintpilot/lib/orchestrator/adapt.js

@@ -592,6 +592,10 @@ function advanceState(state, profile, newPhase, signal) {
     next.story_key = null;
     next.story_file_path = null;
     next.ac_summary = null;
+    // session_story_limit: increment per-session completion counter so
+    // state-machine.js#nextAction can emit the halt at the next
+    // emission. The counter resets on cmdStart (new session boundary).
+    next.session_stories_completed = (state.session_stories_completed || 0) + 1;
   }
 
   return next;

package/_Sprintpilot/lib/orchestrator/state-machine.js

@@ -170,6 +170,37 @@ function nextAction(state, profile) {
       handoff: 'sprint_finalize_pending',
     };
   }
+  // session_story_limit: when this session has completed >= limit
+  // stories, halt cleanly. The next /sprint-autopilot-on resets the
+  // counter and continues. Skipped when limit === 0 (unlimited per
+  // Sprintpilot.md) or limit is unset.
+  const sessionLimit = profile && profile.session_story_limit;
+  const sessionDone = state.session_stories_completed || 0;
+  if (
+    typeof sessionLimit === 'number' &&
+    sessionLimit > 0 &&
+    sessionDone >= sessionLimit &&
+    // Don't halt when we're at a story-start phase — that would
+    // create an infinite halt loop on resume. The limit check should
+    // fire at the boundary between stories (epic_boundary_check or
+    // before the next story is picked). Most natural is to halt
+    // before emitting the next story-start action.
+    (state.phase === STATES.EPIC_BOUNDARY_CHECK ||
+      state.phase === STATES.RETROSPECTIVE ||
+      state.phase === STATES.PREPARE_STORY_BRANCH ||
+      state.phase === STATES.CREATE_STORY ||
+      state.phase === STATES.NANO_QUICK_DEV)
+  ) {
+    return {
+      type: 'halt',
+      reason: 'session_story_limit_reached',
+      prompt:
+        `Session story limit reached (${sessionDone}/${sessionLimit}). ` +
+        `Run /sprint-autopilot-on to start a new session and continue with the next pending story.`,
+      session_stories_completed: sessionDone,
+      session_story_limit: sessionLimit,
+    };
+  }
 
   switch (state.phase) {
     case STATES.PREPARE_STORY_BRANCH: {

package/_Sprintpilot/manifest.yaml

@@ -1,6 +1,6 @@
 addon:
   name: sprintpilot
-  version: 2.2.12
+  version: 2.2.13
   description: Sprintpilot — autopilot and multi-agent addon for BMad Method (git workflow, parallel agents, autonomous story execution)
   bmad_compatibility: ">=6.2.0"
   modules:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikunin/sprintpilot",
-  "version": "2.2.12",
+  "version": "2.2.13",
   "description": "Sprintpilot — autopilot and multi-agent addon for BMad Method v6: git workflow, parallel agents, autonomous story execution",
   "license": "Apache-2.0",
   "repository": {