# Copy Observation 24h Runbook

## Zweck

Dieser Runbook beschreibt den ersten **24h Copy Observation Test** für den Hyperliquid Copy-Research Track. Ziel ist nicht Gewinn, nicht Live-Copy und nicht eine Handelsentscheidung, sondern saubere Datensammlung für die Bewertung, ob öffentliche Hyperliquid-Wallets genügend verwertbare Position-Deltas für spätere Shadow-Research liefern.

## Aktuelle Watchlist

- 2 öffentliche Observation Wallets
- Quelle: Runtime-Watchlist unter `/home/agent/.local/state/CryptoTradingBot/copy_research/state/watchlist.json`
- Zweck: read-only observation only
- Copy permission: false

Die echten Wallet-Adressen stehen nur in der Runtime-Watchlist und werden nicht ins Repo committed.

## Safety-Regeln

Strikt verboten:

- Keine Live-Copy
- Keine Vault-Deposits
- Keine Wallet/API-Wallet-Execution
- Keine Orders
- Kein Signing
- Kein produktiver Cron/systemd-Autostart
- Keine Runtime-Daten im Repo
- Keine Secrets im Repo

Allowed Shadow Decision bedeutet **keine Live-Freigabe**. `allowed` heisst nur: hypothetisch durch das Shadow-Gate erlaubt, nicht: handeln.

## Rhythmus

- Dauer: maximal 24 Stunden
- Intervall: alle 2 Stunden
- Erwartete Zyklen: 12
- Start: manuell per Script
- Kein Cron, kein systemd, kein Autostart

## Manuelle Befehle pro Zyklus

Das Runner-Script führt pro Zyklus nur diese read-only Schritte aus:

```bash
PYTHONPATH=. python3 -m src.ctb_copy.run_collector_once
PYTHONPATH=. python3 -m src.ctb_copy.run_shadow_once
PYTHONPATH=. python3 -m src.ctb_copy.reports.daily_copy_report
```

Manueller Start des 24h Tests:

```bash
bash scripts/run-copy-observation-24h.sh
```

## Runtime-Pfade

Root:

```text
/home/agent/.local/state/CryptoTradingBot/copy_research
```

Wichtige Dateien:

```text
/home/agent/.local/state/CryptoTradingBot/copy_research/state/watchlist.json
/home/agent/.local/state/CryptoTradingBot/copy_research/snapshots/wallets/YYYY-MM-DD/snapshots.jsonl
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/collector_results/YYYY-MM-DD.json
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/shadow_results/YYYY-MM-DD.json
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/daily/YYYY-MM-DD.md
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/observation_runs/YYYY-MM-DD_24h.log
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/observation_runs/YYYY-MM-DD_24h_status.json
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/observation_runs/YYYY-MM-DD_24h_summary.md
```

## Erfolgskriterien nach 24h

Erfolg ist **nicht** Gewinn. Erfolg ist:

- pro Wallet mehrere Snapshots
- Position-Deltas korrekt erkannt oder plausibel keine Deltas
- Shadow-Decisions `allowed` / `blocked` / `ignored` sichtbar, falls Deltas entstehen
- Blockgründe plausibel
- API stabil oder Fehler sauber dokumentiert
- Reports verständlich
- read-only Safety unverletzt

## Abbruchkriterien

Der Run muss abbrechen bei:

- Read-only Guard Verletzung
- Hinweis auf Order-/Signing-/Execution-Code im Copy-Track
- Collector/Shadow/Report Fehler in einem Zyklus
- fehlender oder ungültiger Runtime-Watchlist
- unerwarteter Secret-/Runtime-Leak ins Repo

## Auswertung nach 24h

Nach Ende wird ein Summary-Report erwartet:

```text
/home/agent/.local/state/CryptoTradingBot/copy_research/reports/observation_runs/YYYY-MM-DD_24h_summary.md
```

Der Summary-Report bewertet:

- Anzahl Zyklen
- Snapshots pro Wallet
- Position-Deltas
- Shadow-Decisions
- allowed / blocked / ignored
- Top-Blockgründe
- API-Probleme
- Datenqualität
- ob die 2 Wallets aktiv genug waren
- ob 7 Tage Observation mit 5–10 Wallets sinnvoll ist
- Empfehlung: weiter beobachten / Wallets austauschen / Research erweitern

Noch keine Live-Entscheidung. Nach 24h geht es nur um Datenqualität und Delta-Erkennung.