Metadata System¶
Source of Truth¶
project.toml is the repository-level metadata source for:
- project version
- project name and description
- image base name
- API metadata consumed by the gateway and backend helpers
Current Consumers¶
Gateway build¶
flexserv/gateway/build.rs reads project.toml and exports:
PROJECT_VERSION
The gateway uses that value in:
- startup logs
- landing page
- OpenAPI responses
Version sync helper¶
scripts/sync_versions.py keeps flexserv/gateway/Cargo.toml aligned with the version in project.toml.
Commands:
Python metadata helper¶
flexserv/backend/hf_transformers_backend/project_metadata.py reads project.toml for backend-facing metadata helpers used when building OpenAPI metadata.
Important Caveat¶
The metadata file may contain entries for backends or protocol ideas that are broader than the actively documented runtime surface. Treat the actual implementation in the gateway, backend server, and boot loader as authoritative when metadata and docs diverge.