Module surface 

Shared Clap-derived operator metadata and optional Jinja fragments. 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. MiniJinja rendering 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_FRAGMENT

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

INVOCATION_FRAGMENT

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

VERSION_FRAGMENT

Shared fragment that renders a skill frontmatter version line.

Functions

add_fragments

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

environment

Create a strict Environment containing the shared fragments.

render

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