@claudexor/schema 1.0.0

package/generated/ControlThreadUpdateRequest.schema.json

@@ -0,0 +1,46 @@
+{
+  "$ref": "#/definitions/ControlThreadUpdateRequest",
+  "definitions": {
+    "ControlThreadUpdateRequest": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "New thread title."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "active",
+            "closed"
+          ],
+          "description": "New thread state (active/closed)."
+        },
+        "primaryHarness": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "\\S",
+              "description": "User-supplied string that must contain visible content, not just whitespace."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New sticky primary harness; null clears back to engine routing."
+        },
+        "eligibleHarnesses": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlThreadUpdateRequest/properties/primaryHarness/anyOf/0"
+          },
+          "description": "New sticky eligible harness pool."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body for PATCH /threads/:id: rename, archive, or switch sticky routing."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlTrustListResponse.schema.json

@@ -0,0 +1,59 @@
+{
+  "$ref": "#/definitions/ControlTrustListResponse",
+  "definitions": {
+    "ControlTrustListResponse": {
+      "type": "object",
+      "properties": {
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "repoRoot": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Repo root recorded in the trust file; null for legacy files written before provenance stamping."
+              },
+              "path": {
+                "type": "string",
+                "description": "The user-level trust file backing this state (path disclosure, no content)."
+              },
+              "allowFullAccess": {
+                "type": "boolean",
+                "description": "Whether unsandboxed full access is allowed for the repo."
+              },
+              "accessDefault": {
+                "type": "string",
+                "enum": [
+                  "readonly",
+                  "workspace_write",
+                  "full",
+                  "external_sandbox_full",
+                  "inherit_native"
+                ],
+                "description": "Default access profile for runs in the repo."
+              }
+            },
+            "required": [
+              "repoRoot",
+              "path",
+              "allowFullAccess",
+              "accessDefault"
+            ],
+            "additionalProperties": false,
+            "description": "Trust state of one repo from its user-level trust file."
+          },
+          "description": "Trust states for all known repos."
+        }
+      },
+      "required": [
+        "entries"
+      ],
+      "additionalProperties": false,
+      "description": "Response for listing per-repo trust states."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlTrustState.schema.json

@@ -0,0 +1,45 @@
+{
+  "$ref": "#/definitions/ControlTrustState",
+  "definitions": {
+    "ControlTrustState": {
+      "type": "object",
+      "properties": {
+        "repoRoot": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Repo root recorded in the trust file; null for legacy files written before provenance stamping."
+        },
+        "path": {
+          "type": "string",
+          "description": "The user-level trust file backing this state (path disclosure, no content)."
+        },
+        "allowFullAccess": {
+          "type": "boolean",
+          "description": "Whether unsandboxed full access is allowed for the repo."
+        },
+        "accessDefault": {
+          "type": "string",
+          "enum": [
+            "readonly",
+            "workspace_write",
+            "full",
+            "external_sandbox_full",
+            "inherit_native"
+          ],
+          "description": "Default access profile for runs in the repo."
+        }
+      },
+      "required": [
+        "repoRoot",
+        "path",
+        "allowFullAccess",
+        "accessDefault"
+      ],
+      "additionalProperties": false,
+      "description": "Trust state of one repo from its user-level trust file."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlTrustUpdateRequest.schema.json

@@ -0,0 +1,26 @@
+{
+  "$ref": "#/definitions/ControlTrustUpdateRequest",
+  "definitions": {
+    "ControlTrustUpdateRequest": {
+      "type": "object",
+      "properties": {
+        "repoRoot": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Absolute repo root the trust change applies to."
+        },
+        "allowFullAccess": {
+          "type": "boolean",
+          "description": "Grant (true) or revoke (false) unsandboxed full access for the repo."
+        }
+      },
+      "required": [
+        "repoRoot",
+        "allowFullAccess"
+      ],
+      "additionalProperties": false,
+      "description": "Narrow trust update — the only trust field the control API exposes: grant or revoke unsandboxed full access for one repo in the user-level trust file."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/DecisionRecord.schema.json

@@ -0,0 +1,232 @@
+{
+  "$ref": "#/definitions/DecisionRecord",
+  "definitions": {
+    "DecisionRecord": {
+      "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."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/GateResult.schema.json

@@ -0,0 +1,81 @@
+{
+  "$ref": "#/definitions/GateResult",
+  "definitions": {
+    "GateResult": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Gate id."
+        },
+        "command": {
+          "type": "string",
+          "description": "Command the gate ran."
+        },
+        "exit_code": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Process exit code; null when the gate never ran to completion."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "passed",
+            "failed",
+            "skipped",
+            "timed_out"
+          ],
+          "description": "Outcome of a deterministic gate: passed, failed, skipped, or timed_out."
+        },
+        "duration_ms": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "How long the gate took, in milliseconds."
+        },
+        "required": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether the gate must pass (vs advisory)."
+        },
+        "stdout_tail": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Tail of the gate's stdout, for diagnostics."
+        },
+        "stderr_tail": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Tail of the gate's stderr, for diagnostics."
+        },
+        "output_truncated": {
+          "type": "boolean",
+          "default": false,
+          "description": "True when the stored output tails were truncated."
+        }
+      },
+      "required": [
+        "id",
+        "command",
+        "exit_code",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "Result of a deterministic gate (build/test/lint/etc), decided by exit code, not text."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}