Module models 

Structs

Assessment

Paper x research question -> relevance score + provenance.

AssessmentId

CandidatePaper

Un-deduplicated paper record from a single source adapter.

Citation

Directed citation edge between two papers.

Paper

Canonical, deduplicated paper record.

PaperId

QuestionId

ResearchQuestion

First-class research question entity.

Search

Immutable search run record.

SearchId

SearchResult

Join record: search -> paper, with per-source rank/score.

SearchTerm

Keyword combination linked to a research question.

SearchTermId

SnowballRun

Record of a snowball (citation chaining) run.

SnowballRunId

SourceOutcome

Per-source result metadata for a search run.

Enums

CitationDirection

Direction of a citation edge.

SourceStatus

Outcome status for a single source in a search run.

Functions

doi_to_filename

Sanitize a DOI for use as a filename: replace / with _, keep only safe chars.

normalize_doi

Normalize a DOI string: trim whitespace, strip common URL prefixes, lowercase.

validate_doi

Validate a DOI string against the standard format: 10.NNNN…/suffix.