@allocator-one/harness-cli 1.16.0 → 1.17.1

package/spec/openapi.json

@@ -18411,6 +18411,3417 @@
         "summary": "Retry a terminal review execution",
         "tags": []
       }
+    },
+    "/api/v1/code/blobs/batch": {
+      "post": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. Several blobs in one body of at most the policy's `max_batch_bytes`, framed as `<sha256>\\n<length>\\n<bytes>` records back to back (optionally gzip-compressed). Each blob is stored, found already stored, or rejected with the reason a single upload would give.",
+        "parameters": [],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "description": "`<sha256>\\n<length>\\n<bytes>` records",
+                "format": "binary",
+                "type": "string"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "existing": {
+                          "items": {
+                            "pattern": "^[0-9a-f]{64}$",
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "rejected": {
+                          "items": {
+                            "properties": {
+                              "error": {
+                                "type": "string"
+                              },
+                              "sha256": {
+                                "pattern": "^[0-9a-f]{64}$",
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "stored": {
+                          "items": {
+                            "pattern": "^[0-9a-f]{64}$",
+                            "type": "string"
+                          },
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "The framing is invalid (`malformed_batch`)"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "The body exceeds the size limit (`payload_too_large`), or carries more than 5,000 records, repeated contents included (`too_many_records`)"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`quota_exceeded`: the organization is at a code index limit, named in `details.quota` and `details.limit`"
+          }
+        },
+        "summary": "Upload a batch of blobs",
+        "tags": []
+      }
+    },
+    "/api/v1/code/blobs/{sha256}": {
+      "put": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. One file's content, at most the policy's `max_file_bytes`, as raw bytes (optionally gzip-compressed with `Content-Encoding: gzip`). Blobs are deduplicated within the organization only. Only content an open sync of the organization names is accepted, so open the sync first. Content the policy refuses is never stored, and every entry naming it is skipped, so no base or sync waits for it. Re-sending a stored blob while an open sync still names it answers 204.",
+        "parameters": [
+          {
+            "description": "The content's lowercase hex SHA-256",
+            "in": "path",
+            "name": "sha256",
+            "required": true,
+            "schema": {
+              "pattern": "^[0-9a-f]{64}$",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "description": "The file's bytes",
+                "format": "binary",
+                "type": "string"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success"
+          },
+          "201": {
+            "description": "Stored"
+          },
+          "204": {
+            "description": "Already stored"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`unexpected_blob`: no open sync of the organization names this content"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Larger than `max_file_bytes` (`payload_too_large`)"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`invalid_sha256`, `hash_mismatch`, a policy refusal (`binary`, `secret_content`), or `quota_exceeded`: the organization is at a code index limit, named in `details.quota` and `details.limit`"
+          }
+        },
+        "summary": "Upload a blob",
+        "tags": []
+      }
+    },
+    "/api/v1/code/policy": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. What the CLI may upload and how it must scan: the per-file byte limit, the denied path globs and content patterns, the indexed extensions and languages, the binary rule and the batch byte limit, with the organization it applies to. The policy's digest is on every base status; a write scanned under another one is refused with 409 `stale_policy`. A base also leaves out what the commit's root `.harnesscodeignore` names: one glob per line, trimmed, with lines starting `#` or `!` skipped (no negation); `*`, `**` and `?` are the only wildcards, matched case-sensitively; a leading `/` anchors, a trailing `/` is dropped and a match covers descendants; globs over 256 bytes or with more than 8 `*` are dropped, and only the first 64 KiB and 1,000 globs count.",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "binary_detection": {
+                          "type": "boolean"
+                        },
+                        "binary_rule": {
+                          "type": "string"
+                        },
+                        "content_patterns": {
+                          "description": "Each one a regex from harness-cli's reviewed list, verbatim, or a literal marker; a client refuses any other before it scans, so a new regex ships in a harness-cli release first",
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "deny_glob_case": {
+                          "description": "How `deny_globs` match: folding ASCII letters only. Absent means case-sensitive; a client refuses a mode it does not know",
+                          "enum": [
+                            "ascii_insensitive"
+                          ],
+                          "type": "string"
+                        },
+                        "deny_globs": {
+                          "description": "Globs whose only wildcards are `**/`, `/**`, `*` and `?`; everything else is literal. One without a slash matches the basename at any depth; one with a slash, the whole path",
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "include_extensions": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "languages": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "max_batch_bytes": {
+                          "type": "integer"
+                        },
+                        "max_file_bytes": {
+                          "type": "integer"
+                        },
+                        "org_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "org_name": {
+                          "type": "string"
+                        },
+                        "policy_digest": {
+                          "description": "The digest every scanned write names; see `stale_policy`",
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Get the code upload policy",
+        "tags": []
+      }
+    },
+    "/api/v1/code/repositories": {
+      "put": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. Connecting a repository the organization has not connected yet also needs Harness administrator standing (403 `forbidden`); resolving one already connected does not. Returns the organization's repository named by its normalized remote (`github.com/<owner>/<name>`), connecting it first when needed. Only a repository the organization's GitHub connection shares is connected: any other is refused with 422 `repository_not_connected`, whose message names the connection to share it through. A newly connected repository's default branch is indexed by the server.",
+        "parameters": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "properties": {
+                  "default_branch": {
+                    "type": "string"
+                  },
+                  "repo_key": {
+                    "description": "The normalized remote, e.g. `github.com/acme/app`",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "repo_key"
+                ],
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "repo_key": {
+                          "type": "string"
+                        },
+                        "repository_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Invalid `repo_key`, `repository_not_connected`, or `quota_exceeded`: the organization is at a code index limit, named in `details.quota` and `details.limit`"
+          }
+        },
+        "summary": "Connect or resolve a repository",
+        "tags": []
+      }
+    },
+    "/api/v1/code/repositories/{repository_id}": {
+      "delete": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope AND Harness administrator standing in the organization the credential is bound to — this is a settings write, gated exactly as the settings UI is. Deletes the repository with its views, bases and syncs, and the blobs and facts no other repository of the organization uses. Answers with the counts removed.",
+        "parameters": [
+          {
+            "description": "The repository's id",
+            "in": "path",
+            "name": "repository_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "deleted": {
+                          "properties": {
+                            "bases": {
+                              "type": "integer"
+                            },
+                            "blobs": {
+                              "type": "integer"
+                            },
+                            "facts": {
+                              "type": "integer"
+                            },
+                            "repositories": {
+                              "type": "integer"
+                            },
+                            "views": {
+                              "type": "integer"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Remove a repository from the code index",
+        "tags": []
+      }
+    },
+    "/api/v1/code/repositories/{repository_id}/bases/{sha}": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. Where the commit's base stands under the current upload policy. The server builds a base from the organization's GitHub connection: asking for one it has not built yet queues the build and answers `fetching`. It is `complete` once built, `ready` once indexed, and `failed` (with `error`) when the build failed; asking again retries it. Sync an overlay once the base is `complete` or `ready`.",
+        "parameters": [
+          {
+            "description": "The repository's id",
+            "in": "path",
+            "name": "repository_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The commit's full SHA-1",
+            "in": "path",
+            "name": "sha",
+            "required": true,
+            "schema": {
+              "pattern": "^[0-9a-f]{40}$",
+              "type": "string"
+            }
+          },
+          {
+            "description": "`true` adds `skipped`: every file the base left out, with the reason",
+            "in": "query",
+            "name": "skipped",
+            "required": false,
+            "schema": {
+              "type": "boolean"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "blobs_missing": {
+                          "type": "integer"
+                        },
+                        "error": {
+                          "additionalProperties": true,
+                          "description": "Why the build failed",
+                          "nullable": true,
+                          "type": "object"
+                        },
+                        "excluded_count": {
+                          "type": "integer"
+                        },
+                        "file_count": {
+                          "type": "integer"
+                        },
+                        "policy_digest": {
+                          "type": "string"
+                        },
+                        "skipped": {
+                          "description": "Files in an indexed language the base left out whole, never stored",
+                          "items": {
+                            "properties": {
+                              "path": {
+                                "type": "string"
+                              },
+                              "reason": {
+                                "enum": [
+                                  "excluded_path",
+                                  "ignored",
+                                  "secret_content",
+                                  "binary",
+                                  "too_large",
+                                  "symlink"
+                                ],
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "state": {
+                          "enum": [
+                            "fetching",
+                            "complete",
+                            "ready",
+                            "failed"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Get a commit's base",
+        "tags": []
+      }
+    },
+    "/api/v1/code/repositories/{repository_id}/views/{view_key}": {
+      "put": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. A view is one worktree's overlay on a base and belongs to whoever created it: other members read it, but only its creator or a Harness administrator writes to it (403 `not_view_owner`). Answers with the view's status. A JSON body may be sent gzip-compressed with `Content-Encoding: gzip`; the size limit applies to it inflated.",
+        "parameters": [
+          {
+            "description": "The repository's id",
+            "in": "path",
+            "name": "repository_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The worktree's key, 1–128 bytes, chosen by the client",
+            "in": "path",
+            "name": "view_key",
+            "required": true,
+            "schema": {
+              "maxLength": 128,
+              "minLength": 1,
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "properties": {
+                  "label": {
+                    "description": "A display label, updated on every call",
+                    "type": "string"
+                  },
+                  "session": {
+                    "description": "The client session that created the view",
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          },
+          "required": false
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "active": {
+                          "description": "The version queries answer from; null before the first is indexed",
+                          "nullable": true,
+                          "properties": {
+                            "base_commit": {
+                              "pattern": "^[0-9a-f]{40}$",
+                              "type": "string"
+                            },
+                            "indexed_at": {
+                              "format": "date-time",
+                              "type": "string"
+                            },
+                            "overlay_digest": {
+                              "type": "string"
+                            },
+                            "version": {
+                              "type": "integer"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "kind": {
+                          "description": "A CLI worktree's overlay, or the repository's default branch, kept by the server",
+                          "enum": [
+                            "worktree",
+                            "default_branch"
+                          ],
+                          "type": "string"
+                        },
+                        "last_sync_at": {
+                          "format": "date-time",
+                          "nullable": true,
+                          "type": "string"
+                        },
+                        "pending": {
+                          "description": "A later sync still queued, indexing or failed",
+                          "nullable": true,
+                          "properties": {
+                            "error": {
+                              "description": "Why indexing failed",
+                              "nullable": true,
+                              "properties": {
+                                "failures": {
+                                  "description": "For a refresh, how many times it has failed",
+                                  "type": "integer"
+                                },
+                                "files": {
+                                  "description": "For `regressed`, how many files would lose their facts",
+                                  "type": "integer"
+                                },
+                                "message": {
+                                  "type": "string"
+                                },
+                                "reason": {
+                                  "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                                  "type": "string"
+                                },
+                                "retry_at": {
+                                  "description": "For a refresh, when the server tries it again",
+                                  "format": "date-time",
+                                  "type": "string"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "progress": {
+                              "description": "Files processed so far (parsed or failed) of those the sync must parse, updated after each batch; null before indexing starts",
+                              "nullable": true,
+                              "properties": {
+                                "done": {
+                                  "type": "integer"
+                                },
+                                "total": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "state": {
+                              "type": "string"
+                            },
+                            "version": {
+                              "type": "integer"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "repository_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "view_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "view_key": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`not_view_owner`: another member's view; sync your own `view_key`; `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Invalid `view_key` (the key `default` is the server's), or `quota_exceeded`: the organization is at a code index limit, named in `details.quota` and `details.limit`"
+          }
+        },
+        "summary": "Create or resolve a worktree view",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. Its active version, with that version's base commit and overlay digest, and any sync still pending.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "active": {
+                          "description": "The version queries answer from; null before the first is indexed",
+                          "nullable": true,
+                          "properties": {
+                            "base_commit": {
+                              "pattern": "^[0-9a-f]{40}$",
+                              "type": "string"
+                            },
+                            "indexed_at": {
+                              "format": "date-time",
+                              "type": "string"
+                            },
+                            "overlay_digest": {
+                              "type": "string"
+                            },
+                            "version": {
+                              "type": "integer"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "kind": {
+                          "description": "A CLI worktree's overlay, or the repository's default branch, kept by the server",
+                          "enum": [
+                            "worktree",
+                            "default_branch"
+                          ],
+                          "type": "string"
+                        },
+                        "last_sync_at": {
+                          "format": "date-time",
+                          "nullable": true,
+                          "type": "string"
+                        },
+                        "pending": {
+                          "description": "A later sync still queued, indexing or failed",
+                          "nullable": true,
+                          "properties": {
+                            "error": {
+                              "description": "Why indexing failed",
+                              "nullable": true,
+                              "properties": {
+                                "failures": {
+                                  "description": "For a refresh, how many times it has failed",
+                                  "type": "integer"
+                                },
+                                "files": {
+                                  "description": "For `regressed`, how many files would lose their facts",
+                                  "type": "integer"
+                                },
+                                "message": {
+                                  "type": "string"
+                                },
+                                "reason": {
+                                  "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                                  "type": "string"
+                                },
+                                "retry_at": {
+                                  "description": "For a refresh, when the server tries it again",
+                                  "format": "date-time",
+                                  "type": "string"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "progress": {
+                              "description": "Files processed so far (parsed or failed) of those the sync must parse, updated after each batch; null before indexing starts",
+                              "nullable": true,
+                              "properties": {
+                                "done": {
+                                  "type": "integer"
+                                },
+                                "total": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "state": {
+                              "type": "string"
+                            },
+                            "version": {
+                              "type": "integer"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "repository_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "view_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "view_key": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Get a view's status",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/affected": {
+      "post": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. The symbols that transitively depend on the given symbols, or on every symbol the given paths declare, up to `depth`. Calls are followed, and an import, alias, use or require only when it names a module. A type use is listed under `type_dependents` and not followed unless `include_types`. A read of a value asked for is impact at depth 1. A dependent declared at module level is listed with `via_level: \"module_level\"` and not expanded. An ambiguous reference is listed under `possible` and not followed unless `include_ambiguous`. The body is at most 256 KiB. A JSON body may be sent gzip-compressed with `Content-Encoding: gzip`; the size limit applies to it inflated. `meta.truncation` says whether the answer was cut, the cap that applied and, when a larger request would show more, the parameters to send next (`next`). `not_tracked` names the references the symbol's language doesn't record, so an empty list isn't read as none. A view with no indexed version yet answers 400.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "properties": {
+                  "depth": {
+                    "default": 3,
+                    "maximum": 6,
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  "include_ambiguous": {
+                    "default": false,
+                    "type": "boolean"
+                  },
+                  "include_types": {
+                    "default": false,
+                    "type": "boolean"
+                  },
+                  "paths": {
+                    "description": "Files whose symbols seed it",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "symbol_ids": {
+                    "description": "Symbol ids from search",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "files": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "not_tracked": {
+                          "description": "The references to the symbols asked about that their language doesn't record, in full or in part",
+                          "items": {
+                            "properties": {
+                              "language": {
+                                "type": "string"
+                              },
+                              "partial": {
+                                "type": "boolean"
+                              },
+                              "reason": {
+                                "type": "string"
+                              },
+                              "reference_kind": {
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "possible": {
+                          "items": {
+                            "additionalProperties": true,
+                            "properties": {
+                              "at": {
+                                "additionalProperties": true,
+                                "description": "A file and its line and byte span at the view's version",
+                                "properties": {
+                                  "end_byte": {
+                                    "type": "integer"
+                                  },
+                                  "end_line": {
+                                    "type": "integer"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  },
+                                  "start_byte": {
+                                    "type": "integer"
+                                  },
+                                  "start_line": {
+                                    "type": "integer"
+                                  },
+                                  "truncated": {
+                                    "description": "The snippet was cut to its budget",
+                                    "type": "boolean"
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              "binding": {
+                                "enum": [
+                                  "resolved",
+                                  "ambiguous"
+                                ],
+                                "type": "string"
+                              },
+                              "distance": {
+                                "type": "integer"
+                              },
+                              "kind": {
+                                "type": "string"
+                              },
+                              "name": {
+                                "type": "string"
+                              },
+                              "relation": {
+                                "enum": [
+                                  "read",
+                                  "type"
+                                ],
+                                "type": "string"
+                              },
+                              "score": {
+                                "description": "For an ambiguous binding, the product of the scores along the way",
+                                "type": "number"
+                              },
+                              "symbol_id": {
+                                "type": "string"
+                              },
+                              "via": {
+                                "additionalProperties": true,
+                                "description": "A file and its line and byte span at the view's version",
+                                "properties": {
+                                  "end_byte": {
+                                    "type": "integer"
+                                  },
+                                  "end_line": {
+                                    "type": "integer"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  },
+                                  "start_byte": {
+                                    "type": "integer"
+                                  },
+                                  "start_line": {
+                                    "type": "integer"
+                                  },
+                                  "truncated": {
+                                    "description": "The snippet was cut to its budget",
+                                    "type": "boolean"
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              "via_level": {
+                                "enum": [
+                                  "module_level"
+                                ],
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "symbols": {
+                          "items": {
+                            "additionalProperties": true,
+                            "properties": {
+                              "at": {
+                                "additionalProperties": true,
+                                "description": "A file and its line and byte span at the view's version",
+                                "properties": {
+                                  "end_byte": {
+                                    "type": "integer"
+                                  },
+                                  "end_line": {
+                                    "type": "integer"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  },
+                                  "start_byte": {
+                                    "type": "integer"
+                                  },
+                                  "start_line": {
+                                    "type": "integer"
+                                  },
+                                  "truncated": {
+                                    "description": "The snippet was cut to its budget",
+                                    "type": "boolean"
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              "binding": {
+                                "enum": [
+                                  "resolved",
+                                  "ambiguous"
+                                ],
+                                "type": "string"
+                              },
+                              "distance": {
+                                "type": "integer"
+                              },
+                              "kind": {
+                                "type": "string"
+                              },
+                              "name": {
+                                "type": "string"
+                              },
+                              "relation": {
+                                "enum": [
+                                  "read",
+                                  "type"
+                                ],
+                                "type": "string"
+                              },
+                              "score": {
+                                "description": "For an ambiguous binding, the product of the scores along the way",
+                                "type": "number"
+                              },
+                              "symbol_id": {
+                                "type": "string"
+                              },
+                              "via": {
+                                "additionalProperties": true,
+                                "description": "A file and its line and byte span at the view's version",
+                                "properties": {
+                                  "end_byte": {
+                                    "type": "integer"
+                                  },
+                                  "end_line": {
+                                    "type": "integer"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  },
+                                  "start_byte": {
+                                    "type": "integer"
+                                  },
+                                  "start_line": {
+                                    "type": "integer"
+                                  },
+                                  "truncated": {
+                                    "description": "The snippet was cut to its budget",
+                                    "type": "boolean"
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              "via_level": {
+                                "enum": [
+                                  "module_level"
+                                ],
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "type_dependents": {
+                          "items": {
+                            "additionalProperties": true,
+                            "properties": {
+                              "at": {
+                                "additionalProperties": true,
+                                "description": "A file and its line and byte span at the view's version",
+                                "properties": {
+                                  "end_byte": {
+                                    "type": "integer"
+                                  },
+                                  "end_line": {
+                                    "type": "integer"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  },
+                                  "start_byte": {
+                                    "type": "integer"
+                                  },
+                                  "start_line": {
+                                    "type": "integer"
+                                  },
+                                  "truncated": {
+                                    "description": "The snippet was cut to its budget",
+                                    "type": "boolean"
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              "binding": {
+                                "enum": [
+                                  "resolved",
+                                  "ambiguous"
+                                ],
+                                "type": "string"
+                              },
+                              "distance": {
+                                "type": "integer"
+                              },
+                              "kind": {
+                                "type": "string"
+                              },
+                              "name": {
+                                "type": "string"
+                              },
+                              "relation": {
+                                "enum": [
+                                  "read",
+                                  "type"
+                                ],
+                                "type": "string"
+                              },
+                              "score": {
+                                "description": "For an ambiguous binding, the product of the scores along the way",
+                                "type": "number"
+                              },
+                              "symbol_id": {
+                                "type": "string"
+                              },
+                              "via": {
+                                "additionalProperties": true,
+                                "description": "A file and its line and byte span at the view's version",
+                                "properties": {
+                                  "end_byte": {
+                                    "type": "integer"
+                                  },
+                                  "end_line": {
+                                    "type": "integer"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  },
+                                  "start_byte": {
+                                    "type": "integer"
+                                  },
+                                  "start_line": {
+                                    "type": "integer"
+                                  },
+                                  "truncated": {
+                                    "description": "The snippet was cut to its budget",
+                                    "type": "boolean"
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              "via_level": {
+                                "enum": [
+                                  "module_level"
+                                ],
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.3"
+                          ],
+                          "type": "string"
+                        },
+                        "truncation": {
+                          "additionalProperties": true,
+                          "description": "Whether the answer was cut and how: the caps that applied, what was left out (e.g. `lists`, `depth_limited`, `items_without_text`, `candidates_dropped`) and, when a larger request would show more, the parameters to send next.",
+                          "properties": {
+                            "budget_tokens": {
+                              "type": "integer"
+                            },
+                            "candidates_dropped": {
+                              "type": "integer"
+                            },
+                            "definition_truncated": {
+                              "type": "boolean"
+                            },
+                            "depth": {
+                              "type": "integer"
+                            },
+                            "depth_limited": {
+                              "description": "Dependents not yet listed remain past the depth asked for",
+                              "type": "boolean"
+                            },
+                            "hint": {
+                              "type": "string"
+                            },
+                            "items_unavailable": {
+                              "description": "Items whose indexed content couldn't be read",
+                              "type": "integer"
+                            },
+                            "items_without_text": {
+                              "description": "Items the budget left as citations without text",
+                              "type": "integer"
+                            },
+                            "limit": {
+                              "type": "integer"
+                            },
+                            "limits": {
+                              "additionalProperties": {
+                                "type": "integer"
+                              },
+                              "type": "object"
+                            },
+                            "lists": {
+                              "description": "The answer's lists the caps cut",
+                              "items": {
+                                "type": "string"
+                              },
+                              "type": "array"
+                            },
+                            "next": {
+                              "additionalProperties": true,
+                              "description": "The request parameters to send for more: `limit`, `depth` or `budget_tokens`",
+                              "type": "object"
+                            },
+                            "references_cut": {
+                              "type": "boolean"
+                            },
+                            "seeds_dropped": {
+                              "type": "integer"
+                            },
+                            "truncated": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "truncated"
+                          ],
+                          "type": "object"
+                        },
+                        "view": {
+                          "properties": {
+                            "active": {
+                              "description": "The version queries answer from; null before the first is indexed",
+                              "nullable": true,
+                              "properties": {
+                                "base_commit": {
+                                  "pattern": "^[0-9a-f]{40}$",
+                                  "type": "string"
+                                },
+                                "indexed_at": {
+                                  "format": "date-time",
+                                  "type": "string"
+                                },
+                                "overlay_digest": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "kind": {
+                              "description": "A CLI worktree's overlay, or the repository's default branch, kept by the server",
+                              "enum": [
+                                "worktree",
+                                "default_branch"
+                              ],
+                              "type": "string"
+                            },
+                            "last_sync_at": {
+                              "format": "date-time",
+                              "nullable": true,
+                              "type": "string"
+                            },
+                            "pending": {
+                              "description": "A later sync still queued, indexing or failed",
+                              "nullable": true,
+                              "properties": {
+                                "error": {
+                                  "description": "Why indexing failed",
+                                  "nullable": true,
+                                  "properties": {
+                                    "failures": {
+                                      "description": "For a refresh, how many times it has failed",
+                                      "type": "integer"
+                                    },
+                                    "files": {
+                                      "description": "For `regressed`, how many files would lose their facts",
+                                      "type": "integer"
+                                    },
+                                    "message": {
+                                      "type": "string"
+                                    },
+                                    "reason": {
+                                      "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                                      "type": "string"
+                                    },
+                                    "retry_at": {
+                                      "description": "For a refresh, when the server tries it again",
+                                      "format": "date-time",
+                                      "type": "string"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "progress": {
+                                  "description": "Files processed so far (parsed or failed) of those the sync must parse, updated after each batch; null before indexing starts",
+                                  "nullable": true,
+                                  "properties": {
+                                    "done": {
+                                      "type": "integer"
+                                    },
+                                    "total": {
+                                      "type": "integer"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "state": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "repository_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_key": {
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "The body exceeds the size limit (`payload_too_large`)"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Find what a change affects",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/context": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. The symbol's definition first, then what it calls and what calls it, ranked by how directly they bear on it, packed into the budget at about 4 characters a token. Every item cites its file and byte span; the definition always keeps text, and an item that doesn't fit stays a citation without it. `meta.truncation` says whether the answer was cut, the cap that applied and, when a larger request would show more, the parameters to send next (`next`). `not_tracked` names the references the symbol's language doesn't record, so an empty list isn't read as none. A view with no indexed version yet answers 400.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The symbol to explain",
+            "in": "query",
+            "name": "symbol_id",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "Without `symbol_id`, a name whose best match is used",
+            "in": "query",
+            "name": "q",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "The token budget, 100 to 32,000 (default 2,000)",
+            "in": "query",
+            "name": "budget_tokens",
+            "required": false,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "budget_tokens": {
+                          "type": "integer"
+                        },
+                        "items": {
+                          "items": {
+                            "additionalProperties": true,
+                            "description": "A cited window with its role (`definition`, `callee`, `caller`, …) and, when it fits, its text",
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "not_tracked": {
+                          "description": "The references to the symbols asked about that their language doesn't record, in full or in part",
+                          "items": {
+                            "properties": {
+                              "language": {
+                                "type": "string"
+                              },
+                              "partial": {
+                                "type": "boolean"
+                              },
+                              "reason": {
+                                "type": "string"
+                              },
+                              "reference_kind": {
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "symbol": {
+                          "properties": {
+                            "kind": {
+                              "type": "string"
+                            },
+                            "name": {
+                              "type": "string"
+                            },
+                            "symbol_id": {
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "token_estimate": {
+                          "type": "string"
+                        },
+                        "used_tokens": {
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.3"
+                          ],
+                          "type": "string"
+                        },
+                        "truncation": {
+                          "additionalProperties": true,
+                          "description": "Whether the answer was cut and how: the caps that applied, what was left out (e.g. `lists`, `depth_limited`, `items_without_text`, `candidates_dropped`) and, when a larger request would show more, the parameters to send next.",
+                          "properties": {
+                            "budget_tokens": {
+                              "type": "integer"
+                            },
+                            "candidates_dropped": {
+                              "type": "integer"
+                            },
+                            "definition_truncated": {
+                              "type": "boolean"
+                            },
+                            "depth": {
+                              "type": "integer"
+                            },
+                            "depth_limited": {
+                              "description": "Dependents not yet listed remain past the depth asked for",
+                              "type": "boolean"
+                            },
+                            "hint": {
+                              "type": "string"
+                            },
+                            "items_unavailable": {
+                              "description": "Items whose indexed content couldn't be read",
+                              "type": "integer"
+                            },
+                            "items_without_text": {
+                              "description": "Items the budget left as citations without text",
+                              "type": "integer"
+                            },
+                            "limit": {
+                              "type": "integer"
+                            },
+                            "limits": {
+                              "additionalProperties": {
+                                "type": "integer"
+                              },
+                              "type": "object"
+                            },
+                            "lists": {
+                              "description": "The answer's lists the caps cut",
+                              "items": {
+                                "type": "string"
+                              },
+                              "type": "array"
+                            },
+                            "next": {
+                              "additionalProperties": true,
+                              "description": "The request parameters to send for more: `limit`, `depth` or `budget_tokens`",
+                              "type": "object"
+                            },
+                            "references_cut": {
+                              "type": "boolean"
+                            },
+                            "seeds_dropped": {
+                              "type": "integer"
+                            },
+                            "truncated": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "truncated"
+                          ],
+                          "type": "object"
+                        },
+                        "view": {
+                          "properties": {
+                            "active": {
+                              "description": "The version queries answer from; null before the first is indexed",
+                              "nullable": true,
+                              "properties": {
+                                "base_commit": {
+                                  "pattern": "^[0-9a-f]{40}$",
+                                  "type": "string"
+                                },
+                                "indexed_at": {
+                                  "format": "date-time",
+                                  "type": "string"
+                                },
+                                "overlay_digest": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "kind": {
+                              "description": "A CLI worktree's overlay, or the repository's default branch, kept by the server",
+                              "enum": [
+                                "worktree",
+                                "default_branch"
+                              ],
+                              "type": "string"
+                            },
+                            "last_sync_at": {
+                              "format": "date-time",
+                              "nullable": true,
+                              "type": "string"
+                            },
+                            "pending": {
+                              "description": "A later sync still queued, indexing or failed",
+                              "nullable": true,
+                              "properties": {
+                                "error": {
+                                  "description": "Why indexing failed",
+                                  "nullable": true,
+                                  "properties": {
+                                    "failures": {
+                                      "description": "For a refresh, how many times it has failed",
+                                      "type": "integer"
+                                    },
+                                    "files": {
+                                      "description": "For `regressed`, how many files would lose their facts",
+                                      "type": "integer"
+                                    },
+                                    "message": {
+                                      "type": "string"
+                                    },
+                                    "reason": {
+                                      "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                                      "type": "string"
+                                    },
+                                    "retry_at": {
+                                      "description": "For a refresh, when the server tries it again",
+                                      "format": "date-time",
+                                      "type": "string"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "progress": {
+                                  "description": "Files processed so far (parsed or failed) of those the sync must parse, updated after each batch; null before indexing starts",
+                                  "nullable": true,
+                                  "properties": {
+                                    "done": {
+                                      "type": "integer"
+                                    },
+                                    "total": {
+                                      "type": "integer"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "state": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "repository_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_key": {
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Pack cited source for a symbol",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/symbols": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. Symbols at the view's active version, best first: exact names, then a fused ranking of name prefix and fuzzy name similarity. `meta.truncation` says whether the answer was cut, the cap that applied and, when a larger request would show more, the parameters to send next (`next`). A view with no indexed version yet answers 400.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The name to search for",
+            "in": "query",
+            "name": "q",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "Only symbols of this kind, e.g. `function` or `module`",
+            "in": "query",
+            "name": "kind",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "Only symbols declared under this path",
+            "in": "query",
+            "name": "path_prefix",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "At most this many symbols, up to 100 (default 20)",
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "items": {
+                        "properties": {
+                          "at": {
+                            "additionalProperties": true,
+                            "description": "A file and its line and byte span at the view's version",
+                            "properties": {
+                              "end_byte": {
+                                "type": "integer"
+                              },
+                              "end_line": {
+                                "type": "integer"
+                              },
+                              "path": {
+                                "type": "string"
+                              },
+                              "start_byte": {
+                                "type": "integer"
+                              },
+                              "start_line": {
+                                "type": "integer"
+                              },
+                              "truncated": {
+                                "description": "The snippet was cut to its budget",
+                                "type": "boolean"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "kind": {
+                            "type": "string"
+                          },
+                          "language": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "path": {
+                            "type": "string"
+                          },
+                          "qualified_name": {
+                            "type": "string"
+                          },
+                          "range": {
+                            "properties": {
+                              "end_line": {
+                                "type": "integer"
+                              },
+                              "start_line": {
+                                "type": "integer"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "symbol_id": {
+                            "type": "string"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.3"
+                          ],
+                          "type": "string"
+                        },
+                        "truncation": {
+                          "additionalProperties": true,
+                          "description": "Whether the answer was cut and how: the caps that applied, what was left out (e.g. `lists`, `depth_limited`, `items_without_text`, `candidates_dropped`) and, when a larger request would show more, the parameters to send next.",
+                          "properties": {
+                            "budget_tokens": {
+                              "type": "integer"
+                            },
+                            "candidates_dropped": {
+                              "type": "integer"
+                            },
+                            "definition_truncated": {
+                              "type": "boolean"
+                            },
+                            "depth": {
+                              "type": "integer"
+                            },
+                            "depth_limited": {
+                              "description": "Dependents not yet listed remain past the depth asked for",
+                              "type": "boolean"
+                            },
+                            "hint": {
+                              "type": "string"
+                            },
+                            "items_unavailable": {
+                              "description": "Items whose indexed content couldn't be read",
+                              "type": "integer"
+                            },
+                            "items_without_text": {
+                              "description": "Items the budget left as citations without text",
+                              "type": "integer"
+                            },
+                            "limit": {
+                              "type": "integer"
+                            },
+                            "limits": {
+                              "additionalProperties": {
+                                "type": "integer"
+                              },
+                              "type": "object"
+                            },
+                            "lists": {
+                              "description": "The answer's lists the caps cut",
+                              "items": {
+                                "type": "string"
+                              },
+                              "type": "array"
+                            },
+                            "next": {
+                              "additionalProperties": true,
+                              "description": "The request parameters to send for more: `limit`, `depth` or `budget_tokens`",
+                              "type": "object"
+                            },
+                            "references_cut": {
+                              "type": "boolean"
+                            },
+                            "seeds_dropped": {
+                              "type": "integer"
+                            },
+                            "truncated": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "truncated"
+                          ],
+                          "type": "object"
+                        },
+                        "view": {
+                          "properties": {
+                            "active": {
+                              "description": "The version queries answer from; null before the first is indexed",
+                              "nullable": true,
+                              "properties": {
+                                "base_commit": {
+                                  "pattern": "^[0-9a-f]{40}$",
+                                  "type": "string"
+                                },
+                                "indexed_at": {
+                                  "format": "date-time",
+                                  "type": "string"
+                                },
+                                "overlay_digest": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "kind": {
+                              "description": "A CLI worktree's overlay, or the repository's default branch, kept by the server",
+                              "enum": [
+                                "worktree",
+                                "default_branch"
+                              ],
+                              "type": "string"
+                            },
+                            "last_sync_at": {
+                              "format": "date-time",
+                              "nullable": true,
+                              "type": "string"
+                            },
+                            "pending": {
+                              "description": "A later sync still queued, indexing or failed",
+                              "nullable": true,
+                              "properties": {
+                                "error": {
+                                  "description": "Why indexing failed",
+                                  "nullable": true,
+                                  "properties": {
+                                    "failures": {
+                                      "description": "For a refresh, how many times it has failed",
+                                      "type": "integer"
+                                    },
+                                    "files": {
+                                      "description": "For `regressed`, how many files would lose their facts",
+                                      "type": "integer"
+                                    },
+                                    "message": {
+                                      "type": "string"
+                                    },
+                                    "reason": {
+                                      "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                                      "type": "string"
+                                    },
+                                    "retry_at": {
+                                      "description": "For a refresh, when the server tries it again",
+                                      "format": "date-time",
+                                      "type": "string"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "progress": {
+                                  "description": "Files processed so far (parsed or failed) of those the sync must parse, updated after each batch; null before indexing starts",
+                                  "nullable": true,
+                                  "properties": {
+                                    "done": {
+                                      "type": "integer"
+                                    },
+                                    "total": {
+                                      "type": "integer"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "state": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "repository_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_key": {
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Search a view's symbols",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/symbols/{symbol_id}": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope. The symbol's definition, cut to the budget, and its references both ways, with how each one bound: `resolved`, `ambiguous` (ranked candidates) or `unresolved`. Callers are split into those bound to it, possible ones and name-only ones; a type or module also lists its members' callers. `meta.truncation` says whether the answer was cut, the cap that applied and, when a larger request would show more, the parameters to send next (`next`). `not_tracked` names the references the symbol's language doesn't record, so an empty list isn't read as none. A view with no indexed version yet answers 400.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "A symbol id from search, explain, affected or context; opaque, and stable across versions. A Swift id also names where its declaration starts, since overloads can share a name: once the declaration moves, it is not found and a new search gives its current id",
+            "in": "path",
+            "name": "symbol_id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "The definition snippet's token budget, up to 16,000 (default 4,000)",
+            "in": "query",
+            "name": "budget_tokens",
+            "required": false,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "definition": {
+                          "additionalProperties": true,
+                          "description": "A file and its line and byte span at the view's version",
+                          "properties": {
+                            "end_byte": {
+                              "type": "integer"
+                            },
+                            "end_line": {
+                              "type": "integer"
+                            },
+                            "path": {
+                              "type": "string"
+                            },
+                            "start_byte": {
+                              "type": "integer"
+                            },
+                            "start_line": {
+                              "type": "integer"
+                            },
+                            "truncated": {
+                              "description": "The snippet was cut to its budget",
+                              "type": "boolean"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "edges": {
+                          "properties": {
+                            "called_by": {
+                              "items": {
+                                "additionalProperties": true,
+                                "type": "object"
+                              },
+                              "type": "array"
+                            },
+                            "calls": {
+                              "items": {
+                                "additionalProperties": true,
+                                "type": "object"
+                              },
+                              "type": "array"
+                            },
+                            "member_callers": {
+                              "items": {
+                                "additionalProperties": true,
+                                "type": "object"
+                              },
+                              "type": "array"
+                            },
+                            "name_only_callers": {
+                              "items": {
+                                "additionalProperties": true,
+                                "type": "object"
+                              },
+                              "type": "array"
+                            },
+                            "possible_callers": {
+                              "items": {
+                                "additionalProperties": true,
+                                "type": "object"
+                              },
+                              "type": "array"
+                            },
+                            "references": {
+                              "items": {
+                                "additionalProperties": true,
+                                "type": "object"
+                              },
+                              "type": "array"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "not_tracked": {
+                          "description": "The references to the symbols asked about that their language doesn't record, in full or in part",
+                          "items": {
+                            "properties": {
+                              "language": {
+                                "type": "string"
+                              },
+                              "partial": {
+                                "type": "boolean"
+                              },
+                              "reason": {
+                                "type": "string"
+                              },
+                              "reference_kind": {
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "symbol": {
+                          "properties": {
+                            "at": {
+                              "additionalProperties": true,
+                              "description": "A file and its line and byte span at the view's version",
+                              "properties": {
+                                "end_byte": {
+                                  "type": "integer"
+                                },
+                                "end_line": {
+                                  "type": "integer"
+                                },
+                                "path": {
+                                  "type": "string"
+                                },
+                                "start_byte": {
+                                  "type": "integer"
+                                },
+                                "start_line": {
+                                  "type": "integer"
+                                },
+                                "truncated": {
+                                  "description": "The snippet was cut to its budget",
+                                  "type": "boolean"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "kind": {
+                              "type": "string"
+                            },
+                            "language": {
+                              "type": "string"
+                            },
+                            "name": {
+                              "type": "string"
+                            },
+                            "path": {
+                              "type": "string"
+                            },
+                            "qualified_name": {
+                              "type": "string"
+                            },
+                            "range": {
+                              "properties": {
+                                "end_line": {
+                                  "type": "integer"
+                                },
+                                "start_line": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "symbol_id": {
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "unresolved": {
+                          "items": {
+                            "additionalProperties": true,
+                            "type": "object"
+                          },
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.3"
+                          ],
+                          "type": "string"
+                        },
+                        "truncation": {
+                          "additionalProperties": true,
+                          "description": "Whether the answer was cut and how: the caps that applied, what was left out (e.g. `lists`, `depth_limited`, `items_without_text`, `candidates_dropped`) and, when a larger request would show more, the parameters to send next.",
+                          "properties": {
+                            "budget_tokens": {
+                              "type": "integer"
+                            },
+                            "candidates_dropped": {
+                              "type": "integer"
+                            },
+                            "definition_truncated": {
+                              "type": "boolean"
+                            },
+                            "depth": {
+                              "type": "integer"
+                            },
+                            "depth_limited": {
+                              "description": "Dependents not yet listed remain past the depth asked for",
+                              "type": "boolean"
+                            },
+                            "hint": {
+                              "type": "string"
+                            },
+                            "items_unavailable": {
+                              "description": "Items whose indexed content couldn't be read",
+                              "type": "integer"
+                            },
+                            "items_without_text": {
+                              "description": "Items the budget left as citations without text",
+                              "type": "integer"
+                            },
+                            "limit": {
+                              "type": "integer"
+                            },
+                            "limits": {
+                              "additionalProperties": {
+                                "type": "integer"
+                              },
+                              "type": "object"
+                            },
+                            "lists": {
+                              "description": "The answer's lists the caps cut",
+                              "items": {
+                                "type": "string"
+                              },
+                              "type": "array"
+                            },
+                            "next": {
+                              "additionalProperties": true,
+                              "description": "The request parameters to send for more: `limit`, `depth` or `budget_tokens`",
+                              "type": "object"
+                            },
+                            "references_cut": {
+                              "type": "boolean"
+                            },
+                            "seeds_dropped": {
+                              "type": "integer"
+                            },
+                            "truncated": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "truncated"
+                          ],
+                          "type": "object"
+                        },
+                        "view": {
+                          "properties": {
+                            "active": {
+                              "description": "The version queries answer from; null before the first is indexed",
+                              "nullable": true,
+                              "properties": {
+                                "base_commit": {
+                                  "pattern": "^[0-9a-f]{40}$",
+                                  "type": "string"
+                                },
+                                "indexed_at": {
+                                  "format": "date-time",
+                                  "type": "string"
+                                },
+                                "overlay_digest": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "kind": {
+                              "description": "A CLI worktree's overlay, or the repository's default branch, kept by the server",
+                              "enum": [
+                                "worktree",
+                                "default_branch"
+                              ],
+                              "type": "string"
+                            },
+                            "last_sync_at": {
+                              "format": "date-time",
+                              "nullable": true,
+                              "type": "string"
+                            },
+                            "pending": {
+                              "description": "A later sync still queued, indexing or failed",
+                              "nullable": true,
+                              "properties": {
+                                "error": {
+                                  "description": "Why indexing failed",
+                                  "nullable": true,
+                                  "properties": {
+                                    "failures": {
+                                      "description": "For a refresh, how many times it has failed",
+                                      "type": "integer"
+                                    },
+                                    "files": {
+                                      "description": "For `regressed`, how many files would lose their facts",
+                                      "type": "integer"
+                                    },
+                                    "message": {
+                                      "type": "string"
+                                    },
+                                    "reason": {
+                                      "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                                      "type": "string"
+                                    },
+                                    "retry_at": {
+                                      "description": "For a refresh, when the server tries it again",
+                                      "format": "date-time",
+                                      "type": "string"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "progress": {
+                                  "description": "Files processed so far (parsed or failed) of those the sync must parse, updated after each batch; null before indexing starts",
+                                  "nullable": true,
+                                  "properties": {
+                                    "done": {
+                                      "type": "integer"
+                                    },
+                                    "total": {
+                                      "type": "integer"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                "state": {
+                                  "type": "string"
+                                },
+                                "version": {
+                                  "type": "integer"
+                                }
+                              },
+                              "type": "object"
+                            },
+                            "repository_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_id": {
+                              "format": "uuid",
+                              "type": "string"
+                            },
+                            "view_key": {
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Explain a symbol",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/syncs": {
+      "post": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. Sends the view's overlay against a complete base: the whole overlay (`full`), or the changes to the active version (`delta`, which must name it as `parent_version`). Idempotent on `client_sync_id`: a retry answers with the same sync, whatever its state, and the blobs it still needs (none once activated). The request is not compared with the stored sync, so a `client_sync_id` names one exact manifest. A view holds at most 3 syncs receiving: opening another replaces any left unactivated for 10 minutes and, beyond that, the oldest. Activating a replaced sync answers 404 and its uploads 409 `unexpected_blob`; a retry with a replaced sync's id opens a new sync. A request carries at most 20,000 changes, and the resulting overlay holds at most 20,000 paths. Answers with the blobs still to upload; activate the sync once they have arrived. A JSON body may be sent gzip-compressed with `Content-Encoding: gzip`; the size limit applies to it inflated.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "properties": {
+                  "base_commit": {
+                    "pattern": "^[0-9a-f]{40}$",
+                    "type": "string"
+                  },
+                  "changes": {
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "language": {
+                          "nullable": true,
+                          "type": "string"
+                        },
+                        "mode": {
+                          "description": "The git file mode",
+                          "enum": [
+                            "100644",
+                            "100755",
+                            "120000"
+                          ],
+                          "type": "string"
+                        },
+                        "op": {
+                          "default": "put",
+                          "enum": [
+                            "put",
+                            "delete"
+                          ],
+                          "type": "string"
+                        },
+                        "path": {
+                          "description": "Repository-relative path",
+                          "type": "string"
+                        },
+                        "renamed_from": {
+                          "nullable": true,
+                          "type": "string"
+                        },
+                        "sha256": {
+                          "pattern": "^[0-9a-f]{64}$",
+                          "type": "string"
+                        },
+                        "size": {
+                          "minimum": 0,
+                          "type": "integer"
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "client_sync_id": {
+                    "description": "The client's id for this sync, for retries",
+                    "type": "string"
+                  },
+                  "mode": {
+                    "enum": [
+                      "full",
+                      "delta"
+                    ],
+                    "type": "string"
+                  },
+                  "parent_version": {
+                    "description": "The active version a `delta` applies to",
+                    "type": "integer"
+                  },
+                  "policy_digest": {
+                    "description": "The policy digest the client scanned under; a stale one is refused with 409 `stale_policy`",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "client_sync_id",
+                  "base_commit",
+                  "mode"
+                ],
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "missing": {
+                          "description": "The blobs still to upload",
+                          "items": {
+                            "pattern": "^[0-9a-f]{64}$",
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "rejected": {
+                          "description": "Malformed entries, e.g. `invalid_sha256`, `invalid_mode` or `invalid_op`",
+                          "items": {
+                            "properties": {
+                              "error": {
+                                "type": "string"
+                              },
+                              "path": {
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "state": {
+                          "type": "string"
+                        },
+                        "sync_id": {
+                          "format": "uuid",
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`invalid_sync`: a malformed sync, e.g. `base_commit` is not a full commit SHA, `parent_version` is not a non-negative integer, or more than 20,000 changes"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`not_view_owner`: another member's view; sync your own `view_key`; `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`stale_parent` (`details.active_version` is the version to delta against), `base_missing` (the base commit is not built yet; poll its status), `default_view` (the default-branch view is the server's) or `stale_policy`"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "The body exceeds the size limit (`payload_too_large`)"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`overlay_too_large` (`details.limit`: the view's overlay would pass the path limit; sync against a newer base commit) or `repository_not_connected`"
+          }
+        },
+        "summary": "Open a sync of a view",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/syncs/{sync_id}": {
+      "get": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:read` scope.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The sync's id",
+            "in": "path",
+            "name": "sync_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "error": {
+                          "description": "Why indexing failed",
+                          "nullable": true,
+                          "properties": {
+                            "failures": {
+                              "description": "For a refresh, how many times it has failed",
+                              "type": "integer"
+                            },
+                            "files": {
+                              "description": "For `regressed`, how many files would lose their facts",
+                              "type": "integer"
+                            },
+                            "message": {
+                              "type": "string"
+                            },
+                            "reason": {
+                              "description": "`regressed`: a refresh that would leave files without the facts the active version has; the view keeps that version",
+                              "type": "string"
+                            },
+                            "retry_at": {
+                              "description": "For a refresh, when the server tries it again",
+                              "format": "date-time",
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "mode": {
+                          "description": "`refresh`: the server re-indexing the view after an extractor change",
+                          "enum": [
+                            "full",
+                            "delta",
+                            "refresh"
+                          ],
+                          "type": "string"
+                        },
+                        "overlay_digest": {
+                          "type": "string"
+                        },
+                        "received_bytes": {
+                          "type": "integer"
+                        },
+                        "state": {
+                          "enum": [
+                            "receiving",
+                            "queued",
+                            "indexing",
+                            "active",
+                            "superseded",
+                            "failed"
+                          ],
+                          "type": "string"
+                        },
+                        "timings": {
+                          "additionalProperties": true,
+                          "type": "object"
+                        },
+                        "version": {
+                          "nullable": true,
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "description": "Token not permitted (org-scoped, non-admin, or missing scope); `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Get a sync",
+        "tags": []
+      }
+    },
+    "/api/v1/code/views/{view_id}/syncs/{sync_id}/activate": {
+      "post": {
+        "callbacks": {},
+        "deprecated": false,
+        "description": "Requires the `harness:write` scope. Queues a sync whose content has all arrived for indexing, as the view's next version; it becomes the active version once indexed, unless a later one has. Idempotent per sync: one already activated answers with its state and the version it was given once. A 404 means the view holds no such sync. A sync replaced while receiving was never activated, and an activated one is kept at least 60 minutes: as long as it is active, 24 hours while queued, indexing or failed, and 60 minutes once superseded. So a 404 on a retry within that time means the sync was replaced while receiving; later it can also mean retention swept it, so read the view's active version before syncing again.",
+        "parameters": [
+          {
+            "description": "The view's id",
+            "in": "path",
+            "name": "view_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The sync's id",
+            "in": "path",
+            "name": "sync_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success"
+          },
+          "202": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "data": {
+                      "properties": {
+                        "pending_version": {
+                          "type": "integer"
+                        },
+                        "state": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "meta": {
+                      "properties": {
+                        "contract": {
+                          "enum": [
+                            "1.2"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "Queued for indexing"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Missing or invalid token"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`not_view_owner`: another member's view; sync your own `view_key`; `code_index_disabled` while the code index is off"
+          },
+          "404": {
+            "description": "Not found"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "details": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "nullable": true,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              }
+            },
+            "description": "`missing_blobs`: `details.missing` names the blobs still to upload"
+          },
+          "422": {
+            "description": "Validation error"
+          }
+        },
+        "summary": "Activate a sync",
+        "tags": []
+      }
     }
   },
   "security": [