land_group#

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "`land_group` (CLI `land-group`): lands `changes`, in order, onto `target` as one operation:\neach change merged onto what the clean ones before it make, as\n`land_check` plans them, the clean ones recorded as a chain of landed changesets, each on the\none before, with one move of `target` to the last. A conflicting change is reported and\npassed over; a replayed one, or one with nothing to land, lands nothing. A group with no\nclean change is `E_NOTHING_TO_LAND`, each change's outcome in `details.items`. A target that\nmoves after the plan makes the group plan again, up to `max_attempts`.",
  "properties": {
    "changes": {
      "description": "The changes, in the order they land: 1 to 32 (`E_INVALID_ARG` for none, `E_TOO_LARGE`\npast 32), each key once.",
      "items": {
        "description": "One change of a `land_check`: as `land` takes it.",
        "properties": {
          "base": {
            "anyOf": [
              {
                "description": "A revision as the caller wrote it, for the store to resolve: a ref name (`main`,\n`release/1.2`), a full 64-hex changeset id or a unique prefix of at least 12 hex digits, or a\nref's earlier value: `<ref>@{N}` the value it held N moves before its current one (`@{0}`\nis the current value), `<ref>@{at=<unix seconds>}` the value set by its newest move\nrecorded at or before that instant (the writer's clock, moves read in journal order);\noptionally followed by `~N` for the N-th first-parent ancestor.",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the change starts, as a land's `base`. When omitted, the merge base of `head` and\nthe target's head, along first parents."
          },
          "head": {
            "description": "The change's head. A revision as the caller wrote it, for the store to resolve: a ref name (`main`,\n`release/1.2`), a full 64-hex changeset id or a unique prefix of at least 12 hex digits, or a\nref's earlier value: `<ref>@{N}` the value it held N moves before its current one (`@{0}`\nis the current value), `<ref>@{at=<unix seconds>}` the value set by its newest move\nrecorded at or before that instant (the writer's clock, moves read in journal order);\noptionally followed by `~N` for the N-th first-parent ancestor.",
            "type": "string"
          },
          "idempotency_key": {
            "description": "The change's land key, as a land's: one the target holds a land of is `replayed`.",
            "type": [
              "string",
              "null"
            ]
          },
          "message": {
            "description": "The landed changeset's message, as a land's; a check does not use it.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "head"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "max_attempts": {
      "default": 8,
      "description": "How many times the group plans and publishes at most before `E_CAS_RETRY_EXHAUSTED`:\n1 to 32.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "max_conflict_bytes": {
      "default": 32768,
      "description": "The most bytes of hunk text each conflicting change's report carries, as a land's.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "target": {
      "default": "main",
      "description": "The ref the changes land on: `main` or `release/<name>`, which must exist.",
      "type": "string"
    }
  },
  "required": [
    "changes"
  ],
  "title": "LandGroupReq",
  "type": "object"
}