┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   MCP Client    │────▶│  ComplyOS MCP    │────▶│ Compliance      │
│ (Claude/Cursor) │     │  Server (FastMCP)│     │ Auditor         │
└─────────────────┘     └──────────────────┘     └────────┬────────┘
                                                          │
                           ┌──────────────────────────────┼──────────────┐
                           │                              │              │
                    ┌──────▼──────┐            ┌──────────▼─────┐  ┌────▼─────┐
                    │   Mock      │            │   Workday      │  │  SAP/CSOD│
                    │ Connector   │            │   Connector    │  │ (planned)│
                    └─────────────┘            └────────────────┘  └──────────┘

# Clone the repo
git clone https://github.com/simongonzalezdc/complyos.git
cd complyos

# Install with uv (recommended)
uv sync --all-extras --dev

# Or with pip
pip install -e ".[dev]"

# Run a compliance audit
complyos audit

# Filter by department
complyos audit --department Engineering

# Generate a structured report
complyos report --department Engineering --json

# Check a single user's status
complyos status u1

# Sync LMS data to local SQLite
complyos sync

# Validate an assignment rule before deploying
complyos validate-rule rule.json

# Preview who would be affected by a rule
complyos preview-rule rule.json

# Check connector health
complyos health

# Start the MCP server
complyos mcp

export WORKDAY_BASE_URL="https://your-workday-instance.com"
export WORKDAY_USERNAME="your-user"
export WORKDAY_PASSWORD="your-pass"

# Run tests
uv run pytest -q

# Run with coverage
uv run pytest --cov=complyos --cov-report=term-missing

# Lint
uv run ruff check complyos tests

# Type check
uv run mypy complyos --ignore-missing-imports

ComplianceGap(
    user=User(id="u1", department="Engineering", ...),
    missing_courses=[Course(code="SEC-101", mandatory=True)],
    severity=ComplianceGapSeverity.HIGH,  # critical | high | medium | low
    days_overdue=14,
    remediation_action=RemediationAction(...),
)