Repository navigation
Description
Problem
config-sync overwrites renovate.json5 byte-for-byte, so every repo-local packageRules, customManagers or limit is deleted on the next sync. A read-only study of the 40 config-sync callers (2026-11-16) found real local Renovate config in at least 11 of them. About 20 more differ only because they are stale.
Sync PRs that drop local Renovate config and are on hold:
- chore: sync config files from central repo truenas-apps#978 (91 lines: db-backup v4 pin, Meilisearch review rule, digest rules; caught by its BATS source-policy test)
- chore: sync config files from central repo grip-visualizer#124 (packageRules, including the
@testing-library/user-eventabandonment false positive) - DevSecNinja/gh-repo-hub#56 (customManagers for the vendored json5 build)
- chore: sync config files from central repo ESPHome-Zehnder-RF#67 (Python matrix customManager and
rangeStrategy: replace) - DevSecNinja/notes#23
- chore: sync config files from central repo home-assistant-ovapi#61 (Python
<3.15hold, minimum fixture disabled) - chore: sync config files from central repo lovelace-ovapi#88 (engines replace, TypeScript
<6.1.0, HA manifest pins disabled)
Four repos (ai-toolkit, scratchpad, az-vm-start-stop, deckio-digital-security) already ignore the whole file and therefore miss central changes. DevSecNinja/hadiscover#450 merged with its limits dropped (accepted by the owner).
Renovate reads only the first config file it finds, and a preset cannot reference "this repository" without hard-coding the repo name (templated preset paths need a self-hosted env). A second local file or a self-referencing preset is not an option.
Proposed solution
Use Renovate's own composition and stop overwriting the file:
-
Add
.renovate/default.json5that extends today's list (config:recommended,helpers:pinGitHubActionDigests,:dependencyDashboard,:semanticCommits,:semanticCommitTypeAll(build)and the sevengithub>DevSecNinja/.github//.renovate/*.json5presets). -
Move
config-sync/files/renovate.json5toconfig-sync/templates/renovate.json5as a stub:{ $schema: "https://docs.renovatebot.com/renovate-schema.json", extends: ["github>DevSecNinja/.github//.renovate/default.json5"], // Repo-local packageRules / customManagers go below. }
-
Drift check: config-sync (or a repo-steward baseline rule) warns when
renovate.json5does not extendgithub>DevSecNinja/.github//.renovate/default.json5. No content diffing. -
Document the local-rules convention in
config-sync/templates/README.mdanddocs/architecture.md. -
One-time stub PRs in the repos with local rules, then remove their
renovate.json5ignores.
Caveat: templates only bootstrap when the caller sets sync-templates: true. Either bootstrap renovate.json5 regardless of that input, or rely on repo-starter for new repos.
Breaking (feat!): repos stop receiving preset-list changes through config-sync until they adopt the stub. Needs owner approval before implementation.
Effort: S (about 0.5 to 1 day) plus stub PRs in about 11 repos.
Alternatives considered
- Marker-delimited local block (
// config-sync: local-begin/local-end) spliced by config-sync. Feasible, but Renovate's config-migration PRs rewrite the file and the splice must land inside the JSON5 object. Estimated M (about 2 days) with bats tests. Revisit only if 3 or more repos need partial local content in another synced file. - Whole-file ignore: what four repos do today. They miss every central change.
- Mend-hosted inherited org config (
renovate-configrepo): not verified for this setup and changes the architecture.
Source: config-sync local overrides study (2026-11-16), shared in the coordinating session. Related: #511 (lint excludes), #512 (engines), #510 (TypeScript cap).
Activity
DevSecNinja commentedon Nov 16, 2026
Owner decision (2026-11-16): approved. Implementation is starting.
Related decision for #512:
enginesdeclares the supported range only, and mise pins the exact development and CI version. Renovate should userangeStrategy: "replace"forenginesand never pin it.feat(renovate)!: make renovate.json5 a create-only stub over a centra…