@objectstack/spec 3.0.8 → 3.0.9

package/json-schema/kernel/OpsFilePath.json

@@ -2,6 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "string",
   "description": "Validates a file path against OPS naming conventions",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/OpsFilePath.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/OpsFilePath.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/OpsPluginStructure.json

@@ -28,6 +28,6 @@
   ],
   "additionalProperties": false,
   "description": "Full plugin project layout validated against OPS conventions",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/OpsPluginStructure.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/OpsPluginStructure.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PackageArtifact.json

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "formatVersion": {
+      "default": "1.0",
+      "description": "Artifact format version (e.g. \"1.0\")",
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$"
+    },
+    "packageId": {
+      "type": "string",
+      "description": "Package identifier from manifest"
+    },
+    "version": {
+      "type": "string",
+      "description": "Package version from manifest"
+    },
+    "format": {
+      "default": "tgz",
+      "description": "Archive format of the artifact",
+      "type": "string",
+      "enum": [
+        "tgz",
+        "zip"
+      ]
+    },
+    "size": {
+      "description": "Total artifact file size in bytes",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "builtAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+      "description": "ISO 8601 timestamp of when the artifact was built"
+    },
+    "builtWith": {
+      "description": "Build tool identifier (e.g. \"os-cli@3.2.0\")",
+      "type": "string"
+    },
+    "files": {
+      "description": "List of files contained in the artifact",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Relative file path within the artifact"
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991,
+            "description": "File size in bytes"
+          },
+          "category": {
+            "description": "Metadata category this file belongs to",
+            "type": "string",
+            "enum": [
+              "objects",
+              "views",
+              "pages",
+              "flows",
+              "dashboards",
+              "permissions",
+              "agents",
+              "reports",
+              "actions",
+              "translations",
+              "themes",
+              "datasets",
+              "apis",
+              "triggers",
+              "workflows"
+            ]
+          }
+        },
+        "required": [
+          "path",
+          "size"
+        ],
+        "additionalProperties": false,
+        "description": "A single file entry within the artifact"
+      }
+    },
+    "metadataCategories": {
+      "description": "Metadata categories included in this artifact",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "objects",
+          "views",
+          "pages",
+          "flows",
+          "dashboards",
+          "permissions",
+          "agents",
+          "reports",
+          "actions",
+          "translations",
+          "themes",
+          "datasets",
+          "apis",
+          "triggers",
+          "workflows"
+        ],
+        "description": "Metadata category within the artifact"
+      }
+    },
+    "checksums": {
+      "description": "SHA256 checksums for artifact integrity verification",
+      "type": "object",
+      "properties": {
+        "algorithm": {
+          "default": "sha256",
+          "description": "Hash algorithm used for checksums",
+          "type": "string",
+          "enum": [
+            "sha256",
+            "sha384",
+            "sha512"
+          ]
+        },
+        "files": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "pattern": "^[a-f0-9]+$"
+          },
+          "description": "File path to hash value mapping"
+        }
+      },
+      "required": [
+        "algorithm",
+        "files"
+      ],
+      "additionalProperties": false
+    },
+    "signature": {
+      "description": "Digital signature for artifact authenticity verification",
+      "type": "object",
+      "properties": {
+        "algorithm": {
+          "default": "RSA-SHA256",
+          "description": "Signing algorithm used",
+          "type": "string",
+          "enum": [
+            "RSA-SHA256",
+            "RSA-SHA384",
+            "RSA-SHA512",
+            "ECDSA-SHA256"
+          ]
+        },
+        "publicKeyRef": {
+          "type": "string",
+          "description": "Public key reference (URL or fingerprint) for signature verification"
+        },
+        "signature": {
+          "type": "string",
+          "description": "Base64-encoded digital signature"
+        },
+        "signedAt": {
+          "description": "ISO 8601 timestamp of when the artifact was signed",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "signedBy": {
+          "description": "Identity of the signer (publisher ID or email)",
+          "type": "string"
+        }
+      },
+      "required": [
+        "algorithm",
+        "publicKeyRef",
+        "signature"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "formatVersion",
+    "packageId",
+    "version",
+    "format",
+    "builtAt"
+  ],
+  "additionalProperties": false,
+  "description": "Package artifact structure and metadata",
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PackageArtifact.json",
+  "x-spec-version": "3.0.9"
+}

package/json-schema/kernel/PackageDependency.json

@@ -33,6 +33,6 @@
   ],
   "additionalProperties": false,
   "description": "A package dependency with its version constraint",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PackageDependency.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PackageDependency.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PackageDependencyConflict.json

@@ -80,6 +80,6 @@
   ],
   "additionalProperties": false,
   "description": "A detected conflict between dependency version requirements",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PackageDependencyConflict.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PackageDependencyConflict.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PackageDependencyResolutionResult.json

@@ -336,6 +336,6 @@
   ],
   "additionalProperties": false,
   "description": "Result of a dependency resolution process",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PackageDependencyResolutionResult.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PackageDependencyResolutionResult.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PackageStatusEnum.json

@@ -9,6 +9,7 @@
     "uninstalling",
     "error"
   ],
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PackageStatusEnum.json",
-  "x-spec-version": "3.0.8"
+  "description": "Package installation status",
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PackageStatusEnum.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/Permission.json

@@ -104,6 +104,6 @@
     "required"
   ],
   "additionalProperties": false,
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/Permission.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/Permission.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PermissionAction.json

@@ -15,6 +15,6 @@
     "admin"
   ],
   "description": "Type of action being permitted",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PermissionAction.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PermissionAction.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PermissionScope.json

@@ -9,6 +9,6 @@
     "plugin"
   ],
   "description": "Scope of permission application",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PermissionScope.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PermissionScope.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PermissionSet.json

@@ -155,6 +155,6 @@
     "defaultGrant"
   ],
   "additionalProperties": false,
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PermissionSet.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PermissionSet.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PluginBuildOptions.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "directory": {
+      "description": "Project root directory (defaults to current working directory)",
+      "type": "string"
+    },
+    "outDir": {
+      "description": "Output directory for the built artifact (defaults to ./dist)",
+      "type": "string"
+    },
+    "format": {
+      "default": "tgz",
+      "description": "Archive format for the artifact",
+      "type": "string",
+      "enum": [
+        "tgz",
+        "zip"
+      ]
+    },
+    "sign": {
+      "default": false,
+      "description": "Whether to digitally sign the artifact",
+      "type": "boolean"
+    },
+    "privateKeyPath": {
+      "description": "Path to RSA/ECDSA private key file for signing",
+      "type": "string"
+    },
+    "signAlgorithm": {
+      "description": "Signing algorithm to use",
+      "type": "string",
+      "enum": [
+        "RSA-SHA256",
+        "RSA-SHA384",
+        "RSA-SHA512",
+        "ECDSA-SHA256"
+      ]
+    },
+    "checksumAlgorithm": {
+      "default": "sha256",
+      "description": "Hash algorithm for file checksums",
+      "type": "string",
+      "enum": [
+        "sha256",
+        "sha384",
+        "sha512"
+      ]
+    },
+    "includeData": {
+      "default": true,
+      "description": "Whether to include seed data in the artifact",
+      "type": "boolean"
+    },
+    "includeLocales": {
+      "default": true,
+      "description": "Whether to include locale/translation files",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "format",
+    "sign",
+    "checksumAlgorithm",
+    "includeData",
+    "includeLocales"
+  ],
+  "additionalProperties": false,
+  "description": "Options for the os plugin build command",
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginBuildOptions.json",
+  "x-spec-version": "3.0.9"
+}

package/json-schema/kernel/PluginBuildResult.json

@@ -0,0 +1,245 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "success": {
+      "type": "boolean",
+      "description": "Whether the build succeeded"
+    },
+    "artifactPath": {
+      "description": "Absolute path to the generated artifact file",
+      "type": "string"
+    },
+    "artifact": {
+      "description": "Artifact metadata",
+      "type": "object",
+      "properties": {
+        "formatVersion": {
+          "default": "1.0",
+          "description": "Artifact format version (e.g. \"1.0\")",
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+$"
+        },
+        "packageId": {
+          "type": "string",
+          "description": "Package identifier from manifest"
+        },
+        "version": {
+          "type": "string",
+          "description": "Package version from manifest"
+        },
+        "format": {
+          "default": "tgz",
+          "description": "Archive format of the artifact",
+          "type": "string",
+          "enum": [
+            "tgz",
+            "zip"
+          ]
+        },
+        "size": {
+          "description": "Total artifact file size in bytes",
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "builtAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+          "description": "ISO 8601 timestamp of when the artifact was built"
+        },
+        "builtWith": {
+          "description": "Build tool identifier (e.g. \"os-cli@3.2.0\")",
+          "type": "string"
+        },
+        "files": {
+          "description": "List of files contained in the artifact",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Relative file path within the artifact"
+              },
+              "size": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991,
+                "description": "File size in bytes"
+              },
+              "category": {
+                "description": "Metadata category this file belongs to",
+                "type": "string",
+                "enum": [
+                  "objects",
+                  "views",
+                  "pages",
+                  "flows",
+                  "dashboards",
+                  "permissions",
+                  "agents",
+                  "reports",
+                  "actions",
+                  "translations",
+                  "themes",
+                  "datasets",
+                  "apis",
+                  "triggers",
+                  "workflows"
+                ]
+              }
+            },
+            "required": [
+              "path",
+              "size"
+            ],
+            "additionalProperties": false,
+            "description": "A single file entry within the artifact"
+          }
+        },
+        "metadataCategories": {
+          "description": "Metadata categories included in this artifact",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "objects",
+              "views",
+              "pages",
+              "flows",
+              "dashboards",
+              "permissions",
+              "agents",
+              "reports",
+              "actions",
+              "translations",
+              "themes",
+              "datasets",
+              "apis",
+              "triggers",
+              "workflows"
+            ],
+            "description": "Metadata category within the artifact"
+          }
+        },
+        "checksums": {
+          "description": "SHA256 checksums for artifact integrity verification",
+          "type": "object",
+          "properties": {
+            "algorithm": {
+              "default": "sha256",
+              "description": "Hash algorithm used for checksums",
+              "type": "string",
+              "enum": [
+                "sha256",
+                "sha384",
+                "sha512"
+              ]
+            },
+            "files": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "string",
+                "pattern": "^[a-f0-9]+$"
+              },
+              "description": "File path to hash value mapping"
+            }
+          },
+          "required": [
+            "algorithm",
+            "files"
+          ],
+          "additionalProperties": false
+        },
+        "signature": {
+          "description": "Digital signature for artifact authenticity verification",
+          "type": "object",
+          "properties": {
+            "algorithm": {
+              "default": "RSA-SHA256",
+              "description": "Signing algorithm used",
+              "type": "string",
+              "enum": [
+                "RSA-SHA256",
+                "RSA-SHA384",
+                "RSA-SHA512",
+                "ECDSA-SHA256"
+              ]
+            },
+            "publicKeyRef": {
+              "type": "string",
+              "description": "Public key reference (URL or fingerprint) for signature verification"
+            },
+            "signature": {
+              "type": "string",
+              "description": "Base64-encoded digital signature"
+            },
+            "signedAt": {
+              "description": "ISO 8601 timestamp of when the artifact was signed",
+              "type": "string",
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+            },
+            "signedBy": {
+              "description": "Identity of the signer (publisher ID or email)",
+              "type": "string"
+            }
+          },
+          "required": [
+            "algorithm",
+            "publicKeyRef",
+            "signature"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "formatVersion",
+        "packageId",
+        "version",
+        "format",
+        "builtAt"
+      ],
+      "additionalProperties": false
+    },
+    "fileCount": {
+      "description": "Total number of files in the artifact",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "size": {
+      "description": "Total artifact size in bytes",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "durationMs": {
+      "description": "Build duration in milliseconds",
+      "type": "number"
+    },
+    "errorMessage": {
+      "description": "Error message if build failed",
+      "type": "string"
+    },
+    "warnings": {
+      "description": "Warnings emitted during build",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "success"
+  ],
+  "additionalProperties": false,
+  "description": "Result of the os plugin build command",
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginBuildResult.json",
+  "x-spec-version": "3.0.9"
+}

package/json-schema/kernel/PluginCaching.json

@@ -80,6 +80,6 @@
   ],
   "additionalProperties": false,
   "description": "Plugin caching configuration",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PluginCaching.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginCaching.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PluginCapability.json

@@ -129,6 +129,6 @@
     "certified"
   ],
   "additionalProperties": false,
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PluginCapability.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginCapability.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PluginCapabilityManifest.json

@@ -423,6 +423,6 @@
     }
   },
   "additionalProperties": false,
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PluginCapabilityManifest.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginCapabilityManifest.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PluginCodeSplitting.json

@@ -59,6 +59,6 @@
   ],
   "additionalProperties": false,
   "description": "Plugin code splitting configuration",
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PluginCodeSplitting.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginCodeSplitting.json",
+  "x-spec-version": "3.0.9"
 }

package/json-schema/kernel/PluginCompatibilityMatrix.json

@@ -173,6 +173,6 @@
     "supportedVersions"
   ],
   "additionalProperties": false,
-  "$id": "https://schema.objectstack.io/v3.0.8/kernel/PluginCompatibilityMatrix.json",
-  "x-spec-version": "3.0.8"
+  "$id": "https://schema.objectstack.io/v3.0.9/kernel/PluginCompatibilityMatrix.json",
+  "x-spec-version": "3.0.9"
 }