Initial open-source release

examples/orbit-relationship-verification/README.md

@@ -0,0 +1,33 @@
+# Orbit-style relationship discovery verification
+
+This KLO project backs the default `relationships:verify-orbit` command. It uses
+the checked-in Orbit-style SQLite fixture from the relationship discovery
+benchmark corpus, with no declared primary keys or foreign keys in the database
+schema.
+
+Run from the KLO workspace root:
+
+```bash
+pnpm run relationships:verify-orbit
+```
+
+Expected relationship summary:
+
+```text
+Accepted: 9
+Review: 0
+Rejected: 0
+Skipped: 0
+```
+
+The command refreshes:
+
+```text
+examples/orbit-relationship-verification/reports/orbit-verification.md
+```
+
+Use a real local Orbit project by overriding the project directory:
+
+```bash
+KLO_ORBIT_PROJECT_DIR=/path/to/orbit-project pnpm run relationships:verify-orbit
+```