@claudexor/schema 1.0.0

package/generated/ControlSetupJob.schema.json

@@ -0,0 +1,148 @@
+{
+  "$ref": "#/definitions/ControlSetupJob",
+  "definitions": {
+    "ControlSetupJob": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Setup job id."
+        },
+        "harness": {
+          "type": "string",
+          "enum": [
+            "codex",
+            "claude",
+            "cursor",
+            "opencode",
+            "raw"
+          ],
+          "description": "Harness ids that have a managed setup flow."
+        },
+        "action": {
+          "type": "string",
+          "enum": [
+            "install",
+            "login",
+            "doctor",
+            "store_key"
+          ],
+          "description": "Setup action to perform: install the vendor CLI, log in, run the doctor, or store an API key."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "waiting_for_input",
+            "succeeded",
+            "failed",
+            "cancelled",
+            "not_supported"
+          ],
+          "description": "Lifecycle state of a setup job, including waiting_for_input (needs user confirmation/input) and not_supported."
+        },
+        "command": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Shell command the job runs, when applicable."
+        },
+        "guideUrl": {
+          "anyOf": [
+            {
+              "type": "string",
+              "format": "uri"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Vendor guide URL for manual steps, when applicable."
+        },
+        "logPath": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "On-disk log path for the job's output."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable status message."
+        },
+        "riskFlags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Risk flags for the action (e.g. network_download, shell_pipe), surfaced before confirmation."
+        },
+        "requiresConfirmation": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether the job waits for explicit user confirmation before running."
+        },
+        "createdAt": {
+          "type": "string",
+          "description": "When the job was created."
+        },
+        "startedAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When the job started running."
+        },
+        "firstOutputAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When the job produced its first output."
+        },
+        "lastOutputAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When the job last produced output."
+        },
+        "finishedAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When the job finished."
+        },
+        "retryCount": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "How many times the job was retried."
+        }
+      },
+      "required": [
+        "jobId",
+        "harness",
+        "action",
+        "state",
+        "message",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "One managed harness setup job (install/login/doctor/store_key) with its lifecycle timestamps."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSetupJobConfirmRequest.schema.json

@@ -0,0 +1,18 @@
+{
+  "$ref": "#/definitions/ControlSetupJobConfirmRequest",
+  "definitions": {
+    "ControlSetupJobConfirmRequest": {
+      "type": "object",
+      "properties": {
+        "confirmed": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether the user confirmed the pending action."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body confirming a setup job that waits for user confirmation."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSetupJobCreateRequest.schema.json

@@ -0,0 +1,38 @@
+{
+  "$ref": "#/definitions/ControlSetupJobCreateRequest",
+  "definitions": {
+    "ControlSetupJobCreateRequest": {
+      "type": "object",
+      "properties": {
+        "harness": {
+          "type": "string",
+          "enum": [
+            "codex",
+            "claude",
+            "cursor",
+            "opencode",
+            "raw"
+          ],
+          "description": "Harness ids that have a managed setup flow."
+        },
+        "action": {
+          "type": "string",
+          "enum": [
+            "install",
+            "login",
+            "doctor",
+            "store_key"
+          ],
+          "description": "Setup action to perform: install the vendor CLI, log in, run the doctor, or store an API key."
+        }
+      },
+      "required": [
+        "harness",
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "Request body to create a harness setup job."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSetupJobEvent.schema.json

@@ -0,0 +1,58 @@
+{
+  "$ref": "#/definitions/ControlSetupJobEvent",
+  "definitions": {
+    "ControlSetupJobEvent": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Setup job the event belongs to."
+        },
+        "seq": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Monotonic event sequence within the job."
+        },
+        "time": {
+          "type": "string",
+          "description": "Event timestamp."
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "status"
+          ],
+          "description": "Event kind; only status is ever produced."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "waiting_for_input",
+            "succeeded",
+            "failed",
+            "cancelled",
+            "not_supported"
+          ],
+          "description": "Lifecycle state of a setup job, including waiting_for_input (needs user confirmation/input) and not_supported."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable status message."
+        }
+      },
+      "required": [
+        "jobId",
+        "seq",
+        "time",
+        "kind",
+        "message"
+      ],
+      "additionalProperties": false,
+      "description": "Status event on a setup job's event stream."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSetupJobListResponse.schema.json

@@ -0,0 +1,162 @@
+{
+  "$ref": "#/definitions/ControlSetupJobListResponse",
+  "definitions": {
+    "ControlSetupJobListResponse": {
+      "type": "object",
+      "properties": {
+        "jobs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "jobId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Setup job id."
+              },
+              "harness": {
+                "type": "string",
+                "enum": [
+                  "codex",
+                  "claude",
+                  "cursor",
+                  "opencode",
+                  "raw"
+                ],
+                "description": "Harness ids that have a managed setup flow."
+              },
+              "action": {
+                "type": "string",
+                "enum": [
+                  "install",
+                  "login",
+                  "doctor",
+                  "store_key"
+                ],
+                "description": "Setup action to perform: install the vendor CLI, log in, run the doctor, or store an API key."
+              },
+              "state": {
+                "type": "string",
+                "enum": [
+                  "queued",
+                  "running",
+                  "waiting_for_input",
+                  "succeeded",
+                  "failed",
+                  "cancelled",
+                  "not_supported"
+                ],
+                "description": "Lifecycle state of a setup job, including waiting_for_input (needs user confirmation/input) and not_supported."
+              },
+              "command": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Shell command the job runs, when applicable."
+              },
+              "guideUrl": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "format": "uri"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Vendor guide URL for manual steps, when applicable."
+              },
+              "logPath": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "On-disk log path for the job's output."
+              },
+              "message": {
+                "type": "string",
+                "description": "Human-readable status message."
+              },
+              "riskFlags": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [],
+                "description": "Risk flags for the action (e.g. network_download, shell_pipe), surfaced before confirmation."
+              },
+              "requiresConfirmation": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether the job waits for explicit user confirmation before running."
+              },
+              "createdAt": {
+                "type": "string",
+                "description": "When the job was created."
+              },
+              "startedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the job started running."
+              },
+              "firstOutputAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the job produced its first output."
+              },
+              "lastOutputAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the job last produced output."
+              },
+              "finishedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the job finished."
+              },
+              "retryCount": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "How many times the job was retried."
+              }
+            },
+            "required": [
+              "jobId",
+              "harness",
+              "action",
+              "state",
+              "message",
+              "createdAt"
+            ],
+            "additionalProperties": false,
+            "description": "One managed harness setup job (install/login/doctor/store_key) with its lifecycle timestamps."
+          },
+          "description": "All known setup jobs."
+        }
+      },
+      "required": [
+        "jobs"
+      ],
+      "additionalProperties": false,
+      "description": "Response for listing setup jobs."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSpecFreezeRequest.schema.json

@@ -0,0 +1,83 @@
+{
+  "$ref": "#/definitions/ControlSpecFreezeRequest",
+  "definitions": {
+    "ControlSpecFreezeRequest": {
+      "type": "object",
+      "properties": {
+        "prompt": {
+          "type": "string",
+          "description": "The user's request the spec captures."
+        },
+        "scope": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "project"
+            },
+            "root": {
+              "type": "string",
+              "description": "Absolute path of the project root."
+            },
+            "context": {
+              "type": "string",
+              "enum": [
+                "auto"
+              ],
+              "description": "Project context depth; auto is the only mode.",
+              "default": "auto"
+            }
+          },
+          "required": [
+            "kind",
+            "root"
+          ],
+          "additionalProperties": false,
+          "description": "Project the spec is about."
+        },
+        "planDir": {
+          "type": "string",
+          "description": "Directory to write the frozen spec artifacts into."
+        },
+        "plan": {
+          "type": "string",
+          "description": "Plan text to fold into the spec."
+        },
+        "answers": {
+          "type": "array",
+          "items": {},
+          "description": "Interview answers for the current tier."
+        },
+        "priorDecisions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "question": {
+                "type": "string",
+                "description": "Question asked in a prior tier."
+              },
+              "answer": {
+                "type": "string",
+                "description": "The user's answer."
+              }
+            },
+            "required": [
+              "question",
+              "answer"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Accumulated prior-tier interview decisions, folded into the frozen SpecPack's decided tradeoffs."
+        }
+      },
+      "required": [
+        "prompt",
+        "scope"
+      ],
+      "additionalProperties": false,
+      "description": "Request body to freeze a SpecPack from the interview."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSpecQuestionsRequest.schema.json

@@ -0,0 +1,80 @@
+{
+  "$ref": "#/definitions/ControlSpecQuestionsRequest",
+  "definitions": {
+    "ControlSpecQuestionsRequest": {
+      "type": "object",
+      "properties": {
+        "prompt": {
+          "type": "string",
+          "description": "The user's request the interview is clarifying."
+        },
+        "scope": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "project"
+            },
+            "root": {
+              "type": "string",
+              "description": "Absolute path of the project root."
+            },
+            "context": {
+              "type": "string",
+              "enum": [
+                "auto"
+              ],
+              "description": "Project context depth; auto is the only mode.",
+              "default": "auto"
+            }
+          },
+          "required": [
+            "kind",
+            "root"
+          ],
+          "additionalProperties": false,
+          "description": "Project the spec is about."
+        },
+        "harnesses": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "\\S",
+            "description": "User-supplied string that must contain visible content, not just whitespace."
+          },
+          "description": "Harnesses eligible to generate the questions."
+        },
+        "priorDecisions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "question": {
+                "type": "string",
+                "description": "Question asked in a prior tier."
+              },
+              "answer": {
+                "type": "string",
+                "description": "The user's answer."
+              }
+            },
+            "required": [
+              "question",
+              "answer"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Already-answered decisions from prior tiers, carried so each round goes deeper instead of re-asking."
+        }
+      },
+      "required": [
+        "prompt",
+        "scope"
+      ],
+      "additionalProperties": false,
+      "description": "Request body to generate the next tier of spec interview questions."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}