Module surface 

Available on crate feature surface-model only.

Clap-derived operator metadata and validation.

Clap remains the command grammar. Surface extracts the stable operator view used by committed skills, installed instructions, and contract tests. Rendering with minijinja is separately gated behind surface-templates.

Structs

Surface

Operator-facing projection of one Clap command graph.

SurfaceArgument

One positional argument or flag in a Surface.

SurfaceCommand

One command in a Surface.

Enums

SurfaceRequirement

Whether Clap requires an argument.

SurfaceScope

How far Clap propagates an argument.

Constants

COMMANDS_FRAGMENTsurface-templates

Shared fragment that renders the visible top-level Clap commands.

INVOCATION_FRAGMENTsurface-templates

Shared fragment that renders mounted invocations and the no--- rule.

VERSION_FRAGMENTsurface-templates

Shared fragment that renders a skill frontmatter version line.

Functions

add_fragmentssurface-templates

Add ctl-core’s shared operator fragments to an existing environment.

environmentsurface-templates

Create a strict Environment containing the shared fragments.

rendersurface-templates

Render one operator template with a Surface and consumer-owned context.