alliballi/TEXAS / fragle /README_FINAL.md
alliballi's picture
|
download
raw
8.92 kB

πŸŽͺ 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 & universe
  • TRAP_TOURNAMENT.md β€” rankings & evolution markers
  • LEARNING_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 interface
  • fragle_portal_cli.sh β€” Interactive CLI menu

Lore & Framework (~1,800 lines)

  • FRAGLE_LORE.md β€” Universe & characters
  • TRAP_TOURNAMENT.md β€” Rankings & evolution
  • LEARNING_JOURNEY.md β€” Progression bible
  • SILLINESS_SCALE.md β€” Difficulty scale

Documentation (~2,200 lines)

  • ENTRY_GUIDE.md β€” System map
  • PORTAL_GUIDE.md β€” Portal details
  • INTEGRATION_GUIDE.md β€” Architecture
  • README.md β€” This file

Utilities (~500 lines)

  • post_snoop_debriefing.sh β€” Session reporting
  • post_snoop_email_template.txt β€” Optional outreach
  • fragle_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 setup
  • CLAUDE.md β€” AI interaction model
  • .cursorrules β€” Code conventions

Total: ~5,350 lines | 20 files | 4 Git commits


Next Steps

To Deploy

  1. Read ENTRY_GUIDE.md for complete onboarding
  2. Verify system: bash fragle_install.sh --verify
  3. Test portal: bash fragle_portal_cli.sh (option 6 to exit)
  4. Monitor cron job (should run Sundays 2 AM)

To Customize

  • Edit FRAGLE_LORE.md to add trap characters
  • Update SILLINESS_SCALE.md for difficulty tweaks
  • Modify fragle_learning_pyramid.sh to add traps
  • Expand LEARNING_JOURNEY.md with 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.