@run402/runtime-kernel 0.1.5 → 0.1.7

package/schemas/project-archive-auth-stubs.v1.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-auth-stubs.v1.schema.json",
+  "title": "Run402 Project Archive Auth Stubs v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["subject_id", "disabled"],
+  "properties": {
+    "subject_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "disabled": {
+      "const": true
+    },
+    "references": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/project-archive-database-tables.v1.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-database-tables.v1.schema.json",
+  "title": "Run402 Project Archive Database Tables v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "tables"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.database_tables.v1"
+    },
+    "tables": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "copy_path", "row_count"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "schema": { "type": "string" },
+          "name": { "type": "string", "minLength": 1 },
+          "copy_path": { "type": "string", "minLength": 1 },
+          "row_count": { "type": "integer", "minimum": 0 },
+          "deterministic_order": { "type": "boolean" },
+          "order_by": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "columns": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["name", "type"],
+              "properties": {
+                "name": { "type": "string", "minLength": 1 },
+                "type": { "type": "string", "minLength": 1 },
+                "nullable": { "type": "boolean" }
+              }
+            }
+          },
+          "digest": {
+            "type": "string",
+            "pattern": "^sha256:[0-9a-f]{64}$"
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/project-archive-descriptor.v1.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-descriptor.v1.schema.json",
+  "title": "Run402 Project Archive Descriptor v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["mediaType", "digest", "size"],
+  "properties": {
+    "mediaType": {
+      "type": "string",
+      "minLength": 1
+    },
+    "digest": {
+      "$ref": "#/$defs/sha256_digest"
+    },
+    "size": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "path": {
+      "$ref": "#/$defs/archive_path"
+    },
+    "annotations": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    }
+  },
+  "$defs": {
+    "sha256_digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "archive_path": {
+      "type": "string",
+      "minLength": 1,
+      "not": {
+        "anyOf": [
+          { "pattern": "^/" },
+          { "pattern": "\\\\" },
+          { "pattern": "(^|/)\\.\\.(/|$)" },
+          { "pattern": "(^|/)\\.(/|$)" },
+          { "pattern": "//" },
+          { "pattern": "[\\u0000-\\u001f\\u007f]" }
+        ]
+      }
+    }
+  }
+}

package/schemas/project-archive-export-report.v1.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-export-report.v1.schema.json",
+  "title": "Run402 Project Archive Export Report v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "export_scope", "auth_export", "consistency"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.export_report.v1"
+    },
+    "export_scope": {
+      "const": "portable-runtime-v1"
+    },
+    "auth_export": {
+      "enum": ["none", "stubs"]
+    },
+    "consistency": {
+      "enum": ["cloud_write_pause_v1", "core_fixture_v1"]
+    },
+    "omitted_sensitive_resource_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "unsupported_resource_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "integer",
+        "minimum": 0
+      }
+    },
+    "bytes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "integer",
+        "minimum": 0
+      }
+    }
+  }
+}

package/schemas/project-archive-import-result.v1.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-import-result.v1.schema.json",
+  "title": "Run402 Project Archive Import Result v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "status", "archive_digest", "diagnostics"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.import_result.v1"
+    },
+    "status": {
+      "enum": ["verified", "dry_run", "imported", "blocked", "failed"]
+    },
+    "project_id": {
+      "type": "string"
+    },
+    "project_name": {
+      "type": "string"
+    },
+    "archive_digest": {
+      "type": ["string", "null"],
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "release_id": {
+      "type": ["string", "null"]
+    },
+    "required_secrets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": {
+        "$ref": "https://run402.com/schemas/project-archive-portability-report.v1.schema.json#/$defs/entry"
+      }
+    },
+    "next_action": {
+      "$ref": "https://run402.com/schemas/project-archive-portability-report.v1.schema.json#/$defs/next_action"
+    }
+  }
+}

package/schemas/project-archive-index.v1.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-index.v1.schema.json",
+  "title": "Run402 Project Archive Index v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "archive_version",
+    "mediaType",
+    "core_compatibility",
+    "source",
+    "required_capabilities",
+    "identity_descriptors",
+    "descriptors"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.index.v1"
+    },
+    "archive_version": {
+      "const": "run402-project-archive.v1"
+    },
+    "mediaType": {
+      "const": "application/vnd.run402.project-archive.index.v1+json"
+    },
+    "archive_digest": {
+      "$ref": "#/$defs/sha256_digest"
+    },
+    "core_compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runtime_kernel", "release_spec"],
+      "properties": {
+        "runtime_kernel": { "type": "string", "minLength": 1 },
+        "release_spec": { "type": "string", "minLength": 1 }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform"],
+      "properties": {
+        "platform": {
+          "enum": ["run402-cloud", "run402-core", "run402-core-fixture"]
+        },
+        "label": {
+          "type": "string"
+        }
+      }
+    },
+    "required_capabilities": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "identity_descriptors": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "descriptors": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "https://run402.com/schemas/project-archive-descriptor.v1.schema.json"
+      }
+    },
+    "consistency": {
+      "$ref": "#/$defs/consistency"
+    },
+    "annotations": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256_digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "consistency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode"],
+      "properties": {
+        "mode": {
+          "enum": ["cloud_write_pause_v1", "core_fixture_v1"]
+        },
+        "pinned_release_id": {
+          "type": ["string", "null"]
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "completed_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "database": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "postgres_version": { "type": "string" },
+            "snapshot": { "type": ["string", "null"] },
+            "wal_lsn": { "type": ["string", "null"] }
+          }
+        },
+        "storage": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mutation_pause"],
+          "properties": {
+            "mutation_pause": {
+              "enum": ["not_applicable", "paused", "unavailable"]
+            }
+          }
+        },
+        "runtime": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["artifact_capture"],
+          "properties": {
+            "artifact_capture": {
+              "enum": ["captured", "not_applicable", "unavailable"]
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/project-archive-layout.v1.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-layout.v1.schema.json",
+  "title": "Run402 Project Archive Layout v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "archive_version",
+    "mediaType",
+    "index",
+    "blobs",
+    "transports",
+    "checksum_lists_authoritative"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.layout.v1"
+    },
+    "archive_version": {
+      "const": "run402-project-archive.v1"
+    },
+    "mediaType": {
+      "const": "application/vnd.run402.project-archive.layout.v1+json"
+    },
+    "index": {
+      "const": "index.json"
+    },
+    "blobs": {
+      "const": "blobs/sha256"
+    },
+    "transports": {
+      "type": "array",
+      "contains": { "const": "directory" },
+      "items": {
+        "enum": ["directory", "tar"]
+      },
+      "uniqueItems": true
+    },
+    "checksum_lists_authoritative": {
+      "const": false
+    }
+  }
+}

package/schemas/project-archive-portability-report.v1.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-portability-report.v1.schema.json",
+  "title": "Run402 Project Archive Portability Report v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "entries"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.portability_report.v1"
+    },
+    "entries": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/entry" }
+    }
+  },
+  "$defs": {
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "resource_type", "message", "next_action", "retryable"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "severity": { "enum": ["info", "warning", "blocking"] },
+        "resource_type": { "type": "string", "minLength": 1 },
+        "resource_id": { "type": "string" },
+        "path": { "type": "string" },
+        "message": { "type": "string", "minLength": 1 },
+        "next_action": { "$ref": "#/$defs/next_action" },
+        "retryable": { "type": "boolean" },
+        "context": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "next_action": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "enum": [
+            "run_command",
+            "set_secret",
+            "change_export_scope",
+            "remove_unsupported_feature",
+            "retry_later",
+            "contact_support",
+            "read_docs",
+            "none"
+          ]
+        },
+        "command": { "type": "string" },
+        "env_var": { "type": "string" },
+        "docs_url": { "type": "string", "format": "uri" },
+        "message": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/project-archive-runtime-index.v1.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-runtime-index.v1.schema.json",
+  "title": "Run402 Project Archive Runtime Index v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.runtime_index.v1"
+    },
+    "functions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "runtime", "artifact_digest", "artifact_path"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "runtime": { "const": "node22" },
+          "entrypoint": { "type": "string" },
+          "artifact_digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+          "artifact_path": { "type": "string", "minLength": 1 },
+          "required_secrets": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "class": { "enum": ["standard", "ssr"] }
+        }
+      }
+    },
+    "astro_ssr": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "function": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/project-archive-secret-requirements.v1.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-secret-requirements.v1.schema.json",
+  "title": "Run402 Project Archive Secret Requirements v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "secrets"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.secret_requirements.v1"
+    },
+    "secrets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "required"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "required": { "type": "boolean" },
+          "targets": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "description": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/project-archive-storage-index.v1.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://run402.com/schemas/project-archive-storage-index.v1.schema.json",
+  "title": "Run402 Project Archive Storage Index v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "objects"],
+  "properties": {
+    "schema_version": {
+      "const": "run402.project_archive.storage_index.v1"
+    },
+    "objects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["key", "visibility", "content_type", "size", "digest", "blob_path"],
+        "properties": {
+          "key": { "type": "string", "minLength": 1 },
+          "visibility": { "enum": ["public", "private"] },
+          "content_type": { "type": "string", "minLength": 1 },
+          "cache_control": { "type": "string" },
+          "immutable": { "type": "boolean" },
+          "size": { "type": "integer", "minimum": 0 },
+          "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+          "blob_path": { "type": "string", "minLength": 1 },
+          "metadata": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      }
+    }
+  }
+}