DashboardcliToolkit migration invariants

Toolkit migration invariants

Category: preference
Confidence: 1.00
ID: 01a08874-2388-7f32-aedb-f18fe7771749
Project ID: c760f4f9-42b0-4ce0-b36d-6b8c38d770b2
Cross-project: No
Recalled in other projects: 0
Source session: 06aLRoB0AYUPw7Dkg
Created: 2026-09-08 19:25:42
Updated: 2026-09-09 23:15:07

Content

Treat Toolkit migration as a hard gate: first ship a backward-compatible getsentry/cli stable release, then import CLI and docs history separately into packages/cli and apps/cli-docs. Probe Toolkit before legacy and fall back only on a typed HTTP 404; transport, authentication, rate-limit, and server failures are terminal, and never infer fallback from message text. Reuse the successful probe and preserve source affinity through validation, release notes, GitHub/GHCR, delta chains, caching, prefetch, nightly, downloads, and offline resolution. Normalize Toolkit’s cli@ tag only at the GitHub-release adapter boundary without changing selected-source URLs, assets, or cache keys. Keep TypeScript and installer sources synchronized; fresh installers stay single-source and mutable URLs switch only at cutover. Dual-publish identical stable and nightly artifacts for at least two releases and about 90 days; retain writable legacy until telemetry and release evidence support archival. Test ordering, affinity, fallback, failures, tags, and offline behavior.

Move to: