Skip to content

feat: per-release welcome notification for the 0.4.0 line#3402

Open
MattDHill wants to merge 2 commits into
masterfrom
beta10-welcome-notification
Open

feat: per-release welcome notification for the 0.4.0 line#3402
MattDHill wants to merge 2 commits into
masterfrom
beta10-welcome-notification

Conversation

@MattDHill

Copy link
Copy Markdown
Member

Summary

Adds a per-release welcome notification for the 0.4.0 line and refreshes the aging 0.4.0 update notes.

Welcome routing (shared-libs/crates/start-core/src/version/)

  • Servers already on the 0.4.0 line (e.g. beta.9 → beta.10) now get a "Welcome to StartOS 0.4.0-beta.10!" notification; servers upgrading from 0.3.x still get only "Welcome to StartOS 0.4.0!". The two are mutually exclusive by construction.
  • The gate is factored into a reusable should_welcome_to_release(version, from_pre_0_4_0) in version/mod.rs: a welcome fires only for the release actually being landed on (the current head) and only when the server was already on the 0.4.0 line. This keeps a future beta.11 from double-notifying on a beta.9 → beta.11 jump. Covered by version::tests::welcome_routing.

beta.10 highlights (update_details/v0_4_0_beta_10.md, new)

  • Backups-first, with a "what to do" for the v2 format change, plus trimmed networking / interface / reliability highlights and a new-tab link to the full changelog.

0.4.0 update-notes refresh (update_details/v0_4_0.md)

  • Fix stale late-alpha claims: start-fsbackup-fs; RISC-V RVA23 now supported (present tense); registry binaries served from a CDN with a GitHub mirror; automatic gateway port-forwarding in the clearnet section; rename the "LAN Port Forwarding" heading (it collided with the real auto port-forwarding feature); drop a dead backup cross-reference.
  • The backup warning now advises starting services and letting each reach healthy — some finish updating on first start — before creating a fresh backup.

AGENTS.md

  • Add a short code-comment rule (comment only what the code can't say for itself; keep it terse).

Verified: cargo check -p start-core clean; version::tests::welcome_routing and the existing v0_4_0_beta_10 tests pass.

🤖 Generated with Claude Code

Add a "Welcome to beta.10" notification, shown only to servers already on the
0.4.0 line; servers upgrading from 0.3.x still receive only the "Welcome to
0.4.0" notification. The routing (should_welcome_to_release) is reusable, so a
future release won't double-notify on a multi-version jump.

- Add the beta.10 highlights (backups v2 guidance first), with a new-tab link
  to the full changelog.
- Refresh the 0.4.0 update notes for stale claims: start-fs -> backup-fs,
  RISC-V now supported, registry binaries served from a CDN (GitHub mirror),
  automatic gateway port-forwarding, and a dead backup cross-reference; advise
  starting services until healthy before backing up.
- Add a comment-style rule to AGENTS.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@MattDHill MattDHill requested a review from dr-bonez July 4, 2026 05:49
server_info.get_mut("postInitMigrationTodos")
}

/// True when this run has migrated a version <= `0.4.0-alpha.0`, i.e. the server came

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd prefer this and the following function to be in the beta.10 version file. The current placement implies this is less of a one-off thing than it is

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done — moved both migrated_from_pre_0_4_0 and should_welcome_to_release (plus the welcome_routing test) into v0_4_0_beta_10.rs; mod.rs is back to just the migration engine. Behavior unchanged. (6dc36d7)

Per review: migrated_from_pre_0_4_0 and should_welcome_to_release are
beta.10-specific, not general migration facilities, so they belong with the
version that uses them rather than in version/mod.rs. Behavior and the
welcome_routing test are unchanged (the test moves with them).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@MattDHill MattDHill requested a review from dr-bonez July 4, 2026 06:15
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.

2 participants