# skunk-net-e2e

This repo is the cross-repo local E2E harness for the instant-swap / OPP work.

It is intentionally not a monorepo mirror of the underlying projects. The real
code stays in the original repos; this workspace repo tracks:

- Docker compose and bootstrap scripts
- local environment examples
- protocol notes used for this bring-up
- a dated checkpoint with the current blocker and reproduction steps
- the dependency repo matrix and expected branches

## Start Here

1. Read `WORKSPACE-MANIFEST.md`.
2. Clone each dependency repo into the top-level paths listed there.
3. Check out the recorded branches in those repos.
4. Copy `.env.local.example` to `.env.local` if you need overrides.
5. Use `./local-e2e-up.sh` or the individual commands in `LOCAL-E2E.md`.

## Key Files

- `WORKSPACE-MANIFEST.md`: remotes, branches, and current local heads
- `CHECKPOINT-2026-04-03.md`: current live state, blocker, and next steps
- `LOCAL-E2E.md`: bring-up and runtime commands
- `OPP-COHESIVE-DESIGN.md`: directional OPP design notes
- `protocol/opp/v1/opp.proto`: shared protobuf draft used for the cohesive design