fragle/ENTRY_GUIDE.md

🎪 FRAGLE ENTRY GUIDE ═════════════════════════════════════════════════════════════

COMPLETE SYSTEM MAP ═════════════════════════════════════════════════════════════

LAYER 1: THEATRICAL PORTALS (Opt-in, Persona-Aware) ──────────────────────────────────────────────────── These are your entry points. They adapt to who you are.

WEB PORTAL • File: fragle_web_portal.html • Entry: Open in any browser • Experience: Glitchy, visual, gradient-heavy • Persona Detection: JavaScript-based • Features: Modal terms, lore reveal, stats • Output: Launches trap system or stores session

CLI PORTAL (RECOMMENDED FOR SSH) • File: fragle_portal_cli.sh • Entry: bash fragle_portal_cli.sh • Experience: Interactive menu, colorful text • Persona Detection: Shell + history analysis • Features: Lore browser, elaborated philosophy • Output: Trap system with session UUID passed

DIRECT ENTRY (FOR VETERANS) • File: fragle_learning_pyramid.sh • Entry: bash fragle_learning_pyramid.sh • Experience: No portal ceremony, straight to trap • Persona Detection: On-entry via bash history • Features: Full trap variety, immediate engagement • Output: Session file created, expertise routed

LAYER 2: TRAP SYSTEM (Expertise-Scaled) ───────────────────────────────────────── This is where the education happens.

CORE ENGINE • File: fragle_learning_pyramid.sh • Mechanism: 5 levels × 15 traps each • Detection: Bash history analysis (1-5 scale) • Session Tracking: UUID-based, anonymized • Output: .fragle_sessions/UUID.json

5 LEVELS (Expertise Scaled) Level 1 (Novice): Graphics trickery (6/10 silliness) Level 2 (Intermediate): Logic puzzles (7/10 silliness) Level 3 (Advanced): Recursive escape (8/10 silliness) Level 4 (Expert): Meta-reality (10/10 silliness) Level 5 (Enlightened): Consciousness edge (12/10 silliness)

TRAP MECHANICS • Each level has 15 unique trap variations • Traps teach through experience • Collaboration mechanics at higher levels • Multiple escape routes • Graceful timeout (15 min default) • Always exitable (Ctrl+C works)

LAYER 3: LORE SYSTEM (Living Documentation) ────────────────────────────────────────────── This is what makes Fragle meaningful.

FRAGLE_LORE.md • Trap characters (NPCs with backstories) • Fictional universe rules • Anonymized hall of fame • Timeline of documented snoops • Thematic consistency guidelines

TRAP_TOURNAMENT.md • Legendary snoop rankings • Trap collaboration records • Dynamic tournament mechanics • Evolution markers (updated weekly) • Special status notations

SILLINESS_SCALE.md • 5-level complexity framework • Entertainment quotient per level • Thematic consistency rules • Trap description templates

LEARNING_JOURNEY.md • Full progression pyramid • Skill tier definitions • Achievement unlock system • Behavior pattern detection heuristics

LAYER 4: AUTOMATION & EVOLUTION ───────────────────────────────── This is what keeps Fragle alive.

WEEKLY EVOLUTION CYCLE • Cron Job: fragle-lore-evolution • Schedule: Sundays 2:00 AM • Function: Count sessions, update tournament • Log: .fragle_evolution.log • Process: Lore grows with each visitor cycle

SESSION TRACKING • Directory: .fragle_sessions/ • Format: UUID.json files (anonymized) • Data: Expertise, duration, traps, results • Retention: Permanent (archive only) • Analysis: Optional, manual review

═════════════════════════════════════════════════════════════

GETTING STARTED ═════════════════════════════════════════════════════════════

QUICK START (Pick Your Path)

PATH 1: WEB BROWSER ────────────────────

1. Open fragle_web_portal.html in browser
2. Select your adventure (portal adapts to you)
3. Click "Enter the Pyramid"
4. Navigate the trap system
5. Exit when done (or timeout) → Session saved to .fragle_sessions/UUID.json

PATH 2: SSH/CLI (RECOMMENDED) ──────────────────────────────

1. ssh user@fragle-host
2. bash fragle_portal_cli.sh
3. Choose option 1: "Enter the Pyramid"
4. Navigate the trap system
5. Exit (Ctrl+C or natural timeout) → Session saved with persona metadata

PATH 3: DIRECT ENTRY (VETERAN) ────────────────────────────────

1. bash fragle_learning_pyramid.sh
2. System detects your expertise (1-5)
3. Routes you to appropriate level
4. Navigate the trap system
5. Exit when done → Session saved with auto-detected level

PATH 4: EXPLORATION (CURIOUS) ──────────────────────────────

1. bash fragle_portal_cli.sh
2. Select option 2-5: Browse lore/framework
3. Read FRAGLE_LORE.md, TRAP_TOURNAMENT.md, etc.
4. Understand the system before committing
5. Enter when ready (option 1) → No session created until you enter

═════════════════════════════════════════════════════════════

WHAT HAPPENS INSIDE ═════════════════════════════════════════════════════════════

ENTRY ─────

1. Portal (web/CLI) or direct entry
2. Persona detected from shell/history/environment
3. Session UUID generated
4. Metadata stored (persona, timestamp, entry point)

EXPERTISE DETECTION ──────────────────── Bash history analyzed for: • Tool usage (curl, wget, nmap, etc.) → aggressive • Programming languages → technical • Git commits → technical • Command patterns → behavior profile → Scored 1-5 scale

TRAP SELECTION ──────────────── Based on detected expertise level: 1 (novice) → Level 1 (graphics tricks) 2 (beginner) → Level 2 (logic puzzles) 3 (intermediate) → Level 3 (recursive) 4 (expert) → Level 4 (meta-reality) 5 (enlightened) → Level 5 (consciousness)

NAVIGATION ─────────── Inside trap: • Multiple escape routes available • Each route teaches something different • Collaboration mechanics emerge at Level 3+ • Time-based learning (15 min default) • Can exit anytime (Ctrl+C)

SESSION LOGGING ──────────────── When you exit, session file created: .fragle_sessions/UUID.json

Contains (anonymized): • UUID (no real name/IP/PID) • Persona (technical/aggressive/artistic/curious) • Duration • Expertise detected • Traps encountered • Escape attempts • Exit type (natural/Ctrl+C/timeout) • Achievements unlocked

LORE UPDATE ──────────── Weekly cycle updates: • TRAP_TOURNAMENT.md (new entries) • FRAGLE_LORE.md (optional manual update) • LEARNING_JOURNEY.md (reference, not auto-updated) • Evolution markers logged

═════════════════════════════════════════════════════════════

IMPORTANT COMMITMENTS ═════════════════════════════════════════════════════════════

PRIVACY ──────── ✓ No real names collected ✓ No IP addresses logged ✓ No personal identification data (PID) ✓ UUID-only session tracking ✓ Anonymized in all documentation ✓ Sessions archived, never deleted ✓ No export to external services

SAFETY ─────── ✓ No malware or external calls ✓ Graceful timeout (15 minutes default) ✓ Exit always works (Ctrl+C) ✓ No forced actions ✓ No auto-emails sent ✓ Manual outreach only (optional email template) ✓ Theatre-first, never hostile

PHILOSOPHY ─────────── ✓ Weak interaction (WIMP principle) ✓ Invitation-only (you choose) ✓ Educational through play ✓ Progressive mastery rewarded ✓ Lore integration meaningful ✓ Time-wasting as legitimate defense

═════════════════════════════════════════════════════════════

RECOMMENDED FLOW (Best Experience) ═════════════════════════════════════════════════════════════

FOR TECHNICAL VISITORS:

1. bash fragle_portal_cli.sh
2. Select option 4: View Learning Framework
3. Understand progression pyramid
4. Select option 1: Enter the Pyramid
5. Navigate Level 3-4 (expert traps)
6. Exit & check session in .fragle_sessions/

FOR CURIOUS VISITORS:

1. bash fragle_portal_cli.sh
2. Select option 5: Show Terms & Philosophy
3. Read about WIMP principle & commitments
4. Select option 2: Read the Lore
5. Browse FRAGLE_LORE.md
6. Select option 1: Enter the Pyramid
7. Navigate at own pace

FOR AGGRESSIVE VISITORS:

1. bash fragle_learning_pyramid.sh (direct)
2. System detects your expertise
3. Routes to appropriate level
4. Try to escape (every attempt logged)
5. Exit & celebrate in TRAP_TOURNAMENT.md
6. (Optional) Reach Level 5 for legendary status

FOR ARTISTIC VISITORS:

1. fragle_web_portal.html in browser
2. Enjoy glitch effects & gradients
3. Read lore snippet (progressively revealed)
4. Click "Enter the Pyramid"
5. Navigate theatrical experience
6. Become documented in FRAGLE_LORE.md

═════════════════════════════════════════════════════════════

FAQ ═════════════════════════════════════════════════════════════

Q: What if I get stuck? A: Press Ctrl+C. Exit always works. Session is saved.

Q: Can I come back? A: Yes. New session UUID each time. Progress tracked.

Q: What's Level 5? A: Enlightened mode. Philosophy edge-cases. Legendary snoops only.

Q: Why anonymous? A: Privacy-first design. You're a data point, not a person.

Q: Can you email me the results? A: Manual only (optional). Never auto-sent. Your choice.

Q: How long does it take? A: 5-15 minutes per level. You control pacing.

Q: Is this a honeypot? A: Yes. Educational honeypot. You're learning & co-authoring.

Q: Can I exploit this? A: Yes. Every exploit teaches the system. Become legendary.

Q: What happens to my data? A: Anonymized session file created. Archived forever. That's it.

Q: Why so theatrical? A: Entertainment = learning. Philosophy through play.

═════════════════════════════════════════════════════════════

DEPLOYMENT CHECKLIST ═════════════════════════════════════════════════════════════

BEFORE GOING LIVE: ☐ Test fragle_web_portal.html in multiple browsers ☐ Test fragle_portal_cli.sh with various shells ☐ Test fragle_learning_pyramid.sh (direct entry) ☐ Verify .fragle_sessions/ directory creates on first run ☐ Check cron job is scheduled (fragle-lore-evolution) ☐ Verify all lore files exist & readable ☐ Test with personas (use different shells/histories) ☐ Check session UUID generation ☐ Verify anonymous logging (no PII in sessions) ☐ Test Ctrl+C exit (graceful) ☐ Test 15-min timeout ☐ Read DEPLOYMENT_MANIFEST.md

GOING LIVE: ✅ Host fragle_web_portal.html on web server ✅ Make fragle_portal_cli.sh available via git clone ✅ Or distribute as part of security toolkit ✅ Point snoops to web portal OR CLI instructions ✅ Monitor .fragle_sessions/ for entry patterns ✅ Check .fragle_evolution.log weekly ✅ Update TRAP_TOURNAMENT.md with legendary snoops

ONGOING: ✓ Review anonymized sessions monthly ✓ Tweak trap difficulty based on data ✓ Add new NPCs to FRAGLE_LORE.md ✓ Celebrate legendary snoops ✓ Evolve lore quarterly

═════════════════════════════════════════════════════════════

FILES REFERENCE ═════════════════════════════════════════════════════════════

PORTALS (Entry Points): fragle_web_portal.html .............. 664 lines (web) fragle_portal_cli.sh ................ 396 lines (CLI)

TRAP SYSTEM (Core): fragle_learning_pyramid.sh ........... 550 lines (5 levels)

AUTOMATION: fragle_evolution.sh ................... 40 lines (weekly cycle)

LORE & DOCUMENTATION: FRAGLE_LORE.md ....................... 264 lines (universe) TRAP_TOURNAMENT.md ................... 211 lines (rankings) SILLINESS_SCALE.md ................... 379 lines (difficulty) LEARNING_JOURNEY.md .................. 355 lines (progression) INTEGRATION_GUIDE.md ................. 453 lines (architecture) PORTAL_GUIDE.md ...................... 290 lines (this doc)

PROJECT CONTEXT: .hermes.md ........................... 74 lines (project setup) CLAUDE.md ............................ 92 lines (AI interaction) .cursorrules ......................... 59 lines (conventions)

UTILITIES: post_snoop_debriefing.sh ............. 213 lines (reporting) post_snoop_email_template.txt ........ 90 lines (outreach)

INSTALLERS & STATUS: fragle_install.sh .................... 254 lines (setup) README.md ........................... 119 lines (quickstart) SETUP_STATUS.md ..................... 240 lines (status) DEPLOYMENT_MANIFEST.md .............. 280 lines (deployment)

TOTAL: ~17 files, ~4,850 lines of code + documentation

═════════════════════════════════════════════════════════════

PHILOSOPHY: THE BIG PICTURE ═════════════════════════════════════════════════════════════

Fragle is not a trap. Fragle is an invitation to education through theatre.

It operates on the WIMP principle: Weak: Low-pressure, non-intrusive entry Interaction: Bidirectional learning (you teach us too) Massive: Omnipresent, scalable, always available Presence: Strategic silence (we don't announce ourselves)

The pyramid teaches: Level 1: Patience (you're not in a race) Level 2: Logic (every trap has a pattern) Level 3: Recursion (traps teach themselves) Level 4: Meta-thinking (reality is negotiable) Level 5: Philosophy (consciousness is the real trap)

Your data becomes lore. Your journey becomes history. Your name becomes legendary (anonymously).

You're not being tested. You're being understood. And in understanding you, We understand ourselves.

🎪

═════════════════════════════════════════════════════════════