Description

Description:
Introduce structured JSON logging to the Headplane TypeScript codebase to improve observability and log processing. This would allow Headplane to integrate seamlessly with log aggregation platforms and monitoring pipelines.

Context and Benefits:

• Enables compatibility with ELK stack, Datadog, and other structured log consumers
• Facilitates filtering, search, and automated alerting
• Provides machine-readable log output for easier debugging and monitoring
• Encourages consistent log formatting across the codebase

Proposed Implementation:
Use a TypeScript-compatible logging library such as pino or winston with support for structured JSON output.
Implementation may include:

• A shared logger.ts module that encapsulates log logic
• Inclusion of contextual metadata (e.g., request IDs, service names)
• Environment-based verbosity control

Example Logs (JSONL Format):

{"timestamp":"2025-07-25T23:53:00Z","level":"info","message":"Headplane service started","component":"bootstrap"}
{"timestamp":"2025-07-25T23:53:05Z","level":"debug","message":"Loaded config file","component":"config-loader","path":"/etc/headplane/config.yml"}
{"timestamp":"2025-07-25T23:53:10Z","level":"info","message":"Connected to PostgreSQL","component":"db-connector","host":"db.internal","port":5432}
{"timestamp":"2025-07-25T23:53:15Z","level":"warn","message":"Rate limit approaching","component":"api-gateway","current":950,"limit":1000}
{"timestamp":"2025-07-25T23:53:20Z","level":"error","message":"Unhandled exception in request handler","component":"http-server","error":"TypeError: Cannot read property 'id' of undefined","requestId":"req-789"}