Repository-tracked aliases

Prepare aliases end with .prep.s9s.yaml; run aliases end with .run.s9s.yaml. A logical reference is resolved from the caller’s current working directory and must stay inside the active workspace.

sqlrs prepare chinook run smoke

The command resolves chinook.prep.s9s.yaml and smoke.run.s9s.yaml. File-bearing paths inside each alias resolve relative to the alias file itself.

Inspection

sqlrs alias ls
sqlrs alias check

Inspection is static and does not need an engine, network access, or container startup.

Advisory discovery

sqlrs discover --aliases

Discovery is read-only and may suggest an explicit alias-creation command. Execution never depends on discovery or silently guesses an alias.