Interfaces¶

bijux-proteomics-knowledge interfaces are the published shape of evidence work. This section should help a reader see how evidence records, claims, confidence segments, contradiction handling, and review payloads leave the package in forms that other packages and human reviewers can still interrogate.

flowchart LR
    evidence["evidence inputs"]
    claims["claim surfaces"]
    lineage_graph["graph and lineage contracts"]
    confidence["confidence and resolution outputs"]
    review["review artifacts and repositories"]

    evidence --> claims --> lineage_graph --> confidence --> review

What These Interfaces Need To Preserve¶

evidence should remain traceable after it is transformed into claims or reviewable knowledge
contradictions should remain visible in the interface, not hidden inside internal resolution code
downstream consumers need enough structure to ask why a conclusion changed, not just what the new conclusion is

Start With¶

open Data Contracts when the question is how evidence, claims, or reviews are represented
open Artifact Contracts when the concern is lineage, persisted decision briefs, or contradiction-aware outputs
open Operator Workflows when the reader wants the knowledge flow rather than a code inventory
open Compatibility Commitments before changing any surface that other packages use to reason about evidence

Read By Evidence Question¶

Public Imports for programmatic evidence and resolution entrypoints
Data Contracts and Artifact Contracts for the durable shape of knowledge work
API Surface, CLI Surface, and Configuration Surface for automation and operator control
Entrypoints and Examples for concrete examples of contradiction-aware use

What This Section Should Make Clear¶

which public surfaces let readers reconstruct the reasoning path from evidence to review output
where confidence and contradiction are explicit interface concepts rather than background implementation
why repository-facing review payloads are first-class outputs for this package

First Proof Check¶

src/bijux_proteomics_knowledge/memory/models/claims.py, memory/models/evidence.py, and memory/integrity/graph.py
src/bijux_proteomics_knowledge/memory/reconciliation/resolution.py, reviews/decision_briefs.py, and reviews/provenance.py
packages/bijux-proteomics-knowledge/tests