From 7d3ce6a7cc03073d9f1ae43f91dbe8cf2cd50383 Mon Sep 17 00:00:00 2001
From: Hassan Abedi <cogitator.tech@gmail.com>
Date: Fri, 29 May 2026 09:37:30 +0200
Subject: [PATCH] Add a simple README for the Geomerge demo

---
 crates/geormerge-demo/README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 crates/geormerge-demo/README.md

diff --git a/crates/geormerge-demo/README.md b/crates/geormerge-demo/README.md
new file mode 100644
index 0000000..91e2125
--- /dev/null
+++ b/crates/geormerge-demo/README.md
@@ -0,0 +1,27 @@
+## Geomerge Demo
+
+This crate demonstrates storing and reading data with the `geomerge` submodule.
+
+The demo
+1. loads the compiled `paths.json` schema
+2. creates a Geomerge store
+3. inserts a small graph dataset in one transaction
+4. reads the inserted edge back
+5. persists the store to bytes
+6. reloads it and checks that the restored store matches the original.
+
+### Run
+
+```sh
+cargo run -p geormerge-demo
+```
+
+Expected output includes table and law counts, stored graph row counts, edge endpoints, and persisted byte size.
+
+### Test
+
+```sh
+cargo test -p geormerge-demo
+```
+
+The tests cover the successful store, read, and persistence round trip, plus a rejected invalid edge insert that must leave the store unchanged.