@delete101020/aidlc 4.0.25 → 4.0.26

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/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 } : {}
+      };
+    }
   }
 });
 
@@ -33448,12 +33535,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.EPIC_TAGS_KEY = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.writeUserEpicIdPrefix = exports2.userConfigPath = exports2.readUserConfig = exports2.readGitUserName = exports2.ensureUserConfigIgnored = exports2.USER_CONFIG_RELPATH = exports2.USER_CONFIG_IGNORE_LINE = exports2.suggestEpicId = exports2.resolveEpicIdPrefixChain = exports2.resolveEpicIdPrefix = exports2.epicIdDateStamp = exports2.deriveEpicIdPrefix = exports2.EPIC_ID_PREFIX_PATTERN = exports2.EPIC_ID_PREFIX_KEY = exports2.resolveArtifactLanguage = exports2.commandBodyPredatesArtifactLanguage = exports2.artifactLanguageSection = exports2.ARTIFACT_LANGUAGE_HEADING = exports2.stripPersonaDirectives = exports2.composeAgentPrompt = exports2.PROJECT_INSTRUCTION_FILES = exports2.findProjectInstructions = exports2.stripPersonaMetadata = exports2.PersonaLoader = exports2.SkillNotFoundError = exports2.SkillLoader = exports2.EnvVarMissingError = exports2.EnvResolver = exports2.epicPipelineReport = exports2.planEpicPipelineExtraction = exports2.epicOwningPipeline = exports2.unstageEpicPipeline = exports2.stageEpicPipeline = exports2.writeEpicPipelines = exports2.splitEpicPipelines = exports2.mergeEpicPipelines = exports2.epicPipelinePath = exports2.EPIC_PIPELINE_FILENAME = exports2.unusedAfterStepRemoval = exports2.skillReferences = exports2.agentReferences = exports2.renameSkillRefs = exports2.renameAgentRefs = void 0;
+    exports2.dirtyUpstreamOf = exports2.rerunApprovedStep = exports2.canRerunApprovedStep = exports2.chooseStepSkill = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = exports2.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = exports2.startRun = exports2.activateBackendFromWorkspace = exports2.activateRunStateBackend = exports2.resolveRunStateBackend = exports2.GitRunStateStore = exports2.RUN_ID_PATTERN = exports2.FileRunStateStore = exports2.RunStateStore = exports2.harnessCapabilities = exports2.NO_HARNESS_CAPABILITIES = exports2.RunnerValidationError = exports2.validateRunnerExport = exports2.CustomRunnerLoader = exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.CodexRunner = exports2.claudeModelArg = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = exports2.commandBodyIsStale = exports2.readEpicTags = exports2.normalizeTags = exports2.normalizeTag = exports2.epicMatchesTags = exports2.applyTagEdit = exports2.MAX_TAG_LENGTH = void 0;
+    exports2.PLANNING_MODEL = exports2.isBuiltinPreset = exports2.BUILTIN_PRESET_IDS = exports2.writeBuiltinAutoReviewValidators = exports2.resolvePrimaryStack = exports2.getSdlcArtifactTemplates = exports2.getBuiltinArtifactTemplates = exports2.phaseArtifactFileName = exports2.sdlcClaudeCommand = exports2.builtinClaudeCommand = exports2.loadAllBuiltinPresets = exports2.loadBuiltinPreset = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = exports2.PHASES = exports2.BUILTIN_WORKFLOWS = exports2.withBackfilledStepNames = exports2.describeDrift = exports2.reconcileRunSteps = exports2.RUN_STATE_SCHEMA_VERSION = exports2.migrateRunState = exports2.stepIdentity = exports2.resolvePath = exports2.AutoReviewerError = exports2.runAutoReview = exports2.renderRunReport = exports2.verifyRun = exports2.runExecLoop = exports2.estimateCostUsd = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.checkBudget = exports2.weighStepProgress = exports2.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = void 0;
+    exports2.setClaudeConfigDir = exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = exports2.backboneCommandDoc = exports2.unprovisionedPhases = exports2.nextEligiblePhase = exports2.resolveComposition = exports2.shortcutCommandId = exports2.getCanonicalPhase = exports2.isCanonicalPhase = exports2.BACKBONE_COMMAND_ID = exports2.CANONICAL_PHASE_IDS = exports2.CANONICAL_PHASES = exports2.renderTemplate = exports2.DEFAULT_GLOBAL_WORKFLOW_IDS = exports2.detectGlobalBuiltinSource = exports2.uninstallWorkflowGlobalsByIds = exports2.isWorkflowGloballyInstalled = exports2.installWorkflowGlobalsByIds = exports2.installGlobalDefaults = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = exports2.FAST_MODEL = exports2.CODING_MODEL = void 0;
+    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -33664,6 +33751,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;
     } });
@@ -43113,7 +43212,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.25",
+      version: "4.0.26",
       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 +49851,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 +49870,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 +49910,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 +49921,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);
@@ -50260,6 +50404,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.26",
   "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": {