- Add BINARY_FORMAT.md: full AcBinary wire format spec (markers, encoding, options, protocol, interactions) - Reference BINARY_FORMAT.md from GLOSSARY.md, Binaries/README.md, and Serializers/Binaries/README.md; add new glossary terms - Clarify and expand config options tables to match new doc - Add/clarify LLM maintenance rules: always sync .md files with code, auto-fix discrepancies - Update root README.md: AyCode.Core targets .NET 9, not 10; stress doc/code sync - Add code reuse and doc sync conventions to copilot-instructions.md and CONVENTIONS.md - Add docs/ folder and BINARY_FORMAT.md to solution as Solution Items - Minor clarifications and cross-links in ARCHITECTURE.md and other docs |
||
|---|---|---|
| .. | ||
| IAcSerializableToJson.cs | ||
| IForeignKey.cs | ||
| IId.cs | ||
| README.md | ||
README.md
Interfaces
Core interfaces used throughout the framework.
Key Files
IId.cs—IId<T>withT Id { get; set; }. The foundational interface for ID-bearing entities. Used byCollectionExtensions(merge/sync),IdentityMap(reference tracking), and all three serializers for reference resolution.IForeignKey.cs— Marker interfaces for navigation property detection:IForeignKey— empty markerIForeignCollection<T>— generic collection navigation marker (T : IEnumerable)IForeignCollection— non-generic variant
IAcSerializableToJson.cs— Empty marker interface tagging types that can serialize to JSON. Used for query-time type filtering.