v1 · checkout packet

Evidence Bundle v1

What TWOG includes when someone checks out a candidate for outside review: source records, chunk provenance, artifact manifests, compute settings, and contribution routes.

activeapplies to · public payloadsclaims · source dossier
What this governs

The evidence bundle is the action layer behind a candidate page. It gives a reviewer enough structure to inspect, replicate, challenge, or extend a record without guessing where the claim came from.

The readable page tells the story. The evidence bundle carries the working materials.

01 · Select snapshot

The bundle is pinned to one public candidate snapshot and content hash so outside work targets the same record TWOG published.

02 · Gather references

Expanded literature entries, source URLs, identifiers, duplicate groups, research object IDs, and chunk IDs are packaged together.

03 · Attach artifacts

Compute outputs, MD settings, plots, payload hashes, and generated files are represented as manifests instead of being hidden in private notes.

04 · Expose gaps

Missing citations, unresolved refs, unsupported claims, and absent raw artifacts remain visible as work items instead of being smoothed over.

05 · Enable check-in

The same packet points to the contribution template so reviewers can return structured evidence, critique, replication notes, artifacts, or validation proposals.

Why bundles exist

A candidate page is readable, but a bundle is actionable. It puts the public snapshot, evidence dossier, artifact manifest, and contribution routes into one packet for outside review.

What source access means

The public packet exposes source metadata and provenance fields. It does not automatically publish every licensed full-text document; rights-restricted material stays behind the evidence boundary while the identifiers and claims remain auditable.

How chunk provenance works

Chunk IDs are pointers into TWOG processed research records. They let the internal system re-open the exact supporting material while the public page shows the readable claim and source label.

How compute settings travel

If MD, docking, omics, or another compute lane informs the candidate, the bundle should include the method reference, input contract, settings, artifact IDs, and run ledger identifiers needed for review.

What a reader can verify
Snapshot identity
Candidate ID, display ID, content hash, pipeline version, and method reference.
Source dossier
Citation records, identifiers, links, duplicate handling, and supported claims.
Chunk provenance
Research object IDs and chunk IDs that connect public claims to stored source material.
Artifact manifest
Plots, payloads, compute outputs, method versions, container images, and reproducibility notes when available.
Open gaps
Negative coverage, missing identifiers, unresolved citations, and blockers that need follow-up work.
Where it's inspectable — public routes
Evidence bundleopen route →
/api/public-candidates/rly2608-pik3ca/evidence-bundle

Live example of the actionable checkout packet attached to a public candidate.

Candidate payloadopen route →
/api/public-candidates/rly2608-pik3ca

The public record payload the evidence bundle extends.

How to interpret this method
  • A bundle is for audit and follow-up work, not medical decision-making.
  • Source metadata can be public even when source text has access restrictions.
  • Unresolved references are useful defects, not decoration.
  • Artifacts should be hashable or otherwise traceable back to their generation run.
What this method does not certify

Evidence Bundle v1 does not grant rights to restricted source documents or certify that a compute artifact is scientifically sufficient. It packages what TWOG can expose for reproducible review.