akua lint

Shipped

Parse-only check of a package.k — catches syntax errors and import- resolution failures without executing the program. Runtime errors (schema validation, unresolved options, engine failures) surface through akua render --dry-run.

akua lint [flags]

Flags

Exit codes

0 clean, 1 parse errors (or user error), 2 system error.

JSON output

{
  "status": "ok",
  "issues": []
}

Or on parse failure:

{
  "status": "fail",
  "issues": [
    {
      "level": "error",
      "code": "Error(InvalidSyntax)",
      "message": "invalid token '!', consider using 'not '",
      "file": "/abs/path/package.k",
      "line": 2,
      "column": 2
    }
  ]
}

Planned expansion (🚧). The target surface also checks Regal-style Rego lints, policy-tier compatibility, cross-engine reference integrity, and offers --fix auto-format integration. Lands with the policy pipeline (Phase C).