@delete101020/aidlc 4.0.25 → 4.0.27

package/README.md

@@ -299,7 +299,19 @@ aidlc epic start <id> --pipeline <pipelineId>   # or use an existing pipeline as
 aidlc epic start <id> … --tag payment --tag "thanh toán"   # tag it at creation
 aidlc epic tag <id>                             # print this epic's tags
 aidlc epic tag <id> payment "release q3"        # add tags (also --add/--remove/--set/--clear)
-```
+aidlc epic follow-up <parent> --title "…" [--desc "…"]   # park work found mid-epic as <parent>-F<n>
+```
+
+**Follow-ups opened by hand.** Work that turns up while an epic is in flight —
+a CR in build finds a second screen that needs the same change — goes into
+`epic follow-up <parent>`. It scaffolds `<parent>-F1` (then `F2`, …) with
+`from_epic` and `follow_up_key` in its `inputs.json`, so the parent's card links
+to it exactly as it does to manifest and incident follow-ups. The child runs
+the way the parent does (the recipe that assembled the parent's pipeline, else
+the pipeline it was derived from) and inherits its tags; override with
+`--recipe` / `--pipeline`, `--tag`, `--no-inherit-tags`, `--epic <id>`. Nothing
+runs: the child waits at its first step until someone starts it. The
+extension's card offers the same as **New follow-up epic**.
 
 **Tags** are free text in and one canonical form on disk: uppercase, ASCII,
 dash-separated — `"thanh toán VNPay"` is stored as `THANH-TOAN-VNPAY`, and the

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

@@ -27017,14 +27017,18 @@ var require_FollowUps = __commonJS({
       };
     }();
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.FollowUpsParseError = exports2.FollowUpManifestSchema = exports2.FollowUpItemSchema = exports2.FOLLOW_UP_INTENT = exports2.FOLLOW_UPS_FILE = void 0;
+    exports2.MANUAL_FOLLOW_UP_KEY_PREFIX = exports2.FollowUpsParseError = exports2.FollowUpManifestSchema = exports2.FollowUpItemSchema = exports2.FOLLOW_UP_INTENT = exports2.FOLLOW_UPS_FILE = void 0;
     exports2.parseFollowUps = parseFollowUps;
     exports2.readEpicFollowUps = readEpicFollowUps;
     exports2.followUpsOf = followUpsOf;
     exports2.followUpChildId = followUpChildId;
     exports2.openManifestFollowUp = openManifestFollowUp;
+    exports2.withFollowUpProvenance = withFollowUpProvenance2;
+    exports2.nextManualFollowUpKey = nextManualFollowUpKey;
+    exports2.followUpDefaults = followUpDefaults2;
     var fs14 = __importStar(require("fs"));
     var path17 = __importStar(require("path"));
+    var yaml = __importStar(require_js_yaml());
     var zod_1 = require_zod();
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var EpicScaffold_1 = require_EpicScaffold();
@@ -27032,6 +27036,8 @@ var require_FollowUps = __commonJS({
     Object.defineProperty(exports2, "FOLLOW_UPS_FILE", { enumerable: true, get: function() {
       return FollowUpHookSchema_1.FOLLOW_UPS_FILE;
     } });
+    var EpicPipelineStore_1 = require_EpicPipelineStore();
+    var epicTags_1 = require_epicTags();
     exports2.FOLLOW_UP_INTENT = "intent.md";
     var nonEmpty = (field) => zod_1.z.string().trim().min(1, `\`${field}\` is required`);
     exports2.FollowUpItemSchema = zod_1.z.object({
@@ -27158,11 +27164,7 @@ var require_FollowUps = __commonJS({
         target: { kind: "pipeline", id: pipeline.id },
         agents,
         // Provenance last, so a manifest cannot overwrite the edge it is drawn from.
-        inputs: {
-          ...item.inputs,
-          from_epic: parentEpicId,
-          follow_up_key: item.key
-        },
+        inputs: withFollowUpProvenance2(item.inputs, parentEpicId, item.key),
         pipeline,
         seedArtifacts: { [exports2.FOLLOW_UP_INTENT]: item.intent.endsWith("\n") ? item.intent : `${item.intent}
 ` },
@@ -27174,6 +27176,91 @@ var require_FollowUps = __commonJS({
         intentPath: path17.join(result.artifactsDir, exports2.FOLLOW_UP_INTENT)
       };
     }
+    function withFollowUpProvenance2(inputs, parentEpicId, key) {
+      return { ...inputs, from_epic: parentEpicId, follow_up_key: key };
+    }
+    exports2.MANUAL_FOLLOW_UP_KEY_PREFIX = "F";
+    function nextManualFollowUpKey(taken) {
+      const used = new Set([...taken].map((k) => k.toUpperCase()));
+      for (let n = 1; n < 1e4; n++) {
+        const key = `${exports2.MANUAL_FOLLOW_UP_KEY_PREFIX}${n}`;
+        if (!used.has(key)) {
+          return key;
+        }
+      }
+      throw new EpicScaffold_1.EpicScaffoldError("Could not find a free follow-up key.");
+    }
+    function stepIds(steps) {
+      if (!Array.isArray(steps)) {
+        return [];
+      }
+      return steps.map((s) => {
+        if (typeof s === "string") {
+          return s;
+        }
+        const o = s ?? {};
+        return String(o.name ?? o.agent ?? "");
+      });
+    }
+    function parentTarget(own, pipelines, recipes) {
+      if (!own) {
+        return void 0;
+      }
+      const source = typeof own.derived_from === "string" ? own.derived_from : "";
+      if (!source) {
+        return typeof own.id === "string" && own.id ? { kind: "pipeline", id: own.id } : void 0;
+      }
+      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") {
+        return { kind: "recipe", id: recipe.id };
+      }
+      if (pipelines.some((p) => p.id === source)) {
+        return { kind: "pipeline", id: source };
+      }
+      return void 0;
+    }
+    function followUpDefaults2(workspaceRoot, doc, parentEpicId) {
+      const root = (0, EpicScaffold_1.epicsRoot)(workspaceRoot, doc);
+      const dir = path17.join(root, parentEpicId);
+      const stateFile = path17.join(dir, "state.json");
+      if (!fs14.existsSync(stateFile)) {
+        throw new EpicScaffold_1.EpicScaffoldError(`Epic "${parentEpicId}" not found \u2014 no state.json in ${dir}.`);
+      }
+      let state;
+      try {
+        state = JSON.parse(fs14.readFileSync(stateFile, "utf8"));
+      } catch (err) {
+        throw new EpicScaffold_1.EpicScaffoldError(`Epic "${parentEpicId}" has an unreadable state.json: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      const pipelines = Array.isArray(doc?.pipelines) ? doc.pipelines : [];
+      const recipes = Array.isArray(doc?.recipes) ? doc.recipes : [];
+      let own = null;
+      const ownFile = path17.join(dir, EpicPipelineStore_1.EPIC_PIPELINE_FILENAME);
+      if (fs14.existsSync(ownFile)) {
+        try {
+          const parsed = yaml.load(fs14.readFileSync(ownFile, "utf8"));
+          if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            own = parsed;
+          }
+        } catch {
+        }
+      }
+      if (!own && typeof state.pipeline === "string") {
+        own = pipelines.find((p) => p.id === state.pipeline) ?? null;
+      }
+      const key = nextManualFollowUpKey(followUpsOf(workspaceRoot, doc, parentEpicId).map((f) => f.key ?? ""));
+      const taken = fs14.existsSync(root) ? fs14.readdirSync(root) : [];
+      const target = parentTarget(own, pipelines, recipes);
+      return {
+        parentEpicId,
+        parentTitle: typeof state.title === "string" ? state.title : "",
+        key,
+        epicId: followUpChildId(parentEpicId, key, taken),
+        tags: (0, epicTags_1.normalizeTags)(state.tags),
+        ...target ? { target } : {}
+      };
+    }
   }
 });
 
@@ -30122,8 +30209,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"));
@@ -30149,15 +30237,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 / pinned_epics / recent_epics are your own working set; the",
+      "# extension and `aidlc epic use|pin` 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) {
@@ -30180,7 +30275,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") : "";
@@ -30190,7 +30285,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/pinned epics) \u2014 never shared
 ${exports2.USER_CONFIG_IGNORE_LINE}
 `, "utf8");
         return true;
@@ -30201,6 +30296,114 @@ ${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.RECENT_EPICS_KEY = exports2.PINNED_EPICS_KEY = exports2.ACTIVE_EPIC_KEY = void 0;
+    exports2.epicFocusFrom = epicFocusFrom;
+    exports2.readEpicFocus = readEpicFocus2;
+    exports2.pushRecent = pushRecent;
+    exports2.recordEpicOpened = recordEpicOpened;
+    exports2.setActiveEpic = setActiveEpic2;
+    exports2.setEpicPinned = setEpicPinned2;
+    exports2.epicIdFromBranch = epicIdFromBranch;
+    var userConfig_1 = require_userConfig();
+    exports2.ACTIVE_EPIC_KEY = "active_epic";
+    exports2.PINNED_EPICS_KEY = "pinned_epics";
+    exports2.RECENT_EPICS_KEY = "recent_epics";
+    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]),
+        pinned: asIdList(doc?.[exports2.PINNED_EPICS_KEY]),
+        recent: asIdList(doc?.[exports2.RECENT_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 setEpicPinned2(root, id, pinned) {
+      (0, userConfig_1.updateUserConfig)(root, (doc) => {
+        const list = asIdList(doc[exports2.PINNED_EPICS_KEY]).filter((x) => x !== id);
+        if (pinned) {
+          list.push(id);
+        }
+        writeList(doc, exports2.PINNED_EPICS_KEY, list);
+      });
+    }
+    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) {
@@ -33448,12 +33651,12 @@ var require_dist = __commonJS({
     "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.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 = exports2.followUpEpicId = exports2.renderIntentMarkdown = exports2.openFollowUpEpic = void 0;
-    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 = exports2.epicPipelinePath = exports2.EPIC_PIPELINE_FILENAME = exports2.unusedAfterStepRemoval = void 0;
-    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 = 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 = void 0;
-    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 = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.checkBudget = exports2.weighStepProgress = exports2.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = void 0;
-    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 = exports2.CANONICAL_PHASES = exports2.renderTemplate = exports2.DEFAULT_GLOBAL_WORKFLOW_IDS = exports2.detectGlobalBuiltinSource = exports2.uninstallWorkflowGlobalsByIds = exports2.isWorkflowGloballyInstalled = exports2.installWorkflowGlobalsByIds = exports2.installGlobalDefaults = exports2.resolveProviderModel = 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 = 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.epicIdFromBranch = exports2.epicFocusFrom = exports2.RECENT_EPICS_LIMIT = exports2.RECENT_EPICS_KEY = exports2.PINNED_EPICS_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 = void 0;
+    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 = exports2.EPIC_TAGS_KEY = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.setEpicPinned = exports2.setActiveEpic = exports2.recordEpicOpened = exports2.readEpicFocus = exports2.pushRecent = void 0;
+    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 = exports2.dirtyUpstreamOf = exports2.rerunApprovedStep = exports2.canRerunApprovedStep = exports2.chooseStepSkill = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = exports2.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = void 0;
+    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 = 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 = 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 = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -33664,6 +33867,18 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "openManifestFollowUp", { enumerable: true, get: function() {
       return FollowUps_1.openManifestFollowUp;
     } });
+    Object.defineProperty(exports2, "withFollowUpProvenance", { enumerable: true, get: function() {
+      return FollowUps_1.withFollowUpProvenance;
+    } });
+    Object.defineProperty(exports2, "nextManualFollowUpKey", { enumerable: true, get: function() {
+      return FollowUps_1.nextManualFollowUpKey;
+    } });
+    Object.defineProperty(exports2, "followUpDefaults", { enumerable: true, get: function() {
+      return FollowUps_1.followUpDefaults;
+    } });
+    Object.defineProperty(exports2, "MANUAL_FOLLOW_UP_KEY_PREFIX", { enumerable: true, get: function() {
+      return FollowUps_1.MANUAL_FOLLOW_UP_KEY_PREFIX;
+    } });
     Object.defineProperty(exports2, "FOLLOW_UPS_FILE", { enumerable: true, get: function() {
       return FollowUps_1.FOLLOW_UPS_FILE;
     } });
@@ -33893,12 +34108,49 @@ 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, "PINNED_EPICS_KEY", { enumerable: true, get: function() {
+      return epicFocus_1.PINNED_EPICS_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, "epicFocusFrom", { enumerable: true, get: function() {
+      return epicFocus_1.epicFocusFrom;
+    } });
+    Object.defineProperty(exports2, "epicIdFromBranch", { enumerable: true, get: function() {
+      return epicFocus_1.epicIdFromBranch;
+    } });
+    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, "recordEpicOpened", { enumerable: true, get: function() {
+      return epicFocus_1.recordEpicOpened;
+    } });
+    Object.defineProperty(exports2, "setActiveEpic", { enumerable: true, get: function() {
+      return epicFocus_1.setActiveEpic;
+    } });
+    Object.defineProperty(exports2, "setEpicPinned", { enumerable: true, get: function() {
+      return epicFocus_1.setEpicPinned;
+    } });
     var strictMode_1 = require_strictMode();
     Object.defineProperty(exports2, "STRICT_MODE_HEADING", { enumerable: true, get: function() {
       return strictMode_1.STRICT_MODE_HEADING;
@@ -43113,7 +43365,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.25",
+      version: "4.0.27",
       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: {
@@ -49752,22 +50004,14 @@ ${epics.length} epic${epics.length !== 1 ? "s" : ""}`));
       console.error(import_chalk15.default.dim(err instanceof Error ? err.message : String(err)));
       process.exit(1);
     }
-    let pipelineCfg;
-    if (opts.pipeline) {
-      const found = doc.pipelines.find((p) => String(p.id) === opts.pipeline);
-      if (!found) {
-        console.error(import_chalk15.default.red(`Pipeline "${opts.pipeline}" not found in workspace.yaml.`));
-        process.exit(1);
-      }
-      pipelineCfg = found;
-    } else {
+    let recipeId = opts.recipe;
+    if (!opts.pipeline) {
       if (config.recipes.length === 0) {
         console.error(import_chalk15.default.red("No recipes defined \u2014 task-type suggestion needs them."));
         console.error(import_chalk15.default.dim("  Back-fill from your existing pipeline: aidlc recipe init"));
         console.error(import_chalk15.default.dim("  Or apply the preset that ships them:    aidlc preset apply sdlc"));
         process.exit(1);
       }
-      let recipeId = opts.recipe;
       if (!recipeId) {
         const brief = (opts.brief ?? []).join(" ").trim();
         const heur = (0, import_core19.heuristicClassify)(brief, config.recipes);
@@ -49779,34 +50023,12 @@ ${epics.length} epic${epics.length !== 1 ? "s" : ""}`));
         recipeId = verdict.recipeId;
         console.log(import_chalk15.default.dim(`Classified \u2192 ${import_chalk15.default.bold(recipeId)} (${verdict.confidence}, ${verdict.source})`));
       }
-      if (opts.from) {
-        const recipe = config.recipes.find((r) => r.id === recipeId);
-        if (recipe) {
-          recipe.from = opts.from;
-        }
-      }
-      const pipelineId = (0, import_core19.recipePipelineId)({ recipeId, epicId, taken: existingIds(doc.pipelines) });
-      try {
-        pipelineCfg = (0, import_core19.assemblePipeline)(config, { recipeId, pipelineId });
-      } catch (err) {
-        if (err instanceof import_core19.PipelineAssembleError) {
-          console.error(import_chalk15.default.red("Could not assemble pipeline: ") + import_chalk15.default.dim(err.message));
-          process.exit(1);
-        }
-        throw err;
-      }
-      doc.pipelines.push(pipelineCfg);
-      (0, import_core19.stageEpicPipeline)(doc, pipelineCfg.id, epicId);
-      try {
-        (0, import_core19.validateWorkspace)(doc, ".aidlc/workspace.yaml");
-      } catch (err) {
-        console.error(import_chalk15.default.red("Assembled pipeline failed validation \u2014 not written:"));
-        console.error(import_chalk15.default.dim(err instanceof Error ? err.message : String(err)));
-        process.exit(1);
-      }
-      writeYaml(root, doc);
-      console.log(import_chalk15.default.dim(`Assembled pipeline ${import_chalk15.default.bold(pipelineCfg.id)} from recipe ${import_chalk15.default.bold(recipeId)}`));
     }
+    const pipelineCfg = resolveEpicPipeline(root, doc, config, {
+      pipeline: opts.pipeline,
+      recipe: recipeId,
+      from: opts.from
+    }, epicId);
     const agents = Array.isArray(pipelineCfg.steps) ? pipelineCfg.steps.map(import_core19.stepAgentId) : [];
     const inputs = {};
     for (const kv of opts.input) {
@@ -49841,13 +50063,7 @@ ${epics.length} epic${epics.length !== 1 ? "s" : ""}`));
       if (!opts.strict) {
         console.log(import_chalk15.default.dim("  Depth:    strict_mode: false \u2014 phases stay proportional to the work"));
       }
-      const firstStep = Array.isArray(pipelineCfg.steps) ? pipelineCfg.steps[0] : void 0;
-      const firstName = firstStep?.name ?? firstStep?.agent ?? agents[0];
-      const slashCmds = Array.isArray(doc.slash_commands) ? doc.slash_commands : [];
-      const match = slashCmds.find(
-        (c) => typeof c.name === "string" && c.name.endsWith(`-${firstName}`) && c.agent === agents[0]
-      ) ?? slashCmds.find((c) => typeof c.name === "string" && c.name.endsWith(`-${firstName}`));
-      const runCmd = match?.name ?? `/${firstName}`;
+      const runCmd = firstStepCommand(doc, pipelineCfg, agents);
       console.log(`
 Run ${import_chalk15.default.cyan(`${runCmd} ${epicId}`)} in Claude to begin.`);
     } catch (err) {
@@ -49858,6 +50074,87 @@ Run ${import_chalk15.default.cyan(`${runCmd} ${epicId}`)} in Claude to begin.`);
       throw err;
     }
   });
+  cmd.command("follow-up <parentEpic>").description("Open a follow-up epic of <parentEpic> to park work found while doing it \u2014 nothing runs yet").requiredOption("--title <title>", "what the follow-up is").option("--desc <description>", "the note: what turned up, and why it is not part of the parent").option("--recipe <id>", "recipe for the follow-up (default: the one the parent runs on)").option("--pipeline <id>", "use an existing pipeline as-is (default: the parent's workflow)").option("--from <pipelineId>", "override the recipe's source pipeline").option("--epic <id>", "id for the follow-up (default: <parentEpic>-F<n>)").option("--input <kv>", "capability input as key=value (repeatable)", collectKv, []).option("--tag <tag>", "extra tag (repeatable) \u2014 added to the ones inherited from the parent", collectKv, []).option("--no-inherit-tags", "do not copy the parent's tags").option("--no-strict", "work to the size of this epic \u2014 no invented NFR / risk / alternatives sections").option("--json", "output the result as JSON").action((parentEpic, opts, actionCmd) => {
+    const root = resolveWorkspaceRoot(actionCmd);
+    const doc = requireYaml(root);
+    if (opts.recipe && opts.pipeline) {
+      console.error(import_chalk15.default.red("Pick at most one of --recipe <id> or --pipeline <id>."));
+      process.exit(1);
+    }
+    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 fix it before opening a follow-up:"));
+      console.error(import_chalk15.default.dim(err instanceof Error ? err.message : String(err)));
+      process.exit(1);
+    }
+    let defaults;
+    try {
+      defaults = (0, import_core19.followUpDefaults)(root, doc, parentEpic);
+    } catch (err) {
+      console.error(import_chalk15.default.red(err instanceof Error ? err.message : String(err)));
+      process.exit(1);
+    }
+    const epicId = opts.epic?.trim() || defaults.epicId;
+    const target = opts.pipeline ? { pipeline: opts.pipeline } : opts.recipe ? { recipe: opts.recipe } : defaults.target?.kind === "pipeline" ? { pipeline: defaults.target.id } : defaults.target ? { recipe: defaults.target.id } : void 0;
+    if (!target) {
+      console.error(import_chalk15.default.red(`Could not tell which workflow "${parentEpic}" runs on.`));
+      console.error(import_chalk15.default.dim("  Pass one: --recipe <id> or --pipeline <id>"));
+      process.exit(1);
+    }
+    const pipelineCfg = resolveEpicPipeline(root, doc, config, { ...target, from: opts.from, quiet: opts.json }, epicId);
+    const agents = Array.isArray(pipelineCfg.steps) ? pipelineCfg.steps.map(import_core19.stepAgentId) : [];
+    const inputs = {};
+    for (const kv of opts.input) {
+      const eq = kv.indexOf("=");
+      if (eq > 0) {
+        inputs[kv.slice(0, eq).trim()] = kv.slice(eq + 1).trim();
+      }
+    }
+    const tags = (0, import_core19.normalizeTags)([...opts.inheritTags ? defaults.tags : [], ...opts.tag]);
+    try {
+      const { epicDir } = (0, import_core19.scaffoldEpic)({
+        workspaceRoot: root,
+        doc,
+        epicId,
+        title: opts.title.trim(),
+        description: opts.desc?.trim() ?? "",
+        target: { kind: "pipeline", id: pipelineCfg.id },
+        agents,
+        inputs: (0, import_core19.withFollowUpProvenance)(inputs, parentEpic, defaults.key),
+        pipeline: pipelineCfg,
+        strictMode: opts.strict,
+        tags
+      });
+      if (opts.json) {
+        console.log(JSON.stringify({
+          epicId,
+          epicDir,
+          pipeline: pipelineCfg.id,
+          fromEpic: parentEpic,
+          followUpKey: defaults.key,
+          tags
+        }, null, 2));
+        return;
+      }
+      console.log(import_chalk15.default.green("\u2714") + ` Opened follow-up ${import_chalk15.default.bold(epicId)} of ${import_chalk15.default.bold(parentEpic)}`);
+      console.log(import_chalk15.default.dim(`  Pipeline: ${pipelineCfg.id}`));
+      console.log(import_chalk15.default.dim(`  Steps:    ${agents.join(" \u2192 ")}`));
+      console.log(import_chalk15.default.dim(`  Dir:      ${epicDir}`));
+      if (tags.length > 0) {
+        console.log(import_chalk15.default.dim("  Tags:     ") + import_chalk15.default.cyan(tags.join(" ")));
+      }
+      console.log(`
+Parked \u2014 nothing runs yet. When it is time: ${import_chalk15.default.cyan(`${firstStepCommand(doc, pipelineCfg, agents)} ${epicId}`)}`);
+    } catch (err) {
+      if (err instanceof import_core19.EpicScaffoldError) {
+        console.error(import_chalk15.default.red(err.message));
+        process.exit(1);
+      }
+      throw err;
+    }
+  });
   cmd.command("tag <id> [tags...]").description("Show or edit an epic's tags. Bare `tag <id>` prints them; extra words are added.").option("--add <tag>", "add a tag (repeatable) \u2014 same as passing it positionally", collectKv, []).option("--remove <tag>", "remove a tag (repeatable)", collectKv, []).option("--set <tag>", "replace every tag with these (repeatable)", collectKv, []).option("--clear", "remove every tag").option("--json", "Output the resulting tags as JSON").action((id, positional, opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     const doc = readYaml(root);
@@ -50072,6 +50369,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, pinned and recent 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, pinned] of [["pin", true], ["unpin", false]]) {
+    cmd.command(`${name} [id]`).description(pinned ? "Pin an epic to the top of the sidebar and Go to Epic picker; bare `pin` lists pins" : "Unpin an epic").action((id, _opts, actionCmd) => {
+      const root = resolveWorkspaceRoot(actionCmd);
+      if (!id) {
+        const list = (0, import_core19.readEpicFocus)(root).pinned;
+        console.log(list.length > 0 ? import_chalk15.default.cyan(list.join(" ")) : import_chalk15.default.dim("(nothing pinned)"));
+        return;
+      }
+      const epicId = pinned ? requireKnownEpic(root, id) : id;
+      (0, import_core19.setEpicPinned)(root, epicId, pinned);
+      console.log(import_chalk15.default.green("\u2714") + ` ${pinned ? "Pinned" : "Unpinned"} ${import_chalk15.default.bold(epicId)}`);
+      if (pinned) {
+        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);
@@ -50260,6 +50618,61 @@ function collectKv(value, acc) {
   acc.push(value);
   return acc;
 }
+function firstStepCommand(doc, pipelineCfg, agents) {
+  const firstStep = Array.isArray(pipelineCfg.steps) ? pipelineCfg.steps[0] : void 0;
+  const firstName = firstStep?.name ?? firstStep?.agent ?? agents[0];
+  const slashCmds = Array.isArray(doc.slash_commands) ? doc.slash_commands : [];
+  const match = slashCmds.find(
+    (c) => typeof c.name === "string" && c.name.endsWith(`-${firstName}`) && c.agent === agents[0]
+  ) ?? slashCmds.find((c) => typeof c.name === "string" && c.name.endsWith(`-${firstName}`));
+  return match?.name ?? `/${firstName}`;
+}
+function resolveEpicPipeline(root, doc, config, opts, epicId) {
+  if (opts.pipeline) {
+    const found = doc.pipelines.find((p) => String(p.id) === opts.pipeline);
+    if (!found) {
+      console.error(import_chalk15.default.red(`Pipeline "${opts.pipeline}" not found in workspace.yaml.`));
+      process.exit(1);
+    }
+    return found;
+  }
+  const recipeId = opts.recipe ?? "";
+  if (!config.recipes.some((r) => r.id === recipeId)) {
+    console.error(import_chalk15.default.red(`Recipe "${recipeId}" is not defined in this workspace.`));
+    process.exit(1);
+  }
+  if (opts.from) {
+    const recipe = config.recipes.find((r) => r.id === recipeId);
+    if (recipe) {
+      recipe.from = opts.from;
+    }
+  }
+  const pipelineId = (0, import_core19.recipePipelineId)({ recipeId, epicId, taken: existingIds(doc.pipelines) });
+  let pipelineCfg;
+  try {
+    pipelineCfg = (0, import_core19.assemblePipeline)(config, { recipeId, pipelineId });
+  } catch (err) {
+    if (err instanceof import_core19.PipelineAssembleError) {
+      console.error(import_chalk15.default.red("Could not assemble pipeline: ") + import_chalk15.default.dim(err.message));
+      process.exit(1);
+    }
+    throw err;
+  }
+  doc.pipelines.push(pipelineCfg);
+  (0, import_core19.stageEpicPipeline)(doc, pipelineCfg.id, epicId);
+  try {
+    (0, import_core19.validateWorkspace)(doc, ".aidlc/workspace.yaml");
+  } catch (err) {
+    console.error(import_chalk15.default.red("Assembled pipeline failed validation \u2014 not written:"));
+    console.error(import_chalk15.default.dim(err instanceof Error ? err.message : String(err)));
+    process.exit(1);
+  }
+  writeYaml(root, doc);
+  if (!opts.quiet) {
+    console.log(import_chalk15.default.dim(`Assembled pipeline ${import_chalk15.default.bold(pipelineCfg.id)} from recipe ${import_chalk15.default.bold(recipeId)}`));
+  }
+  return pipelineCfg;
+}
 function printEpicDetail(epic) {
   console.log();
   console.log(import_chalk15.default.bold(epic.id) + "  " + colorEpicStatus(epic.status));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delete101020/aidlc",
-  "version": "4.0.25",
+  "version": "4.0.27",
   "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": {
@@ -36,11 +36,19 @@
     "README.md",
     "AUTOMATION.md"
   ],
+  "scripts": {
+    "compile": "tsc -p ./",
+    "build": "tsc -p ./",
+    "clean": "rm -rf dist",
+    "bundle": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/bundle.js --external:fsevents && rm -rf dist/templates && cp -R ../core/templates dist/templates && rm -rf dist/tools dist/vendor dist/assets && cp -R ../../tools dist/tools && node -e \"require('fs').mkdirSync('dist/vendor', { recursive: true })\" && cp -R ../../vendor/annotron dist/vendor/annotron && cp -R ../extension/assets dist/assets",
+    "prepublishOnly": "pnpm bundle"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
+    "@aidlc/core": "workspace:*",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.0.0",
     "chalk": "^4.1.2",
@@ -48,13 +56,6 @@
     "cli-table3": "^0.6.5",
     "commander": "^11.1.0",
     "esbuild": "^0.21.0",
-    "js-yaml": "^4.1.1",
-    "@aidlc/core": "0.0.1"
-  },
-  "scripts": {
-    "compile": "tsc -p ./",
-    "build": "tsc -p ./",
-    "clean": "rm -rf dist",
-    "bundle": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/bundle.js --external:fsevents && rm -rf dist/templates && cp -R ../core/templates dist/templates && rm -rf dist/tools dist/vendor dist/assets && cp -R ../../tools dist/tools && node -e \"require('fs').mkdirSync('dist/vendor', { recursive: true })\" && cp -R ../../vendor/annotron dist/vendor/annotron && cp -R ../extension/assets dist/assets"
+    "js-yaml": "^4.1.1"
   }
-}
+}