@claudexor/schema 1.0.0

package/generated/ControlRunDetail.schema.json

@@ -0,0 +1,1925 @@
+{
+  "$ref": "#/definitions/ControlRunDetail",
+  "definitions": {
+    "ControlRunDetail": {
+      "type": "object",
+      "properties": {
+        "summary": {
+          "type": "object",
+          "properties": {
+            "jobId": {
+              "type": "string",
+              "description": "Daemon job id backing the run."
+            },
+            "runId": {
+              "type": "string",
+              "description": "Run id."
+            },
+            "taskId": {
+              "type": "string",
+              "description": "Task id, when allocated."
+            },
+            "state": {
+              "type": "string",
+              "enum": [
+                "queued",
+                "running",
+                "blocked",
+                "succeeded",
+                "no_op",
+                "ungated",
+                "review_not_run",
+                "failed",
+                "cancelled",
+                "interrupted",
+                "exhausted",
+                "not_converged",
+                "stuck_no_progress"
+              ],
+              "description": "Control-plane run state: queued/running while live; blocked awaiting a human; then a terminal outcome (succeeded, no_op, ungated, review_not_run, failed, cancelled, interrupted, exhausted, not_converged, stuck_no_progress)."
+            },
+            "runDir": {
+              "type": "string",
+              "description": "On-disk run artifact directory."
+            },
+            "error": {
+              "type": "string",
+              "description": "Error message, when the run failed."
+            },
+            "failure": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "phase": {
+                      "type": "string",
+                      "default": "unknown",
+                      "description": "Pipeline phase where the failure happened."
+                    },
+                    "category": {
+                      "type": "string",
+                      "enum": [
+                        "validation",
+                        "project",
+                        "auth",
+                        "harness_unavailable",
+                        "harness_error",
+                        "budget",
+                        "policy",
+                        "cancelled",
+                        "internal",
+                        "unknown"
+                      ],
+                      "default": "unknown",
+                      "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+                    },
+                    "harnessId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Harness involved in the failure, when known."
+                    },
+                    "attemptId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Attempt involved in the failure, when known."
+                    },
+                    "safeMessage": {
+                      "type": "string",
+                      "description": "Redacted human-readable failure message."
+                    },
+                    "rawDetailRef": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Artifact path holding the raw (redacted) failure detail."
+                    },
+                    "logRefs": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "default": [],
+                      "description": "Log artifact paths relevant to the failure."
+                    },
+                    "eventRefs": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "default": [],
+                      "description": "Event references relevant to the failure."
+                    },
+                    "runDir": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Run artifact directory."
+                    },
+                    "nextActions": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "default": [],
+                      "description": "Suggested operator next actions."
+                    }
+                  },
+                  "required": [
+                    "safeMessage"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Typed failure record for a run: phase, category, evidence references, and suggested next actions."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Typed failure record; null unless the run failed.",
+              "default": null
+            },
+            "project": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "project",
+                    "none"
+                  ],
+                  "default": "none",
+                  "description": "Whether the run was anchored to a project."
+                },
+                "root": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Project root, when anchored."
+                },
+                "projectName": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Project display name, when anchored."
+                },
+                "context": {
+                  "type": "string",
+                  "enum": [
+                    "off",
+                    "auto"
+                  ],
+                  "default": "off",
+                  "description": "Project context depth used for the run."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Project metadata projected onto a run summary.",
+              "default": {}
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "ask",
+                "plan",
+                "audit",
+                "agent",
+                "orchestrate"
+              ],
+              "description": "Canonical run mode: ask, plan, and audit are read-only; agent writes; orchestrate is the autonomous coordinator intent. Engine strategies (race, attempts, swarm, create) are flags on a mode, not modes."
+            },
+            "strategy": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "race",
+                    "attempts",
+                    "until_clean",
+                    "swarm",
+                    "create"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / swarm / create); flags, not modes."
+            },
+            "prompt": {
+              "type": "string",
+              "description": "The user's prompt for the run."
+            },
+            "harnesses": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Harness pool the run used."
+            },
+            "primaryHarness": {
+              "type": "string",
+              "description": "Primary harness the run preferred."
+            },
+            "portfolio": {
+              "type": "string",
+              "enum": [
+                "daily-rich",
+                "balanced",
+                "cheapest",
+                "strongest",
+                "burn",
+                "subscription-first",
+                "api-overflow",
+                "conserve-claude",
+                "conserve-codex"
+              ],
+              "description": "Budget portfolio weighting the harness router's quality/cost/latency and subscription-vs-API preferences (e.g. cheapest minimizes spend, burn maximizes quality, conserve-* deprioritizes one vendor)."
+            },
+            "model": {
+              "type": "string",
+              "description": "Scalar model requested for the run."
+            },
+            "reviewerPanel": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "harness": {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": "\\S",
+                    "description": "Explicit reviewer harness id; repeated harness ids are allowed so one provider can review through multiple requested models."
+                  },
+                  "model": {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": "\\S",
+                    "description": "Per-reviewer model hint, passed to that harness only."
+                  },
+                  "effort": {
+                    "type": "string",
+                    "enum": [
+                      "low",
+                      "medium",
+                      "high",
+                      "xhigh",
+                      "max"
+                    ],
+                    "description": "Per-reviewer effort hint, passed to that harness only."
+                  }
+                },
+                "required": [
+                  "harness"
+                ],
+                "additionalProperties": false,
+                "description": "One reviewer of an explicit reviewer panel."
+              },
+              "description": "Explicit reviewer panel used for the run."
+            },
+            "protectedPathApprovals": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": "\\S",
+                    "description": "Glob approved by the operator/user for this run; consumed only by the auto-protected gate/test path policy, not by built-in critical-path gates."
+                  },
+                  "reason": {
+                    "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/reviewerPanel/items/properties/model",
+                    "description": "Optional human-readable reason for the approval."
+                  }
+                },
+                "required": [
+                  "path"
+                ],
+                "additionalProperties": false,
+                "description": "Per-run typed operator approval allowing changes under an auto-protected gate/test path."
+              },
+              "description": "Per-run protected-path approvals supplied."
+            },
+            "n": {
+              "type": "integer",
+              "description": "Race width, when the run was a race."
+            },
+            "maxUsd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "description": "USD cap for the run; null = no cap."
+            },
+            "spendUsd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "description": "Settled spend in USD; null when unknown."
+            },
+            "spendEstimated": {
+              "type": "boolean",
+              "description": "True when spend is token-derived rather than natively reported."
+            },
+            "access": {
+              "type": "string",
+              "enum": [
+                "readonly",
+                "workspace_write",
+                "full",
+                "external_sandbox_full",
+                "inherit_native"
+              ],
+              "description": "Access profile of the run: the effective profile when known, else the requested one (prefer requestedAccess/effectiveAccess)."
+            },
+            "requestedAccess": {
+              "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/access",
+              "description": "Access profile the caller requested."
+            },
+            "effectiveAccess": {
+              "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/access",
+              "description": "Access profile actually enforced by the engine."
+            },
+            "externalContextPolicy": {
+              "type": "string",
+              "enum": [
+                "off",
+                "auto",
+                "cached",
+                "live"
+              ],
+              "description": "Requested web policy for the run."
+            },
+            "webRequired": {
+              "type": "boolean",
+              "description": "Whether the run required web evidence."
+            },
+            "webMode": {
+              "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/externalContextPolicy",
+              "description": "Web policy actually executed by the selected route."
+            },
+            "webEvidence": {
+              "type": "object",
+              "properties": {
+                "required": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Whether the run required web evidence."
+                },
+                "mode": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/externalContextPolicy",
+                  "default": "auto",
+                  "description": "Requested external-context policy for the run."
+                },
+                "effectiveMode": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/externalContextPolicy",
+                  "default": "auto",
+                  "description": "Policy the selected route actually executed (disclosed upgrades, e.g. cached to live)."
+                },
+                "attempted": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Whether any web activity was attempted."
+                },
+                "satisfied": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Whether the web-evidence requirement was satisfied."
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "none",
+                    "attempted",
+                    "satisfied",
+                    "failed",
+                    "unverified"
+                  ],
+                  "default": "none",
+                  "description": "Web-evidence verdict for the run."
+                },
+                "tool": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Web tool that produced the evidence, when any."
+                },
+                "target": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Redacted target (query/url) of the web activity, when any."
+                },
+                "errorSummary": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Redacted error detail when web activity failed."
+                },
+                "rawDetailRef": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Artifact path holding the raw (redacted) evidence detail."
+                },
+                "available": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "False when the run predates the telemetry artifact; surfaces must render \"telemetry unavailable\"."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Web evidence projected onto a run summary from the telemetry artifact.",
+              "default": {}
+            },
+            "toolPermissionPolicy": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Tool allow/deny policy applied to the run."
+            },
+            "outputReadyState": {
+              "type": "string",
+              "enum": [
+                "pending",
+                "finalizing",
+                "ready",
+                "diagnostic"
+              ],
+              "description": "Whether a terminal run also has a loaded user-facing output artifact: pending (not yet), finalizing (being produced), ready (loaded), diagnostic (only diagnostic output).",
+              "default": "pending"
+            },
+            "toolWarningsTotal": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "description": "Non-blocking tool warnings projected from the telemetry artifact."
+            },
+            "result": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "patch",
+                    "answer",
+                    "plan",
+                    "report",
+                    "none"
+                  ],
+                  "default": "none",
+                  "description": "What the turn actually produced: a patch, an answer, a plan (no files changed), a report, or nothing."
+                },
+                "diffStat": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "files": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "description": "Files changed."
+                        },
+                        "additions": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "description": "Lines added."
+                        },
+                        "deletions": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "description": "Lines deleted."
+                        }
+                      },
+                      "required": [
+                        "files",
+                        "additions",
+                        "deletions"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "description": "Diff statistics; null unless a patch exists."
+                },
+                "blockers": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 0,
+                  "description": "Count of accepted blocking review findings."
+                },
+                "adopted": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "True when the live in-place tree was mutated this turn (regardless of review); null when unknown."
+                },
+                "applyState": {
+                  "type": "string",
+                  "enum": [
+                    "not_applied",
+                    "applied",
+                    "applied_review_blocked",
+                    "reverted"
+                  ],
+                  "description": "Honest application state of a run's changes: not_applied (no in-place mutation), applied (applied and review clean), applied_review_blocked (applied but review blocked/unconverged), or reverted.",
+                  "default": "not_applied"
+                },
+                "preTurnSha": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Tree SHA before this turn mutated the in-place tree (revert restore target)."
+                },
+                "postTurnSha": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Tree SHA right after this turn's mutation; revert refuses if the working tree has diverged from this since."
+                },
+                "revertable": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Revert metadata is available so a Revert affordance may be offered; not a live-safe guarantee — the server re-checks tree divergence at revert time."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Honest terminal outcome of a run (what the turn actually did), projected from the work product and answer artifacts.",
+              "default": {}
+            },
+            "waitingOnUser": {
+              "type": "boolean",
+              "default": false,
+              "description": "True while at least one interactive question is awaiting the user's answer."
+            },
+            "route": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "requestedModel": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Model requested for the run."
+                    },
+                    "observedModel": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Model the harness stream actually reported."
+                    },
+                    "harnessId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Harness that ran the final attempt."
+                    },
+                    "verified": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "True only when an observed model was actually reported by the harness stream — never inferred from the request."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Run-level route evidence projected from telemetry (requested vs observed model)."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Route evidence from telemetry; null when no telemetry exists (legacy runs).",
+              "default": null
+            },
+            "tests": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Test commands configured as gates."
+            },
+            "specId": {
+              "type": "string",
+              "description": "SpecPack id the run was held to."
+            },
+            "specHash": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Content hash of the SpecPack the run was held to."
+            },
+            "createdAt": {
+              "type": "string",
+              "description": "When the run was created."
+            },
+            "startedAt": {
+              "type": "string",
+              "description": "When the run started."
+            },
+            "finishedAt": {
+              "type": "string",
+              "description": "When the run finished."
+            }
+          },
+          "required": [
+            "jobId",
+            "runId",
+            "state"
+          ],
+          "additionalProperties": false,
+          "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
+        },
+        "lastSeq": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Highest event seq included in this snapshot; clients subscribe to the event stream from this cursor (snapshot-then-subscribe, no gaps, no dupes)."
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Artifact path relative to the run directory."
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "file",
+                  "directory"
+                ],
+                "description": "Whether the artifact is a file or a directory."
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Size in bytes; absent for directories."
+              },
+              "mime": {
+                "type": "string",
+                "description": "MIME type derived from the extension; absent for directories."
+              }
+            },
+            "required": [
+              "path",
+              "kind"
+            ],
+            "additionalProperties": false,
+            "description": "One artifact in the run's artifact tree."
+          },
+          "default": [],
+          "description": "Artifacts recorded in the run tree."
+        },
+        "primaryOutput": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "answer",
+                    "report",
+                    "plan",
+                    "summary",
+                    "patch",
+                    "diagnostic"
+                  ],
+                  "description": "What kind of output this is: answer, report, plan, summary, patch, or diagnostic."
+                },
+                "path": {
+                  "type": "string",
+                  "description": "Artifact path of the output."
+                },
+                "text": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Inline text content, when loaded."
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Size of the output in bytes."
+                }
+              },
+              "required": [
+                "kind",
+                "path"
+              ],
+              "additionalProperties": false,
+              "description": "The run's primary user-facing output artifact."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The run's primary user-facing output; null while pending.",
+          "default": null
+        },
+        "timeline": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "description": "Run event type."
+              },
+              "ts": {
+                "type": "string",
+                "description": "Event timestamp."
+              },
+              "harnessId": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Harness involved, when any."
+              },
+              "attemptId": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Attempt involved, when any."
+              },
+              "title": {
+                "type": "string",
+                "description": "Human-readable event title."
+              },
+              "detail": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Human-readable event detail."
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "info",
+                  "warning",
+                  "error"
+                ],
+                "default": "info",
+                "description": "Display severity of the event."
+              },
+              "toolName": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Tool name for tool events."
+              },
+              "target": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Redacted tool target for tool events."
+              },
+              "errorSummary": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Redacted error detail for error events."
+              },
+              "rawRef": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Reference to the raw underlying event/artifact."
+              }
+            },
+            "required": [
+              "type",
+              "title"
+            ],
+            "additionalProperties": false,
+            "description": "One projected timeline row of a run for display."
+          },
+          "default": [],
+          "description": "Projected timeline of run events."
+        },
+        "budget": {
+          "type": "object",
+          "properties": {
+            "maxUsd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "USD cap for the run; null = no cap."
+            },
+            "spendUsd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "Spend so far in USD; null when unknown."
+            },
+            "remainingUsd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "Remaining budget in USD; null when no cap or unknown spend."
+            },
+            "estimated": {
+              "type": "boolean",
+              "default": false,
+              "description": "True when spend is token-derived rather than natively reported."
+            },
+            "source": {
+              "type": "string",
+              "enum": [
+                "decision",
+                "events",
+                "settings",
+                "unknown"
+              ],
+              "default": "unknown",
+              "description": "Where the snapshot came from: the decision record, live events, settings, or unknown."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Budget snapshot for a run: cap, spend, and provenance.",
+          "default": {}
+        },
+        "finalSummary": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Final summary text; null when the run has none."
+        },
+        "decision": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "winner": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Non-empty identifier string."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Winning attempt/candidate id; null when nothing won."
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "success",
+                    "no_op",
+                    "ungated",
+                    "review_not_run",
+                    "blocked",
+                    "not_converged",
+                    "stuck_no_progress",
+                    "failed",
+                    "exhausted",
+                    "cancelled"
+                  ],
+                  "description": "Terminal status of a run: success, no_op (nothing to change), ungated (no gates configured), review_not_run, blocked (accepted blocking findings), not_converged, stuck_no_progress, failed, exhausted (attempt/budget caps), or cancelled."
+                },
+                "outcome": {
+                  "type": "string",
+                  "enum": [
+                    "ready",
+                    "no_op",
+                    "ungated",
+                    "review_not_run",
+                    "blocked"
+                  ],
+                  "description": "Arbitration outcome for the winning candidate: ready (verified applyable), no_op (no changes), ungated (no gates configured), review_not_run, or blocked.",
+                  "default": "blocked"
+                },
+                "why_winner": {
+                  "type": "string",
+                  "default": "",
+                  "description": "Why the winner was chosen."
+                },
+                "why_not_others": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "default": {},
+                  "description": "Per-candidate reasons the others lost, keyed by candidate id."
+                },
+                "accepted_risks": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Risks explicitly accepted in the decision."
+                },
+                "final_checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Final checks performed before the decision."
+                },
+                "evidence_facts": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Evidence facts the decision rests on."
+                },
+                "budget_summary": {
+                  "type": "object",
+                  "properties": {
+                    "spend_usd": {
+                      "type": [
+                        "number",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Total settled spend in USD; null when unknown."
+                    },
+                    "estimated": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "True when any of the spend is token-derived rather than natively reported."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "default": {
+                    "spend_usd": null,
+                    "estimated": false
+                  },
+                  "description": "Settled spend for the run; estimates are disclosed, never presented as exact."
+                },
+                "apply_recommendation": {
+                  "type": "string",
+                  "enum": [
+                    "apply",
+                    "inspect",
+                    "continue",
+                    "split_task",
+                    "human_review"
+                  ],
+                  "description": "Recommended next action for the run's work product: apply it, inspect first, continue working, split the task, or get human review.",
+                  "default": "inspect"
+                },
+                "verification_basis": {
+                  "type": "string",
+                  "enum": [
+                    "none",
+                    "cross_family_review",
+                    "both"
+                  ],
+                  "description": "What backed an applyable outcome: none (non-applyable), cross_family_review (a clean cross-family verified review), or both (deterministic gates and that review).",
+                  "default": "none"
+                },
+                "final_verify": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "attempted": {
+                          "type": "boolean",
+                          "description": "Whether the final verify was attempted."
+                        },
+                        "base_sha": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Base SHA the verify tree was created from (the winner envelope's base)."
+                        },
+                        "applied_cleanly": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Whether the patch applied cleanly onto the fresh tree; null when not attempted."
+                        },
+                        "gates_passed": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Whether the re-run deterministic gates passed; null when not attempted."
+                        },
+                        "gates": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "id": {
+                                "type": "string",
+                                "description": "Gate id."
+                              },
+                              "status": {
+                                "type": "string",
+                                "description": "Gate status."
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "status"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "default": [],
+                          "description": "Per-gate re-run results."
+                        },
+                        "duration_ms": {
+                          "anyOf": [
+                            {
+                              "type": "integer",
+                              "minimum": 0
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "default": null,
+                          "description": "How long the verify took, in milliseconds."
+                        },
+                        "reason": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Typed reason when attempted=false (e.g. no_patch, no_base_sha) or a failure detail."
+                        }
+                      },
+                      "required": [
+                        "attempted"
+                      ],
+                      "additionalProperties": false,
+                      "description": "FinalVerifier record: the winner's patch was applied onto a fresh worktree at the candidate's own base SHA and the deterministic gates were re-run there; no model involvement."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Final verify record; present only for write runs with a patch (or a recorded reason why the verifier did not run).",
+                  "default": null
+                }
+              },
+              "required": [
+                "winner",
+                "status"
+              ],
+              "additionalProperties": false,
+              "description": "The arbitration decision for a run: winner, status/outcome, reasons, spend, and the verification that backs applyability."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The arbitration decision; null before arbitration.",
+          "default": null
+        },
+        "operatorDecision": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "description": "Operator decision action (e.g. accept_risk, override)."
+                },
+                "decidedAt": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "When the decision was made."
+                }
+              },
+              "required": [
+                "action"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Persisted operator unblock decision (accept_risk/override), hash-bound; null when none was made."
+        },
+        "workProduct": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Work product id."
+                },
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "patch",
+                    "new_repo",
+                    "report"
+                  ],
+                  "description": "Kind of work product a run produces: a patch against the base tree, a newly created repository, or a report document."
+                },
+                "source_task_id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Task the work product came from."
+                },
+                "producer_attempt_id": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/decision/anyOf/0/properties/winner/anyOf/0",
+                  "description": "Attempt that produced it, when known."
+                },
+                "evidence_dir": {
+                  "type": "string",
+                  "description": "Directory holding run evidence artifacts."
+                },
+                "files": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "default": {},
+                  "description": "Kind-specific file payload, e.g. artifact name to path (validated loosely here; specialized per kind by callers)."
+                },
+                "meta": {
+                  "type": "object",
+                  "additionalProperties": {},
+                  "default": {},
+                  "description": "Kind-specific metadata."
+                }
+              },
+              "required": [
+                "id",
+                "kind",
+                "source_task_id"
+              ],
+              "additionalProperties": false,
+              "description": "The deliverable a run produced (patch, new repo, or report), referenced by apply/delivery verbs."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The run's work product; null when none was produced.",
+          "default": null
+        },
+        "applyEligibility": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "eligible": {
+                  "type": "boolean",
+                  "description": "True when the apply gate would accept this run's patch right now."
+                },
+                "state": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The gate's state classification (e.g. blocked | ungated | review_not_run | no_op | ok) when known."
+                },
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The gate's refusal text when not eligible (null when eligible)."
+                },
+                "requiredAction": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Honest guidance for what actually unblocks apply (typed operator decision, add gates, re-run, or nothing to apply)."
+                }
+              },
+              "required": [
+                "eligible",
+                "state",
+                "reason",
+                "requiredAction"
+              ],
+              "additionalProperties": false,
+              "description": "Derived apply-gate verdict for a run's WorkProduct (single producer in the delivery gate)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Derived apply-gate verdict (single producer: the delivery gate); null when the run has no patch artifact.",
+          "default": null
+        },
+        "reviewFindings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Finding id."
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "BLOCK",
+                  "FIX_FIRST",
+                  "WARN",
+                  "NIT",
+                  "OUT_OF_SCOPE",
+                  "INSUFFICIENT_EVIDENCE",
+                  "NEEDS_HUMAN"
+                ],
+                "description": "Reviewer-assigned severity of a finding: BLOCK and FIX_FIRST can block convergence when accepted with evidence, WARN/NIT are advisory, OUT_OF_SCOPE and INSUFFICIENT_EVIDENCE are triage verdicts, NEEDS_HUMAN escalates to a human decision."
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "correctness",
+                  "regression",
+                  "security",
+                  "performance",
+                  "maintainability",
+                  "test_gap",
+                  "spec_gap",
+                  "deploy",
+                  "architecture",
+                  "ux"
+                ],
+                "description": "Subject-matter category of a review finding."
+              },
+              "claim": {
+                "type": "string",
+                "description": "The reviewer's claim, stated concretely."
+              },
+              "linked_acceptance_criteria": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/decision/anyOf/0/properties/winner/anyOf/0"
+                },
+                "default": [],
+                "description": "Ids of acceptance criteria this finding relates to."
+              },
+              "evidence": {
+                "type": "object",
+                "properties": {
+                  "files": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "description": "Repo-relative file path."
+                        },
+                        "lines": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Line range in the file (e.g. \"10-42\"); null when the whole file is cited."
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "additionalProperties": false,
+                      "description": "File citation supporting a finding."
+                    },
+                    "default": [],
+                    "description": "File citations."
+                  },
+                  "diff_hunks": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "default": [],
+                    "description": "Diff hunks quoted as evidence."
+                  },
+                  "commands": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "command": {
+                          "type": "string",
+                          "description": "Command whose output supports the finding."
+                        }
+                      },
+                      "required": [
+                        "command"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Command citation supporting a finding."
+                    },
+                    "default": [],
+                    "description": "Commands whose output supports the finding."
+                  },
+                  "logs": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "description": "Log file path."
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "default": [],
+                    "description": "Log files cited as evidence."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Evidence backing a finding; a finding without evidence cannot block.",
+                "default": {}
+              },
+              "proposed_fix": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Reviewer-proposed fix; null when none was offered."
+              },
+              "reviewer": {
+                "type": "object",
+                "properties": {
+                  "harness_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Harness that produced the review."
+                  },
+                  "requested_model": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Model requested for the reviewer route."
+                  },
+                  "requested_effort": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Reasoning effort requested for the reviewer route."
+                  },
+                  "observed_model": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Model the harness actually reported using."
+                  },
+                  "route_proof_status": {
+                    "type": "string",
+                    "enum": [
+                      "verified",
+                      "accepted_model_arg",
+                      "unverified",
+                      "same_model_fallback"
+                    ],
+                    "description": "How strongly the executed route is proven: verified (observed evidence matches the request), accepted_model_arg (the requested model arg was accepted without stream evidence), unverified, or same_model_fallback (a fallback landed on the same model).",
+                    "default": "unverified"
+                  }
+                },
+                "required": [
+                  "harness_id"
+                ],
+                "additionalProperties": false,
+                "description": "Who reviewed: the harness/model route and its verification status."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "proposed",
+                  "accepted",
+                  "rebutted",
+                  "fixed",
+                  "accepted_risk",
+                  "duplicate",
+                  "stale",
+                  "out_of_scope",
+                  "insufficient_evidence"
+                ],
+                "description": "Lifecycle status of a finding, from proposed through accepted/rebutted/fixed to terminal triage states (accepted_risk, duplicate, stale, out_of_scope, insufficient_evidence).",
+                "default": "proposed"
+              },
+              "revalidation_note": {
+                "type": "string",
+                "description": "Note recorded when the finding was revalidated against a changed tree."
+              }
+            },
+            "required": [
+              "id",
+              "severity",
+              "category",
+              "claim",
+              "reviewer"
+            ],
+            "additionalProperties": false,
+            "description": "One evidence-backed review finding produced by a reviewer harness."
+          },
+          "default": [],
+          "description": "Review findings recorded for the run."
+        },
+        "pendingInteractions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "interactionId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Interaction id used to answer."
+              },
+              "runId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Run the interaction belongs to."
+              },
+              "attemptId": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Attempt the interaction was raised in, when known."
+              },
+              "harnessId": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Harness that raised the interaction."
+              },
+              "sourceTool": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Native tool that raised the request."
+              },
+              "questions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Question id."
+                    },
+                    "question": {
+                      "type": "string",
+                      "description": "The question text."
+                    },
+                    "header": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Short chip/header text some harnesses attach to a question."
+                    },
+                    "options": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "label": {
+                            "type": "string",
+                            "description": "Option label shown to the user."
+                          },
+                          "description": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "default": null,
+                            "description": "Optional longer explanation of the option."
+                          }
+                        },
+                        "required": [
+                          "label"
+                        ],
+                        "additionalProperties": false,
+                        "description": "One multiple-choice option of an interactive question."
+                      },
+                      "default": [],
+                      "description": "Selectable options; empty for free-text-only questions."
+                    },
+                    "multi_select": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Whether multiple options may be selected."
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "question"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One question of an interactive user-input request."
+                },
+                "default": [],
+                "description": "Questions awaiting answers."
+              },
+              "requestedAt": {
+                "type": "string",
+                "description": "When the interaction was requested."
+              },
+              "timeoutAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the interaction times out into a benign decline; null = no timeout."
+              }
+            },
+            "required": [
+              "interactionId",
+              "runId",
+              "requestedAt"
+            ],
+            "additionalProperties": false,
+            "description": "A live interactive question awaiting the user's answer (snapshot projection)."
+          },
+          "default": [],
+          "description": "Interactive questions currently awaiting answers."
+        },
+        "orchestrate": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "steps": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "index": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Position of the step in the plan."
+                      },
+                      "tool": {
+                        "type": "string",
+                        "enum": [
+                          "start_run",
+                          "race",
+                          "status",
+                          "answer_question",
+                          "apply",
+                          "review"
+                        ],
+                        "description": "Tool in the orchestrate planner's belt, mapping 1:1 onto engine entry points: start_run, race (best-of-N), status, answer_question, apply, and review."
+                      },
+                      "risk": {
+                        "type": "string",
+                        "enum": [
+                          "safe",
+                          "risky"
+                        ],
+                        "description": "Risk class of the step: safe (no live-tree mutation) or risky."
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pending",
+                          "running",
+                          "done",
+                          "skipped",
+                          "blocked",
+                          "failed"
+                        ],
+                        "description": "Executor status of one plan step: pending, running, done, skipped, blocked (risky step awaiting a human), or failed."
+                      },
+                      "run_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Sub-run id this step started/targeted, when known."
+                      },
+                      "detail": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Human-readable step detail."
+                      }
+                    },
+                    "required": [
+                      "index",
+                      "tool",
+                      "risk",
+                      "status"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "default": [],
+                  "description": "Per-step outcomes, in plan order."
+                },
+                "autonomy": {
+                  "type": "string",
+                  "enum": [
+                    "suggest",
+                    "auto_safe",
+                    "auto_full"
+                  ],
+                  "description": "How much the orchestrate planner may act without confirmation: suggest (user executes the plan), auto_safe (auto-runs only provably safe steps), auto_full (auto-runs everything)."
+                },
+                "stopped_reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Set when the executor stopped early (first risky step under auto_safe, budget, abort)."
+                }
+              },
+              "required": [
+                "autonomy"
+              ],
+              "additionalProperties": false,
+              "description": "Typed executor progress over a plan's tool calls, persisted as final/orchestration_progress.yaml and projected into run detail."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed executor progress for an orchestrate run; null for non-orchestrate runs or suggest autonomy.",
+          "default": null
+        },
+        "candidates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "attemptId": {
+                "type": "string",
+                "description": "Attempt id of the candidate."
+              },
+              "harnessId": {
+                "type": "string",
+                "description": "Harness that produced the candidate."
+              },
+              "label": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Human-readable candidate label, when set."
+              },
+              "costUsd": {
+                "type": "number",
+                "default": 0,
+                "description": "Spend attributed to the candidate, in USD."
+              },
+              "costEstimated": {
+                "type": "boolean",
+                "default": false,
+                "description": "True when the cost is token-derived rather than natively reported."
+              },
+              "errored": {
+                "type": "boolean",
+                "default": false,
+                "description": "True when the candidate's attempt errored."
+              },
+              "gatesPassed": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Number of deterministic gates that passed."
+              },
+              "gatesTotal": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Total deterministic gates run for the candidate."
+              },
+              "blockers": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Count of accepted blocking review findings."
+              },
+              "reviewVerified": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether the candidate's review route was verified."
+              },
+              "finalReviewClean": {
+                "type": [
+                  "boolean",
+                  "null"
+                ],
+                "default": null,
+                "description": "Whether the final review was clean; null when no final review ran."
+              },
+              "winner": {
+                "type": "boolean",
+                "default": false,
+                "description": "True for the adopted/winning candidate."
+              },
+              "diffstat": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "files": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "default": 0,
+                        "description": "Files changed."
+                      },
+                      "additions": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "default": 0,
+                        "description": "Lines added."
+                      },
+                      "deletions": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "default": 0,
+                        "description": "Lines deleted."
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Diff statistics of the candidate's patch; null when there is no patch."
+              }
+            },
+            "required": [
+              "attemptId",
+              "harnessId"
+            ],
+            "additionalProperties": false,
+            "description": "Per-candidate evidence card for a race run, projected from attempt, review, and decision artifacts."
+          },
+          "default": [],
+          "description": "Per-candidate evidence cards for every envelope-producing mode; empty only when no attempt artifacts exist."
+        },
+        "planProgress": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Plan item id."
+                      },
+                      "title": {
+                        "type": "string",
+                        "description": "Plan item title."
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pending",
+                          "in_progress",
+                          "completed"
+                        ],
+                        "description": "Progress state of the item."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "title",
+                      "status"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "default": [],
+                  "description": "Plan items, last-wins."
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Live plan checklist from the last plan.progress event; null when the run never emitted one."
+        },
+        "failure": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/failure/anyOf/0"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed failure info; null unless the run failed.",
+          "default": null
+        }
+      },
+      "required": [
+        "summary"
+      ],
+      "additionalProperties": false,
+      "description": "Full run detail snapshot served by GET /runs/:id: summary, artifacts, timeline, decision, findings, and progress."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}