feat(workflows): refactor workflow execution and state management

Introduce new state machine implementation for workflow execution with improved input handling and error management. Replace queue-based execution with a runner class that orchestrates steps using finite state machine patterns.

Add new input providers for user and controller input with event-based communication. Implement proper state transitions and error handling throughout the workflow lifecycle.

Remove deprecated queue implementation and consolidate execution logic into a single runner class. Add comprehensive type definitions for workflow states and transitions.

The changes improve maintainability and provide a more robust foundation for future workflow features like autonomous mode and chained prompts.

Author: moazbuilds

src/cli/commands/start.command.ts

@@ -28,11 +28,11 @@ export function registerStartCommand(program: Command): void {
       // Comprehensive terminal clearing
       clearTerminal();
 
-      const { runWorkflowQueue } = await import('../../workflows/index.js');
+      const { runWorkflow } = await import('../../workflows/index.js');
       const { ValidationError } = await import('../../runtime/services/validation.js');
 
       try {
-        await runWorkflowQueue({ cwd, specificationPath });
+        await runWorkflow({ cwd, specificationPath });
         console.log('\n✓ Workflow completed successfully');
         process.exit(0);
       } catch (error) {

src/cli/tui/app-shell.tsx

@@ -196,8 +196,8 @@ export function App(props: { initialToast?: InitialToast }) {
     const specPath = path.join(cwd, '.codemachine', 'inputs', 'specifications.md')
 
     pendingWorkflowStart = () => {
-      import("../../workflows/execution/queue.js").then(({ runWorkflowQueue }) => {
-        runWorkflowQueue({ cwd, specificationPath: specPath }).catch((error) => {
+      import("../../workflows/execution/run.js").then(({ runWorkflow }) => {
+        runWorkflow({ cwd, specificationPath: specPath }).catch((error) => {
           // Emit error event to show toast with actual error message
           const errorMsg = error instanceof Error ? error.message : String(error)
           ;(process as NodeJS.EventEmitter).emit('app:error', { message: errorMsg })

src/cli/tui/routes/home/hooks/use-home-commands.tsx

@@ -63,7 +63,7 @@ export function useHomeCommands(options: UseHomeCommandsOptions) {
     const specPath = getAbsoluteSpecPath()
 
     try {
-      const { validateSpecification } = await import("../../../../../workflows/execution/queue.js")
+      const { validateSpecification } = await import("../../../../../workflows/execution/run.js")
       await validateSpecification(specPath)
     } catch (error) {
       if (error instanceof Error) {

src/workflows/execution/auth.ts src/workflows/execution/engine.tssrc/workflows/execution/auth.ts renamed to src/workflows/execution/engine.ts

@@ -1,4 +1,4 @@
 export * from './run.js';
-export * from './queue.js';
+export * from './runner.js';
 export * from './step.js';
 export * from '../behaviors/index.js';