Skip to content

CLI — current state

Version: 0.2 · Last Updated: 2026-09-08 · Status: 🔴 evidence refreshed; design ratification unchanged

Verified against source revision 2465fcc (develop baseline). Test references below identify the executable contracts; they are not a new coverage percentage.

Commands and instance records

The genro-asgi entry point is genro_asgi.__main__:main. It provides serve, apps, stop and remove. serve loads the same recipe as Python server construction; named instances record their location and process state under the configured Genro ASGI home and wire a session snapshot. apps reads that registry; stop signals the recorded process; remove removes its registry entry according to the command's checks.

serve --reload runs through reloading.factory, which marks the child shutdown mode QUITTING so SPA shutdown preserves restart state. --debug declares a usage mode and is not the reload mechanism. The default listener and explicit/configured address precedence are shared with AsgiServer.

These commands do not implement the proposed general administrative restart liturgy or a deployment/subcommander controller.

Claim anchors: apps, remove, remove, factory, AsgiServer.

Behavior evidence: ServerLauncher, AppsRegistry, TargetResolver.

Source and test evidence