init monlet repo with stage 0-2 (docs, contract, agent MVP)

This commit is contained in:
Stanislav Rossovskii
2026-05-26 16:41:27 +04:00
commit dcea096327
42 changed files with 3183 additions and 0 deletions

6
server/.env.example Normal file
View File

@@ -0,0 +1,6 @@
MONLET_ENV=local
MONLET_LOG_LEVEL=info
MONLET_DATABASE_URL=postgresql+psycopg://monlet:monlet@localhost:5432/monlet
MONLET_AGENT_TOKEN_BOOTSTRAP=replace-me
MONLET_MAX_REQUEST_BYTES=1048576
MONLET_MAX_CHECK_OUTPUT_BYTES=8192

28
server/README.md Normal file
View File

@@ -0,0 +1,28 @@
# Monlet Server
Placeholder for the Python/FastAPI server.
Planned stack:
- Python 3.14;
- uv;
- FastAPI;
- Pydantic;
- SQLAlchemy 2.x style;
- Alembic;
- PostgreSQL;
- httpx for outbound notifier calls;
- structured logging;
- Prometheus metrics;
- Docker image.
No server core logic is implemented in Stage 0.
## Planned Commands
```sh
UV_PROJECT_ENVIRONMENT=.venv UV_CACHE_DIR=../.cache/uv uv sync
UV_PROJECT_ENVIRONMENT=.venv UV_CACHE_DIR=../.cache/uv uv run fastapi dev monlet_server/main.py
```
Do not install Python packages globally on the host. Docker builds install server dependencies inside the image; local development uses `server/.venv` and repo-local `.cache/uv`.