akua / cli / inspect

akua inspect

Report a package.k's input surface — every option() call-site with its name, declared type, required flag, default, and help text. Parse-only: the program is not executed.

akua inspect [flags]

Flags

flagdescription
--package=<path>path to the package.k file (default ./package.k)

Exit codes

0 success, 1 user error (missing file, parse failure), 2 system error.

JSON output

{
  "path": "./package.k",
  "options": [
    {
      "name": "input",
      "required": false
    }
  ]
}

Each option carries name, required, and optionally type, default, help when the KCL source supplies them. type is currently empty for the canonical input: Input = ctx.input() form — kcl_lang's list_options only reads a type arg passed directly to option(); full binding-context recovery arrives with AST walking.

Planned expansion (🚧). The target surface also audits a published OCI package — signatures, SLSA attestation chain, chart sources, rendered-manifest counts — via akua inspect <oci://…>. That depends on the OCI fetch pipeline (Phase B/C).