26 lines
1004 B
Markdown
26 lines
1004 B
Markdown
# 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.
|