@delete101020/aidlc 4.0.7 → 4.0.10

package/dist/bundle.js

@@ -19837,6 +19837,17 @@ var require_WorkspaceSchema = __commonJS({
       name: zod_1.z.string().optional(),
       /** Step is part of the pipeline but skipped at run time when false. Defaults to true. */
       enabled: zod_1.z.boolean().default(true),
+      /**
+       * A step the run may fail and carry on past. Its rejection never marks the
+       * epic failed, never parks the run cursor, and never keeps the run from
+       * completing; the autopilot loop steps over it to whatever else is open.
+       *
+       * For the side branch whose findings are welcome but not required — a
+       * second reviewer's lens, an optional QC pass. Without the flag the only
+       * thing making such a step skippable is that nothing happens to
+       * `depends_on` it, which the runner cannot tell from an oversight.
+       */
+      optional: zod_1.z.boolean().default(false),
       /** Artifact paths the step is expected to produce. Checked after work. */
       produces: zod_1.z.array(zod_1.z.string().min(1)).default([]),
       /**
@@ -19969,6 +19980,7 @@ var require_WorkspaceSchema = __commonJS({
         return {
           agent: step,
           enabled: true,
+          optional: false,
           produces: [],
           produces_contains: [],
           requires: [],
@@ -19994,6 +20006,7 @@ var require_WorkspaceSchema = __commonJS({
         name: typeof obj.name === "string" ? obj.name : void 0,
         skills,
         enabled: typeof obj.enabled === "boolean" ? obj.enabled : true,
+        optional: obj.optional === true,
         produces,
         produces_contains,
         requires,
@@ -20752,6 +20765,83 @@ var require_RunState = __commonJS({
   }
 });
 
+// ../core/dist/runs/runProgress.js
+var require_runProgress = __commonJS({
+  "../core/dist/runs/runProgress.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.isActiveStatus = isActiveStatus;
+    exports2.isStepOptional = isStepOptional;
+    exports2.deriveRunProgress = deriveRunProgress;
+    exports2.isRunComplete = isRunComplete;
+    var WorkspaceSchema_1 = require_WorkspaceSchema();
+    var ACTIVE = /* @__PURE__ */ new Set([
+      "awaiting_work",
+      "awaiting_auto_review",
+      "awaiting_review"
+    ]);
+    function isActiveStatus(status) {
+      return ACTIVE.has(status);
+    }
+    function isStepOptional(pipeline, idx) {
+      const cfg = pipeline?.steps?.[idx];
+      return cfg === void 0 ? false : (0, WorkspaceSchema_1.normalizeStep)(cfg).optional;
+    }
+    function usesDag(pipeline) {
+      return pipeline.steps.some((s) => (0, WorkspaceSchema_1.normalizeStep)(s).depends_on.length > 0);
+    }
+    function deriveRunProgress(state, pipeline) {
+      const dag = pipeline ? usesDag(pipeline) : false;
+      const approvedDagIds = /* @__PURE__ */ new Set();
+      if (pipeline && dag) {
+        state.steps.forEach((s, i) => {
+          if (s.status !== "approved") {
+            return;
+          }
+          const norm = (0, WorkspaceSchema_1.normalizeStep)(pipeline.steps[i] ?? { agent: s.agent });
+          approvedDagIds.add(norm.name ?? norm.agent);
+        });
+      }
+      const actionable = [];
+      const rejected = [];
+      const blocking = [];
+      state.steps.forEach((s, i) => {
+        if (isActiveStatus(s.status)) {
+          actionable.push(i);
+          return;
+        }
+        if (s.status === "rejected") {
+          rejected.push(i);
+          if (!isStepOptional(pipeline, i)) {
+            blocking.push(i);
+          }
+          return;
+        }
+        if (s.status === "pending" && pipeline && dag) {
+          const deps = (0, WorkspaceSchema_1.normalizeStep)(pipeline.steps[i] ?? { agent: s.agent }).depends_on;
+          if (deps.length > 0 && deps.every((d) => approvedDagIds.has(d))) {
+            actionable.push(i);
+          }
+        }
+      });
+      const stuck = blocking.length > 0 && actionable.length === 0;
+      const status = state.status === "completed" ? "done" : stuck ? "failed" : "in_progress";
+      return { actionable, rejected, blocking, stuck, status };
+    }
+    function isRunComplete(state, pipeline) {
+      return state.steps.every((s, i) => {
+        if (s.status === "approved") {
+          return true;
+        }
+        if (!isStepOptional(pipeline, i)) {
+          return false;
+        }
+        return s.status === "rejected" || s.status === "pending";
+      });
+    }
+  }
+});
+
 // ../core/dist/runs/reconcileRun.js
 var require_reconcileRun = __commonJS({
   "../core/dist/runs/reconcileRun.js"(exports2) {
@@ -20911,6 +21001,7 @@ var require_PipelineRunner = __commonJS({
     exports2.canStartStep = canStartStep;
     exports2.markStepDone = markStepDone3;
     exports2.submitAutoReviewVerdict = submitAutoReviewVerdict2;
+    exports2.retryAutoReview = retryAutoReview;
     exports2.approveStep = approveStep3;
     exports2.rejectStep = rejectStep3;
     exports2.rerunStep = rerunStep3;
@@ -20919,6 +21010,7 @@ var require_PipelineRunner = __commonJS({
     var path17 = __importStar(require("path"));
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     var RunState_1 = require_RunState();
+    var runProgress_1 = require_runProgress();
     var reconcileRun_1 = require_reconcileRun();
     var PipelineRunError3 = class extends Error {
       missing;
@@ -21098,6 +21190,7 @@ var require_PipelineRunner = __commonJS({
           sentBackToIdx: idx
         });
         next.status = "running";
+        settleOptionalRejection(next, idx, pipeline);
         return next;
       }
       if (norm.human_review) {
@@ -21107,6 +21200,37 @@ var require_PipelineRunner = __commonJS({
       }
       return advance(next, idx, pipeline);
     }
+    function retryAutoReview(args) {
+      const { pipeline } = args;
+      const state = alignedOrThrow(args.state, pipeline);
+      const idx = args.stepIdx ?? state.currentStepIdx;
+      const step = state.steps[idx];
+      if (!step) {
+        throw new PipelineRunError3(`No step at index ${idx}`);
+      }
+      if (step.status !== "rejected") {
+        throw new PipelineRunError3(`Cannot re-run auto-review for step "${step.agent}": status is "${step.status}", expected "rejected"`);
+      }
+      if (step.autoReviewVerdict?.decision !== "reject") {
+        throw new PipelineRunError3(`Step "${step.agent}" was not rejected by its auto-reviewer \u2014 rerun it instead.`);
+      }
+      const stepConfig = pipeline.steps[idx];
+      if (!stepConfig) {
+        throw new PipelineRunError3(`Pipeline mismatch \u2014 step "${(0, RunState_1.stepIdentity)(step)}" is at index ${idx}, which pipeline "${pipeline.id}" does not have.`);
+      }
+      if (!(0, WorkspaceSchema_1.normalizeStep)(stepConfig).auto_review) {
+        throw new PipelineRunError3(`Step "${step.agent}" no longer has auto_review enabled in pipeline "${pipeline.id}".`);
+      }
+      const next = clone(state);
+      next.steps[idx] = {
+        ...step,
+        status: "awaiting_auto_review",
+        rejectReason: void 0,
+        autoReviewVerdict: void 0
+      };
+      next.status = "running";
+      return next;
+    }
     function approveStep3(args) {
       const { pipeline } = args;
       const state = alignedOrThrow(args.state, pipeline);
@@ -21207,6 +21331,9 @@ var require_PipelineRunner = __commonJS({
         })
       };
       next.status = "running";
+      if (pipeline) {
+        settleOptionalRejection(next, idx, pipeline);
+      }
       return next;
     }
     function rerunStep3(args) {
@@ -21325,7 +21452,7 @@ var require_PipelineRunner = __commonJS({
       }
       const dagId = (i) => normalized[i].name ?? normalized[i].agent;
       const approvedDagIds = new Set(next.steps.filter((s) => s.status === "approved").map((s) => dagId(s.stepIdx)));
-      let openedAny = false;
+      const opened = [];
       for (let i = 0; i < normalized.length; i++) {
         const sStep = next.steps[i];
         if (sStep.status !== "pending") {
@@ -21344,25 +21471,47 @@ var require_PipelineRunner = __commonJS({
           status: "awaiting_work",
           startedAt: finishedAt
         };
-        openedAny = true;
-        if (next.currentStepIdx === idx) {
-          next.currentStepIdx = i;
-        }
+        opened.push(i);
       }
-      const allApproved = next.steps.every((s) => s.status === "approved");
-      if (allApproved) {
+      if ((0, runProgress_1.isRunComplete)(next, pipeline)) {
         next.status = "completed";
         return next;
       }
-      if (!openedAny) {
-        const stillActive = next.steps.findIndex((s) => s.status === "awaiting_work" || s.status === "awaiting_auto_review" || s.status === "awaiting_review");
-        if (stillActive >= 0) {
-          next.currentStepIdx = stillActive;
-        }
-      }
+      refocusCursor(next, opened);
       next.status = "running";
       return next;
     }
+    function refocusCursor(next, opened) {
+      const cur = next.steps[next.currentStepIdx];
+      if (cur && cur.status !== "approved" && cur.status !== "rejected") {
+        return;
+      }
+      const target = opened.length > 0 ? Math.min(...opened) : next.steps.findIndex((s) => (0, runProgress_1.isActiveStatus)(s.status));
+      if (target >= 0) {
+        next.currentStepIdx = target;
+      }
+    }
+    function settleOptionalRejection(next, idx, pipeline) {
+      if (!(0, runProgress_1.isStepOptional)(pipeline, idx)) {
+        return;
+      }
+      const normalized = pipeline.steps.map(WorkspaceSchema_1.normalizeStep);
+      const usesDag = normalized.some((s) => s.depends_on.length > 0);
+      if (!usesDag) {
+        const follower = next.steps[idx + 1];
+        if (follower && follower.status === "pending") {
+          next.steps[idx + 1] = {
+            ...follower,
+            status: "awaiting_work",
+            startedAt: (/* @__PURE__ */ new Date()).toISOString()
+          };
+        }
+      }
+      refocusCursor(next, []);
+      if ((0, runProgress_1.isRunComplete)(next, pipeline)) {
+        next.status = "completed";
+      }
+    }
     function clone(value) {
       return JSON.parse(JSON.stringify(value));
     }
@@ -25053,6 +25202,7 @@ var require_EpicScaffold = __commonJS({
     var fs14 = __importStar(require("fs"));
     var path17 = __importStar(require("path"));
     var PipelineRunner_1 = require_PipelineRunner();
+    var runProgress_1 = require_runProgress();
     var RunStateStore_1 = require_RunStateStore();
     var EpicPipelineStore_1 = require_EpicPipelineStore();
     var epicTags_1 = require_epicTags();
@@ -25100,7 +25250,9 @@ var require_EpicScaffold = __commonJS({
       } catch {
         return;
       }
-      const epicStatus = runState.status === "completed" ? "done" : runState.steps.some((s) => s.status === "rejected") ? "failed" : "in_progress";
+      const pipelines = Array.isArray(doc?.pipelines) ? doc.pipelines : [];
+      const pipeline = pipelines.find((p) => p.id === runState.pipelineId);
+      const epicStatus = (0, runProgress_1.deriveRunProgress)(runState, pipeline).status;
       const stepStates = runState.steps.map((s) => ({
         agent: s.agent,
         // The step's identity, mirrored alongside its agent so state.json says
@@ -29409,6 +29561,7 @@ var require_execEngine = __commonJS({
     var AutoReviewer_1 = require_AutoReviewer();
     var EpicArtifactCommit_1 = require_EpicArtifactCommit();
     var EpicScaffold_1 = require_EpicScaffold();
+    var runProgress_1 = require_runProgress();
     var budget_1 = require_budget();
     var pricing_1 = require_pricing();
     var models_1 = require_models();
@@ -29473,9 +29626,34 @@ var require_execEngine = __commonJS({
           return { kind: "awaiting_review" };
         }
         if (step.status === "rejected") {
+          const skippable = (0, runProgress_1.isStepOptional)(initialPipeline, state.currentStepIdx) || initialPipeline.on_failure === "continue";
+          const openElsewhere = state.steps.findIndex((s, i) => i !== state.currentStepIdx && (0, runProgress_1.isActiveStatus)(s.status));
+          if (skippable && openElsewhere >= 0) {
+            hooks.onStepSkipped?.({
+              stepIdx: state.currentStepIdx,
+              agent: step.agent,
+              reason: step.rejectReason ?? step.autoReviewVerdict?.reason ?? "rejected",
+              nextStepIdx: openElsewhere,
+              runId
+            });
+            RunStateStore_1.RunStateStore.save(root, { ...state, currentStepIdx: openElsewhere });
+            continue;
+          }
           hooks.onRejected?.({ agent: step.agent, runId });
           return { kind: "rejected" };
         }
+        if (step.status === "approved") {
+          const openElsewhere = state.steps.findIndex((s) => (0, runProgress_1.isActiveStatus)(s.status));
+          if (openElsewhere >= 0) {
+            RunStateStore_1.RunStateStore.save(root, { ...state, currentStepIdx: openElsewhere });
+            continue;
+          }
+          const parked = state.steps.find((s) => s.status === "rejected");
+          if (parked) {
+            hooks.onRejected?.({ agent: parked.agent, runId });
+            return { kind: "rejected" };
+          }
+        }
         if (step.status !== "awaiting_work") {
           hooks.onRunFailed?.(`Unexpected step status "${step.status}" \u2014 cannot exec.`);
           return { kind: "error" };
@@ -31320,6 +31498,7 @@ var require_commandModel = __commonJS({
     var strictMode_1 = require_strictMode();
     var commandBodyFreshness_1 = require_commandBodyFreshness();
     var WorkspaceSchema_1 = require_WorkspaceSchema();
+    var runProgress_1 = require_runProgress();
     exports2.CANONICAL_PHASES = [
       { id: "plan", name: "Plan", description: "Scaffold the epic and write the PRD.", artifact: "PRD.md" },
       { id: "prototype", name: "Prototype", description: "Propose the UI visually with multiple design options.", artifact: "PROTOTYPE.md" },
@@ -31386,14 +31565,14 @@ var require_commandModel = __commonJS({
       };
       const statusByDagId = /* @__PURE__ */ new Map();
       state.steps.forEach((s, idx) => statusByDagId.set(dagId(idx), s.status));
-      for (let i = 0; i < state.steps.length; i++) {
-        const st = state.steps[i].status;
-        if (st === "awaiting_work") {
-          return { index: i, phaseId: dagId(i), reason: "awaiting_work" };
-        }
-        if (st === "rejected") {
-          return { index: i, phaseId: dagId(i), reason: "rejected" };
-        }
+      const open = state.steps.findIndex((s) => s.status === "awaiting_work");
+      if (open >= 0) {
+        return { index: open, phaseId: dagId(open), reason: "awaiting_work" };
+      }
+      const optional = (i) => (0, runProgress_1.isStepOptional)(pipeline, i);
+      const blocked = state.steps.findIndex((s, i) => s.status === "rejected" && !optional(i));
+      if (blocked >= 0) {
+        return { index: blocked, phaseId: dagId(blocked), reason: "rejected" };
       }
       for (let i = 0; i < state.steps.length; i++) {
         if (state.steps[i].status !== "pending") {
@@ -31406,6 +31585,10 @@ var require_commandModel = __commonJS({
           return { index: i, phaseId: dagId(i), reason: "unblocked" };
         }
       }
+      const skipped = state.steps.findIndex((s, i) => s.status === "rejected" && optional(i));
+      if (skipped >= 0) {
+        return { index: skipped, phaseId: dagId(skipped), reason: "rejected" };
+      }
       return null;
     }
     function unprovisionedPhases(config, canonical = exports2.CANONICAL_PHASE_IDS) {
@@ -31445,10 +31628,12 @@ The first token is the **epic id**; an optional second token is the **phase**.
 - **If a phase was given**, use it. Validate it is a step in the epic's
   pipeline (see step 3). If it isn't, tell the user which phases the pipeline
   *does* have and stop.
-- **If no phase was given**, pick the **next eligible phase**: the first step
-  that is \`awaiting_work\`, else the first \`rejected\` step, else the first
-  \`pending\` step whose every \`depends_on\` is \`approved\`. If none is
-  actionable (all approved or paused for review), say so and stop.
+- **If no phase was given**, pick the **next eligible phase**, checking each
+  rule against every step before moving to the next rule: any step that is
+  \`awaiting_work\`, else any \`rejected\` step *not* marked \`optional: true\`,
+  else the first \`pending\` step whose every \`depends_on\` is \`approved\`, else
+  a \`rejected\` \`optional\` step. If none is actionable (all approved or
+  paused for review), say so and stop.
 
 ## 3. Resolve composition from the pipeline (never from the command name)
 
@@ -32037,9 +32222,9 @@ var require_dist = __commonJS({
     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 = exports2.SignalParseError = exports2.isSignal = exports2.parseSignal = exports2.SignalSchema = exports2.EpicStepEditError = exports2.resolveStepRef = exports2.describeGateEffect = exports2.commitEpicStepEdit = exports2.planSetEpicStepGates = exports2.planRemoveEpicStep = exports2.planAddEpicStep = 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.stepDagId = exports2.stepAgentId = exports2.normalizeStep = exports2.WorkspaceValidationError = exports2.validateWorkspace = exports2.WorkspaceSchema = void 0;
     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.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 = void 0;
     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.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.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 = void 0;
-    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.PipelineRunError = exports2.submitAutoReviewVerdict = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = 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 = void 0;
-    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 = exports2.planRecipeMigration = 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 = void 0;
+    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.isActiveStatus = exports2.isStepOptional = exports2.isRunComplete = exports2.deriveRunProgress = exports2.PipelineRunError = exports2.retryAutoReview = exports2.submitAutoReviewVerdict = exports2.requestStepUpdate = exports2.rerunStep = exports2.rejectStep = exports2.approveStep = 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 = void 0;
+    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 = exports2.planRecipeMigration = exports2.getBuiltinRecipeSummaries = exports2.getAllBuiltinPipelineSummaries = exports2.getSdlcBuiltinPipelineSummary = exports2.getBuiltinPipelineSummary = exports2.getBuiltinWorkflowByPipelineId = 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 = void 0;
     var WorkspaceSchema_1 = require_WorkspaceSchema();
     Object.defineProperty(exports2, "WorkspaceSchema", { enumerable: true, get: function() {
       return WorkspaceSchema_1.WorkspaceSchema;
@@ -32590,9 +32775,25 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "submitAutoReviewVerdict", { enumerable: true, get: function() {
       return PipelineRunner_1.submitAutoReviewVerdict;
     } });
+    Object.defineProperty(exports2, "retryAutoReview", { enumerable: true, get: function() {
+      return PipelineRunner_1.retryAutoReview;
+    } });
     Object.defineProperty(exports2, "PipelineRunError", { enumerable: true, get: function() {
       return PipelineRunner_1.PipelineRunError;
     } });
+    var runProgress_1 = require_runProgress();
+    Object.defineProperty(exports2, "deriveRunProgress", { enumerable: true, get: function() {
+      return runProgress_1.deriveRunProgress;
+    } });
+    Object.defineProperty(exports2, "isRunComplete", { enumerable: true, get: function() {
+      return runProgress_1.isRunComplete;
+    } });
+    Object.defineProperty(exports2, "isStepOptional", { enumerable: true, get: function() {
+      return runProgress_1.isStepOptional;
+    } });
+    Object.defineProperty(exports2, "isActiveStatus", { enumerable: true, get: function() {
+      return runProgress_1.isActiveStatus;
+    } });
     var budget_1 = require_budget();
     Object.defineProperty(exports2, "checkBudget", { enumerable: true, get: function() {
       return budget_1.checkBudget;
@@ -41595,7 +41796,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@delete101020/aidlc",
-      version: "4.0.7",
+      version: "4.0.10",
       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: {
@@ -46412,9 +46613,10 @@ function registerRun(program3) {
   cmd.command("reject <runId>").description("Reject the current awaiting_review step").requiredOption("--reason <text>", "Why the step was rejected").action((runId, opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     const state = requireRun(root, runId);
+    const pipeline = requirePipelineForRun(root, state);
     let next;
     try {
-      next = (0, import_core13.rejectStep)({ state, reason: opts.reason });
+      next = (0, import_core13.rejectStep)({ state, reason: opts.reason, pipeline });
     } catch (err) {
       console.error(import_chalk10.default.red(err instanceof Error ? err.message : String(err)));
       process.exit(1);
@@ -46425,18 +46627,23 @@ function registerRun(program3) {
     console.log(import_chalk10.default.dim(`  Reason: ${opts.reason}`));
     console.log(import_chalk10.default.dim(`  Rerun:  aidlc run rerun ${runId} [--feedback "..."]`));
   });
-  cmd.command("rerun <runId>").description("Retry the current rejected step (bumps revision, resets to awaiting_work)").option("--feedback <text>", "Notes for the next attempt (stored on the step)").action((runId, opts, actionCmd) => {
+  cmd.command("rerun <runId>").description("Retry a rejected step (bumps revision, resets to awaiting_work)").option("--feedback <text>", "Notes for the next attempt (stored on the step)").option("--step <idx>", "0-based step index (default: the run's current step)").action((runId, opts, actionCmd) => {
     const root = resolveWorkspaceRoot(actionCmd);
     const state = requireRun(root, runId);
+    const stepIdx = opts.step === void 0 ? void 0 : Number(opts.step);
+    if (stepIdx !== void 0 && !Number.isInteger(stepIdx)) {
+      console.error(import_chalk10.default.red(`--step must be an integer, got "${opts.step}"`));
+      process.exit(1);
+    }
     let next;
     try {
-      next = (0, import_core13.rerunStep)({ state, feedback: opts.feedback });
+      next = (0, import_core13.rerunStep)({ state, feedback: opts.feedback, stepIdx });
     } catch (err) {
       console.error(import_chalk10.default.red(err instanceof Error ? err.message : String(err)));
       process.exit(1);
     }
     saveRunState(root, next, state);
-    const step = next.steps[next.currentStepIdx];
+    const step = next.steps[stepIdx ?? next.currentStepIdx];
     console.log(import_chalk10.default.yellow("\u21BA") + ` Rerunning "${step.agent}" (rev ${step.revision})`);
     if (opts.feedback) {
       console.log(import_chalk10.default.dim(`  Feedback: ${opts.feedback}`));
@@ -46694,6 +46901,11 @@ ${reason}`)),
 \u2718  Step "${e.agent}" was rejected.`));
       info(import_chalk10.default.dim(`  Rerun: aidlc run rerun ${e.runId} [--feedback "..."]`));
     },
+    onStepSkipped: (e) => {
+      info(import_chalk10.default.yellow(`
+\u2933  Step "${e.agent}" was rejected \u2014 carrying on.`) + import_chalk10.default.dim(` ${e.reason}`));
+      info(import_chalk10.default.dim(`  Want it back? aidlc run rerun ${e.runId} --step ${e.stepIdx}`));
+    },
     onAutoReviewStart: (e) => info(import_chalk10.default.bold(`
 \u{1F50D}  Auto-review: "${e.agent}"`)),
     onAutoReviewResult: (e) => {

package/dist/templates/sdlc/validators/traceability.mjs

@@ -23,33 +23,45 @@
  * which can't resolve the package). Built-in profile rules are embedded; a
  * custom profile is read from .aidlc/profiles/<id>.yaml when js-yaml is
  * importable, else it is treated as enforce-nothing with a logged note.
+ *
+ * A profile carries its own section requirements: the built-ins embed theirs
+ * below, a custom profile declares them as `artifacts.<NAME>.mandatory_sections`
+ * in its manifest. The `mandatory-sections` rule checks the ACTIVE profile's
+ * list — never another profile's.
  */
 
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 
+// Sections the built-in `iso-ieee` profile requires, keyed by artifact file —
+// mirrors its `artifacts:` block in StandardProfile.ts. No other built-in turns
+// `mandatory-sections` on, so no other built-in needs a list.
+const ISO_IEEE_SECTIONS = {
+  'PRD.md': ['Problem & Goal', 'User Flow', 'Acceptance Criteria', 'Non-Functional Requirements', 'Dependencies'],
+  'TECH-DESIGN.md': ['Architecture', 'API', 'Data Model'],
+  'TEST-CASES.md': ['Test Cases'],
+};
+
 // Built-in profile traceability config — mirrors
 // packages/core/src/profiles/StandardProfile.ts. Keep in sync.
 const BUILTIN_TRACE = {
-  none: { enforce: false, rules: [] },
-  'agile-lite': { enforce: true, rules: ['ac-testable', 'ac-has-test'] },
-  hybrid: { enforce: true, rules: ['ac-testable', 'ac-has-test', 'tc-has-result', 'rtm-no-dangling'] },
+  none: { enforce: false, rules: [], sections: {} },
+  'agile-lite': { enforce: true, rules: ['ac-testable', 'ac-has-test'], sections: {} },
+  hybrid: {
+    enforce: true,
+    rules: ['ac-testable', 'ac-has-test', 'tc-has-result', 'rtm-no-dangling'],
+    sections: {},
+  },
   'iso-ieee': {
     enforce: true,
     rules: ['ac-testable', 'ac-has-test', 'tc-has-result', 'rtm-no-dangling', 'mandatory-sections'],
+    sections: ISO_IEEE_SECTIONS,
   },
 };
 
 // Vague phrases that make an acceptance criterion untestable (ac-testable).
 const VAGUE = [/should work well/i, /good ux/i, /feels fast/i, /as expected/i, /etc\.?$/im];
 
-// Mandatory sections checked under `mandatory-sections`, keyed by artifact file.
-const MANDATORY_SECTIONS = {
-  'PRD.md': ['Problem & Goal', 'User Flow', 'Acceptance Criteria', 'Non-Functional Requirements', 'Dependencies'],
-  'TECH-DESIGN.md': ['Architecture', 'API', 'Data Model'],
-  'TEST-CASES.md': ['Test Cases'],
-};
-
 // ── helpers ────────────────────────────────────────────────────────
 
 function readIfExists(p) {
@@ -83,6 +95,24 @@ function resolveStandardId(workspaceRoot, state) {
   return 'none';
 }
 
+/**
+ * A manifest's `artifacts:` block as this validator wants it — keyed by the
+ * artifact FILE name, since that is what we look for on disk. Manifests name
+ * artifacts without the extension (`PRD`, `TECH-DESIGN`), so add it; a key
+ * that already carries `.md` is left alone. An entry with no sections is
+ * dropped so an empty declaration can't masquerade as a real one.
+ */
+function sectionsFromManifest(doc) {
+  const artifacts = doc && typeof doc.artifacts === 'object' && doc.artifacts ? doc.artifacts : {};
+  const out = {};
+  for (const [name, rule] of Object.entries(artifacts)) {
+    const sections = rule && Array.isArray(rule.mandatory_sections) ? rule.mandatory_sections : [];
+    if (sections.length === 0) { continue; }
+    out[/\.md$/i.test(name) ? name : `${name}.md`] = sections;
+  }
+  return out;
+}
+
 /** Traceability config for an id — built-in embedded, custom via optional js-yaml read. */
 async function traceConfigFor(id, workspaceRoot, notes) {
   if (Object.prototype.hasOwnProperty.call(BUILTIN_TRACE, id)) { return BUILTIN_TRACE[id]; }
@@ -90,16 +120,29 @@ async function traceConfigFor(id, workspaceRoot, notes) {
   const text = readIfExists(manifest);
   if (!text) {
     notes.push(`custom profile "${id}" has no manifest at ${manifest} — enforcing nothing`);
-    return { enforce: false, rules: [] };
+    return { enforce: false, rules: [], sections: {} };
   }
   try {
     const yaml = await import('js-yaml');
     const doc = yaml.load(text) || {};
     const t = doc.traceability || {};
-    return { enforce: t.enforce === true, rules: Array.isArray(t.rules) ? t.rules : [] };
+    const cfg = {
+      enforce: t.enforce === true,
+      rules: Array.isArray(t.rules) ? t.rules : [],
+      sections: sectionsFromManifest(doc),
+    };
+    // Turning the rule on with nothing to check is silently vacuous — say so
+    // rather than let the profile look enforced when it isn't.
+    if (cfg.rules.includes('mandatory-sections') && Object.keys(cfg.sections).length === 0) {
+      notes.push(
+        `custom profile "${id}" enables mandatory-sections but declares no ` +
+          'artifacts.<NAME>.mandatory_sections — no sections checked',
+      );
+    }
+    return cfg;
   } catch {
     notes.push(`custom profile "${id}" present but js-yaml unavailable — enforcing nothing`);
-    return { enforce: false, rules: [] };
+    return { enforce: false, rules: [], sections: {} };
   }
 }
 
@@ -218,7 +261,7 @@ export default async function traceability(ctx) {
 
   // mandatory-sections — each present artifact carries the profile's required headings.
   if (trace.rules.includes('mandatory-sections')) {
-    for (const [file, sections] of Object.entries(MANDATORY_SECTIONS)) {
+    for (const [file, sections] of Object.entries(trace.sections || {})) {
       const found = firstExisting(artifactsDir, [file]);
       if (!found) { continue; }
       for (const s of sections) {

package/package.json

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