chore: add basic logging setup (MICRO_AGENT_LOG) to CLI/server; document health endpoints and logging in README

Author: haasonsaas

README.md

@@ -72,6 +72,7 @@ micro-agent replay --path traces/<id>.jsonl --index -1
 - Endpoint: `POST /ask`
   - Request JSON: `{ "question": "...", "max_steps": 6, "use_tool_calls": bool? }`
   - Response JSON: `{ "answer": str, "trace_id": str, "trace_path": str, "steps": [...], "usage": {...}, "cost_usd": number }`
+  - Health: `GET /healthz` (ok), `GET /health` (provider/model), `GET /version` (package version)
 
 Example:
 ```bash
@@ -100,6 +101,10 @@ curl -s http://localhost:8000/trace/$TID | jq .
 micro-agent replay --path traces/$TID.jsonl --index -1
 ```
 
+## Logging
+- Controlled via `MICRO_AGENT_LOG` (debug|info|warning|error). Default: `INFO`.
+- Applies to both CLI and server.
+
 ## Tools
 - Built-ins live in `micro_agent/tools.py`:
   - `calculator`: safe expression evaluator. Supports `+ - * / ** % // ( )` and `!` via rewrite to `fact(n)`.

micro_agent/cli.py

@@ -6,6 +6,7 @@
 from .agent import MicroAgent
 from .runtime import dump_trace, new_trace_id
 from .costs import estimate_prediction_cost
+from .logging_setup import setup_logging
 
 console = Console()
 
@@ -33,6 +34,7 @@ def main():
 
     args = parser.parse_args()
 
+    setup_logging()
     configure_lm()
     if args.cmd == "replay":
         from rich.syntax import Syntax

micro_agent/logging_setup.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+import logging
+import os
+
+
+def setup_logging() -> None:
+    """Configure basic logging for CLI/server usage.
+
+    Controlled via env var MICRO_AGENT_LOG (debug|info|warning|error).
+    Defaults to INFO. No-op if already configured.
+    """
+    if logging.getLogger().handlers:
+        return
+    level_str = os.getenv("MICRO_AGENT_LOG", "INFO").upper()
+    level = getattr(logging, level_str, logging.INFO)
+    fmt = "%(asctime)s %(levelname)s %(name)s: %(message)s"
+    logging.basicConfig(level=level, format=fmt)
+

micro_agent/server.py

@@ -8,6 +8,7 @@
 from .config import configure_lm
 from .agent import MicroAgent
 from .runtime import dump_trace, new_trace_id
+from .logging_setup import setup_logging
 
 app = FastAPI(title="DSPy Micro Agent")
 app.add_middleware(
@@ -31,6 +32,7 @@ class AskResponse(BaseModel):
     usage: dict | None = None
     cost_usd: float | None = None
 
+setup_logging()
 configure_lm()
 _agent = MicroAgent()