workspai 0.43.0 → 0.44.0

package/contracts/workspace-archive-capabilities.v1.json

@@ -0,0 +1,90 @@
+{
+  "schemaVersion": "workspai-workspace-archive-capabilities-v1",
+  "commands": [
+    "export",
+    "inspect",
+    "verify",
+    "doctor",
+    "hydrate"
+  ],
+  "container": {
+    "writeFormat": "zip64",
+    "readFormats": [
+      "zip",
+      "zip64"
+    ],
+    "compressionModes": [
+      "store",
+      "deflate"
+    ],
+    "defaultCompression": "store"
+  },
+  "streaming": {
+    "export": true,
+    "remoteDownload": true,
+    "inspect": true,
+    "verify": true,
+    "hydrate": true,
+    "payloadBufferedInMemory": false
+  },
+  "sizePolicy": {
+    "workspacePayloadDefault": "unlimited",
+    "safetyBudgets": "opt-in",
+    "manifestMemoryLimitBytes": 268435456,
+    "remoteDownloadTimeoutDefaultMs": 1800000
+  },
+  "integrity": {
+    "algorithm": "sha256",
+    "manifestRequired": true,
+    "strictVerificationRequiresChecksums": true
+  },
+  "cliFlags": {
+    "archiveCompression": {
+      "signature": "--archive-compression <mode>",
+      "description": "Archive compression: store (default) or deflate",
+      "appliesTo": [
+        "export"
+      ]
+    },
+    "maxDownloadSize": {
+      "signature": "--max-download-size <size>",
+      "description": "Optional maximum remote archive download size (for example 8gb)",
+      "appliesTo": [
+        "inspect",
+        "verify",
+        "doctor",
+        "hydrate"
+      ]
+    },
+    "maxExpandedSize": {
+      "signature": "--max-expanded-size <size>",
+      "description": "Optional maximum expanded archive payload size (for example 20gb)",
+      "appliesTo": [
+        "inspect",
+        "verify",
+        "doctor",
+        "hydrate"
+      ]
+    },
+    "downloadTimeoutMs": {
+      "signature": "--download-timeout-ms <ms>",
+      "description": "Remote archive download timeout in milliseconds; 0 disables it",
+      "appliesTo": [
+        "inspect",
+        "verify",
+        "doctor",
+        "hydrate"
+      ]
+    }
+  },
+  "contracts": {
+    "manifest": {
+      "schemaVersion": "workspai-workspace-archive-manifest-v1",
+      "path": "contracts/workspace-archive-manifest.v1.json"
+    },
+    "operationResult": {
+      "schemaVersion": "workspai-workspace-archive-operation-result-v1",
+      "path": "contracts/workspace-archive-operation-result.v1.json"
+    }
+  }
+}

package/contracts/workspace-archive-manifest.v1.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/contracts/workspace-archive-manifest.v1.json",
+  "title": "Workspai Workspace Archive Manifest v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "workspaceName",
+    "exportedAt",
+    "security",
+    "files"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspai-workspace-archive-manifest-v1"
+    },
+    "version": {
+      "const": 1
+    },
+    "kind": {
+      "const": "workspai.workspace.archive"
+    },
+    "workspaceName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "exportedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "exportedBy": {
+      "enum": [
+        "workspai",
+        "workspai-vscode"
+      ]
+    },
+    "archiveFormat": {
+      "enum": [
+        "zip-store",
+        "zip-deflate"
+      ]
+    },
+    "containerFormat": {
+      "enum": [
+        "zip",
+        "zip64"
+      ]
+    },
+    "compression": {
+      "enum": [
+        "store",
+        "deflate"
+      ]
+    },
+    "streaming": {
+      "type": "boolean"
+    },
+    "security": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "envFilesIncluded",
+        "excludedByDefault"
+      ],
+      "properties": {
+        "envFilesIncluded": {
+          "type": "boolean"
+        },
+        "excludedByDefault": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        }
+      }
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "path",
+          "size",
+          "sha256"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          }
+        }
+      }
+    }
+  }
+}