SpecsFocus Spatial: See-Through AR Task & Timer Assistant

Inspiration

See-through optical waveguide glasses (Snap Spectacles, 46° diagonal FOV) behave fundamentally differently from video-passthrough headsets: pure black (#000000) renders completely transparent, and central-reticle overlays cause dangerous visual accommodation rivalry during hands-busy tasks like pour-over brewing or electronics soldering.

What it does

SpecsFocus Spatial (specslens_forge + lens_project/SpecsFocusSpatial.esproj) provides a gaze-aware multi-step spatial timer and checklist assistant:

1. Additive Waveguide Palette Validator: Rejects low-luminance dark fills (Y < 0.35) and enforces high-contrast cyan/amber/mint additive strokes.
2. FOV Clutter & Central Cone Guard: Rejects anchors within 8.0° of center gaze unless user dwell >= 600 ms, keeping total FOV occupancy <= 15.0%.
3. Hysteresis Pinch State Machine: Prevents accidental timer triggers using 18 mm enter / 26 mm exit thresholds, 120 ms hold, and 250 ms cooldown.

Verification & Testing

• Unit Tests: 5 passed (pytest -q)
• Design Brief: devpost/design-brief.md + lens_project/SpecsFocusController.ts
• Demo Video: submission_assets/demo_video.mp4 (1920x1080, 150s, H.264/AAC)

Project Overview

SpecsFocus Spatial is an augmented reality spatial timer and surface-anchored task assistant designed for Snap Spectacles ('24) and Lens Studio 5.15+ (Spectacles Interaction Kit / SIK), accompanied by a deterministic Python 3.11 verification and bundle-generation toolkit.

• Public GitHub Repository: https://github.com/cal29292929/specslens-forge
• Author: Kazutoshi Hayashi
• License: MIT

Multi-Model Pipeline Provenance

1. Stage 1 — Architecture Design (claude-opus-5-5): DESIGN_OPUS55.md
2. Stage 2 — Adversarial Architecture Review (gpt-6-luna): REVIEW_LUNA56.md
3. Stage 3 — Core Implementation (Kimi-K2.7-Code @ Sakura AI Engine): specslens_forge/
4. Stage 4 — Post-Implementation Code Review (gpt-6-luna): CODE_REVIEW_LUNA56.md

Quickstart

PYTHONPATH=. pytest -v
PYTHONPATH=. python3 -m specslens_forge.cli simulate --base-dir .

Built With

• lens-studio
• model-context-protocol
• python
• snap-spectacles
• spectacles-interaction-kit
• typescript