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
+```

examples/orbit-relationship-verification/klo.yaml

@@ -0,0 +1,28 @@
+project: orbit-relationship-verification
+connections:
+  orbit:
+    driver: sqlite
+    path: ../../packages/context/test/fixtures/relationship-benchmarks/orbit_style_product_no_declared_constraints/data.sqlite
+    readonly: true
+storage:
+  state: sqlite
+  search: sqlite-fts5
+  git:
+    auto_commit: true
+    author: "klo <klo@example.com>"
+ingest:
+  adapters:
+    - live-database
+scan:
+  enrichment:
+    backend: none
+  relationships:
+    enabled: true
+    llm_proposals: false
+    validation_required_for_manifest: true
+    accept_threshold: 0.85
+    review_threshold: 0.55
+    max_llm_tables_per_batch: 40
+    max_candidates_per_column: 25
+    profile_sample_rows: 10000
+    validation_concurrency: 4