Refactored AcBinarySourceGenerator to use RefAwareEmitPredicate for all ref-handling switch decisions, ensuring child property ref-marker logic is based solely on child compile-time flags. Fixed deserialization drift when parent disables ref-handling but child enables it. Added regression tests and new test models to verify correct round-trip behavior for duplicate child references in collections and dictionaries. Improved XML docs and updated conventions for summary tags. Added SGen string round-trip tests for medium UTF-8/ASCII cases.
.NET 9 core framework providing serialization (Binary, JSON, Toon), entity abstractions, database access, services, and shared utilities. Used as the foundation layer for AyCode applications.
LLM Context
Domain rules and key pitfalls live in a single file: .github/copilot-instructions.md
Tool
Auto-loaded
Action needed
GitHub Copilot
✅copilot-instructions.md
None
Claude Code
✅CLAUDE.md → references above
None
Cursor / Windsurf
✅README.md
Read copilot-instructions.md via @file
Solution-level docs in docs/:
Document
Topic
GLOSSARY.md
Core terminology reference
ARCHITECTURE.md
Solution layers, dependency rules
CONVENTIONS.md
Coding conventions
Project-level docs — each project's docs/ folder documents the code it defines:
Project
Documents
AyCode.Core/docs/
BINARY/ (README, FORMAT, FEATURES, OPTIONS, …), LOGGING/ (README, ISSUES, TODO)