Skip to content

Reference server: BOXLITE_SERVER/BOXLITE_RUNTIME env config + non-detached handle retention#288

Merged
DorianZheng merged 1 commit intomainfrom
codex/ref-server-env-runtime-handle-cache
Feb 23, 2026
Merged

Reference server: BOXLITE_SERVER/BOXLITE_RUNTIME env config + non-detached handle retention#288
DorianZheng merged 1 commit intomainfrom
codex/ref-server-env-runtime-handle-cache

Conversation

@DorianZheng
Copy link
Copy Markdown
Member

Summary

This PR updates the reference server config surface and lifecycle handling:

  • Adds server-local env config module (openapi/reference-server/config.py)
  • Standardizes env prefixes:
    • BOXLITE_SERVER_* for server settings
    • BOXLITE_RUNTIME_* for runtime options used by reference server
  • Loads .env from openapi/reference-server/.env by default (or --env-file)
  • Adds openapi/reference-server/.env.example (server/runtime only)
  • Updates docs for setup, env behavior, and precedence
  • Adds strict config parsing tests
  • Fixes non-detached lifecycle issue by retaining strong box handles in server memory (ID-keyed cache)

Why

  • Clarifies and stabilizes reference-server env contract
  • Avoids dependence on legacy env aliases
  • Prevents watchdog-triggered shutdown from dropped request-scoped handles

Validation

  • python3 -m py_compile on server/config/tests
  • python3 -m unittest discover -s openapi/reference-server/tests -p "test_*.py" -v
  • Manual create/start/get smoke test confirms start -> running and stable process behavior

@DorianZheng DorianZheng merged commit 26ab49e into main Feb 23, 2026
6 checks passed
@DorianZheng DorianZheng deleted the codex/ref-server-env-runtime-handle-cache branch February 23, 2026 09:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant