Architecture Overview

This document provides a high-level overview of architectural decisions made for the interposition-http-adapter project.

Architecture Decision Records

ADR-0001: Use Starlette and uvicorn as HTTP Framework

Status: Accepted | Date: 2026-02-10

Use Starlette as the ASGI framework and uvicorn as the ASGI server for unified HTTP and WebSocket support with lightweight dependencies.

---

ADR-0002: HTTP to InteractionRequest Mapping Conventions

Status: Accepted | Date: 2026-02-11

Define conventions for mapping HTTP requests to InteractionRequest and ResponseChunk to HTTP responses, with status code in the first chunk's metadata.

---

ADR-0003: Replay Miss HTTP Status Policy

Status: Accepted | Date: 2026-02-11

Define the adapter response policy for cassette replay misses as HTTP 500 to keep replay failures explicit.

---

ADR-0004: Factory Class Methods for Adapter Creation

Status: Accepted | Date: 2026-02-24

Provide layered factory class methods (from_store and from_cassette_file) to simplify adapter creation from stores and file paths.

---