@aiwg/cli 2026.9.24 → 2026.10.1

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

@@ -0,0 +1,499 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/SdlcEvidenceScreening.v1.schema.json",
+  "title": "SdlcEvidenceScreening",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "mode",
+    "inventory",
+    "gatePolicyPin",
+    "subject",
+    "nowEpochMs"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-sdlc-evidence-screening/v1"
+    },
+    "mode": {
+      "enum": [
+        "disabled",
+        "shadow",
+        "advisory"
+      ]
+    },
+    "inventory": {
+      "$ref": "#/$defs/inventory"
+    },
+    "gatePolicyPin": {
+      "$ref": "#/$defs/pin"
+    },
+    "subject": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/citationSubject"
+        },
+        {
+          "$ref": "#/$defs/criterionSubject"
+        }
+      ]
+    },
+    "observation": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/citationObservation"
+        },
+        {
+          "$ref": "#/$defs/criterionObservation"
+        }
+      ]
+    },
+    "nowEpochMs": {
+      "type": "integer",
+      "minimum": 0
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "bps": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 10000
+    },
+    "stringId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "pin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "digest"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stringId"
+        },
+        "version": {
+          "$ref": "#/$defs/stringId"
+        },
+        "digest": {
+          "$ref": "#/$defs/digest"
+        }
+      }
+    },
+    "inventory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "claimIds",
+        "requirementIds",
+        "sourceIds",
+        "locators",
+        "criterionIds",
+        "evidenceIds"
+      ],
+      "properties": {
+        "claimIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "requirementIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "sourceIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "locators": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "criterionIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "evidenceIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        }
+      }
+    },
+    "sourceEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "digest",
+        "locator",
+        "locatorExists",
+        "retrieved",
+        "contentDigest",
+        "provenanceVerified",
+        "publicationAuthorized",
+        "trust",
+        "sensitivity"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stringId"
+        },
+        "version": {
+          "$ref": "#/$defs/stringId"
+        },
+        "digest": {
+          "$ref": "#/$defs/digest"
+        },
+        "locator": {
+          "$ref": "#/$defs/stringId"
+        },
+        "locatorExists": {
+          "type": "boolean"
+        },
+        "retrieved": {
+          "type": "boolean"
+        },
+        "contentDigest": {
+          "$ref": "#/$defs/digest"
+        },
+        "content": {
+          "type": "string"
+        },
+        "provenanceVerified": {
+          "type": "boolean"
+        },
+        "publicationAuthorized": {
+          "type": "boolean"
+        },
+        "trust": {
+          "enum": [
+            "untrusted",
+            "verified"
+          ]
+        },
+        "sensitivity": {
+          "enum": [
+            "public",
+            "internal",
+            "confidential",
+            "restricted"
+          ]
+        }
+      }
+    },
+    "gateEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "digest",
+        "type",
+        "required",
+        "present",
+        "passed"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stringId"
+        },
+        "version": {
+          "$ref": "#/$defs/stringId"
+        },
+        "digest": {
+          "$ref": "#/$defs/digest"
+        },
+        "type": {
+          "enum": [
+            "artifact",
+            "test-result",
+            "approval",
+            "signature",
+            "schema"
+          ]
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "present": {
+          "type": "boolean"
+        },
+        "passed": {
+          "type": "boolean"
+        },
+        "expiresAtEpochMs": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "citationSubject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "subjectId",
+        "claimId",
+        "requirementIds",
+        "sourceId",
+        "locator",
+        "evidence"
+      ],
+      "properties": {
+        "kind": {
+          "const": "citation"
+        },
+        "subjectId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "claimId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "requirementIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "sourceId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "locator": {
+          "$ref": "#/$defs/stringId"
+        },
+        "evidence": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "items": {
+            "$ref": "#/$defs/sourceEvidence"
+          }
+        }
+      }
+    },
+    "criterionSubject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "subjectId",
+        "criterionId",
+        "requirementIds",
+        "evidence"
+      ],
+      "properties": {
+        "kind": {
+          "const": "phase-criterion"
+        },
+        "subjectId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "criterionId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "requirementIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "evidence": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/gateEvidence"
+          }
+        }
+      }
+    },
+    "citationObservation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "claimId",
+        "sourceId",
+        "locator",
+        "support",
+        "supportStrengthBps",
+        "injection",
+        "confidenceBps",
+        "model",
+        "attempts"
+      ],
+      "properties": {
+        "kind": {
+          "const": "citation"
+        },
+        "claimId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "sourceId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "locator": {
+          "$ref": "#/$defs/stringId"
+        },
+        "support": {
+          "enum": [
+            "supports",
+            "does-not-support",
+            "contradicts",
+            "unclear"
+          ]
+        },
+        "supportDistribution": {
+          "$ref": "#/$defs/distribution"
+        },
+        "supportStrengthBps": {
+          "$ref": "#/$defs/bps"
+        },
+        "injection": {
+          "enum": [
+            "yes",
+            "no",
+            "unclear"
+          ]
+        },
+        "confidenceBps": {
+          "$ref": "#/$defs/bps"
+        },
+        "model": {
+          "$ref": "#/$defs/stringId"
+        },
+        "attempts": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "criterionObservation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "criterionId",
+        "evidenceIds",
+        "relevance",
+        "completeness",
+        "contradiction",
+        "ambiguity",
+        "reviewerAttention",
+        "confidenceBps",
+        "model",
+        "attempts"
+      ],
+      "properties": {
+        "kind": {
+          "const": "phase-criterion"
+        },
+        "criterionId": {
+          "$ref": "#/$defs/stringId"
+        },
+        "evidenceIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/stringId"
+          }
+        },
+        "relevance": {
+          "enum": [
+            "relevant",
+            "irrelevant",
+            "unclear"
+          ]
+        },
+        "completeness": {
+          "enum": [
+            "complete",
+            "incomplete",
+            "unclear"
+          ]
+        },
+        "contradiction": {
+          "enum": [
+            "none",
+            "present",
+            "unclear"
+          ]
+        },
+        "ambiguity": {
+          "enum": [
+            "low",
+            "high",
+            "unclear"
+          ]
+        },
+        "reviewerAttention": {
+          "enum": [
+            "needed",
+            "not-needed"
+          ]
+        },
+        "distributions": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "relevance": {
+              "$ref": "#/$defs/distribution"
+            },
+            "completeness": {
+              "$ref": "#/$defs/distribution"
+            },
+            "contradiction": {
+              "$ref": "#/$defs/distribution"
+            },
+            "ambiguity": {
+              "$ref": "#/$defs/distribution"
+            },
+            "reviewerAttention": {
+              "$ref": "#/$defs/distribution"
+            }
+          }
+        },
+        "confidenceBps": {
+          "$ref": "#/$defs/bps"
+        },
+        "model": {
+          "$ref": "#/$defs/stringId"
+        },
+        "attempts": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "distribution": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      }
+    }
+  }
+}

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

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/SdlcScreeningPreregistration.v1.schema.json",
+  "title": "SdlcScreeningPreregistration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "planId",
+    "frozenAt",
+    "heldoutSplitDigest",
+    "slices",
+    "gateBlockingSlices",
+    "maximumFalseSupportRateBps",
+    "maximumFalseReadyRateBps",
+    "minimumTotalSupport",
+    "minimumSliceSupport",
+    "minimumGateBlockingSliceSupport",
+    "confidenceInterval",
+    "qualityNonInferiorityBps",
+    "efficiencyClaim"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-sdlc-screening-preregistration/v1"
+    },
+    "planId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "frozenAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "heldoutSplitDigest": {
+      "$ref": "#/$defs/digest"
+    },
+    "slices": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/stringId"
+      }
+    },
+    "gateBlockingSlices": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/stringId"
+      }
+    },
+    "maximumFalseSupportRateBps": {
+      "$ref": "#/$defs/bps"
+    },
+    "maximumFalseReadyRateBps": {
+      "$ref": "#/$defs/bps"
+    },
+    "minimumTotalSupport": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "minimumSliceSupport": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "minimumGateBlockingSliceSupport": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "confidenceInterval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "method",
+        "levelBps"
+      ],
+      "properties": {
+        "method": {
+          "enum": [
+            "wilson",
+            "exact-binomial"
+          ]
+        },
+        "levelBps": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9999
+        }
+      }
+    },
+    "qualityNonInferiorityBps": {
+      "$ref": "#/$defs/bps"
+    },
+    "efficiencyClaim": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "minimumPositiveTotalEconomicsUsd"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "minimumPositiveTotalEconomicsUsd": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": 0
+        }
+      }
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "bps": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 10000
+    },
+    "stringId": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}