@aiwg/cli 2026.9.19 → 2026.9.21

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

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionContextEvidence.v1.schema.json",
+  "title": "Decision Context Evidence v1",
+  "description": "Body-free D06 context plan and estimate-versus-actual usage. Only identifiers, digests and token counts are permitted; authorized state and question bodies are excluded by construction.",
+  "type": "object",
+  "properties": {
+    "plan": { "$ref": "#/$defs/plan" },
+    "actualUsage": { "type": "array", "items": { "$ref": "#/$defs/usage" } }
+  },
+  "required": ["plan", "actualUsage"],
+  "additionalProperties": false,
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "tokens": { "type": "integer", "minimum": 0 },
+    "identity": {
+      "type": "object",
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      },
+      "required": ["id", "version"],
+      "additionalProperties": false
+    },
+    "questionIds": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "plan": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": { "const": "decision-context-plan/v1" },
+        "planDigest": { "$ref": "#/$defs/digest" },
+        "assumptionsDigest": { "$ref": "#/$defs/digest" },
+        "inputDigest": { "$ref": "#/$defs/digest" },
+        "subject": { "type": "string", "minLength": 1 },
+        "authorizationDigest": { "$ref": "#/$defs/digest" },
+        "incompleteContext": { "type": "boolean" },
+        "automaticActionAllowed": { "type": "boolean" },
+        "estimator": { "$ref": "#/$defs/identity" },
+        "providerProfile": {
+          "type": "object",
+          "properties": {
+            "id": { "type": "string", "minLength": 1 },
+            "version": { "type": "string", "minLength": 1 },
+            "digest": { "$ref": "#/$defs/digest" }
+          },
+          "required": ["id", "version", "digest"],
+          "additionalProperties": false
+        },
+        "limits": {
+          "type": "object",
+          "properties": {
+            "documentedAggregateTokens": { "type": "integer", "minimum": 1 },
+            "documentedStateAndLongestQuestionTokens": { "type": "integer", "minimum": 1 },
+            "safetyMarginBps": { "type": "integer", "minimum": 0, "maximum": 9999 },
+            "effectiveAggregateTokens": { "$ref": "#/$defs/tokens" },
+            "effectiveStateAndLongestQuestionTokens": { "$ref": "#/$defs/tokens" }
+          },
+          "required": ["documentedAggregateTokens", "documentedStateAndLongestQuestionTokens", "safetyMarginBps",
+            "effectiveAggregateTokens", "effectiveStateAndLongestQuestionTokens"],
+          "additionalProperties": false
+        },
+        "rawEstimate": {
+          "type": "object",
+          "properties": {
+            "stateTokens": { "$ref": "#/$defs/tokens" },
+            "allQuestionTokens": { "$ref": "#/$defs/tokens" },
+            "longestQuestionTokens": { "$ref": "#/$defs/tokens" },
+            "aggregateTokens": { "$ref": "#/$defs/tokens" },
+            "stateAndLongestQuestionTokens": { "$ref": "#/$defs/tokens" }
+          },
+          "required": ["stateTokens", "allQuestionTokens", "longestQuestionTokens", "aggregateTokens",
+            "stateAndLongestQuestionTokens"],
+          "additionalProperties": false
+        },
+        "partitions": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/partition" } }
+      },
+      "required": ["schemaVersion", "planDigest", "assumptionsDigest", "inputDigest", "subject", "authorizationDigest",
+        "incompleteContext", "automaticActionAllowed", "estimator", "providerProfile", "limits", "rawEstimate", "partitions"],
+      "additionalProperties": false
+    },
+    "partition": {
+      "type": "object",
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "wave": { "type": "integer", "minimum": 0 },
+        "compatibilityKey": { "type": "string", "minLength": 1 },
+        "subject": { "type": "string", "minLength": 1 },
+        "stateDigest": { "$ref": "#/$defs/digest" },
+        "questionIds": { "$ref": "#/$defs/questionIds" },
+        "questionDigests": { "type": "object", "minProperties": 1, "additionalProperties": { "$ref": "#/$defs/digest" } },
+        "questionDependencies": {
+          "type": "object",
+          "additionalProperties": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+        },
+        "estimate": {
+          "type": "object",
+          "properties": {
+            "stateTokens": { "$ref": "#/$defs/tokens" },
+            "questionTokens": { "type": "object", "minProperties": 1, "additionalProperties": { "$ref": "#/$defs/tokens" } },
+            "longestQuestionTokens": { "$ref": "#/$defs/tokens" },
+            "aggregateTokens": { "$ref": "#/$defs/tokens" },
+            "stateAndLongestQuestionTokens": { "$ref": "#/$defs/tokens" }
+          },
+          "required": ["stateTokens", "questionTokens", "longestQuestionTokens", "aggregateTokens", "stateAndLongestQuestionTokens"],
+          "additionalProperties": false
+        },
+        "reason": { "enum": ["fits-original-group", "aggregate-limit-partition", "dependency-wave"] }
+      },
+      "required": ["id", "wave", "compatibilityKey", "subject", "stateDigest", "questionIds", "questionDigests",
+        "questionDependencies", "estimate", "reason"],
+      "additionalProperties": false
+    },
+    "usage": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": { "const": "decision-context-usage/v1" },
+        "planDigest": { "$ref": "#/$defs/digest" },
+        "partitionId": { "type": "string", "minLength": 1 },
+        "questionIds": { "$ref": "#/$defs/questionIds" },
+        "estimator": { "$ref": "#/$defs/identity" },
+        "providerProfile": { "$ref": "#/$defs/identity" },
+        "estimatedInputTokens": { "$ref": "#/$defs/tokens" },
+        "actualInputTokens": { "$ref": "#/$defs/tokens" },
+        "estimationErrorTokens": { "type": "integer" },
+        "estimationErrorBps": { "type": ["integer", "null"] }
+      },
+      "required": ["schemaVersion", "planDigest", "partitionId", "questionIds", "estimator", "providerProfile",
+        "estimatedInputTokens", "actualInputTokens", "estimationErrorTokens", "estimationErrorBps"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/decision/DecisionDefinition.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionDefinition.v1alpha1.schema.json",
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "const": "decision.aiwg.io/v1alpha1"
+    },
+    "kind": {
+      "const": "DecisionDefinition"
+    },
+    "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": {
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        },
+        "inputSchema": {
+          "type": "object"
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "answer": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "const": "choice"
+                },
+                "options": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "description": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "description"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "minItems": 2,
+                  "maxItems": 255
+                }
+              },
+              "required": [
+                "kind",
+                "options"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "const": "ordinal-score"
+                },
+                "levels": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "minItems": 2,
+                  "maxItems": 10
+                }
+              },
+              "required": [
+                "kind",
+                "levels"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "const": "truth-probability"
+                },
+                "trueDescription": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "falseDescription": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "kind",
+                "trueDescription",
+                "falseDescription"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "requiredCapabilities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 0
+        }
+      },
+      "required": [
+        "purpose",
+        "inputSchema",
+        "question",
+        "answer",
+        "requiredCapabilities"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
+  "additionalProperties": false
+}

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

@@ -0,0 +1,203 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionDefinition.v1alpha2.schema.json",
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "const": "decision.aiwg.io/v1alpha2"
+    },
+    "kind": {
+      "const": "DecisionDefinition"
+    },
+    "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": {
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        },
+        "inputSchema": {
+          "type": "object"
+        },
+        "question": {
+          "oneOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/$defs/entry"
+              },
+              "minProperties": 1
+            },
+            {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/entry"
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "answer": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "const": "choice"
+                },
+                "options": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "description": {
+                        "$ref": "#/$defs/entry"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "description"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "minItems": 2,
+                  "maxItems": 255
+                }
+              },
+              "required": [
+                "kind",
+                "options"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "const": "ordinal-score"
+                },
+                "levels": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/$defs/entry"
+                  },
+                  "minItems": 2,
+                  "maxItems": 10
+                }
+              },
+              "required": [
+                "kind",
+                "levels"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "const": "truth-probability"
+                },
+                "trueDescription": {
+                  "$ref": "#/$defs/entry"
+                },
+                "falseDescription": {
+                  "$ref": "#/$defs/entry"
+                }
+              },
+              "required": [
+                "kind",
+                "trueDescription",
+                "falseDescription"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "requiredCapabilities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 0
+        }
+      },
+      "required": [
+        "purpose",
+        "inputSchema",
+        "question",
+        "answer",
+        "requiredCapabilities"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "entry": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/entry"
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/entry"
+          }
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionDriftResponse.v1.schema.json",
+  "title": "Decision Drift Response",
+  "description": "D17 contract mapping each declared drift signal to exactly one configured safe response. Consumes D09 AliasDriftEvent records; this schema does not execute responses.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "version", "alias", "thresholds", "window", "rules", "insufficientSamplesResponse"],
+  "properties": {
+    "schemaVersion": { "const": "decision-drift-response/v1" },
+    "id": { "$ref": "#/$defs/name" },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "alias": { "$ref": "#/$defs/name" },
+    "thresholds": {
+      "type": "object", "additionalProperties": false, "required": ["version", "digest", "registeredAt"],
+      "properties": {
+        "version": { "$ref": "#/$defs/name" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "registeredAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "window": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "size", "minimumSamples"],
+      "properties": {
+        "kind": { "enum": ["observations", "duration-ms"] },
+        "size": { "type": "integer", "minimum": 1 },
+        "minimumSamples": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "rules": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/rule" } },
+    "insufficientSamplesResponse": { "$ref": "#/$defs/response" }
+  },
+  "$defs": {
+    "name": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$" },
+    "response": { "enum": ["alert", "reduce-coverage", "route-to-review", "disable-challenger", "restore-champion", "require-recertification"] },
+    "rule": {
+      "type": "object", "additionalProperties": false, "required": ["id", "source", "metric", "thresholdBps", "response"],
+      "properties": {
+        "id": { "$ref": "#/$defs/name" },
+        "source": { "enum": ["alias-drift", "output-distribution", "label-drift"] },
+        "metric": { "enum": ["identity-change", "jensen-shannon-v1", "population-stability-index-v1", "label-error-rate-delta-v1", "calibration-error-delta-v1"] },
+        "thresholdBps": { "type": ["integer", "null"], "minimum": 0, "maximum": 1000000 },
+        "response": { "$ref": "#/$defs/response" }
+      },
+      "allOf": [
+        { "if": { "properties": { "source": { "const": "alias-drift" } } },
+          "then": { "properties": { "metric": { "const": "identity-change" }, "thresholdBps": { "type": "null" } } } },
+        { "if": { "properties": { "source": { "const": "output-distribution" } } },
+          "then": { "properties": { "metric": { "enum": ["jensen-shannon-v1", "population-stability-index-v1"] }, "thresholdBps": { "type": "integer" } } } },
+        { "if": { "properties": { "source": { "const": "label-drift" } } },
+          "then": { "properties": { "metric": { "enum": ["label-error-rate-delta-v1", "calibration-error-delta-v1"] }, "thresholdBps": { "type": "integer" } } } }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionEnsembleAggregate.v1.schema.json",
+  "title": "Decision Ensemble Aggregate",
+  "description": "Derived D17 aggregate over recorded member results. Agreement is a stability signal: this record has no calibrated or correctness value and its correctness gate is never satisfied by agreement alone.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "policy", "primitive", "algorithm", "semantics", "provenance", "members", "counts", "outcome", "statistics", "disagreement", "warnings", "correctnessGate", "digest"],
+  "properties": {
+    "schemaVersion": { "const": "decision-ensemble-aggregate/v1" },
+    "policy": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version", "digest"],
+      "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "primitive": { "enum": ["choice", "truth-probability", "ordinal-score"] },
+    "algorithm": { "$ref": "#/$defs/versionedId" },
+    "semantics": { "const": "stability-signal-not-correctness" },
+    "provenance": { "const": "derived" },
+    "members": {
+      "type": "array", "minItems": 1,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["memberId", "sampleIndex", "status", "resultDigest", "value"],
+        "properties": {
+          "memberId": { "type": "string", "minLength": 1 },
+          "sampleIndex": { "type": "integer", "minimum": 0 },
+          "status": { "enum": ["succeeded", "failed", "abstained"] },
+          "resultDigest": { "$ref": "#/$defs/digest" },
+          "value": { "anyOf": [{ "type": "string" }, { "type": "number" }, { "type": "null" }] }
+        }
+      }
+    },
+    "counts": {
+      "type": "object", "additionalProperties": false, "required": ["declared", "succeeded", "failed", "abstained"],
+      "properties": {
+        "declared": { "type": "integer", "minimum": 1 }, "succeeded": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 }, "abstained": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "outcome": {
+      "type": "object", "additionalProperties": false, "required": ["disposition", "value", "reason", "tie", "tieRule"],
+      "properties": {
+        "disposition": { "enum": ["accept", "defer", "review"] },
+        "value": { "anyOf": [{ "type": "string" }, { "type": "number" }, { "type": "null" }] },
+        "reason": { "enum": ["aggregated", "tie", "disagreement-exceeded", "insufficient-members"] },
+        "tie": { "type": "boolean" },
+        "tieRule": { "enum": ["lowest-canonical-value", "defer", "review", null] }
+      }
+    },
+    "statistics": {
+      "type": "object", "additionalProperties": false, "required": ["votes", "meanProbability", "meanDistribution", "meanScore", "medianScore", "dispersion"],
+      "properties": {
+        "votes": { "anyOf": [{ "type": "null" }, { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }] },
+        "meanProbability": { "type": ["number", "null"], "minimum": 0, "maximum": 1 },
+        "meanDistribution": { "anyOf": [{ "type": "null" }, { "type": "object", "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 } }] },
+        "meanScore": { "type": ["number", "null"], "minimum": 0 },
+        "medianScore": { "type": ["number", "null"], "minimum": 0 },
+        "dispersion": { "type": ["number", "null"], "minimum": 0 }
+      }
+    },
+    "disagreement": {
+      "type": "object", "additionalProperties": false, "required": ["metric", "valueBps", "thresholdBps", "exceeded"],
+      "properties": {
+        "metric": { "$ref": "#/$defs/versionedId" },
+        "valueBps": { "type": "integer", "minimum": 0, "maximum": 10000 },
+        "thresholdBps": { "type": "integer", "minimum": 0, "maximum": 10000 },
+        "exceeded": { "type": "boolean" }
+      }
+    },
+    "warnings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "correctnessGate": {
+      "type": "object", "additionalProperties": false, "required": ["status", "reason"],
+      "properties": {
+        "status": { "const": "not-satisfied" },
+        "reason": { "const": "agreement-is-not-correctness-evidence" }
+      }
+    },
+    "digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "versionedId": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version"],
+      "properties": { "id": { "type": "string", "pattern": "^[a-z0-9-]+-v[0-9]+$" }, "version": { "type": "string", "pattern": "^v[0-9]+$" } }
+    }
+  }
+}