Workable.AspNetCore 1.1.63026.1

• net10.0

  • Workable.Abstractions (>= 1.1.63026.1)

# 1.1.63026.1

Date: 2026-06-30

## Breaking Changes

- `IWorkPersistenceStore` and related durable persistence contracts now include workflow persistence support. Custom persistence-store implementations must add the new workflow snapshot, transition, recovery, and transaction members before upgrading. The built-in SQL Server store includes these implementations.
- SQL Server durable storage now includes workflow persistence schema changes. Hosts with `AutoDeploySchema` enabled are upgraded automatically; hosts that manage schema manually should apply the updated schema before enabling durable workflows.
- `WorkEventSubscriptionOptions` now includes an overflow behavior setting in addition to capacity. Source callers using named or single positional arguments continue to compile, but precompiled consumers should be rebuilt against this package.

## Added

- Added first-class workflow orchestration through `WorkflowDefinition` and `IWorkflowBuilder`, including `DispatchWork`, typed `DispatchEach`, `RunParallel`, and `Join` steps.
- Added workflow identifiers, workflow definition versions, run identifiers, run status, step status, workflow actions, available actions, run handles, and workflow run snapshots.
- Added in-memory workflow execution for non-durable workflow runs.
- Added durable workflow execution and recovery. Durable workflows persist run snapshots, child dispatch state, retained child completion receipts, pause/cancel intents, and resume incomplete runs for named systems on startup.
- Added SQL Server workflow persistence support, including workflow transactions that persist workflow transitions and child durable queue dispatch boundaries together.
- Added workflow HTTP API routes for starting runs, reading workflow run detail, and issuing workflow actions.
- Added MCP workflow tools for discovering workflows, starting workflow runs, reading run state, and controlling runs.
- Added SignalR workflow realtime views and workflow run operator views.
- Added an admin UI workflow run screen with structure navigation, sampled child workers, action controls, paging, and auto-follow behavior for active runs.
- Added coalesced work change streams through `IWorkChangeStream`, `WorkChange`, and `WorkChangeKey` so realtime surfaces can refresh affected state without replaying every event.
- Added durable queue diagnostics for claim attempts, claim throughput, claim acceptance timing, pending cleanup, accepted waiters, and recent claim samples.
- Added configurable event subscription overflow behavior and expanded event subscription diagnostics for accepted, delivered, queued, peak queued, and dropped events.
- Added performance harness coverage for durable workflow recovery, durable child reconnects, HTTP/MCP query paths, authorization paths, SignalR fanout, workflow dispatch, workflow parallel joins, and durable SQL Server scenarios.
- Added workflow documentation and updated API, realtime, authorization, observability, queue durability, registration, and project-structure docs for the new workflow and change-stream surfaces.

## Changed

- Realtime named views and SignalR worker overview updates now use coalesced change-stream keys to reduce unnecessary refreshes and fanout work.
- SignalR named views now filter refreshes by changed keys and track workflow view versions separately from worker read-model versions.
- Durable SQL Server queue processing now supports batched enqueue, batched claims, detailed claim sampling, and improved throughput diagnostics.
- Durable workflow starts are persisted before the start request is acknowledged, final workflow lifetime state is cleaned up consistently, child-retention retry behavior is built in, and blocked runs can auto-resume after child work is restarted and completed.
- Workflow joins now retain child completion receipts so operator views and recovery do not depend on completed child workers remaining queryable forever.
- Workflow runs can now be paused, canceled, restarted, and auto-resumed when blocked child workers later complete successfully.
- The sample host now includes workflow registration and demo workflow fanout data.
- The admin UI now includes shared execution-status controls, workflow run navigation, workflow progress summaries, and panel state improvements for workflow and overview screens.
- NuGet publishing now reads package release notes from a versioned file under `releases/`.

## Fixed

- Fixed sample host schema drift for the generated SQL Server schema.
- Improved in-memory cleanup and SignalR realtime exception filtering so cancellation and critical runtime exceptions are not swallowed as ordinary recoverable failures.
- Fixed SignalR broadcast handling so independent `OperationCanceledException` failures propagate instead of being logged as per-subscription broadcast failures.
- Improved durable and realtime performance test coverage, including regression coverage for broadcast lanes, worker overview updates, workflow runtime internals, workflow persistence, workflow recovery, and SQL Server persistence.
- Clarified the platform-specific UI test command in repository agent notes.

## Security

- Updated admin UI transitive dependencies to patched versions for `@babel/core`, `ws`, `undici`, `hono`, and `js-yaml`, clearing the known Dependabot and npm audit advisories present before this release.