@xdevops/issue-auto-finish 1.0.90 → 1.0.92

package/dist/cli.js

@@ -93,7 +93,7 @@ program.command("init").description("Launch the interactive web setup wizard").o
   await initCommand({ port: parseInt(opts.port, 10), config: opts.config });
 });
 program.command("start").description("Start the issue-auto-finish daemon service").option("-c, --config <path>", "Path to .env config file").option("-d, --daemon", "Run as a background daemon").action(async (opts) => {
-  const { startCommand } = await import("./start-ECUOKGM2.js");
+  const { startCommand } = await import("./start-IQBNXLEI.js");
   await startCommand({ config: opts.config, daemon: opts.daemon });
 });
 program.command("stop").description("Stop the running service").option("-p, --port <port>", "Web UI port", defaults.port).option("-H, --host <host>", "Service host", defaults.host).option("-f, --force", "Force kill via SIGKILL").action(async (opts) => {
@@ -105,7 +105,7 @@ program.command("stop").description("Stop the running service").option("-p, --po
   });
 });
 program.command("restart").description("Restart the service (stop + start)").option("-c, --config <path>", "Path to .env config file").option("-p, --port <port>", "Web UI port", defaults.port).option("-H, --host <host>", "Service host", defaults.host).option("-d, --daemon", "Restart as a background daemon").action(async (opts) => {
-  const { restartCommand } = await import("./restart-2BCP6AMK.js");
+  const { restartCommand } = await import("./restart-5D3ZDD5L.js");
   await restartCommand({
     config: opts.config,
     host: opts.host,

package/dist/hooks/HookEventWatcher.d.ts

@@ -0,0 +1,34 @@
+import type { HookEvent } from './HookInjector.js';
+export interface Disposable {
+    dispose(): void;
+}
+/**
+ * 监听 hook 事件文件（JSONL），解析新增行并回调。
+ *
+ * 使用 fs.watch + 文件偏移量追踪实现增量读取。
+ * 当 fs.watch 不可靠时（某些网络文件系统），通过定期 poll 兜底。
+ */
+export declare class HookEventWatcher {
+    private readonly eventsFile;
+    private watcher;
+    private pollTimer;
+    private offset;
+    private listeners;
+    private started;
+    constructor(eventsFile: string);
+    start(): void;
+    stop(): void;
+    onEvent(callback: (event: HookEvent) => void): Disposable;
+    /**
+     * 等待指定类型的事件，带超时。
+     * 对于 'stop' 事件，只有 blocked=false 时才 resolve。
+     */
+    waitForEvent(eventType: HookEvent['event'], timeoutMs: number): Promise<HookEvent>;
+    /** 获取已记录的所有产物写入事件摘要 */
+    getArtifactSummary(): string;
+    private readNewEvents;
+    private readAll;
+    private emit;
+    private getCurrentSize;
+}
+//# sourceMappingURL=HookEventWatcher.d.ts.map

package/dist/hooks/HookEventWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookEventWatcher.d.ts","sourceRoot":"","sources":["../../src/hooks/HookEventWatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKnD,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,MAAM;IAI9B,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAYZ,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,UAAU;IASzD;;;OAGG;IACH,YAAY,CACV,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,CAAC;IAiBrB,uBAAuB;IACvB,kBAAkB,IAAI,MAAM;IAY5B,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,cAAc;CAOvB"}

package/dist/hooks/HookInjector.d.ts

@@ -0,0 +1,85 @@
+export interface HookContext {
+    workDir: string;
+    planDir: string;
+    /** All pipeline artifacts (used by PostToolUse to track writes across phases). */
+    expectedArtifacts: string[];
+    /** Current phase artifacts only (used by Stop hook to gate completion). Falls back to expectedArtifacts if omitted. */
+    phaseExpectedArtifacts?: string[];
+    issueIid: number;
+    phaseName?: string;
+    issueTitle?: string;
+    issueDescription?: string;
+}
+export interface ArtifactEntry {
+    ts: string;
+    file: string;
+    path: string;
+    bytes: number;
+    event: 'write';
+}
+export interface StopEntry {
+    ts: string;
+    event: 'stop';
+    blocked: boolean;
+    missing?: string;
+}
+export type ManifestEntry = ArtifactEntry | StopEntry;
+/**
+ * 在 worktree 中动态注入 Claude Code hooks。
+ *
+ * 在 SetupStep 中调用 inject()，生成：
+ *   - {workDir}/.claude/settings.local.json（合并已有 permissions + 追加 hooks）
+ *   - {workDir}/.claude-plan/.hooks/*.sh（hook 脚本，上下文以绝对路径嵌入）
+ *   - {workDir}/.claude-plan/.hook-context.json（阶段上下文，供 compact restore 读取）
+ *
+ * Claude Code PTY 启动后自动加载 settings.local.json 中的 hooks。
+ */
+export declare class HookInjector {
+    inject(ctx: HookContext): void;
+    /**
+     * 阶段切换时更新 hooks 配置（重写脚本 + settings.local.json）。
+     * 保留 events/manifest 文件（不截断），仅更新脚本和配置。
+     */
+    updateForPhase(ctx: HookContext): void;
+    readManifest(workDir: string): ManifestEntry[];
+    readEvents(workDir: string): HookEvent[];
+    getEventsFilePath(workDir: string): string;
+    getManifestFilePath(workDir: string): string;
+    cleanup(workDir: string): void;
+    private writeHookScripts;
+    private writeContextFile;
+    private writeSettingsLocal;
+    private initEventsFile;
+}
+export type HookEvent = {
+    ts: string;
+    event: 'session_start';
+    session_id: string;
+} | {
+    ts: string;
+    event: 'compact_restore';
+} | {
+    ts: string;
+    event: 'artifact_write';
+    file: string;
+    path: string;
+    bytes: number;
+} | {
+    ts: string;
+    event: 'permission_request';
+    tool: string;
+} | {
+    ts: string;
+    event: 'exit_plan_mode';
+} | {
+    ts: string;
+    event: 'protect_blocked';
+    tool: string;
+    file: string;
+} | {
+    ts: string;
+    event: 'stop';
+    blocked: boolean;
+    missing?: string;
+};
+//# sourceMappingURL=HookInjector.d.ts.map

package/dist/hooks/HookInjector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookInjector.d.ts","sourceRoot":"","sources":["../../src/hooks/HookInjector.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,uHAAuH;IACvH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAEtD;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAa9B;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAWtC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE;IAK9C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAKxC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI1C,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI5C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe9B,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,cAAc;CAMvB;AAMD,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACvC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { HookInjector } from './HookInjector.js';
+export type { HookContext, ArtifactEntry, StopEntry, ManifestEntry, HookEvent } from './HookInjector.js';
+export { HookEventWatcher } from './HookEventWatcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,13 +1,13 @@
 import {
   main
-} from "./chunk-Y62E72TA.js";
+} from "./chunk-6T7ZHAV2.js";
 import "./chunk-5M5SB6ZA.js";
 import "./chunk-ENF24C44.js";
 import "./chunk-Z3OBKODV.js";
 import "./chunk-EU4XFZ2T.js";
 import "./chunk-KC5S66OZ.js";
 import "./chunk-SEO57UYI.js";
-import "./chunk-IWSMQXBL.js";
+import "./chunk-WZGEYHCC.js";
 import "./chunk-GPZX4DSY.js";
 import "./chunk-MSL7ROVK.js";
 import "./chunk-4XMYOXGZ.js";

package/dist/lib.js

@@ -13,7 +13,7 @@ import {
   registerPhase,
   registerPipeline,
   resolvePipelineMode
-} from "./chunk-IWSMQXBL.js";
+} from "./chunk-WZGEYHCC.js";
 import {
   AsyncMutex,
   GitOperations,

package/dist/lifecycle/DefaultLifecycleHook.d.ts

@@ -0,0 +1,21 @@
+import type { StreamEvent } from '../ai-runner/AIRunner.js';
+import type { PhaseOutcome } from '../phases/PhaseOutcome.js';
+import type { PhaseLifecycleHook, PhaseExecutionContext } from './PhaseLifecycleHook.js';
+import type { PhaseFeedback, FeedbackResponse, PhaseError, ErrorDecision } from './FeedbackTypes.js';
+export declare class DefaultLifecycleHook implements PhaseLifecycleHook {
+    beforePhase(ctx: PhaseExecutionContext): Promise<void>;
+    onStream(ctx: PhaseExecutionContext, event: StreamEvent): void;
+    beforeExecute?: undefined;
+    afterExecute?: undefined;
+    onFeedback(ctx: PhaseExecutionContext, feedback: PhaseFeedback): Promise<FeedbackResponse>;
+    afterPhase(ctx: PhaseExecutionContext, outcome: PhaseOutcome): Promise<void>;
+    onError(ctx: PhaseExecutionContext, error: PhaseError): Promise<ErrorDecision>;
+}
+/**
+ * 从 PhaseLifecycleHook 创建 PhaseCallbacks（供 BasePhase.run() 使用）。
+ *
+ * 将标准化的 hook 接口适配为 BasePhase 期望的旧式回调，
+ * 实现了 PhaseFeedback/FeedbackResponse ↔ InputRequest/string 的双向转换。
+ */
+export declare function createCallbacksFromHook(hook: PhaseLifecycleHook, ctx: PhaseExecutionContext): import('../phases/PhaseOutcome.js').PhaseCallbacks;
+//# sourceMappingURL=DefaultLifecycleHook.d.ts.map

package/dist/lifecycle/DefaultLifecycleHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultLifecycleHook.d.ts","sourceRoot":"","sources":["../../src/lifecycle/DefaultLifecycleHook.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAgBrG,qBAAa,oBAAqB,YAAW,kBAAkB;IACvD,WAAW,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D,QAAQ,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAS9D,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,YAAY,CAAC,EAAE,SAAS,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwB1F,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5E,OAAO,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CAmBrF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,qBAAqB,GACzB,OAAO,2BAA2B,EAAE,cAAc,CAapD"}

package/dist/lifecycle/FeedbackTypes.d.ts

@@ -0,0 +1,52 @@
+import type { DialogOption, InputRequest } from '../ai-runner/AIRunner.js';
+export type PhaseFeedback = InteractiveDialogFeedback | ApprovalRequiredFeedback | PermissionRequestFeedback | GenericFeedback;
+export interface InteractiveDialogFeedback {
+    kind: 'interactive-dialog';
+    question: string;
+    options: DialogOption[];
+}
+export interface ApprovalRequiredFeedback {
+    kind: 'approval-required';
+    scope: 'plan' | 'release' | 'uat';
+}
+export interface PermissionRequestFeedback {
+    kind: 'permission-request';
+    tool: string;
+    detail: unknown;
+}
+export interface GenericFeedback {
+    kind: 'generic';
+    content: string;
+}
+export type FeedbackResponse = {
+    action: 'approve';
+} | {
+    action: 'reject';
+    reason?: string;
+} | {
+    action: 'select';
+    value: string;
+} | {
+    action: 'dismiss';
+} | {
+    action: 'pause';
+};
+export type ErrorDecision = {
+    action: 'fail';
+    softFail: boolean;
+} | {
+    action: 'retry';
+} | {
+    action: 'skip';
+};
+export interface PhaseError {
+    message: string;
+    isRetryable: boolean;
+    rawOutput: string;
+    wasActiveAtTimeout: boolean;
+}
+export declare function inputRequestToFeedback(request: InputRequest): PhaseFeedback;
+export declare function feedbackToInputRequest(feedback: PhaseFeedback): InputRequest;
+export declare function feedbackResponseToString(response: FeedbackResponse): string;
+export declare function stringToFeedbackResponse(str: string, originalFeedback: PhaseFeedback): FeedbackResponse;
+//# sourceMappingURL=FeedbackTypes.d.ts.map

package/dist/lifecycle/FeedbackTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackTypes.d.ts","sourceRoot":"","sources":["../../src/lifecycle/FeedbackTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI3E,MAAM,MAAM,aAAa,GACrB,yBAAyB,GACzB,wBAAwB,GACxB,yBAAyB,GACzB,eAAe,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAIxB,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAa3E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAW5E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAQ3E;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,GAAG,gBAAgB,CASvG"}

package/dist/lifecycle/PhaseLifecycleHook.d.ts

@@ -0,0 +1,70 @@
+import type { PhaseSpec } from '../pipeline/PipelineDefinition.js';
+import type { GitOperations } from '../git/GitOperations.js';
+import type { PlanPersistence } from '../persistence/PlanPersistence.js';
+import type { StreamEvent } from '../ai-runner/AIRunner.js';
+import type { BasePhase } from '../phases/BasePhase.js';
+import type { PhaseOutcome } from '../phases/PhaseOutcome.js';
+import type { IssueProcessingContext, OrchestratorDeps } from '../orchestrator/IssueProcessingContext.js';
+import type { PhaseFeedback, FeedbackResponse, PhaseError, ErrorDecision } from './FeedbackTypes.js';
+/**
+ * 阶段执行上下文 — 在 hook 方法之间共享的完整上下文。
+ *
+ * 由编排器在执行阶段前构造，包含当前阶段所需的所有依赖和状态。
+ */
+export interface PhaseExecutionContext {
+    /** 当前阶段规格 */
+    spec: PhaseSpec;
+    /** Issue 处理上下文（贯穿整个 pipeline） */
+    issueCtx: IssueProcessingContext;
+    /** 编排器依赖包 */
+    deps: OrchestratorDeps;
+    /** Worktree Git 操作 */
+    wtGit: GitOperations;
+    /** 计划文件持久化 */
+    wtPlan: PlanPersistence;
+    /** 多仓库 Git 操作映射（repo name → GitOperations） */
+    wtGitMap?: Map<string, GitOperations>;
+    /** 阶段实例（由策略或调用方创建后注入） */
+    phase?: BasePhase;
+    /** 便捷字段：issue.iid */
+    displayId: number;
+}
+/**
+ * 阶段生命周期 Hook — 标准化每个阶段的处理流程。
+ *
+ * 每个阶段的执行遵循统一生命周期：
+ *
+ * ```
+ * beforePhase → [beforeExecute] → Execute → [onStream/onFeedback]* → [afterExecute] → afterPhase
+ *                                                                        ↘ onError
+ * ```
+ *
+ * 实现此接口即可注入自定义的前置/后置/反馈处理逻辑，
+ * 而无需修改阶段或编排器的核心代码。
+ */
+export interface PhaseLifecycleHook {
+    /** 阶段开始前 — 更新状态、注入 hooks、准备上下文 */
+    beforePhase(ctx: PhaseExecutionContext): Promise<void>;
+    /** AI 开始执行前 — 最后一次修改 prompt/options 的机会 */
+    beforeExecute?(ctx: PhaseExecutionContext): Promise<void>;
+    /** 收到中间反馈（agent 提问、权限请求等） — 返回决策 */
+    onFeedback?(ctx: PhaseExecutionContext, feedback: PhaseFeedback): Promise<FeedbackResponse>;
+    /** 收到流式输出 — 转发到 SSE/日志等 */
+    onStream?(ctx: PhaseExecutionContext, event: StreamEvent): void;
+    /** AI 执行完成后，结果待校验前 — 可注入自定义验证逻辑 */
+    afterExecute?(ctx: PhaseExecutionContext, outcome: PhaseOutcome): Promise<PhaseOutcome>;
+    /** 阶段成功完成 — 提交产物、发评论、推送事件 */
+    afterPhase(ctx: PhaseExecutionContext, outcome: PhaseOutcome): Promise<void>;
+    /** 阶段失败 — 标记状态、决定重试策略 */
+    onError(ctx: PhaseExecutionContext, error: PhaseError): Promise<ErrorDecision>;
+}
+/**
+ * 策略执行结果 — 策略返回此类型以指示流水线是否应暂停。
+ */
+export interface PhaseStepResult {
+    /** 流水线应暂停（gate 等待、异步阶段等） */
+    paused: boolean;
+    /** 预览服务器是否在此阶段启动 */
+    serversStarted?: boolean;
+}
+//# sourceMappingURL=PhaseLifecycleHook.d.ts.map

package/dist/lifecycle/PhaseLifecycleHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaseLifecycleHook.d.ts","sourceRoot":"","sources":["../../src/lifecycle/PhaseLifecycleHook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErG;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,aAAa;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,sBAAsB;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,yBAAyB;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,WAAW,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,2CAA2C;IAC3C,aAAa,CAAC,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,oCAAoC;IACpC,UAAU,CAAC,CAAC,GAAG,EAAE,qBAAqB,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5F,2BAA2B;IAC3B,QAAQ,CAAC,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAEhE,mCAAmC;IACnC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAExF,6BAA6B;IAC7B,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7E,yBAAyB;IACzB,OAAO,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/lifecycle/PhaseMiddleware.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 阶段 Middleware 链 — 类似 Koa/Express middleware 的洋葱模型。
+ *
+ * 每个 middleware 可以在执行前后注入逻辑（日志、metrics、审计等），
+ * 核心 AI 执行始终在最内层。middleware 可自由组合和排序。
+ *
+ * ```
+ * statusTracking → hookInjection → metrics → [core execution] → metrics → hookInjection → statusTracking
+ * ```
+ */
+import type { PhaseOutcome } from '../phases/PhaseOutcome.js';
+import type { PhaseExecutionContext } from './PhaseLifecycleHook.js';
+/**
+ * 阶段 middleware 函数签名。
+ *
+ * @param ctx - 阶段执行上下文
+ * @param next - 调用下一个 middleware（最终到达核心执行逻辑）
+ * @returns 阶段执行结果
+ */
+export type PhaseMiddleware = (ctx: PhaseExecutionContext, next: () => Promise<PhaseOutcome>) => Promise<PhaseOutcome>;
+/**
+ * 组合多个 middleware 为单一可执行函数（从外到内依次包裹）。
+ *
+ * 执行顺序：middleware[0] 最先进入、最后退出（洋葱模型）。
+ *
+ * ```typescript
+ * const pipeline = composeMiddleware([loggingMw, metricsMw, coreMw]);
+ * const result = await pipeline(ctx, () => phase.run(ctx));
+ * ```
+ */
+export declare function composeMiddleware(middlewares: PhaseMiddleware[]): PhaseMiddleware;
+/**
+ * 日志 middleware — 记录阶段开始/完成/失败和耗时。
+ */
+export declare function loggingMiddleware(logFn: (message: string, meta?: Record<string, unknown>) => void): PhaseMiddleware;
+/**
+ * Metrics middleware — 记录阶段执行次数和耗时直方图。
+ */
+export declare function metricsMiddleware(collector: {
+    incrementCounter(name: string, labels?: Record<string, string>): void;
+    observeHistogram(name: string, value: number, labels?: Record<string, string>): void;
+}): PhaseMiddleware;
+/**
+ * 超时 middleware — 为阶段执行增加额外的超时保护。
+ */
+export declare function timeoutMiddleware(timeoutMs: number): PhaseMiddleware;
+//# sourceMappingURL=PhaseMiddleware.d.ts.map

package/dist/lifecycle/PhaseMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaseMiddleware.d.ts","sourceRoot":"","sources":["../../src/lifecycle/PhaseMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,qBAAqB,EAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,KAC9B,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,eAAe,CAqBjF;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAC/D,eAAe,CAwBjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE;IACT,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACtE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACtF,GACA,eAAe,CAoBjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAmBpE"}

package/dist/lifecycle/PhaseStateMachine.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 轻量级阶段状态机 — 显式定义阶段内的状态流转和 guard 条件。
+ *
+ * 不依赖外部库（如 XState），而是通过简单的状态表 + transition 函数
+ * 实现可预测、可序列化、可测试的状态管理。
+ *
+ * 状态机管理的是**单个阶段内**的状态流转，而非全局 Issue 状态
+ * （全局状态由 ActionLifecycleManager + IssueTracker 管理）。
+ */
+export type PhaseInternalState = 'idle' | 'hooks_injected' | 'context_ready' | 'executing' | 'awaiting_feedback' | 'feedback_received' | 'validating' | 'completed' | 'failed' | 'skipped' | 'paused';
+export type PhaseEvent = {
+    type: 'INJECT_HOOKS';
+} | {
+    type: 'CONTEXT_READY';
+} | {
+    type: 'START_EXECUTE';
+} | {
+    type: 'FEEDBACK_REQUIRED';
+    question: string;
+} | {
+    type: 'FEEDBACK_RECEIVED';
+    response: string;
+} | {
+    type: 'EXECUTE_DONE';
+    success: boolean;
+} | {
+    type: 'VALIDATION_PASSED';
+} | {
+    type: 'VALIDATION_FAILED';
+    reason: string;
+} | {
+    type: 'COMPLETE';
+} | {
+    type: 'FAIL';
+    reason: string;
+} | {
+    type: 'SKIP';
+} | {
+    type: 'PAUSE';
+} | {
+    type: 'RESUME';
+};
+export interface TransitionGuard {
+    (ctx: StateMachineContext, event: PhaseEvent): boolean;
+}
+export interface StateMachineContext {
+    phaseName: string;
+    issueIid: number;
+    retryCount: number;
+    maxRetries: number;
+    lastError?: string;
+    feedbackHistory: Array<{
+        question: string;
+        response: string;
+        timestamp: string;
+    }>;
+    startedAt?: string;
+    completedAt?: string;
+}
+export interface TransitionDef {
+    from: PhaseInternalState;
+    event: PhaseEvent['type'];
+    to: PhaseInternalState;
+    guard?: TransitionGuard;
+    action?: (ctx: StateMachineContext, event: PhaseEvent) => void;
+}
+export interface PhaseStateMachineSnapshot {
+    state: PhaseInternalState;
+    context: StateMachineContext;
+}
+export declare class PhaseStateMachine {
+    private _state;
+    private _context;
+    private readonly transitions;
+    private readonly listeners;
+    constructor(phaseName: string, issueIid: number, opts?: {
+        maxRetries?: number;
+        initialState?: PhaseInternalState;
+        transitions?: TransitionDef[];
+    });
+    get state(): PhaseInternalState;
+    get context(): Readonly<StateMachineContext>;
+    /** 发送事件触发状态转换。返回新状态，如果无匹配 transition 则抛异常。 */
+    send(event: PhaseEvent): PhaseInternalState;
+    /** 尝试发送事件，如果无匹配 transition 则返回 false 而非抛异常。 */
+    trySend(event: PhaseEvent): boolean;
+    /** 检查当前状态下是否可以处理某事件。 */
+    canSend(eventType: PhaseEvent['type']): boolean;
+    /** 获取当前状态下所有可用的事件类型。 */
+    availableEvents(): PhaseEvent['type'][];
+    /** 是否处于终态。 */
+    get isTerminal(): boolean;
+    /** 是否处于失败态（可能可重试）。 */
+    get isFailed(): boolean;
+    /** 是否可重试。 */
+    get canRetry(): boolean;
+    /** 订阅状态变化。返回取消订阅函数。 */
+    subscribe(listener: (snapshot: PhaseStateMachineSnapshot) => void): () => void;
+    /** 快照（可序列化 / 可用于断点恢复）。 */
+    snapshot(): PhaseStateMachineSnapshot;
+    /** 从快照恢复。 */
+    static fromSnapshot(snap: PhaseStateMachineSnapshot, transitions?: TransitionDef[]): PhaseStateMachine;
+    private notify;
+}
+export declare class InvalidTransitionError extends Error {
+    readonly currentState: PhaseInternalState;
+    readonly eventType: string;
+    readonly phaseName: string;
+    constructor(currentState: PhaseInternalState, eventType: string, phaseName: string);
+}
+//# sourceMappingURL=PhaseStateMachine.d.ts.map

package/dist/lifecycle/PhaseStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaseStateMachine.d.ts","sourceRoot":"","sources":["../../src/lifecycle/PhaseStateMachine.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle/index.d.ts

@@ -1,3 +1,11 @@
 export type { ActionStatus, Action, ActionState, StateCategory } from './ActionLifecycle.js';
 export { ActionLifecycleManager } from './ActionLifecycleManager.js';
+export type { PhaseFeedback, InteractiveDialogFeedback, ApprovalRequiredFeedback, PermissionRequestFeedback, GenericFeedback, FeedbackResponse, ErrorDecision, PhaseError, } from './FeedbackTypes.js';
+export { inputRequestToFeedback, feedbackToInputRequest, feedbackResponseToString, stringToFeedbackResponse, } from './FeedbackTypes.js';
+export type { PhaseExecutionContext, PhaseLifecycleHook, PhaseStepResult, } from './PhaseLifecycleHook.js';
+export { DefaultLifecycleHook, createCallbacksFromHook } from './DefaultLifecycleHook.js';
+export type { PhaseMiddleware } from './PhaseMiddleware.js';
+export { composeMiddleware, loggingMiddleware, metricsMiddleware, timeoutMiddleware, } from './PhaseMiddleware.js';
+export type { PhaseInternalState, PhaseEvent, TransitionGuard, StateMachineContext, TransitionDef, PhaseStateMachineSnapshot, } from './PhaseStateMachine.js';
+export { PhaseStateMachine, InvalidTransitionError } from './PhaseStateMachine.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,YAAY,EACV,aAAa,EACb,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAE1F,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/orchestrator/steps/PhaseHelpers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 从 PhaseLoopStep 提取的编排级辅助函数。
+ *
+ * 供 PhaseLoopStep、DefaultLifecycleHook、各 PhaseStrategy 共用，
+ * 避免循环依赖。
+ */
+import type { GitOperations } from '../../git/GitOperations.js';
+import type { PlanPersistence } from '../../persistence/PlanPersistence.js';
+import type { AIRunner, InputRequest } from '../../ai-runner/index.js';
+import type { BasePhase, PhaseContext } from '../../phases/BasePhase.js';
+import type { PhaseSpec, PipelineDef } from '../../pipeline/PipelineDefinition.js';
+import type { IssueProcessingContext, OrchestratorDeps } from '../IssueProcessingContext.js';
+export declare function safeComment(deps: OrchestratorDeps, issueId: number, message: string): Promise<void>;
+export declare function resolveVerifyRunner(deps: OrchestratorDeps): AIRunner;
+export declare function resolveUatRunner(deps: OrchestratorDeps, issueIid: number): AIRunner;
+export declare function commitPlanFiles(ctx: PhaseContext, wtGit: GitOperations, wtGitMap: Map<string, GitOperations> | undefined, phaseName: string, displayId: number): Promise<void>;
+export declare function syncResultToIssue(phase: BasePhase, ctx: PhaseContext, displayId: number, phaseName: string, deps: OrchestratorDeps, issueId: number, wtPlan: PlanPersistence): Promise<void>;
+export declare function handlePlanApproval(displayId: number, phaseName: string, deps: OrchestratorDeps): Promise<string>;
+export declare function handleInteractiveDialog(displayId: number, phaseName: string, deps: OrchestratorDeps, request: InputRequest): Promise<string>;
+export declare function updateHooksForPhase(spec: PhaseSpec, pipelineDef: PipelineDef, ctx: IssueProcessingContext, wtPlan: PlanPersistence): void;
+export declare function findPreviousAiPhaseIndex(phases: readonly {
+    kind: string;
+}[], currentIdx: number): number;
+//# sourceMappingURL=PhaseHelpers.d.ts.map

package/dist/orchestrator/steps/PhaseHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaseHelpers.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/steps/PhaseHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAc7F,wBAAsB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzG;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,QAAQ,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAKnF;AAID,wBAAsB,eAAe,CACnC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,EAChD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAID,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAID,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAoDjB;AAID,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,sBAAsB,EAC3B,MAAM,EAAE,eAAe,GACtB,IAAI,CAyBN;AAID,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EACnC,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/dist/orchestrator/steps/PhaseLoopStep.d.ts

@@ -1,6 +1,16 @@
 import type { GitOperations } from '../../git/GitOperations.js';
 import type { PlanPersistence } from '../../persistence/PlanPersistence.js';
+import type { BasePhase } from '../../phases/BasePhase.js';
+import type { PhaseOutcome } from '../../phases/PhaseOutcome.js';
+import type { PhaseSpec } from '../../pipeline/PipelineDefinition.js';
 import type { IssueProcessingContext, OrchestratorDeps, PhaseLoopResult } from '../IssueProcessingContext.js';
+import type { PhaseLifecycleHook } from '../../lifecycle/PhaseLifecycleHook.js';
+/**
+ * 统一的阶段执行包装器 — 通过 PhaseLifecycleHook 驱动完整生命周期。
+ *
+ * beforePhase → Execute (phase.run with callbacks) → afterPhase / onError
+ */
+export declare function runPhaseWithLifecycle(phase: BasePhase, phaseCtx: import('../../phases/BasePhase.js').PhaseContext, spec: PhaseSpec, ctx: IssueProcessingContext, deps: OrchestratorDeps, wtGit: GitOperations, wtPlan: PlanPersistence, wtGitMap?: Map<string, GitOperations>, hook?: PhaseLifecycleHook): Promise<PhaseOutcome>;
 /**
  * 执行流水线阶段循环：
  * - 确定恢复阶段索引

package/dist/orchestrator/steps/PhaseLoopStep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhaseLoopStep.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/steps/PhaseLoopStep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAe5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAyU9G;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,OAAO,CAAC,eAAe,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAwNhD"}
+{"version":3,"file":"PhaseLoopStep.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/steps/PhaseLoopStep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC9G,OAAO,KAAK,EAAE,kBAAkB,EAAyB,MAAM,uCAAuC,CAAC;AASvG;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,OAAO,2BAA2B,EAAE,YAAY,EAC1D,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACrC,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,YAAY,CAAC,CA6DvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,OAAO,CAAC,eAAe,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CA6GhD"}

package/dist/orchestrator/steps/SetupStep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SetupStep.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/steps/SetupStep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAM1G;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,CAAC,CA6EtB"}
+{"version":3,"file":"SetupStep.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/steps/SetupStep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAO1G;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,CAAC,CAuGtB"}

package/dist/orchestrator/strategies/AiPhaseStrategy.d.ts

@@ -0,0 +1,17 @@
+import type { PhaseExecutionContext, PhaseLifecycleHook, PhaseStepResult } from '../../lifecycle/PhaseLifecycleHook.js';
+import type { PhaseStrategy } from './PhaseStrategy.js';
+/**
+ * 标准 AI 阶段策略 — 处理所有 kind='ai' 的阶段。
+ *
+ * 覆盖：plan、build、uat（非 verify-fix 循环的 verify 也走这里）。
+ * 处理异步阶段（awaitCompletion）、gate 请求（hasReleaseCapability）。
+ */
+export declare class AiPhaseStrategy implements PhaseStrategy {
+    readonly name = "ai";
+    shouldSkip(ctx: PhaseExecutionContext): boolean;
+    execute(ctx: PhaseExecutionContext, hooks: PhaseLifecycleHook): Promise<PhaseStepResult>;
+    private resolveRunner;
+    private handleAsyncOutcome;
+    private handleGateRequest;
+}
+//# sourceMappingURL=AiPhaseStrategy.d.ts.map

package/dist/orchestrator/strategies/AiPhaseStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiPhaseStrategy.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/strategies/AiPhaseStrategy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAexD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,QAAQ;IAErB,UAAU,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO;IASzC,OAAO,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IA4C9F,OAAO,CAAC,aAAa;YAOP,kBAAkB;IAiEhC,OAAO,CAAC,iBAAiB;CAY1B"}