vendoo/docs/PRODUCTION_UPDATER_3_1.md

Vendoo Production Updater 3.1

Architekturwechsel

Updater 3.1 verwendet keine Ausschlusslisten-Kopie und leert die geklonte main-Arbeitskopie nicht mehr.

Der Release enthält release-manifest.json mit:

• jeder auszuliefernden Quelldatei,
• Dateigröße,
• SHA-256-Prüfsumme,
• verbindlichen Pflichtdateien,
• ausschließlich expliziten Löschungen in removedFiles.

Anwendung

1. main wird in einen isolierten Arbeitsordner geklont.
2. Das gesamte Paket wird gegen release-manifest.json geprüft.
3. Sichere Paketdateien, die nicht im Manifest stehen, blockieren das Update.
4. Manipulierte oder fehlende Dateien blockieren das Update.
5. Der Release wird als Overlay angewendet; bestehende Baseline-Dateien bleiben erhalten.
6. Nur Einträge in removedFiles werden gelöscht.
7. Jede kopierte Datei wird im Ziel erneut per SHA-256 geprüft.
8. Erst danach laufen npm ci und npm run verify:all.

Pflichtdateien

Unter anderem müssen immer vorhanden sein:

• db/schema.sql
• lib/db.mjs
• package.json
• package-lock.json
• server.mjs
• bootstrap.mjs
• Updater-Preflight, UI, Host und Worker

Sitzungen

Sitzungsstände der Updater-2.x-Reihe werden nicht übernommen. Updater 3.1 beginnt mit einem neuen Release-Branch und einer neuen, versionsgebundenen Sitzung.