Workflow Engine (v0.4 foundation)

Workflow Engine (v0.4 foundation)#

Purpose#

Resumable multi-step automation per docs 02-system-architecture-prompt.md §7.

Current Scope#

• Domain contracts: WorkflowStepInterface, WorkflowRunnerInterface, WorkflowRunStoreInterface
• Application: WorkflowRunner, WorkflowRegistry, StartWorkflow, GetWorkflowRun
• Infrastructure: WorkflowRunRepository, AsyncQueueDriver (Action Scheduler → WP-Cron fallback)
• Built-in workflow: publish_product (8 steps)
• REST: POST /workflows, GET /workflows/{run_id}, POST /workflows/{run_id}/resume

Feature Flag#

• Setting: enable_workflows (default false)

Publish Product Steps#

1. validate_product
2. generate_description
3. generate_seo
4. apply_content
5. ensure_featured_image — skips if image present; else saves brief + hooks teddy_workflow_generate_product_image / teddy_workflow_need_product_image (require_image input optional). Default handler tries WP AI Client image generation, then GD placeholder PNG.
6. generate_translation_draft — only when input target_language is set; stores _teddy_i18n_draft_{lang}
7. publish_product
8. notify_complete — optional notify_email via wp_mail

State is persisted after each step in wp_teddy_workflow_runs.

Verification#

• tests/Unit/ChatMemoryComposerTest.php (WorkflowRunnerTest)