Base Engine Utility

Generic engine adapter API.

Usage context

• Engine dispatch: Route typed load/write requests to engine-specific implementations.
• Data normalization: Convert raw engine files into canonical domain models.
• Workflow support: Provide reusable adapter entry points for CLI/workflow layers.

Class: EngineAdapter

Bases: ABC

Engine adapter interface for detection + typed data loading.

Method: detect

Return confidence score [0, 1].

Method: required_input_files

Return minimal source filenames needed to load data_type.

Returning None means "use the storage layer's default broad snapshot list".

Method: load

Load requested domain data type from engine-specific sources.

Method: write

Write a domain data object using an engine-appropriate writer.