@aiwg/cli 2026.9.24 → 2026.10.1

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

@@ -0,0 +1,222 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/HeldoutPreregistration.v1.schema.json",
+  "title": "HeldoutPreregistration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "study",
+    "frozenAt",
+    "corpusDigest",
+    "studyAnalysisDigest",
+    "scorerDigest",
+    "providerFailurePolicy",
+    "perRequestTokenBound",
+    "outputAndHiddenTokenAllowance",
+    "requestTimeoutMs",
+    "minDispatchIntervalMs",
+    "sessionLimitMs",
+    "calibration"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-heldout-preregistration/v1"
+    },
+    "study": {
+      "enum": [
+        "D17",
+        "D29"
+      ]
+    },
+    "frozenAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "corpusDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "studyAnalysisDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "scorerDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "regeneration": {
+      "anyOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["reason", "collectorCommit", "priorLiveObservations"],
+          "properties": {
+            "reason": { "type": "string", "minLength": 1 },
+            "collectorCommit": { "type": "string", "pattern": "^[a-f0-9]{9,40}$" },
+            "priorLiveObservations": { "const": 0 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["reason", "previousCorpusDigest", "previousPreregistrationDigest", "previousApprovalTemplateDigest", "liveObservationsAtRegeneration"],
+          "properties": {
+            "reason": { "type": "string", "minLength": 1 },
+            "previousCorpusDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+            "previousPreregistrationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+            "previousApprovalTemplateDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+            "liveObservationsAtRegeneration": { "const": false }
+          }
+        }
+      ]
+    },
+    "providerFailurePolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "maxRetries",
+        "maximumSliceFailureBps",
+        "retryOnlyTerminal"
+      ],
+      "properties": {
+        "maxRetries": {
+          "enum": [
+            0,
+            1
+          ]
+        },
+        "maximumSliceFailureBps": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 500
+        },
+        "retryOnlyTerminal": {
+          "const": true
+        }
+      }
+    },
+    "perRequestTokenBound": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 64000
+    },
+    "outputAndHiddenTokenAllowance": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 32000
+    },
+    "requestTimeoutMs": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 60000
+    },
+    "minDispatchIntervalMs": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 60000
+    },
+    "sessionLimitMs": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 1800000
+    },
+    "providerOverheadTokens": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 64000,
+      "default": 512
+    },
+    "calibration": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "scope",
+            "allowedModes"
+          ],
+          "properties": {
+            "scope": {
+              "const": "uncalibrated-diagnostic"
+            },
+            "allowedModes": {
+              "const": [
+                "uncalibrated-diagnostic"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "scope",
+            "allowedModes"
+          ],
+          "properties": {
+            "scope": {
+              "const": "calibrated"
+            },
+            "allowedModes": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 2,
+              "uniqueItems": true,
+              "items": {
+                "enum": [
+                  "staged",
+                  "artifact"
+                ]
+              }
+            },
+            "calibrationPhaseSplits": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 2,
+              "uniqueItems": true,
+              "items": {
+                "enum": [
+                  "tuning",
+                  "calibration"
+                ]
+              }
+            }
+          },
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "allowedModes": {
+                    "contains": {
+                      "const": "staged"
+                    },
+                    "type": "array"
+                  }
+                }
+              },
+              "then": {
+                "required": [
+                  "calibrationPhaseSplits"
+                ],
+                "properties": {
+                  "calibrationPhaseSplits": {}
+                }
+              },
+              "else": {
+                "not": {
+                  "required": [
+                    "calibrationPhaseSplits"
+                  ],
+                  "properties": {
+                    "calibrationPhaseSplits": {}
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/HeldoutSpendEvent.v1.schema.json",
+  "title": "HeldoutSpendEvent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sequence",
+    "previous",
+    "charge",
+    "totalUsdMicros",
+    "digest"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-heldout-spend-event/v1"
+    },
+    "sequence": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "previous": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "charge": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "study",
+            "runId",
+            "rowId",
+            "requestId",
+            "ordinal",
+            "reservedUsdMicros",
+            "accountedUsdMicros",
+            "disposition",
+            "reservedTokens"
+          ],
+          "properties": {
+            "study": {
+              "enum": [
+                "D17",
+                "D29"
+              ]
+            },
+            "runId": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+            },
+            "rowId": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+            },
+            "requestId": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+            },
+            "ordinal": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 2
+            },
+            "reservedUsdMicros": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "accountedUsdMicros": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "disposition": {
+              "enum": [
+                null,
+                "success",
+                "retryable",
+                "measurement-failure",
+                "stop"
+              ]
+            },
+            "reservedTokens": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            }
+          }
+        }
+      ]
+    },
+    "totalUsdMicros": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  }
+}

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

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/HeldoutSpendHead.v1.schema.json",
+  "title": "HeldoutSpendHead",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sequence",
+    "digest"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-heldout-spend-head/v1"
+    },
+    "sequence": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  }
+}

package/schemas/decision/HeldoutSpendHead.v2.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/HeldoutSpendHead.v2.schema.json",
+  "title": "HeldoutSpendHead",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sequence",
+    "digest",
+    "baselineDigests"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-heldout-spend-head/v2"
+    },
+    "sequence": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "baselineDigests": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["portfolio"],
+      "minProperties": 2,
+      "properties": {
+        "portfolio": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "D17": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "D29": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/HeldoutSummary.v1.schema.json",
+  "title": "HeldoutSummary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "reason",
+    "source",
+    "study",
+    "runId",
+    "reservedUsdMicros",
+    "completedRows",
+    "measurementFailures",
+    "missingRows",
+    "evidenceDigest",
+    "decision",
+    "calibrationPhaseRecordDigest"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-heldout-summary/v1"
+    },
+    "status": {
+      "enum": [
+        "complete",
+        "checkpoint",
+        "stopped"
+      ]
+    },
+    "reason": {
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "source": {
+      "enum": [
+        "injected-transport",
+        "provider"
+      ]
+    },
+    "study": {
+      "enum": [
+        "D17",
+        "D29"
+      ]
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "reservedUsdMicros": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "completedRows": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "measurementFailures": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "missingRows": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "evidenceDigest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "decision": {
+      "const": "HOLD"
+    },
+    "calibrationPhaseRecordDigest": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/OpaDecisionLogExport.v1.schema.json",
+  "type": "object",
+  "properties": {
+    "schemaVersion": { "const": "decision-interop.aiwg.io/v1" },
+    "decision_id": { "type": "string", "minLength": 1 },
+    "trace_id": { "type": "string", "minLength": 1 },
+    "span_id": { "type": "string", "minLength": 1 },
+    "path": { "type": "string", "minLength": 1 },
+    "timestamp": { "type": "string", "minLength": 1 },
+    "bundles": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "revision": { "type": "string", "minLength": 1 },
+          "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+        },
+        "required": ["revision"],
+        "additionalProperties": false
+      },
+      "minProperties": 1
+    },
+    "result": {},
+    "input": {},
+    "metrics": { "type": "object", "additionalProperties": { "type": "number" } },
+    "labels": { "type": "object", "additionalProperties": { "type": "string" } },
+    "revisionLineage": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "kind": { "enum": ["ruleset", "binding", "policy-bundle", "calibration"] },
+          "id": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 },
+          "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+        },
+        "required": ["kind", "id", "version", "digest"],
+        "additionalProperties": false
+      },
+      "minItems": 1
+    },
+    "redaction": {
+      "type": "object",
+      "properties": {
+        "mode": { "const": "default-deny-sensitive" },
+        "removed": { "type": "array", "items": { "type": "string" } }
+      },
+      "required": ["mode", "removed"],
+      "additionalProperties": false
+    },
+    "enforcement": {
+      "type": "object",
+      "properties": {
+        "separated": { "const": true },
+        "contract": { "const": "decision-only-action-requires-aiwg-authorization" }
+      },
+      "required": ["separated", "contract"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["schemaVersion", "decision_id", "path", "bundles", "result", "input", "revisionLineage", "redaction", "enforcement"],
+  "additionalProperties": false
+}