@claudexor/schema 3.0.4 → 3.1.1

package/generated/ControlRunAgainDraft.schema.json

@@ -158,15 +158,22 @@
             },
             "effort": {
               "type": "string",
-              "enum": [
-                "low",
-                "medium",
-                "high",
-                "xhigh",
-                "max"
-              ],
+              "minLength": 1,
+              "maxLength": 32,
+              "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
               "description": "Requested reasoning effort."
             },
+            "efforts": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/ControlRunAgainDraft/properties/request/properties/effort"
+              },
+              "propertyNames": {
+                "minLength": 1,
+                "pattern": "\\S"
+              },
+              "description": "Harness-scoped effort map (harness id to effort); an entry here wins over the scalar effort and the per-harness settings default."
+            },
             "reviewerModels": {
               "type": "object",
               "additionalProperties": {

package/generated/ControlRunDetail.schema.json

@@ -57,6 +57,7 @@
                         "auth",
                         "harness_unavailable",
                         "harness_error",
+                        "config_error",
                         "budget",
                         "policy",
                         "cancelled",
@@ -64,7 +65,28 @@
                         "unknown"
                       ],
                       "default": "unknown",
-                      "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+                      "description": "Typed failure category (validation, project, auth, harness, config, budget, policy, cancelled, internal, unknown). config_error is a settings/routing misconfiguration (e.g. quality routing with no comparable tier), corrected by changing configuration, not by re-auth or waiting for a harness."
+                    },
+                    "code": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "finite_zero",
+                            "hard_cap",
+                            "estimate_headroom",
+                            "unknown_paid_in_flight",
+                            "budget_overshoot",
+                            "cost_unverifiable"
+                          ],
+                          "description": "Machine-readable failure sub-code within a RunFailure category (today the typed budget-denial reasons produced by the budget ledger)."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Machine-readable failure sub-code within the category (today the typed budget-denial reason from the ledger); null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                      "default": null
                     },
                     "harnessId": {
                       "type": [
@@ -256,13 +278,9 @@
                   },
                   "effort": {
                     "type": "string",
-                    "enum": [
-                      "low",
-                      "medium",
-                      "high",
-                      "xhigh",
-                      "max"
-                    ],
+                    "minLength": 1,
+                    "maxLength": 32,
+                    "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
                     "description": "Per-reviewer effort hint, passed to that harness only."
                   }
                 },
@@ -880,7 +898,11 @@
                             "stuck_no_progress",
                             "wall_clock_exceeded",
                             "user_cancelled",
-                            "crash_interrupted"
+                            "crash_interrupted",
+                            "input_required",
+                            "work_incomplete",
+                            "context_capacity_exhausted",
+                            "work_report_contract"
                           ],
                           "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
                         },
@@ -890,6 +912,82 @@
                       ],
                       "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
                       "default": null
+                    },
+                    "work_state": {
+                      "type": "object",
+                      "properties": {
+                        "state": {
+                          "type": "string",
+                          "enum": [
+                            "completed",
+                            "needs_input",
+                            "incomplete",
+                            "unverified"
+                          ],
+                          "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                        },
+                        "source": {
+                          "type": "string",
+                          "enum": [
+                            "constrained",
+                            "validated",
+                            "absent"
+                          ],
+                          "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                        },
+                        "required_inputs": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "kind": {
+                                "type": "string",
+                                "enum": [
+                                  "file",
+                                  "context",
+                                  "credential",
+                                  "permission",
+                                  "decision",
+                                  "external_dependency"
+                                ],
+                                "description": "Category of a missing input a needs_input/incomplete report lists: a file, additional context, a credential, a permission, a human decision, or an external dependency."
+                              },
+                              "locator": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "maxLength": 512
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "default": null,
+                                "description": "Concrete pointer to the missing thing (path/url/name); null when unnameable."
+                              },
+                              "description": {
+                                "type": "string",
+                                "maxLength": 1024,
+                                "description": "Human-readable description of what is needed and why."
+                              }
+                            },
+                            "required": [
+                              "kind",
+                              "description"
+                            ],
+                            "additionalProperties": false,
+                            "description": "One blocking input a needs_input/incomplete WorkReport lists."
+                          },
+                          "maxItems": 16,
+                          "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                        }
+                      },
+                      "required": [
+                        "state",
+                        "source"
+                      ],
+                      "additionalProperties": false,
+                      "description": "D-16 model-attested work outcome, orthogonal to lifecycle; a needs_input/incomplete state vetoes applyability and exit 0. Absent on runs with no work_report transport."
                     }
                   },
                   "required": [
@@ -955,6 +1053,117 @@
               "description": "Route evidence from telemetry; null when no telemetry exists (legacy runs).",
               "default": null
             },
+            "routingRationale": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "goal": {
+                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingGoal"
+                    },
+                    "paid_fallback": {
+                      "type": "string",
+                      "enum": [
+                        "never",
+                        "when_unavailable",
+                        "allowed_within_cap"
+                      ],
+                      "description": "When a route with incremental paid spend may be used."
+                    },
+                    "order": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Non-empty identifier string."
+                      },
+                      "default": [],
+                      "description": "Final ranked order, harness ids."
+                    },
+                    "dropped": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                      },
+                      "default": [],
+                      "description": "Ids removed by paid_fallback or cooldown before ranking."
+                    },
+                    "reason": {
+                      "type": "string",
+                      "enum": [
+                        "subscription_entitlement_first",
+                        "lowest_incremental_cash",
+                        "quality_tier",
+                        "expiring_quota_slack",
+                        "all_incremental_cash_unknown",
+                        "declared_order"
+                      ],
+                      "description": "Typed decisive reason the pool ranked the way it did (QA-034)."
+                    },
+                    "entries": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "harness_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Candidate harness id."
+                          },
+                          "billing_knowledge": {
+                            "type": "string",
+                            "enum": [
+                              "proven_zero",
+                              "subscription_entitlement",
+                              "metered",
+                              "unknown"
+                            ],
+                            "description": "Effective billing knowledge used to rank it."
+                          },
+                          "incremental_cost_usd": {
+                            "anyOf": [
+                              {
+                                "type": "number",
+                                "minimum": 0
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "default": null,
+                            "description": "Known incremental cash cost, when any; null when unknown."
+                          },
+                          "eligible": {
+                            "type": "boolean",
+                            "description": "Whether the candidate survived paid_fallback/cooldown filtering."
+                          }
+                        },
+                        "required": [
+                          "harness_id",
+                          "billing_knowledge",
+                          "eligible"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Per-candidate billing/cost tuple in the routing rationale (QA-034)."
+                      },
+                      "default": []
+                    }
+                  },
+                  "required": [
+                    "goal",
+                    "paid_fallback",
+                    "reason"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Typed routing rationale recorded once at pool ordering (QA-034)."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Typed routing rationale (QA-034) projected from telemetry; null when no ranking was computed or on legacy runs.",
+              "default": null
+            },
             "tests": {
               "type": "array",
               "items": {
@@ -1197,6 +1406,14 @@
                 "default": null,
                 "description": "Redacted error detail for error events."
               },
+              "ignoredSettings": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [],
+                "description": "Unsupported per-harness knobs the route could not honor (INV-105), disclosed on harness.started; empty when nothing was dropped (QA-070)."
+              },
               "rawRef": {
                 "type": [
                   "string",
@@ -1234,6 +1451,24 @@
               "default": null,
               "description": "CASH spend so far in USD; null when unknown."
             },
+            "valuationUsd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "Subscription valuation in USD (separate from billed cash); null when unknown — never a fabricated $0 (QA-023c)."
+            },
+            "valuationKnowledge": {
+              "type": "string",
+              "enum": [
+                "exact",
+                "estimated",
+                "unknown"
+              ],
+              "default": "unknown",
+              "description": "Confidence of valuationUsd: 'estimated' when token-derived, 'unknown' when no usage was reported (valuationUsd is then null), 'exact' when natively priced."
+            },
             "remainingUsd": {
               "type": [
                 "number",
@@ -1257,6 +1492,16 @@
               ],
               "default": "unknown",
               "description": "Where the snapshot came from: the decision record, live events, settings, or unknown."
+            },
+            "evidence": {
+              "type": "string",
+              "enum": [
+                "complete",
+                "incomplete",
+                "unavailable"
+              ],
+              "description": "Integrity of the canonical events this spend fallback read: 'incomplete' when malformed/non-object event lines were skipped, 'unavailable' when the events file was unreadable, else 'complete'. A non-complete value means the projected spend may disagree with disk truth.",
+              "default": "complete"
             }
           },
           "additionalProperties": false,
@@ -1279,9 +1524,7 @@
                 "winner": {
                   "anyOf": [
                     {
-                      "type": "string",
-                      "minLength": 1,
-                      "description": "Non-empty identifier string."
+                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
                     },
                     {
                       "type": "null"
@@ -1305,6 +1548,84 @@
                   "default": {},
                   "description": "Per-candidate reasons the others lost, keyed by candidate id."
                 },
+                "ranking_policy_version": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "default": 1,
+                  "description": "Version of the ranking axis registry the scorecard was produced under."
+                },
+                "score_axes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Every compared ranking axis key, in precedence (best-first) order."
+                },
+                "ranking_scorecard": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "attempt_id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Candidate attempt id (stable key; labels may localize)."
+                      },
+                      "label": {
+                        "type": "string",
+                        "description": "Anonymized candidate label shown to the arbiter."
+                      },
+                      "axes": {
+                        "type": "object",
+                        "additionalProperties": {
+                          "type": "string"
+                        },
+                        "description": "Formatted value for every ranking axis, keyed by axis key."
+                      }
+                    },
+                    "required": [
+                      "attempt_id",
+                      "label",
+                      "axes"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "default": [],
+                  "description": "Per-candidate full ranking scorecard, in final ranking order."
+                },
+                "decisive_axis": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "key": {
+                          "type": "string",
+                          "description": "The first ranking axis that separated winner from runner-up."
+                        },
+                        "winner_value": {
+                          "type": "string",
+                          "description": "The winner's formatted value on the decisive axis."
+                        },
+                        "runner_up_value": {
+                          "type": "string",
+                          "description": "The runner-up's formatted value on the decisive axis."
+                        }
+                      },
+                      "required": [
+                        "key",
+                        "winner_value",
+                        "runner_up_value"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "description": "The axis that actually decided the winner vs the runner-up; null on an exact tie (route order decided, disclosed in final_checks)."
+                },
                 "accepted_risks": {
                   "type": "array",
                   "items": {
@@ -1344,12 +1665,30 @@
                       "type": "boolean",
                       "default": false,
                       "description": "True when any of the spend is token-derived rather than natively reported."
+                    },
+                    "cash_usd": {
+                      "type": [
+                        "number",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Settled cash spend in USD (0 on native-subscription routes); null when unknown."
+                    },
+                    "valuation_usd": {
+                      "type": [
+                        "number",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Settled subscription-equivalent valuation in USD (includes the reviewer panel); null when unknown."
                     }
                   },
                   "additionalProperties": false,
                   "default": {
                     "spend_usd": null,
-                    "estimated": false
+                    "estimated": false,
+                    "cash_usd": null,
+                    "valuation_usd": null
                   },
                   "description": "Settled spend for the run; estimates are disclosed, never presented as exact."
                 },
@@ -1535,7 +1874,7 @@
                   "description": "Task the work product came from."
                 },
                 "producer_attempt_id": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/decision/anyOf/0/properties/winner/anyOf/0",
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items",
                   "description": "Attempt that produced it, when known."
                 },
                 "evidence_dir": {
@@ -1855,7 +2194,7 @@
               "linked_acceptance_criteria": {
                 "type": "array",
                 "items": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/decision/anyOf/0/properties/winner/anyOf/0"
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
                 },
                 "default": [],
                 "description": "Ids of acceptance criteria this finding relates to."
@@ -2272,6 +2611,21 @@
                 ],
                 "default": null,
                 "description": "Diff statistics of the candidate's patch; null when there is no patch."
+              },
+              "rankingAxes": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "string"
+                    }
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "This candidate's ranking-scorecard axis values (from decision.ranking_scorecard); null when no arbitration ran."
               }
             },
             "required": [
@@ -2321,6 +2675,11 @@
                   },
                   "default": [],
                   "description": "Plan items, last-wins."
+                },
+                "evidence": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/budget/properties/evidence",
+                  "default": "complete",
+                  "description": "Integrity of the canonical events this checklist was projected from: 'incomplete'/'unavailable' warns that a plan.progress event may have been lost to a malformed or unreadable events file, so the checklist may be stale or empty; 'complete' otherwise."
                 }
               },
               "additionalProperties": false
@@ -2330,7 +2689,7 @@
             }
           ],
           "default": null,
-          "description": "Live plan checklist from the last plan.progress event; null when the run never emitted one."
+          "description": "Live plan checklist from the last plan.progress event; null when the run never emitted one AND its canonical events were fully readable. Non-null with empty items + non-complete evidence discloses that a plan event may have been dropped."
         },
         "failure": {
           "anyOf": [
@@ -2343,6 +2702,37 @@
           ],
           "description": "Typed failure info; null unless the run failed.",
           "default": null
+        },
+        "requiredActions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "enum": [
+                  "provide_required_input",
+                  "complete_incomplete_work",
+                  "resolve_review_block",
+                  "fix_failed_checks",
+                  "record_operator_decision"
+                ],
+                "description": "Stable machine id for a required operator action on a blocked terminal run."
+              },
+              "detail": {
+                "type": "string",
+                "description": "Human-readable guidance for this action (English-only, INV-141)."
+              }
+            },
+            "required": [
+              "id",
+              "detail"
+            ],
+            "additionalProperties": false,
+            "description": "One typed required operator action derived from a run's terminal outcome facts."
+          },
+          "default": [],
+          "description": "Stable-id required operator actions for a succeeded-but-blocked run (GH #29); empty for clean/decided/failed runs."
         }
       },
       "required": [