@haystackeditor/cli 0.25.1 → 0.27.0

package/schemas/verify-raw.v1.json

@@ -0,0 +1,1132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.haystackeditor.com/cli/schemas/verify-raw.v1.json",
+  "title": "Haystack verify --raw: the service's whole crawl record (CRAWL-V1)",
+  "description": "Machine-readable output of `haystack verify --raw`, for scripts. the caller's crawl of the exact captured checkout (its code and its change title), as GET /api/agent/cloud-verifier/crawls?repository=&workCommit= or, for a crawl the command just submitted, GET /api/agent/cloud-verifier/crawls/:runId?repository= returns it, or null when no crawl of the capture could be started. The crawl shapes mirror infra/lambda/haystack-design-verifier-shared/crawl_contracts.ts (with amendments 1, 8, 9, 10 and 11); that file wins where they differ. Crawl amendment 11 (schema 1.0.1): when the capture's base is not onboarded yet, `onboarding` is the base's OnboardingStatusV1 (onboarding_contracts.ts, APP-ONBOARDING-V1) and `crawl` is null until the app is ready; it is null when onboarding was not involved.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "crawl"
+  ],
+  "properties": {
+    "onboarding": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "$ref": "#/$defs/onboardingStatus"
+        }
+      ]
+    },
+    "schema_version": {
+      "const": "1.0.0"
+    },
+    "change": {
+      "description": "Schema 1.0.2: what this verify checked: the capture's base commit (where HEAD meets origin's default branch), its work commit (committed and uncommitted changes), and the files that differ between them.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "baseCommit",
+        "workCommit",
+        "files"
+      ],
+      "properties": {
+        "baseCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "workCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "crawl": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "$ref": "#/$defs/crawlView"
+        }
+      ]
+    }
+  },
+  "$defs": {
+    "onboardingBlock": {
+      "type": "object",
+      "required": [
+        "kind",
+        "stage",
+        "reason",
+        "evidence",
+        "ask"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "not-enabled",
+            "no-web-app",
+            "unsupported",
+            "question",
+            "outside-credential",
+            "outside-dependency",
+            "evidence-too-large",
+            "budget",
+            "proof-failed"
+          ]
+        },
+        "stage": {
+          "enum": [
+            "admission",
+            "inventory",
+            "plan",
+            "runtime",
+            "boot",
+            "data",
+            "accounts",
+            "workflow",
+            "publish",
+            "cleanup"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "evidence": {
+          "$ref": "#/$defs/strings"
+        },
+        "names": {
+          "$ref": "#/$defs/strings"
+        },
+        "ask": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "message"
+              ],
+              "properties": {
+                "message": {
+                  "type": "string"
+                },
+                "command": {
+                  "type": "string"
+                },
+                "question": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "choices"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "choices": {
+                      "$ref": "#/$defs/strings"
+                    }
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "onboardingStatus": {
+      "type": "object",
+      "required": [
+        "version",
+        "repository",
+        "baseCommit",
+        "state",
+        "onboardRunId",
+        "recordDigest",
+        "checkpoint",
+        "block",
+        "dataAbsences",
+        "versionChoices"
+      ],
+      "properties": {
+        "version": {
+          "const": "app-onboarding-v1"
+        },
+        "repository": {
+          "type": "string"
+        },
+        "baseCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "state": {
+          "enum": [
+            "ready",
+            "onboarding",
+            "blocked",
+            "incomplete",
+            "cancelled",
+            "not-started"
+          ]
+        },
+        "onboardRunId": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string",
+              "pattern": "^ob_[0-9a-f]{48}$"
+            }
+          ]
+        },
+        "recordDigest": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            }
+          ]
+        },
+        "checkpoint": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "status",
+                "stage",
+                "execution",
+                "owned"
+              ],
+              "properties": {
+                "status": {
+                  "enum": [
+                    "queued",
+                    "running",
+                    "cleanup-pending",
+                    "published",
+                    "reused",
+                    "blocked",
+                    "incomplete",
+                    "cancelled"
+                  ]
+                },
+                "stage": {
+                  "enum": [
+                    "inventory",
+                    "plan",
+                    "runtime",
+                    "boot",
+                    "data",
+                    "accounts",
+                    "workflow",
+                    "publish",
+                    "cleanup"
+                  ]
+                },
+                "owned": {
+                  "$ref": "#/$defs/strings"
+                },
+                "execution": {
+                  "type": "object",
+                  "required": [
+                    "stages"
+                  ],
+                  "properties": {
+                    "stages": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "stage",
+                          "status"
+                        ],
+                        "properties": {
+                          "stage": {
+                            "enum": [
+                              "inventory",
+                              "plan",
+                              "runtime",
+                              "boot",
+                              "data",
+                              "accounts",
+                              "workflow",
+                              "publish",
+                              "cleanup"
+                            ]
+                          },
+                          "status": {
+                            "enum": [
+                              "pending",
+                              "running",
+                              "ok",
+                              "reused",
+                              "failed",
+                              "blocked"
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          ]
+        },
+        "block": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/onboardingBlock"
+            }
+          ]
+        },
+        "dataAbsences": {
+          "$ref": "#/$defs/strings"
+        },
+        "versionChoices": {
+          "$ref": "#/$defs/strings"
+        }
+      }
+    },
+    "runId": {
+      "type": "string",
+      "pattern": "^cv_[0-9a-f]{48}$"
+    },
+    "commit": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{40}$"
+    },
+    "count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "timestamp": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "format": "date-time"
+    },
+    "status": {
+      "enum": [
+        "queued",
+        "preparing",
+        "crawling",
+        "draining",
+        "completed",
+        "prepared",
+        "incomplete",
+        "cancelled"
+      ]
+    },
+    "stage": {
+      "enum": [
+        "reconcile",
+        "source",
+        "worlds",
+        "blast",
+        "knobs",
+        "prepare",
+        "crawl",
+        "publish",
+        "cleanup"
+      ]
+    },
+    "spotStage": {
+      "enum": [
+        "resolved",
+        "loaded",
+        "exposed",
+        "activated",
+        "pressed",
+        "observed",
+        "confirmed",
+        "judged"
+      ]
+    },
+    "reuseValue": {
+      "enum": [
+        "hit",
+        "miss",
+        null
+      ]
+    },
+    "reuse": {
+      "type": "object",
+      "required": [
+        "baseWorld",
+        "headWorld",
+        "prepare",
+        "routes"
+      ],
+      "properties": {
+        "baseWorld": {
+          "$ref": "#/$defs/reuseValue"
+        },
+        "headWorld": {
+          "$ref": "#/$defs/reuseValue"
+        },
+        "prepare": {
+          "$ref": "#/$defs/reuseValue"
+        },
+        "routes": {
+          "$ref": "#/$defs/reuseValue"
+        }
+      }
+    },
+    "error": {
+      "type": "object",
+      "required": [
+        "code",
+        "stage",
+        "message"
+      ],
+      "properties": {
+        "code": {
+          "enum": [
+            "source-mismatch",
+            "blast-unavailable",
+            "world-build-failed",
+            "prepare-failed",
+            "crawl-failed",
+            "no-capacity",
+            "stalled",
+            "lease-lost",
+            "cancelled"
+          ]
+        },
+        "stage": {
+          "$ref": "#/$defs/stage"
+        },
+        "message": {
+          "type": "string"
+        }
+      }
+    },
+    "strings": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "finding": {
+      "type": "object",
+      "required": [
+        "id",
+        "verdict",
+        "why",
+        "start",
+        "steps",
+        "observed",
+        "codeThatRan",
+        "confirmedAtSeconds",
+        "images"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "verdict": {
+          "enum": [
+            "bug",
+            "not-a-bug",
+            "cant-tell",
+            "being-judged"
+          ]
+        },
+        "why": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "start": {
+          "type": "string",
+          "description": "Where the replay starts."
+        },
+        "steps": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "string"
+          }
+        },
+        "observed": {
+          "type": "object"
+        },
+        "codeThatRan": {
+          "type": "object"
+        },
+        "confirmedAtSeconds": {
+          "type": "number",
+          "minimum": 0
+        },
+        "images": {
+          "type": "object",
+          "required": [
+            "old",
+            "new"
+          ],
+          "properties": {
+            "old": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "new": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          }
+        },
+        "standIns": {
+          "description": "CRAWL-V1 amendment 13, only when the app's copies answer outside services (sign-in, mail, payments...) with Haystack stand-ins: the calls to them on the path this finding was judged on, per build, one line per distinct call ('<unsupported|mutates> <provider>: <operation>', the phase added in parentheses when not run). 'unsupported': the stand-in could not serve the call, so the copy did not behave as production would there.",
+          "type": "object",
+          "required": [
+            "old",
+            "new"
+          ],
+          "properties": {
+            "old": {
+              "type": "array",
+              "maxItems": 20,
+              "items": {
+                "type": "string"
+              }
+            },
+            "new": {
+              "type": "array",
+              "maxItems": 20,
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "standInRow": {
+      "description": "CRAWL-V1 amendment 13: one distinct outside-service call the crawl's stand-ins logged, with its count in each build: how many times the copy's calls reached the stand-in across the crawl's preparation and all its replays (double-checks and re-walks included), not how many user actions did.",
+      "type": "object",
+      "required": [
+        "provider",
+        "operation",
+        "kind",
+        "phase",
+        "old",
+        "new"
+      ],
+      "properties": {
+        "provider": {
+          "type": "string"
+        },
+        "operation": {
+          "type": "string"
+        },
+        "kind": {
+          "enum": [
+            "unsupported",
+            "mutates"
+          ]
+        },
+        "phase": {
+          "enum": [
+            "build",
+            "boot",
+            "run"
+          ]
+        },
+        "old": {
+          "$ref": "#/$defs/count"
+        },
+        "new": {
+          "$ref": "#/$defs/count"
+        }
+      }
+    },
+    "spot": {
+      "description": "One changed spot (one hunk of a changed file) and how far the crawl got with it: the change's product blast radius.",
+      "type": "object",
+      "required": [
+        "id",
+        "file",
+        "line",
+        "furthest",
+        "reachedBy",
+        "shows",
+        "findingIds"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "<file>#<n>: the file's n-th hunk, 1-based."
+        },
+        "file": {
+          "type": "string"
+        },
+        "line": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "furthest": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/spotStage"
+            }
+          ]
+        },
+        "reachedBy": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "stage",
+                "start",
+                "steps",
+                "page"
+              ],
+              "properties": {
+                "stage": {
+                  "$ref": "#/$defs/spotStage"
+                },
+                "start": {
+                  "type": "string"
+                },
+                "steps": {
+                  "$ref": "#/$defs/strings"
+                },
+                "page": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              }
+            }
+          ]
+        },
+        "shows": {
+          "type": "array",
+          "maxItems": 5,
+          "items": {
+            "type": "string"
+          }
+        },
+        "findingIds": {
+          "$ref": "#/$defs/strings"
+        }
+      }
+    },
+    "results": {
+      "description": "The published results' shape, shared by the sealed manifest and an answer; each sets its own status.",
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "runId",
+        "attemptId",
+        "repository",
+        "baseCommit",
+        "workCommit",
+        "treeSha",
+        "changeTitle",
+        "status",
+        "worlds",
+        "reuse",
+        "timings",
+        "bugs",
+        "findings",
+        "reach",
+        "notFinishedInTime",
+        "error"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "runId": {
+          "$ref": "#/$defs/runId"
+        },
+        "attemptId": {
+          "type": "string"
+        },
+        "repository": {
+          "type": "string"
+        },
+        "baseCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "workCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "treeSha": {
+          "$ref": "#/$defs/commit"
+        },
+        "changeTitle": {
+          "type": "string",
+          "maxLength": 200
+        },
+        "worlds": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "base",
+                "head"
+              ],
+              "properties": {
+                "base": {
+                  "type": "string"
+                },
+                "head": {
+                  "type": "string"
+                }
+              }
+            }
+          ]
+        },
+        "reuse": {
+          "$ref": "#/$defs/reuse"
+        },
+        "timings": {
+          "description": "Milliseconds per stage, as measured.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "number",
+            "minimum": 0
+          }
+        },
+        "bugs": {
+          "$ref": "#/$defs/count"
+        },
+        "findings": {
+          "type": "array",
+          "maxItems": 50,
+          "items": {
+            "$ref": "#/$defs/finding"
+          }
+        },
+        "reach": {
+          "type": "object",
+          "required": [
+            "spots",
+            "unreachedChangedFiles",
+            "blast"
+          ],
+          "properties": {
+            "spots": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/spot"
+              }
+            },
+            "unreachedChangedFiles": {
+              "$ref": "#/$defs/strings"
+            },
+            "blast": {
+              "oneOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "type": "object",
+                  "required": [
+                    "functions",
+                    "ran",
+                    "unreached",
+                    "nearestUnreached"
+                  ],
+                  "properties": {
+                    "functions": {
+                      "$ref": "#/$defs/count"
+                    },
+                    "ran": {
+                      "$ref": "#/$defs/count"
+                    },
+                    "unreached": {
+                      "$ref": "#/$defs/count"
+                    },
+                    "nearestUnreached": {
+                      "$ref": "#/$defs/strings"
+                    }
+                  }
+                }
+              ]
+            }
+          }
+        },
+        "standIns": {
+          "description": "CRAWL-V1 amendment 13, only when the app's copies answer outside services with Haystack stand-ins: every distinct call the crawl's stand-ins logged, both builds alike (at most 200 rows, the rest counted in omittedRows), and each call a stand-in could not serve as a gap line ('<provider>: <operation> (only without your change|only with your change|with and without your change)'). Gaps are missing coverage of the copy, never findings.",
+          "type": "object",
+          "required": [
+            "coverage",
+            "omittedRows",
+            "gaps"
+          ],
+          "properties": {
+            "coverage": {
+              "type": "array",
+              "maxItems": 200,
+              "items": {
+                "$ref": "#/$defs/standInRow"
+              }
+            },
+            "omittedRows": {
+              "$ref": "#/$defs/count"
+            },
+            "gaps": {
+              "type": "array",
+              "maxItems": 200,
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "ideas": {
+          "description": "CRAWL-V1 amendment 17, only when `--idea` or `--ideas-file` gave ideas: one entry per idea in the order given. 'covered': an independent review saw it done in both builds; 'blocked': it could not be done in this copy (reason says why); 'unfinished': the crawl's time ended first. findingIds names the findings found while exploring it.",
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "text",
+              "state",
+              "reason",
+              "findingIds"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^idea-[1-9][0-9]*$"
+              },
+              "text": {
+                "type": "string"
+              },
+              "state": {
+                "enum": [
+                  "covered",
+                  "blocked",
+                  "unfinished"
+                ]
+              },
+              "reason": {
+                "type": "string"
+              },
+              "findingIds": {
+                "$ref": "#/$defs/strings"
+              }
+            }
+          }
+        },
+        "brief": {
+          "description": "CRAWL-V1 amendment 18: what Haystack knew of the change before exploring it (see `haystack schema pre-verify`, $defs.brief); absent when the run ended before its prepare.",
+          "type": "object",
+          "required": [
+            "functions",
+            "leftOut",
+            "planning"
+          ]
+        },
+        "notFinishedInTime": {
+          "$ref": "#/$defs/count"
+        },
+        "error": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/error"
+            }
+          ]
+        }
+      }
+    },
+    "manifest": {
+      "description": "Present once the crawl is terminal and published. 'prepared' (CRAWL-V1 amendment 12): the change was built and frozen by the turn-end hook and not crawled.",
+      "allOf": [
+        {
+          "$ref": "#/$defs/results"
+        }
+      ],
+      "properties": {
+        "status": {
+          "enum": [
+            "completed",
+            "prepared",
+            "incomplete",
+            "cancelled"
+          ]
+        }
+      }
+    },
+    "answer": {
+      "description": "CRAWL-V1 amendment 9: the current attempt's latest answer while no sealed manifest exists: what the crawl found so far (exploring), or its answer once its time is up (answered), with the same findings and reach the sealed manifest will carry. Its findings carry no images.",
+      "allOf": [
+        {
+          "$ref": "#/$defs/results"
+        }
+      ],
+      "required": [
+        "n",
+        "atSeconds"
+      ],
+      "properties": {
+        "status": {
+          "enum": [
+            "exploring",
+            "answered"
+          ]
+        },
+        "n": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "The attempt's answers are numbered from 1."
+        },
+        "atSeconds": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "How far into the crawl stage it was written."
+        }
+      }
+    },
+    "crawlView": {
+      "type": "object",
+      "required": [
+        "runId",
+        "repository",
+        "baseCommit",
+        "workCommit",
+        "treeSha",
+        "changeTitle",
+        "budgetMs",
+        "observedAt",
+        "createdAt",
+        "updatedAt",
+        "supersededBy",
+        "cancelRequested",
+        "manifest",
+        "answer",
+        "status",
+        "stage",
+        "clocks",
+        "reuse",
+        "worlds",
+        "totals"
+      ],
+      "properties": {
+        "runId": {
+          "$ref": "#/$defs/runId"
+        },
+        "repository": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_.-]{1,100}/[A-Za-z0-9_.-]{1,100}$"
+        },
+        "baseCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "workCommit": {
+          "$ref": "#/$defs/commit"
+        },
+        "treeSha": {
+          "$ref": "#/$defs/commit"
+        },
+        "changeTitle": {
+          "type": "string",
+          "maxLength": 200
+        },
+        "budgetMs": {
+          "description": "The time the crawl was asked for (ms), or null for the service's default.",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "integer",
+              "minimum": 60000,
+              "maximum": 1800000
+            }
+          ]
+        },
+        "observedAt": {
+          "$ref": "#/$defs/count"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "supersededBy": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/runId"
+            }
+          ]
+        },
+        "cancelRequested": {
+          "type": "boolean"
+        },
+        "mode": {
+          "enum": [
+            "prepare",
+            "crawl"
+          ],
+          "description": "CRAWL-V1 amendment 12: 'prepare' builds and freezes only (the turn-end hook); 'crawl' checks the change."
+        },
+        "status": {
+          "$ref": "#/$defs/status"
+        },
+        "stage": {
+          "$ref": "#/$defs/stage"
+        },
+        "clocks": {
+          "type": "object",
+          "required": [
+            "startedAt",
+            "stageStartedAt",
+            "crawlStartedAt",
+            "finishedAt",
+            "crawlBudgetMs"
+          ],
+          "properties": {
+            "startedAt": {
+              "$ref": "#/$defs/timestamp"
+            },
+            "stageStartedAt": {
+              "$ref": "#/$defs/timestamp"
+            },
+            "crawlStartedAt": {
+              "$ref": "#/$defs/timestamp"
+            },
+            "finishedAt": {
+              "$ref": "#/$defs/timestamp"
+            },
+            "crawlBudgetMs": {
+              "$ref": "#/$defs/count"
+            }
+          }
+        },
+        "reuse": {
+          "$ref": "#/$defs/reuse"
+        },
+        "worlds": {
+          "type": "object",
+          "required": [
+            "base",
+            "head"
+          ],
+          "properties": {
+            "base": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "head": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          }
+        },
+        "totals": {
+          "type": "object",
+          "required": [
+            "clicks",
+            "differing",
+            "confirmed",
+            "bugs",
+            "vmsLaunched",
+            "cleanupProven",
+            "cleanupUnproven"
+          ],
+          "properties": {
+            "clicks": {
+              "$ref": "#/$defs/count"
+            },
+            "differing": {
+              "$ref": "#/$defs/count"
+            },
+            "confirmed": {
+              "$ref": "#/$defs/count"
+            },
+            "bugs": {
+              "$ref": "#/$defs/count"
+            },
+            "vmsLaunched": {
+              "$ref": "#/$defs/count"
+            },
+            "cleanupProven": {
+              "$ref": "#/$defs/count"
+            },
+            "cleanupUnproven": {
+              "$ref": "#/$defs/count"
+            }
+          }
+        },
+        "error": {
+          "$ref": "#/$defs/error"
+        },
+        "manifest": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/manifest"
+            }
+          ]
+        },
+        "answer": {
+          "description": "Null once the sealed manifest exists, and before the crawl's first answer.",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/answer"
+            }
+          ]
+        }
+      }
+    }
+  }
+}