Round-trip guarantees and limits

When to use

Understand this boundary before moving repeatedly between visual, YAML, and Python authoring.

Behavior

• YAML import preserves services, pipelines, streams, links, connectors, endpoints, types, pools, modules, packages, schedules, and supported properties.
• Generated Python uses deterministic names, directories, imports, typed factories, and object references.
• Default link semantics may be omitted because the service default already defines the same runtime behavior.
• Numeric Designer IDs are regenerated and are not topology identity.

Python example

sa-dsl import architecture.yaml -o migrated --format json
sa-dsl validate --project migrated --format json
sa-dsl export --project migrated --format json

# Compare canonical architecture semantics, not Python formatting.

Related documentation