release-skill 0.9.17 → 0.9.18

package/adapters/cursor/src/schemas/operation-result.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/operation-result.json",
+  "title": "OperationResult",
+  "description": "Terminal result of one kernel protocol operation: terminal state, optional outputs, and stable-coded errors. A result never carries non-terminal states.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "protocol", "operationId", "operation", "state", "errors"],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "kind": {
+      "const": "skill-family.operation-result"
+    },
+    "protocol": {
+      "$ref": "#/$defs/protocolRef"
+    },
+    "operationId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
+      "description": "Echoes the request operationId."
+    },
+    "operation": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
+      "description": "Echoes the request operation."
+    },
+    "state": {
+      "enum": ["succeeded", "failed", "rejected"],
+      "description": "Terminal states only; equals the kernel protocol terminalStates set."
+    },
+    "outputs": {
+      "type": ["object", "null"],
+      "description": "Operation-specific outputs; meaningful when state is succeeded."
+    },
+    "errors": {
+      "type": "array",
+      "description": "Empty when state is succeeded; at least one stable-coded error otherwise.",
+      "items": {
+        "$ref": "#/$defs/error"
+      }
+    },
+    "completedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Optional RFC 3339 date-time when the operation reached a terminal state."
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "state": {
+            "const": "succeeded"
+          }
+        },
+        "required": ["state"]
+      },
+      "then": {
+        "properties": {
+          "errors": {
+            "type": "array",
+            "maxItems": 0
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "state": {
+            "enum": ["failed", "rejected"]
+          }
+        },
+        "required": ["state"]
+      },
+      "then": {
+        "properties": {
+          "errors": {
+            "type": "array",
+            "minItems": 1
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "protocolRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(\\.[a-z][a-z0-9]*(-[a-z0-9]+)*)*$",
+          "description": "Registered protocol name (dot-separated kebab-case segments)."
+        },
+        "version": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Registered protocol version."
+        }
+      }
+    },
+    "error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "type": "string",
+          "pattern": "^SFC[0-9]{4}$",
+          "description": "Stable error code from the frozen contracts error registry."
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "type": "string",
+          "description": "Optional JSON pointer into the offending document."
+        },
+        "details": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/adapters/cursor/src/schemas/platform-difference-registry.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/platform-difference-registry.json",
+  "title": "PlatformDifferenceRegistry",
+  "description": "Platform difference registry (audit SG-08, clause PSG-02). Records how each supported platform differs across the seven mandatory dimensions: directory, manifest, discovery, invocation, internalIsolation, capabilityGaps, degradationConditions. Degradation entries may only express platform implementation differences or an unverified state; they must never lower the primary platform's status and must never loosen the common business semantics. Aligned with the audit-side platform-difference-registry contract; this foundation object freezes the same seven-dimension shape under the foundation envelope.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "kind",
+    "primaryPlatforms",
+    "requiredDimensions",
+    "platforms"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.platform-difference-registry" },
+    "description": { "type": "string" },
+    "primaryPlatforms": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "requiredDimensions": {
+      "type": "array",
+      "minItems": 7,
+      "maxItems": 7,
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "directory",
+          "manifest",
+          "discovery",
+          "invocation",
+          "internalIsolation",
+          "capabilityGaps",
+          "degradationConditions"
+        ]
+      }
+    },
+    "platforms": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "$ref": "#/$defs/platformEntry" }
+    },
+    "registryDigest": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$",
+      "description": "sha256 hex of the canonical JSON of all top-level fields except registryDigest itself."
+    },
+    "thirdPartyNotes": { "type": "string" },
+    "thirdPartyContract": {
+      "type": "string",
+      "description": "Path or $id reference by which a third-party instance points at this contract."
+    }
+  },
+  "$defs": {
+    "platformEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "platformId",
+        "primaryPlatform",
+        "directory",
+        "manifest",
+        "discovery",
+        "invocation",
+        "internalIsolation",
+        "capabilityGaps",
+        "degradationConditions"
+      ],
+      "properties": {
+        "platformId": { "type": "string", "minLength": 1 },
+        "primaryPlatform": { "type": "boolean" },
+        "lowersPrimaryPlatformStatus": {
+          "const": false,
+          "description": "Must be false: a difference entry may never lower the primary platform's status."
+        },
+        "loosensCommonBusinessSemantics": {
+          "const": false,
+          "description": "Must be false: a difference entry may never loosen the common business semantics."
+        },
+        "directory": { "type": "string", "minLength": 1 },
+        "manifest": { "$ref": "#/$defs/dimensionFact" },
+        "discovery": { "$ref": "#/$defs/dimensionFact" },
+        "invocation": { "$ref": "#/$defs/dimensionFact" },
+        "internalIsolation": { "$ref": "#/$defs/dimensionFact" },
+        "capabilityGaps": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "degradationConditions": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "dimensionFact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": { "type": "string", "minLength": 1 },
+        "format": { "type": "string" },
+        "mechanism": { "type": "string" }
+      }
+    }
+  }
+}