Vendor demos under demos/ and link from README for landing-page visibility

README.md

@@ -109,6 +109,23 @@ internally cast to contiguous `float64`.  Outputs are numpy arrays.
 
 See the wrapper docstrings for exact semantics of each function.
 
+## Demos
+
+Three runnable demos live in [`demos/`](./demos/):
+
+1. [`01_iris_boundary.py`](./demos/01_iris_boundary.py) — rediscovers
+   the famous Iris versicolor/virginica boundary specimens with no
+   training, using only `concept_support_matrix` and `pairwise_distances`.
+2. [`02_anomaly_detection.py`](./demos/02_anomaly_detection.py) —
+   parameter-free anomaly detection that matches IsolationForest's
+   AUC=1.0 on a synthetic benchmark, using only `batch_max_similarity`.
+3. [`03_multicriteria_selection.py`](./demos/03_multicriteria_selection.py)
+   — recovers 5/5 hidden balanced candidates that naive sum-of-scores
+   ranking misses, using `pareto_core_mask` and `non_redundant_witnesses`.
+
+A standalone copy of the demos repository is also published at
+https://git.sevana.biz/vvs/sem_cython12-demos.
+
 ## Performance notes
 
 Threads are configured globally per process; calling