Metadata-Version: 2.4
Name: kryptorious-qbio-coherence
Version: 0.3.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
```

## NULLIUS: the adversarial truth ledger

NULLIUS ("take nobody's word for it") layers permanent, tamper-evident
accountability on top of the falsifier (v0.3.0+). It is the public record that
turns one-off verdicts into an auditable scientific ledger.

- **Tamper-evident ledger** (`python -m qbio_coherence.ledger_cli`): every verdict
  is recorded as a hash-chained entry (sha256 of `prev_hash || payload`). Altering
  any past verdict breaks the chain from that point forward, detectable by
  `verify`. The scientific record becomes auditable, not editable.
- **Adversarial attack swarm** (`ledger_cli attack`): probes each verdict across
  the full literature-supported parameter range and classifies robustness --
  ROBUST / FRAGILE / EDGE / RECOVERABLE / FIRMLY FALSIFIED. A claim that "survives"
  only at the most favorable parameter extreme is flagged before it enters the
  literature. This is automated adversarial peer review.
- **Verdict certificate** (`ledger_cli cert`): a portable markdown attestation a
  researcher can attach to a preprint, embedding the ledger entry hash so anyone
  can verify it against the public chain.
- **Public board** (`ledger_cli board`): a self-contained, color-coded HTML page
  (green/falsified/amber) for any lab, journal, or skeptic to audit. Host on
  GitHub Pages, a static bucket, or IPFS.

```bash
python -m qbio_coherence.ledger_cli commit --reset   # seed ledger from built-in verdicts
python -m qbio_coherence.ledger_cli verify           # recompute full chain, report tamper status
python -m qbio_coherence.ledger_cli attack --json attack_report.json
python -m qbio_coherence.ledger_cli board --out nullius_board.html
python -m qbio_coherence.ledger_cli cert "MT Orch-OR functional coherence (naive)" --out cert.md
```

The certification *market* (badge API, institutional access, crypto settlement)
is intentionally out of scope for v0.3.0: credibility first, monetization second.
The ledger, swarm, certificate, and board are the free, reputation-building layer.

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