Introduce jobs top-level element

Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>

Author: ndeloof

schema/compose-spec.json

@@ -88,6 +88,17 @@
       },
       "additionalProperties": false,
       "description": "Configurations that are shared among multiple services."
+    },
+
+    "jobs": {
+      "type": "object",
+      "patternProperties": {
+        "^[a-zA-Z0-9._-]+$": {
+          "$ref": "#/$defs/job"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Jobs are containers that run to completion, triggered manually or on a schedule."
     }
   },
 
@@ -96,12 +107,10 @@
 
   "$defs": {
 
-    "service": {
+    "container_spec": {
       "type": "object",
-      "description": "Configuration for a service.",
+      "description": "Reusable container specification shared by services, jobs, and other container types.",
       "properties": {
-        "develop": {"$ref": "#/$defs/development"},
-        "deploy": {"$ref": "#/$defs/deployment"},
         "annotations": {"$ref": "#/$defs/list_or_dict"},
         "attach": {"type": ["boolean", "string"]},
         "build": {
@@ -702,10 +711,6 @@
           "type": ["boolean", "string"],
           "description": "Give extended privileges to the service container."
         },
-        "profiles": {
-          "$ref": "#/$defs/list_of_strings",
-          "description": "List of profiles for this service. When profiles are specified, services are only started when the profile is activated."
-        },
         "pull_policy": {
           "type": "string",
           "pattern": "always|never|build|if_not_present|missing|refresh|daily|weekly|every_([0-9]+[wdhms])+",
@@ -727,10 +732,6 @@
           "type": "string",
           "description": "Runtime to use for this container, e.g., 'runc'."
         },
-        "scale": {
-          "type": ["integer", "string"],
-          "description": "Number of containers to deploy for this service."
-        },
         "security_opt": {
           "type": "array",
           "items": {"type": "string"},
@@ -920,8 +921,49 @@
           "description": "The working directory in which the entrypoint or command will be run"
         }
       },
-      "patternProperties": {"^x-": {}},
-      "additionalProperties": false
+      "patternProperties": {"^x-": {}}
+    },
+
+    "service": {
+      "description": "Configuration for a service.",
+      "allOf": [{"$ref": "#/$defs/container_spec"}],
+      "properties": {
+        "deploy": {"$ref": "#/$defs/deployment"},
+        "develop": {"$ref": "#/$defs/development"},
+        "profiles": {
+          "$ref": "#/$defs/list_of_strings",
+          "description": "List of profiles for this service. When profiles are specified, services are only started when the profile is activated."
+        },
+        "scale": {
+          "type": ["integer", "string"],
+          "description": "Number of containers to deploy for this service."
+        }
+      },
+      "unevaluatedProperties": false
+    },
+
+    "job": {
+      "description": "Configuration for a job. Jobs are containers that run to completion.",
+      "allOf": [{"$ref": "#/$defs/container_spec"}],
+      "properties": {
+        "triggers": {
+          "type": "object",
+          "description": "Trigger conditions for the job.",
+          "properties": {
+            "manual": {
+              "type": "boolean",
+              "description": "Whether the job can be triggered manually via docker compose run."
+            },
+            "schedule": {
+              "type": "string",
+              "description": "Crontab expression to schedule the job (e.g. '0 * * * *' for every hour)."
+            }
+          },
+          "additionalProperties": false,
+          "patternProperties": {"^x-": {}}
+        }
+      },
+      "unevaluatedProperties": false
     },
 
     "healthcheck": {