# Setup guide — Supply Chain Disruption Monitor

## 1. Install and connect signals

Install the agent and connect your signal sources.

```
pipx install disruption-monitor-agent
disruption-monitor-agent connect --suppliers erp --news news-api --weather noaa
disruption-monitor-agent doctor
```

## 2. Configure guardrails

No fabricated alerts and recommend-only are enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
ALERTS_REQUIRE_SOURCE=true
EXECUTE_ACTIONS=false       # recommends only
LABEL_CONFIDENCE=true
```

## 3. Map suppliers & routes

Tell it what to watch and how impact maps to your chain.

```
# supply.yml
suppliers: { acme: [SKU-1, SKU-2], globex: [SKU-9] }
routes: [shanghai-la, rotterdam-nyc]
severity_rules: { single_source_sku: high }
```

## 4. Run a scan

Scan signals and review the prioritized digest.

```
disruption-monitor-agent run --period 24h --explain
# prints disruptions (sourced + rated) + watch items (no actions taken)
```

## 5. Wire into operations

Schedule scans; recommendations go to a human to approve.

```
# scheduled scan -> sourced digest -> ops reviews + approves any action
```
