sobermind 0.0.1

SoberMind CLI Autopilot Interrupter

🌌 SoberMind // Autopilot Interrupter

Interrupt automatic behaviors, process dopamine cravings, and regain conscious control using the 90-Second Rule.

SoberMind is a premium, high-aesthetic single-page web dashboard designed to intercept subconscious habits (like scrolling social media, boredom eating, or compulsive shopping). It combines interactive somatic grounding interfaces with synthetically generated, real-time ambient drone audio to guide your nervous system from reactivity back to cognitive clarity.

---

⚡ Quick Links

• Live UI Layout: index.html
• Custom Stylesheet: style.css
• Audio & Logic Controller: app.js

---

🧠 The Science: The 90-Second Rule

"When a person has a reaction to something in their environment, there’s a 90-second chemical process that happens; any remaining response is just the person choosing to stay in that loop."
— Dr. Jill Bolte Taylor, Harvard Neuroanatomist

When an impulse fires, a chemical surge floods your system. If you do not feed the impulse with automatic thoughts, the physiological urge peaks and dissipates naturally within 90 seconds. SoberMind creates a visual and somatic container to safely navigate this critical window.

---

🛠️ Key Architectural Features

Module	Core Technology	Visual / Interactive Polish
Constellation Particle Canvas	HTML5 Canvas + Physics	Renders floating points with real-time neural connections drawn between close nodes.
Calming Web Audio Synthesizer	Web Audio API (Oscillators)	Generates Binaural Theta (6Hz shift), Synthetic Rain sweeps, or Deep Space Drone dynamically without asset loads.
Circular Countdown Ring	SVG Vector Stroke Math	Progress ring depletion dynamically matched to clock ticks via strokeDashoffset.
Grounding Steppers	Interactive JS State Engine	Visual breathing guides (4-7-8 rhythm), Somatic 5-4-3-2-1 check-ins, and cognitive logs.
Strict Mode Guard	Javascript Lock Loop	Disables cancellation triggers after 15 seconds to prevent impulsive exits.
Premium Tactile Loops	Web Audio + CSS variables	Cursor-spotlight panels, breathing background pulses, distinct choice chimes, and hotkey presses.

---

🌌 Premium Micro-Reactions & Tactility

SoberMind is designed to feel alive, responsive, and immersive:

• Spotlight Hover Glows: Glass panels trace mouse cursor coordinates with a soft spotlight glow matched to the active Aura Palette.
• Somatic Breathing Pulse: Viewport background glow expands and contracts in sync with inhale, hold, and exhale cycles.
• Linear Sound Fades: Synthesized soundscapes fade in over 1.5s and out over 1.0s to avoid jarring starts and stops.
• Somatic Validation Delights: Inputs in sensory check-ins trigger high-frequency double blips, green highlights, and card shakes.
• Outcome Sound Signatures: Selected paths play distinct audio cues (ascending chime, grounding drone, or triangle-wave sweep).
• Strict Lockdown Alerts: Escape or Cancel presses after 15s lockouts trigger low warning buzzers and red shakes.
• Hotkey Visual Press: Inline hotkey badges visually compress (scale-down/glow) when their physical keys are pressed.

---

🧬 System Flow & Interactions

graph TD
    A[User encounters habit trigger] -->|Inputs intent to dashboard| B(Initiate 90s Pause)
    B --> C{Enforce Calming Mode}
    C -->|Breathing| D[Pulsing 4-7-8 Breath Circle]
    C -->|Sensory| E[5-4-3-2-1 Somatic Stepper]
    C -->|Reframing| F[Local Micro-Journal Prompts]
    C -->|Ambient| G[Silent Zen Text slider]
    
    H[Web Audio Synth Channels] -.->|Binaural / Rain / Drone| C
    I[Interactive Star Canvas] -.->|Visual Constellation Mesh| C
    
    C --> J{Strict Mode Lock?}
    J -->|Yes| K[Hide Abort Button after 15s]
    J -->|No| L[Allow Abort with Streak Reset]
    
    K --> M[Countdown completes]
    L --> M
    M -->|Play Success Chime| N[Confirm Autopilot Bypassed]
    N -->|Update Streak & SVG Chart| O[Synchronize to LocalStorage]

---

🎨 Visual Aesthetics & Design System

SoberMind is crafted around a sleek space-nebula glassmorphic aesthetic:

• Typography: Display elements use the clean geometric font Outfit paired with Inter for crisp text layout.
• Glassmorphic Cards: High-contrast panels designed with backdrop-filter: blur(25px) and delicate borders (rgba(255,255,255,0.07)) floating over a deep space radial gradient.
• Micro-Animations: Fluid bezier scaling, pulsing breath circles, target sweeps, and glowing indicator states.

---

🚀 Setup & Launch

1. Official Terminal CLI Command (Recommended)

You can install and run the SoberMind interrupter directly from your command terminal using our official PyPI package:

pip install sobermind

Once installed, execute the command from any directory or shell session:

sobermind "impulse name"

2. Direct Web Preview (No Installation Needed)

Since SoberMind's dashboard is built using zero-dependency vanilla technologies, you can open the file index.html directly in any modern web browser to run the app immediately.

3. Local Serving (Development Server)

For serving the multi-page web app and contributing to development:

# Navigate to project folder
cd sobermind-interrupter

# Install developer dependencies (Vite)
npm install

# Run the development server
npm run dev

Open http://localhost:5174/ in your browser to inspect the application.

---

📄 License

This project is licensed under the MIT License. Feel free to customize and expand it as needed.