@claudexor/schema 1.0.0 → 2.0.0

package/generated/ControlJournalValidation.schema.json

@@ -0,0 +1,181 @@
+{
+  "$ref": "#/definitions/ControlJournalValidation",
+  "definitions": {
+    "ControlJournalValidation": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "partition": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "generation": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "ready",
+            "recovery_required"
+          ]
+        },
+        "recovery": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "status": {
+                  "type": "string",
+                  "const": "ready"
+                },
+                "discardedTailBytes": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "status",
+                "discardedTailBytes"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "status": {
+                  "type": "string",
+                  "const": "recovery_required"
+                },
+                "location": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "byte"
+                        },
+                        "byteOffset": {
+                          "type": "integer",
+                          "minimum": 0
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "byteOffset"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "cursor"
+                        },
+                        "epoch": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "seq": {
+                          "type": "integer",
+                          "minimum": 0
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "epoch",
+                        "seq"
+                      ],
+                      "additionalProperties": false
+                    }
+                  ]
+                },
+                "reason": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "discardedTailBytes": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "status",
+                "location",
+                "reason",
+                "discardedTailBytes"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "fingerprint": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "observedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "evidenceRefs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        },
+        "projectionStatus": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "valid",
+                  "invalid"
+                ]
+              },
+              "detail": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "name",
+              "status",
+              "detail"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "partition",
+        "generation",
+        "status",
+        "recovery",
+        "fingerprint",
+        "observedAt",
+        "evidenceRefs",
+        "projectionStatus"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlOperationCatalog.schema.json

@@ -0,0 +1,128 @@
+{
+  "$ref": "#/definitions/ControlOperationCatalog",
+  "definitions": {
+    "ControlOperationCatalog": {
+      "type": "object",
+      "properties": {
+        "protocolMajor": {
+          "type": "number",
+          "const": 2
+        },
+        "operations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "method": {
+                "type": "string",
+                "enum": [
+                  "GET",
+                  "POST",
+                  "PUT",
+                  "PATCH",
+                  "DELETE"
+                ]
+              },
+              "path": {
+                "type": "string",
+                "pattern": "^\\/v2\\/"
+              },
+              "requestSchema": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "responseSchema": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "errorSchema": {
+                "type": "string",
+                "const": "ControlProblem"
+              },
+              "mutability": {
+                "type": "string",
+                "enum": [
+                  "read_only",
+                  "mutating"
+                ]
+              },
+              "idempotency": {
+                "type": "string",
+                "enum": [
+                  "none",
+                  "natural",
+                  "key_required"
+                ]
+              },
+              "applicability": {
+                "type": "string",
+                "enum": [
+                  "global",
+                  "project",
+                  "thread",
+                  "run"
+                ]
+              },
+              "responseKind": {
+                "type": "string",
+                "enum": [
+                  "json",
+                  "stream",
+                  "binary"
+                ]
+              },
+              "completion": {
+                "type": "string",
+                "enum": [
+                  "immediate",
+                  "durable_handle",
+                  "terminal_stream"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "method",
+              "path",
+              "requestSchema",
+              "responseSchema",
+              "errorSchema",
+              "mutability",
+              "idempotency",
+              "applicability",
+              "responseKind",
+              "completion"
+            ],
+            "additionalProperties": false,
+            "description": "Machine-readable truth for one implemented v2 operation."
+          }
+        }
+      },
+      "required": [
+        "protocolMajor",
+        "operations"
+      ],
+      "additionalProperties": false,
+      "description": "Implemented v2 operations; absence means unsupported."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlOperationDescriptor.schema.json

@@ -0,0 +1,110 @@
+{
+  "$ref": "#/definitions/ControlOperationDescriptor",
+  "definitions": {
+    "ControlOperationDescriptor": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "method": {
+          "type": "string",
+          "enum": [
+            "GET",
+            "POST",
+            "PUT",
+            "PATCH",
+            "DELETE"
+          ]
+        },
+        "path": {
+          "type": "string",
+          "pattern": "^\\/v2\\/"
+        },
+        "requestSchema": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "responseSchema": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "errorSchema": {
+          "type": "string",
+          "const": "ControlProblem"
+        },
+        "mutability": {
+          "type": "string",
+          "enum": [
+            "read_only",
+            "mutating"
+          ]
+        },
+        "idempotency": {
+          "type": "string",
+          "enum": [
+            "none",
+            "natural",
+            "key_required"
+          ]
+        },
+        "applicability": {
+          "type": "string",
+          "enum": [
+            "global",
+            "project",
+            "thread",
+            "run"
+          ]
+        },
+        "responseKind": {
+          "type": "string",
+          "enum": [
+            "json",
+            "stream",
+            "binary"
+          ]
+        },
+        "completion": {
+          "type": "string",
+          "enum": [
+            "immediate",
+            "durable_handle",
+            "terminal_stream"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "method",
+        "path",
+        "requestSchema",
+        "responseSchema",
+        "errorSchema",
+        "mutability",
+        "idempotency",
+        "applicability",
+        "responseKind",
+        "completion"
+      ],
+      "additionalProperties": false,
+      "description": "Machine-readable truth for one implemented v2 operation."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlProblem.schema.json

@@ -0,0 +1,59 @@
+{
+  "$ref": "#/definitions/ControlProblem",
+  "definitions": {
+    "ControlProblem": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "string",
+          "minLength": 1
+        },
+        "message": {
+          "type": "string"
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "fieldErrors": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "default": {}
+        },
+        "requiredActions": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "evidenceRefs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "context": {
+          "type": "object",
+          "additionalProperties": {},
+          "default": {},
+          "description": "Typed route-specific recovery context; never a duplicate error message."
+        }
+      },
+      "required": [
+        "code",
+        "message",
+        "retryable"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlProject.schema.json

@@ -0,0 +1,42 @@
+{
+  "$ref": "#/definitions/ControlProject",
+  "definitions": {
+    "ControlProject": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 2,
+          "description": "Schema version of the artifact; bumped on breaking ABI changes."
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "createdAt": {
+          "type": "string",
+          "minLength": 1,
+          "description": "ISO-8601 timestamp string."
+        },
+        "updatedAt": {
+          "$ref": "#/definitions/ControlProject/properties/createdAt"
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "id",
+        "root",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Control API projection of a registered project."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlProjectListResponse.schema.json

@@ -0,0 +1,54 @@
+{
+  "$ref": "#/definitions/ControlProjectListResponse",
+  "definitions": {
+    "ControlProjectListResponse": {
+      "type": "object",
+      "properties": {
+        "projects": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "schemaVersion": {
+                "type": "number",
+                "const": 2,
+                "description": "Schema version of the artifact; bumped on breaking ABI changes."
+              },
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Non-empty identifier string."
+              },
+              "root": {
+                "type": "string",
+                "minLength": 1
+              },
+              "createdAt": {
+                "type": "string",
+                "minLength": 1,
+                "description": "ISO-8601 timestamp string."
+              },
+              "updatedAt": {
+                "$ref": "#/definitions/ControlProjectListResponse/properties/projects/items/properties/createdAt"
+              }
+            },
+            "required": [
+              "schemaVersion",
+              "id",
+              "root",
+              "createdAt",
+              "updatedAt"
+            ],
+            "additionalProperties": false,
+            "description": "Control API projection of a registered project."
+          }
+        }
+      },
+      "required": [
+        "projects"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlProjectRegisterRequest.schema.json

@@ -0,0 +1,19 @@
+{
+  "$ref": "#/definitions/ControlProjectRegisterRequest",
+  "definitions": {
+    "ControlProjectRegisterRequest": {
+      "type": "object",
+      "properties": {
+        "root": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "root"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlProjectRelinkRequest.schema.json

@@ -0,0 +1,19 @@
+{
+  "$ref": "#/definitions/ControlProjectRelinkRequest",
+  "definitions": {
+    "ControlProjectRelinkRequest": {
+      "type": "object",
+      "properties": {
+        "root": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "root"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlQueuedRunInfo.schema.json

@@ -20,12 +20,14 @@
             "review_not_run",
             "failed",
             "cancelled",
-            "interrupted",
+            "interrupted_unknown",
+            "cost_unverifiable",
+            "exhausted_overshoot",
             "exhausted",
             "not_converged",
             "stuck_no_progress"
           ],
-          "description": "Control-plane run state: queued/running while live; blocked awaiting a human; then a terminal outcome (succeeded, no_op, ungated, review_not_run, failed, cancelled, interrupted, exhausted, not_converged, stuck_no_progress)."
+          "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
         },
         "error": {
           "type": "string",