ADR-006: Implement Level Zero Adaptive Onboarding Flow

[Copilot]

Rewires the existing boot/animation infrastructure into the correct ADR-006 sequence and adds the missing robot-guided onboarding phases. The old flow sent users directly to Stage 1 after boot; the new flow gates progression behind the robot's teaching sequence and Trade Window consent.

Button Differentiation

• Removed beginPulse glow from .begin-btn (CSS + _postBootReveal JS) — the "Begin Setup →" button is now a static secondary CTA
• New "Get Started" button lives inside the robot's speech bubble; carries its own getStartedPulse animation that only fires after INACTIVITY_GLOW_DELAY_MS (60s) of inactivity

Robot Onboarding Phases (post-boot)

• Phase 1 — body.phase1-speech + _runPillTour(): robot says "Hover over each of the icons", then animates (translateX) toward each of the 3 hero feature pills in sequence, showing tooltip explainers (~1.5s each)
• Phase 2 — _startPhase2(): speech updates to "FERROS is free, for you, for life. Click this button to get started." with the Get Started button rendered inside the bubble; 60s inactivity timer starts

Feature Pill Tooltips

Each .feature-pill wrapped in .feature-pill-wrap with a .feature-pill-tooltip child — shows on :hover or via .pill-active class (robot-triggered during tour):

• 🔒 Cryptographic Seals — explains tamper-evident hash chain
• 🏆 Achievement System — explains SP and stage unlocks
• 💻 100% Local / No Servers — explains file://, localStorage, no cloud

Get Started → Trade Window → Achievement Flow

• handleGetStarted() opens Trade Window; _tradeWindowAccepted flag prevents double-prompt when user later clicks "Begin Setup →"
• _postGetStartedAccepted() removes body.pre-trade (reveals achievements/profiles), applies .ach-locked (50% opacity + grayscale) to all achievements except Genesis Pioneer and Discover Profiles, then fires _launchRocketFromGetStarted() — rocket arc from Get Started button to Genesis Pioneer card
• _robotTransitionToAchievements(): robot exits right, enters left with androidBobFast excited bob, switches to body.congrats-speech

Content Gating

body.pre-trade (set in _postBootReveal alongside removing body.boot-sequence) hides .genesis-ach-section, .gallery-preview-section, .alias-entry-section, .recovery-entry-section until Trade Window is accepted.

Second Achievement Path

_unlockDiscoverProfiles() gates on _tradeWindowAccepted || sessionMode (Genesis Pioneer must come first), then unlocks the Discover Profiles card. Triggered by:

• browseAllProfiles() / startAliasFromGallery() (profile fork)
• completeStage0() (Begin Setup →)

"Start from Scratch" card in featured profiles now calls scrollToGenesisCard() (smooth scroll to Welcome box) instead of jumping directly to completeStage0().

AGENT_GUIDE.md

Added BUG-007 (Begin Setup glow), BUG-008 (achievement hover tooltip persistence), BUG-009 (scroll gating clipped Begin button) with the canonical button differentiation table.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• example.com
  • Triggering command: /usr/bin/curl curl -s -o /dev/null -w %{http_code} REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Context

This is PR D — the big implementation PR that brings the full corrected onboarding flow per ADR-006 (just merged in PR #29). This builds on top of all previously merged PRs (#22-29) and is the definitive implementation of the Level Zero robot-guided onboarding experience.

CRITICAL: Read docs/AGENT_GUIDE.md AND docs/adr/ADR-006-level-zero-adaptive-onboarding.md (just merged in PR #29) before touching any code. ADR-006 is the binding spec for this PR. All architecture constraints apply:

• file:// protocol compatibility mandatory — no external deps, no fetch(), no ES modules, no CDN
• saveProfile() is the ONLY localStorage write point
• Do not restructure the stage flow (0→1→2→3)
• Do not modify hashData() or the seal chain
• Single self-contained HTML file with all CSS/JS embedded
• Trade Window consent dialog must never be bypassed

Read ALL existing ADRs in docs/adr/ — they are binding.

Current State of Main Branch

PRs already merged that this builds on:

• PR PR 1/3: Fix FERROS acronym, add Cloud sync placeholder, add architecture TODO comments #22 — Fixed FERROS acronym, cloud badge, TODO comments
• PR PR 2/3: Hero experience — android companion, begin button pulse, achievement unlock animations #23 — Android companion, begin pulse, achievement tooltips (has hover bug)
• PR Featured profiles revamp, fork-a-profile reframe & onboarding scroll gating #24 — Featured profiles revamp, fork-a-profile, scroll gating
• PR Achievement unlock: rocket animation, screen-wide fireworks, click-to-toggle tooltips #25 — Rocket animation, fireworks, click-to-toggle tooltips
• PR fix: Stage 0 Begin button unreachable due to scroll gating clipping content below fold #26 — Begin button scroll gating fix
• PR feat: FERROS cinematic boot animation + Begin button visibility fix #27 — Cinematic boot animation (FERROS shine, typewriter, robot entrance)
• PR Upgrade fireworks: CSS custom-prop particles, 3-burst cascade, screen-wide coverage #28 — Upgraded fireworks (3-burst cascade, screen-wide particles)
• PR docs: Add ADR-006 — Level Zero Adaptive Onboarding & Robot Assistant Architecture #29 — ADR-006: Level Zero Adaptive Onboarding spec

The current code has the boot animation and rocket/fireworks from PRs #25-28 but they were built BEFORE the corrected flow was defined in ADR-006. This PR needs to rewire the existing animations into the correct sequence and add the missing pieces.

What Needs to Change (per ADR-006)

1. Differentiate the Buttons

There are THREE distinct buttons. They are currently confused. Fix them:

Button	Location	Purpose	Glow?
"Get Started"	Inside robot's speech bubble dialog	Primary CTA — opens Trade Window	Yes — after ~60s inactivity
"Begin Setup →"	Welcome to Your Progression System box	Start from scratch path (scrolls to progression system)	NO glow — remove the beginPulse animation from this button entirely
"🍴 Fork this Profile"	Featured profile cards	Fork a template	No glow

The "Begin Setup →" button currently has the beginPulse glow animation from PR #23. Remove that glow entirely. The glow behavior belongs ONLY on the "Get Started" button inside the robot's dialog, and only after ~60 seconds of inactivity.

2. Robot Phase 1 — Teaching the System

After the boot animation completes and the robot is in position:

1. Robot speech bubble says: "Hover over each of the icons to see more information"
2. The three hero feature descriptions need hover explainers/tooltips added to them. These are the elements near the hero section that describe FERROS features. Add interactive tooltips to:
   • 🔒 Cryptographic Seals — tooltip explains what seal chains are and why they matter
   • 🏆 Achievement System — tooltip explains how achievements and SP work
   • 💻 100% Local / No Servers — tooltip explains file:// protocol, localStorage, no cloud dependency
3. The robot animates to hover over each of the 3 feature icons in sequence (quickly, ~1.5s each), which briefly triggers/shows each tooltip. Use CSS transform to move the robot, and add/remove a class to show each tooltip.
4. Robot returns to home position after the tour (~4.5s total for the tour)

3. Robot Phase 2 — Get Started

5. Robot speech bubble changes to: "FERROS is free, for you, for life. Click this button to get started."
6. A "Get Started" button appears INSIDE the robot's speech bubble. Style it prominently — this is the primary CTA.
7. After ~60 seconds of inactivity (user hasn't clicked anything), the Get Started button starts glowing brighter with a pulse animation. This is the adaptive difficulty hint — if they haven't found it, make it more obvious. (Note: there are only 3 hover explainers to read, so 60s is very generous.)

4. Get Started → Trade Window → Rocket → Achievement

8. User clicks "Get Started" → Trade Window consent dialog appears (the existing showTradeWindow() or equivalent from PR Add MMO-style Trade Window permission/consent dialog with session mode #7)
9. User accepts Trade Window → achievements section becomes visible/scrolls into view
10. 🚀 Rocket animation fires (existing from PR Achievement unlock: rocket animation, screen-wide fireworks, click-to-toggle tooltips #25) — rocket launches up, orbits, lands on Genesis Pioneer
11. 🎆 Fireworks burst (existing from PR Upgrade fireworks: CSS custom-prop particles, 3-burst cascade, screen-wide coverage #28) — screen-wide celebration
12. ✨ "+25 SP" float-up on Genesis Pioneer card
13. Robot transition: slides out the RIGHT side of the hero/level-up section, then re-enters from the LEFT side of the achievements section. The robot should look giddy/excited — maybe a faster bob animation or a little bounce.
14. Robo...

This pull request was created from Copilot chat.

---

⌨️ Start Copilot coding agent tasks without leaving your editor — available in VS Code, Visual Studio, JetBrains IDEs and Eclipse.