Add comprehensive metadata schema reference documentation

[AdaWorldAPI]

Summary

This PR adds a complete reference guide for the ladybug-rs metadata system, documenting the two-tier metadata architecture and all associated types and structures.

Changes

• New file: docs/METADATA_SCHEMA.md — comprehensive schema reference covering:
  • MetaView layout (Container 0, W0-W127): Full 1,024-byte canonical metadata structure with word-by-word breakdown and all 18 word constants
  • SchemaSidecar layout (W224-W255): Compact 256-byte summary for quick deserialization, split into identity/reasoning/learning (W224-W239) and topology/edges (W240-W255) blocks
  • Key data structures: NodeIdentity, AniLevels (8 cognitive layers), NarsTruth, NarsBudget, EdgeTypeMarker, NodeTypeMarker, and NodeKind enum
  • Auxiliary types: EnvelopeMetadata, DocumentMeta, and UnifiedStep execution contract
  • Invariants and alignment guarantees: Container 0 exclusion from Hamming search, schema versioning, checksumming, and 64-byte cache-line alignment
  • Record geometry: Full 2,048-byte record layout and 16K-bit upgrade structure

Notable Details

• Cross-references source files (src/container/meta.rs, src/width_16k/schema.rs, src/contract/types.rs, src/storage/corpus.rs)
• Includes all word constants and their purposes for quick lookup
• Documents zero-copy API design and SIMD safety guarantees
• Provides both high-level overview and detailed field-by-field specifications
• Marked as generated on 2026-03-17 with schema version 1 reference

https://claude.ai/code/session_016wjHu3AsaTCdHfGXEkEMvk

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.