overlane repo events | Overlane Docs

Lists the repository’s ordered events (pushes, branch creates and deletes, forced updates) with the commits before and after and who did it. Use –after with the last sequence you saw to read only what is new.

Usage

overlane repo events repo [--after SEQUENCE]

Arguments

Argument	Required	Description
`repo`	yes	The repository name or ID

Flags

Flag	Type	Required	Default	Description
`--after`	string	no		Only events after this sequence number (default 0)

Examples

overlane repo events app
overlane repo events app --after 40 --json

Behavior

Effect: read (changes nothing).
Needs credentials: yes. Uses the network: yes.
Supports --dry-run: no. Accepts --force: no.
Machine-readable description: overlane schema repo events.

Result

With --json (the default when stdout is not a terminal) the command prints this JSON Schema’s shape on stdout.

{
  "type": "object",
  "properties": {
    "tenantId": {
      "type": "string"
    },
    "repoId": {
      "type": "string"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "type": "string",
            "const": "1"
          },
          "tenantId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
            "description": "tenant identifier"
          },
          "repoId": {
            "type": "string",
            "pattern": "^repo_[A-Za-z0-9]{6,40}$"
          },
          "eventId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "sequence": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "kind": {
            "type": "string",
            "enum": [
              "push",
              "branch_created",
              "branch_deleted",
              "force_push",
              "pr_opened",
              "pr_updated",
              "pr_merged",
              "pr_closed",
              "import_completed",
              "mirror_synced"
            ]
          },
          "ref": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "beforeSha": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$"
              },
              {
                "type": "null"
              }
            ]
          },
          "afterSha": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$"
              },
              {
                "type": "null"
              }
            ]
          },
          "forced": {
            "type": "boolean"
          },
          "actor": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "user",
                      "agent"
                    ]
                  },
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                },
                "required": [
                  "kind",
                  "id"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
          }
        },
        "required": [
          "schemaVersion",
          "tenantId",
          "repoId",
          "eventId",
          "sequence",
          "kind",
          "ref",
          "beforeSha",
          "afterSha",
          "forced",
          "actor",
          "at"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "tenantId",
    "repoId",
    "events"
  ],
  "additionalProperties": false
}

See exit codes for the status the process returns.