feat(layer-101): Quantum Coherence Lab — in-browser phase/interference sandbox

[slavazeph-coder]

Summary

Adds Layer 101 — Quantum Coherence Lab: a single-qubit simulator and panel that runs entirely in the browser, teaching the physical mechanism behind "alignment" — superposition, phase, interference, observation, noise, and decoherence.

• src/utils/quantumCoherence.js — complex helpers (complex, addComplex, mulComplex, abs2, normalizeState), gates (applyH, applyX, applyZ, applyRZ), measurement (measureDistribution, sampleShots), three experiments (runPhaseExperiment, runObservationExperiment, runDecoherenceExperiment), coherenceScore, and mapQuantumToBrainState.
• src/components/QuantumCoherencePanel.jsx — θ slider (0 → π), shots picker (256 / 1024 / 4096), noise slider, X·X depth slider, observe-midway toggle, Scientific / Metaphor mode toggle, P(0) / P(1) bars, coherence score 0–100, plain-English explanation, and a H → RZ(θ) → H → M circuit row.
• Brain mapping: PFC↑ coherence · AMY↑ noise · THL↑ routing · HPC↑ survival · BG↑ dominance · CBL↑ correction · CTX↑ complexity.
• Wiring: panel registered in App.jsx, listed in layerCatalog.js as L101 with a new experimental group.
• Tests: 18 unit tests via Node's built-in node:test runner. npm run test:quantum.
• Docs: README section in brainsnn-r3f-app/README.md that explicitly disclaims literal multiverse, consciousness collapse, Planck foam, and spiritual portal claims — those are framing metaphors only.

No backend, no IBM/OriginQ keys, no secrets. The function surface is intentionally compatible with a future hardware-backed run.

Test plan

• npm install succeeds
• npm run build succeeds (Vite, ~8s)
• npm run test:quantum — 18/18 passing
• Open the app, scroll to the Quantum Coherence Lab panel:
  • θ=0 → P(0) bar at ~100%
  • θ=π → P(1) bar at ~100%
  • θ=π/2 → bars roughly 50/50
  • Slide noise up → both bars approach 50/50, coherence score drops
  • Toggle "observe midway" → bars become ~50/50, score < 40
  • Increase X·X depth → score decays even at noise=0
  • Mode: Scientific ↔ Metaphor flips the explanation
  • "Apply to brain" nudges the 7 regions and toasts

https://claude.ai/code/session_01VYArf8MTS6QdhmswtqNPox

---

Generated by Claude Code

[slavazeph-coder]

Closing as a duplicate of #22, which now ships both the offline Qiskit suite (quantum_alignment/) and the same browser-native Layer 101 (brainsnn-r3f-app/...quantumCoherence...). Same code, broader scope — keeping both open would just create merge conflicts on layerCatalog.js / App.jsx.

---

Generated by Claude Code