@mnstry/atelier 0.2.0-alpha.5 → 0.2.0-alpha.8

package/contracts/atelier-guide.v1.schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$comment": "contract revision 1.0.0; local integrity and inert declarations only.",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-guide.v1.schema.json",
+  "title": "Atelier guide and remote capability contracts",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/offer"
+    },
+    {
+      "$ref": "#/$defs/capability"
+    },
+    {
+      "$ref": "#/$defs/consent"
+    },
+    {
+      "$ref": "#/$defs/engagement"
+    }
+  ],
+  "$defs": {
+    "offer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "id",
+        "guideId",
+        "capabilityIds",
+        "deliverableReview",
+        "commercialAuthority"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-guide-offer@v1"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,63}$"
+        },
+        "guideId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,63}$"
+        },
+        "capabilityIds": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]{0,63}$"
+          }
+        },
+        "deliverableReview": {
+          "const": "required"
+        },
+        "commercialAuthority": {
+          "const": false
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "id",
+        "serviceRef",
+        "inputSchemaDigest",
+        "outputSchemaDigest",
+        "maxInputBytes",
+        "implementation",
+        "executionAuthority"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-remote-capability@v1"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,63}$"
+        },
+        "serviceRef": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https://",
+          "maxLength": 2048
+        },
+        "inputSchemaDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "outputSchemaDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "maxInputBytes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 16777216
+        },
+        "implementation": {
+          "const": "remote"
+        },
+        "executionAuthority": {
+          "const": false
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "consent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "offerDigest",
+        "capabilityDigest",
+        "payloadDigest",
+        "engagementRevision",
+        "status",
+        "validFrom",
+        "expiresAt",
+        "authority"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-guide-consent@v1"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "offerDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "capabilityDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "payloadDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "engagementRevision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "status": {
+          "enum": [
+            "approved",
+            "revoked"
+          ]
+        },
+        "validFrom": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "authority": {
+          "const": "local-assertion-only"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "engagement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "offerDigest",
+        "revision",
+        "status",
+        "authority"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-guide-engagement@v1"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "offerDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "status": {
+          "enum": [
+            "proposed",
+            "accepted",
+            "paused",
+            "revoked"
+          ]
+        },
+        "authority": {
+          "const": "local-assertion-only"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/contracts/atelier-intake.v1.schema.json

@@ -0,0 +1,151 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$comment": "contract revision 1.0.0; local integrity and inert declarations only.",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-intake.v1.schema.json",
+  "title": "Atelier immutable intake records",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/source"
+    },
+    {
+      "$ref": "#/$defs/attempt"
+    },
+    {
+      "$ref": "#/$defs/completion"
+    }
+  ],
+  "$defs": {
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "sourceRef",
+        "blobId",
+        "bytes",
+        "originalMutation"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-intake-source@v1"
+        },
+        "sourceRef": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^./\\\\][^\\\\]*$"
+        },
+        "blobId": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 16777216
+        },
+        "originalMutation": {
+          "const": false
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "attempt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "attemptId",
+        "blobId",
+        "extractorId",
+        "extractorVersion",
+        "configurationDigest"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-intake-attempt@v1"
+        },
+        "attemptId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,63}$"
+        },
+        "blobId": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "extractorId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,63}$"
+        },
+        "extractorVersion": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9._-]{1,64}$"
+        },
+        "configurationDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "completion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "attemptId",
+        "attemptDigest",
+        "outputDigest",
+        "bytes",
+        "integrity",
+        "semanticAcceptance"
+      ],
+      "properties": {
+        "schema": {
+          "const": "mnstry.atelier-intake-completion@v1"
+        },
+        "attemptId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,63}$"
+        },
+        "attemptDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "outputDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 16777216
+        },
+        "integrity": {
+          "const": "verified"
+        },
+        "semanticAcceptance": {
+          "const": "pending"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/contracts/atelier-migration.v2.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-migration.v2.schema.json",
+  "$comment": "contract revision 2.0.0",
+  "title": "mnstry.atelier-migration@v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "executorDigest",
+    "readScope",
+    "allowedWrites",
+    "sideEffects",
+    "postChecks"
+  ],
+  "properties": {
+    "schema": {
+      "const": "mnstry.atelier-migration@v2"
+    },
+    "id": {
+      "const": "local-lock-projections@1"
+    },
+    "executorDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "readScope": {
+      "const": "whole-enrolled-repository"
+    },
+    "allowedWrites": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "sideEffects": {
+      "const": [
+        "git-index",
+        "git-commit"
+      ]
+    },
+    "postChecks": {
+      "const": [
+        "exact-inventory",
+        "lock-schema",
+        "exact-index",
+        "commit-parent-tree-message"
+      ]
+    },
+    "ext": {
+      "type": "object",
+      "description": "Namespaced annotations only. Unknown members MUST be ignored and convey no authority."
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^2\\.[0-9]+\\.[0-9]+$"
+    }
+  }
+}

package/contracts/atelier-obsidian-acceptance-receipt.v1.schema.json

@@ -0,0 +1,211 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-obsidian-acceptance-receipt.v1.schema.json",
+  "title": "Obsidian acceptance receipt",
+  "$comment": "contract revision 1.0.0; portable shape; candidate, tree and tarball identity, OS, app and CLI versions, procedure ID, raw evidence hashes and the actual outcome.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "receiptId",
+    "gate",
+    "procedureId",
+    "candidate",
+    "environment",
+    "evidenceType",
+    "evidence",
+    "outcome",
+    "recordedAt"
+  ],
+  "properties": {
+    "schema": {
+      "const": "atelier-obsidian-acceptance-receipt/v1"
+    },
+    "receiptId": {
+      "$ref": "#/$defs/identifier"
+    },
+    "gate": {
+      "type": "string",
+      "pattern": "^G[0-9]{2}$"
+    },
+    "procedureId": {
+      "$ref": "#/$defs/identifier"
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "commit",
+        "treeDigest"
+      ],
+      "properties": {
+        "commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        },
+        "treeDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "tarballDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "os",
+        "app",
+        "cli"
+      ],
+      "properties": {
+        "os": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "version"
+          ],
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "version": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "ext": {
+              "type": "object"
+            }
+          }
+        },
+        "app": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "version"
+          ],
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "version": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "installerDigest": {
+              "$ref": "#/$defs/digest"
+            },
+            "ext": {
+              "type": "object"
+            }
+          }
+        },
+        "cli": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "version"
+          ],
+          "properties": {
+            "version": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "ext": {
+              "type": "object"
+            }
+          }
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "evidenceType": {
+      "enum": [
+        "real-app",
+        "node",
+        "host",
+        "human"
+      ]
+    },
+    "evidence": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 4096,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "digest",
+          "byteLength"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+          },
+          "digest": {
+            "$ref": "#/$defs/digest"
+          },
+          "byteLength": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "ext": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "outcome": {
+      "enum": [
+        "passed",
+        "failed",
+        "blocked"
+      ]
+    },
+    "recordedAt": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "ext": {
+      "type": "object"
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+    }
+  },
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}