Skip to main content

Crate clap_noun_verb_deploy

Crate clap_noun_verb_deploy 

Source
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 Invocation or deployment manifest.
  • DO: execute only through an explicit Executor supplied 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_registry already project a real clap_noun_verb command graph into a schema, but nothing in this crate actually EXECUTED a call back through the real, production clap_noun_verb::cli::CommandRegistry dispatch path (with its real Guard/Receipt/OCEL machinery already wired in) – every existing Executor (ProcessExecutor) only spawns a separate child process.

Structs§

AdmitValidated
Admit schema-validated argv while refusing per-invocation environment mutation.
ArgumentSchema
CliSchema
CommandAllowList
Least-authority policy for selecting explicit callable command paths.
CommandSchema
Deploy
Transport-neutral deployment projection of a clap-noun-verb registry.
EnvironmentAllowList
Explicitly permits selected per-invocation environment names after another policy admits argv.
Execution
Receipt-shaped execution result returned by an Executor.
ExecutionRecord
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.
ProcessExecutor
Executes a deployed CLI as one explicitly configured child process.
ReplayVerification
ToolSchema
Protocol-neutral tool description derived from one callable command.

Enums§

Admission
Admission decision made before an invocation can reach an executor.
AdmissionError
ArgumentBehavior
Clap action semantics required to reconstruct argv without ambiguity.
ArgumentKind
JSON-facing argument shape inferred from Clap metadata.
GatewayError
InvocationBuildError
ManifestError
Failure reading or parsing a CliSchema manifest from disk.
ProcessExecutionError
ReplayError

Traits§

AdmissionPolicy
Pure admission boundary. Implementations inspect but never execute an invocation.
Executor
Sole actuation boundary used by protocol adapters.