Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
21 lines
1.3 KiB
Markdown
21 lines
1.3 KiB
Markdown
---
|
|
id: 31
|
|
title: Update System
|
|
group: Utility Features
|
|
---
|
|
|
|
**Command:** `/msd-update`
|
|
|
|
**Purpose:** Update MSD to the latest version with changelog preview.
|
|
|
|
**Requirements:**
|
|
- REQ-UPDATE-01: System MUST check for new versions via npm
|
|
- REQ-UPDATE-02: System MUST display changelog for new version before updating
|
|
- REQ-UPDATE-03: System MUST be runtime-aware and target the correct directory
|
|
- REQ-UPDATE-04: System MUST back up locally modified files to `msd-local-patches/`
|
|
- REQ-UPDATE-05: `/msd-update --reapply` MUST restore local modifications after update
|
|
- REQ-UPDATE-06: `/msd-update --next` (alias `--rc`) MUST target the `@next` RC dist-tag for version check and install; omitting the flag MUST keep `@latest` behavior unchanged (ADR #660)
|
|
- REQ-UPDATE-07: System MUST back up user-added files found inside MSD-managed directories to `msd-user-files-backup/` before the clean install
|
|
- REQ-UPDATE-08: When that backup is non-empty, the update MUST offer an explicit restore choice before finishing, and MUST leave the backup intact whichever way the user answers
|
|
- REQ-UPDATE-09: A restore MUST NOT overwrite a path the newly installed release ships, MUST NOT overwrite a different file already on disk, and MUST report best-effort compatibility warnings for restored files without blocking on them
|