release-skill 0.1.1

package/schemas/approval-record.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://release-skill.dev/schemas/approval-record/v1",
+  "title": "Approval Record",
+  "description": "Schema for human approval record bound to a frozen release plan",
+  "type": "object",
+  "required": [
+    "planDigest",
+    "baseline",
+    "approvedActions",
+    "actor",
+    "approvedAt",
+    "expiresAt"
+  ],
+  "anyOf": [
+    { "required": ["targetVersion"] },
+    { "required": ["unitVersions"] }
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "planDigest": {
+      "type": "string",
+      "minLength": 1,
+      "description": "SHA-256 digest of the frozen release plan"
+    },
+    "baseline": {
+      "type": "object",
+      "required": ["gitTreeHash"],
+      "additionalProperties": false,
+      "properties": {
+        "gitTreeHash": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Git tree hash at plan freeze time"
+        },
+        "workspaceDigest": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Deterministic digest of workspace file state at plan freeze time"
+        },
+        "workspaceDigestAlgorithm": {
+          "type": "string",
+          "const": "git-workspace-v2",
+          "description": "Versioned algorithm authority for workspaceDigest"
+        }
+      }
+    },
+    "targetVersion": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target release version approved"
+    },
+    "unitVersions": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Exact unit-id to target-version authority for multi-unit releases"
+    },
+    "approvedActions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true,
+      "description": "List of approved external actions (no wildcards)"
+    },
+    "actor": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Identity of the approver"
+    },
+    "approvedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when approval was granted"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when approval expires (max 24h after approvedAt)"
+    },
+    "exceptions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["rule", "reason", "responsible", "expiresAt"],
+        "additionalProperties": false,
+        "properties": {
+          "rule": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          },
+          "responsible": {
+            "type": "string",
+            "minLength": 1
+          },
+          "expiresAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "description": "Exception waivers with reason, responsible person, and expiration"
+    }
+  }
+}

package/schemas/artifact-lock.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://release-skill.dev/artifact-lock.schema.json",
+  "title": "ArtifactLock",
+  "description": "Reachable accepted artifact manifest. Absolute repository paths are never authoritative.",
+  "type": "object",
+  "required": [
+    "lockVersion",
+    "repositoryId",
+    "repositoryIdentity",
+    "policyDigest",
+    "acceptanceId",
+    "acceptedArtifactManifestDigest",
+    "entries",
+    "acceptedAt",
+    "acceptedBy"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "release-skill.dev/artifact-lock/v1"
+    },
+    "lockVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "repositoryId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "repositoryIdentity": {
+      "type": "object",
+      "required": ["remoteUrlHash"],
+      "additionalProperties": false,
+      "properties": {
+        "remoteUrlHash": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      }
+    },
+    "policyDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "acceptanceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "acceptedArtifactManifestDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "entries": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["path", "type", "mode", "gitOid", "sha256"],
+        "additionalProperties": false,
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "type": {
+            "type": "string",
+            "enum": ["blob", "tree"]
+          },
+          "mode": {
+            "type": "string",
+            "pattern": "^(100644|100755|040000)$"
+          },
+          "gitOid": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{40,64}$"
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^(sha256:)?[a-f0-9]{64}$"
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "manifestDigest": {
+            "type": "string",
+            "pattern": "^sha256:[a-f0-9]{64}$"
+          },
+          "ownership": {
+            "type": "string",
+            "enum": ["human", "generated", "mixed"]
+          },
+          "mergeDriver": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "acceptedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "acceptedBy": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}

package/schemas/artifact-plan.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://release-skill.dev/artifact-plan.schema.json",
+  "title": "ArtifactPlan",
+  "description": "Read-only inspection plan for artifact state and next action.",
+  "type": "object",
+  "required": [
+    "apiVersion",
+    "operation",
+    "bindings",
+    "artifacts",
+    "safeToWrite",
+    "targetUnchanged",
+    "nextAction",
+    "planDigest"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": { "type": "string", "const": "release-skill.dev/artifact-plan/v1" },
+    "operation": { "type": "string", "enum": ["inspect", "init", "status"] },
+    "bindings": {
+      "type": "object",
+      "required": [
+        "repositoryIdentity",
+        "policyDigest",
+        "baseManifestDigest",
+        "currentManifestDigest",
+        "producerClosureDigest"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "repositoryIdentity": { "type": "string" },
+        "policyDigest": { "type": "string" },
+        "baseManifestDigest": { "type": "string" },
+        "currentManifestDigest": { "type": "string" },
+        "producerClosureDigest": { "type": "string" }
+      }
+    },
+    "artifacts": { "type": "array" },
+    "safeToWrite": { "type": "boolean" },
+    "targetUnchanged": { "type": "boolean" },
+    "nextAction": {
+      "type": "object",
+      "required": ["command"],
+      "additionalProperties": false,
+      "properties": {
+        "command": { "type": "string" }
+      }
+    },
+    "planDigest": { "type": "string" }
+  }
+}

package/schemas/artifact-policy.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://release-skill.dev/artifact-policy.schema.json",
+  "title": "ArtifactPolicy",
+  "description": "Closed-world artifact policy defining repository identity, inventory, and artifact definitions.",
+  "type": "object",
+  "required": ["repository", "inventory", "artifacts"],
+  "additionalProperties": false,
+  "properties": {
+    "repository": {
+      "type": "object",
+      "required": ["id"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 }
+      }
+    },
+    "inventory": {
+      "type": "object",
+      "required": ["roots", "defaultOwnership"],
+      "additionalProperties": false,
+      "properties": {
+        "roots": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 1
+        },
+        "defaultOwnership": { "type": "string", "enum": ["human", "generated"] }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "type"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "type": { "type": "string", "enum": ["declared", "generated"] },
+          "sourcePath": { "type": "string" },
+          "ownership": { "type": "string", "enum": ["human", "generated"] },
+          "producer": { "type": "string", "minLength": 1 },
+          "sourceArtifacts": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "minItems": 1
+          },
+          "adoptionRoutes": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["target", "sourceArtifact", "mode"],
+              "additionalProperties": false,
+              "properties": {
+                "target": { "type": "string", "minLength": 1 },
+                "sourceArtifact": { "type": "string", "minLength": 1 },
+                "mode": { "type": "string", "enum": ["exact-copy"] }
+              }
+            },
+            "minItems": 1
+          }
+        },
+        "oneOf": [
+          {
+            "properties": { "type": { "const": "declared" } },
+            "required": ["sourcePath"]
+          },
+          {
+            "properties": { "type": { "const": "generated" } },
+            "required": ["producer", "sourceArtifacts", "adoptionRoutes"]
+          }
+        ]
+      }
+    }
+  }
+}

package/schemas/evidence-event.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://release-skill.dev/schemas/evidence-event/v1",
+  "title": "Evidence Event",
+  "description": "Schema for JSONL evidence events produced during release execution",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "runId",
+    "sequence",
+    "timestamp",
+    "command",
+    "phase",
+    "status"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1,
+      "description": "Event format version"
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Unique identifier for the run (UUID)"
+    },
+    "sequence": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Event sequence number within the run, starting from 1"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 UTC timestamp of the event"
+    },
+    "command": {
+      "type": "string",
+      "enum": ["assess", "prepare", "publish", "reconcile", "verify"],
+      "description": "The command that triggered this event"
+    },
+    "phase": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Current execution phase identifier"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["started", "succeeded", "failed", "skipped"],
+      "description": "Status value of this event"
+    },
+    "error": {
+      "type": ["object", "null"],
+      "description": "Error details when status is failed",
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string",
+          "enum": [
+            "CONFIG_INVALID",
+            "BASELINE_CHANGED",
+            "DIRTY_SCOPE_CONFLICT",
+            "GATE_FAILED",
+            "AUTH_MISSING",
+            "REMOTE_CONFLICT",
+            "HOOK_TIMEOUT",
+            "PARTIAL_RELEASE",
+            "POST_PUBLISH_VERIFY_FAILED"
+          ],
+          "description": "Stable error code"
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable error message"
+        }
+      }
+    },
+    "duration": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Phase duration in milliseconds"
+    },
+    "details": {
+      "type": "object",
+      "description": "Phase-specific supplementary information"
+    }
+  }
+}