hi

.cursorrules

@@ -0,0 +1,59 @@
+# Cursor Rules for Fragle
+
+## Bash Best Practices
+- Shellcheck compliant (pass shellcheck before commit)
+- Shebang: `#!/bin/bash` (explicit, not `/bin/sh`)
+- Strict mode: `set -euo pipefail` for safety
+- Error handling: Trap EXIT, validate inputs
+- Comments: Explain trap logic, not obvious stuff
+
+## File Organization
+- Root scripts: Executable, well-named, self-contained
+- Bin utilities: Reusable functions, sourced by root scripts
+- Documentation: README → MASTER_README → ANTI_SNOOP_README
+- Keep trap mechanics documented as comedy, not secrets
+
+## Trap Design Philosophy
+- Time-waste > data exposure (that's the whole point)
+- Whitelist always works (don't accidentally lock out team)
+- Logging captures performance (audit trail of trolling)
+- Fake files are honeypot (never real secrets here!)
+- Escalation is gradual (annoy, don't traumatize)
+
+## Node.js Secondary Features
+- Keep lightweight (themed wrapper, not main runtime)
+- npm scripts: lint + format on prepare
+- ESLint + Prettier enforced
+- Express endpoints optional (don't bloat if not needed)
+
+## Security & Sanity
+- Never commit real secrets (ever!)
+- Test whitelist thoroughly before merge
+- Don't accidentally trigger own traps in prod
+- Document what each trap does (for team debugging)
+- Fake passwords should be obviously fake (hunter2, etc.)
+
+## Git Workflow
+- Feature branches: `trap/<name>`, `feature/<name>`, `refactor/<name>`
+- Commits: Atomic, reference trap name or enhancement
+- PRs: Link ANTI_SNOOP_README.md sections + explain the joke
+- Pre-commit: shellcheck *.sh passes
+
+## Testing
+- Test as intruder would (follow trap logic)
+- Verify whitelist works (trusted users bypass)
+- Check logging (performance is documented)
+- No skipped tests without justification
+- Document escape artist attempts (they're valuable!)
+
+## Documentation
+- Update ANTI_SNOOP_README.md when adding traps
+- Keep MASTER_README.md synchronized
+- Explain trap mechanics in comments (for team)
+- Never explain the joke to snoops!
+
+## Comedy is Security
+- Entertainment value IS the defense mechanism
+- Trolling is professional here (documented, logged, theatrical)
+- Time-waste = effective security posture
+- Preserve the fourth wall (traps work because snoops take them seriously)

.fragle_anon_data/0e2208c8-92f1-4c31-83ef-e484200992e6_session.json

@@ -0,0 +1,12 @@
+{
+  "session_uuid": "0e2208c8-92f1-4c31-83ef-e484200992e6",
+  "timestamp": "2026-07-16T16:10:18Z",
+  "persona": "technical",
+  "trap_level": 0,
+  "silliness_score": 12,
+  "interaction_count": 0,
+  "duration_seconds": 92,
+  "oracle_queries": 0,
+  "exit_reason": "user_exit",
+  "hash_id": "fragle_9a6c6d20c298"
+}

.fragle_anon_data/f08d80c1-64b9-4fe4-890b-8fd5c91cfcfd_session.json

@@ -0,0 +1,12 @@
+{
+  "session_uuid": "f08d80c1-64b9-4fe4-890b-8fd5c91cfcfd",
+  "timestamp": "2026-07-16T17:19:19Z",
+  "persona": "technical",
+  "trap_level": 0,
+  "silliness_score": 11,
+  "interaction_count": 0,
+  "duration_seconds": 253,
+  "oracle_queries": 1,
+  "exit_reason": "user_exit",
+  "hash_id": "fragle_e7d5a6dcddbe"
+}

.fragle_evolution.log

@@ -0,0 +1,25 @@
+[2026-06-02 09:31:43] 🎪 Fragle Evolution Cycle
+  Sessions this week: 0
+  ✅ Cycle complete
+[2026-06-02 09:41:45] 🎪 Fragle Evolution Cycle
+  Sessions this week: 0
+  ✅ Cycle complete
+[2026-06-10 05:26:01] 🎪 Fragle Evolution Cycle
+  Sessions this week: 0
+  ✅ Cycle complete
+[2026-06-23 16:12:20] 🎪 Fragle Evolution Cycle
+  Sessions this week: 0
+  ✅ Cycle complete
+
+=== SILLY UPGRADE SESSION ===
+Date: 2026-06-29 (Sunday evening vibes)
+Action: npm install --ignore-scripts (safe mode engaged)
+Status: ✅ 326 packages audited, 0 vulnerabilities
+Packages updated: prettier (3.8.3 → 3.9.1 available)
+Major versions available (declined for theatrical stability):
+  - eslint: 8.57.1 → 10.6.0 (too cool for school)
+  - express: 4.22.2 → 5.2.1 (staying humble)
+Package.json enchanted with silly metadata
+Result: Fragle is now 1% more ridiculous, 0% less trap-y
+
+Next victims await...

.fragle_sessions/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2025 CosmicJesterX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

.fragle_sessions/README.md

@@ -0,0 +1,21 @@
+# Project Overview
+
+Welcome! This folder contains part of a larger project managed by CosmicJesterX.
+
+## About
+
+Briefly describe this part of your project here.  
+If this is a standalone module or package, add usage instructions.
+
+## How to Use
+
+- (If required) Install dependencies listed in [requirements.txt](./requirements.txt).
+- Follow additional instructions in this README or the main project README.
+
+## Contributing
+
+Improvements are welcome! If you spot a bug or want to contribute, please open an issue or pull request.
+
+## License
+
+See [LICENSE](./LICENSE) for details.

.fragle_sessions/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Reporting Issues
+
+If you discover a security vulnerability or have a concern, please open an issue or contact CosmicJesterX directly.
+
+## Commitment
+
+We are committed to keeping this project and its users safe. Thank you for helping us improve security!

.fragle_sessions/requirements.txt

@@ -0,0 +1,3 @@
+# List Python dependencies here, one per line.
+# Example:
+# requests>=2.0.0

.github/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2025 CosmicJesterX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

.github/README.md

@@ -0,0 +1,21 @@
+# Project Overview
+
+Welcome! This folder contains part of a larger project managed by CosmicJesterX.
+
+## About
+
+Briefly describe this part of your project here.  
+If this is a standalone module or package, add usage instructions.
+
+## How to Use
+
+- (If required) Install dependencies listed in [requirements.txt](./requirements.txt).
+- Follow additional instructions in this README or the main project README.
+
+## Contributing
+
+Improvements are welcome! If you spot a bug or want to contribute, please open an issue or pull request.
+
+## License
+
+See [LICENSE](./LICENSE) for details.

.github/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Reporting Issues
+
+If you discover a security vulnerability or have a concern, please open an issue or contact CosmicJesterX directly.
+
+## Commitment
+
+We are committed to keeping this project and its users safe. Thank you for helping us improve security!

.github/requirements.txt

@@ -0,0 +1,3 @@
+# List Python dependencies here, one per line.
+# Example:
+# requests>=2.0.0

.github/workflows/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2025 CosmicJesterX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

.github/workflows/README.md

@@ -0,0 +1,21 @@
+# Project Overview
+
+Welcome! This folder contains part of a larger project managed by CosmicJesterX.
+
+## About
+
+Briefly describe this part of your project here.  
+If this is a standalone module or package, add usage instructions.
+
+## How to Use
+
+- (If required) Install dependencies listed in [requirements.txt](./requirements.txt).
+- Follow additional instructions in this README or the main project README.
+
+## Contributing
+
+Improvements are welcome! If you spot a bug or want to contribute, please open an issue or pull request.
+
+## License
+
+See [LICENSE](./LICENSE) for details.

.github/workflows/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Reporting Issues
+
+If you discover a security vulnerability or have a concern, please open an issue or contact CosmicJesterX directly.
+
+## Commitment
+
+We are committed to keeping this project and its users safe. Thank you for helping us improve security!

.github/workflows/requirements.txt

@@ -0,0 +1,3 @@
+# List Python dependencies here, one per line.
+# Example:
+# requests>=2.0.0

.gitignore

@@ -1,2 +1,14 @@
-application/cache/*
-application/logs/*
+# Node modules
+node_modules/
+
+# Logs
+logs/*.log
+
+# Temporary files
+/tmp/fragle_*
+
+# Decoy directory (optional - can be regenerated)
+.secrets_do_not_look/
+
+# Lock files (optional)
+package-lock.json

.hermes.md

@@ -0,0 +1,74 @@
+# Fragle Project Context
+
+## Overview
+**Fragle** — The anti-snoop entertainment system
+
+A theatrical collection of bash scripts designed to detect unauthorized repository snooping, troll curious intruders, and log the entire performance for later amusement. Core philosophy: Make unauthorized access *costly in time*, not data. Entertainment through strategic misdirection.
+
+- **Repo:** github.com/CosmicJesterX/fragle
+- **Status:** Active theatrical security/entertainment project
+- **Team Lead:** almao (ak@almao.bar)
+- **Ecosystem:** CosmicJesterX (aligned with /team project)
+
+## Core Concepts
+- 🎪 **Theatrical** — Trolling is an art form
+- 🛡️ **Defense** — Detect & delay unauthorized access
+- 🎭 **Decoys** — Fake secrets waste intruder time
+- 📊 **Logging** — Document the entire performance
+- 🤐 **Whitelist** — Trusted users bypass the show
+
+## Technology Stack
+- **Bash scripts** (primary) — Detection, traps, escalation, logging
+- **Node.js** (secondary wrapper) — Themed entrypoint
+- **Express.js** — API endpoints (optional)
+- **Tone.js** — Audio notifications (theatrical)
+- **Canvas** — Visual elements (maybe ASCII art?)
+
+## Project Structure
+```
+.
+├── *.sh                        # Core trap & detection scripts
+├── README.md                   # Main overview
+├── MASTER_README.md            # Full script catalog
+├── ANTI_SNOOP_README.md        # Trap documentation
+├── WHITELIST_GUIDE.md          # Trusted user management
+├── index.js                    # Node.js themed entrypoint
+├── package.json                # npm dependencies
+├── .github/                    # CI/CD workflows
+└── bin/                        # Utility scripts
+```
+
+## Key Scripts
+- `smart_snooper_detector.sh` — Whitelist-aware entry checks
+- `greed_amplifier.sh` — "Click for secrets" trap
+- `endless_treasure_hunt.sh` — Infinite breadcrumb nonsense
+- `infinite_rabbit_hole.sh` — 7-phase fake security diagnostic
+- `never_ending_story.sh` — Classified document viewer (ULTIMATE TRAP)
+- `whitelist_manager.sh` — Trust list management
+- `all_seeing_eye.sh` — Session logging everything
+
+## Conventions & Deployment
+- Entry point: `smart_snooper_detector.sh` checks whitelist
+- Traps cascade: Detection → Escalation → Time-wasting loops
+- Logging: All snoop attempts recorded for audit
+- Safety: Never trigger own traps in production (whitelist yourself!)
+- Customization: Scripts encourage creative trap design
+
+## Philosophy
+- Time-wasting ≥ Data protection (cost intruder time, not secrets)
+- Whitelist for collaboration (trusted users see real repo)
+- Trolling as security theatre (entertaining while effective)
+- Anti-snoop mindset (weak visibility, strategic misdirection)
+
+## Important Notes
+- **Entertainment is the feature** — Keep traps creative, funny, theatrical
+- **Whitelist integrity** — Never accidentally lock out team members
+- **Logging is the paper trail** — Trap triggers are valuable audit data
+- **Escalation philosophy** — Make unauthorized access increasingly annoying
+- **Aligned with WIMP** — Weak interaction, invisibility as strength
+
+## Links
+- Repo: https://github.com/CosmicJesterX/fragle
+- Full Catalog: MASTER_README.md
+- Quick Traps: ANTI_SNOOP_README.md
+- Team Context: See /team/.hermes.md (aligned ecosystem)

.pre-commit-config.yaml

@@ -0,0 +1,3 @@
+.. image:: https://results.pre-commit.ci/badge/github/CosmicJesterX/fragle/main.svg
+   :target: https://results.pre-commit.ci/latest/github/CosmicJesterX/fragle/main
+   :alt: pre-commit.ci status

.whitelist

@@ -0,0 +1,25 @@
+# Fragle Repository Whitelist
+# Users listed here are welcome and won't trigger anti-snoop measures
+
+# Owner (always allowed)
+pinky
+
+# Trusted friends and collaborators
+# Add usernames below (one per line, no spaces)
+
+# Example entries:
+# alice
+# bob
+# charlie
+
+# To add someone:
+# 1. Ask their username with: whoami
+# 2. Add it to this list
+# 3. Save the file
+
+# Notes:
+# - Lines starting with # are comments
+# - Blank lines are ignored
+# - Usernames are case-sensitive
+alice
+bob