@delete101020/aidlc 4.0.36 → 4.0.38

package/README.md

@@ -313,6 +313,13 @@ the pipeline it was derived from) and inherits its tags; override with
 runs: the child waits at its first step until someone starts it. The
 extension's card offers the same as **New follow-up epic**.
 
+One epic can follow several: `epic follow-up SEAL-CUT --also SEAL-CLASSIFY`
+(repeatable; **Also follows** in the extension) when one change reworks what two
+earlier epics built. The extra parents go into `also_from` — linked from both
+cards, while the child stays grouped under `<parent>`. Every phase prompt tells
+the agent to read each parent's `intent.md` and `spec.md` first, so the child
+starts from their rules instead of a change request on each.
+
 **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
 accents and case are folded on the way *in* to a filter too, so `--tag "thanh

package/dist/bundle.js

@@ -27076,11 +27076,12 @@ var require_FollowUps = __commonJS({
       };
     }();
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.MANUAL_FOLLOW_UP_KEY_PREFIX = exports2.FollowUpsParseError = exports2.FollowUpManifestSchema = exports2.FollowUpItemSchema = exports2.FOLLOW_UP_INTENT = exports2.FOLLOW_UPS_FILE = void 0;
+    exports2.MANUAL_FOLLOW_UP_KEY_PREFIX = exports2.ALSO_FROM_INPUT = 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.combinedParentId = combinedParentId;
     exports2.openManifestFollowUp = openManifestFollowUp;
     exports2.withFollowUpProvenance = withFollowUpProvenance2;
     exports2.nextManualFollowUpKey = nextManualFollowUpKey;
@@ -27205,6 +27206,17 @@ var require_FollowUps = __commonJS({
       }
       throw new EpicScaffold_1.EpicScaffoldError(`Could not derive a free epic id from "${base}".`);
     }
+    function combinedParentId(parentEpicId, alsoFrom = []) {
+      const head = parentEpicId.split("-");
+      return parentEpicId + alsoFrom.map((id) => {
+        const segs = id.split("-");
+        let i = 0;
+        while (i < segs.length - 1 && segs[i] === head[i]) {
+          i++;
+        }
+        return segs.slice(i).join("-");
+      }).join("");
+    }
     function openManifestFollowUp(args) {
       const { workspaceRoot, doc, parentEpicId, item, pipeline } = args;
       const steps = Array.isArray(pipeline.steps) ? pipeline.steps : [];
@@ -27235,8 +27247,16 @@ 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.ALSO_FROM_INPUT = "also_from";
+    function withFollowUpProvenance2(inputs, parentEpicId, key, alsoFrom = []) {
+      const { [exports2.ALSO_FROM_INPUT]: _ignored, ...rest } = inputs;
+      const others = [...new Set(alsoFrom.map((id) => id.trim()).filter((id) => id && id !== parentEpicId))];
+      return {
+        ...rest,
+        from_epic: parentEpicId,
+        follow_up_key: key,
+        ...others.length > 0 ? { [exports2.ALSO_FROM_INPUT]: others.join(",") } : {}
+      };
     }
     exports2.MANUAL_FOLLOW_UP_KEY_PREFIX = "F";
     function nextManualFollowUpKey(taken) {
@@ -27283,7 +27303,7 @@ var require_FollowUps = __commonJS({
       }
       return void 0;
     }
-    function followUpDefaults2(workspaceRoot, doc, parentEpicId) {
+    function followUpDefaults2(workspaceRoot, doc, parentEpicId, alsoFrom = []) {
       const root = (0, EpicScaffold_1.epicsRoot)(workspaceRoot, doc);
       const dir = path17.join(root, parentEpicId);
       const stateFile = path17.join(dir, "state.json");
@@ -27312,14 +27332,15 @@ var require_FollowUps = __commonJS({
       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 combined = combinedParentId(parentEpicId, alsoFrom);
+      const key = alsoFrom.length > 0 ? nextManualFollowUpKey(taken.filter((id) => id.startsWith(`${combined}-`)).map((id) => id.slice(combined.length + 1))) : nextManualFollowUpKey(followUpsOf(workspaceRoot, doc, parentEpicId).map((f) => f.key ?? ""));
       const target = parentTarget(own, pipelines, recipes);
       return {
         parentEpicId,
         parentTitle: typeof state.title === "string" ? state.title : "",
         key,
-        epicId: followUpChildId(parentEpicId, key, taken),
+        epicId: followUpChildId(combined, key, taken),
         tags: (0, epicTags_1.normalizeTags)(state.tags),
         ...target ? { target } : {}
       };
@@ -30677,6 +30698,24 @@ var require_epicFocus = __commonJS({
   }
 });
 
+// ../core/dist/loader/inheritedContext.js
+var require_inheritedContext = __commonJS({
+  "../core/dist/loader/inheritedContext.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.INHERITED_CONTEXT_MARKER = void 0;
+    exports2.inheritedContextNote = inheritedContextNote;
+    exports2.commandBodyPredatesInheritedContext = commandBodyPredatesInheritedContext;
+    exports2.INHERITED_CONTEXT_MARKER = "`also_from`";
+    function inheritedContextNote(epicRoot) {
+      return `If it has \`from_epic\` (and ${exports2.INHERITED_CONTEXT_MARKER}, comma-separated), this epic follows those epics and inherits their business rules: before writing, read each one's \`${epicRoot}/<parent>/artifacts/intent.md\` and \`spec.md\` (whichever exist), keep what this epic does not change, and say what it changes.`;
+    }
+    function commandBodyPredatesInheritedContext(existing) {
+      return !existing.includes(exports2.INHERITED_CONTEXT_MARKER);
+    }
+  }
+});
+
 // ../core/dist/presets/commandBodyFreshness.js
 var require_commandBodyFreshness = __commonJS({
   "../core/dist/presets/commandBodyFreshness.js"(exports2) {
@@ -30685,8 +30724,9 @@ var require_commandBodyFreshness = __commonJS({
     exports2.commandBodyIsStale = commandBodyIsStale;
     var artifactLanguage_1 = require_artifactLanguage();
     var strictMode_1 = require_strictMode();
+    var inheritedContext_1 = require_inheritedContext();
     function commandBodyIsStale(existing) {
-      return (0, artifactLanguage_1.commandBodyPredatesArtifactLanguage)(existing) || (0, strictMode_1.commandBodyPredatesStrictMode)(existing);
+      return (0, artifactLanguage_1.commandBodyPredatesArtifactLanguage)(existing) || (0, strictMode_1.commandBodyPredatesStrictMode)(existing) || (0, inheritedContext_1.commandBodyPredatesInheritedContext)(existing);
     }
   }
 });
@@ -31337,8 +31377,46 @@ Expected a JS/TS module at "${scriptPath}" with a default-exported function retu
 var require_execEngine = __commonJS({
   "../core/dist/runs/execEngine.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.runExecLoop = runExecLoop2;
+    var path17 = __importStar(require("path"));
     var WorkspaceLoader_1 = require_WorkspaceLoader();
     var RunStateStore_1 = require_RunStateStore();
     var PipelineRunner_1 = require_PipelineRunner();
@@ -31353,6 +31431,7 @@ var require_execEngine = __commonJS({
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var artifactLanguage_1 = require_artifactLanguage();
     var strictMode_1 = require_strictMode();
+    var inheritedContext_1 = require_inheritedContext();
     var promptComposer_1 = require_promptComposer();
     var projectInstructions_1 = require_projectInstructions();
     var types_1 = require_types();
@@ -31553,7 +31632,11 @@ var require_execEngine = __commonJS({
       const skillText = prompt2.text;
       const env = ws.envResolver.resolveLayered(ws.config.environment ?? {}, agent.env ?? {});
       const contextStr = Object.entries(state.context).map(([k, v]) => `${k}=${v}`).join(" ");
-      const userMessage = opts.message ?? (contextStr || `Execute step: ${agentId}`);
+      const epicRoot = path17.relative(root, (0, EpicScaffold_1.epicsRoot)(root, ws.config)).split(path17.sep).join("/");
+      const inherited = state.context.from_epic ? `
+
+About these inputs: ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}` : "";
+      const userMessage = opts.message ?? (contextStr ? contextStr + inherited : `Execute step: ${agentId}`);
       if (opts.dryRun) {
         hooks.onDryRunPreview?.({
           skills: skillIds.join(", "),
@@ -32094,6 +32177,7 @@ var require_builtinWorkflows = __commonJS({
     var path17 = __importStar(require("path"));
     var artifactLanguage_1 = require_artifactLanguage();
     var strictMode_1 = require_strictMode();
+    var inheritedContext_1 = require_inheritedContext();
     var models_1 = require_models();
     var templateRenderer_1 = require_templateRenderer();
     var PHASES = [
@@ -32890,7 +32974,7 @@ The user invoked you with epic id \`$ARGUMENTS\`.
 1. Read \`${epicRoot}/$ARGUMENTS/state.json\` to understand the current run state.
    - If the step has \`feedback\` from a prior rejection, address it explicitly in this revision.
    - Check \`history\` entries for rejection reasons and context.
-2. Read \`${epicRoot}/$ARGUMENTS/inputs.json\` for capability inputs (Jira ticket, Figma URL, files glob, GitHub repo, etc.).
+2. Read \`${epicRoot}/$ARGUMENTS/inputs.json\` for capability inputs (Jira ticket, Figma URL, files glob, GitHub repo, etc.). ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}
 ${artifactInstruction}
 4. When finished, summarize what you produced and tell the user to click **"Mark step done"** in the AIDLC panel to advance the pipeline.
 
@@ -33308,6 +33392,7 @@ var require_commandModel = __commonJS({
     var path17 = __importStar(require("path"));
     var artifactLanguage_1 = require_artifactLanguage();
     var strictMode_1 = require_strictMode();
+    var inheritedContext_1 = require_inheritedContext();
     var commandBodyFreshness_1 = require_commandBodyFreshness();
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var runProgress_1 = require_runProgress();
@@ -33466,7 +33551,7 @@ Claude \u2014 but still follow the structural contract below.
 
 1. Read \`${epicRoot}/<epic>/state.json\` for prior feedback/history and address
    any rejection reasons in this revision.
-2. Read \`${epicRoot}/<epic>/inputs.json\` for capability inputs.
+2. Read \`${epicRoot}/<epic>/inputs.json\` for capability inputs. ${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}
 3. Before writing, read the blank template for that artifact at
    \`.aidlc/aidlc-templates/<templatesId>/<FILE>\` and follow its structure \u2014
    \`<templatesId>\` is the pipeline's \`derived_from\` when it has one (a
@@ -33509,7 +33594,7 @@ procedure exactly as \`/aidlc <epic> ${phase.id}\` would:
    ones \u2014 and only fall back to \`.claude/skills/<id>.md\` and
    \`.claude/agents/<id>.md\` when none is declared. Adopt them (unless the
    active standard is \`none\`), then follow the structural contract: read
-   state/inputs, write to
+   state/inputs (${(0, inheritedContext_1.inheritedContextNote)(epicRoot)}), write to
    \`${epicRoot}/<epic>/artifacts/${phase.artifact}\` (or the step's declared
    artifact), and tell the user to click **"Mark step done"**.
 
@@ -34032,12 +34117,12 @@ var require_dist = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     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.RECENT_EPICS_LIMIT = exports2.RECENT_EPICS_KEY = exports2.EPIC_LIST_FLAT_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.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.setEpicListFlat = exports2.setEpicSort = exports2.setActiveEpic = exports2.recordEpicOpened = exports2.readEpicListFlat = exports2.readEpicSort = exports2.readEpicFocus = exports2.pushRecent = exports2.epicSortFrom = exports2.epicIdFromBranch = exports2.epicFocusFrom = exports2.WATCHED_EPICS_KEY = void 0;
-    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.chooseStepModel = 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 = void 0;
-    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.stepModelOptions = exports2.pickAgentModel = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = exports2.FAST_MODEL = exports2.CODING_MODEL = exports2.PLANNING_MODEL = exports2.isBuiltinPreset = exports2.BUILTIN_PRESET_IDS = exports2.writeBuiltinAutoReviewValidators = exports2.resolvePrimaryStack = exports2.getSdlcArtifactTemplates = exports2.getBuiltinArtifactTemplates = exports2.phaseArtifactFileName = exports2.sdlcClaudeCommand = exports2.builtinClaudeCommand = exports2.loadAllBuiltinPresets = exports2.loadBuiltinPreset = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = exports2.PHASES = exports2.BUILTIN_WORKFLOWS = exports2.withBackfilledStepNames = exports2.describeDrift = void 0;
-    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = exports2.setClaudeConfigDir = exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = void 0;
+    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.combinedParentId = 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.RECENT_EPICS_KEY = exports2.EPIC_LIST_FLAT_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 = exports2.dropRecipeStep = void 0;
+    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.inheritedContextNote = exports2.INHERITED_CONTEXT_MARKER = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.setEpicWatched = exports2.setEpicListFlat = exports2.setEpicSort = exports2.setActiveEpic = exports2.recordEpicOpened = exports2.readEpicListFlat = exports2.readEpicSort = exports2.readEpicFocus = exports2.pushRecent = exports2.epicSortFrom = exports2.epicIdFromBranch = exports2.epicFocusFrom = exports2.WATCHED_EPICS_KEY = exports2.RECENT_EPICS_LIMIT = void 0;
+    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.chooseStepModel = 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 = void 0;
+    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.stepModelOptions = exports2.pickAgentModel = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = exports2.FAST_MODEL = exports2.CODING_MODEL = exports2.PLANNING_MODEL = exports2.isBuiltinPreset = exports2.BUILTIN_PRESET_IDS = exports2.writeBuiltinAutoReviewValidators = exports2.resolvePrimaryStack = exports2.getSdlcArtifactTemplates = exports2.getBuiltinArtifactTemplates = exports2.phaseArtifactFileName = exports2.sdlcClaudeCommand = exports2.builtinClaudeCommand = exports2.loadAllBuiltinPresets = exports2.loadBuiltinPreset = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = exports2.PHASES = exports2.BUILTIN_WORKFLOWS = exports2.withBackfilledStepNames = exports2.describeDrift = exports2.reconcileRunSteps = exports2.RUN_STATE_SCHEMA_VERSION = exports2.migrateRunState = void 0;
+    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = exports2.setClaudeConfigDir = exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = exports2.backboneCommandDoc = exports2.unprovisionedPhases = exports2.nextEligiblePhase = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -34248,6 +34333,9 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "followUpChildId", { enumerable: true, get: function() {
       return FollowUps_1.followUpChildId;
     } });
+    Object.defineProperty(exports2, "combinedParentId", { enumerable: true, get: function() {
+      return FollowUps_1.combinedParentId;
+    } });
     Object.defineProperty(exports2, "openManifestFollowUp", { enumerable: true, get: function() {
       return FollowUps_1.openManifestFollowUp;
     } });
@@ -34575,6 +34663,13 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "strictModeSection", { enumerable: true, get: function() {
       return strictMode_1.strictModeSection;
     } });
+    var inheritedContext_1 = require_inheritedContext();
+    Object.defineProperty(exports2, "INHERITED_CONTEXT_MARKER", { enumerable: true, get: function() {
+      return inheritedContext_1.INHERITED_CONTEXT_MARKER;
+    } });
+    Object.defineProperty(exports2, "inheritedContextNote", { enumerable: true, get: function() {
+      return inheritedContext_1.inheritedContextNote;
+    } });
     var epicTags_1 = require_epicTags();
     Object.defineProperty(exports2, "EPIC_TAGS_KEY", { enumerable: true, get: function() {
       return epicTags_1.EPIC_TAGS_KEY;
@@ -43796,7 +43891,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.36",
+      version: "4.0.38",
       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: {
@@ -50515,7 +50610,7 @@ 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) => {
+  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("--also <epic>", "another epic this one also follows (repeatable) \u2014 linked and read for context; <parentEpic> stays the one it is grouped under", collectKv, []).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) {
@@ -50532,11 +50627,19 @@ Run ${import_chalk15.default.cyan(`${runCmd} ${epicId}`)} in Claude to begin.`);
     }
     let defaults;
     try {
-      defaults = (0, import_core19.followUpDefaults)(root, doc, parentEpic);
+      defaults = (0, import_core19.followUpDefaults)(root, doc, parentEpic, opts.also.map((id) => id.trim()));
     } catch (err) {
       console.error(import_chalk15.default.red(err instanceof Error ? err.message : String(err)));
       process.exit(1);
     }
+    for (const other of opts.also) {
+      try {
+        (0, import_core19.followUpDefaults)(root, doc, other.trim());
+      } 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) {
@@ -50563,7 +50666,7 @@ Run ${import_chalk15.default.cyan(`${runCmd} ${epicId}`)} in Claude to begin.`);
         description: opts.desc?.trim() ?? "",
         target: { kind: "pipeline", id: pipelineCfg.id },
         agents,
-        inputs: (0, import_core19.withFollowUpProvenance)(inputs, parentEpic, defaults.key),
+        inputs: (0, import_core19.withFollowUpProvenance)(inputs, parentEpic, defaults.key, opts.also),
         pipeline: pipelineCfg,
         strictMode: opts.strict,
         tags
@@ -50574,12 +50677,14 @@ Run ${import_chalk15.default.cyan(`${runCmd} ${epicId}`)} in Claude to begin.`);
           epicDir,
           pipeline: pipelineCfg.id,
           fromEpic: parentEpic,
+          alsoFrom: opts.also,
           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)}`);
+      const others = opts.also.length > 0 ? ` (also ${opts.also.map((id) => import_chalk15.default.bold(id)).join(", ")})` : "";
+      console.log(import_chalk15.default.green("\u2714") + ` Opened follow-up ${import_chalk15.default.bold(epicId)} of ${import_chalk15.default.bold(parentEpic)}${others}`);
       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}`));

package/package.json

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