Expand description
Deployment adapters for clap-noun-verb applications.
clap-noun-verb-deploy projects one admitted CLI command graph into multiple
serving and deployment surfaces without duplicating domain behavior.
The crate deliberately separates three concerns:
- SELECT: inspect the CLI graph and select a callable command.
- CONSTRUCT: manufacture a validated
Invocationor deployment manifest. - DO: execute only through an explicit
Executorsupplied by the caller.
Kubernetes and OCI modules only render artifacts. They never contact a cluster, registry, container runtime, or network service.
Modules§
- container
- Deterministic OCI/container build projection.
- http
- Small HTTP/1.1 serving adapter with no web-framework dependency.
- kubernetes
- Deterministic Kubernetes projection for a deployed CLI service.
- mcp
- MCP 2026-07-28 stdio adapter for a projected CLI.
- oci_
builder - A real OCI image builder: shells out to a real, already-installed
container build tool (
docker,podman, or any OCI-compatible CLI) to actually build an image from a rendered Dockerfile. - registry_
executor - Closes the real gap the “unwired deployment crate” innovation finding
surfaced:
Deploy::from_command/from_registryalready project a realclap_noun_verbcommand graph into a schema, but nothing in this crate actually EXECUTED a call back through the real, productionclap_noun_verb::cli::CommandRegistrydispatch path (with its realGuard/Receipt/OCEL machinery already wired in) – every existingExecutor(ProcessExecutor) only spawns a separate child process.
Structs§
- Admit
Validated - Admit schema-validated argv while refusing per-invocation environment mutation.
- Argument
Schema - CliSchema
- Command
Allow List - Least-authority policy for selecting explicit callable command paths.
- Command
Schema - Deploy
- Transport-neutral deployment projection of a
clap-noun-verbregistry. - Environment
Allow List - Explicitly permits selected per-invocation environment names after another policy admits argv.
- Execution
- Receipt-shaped execution result returned by an
Executor. - Execution
Record - Evidence produced after an explicitly admitted execution.
- Gateway
- The sole high-level DO path: admission precedes execution and every successful executor call manufactures an execution record.
- Invocation
- A bounded request to invoke the configured CLI executable.
- Process
Executor - Executes a deployed CLI as one explicitly configured child process.
- Replay
Verification - Tool
Schema - Protocol-neutral tool description derived from one callable command.
Enums§
- Admission
- Admission decision made before an invocation can reach an executor.
- Admission
Error - Argument
Behavior - Clap action semantics required to reconstruct argv without ambiguity.
- Argument
Kind - JSON-facing argument shape inferred from Clap metadata.
- Gateway
Error - Invocation
Build Error - Manifest
Error - Failure reading or parsing a
CliSchemamanifest from disk. - Process
Execution Error - Replay
Error
Traits§
- Admission
Policy - Pure admission boundary. Implementations inspect but never execute an invocation.
- Executor
- Sole actuation boundary used by protocol adapters.