@claudexor/schema 1.0.0

package/generated/ConformanceReport.schema.json

@@ -0,0 +1,107 @@
+{
+  "$ref": "#/definitions/ConformanceReport",
+  "definitions": {
+    "ConformanceReport": {
+      "type": "object",
+      "properties": {
+        "harness_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Harness the report is about."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "ok",
+            "degraded",
+            "unavailable"
+          ],
+          "description": "Doctor verdict for a harness: ok (usable), degraded (usable with limitations), or unavailable."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Check id."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "fail",
+                  "skip"
+                ],
+                "description": "Outcome of the check: pass, fail, or skip."
+              },
+              "detail": {
+                "type": "string",
+                "description": "Human-readable detail for the outcome."
+              },
+              "duration_ms": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "How long the check took, in milliseconds."
+              }
+            },
+            "required": [
+              "id",
+              "status"
+            ],
+            "additionalProperties": false,
+            "description": "Result of a conformance probe for one capability check."
+          },
+          "default": [],
+          "description": "Individual probe results."
+        },
+        "enabled_intents": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "plan",
+              "spec",
+              "implement",
+              "create_from_scratch",
+              "repair",
+              "review",
+              "verify",
+              "synthesize",
+              "explain",
+              "audit",
+              "orchestrate"
+            ],
+            "description": "Canonical intent a harness can be assigned for a session (roles are intents, never fixed classes)."
+          },
+          "default": [],
+          "description": "Intents the gateway will route to this harness."
+        },
+        "disabled_intents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ConformanceReport/properties/enabled_intents/items"
+          },
+          "default": [],
+          "description": "Intents the doctor disabled."
+        },
+        "reasons": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Human-readable reasons for degraded/unavailable status or disabled intents."
+        }
+      },
+      "required": [
+        "harness_id",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "Doctor/conformance report for one harness: status, probe results, and the intents enabled or disabled by it."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ContextPack.schema.json

@@ -0,0 +1,186 @@
+{
+  "$ref": "#/definitions/ContextPack",
+  "definitions": {
+    "ContextPack": {
+      "type": "object",
+      "properties": {
+        "task_contract_hash": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Hash of the TaskContract this pack was built from."
+        },
+        "hash": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Content hash of the pack itself."
+        },
+        "files": {
+          "type": "object",
+          "properties": {
+            "mandatory": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Repo-relative path of the included file."
+                  },
+                  "hash": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Content hash of the file as included."
+                  }
+                },
+                "required": [
+                  "path",
+                  "hash"
+                ],
+                "additionalProperties": false,
+                "description": "Reference to a file included in the context pack."
+              },
+              "default": [],
+              "description": "Files every harness must receive."
+            },
+            "included": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/ContextPack/properties/files/properties/mandatory/items"
+              },
+              "default": [],
+              "description": "Additional files included in the pack."
+            },
+            "omitted": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Repo-relative path that was omitted."
+                  },
+                  "reason": {
+                    "type": "string",
+                    "description": "Why the path was omitted."
+                  },
+                  "replacement": {
+                    "type": "string",
+                    "enum": [
+                      "summary",
+                      "map",
+                      "index",
+                      "none"
+                    ],
+                    "default": "none",
+                    "description": "What stands in for the omitted content: a summary, a map, an index, or nothing."
+                  },
+                  "hash": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Content hash of the omitted file, when known."
+                  }
+                },
+                "required": [
+                  "path",
+                  "reason"
+                ],
+                "additionalProperties": false,
+                "description": "Explicit record of a file omitted from the context; nothing is silently cut."
+              },
+              "default": [],
+              "description": "Files explicitly omitted, with reasons."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Files included in or explicitly omitted from the pack."
+        },
+        "atlas": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Repo-relative path."
+              },
+              "disposition": {
+                "type": "string",
+                "enum": [
+                  "full",
+                  "included",
+                  "manifest_only",
+                  "excluded",
+                  "sensitive",
+                  "binary",
+                  "vendored",
+                  "oversized",
+                  "read_error",
+                  "omitted"
+                ],
+                "description": "How a tracked path was accounted for in the Scope Atlas (full/included content, manifest_only, or excluded/sensitive/binary/vendored/oversized/read_error/omitted); no path is ever silently dropped."
+              },
+              "hash": {
+                "$ref": "#/definitions/ContextPack/properties/files/properties/omitted/items/properties/hash",
+                "description": "Content hash of the path, when read."
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Size of the path in bytes, when known."
+              },
+              "reason": {
+                "type": "string",
+                "description": "Why the path got this disposition."
+              }
+            },
+            "required": [
+              "path",
+              "disposition"
+            ],
+            "additionalProperties": false,
+            "description": "Accounting entry for one tracked path in the Scope Atlas."
+          },
+          "default": [],
+          "description": "Scope Atlas: per-path accounting of the whole tracked tree."
+        },
+        "instructions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Instruction strings passed alongside the files."
+        },
+        "token_budget": {
+          "type": "object",
+          "properties": {
+            "limit": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "description": "Token budget limit for the pack."
+            },
+            "estimated_used": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Estimated tokens consumed by the pack."
+            }
+          },
+          "required": [
+            "limit",
+            "estimated_used"
+          ],
+          "additionalProperties": false,
+          "description": "Token budget accounting for the pack, when computed."
+        }
+      },
+      "required": [
+        "task_contract_hash",
+        "hash",
+        "files"
+      ],
+      "additionalProperties": false,
+      "description": "The deterministic, hashable context bundle every harness receives, built from the TaskContract plus repo state; omissions are explicit."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlApplyCheckRequest.schema.json

@@ -0,0 +1,54 @@
+{
+  "$ref": "#/definitions/ControlApplyCheckRequest",
+  "definitions": {
+    "ControlApplyCheckRequest": {
+      "type": "object",
+      "properties": {
+        "target": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "original_project"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false,
+              "description": "Apply to the project the run originally came from."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "project"
+                },
+                "root": {
+                  "type": "string",
+                  "description": "Absolute path of the target project root."
+                }
+              },
+              "required": [
+                "kind",
+                "root"
+              ],
+              "additionalProperties": false,
+              "description": "Apply to an explicitly named project root."
+            }
+          ],
+          "description": "Where a work product is delivered: the original project or an explicit project root.",
+          "default": {
+            "kind": "original_project"
+          }
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body for a dry-run apply check."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlApplyRequest.schema.json

@@ -0,0 +1,74 @@
+{
+  "$ref": "#/definitions/ControlApplyRequest",
+  "definitions": {
+    "ControlApplyRequest": {
+      "type": "object",
+      "properties": {
+        "target": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "original_project"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false,
+              "description": "Apply to the project the run originally came from."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "project"
+                },
+                "root": {
+                  "type": "string",
+                  "description": "Absolute path of the target project root."
+                }
+              },
+              "required": [
+                "kind",
+                "root"
+              ],
+              "additionalProperties": false,
+              "description": "Apply to an explicitly named project root."
+            }
+          ],
+          "description": "Where a work product is delivered: the original project or an explicit project root.",
+          "default": {
+            "kind": "original_project"
+          }
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "artifact_only",
+            "apply",
+            "branch",
+            "commit",
+            "pr"
+          ],
+          "default": "apply",
+          "description": "Delivery mode: artifact_only (export only), apply to the tree, or as a branch, commit, or PR."
+        },
+        "branch": {
+          "type": "string",
+          "description": "Branch name for branch/pr modes."
+        },
+        "message": {
+          "type": "string",
+          "description": "Commit message for commit/pr modes."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body applying a run's work product to a project."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}