@delete101020/aidlc 4.0.26 → 4.0.27

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

@@ -30209,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"));
@@ -30236,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) {
@@ -30267,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") : "";
@@ -30277,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;
@@ -30288,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) {
@@ -33536,11 +33652,11 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.openIncidentEpic = exports2.SignalParseError = exports2.isSignal = exports2.parseSignal = exports2.SignalSchema = exports2.EpicStepEditError = exports2.resolveStepRef = exports2.describeGateEffect = exports2.commitEpicStepEdit = exports2.planSetEpicStepGates = exports2.planRemoveEpicStep = exports2.planAddEpicStep = exports2.EpicWorkflowSwitchError = exports2.canSwitchEpicWorkflow = exports2.epicWorkflowLock = exports2.applyEpicWorkflowSwitch = exports2.stageEpicWorkflowSwitch = exports2.planEpicWorkflowSwitch = exports2.EpicDescriptionError = exports2.setEpicDescription = exports2.lockedEpicDirError = exports2.EpicScaffoldError = exports2.epicsRoot = exports2.mapStepStatusToEpic = exports2.mirrorRunStateToEpic = exports2.scaffoldEpic = exports2.resolveArtifactCommitConfig = exports2.commitApprovedArtifacts = exports2.PipelineAdaptError = exports2.applyAdaptation = exports2.parseAdaptationVerdict = exports2.buildAdaptationPrompt = exports2.buildPhaseCatalog = exports2.slugEpicId = exports2.parseClassificationVerdict = exports2.buildClassificationPrompt = exports2.heuristicClassify = exports2.PipelineAssembleError = exports2.recipePipelineId = exports2.assemblePipeline = exports2.collectWorkspaceRefIssues = exports2.resolveStepSkills = exports2.stepSkillAlternatives = exports2.stepDagId = exports2.stepAgentId = exports2.producesEntries = exports2.normalizeStep = exports2.WorkspaceValidationError = exports2.validateWorkspace = exports2.WorkspaceSchema = void 0;
     exports2.dropRecipesForPipeline = exports2.dropRecipeStep = exports2.recipesDrawingFrom = exports2.WORKSPACE_DIR = exports2.WORKSPACE_FILENAME = exports2.WorkspaceParseError = exports2.WorkspaceNotFoundError = exports2.WorkspaceLoader = exports2.renderPlanMarkdown = exports2.generatePlan = exports2.collectContext = exports2.followUpHookFailures = exports2.pendingFollowUpDone = exports2.applyFollowUpHookRun = exports2.trackFollowUpChildren = exports2.writeFollowUpHookLedger = exports2.readFollowUpHookLedger = exports2.followUpHookLedgerPath = exports2.runFollowUpHook = exports2.fillFollowUpHookCommand = exports2.resolveFollowUpHooks = exports2.epicPipelineId = exports2.FOLLOW_UP_HOOK_TIMEOUT_MS = exports2.FOLLOW_UP_HOOKS_LEDGER = exports2.stepProducesFollowUps = exports2.collectFollowUpHookIssues = exports2.FOLLOW_UP_HOOK_PLACEHOLDERS = exports2.FOLLOW_UP_HOOK_KEYS = exports2.FOLLOW_UP_INTENT = exports2.FOLLOW_UPS_FILE = exports2.MANUAL_FOLLOW_UP_KEY_PREFIX = exports2.followUpDefaults = exports2.nextManualFollowUpKey = exports2.withFollowUpProvenance = exports2.openManifestFollowUp = exports2.followUpChildId = exports2.followUpsOf = exports2.readEpicFollowUps = exports2.parseFollowUps = exports2.FollowUpsParseError = exports2.FollowUpManifestSchema = exports2.FollowUpItemSchema = exports2.SIGNAL_FILE = exports2.FOLLOW_UP_ARTIFACT = exports2.readEpicSignal = exports2.existingEpicIds = exports2.followUpIdFor = exports2.followUpEpicId = exports2.renderIntentMarkdown = exports2.openFollowUpEpic = void 0;
-    exports2.EPIC_TAGS_KEY = exports2.strictModeSection = exports2.resolveEpicStrictMode = exports2.epicStrictMode = exports2.commandBodyPredatesStrictMode = exports2.STRICT_MODE_KEY = exports2.STRICT_MODE_HEADING = exports2.writeUserEpicIdPrefix = exports2.userConfigPath = exports2.readUserConfig = exports2.readGitUserName = exports2.ensureUserConfigIgnored = exports2.USER_CONFIG_RELPATH = exports2.USER_CONFIG_IGNORE_LINE = exports2.suggestEpicId = exports2.resolveEpicIdPrefixChain = exports2.resolveEpicIdPrefix = exports2.epicIdDateStamp = exports2.deriveEpicIdPrefix = exports2.EPIC_ID_PREFIX_PATTERN = exports2.EPIC_ID_PREFIX_KEY = exports2.resolveArtifactLanguage = exports2.commandBodyPredatesArtifactLanguage = exports2.artifactLanguageSection = exports2.ARTIFACT_LANGUAGE_HEADING = exports2.stripPersonaDirectives = exports2.composeAgentPrompt = exports2.PROJECT_INSTRUCTION_FILES = exports2.findProjectInstructions = exports2.stripPersonaMetadata = exports2.PersonaLoader = exports2.SkillNotFoundError = exports2.SkillLoader = exports2.EnvVarMissingError = exports2.EnvResolver = exports2.epicPipelineReport = exports2.planEpicPipelineExtraction = exports2.epicOwningPipeline = exports2.unstageEpicPipeline = exports2.stageEpicPipeline = exports2.writeEpicPipelines = exports2.splitEpicPipelines = exports2.mergeEpicPipelines = exports2.epicPipelinePath = exports2.EPIC_PIPELINE_FILENAME = exports2.unusedAfterStepRemoval = exports2.skillReferences = exports2.agentReferences = exports2.renameSkillRefs = exports2.renameAgentRefs = void 0;
-    exports2.dirtyUpstreamOf = exports2.rerunApprovedStep = exports2.canRerunApprovedStep = exports2.chooseStepSkill = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = exports2.undoStepDone = exports2.canUndoStepDone = exports2.markStepDone = exports2.canStartStep = exports2.startRun = exports2.activateBackendFromWorkspace = exports2.activateRunStateBackend = exports2.resolveRunStateBackend = exports2.GitRunStateStore = exports2.RUN_ID_PATTERN = exports2.FileRunStateStore = exports2.RunStateStore = exports2.harnessCapabilities = exports2.NO_HARNESS_CAPABILITIES = exports2.RunnerValidationError = exports2.validateRunnerExport = exports2.CustomRunnerLoader = exports2.buildClaudeSpawnEnv = exports2.hasClaudeLogin = exports2.isInsideClaudeCodeSession = exports2.createJsonSink = exports2.createLineSink = exports2.isCodexMcpConfigured = exports2.codexConfigPath = exports2.readProjectMcpServer = exports2.mcpRegistrarFor = exports2.codexMcpRegistrar = exports2.claudeMcpRegistrar = exports2.CodexRunner = exports2.claudeModelArg = exports2.DefaultRunner = exports2.RunnerRegistry = exports2.targetPath = exports2.scopePaths = exports2.discoverAssets = exports2.commandBodyIsStale = exports2.readEpicTags = exports2.normalizeTags = exports2.normalizeTag = exports2.epicMatchesTags = exports2.applyTagEdit = exports2.MAX_TAG_LENGTH = void 0;
-    exports2.PLANNING_MODEL = exports2.isBuiltinPreset = exports2.BUILTIN_PRESET_IDS = exports2.writeBuiltinAutoReviewValidators = exports2.resolvePrimaryStack = exports2.getSdlcArtifactTemplates = exports2.getBuiltinArtifactTemplates = exports2.phaseArtifactFileName = exports2.sdlcClaudeCommand = exports2.builtinClaudeCommand = exports2.loadAllBuiltinPresets = exports2.loadBuiltinPreset = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = exports2.getBuiltinWorkflow = exports2.workflowSlug = exports2.builtinTemplatesRoot = exports2.pipelineCommandId = exports2.PHASES = exports2.BUILTIN_WORKFLOWS = exports2.withBackfilledStepNames = exports2.describeDrift = exports2.reconcileRunSteps = exports2.RUN_STATE_SCHEMA_VERSION = exports2.migrateRunState = exports2.stepIdentity = exports2.resolvePath = exports2.AutoReviewerError = exports2.runAutoReview = exports2.renderRunReport = exports2.verifyRun = exports2.runExecLoop = exports2.estimateCostUsd = exports2.providerAliases = exports2.ratesFromConfig = exports2.mergeRates = exports2.BUILTIN_RATES = exports2.checkBudget = exports2.weighStepProgress = exports2.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = void 0;
-    exports2.setClaudeConfigDir = exports2.resolveDeclaredPath = exports2.expandHome = exports2.ProfileLoadError = exports2.UnknownStandardError = exports2.builtinProfiles = exports2.loadActiveProfile = exports2.loadProfile = exports2.listProfileManifests = exports2.resolveStandard = exports2.workspaceStandard = exports2.isBuiltinProfileId = exports2.ProfileSchema = exports2.TRACE_RULES = exports2.PROFILES_DIR = exports2.DEFAULT_PROFILE_ID = exports2.BUILTIN_PROFILE_IDS = exports2.setEpicMemoryHook = exports2.isEpicMemoryHookEnabled = exports2.installAnnotationTools = exports2.relativeEpicRoot = exports2.provisionDeclaredWorkflows = exports2.provisionWorkflowFiles = exports2.writeWorkflowArtifactTemplates = exports2.writeWorkflowCommands = exports2.provisionShortcutDocs = exports2.writeTwoLayerCommands = exports2.shortcutCommandDoc = exports2.backboneCommandDoc = exports2.unprovisionedPhases = exports2.nextEligiblePhase = exports2.resolveComposition = exports2.shortcutCommandId = exports2.getCanonicalPhase = exports2.isCanonicalPhase = exports2.BACKBONE_COMMAND_ID = exports2.CANONICAL_PHASE_IDS = exports2.CANONICAL_PHASES = exports2.renderTemplate = exports2.DEFAULT_GLOBAL_WORKFLOW_IDS = exports2.detectGlobalBuiltinSource = exports2.uninstallWorkflowGlobalsByIds = exports2.isWorkflowGloballyInstalled = exports2.installWorkflowGlobalsByIds = exports2.installGlobalDefaults = exports2.resolveProviderModel = exports2.isClaudeTierAlias = exports2.CLAUDE_TIER_ALIASES = exports2.FAST_MODEL = exports2.CODING_MODEL = void 0;
-    exports2.AIDLC_CORE_VERSION = exports2.AIDLC_CLI_GUIDE_TEXT = exports2.AIDLC_KNOWLEDGE = exports2.clearResolveCommandCache = exports2.resolveCommand = exports2.remapClaudePath = exports2.claudeConfigEnv = exports2.claudeJsonPath = exports2.isDefaultClaudeConfigDir = exports2.claudeConfigDir = exports2.resolveClaudeConfigDir = exports2.defaultClaudeConfigDir = exports2.getClaudeConfigDirOverride = void 0;
+    exports2.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;
@@ -33992,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;
@@ -43212,7 +43365,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.26",
+      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: {
@@ -50216,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);

package/package.json

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