Skip to content

Self-improving AI Employees for everyone

ci(dependabot): security updates only - end the weekly version-bump flood

trohitg9ac8768b6806
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index eb8f69bc..a71ca2cc 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -1,43 +1,50 @@
+# Dependabot policy: SECURITY UPDATES ONLY.
+#
+# Version-update PRs are deliberately disabled (open-pull-requests-limit: 0).
+# History: weekly version bumps produced 12-26 PRs/week, ~89% closed unmerged
+# (105 PRs May-Aug 2026; see docs-internal/ci_cd.md "Dependency update
+# policy"). Dependencies move deliberately, alongside test runs - not
+# piecemeal. Security PRs are NOT affected by the limit or the schedule:
+# they open as soon as a fixable vulnerability is disclosed.
+#
+# Do not "fix" the 0 limits without reading the ci_cd.md section first.
version: 2
updates:
+ # npm - the root pnpm workspace covers package.json, client/, and
+ # server/nodejs/ through the single pnpm-lock.yaml. (A former `/server`
+ # entry pointed at a manifest deleted in d0e1b816 and was removed.)
- package-ecosystem: npm
directory: /
schedule:
interval: weekly
- cooldown:
- default-days: 7
+ open-pull-requests-limit: 0
groups:
- production-dependencies:
- dependency-type: production
- development-dependencies:
- dependency-type: development
+ npm-security:
+ applies-to: security-updates
+ patterns: ["*"]
- - package-ecosystem: npm
- directory: /server
- schedule:
- interval: weekly
- cooldown:
- default-days: 7
-
- - package-ecosystem: pip
- directory: /
- schedule:
- interval: weekly
- cooldown:
- default-days: 7
-
- # The server intentionally does not commit uv.lock; Dependabot therefore
- # maintains its PEP 621 pyproject constraints through the pip ecosystem.
+ # pip - the server runtime. Authoritative manifest: server/pyproject.toml;
+ # the committed requirements.txt (a `uv export` of the transitive tree)
+ # doubles as the pinned surface security updates can patch. (A former root
+ # `pip: /` entry never updated the root CLI pyproject - its >= floors need
+ # no PRs - and only re-bumped server/requirements.txt, duplicating this
+ # entry's PRs; it was removed.)
- package-ecosystem: pip
directory: /server
schedule:
interval: weekly
- cooldown:
- default-days: 7
+ open-pull-requests-limit: 0
+ groups:
+ pip-security:
+ applies-to: security-updates
+ patterns: ["*"]
- package-ecosystem: github-actions
directory: /
schedule:
interval: weekly
- cooldown:
- default-days: 7
+ open-pull-requests-limit: 0
+ groups:
+ actions-security:
+ applies-to: security-updates
+ patterns: ["*"]
diff --git a/docs-internal/ci_cd.md b/docs-internal/ci_cd.md
index c7ac703a..bb33a067 100644
--- a/docs-internal/ci_cd.md
+++ b/docs-internal/ci_cd.md
@@ -152,11 +152,37 @@ folder — both the folder and the workflow are gone.
| `.github/workflows/predeploy.yml` | Reusable validation (build/lint + backend tests + CLI tests + OS matrix build/start) |
| `.github/workflows/release.yml` | Tag / manual release: predeploy gate → publish npm + GitHub Packages |
| `.github/actions/setup/action.yml` | Composite: pnpm + Node + Python + uv + editable CLI install |
-| `.github/dependabot.yml` | Weekly npm, Python, and GitHub Actions update coverage |
+| `.github/dependabot.yml` | **Security updates only** — version-update PRs disabled; see below |
| `.python-version` | Toolchain pin (`3.12`) — single source of truth |
---
+## Dependency update policy (security-only)
+
+Dependabot raises **security PRs only**; routine version bumps are disabled
+(`open-pull-requests-limit: 0` on every entry — the limit affects version
+updates only; security PRs are exempt from both the limit and the schedule
+and are grouped per ecosystem via `applies-to: security-updates`).
+
+Three entries cover the real surfaces: `npm /` (pnpm workspace spans root +
+`client/` + `server/nodejs/`), `pip /server` (authoritative
+`server/pyproject.toml`; the committed `requirements.txt` export is the
+transitive-pin surface security fixes patch), `github-actions /`. A former
+`pip: /` entry (duplicate churn against `server/requirements.txt`) and a
+dead `npm: /server` entry were removed.
+
+Repo-level alerts + security updates must stay enabled — verify with
+`gh api repos/zeenie-ai/OpenCompany/vulnerability-alerts` (204 = enabled).
+
+Re-enable version updates deliberately, never by just deleting the limits:
+raise `open-pull-requests-limit`, set `schedule.interval: monthly`, add
+`groups` with `patterns: ["*"]` + `update-types: [minor, patch]`, and
+`cooldown: {semver-major-days: 30}`. Stored comment-ignores (`mcp` 2.x,
+`websockets` 17.x) are inspectable via `@dependabot show <dep> ignore
+conditions`.
+
+---
+
## Planned (not yet implemented)
The following existed in earlier drafts of this doc but are **not present in the current repo**. Listed here so the intent is preserved without misrepresenting the shipped pipeline: