chore: dependency modernization and documentation accuracy sweep - #164
Merged
Merged
Conversation
Dependencies - NuGet: .NET 10 servicing 10.0.12 (Microsoft.Extensions.* 10.10.0), Microsoft.OpenApi 2.12.2 (floor required by Microsoft.AspNetCore.OpenApi 10.0.12), ModelContextProtocol.AspNetCore 2.2.0, gRPC 2.84.0, OpenTelemetry 1.19, Npgsql EF 10.0.3, OpenFeature 2.14.1, Aspire 13.5.4, xunit v3 4.0.1, Testcontainers 4.15.0. Roslyn stays at 5.6.0 to match the global.json SDK band (documented in Directory.Packages.props). - npm: minor bumps everywhere; TypeScript 6 + Vitest 5 for both library packages (explicit "types": ["node"] for the client generator); fumadocs 16.15 (zbsearch). - GitHub Actions: pin every action to its latest release. - Samples: Aspire AppHost SDK 13.5.4; silence ASPIRE010 for plain `dotnet run`. Framework - Attribute properties are init-only (breaking, CHANGELOG'd). - ELSG010 message and stale XML examples (ITenantContext, IGlobalAuthorizationRule, IClientSnapshotContributor, HandlerAttribute) match the current API. - release.mjs syncs only Elarion package versions (Version="" and `--version`), no longer clobbering third-party pins in doc snippets. Docs - Verified capabilities, concepts, reference, getting-started and tutorial pages against source: non-compiling samples, removed APIs, wrong namespaces/defaults, full decorator order, ADR index, SKILL.md sync, Node 20.11+. - Tutorial uses the framework TransactionDecorator + AddElarionUnitOfWork instead of a hand-rolled decorator that double-wrapped inbox/idempotent handlers.
…or fumadocs 16.15
Resolve Directory.Packages.props (keep bumps; Microsoft.Extensions.Http 10.0.12) and CONTRIBUTING.md (main's three-package npm wording). Bring elarion-webpush to TypeScript 6 / Vitest 5 and make [GenerateElarionWebPush] properties init-only like the other attributes.
swimmesberger
marked this pull request as ready for review
September 25, 2026 20:42
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Dependencies
Microsoft.Extensions.*to 10.10.0).Microsoft.OpenApito 2.12.2, the minimum thatMicrosoft.AspNetCore.OpenApi10.0.12 now requires.ModelContextProtocol.AspNetCore1.4 → 2.2 (major): apps that useElarion.AspNetCore.Mcpwill pull in MCP 2.x.Microsoft.CodeAnalysis.CSharpstays at 5.6.0 on purpose. SDK 10.0.3xx ships Roslyn 5.6, so a newer version would stop the bundled generators loading (CS9057) for anyone on that SDK. There's a comment inDirectory.Packages.props.tsconfig.jsonnow lists"types": ["node"]because TS 6+ stops including@typesautomatically. TypeScript 7 was skipped: it has no JS API, and the tests usets.transpileModule.@orama/oramato fumadocs'zbsearchfork (initOrama→initDB), andllms.txtawaits the now-asyncllms(source).index().uses:pinned to its latest release.setup-dotnetandsetup-nodehad been on mismatched versions across workflows.Merged with
main(Web Push, #163)Microsoft.Extensions.Httpto 10.0.12.elarion-webpushon TypeScript 6 / Vitest 5 (26/26 tests).[GenerateElarionWebPush]properties madeinitlike the other attributes.Framework
init-only (breaking, in the CHANGELOG): the 54 remainingsetproperties on framework attributes. Attribute syntax at call sites is unaffected.Add{Assembly}ScheduledJobs. XML examples onITenantContext,IGlobalAuthorizationRule,IClientSnapshotContributorandHandlerAttributenow use the current API.scripts/release.mjs: only rewrites Elarion package versions, bothVersion="…"anddotnet add package … --version. It used to overwrite third-party version pins in doc snippets (the OpenApi one had already been broken), and it missed the--versionform.Docs
Elarion.Pipeline.TransactionDecorator<,>withAddElarionUnitOfWork<BillingDbContext>(). The hand-written decorator it replaces double-wrapped inbox and[Idempotent]handlers, and a cancel arriving after success rolled back finished work.SKILL.mdcopies synced, Node 20.11+ everywhere.Validation
Elarion.Tests: 2139/2139 passed after the merge (one earlier run had 4 intermittent failures that didn't reproduce in 3 reruns), integration tests included (Docker available).dotnet pack: all 54 packages.pack --dry-runclean for both.tsc -b && vite buildsucceeds.check:linkspassed (9691 references after the merge). Search checked in the dev server: the index loads and a query returns results.