@apexops/contracts 0.10.0-next.5 → 0.11.0-next.0

package/schemas/architecture-v1.schema.json

@@ -31,6 +31,15 @@
             "type": "array",
             "uniqueItems": true
           },
+          "resourceTypes": {
+            "items": {
+              "pattern": "^[A-Za-z][A-Za-z0-9]*\\.[A-Za-z][A-Za-z0-9.]*(?:/[A-Za-z][A-Za-z0-9]*)+$",
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
           "service": {
             "minLength": 1,
             "type": "string"
@@ -39,6 +48,7 @@
         "required": [
           "id",
           "service",
+          "resourceTypes",
           "purpose",
           "requirementIds",
           "dependsOn"
@@ -48,6 +58,155 @@
       "minItems": 1,
       "type": "array"
     },
+    "decisionRecords": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "alternatives": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "benefits": {
+                  "maxLength": 2048,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "drawbacks": {
+                  "maxLength": 2048,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "option": {
+                  "maxLength": 256,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "rejectionReason": {
+                  "maxLength": 2048,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "option",
+                "benefits",
+                "drawbacks",
+                "rejectionReason"
+              ],
+              "type": "object"
+            },
+            "maxItems": 10,
+            "minItems": 2,
+            "type": "array"
+          },
+          "complianceConsiderations": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "context": {
+            "maxLength": 4096,
+            "minLength": 1,
+            "type": "string"
+          },
+          "decision": {
+            "maxLength": 4096,
+            "minLength": 1,
+            "type": "string"
+          },
+          "id": {
+            "pattern": "^ADR-[0-9]{4}$",
+            "type": "string"
+          },
+          "implementationNotes": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "negativeConsequences": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 32,
+            "minItems": 1,
+            "type": "array"
+          },
+          "positiveConsequences": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 32,
+            "minItems": 1,
+            "type": "array"
+          },
+          "requirementIds": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 256,
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "title": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "wafImpacts": {
+            "additionalProperties": false,
+            "properties": {
+              "cost-optimization": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "operational-excellence": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "performance-efficiency": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "reliability": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "security": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "security",
+              "reliability",
+              "performance-efficiency",
+              "cost-optimization",
+              "operational-excellence"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "context",
+          "decision",
+          "requirementIds",
+          "alternatives",
+          "positiveConsequences",
+          "negativeConsequences",
+          "wafImpacts",
+          "complianceConsiderations",
+          "implementationNotes"
+        ],
+        "type": "object"
+      },
+      "maxItems": 64,
+      "minItems": 1,
+      "type": "array"
+    },
     "decisions": {
       "items": {
         "minLength": 1,
@@ -90,6 +249,125 @@
     "title": {
       "minLength": 1,
       "type": "string"
+    },
+    "wellArchitectedAssessment": {
+      "additionalProperties": false,
+      "properties": {
+        "assessmentType": {
+          "const": "qualitative",
+          "type": "string"
+        },
+        "framework": {
+          "const": "azure-well-architected-framework",
+          "type": "string"
+        },
+        "pillars": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "assessment": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "evidenceRefs": {
+                "items": {
+                  "pattern": "^[0-9a-f]{64}$",
+                  "type": "string"
+                },
+                "type": "array",
+                "uniqueItems": true
+              },
+              "pillar": {
+                "anyOf": [
+                  {
+                    "const": "security",
+                    "type": "string"
+                  },
+                  {
+                    "const": "reliability",
+                    "type": "string"
+                  },
+                  {
+                    "const": "performance-efficiency",
+                    "type": "string"
+                  },
+                  {
+                    "const": "cost-optimization",
+                    "type": "string"
+                  },
+                  {
+                    "const": "operational-excellence",
+                    "type": "string"
+                  }
+                ]
+              },
+              "recommendations": {
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "array",
+                "uniqueItems": true
+              },
+              "requirementIds": {
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "array",
+                "uniqueItems": true
+              },
+              "status": {
+                "anyOf": [
+                  {
+                    "const": "aligned",
+                    "type": "string"
+                  },
+                  {
+                    "const": "concern",
+                    "type": "string"
+                  },
+                  {
+                    "const": "blocker",
+                    "type": "string"
+                  },
+                  {
+                    "const": "not-applicable",
+                    "type": "string"
+                  }
+                ]
+              },
+              "tradeoffs": {
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "array",
+                "uniqueItems": true
+              }
+            },
+            "required": [
+              "pillar",
+              "status",
+              "assessment",
+              "requirementIds",
+              "evidenceRefs",
+              "recommendations",
+              "tradeoffs"
+            ],
+            "type": "object"
+          },
+          "maxItems": 5,
+          "minItems": 5,
+          "type": "array"
+        }
+      },
+      "required": [
+        "framework",
+        "assessmentType",
+        "pillars"
+      ],
+      "type": "object"
     }
   },
   "required": [

package/schemas/bootstrap-plan-v1.schema.json

@@ -0,0 +1,206 @@
+{
+  "$id": "https://schemas.apexops.dev/bootstrap-plan-v1.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "checks": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "anyOf": [
+              {
+                "const": "repository",
+                "type": "string"
+              },
+              {
+                "const": "workspace-runtime",
+                "type": "string"
+              },
+              {
+                "const": "apex-state",
+                "type": "string"
+              }
+            ]
+          },
+          "reason": {
+            "maxLength": 1024,
+            "minLength": 1,
+            "type": "string"
+          },
+          "status": {
+            "anyOf": [
+              {
+                "const": "ready",
+                "type": "string"
+              },
+              {
+                "const": "pending",
+                "type": "string"
+              },
+              {
+                "const": "blocked",
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "status",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "maxItems": 3,
+      "minItems": 3,
+      "type": "array"
+    },
+    "config": {
+      "$id": "https://schemas.apexops.dev/onboarding-config-v1.json",
+      "additionalProperties": false,
+      "properties": {
+        "client": {
+          "const": "github-copilot-cli",
+          "type": "string"
+        },
+        "createRepository": {
+          "type": "boolean"
+        },
+        "displayName": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "environment": {
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "type": "string"
+        },
+        "iacTool": {
+          "anyOf": [
+            {
+              "const": "bicep",
+              "type": "string"
+            },
+            {
+              "const": "terraform",
+              "type": "string"
+            }
+          ]
+        },
+        "projectId": {
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "type": "string"
+        },
+        "riskOwner": {
+          "anyOf": [
+            {
+              "const": "partner",
+              "type": "string"
+            },
+            {
+              "const": "customer",
+              "type": "string"
+            }
+          ]
+        },
+        "schemaVersion": {
+          "const": "1.0.0",
+          "type": "string"
+        },
+        "targetScope": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "schemaVersion"
+      ],
+      "type": "object"
+    },
+    "configHash": {
+      "pattern": "^[0-9a-f]{64}$",
+      "type": "string"
+    },
+    "executionAuthorized": {
+      "const": false,
+      "type": "boolean"
+    },
+    "filesModified": {
+      "const": false,
+      "type": "boolean"
+    },
+    "runtimeVersion": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "schemaVersion": {
+      "const": "1.0.0",
+      "type": "string"
+    },
+    "scope": {
+      "const": "local-bootstrap-preflight-v1",
+      "type": "string"
+    },
+    "status": {
+      "anyOf": [
+        {
+          "const": "ready",
+          "type": "string"
+        },
+        {
+          "const": "pending",
+          "type": "string"
+        },
+        {
+          "const": "blocked",
+          "type": "string"
+        }
+      ]
+    },
+    "unassessed": {
+      "additionalItems": false,
+      "items": [
+        {
+          "const": "machine-prerequisites",
+          "type": "string"
+        },
+        {
+          "const": "client-health",
+          "type": "string"
+        },
+        {
+          "const": "remote-coe",
+          "type": "string"
+        },
+        {
+          "const": "github-repository",
+          "type": "string"
+        },
+        {
+          "const": "governance-oidc",
+          "type": "string"
+        },
+        {
+          "const": "reviewed-baseline",
+          "type": "string"
+        }
+      ],
+      "maxItems": 6,
+      "minItems": 6,
+      "type": "array"
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "config",
+    "configHash",
+    "runtimeVersion",
+    "scope",
+    "status",
+    "checks",
+    "unassessed",
+    "filesModified",
+    "executionAuthorized"
+  ],
+  "type": "object"
+}

package/schemas/contract-metadata.json

@@ -4,6 +4,21 @@
     "maxBytes": 32768,
     "sensitivity": "confidential"
   },
+  "https://schemas.apexops.dev/archetype-batch-config-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 16384,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/archetype-batch-plan-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 2097152,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/archetype-source-proposal-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 524288,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/architecture-availability-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 131072,
@@ -14,6 +29,11 @@
     "maxBytes": 1048576,
     "sensitivity": "internal"
   },
+  "https://schemas.apexops.dev/bootstrap-plan-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 65536,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/capability-pack-manifest-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 262144,
@@ -79,6 +99,26 @@
     "maxBytes": 131072,
     "sensitivity": "confidential"
   },
+  "https://schemas.apexops.dev/governance-observation-receipt-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 16384,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/governance-provision-plan-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 65536,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/governance-setup-config-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 16384,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/governance-setup-plan-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 32768,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/iac-binding-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 524288,
@@ -139,6 +179,11 @@
     "maxBytes": 2097152,
     "sensitivity": "internal"
   },
+  "https://schemas.apexops.dev/native-validation-receipt-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 8404992,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/onboarding-config-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 16384,
@@ -154,6 +199,11 @@
     "maxBytes": 2097152,
     "sensitivity": "confidential"
   },
+  "https://schemas.apexops.dev/policy-validation-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 4194304,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/pricing-evidence-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 524288,
@@ -184,6 +234,31 @@
     "maxBytes": 262144,
     "sensitivity": "public"
   },
+  "https://schemas.apexops.dev/repeat-guard-records-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 6356992,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/repository-publish-config-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 16384,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/repository-publish-plan-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 262144,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/requirements-amendment-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 262144,
+    "sensitivity": "confidential"
+  },
+  "https://schemas.apexops.dev/requirements-change-proposal-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 524288,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/requirements-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 524288,
@@ -194,11 +269,21 @@
     "maxBytes": 4194304,
     "sensitivity": "confidential"
   },
+  "https://schemas.apexops.dev/review-capture-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 1048576,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/review-findings-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 1048576,
     "sensitivity": "confidential"
   },
+  "https://schemas.apexops.dev/review-request-v1.json": {
+    "compatibility": "strict-v1",
+    "maxBytes": 65536,
+    "sensitivity": "confidential"
+  },
   "https://schemas.apexops.dev/run-config-v1.json": {
     "compatibility": "strict-v1",
     "maxBytes": 65536,