Skip to content

8.12. Service Admission Workflow

Manifest, compose fragment, topology row, env assembler, docs regeneration, diagrams, tests, and CI drift gates.

1. Diagram

Service Admission Workflow architecture diagram

Open the full-size diagram.

2. Notes

The fragment check in manifest_validator.py blocks a partial landing. It reports missing_fragment for a non-virtual manifest without compose.yml and unexpected_fragment for a virtual manifest that ships one. It reports fragment_container_drift when containers[] disagrees with the compose services: keys. tools/validate_fragments.py runs this check in CI, and also checks .env.example drift and the README TOPOLOGY block.

3. Source Files

  • bootstrapper/services/manifest_validator.py
  • bootstrapper/services/source_validator.py
  • bootstrapper/services/topology.py
  • bootstrapper/services/env_assembler.py
  • bootstrapper/docs/regen.py
  • bootstrapper/docs/diagram_renderer.py
  • bootstrapper/tools/validate_fragments.py
  • .github/workflows/services-lint.yml