duola-lobster-agent

# Duola Lobster Agent

## Overview

Execute the standard operating workflow for `duola` as an agent toolchain.
Prefer staged rollout: sync -> backtest -> doctor -> limited live start -> status/log review.

## Billing Setup (SkillPay)

Configure once in runtime environment:

```bash
export SKILLPAY_API_URL="https://skillpay.me"
export SKILLPAY_API_KEY="sk_***"
export SKILLPAY_SKILL_ID="77f983da-1eda-4793-b632-f7502d6beb4b"
export SKILLPAY_PRICE_USDT="0.01"
```

Use billing gate with commands that support `--billing-user-id`.
Supported: `sync`, `backtest`, `follow start`, `autopilot onboard`, `autopilot start`.

Check billing endpoints from CLI:

```bash
duola billing balance --user-id <user_id> --output json
duola billing charge --user-id <user_id> --amount 0.01 --output json
duola billing payment-link --user-id <user_id> --amount 1 --output json
```

## Execution Workflow

### 1) Verify Runtime and CLI

Run:

```bash
node -v
npm view duola version
duola --version
```

If `duola` is missing, install:

```bash
npm install -g duola
```

If global install is restricted, run project-local CLI:

```bash
npm install
npm run build
node dist/index.js --version
```

### 2) Register and Inspect Leader

```bash
duola leader add <leader_address> --name <alias>
duola leader list --output json
duola leader inspect <alias> --output json
```

Use deterministic aliases and keep one alias per leader address.

### 3) Sync and Baseline Backtest

```bash
duola sync <alias> --limit 500 --output json
duola backtest <alias> --lookback 30d --fixed-usd 25 --output json
```

If results are weak, tune before live mode:
- raise `--min-liquidity`
- increase `--min-time-to-expiry`
- reduce `--fixed-usd`

### 4) Run Doctor Diagnostics

```bash
duola doctor <alias> --output json
```

Require passing API connectivity and secret checks before live mode.

### 5) Onboard Autopilot (Preferred Live Path)

Use stdin for private key and do not print secrets:

```bash
printf '%s' '<private_key>' | duola auto...