# velocirepo gate


Run the nightly fetch in GitHub Actions: check the commits made since the last run, fetch, check the night's changes, commit the data, concatenate on or after the concatenation day in a commit of its own, push, and report in the tracking issue labelled velocirepo`-h`ealth. A night only adds data. With \[settings\] gate = "enforce", removed records are restored, changed values keep their stored value, and the new records of a source and project with an error about them are held back in velocirepo/held-back/ until they pass, or a manual run releases (`--release`) or discards (`--discard`) them. Without it, the gate only reports what it would do, and commits everything, as fetch does. GITHUB_TOKEN is the token velocirepo fetches with. The tracking issue and the archive use the workflow token, from `--repo-token` or VELOCIREPO_REPO_TOKEN.


``` bash
velocirepo gate [OPTIONS]
```


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Run the nightly fetch in GitHub Actions: check the commits made since the last run, fetch, check the night's changes, commit the data, concatenate on or after the concatenation day in a commit of its own, push, and report in the tracking issue labelled velocirepo-health.

    A night only adds data. With [settings] gate = "enforce", removed records are restored, changed values keep their stored value, and the new records of a source and project with an error about them are held back in velocirepo/held-back/ until they pass, or a manual run releases (--release) or discards (--discard) them. Without it, the gate only reports what it would do, and commits everything, as fetch does.

    GITHUB_TOKEN is the token velocirepo fetches with. The tracking issue and the archive use the workflow token, from --repo-token or VELOCIREPO_REPO_TOKEN.

    Usage:
      velocirepo gate [flags]

    Flags:
          --archive string      archive the responses in this directory (default: $RUNNER_TEMP/velocirepo-archive)
          --discard string      delete a project's held-back data, so it's fetched again: <source>/<project> (default: $VELOCIREPO_DISCARD)
      -h, --help                help for gate
          --no-concatenate      don't concatenate
          --no-reconcile        don't compare stored totals with the APIs' own totals
          --release string      land a project's held-back data regardless of its findings: <source>/<project> (default: $VELOCIREPO_RELEASE)
          --repair string       re-fetch or replay a range: <source>/<project> <from>..<to> (default: $VELOCIREPO_REPAIR)
          --repo string         the data repository, owner/name (default: $GITHUB_REPOSITORY)
          --repo-token string   a token for the data repository (default: $VELOCIREPO_REPO_TOKEN)

    Global Flags:
          --config string   config file (default: walk up for velocirepo.toml)
      -q, --quiet           suppress progress output
      -v, --verbose         enable debug logging


## Options


`--archive: string = $RUNNER_TEMP/velocirepo-archive`  
archive the responses in this directory

`--discard: string = $VELOCIREPO_DISCARD`  
delete a project's held-back data, so it's fetched again:

/

`-h, --help`  
help for gate

`--no-concatenate`  
don't concatenate

`--no-reconcile`  
don't compare stored totals with the APIs' own totals

`--release: string = $VELOCIREPO_RELEASE`  
land a project's held-back data regardless of its findings:

/

`--repair: string = $VELOCIREPO_REPAIR`  
re-fetch or replay a range:

/ ..

`--repo: string = $GITHUB_REPOSITORY`  
the data repository, owner/name

`--repo-token: string = $VELOCIREPO_REPO_TOKEN`  
a token for the data repository

`--config: string = walk up for velocirepo.toml`  
config file

`-q, --quiet`  
suppress progress output

`-v, --verbose`  
enable debug logging