diff --git a/README.md b/README.md index 627ba1d..d8d5a17 100644 --- a/README.md +++ b/README.md @@ -155,15 +155,18 @@ reasonable start; check with `ollama ps` on that machine that the model is fully `gitlib dependabot check` reports which open [Dependabot](https://docs.github.com/code-security/dependabot) pull requests on your **starred** repositories can be merged and which need work. "Starred" is the Star toggle in gitlib (`repo_favorites`), not GitHub stars, and only favorites with a github.com remote can be watched; the report says -how many were skipped and why. It is report-only: nothing is written to GitHub or to gitlib's database, no model is -involved, and the verdict comes only from fields GitHub returns (never from the PR text, which quotes third-party -release notes). The research and the reasoning behind it are in -[`docs/dependabot-watch.md`](docs/dependabot-watch.md). +how many were skipped and why. Nothing is ever written to GitHub, and the verdict comes only from fields GitHub +returns (never from the PR text, which quotes third-party release notes). The research and the reasoning behind it +are in [`docs/dependabot-watch.md`](docs/dependabot-watch.md). ```bash export GITLIB_GITHUB_TOKEN=... # or GITHUB_TOKEN; GitHub's GraphQL API does not answer without one -gitlib dependabot check # grouped by bucket, with reasons and suggested actions +gitlib dependabot check # asks GitHub, saves the result, prints it grouped by bucket gitlib dependabot check --json # the same, machine-readable +gitlib dependabot check --no-save # print only; nothing is stored and no lock is taken +gitlib dependabot show [--json] # the newest saved check, without contacting GitHub +gitlib dependabot dismiss meddlin/gitlib#41 [--until 2026-12-01] # put a PR aside +gitlib dependabot restore meddlin/gitlib#41 ``` | Bucket | Meaning | @@ -179,11 +182,20 @@ PRs, plus one small lookup that tells which watched repositories your token cann few points of the 5,000 an hour; the report prints the actual cost. Anything it could not check is listed under `NOT CHECKED` or `INCOMPLETE` rather than left out, and the command exits with status 1 if a whole owner failed. +**Saved runs.** Each check is stored in `gitlib.db` (`dependabot_runs`, `dependabot_findings`; the newest 60 runs +are kept) so the findings can be read offline and compared over time; they are derived from GitHub and can be fetched +again. If one owner cannot be asked (network, rate limit), the last findings for its repositories are kept, marked +`last seen