Add instructions and configuration for running everything locally

[djeebus]

Components functional:

• api
• client-proxy
• orchestrator

Infra included:

• clickhouse
• grafana
• loki
• memcached
• mimir
• otel
• redis
• postgres
• tempo

---

Note

Introduce a full local dev setup (docker-compose infra, .env.local configs, DB seeding), add run-local Make targets, and make small reliability tweaks in orchestrator and DB client.

• Local development:
  • Add packages/local-dev with docker-compose.yaml provisioning clickhouse, grafana, loki, memcached, mimir, otel-collector, postgres, redis, tempo + Grafana datasources and service configs.
  • Add DEV-LOCAL.md with step-by-step local run instructions.
  • New DB seeding tool packages/local-dev/seed-local-database.go and go.mod/go.sum for local-dev.
  • Wire into workspace: update go.work to include ./packages/local-dev.
  • Makefile targets:
    • Root: local-infra (docker compose up).
    • DB: migrate-local.
    • API/Client-Proxy/Orchestrator: run-local that loads .env.local and runs binaries.
  • Add .env.local for packages/api, packages/client-proxy, packages/orchestrator.
• API:
  • Defer cfg.Parse() until after telemetry/logger setup; add run-local target in Makefile.
• Orchestrator:
  • Add run-local target and .env.local; update .gitignore to ignore tmp/.
  • NBD pool: introduce ErrNBDModuleNotLoaded and improve error logging/formatting.
  • Network pool: clarify error on slot acquisition.
• Client Proxy:
  • Add run-local target and .env.local.
• Shared DB:
  • Read POSTGRES_CONNECTION_STRING within NewClient (no package-level var).

^{Written by Cursor Bugbot for commit eda9efe. This will update automatically on new commits. Configure here.}