@claudexor/schema 1.0.0

package/generated/OrchestratePlan.schema.json

@@ -0,0 +1,244 @@
+{
+  "$ref": "#/definitions/OrchestratePlan",
+  "definitions": {
+    "OrchestratePlan": {
+      "type": "object",
+      "properties": {
+        "tool_calls": {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "const": "start_run"
+                  },
+                  "prompt": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Prompt for the sub-run."
+                  },
+                  "mode": {
+                    "type": "string",
+                    "enum": [
+                      "ask",
+                      "plan",
+                      "audit",
+                      "agent",
+                      "orchestrate"
+                    ],
+                    "description": "Mode for the sub-run.",
+                    "default": "agent"
+                  },
+                  "harness": {
+                    "type": "string",
+                    "description": "Harness to run on; omitted = engine routing."
+                  },
+                  "why": {
+                    "type": "string",
+                    "default": "",
+                    "description": "Planner's reason for this step."
+                  }
+                },
+                "required": [
+                  "tool",
+                  "prompt"
+                ],
+                "additionalProperties": false,
+                "description": "Start one isolated sub-run."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "const": "race"
+                  },
+                  "prompt": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Prompt raced across harnesses."
+                  },
+                  "n": {
+                    "type": "integer",
+                    "minimum": 2,
+                    "default": 2,
+                    "description": "Number of race candidates (one per harness)."
+                  },
+                  "why": {
+                    "type": "string",
+                    "default": "",
+                    "description": "Planner's reason for this step."
+                  }
+                },
+                "required": [
+                  "tool",
+                  "prompt"
+                ],
+                "additionalProperties": false,
+                "description": "Race the prompt as a best-of-N run."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "const": "review"
+                  },
+                  "run_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Run to review."
+                  },
+                  "why": {
+                    "type": "string",
+                    "default": "",
+                    "description": "Planner's reason for this step."
+                  }
+                },
+                "required": [
+                  "tool",
+                  "run_id"
+                ],
+                "additionalProperties": false,
+                "description": "Review an existing run."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "const": "status"
+                  },
+                  "run_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Run to inspect."
+                  },
+                  "why": {
+                    "type": "string",
+                    "default": "",
+                    "description": "Planner's reason for this step."
+                  }
+                },
+                "required": [
+                  "tool",
+                  "run_id"
+                ],
+                "additionalProperties": false,
+                "description": "Read the status of an existing run."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "const": "answer_question"
+                  },
+                  "interaction_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Pending interaction to answer."
+                  },
+                  "answers": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "question_id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Id of the question being answered."
+                        },
+                        "selected_labels": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          },
+                          "default": [],
+                          "description": "Labels of the selected options."
+                        },
+                        "free_text": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Free-text answer; null when only options were selected."
+                        }
+                      },
+                      "required": [
+                        "question_id"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "default": [],
+                    "description": "Answers, one per question."
+                  },
+                  "why": {
+                    "type": "string",
+                    "default": "",
+                    "description": "Planner's reason for this step."
+                  }
+                },
+                "required": [
+                  "tool",
+                  "interaction_id"
+                ],
+                "additionalProperties": false,
+                "description": "Answer a pending interactive question of a sub-run."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "const": "apply"
+                  },
+                  "run_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Run whose work product to deliver."
+                  },
+                  "mode": {
+                    "type": "string",
+                    "enum": [
+                      "apply",
+                      "branch",
+                      "commit",
+                      "pr"
+                    ],
+                    "default": "apply",
+                    "description": "Delivery mode: apply to the tree, or as a branch, commit, or PR."
+                  },
+                  "why": {
+                    "type": "string",
+                    "default": "",
+                    "description": "Planner's reason for this step."
+                  }
+                },
+                "required": [
+                  "tool",
+                  "run_id"
+                ],
+                "additionalProperties": false,
+                "description": "Deliver a run's work product to the project (the only live-tree-mutating tool)."
+              }
+            ],
+            "description": "One concrete tool invocation in a planner plan, with per-tool typed args discriminated on `tool`."
+          },
+          "minItems": 1,
+          "description": "Ordered tool invocations of the plan."
+        }
+      },
+      "required": [
+        "tool_calls"
+      ],
+      "additionalProperties": false,
+      "description": "The typed orchestration plan extracted from the planner's report; persisted as final/orchestration.yaml."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/OrchestratePlanProgress.schema.json

@@ -0,0 +1,103 @@
+{
+  "$ref": "#/definitions/OrchestratePlanProgress",
+  "definitions": {
+    "OrchestratePlanProgress": {
+      "type": "object",
+      "properties": {
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "index": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Position of the step in the plan."
+              },
+              "tool": {
+                "type": "string",
+                "enum": [
+                  "start_run",
+                  "race",
+                  "status",
+                  "answer_question",
+                  "apply",
+                  "review"
+                ],
+                "description": "Tool in the orchestrate planner's belt, mapping 1:1 onto engine entry points: start_run, race (best-of-N), status, answer_question, apply, and review."
+              },
+              "risk": {
+                "type": "string",
+                "enum": [
+                  "safe",
+                  "risky"
+                ],
+                "description": "Risk class of the step: safe (no live-tree mutation) or risky."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "pending",
+                  "running",
+                  "done",
+                  "skipped",
+                  "blocked",
+                  "failed"
+                ],
+                "description": "Executor status of one plan step: pending, running, done, skipped, blocked (risky step awaiting a human), or failed."
+              },
+              "run_id": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Sub-run id this step started/targeted, when known."
+              },
+              "detail": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Human-readable step detail."
+              }
+            },
+            "required": [
+              "index",
+              "tool",
+              "risk",
+              "status"
+            ],
+            "additionalProperties": false
+          },
+          "default": [],
+          "description": "Per-step outcomes, in plan order."
+        },
+        "autonomy": {
+          "type": "string",
+          "enum": [
+            "suggest",
+            "auto_safe",
+            "auto_full"
+          ],
+          "description": "How much the orchestrate planner may act without confirmation: suggest (user executes the plan), auto_safe (auto-runs only provably safe steps), auto_full (auto-runs everything)."
+        },
+        "stopped_reason": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Set when the executor stopped early (first risky step under auto_safe, budget, abort)."
+        }
+      },
+      "required": [
+        "autonomy"
+      ],
+      "additionalProperties": false,
+      "description": "Typed executor progress over a plan's tool calls, persisted as final/orchestration_progress.yaml and projected into run detail."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ProjectConfig.schema.json

@@ -0,0 +1,95 @@
+{
+  "$ref": "#/definitions/ProjectConfig",
+  "definitions": {
+    "ProjectConfig": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "number",
+          "const": 1,
+          "default": 1,
+          "description": "Config format version."
+        },
+        "context": {
+          "type": "object",
+          "properties": {
+            "mandatory_files": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Files every context pack must include."
+            },
+            "include": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Globs to include in context building."
+            },
+            "exclude": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Globs to exclude from context building."
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Context-building preferences for the project."
+        },
+        "tests": {
+          "type": "object",
+          "properties": {
+            "commands": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Test commands run as deterministic gates."
+            }
+          },
+          "additionalProperties": false,
+          "default": {
+            "commands": []
+          },
+          "description": "Project-configured deterministic test gates."
+        },
+        "budget": {
+          "type": "object",
+          "properties": {
+            "portfolio": {
+              "type": "string",
+              "enum": [
+                "daily-rich",
+                "balanced",
+                "cheapest",
+                "strongest",
+                "burn",
+                "subscription-first",
+                "api-overflow",
+                "conserve-claude",
+                "conserve-codex"
+              ],
+              "description": "Budget portfolio weighting the harness router's quality/cost/latency and subscription-vs-API preferences (e.g. cheapest minimizes spend, burn maximizes quality, conserve-* deprioritizes one vendor).",
+              "default": "subscription-first"
+            }
+          },
+          "additionalProperties": false,
+          "default": {
+            "portfolio": "subscription-first"
+          },
+          "description": "Project budget preferences."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Project config (.claudexor/config.yaml) — safe, versioned settings only; sensitive settings live in global/user-local/trust configs."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ReviewFinding.schema.json

@@ -0,0 +1,226 @@
+{
+  "$ref": "#/definitions/ReviewFinding",
+  "definitions": {
+    "ReviewFinding": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Finding id."
+        },
+        "severity": {
+          "type": "string",
+          "enum": [
+            "BLOCK",
+            "FIX_FIRST",
+            "WARN",
+            "NIT",
+            "OUT_OF_SCOPE",
+            "INSUFFICIENT_EVIDENCE",
+            "NEEDS_HUMAN"
+          ],
+          "description": "Reviewer-assigned severity of a finding: BLOCK and FIX_FIRST can block convergence when accepted with evidence, WARN/NIT are advisory, OUT_OF_SCOPE and INSUFFICIENT_EVIDENCE are triage verdicts, NEEDS_HUMAN escalates to a human decision."
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "correctness",
+            "regression",
+            "security",
+            "performance",
+            "maintainability",
+            "test_gap",
+            "spec_gap",
+            "deploy",
+            "architecture",
+            "ux"
+          ],
+          "description": "Subject-matter category of a review finding."
+        },
+        "claim": {
+          "type": "string",
+          "description": "The reviewer's claim, stated concretely."
+        },
+        "linked_acceptance_criteria": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Non-empty identifier string."
+          },
+          "default": [],
+          "description": "Ids of acceptance criteria this finding relates to."
+        },
+        "evidence": {
+          "type": "object",
+          "properties": {
+            "files": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Repo-relative file path."
+                  },
+                  "lines": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Line range in the file (e.g. \"10-42\"); null when the whole file is cited."
+                  }
+                },
+                "required": [
+                  "path"
+                ],
+                "additionalProperties": false,
+                "description": "File citation supporting a finding."
+              },
+              "default": [],
+              "description": "File citations."
+            },
+            "diff_hunks": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Diff hunks quoted as evidence."
+            },
+            "commands": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "command": {
+                    "type": "string",
+                    "description": "Command whose output supports the finding."
+                  }
+                },
+                "required": [
+                  "command"
+                ],
+                "additionalProperties": false,
+                "description": "Command citation supporting a finding."
+              },
+              "default": [],
+              "description": "Commands whose output supports the finding."
+            },
+            "logs": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Log file path."
+                  }
+                },
+                "required": [
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              "default": [],
+              "description": "Log files cited as evidence."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Evidence backing a finding; a finding without evidence cannot block.",
+          "default": {}
+        },
+        "proposed_fix": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Reviewer-proposed fix; null when none was offered."
+        },
+        "reviewer": {
+          "type": "object",
+          "properties": {
+            "harness_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Harness that produced the review."
+            },
+            "requested_model": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Model requested for the reviewer route."
+            },
+            "requested_effort": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Reasoning effort requested for the reviewer route."
+            },
+            "observed_model": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Model the harness actually reported using."
+            },
+            "route_proof_status": {
+              "type": "string",
+              "enum": [
+                "verified",
+                "accepted_model_arg",
+                "unverified",
+                "same_model_fallback"
+              ],
+              "description": "How strongly the executed route is proven: verified (observed evidence matches the request), accepted_model_arg (the requested model arg was accepted without stream evidence), unverified, or same_model_fallback (a fallback landed on the same model).",
+              "default": "unverified"
+            }
+          },
+          "required": [
+            "harness_id"
+          ],
+          "additionalProperties": false,
+          "description": "Who reviewed: the harness/model route and its verification status."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "proposed",
+            "accepted",
+            "rebutted",
+            "fixed",
+            "accepted_risk",
+            "duplicate",
+            "stale",
+            "out_of_scope",
+            "insufficient_evidence"
+          ],
+          "description": "Lifecycle status of a finding, from proposed through accepted/rebutted/fixed to terminal triage states (accepted_risk, duplicate, stale, out_of_scope, insufficient_evidence).",
+          "default": "proposed"
+        },
+        "revalidation_note": {
+          "type": "string",
+          "description": "Note recorded when the finding was revalidated against a changed tree."
+        }
+      },
+      "required": [
+        "id",
+        "severity",
+        "category",
+        "claim",
+        "reviewer"
+      ],
+      "additionalProperties": false,
+      "description": "One evidence-backed review finding produced by a reviewer harness."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}