# ARMOR OS integration boundary

SHIRE Merchant is the merchant brain. Etsy, eBay and shire3d.com are channel adapters beneath it.

ARMOR OS should call the local service through `127.0.0.1` when both run on THE BRAIN. If moved to another private node, use its Tailscale address and add authentication before changing `SHIRE_HOST`.

## Read-only discovery

```text
GET /api/health
GET /api/assistant/status
GET /api/channels/status
```

## Conversation

```http
POST /api/assistant/chat
Content-Type: application/json

{"message":"Analyse SHIRE 3D and tell me the best next action."}
```

## Authority policy

ARMOR OS may request analysis and drafts automatically. Publishing, repricing a live marketplace, sending customer communications, spending money, deleting records, disconnecting accounts or changing credentials must create an approval proposal for Ray. Approval must be explicit, scoped to the exact action and written to the audit record.

The supplied systemd unit is a template only. Review paths and the service user before installation. This archive does not modify the live ARMOR OS installation.
