@claudexor/schema 1.0.0 → 2.0.0

package/generated/ControlSpecSessionListResponse.schema.json

@@ -0,0 +1,261 @@
+{
+  "$ref": "#/definitions/ControlSpecSessionListResponse",
+  "definitions": {
+    "ControlSpecSessionListResponse": {
+      "type": "object",
+      "properties": {
+        "sessions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "User-supplied string that must contain visible content, not just whitespace."
+              },
+              "prompt": {
+                "type": "string"
+              },
+              "scope": {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "const": "project"
+                  },
+                  "root": {
+                    "type": "string"
+                  },
+                  "context": {
+                    "type": "string",
+                    "enum": [
+                      "auto"
+                    ],
+                    "description": "Project context depth; auto is the only mode."
+                  }
+                },
+                "required": [
+                  "kind",
+                  "root",
+                  "context"
+                ],
+                "additionalProperties": false
+              },
+              "state": {
+                "type": "string",
+                "enum": [
+                  "grounding",
+                  "questions",
+                  "answered",
+                  "freezing",
+                  "frozen",
+                  "cancelled",
+                  "failed",
+                  "interrupted_unknown"
+                ]
+              },
+              "planRunId": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "questions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Question id."
+                    },
+                    "tier": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0,
+                      "description": "Hierarchical depth of the question (0 = foundational)."
+                    },
+                    "prompt": {
+                      "type": "string",
+                      "description": "The question text shown to the user."
+                    },
+                    "kind": {
+                      "type": "string",
+                      "enum": [
+                        "single",
+                        "multi",
+                        "text"
+                      ],
+                      "description": "Answer shape of an interview question: single choice, multiple choice, or free text.",
+                      "default": "single"
+                    },
+                    "options": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Option id."
+                          },
+                          "label": {
+                            "type": "string",
+                            "description": "Human-readable option label."
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "label"
+                        ],
+                        "additionalProperties": false,
+                        "description": "One selectable option of an interview question."
+                      },
+                      "default": [],
+                      "description": "Selectable options; empty for pure free-text questions."
+                    },
+                    "allow_text": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Whether free-text is accepted in addition to or instead of options."
+                    },
+                    "rationale": {
+                      "type": "string",
+                      "description": "Why this question matters for the spec."
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "prompt"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One quiz card of the spec interview."
+                }
+              },
+              "answers": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "question_id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Id of the question being answered."
+                    },
+                    "option_ids": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Non-empty identifier string."
+                      },
+                      "default": [],
+                      "description": "Ids of the selected options."
+                    },
+                    "text": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Free-text answer; null when only options were selected."
+                    }
+                  },
+                  "required": [
+                    "question_id"
+                  ],
+                  "additionalProperties": false,
+                  "description": "The user's answer to one interview question."
+                }
+              },
+              "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
+                }
+              },
+              "specId": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "specDir": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "specPath": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "specHash": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "error": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "createdAt": {
+                "type": "string"
+              },
+              "updatedAt": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "sessionId",
+              "prompt",
+              "scope",
+              "state",
+              "planRunId",
+              "questions",
+              "answers",
+              "priorDecisions",
+              "specId",
+              "specDir",
+              "specPath",
+              "specHash",
+              "error",
+              "createdAt",
+              "updatedAt"
+            ],
+            "additionalProperties": false,
+            "description": "Durable public projection of a spec interview session."
+          }
+        }
+      },
+      "required": [
+        "sessions"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThread.schema.json

@@ -75,11 +75,29 @@
           "type": "string",
           "enum": [
             "active",
-            "closed"
+            "closed",
+            "trashed",
+            "purged"
           ],
-          "description": "Thread lifecycle state: active or explicitly closed (archived). Blocked is a live projection, not a thread state.",
+          "description": "Thread lifecycle state: active, closed, trashed for recovery, or terminally purged.",
           "default": "active"
         },
+        "trashedAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When the thread entered trash."
+        },
+        "purgeAfter": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When trash retention expires."
+        },
         "runIds": {
           "type": "array",
           "items": {

package/generated/ControlThreadApplyResponse.schema.json

@@ -33,6 +33,145 @@
           ],
           "default": null,
           "description": "Human-readable detail."
+        },
+        "delivery": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "artifact_only",
+                    "apply",
+                    "branch",
+                    "commit",
+                    "pr"
+                  ]
+                },
+                "applied": {
+                  "type": "boolean"
+                },
+                "branch": {
+                  "type": "string"
+                },
+                "commit": {
+                  "type": "string"
+                },
+                "prUrl": {
+                  "type": "string"
+                },
+                "detail": {
+                  "type": "string"
+                },
+                "treeMutated": {
+                  "type": "boolean"
+                },
+                "refused": {
+                  "type": "boolean"
+                },
+                "finalVerify": {
+                  "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": "Fresh verifier evidence for this delivery attempt."
+                },
+                "targetPreimageSha": {
+                  "type": "string",
+                  "description": "Target snapshot verified immediately before delivery."
+                }
+              },
+              "required": [
+                "mode",
+                "applied",
+                "finalVerify",
+                "targetPreimageSha"
+              ],
+              "additionalProperties": false,
+              "description": "Immutable receipt for a freshly verified delivery attempt."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Fresh verifier, target preimage, and mutation receipt; null when no delivery ran.",
+          "default": null
         }
       },
       "required": [

package/generated/ControlThreadDetail.schema.json

@@ -78,11 +78,29 @@
               "type": "string",
               "enum": [
                 "active",
-                "closed"
+                "closed",
+                "trashed",
+                "purged"
               ],
-              "description": "Thread lifecycle state: active or explicitly closed (archived). Blocked is a live projection, not a thread state.",
+              "description": "Thread lifecycle state: active, closed, trashed for recovery, or terminally purged.",
               "default": "active"
             },
+            "trashedAt": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "When the thread entered trash."
+            },
+            "purgeAfter": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "When trash retention expires."
+            },
             "runIds": {
               "type": "array",
               "items": {
@@ -268,12 +286,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."
                       },
                       "mode": {
                         "$ref": "#/definitions/ControlThreadDetail/properties/thread/properties/mode",
@@ -392,6 +412,14 @@
                             "default": null,
                             "description": "Tree SHA right after this turn's mutation; revert refuses if the working tree has diverged from this since."
                           },
+                          "revertAnchorId": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "default": null,
+                            "description": "GC-independent revert anchor."
+                          },
                           "revertable": {
                             "type": "boolean",
                             "default": false,

package/generated/ControlThreadListResponse.schema.json

@@ -80,11 +80,29 @@
                 "type": "string",
                 "enum": [
                   "active",
-                  "closed"
+                  "closed",
+                  "trashed",
+                  "purged"
                 ],
-                "description": "Thread lifecycle state: active or explicitly closed (archived). Blocked is a live projection, not a thread state.",
+                "description": "Thread lifecycle state: active, closed, trashed for recovery, or terminally purged.",
                 "default": "active"
               },
+              "trashedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When the thread entered trash."
+              },
+              "purgeAfter": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "When trash retention expires."
+              },
               "runIds": {
                 "type": "array",
                 "items": {