# lex-align

> Enterprise governance platform that ensures all code generated by AI
> agents or developers is legally compliant, architecturally sound, and
> secure. Centralized server is the source of truth; the client is a
> thin CLI plus git pre-commit and Claude Code PreToolUse hooks.

The verdict surface is small and deterministic — `ALLOWED`,
`PROVISIONALLY_ALLOWED`, `DENIED` — so an agent can act without
ambiguity. A package that passes registry, license, and CVE gates is
provisionally allowed for immediate use; the agent commits and keeps
moving while `request-approval` enqueues formal review asynchronously
("use first, approve in parallel").

## For agents (read this first)

- [For Agents](for-agents.md): Decision tree, required CLI flags, full verdict JSON shape, hard rules. The single most useful page if you are an LLM.
- [Verdict shape](for-agents.md#verdict-json-shape): Every field returned by `check` and `/api/v1/evaluate`, with the rule each one drives.
- [Decision tree](for-agents.md#decision-tree): Mermaid flowchart from "need a dep" to "commit and continue".
- [Hard rules](for-agents.md#hard-rules): Things never to do (bypass pre-commit, `--no-verify`, re-run `init`, etc.).

## Core docs

- [Home](index.md): Overview, architecture, quick links.
- [Single-user Quickstart](single-user-quickstart.md): Two-command bring-up for a solo developer; no Docker, no Redis, audit DB on disk. Recommended path for evaluation and personal projects.
- [Getting Started](getting-started.md): Bring up the server (Docker Compose), install the client, init a project. The team-deployment path.
- [Org Mode Authentication](org-mode-auth.md): Pluggable auth backends (`header`, `webhook`, custom Python) for multi-user deployments.
- [Agent Support](agent-support.md): Which features work for which agents (Claude Code, Cursor, Aider). Claude Code is first-class; the pre-commit guardrail is universal.
- [API Reference](api.md): Auto-generated docstrings for `lex_align_client` and `lex_align_server`, sourced via mkdocstrings from `src/`.

## Source

- [Repository](https://github.com/dlfelps/lex-align): Canonical source for the client (`src/lex_align_client`) and server (`src/lex_align_server`).
- [README](https://github.com/dlfelps/lex-align#readme): Deployment modes, registry schema, server endpoints.

## Optional

- [Registry example](https://github.com/dlfelps/lex-align/blob/main/src/lex_align_server/_assets/registry.example.yml): YAML schema for the enterprise package registry. Materialized as `registry.yml` by `lex-align-server init`.
- [Server endpoints](for-agents.md#server-endpoints-if-you-must-call-directly): Direct HTTP API if shelling out is not an option.