@agent-teams/engineering-foundation 0.21.0 → 1.0.1

package/schemas/document-authoring-profile/v2.schema.json

@@ -1,168 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/document-authoring-profile/v2",
-  "title": "Document Authoring Profile v2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "projectId", "catalog", "authoring"],
-  "properties": {
-    "schemaVersion": { "const": 2 },
-    "projectId": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
-    "catalog": { "$ref": "#/$defs/catalog" },
-    "authoring": { "$ref": "#/$defs/authoring" }
-  },
-  "$defs": {
-    "catalog": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["metadataSchemaPath", "ownerCatalog", "collections"],
-      "properties": {
-        "metadataSchemaPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
-        "ownerCatalog": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["path", "contract"],
-          "properties": {
-            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
-            "contract": { "const": "foundation.owner-map/v1" }
-          }
-        },
-        "collections": {
-          "type": "array",
-          "minItems": 1,
-          "maxItems": 32,
-          "items": {
-            "oneOf": [
-              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/markdownTreeCollection" },
-              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/frontmatterReadmeCollection" }
-            ]
-          }
-        },
-        "excludedPrefixes": {
-          "type": "array",
-          "maxItems": 128,
-          "uniqueItems": true,
-          "items": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-        },
-        "metadataSidecar": { "$ref": "#/$defs/metadataSidecar" }
-      }
-    },
-    "metadataSidecar": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "path"],
-      "properties": {
-        "kind": { "const": "path-metadata-map" },
-        "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-      }
-    },
-    "authoring": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["mode", "artifactTypes"],
-      "properties": {
-        "mode": { "const": "create-only" },
-        "artifactTypes": {
-          "type": "array",
-          "minItems": 1,
-          "maxItems": 32,
-          "items": { "$ref": "#/$defs/artifactType" }
-        }
-      }
-    },
-    "artifactType": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "type",
-        "initialStatus",
-        "identity",
-        "placement",
-        "template",
-        "heading",
-        "reachability",
-        "allowedOwnerIds"
-      ],
-      "properties": {
-        "type": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
-        "initialStatus": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
-        "identity": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/identity" },
-        "placement": {
-          "oneOf": [
-            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/collectionPlacement" },
-            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/qualifiedLeafIndexPlacement" },
-            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/explicitPlacement" }
-          ]
-        },
-        "template": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "path"],
-          "properties": {
-            "kind": { "const": "fenced-markdown-body" },
-            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-          }
-        },
-        "heading": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind"],
-          "properties": {
-            "kind": { "enum": ["id-colon-title", "title"] }
-          }
-        },
-        "reachability": { "$ref": "#/$defs/reachability" },
-        "allowedOwnerIds": { "$ref": "#/$defs/allowedOwnerIds" }
-      }
-    },
-    "allowedOwnerIds": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 4096,
-      "uniqueItems": true,
-      "items": {
-        "type": "string",
-        "minLength": 1,
-        "maxLength": 214,
-        "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$"
-      }
-    },
-    "reachability": {
-      "oneOf": [
-        {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "indexPath"],
-          "properties": {
-            "kind": { "const": "manual-fixed-index" },
-            "indexPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-          }
-        },
-        {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "pathPrefix", "indexBasename"],
-          "properties": {
-            "kind": { "const": "manual-colocated-index" },
-            "pathPrefix": { "const": "before-required-segments" },
-            "indexBasename": { "const": "README.md" }
-          }
-        },
-        {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "reason"],
-          "properties": {
-            "kind": { "const": "not-required" },
-            "reason": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 500,
-              "pattern": "^[^\\u0000-\\u001F\\u007F]+$"
-            }
-          }
-        }
-      ]
-    }
-  }
-}

package/schemas/document-authoring-profile/v3.schema.json

@@ -1,200 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/document-authoring-profile/v3",
-  "title": "Document Authoring Profile v3",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "projectId", "catalog", "authoring"],
-  "properties": {
-    "schemaVersion": { "const": 3 },
-    "projectId": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
-    "catalog": { "$ref": "#/$defs/catalog" },
-    "authoring": { "$ref": "#/$defs/authoring" }
-  },
-  "$defs": {
-    "catalog": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["metadataSchemaPath", "ownerCatalog", "collections"],
-      "properties": {
-        "metadataSchemaPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
-        "ownerCatalog": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["path", "contract"],
-          "properties": {
-            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
-            "contract": { "const": "foundation.owner-map/v1" }
-          }
-        },
-        "collections": {
-          "type": "array",
-          "minItems": 1,
-          "maxItems": 32,
-          "items": {
-            "oneOf": [
-              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/markdownTreeCollection" },
-              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/frontmatterReadmeCollection" }
-            ]
-          }
-        },
-        "excludedPrefixes": {
-          "type": "array",
-          "maxItems": 128,
-          "uniqueItems": true,
-          "items": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-        },
-        "metadataSidecar": { "$ref": "#/$defs/metadataSidecar" }
-      }
-    },
-    "metadataSidecar": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "path"],
-      "properties": {
-        "kind": { "const": "path-metadata-map" },
-        "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-      }
-    },
-    "authoring": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["mode", "artifactTypes"],
-      "properties": {
-        "mode": { "const": "create-only" },
-        "ownerSets": { "$ref": "#/$defs/ownerSets" },
-        "artifactTypes": {
-          "type": "array",
-          "minItems": 1,
-          "maxItems": 32,
-          "items": { "$ref": "#/$defs/artifactType" }
-        }
-      }
-    },
-    "artifactType": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "type",
-        "initialStatus",
-        "identity",
-        "placement",
-        "template",
-        "heading",
-        "reachability"
-      ],
-      "oneOf": [
-        {
-          "required": ["allowedOwnerIds"],
-          "properties": { "allowedOwnerIds": true }
-        },
-        {
-          "required": ["ownerSetId"],
-          "properties": { "ownerSetId": true }
-        }
-      ],
-      "properties": {
-        "type": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
-        "initialStatus": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
-        "identity": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/identity" },
-        "placement": {
-          "oneOf": [
-            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/collectionPlacement" },
-            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/qualifiedLeafIndexPlacement" },
-            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/explicitPlacement" }
-          ]
-        },
-        "template": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "path"],
-          "properties": {
-            "kind": { "const": "fenced-markdown-body" },
-            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-          }
-        },
-        "heading": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind"],
-          "properties": {
-            "kind": { "enum": ["id-colon-title", "title"] }
-          }
-        },
-        "reachability": { "$ref": "#/$defs/reachability" },
-        "allowedOwnerIds": { "$ref": "#/$defs/allowedOwnerIds" },
-        "ownerSetId": { "$ref": "#/$defs/ownerSetId" }
-      }
-    },
-    "ownerSetId": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 160,
-      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
-    },
-    "ownerSets": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["schemaVersion", "sets"],
-      "properties": {
-        "schemaVersion": { "const": 1 },
-        "sets": {
-          "type": "object",
-          "minProperties": 1,
-          "maxProperties": 128,
-          "propertyNames": { "$ref": "#/$defs/ownerSetId" },
-          "additionalProperties": { "$ref": "#/$defs/allowedOwnerIds" }
-        }
-      }
-    },
-    "allowedOwnerIds": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 4096,
-      "uniqueItems": true,
-      "items": {
-        "type": "string",
-        "minLength": 1,
-        "maxLength": 214,
-        "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$"
-      }
-    },
-    "reachability": {
-      "oneOf": [
-        {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "indexPath"],
-          "properties": {
-            "kind": { "const": "manual-fixed-index" },
-            "indexPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
-          }
-        },
-        {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "pathPrefix", "indexBasename"],
-          "properties": {
-            "kind": { "const": "manual-colocated-index" },
-            "pathPrefix": { "const": "before-required-segments" },
-            "indexBasename": { "const": "README.md" }
-          }
-        },
-        {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["kind", "reason"],
-          "properties": {
-            "kind": { "const": "not-required" },
-            "reason": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 500,
-              "pattern": "^[^\\u0000-\\u001F\\u007F]+$"
-            }
-          }
-        }
-      ]
-    }
-  }
-}

package/schemas/document-command-envelope/v1.schema.json

@@ -1,161 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/document-command-envelope/v1",
-  "title": "Document Command Envelope",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "command", "outcome", "diagnostics", "result"],
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "command": { "enum": ["docs.doctor", "docs.find", "docs.new", "docs.recover"] },
-    "outcome": { "enum": ["success", "partial", "conflict", "violation", "authority-stale", "recovery-required", "invalid-input", "execution-failure", "cancelled"] },
-    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
-    "result": {
-      "oneOf": [
-        { "$ref": "#/$defs/findResult" },
-        { "$ref": "#/$defs/newResult" },
-        { "$ref": "#/$defs/doctorResult" },
-        { "$ref": "#/$defs/recoverResult" }
-      ]
-    }
-  },
-  "allOf": [
-    { "$ref": "#/$defs/findEnvelope" },
-    { "$ref": "#/$defs/newEnvelope" },
-    { "$ref": "#/$defs/doctorEnvelope" },
-    { "$ref": "#/$defs/recoverEnvelope" }
-  ],
-  "$defs": {
-    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
-    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
-    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
-    "semver": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" },
-    "repositoryPath": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 512,
-      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\.(?:/|$))(?!.*(?:^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])(?:\\.[A-Za-z0-9._@-]*)?(?:/|$))[A-Za-z0-9._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
-    },
-    "documentDescriptor": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "type", "status", "owner", "summary", "repositoryPath", "title", "source"],
-      "properties": {
-        "id": { "$ref": "#/$defs/opaqueId" },
-        "type": { "$ref": "#/$defs/lowerId" },
-        "status": { "$ref": "#/$defs/lowerId" },
-        "owner": { "$ref": "#/$defs/opaqueId" },
-        "summary": { "type": "string", "minLength": 1, "maxLength": 1000 },
-        "repositoryPath": { "$ref": "#/$defs/repositoryPath" },
-        "title": { "type": "string", "minLength": 1, "maxLength": 240 },
-        "source": { "enum": ["frontmatter-readme", "markdown-tree"] }
-      }
-    },
-    "findResult": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "matches", "documents"],
-      "properties": {
-        "kind": { "const": "find" },
-        "matches": { "type": "integer", "minimum": 0, "maximum": 100000 },
-        "documents": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/documentDescriptor" } }
-      }
-    },
-    "newResult": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "documentPath", "reachability"],
-      "properties": {
-        "kind": { "const": "new" },
-        "documentPath": { "$ref": "#/$defs/repositoryPath" },
-        "reachability": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["state"],
-          "properties": {
-            "state": { "enum": ["manual-required", "managed", "not-required"] },
-            "indexPath": { "$ref": "#/$defs/repositoryPath" },
-            "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
-          },
-          "allOf": [
-            {
-              "if": { "type": "object", "properties": { "state": { "const": "manual-required" } }, "required": ["state"] },
-              "then": {
-                "type": "object",
-                "required": ["indexPath", "markdownLink"],
-                "properties": {
-                  "indexPath": { "$ref": "#/$defs/repositoryPath" },
-                  "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
-                }
-              }
-            }
-          ]
-        }
-      }
-    },
-    "doctorResult": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "transactionState", "recoveryClass"],
-      "properties": {
-        "kind": { "const": "doctor" },
-        "transactionState": { "enum": ["none", "pending", "tampered", "unknown-version"] },
-        "protocolKind": { "enum": ["document-authoring", "scaffolding"] },
-        "foundationVersion": { "$ref": "#/$defs/semver" },
-        "recoveryClass": { "enum": ["auto-recoverable", "manual", "not-required"] }
-      }
-    },
-    "recoverResult": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "transactionState"],
-      "properties": {
-        "kind": { "const": "recover" },
-        "transactionState": { "enum": ["already-applied", "manual-required", "no-pending-transaction", "recovered"] },
-        "receiptDigest": { "$ref": "#/$defs/digest" }
-      }
-    },
-    "findEnvelope": {
-      "if": { "type": "object", "properties": { "command": { "const": "docs.find" } }, "required": ["command"] },
-      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/findResult" } } }
-    },
-    "newEnvelope": {
-      "if": { "type": "object", "properties": { "command": { "const": "docs.new" } }, "required": ["command"] },
-      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/newResult" } } }
-    },
-    "doctorEnvelope": {
-      "if": { "type": "object", "properties": { "command": { "const": "docs.doctor" } }, "required": ["command"] },
-      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/doctorResult" } } }
-    },
-    "recoverEnvelope": {
-      "if": { "type": "object", "properties": { "command": { "const": "docs.recover" } }, "required": ["command"] },
-      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/recoverResult" } } }
-    },
-    "diagnostic": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["ruleId", "severity", "phase", "subject", "message"],
-      "properties": {
-        "ruleId": { "$ref": "#/$defs/opaqueId" },
-        "severity": { "enum": ["error", "info", "warning"] },
-        "phase": { "enum": ["apply", "authority", "input", "planning", "query", "recovery"] },
-        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
-        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
-        "remediation": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["commandId", "args"],
-          "properties": {
-            "commandId": { "enum": ["docs.doctor", "docs.find", "docs.new", "docs.recover"] },
-            "args": {
-              "type": "object",
-              "maxProperties": 16,
-              "propertyNames": { "pattern": "^[a-z][a-zA-Z0-9]*$", "maxLength": 64 },
-              "additionalProperties": { "type": "string", "maxLength": 512 }
-            }
-          }
-        }
-      }
-    }
-  }
-}