MAQPNADocs

maqpna explain

Document a MAQPNA resource or field

Get started-o json | yaml

Synopsis#

maqpna explain KIND[.field.path] [--recursive] [-o table|json|yaml]

Description#

Like kubectl explain, with no cluster: the schemas are the CRDs this maqpna was built with. KIND is a kind, plural or short name; examples:

  maqpna explain toolpolicy.spec.rules.when
  maqpna explain agent --recursive

Flags#

FlagTypeDescriptionDefault
--recursiveswitchprint every nested fieldnone

The global flags (--context, -o, --no-color, ...) work with every command.

Examples#

maqpna explain agent
maqpna explain agent.spec.tier
maqpna explain toolpolicy.spec.rules --recursive

What happens when you run it#

  • Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

Exit codes#

CodeMeaning
0success
1error (the message says what failed, with a hint when there is one)
2usage error: unknown flag, missing argument or bad value; the synopsis is printed
3a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command)

Terminal demo#

maqpna explain.cast