# myers404/authz-analyzer architecture

> Architecture diagram of the GitHub repository myers404/authz-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/myers404/authz-analyzer
- Repository: https://github.com/myers404/authz-analyzer

## Overview

authz-analyzer is a Boolean authorization-policy analyzer exposed through a CLI and Python API. The principal workflow accepts JSON policy documents or expression strings, parses/decodes them into a typed IR, and answers verify, diff, explain, or batch-report queries using exact BDDs; results include counterexamples, explanations, and diagnostics. The graph preserves the documented query modes and result/metadata path. Edges reflect excerpts, SOURCE INDEX references, or README statements; unsampled details are not inferred.

Main entry points: [`src/authz_analyzer/queries.py`](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/queries.py) (Query orchestration), [`src/authz_analyzer/cli.py`](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/cli.py) (CLI commands), [`src/authz_analyzer/json_codec.py`](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/json_codec.py) (JSON codec), [`src/authz_analyzer/expressions.py`](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/expressions.py) (Expression model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interfaces"]
  node_cli["CLI commands<br/>[cli.py]"]
  node_api["Python API<br/>[__init__.py]"]
end

subgraph group_input["Policy Inputs"]
  node_lexer["Expression lexer<br/>[lexer.py]"]
  node_parser["Expression parser<br/>[parser.py]"]
  node_codec["JSON codec<br/>[json_codec.py]"]
  node_ir["Policy IR<br/>[ir.py]"]
  node_expressions["Expression model<br/>[expressions.py]"]
end

subgraph group_analysis["Analysis"]
  node_queries["Query orchestration<br/>[queries.py]"]
  node_compiler["BDD compiler<br/>[compile.py]"]
  node_bdd["BDD engine<br/>[bdd.py]"]
  node_explain["Minimal explanations<br/>[explain.py]"]
end

subgraph group_output["Results"]
  node_results["Results and encoding<br/>[results.py]"]
end

node_user(("Caller"))

node_user -->|"runs commands"| node_cli
node_user -->|"calls API"| node_api
node_cli -->|"loads documents"| node_codec
node_cli -->|"parses expressions"| node_parser
node_cli -->|"dispatches queries"| node_queries
node_cli -->|"formats output"| node_results
node_api -->|"exposes queries"| node_queries
node_codec -->|"builds document"| node_ir
node_codec -->|"builds expressions"| node_expressions
node_parser -->|"tokenizes input"| node_lexer
node_parser -->|"builds AST"| node_expressions
node_ir -->|"stores expressions"| node_expressions
node_queries -->|"compiles formulas"| node_compiler
node_compiler -->|"builds diagrams"| node_bdd
node_compiler -->|"traverses AST"| node_expressions
node_queries -->|"requests explanations"| node_explain
node_explain -->|"analyzes BDDs"| node_bdd
node_queries -->|"returns outcomes"| node_results
node_queries -->|"loads documents"| node_codec
node_results -.->|"reports diagnostics"| node_bdd

click node_cli "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/cli.py"
click node_api "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/__init__.py"
click node_lexer "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/lexer.py"
click node_parser "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/parser.py"
click node_codec "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/json_codec.py"
click node_ir "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/ir.py"
click node_expressions "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/expressions.py"
click node_queries "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/queries.py"
click node_compiler "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/compile.py"
click node_bdd "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/bdd.py"
click node_explain "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/explain.py"
click node_results "https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/results.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_api toneBlue
class node_lexer,node_parser,node_codec,node_ir,node_expressions toneAmber
class node_queries,node_compiler,node_bdd,node_explain toneMint
class node_results toneRose
class node_user toneIndigo
```

## Components

### Interfaces

- [CLI commands](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/cli.py): `src/authz_analyzer/cli.py`
- [Python API](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/__init__.py): `src/authz_analyzer/__init__.py`

### Policy Inputs

- [Expression lexer](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/lexer.py): `src/authz_analyzer/lexer.py`
- [Expression parser](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/parser.py): `src/authz_analyzer/parser.py`
- [JSON codec](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/json_codec.py): `src/authz_analyzer/json_codec.py`
- [Policy IR](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/ir.py): `src/authz_analyzer/ir.py`
- [Expression model](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/expressions.py): `src/authz_analyzer/expressions.py`

### Analysis

- [Query orchestration](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/queries.py): `src/authz_analyzer/queries.py`
- [BDD compiler](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/compile.py): `src/authz_analyzer/compile.py`
- [BDD engine](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/bdd.py): `src/authz_analyzer/bdd.py`
- [Minimal explanations](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/explain.py): `src/authz_analyzer/explain.py`

### Results

- [Results and encoding](https://github.com/myers404/authz-analyzer/blob/main/src/authz_analyzer/results.py): `src/authz_analyzer/results.py`

### Other components

- **Caller**

## Connections

- Caller → CLI commands: runs commands (evidence: `README.md`)
- Caller → Python API: calls API (evidence: `README.md`)
- CLI commands → JSON codec: loads documents (evidence: `src/authz_analyzer/cli.py`)
- CLI commands → Expression parser: parses expressions (evidence: `src/authz_analyzer/cli.py`)
- CLI commands → Query orchestration: dispatches queries (evidence: `src/authz_analyzer/cli.py`)
- CLI commands → Results and encoding: formats output (evidence: `src/authz_analyzer/cli.py`)
- Python API → Query orchestration: exposes queries (evidence: `src/authz_analyzer/__init__.py`)
- JSON codec → Policy IR: builds document (evidence: `src/authz_analyzer/json_codec.py`)
- JSON codec → Expression model: builds expressions (evidence: `src/authz_analyzer/json_codec.py`)
- Expression parser → Expression lexer: tokenizes input (evidence: `src/authz_analyzer/parser.py`)
- Expression parser → Expression model: builds AST (evidence: `src/authz_analyzer/parser.py`)
- Policy IR → Expression model: stores expressions (evidence: `src/authz_analyzer/ir.py`)
- Query orchestration → BDD compiler: compiles formulas (evidence: `src/authz_analyzer/queries.py`)
- BDD compiler → BDD engine: builds diagrams (evidence: `src/authz_analyzer/compile.py`)
- BDD compiler → Expression model: traverses AST (evidence: `src/authz_analyzer/compile.py`)
- Query orchestration → Minimal explanations: requests explanations (evidence: `src/authz_analyzer/queries.py`)
- Minimal explanations → BDD engine: analyzes BDDs (evidence: `src/authz_analyzer/explain.py`)
- Query orchestration → Results and encoding: returns outcomes (evidence: `src/authz_analyzer/queries.py`)
- Query orchestration → JSON codec: loads documents (evidence: `src/authz_analyzer/queries.py`)
- Results and encoding → BDD engine: reports diagnostics
