@aiwg/cli 2026.9.20 → 2026.9.24

package/schemas/decision/DecisionBinding.v1alpha2.schema.json

@@ -0,0 +1,369 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionBinding.v1alpha2.schema.json",
+  "$defs": {
+    "acceptanceRoute": {
+      "type": "object",
+      "properties": {
+        "disposition": { "enum": ["act", "review", "reject", "fallback"] },
+        "fallbackTarget": { "type": "string", "minLength": 1 }
+      },
+      "required": ["disposition"],
+      "additionalProperties": false
+    },
+    "acceptanceCondition": {
+      "type": "object",
+      "properties": {
+        "metric": { "enum": ["yes-probability", "selected-probability", "native-confidence", "top-two-margin", "entropy", "concentration", "expected-score", "dispersion", "calibrated-risk"] },
+        "op": { "enum": ["lt", "lte", "gt", "gte", "between", "outside"] },
+        "thresholdBps": { "type": "integer", "minimum": 0, "maximum": 10000 },
+        "minimumBps": { "type": "integer", "minimum": 0, "maximum": 10000 },
+        "maximumBps": { "type": "integer", "minimum": 0, "maximum": 10000 }
+      },
+      "required": ["metric", "op"],
+      "additionalProperties": false
+    },
+    "primitiveAcceptance": {
+      "type": "object",
+      "properties": {
+        "mode": { "const": "primitive-policy" },
+        "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+        "compatibleUncertaintyProfiles": {
+          "type": "array", "minItems": 1, "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "precedence": { "const": "first-match" },
+        "calibration": { "enum": ["advisory", "required"] },
+        "rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "primitive": { "enum": ["choice", "ordinal-score", "truth-probability"] },
+              "all": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/acceptanceCondition" } },
+              "route": { "$ref": "#/$defs/acceptanceRoute" }
+            },
+            "required": ["id", "primitive", "all", "route"],
+            "additionalProperties": false
+          }
+        },
+        "defaultRoute": { "$ref": "#/$defs/acceptanceRoute" },
+        "missingEvidenceRoute": { "$ref": "#/$defs/acceptanceRoute" },
+        "invalidEvidenceRoute": { "$ref": "#/$defs/acceptanceRoute" },
+        "tieRoute": { "$ref": "#/$defs/acceptanceRoute" },
+        "requiredOptions": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      },
+      "required": ["mode", "version", "compatibleUncertaintyProfiles", "precedence", "calibration", "rules", "defaultRoute", "missingEvidenceRoute", "invalidEvidenceRoute", "tieRoute"],
+      "additionalProperties": false
+    }
+  },
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "const": "decision.aiwg.io/v1alpha2"
+    },
+    "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
+                        },
+                        {
+                          "$ref": "#/$defs/primitiveAcceptance"
+                        }
+                      ]
+                    },
+                    "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
+}

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

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionCacheTelemetry.v1.schema.json",
+  "title": "AIWG Decision Cache Telemetry v1",
+  "description": "Metadata-only cache record for all five layers. It carries no cache key, alias, identity, prompt, schema body, credential or provider handle.",
+  "type": "object",
+  "required": ["schemaVersion", "layer", "outcome", "reason", "version", "savedTokens", "preparationLatencyMs", "expiresAtEpochMs", "invalidationReason"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": "decision-cache-telemetry/v1" },
+    "layer": { "enum": ["definition-compilation", "adapter-compilation", "provider-prefix", "invocation-replay", "semantic-result"] },
+    "outcome": { "enum": ["hit", "miss", "bypass", "rejected", "unsupported", "unknown"] },
+    "reason": { "enum": ["verified-hit", "cold-fill", "cache-disabled", "store-rejected", "provider-report", "documented-unsupported", "policy-bypass", "unreported"] },
+    "version": { "oneOf": [{ "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" }] },
+    "savedTokens": { "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }] },
+    "preparationLatencyMs": { "type": "number", "minimum": 0 },
+    "expiresAtEpochMs": { "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }] },
+    "invalidationReason": { "enum": ["revalidation-failed", null] }
+  }
+}

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

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionChampionChallenger.v1.schema.json",
+  "title": "Decision Champion Challenger",
+  "description": "D17 contract pairing a pinned champion with a challenger over one immutable input set. Promotion consumes the D09 calibration registry eligibility record; this schema does not move aliases or route traffic.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "alias", "champion", "challenger", "inputSet", "pairedMetrics", "preregistration", "eligibilityId", "evaluationIntegrityReport", "approval", "rollbackTarget"],
+  "properties": {
+    "schemaVersion": { "const": "decision-champion-challenger/v1" },
+    "id": { "$ref": "#/$defs/name" },
+    "alias": { "$ref": "#/$defs/name" },
+    "champion": {
+      "type": "object",
+      "allOf": [{ "$ref": "#/$defs/rolePin" }],
+      "required": ["aliasRevision"],
+      "properties": { "aliasRevision": { "type": "integer", "minimum": 1 } },
+      "unevaluatedProperties": false
+    },
+    "challenger": {
+      "type": "object",
+      "allOf": [{ "$ref": "#/$defs/rolePin" }],
+      "unevaluatedProperties": false
+    },
+    "inputSet": {
+      "type": "object", "additionalProperties": false, "required": ["id", "digest", "itemCount", "frozenAt", "purpose"],
+      "properties": {
+        "id": { "$ref": "#/$defs/name" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "itemCount": { "type": "integer", "minimum": 1 },
+        "frozenAt": { "type": "string", "format": "date-time" },
+        "purpose": { "enum": ["shadow", "held-out"] }
+      }
+    },
+    "pairedMetrics": {
+      "type": "array", "minItems": 8, "maxItems": 8,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["metric", "comparison", "bound", "minimumPairs"],
+        "properties": {
+          "metric": { "enum": ["quality", "calibration", "risk-coverage", "abstention", "latency", "tokens", "cost", "slice"] },
+          "comparison": { "enum": ["delta-at-least", "delta-at-most"] },
+          "bound": { "type": "number" },
+          "minimumPairs": { "type": "integer", "minimum": 1 }
+        }
+      }
+    },
+    "preregistration": {
+      "type": "object", "additionalProperties": false, "required": ["thresholdsDigest", "registeredAt", "holdoutAccessedAt"],
+      "properties": {
+        "thresholdsDigest": { "$ref": "#/$defs/digest" },
+        "registeredAt": { "type": "string", "format": "date-time" },
+        "holdoutAccessedAt": { "type": ["string", "null"], "format": "date-time" }
+      }
+    },
+    "eligibilityId": { "$ref": "#/$defs/name" },
+    "evaluationIntegrityReport": { "$ref": "#/$defs/artifactPin" },
+    "approval": {
+      "type": "object", "additionalProperties": false, "required": ["reference", "approvedAt"],
+      "properties": { "reference": { "type": "string", "minLength": 1 }, "approvedAt": { "type": "string", "format": "date-time" } }
+    },
+    "rollbackTarget": { "$ref": "#/$defs/aliasPin" }
+  },
+  "$defs": {
+    "name": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "pin": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version", "digest"],
+      "properties": { "id": { "$ref": "#/$defs/name" }, "version": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "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" } }
+    },
+    "rolePin": {
+      "type": "object",
+      "required": ["identityDigest", "actualModel", "binding", "adapter", "calibration", "ensemblePolicy"],
+      "properties": {
+        "identityDigest": { "$ref": "#/$defs/digest" },
+        "actualModel": { "$ref": "#/$defs/name" },
+        "binding": { "$ref": "#/$defs/pin" },
+        "adapter": {
+          "type": "object", "additionalProperties": false, "required": ["id", "version"],
+          "properties": { "id": { "$ref": "#/$defs/name" }, "version": { "type": "string", "minLength": 1 } }
+        },
+        "calibration": {
+          "anyOf": [
+            { "type": "null" },
+            { "type": "object", "additionalProperties": false, "required": ["artifactId", "artifactDigest"],
+              "properties": { "artifactId": { "$ref": "#/$defs/name" }, "artifactDigest": { "$ref": "#/$defs/digest" } } }
+          ]
+        },
+        "ensemblePolicy": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/pin" }] }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionCompileCacheEntry.v1.schema.json",
+  "title": "AIWG Decision Compile Cache Entry v1",
+  "description": "Live definition- or adapter-compilation artifact. It is never a decision result; a tombstoned or deleted key holds DecisionCompileCacheTombstone.v1 instead.",
+  "type": "object",
+  "required": ["schemaVersion", "key", "identity", "value", "valueDigest", "createdAtEpochMs", "expiresAtEpochMs", "legalHold"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": "decision-compile-cache-entry/v1" },
+    "key": { "$ref": "#/$defs/digest" },
+    "identity": { "$ref": "DecisionCompileCacheIdentity.v1.schema.json" },
+    "value": { "description": "Compiled artifact (any JSON value)." },
+    "valueDigest": { "$ref": "#/$defs/digest" },
+    "createdAtEpochMs": { "type": "integer", "minimum": 0 },
+    "expiresAtEpochMs": { "type": "integer", "minimum": 0 },
+    "legalHold": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hold" }] }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "hold": {
+      "type": "object",
+      "required": ["subject", "reason", "scope", "expiresAt", "authorizedBy"],
+      "additionalProperties": false,
+      "properties": {
+        "subject": { "type": "string", "minLength": 1 },
+        "reason": { "type": "string", "minLength": 1 },
+        "scope": { "type": "array", "minItems": 1, "contains": { "const": "cache" },
+          "items": { "enum": ["state", "receipt", "trace", "debug-sidecar", "cache", "job", "review", "calibration", "evaluation", "export", "preprocessing-lineage"] } },
+        "expiresAt": { "type": "integer", "minimum": 0 },
+        "authorizedBy": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionCompileCacheIdentity.v1.schema.json",
+  "title": "AIWG Decision Compile Cache Identity v1",
+  "type": "object",
+  "required": ["identityVersion", "layer", "sourceArtifactDigests", "compiler", "runtimeVersion", "schemaVersion", "canonicalizer", "adapter", "backendCapabilityMode", "modelPolicy", "featureFlags", "tenantId", "projectId", "dataClass"],
+  "additionalProperties": false,
+  "properties": {
+    "identityVersion": { "const": "decision-compile-cache-identity/v1" },
+    "layer": { "enum": ["definition-compilation", "adapter-compilation"] },
+    "sourceArtifactDigests": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/digest" } },
+    "compiler": { "$ref": "#/$defs/versioned" },
+    "runtimeVersion": { "type": "string", "minLength": 1 },
+    "schemaVersion": { "type": "string", "minLength": 1 },
+    "canonicalizer": { "$ref": "#/$defs/versioned" },
+    "adapter": { "type": "object", "required": ["id", "version", "promptVersion"], "additionalProperties": false, "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 }, "promptVersion": { "type": "string", "minLength": 1 } } },
+    "backendCapabilityMode": { "type": "string", "minLength": 1 },
+    "modelPolicy": { "type": "object", "required": ["requested", "compatibleActualModels"], "additionalProperties": false, "properties": { "requested": { "type": "string", "minLength": 1 }, "compatibleActualModels": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
+    "featureFlags": { "type": "object", "additionalProperties": { "oneOf": [{ "type": "boolean" }, { "type": "number" }, { "type": "string" }] } },
+    "tenantId": { "type": "string", "minLength": 1 }, "projectId": { "type": "string", "minLength": 1 }, "dataClass": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "versioned": { "type": "object", "required": ["id", "version"], "additionalProperties": false, "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } }
+  }
+}

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

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionCompileCacheTombstone.v1.schema.json",
+  "title": "AIWG Decision Compile Cache Tombstone v1",
+  "description": "Body-free record left at a compile-cache key by tombstone or deletion. It carries no value, value digest or identity, and it blocks refill and backup restore.",
+  "type": "object",
+  "required": ["schemaVersion", "key", "tombstone"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": "decision-compile-cache-tombstone/v1" },
+    "key": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "tombstone": {
+      "type": "object",
+      "required": ["subject", "reference", "deletedAt"],
+      "additionalProperties": false,
+      "properties": {
+        "subject": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "reference": {
+          "type": "object",
+          "required": ["surface", "opaqueId"],
+          "additionalProperties": false,
+          "properties": {
+            "surface": { "const": "cache" },
+            "opaqueId": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+          }
+        },
+        "deletedAt": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}