@aiwg/cli 2026.9.24 → 2026.10.0

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

@@ -0,0 +1,175 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/ContextPruningPreregistration.v1.schema.json",
+  "title": "Context Pruning Preregistration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "registeredAt",
+    "pairSetDigest",
+    "thresholds",
+    "digest"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "decision-context-pruning-preregistration/v1"
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "registeredAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "pairSetDigest": {
+      "$ref": "#/$defs/digest"
+    },
+    "thresholds": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protectedRetentionBps",
+        "confidenceInterval",
+        "qualityMetrics",
+        "slices",
+        "minimumOverallN",
+        "minimumSliceN",
+        "minimumZeroVarianceN",
+        "minimumProtectedN",
+        "powerRule",
+        "qualityNonInferiorityMarginBps",
+        "positiveTotalTokenTarget",
+        "positiveTotalCostTargetUsd"
+      ],
+      "properties": {
+        "protectedRetentionBps": {
+          "const": 10000
+        },
+        "confidenceInterval": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "levelBps",
+            "binaryMethod",
+            "boundedMethod",
+            "bootstrapSeed",
+            "bootstrapResamples"
+          ],
+          "properties": {
+            "levelBps": {
+              "type": "integer",
+              "exclusiveMinimum": 5000,
+              "exclusiveMaximum": 9999
+            },
+            "binaryMethod": {
+              "enum": [
+                "newcombe-10",
+                "tango"
+              ]
+            },
+            "boundedMethod": {
+              "const": "percentile-bootstrap"
+            },
+            "bootstrapSeed": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 4294967295
+            },
+            "bootstrapResamples": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000000
+            }
+          }
+        },
+        "qualityMetrics": {
+          "type": "array",
+          "minItems": 5,
+          "maxItems": 5,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "metric",
+              "scale"
+            ],
+            "properties": {
+              "metric": {
+                "enum": [
+                  "downstream-task-success",
+                  "requirement-coverage",
+                  "factual-coverage",
+                  "citation-accuracy",
+                  "human-preference"
+                ]
+              },
+              "scale": {
+                "enum": [
+                  "binary",
+                  "bounded"
+                ]
+              }
+            }
+          }
+        },
+        "slices": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "minimumOverallN": {
+          "type": "integer",
+          "minimum": 2
+        },
+        "minimumSliceN": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "minimumZeroVarianceN": {
+          "type": "integer",
+          "minimum": 2
+        },
+        "minimumProtectedN": {
+          "type": "integer",
+          "minimum": 2
+        },
+        "powerRule": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "qualityNonInferiorityMarginBps": {
+          "type": "integer",
+          "minimum": -10000,
+          "maximum": 0
+        },
+        "positiveTotalTokenTarget": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "positiveTotalCostTargetUsd": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        }
+      }
+    },
+    "digest": {
+      "$ref": "#/$defs/digest"
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  }
+}

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

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/decision/ContextPruningReceipt.v1.schema.json",
+  "title": "Context Pruning Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "pairId", "itemId", "locator", "originalDigest", "originalTokenEstimate", "classification", "proposedAction", "appliedAction", "mode", "reason", "decisionReceiptDigest", "reversibleReference", "createdAt", "receiptDigest"],
+  "properties": {
+    "schemaVersion": { "const": "decision-context-pruning-receipt/v1" },
+    "runId": { "$ref": "#/$defs/digest" },
+    "pairId": { "type": ["string", "null"], "minLength": 1 },
+    "itemId": { "type": "string", "minLength": 1 },
+    "locator": { "type": "string", "minLength": 1 },
+    "originalDigest": { "$ref": "#/$defs/digest" },
+    "originalTokenEstimate": { "type": "integer", "minimum": 0 },
+    "classification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "itemId", "protected", "reasons", "policyDigest"],
+      "properties": {
+        "schemaVersion": { "const": "decision-context-protected/v1" },
+        "itemId": { "type": "string", "minLength": 1 },
+        "protected": { "type": "boolean" },
+        "reasons": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/protectedReason" } },
+        "policyDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "proposedAction": { "$ref": "#/$defs/action" },
+    "appliedAction": { "$ref": "#/$defs/action" },
+    "mode": { "enum": ["disabled", "shadow", "advisory", "deterministic-fallback"] },
+    "reason": {
+      "enum": ["protected-item", "disabled", "shadow-only", "accepted-evidence", "prior-deterministic-fallback", "invalid-evidence", "uncertain-evidence", "uncalibrated", "incomplete-state", "cancelled", "evaluation-failed", "drift-or-monitoring-regression", "unsupported-transformation", "policy-denied-action"]
+    },
+    "decisionReceiptDigest": { "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+    "reversibleReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["locator", "originalDigest", "restorationPath", "transformation"],
+      "properties": {
+        "locator": { "type": "string", "minLength": 1 },
+        "originalDigest": { "$ref": "#/$defs/digest" },
+        "restorationPath": { "type": "string", "minLength": 1 },
+        "transformation": {
+          "anyOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["action", "locator", "digest", "sourceDigest", "qualityCheck"],
+              "properties": {
+                "action": { "enum": ["truncate", "summarize"] },
+                "locator": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" },
+                "sourceDigest": { "$ref": "#/$defs/digest" },
+                "qualityCheck": { "enum": ["passed", "failed", "missing"] }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "receiptDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "action": { "enum": ["keep", "drop", "truncate", "summarize"] },
+    "protectedReason": {
+      "enum": ["system-rule", "developer-rule", "project-rule", "security-policy", "current-user-requirement", "explicit-mention", "unresolved-blocker", "action-approval", "artifact-pin", "version-pin", "digest-pin", "provenance-required", "citation-required", "test-gate-evidence", "open-decision-evidence", "protected-dependency", "external-evaluation-denied", "local-only", "restricted-data", "legal-policy"]
+    }
+  }
+}