Documentation

Supervision model

Understand lifecycle policy, shutdown escalation, and how scopes are managed.

Lifecycle policy

Vectron builds runtime specs from config, then launches supervised child processes in the foreground.

The default lifecycle policy is fail-fast: an unexpected exit can stop the workspace rather than letting the system drift into a half-running state.

Scopes

Lifecycle operations can target:

  • the whole workspace
  • one process
  • one instance

This model is used by both the CLI and the TUI.

Shutdown escalation

Vectron models shutdown as an escalation:

  • Interrupt
  • Terminate
  • Kill

On Unix this maps to process-group signaling. On Windows it uses best-effort termination behavior.

Control endpoint integration

The control endpoint queries or drives the supervision layer for:

  • status
  • restart
  • log streaming