@cratis/arc 22.32.0 → 22.32.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +11 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -136,6 +136,17 @@ Before submitting documentation-only work, verify its links, anchors, and exampl
136
136
  - [Node 23+](https://nodejs.org/en)
137
137
  - [Yarn](https://yarnpkg.com)
138
138
 
139
+ ### Trim and NativeAOT diagnostics
140
+
141
+ `Cratis.Arc.Core` and `Cratis.Arc` are not trim or NativeAOT compatible yet ([#2204](https://github.com/Cratis/Arc/issues/2204)). Pull requests that change `Source/DotNET` run a ratchet that builds both projects with the trim and AOT analyzers on and compares the diagnostics per code, file and target framework with [`Source/DotNET/aot-baseline.json`](https://github.com/Cratis/Arc/blob/main/Source/DotNET/aot-baseline.json). It fails when a diagnostic or a trim/AOT suppression is added, and also when one is removed without shrinking the baseline. Run it locally with Python 3 and the .NET SDKs:
142
+
143
+ ```shell
144
+ python3 scripts/aot-ratchet.py # compare with the baseline
145
+ python3 scripts/aot-ratchet.py --update # rewrite the baseline after fixing diagnostics, then commit it
146
+ ```
147
+
148
+ Fix a new diagnostic by replacing the unsafe path rather than suppressing it. The analyzer ships with the .NET SDK, so run `--update` with the SDK `global.json` selects, as CI does; the baseline records the SDK version it was made with. When a new SDK changes what the analyzer reports, regenerate the baseline with `--update` in its own pull request. The normal build is unaffected; the analyzers only run when the script passes `CratisAotAnalysis=true`.
149
+
139
150
  ## Community and repository
140
151
 
141
152
  | Path | Destination |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "@cratis/arc",
4
- "version": "22.32.0",
4
+ "version": "22.32.1",
5
5
  "description": "TypeScript command, query, validation, identity, and messaging runtime for Cratis Arc — the CQRS application framework for ASP.NET Core — used by generated proxies.",
6
6
  "keywords": [
7
7
  "cratis",