Configuration resolution

How repository and workspace intent become a workload

The normal researcher contract is a checked-in direct run config:

name: train
engine: rayjob
entrypoint: train.py

compute:
  workers: 2
  gpus_per_worker: 8

storage:
  data_pvc: training-data

TauGrid combines:

  1. Explicit project and target selection.
  2. Repository or monorepo discovery.
  3. The project’s workspace connection descriptor.
  4. Platform-owned workspace defaults.
  5. Checked-in workload intent.
  6. Temporary explicit operator overrides.

Ambiguity is an error. Dry-run output must keep default sources visible.

tau run validate --config tau/train.yaml
tau run train --dry-run=client
tau run explain-config

See direct run config vs. managed workflow manifest for how Python SDK-generated manifests relate to this default format.