@xdevops/issue-auto-finish 1.0.80 → 1.0.82

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

@@ -528,1999 +528,1999 @@ var IssueState = /* @__PURE__ */ ((IssueState2) => {
   return IssueState2;
 })(IssueState || {});
 
-// src/tracker/IssueTracker.ts
-var logger5 = logger.child("IssueTracker");
-var STATE_MIGRATION_MAP = {
-  analyzing: { state: "phase_running", currentPhase: "analysis" },
-  analysis_done: { state: "phase_done", currentPhase: "analysis" },
-  designing: { state: "phase_running", currentPhase: "design" },
-  design_done: { state: "phase_done", currentPhase: "design" },
-  implementing: { state: "phase_running", currentPhase: "implement" },
-  implement_done: { state: "phase_done", currentPhase: "implement" },
-  planning: { state: "phase_running", currentPhase: "plan" },
-  plan_done: { state: "phase_done", currentPhase: "plan" },
-  building: { state: "phase_running", currentPhase: "build" },
-  build_done: { state: "phase_done", currentPhase: "build" },
-  verifying: { state: "phase_running", currentPhase: "verify" },
-  // 旧 gate 硬编码状态 → 通用 gate 状态
-  waiting_for_review: { state: "phase_waiting", currentPhase: "review" },
-  review_approved: { state: "phase_approved", currentPhase: "review" }
-};
-var IssueTracker = class extends BaseTracker {
-  lifecycleManagers;
-  tenantId;
-  constructor(dataDir, lifecycleManagers, tenantId) {
-    const tid = tenantId ?? "default";
-    const filename = tid === "default" ? "tracker.json" : `tracker-${tid}.json`;
-    super(dataDir, filename, "issues", "tracker");
-    this.lifecycleManagers = lifecycleManagers;
-    this.tenantId = tid;
-    this.migrateRecords();
+// 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);
   }
-  /**
-   * 迁移旧格式记录到新格式：
-   * 1. 旧阶段专属状态 → PhaseRunning/PhaseDone + currentPhase
-   * 2. failedAtState 同步迁移
-   * 3. 为缺少 demandSpec 的旧记录回填
-   *
-   * 幂等：已迁移的记录不会重复处理。
-   */
-  migrateRecords() {
-    let migrated = 0;
-    for (const record of this.getAllRecords()) {
-      const raw = record;
-      const stateStr = raw.state;
-      const migration = STATE_MIGRATION_MAP[stateStr];
-      if (migration) {
-        raw.state = migration.state;
-        raw.currentPhase = migration.currentPhase;
-        migrated++;
-      }
-      const failedAtStr = raw.failedAtState;
-      if (failedAtStr) {
-        const failedMigration = STATE_MIGRATION_MAP[failedAtStr];
-        if (failedMigration) {
-          raw.failedAtState = failedMigration.state;
-          if (!raw.currentPhase) {
-            raw.currentPhase = failedMigration.currentPhase;
-          }
+  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");
         }
       }
-      if (!raw.demandSpec && raw.issueIid) {
-        raw.demandSpec = {
-          demandId: `gf-${raw.issueIid}`,
-          sourceRef: {
-            source: "gongfeng-issue",
-            externalId: String(raw.issueId ?? raw.issueIid),
-            displayId: String(raw.issueIid)
-          },
-          title: raw.issueTitle || "",
-          description: "",
-          createdAt: raw.createdAt || (/* @__PURE__ */ new Date()).toISOString()
-        };
-      }
-      if (raw.issueId !== void 0 || raw.issueIid !== void 0 || raw.issueTitle !== void 0) {
-        delete raw.issueId;
-        delete raw.issueIid;
-        delete raw.issueTitle;
-        migrated++;
-      }
-    }
-    if (migrated > 0) {
-      this.save();
-      logger5.info("Migrated tracker records", { migrated });
     }
   }
-  lifecycleFor(record) {
-    if (record.pipelineMode) {
-      const lm = this.lifecycleManagers.get(record.pipelineMode);
-      if (lm) return lm;
+  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);
     }
-    return this.lifecycleManagers.get("plan-mode") ?? this.lifecycleManagers.values().next().value;
-  }
-  key(issueIid) {
-    return String(issueIid);
-  }
-  get(issueIid) {
-    return this.getByKey(this.key(issueIid));
-  }
-  create(record) {
-    const now = (/* @__PURE__ */ new Date()).toISOString();
-    const full = {
-      ...record,
-      attempts: 0,
-      createdAt: now,
-      updatedAt: now
-    };
-    this.setRecord(this.key(getIid(full)), full);
-    this.save();
-    logger5.info("Issue tracked", { issueIid: getIid(full), state: record.state });
-    eventBus.emitTyped("issue:created", full);
-    return full;
   }
-  updateState(issueIid, state, extra) {
-    const record = this.collection[this.key(issueIid)];
-    if (!record) {
-      throw new IssueNotFoundError(issueIid);
+  // ─── Query API ───
+  /**
+   * 将 IssueState 解析为语义化的 ActionState。
+   *
+   * 对于通用状态 PhaseRunning/PhaseDone，需额外传入 currentPhase 来区分具体阶段。
+   */
+  resolve(state, currentPhase) {
+    if (state === "phase_running" /* PhaseRunning */ && currentPhase) {
+      return { action: currentPhase, status: "running" };
     }
-    record.state = state;
-    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    if (state === "completed" /* Completed */) {
-      record.lastError = void 0;
-      record.failedAtState = void 0;
+    if (state === "phase_done" /* PhaseDone */ && currentPhase) {
+      return { action: currentPhase, status: "ready" };
     }
-    if (extra) {
-      Object.assign(record, extra);
+    if (state === "phase_waiting" /* PhaseWaiting */ && currentPhase) {
+      return { action: currentPhase, status: "waiting" };
     }
-    this.save();
-    logger5.info("Issue state updated", { issueIid, state });
-    eventBus.emitTyped("issue:stateChanged", { issueIid, state, record });
-  }
-  markFailed(issueIid, error, failedAtState, isRetryable) {
-    const record = this.collection[this.key(issueIid)];
-    if (!record) return;
-    record.state = "failed" /* Failed */;
-    record.lastError = error;
-    record.failedAtState = failedAtState;
-    record.lastErrorRetryable = isRetryable;
-    record.attempts += 1;
-    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.save();
-    logger5.warn("Issue marked as failed", { issueIid, error, failedAtState, attempts: record.attempts, isRetryable });
-    eventBus.emitTyped("issue:failed", { issueIid, error, failedAtState, record });
-  }
-  isProcessing(issueIid) {
-    const record = this.get(issueIid);
-    if (!record) return false;
-    return !this.lifecycleFor(record).isTerminal(record.state);
-  }
-  isCompleted(issueIid) {
-    const record = this.get(issueIid);
-    return record?.state === "completed" /* Completed */;
+    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" };
   }
-  canRetry(issueIid, maxRetries) {
-    const record = this.get(issueIid);
-    if (!record || record.state !== "failed" /* Failed */) return false;
-    return record.attempts < maxRetries;
+  /**
+   * 将 action + status 反向映射为 IssueState。
+   */
+  toIssueState(action, status) {
+    return this.actionToState.get(`${action}:${status}`);
   }
-  getRetryState(issueIid) {
-    const record = this.get(issueIid);
-    return record?.failedAtState;
+  // ─── 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";
   }
-  isStalled(issueIid, thresholdMs = 5 * 60 * 1e3) {
-    const record = this.get(issueIid);
-    if (!record) return false;
-    if (this.lifecycleFor(record).isBlocked(record.state)) return false;
-    if (!this.isProcessing(issueIid)) return false;
-    const elapsed = Date.now() - new Date(record.updatedAt).getTime();
-    return elapsed > thresholdMs;
+  /**
+   * 进行中：running (包含通用 PhaseRunning)
+   */
+  isInProgress(state) {
+    if (state === "phase_running" /* PhaseRunning */) return true;
+    return this.resolve(state).status === "running";
   }
-  getDrivableIssues(maxRetries, stalledThresholdMs) {
-    return this.getAllRecords().filter((record) => {
-      const lm = this.lifecycleFor(record);
-      if (lm.isDrivable(record.state, record.attempts, maxRetries, record.lastErrorRetryable)) return true;
-      if (this.isStalled(getIid(record), stalledThresholdMs)) return true;
-      return false;
-    });
+  /**
+   * 阻塞中：waiting
+   */
+  isBlocked(state) {
+    if (state === "phase_waiting" /* PhaseWaiting */) return true;
+    return this.resolve(state).status === "waiting";
   }
-  getAllActive() {
-    return this.getAllRecords().filter(
-      (r) => !this.lifecycleFor(r).isTerminal(r.state)
-    );
+  /**
+   * 可驱动判断（集中化 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;
+    }
   }
-  getAll() {
-    return this.getAllRecords();
+  // ─── 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;
   }
-  startSkipped(issueIid) {
-    const record = this.collection[this.key(issueIid)];
-    if (!record || record.state !== "skipped" /* Skipped */) return false;
-    record.state = "pending" /* Pending */;
-    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.save();
-    logger5.info("Skipped issue started", { issueIid });
-    eventBus.emitTyped("issue:stateChanged", { issueIid, state: "pending" /* Pending */, record });
-    return true;
+  /**
+   * 获取某个 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;
   }
-  resetFull(issueIid) {
-    const record = this.collection[this.key(issueIid)];
-    if (!record) return false;
-    record.state = "pending" /* Pending */;
-    record.currentPhase = void 0;
-    record.attempts = 0;
-    record.failedAtState = void 0;
-    record.lastError = void 0;
-    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.save();
-    logger5.info("Issue fully reset", { issueIid });
-    eventBus.emitTyped("issue:restarted", { issueIid, record });
-    return true;
+  /**
+   * 获取某个 phase 的状态三元组。
+   */
+  getPhaseStates(phaseName) {
+    return this.phaseStatesMap.get(phaseName);
   }
-  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 targetState = lm.getPhasePreState(phase);
-    if (!targetState) return false;
-    record.state = targetState;
-    if (targetState === "phase_running" /* PhaseRunning */ || targetState === "phase_done" /* PhaseDone */ || targetState === "phase_waiting" /* PhaseWaiting */ || targetState === "phase_approved" /* PhaseApproved */) {
-      const phases = def.phases;
-      const idx = phases.findIndex((p) => p.name === phase);
-      if (idx > 0) {
-        record.currentPhase = phases[idx - 1].name;
-      }
+  // ─── 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 });
     }
-    record.failedAtState = void 0;
-    record.lastError = void 0;
-    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.save();
-    logger5.info("Issue reset to phase", { issueIid, phase, state: targetState });
-    eventBus.emitTyped("issue:retryFromPhase", { issueIid, phase, record });
-    return true;
-  }
-  resetForRetry(issueIid) {
-    const record = this.collection[this.key(issueIid)];
-    if (!record || record.state !== "failed" /* Failed */) return false;
-    const restoreState = record.failedAtState ?? "pending" /* Pending */;
-    record.state = restoreState;
-    record.lastError = void 0;
-    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.save();
-    logger5.info("Issue reset for retry", { issueIid, restoreState });
-    eventBus.emitTyped("issue:resetForRetry", { issueIid, restoreState, record });
-    return true;
+    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;
   }
-  delete(issueIid) {
-    const key = this.key(issueIid);
-    const record = this.collection[key];
-    if (!record) return false;
-    delete this.collection[key];
-    this.save();
-    logger5.info("Issue deleted from tracker", { issueIid });
-    eventBus.emitTyped("issue:deleted", { issueIid, record });
-    return true;
+  /**
+   * 收集所有状态及其展示标签。
+   * 为通用状态 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;
   }
-  recoverInterruptedIssues() {
-    let count = 0;
-    for (const record of this.getAllRecords()) {
-      const lm = this.lifecycleFor(record);
-      if (lm.isInProgress(record.state)) {
-        const iid = getIid(record);
-        logger5.warn("Recovering interrupted issue", {
-          issueIid: iid,
-          state: record.state
-        });
-        record.failedAtState = record.state;
-        record.state = "failed" /* Failed */;
-        record.lastError = "Interrupted by service restart";
-        record.attempts += 1;
-        record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-        count++;
-        eventBus.emitTyped("issue:failed", {
-          issueIid: iid,
-          error: "Interrupted by service restart",
-          failedAtState: record.failedAtState,
-          record
-        });
+  /**
+   * 根据当前 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 (count > 0) {
-      this.save();
-      logger5.info("Recovered interrupted issues", { count });
+    if (currentState === "completed" /* Completed */ || currentState === "resolving_conflict" /* ResolvingConflict */) {
+      for (const phase of this.def.phases) {
+        result[phase.name] = "completed";
+      }
+      return result;
     }
-    return count;
-  }
-  /** 将所有 IssueRecord 投影为 ExecutableTask[] */
-  toExecutableTasks() {
-    return this.getAllRecords().map((record) => {
-      const lm = this.lifecycleFor(record);
-      return issueToExecutableTask(record, lm);
-    });
-  }
-};
-
-// src/persistence/PlanPersistence.ts
-import fs2 from "fs";
-import path2 from "path";
-var logger6 = logger.child("PlanPersistence");
-var PLAN_DIR = ".claude-plan";
-var PlanPersistence = class _PlanPersistence {
-  workDir;
-  issueIid;
-  constructor(workDir, issueIid) {
-    this.workDir = workDir;
-    this.issueIid = issueIid;
-  }
-  get baseDir() {
-    return this.workDir;
-  }
-  get planDir() {
-    return path2.join(this.workDir, PLAN_DIR, `issue-${this.issueIid}`);
-  }
-  ensureDir() {
-    if (!fs2.existsSync(this.planDir)) {
-      fs2.mkdirSync(this.planDir, { recursive: true });
+    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;
   }
-  writeIssueMeta(meta) {
-    this.ensureDir();
-    const filePath = path2.join(this.planDir, "issue-meta.json");
-    fs2.writeFileSync(filePath, JSON.stringify(meta, null, 2), "utf-8");
-    logger6.info("Issue meta written");
+  // ─── Pipeline Protocol queries (P1) ───
+  /**
+   * 返回可被用户单独重试的阶段名列表。
+   * 优先使用 spec.retryable，未声明时默认 kind === 'ai'。
+   */
+  getRetryablePhases() {
+    return this.def.phases.filter((spec) => spec.retryable ?? spec.kind === "ai").map((spec) => spec.name);
   }
-  writeProgress(data) {
-    this.ensureDir();
-    const filePath = path2.join(this.planDir, "progress.json");
-    fs2.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
-    logger6.debug("Progress written", { currentPhase: data.currentPhase });
+  /**
+   * 判断指定阶段是否可重试。
+   */
+  isRetryable(phaseName) {
+    const spec = this.def.phases.find((p) => p.name === phaseName);
+    if (!spec) return false;
+    return spec.retryable ?? spec.kind === "ai";
   }
-  readProgress() {
-    const filePath = path2.join(this.planDir, "progress.json");
-    if (!fs2.existsSync(filePath)) return null;
-    try {
-      return JSON.parse(fs2.readFileSync(filePath, "utf-8"));
-    } catch {
-      return null;
-    }
+  /**
+   * 查找 gate 类型的阶段。
+   */
+  getGatePhase() {
+    return this.def.phases.find((p) => p.kind === "gate");
   }
-  writeAnalysis(content) {
-    this.ensureDir();
-    fs2.writeFileSync(path2.join(this.planDir, "01-analysis.md"), content, "utf-8");
-    logger6.info("Analysis document written");
+  /**
+   * 判断指定阶段完成后是否应启动预览服务器。
+   */
+  shouldDeployPreview(phaseName) {
+    const spec = this.def.phases.find((p) => p.name === phaseName);
+    return spec?.deploysPreview ?? false;
   }
-  writeDesign(content) {
-    this.ensureDir();
-    fs2.writeFileSync(path2.join(this.planDir, "02-design.md"), content, "utf-8");
-    logger6.info("Design document written");
+  /**
+   * 收集所有阶段的产物文件，扁平化为单一列表。
+   */
+  collectArtifacts() {
+    return this.def.phases.flatMap((spec) => spec.artifacts ?? []);
   }
-  writeTodolist(content) {
-    this.ensureDir();
-    fs2.writeFileSync(path2.join(this.planDir, "03-todolist.md"), content, "utf-8");
-    logger6.info("Todolist written");
+  /**
+   * 返回所有阶段的名称和标签（保持定义顺序）。
+   */
+  getPhaseDefs() {
+    return this.def.phases.map((p) => ({ name: p.name, label: p.label }));
   }
-  writeVerifyReport(content, filename = "04-verify-report.md") {
-    this.ensureDir();
-    fs2.writeFileSync(path2.join(this.planDir, filename), content, "utf-8");
-    logger6.info("Verify report written", { filename });
+  /**
+   * 返回所有 kind === 'ai' 的阶段名（可执行阶段）。
+   */
+  getExecutablePhaseNames() {
+    return this.def.phases.filter((spec) => spec.kind === "ai").map((spec) => spec.name);
   }
-  getAllPlanFiles() {
-    if (!fs2.existsSync(this.planDir)) return [];
-    return fs2.readdirSync(this.planDir).map((f) => path2.join(PLAN_DIR, `issue-${this.issueIid}`, f));
+};
+
+// src/tracker/IssueTracker.ts
+var logger5 = logger.child("IssueTracker");
+var STATE_MIGRATION_MAP = {
+  analyzing: { state: "phase_running", currentPhase: "analysis" },
+  analysis_done: { state: "phase_done", currentPhase: "analysis" },
+  designing: { state: "phase_running", currentPhase: "design" },
+  design_done: { state: "phase_done", currentPhase: "design" },
+  implementing: { state: "phase_running", currentPhase: "implement" },
+  implement_done: { state: "phase_done", currentPhase: "implement" },
+  planning: { state: "phase_running", currentPhase: "plan" },
+  plan_done: { state: "phase_done", currentPhase: "plan" },
+  building: { state: "phase_running", currentPhase: "build" },
+  build_done: { state: "phase_done", currentPhase: "build" },
+  verifying: { state: "phase_running", currentPhase: "verify" },
+  // 旧 gate 硬编码状态 → 通用 gate 状态
+  waiting_for_review: { state: "phase_waiting", currentPhase: "review" },
+  review_approved: { state: "phase_approved", currentPhase: "review" }
+};
+var IssueTracker = class extends BaseTracker {
+  lifecycleManagers;
+  tenantId;
+  constructor(dataDir, lifecycleManagers, tenantId) {
+    const tid = tenantId ?? "default";
+    const filename = tid === "default" ? "tracker.json" : `tracker-${tid}.json`;
+    super(dataDir, filename, "issues", "tracker");
+    this.lifecycleManagers = lifecycleManagers;
+    this.tenantId = tid;
+    this.migrateRecords();
   }
-  createInitialProgress(displayId, title, branchName, def) {
-    const pending = { status: "pending" };
-    if (def) {
-      const phases = {};
-      for (const spec of def.phases) {
-        phases[spec.name] = { ...pending };
+  /**
+   * 迁移旧格式记录到新格式：
+   * 1. 旧阶段专属状态 → PhaseRunning/PhaseDone + currentPhase
+   * 2. failedAtState 同步迁移
+   * 3. 为缺少 demandSpec 的旧记录回填
+   *
+   * 幂等：已迁移的记录不会重复处理。
+   */
+  migrateRecords() {
+    let migrated = 0;
+    for (const record of this.getAllRecords()) {
+      const raw = record;
+      const stateStr = raw.state;
+      const migration = STATE_MIGRATION_MAP[stateStr];
+      if (migration) {
+        raw.state = migration.state;
+        raw.currentPhase = migration.currentPhase;
+        migrated++;
       }
-      return {
-        displayId,
-        title,
-        branchName,
-        pipelineMode: def.mode,
-        currentPhase: def.phases[0].name,
-        phases
-      };
-    }
-    return {
-      displayId,
-      title,
-      branchName,
-      currentPhase: "analysis",
-      phases: {
-        analysis: { ...pending },
-        design: { ...pending },
-        implement: { ...pending },
-        verify: { ...pending }
+      const failedAtStr = raw.failedAtState;
+      if (failedAtStr) {
+        const failedMigration = STATE_MIGRATION_MAP[failedAtStr];
+        if (failedMigration) {
+          raw.failedAtState = failedMigration.state;
+          if (!raw.currentPhase) {
+            raw.currentPhase = failedMigration.currentPhase;
+          }
+        }
+      }
+      if (!raw.demandSpec && raw.issueIid) {
+        raw.demandSpec = {
+          demandId: `gf-${raw.issueIid}`,
+          sourceRef: {
+            source: "gongfeng-issue",
+            externalId: String(raw.issueId ?? raw.issueIid),
+            displayId: String(raw.issueIid)
+          },
+          title: raw.issueTitle || "",
+          description: "",
+          createdAt: raw.createdAt || (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+      if (raw.issueId !== void 0 || raw.issueIid !== void 0 || raw.issueTitle !== void 0) {
+        delete raw.issueId;
+        delete raw.issueIid;
+        delete raw.issueTitle;
+        migrated++;
       }
-    };
-  }
-  writePlan(content) {
-    this.ensureDir();
-    fs2.writeFileSync(path2.join(this.planDir, "01-plan.md"), content, "utf-8");
-    logger6.info("Plan document written");
-  }
-  writeReviewFeedback(content) {
-    this.ensureDir();
-    const history = this.readReviewHistory();
-    const round = {
-      round: history.length + 1,
-      feedback: content,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    history.push(round);
-    fs2.writeFileSync(
-      path2.join(this.planDir, "review-history.json"),
-      JSON.stringify(history, null, 2),
-      "utf-8"
-    );
-    fs2.writeFileSync(
-      path2.join(this.planDir, "review-feedback.md"),
-      _PlanPersistence.renderReviewHistoryMarkdown(history),
-      "utf-8"
-    );
-    logger6.info("Review feedback appended", { round: round.round });
-  }
-  readReviewFeedback() {
-    const filePath = path2.join(this.planDir, "review-feedback.md");
-    if (!fs2.existsSync(filePath)) return null;
-    try {
-      return fs2.readFileSync(filePath, "utf-8");
-    } catch {
-      return null;
     }
-  }
-  readReviewHistory() {
-    const filePath = path2.join(this.planDir, "review-history.json");
-    if (!fs2.existsSync(filePath)) return [];
-    try {
-      const data = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
-      return Array.isArray(data) ? data : [];
-    } catch {
-      return [];
+    if (migrated > 0) {
+      this.save();
+      logger5.info("Migrated tracker records", { migrated });
     }
   }
-  static renderReviewHistoryMarkdown(history) {
-    if (history.length === 0) return "";
-    const lines = ["# \u5BA1\u6838\u53CD\u9988\u5386\u53F2", ""];
-    for (const r of history) {
-      lines.push(`## \u7B2C ${r.round} \u8F6E\u5BA1\u6838\u53CD\u9988`);
-      lines.push(`> \u65F6\u95F4: ${r.timestamp}`);
-      lines.push("");
-      lines.push(r.feedback);
-      lines.push("");
+  lifecycleFor(record) {
+    if (record.pipelineMode) {
+      const lm = this.lifecycleManagers.get(record.pipelineMode);
+      if (lm) return lm;
     }
-    return lines.join("\n");
+    return this.lifecycleManagers.get("plan-mode") ?? this.lifecycleManagers.values().next().value;
   }
-  updatePhaseProgress(phaseName, status, error, options) {
-    const progress = this.readProgress();
-    if (!progress) return;
+  key(issueIid) {
+    return String(issueIid);
+  }
+  get(issueIid) {
+    return this.getByKey(this.key(issueIid));
+  }
+  create(record) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    if (!progress.phases[phaseName]) {
-      progress.phases[phaseName] = { status: "pending" };
+    const full = {
+      ...record,
+      attempts: 0,
+      createdAt: now,
+      updatedAt: now
+    };
+    this.setRecord(this.key(getIid(full)), full);
+    this.save();
+    logger5.info("Issue tracked", { issueIid: getIid(full), state: record.state });
+    eventBus.emitTyped("issue:created", full);
+    return full;
+  }
+  updateState(issueIid, state, extra) {
+    const record = this.collection[this.key(issueIid)];
+    if (!record) {
+      throw new IssueNotFoundError(issueIid);
     }
-    const phase = progress.phases[phaseName];
-    phase.status = status;
-    if (status === "in_progress") {
-      phase.startedAt = now;
-      progress.currentPhase = phaseName;
-      if (!options?.preserveSessionId) {
-        delete phase.sessionId;
-      }
-    } else if (status === "completed") {
-      phase.completedAt = now;
-    } else if (status === "failed") {
-      phase.error = error;
+    record.state = state;
+    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    if (state === "completed" /* Completed */) {
+      record.lastError = void 0;
+      record.failedAtState = void 0;
     }
-    this.writeProgress(progress);
+    if (extra) {
+      Object.assign(record, extra);
+    }
+    this.save();
+    logger5.info("Issue state updated", { issueIid, state });
+    eventBus.emitTyped("issue:stateChanged", { issueIid, state, record });
   }
-  updatePhaseSessionId(phaseName, sessionId) {
-    const progress = this.readProgress();
-    if (!progress?.phases[phaseName]) return;
-    progress.phases[phaseName].sessionId = sessionId;
-    this.writeProgress(progress);
+  markFailed(issueIid, error, failedAtState, isRetryable) {
+    const record = this.collection[this.key(issueIid)];
+    if (!record) return;
+    record.state = "failed" /* Failed */;
+    record.lastError = error;
+    record.failedAtState = failedAtState;
+    record.lastErrorRetryable = isRetryable;
+    record.attempts += 1;
+    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.save();
+    logger5.warn("Issue marked as failed", { issueIid, error, failedAtState, attempts: record.attempts, isRetryable });
+    eventBus.emitTyped("issue:failed", { issueIid, error, failedAtState, record });
   }
-  getPhaseSessionId(phaseName) {
-    const progress = this.readProgress();
-    return progress?.phases[phaseName]?.sessionId;
+  isProcessing(issueIid) {
+    const record = this.get(issueIid);
+    if (!record) return false;
+    return !this.lifecycleFor(record).isTerminal(record.state);
   }
-};
-
-// src/phases/BasePhase.ts
-import fs3 from "fs";
-import path4 from "path";
-
-// src/rules/RuleResolver.ts
-import { readdir, readFile } from "fs/promises";
-import path3 from "path";
-function parseFrontmatter(raw) {
-  const fmRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
-  const match = raw.match(fmRegex);
-  if (!match) {
-    return { description: "", alwaysApply: false, content: raw.trim() };
+  isCompleted(issueIid) {
+    const record = this.get(issueIid);
+    return record?.state === "completed" /* Completed */;
   }
-  const yamlBlock = match[1];
-  const content = raw.slice(match[0].length).trim();
-  let description = "";
-  const descMatch = yamlBlock.match(/description:\s*(.+)/);
-  if (descMatch) {
-    description = descMatch[1].trim();
+  canRetry(issueIid, maxRetries) {
+    const record = this.get(issueIid);
+    if (!record || record.state !== "failed" /* Failed */) return false;
+    return record.attempts < maxRetries;
   }
-  let alwaysApply = false;
-  const applyMatch = yamlBlock.match(/alwaysApply:\s*(true|false)/i);
-  if (applyMatch) {
-    alwaysApply = applyMatch[1].toLowerCase() === "true";
+  getRetryState(issueIid) {
+    const record = this.get(issueIid);
+    return record?.failedAtState;
   }
-  return { description, alwaysApply, content };
-}
-var RuleResolver = class {
-  rules = [];
-  triggers;
-  constructor(ruleTriggers) {
-    this.triggers = ruleTriggers;
+  isStalled(issueIid, thresholdMs = 5 * 60 * 1e3) {
+    const record = this.get(issueIid);
+    if (!record) return false;
+    if (this.lifecycleFor(record).isBlocked(record.state)) return false;
+    if (!this.isProcessing(issueIid)) return false;
+    const elapsed = Date.now() - new Date(record.updatedAt).getTime();
+    return elapsed > thresholdMs;
   }
-  async loadRules(rulesDir) {
-    this.rules = [];
-    let files;
-    try {
-      files = await readdir(rulesDir);
-    } catch {
-      return;
-    }
-    const mdcFiles = files.filter((f) => f.endsWith(".mdc"));
-    const loadPromises = mdcFiles.map(async (filename) => {
-      try {
-        const raw = await readFile(path3.join(rulesDir, filename), "utf-8");
-        const { description, alwaysApply, content } = parseFrontmatter(raw);
-        if (content) {
-          this.rules.push({ filename, description, alwaysApply, content });
-        }
-      } catch {
-      }
+  getDrivableIssues(maxRetries, stalledThresholdMs) {
+    return this.getAllRecords().filter((record) => {
+      const lm = this.lifecycleFor(record);
+      if (lm.isDrivable(record.state, record.attempts, maxRetries, record.lastErrorRetryable)) return true;
+      if (this.isStalled(getIid(record), stalledThresholdMs)) return true;
+      return false;
     });
-    await Promise.all(loadPromises);
   }
-  getRules() {
-    return this.rules;
+  getAllActive() {
+    return this.getAllRecords().filter(
+      (r) => !this.lifecycleFor(r).isTerminal(r.state)
+    );
+  }
+  getAll() {
+    return this.getAllRecords();
+  }
+  startSkipped(issueIid) {
+    const record = this.collection[this.key(issueIid)];
+    if (!record || record.state !== "skipped" /* Skipped */) return false;
+    record.state = "pending" /* Pending */;
+    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.save();
+    logger5.info("Skipped issue started", { issueIid });
+    eventBus.emitTyped("issue:stateChanged", { issueIid, state: "pending" /* Pending */, record });
+    return true;
+  }
+  resetFull(issueIid) {
+    const record = this.collection[this.key(issueIid)];
+    if (!record) return false;
+    record.state = "pending" /* Pending */;
+    record.currentPhase = void 0;
+    record.attempts = 0;
+    record.failedAtState = void 0;
+    record.lastError = void 0;
+    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.save();
+    logger5.info("Issue fully reset", { issueIid });
+    eventBus.emitTyped("issue:restarted", { issueIid, record });
+    return true;
+  }
+  resetToPhase(issueIid, phase, def) {
+    const record = this.collection[this.key(issueIid)];
+    if (!record) return false;
+    const lm = new ActionLifecycleManager(def);
+    const targetState = lm.getPhasePreState(phase);
+    if (!targetState) return false;
+    record.state = targetState;
+    if (targetState === "phase_running" /* PhaseRunning */ || targetState === "phase_done" /* PhaseDone */ || targetState === "phase_waiting" /* PhaseWaiting */ || targetState === "phase_approved" /* PhaseApproved */) {
+      const phases = def.phases;
+      const idx = phases.findIndex((p) => p.name === phase);
+      if (idx > 0) {
+        record.currentPhase = phases[idx - 1].name;
+      }
+    }
+    record.failedAtState = void 0;
+    record.lastError = void 0;
+    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.save();
+    logger5.info("Issue reset to phase", { issueIid, phase, state: targetState });
+    eventBus.emitTyped("issue:retryFromPhase", { issueIid, phase, record });
+    return true;
+  }
+  resetForRetry(issueIid) {
+    const record = this.collection[this.key(issueIid)];
+    if (!record || record.state !== "failed" /* Failed */) return false;
+    const restoreState = record.failedAtState ?? "pending" /* Pending */;
+    record.state = restoreState;
+    record.lastError = void 0;
+    record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.save();
+    logger5.info("Issue reset for retry", { issueIid, restoreState });
+    eventBus.emitTyped("issue:resetForRetry", { issueIid, restoreState, record });
+    return true;
   }
-  matchRules(text) {
-    const lowerText = text.toLowerCase();
-    const matched = /* @__PURE__ */ new Map();
-    for (const rule of this.rules) {
-      if (rule.alwaysApply) {
-        matched.set(rule.filename, rule);
+  delete(issueIid) {
+    const key = this.key(issueIid);
+    const record = this.collection[key];
+    if (!record) return false;
+    delete this.collection[key];
+    this.save();
+    logger5.info("Issue deleted from tracker", { issueIid });
+    eventBus.emitTyped("issue:deleted", { issueIid, record });
+    return true;
+  }
+  recoverInterruptedIssues() {
+    let count = 0;
+    for (const record of this.getAllRecords()) {
+      const lm = this.lifecycleFor(record);
+      if (lm.isInProgress(record.state)) {
+        const iid = getIid(record);
+        logger5.warn("Recovering interrupted issue", {
+          issueIid: iid,
+          state: record.state
+        });
+        record.failedAtState = record.state;
+        record.state = "failed" /* Failed */;
+        record.lastError = "Interrupted by service restart";
+        record.attempts += 1;
+        record.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        count++;
+        eventBus.emitTyped("issue:failed", {
+          issueIid: iid,
+          error: "Interrupted by service restart",
+          failedAtState: record.failedAtState,
+          record
+        });
       }
     }
-    if (this.triggers && this.triggers.length > 0) {
-      for (const trigger of this.triggers) {
-        if (matched.has(trigger.filename)) continue;
-        const isTriggered = trigger.keywords.some((kw) => lowerText.includes(kw.toLowerCase()));
-        if (!isTriggered) continue;
-        const rule = this.rules.find((r) => r.filename === trigger.filename);
-        if (rule) {
-          matched.set(rule.filename, rule);
-        }
-      }
-    } else {
-      for (const rule of this.rules) {
-        if (matched.has(rule.filename)) continue;
-        if (!rule.description) continue;
-        const descWords = rule.description.split(/[\s,，;；、/|]+/).filter((w) => w.length >= 2);
-        const isMatched = descWords.some((word) => lowerText.includes(word.toLowerCase()));
-        if (isMatched) {
-          matched.set(rule.filename, rule);
-        }
-      }
+    if (count > 0) {
+      this.save();
+      logger5.info("Recovered interrupted issues", { count });
     }
-    return Array.from(matched.values());
+    return count;
   }
-  formatForPrompt(rules) {
-    if (rules.length === 0) return "";
-    return rules.map((rule) => {
-      const header = rule.description ? `### ${rule.description} (${rule.filename})` : `### ${rule.filename}`;
-      return `${header}
-
-${rule.content}`;
-    }).join("\n\n---\n\n");
+  /** 将所有 IssueRecord 投影为 ExecutableTask[] */
+  toExecutableTasks() {
+    return this.getAllRecords().map((record) => {
+      const lm = this.lifecycleFor(record);
+      return issueToExecutableTask(record, lm);
+    });
   }
 };
 
-// src/notesync/NoteSyncSettings.ts
-var noteSyncOverride;
-function getNoteSyncEnabled(cfg) {
-  return noteSyncOverride ?? cfg.issueNoteSync.enabled;
-}
-function setNoteSyncOverride(value) {
-  noteSyncOverride = value;
-}
-function isNoteSyncEnabledForIssue(issueIid, tracker, cfg) {
-  const record = tracker.get(issueIid);
-  if (record?.issueNoteSyncEnabled !== void 0) return record.issueNoteSyncEnabled;
-  return getNoteSyncEnabled(cfg);
-}
-var SUMMARY_MAX_LENGTH = 500;
-function truncateToSummary(content) {
-  if (content.length <= SUMMARY_MAX_LENGTH) return content;
-  const cut = content.slice(0, SUMMARY_MAX_LENGTH);
-  const lastNewline = cut.lastIndexOf("\n\n");
-  const boundary = lastNewline > SUMMARY_MAX_LENGTH * 0.3 ? lastNewline : cut.lastIndexOf("\n");
-  const summary = boundary > SUMMARY_MAX_LENGTH * 0.3 ? cut.slice(0, boundary) : cut;
-  return summary + "\n\n...";
-}
-function buildNoteSyncComment(phaseName, phaseLabel, docUrl, dashboardUrl, summary) {
-  const emoji = {
-    analysis: "\u{1F50D}",
-    design: "\u{1F4D0}",
-    implement: "\u{1F4BB}",
-    verify: "\u2705",
-    plan: "\u{1F4CB}",
-    review: "\u{1F440}",
-    build: "\u{1F528}"
-  };
-  const icon = emoji[phaseName] || "\u{1F4CB}";
-  return [
-    t("notesync.phaseCompleted", { icon, label: phaseLabel }),
-    "",
-    summary,
-    "",
-    "---",
-    t("notesync.viewDoc", { label: phaseLabel, url: docUrl }),
-    t("notesync.viewDashboard", { url: dashboardUrl })
-  ].join("\n");
-}
-
-// src/phases/BasePhase.ts
-var BasePhase = class _BasePhase {
-  static MIN_ARTIFACT_BYTES = 50;
-  aiRunner;
-  git;
-  plan;
-  config;
-  logger;
-  lifecycle;
-  hooks;
-  /** 多仓模式下所有 repo 的 GitOperations（repo name → GitOperations） */
-  wtGitMap;
-  get startState() {
-    const states = this.lifecycle.getPhaseStates(this.phaseName);
-    if (!states) throw new Error(`Phase "${this.phaseName}" not found in lifecycle manager`);
-    return states.startState;
+// src/persistence/PlanPersistence.ts
+import fs2 from "fs";
+import path2 from "path";
+var logger6 = logger.child("PlanPersistence");
+var PLAN_DIR = ".claude-plan";
+var PlanPersistence = class _PlanPersistence {
+  workDir;
+  issueIid;
+  constructor(workDir, issueIid) {
+    this.workDir = workDir;
+    this.issueIid = issueIid;
   }
-  get doneState() {
-    const states = this.lifecycle.getPhaseStates(this.phaseName);
-    if (!states) throw new Error(`Phase "${this.phaseName}" not found in lifecycle manager`);
-    return states.doneState;
+  get baseDir() {
+    return this.workDir;
   }
-  constructor(aiRunner, git, plan, config, lifecycle, hooks) {
-    this.aiRunner = aiRunner;
-    this.git = git;
-    this.plan = plan;
-    this.config = config;
-    this.lifecycle = lifecycle;
-    this.hooks = hooks;
-    this.logger = logger.child(this.constructor.name);
+  get planDir() {
+    return path2.join(this.workDir, PLAN_DIR, `issue-${this.issueIid}`);
   }
-  /** 注入多仓库 GitOperations map（由编排器在创建 phase 后调用） */
-  setWtGitMap(map) {
-    this.wtGitMap = map;
+  ensureDir() {
+    if (!fs2.existsSync(this.planDir)) {
+      fs2.mkdirSync(this.planDir, { recursive: true });
+    }
   }
-  getRunMode() {
-    return void 0;
+  writeIssueMeta(meta) {
+    this.ensureDir();
+    const filePath = path2.join(this.planDir, "issue-meta.json");
+    fs2.writeFileSync(filePath, JSON.stringify(meta, null, 2), "utf-8");
+    logger6.info("Issue meta written");
   }
-  getResultFiles(_ctx) {
-    return [];
+  writeProgress(data) {
+    this.ensureDir();
+    const filePath = path2.join(this.planDir, "progress.json");
+    fs2.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+    logger6.debug("Progress written", { currentPhase: data.currentPhase });
   }
-  async execute(ctx) {
-    const displayId = Number(ctx.demand.sourceRef.displayId);
-    this.logger.info(`Phase ${this.phaseName} starting`, { issueIid: displayId });
-    const resumeInfo = this.resolveResumeInfo();
-    await this.notifyPhaseStart();
-    this.plan.updatePhaseProgress(this.phaseName, "in_progress", void 0, {
-      preserveSessionId: resumeInfo.resumable
-    });
-    await this.notifyComment(
-      issueProgressComment(this.phaseName, "in_progress")
-    );
-    const phaseLabel = t(`phase.${this.phaseName}`) || this.phaseName;
-    const systemMessage = resumeInfo.resumable ? t("basePhase.aiResuming", { label: phaseLabel }) : t("basePhase.aiStarting", { label: phaseLabel });
-    eventBus.emitTyped("agent:output", {
-      issueIid: displayId,
-      phase: this.phaseName,
-      event: { type: "system", content: systemMessage, timestamp: (/* @__PURE__ */ new Date()).toISOString() }
-    });
-    let basePrompt = this.buildPrompt(ctx);
-    const wsSection = buildWorkspaceSection(ctx.workspace);
-    if (wsSection) {
-      basePrompt = `${basePrompt}
-
-${wsSection}`;
+  readProgress() {
+    const filePath = path2.join(this.planDir, "progress.json");
+    if (!fs2.existsSync(filePath)) return null;
+    try {
+      return JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+    } catch {
+      return null;
     }
-    const matchedRulesText = await this.resolveRules(ctx);
-    const fullPrompt = matchedRulesText ? `${basePrompt}
-
-${t("basePhase.rulesSection", { rules: matchedRulesText })}` : basePrompt;
-    const resumePrompt = t("basePhase.resumePrompt");
-    const onInputRequired = this.buildInputRequiredHandler(displayId);
-    let result;
-    if (resumeInfo.resumable) {
-      this.logger.info("Attempting session resume", {
-        issueIid: displayId,
-        phase: this.phaseName,
-        sessionId: resumeInfo.sessionId
-      });
-      result = await this.runWithResumeFallback(
+  }
+  writeAnalysis(content) {
+    this.ensureDir();
+    fs2.writeFileSync(path2.join(this.planDir, "01-analysis.md"), content, "utf-8");
+    logger6.info("Analysis document written");
+  }
+  writeDesign(content) {
+    this.ensureDir();
+    fs2.writeFileSync(path2.join(this.planDir, "02-design.md"), content, "utf-8");
+    logger6.info("Design document written");
+  }
+  writeTodolist(content) {
+    this.ensureDir();
+    fs2.writeFileSync(path2.join(this.planDir, "03-todolist.md"), content, "utf-8");
+    logger6.info("Todolist written");
+  }
+  writeVerifyReport(content, filename = "04-verify-report.md") {
+    this.ensureDir();
+    fs2.writeFileSync(path2.join(this.planDir, filename), content, "utf-8");
+    logger6.info("Verify report written", { filename });
+  }
+  getAllPlanFiles() {
+    if (!fs2.existsSync(this.planDir)) return [];
+    return fs2.readdirSync(this.planDir).map((f) => path2.join(PLAN_DIR, `issue-${this.issueIid}`, f));
+  }
+  createInitialProgress(displayId, title, branchName, def) {
+    const pending = { status: "pending" };
+    if (def) {
+      const phases = {};
+      for (const spec of def.phases) {
+        phases[spec.name] = { ...pending };
+      }
+      return {
         displayId,
-        resumeInfo.sessionId,
-        resumePrompt,
-        fullPrompt,
-        onInputRequired,
-        ctx
-      );
-    } else {
-      result = await this.runAI(displayId, fullPrompt, onInputRequired, void 0, ctx);
-    }
-    if (!result.success) {
-      this.persistSessionId(result.sessionId);
-      const failReason = (result.errorMessage || result.output).slice(0, 500);
-      const shortReason = (result.errorMessage || result.output).slice(0, 200);
-      this.plan.updatePhaseProgress(this.phaseName, "failed", failReason);
-      await this.notifyPhaseFailed(failReason);
-      await this.notifyComment(
-        issueProgressComment(this.phaseName, "failed", t("basePhase.error", { message: shortReason }))
-      );
-      throw new AIExecutionError(this.phaseName, `Phase ${this.phaseName} failed: ${shortReason}`, {
-        output: result.output,
-        exitCode: result.exitCode,
-        isRetryable: this.classifyRetryable(result)
-      });
+        title,
+        branchName,
+        pipelineMode: def.mode,
+        currentPhase: def.phases[0].name,
+        phases
+      };
     }
-    this.persistSessionId(result.sessionId);
-    await this.validatePhaseOutput(ctx, displayId);
-    await this.notifyPhaseDone();
-    this.plan.updatePhaseProgress(this.phaseName, "completed");
-    await this.commitPlanFiles(ctx, displayId);
-    await this.syncResultToIssue(ctx, displayId);
-    this.logger.info(`Phase ${this.phaseName} completed`, { issueIid: displayId });
-    return result;
+    return {
+      displayId,
+      title,
+      branchName,
+      currentPhase: "analysis",
+      phases: {
+        analysis: { ...pending },
+        design: { ...pending },
+        implement: { ...pending },
+        verify: { ...pending }
+      }
+    };
   }
-  // ── Session resume helpers ──
-  resolveResumeInfo() {
-    if (this.isAcpMode()) {
-      return { resumable: false };
-    }
-    const previousSessionId = this.plan.getPhaseSessionId(this.phaseName);
-    if (!previousSessionId) {
-      return { resumable: false };
-    }
-    const progress = this.plan.readProgress();
-    const phaseStatus = progress?.phases[this.phaseName]?.status;
-    if (phaseStatus !== "failed" && phaseStatus !== "in_progress") {
-      return { resumable: false };
-    }
-    return { resumable: true, sessionId: previousSessionId };
+  writePlan(content) {
+    this.ensureDir();
+    fs2.writeFileSync(path2.join(this.planDir, "01-plan.md"), content, "utf-8");
+    logger6.info("Plan document written");
   }
-  isAcpMode() {
-    return this.config.ai.mode === "codebuddy-acp";
+  writeReviewFeedback(content) {
+    this.ensureDir();
+    const history = this.readReviewHistory();
+    const round = {
+      round: history.length + 1,
+      feedback: content,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    history.push(round);
+    fs2.writeFileSync(
+      path2.join(this.planDir, "review-history.json"),
+      JSON.stringify(history, null, 2),
+      "utf-8"
+    );
+    fs2.writeFileSync(
+      path2.join(this.planDir, "review-feedback.md"),
+      _PlanPersistence.renderReviewHistoryMarkdown(history),
+      "utf-8"
+    );
+    logger6.info("Review feedback appended", { round: round.round });
   }
-  resolveAIWorkDir(ctx) {
-    if (ctx?.workspace && ctx.workspace.repos.length > 1) {
-      return ctx.workspace.workspaceRoot;
+  readReviewFeedback() {
+    const filePath = path2.join(this.planDir, "review-feedback.md");
+    if (!fs2.existsSync(filePath)) return null;
+    try {
+      return fs2.readFileSync(filePath, "utf-8");
+    } catch {
+      return null;
     }
-    return this.plan.baseDir;
   }
-  async runAI(displayId, prompt, onInputRequired, options, ctx) {
-    let capturedSessionId;
-    const result = await this.aiRunner.run({
-      prompt,
-      workDir: this.resolveAIWorkDir(ctx),
-      timeoutMs: this.config.ai.phaseTimeoutMs,
-      idleTimeoutMs: this.config.ai.idleTimeoutMs,
-      mode: this.getRunMode(),
-      sessionId: options?.sessionId,
-      continueSession: options?.continueSession,
-      onStreamEvent: (event) => {
-        if (!capturedSessionId && event.type !== "raw") {
-          const content = event.content;
-          if (content?.session_id && typeof content.session_id === "string") {
-            capturedSessionId = content.session_id;
-            this.persistSessionId(capturedSessionId);
-          }
-        }
-        eventBus.emitTyped("agent:output", {
-          issueIid: displayId,
-          phase: this.phaseName,
-          event
-        });
-      },
-      onInputRequired
-    });
-    if (result.sessionId) {
-      this.persistSessionId(result.sessionId);
+  readReviewHistory() {
+    const filePath = path2.join(this.planDir, "review-history.json");
+    if (!fs2.existsSync(filePath)) return [];
+    try {
+      const data = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+      return Array.isArray(data) ? data : [];
+    } catch {
+      return [];
     }
-    return result;
   }
-  async runWithResumeFallback(displayId, sessionId, resumePrompt, fullPrompt, onInputRequired, ctx) {
-    const result = await this.runAI(displayId, resumePrompt, onInputRequired, {
-      sessionId,
-      continueSession: true
-    }, ctx);
-    if (!result.success && this.isResumeFailure(result)) {
-      this.logger.warn(t("basePhase.resumeFallback"), {
-        issueIid: displayId,
-        phase: this.phaseName,
-        exitCode: result.exitCode
-      });
-      eventBus.emitTyped("agent:output", {
-        issueIid: displayId,
-        phase: this.phaseName,
-        event: {
-          type: "system",
-          content: t("basePhase.resumeFallback"),
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        }
-      });
-      return this.runAI(displayId, fullPrompt, onInputRequired, void 0, ctx);
+  static renderReviewHistoryMarkdown(history) {
+    if (history.length === 0) return "";
+    const lines = ["# \u5BA1\u6838\u53CD\u9988\u5386\u53F2", ""];
+    for (const r of history) {
+      lines.push(`## \u7B2C ${r.round} \u8F6E\u5BA1\u6838\u53CD\u9988`);
+      lines.push(`> \u65F6\u95F4: ${r.timestamp}`);
+      lines.push("");
+      lines.push(r.feedback);
+      lines.push("");
     }
-    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));
+    return lines.join("\n");
   }
-  /**
-   * 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;
+  updatePhaseProgress(phaseName, status, error, options) {
+    const progress = this.readProgress();
+    if (!progress) return;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    if (!progress.phases[phaseName]) {
+      progress.phases[phaseName] = { status: "pending" };
     }
-    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;
+    const phase = progress.phases[phaseName];
+    phase.status = status;
+    if (status === "in_progress") {
+      phase.startedAt = now;
+      progress.currentPhase = phaseName;
+      if (!options?.preserveSessionId) {
+        delete phase.sessionId;
+      }
+    } else if (status === "completed") {
+      phase.completedAt = now;
+    } else if (status === "failed") {
+      phase.error = error;
     }
-    return false;
+    this.writeProgress(progress);
   }
-  persistSessionId(sessionId) {
-    if (sessionId) {
-      this.plan.updatePhaseSessionId(this.phaseName, sessionId);
-    }
+  updatePhaseSessionId(phaseName, sessionId) {
+    const progress = this.readProgress();
+    if (!progress?.phases[phaseName]) return;
+    progress.phases[phaseName].sessionId = sessionId;
+    this.writeProgress(progress);
   }
-  // ── Hook dispatch methods ──
-  async notifyPhaseStart() {
-    await this.hooks.onPhaseStart(this.phaseName);
+  getPhaseSessionId(phaseName) {
+    const progress = this.readProgress();
+    return progress?.phases[phaseName]?.sessionId;
   }
-  async notifyPhaseDone() {
-    await this.hooks.onPhaseDone(this.phaseName);
+};
+
+// src/phases/BasePhase.ts
+import fs3 from "fs";
+import path4 from "path";
+
+// src/rules/RuleResolver.ts
+import { readdir, readFile } from "fs/promises";
+import path3 from "path";
+function parseFrontmatter(raw) {
+  const fmRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
+  const match = raw.match(fmRegex);
+  if (!match) {
+    return { description: "", alwaysApply: false, content: raw.trim() };
   }
-  async notifyPhaseFailed(error) {
-    await this.hooks.onPhaseFailed(this.phaseName, error);
+  const yamlBlock = match[1];
+  const content = raw.slice(match[0].length).trim();
+  let description = "";
+  const descMatch = yamlBlock.match(/description:\s*(.+)/);
+  if (descMatch) {
+    description = descMatch[1].trim();
   }
-  async notifyComment(message) {
-    try {
-      await this.hooks.onComment(message);
-    } catch (err) {
-      this.logger.warn("Hook onComment failed", { error: err.message });
-    }
+  let alwaysApply = false;
+  const applyMatch = yamlBlock.match(/alwaysApply:\s*(true|false)/i);
+  if (applyMatch) {
+    alwaysApply = applyMatch[1].toLowerCase() === "true";
   }
-  /**
-   * 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);
-      });
-    };
+  return { description, alwaysApply, content };
+}
+var RuleResolver = class {
+  rules = [];
+  triggers;
+  constructor(ruleTriggers) {
+    this.triggers = ruleTriggers;
   }
-  async resolveRules(ctx) {
+  async loadRules(rulesDir) {
+    this.rules = [];
+    let files;
     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 {
-          }
+      files = await readdir(rulesDir);
+    } catch {
+      return;
+    }
+    const mdcFiles = files.filter((f) => f.endsWith(".mdc"));
+    const loadPromises = mdcFiles.map(async (filename) => {
+      try {
+        const raw = await readFile(path3.join(rulesDir, filename), "utf-8");
+        const { description, alwaysApply, content } = parseFrontmatter(raw);
+        if (content) {
+          this.rules.push({ filename, description, alwaysApply, content });
         }
-      } else {
-        const rulesDir = path4.join(this.plan.baseDir, ".cursor", "rules");
-        await resolver.loadRules(rulesDir);
+      } catch {
       }
-      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);
+    });
+    await Promise.all(loadPromises);
+  }
+  getRules() {
+    return this.rules;
+  }
+  matchRules(text) {
+    const lowerText = text.toLowerCase();
+    const matched = /* @__PURE__ */ new Map();
+    for (const rule of this.rules) {
+      if (rule.alwaysApply) {
+        matched.set(rule.filename, rule);
       }
-    } 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;
+    if (this.triggers && this.triggers.length > 0) {
+      for (const trigger of this.triggers) {
+        if (matched.has(trigger.filename)) continue;
+        const isTriggered = trigger.keywords.some((kw) => lowerText.includes(kw.toLowerCase()));
+        if (!isTriggered) continue;
+        const rule = this.rules.find((r) => r.filename === trigger.filename);
+        if (rule) {
+          matched.set(rule.filename, rule);
+        }
       }
-      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 });
+    } else {
+      for (const rule of this.rules) {
+        if (matched.has(rule.filename)) continue;
+        if (!rule.description) continue;
+        const descWords = rule.description.split(/[\s,，;；、/|]+/).filter((w) => w.length >= 2);
+        const isMatched = descWords.some((word) => lowerText.includes(word.toLowerCase()));
+        if (isMatched) {
+          matched.set(rule.filename, rule);
+        }
       }
-    } catch (err) {
-      this.logger.warn("Failed to sync result to issue", { error: err.message });
-      await this.notifyComment(
-        issueProgressComment(this.phaseName, "completed")
-      );
     }
+    return Array.from(matched.values());
+  }
+  formatForPrompt(rules) {
+    if (rules.length === 0) return "";
+    return rules.map((rule) => {
+      const header = rule.description ? `### ${rule.description} (${rule.filename})` : `### ${rule.filename}`;
+      return `${header}
+
+${rule.content}`;
+    }).join("\n\n---\n\n");
+  }
+};
+
+// src/notesync/NoteSyncSettings.ts
+var noteSyncOverride;
+function getNoteSyncEnabled(cfg) {
+  return noteSyncOverride ?? cfg.issueNoteSync.enabled;
+}
+function setNoteSyncOverride(value) {
+  noteSyncOverride = value;
+}
+function isNoteSyncEnabledForIssue(issueIid, tracker, cfg) {
+  const record = tracker.get(issueIid);
+  if (record?.issueNoteSyncEnabled !== void 0) return record.issueNoteSyncEnabled;
+  return getNoteSyncEnabled(cfg);
+}
+var SUMMARY_MAX_LENGTH = 500;
+function truncateToSummary(content) {
+  if (content.length <= SUMMARY_MAX_LENGTH) return content;
+  const cut = content.slice(0, SUMMARY_MAX_LENGTH);
+  const lastNewline = cut.lastIndexOf("\n\n");
+  const boundary = lastNewline > SUMMARY_MAX_LENGTH * 0.3 ? lastNewline : cut.lastIndexOf("\n");
+  const summary = boundary > SUMMARY_MAX_LENGTH * 0.3 ? cut.slice(0, boundary) : cut;
+  return summary + "\n\n...";
+}
+function buildNoteSyncComment(phaseName, phaseLabel, docUrl, dashboardUrl, summary) {
+  const emoji = {
+    analysis: "\u{1F50D}",
+    design: "\u{1F4D0}",
+    implement: "\u{1F4BB}",
+    verify: "\u2705",
+    plan: "\u{1F4CB}",
+    review: "\u{1F440}",
+    build: "\u{1F528}"
+  };
+  const icon = emoji[phaseName] || "\u{1F4CB}";
+  return [
+    t("notesync.phaseCompleted", { icon, label: phaseLabel }),
+    "",
+    summary,
+    "",
+    "---",
+    t("notesync.viewDoc", { label: phaseLabel, url: docUrl }),
+    t("notesync.viewDashboard", { url: dashboardUrl })
+  ].join("\n");
+}
+
+// src/phases/BasePhase.ts
+var BasePhase = class _BasePhase {
+  static MIN_ARTIFACT_BYTES = 50;
+  aiRunner;
+  git;
+  plan;
+  config;
+  logger;
+  lifecycle;
+  hooks;
+  /** 多仓模式下所有 repo 的 GitOperations（repo name → GitOperations） */
+  wtGitMap;
+  get startState() {
+    const states = this.lifecycle.getPhaseStates(this.phaseName);
+    if (!states) throw new Error(`Phase "${this.phaseName}" not found in lifecycle manager`);
+    return states.startState;
+  }
+  get doneState() {
+    const states = this.lifecycle.getPhaseStates(this.phaseName);
+    if (!states) throw new Error(`Phase "${this.phaseName}" not found in lifecycle manager`);
+    return states.doneState;
+  }
+  constructor(aiRunner, git, plan, config, lifecycle, hooks) {
+    this.aiRunner = aiRunner;
+    this.git = git;
+    this.plan = plan;
+    this.config = config;
+    this.lifecycle = lifecycle;
+    this.hooks = hooks;
+    this.logger = logger.child(this.constructor.name);
+  }
+  /** 注入多仓库 GitOperations map（由编排器在创建 phase 后调用） */
+  setWtGitMap(map) {
+    this.wtGitMap = map;
+  }
+  getRunMode() {
+    return void 0;
   }
-  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;
-    }
+  getResultFiles(_ctx) {
+    return [];
   }
-  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 execute(ctx) {
+    const displayId = Number(ctx.demand.sourceRef.displayId);
+    this.logger.info(`Phase ${this.phaseName} starting`, { issueIid: displayId });
+    const resumeInfo = this.resolveResumeInfo();
+    await this.notifyPhaseStart();
+    this.plan.updatePhaseProgress(this.phaseName, "in_progress", void 0, {
+      preserveSessionId: resumeInfo.resumable
+    });
+    await this.notifyComment(
+      issueProgressComment(this.phaseName, "in_progress")
+    );
+    const phaseLabel = t(`phase.${this.phaseName}`) || this.phaseName;
+    const systemMessage = resumeInfo.resumable ? t("basePhase.aiResuming", { label: phaseLabel }) : t("basePhase.aiStarting", { label: phaseLabel });
+    eventBus.emitTyped("agent:output", {
+      issueIid: displayId,
+      phase: this.phaseName,
+      event: { type: "system", content: systemMessage, timestamp: (/* @__PURE__ */ new Date()).toISOString() }
+    });
+    let basePrompt = this.buildPrompt(ctx);
+    const wsSection = buildWorkspaceSection(ctx.workspace);
+    if (wsSection) {
+      basePrompt = `${basePrompt}
+
+${wsSection}`;
     }
-  }
-  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
-          });
-        }
-      }
+    const matchedRulesText = await this.resolveRules(ctx);
+    const fullPrompt = matchedRulesText ? `${basePrompt}
+
+${t("basePhase.rulesSection", { rules: matchedRulesText })}` : basePrompt;
+    const resumePrompt = t("basePhase.resumePrompt");
+    const onInputRequired = this.buildInputRequiredHandler(displayId);
+    let result;
+    if (resumeInfo.resumable) {
+      this.logger.info("Attempting session resume", {
+        issueIid: displayId,
+        phase: this.phaseName,
+        sessionId: resumeInfo.sessionId
+      });
+      result = await this.runWithResumeFallback(
+        displayId,
+        resumeInfo.sessionId,
+        resumePrompt,
+        fullPrompt,
+        onInputRequired,
+        ctx
+      );
     } else {
-      if (await this.git.hasChanges()) {
-        await this.git.add(["."]);
-        await this.git.commit(commitMsg);
-        await this.git.push(ctx.branchName);
-      }
+      result = await this.runAI(displayId, fullPrompt, onInputRequired, void 0, ctx);
+    }
+    if (!result.success) {
+      this.persistSessionId(result.sessionId);
+      const failReason = (result.errorMessage || result.output).slice(0, 500);
+      const shortReason = (result.errorMessage || result.output).slice(0, 200);
+      this.plan.updatePhaseProgress(this.phaseName, "failed", failReason);
+      await this.notifyPhaseFailed(failReason);
+      await this.notifyComment(
+        issueProgressComment(this.phaseName, "failed", t("basePhase.error", { message: shortReason }))
+      );
+      throw new AIExecutionError(this.phaseName, `Phase ${this.phaseName} failed: ${shortReason}`, {
+        output: result.output,
+        exitCode: result.exitCode,
+        isRetryable: this.classifyRetryable(result)
+      });
     }
+    this.persistSessionId(result.sessionId);
+    await this.validatePhaseOutput(ctx, displayId);
+    await this.notifyPhaseDone();
+    this.plan.updatePhaseProgress(this.phaseName, "completed");
+    await this.commitPlanFiles(ctx, displayId);
+    await this.syncResultToIssue(ctx, displayId);
+    this.logger.info(`Phase ${this.phaseName} completed`, { issueIid: displayId });
+    return result;
   }
-};
-
-// 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}`);
+  // ── Session resume helpers ──
+  resolveResumeInfo() {
+    if (this.isAcpMode()) {
+      return { resumable: false };
     }
-    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 previousSessionId = this.plan.getPhaseSessionId(this.phaseName);
+    if (!previousSessionId) {
+      return { resumable: false };
     }
-    const passed = failureReasons.length === 0;
-    return {
-      passed,
-      lintPassed,
-      buildPassed,
-      testPassed,
-      todolistComplete,
-      todolistStats: todolistStats ?? void 0,
-      failureReasons,
-      rawReport: reportContent
-    };
+    const progress = this.plan.readProgress();
+    const phaseStatus = progress?.phases[this.phaseName]?.status;
+    if (phaseStatus !== "failed" && phaseStatus !== "in_progress") {
+      return { resumable: false };
+    }
+    return { resumable: true, sessionId: previousSessionId };
   }
-  /**
-   * 从 plan 文件中解析 Todolist 完成度。
-   * 统计 `- [x]` (已完成) 和 `- [ ]` (未完成) 的数量。
-   */
-  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
-    };
+  isAcpMode() {
+    return this.config.ai.mode === "codebuddy-acp";
   }
-  /**
-   * 从报告中提取 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)
-      };
+  resolveAIWorkDir(ctx) {
+    if (ctx?.workspace && ctx.workspace.repos.length > 1) {
+      return ctx.workspace.workspaceRoot;
     }
-    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" }];
+    return this.plan.baseDir;
   }
-  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;
-              }
-            }
+  async runAI(displayId, prompt, onInputRequired, options, ctx) {
+    let capturedSessionId;
+    const result = await this.aiRunner.run({
+      prompt,
+      workDir: this.resolveAIWorkDir(ctx),
+      timeoutMs: this.config.ai.phaseTimeoutMs,
+      idleTimeoutMs: this.config.ai.idleTimeoutMs,
+      mode: this.getRunMode(),
+      sessionId: options?.sessionId,
+      continueSession: options?.continueSession,
+      onStreamEvent: (event) => {
+        if (!capturedSessionId && event.type !== "raw") {
+          const content = event.content;
+          if (content?.session_id && typeof content.session_id === "string") {
+            capturedSessionId = content.session_id;
+            this.persistSessionId(capturedSessionId);
           }
         }
-        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
+        eventBus.emitTyped("agent:output", {
+          issueIid: displayId,
+          phase: this.phaseName,
+          event
         });
-        return { ...result, verifyReport: parsed };
-      }
+      },
+      onInputRequired
+    });
+    if (result.sessionId) {
+      this.persistSessionId(result.sessionId);
     }
     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);
-  }
-  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;
-    }
-  }
-  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;
+  async runWithResumeFallback(displayId, sessionId, resumePrompt, fullPrompt, onInputRequired, ctx) {
+    const result = await this.runAI(displayId, resumePrompt, onInputRequired, {
+      sessionId,
+      continueSession: true
+    }, ctx);
+    if (!result.success && this.isResumeFailure(result)) {
+      this.logger.warn(t("basePhase.resumeFallback"), {
+        issueIid: displayId,
+        phase: this.phaseName,
+        exitCode: result.exitCode
+      });
+      eventBus.emitTyped("agent:output", {
+        issueIid: displayId,
+        phase: this.phaseName,
+        event: {
+          type: "system",
+          content: t("basePhase.resumeFallback"),
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        }
+      });
+      return this.runAI(displayId, fullPrompt, onInputRequired, void 0, ctx);
     }
+    return result;
   }
-};
-
-// 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";
+  /**
+   * 判断 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));
   }
-  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);
+  /**
+   * 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;
     }
-    const caps = getRunnerCapabilities(this.config.ai.mode);
-    if (!caps?.nativePlanMode) {
-      basePrompt = `${t("prompt.planModeFallback")}
-
-${basePrompt}`;
+    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 basePrompt;
+    return false;
   }
-};
-
-// 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();
-    }
-    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 });
+  persistSessionId(sessionId) {
+    if (sessionId) {
+      this.plan.updatePhaseSessionId(this.phaseName, sessionId);
     }
   }
-  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)
-      });
-    }
-    return base;
+  // ── Hook dispatch methods ──
+  async notifyPhaseStart() {
+    await this.hooks.onPhaseStart(this.phaseName);
   }
-};
-
-// 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");
+  async notifyPhaseDone() {
+    await this.hooks.onPhaseDone(this.phaseName);
   }
-  filePath(projectPath) {
-    return path6.join(this.cacheDir, `${hashProjectPath(projectPath)}.json`);
+  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 });
+    }
   }
   /**
-   * 读取缓存。返回 null 如果不存在、已过期或校验失败。
+   * Build an onInputRequired handler for ACP permission delegation.
+   * Only returns a handler when codebuddyAcpAutoApprove is false,
+   * enabling review gate delegation for permission requests.
    */
-  get(projectPath, ttlMs) {
-    const fp = this.filePath(projectPath);
+  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 {
-      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;
       }
-      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 });
-    }
-  }
-  /**
-   * 手动失效缓存。
-   */
-  invalidate(projectPath) {
-    const fp = this.filePath(projectPath);
-    try {
-      if (fs5.existsSync(fp)) {
-        fs5.unlinkSync(fp);
-        logger7.info("Release detect cache invalidated", { projectPath });
-        return true;
+      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 });
       }
-      return false;
     } catch (err) {
-      logger7.warn("Failed to invalidate release detect cache", { path: fp, error: err.message });
-      return false;
+      this.logger.warn("Failed to sync result to issue", { error: err.message });
+      await this.notifyComment(
+        issueProgressComment(this.phaseName, "completed")
+      );
     }
   }
-};
-
-// 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;
-  /**
-   * 检测结果是否已存在（即是否处于执行模式）。
-   */
-  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;
+  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 JSON.parse(fs6.readFileSync(fp, "utf-8"));
+      return fs3.readFileSync(filePath, "utf-8");
     } catch {
       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");
-  }
-  getResultFiles(_ctx) {
-    if (this.hasDetectionResult()) {
-      return [{ filename: REPORT_FILENAME, label: "\u53D1\u5E03\u62A5\u544A" }];
+  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)`);
+      }
     }
-    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 (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 });
     }
-    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");
+  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 {
-          await this.git.add(["."]);
-          await this.git.commit(`chore: release detection (cached) for issue-${ctx.demand.sourceRef.displayId}`);
-        } catch {
+          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
+          });
         }
-        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
-        };
       }
-    }
-    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
-        };
+    } else {
+      if (await this.git.hasChanges()) {
+        await this.git.add(["."]);
+        await this.git.commit(commitMsg);
+        await this.git.push(ctx.branchName);
       }
-      return { ...result, gateRequested: false, hasReleaseCapability: false };
     }
-    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" }];
-  }
-  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}`;
   }
 };
 
-// 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/phases/VerifyPhase.ts
+import fs4 from "fs";
+import path5 from "path";
 
-// 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 ───
+// 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 {
   /**
-   * 将 IssueState 解析为语义化的 ActionState。
+   * 解析验证报告内容。
    *
-   * 对于通用状态 PhaseRunning/PhaseDone，需额外传入 currentPhase 来区分具体阶段。
+   * @param reportContent 验证报告的完整 Markdown 文本
    */
-  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" };
+  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}`);
     }
-    if (state === "phase_approved" /* PhaseApproved */ && currentPhase) {
-      return { action: currentPhase, status: "ready" };
+    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 mapped = this.stateToAction.get(state);
-    if (mapped) return mapped;
-    return { action: "init", status: "idle" };
+    const passed = failureReasons.length === 0;
+    return {
+      passed,
+      lintPassed,
+      buildPassed,
+      testPassed,
+      todolistComplete,
+      todolistStats: todolistStats ?? void 0,
+      failureReasons,
+      rawReport: reportContent
+    };
   }
   /**
-   * 将 action + status 反向映射为 IssueState。
+   * 从 plan 文件中解析 Todolist 完成度。
+   * 统计 `- [x]` (已完成) 和 `- [ ]` (未完成) 的数量。
    */
-  toIssueState(action, status) {
-    return this.actionToState.get(`${action}:${status}`);
+  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
+    };
   }
-  // ─── Classification predicates (替代 3 个 Set 常量 + getDrivableIssues) ───
   /**
-   * 终态：done | failed | skipped
+   * 从报告中提取 Todolist 统计数据。
+   * 格式: "Todolist 检查: X/Y 项完成"
    */
-  isTerminal(state) {
-    const as = this.resolve(state);
-    return as.status === "done" || as.status === "failed" || as.status === "skipped";
+  parseTodolistStats(reportContent) {
+    const match = reportContent.match(TODOLIST_STATS_RE);
+    if (match) {
+      return {
+        completed: parseInt(match[1], 10),
+        total: parseInt(match[2], 10)
+      };
+    }
+    return null;
   }
-  /**
-   * 进行中：running (包含通用 PhaseRunning)
-   */
-  isInProgress(state) {
-    if (state === "phase_running" /* PhaseRunning */) return true;
-    return this.resolve(state).status === "running";
+};
+
+// 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" }];
   }
-  /**
-   * 阻塞中：waiting
-   */
-  isBlocked(state) {
-    if (state === "phase_waiting" /* PhaseWaiting */) return true;
-    return this.resolve(state).status === "waiting";
+  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 result;
   }
-  /**
-   * 可驱动判断（集中化 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;
+  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);
+  }
+  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;
     }
   }
-  // ─── 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;
-      }
+  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;
     }
-    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;
+  }
+};
+
+// 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
+    };
+    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}`;
+    }
+    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;
         }
-        return idx;
       }
+    } else {
+      hasAnyChanges = await this.git.hasChanges();
     }
-    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;
-      }
+    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 });
     }
-    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;
+  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)
+      });
+    }
+    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`);
   }
   /**
-   * 获取某个 phase 的状态三元组。
+   * 读取缓存。返回 null 如果不存在、已过期或校验失败。
    */
-  getPhaseStates(phaseName) {
-    return this.phaseStatesMap.get(phaseName);
+  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;
+      }
+      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;
+    }
   }
-  // ─── 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 });
+  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 });
     }
-    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 }));
+  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;
     }
-    labels.set("completed" /* Completed */, t("state.completed"));
-    labels.set("failed" /* Failed */, t("state.failed"));
-    labels.set("resolving_conflict" /* ResolvingConflict */, t("state.resolvingConflict"));
-    return labels;
   }
+};
+
+// 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;
   /**
-   * 根据当前 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;
+  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;
     }
-    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;
+  }
+  writeDetectionFile(result) {
+    const dir = this.planDir;
+    if (!fs6.existsSync(dir)) {
+      fs6.mkdirSync(dir, { recursive: true });
     }
-    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;
+    fs6.writeFileSync(path7.join(dir, DETECT_FILENAME), JSON.stringify(result, null, 2), "utf-8");
+  }
+  getResultFiles(_ctx) {
+    if (this.hasDetectionResult()) {
+      return [{ filename: REPORT_FILENAME, label: "\u53D1\u5E03\u62A5\u544A" }];
     }
-    if (currentState === "completed" /* Completed */ || currentState === "resolving_conflict" /* ResolvingConflict */) {
-      for (const phase of this.def.phases) {
-        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);
     }
-    for (const phase of this.def.phases) {
-      if (passedCurrent) {
-        result[phase.name] = "pending";
-        continue;
+    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
+        };
       }
-      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();
@@ -3171,38 +3171,8 @@ var PortAllocator = class {
 import { spawn } from "child_process";
 import fs10 from "fs";
 import path11 from "path";
-import net2 from "net";
 var logger12 = logger.child("DevServerManager");
-var DEFAULT_OPTIONS2 = {
-  healthCheckTimeoutMs: 12e4,
-  healthCheckIntervalMs: 3e3
-};
-function waitForPort(port, timeoutMs, intervalMs) {
-  return new Promise((resolve, reject) => {
-    const deadline = Date.now() + timeoutMs;
-    const check = () => {
-      if (Date.now() > deadline) {
-        reject(new Error(`Port ${port} not ready after ${timeoutMs}ms`));
-        return;
-      }
-      const socket = net2.createConnection({ host: "127.0.0.1", port });
-      socket.setTimeout(5e3);
-      socket.on("connect", () => {
-        socket.destroy();
-        resolve();
-      });
-      socket.on("error", () => {
-        socket.destroy();
-        setTimeout(check, intervalMs);
-      });
-      socket.on("timeout", () => {
-        socket.destroy();
-        setTimeout(check, intervalMs);
-      });
-    };
-    check();
-  });
-}
+var DEFAULT_OPTIONS2 = {};
 var DevServerManager = class {
   servers = /* @__PURE__ */ new Map();
   options;
@@ -3287,29 +3257,9 @@ var DevServerManager = class {
       frontendLog
     };
     this.servers.set(wtCtx.issueIid, serverSet);
-    logger12.info("Waiting for servers to become healthy", { issueIid: wtCtx.issueIid });
-    try {
-      await Promise.all([
-        waitForPort(
-          ports.backendPort,
-          this.options.healthCheckTimeoutMs,
-          this.options.healthCheckIntervalMs
-        ),
-        waitForPort(
-          ports.frontendPort,
-          this.options.healthCheckTimeoutMs,
-          this.options.healthCheckIntervalMs
-        )
-      ]);
-      logger12.info("Dev servers healthy", { issueIid: wtCtx.issueIid, ...ports });
-    } catch (err) {
-      logger12.error("Dev servers failed health check, cleaning up", {
-        issueIid: wtCtx.issueIid,
-        error: err.message
-      });
-      this.stopServers(wtCtx.issueIid);
-      throw err;
-    }
+    logger12.info("Dev servers spawned, waiting for startup", { issueIid: wtCtx.issueIid, ...ports });
+    await new Promise((r) => setTimeout(r, 1e4));
+    logger12.info("Dev servers startup grace period done", { issueIid: wtCtx.issueIid });
   }
   stopServers(issueIid) {
     const set = this.servers.get(issueIid);
@@ -4424,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) {
@@ -5145,4 +5098,4 @@ export {
   PipelineOrchestrator,
   BrainstormService
 };
-//# sourceMappingURL=chunk-CUZCZUMA.js.map
+//# sourceMappingURL=chunk-7D2NH37P.js.map