Initial MetaCrate rewrite shell

README.md

@@ -0,0 +1,22 @@
+# MetaCrate
+
+MetaCrate is a test-driven, clean native Rust reimplementation of
+[LibreMetaverse](https://github.com/cinderblocks/libremetaverse). LibreMetaverse
+is a behavioral and API reference only: the finished project must not load,
+host, bind to, invoke, or ship the .NET implementation. The current
+stage is a compiling structural shell: crate boundaries mirror the .NET library
+projects, public C# type names have Rust declarations, every upstream NUnit case
+has a traceable placeholder, and every sample/tool project has a Rust binary
+target. Callable member signatures and semantic Rust test translations are the
+next two required gates; the current generated declarations are not yet the
+complete public API shim.
+
+The source snapshot, compatibility rules, dependency research, and ordered
+implementation plan are in [RUSTREWRITE.md](RUSTREWRITE.md).
+
+```sh
+cargo build --workspace
+cargo test --workspace --no-run
+```
+
+Running `cargo test --workspace` is intentionally red during the shim stage.