feat: version state hub fabric export contract

2026-05-24 01:06:49 +02:00
parent be0299e528
commit 63379ca329
5 changed files with 898 additions and 126 deletions
--- a/examples/exports/financial-fabric-v1.json
+++ b/examples/exports/financial-fabric-v1.json
@@ -0,0 +1,192 @@
+{
+  "apiVersion": "railiance.fabric/v1alpha2",
+  "kind": "FabricGraphExport",
+  "schema_version": "financial-fabric-v1",
+  "generated_at": "2026-05-24T00:00:00Z",
+  "source": {
+    "producer": "railiance-fabric",
+    "registry": "registry",
+    "commit": "example",
+    "generation_reason": "operator_refresh"
+  },
+  "compatibility": {
+    "legacy_v1alpha1_supported": true,
+    "breaking_reset": false
+  },
+  "netkingdom": {
+    "id": "railiance.netkingdom",
+    "name": "Railiance Netkingdom",
+    "king_actor_id": "actor.railiance.king"
+  },
+  "actors": [
+    {
+      "id": "actor.railiance.king",
+      "kind": "FabricActor",
+      "role": "king",
+      "name": "Railiance King"
+    },
+    {
+      "id": "actor.railiance.primary-lord",
+      "kind": "FabricActor",
+      "role": "lord",
+      "name": "Railiance Primary Lord"
+    },
+    {
+      "id": "actor.coulomb.tenant",
+      "kind": "FabricActor",
+      "role": "tenant",
+      "name": "Coulomb Tenant"
+    }
+  ],
+  "fabrics": [
+    {
+      "id": "fabric.railiance.primary",
+      "kind": "Fabric",
+      "name": "Railiance Primary Fabric",
+      "netkingdom_id": "railiance.netkingdom",
+      "lord_actor_id": "actor.railiance.primary-lord",
+      "parent_fabric_id": null,
+      "status": "active",
+      "boundary": {
+        "boundary_type": "fabric",
+        "criterion": "financial_and_operational_accountability"
+      },
+      "evidence_refs": []
+    },
+    {
+      "id": "subfabric.railiance.tenant.coulomb",
+      "kind": "Subfabric",
+      "name": "Coulomb Tenant Subfabric",
+      "netkingdom_id": "railiance.netkingdom",
+      "parent_fabric_id": "fabric.railiance.primary",
+      "tenant_actor_id": "actor.coulomb.tenant",
+      "status": "planned",
+      "boundary": {
+        "boundary_type": "subfabric",
+        "criterion": "restricted_paid_tenant_utility"
+      },
+      "evidence_refs": []
+    }
+  ],
+  "nodes": [
+    {
+      "id": "state-hub.http",
+      "kind": "UtilityInterface",
+      "name": "State Hub HTTP API",
+      "repo": "state-hub",
+      "domain": "custodian",
+      "lifecycle": "active",
+      "containment": {
+        "netkingdom_id": "railiance.netkingdom",
+        "fabric_id": "fabric.railiance.primary",
+        "subfabric_id": null,
+        "environment": "local",
+        "deployment_scenario_id": null
+      },
+      "ownership": {
+        "owner_actor_id": "actor.railiance.primary-lord",
+        "owner_role": "lord",
+        "resolution": "inherited",
+        "inherited_from": "fabric.railiance.primary",
+        "supporting_actor_ids": []
+      },
+      "accounting": {
+        "cost_center_id": "cc.platform.shared",
+        "allocation_model": "direct"
+      },
+      "evidence": {
+        "state": "declared",
+        "review_state": "accepted",
+        "confidence": 0.9,
+        "refs": []
+      },
+      "canon_category": "endpoint",
+      "canon_anchor": "model/network",
+      "mapping_fit": "partial",
+      "evidence_state": "declared",
+      "attributes": {
+        "description": "Example tenant-facing State Hub API utility."
+      }
+    },
+    {
+      "id": "coulomb.automation-client",
+      "kind": "Service",
+      "name": "Coulomb Automation Client",
+      "repo": "coulomb-automation",
+      "domain": "railiance",
+      "lifecycle": "planned",
+      "containment": {
+        "netkingdom_id": "railiance.netkingdom",
+        "fabric_id": "fabric.railiance.primary",
+        "subfabric_id": "subfabric.railiance.tenant.coulomb",
+        "environment": "local",
+        "deployment_scenario_id": null
+      },
+      "ownership": {
+        "owner_actor_id": "actor.coulomb.tenant",
+        "owner_role": "tenant",
+        "resolution": "explicit",
+        "supporting_actor_ids": []
+      },
+      "accounting": {
+        "cost_center_id": "cc.coulomb.automation",
+        "allocation_model": "direct"
+      },
+      "evidence": {
+        "state": "declared",
+        "review_state": "accepted",
+        "confidence": 0.8,
+        "refs": []
+      },
+      "attributes": {}
+    }
+  ],
+  "edges": [
+    {
+      "id": "utility:state-hub-http:coulomb-client",
+      "from": "state-hub.http",
+      "to": "coulomb.automation-client",
+      "type": "provides_utility_to",
+      "relationship_category": "utility",
+      "canonical_type": "depends_on",
+      "canon_anchor": "model/landscape",
+      "mapping_fit": "partial",
+      "display_only": false,
+      "evidence_state": "declared",
+      "provider": {
+        "owner_actor_id": "actor.railiance.primary-lord",
+        "fabric_id": "fabric.railiance.primary",
+        "subfabric_id": null
+      },
+      "consumer": {
+        "owner_actor_id": "actor.coulomb.tenant",
+        "fabric_id": "fabric.railiance.primary",
+        "subfabric_id": "subfabric.railiance.tenant.coulomb"
+      },
+      "boundary": {
+        "crosses_fabric_boundary": false,
+        "crosses_subfabric_boundary": true
+      },
+      "utility": {
+        "utility_type": "coordination_api",
+        "contract_id": "state-hub.http",
+        "payment_schema_id": "payment.internal-tenant-access",
+        "metering_basis": "unknown",
+        "business_model": "tenant_utility"
+      },
+      "accounting": {
+        "provider_profit_center_id": "pc.tenant-utilities",
+        "consumer_cost_center_id": "cc.coulomb.automation",
+        "allocation_model": "usage_weighted"
+      },
+      "evidence": {
+        "state": "declared",
+        "review_state": "accepted",
+        "confidence": 0.8,
+        "refs": []
+      },
+      "attributes": {}
+    }
+  ],
+  "unresolved": []
+}