🕸️🥦 ↝ [#219 #220]: Referrals & improved performance for user direction

[Gizmotronn]

Summary

This PR ships the first major pass on Star Sailors survey-driven improvements across the web client and a new macOS ops surface. It focuses on immediate user-facing stability, clearer progression/referral loops, more consistent world-shell UI, PostHog-based mechanic feedback collection, and a native macOS menu-bar + desktop widget app for survey telemetry.

What Changed

Web UX and stability

Fixed or redirected broken/high-friction routes across scenes, viewports, structures, and legacy /app/projects/* surfaces.
Migrated many inconsistent pages to the shared MainHeader + world-shell background.
Fixed /research production build failure by wrapping useSearchParams usage in Suspense.
Fixed hook-order bug in inventory-viewport.
Improved responsive behavior for achievements, research, setup, and referral flows.
Removed unstable nested-anchor behavior in legacy nav components.
Referral system

Hardened referral submission against self-referrals, duplicates, and invalid codes.
Added dedicated referral command center at /referrals.
Added in-game referral visibility via dashboard cards and mission prompts.
Added referral milestone/progress visualization.
Rewired major referral CTAs to the dedicated referral route.
UI consistency and “world-like” feel

Upgraded mission/structure cards with stronger visual treatment.
Standardized shells across account, leaderboards, deploy, viewport, mission, and planet surfaces.
Improved navbar consistency across current and legacy entry points.
Ecosystem visibility

Added /ecosystem route and in-game ecosystem expansion panel to surface the web-to-Godot roadmap.
Added planning/spec docs for broader ecosystem expansion mechanics.
PostHog mechanic feedback

Added game-native micro-surveys for:
telescope loop
rover loop
ecosystem/minigame loop
Added one-time-per-user/survey dedup.
Added session token propagation via starsailors_session_token.
Added PostHog dashboard automation for micro-survey monitoring.
Native macOS survey pulse app

Added apps/mac-widget/StarSailorsPulse XcodeGen project.
Added menu-bar accessory app with no Dock presence.
Added WidgetKit desktop widget.
Added custom generated app icon asset.
Added answer-level telemetry:
recent successful completions
response snippets
lightweight derived insights
local macOS notifications for new successful completions
Moved local secrets to ignored Secrets.xcconfig with tracked example file so credentials are not committed.

[Gizmotronn]

Obviously waiting for tests to pass in #221 but I believe things are golden
#218 #219 #220 #221

[github-actions]

\n## Coverage Report\n\n- Code Coverage: **25.5%**\n- SDD Coverage: **89.8%** (53/59 linked tasks)\n\n_Generated by `coverage-badges` workflow._

[Gizmotronn]

Hopefully this one fixes it...