Evidence curation workflow¶
Knowledge turns heterogeneous observations into inspectable evidence state. It does not turn every imported row into a fact. The workflow retains rejected inputs, source context, contradictions, and unresolved questions so downstream decision support can distinguish absence of support from support for absence.
flowchart LR
A[Runtime, core, literature, database, or lab source] --> B[Normalize input]
B --> C[Validate context and provenance]
C --> D[Attach records to versioned bundle]
D --> E[Build and validate evidence graph]
E --> F[Score trust, freshness, coverage, and artifacts]
F --> G[Detect and cluster conflicts]
G --> H{Resolution policy}
H -->|accept or split| I[Record resolution and belief update]
H -->|curation required| J[Escalation queue or hold]
I --> K[Decision-scoped brief]
J --> K
Curate an evidence bundle¶
- Convert each source into
NormalizedEvidenceInputor a typed manual note. Record origin, extraction method, source URI, curator, observation time, and derivation. - Validate the target identifier and biological context. Species, system, sample type, perturbation, dose, timepoint, control, replicate design, normalization, and assay modality belong in the record when relevant.
- Attach quantitative support without flattening uncertainty. Keep confidence intervals, q-values, replicate and peptide counts, localization probability, scale, units, censoring, and artifact flags.
- Run ingestion with a report and retain invalid and duplicate inputs with reasons. Build the bundle only from accepted records.
- Validate bundle integrity and the evidence graph. Dangling edges, missing lineage, duplicate IDs, and decisions without supporting paths are blockers.
Reconcile without erasing disagreement¶
- Compute trust, freshness, context compatibility, modality coverage, and knowledge gaps using explicit policies.
- Detect conflicts before updating claims. Cluster them by decision tag and conflict type so related disagreements are reviewed together.
- Preview the impact of a proposed resolution. High-severity, small-confidence gap, quantitative-direction, and context conflicts may require a hold, curation, or a split rather than automatic preference.
- Persist
ClaimResolutionRecordwith the chosen action, actor, rationale, policy, and affected evidence. Apply belief updates without deleting the losing evidence. - Keep the escalation queue and unresolved questions in the decision handoff.
Publish a decision-scoped view¶
Build KnowledgeDecisionBrief for one decision tag and expected context. The
brief combines ranked evidence, quality audit, evidence-state index,
hypothesis dossier, knowledge gaps, conflict clusters, trust and triangulation,
biological conclusions, operational labels, and a gate recommendation.
Publish the brief with the source bundle, claims, reference-pack identity, policy identifiers, graph validation result, and resolution history. A future brief may supersede the recommendation, but it should remain possible to reconstruct why the earlier evidence state produced its original outcome.