Switch and Roll Back Precisely

Prepare both sides of the switch

The supported web-profile model keeps one direct @dsh-themes/* package active. Switching removes the previous package before adding the target, so recovery must be prepared before the first mutation.

1. 01

   Inspect and identify the current state

   Read the direct package name and exact version from the web profile. Stop if dependencies are ambiguous or version ranges are present.

2. 02

   Verify the target artifact

   Match the controlled download to its complete artifact SHA-256, manifest identity, exact compatibility, slug, and version.

3. 03

   Verify the previous artifact

   Prepare the exact old tgz and digest, or record that the previous state is the built-in palette with no @dsh-themes/* package.

4. 04

   Write the rollback record

   Record previous and target identities plus absolute verified artifact paths and complete-artifact digests. Do not include profile contents or credentials.

5. 05

   Confirm the mutation

   Review current, target, compatibility, and prepared rollback information before removing anything.

node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs plugin --profile web remove @dsh-themes/current-theme
node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs plugin --profile web add /absolute/path/to/verified-target.tgz --save-exact
node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs plugin --profile web list --json
node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs --profile web --dump-config

Roll back only from a matching state

1. 01

   Validate the record

   Reject malformed, incomplete, moved, or mismatched artifact references before changing the profile.

2. 02

   Confirm the current target still matches

   Do not consume a rollback record against a profile that has changed independently since the switch.

3. 03

   Re-verify the previous artifact

   Check the complete bytes again immediately before installation. Payload hashes are not substitutes.

4. 04

   Remove the target and restore the exact prior state

   Install the prior exact package, or leave no @dsh-themes/* package when returning to the built-in palette.

5. 05

   Restart and verify

   Confirm one expected direct dependency, inspect the dumped configuration, restart DSH, and verify the real runtime identity.