Runtime wiring and business code

Each service separates topology-derived framework assembly from files intended for application development.

When to use

Use this reference when generating, reviewing or operating a Service Architect project.

Behavior

Generated app code constructs the ServiceLib service, connectors, endpoints, streams, links, pools and lifecycle hooks represented by the graph.
Generated configuration code turns YAML values into target-language runtime objects.
Function makers and endpoint handlers are created as preserved extension points, so regeneration does not erase implementations.
Generated tests and test support establish the signatures and stream behavior expected by the graph.
Service-local types and serializers are emitted when a contract is not owned by a shared module.

Runtime source layers

Cross-language mapping of the generated service internals.

PathRoleDescription

cmd/service or src/main*Entrypoint

Starts configuration, ServiceLib runtime and graceful shutdown.

internal/app or src/internal/appGenerated assembly

Creates the executable graph and transport adapters.

internal/config or src/internal/configMixed

Typed generated settings plus custom configuration extension points.

internal/functions or src/internal/functionsUser owned

Business stream operators, sinks, endpoint handlers and Temporal implementations.

internal/types or src/internal/typesMixed

Types scoped to one service.

internal/serdesMixed

Serialization adapters and registrations.

test/ or *_test.*User owned

Behavior tests for preserved business implementations.

workflowcheck.generated.yamlGenerated

Temporal Workflow determinism check configuration where applicable.

cmd/temporal-replayGenerated when applicable

Temporal Workflow history replay executable for compatibility checks.

Ownership boundary

internal/app/service.generated.*   # replace on regeneration
internal/functions/process_order.* # preserve and implement
config/config.yaml                # generator-managed public runtime config
config/overrides.yaml             # preserved environment overrides