This file is for contributors and readers who want the evidence trail behind the
package. It is intentionally separate from the package landing page.
Durable contracts
| Path | Role |
|---|
SPEC.md | Durable project statements and v1 frozen scope |
KERNEL.md | The five kernel members and state ownership definitions |
DELEGATION_LEDGER.md | Ledger format and classification rules |
CONFORMANCE.md | Harness design, CI fuse, and ledger regeneration |
CURSOR_CONTRACT.md | Client-owned coordination contract |
CHANNEL_CONTRACT.md | Versioned async query/result contract |
REFERENCE_POPOVER_CONTRACT.md | First green reference machine |
CONTRACT_DIALOG.md | Amber dialog adapter |
CONTRACT_MENU.md | Menu reference: popover plus cursor |
CONTRACT_ISLAND.md | Client-built children under phx-update="ignore" |
CONTRACT_TOOLTIP.md | Tooltip reference: hover/focus popover |
CONTRACT_SELECT.md | Select reference: popover plus cursor plus server-owned value |
CONTRACT_COMBOBOX.md | Combobox reference: popover, cursor, and Channel |
RED_FIXTURES.md | Dialog and details red fixtures |
BACKLOG.md | Amber, unknown, and deferred work |
REPRODUCE.md | Raw commands for reproducing the spikes |
BUILDING_COMPONENTS.md | Playbook for adding a contract-backed component |
BLUEPRINT.md | Final product architecture and consumer-contract roadmap |
Generated evidence
| Path | Role |
|---|
delegation-ledger.md / delegation-ledger.json | Current generated ledger |
reports/ | Version-specific evidence reports |
priv/*/*results*.json | Browser result fixtures used by the ledger |
Package surface
| Path | Role |
|---|
mix.exs | Package metadata and file list |
lib/live_interaction_contracts/components.ex | Single use LiveInteractionContracts.Components entrypoint |
lib/live_interaction_contracts/components/popover.ex | Reference <.popover> component |
lib/live_interaction_contracts/components/menu.ex | Reference <.menu> component |
lib/live_interaction_contracts/components/tooltip.ex | Reference <.tooltip> component |
lib/live_interaction_contracts/components/select.ex | Reference <.select> component |
lib/live_interaction_contracts/components/combobox.ex | Reference <.combobox> component |
lib/live_interaction_contracts/channel.ex | Channel monotonic async result guard |
lib/mix/tasks/ | Public Mix task entrypoints |
priv/contract-runner/ | External-app browser contract execution engine |
Harness fixtures
| Path | Role |
|---|
priv/harness/ | Multi-version conformance harness |
priv/cursor-spike/ | Client-owned focus/cursor evidence |
priv/combobox-spike/ | Delegation, cursor, and Channel composition evidence |
priv/dialog-adapter-spike/ | Amber dialog adapter evidence |
priv/island-survival-spike/ | Client-built children survival evidence |
priv/popover-reference/ | Reference popover conformance |
priv/menu-reference/ | Reference menu conformance |
priv/tooltip-reference/ | Reference tooltip conformance |
priv/select-reference/ | Reference select conformance |
priv/combobox-reference/ | Reference combobox conformance |