@delete101020/aidlc 4.0.45 → 4.0.47

package/README.md

@@ -469,6 +469,15 @@ and approval — a `pass` advances the step, a `reject` stops with a rerun hint.
 With `--auto-approve` it also clears `human_review` gates without pausing — a
 single command then drives the entire pipeline end-to-end.
 
+An `autopilot: true` pipeline refuses to start on uncommitted changes, with
+one exception: when a step stopped short (a non-zero exit such as the account
+running out of usage, its `timeout_minutes`, a "stop now"), the run records
+what it left in the working tree, and `run exec` carries on from exactly that
+tree — switch accounts and run it again. The next attempt is told to finish
+the half-written changes rather than start over. If the tree has changed
+since, or the agent was killed before anything could be recorded, pass
+`--allow-dirty` to start anyway.
+
 **`run request-update`** reopens an already-approved step (bumps its revision,
 resets downstream steps), mirroring the extension's "Request update" action.
 

package/dist/bundle.js

@@ -21157,6 +21157,7 @@ var require_runProgress = __commonJS({
     exports2.isStepOptional = isStepOptional;
     exports2.deriveRunProgress = deriveRunProgress;
     exports2.isRunComplete = isRunComplete2;
+    exports2.nextRunnableStep = nextRunnableStep;
     exports2.weighStepProgress = weighStepProgress2;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var ACTIVE = /* @__PURE__ */ new Set([
@@ -21228,6 +21229,48 @@ var require_runProgress = __commonJS({
         return s.status === "rejected" || s.status === "pending";
       });
     }
+    function nextRunnableStep(state, pipeline, untilIdx = -1) {
+      if (!usesDag(pipeline)) {
+        return state.currentStepIdx;
+      }
+      const skipped = deadEndPeersOfApproved(state, pipeline);
+      if (untilIdx >= 0) {
+        skipped.delete(untilIdx);
+        const onPath = ancestorsOf(pipeline, untilIdx);
+        onPath.add(untilIdx);
+        state.steps.forEach((_, i) => {
+          if (!onPath.has(i)) {
+            skipped.add(i);
+          }
+        });
+      }
+      const runnable = (i) => isActiveStatus(state.steps[i]?.status ?? "pending") && !skipped.has(i);
+      if (runnable(state.currentStepIdx)) {
+        return state.currentStepIdx;
+      }
+      return state.steps.findIndex((_, i) => runnable(i));
+    }
+    function ancestorsOf(pipeline, idx) {
+      const normalized = pipeline.steps.map(WorkspaceSchema_1.normalizeStep);
+      const idxByDagId = /* @__PURE__ */ new Map();
+      normalized.forEach((s, i) => {
+        idxByDagId.set(s.name ?? s.agent, i);
+      });
+      const found = /* @__PURE__ */ new Set();
+      const queue = [idx];
+      while (queue.length > 0) {
+        const cur = queue.pop();
+        for (const dep of normalized[cur]?.depends_on ?? []) {
+          const di = idxByDagId.get(dep);
+          if (di === void 0 || found.has(di) || di === idx) {
+            continue;
+          }
+          found.add(di);
+          queue.push(di);
+        }
+      }
+      return found;
+    }
     function deadEndPeersOfApproved(state, pipeline) {
       const normalized = state.steps.map((s, i) => (0, WorkspaceSchema_1.normalizeStep)(pipeline.steps[i] ?? { agent: s.agent }));
       const ids = normalized.map((n) => n.name ?? n.agent);
@@ -31152,6 +31195,120 @@ var require_commandBodyFreshness = __commonJS({
   }
 });
 
+// ../core/dist/runs/codeFingerprint.js
+var require_codeFingerprint = __commonJS({
+  "../core/dist/runs/codeFingerprint.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.codeFingerprint = codeFingerprint;
+    exports2.uncommittedPaths = uncommittedPaths;
+    var child_process_1 = require("child_process");
+    var fs14 = __importStar(require("fs"));
+    var os3 = __importStar(require("os"));
+    var path17 = __importStar(require("path"));
+    function codeFingerprint(root, exclude) {
+      const git = (args, env) => (0, child_process_1.execFileSync)("git", args, {
+        cwd: root,
+        encoding: "utf8",
+        env: env ? { ...process.env, ...env } : process.env,
+        stdio: ["ignore", "pipe", "ignore"],
+        maxBuffer: 64 * 1024 * 1024
+      }).trim();
+      let realIndex;
+      try {
+        realIndex = path17.resolve(root, git(["rev-parse", "--git-path", "index"]));
+      } catch {
+        return null;
+      }
+      const dir = fs14.mkdtempSync(path17.join(os3.tmpdir(), "aidlc-fp-"));
+      const index = path17.join(dir, "index");
+      try {
+        if (fs14.existsSync(realIndex)) {
+          fs14.copyFileSync(realIndex, index);
+        }
+        const env = { GIT_INDEX_FILE: index };
+        git(["add", "-A", "--", "."], env);
+        const skip = exclude.filter((p) => p && !p.startsWith(".."));
+        if (skip.length > 0) {
+          git(["rm", "-r", "-q", "--cached", "--ignore-unmatch", "--", ...skip], env);
+        }
+        return git(["write-tree"], env);
+      } catch {
+        return null;
+      } finally {
+        fs14.rmSync(dir, { recursive: true, force: true });
+      }
+    }
+    function uncommittedPaths(root, exclude) {
+      let out2;
+      try {
+        out2 = (0, child_process_1.execFileSync)("git", ["status", "--porcelain=v1", "-z", "--untracked-files=all"], {
+          cwd: root,
+          encoding: "utf8",
+          stdio: ["ignore", "pipe", "ignore"],
+          maxBuffer: 64 * 1024 * 1024
+        });
+      } catch {
+        return [];
+      }
+      const skip = exclude.map((p) => p.split(path17.sep).join("/")).filter((p) => p && !p.startsWith(".."));
+      return statusPaths(out2).filter((p) => !skip.some((s) => p === s || p.startsWith(`${s}/`)));
+    }
+    function statusPaths(out2) {
+      const parts = out2.split("\0");
+      const paths = [];
+      for (let i = 0; i < parts.length; i++) {
+        const entry = parts[i];
+        if (entry.length < 4) {
+          continue;
+        }
+        paths.push(entry.slice(3));
+        if (entry[0] === "R" || entry[0] === "C") {
+          i++;
+        }
+      }
+      return paths;
+    }
+  }
+});
+
 // ../core/dist/runs/autopilotPreflight.js
 var require_autopilotPreflight = __commonJS({
   "../core/dist/runs/autopilotPreflight.js"(exports2) {
@@ -31204,6 +31361,7 @@ var require_autopilotPreflight = __commonJS({
     var os3 = __importStar(require("os"));
     var path17 = __importStar(require("path"));
     var claudeHome_1 = require_claudeHome();
+    var codeFingerprint_1 = require_codeFingerprint();
     var EpicScaffold_1 = require_EpicScaffold();
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     exports2.APPROVAL_GATE_SCRIPT = "aidlc-approval-gate";
@@ -31282,14 +31440,25 @@ var require_autopilotPreflight = __commonJS({
         } else if (protectedBranches.has(branch)) {
           problems.push(`You are on "${branch}". Autopilot does not commit to it \u2014 switch to a branch for this epic (git switch -c <branch>).`);
         }
-        const skip = [
+        const exclude = [
           toPosix(path17.relative(root, path17.join((0, EpicScaffold_1.epicsRoot)(root, config), state.runId))),
           ".aidlc"
         ];
-        const dirty = dirtyPaths(git(["status", "--porcelain=v1", "-z", "--untracked-files=all"]) ?? "").filter((p) => !skip.some((s) => p === s || p.startsWith(`${s}/`)));
+        const dirty = (0, codeFingerprint_1.uncommittedPaths)(root, exclude);
         if (dirty.length > 0) {
-          const shown = dirty.slice(0, 5).join(", ") + (dirty.length > 5 ? `, and ${dirty.length - 5} more` : "");
-          problems.push(`The working tree has uncommitted changes (${shown}). Commit or stash them first: the agent would build on them, and its own changes would be mixed in with them.`);
+          const shown = listPaths(dirty);
+          const left = state.steps.filter((s) => s.leftover);
+          const tree = left.length > 0 ? (0, codeFingerprint_1.codeFingerprint)(root, exclude) : null;
+          const own = tree ? left.find((s) => s.leftover.tree === tree) : void 0;
+          if (own) {
+            args.onNote?.(`Carrying on from what "${own.name ?? own.agent}" left uncommitted when it ${leftoverWhy(own)} (${shown}). Nothing else has changed since.`);
+          } else if (args.allowDirty) {
+            args.onNote?.(`--allow-dirty: starting on top of uncommitted changes (${shown}).`);
+          } else {
+            args.onDirty?.(dirty);
+            const changed = left.length > 0 ? ` They are not what "${left.map((s) => s.name ?? s.agent).join('", "')}" left when it stopped \u2014 something has changed since.` : "";
+            problems.push(`The working tree has uncommitted changes (${shown}). Commit or stash them first: the agent would build on them, and its own changes would be mixed in with them.${changed} If they are this run's own unfinished work, run again with --allow-dirty.`);
+          }
         }
       }
       const claudeSteps = new Set(state.steps.filter((s) => s.status !== "approved").map((s) => config.agents.find((a) => a.id === s.agent)).filter((a) => a?.runner === "default").map((a) => a.id));
@@ -31325,20 +31494,18 @@ var require_autopilotPreflight = __commonJS({
     function emptyCiChecksMessage2(runner, step) {
       return `${runner} has no commands in CHECKS, so it passes whatever "${step}" builds. Add your lint, typecheck and test commands to it before leaving a run alone.`;
     }
-    function dirtyPaths(out2) {
-      const parts = out2.split("\0");
-      const paths = [];
-      for (let i = 0; i < parts.length; i++) {
-        const entry = parts[i];
-        if (entry.length < 4) {
-          continue;
-        }
-        paths.push(entry.slice(3));
-        if (entry[0] === "R" || entry[0] === "C") {
-          i++;
-        }
+    function listPaths(paths) {
+      return paths.slice(0, 5).join(", ") + (paths.length > 5 ? `, and ${paths.length - 5} more` : "");
+    }
+    function leftoverWhy(step) {
+      switch (step.leftover.why) {
+        case "timeout":
+          return "ran past its timeout_minutes";
+        case "stopped":
+          return "was stopped";
+        default:
+          return "failed";
       }
-      return paths;
     }
     function matcherCoversBash(matcher) {
       if (!matcher || matcher === "*") {
@@ -32164,89 +32331,6 @@ var require_runLock = __commonJS({
   }
 });
 
-// ../core/dist/runs/codeFingerprint.js
-var require_codeFingerprint = __commonJS({
-  "../core/dist/runs/codeFingerprint.js"(exports2) {
-    "use strict";
-    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    } : function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    });
-    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    } : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ function() {
-      var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function(o2) {
-          var ar = [];
-          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
-          return ar;
-        };
-        return ownKeys(o);
-      };
-      return function(mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) {
-          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        }
-        __setModuleDefault(result, mod);
-        return result;
-      };
-    }();
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.codeFingerprint = codeFingerprint;
-    var child_process_1 = require("child_process");
-    var fs14 = __importStar(require("fs"));
-    var os3 = __importStar(require("os"));
-    var path17 = __importStar(require("path"));
-    function codeFingerprint(root, exclude) {
-      const git = (args, env) => (0, child_process_1.execFileSync)("git", args, {
-        cwd: root,
-        encoding: "utf8",
-        env: env ? { ...process.env, ...env } : process.env,
-        stdio: ["ignore", "pipe", "ignore"],
-        maxBuffer: 64 * 1024 * 1024
-      }).trim();
-      let realIndex;
-      try {
-        realIndex = path17.resolve(root, git(["rev-parse", "--git-path", "index"]));
-      } catch {
-        return null;
-      }
-      const dir = fs14.mkdtempSync(path17.join(os3.tmpdir(), "aidlc-fp-"));
-      const index = path17.join(dir, "index");
-      try {
-        if (fs14.existsSync(realIndex)) {
-          fs14.copyFileSync(realIndex, index);
-        }
-        const env = { GIT_INDEX_FILE: index };
-        git(["add", "-A", "--", "."], env);
-        const skip = exclude.filter((p) => p && !p.startsWith(".."));
-        if (skip.length > 0) {
-          git(["rm", "-r", "-q", "--cached", "--ignore-unmatch", "--", ...skip], env);
-        }
-        return git(["write-tree"], env);
-      } catch {
-        return null;
-      } finally {
-        fs14.rmSync(dir, { recursive: true, force: true });
-      }
-    }
-  }
-});
-
 // ../core/dist/runs/batchStatus.js
 var require_batchStatus = __commonJS({
   "../core/dist/runs/batchStatus.js"(exports2) {
@@ -32438,16 +32522,27 @@ var require_execEngine = __commonJS({
       const batchesRun = /* @__PURE__ */ new Map();
       if (initialPipeline.autopilot && !opts.dryRun) {
         let problems;
+        let dirty;
         try {
           const ws = WorkspaceLoader_1.WorkspaceLoader.load(root);
-          problems = (0, autopilotPreflight_1.autopilotPreflight)({ root, state: initialState, pipeline: initialPipeline, config: ws.config });
+          problems = (0, autopilotPreflight_1.autopilotPreflight)({
+            root,
+            state: initialState,
+            pipeline: initialPipeline,
+            config: ws.config,
+            allowDirty: opts.allowDirty,
+            onNote: (m) => hooks.onPreflightNote?.(m),
+            onDirty: (paths) => {
+              dirty = paths;
+            }
+          });
         } catch (err) {
           problems = [`Could not check the workspace: ${errMsg(err)}`];
         }
         if (problems.length > 0) {
           hooks.onRunFailed?.(`Pipeline "${initialPipeline.id}" is an autopilot pipeline, and it is not safe to leave this run alone yet:
 ` + problems.map((p) => `  - ${p}`).join("\n"));
-          return { kind: "error" };
+          return dirty && problems.length === 1 ? { kind: "error", dirty } : { kind: "error" };
         }
       }
       while (true) {
@@ -32468,6 +32563,26 @@ var require_execEngine = __commonJS({
           hooks.onRunFailed?.("Run failed.");
           return { kind: "error" };
         }
+        const atIdx = state.currentStepIdx;
+        if (state.steps[atIdx] && state.steps[atIdx].status !== "rejected") {
+          const pick = (0, runProgress_1.nextRunnableStep)(state, initialPipeline, untilIdx);
+          if (pick >= 0 && pick !== atIdx) {
+            hooks.onStepBypassed?.({
+              stepIdx: atIdx,
+              label: stepLabel3(state.steps[atIdx]),
+              nextStepIdx: pick,
+              nextLabel: stepLabel3(state.steps[pick]),
+              runId
+            });
+            state.currentStepIdx = pick;
+            if (!opts.dryRun) {
+              persist(root, state);
+            }
+          } else if (pick < 0 && untilIdx >= 0 && (0, runProgress_1.isActiveStatus)(state.steps[atIdx].status)) {
+            hooks.onUntilStop?.({ untilIdx });
+            return { kind: "until" };
+          }
+        }
         const step = state.steps[state.currentStepIdx];
         if (step.status === "awaiting_auto_review") {
           const proceed = await runAutoReviewStep(root, runId, hooks);
@@ -32706,7 +32821,8 @@ About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` :
       }
       const batchNo = report ? batchesOf(stepRec).length + 1 : 0;
       const batchNote = report ? batchInstructions(report, batchNo, stepRec.revision) : null;
-      const userMessage = [baseMessage, feedback, batchNote].filter(Boolean).join("\n\n");
+      const leftoverNote = leftoverInstructions(stepRec);
+      const userMessage = [baseMessage, feedback, leftoverNote, batchNote].filter(Boolean).join("\n\n");
       if (opts.dryRun) {
         hooks.onDryRunPreview?.({
           skills: skillIds.join(", "),
@@ -32768,6 +32884,7 @@ About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` :
       }
       if (stop.signal.aborted) {
         recordInterrupted(root, runId, stepIdx, timedOut ? { why: "timeout", minutes } : { why: "stopped" });
+        recordLeftover(root, runId, stepIdx, timedOut ? "timeout" : "stopped", codeExclude);
         if (timedOut) {
           hooks.onStepFailed?.({
             stepIdx,
@@ -32781,6 +32898,7 @@ About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` :
         return "stopped";
       }
       if (!result || !result.success) {
+        recordLeftover(root, runId, stepIdx, "failed", codeExclude);
         hooks.onStepFailed?.({ stepIdx, agent: agentId, label: stepLabel3(stepRec), message: `Step "${agentId}" failed (non-zero exit).` });
         return "failed";
       }
@@ -32836,6 +32954,7 @@ About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` :
             return "failed";
           }
           recordProvenance(rec, { agent, resolvedModel, agentModel, skillIds, alternatives, modelOpts });
+          delete rec.leftover;
           const cost = addBatchCost(rec, batchNo, result, batchCost(result, ws, agent.runner, resolvedModel ?? agentModel));
           rec.history = [...rec.history ?? [], {
             kind: "batch",
@@ -32864,6 +32983,7 @@ About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` :
         freshState = RunStateStore_1.RunStateStore.load(root, runId);
         const rec = freshState.steps[stepIdx];
         recordProvenance(rec, { agent, resolvedModel, agentModel, skillIds, alternatives, modelOpts });
+        delete rec.leftover;
         addBatchCost(rec, batchNo, result, batchCost(result, ws, agent.runner, resolvedModel ?? agentModel));
         next = (0, PipelineRunner_1.markStepDone)({ state: freshState, pipeline, workspaceRoot: root });
       } catch (err) {
@@ -32992,6 +33112,29 @@ About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` :
       }];
       RunStateStore_1.RunStateStore.save(root, fresh);
     }
+    function recordLeftover(root, runId, stepIdx, why, exclude) {
+      const fresh = RunStateStore_1.RunStateStore.load(root, runId);
+      const rec = fresh?.steps[stepIdx];
+      if (!fresh || !rec) {
+        return;
+      }
+      const paths = (0, codeFingerprint_1.uncommittedPaths)(root, exclude);
+      const tree = paths.length > 0 ? (0, codeFingerprint_1.codeFingerprint)(root, exclude) : null;
+      if (tree) {
+        rec.leftover = { at: (/* @__PURE__ */ new Date()).toISOString(), revision: rec.revision, why, tree, paths };
+      } else {
+        delete rec.leftover;
+      }
+      RunStateStore_1.RunStateStore.save(root, fresh);
+    }
+    function leftoverInstructions(rec) {
+      const l = rec.leftover;
+      if (!l || l.revision !== rec.revision) {
+        return null;
+      }
+      const shown = l.paths.slice(0, 20).join(", ") + (l.paths.length > 20 ? `, and ${l.paths.length - 20} more` : "");
+      return `A previous attempt at this revision stopped before it finished. Its unfinished changes are still in the working tree, uncommitted: ${shown}. Read them first and carry on from there \u2014 keep what is right, finish what is missing \u2014 rather than starting over.`;
+    }
     async function runAutoReviewStep(root, runId, hooks) {
       const state = RunStateStore_1.RunStateStore.load(root, runId);
       if (!state) {
@@ -35463,9 +35606,9 @@ var require_dist = __commonJS({
     exports2.readUserConfig = exports2.readGitUserName = exports2.ensureUserConfigIgnored = exports2.USER_CONFIG_RELPATH = exports2.USER_CONFIG_IGNORE_LINE = exports2.suggestEpicId = exports2.resolveEpicIdPrefixChain = exports2.resolveEpicIdPrefix = exports2.epicIdDateStamp = exports2.deriveEpicIdPrefix = exports2.EPIC_ID_PREFIX_PATTERN = exports2.EPIC_ID_PREFIX_KEY = exports2.resolveArtifactLanguage = exports2.commandBodyPredatesArtifactLanguage = exports2.artifactLanguageSection = exports2.ARTIFACT_LANGUAGE_HEADING = exports2.stripPersonaDirectives = exports2.composeAgentPrompt = exports2.PROJECT_INSTRUCTION_FILES = exports2.findProjectInstructions = exports2.stripPersonaMetadata = exports2.PersonaLoader = exports2.SkillNotFoundError = exports2.SkillLoader = exports2.EnvVarMissingError = exports2.EnvResolver = exports2.epicPipelineReport = exports2.planEpicPipelineExtraction = exports2.epicOwningPipeline = exports2.unstageEpicPipeline = exports2.stageEpicPipeline = exports2.writeEpicPipelines = exports2.splitEpicPipelines = exports2.mergeEpicPipelines = exports2.epicPipelinePath = exports2.EPIC_PIPELINE_FILENAME = exports2.unusedAfterStepRemoval = exports2.skillReferences = exports2.agentReferences = exports2.renameSkillRefs = exports2.renameAgentRefs = exports2.dropRecipesForPipeline = exports2.dropRecipeStep = exports2.recipesDrawingFrom = exports2.WORKSPACE_DIR = exports2.WORKSPACE_FILENAME = exports2.WorkspaceParseError = exports2.WorkspaceNotFoundError = exports2.WorkspaceLoader = exports2.renderPlanMarkdown = void 0;
     exports2.hasEmptyCiChecks = exports2.findApprovalGate = exports2.autopilotPreflight = exports2.STOP_GRACE_MS = exports2.stopProcessTree = exports2.stopOnAbort = exports2.processGroupSpawnOptions = exports2.claudeModelArg = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = exports2.commandBodyIsStale = exports2.readEpicTags = exports2.normalizeTags = exports2.normalizeTag = exports2.epicMatchesTags = exports2.applyTagEdit = exports2.MAX_TAG_LENGTH = exports2.EPIC_TAGS_KEY = exports2.inheritedContextNote = exports2.INHERITED_CONTEXT_MARKER = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.setEpicWatched = exports2.setEpicListFlat = exports2.setEpicSort = exports2.setActiveEpic = exports2.recordEpicOpened = exports2.readEpicListFlat = exports2.readEpicSort = exports2.readEpicFocus = exports2.pushRecent = exports2.epicSortFrom = exports2.epicIdFromBranch = exports2.epicFocusFrom = exports2.WATCHED_EPICS_KEY = exports2.RECENT_EPICS_LIMIT = exports2.RECENT_EPICS_KEY = exports2.EPIC_LIST_FLAT_KEY = exports2.EPIC_SORT_KEY = exports2.ACTIVE_EPIC_KEY = exports2.writeUserEpicIdPrefix = exports2.userConfigPath = exports2.updateUserConfig = void 0;
     exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = exports2.dirtyUpstreamOf = exports2.rerunApprovedStep = exports2.canRerunApprovedStep = exports2.recordLaunchFeedback = exports2.chooseStepModel = exports2.chooseStepSkill = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = exports2.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = exports2.startRun = exports2.activateBackendFromWorkspace = exports2.activateRunStateBackend = exports2.resolveRunStateBackend = exports2.GitRunStateStore = exports2.RUN_ID_PATTERN = exports2.FileRunStateStore = exports2.RunStateStore = exports2.harnessCapabilities = exports2.NO_HARNESS_CAPABILITIES = exports2.RunnerValidationError = exports2.validateRunnerExport = exports2.CustomRunnerLoader = exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.copilotMcpConfig = exports2.copilotGraphServer = exports2.CopilotRunner = exports2.CodexRunner = exports2.AUTOPILOT_ENV = exports2.APPROVAL_GATE_SCRIPT = exports2.emptyCiChecksMessage = void 0;
-    exports2.FAST_MODEL = exports2.CODING_MODEL = exports2.PLANNING_MODEL = exports2.isBuiltinPreset = exports2.BUILTIN_PRESET_IDS = exports2.writeBuiltinAutoReviewValidators = exports2.resolvePrimaryStack = exports2.getSdlcArtifactTemplates = exports2.getBuiltinArtifactTemplates = exports2.phaseArtifactFileName = exports2.sdlcClaudeCommand = exports2.builtinClaudeCommand = exports2.loadAllBuiltinPresets = exports2.loadBuiltinPreset = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = exports2.PHASES = exports2.BUILTIN_WORKFLOWS = exports2.withBackfilledStepNames = exports2.describeDrift = exports2.reconcileRunSteps = exports2.RUN_STATE_SCHEMA_VERSION = exports2.migrateRunState = exports2.stepIdentity = exports2.resolvePath = exports2.AutoReviewerError = exports2.runAutoReview = exports2.renderRunReport = exports2.verifyRun = exports2.stepLabel = exports2.runExecLoop = exports2.estimateCostUsd = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.unchangedProduces = exports2.snapshotProduces = exports2.checkBudget = exports2.weighStepProgress = exports2.isActiveStatus = exports2.isStepOptional = void 0;
-    exports2.setClaudeConfigDir = exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = exports2.backboneCommandDoc = exports2.unprovisionedPhases = exports2.nextEligiblePhase = exports2.resolveComposition = exports2.shortcutCommandId = exports2.getCanonicalPhase = exports2.isCanonicalPhase = exports2.BACKBONE_COMMAND_ID = exports2.CANONICAL_PHASE_IDS = exports2.CANONICAL_PHASES = exports2.renderTemplate = exports2.DEFAULT_GLOBAL_WORKFLOW_IDS = exports2.detectGlobalBuiltinSource = exports2.uninstallWorkflowGlobalsByIds = exports2.isWorkflowGloballyInstalled = exports2.installWorkflowGlobalsByIds = exports2.installGlobalDefaults = exports2.stepModelOptions = exports2.pickAgentModel = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = void 0;
-    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = void 0;
+    exports2.CODING_MODEL = exports2.PLANNING_MODEL = exports2.isBuiltinPreset = exports2.BUILTIN_PRESET_IDS = exports2.writeBuiltinAutoReviewValidators = exports2.resolvePrimaryStack = exports2.getSdlcArtifactTemplates = exports2.getBuiltinArtifactTemplates = exports2.phaseArtifactFileName = exports2.sdlcClaudeCommand = exports2.builtinClaudeCommand = exports2.loadAllBuiltinPresets = exports2.loadBuiltinPreset = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = exports2.PHASES = exports2.BUILTIN_WORKFLOWS = exports2.withBackfilledStepNames = exports2.describeDrift = exports2.reconcileRunSteps = exports2.RUN_STATE_SCHEMA_VERSION = exports2.migrateRunState = exports2.stepIdentity = exports2.resolvePath = exports2.AutoReviewerError = exports2.runAutoReview = exports2.renderRunReport = exports2.verifyRun = exports2.stepLabel = exports2.runExecLoop = exports2.estimateCostUsd = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.unchangedProduces = exports2.snapshotProduces = exports2.checkBudget = exports2.weighStepProgress = exports2.nextRunnableStep = exports2.isActiveStatus = exports2.isStepOptional = void 0;
+    exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = exports2.backboneCommandDoc = exports2.unprovisionedPhases = exports2.nextEligiblePhase = exports2.resolveComposition = exports2.shortcutCommandId = exports2.getCanonicalPhase = exports2.isCanonicalPhase = exports2.BACKBONE_COMMAND_ID = exports2.CANONICAL_PHASE_IDS = exports2.CANONICAL_PHASES = exports2.renderTemplate = exports2.DEFAULT_GLOBAL_WORKFLOW_IDS = exports2.detectGlobalBuiltinSource = exports2.uninstallWorkflowGlobalsByIds = exports2.isWorkflowGloballyInstalled = exports2.installWorkflowGlobalsByIds = exports2.installGlobalDefaults = exports2.stepModelOptions = exports2.pickAgentModel = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = exports2.FAST_MODEL = void 0;
+    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = exports2.setClaudeConfigDir = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -36272,6 +36415,9 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "isActiveStatus", { enumerable: true, get: function() {
       return runProgress_1.isActiveStatus;
     } });
+    Object.defineProperty(exports2, "nextRunnableStep", { enumerable: true, get: function() {
+      return runProgress_1.nextRunnableStep;
+    } });
     Object.defineProperty(exports2, "weighStepProgress", { enumerable: true, get: function() {
       return runProgress_1.weighStepProgress;
     } });
@@ -45293,7 +45439,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.45",
+      version: "4.0.47",
       description: "AIDLC Native CLI, a fork of AIDLC \u2014 drive Claude through the six-stage AI-Native SDLC Playbook: Plan \u2192 Design \u2192 Build \u2192 Test \u2192 Deploy \u2192 Maintain, with artifact gates, requirements traceability, an incident loop back to Plan, and Spec Kit support.",
       license: "MIT",
       repository: {
@@ -50328,7 +50474,7 @@ function registerRun(program3) {
   });
   cmd.command("exec <runId>").description(
     "Execute the current step by spawning the claude CLI, then auto-advance.\n  Streams output live. Stops at human_review steps unless --auto-approve.\n  Exit codes: 0 completed (or stopped at --until), 2 paused on a gate\n  (awaiting review / rejected / sent back max_send_backs times / no code\n  change after a send-back or a batch / max_batches / pause_between_batches /\n  budget / stopped), 1 error (a step that ran\n  past its timeout_minutes included). --require-complete maps any\n  non-completed outcome to 1 for CI gating.\n  Ctrl+C once: stop after the running step. Twice: stop it now."
-  ).option("--until <step>", "Stop after this step completes (index or agent id)").option("--auto-approve", "Also auto-approve human_review steps without pausing").option("--require-complete", "Exit 1 unless the run reaches completed (for CI gating)").option("--json", "Suppress decorative output; print a final JSON summary to stdout (claude stream goes to stderr)").option("--message <text>", "Override the user message sent to claude (default: context pairs)").option("--dry-run", "Print the assembled prompt without spawning claude").option("--skill <id>", "On steps that offer alternative skills (default_skill), run this one").action(async (runId, opts, actionCmd) => {
+  ).option("--until <step>", "Stop after this step completes (index or agent id)").option("--auto-approve", "Also auto-approve human_review steps without pausing").option("--require-complete", "Exit 1 unless the run reaches completed (for CI gating)").option("--json", "Suppress decorative output; print a final JSON summary to stdout (claude stream goes to stderr)").option("--message <text>", "Override the user message sent to claude (default: context pairs)").option("--dry-run", "Print the assembled prompt without spawning claude").option("--skill <id>", "On steps that offer alternative skills (default_skill), run this one").option("--allow-dirty", "Autopilot: start on top of uncommitted changes (e.g. a step killed mid-run)").action(async (runId, opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     if (opts.json) {
       setQuiet(true);
@@ -50458,6 +50604,7 @@ async function execLoop(root, runId, opts) {
         message: opts.message,
         dryRun: opts.dryRun,
         skill: opts.skill,
+        allowDirty: opts.allowDirty,
         shouldCancel: () => cancelRequested,
         signal: stopNow.signal
       },
@@ -50511,6 +50658,7 @@ function cliExecHooks(runId, claudeOut) {
     onRunCompleted: () => info(import_chalk10.default.green("\n\u{1F389} Run completed \u2014 all steps approved.")),
     onRunFailed: (reason) => console.error(import_chalk10.default.red(`
 ${reason}`)),
+    onPreflightNote: (message) => info(import_chalk10.default.yellow(`\u26A0  ${message}`)),
     onStepStart: (e) => {
       info(import_chalk10.default.bold(`
 \u25B6  Step ${e.stepIdx}: ${e.label}`) + import_chalk10.default.dim(` (rev ${e.revision})`));
@@ -50599,6 +50747,10 @@ ${reason}`)),
 \u2933  Step "${e.label}" was rejected \u2014 carrying on.`) + import_chalk10.default.dim(` ${e.reason}`));
       info(import_chalk10.default.dim(`  Want it back? aidlc run rerun ${e.runId} --step ${e.stepIdx}`));
     },
+    onStepBypassed: (e) => {
+      info(import_chalk10.default.dim(`
+\u2933  Not running "${e.label}" \u2014 the run does not need it here. Running "${e.nextLabel}" instead.`));
+    },
     onAutoReviewStart: (e) => info(import_chalk10.default.bold(`
 \u{1F50D}  Auto-review: "${e.label}"`)),
     onAutoReviewResult: (e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delete101020/aidlc",
-  "version": "4.0.45",
+  "version": "4.0.47",
   "description": "AIDLC Native CLI, a fork of AIDLC — drive Claude through the six-stage AI-Native SDLC Playbook: Plan → Design → Build → Test → Deploy → Maintain, with artifact gates, requirements traceability, an incident loop back to Plan, and Spec Kit support.",
   "license": "MIT",
   "repository": {