# Clone the standalone GPL-3.0 repository, run the core module fidelity suite, and build release binary
git clone https://github.com/bpwhite/crvscience-labs.git
cd crvscience-labs && cargo test && cargo build --release
# Pipelines 1 & 2 — Core Barcoding & Subtelomeric Non-B DNA Complexity
./target/release/bio-suite agent coi-barcode-cluster --out runs/coi-barcode-report.json
./target/release/bio-suite agent chr1-unbiased-scan --out runs/chr1-complexity-report.json
# Part 1 (Pipelines 3–5) — Standardized High-Yield FASTA/MAG/Biobank Discovery Scanners
./target/release/bio-suite hgt-scan --out runs/hgt-scan-report.json
./target/release/bio-suite bgc-mine --out runs/bgc-mine-report.json
./target/release/bio-suite pseudo-loss --out runs/pseudo-loss-report.json
# Part 2 (Pipeline 6) — Deep Multi-Modal Pangenome Graph & Cryptic Allosteric Pocket Engine
./target/release/bio-suite pan-cryptic --out runs/pan-cryptic-report.json
# Part 3 (Pipelines 7–9 & Master Chaining DAG) — Chained Multi-Modal Discovery Engines
./target/release/bio-suite co-evo --out runs/co-evo-report.json
./target/release/bio-suite chrom-condensate --out runs/chrom-condensate-report.json
./target/release/bio-suite clonal-synth --out runs/clonal-synth-report.json
./target/release/bio-suite haplo-cluster --out runs/haplo-cluster-report.json
./target/release/bio-suite dag-chain --out runs/master-dag-report.json
./target/release/bio-suite sweep --out runs/calibration-sweep-report.json
./target/release/bio-suite registry
Tier 1 • Polite Data Acquisition & Local Cache
src/fetch.rs (bio-suite fetch)
Token-bucket rate-limited NCBI Entrez / Datasets fetcher (≤ 2.5 req/sec with process lockfile coordination and exponential backoff) backed by a SHA-256 content-addressable local disk cache (./cache/) and IUPAC frame-preserving FASTA/GFF3 coordinate slicers.
Tier 3 • Deterministic Worker-Agents & Emergent Composer
src/agent.rs (bio-suite agent)
Strongly typed DAG pipeline composer that seamlessly chains Tier-1 cached datasets through Tier-2 task runners without glue scripts, automatically scanning cross-engine outputs (e.g., K2P phylogenetics × codon Shannon entropy × Non-B DNA) to isolate emergent discoveries.
1. Molecular Systematics & Phylogenomics (bio-suite phylo)
Native Rust Algorithms: Codon-anchored progressive MSA, Kimura 2-Parameter (K2P) & Tamura-Nei (TN93) distance matrices, Ti/Tv substitution bias, Neighbor-Joining (NJ) Newick inference with rayon parallel bootstrap replicates, diagnostic synapomorphy caller, and Automatic Barcode Gap Discovery (ABGD) MOTU clustering.
GPL-3.0 Drop-Ins: OrthoFinder, BUSCO, DIAMOND, MAFFT, MUSCLE5, trimAl, IQ-TREE 2, RAxML-ng, MrBayes, RevBayes, ASTRAL-IV, Dsuite, TreePL, HyPhy.
2. Structural, Population & Functional Genomics (bio-suite genome)
Native Rust Algorithms: Multi-threaded G4Hunter G-quadruplex scanner, alternating purine-pyrimidine Z-DNA propensity scorer, CpG island observed/expected analyzer, annotation-agnostic complexity anomaly peak detector, and GFF3/RefSeq coordinate intersector.
GPL-3.0 Drop-Ins: hifiasm, Verkko, Flye, Minigraph-Cactus, PGGB, vg, DeepVariant, Sniffles2, Helixer, AUGUSTUS, EDTA, Liftoff, Minimap2, MUMmer4, SyRI, GENESPACE, Cooler, MACS3.
3. Genetic Target Identification & Drug Discovery (bio-suite target)
Native Rust Algorithms: Bayesian fine-mapping Wakefield Approximate Bayes Factor (ABF) & 95% credible-set posterior inclusion probability (PIP) engine.
GPL-3.0 Drop-Ins: SuSiE, coloc, PolyFun, TwoSampleMR, S-PrediXcan, FUSION, MAGeCK, BAGEL2, rMATS-turbo, LeafCutter, Whippet, Boltz-1 (MIT complex folding), OpenFold, ESMFold, fpocket, P2Rank, AutoDock Vina, DiffDock, GNINA, OpenMM.
4. Complexity Theory & Information Genomics (bio-suite complexity)
Native Rust Algorithms: Sliding-window k-mer Shannon block entropy (H1 &dots; H6), 256-dim tetranucleotide Kullback-Leibler divergence (DKL), 64-codon RSCU, codon positional entropy (Hpos1, Hpos2, Hpos3), GC3%, Jensen-Shannon compositional divergence (DJS), Lempel-Ziv 1976 (LZ76) Kolmogorov complexity approximation, Purine-Pyrimidine DNA walk Hurst (H) & Detrended Fluctuation Analysis (αDFA), Pangenome Graph Walk Entropy (Hwalk), and Ollivier-Ricci Graph Curvature (κ).
GPL-3.0 Drop-Ins: Jellyfish, KMC3, GeCo3, odgi, panacus, HMMER, Infernal, igraph, graph-tool.
Pipeline 3 • Genomics & Complexity Theory
Horizontal Gene Transfer & Mobile Resistome Scanner (bio-suite hgt-scan)
1. Compositional Anomaly: 5 kb sliding-window 256-dim tetranucleotide Kullback-Leibler divergence (DKL), 64-codon RSCU cosine distance, and GC-skew excursion.
2. Mobility Boundaries: Scans 10 kb flanks for tRNA-attB/attR direct repeats (tRNAscan-SE 2.0), phage integrases (VirSorter2 / PhiSpy), insertion sequences (ISEScan), and plasmid relaxases (MOB-suite).
3. Cargo Interrogation: Screens island ORFs against AMRFinderPlus, CARD, and VFDB to flag mobilized carbapenemase and virulence cassettes.
Pipeline 4 • Drug Discovery & Genomics
Cryptic Biosynthetic Gene Cluster & AMP Miner (bio-suite bgc-mine)
1. sORF & BGC Detection: Runs Prodigal-gv + antiSMASH 7 / GECCO for NRPS, PKS, and short-ORF RiPPs/AMPs (< 100 aa).
2. MIBiG Dereplication: Filters known scaffolds exceeding 80% domain Jaccard similarity via BiG-SCAPE.
3. Self-Resistance Hook & Folding: Uses ARTS to detect duplicated, mutated core essential targets (e.g., embedded second copy of gyrB or rpoB) alongside Eisenberg amphipathic α-helical moment (μH) and ESMFold / Macrel peptide folding.
Pipeline 5 • Systematics & Target De-Risking
Lineage-Specific Pseudogenization & Trait-Loss Detector (bio-suite pseudo-loss)
1. Syntenic Exon Projection: Projects reference coding exons via TOGA / Miniprot + MACSE to call frameshift indels and premature stops (TAG/TAA/TGA).
2. Artifact vs. True Loss: Filters long-read homopolymer errors via phylogenetic sister-clade sharing (IQ-TREE 2) and mosdepth / bcftools coverage.
3. Selection Relaxation & Biobanks: Runs HyPhy RELAX (ω → 1.0, k → 0) and cross-checks gnomAD homozygous pLoF cohorts to isolate de-risked human knockout drug targets.
Pipeline 6 • Complexity Theory + Pangenomics + 3D Chromatin + Structural Drug Discovery
Reconciles HPRC Pangenome Variation Graphs (.gfa), PacBio HiFi / ONT native 5mC methylation, single-cell long-read Iso-Seq, and 3D Markov State Model protein ensembles to discover how braided structural variants alter topological graph walk entropy (Hwalk), disrupt CTCF insulators, elevate transcript splicing entropy (Hiso), and open transient, isoform-selective allosteric drug pockets.
[Deep Cohort Datasets: HPRC Pangenome (.gfa) + PacBio HiFi/ONT 5mC + scIso-Seq + 3D Ensembles]
│
▼
┌──────────────────────────────────────────────────────────────┐
│ Stage 1: Pangenome Graph Complexity & Bubble Entropy Scan │
│ (odgi / vg / Graph-Walk Shannon Entropy / Ollivier-Ricci) │
└──────────────────────────────┬───────────────────────────────┘
│ (Flags Hyper-Complex Structural Hubs)
▼
┌──────────────────────────────────────────────────────────────┐
│ Stage 2: Phylogenetic Coalescent & Selection on Graph Paths │
│ (panacus / Ancestral Recombination Graphs / Tajima's D) │
└──────────────────────────────┬───────────────────────────────┘
│ (Identifies Adaptive / Pathogenic Haplotypes)
▼
┌──────────────────────────────────────────────────────────────┐
│ Stage 3: Epigenomic Phase-Switch & Long-Read Isoform Mapping │
│ (Modkit 5mC / IsoQuant / LeafCutter — Splicing Entropy H_iso)│
└──────────────────────────────┬───────────────────────────────┘
│ (Extracts Disease-Specific Chimeric Isoforms)
▼
┌──────────────────────────────────────────────────────────────┐
│ Stage 4: Conformational Ensemble & Cryptic Pocket Discovery │
│ (Boltz-1 / BioEmu / OpenMM MSM / RIN Centrality / PocketMiner│
└──────────────────────────────────────────────────────────────┘
Pipeline 7 • Systematics + Potts Epistasis + Drug Design
Co-Evolutionary Host-Pathogen Interface & Epistatic Escape Predictor (bio-suite co-evo)
Upstream Seeds: Chains cryptic lineages (P1), HGT islands (P3), self-resistance BGC scaffolds (P4), and pangenome paths (P6).
Stages 1–4: Event-based cophylogeny (eMPRESS / ALE, HyPhy MEME) → APC-corrected Mutual Information (MIi,j) & Potts Direct Coupling Hamiltonian (E(σ)) → AlphaFold 3 Multimer + 100k-step Metropolis-Hastings escape MCMC → frustrated allosteric dead-end target design.
Pipeline 8 • 3D Epigenomics + Structural RNA + LLPS
3D Chromatin Phase-Separation & Non-Coding RNA Scaffolder (bio-suite chrom-condensate)
Upstream Seeds: Chains non-B DNA complexity anomalies (P2) and VNTR epigenetic phase-switches (P6).
Stages 1–4: 3D Micro-C/Pore-C Graph Laplacian Von Neumann Spectral Entropy (SVN) & Fiedler Algebraic Connectivity (λ2) → Infernal SCFG stem-loop aptamers & IDP sticker-spacer grammar → Direct RNA Modkit m6A/Ψ switches → 2′-MOE steric ASO walk & RNA pseudoknot small molecules.
Pipeline 9 • Somatic Phylogenetics + Synthetic Lethality
Somatic Mosaicism, Clonal Entropy & Synthetic Lethal Neoantigen Engine (bio-suite clonal-synth)
Upstream Seeds: Chains non-B DNA fragility breakpoints (P2), somatic gene knockouts (P5), and personal pangenome splicing chaos (P6).
Stages 1–4: Single-cell somatic coalescent phylogeny (BEAST 2 / PhyloWGS) → 96-channel mutational signature JSD & Kolmogorov-Smirnov complexity → truncal LoF to DepMap CRISPR MAGeCK/Chronos synthetic lethality → paralog-selective PocketMiner & HLA-phased neoantigen docking.
Master Chaining Architecture • Directed Acyclic Meta-Pipeline (bio-suite dag-chain)
By ingesting intermediate artifacts (.gfa, .nwk, .mcool, .bed, .pdb) and reusing core binary engines across all 9 pipelines, bio-suite operates as a unified Directed Acyclic Meta-Pipeline (DAG) where discoveries from standardized FASTA scanners automatically seed multi-modal structural and therapeutic engines.
[PIPELINE 1: phylo-audit] [PIPELINE 3: hgt-scan] [PIPELINE 4: bgc-mine]
(rRNA SCFGs, ETE3, IQ-TREE) (KL-Divergence, AMRFinder) (antiSMASH, ARTS, ESMFold)
│ │ │
└────────────────────┬─────────────────────┘ │
▼ │
[PIPELINE 7: co-evo] ◄────────────────────────────────────────────────┘
(Potts Epistasis + Host-Pathogen AF3 Multimer + Escape MCMC) (Feeds novel BGC scaffolds +
│ resistance targets into
▼ co-evolutionary docking)
(Identifies Conserved Allosteric
Pockets & Escape-Proof Ligands)
[PIPELINE 2: chr-probe] [PIPELINE 6: pan-cryptic] [PIPELINE 5: pseudo-loss]
(GeCo3, DFA, G4Hunter, Micro-C) (odgi Graph Entropy, Modkit, (TOGA, MACSE, HyPhy RELAX)
│ IsoQuant, PocketMiner) │
│ │ │ │
└──────────────────┬─────────────────┘ └─────────────┬────────────┘
▼ ▼
[PIPELINE 8: chrom-condensate] [PIPELINE 9: clonal-synth]
(3D Graph Laplacians + lncRNA SCFGs + m6A + (Somatic BEAST2 Trees + CRISPR MAGeCK +
Condensate Dissolving ASOs/Small Mols) Paralog PocketMiner + HLA Neoantigens)