XP = BASE_XP × DIFFICULTY_MULTIPLIER × COMPLEXITY_FACTOR × SPEED_BONUS × STREAK_BONUS

Action                    Base XP    Time Commitment
─────────────────────────────────────────────────────
Complete Smoke Test       50-100     2-5 min
Complete Integration      250-500    10-30 min
Complete Network Trial    1000-2500  30min-2h
Complete Ritual           500-1000   Varies
Guild Tournament Win      2000-5000  2-4h
Leaderboard Rank 1        1000+      Ongoing
Help Another Developer    100-500    Variable
Report Bug                50-200     5-30 min
Contribute to Lore        100-300    10-20 min

Tier 1 (Apprentice):  1.0x  (easy, foundational)
Tier 2 (Journeyman):  1.5x  (medium, requires understanding)
Tier 3 (Master):      2.5x  (hard, needs expertise)
Tier 4 (Legend):      5.0x  (extreme, mastery-level)

Based on domain size:
  Small (1-5 events):      1.0x
  Medium (5-15 events):    1.5x
  Large (15-30 events):    2.0x
  Massive (30+ events):    3.0x

Based on cross-domain dependencies:
  No dependencies:         1.0x
  1-2 dependencies:        1.2x
  3-5 dependencies:        1.5x
  6+ dependencies:         2.0x

Complete within 50% of estimated time:  1.3x bonus
Complete within 75% of estimated time:  1.15x bonus
Complete at normal pace:                1.0x (no bonus)
Complete in 2x+ estimated time:         0.7x penalty

Complete N quests in 24 hours:
  3 quests:    1.1x bonus
  5 quests:    1.2x bonus
  7+ quests:   1.5x bonus

Maintain streak for N consecutive days:
  3 days:      1.05x daily bonus
  7 days:      1.1x daily bonus
  14 days:     1.2x daily bonus
  30 days:     1.5x daily bonus (reset monthly)

Total XP for Level N = 1000 × (1.15 ^ (N-1))

Level  Required XP  Cumulative XP  Title
────────────────────────────────────────────
1      0            0               Novice Smith
2      1000         1000            Apprentice Smith
3      1150         2150            Skilled Smith
4      1323         3473            Journeyman Smith
5      1521         4994            Expert Smith
6      1750         6744            Master Smith
7      2012         8756            Grand Master Smith
8      2313         11,069          Legendary Smith
9      2661         13,730          Mythic Smith
10+    3059+        16,391+         Ascended Smith

level_unlocks:
    1:
        - First quest: 'Forge the User Domain'

    3:
        - Unlock integration quests
        - Unlock achievements

    5:
        - Unlock guild creation
        - Unlock rituals
        - Unlock multiplayer quests

    10:
        - Unlock leaderboards
        - Unlock tournaments
        - Unlock advanced cosmetics

    20:
        - Unlock crucible (network stress testing)
        - Unlock mentor role
        - Unlock quest creation

    50+:
        - Prestige system (reset to level 1 with benefits)
        - Cosmetic customization
        - Hall of fame entry

Tier       Rarity        Color   XP Reward  Display
──────────────────────────────────────────────────
Common     Frequent       Blue    10 XP     ⭐
Uncommon   Regular        Green   25 XP     ✨
Rare       Challenging    Purple  50 XP      💎
Epic       Very Hard      Orange  100 XP    👑
Legendary  Extreme        Gold    250 XP    🔥

first_forge:
    name: 'First Forge'
    description: 'Complete your first quest'
    rarity: common
    xp: 10
    unlock: 'Level 1'

smith_master:
    name: 'Smith Master'
    description: 'Reach level 20'
    rarity: rare
    xp: 50

ascended:
    name: 'Ascended'
    description: 'Reach level 50'
    rarity: legendary
    xp: 250

speedrunner:
    name: 'Speedrunner'
    description: 'Complete a quest 2x faster than estimated'
    rarity: rare
    xp: 50
    criteria:
        - 'completion_time < estimated_time * 0.5'

perfect_temper:
    name: 'Perfect Temper'
    description: 'Complete 5 quests with 100% test pass rate'
    rarity: uncommon
    xp: 25
    criteria:
        - '5 consecutive quests with 100% pass'

consistency_champion:
    name: 'Consistency Champion'
    description: 'Maintain a 30-day quest streak'
    rarity: epic
    xp: 100
    criteria:
        - 'complete_at_least_one_quest_per_day for 30 days'

guild_founder:
    name: 'Guild Founder'
    description: 'Create and lead a guild'
    rarity: rare
    xp: 50

team_player:
    name: 'Team Player'
    description: 'Complete 10 collaborative quests'
    rarity: uncommon
    xp: 25

mentor:
    name: 'Mentor'
    description: 'Help 5 developers complete their first quest'
    rarity: epic
    xp: 100

tournament_champion:
    name: 'Tournament Champion'
    description: 'Win 3 tournaments'
    rarity: legendary
    xp: 250

user_domain_master:
    name: 'User Domain Master'
    description: 'Complete all user domain quests'
    rarity: epic
    xp: 100
    criteria:
        - 'complete_all_quests_for_domain(user)'

domain_architect:
    name: 'Domain Architect'
    description: 'Master all 8 domains'
    rarity: legendary
    xp: 500
    criteria:
        - 'master_all_domains'

resilience_expert:
    name: 'Resilience Expert'
    description: 'Complete the Crucible challenge'
    rarity: legendary
    xp: 250

easter_egg_1:
    name: '???'
    description: '[HIDDEN]'
    rarity: legendary
    hidden: true
    unlock_criteria: 'easter_egg_1_trigger()'

lore_keeper:
    name: 'Lore Keeper'
    description: 'Discover all story fragments'
    rarity: epic
    hidden: true
    xp: 150

┌─────────────────────────┐
│  🏆 Smith Master        │
│  ✨ Uncommon            │
│                         │
│  "Reach level 20"       │
│                         │
│  Progress: 15/20 ████░░ │
│                         │
│  +25 XP • Locked        │
└─────────────────────────┘

Local Leaderboard (Per Developer)
─────────────────────────────────
Rank  Developer    XP      Level   Quests
────────────────────────────────────────
1.    @alice       45,230  8       127
2.    @bob         38,120  7       98
3.    @carol       32,050  7       89
4.    @you         12,340  4       34
5.    @dave        11,200  4       29

Team Leaderboard
────────────────────────────────────────────
Rank  Team Name       Total XP  Members  Avg Level
──────────────────────────────────────────────────
1.    "The Smiths"    250,000   12       5.3
2.    "Guild Rift"    180,000   8        4.9
3.    Your Team       95,000    4        4.2
4.    "Fire & Forge"  87,000    6        3.8
5.    "Code Masters"  65,000    5        3.5

Global Leaderboard (All Time)
────────────────────────────────────────────────────────
Rank  Developer           Total XP    Achievements  Guilds
────────────────────────────────────────────────────────
1.    legendary-smith     2,450,000   48           7
2.    forge-master-pro    2,130,000   46           5
3.    resilience-queen    1,980,000   45           8
...

Season 1: December 1 - December 31, 2025
├─ Leaderboard reset on Dec 1
├─ New theme: "The Great Forging"
├─ Bonus multiplier: 1.25x XP for all quests
└─ Grand Prize: Custom badge + $50 credit

Season 2: January 1 - January 31, 2026
├─ Leaderboard reset
├─ Theme: "Network Trials"
├─ Bonus: Network quests give 2x XP
└─ Grand Prize: Custom title + Pro tier upgrade (1 month)

Leaderboard Score = (Total XP × 0.7) + (Achievements × 100) + (Streak Bonus × 50)

Tiebreaker:
1. Most recent quest completion time
2. Consistency (quests per day)
3. Account creation date

Level: 5+
Cost: 0 (free tier)
Members: Must invite 3+ members
Guild Size Limits:
  Community:  5 members max
  Team:       25 members max
  Pro:        100 members max
  Enterprise: Unlimited

guild:
    id: 'guild_001'
    name: 'The Smiths'
    tagline: 'Forging excellence together'
    founded: 2025-12-16

    roles:
        founder:
            permissions: ['manage_members', 'create_events', 'disband']
        officer:
            permissions: ['manage_members', 'create_events']
        member:
            permissions: ['participate_events', 'view_guild_stats']

    stats:
        total_members: 12
        total_xp_earned: 250,000
        average_level: 5.3
        quest_completion_rate: 78%

    treasury:
        guild_xp_pool: 50,000 # Shared guild resource
        contributed_by: 'daily_quests_5%'

Guild XP Pool
├─ 5% of all member XP goes to pool
├─ Used for guild quests
├─ Used for guild tournaments
├─ Can boost member XP temporarily (1.1x for 24h)
└─ Officer-managed distribution

Guild Vault (Pro+)
├─ Share artifacts with guild members
├─ Duplicate rare artifacts
└─ Transfer achievements (limited)

guild_quest:
    name: 'Guild Cohesion'
    description: 'All members complete the User Domain quest'
    difficulty: medium
    time_limit: 7 days

    rewards:
        # Per member who completes
        member_xp: 200

        # Guild-wide reward
        guild_xp: 500
        guild_achievement: 'united_forge'

Monthly Guild Tournament
├─ Single/Team elimination bracket
├─ Qualifying round (top 8 guilds advance)
├─ Grand finale (best of 3 rounds)
├─ Winners: Guild flag, exclusive badge, 1000 guild XP
└─ All participants: 500 guild XP

Streak Counter:
├─ Track: # consecutive days with ≥1 quest completed
├─ Display: "🔥 7 day streak!" in profile
├─ Bonus: 1.5x XP at 7-day streak
├─ Reset: If no quest completed in calendar day
└─ History: Show longest streak ever

Streak Milestones:
  3 days:  "On Fire!" badge
  7 days:  "Weekly Champion" badge
  14 days: "Unstoppable" badge + 1.2x XP multiplier
  30 days: "Legendary Streak" badge + monthly prestige points

Team Momentum increases with:
  - Consistent daily quests
  - Multiple quests per day (bonus at 3, 5, 7+ quests)
  - Achieving milestones together
  - Winning tournaments

Momentum Meter (0-100%):
  0-25%:   Ember    (1.0x XP)
  25-50%:  Flame    (1.1x XP)
  50-75%:  Inferno  (1.2x XP)
  75-100%: Cataclysm (1.5x XP) ← Maximum momentum

Momentum decays at 2% per day of inactivity

Titles (Earned):
  - Smith
  - Master Smith
  - Legendary Smith
  - Domain Expert: [Domain Name]

Badges (Earned via Achievements):
  - Common/Uncommon: Standard frame
  - Rare/Epic: Ornate frame
  - Legendary: Animated, glowing

Username Color (Pro+):
  - Bronze (Level 1-10)
  - Silver (Level 11-20)
  - Gold (Level 21-40)
  - Platinum (Level 41-50)
  - Rainbow/Custom (Level 50+)

Cosmetics Shop (Earned XP):
  - Custom avatar frame (250 credits)
  - ASCII art smithy theme (500 credits)
  - Rare title "Mythic Smith" (1000 credits)
  - Badge border color (100 credits)

Exchange Rate:
  100,000 XP = 1 credit
  1 credit = $0.01 USD equivalent

When reaching Level 50:
  Option: "Ascend and Prestige"

  Effect:
  ├─ Reset level to 1
  ├─ Keep all achievements
  ├─ Keep cosmetics
  ├─ Gain prestige level +1
  ├─ Prestige star ⭐ added to profile
  ├─ Title changes to "[Title] (Prestige N)"
  └─ Future XP requirements reduced by 10% per prestige

  Benefits:
  ├─ Exclusive prestige-only cosmetics unlock
  ├─ 1.25x XP multiplier on next cycle
  └─ Global recognition

Prestige 1:  ⭐ (1 star)
Prestige 2:  ⭐⭐ (2 stars)
Prestige 3:  ⭐⭐⭐ (3 stars, max)

Prestige 3+ Benefits:
  - Custom title colors
  - Glow effect in leaderboards
  - Exclusive "Ascended" badge
  - VIP profile frame

As you complete quests and achievements, you unlock lore fragments:

Chapter 1: "The First Forge"
├─ Quest 1 completion: Fragment 1
├─ Quest 2 completion: Fragment 2
├─ Achievement unlock: Fragment 3
└─ Level 5: Complete Chapter 1 cutscene

Chapter 2: "The Guild Awakes"
├─ Unlock at Level 10
├─ Create/join guild: 5 fragments
└─ Win guild tournament: Final fragment

...continues to Level 50+

Player can read full lore via:
  sparki forge lore
  sparki forge lore chapter 2
  sparki forge lore --interactive (story mode)

lore_fragment:
    - Completion: +10 XP per fragment
    - Complete chapter: +100 XP + badge
    - Contribute to lore (community): +50-500 XP + author credit

lore_database:
    - Database of all domain models and their "historical context"
    - Each domain has a "smithing legend"
    - User contributions expand the lore
    - Enterprise: White-label lore for company-specific domains

Account:
  - Bulk XP farming (> 10x normal rate) → Investigation
  - Auto-click detection (quest completion < 1 sec) → Flag
  - Impossible timing (location change in &lt;1 sec) → Flag

Quests:
  - 100% win rate with 0 failures → Suspicious
  - Consistent speedruns (< 10% of estimate) → Review

Social:
  - Botnet-like behavior → Disqualify
  - Collusion (synchronized submissions) → Investigation

Tier 1 (First Offense):
  - Warning message
  - Temp XP pause (24h)
  - Manual review

Tier 2 (Repeated):
  - XP reset to 50%
  - Temporary leaderboard suspension
  - Achievement review

Tier 3 (Egregious):
  - Permanent ban
  - XP reset to 0
  - Achievements stripped

Quest Difficulty Scaling:
  - Adjust quest difficulty based on player level
  - Prevent over-leveling smurfs
  - Historical performance tracking

Leaderboard Fairness:
  - Account age factor (new accounts weighted lower)
  - Activity-based scoring (prevent inactive ranking)
  - Seasonal resets to prevent permanent advantage

sparki forge dashboard

┌─ Your Forge Stats ────────────────────────────┐
│ Level: 8 (45,000 / 50,250 XP to Level 9)   │
│ Quests Completed: 127                        │
│ Achievements: 24                             │
│ Current Streak: 🔥 7 days                    │
│ Guild: "The Smiths" (Rank: 2/12)            │
│                                              │
│ This Month:                                  │
│  ├─ XP Earned: 8,450                         │
│  ├─ Quests Done: 34                          │
│  ├─ Fastest Quest: 2.1 min (Tier 1)          │
│  └─ Hardest Quest: Crucible (1h 23m)         │
│                                              │
│ Recommendations:                             │
│  • Try Tier 3 Network Trials (Level unlocked)│
│  • 3 achievements away from "Consistency"    │
│  • Guild needs help with Document quest      │
└──────────────────────────────────────────────┘