**Security notes:**
- Playwright will download chromium binaries (~300-500MB)
- Review Playwright's installation docs: https://playwright.dev/python/docs/intro
- No credentials are embedded in the script — it only accesses public tracking pages
- Telegram notifications are handled by OpenClaw cron delivery mechanism (not in script)
- All sensitive files (history, config) are stored locally in `memory/` directory

## Understanding Evenrealities Smart Ring Orders

Evenrealities manufactures **smart rings** in different sizes. When ordering, customers can optionally request a **sizing kit** — a collection of all sizes to try on and find the correct fit.

### Order Workflow

1. **Order 1: Sizing Kit (Optional)**
   - Customer receives ring in all available sizes
   - Status tracked separately from main order
   - Typically ships first

2. **Order 2: Final Ring (After Sizing)**
   - Once customer determines correct size, they return to Evenrealities
   - Specify the correct size on the order tracking page
   - Final ring ships separately with the customer's size
   - Typically ships after sizing kit is returned/processed

### How This Affects Tracking

- **Single Shipment Orders**: Only one status to track (no sizing kit requested)
  - Example: Direct purchase of known size → Single "SHIPPED" status

- **Multi-Shipment Orders**: Two separate shipments with independent statuses
  - Sizing kit shipment: `PROCESSING` → `SHIPPED`
  - Final ring shipment: `PENDING` (waiting for size confirmation) → `PROCESSING` → `SHIPPED`

### Important Note

The tracker will show the **combined order status** — if the order has been split into multiple shipments:
- First shipment status (sizing kit or direct ring)
- You may see: "SHIPPED (sizing kit received, waiting for final ring)"

Monitor both statuses for complete visibility of your order fulfillment.

## Quick Start

### 1. Set Up Orders Configuration

Copy the example file and add your orders:

That's it! The cron will run every morning at 9 AM.

## How It Works

**Daily Flow (9 AM):**

1. Script loads your orders from `memory/evenrealities-orders.json`
2. For each order, uses browser automation to:
   - Navigate to https://track.evenrealities.com
   - Enter email + order number
   - Click confirm
   - Extract status text
3. Compares status against history
4. **If changed:** Sends Telegram notification
5. **If unchanged:** Silent (no notification)
6. Updates `memory/evenrealities-status-history.json`

## Commands

### Check All Orders Now

## Configuration Files

### evenrealities-orders.json

Location: `memory/evenrealities-orders.json`

**Fields:**
- `email`: Email used for tracking
- `order_id`: Order number (format: ORD-XXXXXX or similar)

Add as many orders as needed.

### evenrealities-status-history.json

Location: `memory/evenrealities-status-history.json` (auto-generated)

Updated automatically on each run.

## Notifications

### When You Get Notified

✨ **Status CHANGED** → Telegram message sent

Example notification:

### When You DON'T Get Notified

✓ Status unchanged
✓ First check (no previous status to compare)
✓ No orders configured

## Browser Automation (Playwright)

The skill uses **Playwright** (direct, not via fast-browser-use) for browser automation:

1. Navigate to https://track.evenrealities.com
2. Fill email field (validated before use)
3. Fill order ID field (validated before use)
4. Click confirmation button
5. Wait 1-2 seconds for page response
6. Extract status text from result
7. Close browser gracefully

**Why Playwright directly?**
- Dedicated, well-tested library for headless browser control
- No extra skill dependencies needed
- Direct access to page content and timing control

**Security:**
- Email and order ID are validated before being sent to the browser
- No sensitive credentials passed to browser
- Browser session is ephemeral (created/destroyed per check)

## Workflow

**Setup (one-time):**
1. Copy orders example
2. Edit with your orders
3. Create cron job

**Daily (automatic):**
1. 9 AM: Cron triggers
2. Script checks all orders
3. Compares to yesterday's status
4. If changed: You get notified
5. History updated

**Maintenance:**
- Add/remove orders: Edit `memory/evenrealities-orders.json`
- Check manually anytime: `python3 scripts/tracker.py --check`
- Review history: `python3 scripts/tracker.py --history`

## Troubleshooting

### "No orders configured"

Create/edit `memory/evenrealities-orders.json` with at least one order.

### "Failed to fetch status"

- Check that https://track.evenrealities.com is accessible
- Verify email and order ID are correct
- Browser automation might need adjustment if site layout changed

### "No notifications" (but orders exist)

- First run: Always silent (establishes baseline)
- Subsequent runs: Only notified if status changes
- Check history with `--history` to see stored statuses

### Change Cron Time

Edit the cron schedule. Example for 8 AM instead of 9 AM:

# Install Python packages
pip install -r skills/evenrealities-tracker/requirements.txt

# Install Playwright browsers (one-time, required for browser automation)
playwright install

{
  "orders": [
    {
      "email": "[email protected]",
      "order_id": "ORD-123456"
    },
    {
      "email": "[email protected]",
      "order_id": "ORD-789012"
    }
  ]
}

clawdbot cron add \
  --name "Evenrealities order check" \
  --schedule "0 9 * * *" \
  --task "python3 /Users/thibautrey/clawd/skills/evenrealities-tracker/scripts/tracker.py --check"

🔍 Checking 2 order(s)...
============================================================

📦 Checking: [email protected] / Order #ORD-123456
   Status: SHIPPED
   (No change)

📦 Checking: [email protected] / Order #ORD-789012
   Status: PROCESSING
   ✨ CHANGED: PENDING → PROCESSING

✨ 1 change(s) detected!
   📦 ORD-789012: PENDING → PROCESSING