Skip to main content

Github

@hivemq/githubv2026.07.30.1785404499· 23d agoMODELSREPORTS
01README

GitHub models for swamp. @hivemq/github/token audits a single GitHub token. A token model instance is bound to one token (supplied inline or read from a file at audit time). Its audit method calls the API as that token and records validity, the token type inferred from the secret prefix (classic PAT, fine-grained PAT, OAuth, GitHub App user/installation), the issuing app (OAuth client id), and the acting identity (login and account), so you can identify what a token is and where it came from without exposing its value. @hivemq/github/dependabot/alerts, @hivemq/github/code-scanning/alerts, and @hivemq/github/secret-scanning/alerts mirror the corresponding /repos/{owner}/{repo}//alerts endpoints: each list method fetches a set of repos' open alerts and writes one normalized resource per repo ({number, htmlUrl, title, severity}, plus unavailable/truncated markers). The bundled @hivemq/github-security-alerts workflow report merges the three models' resources from one workflow run into per-repo Slack Block Kit payloads, ready to post via a Slack model. @hivemq/github/security-alerts merges one run of the three alert models (wired in as their run aggregates via workflow CEL) into gated per-repo Slack payloads: its build method verifies every requested repo is covered by every scanner, fails loud on gaps, and writes payloads with JSON-stringified blocks ready for a Slack model's postBlocks.

02Models5
@hivemq/github/tokenv2026.07.29.1github/token.ts
fn audit()
Audit the configured GitHub token: report validity, token type, issuing app (client ID), and the acting identity (login/account)

Resources

tokenAudit(infinite)— Audit result for a GitHub token: validity, type, issuing app, and acting identity
@hivemq/github/security-alertsv2026.07.29.1github/security-alerts.ts

Global Arguments

ArgumentTypeDescription
orgstringGitHub organization the scanner runs must belong to
fn build(repos: array)
Verify the three scanner runs cover every requested repo in the configured org, then write one Slack payload per repo with open alerts. Fails loud on any coverage gap.
ArgumentTypeDescription
reposarrayRepo names (bare, without org) that every scanner run must cover; the

Resources

payloads(infinite)— Gated per-repo Slack payloads built from one run of the three alert models
@hivemq/github/dependabot/alertsv2026.07.29.1github/dependabot/alerts.ts
fn list()
List open Dependabot alerts for each given repo and write one alerts resource per repo. Repos where Dependabot alerts are disabled are recorded as unavailable, not errors.

Resources

alerts(infinite)— Open Dependabot alerts for one repository
run(infinite)— Aggregate of one list invocation: every requested repo's document
@hivemq/github/code-scanning/alertsv2026.07.29.1github/code-scanning/alerts.ts
fn list()
List open code scanning alerts for each given repo and write one alerts resource per repo. Repos without code scanning set up are recorded as unavailable, not errors.

Resources

alerts(infinite)— Open code scanning alerts for one repository
run(infinite)— Aggregate of one list invocation: every requested repo's document
@hivemq/github/secret-scanning/alertsv2026.07.29.1github/secret-scanning/alerts.ts
fn list()
List open secret scanning alerts for each given repo, including non-provider and AI-detected generic patterns (which the API excludes from the default listing), and write one alerts resource per repo. Repos where secret scanning is disabled are recorded as unavailable, not errors.

Resources

alerts(infinite)— Open secret scanning alerts for one repository
run(infinite)— Aggregate of one list invocation: every requested repo's document
03Reports1
@hivemq/github-security-alertsworkflow
github_security_alerts.ts

Merge the security-audit workflow's per-repo open-alert resources (Dependabot, code scanning, secret scanning) into one Slack Block Kit payload per repo with open alerts.

securitygithubalertsslack
04Previous Versions2
2026.07.27.1785145602
2026.05.22.67
05Stats
B
85 / 100
Downloads
67
Archive size
158.9 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
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository0/2missing
06Platforms
07Labels