Refactor docs: topic folders, TOON, XCUT, protocol sync - Migrated all topic documentation into dedicated folders with canonical `README.md`, `ISSUES.md`, and `TODO.md` per topic (e.g., `LOGGING/`, `SIGNALR/`, `BINARY/`, `TOON/`). - Added comprehensive TOON serializer documentation: design, format, options, attributes, inference, issues, and TODOs. - Introduced `XCUT` folder for cross-cutting issues and TODOs, with canonical entries and topic cross-references. - Updated all references and navigation to use new folder-based doc paths; fixed links and clarified doc structure. - Enhanced AI agent protocol: enforce session skill preloading, `[LOADED_DOCS: ...]` short-name prefix, and mandatory `docs-check` skill for doc/code sync. - Updated `.csproj` to include all `README.md` files for IDE visibility. - Improved and clarified SignalR, grid, and project-level documentation. - Minor code/test tweaks and doc content corrections for consistency. |
||
|---|---|---|
| .. | ||
| AcNavigationPropertyInfo.cs | ||
| AcToonContextBase.cs | ||
| AcToonSerializer.AttributeExtraction.cs | ||
| AcToonSerializer.Attributes.cs | ||
| AcToonSerializer.DataSection.cs | ||
| AcToonSerializer.Descriptions.cs | ||
| AcToonSerializer.ForeignKeys.cs | ||
| AcToonSerializer.MetaWriter.cs | ||
| AcToonSerializer.Navigation.cs | ||
| AcToonSerializer.Placeholders.cs | ||
| AcToonSerializer.ToonSerializationContext.cs | ||
| AcToonSerializer.ToonSerializeTypeMetadata.cs | ||
| AcToonSerializer.TopologicalSort.cs | ||
| AcToonSerializer.TypeDefinitions.cs | ||
| AcToonSerializer.Validation.cs | ||
| AcToonSerializer.cs | ||
| AcToonSerializerOptions.cs | ||
| README.md | ||
| ToonDescriptionAttribute.cs | ||
| ToonTypeRelation.cs | ||
README.md
Toons (code folder)
Source code for AcToonSerializer — Token-Oriented Object Notation, the LLM-optimized serialization format.
Domain documentation:
../../docs/TOON/README.md. This file is only a local file index.
Files in this folder
AcToonSerializer.cs— main entry point (publicSerialize/SerializeTypeMetadata/SerializeMetadataAPI).AcToonSerializer.*.cs— 14 partial class files split topically (MetaWriter, DataSection, TypeDefinitions, Descriptions, Attributes, AttributeExtraction, Placeholders, TopologicalSort, Navigation, ForeignKeys, Validation, ToonSerializationContext, ToonSerializeTypeMetadata).AcToonSerializerOptions.cs— options POCO,ToonSerializationModeenum, preset factories.AcToonContextBase.cs— shared base for serialization contexts.ToonDescriptionAttribute.cs—[ToonDescription]attribute +ToonRelationTypeenum.ToonTypeRelation.cs— type relation string constants (BaseOf,DtoOf,ModelOf, etc.).
Cross-references
- Shared serializer infrastructure (metadata cache, reference tracking,
IdentityMap):../README.md. - Full Toon docs:
../../docs/TOON/.