vibeman 0.0.2 → 0.0.5

package/dist/runtime/api/workflows/vibing-orchestrator.d.ts

@@ -5,6 +5,9 @@ import { AgentService } from '../agent/agent-service.js';
 import { WorktreeService } from '../vcs/worktree-service.js';
 import { GitService } from '../vcs/git-service.js';
 import type { ResolvedProvider } from '../agent/routing-policy.js';
+import type { WorkflowEvent } from './workflow-schema.js';
+import { computeNextAction } from './workflow-reducer.js';
+import { type ReconcileAction } from './workflow-reconciler.js';
 export declare class VibingOrchestrator extends EventEmitter {
     private taskService;
     private agentService;
@@ -14,7 +17,13 @@ export declare class VibingOrchestrator extends EventEmitter {
     private workflows;
     private qualityPipeline;
     private workflowDB;
+    private taskUpdater;
     private initialized;
+    private activeImprovements;
+    private taskImprovementExecutions;
+    private reconciler;
+    private heartbeatTracker;
+    private idempotencyGuard;
     private computeVisibleTimeline;
     private buildTimeline;
     constructor(taskService: TaskService, agentService: AgentService, worktreeService: WorktreeService, config: VibingConfig, gitService?: GitService | undefined, persistenceDataDir?: string);
@@ -23,7 +32,53 @@ export declare class VibingOrchestrator extends EventEmitter {
      * Call this after construction to load persisted workflows
      */
     initialize(): Promise<void>;
+    /**
+     * Shutdown the orchestrator and cleanup resources
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get workflow snapshots for reconciler
+     */
+    private getWorkflowSnapshots;
+    /**
+     * Handle stuck workflow detected by reconciler
+     */
+    private handleStuckWorkflow;
+    /**
+     * Record heartbeat for active workflow execution
+     */
+    recordHeartbeat(workflowId: string): void;
+    /**
+     * Check if reconciler is running
+     */
+    isReconcilerRunning(): boolean;
+    /**
+     * Get reconcile history for debugging
+     */
+    getReconcileHistory(): ReconcileAction[];
     private normalizeWorkflow;
+    /**
+     * Convert VibingExecution to WorkflowState for the reducer
+     */
+    private toWorkflowState;
+    /**
+     * Apply WorkflowState changes back to VibingExecution (for backward compatibility)
+     */
+    private applyStateToExecution;
+    /**
+     * Create an EffectContext that binds orchestrator methods
+     */
+    private createEffectContext;
+    /**
+     * Dispatch an event to the workflow state machine (NEW API)
+     * This is the new way to trigger state transitions.
+     * Uses idempotency guard to prevent duplicate event processing.
+     */
+    dispatch(workflowId: string, event: WorkflowEvent): Promise<void>;
+    /**
+     * Get the next recommended action for a workflow (uses new state machine)
+     */
+    getNextAction(workflowId: string): ReturnType<typeof computeNextAction> | null;
     /**
      * Execute a task once (no phase management). Optionally associates with a workflow.
      */
@@ -52,6 +107,16 @@ export declare class VibingOrchestrator extends EventEmitter {
         };
     };
     listAllExecutions(): Promise<any[]>;
+    startTaskImprovement(taskId: string, data: {
+        title: string;
+        type: string;
+        priority: string;
+        content: string;
+    }, options?: {
+        executionId?: string;
+    }): Promise<{
+        readonly executionId: string;
+    }>;
     improveTaskContent(taskId: string, data: {
         title: string;
         type: string;
@@ -68,6 +133,7 @@ export declare class VibingOrchestrator extends EventEmitter {
         executionId: string;
         selectedModel?: string;
     }>;
+    private runTaskImprovementPipeline;
     aiReviewCode(taskId: string, reviewContext?: string, options?: {
         workflowId?: string;
         overrides?: Partial<ResolvedProvider>;
@@ -147,6 +213,10 @@ export declare class VibingOrchestrator extends EventEmitter {
      * Reject workflow and request changes
      */
     rejectWorkflow(workflowId: string, feedback: string): Promise<void>;
+    /**
+     * Helper to close a timeline item by phase
+     */
+    private closeTimelineItem;
     /**
      * Get workflow status
      */
@@ -161,9 +231,18 @@ export declare class VibingOrchestrator extends EventEmitter {
      */
     getLatestWorkflowByTask(taskId: string): VibingExecution | null;
     /**
-     * Transition workflow to new phase
+     * Update UI phase with proper tracking of lastPhase, phaseHistory, and metrics.
+     * This is for UI-only phases that don't correspond to FSM states.
+     */
+    private updateUIPhase;
+    /**
+     * Update task file when workflow becomes ready for review
      */
-    private transitionToPhase;
+    private updateTaskForReviewReadiness;
+    /**
+     * Extract context information for task updates
+     */
+    private extractTaskUpdateContext;
     /**
      * Save workflow to persistence layer
      */
@@ -174,7 +253,7 @@ export declare class VibingOrchestrator extends EventEmitter {
     private executeImplementation;
     /**
      * Public: re-run implementation phase on demand
-     * Forces phase to 'implementing' and executes implementation again.
+     * Uses dispatch(RETRY) to transition FSM and trigger implementation via effect.
      */
     rerunImplementation(workflowId: string, feedback?: string, providerOverride?: {
         provider?: string;
@@ -204,11 +283,14 @@ export declare class VibingOrchestrator extends EventEmitter {
     private performAICodeReview;
     /**
      * Execute AI review as a dedicated phase
+     * Note: 'ai-reviewing' is a UI-only phase for timeline display, not an FSM phase.
+     * FSM remains in 'approved' during AI review.
      */
     private executeAiReviewPhase;
     private executeAwaitingReview;
     /**
      * Execute validation phase with quality checks
+     * Note: FSM has already transitioned to 'validating' via IMPL_SUCCESS event
      */
     private executeValidation;
     /**
@@ -217,9 +299,13 @@ export declare class VibingOrchestrator extends EventEmitter {
     runValidation(workflowId: string): Promise<void>;
     /**
      * Execute merge phase
+     * Note: FSM has already transitioned to 'merging' via APPROVE event
      */
     private executeMerge;
-    private updateCleanupStatus;
+    /**
+     * Verify that a merge actually succeeded by checking git state
+     */
+    private verifyMergeSuccess;
     /**
      * Public: run merge phase on demand
      * This will attempt merge regardless of current phase.
@@ -230,6 +316,7 @@ export declare class VibingOrchestrator extends EventEmitter {
     }): Promise<void>;
     /**
      * Execute cleanup phase: remove worktree/branch and finalize workflow
+     * Note: FSM has already transitioned to 'done' via MERGE_SUCCESS event
      */
     private executeCleanup;
     /**
@@ -302,15 +389,16 @@ export declare class VibingOrchestrator extends EventEmitter {
     updateWorkflowOptions(workflowId: string, config: Partial<VibingConfig>): Promise<void>;
     /**
      * Continue workflow execution from current state
+     * Uses the new state machine to determine the next action
      */
     continueWorkflow(workflowId: string): Promise<void>;
-    private computeNextActionPhase;
     private requireWorkflow;
     private getAIReviewThreshold;
     private assertPhase;
     private createNewWorkflow;
     private maybeRetryImplementation;
     private handlePhaseFailure;
+    private getFailEventForPhase;
     /**
      * Get the agent service instance
      */