Repository fit¶
Core is the scientific authority of the package family. It owns the meaning of proteomics inputs, calculations, validation policies, result contracts, and family-specific acceptance. It exists separately so scientific truth does not depend on how work was scheduled, which evidence source was later consulted, which action was preferred, or whether a laboratory could execute follow-up.
The boundary in one question¶
Ask: would this rule still mean the same thing if execution, literature, ranking policy, and laboratory capacity all changed?
- If yes, and the rule concerns a proteomics entity, calculation, or scientific acceptance contract, it belongs in Core.
- If the rule changes with provider state, evidence context, decision values, or operational readiness, it belongs with the corresponding owner.
flowchart TD
proposal["new rule or record"] --> scientific{"defines proteomics meaning or calculation?"}
scientific -->|no| neighbor["route to Runtime, Knowledge, Intelligence, or Lab"]
scientific -->|yes| independent{"valid without downstream state?"}
independent -->|no| seam["split scientific contract from downstream policy"]
independent -->|yes| core["Core owner"]
What Core contributes¶
| Responsibility | Durable output |
|---|---|
| input and format interpretation | typed accepted records, rejected records, diagnostics, and source lineage |
| sequence, chemistry, signal, identification, and inference | result contract with declared scientific assumptions |
| quantification and specialized workflows | matrices, uncertainty, QC, and domain-specific review records |
| workflow contracts | validated request, expected artifacts, refusal conditions, and acceptance policy |
| public evidence assets | family-specific corpus, challenge, comparison, and bounded acceptance record |
The package may render reports and assemble workflows, but those surfaces must remain views and compositions of domain-owned contracts. A CLI handler, report builder, or integrated demo is not a new scientific owner.
Where the boundary is under pressure¶
Core is broad, and its source tree contains interpretation, review, lab,
and integrated workflow surfaces. Their names do not grant ownership over
neighboring package policy.
| Core surface | Allowed responsibility | Drift to reject |
|---|---|---|
interpretation |
scientific reading of a governed result | source curation or final evidence sufficiency |
review |
scientific QC, explanations, and result inspection | recommendation policy or human authorization |
lab |
analytical QC and validation requirements | scheduling, custody, or assay execution authority |
workflow |
runtime-agnostic scientific composition | providers, checkpoints, retry, or persisted run state |
benchmarks |
scientific assets and acceptance burden | claiming execution or downstream consequence that was not observed |
Fit tests¶
Core remains coherent when:
- every algorithm is beside the domain contract whose meaning it implements;
- rejected inputs, active policy, ambiguity, and known limits survive report assembly;
- workflow requests remain executable by more than one Runtime implementation;
- cross-package records keep their original owner and identity;
- scientific acceptance never implies execution equivalence, grounded truth, recommendation authority, or laboratory value.
For the implemented domain map, read scientific package map. For current family-level evidence, continue with the public benchmark catalog and known limitations.