Python DSL reference .service-architect/project.yaml

Project manifest

Declare the trusted Python entrypoint, canonical YAML output, and generation targets in one discoverable project contract.

When to use

Add a manifest to every Python-authored repository used by CLI, Codex, MCP, or CI.

Behavior

inspect reads the manifest without importing or executing project Python.
validate and export execute the Python entrypoint in a child process with a 30-second default timeout.
export writes through a temporary file and atomically replaces the configured canonical output.
Paths are relative to the workspace root and use forward slashes.

Manifest fields properties

Version 1 project contract.

PropertyTypeDescription

project.namestring

Human-readable project identity.

authoring.modepython

Select typed Python as editable authoring source.

authoring.entrypointmodule:attribute

Importable Project object or callable.

canonical.outputrelative YAML path

Generated interchange artifact.

generation.targetslist

Requested target runtimes such as go, cpp, python, rust, and typescript.

.service-architect/project.yaml

version: 1

project:
  name: ProcessOrder

authoring:
  mode: python
  entrypoint: processorder.main:project

canonical:
  output: .service-architect/build/processorder.yaml

generation:
  targets:
    - go
    - python
    - rust