@mnstry/atelier 0.2.0-alpha.1

package/contracts/atelier-readiness-run.v1.schema.json

@@ -0,0 +1,229 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-readiness-run.v1.schema.json",
+  "$comment": "contract revision 1.1.0 (contract-stability epoch)",
+  "title": "MNSTRY Atelier Readiness Run v1",
+  "description": "Local, ignored, claim-first result of a readiness protocol run. A run can create proposed claims and draft packets, but it never grants runtime mutation, import, telemetry, egress, send-path, direct browser-write, or canonical graph/front-matter authority.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "runId",
+    "protocolId",
+    "createdAt",
+    "project",
+    "answers",
+    "status",
+    "score",
+    "blockers",
+    "warnings",
+    "claims",
+    "safety"
+  ],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "ready"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "blockers": {
+            "maxItems": 0
+          }
+        }
+      }
+    }
+  ],
+  "properties": {
+    "schema": {
+      "const": "atelier-readiness-run@v1"
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+    },
+    "runId": {
+      "type": "string",
+      "pattern": "^readiness-run-[a-f0-9]{24}$"
+    },
+    "protocolId": {
+      "$ref": "#/$defs/protocolId"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "project": {
+      "type": "string",
+      "minLength": 1
+    },
+    "answers": {
+      "type": "object"
+    },
+    "status": {
+      "enum": [
+        "missing",
+        "draft",
+        "review-needed",
+        "ready",
+        "blocked"
+      ]
+    },
+    "score": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "blockers": {
+      "$ref": "#/$defs/stringList"
+    },
+    "warnings": {
+      "$ref": "#/$defs/stringList"
+    },
+    "claims": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/claim"
+      }
+    },
+    "safety": {
+      "$ref": "#/$defs/safety"
+    },
+    "ext": {
+      "type": "object",
+      "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+    }
+  },
+  "$defs": {
+    "protocolId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*\\.[a-z][a-z0-9-]*:[a-z][a-z0-9._-]*$"
+    },
+    "stringList": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "claim": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "claimId",
+        "subject",
+        "predicate",
+        "object",
+        "provider",
+        "status",
+        "promoted"
+      ],
+      "properties": {
+        "schema": {
+          "const": "atelier-claim@v1"
+        },
+        "claimId": {
+          "type": "string",
+          "pattern": "^claim:[a-z0-9][a-z0-9:-]*$"
+        },
+        "subject": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9:-]*$"
+        },
+        "predicate": {
+          "enum": [
+            "related",
+            "supports",
+            "supersedes",
+            "implements",
+            "depends_on",
+            "evidences",
+            "contradicts",
+            "belongs_to"
+          ]
+        },
+        "object": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9:-]*$"
+        },
+        "provider": {
+          "enum": [
+            "atelier-readiness",
+            "codex",
+            "manual",
+            "analysis",
+            "claude",
+            "script"
+          ]
+        },
+        "status": {
+          "const": "proposed"
+        },
+        "promoted": {
+          "const": false
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        },
+        "notes": {
+          "$ref": "#/$defs/stringList"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "safety": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "runtimeMutation",
+        "runtimeImport",
+        "canonicalWrites",
+        "claimOnly",
+        "storage"
+      ],
+      "properties": {
+        "runtimeMutation": {
+          "const": false
+        },
+        "runtimeImport": {
+          "const": false
+        },
+        "canonicalWrites": {
+          "const": false
+        },
+        "claimOnly": {
+          "const": true
+        },
+        "storage": {
+          "const": "ignored-local"
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,457 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-readiness.v1.schema.json",
+  "$comment": "contract revision 1.1.0 (contract-stability epoch)",
+  "title": "mnstry.atelier-readiness@v1",
+  "description": "Live readiness report for the Atelier extractable-kit boundary. This is evidence from current checks, not source authority.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "generatedAt",
+    "workspace",
+    "acceptedBoundary",
+    "ready",
+    "blockers",
+    "warnings",
+    "graph",
+    "alignment",
+    "contracts",
+    "kitManifest",
+    "runtimeDryRun",
+    "supportBundle",
+    "analysis",
+    "checks"
+  ],
+  "properties": {
+    "schema": {
+      "const": "mnstry.atelier-readiness@v1"
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "root",
+        "repoOpsHead"
+      ],
+      "properties": {
+        "root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "repoOpsHead": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[0-9a-f]{7,40}$"
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "acceptedBoundary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "ready": {
+      "type": "boolean"
+    },
+    "blockers": {
+      "$ref": "#/$defs/stringList"
+    },
+    "warnings": {
+      "$ref": "#/$defs/stringList"
+    },
+    "graph": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "path",
+        "schema",
+        "nodes",
+        "edges",
+        "diagnostics",
+        "privateRepoRecommended"
+      ],
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schema": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "nodes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "edges": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "diagnostics": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "privateRepoRecommended": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "alignment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "path",
+        "schema",
+        "generatedAt",
+        "graphNodes",
+        "graphEdges",
+        "alignmentNodes",
+        "alignmentEdges",
+        "gaps",
+        "diagnostics"
+      ],
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schema": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "generatedAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "format": "date-time"
+        },
+        "graphNodes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "graphEdges": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "alignmentNodes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "alignmentEdges": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "gaps": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "diagnostics": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "contracts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "path",
+          "present"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "present": {
+            "type": "boolean"
+          },
+          "ext": {
+            "type": "object",
+            "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+          }
+        }
+      }
+    },
+    "runtimeDryRun": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "root",
+        "script",
+        "test",
+        "fixture",
+        "dryRunOnly"
+      ],
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "script": {
+          "type": "string",
+          "minLength": 1
+        },
+        "test": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fixture": {
+          "type": "string",
+          "minLength": 1
+        },
+        "dryRunOnly": {
+          "const": true
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "kitManifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "path",
+        "schema",
+        "kernel",
+        "sourceDialect",
+        "exportContract",
+        "extensionPacks",
+        "telemetry"
+      ],
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schema": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "kernel": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sourceDialect": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "exportContract": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "extensionPacks": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "telemetry": {
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "supportBundle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "states",
+        "sendPath",
+        "background",
+        "telemetry",
+        "hashableDryRun"
+      ],
+      "properties": {
+        "states": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "none",
+              "support_bundle"
+            ]
+          },
+          "minItems": 2,
+          "uniqueItems": true
+        },
+        "sendPath": {
+          "const": false
+        },
+        "background": {
+          "const": false
+        },
+        "telemetry": {
+          "const": "none"
+        },
+        "hashableDryRun": {
+          "const": true
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "analysis": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "enabled",
+        "defaultEnabled",
+        "manifestPath",
+        "manifestPresent",
+        "authority"
+      ],
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "defaultEnabled": {
+          "const": false
+        },
+        "manifestPath": {
+          "type": "string",
+          "minLength": 1
+        },
+        "manifestPresent": {
+          "type": "boolean"
+        },
+        "authority": {
+          "enum": [
+            "optional-local-claim-only"
+          ]
+        },
+        "ext": {
+          "type": "object",
+          "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+        }
+      }
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "label",
+          "command",
+          "cwd",
+          "ok",
+          "status",
+          "signal"
+        ],
+        "properties": {
+          "label": {
+            "type": "string",
+            "minLength": 1
+          },
+          "command": {
+            "type": "string",
+            "minLength": 1
+          },
+          "cwd": {
+            "type": "string",
+            "minLength": 1
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "status": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "signal": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ext": {
+            "type": "object",
+            "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+          }
+        }
+      }
+    },
+    "ext": {
+      "type": "object",
+      "description": "Reserved extension container. Producers MAY add namespaced members (recommend vendor-prefixed keys). Consumers MUST ignore members they do not recognize. Contents are not validated at v1 and carry no authority over first-class fields."
+    }
+  },
+  "$defs": {
+    "stringList": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    }
+  }
+}

package/contracts/compat-baseline.json

@@ -0,0 +1,10 @@
+{
+  "schema": "atelier-compat-baseline@v1",
+  "baselineTag": "v0.2.0-alpha.0",
+  "preEpochTags": [
+    "v0.1.0-alpha.0",
+    "v0.1.0-alpha.1",
+    "v0.1.0-alpha.2"
+  ],
+  "note": "Set baselineTag to the first tag cut after the contract-stability epoch, in the same release commit as the tag. Null is inert ONLY while every existing tag is in preEpochTags; any tag beyond that set with a null baseline fails the gate."
+}