Skip to content

SourceFlow.Net v3.0.0: event-sourced redesign for .NET 10 - #8

Open
Nshai wants to merge 112 commits into
masterfrom
v3.0.0
Open

Nshai wants to merge 112 commits into
masterfrom
v3.0.0

Conversation

@Nshai

@Nshai Nshai commented Nov 15, 2026

Copy link
Copy Markdown
Contributor

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.0 only (C# 14), except the Roslyn generator src/Core/SourceFlow.Generators (netstandard2.0, ADR-027).

What's in it

  • Core: event-sourced aggregates as deciders, source-generated registration, purity and determinism analyzers.
  • Persistence: PostgreSQL and SQL Server event stores, with EF Core read models in the same transaction.
  • Transports: AWS SNS/SQS, Azure Service Bus and Google Pub/Sub, all passing the same conformance kit.
  • Query side: a schema catalog, the SFQL query language, named domain queries and a per-service HTTP query API.
  • Multi-tenancy: conjoined tenants with PostgreSQL row-level security.
  • Security: payload encryption and crypto-shredding of personal data with AWS KMS, Azure Key Vault and Google Cloud KMS.
  • Observability: OpenTelemetry traces and metrics, health checks, a generated Grafana dashboard and Prometheus alerts.
  • Tooling: the dotnet sourceflow CLI and SourceFlow.Testing (given/when/then specs, conformance kits).
  • Workflows: a workflow DSL compiled into process managers, and SourceFlow Studio, a visual designer for it.
  • Migration: a v2 data migration tool and a v2 wire bridge for AWS.
  • Samples: OrderFulfilment and TravelBooking, with Docker Compose stacks.

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):

  • the first weekly libFuzzer run per target (O-1)
  • the NuGet signing certificate and the nuget.org key (O-2)
  • the maintainer's sign-off of the security review (O-6)
  • five consecutive green nights per cloud for the real-cloud legs
  • the PERF-09 acceptance run (5,000 commands/s per 4 vCPU)
  • Studio 1.0: the workflow end-to-end scenarios on the three real clouds; publishing @sourceflow/studio and the workflow-diff action
  • the M6 hardening and release-candidate programme

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.
Copilot AI balanced review requested due to automatic review settings November 15, 2026 14:17
@github-advanced-security

Copy link
Copy Markdown

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:

  • The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
  • Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
  • You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

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)

@github-advanced-security github-advanced-security AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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));
Comment on lines +217 to +218
return Codes(conditional.WhenTrue, rejects, compilation, depth, cancellationToken)
& (conditional.WhenFalse is null || Codes(conditional.WhenFalse, rejects, compilation, depth, cancellationToken));
Comment on lines +392 to +393
{
}
Comment on lines +393 to +394
{
}
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);

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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

Comment on lines +2 to +12
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'));
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants