LumaOps-Public/docs/OPENRGB_UPSTREAM_SYNC.md

OpenRGB upstream synchroniseren

De repository heeft origin voor deze LumaOps-repo en upstream voor de officiële OpenRGB GitLab-repository. Tag upstream-openrgb-1.0rc3 markeert de originele baseline.

Eisen:

• OpenRGB blijft de core hardware-engine en volgt upstream-architectuur.
• Forkwijzigingen blijven minimaal.
• Afwijkingen t.o.v. upstream worden gelogd in CORE_PATCHES en SOURCE_AUDIT.

1. Controleer de upstream-remote.

git remote -v
git fetch --tags upstream

2. Maak een onderhoudsbranch.

git switch -c maintenance/openrgb-VERSIE

3. Breng upstream binnen via een gecontroleerde merge.

git merge --no-commit upstream/master

4. Valideer dat alleen geautoriseerde core-bestanden afwijken.

OPENRGB_BASELINE_TAG=upstream-openrgb-1.0rc3 ./scripts/openrgb-upstream-guard.sh

Of op Windows:

$env:OPENRGB_BASELINE_TAG="upstream-openrgb-1.0rc3"
.\scripts\openrgb-upstream-guard.ps1

Deze controle draait automatisch in CI via:

• /.github/workflows/openrgb_upstream_compat_guard.yml op pull_request en push voor main/master.

5. Voer daarna de inhoudelijke review uit op:

• NetworkProtocol.*
• NetworkServer.*
• PluginManager.*
• RGBController.*
• SettingsManager.*
• ProfileManager.*
• cli.*
• alle controller- en detectorregistraties.

6. Pas de forkpatch (headless stop-handler) opnieuw toe of verwijder hem als upstream dat gedrag inmiddels bevat.

7. Bepaal compatibiliteitstesten:

• compileer OpenRGB-core,
• draai backend/frontendtests,
• bouw de container,
• voer read-only inventarisatie uit op hardware,
• voer daarna minimaal één non-destructieve kleuractie op fysiek apparaat uit.

8. Als stap 4 mislukt, stop en onderzoek de drift direct.

Gebruik nooit een blinde subtree-overschrijving.