release-skill 0.9.16 → 0.9.17

package/adapters/qoder/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" }
+      }
+    }
+  }
+}

package/adapters/qoder/src/schemas/plugin-verification-request.schema.json

@@ -0,0 +1,499 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/plugin-verification-request.json",
+  "title": "Plugin verification request",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "kind",
+    "operation",
+    "verificationSetId",
+    "goal",
+    "source",
+    "host",
+    "install"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "kind": {
+      "const": "skill-family.plugin-verification-request"
+    },
+    "operation": {
+      "const": "plugin-verification"
+    },
+    "verificationSetId": {
+      "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+    },
+    "goal": {
+      "enum": [
+        "install-only",
+        "install-and-invoke",
+        "native-lifecycle"
+      ]
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "enum": [
+            "local-staged",
+            "public-channel",
+            "local-marketplace"
+          ]
+        },
+        "candidateRef": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+        },
+        "sourceManifestSha256": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        },
+        "membersDigest": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        },
+        "marketplaceId": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+        },
+        "pluginId": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+        },
+        "revisions": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["v1", "v2"],
+          "properties": {
+            "v1": { "$ref": "#/$defs/marketplaceRevision" },
+            "v2": { "$ref": "#/$defs/marketplaceRevision" }
+          }
+        },
+        "channel": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "marketplaceId",
+            "pluginId",
+            "version",
+            "sourceRef",
+            "locatorSha256"
+          ],
+          "properties": {
+            "marketplaceId": {
+              "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+            },
+            "pluginId": {
+              "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+            },
+            "version": {
+              "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/host/properties/driverVersion"
+            },
+            "sourceRef": {
+              "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/opaque"
+            },
+            "locatorSha256": {
+              "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+            }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "type": { "const": "local-staged" } },
+            "required": ["type"]
+          },
+          "then": {
+            "required": ["candidateRef", "sourceManifestSha256", "membersDigest"],
+            "properties": {
+              "candidateRef": {}, "sourceManifestSha256": {}, "membersDigest": {},
+              "channel": false, "marketplaceId": false, "pluginId": false, "revisions": false
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "public-channel" } },
+            "required": ["type"]
+          },
+          "then": {
+            "required": ["candidateRef", "sourceManifestSha256", "membersDigest", "channel"],
+            "properties": {
+              "candidateRef": {}, "sourceManifestSha256": {}, "membersDigest": {}, "channel": {},
+              "marketplaceId": false, "pluginId": false, "revisions": false
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "local-marketplace" } },
+            "required": ["type"]
+          },
+          "then": {
+            "required": ["candidateRef", "marketplaceId", "pluginId", "revisions"],
+            "properties": {
+              "candidateRef": {}, "marketplaceId": {}, "pluginId": {}, "revisions": {},
+              "sourceManifestSha256": false, "membersDigest": false, "channel": false
+            }
+          }
+        }
+      ]
+    },
+    "host": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "hostId",
+        "descriptorSha256",
+        "driverId",
+        "driverVersion"
+      ],
+      "properties": {
+        "hostId": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/host/properties/hostId"
+        },
+        "descriptorSha256": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        },
+        "driverId": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/host/properties/driverId"
+        },
+        "driverVersion": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/host/properties/driverVersion"
+        },
+        "cliVersion": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "executableSha256": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        }
+      }
+    },
+    "install": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode"
+      ],
+      "properties": {
+        "mode": {
+          "const": "fresh-tree"
+        },
+        "timeoutPolicy": {
+          "$ref": "https://contracts.skill-family.example/v1/timeout-policy.json"
+        },
+        "outputByteLimits": {
+          "$ref": "https://contracts.skill-family.example/v1/watchdog-termination-envelope.json#/$defs/outputByteLimits"
+        }
+      }
+    },
+    "auth": {
+      "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/properties/auth"
+    },
+    "invocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "effectivePromptSha256",
+        "fixtureClosureDigest",
+        "protectedWorkspaceClosureDigest",
+        "timeoutPolicy",
+        "modelOverridePolicy",
+        "restrictions"
+      ],
+      "properties": {
+        "effectivePromptSha256": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        },
+        "fixtureClosureDigest": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        },
+        "protectedWorkspaceClosureDigest": {
+          "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256"
+        },
+        "timeoutPolicy": {
+          "$ref": "https://contracts.skill-family.example/v1/timeout-policy.json"
+        },
+        "modelOverridePolicy": {
+          "const": "forbidden"
+        },
+        "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
+            }
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": { "goal": { "const": "install-and-invoke" } },
+            "required": ["goal"]
+          },
+          {
+            "type": "object",
+            "properties": { "goal": { "const": "native-lifecycle" } },
+            "required": ["goal"]
+          }
+        ]
+      },
+      "then": {
+        "type": "object",
+        "required": [
+          "invocation"
+        ],
+        "properties": {
+          "invocation": {}
+        }
+      },
+      "else": {
+        "type": "object",
+        "properties": {
+          "invocation": false
+        }
+      }
+    },
+    {
+      "if": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "const": "public-channel"
+              }
+            },
+            "required": [
+              "type"
+            ]
+          }
+        },
+        "required": [
+          "source"
+        ]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "object",
+            "properties": {
+              "channel": {
+                "type": "object"
+              }
+            },
+            "required": [
+              "channel"
+            ]
+          },
+          "install": {
+            "type": "object",
+            "properties": {
+              "timeoutPolicy": {}
+            },
+            "required": [
+              "timeoutPolicy"
+            ]
+          }
+        }
+      },
+      "else": {
+        "type": "object",
+        "if": {
+          "properties": {
+            "source": {
+              "type": "object",
+              "properties": { "type": { "const": "local-staged" } },
+              "required": ["type"]
+            }
+          },
+          "required": ["source"]
+        },
+        "then": {
+        "properties": {
+          "source": {
+            "type": "object",
+            "properties": {
+              "channel": false
+            }
+          },
+          "install": {
+            "type": "object",
+            "properties": {
+              "timeoutPolicy": false,
+              "outputByteLimits": false
+            }
+          }
+        }
+        }
+      }
+    },
+    {
+      "if": {
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": {
+              "goal": {
+                "const": "install-and-invoke"
+              }
+            },
+            "required": [
+              "goal"
+            ]
+          },
+          {
+            "type": "object",
+            "properties": {
+              "source": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "const": "public-channel"
+                  }
+                },
+                "required": [
+                  "type"
+                ]
+              }
+            },
+            "required": [
+              "source"
+            ]
+          },
+          {
+            "type": "object",
+            "properties": { "goal": { "const": "native-lifecycle" } },
+            "required": ["goal"]
+          }
+        ]
+      },
+      "then": {
+        "type": "object",
+        "required": [
+          "auth"
+        ],
+        "properties": {
+          "auth": {},
+          "host": {
+            "type": "object",
+            "properties": {
+              "cliVersion": {},
+              "executableSha256": {}
+            }
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "type": "object",
+              "properties": { "goal": { "const": "native-lifecycle" } },
+              "required": ["goal"]
+            },
+            "then": {
+              "type": "object",
+              "properties": {
+                "host": {
+                  "type": "object",
+                  "properties": { "cliVersion": false, "executableSha256": false }
+                }
+              }
+            },
+            "else": {
+              "type": "object",
+              "properties": {
+                "host": {
+                  "type": "object",
+                  "required": ["cliVersion", "executableSha256"],
+                  "properties": { "cliVersion": {}, "executableSha256": {} }
+                }
+              }
+            }
+          }
+        ]
+      },
+      "else": {
+        "type": "object",
+        "properties": {
+          "auth": false,
+          "host": {
+            "type": "object",
+            "properties": {
+              "cliVersion": false,
+              "executableSha256": false
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "goal": { "const": "native-lifecycle" } },
+        "required": ["goal"]
+      },
+      "then": {
+        "properties": {
+          "source": {
+            "type": "object",
+            "properties": { "type": { "const": "local-marketplace" } },
+            "required": ["type"]
+          }
+        },
+        "required": ["auth", "invocation"]
+      }
+    }
+  ],
+  "$defs": {
+    "marketplaceRevision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "sourceManifestSha256", "membersDigest"],
+      "properties": {
+        "version": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/host/properties/driverVersion" },
+        "sourceManifestSha256": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256" },
+        "membersDigest": { "$ref": "https://contracts.skill-family.example/v1/host-verification-request.json#/$defs/sha256" }
+      }
+    }
+  }
+}