live_interaction_contracts

# Project map

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 |