gemmapod doctor

Synopsis

gemmapod doctor <pod.toml>

Description

Parses pod.toml and runs the same validation the build command runs before signing. Useful in CI to gate manifests before a deploy.

Reports:

• missing required fields (name, system_prompt, model)
• transport block consistency ([transport.dartc] requires both signal_url and pod_id; [transport.fallback] requires model)
• the resolved transport order

Does not sign or write any artefacts. Does not touch the network.

Exit codes

Example

gemmapod doctor pod.toml
# pod.toml looks fine
#   transport preferred: dartc → fallback

A failure looks like:

gemmapod doctor pod.toml
# [doctor] missing required field: system_prompt
# [doctor] transport.dartc is configured but signal_url is empty

See also

• gemmapod build
• gemmapod status — runtime health check (different command — doctor is for manifest validation, status probes a running Host).
• pod.toml reference