# FLASHPLAN AGENTS

Overview
- FlashPlan is a federated edge planner for cross-venue execution. This repository provides a minimal MVP core to bootstrap development and testing.

Architecture
- Core primitives: LocalProblem, SharedVariables, PlanDelta
- Edge planner: lightweight optimization with a simple ADMM-lite coordinator
- Adapters: venue A, venue B; mock risk center
- Transport: TLS-stub boundary to illustrate secure channels (no real network in MVP)
- Delta-sync: deterministic reconciliation on reconnects

Tech Stack
- Python 3.11+ (typing, dataclasses, small in-process simulations)
- Tests with pytest
- Packaging via setuptools (pyproject.toml)

How to run tests
- ./test.sh
- The script runs pytest and python -m build to verify packaging.

Development Rules
- Implement smallest correct change first; small, well-scoped PRs preferred.
- Favor plain Python modules with clear interfaces; add tests for new behavior.
- Do not publish or push to remote without explicit user instruction.