@claudexor/schema 2.1.2 → 3.0.0

package/generated/ControlRunDetail.schema.json

@@ -24,21 +24,12 @@
               "enum": [
                 "queued",
                 "running",
-                "blocked",
                 "succeeded",
-                "no_op",
-                "ungated",
-                "review_not_run",
                 "failed",
                 "cancelled",
-                "interrupted_unknown",
-                "cost_unverifiable",
-                "exhausted_overshoot",
-                "exhausted",
-                "not_converged",
-                "stuck_no_progress"
+                "interrupted"
               ],
-              "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
+              "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
             },
             "runDir": {
               "type": "string",
@@ -196,11 +187,9 @@
               "enum": [
                 "ask",
                 "plan",
-                "audit",
-                "agent",
-                "orchestrate"
+                "agent"
               ],
-              "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."
+              "description": "Canonical run mode: ask and plan are read-only, agent writes. Engine strategies (race width, attempts, deep_scan, create, delegate) are flags on a mode, not modes."
             },
             "strategy": {
               "anyOf": [
@@ -210,7 +199,7 @@
                     "race",
                     "attempts",
                     "until_clean",
-                    "swarm",
+                    "deep_scan",
                     "create"
                   ]
                 },
@@ -218,7 +207,7 @@
                   "type": "null"
                 }
               ],
-              "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / swarm / create); flags, not modes."
+              "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / deep-scan / create); flags, not modes."
             },
             "prompt": {
               "type": "string",
@@ -281,7 +270,7 @@
                   "harness"
                 ],
                 "additionalProperties": false,
-                "description": "One reviewer of an explicit reviewer panel."
+                "description": "One reviewer of an explicit reviewer panel — a harness plus optional model and effort. The CLI spells one entry `harness=model:effort` (e.g. `claude=claude-opus-4-8:max`)."
               },
               "description": "Explicit reviewer panel used for the run."
             },
@@ -835,6 +824,87 @@
               "description": "Honest terminal outcome of a run (what the turn actually did), projected from the work product and answer artifacts.",
               "default": {}
             },
+            "outcomeFacts": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "lifecycle": {
+                      "type": "string",
+                      "enum": [
+                        "succeeded",
+                        "failed",
+                        "cancelled",
+                        "interrupted"
+                      ],
+                      "description": "Terminal lifecycle of the run."
+                    },
+                    "noChanges": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "True when the run finished without changing any files (the ex no_op fact)."
+                    },
+                    "checks": {
+                      "type": "string",
+                      "enum": [
+                        "passed",
+                        "failed",
+                        "not_configured"
+                      ],
+                      "description": "Deterministic checks axis: configured project checks passed, failed, or none are configured (a named state, never a stand-in for review results).",
+                      "default": "not_configured"
+                    },
+                    "review": {
+                      "type": "string",
+                      "enum": [
+                        "approved",
+                        "blocked",
+                        "not_run"
+                      ],
+                      "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
+                      "default": "not_run"
+                    },
+                    "reason": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "harness_failed",
+                            "no_changes",
+                            "review_blocked",
+                            "checks_failed",
+                            "budget_exhausted",
+                            "budget_overshoot",
+                            "cost_unverifiable",
+                            "not_converged",
+                            "stuck_no_progress",
+                            "wall_clock_exceeded",
+                            "user_cancelled",
+                            "crash_interrupted"
+                          ],
+                          "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
+                      "default": null
+                    }
+                  },
+                  "required": [
+                    "lifecycle"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Independent terminal outcome axes of a run (D8/D18)."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "D8 terminal outcome axes (checks/review/reason/noChanges) projected from decision.facts or derived from the failure; null while non-terminal.",
+              "default": null
+            },
             "waitingOnUser": {
               "type": "boolean",
               "default": false,
@@ -925,15 +995,6 @@
               },
               "description": "Typed argv 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."
@@ -955,6 +1016,14 @@
           "additionalProperties": false,
           "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
         },
+        "outcomeBanner": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Server-owned outcome headline (status-projection.outcomeBanner); null while the run is not terminal."
+        },
         "lastSeq": {
           "type": "integer",
           "minimum": 0,
@@ -1032,6 +1101,11 @@
                   "type": "integer",
                   "minimum": 0,
                   "description": "Size of the output in bytes."
+                },
+                "truncated": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when text is a bounded inline preview of the full artifact."
                 }
               },
               "required": [
@@ -1215,36 +1289,8 @@
                   ],
                   "description": "Winning attempt/candidate id; null when nothing won."
                 },
-                "status": {
-                  "type": "string",
-                  "enum": [
-                    "success",
-                    "no_op",
-                    "ungated",
-                    "review_not_run",
-                    "blocked",
-                    "failed",
-                    "interrupted_unknown",
-                    "cost_unverifiable",
-                    "exhausted_overshoot",
-                    "exhausted",
-                    "not_converged",
-                    "stuck_no_progress",
-                    "cancelled"
-                  ],
-                  "description": "Terminal status of a run, including truthful blocked, interrupted-unknown, cost-unverifiable, overshoot, exhaustion, non-convergence, failure, and cancellation outcomes."
-                },
-                "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"
+                "facts": {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/outcomeFacts/anyOf/0"
                 },
                 "why_winner": {
                   "type": "string",
@@ -1313,10 +1359,9 @@
                     "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.",
+                  "description": "Recommended next action for the run's work product: apply it, inspect first, continue working, or get human review.",
                   "default": "inspect"
                 },
                 "verification_basis": {
@@ -1423,10 +1468,10 @@
               },
               "required": [
                 "winner",
-                "status"
+                "facts"
               ],
               "additionalProperties": false,
-              "description": "The arbitration decision for a run: winner, status/outcome, reasons, spend, and the verification that backs applyability."
+              "description": "The arbitration decision for a run: winner, outcome axes, reasons, spend, and the verification that backs applyability."
             },
             {
               "type": "null"
@@ -1527,6 +1572,196 @@
           "description": "The run's work product; null when none was produced.",
           "default": null
         },
+        "planReadiness": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "ready",
+                    "needs_answers",
+                    "unverified"
+                  ],
+                  "description": "Derived plan readiness: ready (block parsed, zero open questions), needs_answers (open questions remain), unverified (no parseable block — the planner ignored the format)."
+                },
+                "questionCount": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 0
+                }
+              },
+              "required": [
+                "state"
+              ],
+              "additionalProperties": false,
+              "description": "Server-derived readiness of a plan run (one derivation owner; D17)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Derived readiness of a plan run; null for non-plan runs.",
+          "default": null
+        },
+        "planQuestions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Stable question id within the plan revision."
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "single",
+                  "multi",
+                  "text"
+                ],
+                "description": "Question kind: pick exactly one, pick one or more, or free text."
+              },
+              "prompt": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The question text."
+              },
+              "options": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Stable option id within the question."
+                    },
+                    "label": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Option label shown to the user."
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "label"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One selectable option of a plan question."
+                },
+                "default": [],
+                "description": "Options for single/multi questions; empty for free text."
+              },
+              "allow_text": {
+                "type": "boolean",
+                "default": false,
+                "description": "True when a free-text answer is accepted (text questions)."
+              }
+            },
+            "required": [
+              "id",
+              "kind",
+              "prompt"
+            ],
+            "additionalProperties": false,
+            "description": "One open question surfaced by a plan revision."
+          },
+          "default": [],
+          "description": "Open questions of a plan run (projected from final/questions.json); empty otherwise."
+        },
+        "council": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "requested": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Requested member count (n; 2..4)."
+                },
+                "drafted": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Members whose draft survived to the merge."
+                },
+                "degraded": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when fewer members drafted than requested (failures disclosed per member)."
+                },
+                "mergedBy": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Harness that produced the unified plan (the primary); null if the merge failed."
+                },
+                "members": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harnessId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Harness that drafted (or merged) this member's plan."
+                      },
+                      "role": {
+                        "type": "string",
+                        "enum": [
+                          "primary",
+                          "member"
+                        ],
+                        "description": "primary = the merger that synthesizes the unified plan; member = draft only."
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "drafted",
+                          "failed",
+                          "merged"
+                        ],
+                        "description": "drafted = draft landed; merged = this member produced the unified plan; failed."
+                      },
+                      "error": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "First redacted draft error; null unless the member failed."
+                      }
+                    },
+                    "required": [
+                      "harnessId",
+                      "role",
+                      "status"
+                    ],
+                    "additionalProperties": false,
+                    "description": "One council member's role and draft/merge outcome."
+                  },
+                  "default": [],
+                  "description": "Per-member role and outcome."
+                }
+              },
+              "required": [
+                "requested",
+                "drafted"
+              ],
+              "additionalProperties": false,
+              "description": "Council membership + merge disclosure for a --council plan run."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Council membership + merge disclosure; null for solo plans and non-plan runs.",
+          "default": null
+        },
         "applyEligibility": {
           "anyOf": [
             {
@@ -1541,7 +1776,7 @@
                     "string",
                     "null"
                   ],
-                  "description": "The gate's state classification (e.g. blocked | ungated | review_not_run | no_op | ok) when known."
+                  "description": "The gate's apply-eligibility classification (e.g. needs_review | not_verified | no_changes | ok) when known."
                 },
                 "reason": {
                   "type": [
@@ -1925,157 +2160,6 @@
           "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."
-                      },
-                      "required": {
-                        "type": "boolean",
-                        "default": true
-                      },
-                      "terminal_status": {
-                        "anyOf": [
-                          {
-                            "$ref": "#/definitions/ControlRunDetail/properties/decision/anyOf/0/properties/status"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "description": "Actual child/delivery terminal used by the parent outcome reducer.",
-                        "default": null
-                      },
-                      "terminal_source": {
-                        "anyOf": [
-                          {
-                            "type": "string",
-                            "enum": [
-                              "executor",
-                              "subrun",
-                              "review",
-                              "delivery",
-                              "policy",
-                              "budget"
-                            ]
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "default": null,
-                        "description": "Authority that produced terminal_status."
-                      },
-                      "evidence_refs": {
-                        "type": "array",
-                        "items": {
-                          "type": "string",
-                          "minLength": 1
-                        },
-                        "default": [],
-                        "description": "Immutable run artifact or delivery receipt references."
-                      },
-                      "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": {
@@ -2112,6 +2196,14 @@
                 "default": false,
                 "description": "True when the candidate's attempt errored."
               },
+              "errorReason": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "First redacted attempt error; null when the candidate did not error."
+              },
               "gatesPassed": {
                 "type": "integer",
                 "minimum": 0,