Metadata-Version: 2.4
Name: kryptorious-qbio-coherence
Version: 0.2.1
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
qbio-falsify board --summary     # coherence leaderboard summary
qbio-falsify board               # full leaderboard
```

Run the module with `python -m qbio_coherence.cli ...` (do NOT use
`python qbio_coherence/cli.py` directly — it imports the package and raises a
`RuntimeWarning`/import-order issue).

## Leaderboard (agentic layer)

The leaderboard is a persistent JSON registry of falsified claims — the public
asset labs cite. Seed it with the verified built-in library, then append agent-
extracted claims:

```
python -m qbio_coherence.ingest --self-test --path leaderboard.json
python -m qbio_coherence.ingest --claims extracted.json --path leaderboard.json
python -m qbio_coherence.cli board --summary
```

The agent extracts a claim (claimed τ, temperature, system, mechanism) from a
paper; `ingest` runs the physics-enforced verdict and appends it. The verdict
stage is deterministic and never bypasses the Firmenich floor.

```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.
