release-skill 0.9.17 → 0.9.18

package/adapters/cursor/src/schemas/report-model.schema.json

@@ -0,0 +1,308 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/report-model.json",
+  "title": "ReportModel",
+  "description": "A caller-authored, machine-validated model that is the only structured source for human-report facts. Harness never interprets business outputs or invents report prose, but it does bind the model to the source operation result's digest, terminal state, and complete stable-coded errors.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "kind",
+    "identity",
+    "timeRange",
+    "outcome",
+    "errors",
+    "changes",
+    "evidence",
+    "risks",
+    "unresolved",
+    "nextActions",
+    "appendices",
+    "source",
+    "renderer"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "kind": {
+      "const": "skill-family.report-model"
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runId", "skillFamily", "audience", "locale"],
+      "properties": {
+        "runId": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
+          "description": "The machine run/operation identity this report is about."
+        },
+        "skillFamily": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The skill family whose run produced the underlying machine result."
+        },
+        "stageId": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
+          "description": "Optional stage identity echoed from the machine result when present."
+        },
+        "audience": {
+          "enum": ["operator", "reviewer", "consumer"],
+          "description": "The declared reader of the report; selection only, never a license to add facts."
+        },
+        "locale": {
+          "enum": ["zh-CN", "en-US"],
+          "description": "Frozen rendering locale set; an unsupported locale is a hard failure (SFC3002), never a silent fallback."
+        }
+      }
+    },
+    "timeRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["startedAt", "completedAt"],
+      "properties": {
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "RFC 3339 start time copied from the machine result; never invented by the renderer."
+        },
+        "completedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "RFC 3339 terminal time copied from the machine result; never invented by the renderer."
+        }
+      }
+    },
+    "outcome": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["executionStatus", "summary", "counts"],
+      "properties": {
+        "executionStatus": {
+          "enum": [
+            "SUCCEEDED",
+            "SUCCEEDED_WITH_WARNINGS",
+            "FAILED",
+            "BLOCKED",
+            "NEEDS_INPUT",
+            "SKIPPED",
+            "CANCELLED"
+          ],
+          "description": "The machine execution status, copied verbatim from the machine result vocabulary."
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The conclusion sentence(s). A report without a conclusion is a missing element (SFC3002), never an empty render."
+        },
+        "blockingReason": {
+          "type": ["string", "null"],
+          "description": "Present only when the machine result carries one (FAILED/BLOCKED); never invented."
+        },
+        "counts": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["changes", "evidence", "risks", "unresolved", "nextActions", "appendices"],
+          "properties": {
+            "changes": { "type": "integer", "minimum": 0 },
+            "evidence": { "type": "integer", "minimum": 0 },
+            "risks": { "type": "integer", "minimum": 0 },
+            "unresolved": { "type": "integer", "minimum": 0 },
+            "nextActions": { "type": "integer", "minimum": 0 },
+            "appendices": { "type": "integer", "minimum": 0 }
+          },
+          "description": "Mechanically derived section counts; must equal the array lengths below. A mismatch is fact drift."
+        }
+      }
+    },
+    "errors": {
+      "type": "array",
+      "description": "The source operation-result errors copied without loss. It must be empty for successful outcomes; when a source result is supplied, Harness requires canonical equality with result.errors.",
+      "items": {
+        "$ref": "https://contracts.skill-family.example/v1/operation-result.json#/$defs/error"
+      }
+    },
+    "changes": {
+      "type": "array",
+      "description": "Changed artifacts declared by the machine result; may legitimately be empty. Order is preserved from the machine result.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "description"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Descriptive artifact path as stated by the machine result; rendering never reads or resolves it."
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Traceable evidence entries; a report model without at least one evidence entry is a missing element (SFC3002).",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "reference"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
+            "description": "Stable evidence identifier used for in-report referencing."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reference": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The exact reference target of this evidence. A rendered link may only point at a declared reference or an in-report anchor; any other target is fact drift."
+          },
+          "note": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "description": "Declared risks; may be empty, but the section itself is mandatory in every rendered report.",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "unresolved": {
+      "type": "array",
+      "description": "Unresolved questions carried out of the run; may be empty.",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "description": "Follow-up actions; may be empty, but the section itself is mandatory in every rendered report.",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "appendices": {
+      "type": "array",
+      "description": "Supplementary material copied from the machine result; may be empty. Never a place for renderer-added prose.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["title", "body"],
+        "properties": {
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "body": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resultDigest", "resultState"],
+      "properties": {
+        "resultDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$",
+          "description": "sha256 hex digest over the canonical JSON of the source machine result document."
+        },
+        "resultState": {
+          "enum": ["succeeded", "failed", "rejected"],
+          "description": "The terminal state copied verbatim from the source operation result. Harness verifies it and the compatible human executionStatus without interpreting outputs."
+        },
+        "resultKind": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Optional kind discriminator of the source machine result document."
+        }
+      }
+    },
+    "renderer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._/-]{0,127}$",
+          "description": "Identity of the deterministic renderer that produced the model."
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+          "description": "Exact semver of the renderer; no ranges."
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "outcome": {
+            "type": "object",
+            "properties": {
+              "executionStatus": {
+                "enum": ["SUCCEEDED", "SUCCEEDED_WITH_WARNINGS"]
+              }
+            },
+            "required": ["executionStatus"]
+          }
+        },
+        "required": ["outcome"]
+      },
+      "then": {
+        "properties": {
+          "errors": {
+            "type": "array",
+            "maxItems": 0
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "outcome": {
+            "type": "object",
+            "properties": {
+              "executionStatus": {
+                "enum": ["FAILED", "BLOCKED"]
+              }
+            },
+            "required": ["executionStatus"]
+          }
+        },
+        "required": ["outcome"]
+      },
+      "then": {
+        "properties": {
+          "errors": {
+            "type": "array",
+            "minItems": 1
+          }
+        }
+      }
+    }
+  ]
+}

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

package/adapters/cursor/src/schemas/skill-family-directory-verification-result.schema.json

@@ -0,0 +1,193 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/skill-family-directory-verification-result.json",
+  "title": "Skill-family directory verification result",
+  "description": "A public, closed Kimi directory verification result. It carries only digests and structured observation summaries; family roots, raw streams, credentials and executable identity inputs remain private.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "operation", "status", "requestDigest", "host", "facts", "reason", "requiredActions"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.skill-family-directory-verification-result" },
+    "operation": { "const": "skill-family-directory-verification" },
+    "status": { "enum": ["observed", "rejected", "failed", "indeterminate"] },
+    "requestDigest": { "$ref": "#/$defs/sha256" },
+    "host": { "$ref": "https://contracts.skill-family.example/v1/skill-family-directory-verification-request.json#/$defs/host" },
+    "facts": { "$ref": "#/$defs/facts" },
+    "reason": {
+      "enum": [null, "preflight-rejected", "executable-observation-mismatch", "execution-failed", "snapshot-mismatch", "private-evidence-publication-failed", "boundary-state-indeterminate", "source-invalid", "directory-mismatch", "skill-not-discovered", "skill-not-loaded", "official-observation-unavailable"]
+    },
+    "requiredActions": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "enum": ["manual-temporary-root-inspection-required"] }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "type": "object", "properties": { "status": { "const": "observed" } }, "required": ["status"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "const": null },
+          "requiredActions": { "type": "array", "maxItems": 0 },
+          "facts": {
+            "type": "object",
+            "properties": {
+                "skills": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["callId", "resultId"],
+                    "properties": {
+                      "discovery": { "const": "observed" },
+                      "load": { "const": "observed" },
+                      "callId": { "type": "string", "minLength": 1, "maxLength": 512 },
+                      "resultId": { "type": "string", "minLength": 1, "maxLength": 512 }
+                    }
+                  }
+                },
+              "workload": {
+                "type": "object",
+                "properties": {
+                  "execution": {
+                    "type": "object",
+                    "properties": {
+                      "spawned": { "const": true },
+                      "exitStatus": { "const": 0 },
+                      "processStatus": { "const": "EXITED" },
+                      "terminationReason": { "const": null },
+                      "watchdogReason": { "const": null },
+                      "runnerModelOverrideAbsent": { "const": true }
+                    }
+                  },
+                  "streams": { "type": "object" },
+                  "snapshots": { "type": "object" },
+                  "snapshotsMatch": { "const": true }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "type": "object", "properties": { "status": { "const": "indeterminate" } }, "required": ["status"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "enum": ["boundary-state-indeterminate", "official-observation-unavailable"] },
+          "requiredActions": { "const": ["manual-temporary-root-inspection-required"] }
+        }
+      }
+    },
+    {
+      "if": { "type": "object", "properties": { "status": { "const": "rejected" } }, "required": ["status"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "enum": ["preflight-rejected", "executable-observation-mismatch", "source-invalid", "directory-mismatch"] },
+          "requiredActions": { "type": "array", "maxItems": 0 },
+          "facts": { "type": "object", "properties": { "workload": { "const": null } } }
+        }
+      }
+    },
+    {
+      "if": { "type": "object", "properties": { "status": { "const": "failed" } }, "required": ["status"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "reason": { "enum": ["execution-failed", "snapshot-mismatch", "private-evidence-publication-failed", "skill-not-discovered", "skill-not-loaded"] },
+          "requiredActions": { "type": "array", "maxItems": 0 }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "skillName": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "facts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["familyTree", "skills", "workload"],
+      "properties": {
+        "familyTree": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["sourceManifestSha256", "membersDigest"],
+          "properties": {
+            "sourceManifestSha256": { "$ref": "#/$defs/sha256" },
+            "membersDigest": { "$ref": "#/$defs/sha256" }
+          }
+        },
+        "skills": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "sourceSha256", "discovery", "load", "callId", "resultId"],
+            "properties": {
+              "name": { "$ref": "#/$defs/skillName" },
+              "sourceSha256": { "$ref": "#/$defs/sha256" },
+              "discovery": { "enum": ["observed", "absent", "unknown"] },
+              "load": { "enum": ["observed", "absent", "unknown"] },
+              "callId": { "type": ["string", "null"], "minLength": 1, "maxLength": 512 },
+              "resultId": { "type": ["string", "null"], "minLength": 1, "maxLength": 512 }
+            }
+          }
+        },
+        "workload": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": ["execution", "streams", "snapshots", "snapshotsMatch"],
+          "properties": {
+            "execution": { "$ref": "#/$defs/execution" },
+            "streams": { "$ref": "#/$defs/streams" },
+            "snapshots": { "$ref": "#/$defs/snapshots" },
+            "snapshotsMatch": { "type": ["boolean", "null"] }
+          }
+        }
+      }
+    },
+    "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": { "type": ["string", "null"] },
+        "watchdogReason": { "type": ["string", "null"] },
+        "runnerModelOverrideAbsent": { "type": "boolean" }
+      }
+    },
+    "stream": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sha256", "bytes", "sensitivity"],
+      "properties": { "sha256": { "$ref": "#/$defs/sha256" }, "bytes": { "type": "integer", "minimum": 0 }, "sensitivity": { "const": "private" } }
+    },
+    "streams": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["stdout", "stderr"],
+      "properties": { "stdout": { "$ref": "#/$defs/stream" }, "stderr": { "$ref": "#/$defs/stream" } }
+    },
+    "snapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["preClosureDigest", "postClosureDigest"],
+      "properties": { "preClosureDigest": { "$ref": "#/$defs/sha256" }, "postClosureDigest": { "$ref": "#/$defs/sha256" } }
+    },
+    "snapshots": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["family", "fixture", "protectedWorkspace"],
+      "properties": { "family": { "$ref": "#/$defs/snapshot" }, "fixture": { "$ref": "#/$defs/snapshot" }, "protectedWorkspace": { "$ref": "#/$defs/snapshot" } }
+    }
+  }
+}

package/adapters/cursor/src/schemas/source-authority-receipt.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://contracts.skill-family.example/v1/source-authority-receipt.json",
+  "title": "Source Authority Receipt",
+  "description": "Business-neutral external authority receipt binding one source repository and base commit to an exact, deterministically ordered package subject set.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "sourceRepository", "sourceBaseCommit", "subjects"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "skill-family.source-authority-receipt" },
+    "sourceRepository": { "type": "string", "minLength": 1 },
+    "sourceBaseCommit": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+    "subjects": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["packageName", "version", "filename", "sha256"],
+        "properties": {
+          "packageName": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 },
+          "filename": { "type": "string", "minLength": 1 },
+          "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+        }
+      }
+    }
+  }
+}