Skip to content

NosoGraph v0.2.0 — Compare V2

NosoGraph v0.2.0 ships Compare V2 as a usable public-alpha research workflow. Researchers can select two through five imported diseases, choose one or more evidence dimensions, inspect shared and distinguishing entities, identify missing curation, follow supporting assertions into Evidence Explorer, and export the same deterministic result for review or automation.

Highlights

  • Deterministic cohorts of two through five unique, resolved condition CURIEs.
  • Phenotype, gene, pathway, treatment, and evidence-coverage dimensions in a fixed canonical order.
  • Shared-by-all, shared-by-subset, disease-distinct, KNOWN_ABSENT, and NOT_RECORDED views.
  • Structured missing-curation, asymmetric-curation, and conflicting-assertion warnings.
  • Evidence Explorer links for the exact positive and negated claims behind each recorded state.
  • Canonical JSON and timestamp-free Markdown exports with stable ordering and filenames.
  • Accepted Compare V2 semantics ADR, result-schema versioning, golden fixtures, API tests, and Playwright coverage through both deterministic mocks and the live FastAPI seam.

API and compatibility

The canonical endpoint is POST /api/v1/nosograph/comparisons. It accepts condition_curies and optional dimensions, validates a cohort of two through five unique conditions, and returns HTTP 200 for both comparable and valid insufficient_data results. Persisted results can be retrieved or exported by run ID.

The deprecated POST /api/v1/nosograph/compare endpoint remains as a two-condition projection. Its legacy mechanism dimension maps to pathway. The separate scored comparison API is unchanged.

Compare semantics use algorithm nosograph-compare-v2 version 2.0.0. The persisted response contract is independently versioned as schema 2.0, preventing older incomplete payloads from being replayed for new requests after contract evolution.

Interpretation

KNOWN_ABSENT requires an explicit current negated assertion. NOT_RECORDED means neither a positive nor a negated assertion is present in the active imported snapshots. Empty data is not evidence of absence. When positive and negated assertions coexist, PRESENT takes precedence, both claim directions remain available for inspection, and a conflict warning is emitted.

NosoGraph Compare does not produce a universal similarity score. Coverage and overlap reflect imported snapshots and curation depth, not clinical truth.

Verification

The release gate covers the complete offline suite, Ruff lint and format checks, dependency locks, import boundaries, public metadata and fonts, strict documentation build, deterministic export fixtures, API tests, and Playwright product flows.

make ci-local
make test-browser
python -m mkdocs build --strict
python scripts/check_public_metadata.py

Maturity

Public Alpha — research use only. NosoGraph is not medical advice, a diagnostic system, or clinical decision support. No public hosted demo is deployed.