@delete101020/aidlc 4.0.10 → 4.0.12

package/dist/bundle.js

@@ -20068,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];
@@ -21000,6 +21018,8 @@ var require_PipelineRunner = __commonJS({
     exports2.startRun = startRun2;
     exports2.canStartStep = canStartStep;
     exports2.markStepDone = markStepDone3;
+    exports2.canUndoStepDone = canUndoStepDone;
+    exports2.undoStepDone = undoStepDone;
     exports2.submitAutoReviewVerdict = submitAutoReviewVerdict2;
     exports2.retryAutoReview = retryAutoReview;
     exports2.approveStep = approveStep3;
@@ -21152,6 +21172,101 @@ var require_PipelineRunner = __commonJS({
       }
       return advance(next, idx, pipeline);
     }
+    var UNDOABLE_STATUSES = ["awaiting_auto_review", "awaiting_review", "approved"];
+    function followersOf(pipeline, idx) {
+      const normalized = pipeline.steps.map(WorkspaceSchema_1.normalizeStep);
+      const usesDag = normalized.some((s) => s.depends_on.length > 0);
+      if (!usesDag) {
+        return idx + 1 < normalized.length ? [idx + 1] : [];
+      }
+      const dagId = normalized[idx] ? normalized[idx].name ?? normalized[idx].agent : void 0;
+      if (dagId === void 0) {
+        return [];
+      }
+      const out2 = [];
+      normalized.forEach((s, i) => {
+        if (s.depends_on.includes(dagId)) {
+          out2.push(i);
+        }
+      });
+      return out2;
+    }
+    function canUndoStepDone(args) {
+      const { state, pipeline } = args;
+      const idx = args.stepIdx ?? state.currentStepIdx;
+      const step = state.steps[idx];
+      if (!step) {
+        return { ok: false, reason: `No step at index ${idx}` };
+      }
+      if (!(0, reconcileRun_1.reconcileRunSteps)(state, pipeline).aligned) {
+        return {
+          ok: false,
+          reason: `Run "${state.runId}" no longer matches pipeline "${pipeline.id}" \u2014 reconcile it before undoing anything.`
+        };
+      }
+      if (!UNDOABLE_STATUSES.includes(step.status)) {
+        return {
+          ok: false,
+          reason: `Step "${(0, RunState_1.stepIdentity)(step)}" is "${step.status}" \u2014 there is no "mark done" to undo.`
+        };
+      }
+      if (step.status === "approved") {
+        for (const i of followersOf(pipeline, idx)) {
+          const follower = state.steps[i];
+          if (!follower || follower.status === "pending") {
+            continue;
+          }
+          const untouched = follower.status === "awaiting_work" && follower.artifactsProduced.length === 0;
+          if (!untouched) {
+            return {
+              ok: false,
+              reason: `Step ${i + 1} ("${(0, RunState_1.stepIdentity)(follower)}") has already moved on (${follower.status}) \u2014 undo would silently discard it. Use "Request update" instead.`
+            };
+          }
+        }
+      }
+      return { ok: true };
+    }
+    function undoStepDone(args) {
+      const { pipeline } = args;
+      const state = alignedOrThrow(args.state, pipeline);
+      const idx = args.stepIdx ?? state.currentStepIdx;
+      const gate = canUndoStepDone({ state, pipeline, stepIdx: idx });
+      if (!gate.ok) {
+        throw new PipelineRunError3(gate.reason);
+      }
+      const step = state.steps[idx];
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const next = clone(state);
+      if (step.status === "approved") {
+        for (const i of followersOf(pipeline, idx)) {
+          const follower = next.steps[i];
+          if (!follower || follower.status !== "awaiting_work") {
+            continue;
+          }
+          next.steps[i] = { ...follower, status: "pending", startedAt: void 0 };
+        }
+      }
+      next.steps[idx] = {
+        ...next.steps[idx],
+        status: "awaiting_work",
+        finishedAt: void 0,
+        artifactsProduced: [],
+        autoReviewVerdict: void 0,
+        // `startedAt` stays: this is the same attempt at the same step, and the
+        // panel dates the artifact against it to tell "written for this step" from
+        // "inherited from an earlier one".
+        history: pushHistory(step.history, {
+          kind: "undo",
+          at: now,
+          revision: step.revision,
+          from: step.status
+        })
+      };
+      next.currentStepIdx = idx;
+      next.status = "running";
+      return next;
+    }
     function submitAutoReviewVerdict2(args) {
       const { pipeline, verdict } = args;
       const state = alignedOrThrow(args.state, pipeline);
@@ -25198,6 +25313,7 @@ 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"));
@@ -25281,6 +25397,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()) {
@@ -25291,12 +25416,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 ?? {})) {
@@ -25547,6 +25681,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) {
@@ -28532,6 +29060,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) {
@@ -30053,6 +30879,8 @@ var require_runReport = __commonJS({
             return `  - \u{1F916} auto-review ${h.decision} (rev ${h.revision}): ${h.reason}`;
           case "approve":
             return `  - \u2714 approved (rev ${h.revision})`;
+          case "undo":
+            return `  - \u21B6 mark-done undone (rev ${h.revision}, was ${h.from})`;
           default:
             return "  - (unknown event)";
         }
@@ -32219,12 +33047,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.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.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 = void 0;
-    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 = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = 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 = 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.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.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = exports2.startRun = exports2.activateBackendFromWorkspace = exports2.activateRunStateBackend = exports2.resolveRunStateBackend = exports2.GitRunStateStore = exports2.RUN_ID_PATTERN = exports2.FileRunStateStore = exports2.RunStateStore = exports2.harnessCapabilities = exports2.NO_HARNESS_CAPABILITIES = exports2.RunnerValidationError = exports2.validateRunnerExport = exports2.CustomRunnerLoader = exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.CodexRunner = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = void 0;
+    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 = exports2.runExecLoop = exports2.estimateCostUsd = 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 = exports2.BACKBONE_COMMAND_ID = exports2.CANONICAL_PHASE_IDS = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -32309,6 +33137,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;
@@ -32483,6 +33340,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;
@@ -32760,6 +33643,12 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "markStepDone", { enumerable: true, get: function() {
       return PipelineRunner_1.markStepDone;
     } });
+    Object.defineProperty(exports2, "canUndoStepDone", { enumerable: true, get: function() {
+      return PipelineRunner_1.canUndoStepDone;
+    } });
+    Object.defineProperty(exports2, "undoStepDone", { enumerable: true, get: function() {
+      return PipelineRunner_1.undoStepDone;
+    } });
     Object.defineProperty(exports2, "approveStep", { enumerable: true, get: function() {
       return PipelineRunner_1.approveStep;
     } });
@@ -41796,7 +42685,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.10",
+      version: "4.0.12",
       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: {
@@ -48514,6 +49403,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."

package/package.json

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