broker-synclisted
Install: claude install-skill kensongan-prog/trading-advisor
# broker-sync — MooMoo paper fills → journal
> **Deprecated 2026-07-14.** MooMoo no longer owns paper execution, and the
> operator confirmed manual Trading Advisor paper journaling is sufficient.
> This implementation remains only as historical compatibility code. Do not
> run, schedule, or extend it unless a future architecture decision explicitly
> introduces a new paper simulator contract.
The feedback half of the Trading Advisor ↔ MooMoo bridge (see the vault note
"Bridge Contract — Trading Advisor ↔ MooMoo" for the full cross-repo contract).
MooMoo (`Projects/Codex/MooMoo`) owns broker execution and already aggregates
per-intent fill state in `data/moomoo/staged_orders.json` — this skill reads
that read-only and writes into TA's own journal via TA's own `j.py`, nothing
else.
## Usage
```bash
python3 .claude/skills/broker-sync/broker_sync.py sync # preview, then confirm
python3 .claude/skills/broker-sync/broker_sync.py sync --yes # execute without prompting
python3 .claude/skills/broker-sync/broker_sync.py show # read-only: last sync state + review items
```
Config: set `MOOMOO_ROOT` in `.claude/skills/broker-sync/.env` (copy from
`.env.example`) or the environment — the absolute path to the MooMoo repo.
Manual by design — no cron, run it whenever you want journal state to catch
up with the paper broker.
## What it does
For every **SIMULATE** staged order (paper only — MooMoo's realized-P&L
ledger intentionally ignores SIMULATE rows, so this i