Loretta
bb1dbd242e
Moved AcSignalRDataSource and TrackingItemHelpers from AyCode.Services.Server to AyCode.Services (namespace updated). Updated all references, usings, and doc cross-refs to new location. Removed orphan SignalR.Core 1.2.0 package and .Server DLL refs from Blazor/Web.Client/Shared projects; WASM AOT build now works. Introduced AcBinaryDeserExecutor for off-pool streaming deserialization, fixing thread pool starvation (see updated protocol docs). Updated test usings and doc tables. No functional changes to DataSource logic. Decision log entry LLMP-DEC-68 documents the change. |
||
|---|---|---|
| .. | ||
| BINARY_AQN_IMPLEMENTATION.md | ||
| BINARY_ASYNCPIPE_ISSUES.md | ||
| BINARY_ASYNCPIPE_TODO.md | ||
| BINARY_BYTECODE_OPTIMIZATION.md | ||
| BINARY_FEATURES.md | ||
| BINARY_FORMAT.md | ||
| BINARY_IMPLEMENTATION.md | ||
| BINARY_ISSUES.md | ||
| BINARY_OPTIONS.md | ||
| BINARY_SGEN.md | ||
| BINARY_SGEN_OPTIMIZATION.md | ||
| BINARY_STRICT_SGEN.md | ||
| BINARY_TODO.md | ||
| BINARY_TODO_2026_04.md | ||
| BINARY_TODO_2026_05.md | ||
| BINARY_WHYUSE.md | ||
| BINARY_WRITERS.md | ||
| README.md | ||
README.md
BINARY — AcBinary serializer
AcBinary serialization system. Primary goal: speed (two-phase scan+serialize, reference tracking, string interning).
Files in this folder
BINARY_WHYUSE.md— Architectural framing: why AcBinary exists (category vs wire-only serializers, three-pillar value proposition, fit/not-fit decision lists, benchmark reading guide)BINARY_FEATURES.md— High-level features and capabilitiesBINARY_FORMAT.md— Wire format specificationBINARY_OPTIONS.md— Configuration options (AcBinaryOptions)BINARY_IMPLEMENTATION.md— Internal implementation detailsBINARY_WRITERS.md— Writer internals (streaming, buffering)BINARY_SGEN.md— Source generator (AyCode.Core.Serializers.SourceGenerator)BINARY_SGEN_OPTIMIZATION.md— SGen per-property emit micro-optimization brainstorming / methodology notes (working doc, not a TODO)BINARY_BYTECODE_OPTIMIZATION.md— Wire-format hot/cold marker layout reorganization (sibling working doc, feature-flag-aligned bytecode space partition)BINARY_STRICT_SGEN.md—AcBinary.StrictNuGet package plan (sibling working doc, SGen-only build target, AOT-friendly opt-in next to the default Hybrid)BINARY_ISSUES.md— Known issues and limitations (binary serializer core)BINARY_TODO.md— Planned work / open tickets (binary serializer core)BINARY_ASYNCPIPE_ISSUES.md— Known issues and limitations (streaming I/O layer:AsyncPipeReaderInput+AsyncPipeWriterOutput)BINARY_ASYNCPIPE_TODO.md— Planned work / open tickets (streaming I/O layer)
Start here
Start with BINARY_WHYUSE.md (architectural framing — why this serializer over the alternatives), then BINARY_FEATURES.md (feature overview), then BINARY_FORMAT.md (wire-level). BINARY_SGEN.md covers build-time code-gen integration.
Cross-references
- Serialization overview (Toon vs AcBinary vs AcJson, shared infrastructure):
../../Serializers/README.md - SignalR binary transport (uses this serializer):
../../AyCode.Services/docs/SIGNALR_BINARY_PROTOCOL/README.md - ASP.NET Core MVC formatter (uses this serializer):
../../AyCode.Services/docs/MVC/README.md - Glossary terms:
../../../docs/GLOSSARY.md
Related ADRs
AyCode.Core/docs/adr/0003-acbinary-streaming-receive-architecture.md— Receive-side streaming architecture (Status: Accepted 2026-05-03, partially executed). Delivered:SegmentBufferReader+SegmentBufferReaderInputconsolidated into a singleAsyncPipeReaderInputprimitive (mirrors send-sideAsyncPipeWriterOutput); SignalR receive-side migration completed. Dropped during execution: NamedPipe + FileStream helpers (Steps 4 & 5) — framework stays consumer-implements-transport, exposes only genericPipeWriter/PipeReaderprimitives.