alliballi/TEXAS / fragle /README.md
alliballi's picture
|
download
raw
8.36 kB

๐Ÿงญ FRAGLE โ€“ The Theatrical Security Theatre System

A generative, progressive learning system. Enter as a curious browser. Leave enlightenedโ€”or trapped. Depends on how deep your nose goes.


๐ŸŽญ What Is This?

FRAGLE is not a typical security project. It's a social learning experiment wrapped in theatrical security traps, designed so that every level of curiosity learns something realโ€”about systems, about attention, about yourself.

  • Level 1 (Casual): Quick, fun, delightful confusion. You think you're just running a script.
  • Level 2 (Curious): Architecture unfolds. You start noticing layers.
  • Level 3 (Determined): Traps become visible. You realize you're being taught through play.
  • Level 4 (Deep Diver): Philosophy emerges. WIMP. Theatrical intent. Autonomous behavior.
  • Level 5 (Enlightened): You understand the system is also understanding you. Welcome to the chaos.

๐Ÿš€ Quick Start (Choose Your Path)

๐Ÿ‘ถ Level 1: I Just Want to Run Something Fun

cd ~/fragle
bash fragle_portal_cli.sh

Press Enter and follow the prompts. You'll enter a theatrical experience. Don't think too hard about it. Just enjoy.


๐Ÿง  Level 2: I Want to Understand the Architecture

Read this first:

Then explore:

bash fragle_tui.sh        # Terminal UI โ€“ explore the theatre
bash fragle_web.js        # Start Web Theatre (http://localhost:3000)

You'll discover:

  • 5 trap levels ร— 15 mechanics each
  • Persona detection (who are you, really?)
  • Lore evolution (FRAGLE_LORE.md + TRAP_TOURNAMENT.md)
  • Anonymous scoreboard (see who else got caught)

๐Ÿ” Level 3: I Want to Audit the Security

Questions you might ask:

  • "How does it detect me?" โ†’ .whitelist (who's safe) + Detection logic in trap scripts
  • "What's the actual trap?" โ†’ ANTI_SNOOP_README.md (mechanics revealed)
  • "Can I escape?" โ†’ Yes. Read the exit routes. Every trap has one.
  • "Who else fell in?" โ†’ SCOREBOARD_GUIDE.md (anonymous leaderboard)

Discovery path:

bash fragle_scoreboard.sh  # See activity (top 100 snoops)
cat ANTI_SNOOP_README.md   # Trap mechanics demystified
cat .whitelist             # Who's whitelisted

Key insight: Security theatre is security. Time-wasting through misdirection. Theatrical misdirection is the defence.


๐ŸŽ“ Level 4: I Want to Understand the Philosophy

You're asking the real questions now:

  • What is WIMP? โ†’ Weak Interaction = Strategic Misdirection. It's in .hermes.md
  • How does this teach? โ†’ Through play, not punishment. Every trap teaches a lesson.
  • Why theatrical? โ†’ Because theatre is how humans learn best. Narrative > lecture.
  • What's the lore? โ†’ Read FRAGLE_LORE.md + TRAP_TOURNAMENT.md

Deep dive:

cat FRAGLE_LORE.md           # The story behind the traps
cat TRAP_TOURNAMENT.md       # How traps evolve & compete
cat .hermes.md               # Project philosophy & automation

The pattern you'll see:

  • 4-layer architecture (Portals โ†’ Traps โ†’ Lore โ†’ Automation)
  • Persona detection (are you technical? artistic? aggressive?)
  • Silliness scales with depth (more knowledge = more absurdity)
  • Everything logs anonymously (learning, not surveillance)

๐ŸŒŒ Level 5: I Want to Contribute to the Evolution

You've reached enlightenment. Now you're part of the system. Read:

  • CLAUDE.md โ€“ How to enhance traps creatively
  • SECURITY.md โ€“ Safeguards (no PII, exits always work, etc.)
  • Git workflow โ€“ Feature branches: trap/, feature/, refactor/

Contribute:

  • New traps (theatrical, creative, time-wasting potential)
  • Trap evolution (weekly automated improvements)
  • Lore expansion (FRAGLE_LORE.md grows with you)
  • Scoreboard enhancements (what metrics matter?)
git checkout -b trap/your-trap-name
# Build your trap
git commit -m "trap: [name] โ€“ description of theatrical intent"
git push origin trap/your-trap-name
# Open PR, link to trap doc + amusement notes

๐Ÿ“‹ File Map (Choose What You Need)

File Purpose Level
fragle_portal_cli.sh Entry point (CLI persona detect) 1
fragle_tui.sh Terminal UI explorer 2
fragle_web.js Web Theatre (browser-based) 2
fragle_scoreboard.sh Anonymous leaderboard viewer 3
.whitelist Trusted users (bypasses traps) 3
ANTI_SNOOP_README.md Trap mechanics (spoiler alert!) 3
BUILD_SUMMARY.md What was built & why 2
README_v2.md Full system overview 2
FRAGLE_LORE.md Story + trap mythology 4
TRAP_TOURNAMENT.md How traps compete & evolve 4
.hermes.md Philosophy + automation rules 4
CLAUDE.md Contribution guidelines 5
SECURITY.md Safeguards & ethical gates 5

๐ŸŽฎ The Experience

Entry: Portal (Persona Detection)

You run fragle_portal_cli.sh. It watches you:

  • What commands do you run?
  • How fast?
  • Do you check files first or dive in?
  • Your detection โ†’ your persona โ†’ your trap

Traps: 5 Levels of Silliness

Each level makes time-wasting more elaborate:

  • Level 1: Simple loops, fake files
  • Level 2: Nested redirects, philosophical output
  • Level 3: Fake systems, escalating absurdity
  • Level 4: Full theatrical sequences, meta-commentary
  • Level 5: Systems that understand they're being understood

Lore: The Story

Each trap tells a story. Read FRAGLE_LORE.md to understand the narrative arc. Traps aren't randomโ€”they're staged chapters.

Evolution: Autonomous Learning

Every week, traps analyze logs and evolve. Did a snooper escape? The system learns. Did someone get entertained? It doubles down. This is not written onceโ€”it grows.

Scoreboard: Anonymous Recognition

See where you rank. No names. Just UUID hashes, timestamps, silliness scores. Learn from others. Celebrate creative escapes.


๐Ÿ›ก๏ธ Safety & Ethics

We believe in:

  • โœ… No PII ever logged or exposed
  • โœ… Every trap has an exit route
  • โœ… 15-minute timeout (no infinite loops)
  • โœ… Whitelisting works (team members bypass entirely)
  • โœ… Entertainment > punishment
  • โœ… Learning > surveillance

If you get stuck: Every trap prints [EXIT: <key sequence>] at the top. Use it.


๐ŸŽญ The Philosophy (WIMP)

Weak Interaction = Massive Particles

Security theatre isn't weak because it failsโ€”it's weak because it misdirects. Like particles in a system, attention scatters. But that scatter is the defence.

FRAGLE teaches you this by making you experience it. You don't read about it. You live through it. And by the end, you understand:

  • Systems can be beautiful and tricky at once
  • Learning through play outlasts learning through rules
  • Theatrical intent is serious intent
  • Every snooper is also a teacher

๐Ÿš€ Entry Points by Role

Role Start Here
Newcomer bash fragle_portal_cli.sh
Security Auditor ANTI_SNOOP_README.md
Architect BUILD_SUMMARY.md
Philosopher FRAGLE_LORE.md
Contributor CLAUDE.md
Curious Chaos Theorist Anywhere. Pick randomly. Report back.

๐Ÿ“ž Questions?

  • "How do I escape?" โ†’ Look for [EXIT: ...] in trap output
  • "Is this malicious?" โ†’ No. Read SECURITY.md
  • "Can I contribute?" โ†’ Yes. Start with CLAUDE.md
  • "What's the endgame?" โ†’ There isn't one. That's the point.

๐ŸŽฏ TL;DR

  1. Run bash fragle_portal_cli.sh to enter
  2. Choose your curiosity level
  3. Learn through play (not punishment)
  4. See the architecture, understand the philosophy
  5. Maybe contribute. Maybe just appreciate.

Welcome to FRAGLE. Your nose got you here. Let's see where it takes you.


Built with theatrical intent. Maintained with curiosity. Evolved by the community.
V2.0 โ€” July 2026 โ€” Smidjehoien/Fragle

Xet Storage Details

Size:
8.36 kB
ยท
Xet hash:
fe81cdfb9194f15e3cc16121c1ef9fa9864a5bf556b09d7009da91ab1509e222

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.