Forgejo Commits
@reset/forgejo-commitsv2026.10.24.1
01README
Record a Forgejo or Gitea branch's commits and head over time.
02Behaviors
@reset/forgejo-commitsv2026.10.24.1forgejo_commits.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| host | string | Base https URL of the Forgejo or Gitea host, e.g. https://codeberg.org; the API is under /api/v1 |
| token? | string | Optional access token for a private repository, supplied with a vault.get expression, never a literal. Sent only as an Authorization token header |
fn sample(owner: string, repo: string, ref?: string, depth?: number)
Read a branch's newest commits from the host's /api/v1 commits endpoint and record them with the head as a new version
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner, the user or organisation, e.g. forgejo |
| repo | string | Repository name, e.g. forgejo |
| ref? | string | Branch, tag or sha to read from, e.g. main; the repository's default branch when omitted |
| depth? | number | How many of the newest commits to record, 1 to 500; 50 when omitted |
fn summarise(owner: string, repo: string, ref?: string, since?: string)
Summarise the recorded samples of a branch: head moves, distinct commits, commits per day and commits per author
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner, the user or organisation, e.g. forgejo |
| repo | string | Repository name, e.g. forgejo |
| ref? | string | The branch, tag or sha whose samples to summarise; the default branch when omitted |
| since? | string | Only summarise samples recorded at or after this ISO-8601 time; all samples when omitted |
Resources
commits(infinite)— One branch's newest commits and head at one moment, flagging the commits new since the previous version and whether the head moved
summary(infinite)— How often a branch's head moved, the distinct commits seen, the commits per day and the commits per author over the recorded samples
03Stats
B
87 / 100
Downloads
3
Archive size
18.7 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository0/2missing
behavior-spelling1 accepted
- (extension) — Written against swamp 20261020.024627.0, the release that added the behavior spelling. Consumers on an older swamp are not supported.
05Platforms
06Labels