Skip to content
Arxo Arxo

Policy & Config

Policy Violations

Section titled “Policy Violations”

False Positives

Section titled “False Positives”

Symptoms: Policy violations that seem incorrect.

Solutions:

  1. Inspect violations:

    Terminal window
    arxo analyze --format json --output report.json
    jq '.violations' report.json

  2. Adjust thresholds in policy.invariants (e.g. lower value for agent_architecture.overall_agent_health).

  3. Exclude paths in data.import_graph.exclude if needed (e.g. **/legacy/**).

Cannot Reproduce Locally

Section titled “Cannot Reproduce Locally”

Symptoms: CI fails, local run passes.

Solutions:

  1. Clear cache: arxo cache clear then arxo analyze.
  2. Specify config in CI: arxo analyze --config .arxo.yaml.
  3. Match version: arxo --version in CI and locally.

Configuration Issues

Section titled “Configuration Issues”

Invalid Configuration

Section titled “Invalid Configuration”

Error: “Invalid config: unknown field ‘foo’”

Solution: Validate config:

Terminal window
arxo config validate --config .arxo.yaml

Common mistakes:

  • Typos — e.g. metriks instead of metrics.
  • Indentation — Use 2 spaces in YAML.
  • Invalid operators — Use ==, !=, <, <=, >, >= in policy.invariants, not less_than.

Config Not Found

Section titled “Config Not Found”

Error: “Config file not found: .arxo.yaml”

Solutions:

  1. Create config: arxo init
  2. Specify path: arxo analyze --config path/to/config.yaml
  3. Check working directory: run from project root where .arxo.yaml lives.

Next steps

Section titled “Next steps”