cadrumo.application.operator_surface package

Backend-owned operator-surface namespace.

The application-layer command-shape declarations are defined in application.operator_surface.contract, application.operator_surface.models, application.operator_surface.help, application.operator_surface.errors. Command adapters consume this surface as data and render it; they do not define a second contract.

Root-surface declarations flow through get_operator_surface_contract(), ACCEPTED_ROOTS, MOUNTED_COMMAND_FAMILIES, and OperatorSurfaceContract. Source-kind aliases remain parser-only SourceKindAlias records that resolve through resolve_source_kind_alias() to canonical core.aggregation.BindingSourceKind members. No operator-specific source-kind taxonomy is introduced here.

Help and landing surfaces are defined by build_help_document(), build_root_landing_report(), HelpDocument, and RootLandingReport. Refused surfaces use the registered OperatorSurfaceContractError path shared with require_accepted_root().

Consumer-specific projections of these protocol-neutral contracts belong to the consuming distribution, not to the base application.

Consumers import from the owning module – contract, manifest, models, help, help_models, action_resolution, errors – rather than from this package root, which is inert.

Submodules