@aiwg/cli 2026.9.19 → 2026.9.21

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

@@ -0,0 +1,619 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionResult.v1alpha2.schema.json",
+  "$defs": {
+    "acceptanceEvidence": {
+      "type": "object",
+      "properties": {
+        "policyVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+        "uncertaintyProfile": { "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },
+        "disposition": { "enum": ["act", "review", "reject", "fallback"] },
+        "matchedRule": { "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },
+        "fallbackTarget": { "type": "string", "minLength": 1 },
+        "reason": { "enum": ["matched", "default", "missing-evidence", "invalid-evidence", "tie", "calibration-required"] },
+        "values": {
+          "type": "object",
+          "propertyNames": { "enum": ["yes-probability", "selected-probability", "native-confidence", "top-two-margin", "entropy", "concentration", "expected-score", "dispersion", "calibrated-risk"] },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "value": { "type": "number" },
+              "normalizedBps": { "type": "number", "minimum": 0, "maximum": 10000 },
+              "provenance": { "enum": ["provider-value", "provider-confidence", "provider-distribution", "derived", "calibrated"] },
+              "calibrationRef": { "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] }
+            },
+            "required": ["value", "normalizedBps", "provenance", "calibrationRef"],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": ["policyVersion", "uncertaintyProfile", "disposition", "matchedRule", "reason", "values"],
+      "additionalProperties": false
+    }
+  },
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "const": "decision.aiwg.io/v1alpha2"
+    },
+    "kind": {
+      "const": "DecisionResult"
+    },
+    "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": {
+        "decision": {
+          "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
+        },
+        "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
+        },
+        "binding": {
+          "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
+        },
+        "alias": {
+          "type": "string",
+          "minLength": 1
+        },
+        "runId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "invocationId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "enum": [
+            "success",
+            "abstained",
+            "error",
+            "unsupported",
+            "cancelled"
+          ]
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "reason": {
+          "enum": [
+            "none",
+            "invalid-input",
+            "invalid-definition",
+            "digest-mismatch",
+            "unauthorized",
+            "data-boundary-denied",
+            "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",
+            "budget-exhausted",
+            "cancelled",
+            "persistence-error",
+            "replay-mismatch",
+            "execution-uncertain",
+            "batch-record-unavailable",
+            "no-match",
+            "conflicting-outcomes",
+            "evaluation-failed"
+          ]
+        },
+        "uncertainty": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "source": {
+                  "enum": [
+                    "provider",
+                    "model-self-report",
+                    "derived"
+                  ]
+                },
+                "profile": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "calibration": {
+                  "enum": [
+                    "vendor-claimed",
+                    "uncalibrated",
+                    "measured"
+                  ]
+                },
+                "confidence": {
+                  "anyOf": [
+                    {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "distribution": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "minProperties": 2,
+                      "additionalProperties": {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 1
+                      }
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "calibrationRef": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "calibratedRisk": {
+                  "type": "object",
+                  "properties": {
+                    "value": { "type": "number", "minimum": 0, "maximum": 1 },
+                    "calibrationRef": { "type": "string", "minLength": 1 }
+                  },
+                  "required": ["value", "calibrationRef"],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "source",
+                "profile",
+                "calibration",
+                "confidence",
+                "distribution",
+                "calibrationRef"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "acceptance": {
+          "$ref": "#/$defs/acceptanceEvidence"
+        },
+        "attempts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "ordinal": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "adapter": {
+                "type": "string",
+                "minLength": 1
+              },
+              "adapterVersion": {
+                "type": "string",
+                "minLength": 1
+              },
+              "requestedModel": {
+                "type": "string",
+                "minLength": 1
+              },
+              "actualModel": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "subagent": {
+                "anyOf": [
+                  {
+                    "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
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "status": {
+                "enum": [
+                  "success",
+                  "abstained",
+                  "error",
+                  "unsupported",
+                  "cancelled"
+                ]
+              },
+              "reason": {
+                "enum": [
+                  "none",
+                  "invalid-input",
+                  "invalid-definition",
+                  "digest-mismatch",
+                  "unauthorized",
+                  "data-boundary-denied",
+                  "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",
+                  "budget-exhausted",
+                  "cancelled",
+                  "persistence-error",
+                  "replay-mismatch",
+                  "execution-uncertain",
+                  "batch-record-unavailable",
+                  "no-match",
+                  "conflicting-outcomes",
+                  "evaluation-failed"
+                ]
+              },
+              "durationMs": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              },
+              "usage": {
+                "type": "object",
+                "properties": {
+                  "inputTokens": {
+                    "anyOf": [
+                      {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 9007199254740991
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "outputTokens": {
+                    "anyOf": [
+                      {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 9007199254740991
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "costUsd": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "minimum": 0
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "inputTokens",
+                  "outputTokens",
+                  "costUsd"
+                ],
+                "additionalProperties": false
+              },
+              "requestId": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "requestIdSource": {
+                "enum": [
+                  "typesafe",
+                  "legacy",
+                  "body"
+                ]
+              },
+              "httpStatus": {
+                "type": "integer",
+                "minimum": 100,
+                "maximum": 599
+              },
+              "retryDelayMs": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "termination": {
+                "enum": [
+                  "caller-cancelled",
+                  "target-timeout",
+                  "total-deadline",
+                  "backend-cancelled"
+                ]
+              },
+              "remoteExecution": {
+                "const": "unknown"
+              },
+              "admission": {
+                "$ref": "DecisionAdmissionEvidence.v1.schema.json"
+              },
+              "providerPrefix": {
+                "$ref": "DecisionProviderPrefixEvidence.v1.schema.json"
+              },
+              "batch": {
+                "type": "object",
+                "properties": {
+                  "mode": { "enum": ["native", "single"] },
+                  "groupId": { "type": "string", "pattern": "^(batch|single)_[0-9a-f]{24}$" },
+                  "questionId": { "type": "string", "pattern": "^q_[0-9a-f]{24}$" },
+                  "degradationReason": { "enum": ["disabled", "unsupported", "ineligible"] }
+                },
+                "required": ["mode", "groupId", "questionId"],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "ordinal",
+              "adapter",
+              "adapterVersion",
+              "requestedModel",
+              "actualModel",
+              "subagent",
+              "status",
+              "reason",
+              "durationMs",
+              "usage",
+              "requestId"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 0
+        },
+        "calibrationCompatibility": {
+          "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
+        },
+        "batchResult": {
+          "type": "object",
+          "properties": {
+            "schemaVersion": { "const": "decision-batch-result-ref/v1" },
+            "batchId": { "type": "string", "minLength": 1 },
+            "receiptRevision": { "type": "integer", "minimum": 1 },
+            "questionId": { "type": "string", "minLength": 1 },
+            "answerId": { "type": "string", "minLength": 1 }
+          },
+          "required": ["schemaVersion", "batchId", "receiptRevision", "questionId", "answerId"],
+          "additionalProperties": false
+        },
+        "context": {
+          "$ref": "DecisionContextEvidence.v1.schema.json"
+        }
+      },
+      "required": [
+        "decision",
+        "ruleset",
+        "binding",
+        "alias",
+        "runId",
+        "invocationId",
+        "status",
+        "reason",
+        "uncertainty",
+        "attempts"
+      ],
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "status": {
+                "const": "success"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "value"
+            ],
+            "properties": {
+              "value": {},
+              "reason": {
+                "const": "none"
+              },
+              "attempts": {
+                "type": "array",
+                "minItems": 1
+              }
+            }
+          },
+          "else": {
+            "not": {
+              "properties": {
+                "value": {}
+              },
+              "required": [
+                "value"
+              ]
+            },
+            "properties": {
+              "reason": {
+                "not": {
+                  "const": "none"
+                }
+              }
+            }
+          }
+        }
+      ]
+    }
+  },
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
+  "additionalProperties": false
+}

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

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/DecisionResultCacheEntry.v1.schema.json",
+  "title": "Decision semantic result cache entry v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "revision", "entryId", "scope", "keyDigest", "identityDigest", "policyVersion", "sensitivity", "createdAtEpochMs", "expiresAtEpochMs", "evidence", "integrityDigest"],
+  "properties": {
+    "schemaVersion": { "const": "decision-result-cache/v1" },
+    "revision": { "const": 1 },
+    "entryId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "scope": {
+      "type": "object", "additionalProperties": false,
+      "required": ["tenantId", "projectId", "workspaceId"],
+      "properties": {
+        "tenantId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "projectId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }
+      }
+    },
+    "keyDigest": { "$ref": "#/$defs/digest" },
+    "identityDigest": { "$ref": "#/$defs/digest" },
+    "policyVersion": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "sensitivity": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "createdAtEpochMs": { "type": "integer", "minimum": 0 },
+    "expiresAtEpochMs": { "type": "integer", "minimum": 1 },
+    "evidence": {
+      "type": "object", "additionalProperties": false,
+      "required": ["result", "resultDigest", "sourceInvocationId", "sourceReceiptId", "evaluatedAtEpochMs", "actualModel", "uncertainty", "calibrationStatus", "durationMs", "usage", "status", "failureReason"],
+      "properties": {
+        "result": {}, "resultDigest": { "$ref": "#/$defs/digest" },
+        "sourceInvocationId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "sourceReceiptId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "evaluatedAtEpochMs": { "type": "integer", "minimum": 0 },
+        "actualModel": { "type": "string", "minLength": 1, "maxLength": 300 },
+        "uncertainty": {}, "calibrationStatus": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "durationMs": { "type": "number", "minimum": 0 },
+        "usage": {
+          "type": "object", "additionalProperties": false, "required": ["inputTokens", "outputTokens", "costUsd"],
+          "properties": {
+            "inputTokens": { "type": ["integer", "null"], "minimum": 0 },
+            "outputTokens": { "type": ["integer", "null"], "minimum": 0 },
+            "costUsd": { "type": ["number", "null"], "minimum": 0 }
+          }
+        },
+        "status": { "enum": ["success", "terminal-failure"] },
+        "failureReason": { "type": "string", "minLength": 1, "maxLength": 100 }
+      }
+    },
+    "integrityDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }
+}