Crate renkin 

Modules

agent_replay

Deterministic replay validation for multi-stage agent executions.

bridge

RENKIN Bridge P0: a tool-neutral route audit model.

candidate

Candidate proposal/selection separation inspired by:

chem_env

compiled_stock

Deterministic, integrity-checked stock snapshots.

constraints

Shared validation for route-level planning constraints.

coverage_mode

Shared Stage-1/Stage-2 “coverage mode” orchestration (v0.24, Phase 41.18B), per docs/design/coverage-mode-v0.md. One implementation, called from both src/main.rs (CLI) and src/python.rs (PyO3) – the whole point of this module existing is that neither of those files duplicates staged-escalation logic.

display

diversity

Route-set diversity metrics.

evidence

evidence_match

Deterministic, exact-set batch matching of external reaction records against RENKIN’s stable template_ids (for importing evidence from datasets such as ORD – see scripts/ord_evidence_audit.py).

io_limits

Bounded readers for attacker-controlled local text files.

mcp

MCP (Model Context Protocol) server support for RENKIN.

model_manifest

Reproducibility metadata for optional learned model adapters.

pool_export

JSONL candidate-pool export for offline reranker training/evaluation.

recovery_mode

Opt-in staged recovery for completed, unsuccessful route searches.

reranker

Issue #101: runtime candidate reranker, implementing the pre-existing crate::candidate::CandidateReranker trait against a LightGBM model frozen offline (Issue #101 Task 35, data/phase3e_reranker_training/).

retro_generator

Contract for direct precursor generators (for example Chemformer-like models). The contract is intentionally separate from ReactionPrior: these models propose precursor sets without selecting a RENKIN template.

ring_context

Ring-context safety guard for extracted templates (Issue #72).

score

scorer

search

spectator_bond

SpectatorBondLoss: detects a real target bond that a retro-rule’s own SMIRKS never declares as broken, yet chematic’s reaction engine silently drops when assembling precursors – turning a step that looks atom-balanced into one whose precursors can never forward-reconstruct the target, for a purely mechanical (not chemical) reason.

static_retro_generator

Hash-pinned, file-backed RetroGenerator reference adapter.

static_value_model

Hash-pinned, file-backed value-model fixture.

stock_import

Deterministic stock importer core (v0.36.0 Phase 2, PR 1).

synthesizability

Synthesizability Kernel v0 (docs/design/synthesizability-kernel-v0.md): takes already-produced search routes plus stock/evidence/validation context and returns a decisive, auditable, machine-readable assessment of how well-supported a route is – never a claim that a target cannot be synthesized, and never an uncalibrated score.

template_policy

Reference adapter for deterministic template-policy A/B evaluation.

validation

Route/step plausibility checks, shared by renkin-bench and renkin-mcp.

vendor_stock

Vendor stock import and explicit match-mode classification (v0.38).

wasm_limits

Input limits for the public WASM search surface.

Constants

DEFAULT_BUILDING_BLOCKS

Default set of commercially available starting materials (SMILES).

Functions

sha256_hex

Lower-hex encoding of a digest, shared by every "sha256:<hex>"-style hash string across this crate and renkin-forward. sha2/digest 0.11’s output type (Array<u8, N>, from the hybrid-array crate) no longer implements LowerHex the way generic_array::GenericArray did in 0.10.