This is a submission for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass
The 3-Hour Compiler Trap & Prefrontal Exhaustion
Every software engineer knows the suffocating sensation of hour three.
You are hunting an intermittent race condition, an elusive memory leak, or a broken build pipeline. Your eyes are dry and stinging from the 120Hz monitor. Your shoulders are hunched toward the keyboard. You re-read the exact same stack trace for the fourteenth time, convinced that if you just squint a little harder at line 142, the missing semicolon or dangling pointer will magically reveal itself.
It never does.
Instead, something biologically destructive is occurring inside your skull: Prefrontal Cortex Working Memory Exhaustion.
In neuroscience, conscious analytical debugging relies strictly on the brain's Focused Mode—a high-energy neural state mediated by the prefrontal cortex and sustained by dopamine reserves. When you stay locked in focused mode for hours without reprieve, two cognitive breakdowns occur:
- Cognitive Tunneling (Einstellung Effect): Your neural firing loops become rigid. The brain hyper-focuses on flawed initial assumptions, physically blinding you to lateral architectural solutions that are obvious in hindsight.
- Scotopic Ciliary Spasm: Staring at high-contrast pixels 50 centimeters from your face locks your eye lenses into continuous ciliary contraction, signaling persistent low-grade sympathetic stress to the central nervous system.
| The Screen-Locked Engineer | The Natural Diffuse Reset |
|---|---|
| Hours staring at the same stack trace | Prefrontal cortex rests; Default Mode Network (DMN) engages |
| Repeatedly running failed tests with no insight | Associative memory connects non-adjacent conceptual nodes |
| Ciliary eye strain from 50cm screen focus | Distant optical horizon gazing relaxes lens muscles |
| Dopamine depletion & irritable burnout | Natural daylight exposure resets circadian rhythm and cortisol |
The great breakthroughs in computer science—from Archimedes stepping into the bath to developers realizing the solution to an architectural bug while stepping away from their desk—almost never happen while furiously typing. They happen when the conscious mind steps back and allows the Diffuse Mode (Default Mode Network) to subconsciously synthesize associative solutions across disparate memory networks.
When DEV announced the Touch Grass Challenge for Week 1 of Hacktoberfest 2026 with the mandate:
"Make the screen the shortest part of the experience."
I knew I didn't want to build a gamified habit-tracker or another screen-heavy social dashboard that forces developers to look at their phone while outdoors.
I built the exact opposite: an anti-distraction cognitive dispatcher designed to require under 15 seconds of screen interaction before closing your laptop, stepping outside into natural daylight, and letting diffuse biology solve the bug.
I call it BreakPoint ☀️.
What I Built
BreakPoint translates the core debugging principle of a software breakpoint—temporarily suspending execution to inspect state before resuming—into human biological hardware.
It is an offline-first, client-side progressive web application that dispenses customized 15-, 20-, or 30-minute outdoor cognitive reset missions tailored to your specific mental blocker.
BreakPoint Master UI System: Discharging digital work to step outside into natural daylight and diffuse thinking.
What does it do, and how does it get people off the screen?
Most wellness apps demand continuous attention with feeds, notifications, and gamification badges. BreakPoint is architected around the opposite principle: Zero-Screen Field Protocol.
-
15 Seconds Before Departure: Open BreakPoint, select your active fatigue blocker (
Complex Bug,Merge Conflict,Memory Leak, orDeploy Burnout), pick a duration tier (15, 20, or 30 minutes), and get your solar trajectory. - Zero Screens Moving: Pop in an earbud for a 20-second Web Audio acoustic briefing (432 Hz sine chime + spoken milestones) or glance at a 1080×1920 mobile lockscreen field card.
- Laptop Closed, Phone in Pocket: Step out the door. The app calculates your exact half-way turnaround time and observation milestones so you never have to unlock your screen during the walk.
Demo
- 🌐 Live Application (GitHub Pages): https://smtahosin.github.io/breakpoint/
- 🚀 GitHub Repository: https://github.com/smtahosin/breakpoint
1. Home Interface (/)
An anti-distraction entry deck presenting real solar data, 20-minute reset metrics, and instant launch CTAs:
Home Deck: Real-time NOAA solar metrics, 20-minute reset duration, and instant dispatcher launch.
2. Tactical Mission Dispatcher (/start/)
Configure your reset duration, select from 4 cognitive blocker presets, and observe real-time NOAA solar telemetry with live turnaround deadlines:
The Tactical Dispatcher UI: Instant celestial ephemeris, half-way turnaround milestones, and tailored cognitive tasks.
3. Pocket Field Card & 1080×1920 Lockscreen Studio (/field-card/)
Generate a printable 3×5 physical card or export an offline 1080×1920 mobile wallpaper to keep your phone locked in your pocket:
Pocket Field Card Studio: High-contrast lockscreen field card preview and Web Audio playback controls.
4. Neuroscience Foundation & Interactive Ephemeris Calculator (/science/)
Explore the dual-mode brain state visualizer and inspect the Spencer/Meeus NOAA astronomical formulas:
Neuroscience Explorer: Focused vs. Diffuse cognitive modes and biological reset mechanics.
Code
BreakPoint is 100% open-source under the MIT License:
- 📦 GitHub Repository: https://github.com/smtahosin/breakpoint
- 📜 Entire Checkpoints Branch:
entire/checkpoints/v1
# Clone the repository
git clone https://github.com/smtahosin/breakpoint.git
cd breakpoint
# Install dependencies
npm install
# Run automated test suite
npm test
# Run local development server
npm run dev
# Build static production export
npm run build
Automated Unit Test Suite (23/23 Passing)
BreakPoint includes a comprehensive, deterministic test suite verifying NOAA physics, cognitive dispatch, and storage persistence:
> breakpoint@1.0.0 test
> tsx --test tests/solar-engine.test.ts tests/cognitive-engine.test.ts tests/mission-store.test.ts
▶ BreakPoint Cognitive Engine — Deterministic Reset Missions
✔ supports all 4 cognitive blocker presets (1.54ms)
✔ correctly calculates turnaround and return times for 15, 20, and 30 minute durations (0.35ms)
✔ adapts observation task for daytime vs nighttime missions (0.32ms)
✔ generates concise spoken audio script containing vital return milestones (0.94ms)
✔ guarantees deterministic mission generation for identical inputs (0.86ms)
✔ enforces physical safety notices on all generated missions (0.15ms)
✔ BreakPoint Cognitive Engine — Deterministic Reset Missions (5.72ms)
▶ BreakPoint Mission Store — Persistence & SSR Fallback
✔ provides safe default mission during SSR when window is undefined (1.25ms)
✔ persists and restores mission when localStorage is available (0.50ms)
✔ gracefully handles corrupt JSON in localStorage without throwing (0.48ms)
✔ BreakPoint Mission Store — Persistence & SSR Fallback (3.29ms)
▶ BreakPoint Solar Engine — NOAA Mathematical ephemeris
✔ handles equator near solar noon on vernal equinox (17.00ms)
✔ calculates London summer solstice solar elevation correctly (1.09ms)
✔ calculates Southern Hemisphere (Sydney) winter noon correctly (0.23ms)
✔ handles Arctic Circle / Tromsø Polar Night in December (0.14ms)
✔ handles Arctic Circle / Tromsø Midnight Sun in June (0.16ms)
✔ classifies twilight and night states accurately with honest lux labels (0.17ms)
✔ safely clamps out-of-range coordinates without throwing or NaN (0.13ms)
✔ safely handles invalid Date instances without NaN crash (0.29ms)
✔ enforces optical and physical safety in returned advice (0.43ms)
▶ Independent Astronomical Regression Fixtures
✔ matches NREL Solar Position Algorithm (SPA) benchmark (Reda & Andreas 2004) (0.35ms)
✔ matches Jean Meeus (Astronomical Algorithms 1998 Ch. 25) meridian transit benchmark (0.14ms)
✔ matches NOAA Global Monitoring Laboratory solstice benchmark (Boulder, CO) (0.11ms)
✔ matches US Naval Observatory high-latitude winter solstice skim (Fairbanks, AK) (0.19ms)
✔ matches equinox exact cardinal sunrise (90° E) and sunset (270° W) at equator (0.24ms)
✔ Independent Astronomical Regression Fixtures (1.30ms)
✔ BreakPoint Solar Engine — NOAA Mathematical ephemeris (22.24ms)
ℹ tests 23
ℹ suites 4
ℹ pass 23
ℹ fail 0
ℹ duration_ms 236.26ms
Tech Stack Breakdown
- Framework: Next.js 15.2.1 (React 19, TypeScript 5.8)
-
Styling: Pure Custom Vanilla CSS tokens (
src/styles/globals.css) — Zero Tailwind, zero external UI kits - Solar Physics: Client-side Spencer (1971) & Jean Meeus (1998) NOAA Solar Position Algorithms
- Audio Synthesis: Native Web Audio API (432 Hz calming sine oscillator) & Web Speech API
- Canvas Exporter: Native HTML5 Canvas 2D engine generating 1080×1920 PNG lockscreen wallpapers
-
PWA & Offline: Scope-relative custom Service Worker (
public/sw.js) supporting GitHub Pages subpaths
How I Built It
BreakPoint is architected with a strict client-side, zero-telemetry philosophy. All astronomical ephemeris calculations, speech syntheses, audio waves, and canvas wallpaper generations occur locally on your device with zero cloud tracking and zero API latency.
System Architecture
flowchart TD
subgraph S1["1. Pre-Departure Tactical Dispatcher [Step 1: Screen Time < 15s]"]
A["<b>Fatigue Blocker Selector</b><br/>Complex Bug · Merge Conflict · Memory Leak · Pre-Deploy Burnout<br/>Duration Tiers: 15m · 20m · 30m | Turnaround Milestone Calculation"]
end
subgraph S2["2. Deterministic NOAA Ephemeris & Cognitive Engine"]
B["<b>Spencer / Meeus NOAA Solar Ephemeris Algorithm</b><br/>Solar Declination · Equation of Time · Saemundsson Atmospheric Refraction"]
C["<b>Clear-Sky Physical Illuminance Model</b><br/>74,874 lux Direct Beam · Twilight Logarithmic Falloff · Night Clamping"]
D["<b>Diffuse Mode Cognitive Mission Dispatcher</b><br/>Associative Memory Shift · Ciliary Eye Relaxation · Optical Horizon Rules"]
B --> C --> D
end
subgraph S3["3. Zero-Screen Dispatches & Audio Synthesis Layer"]
E["<b>Synthesized Mission Directive & Safe Horizon Waypoints</b><br/>“Turn around at 10 minutes. Fix gaze on distant ridge or tree contour.”"]
F["<b>Native Web Audio Engine</b><br/>432 Hz Calming Sine Wave Osc<br/>Exponential Envelope Smoothing"]
G["<b>Native Web Speech API</b><br/>Zero-Latency Hands-Free Briefing<br/>Dedicated Queue Cancellation"]
E --> F
E --> G
end
subgraph S4["4. Lockscreen & Offline Field Persistence"]
H["<b>HTML5 Canvas 2D Engine</b><br/>1080×1920 Mobile Lockscreen Card<br/>Offline PWA Cache (sw.js)"]
end
subgraph S5["5. AI Provenance & Verification Layer (Best Use of Entire)"]
I["<b>Entire.io Session Provenance</b><br/>Checkpoint: b197c747e707 · Provenance Branch: entire/checkpoints/v1<br/>4 Architectural Decision Records (ADRs) · 23/23 Automated Unit Tests Passing"]
end
A --> B
D --> E
E --> H
S2 -.-> S51. Deterministic Spencer/Meeus NOAA Solar Ephemeris Engine
Instead of querying rate-limited third-party weather APIs, BreakPoint executes the deterministic NOAA mathematical formulas directly in client-side TypeScript:
Fractional Day Angle ($\gamma$):
$$\gamma = \frac{2\pi}{365} \cdot \left(\text{day_of_year} - 1 + \frac{\text{hour} - 12}{24}\right)$$Equation of Time ($E_t$) & Solar Declination ($\delta$):
$$E_t = 229.18 \cdot (0.000075 + 0.001868\cos\gamma - 0.032077\sin\gamma - 0.014615\cos 2\gamma - 0.040849\sin 2\gamma)$$
$$\delta = 0.006918 - 0.399912\cos\gamma + 0.070257\sin\gamma - 0.006758\cos 2\gamma + 0.000907\sin 2\gamma$$Solar Elevation ($\alpha$) & Atmospheric Refraction:
$$\sin\alpha = \sin\phi\sin\delta + \cos\phi\cos\delta\cos H$$
Near the horizon, atmospheric refraction is computed via Saemundsson (1986):
$$R = \frac{1.02}{\tan\left(\alpha + \frac{10.3}{\alpha + 5.11}\right)} \quad \text{(arcminutes)}$$
// src/lib/solar-engine.ts - Deterministic NOAA Ephemeris
export function calculateSolarPosition(
latitude: number,
longitude: number,
date: Date = new Date()
): SolarTelemetry {
const safeLat = Math.max(-90, Math.min(90, latitude));
const safeLng = Math.max(-180, Math.min(180, longitude));
const dayOfYear = getDayOfYear(date);
const hour = date.getUTCHours() + date.getUTCMinutes() / 60;
const gamma = (2 * Math.PI / 365) * (dayOfYear - 1 + (hour - 12) / 24);
// Spencer Equation of Time & Solar Declination
const eqtime = 229.18 * (0.000075 + 0.001868 * Math.cos(gamma) - 0.032077 * Math.sin(gamma));
const decl = 0.006918 - 0.399912 * Math.cos(gamma) + 0.070257 * Math.sin(gamma);
// Hour Angle & True Elevation
const timeOffset = eqtime + 4 * safeLng;
const ha = (((hour * 60 + timeOffset) / 4) - 180) * (Math.PI / 180);
const latRad = safeLat * (Math.PI / 180);
const sinElev = Math.sin(latRad) * Math.sin(decl) + Math.cos(latRad) * Math.cos(decl) * Math.cos(ha);
const elevation = Math.asin(Math.max(-1, Math.min(1, sinElev))) * (180 / Math.PI);
// Saemundsson Refraction Correction
const refr = elevation > -5 ? (1.02 / Math.tan((elevation + 10.3 / (elevation + 5.11)) * (Math.PI / 180))) / 60 : 0;
return { elevation: Math.round((elevation + refr) * 10) / 10, ... };
}
2. Zero-Latency Acoustic Briefing (Web Audio & Speech API)
-
Web Audio 432 Hz Sine Chime: Native
window.AudioContextsynthesizes a harmonic relaxation tone with exponential envelope ramps (exponentialRampToValueAtTime) to eliminate clipping and audio artifacts. -
Native Web Speech API: Synthesizes spoken mission instructions directly in the browser with automatic queue flushing (
window.speechSynthesis.cancel()) to prevent overlapping utterance bugs. - 1080×1920 Canvas Wallpaper Generator: Generates an ultra-crisp mobile lockscreen PNG so users can view return deadlines and checklists without unlocking their phones.
Why Does Open Innovation Matter?
In an era where everyday developer utilities are increasingly wrapped in proprietary cloud APIs, invasive tracking pixels, and subscription paywalls, BreakPoint is a commitment to open innovation:
- Verifiable Astronomical Physics Over Closed APIs: By publishing the full Spencer/Meeus NOAA solar engine in open-source TypeScript, BreakPoint eliminates external server dependencies and rate limits. The mathematical proofs can be independently audited, tested, and integrated by any developer worldwide.
- Zero-Telemetry Privacy: Your mental health, cognitive fatigue blockers, and geographic coordinates are your personal business. Open-source architecture allows any engineer to verify that zero analytics or coordinates ever leave their browser.
- Accessible Offline Resilience: Software engineers work in basements, rural hack houses, and cellular dead-zones. Open web standards (Service Workers, Web Audio, HTML5 Canvas) allow BreakPoint to function completely offline without internet connectivity.
Prize Categories
This project is entered into the following partner category for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass:
- 🏆 Best Use of Entire: BreakPoint integrates Entire.io's AI provenance layer throughout the entire engineering lifecycle—capturing prompt trajectories, recording formal Architectural Decision Records (ADRs), linking Git commit trailers (
Entire-Checkpoint: b197c747e707), maintaining an authentic provenance branch (entire/checkpoints/v1), and rendering an interactive session provenance inspector directly inside the user interface.
Stepping Away from the Screen
As developers, we pride ourselves on persistence. We treat marathon debugging sessions as badges of honor, convincing ourselves that brute force and another cup of black coffee will eventually conquer the bug.
Yet the biological reality is that software engineering is an act of creative synthesis, not mechanical data entry. When our prefrontal cortex is exhausted, more screen time only generates more friction, more bugs, and deeper cognitive fatigue.
Building BreakPoint taught me that the most powerful debugging tool is often not another profiler, another breakpoint, or another AI chat window. It is the simple, humble decision to close the laptop lid, step outside into natural daylight, feel the sun on your face, and let your brain's diffuse mode do what millions of years of human biology evolved it to do.
How do you manage cognitive lock when an intractable bug has you trapped in a mental loop? Do you have an established ritual for stepping away from the keyboard, or do you find yourself falling into the 3-hour compiler trap? I would love to hear your outdoor reset routines and debugging breakthroughs in the comments below.
Top comments (1)
|> Just a joke: do not!
