Feature: Add Request Context Health Checks and Graceful Shutdown

[3m1n3nc3]

Description

Add request correlation, actor context, health/readiness endpoints, and safe process shutdown.

File Location

learnault-api/src/middleware/request-context.ts, learnault-api/src/routes/health.routes.ts, learnault-api/src/server.ts, and logger config

Design Reference

API Roadmap Phase 0: Add Request Context Health Checks and Graceful Shutdown.

Dependencies

• Status: Ready
• Blocked by: None
• Blocks: Feature: Add Staging Deployment Rollback and Smoke Tests

Tasks

• Generate or validate request IDs and return them in responses
• Attach authenticated actor context without logging secrets
• Add liveness and dependency-aware readiness endpoints
• Log request completion with duration, status, and request ID
• Drain HTTP, jobs, and database connections on termination
• Test propagation, readiness failure, and shutdown timeout

Acceptance Criteria

• Every response and error log is correlatable
• Readiness reflects required dependencies
• Shutdown completes within a configured deadline
• Tests pass

Verification Evidence

• Attach curl health output, correlated logs, and shutdown test results

Difficulty

Medium

[Menjay7]

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

[jaynomyaro]

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. Thank you!

[Unclebaffa]

Hello Maintainer,
I'm interested in contributing to this amazing project of yours, I'm confident i will deliver the best result that aligns with this project.
Kindly assign me.
Thank you

[grantfox-oss]

🦊 GrantFox — @Unclebaffa has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #62)
2. Your PR will be reviewed by the learnault maintainers

Good luck! Track your progress on GrantFox.