@mnstry/atelier 0.2.0-alpha.1

package/contracts/analysis-adapter.v1.schema.json

@@ -0,0 +1,248 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/analysis-adapter.v1.schema.json",
+  "$comment": "contract revision 1.1.0 (contract-stability epoch)",
+  "title": "analysis-adapter@v1",
+  "description": "Local-only optional model-assisted analysis adapter contract. The adapter may record opt-in posture and claim files, but it cannot install model-assisted analysis, execute model-assisted analysis, create a model-provider boundary, or mutate canonical Atelier state.",
+  "$defs": {
+    "manifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "provider",
+        "outputRoot",
+        "claimContract",
+        "harness",
+        "canonicalMutation",
+        "authority"
+      ],
+      "properties": {
+        "schema": {
+          "const": "analysis-adapter-manifest@v1"
+        },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+        },
+        "provider": {
+          "const": "analysis"
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        },
+        "outputRoot": {
+          "description": "Repo-relative ignored local directory for model-assisted analysis adapter artifacts.",
+          "type": "string",
+          "pattern": "^\\.mnstry/atelier/analysis(/.*)?$"
+        },
+        "claimContract": {
+          "const": "atelier-claim@v1"
+        },
+        "harness": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "policy",
+            "hiddenModelProvider",
+            "network",
+            "analysisExecution"
+          ],
+          "properties": {
+            "policy": {
+              "const": "active-agentic-harness-only"
+            },
+            "hiddenModelProvider": {
+              "const": false
+            },
+            "network": {
+              "const": "none"
+            },
+            "analysisExecution": {
+              "const": false
+            },
+            "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."
+            }
+          }
+        },
+        "canonicalMutation": {
+          "const": false
+        },
+        "authority": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "claimOnly",
+            "frontMatterMutation",
+            "graphRelationMutation",
+            "publicExportFeed",
+            "mcpFeed",
+            "runtimeImport",
+            "directCanonicalWrite"
+          ],
+          "properties": {
+            "claimOnly": {
+              "const": true
+            },
+            "frontMatterMutation": {
+              "const": false
+            },
+            "graphRelationMutation": {
+              "const": false
+            },
+            "publicExportFeed": {
+              "const": false
+            },
+            "mcpFeed": {
+              "const": false
+            },
+            "runtimeImport": {
+              "const": false
+            },
+            "directCanonicalWrite": {
+              "const": false
+            },
+            "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."
+        }
+      }
+    },
+    "claimOutput": {
+      "description": "model-assisted analysis adapter output is only a list of proposed atelier-claim@v1 claims.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "schema",
+          "provider",
+          "status",
+          "promoted"
+        ],
+        "properties": {
+          "schema": {
+            "const": "atelier-claim@v1"
+          },
+          "provider": {
+            "const": "analysis"
+          },
+          "status": {
+            "const": "proposed"
+          },
+          "promoted": {
+            "const": false
+          }
+        },
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "kg"
+              ]
+            },
+            {
+              "required": [
+                "frontmatter"
+              ]
+            },
+            {
+              "required": [
+                "frontMatter"
+              ]
+            },
+            {
+              "required": [
+                "canonicalFrontMatter"
+              ]
+            },
+            {
+              "required": [
+                "relations"
+              ]
+            },
+            {
+              "required": [
+                "graphRelations"
+              ]
+            },
+            {
+              "required": [
+                "canonicalRelations"
+              ]
+            },
+            {
+              "required": [
+                "edges"
+              ]
+            },
+            {
+              "required": [
+                "publicExport"
+              ]
+            },
+            {
+              "required": [
+                "atelierExport"
+              ]
+            },
+            {
+              "required": [
+                "mcpFeed"
+              ]
+            },
+            {
+              "required": [
+                "mcpResources"
+              ]
+            },
+            {
+              "required": [
+                "runtimeImport"
+              ]
+            },
+            {
+              "required": [
+                "importPlan"
+              ]
+            },
+            {
+              "required": [
+                "canonicalWrite"
+              ]
+            },
+            {
+              "required": [
+                "canonicalMutation"
+              ]
+            },
+            {
+              "required": [
+                "mutation"
+              ]
+            },
+            {
+              "required": [
+                "mutations"
+              ]
+            },
+            {
+              "required": [
+                "writes"
+              ]
+            }
+          ]
+        }
+      }
+    }
+  }
+}

package/contracts/atelier-action-intent.v1.schema.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-action-intent.v1.schema.json",
+  "$comment": "contract revision 1.1.0 (contract-stability epoch)",
+  "title": "atelier-action-intent@v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "kind",
+    "appliesTo",
+    "reads",
+    "writes",
+    "authority",
+    "deniedWhen"
+  ],
+  "properties": {
+    "schema": {
+      "const": "atelier-action-intent@v1"
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^atelier\\.action\\.[a-z0-9][a-z0-9.-]*$"
+    },
+    "kind": {
+      "enum": [
+        "copy.repoPath",
+        "copy.absolutePath",
+        "copy.agentPrompt",
+        "copy.realmPath",
+        "copy.repoFolder"
+      ]
+    },
+    "label": {
+      "type": "string",
+      "minLength": 1
+    },
+    "appliesTo": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "scopes"
+      ],
+      "properties": {
+        "scopes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "enum": [
+              "entry",
+              "realm"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "targetTypes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": 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."
+        }
+      }
+    },
+    "reads": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    },
+    "writes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "const": "clipboard"
+      },
+      "uniqueItems": true
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "label",
+        "runtimeMutation"
+      ],
+      "properties": {
+        "label": {
+          "const": "Copy only; no runtime mutation"
+        },
+        "runtimeMutation": {
+          "const": false
+        },
+        "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."
+        }
+      }
+    },
+    "deniedWhen": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "reason",
+          "message"
+        ],
+        "properties": {
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1
+          },
+          "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."
+    }
+  }
+}