controller types

src/controller.jsonnet

@@ -1,4 +1,5 @@
 local entity = import 'entity.libsonnet';
+local types = import 'types.libsonnet';
 
 entity
 {
@@ -18,19 +19,19 @@ entity
       type: 'array',
       description: 'Entities this controller controls.',
       items:
-        $.properties.id,
+        types.id,
     },
     measures: {
       type: 'array',
       description: 'List of variables this controller measures.',
-      items: 'string',
+      items: types.id,
       minItems: 1,
       uniqueItems: true,
     },
     controls: {
       type: 'array',
       description: 'List of variables this controller controls.',
-      items: 'string',
+      items: type.id,
       minItems: 1,
       uniqueItems: true,
     }

src/locations/room.jsonnet

@@ -15,7 +15,7 @@ entity
       type: 'array',
       items: {
         type: 'object',
-        description: 'Relationships that bind other entities to this room.',
+        description: 'Relationships notionally related to this room.',
         properties: {
           id: types.id,
           args: {

src/relationship.jsonnet

@@ -4,7 +4,11 @@ entity
 {
   '$id': 'https://picc.app/schemata/v0.1-dev/relationship',
   title: 'Relationship',
-  description: 'Describes a relationship between entities. An arity of 1 is used to describe a property of an entity (a relationship of the entity to itself).',
+  description: |||
+    Describes a relationship between entities. An arity of 1 is used to describe a property of an entity (a relationship of the entity to itself).
+
+    The first argument of a relationship is used as the primary key and should be the main entity of the relationship.
+  |||,
 
   properties+: {
     arity: {