Skip to main content

Changelog — v0.1 (Initial Release)

Release Date: April 2026

This is the first public release of Stateway, a distributed BPMN 2.0 process engine delivered as BaaS.

Features​

BPMN Engine​

  • Full BPMN 2.0 process execution engine
  • Element types: startEvent, endEvent, task, userTask, serviceTask, sendTask, businessRuleTask, exclusiveGateway, parallelGateway, timerEvent
  • Event-driven execution loop with persistent state
  • Secure expression evaluator with {{expression}} syntax
  • Support for BPMN XML, JSON, and YAML process definitions

Decision Engine (DMM)​

  • Decision model evaluation with 7 hit policies: FIRST, ALL, UNIQUE, RULE_ORDER, COLLECT, OUTPUT_ORDER, PRIORITY
  • FEEL expression support: comparison, ranges, lists, negation, wildcards
  • Standalone evaluation via REST API
  • Embedded evaluation via businessRuleTask in processes
  • DMN-XML parser for standard OMG DMN files

REST API​

  • Auth: Register tenant, manage API keys (create, list, revoke)
  • Tenants: Get and update tenant settings
  • Definitions: Full CRUD with versioning and BPMN XML export
  • Instances: Start, query, suspend, resume, terminate instances
  • Tasks: List, claim, unclaim, delegate, complete human tasks
  • Events: Send events/signals to instances, broadcast signals
  • Timers: List and cancel timer jobs
  • Webhooks: Full CRUD for subscriptions, test deliveries, delivery history
  • Decisions: Full CRUD with versioning and direct evaluation
  • Health: Liveness and readiness probes

Authentication & Multitenancy​

  • API key authentication via X-API-Key header
  • Automatic tenant resolution from API key
  • Column-based multitenancy with strict isolation
  • Key hashing with configurable salt

Infrastructure​

  • Docker + Docker Compose deployment
  • Kubernetes manifests (DigitalOcean + Oracle Cloud)
  • Terraform-managed DNS (DigitalOcean)
  • Nginx reverse proxy with SSL termination
  • Rate limiting per API key and per IP
  • Structured logging with Pino

MCP Server (AI Integration)​

  • 13 MCP tools for AI agent integration
  • Server-Sent Events (SSE) transport
  • Docker container with nginx proxy
  • Kubernetes deployment

Documentation​

  • Docusaurus 3 static site with local search
  • OpenAPI auto-generation from Fastify swagger
  • Comprehensive guides for all features
  • AI Agents integration guide with tool call schemas

Testing​

  • Unit tests for engine core (expressions, eventBus, executor, parser)
  • Unit tests for all element handlers
  • Unit tests for decision parser and evaluator (35 tests)
  • Integration tests for all API endpoints
  • Cross-tenant isolation tests
  • Landing page Playwright E2E tests
  • API smoke test script

Known Limitations at Release​

  • No Redis cache (resolved in v0.2)
  • No horizontal scaling of the engine (resolved in v0.2)
  • No credential management (resolved in v0.2)
  • No monitoring API (resolved in v0.2)
  • No web UI for process management
  • No SDK clients
  • No i18n support
  • Single-process architecture (monolith)

Migration Notes​

This is the initial release — no migration is needed.