@mnstry/atelier 0.2.0-alpha.11 → 0.2.0-alpha.13

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

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-migration.v3.schema.json",
+  "$comment": "contract revision 3.0.0",
+  "title": "mnstry.atelier-migration@v3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "executorDigest",
+    "readScope",
+    "allowedWrites",
+    "sideEffects",
+    "postChecks"
+  ],
+  "properties": {
+    "schema": {
+      "const": "mnstry.atelier-migration@v3"
+    },
+    "id": {
+      "const": "local-template-profile@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",
+        "template-adoption",
+        "template-current-source"
+      ]
+    },
+    "ext": {
+      "type": "object",
+      "maxProperties": 0,
+      "description": "Reserved extension container; no extension behavior is supported by this contract."
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^3\\.[0-9]+\\.[0-9]+$"
+    }
+  }
+}

package/contracts/atelier-obsidian-generation-manifest.v2.schema.json

@@ -0,0 +1,372 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-obsidian-generation-manifest.v2.schema.json",
+  "title": "Obsidian generation manifest",
+  "$comment": "contract revision 2.0.0; portable shape; vault layout 2: readable paths mirroring each repository, the identity of every note in a generated region of its own, authored and generated byte regions, link inversion map, attachment hashes, completeness and freshness. Withheld endpoints never appear.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "layoutVersion",
+    "generationId",
+    "scopeId",
+    "snapshotId",
+    "notes",
+    "links",
+    "attachments",
+    "completeness",
+    "freshness"
+  ],
+  "properties": {
+    "schema": {
+      "const": "atelier-obsidian-generation-manifest/v2"
+    },
+    "layoutVersion": {
+      "const": 2
+    },
+    "generationId": {
+      "$ref": "#/$defs/identifier"
+    },
+    "scopeId": {
+      "$ref": "#/$defs/identifier"
+    },
+    "snapshotId": {
+      "$ref": "#/$defs/identifier"
+    },
+    "notes": {
+      "type": "array",
+      "maxItems": 1000000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "repoId",
+          "nodeId",
+          "path",
+          "title",
+          "noteDigest",
+          "regions"
+        ],
+        "properties": {
+          "repoId": {
+            "$ref": "#/$defs/identifier"
+          },
+          "nodeId": {
+            "$ref": "#/$defs/identifier"
+          },
+          "path": {
+            "$ref": "#/$defs/notePath"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          },
+          "noteDigest": {
+            "$ref": "#/$defs/digest"
+          },
+          "regions": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "identity",
+              "body",
+              "generated"
+            ],
+            "properties": {
+              "frontmatter": {
+                "$ref": "#/$defs/byteRange"
+              },
+              "identity": {
+                "$ref": "#/$defs/byteRange"
+              },
+              "body": {
+                "$ref": "#/$defs/byteRange"
+              },
+              "generated": {
+                "type": "array",
+                "maxItems": 64,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "kind",
+                    "range"
+                  ],
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "relations",
+                        "outside-selection",
+                        "representation",
+                        "identity"
+                      ]
+                    },
+                    "range": {
+                      "$ref": "#/$defs/byteRange"
+                    },
+                    "ext": {
+                      "type": "object"
+                    }
+                  }
+                }
+              },
+              "ext": {
+                "type": "object"
+              }
+            }
+          },
+          "ext": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "links": {
+      "type": "array",
+      "maxItems": 5000000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "edgeId",
+          "sourceNodeId",
+          "targetNodeId",
+          "type",
+          "origin",
+          "targetState"
+        ],
+        "properties": {
+          "edgeId": {
+            "$ref": "#/$defs/identifier"
+          },
+          "sourceNodeId": {
+            "$ref": "#/$defs/identifier"
+          },
+          "targetNodeId": {
+            "$ref": "#/$defs/identifier"
+          },
+          "type": {
+            "$ref": "#/$defs/relationType"
+          },
+          "origin": {
+            "enum": [
+              "declared",
+              "markdown"
+            ]
+          },
+          "targetState": {
+            "enum": [
+              "in-scope",
+              "outside-selection"
+            ]
+          },
+          "inversions": {
+            "type": "array",
+            "maxItems": 4096,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "source",
+                "note"
+              ],
+              "properties": {
+                "source": {
+                  "$ref": "#/$defs/byteRange"
+                },
+                "note": {
+                  "$ref": "#/$defs/byteRange"
+                },
+                "ext": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "ext": {
+            "type": "object"
+          }
+        },
+        "if": {
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "const": "links_to"
+            }
+          }
+        },
+        "then": {
+          "properties": {
+            "origin": {
+              "const": "markdown"
+            }
+          }
+        },
+        "else": {
+          "properties": {
+            "origin": {
+              "const": "declared"
+            }
+          }
+        }
+      }
+    },
+    "attachments": {
+      "type": "array",
+      "maxItems": 1000000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "path",
+          "digest",
+          "byteLength"
+        ],
+        "properties": {
+          "path": {
+            "$ref": "#/$defs/vaultPath"
+          },
+          "digest": {
+            "$ref": "#/$defs/digest"
+          },
+          "byteLength": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "ext": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "completeness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "expectedNotes",
+        "writtenNotes"
+      ],
+      "properties": {
+        "status": {
+          "enum": [
+            "complete",
+            "partial"
+          ]
+        },
+        "expectedNotes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "writtenNotes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "freshness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "checkedAt"
+      ],
+      "properties": {
+        "status": {
+          "enum": [
+            "current",
+            "stale",
+            "unknown"
+          ]
+        },
+        "checkedAt": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "ext": {
+      "type": "object"
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^2\\.[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"
+    },
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?![/~])(?![A-Za-z]:)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\\u0000]+$"
+    },
+    "byteRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "start",
+        "end"
+      ],
+      "properties": {
+        "start": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "end": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "ext": {
+          "type": "object"
+        }
+      }
+    },
+    "relationType": {
+      "enum": [
+        "related",
+        "supports",
+        "supersedes",
+        "implements",
+        "depends_on",
+        "evidences",
+        "contradicts",
+        "belongs_to",
+        "links_to"
+      ]
+    },
+    "vaultPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?:(?![ .])[^/\\\\\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029:*?\"<>|#^\\[\\]]+(?<![ .])/)+(?![ .])[^/\\\\\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029:*?\"<>|#^\\[\\]]+(?<![ .])$"
+    },
+    "notePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?:(?![ .])[^/\\\\\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029:*?\"<>|#^\\[\\]]+(?<![ .])/)+(?![ .])[^/\\\\\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029:*?\"<>|#^\\[\\]]+(?<![ .])\\.md$"
+    }
+  }
+}

package/contracts/atelier-personal-workspace-manifest.v1.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mnstry.ai/schemas/atelier/atelier-personal-workspace-manifest.v1.schema.json",
+  "title": "atelier-personal-workspace-manifest@v1",
+  "description": "Private enrollment and interpretation only. This document grants no read, write, disclosure, consent, or effect authority.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema": {
+      "const": "atelier-personal-workspace-manifest@v1"
+    },
+    "workspaceId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,63}$"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "bindings": {
+      "type": "array",
+      "maxItems": 512,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 4096
+      }
+    },
+    "repos": {
+      "type": "array",
+      "maxItems": 512,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "repoId": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]{0,63}$"
+          },
+          "root": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4096
+          },
+          "remote": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
+          },
+          "enrolled": {
+            "type": "boolean"
+          },
+          "ext": {
+            "type": "object",
+            "maxProperties": 0,
+            "description": "Reserved for a later admitted extension. Non-empty extensions refuse in this version; they grant no authority."
+          }
+        },
+        "required": [
+          "repoId",
+          "root",
+          "remote",
+          "enrolled"
+        ]
+      }
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$"
+    },
+    "ext": {
+      "type": "object",
+      "maxProperties": 0,
+      "description": "Reserved for a later admitted extension. Non-empty extensions refuse in this version; they grant no authority."
+    }
+  },
+  "required": [
+    "schema",
+    "workspaceId",
+    "revision",
+    "bindings",
+    "repos"
+  ],
+  "$comment": "contract revision 1.0.0 (personal workspace contract)"
+}