feat: add predicates to controller and application schemas (#146)

docs/docs/reference/02-yaml-syntax.md

@@ -914,7 +914,7 @@ my_button:
 
 ## Validating a YAML application
 
-The [YAML application schema](https://docs.aica.tech/schemas/1-3-0/application.schema.json) defines the structural rules
+The [YAML application schema](https://docs.aica.tech/schemas/1-4-0/application.schema.json) defines the structural rules
 of an AICA application and effectively distinguishes between valid and invalid syntax.
 
 Many modern IDEs and code editors can be configured to support custom schemas and provide in-line validation and
@@ -928,5 +928,5 @@ Developers working with Visual Studio Code can validate YAML application files e
 2. Associate a schema with the YAML application by adding the following modeline to the file:
 
 ```yaml
-# yaml-language-server: $schema=https://docs.aica.tech/schemas/1-3-0/application.schema.json
+# yaml-language-server: $schema=https://docs.aica.tech/schemas/1-4-0/application.schema.json
 ```

schemas/applications/CHANGELOG.md

@@ -2,13 +2,18 @@
 
 Release Versions:
 
+- [1-4-0](#140)
 - [1-3-0](#130)
 - [1-2-0](#120)
 - [1-1-2](#112)
 - [1-1-1](#111)
 - [1-1-0](#110)
 - [1-0-0](#100)
 
+## 1-4-0
+
+Version 1-4-0 adds support for predicate events on controllers.
+
 ## 1-3-0
 
 Version 1-3-0 adds support for service calls on controllers.

schemas/applications/schema/application.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "/1-3-0/application.schema.json",
+  "$id": "/1-4-0/application.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "YAML Application Description",
   "description": "An AICA application graph description using YAML syntax.",

schemas/applications/schema/components.schema.json

@@ -70,7 +70,7 @@
           }
         },
         "events": {
-          "title": "Event Predicates",
+          "title": "Component Event Predicates",
           "description": "Component predicates that trigger events",
           "type": "object",
           "additionalProperties": false,
@@ -118,7 +118,7 @@
           },
           "patternProperties": {
             "^[a-zA-Z][a-zA-Z0-9_]*[a-zA-Z0-9]$": {
-              "title": "Predicate Events",
+              "title": "Component Predicate",
               "description": "A component-specific predicate",
               "$ref": "events.schema.json"
             }

schemas/applications/schema/hardware.schema.json

@@ -69,7 +69,19 @@
                 },
                 "outputs": {
                   "$ref": "common/outputs.schema.json"
-                }
+                },
+                "events": {
+                  "title": "Controller Event Predicates",
+                  "description": "Controller predicates that trigger events",
+                  "type": "object",
+                  "additionalProperties": false,
+                  "patternProperties": {
+                    "^[a-zA-Z][a-zA-Z0-9_]*[a-zA-Z0-9]$": {
+                      "title": "Controller Predicate",
+                      "description": "A controller-specific predicate",
+                      "$ref": "events.schema.json"
+                    }
+                  }
               },
               "required": [
                 "plugin"

schemas/component-descriptions/schema/component.schema.json

@@ -101,7 +101,7 @@
       "description": "The predicates provided by the component.",
       "type": "array",
       "items": {
-        "$ref": "predicate.schema.json"
+        "$ref": "https://raw.githubusercontent.com/aica-technology/api/main/schemas/predicates/schema/predicate.schema.json"
       },
       "uniqueItems": true
     },

schemas/controller-descriptions/CHANGELOG.md

@@ -2,10 +2,19 @@
 
 Release Versions:
 
+- [1-3-0](#130)
 - [1-2-0](#120)
 - [1-1-0](#110)
 - [1-0-0](#100)
 
+## 1-3-0
+
+As of version 1-2-0, controllers can also have the field `predicates` to list the predicates provided by the controller.
+
+### Changelog
+
+- feat(controller-schema): add predicates (#145)
+
 ## 1-2-0
 
 As of version 1-2-0, controllers can also have the field `services` to list the services provided by the controller.

schemas/controller-descriptions/schema/controller.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "/1-2-0/controller.schema.json",
+  "$id": "/1-3-0/controller.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "AICA Controller Description",
   "description": "A full description of a controller in the AICA application framework.",
@@ -106,6 +106,15 @@
       },
       "uniqueItems": true
     },
+    "predicates": {
+      "title": "Controller Predicates",
+      "description": "The predicates provided by the controller.",
+      "type": "array",
+      "items": {
+        "$ref": "https://raw.githubusercontent.com/aica-technology/api/main/schemas/predicates/schema/predicate.schema.json"
+      },
+      "uniqueItems": true
+    },
     "services": {
       "title": "Controller Services",
       "description": "The services provided by the controller.",

schemas/component-descriptions/schema/predicate.schema.json → schemas/predicates/schema/predicate.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "Component Predicate",
-  "description": "A predicate signal parameter of a dynamic component.",
+  "title": "Predicate",
+  "description": "A predicate of a component or controller.",
   "type": "object",
   "properties": {
     "display_name": {
@@ -13,7 +13,7 @@
       "type": "string"
     },
     "predicate_name": {
-      "description": "The lower_snake_case predicate name as it is declared in the component.",
+      "description": "The lower_snake_case predicate name as it is declared in the component or controller.",
       "type": "string"
     }
   },

schemas/services/schema/service.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "Component Service",
-  "description": "A service endpoint of a dynamic component.",
+  "title": "Service",
+  "description": "A service endpoint of a component or controller.",
   "type": "object",
   "properties": {
     "display_name": {
@@ -13,7 +13,7 @@
       "type": "string"
     },
     "service_name": {
-      "description": "The lower_snake_case service name as it is declared in the component.",
+      "description": "The lower_snake_case service name as it is declared in the component or controller.",
       "type": "string"
     },
     "payload_format": {