Repository navigation
Conversation
Relocates the v2.0.0 architecture docs, package READMEs, guides and changelogs under docs/legacy-version so docs/ can hold the v3 product requirements and technical design. Content is unchanged.
Reverse-engineered requirements for SourceFlow.Net (core, EF stores, AWS/GCP cloud messaging, non-functional), a gap and risk register (GAP-01..20, Q1-Q7) with code evidence, and the new requirement for a workflow DSL and React visual designer (WFD-10..37).
Technical design for the .NET 10 rewrite: event sourcing with pure deciders, commit-ordered event store, transactional outbox/inbox, partitioned subscriptions, AWS/Azure/GCP transports with a conformance kit, observability, security, the per-service query API (SFQL with SQL syntax and injection-proof compilation), and the workflow DSL plus SourceFlow Studio. Includes 26 ADRs, a competitive analysis, and implementation plans for the v3.0.0 branch: work breakdown (54 WPs + track S), test strategy, unit/integration/E2E catalogues, v2 test disposition, CI/CD gates, and the GA cutover runbook.
…ution rules next-version 3.0.0; 'v3' branch config (alpha) and 'v3-work' config for work-package branches, per implementation plan 02 §2. CONTRIBUTING.md documents branches, the PR Definition of Done and the tag-collision rule.
- SourceFlow.slnx with src/ and tests/ grouped by category: Core (SourceFlow.Net single core + SourceFlow.Generators), Storage (SourceFlow.Storage.PostgreSQL/SqlServer/EntityFrameworkCore), Cloud (SourceFlow.Cloud.Aws/Azure/Gcp), Hosting (SourceFlow.AspNetCore), Tooling (SourceFlow.Testing, SourceFlow.Tool), Workflows (SourceFlow.Studio). - One test project per category plus EndToEnd and Architecture. - net10.0 only; the generator is the single netstandard2.0 exception. - Central package management, warnings as errors, AOT analysis, SourceLink, deterministic CI builds, banned non-deterministic APIs in tests. - Microsoft.Testing.Platform runner opted in via global.json. - SourceFlow.Net.sln removed; v2 projects stay on disk outside the build.
…ed adapters Records the consolidation and renames: SourceFlow.Net absorbs the abstractions, workflow runtime types and OpenTelemetry wiring and exposes the persistence, transport, security, query, pipeline and diagnostics SPIs; storage adapters become SourceFlow.Storage.*, one SourceFlow.Cloud.* package per cloud carries its transport and KMS key provider, and the workflow DSL core becomes SourceFlow.Studio. Design docs, ADRs and implementation plans are updated to the new names, test layout and dependency rules.
v3-pr runs build (ubuntu, windows), unit, storage, transports (aws, gcp, azure emulators), e2e, coverage gate, API approval and traceability, and pack layout checks. v3-nightly runs the database matrix, real-cloud TCK through OIDC, chaos and long property runs. Emulator compose files move to .github/emulators with pinned images.
…e gate Architecture tests enforce ARCH-01..03, 05, 07 and 08 (traceability ids read from test assemblies through MetadataLoadContext). Library code bans reflection activation, CLR-name type lookup and wall-clock reads at compile time. SourceFlow.Testing gains approved-file snapshots; public API approval is opt-in per test project. tools/CoverageGate applies the plan 04 thresholds and the no-drop rule.
Messages, attributes, strongly typed id contracts, stream/version/position primitives, Decision and DecisionContext, Error, the command sender API with consistency tokens, Reaction (DC-3), projections, event handlers and the module builder surface. Tests UT-ABS-01..18.
Generates strongly typed ids (UUIDv7 New, parsing, formatting, JSON converter), aggregate dispatch (Decide, Evolve, TargetOf), process manager React/CorrelateBy, projection Apply/TryGetKey and the module registration, from value-equatable pipeline models. Analyzers SF0001-SF0004 and SF0007-SF0009. The Bank sample Accounts domain is the first consumer. Tests GEN-01..40 including incrementality and an approved snapshot of the sample output.
MessageEnvelope with CloudEvents binary/structured mapping and overflow, RFC 9562 UUIDv5 ids for idempotency keys, the frozen allow-list type registry with upcaster chains, the System.Text.Json serializer over module contexts, size and header limits. SourceFlowModelBuilder turns generated registrations into AOT-safe descriptors. ARCH-05 now scans IL for banned reflection calls. Tests UT-MSG-01..28.
SourceFlow.Storage defines the persistence ports (event store, commit-ordered log, sessions with write-behind semantics, inbox, outbox with head-of-key claims, fenced leases and checkpoints, process state, versioned documents, dead letters, snapshots, notifications) plus bucket and outbox partition math. InMemoryStore implements every port transactionally with fault hooks. SourceFlow.Testing ships the framework-agnostic storage conformance kit (SCK-01..58 mandatory cases); the in-memory store passes all of them. Tests UT-STO.
…and Bank sample Runtime (SourceFlow.Runtime, .Pipeline, .Diagnostics, .Transport, .Query, .Hosting): - routing table with owned-xor-routed validation and logical names (RT-R1, RT-R5); options with source-generated and timing validators (no inert options); - command processor: one session per attempt, inbox, fold, decide (generated or ICommandHandler), append first (ES-R1), publications to the outbox, inline projections, commit; jittered re-decide on conflicts; keyed sends return the original result; default target ids are rejected; - command sender (local xor remote), temporal aggregate reader (AsOf version/time); - one middleware abstraction with built-in telemetry, logging scope and error classification; SourceFlowMetrics with InstrumentAdvice buckets; - transport SPI and in-memory broker (per-service fan-out, competing consumers, delayed redelivery, duplicate/dropped-ack faults); - outbox relay with fenced partition leases, head-of-key order, backoff and parking; - receive endpoint with partitioned workers, bounded channels, settle after commit, immediate and delayed retries, parking; per-consumer inbox for process managers and event handlers; - subscription engine over the commit-ordered log: fenced partitions, batch plus checkpoint in one transaction, poison-event isolation and parking; - process manager runner (state with optimistic concurrency, commands and timers via the outbox); dead-letter manager (list, replay, discard); - AddSourceFlow with Use* slots for storage and transport, roles, hosted lifecycle and readiness health check. SourceFlow.Testing: SourceFlowTestHost with deterministic idle detection, aggregate, process-manager and projection specs. Bank sample: Contracts, Accounts, Transfers (MoneyTransfer with timeout and compensation) and Notifications (second service). E2E-01..07, 11, 13, 14, 17..20, UT-RT, UT-MW, UT-HOST, UT-OUT, UT-RX, UT-TST and ARCH-04 are green (233 tests).
… system clock SourceFlow.Testing ships TCK-01..12 (round trip, attribute fidelity, per-key order, settle semantics, delayed redelivery, per-service fan-out, competing consumers, size limit, provisioning, capabilities, binary bodies); the in-memory broker passes all of them. Long-poll, poll-fallback and conflict-backoff waits now use the system clock, so a fake business clock in tests can never stall the runtime; message visibility and timers still follow the configured TimeProvider.
Aggregates that opt in with SnapshotEvery load from the latest snapshot whose schema hash (SnapshotVersion plus the state's JSON shape) matches, then fold the tail; snapshots are written after commit, outside the command transaction, best effort. The generator emits SnapshotVersion. New compilation-end analyzers: SF0006 (command with no Decide or handler) and SF0010 (type missing from the module JSON context, DC-1). Tests UT-SNAP-01..02, GEN-29, GEN-34.
MapCommand<TCommand>(pattern) binds the JSON body plus route values to the command through the registry's source-generated metadata (no reflection binding), maps Idempotency-Key and If-Match, and returns 200 with ETag and SourceFlow-Consistency, 202 for remote dispatch, 422 ProblemDetails for rejections, 409/412 for conflicts and 400 for unreadable bodies. Tests UT-ASP-01..06 on TestServer.
SourceFlow.Storage.PostgreSQL implements every storage port over one NpgsqlDataSource and passes the storage conformance kit on PostgreSQL 15, 16 and 17. - Schema V001 with every doc 05 table plus schemas, nodes, collection_aliases and subject_streams; payload columns are json so bytes round-trip exactly (ADR-028), tenant columns per ADR-022. - PostgreSqlSchemaMigrator: advisory lock, checksummed schema_history, db script output; UsePostgreSql migrates at startup in Development and verifies elsewhere (IHostedLifecycleService.StartingAsync). - Write-behind session: one NpgsqlBatch per commit with the append first (ES-R1/ES-R2); CTE append for every ExpectedVersion kind; conflict, closed-stream, duplicate and fencing failures mapped and rolled back. - Gap-free global log ordered by (tx_id, seq) below pg_snapshot_xmin, bucket filtering, inclusive horizon, horizon age. - Head-of-key outbox claim, fenced complete/retry, database-clock leases, fenced checkpoints, inbox results, process-state CAS, versioned documents, dead letters, snapshots. - LISTEN/NOTIFY with origin filtering and reconnect. Core: a missing CloudEvents correlation maps to CorrelationId.None so envelopes round-trip; the safe horizon is documented as inclusive and the conformance kit's log cases wait for it to pass their commits. Tests: SCK on PostgreSQL (45 cases), SCK-M01..M06, adapter cases for the database clock, LISTEN, the held horizon and byte-exact payloads, and the Bank sample end to end on PostgreSQL.
TenantIsolation.RowLevelSecurity makes PostgreSQL enforce tenancy
(ADR-022), so a query without a tenant predicate, or one that forges
another tenant's key, still sees only the session tenant's rows.
- V002 creates tenant_isolation policies (USING and WITH CHECK on
current_setting('sourceflow.tenant')) on streams, events, snapshots,
documents, process_instances and subject_streams.
- The migrator enables and forces row-level security for the
configured isolation and verification fails on a mismatch; db script
output includes the same statements.
- Sessions set the tenant at begin, so custom SQL on the session
connection is scoped too; tenant reads outside a session send the
setting in the same batch.
- The global log is read through SystemConnectionString, a BYPASSRLS
role, because it spans tenants; RLS without it is rejected.
Tests: the whole storage conformance kit under row-level security
through a DML-only role, forged-query and cross-tenant write
rejection, isolation verification, and the Bank transfer end to end
under row-level security.
EF Core projections write relational read models through a DbContext bound to the storage session, so they commit with the events (inline) or with the fenced subscription checkpoint (async), as doc 05 §10 specifies. Core - Session projections: ISessionProjection<TUnitOfWork> (generated ISessionProjectionRuntime), registered by modules with AddSessionProjection; ProjectionDescriptor is now the general base and DocumentProjectionDescriptor the document kind. - IProjectionUnitOfWork<T> SPI: a storage package creates the unit of work on the session and completes it before the commit; a projection without one fails at startup. - IStorageSession.FlushAsync sends queued writes, append first, without committing. The projection scope flushes before the first unit of work, so EF writes always follow the append (ES-R1) and conflicts surface before any EF write. Generator: [Projection] classes implementing ISessionProjection<T> get When(TEvent, T, EventContext, CancellationToken) dispatch (ValueTask or Task) and module registration (GEN-41, GEN-42). SourceFlow.Storage.EntityFrameworkCore: IEfProjection<TDbContext>, EfSessionContextFactory (session connection and transaction), UseEntityFrameworkProjections, IVersionedReadModel and IdempotentUpsert. Tests: UT-EF-01..04 and SCK-61..64 on PostgreSQL, including retries on real conflicts leaving no EF trace and a lost lease rolling back EF changes.
Snapshots no longer delay commands, and an opt-in in-process cache skips most of the load work (doc 05 §8). - SnapshotWriter: a bounded queue drained by one background loop while the host runs; a full queue drops the oldest entry and a failed write is dropped too (sourceflow.snapshot.written/dropped). The host drains it on shutdown; without a running host snapshots are written inline. - AggregateCache (Microsoft.Extensions.Caching.Memory, size-limited): SourceFlowOptions.AggregateCache = ReadTail starts from the cached state and reads the tail; Optimistic skips the tail read and relies on the append's version check, invalidating on conflict. - Optimistic mode confirms a rejection or no-op against the stream tail before returning it, because a decision that appends nothing is never version-checked; a command with an expected version (If-Match) never takes the shortcut. Doc 05 §8.2 is updated accordingly. - sourceflow.aggregate.cache.hits with result hit, miss or stale. Tests: UT-SNAP-03..10 (drop-oldest without blocking, failing store, ReadTail catching up with another node, optimistic conflict recovery, stale-rejection confirmation, If-Match), SCK-52/53/55 on every store, and parallel deposits on PostgreSQL in both cache modes.
…ity and retention The storage conformance kit now covers the plan 06 §2 catalogue for the in-memory store, PostgreSQL and PostgreSQL with row-level security. Kit and tests - SCK-23: events written but not committed stay below no horizon and are invisible until commit (uses IStorageSession.FlushAsync). - SCK-37: batched retention of processed inbox rows and resolved dead letters; parked dead letters are never purged. - SCK-54: a CsCheck property over random command histories proves that loading a snapshot plus the tail equals the full fold, with background snapshots at varying lag. - SCK-28 (PostgreSQL): killing the LISTEN backend triggers a reconnect with a catch-up signal, so a commit made while disconnected is not missed. - SCK-L01: CsCheck linearisability of concurrent Any and NoStream appends and appends with outbox rows (compare-and-set plus append/outbox atomicity), shared by the in-memory and PostgreSQL suites. Retention (doc 05 §9) - IStoreRetention port (optional on StoragePorts) implemented by the in-memory and PostgreSQL stores in bounded batches; PostgreSQL inbox rows now record processed_at from the configured clock. - The relay role runs retention every RetentionInterval with InboxRetention, DeadLetterRetention and RetentionBatchSize options. SCK-20 (one round trip per commit) moves to WP-2.10 and SCK-65..72 (partitioned events) to WP-4.5.
…re projections Benchmarks (benchmarks/SourceFlow.Benchmarks) - BenchmarkDotNet: PERF-01 in-process command, PERF-02 middleware, PERF-03 PostgreSQL commit (1/3/10 events + outbox), PERF-04 load with 0/100/1,000 events with and without snapshots, PERF-06 global log read. - Measurement harness: PERF-05 projection rebuild, PERF-08 event to projection latency over LISTEN/NOTIFY, PERF-10 startup to ready. - `baseline` mode writes benchmarks/baselines/*.json; a nightly job runs it and uploads the results. Report: implementation/perf-baseline.md. Improvements found by the baseline - One-round-trip PostgreSQL commit: conditional writes assert in SQL (sf_assert, migration V003, SQLSTATE SF001) and COMMIT rides in the batch; a failed check aborts before COMMIT and maps to the same exceptions. SCK-20 counts Npgsql activities to prove one round trip. - Batch-aware document projections (doc 06 §85): a batch prefetches its documents with IDocumentSession.GetManyAsync, applies events in memory and writes each changed document once (multi-row unnest upsert on PostgreSQL). Rebuild rose from about 4,100 to 15,000 events/s at 256-event batches. - Adaptive subscription batches (doc 06 §2): 100 events, doubling while behind, up to SubscriptionBatchSize (now 1,000 by default). Rebuild reaches about 33,000 events/s. Results: PERF-03/04/05/06/08 meet their targets; PERF-01/02 allocations and the PERF-10 cold start are logged as deviations owned by WP-6.2. PERF-07 waits for the M3 emulators and PERF-09 for WP-4.7.
…L parsers Both SFQL syntaxes (doc 14 §4) now parse into one normalised AST in SourceFlow.Query, the base for the binder, policy, interpreter and the PostgreSQL compiler. - Request guard (§9.2): length, valid UTF-16, NFC, no NUL/control characters or bidi overrides/isolates (SFQ0103/0104). - Lexer: ASCII identifiers (no homoglyphs), zero-width characters only inside strings, durations (7d/12h/30m/15s/ms), decimals (12.50m), parameters; comments and ';' are tokens so they can be rejected by name. - Pipeline parser: every source and stage, with canonical stage order; summarize names are substituted into a following where (HAVING) and project, and lookup desugars to a left join on id, so a pipeline query and its SQL equivalent print the same tree. - SQL parser: the read-only SELECT subset with DISTINCT, aliases, INNER/LEFT joins on column equalities, GROUP BY/HAVING, ORDER BY with NULLS FIRST/LAST, LIMIT/OFFSET and IN/EXISTS subqueries (depth 1). DML, DDL, EXEC, WITH, UNION, INTO, window functions, RIGHT/FULL/CROSS joins, scalar and derived subqueries are SFQ0102 naming the construct; pg_catalog, information_schema and internal tables are unreachable (I-4). - Function allow-list (I-5), request limits (joins, subqueries, IN items, parameters, depth, columns, grouping keys), positions on every error, and messages that never echo the query text (S-3). Tests: UT-QL-01..13, 61..65 and 69..77, including pipeline/SQL tree equivalence for doc 14 examples A and G and the Example I injection cases.
Catalog (doc 14 §2, Q-B1): QueryCatalog is built from the runtime model, so it holds only the event types (every version), read models and aggregates this service's modules register. Fields come from the source-generated JSON metadata with [Queryable], [PersonalData] and [RenamedFrom], nested objects and arrays; a SHA-256 fingerprint keys plans and continuation tokens. Binder (doc 14 §4.4, §5): resolves sources and columns (event attributes, data paths, read-model and aggregate fields), applies [RenamedFrom] per event version and marks fields missing in a version, types every expression and infers parameter types, expands defaults and *, names outputs uniquely, lets ORDER BY name an output, appends the G-6 tie-break, and enforces G-10 (ambiguity), G-11 (grouping) and G-12 (subqueries correlated by equality only). Diagnostics SFQ0201-0206. Policy (doc 14 §7.3, §8): permissions per source kind and for allow_scan / tenants='all' (SFQ0501); personal data as a filter, sort, group or join key (SFQ0301); the cost guard for event sources, with time ranges taken from parameter values (SFQ0401/0402); join rules for indexed keys and bounded event joins (SFQ0405/0406); OFFSET only on read models and within limits (SFQ0409); row limits (SFQ0103). Tests: UT-QL-21..39, 79, 80, 88, 89.
- Interpreter: tree-walking evaluator over the storage ports with SQL three-valued logic, hash joins (inner/left), grouping and aggregates that ignore nulls, correlated IN/EXISTS subqueries, aggregate as-of folds and schema rows; the reference semantics for provider compilers. - IQueryService: parse, bind, typed parameter conversion (SFQ0202/0203), policy, at_least consistency waits (SFQ0602, stale on timeout), PII redaction, tenant filtering, keyset continuation tokens bound to the query hash and catalog fingerprint (SFQ0601), plan cache. - IQueryEngine SPI so storage packages can plug in SQL compilers. - Tests UT-QL-41..60; public API approved.
- PostgreSqlQueryEngine implements IQueryEngine: one parameterised statement per page, every request value a typed $n parameter (I-3), keyset predicate and ORDER BY over a derived table, COLLATE "C" text ordering, horizon predicate, per-version rename CASE, tenant predicates, NULLIF division, read-only transaction with statement_timeout (QueryTimeout) and the RLS tenant setting. Aggregate and schema sources stay in the interpreter. - Catalog types enums by their JSON form (number or string); the interpreter returns whole event data and honours parameterised versions; Expr.ToString prints canonical text. - Tests: cross-provider equivalence with the interpreter on the same PostgreSQL data (QRY-01..20, 40, 41), golden SQL (QRY-42/43), injection corpus (QRY-44), no-literal property (QRY-60), UT-QL-66.
… demo console - Bank.Api: ASP.NET Core host for the Accounts, Transfers and Notifications modules on PostgreSQL (auto-migrated), with the command endpoints (MapCommand) and opt-in, sample-only query endpoints (POST /query, /query/validate, GET /query/schema) over IQueryService. - SourceFlow.Studio.Demo: interim console (not the doc-15 workflow designer) served with a same-origin, allow-listed proxy to the service: schema browser, SFQL/SQL query console with paging and diagnostics, Bank commands with read-your-writes follow-up queries, demo data seeding and an activity log. Text-only rendering and a strict CSP. - Multi-stage Dockerfiles (SDK on the build platform), .dockerignore, docker-compose.yml (PostgreSQL 17, service, console) and the v3-images workflow publishing linux/amd64 and linux/arm64 images to ghcr.io (branch, short SHA and v3-latest tags). - samples/README.md describes the demo.
- SF0005 (warning): an event created in an aggregate's Decide that no When of the aggregate accepts. - SF0014 (error): routing.Command<T>().To(...) for a command owned in the compilation (the target aggregate's Decide, also from a referenced module, or an ICommandHandler in source). - SF0010 code fix adds [JsonSerializable(typeof(T))] to the module's JSON context (RS1038 suppressed: code fixes are IDE-only, ADR-027). - Process managers: CorrelateBy may return a string, parsed into the id with TryParse (GEN-13). - Tests GEN-13, 28, 35, 36; guide docs/v3.0.0/guides/reading-generated-code.md.
- CommandRejected<TCommand> (MessageKind.Reply): a process manager that
reacts to it gets the owner's rejection through its correlation. The
sender adds an sf-reply-to header for locally owned commands and
ReplyOnReject() routes when it registered the reply type; the owner
enqueues the reply in the same commit as the rejection, built from the
received command JSON. The header never propagates to caused messages.
The generator registers CommandRejected<T> as "{command}.rejected" and
SF0010 requires it in the module's JSON context.
- Bank: MoneyTransfer fails at once on CommandRejected<Withdraw>; E2E-14
now times out on a rejected deposit and compensates; E2E-15 added.
- INodeRegistry (optional storage port; in-memory and PostgreSQL):
heartbeats on the store clock, live count by role. The subscription
engine takes at most ceil(leases / live nodes), releases one excess
lease per pass and hands every lease back on graceful stop.
- Unit tests UT-SUB-01/05/06/08/09/10/12/17, UT-PRJ-01, UT-PM-01/10..13;
PostgreSQL node registry test.
…le checks
CR-06: MapCommand let a body member override its route value, so
POST /accounts/A/... {"accountId":"B"} acted on B and a policy on the route
could be sidestepped. A body member that differs from its route value is now
a 400 (doc 03 section 5.1); the error doesn't echo the values.
CR-36: continuation tokens are checked against the plan before any engine
sees them: one key per sort item, of its sort item's type, and the rows
remaining present and within the limit. A forged token can no longer lift the
LIMIT or reach a compiler with keys of the wrong shape; it is a 409 SFQ0601.
CR-37: opaque JSON paths on untyped events came from the request and were
inlined as escaped constants. PostgreSQL binds them as one text[] parameter
(#>), SQL Server binds the exists() parent path; catalog paths stay constants
so expression indexes still match.
CR-38: status codes as doc 14 section 9.1: SFQ0103 is 413, SFQ0602 is 503
with Retry-After, and every concurrency limit is 429.
CR-48: the Studio host's asset containment compares with a trailing
separator, and the manifest export write checks for links and is atomic.
UT-ASP-42 and QRY-62 failed before the fix (the body won, and a token
without "r" lifted the limit). New tests: UT-ASP-42, QRY-62 with a CsCheck
property over forged keys, QRY-60 extended to opaque paths on both
providers, UT-STU-HOST-13, UT-STU-HOST-14.
CR-07: a routed ICommandSender.SendAsync called the transport directly, even inside a handler. A rollback left a phantom command, a redelivery sent it again under a new id the owner's inbox couldn't match, and the send skipped payload protection, the size check and the relay's retries (ADR-006, doc 03 section 5.2, doc 10 section 3). While an event handler (receive path and subscriptions) or a command handler runs, AmbientSend holds its session and the message it handles. The sender then writes every command, owned or routed, to that session's outbox, inside the Send stage of the pipeline, with an id derived from the cause's id and the send's ordinal, and returns Dispatched: it is sent only if the handler commits, and a redelivery sends the same ids. A routed send from an API call is written to the outbox in a session of its own. The in-service dead-letter replay goes through the outbox as well. ARCH-09, an IL scan, keeps ITransport.SendAsync and PublishAsync to the outbox relay. UT-CMD-35 failed before the fix (the routed command crossed the wire in clear text). UT-OUT-01 and UT-CMD-23 now assert delivery by the relay. New tests: UT-CMD-33..36, ARCH-09.
…y, checks retention - Ordered endpoints: when a key's head is abandoned for a delayed retry, the key's messages already received behind it are released unhandled, so the broker redelivers them after the head (CR-08). - Parking resolves services from the last attempt's scope, which now stays open until the message is settled (CR-10). - SourceFlowHost is an IHostedLifecycleService: StoppingAsync stops pulling and starts draining; queued messages are abandoned with no delay; handlers run under their own token and are cancelled only when ShutdownTimeout is up; one deadline covers the whole stop (CR-11). ReceiveEndpoint disposal is idempotent. - InboxRetention defaults to 14 days and is checked against the transport's MaxRetention: fatal in Validate, warning 1405 otherwise (CR-12). - A delayed retry longer than MaxDelay goes through the outbox (doc 04 9.2): the message is re-sent to the endpoint with deliver_at and the new sfattempt extension (MessageEnvelope.Attempts), and attempts are counted across re-sends. On ordered endpoints the delay is capped and logged (1404) (CR-13). - SourceFlowTestHost runs the hosted lifecycle hooks in the generic host's order; TCK-01 round-trips sfattempt. Tests: UT-RX-26, UT-RX-27, UT-RT-26.
…hes and renews its lease - Service Bus: a failed settlement, or a receive that fails partway, forgets the delivery, releases its session hold and closes the session so the broker hands it out again; a message without a session is abandoned. Only sessions with deliveries in flight have their locks renewed (CR-09). - SQS and Pub/Sub: a failure partway through a receive makes everything that receive took and has not settled visible again, and forgets it (CR-42). - Outbox relay: a claim's rows are sent with one batch call per destination (claims hold one head per key, so per-key order is kept); a partial batch fails only the rows it names; a drain renews its partition lease every third of LeaseTtl and stops if the lease lapsed (CR-43). - Ordered endpoints: a key's buffered messages behind a head that waits for a delayed retry are released with the head's delay, so no broker can hand them out first (LocalStack did, with a zero delay). - Conformance kit: TCK-46 (ordered retry through the core), TCK-47 (a failed settlement recovers without a restart), TCK-48 (a delay longer than MaxDelay is honoured through the outbox), TCK-49 (Validate creates nothing). The in-memory, LocalStack and Service Bus emulator fixtures pass. Tests: UT-OUT-19..20, TCK-46..49; UT-OUT-06's fake reports a partial batch.
… version; ES-R1 enforced - Fencing (CR-14): every fenced statement locks the lease row until it commits, FOR SHARE on PostgreSQL and UPDLOCK, HOLDLOCK on SQL Server, whose fenced outbox statements now run in a transaction of their own. A takeover waits for a paused former owner, so it can never commit after the lease changed hands. Doc 05 7.3's SQL is corrected. - SQL Server single-document upsert (CR-15): update if newer, else insert, and on a duplicate key update again if newer. No lost update between two writers of a new document, and no key-range deadlock (MERGE with HOLDLOCK deadlocked them). - Subscriptions (CR-29): process managers and handlers hold a partition at a transiently failing event and retry on the DelayedRetries schedule before parking; a parked event's dead-letter id is derived from consumer and event, so a crash before the checkpoint re-parks the same dead letter (new fault point subscription.afterParkBeforeCheckpoint). - ES-R1 (CR-50): an append after FlushAsync or raw Connection/Transaction access is refused, and the raw getters throw while an append is queued and unsent. SCK-63 now flushes before its custom SQL. - UT-OUT-08 publishes an event so the relay has run before it checks the lease (it raced under load). Tests: SCK-79..81 (in-memory, PostgreSQL, SQL Server), UT-SUB-29..30.
… backing has one source - Ids (CR-16): IStronglyTypedId gains IsValid. Int64 ids must be positive and string ids may not contain a dash, whitespace or control character. A send with an invalid target returns Rejected (sourceflow.invalid_command); ToStreamSegment(), the generated JSON converter and StreamId.For refuse such ids, so they are never stored. - Fingerprints (CR-17): the fingerprint covers the schema's structure only; the root title (CLR name), enum CLR names and upcastsTo are annotations, so renaming a type or adding an upcast version keeps a published fingerprint. Fingerprints registered under the earlier rule are re-registered once at startup when the stored structure is unchanged (ISchemaStore.ReplaceAsync, on every store). ADR-029 is amended. - Backing types (CR-30): generated ids expose a static Backing, and their converters implement IStronglyTypedIdConverter; the schema catalog and the SFQL catalog both read it (IdBackings.Of), so an Int64 id is an integer in both. SF0022 flags a [StronglyTypedId(Backing)] that disagrees with Value. Tests: GEN-66..68, UT-CAT-19..22, E2E-34; UT-CAT-04 uses a structural change.
…ents already applied A document fed by many streams has no stream version to guard it, so a repartition or replay that starts at an earlier checkpoint counted events twice (CR-31). It now records the global position of the last event applied and skips events at or below it. - StoredDocument.Position and an IDocumentSession.Upsert overload that writes it (a store without positions falls back to the version guard). - documents.position_commit and position_seq: PostgreSQL V008, SQL Server V003; the in-memory store keeps them too. - Every document projection is now guarded (stream version or position), so projection repartition keeps exempting them all from --idempotent. Tests: UT-PRJ-13; migration version lists updated.
… node must match it The partition count was one global option, not stored, so two nodes with different counts read different buckets for the same partition and could both handle an event (CR-18). - subscription_partitions (PostgreSQL V009, SQL Server V004, in memory): the first node to run a subscription claims its configured count. - A node configured otherwise refuses that subscription: it holds none of its leases, doesn't wait on it when checking it has caught up, and reports sourceflow.subscription.partition_mismatch (log event 1306). The count is rechecked every LeaseTtl. - Projections(p => p.Add<T>().Partitions(n)) overrides the count per projection; SubscriptionPartitions applies only to subscriptions without a stored count. - projection repartition writes the new count and every checkpoint in one transaction (IStorageSession.SetPartitions). - The monitor, query consistency check and skip use each subscription's own count. The dashboard has a panel for the new gauge. Tests: UT-SUB-31..32, SCK-82, E2E-35; migration and table lists updated.
…ivot is a point of no return
Timers (CR-19):
- A compensation's timers have their own identity (kind compensate-timeout,
step compensate:{step}), so a cancelled step timeout delivered late no
longer ends the compensation early (doc 15 5.1: release-stock gets its own
15-minute timeout).
- WorkflowTimer carries its due time; a delivered timer counts only if its
identity and due time match the pending timer. Timers scheduled before
this change match by identity.
- WorkflowSpec keeps every scheduled timer (Timers) and can fire a specific,
stale one (FireTimer(kind, step, attempt)).
Pivot (CR-20):
- The engine records PivotPassed. A later 'then: fail' goes to
ManualIntervention instead of compensating; an operator abort with
compensation still compensates, recorded as an audit effect; a resume to
a step before the pivot is ignored.
- WF-V17: a next or goto from a step at or after the pivot back before it
is an error.
Tests: UT-WF-77..79, WF-GOLD-31, WF-DIFF-06.
…ored Rejections (CR-32): - The generated workflow handles CommandRejected<T> for every command it awaits, declared or not (an undeclared one goes to ManualIntervention), and for every compensation command (a rejected compensation is a failed attempt). Each needs JSON metadata in the service's context; the fixtures and the TravelBooking sample add theirs. - WF-V18 (warning): a compensation with 'timeout: none' could stay Compensating for ever. Late replies (CR-33): - ReactionContext.CausationId carries the handled envelope's causation; for a rejection reply it is the rejected command's id. - The engine compares it with the current attempt's deterministic id (WorkflowIds.Send, or WorkflowIds.Compensation while compensating) and ignores a reply to an earlier attempt. - WorkflowSpec rejections carry their causation as in production; RejectAt(sentIndex, code) rejects an earlier send. Tests: UT-PM-19..20; rule ids include WF-V18.
The workflow records a send before the relay delivers it, so the outage could end first: the first charge then reached payments and its rejection, now a late reply to attempt 1, was ignored. The scenario waits until payments has refused the charge before bringing it back.
…pecs on the runner
CR-34: a process manager that has never run starts at the head of the log.
Every node sets its checkpoints to the safe horizon at startup, before it
receives or sends anything (ICheckpointStore.InitializeAsync, insert-if-none,
log 1307), so a new workflow or version starts no instances for past events.
ProcessManager<T>(p => p.StartFrom(SubscriptionStart.Beginning)) opts out.
Starting an instance writes a completed workflow-claim:{name} state with
expected version 0, so a v1 node and a v2 node can't both start one.
CR-35: one CorrelationPath helper reads start.correlate for the reader,
validator, simulator, path explorer, spec generator and source generator.
The start message is read along the whole path (the generated TryCorrelate
reads m.Customer?.OrderId); awaited events carry the instance key. The
manifest lists the members of nested object fields, and from, capture and
guard paths are typed through them.
CR-44: ProcessManagerSpec and WorkflowSpec run every message through the
process-manager runner over in-memory storage: TryCorrelate and the envelope
correlation, the start and completed rules, and the state read back from its
JSON. ProcessManagerSpec is created with For<TProcess, TId, TModule>() and
WithModule<T>(); a workflow spec runs its own version only, and commands
owned elsewhere go to a stand-in endpoint.
Tests: UT-PM-21, UT-WF-80, GEN-80, SCK-83, E2E-36, UT-TST-21.
…alike, and run read-only CR-21: a store's SQL engine runs every event and read-model query; one it can't express is refused with SFQ0410 instead of running in the interpreter over the whole log. Only aggregate folds and schema rows (BoundQuery.RequiresInterpreter, the rule PostgreSQL and SQL Server now share) go to the interpreter, time-boxed to the engine's QueryTimeout and capped at QueryPolicySettings.MaxInterpretedRows (SFQ0407). CR-22: SQL Server LIKE has ESCAPE N'\' and escapes '[', so patterns match as in the interpreter and PostgreSQL. Text =, <>, IN, join keys, GROUP BY and DISTINCT also compare the byte length, so trailing-space padding no longer makes 'a' equal 'a '. CR-23: PostgreSQL queries run on QueryConnectionString in a read-only transaction, and db script --query-role prints SELECT-only grants. SQL Server queries always use ApplicationIntent=ReadOnly (a QueryConnectionString without it is refused), and SqlServerSchemaMigrator.QueryGrantsScript grants SELECT only. Tests: QRY-63..65; QRY-36 now expects SFQ0410.
… rest is validated CR-24: AWS CreateIfMissing merges its sourceflow-sns-to-sqs statement into the queue's existing policy by Sid, keeping every other statement (a cross-account grant for example), as doc 07 §5 says existing resources are never changed. CR-41: AwsTransportOptions.RequireEncryption (with an optional KmsKeyId) makes Validate report queues without SSE and topics without a KMS key, and CreateIfMissing create them encrypted; GcpTransportOptions.KmsKeyName does the same for Pub/Sub topics (CMEK). The new problem kind is Unencrypted. Azure is amended in doc 07 §5 and ADR-017: a namespace's customer-managed key is visible only through Azure Resource Manager, so it is required at deployment. Tests: UT-AWS-35, UT-AWS-36, UT-GCP-26.
…dleware stage runs WP-C.14 (CR-39, CR-45): every in-process retry goes through a Polly v8 ResiliencePipeline (Polly.Core 8.7), named by SourceFlowResilience: concurrency (the re-decide, exponential with jitter, 5-50 ms per ADR-008), immediate (receive and subscriptions), outbox (a circuit breaker per destination: after 20 transient failures in a row it leaves the destination alone for 15 s, and rows wait without spending attempts, security review F-07) and ingest (the dead-letter ingestor's polls). Stored retries (an outbox row's next attempt, a stalled subscription) use one Backoff function. The six hand-written policies are gone; sf.Resilience(r => r.Configure(name, b => ...)) adds strategies inside SourceFlow's own. ARCH-10 checks that no exponent, jitter or retry delay exists outside the engine. WP-C.15 (CR-46): the Handle stage runs inside the command processor, for commands sent here and commands received from other services; Receive middleware sees the deserialised message (a built-in step after payload protection); the outbox relay runs the Publish stage before each broker call (middleware may change the envelope or drop the message); the subscription engine runs the Project stage around each applied event, with the session; the log scope wraps every stage. Publish and Project run only when middleware is registered for them. Tests: UT-RES-01..06, ARCH-10, UT-MW-21..27.
…d costs nothing unobserved CR-47: the four standard instruments carry messaging.system and messaging.destination.name: messaging.client.operation.duration is new (the relay records each broker call, with messaging.operation.name), failed sends are counted with error.type, and consumed.messages, process.duration and the process span add the system and the endpoint. Span names are built only when a listener is attached (SourceFlowTelemetry.Start), and the handle span and sourceflow.command.type use the logical message name. Log event ids follow doc 08 §4's ranges: store 20xx, transport 30xx/31xx, subscriptions 40xx, security 50xx; the Observability guide's table lists every id. Tests: UT-HC-11 (required attributes per instrument and on the process span), UT-HC-16 (no allocation without a listener).
… each
CR-51: SF0004 reports I/O in a When (System.IO, System.Net, System.Data,
EF Core, the console), a collection reachable from 'this' changed through a
method call, and both inside lambdas and local functions; SF0024 warns on
mutable collections in aggregate state.
CR-52: SF0025 reports a Decide for a command that targets another aggregate,
and the model builder refuses one at startup.
CR-53: DecisionContext and ReactionContext get NewId<TId>(purpose), derived
from the command or message id, so a retry creates the same id; SF0009 flags
Guid.CreateVersion7() and a generated Id.New() in Decide, When and React, and
New() is documented as non-deterministic.
CR-54: the generator, the analyzers and the manifest share one rule for the
command target and one for the {name}.rejected name (Conventions).
CR-56: AddMessage refuses a name or version the type's [MessageType] doesn't
declare; SF0023 reports an upcaster without a public parameterless
constructor; generated ids implement IUtf8SpanFormattable.
CR-57: doc 03 §9 says SF0012 is not built.
Also: UT-SUB-31 waits for the first node's partition claim instead of for
idle, which could come first. The PostgreSQL round-trip count ignores the
driver's own pg_catalog type lookups and names the statements it saw.
Tests: GEN-69..77.
…y a publish CR-58: ARCH-01 is an explicit allow-list checked against the core's restore graph (project.assets.json); ARCH-03 allows each adapter its own SDK only; ARCH-06 checks that every AOT-marked runtime package is published by an AotCheck fixture that CI runs. The new Cloud.AotCheck fixture publishes the AWS and Azure adapters. A trimmed publish found that the AWS policy merge re-parented a single-object Statement into a JsonArray (which would throw) through the generic JsonArray.Add<T>; both are fixed. The Google Cloud SDK warns inside itself when trimmed (Newtonsoft.Json, Gax reflection, System.Management), so SourceFlow.Cloud.Gcp is no longer AOT-marked; the waiver is in plan 09 IR-08. CR-59: ADR-027 is amended: SourceFlow.Runtime is public SPI. CR-60: a second UseStorage, UseTransport or UseKeyProvider throws (the test host's in-memory defaults are replaced once); OnFailure on an Inline projection is refused; a key provider nothing uses is logged (5002). The query API validates its options at registration and takes the tenant from ITenantResolver, as commands do: AddSourceFlowQueryApi registers ClaimsTenantResolver unless the application has its own. Also: the service records its outbox partition count at start (as $outbox, next to the subscription counts) and the CLI reads it (--outbox-partitions overrides, 16 only when none is recorded); SQL Server Script() batches are guarded (:on error exit, NOEXEC after a rolled-back batch); ICollectionAliases.RequestAsync is a compare-and-set returning bool, and the CLI stops when the alias moved; ADR-011 and doc 04 match the CloudEvents mapping (the version in type, sfext, sfheaders). Tests: ARCH-06, UT-HOST-21..25, UT-OUT-21, UT-ASP-43..44, UT-CLI-37, UT-AWS-37; SCK-M04 and the alias conformance check updated. The design-time test configures only its fault-injecting slots, and the partition-count scenario ignores the $outbox row.
scorecard-action v2.4.0 pulls its image from gcr.io, which now refuses the pull, so the v3-scorecard job failed on every push. v2.4.1 and later publish the image on ghcr.io; move to v2.5.0.
scorecard-action refuses a push to any branch but the default one, whatever publish_results says, so the v3.0.0 push trigger could never pass. Scorecard now runs on pull requests into master (v3.0.0 among them), on pushes to master and weekly, and publishes from master only; a manual run from another branch is skipped rather than failed. GitHub-Actions-Setup says when it runs.
- studio/ -> web/ (the TypeScript side of Studio); the action moves from studio/action to web/actions/workflow-diff. The static-site CLI stays in web/app/bin and still ships in @sourceflow/studio. - tests/workflow-golden -> tests/Golden. - benchmarks/, fuzz/, loadtest/ -> quality/. - tools/CoverageGate -> eng/CoverageGate; .github/emulators -> eng/emulators (the v2 .github/gcp-emulator stays for GCP-Build.yml). - docs/v3.0.0: Documentation/ -> reference/ and guides/ -> reference/guides/ (user-facing); ADRs/, Design/ and implementation/ -> engineering/ (team-facing). Every path reference follows: the solution, project references, the workflows (paths filters, working directories, compose files, the workflow-diff uses:), the npm workspace and lock file, the Studio Dockerfile, test fixtures, analyzer help links and relative links across the docs. The tool's embedded resource names are unchanged. Plan 02 §3 and plan 10 §1 show the new layout.
tests/Fixtures/OrderFulfilment moves to samples/OrderFulfilment (the domain, workflow, manifests and generated specs unchanged) and becomes user-facing next to TravelBooking: - The host keeps one process per service (Service=orders|inventory| payments|shipping) and gains what TravelBooking's hosts have, in ServiceHost.cs: the full health checks (/health/sourceflow), SourceFlow:Provisioning, the demo query API (orders.workflow-instances among the named queries) and OTLP export. - Dockerfile: one image for the four services; Studio.Dockerfile: the read-only Studio site of the workspace. - docker-compose.yml: PostgreSQL, LocalStack, the four services, Studio and the Aspire dashboard, on ports apart from TravelBooking's (8090-8093, 5090, 18890, 55433, 4567) so both demos run at once. - v3-images.yml publishes sourceflow-order-fulfilment and sourceflow-order-studio. - README walks through the outcomes: delivered, out of stock, declined, fraud, a large order approved or rejected, an address corrected after the point of no return, and the operator's CLI. The E2E, NextRelease, Studio and Playwright tests and the manifest drift check use the new path; the docs call it a sample. The solution folders for quality/ and eng/ are named after the re-layout.
guides/using-studio.md tours Studio on the OrderFulfilment sample, with TravelBooking as a second workspace: opening a workspace (compose site or local host), the shell, the domain map, reading the statechart, the swimlane, simulating instances (a delivery, a declined card retried, an unreviewed large order aborted with compensation, forward recovery after the pivot, plan and run), paths and the minimal cover, spec generation, editing (WF-V15 and a new version, diagnostics, the palette, layout and save), exports and static sites, and how the simulated paths map to the running services. Numbers, labels and diagnostics are taken from the core and the app. Linked from the reference index, the Studio README, the workflows guide, both sample READMEs and the changelog. Also: `cd web` (not `cd studio`) in the Studio README and GitHub Actions setup, and WF-V17 in the rule table.
|
You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool. What Enabling Code Scanning Means:
For more information about GitHub Code Scanning, check out the documentation. |
|
|
||
| /// <summary>The connection string queries use: <see cref="QueryConnectionString"/>, or the read-intent form of <see cref="ConnectionString"/>.</summary> | ||
| internal string QueryConnection => QueryConnectionString | ||
| ?? new Microsoft.Data.SqlClient.SqlConnectionStringBuilder(ConnectionString) { ApplicationIntent = Microsoft.Data.SqlClient.ApplicationIntent.ReadOnly }.ConnectionString; |
| } | ||
|
|
||
| if (QueryConnectionString is { } query | ||
| && new Microsoft.Data.SqlClient.SqlConnectionStringBuilder(query).ApplicationIntent != Microsoft.Data.SqlClient.ApplicationIntent.ReadOnly) |
There was a problem hiding this comment.
Scorecard found more than 20 potential problems in the proposed changes. Check the Files changed tab for more details.
|
|
||
| return true; | ||
| case IConditionalOperation conditional: | ||
| return Events(conditional.WhenTrue, emits) & (conditional.WhenFalse is null || Events(conditional.WhenFalse, emits)); |
| return Codes(conditional.WhenTrue, rejects, compilation, depth, cancellationToken) | ||
| & (conditional.WhenFalse is null || Codes(conditional.WhenFalse, rejects, compilation, depth, cancellationToken)); |
| { | ||
| } |
| { | ||
| } |
| return Participates(projection) | ||
| && Aliases.TryGetValue(projection.Name, out CollectionAlias? alias) | ||
| && ReadModelGeneration.TryParse(alias.Target, out ReadModelGeneration? target) | ||
| ? target.Value |
| return (first, null); | ||
| } | ||
|
|
||
| ReadModelGeneration target = parsed.Value; |
|
|
||
| ReadModelGeneration target = parsed.Value; | ||
| ReadModelGeneration? requested = ReadModelGeneration.TryParse(alias.Building, out ReadModelGeneration? b) | ||
| && b.Value.Version == projection.Version && b.Value.IsNewerThan(target) |
| } | ||
|
|
||
| await using IStorageSession session = await _runtime.Storage.Sessions.BeginAsync(_runtime.Options.DefaultTenant, cancellationToken).ConfigureAwait(false); | ||
| await store.DropGenerationAsync(generation.Value, session, cancellationToken).ConfigureAwait(false); |
| public static ReadModelGeneration Parse(string collection) | ||
| { | ||
| return TryParse(collection, out ReadModelGeneration? generation) | ||
| ? generation.Value |
| } | ||
|
|
||
| CollectionAlias? alias = (await aliases.ListAliasesAsync(ct)).FirstOrDefault(a => a.Alias == requested.Value.Name); | ||
| ReadModelGeneration serving = alias is null ? requested.Value : ReadModelGeneration.Parse(alias.Target); |
There was a problem hiding this comment.
🟡 Changes recommended
The size test counts stale fingerprinted .br files rather than only those shipped by the active loader, causing false bundle-budget failures.
1 open issue
What changed in this PR
This PR replaces SourceFlow.Net v2’s command-replay model with an event-sourced .NET 10 architecture. It reorganizes the codebase around the new runtime, persistence adapters, cloud transports, and Studio workflow tooling.
Changes:
- Introduces v3 project wiring, storage migrations, generated registration, and deployment configuration.
- Adds Studio’s web tooling, workflow fixtures, and shared testing infrastructure.
- Removes legacy v2 APIs and tests, and adds sample applications and architecture documentation.
| File | Description |
|---|---|
| web/package.json | Defines Studio workspaces and shared scripts. |
| web/core-client/vitest.config.ts | Configures WebAssembly client tests. |
| web/core-client/tsconfig.json | Enables strict client type checking. |
| web/core-client/test/size.test.ts | Enforces the compressed WebAssembly size budget. |
| web/core-client/test/node-worker.mjs | Hosts the core in Node worker tests. |
| web/core-client/src/worker.ts | Hosts the core in browser workers. |
| web/core-client/src/index.ts | Exposes the typed browser client. |
| web/core-client/src/generated/exports.d.ts | Declares generated WebAssembly exports. |
| web/core-client/package.json | Defines client exports and build scripts. |
| web/app/vitest.config.ts | Configures Studio component tests. |
| web/app/tsconfig.json | Configures application type checking. |
| web/app/src/views/Legend.tsx | Explains workflow graph symbols. |
| web/app/src/routes/NotFound.tsx | Adds workspace not-found navigation. |
| web/app/src/components/ThemeSwitch.tsx | Adds theme selection controls. |
| web/app/src/components/KeyboardMap.tsx | Displays keyboard shortcuts. |
| web/app/index.html | Adds the Studio application shell. |
| web/app/e2e/workspace/sourceflow.domain.yaml | Defines the browser-test workspace. |
| web/app/e2e/workspace/orders/workflows/unknown-type.sfflow.yaml | Adds an invalid-message test fixture. |
| web/actions/workflow-diff/vitest.config.ts | Configures workflow-diff integration tests. |
| web/actions/workflow-diff/vite.config.ts | Configures the bundled action build. |
| web/actions/workflow-diff/tsconfig.json | Enables strict action type checking. |
| web/actions/workflow-diff/scripts/bundle-framework.mjs | Copies active WebAssembly runtime files. |
| web/actions/workflow-diff/package.json | Defines action dependencies and scripts. |
| web/actions/workflow-diff/action.yml | Declares workflow-diff action inputs and outputs. |
| web/.gitignore | Excludes web build artifacts. |
| tests/Workflows/SourceFlow.Studio.Tests/SourceFlow.Studio.Tests.csproj | Wires Studio and workflow tests. |
| tests/Tooling/SourceFlow.Tooling.Tests/SourceFlow.Tooling.Tests.csproj | Wires CLI and testing-toolkit tests. |
| tests/Storage/SourceFlow.Storage.Tests/PostgreSql/RealClock.cs | Supports external-clock integration tests. |
| tests/SourceFlow.Stores.EntityFramework.Tests/TestModels/TestModels.cs | Removes legacy storage test models. |
| tests/SourceFlow.Stores.EntityFramework.Tests/SourceFlow.Stores.EntityFramework.Tests.csproj | Removes the v2 storage test project. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Projections/AccountViewModel.cs | Removes a legacy projection fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Events/AccountUpdated.cs | Removes a legacy account event fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Events/AccountCreated.cs | Removes a legacy creation event fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Commands/WithdrawMoney.cs | Removes a legacy withdrawal fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Commands/Payload.cs | Removes legacy command payload fixtures. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Commands/DepositMoney.cs | Removes a legacy deposit fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Commands/CreateAccount.cs | Removes a legacy account-creation fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Commands/CloseAccount.cs | Removes a legacy account-closure fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Commands/ActivateAccount.cs | Removes a legacy activation fixture. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Aggregates/TransactionType.cs | Removes a legacy transaction enum. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Aggregates/IAccountAggregate.cs | Removes a legacy aggregate contract. |
| tests/SourceFlow.Stores.EntityFramework.Tests/E2E/Aggregates/BankAccount.cs | Removes a legacy account entity. |
| tests/SourceFlow.Core.Tests/SourceFlow.Core.Tests.csproj | Removes the v2 core test project. |
| tests/SourceFlow.Core.Tests/Messaging/MetadataTests.cs | Removes legacy metadata tests. |
| tests/SourceFlow.Core.Tests/Messaging/EventTests.cs | Removes legacy event tests. |
| tests/SourceFlow.Core.Tests/Messaging/CommandTests.cs | Removes legacy command tests. |
| tests/SourceFlow.Core.Tests/Ioc/DummyCommandStore.cs | Removes a legacy command-store stub. |
| tests/SourceFlow.Core.Tests/Interfaces/IViewModelRepositoryTests.cs | Removes legacy view-store tests. |
| tests/SourceFlow.Core.Tests/Impl/SagaDispatcherTests.cs | Removes legacy saga-dispatch tests. |
| tests/SourceFlow.Core.Tests/Impl/DummyEvent.cs | Removes legacy event test doubles. |
| tests/SourceFlow.Core.Tests/Impl/DummyCommand.cs | Removes legacy command test doubles. |
| tests/SourceFlow.Core.Tests/Impl/AggregateFactoryTests.cs | Removes legacy factory tests. |
| tests/SourceFlow.Core.Tests/E2E/Projections/AccountViewModel.cs | Removes a v2 projection fixture. |
| tests/SourceFlow.Core.Tests/E2E/Impl/InMemoryEventStore.cs | Removes the command-replay store fixture. |
| tests/SourceFlow.Core.Tests/E2E/Impl/InMemoryEntityStore.cs | Removes a legacy entity-store fixture. |
| tests/SourceFlow.Core.Tests/E2E/Events/AccountUpdated.cs | Removes a v2 account-update fixture. |
| tests/SourceFlow.Core.Tests/E2E/Events/AccountCreated.cs | Removes a v2 account-creation fixture. |
| tests/SourceFlow.Core.Tests/E2E/Commands/WithdrawMoney.cs | Removes a v2 withdrawal fixture. |
| tests/SourceFlow.Core.Tests/E2E/Commands/Payload.cs | Removes v2 command payload fixtures. |
| tests/SourceFlow.Core.Tests/E2E/Commands/DepositMoney.cs | Removes a v2 deposit fixture. |
| tests/SourceFlow.Core.Tests/E2E/Commands/CreateAccount.cs | Removes a v2 creation command fixture. |
| tests/SourceFlow.Core.Tests/E2E/Commands/CloseAccount.cs | Removes a v2 closure command fixture. |
| tests/SourceFlow.Core.Tests/E2E/Commands/ActivateAccount.cs | Removes a v2 activation fixture. |
| tests/SourceFlow.Core.Tests/E2E/Aggregates/TransactionType.cs | Removes a v2 transaction enum. |
| tests/SourceFlow.Core.Tests/E2E/Aggregates/IAccountAggregate.cs | Removes a v2 aggregate fixture contract. |
| tests/SourceFlow.Core.Tests/E2E/Aggregates/BankAccount.cs | Removes a v2 account fixture. |
| tests/SourceFlow.Cloud.GCP.Tests/Unit/GcpOptionsTests.cs | Removes legacy Google Cloud options tests. |
| tests/SourceFlow.Cloud.GCP.Tests/TestHelpers/TestMessages.cs | Removes legacy Google Cloud test messages. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/TestEvent.cs | Removes a legacy AWS event fixture. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/TestCommand.cs | Removes a legacy AWS command fixture. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/TestCategories.cs | Removes legacy AWS test categories. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/SnsTestModels.cs | Removes legacy SNS test models. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/LocalStackRequiredTestBase.cs | Removes legacy LocalStack test setup. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/ICloudTestEnvironment.cs | Removes the legacy cloud-test abstraction. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/AwsTestDefaults.cs | Removes legacy AWS test defaults. |
| tests/SourceFlow.Cloud.AWS.Tests/TestHelpers/AwsIntegrationTestCollection.cs | Removes legacy AWS fixture sharing. |
| tests/SourceFlow.Cloud.AWS.Tests/Integration/KmsSecurityAndPerformancePropertyTests.cs | Legacy KMS test change; diff unavailable. |
| tests/SourceFlow.Cloud.AWS.Tests/Integration/KmsKeyRotationIntegrationTests.cs | Legacy KMS rotation test change; diff unavailable. |
| tests/SourceFlow.Cloud.AWS.Tests/Integration/KmsEncryptionIntegrationTests.cs | Legacy KMS encryption test change; diff unavailable. |
| tests/SourceFlow.Cloud.AWS.Tests/Integration/AwsIntegrationTests.cs | Removes legacy AWS configuration tests. |
| tests/Shared/PublicApiApproval.cs | Adds shared public-API snapshot assertions. |
| tests/Hosting/SourceFlow.Hosting.Tests/SourceFlow.Hosting.Tests.csproj | Wires ASP.NET Core endpoint tests. |
| tests/Golden/domain/sourceflow.domain.yaml | Defines the shared commerce test domain. |
| tests/Golden/cases/31-v17-pivot-backward/workflow.sfflow.yaml | Exercises invalid backward recovery after a pivot. |
| tests/Golden/cases/31-v17-pivot-backward/expected.diagnostics.json | Records the pivot-recovery diagnostic. |
| tests/Golden/cases/30-v03-start-not-received/workflow.sfflow.yaml | Exercises an unreachable start message. |
| tests/Golden/cases/30-v03-start-not-received/expected.diagnostics.json | Records the start-subscription diagnostic. |
| tests/Golden/cases/29-s01-anchors/workflow.sfflow.yaml | Exercises prohibited YAML anchors. |
| tests/Golden/cases/29-s01-anchors/expected.diagnostics.json | Records the anchor diagnostic. |
| tests/Golden/cases/28-retries-and-backoff/workflow.sfflow.yaml | Exercises retries and exponential backoff. |
| tests/Golden/cases/28-retries-and-backoff/expected.mmd | Captures retry diagram output. |
| tests/Golden/cases/28-retries-and-backoff/expected.diagnostics.json | Confirms valid retry configuration. |
| tests/Golden/cases/27-local-steps/workflow.sfflow.yaml | Exercises local commands and explicit exemptions. |
| tests/Golden/cases/27-local-steps/expected.paths.txt | Captures local-step execution paths. |
| tests/Golden/cases/27-local-steps/expected.mmd | Captures the local-step statechart. |
| tests/Golden/cases/27-local-steps/expected.diagnostics.json | Confirms valid local-step configuration. |
| tests/Golden/cases/26-guards-and-hooks/expected.diagnostics.json | Confirms valid guards and hooks. |
| tests/Golden/cases/25-v16-nested-compensation/expected.diagnostics.json | Records unsupported compensation diagnostics. |
| tests/Golden/cases/24-v15-published-version/workflow.sfflow.yaml | Exercises published-workflow version protection. |
| tests/Golden/cases/24-v15-published-version/expected.diagnostics.json | Records the required version-bump diagnostic. |
| tests/Golden/cases/23-v14-personal-data/expected.diagnostics.json | Records personal-data classification warnings. |
| tests/Golden/cases/22-v13-guards/expected.diagnostics.json | Records guard parsing and binding errors. |
| tests/Golden/cases/20-v11-goto/expected.diagnostics.json | Records invalid transitions and unreachable steps. |
| tests/Golden/cases/19-v10-retries/expected.diagnostics.json | Records retry-bound and backoff errors. |
| tests/Golden/cases/18-v09-compensation/expected.diagnostics.json | Records missing-compensation warnings. |
| tests/Golden/cases/17-v08-rejections/expected.diagnostics.json | Records rejection-routing errors. |
| tests/Golden/cases/15-v06-timeouts/expected.diagnostics.json | Records timeout requirements. |
| tests/Golden/cases/14-v05-never-completes/workflow.sfflow.yaml | Exercises a workflow without completion. |
| tests/Golden/cases/14-v05-never-completes/expected.diagnostics.json | Records the missing-completion diagnostic. |
| tests/Golden/cases/13-v05-unreachable-step/workflow.sfflow.yaml | Exercises an unreachable step. |
| tests/Golden/cases/13-v05-unreachable-step/expected.diagnostics.json | Records the unreachable-step diagnostic. |
| tests/Golden/cases/12-v04-correlation/workflow.sfflow.yaml | Exercises invalid correlation fields. |
| tests/Golden/cases/12-v04-correlation/expected.diagnostics.json | Records correlation-key diagnostics. |
| tests/Golden/cases/11-v03-unreachable-event/expected.diagnostics.json | Records unavailable-event diagnostics. |
| tests/Golden/cases/10-v02-command-owner/workflow.sfflow.yaml | Exercises command ownership and routing errors. |
| tests/Golden/cases/10-v02-command-owner/expected.diagnostics.json | Records ownership and routing diagnostics. |
| tests/Golden/cases/09-v01-unknown-type/workflow.sfflow.yaml | Exercises unknown and mismatched message types. |
| tests/Golden/cases/09-v01-unknown-type/expected.diagnostics.json | Records message-type diagnostics. |
| tests/Golden/cases/08-s06-format/workflow.sfflow.yaml | Exercises invalid names and message identifiers. |
| tests/Golden/cases/08-s06-format/expected.diagnostics.json | Records format diagnostics. |
| tests/Golden/cases/07-s05-duration/workflow.sfflow.yaml | Exercises unsupported duration formats. |
| tests/Golden/cases/07-s05-duration/expected.diagnostics.json | Records duration diagnostics. |
| tests/Golden/cases/06-s04-schema-version/workflow.sfflow.yaml | Exercises an unsupported DSL version. |
| tests/Golden/cases/06-s04-schema-version/expected.diagnostics.json | Records the schema-version diagnostic. |
| tests/Golden/cases/05-s03-shape/workflow.sfflow.yaml | Exercises invalid workflow structure. |
| tests/Golden/cases/05-s03-shape/expected.diagnostics.json | Records structural validation errors. |
| tests/Golden/cases/04-s02-unknown-keys/workflow.sfflow.yaml | Exercises unsupported workflow keys. |
| tests/Golden/cases/04-s02-unknown-keys/expected.diagnostics.json | Records unknown-key diagnostics. |
| tests/Golden/cases/03-s01-invalid-yaml/workflow.sfflow.yaml | Exercises malformed YAML indentation. |
| tests/Golden/cases/03-s01-invalid-yaml/expected.diagnostics.json | Records the YAML parsing diagnostic. |
| tests/Golden/cases/02-minimal/workflow.sfflow.yaml | Adds a minimal valid workflow. |
| tests/Golden/cases/02-minimal/expected.paths.txt | Captures minimal workflow paths. |
| tests/Golden/cases/02-minimal/expected.mmd | Captures the minimal statechart. |
| tests/Golden/cases/02-minimal/expected.diagnostics.json | Confirms the minimal workflow validates. |
| tests/Golden/cases/01-order-fulfilment/expected.diagnostics.json | Confirms order-fulfilment validation. |
| tests/Golden/.gitattributes | Preserves fixture line endings. |
| tests/Fuzz/SourceFlow.Fuzz.Tests/SourceFlow.Fuzz.Tests.csproj | Wires bounded fuzz regression tests. |
| tests/Fixtures/Directory.Build.props | Configures generated, AOT-compatible fixtures. |
| tests/Fixtures/Cloud.AotCheck/Program.cs | References AWS and Azure for AOT checks. |
| tests/Fixtures/Cloud.AotCheck/Cloud.AotCheck.csproj | Configures conditional native compilation checks. |
| tests/Fixtures/Bank/Bank.Transfers/Bank.Transfers.csproj | Wires the transfer-domain fixture. |
| tests/Fixtures/Bank/Bank.Notifications/Bank.Notifications.csproj | Wires the notification-service fixture. |
| tests/Fixtures/Bank/Bank.Contracts/Bank.Contracts.csproj | Wires shared integration contracts. |
| tests/Fixtures/Bank/Bank.Contracts/AccountContracts.cs | Defines generated integration-event registration. |
| tests/Fixtures/Bank/Bank.Accounts/Bank.Accounts.csproj | Wires the account-domain fixture. |
| tests/EndToEnd/OrderFulfilment.NextRelease/NextRelease.cs | Registers next-release workflow serialization. |
| tests/Core/SourceFlow.Generators.Tests/SourceFlow.Generators.Tests.csproj | Wires generator and analyzer tests. |
| tests/Core/SourceFlow.Core.Tests/SourceFlow.Core.Tests.csproj | Wires v3 core and conformance tests. |
| tests/Core/SourceFlow.Core.Tests/BankModel.cs | Shares a deterministic Bank runtime model. |
| tests/CodeCoverage.settings.xml | Excludes sample and generated coverage sources. |
| tests/Cloud/SourceFlow.Cloud.Tests/SourceFlow.Cloud.Tests.csproj | Wires cross-cloud conformance tests. |
| tests/BannedSymbols.txt | Enforces deterministic test APIs. |
| src/Workflows/SourceFlow.Studio/SourceFlow.Studio.csproj | Defines the Studio core project. |
| src/Workflows/SourceFlow.Studio.Wasm/Program.cs | Adds the WebAssembly entry point. |
| src/Tooling/SourceFlow.Tool/Program.cs | Delegates CLI execution to SourceFlowCli. |
| src/Tooling/SourceFlow.Testing/SourceFlow.Testing.csproj | Defines the public testing toolkit. |
| src/Storage/SourceFlow.Storage.SqlServer/SourceFlow.Storage.SqlServer.csproj | Wires SQL Server storage dependencies. |
| src/Storage/SourceFlow.Storage.SqlServer/Schema/V004__subscription_partitions.sql | Persists subscription partition counts. |
| src/Storage/SourceFlow.Storage.SqlServer/Schema/V003__document_position.sql | Adds cross-stream document positions. |
| src/Storage/SourceFlow.Storage.SqlServer/Schema/V002__data_keys_per_tenant.sql | Scopes encryption keys by tenant. |
| src/Storage/SourceFlow.Storage.PostgreSQL/SourceFlow.Storage.PostgreSQL.csproj | Wires PostgreSQL storage dependencies. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V009__subscription_partitions.sql | Persists subscription partition counts. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V008__document_position.sql | Adds cross-stream document positions. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V007__data_keys_policy.sql | Defines tenant isolation for encryption keys. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V006__data_keys_per_tenant.sql | Scopes encryption keys by tenant. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V005__outbox_first_due.sql | Preserves original outbox due times. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V004__read_model_generations.sql | Tracks read-model rebuild generations. |
| src/Storage/SourceFlow.Storage.PostgreSQL/Schema/V003__commit_assertions.sql | Adds transactional concurrency assertions. |
| src/Storage/SourceFlow.Storage.EntityFrameworkCore/SourceFlow.Storage.EntityFrameworkCore.csproj | Wires transactional EF Core projections. |
| src/SourceFlow/Saga/ISaga.cs | Removes the v2 saga contract. |
| src/SourceFlow/Saga/IHandlesWithEvent.cs | Removes the v2 event-producing handler contract. |
| src/SourceFlow/Saga/IHandles.cs | Removes the v2 command-handler contract. |
| src/SourceFlow/Projections/IViewModel.cs | Removes the v2 view-model contract. |
| src/SourceFlow/Projections/IView.cs | Removes the v2 view contract. |
| src/SourceFlow/Projections/IProjectOn.cs | Removes the v2 projection-handler contract. |
| src/SourceFlow/Messaging/IPayload.cs | Removes the v2 payload marker. |
| src/SourceFlow/Messaging/IName.cs | Removes the v2 message-name contract. |
| src/SourceFlow/Messaging/Events/IEventSubscriber.cs | Removes the v2 event-subscriber contract. |
| src/SourceFlow/Messaging/Events/IEventSubscribeMiddleware.cs | Removes v2 subscription middleware. |
| src/SourceFlow/Messaging/Events/IEventQueue.cs | Removes the v2 event-queue contract. |
| src/SourceFlow/Messaging/Events/IEventDispatchMiddleware.cs | Removes v2 event-dispatch middleware. |
| src/SourceFlow/Messaging/Events/IEventDispatcher.cs | Removes the v2 event-dispatch contract. |
| src/SourceFlow/Messaging/Events/IEvent.cs | Removes the v2 event contract. |
| src/SourceFlow/Messaging/Events/Event.cs | Removes the v2 entity-payload event base. |
| src/SourceFlow/Messaging/Commands/ICommandSubscriber.cs | Removes the v2 command-subscriber contract. |
| src/SourceFlow/Messaging/Commands/ICommandSubscribeMiddleware.cs | Removes v2 command-subscription middleware. |
| src/SourceFlow/Messaging/Commands/ICommandPublisher.cs | Removes the v2 replaying publisher contract. |
| src/SourceFlow/Messaging/Commands/ICommandDispatcher.cs | Removes the v2 command-dispatch contract. |
| src/SourceFlow/Messaging/Commands/ICommand.cs | Removes v2 commands and entity references. |
| src/SourceFlow/Messaging/Commands/CommandData.cs | Removes the serialized-command storage model. |
| src/SourceFlow/Messaging/Bus/ICommandDispatchMiddleware.cs | Removes v2 bus-dispatch middleware. |
| src/SourceFlow/Messaging/Bus/ICommandBus.cs | Removes the v2 command-replay bus. |
| src/SourceFlow/IViewModelStoreAdapter.cs | Removes the v2 view-store adapter contract. |
| src/SourceFlow/IViewModelStore.cs | Removes the v2 view-store contract. |
| src/SourceFlow/Impl/AggregateFactory.cs | Removes the v2 aggregate factory. |
| src/SourceFlow/IEntityStoreAdapter.cs | Removes the v2 entity-store adapter contract. |
| src/SourceFlow/IEntityStore.cs | Removes the v2 entity-store contract. |
| src/SourceFlow/IEntity.cs | Removes the v2 entity marker. |
| src/SourceFlow/ICommandStoreAdapter.cs | Removes the v2 command-store adapter contract. |
| src/SourceFlow/ICommandStore.cs | Removes the v2 command-store contract. |
| src/SourceFlow/Cloud/Security/MessageDecryptionException.cs | Removes the legacy decryption exception. |
| src/SourceFlow/Cloud/Security/IMessageEncryption.cs | Removes the legacy encryption contract. |
| src/SourceFlow/Cloud/Security/EncryptionOptions.cs | Removes legacy encryption settings. |
| src/SourceFlow/Cloud/Resilience/CircuitState.cs | Removes the legacy circuit-state enum. |
| src/SourceFlow/Cloud/Resilience/CircuitBreakerStateChangedEventArgs.cs | Removes legacy circuit-change events. |
| src/SourceFlow/Cloud/Resilience/CircuitBreakerOptions.cs | Removes legacy circuit-breaker settings. |
| src/SourceFlow/Cloud/Resilience/CircuitBreakerOpenException.cs | Removes the legacy circuit exception. |
| src/SourceFlow/Cloud/Configuration/InMemoryIdempotencyCleanupService.cs | Removes legacy idempotency cleanup hosting. |
| src/SourceFlow/Cloud/Configuration/IIdempotencyService.cs | Removes legacy idempotency service contracts. |
| src/SourceFlow/Cloud/Configuration/IEventRoutingConfiguration.cs | Removes legacy event-routing configuration. |
| src/SourceFlow/Cloud/Configuration/ICommandRoutingConfiguration.cs | Removes legacy command-routing configuration. |
| src/SourceFlow/Cloud/Configuration/IBusBootstrapConfiguration.cs | Removes legacy bus bootstrap configuration. |
| src/SourceFlow/Aggregate/ISubscribes.cs | Removes the v2 aggregate subscription contract. |
| src/SourceFlow/Aggregate/IAggregateFactory.cs | Removes the v2 aggregate factory contract. |
| src/SourceFlow/Aggregate/IAggregate.cs | Removes the v2 aggregate marker. |
| src/SourceFlow.Stores.EntityFramework/Models/IdempotencyRecord.cs | Removes the legacy idempotency entity. |
| src/SourceFlow.Stores.EntityFramework/Models/CommandRecord.cs | Removes legacy command persistence models. |
| src/SourceFlow.Stores.EntityFramework/IdempotencyDbContext.cs | Removes the legacy idempotency context. |
| src/SourceFlow.Cloud.GCP/Observability/GcpTelemetryExtensions.cs | Removes legacy Google Cloud metrics. |
| src/SourceFlow.Cloud.GCP/Infrastructure/PubSubClientFactory.cs | Removes legacy Pub/Sub client creation. |
| src/SourceFlow.Cloud.GCP/Infrastructure/GcpHealthCheck.cs | Removes the legacy Pub/Sub health check. |
| src/SourceFlow.Cloud.AWS/Observability/AwsTelemetryExtensions.cs | Removes legacy AWS metrics. |
| src/SourceFlow.Cloud.AWS/Messaging/Serialization/JsonMessageSerializer.cs | Removes legacy reflection-based JSON helpers. |
| src/SourceFlow.Cloud.AWS/Messaging/Events/SnsNotificationModels.cs | Removes legacy SNS envelope models. |
| src/SourceFlow.Cloud.AWS/Management/_placeholder.cs | Removes an unused namespace placeholder. |
| src/SourceFlow.Cloud.AWS/Infrastructure/SqsClientFactory.cs | Removes legacy SQS client creation. |
| src/SourceFlow.Cloud.AWS/Infrastructure/SnsClientFactory.cs | Removes legacy SNS client creation. |
| src/SourceFlow.Cloud.AWS/GlobalUsings.cs | Removes old framework compatibility imports. |
| src/SourceFlow.Cloud.AWS/Configuration/AwsOptions.cs | Removes legacy AWS configuration. |
| src/SourceFlow.Cloud.AWS/Attributes/_placeholder.cs | Removes an unused routing placeholder. |
| src/Hosting/SourceFlow.AspNetCore/SourceFlow.AspNetCore.csproj | Defines ASP.NET Core integration dependencies. |
| src/Core/SourceFlow.Net/Storage/ProjectionUnitOfWork.cs | Defines transactional projection lifecycle hooks. |
| src/Core/SourceFlow.Net/Domain/Taxonomy.cs | Defines personal-data and secret classifications. |
| src/Core/SourceFlow.Net/build/SourceFlow.Net.props | Supplies workflow files to the generator. |
| src/Core/SourceFlow.Generators/AnalyzerReleases.Shipped.md | Initializes analyzer release tracking. |
| src/Cloud/SourceFlow.Cloud.Gcp/SourceFlow.Cloud.Gcp.csproj | Wires Pub/Sub and Cloud KMS dependencies. |
| src/Cloud/SourceFlow.Cloud.Azure/SourceFlow.Cloud.Azure.csproj | Wires Service Bus and Key Vault dependencies. |
| src/Cloud/SourceFlow.Cloud.Aws/SourceFlow.Cloud.Aws.csproj | Wires SNS, SQS, and KMS dependencies. |
| src/BannedSymbols.txt | Restricts reflection and nondeterministic APIs. |
| samples/TravelBooking/sourceflow.domain.yaml | Defines the TravelBooking Studio workspace. |
| samples/TravelBooking/Hotels/Hotels.csproj | Configures the Hotels domain module. |
| samples/TravelBooking/Hotels.Api/Hotels.Api.csproj | Wires the Hotels service host. |
| samples/TravelBooking/Hotels.Api/appsettings.json | Sets Hotels demo defaults. |
| samples/TravelBooking/Bookings/Bookings.csproj | Configures generated booking workflows. |
| samples/TravelBooking/Bookings.Api/Bookings.Api.csproj | Wires the Bookings service host. |
| samples/TravelBooking/Bookings.Api/appsettings.json | Sets Bookings demo defaults. |
| samples/OrderFulfilment/sourceflow.domain.yaml | Defines the commerce Studio workspace. |
| samples/OrderFulfilment/Shipping/Shipping.csproj | Configures the Shipping domain module. |
| samples/OrderFulfilment/Payments/Payments.csproj | Configures the Payments domain module. |
| samples/OrderFulfilment/Orders/Orders.csproj | Wires generated order workflows and contracts. |
| samples/OrderFulfilment/OrderFulfilment.Host/appsettings.json | Sets commerce demo defaults. |
| samples/OrderFulfilment/Inventory/Inventory.csproj | Configures the Inventory domain module. |
| samples/Directory.Build.props | Enables generated, AOT-compatible sample code. |
| renovate.json | Groups dependency updates for v3. |
| global.json | Selects .NET 10 and the test runner. |
| GitVersion.yml | Defines v3 prerelease versioning. |
| eng/emulators/servicebus/docker-compose.yml | Adds the Service Bus emulator stack. |
| eng/emulators/servicebus/Config.json | Defines the emulator namespace. |
| eng/emulators/pubsub/docker-compose.yml | Adds the Pub/Sub emulator stack. |
| eng/emulators/localstack/docker-compose.yml | Adds the AWS emulator stack. |
| eng/CoverageGate/CoverageGate.csproj | Defines the coverage-gate executable. |
| docs/v3.0.0/engineering/implementation/forward-port-log.md | Adds a v2-to-v3 fix-assessment log. |
| docs/v3.0.0/engineering/ADRs/ADR-019-telemetry-always-on-with-standard-semantic-conventions.md | Documents always-on telemetry conventions. |
| docs/v3.0.0/engineering/ADRs/ADR-018-business-rejections-are-values-not-exceptions.md | Documents value-based business rejections. |
| docs/v3.0.0/engineering/ADRs/ADR-016-projections-inline-or-async-with-partitioned-fenced.md | Documents durable projection processing. |
| docs/v3.0.0/engineering/ADRs/ADR-009-event-store-on-adonet-postgresql-first.md | Documents SQL-based event persistence. |
| docs/v3.0.0/engineering/ADRs/ADR-005-logical-message-type-names-and-registry.md | Documents stable message names and registration. |
| docker-compose.yml | Exposes TravelBooking as the root demo. |
| Directory.Build.targets | Wires generators into repository consumers. |
| deploy/topology/terraform/gcp/variables.tf | Defines Google Cloud topology inputs. |
| deploy/topology/terraform/gcp/outputs.tf | Exposes Pub/Sub resource identifiers. |
| deploy/topology/terraform/azure/variables.tf | Defines Azure topology inputs. |
| deploy/topology/terraform/azure/outputs.tf | Exposes Service Bus resource identifiers. |
| deploy/topology/terraform/aws/variables.tf | Defines AWS topology inputs. |
| deploy/topology/terraform/aws/outputs.tf | Exposes AWS resources and runtime permissions. |
| deploy/topology/fixtures/in-memory/publisher.json | Captures an in-memory publisher topology. |
| deploy/topology/fixtures/in-memory/minimal.json | Captures a minimal in-memory topology. |
| deploy/topology/fixtures/azure/minimal.json | Captures a minimal Service Bus topology. |
| deploy/topology/fixtures/aws/minimal.json | Captures a minimal SQS topology. |
| deploy/topology/.gitignore | Excludes Terraform state and local artifacts. |
| deploy/dast/zap-rules.tsv | Configures an informational scanner exception. |
| .github/workflows/v3-codeql.yml | Adds C# security analysis for v3. |
| .gitattributes | Standardizes cross-platform line endings. |
| .editorconfig | Adds v3 C# and test conventions. |
| .dockerignore | Narrows demo image build contexts. |
Review effort: Balanced
| import { readdirSync, statSync } from 'node:fs'; | ||
| import { join } from 'node:path'; | ||
| import { describe, expect, it } from 'vitest'; | ||
| import { frameworkDir, frameworkUrl } from './support.ts'; | ||
|
|
||
| const budget = 6 * 1024 * 1024; | ||
|
|
||
| describe('WASM-08 size budget', () => { | ||
| it('ships at most 6 MB brotli, without the core package', () => { | ||
| frameworkUrl(); // fails clearly when the bundle wasn't built | ||
| const compressed = readdirSync(frameworkDir).filter((f) => f.endsWith('.br')); |

SourceFlow.Net v3 is a redesign, not an upgrade. v2 stored commands and replayed them to rebuild state; v3 stores events. Aggregates are pure deciders, everything that crosses a boundary goes through a transactional outbox and an inbox, and the event log is commit-ordered and gap-free. Registration is generated at compile time instead of discovered by reflection.
Every project targets
net10.0only (C# 14), except the Roslyn generatorsrc/Core/SourceFlow.Generators(netstandard2.0, ADR-027).What's in it
dotnet sourceflowCLI andSourceFlow.Testing(given/when/then specs, conformance kits).Breaking changes
v3 is neither source- nor binary-compatible with v2, and its storage model is different. Nothing in v2 survives as code. See Migrating from v2 and the breaking-changes section of the changelog.
The repository layout changes too: the v2 documentation moves to
docs/legacy-version, and the folders are grouped by purpose (src/,web/,samples/,docs/).Documentation
Status
All 63 work packages of the v3 plan and the 18 design-conformance packages (Track C, plan 11) are complete, and the CI workflows (v3-pr, v3-codeql, studio-pr, v3-images, v3-release) are green on
v3.0.0.Open before the release candidate (from the changelog's Release readiness):
@sourceflow/studioand theworkflow-diffaction