@documentation-robotics/cli 0.1.0

package/dist/schemas/bundled/relationship-catalog.json

@@ -0,0 +1,1302 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Relationship Catalog",
+  "description": "Comprehensive catalog of semantic relationship types for Documentation Robotics",
+  "version": "2.1.0",
+  "generatedBy": "Manual",
+  "lastUpdated": "2025-12-15",
+
+  "relationshipTypes": [
+    {
+      "id": "composition",
+      "predicate": "composes",
+      "inversePredicate": "composed-of",
+      "category": "structural",
+      "archimateAlignment": "Composition",
+      "description": "Whole-part relationship where the part cannot exist without the whole",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "03", "04", "05", "06", "07", "08", "11", "12"],
+      "examples": [
+        {
+          "source": "BusinessCollaboration",
+          "target": "BusinessRole",
+          "description": "Business collaboration composes business roles that participate in it"
+        },
+        {
+          "source": "TestCoverageModel",
+          "target": "TestCoverageTarget",
+          "description": "Coverage model composes targets defining what needs testing",
+          "layer": "12-testing"
+        },
+        {
+          "source": "TestCoverageTarget",
+          "target": "OutcomeCategory",
+          "description": "Coverage target composes expected outcome categories",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageRequirement",
+          "target": "InputPartitionSelection",
+          "description": "Coverage requirement composes partition value selections",
+          "layer": "12-testing"
+        },
+        {
+          "source": "Span",
+          "target": "SpanEvent",
+          "description": "Span composes timestamped events occurring during execution",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "APMConfiguration",
+          "target": "TraceConfiguration",
+          "description": "APM config composes trace, log, and metric configurations",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "MeterConfig",
+          "target": "MetricInstrument",
+          "description": "Meter config composes individual metric instruments",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "ApplicationComponent",
+          "target": "ApplicationInterface",
+          "description": "Application component composes its interfaces"
+        },
+        {
+          "source": "OpenAPIDocument",
+          "target": "Paths",
+          "description": "API document composes paths object defining all endpoints",
+          "layer": "06-api"
+        },
+        {
+          "source": "Operation",
+          "target": "Responses",
+          "description": "API operation composes its responses object",
+          "layer": "06-api"
+        },
+        {
+          "source": "Components",
+          "target": "Schema",
+          "description": "Components object composes reusable schema definitions",
+          "layer": "06-api"
+        },
+        {
+          "source": "JSONSchema",
+          "target": "SchemaDefinition",
+          "description": "Schema document composes reusable definitions",
+          "layer": "07-data-model"
+        },
+        {
+          "source": "SchemaDefinition",
+          "target": "SchemaProperty",
+          "description": "Schema definition composes its properties",
+          "layer": "07-data-model"
+        },
+        {
+          "source": "Database",
+          "target": "DatabaseSchema",
+          "description": "Database instance contains one or more schemas",
+          "layer": "08-datastore"
+        },
+        {
+          "source": "DatabaseSchema",
+          "target": "Table",
+          "description": "Schema contains tables as physical storage units",
+          "layer": "08-datastore"
+        },
+        {
+          "source": "Table",
+          "target": "Column",
+          "description": "Table is composed of columns defining its structure",
+          "layer": "08-datastore"
+        },
+        {
+          "source": "Table",
+          "target": "Constraint",
+          "description": "Table contains constraints enforcing data integrity",
+          "layer": "08-datastore"
+        },
+        {
+          "source": "Table",
+          "target": "Index",
+          "description": "Table contains indexes for query optimization",
+          "layer": "08-datastore"
+        }
+      ]
+    },
+    {
+      "id": "aggregation",
+      "predicate": "aggregates",
+      "inversePredicate": "aggregated-by",
+      "category": "structural",
+      "archimateAlignment": "Aggregation",
+      "description": "Whole-part relationship where the part can exist independently",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["01", "02", "03", "04", "05", "06", "07", "08", "11", "12"],
+      "examples": [
+        {
+          "source": "Goal",
+          "target": "Goal",
+          "description": "High-level goal aggregates sub-goals",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "InputPartitionSelection",
+          "target": "PartitionValue",
+          "description": "Partition selection aggregates multiple partition values to cover",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageRequirement",
+          "target": "ContextVariation",
+          "description": "Requirement aggregates selected contexts for testing",
+          "layer": "12-testing"
+        },
+        {
+          "source": "Resource",
+          "target": "Span",
+          "description": "Resource aggregates all spans it produces",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "InstrumentationScope",
+          "target": "MetricInstrument",
+          "description": "Instrumentation scope aggregates metrics it records",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "TraceConfiguration",
+          "target": "ExporterConfig",
+          "description": "Trace config aggregates trace exporters",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "Requirement",
+          "target": "Requirement",
+          "description": "High-level requirement aggregates detailed requirements",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Product",
+          "target": "BusinessService",
+          "description": "Product aggregates business services it offers"
+        },
+        {
+          "source": "OpenAPIDocument",
+          "target": "Server",
+          "description": "API document aggregates server definitions",
+          "layer": "06-api"
+        },
+        {
+          "source": "OpenAPIDocument",
+          "target": "Tag",
+          "description": "API document aggregates tag definitions for operation grouping",
+          "layer": "06-api"
+        },
+        {
+          "source": "Operation",
+          "target": "SecurityRequirement",
+          "description": "Operation aggregates its security requirements",
+          "layer": "06-api"
+        },
+        {
+          "source": "JSONSchema",
+          "target": "DataGovernance",
+          "description": "Schema aggregates governance metadata",
+          "layer": "07-data-model"
+        },
+        {
+          "source": "JSONSchema",
+          "target": "DataQualityMetrics",
+          "description": "Schema aggregates quality metrics configuration",
+          "layer": "07-data-model"
+        },
+        {
+          "source": "Index",
+          "target": "Column",
+          "description": "Index aggregates one or more columns (composite indexes)",
+          "layer": "08-datastore"
+        },
+        {
+          "source": "Constraint",
+          "target": "Column",
+          "description": "Constraint aggregates columns (composite keys, multi-column checks)",
+          "layer": "08-datastore"
+        }
+      ]
+    },
+    {
+      "id": "specialization",
+      "predicate": "specializes",
+      "inversePredicate": "generalized-by",
+      "category": "structural",
+      "archimateAlignment": "Specialization",
+      "description": "Type-subtype relationship (inheritance)",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": true,
+        "symmetry": false
+      },
+      "applicableLayers": ["01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12"],
+      "examples": [
+        {
+          "source": "PremiumAccount",
+          "target": "Account",
+          "description": "Premium account specializes the general account concept"
+        },
+        {
+          "source": "Schema",
+          "target": "Schema",
+          "description": "API schema specializes another via allOf/oneOf/anyOf composition",
+          "layer": "06-api"
+        }
+      ]
+    },
+    {
+      "id": "realization",
+      "predicate": "realizes",
+      "inversePredicate": "realized-by",
+      "category": "structural",
+      "archimateAlignment": "Realization",
+      "description": "Implementation element realizes abstract element",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": true,
+        "symmetry": false
+      },
+      "applicableLayers": ["01", "02", "04", "05", "06", "07"],
+      "examples": [
+        {
+          "source": "Goal",
+          "target": "Value",
+          "description": "Goal realizes value for stakeholders",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Outcome",
+          "target": "Goal",
+          "description": "Outcome realizes achievement of goal",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "ApplicationService",
+          "target": "BusinessService",
+          "description": "Application service realizes business service capability"
+        },
+        {
+          "source": "APIOperation",
+          "target": "ApplicationInterface",
+          "description": "API operation realizes application interface"
+        }
+      ]
+    },
+    {
+      "id": "assignment",
+      "predicate": "assigned-to",
+      "inversePredicate": "assigns",
+      "category": "structural",
+      "archimateAlignment": "Assignment",
+      "description": "Active element assigned to behavior or role",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "03", "04", "05"],
+      "examples": [
+        {
+          "source": "BusinessActor",
+          "target": "BusinessRole",
+          "description": "Business actor assigned to business role"
+        }
+      ]
+    },
+    {
+      "id": "association",
+      "predicate": "associated-with",
+      "inversePredicate": "associated-with",
+      "category": "structural",
+      "archimateAlignment": "Association",
+      "description": "Generic relationship indicating elements are related or connected",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": true
+      },
+      "applicableLayers": ["01", "02", "03", "04", "05", "06"],
+      "examples": [
+        {
+          "source": "Stakeholder",
+          "target": "Driver",
+          "description": "Stakeholder has concern represented by driver",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Stakeholder",
+          "target": "Goal",
+          "description": "Stakeholder has interest in goal",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Requirement",
+          "target": "Constraint",
+          "description": "Requirement is limited by constraint",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Value",
+          "target": "Stakeholder",
+          "description": "Value is desired by stakeholder",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Outcome",
+          "target": "Value",
+          "description": "Outcome demonstrates value achievement",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Meaning",
+          "target": "Value",
+          "description": "Meaning interprets significance of value",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Meaning",
+          "target": "Outcome",
+          "description": "Meaning provides context for outcome",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Contact",
+          "target": "OpenAPIDocument",
+          "description": "Contact is associated with API document for support",
+          "layer": "06-api"
+        },
+        {
+          "source": "License",
+          "target": "OpenAPIDocument",
+          "description": "License is associated with API document for legal terms",
+          "layer": "06-api"
+        }
+      ]
+    },
+    {
+      "id": "influence",
+      "predicate": "influence",
+      "inversePredicate": "influenced-by",
+      "category": "behavioral",
+      "archimateAlignment": "Influence",
+      "description": "Element affects or impacts another element",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["01", "02", "04"],
+      "examples": [
+        {
+          "source": "Driver",
+          "target": "Assessment",
+          "description": "Driver creates need for assessment",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Driver",
+          "target": "Goal",
+          "description": "Driver motivates goal definition",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Assessment",
+          "target": "Goal",
+          "description": "Assessment informs goal setting",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Goal",
+          "target": "Principle",
+          "description": "Goal drives principle establishment",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Principle",
+          "target": "Requirement",
+          "description": "Principle guides requirement definition",
+          "layer": "01-motivation"
+        },
+        {
+          "source": "Constraint",
+          "target": "Requirement",
+          "description": "Constraint restricts requirement scope",
+          "layer": "01-motivation"
+        }
+      ]
+    },
+    {
+      "id": "triggering",
+      "predicate": "triggers",
+      "inversePredicate": "triggered-by",
+      "category": "behavioral",
+      "archimateAlignment": "Triggering",
+      "description": "Event or behavior triggers another behavior",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "06", "08", "11", "12"],
+      "examples": [
+        {
+          "source": "BusinessEvent",
+          "target": "BusinessProcess",
+          "description": "Business event triggers business process execution"
+        },
+        {
+          "source": "PartitionDependency",
+          "target": "PartitionValue",
+          "description": "Dependency condition triggers inclusion/exclusion of partition values",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageGap",
+          "target": "CoverageRequirement",
+          "description": "Identified gap triggers need for additional coverage",
+          "layer": "12-testing"
+        },
+        {
+          "source": "DataQualityMetric",
+          "target": "LogRecord",
+          "description": "Quality violation triggers alert log record",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "Operation",
+          "target": "Callback",
+          "description": "API operation triggers callback webhooks on events",
+          "layer": "06-api"
+        },
+        {
+          "source": "Trigger",
+          "target": "Function",
+          "description": "Database trigger executes specified function on event",
+          "layer": "08-datastore"
+        }
+      ]
+    },
+    {
+      "id": "flow",
+      "predicate": "flows-to",
+      "inversePredicate": "flows-from",
+      "category": "behavioral",
+      "archimateAlignment": "Flow",
+      "description": "Sequential or data flow between behaviors",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "09", "10", "11", "12"],
+      "examples": [
+        {
+          "source": "BusinessProcess",
+          "target": "BusinessProcess",
+          "description": "One business process flows to the next in sequence"
+        },
+        {
+          "source": "TestCoverageTarget",
+          "target": "CoverageRequirement",
+          "description": "Target flows to requirements that specify its coverage",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageRequirement",
+          "target": "TestCaseSketch",
+          "description": "Requirement flows to sketches that implement it",
+          "layer": "12-testing"
+        },
+        {
+          "source": "Span",
+          "target": "Span",
+          "description": "Span flows to child spans (request propagation)",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "LogProcessor",
+          "target": "LogProcessor",
+          "description": "Log records flow through processor pipeline in order",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "MetricInstrument",
+          "target": "ExporterConfig",
+          "description": "Collected metrics flow to configured exporters",
+          "layer": "11-apm-observability"
+        }
+      ]
+    },
+    {
+      "id": "serving",
+      "predicate": "serves",
+      "inversePredicate": "served-by",
+      "category": "behavioral",
+      "archimateAlignment": "Serving",
+      "description": "Service available to consumer",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "06", "08", "11", "12"],
+      "examples": [
+        {
+          "source": "BusinessService",
+          "target": "BusinessActor",
+          "description": "Business service serves business actor"
+        },
+        {
+          "source": "InputSpacePartition",
+          "target": "TestCoverageTarget",
+          "description": "Partition serves target by defining testable input space",
+          "layer": "12-testing"
+        },
+        {
+          "source": "ContextVariation",
+          "target": "TestCoverageTarget",
+          "description": "Context serves target by defining execution environments",
+          "layer": "12-testing"
+        },
+        {
+          "source": "InstrumentationConfig",
+          "target": "Resource",
+          "description": "Instrumentation config serves resources it instruments",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "ExporterConfig",
+          "target": "APMConfiguration",
+          "description": "Exporter serves APM configuration by delivering telemetry",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "SecurityScheme",
+          "target": "Operation",
+          "description": "Security scheme serves operations requiring authentication",
+          "layer": "06-api"
+        }
+      ]
+    },
+    {
+      "id": "access",
+      "predicate": "accesses",
+      "inversePredicate": "accessed-by",
+      "category": "behavioral",
+      "archimateAlignment": "Access",
+      "description": "Behavior accesses passive element (data/artifact)",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "06", "07", "08", "11", "12"],
+      "examples": [
+        {
+          "source": "BusinessProcess",
+          "target": "BusinessObject",
+          "description": "Business process accesses business object data"
+        },
+        {
+          "source": "TestCaseSketch",
+          "target": "InputSelection",
+          "description": "Test sketch accesses input selections for test execution",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageRequirement",
+          "target": "InputPartitionSelection",
+          "description": "Requirement accesses partition selections for coverage",
+          "layer": "12-testing"
+        },
+        {
+          "source": "LogProcessor",
+          "target": "Attribute",
+          "description": "Log processor accesses attributes for filtering/transformation",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "MetricInstrument",
+          "target": "Attribute",
+          "description": "Metric instrument accesses attributes for labeling",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "APIOperation",
+          "target": "DataObject",
+          "description": "API operation accesses data object"
+        }
+      ]
+    },
+    {
+      "id": "uses",
+      "predicate": "uses",
+      "inversePredicate": "used-by",
+      "category": "dependency",
+      "archimateAlignment": null,
+      "description": "Element depends on another for functionality",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "03", "04", "05", "09"],
+      "examples": [
+        {
+          "source": "ApplicationComponent",
+          "target": "TechnologyService",
+          "description": "Application component uses technology service"
+        }
+      ]
+    },
+    {
+      "id": "reference",
+      "predicate": "references",
+      "inversePredicate": "referenced-by",
+      "category": "dependency",
+      "archimateAlignment": null,
+      "description": "Pointer reference without functional dependency",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03", "04", "06", "07", "08", "09", "11", "12"],
+      "examples": [
+        {
+          "source": "DataObject",
+          "target": "Schema",
+          "description": "Data object references JSON schema"
+        },
+        {
+          "source": "TestCaseSketch",
+          "target": "CoverageRequirement",
+          "description": "Test case sketch references coverage requirement it satisfies",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageRequirement",
+          "target": "TestCoverageTarget",
+          "description": "Coverage requirement references target it covers",
+          "layer": "12-testing"
+        },
+        {
+          "source": "InputSelection",
+          "target": "PartitionValue",
+          "description": "Input selection references selected partition value",
+          "layer": "12-testing"
+        },
+        {
+          "source": "Span",
+          "target": "Span",
+          "description": "Span references parent span via parentSpanId (trace hierarchy)",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "LogRecord",
+          "target": "Span",
+          "description": "Log record references associated span via traceContext",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "SpanLink",
+          "target": "Span",
+          "description": "Span link references target span across traces",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "APIOperation",
+          "target": "BusinessService",
+          "description": "API operation references business service it supports"
+        },
+        {
+          "source": "Schema",
+          "target": "Schema",
+          "description": "API schema references another schema via $ref",
+          "layer": "06-api"
+        },
+        {
+          "source": "Parameter",
+          "target": "Schema",
+          "description": "Parameter references a schema for its data type",
+          "layer": "06-api"
+        },
+        {
+          "source": "Link",
+          "target": "Operation",
+          "description": "Link references target operation via operationId for HATEOAS",
+          "layer": "06-api"
+        },
+        {
+          "source": "Operation",
+          "target": "Tag",
+          "description": "Operation references tags for categorization",
+          "layer": "06-api"
+        }
+      ]
+    },
+    {
+      "id": "depends-on",
+      "predicate": "depends-on",
+      "inversePredicate": "dependency-of",
+      "category": "dependency",
+      "archimateAlignment": null,
+      "description": "Element requires another to function",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": true,
+        "symmetry": false
+      },
+      "applicableLayers": ["04", "05", "06", "08", "09", "11", "12"],
+      "examples": [
+        {
+          "source": "ApplicationService",
+          "target": "DataObject",
+          "description": "Application service depends on data object"
+        },
+        {
+          "source": "TestCaseSketch",
+          "target": "ContextVariation",
+          "description": "Test sketch depends on context for execution environment",
+          "layer": "12-testing"
+        },
+        {
+          "source": "TestCaseSketch",
+          "target": "OutcomeCategory",
+          "description": "Test sketch depends on expected outcome category",
+          "layer": "12-testing"
+        },
+        {
+          "source": "CoverageRequirement",
+          "target": "InputSpacePartition",
+          "description": "Requirement depends on partitions for coverage criteria",
+          "layer": "12-testing"
+        },
+        {
+          "source": "Span",
+          "target": "Resource",
+          "description": "Span depends on resource for identity context",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "Span",
+          "target": "InstrumentationScope",
+          "description": "Span depends on instrumentation scope for source context",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "LogRecord",
+          "target": "Resource",
+          "description": "Log record depends on resource for identity context",
+          "layer": "11-apm-observability"
+        },
+        {
+          "source": "MetricInstrument",
+          "target": "InstrumentationScope",
+          "description": "Metric instrument depends on instrumentation scope",
+          "layer": "11-apm-observability"
+        }
+      ]
+    },
+    {
+      "id": "supports-goals",
+      "predicate": "supports-goals",
+      "inversePredicate": "supported-by",
+      "category": "traceability",
+      "archimateAlignment": null,
+      "description": "Implementation contributes to achieving goal",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": true,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "06"],
+      "fieldPaths": ["motivation.supports-goals", "x-supports-goals"],
+      "examples": [
+        {
+          "source": "BusinessService",
+          "sourceLayer": "02-business",
+          "target": "Goal",
+          "targetLayer": "01-motivation",
+          "value": "goal-revenue-growth",
+          "description": "Payment service supports revenue growth goal"
+        },
+        {
+          "source": "Operation",
+          "sourceLayer": "06-api",
+          "target": "Goal",
+          "targetLayer": "01-motivation",
+          "value": "goal-customer-satisfaction",
+          "description": "GET /products operation supports customer satisfaction goal"
+        }
+      ]
+    },
+    {
+      "id": "fulfills-requirements",
+      "predicate": "fulfills-requirements",
+      "inversePredicate": "fulfilled-by",
+      "category": "traceability",
+      "archimateAlignment": null,
+      "description": "Implementation satisfies requirement",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "06", "03", "11"],
+      "fieldPaths": ["motivation.fulfills-requirements", "x-fulfills-requirements"],
+      "examples": [
+        {
+          "source": "ApplicationService",
+          "target": "Requirement",
+          "description": "OAuth service fulfills authentication requirement"
+        },
+        {
+          "source": "Operation",
+          "sourceLayer": "06-api",
+          "target": "Requirement",
+          "targetLayer": "01-motivation",
+          "value": "req-product-creation-capability",
+          "description": "POST /products operation fulfills product creation requirement"
+        }
+      ]
+    },
+    {
+      "id": "delivers-value",
+      "predicate": "delivers-value",
+      "inversePredicate": "delivered-by",
+      "category": "traceability",
+      "archimateAlignment": null,
+      "description": "Implementation provides business value",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02"],
+      "fieldPaths": ["motivation.delivers-value"],
+      "examples": [
+        {
+          "source": "BusinessService",
+          "target": "Value",
+          "description": "Loyalty program delivers customer retention value"
+        }
+      ]
+    },
+    {
+      "id": "measures-outcome",
+      "predicate": "measures-outcome",
+      "inversePredicate": "measured-by",
+      "category": "traceability",
+      "archimateAlignment": null,
+      "description": "Metric validates outcome achievement",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["11", "12"],
+      "fieldPaths": ["motivationMapping.measuresOutcome"],
+      "examples": [
+        {
+          "source": "Metric",
+          "target": "Outcome",
+          "description": "Response time metric measures performance outcome"
+        }
+      ]
+    },
+    {
+      "id": "governed-by-principles",
+      "predicate": "governed-by-principles",
+      "inversePredicate": "governs",
+      "category": "governance",
+      "archimateAlignment": null,
+      "description": "Element follows architectural principle",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["02", "04", "05", "06", "07"],
+      "fieldPaths": ["motivation.governed-by-principles", "x-governed-by-principles"],
+      "examples": [
+        {
+          "source": "APIOperation",
+          "target": "Principle",
+          "description": "REST API governed by RESTful design principles"
+        }
+      ]
+    },
+    {
+      "id": "constrainedby",
+      "predicate": "constrained-by",
+      "inversePredicate": "constrains",
+      "category": "governance",
+      "archimateAlignment": null,
+      "description": "Element limited by constraint",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03", "04", "05", "06", "07"],
+      "fieldPaths": ["motivation.constrained-by", "x-constrained-by"],
+      "examples": [
+        {
+          "source": "APIOperation",
+          "target": "Constraint",
+          "description": "API operation constrained by rate limit"
+        }
+      ]
+    },
+    {
+      "id": "enforces-requirement",
+      "predicate": "enforces-requirement",
+      "inversePredicate": "enforced-by",
+      "category": "governance",
+      "archimateAlignment": null,
+      "description": "Element actively enforces requirement",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03", "10"],
+      "fieldPaths": ["motivationAlignment.enforcesRequirement"],
+      "examples": [
+        {
+          "source": "NavigationGuard",
+          "target": "Requirement",
+          "description": "Auth guard enforces authentication requirement"
+        }
+      ]
+    },
+    {
+      "id": "traces",
+      "predicate": "traces",
+      "inversePredicate": "traced-by",
+      "category": "apm",
+      "archimateAlignment": null,
+      "description": "Distributed tracing relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["04", "06", "11"],
+      "fieldPaths": ["apm.traces", "x-traces"],
+      "examples": [
+        {
+          "source": "APIOperation",
+          "target": "DistributedTrace",
+          "description": "API operation participates in distributed trace"
+        }
+      ]
+    },
+    {
+      "id": "monitors",
+      "predicate": "monitors",
+      "inversePredicate": "monitored-by",
+      "category": "apm",
+      "archimateAlignment": null,
+      "description": "Health/performance monitoring",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["11"],
+      "fieldPaths": ["apm.monitors", "x-monitors"],
+      "examples": [
+        {
+          "source": "HealthCheck",
+          "target": "ApplicationService",
+          "description": "Health check monitors application service"
+        }
+      ]
+    },
+    {
+      "id": "measures",
+      "predicate": "measures",
+      "inversePredicate": "measured-by",
+      "category": "apm",
+      "archimateAlignment": null,
+      "description": "Metric collection relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["11"],
+      "fieldPaths": ["apm.measures", "x-measures"],
+      "examples": [
+        {
+          "source": "Metric",
+          "target": "APIOperation",
+          "description": "Response time metric measures API operation"
+        }
+      ]
+    },
+    {
+      "id": "protects",
+      "predicate": "protects",
+      "inversePredicate": "protected-by",
+      "category": "security",
+      "archimateAlignment": null,
+      "description": "Security control relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03"],
+      "fieldPaths": ["security.protects", "x-protects"],
+      "examples": [
+        {
+          "source": "SecurityControl",
+          "target": "ApplicationService",
+          "description": "Encryption control protects sensitive data service"
+        }
+      ]
+    },
+    {
+      "id": "authenticates",
+      "predicate": "authenticates",
+      "inversePredicate": "authenticated-by",
+      "category": "security",
+      "archimateAlignment": null,
+      "description": "Authentication flows",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03"],
+      "fieldPaths": ["security.authenticates", "x-authenticates"],
+      "examples": [
+        {
+          "source": "AuthenticationService",
+          "target": "User",
+          "description": "OAuth service authenticates user"
+        }
+      ]
+    },
+    {
+      "id": "authorization",
+      "predicate": "authorizes",
+      "inversePredicate": "authorized-by",
+      "category": "security",
+      "archimateAlignment": null,
+      "description": "Permission grants",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03"],
+      "fieldPaths": ["security.authorizes", "x-authorizes"],
+      "examples": [
+        {
+          "source": "Role",
+          "target": "Operation",
+          "description": "Admin role authorizes delete operation"
+        }
+      ]
+    },
+    {
+      "id": "renders",
+      "predicate": "renders",
+      "inversePredicate": "rendered-by",
+      "category": "ux",
+      "archimateAlignment": null,
+      "description": "UI rendering relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["09"],
+      "fieldPaths": ["ux.renders", "x-renders"],
+      "examples": [
+        {
+          "source": "UIComponent",
+          "target": "UIView",
+          "description": "Layout component renders view content"
+        }
+      ]
+    },
+    {
+      "id": "binds-to",
+      "predicate": "binds-to",
+      "inversePredicate": "bound-by",
+      "category": "ux",
+      "archimateAlignment": null,
+      "description": "Data binding relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["09"],
+      "fieldPaths": ["ux.binds-to", "x-binds-to"],
+      "examples": [
+        {
+          "source": "UIComponent",
+          "target": "DataObject",
+          "description": "Form component binds to user data object"
+        }
+      ]
+    },
+    {
+      "id": "navigates-to",
+      "predicate": "navigates-to",
+      "inversePredicate": "navigated-from",
+      "category": "ux",
+      "archimateAlignment": null,
+      "description": "Navigation flows",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["09", "10"],
+      "fieldPaths": ["navigation.navigates-to", "x-navigates-to"],
+      "examples": [
+        {
+          "source": "UIView",
+          "target": "UIView",
+          "description": "Login view navigates to dashboard view"
+        }
+      ]
+    },
+    {
+      "id": "maps-to",
+      "predicate": "maps-to",
+      "inversePredicate": "mapped-from",
+      "category": "data",
+      "archimateAlignment": null,
+      "description": "Schema/table mapping",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["07", "08"],
+      "fieldPaths": ["data.maps-to", "x-maps-to"],
+      "examples": [
+        {
+          "source": "DataObject",
+          "target": "DatabaseTable",
+          "description": "User data object maps to users table"
+        }
+      ]
+    },
+    {
+      "id": "references-table",
+      "predicate": "references-table",
+      "inversePredicate": "table-referenced-by",
+      "category": "data",
+      "archimateAlignment": null,
+      "description": "Foreign key relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["08"],
+      "fieldPaths": ["data.references-table", "x-references-table"],
+      "examples": [
+        {
+          "source": "OrderTable",
+          "target": "CustomerTable",
+          "description": "Order table references customer table via foreign key"
+        }
+      ]
+    },
+    {
+      "id": "derivedfrom",
+      "predicate": "derives-from",
+      "inversePredicate": "derived-by",
+      "category": "data",
+      "archimateAlignment": null,
+      "description": "Calculated field relationships",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["03", "07", "08"],
+      "fieldPaths": ["data.derives-from", "x-derives-from"],
+      "examples": [
+        {
+          "source": "TotalPrice",
+          "target": "Quantity, UnitPrice",
+          "description": "Total price derives from quantity times unit price"
+        }
+      ]
+    },
+    {
+      "id": "validates",
+      "predicate": "validates",
+      "inversePredicate": "validated-by",
+      "category": "testing",
+      "archimateAlignment": null,
+      "description": "Test element validates that a requirement or target is satisfied",
+      "semantics": {
+        "directionality": "bidirectional",
+        "transitivity": false,
+        "symmetry": false
+      },
+      "applicableLayers": ["12"],
+      "examples": [
+        {
+          "source": "TestCaseSketch",
+          "target": "CoverageRequirement",
+          "description": "Test sketch validates requirement is satisfied",
+          "layer": "12-testing"
+        },
+        {
+          "source": "TargetCoverageSummary",
+          "target": "TestCoverageTarget",
+          "description": "Summary validates coverage completeness of target",
+          "layer": "12-testing"
+        }
+      ]
+    }
+  ],
+
+  "metadata": {
+    "totalRelationships": 34,
+    "categoryCounts": {
+      "structural": 6,
+      "behavioral": 5,
+      "dependency": 3,
+      "traceability": 4,
+      "governance": 3,
+      "apm": 3,
+      "security": 3,
+      "ux": 3,
+      "data": 3,
+      "testing": 1
+    },
+    "archimateAligned": 11,
+    "documentationRoboticsExtensions": 23
+  }
+}