Omnis HelixGenome IDE
← Docs
Helix CLI docs
Browse Helix CLI docs

Lightcone v0.9 milestone

Goal: deepen Lightcone as an evidence navigation surface without adding visual polish or new visual metaphors.

Lightcone v0.8 proved the demo loop: visible decision objects resolve to deterministic simulated data, receipt-backed explanation, or replayable audit context. Lightcone v0.9 should make that proof usable by reviewers across repeated review sessions.

Non-goals

  • No new art direction.
  • No shader, CUDA, or rendering milestone.
  • No clinical, diagnostic, therapeutic, wet-lab, or in vivo claims.
  • No visual object without a stable id, replay path, and receipt linkage.
  • No architecture tour features that do not improve reviewer evidence navigation.

Epic 1: Branch replay bookmarks

Goal

Reviewers can save and reopen the exact Lightcone branch focus used in an in silico review.

Deliverables

  • Stable bookmark schema for branch id, phase, viewport camera, selected outcome id, active filters, and source fixture/run receipt.
  • Studio action to create a bookmark from the active selected branch.
  • Restore path that reopens Lightcone with the same selected branch and viewport focus.
  • Audit-pack inclusion for bookmarks.

Acceptance

  • A bookmark created from the dominant branch restores the same selection id and dominant outcome.
  • Restored viewport context matches the saved phase and camera values.
  • Bookmark payload is deterministic JSON with stable key ordering.
  • Bookmark references either fixture snapshot receipt or live run receipt.

Tests

  • Headless test saves a bookmark, restores it, and asserts selection id, phase, camera, and dominant outcome.
  • Audit-pack test asserts bookmark file hash is listed in manifest.json.

Epic 2: Reviewer annotations

Goal

Reviewers can attach comments to evidence objects without breaking determinism.

Deliverables

  • Annotation schema with stable ids, target type, target id, author label, timestamp, body, and optional status.
  • Target types: branch selection, story node, horizon zone, audit receipt.
  • Side rail panel for annotation list and selected-object context.
  • Audit-pack inclusion for annotations.

Acceptance

  • Annotation targets resolve to existing deterministic objects.
  • Missing or stale targets render as unresolved, not silently reassigned.
  • Annotation export is stable and included in audit-pack manifest.
  • Annotation text does not alter simulation receipts.

Tests

  • Schema round-trip test for annotations.
  • UI smoke test attaches an annotation to a selected branch and reloads it.
  • Audit-pack verification confirms annotation file hash.

Epic 3: Side-by-side branch comparison

Goal

Reviewers can compare two modeled branches by evidence, not by eye.

Deliverables

  • Compare drawer with branch A and branch B selection ids.
  • Shared fields: dominant outcome, linked outcomes, mechanism tags, allele-state hashes, probability/rank display policy, and receipt context.
  • Explicit deterministic delta summary.
  • Exportable comparison JSON.

Acceptance

  • Selecting two branches produces a stable comparison payload.
  • Deltas are derived only from deterministic selection/outcome data.
  • Non-decision-grade mode does not emit quantitative values in the UI or export.
  • Comparison export verifies through audit-pack manifest hashes.

Tests

  • Headless comparison test for two fixture branches.
  • Non-decision-grade policy test ensures probability-shaped values are suppressed where required.
  • Audit-pack test includes comparison JSON and verifies manifest hash.

Epic 4: Deterministic session restore

Goal

The v0.8 proof state can be restored from audit context without trusting a server.

Deliverables

  • Restore command/path that reads audit pack, fixture snapshot, selection dump, bookmarks, and annotations.
  • Studio restore action for Lightcone audit packs.
  • Receipt field that records restore support and source hashes.

Acceptance

  • Restore from artifacts/lightcone_demo_proof_v0_8/lightcone_demo_proof_v0_8_audit_pack.zip opens the same selected branch.
  • Restore does not require network access.
  • Restore reports missing optional files clearly.
  • Restore emits a deterministic restore receipt.

Tests

  • Headless restore test from the v0.8 proof audit pack.
  • Negative test for tampered manifest hash.
  • Offline test path that does not call network APIs.

Epic 5: Exportable reviewer snapshots

Goal

Reviewers can export a frozen evidence snapshot that is smaller than a full audit pack but still traceable.

Deliverables

  • Reviewer snapshot JSON: selected branch, story nodes, horizon zone map, annotations, comparison payload, receipt links.
  • Optional PNG sidecar only as a convenience; JSON remains authoritative.
  • Verification command for reviewer snapshot.

Acceptance

  • Snapshot verifies against audit-pack receipts or embedded fixture snapshot hash.
  • Snapshot contains no unbacked visual-only claims.
  • Snapshot can be regenerated deterministically from the same inputs.

Tests

  • Snapshot generation test.
  • Snapshot verifier test.
  • Round-trip test from snapshot back to selected branch context.

v0.9 proof artifact

Target receipt:

{
  "visual_contract": "lightcone_visual_contract_v0_8",
  "evidence_navigation_milestone": "lightcone_v0_9",
  "branch_bookmark_restore_supported": true,
  "reviewer_annotations_resolve_to_targets": true,
  "branch_comparison_export_verifies": true,
  "audit_pack_session_restore_supported": true,
  "reviewer_snapshot_export_verifies": true,
  "offline_verification_supported": true
}

External demo script

Keep the first external demo to 60-90 seconds:

  1. Load synthetic sequence.
  2. Run guide discovery and select a guide.
  3. Generate modeled outcome family.
  4. Open Lightcone and focus dominant branch.
  5. Inspect branch story nodes and evidence links.
  6. Export audit pack.
  7. Verify offline.

Script:

We modeled possible edit outcomes from a synthetic input. Lightcone organizes those modeled futures into a decision surface. This selected branch is not just drawn; it resolves to deterministic simulated outcomes and receipt-backed context. We export the audit pack, verify it offline, and restore the decision context without trusting a server.

Close criteria

  • v0.8 proof remains green.
  • v0.9 proof receipt exists under artifacts/lightcone_v0_9_proof/receipt.json.
  • Every new reviewer-facing object has a stable id, deterministic payload, replay path, and receipt linkage.
  • No new visual polish ships unless required to fix traceability or readability.