@delete101020/aidlc 4.0.46 → 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

@@ -31195,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) {
@@ -31247,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";
@@ -31325,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));
@@ -31368,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 === "*") {
@@ -32207,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) {
@@ -32481,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) {
@@ -32769,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(", "),
@@ -32831,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,
@@ -32844,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";
       }
@@ -32899,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",
@@ -32927,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) {
@@ -33055,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) {
@@ -45359,7 +45439,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.46",
+      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: {
@@ -50394,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);
@@ -50524,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
       },
@@ -50577,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})`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delete101020/aidlc",
-  "version": "4.0.46",
+  "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": {