release-skill 0.9.17 → 0.9.18

package/adapters/cursor/src/schemas/host-capability-fact.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-capability-fact.json",
+  "title": "Skill Family host capability fact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "hostId", "capability", "state", "evidence"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-capability-fact" },
+    "hostId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "capability": { "enum": ["cli", "version", "payload", "registry", "discover", "enabled", "reload", "smoke", "uninstall"] },
+    "state": { "enum": ["available", "unavailable", "unknown", "error"] },
+    "evidence": { "type": "array", "minItems": 1, "maxItems": 8, "items": { "type": "string", "minLength": 1, "maxLength": 300 } },
+    "observedVersion": { "type": "string", "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$" },
+    "unknownReason": { "enum": ["timeout", "permission-denied", "interactive-required", "spawn-restricted", "not-probed", "driver-limited"] },
+    "manualSteps": { "type": "array", "minItems": 1, "maxItems": 8, "items": { "type": "string", "minLength": 1, "maxLength": 300 } }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "unknown" } }, "required": ["state"] },
+      "then": { "properties": { "unknownReason": true, "manualSteps": true }, "required": ["unknownReason", "manualSteps"] },
+      "else": { "properties": { "unknownReason": false, "manualSteps": false } }
+    },
+    {
+      "if": { "properties": { "capability": { "const": "version" }, "state": { "const": "available" } }, "required": ["capability", "state"] },
+      "then": { "properties": { "observedVersion": true }, "required": ["observedVersion"] },
+      "else": { "properties": { "observedVersion": false } }
+    }
+  ]
+}

package/adapters/cursor/src/schemas/host-descriptor.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-descriptor.json",
+  "title": "Skill Family host descriptor",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "hostId", "displayName", "support", "pathCategories", "probeCapabilities"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-descriptor" },
+    "hostId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "displayName": { "type": "string", "minLength": 1, "maxLength": 80 },
+    "support": { "enum": ["supported", "manual", "unsupported"] },
+    "maturity": { "enum": ["stable", "manual", "developer-preview", "unsupported"] },
+    "sourceAliases": {
+      "type": "array",
+      "maxItems": 8,
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" }
+    },
+    "unsupportedReason": { "type": "string", "minLength": 1 },
+    "driverId": { "enum": ["claude-version-v1", "codex-version-v1"] },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["driverId", "authStrategy", "credentialMutation"],
+      "properties": {
+        "driverId": { "enum": ["kimi-code-print-v1", "workbuddy-codebuddy-print-v1", "codebuddy-print-v1", "claude-code-print-v1", "codex-exec-v1", "qodercli-print-v1", "cursor-agent-print-v1"] },
+        "authStrategy": { "const": "existing-user-state" },
+        "credentialMutation": { "const": "host-managed" }
+      }
+    },
+    "adapterFormat": { "const": "skill-directory-v1" },
+    "pathCategories": {
+      "type": "array",
+      "maxItems": 8,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "role", "scope", "anchor", "relPath"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+          "role": { "const": "skill-root" },
+          "scope": { "enum": ["user", "project"] },
+          "anchor": { "enum": ["user-home", "project-root"] },
+          "relPath": { "$ref": "#/$defs/relativePath" }
+        },
+        "allOf": [
+          { "if": { "properties": { "scope": { "const": "user" } }, "required": ["scope"] }, "then": { "properties": { "anchor": { "const": "user-home" } } } },
+          { "if": { "properties": { "scope": { "const": "project" } }, "required": ["scope"] }, "then": { "properties": { "anchor": { "const": "project-root" } } } }
+        ]
+      }
+    },
+    "probeCapabilities": {
+      "type": "array",
+      "items": { "enum": ["cli", "version", "payload", "registry", "discover", "enabled", "reload", "smoke", "uninstall"] },
+      "uniqueItems": true
+    }
+  },
+  "$defs": {
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 240,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)(?!.*\\u0000)[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$"
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "hostId": { "const": "kimi-code" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "kimi-code-print-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "const": "workbuddy" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "workbuddy-codebuddy-print-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "const": "codebuddy" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "codebuddy-print-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "const": "claude" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "claude-code-print-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "const": "codex" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "codex-exec-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "const": "qoder" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "qodercli-print-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "const": "cursor" } }, "required": ["hostId"] },
+      "then": {
+        "required": ["verification"],
+        "properties": { "verification": { "type": "object", "properties": { "driverId": { "const": "cursor-agent-print-v1" } } } }
+      }
+    },
+    {
+      "if": { "properties": { "hostId": { "enum": ["kimi-code", "workbuddy", "codebuddy", "claude", "codex", "qoder", "cursor"] } }, "required": ["hostId"] },
+      "else": { "properties": { "verification": false } }
+    },
+    {
+      "if": { "properties": { "support": { "const": "supported" } }, "required": ["support"] },
+      "then": {
+        "required": ["driverId", "adapterFormat"],
+        "properties": { "unsupportedReason": false, "maturity": { "enum": ["stable"] }, "driverId": true, "adapterFormat": true, "pathCategories": { "type": "array", "minItems": 1 }, "probeCapabilities": { "type": "array", "minItems": 9, "maxItems": 9 } }
+      }
+    },
+    {
+      "if": { "properties": { "support": { "const": "manual" } }, "required": ["support"] },
+      "then": {
+        "required": ["maturity"],
+        "properties": { "unsupportedReason": false, "maturity": { "enum": ["manual", "developer-preview"] }, "driverId": false, "adapterFormat": false, "pathCategories": { "type": "array", "maxItems": 8 }, "probeCapabilities": { "type": "array", "minItems": 9, "maxItems": 9 } }
+      }
+    },
+    {
+      "if": { "properties": { "support": { "const": "unsupported" } }, "required": ["support"] },
+      "then": {
+        "required": ["unsupportedReason"],
+        "properties": { "unsupportedReason": true, "maturity": { "enum": ["unsupported"] }, "driverId": false, "adapterFormat": false, "pathCategories": { "type": "array", "maxItems": 0 }, "probeCapabilities": { "type": "array", "maxItems": 0 } }
+      }
+    }
+  ]
+}

package/adapters/cursor/src/schemas/host-operation-plan.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-operation-plan.json",
+  "title": "Skill Family host operation plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "hostId", "status", "probeFacts", "actions", "writeSet", "digest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-operation-plan" },
+    "hostId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "status": { "enum": ["planned", "manual", "unsupported"] },
+    "operation": { "enum": ["install", "update", "uninstall"] },
+    "unsupportedReason": { "type": "string", "minLength": 1 },
+    "pathCategory": { "$ref": "#/$defs/category" },
+    "probeFacts": { "type": "array", "items": { "$ref": "https://contracts.skill-family.example/v1/host-capability-fact.json" } },
+    "actions": { "type": "array", "items": { "$ref": "#/$defs/action" } },
+    "writeSet": { "type": "array", "items": { "$ref": "#/$defs/write" } },
+    "digest": { "$ref": "#/$defs/sha256" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "relativePath": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)(?!.*\\u0000)[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$" },
+    "category": {
+      "type": "object", "additionalProperties": false, "required": ["id", "scope", "anchor", "relPath"],
+      "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" }, "scope": { "enum": ["user", "project"] }, "anchor": { "enum": ["user-home", "project-root"] }, "relPath": { "$ref": "#/$defs/relativePath" } }
+    },
+    "action": {
+      "type": "object", "additionalProperties": false,
+      "required": ["sequence", "kind", "categoryId", "scope", "anchor", "target", "expect", "sourceSha256"],
+      "properties": {
+        "sequence": { "type": "integer", "minimum": 1 }, "kind": { "const": "install-file" },
+        "categoryId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" }, "scope": { "enum": ["user", "project"] }, "anchor": { "enum": ["user-home", "project-root"] },
+        "target": { "$ref": "#/$defs/relativePath" }, "expect": { "enum": ["absent", "matching"] }, "sourceSha256": { "$ref": "#/$defs/sha256" }, "expectedSha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "write": {
+      "type": "object", "additionalProperties": false, "required": ["categoryId", "scope", "anchor", "target", "sourceSha256"],
+      "properties": { "categoryId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" }, "scope": { "enum": ["user", "project"] }, "anchor": { "enum": ["user-home", "project-root"] }, "target": { "$ref": "#/$defs/relativePath" }, "sourceSha256": { "$ref": "#/$defs/sha256" }, "expectedSha256": { "$ref": "#/$defs/sha256" } }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "planned" } }, "required": ["status"] },
+      "then": { "required": ["pathCategory"], "properties": { "pathCategory": true, "unsupportedReason": false, "probeFacts": { "type": "array", "minItems": 9, "maxItems": 9 }, "actions": { "type": "array", "minItems": 1 }, "writeSet": { "type": "array", "minItems": 1 } } },
+      "else": { "required": ["unsupportedReason"], "properties": { "unsupportedReason": true, "pathCategory": false, "probeFacts": { "type": "array", "maxItems": 0 }, "actions": { "type": "array", "maxItems": 0 }, "writeSet": { "type": "array", "maxItems": 0 } } }
+    },
+    {
+      "if": { "properties": { "status": { "const": "manual" } }, "required": ["status"] },
+      "then": { "properties": { "operation": { "enum": ["install", "update", "uninstall"] } } }
+    },
+    {
+      "if": { "properties": { "operation": { "enum": ["update", "uninstall"] } }, "required": ["operation"] },
+      "then": { "properties": { "actions": { "type": "array", "items": { "type": "object", "properties": { "expectedSha256": { "$ref": "#/$defs/sha256" } }, "required": ["expectedSha256"] } }, "writeSet": { "type": "array", "items": { "type": "object", "properties": { "expectedSha256": { "$ref": "#/$defs/sha256" } }, "required": ["expectedSha256"] } } } }
+    }
+  ]
+}

package/adapters/cursor/src/schemas/host-operation-receipt.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-operation-receipt.json",
+  "title": "Skill Family host operation receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "hostId", "planDigest", "overall", "writes"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-operation-receipt" },
+    "hostId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "planDigest": { "$ref": "#/$defs/sha256" },
+    "overall": { "enum": ["rejected", "failed", "succeeded", "partially_applied"] },
+    "reason": { "type": "string", "minLength": 1 },
+    "authorizationRef": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "writes": { "type": "array", "items": { "$ref": "#/$defs/write" } },
+    "closure": { "$ref": "#/$defs/closure" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "relativePath": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)(?!.*\\u0000)[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$" },
+    "write": {
+      "type": "object", "additionalProperties": false, "required": ["target", "outcome"],
+      "properties": { "target": { "$ref": "#/$defs/relativePath" }, "outcome": { "enum": ["planned", "attempted", "succeeded", "failed"] }, "sha256": { "$ref": "#/$defs/sha256" }, "reason": { "type": "string", "minLength": 1 } },
+      "allOf": [
+        { "if": { "properties": { "outcome": { "const": "succeeded" } }, "required": ["outcome"] }, "then": { "properties": { "sha256": true }, "required": ["sha256"] }, "else": { "properties": { "sha256": false } } },
+        { "if": { "properties": { "outcome": { "const": "failed" } }, "required": ["outcome"] }, "then": { "properties": { "reason": true }, "required": ["reason"] } }
+      ]
+    },
+    "closure": {
+      "type": "object", "additionalProperties": false, "required": ["digestAlgorithm", "digest", "resources"],
+      "properties": {
+        "digestAlgorithm": { "const": "sha256" }, "digest": { "$ref": "#/$defs/sha256" },
+        "resources": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["path", "sha256"], "properties": { "path": { "$ref": "#/$defs/relativePath" }, "sha256": { "$ref": "#/$defs/sha256" } } } }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "overall": { "const": "rejected" } }, "required": ["overall"] },
+      "then": {
+        "required": ["reason"],
+        "properties": { "reason": true, "authorizationRef": false, "closure": false, "writes": { "type": "array", "maxItems": 0 } }
+      }
+    },
+    {
+      "if": { "properties": { "overall": { "const": "succeeded" } }, "required": ["overall"] },
+      "then": {
+        "required": ["authorizationRef", "closure"],
+        "properties": { "authorizationRef": true, "closure": true, "writes": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "outcome": { "const": "succeeded" } }, "required": ["outcome"] } } }
+      }
+    },
+    {
+      "if": { "properties": { "overall": { "const": "failed" } }, "required": ["overall"] },
+      "then": {
+        "required": ["reason"],
+        "properties": { "reason": true, "writes": { "type": "array", "contains": { "type": "object", "properties": { "outcome": { "const": "failed" } }, "required": ["outcome"] } } },
+        "not": { "properties": { "writes": { "type": "array", "contains": { "type": "object", "properties": { "outcome": { "const": "succeeded" } }, "required": ["outcome"] } } } }
+      }
+    },
+    {
+      "if": { "properties": { "overall": { "const": "partially_applied" } }, "required": ["overall"] },
+      "then": {
+        "required": ["reason", "authorizationRef", "closure"],
+        "properties": {
+          "reason": true,
+          "authorizationRef": true,
+          "closure": true,
+          "writes": {
+            "type": "array",
+            "minItems": 2,
+            "allOf": [
+              { "contains": { "type": "object", "properties": { "outcome": { "const": "succeeded" } }, "required": ["outcome"] } },
+              { "contains": { "type": "object", "properties": { "outcome": { "enum": ["failed", "attempted", "planned"] } }, "required": ["outcome"] } }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}

package/adapters/cursor/src/schemas/host-probe-result.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-probe-result.json",
+  "title": "Skill Family host probe result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "hostId", "support", "facts"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-probe-result" },
+    "hostId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "support": { "enum": ["supported", "manual", "unsupported"] },
+    "reason": { "type": "string", "minLength": 1 },
+    "facts": {
+      "type": "array",
+      "items": { "$ref": "https://contracts.skill-family.example/v1/host-capability-fact.json" }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "support": { "const": "supported" } }, "required": ["support"] },
+      "then": { "properties": { "reason": false, "facts": { "type": "array", "minItems": 9, "maxItems": 9 } } },
+      "else": {
+        "if": { "properties": { "support": { "const": "manual" } }, "required": ["support"] },
+        "then": { "required": ["reason"], "properties": { "reason": true, "facts": { "type": "array", "minItems": 9, "maxItems": 9 } } },
+        "else": { "required": ["reason"], "properties": { "reason": true, "facts": { "type": "array", "maxItems": 0 } } }
+      }
+    }
+  ]
+}

package/adapters/cursor/src/schemas/host-registry.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-registry.json",
+  "title": "Skill Family host registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "hosts"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-registry" },
+    "hosts": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" }
+    }
+  }
+}

package/adapters/cursor/src/schemas/host-verification-request.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-verification-request.json",
+  "title": "Host verification request",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "operation", "common", "host", "auth", "execution"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-verification-request" },
+    "operation": { "const": "host-verification" },
+    "common": { "$ref": "#/$defs/common" },
+    "host": { "$ref": "#/$defs/host" },
+    "auth": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["strategy", "credentialMutation"],
+      "properties": {
+        "strategy": { "const": "existing-user-state" },
+        "credentialMutation": { "const": "host-managed" }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["timeoutPolicy", "modelOverridePolicy"],
+      "properties": {
+        "timeoutPolicy": { "$ref": "https://contracts.skill-family.example/v1/timeout-policy.json" },
+        "modelOverridePolicy": { "const": "forbidden" }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "digest": { "$ref": "#/$defs/sha256" },
+    "opaque": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "common": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["verificationSetId", "candidateRef", "candidateManifestSha256", "workloadDocumentSha256", "fixtureClosureDigest", "protectedWorkspaceClosureDigest"],
+      "properties": {
+        "verificationSetId": { "$ref": "#/$defs/opaque" },
+        "candidateRef": { "$ref": "#/$defs/opaque" },
+        "candidateManifestSha256": { "$ref": "#/$defs/sha256" },
+        "workloadDocumentSha256": { "$ref": "#/$defs/sha256" },
+        "fixtureClosureDigest": { "$ref": "#/$defs/digest" },
+        "protectedWorkspaceClosureDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "host": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["hostId", "descriptorSha256", "driverId", "driverVersion", "platformManifestSha256", "adapterClosureDigest", "installedSkillClosureDigest", "effectivePromptSha256", "executableSha256"],
+      "properties": {
+        "hostId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+        "descriptorSha256": { "$ref": "#/$defs/sha256" },
+        "driverId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,127}$" },
+        "driverVersion": { "type": "string", "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?$" },
+        "platformManifestSha256": { "$ref": "#/$defs/sha256" },
+        "adapterClosureDigest": { "$ref": "#/$defs/digest" },
+        "installedSkillClosureDigest": { "$ref": "#/$defs/digest" },
+        "effectivePromptSha256": { "$ref": "#/$defs/sha256" },
+        "executableSha256": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}

package/adapters/cursor/src/schemas/host-verification-result.schema.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/host-verification-result.json",
+  "title": "Host verification result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "operation", "status", "requestDigest", "common", "host", "runtimeIdentities", "execution", "snapshots", "streams", "reason", "requiredActions"],
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "observed" } } },
+      "then": {
+        "properties": {
+          "runtimeIdentities": { "type": "object" },
+          "execution": {
+            "type": "object",
+            "properties": {
+              "spawned": { "const": true },
+              "exitStatus": { "const": 0 },
+              "processStatus": { "const": "EXITED" },
+              "terminationReason": { "const": null },
+              "watchdogReason": { "const": null },
+              "runnerModelOverrideAbsent": { "const": true }
+            }
+          },
+          "snapshots": { "type": "object" },
+          "streams": { "type": "object" },
+          "reason": { "const": null },
+          "requiredActions": { "type": "array", "maxItems": 0 }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "indeterminate" } } },
+      "then": {
+        "properties": {
+          "reason": { "const": "boundary-state-indeterminate" },
+          "requiredActions": { "type": "array", "minItems": 1 }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "rejected" } } },
+      "then": {
+        "properties": {
+          "runtimeIdentities": { "const": null },
+          "execution": {
+            "type": "object",
+            "properties": {
+              "spawned": { "const": false },
+              "exitStatus": { "const": null },
+              "processStatus": { "const": null },
+              "terminationReason": { "const": null },
+              "watchdogReason": { "const": null }
+            }
+          },
+          "snapshots": { "const": null },
+          "streams": { "const": null },
+          "reason": { "enum": ["preflight-rejected", "executable-observation-mismatch"] },
+          "requiredActions": { "type": "array", "maxItems": 0 }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "failed" } } },
+      "then": {
+        "properties": {
+          "reason": { "enum": ["executable-observation-mismatch", "execution-failed", "snapshot-mismatch", "private-evidence-publication-failed"] },
+          "requiredActions": { "type": "array", "maxItems": 0 }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "reason": { "const": "snapshot-mismatch" } } },
+      "then": {
+        "properties": {
+          "execution": {
+            "type": "object",
+            "properties": { "spawned": { "const": true } }
+          }
+        }
+      }
+    }
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.host-verification-result" },
+    "operation": { "const": "host-verification" },
+    "status": { "enum": ["observed", "rejected", "failed", "indeterminate"] },
+    "requestDigest": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256" },
+    "common": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/common" },
+    "host": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/host" },
+    "runtimeIdentities": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["cliVersion"],
+      "properties": { "cliVersion": { "type": "string", "minLength": 1, "maxLength": 256 } }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["spawned", "exitStatus", "processStatus", "terminationReason", "watchdogReason", "runnerModelOverrideAbsent"],
+      "properties": {
+        "spawned": { "type": "boolean" },
+        "exitStatus": { "type": ["integer", "null"], "minimum": 0 },
+        "processStatus": { "type": ["string", "null"], "enum": ["PLANNED", "STARTING", "RUNNING", "EXITED", "FAILED_TO_START", "TIMED_OUT", "TERMINATED", null] },
+        "terminationReason": { "$ref": "https://contracts.skill-family.example/v1/watchdog-termination-envelope.json#/properties/terminationReason", "not": { "const": "output_limit_exceeded" } },
+        "watchdogReason": { "$ref": "https://contracts.skill-family.example/v1/watchdog-termination-envelope.json#/properties/watchdogReason", "not": { "const": "output_limit_exceeded" } },
+        "runnerModelOverrideAbsent": { "type": "boolean" }
+      }
+    },
+    "snapshots": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["installedSkill", "fixture", "protectedWorkspace"],
+      "properties": {
+        "installedSkill": { "$ref": "#/$defs/snapshot" },
+        "fixture": { "$ref": "#/$defs/snapshot" },
+        "protectedWorkspace": { "$ref": "#/$defs/snapshot" }
+      }
+    },
+    "streams": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["stdout", "stderr"],
+      "properties": { "stdout": { "$ref": "#/$defs/stream" }, "stderr": { "$ref": "#/$defs/stream" } }
+    },
+    "reason": { "enum": [null, "preflight-rejected", "executable-observation-mismatch", "execution-failed", "snapshot-mismatch", "private-evidence-publication-failed", "boundary-state-indeterminate"] },
+    "requiredActions": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "enum": ["manual-temporary-root-inspection-required"] }
+    }
+  },
+  "$defs": {
+    "snapshot": {
+      "type": "object", "additionalProperties": false,
+      "required": ["preClosureDigest", "postClosureDigest"],
+      "properties": {
+        "preClosureDigest": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256" },
+        "postClosureDigest": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256" }
+      }
+    },
+    "stream": {
+      "type": "object", "additionalProperties": false,
+      "required": ["sha256", "bytes", "sensitivity"],
+      "properties": { "sha256": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256" }, "bytes": { "type": "integer", "minimum": 0 }, "sensitivity": { "const": "private" } }
+    }
+  }
+}