@sudocode-ai/local-server 0.1.10 → 0.1.11

package/dist/workflow/base-workflow-engine.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Base Workflow Engine
+ *
+ * Abstract base class with shared logic for workflow engine implementations.
+ * Both SequentialWorkflowEngine and OrchestratorWorkflowEngine extend this class.
+ */
+import type Database from "better-sqlite3";
+import type { Workflow, WorkflowSource, WorkflowConfig, WorkflowStep, WorkflowStatus, DependencyGraph } from "@sudocode-ai/types";
+import type { IWorkflowEngine } from "./workflow-engine.js";
+import { WorkflowEventEmitter, type WorkflowEventListener } from "./workflow-event-emitter.js";
+import type { ExecutionLifecycleService } from "../services/execution-lifecycle.js";
+/**
+ * Abstract base class for workflow engine implementations.
+ *
+ * Provides shared functionality for:
+ * - Database CRUD operations
+ * - Source resolution (spec, issues, root_issue, goal)
+ * - Step creation from dependency graph
+ * - Ready step detection
+ * - Event subscription
+ *
+ * Subclasses must implement:
+ * - createWorkflow()
+ * - startWorkflow()
+ * - pauseWorkflow()
+ * - resumeWorkflow()
+ * - cancelWorkflow()
+ * - retryStep()
+ * - skipStep()
+ */
+export declare abstract class BaseWorkflowEngine implements IWorkflowEngine {
+    protected db: Database.Database;
+    protected eventEmitter: WorkflowEventEmitter;
+    constructor(db: Database.Database, eventEmitter?: WorkflowEventEmitter);
+    abstract createWorkflow(source: WorkflowSource, config?: Partial<WorkflowConfig>): Promise<Workflow>;
+    /**
+     * Generate a title from the workflow source.
+     */
+    protected generateTitle(source: WorkflowSource): string;
+    abstract startWorkflow(workflowId: string): Promise<void>;
+    abstract pauseWorkflow(workflowId: string): Promise<void>;
+    abstract resumeWorkflow(workflowId: string, message?: string): Promise<void>;
+    abstract cancelWorkflow(workflowId: string): Promise<void>;
+    abstract retryStep(workflowId: string, stepId: string): Promise<void>;
+    abstract skipStep(workflowId: string, stepId: string, reason?: string): Promise<void>;
+    /**
+     * Get a workflow by ID.
+     */
+    getWorkflow(workflowId: string): Promise<Workflow | null>;
+    /**
+     * Get a workflow by ID, throwing if not found.
+     */
+    protected getWorkflowOrThrow(workflowId: string): Promise<Workflow>;
+    /**
+     * Get steps that are ready to execute.
+     * A step is ready if:
+     * - Its status is "pending" or "ready"
+     * - All its dependencies are "completed"
+     */
+    getReadySteps(workflowId: string): Promise<WorkflowStep[]>;
+    /**
+     * List all workflows with optional filtering.
+     */
+    listWorkflows(options?: {
+        status?: WorkflowStatus;
+        limit?: number;
+        offset?: number;
+    }): Promise<Workflow[]>;
+    /**
+     * Subscribe to workflow events.
+     */
+    onWorkflowEvent(listener: WorkflowEventListener): () => void;
+    /**
+     * Emit an escalation requested event.
+     */
+    emitEscalationRequested(workflowId: string, escalationId: string, message: string, options?: string[], context?: Record<string, unknown>): void;
+    /**
+     * Emit an escalation resolved event.
+     */
+    emitEscalationResolved(workflowId: string, escalationId: string, action: "approve" | "reject" | "custom", message?: string): void;
+    /**
+     * Emit a step started event.
+     */
+    emitStepStarted(workflowId: string, step: WorkflowStep): void;
+    /**
+     * Emit a step completed event.
+     */
+    emitStepCompleted(workflowId: string, step: WorkflowStep, executionId: string): void;
+    /**
+     * Emit a step failed event.
+     */
+    emitStepFailed(workflowId: string, step: WorkflowStep, error: string): void;
+    /**
+     * Emit a workflow completed event.
+     */
+    emitWorkflowCompleted(workflowId: string, workflow: Workflow): void;
+    /**
+     * Emit a workflow failed event.
+     */
+    emitWorkflowFailed(workflowId: string, error: string): void;
+    /**
+     * Save a new workflow to the database.
+     */
+    protected saveWorkflow(workflow: Workflow): void;
+    /**
+     * Update a workflow in the database.
+     * Uses dynamic field builder for partial updates.
+     */
+    protected updateWorkflow(workflowId: string, updates: Partial<{
+        title: string;
+        status: WorkflowStatus;
+        steps: WorkflowStep[];
+        worktreePath: string | null;
+        branchName: string | null;
+        currentStepIndex: number;
+        orchestratorExecutionId: string | null;
+        orchestratorSessionId: string | null;
+        config: WorkflowConfig;
+        startedAt: string | null;
+        completedAt: string | null;
+    }>): Workflow;
+    /**
+     * Update a specific step within a workflow.
+     */
+    protected updateStep(workflowId: string, stepId: string, updates: Partial<WorkflowStep>): void;
+    /**
+     * Delete a workflow from the database.
+     */
+    protected deleteWorkflow(workflowId: string): void;
+    /**
+     * Resolve a WorkflowSource to a list of issue IDs.
+     *
+     * @param source - The workflow source definition
+     * @returns Array of issue IDs
+     */
+    protected resolveSource(source: WorkflowSource): Promise<string[]>;
+    /**
+     * Resolve a spec source to issue IDs.
+     * Finds all issues that implement the spec.
+     */
+    private resolveSpecSource;
+    /**
+     * Resolve a root issue source to issue IDs.
+     * Returns the root issue plus all issues that block it (recursively).
+     */
+    private resolveRootIssueSource;
+    /**
+     * Create workflow steps from a dependency graph.
+     *
+     * @param graph - The analyzed dependency graph
+     * @returns Array of WorkflowStep objects
+     */
+    protected createStepsFromGraph(graph: DependencyGraph): WorkflowStep[];
+    /**
+     * Create a workflow object (without saving to database).
+     * Used by subclasses to build the workflow before saving.
+     */
+    protected buildWorkflow(options: {
+        source: WorkflowSource;
+        steps: WorkflowStep[];
+        config: Partial<WorkflowConfig>;
+        repoPath?: string;
+    }): Workflow;
+    /**
+     * Analyze dependencies for a set of issues.
+     * Convenience wrapper around analyzeDependencies().
+     */
+    protected analyzeDependencies(issueIds: string[]): DependencyGraph;
+    /**
+     * Create a workflow-level worktree.
+     *
+     * Creates a worktree that will be shared across all executions in the workflow.
+     * This ensures the orchestrator and all step executions run in the same isolated
+     * environment and can see each other's changes.
+     *
+     * @param workflow - The workflow to create the worktree for
+     * @param repoPath - Path to the git repository
+     * @param lifecycleService - Execution lifecycle service for worktree creation
+     * @returns Object with worktreePath and branchName
+     */
+    protected createWorkflowWorktreeHelper(workflow: Workflow, repoPath: string, lifecycleService: ExecutionLifecycleService): Promise<{
+        worktreePath: string;
+        branchName: string;
+    }>;
+}
+//# sourceMappingURL=base-workflow-engine.d.ts.map

package/dist/workflow/base-workflow-engine.d.ts.map

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