docs: reef attribute refs and resource object workplan

Publish the operational reference convention (reef: and secret:
handles). Add a resource-control view of reef-railiance that excludes
S3. Open RESOURCE-WP-0006 for the five-facet inventory model.

tools/validate.py

@@ -114,6 +114,18 @@ def main() -> int:
     assert planning["transfer_price"] == "240.00"
     assert planning["credit_headroom"] == "760.00"
     assert planning["financial_entity_id"] == "entity:coulomb"
+    reef_view_schema = load("schemas/reef-view.schema.json")
+    assert reef_view_schema["$schema"].endswith("2020-12/schema")
+    inventory_ids = {resource["id"] for resource in resources if resource.get("record_scope") == "inventory"}
+    for path in Path("data/reefs").glob("*.json"):
+        view = load(str(path))
+        assert view["schema_version"] == "0.1"
+        assert view["declaration_ref"].startswith("reef:")
+        missing = [row["resource_id"] for row in view["resources"] if row["resource_id"] not in inventory_ids]
+        assert not missing, f"{path} cites unknown resources: {missing}"
+        if view["reef_id"] == "reef-railiance":
+            assert view["role"] == "compute_substrate"
+            assert any("reef-storage" in note for note in view.get("notes") or [])
     print("resource-control declarations: valid")
     return 0