System View

Small service, visible metrics, explicit controller loop.

The repository is a research meta-repo. The Go workload lives under toy-load/; analysis, monitoring, runners, docs, and release automation live at root.

Architecture diagram showing load, toy-load, Prometheus, HPA, MPC, scaling, and analysis — The same boundaries are documented in docs/ARCHITECTURE.md.

Workload

toy-load exposes /work, health probes, and Prometheus metrics with CPU, jitter, latency, request, and in-flight controls.

Controllers

HPA provides the reactive baseline. MPC solves a short-horizon control problem and can run dry-run or apply mode.

Evidence

Runners write artifacts under experiment roots. Analysis commands rebuild summaries without committing bulky raw outputs.

Repository Roles

Path	Role
`toy-load/`	Go service, Dockerfile, Helm chart, raw manifests.
`analysis/`	Offline MPC simulation, live controller, artifact summarizers.
`loadgen/scripts/`	Repeatable HPA and MPC experiment runners.
`deploy/monitoring/`	Kustomize monitoring stack for Prometheus and Grafana.
`experiments/`	Evidence index, archive policy, packaging script, ignored raw runs.