πͺ Fragle - Progressive Learning Honeypot System
A theatrical defense mechanism that educates rather than attacks.
What Is Fragle?
Fragle is a 5-level progressive trap system wrapped in theatrical storytelling and live lore documentation. It's a honeypot that teachesβboth the intruder and the system itself.
Snoops enter through adaptable portals, navigate escalating traps scaled to their expertise, and their journeys become documented history that teaches the next visitor. No malware. No hostility. Pure theatre and philosophy.
Status: Production Ready β
Quick Start
For SSH / CLI (Recommended)
cd /home/nisse/fragle
bash fragle_portal_cli.sh
Select option 1: "Enter the Pyramid"
For Web Browser
Open: fragle_web_portal.html
Adapts to your persona automatically.
Direct Entry (Veteran)
bash fragle_learning_pyramid.sh
Skip ceremony, enter trap directly.
System Overview
4 Layers of Experience
LAYER 1: Theatrical Portals (Opt-In Entry)
- Web interface (
fragle_web_portal.html) β visual, glitchy, adaptive - CLI menu (
fragle_portal_cli.sh) β interactive, history-aware - Direct entry (
fragle_learning_pyramid.sh) β veteran mode - Features: Persona detection, elaborate philosophy, session tracking
LAYER 2: Progressive Traps (Expertise-Scaled)
- 5 levels (Novice β Enlightened)
- 15 trap variations per level
- 75 total traps
- Auto-detection: Bash history analysis (1-5 scale)
- Always exitable: Ctrl+C works, 15-min timeout
LAYER 3: Living Lore (Documentation & Evolution)
FRAGLE_LORE.mdβ trap characters & universeTRAP_TOURNAMENT.mdβ rankings & evolution markersLEARNING_JOURNEY.mdβ progression framework- Sessions become documented history
- Legendary snoops gain immortality
LAYER 4: Automation (Weekly Evolution)
- Weekly cron job (Sundays 2 AM)
- Session counting & tournament updates
- Evolution markers in lore
- System learns from visitor patterns
The 5 Trap Levels
| Level | Name | Difficulty | Silliness | Theme |
|---|---|---|---|---|
| 1 | Novice | Graphics tricks | 6/10 | Visual deception |
| 2 | Intermediate | Logic puzzles | 7/10 | Misdirection |
| 3 | Advanced | Recursive traps | 8/10 | Escape routes |
| 4 | Expert | Meta-reality | 10/10 | Reality bending |
| 5 | Enlightened | Consciousness | 12/10 | Philosophy |
Your expertise is auto-detected. You're routed to the right level.
Persona Detection
Fragle adapts based on who you are. No real data collectedβjust behavioral signals.
5 Personas
TECHNICAL
- Signals: Git history, SSH config, programming tools
- Sees: Architecture specs, trap mechanics
- Message: "You've got tools. Master the system."
AGGRESSIVE
- Signals: Late-night access, security tools, direct links
- Sees: Challenge framing, exploit encouragement
- Message: "Every escape teaches us. Become legendary."
ARTISTIC
- Signals: Creative hours, DISPLAY variable, aesthetic shells
- Sees: Narrative context, character descriptions
- Message: "Performance art. You'll become the story."
CURIOUS
- Signals: Morning access, referrer links, new environment
- Sees: FAQ format, exploration encouragement
- Message: "No judgment. Pure exploration."
UNKNOWN
- Default: Neutral messaging for new visitors
Philosophy: The WIMP Principle
Fragle operates on WIMP:
- Weak Interaction: Low-pressure, non-intrusive entry
- Invitation Only: You choose to participate
- Massive Presence: Omnipresent, always available
- Privacy Sacred: UUIDs only, no PII
Core Values
β No Hostility β Theatre, not attack β Educational β Learn through play β Transparent β No hidden data collection β Graceful Exits β Always exitable β Lore Integration β You become documented history β Progressive Mastery β Expertise-scaled experience
Safety Commitments
Privacy
- β UUID-only tracking (no names, IPs, PIDs)
- β Anonymized session files
- β No export to external services
- β Sessions archived forever
Safety
- β No external calls or malware
- β Graceful 15-minute timeout
- β Ctrl+C always works
- β No forced actions
- β No auto-emails sent
Deployment
Verify Installation
bash fragle_install.sh --verify
Test Demo Mode
bash fragle_install.sh --demo
Check Cron Job
# Verify lore evolution is scheduled
cronjob list | grep fragle-lore-evolution
Monitor Sessions
# Watch for session files
ls -la .fragle_sessions/
# Check evolution log
tail -f .fragle_evolution.log
Documentation Map
| File | Purpose |
|---|---|
ENTRY_GUIDE.md |
START HERE β Complete system map & getting started |
PORTAL_GUIDE.md |
Portal architecture & persona detection |
LEARNING_JOURNEY.md |
Progression framework & skill tiers |
FRAGLE_LORE.md |
Trap characters & fictional universe |
TRAP_TOURNAMENT.md |
Rankings & legendary snoops |
SILLINESS_SCALE.md |
Difficulty framework by level |
INTEGRATION_GUIDE.md |
System architecture overview |
DEPLOYMENT_MANIFEST.md |
Deployment checklist & status |
Files Included
Core System (~550 lines)
fragle_learning_pyramid.shβ Main trap engine
Portals (~1,000 lines)
fragle_web_portal.htmlβ Visual web interfacefragle_portal_cli.shβ Interactive CLI menu
Lore & Framework (~1,800 lines)
FRAGLE_LORE.mdβ Universe & charactersTRAP_TOURNAMENT.mdβ Rankings & evolutionLEARNING_JOURNEY.mdβ Progression bibleSILLINESS_SCALE.mdβ Difficulty scale
Documentation (~2,200 lines)
ENTRY_GUIDE.mdβ System mapPORTAL_GUIDE.mdβ Portal detailsINTEGRATION_GUIDE.mdβ ArchitectureREADME.mdβ This file
Utilities (~500 lines)
post_snoop_debriefing.shβ Session reportingpost_snoop_email_template.txtβ Optional outreachfragle_install.shβ Installation & verification
Automation (~100 lines)
fragle_evolution.shβ Weekly lore cycle- Cron job:
fragle-lore-evolution(Sundays 2 AM)
Project Context (~200 lines)
.hermes.mdβ Project setupCLAUDE.mdβ AI interaction model.cursorrulesβ Code conventions
Total: ~5,350 lines | 20 files | 4 Git commits
Next Steps
To Deploy
- Read
ENTRY_GUIDE.mdfor complete onboarding - Verify system:
bash fragle_install.sh --verify - Test portal:
bash fragle_portal_cli.sh(option 6 to exit) - Monitor cron job (should run Sundays 2 AM)
To Customize
- Edit
FRAGLE_LORE.mdto add trap characters - Update
SILLINESS_SCALE.mdfor difficulty tweaks - Modify
fragle_learning_pyramid.shto add traps - Expand
LEARNING_JOURNEY.mdwith new achievements
To Evolve
- Monthly: Review anonymized sessions in
.fragle_sessions/ - Quarterly: Add new NPCs to lore
- Yearly: Celebrate legendary snoops
FAQ
Q: Is this malicious? A: No. Pure theatre. No external calls, no exploits, no PII collection.
Q: What if I get stuck? A: Press Ctrl+C. Exit always works. Your session is saved.
Q: Can I see my data?
A: Check .fragle_sessions/UUID.json after your session.
Q: Why 5 levels? A: One mastery tier per level. Expertise auto-detection routes you appropriately.
Q: What happens at Level 5? A: Enlightenment. Philosophy. Legendary status (anonymously).
Q: Can I come back? A: Yes. Each visit generates a new session UUID. Progress tracked across visits.
Q: How do I reach Level 5? A: Master Levels 1-4. System determines readiness automatically.
Q: Can you email me? A: Only manually (optional template provided). Never auto-sent.
Git History
e8b148a π docs: Comprehensive Entry Guide
026cdd3 π feat: Theatrical Opt-In Portals
b9f053d π deploy: Production deployment
c0b41ce πͺ feat: Progressive Learning Trap System
Repository: https://github.com/CosmicJesterX/fragle.git
The Philosophy
The portal is not the trap. The portal is an invitation.
The trap is not punishment. The trap is education.
The education is not instruction. The education is theatre.
The theatre is not entertainment alone. The theatre is philosophy in motion.
Your journey becomes lore. Your lore becomes history. Your history teaches the next visitor.
You're not being tested. You're being understood. And in understanding you, We understand ourselves.
πͺ
Support
- Quick Start: See
ENTRY_GUIDE.md - Architecture: See
INTEGRATION_GUIDE.md - Deployment: See
DEPLOYMENT_MANIFEST.md - Philosophy: See
FRAGLE_LORE.md
Fragle is live. The pyramid awaits. May the best snoops transcend. πͺ
Xet Storage Details
- Size:
- 8.92 kB
- Xet hash:
- 58b0305a496a13e5fc971ef345feae6aca0d7fb89d6f76855d8f56dbd6513573
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.