surface_area

Scope: Surface-area budgeting.
Audience: External users and contributors.
Guarantees: Public surface stays bounded.
Non-Goals: Full API listing.
Why: This doc exists to record its single responsibility for review.

Overview

This doc defines surface-area budgets.
MPI context lives in Mpi.
Architecture context lives in Invariants.

Contracts

Public entry points are capped by src/agentic_proteins/core/surface_area.py.
Extension points are capped by the same budget.
Configuration knobs are capped by the same budget.

Invariants

Budgets align with Core.
Budget checks align with tests/unit/test_surface_area_budget.py.
Budget changes update Mpi.

Failure Modes

Budget overruns trigger review.
Untracked entry points break Core.
Unlinked usage breaks Docs Style.

Extension Points

Extensions follow Experimental.
Review rules align with Triage.
MPI changes align with Mpi.

Exit Criteria

This doc is obsolete when budgets are generated.
The replacement is Mpi.
Obsolete docs are removed.

Code refs: src/agentic_proteins/core/surface_area.py.