cohorte 2.10.1 → 3.0.0-dev.1

package/assets/schemas/run-state.schema.json

@@ -0,0 +1,1755 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://cohorte.dev/schemas/3/run-state.schema.json",
+  "title": "Cohorte run snapshot (status <run> --json, inspect snapshot, first stream line)",
+  "type": "object",
+  "required": [
+    "documentVersion",
+    "protocolVersion",
+    "cohorteVersion",
+    "generatedAt",
+    "lastSequence",
+    "run",
+    "phases",
+    "approvals",
+    "budgets",
+    "usage",
+    "locks",
+    "inDoubtEffects"
+  ],
+  "properties": {
+    "documentVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "protocolVersion": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "cohorteVersion": {
+      "type": "string"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+    },
+    "lastSequence": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "run": {
+      "type": "object",
+      "required": [
+        "runId",
+        "profile",
+        "title",
+        "spec",
+        "state",
+        "status",
+        "since",
+        "iteration",
+        "host",
+        "git",
+        "plan",
+        "snapshotDigest",
+        "startedAt"
+      ],
+      "properties": {
+        "runId": {
+          "type": "string",
+          "pattern": "^run_[0-9a-f]{32}$"
+        },
+        "profile": {
+          "type": "string",
+          "x-cohorte-known": [
+            "feature",
+            "bugfix",
+            "review"
+          ]
+        },
+        "title": {
+          "type": "string"
+        },
+        "spec": {
+          "type": "object",
+          "required": [
+            "id",
+            "kind",
+            "sha256"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$"
+            },
+            "kind": {
+              "type": "string"
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            }
+          }
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "IDLE",
+            "BRAINSTORM",
+            "SPEC",
+            "PREFLIGHT",
+            "BUILD",
+            "TEST",
+            "REVIEW",
+            "FIX",
+            "SHIP",
+            "PAUSED",
+            "WAITING_APPROVAL",
+            "AUTH_REQUIRED",
+            "QUOTA_EXCEEDED",
+            "FAILED",
+            "BLOCKED",
+            "COMPLETED",
+            "CANCELLED"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "running",
+            "completed",
+            "failed",
+            "paused",
+            "waiting-approval",
+            "cancelled",
+            "skipped",
+            "blocked"
+          ]
+        },
+        "since": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+        },
+        "resumeTo": {
+          "type": "string",
+          "enum": [
+            "BRAINSTORM",
+            "SPEC",
+            "PREFLIGHT",
+            "BUILD",
+            "TEST",
+            "REVIEW",
+            "FIX",
+            "SHIP"
+          ]
+        },
+        "stop": {
+          "type": "object",
+          "required": [
+            "reason",
+            "detail",
+            "resumable"
+          ],
+          "properties": {
+            "reason": {
+              "type": "string",
+              "enum": [
+                "review-clean",
+                "iteration-limit",
+                "budget-exhausted",
+                "timeout",
+                "identical-failure",
+                "no-progress",
+                "policy-violation",
+                "approval-required",
+                "unexpected-repo-change",
+                "runtime-incompatible",
+                "auth-required",
+                "quota-exceeded",
+                "paused",
+                "cancelled",
+                "agent-dead",
+                "unreviewed",
+                "internal-error",
+                "check-environment"
+              ]
+            },
+            "detail": {
+              "type": "string"
+            },
+            "resumable": {
+              "type": "boolean"
+            },
+            "resumeRequires": {
+              "type": "string",
+              "x-cohorte-known": [
+                "approval",
+                "auth-login",
+                "quota-reset",
+                "budget-raise",
+                "human-ack",
+                "repo-repair",
+                "reinstall-pinned-version",
+                "environment-repair"
+              ]
+            }
+          }
+        },
+        "lastError": {
+          "$ref": "#/$defs/ErrorInfo"
+        },
+        "iteration": {
+          "type": "object",
+          "required": [
+            "fixRounds",
+            "maxFixRounds",
+            "reviewRounds"
+          ],
+          "properties": {
+            "fixRounds": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "maxFixRounds": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "reviewRounds": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "host": {
+          "type": "object",
+          "required": [
+            "alive"
+          ],
+          "properties": {
+            "hostId": {
+              "type": "string"
+            },
+            "alive": {
+              "type": "boolean"
+            },
+            "heartbeatAt": {
+              "type": "string",
+              "format": "date-time",
+              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+            },
+            "pid": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "git": {
+          "type": "object",
+          "required": [
+            "base",
+            "integrationBranch"
+          ],
+          "properties": {
+            "base": {
+              "type": "object",
+              "required": [
+                "branch",
+                "sha"
+              ],
+              "properties": {
+                "branch": {
+                  "type": "string"
+                },
+                "sha": {
+                  "type": "string"
+                }
+              }
+            },
+            "integrationBranch": {
+              "type": "string"
+            },
+            "integrationHead": {
+              "type": "string"
+            },
+            "approvedTreeDigest": {
+              "type": "string"
+            }
+          }
+        },
+        "plan": {
+          "type": "object",
+          "required": [
+            "profile",
+            "runtime",
+            "trust",
+            "models",
+            "apiBillingEnabled",
+            "meteredProviders",
+            "sandbox",
+            "sandboxRequire",
+            "brainIsolation",
+            "budgets",
+            "network",
+            "promptOverrides",
+            "unattended"
+          ],
+          "properties": {
+            "profile": {
+              "type": "string",
+              "x-cohorte-known": [
+                "feature",
+                "bugfix",
+                "review"
+              ]
+            },
+            "runtime": {
+              "type": "object",
+              "required": [
+                "id",
+                "version"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                }
+              }
+            },
+            "trust": {
+              "type": "object",
+              "required": [
+                "policySha256",
+                "loosenedKeys",
+                "grantedBy"
+              ],
+              "properties": {
+                "policySha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                },
+                "loosenedKeys": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "grantedBy": {
+                  "type": "string",
+                  "x-cohorte-known": [
+                    "none-needed",
+                    "user-config",
+                    "cli-flag",
+                    "trust-record"
+                  ]
+                }
+              }
+            },
+            "models": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "role",
+                  "requested",
+                  "thinking",
+                  "authMode",
+                  "billing",
+                  "reason"
+                ],
+                "properties": {
+                  "role": {
+                    "type": "string"
+                  },
+                  "requested": {
+                    "type": "object",
+                    "required": [
+                      "provider",
+                      "model"
+                    ],
+                    "properties": {
+                      "provider": {
+                        "type": "string"
+                      },
+                      "model": {
+                        "type": "string"
+                      },
+                      "capability": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "const": "fast"
+                          },
+                          {
+                            "type": "string",
+                            "const": "coding"
+                          },
+                          {
+                            "type": "string",
+                            "const": "reasoning"
+                          },
+                          {
+                            "type": "string",
+                            "const": "vision"
+                          },
+                          {
+                            "type": "string",
+                            "const": "cheap"
+                          }
+                        ]
+                      }
+                    }
+                  },
+                  "thinking": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "const": "off"
+                      },
+                      {
+                        "type": "string",
+                        "const": "minimal"
+                      },
+                      {
+                        "type": "string",
+                        "const": "low"
+                      },
+                      {
+                        "type": "string",
+                        "const": "medium"
+                      },
+                      {
+                        "type": "string",
+                        "const": "high"
+                      },
+                      {
+                        "type": "string",
+                        "const": "xhigh"
+                      }
+                    ]
+                  },
+                  "authMode": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "const": "subscription"
+                      },
+                      {
+                        "type": "string",
+                        "const": "api"
+                      }
+                    ]
+                  },
+                  "billing": {
+                    "type": "string",
+                    "enum": [
+                      "plan-limits",
+                      "metered"
+                    ]
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "apiBillingEnabled": {
+              "type": "boolean"
+            },
+            "meteredProviders": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "sandbox": {
+              "type": "object",
+              "required": [
+                "level",
+                "backend",
+                "filesystem",
+                "network"
+              ],
+              "properties": {
+                "level": {
+                  "type": "string",
+                  "x-cohorte-known": [
+                    "L0-process",
+                    "L1-os"
+                  ]
+                },
+                "backend": {
+                  "type": "string",
+                  "x-cohorte-known": [
+                    "none",
+                    "seatbelt",
+                    "bubblewrap"
+                  ]
+                },
+                "filesystem": {
+                  "type": "string",
+                  "x-cohorte-known": [
+                    "enforced",
+                    "partial",
+                    "advisory"
+                  ]
+                },
+                "network": {
+                  "type": "string",
+                  "x-cohorte-known": [
+                    "enforced-off",
+                    "partial",
+                    "unenforced"
+                  ]
+                }
+              }
+            },
+            "sandboxRequire": {
+              "type": "string",
+              "enum": [
+                "native",
+                "best-effort"
+              ]
+            },
+            "brainIsolation": {
+              "type": "string",
+              "enum": [
+                "os",
+                "process"
+              ]
+            },
+            "budgets": {
+              "type": "object",
+              "required": [
+                "run",
+                "perPhase",
+                "perAgent",
+                "perProvider",
+                "perTool"
+              ],
+              "properties": {
+                "run": {
+                  "type": "object",
+                  "properties": {
+                    "tokens": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "modelRequests": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "toolCalls": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "wallClockMs": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "retries": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "fixRounds": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "contextTokens": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "concurrentAgents": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "estimatedQuotaPercent": {
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  }
+                },
+                "perPhase": {
+                  "type": "object",
+                  "properties": {
+                    "tokens": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "modelRequests": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "toolCalls": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "wallClockMs": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "retries": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "fixRounds": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "contextTokens": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "concurrentAgents": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "estimatedQuotaPercent": {
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  }
+                },
+                "perAgent": {
+                  "type": "object",
+                  "properties": {
+                    "tokens": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "modelRequests": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "toolCalls": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "wallClockMs": {
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "retries": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "fixRounds": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "contextTokens": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "concurrentAgents": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "estimatedQuotaPercent": {
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  }
+                },
+                "perProvider": {
+                  "type": "object",
+                  "patternProperties": {
+                    "^.*$": {
+                      "type": "object",
+                      "properties": {
+                        "tokens": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "modelRequests": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "toolCalls": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "wallClockMs": {
+                          "type": "number",
+                          "minimum": 0
+                        },
+                        "retries": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "fixRounds": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "contextTokens": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "concurrentAgents": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "estimatedQuotaPercent": {
+                          "type": "number",
+                          "minimum": 0
+                        }
+                      }
+                    }
+                  }
+                },
+                "perTool": {
+                  "type": "object",
+                  "patternProperties": {
+                    "^.*$": {
+                      "type": "object",
+                      "properties": {
+                        "tokens": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "modelRequests": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "toolCalls": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "wallClockMs": {
+                          "type": "number",
+                          "minimum": 0
+                        },
+                        "retries": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "fixRounds": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "contextTokens": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "concurrentAgents": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "estimatedQuotaPercent": {
+                          "type": "number",
+                          "minimum": 0
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "network": {
+              "type": "object",
+              "required": [
+                "provisioning"
+              ],
+              "properties": {
+                "provisioning": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "promptOverrides": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "unattended": {
+              "type": "boolean"
+            }
+          }
+        },
+        "snapshotDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+        },
+        "endedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+        }
+      }
+    },
+    "phases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "state",
+          "label",
+          "status",
+          "runs"
+        ],
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "BRAINSTORM",
+              "SPEC",
+              "PREFLIGHT",
+              "BUILD",
+              "TEST",
+              "REVIEW",
+              "FIX",
+              "SHIP"
+            ]
+          },
+          "label": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "running",
+              "completed",
+              "failed",
+              "paused",
+              "waiting-approval",
+              "cancelled",
+              "skipped",
+              "blocked"
+            ]
+          },
+          "runs": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "phaseRunId",
+                "iteration",
+                "status",
+                "agents",
+                "checks"
+              ],
+              "properties": {
+                "phaseRunId": {
+                  "type": "string",
+                  "maxLength": 128,
+                  "pattern": "^phs_[A-Z][A-Z_]*_[0-9]+$"
+                },
+                "iteration": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "pending",
+                    "running",
+                    "completed",
+                    "failed",
+                    "paused",
+                    "waiting-approval",
+                    "cancelled",
+                    "skipped",
+                    "blocked"
+                  ]
+                },
+                "startedAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+                },
+                "endedAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+                },
+                "outcome": {
+                  "type": "string"
+                },
+                "agents": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": [
+                      "agentId",
+                      "role",
+                      "label",
+                      "status",
+                      "lifecycle",
+                      "attempt",
+                      "incarnation",
+                      "model",
+                      "usage"
+                    ],
+                    "properties": {
+                      "agentId": {
+                        "type": "string",
+                        "maxLength": 128,
+                        "pattern": "^agt_[A-Za-z0-9.-]+_[A-Za-z0-9_.-]+$"
+                      },
+                      "role": {
+                        "type": "string"
+                      },
+                      "surface": {
+                        "type": "string",
+                        "pattern": "^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$"
+                      },
+                      "label": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pending",
+                          "running",
+                          "completed",
+                          "failed",
+                          "paused",
+                          "waiting-approval",
+                          "cancelled",
+                          "skipped",
+                          "blocked"
+                        ]
+                      },
+                      "lifecycle": {
+                        "type": "string",
+                        "enum": [
+                          "declared",
+                          "planned",
+                          "spawning",
+                          "running",
+                          "waiting",
+                          "paused",
+                          "completed",
+                          "failed",
+                          "retrying",
+                          "escalated",
+                          "cancelled"
+                        ]
+                      },
+                      "attempt": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "incarnation": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "model": {
+                        "type": "object",
+                        "required": [
+                          "requested"
+                        ],
+                        "properties": {
+                          "requested": {
+                            "type": "object",
+                            "required": [
+                              "provider",
+                              "model"
+                            ],
+                            "properties": {
+                              "provider": {
+                                "type": "string"
+                              },
+                              "model": {
+                                "type": "string"
+                              },
+                              "capability": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "const": "fast"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "const": "coding"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "const": "reasoning"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "const": "vision"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "const": "cheap"
+                                  }
+                                ]
+                              }
+                            }
+                          },
+                          "effective": {
+                            "type": "object",
+                            "required": [
+                              "provider",
+                              "model"
+                            ],
+                            "properties": {
+                              "provider": {
+                                "type": "string"
+                              },
+                              "model": {
+                                "type": "string"
+                              }
+                            }
+                          }
+                        }
+                      },
+                      "authMode": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "const": "subscription"
+                          },
+                          {
+                            "type": "string",
+                            "const": "api"
+                          }
+                        ]
+                      },
+                      "worktree": {
+                        "type": "string"
+                      },
+                      "usage": {
+                        "type": "object",
+                        "properties": {
+                          "tokens": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "modelRequests": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "toolCalls": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "wallClockMs": {
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          "retries": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "fixRounds": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "contextTokens": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "concurrentAgents": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "estimatedQuotaPercent": {
+                            "type": "number",
+                            "minimum": 0
+                          }
+                        }
+                      },
+                      "summary": {
+                        "type": "string"
+                      },
+                      "lastError": {
+                        "$ref": "#/$defs/ErrorInfo"
+                      },
+                      "pendingApproval": {
+                        "type": "string",
+                        "pattern": "^apr_[0-9a-f]{32}$"
+                      },
+                      "runtimeRef": {
+                        "type": "object",
+                        "required": [
+                          "runtime",
+                          "version",
+                          "sessionId",
+                          "transcriptRef"
+                        ],
+                        "properties": {
+                          "runtime": {
+                            "type": "string"
+                          },
+                          "version": {
+                            "type": "string"
+                          },
+                          "sessionId": {
+                            "type": "string"
+                          },
+                          "transcriptRef": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": [
+                      "name",
+                      "status",
+                      "argv",
+                      "durationMs",
+                      "treeDigest"
+                    ],
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "passed",
+                          "failed",
+                          "errored",
+                          "skipped"
+                        ]
+                      },
+                      "argv": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "exitCode": {
+                        "type": "integer"
+                      },
+                      "durationMs": {
+                        "type": "number",
+                        "minimum": 0
+                      },
+                      "treeDigest": {
+                        "type": "string"
+                      },
+                      "output": {
+                        "type": "object",
+                        "required": [
+                          "artifactId",
+                          "kind",
+                          "path",
+                          "sha256",
+                          "bytes"
+                        ],
+                        "properties": {
+                          "artifactId": {
+                            "type": "string",
+                            "pattern": "^art_[0-9a-f]{32}$"
+                          },
+                          "kind": {
+                            "type": "string",
+                            "x-cohorte-known": [
+                              "diff",
+                              "file",
+                              "log",
+                              "report",
+                              "agent-output",
+                              "transcript",
+                              "context",
+                              "prompt",
+                              "patch"
+                            ]
+                          },
+                          "path": {
+                            "type": "string"
+                          },
+                          "sha256": {
+                            "type": "string",
+                            "pattern": "^[0-9a-f]{64}$"
+                          },
+                          "bytes": {
+                            "type": "integer",
+                            "minimum": 0
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "approvals": {
+      "type": "object",
+      "required": [
+        "pending",
+        "resolved"
+      ],
+      "properties": {
+        "pending": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "approvalId",
+              "kind",
+              "what",
+              "since",
+              "cli"
+            ],
+            "properties": {
+              "approvalId": {
+                "type": "string",
+                "pattern": "^apr_[0-9a-f]{32}$"
+              },
+              "kind": {
+                "type": "string"
+              },
+              "agentId": {
+                "type": "string",
+                "maxLength": 128,
+                "pattern": "^agt_[A-Za-z0-9.-]+_[A-Za-z0-9_.-]+$"
+              },
+              "what": {
+                "type": "string",
+                "maxLength": 512
+              },
+              "since": {
+                "type": "string",
+                "format": "date-time",
+                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+              },
+              "expiresAt": {
+                "type": "string",
+                "format": "date-time",
+                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+              },
+              "cli": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "resolved": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "budgets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "scope",
+          "consumed",
+          "limit"
+        ],
+        "properties": {
+          "scope": {
+            "type": "object",
+            "required": [
+              "level",
+              "id"
+            ],
+            "properties": {
+              "level": {
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              }
+            }
+          },
+          "consumed": {
+            "type": "object",
+            "properties": {
+              "tokens": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "modelRequests": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "toolCalls": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "wallClockMs": {
+                "type": "number",
+                "minimum": 0
+              },
+              "retries": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "fixRounds": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "contextTokens": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "concurrentAgents": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "estimatedQuotaPercent": {
+                "type": "number",
+                "minimum": 0
+              }
+            }
+          },
+          "limit": {
+            "type": "object",
+            "properties": {
+              "tokens": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "modelRequests": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "toolCalls": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "wallClockMs": {
+                "type": "number",
+                "minimum": 0
+              },
+              "retries": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "fixRounds": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "contextTokens": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "concurrentAgents": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "estimatedQuotaPercent": {
+                "type": "number",
+                "minimum": 0
+              }
+            }
+          }
+        }
+      }
+    },
+    "usage": {
+      "type": "object",
+      "required": [
+        "tokens",
+        "monetaryCost",
+        "byProvider"
+      ],
+      "properties": {
+        "tokens": {
+          "type": "object",
+          "required": [
+            "input",
+            "output",
+            "cacheRead",
+            "cacheWrite",
+            "total"
+          ],
+          "properties": {
+            "input": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "output": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cacheRead": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cacheWrite": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "total": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "monetaryCost": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "not_applicable"
+            },
+            {
+              "type": "object",
+              "required": [
+                "currency",
+                "amount",
+                "basis",
+                "priceCatalogVersion"
+              ],
+              "properties": {
+                "currency": {
+                  "type": "string",
+                  "const": "USD"
+                },
+                "amount": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "basis": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "const": "catalogue"
+                    },
+                    {
+                      "type": "string",
+                      "const": "estimate"
+                    }
+                  ]
+                },
+                "priceCatalogVersion": {
+                  "type": "string"
+                }
+              }
+            }
+          ]
+        },
+        "byProvider": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "provider",
+              "authMode",
+              "billing",
+              "tokens",
+              "quota"
+            ],
+            "properties": {
+              "provider": {
+                "type": "string"
+              },
+              "authMode": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "const": "subscription"
+                  },
+                  {
+                    "type": "string",
+                    "const": "api"
+                  }
+                ]
+              },
+              "billing": {
+                "type": "string",
+                "enum": [
+                  "plan-limits",
+                  "metered"
+                ]
+              },
+              "tokens": {
+                "type": "object",
+                "required": [
+                  "input",
+                  "output",
+                  "cacheRead",
+                  "cacheWrite",
+                  "total"
+                ],
+                "properties": {
+                  "input": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "output": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "cacheRead": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "cacheWrite": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "total": {
+                    "type": "integer",
+                    "minimum": 0
+                  }
+                }
+              },
+              "quota": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "required": [
+                      "known"
+                    ],
+                    "properties": {
+                      "known": {
+                        "type": "boolean",
+                        "const": false
+                      }
+                    }
+                  },
+                  {
+                    "type": "object",
+                    "required": [
+                      "known",
+                      "source",
+                      "provider",
+                      "windows",
+                      "observedAt"
+                    ],
+                    "properties": {
+                      "known": {
+                        "type": "boolean",
+                        "const": true
+                      },
+                      "source": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "const": "response-headers"
+                          },
+                          {
+                            "type": "string",
+                            "const": "error"
+                          }
+                        ]
+                      },
+                      "provider": {
+                        "type": "string"
+                      },
+                      "windows": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "required": [
+                            "name"
+                          ],
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "usedPercent": {
+                              "type": "number",
+                              "minimum": 0
+                            },
+                            "resetsAt": {
+                              "type": "string",
+                              "format": "date-time",
+                              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+                            },
+                            "limitLabel": {
+                              "type": "string"
+                            }
+                          }
+                        }
+                      },
+                      "observedAt": {
+                        "type": "string",
+                        "format": "date-time",
+                        "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+                      }
+                    }
+                  }
+                ]
+              },
+              "accountLabel": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "locks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "scope",
+          "key",
+          "mode"
+        ],
+        "properties": {
+          "scope": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "inDoubtEffects": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^eff_[0-9a-f]{32}$"
+      }
+    }
+  },
+  "$defs": {
+    "JsonValue": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/JsonValue"
+          }
+        },
+        {
+          "type": "object",
+          "patternProperties": {
+            "^.*$": {
+              "$ref": "#/$defs/JsonValue"
+            }
+          }
+        }
+      ]
+    },
+    "ErrorInfo": {
+      "type": "object",
+      "required": [
+        "code",
+        "class",
+        "message",
+        "impact",
+        "retryable",
+        "remediation"
+      ],
+      "properties": {
+        "code": {
+          "type": "string",
+          "pattern": "^[a-z]+(?:-[a-z]+)*/[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "class": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "configuration"
+            },
+            {
+              "type": "string",
+              "const": "validation"
+            },
+            {
+              "type": "string",
+              "const": "permission"
+            },
+            {
+              "type": "string",
+              "const": "security"
+            },
+            {
+              "type": "string",
+              "const": "provider-transient"
+            },
+            {
+              "type": "string",
+              "const": "provider-terminal"
+            },
+            {
+              "type": "string",
+              "const": "tool-transient"
+            },
+            {
+              "type": "string",
+              "const": "tool-terminal"
+            },
+            {
+              "type": "string",
+              "const": "conflict"
+            },
+            {
+              "type": "string",
+              "const": "budget"
+            },
+            {
+              "type": "string",
+              "const": "timeout"
+            },
+            {
+              "type": "string",
+              "const": "corruption"
+            },
+            {
+              "type": "string",
+              "const": "human-required"
+            }
+          ]
+        },
+        "message": {
+          "type": "string"
+        },
+        "impact": {
+          "type": "string"
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "retryAfterMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "remediation": {
+          "type": "string"
+        },
+        "cause": {
+          "$ref": "#/$defs/ErrorInfo"
+        },
+        "details": {
+          "type": "object",
+          "patternProperties": {
+            "^.*$": {
+              "$ref": "#/$defs/JsonValue"
+            }
+          }
+        }
+      }
+    }
+  }
+}