elsa-workflows/elsa-core
56.1
Adequate · 9 October 2026
259k
lines of production code
C#
with Python
5
measurements over time
What this system is
This system is Elsa, a workflow engine and automation platform that provides a modular server architecture with plugin discovery and external authentication capabilities. It includes a Studio interface for management and supports a wide range of database backends through comprehensive Docker infrastructure. The codebase is structured into core, extensions, and studio components, managed by a standardized .NET 10 build system with extensive tooling for release automation, testing, and developer workflows.
How it got here
2018–2023 — Repository consolidation and infrastructure modernization
6 changes.
The project underwent a major structural reorganization, consolidating the codebase into core, extensions, and studio directories while standardizing developer workflows with a NUKE-based build system. Concurrently, the infrastructure was modernized to support .NET 10.0, OpenTelemetry, and multi-database environments through comprehensive Docker configurations. These technical improvements were accompanied by updates to brand assets and design specifications to reflect the current visual identity.
2024–2026 — Build modernization and release automation
18 changes.
The project overhauled its infrastructure by migrating to a NUKE-based build system, adopting Central Package Management, and targeting .NET 10. Significant effort was directed toward automating release workflows, including CI gating, Docker trust validation, and automated social media announcements via agent skills. Concurrently, the codebase expanded with new features such as modular plugin discovery, external authentication brokers, and multitenancy support for background tasks.
Features
Add Elsa README video assets
A new Remotion-based video project has been added to the \design/video/elsa-readme-video\ directory to generate assets for the repository's README. This includes the source code for an animated video showcasing Elsa Workflows, along with configuration files (Remotion config, TypeScript config) and a README explaining how to build the video and GIF assets.
design/video · high confidence
Added glass.ai design asset
A new Adobe Illustrator design file named glass.ai has been added to the design/artwork directory. This vector graphic, created in Adobe Illustrator 26.5, serves as a visual asset for the project.
design/artwork · high confidence
Automated Elsa release announcements on Discord, LinkedIn, and X
A new agent skill for Elsa release announcements has been added to automate drafting and publishing release posts across Discord, LinkedIn, and X. The skill includes a Python script to generate channel-specific announcement drafts from release notes, and helper scripts to safely post to Discord (supporting bot and webhook modes with resumable state and crossposting) and to LinkedIn/X via Buffer (with intent persistence, reconciliation logic for interrupted calls, and receipt validation). The skill is designed to be invoked after a verified Elsa release to ensure consistent, auditable, and recoverable community communications.
.agents · high confidence
Automated generation of the ADR table of contents
A new script, scripts/adr/generate-toc.sh, automatically regenerates the Architecture Decision Records (ADR) index (docs/adr/toc.md) from the individual ADR files. This eliminates the manual effort and potential drift of maintaining the index by hand, ensuring it always reflects the current state of the ADR directory. The script supports a --check mode to verify index currency without writing, and handles both numbered and date-based ADR naming conventions to maintain chronological order.
scripts/adr · high confidence
Git workflow extension for automated branching and commits
The Specify tooling now includes a bundled Git extension that automates repository initialization, feature branch creation (with sequential or timestamp numbering), branch validation, and auto-committing changes at key workflow stages. Users benefit from consistent branch naming conventions and optional automatic commits before and after specification, planning, and implementation steps, with graceful degradation if Git is unavailable.
.specify · high confidence
Introduce Elsa release tooling and integration-program proof scripts
This change adds a new set of Python scripts to automate and verify Elsa release processes. The \.agents/skills/elsa-release\ directory introduces a release helper (\release.py\) that validates source tags, existing releases, and containment before executing GitHub release creation, alongside a \release\_notes.py\ script that generates categorized Markdown changelogs from commit history. Additionally, the \scripts/integration-program\ directory adds several proof and migration scripts: \consolidated\_package\_recovery.py\ for read-only reconciliation of NuGet packages from the Feedz index, \github\_activity\_id\_migration.py\ for migrating legacy GitHub activity IDs in workflows, \run\_persisted\_workflow\_upgrade\_fixture.py\ for verifying SQLite suspension/resumption across versions, and \run\_slack\_package\_proof.py\ for building and verifying local package proofs. Finally, \scripts/solution/solution\_groups.py\ adds tooling to group the Elsa.sln solution into Foundation, Extensions, Studio, and Apps categories with focused filters.
python · high confidence
New Docker infrastructure for .NET 10.0, OpenTelemetry, and multi-database support
The project now provides a complete set of Dockerfiles and compose configurations to run Elsa Server and Studio on .NET 10.0. The standard images include Python 3.11 support and CA certificates for secure HTTPS connections. A new Datadog-enabled image (\ElsaServer-Datadog.Dockerfile\) and associated compose file (\docker-compose-datadog+otel-collector.yml\) introduce OpenTelemetry auto-instrumentation and tracing via a Datadog agent. The \docker-compose.yml\ has been expanded to include services for PostgreSQL, SQL Server, MySQL, Oracle, MongoDB, RabbitMQ, Redis, and an SMTP mock server, allowing for easy local development with various database backends.
docker · high confidence
New external authentication broker endpoints and connection management APIs
The Elsa.ExternalAuthentication module now exposes a set of new broker endpoints for handling external identity flows, including discovering login methods, initiating external and local authorizations, exchanging tokens, and managing logout callbacks. Additionally, a new connection management API is available for listing, creating, updating, and viewing identity provider connections, featuring ETag-based concurrency control, cursor-based pagination, and support for host-scoped connections. These changes introduce new rate-limiting policies and data protection purposes to support the new authentication broker and connection management capabilities.
core/src/modules/Elsa.ExternalAuthentication, core/src/modules/Elsa.Identity, extensions · high confidence
New integration-program tools for verifying embedded sources and activity contract compatibility
The integration-program script area now includes new verification tools: a C\# utility to validate that embedded source code in Portable PDBs matches pinned Extensions source files, and a comprehensive activity-compatibility harness that probes Elsa workflow activities across released and consolidated builds to ensure serialization round-trips and historical workflow preservation remain intact. This harness uses a matrix of assembly definitions and strict contract comparison logic to detect unexpected changes in activity inputs, outputs, and identities, with Python scripts and tests to automate the build, probe execution, and evidence validation.
scripts/integration-program · high confidence
New modular server and sample packages for plugin discovery
The Elsa.ModularServer.Web application now exposes a sample catalog API (endpoints under /catalog) that lists active packages, their loaded assemblies, and discovers IPlugin implementations from the active package set. A new Elsa.SamplePackage demonstrates this by registering a sample endpoint and service, while the server host wires up the Nuplane plugin loader, assembly provider, and the PluginCatalog service to enable this discovery.
(repo-wide) · high confidence
Architecture
Repository consolidation and developer workflow standardization
The repository has been restructured into a consolidated layout with \core/\, \extensions/\, and \studio/\ product directories, each containing their own \src/\, \test/\, and \docs/\ folders. This change introduces standardized developer tooling, including a NUKE-based build system (\build/Build.cs\), solution filters for focused builds (e.g., \Elsa.Core.slnf\), and centralized build policies via \Directory.Build.props\ and \Directory.Build.targets\. New documentation files (\AGENTS.md\, \CLAUDE.md\, \CONTEXT.md\, \CONTRIBUTING.md\) define coding standards, testing guidelines, and contribution workflows. Additionally, \.dockerignore\ and \.gitignore\ files have been added to exclude local credentials, build artifacts, and IDE-specific files from version control and Docker contexts.
(repo-wide) · high confidence
Behavioural changes
5 commits (0 fixes) modifying design
A change to existing behaviour in design — 5 commits, 2 files.
design · medium confidence · unverified
Gated package publication and TLS trust validation
The scripts directory now enforces strict gating for package publication workflows and validates Docker image trust. A new validation script rejects manual publication runs if the selected artifacts (Feedz, NuGet, or coverage) do not match the dispatched ref (e.g., preventing NuGet publishing from branches or restricting 3.10.x tags to Feedz only). A companion workflow gate script ensures that sensitive capabilities like secrets, OIDC tokens, and package pushes are only accessible within specific gated jobs, explicitly rejecting indexed secret access outside these controlled contexts. Additionally, a new smoke test script verifies that Docker images correctly ship CA trust certificates and handle TLS connections via public stores, custom CA injection, and environment variable fallbacks.
scripts · high confidence
New Docker scripts and compose files for Citus, YugabyteDB, and updated SQL Server
The scripts/docker directory now includes dedicated Docker Compose configurations for Citus (docker-compose-citus.yml) and YugabyteDB (docker-compose-yugabyte.yml), enabling users to run the application with these distributed database backends. The main docker-compose.yml has been updated to use SQL Server 2022 (mcr.microsoft.com/mssql/server:2022-latest) and includes a new Citus service definition. Additionally, new shell and PowerShell scripts (build-and-run-all-in-one-web.sh, docker-run-all-in-one-web.ps1) have been added to simplify building and running the all-in-one web application locally.
scripts/docker · high confidence
New NUKE-based build system and CI configuration
The build process has been migrated to use the NUKE build automation framework, replacing the previous system. This change introduces a new \build/\ directory containing the core build logic (\Build.cs\), CI pipeline definitions for GitHub Actions (\Build.CI.GitHubActions.cs\), and standardized code formatting rules (\.editorconfig\). For users, this means the build now explicitly targets .NET 10.x, enforces stricter code style rules, and automatically uploads test results and hang dumps to GitHub Actions artifacts when tests fail.
build · high confidence
Updated brand assets and artwork
The design/logo directory has been updated with new artwork files, including the addition of a new PDF source file (Elsa.ai) and an updated vector logo (Esla\_vector-18.svg), replacing or supplementing previous versions to reflect the latest brand identity.
design/logo · high confidence
Updated custom icon artwork
The custom icon design in the \design/custom\ directory has been updated with a new Adobe Illustrator source file (\icon.ai\). This change replaces the previous icon asset with the latest version of the artwork, ensuring the visual identity reflects the current design specifications.
design/custom · high confidence
Updated migration generation scripts for database schema V3.4
The migration helper scripts in \scripts/migrations\ have been updated to generate Entity Framework Core migrations for database schema version V3.4. The \efcore-3.4.sh\ script now targets the 'Tenants' module alongside 'Alterations', 'Runtime', 'Management', 'Identity', and 'Labels' across all supported database providers (MySQL, SQL Server, SQLite, PostgreSQL, Oracle). This change reflects the addition of multitenancy support for background tasks and runtime tenant management, ensuring the database schema migrations align with the new tenant-aware data structures.
scripts/migrations · high confidence
Test coverage
Added tests for solution grouping logic and manifest validation; Added unit and integration tests for Elsa modules; Added unit tests for authentication UI and dashboard components.
Dependencies
Adopts Central Package Management and targets .NET 10
The project now uses Central Package Management (CPM) via \Directory.Packages.props\ to define and version all NuGet packages in one place, simplifying dependency updates across the solution. Additionally, the build infrastructure and core modules have been updated to support .NET 10 (LTS), with specific package versions defined for \net10.0\ targets alongside existing \net8.0\ and \net9.0\ support.
(dependencies) · high confidence
Housekeeping
Documentation updates for core development and directory layout; Studio documentation relocated to product-owned directory structure.
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 64 → 56 (-8.1)
- Rubric changed (rubric-2026.09.15 → rubric-2026.10.5) — scores are not directly comparable.
Lenses
- Code Health 78 → 73 (-4.7)
- Architecture 67 → 63 (-4.1)
- Maturity 83 → 82 (-1.0)
- Readiness 73 → 58 (-14.3)
- Security 62 → 61 (-1.4)
- Domain Modelling 56 (new)
- Event-Driven 100 → 100 (+0.0)
- Accessibility 66 → 52 (-13.8)
- Performance 62 → 70 (+8.5)
Resolved (1021)
- AIOrchestrator.ExecuteChatAsync (cognitive 50) (src/modules/Elsa.AI.Host/Services/AIOrchestrator.cs)
- AIOrchestrator.ExecuteChatAsync (cyclomatic 34) (src/modules/Elsa.AI.Host/Services/AIOrchestrator.cs)
- ActivityExecutionRecordFilter.Apply (cognitive 32) (src/modules/Elsa.Workflows.Runtime/Filters/ActivityExecutionRecordFilter.cs)
- ActivityExecutionRecordFilter.Apply (cyclomatic 32) (src/modules/Elsa.Workflows.Runtime/Filters/ActivityExecutionRecordFilter.cs)
- ActivityWriter.WriteActivity (cognitive 30) (src/modules/Elsa.Workflows.Core/Serialization/Helpers/ActivityWriter.cs)
- BackgroundActivityInvokerMiddleware.CompleteBackgroundActivityScheduledActivitiesAsync (cognitive 22) (src/modules/Elsa.Workflows.Runtime/Middleware/Activities/BackgroundActivityInvokerMiddleware.cs)
- BarePragmaDisable (src/modules/Elsa.Common/Serialization/SerializationTypeResolver.cs)
- BarePragmaDisable (src/modules/Elsa.Expressions.JavaScript/TypeDefinitions/Services/TypeDescriber.cs)
- BarePragmaDisable (src/modules/Elsa.Workflows.Management/Mappers/WorkflowDefinitionMapper.cs)
- BareSuppressMessage (test/unit/Elsa.Activities.UnitTests/Http/ZipManagerTests.cs)
- BookmarkFilter.GetHashableString (cognitive 16) (src/modules/Elsa.Workflows.Runtime/Filters/BookmarkFilter.cs)
- BpmnProcess.AddStartTriggerPayload (cognitive 20) (src/modules/Elsa.Bpmn/Activities/BpmnProcess.cs)
- BulkPublish.ExecuteAsync (cognitive 18) (src/modules/Elsa.Workflows.Api/Endpoints/WorkflowDefinitions/BulkPublish/Endpoint.cs)
- BulkUpsertExtensions.GeneratePostgresUpsert (cognitive 16) (src/modules/Elsa.Persistence.EFCore.Common/Extensions/BulkUpsertExtensions.cs)
- BulkUpsertExtensions.GenerateSqlServerUpsert (cognitive 16) (src/modules/Elsa.Persistence.EFCore.Common/Extensions/BulkUpsertExtensions.cs)
- CRAP 30: BackgroundJobProcessor.ProcessJobsAsync (src/common/Elsa.Mediator/Services/BackgroundJobProcessor.cs)
- Change coupling: ElsaDistributedLockHealthCheck.cs ↔ ElsaWorkflowPersistenceHealthCheck.cs (src/modules/Elsa.Workflows.Runtime/HealthChecks/ElsaDistributedLockHealthCheck.cs)
- Change coupling: Endpoint.cs ↔ Endpoint.cs (src/modules/Elsa.Workflows.Api/Endpoints/WorkflowDefinitions/Export/Endpoint.cs)
- Change coupling: Endpoint.cs ↔ Endpoint.cs (src/modules/Elsa.Workflows.Api/Endpoints/WorkflowDefinitions/Import/Endpoint.cs)
- ClassTooLong: DefaultUserTaskManager (src/modules/Elsa.UserTasks/Services/DefaultUserTaskManager.cs)
- …and 1001 more
New (1817)
- AIOrchestrator.ExecuteChatAsync (cognitive 50) (core/src/modules/Elsa.AI.Host/Services/AIOrchestrator.cs)
- AIOrchestrator.ExecuteChatAsync (cyclomatic 34) (core/src/modules/Elsa.AI.Host/Services/AIOrchestrator.cs)
- ActivityDetailsTab.CreateDataModels (cognitive 36) (studio/src/modules/Elsa.Studio.Workflows/Components/WorkflowInstanceViewer/Components/ActivityDetailsTab.razor.cs)
- ActivityDetailsTab.CreateDataModels (cyclomatic 21) (studio/src/modules/Elsa.Studio.Workflows/Components/WorkflowInstanceViewer/Components/ActivityDetailsTab.razor.cs)
- ActivityExecutionRecordFilter.Apply (cognitive 32) (core/src/modules/Elsa.Workflows.Runtime/Filters/ActivityExecutionRecordFilter.cs)
- ActivityExecutionRecordFilter.Apply (cyclomatic 32) (core/src/modules/Elsa.Workflows.Runtime/Filters/ActivityExecutionRecordFilter.cs)
- ActivityExtensions.FindActivitiesContainer (cognitive 18) (studio/src/modules/Elsa.Studio.Workflows.Core/Extensions/ActivityExtensions.cs)
- ActivityNode.ActivityNodeImpl (cognitive 21) (studio/src/modules/Elsa.Studio.Workflows.Designer/ClientLib/src/react-designer/components/ActivityNode.tsx)
- ActivityNode.ActivityNodeImpl (cyclomatic 23) (studio/src/modules/Elsa.Studio.Workflows.Designer/ClientLib/src/react-designer/components/ActivityNode.tsx)
- ActivityWriter.WriteActivity (cognitive 30) (core/src/modules/Elsa.Workflows.Core/Serialization/Helpers/ActivityWriter.cs)
- AdmissionBootstrapService.ProvisionAsync (cyclomatic 17) (core/src/modules/Elsa.Workflows.Admission/AdmissionBootstrapService.cs)
- AdmissionHostConfiguration.ValidateAsync (cognitive 18) (core/src/modules/Elsa.Workflows.Admission/AdmissionHostConfiguration.cs)
- AdmissionHostConfiguration.ValidateAsync (cyclomatic 28) (core/src/modules/Elsa.Workflows.Admission/AdmissionHostConfiguration.cs)
- AdmissionValueFingerprint.Write (cognitive 22) (core/src/modules/Elsa.Workflows.Admission/AdmissionValueFingerprint.cs)
- AdmissionValueFingerprint.Write (cyclomatic 29) (core/src/modules/Elsa.Workflows.Admission/AdmissionValueFingerprint.cs)
- BackgroundActivityInvokerMiddleware.CompleteBackgroundActivityScheduledActivitiesAsync (cognitive 22) (core/src/modules/Elsa.Workflows.Runtime/Middleware/Activities/BackgroundActivityInvokerMiddleware.cs)
- BarePragmaDisable (core/src/modules/Elsa.Common/Serialization/SerializationTypeResolver.cs)
- BarePragmaDisable (core/src/modules/Elsa.Expressions.JavaScript/TypeDefinitions/Services/TypeDescriber.cs)
- BarePragmaDisable (core/src/modules/Elsa.Workflows.Management/Mappers/WorkflowDefinitionMapper.cs)
- BarePragmaDisable (studio/src/framework/Elsa.Studio.Core/Contracts/IThemeService.cs)
- …and 1797 more
Changes since last survey
- 300 commits — 264 feature/other, 36 fixes
By area
- scripts/integration-program — 88 commits
- (repo) — 67 commits
- src/modules — 31 commits
- test/integration — 27 commits
- doc/integration-program — 13 commits
- .agents/skills — 11 commits
- .github/workflows — 9 commits
- src/extensions — 7 commits
- test/extensions — 5 commits
- test/studio — 5 commits
- test/workers — 5 commits
- (root) — 4 commits
- src/studio — 4 commits
- doc/design — 3 commits
- docs/integration-program — 3 commits
- test/unit — 3 commits
- .github/dependabot.yml — 2 commits
- doc/adr — 2 commits
- doc/guides — 2 commits
- test/modules — 2 commits
Notable commits
- fix: Add exact-source Mongo regression and replica-set proof
- fix: Apply required braces to literal-prefix regression assertions
- fix: Bound reviewed Dapper save contention retries with SQLite and PostgreSQL regression
- fix: Catalog first real admission runtime regression cases
- fix: Fix Dapper literal prefix matching
- fix: Fix Dependabot discovery for imported product projects (#8638) [skip ci]
- fix: Fix admission package consumer public API calls
- fix: Fix admission receipt publication commit boundary
- fix: Fix execution cycle ownership through checkpoints and trailing writes
- fix: Fix operator commands after product documentation relocation
- fix: Fix recursive Dependabot project discovery and validate coverage (#8640) [skip ci]
- fix: Integrate control compatibility cases and hosted fixture compiler fixes
- fix: Integrate drain and variable persistence semantics with fixture API fixes
- fix: Integrate real telemetry guard boundary regression
- fix: Merge pull request #8674 from elsa-workflows/codex/fix-relocated-operator-doc-paths-8667
- fix: Preserve Studio feature namespace and drawer review fix history
- fix: Record bounded retry source receipt and regression evidence
- fix: Resolve relocated current paths in proof regression tests
- fix: fix(dependabot): recursively select imported project directories
- fix: fix(deps): scan imported product projects recursively
- …and 280 more
API surface
- 10 added · 0 removed (a removed endpoint is potentially breaking)
Added endpoints (10)
- GET /__fixture/secrets/routes
- GET /authentication/external/callback
- GET /authentication/external/login/{connectionKey}
- GET /authentication/external/logout-callback
- GET /authentication/login
- GET /documentation
- GET /openapi.json
- POST /authentication/external/local-login
- POST /authentication/external/logout
- POST /authentication/logout
Architecture
- 14 containers · 5 bounded contexts · 4 dependency edges (baseline)
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
elsa-workflows/elsa-core was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 9 October 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 061ddf3973f6b86becaff6e927438d17d1b8065c — the exact code this score is about.
- Scored under rubric-2026.10.5 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-fe8540b5da9b.