@delete101020/aidlc 4.0.9 → 4.0.11

package/dist/bundle.js

@@ -19837,6 +19837,17 @@ var require_WorkspaceSchema = __commonJS({
       name: zod_1.z.string().optional(),
       /** Step is part of the pipeline but skipped at run time when false. Defaults to true. */
       enabled: zod_1.z.boolean().default(true),
+      /**
+       * A step the run may fail and carry on past. Its rejection never marks the
+       * epic failed, never parks the run cursor, and never keeps the run from
+       * completing; the autopilot loop steps over it to whatever else is open.
+       *
+       * For the side branch whose findings are welcome but not required — a
+       * second reviewer's lens, an optional QC pass. Without the flag the only
+       * thing making such a step skippable is that nothing happens to
+       * `depends_on` it, which the runner cannot tell from an oversight.
+       */
+      optional: zod_1.z.boolean().default(false),
       /** Artifact paths the step is expected to produce. Checked after work. */
       produces: zod_1.z.array(zod_1.z.string().min(1)).default([]),
       /**
@@ -19969,6 +19980,7 @@ var require_WorkspaceSchema = __commonJS({
         return {
           agent: step,
           enabled: true,
+          optional: false,
           produces: [],
           produces_contains: [],
           requires: [],
@@ -19994,6 +20006,7 @@ var require_WorkspaceSchema = __commonJS({
         name: typeof obj.name === "string" ? obj.name : void 0,
         skills,
         enabled: typeof obj.enabled === "boolean" ? obj.enabled : true,
+        optional: obj.optional === true,
         produces,
         produces_contains,
         requires,
@@ -20055,6 +20068,24 @@ var require_WorkspaceSchema = __commonJS({
           }
         }
       }
+      const pipelineIds = new Set(config.pipelines.map((p) => p.id));
+      for (const cmd of config.slash_commands ?? []) {
+        const target = cmd;
+        if (typeof target.agent === "string" && !agentIds.has(target.agent)) {
+          issues.push({
+            code: "unknown-command-agent",
+            message: `Slash command "${target.name}" targets agent "${target.agent}" which is not defined in agents:`,
+            path: `slash_commands.${target.name}.agent`
+          });
+        }
+        if (typeof target.pipeline === "string" && !pipelineIds.has(target.pipeline)) {
+          issues.push({
+            code: "unknown-command-pipeline",
+            message: `Slash command "${target.name}" targets pipeline "${target.pipeline}" which is not defined in pipelines:`,
+            path: `slash_commands.${target.name}.pipeline`
+          });
+        }
+      }
       const pipelinesById = new Map(config.pipelines.map((p) => [p.id, p]));
       for (const recipe of config.recipes) {
         const source = recipe.from ? pipelinesById.get(recipe.from) : config.pipelines[0];
@@ -20752,6 +20783,83 @@ var require_RunState = __commonJS({
   }
 });
 
+// ../core/dist/runs/runProgress.js
+var require_runProgress = __commonJS({
+  "../core/dist/runs/runProgress.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.isActiveStatus = isActiveStatus;
+    exports2.isStepOptional = isStepOptional;
+    exports2.deriveRunProgress = deriveRunProgress;
+    exports2.isRunComplete = isRunComplete;
+    var WorkspaceSchema_1 = require_WorkspaceSchema();
+    var ACTIVE = /* @__PURE__ */ new Set([
+      "awaiting_work",
+      "awaiting_auto_review",
+      "awaiting_review"
+    ]);
+    function isActiveStatus(status) {
+      return ACTIVE.has(status);
+    }
+    function isStepOptional(pipeline, idx) {
+      const cfg = pipeline?.steps?.[idx];
+      return cfg === void 0 ? false : (0, WorkspaceSchema_1.normalizeStep)(cfg).optional;
+    }
+    function usesDag(pipeline) {
+      return pipeline.steps.some((s) => (0, WorkspaceSchema_1.normalizeStep)(s).depends_on.length > 0);
+    }
+    function deriveRunProgress(state, pipeline) {
+      const dag = pipeline ? usesDag(pipeline) : false;
+      const approvedDagIds = /* @__PURE__ */ new Set();
+      if (pipeline && dag) {
+        state.steps.forEach((s, i) => {
+          if (s.status !== "approved") {
+            return;
+          }
+          const norm = (0, WorkspaceSchema_1.normalizeStep)(pipeline.steps[i] ?? { agent: s.agent });
+          approvedDagIds.add(norm.name ?? norm.agent);
+        });
+      }
+      const actionable = [];
+      const rejected = [];
+      const blocking = [];
+      state.steps.forEach((s, i) => {
+        if (isActiveStatus(s.status)) {
+          actionable.push(i);
+          return;
+        }
+        if (s.status === "rejected") {
+          rejected.push(i);
+          if (!isStepOptional(pipeline, i)) {
+            blocking.push(i);
+          }
+          return;
+        }
+        if (s.status === "pending" && pipeline && dag) {
+          const deps = (0, WorkspaceSchema_1.normalizeStep)(pipeline.steps[i] ?? { agent: s.agent }).depends_on;
+          if (deps.length > 0 && deps.every((d) => approvedDagIds.has(d))) {
+            actionable.push(i);
+          }
+        }
+      });
+      const stuck = blocking.length > 0 && actionable.length === 0;
+      const status = state.status === "completed" ? "done" : stuck ? "failed" : "in_progress";
+      return { actionable, rejected, blocking, stuck, status };
+    }
+    function isRunComplete(state, pipeline) {
+      return state.steps.every((s, i) => {
+        if (s.status === "approved") {
+          return true;
+        }
+        if (!isStepOptional(pipeline, i)) {
+          return false;
+        }
+        return s.status === "rejected" || s.status === "pending";
+      });
+    }
+  }
+});
+
 // ../core/dist/runs/reconcileRun.js
 var require_reconcileRun = __commonJS({
   "../core/dist/runs/reconcileRun.js"(exports2) {
@@ -20920,6 +21028,7 @@ var require_PipelineRunner = __commonJS({
     var path17 = __importStar(require("path"));
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var RunState_1 = require_RunState();
+    var runProgress_1 = require_runProgress();
     var reconcileRun_1 = require_reconcileRun();
     var PipelineRunError3 = class extends Error {
       missing;
@@ -21099,6 +21208,7 @@ var require_PipelineRunner = __commonJS({
           sentBackToIdx: idx
         });
         next.status = "running";
+        settleOptionalRejection(next, idx, pipeline);
         return next;
       }
       if (norm.human_review) {
@@ -21239,6 +21349,9 @@ var require_PipelineRunner = __commonJS({
         })
       };
       next.status = "running";
+      if (pipeline) {
+        settleOptionalRejection(next, idx, pipeline);
+      }
       return next;
     }
     function rerunStep3(args) {
@@ -21357,7 +21470,7 @@ var require_PipelineRunner = __commonJS({
       }
       const dagId = (i) => normalized[i].name ?? normalized[i].agent;
       const approvedDagIds = new Set(next.steps.filter((s) => s.status === "approved").map((s) => dagId(s.stepIdx)));
-      let openedAny = false;
+      const opened = [];
       for (let i = 0; i < normalized.length; i++) {
         const sStep = next.steps[i];
         if (sStep.status !== "pending") {
@@ -21376,25 +21489,47 @@ var require_PipelineRunner = __commonJS({
           status: "awaiting_work",
           startedAt: finishedAt
         };
-        openedAny = true;
-        if (next.currentStepIdx === idx) {
-          next.currentStepIdx = i;
-        }
+        opened.push(i);
       }
-      const allApproved = next.steps.every((s) => s.status === "approved");
-      if (allApproved) {
+      if ((0, runProgress_1.isRunComplete)(next, pipeline)) {
         next.status = "completed";
         return next;
       }
-      if (!openedAny) {
-        const stillActive = next.steps.findIndex((s) => s.status === "awaiting_work" || s.status === "awaiting_auto_review" || s.status === "awaiting_review");
-        if (stillActive >= 0) {
-          next.currentStepIdx = stillActive;
-        }
-      }
+      refocusCursor(next, opened);
       next.status = "running";
       return next;
     }
+    function refocusCursor(next, opened) {
+      const cur = next.steps[next.currentStepIdx];
+      if (cur && cur.status !== "approved" && cur.status !== "rejected") {
+        return;
+      }
+      const target = opened.length > 0 ? Math.min(...opened) : next.steps.findIndex((s) => (0, runProgress_1.isActiveStatus)(s.status));
+      if (target >= 0) {
+        next.currentStepIdx = target;
+      }
+    }
+    function settleOptionalRejection(next, idx, pipeline) {
+      if (!(0, runProgress_1.isStepOptional)(pipeline, idx)) {
+        return;
+      }
+      const normalized = pipeline.steps.map(WorkspaceSchema_1.normalizeStep);
+      const usesDag = normalized.some((s) => s.depends_on.length > 0);
+      if (!usesDag) {
+        const follower = next.steps[idx + 1];
+        if (follower && follower.status === "pending") {
+          next.steps[idx + 1] = {
+            ...follower,
+            status: "awaiting_work",
+            startedAt: (/* @__PURE__ */ new Date()).toISOString()
+          };
+        }
+      }
+      refocusCursor(next, []);
+      if ((0, runProgress_1.isRunComplete)(next, pipeline)) {
+        next.status = "completed";
+      }
+    }
     function clone(value) {
       return JSON.parse(JSON.stringify(value));
     }
@@ -25081,10 +25216,12 @@ var require_EpicScaffold = __commonJS({
     exports2.epicsRoot = epicsRoot3;
     exports2.mapStepStatusToEpic = mapStepStatusToEpic;
     exports2.mirrorRunStateToEpic = mirrorRunStateToEpic2;
+    exports2.lockedEpicDirError = lockedEpicDirError;
     exports2.scaffoldEpic = scaffoldEpic2;
     var fs14 = __importStar(require("fs"));
     var path17 = __importStar(require("path"));
     var PipelineRunner_1 = require_PipelineRunner();
+    var runProgress_1 = require_runProgress();
     var RunStateStore_1 = require_RunStateStore();
     var EpicPipelineStore_1 = require_EpicPipelineStore();
     var epicTags_1 = require_epicTags();
@@ -25132,7 +25269,9 @@ var require_EpicScaffold = __commonJS({
       } catch {
         return;
       }
-      const epicStatus = runState.status === "completed" ? "done" : runState.steps.some((s) => s.status === "rejected") ? "failed" : "in_progress";
+      const pipelines = Array.isArray(doc?.pipelines) ? doc.pipelines : [];
+      const pipeline = pipelines.find((p) => p.id === runState.pipelineId);
+      const epicStatus = (0, runProgress_1.deriveRunProgress)(runState, pipeline).status;
       const stepStates = runState.steps.map((s) => ({
         agent: s.agent,
         // The step's identity, mirrored alongside its agent so state.json says
@@ -25161,6 +25300,15 @@ var require_EpicScaffold = __commonJS({
       };
       fs14.writeFileSync(stateFile, JSON.stringify(next, null, 2) + "\n", "utf8");
     }
+    function lockedEpicDirError(workspaceRoot, epicDir, err, action) {
+      const rel = path17.relative(workspaceRoot, epicDir) || epicDir;
+      const code = err?.code;
+      const detail = err instanceof Error ? err.message : String(err);
+      if (code === "EPERM" || code === "EACCES" || code === "EBUSY") {
+        return new EpicScaffoldError3(`Epic dir ${rel} exists but cannot be ${action === "read" ? "read" : "created"} (${code}). It was most likely deleted while another process still held it open \u2014 on Windows the name survives until the last handle closes. Close whatever points at it (editor window, a terminal sitting in that folder, file explorer) or reboot, then start the epic again. Deleting it again will not help. Underlying error: ${detail}`);
+      }
+      return new EpicScaffoldError3(`Cannot ${action} epic dir ${rel}: ${detail}`);
+    }
     function scaffoldEpic2(args) {
       const { workspaceRoot, doc, epicId, title, description, target, agents, inputs, extraProjects, pipeline, seedArtifacts, enableAutopilot = false, strictMode = true, tags } = args;
       if (!epicId.trim()) {
@@ -25171,12 +25319,21 @@ var require_EpicScaffold = __commonJS({
       }
       const epicDir = path17.join(epicsRoot3(workspaceRoot, doc), epicId);
       if (fs14.existsSync(epicDir)) {
-        const entries = fs14.readdirSync(epicDir);
+        let entries;
+        try {
+          entries = fs14.readdirSync(epicDir);
+        } catch (err) {
+          throw lockedEpicDirError(workspaceRoot, epicDir, err, "read");
+        }
         if (entries.length !== 1 || entries[0] !== EpicPipelineStore_1.EPIC_PIPELINE_FILENAME) {
           throw new EpicScaffoldError3(`Epic dir already exists at ${path17.relative(workspaceRoot, epicDir) || epicDir}. Delete it first.`);
         }
       }
-      fs14.mkdirSync(epicDir, { recursive: true });
+      try {
+        fs14.mkdirSync(epicDir, { recursive: true });
+      } catch (err) {
+        throw lockedEpicDirError(workspaceRoot, epicDir, err, "create");
+      }
       const artifactsDir = path17.join(epicDir, "artifacts");
       fs14.mkdirSync(artifactsDir, { recursive: true });
       for (const [fileName, content] of Object.entries(seedArtifacts ?? {})) {
@@ -25427,6 +25584,400 @@ var require_EpicArtifactCommit = __commonJS({
   }
 });
 
+// ../core/dist/runs/EpicDescription.js
+var require_EpicDescription = __commonJS({
+  "../core/dist/runs/EpicDescription.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.EpicDescriptionError = void 0;
+    exports2.setEpicDescription = setEpicDescription2;
+    var fs14 = __importStar(require("fs"));
+    var path17 = __importStar(require("path"));
+    var EpicDescriptionError2 = class extends Error {
+      constructor(message) {
+        super(message);
+        this.name = "EpicDescriptionError";
+      }
+    };
+    exports2.EpicDescriptionError = EpicDescriptionError2;
+    function readState(stateFile, epicId) {
+      let raw;
+      try {
+        raw = fs14.readFileSync(stateFile, "utf8");
+      } catch (err) {
+        throw new EpicDescriptionError2(`Cannot read ${path17.basename(stateFile)} for ${epicId}: ${err.message}`);
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(raw);
+      } catch (err) {
+        throw new EpicDescriptionError2(`${stateFile} is not valid JSON \u2014 fix it by hand before editing the description. ${err.message}`);
+      }
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new EpicDescriptionError2(`${stateFile} does not hold an epic state object.`);
+      }
+      return parsed;
+    }
+    function splitDoc(text) {
+      const lines = text.split(/\r?\n/);
+      const h1 = lines.findIndex((l) => /^#\s/.test(l));
+      if (h1 === -1) {
+        return null;
+      }
+      let end = lines.length;
+      for (let i = h1 + 1; i < lines.length; i++) {
+        if (/^#{1,6}\s/.test(lines[i])) {
+          end = i;
+          break;
+        }
+      }
+      return {
+        head: lines.slice(0, h1 + 1).join("\n"),
+        lead: lines.slice(h1 + 1, end).join("\n"),
+        rest: lines.slice(end).join("\n")
+      };
+    }
+    function setEpicDescription2(epicDir, epicId, description) {
+      const next = description.trim();
+      const stateFile = path17.join(epicDir, "state.json");
+      const docFile = path17.join(epicDir, `${epicId}.md`);
+      const state = readState(stateFile, epicId);
+      const previous = typeof state.description === "string" ? state.description : "";
+      state.description = next;
+      try {
+        fs14.writeFileSync(stateFile, JSON.stringify(state, null, 2) + "\n", "utf8");
+      } catch (err) {
+        throw new EpicDescriptionError2(`Cannot write ${stateFile}: ${err.message}`);
+      }
+      const title = typeof state.title === "string" ? state.title.trim() : "";
+      const doc = writeDoc(docFile, epicId, title, previous, next);
+      return { epicId, description: next, previous, doc, docFile };
+    }
+    function writeDoc(docFile, epicId, title, previous, next) {
+      let text = null;
+      try {
+        text = fs14.readFileSync(docFile, "utf8");
+      } catch {
+        text = null;
+      }
+      if (text === null) {
+        const body = `# ${epicId}${title ? ` \u2014 ${title}` : ""}
+` + (next ? `
+${next}
+` : "");
+        try {
+          fs14.mkdirSync(path17.dirname(docFile), { recursive: true });
+          fs14.writeFileSync(docFile, body, "utf8");
+        } catch (err) {
+          throw new EpicDescriptionError2(`Cannot write ${docFile}: ${err.message}`);
+        }
+        return "created";
+      }
+      const parts = splitDoc(text);
+      if (!parts) {
+        return "kept";
+      }
+      const leadText = parts.lead.trim();
+      if (leadText !== previous.trim()) {
+        return "kept";
+      }
+      if (leadText === next) {
+        return "unchanged";
+      }
+      const rebuilt = parts.head + "\n" + (next ? `
+${next}
+` : "") + (parts.rest ? `
+${parts.rest}` : "");
+      try {
+        fs14.writeFileSync(docFile, rebuilt, "utf8");
+      } catch (err) {
+        throw new EpicDescriptionError2(`Cannot write ${docFile}: ${err.message}`);
+      }
+      return "updated";
+    }
+  }
+});
+
+// ../core/dist/runs/EpicWorkflowSwitch.js
+var require_EpicWorkflowSwitch = __commonJS({
+  "../core/dist/runs/EpicWorkflowSwitch.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.EpicWorkflowSwitchError = void 0;
+    exports2.epicWorkflowLock = epicWorkflowLock2;
+    exports2.canSwitchEpicWorkflow = canSwitchEpicWorkflow;
+    exports2.planEpicWorkflowSwitch = planEpicWorkflowSwitch2;
+    exports2.stageEpicWorkflowSwitch = stageEpicWorkflowSwitch2;
+    exports2.applyEpicWorkflowSwitch = applyEpicWorkflowSwitch2;
+    var fs14 = __importStar(require("fs"));
+    var path17 = __importStar(require("path"));
+    var WorkspaceSchema_1 = require_WorkspaceSchema();
+    var PipelineRunner_1 = require_PipelineRunner();
+    var RunStateStore_1 = require_RunStateStore();
+    var PipelineAssembler_1 = require_PipelineAssembler();
+    var EpicScaffold_1 = require_EpicScaffold();
+    var EpicPipelineStore_1 = require_EpicPipelineStore();
+    var EpicWorkflowSwitchError2 = class extends Error {
+      constructor(message) {
+        super(message);
+        this.name = "EpicWorkflowSwitchError";
+      }
+    };
+    exports2.EpicWorkflowSwitchError = EpicWorkflowSwitchError2;
+    function epicWorkflowLock2(run) {
+      if (!run) {
+        return null;
+      }
+      if (run.status !== "running") {
+        return `the run is already ${run.status}`;
+      }
+      for (const step of run.steps) {
+        const id = step.name ?? step.agent;
+        if (step.status !== "pending" && step.status !== "awaiting_work") {
+          return `step "${id}" is ${step.status}`;
+        }
+        if (step.revision > 1) {
+          return `step "${id}" has already been rerun`;
+        }
+        if ((step.history?.length ?? 0) > 0) {
+          return `step "${id}" already has history`;
+        }
+        if (step.artifactsProduced.length > 0) {
+          return `step "${id}" has produced artifacts`;
+        }
+      }
+      return null;
+    }
+    function canSwitchEpicWorkflow(workspaceRoot, epicId) {
+      return epicWorkflowLock2(RunStateStore_1.RunStateStore.load(workspaceRoot, epicId)) === null;
+    }
+    function readEpicState(epicDir, epicId) {
+      const file = path17.join(epicDir, "state.json");
+      let raw;
+      try {
+        raw = fs14.readFileSync(file, "utf8");
+      } catch {
+        throw new EpicWorkflowSwitchError2(`Epic "${epicId}" has no state.json at ${file}.`);
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(raw);
+      } catch (err) {
+        throw new EpicWorkflowSwitchError2(`Epic "${epicId}" has a state.json that is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new EpicWorkflowSwitchError2(`Epic "${epicId}" has a state.json that is not an object.`);
+      }
+      return parsed;
+    }
+    function stepAgents(pipeline) {
+      return pipeline.steps.map((s) => (0, WorkspaceSchema_1.normalizeStep)(s).agent);
+    }
+    function planEpicWorkflowSwitch2(args) {
+      const { workspaceRoot, doc, config, epicId, target } = args;
+      const epicDir = path17.join((0, EpicScaffold_1.epicsRoot)(workspaceRoot, doc), epicId);
+      const state = readEpicState(epicDir, epicId);
+      const lock = epicWorkflowLock2(RunStateStore_1.RunStateStore.load(workspaceRoot, epicId));
+      if (lock) {
+        throw new EpicWorkflowSwitchError2(`Epic "${epicId}" has already started, so its workflow can't be changed: ${lock}. Add or remove individual steps instead (\`aidlc epic step add\` / \`remove\`), or start a new epic.`);
+      }
+      const currentPipelineId = typeof state.pipeline === "string" && state.pipeline ? state.pipeline : null;
+      const currentAgentId = typeof state.agent === "string" && state.agent ? state.agent : null;
+      const from = currentPipelineId ? { kind: "pipeline", id: currentPipelineId } : currentAgentId ? { kind: "agent", id: currentAgentId } : { kind: "none", id: null };
+      const ownFile = (0, EpicPipelineStore_1.epicPipelinePath)(workspaceRoot, doc, epicId);
+      const previousOwnedPipelineId = fs14.existsSync(ownFile) && currentPipelineId ? currentPipelineId : null;
+      let pipeline;
+      let owned;
+      if (target.kind === "pipeline") {
+        const found = config.pipelines.find((p) => p.id === target.id);
+        if (!found) {
+          const available = config.pipelines.map((p) => p.id).join(", ") || "(none defined)";
+          throw new EpicWorkflowSwitchError2(`Pipeline "${target.id}" is not defined. Available: ${available}`);
+        }
+        const otherOwner = (0, EpicPipelineStore_1.epicOwningPipeline)(doc, target.id);
+        if (otherOwner && otherOwner !== epicId) {
+          throw new EpicWorkflowSwitchError2(`Pipeline "${target.id}" belongs to epic "${otherOwner}" \u2014 it lives in that epic's folder and editing it there would reshape that epic too. Pick a recipe instead, and this epic gets its own copy.`);
+        }
+        if (target.id === currentPipelineId) {
+          throw new EpicWorkflowSwitchError2(`Epic "${epicId}" already runs pipeline "${target.id}".`);
+        }
+        if (found.steps.length === 0) {
+          throw new EpicWorkflowSwitchError2(`Pipeline "${target.id}" has no steps to run.`);
+        }
+        pipeline = found;
+        owned = otherOwner === epicId;
+      } else {
+        const taken = new Set(config.pipelines.map((p) => p.id).filter((id) => id !== previousOwnedPipelineId));
+        const pipelineId = (0, PipelineAssembler_1.recipePipelineId)({ recipeId: target.id, epicId, taken });
+        pipeline = (0, PipelineAssembler_1.assemblePipeline)(config, { recipeId: target.id, pipelineId });
+        owned = true;
+      }
+      return {
+        epicId,
+        from,
+        to: target,
+        pipeline,
+        owned,
+        previousOwnedPipelineId,
+        agents: stepAgents(pipeline)
+      };
+    }
+    function stageEpicWorkflowSwitch2(doc, plan) {
+      const { previousOwnedPipelineId, pipeline, owned, epicId } = plan;
+      const next = pipeline;
+      const at = previousOwnedPipelineId ? doc.pipelines.findIndex((p) => p.id === previousOwnedPipelineId) : -1;
+      if (previousOwnedPipelineId) {
+        (0, EpicPipelineStore_1.unstageEpicPipeline)(doc, previousOwnedPipelineId);
+      }
+      if (owned) {
+        const existing = doc.pipelines.findIndex((p) => p.id === pipeline.id);
+        if (existing >= 0) {
+          doc.pipelines.splice(existing, 1, next);
+        } else if (at >= 0) {
+          doc.pipelines.splice(at, 1, next);
+        } else {
+          doc.pipelines.push(next);
+        }
+        if (previousOwnedPipelineId && previousOwnedPipelineId !== pipeline.id) {
+          doc.pipelines = doc.pipelines.filter((p) => p.id !== previousOwnedPipelineId);
+        }
+        (0, EpicPipelineStore_1.stageEpicPipeline)(doc, pipeline.id, epicId);
+      } else if (at >= 0) {
+        doc.pipelines.splice(at, 1);
+      }
+    }
+    function applyEpicWorkflowSwitch2(workspaceRoot, doc, plan) {
+      const { epicId } = plan;
+      const epicDir = path17.join((0, EpicScaffold_1.epicsRoot)(workspaceRoot, doc), epicId);
+      const stateFile = path17.join(epicDir, "state.json");
+      const state = readEpicState(epicDir, epicId);
+      const previous = RunStateStore_1.RunStateStore.load(workspaceRoot, epicId);
+      const lock = epicWorkflowLock2(previous);
+      if (lock) {
+        throw new EpicWorkflowSwitchError2(`Epic "${epicId}" has already started, so its workflow can't be changed: ${lock}.`);
+      }
+      let removedPipelineFile = null;
+      if (!plan.owned && plan.previousOwnedPipelineId) {
+        const file = (0, EpicPipelineStore_1.epicPipelinePath)(workspaceRoot, doc, epicId);
+        if (fs14.existsSync(file)) {
+          fs14.rmSync(file);
+          removedPipelineFile = file;
+        }
+      }
+      state.pipeline = plan.pipeline.id;
+      state.agent = null;
+      fs14.writeFileSync(stateFile, JSON.stringify(state, null, 2) + "\n", "utf8");
+      const context = previous?.context ?? readInputs2(epicDir);
+      const runState = (0, PipelineRunner_1.startRun)({
+        runId: epicId,
+        pipeline: plan.pipeline,
+        context: { ...context, epic: epicId }
+      });
+      RunStateStore_1.RunStateStore.save(workspaceRoot, runState);
+      (0, EpicScaffold_1.mirrorRunStateToEpic)(workspaceRoot, runState, doc);
+      return {
+        epicId,
+        pipelineId: plan.pipeline.id,
+        agents: plan.agents,
+        previousPipelineId: plan.from.kind === "pipeline" ? plan.from.id : null,
+        removedPipelineFile,
+        runState
+      };
+    }
+    function readInputs2(epicDir) {
+      try {
+        const parsed = JSON.parse(fs14.readFileSync(path17.join(epicDir, "inputs.json"), "utf8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+          return {};
+        }
+        const out2 = {};
+        for (const [k, v] of Object.entries(parsed)) {
+          if (typeof v === "string") {
+            out2[k] = v;
+          }
+        }
+        return out2;
+      } catch {
+        return {};
+      }
+    }
+  }
+});
+
 // ../core/dist/runs/EpicStepEdit.js
 var require_EpicStepEdit = __commonJS({
   "../core/dist/runs/EpicStepEdit.js"(exports2) {
@@ -28412,6 +28963,304 @@ var require_WorkspaceLoader = __commonJS({
   }
 });
 
+// ../core/dist/loader/recipeRefs.js
+var require_recipeRefs = __commonJS({
+  "../core/dist/loader/recipeRefs.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.recipesDrawingFrom = recipesDrawingFrom;
+    exports2.dropRecipeStep = dropRecipeStep;
+    exports2.dropRecipesForPipeline = dropRecipesForPipeline;
+    function recipeList(doc) {
+      return Array.isArray(doc.recipes) ? doc.recipes : [];
+    }
+    function stepIds(recipe) {
+      return Array.isArray(recipe.steps) ? recipe.steps.map(String) : [];
+    }
+    function recipesDrawingFrom(doc, pipelineId) {
+      const firstPipelineId = doc.pipelines.length > 0 ? String(doc.pipelines[0].id ?? "") : "";
+      return recipeList(doc).filter((r) => {
+        const from = typeof r.from === "string" && r.from ? r.from : "";
+        return from ? from === pipelineId : firstPipelineId === pipelineId;
+      });
+    }
+    function emptyEdit(recipe) {
+      return { recipeId: String(recipe.id ?? ""), steps: [], gates: [], removed: false };
+    }
+    function dropGate(recipe, stepId) {
+      const gates = recipe.gates;
+      if (!gates || typeof gates !== "object" || Array.isArray(gates)) {
+        return false;
+      }
+      const map2 = gates;
+      if (!(stepId in map2)) {
+        return false;
+      }
+      delete map2[stepId];
+      if (Object.keys(map2).length === 0) {
+        delete recipe.gates;
+      }
+      return true;
+    }
+    function dropRecipeStep(doc, pipelineId, stepId) {
+      const edits = [];
+      const emptied = [];
+      for (const recipe of recipesDrawingFrom(doc, pipelineId)) {
+        const edit = emptyEdit(recipe);
+        const steps = stepIds(recipe);
+        if (steps.includes(stepId)) {
+          const kept = steps.filter((s) => s !== stepId);
+          edit.steps.push(stepId);
+          if (kept.length === 0) {
+            edit.removed = true;
+            emptied.push(recipe);
+          } else {
+            recipe.steps = kept;
+          }
+        }
+        if (dropGate(recipe, stepId)) {
+          edit.gates.push(stepId);
+        }
+        if (edit.steps.length > 0 || edit.gates.length > 0) {
+          edits.push(edit);
+        }
+      }
+      if (emptied.length > 0) {
+        doc.recipes = recipeList(doc).filter((r) => !emptied.includes(r));
+      }
+      return edits;
+    }
+    function dropRecipesForPipeline(doc, pipelineId) {
+      const doomed = recipeList(doc).filter((r) => r.from === pipelineId);
+      if (doomed.length === 0) {
+        return [];
+      }
+      doc.recipes = recipeList(doc).filter((r) => !doomed.includes(r));
+      return doomed.map((r) => String(r.id ?? ""));
+    }
+  }
+});
+
+// ../core/dist/loader/renameRefs.js
+var require_renameRefs = __commonJS({
+  "../core/dist/loader/renameRefs.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.renameAgentRefs = renameAgentRefs;
+    exports2.renameSkillRefs = renameSkillRefs;
+    exports2.agentReferences = agentReferences;
+    exports2.skillReferences = skillReferences;
+    exports2.unusedAfterStepRemoval = unusedAfterStepRemoval;
+    var recipeRefs_1 = require_recipeRefs();
+    function list(value) {
+      return Array.isArray(value) ? value : [];
+    }
+    function strings(value) {
+      return Array.isArray(value) ? value.map(String) : null;
+    }
+    function dagIdOf(step) {
+      return typeof step.name === "string" && step.name.trim() ? step.name : String(step.agent ?? "");
+    }
+    function renameSkillOn(obj, oldId, newId) {
+      let moved = false;
+      const arr = strings(obj.skills);
+      if (arr && arr.includes(oldId)) {
+        obj.skills = arr.map((s) => s === oldId ? newId : s);
+        moved = true;
+      }
+      if (typeof obj.skill === "string" && obj.skill === oldId) {
+        obj.skill = newId;
+        moved = true;
+      }
+      return moved;
+    }
+    function declaredSkills(obj) {
+      return strings(obj.skills) ?? (typeof obj.skill === "string" ? [obj.skill] : []);
+    }
+    function renameAgentRefs(doc, oldId, newId) {
+      const edit = { paths: [], renamedStepIds: [] };
+      if (!oldId || !newId || oldId === newId) {
+        return edit;
+      }
+      for (const pipeline of list(doc.pipelines)) {
+        const pipelineId = String(pipeline.id ?? "");
+        const steps = pipeline.steps;
+        if (!Array.isArray(steps)) {
+          continue;
+        }
+        let dagIdMoved = false;
+        for (let i = 0; i < steps.length; i++) {
+          const step = steps[i];
+          if (typeof step === "string") {
+            if (step === oldId) {
+              steps[i] = newId;
+              dagIdMoved = true;
+              edit.paths.push(`pipelines.${pipelineId}.steps.${oldId}`);
+            }
+            continue;
+          }
+          if (!step || typeof step !== "object") {
+            continue;
+          }
+          const obj = step;
+          if (obj.agent !== oldId) {
+            continue;
+          }
+          obj.agent = newId;
+          const named = typeof obj.name === "string" && obj.name.trim() !== "";
+          edit.paths.push(`pipelines.${pipelineId}.steps.${named ? String(obj.name) : oldId}.agent`);
+          if (!named) {
+            dagIdMoved = true;
+          }
+        }
+        if (!dagIdMoved) {
+          continue;
+        }
+        edit.renamedStepIds.push(oldId);
+        for (const step of steps) {
+          if (!step || typeof step !== "object") {
+            continue;
+          }
+          const obj = step;
+          const deps = strings(obj.depends_on);
+          if (!deps || !deps.includes(oldId)) {
+            continue;
+          }
+          obj.depends_on = deps.map((d) => d === oldId ? newId : d);
+          edit.paths.push(`pipelines.${pipelineId}.steps.${dagIdOf(obj)}.depends_on`);
+        }
+        for (const recipe of (0, recipeRefs_1.recipesDrawingFrom)(doc, pipelineId)) {
+          const recipeId = String(recipe.id ?? "");
+          const recipeSteps = strings(recipe.steps);
+          if (recipeSteps && recipeSteps.includes(oldId)) {
+            recipe.steps = recipeSteps.map((s) => s === oldId ? newId : s);
+            edit.paths.push(`recipes.${recipeId}.steps`);
+          }
+          const gates = recipe.gates;
+          if (gates && typeof gates === "object" && !Array.isArray(gates)) {
+            const map2 = gates;
+            if (oldId in map2) {
+              map2[newId] = map2[oldId];
+              delete map2[oldId];
+              edit.paths.push(`recipes.${recipeId}.gates.${oldId}`);
+            }
+          }
+        }
+      }
+      for (const cmd of list(doc.slash_commands)) {
+        if (cmd.agent === oldId) {
+          cmd.agent = newId;
+          edit.paths.push(`slash_commands.${String(cmd.name ?? "")}.agent`);
+        }
+      }
+      return edit;
+    }
+    function renameSkillRefs(doc, oldId, newId) {
+      const edit = { paths: [], renamedStepIds: [] };
+      if (!oldId || !newId || oldId === newId) {
+        return edit;
+      }
+      for (const agent of list(doc.agents)) {
+        if (renameSkillOn(agent, oldId, newId)) {
+          edit.paths.push(`agents.${String(agent.id ?? "")}.skills`);
+        }
+      }
+      for (const pipeline of list(doc.pipelines)) {
+        const pipelineId = String(pipeline.id ?? "");
+        for (const step of Array.isArray(pipeline.steps) ? pipeline.steps : []) {
+          if (!step || typeof step !== "object") {
+            continue;
+          }
+          const obj = step;
+          if (!renameSkillOn(obj, oldId, newId)) {
+            continue;
+          }
+          edit.paths.push(`pipelines.${pipelineId}.steps.${dagIdOf(obj)}.skills`);
+        }
+      }
+      return edit;
+    }
+    function agentReferences(doc, id) {
+      const out2 = { paths: [], messages: [] };
+      if (!id) {
+        return out2;
+      }
+      for (const pipeline of list(doc.pipelines)) {
+        const pipelineId = String(pipeline.id ?? "");
+        for (const step of Array.isArray(pipeline.steps) ? pipeline.steps : []) {
+          const isObj = Boolean(step) && typeof step === "object";
+          const agent = typeof step === "string" ? step : step?.agent;
+          if (agent !== id) {
+            continue;
+          }
+          const name = isObj ? dagIdOf(step) : id;
+          out2.paths.push(`pipelines.${pipelineId}.steps.${name}`);
+          out2.messages.push(`Pipeline "${pipelineId}" step "${name}" still runs agent "${id}".`);
+        }
+      }
+      for (const cmd of list(doc.slash_commands)) {
+        if (cmd.agent !== id) {
+          continue;
+        }
+        const name = String(cmd.name ?? "");
+        out2.paths.push(`slash_commands.${name}.agent`);
+        out2.messages.push(`Slash command "${name}" still targets agent "${id}".`);
+      }
+      return out2;
+    }
+    function skillReferences(doc, id) {
+      const out2 = { paths: [], messages: [] };
+      if (!id) {
+        return out2;
+      }
+      for (const agent of list(doc.agents)) {
+        const declared = declaredSkills(agent);
+        if (!declared.includes(id)) {
+          continue;
+        }
+        const agentId = String(agent.id ?? "");
+        out2.paths.push(`agents.${agentId}.skills`);
+        out2.messages.push(declared.length === 1 ? `Agent "${agentId}" declares "${id}" as its only skill \u2014 it needs another before this one goes.` : `Agent "${agentId}" declares skill "${id}".`);
+      }
+      for (const pipeline of list(doc.pipelines)) {
+        const pipelineId = String(pipeline.id ?? "");
+        for (const step of Array.isArray(pipeline.steps) ? pipeline.steps : []) {
+          if (!step || typeof step !== "object") {
+            continue;
+          }
+          const obj = step;
+          if (!declaredSkills(obj).includes(id)) {
+            continue;
+          }
+          out2.paths.push(`pipelines.${pipelineId}.steps.${dagIdOf(obj)}.skills`);
+          out2.messages.push(`Pipeline "${pipelineId}" step "${dagIdOf(obj)}" narrows to skill "${id}".`);
+        }
+      }
+      return out2;
+    }
+    function unusedAfterStepRemoval(doc, agentId) {
+      const none = { agent: null, slashCommands: [], skills: [] };
+      if (!agentId) {
+        return none;
+      }
+      for (const pipeline of list(doc.pipelines)) {
+        for (const step of Array.isArray(pipeline.steps) ? pipeline.steps : []) {
+          const agent2 = typeof step === "string" ? step : step?.agent;
+          if (agent2 === agentId) {
+            return none;
+          }
+        }
+      }
+      const agent = list(doc.agents).find((a) => a.id === agentId);
+      return {
+        agent: agentId,
+        slashCommands: list(doc.slash_commands).filter((c) => c.agent === agentId).map((c) => String(c.name ?? "")),
+        skills: agent ? declaredSkills(agent) : []
+      };
+    }
+  }
+});
+
 // ../core/dist/loader/projectInstructions.js
 var require_projectInstructions = __commonJS({
   "../core/dist/loader/projectInstructions.js"(exports2) {
@@ -29441,6 +30290,7 @@ var require_execEngine = __commonJS({
     var AutoReviewer_1 = require_AutoReviewer();
     var EpicArtifactCommit_1 = require_EpicArtifactCommit();
     var EpicScaffold_1 = require_EpicScaffold();
+    var runProgress_1 = require_runProgress();
     var budget_1 = require_budget();
     var pricing_1 = require_pricing();
     var models_1 = require_models();
@@ -29505,9 +30355,34 @@ var require_execEngine = __commonJS({
           return { kind: "awaiting_review" };
         }
         if (step.status === "rejected") {
+          const skippable = (0, runProgress_1.isStepOptional)(initialPipeline, state.currentStepIdx) || initialPipeline.on_failure === "continue";
+          const openElsewhere = state.steps.findIndex((s, i) => i !== state.currentStepIdx && (0, runProgress_1.isActiveStatus)(s.status));
+          if (skippable && openElsewhere >= 0) {
+            hooks.onStepSkipped?.({
+              stepIdx: state.currentStepIdx,
+              agent: step.agent,
+              reason: step.rejectReason ?? step.autoReviewVerdict?.reason ?? "rejected",
+              nextStepIdx: openElsewhere,
+              runId
+            });
+            RunStateStore_1.RunStateStore.save(root, { ...state, currentStepIdx: openElsewhere });
+            continue;
+          }
           hooks.onRejected?.({ agent: step.agent, runId });
           return { kind: "rejected" };
         }
+        if (step.status === "approved") {
+          const openElsewhere = state.steps.findIndex((s) => (0, runProgress_1.isActiveStatus)(s.status));
+          if (openElsewhere >= 0) {
+            RunStateStore_1.RunStateStore.save(root, { ...state, currentStepIdx: openElsewhere });
+            continue;
+          }
+          const parked = state.steps.find((s) => s.status === "rejected");
+          if (parked) {
+            hooks.onRejected?.({ agent: parked.agent, runId });
+            return { kind: "rejected" };
+          }
+        }
         if (step.status !== "awaiting_work") {
           hooks.onRunFailed?.(`Unexpected step status "${step.status}" \u2014 cannot exec.`);
           return { kind: "error" };
@@ -31352,6 +32227,7 @@ var require_commandModel = __commonJS({
     var strictMode_1 = require_strictMode();
     var commandBodyFreshness_1 = require_commandBodyFreshness();
     var WorkspaceSchema_1 = require_WorkspaceSchema();
+    var runProgress_1 = require_runProgress();
     exports2.CANONICAL_PHASES = [
       { id: "plan", name: "Plan", description: "Scaffold the epic and write the PRD.", artifact: "PRD.md" },
       { id: "prototype", name: "Prototype", description: "Propose the UI visually with multiple design options.", artifact: "PROTOTYPE.md" },
@@ -31418,14 +32294,14 @@ var require_commandModel = __commonJS({
       };
       const statusByDagId = /* @__PURE__ */ new Map();
       state.steps.forEach((s, idx) => statusByDagId.set(dagId(idx), s.status));
-      for (let i = 0; i < state.steps.length; i++) {
-        const st = state.steps[i].status;
-        if (st === "awaiting_work") {
-          return { index: i, phaseId: dagId(i), reason: "awaiting_work" };
-        }
-        if (st === "rejected") {
-          return { index: i, phaseId: dagId(i), reason: "rejected" };
-        }
+      const open = state.steps.findIndex((s) => s.status === "awaiting_work");
+      if (open >= 0) {
+        return { index: open, phaseId: dagId(open), reason: "awaiting_work" };
+      }
+      const optional = (i) => (0, runProgress_1.isStepOptional)(pipeline, i);
+      const blocked = state.steps.findIndex((s, i) => s.status === "rejected" && !optional(i));
+      if (blocked >= 0) {
+        return { index: blocked, phaseId: dagId(blocked), reason: "rejected" };
       }
       for (let i = 0; i < state.steps.length; i++) {
         if (state.steps[i].status !== "pending") {
@@ -31438,6 +32314,10 @@ var require_commandModel = __commonJS({
           return { index: i, phaseId: dagId(i), reason: "unblocked" };
         }
       }
+      const skipped = state.steps.findIndex((s, i) => s.status === "rejected" && optional(i));
+      if (skipped >= 0) {
+        return { index: skipped, phaseId: dagId(skipped), reason: "rejected" };
+      }
       return null;
     }
     function unprovisionedPhases(config, canonical = exports2.CANONICAL_PHASE_IDS) {
@@ -31477,10 +32357,12 @@ The first token is the **epic id**; an optional second token is the **phase**.
 - **If a phase was given**, use it. Validate it is a step in the epic's
   pipeline (see step 3). If it isn't, tell the user which phases the pipeline
   *does* have and stop.
-- **If no phase was given**, pick the **next eligible phase**: the first step
-  that is \`awaiting_work\`, else the first \`rejected\` step, else the first
-  \`pending\` step whose every \`depends_on\` is \`approved\`. If none is
-  actionable (all approved or paused for review), say so and stop.
+- **If no phase was given**, pick the **next eligible phase**, checking each
+  rule against every step before moving to the next rule: any step that is
+  \`awaiting_work\`, else any \`rejected\` step *not* marked \`optional: true\`,
+  else the first \`pending\` step whose every \`depends_on\` is \`approved\`, else
+  a \`rejected\` \`optional\` step. If none is actionable (all approved or
+  paused for review), say so and stop.
 
 ## 3. Resolve composition from the pipeline (never from the command name)
 
@@ -32066,12 +32948,12 @@ var require_dist = __commonJS({
   "../core/dist/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.parseFollowUps = exports2.FollowUpsParseError = exports2.FollowUpManifestSchema = exports2.FollowUpItemSchema = exports2.SIGNAL_FILE = exports2.FOLLOW_UP_ARTIFACT = exports2.readEpicSignal = exports2.existingEpicIds = exports2.followUpIdFor = exports2.followUpEpicId = exports2.renderIntentMarkdown = exports2.openFollowUpEpic = exports2.openIncidentEpic = exports2.SignalParseError = exports2.isSignal = exports2.parseSignal = exports2.SignalSchema = exports2.EpicStepEditError = exports2.resolveStepRef = exports2.describeGateEffect = exports2.commitEpicStepEdit = exports2.planSetEpicStepGates = exports2.planRemoveEpicStep = exports2.planAddEpicStep = exports2.EpicScaffoldError = exports2.epicsRoot = exports2.mapStepStatusToEpic = exports2.mirrorRunStateToEpic = exports2.scaffoldEpic = exports2.resolveArtifactCommitConfig = exports2.commitApprovedArtifacts = exports2.PipelineAdaptError = exports2.applyAdaptation = exports2.parseAdaptationVerdict = exports2.buildAdaptationPrompt = exports2.buildPhaseCatalog = exports2.slugEpicId = exports2.parseClassificationVerdict = exports2.buildClassificationPrompt = exports2.heuristicClassify = exports2.PipelineAssembleError = exports2.recipePipelineId = exports2.assemblePipeline = exports2.collectWorkspaceRefIssues = exports2.stepDagId = exports2.stepAgentId = exports2.normalizeStep = exports2.WorkspaceValidationError = exports2.validateWorkspace = exports2.WorkspaceSchema = void 0;
-    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.WORKSPACE_DIR = exports2.WORKSPACE_FILENAME = exports2.WorkspaceParseError = exports2.WorkspaceNotFoundError = exports2.WorkspaceLoader = exports2.renderPlanMarkdown = exports2.generatePlan = exports2.collectContext = exports2.followUpHookFailures = exports2.pendingFollowUpDone = exports2.applyFollowUpHookRun = exports2.trackFollowUpChildren = exports2.writeFollowUpHookLedger = exports2.readFollowUpHookLedger = exports2.followUpHookLedgerPath = exports2.runFollowUpHook = exports2.fillFollowUpHookCommand = exports2.resolveFollowUpHooks = exports2.epicPipelineId = exports2.FOLLOW_UP_HOOK_TIMEOUT_MS = exports2.FOLLOW_UP_HOOKS_LEDGER = exports2.stepProducesFollowUps = exports2.collectFollowUpHookIssues = exports2.FOLLOW_UP_HOOK_PLACEHOLDERS = exports2.FOLLOW_UP_HOOK_KEYS = exports2.FOLLOW_UP_INTENT = exports2.FOLLOW_UPS_FILE = exports2.openManifestFollowUp = exports2.followUpChildId = exports2.followUpsOf = exports2.readEpicFollowUps = void 0;
-    exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.CodexRunner = 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.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.writeUserEpicIdPrefix = exports2.userConfigPath = 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 = void 0;
-    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.runExecLoop = exports2.estimateCostUsd = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.checkBudget = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = 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 = void 0;
-    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.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = 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 = 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 = 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 = void 0;
+    exports2.followUpEpicId = exports2.renderIntentMarkdown = exports2.openFollowUpEpic = exports2.openIncidentEpic = exports2.SignalParseError = exports2.isSignal = exports2.parseSignal = exports2.SignalSchema = exports2.EpicStepEditError = exports2.resolveStepRef = exports2.describeGateEffect = exports2.commitEpicStepEdit = exports2.planSetEpicStepGates = exports2.planRemoveEpicStep = exports2.planAddEpicStep = exports2.EpicWorkflowSwitchError = exports2.canSwitchEpicWorkflow = exports2.epicWorkflowLock = exports2.applyEpicWorkflowSwitch = exports2.stageEpicWorkflowSwitch = exports2.planEpicWorkflowSwitch = exports2.EpicDescriptionError = exports2.setEpicDescription = exports2.lockedEpicDirError = exports2.EpicScaffoldError = exports2.epicsRoot = exports2.mapStepStatusToEpic = exports2.mirrorRunStateToEpic = exports2.scaffoldEpic = exports2.resolveArtifactCommitConfig = exports2.commitApprovedArtifacts = exports2.PipelineAdaptError = exports2.applyAdaptation = exports2.parseAdaptationVerdict = exports2.buildAdaptationPrompt = exports2.buildPhaseCatalog = exports2.slugEpicId = exports2.parseClassificationVerdict = exports2.buildClassificationPrompt = exports2.heuristicClassify = exports2.PipelineAssembleError = exports2.recipePipelineId = exports2.assemblePipeline = exports2.collectWorkspaceRefIssues = exports2.stepDagId = exports2.stepAgentId = exports2.normalizeStep = exports2.WorkspaceValidationError = exports2.validateWorkspace = exports2.WorkspaceSchema = void 0;
+    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 = exports2.generatePlan = exports2.collectContext = exports2.followUpHookFailures = exports2.pendingFollowUpDone = exports2.applyFollowUpHookRun = exports2.trackFollowUpChildren = exports2.writeFollowUpHookLedger = exports2.readFollowUpHookLedger = exports2.followUpHookLedgerPath = exports2.runFollowUpHook = exports2.fillFollowUpHookCommand = exports2.resolveFollowUpHooks = exports2.epicPipelineId = exports2.FOLLOW_UP_HOOK_TIMEOUT_MS = exports2.FOLLOW_UP_HOOKS_LEDGER = exports2.stepProducesFollowUps = exports2.collectFollowUpHookIssues = exports2.FOLLOW_UP_HOOK_PLACEHOLDERS = exports2.FOLLOW_UP_HOOK_KEYS = exports2.FOLLOW_UP_INTENT = exports2.FOLLOW_UPS_FILE = exports2.openManifestFollowUp = exports2.followUpChildId = exports2.followUpsOf = exports2.readEpicFollowUps = exports2.parseFollowUps = exports2.FollowUpsParseError = exports2.FollowUpManifestSchema = exports2.FollowUpItemSchema = exports2.SIGNAL_FILE = exports2.FOLLOW_UP_ARTIFACT = exports2.readEpicSignal = exports2.existingEpicIds = exports2.followUpIdFor = void 0;
+    exports2.commandBodyIsStale = exports2.readEpicTags = exports2.normalizeTags = exports2.normalizeTag = exports2.epicMatchesTags = exports2.applyTagEdit = exports2.MAX_TAG_LENGTH = exports2.EPIC_TAGS_KEY = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.writeUserEpicIdPrefix = exports2.userConfigPath = 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 = void 0;
+    exports2.runExecLoop = exports2.estimateCostUsd = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.checkBudget = exports2.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = 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.CodexRunner = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = void 0;
+    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.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = 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 = 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 = 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 = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -32156,6 +33038,35 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "EpicScaffoldError", { enumerable: true, get: function() {
       return EpicScaffold_1.EpicScaffoldError;
     } });
+    Object.defineProperty(exports2, "lockedEpicDirError", { enumerable: true, get: function() {
+      return EpicScaffold_1.lockedEpicDirError;
+    } });
+    var EpicDescription_1 = require_EpicDescription();
+    Object.defineProperty(exports2, "setEpicDescription", { enumerable: true, get: function() {
+      return EpicDescription_1.setEpicDescription;
+    } });
+    Object.defineProperty(exports2, "EpicDescriptionError", { enumerable: true, get: function() {
+      return EpicDescription_1.EpicDescriptionError;
+    } });
+    var EpicWorkflowSwitch_1 = require_EpicWorkflowSwitch();
+    Object.defineProperty(exports2, "planEpicWorkflowSwitch", { enumerable: true, get: function() {
+      return EpicWorkflowSwitch_1.planEpicWorkflowSwitch;
+    } });
+    Object.defineProperty(exports2, "stageEpicWorkflowSwitch", { enumerable: true, get: function() {
+      return EpicWorkflowSwitch_1.stageEpicWorkflowSwitch;
+    } });
+    Object.defineProperty(exports2, "applyEpicWorkflowSwitch", { enumerable: true, get: function() {
+      return EpicWorkflowSwitch_1.applyEpicWorkflowSwitch;
+    } });
+    Object.defineProperty(exports2, "epicWorkflowLock", { enumerable: true, get: function() {
+      return EpicWorkflowSwitch_1.epicWorkflowLock;
+    } });
+    Object.defineProperty(exports2, "canSwitchEpicWorkflow", { enumerable: true, get: function() {
+      return EpicWorkflowSwitch_1.canSwitchEpicWorkflow;
+    } });
+    Object.defineProperty(exports2, "EpicWorkflowSwitchError", { enumerable: true, get: function() {
+      return EpicWorkflowSwitch_1.EpicWorkflowSwitchError;
+    } });
     var EpicStepEdit_1 = require_EpicStepEdit();
     Object.defineProperty(exports2, "planAddEpicStep", { enumerable: true, get: function() {
       return EpicStepEdit_1.planAddEpicStep;
@@ -32330,6 +33241,32 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "WORKSPACE_DIR", { enumerable: true, get: function() {
       return WorkspaceLoader_1.WORKSPACE_DIR;
     } });
+    var recipeRefs_1 = require_recipeRefs();
+    Object.defineProperty(exports2, "recipesDrawingFrom", { enumerable: true, get: function() {
+      return recipeRefs_1.recipesDrawingFrom;
+    } });
+    Object.defineProperty(exports2, "dropRecipeStep", { enumerable: true, get: function() {
+      return recipeRefs_1.dropRecipeStep;
+    } });
+    Object.defineProperty(exports2, "dropRecipesForPipeline", { enumerable: true, get: function() {
+      return recipeRefs_1.dropRecipesForPipeline;
+    } });
+    var renameRefs_1 = require_renameRefs();
+    Object.defineProperty(exports2, "renameAgentRefs", { enumerable: true, get: function() {
+      return renameRefs_1.renameAgentRefs;
+    } });
+    Object.defineProperty(exports2, "renameSkillRefs", { enumerable: true, get: function() {
+      return renameRefs_1.renameSkillRefs;
+    } });
+    Object.defineProperty(exports2, "agentReferences", { enumerable: true, get: function() {
+      return renameRefs_1.agentReferences;
+    } });
+    Object.defineProperty(exports2, "skillReferences", { enumerable: true, get: function() {
+      return renameRefs_1.skillReferences;
+    } });
+    Object.defineProperty(exports2, "unusedAfterStepRemoval", { enumerable: true, get: function() {
+      return renameRefs_1.unusedAfterStepRemoval;
+    } });
     var EpicPipelineStore_1 = require_EpicPipelineStore();
     Object.defineProperty(exports2, "EPIC_PIPELINE_FILENAME", { enumerable: true, get: function() {
       return EpicPipelineStore_1.EPIC_PIPELINE_FILENAME;
@@ -32628,6 +33565,19 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "PipelineRunError", { enumerable: true, get: function() {
       return PipelineRunner_1.PipelineRunError;
     } });
+    var runProgress_1 = require_runProgress();
+    Object.defineProperty(exports2, "deriveRunProgress", { enumerable: true, get: function() {
+      return runProgress_1.deriveRunProgress;
+    } });
+    Object.defineProperty(exports2, "isRunComplete", { enumerable: true, get: function() {
+      return runProgress_1.isRunComplete;
+    } });
+    Object.defineProperty(exports2, "isStepOptional", { enumerable: true, get: function() {
+      return runProgress_1.isStepOptional;
+    } });
+    Object.defineProperty(exports2, "isActiveStatus", { enumerable: true, get: function() {
+      return runProgress_1.isActiveStatus;
+    } });
     var budget_1 = require_budget();
     Object.defineProperty(exports2, "checkBudget", { enumerable: true, get: function() {
       return budget_1.checkBudget;
@@ -41630,7 +42580,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.9",
+      version: "4.0.11",
       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: {
@@ -46447,9 +47397,10 @@ function registerRun(program3) {
   cmd.command("reject <runId>").description("Reject the current awaiting_review step").requiredOption("--reason <text>", "Why the step was rejected").action((runId, opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     const state = requireRun(root, runId);
+    const pipeline = requirePipelineForRun(root, state);
     let next;
     try {
-      next = (0, import_core13.rejectStep)({ state, reason: opts.reason });
+      next = (0, import_core13.rejectStep)({ state, reason: opts.reason, pipeline });
     } catch (err) {
       console.error(import_chalk10.default.red(err instanceof Error ? err.message : String(err)));
       process.exit(1);
@@ -46460,18 +47411,23 @@ function registerRun(program3) {
     console.log(import_chalk10.default.dim(`  Reason: ${opts.reason}`));
     console.log(import_chalk10.default.dim(`  Rerun:  aidlc run rerun ${runId} [--feedback "..."]`));
   });
-  cmd.command("rerun <runId>").description("Retry the current rejected step (bumps revision, resets to awaiting_work)").option("--feedback <text>", "Notes for the next attempt (stored on the step)").action((runId, opts, actionCmd) => {
+  cmd.command("rerun <runId>").description("Retry a rejected step (bumps revision, resets to awaiting_work)").option("--feedback <text>", "Notes for the next attempt (stored on the step)").option("--step <idx>", "0-based step index (default: the run's current step)").action((runId, opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     const state = requireRun(root, runId);
+    const stepIdx = opts.step === void 0 ? void 0 : Number(opts.step);
+    if (stepIdx !== void 0 && !Number.isInteger(stepIdx)) {
+      console.error(import_chalk10.default.red(`--step must be an integer, got "${opts.step}"`));
+      process.exit(1);
+    }
     let next;
     try {
-      next = (0, import_core13.rerunStep)({ state, feedback: opts.feedback });
+      next = (0, import_core13.rerunStep)({ state, feedback: opts.feedback, stepIdx });
     } catch (err) {
       console.error(import_chalk10.default.red(err instanceof Error ? err.message : String(err)));
       process.exit(1);
     }
     saveRunState(root, next, state);
-    const step = next.steps[next.currentStepIdx];
+    const step = next.steps[stepIdx ?? next.currentStepIdx];
     console.log(import_chalk10.default.yellow("\u21BA") + ` Rerunning "${step.agent}" (rev ${step.revision})`);
     if (opts.feedback) {
       console.log(import_chalk10.default.dim(`  Feedback: ${opts.feedback}`));
@@ -46729,6 +47685,11 @@ ${reason}`)),
 \u2718  Step "${e.agent}" was rejected.`));
       info(import_chalk10.default.dim(`  Rerun: aidlc run rerun ${e.runId} [--feedback "..."]`));
     },
+    onStepSkipped: (e) => {
+      info(import_chalk10.default.yellow(`
+\u2933  Step "${e.agent}" 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}`));
+    },
     onAutoReviewStart: (e) => info(import_chalk10.default.bold(`
 \u{1F50D}  Auto-review: "${e.agent}"`)),
     onAutoReviewResult: (e) => {
@@ -48337,6 +49298,121 @@ Run ${import_chalk15.default.cyan(`${runCmd} ${epicId}`)} in Claude to begin.`);
       console.log(import_chalk15.default.dim(`  was: ${before.join(" ")}`));
     }
   });
+  cmd.command("describe <id> [text...]").description("Show or set an epic's description. Bare `describe <id>` prints it.").option("--clear", "empty the description").option("--json", "Output the result as JSON").action((id, text, opts, actionCmd) => {
+    const root = resolveWorkspaceRoot(actionCmd);
+    const doc = readYaml(root);
+    const dir = path12.join((0, import_core19.epicsRoot)(root, doc), id);
+    const file = path12.join(dir, "state.json");
+    if (!fs10.existsSync(file)) {
+      const all = listEpics(root, doc).map((e) => e.id);
+      console.error(import_chalk15.default.red(`Epic "${id}" not found.`));
+      if (all.length > 0) {
+        console.error(import_chalk15.default.dim(`Available: ${all.join(", ")}`));
+      }
+      process.exit(1);
+    }
+    const words = text.join(" ").trim();
+    if (!opts.clear && words === "") {
+      let current = "";
+      try {
+        const state = JSON.parse(fs10.readFileSync(file, "utf8"));
+        current = typeof state.description === "string" ? state.description : "";
+      } catch (err) {
+        console.error(import_chalk15.default.red(`Could not read ${file}: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+      }
+      if (opts.json) {
+        console.log(JSON.stringify({ id, description: current }, null, 2));
+        return;
+      }
+      console.log(current ? current : import_chalk15.default.dim("(no description)"));
+      return;
+    }
+    try {
+      const edit = (0, import_core19.setEpicDescription)(dir, id, opts.clear ? "" : words);
+      if (opts.json) {
+        console.log(JSON.stringify(edit, null, 2));
+        return;
+      }
+      console.log(import_chalk15.default.green("\u2714") + ` ${import_chalk15.default.bold(id)}: ` + (edit.description ? edit.description : import_chalk15.default.dim("(no description)")));
+      if (edit.previous) {
+        console.log(import_chalk15.default.dim(`  was: ${edit.previous}`));
+      }
+      console.log(import_chalk15.default.dim(`  ${id}.md: ${edit.doc === "kept" ? "left as it is \u2014 written by hand since, and agents read it" : edit.doc === "created" ? "created" : edit.doc}`));
+    } catch (err) {
+      console.error(import_chalk15.default.red(err instanceof import_core19.EpicDescriptionError ? err.message : String(err)));
+      process.exit(1);
+    }
+  });
+  cmd.command("workflow <id>").description("Show or change the workflow an epic runs. Only before its first step moves.").option("--recipe <recipeId>", "rebuild the epic's own pipeline from this recipe").option("--pipeline <pipelineId>", "point the epic at a pipeline that already exists").option("--json", "Output the result as JSON").action((id, opts, actionCmd) => {
+    const root = resolveWorkspaceRoot(actionCmd);
+    const doc = requireYaml(root);
+    const stateFile = path12.join((0, import_core19.epicsRoot)(root, doc), id, "state.json");
+    if (!fs10.existsSync(stateFile)) {
+      const all = listEpics(root, doc).map((e) => e.id);
+      console.error(import_chalk15.default.red(`Epic "${id}" not found.`));
+      if (all.length > 0) {
+        console.error(import_chalk15.default.dim(`Available: ${all.join(", ")}`));
+      }
+      process.exit(1);
+    }
+    if (opts.recipe && opts.pipeline) {
+      console.error(import_chalk15.default.red("Pass --recipe or --pipeline, not both."));
+      process.exit(1);
+    }
+    const lock = (0, import_core19.epicWorkflowLock)(import_core19.RunStateStore.load(root, id));
+    if (!opts.recipe && !opts.pipeline) {
+      const state = JSON.parse(fs10.readFileSync(stateFile, "utf8"));
+      const current = typeof state.pipeline === "string" && state.pipeline ? { kind: "pipeline", id: state.pipeline } : typeof state.agent === "string" && state.agent ? { kind: "agent", id: state.agent } : { kind: "none", id: null };
+      const recipes = Array.isArray(doc.recipes) ? doc.recipes.map((r) => String(r.id ?? "")) : [];
+      if (opts.json) {
+        console.log(JSON.stringify({ id, current, canChange: lock === null, lock, recipes }, null, 2));
+        return;
+      }
+      console.log(`${import_chalk15.default.bold(id)} runs ${current.id ? import_chalk15.default.cyan(`${current.kind} ${current.id}`) : import_chalk15.default.dim("(nothing)")}`);
+      if (lock) {
+        console.log(import_chalk15.default.dim(`  locked: ${lock} \u2014 use \`aidlc epic step add/remove\` instead`));
+      } else {
+        console.log(import_chalk15.default.dim("  not started yet, so the workflow can still be changed:"));
+        console.log(import_chalk15.default.dim(`    aidlc epic workflow ${id} --recipe <${recipes.join("|") || "recipe"}>`));
+      }
+      return;
+    }
+    let config;
+    try {
+      config = (0, import_core19.validateWorkspace)(doc, ".aidlc/workspace.yaml");
+    } catch (err) {
+      console.error(import_chalk15.default.red("workspace.yaml is invalid \u2014 not changing anything:"));
+      console.error(import_chalk15.default.dim(err instanceof Error ? err.message : String(err)));
+      process.exit(1);
+    }
+    const target = opts.recipe ? { kind: "recipe", id: opts.recipe } : { kind: "pipeline", id: opts.pipeline };
+    try {
+      const plan = (0, import_core19.planEpicWorkflowSwitch)({ workspaceRoot: root, doc, config, epicId: id, target });
+      (0, import_core19.stageEpicWorkflowSwitch)(doc, plan);
+      (0, import_core19.validateWorkspace)(doc, ".aidlc/workspace.yaml");
+      writeYaml(root, doc);
+      const result = (0, import_core19.applyEpicWorkflowSwitch)(root, doc, plan);
+      if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+      console.log(import_chalk15.default.green("\u2714") + ` ${import_chalk15.default.bold(id)} now runs ${import_chalk15.default.cyan(result.pipelineId)}` + (target.kind === "recipe" ? import_chalk15.default.dim(` (from recipe ${target.id})`) : ""));
+      console.log(import_chalk15.default.dim(`  steps: ${result.agents.join(" \u2192 ")}`));
+      if (result.previousPipelineId && result.previousPipelineId !== result.pipelineId) {
+        console.log(import_chalk15.default.dim(`  was: ${result.previousPipelineId}`));
+      }
+      if (result.removedPipelineFile) {
+        console.log(import_chalk15.default.dim(`  removed ${path12.relative(root, result.removedPipelineFile)} \u2014 the shared pipeline takes over`));
+      }
+    } catch (err) {
+      if (err instanceof import_core19.EpicWorkflowSwitchError || err instanceof import_core19.PipelineAssembleError) {
+        console.error(import_chalk15.default.red(err.message));
+        process.exit(1);
+      }
+      throw err;
+    }
+  });
   const pipelineCmd = cmd.command("pipeline").description("Move epic-owned pipelines out of the shared workspace.yaml");
   pipelineCmd.command("extract").description(
     "Move each epic's pipeline out of .aidlc/workspace.yaml into\n  <state.root>/<epic>/pipeline.yaml. Only pipelines an epic names in its\n  own state.json move; shared and hand-authored ones stay put."