Project repo-family relations from local declarations

docs/rail-rapp-reef-adaptation.md

@@ -1,6 +1,6 @@
 # Rail Rapp Reef Adaptation
 
-Date: 2026-07-25
+Date: 2026-07-26
 
 ## Purpose
 
@@ -79,6 +79,10 @@ This metadata is available through repository registration, manifest sync, and
 repository projections such as the graph explorer's synthesized repository
 nodes.
 
+The registry now also retains the local checkout `path` used during onboarding.
+That lets Fabric reopen the conventional repo-local `rail`, `rapp`, and `reef`
+files when it needs to project first-wave relation edges.
+
 ## First New Capability Type
 
 Fabric now reserves:
@@ -95,23 +99,35 @@ Meaning:
 This is intentionally rail-focused. `rapp-*` and `reef-*` can start with
 service-level visibility before they need their own dedicated capability types.
 
+## Relation Projection Path
+
+Fabric now projects the minimum first-wave repo-family relations from
+repo-local files:
+
+- `governed_by` from `declarations/rail.yaml`, `declarations/rapp.yaml`, and
+  `declarations/reef.yaml`
+- `supports_rail` from `declarations/rapp.yaml`
+- `hosts_rail` from `bindings/rails.yaml` with a fallback to the reef
+  declaration
+- `binds_rapp` from `bindings/rapps.yaml` with a fallback to the reef
+  declaration
+
+This keeps the relation path anchored in reviewed repo-local files rather than
+guessing solely from registry metadata.
+
 ## What Is Still Missing
 
-The following are not done by this adaptation slice:
+The following are still not done:
 
-- export relations such as `supports_rail`, `hosts_rail`, `binds_rapp`, or
-  `governed_by`
 - validator rules for repo-family-specific declaration completeness
-- graph queries that resolve placement or governance directly from the new
-  repo-family metadata
+- richer graph queries that answer reef/workload placement beyond the first
+  projected repo edges
 - State Hub read-model fields that surface repo family directly in generated
   repo briefs or inventory views
-
-Those require a second wave after the first real `rail-*`, `rapp-*`, and
-`reef-*` repos exist.
+- deeper runtime placement semantics than the first repo-level topology
 
 ## Outcome
 
 Fabric can now move from "the new repo families exist only in architecture
-docs" to "the registry and declaration guidance are ready for the first repo
-instances" without overcommitting to a premature graph redesign.
+docs" to "the registry can project the first repo-family topology from
+repo-local evidence" without overcommitting to a premature graph redesign.