release-skill 0.9.1 → 0.9.4

package/adapters/claude/src/schemas/plugin-verification-result.schema.json

@@ -50,12 +50,7 @@
     "facts": {
       "type": "object",
       "additionalProperties": false,
-      "required": [
-        "input",
-        "install",
-        "discovery",
-        "invocation"
-      ],
+      "required": [],
       "properties": {
         "input": {
           "type": "object",
@@ -305,6 +300,9 @@
               ]
             }
           }
+        },
+        "lifecycle": {
+          "$ref": "#/$defs/lifecycle"
         }
       }
     },
@@ -337,6 +335,221 @@
     }
   },
   "allOf": [
+    {
+      "if": {
+        "type": "object",
+        "properties": { "goal": { "const": "native-lifecycle" } },
+        "required": ["goal"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "object",
+            "properties": { "type": { "const": "local-marketplace" } }
+          },
+          "host": {
+            "type": "object",
+            "properties": {
+              "cliVersion": false,
+              "executableSha256": false
+            }
+          },
+          "facts": {
+            "type": "object",
+            "required": ["lifecycle"],
+            "properties": {
+              "lifecycle": {},
+              "input": false,
+              "install": false,
+              "discovery": false,
+              "invocation": false
+            }
+          }
+        }
+      },
+      "else": {
+        "type": "object",
+        "properties": {
+          "facts": {
+            "type": "object",
+            "required": ["input", "install", "discovery", "invocation"],
+            "properties": { "input": {}, "install": {}, "discovery": {}, "invocation": {}, "lifecycle": false }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "type": "object",
+        "properties": {
+          "goal": { "const": "native-lifecycle" },
+          "status": { "const": "rejected" }
+        },
+        "required": ["goal", "status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "const": "preflight-rejected" },
+          "requiredActions": { "type": "array", "maxItems": 0 },
+          "facts": {
+            "type": "object",
+            "properties": {
+              "lifecycle": {
+                "type": "object",
+                "properties": {
+                  "stages": {
+                    "type": "array",
+                    "minItems": 12,
+                    "maxItems": 12,
+                    "prefixItems": [
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" },
+                      { "$ref": "#/$defs/stageNotPerformed" }
+                    ],
+                    "items": false
+                  },
+                  "cleanup": {
+                    "type": "object",
+                    "properties": { "pluginAbsent": { "const": false } }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "type": "object",
+        "properties": {
+          "goal": { "const": "native-lifecycle" },
+          "status": { "const": "failed" }
+        },
+        "required": ["goal", "status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "const": "execution-failed" },
+          "requiredActions": { "type": "array", "maxItems": 0 },
+          "facts": {
+            "type": "object",
+            "properties": {
+              "lifecycle": {
+                "type": "object",
+                "properties": {
+                  "stages": {
+                    "type": "array",
+                    "contains": {
+                      "type": "object",
+                      "properties": { "status": { "const": "failed" } },
+                      "required": ["status"]
+                    },
+                    "minContains": 1
+                  },
+                  "cleanup": {
+                    "type": "object",
+                    "properties": { "pluginAbsent": { "const": false } }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "type": "object",
+        "properties": {
+          "goal": { "const": "native-lifecycle" },
+          "status": { "const": "indeterminate" }
+        },
+        "required": ["goal", "status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "const": "boundary-state-indeterminate" },
+          "requiredActions": { "const": ["manual-temporary-root-inspection-required"] },
+          "facts": {
+            "type": "object",
+            "properties": {
+              "lifecycle": {
+                "type": "object",
+                "properties": {
+                  "stages": {
+                    "type": "array",
+                    "contains": {
+                      "type": "object",
+                      "properties": { "status": { "const": "indeterminate" } },
+                      "required": ["status"]
+                    },
+                    "minContains": 1
+                  },
+                  "cleanup": {
+                    "type": "object",
+                    "properties": { "pluginAbsent": { "const": false } }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "type": "object",
+        "properties": {
+          "goal": { "const": "native-lifecycle" },
+          "status": { "const": "observed" }
+        },
+        "required": ["goal", "status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "facts": {
+            "type": "object",
+            "required": ["lifecycle"],
+            "properties": {
+              "lifecycle": {
+                "type": "object",
+                "required": ["stages", "cleanup"],
+                "properties": {
+                  "stages": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "required": ["status"],
+                      "properties": { "status": { "const": "observed" } }
+                    }
+                  },
+                  "cleanup": {
+                    "type": "object",
+                    "required": ["pluginAbsent"],
+                    "properties": { "pluginAbsent": { "const": true } }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     {
       "if": {
         "properties": {
@@ -531,13 +744,13 @@
     },
     {
       "if": {
-        "properties": {
-          "status": {
-            "const": "failed"
-          }
-        },
+        "allOf": [
+          { "properties": { "status": { "const": "failed" } }, "required": ["status"] },
+          { "properties": { "goal": { "enum": ["install-only", "install-and-invoke"] } }, "required": ["goal"] }
+        ],
         "required": [
-          "status"
+          "status",
+          "goal"
         ],
         "type": "object"
       },
@@ -670,12 +883,10 @@
       ],
       "properties": {
         "step": {
-          "enum": [
-            "version-probe",
-            "marketplace-add",
-            "plugin-install",
-            "plugin-list"
-          ]
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
         },
         "execution": {
           "$ref": "#/$defs/execution"
@@ -794,6 +1005,213 @@
           "$ref": "https://contracts.skill-family.example/v1/filesystem-tree-observation.json"
         }
       }
+    },
+    "lifecycle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["scope", "stages", "cleanup"],
+      "properties": {
+        "scope": { "const": "local" },
+        "stages": {
+          "type": "array",
+          "minItems": 12,
+          "maxItems": 12,
+          "prefixItems": [
+            { "$ref": "#/$defs/stagePreflight" },
+            { "$ref": "#/$defs/stageValidateV1" },
+            { "$ref": "#/$defs/stageMarketplaceAdd" },
+            { "$ref": "#/$defs/stageInstallV1" },
+            { "$ref": "#/$defs/stageDiscoverV1" },
+            { "$ref": "#/$defs/stageInvokeV1" },
+            { "$ref": "#/$defs/stageDisable" },
+            { "$ref": "#/$defs/stageEnable" },
+            { "$ref": "#/$defs/stageUpdateV2" },
+            { "$ref": "#/$defs/stageInvokeV2" },
+            { "$ref": "#/$defs/stageUninstall" },
+            { "$ref": "#/$defs/stageAbsentAfterUninstall" }
+          ],
+          "items": false
+        },
+        "cleanup": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["pluginAbsent"],
+          "properties": { "pluginAbsent": { "type": "boolean" } }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{ "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }, {}], "items": false } } }
+        },
+        {
+          "if": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageStopped" }, {}], "items": false } } },
+          "then": { "properties": { "stages": { "type": "array", "minItems": 12, "maxItems": 12, "prefixItems": [{}, {}, {}, {}, {}, {}, {}, {}, {}, {}, {}, { "$ref": "#/$defs/stageNotPerformed" }], "items": false } } }
+        }
+      ]
+    },
+    "stageStopped": {
+      "type": "object",
+      "required": ["status"],
+      "properties": { "status": { "enum": ["failed", "indeterminate", "not-performed"] } }
+    },
+    "stageNotPerformed": {
+      "type": "object",
+      "required": ["status"],
+      "properties": { "status": { "const": "not-performed" } }
+    },
+    "stageBase": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "status", "commands", "trees"],
+      "properties": {
+        "name": {
+          "enum": [
+            "preflight", "validate-v1", "marketplace-add", "install-v1",
+            "discover-v1", "invoke-v1", "disable", "enable", "update-v2",
+            "invoke-v2", "uninstall", "absent-after-uninstall"
+          ]
+        },
+        "status": { "enum": ["observed", "failed", "indeterminate", "not-performed"] },
+        "commands": { "type": "array", "maxItems": 3, "items": { "$ref": "#/$defs/commandObservation" } },
+        "trees": { "type": "array", "maxItems": 6, "uniqueItems": true, "items": { "$ref": "#/$defs/treeEvidence" } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "const": "not-performed" } }, "required": ["status"] },
+          "then": {
+            "properties": {
+              "commands": { "type": "array", "maxItems": 0 },
+              "trees": { "type": "array", "maxItems": 0 }
+            }
+          }
+        }
+      ]
+    },
+    "stagePreflight": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "preflight" }, "trees": { "type": "array", "maxItems": 0 } } }
+      ]
+    },
+    "stageValidateV1": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "validate-v1" } } }
+      ]
+    },
+    "stageMarketplaceAdd": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "marketplace-add" } } }
+      ]
+    },
+    "stageInstallV1": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "install-v1" } } }
+      ]
+    },
+    "stageDiscoverV1": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "discover-v1" } } }
+      ]
+    },
+    "stageInvokeV1": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "invoke-v1" } } }
+      ]
+    },
+    "stageDisable": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "disable" } } }
+      ]
+    },
+    "stageEnable": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "enable" } } }
+      ]
+    },
+    "stageUpdateV2": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "update-v2" } } }
+      ]
+    },
+    "stageInvokeV2": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "invoke-v2" } } }
+      ]
+    },
+    "stageUninstall": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "uninstall" } } }
+      ]
+    },
+    "stageAbsentAfterUninstall": {
+      "allOf": [
+        { "$ref": "#/$defs/stageBase" },
+        { "type": "object", "properties": { "name": { "const": "absent-after-uninstall" } } }
+      ]
+    },
+    "treeEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["role", "status"],
+      "properties": {
+        "role": { "enum": ["source-v1", "source-v2", "installed", "cache", "config", "data"] },
+        "status": { "enum": ["observed", "absent", "not-applicable"] },
+        "observationDigest": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      },
+      "allOf": [
+        {
+          "if": { "type": "object", "properties": { "status": { "const": "observed" } }, "required": ["status"] },
+          "then": { "type": "object", "required": ["observationDigest"], "properties": { "observationDigest": {} } },
+          "else": { "type": "object", "properties": { "observationDigest": false } }
+        }
+      ]
     }
   }
 }

package/adapters/claude/src/schemas/skill-family-directory-verification-request.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/skill-family-directory-verification-request.json",
+  "title": "Skill-family directory verification request",
+  "description": "A public, closed request for the Kimi skill-family directory adapter. Family roots, member tables, executable identity inputs and authentication sources are private bindings and never occur here.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "operation", "verificationSetId", "host", "expectedSkills", "familyTree", "workload", "auth"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.skill-family-directory-verification-request" },
+    "operation": { "const": "skill-family-directory-verification" },
+    "verificationSetId": { "$ref": "#/$defs/opaque" },
+    "host": { "$ref": "#/$defs/host" },
+    "expectedSkills": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "sourceSha256"],
+        "properties": {
+          "name": { "$ref": "#/$defs/skillName" },
+          "sourceSha256": { "$ref": "#/$defs/sha256" }
+        }
+      }
+    },
+    "familyTree": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sourceManifestSha256", "membersDigest"],
+      "properties": {
+        "sourceManifestSha256": { "$ref": "#/$defs/sha256" },
+        "membersDigest": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "workload": { "$ref": "#/$defs/workload" },
+    "auth": { "$ref": "#/$defs/auth" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "opaque": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[^\\u0000\\r\\n]+$" },
+    "skillName": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "host": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["hostId", "descriptorSha256", "driverId", "driverVersion", "cliVersion"],
+      "properties": {
+        "hostId": { "const": "kimi-code" },
+        "descriptorSha256": { "$ref": "#/$defs/sha256" },
+        "driverId": { "const": "kimi-code-print-v1" },
+        "driverVersion": { "const": "1.0.0" },
+        "cliVersion": { "const": "0.39.1" }
+      }
+    },
+    "semver": { "type": "string", "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?$" },
+    "timeoutPolicy": {
+      "$ref": "https://contracts.skill-family.example/v1/timeout-policy.json"
+    },
+    "workload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["effectivePromptSha256", "fixtureClosureDigest", "protectedWorkspaceClosureDigest", "timeoutPolicy", "modelOverridePolicy", "restrictions"],
+      "properties": {
+        "effectivePromptSha256": { "$ref": "#/$defs/sha256" },
+        "fixtureClosureDigest": { "$ref": "#/$defs/sha256" },
+        "protectedWorkspaceClosureDigest": { "$ref": "#/$defs/sha256" },
+        "timeoutPolicy": { "$ref": "#/$defs/timeoutPolicy" },
+        "modelOverridePolicy": { "const": "forbidden" },
+        "restrictions": { "$ref": "#/$defs/restrictions" }
+      }
+    },
+    "restrictions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "approvalPolicy": { "const": "deny-unattended" },
+        "tools": { "const": "skill-only" },
+        "mcp": { "const": "disabled" },
+        "settingsSources": { "const": "empty" },
+        "sessionPersistence": { "const": "disabled" },
+        "history": { "const": "fresh" },
+        "browserIntegration": { "const": "disabled" },
+        "maxTurns": { "type": "integer", "minimum": 1, "maximum": 100 },
+        "maxBudgetUsd": { "type": "number", "exclusiveMinimum": 0, "maximum": 100 }
+      }
+    },
+    "auth": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["strategy", "credentialMutation"],
+      "properties": {
+        "strategy": { "const": "existing-user-state" },
+        "credentialMutation": { "const": "host-managed" }
+      }
+    }
+  }
+}