koh / ai-workflows

v0.8.1 2026-10-13 17:23 UTC

Requires

• php: ^8.5.11
• symfony/yaml: ^7.4.20
• typo3/cms-backend: ^14.0
• typo3/cms-core: ^14.0
• typo3/cms-extbase: ^14.0
• typo3/cms-fluid: ^14.0

Requires (Dev)

• koh/dev-typo3: ^1.0

Suggests

• koh/content-intelligence: Provides content quality checks for quality gate steps
• koh/semantic-delivery: Provides multi-channel content transformation

GPL-2.0-or-later

• Kai Ole Hartwig

Published on Packagist.org on 2026-10-14 02:49 UTC

README

Agentic workflow engine for TYPO3 that orchestrates AI-powered content operations through YAML-defined pipelines. Supports multi-step workflows with expression resolution, blocking/resume capability, and extensible step/notifier architecture.

Features

• YAML Workflow Definitions — Declarative pipeline configuration with steps, conditions, and expressions
• Blocking & Resume — Workflows can pause for human review and resume after approval
• Expression Resolution — Dynamic value resolution within workflow steps using an expression language
• Extensible Step Architecture — Register custom steps via StepInterface and DI auto-discovery
• Notifier System — Pluggable notifications for workflow state changes
• DDD 4-Layer Architecture — Domain, Application, Infrastructure, Presentation layers enforced by deptrac

Installation

composer require koh/ai-workflows

Architecture

Classes/
├── Domain/          # Value objects, enums, contracts (interfaces)
├── Application/     # Orchestration services
├── Infrastructure/  # Steps, adapters, persistence
└── Presentation/    # Controllers, event listeners

Layer dependencies are enforced via deptrac — Domain has zero external dependencies, Application depends only on Domain, Infrastructure and Presentation may use framework classes.

Extension Points

1. Define an interface in Domain/Contract/
2. Create an implementation in Infrastructure/
3. Auto-discovery via _instanceof tags in Services.yaml

Configuration

Workflows are defined as YAML files and registered through TYPO3's configuration system. Each workflow consists of ordered steps with optional conditions and expressions.

Development

composer install
composer test                    # Unit tests
composer phpstan                 # Static analysis (level 8)
composer deptrac                 # DDD layer enforcement
vendor/bin/php-cs-fixer fix      # Code style (PER-CS3x0)

Dependencies

Package	Type	Purpose
symfony/yaml	Required	YAML workflow parsing
koh/content-intelligence	Optional	Content quality analysis integration
koh/semantic-delivery	Optional	Multi-channel delivery integration
koh/dev	Dev	Shared QA tooling

License

GPL-2.0-or-later — see LICENSE for details.