Skip to content

Release and versioning

Lab follows the coordinated package-family release identity. The version is resolved from Git tags through hatch-vcs. A v<version> tag identifies the source revision shared with the coordinated package family. The fallback value in package metadata supports source archives without repository history; it is not a separate Lab release line. Release review is operational: it must show that an upgraded consumer cannot silently change authorization, readiness, instructions, observations, or follow-up obligations.

Classify operational impact

Change Release evidence
planning implementation identical advisory/executable state and rationale for frozen cases
readiness or refusal policy boundary cases and changed remediation
handoff schema old payload load or migration plus operator-view comparison
scheduling logic dependency, capacity, ordering, and infeasibility comparison
outcome semantics units, QC, censoring, failure class, and promotion behavior
public export canonical and proteomics-lab forwarding proof

Computational package versions do not validate physical protocols or instruments. A release can prove deterministic planning and artifact behavior; claims about laboratory performance require separately governed observed data.

Release evidence chain

flowchart LR
    cases["frozen planning and outcome cases"]
    boundaries["authority and refusal boundaries"]
    artifacts["handoff and outcome round trips"]
    gates["test · quality · API"]
    aliases["alias forwarding"]
    install["isolated consumer replay"]
    cases --> boundaries --> artifacts --> gates --> aliases --> install

Run the package gates from the repository root:

make test PACKAGE=bijux-proteomics-lab
make quality PACKAGE=bijux-proteomics-lab
make api PACKAGE=bijux-proteomics-lab
make build PACKAGE=bijux-proteomics-lab
make test PACKAGE=proteomics-lab

For handoff changes, compare the canonical artifact, its digest, the exported operator or LIMS view, and acknowledgement behavior. For outcome changes, replay successful, failed-QC, censored, deviated, and rerun-required cases.

Changelog and rollout

Update packages/bijux-proteomics-lab/CHANGELOG.md with the affected operational state, payload or policy change, compatibility route, operator impact, and any required regeneration of planned work. Never imply that a software release retrospectively changes an already authorized instruction or recorded observation.

Coordinate with Intelligence when recommendations feeding assay plans change, with Knowledge when outcomes can become evidence, and with Core when units or scientific result contracts move. Lab retains authority over execution posture and refusal.

After publication, install the exact wheel in an empty environment and replay one advisory-to-refusal case plus one authorized-handoff-to-outcome case. Verify proteomics-lab when root exports move. Successful upload establishes package delivery; the replays establish that operational boundaries survived release.