Metadata-Version: 2.4
Name: kryptorious-qbio-coherence
Version: 0.1.0
Summary: Bio-Coherence Falsifier: a computational falsification engine for biological quantum-coherence claims, anchored to the Firmenich 2026 HEOM dephasing baseline.
Project-URL: Homepage, https://github.com/CodeGero/qbio-coherence
Author: Kryptorious Quantum Biosciences
License: MIT
Keywords: coherence,decoherence,falsification,microtubule,quantum-biology
Requires-Python: >=3.9
Requires-Dist: numpy>=1.21
Description-Content-Type: text/markdown

# qbio-coherence — Bio-Coherence Falsifier

A computational falsification engine for biological quantum-coherence claims.
Every verdict is anchored to the **Firmenich et al. (2026) HEOM dephasing
baseline** (γ_dephase = 7.69×10¹³ Hz → τ_coh ≈ 13 fs at 310 K), which is the
rigorous reference for electronic coherence in protein environments and MUST be
cited by any claim of functional biological quantum coherence.

## Why this exists

Quantum biology has been assertion-driven for 30 years. Orch-OR, "quantum
consciousness," and long-range-coherence claims are rarely checked against a real
dephasing floor. This package turns those claims into falsifiable computations:
feed it a claimed coherence time, declare (or omit) a protection mechanism, and
get a verdict — **SURVIVES / FALSIFIED / UNTESTED** — with the failure mode and
the mandatory baseline citation.

## Install

```
pip install kryptorious-qbio-coherence
```

## CLI

```
qbio-falsify baseline            # print the Firmenich floor
qbio-falsify list                # list built-in claims
qbio-falsify check               # falsify all built-in claims
qbio-falsify check "MT collective-mode protection (N=1000)"
qbio-falsify check --json out.json
```

## Library

```python
from qbio_coherence import falsify, get_claim
from qbio_coherence.claims import get_claim
from qbio_coherence.baseline import FIRMENICH_T_COH

report = falsify(get_claim("MT bare electronic (Firmenich null)"))
print(report.verdict)  # FALSIFIED
```

## Honesty constraints

- **Superradiance does NOT protect fidelity.** The Dicke bright state is *N* times
  more sensitive to uncorrelated dephasing. Superradiance only speeds up radiative
  propagation. We never count it as a protection factor.
- Protection factors are only valid inside literature-supported bounds:
  collective √(N), non-Markovian ≤ 5×, entropy-feedback ≤ 50×, structured-bath
  (ENAQT) ≤ 20×.
- A claim with no declared mechanism that exceeds the 13 fs floor is **UNTESTED**,
  not proven — it requires a specific mechanism and experimental confirmation.

## Built-in claims

Microtubule bare floor (Firmenich null), Orch-OR naive, collective-mode protection
(N=1000), avian radical-pair compass (spin regime), photosynthetic FMO/ENAQT, and a
collagen-piezoelectric proton-tunneling speculative claim (flagged as physical
possibility, not demonstrated function).

MIT — Kryptorious Quantum Biosciences.
