fix: upgrade startup script controls

docs/CHANGELOG.md

@@ -7,6 +7,30 @@ This project follows the repository versioning rule:
 - `feature` -> `+0.1.0`
 - `bugfix` -> `+0.0.1`
 
+## 0.21.3
+
+Released: 2026-03-27
+
+### Highlights
+
+- Upgraded the startup script into a more resilient local control entrypoint with retry-based service boot, selective restart targeting, and guided CLI user creation.
+- Reduced friction when developing across slower machines by making backend and frontend startup checks more tolerant and operator-friendly.
+
+### Added
+
+- Added interactive `createuser` support to [planet.sh](/home/ray/dev/linkong/planet/planet.sh) for CLI-driven username, email, password, and admin-role creation.
+
+### Improved
+
+- Improved `start` and `restart` in [planet.sh](/home/ray/dev/linkong/planet/planet.sh) with optional backend/frontend port targeting and on-demand port cleanup.
+- Improved startup robustness with repeated health checks and automatic retry loops for both backend and frontend services.
+- Improved restart ergonomics so `restart -b` and `restart -f` can restart only the requested service instead of forcing a full stack restart.
+
+### Fixed
+
+- Fixed false startup failures on slower environments where services needed longer than a single fixed wait window to become healthy.
+- Fixed first-run login dead-end by ensuring a default admin user is created during backend initialization when the database has no users.
+
 ## 0.21.2
 
 Released: 2026-03-26

docs/version-history.md

@@ -16,7 +16,7 @@
 ## Current Version
 
 - `main` 当前主线历史推导到：`0.16.5`
-- `dev` 当前开发分支历史推导到：`0.21.1`
+- `dev` 当前开发分支历史推导到：`0.21.3`
 
 ## Timeline
 
@@ -65,6 +65,7 @@
 | `0.21.0` | feature | `dev` | `pending` | add Earth inertial drag, sync hover/trail state, and support unlimited satellite loading |
 | `0.21.1` | bugfix | `dev` | `pending` | polish Earth toolbar controls, icons, and loading copy |
 | `0.21.2` | bugfix | `dev` | `pending` | redesign Earth HUD with liquid-glass controls, dynamic legend switching, and info-card interaction polish |
+| `0.21.3` | bugfix | `dev` | `30a29a6e` | harden `planet.sh` startup controls, add selective restart and interactive user creation |
 
 ## Maintenance Commits Not Counted as Version Bumps