@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/schemas/performance-policy-v1.json

@@ -0,0 +1,335 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://empirebuilderkit.dev/schemas/performance-policy-v1.json",
+  "$comment": "Structural interchange schema only. Semantic readiness, exact-reference resolution, protected-load authorization, and evidence validation require the performance module in @empire-builder-kit/nx.",
+  "title": "Empire Builder Kit performance policy v1 structural schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "authority",
+    "budgets",
+    "capacity",
+    "cost",
+    "evidence",
+    "kind",
+    "load",
+    "owner",
+    "reviewAt",
+    "schemaVersion",
+    "slice",
+    "tags"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "journeyAuthorityPath",
+        "operationsAuthorityPath",
+        "releaseManifestPath",
+        "repositoryPolicyPath"
+      ],
+      "properties": {
+        "journeyAuthorityPath": { "$ref": "#/$defs/reference" },
+        "operationsAuthorityPath": { "$ref": "#/$defs/reference" },
+        "releaseManifestPath": { "$ref": "#/$defs/reference" },
+        "repositoryPolicyPath": { "$ref": "#/$defs/reference" }
+      }
+    },
+    "budgets": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "comparator",
+          "evidenceProvenance",
+          "id",
+          "journeyRef",
+          "metric",
+          "population",
+          "scenarioRef",
+          "status",
+          "threshold",
+          "unit"
+        ],
+        "properties": {
+          "comparator": {
+            "type": "string",
+            "enum": ["maximum", "minimum"]
+          },
+          "evidenceProvenance": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 3,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "enum": ["estimate", "test", "actual"]
+            }
+          },
+          "id": { "$ref": "#/$defs/identifier" },
+          "journeyRef": { "$ref": "#/$defs/reference" },
+          "metric": {
+            "type": "string",
+            "enum": [
+              "backlog-age-seconds",
+              "bundle-bytes",
+              "cold-resume-milliseconds",
+              "error-rate",
+              "latency-milliseconds",
+              "monthly-cost-usd",
+              "throughput-per-second",
+              "timeout-rate",
+              "unit-cost-usd"
+            ]
+          },
+          "percentile": {
+            "type": "integer",
+            "enum": [50, 95, 99]
+          },
+          "population": {
+            "type": "string",
+            "enum": ["all", "cache-hit", "cache-miss", "cold", "warm"]
+          },
+          "scenarioRef": { "$ref": "#/$defs/reference" },
+          "status": {
+            "type": "string",
+            "enum": ["declared", "example"]
+          },
+          "threshold": {
+            "type": "number",
+            "exclusiveMinimum": 0
+          },
+          "unit": { "$ref": "#/$defs/reference" }
+        }
+      }
+    },
+    "capacity": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "capacityUnit",
+          "configuredMaximum",
+          "downstreamMaximum",
+          "failureMode",
+          "id",
+          "kind",
+          "protectionRef",
+          "quotaMaximum",
+          "saturationSignalRef",
+          "status"
+        ],
+        "properties": {
+          "capacityUnit": { "$ref": "#/$defs/reference" },
+          "configuredMaximum": { "$ref": "#/$defs/nullablePositive" },
+          "downstreamMaximum": { "$ref": "#/$defs/nullablePositive" },
+          "failureMode": { "$ref": "#/$defs/reference" },
+          "id": { "$ref": "#/$defs/identifier" },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "api-lambda",
+              "async-worker",
+              "browser",
+              "database",
+              "job",
+              "service"
+            ]
+          },
+          "protectionRef": { "$ref": "#/$defs/reference" },
+          "quotaMaximum": { "$ref": "#/$defs/nullablePositive" },
+          "saturationSignalRef": { "$ref": "#/$defs/reference" },
+          "status": {
+            "type": "string",
+            "enum": ["declared", "requires-adopter-value"]
+          }
+        }
+      }
+    },
+    "cost": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "accountMonthlyMaximumUsd",
+        "actualNotificationThresholdPercent",
+        "anomalyRouteRef",
+        "anomalyThresholdUsd",
+        "forecastNotificationThresholdPercent",
+        "notificationRoute",
+        "pilotMonthlyMaximumUsd",
+        "sharedCostAllocationRef",
+        "status",
+        "testRunMaximumUsd",
+        "unitCostRefs"
+      ],
+      "properties": {
+        "accountMonthlyMaximumUsd": {
+          "type": "number",
+          "minimum": 0.01,
+          "multipleOf": 0.01
+        },
+        "actualNotificationThresholdPercent": {
+          "$ref": "#/$defs/percentage"
+        },
+        "anomalyRouteRef": { "$ref": "#/$defs/reference" },
+        "anomalyThresholdUsd": {
+          "type": "number",
+          "minimum": 0.01,
+          "multipleOf": 0.01
+        },
+        "forecastNotificationThresholdPercent": {
+          "$ref": "#/$defs/percentage"
+        },
+        "notificationRoute": { "const": "foundation-alert-topic" },
+        "pilotMonthlyMaximumUsd": {
+          "type": "number",
+          "minimum": 0.01,
+          "multipleOf": 0.01
+        },
+        "sharedCostAllocationRef": { "$ref": "#/$defs/reference" },
+        "status": {
+          "type": "string",
+          "enum": ["declared", "example"]
+        },
+        "testRunMaximumUsd": {
+          "type": "number",
+          "minimum": 0.01,
+          "multipleOf": 0.01
+        },
+        "unitCostRefs": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/reference" }
+        }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maximumAgeDays", "protectedEvidenceRequiresExactRelease"],
+      "properties": {
+        "maximumAgeDays": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["actual", "estimate", "test"],
+          "properties": {
+            "actual": { "$ref": "#/$defs/positiveInteger" },
+            "estimate": { "$ref": "#/$defs/positiveInteger" },
+            "test": { "$ref": "#/$defs/positiveInteger" }
+          }
+        },
+        "protectedEvidenceRequiresExactRelease": { "const": true }
+      }
+    },
+    "kind": { "const": "ebk-performance-policy" },
+    "load": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "allowedProtectedStages",
+        "maximumConcurrency",
+        "maximumDurationSeconds",
+        "maximumEstimatedCostUsd",
+        "maximumRatePerSecond",
+        "maximumRequests",
+        "productionExceptionalOnly"
+      ],
+      "properties": {
+        "allowedProtectedStages": { "const": ["staging"] },
+        "maximumConcurrency": { "$ref": "#/$defs/positiveInteger" },
+        "maximumDurationSeconds": { "$ref": "#/$defs/positiveInteger" },
+        "maximumEstimatedCostUsd": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "maximumRatePerSecond": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "maximumRequests": { "$ref": "#/$defs/positiveInteger" },
+        "productionExceptionalOnly": { "const": true }
+      }
+    },
+    "owner": { "$ref": "#/$defs/reference" },
+    "reviewAt": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+        }
+      ]
+    },
+    "schemaVersion": { "const": 1 },
+    "slice": { "$ref": "#/$defs/identifier" },
+    "tags": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "forbiddenKeys",
+        "requiredKeys",
+        "unsupportedResourcePolicy"
+      ],
+      "properties": {
+        "forbiddenKeys": { "const": ["ebk:feature"] },
+        "requiredKeys": {
+          "const": [
+            "ebk:cost-allocation",
+            "ebk:cost-scope",
+            "ebk:framework-version",
+            "ebk:managed-by",
+            "ebk:owner",
+            "ebk:production-profile",
+            "ebk:repository",
+            "ebk:slice",
+            "ebk:stage",
+            "ebk:workspace"
+          ]
+        },
+        "unsupportedResourcePolicy": {
+          "const": "report-with-reason-and-allocation"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+    },
+    "nullablePositive": {
+      "oneOf": [{ "type": "null" }, { "type": "number", "exclusiveMinimum": 0 }]
+    },
+    "positiveInteger": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "percentage": {
+      "type": "number",
+      "exclusiveMinimum": 0,
+      "maximum": 100
+    },
+    "reference": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^[A-Za-z0-9.][A-Za-z0-9._:/#@+\\-]{0,511}$"
+    }
+  }
+}

package/src/schemas/repository-policy-v1.json

@@ -8,6 +8,7 @@
     "schemaVersion",
     "productionAccess",
     "productionApproval",
+    "productionFoundation",
     "slices"
   ],
   "properties": {

package/src/schemas/testing-evidence-quarantine-v1.json

@@ -0,0 +1,168 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://empirebuilderkit.dev/schemas/testing-evidence-quarantine-v1.json",
+  "$comment": "Structural interchange schema only. Semantic acceptance requires validateTestingEvidenceQuarantine with trusted time and workflow-run context from @empire-builder-kit/nx/testing-evidence.",
+  "title": "Empire Builder Kit testing evidence quarantine v1 structural schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["records", "schemaVersion"],
+  "properties": {
+    "records": {
+      "type": "array",
+      "maxItems": 256,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "affectedRisk",
+          "compensatingProof",
+          "expiry",
+          "failureEvidence",
+          "gate",
+          "gateCoverage",
+          "id",
+          "owner",
+          "reason",
+          "testId",
+          "workItem"
+        ],
+        "properties": {
+          "accessibility": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["approver", "journey", "kind", "wcagCriteria"],
+            "properties": {
+              "approver": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256,
+                "pattern": "^[A-Za-z0-9@][A-Za-z0-9._:@/-]*$"
+              },
+              "journey": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256,
+                "pattern": "^[A-Za-z0-9@][A-Za-z0-9._:@/-]*$"
+              },
+              "kind": { "const": "accessibility" },
+              "wcagCriteria": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 32,
+                "uniqueItems": true,
+                "items": {
+                  "type": "string",
+                  "pattern": "^[1-4]\\.[1-9][0-9]*\\.[1-9][0-9]*$"
+                }
+              }
+            }
+          },
+          "affectedRisk": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024
+          },
+          "compensatingProof": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024
+          },
+          "expiry": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["expiresAt", "kind"],
+                "properties": {
+                  "expiresAt": { "type": "string", "format": "date-time" },
+                  "kind": { "const": "date" }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["expiresAfterRun", "kind", "workflow"],
+                "properties": {
+                  "expiresAfterRun": {
+                    "type": "integer",
+                    "minimum": 1
+                  },
+                  "kind": { "const": "run-count" },
+                  "workflow": {
+                    "type": "string",
+                    "pattern": "^\\.github/workflows/[A-Za-z0-9][A-Za-z0-9._-]*\\.ya?ml$"
+                  }
+                }
+              }
+            ]
+          },
+          "failureEvidence": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024
+          },
+          "gate": {
+            "type": "string",
+            "enum": [
+              "none",
+              "security",
+              "contract-compatibility",
+              "migration",
+              "protected-deployment"
+            ]
+          },
+          "gateCoverage": {
+            "type": "string",
+            "enum": ["none", "supplemental"]
+          },
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[A-Za-z0-9@][A-Za-z0-9._:@/-]*$"
+          },
+          "owner": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[A-Za-z0-9@][A-Za-z0-9._:@/-]*$"
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024
+          },
+          "testId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[A-Za-z0-9@][A-Za-z0-9._:@/-]*$"
+          },
+          "workItem": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[A-Za-z0-9@][A-Za-z0-9._:@/-]*$"
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": { "gate": { "const": "none" } },
+              "required": ["gate"]
+            },
+            "then": {
+              "properties": { "gateCoverage": { "const": "none" } }
+            },
+            "else": {
+              "properties": {
+                "gateCoverage": { "const": "supplemental" }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "schemaVersion": { "const": 1 }
+  }
+}