@xdevops/issue-auto-finish 1.0.81 → 1.0.82

package/dist/{chunk-S3ULUOTM.js → chunk-7D2NH37P.js}

@@ -528,6 +528,372 @@ var IssueState = /* @__PURE__ */ ((IssueState2) => {
   return IssueState2;
 })(IssueState || {});
 
+// src/lifecycle/ActionLifecycleManager.ts
+var ActionLifecycleManager = class {
+  /** IssueState → ActionState */
+  stateToAction;
+  /** "action:status" → IssueState */
+  actionToState;
+  /** phase name → { startState, doneState, approvedState? } */
+  phaseStatesMap;
+  /** Ordered phase indices by IssueState for determineResumePhaseIndex */
+  def;
+  constructor(def) {
+    this.def = def;
+    this.stateToAction = /* @__PURE__ */ new Map();
+    this.actionToState = /* @__PURE__ */ new Map();
+    this.phaseStatesMap = /* @__PURE__ */ new Map();
+    this.buildMappings(def);
+  }
+  buildMappings(def) {
+    this.addMapping("pending" /* Pending */, "init", "idle");
+    this.addMapping("skipped" /* Skipped */, "init", "skipped");
+    this.addMapping("branch_created" /* BranchCreated */, "init", "ready");
+    this.addMapping("failed" /* Failed */, "init", "failed");
+    this.addMapping("deployed" /* Deployed */, "init", "done");
+    this.addMapping("resolving_conflict" /* ResolvingConflict */, "conflict", "running");
+    for (const spec of def.phases) {
+      this.phaseStatesMap.set(spec.name, {
+        startState: spec.startState,
+        doneState: spec.doneState,
+        approvedState: spec.approvedState
+      });
+      if (spec.kind === "ai") {
+        if (spec.startState !== "phase_running" /* PhaseRunning */) {
+          this.addMapping(spec.startState, spec.name, "running");
+        }
+        if (spec.doneState === "completed" /* Completed */) {
+          this.addMapping(spec.doneState, spec.name, "done");
+        } else if (spec.doneState !== "phase_done" /* PhaseDone */) {
+          this.addMapping(spec.doneState, spec.name, "ready");
+        }
+      } else if (spec.kind === "gate") {
+        if (spec.startState !== "phase_waiting" /* PhaseWaiting */) {
+          this.addMapping(spec.startState, spec.name, "waiting");
+        }
+        if (spec.approvedState && spec.approvedState !== "phase_approved" /* PhaseApproved */) {
+          this.addMapping(spec.approvedState, spec.name, "ready");
+        }
+      }
+    }
+  }
+  addMapping(state, action, status) {
+    if (!this.stateToAction.has(state)) {
+      this.stateToAction.set(state, { action, status });
+    }
+    const key = `${action}:${status}`;
+    if (!this.actionToState.has(key)) {
+      this.actionToState.set(key, state);
+    }
+  }
+  // ─── Query API ───
+  /**
+   * 将 IssueState 解析为语义化的 ActionState。
+   *
+   * 对于通用状态 PhaseRunning/PhaseDone，需额外传入 currentPhase 来区分具体阶段。
+   */
+  resolve(state, currentPhase) {
+    if (state === "phase_running" /* PhaseRunning */ && currentPhase) {
+      return { action: currentPhase, status: "running" };
+    }
+    if (state === "phase_done" /* PhaseDone */ && currentPhase) {
+      return { action: currentPhase, status: "ready" };
+    }
+    if (state === "phase_waiting" /* PhaseWaiting */ && currentPhase) {
+      return { action: currentPhase, status: "waiting" };
+    }
+    if (state === "phase_approved" /* PhaseApproved */ && currentPhase) {
+      return { action: currentPhase, status: "ready" };
+    }
+    const mapped = this.stateToAction.get(state);
+    if (mapped) return mapped;
+    return { action: "init", status: "idle" };
+  }
+  /**
+   * 将 action + status 反向映射为 IssueState。
+   */
+  toIssueState(action, status) {
+    return this.actionToState.get(`${action}:${status}`);
+  }
+  // ─── Classification predicates (替代 3 个 Set 常量 + getDrivableIssues) ───
+  /**
+   * 终态：done | failed | skipped
+   */
+  isTerminal(state) {
+    const as = this.resolve(state);
+    return as.status === "done" || as.status === "failed" || as.status === "skipped";
+  }
+  /**
+   * 进行中：running (包含通用 PhaseRunning)
+   */
+  isInProgress(state) {
+    if (state === "phase_running" /* PhaseRunning */) return true;
+    return this.resolve(state).status === "running";
+  }
+  /**
+   * 阻塞中：waiting
+   */
+  isBlocked(state) {
+    if (state === "phase_waiting" /* PhaseWaiting */) return true;
+    return this.resolve(state).status === "waiting";
+  }
+  /**
+   * 可驱动判断（集中化 getDrivableIssues 的过滤逻辑）。
+   *
+   * - idle → 可驱动 (Pending)
+   * - ready → 可驱动 (BranchCreated, PhaseDone, PhaseApproved)
+   * - failed && attempts < maxRetries → 可驱动
+   * - waiting → 不可驱动 (PhaseWaiting)
+   * - running → 不可驱动（stalled 由外部叠加）
+   * - done/skipped → 不可驱动
+   */
+  isDrivable(state, attempts, maxRetries, lastErrorRetryable) {
+    if (state === "phase_done" /* PhaseDone */) return true;
+    if (state === "phase_approved" /* PhaseApproved */) return true;
+    if (state === "phase_running" /* PhaseRunning */) return false;
+    if (state === "phase_waiting" /* PhaseWaiting */) return false;
+    const as = this.resolve(state);
+    switch (as.status) {
+      case "idle":
+      case "ready":
+        return true;
+      case "failed":
+        if (lastErrorRetryable === false) return false;
+        return attempts < maxRetries;
+      case "waiting":
+      case "running":
+      case "done":
+      case "skipped":
+        return false;
+    }
+  }
+  // ─── Phase navigation (替代 determineStartIndex + getPhasePreState) ───
+  /**
+   * 确定从哪个阶段索引恢复执行（替代 PipelineOrchestrator.determineStartIndex）。
+   *
+   * 从后向前扫描 phases，匹配 currentState 或 failedAtState。
+   * 支持通用状态 PhaseRunning/PhaseDone + currentPhase 的组合。
+   */
+  determineResumePhaseIndex(currentState, failedAtState, currentPhase) {
+    const target = failedAtState || currentState;
+    const phases = this.def.phases;
+    if ((target === "phase_running" /* PhaseRunning */ || target === "phase_done" /* PhaseDone */) && currentPhase) {
+      const idx = phases.findIndex((p) => p.name === currentPhase);
+      if (idx >= 0) {
+        return target === "phase_done" /* PhaseDone */ ? idx + 1 : idx;
+      }
+    }
+    if ((target === "phase_waiting" /* PhaseWaiting */ || target === "phase_approved" /* PhaseApproved */) && currentPhase) {
+      const idx = phases.findIndex((p) => p.name === currentPhase);
+      if (idx >= 0) {
+        if (target === "phase_approved" /* PhaseApproved */) {
+          const spec = phases[idx];
+          return spec.kind === "ai" && spec.approvedState ? idx : idx + 1;
+        }
+        return idx;
+      }
+    }
+    for (let i = phases.length - 1; i >= 0; i--) {
+      const spec = phases[i];
+      if (spec.kind === "gate" && spec.approvedState === target) {
+        return i + 1;
+      }
+      if (spec.startState === target || spec.doneState === target) {
+        return spec.doneState === target ? i + 1 : i;
+      }
+    }
+    return 0;
+  }
+  /**
+   * 获取某个 phase 的前驱状态（即重置到该 phase 需要设置的状态）。
+   * 第一个 phase 的前驱是 BranchCreated；后续 phase 的前驱是上一个 phase 的 approvedState 或 doneState。
+   */
+  getPhasePreState(phaseName) {
+    const phases = this.def.phases;
+    const idx = phases.findIndex((p) => p.name === phaseName);
+    if (idx < 0) return void 0;
+    if (idx === 0) return "branch_created" /* BranchCreated */;
+    const prev = phases[idx - 1];
+    return prev.approvedState ?? prev.doneState;
+  }
+  /**
+   * 获取某个 phase 的状态三元组。
+   */
+  getPhaseStates(phaseName) {
+    return this.phaseStatesMap.get(phaseName);
+  }
+  // ─── Display helpers (替代 collectStateLabels + derivePhaseStatuses) ───
+  /**
+   * 解析单条状态的展示标签。
+   *
+   * 对通用状态 PhaseRunning/PhaseDone，需传入 currentPhase 以生成具体标签（如"分析中"）；
+   * 缺少 currentPhase 时回退到泛化标签（如"阶段执行中"）。
+   */
+  resolveLabel(state, currentPhase) {
+    if ((state === "phase_running" /* PhaseRunning */ || state === "phase_done" /* PhaseDone */) && currentPhase) {
+      const phaseLabel = t(`pipeline.phase.${currentPhase}`);
+      return state === "phase_running" /* PhaseRunning */ ? t("state.phaseDoing", { label: phaseLabel }) : t("state.phaseDone", { label: phaseLabel });
+    }
+    if ((state === "phase_waiting" /* PhaseWaiting */ || state === "phase_approved" /* PhaseApproved */) && currentPhase) {
+      const phaseLabel = t(`pipeline.phase.${currentPhase}`);
+      return state === "phase_waiting" /* PhaseWaiting */ ? t("state.phaseWaiting", { label: phaseLabel }) : t("state.phaseApproved", { label: phaseLabel });
+    }
+    const labels = this.collectStateLabels();
+    return labels.get(state) ?? state;
+  }
+  /**
+   * 收集所有状态及其展示标签。
+   * 为通用状态 PhaseRunning/PhaseDone 生成每个阶段的复合 key 条目。
+   */
+  collectStateLabels() {
+    const labels = /* @__PURE__ */ new Map();
+    labels.set("pending" /* Pending */, t("state.pending"));
+    labels.set("skipped" /* Skipped */, t("state.skipped"));
+    labels.set("branch_created" /* BranchCreated */, t("state.branchCreated"));
+    for (const phase of this.def.phases) {
+      const phaseLabel = t(`pipeline.phase.${phase.name}`);
+      if (phase.startState === "phase_running" /* PhaseRunning */) {
+        labels.set(`phase_running:${phase.name}`, t("state.phaseDoing", { label: phaseLabel }));
+      } else if (phase.startState === "phase_waiting" /* PhaseWaiting */) {
+        labels.set(`phase_waiting:${phase.name}`, t("state.phaseWaiting", { label: phaseLabel }));
+      } else {
+        labels.set(phase.startState, t("state.phaseDoing", { label: phaseLabel }));
+      }
+      if (phase.doneState === "phase_done" /* PhaseDone */) {
+        labels.set(`phase_done:${phase.name}`, t("state.phaseDone", { label: phaseLabel }));
+      } else if (phase.doneState === "phase_approved" /* PhaseApproved */) {
+        labels.set(`phase_approved:${phase.name}`, t("state.phaseApproved", { label: phaseLabel }));
+      } else if (phase.doneState !== "completed" /* Completed */) {
+        labels.set(phase.doneState, t("state.phaseDone", { label: phaseLabel }));
+      }
+      if (phase.approvedState && phase.approvedState !== "phase_approved" /* PhaseApproved */ && phase.approvedState !== phase.doneState) {
+        labels.set(phase.approvedState, t("state.phaseApproved", { label: phaseLabel }));
+      }
+    }
+    labels.set("completed" /* Completed */, t("state.completed"));
+    labels.set("failed" /* Failed */, t("state.failed"));
+    labels.set("resolving_conflict" /* ResolvingConflict */, t("state.resolvingConflict"));
+    return labels;
+  }
+  /**
+   * 根据当前 state，推导每个 phase 的进度状态。
+   * 支持通用状态 PhaseRunning/PhaseDone + currentPhase。
+   */
+  derivePhaseStatuses(currentState, currentPhase) {
+    const result = {};
+    let passedCurrent = false;
+    if (currentState === "failed" /* Failed */ && currentPhase) {
+      for (const phase of this.def.phases) {
+        if (passedCurrent) {
+          result[phase.name] = "pending";
+        } else if (phase.name === currentPhase) {
+          result[phase.name] = "failed";
+          passedCurrent = true;
+        } else {
+          result[phase.name] = "completed";
+        }
+      }
+      return result;
+    }
+    if ((currentState === "phase_running" /* PhaseRunning */ || currentState === "phase_done" /* PhaseDone */) && currentPhase) {
+      for (const phase of this.def.phases) {
+        if (passedCurrent) {
+          result[phase.name] = "pending";
+        } else if (phase.name === currentPhase) {
+          result[phase.name] = currentState === "phase_running" /* PhaseRunning */ ? "in_progress" : "completed";
+          passedCurrent = currentState === "phase_running" /* PhaseRunning */;
+          if (currentState === "phase_done" /* PhaseDone */) passedCurrent = true;
+        } else {
+          result[phase.name] = "completed";
+        }
+      }
+      return result;
+    }
+    if ((currentState === "phase_waiting" /* PhaseWaiting */ || currentState === "phase_approved" /* PhaseApproved */) && currentPhase) {
+      for (const phase of this.def.phases) {
+        if (passedCurrent) {
+          result[phase.name] = "pending";
+        } else if (phase.name === currentPhase) {
+          const isGatedAi = phase.kind === "ai" && phase.approvedState;
+          result[phase.name] = currentState === "phase_waiting" /* PhaseWaiting */ || currentState === "phase_approved" /* PhaseApproved */ && isGatedAi ? "in_progress" : "completed";
+          passedCurrent = true;
+        } else {
+          result[phase.name] = "completed";
+        }
+      }
+      return result;
+    }
+    if (currentState === "completed" /* Completed */ || currentState === "resolving_conflict" /* ResolvingConflict */) {
+      for (const phase of this.def.phases) {
+        result[phase.name] = "completed";
+      }
+      return result;
+    }
+    for (const phase of this.def.phases) {
+      if (passedCurrent) {
+        result[phase.name] = "pending";
+        continue;
+      }
+      if (phase.startState === currentState) {
+        result[phase.name] = "in_progress";
+        passedCurrent = true;
+      } else if (phase.doneState === currentState || phase.approvedState === currentState) {
+        result[phase.name] = "completed";
+      } else {
+        result[phase.name] = "pending";
+      }
+    }
+    return result;
+  }
+  // ─── Pipeline Protocol queries (P1) ───
+  /**
+   * 返回可被用户单独重试的阶段名列表。
+   * 优先使用 spec.retryable，未声明时默认 kind === 'ai'。
+   */
+  getRetryablePhases() {
+    return this.def.phases.filter((spec) => spec.retryable ?? spec.kind === "ai").map((spec) => spec.name);
+  }
+  /**
+   * 判断指定阶段是否可重试。
+   */
+  isRetryable(phaseName) {
+    const spec = this.def.phases.find((p) => p.name === phaseName);
+    if (!spec) return false;
+    return spec.retryable ?? spec.kind === "ai";
+  }
+  /**
+   * 查找 gate 类型的阶段。
+   */
+  getGatePhase() {
+    return this.def.phases.find((p) => p.kind === "gate");
+  }
+  /**
+   * 判断指定阶段完成后是否应启动预览服务器。
+   */
+  shouldDeployPreview(phaseName) {
+    const spec = this.def.phases.find((p) => p.name === phaseName);
+    return spec?.deploysPreview ?? false;
+  }
+  /**
+   * 收集所有阶段的产物文件，扁平化为单一列表。
+   */
+  collectArtifacts() {
+    return this.def.phases.flatMap((spec) => spec.artifacts ?? []);
+  }
+  /**
+   * 返回所有阶段的名称和标签（保持定义顺序）。
+   */
+  getPhaseDefs() {
+    return this.def.phases.map((p) => ({ name: p.name, label: p.label }));
+  }
+  /**
+   * 返回所有 kind === 'ai' 的阶段名（可执行阶段）。
+   */
+  getExecutablePhaseNames() {
+    return this.def.phases.filter((spec) => spec.kind === "ai").map((spec) => spec.name);
+  }
+};
+
 // src/tracker/IssueTracker.ts
 var logger5 = logger.child("IssueTracker");
 var STATE_MIGRATION_MAP = {
@@ -738,7 +1104,7 @@ var IssueTracker = class extends BaseTracker {
   resetToPhase(issueIid, phase, def) {
     const record = this.collection[this.key(issueIid)];
     if (!record) return false;
-    const lm = this.lifecycleManagers.get(def.mode) ?? this.lifecycleFor(record);
+    const lm = new ActionLifecycleManager(def);
     const targetState = lm.getPhasePreState(phase);
     if (!targetState) return false;
     record.state = targetState;
@@ -1341,1186 +1707,820 @@ ${t("basePhase.rulesSection", { rules: matchedRulesText })}` : basePrompt;
       });
       return this.runAI(displayId, fullPrompt, onInputRequired, void 0, ctx);
     }
-    return result;
-  }
-  /**
-   * 判断 AI 执行失败是否为永久性错误（不可重试）。
-   * 模型不存在、API key 无效等配置问题重试不会成功。
-   */
-  classifyRetryable(result) {
-    const msg = (result.errorMessage ?? result.output ?? "").toLowerCase();
-    const permanentPatterns = [
-      /model\b.*\b(?:not found|not supported|unavailable|service info not found)/,
-      /invalid.?api.?key/,
-      /authentication.*(?:failed|denied|error)/,
-      /permission.?denied/,
-      /billing/,
-      /quota.*exceeded/
-    ];
-    return !permanentPatterns.some((p) => p.test(msg));
-  }
-  /**
-   * Heuristic: a resume failure is typically an immediate process exit
-   * (exit code != 0, empty output) caused by an invalid/expired session ID.
-   */
-  isResumeFailure(result) {
-    if (result.success) return false;
-    const msg = (result.errorMessage ?? "").toLowerCase();
-    if (msg.includes("session") || msg.includes("resume") || msg.includes("session_id")) {
-      return true;
-    }
-    if (result.output.length === 0 && result.exitCode !== null && result.exitCode !== 0) {
-      const isConfigError = msg.includes("model") || msg.includes("api key") || msg.includes("authentication");
-      return !isConfigError;
-    }
-    return false;
-  }
-  persistSessionId(sessionId) {
-    if (sessionId) {
-      this.plan.updatePhaseSessionId(this.phaseName, sessionId);
-    }
-  }
-  // ── Hook dispatch methods ──
-  async notifyPhaseStart() {
-    await this.hooks.onPhaseStart(this.phaseName);
-  }
-  async notifyPhaseDone() {
-    await this.hooks.onPhaseDone(this.phaseName);
-  }
-  async notifyPhaseFailed(error) {
-    await this.hooks.onPhaseFailed(this.phaseName, error);
-  }
-  async notifyComment(message) {
-    try {
-      await this.hooks.onComment(message);
-    } catch (err) {
-      this.logger.warn("Hook onComment failed", { error: err.message });
-    }
-  }
-  /**
-   * Build an onInputRequired handler for ACP permission delegation.
-   * Only returns a handler when codebuddyAcpAutoApprove is false,
-   * enabling review gate delegation for permission requests.
-   */
-  buildInputRequiredHandler(displayId) {
-    if (this.config.ai.codebuddyAcpAutoApprove !== false) return void 0;
-    return (request) => {
-      if (request.type !== "plan-approval") {
-        return Promise.resolve("allow");
-      }
-      this.logger.info("ACP plan-approval requested, delegating to review gate", {
-        issueIid: displayId,
-        phase: this.phaseName
-      });
-      eventBus.emitTyped("review:requested", { issueIid: displayId });
-      return new Promise((resolve) => {
-        const onApproved = (payload) => {
-          const data = payload.data;
-          if (data.issueIid !== displayId) return;
-          cleanup();
-          this.logger.info("ACP plan-approval approved via review gate", { issueIid: displayId });
-          resolve("allow");
-        };
-        const onRejected = (payload) => {
-          const data = payload.data;
-          if (data.issueIid !== displayId) return;
-          cleanup();
-          this.logger.info("ACP plan-approval rejected via review gate", { issueIid: displayId });
-          resolve("reject");
-        };
-        const cleanup = () => {
-          eventBus.removeListener("review:approved", onApproved);
-          eventBus.removeListener("review:rejected", onRejected);
-        };
-        eventBus.on("review:approved", onApproved);
-        eventBus.on("review:rejected", onRejected);
-      });
-    };
-  }
-  async resolveRules(ctx) {
-    try {
-      const knowledge = getProjectKnowledge();
-      const resolver = new RuleResolver(knowledge?.ruleTriggers);
-      const context = `${ctx.demand.title} ${ctx.demand.description} ${ctx.demand.supplement ? JSON.stringify(ctx.demand.supplement) : ""}`;
-      if (ctx.workspace && ctx.workspace.repos.length > 1) {
-        for (const repo of ctx.workspace.repos) {
-          const rulesDir = path4.join(repo.gitRootDir, ".cursor", "rules");
-          try {
-            await resolver.loadRules(rulesDir);
-          } catch {
-          }
-        }
-      } else {
-        const rulesDir = path4.join(this.plan.baseDir, ".cursor", "rules");
-        await resolver.loadRules(rulesDir);
-      }
-      const matched = resolver.matchRules(context);
-      if (matched.length > 0) {
-        this.logger.info(`Matched ${matched.length} MDC rules`, {
-          rules: matched.map((r) => r.filename)
-        });
-        return resolver.formatForPrompt(matched);
-      }
-    } catch (err) {
-      this.logger.warn("Failed to resolve MDC rules", { error: err.message });
-    }
-    return null;
-  }
-  async syncResultToIssue(ctx, displayId) {
-    try {
-      const enabled = this.hooks.isNoteSyncEnabled();
-      const resultFiles = this.getResultFiles(ctx);
-      if (!enabled || resultFiles.length === 0) {
-        await this.notifyComment(
-          issueProgressComment(this.phaseName, "completed")
-        );
-        return;
-      }
-      const baseUrl = this.config.issueNoteSync.webBaseUrl.replace(/\/$/, "");
-      const phaseLabel = t(`phase.${this.phaseName}`) || this.phaseName;
-      const dashboardUrl = `${baseUrl}/?issue=${displayId}`;
-      for (const file of resultFiles) {
-        const content = this.readResultFile(displayId, file.filename);
-        if (!content) continue;
-        const summary = truncateToSummary(content);
-        const docUrl = `${baseUrl}/doc/${displayId}/${file.filename}`;
-        const comment = buildNoteSyncComment(
-          this.phaseName,
-          file.label || phaseLabel,
-          docUrl,
-          dashboardUrl,
-          summary
-        );
-        await this.notifyComment(comment);
-        this.logger.info("Result synced to issue", { issueIid: displayId, file: file.filename });
-      }
-    } catch (err) {
-      this.logger.warn("Failed to sync result to issue", { error: err.message });
-      await this.notifyComment(
-        issueProgressComment(this.phaseName, "completed")
-      );
-    }
-  }
-  readResultFile(issueIid, filename) {
-    const planDir = path4.join(this.plan.baseDir, ".claude-plan", `issue-${issueIid}`);
-    const filePath = path4.join(planDir, filename);
-    if (!fs3.existsSync(filePath)) return null;
-    try {
-      return fs3.readFileSync(filePath, "utf-8");
-    } catch {
-      return null;
-    }
-  }
-  async validatePhaseOutput(ctx, displayId) {
-    const resultFiles = this.getResultFiles(ctx);
-    if (resultFiles.length === 0) return;
-    const planDir = path4.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
-    const missing = [];
-    for (const file of resultFiles) {
-      const filePath = path4.join(planDir, file.filename);
-      if (!fs3.existsSync(filePath)) {
-        missing.push(file.filename);
-        continue;
-      }
-      const stat = fs3.statSync(filePath);
-      if (stat.size < _BasePhase.MIN_ARTIFACT_BYTES) {
-        missing.push(`${file.filename} (${stat.size} bytes, \u5185\u5BB9\u4E0D\u8DB3)`);
-      }
-    }
-    if (missing.length > 0) {
-      const msg = `AI \u8FDB\u7A0B\u6210\u529F\u9000\u51FA\u4F46\u672A\u751F\u6210\u9884\u671F\u4EA7\u7269: ${missing.join(", ")}`;
-      this.logger.error(msg, { phase: this.phaseName, displayId });
-      throw new AIExecutionError(this.phaseName, msg, { output: "", exitCode: 0 });
-    }
-  }
-  async commitPlanFiles(ctx, displayId) {
-    const commitMsg = `chore(auto): ${this.phaseName} phase completed for issue #${displayId}`;
-    if (ctx.workspace && ctx.workspace.repos.length > 1) {
-      for (const repo of ctx.workspace.repos) {
-        const repoGit = this.wtGitMap?.get(repo.name) ?? new GitOperations(repo.gitRootDir);
-        const branch = repo.branchPrefix ? `${repo.branchPrefix}-${displayId}` : ctx.branchName;
-        try {
-          if (await repoGit.hasChanges()) {
-            await repoGit.add(["."]);
-            await repoGit.commit(commitMsg);
-            await repoGit.push(branch);
-            this.logger.info("Committed changes for repo", { repo: repo.name, branch });
-          }
-        } catch (err) {
-          this.logger.warn("Failed to commit/push for repo", {
-            repo: repo.name,
-            error: err.message
-          });
-        }
-      }
-    } else {
-      if (await this.git.hasChanges()) {
-        await this.git.add(["."]);
-        await this.git.commit(commitMsg);
-        await this.git.push(ctx.branchName);
-      }
-    }
-  }
-};
-
-// src/phases/VerifyPhase.ts
-import fs4 from "fs";
-import path5 from "path";
-
-// src/verify/VerifyReportParser.ts
-var LINT_FAIL_RE = /\*{0,2}Lint\s*(?:结果|Result)\*{0,2}\s*[:：]\s*(?:失败|failed|fail|未通过)/i;
-var BUILD_FAIL_RE = /\*{0,2}Build\s*(?:结果|Result)\*{0,2}\s*[:：]\s*(?:失败|failed|fail|未通过)/i;
-var TEST_FAIL_RE = /\*{0,2}Test\s*(?:结果|Result)\*{0,2}\s*[:：]\s*(?:失败|failed|fail|未通过)/i;
-var SUMMARY_FAIL_RE = /\*{0,2}(?:总结|Summary)\*{0,2}\s*[:：].*(?:验证失败|verification\s+failed|failed|失败)/i;
-var TODOLIST_STATS_RE = /\*{0,2}(?:Todolist|Todo)\s*(?:检查|check)?\*{0,2}\s*[:：]\s*(\d+)\s*[/／]\s*(\d+)/i;
-var VerifyReportParser = class {
-  /**
-   * 解析验证报告内容。
-   *
-   * @param reportContent 验证报告的完整 Markdown 文本
-   */
-  parse(reportContent) {
-    const lintPassed = !LINT_FAIL_RE.test(reportContent);
-    const buildPassed = !BUILD_FAIL_RE.test(reportContent);
-    const testPassed = !TEST_FAIL_RE.test(reportContent);
-    const todolistStats = this.parseTodolistStats(reportContent);
-    const todolistComplete = todolistStats ? todolistStats.total === 0 || todolistStats.completed === todolistStats.total : true;
-    const failureReasons = [];
-    if (!lintPassed) failureReasons.push("Lint \u68C0\u67E5\u5931\u8D25");
-    if (!buildPassed) failureReasons.push("Build \u7F16\u8BD1\u5931\u8D25");
-    if (!testPassed) failureReasons.push("\u6D4B\u8BD5\u672A\u901A\u8FC7");
-    if (!todolistComplete) {
-      const statsText = todolistStats ? `(${todolistStats.completed}/${todolistStats.total})` : "";
-      failureReasons.push(`Todolist \u672A\u5168\u90E8\u5B8C\u6210${statsText}`);
-    }
-    const summaryFailed = SUMMARY_FAIL_RE.test(reportContent);
-    if (failureReasons.length === 0 && summaryFailed) {
-      failureReasons.push("\u9A8C\u8BC1\u62A5\u544A\u603B\u7ED3\u5224\u5B9A\u4E3A\u5931\u8D25");
-    }
-    const passed = failureReasons.length === 0;
-    return {
-      passed,
-      lintPassed,
-      buildPassed,
-      testPassed,
-      todolistComplete,
-      todolistStats: todolistStats ?? void 0,
-      failureReasons,
-      rawReport: reportContent
-    };
+    return result;
   }
   /**
-   * 从 plan 文件中解析 Todolist 完成度。
-   * 统计 `- [x]` (已完成) 和 `- [ ]` (未完成) 的数量。
+   * 判断 AI 执行失败是否为永久性错误（不可重试）。
+   * 模型不存在、API key 无效等配置问题重试不会成功。
    */
-  parseTodolistFromPlan(planContent) {
-    const completedRe = /^[ \t]*-\s+\[x\]/gim;
-    const uncompletedRe = /^[ \t]*-\s+\[\s\]/gm;
-    const completedMatches = planContent.match(completedRe);
-    const uncompletedMatches = planContent.match(uncompletedRe);
-    const completed = completedMatches?.length ?? 0;
-    const uncompleted = uncompletedMatches?.length ?? 0;
-    return {
-      completed,
-      total: completed + uncompleted
-    };
+  classifyRetryable(result) {
+    const msg = (result.errorMessage ?? result.output ?? "").toLowerCase();
+    const permanentPatterns = [
+      /model\b.*\b(?:not found|not supported|unavailable|service info not found)/,
+      /invalid.?api.?key/,
+      /authentication.*(?:failed|denied|error)/,
+      /permission.?denied/,
+      /billing/,
+      /quota.*exceeded/
+    ];
+    return !permanentPatterns.some((p) => p.test(msg));
   }
   /**
-   * 从报告中提取 Todolist 统计数据。
-   * 格式: "Todolist 检查: X/Y 项完成"
+   * Heuristic: a resume failure is typically an immediate process exit
+   * (exit code != 0, empty output) caused by an invalid/expired session ID.
    */
-  parseTodolistStats(reportContent) {
-    const match = reportContent.match(TODOLIST_STATS_RE);
-    if (match) {
-      return {
-        completed: parseInt(match[1], 10),
-        total: parseInt(match[2], 10)
-      };
+  isResumeFailure(result) {
+    if (result.success) return false;
+    const msg = (result.errorMessage ?? "").toLowerCase();
+    if (msg.includes("session") || msg.includes("resume") || msg.includes("session_id")) {
+      return true;
     }
-    return null;
-  }
-};
-
-// src/phases/VerifyPhase.ts
-var VerifyPhase = class extends BasePhase {
-  phaseName = "verify";
-  reportParser = new VerifyReportParser();
-  getResultFiles(ctx) {
-    const filename = ctx?.pipelineMode === "plan-mode" ? "02-verify-report.md" : "04-verify-report.md";
-    return [{ filename, label: "\u9A8C\u8BC1\u62A5\u544A" }];
-  }
-  async execute(ctx) {
-    const result = await super.execute(ctx);
-    if (result.success) {
-      const report = this.readVerifyReport(ctx);
-      if (report) {
-        const parsed = this.reportParser.parse(report);
-        if (this.config.verifyFixLoop.todolistCheckEnabled && !parsed.todolistStats) {
-          const planContent = this.readPlanFile(ctx);
-          if (planContent) {
-            const todoStats = this.reportParser.parseTodolistFromPlan(planContent);
-            if (todoStats.total > 0) {
-              parsed.todolistStats = todoStats;
-              parsed.todolistComplete = todoStats.completed === todoStats.total;
-              if (!parsed.todolistComplete) {
-                parsed.failureReasons.push(
-                  `Todolist \u672A\u5168\u90E8\u5B8C\u6210(${todoStats.completed}/${todoStats.total})`
-                );
-                parsed.passed = false;
-              }
-            }
-          }
-        }
-        this.logger.info("Verify report parsed", {
-          passed: parsed.passed,
-          lintPassed: parsed.lintPassed,
-          buildPassed: parsed.buildPassed,
-          testPassed: parsed.testPassed,
-          todolistComplete: parsed.todolistComplete,
-          todolistStats: parsed.todolistStats,
-          failureCount: parsed.failureReasons.length
-        });
-        return { ...result, verifyReport: parsed };
-      }
+    if (result.output.length === 0 && result.exitCode !== null && result.exitCode !== 0) {
+      const isConfigError = msg.includes("model") || msg.includes("api key") || msg.includes("authentication");
+      return !isConfigError;
     }
-    return result;
-  }
-  buildPrompt(ctx) {
-    const pc = demandToPromptContext(ctx.demand);
-    const promptCtx = {
-      issueTitle: pc.title,
-      issueDescription: pc.description,
-      issueIid: Number(pc.displayId),
-      workspace: ctx.workspace
-    };
-    return ctx.pipelineMode === "plan-mode" ? planModeVerifyPrompt(promptCtx) : verifyPrompt(promptCtx);
+    return false;
   }
-  readVerifyReport(ctx) {
-    const files = this.getResultFiles(ctx);
-    if (files.length === 0) return null;
-    const displayId = Number(ctx.demand.sourceRef.displayId);
-    const planDir = path5.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
-    const filePath = path5.join(planDir, files[0].filename);
-    if (!fs4.existsSync(filePath)) return null;
-    try {
-      return fs4.readFileSync(filePath, "utf-8");
-    } catch {
-      return null;
+  persistSessionId(sessionId) {
+    if (sessionId) {
+      this.plan.updatePhaseSessionId(this.phaseName, sessionId);
     }
   }
-  readPlanFile(ctx) {
-    const displayId = Number(ctx.demand.sourceRef.displayId);
-    const planDir = path5.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
-    const filePath = path5.join(planDir, "01-plan.md");
-    if (!fs4.existsSync(filePath)) return null;
-    try {
-      return fs4.readFileSync(filePath, "utf-8");
-    } catch {
-      return null;
-    }
+  // ── Hook dispatch methods ──
+  async notifyPhaseStart() {
+    await this.hooks.onPhaseStart(this.phaseName);
   }
-};
-
-// src/phases/PlanPhase.ts
-var PlanPhase = class extends BasePhase {
-  phaseName = "plan";
-  getResultFiles() {
-    return [{ filename: "01-plan.md", label: "\u5B9E\u65BD\u8BA1\u5212" }];
+  async notifyPhaseDone() {
+    await this.hooks.onPhaseDone(this.phaseName);
   }
-  getRunMode() {
-    return "plan";
+  async notifyPhaseFailed(error) {
+    await this.hooks.onPhaseFailed(this.phaseName, error);
   }
-  buildPrompt(ctx) {
-    const pc = demandToPromptContext(ctx.demand);
-    const history = this.plan.readReviewHistory();
-    const promptCtx = {
-      issueTitle: pc.title,
-      issueDescription: pc.description,
-      issueIid: Number(pc.displayId),
-      supplementText: pc.supplementText || void 0,
-      workspace: ctx.workspace
-    };
-    let basePrompt;
-    if (history.length > 0) {
-      basePrompt = rePlanPrompt(promptCtx, history);
-    } else {
-      basePrompt = planPrompt(promptCtx);
-    }
-    const caps = getRunnerCapabilities(this.config.ai.mode);
-    if (!caps?.nativePlanMode) {
-      basePrompt = `${t("prompt.planModeFallback")}
-
-${basePrompt}`;
+  async notifyComment(message) {
+    try {
+      await this.hooks.onComment(message);
+    } catch (err) {
+      this.logger.warn("Hook onComment failed", { error: err.message });
     }
-    return basePrompt;
   }
-};
-
-// src/phases/BuildPhase.ts
-var BuildPhase = class extends BasePhase {
-  phaseName = "build";
-  async validatePhaseOutput(ctx, _displayId) {
-    let hasAnyChanges = false;
-    if (ctx.workspace && ctx.workspace.repos.length > 1) {
-      for (const repo of ctx.workspace.repos) {
-        const repoGit = new GitOperations(repo.gitRootDir);
-        if (await repoGit.hasChanges()) {
-          hasAnyChanges = true;
-          break;
-        }
+  /**
+   * Build an onInputRequired handler for ACP permission delegation.
+   * Only returns a handler when codebuddyAcpAutoApprove is false,
+   * enabling review gate delegation for permission requests.
+   */
+  buildInputRequiredHandler(displayId) {
+    if (this.config.ai.codebuddyAcpAutoApprove !== false) return void 0;
+    return (request) => {
+      if (request.type !== "plan-approval") {
+        return Promise.resolve("allow");
       }
-    } else {
-      hasAnyChanges = await this.git.hasChanges();
-    }
-    if (!hasAnyChanges) {
-      const msg = "AI \u8FDB\u7A0B\u6210\u529F\u9000\u51FA\u4F46\u672A\u4EA7\u751F\u4EFB\u4F55\u4EE3\u7801\u53D8\u66F4";
-      this.logger.error(msg, { phase: this.phaseName });
-      throw new AIExecutionError(this.phaseName, msg, { output: "", exitCode: 0 });
-    }
-  }
-  buildPrompt(ctx) {
-    const pc = demandToPromptContext(ctx.demand);
-    const base = buildPrompt({
-      issueTitle: pc.title,
-      issueDescription: pc.description,
-      issueIid: Number(pc.displayId),
-      workspace: ctx.workspace
-    });
-    if (ctx.fixContext) {
-      return base + t("prompt.buildFixSuffix", {
-        iteration: ctx.fixContext.iteration,
-        failures: ctx.fixContext.verifyFailures.map((f, i) => `${i + 1}. ${f}`).join("\n"),
-        rawReport: ctx.fixContext.rawReport.slice(0, 2e3)
+      this.logger.info("ACP plan-approval requested, delegating to review gate", {
+        issueIid: displayId,
+        phase: this.phaseName
       });
-    }
-    return base;
-  }
-};
-
-// src/phases/ReleasePhase.ts
-import fs6 from "fs";
-import path7 from "path";
-
-// src/release/ReleaseDetectCache.ts
-import fs5 from "fs";
-import path6 from "path";
-import { createHash } from "crypto";
-var logger7 = logger.child("ReleaseDetectCache");
-function hashProjectPath(projectPath) {
-  return createHash("sha256").update(projectPath).digest("hex").slice(0, 16);
-}
-var ReleaseDetectCache = class {
-  cacheDir;
-  constructor(dataDir) {
-    this.cacheDir = path6.join(dataDir, "release-detect");
-  }
-  filePath(projectPath) {
-    return path6.join(this.cacheDir, `${hashProjectPath(projectPath)}.json`);
+      eventBus.emitTyped("review:requested", { issueIid: displayId });
+      return new Promise((resolve) => {
+        const onApproved = (payload) => {
+          const data = payload.data;
+          if (data.issueIid !== displayId) return;
+          cleanup();
+          this.logger.info("ACP plan-approval approved via review gate", { issueIid: displayId });
+          resolve("allow");
+        };
+        const onRejected = (payload) => {
+          const data = payload.data;
+          if (data.issueIid !== displayId) return;
+          cleanup();
+          this.logger.info("ACP plan-approval rejected via review gate", { issueIid: displayId });
+          resolve("reject");
+        };
+        const cleanup = () => {
+          eventBus.removeListener("review:approved", onApproved);
+          eventBus.removeListener("review:rejected", onRejected);
+        };
+        eventBus.on("review:approved", onApproved);
+        eventBus.on("review:rejected", onRejected);
+      });
+    };
   }
-  /**
-   * 读取缓存。返回 null 如果不存在、已过期或校验失败。
-   */
-  get(projectPath, ttlMs) {
-    const fp = this.filePath(projectPath);
+  async resolveRules(ctx) {
     try {
-      if (!fs5.existsSync(fp)) return null;
-      const raw = fs5.readFileSync(fp, "utf-8");
-      const data = JSON.parse(raw);
-      if (data.projectPath !== projectPath) {
-        logger7.warn("Cache projectPath mismatch, ignoring", { expected: projectPath, got: data.projectPath });
-        return null;
+      const knowledge = getProjectKnowledge();
+      const resolver = new RuleResolver(knowledge?.ruleTriggers);
+      const context = `${ctx.demand.title} ${ctx.demand.description} ${ctx.demand.supplement ? JSON.stringify(ctx.demand.supplement) : ""}`;
+      if (ctx.workspace && ctx.workspace.repos.length > 1) {
+        for (const repo of ctx.workspace.repos) {
+          const rulesDir = path4.join(repo.gitRootDir, ".cursor", "rules");
+          try {
+            await resolver.loadRules(rulesDir);
+          } catch {
+          }
+        }
+      } else {
+        const rulesDir = path4.join(this.plan.baseDir, ".cursor", "rules");
+        await resolver.loadRules(rulesDir);
       }
-      const age = Date.now() - new Date(data.detectedAt).getTime();
-      if (age > ttlMs) {
-        logger7.debug("Cache expired", { projectPath, ageMs: age, ttlMs });
-        return null;
+      const matched = resolver.matchRules(context);
+      if (matched.length > 0) {
+        this.logger.info(`Matched ${matched.length} MDC rules`, {
+          rules: matched.map((r) => r.filename)
+        });
+        return resolver.formatForPrompt(matched);
       }
-      return data;
     } catch (err) {
-      logger7.warn("Failed to read release detect cache", { path: fp, error: err.message });
-      return null;
+      this.logger.warn("Failed to resolve MDC rules", { error: err.message });
     }
+    return null;
   }
-  /**
-   * 写入缓存。
-   */
-  set(result) {
-    const fp = this.filePath(result.projectPath);
+  async syncResultToIssue(ctx, displayId) {
     try {
-      if (!fs5.existsSync(this.cacheDir)) {
-        fs5.mkdirSync(this.cacheDir, { recursive: true });
+      const enabled = this.hooks.isNoteSyncEnabled();
+      const resultFiles = this.getResultFiles(ctx);
+      if (!enabled || resultFiles.length === 0) {
+        await this.notifyComment(
+          issueProgressComment(this.phaseName, "completed")
+        );
+        return;
+      }
+      const baseUrl = this.config.issueNoteSync.webBaseUrl.replace(/\/$/, "");
+      const phaseLabel = t(`phase.${this.phaseName}`) || this.phaseName;
+      const dashboardUrl = `${baseUrl}/?issue=${displayId}`;
+      for (const file of resultFiles) {
+        const content = this.readResultFile(displayId, file.filename);
+        if (!content) continue;
+        const summary = truncateToSummary(content);
+        const docUrl = `${baseUrl}/doc/${displayId}/${file.filename}`;
+        const comment = buildNoteSyncComment(
+          this.phaseName,
+          file.label || phaseLabel,
+          docUrl,
+          dashboardUrl,
+          summary
+        );
+        await this.notifyComment(comment);
+        this.logger.info("Result synced to issue", { issueIid: displayId, file: file.filename });
       }
-      fs5.writeFileSync(fp, JSON.stringify(result, null, 2), "utf-8");
-      logger7.debug("Release detect cache written", { projectPath: result.projectPath, path: fp });
     } catch (err) {
-      logger7.warn("Failed to write release detect cache", { path: fp, error: err.message });
+      this.logger.warn("Failed to sync result to issue", { error: err.message });
+      await this.notifyComment(
+        issueProgressComment(this.phaseName, "completed")
+      );
     }
   }
-  /**
-   * 手动失效缓存。
-   */
-  invalidate(projectPath) {
-    const fp = this.filePath(projectPath);
+  readResultFile(issueIid, filename) {
+    const planDir = path4.join(this.plan.baseDir, ".claude-plan", `issue-${issueIid}`);
+    const filePath = path4.join(planDir, filename);
+    if (!fs3.existsSync(filePath)) return null;
     try {
-      if (fs5.existsSync(fp)) {
-        fs5.unlinkSync(fp);
-        logger7.info("Release detect cache invalidated", { projectPath });
-        return true;
+      return fs3.readFileSync(filePath, "utf-8");
+    } catch {
+      return null;
+    }
+  }
+  async validatePhaseOutput(ctx, displayId) {
+    const resultFiles = this.getResultFiles(ctx);
+    if (resultFiles.length === 0) return;
+    const planDir = path4.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
+    const missing = [];
+    for (const file of resultFiles) {
+      const filePath = path4.join(planDir, file.filename);
+      if (!fs3.existsSync(filePath)) {
+        missing.push(file.filename);
+        continue;
       }
-      return false;
-    } catch (err) {
-      logger7.warn("Failed to invalidate release detect cache", { path: fp, error: err.message });
-      return false;
+      const stat = fs3.statSync(filePath);
+      if (stat.size < _BasePhase.MIN_ARTIFACT_BYTES) {
+        missing.push(`${file.filename} (${stat.size} bytes, \u5185\u5BB9\u4E0D\u8DB3)`);
+      }
+    }
+    if (missing.length > 0) {
+      const msg = `AI \u8FDB\u7A0B\u6210\u529F\u9000\u51FA\u4F46\u672A\u751F\u6210\u9884\u671F\u4EA7\u7269: ${missing.join(", ")}`;
+      this.logger.error(msg, { phase: this.phaseName, displayId });
+      throw new AIExecutionError(this.phaseName, msg, { output: "", exitCode: 0 });
     }
   }
-};
-
-// src/prompts/release-templates.ts
-function releaseDetectPrompt(ctx) {
-  const pd = `.claude-plan/issue-${ctx.issueIid}`;
-  return `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 DevOps \u5206\u6790\u5E08\u3002\u4F60\u7684\u4EFB\u52A1\u662F\u63A2\u7D22\u5F53\u524D\u9879\u76EE\uFF0C\u67E5\u627E\u6240\u6709\u4E0E**\u53D1\u5E03/\u90E8\u7F72**\u76F8\u5173\u7684\u673A\u5236\u3002
-
-## \u63A2\u7D22\u8303\u56F4
-
-\u8BF7\u6309\u4F18\u5148\u7EA7\u4F9D\u6B21\u68C0\u67E5\u4EE5\u4E0B\u4F4D\u7F6E\uFF1A
-
-1. **Skill \u6587\u4EF6**
-   - \`.cursor/skills/\` \u76EE\u5F55\u4E0B\u4E0E release/deploy/publish \u76F8\u5173\u7684 skill
-   - \u9879\u76EE\u6839\u76EE\u5F55\u7684 \`SKILL.md\` \u6216 \`release.md\`
-
-2. **Rule \u6587\u4EF6**
-   - \`.cursor/rules/\` \u76EE\u5F55\u4E0B\u4E0E release/deploy \u76F8\u5173\u7684 \`.mdc\` \u89C4\u5219
-
-3. **CI/CD \u914D\u7F6E**
-   - \`.gitlab-ci.yml\` / \`Jenkinsfile\` / \`.github/workflows/\`
-   - \u67E5\u627E release/deploy/publish \u76F8\u5173\u7684 stage/job/workflow
-
-4. **Package Manager**
-   - \`package.json\` \u4E2D\u7684 \`scripts\` \u5B57\u6BB5\uFF1Apublish\u3001release\u3001deploy \u7B49
-   - \`Makefile\` \u4E2D\u7684 release/deploy target
-
-5. **\u811A\u672C\u4E0E\u6587\u6863**
-   - \`scripts/release.*\`\u3001\`scripts/deploy.*\`\u3001\`scripts/publish.*\`
-   - \`RELEASE.md\`\u3001\`CHANGELOG.md\`\u3001\`CONTRIBUTING.md\` \u4E2D\u7684\u53D1\u5E03\u8BF4\u660E
-   - \`Dockerfile\`\u3001\`docker-compose*.yml\`
-
-## \u8F93\u51FA\u8981\u6C42
-
-\u5C06\u68C0\u6D4B\u7ED3\u679C\u4EE5 **\u4E25\u683C JSON** \u683C\u5F0F\u5199\u5165 \`${pd}/03-release-detect.json\`\uFF1A
-
-\`\`\`json
-{
-  "hasReleaseCapability": true,
-  "releaseMethod": "npm-publish",
-  "artifacts": ["package.json", ".gitlab-ci.yml"],
-  "instructions": "\u8FD0\u884C npm publish \u53D1\u5E03\u5230 npm registry..."
-}
-\`\`\`
-
-\u5B57\u6BB5\u8BF4\u660E\uFF1A
-- \`hasReleaseCapability\`: \u662F\u5426\u627E\u5230\u53D1\u5E03\u673A\u5236\uFF08boolean\uFF09
-- \`releaseMethod\`: \u53D1\u5E03\u65B9\u5F0F\uFF0C\u53EF\u9009\u503C\uFF1A"npm-publish" | "ci-pipeline" | "makefile" | "custom-script" | "skill" | "docker" | \u5176\u4ED6\u63CF\u8FF0
-- \`artifacts\`: \u53D1\u73B0\u7684\u53D1\u5E03\u76F8\u5173\u6587\u4EF6\u8DEF\u5F84\u6570\u7EC4
-- \`instructions\`: \u4ECE\u6587\u4EF6\u4E2D\u63D0\u53D6\u7684\u53D1\u5E03\u6B65\u9AA4\u8BF4\u660E\u3002\u5982\u679C\u662F skill/rule \u6587\u4EF6\uFF0C\u8BF7\u5B8C\u6574\u590D\u5236\u5176\u5185\u5BB9
-
-**\u91CD\u8981**\uFF1A
-- \u5982\u679C\u6CA1\u6709\u627E\u5230\u4EFB\u4F55\u53D1\u5E03\u673A\u5236\uFF0C\u5C06 \`hasReleaseCapability\` \u8BBE\u4E3A \`false\`\uFF0C\u5176\u4ED6\u5B57\u6BB5\u53EF\u7701\u7565
-- \u5982\u679C\u627E\u5230\u4E86 skill \u6216 rule \u6587\u4EF6\uFF0C\u8BF7\u5728 \`instructions\` \u4E2D\u5B8C\u6574\u4FDD\u7559\u539F\u6587\u5185\u5BB9\uFF0C\u540E\u7EED\u53D1\u5E03\u6267\u884C\u5C06\u4F9D\u8D56\u5B83
-- \u53EA\u8F93\u51FA JSON \u6587\u4EF6\uFF0C\u4E0D\u8981\u6267\u884C\u4EFB\u4F55\u53D1\u5E03\u64CD\u4F5C`;
-}
-function releaseExecPrompt(ctx, detectResult) {
-  const pd = `.claude-plan/issue-${ctx.issueIid}`;
-  const artifactList = detectResult.artifacts.length > 0 ? detectResult.artifacts.map((a) => `- \`${a}\``).join("\n") : "\uFF08\u65E0\uFF09";
-  const instructionSection = detectResult.instructions ? `
-## \u53D1\u5E03\u6307\u5F15\uFF08\u6765\u81EA\u9879\u76EE skill/rule/\u6587\u6863\uFF09
-
-${detectResult.instructions}` : "";
-  return `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684\u53D1\u5E03\u5DE5\u7A0B\u5E08\u3002\u8BF7\u6839\u636E\u4EE5\u4E0B\u68C0\u6D4B\u7ED3\u679C\uFF0C\u6267\u884C\u9879\u76EE\u7684\u53D1\u5E03\u6D41\u7A0B\u3002
-
-## \u68C0\u6D4B\u7ED3\u679C
-
-- **\u53D1\u5E03\u65B9\u5F0F**: ${detectResult.releaseMethod ?? "\u672A\u77E5"}
-- **\u76F8\u5173\u6587\u4EF6**:
-${artifactList}
-${instructionSection}
-
-## \u4EFB\u52A1
-
-1. \u9605\u8BFB\u4E0A\u8FF0\u53D1\u5E03\u6307\u5F15\u548C\u76F8\u5173\u6587\u4EF6
-2. \u6309\u7167\u9879\u76EE\u5B9A\u4E49\u7684\u53D1\u5E03\u6D41\u7A0B\u6267\u884C\u53D1\u5E03\u64CD\u4F5C
-3. \u5C06\u53D1\u5E03\u7ED3\u679C\u5199\u5165 \`${pd}/04-release-report.md\`
-
-## \u53D1\u5E03\u62A5\u544A\u683C\u5F0F
-
-\`\`\`markdown
-# \u53D1\u5E03\u62A5\u544A
-
-## \u53D1\u5E03\u65B9\u5F0F
-<\u4F7F\u7528\u7684\u53D1\u5E03\u65B9\u5F0F>
-
-## \u6267\u884C\u6B65\u9AA4
-<\u9010\u6B65\u8BB0\u5F55\u6267\u884C\u7684\u64CD\u4F5C>
-
-## \u7ED3\u679C
-<\u6210\u529F/\u5931\u8D25\u53CA\u8BE6\u60C5>
-\`\`\`
+  async commitPlanFiles(ctx, displayId) {
+    const commitMsg = `chore(auto): ${this.phaseName} phase completed for issue #${displayId}`;
+    if (ctx.workspace && ctx.workspace.repos.length > 1) {
+      for (const repo of ctx.workspace.repos) {
+        const repoGit = this.wtGitMap?.get(repo.name) ?? new GitOperations(repo.gitRootDir);
+        const branch = repo.branchPrefix ? `${repo.branchPrefix}-${displayId}` : ctx.branchName;
+        try {
+          if (await repoGit.hasChanges()) {
+            await repoGit.add(["."]);
+            await repoGit.commit(commitMsg);
+            await repoGit.push(branch);
+            this.logger.info("Committed changes for repo", { repo: repo.name, branch });
+          }
+        } catch (err) {
+          this.logger.warn("Failed to commit/push for repo", {
+            repo: repo.name,
+            error: err.message
+          });
+        }
+      }
+    } else {
+      if (await this.git.hasChanges()) {
+        await this.git.add(["."]);
+        await this.git.commit(commitMsg);
+        await this.git.push(ctx.branchName);
+      }
+    }
+  }
+};
 
-**\u91CD\u8981**\uFF1A
-- \u4E25\u683C\u6309\u7167\u9879\u76EE\u81EA\u8EAB\u7684\u53D1\u5E03\u6D41\u7A0B\u64CD\u4F5C
-- \u5982\u6709\u4EFB\u4F55\u9519\u8BEF\u6216\u5F02\u5E38\uFF0C\u8BB0\u5F55\u5728\u62A5\u544A\u4E2D
-- \u4E0D\u8981\u8DF3\u8FC7\u4EFB\u4F55\u53D1\u5E03\u524D\u7684\u68C0\u67E5\u6B65\u9AA4`;
-}
+// src/phases/VerifyPhase.ts
+import fs4 from "fs";
+import path5 from "path";
 
-// src/phases/ReleasePhase.ts
-var logger8 = logger.child("ReleasePhase");
-var DETECT_FILENAME = "05-release-detect.json";
-var REPORT_FILENAME = "06-release-report.md";
-var ReleasePhase = class extends BasePhase {
-  phaseName = "release";
-  get planDir() {
-    const displayId = Number(this.currentCtx?.demand.sourceRef.displayId ?? 0);
-    return path7.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
+// src/verify/VerifyReportParser.ts
+var LINT_FAIL_RE = /\*{0,2}Lint\s*(?:结果|Result)\*{0,2}\s*[:：]\s*(?:失败|failed|fail|未通过)/i;
+var BUILD_FAIL_RE = /\*{0,2}Build\s*(?:结果|Result)\*{0,2}\s*[:：]\s*(?:失败|failed|fail|未通过)/i;
+var TEST_FAIL_RE = /\*{0,2}Test\s*(?:结果|Result)\*{0,2}\s*[:：]\s*(?:失败|failed|fail|未通过)/i;
+var SUMMARY_FAIL_RE = /\*{0,2}(?:总结|Summary)\*{0,2}\s*[:：].*(?:验证失败|verification\s+failed|failed|失败)/i;
+var TODOLIST_STATS_RE = /\*{0,2}(?:Todolist|Todo)\s*(?:检查|check)?\*{0,2}\s*[:：]\s*(\d+)\s*[/／]\s*(\d+)/i;
+var VerifyReportParser = class {
+  /**
+   * 解析验证报告内容。
+   *
+   * @param reportContent 验证报告的完整 Markdown 文本
+   */
+  parse(reportContent) {
+    const lintPassed = !LINT_FAIL_RE.test(reportContent);
+    const buildPassed = !BUILD_FAIL_RE.test(reportContent);
+    const testPassed = !TEST_FAIL_RE.test(reportContent);
+    const todolistStats = this.parseTodolistStats(reportContent);
+    const todolistComplete = todolistStats ? todolistStats.total === 0 || todolistStats.completed === todolistStats.total : true;
+    const failureReasons = [];
+    if (!lintPassed) failureReasons.push("Lint \u68C0\u67E5\u5931\u8D25");
+    if (!buildPassed) failureReasons.push("Build \u7F16\u8BD1\u5931\u8D25");
+    if (!testPassed) failureReasons.push("\u6D4B\u8BD5\u672A\u901A\u8FC7");
+    if (!todolistComplete) {
+      const statsText = todolistStats ? `(${todolistStats.completed}/${todolistStats.total})` : "";
+      failureReasons.push(`Todolist \u672A\u5168\u90E8\u5B8C\u6210${statsText}`);
+    }
+    const summaryFailed = SUMMARY_FAIL_RE.test(reportContent);
+    if (failureReasons.length === 0 && summaryFailed) {
+      failureReasons.push("\u9A8C\u8BC1\u62A5\u544A\u603B\u7ED3\u5224\u5B9A\u4E3A\u5931\u8D25");
+    }
+    const passed = failureReasons.length === 0;
+    return {
+      passed,
+      lintPassed,
+      buildPassed,
+      testPassed,
+      todolistComplete,
+      todolistStats: todolistStats ?? void 0,
+      failureReasons,
+      rawReport: reportContent
+    };
   }
-  /** 暂存当前 ctx 供 planDir getter 使用 */
-  currentCtx;
   /**
-   * 检测结果是否已存在（即是否处于执行模式）。
+   * 从 plan 文件中解析 Todolist 完成度。
+   * 统计 `- [x]` (已完成) 和 `- [ ]` (未完成) 的数量。
    */
-  hasDetectionResult() {
-    return fs6.existsSync(path7.join(this.planDir, DETECT_FILENAME));
+  parseTodolistFromPlan(planContent) {
+    const completedRe = /^[ \t]*-\s+\[x\]/gim;
+    const uncompletedRe = /^[ \t]*-\s+\[\s\]/gm;
+    const completedMatches = planContent.match(completedRe);
+    const uncompletedMatches = planContent.match(uncompletedRe);
+    const completed = completedMatches?.length ?? 0;
+    const uncompleted = uncompletedMatches?.length ?? 0;
+    return {
+      completed,
+      total: completed + uncompleted
+    };
   }
-  readDetectionFile() {
-    const fp = path7.join(this.planDir, DETECT_FILENAME);
-    if (!fs6.existsSync(fp)) return null;
-    try {
-      return JSON.parse(fs6.readFileSync(fp, "utf-8"));
-    } catch {
-      return null;
+  /**
+   * 从报告中提取 Todolist 统计数据。
+   * 格式: "Todolist 检查: X/Y 项完成"
+   */
+  parseTodolistStats(reportContent) {
+    const match = reportContent.match(TODOLIST_STATS_RE);
+    if (match) {
+      return {
+        completed: parseInt(match[1], 10),
+        total: parseInt(match[2], 10)
+      };
     }
+    return null;
   }
-  writeDetectionFile(result) {
-    const dir = this.planDir;
-    if (!fs6.existsSync(dir)) {
-      fs6.mkdirSync(dir, { recursive: true });
-    }
-    fs6.writeFileSync(path7.join(dir, DETECT_FILENAME), JSON.stringify(result, null, 2), "utf-8");
+};
+
+// src/phases/VerifyPhase.ts
+var VerifyPhase = class extends BasePhase {
+  phaseName = "verify";
+  reportParser = new VerifyReportParser();
+  getResultFiles(ctx) {
+    const filename = ctx?.pipelineMode === "plan-mode" ? "02-verify-report.md" : "04-verify-report.md";
+    return [{ filename, label: "\u9A8C\u8BC1\u62A5\u544A" }];
   }
-  getResultFiles(_ctx) {
-    if (this.hasDetectionResult()) {
-      return [{ filename: REPORT_FILENAME, label: "\u53D1\u5E03\u62A5\u544A" }];
+  async execute(ctx) {
+    const result = await super.execute(ctx);
+    if (result.success) {
+      const report = this.readVerifyReport(ctx);
+      if (report) {
+        const parsed = this.reportParser.parse(report);
+        if (this.config.verifyFixLoop.todolistCheckEnabled && !parsed.todolistStats) {
+          const planContent = this.readPlanFile(ctx);
+          if (planContent) {
+            const todoStats = this.reportParser.parseTodolistFromPlan(planContent);
+            if (todoStats.total > 0) {
+              parsed.todolistStats = todoStats;
+              parsed.todolistComplete = todoStats.completed === todoStats.total;
+              if (!parsed.todolistComplete) {
+                parsed.failureReasons.push(
+                  `Todolist \u672A\u5168\u90E8\u5B8C\u6210(${todoStats.completed}/${todoStats.total})`
+                );
+                parsed.passed = false;
+              }
+            }
+          }
+        }
+        this.logger.info("Verify report parsed", {
+          passed: parsed.passed,
+          lintPassed: parsed.lintPassed,
+          buildPassed: parsed.buildPassed,
+          testPassed: parsed.testPassed,
+          todolistComplete: parsed.todolistComplete,
+          todolistStats: parsed.todolistStats,
+          failureCount: parsed.failureReasons.length
+        });
+        return { ...result, verifyReport: parsed };
+      }
     }
-    return [{ filename: DETECT_FILENAME, label: "\u53D1\u5E03\u68C0\u6D4B\u62A5\u544A" }];
+    return result;
   }
   buildPrompt(ctx) {
-    const dc = demandToPromptContext(ctx.demand);
-    const pc = {
-      issueTitle: dc.title,
-      issueDescription: dc.description,
-      issueIid: Number(dc.displayId),
-      supplementText: dc.supplementText || void 0,
+    const pc = demandToPromptContext(ctx.demand);
+    const promptCtx = {
+      issueTitle: pc.title,
+      issueDescription: pc.description,
+      issueIid: Number(pc.displayId),
       workspace: ctx.workspace
     };
-    if (this.hasDetectionResult()) {
-      const detect = this.readDetectionFile();
-      return releaseExecPrompt(pc, detect);
-    }
-    return releaseDetectPrompt(pc);
+    return ctx.pipelineMode === "plan-mode" ? planModeVerifyPrompt(promptCtx) : verifyPrompt(promptCtx);
   }
-  async execute(ctx) {
-    this.currentCtx = ctx;
-    const isDetect = !this.hasDetectionResult();
-    if (isDetect) {
-      const cache = new ReleaseDetectCache(resolveDataDir());
-      const projectPath = this.config.gongfeng.projectPath;
-      const ttlMs = this.config.release.detectCacheTtlMs;
-      const cached = cache.get(projectPath, ttlMs);
-      if (cached) {
-        logger8.info("Using cached release detection result", {
-          projectPath,
-          hasCapability: cached.hasReleaseCapability,
-          method: cached.releaseMethod
-        });
-        await this.hooks.onPhaseStart(this.phaseName);
-        this.writeDetectionFile(cached);
-        this.plan.updatePhaseProgress(this.phaseName, "completed");
-        try {
-          await this.git.add(["."]);
-          await this.git.commit(`chore: release detection (cached) for issue-${ctx.demand.sourceRef.displayId}`);
-        } catch {
-        }
-        await this.hooks.onPhaseDone(this.phaseName);
-        return {
-          success: true,
-          output: `Release detection cached: ${cached.hasReleaseCapability ? cached.releaseMethod ?? "found" : "no capability"}`,
-          exitCode: 0,
-          gateRequested: cached.hasReleaseCapability,
-          hasReleaseCapability: cached.hasReleaseCapability
-        };
-      }
+  readVerifyReport(ctx) {
+    const files = this.getResultFiles(ctx);
+    if (files.length === 0) return null;
+    const displayId = Number(ctx.demand.sourceRef.displayId);
+    const planDir = path5.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
+    const filePath = path5.join(planDir, files[0].filename);
+    if (!fs4.existsSync(filePath)) return null;
+    try {
+      return fs4.readFileSync(filePath, "utf-8");
+    } catch {
+      return null;
     }
-    const result = await super.execute(ctx);
-    if (isDetect && result.success) {
-      const detected = this.readDetectionFile();
-      if (detected) {
-        const cache = new ReleaseDetectCache(resolveDataDir());
-        const projectPath = this.config.gongfeng.projectPath;
-        cache.set({
-          ...detected,
-          projectPath,
-          detectedAt: (/* @__PURE__ */ new Date()).toISOString()
-        });
-        logger8.info("Release detection completed", {
-          hasCapability: detected.hasReleaseCapability,
-          method: detected.releaseMethod,
-          artifacts: detected.artifacts
-        });
-        return {
-          ...result,
-          gateRequested: detected.hasReleaseCapability,
-          hasReleaseCapability: detected.hasReleaseCapability
-        };
-      }
-      return { ...result, gateRequested: false, hasReleaseCapability: false };
+  }
+  readPlanFile(ctx) {
+    const displayId = Number(ctx.demand.sourceRef.displayId);
+    const planDir = path5.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
+    const filePath = path5.join(planDir, "01-plan.md");
+    if (!fs4.existsSync(filePath)) return null;
+    try {
+      return fs4.readFileSync(filePath, "utf-8");
+    } catch {
+      return null;
     }
-    return { ...result, gateRequested: false };
   }
-};
-
-// src/phases/UatPhase.ts
-function getDefaultHost() {
-  return getLocalIP();
-}
-var UatPhase = class extends BasePhase {
-  phaseName = "uat";
-  getResultFiles(_ctx) {
-    return [{ filename: "03-uat-report.md", label: "UAT \u62A5\u544A" }];
+};
+
+// src/phases/PlanPhase.ts
+var PlanPhase = class extends BasePhase {
+  phaseName = "plan";
+  getResultFiles() {
+    return [{ filename: "01-plan.md", label: "\u5B9E\u65BD\u8BA1\u5212" }];
+  }
+  getRunMode() {
+    return "plan";
   }
   buildPrompt(ctx) {
     const pc = demandToPromptContext(ctx.demand);
+    const history = this.plan.readReviewHistory();
     const promptCtx = {
       issueTitle: pc.title,
       issueDescription: pc.description,
       issueIid: Number(pc.displayId),
+      supplementText: pc.supplementText || void 0,
       workspace: ctx.workspace
     };
-    const hasUatTool = !!this.config.e2e.uatVendorDir;
-    const systemE2e = this.hooks.isE2eEnabled();
-    const e2ePorts = systemE2e && ctx.ports ? {
-      backendPort: ctx.ports.backendPort,
-      frontendPort: ctx.ports.frontendPort,
-      host: this.config.preview.host || getDefaultHost()
-    } : void 0;
-    const uatTool = hasUatTool ? { vendorDir: this.config.e2e.uatVendorDir, configFile: this.config.e2e.uatConfigFile } : void 0;
-    const e2eSuffix = e2eVerifyPromptSuffix(promptCtx, e2ePorts, uatTool);
-    return `# UAT/E2E \u9A8C\u8BC1\u9636\u6BB5
-
-## \u4EFB\u52A1\u80CC\u666F
-- Issue: #${promptCtx.issueIid} ${promptCtx.issueTitle}
-- \u672C\u9636\u6BB5\u4E13\u6CE8\u4E8E E2E/UAT \u7AEF\u5BF9\u7AEF\u9A8C\u8BC1\uFF0Clint/build/test \u68C0\u67E5\u5DF2\u5728\u4E0A\u4E00\u9A8C\u8BC1\u9636\u6BB5\u5B8C\u6210\u3002
-
-## \u4EA7\u7269\u8981\u6C42
-\u8BF7\u5C06 E2E \u9A8C\u8BC1\u7ED3\u679C\u5199\u5165 \`.claude-plan/issue-${promptCtx.issueIid}/03-uat-report.md\`\uFF0C\u5305\u542B\uFF1A
-- \u6D4B\u8BD5\u573A\u666F\u6E05\u5355
-- \u6267\u884C\u7ED3\u679C\uFF08\u901A\u8FC7/\u5931\u8D25\uFF09
-- \u622A\u56FE\u8DEF\u5F84\uFF08\u5982\u6709\uFF09
-- \u5931\u8D25\u539F\u56E0\u5206\u6790\uFF08\u5982\u6709\u5931\u8D25\uFF09
+    let basePrompt;
+    if (history.length > 0) {
+      basePrompt = rePlanPrompt(promptCtx, history);
+    } else {
+      basePrompt = planPrompt(promptCtx);
+    }
+    const caps = getRunnerCapabilities(this.config.ai.mode);
+    if (!caps?.nativePlanMode) {
+      basePrompt = `${t("prompt.planModeFallback")}
 
-${e2eSuffix}`;
+${basePrompt}`;
+    }
+    return basePrompt;
   }
 };
 
-// src/phases/PhaseFactory.ts
-var PHASE_REGISTRY = /* @__PURE__ */ new Map();
-function registerPhase(name, ctor) {
-  PHASE_REGISTRY.set(name, ctor);
-}
-function registerBuiltinPhases() {
-  PHASE_REGISTRY.set("plan", PlanPhase);
-  PHASE_REGISTRY.set("build", BuildPhase);
-  PHASE_REGISTRY.set("verify", VerifyPhase);
-  PHASE_REGISTRY.set("uat", UatPhase);
-  PHASE_REGISTRY.set("release", ReleasePhase);
-}
-registerBuiltinPhases();
-function createPhase(name, ...args) {
-  const Ctor = PHASE_REGISTRY.get(name);
-  if (!Ctor) {
-    throw new PhaseNotRegisteredError(name, [...PHASE_REGISTRY.keys()]);
-  }
-  return new Ctor(...args);
-}
-function validatePhaseRegistry(phaseNames) {
-  const missing = phaseNames.filter((name) => !PHASE_REGISTRY.has(name));
-  if (missing.length > 0) {
-    throw new UnregisteredPhasesError(missing, [...PHASE_REGISTRY.keys()]);
-  }
-}
-
-// src/lifecycle/ActionLifecycleManager.ts
-var ActionLifecycleManager = class {
-  /** IssueState → ActionState */
-  stateToAction;
-  /** "action:status" → IssueState */
-  actionToState;
-  /** phase name → { startState, doneState, approvedState? } */
-  phaseStatesMap;
-  /** Ordered phase indices by IssueState for determineResumePhaseIndex */
-  def;
-  constructor(def) {
-    this.def = def;
-    this.stateToAction = /* @__PURE__ */ new Map();
-    this.actionToState = /* @__PURE__ */ new Map();
-    this.phaseStatesMap = /* @__PURE__ */ new Map();
-    this.buildMappings(def);
-  }
-  buildMappings(def) {
-    this.addMapping("pending" /* Pending */, "init", "idle");
-    this.addMapping("skipped" /* Skipped */, "init", "skipped");
-    this.addMapping("branch_created" /* BranchCreated */, "init", "ready");
-    this.addMapping("failed" /* Failed */, "init", "failed");
-    this.addMapping("deployed" /* Deployed */, "init", "done");
-    this.addMapping("resolving_conflict" /* ResolvingConflict */, "conflict", "running");
-    for (const spec of def.phases) {
-      this.phaseStatesMap.set(spec.name, {
-        startState: spec.startState,
-        doneState: spec.doneState,
-        approvedState: spec.approvedState
-      });
-      if (spec.kind === "ai") {
-        if (spec.startState !== "phase_running" /* PhaseRunning */) {
-          this.addMapping(spec.startState, spec.name, "running");
-        }
-        if (spec.doneState === "completed" /* Completed */) {
-          this.addMapping(spec.doneState, spec.name, "done");
-        } else if (spec.doneState !== "phase_done" /* PhaseDone */) {
-          this.addMapping(spec.doneState, spec.name, "ready");
-        }
-      } else if (spec.kind === "gate") {
-        if (spec.startState !== "phase_waiting" /* PhaseWaiting */) {
-          this.addMapping(spec.startState, spec.name, "waiting");
-        }
-        if (spec.approvedState && spec.approvedState !== "phase_approved" /* PhaseApproved */) {
-          this.addMapping(spec.approvedState, spec.name, "ready");
+// src/phases/BuildPhase.ts
+var BuildPhase = class extends BasePhase {
+  phaseName = "build";
+  async validatePhaseOutput(ctx, _displayId) {
+    let hasAnyChanges = false;
+    if (ctx.workspace && ctx.workspace.repos.length > 1) {
+      for (const repo of ctx.workspace.repos) {
+        const repoGit = new GitOperations(repo.gitRootDir);
+        if (await repoGit.hasChanges()) {
+          hasAnyChanges = true;
+          break;
         }
       }
+    } else {
+      hasAnyChanges = await this.git.hasChanges();
     }
-  }
-  addMapping(state, action, status) {
-    if (!this.stateToAction.has(state)) {
-      this.stateToAction.set(state, { action, status });
-    }
-    const key = `${action}:${status}`;
-    if (!this.actionToState.has(key)) {
-      this.actionToState.set(key, state);
+    if (!hasAnyChanges) {
+      const msg = "AI \u8FDB\u7A0B\u6210\u529F\u9000\u51FA\u4F46\u672A\u4EA7\u751F\u4EFB\u4F55\u4EE3\u7801\u53D8\u66F4";
+      this.logger.error(msg, { phase: this.phaseName });
+      throw new AIExecutionError(this.phaseName, msg, { output: "", exitCode: 0 });
     }
   }
-  // ─── Query API ───
-  /**
-   * 将 IssueState 解析为语义化的 ActionState。
-   *
-   * 对于通用状态 PhaseRunning/PhaseDone，需额外传入 currentPhase 来区分具体阶段。
-   */
-  resolve(state, currentPhase) {
-    if (state === "phase_running" /* PhaseRunning */ && currentPhase) {
-      return { action: currentPhase, status: "running" };
-    }
-    if (state === "phase_done" /* PhaseDone */ && currentPhase) {
-      return { action: currentPhase, status: "ready" };
-    }
-    if (state === "phase_waiting" /* PhaseWaiting */ && currentPhase) {
-      return { action: currentPhase, status: "waiting" };
-    }
-    if (state === "phase_approved" /* PhaseApproved */ && currentPhase) {
-      return { action: currentPhase, status: "ready" };
+  buildPrompt(ctx) {
+    const pc = demandToPromptContext(ctx.demand);
+    const base = buildPrompt({
+      issueTitle: pc.title,
+      issueDescription: pc.description,
+      issueIid: Number(pc.displayId),
+      workspace: ctx.workspace
+    });
+    if (ctx.fixContext) {
+      return base + t("prompt.buildFixSuffix", {
+        iteration: ctx.fixContext.iteration,
+        failures: ctx.fixContext.verifyFailures.map((f, i) => `${i + 1}. ${f}`).join("\n"),
+        rawReport: ctx.fixContext.rawReport.slice(0, 2e3)
+      });
     }
-    const mapped = this.stateToAction.get(state);
-    if (mapped) return mapped;
-    return { action: "init", status: "idle" };
-  }
-  /**
-   * 将 action + status 反向映射为 IssueState。
-   */
-  toIssueState(action, status) {
-    return this.actionToState.get(`${action}:${status}`);
-  }
-  // ─── Classification predicates (替代 3 个 Set 常量 + getDrivableIssues) ───
-  /**
-   * 终态：done | failed | skipped
-   */
-  isTerminal(state) {
-    const as = this.resolve(state);
-    return as.status === "done" || as.status === "failed" || as.status === "skipped";
-  }
-  /**
-   * 进行中：running (包含通用 PhaseRunning)
-   */
-  isInProgress(state) {
-    if (state === "phase_running" /* PhaseRunning */) return true;
-    return this.resolve(state).status === "running";
-  }
-  /**
-   * 阻塞中：waiting
-   */
-  isBlocked(state) {
-    if (state === "phase_waiting" /* PhaseWaiting */) return true;
-    return this.resolve(state).status === "waiting";
+    return base;
   }
-  /**
-   * 可驱动判断（集中化 getDrivableIssues 的过滤逻辑）。
-   *
-   * - idle → 可驱动 (Pending)
-   * - ready → 可驱动 (BranchCreated, PhaseDone, PhaseApproved)
-   * - failed && attempts < maxRetries → 可驱动
-   * - waiting → 不可驱动 (PhaseWaiting)
-   * - running → 不可驱动（stalled 由外部叠加）
-   * - done/skipped → 不可驱动
-   */
-  isDrivable(state, attempts, maxRetries, lastErrorRetryable) {
-    if (state === "phase_done" /* PhaseDone */) return true;
-    if (state === "phase_approved" /* PhaseApproved */) return true;
-    if (state === "phase_running" /* PhaseRunning */) return false;
-    if (state === "phase_waiting" /* PhaseWaiting */) return false;
-    const as = this.resolve(state);
-    switch (as.status) {
-      case "idle":
-      case "ready":
-        return true;
-      case "failed":
-        if (lastErrorRetryable === false) return false;
-        return attempts < maxRetries;
-      case "waiting":
-      case "running":
-      case "done":
-      case "skipped":
-        return false;
-    }
+};
+
+// src/phases/ReleasePhase.ts
+import fs6 from "fs";
+import path7 from "path";
+
+// src/release/ReleaseDetectCache.ts
+import fs5 from "fs";
+import path6 from "path";
+import { createHash } from "crypto";
+var logger7 = logger.child("ReleaseDetectCache");
+function hashProjectPath(projectPath) {
+  return createHash("sha256").update(projectPath).digest("hex").slice(0, 16);
+}
+var ReleaseDetectCache = class {
+  cacheDir;
+  constructor(dataDir) {
+    this.cacheDir = path6.join(dataDir, "release-detect");
+  }
+  filePath(projectPath) {
+    return path6.join(this.cacheDir, `${hashProjectPath(projectPath)}.json`);
   }
-  // ─── Phase navigation (替代 determineStartIndex + getPhasePreState) ───
   /**
-   * 确定从哪个阶段索引恢复执行（替代 PipelineOrchestrator.determineStartIndex）。
-   *
-   * 从后向前扫描 phases，匹配 currentState 或 failedAtState。
-   * 支持通用状态 PhaseRunning/PhaseDone + currentPhase 的组合。
+   * 读取缓存。返回 null 如果不存在、已过期或校验失败。
    */
-  determineResumePhaseIndex(currentState, failedAtState, currentPhase) {
-    const target = failedAtState || currentState;
-    const phases = this.def.phases;
-    if ((target === "phase_running" /* PhaseRunning */ || target === "phase_done" /* PhaseDone */) && currentPhase) {
-      const idx = phases.findIndex((p) => p.name === currentPhase);
-      if (idx >= 0) {
-        return target === "phase_done" /* PhaseDone */ ? idx + 1 : idx;
-      }
-    }
-    if ((target === "phase_waiting" /* PhaseWaiting */ || target === "phase_approved" /* PhaseApproved */) && currentPhase) {
-      const idx = phases.findIndex((p) => p.name === currentPhase);
-      if (idx >= 0) {
-        if (target === "phase_approved" /* PhaseApproved */) {
-          const spec = phases[idx];
-          return spec.kind === "ai" && spec.approvedState ? idx : idx + 1;
-        }
-        return idx;
-      }
-    }
-    for (let i = phases.length - 1; i >= 0; i--) {
-      const spec = phases[i];
-      if (spec.kind === "gate" && spec.approvedState === target) {
-        return i + 1;
+  get(projectPath, ttlMs) {
+    const fp = this.filePath(projectPath);
+    try {
+      if (!fs5.existsSync(fp)) return null;
+      const raw = fs5.readFileSync(fp, "utf-8");
+      const data = JSON.parse(raw);
+      if (data.projectPath !== projectPath) {
+        logger7.warn("Cache projectPath mismatch, ignoring", { expected: projectPath, got: data.projectPath });
+        return null;
       }
-      if (spec.startState === target || spec.doneState === target) {
-        return spec.doneState === target ? i + 1 : i;
+      const age = Date.now() - new Date(data.detectedAt).getTime();
+      if (age > ttlMs) {
+        logger7.debug("Cache expired", { projectPath, ageMs: age, ttlMs });
+        return null;
       }
+      return data;
+    } catch (err) {
+      logger7.warn("Failed to read release detect cache", { path: fp, error: err.message });
+      return null;
     }
-    return 0;
-  }
-  /**
-   * 获取某个 phase 的前驱状态（即重置到该 phase 需要设置的状态）。
-   * 第一个 phase 的前驱是 BranchCreated；后续 phase 的前驱是上一个 phase 的 approvedState 或 doneState。
-   */
-  getPhasePreState(phaseName) {
-    const phases = this.def.phases;
-    const idx = phases.findIndex((p) => p.name === phaseName);
-    if (idx < 0) return void 0;
-    if (idx === 0) return "branch_created" /* BranchCreated */;
-    const prev = phases[idx - 1];
-    return prev.approvedState ?? prev.doneState;
   }
   /**
-   * 获取某个 phase 的状态三元组。
+   * 写入缓存。
    */
-  getPhaseStates(phaseName) {
-    return this.phaseStatesMap.get(phaseName);
+  set(result) {
+    const fp = this.filePath(result.projectPath);
+    try {
+      if (!fs5.existsSync(this.cacheDir)) {
+        fs5.mkdirSync(this.cacheDir, { recursive: true });
+      }
+      fs5.writeFileSync(fp, JSON.stringify(result, null, 2), "utf-8");
+      logger7.debug("Release detect cache written", { projectPath: result.projectPath, path: fp });
+    } catch (err) {
+      logger7.warn("Failed to write release detect cache", { path: fp, error: err.message });
+    }
   }
-  // ─── Display helpers (替代 collectStateLabels + derivePhaseStatuses) ───
   /**
-   * 解析单条状态的展示标签。
-   *
-   * 对通用状态 PhaseRunning/PhaseDone，需传入 currentPhase 以生成具体标签（如"分析中"）；
-   * 缺少 currentPhase 时回退到泛化标签（如"阶段执行中"）。
+   * 手动失效缓存。
    */
-  resolveLabel(state, currentPhase) {
-    if ((state === "phase_running" /* PhaseRunning */ || state === "phase_done" /* PhaseDone */) && currentPhase) {
-      const phaseLabel = t(`pipeline.phase.${currentPhase}`);
-      return state === "phase_running" /* PhaseRunning */ ? t("state.phaseDoing", { label: phaseLabel }) : t("state.phaseDone", { label: phaseLabel });
-    }
-    if ((state === "phase_waiting" /* PhaseWaiting */ || state === "phase_approved" /* PhaseApproved */) && currentPhase) {
-      const phaseLabel = t(`pipeline.phase.${currentPhase}`);
-      return state === "phase_waiting" /* PhaseWaiting */ ? t("state.phaseWaiting", { label: phaseLabel }) : t("state.phaseApproved", { label: phaseLabel });
+  invalidate(projectPath) {
+    const fp = this.filePath(projectPath);
+    try {
+      if (fs5.existsSync(fp)) {
+        fs5.unlinkSync(fp);
+        logger7.info("Release detect cache invalidated", { projectPath });
+        return true;
+      }
+      return false;
+    } catch (err) {
+      logger7.warn("Failed to invalidate release detect cache", { path: fp, error: err.message });
+      return false;
     }
-    const labels = this.collectStateLabels();
-    return labels.get(state) ?? state;
   }
+};
+
+// src/prompts/release-templates.ts
+function releaseDetectPrompt(ctx) {
+  const pd = `.claude-plan/issue-${ctx.issueIid}`;
+  return `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 DevOps \u5206\u6790\u5E08\u3002\u4F60\u7684\u4EFB\u52A1\u662F\u63A2\u7D22\u5F53\u524D\u9879\u76EE\uFF0C\u67E5\u627E\u6240\u6709\u4E0E**\u53D1\u5E03/\u90E8\u7F72**\u76F8\u5173\u7684\u673A\u5236\u3002
+
+## \u63A2\u7D22\u8303\u56F4
+
+\u8BF7\u6309\u4F18\u5148\u7EA7\u4F9D\u6B21\u68C0\u67E5\u4EE5\u4E0B\u4F4D\u7F6E\uFF1A
+
+1. **Skill \u6587\u4EF6**
+   - \`.cursor/skills/\` \u76EE\u5F55\u4E0B\u4E0E release/deploy/publish \u76F8\u5173\u7684 skill
+   - \u9879\u76EE\u6839\u76EE\u5F55\u7684 \`SKILL.md\` \u6216 \`release.md\`
+
+2. **Rule \u6587\u4EF6**
+   - \`.cursor/rules/\` \u76EE\u5F55\u4E0B\u4E0E release/deploy \u76F8\u5173\u7684 \`.mdc\` \u89C4\u5219
+
+3. **CI/CD \u914D\u7F6E**
+   - \`.gitlab-ci.yml\` / \`Jenkinsfile\` / \`.github/workflows/\`
+   - \u67E5\u627E release/deploy/publish \u76F8\u5173\u7684 stage/job/workflow
+
+4. **Package Manager**
+   - \`package.json\` \u4E2D\u7684 \`scripts\` \u5B57\u6BB5\uFF1Apublish\u3001release\u3001deploy \u7B49
+   - \`Makefile\` \u4E2D\u7684 release/deploy target
+
+5. **\u811A\u672C\u4E0E\u6587\u6863**
+   - \`scripts/release.*\`\u3001\`scripts/deploy.*\`\u3001\`scripts/publish.*\`
+   - \`RELEASE.md\`\u3001\`CHANGELOG.md\`\u3001\`CONTRIBUTING.md\` \u4E2D\u7684\u53D1\u5E03\u8BF4\u660E
+   - \`Dockerfile\`\u3001\`docker-compose*.yml\`
+
+## \u8F93\u51FA\u8981\u6C42
+
+\u5C06\u68C0\u6D4B\u7ED3\u679C\u4EE5 **\u4E25\u683C JSON** \u683C\u5F0F\u5199\u5165 \`${pd}/03-release-detect.json\`\uFF1A
+
+\`\`\`json
+{
+  "hasReleaseCapability": true,
+  "releaseMethod": "npm-publish",
+  "artifacts": ["package.json", ".gitlab-ci.yml"],
+  "instructions": "\u8FD0\u884C npm publish \u53D1\u5E03\u5230 npm registry..."
+}
+\`\`\`
+
+\u5B57\u6BB5\u8BF4\u660E\uFF1A
+- \`hasReleaseCapability\`: \u662F\u5426\u627E\u5230\u53D1\u5E03\u673A\u5236\uFF08boolean\uFF09
+- \`releaseMethod\`: \u53D1\u5E03\u65B9\u5F0F\uFF0C\u53EF\u9009\u503C\uFF1A"npm-publish" | "ci-pipeline" | "makefile" | "custom-script" | "skill" | "docker" | \u5176\u4ED6\u63CF\u8FF0
+- \`artifacts\`: \u53D1\u73B0\u7684\u53D1\u5E03\u76F8\u5173\u6587\u4EF6\u8DEF\u5F84\u6570\u7EC4
+- \`instructions\`: \u4ECE\u6587\u4EF6\u4E2D\u63D0\u53D6\u7684\u53D1\u5E03\u6B65\u9AA4\u8BF4\u660E\u3002\u5982\u679C\u662F skill/rule \u6587\u4EF6\uFF0C\u8BF7\u5B8C\u6574\u590D\u5236\u5176\u5185\u5BB9
+
+**\u91CD\u8981**\uFF1A
+- \u5982\u679C\u6CA1\u6709\u627E\u5230\u4EFB\u4F55\u53D1\u5E03\u673A\u5236\uFF0C\u5C06 \`hasReleaseCapability\` \u8BBE\u4E3A \`false\`\uFF0C\u5176\u4ED6\u5B57\u6BB5\u53EF\u7701\u7565
+- \u5982\u679C\u627E\u5230\u4E86 skill \u6216 rule \u6587\u4EF6\uFF0C\u8BF7\u5728 \`instructions\` \u4E2D\u5B8C\u6574\u4FDD\u7559\u539F\u6587\u5185\u5BB9\uFF0C\u540E\u7EED\u53D1\u5E03\u6267\u884C\u5C06\u4F9D\u8D56\u5B83
+- \u53EA\u8F93\u51FA JSON \u6587\u4EF6\uFF0C\u4E0D\u8981\u6267\u884C\u4EFB\u4F55\u53D1\u5E03\u64CD\u4F5C`;
+}
+function releaseExecPrompt(ctx, detectResult) {
+  const pd = `.claude-plan/issue-${ctx.issueIid}`;
+  const artifactList = detectResult.artifacts.length > 0 ? detectResult.artifacts.map((a) => `- \`${a}\``).join("\n") : "\uFF08\u65E0\uFF09";
+  const instructionSection = detectResult.instructions ? `
+## \u53D1\u5E03\u6307\u5F15\uFF08\u6765\u81EA\u9879\u76EE skill/rule/\u6587\u6863\uFF09
+
+${detectResult.instructions}` : "";
+  return `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684\u53D1\u5E03\u5DE5\u7A0B\u5E08\u3002\u8BF7\u6839\u636E\u4EE5\u4E0B\u68C0\u6D4B\u7ED3\u679C\uFF0C\u6267\u884C\u9879\u76EE\u7684\u53D1\u5E03\u6D41\u7A0B\u3002
+
+## \u68C0\u6D4B\u7ED3\u679C
+
+- **\u53D1\u5E03\u65B9\u5F0F**: ${detectResult.releaseMethod ?? "\u672A\u77E5"}
+- **\u76F8\u5173\u6587\u4EF6**:
+${artifactList}
+${instructionSection}
+
+## \u4EFB\u52A1
+
+1. \u9605\u8BFB\u4E0A\u8FF0\u53D1\u5E03\u6307\u5F15\u548C\u76F8\u5173\u6587\u4EF6
+2. \u6309\u7167\u9879\u76EE\u5B9A\u4E49\u7684\u53D1\u5E03\u6D41\u7A0B\u6267\u884C\u53D1\u5E03\u64CD\u4F5C
+3. \u5C06\u53D1\u5E03\u7ED3\u679C\u5199\u5165 \`${pd}/04-release-report.md\`
+
+## \u53D1\u5E03\u62A5\u544A\u683C\u5F0F
+
+\`\`\`markdown
+# \u53D1\u5E03\u62A5\u544A
+
+## \u53D1\u5E03\u65B9\u5F0F
+<\u4F7F\u7528\u7684\u53D1\u5E03\u65B9\u5F0F>
+
+## \u6267\u884C\u6B65\u9AA4
+<\u9010\u6B65\u8BB0\u5F55\u6267\u884C\u7684\u64CD\u4F5C>
+
+## \u7ED3\u679C
+<\u6210\u529F/\u5931\u8D25\u53CA\u8BE6\u60C5>
+\`\`\`
+
+**\u91CD\u8981**\uFF1A
+- \u4E25\u683C\u6309\u7167\u9879\u76EE\u81EA\u8EAB\u7684\u53D1\u5E03\u6D41\u7A0B\u64CD\u4F5C
+- \u5982\u6709\u4EFB\u4F55\u9519\u8BEF\u6216\u5F02\u5E38\uFF0C\u8BB0\u5F55\u5728\u62A5\u544A\u4E2D
+- \u4E0D\u8981\u8DF3\u8FC7\u4EFB\u4F55\u53D1\u5E03\u524D\u7684\u68C0\u67E5\u6B65\u9AA4`;
+}
+
+// src/phases/ReleasePhase.ts
+var logger8 = logger.child("ReleasePhase");
+var DETECT_FILENAME = "05-release-detect.json";
+var REPORT_FILENAME = "06-release-report.md";
+var ReleasePhase = class extends BasePhase {
+  phaseName = "release";
+  get planDir() {
+    const displayId = Number(this.currentCtx?.demand.sourceRef.displayId ?? 0);
+    return path7.join(this.plan.baseDir, ".claude-plan", `issue-${displayId}`);
+  }
+  /** 暂存当前 ctx 供 planDir getter 使用 */
+  currentCtx;
   /**
-   * 收集所有状态及其展示标签。
-   * 为通用状态 PhaseRunning/PhaseDone 生成每个阶段的复合 key 条目。
+   * 检测结果是否已存在（即是否处于执行模式）。
    */
-  collectStateLabels() {
-    const labels = /* @__PURE__ */ new Map();
-    labels.set("pending" /* Pending */, t("state.pending"));
-    labels.set("skipped" /* Skipped */, t("state.skipped"));
-    labels.set("branch_created" /* BranchCreated */, t("state.branchCreated"));
-    for (const phase of this.def.phases) {
-      const phaseLabel = t(`pipeline.phase.${phase.name}`);
-      if (phase.startState === "phase_running" /* PhaseRunning */) {
-        labels.set(`phase_running:${phase.name}`, t("state.phaseDoing", { label: phaseLabel }));
-      } else if (phase.startState === "phase_waiting" /* PhaseWaiting */) {
-        labels.set(`phase_waiting:${phase.name}`, t("state.phaseWaiting", { label: phaseLabel }));
-      } else {
-        labels.set(phase.startState, t("state.phaseDoing", { label: phaseLabel }));
-      }
-      if (phase.doneState === "phase_done" /* PhaseDone */) {
-        labels.set(`phase_done:${phase.name}`, t("state.phaseDone", { label: phaseLabel }));
-      } else if (phase.doneState === "phase_approved" /* PhaseApproved */) {
-        labels.set(`phase_approved:${phase.name}`, t("state.phaseApproved", { label: phaseLabel }));
-      } else if (phase.doneState !== "completed" /* Completed */) {
-        labels.set(phase.doneState, t("state.phaseDone", { label: phaseLabel }));
-      }
-      if (phase.approvedState && phase.approvedState !== "phase_approved" /* PhaseApproved */ && phase.approvedState !== phase.doneState) {
-        labels.set(phase.approvedState, t("state.phaseApproved", { label: phaseLabel }));
-      }
+  hasDetectionResult() {
+    return fs6.existsSync(path7.join(this.planDir, DETECT_FILENAME));
+  }
+  readDetectionFile() {
+    const fp = path7.join(this.planDir, DETECT_FILENAME);
+    if (!fs6.existsSync(fp)) return null;
+    try {
+      return JSON.parse(fs6.readFileSync(fp, "utf-8"));
+    } catch {
+      return null;
+    }
+  }
+  writeDetectionFile(result) {
+    const dir = this.planDir;
+    if (!fs6.existsSync(dir)) {
+      fs6.mkdirSync(dir, { recursive: true });
     }
-    labels.set("completed" /* Completed */, t("state.completed"));
-    labels.set("failed" /* Failed */, t("state.failed"));
-    labels.set("resolving_conflict" /* ResolvingConflict */, t("state.resolvingConflict"));
-    return labels;
+    fs6.writeFileSync(path7.join(dir, DETECT_FILENAME), JSON.stringify(result, null, 2), "utf-8");
   }
-  /**
-   * 根据当前 state，推导每个 phase 的进度状态。
-   * 支持通用状态 PhaseRunning/PhaseDone + currentPhase。
-   */
-  derivePhaseStatuses(currentState, currentPhase) {
-    const result = {};
-    let passedCurrent = false;
-    if (currentState === "failed" /* Failed */ && currentPhase) {
-      for (const phase of this.def.phases) {
-        if (passedCurrent) {
-          result[phase.name] = "pending";
-        } else if (phase.name === currentPhase) {
-          result[phase.name] = "failed";
-          passedCurrent = true;
-        } else {
-          result[phase.name] = "completed";
-        }
-      }
-      return result;
+  getResultFiles(_ctx) {
+    if (this.hasDetectionResult()) {
+      return [{ filename: REPORT_FILENAME, label: "\u53D1\u5E03\u62A5\u544A" }];
     }
-    if ((currentState === "phase_running" /* PhaseRunning */ || currentState === "phase_done" /* PhaseDone */) && currentPhase) {
-      for (const phase of this.def.phases) {
-        if (passedCurrent) {
-          result[phase.name] = "pending";
-        } else if (phase.name === currentPhase) {
-          result[phase.name] = currentState === "phase_running" /* PhaseRunning */ ? "in_progress" : "completed";
-          passedCurrent = currentState === "phase_running" /* PhaseRunning */;
-          if (currentState === "phase_done" /* PhaseDone */) passedCurrent = true;
-        } else {
-          result[phase.name] = "completed";
-        }
-      }
-      return result;
+    return [{ filename: DETECT_FILENAME, label: "\u53D1\u5E03\u68C0\u6D4B\u62A5\u544A" }];
+  }
+  buildPrompt(ctx) {
+    const dc = demandToPromptContext(ctx.demand);
+    const pc = {
+      issueTitle: dc.title,
+      issueDescription: dc.description,
+      issueIid: Number(dc.displayId),
+      supplementText: dc.supplementText || void 0,
+      workspace: ctx.workspace
+    };
+    if (this.hasDetectionResult()) {
+      const detect = this.readDetectionFile();
+      return releaseExecPrompt(pc, detect);
     }
-    if ((currentState === "phase_waiting" /* PhaseWaiting */ || currentState === "phase_approved" /* PhaseApproved */) && currentPhase) {
-      for (const phase of this.def.phases) {
-        if (passedCurrent) {
-          result[phase.name] = "pending";
-        } else if (phase.name === currentPhase) {
-          const isGatedAi = phase.kind === "ai" && phase.approvedState;
-          result[phase.name] = currentState === "phase_waiting" /* PhaseWaiting */ || currentState === "phase_approved" /* PhaseApproved */ && isGatedAi ? "in_progress" : "completed";
-          passedCurrent = true;
-        } else {
-          result[phase.name] = "completed";
+    return releaseDetectPrompt(pc);
+  }
+  async execute(ctx) {
+    this.currentCtx = ctx;
+    const isDetect = !this.hasDetectionResult();
+    if (isDetect) {
+      const cache = new ReleaseDetectCache(resolveDataDir());
+      const projectPath = this.config.gongfeng.projectPath;
+      const ttlMs = this.config.release.detectCacheTtlMs;
+      const cached = cache.get(projectPath, ttlMs);
+      if (cached) {
+        logger8.info("Using cached release detection result", {
+          projectPath,
+          hasCapability: cached.hasReleaseCapability,
+          method: cached.releaseMethod
+        });
+        await this.hooks.onPhaseStart(this.phaseName);
+        this.writeDetectionFile(cached);
+        this.plan.updatePhaseProgress(this.phaseName, "completed");
+        try {
+          await this.git.add(["."]);
+          await this.git.commit(`chore: release detection (cached) for issue-${ctx.demand.sourceRef.displayId}`);
+        } catch {
         }
+        await this.hooks.onPhaseDone(this.phaseName);
+        return {
+          success: true,
+          output: `Release detection cached: ${cached.hasReleaseCapability ? cached.releaseMethod ?? "found" : "no capability"}`,
+          exitCode: 0,
+          gateRequested: cached.hasReleaseCapability,
+          hasReleaseCapability: cached.hasReleaseCapability
+        };
       }
-      return result;
-    }
-    if (currentState === "completed" /* Completed */ || currentState === "resolving_conflict" /* ResolvingConflict */) {
-      for (const phase of this.def.phases) {
-        result[phase.name] = "completed";
-      }
-      return result;
     }
-    for (const phase of this.def.phases) {
-      if (passedCurrent) {
-        result[phase.name] = "pending";
-        continue;
-      }
-      if (phase.startState === currentState) {
-        result[phase.name] = "in_progress";
-        passedCurrent = true;
-      } else if (phase.doneState === currentState || phase.approvedState === currentState) {
-        result[phase.name] = "completed";
-      } else {
-        result[phase.name] = "pending";
+    const result = await super.execute(ctx);
+    if (isDetect && result.success) {
+      const detected = this.readDetectionFile();
+      if (detected) {
+        const cache = new ReleaseDetectCache(resolveDataDir());
+        const projectPath = this.config.gongfeng.projectPath;
+        cache.set({
+          ...detected,
+          projectPath,
+          detectedAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        logger8.info("Release detection completed", {
+          hasCapability: detected.hasReleaseCapability,
+          method: detected.releaseMethod,
+          artifacts: detected.artifacts
+        });
+        return {
+          ...result,
+          gateRequested: detected.hasReleaseCapability,
+          hasReleaseCapability: detected.hasReleaseCapability
+        };
       }
+      return { ...result, gateRequested: false, hasReleaseCapability: false };
     }
-    return result;
-  }
-  // ─── Pipeline Protocol queries (P1) ───
-  /**
-   * 返回可被用户单独重试的阶段名列表。
-   * 优先使用 spec.retryable，未声明时默认 kind === 'ai'。
-   */
-  getRetryablePhases() {
-    return this.def.phases.filter((spec) => spec.retryable ?? spec.kind === "ai").map((spec) => spec.name);
-  }
-  /**
-   * 判断指定阶段是否可重试。
-   */
-  isRetryable(phaseName) {
-    const spec = this.def.phases.find((p) => p.name === phaseName);
-    if (!spec) return false;
-    return spec.retryable ?? spec.kind === "ai";
-  }
-  /**
-   * 查找 gate 类型的阶段。
-   */
-  getGatePhase() {
-    return this.def.phases.find((p) => p.kind === "gate");
+    return { ...result, gateRequested: false };
   }
-  /**
-   * 判断指定阶段完成后是否应启动预览服务器。
-   */
-  shouldDeployPreview(phaseName) {
-    const spec = this.def.phases.find((p) => p.name === phaseName);
-    return spec?.deploysPreview ?? false;
+};
+
+// src/phases/UatPhase.ts
+function getDefaultHost() {
+  return getLocalIP();
+}
+var UatPhase = class extends BasePhase {
+  phaseName = "uat";
+  getResultFiles(_ctx) {
+    return [{ filename: "03-uat-report.md", label: "UAT \u62A5\u544A" }];
   }
-  /**
-   * 收集所有阶段的产物文件，扁平化为单一列表。
-   */
-  collectArtifacts() {
-    return this.def.phases.flatMap((spec) => spec.artifacts ?? []);
+  buildPrompt(ctx) {
+    const pc = demandToPromptContext(ctx.demand);
+    const promptCtx = {
+      issueTitle: pc.title,
+      issueDescription: pc.description,
+      issueIid: Number(pc.displayId),
+      workspace: ctx.workspace
+    };
+    const hasUatTool = !!this.config.e2e.uatVendorDir;
+    const systemE2e = this.hooks.isE2eEnabled();
+    const e2ePorts = systemE2e && ctx.ports ? {
+      backendPort: ctx.ports.backendPort,
+      frontendPort: ctx.ports.frontendPort,
+      host: this.config.preview.host || getDefaultHost()
+    } : void 0;
+    const uatTool = hasUatTool ? { vendorDir: this.config.e2e.uatVendorDir, configFile: this.config.e2e.uatConfigFile } : void 0;
+    const e2eSuffix = e2eVerifyPromptSuffix(promptCtx, e2ePorts, uatTool);
+    return `# UAT/E2E \u9A8C\u8BC1\u9636\u6BB5
+
+## \u4EFB\u52A1\u80CC\u666F
+- Issue: #${promptCtx.issueIid} ${promptCtx.issueTitle}
+- \u672C\u9636\u6BB5\u4E13\u6CE8\u4E8E E2E/UAT \u7AEF\u5BF9\u7AEF\u9A8C\u8BC1\uFF0Clint/build/test \u68C0\u67E5\u5DF2\u5728\u4E0A\u4E00\u9A8C\u8BC1\u9636\u6BB5\u5B8C\u6210\u3002
+
+## \u4EA7\u7269\u8981\u6C42
+\u8BF7\u5C06 E2E \u9A8C\u8BC1\u7ED3\u679C\u5199\u5165 \`.claude-plan/issue-${promptCtx.issueIid}/03-uat-report.md\`\uFF0C\u5305\u542B\uFF1A
+- \u6D4B\u8BD5\u573A\u666F\u6E05\u5355
+- \u6267\u884C\u7ED3\u679C\uFF08\u901A\u8FC7/\u5931\u8D25\uFF09
+- \u622A\u56FE\u8DEF\u5F84\uFF08\u5982\u6709\uFF09
+- \u5931\u8D25\u539F\u56E0\u5206\u6790\uFF08\u5982\u6709\u5931\u8D25\uFF09
+
+${e2eSuffix}`;
   }
-  /**
-   * 返回所有阶段的名称和标签（保持定义顺序）。
-   */
-  getPhaseDefs() {
-    return this.def.phases.map((p) => ({ name: p.name, label: p.label }));
+};
+
+// src/phases/PhaseFactory.ts
+var PHASE_REGISTRY = /* @__PURE__ */ new Map();
+function registerPhase(name, ctor) {
+  PHASE_REGISTRY.set(name, ctor);
+}
+function registerBuiltinPhases() {
+  PHASE_REGISTRY.set("plan", PlanPhase);
+  PHASE_REGISTRY.set("build", BuildPhase);
+  PHASE_REGISTRY.set("verify", VerifyPhase);
+  PHASE_REGISTRY.set("uat", UatPhase);
+  PHASE_REGISTRY.set("release", ReleasePhase);
+}
+registerBuiltinPhases();
+function createPhase(name, ...args) {
+  const Ctor = PHASE_REGISTRY.get(name);
+  if (!Ctor) {
+    throw new PhaseNotRegisteredError(name, [...PHASE_REGISTRY.keys()]);
   }
-  /**
-   * 返回所有 kind === 'ai' 的阶段名（可执行阶段）。
-   */
-  getExecutablePhaseNames() {
-    return this.def.phases.filter((spec) => spec.kind === "ai").map((spec) => spec.name);
+  return new Ctor(...args);
+}
+function validatePhaseRegistry(phaseNames) {
+  const missing = phaseNames.filter((name) => !PHASE_REGISTRY.has(name));
+  if (missing.length > 0) {
+    throw new UnregisteredPhasesError(missing, [...PHASE_REGISTRY.keys()]);
   }
-};
+}
 
 // src/pipeline/PipelineDefinition.ts
 var pipelineRegistry = /* @__PURE__ */ new Map();
@@ -4374,7 +4374,10 @@ var PipelineOrchestrator = class {
       throw new InvalidPhaseError(phase);
     }
     logger19.info("Retrying issue from phase", { issueIid, phase });
-    this.tracker.resetToPhase(issueIid, phase, issueDef);
+    const ok = this.tracker.resetToPhase(issueIid, phase, issueDef);
+    if (!ok) {
+      throw new InvalidPhaseError(phase);
+    }
   }
   getIssueSpecificPipelineDef(record) {
     if (record.pipelineMode) {
@@ -5095,4 +5098,4 @@ export {
   PipelineOrchestrator,
   BrainstormService
 };
-//# sourceMappingURL=chunk-S3ULUOTM.js.map
+//# sourceMappingURL=chunk-7D2NH37P.js.map