Skip to content

fix: support legacy runtime migration during npm upgrades - #136

Merged
jeremymcs merged 8 commits into
mainfrom
jeremymcs/verify-npm-upgrade-validity
Sep 21, 2026
Merged

jeremymcs merged 8 commits into
mainfrom
jeremymcs/verify-npm-upgrade-validity

Conversation

@jeremymcs

@jeremymcs jeremymcs commented Sep 21, 2026

Copy link
Copy Markdown
Member

Legacy projects using .gsd-path/runtime/ failed during npm upgrades with a rollback message. The installer now checks before writing, offers explicit migration consent in the wizard, and supports migration followed by the update. Unattended upgrades print the exact recovery command. Migration preserves local edits, leaves a reviewable Git diff, and remains separate from installation rollback. Later updates preserve the selected runtime.

Installer-only changes now reuse valid host workflow receipts. Installation, migration, rollback, runtime pinning, and installed guards remain covered by the offline gate. Changes to installed skills, adapters, guard implementations, workflow runtime, host manifests, or package contents keep their existing live-check requirements. Missing or invalid evidence still blocks release, and the full matrix remains available explicitly.

Prepares 1.3.0.

Validation:

  • Installer and runtime lifecycle regression coverage includes consent/cancel, dry run, local-edit protection, migration recovery, and pin preservation.
  • New receipt-validator tests failed before the scope fix, passed afterward, and failed again when the rule was deliberately removed and restored.
  • Mixed installer/adapter changes select only the affected host; shared workflow changes select all hosts; invalid or missing receipts remain blocking.
  • The release plan validates all existing receipts with required_runs: []; no new live host runs are required.
  • Independent validation passed 83 Python tests, 64 Node tests, and real terminal upgrade scenarios.
  • All seven PR checks passed, including the full offline gate on Node 18 and Node 20.

Prepare the 1.3.0 minor release. Ask for explicit migration consent in the wizard, preflight legacy projects before writes, and continue into the update after migration. Preserve local edits and selected runtimes on later updates.
@jeremymcs jeremymcs changed the title fix: support legacy project runtime upgrades feat: migrate legacy runtimes during upgrades Sep 21, 2026
@jeremymcs jeremymcs changed the title feat: migrate legacy runtimes during upgrades fix: support legacy runtime migration during npm upgrades Sep 21, 2026
@jeremymcs
jeremymcs merged commit beef800 into main Sep 21, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant