@aiwg/cli 2026.9.20 → 2026.9.21

package/schemas/decision/CalibrationArtifact.v1.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/CalibrationArtifact.v1.schema.json",
+  "title": "Decision Calibration Artifact",
+  "type": "object",
+  "required": ["schemaVersion", "id", "digest", "identity", "splitProvenance", "profile", "metrics", "effectiveAt", "limitations", "approval"],
+  "properties": {
+    "schemaVersion": { "const": "decision-calibration-artifact/v1" },
+    "id": { "type": "string", "minLength": 1 },
+    "digest": { "$ref": "#/$defs/digest" },
+    "identity": { "$ref": "#/$defs/identity" },
+    "splitProvenance": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "hash", "holdoutAccessedAt"],
+      "properties": { "id": { "type": "string", "minLength": 1 }, "hash": { "$ref": "#/$defs/digest" }, "holdoutAccessedAt": { "type": ["string", "null"], "format": "date-time" } }
+    },
+    "profile": {
+      "type": "object", "additionalProperties": false,
+      "required": ["minimumTotalSamples", "minimumPerSliceSamples", "powerRule", "confidenceInterval", "maximumCalibrationError", "maximumSelectiveRisk", "expiresAfterDays"],
+      "properties": {
+        "minimumTotalSamples": { "type": "integer", "minimum": 1 },
+        "minimumPerSliceSamples": { "type": "integer", "minimum": 1 },
+        "powerRule": { "type": ["string", "null"] },
+        "confidenceInterval": {
+          "type": "object", "additionalProperties": false, "required": ["method", "level"],
+          "properties": { "method": { "type": "string", "minLength": 1 }, "level": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 } }
+        },
+        "maximumCalibrationError": { "type": "number", "minimum": 0, "maximum": 1 },
+        "maximumSelectiveRisk": { "type": "number", "minimum": 0, "maximum": 1 },
+        "expiresAfterDays": { "type": "number", "exclusiveMinimum": 0 }
+      }
+    },
+    "metrics": {
+      "type": "object", "additionalProperties": false,
+      "required": ["totalSamples", "perSliceSamples", "calibrationError", "selectiveRisk", "confidenceIntervals"],
+      "properties": {
+        "totalSamples": { "type": "integer", "minimum": 0 }, "perSliceSamples": { "type": "integer", "minimum": 0 },
+        "calibrationError": { "type": "number", "minimum": 0 }, "selectiveRisk": { "type": "number", "minimum": 0 },
+        "confidenceIntervals": { "type": "object", "minProperties": 1, "additionalProperties": { "$ref": "#/$defs/interval" } }
+      }
+    },
+    "effectiveAt": { "type": "string", "format": "date-time" },
+    "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "approval": {
+      "type": "object", "additionalProperties": false, "required": ["state", "reference"],
+      "properties": { "state": { "enum": ["observed", "approved", "rejected", "retired"] }, "reference": { "type": ["string", "null"] } }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "namedHash": { "type": "object", "additionalProperties": false, "required": ["id", "hash"], "properties": { "id": { "type": "string", "minLength": 1 }, "hash": { "$ref": "#/$defs/digest" } } },
+    "identity": {
+      "type": "object", "additionalProperties": false,
+      "required": ["provider", "backend", "actualModel", "primitive", "definitionDigest", "adapterVersion", "dataset", "slice", "calibrator"],
+      "properties": {
+        "provider": { "type": "string", "minLength": 1 }, "backend": { "type": "string", "minLength": 1 }, "actualModel": { "type": "string", "minLength": 1 },
+        "primitive": { "type": "string", "minLength": 1 }, "definitionDigest": { "$ref": "#/$defs/digest" }, "adapterVersion": { "type": "string", "minLength": 1 },
+        "dataset": { "$ref": "#/$defs/namedHash" }, "slice": { "$ref": "#/$defs/namedHash" },
+        "calibrator": {
+          "type": "object", "additionalProperties": false, "required": ["id", "version", "parametersDigest"],
+          "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 }, "parametersDigest": { "$ref": "#/$defs/digest" } }
+        }
+      }
+    },
+    "interval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lower", "upper"],
+      "properties": {
+        "lower": { "type": "number", "minimum": 0, "maximum": 1 },
+        "upper": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    }
+  }
+}

package/schemas/decision/CalibrationCompatibility.v1.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/CalibrationCompatibility.v1.schema.json",
+  "title": "Pinned Calibration Compatibility Decision",
+  "type": "object",
+  "required": ["schemaVersion", "pinId", "runId", "requestedAlias", "actualModel", "aliasRevision", "artifactId", "artifactDigest", "state", "action", "reasons", "decidedAt"],
+  "properties": {
+    "schemaVersion": { "const": "decision-calibration-compatibility/v1" },
+    "pinId": { "type": "string", "minLength": 1 }, "runId": { "type": "string", "minLength": 1 },
+    "requestedAlias": { "type": "string", "minLength": 1 }, "actualModel": { "type": "string", "minLength": 1 },
+    "aliasRevision": { "type": ["integer", "null"], "minimum": 1 }, "artifactId": { "type": ["string", "null"] },
+    "artifactDigest": { "anyOf": [{ "type": "null" }, { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }] },
+    "state": { "enum": ["exact", "approved-compatible", "shadow-required", "incompatible", "unknown"] },
+    "action": { "enum": ["allow", "fail", "defer", "shadow", "require-approval"] },
+    "reasons": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "decidedAt": { "type": "string", "format": "date-time" }
+  },
+  "additionalProperties": false
+}

package/schemas/decision/CalibrationGovernanceReceipt.v1.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/CalibrationGovernanceReceipt.v1.schema.json",
+  "title": "Calibration Governance Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "receiptId", "sequence", "kind", "alias", "from", "to", "action", "reviewedEvidence", "approvalReference", "eligibilityId", "reasons", "recordedAt", "previousReceiptDigest", "digest"],
+  "properties": {
+    "schemaVersion": { "const": "decision-calibration-governance-receipt/v1" },
+    "receiptId": { "type": "string", "minLength": 1 },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "kind": { "enum": ["promotion", "rollback"] },
+    "alias": { "type": "string", "minLength": 1 },
+    "from": { "$ref": "#/$defs/aliasPin" },
+    "to": { "$ref": "#/$defs/aliasPin" },
+    "action": { "enum": ["promote", "rollback"] },
+    "reviewedEvidence": {
+      "type": "object", "additionalProperties": false,
+      "required": ["evaluationIntegrityReport", "calibrationArtifact", "compatibilityRelation"],
+      "properties": {
+        "evaluationIntegrityReport": { "$ref": "#/$defs/artifactPin" },
+        "calibrationArtifact": { "$ref": "#/$defs/artifactPin" },
+        "compatibilityRelation": { "anyOf": [{ "$ref": "#/$defs/artifactPin" }, { "type": "null" }] }
+      }
+    },
+    "approvalReference": { "type": "string", "minLength": 1 },
+    "eligibilityId": { "type": ["string", "null"], "minLength": 1 },
+    "reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "previousReceiptDigest": { "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+    "digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "artifactPin": {
+      "type": "object", "additionalProperties": false, "required": ["id", "digest"],
+      "properties": { "id": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "aliasPin": {
+      "type": "object", "additionalProperties": false, "required": ["aliasRevision", "identityDigest"],
+      "properties": { "aliasRevision": { "type": "integer", "minimum": 1 }, "identityDigest": { "$ref": "#/$defs/digest" } }
+    }
+  }
+}

package/schemas/decision/DecisionAdmissionEvidence.v1.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionAdmissionEvidence.v1.schema.json",
+  "type": "object",
+  "properties": {
+    "decision": { "enum": ["admit", "defer", "reject"] },
+    "reason": {
+      "enum": [
+        "admitted", "disabled", "cancelled", "deadline-exceeded", "concurrency",
+        "requests-per-minute", "tokens-per-second", "attempts", "batch-size", "cost",
+        "unknown-cost", "tokens", "unknown-tokens", "queue-full", "queue-timeout", "invalid-estimate", "request-too-large", "too-many-items",
+        "retained-work", "unknown-retained-work",
+        "retry-after", "circuit-open", "unconfigured-provider"
+      ]
+    },
+    "queueDelayMs": { "type": "number", "minimum": 0 },
+    "active": { "type": "integer", "minimum": 0 },
+    "queued": { "type": "integer", "minimum": 0 },
+    "estimatedTokens": { "type": ["integer", "null"], "minimum": 0 },
+    "estimatedCostUsd": { "type": ["number", "null"], "minimum": 0 },
+    "retryPressure": { "type": "integer", "minimum": 0 },
+    "breakerState": { "enum": ["closed", "open", "half-open"] },
+    "retryAfterMs": { "type": "integer", "minimum": 1, "maximum": 30000 },
+    "breakerTransitions": {
+      "type": "array",
+      "maxItems": 2,
+      "items": {
+        "type": "object",
+        "properties": {
+          "from": { "enum": ["closed", "open", "half-open"] },
+          "to": { "enum": ["closed", "open", "half-open"] }
+        },
+        "required": ["from", "to"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "decision", "reason", "queueDelayMs", "active", "queued", "estimatedTokens",
+    "estimatedCostUsd", "retryPressure", "breakerState"
+  ],
+  "additionalProperties": false
+}

package/schemas/decision/DecisionBinding.schema.json

@@ -0,0 +1,309 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionBinding.v1alpha1.schema.json",
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "const": "decision.aiwg.io/v1alpha1"
+    },
+    "kind": {
+      "const": "DecisionBinding"
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "version",
+        "description"
+      ],
+      "additionalProperties": false
+    },
+    "spec": {
+      "type": "object",
+      "properties": {
+        "ruleset": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "version": {
+              "type": "string",
+              "pattern": "^\\d+\\.\\d+\\.\\d+$"
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[0-9a-f]{64}$"
+            }
+          },
+          "required": [
+            "id",
+            "version",
+            "digest"
+          ],
+          "additionalProperties": false
+        },
+        "totalTimeoutMs": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "maxAttempts": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "concurrency": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "evaluations": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "targets": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "adapter": {
+                      "enum": [
+                        "jev",
+                        "llm-subagent"
+                      ]
+                    },
+                    "adapterVersion": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "model": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "subagent": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "version": {
+                          "type": "string",
+                          "pattern": "^\\d+\\.\\d+\\.\\d+$"
+                        },
+                        "digest": {
+                          "type": "string",
+                          "pattern": "^sha256:[0-9a-f]{64}$"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "version",
+                        "digest"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "credentialRef": {
+                      "type": "string",
+                      "pattern": "^[a-z][a-z0-9.-]+$"
+                    },
+                    "requiredCapabilities": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "minItems": 0
+                    },
+                    "acceptance": {
+                      "oneOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "mode": {
+                              "const": "typed-value"
+                            }
+                          },
+                          "required": [
+                            "mode"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "mode": {
+                              "const": "confidence-threshold"
+                            },
+                            "profile": {
+                              "type": "string",
+                              "minLength": 1
+                            },
+                            "minimumBps": {
+                              "type": "integer",
+                              "minimum": 0,
+                              "maximum": 10000
+                            }
+                          },
+                          "required": [
+                            "mode",
+                            "profile",
+                            "minimumBps"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    },
+                    "timeoutMs": {
+                      "type": "integer",
+                      "minimum": 1
+                    },
+                    "retry": {
+                      "type": "object",
+                      "properties": {
+                        "maxRetries": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 10
+                        },
+                        "initialDelayMs": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 9007199254740991
+                        },
+                        "maxDelayMs": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 9007199254740991
+                        }
+                      },
+                      "required": [
+                        "maxRetries",
+                        "initialDelayMs",
+                        "maxDelayMs"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "adapter",
+                    "adapterVersion",
+                    "model",
+                    "requiredCapabilities",
+                    "acceptance",
+                    "timeoutMs",
+                    "retry"
+                  ],
+                  "additionalProperties": false,
+                  "allOf": [
+                    {
+                      "if": {
+                        "properties": {
+                          "adapter": {
+                            "const": "jev"
+                          }
+                        }
+                      },
+                      "then": {
+                        "properties": {
+                          "credentialRef": {}
+                        },
+                        "required": [
+                          "credentialRef"
+                        ],
+                        "not": {
+                          "properties": {
+                            "subagent": {}
+                          },
+                          "required": [
+                            "subagent"
+                          ]
+                        }
+                      },
+                      "else": {
+                        "properties": {
+                          "subagent": {}
+                        },
+                        "required": [
+                          "subagent"
+                        ],
+                        "not": {
+                          "properties": {
+                            "credentialRef": {}
+                          },
+                          "required": [
+                            "credentialRef"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                },
+                "minItems": 1
+              },
+              "fallbackOn": {
+                "type": "array",
+                "items": {
+                  "enum": [
+                    "unsupported-capability",
+                    "executor-unavailable",
+                    "invalid-output",
+                    "low-confidence",
+                    "missing-confidence",
+                    "confidence-profile-mismatch",
+                    "insufficient-information",
+                    "timeout",
+                    "network-transient",
+                    "rate-limited",
+                    "overloaded",
+                    "service-error",
+                    "authentication",
+                    "invalid-request"
+                  ]
+                },
+                "minItems": 0
+              }
+            },
+            "required": [
+              "targets",
+              "fallbackOn"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "ruleset",
+        "totalTimeoutMs",
+        "maxAttempts",
+        "concurrency",
+        "evaluations"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
+  "additionalProperties": false
+}