launcher-next/docs/architecture/package-activation.md

Package activation

Before changing package pointers, Launcher Next writes an activation snapshot containing exact previous current.json and previous.json contents and their SHA-256 values. Files are copied to a unique staging directory and rehashed. Only then is staging moved to packages/<package>/versions/<version> and the package-local pointer updated atomically.

Rollback restores the exact pointers, deletes the pilot version and startup script, and removes incomplete staging. Autodesk assemblies, PDBs, executables, test assemblies and legacy files are rejected from the pilot package.