@delete101020/aidlc 4.0.26 → 4.0.28

package/dist/assets/epic-context.skill.md

@@ -1,6 +1,6 @@
 ---
 name: epic-context
-description: Load and maintain an epic's compact memory so continuing it (with any agent) is cheap on tokens. Reads docs/epics/<epic>/epic-memory.json FIRST as primary context, appends durable decisions/constraints as you work, and records a reflection on how to prompt/work better next time. Invoke /epic-context <epic> when starting or continuing an epic.
+description: Load and maintain an epic's compact memory so continuing it (with any agent) is cheap on tokens. Reads docs/epics/<epic>/epic-memory.json FIRST as primary context, appends durable decisions/constraints as you work, and records a reflection on how to prompt/work better next time. Invoke /epic-context <epic> when starting or continuing an epic (no id = the active epic from .aidlc/user.yaml).
 ---
 
 # /epic-context — cheap, portable epic memory
@@ -20,9 +20,16 @@ Each write is auto-attributed (git identity, hostname fallback) + timestamped.
 
 ## Arguments
 
-`/epic-context <epic>` — e.g. `/epic-context EPIC-001`. Paths are relative to the
+`/epic-context [epic]` — e.g. `/epic-context EPIC-001`. Paths are relative to the
 open project: `EPIC_DIR = docs/epics/<epic>`.
 
+No id given → use the **active epic**: the `active_epic:` line of
+`.aidlc/user.yaml` (set from the VS Code status bar / Go to Epic, or with
+`aidlc epic use <id>`). Read it with
+`grep -m1 '^active_epic:' .aidlc/user.yaml | sed 's/^active_epic:[[:space:]]*//'`.
+Say which epic you picked in one line. If there is no active epic either, ask
+for the id — don't guess from the epics folder.
+
 ## On start (continuing an epic)
 
 1. **Load memory first**: `$M show "$EPIC_DIR"`.

package/dist/bundle.js

@@ -19806,7 +19806,7 @@ var require_WorkspaceSchema = __commonJS({
         // invalidate every workspace.yaml already on disk and buy nothing
         // (MULTI_PROVIDER_ALIGNMENT.md P0/D1). A closed enum is what lets
         // `aidlc validate` reject a typo instead of failing at spawn time.
-        runner: zod_1.z.enum(["default", "custom", "codex", "gemini"]).default("default"),
+        runner: zod_1.z.enum(["default", "custom", "codex", "gemini", "copilot"]).default("default"),
         /** Required when runner === 'custom'. Relative path to .js or .ts file. */
         runner_path: zod_1.z.string().optional(),
         /** Per-agent env overrides (layered over workspace.environment). */
@@ -19981,6 +19981,13 @@ var require_WorkspaceSchema = __commonJS({
        * pipelines, which are their own source.
        */
       derived_from: zod_1.z.string().min(1).optional(),
+      /**
+       * Set by {@link assemblePipeline} to the recipe that picked the steps. A
+       * creation-time label only — `steps` stays the source of truth, and a hand
+       * edit may leave the two apart. Needed because two recipes can select the
+       * same steps, so the recipe cannot be recovered from the step list.
+       */
+      recipe: zod_1.z.string().min(1).optional(),
       steps: zod_1.z.array(PipelineStepSchema).min(1),
       on_failure: zod_1.z.enum(["stop", "continue"]).default("stop"),
       budget: PipelineBudgetSchema.optional()
@@ -20361,6 +20368,7 @@ var require_PipelineAssembler = __commonJS({
     exports2.PipelineAssembleError = void 0;
     exports2.assemblePipeline = assemblePipeline4;
     exports2.recipePipelineId = recipePipelineId4;
+    exports2.pipelineRecipeLabel = pipelineRecipeLabel;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var PipelineAssembleError4 = class extends Error {
       constructor(message) {
@@ -20448,6 +20456,7 @@ var require_PipelineAssembler = __commonJS({
       const assembled = {
         id: opts.pipelineId ?? recipe.id,
         derived_from: source.id,
+        recipe: recipe.id,
         steps,
         on_failure: source.on_failure
       };
@@ -20478,6 +20487,20 @@ var require_PipelineAssembler = __commonJS({
         }
       }
     }
+    function pipelineRecipeLabel(pipeline, recipes) {
+      if (typeof pipeline.recipe !== "string" || !pipeline.recipe) {
+        return void 0;
+      }
+      const id = pipeline.recipe;
+      const recipe = recipes?.find((r) => r.id === id);
+      if (!recipe || !Array.isArray(recipe.steps) || !Array.isArray(pipeline.steps)) {
+        return { id, modified: false };
+      }
+      const own = pipeline.steps.map((s) => (0, WorkspaceSchema_1.stepDagId)(s));
+      const listed = recipe.steps.map(String);
+      const modified = own.length !== listed.length || own.some((s, i) => s !== listed[i]);
+      return { id, modified };
+    }
     function resolveSource(config, recipe) {
       if (recipe.from) {
         const found = config.pipelines.find((p) => p.id === recipe.from);
@@ -25980,7 +26003,7 @@ var require_EpicArtifactCommit = __commonJS({
         if (!fs14.existsSync(p) || !fs14.statSync(p).isFile()) {
           continue;
         }
-        const rel = path17.relative(repoRoot, p).split(path17.sep).join("/");
+        const rel = path17.relative(repoRoot, fs14.realpathSync(p)).split(path17.sep).join("/");
         if (rel.startsWith("../")) {
           continue;
         }
@@ -27210,6 +27233,10 @@ var require_FollowUps = __commonJS({
       if (!source) {
         return typeof own.id === "string" && own.id ? { kind: "pipeline", id: own.id } : void 0;
       }
+      const labelled = typeof own.recipe === "string" ? own.recipe : "";
+      if (labelled && recipes.some((r) => r.id === labelled)) {
+        return { kind: "recipe", id: labelled };
+      }
       const steps = stepIds(own.steps).join("\n");
       const recipe = recipes.find((r) => (r.from === void 0 || r.from === source) && stepIds(r.steps).join("\n") === steps);
       if (recipe && typeof recipe.id === "string") {
@@ -28887,6 +28914,170 @@ ${task}
   }
 });
 
+// ../core/dist/runner/CopilotRunner.js
+var require_CopilotRunner = __commonJS({
+  "../core/dist/runner/CopilotRunner.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.CopilotRunner = void 0;
+    exports2.copilotGraphServer = copilotGraphServer;
+    exports2.copilotMcpConfig = copilotMcpConfig;
+    var child_process_1 = require("child_process");
+    var CodexRunner_1 = require_CodexRunner();
+    var claudeHome_1 = require_claudeHome();
+    var mcp_1 = require_mcp();
+    var ndjson_1 = require_ndjson();
+    var models_1 = require_models();
+    var resolveCommand_1 = require_resolveCommand();
+    var GRAPH_SERVERS2 = ["ast-graph", "codegraph"];
+    var CopilotRunner2 = class {
+      opts;
+      /**
+       * `projectInstructions` is `false` although Copilot reads a root `CLAUDE.md`
+       * and `AGENTS.md` by itself: it does not read `.claude/CLAUDE.md`, and the
+       * composer cannot know which layout a repo uses. Inlining costs a duplicate
+       * when the file is at the root; not inlining would cost the conventions when
+       * it is not. `CLAUDE.md` is preferred over `AGENTS.md` because a repo that
+       * keeps both usually has tool-generated boilerplate in the latter.
+       *
+       * `astGraph` is `true` because the runner attaches the server on every run
+       * that has one registered; `doctor` reports the workspaces that do not.
+       */
+      capabilities = {
+        persona: false,
+        projectInstructions: false,
+        astGraph: true,
+        instructionFile: "CLAUDE.md"
+      };
+      constructor(opts = {}) {
+        this.opts = opts;
+      }
+      async run(ctx) {
+        const bin = this.opts.copilotBin ?? "copilot";
+        const model = (0, models_1.resolveProviderModel)("copilot", ctx.model, ctx.modelAliases);
+        const graph = (this.opts.graphServer ?? copilotGraphServer)(ctx.workspaceRoot);
+        const args = [
+          // Required for non-interactive runs: without it every tool call waits for
+          // a confirmation nobody is there to give.
+          "--allow-all-tools",
+          "--output-format",
+          "json",
+          "--no-color",
+          ...this.opts.keepBuiltinMcps ? [] : ["--disable-builtin-mcps"],
+          ...graph ? ["--additional-mcp-config", copilotMcpConfig(graph)] : [],
+          ...model ? ["--model", model] : [],
+          ...this.opts.extraArgs ?? []
+        ];
+        const cmd = (0, resolveCommand_1.resolveCommand)(bin);
+        const proc = (0, child_process_1.spawn)(cmd.command, [...cmd.args, ...args], {
+          cwd: ctx.workspaceRoot,
+          env: { ...process.env, ...ctx.env },
+          stdio: ["pipe", "pipe", "pipe"]
+        });
+        let streamed = "";
+        let lastMessage = "";
+        const deltaSeen = /* @__PURE__ */ new Set();
+        let premiumRequests;
+        const emit = (text) => {
+          streamed += text;
+          ctx.onOutput(text);
+        };
+        const handle = (evt) => {
+          const d = evt.data ?? {};
+          switch (evt.type) {
+            case "assistant.message_delta":
+              if (d.deltaContent) {
+                if (d.messageId) {
+                  deltaSeen.add(d.messageId);
+                }
+                emit(d.deltaContent);
+              }
+              return;
+            case "assistant.message":
+              if (!d.content) {
+                return;
+              }
+              lastMessage = d.content;
+              if (!d.messageId || !deltaSeen.has(d.messageId)) {
+                emit(d.content);
+              }
+              emit("\n");
+              return;
+            case "tool.execution_start":
+              if (d.toolName) {
+                ctx.onOutput(`[${d.toolTitle ?? d.toolName}]
+`);
+              }
+              return;
+            case "session.mcp_server_status_changed":
+              if (d.status === "failed") {
+                ctx.onError(`MCP server ${d.serverName ?? "?"} failed to start: ${d.error ?? "unknown error"}
+`);
+              }
+              return;
+            case "result":
+              if (typeof evt.usage?.premiumRequests === "number") {
+                premiumRequests = evt.usage.premiumRequests;
+              }
+              return;
+            default:
+              if (evt.type?.endsWith(".error")) {
+                ctx.onError(`${d.message ?? d.error ?? "copilot reported an error"}
+`);
+              }
+          }
+        };
+        const sink = (0, ndjson_1.createJsonSink)(handle, (line) => ctx.onOutput(line + "\n"));
+        proc.stdout.on("data", (d) => sink.push(d.toString("utf8")));
+        proc.stderr.on("data", (d) => ctx.onError(d.toString("utf8")));
+        proc.stdin.on("error", () => {
+        });
+        proc.stdin.end((0, CodexRunner_1.buildPrompt)(ctx));
+        return new Promise((resolve5) => {
+          proc.on("error", (err) => {
+            ctx.onError(`Failed to spawn ${bin}: ${err.message}
+`);
+            resolve5({ success: false, output: "" });
+          });
+          proc.on("close", (code) => {
+            sink.flush();
+            resolve5({
+              success: code === 0,
+              output: lastMessage || streamed,
+              // No costUsd or usage: Copilot bills premium requests, and turning
+              // those into dollars or tokens would be a guess (P0, D5).
+              ...premiumRequests !== void 0 ? { data: { premiumRequests } } : {}
+            });
+          });
+        });
+      }
+    };
+    exports2.CopilotRunner = CopilotRunner2;
+    function copilotGraphServer(workspaceRoot) {
+      for (const name of GRAPH_SERVERS2) {
+        const server = (0, mcp_1.readProjectMcpServer)(workspaceRoot, name, (0, claudeHome_1.claudeJsonPath)());
+        if (server) {
+          return server;
+        }
+      }
+      return null;
+    }
+    function copilotMcpConfig(server) {
+      return JSON.stringify({
+        mcpServers: {
+          [server.name]: {
+            type: "local",
+            command: server.command,
+            args: server.args,
+            ...server.env && Object.keys(server.env).length ? { env: server.env } : {},
+            tools: ["*"]
+          }
+        }
+      });
+    }
+  }
+});
+
 // ../core/dist/runner/types.js
 var require_types = __commonJS({
   "../core/dist/runner/types.js"(exports2) {
@@ -29071,6 +29262,7 @@ var require_RunnerRegistry = __commonJS({
     var path17 = __importStar(require("path"));
     var DefaultRunner_1 = require_DefaultRunner();
     var CodexRunner_1 = require_CodexRunner();
+    var CopilotRunner_1 = require_CopilotRunner();
     var CustomRunnerLoader_1 = require_CustomRunnerLoader();
     var RunnerRegistry = class {
       builtins = /* @__PURE__ */ new Map();
@@ -29080,6 +29272,7 @@ var require_RunnerRegistry = __commonJS({
         this.loader = new CustomRunnerLoader_1.CustomRunnerLoader(workspaceRoot);
         this.register("default", new DefaultRunner_1.DefaultRunner());
         this.register("codex", new CodexRunner_1.CodexRunner());
+        this.register("copilot", new CopilotRunner_1.CopilotRunner());
       }
       /** Add or replace a builtin runner. */
       register(id, runner) {
@@ -30209,8 +30402,9 @@ var require_userConfig = __commonJS({
     exports2.userConfigPath = userConfigPath;
     exports2.readUserConfig = readUserConfig3;
     exports2.writeUserEpicIdPrefix = writeUserEpicIdPrefix;
+    exports2.updateUserConfig = updateUserConfig;
     exports2.readGitUserName = readGitUserName2;
-    exports2.ensureUserConfigIgnored = ensureUserConfigIgnored;
+    exports2.ensureUserConfigIgnored = ensureUserConfigIgnored2;
     var child_process_1 = require("child_process");
     var fs_1 = __importDefault(require("fs"));
     var path_1 = __importDefault(require("path"));
@@ -30236,15 +30430,22 @@ var require_userConfig = __commonJS({
       "# Settings for this checkout only \u2014 NOT committed (see .gitignore).",
       "# epic_id_prefix is your own two letters, so the epics you open are filed",
       "# under you and never collide with a colleague's numbering.",
+      "# active_epic / recent_epics / watched_epics / epic_sort are your own; the",
+      "# extension and `aidlc epic use|watch` keep them, and hand edits are fine.",
       ""
     ].join("\n");
     function writeUserEpicIdPrefix(root, prefix) {
+      updateUserConfig(root, (doc) => {
+        if (prefix) {
+          doc.epic_id_prefix = prefix.toUpperCase();
+        } else {
+          delete doc.epic_id_prefix;
+        }
+      });
+    }
+    function updateUserConfig(root, mutate) {
       const doc = readUserConfig3(root) ?? {};
-      if (prefix) {
-        doc.epic_id_prefix = prefix.toUpperCase();
-      } else {
-        delete doc.epic_id_prefix;
-      }
+      mutate(doc);
       const file = userConfigPath(root);
       fs_1.default.mkdirSync(path_1.default.dirname(file), { recursive: true });
       if (Object.keys(doc).length === 0) {
@@ -30267,7 +30468,7 @@ var require_userConfig = __commonJS({
         return null;
       }
     }
-    function ensureUserConfigIgnored(root) {
+    function ensureUserConfigIgnored2(root) {
       const file = path_1.default.join(root, ".gitignore");
       try {
         const existing = fs_1.default.existsSync(file) ? fs_1.default.readFileSync(file, "utf8") : "";
@@ -30277,7 +30478,7 @@ var require_userConfig = __commonJS({
         }
         const sep4 = existing === "" || existing.endsWith("\n") ? "" : "\n";
         fs_1.default.writeFileSync(file, `${existing}${sep4}
-# Per-checkout AIDLC settings (epic_id_prefix) \u2014 never shared
+# Per-checkout AIDLC settings (epic_id_prefix, active/watched epics) \u2014 never shared
 ${exports2.USER_CONFIG_IGNORE_LINE}
 `, "utf8");
         return true;
@@ -30288,6 +30489,134 @@ ${exports2.USER_CONFIG_IGNORE_LINE}
   }
 });
 
+// ../core/dist/loader/epicFocus.js
+var require_epicFocus = __commonJS({
+  "../core/dist/loader/epicFocus.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.RECENT_EPICS_LIMIT = exports2.EPIC_SORT_KEY = exports2.WATCHED_EPICS_KEY = exports2.RECENT_EPICS_KEY = exports2.ACTIVE_EPIC_KEY = void 0;
+    exports2.epicFocusFrom = epicFocusFrom;
+    exports2.readEpicFocus = readEpicFocus2;
+    exports2.pushRecent = pushRecent;
+    exports2.recordEpicOpened = recordEpicOpened;
+    exports2.setActiveEpic = setActiveEpic2;
+    exports2.setEpicWatched = setEpicWatched2;
+    exports2.epicSortFrom = epicSortFrom;
+    exports2.readEpicSort = readEpicSort;
+    exports2.setEpicSort = setEpicSort;
+    exports2.epicIdFromBranch = epicIdFromBranch;
+    var userConfig_1 = require_userConfig();
+    exports2.ACTIVE_EPIC_KEY = "active_epic";
+    exports2.RECENT_EPICS_KEY = "recent_epics";
+    exports2.WATCHED_EPICS_KEY = "watched_epics";
+    exports2.EPIC_SORT_KEY = "epic_sort";
+    exports2.RECENT_EPICS_LIMIT = 10;
+    function asId(v) {
+      return typeof v === "string" && v.trim() !== "" ? v.trim() : null;
+    }
+    function asIdList(v) {
+      if (!Array.isArray(v)) {
+        return [];
+      }
+      const out2 = [];
+      for (const item of v) {
+        const id = asId(item);
+        if (id && !out2.includes(id)) {
+          out2.push(id);
+        }
+      }
+      return out2;
+    }
+    function epicFocusFrom(doc) {
+      return {
+        active: asId(doc?.[exports2.ACTIVE_EPIC_KEY]),
+        recent: asIdList(doc?.[exports2.RECENT_EPICS_KEY]),
+        watched: asIdList(doc?.[exports2.WATCHED_EPICS_KEY])
+      };
+    }
+    function readEpicFocus2(root) {
+      return epicFocusFrom((0, userConfig_1.readUserConfig)(root));
+    }
+    function pushRecent(list, id, limit = exports2.RECENT_EPICS_LIMIT) {
+      return [id, ...list.filter((x) => x !== id)].slice(0, limit);
+    }
+    function writeList(doc, key, list) {
+      if (list.length > 0) {
+        doc[key] = list;
+      } else {
+        delete doc[key];
+      }
+    }
+    function recordEpicOpened(root, id) {
+      (0, userConfig_1.updateUserConfig)(root, (doc) => {
+        writeList(doc, exports2.RECENT_EPICS_KEY, pushRecent(asIdList(doc[exports2.RECENT_EPICS_KEY]), id));
+      });
+    }
+    function setActiveEpic2(root, id) {
+      (0, userConfig_1.updateUserConfig)(root, (doc) => {
+        if (id) {
+          doc[exports2.ACTIVE_EPIC_KEY] = id;
+          writeList(doc, exports2.RECENT_EPICS_KEY, pushRecent(asIdList(doc[exports2.RECENT_EPICS_KEY]), id));
+        } else {
+          delete doc[exports2.ACTIVE_EPIC_KEY];
+        }
+      });
+    }
+    function setEpicWatched2(root, id, watched) {
+      (0, userConfig_1.updateUserConfig)(root, (doc) => {
+        const list = asIdList(doc[exports2.WATCHED_EPICS_KEY]);
+        if (watched === list.includes(id)) {
+          return;
+        }
+        writeList(doc, exports2.WATCHED_EPICS_KEY, watched ? [...list, id] : list.filter((x) => x !== id));
+      });
+    }
+    function epicSortFrom(doc) {
+      const v = doc?.[exports2.EPIC_SORT_KEY];
+      if (!v || typeof v !== "object" || Array.isArray(v)) {
+        return null;
+      }
+      const by = asId(v.by);
+      return by ? { by, reversed: v.reversed === true } : null;
+    }
+    function readEpicSort(root) {
+      return epicSortFrom((0, userConfig_1.readUserConfig)(root));
+    }
+    function setEpicSort(root, pref) {
+      (0, userConfig_1.updateUserConfig)(root, (doc) => {
+        doc[exports2.EPIC_SORT_KEY] = pref.reversed ? { by: pref.by, reversed: true } : { by: pref.by };
+      });
+    }
+    function epicIdFromBranch(branch, knownIds) {
+      if (!branch) {
+        return null;
+      }
+      const hay = branch.toLowerCase();
+      let best = null;
+      for (const id of knownIds) {
+        const needle = id.toLowerCase();
+        let from = 0;
+        for (; ; ) {
+          const at = hay.indexOf(needle, from);
+          if (at < 0) {
+            break;
+          }
+          const before = at === 0 ? "" : hay[at - 1];
+          const after = hay[at + needle.length] ?? "";
+          if (!/[a-z0-9]/.test(before) && !/[0-9]/.test(after)) {
+            if (!best || id.length > best.length) {
+              best = id;
+            }
+            break;
+          }
+          from = at + 1;
+        }
+      }
+      return best;
+    }
+  }
+});
+
 // ../core/dist/presets/commandBodyFreshness.js
 var require_commandBodyFreshness = __commonJS({
   "../core/dist/presets/commandBodyFreshness.js"(exports2) {
@@ -30642,6 +30971,98 @@ var require_budget = __commonJS({
   }
 });
 
+// ../core/dist/runs/producesSnapshot.js
+var require_producesSnapshot = __commonJS({
+  "../core/dist/runs/producesSnapshot.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.snapshotProduces = snapshotProduces;
+    exports2.unchangedProduces = unchangedProduces;
+    var crypto_1 = require("crypto");
+    var fs14 = __importStar(require("fs"));
+    var path17 = __importStar(require("path"));
+    var WorkspaceSchema_1 = require_WorkspaceSchema();
+    var RunState_1 = require_RunState();
+    function snapshotProduces(args) {
+      const snap = /* @__PURE__ */ new Map();
+      const stepCfg = args.pipeline.steps[args.stepIdx];
+      if (!stepCfg) {
+        return snap;
+      }
+      for (const p of (0, WorkspaceSchema_1.normalizeStep)(stepCfg).produces) {
+        const rel = (0, RunState_1.resolvePath)(p, args.state.context);
+        snap.set(rel, fingerprint(absolute(args.workspaceRoot, rel)));
+      }
+      return snap;
+    }
+    function unchangedProduces(before, workspaceRoot) {
+      const stale = [];
+      for (const [rel, prior] of before) {
+        const now = fingerprint(absolute(workspaceRoot, rel));
+        if (now === null) {
+          continue;
+        }
+        if (prior === null || prior !== now) {
+          return [];
+        }
+        stale.push(rel);
+      }
+      return stale;
+    }
+    function absolute(root, rel) {
+      return path17.isAbsolute(rel) ? rel : path17.join(root, rel);
+    }
+    function fingerprint(abs) {
+      try {
+        const st = fs14.statSync(abs);
+        if (!st.isFile()) {
+          return `dir:${st.mtimeMs}`;
+        }
+        return (0, crypto_1.createHash)("sha1").update(fs14.readFileSync(abs)).digest("hex");
+      } catch {
+        return null;
+      }
+    }
+  }
+});
+
 // ../core/dist/runs/pricing.js
 var require_pricing = __commonJS({
   "../core/dist/runs/pricing.js"(exports2) {
@@ -30866,6 +31287,7 @@ var require_execEngine = __commonJS({
     var EpicScaffold_1 = require_EpicScaffold();
     var runProgress_1 = require_runProgress();
     var budget_1 = require_budget();
+    var producesSnapshot_1 = require_producesSnapshot();
     var pricing_1 = require_pricing();
     var models_1 = require_models();
     var WorkspaceSchema_1 = require_WorkspaceSchema();
@@ -31091,6 +31513,7 @@ var require_execEngine = __commonJS({
       });
       const aliases = (0, pricing_1.providerAliases)(ws.config.providers, agent.runner);
       const resolvedModel = (0, models_1.resolveProviderModel)(agent.runner, agent.model, aliases);
+      const producedBefore = (0, producesSnapshot_1.snapshotProduces)({ state, pipeline, workspaceRoot: root, stepIdx });
       const result = await runner.run({
         skill: skillText,
         env,
@@ -31106,6 +31529,15 @@ var require_execEngine = __commonJS({
         hooks.onStepFailed?.({ stepIdx, agent: agentId, message: `Step "${agentId}" failed (non-zero exit).` });
         return false;
       }
+      const stale = (0, producesSnapshot_1.unchangedProduces)(producedBefore, root);
+      if (stale.length > 0) {
+        hooks.onStepFailed?.({
+          stepIdx,
+          agent: agentId,
+          message: `Step "${agentId}" reported success but left its artifacts unchanged: ${stale.join(", ")}. The agent may have failed to write them. Check its output, then rerun the step.`
+        });
+        return false;
+      }
       let next;
       let freshState;
       try {
@@ -33534,13 +33966,13 @@ var require_dist = __commonJS({
   "../core/dist/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    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.resolveStepSkills = exports2.stepSkillAlternatives = exports2.stepDagId = exports2.stepAgentId = exports2.producesEntries = exports2.normalizeStep = exports2.WorkspaceValidationError = exports2.validateWorkspace = exports2.WorkspaceSchema = void 0;
-    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.MANUAL_FOLLOW_UP_KEY_PREFIX = exports2.followUpDefaults = exports2.nextManualFollowUpKey = exports2.withFollowUpProvenance = 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 = exports2.followUpEpicId = exports2.renderIntentMarkdown = exports2.openFollowUpEpic = void 0;
-    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 = exports2.epicPipelinePath = exports2.EPIC_PIPELINE_FILENAME = exports2.unusedAfterStepRemoval = exports2.skillReferences = exports2.agentReferences = exports2.renameSkillRefs = exports2.renameAgentRefs = void 0;
-    exports2.dirtyUpstreamOf = exports2.rerunApprovedStep = exports2.canRerunApprovedStep = exports2.chooseStepSkill = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = exports2.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = exports2.startRun = exports2.activateBackendFromWorkspace = exports2.activateRunStateBackend = exports2.resolveRunStateBackend = exports2.GitRunStateStore = exports2.RUN_ID_PATTERN = exports2.FileRunStateStore = exports2.RunStateStore = exports2.harnessCapabilities = exports2.NO_HARNESS_CAPABILITIES = exports2.RunnerValidationError = exports2.validateRunnerExport = exports2.CustomRunnerLoader = exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.CodexRunner = exports2.claudeModelArg = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = exports2.commandBodyIsStale = exports2.readEpicTags = exports2.normalizeTags = exports2.normalizeTag = exports2.epicMatchesTags = exports2.applyTagEdit = exports2.MAX_TAG_LENGTH = void 0;
-    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 = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.checkBudget = exports2.weighStepProgress = exports2.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = void 0;
-    exports2.setClaudeConfigDir = exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = exports2.backboneCommandDoc = exports2.unprovisionedPhases = exports2.nextEligiblePhase = exports2.resolveComposition = exports2.shortcutCommandId = exports2.getCanonicalPhase = exports2.isCanonicalPhase = exports2.BACKBONE_COMMAND_ID = exports2.CANONICAL_PHASE_IDS = exports2.CANONICAL_PHASES = exports2.renderTemplate = exports2.DEFAULT_GLOBAL_WORKFLOW_IDS = exports2.detectGlobalBuiltinSource = exports2.uninstallWorkflowGlobalsByIds = exports2.isWorkflowGloballyInstalled = exports2.installWorkflowGlobalsByIds = exports2.installGlobalDefaults = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = exports2.FAST_MODEL = exports2.CODING_MODEL = void 0;
-    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = void 0;
+    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.pipelineRecipeLabel = exports2.recipePipelineId = exports2.assemblePipeline = exports2.collectWorkspaceRefIssues = exports2.resolveStepSkills = exports2.stepSkillAlternatives = exports2.stepDagId = exports2.stepAgentId = exports2.producesEntries = exports2.normalizeStep = exports2.WorkspaceValidationError = exports2.validateWorkspace = exports2.WorkspaceSchema = void 0;
+    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.MANUAL_FOLLOW_UP_KEY_PREFIX = exports2.followUpDefaults = exports2.nextManualFollowUpKey = exports2.withFollowUpProvenance = 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 = exports2.followUpEpicId = exports2.renderIntentMarkdown = exports2.openFollowUpEpic = exports2.openIncidentEpic = void 0;
+    exports2.WATCHED_EPICS_KEY = exports2.RECENT_EPICS_LIMIT = exports2.RECENT_EPICS_KEY = exports2.EPIC_SORT_KEY = exports2.ACTIVE_EPIC_KEY = exports2.writeUserEpicIdPrefix = exports2.userConfigPath = exports2.updateUserConfig = exports2.readUserConfig = exports2.readGitUserName = exports2.ensureUserConfigIgnored = exports2.USER_CONFIG_RELPATH = exports2.USER_CONFIG_IGNORE_LINE = exports2.suggestEpicId = exports2.resolveEpicIdPrefixChain = exports2.resolveEpicIdPrefix = exports2.epicIdDateStamp = exports2.deriveEpicIdPrefix = exports2.EPIC_ID_PREFIX_PATTERN = exports2.EPIC_ID_PREFIX_KEY = exports2.resolveArtifactLanguage = exports2.commandBodyPredatesArtifactLanguage = exports2.artifactLanguageSection = exports2.ARTIFACT_LANGUAGE_HEADING = exports2.stripPersonaDirectives = exports2.composeAgentPrompt = exports2.PROJECT_INSTRUCTION_FILES = exports2.findProjectInstructions = exports2.stripPersonaMetadata = exports2.PersonaLoader = exports2.SkillNotFoundError = exports2.SkillLoader = exports2.EnvVarMissingError = exports2.EnvResolver = exports2.epicPipelineReport = exports2.planEpicPipelineExtraction = exports2.epicOwningPipeline = exports2.unstageEpicPipeline = exports2.stageEpicPipeline = exports2.writeEpicPipelines = exports2.splitEpicPipelines = exports2.mergeEpicPipelines = exports2.epicPipelinePath = exports2.EPIC_PIPELINE_FILENAME = exports2.unusedAfterStepRemoval = exports2.skillReferences = exports2.agentReferences = exports2.renameSkillRefs = exports2.renameAgentRefs = exports2.dropRecipesForPipeline = void 0;
+    exports2.harnessCapabilities = exports2.NO_HARNESS_CAPABILITIES = exports2.RunnerValidationError = exports2.validateRunnerExport = exports2.CustomRunnerLoader = exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.copilotMcpConfig = exports2.copilotGraphServer = exports2.CopilotRunner = exports2.CodexRunner = exports2.claudeModelArg = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = exports2.commandBodyIsStale = exports2.readEpicTags = exports2.normalizeTags = exports2.normalizeTag = exports2.epicMatchesTags = exports2.applyTagEdit = exports2.MAX_TAG_LENGTH = exports2.EPIC_TAGS_KEY = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.setEpicWatched = exports2.setEpicSort = exports2.setActiveEpic = exports2.recordEpicOpened = exports2.readEpicSort = exports2.readEpicFocus = exports2.pushRecent = exports2.epicSortFrom = exports2.epicIdFromBranch = exports2.epicFocusFrom = void 0;
+    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.unchangedProduces = exports2.snapshotProduces = exports2.checkBudget = exports2.weighStepProgress = exports2.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = exports2.dirtyUpstreamOf = exports2.rerunApprovedStep = exports2.canRerunApprovedStep = exports2.chooseStepSkill = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = exports2.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = exports2.startRun = exports2.activateBackendFromWorkspace = exports2.activateRunStateBackend = exports2.resolveRunStateBackend = exports2.GitRunStateStore = exports2.RUN_ID_PATTERN = exports2.FileRunStateStore = exports2.RunStateStore = void 0;
+    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 = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = 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 = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -33579,6 +34011,9 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "recipePipelineId", { enumerable: true, get: function() {
       return PipelineAssembler_1.recipePipelineId;
     } });
+    Object.defineProperty(exports2, "pipelineRecipeLabel", { enumerable: true, get: function() {
+      return PipelineAssembler_1.pipelineRecipeLabel;
+    } });
     Object.defineProperty(exports2, "PipelineAssembleError", { enumerable: true, get: function() {
       return PipelineAssembler_1.PipelineAssembleError;
     } });
@@ -33992,12 +34427,61 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "readUserConfig", { enumerable: true, get: function() {
       return userConfig_1.readUserConfig;
     } });
+    Object.defineProperty(exports2, "updateUserConfig", { enumerable: true, get: function() {
+      return userConfig_1.updateUserConfig;
+    } });
     Object.defineProperty(exports2, "userConfigPath", { enumerable: true, get: function() {
       return userConfig_1.userConfigPath;
     } });
     Object.defineProperty(exports2, "writeUserEpicIdPrefix", { enumerable: true, get: function() {
       return userConfig_1.writeUserEpicIdPrefix;
     } });
+    var epicFocus_1 = require_epicFocus();
+    Object.defineProperty(exports2, "ACTIVE_EPIC_KEY", { enumerable: true, get: function() {
+      return epicFocus_1.ACTIVE_EPIC_KEY;
+    } });
+    Object.defineProperty(exports2, "EPIC_SORT_KEY", { enumerable: true, get: function() {
+      return epicFocus_1.EPIC_SORT_KEY;
+    } });
+    Object.defineProperty(exports2, "RECENT_EPICS_KEY", { enumerable: true, get: function() {
+      return epicFocus_1.RECENT_EPICS_KEY;
+    } });
+    Object.defineProperty(exports2, "RECENT_EPICS_LIMIT", { enumerable: true, get: function() {
+      return epicFocus_1.RECENT_EPICS_LIMIT;
+    } });
+    Object.defineProperty(exports2, "WATCHED_EPICS_KEY", { enumerable: true, get: function() {
+      return epicFocus_1.WATCHED_EPICS_KEY;
+    } });
+    Object.defineProperty(exports2, "epicFocusFrom", { enumerable: true, get: function() {
+      return epicFocus_1.epicFocusFrom;
+    } });
+    Object.defineProperty(exports2, "epicIdFromBranch", { enumerable: true, get: function() {
+      return epicFocus_1.epicIdFromBranch;
+    } });
+    Object.defineProperty(exports2, "epicSortFrom", { enumerable: true, get: function() {
+      return epicFocus_1.epicSortFrom;
+    } });
+    Object.defineProperty(exports2, "pushRecent", { enumerable: true, get: function() {
+      return epicFocus_1.pushRecent;
+    } });
+    Object.defineProperty(exports2, "readEpicFocus", { enumerable: true, get: function() {
+      return epicFocus_1.readEpicFocus;
+    } });
+    Object.defineProperty(exports2, "readEpicSort", { enumerable: true, get: function() {
+      return epicFocus_1.readEpicSort;
+    } });
+    Object.defineProperty(exports2, "recordEpicOpened", { enumerable: true, get: function() {
+      return epicFocus_1.recordEpicOpened;
+    } });
+    Object.defineProperty(exports2, "setActiveEpic", { enumerable: true, get: function() {
+      return epicFocus_1.setActiveEpic;
+    } });
+    Object.defineProperty(exports2, "setEpicSort", { enumerable: true, get: function() {
+      return epicFocus_1.setEpicSort;
+    } });
+    Object.defineProperty(exports2, "setEpicWatched", { enumerable: true, get: function() {
+      return epicFocus_1.setEpicWatched;
+    } });
     var strictMode_1 = require_strictMode();
     Object.defineProperty(exports2, "STRICT_MODE_HEADING", { enumerable: true, get: function() {
       return strictMode_1.STRICT_MODE_HEADING;
@@ -34068,6 +34552,16 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "CodexRunner", { enumerable: true, get: function() {
       return CodexRunner_1.CodexRunner;
     } });
+    var CopilotRunner_1 = require_CopilotRunner();
+    Object.defineProperty(exports2, "CopilotRunner", { enumerable: true, get: function() {
+      return CopilotRunner_1.CopilotRunner;
+    } });
+    Object.defineProperty(exports2, "copilotGraphServer", { enumerable: true, get: function() {
+      return CopilotRunner_1.copilotGraphServer;
+    } });
+    Object.defineProperty(exports2, "copilotMcpConfig", { enumerable: true, get: function() {
+      return CopilotRunner_1.copilotMcpConfig;
+    } });
     var mcp_1 = require_mcp();
     Object.defineProperty(exports2, "claudeMcpRegistrar", { enumerable: true, get: function() {
       return mcp_1.claudeMcpRegistrar;
@@ -34214,6 +34708,13 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "checkBudget", { enumerable: true, get: function() {
       return budget_1.checkBudget;
     } });
+    var producesSnapshot_1 = require_producesSnapshot();
+    Object.defineProperty(exports2, "snapshotProduces", { enumerable: true, get: function() {
+      return producesSnapshot_1.snapshotProduces;
+    } });
+    Object.defineProperty(exports2, "unchangedProduces", { enumerable: true, get: function() {
+      return producesSnapshot_1.unchangedProduces;
+    } });
     var pricing_1 = require_pricing();
     Object.defineProperty(exports2, "BUILTIN_RATES", { enumerable: true, get: function() {
       return pricing_1.BUILTIN_RATES;
@@ -43212,7 +43713,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.26",
+      version: "4.0.28",
       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: {
@@ -46344,6 +46845,9 @@ function parityChecks(root, ws) {
     if (runner === "codex") {
       return new import_core5.CodexRunner().capabilities;
     }
+    if (runner === "copilot") {
+      return new import_core5.CopilotRunner().capabilities;
+    }
     return import_core5.NO_HARNESS_CAPABILITIES;
   };
   const runners = [...new Set(ws.config.agents.map((a) => a.runner))];
@@ -46393,6 +46897,12 @@ function parityChecks(root, ws) {
         `${engine} via codex`,
         'not in ~/.codex/config.toml \u2014 run "aidlc mcp register --runner codex"'
       ));
+    } else if (runner === "copilot") {
+      const server = (0, import_core5.readProjectMcpServer)(root, engine, (0, import_core5.claudeJsonPath)());
+      checks.push(server ? ok(`${engine} via copilot`, "attached to each run from this project's Claude registration") : warn(
+        `${engine} via copilot`,
+        'no project registration to attach \u2014 run "AIDLC: Rescan AST Graph" in VS Code'
+      ));
     } else {
       checks.push(warn(
         `${engine} via ${runner}`,
@@ -50216,6 +50726,67 @@ ${plan.length} pipeline(s) would move. Re-run without --dry-run.`));
     });
     console.log((0, import_core19.suggestEpicId)(existing, prefix));
   });
+  const requireKnownEpic = (root, id) => {
+    const all = listEpics(root, readYaml(root)).map((e) => e.id);
+    const hit = all.find((x) => x.toLowerCase() === id.toLowerCase());
+    if (!hit) {
+      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);
+    }
+    return hit;
+  };
+  const noteIgnored = (root) => {
+    if ((0, import_core19.ensureUserConfigIgnored)(root)) {
+      console.log(import_chalk15.default.dim(`  Added ${import_core19.USER_CONFIG_IGNORE_LINE} to .gitignore \u2014 it is yours, not the team's.`));
+    }
+  };
+  cmd.command("current").description("Print the active epic id (from .aidlc/user.yaml); exits 1 when none is set").option("--json", "Print active, recent and watched as JSON").action((opts, actionCmd) => {
+    const root = resolveWorkspaceRoot(actionCmd);
+    const focus = (0, import_core19.readEpicFocus)(root);
+    if (opts.json) {
+      console.log(JSON.stringify(focus, null, 2));
+      return;
+    }
+    if (!focus.active) {
+      process.exit(1);
+    }
+    console.log(focus.active);
+  });
+  cmd.command("use [id]").description("Make an epic the active one \u2014 what skills like /epic-context pick up when given no id").option("--clear", "unset the active epic").action((id, opts, actionCmd) => {
+    const root = resolveWorkspaceRoot(actionCmd);
+    if (opts.clear) {
+      (0, import_core19.setActiveEpic)(root, null);
+      console.log(import_chalk15.default.green("\u2714") + " No active epic.");
+      return;
+    }
+    if (!id) {
+      console.error(import_chalk15.default.red("Give an epic id, or --clear."));
+      process.exit(1);
+    }
+    const epicId = requireKnownEpic(root, id);
+    (0, import_core19.setActiveEpic)(root, epicId);
+    console.log(import_chalk15.default.green("\u2714") + ` Active epic: ${import_chalk15.default.bold(epicId)}`);
+    noteIgnored(root);
+  });
+  for (const [name, watched] of [["watch", true], ["unwatch", false]]) {
+    cmd.command(`${name} [id]`).description(watched ? "Watch an epic \u2014 listed under My epics in the sidebar; bare `watch` lists them" : "Stop watching an epic").action((id, _opts, actionCmd) => {
+      const root = resolveWorkspaceRoot(actionCmd);
+      if (!id) {
+        const list = (0, import_core19.readEpicFocus)(root).watched;
+        console.log(list.length > 0 ? import_chalk15.default.cyan(list.join(" ")) : import_chalk15.default.dim("(nothing watched)"));
+        return;
+      }
+      const epicId = watched ? requireKnownEpic(root, id) : id;
+      (0, import_core19.setEpicWatched)(root, epicId, watched);
+      console.log(import_chalk15.default.green("\u2714") + ` ${watched ? "Watching" : "Stopped watching"} ${import_chalk15.default.bold(epicId)}`);
+      if (watched) {
+        noteIgnored(root);
+      }
+    });
+  }
   cmd.command("strict <epicId> [value]").description("Show or set an epic's depth of work (strict_mode in its state.json)").action((epicId, value, _opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     const doc = requireYaml(root);

package/package.json

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